@africanies/angular-web-sdk 0.1.11 → 0.1.13

package/libs/africanies-ui/src/lib/forms/phone-input/phone-input.utils.ts

@@ -0,0 +1,275 @@
+import { countryFlagUrl } from '@africanies/africanies-core';
+
+import {
+  PHONE_DIAL_CODES,
+  PHONE_MAX_NATIONAL_DIGITS,
+  PHONE_MIN_NATIONAL_DIGITS,
+} from './phone-codes';
+import type { PhoneCountryOption, PhoneNumberValue } from './phone-input.types';
+
+const regionNames =
+  typeof Intl !== 'undefined' && 'DisplayNames' in Intl
+    ? new Intl.DisplayNames(['en'], { type: 'region' })
+    : null;
+
+/** Digits only from a phone draft. */
+export function phoneDigitsOnly(value: string | null | undefined): string {
+  return (value ?? '').replace(/\D/g, '');
+}
+
+/** Normalize ISO2 to uppercase two letters, or `''`. */
+export function normalizePhoneIso2(iso2: string | null | undefined): string {
+  const code = (iso2 ?? '').trim().toUpperCase();
+  return /^[A-Z]{2}$/.test(code) ? code : '';
+}
+
+/** Dial code for an ISO2 (with `+`), or `''` when unknown. */
+export function dialCodeForIso2(iso2: string | null | undefined): string {
+  const code = normalizePhoneIso2(iso2);
+  return code ? (PHONE_DIAL_CODES[code] ?? '') : '';
+}
+
+/** English country name from ISO2 (falls back to the code). */
+export function phoneCountryName(iso2: string): string {
+  const code = normalizePhoneIso2(iso2);
+  if (!code) {
+    return '';
+  }
+  try {
+    return regionNames?.of(code) ?? code;
+  } catch {
+    return code;
+  }
+}
+
+/** All dial-code countries for the picker (sorted by name). */
+export function phoneCountryOptions(): PhoneCountryOption[] {
+  return Object.keys(PHONE_DIAL_CODES)
+    .map((iso2) => {
+      const dialCode = PHONE_DIAL_CODES[iso2]!;
+      return {
+        iso2,
+        dialCode,
+        name: phoneCountryName(iso2),
+        flagUrl: countryFlagUrl(iso2, { width: 40 }),
+      };
+    })
+    .sort((a, b) => a.name.localeCompare(b.name));
+}
+
+/**
+ * Filter dial-code countries by name, ISO2, or dial digits.
+ * Digit matching is skipped when the query has no digits — otherwise
+ * `''.includes('')` would keep every country for letter-only searches.
+ */
+export function filterPhoneCountries(
+  countries: readonly PhoneCountryOption[],
+  query: string,
+): PhoneCountryOption[] {
+  const q = query.trim().toLowerCase();
+  if (!q) {
+    return [...countries];
+  }
+  const qDigits = phoneDigitsOnly(q);
+  return countries.filter((row) => {
+    if (
+      row.name.toLowerCase().includes(q) ||
+      row.iso2.toLowerCase().includes(q) ||
+      row.dialCode.toLowerCase().includes(q)
+    ) {
+      return true;
+    }
+    return qDigits.length > 0
+      ? phoneDigitsOnly(row.dialCode).includes(qDigits)
+      : false;
+  });
+}
+
+/**
+ * Match an E.164 / international string to the longest known dial code.
+ * Prefers `hintIso2` when several countries share the same dial code (e.g. `+1`).
+ */
+export function matchDialCode(
+  e164OrInternational: string,
+  hintIso2?: string | null,
+): { iso2: string; dialCode: string; nationalDigits: string } | null {
+  const digits = phoneDigitsOnly(e164OrInternational);
+  if (!digits) {
+    return null;
+  }
+
+  const hint = normalizePhoneIso2(hintIso2);
+  if (hint) {
+    const hintDial = PHONE_DIAL_CODES[hint];
+    if (hintDial) {
+      const hintDigits = phoneDigitsOnly(hintDial);
+      if (digits.startsWith(hintDigits)) {
+        return {
+          iso2: hint,
+          dialCode: hintDial,
+          nationalDigits: digits.slice(hintDigits.length),
+        };
+      }
+    }
+  }
+
+  let best: { iso2: string; dialCode: string; nationalDigits: string } | null =
+    null;
+  for (const [iso2, dialCode] of Object.entries(PHONE_DIAL_CODES)) {
+    const dialDigits = phoneDigitsOnly(dialCode);
+    if (!digits.startsWith(dialDigits)) {
+      continue;
+    }
+    const nationalDigits = digits.slice(dialDigits.length);
+    if (
+      !best ||
+      dialDigits.length > phoneDigitsOnly(best.dialCode).length
+    ) {
+      best = { iso2, dialCode, nationalDigits };
+    }
+  }
+  return best;
+}
+
+/**
+ * Strip a leading dial code from a stored phone (classic `removeDialCode`).
+ * Returns national digits for prefilling the input.
+ */
+export function removeDialCode(
+  phone: string | null | undefined,
+  hintIso2?: string | null,
+): string {
+  const raw = (phone ?? '').trim();
+  if (!raw) {
+    return '';
+  }
+  const matched = matchDialCode(raw, hintIso2);
+  if (matched) {
+    return matched.nationalDigits;
+  }
+  return phoneDigitsOnly(raw);
+}
+
+/** Group national digits for readable display (… + last 4). */
+export function formatNationalDigits(digits: string): string {
+  const clean = phoneDigitsOnly(digits).slice(0, PHONE_MAX_NATIONAL_DIGITS);
+  if (!clean) {
+    return '';
+  }
+  if (clean.length <= 4) {
+    return clean;
+  }
+  const end = clean.slice(-4);
+  const head = clean.slice(0, -4).replace(/(\d{3})(?=\d)/g, '$1 ').trim();
+  return `${head} ${end}`.trim();
+}
+
+/**
+ * Build the structured value (or `null` when empty).
+ */
+export function buildPhoneNumberValue(
+  iso2: string,
+  nationalDraft: string,
+): PhoneNumberValue | null {
+  const countryCode = normalizePhoneIso2(iso2);
+  const dialCode = dialCodeForIso2(countryCode);
+  if (!countryCode || !dialCode) {
+    return null;
+  }
+
+  const nationalDigits = phoneDigitsOnly(nationalDraft).slice(
+    0,
+    PHONE_MAX_NATIONAL_DIGITS,
+  );
+  if (!nationalDigits) {
+    return null;
+  }
+
+  const number = formatNationalDigits(nationalDigits);
+  const e164Number = `${dialCode}${nationalDigits}`;
+  const internationalNumber = `${dialCode} ${number}`.trim();
+  // Trunk-prefix `0` for national display when digits omit it (classic ngx shape).
+  const nationalNumber = nationalDigits.startsWith('0')
+    ? number
+    : `0${number}`;
+
+  return {
+    number,
+    internationalNumber,
+    nationalNumber,
+    e164Number,
+    countryCode,
+    dialCode,
+  };
+}
+
+/**
+ * Canonical outbound phone string — prefer E.164 from a structured value.
+ */
+export function phoneToE164(
+  phone: PhoneNumberValue | string | null | undefined,
+): string {
+  if (phone == null) {
+    return '';
+  }
+  if (typeof phone === 'string') {
+    const digits = phoneDigitsOnly(phone);
+    if (!digits) {
+      return '';
+    }
+    return phone.trim().startsWith('+') ? `+${digits}` : phone.trim();
+  }
+  return phone.e164Number?.trim() || '';
+}
+
+/**
+ * Soft validity: has dial code + enough national digits (not full libphonenumber).
+ */
+export function isPhoneNumberComplete(
+  phone: PhoneNumberValue | null | undefined,
+): boolean {
+  if (!phone?.e164Number) {
+    return false;
+  }
+  const national = phoneDigitsOnly(phone.number);
+  return (
+    national.length >= PHONE_MIN_NATIONAL_DIGITS &&
+    national.length <= PHONE_MAX_NATIONAL_DIGITS
+  );
+}
+
+/**
+ * Split an incoming control value (E.164 string or structured) into UI state.
+ */
+export function parsePhoneControlValue(
+  value: string | PhoneNumberValue | null | undefined,
+  fallbackIso2: string,
+): { iso2: string; nationalDigits: string } {
+  const fallback = normalizePhoneIso2(fallbackIso2) || 'US';
+
+  if (value == null || value === '') {
+    return { iso2: fallback, nationalDigits: '' };
+  }
+
+  if (typeof value === 'object') {
+    const iso2 = normalizePhoneIso2(value.countryCode) || fallback;
+    const national =
+      phoneDigitsOnly(value.number) ||
+      phoneDigitsOnly(value.nationalNumber) ||
+      removeDialCode(value.e164Number, iso2);
+    return { iso2, nationalDigits: national };
+  }
+
+  const matched = matchDialCode(value, fallback);
+  if (matched) {
+    return {
+      iso2: matched.iso2,
+      nationalDigits: matched.nationalDigits,
+    };
+  }
+
+  return {
+    iso2: fallback,
+    nationalDigits: phoneDigitsOnly(value),
+  };
+}

