@aranova/tracking-react 1.3.0 → 1.4.0

package/dist/{ingest-typed-DGqzbteM.d.ts → ingest-typed-D2S3Kb8m.d.ts}

@@ -1,4 +1,4 @@
-import { f as BookingDayWindows, h as ConversionIntegrations } from './bookings-CqdjLMkv.js';
+import { j as BookingDayWindows, c as BookingMode, k as ConversionIntegrations } from './bookings-DIu1ho6v.js';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod/mini';
 import { J as JsonValue, F as FormSubmitConfig, a as FormSubmitMetadata } from './form-submit-BLb28aCk.js';
@@ -38,6 +38,11 @@ interface BookingIntegration {
     configVersion: number | null;
     rules: BookingRules | null;
     options: BookingOption[];
+    /**
+     * Where a booking from this page goes: `live` in production; on a development config `test`
+     * (the shop's test lead source) or `simulated` (never sent). Show a banner when not `live`.
+     */
+    mode: BookingMode;
 }
 /** What the visitor already typed, carried onto the shop's booking page. */
 interface BookingHandoffPrefill {

package/dist/{ingest-typed-BCUv93ax.d.mts → ingest-typed-D7UZr0EM.d.mts}

@@ -1,4 +1,4 @@
-import { f as BookingDayWindows, h as ConversionIntegrations } from './bookings-VsQdopTt.mjs';
+import { j as BookingDayWindows, c as BookingMode, k as ConversionIntegrations } from './bookings-CqCuuyP6.mjs';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod/mini';
 import { J as JsonValue, F as FormSubmitConfig, a as FormSubmitMetadata } from './form-submit-BLb28aCk.mjs';
@@ -38,6 +38,11 @@ interface BookingIntegration {
     configVersion: number | null;
     rules: BookingRules | null;
     options: BookingOption[];
+    /**
+     * Where a booking from this page goes: `live` in production; on a development config `test`
+     * (the shop's test lead source) or `simulated` (never sent). Show a banner when not `live`.
+     */
+    mode: BookingMode;
 }
 /** What the visitor already typed, carried onto the shop's booking page. */
 interface BookingHandoffPrefill {

package/dist/{sales-DSL6vMuY.d.mts → sales-CxJVthx_.d.mts}

@@ -1,5 +1,5 @@
 import * as z from 'zod/mini';
-import { S as SalesBookingsClient, d as ConversionConfigStore, i as TrackingConfigRuntime } from './bookings-VsQdopTt.mjs';
+import { S as SalesBookingsClient, g as ConversionConfigStore, l as TrackingConfigRuntime } from './bookings-CqCuuyP6.mjs';
 import { CountryCode } from 'libphonenumber-js';
 
 /** Raw identifiers a caller may hand us (normalized before use). */

package/dist/{sales-_F3nnI2r.d.ts → sales-hlcVTJSS.d.ts}

@@ -1,5 +1,5 @@
 import * as z from 'zod/mini';
-import { S as SalesBookingsClient, d as ConversionConfigStore, i as TrackingConfigRuntime } from './bookings-CqdjLMkv.js';
+import { S as SalesBookingsClient, g as ConversionConfigStore, l as TrackingConfigRuntime } from './bookings-DIu1ho6v.js';
 import { CountryCode } from 'libphonenumber-js';
 
 /** Raw identifiers a caller may hand us (normalized before use). */

package/dist/sales.d.mts

@@ -1,5 +1,5 @@
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SALE_SOURCES, u as SUPPORTED_CURRENCIES, v as Sale, w as SaleBuiltinRequirableField, x as SaleCursorPage, y as SaleFilters, z as SaleInput, F as SaleItem, H as SaleItemInput, I as SaleKeysetSortField, J as SaleListPage, K as SaleListQuery, L as SaleListQueryV2, M as SalePropertyOption, O as SalePropertyType, Q as SaleService, R as SaleServiceInput, T as SaleSortField, U as SaleSortOrder, V as SaleSource, W as SaleSourceFacts, X as SaleSummary, Y as SaleSummaryPrevious, Z as SaleSummaryQuery, _ as SaleSummaryQueryV2, $ as SaleSummaryV2, a0 as SaleUpdateInput, a1 as SalesBusinessClient, a2 as SalesCategoryBreakdown, a3 as SalesClient, a4 as SalesClientConfig, a5 as SalesCustomersClient, a6 as SalesServiceBreakdown, a7 as SalesTransportConfig, a8 as SalesTrendPoint, a9 as SummaryCurrencyDelta, aa as SummaryDeltas, ab as SummaryWindow, ac as SupportedCurrency, ad as TRACKING_RANGES, ae as TrackingOverviewRange, ag as createSalesClient, ah as currencySchema, ai as fetchServices, aj as formatDateInTz, ak as formatMoney, al as fromMinor, am as saleCreateSchema, an as saleItemSchema, ao as saleServiceSchema, ap as saleUpdateSchema, aq as salesRequest, as as toMinor } from './sales-DSL6vMuY.mjs';
-export { B as BookingDropOff, a as BookingFormSubmit, b as BookingInput, c as BookingOutcome, S as SalesBookingsClient, n as newBookingAttemptKey } from './bookings-VsQdopTt.mjs';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SALE_SOURCES, u as SUPPORTED_CURRENCIES, v as Sale, w as SaleBuiltinRequirableField, x as SaleCursorPage, y as SaleFilters, z as SaleInput, F as SaleItem, H as SaleItemInput, I as SaleKeysetSortField, J as SaleListPage, K as SaleListQuery, L as SaleListQueryV2, M as SalePropertyOption, O as SalePropertyType, Q as SaleService, R as SaleServiceInput, T as SaleSortField, U as SaleSortOrder, V as SaleSource, W as SaleSourceFacts, X as SaleSummary, Y as SaleSummaryPrevious, Z as SaleSummaryQuery, _ as SaleSummaryQueryV2, $ as SaleSummaryV2, a0 as SaleUpdateInput, a1 as SalesBusinessClient, a2 as SalesCategoryBreakdown, a3 as SalesClient, a4 as SalesClientConfig, a5 as SalesCustomersClient, a6 as SalesServiceBreakdown, a7 as SalesTransportConfig, a8 as SalesTrendPoint, a9 as SummaryCurrencyDelta, aa as SummaryDeltas, ab as SummaryWindow, ac as SupportedCurrency, ad as TRACKING_RANGES, ae as TrackingOverviewRange, ag as createSalesClient, ah as currencySchema, ai as fetchServices, aj as formatDateInTz, ak as formatMoney, al as fromMinor, am as saleCreateSchema, an as saleItemSchema, ao as saleServiceSchema, ap as saleUpdateSchema, aq as salesRequest, as as toMinor } from './sales-CxJVthx_.mjs';
+export { B as BookingDropOff, a as BookingFormSubmit, b as BookingInput, c as BookingMode, d as BookingOutcome, e as BookingSimulation, f as BookingSubmitOptions, S as SalesBookingsClient, n as newBookingAttemptKey } from './bookings-CqCuuyP6.mjs';
 import 'zod/mini';
 import 'libphonenumber-js';
 import './form-submit-BLb28aCk.mjs';

