@aranova/tracking-react 0.22.0 → 0.22.3

package/dist/index.d.mts

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

package/dist/index.js

@@ -1756,6 +1756,9 @@ function buildHeartbeatMetadata(surface, sdkVersion, packageName, triggers, gtag
 var DEFAULT_FLUSH_INTERVAL_MS = 2e3;
 var DEFAULT_MAX_QUEUE_SIZE = 10;
 var HARD_MAX_BATCH = 50;
+var MAX_RETRY_BACKOFF_MS = 6e4;
+var MAX_BUFFERED_EVENTS2 = 200;
+var RETRY_BUFFER_KEY_PREFIX = "aranova_tracking_pending_v1";
 var API_KEY_HEADER = "X-Aranova-Api-Key";
 var SDK_VERSION_HEADER = "X-Aranova-Sdk-Version";
 var SDK_PACKAGE_HEADER = "X-Aranova-Sdk-Package";
@@ -1798,9 +1801,9 @@ function consentSnapshot() {
   }
 }
 async function postWithFetch(url, body, apiKey, identity, keepalive) {
-  if (typeof fetch !== "function") return;
+  if (typeof fetch !== "function") return "drop";
   try {
-    await fetch(url, {
+    const response = await fetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -1816,9 +1819,49 @@ async function postWithFetch(url, body, apiKey, identity, keepalive) {
       credentials: "omit",
       mode: "cors"
     });
+    if (response.ok) return "ok";
+    if (response.status === 408 || response.status === 429 || response.status >= 500) {
+      return "retry";
+    }
+    return "drop";
   } catch {
+    return "retry";
   }
 }
+function retryBufferKey(apiKey, endpoint) {
+  return `${RETRY_BUFFER_KEY_PREFIX}:${apiKey}:${endpoint}`;
+}
+function readPendingBatches(key) {
+  if (typeof window === "undefined") return [];
+  try {
+    const raw = window.localStorage.getItem(key);
+    if (!raw) return [];
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return [];
+    return parsed.filter(
+      (entry) => typeof entry === "object" && entry !== null && "session" in entry && Array.isArray(entry.events)
+    );
+  } catch {
+    return [];
+  }
+}
+function writePendingBatches(key, batches) {
+  if (typeof window === "undefined") return;
+  try {
+    if (batches.length === 0) window.localStorage.removeItem(key);
+    else window.localStorage.setItem(key, JSON.stringify(batches));
+  } catch {
+  }
+}
+function trimToBufferCap(batches) {
+  let total = batches.reduce((sum, batch) => sum + batch.events.length, 0);
+  const trimmed = batches.slice();
+  while (total > MAX_BUFFERED_EVENTS2 && trimmed.length > 1) {
+    const dropped = trimmed.shift();
+    total -= dropped ? dropped.events.length : 0;
+  }
+  return trimmed;
+}
 var globalClient = null;
 var globalClientKey = null;
 function clientConfigKey(config) {
@@ -1874,6 +1917,10 @@ function createTrackingClient(config) {
   };
   let queue = [];
   let flushTimer = null;
+  const bufferKey = retryBufferKey(config.apiKey, endpointBase);
+  let pending = readPendingBatches(bufferKey);
+  let flushChain = Promise.resolve();
+  let retryAttempt = 0;
   let firstPage = null;
   let initialParams = createEmptyTrackingParams();
   let destroyed = false;
@@ -1910,6 +1957,9 @@ function createTrackingClient(config) {
   if (initialSession.isNew) {
     enqueueHeartbeat();
   }
+  if (pending.length > 0) {
+    scheduleFlush();
+  }
   function buildSessionPayload() {
     const rotated = getOrRotateSessionId();
     if (rotated.isNew && rotated.id !== sessionId) {
@@ -1948,12 +1998,12 @@ function createTrackingClient(config) {
       context
     };
   }
-  function scheduleFlush() {
+  function scheduleFlush(delayMs = flushIntervalMs) {
     if (flushTimer !== null || destroyed) return;
     flushTimer = setTimeout(() => {
       flushTimer = null;
       void flush();
-    }, flushIntervalMs);
+    }, delayMs);
   }
   function clearScheduledFlush() {
     if (flushTimer !== null) {
@@ -1961,17 +2011,50 @@ function createTrackingClient(config) {
       flushTimer = null;
     }
   }
-  async function flush() {
+  function bufferQueued() {
     if (queue.length === 0) return;
     const events = queue.slice(0, HARD_MAX_BATCH);
     queue = queue.slice(events.length);
+    pending = trimToBufferCap([...pending, { session: buildSessionPayload(), events }]);
+    writePendingBatches(bufferKey, pending);
+  }
+  function flush() {
+    flushChain = flushChain.then(runFlush).catch(() => {
+    });
+    return flushChain;
+  }
+  async function runFlush() {
+    if (destroyed) return;
     clearScheduledFlush();
-    const body = {
-      session: buildSessionPayload(),
-      events
-    };
-    const serialized = JSON.stringify(body);
-    await postWithFetch(eventsUrl, serialized, config.apiKey, identityHeaders2, false);
+    bufferQueued();
+    if (pending.length === 0) return;
+    try {
+      while (pending.length > 0) {
+        const batch = pending[0];
+        const body = { session: batch.session, events: batch.events };
+        const outcome = await postWithFetch(
+          eventsUrl,
+          JSON.stringify(body),
+          config.apiKey,
+          identityHeaders2,
+          false
+        );
+        if (outcome === "retry") {
+          retryAttempt += 1;
+          return;
+        }
+        pending = pending.slice(1);
+        writePendingBatches(bufferKey, pending);
+        retryAttempt = 0;
+      }
+    } finally {
+      if (pending.length > 0) {
+        const backoff = Math.min(flushIntervalMs * 2 ** retryAttempt, MAX_RETRY_BACKOFF_MS);
+        scheduleFlush(backoff);
+      } else if (queue.length > 0) {
+        scheduleFlush();
+      }
+    }
   }
   function trackEvent(input) {
     if (destroyed) return;
@@ -1997,16 +2080,14 @@ function createTrackingClient(config) {
     }
   }
   function flushOnUnload() {
-    if (queue.length === 0) return;
-    const events = queue.slice(0, HARD_MAX_BATCH);
-    queue = queue.slice(events.length);
+    bufferQueued();
     clearScheduledFlush();
-    const body = {
-      session: buildSessionPayload(),
-      events
-    };
-    const serialized = JSON.stringify(body);
-    void postWithFetch(eventsUrl, serialized, config.apiKey, identityHeaders2, true);
+    if (pending.length === 0) return;
+    const batch = pending[0];
+    pending = pending.slice(1);
+    writePendingBatches(bufferKey, pending);
+    const body = { session: batch.session, events: batch.events };
+    void postWithFetch(eventsUrl, JSON.stringify(body), config.apiKey, identityHeaders2, true);
   }
   if (typeof window !== "undefined") {
     window.addEventListener("pagehide", flushOnUnload);
@@ -3316,7 +3397,12 @@ var saleCreateSchema = import_zod12.z.object({
   customer_email: customerEmailSchema.nullable().optional(),
   // CASL consent attestation: the customer agreed to receive SMS. Recorded
   // with a timestamp server-side; every SMS send path gates on it.
-  sms_consent: import_zod12.z.boolean().default(false)
+  //
+  // Tri-state: omit it (or send null) to let the server apply the business's
+  // configured default-opt-in policy, honouring a returning customer's
+  // remembered preference. Send an explicit boolean to assert consent state
+  // yourself — `false` records a deliberate opt-out.
+  sms_consent: import_zod12.z.boolean().nullable().optional()
 }).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: true }));
 var saleUpdateSchema = import_zod12.z.object({
   description: import_zod12.z.string().nullable().optional(),
@@ -3328,6 +3414,9 @@ var saleUpdateSchema = import_zod12.z.object({
   items: import_zod12.z.array(saleItemSchema).optional(),
   metadata: metadataSchema.nullable().optional(),
   customer_name: customerNameSchema.nullable().optional(),
+  // Re-attest when changing a filler-looking name; the server clears the
+  // prior attestation whenever `customer_name` changes.
+  customer_name_placeholder_confirmed: import_zod12.z.boolean().optional(),
   customer_phone: customerPhoneSchema.nullable().optional(),
   customer_email: customerEmailSchema.nullable().optional(),
   // NOT NULL server-side: omit to leave unchanged (explicit null is rejected).
@@ -3689,7 +3778,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "0.22.0";
+var version = "0.22.3";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");