package/libs/africanies-ui/src/lib/forms/radio/radio.component.ts

@@ -118,6 +118,9 @@ let nextRadioId = 0;
     </fieldset>
   `,
 })
+/**
+ * Radio group following the shared AFRICANIES form field pattern.
+ */
 export class RadioComponent<T = string> implements ControlValueAccessor {
   private readonly modeColor = inject(ModeColorService);
 

package/libs/africanies-ui/src/lib/forms/search-combobox/search-combobox.component.ts

@@ -269,6 +269,9 @@ const PANEL_POSITIONS: ConnectedPosition[] = [
     }
   `,
 })
+/**
+ * Generic type-as-you-search combobox with a debounced async lookup and overlay result list.
+ */
 export class SearchComboboxComponent<T> implements ControlValueAccessor {
   private readonly destroyRef = inject(DestroyRef);
 

package/libs/africanies-ui/src/lib/forms/select/select.component.ts

@@ -443,6 +443,9 @@ const SELECT_PANEL_POSITIONS: ConnectedPosition[] = [
     }
   `,
 })
+/**
+ * Option select following the shared AFRICANIES form field pattern.
+ */
 export class SelectComponent<T = string> implements ControlValueAccessor {
   private readonly modal = inject(ModalService, { optional: true });
   protected readonly modeColor = inject(ModeColorService);

package/libs/africanies-ui/src/lib/forms/text-input/text-input.component.ts

@@ -115,6 +115,9 @@ export type TextInputType =
     }
   `,
 })
