TREK/client/src/repo/reverseGeocodeRepo.test.ts

import { beforeEach, describe, expect, it, vi } from 'vitest';
import { mapsApi } from '../api/client';
import { isEffectivelyOffline } from '../sync/networkMode';
import { reverseGeocodeRepo } from './reverseGeocodeRepo';

vi.mock('../sync/networkMode', () => ({ isEffectivelyOffline: vi.fn(() => false) }));
vi.mock('../api/client', () => ({ mapsApi: { reverse: vi.fn() } }));

beforeEach(() => {
  vi.clearAllMocks();
  reverseGeocodeRepo.clear();
  vi.mocked(isEffectivelyOffline).mockReturnValue(false);
  vi.mocked(mapsApi.reverse).mockResolvedValue({ name: 'Zugspitze', address: 'Zugspitze, Grainau, Bayern' });
});

describe('reverse geocoded place names', () => {
  it('FE-REVERSE-GEOCODE-001: asks the maps route with the coordinate and the place language', async () => {
    await expect(reverseGeocodeRepo.placeName(47.42123, 10.98456, 'de')).resolves.toBe('Zugspitze');
    expect(mapsApi.reverse).toHaveBeenCalledWith(47.42123, 10.98456, 'de');
  });

  it('FE-REVERSE-GEOCODE-002: the same point twice is one request, another language or point is another', async () => {
    const first = reverseGeocodeRepo.placeName(47.4, 11.1, 'de');
    const again = reverseGeocodeRepo.placeName(47.400001, 11.100001, 'de');
    expect(await first).toBe(await again);
    expect(mapsApi.reverse).toHaveBeenCalledTimes(1);
    await reverseGeocodeRepo.placeName(47.4, 11.1, 'en');
    await reverseGeocodeRepo.placeName(47.41, 11.1, 'de');
    expect(mapsApi.reverse).toHaveBeenCalledTimes(3);
  });

  it('FE-REVERSE-GEOCODE-003: falls back to the first part of the address and to null', async () => {
    vi.mocked(mapsApi.reverse).mockResolvedValueOnce({ name: null, address: 'Höllentalanger, Grainau' });
    await expect(reverseGeocodeRepo.placeName(47.1, 11, 'de')).resolves.toBe('Höllentalanger');
    vi.mocked(mapsApi.reverse).mockResolvedValueOnce({ name: '  ', address: null });
    await expect(reverseGeocodeRepo.placeName(47.2, 11, 'de')).resolves.toBeNull();
  });

  it('FE-REVERSE-GEOCODE-004: a failed lookup is not cached, so the point is asked again', async () => {
    vi.mocked(mapsApi.reverse).mockRejectedValueOnce(new Error('boom'));
    await expect(reverseGeocodeRepo.placeName(47.3, 11, 'de')).rejects.toThrow('boom');
    await expect(reverseGeocodeRepo.placeName(47.3, 11, 'de')).resolves.toBe('Zugspitze');
    expect(mapsApi.reverse).toHaveBeenCalledTimes(2);
  });

  it('FE-REVERSE-GEOCODE-005: offline never reaches the network', async () => {
    vi.mocked(isEffectivelyOffline).mockReturnValue(true);
    await expect(reverseGeocodeRepo.placeName(47.5, 11, 'de')).rejects.toThrow('Offline');
    expect(mapsApi.reverse).not.toHaveBeenCalled();
  });

  it('FE-REVERSE-GEOCODE-006: runs at most two lookups at once and starts the rest as they finish', async () => {
    const resolvers: Array<(value: { name: string; address: null }) => void> = [];
    vi.mocked(mapsApi.reverse).mockImplementation(
      () =>
        new Promise((resolve) => {
          resolvers.push(resolve);
        })
    );
    const names = [1, 2, 3].map((n) => reverseGeocodeRepo.placeName(46 + n, 11, 'de'));
    expect(mapsApi.reverse).toHaveBeenCalledTimes(2);
    resolvers[0]({ name: 'One', address: null });
    await names[0];
    await vi.waitFor(() => expect(mapsApi.reverse).toHaveBeenCalledTimes(3));
    resolvers[1]({ name: 'Two', address: null });
    resolvers[2]({ name: 'Three', address: null });
    await expect(Promise.all(names)).resolves.toEqual(['One', 'Two', 'Three']);
  });
  it('FE-REVERSE-GEOCODE-007: an answered name outlives a reload and is not asked for again', async () => {
    await reverseGeocodeRepo.placeName(47.42, 11.01, 'de');
    vi.resetModules();
    const reloaded = (await import('./reverseGeocodeRepo')).reverseGeocodeRepo;
    const network = (await import('../api/client')).mapsApi;
    vi.mocked(network.reverse).mockClear();

    await expect(reloaded.placeName(47.42, 11.01, 'de')).resolves.toBe('Zugspitze');
    expect(reloaded.knownName(47.42, 11.01, 'de')).toBe('Zugspitze');
    expect(network.reverse).not.toHaveBeenCalled();
  });

  it('FE-REVERSE-GEOCODE-008: a name answered before is there offline too', async () => {
    await reverseGeocodeRepo.placeName(47.43, 11.02, 'de');
    vi.mocked(isEffectivelyOffline).mockReturnValue(true);
    await expect(reverseGeocodeRepo.placeName(47.43, 11.02, 'de')).resolves.toBe('Zugspitze');
  });

  it('FE-REVERSE-GEOCODE-009: knows a name only once it was answered, and per language', async () => {
    expect(reverseGeocodeRepo.knownName(47.44, 11.03, 'de')).toBeUndefined();
    await reverseGeocodeRepo.placeName(47.44, 11.03, 'de');
    expect(reverseGeocodeRepo.knownName(47.44, 11.03, 'de')).toBe('Zugspitze');
    expect(reverseGeocodeRepo.knownName(47.44, 11.03, 'en')).toBeUndefined();
  });

  it('FE-REVERSE-GEOCODE-010: keeps no answer without a name, so it is asked again later', async () => {
    vi.mocked(mapsApi.reverse).mockResolvedValueOnce({ name: null, address: null });
    await expect(reverseGeocodeRepo.placeName(47.45, 11.04, 'de')).resolves.toBeNull();
    expect(reverseGeocodeRepo.knownName(47.45, 11.04, 'de')).toBeUndefined();
  });

  it('FE-REVERSE-GEOCODE-011: drops the oldest kept name past the limit and survives broken storage', async () => {
    const seeded = Array.from({ length: 2000 }, (_, n) => [`${n},0|de`, `Place ${n}`]);
    localStorage.setItem('trek-place-names-v1', JSON.stringify(seeded));
    vi.resetModules();
    const reloaded = (await import('./reverseGeocodeRepo')).reverseGeocodeRepo;
    await reloaded.placeName(47.46, 11.05, 'de');
    const kept = JSON.parse(localStorage.getItem('trek-place-names-v1') ?? '[]') as [string, string][];
    expect(kept).toHaveLength(2000);
    expect(kept[0][0]).toBe('1,0|de');
    expect(kept[kept.length - 1]).toEqual(['47.46000,11.05000|de', 'Zugspitze']);

    localStorage.setItem('trek-place-names-v1', '{broken');
    vi.resetModules();
    const fresh = (await import('./reverseGeocodeRepo')).reverseGeocodeRepo;
    expect(fresh.knownName(47.46, 11.05, 'de')).toBeUndefined();
  });
});