@aranova/tracking-next 0.20.2 → 0.22.0

package/dist/index.js

@@ -32,39 +32,71 @@ var src_exports = {};
 __export(src_exports, {
   AdPlatformTracking: () => AdPlatformTracking,
   AranovaApiError: () => AranovaApiError,
+  BOOKING_SOURCES: () => BOOKING_SOURCES,
+  BOOKING_STATUSES: () => BOOKING_STATUSES,
+  CALENDAR_ERROR_CODES: () => CALENDAR_ERROR_CODES,
+  CALENDAR_METADATA_SCHEMA_VERSION: () => CALENDAR_METADATA_SCHEMA_VERSION,
+  CALENDAR_SYNC_STATUSES: () => CALENDAR_SYNC_STATUSES,
+  CalendarClientProvider: () => CalendarClientProvider,
   ConsentBanner: () => ConsentBanner,
   DEFAULT_DECLINE_TTL_DAYS: () => DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY: () => DEFAULT_PHONE_COUNTRY,
   EVENT_SEMANTICS: () => EVENT_SEMANTICS,
+  GOOGLE_SYNC_STATES: () => GOOGLE_SYNC_STATES,
   GoogleAdsTracking: () => GoogleAdsTracking,
+  MAX_ATTENDEES: () => MAX_ATTENDEES,
+  MAX_BOOKING_MINUTES: () => MAX_BOOKING_MINUTES,
+  MAX_REMINDER_MINUTES: () => MAX_REMINDER_MINUTES,
+  MAX_REMINDER_OVERRIDES: () => MAX_REMINDER_OVERRIDES,
   NAMED_RANGES: () => NAMED_RANGES,
   PhoneField: () => PhoneField,
   SUPPORTED_CURRENCIES: () => SUPPORTED_CURRENCIES,
   TRACKING_PARAM_KEYS: () => TRACKING_PARAM_KEYS,
   TRACKING_RANGES: () => TRACKING_RANGES,
+  bookingAttendeeSchema: () => bookingAttendeeSchema,
+  bookingCancelSchema: () => bookingCancelSchema,
+  bookingCreateSchema: () => bookingCreateSchema,
+  bookingCustomerSchema: () => bookingCustomerSchema,
+  bookingLocationNullableSchema: () => bookingLocationNullableSchema,
+  bookingLocationSchema: () => bookingLocationSchema,
+  bookingMetadataSchema: () => bookingMetadataSchema,
+  bookingReminderSchema: () => bookingReminderSchema,
+  bookingRemindersSchema: () => bookingRemindersSchema,
+  bookingRescheduleSchema: () => bookingRescheduleSchema,
   captureTrackingParamsFromLocation: () => captureTrackingParamsFromLocation,
   clearStashedUserData: () => clearStashedUserData,
+  computeSlots: () => computeSlots,
+  createCalendarReadClient: () => createCalendarReadClient,
   createSalesClient: () => createSalesClient,
   createTracking: () => createTracking,
   createTrackingClientContext: () => createTrackingClientContext,
   createTrackingEventCreatePayload: () => createTrackingEventCreatePayload,
   createTrackingSessionUpsertPayload: () => createTrackingSessionUpsertPayload,
+  durationMinutes: () => durationMinutes,
+  endOfDayInTz: () => endOfDayInTz,
   fetchServices: () => fetchServices,
   formatDateInTz: () => formatDateInTz,
   formatMoney: () => formatMoney,
   formatPhone: () => formatPhone,
   formatPhoneAsTyped: () => formatPhoneAsTyped,
+  formatSlotRange: () => formatSlotRange,
   fromMinor: () => fromMinor,
   getConsentChoice: () => getConsentChoice,
   getConsentState: () => getConsentState,
   getEventSemantics: () => getEventSemantics,
   getTrackingConfigRuntime: () => getTrackingConfigRuntime,
+  groupSlotsByDay: () => groupSlotsByDay,
+  instantFromWallClock: () => instantFromWallClock,
+  isCalendarError: () => isCalendarError,
+  localDateKey: () => localDateKey,
+  offsetMinutesAt: () => offsetMinutesAt,
   onConsentChange: () => onConsentChange,
   optIn: () => optIn,
   optOut: () => optOut,
   parsePhone: () => parsePhone,
   phoneField: () => phoneField,
   resetConsent: () => resetConsent,
+  resolveBrowserTimeZone: () => resolveBrowserTimeZone,
   resolveConversionConfig: () => resolveConversionConfig,
   saleCreateSchema: () => saleCreateSchema,
   saleItemSchema: () => saleItemSchema,
@@ -72,15 +104,20 @@ __export(src_exports, {
   saleUpdateSchema: () => saleUpdateSchema,
   salesRequest: () => salesRequest,
   setConsentState: () => setConsentState,
+  startOfDayInTz: () => startOfDayInTz,
   stashUserData: () => stashUserData,
   toE164: () => toE164,
   toMinor: () => toMinor,
+  useBookingForm: () => useBookingForm,
+  useCalendarBusy: () => useCalendarBusy,
+  useCalendarClient: () => useCalendarClient,
   useConsent: () => useConsent,
   useConsentState: () => useConsentState,
   useCookiePreferences: () => useCookiePreferences,
   useGclid: () => useGclid,
   usePhoneConfig: () => usePhoneConfig,
   usePhoneField: () => usePhoneField,
+  useSlots: () => useSlots,
   useTrackingParams: () => useTrackingParams
 });
 module.exports = __toCommonJS(src_exports);
@@ -345,6 +382,43 @@ var aranovaConsent = (function () {
 `.trim();
 }
 
+// ../tracking-core/src/capabilities.ts
+var TRACKING_CAPABILITIES = [
+  "ad_tags_google",
+  "ad_tags_meta",
+  "base_tracking",
+  "blog_rendering",
+  "calendar_read",
+  "calendar_write",
+  "consent_controls",
+  "conversion_goals_auto",
+  "conversion_goals_manual",
+  "cta_click_capture",
+  "form_capture",
+  "phone_click_capture",
+  "phone_fields"
+];
+var CAPABILITY_DOM_ATTRIBUTE = "data-aranova-capability";
+var registered = /* @__PURE__ */ new Set();
+function registerCapability(capability) {
+  registered.add(capability);
+}
+function getRegisteredCapabilities() {
+  const all = new Set(registered);
+  for (const marker of readDomMarkers()) all.add(marker);
+  return Array.from(all).sort();
+}
+function readDomMarkers() {
+  if (typeof document === "undefined") return [];
+  const known = new Set(TRACKING_CAPABILITIES);
+  const found = [];
+  for (const node of document.querySelectorAll(`[${CAPABILITY_DOM_ATTRIBUTE}]`)) {
+    const value = node.getAttribute(CAPABILITY_DOM_ATTRIBUTE);
+    if (value && known.has(value)) found.push(value);
+  }
+  return found;
+}
+
 // ../tracking-core/src/tracking.ts
 var TRACKING_COOKIE_MAX_AGE_SECONDS = 7776e3;
 var TRACKING_PARAM_KEYS = [
@@ -689,7 +763,8 @@ function createTrackingClientContext(surface, input = {}) {
     page_title: input.pageTitle ?? (typeof document === "undefined" ? null : document.title || null),
     referrer: input.referrer ?? (typeof document === "undefined" ? null : document.referrer || null),
     environment: input.environment ?? "production",
-    active_gtag_ids: input.activeGtagIds ?? null
+    active_gtag_ids: input.activeGtagIds ?? null,
+    capabilities: getRegisteredCapabilities()
   };
 }
 function createTrackingSessionUpsertPayload(trackingParams, input, context) {
@@ -1033,6 +1108,21 @@ function automaticThresholdMet(goal, eventType, metadata) {
   }
 }
 
+// ../tracking-core/src/resources/intl/date.ts
+function formatDateInTz(iso, timeZone, opts, locale) {
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return iso;
+  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,
@@ -1052,19 +1142,6 @@ function formatMoney(cents, currency, locale) {
     fromMinor(cents, currency)
   );
 }
-function formatDateInTz(iso, timeZone, opts, locale) {
-  const date = new Date(iso);
-  if (Number.isNaN(date.getTime())) return iso;
-  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/tracking-config-runtime.ts
 var CACHE_PREFIX2 = "_aranova_cfg_runtime_";
@@ -1681,7 +1758,10 @@ function buildContext(surface, sdkVersion, packageName, environment, activeGtagI
     page_title: typeof document === "undefined" ? null : document.title || null,
     referrer: typeof document === "undefined" ? null : document.referrer || null,
     environment,
-    active_gtag_ids: activeGtagIds
+    active_gtag_ids: activeGtagIds,
+    // Rebuilt per flush (this runs inside the payload builder), so a client
+    // constructed later on a deeper route still gets reported.
+    capabilities: getRegisteredCapabilities()
   };
 }
 function readTrackingParams() {
@@ -2274,8 +2354,9 @@ function getEventDefinition(name) {
 }
 
 // ../tracking-core/src/ingest-typed.ts
-function createTypedClient(raw, _registry, options = {}) {
+function createTypedClient(raw, registry, options = {}) {
   const debug = options.debug ?? false;
+  if (registry.manual?.form_submit) registerCapability("form_capture");
   return {
     trackEvent(eventType, metadata, opts) {
       if (debug) {
@@ -2682,6 +2763,7 @@ function attachCtaClickCapture(client, config) {
     return () => {
     };
   }
+  registerCapability("cta_click_capture");
   const selector = autoCapture.selector ?? DEFAULT_CTA_SELECTOR;
   function onClick(event) {
     const target = event.target;
@@ -2738,6 +2820,7 @@ function attachPhoneClickCapture(client, config) {
     return () => {
     };
   }
+  registerCapability("phone_click_capture");
   const selector = autoCapture.selector ?? DEFAULT_TEL_SELECTOR;
   function onClick(event) {
     const target = event.target;
@@ -2767,7 +2850,7 @@ function attachPhoneClickCapture(client, config) {
   };
 }
 
-// ../tracking-core/src/resources/sales/errors.ts
+// ../tracking-core/src/resources/http/errors.ts
 var AranovaApiError = class extends Error {
   constructor(message, options) {
     super(message);
@@ -2778,7 +2861,7 @@ var AranovaApiError = class extends Error {
   }
 };
 
-// ../tracking-core/src/resources/sales/transport.ts
+// ../tracking-core/src/resources/http/request.ts
 function identityHeaders(config) {
   const headers = { [API_KEY_HEADER]: config.apiKey };
   if (config.sdkVersion) headers[SDK_VERSION_HEADER] = config.sdkVersion;
@@ -2790,8 +2873,8 @@ function identityHeaders(config) {
 function joinUrl(endpoint, path) {
   return `${endpoint.replace(/\/$/, "")}${path}`;
 }
-async function salesRequest(config, method, path, body) {
-  const headers = identityHeaders(config);
+async function apiRequest(config, method, path, body, extraHeaders) {
+  const headers = { ...identityHeaders(config), ...extraHeaders };
   if (body !== void 0) headers["Content-Type"] = "application/json";
   const response = await fetch(joinUrl(config.endpoint, path), {
     method,
@@ -2820,6 +2903,9 @@ async function salesRequest(config, method, path, body) {
   return await response.json();
 }
 
+// ../tracking-core/src/resources/sales/transport.ts
+var salesRequest = apiRequest;
+
 // ../tracking-core/src/resources/sales/client.ts
 function fireRecordedConversions(firing, input, recorded, sale, currency) {
   if (!firing) return;
@@ -2851,6 +2937,7 @@ function fireRecordedConversions(firing, input, recorded, sale, currency) {
   }
 }
 function createSalesClient(config) {
+  if (config.firing) registerCapability("conversion_goals_manual");
   async function record(input) {
     const currency = input.currency ?? config.defaultCurrency;
     if (!currency) {
@@ -3150,6 +3237,7 @@ var DEFAULT_CHOICE2 = {
   expiresAt: null
 };
 function useCookiePreferences(options) {
+  registerCapability("consent_controls");
   const [choice, setChoice] = (0, import_react.useState)(DEFAULT_CHOICE2);
   const ttlDays = options?.declineTtlDays;
   (0, import_react.useEffect)(() => {
@@ -3417,6 +3505,8 @@ function AdPlatformTracking({
   }, [trackingConfigKey, standalonePageView]);
   const gtagAll = trackingConfig ? [] : gtagIds ? Object.values(gtagIds).filter((id) => id != null) : gtagId ? [gtagId] : [];
   const metaAll = metaPixelIds ? Object.values(metaPixelIds).filter((id) => id != null) : metaPixelId ? [metaPixelId] : [];
+  if (trackingConfig || gtagAll.length > 0) registerCapability("ad_tags_google");
+  if (metaAll.length > 0) registerCapability("ad_tags_meta");
   const gtagLoaderId = gtagAll[0];
   const gtagInitScript = gtagAll.length === 1 ? createGtagInitScript(gtagAll[0]) : createGtagInitScriptMulti(gtagAll);
   const metaInitScript = metaAll.length === 1 ? createMetaPixelInitScript(metaAll[0]) : createMetaPixelInitScriptMulti(metaAll);
@@ -3465,7 +3555,7 @@ function GoogleAdsTracking(props) {
 var import_navigation3 = require("next/navigation");
 
 // package.json
-var version = "0.20.2";
+var version = "0.22.0";
 
 // src/factory.tsx
 var import_react5 = require("react");
@@ -3492,6 +3582,7 @@ function usePhoneConfig() {
   };
 }
 function usePhoneField(opts = {}) {
+  registerCapability("phone_fields");
   const cfg = usePhoneConfig();
   const country = opts.country ?? cfg.defaultCountry;
   const display = opts.display ?? cfg.display;
@@ -3578,6 +3669,8 @@ function createTracking(options) {
     conversionConfig,
     trackingConfig
   } = options;
+  registerCapability("base_tracking");
+  if (trackingConfig) registerCapability("conversion_goals_auto");
   if (!apiKey || !endpoint) {
     if (apiKey || endpoint) {
       console.warn(
@@ -3746,43 +3839,490 @@ function createTracking(options) {
   }
   return { TrackingProvider, useTracking };
 }
+
+// ../tracking-core/src/resources/calendar/transport.ts
+async function calendarRequest(config, method, path, body) {
+  return apiRequest(config, method, `/calendar${path}`, body);
+}
+
+// ../tracking-core/src/resources/calendar/time.ts
+function resolveBrowserTimeZone() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+  } catch {
+    return "UTC";
+  }
+}
+function partsInTz(date, timeZone) {
+  const formatter = new Intl.DateTimeFormat("en-US", {
+    timeZone,
+    hour12: false,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit"
+  });
+  const out = {};
+  for (const part of formatter.formatToParts(date)) {
+    if (part.type !== "literal") out[part.type] = Number(part.value);
+  }
+  if (out.hour === 24) out.hour = 0;
+  return out;
+}
+function offsetMinutesAt(date, timeZone) {
+  const p = partsInTz(date, timeZone);
+  const asUtc = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second);
+  return (asUtc - Math.floor(date.getTime() / 1e3) * 1e3) / 6e4;
+}
+function instantFromWallClock(timeZone, year, month, day, hour = 0, minute = 0) {
+  const naive = Date.UTC(year, month - 1, day, hour, minute);
+  const firstGuess = new Date(naive - offsetMinutesAt(new Date(naive), timeZone) * 6e4);
+  const corrected = naive - offsetMinutesAt(firstGuess, timeZone) * 6e4;
+  return new Date(corrected);
+}
+function localDateKey(iso, timeZone) {
+  const p = partsInTz(new Date(iso), timeZone);
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${p.year}-${pad(p.month)}-${pad(p.day)}`;
+}
+function startOfDayInTz(dateKey, timeZone) {
+  const [year, month, day] = dateKey.split("-").map(Number);
+  return instantFromWallClock(timeZone, year, month, day, 0, 0);
+}
+function endOfDayInTz(dateKey, timeZone) {
+  const start = startOfDayInTz(dateKey, timeZone);
+  const p = partsInTz(start, timeZone);
+  return instantFromWallClock(timeZone, p.year, p.month, p.day + 1, 0, 0);
+}
+function durationMinutes(startIso, endIso) {
+  return Math.round((new Date(endIso).getTime() - new Date(startIso).getTime()) / 6e4);
+}
+function formatSlotRange(startIso, endIso, timeZone, locale) {
+  const opts = { hour: "2-digit", minute: "2-digit", timeZone };
+  const fmt = new Intl.DateTimeFormat(locale, opts);
+  return `${fmt.format(new Date(startIso))} \u2013 ${fmt.format(new Date(endIso))}`;
+}
+
+// ../tracking-core/src/resources/calendar/read-client.ts
+function withBusiness(config, path) {
+  if (!config.businessId) return path;
+  const separator = path.includes("?") ? "&" : "?";
+  return `${path}${separator}business_id=${encodeURIComponent(config.businessId)}`;
+}
+function createCalendarReadClient(config) {
+  registerCapability("calendar_read");
+  return {
+    async listCalendars() {
+      return calendarRequest(config, "GET", withBusiness(config, "/calendars"));
+    },
+    async busy(calendarKey, query) {
+      const params = new URLSearchParams({
+        since: query.since,
+        until: query.until
+      });
+      const timeZone = query.timeZone ?? config.defaultTimeZone ?? resolveBrowserTimeZone();
+      params.set("time_zone", timeZone);
+      return calendarRequest(
+        config,
+        "GET",
+        withBusiness(config, `/${encodeURIComponent(calendarKey)}/busy?${params.toString()}`)
+      );
+    }
+  };
+}
+function isCalendarError(error, code) {
+  if (!(error instanceof AranovaApiError)) return false;
+  return code === void 0 || error.code === code;
+}
+
+// ../tracking-core/src/resources/calendar/schema.ts
+var import_zod13 = require("zod");
+var CALENDAR_METADATA_SCHEMA_VERSION = 1;
+var MAX_ATTENDEES = 20;
+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 CALENDAR_ERROR_CODES = [
+  "slot_unavailable",
+  "calendar_not_connected",
+  "calendar_disconnected",
+  "booking_not_found",
+  "outside_booking_window",
+  "rate_limited",
+  "google_error"
+];
+var isoInstant = import_zod13.z.string().datetime({ offset: true });
+function isKnownTimeZone(timeZone) {
+  try {
+    new Intl.DateTimeFormat(void 0, { timeZone });
+    return true;
+  } catch {
+    return false;
+  }
+}
+var ianaTz = import_zod13.z.string().min(1).max(64).regex(/^[A-Za-z0-9_+\-/]+$/).refine(isKnownTimeZone, { message: "unknown IANA time zone" });
+var bookingAttendeeSchema = import_zod13.z.object({
+  email: import_zod13.z.string().max(320).email(),
+  display_name: import_zod13.z.string().max(200).nullable().optional(),
+  optional: import_zod13.z.boolean().default(false)
+}).strict();
+var bookingReminderSchema = import_zod13.z.object({
+  method: import_zod13.z.enum(["email", "popup"]),
+  minutes_before: import_zod13.z.number().int().min(0).max(MAX_REMINDER_MINUTES)
+}).strict();
+var bookingRemindersSchema = import_zod13.z.object({
+  use_calendar_defaults: import_zod13.z.boolean().default(true),
+  overrides: import_zod13.z.array(bookingReminderSchema).max(MAX_REMINDER_OVERRIDES).default([])
+}).strict();
+var bookingLocationSchema = import_zod13.z.union([
+  import_zod13.z.object({ kind: import_zod13.z.literal("google_meet") }).strict(),
+  import_zod13.z.object({ kind: import_zod13.z.literal("physical"), address: import_zod13.z.string().max(1024) }).strict(),
+  import_zod13.z.object({ kind: import_zod13.z.literal("phone"), phone: import_zod13.z.string().max(64) }).strict(),
+  import_zod13.z.object({ kind: import_zod13.z.literal("custom"), text: import_zod13.z.string().max(1024) }).strict()
+]);
+var bookingLocationNullableSchema = import_zod13.z.union([...bookingLocationSchema.options, import_zod13.z.null()]);
+var bookingCustomerSchema = import_zod13.z.object({
+  // Required: Google needs an address to send the invite that confirms the
+  // booking, and that invite is the whole confirmation mechanism.
+  email: import_zod13.z.string().max(320).email(),
+  name: import_zod13.z.string().max(200).nullable().optional(),
+  phone: import_zod13.z.string().max(64).nullable().optional(),
+  sms_consent: import_zod13.z.boolean().default(false)
+}).strict();
+var jsonScalar = import_zod13.z.union([import_zod13.z.string(), import_zod13.z.number(), import_zod13.z.boolean(), import_zod13.z.null()]);
+var bookingMetadataSchema = import_zod13.z.object({
+  schema_version: import_zod13.z.number().int().default(CALENDAR_METADATA_SCHEMA_VERSION),
+  source: import_zod13.z.enum(BOOKING_SOURCES).nullable().optional(),
+  service: import_zod13.z.string().max(64).nullable().optional(),
+  visitor_id: import_zod13.z.string().max(64).nullable().optional(),
+  session_id: import_zod13.z.string().max(64).nullable().optional(),
+  gclid: import_zod13.z.string().max(256).nullable().optional(),
+  fbclid: import_zod13.z.string().max(256).nullable().optional(),
+  utm_source: import_zod13.z.string().max(128).nullable().optional(),
+  utm_medium: import_zod13.z.string().max(128).nullable().optional(),
+  utm_campaign: import_zod13.z.string().max(128).nullable().optional(),
+  utm_term: import_zod13.z.string().max(128).nullable().optional(),
+  utm_content: import_zod13.z.string().max(128).nullable().optional(),
+  landing_page: import_zod13.z.string().max(2048).nullable().optional(),
+  referrer: import_zod13.z.string().max(2048).nullable().optional(),
+  notes: import_zod13.z.string().max(2e3).nullable().optional(),
+  custom: import_zod13.z.record(jsonScalar).nullable().optional()
+}).strict();
+function refineEndXor(value, ctx) {
+  const hasEnd = value.end_at !== void 0 && value.end_at !== null;
+  const hasDuration = value.duration_minutes !== void 0 && value.duration_minutes !== null;
+  if (hasEnd === hasDuration) {
+    ctx.addIssue({
+      code: import_zod13.z.ZodIssueCode.custom,
+      message: "provide exactly one of end_at or duration_minutes",
+      path: ["end_at"]
+    });
+    return;
+  }
+  if (hasEnd && new Date(value.end_at) <= new Date(value.start_at)) {
+    ctx.addIssue({
+      code: import_zod13.z.ZodIssueCode.custom,
+      message: "end_at must be after start_at",
+      path: ["end_at"]
+    });
+  }
+}
+var bookingCreateSchema = import_zod13.z.object({
+  calendar_key: import_zod13.z.string().min(1).max(64),
+  // Free-form: appointment types are the client site's own vocabulary, not
+  // configuration the dashboard holds.
+  appointment_type: import_zod13.z.string().max(64).nullable().optional(),
+  start_at: isoInstant,
+  end_at: isoInstant.nullable().optional(),
+  duration_minutes: import_zod13.z.number().int().positive().max(MAX_BOOKING_MINUTES).nullable().optional(),
+  /** The booker's zone — distinct from the business's and the calendar's. */
+  time_zone: ianaTz,
+  title: import_zod13.z.string().max(300).nullable().optional(),
+  description: import_zod13.z.string().max(8e3).nullable().optional(),
+  location: bookingLocationNullableSchema.optional(),
+  customer: bookingCustomerSchema,
+  attendees: import_zod13.z.array(bookingAttendeeSchema).max(MAX_ATTENDEES).default([]),
+  send_invites: import_zod13.z.boolean().default(true),
+  reminders: bookingRemindersSchema.nullable().optional(),
+  metadata: bookingMetadataSchema.nullable().optional(),
+  idempotency_key: import_zod13.z.string().max(128).nullable().optional(),
+  buffer_before_minutes: import_zod13.z.number().int().min(0).max(MAX_BOOKING_MINUTES).default(0),
+  buffer_after_minutes: import_zod13.z.number().int().min(0).max(MAX_BOOKING_MINUTES).default(0)
+}).strict().superRefine(refineEndXor);
+var bookingRescheduleSchema = import_zod13.z.object({
+  start_at: isoInstant,
+  end_at: isoInstant.nullable().optional(),
+  duration_minutes: import_zod13.z.number().int().positive().max(MAX_BOOKING_MINUTES).nullable().optional(),
+  time_zone: ianaTz,
+  notify_attendees: import_zod13.z.boolean().default(true),
+  reason: import_zod13.z.string().max(500).nullable().optional()
+}).strict().superRefine(refineEndXor);
+var bookingCancelSchema = import_zod13.z.object({
+  reason: import_zod13.z.string().max(500).nullable().optional(),
+  notify_attendees: import_zod13.z.boolean().default(true)
+}).strict();
+
+// ../tracking-core/src/resources/calendar/slots.ts
+function parseHhMm(value) {
+  const [hour, minute] = value.split(":").map(Number);
+  return [hour || 0, minute || 0];
+}
+function dateKeyOf(date, timeZone) {
+  const fmt = new Intl.DateTimeFormat("en-CA", {
+    timeZone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  });
+  return fmt.format(date);
+}
+function weekdayFromDateKey(dateKey) {
+  const [year, month, day] = dateKey.split("-").map(Number);
+  return new Date(Date.UTC(year, month - 1, day, 12)).getUTCDay();
+}
+function startOfLocalDay(at, timeZone) {
+  const [year, month, day] = dateKeyOf(at, timeZone).split("-").map(Number);
+  return instantFromWallClock(timeZone, year, month, day, 12, 0);
+}
+function overlaps(aStart, aEnd, bStart, bEnd) {
+  return aStart < bEnd && aEnd > bStart;
+}
+function computeSlots(options) {
+  const {
+    busy,
+    openingHours,
+    timeZone,
+    durationMinutes: durationMinutes2,
+    granularityMinutes = 15,
+    minNoticeMinutes = 0,
+    bufferBeforeMinutes = 0,
+    bufferAfterMinutes = 0,
+    windowDays = 30,
+    now = /* @__PURE__ */ new Date()
+  } = options;
+  const earliest = now.getTime() + minNoticeMinutes * 6e4;
+  const busyRanges = busy.map((interval) => [
+    new Date(interval.start_at).getTime(),
+    new Date(interval.end_at).getTime()
+  ]);
+  const slots = [];
+  let cursor = startOfLocalDay(now, timeZone);
+  for (let dayOffset = 0; dayOffset < windowDays; dayOffset += 1) {
+    const dateKey = dateKeyOf(cursor, timeZone);
+    const [year, month, day] = dateKey.split("-").map(Number);
+    cursor = instantFromWallClock(timeZone, year, month, day + 1, 12, 0);
+    if (openingHours.closedDates?.includes(dateKey)) continue;
+    const intervals = openingHours.overrides?.[dateKey] ?? openingHours.weekly[weekdayFromDateKey(dateKey)] ?? [];
+    for (const interval of intervals) {
+      const [openHour, openMinute] = parseHhMm(interval.start);
+      const [closeHour, closeMinute] = parseHhMm(interval.end);
+      const opensAt = instantFromWallClock(timeZone, year, month, day, openHour, openMinute);
+      const closesAt = instantFromWallClock(timeZone, year, month, day, closeHour, closeMinute);
+      for (let start = opensAt.getTime(); start + durationMinutes2 * 6e4 <= closesAt.getTime(); start += granularityMinutes * 6e4) {
+        const end = start + durationMinutes2 * 6e4;
+        if (start < earliest) continue;
+        const blockedStart = start - bufferBeforeMinutes * 6e4;
+        const blockedEnd = end + bufferAfterMinutes * 6e4;
+        const taken = busyRanges.some(
+          ([busyStart, busyEnd]) => overlaps(blockedStart, blockedEnd, busyStart, busyEnd)
+        );
+        if (taken) continue;
+        slots.push({
+          start_at: new Date(start).toISOString(),
+          end_at: new Date(end).toISOString()
+        });
+      }
+    }
+  }
+  slots.sort((a, b) => a.start_at.localeCompare(b.start_at));
+  return { slots, nextAvailableAt: slots[0]?.start_at ?? null };
+}
+function groupSlotsByDay(slots, timeZone) {
+  const byDay = /* @__PURE__ */ new Map();
+  for (const slot of slots) {
+    const key = dateKeyOf(new Date(slot.start_at), timeZone);
+    const bucket = byDay.get(key);
+    if (bucket) bucket.push(slot);
+    else byDay.set(key, [slot]);
+  }
+  return [...byDay.entries()].map(([date, daySlots]) => ({ date, slots: daySlots })).sort((a, b) => a.date.localeCompare(b.date));
+}
+
+// ../tracking-core/src/calendar-react.tsx
+var import_react6 = require("react");
+var import_jsx_runtime6 = require("react/jsx-runtime");
+var _calendarClientContext;
+function calendarClientContext() {
+  return _calendarClientContext ?? (_calendarClientContext = (0, import_react6.createContext)(null));
+}
+function CalendarClientProvider({
+  value,
+  children
+}) {
+  const Ctx = calendarClientContext();
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Ctx.Provider, { value, children });
+}
+function useCalendarClient() {
+  const client = (0, import_react6.useContext)(calendarClientContext());
+  if (!client) {
+    throw new Error(
+      "useCalendarClient requires <CalendarClientProvider>. Wire it via createTracking({ calendar })."
+    );
+  }
+  return client;
+}
+function useCalendarBusy(calendarKey, window2) {
+  const client = useCalendarClient();
+  const [busy, setBusy] = (0, import_react6.useState)([]);
+  const [timeZone, setTimeZone] = (0, import_react6.useState)(resolveBrowserTimeZone());
+  const [isLoading, setIsLoading] = (0, import_react6.useState)(true);
+  const [error, setError] = (0, import_react6.useState)(null);
+  const [nonce, setNonce] = (0, import_react6.useState)(0);
+  (0, import_react6.useEffect)(() => {
+    const controller = new AbortController();
+    setIsLoading(true);
+    client.busy(calendarKey, { since: window2.since, until: window2.until }).then((response) => {
+      if (controller.signal.aborted) return;
+      setBusy(response.busy);
+      setTimeZone(response.time_zone);
+      setError(null);
+    }).catch((cause) => {
+      if (controller.signal.aborted) return;
+      setError(cause instanceof Error ? cause : new Error(String(cause)));
+    }).finally(() => {
+      if (!controller.signal.aborted) setIsLoading(false);
+    });
+    return () => controller.abort();
+  }, [client, calendarKey, window2.since, window2.until, nonce]);
+  const refetch = (0, import_react6.useCallback)(() => setNonce((value) => value + 1), []);
+  return { busy, timeZone, isLoading, error, refetch };
+}
+function useSlots(busy, timeZone, options) {
+  const zone = options.timeZone ?? timeZone;
+  return (0, import_react6.useMemo)(() => {
+    const { slots, nextAvailableAt } = computeSlots({ ...options, busy, timeZone: zone });
+    return { slots, days: groupSlotsByDay(slots, zone), nextAvailableAt };
+  }, [busy, zone, options]);
+}
+function useBookingForm(options = {}) {
+  const endpoint = options.endpoint ?? "/api/aranova/calendar/bookings";
+  const [status, setStatus] = (0, import_react6.useState)("idle");
+  const [error, setError] = (0, import_react6.useState)(null);
+  const [booking, setBooking] = (0, import_react6.useState)(null);
+  const submit = (0, import_react6.useCallback)(
+    async (input) => {
+      setStatus("submitting");
+      setError(null);
+      try {
+        const response = await fetch(endpoint, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(input)
+        });
+        const body = await response.json().catch(() => null);
+        if (!response.ok) {
+          const detail = body && typeof body === "object" && typeof body.detail === "string" ? body.detail : "Booking failed";
+          throw new Error(detail);
+        }
+        setBooking(body);
+        setStatus("confirmed");
+        options.onConfirmed?.(body);
+      } catch (cause) {
+        setError(cause instanceof Error ? cause : new Error(String(cause)));
+        setStatus("failed");
+      }
+    },
+    [endpoint, options]
+  );
+  const reset = (0, import_react6.useCallback)(() => {
+    setStatus("idle");
+    setError(null);
+    setBooking(null);
+  }, []);
+  return { status, error, booking, submit, reset };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdPlatformTracking,
   AranovaApiError,
+  BOOKING_SOURCES,
+  BOOKING_STATUSES,
+  CALENDAR_ERROR_CODES,
+  CALENDAR_METADATA_SCHEMA_VERSION,
+  CALENDAR_SYNC_STATUSES,
+  CalendarClientProvider,
   ConsentBanner,
   DEFAULT_DECLINE_TTL_DAYS,
   DEFAULT_PHONE_COUNTRY,
   EVENT_SEMANTICS,
+  GOOGLE_SYNC_STATES,
   GoogleAdsTracking,
+  MAX_ATTENDEES,
+  MAX_BOOKING_MINUTES,
+  MAX_REMINDER_MINUTES,
+  MAX_REMINDER_OVERRIDES,
   NAMED_RANGES,
   PhoneField,
   SUPPORTED_CURRENCIES,
   TRACKING_PARAM_KEYS,
   TRACKING_RANGES,
+  bookingAttendeeSchema,
+  bookingCancelSchema,
+  bookingCreateSchema,
+  bookingCustomerSchema,
+  bookingLocationNullableSchema,
+  bookingLocationSchema,
+  bookingMetadataSchema,
+  bookingReminderSchema,
+  bookingRemindersSchema,
+  bookingRescheduleSchema,
   captureTrackingParamsFromLocation,
   clearStashedUserData,
+  computeSlots,
+  createCalendarReadClient,
   createSalesClient,
   createTracking,
   createTrackingClientContext,
   createTrackingEventCreatePayload,
   createTrackingSessionUpsertPayload,
+  durationMinutes,
+  endOfDayInTz,
   fetchServices,
   formatDateInTz,
   formatMoney,
   formatPhone,
   formatPhoneAsTyped,
+  formatSlotRange,
   fromMinor,
   getConsentChoice,
   getConsentState,
   getEventSemantics,
   getTrackingConfigRuntime,
+  groupSlotsByDay,
+  instantFromWallClock,
+  isCalendarError,
+  localDateKey,
+  offsetMinutesAt,
   onConsentChange,
   optIn,
   optOut,
   parsePhone,
   phoneField,
   resetConsent,
+  resolveBrowserTimeZone,
   resolveConversionConfig,
   saleCreateSchema,
   saleItemSchema,
@@ -3790,15 +4330,20 @@ function createTracking(options) {
   saleUpdateSchema,
   salesRequest,
   setConsentState,
+  startOfDayInTz,
   stashUserData,
   toE164,
   toMinor,
+  useBookingForm,
+  useCalendarBusy,
+  useCalendarClient,
   useConsent,
   useConsentState,
   useCookiePreferences,
   useGclid,
   usePhoneConfig,
   usePhoneField,
+  useSlots,
   useTrackingParams
 });
 //# sourceMappingURL=index.js.map