+/**
+ * Single-line text field — **reference** form control for `@africanies/africanies-ui`.
+ */
 export class TextInputComponent implements ControlValueAccessor {
   /** Stable ids so label / aria-describedby stay paired across re-renders. */
   protected readonly controlId = `africanies-text-input-${++nextTextInputId}`;

package/libs/africanies-ui/src/lib/forms/textarea/textarea.component.ts

@@ -82,6 +82,9 @@ let nextTextareaId = 0;
     }
   `,
 })
+/**
+ * Multi-line text field following the shared form-control pattern (`shared AFRICANIES form field pattern`). Supports prefix/suffix slots, field-level `error`, and {@link ControlValueAccessor}.
+ */
 export class TextareaComponent implements ControlValueAccessor {
   protected readonly controlId = `africanies-textarea-${++nextTextareaId}`;
   protected readonly hintId = `${this.controlId}-hint`;

package/libs/africanies-ui/src/lib/forms/toggle/toggle.component.ts

@@ -105,6 +105,9 @@ let nextToggleId = 0;
     </div>
   `,
 })
+/**
+ * Boolean switch following the shared AFRICANIES form field pattern.
+ */
 export class ToggleComponent implements ControlValueAccessor {
   private readonly modeColor = inject(ModeColorService);
 

package/libs/africanies-ui/src/lib/image/image.component.ts

@@ -95,6 +95,9 @@ export type ImageFit = 'cover' | 'contain';
     </div>
   `,
 })
+/**
+ * Image with a shaped loading frame and fallback while the asset fetches or if it fails to render.
+ */
 export class ImageComponent {
   private readonly imgRef = viewChild<ElementRef<HTMLImageElement>>('img');
 

package/libs/africanies-ui/src/lib/info-popover/info-popover-content.directive.ts

@@ -20,4 +20,7 @@ import { Directive } from '@angular/core';
   selector: '[africaniesInfoPopoverContent]',
   standalone: true,
 })
+/**
+ * Marks projected content as the panel body for {@link InfoPopoverComponent}.
+ */
 export class InfoPopoverContentDirective {}

package/libs/africanies-ui/src/lib/info-popover/info-popover-trigger.directive.ts

@@ -18,4 +18,7 @@ import { Directive } from '@angular/core';
   selector: '[africaniesInfoPopoverTrigger]',
   standalone: true,
 })
+/**
+ * Marks projected content as the custom trigger for {@link InfoPopoverComponent}.
+ */
 export class InfoPopoverTriggerDirective {}

package/libs/africanies-ui/src/lib/info-popover/info-popover.component.ts

@@ -205,6 +205,9 @@ const PLACEMENT_POSITIONS: Record<InfoPopoverPlacement, ConnectedPosition[]> = {
     </ng-template>
   `,
 })
