@escape-game-over/atlas 0.1.41 → 0.1.42

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.41",
+    "version": "0.1.42",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,

package/src/astro/attribution.ts

@@ -87,6 +87,14 @@ export function campaign(): Campaign {
     }
 }
 
+/**
+ * A moment as a Google Ads conversion import reads it:
+ * `2026-09-24 12:42:10+00:00`. In UTC, so the file needs no time zone setting.
+ */
+export function conversionTime(at: Date = new Date()): string {
+    return `${at.toISOString().slice(0, 19).replace("T", " ")}+00:00`;
+}
+
 /**
  * A cookie's value. `document.cookie` is always `name=value; name=value`, so a
  * split reads it — `cookieStore.get` would too, but is async and newer than

package/src/astro/client.ts

@@ -24,4 +24,5 @@ export {
 export * from "./filters.ts";
 export * from "./filters-view.ts";
 export { data, ref, refs } from "./ref.ts";
+export * from "./umami-event.ts";
 export * from "./youtube.ts";

package/src/astro/umami-event.ts

@@ -0,0 +1,24 @@
+/**
+ * Records a named event with Umami — a form sent, a deck downloaded — from a
+ * client script.
+ *
+ * Umami's own script defines `window.umami` once it has loaded; atlas emits
+ * that script from `analytics.umami`. Before then, or where a blocker stopped
+ * it, there is nothing to call, and the event is dropped rather than thrown:
+ * an analytics call must never be the reason a page misbehaves.
+ *
+ * The data goes to Umami as it is, so it should carry what the visitor chose,
+ * never who they are. For an event on a plain click, Umami's
+ * `data-umami-event` attribute needs no script at all.
+ */
+export function umamiEvent(
+    name: string,
+    data?: Readonly<Record<string, string>>
+): void {
+    const umami = (
+        window as unknown as {
+            umami?: { track(event: string, data?: object): void };
+        }
+    ).umami;
+    umami?.track(name, data);
+}