Method fetchList

server/src/datasource.ts:216–249

(source: DataSource, now: number)

  }

  private async fetchList(source: DataSource, now: number): Promise<Aircraft[] | null> {
    const url = source === "radio" ? this.o.getConfig().radioUrl : this.buildApiUrl();
    try {
      const json = await fetchJson(url);
      const rawList: RawAircraft[] = json.aircraft ?? json.ac ?? [];
      const list: Aircraft[] = [];
      for (const raw of rawList) {
        const ac = normalize(raw, now);
        if (ac) list.push(ac);
      }
      // Area APIs sometimes return a far wider box than the radius we asked
      // for, so a 3-mile setup ends up showing flights across the country.
      // Trim to the configured radius ourselves (matching the renderer's
      // radiusMiles * 1.08 cutoff). The radio feed is already local-only.
      return source === "api" ? this.withinRadius(list) : list;
    } catch (e) {
      const reason = describeFetchError(e);
      if (source === "api" && reason === "HTTP 429") {
        this.apiBackoffUntil = now + RATE_LIMIT_BACKOFF_MS;
      }
      let host = url;
      try {
        host = new URL(url).host;
      } catch {
        // keep the raw url — a malformed one is itself the diagnosis
      }
      this.lastError = `${source} fetch failed: ${reason} (${host})`;
      if (now - this.lastErrorLogAt > 30_000) {
        this.lastErrorLogAt = now;
        console.error(`[poller] ${source} fetch failed: ${reason} — ${url}`);
      }
      return null;
    }
  }

  private async refreshApi(): Promise<void> {
    if (Date.now() < this.apiBackoffUntil) return;