+/**
+ * Hover / focus / click info panel with a white card, optional title, and fully projected body content (any child component or markup).
+ */
 export class InfoPopoverComponent {
   protected readonly panelId = `africanies-info-popover-${++nextInfoPopoverId}`;
 

package/libs/africanies-ui/src/lib/layout/app-shell-content-header.component.ts

@@ -71,6 +71,9 @@ import { PageHeaderComponent } from './page-header.component';
     }
   `,
 })
+/**
+ * Content chrome above the app-shell body: Back, breadcrumbs, then the page title and optional subtitle.
+ */
 export class AppShellContentHeaderComponent {
   private readonly router = inject(Router);
 

package/libs/africanies-ui/src/lib/layout/app-shell-header-slot.directive.ts

@@ -9,4 +9,7 @@ import { Directive } from '@angular/core';
   selector: '[africaniesAppShellHeader]',
   standalone: true,
 })
+/**
+ * Marks projected content as the custom header for {@link AppShellComponent}.
+ */
 export class AppShellHeaderSlotDirective {}

package/libs/africanies-ui/src/lib/layout/app-shell-header.component.ts

@@ -38,6 +38,9 @@ export type AppShellHeaderDensity = 'mobile' | 'tablet' | 'desktop';
   selector: '[africaniesAppShellHeaderStart]',
   standalone: true,
 })
+/**
+ * Marks projected content as extra leading chrome in {@link AppShellHeaderComponent}.
+ */
 export class AppShellHeaderStartDirective {}
 
 /**
@@ -47,6 +50,9 @@ export class AppShellHeaderStartDirective {}
   selector: '[africaniesAppShellHeaderEnd]',
   standalone: true,
 })
+/**
+ * Marks projected content as extra trailing chrome in {@link AppShellHeaderComponent}.
+ */
 export class AppShellHeaderEndDirective {}
 
 /**
@@ -206,6 +212,9 @@ export class AppShellHeaderEndDirective {}
     </div>
   `,
 })
+/**
+ * Product header bar for {@link AppShellComponent}: a short time-of-day kicker plus the given name, local weather, live clock, notification inbox drawer, and avatar menu. Breadcrumbs and Back belong in the content column via {@link AppShellContentHeaderComponent}.
+ */
 export class AppShellHeaderComponent {
   private readonly notificationsDrawer = inject(NotificationDrawerService);
   private readonly destroyRef = inject(DestroyRef);

package/libs/africanies-ui/src/lib/layout/app-shell.component.ts

@@ -85,6 +85,9 @@ export type AppShellLayoutPreview = 'mobile' | 'tablet' | 'desktop';
   },
   templateUrl: './app-shell.component.html',
 })
+/**
+ * Application chrome scaffold: side nav + sticky header + constrained content.
+ */
 export class AppShellComponent {
   protected readonly modeColor = inject(ModeColorService);
   protected readonly logoMiniUrl = inject(AFRICANIES_BRAND_LOGO_MINI_URL);

package/libs/africanies-ui/src/lib/layout/header-weather.spec.ts

@@ -66,18 +66,15 @@ describe('loadHeaderWeather', () => {
     ).resolves.toBeNull();
   });
 
