@escape-game-over/atlas 0.1.116 → 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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.116",
+    "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/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,

package/src/astro/google-map.ts

@@ -6,6 +6,7 @@ import { reportDevError } from "./dev-log.ts";
 import { element } from "./element.ts";
 import { triggered } from "./load-script.ts";
 import { data } from "./ref.ts";
+import { GOOGLE_MAPS_CALLBACK, vendors } from "./vendors.ts";
 
 /** What `GoogleMap.astro` hands the element, serialised. */
 export interface GoogleMapConfig {
@@ -27,20 +28,17 @@ export interface GoogleMapConfig {
     }[];
 }
 
-const CALLBACK = "__atlasGoogleMaps";
-
 let loading: Promise<typeof google.maps> | undefined;
 
 /** The Maps JavaScript API, fetched once per page however many maps ask. */
 export function loadGoogleMaps(apiKey: string): Promise<typeof google.maps> {
     loading ??= new Promise((resolve, reject) => {
-        (window as unknown as Record<string, () => void>)[CALLBACK] = () =>
-            resolve(google.maps);
+        vendors()[GOOGLE_MAPS_CALLBACK] = () => resolve(google.maps);
         const params = {
             key: apiKey,
             v: "weekly",
             loading: "async",
-            callback: CALLBACK,
+            callback: GOOGLE_MAPS_CALLBACK,
         };
         appendScript(
             `https://maps.googleapis.com/maps/api/js?${new URLSearchParams(params)}`

package/src/astro/meta-event.ts

@@ -1,5 +1,6 @@
 import type { CurrencyCode } from "../currency.ts";
 import type { DeclaredEvent, EventDataArgs } from "./event-data.ts";
+import { vendors } from "./vendors.ts";
 
 /** Meta's standard events, which its ad optimisation understands by name. */
 const META_STANDARD_EVENTS = [
@@ -66,9 +67,6 @@ type MetaEventArgs<E extends MetaEventName> = E extends MetaStandardEvent
     : EventDataArgs<MetaCustomEvents[E & keyof MetaCustomEvents]>;
 
 /** What `meta-pixel.ts` defines once marketing is granted. */
-interface MetaWindow {
-    fbq?: (...args: unknown[]) => void;
-}
 
 /**
  * Records an event with Meta's pixel — a lead sent, a booking made. A declared
@@ -83,7 +81,7 @@ export function metaEvent<E extends MetaEventName>(
     event: E,
     ...[data]: MetaEventArgs<E>
 ): void {
-    const fbq = (window as unknown as MetaWindow).fbq;
+    const fbq = vendors().fbq;
     const method = (META_STANDARD_EVENTS as readonly string[]).includes(event)
         ? "track"
         : "trackCustom";

package/src/astro/meta-pixel.ts

@@ -1,8 +1,9 @@
 import { appendScript } from "./append-script.ts";
 import type { ConsentGated } from "./consent-gate.ts";
+import { vendors } from "./vendors.ts";
 
 /** Meta's `fbq`: a queue until `fbevents.js` arrives and replays it. */
-interface Fbq {
+export interface Fbq {
     (...args: unknown[]): void;
     callMethod?: (...args: unknown[]) => void;
     queue: unknown[];
@@ -11,16 +12,11 @@ interface Fbq {
     version: string;
 }
 
-interface PixelWindow {
-    fbq?: Fbq;
-    _fbq?: Fbq;
-}
-
 const SCRIPT = "https://connect.facebook.net/en_US/fbevents.js";
 
 /** Meta's own base code, as it defines `fbq` before the script loads. */
 function defineFbq(): Fbq {
-    const global = window as unknown as PixelWindow;
+    const global = vendors();
     if (global.fbq !== undefined) return global.fbq;
     // `arguments` is the list of whatever a call passed, which every regular
     // `function` gets without declaring it (an arrow function does not). The
@@ -57,7 +53,7 @@ export function metaPixel(pixelIds: readonly string[]): ConsentGated {
             appendScript(SCRIPT);
         },
         revoke: () => {
-            (window as unknown as PixelWindow).fbq?.("consent", "revoke");
+            vendors().fbq?.("consent", "revoke");
         },
     };
 }

package/src/astro/snap-event.ts

@@ -1,5 +1,6 @@
 import type { CurrencyCode } from "../currency.ts";
 import { readConsent } from "./consent.ts";
+import { vendors } from "./vendors.ts";
 
 /** Snap's standard events that a website sends. */
 export type SnapStandardEvent =
@@ -37,9 +38,6 @@ type SnapEventArgs<E extends SnapStandardEvent> = E extends "PURCHASE"
     : [data?: SnapEventData];
 
 /** What `snap-pixel.ts` defines once marketing is granted. */
-interface SnapWindow {
-    snaptr?: (...args: unknown[]) => void;
-}
 
 /**
  * Records a standard event with Snap's pixel — a lead sent, a booking made.
@@ -53,7 +51,7 @@ export function snapEvent<E extends SnapStandardEvent>(
     ...[data]: SnapEventArgs<E>
 ): void {
     if (readConsent()?.marketing !== "granted") return;
-    const snaptr = (window as unknown as SnapWindow).snaptr;
+    const snaptr = vendors().snaptr;
     if (data === undefined) snaptr?.("track", event);
     else snaptr?.("track", event, data);
 }