@aranova/tracking-react 0.14.0 → 0.14.2

package/README.md

@@ -223,8 +223,10 @@ export const { TrackingProvider, useTracking } = createTracking({
 
 ```ts
 import { createSalesClient, resolveConversionConfig, toMinor } from "@aranova/tracking-react";
+import type { AranovaService, AranovaConversion } from "./aranova-services"; // generated by `gen`
 
-const sales = createSalesClient({
+// Bind the generated unions so `service` and `trackConversion` keys are type-checked.
+const sales = createSalesClient<AranovaService, AranovaConversion>({
   apiKey,
   endpoint,
   firing: resolveConversionConfig({ cdnUrl: ARANOVA_CONFIG_URL }),
@@ -235,10 +237,23 @@ await sales.recordSale({
   amount_total_cents: toMinor(250, "CAD"),
   service: "tires",
 }); // records + fires
-sales.trackConversion("phone_click"); // fires a manual event-goal only (no sale recorded)
 ```
 
-Firing is consent-gated, de-duped by `transaction_id`, and no-ops server-side. The config bucket needs an R2 CORS policy — see [conversion-config-schema.md](https://github.com/AranovaIO/aranova_internal/blob/master/docs/tracking-package/conversion-config-schema.md).
+**Manual conversions (multiple forms):** register the trigger once, then call `trackConversion(key)` in each form's submit handler. Keys come from the dashboard Goals tab (event-goals with a `form_submit`/`phone_click`/`cta_click` trigger mapped to a WEBPAGE action) and are emitted as the `AranovaConversion` union by `gen` — so they autocomplete and reject typos:
+
+```ts
+// createTracking({ …, triggers: { manual: { form_submit: {} } } })  // register once
+
+// in the contact form's onSubmit:
+sales.trackConversion("contact_form"); // ✅ typed by AranovaConversion
+// in the demo form's onSubmit:
+sales.trackConversion("demo_request");
+sales.trackConversion("typo"); // ❌ compile error — not a known goal key
+```
+
+Each call fires **only** the WEBPAGE conversion for that goal (no `/sales` write); the SDK no-ops if the goal isn't mapped. Firing is consent-gated, de-duped by `transaction_id`, and no-ops server-side. The config bucket needs an R2 CORS policy — see [conversion-config-schema.md](https://github.com/AranovaIO/aranova_internal/blob/master/docs/tracking-package/conversion-config-schema.md).
+
+> **Before any manual goal exists,** `gen` emits an empty `ARANOVA_CONVERSIONS`, so `AranovaConversion` resolves to `never` — binding it (`createSalesClient<AranovaService, AranovaConversion>`) then makes **every** `trackConversion` call a compile error. Until you've mapped at least one manual goal and re-run `gen`, bind only the service generic (`createSalesClient<AranovaService>(…)`); the conversion key defaults back to `string`.
 
 ## Consent UI
 

package/dist/index.d.mts

@@ -2,8 +2,8 @@ import * as react from 'react';
 import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent } from 'react';
 import { C as ConsentState, T as TrackingInstallSurface, a as TrackingEnvironment, b as TrackingClientContext, c as TrackingParams, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload, F as FormSubmitConfig, f as FormSubmitMetadata, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, P as PhoneConfig, g as ParsedPhone, h as PhoneDisplayFormat } from './phone-utils-Dyk0F14_.mjs';
 export { D as DEFAULT_PHONE_COUNTRY, J as JsonValue, i as TrackedField, j as TrackingInitConfig, k as formSubmitConfigSchema, l as formSubmitMetadataSchema, m as formatPhone, n as formatPhoneAsTyped, o as jsonValueSchema, p as parsePhone, q as phoneField, t as toE164 } from './phone-utils-Dyk0F14_.mjs';
-import { C as ConversionConfig } from './sales-BsJodmh0.mjs';
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, d as ConversionConfigStore, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z as SaleItem, E as SaleItemInput, F as SaleKeysetSortField, H as SaleListPage, I as SaleListQuery, J as SaleListQueryV2, K as SaleService, L as SaleServiceInput, M as SaleSortField, O as SaleSortOrder, Q as SaleSummary, R as SaleSummaryPrevious, T as SaleSummaryQuery, U as SaleSummaryQueryV2, V as SaleSummaryV2, W as SaleUpdateInput, X as SalesBusinessClient, Y as SalesCategoryBreakdown, Z as SalesClient, _ as SalesClientConfig, $ as SalesCustomersClient, a0 as SalesServiceBreakdown, a1 as SalesTransportConfig, a2 as SalesTrendPoint, a3 as SummaryCurrencyDelta, a4 as SummaryDeltas, a5 as SummaryWindow, a6 as SupportedCurrency, a7 as TRACKING_RANGES, a8 as TrackingOverviewRange, a9 as createSalesClient, aa as fetchServices, ab as formatDateInTz, ac as formatMoney, ad as fromMinor, ae as resolveConversionConfig, af as saleCreateSchema, ag as saleItemSchema, ah as saleServiceSchema, ai as saleUpdateSchema, aj as salesRequest, ak as toMinor } from './sales-BsJodmh0.mjs';
+import { C as ConversionConfig } from './sales-Bq7H-Vym.mjs';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, d as ConversionConfigStore, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z as SaleItem, E as SaleItemInput, F as SaleKeysetSortField, H as SaleListPage, I as SaleListQuery, J as SaleListQueryV2, K as SaleService, L as SaleServiceInput, M as SaleSortField, O as SaleSortOrder, Q as SaleSummary, R as SaleSummaryPrevious, T as SaleSummaryQuery, U as SaleSummaryQueryV2, V as SaleSummaryV2, W as SaleUpdateInput, X as SalesBusinessClient, Y as SalesCategoryBreakdown, Z as SalesClient, _ as SalesClientConfig, $ as SalesCustomersClient, a0 as SalesServiceBreakdown, a1 as SalesTransportConfig, a2 as SalesTrendPoint, a3 as SummaryCurrencyDelta, a4 as SummaryDeltas, a5 as SummaryWindow, a6 as SupportedCurrency, a7 as TRACKING_RANGES, a8 as TrackingOverviewRange, a9 as createSalesClient, aa as fetchServices, ab as formatDateInTz, ac as formatMoney, ad as fromMinor, ae as resolveConversionConfig, af as saleCreateSchema, ag as saleItemSchema, ah as saleServiceSchema, ai as saleUpdateSchema, aj as salesRequest, ak as toMinor } from './sales-Bq7H-Vym.mjs';
 import * as src from 'src';
 import { z } from 'zod';
 import { CountryCode } from 'libphonenumber-js';

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import * as react from 'react';
 import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent } from 'react';
 import { C as ConsentState, T as TrackingInstallSurface, a as TrackingEnvironment, b as TrackingClientContext, c as TrackingParams, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload, F as FormSubmitConfig, f as FormSubmitMetadata, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, P as PhoneConfig, g as ParsedPhone, h as PhoneDisplayFormat } from './phone-utils-Dyk0F14_.js';
 export { D as DEFAULT_PHONE_COUNTRY, J as JsonValue, i as TrackedField, j as TrackingInitConfig, k as formSubmitConfigSchema, l as formSubmitMetadataSchema, m as formatPhone, n as formatPhoneAsTyped, o as jsonValueSchema, p as parsePhone, q as phoneField, t as toE164 } from './phone-utils-Dyk0F14_.js';
