@aranova/tracking-react 1.2.4 → 1.3.0

package/dist/sales.mjs

@@ -170,12 +170,105 @@ 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 }))
+  };
+}
+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 {
@@ -185,9 +278,17 @@ var AranovaApiError = class extends Error {
     this.status = options.status;
     this.code = options.code;
     this.requestId = options.requestId;
+    this.context = options.context;
   }
 };
 
+// ../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 };
@@ -211,19 +312,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;
@@ -233,6 +339,179 @@ async function apiRequest(config, method, path, body, extraHeaders) {
 // ../tracking-core/src/resources/sales/transport.ts
 var salesRequest = apiRequest;
 
+// ../tracking-core/src/resources/sales/bookings.ts
+var BOOKING_ERROR_CODES = {
+  unavailable: "booking_unavailable",
+  stale: "booking_config_stale",
+  rejected: "booking_rejected"
+};
+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 outcomeOf(body) {
+  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 };
+}
+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 runtimeOf(firing) {
+  return firing && "integrations" in firing ? firing : null;
+}
+function createSalesBookingsClient(config, firing) {
+  const submittedForms = /* @__PURE__ */ new Set();
+  const staleAttempts = /* @__PURE__ */ new Set();
+  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 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 };
+    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 { status: "failed", id: null, fallbackUrl: handoff(input) };
+    }
+    if (error.code === BOOKING_ERROR_CODES.stale) {
+      if (staleAttempts.has(attemptKey)) {
+        return { status: "failed", id: null, fallbackUrl: handoff(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 { status: "failed", id: null, fallbackUrl: handoff(input) };
+  }
+  return {
+    async submit(input, { attemptKey, formSubmit }) {
+      registerCapability("booking_integration");
+      const runtime = runtimeOf(firing);
+      const booking = getBookingIntegration(runtime?.integrations());
+      if (!booking?.acceptsBookings || booking.configVersion === null) {
+        return { status: "failed", id: null, fallbackUrl: handoff(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 {
+        response = await salesRequest(config, "POST", "/bookings", body);
+      } catch (error) {
+        return rejected(error, input, attemptKey, runtime);
+      }
+      const outcome = outcomeOf(response);
+      return withHandoff(outcome.status === "pending" ? await poll(outcome.id) : outcome, input);
+    },
+    async status(id) {
+      return outcomeOf(
+        await salesRequest(
+          config,
+          "GET",
+          `/bookings/${encodeURIComponent(id)}`
+        )
+      );
+    }
+  };
+}
+
 // ../tracking-core/src/resources/intl/date.ts
 function formatDateInTz(iso3, timeZone, opts, locale) {
   const date = new Date(iso3);
@@ -442,7 +721,8 @@ function createSalesClient(config) {
       async config() {
         return salesRequest(config, "GET", "/business/config");
       }
-    }
+    },
+    bookings: createSalesBookingsClient(config, config.firing)
   };
 }
 
@@ -451,6 +731,12 @@ import * as z2 from "zod/mini";
 
 // ../tracking-core/src/resources/sales/generated/zod.gen.ts
 import * as z from "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",
@@ -478,6 +764,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",
@@ -519,6 +808,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",
@@ -550,7 +840,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),
@@ -659,6 +950,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)
 });
@@ -668,6 +961,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));
@@ -747,6 +1041,7 @@ async function fetchServices(config) {
 export {
   AranovaApiError,
   NAMED_RANGES,
+  SALE_SOURCES,
   SUPPORTED_CURRENCIES,
   TRACKING_RANGES,
   createSalesClient,
@@ -755,6 +1050,7 @@ export {
   formatDateInTz,
   formatMoney,
   fromMinor,
+  newBookingAttemptKey,
   saleCreateSchema,
   saleItemSchema,
   saleServiceSchema,