-  it('reads Open-Meteo after IP geolocation and reverse-geocodes the city', async () => {
+  it('does not label the device with the IP city', async () => {
     const fetchFn = jest.fn(async (url: string) => {
       if (String(url).includes('geojs')) {
         return jsonResponse({
-          latitude: '9.0765',
-          longitude: '7.3986',
+          latitude: '6.45',
+          longitude: '3.4',
           city: 'Lagos',
         });
       }
-      if (String(url).includes('bigdatacloud')) {
-        return jsonResponse({ city: 'Abuja', locality: 'Abuja' });
-      }
       return jsonResponse({
         current: { weather_code: 61, temperature_2m: 27.4 },
       });
@@ -88,38 +85,18 @@ describe('loadHeaderWeather', () => {
     ).resolves.toEqual({
       kind: 'rain',
       temperatureC: 27.4,
-      city: 'Abuja',
-    });
-    expect(fetchFn).toHaveBeenCalledTimes(3);
-  });
-
-  it('falls back to the IP city when reverse geocode is empty', async () => {
-    const fetchFn = jest.fn(async (url: string) => {
-      if (String(url).includes('geojs')) {
-        return jsonResponse({ latitude: 1, longitude: 2, city: 'Lagos' });
-      }
-      if (String(url).includes('bigdatacloud')) {
-        return jsonResponse({});
-      }
-      return jsonResponse({ current: { weather_code: 0, temperature_2m: 30 } });
-    });
-
-    await expect(
-      loadHeaderWeather(fetchFn as unknown as typeof fetch),
-    ).resolves.toEqual({
-      kind: 'clear',
-      temperatureC: 30,
-      city: 'Lagos',
+      city: undefined,
     });
+    expect(fetchFn).not.toHaveBeenCalledWith(
+      expect.stringContaining('geocoding-api'),
+    );
   });
 
-  it('reuses the same-hour session cache', async () => {
+  it('reuses the same-hour session cache when the device city was resolved', async () => {
+    stubDeviceAt(9.0765, 7.3986);
     const fetchFn = jest.fn(async (url: string) => {
-      if (String(url).includes('geojs')) {
-        return jsonResponse({ latitude: 1, longitude: 2 });
-      }
-      if (String(url).includes('bigdatacloud')) {
-        return jsonResponse({ city: 'Accra' });
+      if (String(url).includes('geocoding-api')) {
+        return jsonResponse({ results: [{ name: 'Abuja' }] });
       }
       return jsonResponse({ current: { weather_code: 0, temperature_2m: 30 } });
     });
@@ -127,17 +104,16 @@ describe('loadHeaderWeather', () => {
     const first = await loadHeaderWeather(fetchFn as unknown as typeof fetch);
     const second = await loadHeaderWeather(fetchFn as unknown as typeof fetch);
 
-    expect(first).toEqual(second);
-    expect(fetchFn).toHaveBeenCalledTimes(3);
+    expect(first).toEqual({ kind: 'clear', temperatureC: 30, city: 'Abuja' });
+    expect(second).toEqual(first);
+    expect(fetchFn).toHaveBeenCalledTimes(2);
   });
 
   it('fetches again when the cached hour no longer matches', async () => {
+    stubDeviceAt(9.0765, 7.3986);
     const fetchFn = jest.fn(async (url: string) => {
-      if (String(url).includes('geojs')) {
-        return jsonResponse({ latitude: 1, longitude: 2, city: 'Lagos' });
-      }
-      if (String(url).includes('bigdatacloud')) {
-        return jsonResponse({ city: 'Lagos' });
+      if (String(url).includes('geocoding-api')) {
+        return jsonResponse({ results: [{ name: 'Abuja' }] });
       }
       return jsonResponse({ current: { weather_code: 0, temperature_2m: 30.2 } });
     });
@@ -146,7 +122,7 @@ describe('loadHeaderWeather', () => {
     const cacheKey = Object.keys(sessionStorage).find((key) =>
       key.startsWith('africanies-header-weather'),
     );
-    expect(cacheKey).toBeDefined();
+    expect(cacheKey).toBe('africanies-header-weather-v8');
     const stored = JSON.parse(sessionStorage.getItem(cacheKey!) ?? '{}') as {
       hour?: string;
     };
@@ -154,35 +130,15 @@ describe('loadHeaderWeather', () => {
     sessionStorage.setItem(cacheKey!, JSON.stringify(stored));
 
     await loadHeaderWeather(fetchFn as unknown as typeof fetch);
-    expect(fetchFn).toHaveBeenCalledTimes(6);
+    expect(fetchFn).toHaveBeenCalledTimes(4);
   });
 
-  it('uses browser coordinates when geolocation succeeds', async () => {
-    Object.defineProperty(navigator, 'geolocation', {
-      configurable: true,
-      value: {
-        getCurrentPosition: (success: PositionCallback) => {
-          success({
-            coords: {
-              latitude: 9.0765,
-              longitude: 7.3986,
-              accuracy: 10,
-              altitude: null,
-              altitudeAccuracy: null,
-              heading: null,
-              speed: null,
-              toJSON: () => ({}),
-            },
-            timestamp: Date.now(),
-            toJSON: () => ({}),
-          } as GeolocationPosition);
-        },
-      },
-    });
+  it('uses device coordinates and ignores the IP city', async () => {
+    stubDeviceAt(9.0765, 7.3986);
 
     const fetchFn = jest.fn(async (url: string) => {
-      if (String(url).includes('bigdatacloud')) {
-        return jsonResponse({ city: 'Abuja' });
+      if (String(url).includes('geocoding-api')) {
+        return jsonResponse({ results: [{ name: 'Abuja' }] });
       }
       if (String(url).includes('geojs')) {
         return jsonResponse({
@@ -201,34 +157,15 @@ describe('loadHeaderWeather', () => {
       temperatureC: 31,
       city: 'Abuja',
     });
+    expect(fetchFn).not.toHaveBeenCalledWith(expect.stringContaining('geojs'));
   });
 
-  it('uses the IP city when browser geo succeeds but reverse geocode is empty', async () => {
-    Object.defineProperty(navigator, 'geolocation', {
-      configurable: true,
-      value: {
-        getCurrentPosition: (success: PositionCallback) => {
-          success({
-            coords: {
-              latitude: 9.0765,
-              longitude: 7.3986,
-              accuracy: 10,
-              altitude: null,
-              altitudeAccuracy: null,
-              heading: null,
-              speed: null,
-              toJSON: () => ({}),
-            },
-            timestamp: Date.now(),
-            toJSON: () => ({}),
-          } as GeolocationPosition);
-        },
-      },
-    });
+  it('omits the city when the device fix has no place name', async () => {
+    stubDeviceAt(9.0765, 7.3986);
 
     const fetchFn = jest.fn(async (url: string) => {
-      if (String(url).includes('bigdatacloud')) {
-        return jsonResponse({ city: '' });
+      if (String(url).includes('geocoding-api')) {
+        return jsonResponse({ results: [{ name: '' }] });
       }
       if (String(url).includes('geojs')) {
         return jsonResponse({
@@ -245,13 +182,14 @@ describe('loadHeaderWeather', () => {
     ).resolves.toEqual({
       kind: 'clear',
       temperatureC: 31,
-      city: 'Lagos',
+      city: undefined,
     });
+    expect(fetchFn).not.toHaveBeenCalledWith(expect.stringContaining('geojs'));
   });
 
   it('refetches when the hour cache has weather but no city', async () => {
     sessionStorage.setItem(
-      'africanies-header-weather-v7',
+      'africanies-header-weather-v8',
       JSON.stringify({
         hour: `${new Date().getFullYear()}-${new Date().getMonth()}-${new Date().getDate()}-${new Date().getHours()}`,
         kind: 'cloudy',
@@ -274,7 +212,7 @@ describe('loadHeaderWeather', () => {
     ).resolves.toEqual({
       kind: 'cloudy',
       temperatureC: 25,
-      city: 'Lagos',
+      city: undefined,
     });
     expect(fetchFn).toHaveBeenCalled();
   });
@@ -304,6 +242,36 @@ describe('headerWeatherIcon', () => {
   });
 });
 
+function stubDeviceAt(latitude: number, longitude: number): void {
+  Object.defineProperty(navigator, 'permissions', {
+    configurable: true,
+    value: {
+      query: async () => ({ state: 'granted' }),
+    },
+  });
+  Object.defineProperty(navigator, 'geolocation', {
+    configurable: true,
+    value: {
+      getCurrentPosition: (success: PositionCallback) => {
+        success({
+          coords: {
+            latitude,
+            longitude,
+            accuracy: 10,
+            altitude: null,
+            altitudeAccuracy: null,
+            heading: null,
+            speed: null,
+            toJSON: () => ({}),
+          },
+          timestamp: Date.now(),
+          toJSON: () => ({}),
+        } as GeolocationPosition);
+      },
+    },
+  });
+}
+
 function jsonResponse(body: unknown): Pick<Response, 'ok' | 'json'> {
   return {
     ok: true,