@aranova/tracking-react 0.17.3 → 0.18.1

package/dist/{sales-C3jFBx08.d.ts → sales-QqKh6_iy.d.ts}

@@ -30,6 +30,7 @@ interface ConversionConfig {
     business_id?: string;
     customer_id?: string | null;
     environment?: string;
+    google_tracking_state: "active" | "disabled";
     gtag_ids: Record<string, string>;
     meta_pixel_ids: Record<string, string>;
     /** LEGACY: sale-goals only (for pre-unified-goal readers). */
@@ -78,6 +79,54 @@ interface ResolveConversionConfigOptions {
  */
 declare function resolveConversionConfig(options: ResolveConversionConfigOptions): ConversionConfigStore;
 
+interface TrackingConfigReference {
+    cdnUrl: string;
+    businessId: string;
+    environment: "production" | "test";
+}
+type RuntimeState = "unconfirmed" | "active" | "tombstone";
+interface QueuedConversion {
+    key: string;
+    value?: number | null;
+    currency?: string | null;
+    transactionId?: string | null;
+}
+type TrackingConfigConversionOptions = Omit<QueuedConversion, "key">;
+interface QueuedPageView {
+    href: string;
+    title: string | null;
+    referrer: string | null;
+}
+declare class TrackingConfigRuntime {
+    readonly ref: TrackingConfigReference;
+    private readonly fetchImpl;
+    private current;
+    private etag;
+    private stateValue;
+    private confirmedAt;
+    private inFlight;
+    private readonly conversionQueue;
+    private readonly automaticQueue;
+    private readonly pageQueue;
+    private readonly listeners;
+    constructor(ref: TrackingConfigReference, fetchImpl?: typeof fetch);
+    state(): RuntimeState;
+    config(): ConversionConfig | null;
+    __unsafeExpireAuthorityForTests(): void;
+    subscribe(listener: () => void): () => void;
+    ensureAuthority(): Promise<boolean>;
+    revalidate(): Promise<void>;
+    queuePageView(snapshot?: QueuedPageView | null): void;
+    fireConversion(key: string, options?: TrackingConfigConversionOptions): void;
+    queueAutomaticEvent(eventType: string, metadata: Record<string, unknown>, transactionPath: string): void;
+    listGoals(): ConversionGoal[];
+    private revalidateNow;
+    private expireAuthority;
+    private confirm;
+    private flush;
+}
+declare function getTrackingConfigRuntime(ref: TrackingConfigReference, fetchImpl?: typeof fetch): TrackingConfigRuntime;
+
 /**
  * Sales / Conversions wire schemas — the client-side source of truth.
  *
@@ -443,6 +492,10 @@ interface Sale {
     customer_name: string | null;
     customer_phone: string | null;
     customer_email: string | null;
+    /** CASL consent attestation stored on the sale; SMS send paths gate on it server-side. */
+    sms_consent: boolean;
+    /** Server timestamp for when the consent attestation was recorded. */
+    sms_consent_granted_at: string | null;
     created_at: string;
     updated_at: string;
     items: SaleItem[];
@@ -768,7 +821,7 @@ interface SalesClientConfig extends SalesTransportConfig {
      * the resolved config. Consent-gated + de-duped; no-ops server-side. Wire it from
      * `resolveConversionConfig(...)`.
      */
-    firing?: Pick<ConversionConfigStore, "getFiring">;
+    firing?: Pick<ConversionConfigStore, "getFiring"> | TrackingConfigRuntime;
 }
 /** Phone-keyed customer rollups (sk-only; a public key gets a `403`). */
 interface SalesCustomersClient {
@@ -903,4 +956,4 @@ interface PublicServiceItem {
  */
 declare function fetchServices(config: SalesTransportConfig): Promise<PublicServiceItem[]>;
 
-export { type SalesCustomersClient as $, AranovaApiError as A, type BusinessConfig as B, type ConversionConfig as C, type DistinctCustomersByCurrency as D, type SaleItemInput as E, type SaleKeysetSortField as F, type Granularity as G, type SaleListPage as H, type SaleListQuery as I, type SaleListQueryV2 as J, type SaleService as K, type SaleServiceInput as L, type SaleSortField as M, NAMED_RANGES as N, type SaleSortOrder as O, type PublicServiceItem as P, type SaleSummary as Q, type SaleSummaryPrevious as R, SUPPORTED_CURRENCIES as S, type SaleSummaryQuery as T, type SaleSummaryQueryV2 as U, type SaleSummaryV2 as V, type SaleUpdateInput as W, type SalesBusinessClient as X, type SalesCategoryBreakdown as Y, type SalesClient as Z, type SalesClientConfig as _, type BusinessConfigFeatures as a, type SalesServiceBreakdown as a0, type SalesTransportConfig as a1, type SalesTrendPoint as a2, type SummaryCurrencyDelta as a3, type SummaryDeltas as a4, type SummaryWindow as a5, type SupportedCurrency as a6, TRACKING_RANGES as a7, type TrackingOverviewRange as a8, createSalesClient as a9, fetchServices as aa, formatDateInTz as ab, formatMoney as ac, fromMinor as ad, resolveConversionConfig as ae, saleCreateSchema as af, saleItemSchema as ag, saleServiceSchema as ah, saleUpdateSchema as ai, salesRequest as aj, toMinor as ak, type BusinessConfigService as b, type CompareTo as c, type ConversionConfigStore as d, type CurrencyRevenue as e, type CustomerCurrencyDelta as f, type CustomerCurrencyTotal as g, type CustomerGetOptions as h, type CustomerGetResult as i, type CustomerKpis as j, type CustomerKpisDeltas as k, type CustomerKpisPrevious as l, type CustomerListPage as m, type CustomerListQuery as n, type CustomerProfile as o, type CustomerSegment as p, type CustomerSegmentCount as q, type CustomerSortField as r, type CustomerSummary as s, type CustomerSummaryQuery as t, type NamedRange as u, type Sale as v, type SaleCursorPage as w, type SaleFilters as x, type SaleInput as y, type SaleItem as z };
+export { type SalesClientConfig as $, AranovaApiError as A, type BusinessConfig as B, type ConversionConfig as C, type DistinctCustomersByCurrency as D, type SaleItemInput as E, type SaleKeysetSortField as F, type Granularity as G, type SaleListPage as H, type SaleListQuery as I, type SaleListQueryV2 as J, type SaleService as K, type SaleServiceInput as L, type SaleSortField as M, NAMED_RANGES as N, type SaleSortOrder as O, type PublicServiceItem as P, type SaleSummary as Q, type SaleSummaryPrevious as R, SUPPORTED_CURRENCIES as S, type TrackingConfigReference as T, type SaleSummaryQuery as U, type SaleSummaryQueryV2 as V, type SaleSummaryV2 as W, type SaleUpdateInput as X, type SalesBusinessClient as Y, type SalesCategoryBreakdown as Z, type SalesClient as _, type BusinessConfigFeatures as a, type SalesCustomersClient as a0, type SalesServiceBreakdown as a1, type SalesTransportConfig as a2, type SalesTrendPoint as a3, type SummaryCurrencyDelta as a4, type SummaryDeltas as a5, type SummaryWindow as a6, type SupportedCurrency as a7, TRACKING_RANGES as a8, type TrackingOverviewRange as a9, createSalesClient as aa, fetchServices as ab, formatDateInTz as ac, formatMoney as ad, fromMinor as ae, getTrackingConfigRuntime as af, resolveConversionConfig as ag, saleCreateSchema as ah, saleItemSchema as ai, saleServiceSchema as aj, saleUpdateSchema as ak, salesRequest as al, toMinor as am, type BusinessConfigService as b, type CompareTo as c, type ConversionConfigStore as d, type CurrencyRevenue as e, type CustomerCurrencyDelta as f, type CustomerCurrencyTotal as g, type CustomerGetOptions as h, type CustomerGetResult as i, type CustomerKpis as j, type CustomerKpisDeltas as k, type CustomerKpisPrevious as l, type CustomerListPage as m, type CustomerListQuery as n, type CustomerProfile as o, type CustomerSegment as p, type CustomerSegmentCount as q, type CustomerSortField as r, type CustomerSummary as s, type CustomerSummaryQuery as t, type NamedRange as u, type Sale as v, type SaleCursorPage as w, type SaleFilters as x, type SaleInput as y, type SaleItem as z };

package/dist/sales.d.mts

@@ -1,2 +1,2 @@
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z 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, T as SaleSummaryQuery, U as SaleSummaryQueryV2, V as SaleSummaryV2, W as SaleUpdateInput, X as SalesBusinessClient, Y as SalesCategoryBreakdown, Z as SalesClient, _ as SalesClientConfig, $ as SalesCustomersClient, a0 as SalesServiceBreakdown, a1 as SalesTransportConfig, a2 as SalesTrendPoint, a3 as SummaryCurrencyDelta, a4 as SummaryDeltas, a5 as SummaryWindow, a6 as SupportedCurrency, a7 as TRACKING_RANGES, a8 as TrackingOverviewRange, a9 as createSalesClient, aa as fetchServices, ab as formatDateInTz, ac as formatMoney, ad as fromMinor, af as saleCreateSchema, ag as saleItemSchema, ah as saleServiceSchema, ai as saleUpdateSchema, aj as salesRequest, ak as toMinor } from './sales-C3jFBx08.mjs';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z 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 createSalesClient, ab as fetchServices, ac as formatDateInTz, ad as formatMoney, ae as fromMinor, ah as saleCreateSchema, ai as saleItemSchema, aj as saleServiceSchema, ak as saleUpdateSchema, al as salesRequest, am as toMinor } from './sales-QqKh6_iy.mjs';
 import 'zod';

package/dist/sales.d.ts

@@ -1,2 +1,2 @@
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z 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, T as SaleSummaryQuery, U as SaleSummaryQueryV2, V as SaleSummaryV2, W as SaleUpdateInput, X as SalesBusinessClient, Y as SalesCategoryBreakdown, Z as SalesClient, _ as SalesClientConfig, $ as SalesCustomersClient, a0 as SalesServiceBreakdown, a1 as SalesTransportConfig, a2 as SalesTrendPoint, a3 as SummaryCurrencyDelta, a4 as SummaryDeltas, a5 as SummaryWindow, a6 as SupportedCurrency, a7 as TRACKING_RANGES, a8 as TrackingOverviewRange, a9 as createSalesClient, aa as fetchServices, ab as formatDateInTz, ac as formatMoney, ad as fromMinor, af as saleCreateSchema, ag as saleItemSchema, ah as saleServiceSchema, ai as saleUpdateSchema, aj as salesRequest, ak as toMinor } from './sales-C3jFBx08.js';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z 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 createSalesClient, ab as fetchServices, ac as formatDateInTz, ad as formatMoney, ae as fromMinor, ah as saleCreateSchema, ai as saleItemSchema, aj as saleServiceSchema, ak as saleUpdateSchema, al as salesRequest, am as toMinor } from './sales-QqKh6_iy.js';
 import 'zod';