package/dist/sales.d.ts

@@ -1,5 +1,5 @@
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SALE_SOURCES, u as SUPPORTED_CURRENCIES, v as Sale, w as SaleBuiltinRequirableField, x as SaleCursorPage, y as SaleFilters, z as SaleInput, F as SaleItem, H as SaleItemInput, I as SaleKeysetSortField, J as SaleListPage, K as SaleListQuery, L as SaleListQueryV2, M as SalePropertyOption, O as SalePropertyType, Q as SaleService, R as SaleServiceInput, T as SaleSortField, U as SaleSortOrder, V as SaleSource, W as SaleSourceFacts, X as SaleSummary, Y as SaleSummaryPrevious, Z as SaleSummaryQuery, _ as SaleSummaryQueryV2, $ as SaleSummaryV2, a0 as SaleUpdateInput, a1 as SalesBusinessClient, a2 as SalesCategoryBreakdown, a3 as SalesClient, a4 as SalesClientConfig, a5 as SalesCustomersClient, a6 as SalesServiceBreakdown, a7 as SalesTransportConfig, a8 as SalesTrendPoint, a9 as SummaryCurrencyDelta, aa as SummaryDeltas, ab as SummaryWindow, ac as SupportedCurrency, ad as TRACKING_RANGES, ae as TrackingOverviewRange, ag as createSalesClient, ah as currencySchema, ai as fetchServices, aj as formatDateInTz, ak as formatMoney, al as fromMinor, am as saleCreateSchema, an as saleItemSchema, ao as saleServiceSchema, ap as saleUpdateSchema, aq as salesRequest, as as toMinor } from './sales-_F3nnI2r.js';
-export { B as BookingDropOff, a as BookingFormSubmit, b as BookingInput, c as BookingOutcome, S as SalesBookingsClient, n as newBookingAttemptKey } from './bookings-CqdjLMkv.js';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SALE_SOURCES, u as SUPPORTED_CURRENCIES, v as Sale, w as SaleBuiltinRequirableField, x as SaleCursorPage, y as SaleFilters, z as SaleInput, F as SaleItem, H as SaleItemInput, I as SaleKeysetSortField, J as SaleListPage, K as SaleListQuery, L as SaleListQueryV2, M as SalePropertyOption, O as SalePropertyType, Q as SaleService, R as SaleServiceInput, T as SaleSortField, U as SaleSortOrder, V as SaleSource, W as SaleSourceFacts, X as SaleSummary, Y as SaleSummaryPrevious, Z as SaleSummaryQuery, _ as SaleSummaryQueryV2, $ as SaleSummaryV2, a0 as SaleUpdateInput, a1 as SalesBusinessClient, a2 as SalesCategoryBreakdown, a3 as SalesClient, a4 as SalesClientConfig, a5 as SalesCustomersClient, a6 as SalesServiceBreakdown, a7 as SalesTransportConfig, a8 as SalesTrendPoint, a9 as SummaryCurrencyDelta, aa as SummaryDeltas, ab as SummaryWindow, ac as SupportedCurrency, ad as TRACKING_RANGES, ae as TrackingOverviewRange, ag as createSalesClient, ah as currencySchema, ai as fetchServices, aj as formatDateInTz, ak as formatMoney, al as fromMinor, am as saleCreateSchema, an as saleItemSchema, ao as saleServiceSchema, ap as saleUpdateSchema, aq as salesRequest, as as toMinor } from './sales-hlcVTJSS.js';
+export { B as BookingDropOff, a as BookingFormSubmit, b as BookingInput, c as BookingMode, d as BookingOutcome, e as BookingSimulation, f as BookingSubmitOptions, S as SalesBookingsClient, n as newBookingAttemptKey } from './bookings-DIu1ho6v.js';
 import 'zod/mini';
 import 'libphonenumber-js';
 import './form-submit-BLb28aCk.js';

