@aranova/tracking-react 0.13.0 → 0.14.1

package/dist/sales.mjs

@@ -1,3 +1,87 @@
+// ../tracking-core/src/consent.ts
+var CONSENT_STATE_KEY = "consent_state";
+var grantedListeners = /* @__PURE__ */ new Set();
+function onConsentGranted(listener) {
+  grantedListeners.add(listener);
+  return () => {
+    grantedListeners.delete(listener);
+  };
+}
+function getConsentState() {
+  if (typeof window === "undefined") return "pending";
+  try {
+    const storedState = window.localStorage.getItem(CONSENT_STATE_KEY);
+    if (storedState === "granted" || storedState === "denied") return storedState;
+  } catch {
+  }
+  return "pending";
+}
+
+// ../tracking-core/src/gtag.ts
+var SEND_TO_RE = /^AW-[A-Za-z0-9]+\/[A-Za-z0-9_-]+$/;
+function isValidSendTo(sendTo) {
+  return SEND_TO_RE.test(sendTo);
+}
+function fireGtagConversion(input) {
+  if (typeof window === "undefined" || typeof window.gtag !== "function") return false;
+  if (!isValidSendTo(input.sendTo)) return false;
+  const params = { send_to: input.sendTo };
+  if (input.value != null) params.value = input.value;
+  if (input.currency) params.currency = input.currency;
+  if (input.transactionId) params.transaction_id = input.transactionId;
+  try {
+    window.gtag("event", "conversion", params);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ../tracking-core/src/resources/conversion-firing.ts
+var DEDUP_PREFIX = "_aranova_conv_";
+var MAX_PENDING = 100;
+var pendingQueue = [];
+function dedupKey(input) {
+  return `${DEDUP_PREFIX}${input.transactionId ?? ""}:${input.sendTo}`;
+}
+function alreadyFired(input) {
+  if (!input.transactionId || typeof window === "undefined") return false;
+  try {
+    return window.sessionStorage.getItem(dedupKey(input)) !== null;
+  } catch {
+    return false;
+  }
+}
+function markFired(input) {
+  if (!input.transactionId || typeof window === "undefined") return;
+  try {
+    window.sessionStorage.setItem(dedupKey(input), "1");
+  } catch {
+  }
+}
+function fireOnce(input) {
+  if (alreadyFired(input)) return;
+  if (fireGtagConversion(input)) markFired(input);
+}
+function fireConversionWithConsent(input) {
+  const state = getConsentState();
+  if (state === "denied") return;
+  if (state === "pending") {
+    if (pendingQueue.length >= MAX_PENDING) pendingQueue.shift();
+    pendingQueue.push(input);
+    return;
+  }
+  fireOnce(input);
+}
+function flushPendingConversions() {
+  if (getConsentState() !== "granted") return;
+  while (pendingQueue.length > 0) {
+    const input = pendingQueue.shift();
+    if (input) fireOnce(input);
+  }
+}
+if (typeof window !== "undefined") onConsentGranted(flushPendingConversions);
+
 // ../tracking-core/src/events/page-view.ts
 import { z } from "zod";
 var pageViewMetadataSchema = z.object({
@@ -81,22 +165,98 @@ async function salesRequest(config, method, path, body) {
   return await response.json();
 }
 
+// ../tracking-core/src/resources/sales/money.ts
+var MINOR_UNIT_EXPONENT = {
+  USD: 2,
+  CAD: 2
+};
+function exponentFor(currency) {
+  return MINOR_UNIT_EXPONENT[currency] ?? 2;
+}
+function toMinor(amount, currency) {
+  return Math.round(amount * 10 ** exponentFor(currency));
+}
+function fromMinor(cents, currency) {
+  return cents / 10 ** exponentFor(currency);
+}
+function formatMoney(cents, currency, locale) {
+  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(
+    fromMinor(cents, currency)
+  );
+}
+function formatDateInTz(iso, timeZone, opts, locale) {
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return iso;
+  return new Intl.DateTimeFormat(locale, {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    ...opts,
+    timeZone
+  }).format(date);
+}
+
 // ../tracking-core/src/resources/sales/client.ts
+function fireRecordedConversions(firing, input, recorded, sale, currency) {
+  if (!firing) return;
+  const txnBase = input.external_id ?? sale.id;
+  for (const item of recorded) {
+    if (!item.service) continue;
+    const config = firing.getFiring(item.service);
+    if (!config) continue;
+    const cents = item.amount_cents ?? config.value_cents ?? null;
+    fireConversionWithConsent({
+      sendTo: config.send_to,
+      value: cents != null ? fromMinor(cents, currency) : null,
+      currency: config.currency ?? currency,
+      transactionId: `${txnBase}:${item.service}`
+    });
+  }
+}
 function createSalesClient(config) {
-  return {
-    async record(input) {
-      const currency = input.currency ?? config.defaultCurrency;
-      if (!currency) {
-        throw new Error(
-          "record: `currency` is required (pass it on the sale or set config.defaultCurrency)"
-        );
+  async function record(input) {
+    const currency = input.currency ?? config.defaultCurrency;
+    if (!currency) {
+      throw new Error(
+        "record: `currency` is required (pass it on the sale or set config.defaultCurrency)"
+      );
+    }
+    const body = {
+      ...input,
+      currency,
+      occurred_at: input.occurred_at ?? (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const sale = await salesRequest(config, "POST", "/sales", body);
+    const recorded = input.services?.length ? input.services.map((s) => ({
+      service: s.service,
+      amount_cents: s.amount_cents
+    })) : [
+      {
+        service: input.service,
+        amount_cents: input.amount_total_cents ?? null
       }
-      const body = {
-        ...input,
+    ];
+    fireRecordedConversions(config.firing, input, recorded, sale, currency);
+    return sale;
+  }
+  return {
+    record,
+    // recordSale is the intent-revealing alias — same behavior, clearer call site.
+    recordSale: record,
+    trackConversion(key, options) {
+      const firing = config.firing?.getFiring(key);
+      if (!firing) return;
+      const currency = firing.currency ?? options?.currency ?? config.defaultCurrency ?? null;
+      const cents = firing.value_cents ?? null;
+      const value = options?.value ?? (cents != null && currency ? fromMinor(cents, currency) : null);
+      fireConversionWithConsent({
+        sendTo: firing.send_to,
+        value,
         currency,
-        occurred_at: input.occurred_at ?? (/* @__PURE__ */ new Date()).toISOString()
-      };
-      return salesRequest(config, "POST", "/sales", body);
+        transactionId: options?.transactionId ?? null
+      });
     },
     async list(query) {
       const { cursor, limit, sort, order, want_total, ...filters } = query ?? {};
@@ -190,39 +350,6 @@ function createSalesClient(config) {
   };
 }
 
-// ../tracking-core/src/resources/sales/money.ts
-var MINOR_UNIT_EXPONENT = {
-  USD: 2,
-  CAD: 2
-};
-function exponentFor(currency) {
-  return MINOR_UNIT_EXPONENT[currency] ?? 2;
-}
-function toMinor(amount, currency) {
-  return Math.round(amount * 10 ** exponentFor(currency));
-}
-function fromMinor(cents, currency) {
-  return cents / 10 ** exponentFor(currency);
-}
-function formatMoney(cents, currency, locale) {
-  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(
-    fromMinor(cents, currency)
-  );
-}
-function formatDateInTz(iso, timeZone, opts, locale) {
-  const date = new Date(iso);
-  if (Number.isNaN(date.getTime())) return iso;
-  return new Intl.DateTimeFormat(locale, {
-    year: "numeric",
-    month: "short",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    ...opts,
-    timeZone
-  }).format(date);
-}
-
 // ../tracking-core/src/resources/sales/schema.ts
 import { z as z2 } from "zod";
 var SUPPORTED_CURRENCIES = ["USD", "CAD"];