gods-eye-view/src/annotations/outlineRungsFallback.test.mjs

// Tile fallbacks still run after a busy or failed Nominatim answer, and
// grounds asks phrased "around" still reach their outline rungs.
import test from 'node:test';
import assert from 'node:assert/strict';
import { readFileSync } from 'node:fs';
import { createOutlineRungs, nominatimKindFor } from './outlineRungs.js';
import { decodeOpenFreeMapOutlineTile } from '../sources/openFreeMapOutlines.js';

const TILES = [6745, 6746].map((y) =>
  decodeOpenFreeMapOutlineTile(
    readFileSync(
      new URL(
        `../data/fixtures/ofm-outlines-austin-14-3743-${y}.pbf`,
        import.meta.url,
      ),
    ),
    14,
    3743,
    y,
  ),
);
const UNAVAILABLE = { unavailable: true, retryable: false };
const CAPITOL = { lat: 30.27472, lon: -97.74035 };

function setup(answer, tiles = TILES) {
  const tileCalls = [];
  const asks = [];
  const rungs = createOutlineRungs({
    tiles: {
      fetchBounds: async (box) => {
        tileCalls.push(box);
        return { tiles };
      },
    },
    nominatim: {
      lookup: async (ask) => {
        asks.push(ask);
        return answer;
      },
    },
  });
  return { rungs, tileCalls, asks };
}
const ladder = {
  base: async () => UNAVAILABLE,
  finish: (fp) => ({ ring: fp.ring, footprintKind: fp.kind }),
};
const ctx = (overrides) => ({
  scope: 'building',
  target: 'Texas State Capitol',
  matchName: 'Texas State Capitol',
  fromName: true,
  ...CAPITOL,
  view: CAPITOL,
  ...overrides,
});

for (const [label, answer] of [
  ['busy', { rateLimited: true, retryAfterMs: 5000 }],
  ['transient', undefined],
]) {
  test(`a ${label} Nominatim answer does not skip the tile fallbacks`, async () => {
    const building = setup(answer);
    const found = await building.rungs.resolve(ctx(), ladder);
    assert.equal(building.asks.length, 1);
    assert.ok(building.tileCalls.length > 0, 'tiles were consulted');
    assert.equal(found.footprintKind, 'building');

    const grounds = setup(answer);
    const lawn = await grounds.rungs.resolve(
      ctx({ target: 'the Texas Capitol grounds', groundsLike: true }),
      ladder,
    );
    assert.ok(grounds.tileCalls.length > 0, 'grounds tiles were consulted');
    assert.equal(lawn, answer, 'unnamed grounds preserve the retryable answer');
  });
}

test('with no tile answer either, the busy result keeps the mark retryable', async () => {
  const busy = { rateLimited: true, retryAfterMs: 5000 };
  const rungs = createOutlineRungs({
    tiles: { fetchBounds: async () => ({ tiles: [] }) },
    nominatim: { lookup: async () => busy },
  });
  assert.equal(await rungs.resolve(ctx(), ladder), busy);
});

test('"around the Capitol grounds" is still a grounds ask', async () => {
  assert.equal(
    nominatimKindFor({ scope: 'building', groundsLike: true, around: true }),
    'landmark',
  );
  assert.equal(nominatimKindFor({ scope: 'compound', around: true }), null);
  const { rungs, asks } = setup(null);
  const lawn = await rungs.resolve(
    ctx({
      target: 'the Texas Capitol grounds',
      groundsLike: true,
      around: true,
    }),
    ladder,
  );
  assert.equal(asks.length, 1);
});

test('named grounds around a building seed still require the original anchor', async () => {
  // A place-search anchor ~250 m from the dome, outside the Capitol lawn.
  const offLawn = { lat: 30.27265, lon: -97.73925 };
  const d = 0.0003;
  const dome = {
    polygons: [
      [
        [
          [CAPITOL.lon - d, CAPITOL.lat - d],
          [CAPITOL.lon + d, CAPITOL.lat - d],
          [CAPITOL.lon + d, CAPITOL.lat + d],
          [CAPITOL.lon - d, CAPITOL.lat + d],
          [CAPITOL.lon - d, CAPITOL.lat - d],
        ],
      ],
    ],
    class: 'office',
  };
  const lawnRadius = 0.001;
  const namedTiles = [
    {
      areas: [
        {
          name: 'Texas Capitol',
          class: 'park',
          clipped: false,
          rings: [
            [
              [CAPITOL.lon - lawnRadius, CAPITOL.lat - lawnRadius],
              [CAPITOL.lon + lawnRadius, CAPITOL.lat - lawnRadius],
              [CAPITOL.lon + lawnRadius, CAPITOL.lat + lawnRadius],
              [CAPITOL.lon - lawnRadius, CAPITOL.lat + lawnRadius],
              [CAPITOL.lon - lawnRadius, CAPITOL.lat - lawnRadius],
            ],
          ],
        },
      ],
    },
  ];
  const withoutSeed = setup(null, namedTiles);
  assert.equal(
    await withoutSeed.rungs.resolve(
      ctx({
        ...offLawn,
        target: 'the Texas Capitol grounds',
        groundsLike: true,
      }),
      ladder,
    ),
    UNAVAILABLE,
    'the anchor alone is not inside the grounds',
  );
  const { rungs, tileCalls } = setup(dome, namedTiles);
  const lawn = await rungs.resolve(
    ctx({ ...offLawn, target: 'the Texas Capitol grounds', groundsLike: true }),
    ladder,
  );
  assert.ok(tileCalls.length > 0, 'the matching named enclosure was consulted');
  assert.deepEqual(
    tileCalls,
    withoutSeed.tileCalls,
    'a rejected polygon cannot add a shifted grounds-seed lookup',
  );
  assert.equal(
    lawn,
    UNAVAILABLE,
    'a building seed cannot move the original anchor into the named grounds',
  );
});