@aranova/tracking-next 0.22.3 → 0.23.0

package/README.md

@@ -471,6 +471,30 @@ sales.trackConversion("phone_click"); // fires a manual event-goal only (no sale
 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).
 
+### Where the config is read from
+
+`ARANOVA_TRACKING_CONFIG` carries the business identity, and the SDK composes the
+object URL against the production CDN. Two origins are in play and they are easy to
+conflate:
+
+- `endpoint` — where **events** are POSTed (the Aranova API).
+- `cdnBaseUrl` — where the **config object** is GET (object storage / CDN).
+
+Switching `NEXT_PUBLIC_ARANOVA_TRACKING_ENDPOINT` to a local backend therefore does
+_not_ move the config fetch. The generated module reads
+`NEXT_PUBLIC_ARANOVA_CDN_BASE_URL` for that, falling back to production:
+
+```
+# .env.local — local object storage only. Leave UNSET in production.
+NEXT_PUBLIC_ARANOVA_CDN_BASE_URL=http://localhost:9100/aranova-demos
+```
+
+No code change is needed; pass `ARANOVA_TRACKING_CONFIG` as-is. Setting this in
+production points every visitor's browser at the wrong origin — events keep
+flowing, so the dashboard looks healthy while on-page conversion firing never
+engages. If you need to override it programmatically,
+`resolveTrackingConfigUrl(ref)` returns the URL a reference resolves to.
+
 ## Consent (v2 — opt-out model)
 
 Tracking is **on by default**: the consent-default `<Script>` injected by `GoogleAdsTracking` / `AdPlatformTracking` resolves the visitor's effective consent synchronously from `localStorage` before gtag.js loads — granted unless an explicit, unexpired decline is stored. A decline is honored for **90 days**; a grant never expires. There is no `pending` state and the package ships **no consent UI** — each site provides its own footer "cookie preferences" control and discloses tracking in its privacy policy (that notice is what makes the opt-out model defensible).

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 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, C as ConsentState, g as ConsentChoiceState, h as ConsentSource, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, 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-ChA6g-GJ.mjs';
-export { 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, A 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, U as SaleSummaryQuery, V as SaleSummaryQueryV2, W as SaleSummaryV2, X as SaleUpdateInput, Y as SalesBusinessClient, Z as SalesCategoryBreakdown, _ as SalesClient, $ as SalesClientConfig, a0 as SalesCustomersClient, a1 as SalesServiceBreakdown, a2 as SalesTransportConfig, a3 as SalesTrendPoint, a4 as SummaryCurrencyDelta, a5 as SummaryDeltas, a6 as SummaryWindow, a7 as SupportedCurrency, a8 as TRACKING_RANGES, a9 as TrackingOverviewRange, aa as clearStashedUserData, ab as createSalesClient, ac as fetchServices, ad as formatMoney, ae as fromMinor, af as getTrackingConfigRuntime, ag as resolveConversionConfig, ah as saleCreateSchema, ai as saleItemSchema, aj as saleServiceSchema, ak as saleUpdateSchema, al as salesRequest, am as stashUserData, an as toMinor } from './sales-ChA6g-GJ.mjs';
+import { T as TrackingConfigReference, C as ConversionConfig } from './sales-CmlzRq3u.mjs';
+export { 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, A 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, U as SaleSummaryQuery, V as SaleSummaryQueryV2, W as SaleSummaryV2, X as SaleUpdateInput, Y as SalesBusinessClient, Z as SalesCategoryBreakdown, _ as SalesClient, $ as SalesClientConfig, a0 as SalesCustomersClient, a1 as SalesServiceBreakdown, a2 as SalesTransportConfig, a3 as SalesTrendPoint, a4 as SummaryCurrencyDelta, a5 as SummaryDeltas, a6 as SummaryWindow, a7 as SupportedCurrency, a8 as TRACKING_RANGES, a9 as TrackingOverviewRange, aa as clearStashedUserData, ab as createSalesClient, ac as fetchServices, ad as formatMoney, ae as fromMinor, af as getTrackingConfigRuntime, ag as resolveConversionConfig, ah as resolveTrackingConfigUrl, ai as saleCreateSchema, aj as saleItemSchema, ak as saleServiceSchema, al as saleUpdateSchema, am as salesRequest, an as stashUserData, ao as toMinor } from './sales-CmlzRq3u.mjs';
 import { z } from 'zod';
 import * as src from 'src';
 export { A as AranovaApiError, f as formatDateInTz } from './date-BHetnL7s.mjs';