-import { C as ConversionConfig } from './sales-BsJodmh0.js';
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, d as ConversionConfigStore, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z as SaleItem, E as SaleItemInput, F as SaleKeysetSortField, H as SaleListPage, I as SaleListQuery, J as SaleListQueryV2, K as SaleService, L as SaleServiceInput, M as SaleSortField, O as SaleSortOrder, Q as SaleSummary, R as SaleSummaryPrevious, T as SaleSummaryQuery, U as SaleSummaryQueryV2, V as SaleSummaryV2, W as SaleUpdateInput, X as SalesBusinessClient, Y as SalesCategoryBreakdown, Z as SalesClient, _ as SalesClientConfig, $ as SalesCustomersClient, a0 as SalesServiceBreakdown, a1 as SalesTransportConfig, a2 as SalesTrendPoint, a3 as SummaryCurrencyDelta, a4 as SummaryDeltas, a5 as SummaryWindow, a6 as SupportedCurrency, a7 as TRACKING_RANGES, a8 as TrackingOverviewRange, a9 as createSalesClient, aa as fetchServices, ab as formatDateInTz, ac as formatMoney, ad as fromMinor, ae as resolveConversionConfig, af as saleCreateSchema, ag as saleItemSchema, ah as saleServiceSchema, ai as saleUpdateSchema, aj as salesRequest, ak as toMinor } from './sales-BsJodmh0.js';
+import { C as ConversionConfig } from './sales-Bq7H-Vym.js';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, d as ConversionConfigStore, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z as SaleItem, E as SaleItemInput, F as SaleKeysetSortField, H as SaleListPage, I as SaleListQuery, J as SaleListQueryV2, K as SaleService, L as SaleServiceInput, M as SaleSortField, O as SaleSortOrder, Q as SaleSummary, R as SaleSummaryPrevious, T as SaleSummaryQuery, U as SaleSummaryQueryV2, V as SaleSummaryV2, W as SaleUpdateInput, X as SalesBusinessClient, Y as SalesCategoryBreakdown, Z as SalesClient, _ as SalesClientConfig, $ as SalesCustomersClient, a0 as SalesServiceBreakdown, a1 as SalesTransportConfig, a2 as SalesTrendPoint, a3 as SummaryCurrencyDelta, a4 as SummaryDeltas, a5 as SummaryWindow, a6 as SupportedCurrency, a7 as TRACKING_RANGES, a8 as TrackingOverviewRange, a9 as createSalesClient, aa as fetchServices, ab as formatDateInTz, ac as formatMoney, ad as fromMinor, ae as resolveConversionConfig, af as saleCreateSchema, ag as saleItemSchema, ah as saleServiceSchema, ai as saleUpdateSchema, aj as salesRequest, ak as toMinor } from './sales-Bq7H-Vym.js';
 import * as src from 'src';
 import { z } from 'zod';
 import { CountryCode } from 'libphonenumber-js';