package/dist/sales.js

@@ -242,7 +242,8 @@ function getBookingIntegration(integrations) {
     timezone: booking.timezone,
     configVersion: booking.config_version,
     rules,
-    options: booking.options.map((option) => ({ key: option.key, label: option.label }))
+    options: booking.options.map((option) => ({ key: option.key, label: option.label })),
+    mode: booking.mode ?? "live"
   };
 }
 function camelRules(rules) {
@@ -335,6 +336,55 @@ var AranovaApiError = class extends Error {
   }
 };
 
+// ../tracking-core/src/resources/intl/date.ts
+function formatDateInTz(iso3, timeZone, opts, locale) {
+  const date = new Date(iso3);
+  if (Number.isNaN(date.getTime())) return iso3;
+  return new Intl.DateTimeFormat(locale, {
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    ...opts,
+    timeZone
+  }).format(date);
+}
+
+// ../tracking-core/src/resources/sales/money.ts
+var MINOR_UNIT_EXPONENT = {
+  USD: 2,
+  CAD: 2
+};
+function exponentFor(currency) {
+  return MINOR_UNIT_EXPONENT[currency] ?? 2;
+}
+function toMinor(amount, currency) {
+  return Math.round(amount * 10 ** exponentFor(currency));
+}
+function fromMinor(cents, currency) {
+  return cents / 10 ** exponentFor(currency);
+}
+function formatMoney(cents, currency, locale) {
+  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(
+    fromMinor(cents, currency)
+  );
+}
+
+// ../tracking-core/src/resources/tracking-config-runtime.ts
+var DEFAULT_CDN_BASE_URL = "https://demos.aranova.io";
+function trackingConfigKey(ref) {
+  if (ref.siteId) return `tracking-config/v1/sites/${ref.siteId}-${ref.environment}.json`;
+  return `tracking-config/v1/${ref.businessId}-${ref.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)}`;
+}
+var RETRY_MAX_MS = 5 * 6e4;
+
 // ../tracking-core/src/ingest.ts
 var API_KEY_HEADER = "X-Aranova-Api-Key";
 var SDK_VERSION_HEADER = "X-Aranova-Sdk-Version";
