@escape-game-over/atlas 0.1.115 → 0.1.117

package/README.md

@@ -398,7 +398,7 @@ src/            the package — see the export map above for what is reachable
   meta/           head tags: canonical, hreflang, Open Graph, Twitter, robots
   jsonld/         the @graph — one file per node, each linked to Google's docs
   i18n/           defineMessages(), t(), placeholder extraction
-  routes/         defineRoutes(), routeFamily(), merging and collisions
+  routes/         defineRoutes(), route families, merging and collisions
   analytics/      Umami and Google, the Consent Mode defaults, and whether a
                   visitor has to be asked anything at all
   astro/          the only framework-aware code, plus the one component

package/docs/NOT-BUILT.md

@@ -209,10 +209,10 @@ something renders a currency picker, and not before.
 
 `LocalBusinessInput.type` and `ProductInput.alsoA` take bare strings, so
 `"EntertainmentBussiness"` compiles, gets emitted, and is ignored by every
-reader — the silent failure that `RobotsDirective` and `OpenGraphType` were
+reader — the silent failure that `RobotsDirective` was
 tightened to prevent.
 
-They are not the same case. Those two vocabularies are closed; schema.org has
+They are not the same case. That vocabulary is closed; schema.org has
 around 800 types and is still growing. A partial enumeration of an open
 vocabulary rejects types that are perfectly valid, and the response to that is
 to cast past it — at which point the check is theatre. A literal union that

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.115",
+    "version": "0.1.117",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,
@@ -67,7 +67,7 @@
         "@biomejs/biome": "2.6.7",
         "@types/node": "26.6.6",
         "@vitest/coverage-istanbul": "5.1.0",
-        "astro": "7.4.11",
+        "astro": "7.4.12",
         "typescript": "6.0.3",
         "vitest": "5.1.0"
     }

package/src/analytics/ids.ts

@@ -24,18 +24,6 @@ export function invalidId(at: string, message: string): never {
     throw new Error(`${at}: ${message}`);
 }
 
-/** A Meta pixel id: 15 or 16 digits. */
-export const META_PIXEL_ID = /^\d{15,16}$/;
-
-/** A TikTok pixel id: 20 capital letters and digits. */
-export const TIKTOK_PIXEL_ID = /^[A-Z0-9]{20}$/;
-
-/** A Drip account id: digits. */
-export const DRIP_ACCOUNT_ID = /^\d+$/;
-
-/** A Clarity project id: 10 lowercase letters and digits. */
-export const CLARITY_PROJECT_ID = /^[a-z0-9]{10}$/;
-
-/** A UUID, as Umami, Snap and Axon issue them. */
+/** A UUID, as Umami, Snap, Axon and the booking vendors issue them. */
 export const UUID =
     /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;

package/src/analytics/index.ts

@@ -1,18 +1,21 @@
 import type { MetaTag } from "../meta/tag.ts";
 import type { HttpsUrl } from "../url.ts";
-import { type AxonPixelSettings, checkAxonPixel } from "./axon-pixel.ts";
-import { type ClaritySettings, checkClarity } from "./clarity.ts";
-import { checkDrip, type DripSettings } from "./drip.ts";
 import { type GoogleSettings, googleEmits, googleScripts } from "./google.ts";
-import { checkMetaPixel, type MetaPixelSettings } from "./meta-pixel.ts";
-import { checkSnapPixel, type SnapPixelSettings } from "./snap-pixel.ts";
 import type { AnalyticsTags } from "./tags.ts";
-import { checkTikTokPixel, type TikTokPixelSettings } from "./tiktok-pixel.ts";
 import {
     checkUmamiDomains,
     type UmamiSettings,
     umamiScripts,
 } from "./umami.ts";