@@ -1710,6 +1710,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: process.env.NEXT_PUBLIC_ARANOVA_CDN_BASE_URL }`.
+     */
     trackingConfig?: TrackingConfigReference;
 }
 interface TrackingProviderProps {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 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, C as ConsentState, g as ConsentChoiceState, h as ConsentSource, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, 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-PttMfkw0.js';
-export { 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, A 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, U as SaleSummaryQuery, V as SaleSummaryQueryV2, W as SaleSummaryV2, X as SaleUpdateInput, Y as SalesBusinessClient, Z as SalesCategoryBreakdown, _ as SalesClient, $ as SalesClientConfig, a0 as SalesCustomersClient, a1 as SalesServiceBreakdown, a2 as SalesTransportConfig, a3 as SalesTrendPoint, a4 as SummaryCurrencyDelta, a5 as SummaryDeltas, a6 as SummaryWindow, a7 as SupportedCurrency, a8 as TRACKING_RANGES, a9 as TrackingOverviewRange, aa as clearStashedUserData, ab as createSalesClient, ac as fetchServices, ad as formatMoney, ae as fromMinor, af as getTrackingConfigRuntime, ag as resolveConversionConfig, ah as saleCreateSchema, ai as saleItemSchema, aj as saleServiceSchema, ak as saleUpdateSchema, al as salesRequest, am as stashUserData, an as toMinor } from './sales-PttMfkw0.js';
+import { T as TrackingConfigReference, C as ConversionConfig } from './sales-D_BTsRuM.js';
+export { 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, A 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, U as SaleSummaryQuery, V as SaleSummaryQueryV2, W as SaleSummaryV2, X as SaleUpdateInput, Y as SalesBusinessClient, Z as SalesCategoryBreakdown, _ as SalesClient, $ as SalesClientConfig, a0 as SalesCustomersClient, a1 as SalesServiceBreakdown, a2 as SalesTransportConfig, a3 as SalesTrendPoint, a4 as SummaryCurrencyDelta, a5 as SummaryDeltas, a6 as SummaryWindow, a7 as SupportedCurrency, a8 as TRACKING_RANGES, a9 as TrackingOverviewRange, aa as clearStashedUserData, ab as createSalesClient, ac as fetchServices, ad as formatMoney, ae as fromMinor, af as getTrackingConfigRuntime, ag as resolveConversionConfig, ah as resolveTrackingConfigUrl, ai as saleCreateSchema, aj as saleItemSchema, ak as saleServiceSchema, al as saleUpdateSchema, am as salesRequest, an as stashUserData, ao as toMinor } from './sales-D_BTsRuM.js';
 import { z } from 'zod';
 import * as src from 'src';
 export { A as AranovaApiError, f as formatDateInTz } from './date-BHetnL7s.js';
@@ -1710,6 +1710,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: process.env.NEXT_PUBLIC_ARANOVA_CDN_BASE_URL }`.
+     */
     trackingConfig?: TrackingConfigReference;
 }
 interface TrackingProviderProps {

package/dist/index.js

@@ -98,6 +98,7 @@ __export(src_exports, {
   resetConsent: () => resetConsent,
   resolveBrowserTimeZone: () => resolveBrowserTimeZone,
   resolveConversionConfig: () => resolveConversionConfig,
+  resolveTrackingConfigUrl: () => resolveTrackingConfigUrl,
   saleCreateSchema: () => saleCreateSchema,
   saleItemSchema: () => saleItemSchema,
   saleServiceSchema: () => saleServiceSchema,
@@ -1144,8 +1145,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;
@@ -1153,6 +1167,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 {
@@ -1233,16 +1251,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.
    *
@@ -1271,6 +1298,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);
@@ -1280,10 +1316,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();
   }
@@ -1297,15 +1335,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() {
@@ -1315,7 +1358,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"
@@ -1345,14 +1388,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);
@@ -1431,7 +1479,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,
@@ -1467,7 +1515,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);
@@ -3585,13 +3633,13 @@ function AdPlatformTracking({
   metaPixelId,
   metaPixelIds
 }) {
-  const trackingConfigKey = trackingConfig ? `${trackingConfig.cdnUrl}:${trackingConfig.businessId}:${trackingConfig.environment}` : "";
+  const trackingConfigKey2 = trackingConfig ? `${resolveTrackingConfigUrl(trackingConfig)}:${trackingConfig.businessId}:${trackingConfig.environment}` : "";
   (0, import_react3.useEffect)(() => {
     if (!trackingConfig) return;
     const runtime = getTrackingConfigRuntime(trackingConfig);
     if (standalonePageView) runtime.queuePageView();
     else runtime.start();
-  }, [trackingConfigKey, standalonePageView]);
+  }, [trackingConfigKey2, standalonePageView]);
   const gtagAll = trackingConfig ? [] : gtagIds ? Object.values(gtagIds).filter((id) => id != null) : gtagId ? [gtagId] : [];
   const metaAll = metaPixelIds ? Object.values(metaPixelIds).filter((id) => id != null) : metaPixelId ? [metaPixelId] : [];
   if (trackingConfig || gtagAll.length > 0) registerCapability("ad_tags_google");
@@ -3644,7 +3692,7 @@ function GoogleAdsTracking(props) {
 var import_navigation3 = require("next/navigation");
 
 // package.json
-var version = "0.22.3";
+var version = "0.23.0";
 
 // src/factory.tsx
 var import_react5 = require("react");
@@ -4413,6 +4461,7 @@ function useBookingForm(options = {}) {
   resetConsent,
   resolveBrowserTimeZone,
   resolveConversionConfig,
+  resolveTrackingConfigUrl,
   saleCreateSchema,
   saleItemSchema,
   saleServiceSchema,