package/dist/sales.js

@@ -248,6 +248,14 @@ function fireRecordedConversions(firing, input, recorded, sale, currency) {
   const txnBase = input.external_id ?? sale.id;
   for (const item of recorded) {
     if (!item.service) continue;
+    if ("fireConversion" in firing) {
+      firing.fireConversion(item.service, {
+        value: item.amount_cents != null ? fromMinor(item.amount_cents, currency) : void 0,
+        currency,
+        transactionId: `${txnBase}:${item.service}`
+      });
+      continue;
+    }
     const config = firing.getFiring(item.service);
     if (!config) continue;
     const cents = item.amount_cents ?? config.value_cents ?? null;
@@ -290,6 +298,14 @@ function createSalesClient(config) {
     // recordSale is the intent-revealing alias — same behavior, clearer call site.
     recordSale: record,
     trackConversion(key, options) {
+      if (config.firing && "fireConversion" in config.firing) {
+        config.firing.fireConversion(key, {
+          value: options?.value ?? void 0,
+          currency: options?.currency ?? config.defaultCurrency ?? void 0,
+          transactionId: options?.transactionId ?? null
+        });
+        return;
+      }
       const firing = config.firing?.getFiring(key);
       if (!firing) return;
       const currency = firing.currency ?? options?.currency ?? config.defaultCurrency ?? null;