@aranova/tracking-react 0.22.3 → 0.23.0

package/README.md

@@ -345,6 +345,12 @@ wiring. `ARANOVA_CONFIG_URL` and `conversionConfig: { cdnUrl }` remain legacy co
 APIs; do not use them for new installs. See
 [conversion-config-schema.md](https://github.com/AranovaIO/aranova_internal/blob/master/docs/tracking-package/conversion-config-schema.md).
 
+`ARANOVA_TRACKING_CONFIG` carries the business identity and the SDK composes the object URL
+against the production CDN — the `endpoint` option only moves **event ingest**, not the config
+fetch. To read the config from elsewhere (a local object store), set
+`REACT_APP_ARANOVA_CDN_BASE_URL`; the generated module already reads it and falls back to
+production, so no code change is needed. Leave it unset in production.
+
 > **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 (v2 — opt-out model)

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-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 { T as TrackingConfigReference, C as ConversionConfig } from './sales-BwWnvl8L.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 resolveTrackingConfigUrl, ak as saleCreateSchema, al as saleItemSchema, am as saleServiceSchema, an as saleUpdateSchema, ao as salesRequest, ap as stashUserData, aq as toMinor } from './sales-BwWnvl8L.mjs';
 import * as src from 'src';
 import { z } from 'zod';
 import { CountryCode } from 'libphonenumber-js';
@@ -1709,6 +1709,13 @@ interface CreateTrackingOptions<TRegistry extends TriggerRegistryConfig> {
         cdnUrl: string;
         baked?: ConversionConfig | null;
     };
+    /**
+     * R2-authoritative config reference — `ARANOVA_TRACKING_CONFIG` from
+     * `tracking-cli gen`. Wins over `conversionConfig`. The object URL is composed
+     * from `businessId` + `environment` against the production CDN; spread in a
+     * `cdnBaseUrl` to read it from somewhere else, e.g.
+     * `{ ...ARANOVA_TRACKING_CONFIG, cdnBaseUrl: import.meta.env.VITE_ARANOVA_CDN_BASE_URL }`.
+     */
     trackingConfig?: TrackingConfigReference;
 }
 interface TrackingProviderProps {

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-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 { T as TrackingConfigReference, C as ConversionConfig } from './sales-BwWnvl8L.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 resolveTrackingConfigUrl, ak as saleCreateSchema, al as saleItemSchema, am as saleServiceSchema, an as saleUpdateSchema, ao as salesRequest, ap as stashUserData, aq as toMinor } from './sales-BwWnvl8L.js';
 import * as src from 'src';
 import { z } from 'zod';
 import { CountryCode } from 'libphonenumber-js';
@@ -1709,6 +1709,13 @@ interface CreateTrackingOptions<TRegistry extends TriggerRegistryConfig> {
         cdnUrl: string;
         baked?: ConversionConfig | null;
     };
+    /**
+     * R2-authoritative config reference — `ARANOVA_TRACKING_CONFIG` from
+     * `tracking-cli gen`. Wins over `conversionConfig`. The object URL is composed
+     * from `businessId` + `environment` against the production CDN; spread in a
+     * `cdnBaseUrl` to read it from somewhere else, e.g.
+     * `{ ...ARANOVA_TRACKING_CONFIG, cdnBaseUrl: import.meta.env.VITE_ARANOVA_CDN_BASE_URL }`.
+     */
     trackingConfig?: TrackingConfigReference;
 }
 interface TrackingProviderProps {

package/dist/index.js

@@ -56,6 +56,7 @@ __export(src_exports, {
   phoneField: () => phoneField,
   resetConsent: () => resetConsent,
   resolveConversionConfig: () => resolveConversionConfig,
+  resolveTrackingConfigUrl: () => resolveTrackingConfigUrl,
   saleCreateSchema: () => saleCreateSchema,
   saleItemSchema: () => saleItemSchema,
   saleServiceSchema: () => saleServiceSchema,
@@ -1118,8 +1119,21 @@ function formatMoney(cents, currency, locale) {
 }
 
 // ../tracking-core/src/resources/tracking-config-runtime.ts
+var DEFAULT_CDN_BASE_URL = "https://demos.aranova.io";
+function trackingConfigKey(businessId, environment) {
+  return `tracking-config/v1/${businessId}-${environment}.json`;
+}
+function resolveTrackingConfigUrl(ref) {
+  if (ref.cdnUrl) return ref.cdnUrl;
+  const configured = ref.cdnBaseUrl?.trim();
+  const base = (configured || DEFAULT_CDN_BASE_URL).replace(/\/+$/, "");
+  return `${base}/${trackingConfigKey(ref.businessId, ref.environment)}`;
+}
 var CACHE_PREFIX2 = "_aranova_cfg_runtime_";
 var AUTHORITY_TTL_MS = 6e4;
+var MAX_QUEUE_LENGTH = 50;
+var RETRY_BASE_MS = 5e3;
+var RETRY_MAX_MS = 5 * 6e4;
 var runtimes = /* @__PURE__ */ new Map();
 var configuredIds = /* @__PURE__ */ new Set();
 var scriptLoad = null;
@@ -1127,6 +1141,10 @@ var jsInitialized = false;
 function cacheKey2(url) {
   return `${CACHE_PREFIX2}${url}`;
 }
+function pushBounded(queue, item) {
+  queue.push(item);
+  if (queue.length > MAX_QUEUE_LENGTH) queue.splice(0, queue.length - MAX_QUEUE_LENGTH);
+}
 function readCache2(url) {
   if (typeof window === "undefined") return null;
   try {
@@ -1207,16 +1225,25 @@ var TrackingConfigRuntime = class {
     this.flushRequested = false;
     this.retryTimer = null;
     this.started = false;
+    /** Consecutive failed authority attempts — drives the revalidate backoff. */
+    this.authorityFailures = 0;
+    /** Epoch ms before which `ensureAuthority` must not issue another request. */
+    this.nextAuthorityAttemptAt = 0;
     this.conversionQueue = [];
     this.automaticQueue = [];
     this.pageQueue = [];
     this.listeners = /* @__PURE__ */ new Set();
     this.fetchImpl = fetchImpl.bind(globalThis);
-    const cached = readCache2(ref.cdnUrl);
+    this.url = resolveTrackingConfigUrl(ref);
+    const cached = readCache2(this.url);
     this.current = cached?.config ?? null;
     this.etag = cached?.etag ?? null;
     this.start();
   }
+  /** The URL this runtime actually fetches (composed or explicit). */
+  configUrl() {
+    return this.url;
+  }
   /**
    * Explicitly start authority resolution and Google-tag bootstrap.
    *
@@ -1245,6 +1272,15 @@ var TrackingConfigRuntime = class {
   }
   __unsafeExpireAuthorityForTests() {
     this.confirmedAt = Number.NEGATIVE_INFINITY;
+    this.nextAuthorityAttemptAt = 0;
+  }
+  /** Queue depths — asserted by tests to pin the bound. */
+  __queueDepthsForTests() {
+    return {
+      conversions: this.conversionQueue.length,
+      automatic: this.automaticQueue.length,
+      pages: this.pageQueue.length
+    };
   }
   subscribe(listener) {
     this.listeners.add(listener);
@@ -1254,10 +1290,12 @@ var TrackingConfigRuntime = class {
     if (this.stateValue !== "unconfirmed" && Date.now() - this.confirmedAt < AUTHORITY_TTL_MS) {
       return true;
     }
+    if (Date.now() < this.nextAuthorityAttemptAt) return false;
     await this.revalidateAuthority();
     return this.stateValue !== "unconfirmed" && Date.now() - this.confirmedAt < AUTHORITY_TTL_MS;
   }
   async revalidate() {
+    this.nextAuthorityAttemptAt = 0;
     await this.revalidateAuthority();
     await this.flush();
   }
@@ -1271,15 +1309,20 @@ var TrackingConfigRuntime = class {
   }
   queuePageView(snapshot = pageViewSnapshot()) {
     if (!snapshot) return;
-    this.pageQueue.push(snapshot);
+    pushBounded(this.pageQueue, snapshot);
     void this.flush();
   }
   fireConversion(key, options) {
-    this.conversionQueue.push({ key, ...options });
+    pushBounded(this.conversionQueue, { key, ...options });
     void this.flush();
   }
   queueAutomaticEvent(eventType, metadata, transactionPath, transactionScope) {
-    this.automaticQueue.push({ eventType, metadata, transactionPath, transactionScope });
+    pushBounded(this.automaticQueue, {
+      eventType,
+      metadata,
+      transactionPath,
+      transactionScope
+    });
     void this.flush();
   }
   listGoals() {
@@ -1289,7 +1332,7 @@ var TrackingConfigRuntime = class {
     try {
       const headers = {};
       if (this.etag) headers["If-None-Match"] = this.etag;
-      const response = await this.fetchImpl(this.ref.cdnUrl, {
+      const response = await this.fetchImpl(this.url, {
         method: "GET",
         headers,
         cache: "no-cache"
@@ -1319,14 +1362,19 @@ var TrackingConfigRuntime = class {
   expireAuthority() {
     this.authorityGeneration += 1;
     if (this.stateValue !== "unconfirmed") this.stateValue = "unconfirmed";
+    this.authorityFailures += 1;
+    const delay = Math.min(RETRY_MAX_MS, RETRY_BASE_MS * 2 ** (this.authorityFailures - 1));
+    this.nextAuthorityAttemptAt = Date.now() + delay;
   }
   confirm(config, etag) {
     this.authorityGeneration += 1;
     this.current = config;
     this.etag = etag;
     this.confirmedAt = Date.now();
+    this.authorityFailures = 0;
+    this.nextAuthorityAttemptAt = 0;
     this.stateValue = isTombstone(config) ? "tombstone" : "active";
-    writeCache2(this.ref.cdnUrl, { etag, config });
+    writeCache2(this.url, { etag, config });
     if (this.stateValue === "tombstone") {
       if (this.retryTimer !== null) {
         window.clearTimeout(this.retryTimer);
@@ -1405,7 +1453,7 @@ var TrackingConfigRuntime = class {
       for (const goal of config.goals) {
         if (goal.kind !== "event" || !goal.firing) continue;
         if (!automaticThresholdMet(goal, event.eventType, event.metadata)) continue;
-        this.conversionQueue.push({
+        pushBounded(this.conversionQueue, {
           key: goal.key,
           transactionId: getAutomaticTransactionId(
             event.transactionScope,
@@ -1441,7 +1489,7 @@ var TrackingConfigRuntime = class {
   }
 };
 function getTrackingConfigRuntime(ref, fetchImpl) {
-  const key = `${ref.cdnUrl}|${ref.businessId}|${ref.environment}`;
+  const key = `${resolveTrackingConfigUrl(ref)}|${ref.businessId}|${ref.environment}`;
   const existing = runtimes.get(key);
   if (existing) return existing;
   const runtime = new TrackingConfigRuntime(ref, fetchImpl ?? globalThis.fetch);
@@ -3726,7 +3774,7 @@ function AdPlatformTracking({
   metaPixelId,
   metaPixelIds
 }) {
-  const trackingConfigKey = trackingConfig ? `${trackingConfig.cdnUrl}:${trackingConfig.businessId}:${trackingConfig.environment}` : "";
+  const trackingConfigKey2 = trackingConfig ? `${resolveTrackingConfigUrl(trackingConfig)}:${trackingConfig.businessId}:${trackingConfig.environment}` : "";
   const gtagIdsKey = (0, import_react3.useMemo)(() => gtagIds ? JSON.stringify(gtagIds) : "", [gtagIds]);
   const metaPixelIdsKey = (0, import_react3.useMemo)(
     () => metaPixelIds ? JSON.stringify(metaPixelIds) : "",
@@ -3748,7 +3796,7 @@ function AdPlatformTracking({
     } else if (gtagId) {
       bootstrapGoogleAdsTracking(gtagId);
     }
-  }, [gtagId, gtagIdsKey, trackingConfigKey, standalonePageView]);
+  }, [gtagId, gtagIdsKey, trackingConfigKey2, standalonePageView]);
   (0, import_react3.useEffect)(() => {
     if (metaPixelIds && Object.keys(metaPixelIds).length > 0) {
       bootstrapMultiplePixels(metaPixelIds);
@@ -3778,7 +3826,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "0.22.3";
+var version = "0.23.0";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");
@@ -4069,6 +4117,7 @@ function createTracking(options) {
   phoneField,
   resetConsent,
   resolveConversionConfig,
+  resolveTrackingConfigUrl,
   saleCreateSchema,
   saleItemSchema,
   saleServiceSchema,