+import {
+    type AxonPixelSettings,
+    type ClaritySettings,
+    checkVendorIds,
+    type DripSettings,
+    type MetaPixelSettings,
+    type SnapPixelSettings,
+    type TikTokPixelSettings,
+} from "./vendor-settings.ts";
 
 /**
  * Analytics, as head tags.
@@ -29,9 +32,6 @@ import {
  * project states ids; lib decides everything that follows from them.
  */
 
-export type { AxonPixelSettings } from "./axon-pixel.ts";
-export type { ClaritySettings } from "./clarity.ts";
-export type { DripSettings } from "./drip.ts";
 export {
     CONSENT_UPDATE_GLOBAL,
     type ConsentDefaults,
@@ -39,15 +39,20 @@ export {
     type GoogleSettings,
 } from "./google.ts";
 export type { GoogleTagId, NumericId, TagManagerId, Uuid } from "./ids.ts";
-export type { MetaPixelSettings } from "./meta-pixel.ts";
-export type { SnapPixelSettings } from "./snap-pixel.ts";
 export type { AnalyticsTags } from "./tags.ts";
-export type { TikTokPixelSettings } from "./tiktok-pixel.ts";
 export type {
     UmamiReplay,
     UmamiSettings,
     UmamiTracker,
 } from "./umami.ts";
+export type {
+    AxonPixelSettings,
+    ClaritySettings,
+    DripSettings,
+    MetaPixelSettings,
+    SnapPixelSettings,
+    TikTokPixelSettings,
+} from "./vendor-settings.ts";
 
 /** What a project may switch on. A vendor is a key here. */
 export interface AnalyticsSettings {
@@ -85,12 +90,7 @@ export function analyticsScripts(
     if (analytics === undefined) return { head: [], body: [] };
 
     checkUmamiDomains(analytics.umami, origin);
-    checkMetaPixel(analytics.meta, origin);
-    checkTikTokPixel(analytics.tiktok, origin);
-    checkSnapPixel(analytics.snapchat, origin);
-    checkAxonPixel(analytics.axon, origin);
-    checkDrip(analytics.drip, origin);
-    checkClarity(analytics.clarity, origin);
+    checkVendorIds(analytics, origin);
     const google = googleScripts(analytics.google, origin);
     return {
         head: [...google.head, ...umamiScripts(analytics.umami)],

package/src/analytics/storage.ts

@@ -97,7 +97,7 @@ export interface StoredItem {
     readonly consent: ConsentCategory | "none";
 }
 
-export interface StoredItemsOptions {
+export interface StoredItemsOptions<Purpose> {
     /** As passed to `Document`, and with its default: `true`. */
     readonly rememberLocale?: boolean;
     /** As passed to `Document`, and with its default: `false`. */
@@ -109,12 +109,17 @@ export interface StoredItemsOptions {
      */
     readonly booking?: readonly BookingVendor[];
     /**
-     * Rows the site sets first, then by what has to be granted — nothing,
-     * analytics, marketing — and otherwise in catalog order. Off, the rows
-     * come in catalog order: Atlas's own, then each vendor's site row before
-     * its vendor-domain one.
+     * What each row is for, in the project's words — a message key, usually,
+     * since the words are the project's and in every locale.
+     *
+     * Required, and every row this deployment has must be named: a notice
+     * that lists a cookie without a purpose is the one thing it must not
+     * publish, so a vendor switched on, or a row a new Atlas adds, fails the
+     * build until the site says what it is for. Rows this deployment does not
+     * have may be named too; a site keeps its wording when a vendor is
+     * switched off.
      */
-    readonly sort?: boolean;
+    readonly purposes: Readonly<Partial<Record<StoredId, Purpose>>>;
 }
 
 interface Stored {
@@ -264,7 +269,7 @@ type VendorWithOwn = {
         : never;
 }[keyof typeof CATALOG];
 
-/** Catalog order, which is also the order rows come in unsorted. */
+/** Catalog order, which is how rows that sort alike stay ordered. */
 const VENDOR_ORDER: readonly StorageVendor[] = [
     "google-analytics",
     "google-ads",
@@ -372,8 +377,12 @@ const CONSENT_ORDER: readonly StoredItem["consent"][] = [
     "marketing",
 ];
 
-/** The rows the `sort` option puts first come first; ties keep their order. */
-export function compareStoredItems(a: StoredItem, b: StoredItem): number {
+/**
+ * Rows the site sets first, then by what has to be granted — nothing,
+ * analytics, marketing. Ties keep catalog order: Atlas's own, then each
+ * vendor's site row before its vendor-domain one.
+ */
+function compareStoredItems(a: StoredItem, b: StoredItem): number {
     return (
         Number(b.provider === "site") - Number(a.provider === "site") ||
         CONSENT_ORDER.indexOf(a.consent) - CONSENT_ORDER.indexOf(b.consent)
@@ -381,45 +390,22 @@ export function compareStoredItems(a: StoredItem, b: StoredItem): number {
 }
 
 /**
- * Each row with what the project says it is for — a message key, usually,
- * since the words are the project's and in every locale.
- *
- * Throws, naming every row without one, so a vendor switched on, or a row a
- * new Atlas adds, fails the build until the site has said what it is for: a
- * notice that lists a cookie without a purpose is the one thing it must not
- * publish. `purposes` may name rows this deployment does not have; a site
- * keeps its wording when a vendor is switched off.
- */
-export function withPurposes<K>(
-    rows: readonly StoredItem[],
-    purposes: Partial<Record<StoredId, K>>
-): readonly (StoredItem & { readonly purpose: K })[] {
-    const missing = rows.filter((row) => purposes[row.id] === undefined);
-    if (missing.length > 0) {
-        throw new Error(
-            `The storage table has no purpose for ${missing.map((row) => `"${row.id}"`).join(", ")}. Add one for each to the purposes given to withPurposes.`
-        );
-    }
-    return rows.map((row) => ({ ...row, purpose: purposes[row.id] as K }));
-}
-
-/**
- * Everything this deployment keeps on a device: Atlas's own keys, then each
- * loaded vendor's.
+ * Everything this deployment keeps on a device, each row with its purpose:
+ * the site's own rows first, then by what has to be granted.
  *
  * Atlas's rows follow what the page renders, which `Document` decides from
  * its props, so pass the same `rememberLocale` and `rememberCampaign` here.
  * The consent record is listed whenever there is a banner to answer.
  */
-export function storedItems(
+export function storedItems<const Purpose>(
     analytics: AnalyticsSettings | undefined,
-    options: StoredItemsOptions = {}
-): readonly StoredItem[] {
+    options: StoredItemsOptions<Purpose>
+): readonly (StoredItem & { readonly purpose: Purpose })[] {
     const {
         rememberLocale = true,
         rememberCampaign = false,
         booking = [],
-        sort = false,
+        purposes,
     } = options;
     const asked = consentVendors(analytics).length > 0;
 
@@ -506,5 +492,14 @@ export function storedItems(
 
     rows.push(...widgetRows);
 
-    return sort ? rows.toSorted(compareStoredItems) : rows;
+    const missing = rows.filter((row) => purposes[row.id] === undefined);
+    if (missing.length > 0) {
+        throw new Error(
+            `The storage table has no purpose for ${missing.map((row) => `"${row.id}"`).join(", ")}. Add one for each to storedItems' purposes.`
+        );
+    }
+    return rows.toSorted(compareStoredItems).flatMap((row) => {
+        const purpose = purposes[row.id];
+        return purpose === undefined ? [] : [{ ...row, purpose }];
+    });
 }

package/src/analytics/vendor-settings.ts

@@ -0,0 +1,162 @@
+import type { NonEmpty } from "../types.ts";
+import { invalidId, type NumericId, UUID, type Uuid } from "./ids.ts";
+
+/**
+ * Meta's pixel. Marketing: it loads only once a visitor grants that.
+ *
+ * @see https://developers.facebook.com/docs/meta-pixel/get-started
+ * @see https://developers.facebook.com/docs/meta-pixel/reference
+ * @see https://developers.facebook.com/docs/meta-pixel/implementation/gdpr
+ */
+export interface MetaPixelSettings {
+    /** From Events Manager: 15 or 16 digits. Several share one script. */
+    readonly pixelIds: NonEmpty<NumericId>;
+}
+
+/**
+ * TikTok's pixel. Marketing: it loads only once a visitor grants that.
+ *
+ * @see https://ads.tiktok.com/help/article/get-started-pixel
+ * @see https://ads.tiktok.com/help/article/standard-events-parameters
+ * @see https://ads.tiktok.com/help/article/how-to-use-cookies-with-tiktok-pixel
+ */
+export interface TikTokPixelSettings {
+    /** From TikTok Events Manager: 20 capital letters and digits. */
+    readonly pixelIds: NonEmpty<string>;
+}
+
+/**
+ * Snapchat's pixel. Marketing: it loads only once a visitor grants that.
+ *
+ * @see https://businesshelp.snapchat.com/s/article/pixel-direct-implementation
+ * @see https://forbusiness.snapchat.com/en-US/blog/the-snap-pixel-how-it-works-and-how-to-install-it
+ */
+export interface SnapPixelSettings {
+    /** From Snap's Events Manager: a UUID. */
+    readonly pixelIds: NonEmpty<Uuid>;
+}
+
+/**
+ * AppLovin's Axon pixel. Marketing: it loads only once a visitor grants that.
+ *
+ * @see https://support.applovin.com/en/growth/promoting-your-websites/axon-pixel-integration/axon-pixel-native-js
+ * @see https://support.applovin.com/en/growth/promoting-your-websites/axon-pixel-integration/events-and-objects
+ */
+export interface AxonPixelSettings {
+    /** From the Axon dashboard: a UUID. */
+    readonly eventKey: Uuid;
+}
+
+/**
+ * Drip's site tracking. Marketing: it loads only once a visitor grants that.
+ *
+ * @see https://help.drip.com/hc/en-us/articles/4424702539789-Install-Your-JavaScript-Snippet
+ */
+export interface DripSettings {
+    /** From Drip's Site Setup: digits, the `_dcs.account` of its snippet. */
+    readonly accountId: NumericId;
+}
+
+/**
+ * Microsoft Clarity. It has a cookieless mode, so like Google it loads for
+ * every visitor: without consent it records each page view on its own and sets
+ * no cookie, and the visitor's answer switches its cookies on or off.
+ *
+ * @see https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-setup
+ * @see https://learn.microsoft.com/en-us/clarity/setup-and-installation/consent-mode
+ * @see https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-consent-api-v2
+ */
+export interface ClaritySettings {
+    /** From the Clarity project's settings: 10 lowercase letters and digits. */
+    readonly projectId: string;
+}
+
+/** What these vendors' checks read: their slice of `AnalyticsSettings`. */
+interface VendorSettings {
+    readonly meta?: MetaPixelSettings;
+    readonly tiktok?: TikTokPixelSettings;
+    readonly snapchat?: SnapPixelSettings;
+    readonly axon?: AxonPixelSettings;
+    readonly drip?: DripSettings;
+    readonly clarity?: ClaritySettings;
+}
+
+/** One vendor's id: where it is set, its shape, and where to copy it from. */
+interface IdCheck {
+    readonly ids: (settings: VendorSettings) => readonly string[];
+    /** What the id is called, as the vendor calls it. */
+    readonly name: string;
+    readonly shape: RegExp;
+    /** The shape in words, for the error. */
+    readonly is: string;
+    readonly from: string;
+}
+
+/**
+ * Each vendor's id check: one row each, read in one loop. Only the shape, the
+ * words and the place to copy it from differ between vendors.
+ */
+const ID_CHECKS: readonly IdCheck[] = [
+    {
+        ids: (settings) => settings.meta?.pixelIds ?? [],
+        name: "Meta pixel id",
+        shape: /^\d{15,16}$/,
+        is: "15 or 16 digits",
+        from: "Events Manager",
+    },
+    {
+        ids: (settings) => settings.tiktok?.pixelIds ?? [],
+        name: "TikTok pixel id",
+        shape: /^[A-Z0-9]{20}$/,
+        is: "20 capital letters and digits",
+        from: "TikTok Events Manager",
+    },
+    {
+        ids: (settings) => settings.snapchat?.pixelIds ?? [],
+        name: "Snap pixel id",
+        shape: UUID,
+        is: "a UUID",
+        from: "Snap's Events Manager",
+    },
+    {
+        ids: (settings) =>
+            settings.axon === undefined ? [] : [settings.axon.eventKey],
+        name: "Axon event key",
+        shape: UUID,
+        is: "a UUID",
+        from: "the Axon dashboard",
+    },
+    {
+        ids: (settings) =>
+            settings.drip === undefined ? [] : [settings.drip.accountId],
+        name: "Drip account id",
+        shape: /^\d+$/,
+        is: "all digits",
+        from: "Drip's Site Setup",
+    },
+    {
+        ids: (settings) =>
+            settings.clarity === undefined ? [] : [settings.clarity.projectId],
+        name: "Clarity project id",
+        shape: /^[a-z0-9]{10}$/,
+        is: "10 lowercase letters and digits",
+        from: "the Clarity project's settings",
+    },
+];
+
+/**
+ * Fails the build on an id that is not what its vendor issues: configured,
+ * emitted, and reporting nowhere is the failure it prevents.
+ */
+export function checkVendorIds(settings: VendorSettings, at: string): void {
+    for (const check of ID_CHECKS) {
+        for (const id of check.ids(settings)) {
+            if (!check.shape.test(id)) {
+                invalidId(
+                    at,
+                    `${check.name} "${id}" is not ${check.is}, so it would report nowhere. Copy it from ${check.from}.`
+                );
+            }
+        }
+    }
+}

package/src/astro/axon-event.ts

@@ -1,5 +1,6 @@
 import type { CurrencyCode } from "../currency.ts";
 import { readConsent } from "./consent.ts";
+import { vendors } from "./vendors.ts";
 
 /**
  * Axon's events that a site without a cart sends. The cart and purchase events
@@ -15,9 +16,6 @@ export interface AxonEventData {
 }
 
 /** What `axon-pixel.ts` defines once marketing is granted. */
-interface AxonWindow {
-    axon?: (...args: unknown[]) => void;
-}
 
 /**
  * Records an event with Axon's pixel — a lead sent, an account made.
@@ -28,7 +26,7 @@ interface AxonWindow {
  */
 export function axonEvent(event: AxonEvent, data?: AxonEventData): void {
     if (readConsent()?.marketing !== "granted") return;
-    const axon = (window as unknown as AxonWindow).axon;
+    const axon = vendors().axon;
     if (data === undefined) axon?.("track", event);
     else axon?.("track", event, data);
 }

package/src/astro/axon-pixel.ts

@@ -1,8 +1,9 @@
 import { appendScript } from "./append-script.ts";
 import type { ConsentGated } from "./consent-gate.ts";
+import { vendors } from "./vendors.ts";
 
 /** Axon's `axon`: a queue until its scripts arrive and replay it. */
-interface Axon {
+export interface Axon {
     (...args: unknown[]): void;
     performOperation?: (...args: unknown[]) => void;
     operationQueue: unknown[];
@@ -10,10 +11,6 @@ interface Axon {
     eventKey: string;
 }
 
-interface PixelWindow {
-    axon?: Axon;
-}
-
 const SCRIPTS = [
     "https://s.axon.ai/pixel.js",
     "https://res4.applovin.com/p/l/loader.iife.js",
@@ -21,7 +18,7 @@ const SCRIPTS = [
 
 /** Axon's own base code, as it defines `axon` before the scripts load. */
 function defineAxon(eventKey: string): Axon {
-    const global = window as unknown as PixelWindow;
+    const global = vendors();
     if (global.axon !== undefined) return global.axon;
     // `arguments` is the list of whatever a call passed, which every regular
     // `function` gets without declaring it (an arrow function does not). The

package/src/astro/clarity-event.ts

@@ -1,4 +1,5 @@
 import type { DeclaredEvent } from "./event-data.ts";
+import { vendors } from "./vendors.ts";
 
 /**
  * The project's Clarity events. Clarity carries a name and nothing else, so
@@ -17,9 +18,6 @@ import type { DeclaredEvent } from "./event-data.ts";
 export interface ClarityEvents {}
 
 /** What `clarity.ts` defines once the page has loaded. */
-interface ClarityWindow {
-    clarity?: (...args: unknown[]) => void;
-}
 
 /**
  * Marks the current Clarity recording with a named event — a form sent, a
@@ -29,5 +27,5 @@ interface ClarityWindow {
  * sets no cookie. Dropped before Clarity loads, or where it is not configured.
  */
 export function clarityEvent(name: DeclaredEvent<ClarityEvents>): void {
-    (window as unknown as ClarityWindow).clarity?.("event", name);
+    vendors().clarity?.("event", name);
 }

package/src/astro/clarity.ts

@@ -1,19 +1,16 @@
 import { appendScript } from "./append-script.ts";
 import type { ConsentChoices } from "./consent.ts";
+import { vendors } from "./vendors.ts";
 
 /** Clarity's `clarity`: a queue until its script arrives and replays it. */
-interface Clarity {
+export interface Clarity {
     (...args: unknown[]): void;
     q?: unknown[];
 }
 
-interface ClarityWindow {
-    clarity?: Clarity;
-}
-
 /** Clarity's own base code, as it defines `clarity` before the script loads. */
 function defineClarity(): Clarity {
-    const global = window as unknown as ClarityWindow;
+    const global = vendors();
     if (global.clarity !== undefined) return global.clarity;
     // `arguments` is the list of whatever a call passed, which every regular
     // `function` gets without declaring it (an arrow function does not). The

package/src/astro/consent.ts

@@ -12,6 +12,8 @@ export type {
     ConsentChoices,
 } from "../analytics/consent-storage.ts";
 
+import { vendors } from "./vendors.ts";
+
 /**
  * The browser half of consent: remembering an answer, expiring it, and handing
  * it to Google.
@@ -120,12 +122,7 @@ export function recordConsent(choices: ConsentChoices): void {
  * copy of that list.
  */
 export function applyConsent(choices: ConsentChoices): void {
-    const update = (
-        window as unknown as Record<
-            string,
-            ((c: ConsentChoices) => void) | undefined
-        >
-    )[CONSENT_UPDATE_GLOBAL];
+    const update = vendors()[CONSENT_UPDATE_GLOBAL];
     // Only the categories, so a record's date does not ride along.
     update?.({ analytics: choices.analytics, marketing: choices.marketing });
 }

package/src/astro/drip-event.ts

@@ -1,5 +1,6 @@
 import { readConsent } from "./consent.ts";
 import type { DeclaredEvent, EventDataArgs } from "./event-data.ts";
+import { vendors } from "./vendors.ts";
 
 /**
  * The project's Drip events — the actions its workflows start on — each with
@@ -18,9 +19,6 @@ import type { DeclaredEvent, EventDataArgs } from "./event-data.ts";
 export interface DripEvents {}
 
 /** What `drip.ts` defines once marketing is granted. */
-interface DripWindow {
-    _dcq?: unknown[][];
-}
 
 /**
  * Records an event with Drip, to start a workflow — a lead sent, a voucher
@@ -38,7 +36,7 @@ export function dripEvent<E extends DeclaredEvent<DripEvents>>(
     >
 ): void {
     if (readConsent()?.marketing !== "granted") return;
-    const queue = (window as unknown as DripWindow)._dcq;
+    const queue = vendors()._dcq;
     if (properties === undefined) queue?.push(["track", action]);
     else queue?.push(["track", action, properties]);
 }

package/src/astro/drip.ts

@@ -1,11 +1,6 @@
 import { appendScript } from "./append-script.ts";
 import type { ConsentGated } from "./consent-gate.ts";
-
-/** Drip's globals: a queue of calls, and the account its script reports to. */
-interface DripWindow {
-    _dcq?: unknown[][];
-    _dcs?: { account?: string };
-}
+import { vendors } from "./vendors.ts";
 
 /**
  * Drip, loaded on the first grant. Its script records visits by itself, so
@@ -19,7 +14,7 @@ export function drip(accountId: string): ConsentGated {
         grant: () => {
             if (loaded) return;
             loaded = true;
-            const global = window as unknown as DripWindow;
+            const global = vendors();
             global._dcq ??= [];
             global._dcs ??= {};
             global._dcs.account = accountId;

package/src/astro/escape-navigator-consent.ts

@@ -1,6 +1,7 @@
 import { ESCAPE_NAVIGATOR_LOADER } from "../booking/escape-navigator.ts";
 import { appendScript } from "./append-script.ts";
 import { CONSENT_EVENT, type ConsentChoices, readConsent } from "./consent.ts";
+import { vendors } from "./vendors.ts";
 
 /**
  * Escape Navigator's consent, from the visitor's answer on this site: its
@@ -13,12 +14,7 @@ function escapeNavigatorConsent(choices: ConsentChoices | undefined) {
     };
 }
 
-interface EscapeNavigatorGlobal {
-    __pendingConsent?: { analytics: boolean; ads: boolean };
-    setConsent?: (consent: { analytics: boolean; ads: boolean }) => void;
-}
-
-const host = window as unknown as { EscapeNavigator?: EscapeNavigatorGlobal };
+const host = vendors();
 
 // Before the loader runs, which reads the pending answer as it starts: its
 // tags never load on an answer the visitor has not given.

package/src/astro/escapeall-calendar.ts

@@ -1,15 +1,12 @@
 import { appendScript } from "./append-script.ts";
+import { vendors } from "./vendors.ts";
 
 /**
  * Draws each EscapeAll calendar on the page, once EscapeAll's script has
  * loaded: the call its store scripts make, with the settings the component
  * wrote on the element.
  */
-// Its script builds selectors by appending to the one it is given, so the
-// calendar is named by its id, not handed over as an element.
-type Calendar = (selector: string, settings: Record<string, unknown>) => void;
-
-const host = window as unknown as { GetBookingCalendra?: Calendar };
+const host = vendors();
 
 const elements = [...document.querySelectorAll("[data-escapeall-company]")];
 const [first] = elements;

package/src/astro/google-event.ts

@@ -1,9 +1,7 @@
-import {
-    GOOGLE_EVENT_GLOBAL,
-    type GoogleEventSink,
-} from "../analytics/google.ts";
+import { GOOGLE_EVENT_GLOBAL } from "../analytics/google.ts";
 import type { CurrencyCode } from "../currency.ts";
 import type { DeclaredEvent, EventDataArgs } from "./event-data.ts";
+import { vendors } from "./vendors.ts";
 
 /** GA4's recommended events that carry items and revenue. */
 const ECOMMERCE_EVENTS = [
@@ -110,9 +108,7 @@ export function googleEvent<E extends GoogleEventName>(
     event: E,
     ...[data]: GoogleEventArgs<E>
 ): void {
-    const send = (
-        window as unknown as Record<string, GoogleEventSink | undefined>
-    )[GOOGLE_EVENT_GLOBAL];
+    const send = vendors()[GOOGLE_EVENT_GLOBAL];
     send?.(
         event,
         data,