@@ -393,6 +443,7 @@ async function apiRequest(config, method, path, body, extraHeaders) {
 var salesRequest = apiRequest;
 
 // ../tracking-core/src/resources/sales/bookings.ts
+var BOOKING_SIMULATE_HEADER = "X-Aranova-Simulate";
 var BOOKING_ERROR_CODES = {
   unavailable: "booking_unavailable",
   stale: "booking_config_stale",
@@ -407,10 +458,11 @@ function sleep(ms) {
   });
 }
 function outcomeOf(body) {
+  const mode = body.mode ?? "live";
   if (body.status === "created")
-    return { status: "created", id: body.id, requestCode: body.request_code };
-  if (body.status === "pending") return { status: "pending", id: body.id };
-  return { status: "failed", id: body.id, fallbackUrl: body.fallback_url };
+    return { status: "created", id: body.id, requestCode: body.request_code, mode };
+  if (body.status === "pending") return { status: "pending", id: body.id, mode };
+  return { status: "failed", id: body.id, fallbackUrl: body.fallback_url, mode };
 }
 function formSubmitPayload(input, formId, labels) {
   const vehicle = input.vehicle ? `${input.vehicle.year} ${input.vehicle.make} ${input.vehicle.model}` : "";
@@ -452,9 +504,29 @@ function formSubmitPayload(input, formId, labels) {
 function runtimeOf(firing) {
   return firing && "integrations" in firing ? firing : null;
 }
+function isLocalUrl(url) {
+  try {
+    return ["localhost", "127.0.0.1", "[::1]"].includes(new URL(url).hostname);
+  } catch {
+    return false;
+  }
+}
+function bookingSetupMismatch(endpoint, runtime) {
+  if (!runtime || !isLocalUrl(endpoint)) return null;
+  const configUrl = resolveTrackingConfigUrl(runtime.ref);
+  if (isLocalUrl(configUrl)) return null;
+  return `[aranova] Bookings go to the local API (${endpoint}) but the runtime config comes from ${configUrl}. Set NEXT_PUBLIC_ARANOVA_CDN_BASE_URL to the local bucket (http://localhost:9100/aranova-demos) so both come from one backend.`;
+}
 function createSalesBookingsClient(config, firing) {
   const submittedForms = /* @__PURE__ */ new Set();
   const staleAttempts = /* @__PURE__ */ new Set();
+  let isSetupChecked = false;
+  function warnOnSetupMismatch(runtime) {
+    if (isSetupChecked) return;
+    isSetupChecked = true;
+    const warning = bookingSetupMismatch(config.endpoint, runtime);
+    if (warning) console.warn(warning);
+  }
   function handoff(input) {
     const booking = getBookingIntegration(runtimeOf(firing)?.integrations());
     if (!booking) return null;
@@ -465,14 +537,18 @@ function createSalesBookingsClient(config, firing) {
       email: input.email
     });
   }
+  function failedBeforeSend(input) {
+    const mode = getBookingIntegration(runtimeOf(firing)?.integrations())?.mode ?? "live";
+    return { status: "failed", id: null, fallbackUrl: handoff(input), mode };
+  }
   function withHandoff(outcome, input) {
     if (outcome.status === "failed" && !outcome.fallbackUrl) {
       return { ...outcome, fallbackUrl: handoff(input) };
     }
     return outcome;
   }
-  async function poll(id) {
-    let outcome = { status: "pending", id };
+  async function poll(id, mode) {
+    let outcome = { status: "pending", id, mode };
     for (const delay of POLL_DELAYS_MS) {
       await sleep(delay);
       try {
@@ -487,12 +563,10 @@ function createSalesBookingsClient(config, firing) {
   }
   async function rejected(error, input, attemptKey, runtime) {
     if (!(error instanceof AranovaApiError)) {
-      return { status: "failed", id: null, fallbackUrl: handoff(input) };
+      return failedBeforeSend(input);
     }
     if (error.code === BOOKING_ERROR_CODES.stale) {
-      if (staleAttempts.has(attemptKey)) {
-        return { status: "failed", id: null, fallbackUrl: handoff(input) };
-      }
+      if (staleAttempts.has(attemptKey)) return failedBeforeSend(input);
       staleAttempts.add(attemptKey);
       await runtime?.revalidate();
       return { status: "stale", message: error.message };
@@ -508,15 +582,16 @@ function createSalesBookingsClient(config, firing) {
     if (error.code === "validation_error") {
       return { status: "invalid", message: INVALID_DETAILS, reasons: [] };
     }
-    return { status: "failed", id: null, fallbackUrl: handoff(input) };
+    return failedBeforeSend(input);
   }
   return {
-    async submit(input, { attemptKey, formSubmit }) {
+    async submit(input, { attemptKey, formSubmit, simulate }) {
       registerCapability("booking_integration");
       const runtime = runtimeOf(firing);
+      warnOnSetupMismatch(runtime);
       const booking = getBookingIntegration(runtime?.integrations());
       if (!booking?.acceptsBookings || booking.configVersion === null) {
-        return { status: "failed", id: null, fallbackUrl: handoff(input) };
+        return failedBeforeSend(input);
       }
       if (formSubmit && !submittedForms.has(attemptKey)) {
         submittedForms.add(attemptKey);
@@ -546,12 +621,22 @@ function createSalesBookingsClient(config, firing) {
       };
       let response;
       try {
-        response = await salesRequest(config, "POST", "/bookings", body);
+        const headers = simulate ? { [BOOKING_SIMULATE_HEADER]: simulate } : void 0;
+        response = await salesRequest(
+          config,
+          "POST",
+          "/bookings",
+          body,
+          headers
+        );
       } catch (error) {
         return rejected(error, input, attemptKey, runtime);
       }
       const outcome = outcomeOf(response);
-      return withHandoff(outcome.status === "pending" ? await poll(outcome.id) : outcome, input);
+      return withHandoff(
+        outcome.status === "pending" ? await poll(outcome.id, outcome.mode) : outcome,
+        input
+      );
     },
     async status(id) {
       return outcomeOf(
@@ -565,41 +650,6 @@ function createSalesBookingsClient(config, firing) {
   };
 }
 
-// ../tracking-core/src/resources/intl/date.ts
-function formatDateInTz(iso3, timeZone, opts, locale) {
-  const date = new Date(iso3);
-  if (Number.isNaN(date.getTime())) return iso3;
-  return new Intl.DateTimeFormat(locale, {
-    year: "numeric",
-    month: "short",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    ...opts,
-    timeZone
-  }).format(date);
-}
-
-// ../tracking-core/src/resources/sales/money.ts
-var MINOR_UNIT_EXPONENT = {
-  USD: 2,
-  CAD: 2
-};
-function exponentFor(currency) {
-  return MINOR_UNIT_EXPONENT[currency] ?? 2;
-}
-function toMinor(amount, currency) {
-  return Math.round(amount * 10 ** exponentFor(currency));
-}
-function fromMinor(cents, currency) {
-  return cents / 10 ** exponentFor(currency);
-}
-function formatMoney(cents, currency, locale) {
-  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(
-    fromMinor(cents, currency)
-  );
-}
-
 // ../tracking-core/src/resources/sales/client.ts
 function fireRecordedConversions(firing, input, recorded, sale, currency) {
   if (!firing) return;