package/dist/index.js

@@ -246,9 +246,10 @@ function isValidGtagId(id) {
 function ensureGtagFunction() {
   window.dataLayer = window.dataLayer || [];
   if (typeof window.gtag === "function") return window.gtag;
-  window.gtag = (...args) => {
-    window.dataLayer?.push(args);
-  };
+  function gtag() {
+    window.dataLayer?.push(arguments);
+  }
+  window.gtag = gtag;
   return window.gtag;
 }
 var SEND_TO_RE = /^AW-[A-Za-z0-9]+\/[A-Za-z0-9_-]+$/;
@@ -626,19 +627,32 @@ function resolveConversionConfig(options) {
   let current = cached?.config ?? options.baked ?? null;
   let etag = cached?.etag ?? null;
   const goalsByKey = /* @__PURE__ */ new Map();
+  const resolveListeners = /* @__PURE__ */ new Set();
   function rebuildIndex() {
     goalsByKey.clear();
     for (const goal of current?.goals ?? []) {
       goalsByKey.set(goal.key, goal);
     }
   }
+  function notifyResolved() {
+    const listeners = [...resolveListeners];
+    resolveListeners.clear();
+    for (const listener of listeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  }
   function adopt(next, nextEtag) {
     if (!next) return;
     if (current && next.config_version <= current.config_version) return;
+    const wasEmpty = current === null;
     current = next;
     etag = nextEtag;
     rebuildIndex();
     writeCache(options.cdnUrl, { etag, config: next });
+    if (wasEmpty) notifyResolved();
   }
   async function revalidate() {
     if (typeof window === "undefined") return;
@@ -663,6 +677,16 @@ function resolveConversionConfig(options) {
     getGoal: (key) => goalsByKey.get(key) ?? null,
     listGoals: () => [...goalsByKey.values()],
     current: () => current,
+    isReady: () => current !== null,
+    onResolve: (listener) => {
+      if (current !== null) {
+        listener();
+        return () => {
+        };
+      }
+      resolveListeners.add(listener);
+      return () => resolveListeners.delete(listener);
+    },
     revalidate
   };
 }
@@ -724,22 +748,39 @@ function thresholdMet(goal, eventType, metadata) {
 function currentPath() {
   return typeof window === "undefined" ? "" : window.location.pathname;
 }
+var MAX_BUFFERED_EVENTS = 50;
 function createConversionAutoFire(store) {
+  const pending = [];
+  let subscribed = false;
+  function fireMatching(eventType, metadata) {
+    for (const goal of store.listGoals()) {
+      if (goal.kind !== "event" || !goal.firing) continue;
+      if (!thresholdMet(goal, eventType, metadata)) continue;
+      const firing = goal.firing;
+      const cents = firing.value_cents ?? null;
+      const currency = firing.currency ?? null;
+      fireConversionWithConsent({
+        sendTo: firing.send_to,
+        value: cents != null && currency ? fromMinor(cents, currency) : null,
+        currency,
+        // Page-scoped txn id → fire once per (goal, path) per session; engagement conversions
+        // shouldn't re-fire as the visitor scrolls back and forth or re-enters a page.
+        transactionId: `auto:${goal.key}:${currentPath()}`
+      });
+    }
+  }
   return {
     onAutomaticEvent(eventType, metadata) {
-      for (const goal of store.listGoals()) {
-        if (goal.kind !== "event" || !goal.firing) continue;
-        if (!thresholdMet(goal, eventType, metadata)) continue;
-        const firing = goal.firing;
-        const cents = firing.value_cents ?? null;
-        const currency = firing.currency ?? null;
-        fireConversionWithConsent({
-          sendTo: firing.send_to,
-          value: cents != null && currency ? fromMinor(cents, currency) : null,
-          currency,
-          // Page-scoped txn id → fire once per (goal, path) per session; engagement conversions
-          // shouldn't re-fire as the visitor scrolls back and forth or re-enters a page.
-          transactionId: `auto:${goal.key}:${currentPath()}`
+      if (store.isReady()) {
+        fireMatching(eventType, metadata);
+        return;
+      }
+      if (pending.length < MAX_BUFFERED_EVENTS) pending.push({ eventType, metadata });
+      if (!subscribed) {
+        subscribed = true;
+        store.onResolve(() => {
+          const buffered = pending.splice(0);
+          for (const event of buffered) fireMatching(event.eventType, event.metadata);
         });
       }
     }
@@ -2449,7 +2490,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "0.14.0";
+var version = "0.14.2";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");