@aranova/tracking-react 0.22.4 → 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-hH-509J5.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-hH-509J5.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-hH-509J5.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-hH-509J5.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,6 +1119,16 @@ 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;
@@ -1223,11 +1234,16 @@ var TrackingConfigRuntime = class {
     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.
    *
@@ -1316,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"
@@ -1358,7 +1374,7 @@ var TrackingConfigRuntime = class {
     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);
@@ -1473,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);
@@ -3758,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) : "",
@@ -3780,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);
@@ -3810,7 +3826,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "0.22.4";
+var version = "0.23.0";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");
@@ -4101,6 +4117,7 @@ function createTracking(options) {
   phoneField,
   resetConsent,
   resolveConversionConfig,
+  resolveTrackingConfigUrl,
   saleCreateSchema,
   saleItemSchema,
   saleServiceSchema,