@aranova/tracking-react 0.12.0 → 0.12.2

package/dist/index.js

@@ -24,9 +24,11 @@ __export(src_exports, {
   ConsentBanner: () => ConsentBanner,
   DEFAULT_PHONE_COUNTRY: () => DEFAULT_PHONE_COUNTRY,
   GoogleAdsTracking: () => GoogleAdsTracking,
-  PhoneConfigContext: () => PhoneConfigContext,
+  NAMED_RANGES: () => NAMED_RANGES,
   PhoneField: () => PhoneField,
+  SUPPORTED_CURRENCIES: () => SUPPORTED_CURRENCIES,
   TRACKING_PARAM_KEYS: () => TRACKING_PARAM_KEYS,
+  TRACKING_RANGES: () => TRACKING_RANGES,
   captureTrackingParamsFromLocation: () => captureTrackingParamsFromLocation,
   createSalesClient: () => createSalesClient,
   createTracking: () => createTracking,
@@ -43,6 +45,11 @@ __export(src_exports, {
   parsePhone: () => parsePhone,
   phoneField: () => phoneField,
   resetConsent: () => resetConsent,
+  saleCreateSchema: () => saleCreateSchema,
+  saleItemSchema: () => saleItemSchema,
+  saleServiceSchema: () => saleServiceSchema,
+  saleUpdateSchema: () => saleUpdateSchema,
+  salesRequest: () => salesRequest,
   setConsentState: () => setConsentState,
   toE164: () => toE164,
   toMinor: () => toMinor,
@@ -73,31 +80,26 @@ function buildConsentPayload(state) {
   };
 }
 function getConsentState() {
-  if (typeof window === "undefined")
-    return "pending";
+  if (typeof window === "undefined") return "pending";
   const storedState = window.localStorage.getItem(CONSENT_STATE_KEY);
-  if (storedState === "granted" || storedState === "denied")
-    return storedState;
+  if (storedState === "granted" || storedState === "denied") return storedState;
   return "pending";
 }
 function setConsentState(state) {
-  if (typeof window === "undefined")
-    return;
+  if (typeof window === "undefined") return;
   window.localStorage.setItem(CONSENT_STATE_KEY, state);
   window.localStorage.setItem(CONSENT_TIMESTAMP_KEY, (/* @__PURE__ */ new Date()).toISOString());
   if (typeof window.gtag === "function")
     window.gtag("consent", "update", buildConsentPayload(state));
 }
 function resetConsent() {
-  if (typeof window === "undefined")
-    return;
+  if (typeof window === "undefined") return;
   window.localStorage.removeItem(CONSENT_STATE_KEY);
   window.localStorage.removeItem(CONSENT_TIMESTAMP_KEY);
 }
 function restoreStoredConsent() {
   const consentState = getConsentState();
-  if (consentState === "granted" || consentState === "denied")
-    setConsentState(consentState);
+  if (consentState === "granted" || consentState === "denied") setConsentState(consentState);
   return consentState;
 }
 
@@ -154,8 +156,7 @@ function isValidGtagId(id) {
 }
 function ensureGtagFunction() {
   window.dataLayer = window.dataLayer || [];
-  if (typeof window.gtag === "function")
-    return window.gtag;
+  if (typeof window.gtag === "function") return window.gtag;
   window.gtag = (...args) => {
     window.dataLayer?.push(args);
   };
@@ -172,17 +173,17 @@ function applyDefaultConsentState() {
   });
 }
 function loadGtagScript(gtagId) {
-  if (typeof document === "undefined")
-    return;
+  if (typeof document === "undefined") return;
   const marker = getScriptMarker("gtag-loader");
-  const existingScript = document.querySelector(`script[${TRACKING_SCRIPT_ATTRIBUTE}="${marker}"]`);
-  if (existingScript)
-    return;
+  const existingScript = document.querySelector(
+    `script[${TRACKING_SCRIPT_ATTRIBUTE}="${marker}"]`
+  );
+  if (existingScript) return;
   const script = document.createElement("script");
   script.async = true;
   script.src = `${GTAG_SCRIPT_HOST}?id=${encodeURIComponent(gtagId)}`;
   script.setAttribute(TRACKING_SCRIPT_ATTRIBUTE, marker);
-  document.head.appendChild(script);
+  document.head.append(script);
 }
 function initializeGtag(gtagId) {
   const gtag = ensureGtagFunction();
@@ -190,21 +191,19 @@ function initializeGtag(gtagId) {
   gtag("config", gtagId);
 }
 function bootstrapGoogleAdsTracking(gtagId) {
-  if (typeof window === "undefined" || typeof document === "undefined")
-    return;
-  if (!isValidGtagId(gtagId))
-    return;
+  if (typeof window === "undefined" || typeof document === "undefined") return;
+  if (!isValidGtagId(gtagId)) return;
   applyDefaultConsentState();
   loadGtagScript(gtagId);
   initializeGtag(gtagId);
   restoreStoredConsent();
 }
 function bootstrapMultipleGtags(gtagIds) {
-  if (typeof window === "undefined" || typeof document === "undefined")
-    return;
-  const ids = Object.values(gtagIds).filter(isValidGtagId);
-  if (ids.length === 0)
-    return;
+  if (typeof window === "undefined" || typeof document === "undefined") return;
+  const ids = Object.values(gtagIds).filter(
+    (id) => typeof id === "string" && isValidGtagId(id)
+  );
+  if (ids.length === 0) return;
   applyDefaultConsentState();
   loadGtagScript(ids[0]);
   const gtag = ensureGtagFunction();
@@ -256,18 +255,15 @@ function getTrackingQueryValues(searchParams) {
   }, {});
 }
 function getCookieValueFromDocument(key) {
-  if (typeof document === "undefined")
-    return null;
+  if (typeof document === "undefined") return null;
   const cookies = document.cookie ? document.cookie.split("; ") : [];
   const match = cookies.find((cookie) => cookie.startsWith(`${key}=`));
-  if (!match)
-    return null;
+  if (!match) return null;
   const [, rawValue = ""] = match.split("=");
   return normalizeTrackingCookieValue(decodeURIComponent(rawValue));
 }
 function setTrackingCookie(key, value, maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS) {
-  if (typeof document === "undefined")
-    return;
+  if (typeof document === "undefined") return;
   const encodedValue = encodeURIComponent(value);
   document.cookie = `${key}=${encodedValue}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;
 }
@@ -307,18 +303,15 @@ function writeLocalStorage(key, value) {
   }
 }
 function getVisitorId() {
-  if (typeof window === "undefined")
-    return safeUuid();
+  if (typeof window === "undefined") return safeUuid();
   const existing = readLocalStorage(VISITOR_STORAGE_KEY);
-  if (existing && existing.length > 0)
-    return existing;
+  if (existing && existing.length > 0) return existing;
   const fresh = safeUuid();
   writeLocalStorage(VISITOR_STORAGE_KEY, fresh);
   return fresh;
 }
 function getOrRotateSessionId(now = Date.now()) {
-  if (typeof window === "undefined")
-    return { id: safeUuid(), isNew: true };
+  if (typeof window === "undefined") return { id: safeUuid(), isNew: true };
   const raw = readLocalStorage(SESSION_STORAGE_KEY);
   if (raw) {
     try {
@@ -391,8 +384,7 @@ function setLastFiredUrl(url) {
   writeSessionStorage(LAST_FIRED_URL_STORAGE_KEY, url);
 }
 function buildPageViewMetadata(referrerOverride) {
-  if (typeof window === "undefined" || typeof document === "undefined")
-    return null;
+  if (typeof window === "undefined" || typeof document === "undefined") return null;
   return pageViewMetadataSchema.parse({
     page: {
       title: document.title || null,
@@ -405,8 +397,7 @@ function buildPageViewMetadata(referrerOverride) {
   });
 }
 function fireManualPageView(client) {
-  if (typeof window === "undefined")
-    return;
+  if (typeof window === "undefined") return;
   const currentHref = window.location.href;
   const previousFiredUrl = getLastFiredUrl();
   const internalReferrer = previousFiredUrl !== null && previousFiredUrl !== currentHref ? previousFiredUrl : null;
@@ -442,8 +433,7 @@ function attachAutoPageView(client, options = {}) {
   let lastPath = window.location.pathname + window.location.search;
   function maybeFire() {
     const current = window.location.pathname + window.location.search;
-    if (current === lastPath)
-      return;
+    if (current === lastPath) return;
     lastPath = current;
     fireManualPageView(client);
   }
@@ -465,8 +455,7 @@ function attachAutoPageView(client, options = {}) {
   history.replaceState = patchedReplaceState;
   window.addEventListener("popstate", maybeFire);
   window.addEventListener("pageshow", handlePageShow);
-  if (!options.skipInitial)
-    fireManualPageView(client);
+  if (!options.skipInitial) fireManualPageView(client);
   return () => {
     history.pushState = originalPushState;
     history.replaceState = originalReplaceState;
@@ -548,8 +537,7 @@ function buildContext(surface, sdkVersion, packageName, environment, activeGtagI
   };
 }
 function readTrackingParams() {
-  if (typeof window === "undefined")
-    return createEmptyTrackingParams();
+  if (typeof window === "undefined") return createEmptyTrackingParams();
   try {
     captureTrackingParamsFromLocation();
   } catch {
@@ -564,8 +552,7 @@ function consentSnapshot() {
   }
 }
 async function postWithFetch(url, body, apiKey, identity, keepalive) {
-  if (typeof fetch !== "function")
-    return;
+  if (typeof fetch !== "function") return;
   try {
     await fetch(url, {
       method: "POST",
@@ -625,8 +612,7 @@ function createTrackingClient(config) {
   const visitorId = getVisitorId();
   const initialSession = getOrRotateSessionId();
   let sessionId = initialSession.id;
-  if (typeof window !== "undefined")
-    firstPage = window.location.href;
+  if (typeof window !== "undefined") firstPage = window.location.href;
   function enqueueHeartbeat() {
     const metadata = buildHeartbeatMetadata(
       config.surface,
@@ -652,7 +638,13 @@ function createTrackingClient(config) {
     }
     sessionId = rotated.id;
     const params = readTrackingParams();
-    const context = buildContext(config.surface, sdkVersion, packageName, environment, activeGtagIds);
+    const context = buildContext(
+      config.surface,
+      sdkVersion,
+      packageName,
+      environment,
+      activeGtagIds
+    );
     return {
       session_id: sessionId,
       visitor_id: visitorId,
@@ -669,8 +661,7 @@ function createTrackingClient(config) {
     };
   }
   function scheduleFlush() {
-    if (flushTimer !== null || destroyed)
-      return;
+    if (flushTimer !== null || destroyed) return;
     flushTimer = setTimeout(() => {
       flushTimer = null;
       void flush();
@@ -683,8 +674,7 @@ function createTrackingClient(config) {
     }
   }
   async function flush() {
-    if (queue.length === 0)
-      return;
+    if (queue.length === 0) return;
     const events = queue.slice(0, HARD_MAX_BATCH);
     queue = queue.slice(events.length);
     clearScheduledFlush();
@@ -696,10 +686,8 @@ function createTrackingClient(config) {
     await postWithFetch(eventsUrl, serialized, config.apiKey, identityHeaders2, false);
   }
   function trackEvent(input) {
-    if (destroyed)
-      return;
-    if (!input || typeof input.eventType !== "string" || input.eventType.length === 0)
-      return;
+    if (destroyed) return;
+    if (!input || typeof input.eventType !== "string" || input.eventType.length === 0) return;
     const occurredAt = input.occurredAt instanceof Date ? input.occurredAt.toISOString() : typeof input.occurredAt === "string" ? input.occurredAt : (/* @__PURE__ */ new Date()).toISOString();
     queue.push({
       event_type: input.eventType,
@@ -714,8 +702,7 @@ function createTrackingClient(config) {
     }
   }
   function flushOnUnload() {
-    if (queue.length === 0)
-      return;
+    if (queue.length === 0) return;
     const events = queue.slice(0, HARD_MAX_BATCH);
     queue = queue.slice(events.length);
     clearScheduledFlush();
@@ -1481,11 +1468,6 @@ function createSalesClient(config) {
   };
 }
 
-// ../tracking-core/src/resources/services.ts
-async function fetchServices(config) {
-  return salesRequest(config, "GET", "/services");
-}
-
 // ../tracking-core/src/resources/sales/money.ts
 var MINOR_UNIT_EXPONENT = {
   USD: 2,
@@ -1519,6 +1501,123 @@ function formatDateInTz(iso, timeZone, opts, locale) {
   }).format(date);
 }
 
+// ../tracking-core/src/resources/sales/schema.ts
+var import_zod11 = require("zod");
+var SUPPORTED_CURRENCIES = ["USD", "CAD"];
+var TRACKING_ENVIRONMENTS = ["production", "development"];
+var currencySchema = import_zod11.z.enum(SUPPORTED_CURRENCIES);
+var centsSchema = import_zod11.z.number().int().nonnegative();
+var quantitySchema = import_zod11.z.string().regex(/^\d+(\.\d{1,3})?$/);
+var metadataSchema = import_zod11.z.record(import_zod11.z.unknown());
+var saleItemSchema = import_zod11.z.object({
+  external_item_id: import_zod11.z.string().nullable().optional(),
+  name: import_zod11.z.string().nullable().optional(),
+  category: import_zod11.z.string().nullable().optional(),
+  quantity: quantitySchema,
+  unit_price_cents: centsSchema,
+  // Non-negativity validated on the wire — same contract as the other cents
+  // fields — and backstopped by the DB CHECK.
+  unit_cost_cents: centsSchema.nullable().optional()
+}).strict();
+var saleServiceSchema = import_zod11.z.object({
+  service: import_zod11.z.string(),
+  amount_cents: centsSchema
+}).strict();
+var customerNameSchema = import_zod11.z.string().max(200);
+var customerPhoneSchema = import_zod11.z.string().max(64);
+var customerEmailSchema = import_zod11.z.string().max(320).email();
+function refineServiceXor(val, ctx, { requireAmount }) {
+  if (val.services != null) {
+    if (val.service != null) {
+      ctx.addIssue({
+        code: import_zod11.z.ZodIssueCode.custom,
+        message: "pass either `service` or `services`, not both",
+        path: ["services"]
+      });
+    }
+    if (val.services.length === 0) {
+      ctx.addIssue({
+        code: import_zod11.z.ZodIssueCode.custom,
+        message: "`services` must not be empty",
+        path: ["services"]
+      });
+    }
+    const keys = val.services.map((s) => s.service);
+    if (new Set(keys).size !== keys.length) {
+      ctx.addIssue({
+        code: import_zod11.z.ZodIssueCode.custom,
+        message: "`services` must not list the same service more than once",
+        path: ["services"]
+      });
+    }
+    if (val.amount_total_cents != null) {
+      const sum = val.services.reduce((acc, s) => acc + s.amount_cents, 0);
+      if (val.amount_total_cents !== sum) {
+        ctx.addIssue({
+          code: import_zod11.z.ZodIssueCode.custom,
+          message: "amount_total_cents must equal the sum of the services amounts (omit it to derive it automatically)",
+          path: ["amount_total_cents"]
+        });
+      }
+    }
+  } else if (requireAmount && val.amount_total_cents == null) {
+    ctx.addIssue({
+      code: import_zod11.z.ZodIssueCode.custom,
+      message: "amount_total_cents is required unless `services` is provided",
+      path: ["amount_total_cents"]
+    });
+  }
+}
+var saleCreateSchema = import_zod11.z.object({
+  external_id: import_zod11.z.string().nullable().optional(),
+  description: import_zod11.z.string().nullable().optional(),
+  service: import_zod11.z.string().nullable().optional(),
+  services: import_zod11.z.array(saleServiceSchema).nullable().optional(),
+  currency: currencySchema,
+  // Optional only because the plural `services` form derives it from the sum
+  // (see refineServiceXor); the singular/serviceless path still requires it.
+  amount_total_cents: centsSchema.nullable().optional(),
+  occurred_at: import_zod11.z.string().datetime(),
+  environment: import_zod11.z.enum(TRACKING_ENVIRONMENTS).default("production"),
+  items: import_zod11.z.array(saleItemSchema).default([]),
+  metadata: metadataSchema.nullable().optional(),
+  customer_name: customerNameSchema.nullable().optional(),
+  customer_phone: customerPhoneSchema.nullable().optional(),
+  customer_email: customerEmailSchema.nullable().optional()
+}).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: true }));
+var saleUpdateSchema = import_zod11.z.object({
+  description: import_zod11.z.string().nullable().optional(),
+  service: import_zod11.z.string().nullable().optional(),
+  services: import_zod11.z.array(saleServiceSchema).nullable().optional(),
+  currency: currencySchema.optional(),
+  amount_total_cents: centsSchema.optional(),
+  occurred_at: import_zod11.z.string().datetime().optional(),
+  items: import_zod11.z.array(saleItemSchema).optional(),
+  metadata: metadataSchema.nullable().optional(),
+  customer_name: customerNameSchema.nullable().optional(),
+  customer_phone: customerPhoneSchema.nullable().optional(),
+  customer_email: customerEmailSchema.nullable().optional()
+}).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: false }));
+var TRACKING_RANGES = ["24h", "7d", "30d"];
+var NAMED_RANGES = [
+  "today",
+  "yesterday",
+  "wtd",
+  "mtd",
+  "qtd",
+  "ytd",
+  "24h",
+  "7d",
+  "30d",
+  "90d",
+  "custom"
+];
+
+// ../tracking-core/src/resources/services.ts
+async function fetchServices(config) {
+  return salesRequest(config, "GET", "/services");
+}
+
 // ../tracking-core/src/phone.ts
 var import_libphonenumber_js = require("libphonenumber-js");
 var DEFAULT_PHONE_COUNTRY = "CA";
@@ -1804,10 +1903,7 @@ var ANIMATION_KEYFRAMES = `
 var import_react3 = require("react");
 function GoogleAdsTracking(props) {
   const { gtagId, gtagIds } = props;
-  const gtagIdsKey = (0, import_react3.useMemo)(
-    () => gtagIds ? JSON.stringify(gtagIds) : "",
-    [gtagIds]
-  );
+  const gtagIdsKey = (0, import_react3.useMemo)(() => gtagIds ? JSON.stringify(gtagIds) : "", [gtagIds]);
   (0, import_react3.useEffect)(() => {
     if (gtagIds && Object.keys(gtagIds).length > 0) {
       bootstrapMultipleGtags(gtagIds);
@@ -1822,14 +1918,24 @@ function GoogleAdsTracking(props) {
 var import_react5 = require("react");
 
 // package.json
-var version = "0.12.0";
+var version = "0.12.2";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react4 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
-var PhoneConfigContext = (0, import_react4.createContext)(null);
+var _phoneConfigContext;
+function phoneConfigContext() {
+  return _phoneConfigContext ?? (_phoneConfigContext = (0, import_react4.createContext)(null));
+}
+function PhoneConfigProvider({
+  value,
+  children
+}) {
+  const Ctx = phoneConfigContext();
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Ctx.Provider, { value, children });
+}
 function usePhoneConfig() {
-  const ctx = (0, import_react4.useContext)(PhoneConfigContext);
+  const ctx = (0, import_react4.useContext)(phoneConfigContext());
   return {
     defaultCountry: ctx?.defaultCountry ?? DEFAULT_PHONE_COUNTRY,
     display: ctx?.display ?? "national"
@@ -1922,13 +2028,15 @@ function createTracking(options) {
     return {
       // Still publish phone config so usePhoneField/<PhoneField> work even when
       // tracking is disabled (missing apiKey/endpoint).
-      TrackingProvider: ({ children }) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PhoneConfigContext.Provider, { value: phone ?? null, children }),
+      TrackingProvider: ({ children }) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PhoneConfigProvider, { value: phone ?? null, children }),
       useTracking: () => noopTyped
     };
   }
   const TrackingContext = (0, import_react5.createContext)(null);
   function TrackingProvider({ gtagId, gtagIds, children }) {
-    const resolvedGtagIds = gtagIds ?? (gtagId ? { default: gtagId } : void 0);
+    const resolvedGtagIds = gtagIds ? Object.fromEntries(
+      Object.entries(gtagIds).filter((e) => e[1] != null)
+    ) : gtagId ? { default: gtagId } : void 0;
     const client = (0, import_react5.useMemo)(
       () => createTypedClient(
         getOrCreateTrackingClient({
@@ -1995,7 +2103,7 @@ function createTracking(options) {
         }
       };
     }, []);
-    return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(TrackingContext.Provider, { value: client, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PhoneConfigContext.Provider, { value: phone ?? null, children }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(TrackingContext.Provider, { value: client, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PhoneConfigProvider, { value: phone ?? null, children }) });
   }
   function useTracking() {
     const client = (0, import_react5.useContext)(TrackingContext);
@@ -2014,9 +2122,11 @@ function createTracking(options) {
   ConsentBanner,
   DEFAULT_PHONE_COUNTRY,
   GoogleAdsTracking,
-  PhoneConfigContext,
+  NAMED_RANGES,
   PhoneField,
+  SUPPORTED_CURRENCIES,
   TRACKING_PARAM_KEYS,
+  TRACKING_RANGES,
   captureTrackingParamsFromLocation,
   createSalesClient,
   createTracking,
@@ -2033,6 +2143,11 @@ function createTracking(options) {
   parsePhone,
   phoneField,
   resetConsent,
+  saleCreateSchema,
+  saleItemSchema,
+  saleServiceSchema,
+  saleUpdateSchema,
+  salesRequest,
   setConsentState,
   toE164,
   toMinor,