Files
worldmonitor/api/_relay.js
Elie Habib 7c3f3825f7 refactor(api): extract shared relay helper into _relay.js (#782)
DRY 7 edge functions that duplicated relay proxy boilerplate (~80%
identical: CORS, origin check, OPTIONS, relay URL construction, auth
headers, fetchWithTimeout, error handling).

- New `api/_relay.js` exports createRelayHandler factory + getRelayBaseUrl,
  getRelayHeaders, fetchWithTimeout utilities
- Convert ais-snapshot, polymarket, opensky, oref-alerts, telegram-feed
  to ~15-25 line config objects via createRelayHandler
- Refactor youtube/live.js and rss-proxy.js to import shared utils only
  (complex handlers not suited for factory pattern)
- 30 unit/behavior tests in tests/relay-helper.test.mjs

Net: -501 lines removed, +72 added across 7 prod files. Relay utility
functions exist in 1 place instead of 7.
2026-03-02 19:28:31 +04:00

121 lines
4.1 KiB
JavaScript

import { getCorsHeaders, isDisallowedOrigin } from './_cors.js';
import { validateApiKey } from './_api-key.js';
import { checkRateLimit } from './_rate-limit.js';
export function getRelayBaseUrl() {
const relayUrl = process.env.WS_RELAY_URL;
if (!relayUrl) return null;
return relayUrl.replace('wss://', 'https://').replace('ws://', 'http://').replace(/\/$/, '');
}
export function getRelayHeaders(baseHeaders = {}) {
const headers = { ...baseHeaders };
const relaySecret = process.env.RELAY_SHARED_SECRET || '';
if (relaySecret) {
const relayHeader = (process.env.RELAY_AUTH_HEADER || 'x-relay-key').toLowerCase();
headers[relayHeader] = relaySecret;
headers.Authorization = `Bearer ${relaySecret}`;
}
return headers;
}
export async function fetchWithTimeout(url, options, timeoutMs = 15000) {
const controller = new AbortController();
const timeout = setTimeout(() => controller.abort(), timeoutMs);
try {
return await fetch(url, { ...options, signal: controller.signal });
} finally {
clearTimeout(timeout);
}
}
export function createRelayHandler(cfg) {
return async function handler(req) {
const corsHeaders = getCorsHeaders(req, 'GET, OPTIONS');
if (isDisallowedOrigin(req)) {
return new Response(JSON.stringify({ error: 'Origin not allowed' }), {
status: 403,
headers: { 'Content-Type': 'application/json', ...corsHeaders },
});
}
if (req.method === 'OPTIONS') {
return new Response(null, { status: 204, headers: corsHeaders });
}
if (req.method !== 'GET') {
return new Response(JSON.stringify({ error: 'Method not allowed' }), {
status: 405,
headers: { 'Content-Type': 'application/json', ...corsHeaders },
});
}
if (cfg.requireApiKey) {
const keyCheck = validateApiKey(req);
if (keyCheck.required && !keyCheck.valid) {
return new Response(JSON.stringify({ error: keyCheck.error }), {
status: 401,
headers: { 'Content-Type': 'application/json', ...corsHeaders },
});
}
}
if (cfg.requireRateLimit) {
const rateLimitResponse = await checkRateLimit(req, corsHeaders);
if (rateLimitResponse) return rateLimitResponse;
}
const relayBaseUrl = getRelayBaseUrl();
if (!relayBaseUrl) {
if (cfg.fallback) return cfg.fallback(req, corsHeaders);
return new Response(JSON.stringify({ error: 'WS_RELAY_URL is not configured' }), {
status: 503,
headers: { 'Content-Type': 'application/json', ...corsHeaders },
});
}
try {
const requestUrl = new URL(req.url);
const path = typeof cfg.buildRelayPath === 'function'
? cfg.buildRelayPath(req, requestUrl)
: cfg.relayPath;
const search = cfg.forwardSearch !== false ? (requestUrl.search || '') : '';
const relayUrl = `${relayBaseUrl}${path}${search}`;
const reqHeaders = cfg.requestHeaders || { Accept: 'application/json' };
const response = await fetchWithTimeout(relayUrl, {
headers: getRelayHeaders(reqHeaders),
}, cfg.timeout || 15000);
if (cfg.onlyOk && !response.ok && cfg.fallback) {
return cfg.fallback(req, corsHeaders);
}
const extraHeaders = cfg.extraHeaders ? cfg.extraHeaders(response) : {};
const body = await response.text();
const isSuccess = response.status >= 200 && response.status < 300;
const cacheHeaders = cfg.cacheHeaders ? cfg.cacheHeaders(isSuccess) : {};
return new Response(body, {
status: response.status,
headers: {
'Content-Type': response.headers.get('content-type') || 'application/json',
...cacheHeaders,
...extraHeaders,
...corsHeaders,
},
});
} catch (error) {
if (cfg.fallback) return cfg.fallback(req, corsHeaders);
const isTimeout = error?.name === 'AbortError';
return new Response(JSON.stringify({
error: isTimeout ? 'Relay timeout' : 'Relay request failed',
details: error?.message || String(error),
}), {
status: isTimeout ? 504 : 502,
headers: { 'Content-Type': 'application/json', ...corsHeaders },
});
}
};
}