@aranova/tracking-next 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -6,9 +6,9 @@ export { A as ALL_AUTOMATIC_EVENT_NAMES, a as ALL_LEAD_EVENT_NAMES, b as ALL_MAN
 export { A as AranovaApiError, f as formatDateInTz } from './date-BHetnL7s.mjs';
 export { AdPlatformTracking, AdPlatformTrackingProps, ConsentBanner, ConsentBannerProps, CreateTrackingOptions, CreateTrackingResult, GoogleAdsTracking, GoogleAdsTrackingProps, PhoneField, PhoneFieldApi, PhoneFieldProps, PhoneInputProps, TrackingProviderProps, UseConsentResult, UseCookiePreferencesOptions, UseCookiePreferencesResult, UsePhoneFieldOptions, createTracking, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams } from '@aranova/tracking-next/client';
 import { CalendarReadClient, ComputeSlotsOptions, OpeningHours, Slot } from './calendar.mjs';
-export { BusyQuery, CalendarReadClientConfig, ComputeSlotsResult, OpeningInterval, computeSlots, createCalendarReadClient, durationMinutes, endOfDayInTz, formatSlotRange, groupSlotsByDay, instantFromWallClock, isCalendarError, localDateKey, offsetMinutesAt, resolveBrowserTimeZone, startOfDayInTz } from './calendar.mjs';
-import { a as Booking, B as BookingCreateInput, d as BusyInterval } from './transport-I_cMSFQ6.mjs';
-export { e as BOOKING_SOURCES, f as BOOKING_STATUSES, g as BookingAttendee, c as BookingCancelInput, h as BookingCustomer, i as BookingLocation, j as BookingMetadata, k as BookingReminders, b as BookingRescheduleInput, l as BookingStatus, m as BusyResponse, n as CALENDAR_ERROR_CODES, o as CALENDAR_METADATA_SCHEMA_VERSION, p as CALENDAR_SYNC_STATUSES, q as CalendarErrorCode, r as CalendarSummary, s as CalendarSyncStatus, C as CalendarTransportConfig, G as GOOGLE_SYNC_STATES, t as GoogleSyncState, J as JsonScalar, M as MAX_ATTENDEES, u as MAX_BOOKING_MINUTES, v as MAX_REMINDER_MINUTES, w as MAX_REMINDER_OVERRIDES, x as bookingAttendeeSchema, y as bookingCancelSchema, z as bookingCreateSchema, A as bookingCustomerSchema, D as bookingLocationNullableSchema, E as bookingLocationSchema, F as bookingMetadataSchema, H as bookingReminderSchema, I as bookingRemindersSchema, K as bookingRescheduleSchema } from './transport-I_cMSFQ6.mjs';
+export { BookingAttribution, BusyQuery, CalendarReadClientConfig, ComputeSlotsResult, OpeningInterval, computeSlots, createCalendarReadClient, durationMinutes, endOfDayInTz, formatSlotRange, getBookingAttribution, groupSlotsByDay, instantFromWallClock, isCalendarError, localDateKey, offsetMinutesAt, resolveBrowserTimeZone, startOfDayInTz } from './calendar.mjs';
+import { a as Booking, B as BookingCreateInput, d as BusyInterval } from './transport-BlXQZs9Z.mjs';
+export { e as BOOKING_SOURCES, f as BOOKING_STATUSES, g as BookingAttendee, c as BookingCancelInput, h as BookingCustomer, i as BookingLocation, j as BookingMetadata, k as BookingReminders, b as BookingRescheduleInput, l as BookingStatus, m as BusyResponse, n as CALENDAR_ERROR_CODES, o as CALENDAR_METADATA_SCHEMA_VERSION, p as CALENDAR_SYNC_STATUSES, q as CalendarErrorCode, r as CalendarSummary, s as CalendarSyncStatus, C as CalendarTransportConfig, G as GOOGLE_SYNC_STATES, t as GoogleSyncState, J as JsonScalar, M as MAX_ATTENDEES, u as MAX_BOOKING_MINUTES, v as MAX_REMINDER_MINUTES, w as MAX_REMINDER_OVERRIDES, x as bookingAttendeeSchema, y as bookingCancelSchema, z as bookingCreateSchema, A as bookingCustomerSchema, D as bookingLocationNullableSchema, E as bookingLocationSchema, F as bookingMetadataSchema, H as bookingReminderSchema, I as bookingRemindersSchema, K as bookingRescheduleSchema } from './transport-BlXQZs9Z.mjs';
 import { ReactNode } from 'react';
 export { CountryCode } from 'libphonenumber-js';
 import 'zod/mini';
@@ -154,7 +154,8 @@ interface UseBookingFormResult {
  * Submit state for a booking.
  *
  * Posts to the SITE's own route handler, not to us: a booking needs a secret
- * key, which must never reach a browser bundle.
+ * key, which must never reach a browser bundle. The visit's attribution fills any
+ * `metadata` key the caller left unset, so the booking links to its journey.
  */
 declare function useBookingForm(options?: UseBookingFormOptions): UseBookingFormResult;
 

package/dist/index.d.ts

@@ -6,9 +6,9 @@ export { A as ALL_AUTOMATIC_EVENT_NAMES, a as ALL_LEAD_EVENT_NAMES, b as ALL_MAN
 export { A as AranovaApiError, f as formatDateInTz } from './date-BHetnL7s.js';
 export { AdPlatformTracking, AdPlatformTrackingProps, ConsentBanner, ConsentBannerProps, CreateTrackingOptions, CreateTrackingResult, GoogleAdsTracking, GoogleAdsTrackingProps, PhoneField, PhoneFieldApi, PhoneFieldProps, PhoneInputProps, TrackingProviderProps, UseConsentResult, UseCookiePreferencesOptions, UseCookiePreferencesResult, UsePhoneFieldOptions, createTracking, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams } from '@aranova/tracking-next/client';
 import { CalendarReadClient, ComputeSlotsOptions, OpeningHours, Slot } from './calendar.js';
-export { BusyQuery, CalendarReadClientConfig, ComputeSlotsResult, OpeningInterval, computeSlots, createCalendarReadClient, durationMinutes, endOfDayInTz, formatSlotRange, groupSlotsByDay, instantFromWallClock, isCalendarError, localDateKey, offsetMinutesAt, resolveBrowserTimeZone, startOfDayInTz } from './calendar.js';
-import { a as Booking, B as BookingCreateInput, d as BusyInterval } from './transport-CDmGOiCq.js';
-export { e as BOOKING_SOURCES, f as BOOKING_STATUSES, g as BookingAttendee, c as BookingCancelInput, h as BookingCustomer, i as BookingLocation, j as BookingMetadata, k as BookingReminders, b as BookingRescheduleInput, l as BookingStatus, m as BusyResponse, n as CALENDAR_ERROR_CODES, o as CALENDAR_METADATA_SCHEMA_VERSION, p as CALENDAR_SYNC_STATUSES, q as CalendarErrorCode, r as CalendarSummary, s as CalendarSyncStatus, C as CalendarTransportConfig, G as GOOGLE_SYNC_STATES, t as GoogleSyncState, J as JsonScalar, M as MAX_ATTENDEES, u as MAX_BOOKING_MINUTES, v as MAX_REMINDER_MINUTES, w as MAX_REMINDER_OVERRIDES, x as bookingAttendeeSchema, y as bookingCancelSchema, z as bookingCreateSchema, A as bookingCustomerSchema, D as bookingLocationNullableSchema, E as bookingLocationSchema, F as bookingMetadataSchema, H as bookingReminderSchema, I as bookingRemindersSchema, K as bookingRescheduleSchema } from './transport-CDmGOiCq.js';
+export { BookingAttribution, BusyQuery, CalendarReadClientConfig, ComputeSlotsResult, OpeningInterval, computeSlots, createCalendarReadClient, durationMinutes, endOfDayInTz, formatSlotRange, getBookingAttribution, groupSlotsByDay, instantFromWallClock, isCalendarError, localDateKey, offsetMinutesAt, resolveBrowserTimeZone, startOfDayInTz } from './calendar.js';
+import { a as Booking, B as BookingCreateInput, d as BusyInterval } from './transport-CAZYrZbB.js';
+export { e as BOOKING_SOURCES, f as BOOKING_STATUSES, g as BookingAttendee, c as BookingCancelInput, h as BookingCustomer, i as BookingLocation, j as BookingMetadata, k as BookingReminders, b as BookingRescheduleInput, l as BookingStatus, m as BusyResponse, n as CALENDAR_ERROR_CODES, o as CALENDAR_METADATA_SCHEMA_VERSION, p as CALENDAR_SYNC_STATUSES, q as CalendarErrorCode, r as CalendarSummary, s as CalendarSyncStatus, C as CalendarTransportConfig, G as GOOGLE_SYNC_STATES, t as GoogleSyncState, J as JsonScalar, M as MAX_ATTENDEES, u as MAX_BOOKING_MINUTES, v as MAX_REMINDER_MINUTES, w as MAX_REMINDER_OVERRIDES, x as bookingAttendeeSchema, y as bookingCancelSchema, z as bookingCreateSchema, A as bookingCustomerSchema, D as bookingLocationNullableSchema, E as bookingLocationSchema, F as bookingMetadataSchema, H as bookingReminderSchema, I as bookingRemindersSchema, K as bookingRescheduleSchema } from './transport-CAZYrZbB.js';
 import { ReactNode } from 'react';
 export { CountryCode } from 'libphonenumber-js';
 import 'zod/mini';
@@ -154,7 +154,8 @@ interface UseBookingFormResult {
  * Submit state for a booking.
  *
  * Posts to the SITE's own route handler, not to us: a booking needs a secret
- * key, which must never reach a browser bundle.
+ * key, which must never reach a browser bundle. The visit's attribution fills any
+ * `metadata` key the caller left unset, so the booking links to its journey.
  */
 declare function useBookingForm(options?: UseBookingFormOptions): UseBookingFormResult;
 

package/dist/index.js

@@ -82,6 +82,7 @@ __export(src_exports, {
   formatPhoneAsTyped: () => formatPhoneAsTyped,
   formatSlotRange: () => formatSlotRange,
   fromMinor: () => fromMinor,
+  getBookingAttribution: () => getBookingAttribution,
   getConsentChoice: () => getConsentChoice,
   getConsentState: () => getConsentState,
   getEventSemantics: () => getEventSemantics,
@@ -613,6 +614,35 @@ function buildLandingPayloadFields(sessionId, override) {
   };
 }
 
+// ../tracking-core/src/session.ts
+var VISITOR_STORAGE_KEY = "aranova_tracking_visitor";
+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 peekVisitorId() {
+  if (typeof window === "undefined") return null;
+  const existing = readLocalStorage(VISITOR_STORAGE_KEY);
+  return existing && existing.length > 0 ? existing : 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/cross-site-link.ts
 var LINK_PARAM = "_arv";
 var LINK_TOKEN_TTL_MS = 5 * 60 * 1e3;
@@ -1775,9 +1805,19 @@ var zErrorCode = z2.enum([
   "bad_request",
   "not_found",
   "conflict",
+  "gone",
   "incompatible_payload",
   "repeat_confirmation_required",
   "idempotency_conflict",
+  "slot_unavailable",
+  "calendar_not_connected",
+  "calendar_disconnected",
+  "booking_not_found",
+  "booking_not_cancellable",
+  "booking_not_reschedulable",
+  "manage_token_invalid",
+  "google_error",
+  "calendar_not_owned",
   "validation_error",
   "unknown_service",
   "invalid_sale_properties",
@@ -1841,6 +1881,7 @@ var zSmsWithheldReason = z2.enum([
   "no_handler",
   "dispatch_already_recorded",
   "text_back_disabled",
+  "number_text_back_disabled",
   "number_not_active",
   "a2p_registration_required",
   "alert_recipient_cannot_receive_sms",
@@ -2047,6 +2088,40 @@ function phoneField(name, raw, country) {
 // src/index.ts
 var import_client = require("@aranova/tracking-next/client");
 
+// ../tracking-core/src/resources/calendar/attribution.ts
+var LIMITS = {
+  session_id: 64,
+  visitor_id: 64,
+  gclid: 256,
+  fbclid: 256,
+  utm_source: 128,
+  utm_medium: 128,
+  utm_campaign: 128,
+  utm_term: 128,
+  utm_content: 128
+};
+function getBookingAttribution() {
+  if (typeof window === "undefined") return {};
+  const params = getTrackingParamsFromCookieReader(getCookieValueFromDocument);
+  const values = {
+    session_id: peekSessionId(),
+    visitor_id: peekVisitorId(),
+    gclid: params.gclid,
+    fbclid: params.fbclid,
+    utm_source: params.utm_source,
+    utm_medium: params.utm_medium,
+    utm_campaign: params.utm_campaign,
+    utm_term: params.utm_term,
+    utm_content: params.utm_content
+  };
+  const attribution = {};
+  for (const key of Object.keys(LIMITS)) {
+    const value = values[key];
+    if (value) attribution[key] = value.slice(0, LIMITS[key]);
+  }
+  return attribution;
+}
+
 // ../tracking-core/src/resources/calendar/transport.ts
 async function calendarRequest(config, method, path, body) {
   return apiRequest(config, method, `/calendar${path}`, body);
@@ -2179,22 +2254,27 @@ var zBookingRescheduleSchema = z4.strictObject({
   time_zone: z4.string().check(z4.minLength(1), z4.maxLength(64), z4.regex(/^[A-Za-z0-9_+\-\/]+$/))
 });
 var zBookingResponse = z4.strictObject({
+  all_day: z4.boolean(),
   appointment_type: z4.nullable(z4.string()),
   calendar_key: z4.string(),
+  created_at: z4.iso.datetime({ offset: true }),
   customer: zBookingCustomerOutput,
   end_at: z4.iso.datetime({ offset: true }),
+  google_event_id: z4.nullable(z4.string()),
   google_html_link: z4.nullable(z4.string()),
-  google_sync_state: z4.string(),
+  google_sync_state: z4.enum(["queued", "synced", "uncertain", "failed", "drifted"]),
+  ical_uid: z4.nullable(z4.string()),
   id: z4.string(),
   manage_token: z4.nullable(z4.string()),
   meet_url: z4.nullable(z4.string()),
+  organizer_email: z4.nullable(z4.string()),
   start_at: z4.iso.datetime({ offset: true }),
-  status: z4.string(),
+  status: z4.enum(["pending", "confirmed", "cancelled", "no_show"]),
   time_zone: z4.string(),
   title: z4.string()
 });
 var zBookingSource = z4.enum(["website", "phone", "walk_in", "import", "operator"]);
-var zBookingMetadata = z4.strictObject({
+var zBookingMetadataInput = z4.strictObject({
   custom: z4.nullish(
     z4.record(z4.string(), z4.nullable(z4.union([z4.string(), z4.int(), z4.number(), z4.boolean()])))
   ),
@@ -2214,6 +2294,40 @@ var zBookingMetadata = z4.strictObject({
   utm_term: z4.nullish(z4.string().check(z4.maxLength(128))),
   visitor_id: z4.nullish(z4.string().check(z4.maxLength(64)))
 });
+var zBusySource = z4.enum(["google", "booking"]);
+var zBusyInterval = z4.strictObject({
+  end_at: z4.iso.datetime({ offset: true }),
+  source: zBusySource,
+  start_at: z4.iso.datetime({ offset: true })
+});
+var zBusyWindow = z4.strictObject({
+  since: z4.iso.datetime({ offset: true }),
+  until: z4.iso.datetime({ offset: true })
+});
+var zBusyResponse = z4.strictObject({
+  busy: z4.array(zBusyInterval),
+  calendar_key: z4.string(),
+  generated_at: z4.iso.datetime({ offset: true }),
+  time_zone: z4.string(),
+  window: zBusyWindow
+});
+var zCalendarSummary = z4.strictObject({
+  allow_overlaps: z4.boolean(),
+  calendar_key: z4.string(),
+  connected_at: z4.nullable(z4.iso.datetime({ offset: true })),
+  google_account_email: z4.nullable(z4.string()),
+  granted_scopes: z4.nullable(z4.array(z4.string())),
+  label: z4.string(),
+  status: z4.enum([
+    "pending_invite",
+    "awaiting_calendar_selection",
+    "connected",
+    "needs_reconnect",
+    "revoked",
+    "disabled"
+  ]),
+  time_zone: z4.string()
+});
 var zCustomLocation = z4.strictObject({
   kind: z4.literal("custom"),
   text: z4.string().check(z4.maxLength(1024))
@@ -2233,9 +2347,19 @@ var zErrorCode2 = z4.enum([
   "bad_request",
   "not_found",
   "conflict",
+  "gone",
   "incompatible_payload",
   "repeat_confirmation_required",
   "idempotency_conflict",
+  "slot_unavailable",
+  "calendar_not_connected",
+  "calendar_disconnected",
+  "booking_not_found",
+  "booking_not_cancellable",
+  "booking_not_reschedulable",
+  "manage_token_invalid",
+  "google_error",
+  "calendar_not_owned",
   "validation_error",
   "unknown_service",
   "invalid_sale_properties",
@@ -2270,15 +2394,16 @@ var zBookingCreateSchema = z4.strictObject({
   buffer_before_minutes: z4._default(z4.optional(z4.int().check(z4.gte(0), z4.lte(1440))), 0),
   calendar_key: z4.string().check(z4.minLength(1), z4.maxLength(64)),
   customer: zBookingCustomerInput,
+  date: z4.nullish(z4.iso.date()),
   description: z4.nullish(z4.string().check(z4.maxLength(8e3))),
   duration_minutes: z4.nullish(z4.int().check(z4.gt(0), z4.lte(1440))),
   end_at: z4.nullish(z4.iso.datetime({ offset: true })),
   idempotency_key: z4.nullish(z4.string().check(z4.maxLength(128))),
   location: z4.nullish(z4.union([zMeetLocation, zPhysicalLocation, zPhoneLocation, zCustomLocation])),
-  metadata: z4.nullish(zBookingMetadata),
+  metadata: z4.nullish(zBookingMetadataInput),
   reminders: z4.nullish(zBookingReminders),
   send_invites: z4._default(z4.optional(z4.boolean()), true),
-  start_at: z4.iso.datetime({ offset: true }),
+  start_at: z4.nullish(z4.iso.datetime({ offset: true })),
   time_zone: z4.string().check(z4.minLength(1), z4.maxLength(64), z4.regex(/^[A-Za-z0-9_+\-\/]+$/)),
   title: z4.nullish(z4.string().check(z4.maxLength(300)))
 });
@@ -2312,22 +2437,17 @@ var MAX_REMINDER_OVERRIDES = 5;
 var MAX_REMINDER_MINUTES = 40320;
 var MAX_BOOKING_MINUTES = 1440;
 var BOOKING_SOURCES = ["website", "phone", "walk_in", "import", "operator"];
-var BOOKING_STATUSES = ["pending", "confirmed", "cancelled", "no_show"];
-var GOOGLE_SYNC_STATES = ["queued", "synced", "uncertain", "failed", "drifted"];
-var CALENDAR_SYNC_STATUSES = [
-  "pending_invite",
-  "awaiting_calendar_selection",
-  "connected",
-  "needs_reconnect",
-  "revoked",
-  "disabled"
-];
+var BOOKING_STATUSES = zBookingResponse.shape.status.options;
+var GOOGLE_SYNC_STATES = zBookingResponse.shape.google_sync_state.options;
+var CALENDAR_SYNC_STATUSES = zCalendarSummary.shape.status.options;
 var CALENDAR_ERROR_CODES = [
   "slot_unavailable",
   "calendar_not_connected",
   "calendar_disconnected",
   "booking_not_found",
-  "outside_booking_window",
+  "booking_not_cancellable",
+  "booking_not_reschedulable",
+  "manage_token_invalid",
   "rate_limited",
   "google_error"
 ];
@@ -2348,7 +2468,7 @@ var ianaTz = z5.string().check(
 var bookingAttendeeSchema = zBookingAttendee;
 var bookingReminderSchema = zBookingReminder;
 var bookingCustomerSchema = zBookingCustomerInput;
-var bookingMetadataSchema = z5.extend(zBookingMetadata, {
+var bookingMetadataSchema = z5.extend(zBookingMetadataInput, {
   custom: z5.nullish(
     z5.record(z5.string(), z5.union([z5.string(), z5.int(), z5.number(), z5.boolean(), z5.null()]))
   )
@@ -2377,6 +2497,24 @@ function refineEndXor(value, ctx) {
     addIssue2(ctx, ["end_at"], "end_at must be after start_at");
   }
 }
+function refineStartXor(value, ctx) {
+  const hasStart = value.start_at !== void 0 && value.start_at !== null;
+  const hasDate = value.date !== void 0 && value.date !== null;
+  if (hasStart === hasDate) {
+    addIssue2(ctx, ["start_at"], "provide exactly one of start_at or date");
+    return;
+  }
+  if (hasStart) {
+    refineEndXor(value, ctx);
+    return;
+  }
+  if (value.end_at != null || value.duration_minutes != null) {
+    addIssue2(ctx, ["date"], "an all-day booking (date) takes no end_at or duration_minutes");
+  }
+  if (value.buffer_before_minutes || value.buffer_after_minutes) {
+    addIssue2(ctx, ["date"], "an all-day booking (date) takes no buffers");
+  }
+}
 var bookingRemindersSchema = z5.extend(zBookingReminders, {
   overrides: z5._default(
     z5.array(bookingReminderSchema).check(z5.maxLength(MAX_REMINDER_OVERRIDES)),
@@ -2395,7 +2533,7 @@ var bookingCreateSchema = z5.extend(zBookingCreateSchema, {
   // our compositions into its own output.
   reminders: z5.nullish(bookingRemindersSchema),
   metadata: z5.nullish(bookingMetadataSchema)
-}).check((ctx) => refineEndXor(ctx.value, ctx));
+}).check((ctx) => refineStartXor(ctx.value, ctx));
 var bookingRescheduleSchema = z5.extend(zBookingRescheduleSchema, { time_zone: ianaTz }).check((ctx) => refineEndXor(ctx.value, ctx));
 var bookingCancelSchema = zBookingCancelSchema;
 
@@ -2554,7 +2692,10 @@ function useBookingForm(options = {}) {
         const response = await fetch(endpoint, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
-          body: JSON.stringify(input)
+          body: JSON.stringify({
+            ...input,
+            metadata: { ...getBookingAttribution(), ...input.metadata }
+          })
         });
         const body = await response.json().catch(() => null);
         if (!response.ok) {
@@ -2635,6 +2776,7 @@ var import_client2 = require("@aranova/tracking-next/client");
   formatPhoneAsTyped,
   formatSlotRange,
   fromMinor,
+  getBookingAttribution,
   getConsentChoice,
   getConsentState,
   getEventSemantics,