@aranova/tracking-react 1.2.5 → 1.4.0

package/dist/sales.js

@@ -32,6 +32,7 @@ var sales_exports = {};
 __export(sales_exports, {
   AranovaApiError: () => AranovaApiError,
   NAMED_RANGES: () => NAMED_RANGES,
+  SALE_SOURCES: () => SALE_SOURCES,
   SUPPORTED_CURRENCIES: () => SUPPORTED_CURRENCIES,
   TRACKING_RANGES: () => TRACKING_RANGES,
   createSalesClient: () => createSalesClient,
@@ -40,6 +41,7 @@ __export(sales_exports, {
   formatDateInTz: () => formatDateInTz,
   formatMoney: () => formatMoney,
   fromMinor: () => fromMinor,
+  newBookingAttemptKey: () => newBookingAttemptKey,
   saleCreateSchema: () => saleCreateSchema,
   saleItemSchema: () => saleItemSchema,
   saleServiceSchema: () => saleServiceSchema,
@@ -221,12 +223,106 @@ function fireConversionWithConsent(input, options) {
   }
 }
 
-// ../tracking-core/src/ingest.ts
-var API_KEY_HEADER = "X-Aranova-Api-Key";
-var SDK_VERSION_HEADER = "X-Aranova-Sdk-Version";
-var SDK_PACKAGE_HEADER = "X-Aranova-Sdk-Package";
-var SDK_SURFACE_HEADER = "X-Aranova-Sdk-Surface";
-var SDK_ENVIRONMENT_HEADER = "X-Aranova-Sdk-Environment";
+// ../../contracts/autoleap-booking-links.json
+var autoleap_booking_links_default = {
+  hosts: ["myalp.io"]
+};
+
+// ../tracking-core/src/integrations-public.ts
+var HANDOFF_HOSTS = new Set(autoleap_booking_links_default.hosts);
+function getBookingIntegration(integrations) {
+  const booking = integrations?.autoleap?.booking;
+  if (!booking) return null;
+  const rules = booking.rules ? camelRules(booking.rules) : null;
+  return {
+    provider: "autoleap",
+    enabled: booking.enabled,
+    fallbackUrl: booking.fallback_url,
+    acceptsBookings: booking.accepts_bookings && rules !== null && booking.config_version !== null,
+    timezone: booking.timezone,
+    configVersion: booking.config_version,
+    rules,
+    options: booking.options.map((option) => ({ key: option.key, label: option.label })),
+    mode: booking.mode ?? "live"
+  };
+}
+function camelRules(rules) {
+  return {
+    minDaysAhead: rules.min_days_ahead,
+    maxDaysAhead: rules.max_days_ahead,
+    hours: rules.hours,
+    closedDates: rules.closed_dates,
+    specialHours: rules.special_hours,
+    vehicleRequired: rules.vehicle_required,
+    dropOffOptions: rules.drop_off_options
+  };
+}
+function buildBookingHandoffUrl(fallbackUrl, prefill = {}) {
+  let url;
+  try {
+    url = new URL(fallbackUrl);
+  } catch {
+    return null;
+  }
+  if (url.protocol !== "https:" || !HANDOFF_HOSTS.has(url.hostname) || url.username || url.password || url.port) {
+    return null;
+  }
+  const [firstName, lastName] = prefill.firstName?.trim() ? [prefill.firstName, prefill.lastName] : splitFullName(prefill.name);
+  const values = [
+    ["firstName", firstName?.trim()],
+    ["lastName", lastName?.trim()],
+    ["phone", prefill.phone ? nationalDigits(prefill.phone) : ""],
+    ["email", prefill.email?.trim()]
+  ];
+  for (const [key, value] of values) {
+    if (value) url.searchParams.set(key, value);
+  }
+  return url.toString();
+}
+function splitFullName(name) {
+  const [first = "", ...rest] = (name ?? "").trim().split(/\s+/);
+  return [first, rest.join(" ")];
+}
+function nationalDigits(phone) {
+  const parsed = parsePhone(phone);
+  return (parsed.isValid ? parsed.national : phone).replace(/\D/g, "");
+}
+
+// ../tracking-core/src/uuid.ts
+function uuidV4() {
+  const cryptoApi = globalThis.crypto;
+  if (typeof cryptoApi?.randomUUID === "function") return cryptoApi.randomUUID();
+  const bytes = new Uint8Array(16);
+  if (typeof cryptoApi?.getRandomValues === "function") cryptoApi.getRandomValues(bytes);
+  else for (let i = 0; i < 16; i += 1) bytes[i] = Math.floor(Math.random() * 256);
+  bytes[6] = bytes[6] & 15 | 64;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+
+// ../tracking-core/src/session.ts
+var SESSION_STORAGE_KEY = "aranova_tracking_session";
+var SESSION_IDLE_MS = 30 * 60 * 1e3;
+function readLocalStorage(key) {
+  try {
+    return window.localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function peekSessionId(now = Date.now()) {
+  if (typeof window === "undefined") return null;
+  const raw = readLocalStorage(SESSION_STORAGE_KEY);
+  if (!raw) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.id !== "string" || typeof parsed.last_event_at !== "number") return null;
+    return now - parsed.last_event_at <= SESSION_IDLE_MS ? parsed.id : null;
+  } catch {
+    return null;
+  }
+}
 
 // ../tracking-core/src/resources/http/errors.ts
 var AranovaApiError = class extends Error {
@@ -236,9 +332,66 @@ var AranovaApiError = class extends Error {
     this.status = options.status;
     this.code = options.code;
     this.requestId = options.requestId;
+    this.context = options.context;
   }
 };
 
+// ../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";
+var SDK_PACKAGE_HEADER = "X-Aranova-Sdk-Package";
+var SDK_SURFACE_HEADER = "X-Aranova-Sdk-Surface";
+var SDK_ENVIRONMENT_HEADER = "X-Aranova-Sdk-Environment";
+
 // ../tracking-core/src/resources/http/request.ts
 function identityHeaders(config) {
   const headers = { [API_KEY_HEADER]: config.apiKey };
@@ -262,19 +415,24 @@ async function apiRequest(config, method, path, body, extraHeaders) {
   if (!response.ok) {
     let detail;
     let code;
+    let context;
     try {
       const parsed = await response.json();
       if (parsed && typeof parsed === "object") {
         const record3 = parsed;
         if (typeof record3.detail === "string") detail = record3.detail;
         if (typeof record3.code === "string") code = record3.code;
+        if (record3.context && typeof record3.context === "object") {
+          context = record3.context;
+        }
       }
     } catch {
     }
     throw new AranovaApiError(detail ?? response.statusText ?? "Request failed", {
       status: response.status,
       code,
-      requestId: response.headers.get("x-request-id") ?? void 0
+      requestId: response.headers.get("x-request-id") ?? void 0,
+      context
     });
   }
   if (response.status === 204) return void 0;
@@ -284,39 +442,212 @@ async function apiRequest(config, method, path, body, extraHeaders) {
 // ../tracking-core/src/resources/sales/transport.ts
 var salesRequest = apiRequest;
 
-// ../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
+// ../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",
+  rejected: "booking_rejected"
 };
-function exponentFor(currency) {
-  return MINOR_UNIT_EXPONENT[currency] ?? 2;
+var POLL_DELAYS_MS = [1e3, 2e3, 4e3, 8e3, 15e3];
+var INVALID_DETAILS = "Please check your details and try again.";
+var newBookingAttemptKey = uuidV4;
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
 }
-function toMinor(amount, currency) {
-  return Math.round(amount * 10 ** exponentFor(currency));
+function outcomeOf(body) {
+  const mode = body.mode ?? "live";
+  if (body.status === "created")
+    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 fromMinor(cents, currency) {
-  return cents / 10 ** exponentFor(currency);
+function formSubmitPayload(input, formId, labels) {
+  const vehicle = input.vehicle ? `${input.vehicle.year} ${input.vehicle.make} ${input.vehicle.model}` : "";
+  const field = (name, type, label, value) => ({
+    name,
+    type,
+    label,
+    value
+  });
+  return {
+    form: {
+      id: formId,
+      action: "/tracking/bookings",
+      fields: [
+        field("first_name", "text", "First name", input.firstName),
+        field("last_name", "text", "Last name", input.lastName),
+        // E.164 on the wire: it keys the customer and enhanced-conversion matching.
+        field("phone", "tel", "Phone", toE164(input.phone) ?? input.phone),
+        field("email", "email", "Email", input.email ?? ""),
+        field(
+          "service",
+          "select",
+          "Service",
+          input.services.map((key) => labels.get(key) ?? key).join(", ")
+        ),
+        field("vehicle", "text", "Vehicle", vehicle),
+        field(
+          "start",
+          "text",
+          "Requested time",
+          `${input.startDate} ${String(input.startHour).padStart(2, "0")}:00`
+        ),
+        field("note", "textarea", "Notes", input.notes ?? "")
+      ]
+    },
+    page: { path: typeof window === "undefined" ? "/" : window.location.pathname }
+  };
 }
-function formatMoney(cents, currency, locale) {
-  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(
-    fromMinor(cents, currency)
-  );
+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;
+    return buildBookingHandoffUrl(booking.fallbackUrl, {
+      firstName: input.firstName,
+      lastName: input.lastName,
+      phone: input.phone,
+      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, mode) {
+    let outcome = { status: "pending", id, mode };
+    for (const delay of POLL_DELAYS_MS) {
+      await sleep(delay);
+      try {
+        const path = `/bookings/${encodeURIComponent(id)}`;
+        outcome = outcomeOf(await salesRequest(config, "GET", path));
+      } catch {
+        continue;
+      }
+      if (outcome.status !== "pending") return outcome;
+    }
+    return outcome;
+  }
+  async function rejected(error, input, attemptKey, runtime) {
+    if (!(error instanceof AranovaApiError)) {
+      return failedBeforeSend(input);
+    }
+    if (error.code === BOOKING_ERROR_CODES.stale) {
+      if (staleAttempts.has(attemptKey)) return failedBeforeSend(input);
+      staleAttempts.add(attemptKey);
+      await runtime?.revalidate();
+      return { status: "stale", message: error.message };
+    }
+    if (error.code === BOOKING_ERROR_CODES.rejected) {
+      const reasons = error.context?.reasons;
+      return {
+        status: "invalid",
+        message: error.message,
+        reasons: Array.isArray(reasons) ? reasons.map(String) : []
+      };
+    }
+    if (error.code === "validation_error") {
+      return { status: "invalid", message: INVALID_DETAILS, reasons: [] };
+    }
+    return failedBeforeSend(input);
+  }
+  return {
+    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 failedBeforeSend(input);
+      }
+      if (formSubmit && !submittedForms.has(attemptKey)) {
+        submittedForms.add(attemptKey);
+        const labels = new Map(booking.options.map((option) => [option.key, option.label]));
+        formSubmit.tracking.trackEvent(
+          "form_submit",
+          formSubmitPayload(input, formSubmit.formId, labels)
+        );
+      }
+      const body = {
+        idempotency_key: attemptKey,
+        // The tracking client's own visit, so the booking and its form_submit share one session.
+        session_id: formSubmit?.tracking.getSessionId() ?? peekSessionId() ?? `no-session-${attemptKey}`,
+        config_version: booking.configVersion,
+        start_date: input.startDate,
+        start_hour: input.startHour,
+        first_name: input.firstName.trim(),
+        last_name: input.lastName.trim(),
+        phone: input.phone,
+        email: input.email?.trim() || null,
+        vehicle: input.vehicle ?? null,
+        drop_off: input.dropOff ?? null,
+        services: input.services,
+        notes: input.notes?.trim() || null,
+        marketing_sms_consent: input.marketingSmsConsent === true,
+        page_path: typeof window === "undefined" ? null : window.location.pathname
+      };
+      let response;
+      try {
+        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.mode) : outcome,
+        input
+      );
+    },
+    async status(id) {
+      return outcomeOf(
+        await salesRequest(
+          config,
+          "GET",
+          `/bookings/${encodeURIComponent(id)}`
+        )
+      );
+    }
+  };
 }
 
 // ../tracking-core/src/resources/sales/client.ts
@@ -493,7 +824,8 @@ function createSalesClient(config) {
       async config() {
         return salesRequest(config, "GET", "/business/config");
       }
-    }
+    },
+    bookings: createSalesBookingsClient(config, config.firing)
   };
 }
 
@@ -502,6 +834,12 @@ var z2 = __toESM(require("zod/mini"));
 
 // ../tracking-core/src/resources/sales/generated/zod.gen.ts
 var z = __toESM(require("zod/mini"));
+var zAutoLeapSaleFacts = z.object({
+  first_order: z.boolean(),
+  fleet_customer: z.boolean(),
+  invoice_code: z.string(),
+  invoice_id: z.string()
+});
 var zErrorCode = z.enum([
   "missing_credentials",
   "invalid_api_key",
@@ -529,6 +867,9 @@ var zErrorCode = z.enum([
   "booking_not_reschedulable",
   "manage_token_invalid",
   "google_error",
+  "booking_unavailable",
+  "booking_config_stale",
+  "booking_rejected",
   "calendar_not_owned",
   "calendar_is_sandbox",
   "sandbox_exists",
@@ -570,6 +911,7 @@ var zSaleServiceInputSchema = z.strictObject({
   amount_cents: z.int().check(z.gte(0)),
   service: z.string()
 });
+var zSaleSource = z.enum(["api", "admin", "autoleap"]);
 var zSmsAutomationState = z.enum([
   "needs_check",
   "failed",
@@ -601,7 +943,8 @@ var zSmsWithheldReason = z.enum([
   "number_not_active",
   "a2p_registration_required",
   "alert_recipient_cannot_receive_sms",
-  "line_type_unresolved"
+  "line_type_unresolved",
+  "sale_source_sends_own_messages"
 ]);
 var zSaleSmsStatusSchema = z.object({
   can_send_now: z._default(z.boolean(), false),
@@ -710,6 +1053,8 @@ var zSaleEntitySchema = z.object({
   sms_automation: z.nullable(zSaleSmsStatusSchema),
   sms_consent: z._default(z.boolean(), false),
   sms_consent_granted_at: z.nullable(z.iso.datetime({ offset: true })),
+  source: zSaleSource,
+  source_facts: z.nullable(zAutoLeapSaleFacts),
   updated_at: z.iso.datetime({ offset: true }),
   writeback: z.nullable(zSaleWritebackStatusSchema)
 });
@@ -719,6 +1064,7 @@ var saleItemSchema = zSaleItemInputSchema;
 var saleServiceSchema = zSaleServiceInputSchema;
 var currencySchema = zSupportedCurrency;
 var SUPPORTED_CURRENCIES = currencySchema.options;
+var SALE_SOURCES = zSaleSource.options;
 var centsSchema = z2.int().check(z2.gte(0));
 var metadataSchema = z2.record(z2.string(), z2.unknown());
 var customerNameSchema = z2.string().check(z2.maxLength(200));
@@ -799,6 +1145,7 @@ async function fetchServices(config) {
 0 && (module.exports = {
   AranovaApiError,
   NAMED_RANGES,
+  SALE_SOURCES,
   SUPPORTED_CURRENCIES,
   TRACKING_RANGES,
   createSalesClient,
@@ -807,6 +1154,7 @@ async function fetchServices(config) {
   formatDateInTz,
   formatMoney,
   fromMinor,
+  newBookingAttemptKey,
   saleCreateSchema,
   saleItemSchema,
   saleServiceSchema,