Files
ssmithx bb03bfc365 Go global: worldwide BTC Map sync, marker clustering, response compression
- Sync now pulls every BTC Map place worldwide (~29k live), not just
  Madeira — dropped BTCMAP_CENTER_LAT/LON/RADIUS_KM entirely.
- Incremental via a stored watermark (settings.btcmap_synced_since):
  only fetches what changed since the last sync, not the whole dataset
  every time. Handles deletions too (BTC Map delistings correctly evict
  the local place + cascade its claim/links, not just go unclaimed).
- Real bug caught and fixed before it shipped: tried BTC Map's own
  recommended updated_since+limit pagination first, but their timestamps
  mix millisecond and whole-second precision, and naive string comparison
  across that isn't chronologically safe — silently truncated a real
  sync to ~4,000 of ~42,000 records with no error. Measured the
  alternative (single unpaginated request) instead: 2-3s for the full
  dataset, simpler and actually correct. Full writeup in
  services/btcmap.ts, regression test for the specific bug in
  services/btcmap.test.ts.
- @fastify/compress added — the places list is now tens of thousands of
  rows, gzip/br/zstd auto-negotiated.
- Also fixed while touching dependencies: @fastify/static had a real
  high-severity path-traversal/auth-bypass advisory (GHSA-pr96-94w5-mx2h
  et al) affecting the version we were pinned to — bumped to the patched
  10.1.2.
- Frontend: leaflet.markercluster (raw per-marker rendering doesn't scale
  to tens of thousands of points), cyberpunk-themed cluster icons to
  match the existing HUD styling, batch marker insertion (addLayers, not
  a per-marker addLayer loop) since that's dramatically faster at this
  scale. Default map view is now world-scale, recentering on the
  player's location if geolocation is available.
- 60 backend tests passing throughout (7 new for the sync rewrite).
2026-08-05 17:32:54 +00:00

43 lines
2.3 KiB
TypeScript

import { z } from 'zod';
const envSchema = z.object({
PORT: z.coerce.number().default(8096),
HOST: z.string().default('0.0.0.0'),
DATA_DIR: z.string().default('./data'),
STATIC_DIR: z.string().optional(),
PUBLIC_URL: z.string().url().default('http://localhost:8096'),
// Set when this instance is deployed under a path prefix on a shared domain
// (e.g. "/regress" on podsteadr.atobitcoin.io/regress/) rather than at
// root. Must match nginx's location block, which must NOT strip the
// prefix — the NIP-98 `u` tag the frontend signs includes it, so the
// backend needs to see (and route) the same full path. Leave unset ("") to
// deploy at root, e.g. its own dedicated host/port.
ROUTE_PREFIX: z.string().default(''),
NIP98_MAX_SKEW_SECS: z.coerce.number().default(60),
SESSION_TTL_DAYS: z.coerce.number().default(30),
// Base URL for BTC Map's API — global sync pulls every place worldwide via
// the chronological /v4/places endpoint (paginated, incremental via a
// stored watermark — see routes/sync.ts), not scoped to any region.
// Overridable for tests to point at a mock server instead of the real API.
BTCMAP_API_BASE_URL: z.string().url().default('https://api.btcmap.org'),
// How close (in meters) a player must be to a place to claim it or link from it.
CLAIM_RADIUS_METERS: z.coerce.number().default(40),
// Maximum link length, in kilometers — mirrors Ingress's level-scaled link
// range (up to ~655km at max level) with a single flat cap instead, since
// Regress has no resonator-leveling system to scale it off of.
MAX_LINK_DISTANCE_KM: z.coerce.number().default(500),
// Claims expire after this many Bitcoin blocks and revert to neutral —
// mirrors Ingress's real-world portal decay, but block-height-based
// instead of wall-clock, since that's the native "clock" for this game.
PORTAL_TIMEOUT_BLOCKS: z.coerce.number().default(2100),
BLOCK_HEIGHT_API_URL: z.string().url().default('https://mempool.space/api/blocks/tip/height'),
// How often to sweep for and expire timed-out claims.
EXPIRY_SWEEP_INTERVAL_MS: z.coerce.number().default(5 * 60 * 1000),
});
export type Config = z.infer<typeof envSchema>;
export function loadConfig(env: NodeJS.ProcessEnv = process.env): Config {
return envSchema.parse(env);
}