@escape-game-over/atlas 0.1.75 → 0.1.76

package/docs/client-scripts.md

@@ -581,7 +581,9 @@ googleEvent("form_submissions_contact"); // does not compile
 A name nobody declared does not compile, so a typo cannot quietly become a
 second event in a report — which is why this is not a `string` with the standard
 names offered for autocomplete. Data declared with a required field is required
-at every call. The interfaces are `GoogleCustomEvents`, `MetaCustomEvents`,
+at every call. A Google declaration may reuse a recommended name —
+`generate_lead` with an agency's own parameters, say — and then takes what was
+declared instead of GA4's. The interfaces are `GoogleCustomEvents`, `MetaCustomEvents`,
 `TikTokCustomEvents`, `UmamiEvents`, `DripEvents` and `ClarityEvents`; Clarity
 carries a name only, so its entries are all `undefined`. Snap and Axon take no
 declarations because they accept no names but their own.

package/package.json

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

package/src/astro/google-event.ts

@@ -78,22 +78,24 @@ export interface GoogleEventData {
 }
 
 /**
- * A recommended event takes GA4's parameters; `purchase` without its three
- * reports a sale of nothing, possibly twice. A declared one takes what the
- * project declared.
+ * A declared event takes what the project declared — checked first, so a
+ * project can declare a recommended name too, when its Tag Manager wants that
+ * name with its own parameters (an agency's `generate_lead`, say). Otherwise a
+ * recommended event takes GA4's parameters; `purchase` without its three
+ * reports a sale of nothing, possibly twice.
  */
 type GoogleEventArgs<E extends GoogleEventName> =
-    E extends GoogleRecommendedEvent
-        ? E extends "purchase"
-            ? [
-                  data: GoogleEventData & {
-                      value: number;
-                      currency: CurrencyCode;
-                      transaction_id: string;
-                  },
-              ]
-            : [data?: GoogleEventData]
-        : EventDataArgs<GoogleCustomEvents[E & keyof GoogleCustomEvents]>;
+    E extends DeclaredEvent<GoogleCustomEvents>
+        ? EventDataArgs<GoogleCustomEvents[E]>
+        : E extends "purchase"
+          ? [
+                data: GoogleEventData & {
+                    value: number;
+                    currency: CurrencyCode;
+                    transaction_id: string;
+                },
+            ]
+          : [data?: GoogleEventData];
 
 /**
  * Records an event with Google — a lead sent, a booking made — through