HomePage/build/node-locations.ts

import { isIP } from "node:net";

interface KomariRpcResponse {
  result?: Record<string, KomariNode>;
  error?: { code: number; message: string };
}

interface KomariNode {
  uuid: string;
  name: string;
  ipv4?: string;
  ipv6?: string;
  hidden?: boolean;
  region?: string;
}

interface KomariNodesResponse {
  data?: KomariNode[];
}

export interface PublicNode {
  uuid: string;
  name: string;
  region: string;
}

interface GeoResult {
  lat: number;
  lng: number;
  city: string;
  country: string;
  countryCode: string;
}

export interface NodeLocation extends GeoResult {
  uuid: string;
  name: string;
}

export interface NodeLocationsFile {
  version: 1;
  generatedAt: string | null;
  nodes: PublicNode[];
  locations: NodeLocation[];
}

export interface NodeLocationBuildOptions {
  komariBaseUrl: string;
  komariApiKey?: string;
  ipinfoToken?: string;
}

function isPrivateIp(ip: string): boolean {
  if (ip.includes(":")) {
    const value = ip.toLowerCase();
    return value === "::1" || value.startsWith("fc") || value.startsWith("fd") || value.startsWith("fe80:");
  }

  const parts = ip.split(".").map(Number);
  return (
    parts[0] === 10 ||
    parts[0] === 127 ||
    (parts[0] === 169 && parts[1] === 254) ||
    (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31) ||
    (parts[0] === 192 && parts[1] === 168)
  );
}

function firstPublicIp(node: KomariNode): string | null {
  for (const rawValue of [node.ipv4, node.ipv6]) {
    if (!rawValue) continue;
    for (const rawCandidate of rawValue.split(/[\s,]+/)) {
      const candidate = rawCandidate.replace(/^\[|\]$/g, "").split("/")[0];
      if (isIP(candidate) && !isPrivateIp(candidate)) return candidate;
    }
  }
  return null;
}

async function fetchJson(url: string, init?: RequestInit): Promise<Record<string, unknown>> {
  const response = await fetch(url, {
    ...init,
    headers: {
      Accept: "application/json",
      "User-Agent": "PersonalWeb build",
      ...init?.headers,
    },
    signal: AbortSignal.timeout(7000),
  });
  if (!response.ok) throw new Error(`${url} responded ${response.status}`);
  return response.json() as Promise<Record<string, unknown>>;
}

function numberValue(value: unknown): number | null {
  const parsed = typeof value === "number" ? value : Number(value);
  return Number.isFinite(parsed) ? parsed : null;
}

function geoResult(
  latValue: unknown,
  lngValue: unknown,
  city: unknown,
  country: unknown,
  countryCode: unknown,
): GeoResult | null {
  const lat = numberValue(latValue);
  const lng = numberValue(lngValue);
  if (lat === null || lng === null || Math.abs(lat) > 90 || Math.abs(lng) > 180) return null;
  return {
    lat,
    lng,
    city: typeof city === "string" ? city : "",
    country: typeof country === "string" ? country : "",
    countryCode: typeof countryCode === "string" ? countryCode : "",
  };
}

async function locateWithIpWho(ip: string): Promise<GeoResult | null> {
  const data = await fetchJson(
    `https://ipwho.is/${encodeURIComponent(ip)}?fields=success,country,country_code,city,latitude,longitude`,
  );
  if (data.success !== true) return null;
  return geoResult(data.latitude, data.longitude, data.city, data.country, data.country_code);
}

async function locateWithIpSb(ip: string): Promise<GeoResult | null> {
  const data = await fetchJson(`https://api.ip.sb/geoip/${encodeURIComponent(ip)}`);
  return geoResult(data.latitude, data.longitude, data.city, data.country, data.country_code);
}

async function locateWithIpinfo(ip: string, token: string): Promise<GeoResult | null> {
  const data = await fetchJson(`https://ipinfo.io/${encodeURIComponent(ip)}/json?token=${encodeURIComponent(token)}`);
  if (typeof data.loc !== "string") return null;
  const [lat, lng] = data.loc.split(",");
  return geoResult(lat, lng, data.city, data.country, data.country);
}

async function locateIp(ip: string, ipinfoToken?: string): Promise<GeoResult | null> {
  const providers = [() => locateWithIpWho(ip), () => locateWithIpSb(ip)];
  if (ipinfoToken) providers.push(() => locateWithIpinfo(ip, ipinfoToken));

  for (const provider of providers) {
    try {
      const location = await provider();
      if (location) return location;
    } catch {
      // Try the next provider; the country-level fallback remains available in the client.
    }
  }
  return null;
}

async function mapWithConcurrency<T, R>(items: T[], limit: number, worker: (item: T) => Promise<R>): Promise<R[]> {
  const results = new Array<R>(items.length);
  let nextIndex = 0;

  async function run(): Promise<void> {
    while (nextIndex < items.length) {
      const index = nextIndex++;
      results[index] = await worker(items[index]);
    }
  }

  await Promise.all(Array.from({ length: Math.min(limit, items.length) }, () => run()));
  return results;
}

async function fetchKomariNodes(baseUrl: string, apiKey: string): Promise<KomariNode[]> {
  const payload = await fetchJson(`${baseUrl.replace(/\/$/, "")}/api/rpc2`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "common:getNodes", params: {} }),
  });
  const rpc = payload as KomariRpcResponse;
  if (rpc.error) throw new Error(`Komari RPC ${rpc.error.code}: ${rpc.error.message}`);
  if (!rpc.result || Array.isArray(rpc.result)) throw new Error("Komari RPC returned an invalid node map.");
  return Object.values(rpc.result).filter((node) => !node.hidden);
}

async function fetchPublicNodes(baseUrl: string): Promise<PublicNode[]> {
  const payload = (await fetchJson(`${baseUrl.replace(/\/$/, "")}/api/nodes`)) as KomariNodesResponse;
  if (!Array.isArray(payload.data)) throw new Error("Komari public API returned an invalid node list.");
  return payload.data.map((node) => ({ uuid: node.uuid, name: node.name, region: node.region ?? "" }));
}

export async function generateNodeLocations(options: NodeLocationBuildOptions): Promise<NodeLocationsFile> {
  const publicNodes = await fetchPublicNodes(options.komariBaseUrl);
  if (!options.komariApiKey) {
    return { version: 1, generatedAt: new Date().toISOString(), nodes: publicNodes, locations: [] };
  }

  const nodes = await fetchKomariNodes(options.komariBaseUrl, options.komariApiKey);
  const nodesWithIp = nodes.flatMap((node) => {
    const ip = firstPublicIp(node);
    return ip ? [{ node, ip }] : [];
  });
  const uniqueIps = [...new Set(nodesWithIp.map(({ ip }) => ip))];
  const resolved = await mapWithConcurrency(uniqueIps, 4, async (ip) => [ip, await locateIp(ip, options.ipinfoToken)] as const);
  const locationsByIp = new Map(resolved.filter((entry): entry is readonly [string, GeoResult] => entry[1] !== null));

  const locations = nodesWithIp.flatMap(({ node, ip }) => {
    const location = locationsByIp.get(ip);
    return location ? [{ uuid: node.uuid, name: node.name, ...location }] : [];
  });

  return {
    version: 1,
    generatedAt: new Date().toISOString(),
    nodes: publicNodes,
    locations,
  };
}