Files
worldmonitor/api/reverse-geocode.js
Elie Habib fe67111dc9 feat: harness engineering P0 - linting, testing, architecture docs (#1587)
* feat: harness engineering P0 - linting, testing, architecture docs

Add foundational infrastructure for agent-first development:

- AGENTS.md: agent entry point with progressive disclosure to deeper docs
- ARCHITECTURE.md: 12-section system reference with source-file refs and ownership rule
- Biome 2.4.7 linter with project-tuned rules, CI workflow (lint-code.yml)
- Architectural boundary lint enforcing forward-only dependency direction (lint-boundaries.mjs)
- Unit test CI workflow (test.yml), all 1083 tests passing
- Fixed 9 pre-existing test failures (bootstrap sync, deploy-config headers, globe parity, redis mocks, geometry URL, import.meta.env null safety)
- Fixed 12 architectural boundary violations (types moved to proper layers)
- Added 3 missing cache tier entries in gateway.ts
- Synced cache-keys.ts with bootstrap.js
- Renamed docs/architecture.mdx to "Design Philosophy" with cross-references
- Deprecated legacy docs/Docs_To_Review/ARCHITECTURE.md
- Harness engineering roadmap tracking doc

* fix: address PR review feedback on harness-engineering-p0

- countries-geojson.test.mjs: skip gracefully when CDN unreachable
  instead of failing CI on network issues
- country-geometry-overrides.test.mts: relax timing assertion
  (250ms -> 2000ms) for constrained CI environments
- lint-boundaries.mjs: implement the documented api/ boundary check
  (was documented but missing, causing false green)

* fix(lint): scan api/ .ts files in boundary check

The api/ boundary check only scanned .js/.mjs files, missing the 25
sebuf RPC .ts edge functions. Now scans .ts files with correct rules:
- Legacy .js: fully self-contained (no server/ or src/ imports)
- RPC .ts: may import server/ and src/generated/ (bundled at deploy),
  but blocks imports from src/ application code

* fix(lint): detect import() type expressions in boundary lint

- Move AppContext back to app/app-context.ts (aggregate type that
  references components/services/utils belongs at the top, not types/)
- Move HappyContentCategory and TechHQ to types/ (simple enums/interfaces)
- Boundary lint now catches import('@/layer') expressions, not just
  from '@/layer' imports
- correlation-engine imports of AppContext marked boundary-ignore
  (type-only imports of top-level aggregate)
2026-03-14 21:29:21 +04:00

102 lines
3.3 KiB
JavaScript

import { getCorsHeaders, isDisallowedOrigin } from './_cors.js';
export const config = { runtime: 'edge' };
const NOMINATIM_BASE = 'https://nominatim.openstreetmap.org/reverse';
const CHROME_UA = 'WorldMonitor/2.0 (https://worldmonitor.app)';
export default async function handler(req) {
if (isDisallowedOrigin(req))
return new Response('Forbidden', { status: 403 });
const cors = getCorsHeaders(req);
if (req.method === 'OPTIONS')
return new Response(null, { status: 204, headers: cors });
const url = new URL(req.url);
const lat = url.searchParams.get('lat');
const lon = url.searchParams.get('lon');
const latN = Number(lat);
const lonN = Number(lon);
if (!lat || !lon || Number.isNaN(latN) || Number.isNaN(lonN)
|| latN < -90 || latN > 90 || lonN < -180 || lonN > 180) {
return new Response(JSON.stringify({ error: 'valid lat (-90..90) and lon (-180..180) required' }), {
status: 400,
headers: { ...cors, 'Content-Type': 'application/json' },
});
}
const redisUrl = process.env.UPSTASH_REDIS_REST_URL;
const redisToken = process.env.UPSTASH_REDIS_REST_TOKEN;
const cacheKey = `geocode:${latN.toFixed(1)},${lonN.toFixed(1)}`;
if (redisUrl && redisToken) {
try {
const cached = await fetch(`${redisUrl}/get/${encodeURIComponent(cacheKey)}`, {
headers: { Authorization: `Bearer ${redisToken}` },
signal: AbortSignal.timeout(1500),
});
if (cached.ok) {
const data = await cached.json();
if (data.result) {
return new Response(data.result, {
status: 200,
headers: {
...cors,
'Content-Type': 'application/json',
'Cache-Control': 'public, s-maxage=86400, stale-while-revalidate=3600',
},
});
}
}
} catch { /* cache miss, fetch fresh */ }
}
try {
const resp = await fetch(
`${NOMINATIM_BASE}?lat=${latN}&lon=${lonN}&format=json&zoom=3&accept-language=en`,
{
headers: { 'User-Agent': CHROME_UA, Accept: 'application/json' },
signal: AbortSignal.timeout(8000),
},
);
if (!resp.ok) {
return new Response(JSON.stringify({ error: `Nominatim ${resp.status}` }), {
status: 502,
headers: { ...cors, 'Content-Type': 'application/json' },
});
}
const data = await resp.json();
const country = data.address?.country;
const code = data.address?.country_code?.toUpperCase();
const result = { country: country || null, code: code || null, displayName: data.display_name || country || '' };
const body = JSON.stringify(result);
if (redisUrl && redisToken && country && code) {
fetch(redisUrl, {
method: 'POST',
headers: { Authorization: `Bearer ${redisToken}`, 'Content-Type': 'application/json' },
body: JSON.stringify(['SET', cacheKey, body, 'EX', 604800]),
}).catch(() => {});
}
return new Response(body, {
status: 200,
headers: {
...cors,
'Content-Type': 'application/json',
'Cache-Control': 'public, s-maxage=86400, stale-while-revalidate=3600',
},
});
} catch (err) {
return new Response(JSON.stringify({ error: 'Nominatim request failed' }), {
status: 502,
headers: { ...cors, 'Content-Type': 'application/json' },
});
}
}