@cimplify/sdk 0.90.0 → 0.93.0

package/dist/{chunk-2UDEWILL.mjs → chunk-FKARGZK3.mjs}

@@ -1,4 +1,4 @@
-import { safe, generateIdempotencyKey, CatalogueQueries, CartOperations, CheckoutService, OrderQueries, LinkService, AuthService, BusinessService, InventoryService, SchedulingService, LiteService, FxService, createElements } from './chunk-ZU4ZRYUR.mjs';
+import { safe, generateIdempotencyKey, err, ok, CatalogueQueries, CartOperations, CheckoutService, OrderQueries, LinkService, AuthService, BusinessService, InventoryService, SchedulingService, LiteService, FxService, createElements } from './chunk-VUSHG3HA.mjs';
 import { CimplifyError, ErrorCode, IdempotencyMismatchError, enrichError } from './chunk-K5EN2W2Q.mjs';
 
 // src/store-credit.ts
@@ -72,6 +72,21 @@ var ActivityService = class {
       is_new_visitor: isNewVisitor
     };
   }
+  /**
+   * Record a page the visitor landed on. Product and category views already
+   * imply one, so call this for everything else — home, listings, booking,
+   * checkout — or entry pages, exits and bounce rate are computed from
+   * product pages alone.
+   */
+  trackPageView(options = {}) {
+    this.sendEvents([
+      {
+        type: "page_view",
+        page_path: options.pagePath ?? currentPath(),
+        page_title: options.pageTitle ?? currentTitle()
+      }
+    ]);
+  }
   trackProductView(productId, options = {}) {
     const event = {
       type: "product_view",
@@ -120,6 +135,12 @@ function currentPath() {
   }
   return void 0;
 }
+function currentTitle() {
+  if (typeof document !== "undefined" && document.title) {
+    return document.title;
+  }
+  return void 0;
+}
 function resolveVisitor() {
   try {
     const existing = localStorage.getItem(VISITOR_ID_STORAGE_KEY);
@@ -293,10 +314,137 @@ var DeliveryService = class {
   }
 };
 
+// src/internal/events.ts
+var MUTATION_ERROR = "mutation:error";
+var AUTH_TOKEN_CHANGED = "auth:token-changed";
+var SESSION_CLAIMED = "session:claimed";
+var SESSION_CLEARED = "session:cleared";
+function createClientEvents() {
+  const listeners = /* @__PURE__ */ new Map();
+  return {
+    on(name, listener) {
+      let set = listeners.get(name);
+      if (!set) {
+        set = /* @__PURE__ */ new Set();
+        listeners.set(name, set);
+      }
+      set.add(listener);
+      return () => {
+        set?.delete(listener);
+      };
+    },
+    off(name, listener) {
+      listeners.get(name)?.delete(listener);
+    },
+    emit(name, payload) {
+      const set = listeners.get(name);
+      if (!set) return;
+      const snapshot = Array.from(set);
+      for (const listener of snapshot) {
+        try {
+          listener(payload);
+        } catch (err2) {
+          console.error(`[Cimplify] event listener for "${name}" threw:`, err2);
+        }
+      }
+    }
+  };
+}
+
 // src/support.ts
+var CLAIM_TIMEOUT_MS = 15e3;
 var SupportService = class {
   constructor(client) {
     this.client = client;
+    this.claimInFlight = null;
+    this.claimInFlightToken = null;
+    this.lastClaimedAccessToken = null;
+    this.claimedName = null;
+    this.client.events.on(SESSION_CLEARED, () => {
+      this.lastClaimedAccessToken = null;
+      this.claimedName = null;
+    });
+    this.client.events.on(SESSION_CLAIMED, (event) => {
+      if (event.customerName) this.claimedName = event.customerName;
+    });
+  }
+  /** The verified customer this session's conversation was claimed for, null while anonymous. */
+  get claimedCustomerName() {
+    return this.claimedName;
+  }
+  /**
+   * Claim the anonymous session for the verified Link identity: the server
+   * verifies the access token, rotates the session token (adopted here, so
+   * every subsequent request rides the bound session), folds the guest cart
+   * in, and adopts or merges the widget conversation.
+   *
+   * Idempotent and single-flight: concurrent calls share one request, and a
+   * token already claimed by this instance short-circuits without a network
+   * round trip. Emits `session:claimed` on the client's event channel.
+   */
+  async claimConversation() {
+    const accessToken = this.client.getAccessToken();
+    if (!accessToken) {
+      return err(new CimplifyError("not_authenticated", "No access token to claim with"));
+    }
+    if (this.claimInFlight) {
+      if (this.claimInFlightToken === accessToken) return this.claimInFlight;
+      await this.claimInFlight;
+      return this.claimConversation();
+    }
+    if (this.lastClaimedAccessToken === accessToken) {
+      return err(new CimplifyError("already_claimed", "Session already claimed for this token"));
+    }
+    const epoch = this.client.getSessionEpoch();
+    this.claimInFlightToken = accessToken;
+    this.claimInFlight = (async () => {
+      const result = await safe(
+        this.client.post(
+          "/api/v1/support/conversation/claim",
+          { access_token: accessToken },
+          { timeoutMs: CLAIM_TIMEOUT_MS }
+        )
+      );
+      if (result.ok) {
+        if (this.client.getSessionEpoch() !== epoch) {
+          return err(
+            new CimplifyError("session_cleared", "Session was cleared during the claim")
+          );
+        }
+        this.lastClaimedAccessToken = accessToken;
+        this.claimedName = result.value.customer_name || null;
+        this.client.adoptSessionToken(result.value.session_token);
+        this.client.publishSessionClaimed(this.claimedName);
+        this.client.events.emit(SESSION_CLAIMED, {
+          sessionToken: result.value.session_token,
+          threadId: result.value.thread_id ?? null,
+          customerName: result.value.customer_name
+        });
+      }
+      return result;
+    })();
+    try {
+      return await this.claimInFlight;
+    } finally {
+      this.claimInFlight = null;
+      this.claimInFlightToken = null;
+    }
+  }
+  /**
+   * Peek at the conversation without creating one: resolves the existing
+   * thread (or null) so a page load can hydrate history without littering
+   * the inbox with empty threads.
+   */
+  async peekConversation() {
+    const result = await safe(
+      this.client.get("/api/v1/support/conversation")
+    );
+    if (!result.ok) return result;
+    if (!result.value.conversation) return ok(null);
+    return ok({
+      conversation: result.value.conversation,
+      messages: result.value.messages
+    });
   }
   /** Open (or resume) the customer's widget conversation. */
   async openConversation(opts) {
@@ -365,41 +513,9 @@ var SupportService = class {
   }
 };
 
-// src/internal/events.ts
-function createClientEvents() {
-  const listeners = /* @__PURE__ */ new Map();
-  return {
-    on(name, listener) {
-      let set = listeners.get(name);
-      if (!set) {
-        set = /* @__PURE__ */ new Set();
-        listeners.set(name, set);
-      }
-      set.add(listener);
-      return () => {
-        set?.delete(listener);
-      };
-    },
-    off(name, listener) {
-      listeners.get(name)?.delete(listener);
-    },
-    emit(name, payload) {
-      const set = listeners.get(name);
-      if (!set) return;
-      const snapshot = Array.from(set);
-      for (const listener of snapshot) {
-        try {
-          listener(payload);
-        } catch (err) {
-          console.error(`[Cimplify] event listener for "${name}" threw:`, err);
-        }
-      }
-    }
-  };
-}
-
 // src/client.ts
 var SESSION_TOKEN_STORAGE_KEY = "cimplify_session_token";
+var SESSION_SYNC_STORAGE_KEY = "cimplify_session_sync";
 var ORDER_TOKEN_PREFIX = "cimplify_ot_";
 var SESSION_TOKEN_HEADER = "x-session-token";
 var ORDER_TOKEN_TTL_MS = 24 * 60 * 60 * 1e3;
@@ -516,6 +632,7 @@ var CimplifyClient = class {
   constructor(config = {}) {
     this.accessToken = null;
     this.sessionToken = null;
+    this.sessionEpoch = 0;
     this.context = {};
     this.businessId = null;
     this.businessIdResolvePromise = null;
@@ -538,6 +655,7 @@ var CimplifyClient = class {
     this.hooks = config.hooks ?? {};
     this.fetchImpl = (config.fetch ?? globalThis.fetch).bind(globalThis);
     this.sessionToken = this.loadSessionToken() ?? this.mintSessionToken();
+    this.watchCrossTabSession();
     if (!this.publicKey && !config.suppressPublicKeyWarning) {
       console.warn(
         '[Cimplify] No public key found. Set NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY in your environment, or pass { publicKey: "cpk_..." } to createCimplifyClient().'
@@ -577,57 +695,133 @@ var CimplifyClient = class {
       newToken: token,
       source: "manual"
     });
+    this.events.emit(AUTH_TOKEN_CHANGED, { token });
+  }
+  /**
+   * Zero-UI claim: a freshly verified customer identity (OTP verify, silent
+   * refresh restore) binds the anonymous session so the conversation, cart
+   * and orders survive a cleared browser. Best-effort by design — a failed
+   * claim leaves the session anonymous, exactly as it was. Called by the
+   * auth flows, never by the raw token setter.
+   */
+  autoClaimChatIdentity() {
+    if (typeof window === "undefined" || !this.sessionToken || !this.accessToken) return;
+    void this.support.claimConversation();
+  }
+  /**
+   * Adopt a server-rotated session token (claim flow). The old token stays
+   * in flight-safe use until the next request; the storage swap makes the
+   * rotation durable across reloads.
+   */
+  adoptSessionToken(token) {
+    if (!token || token === this.sessionToken) return;
+    this.sessionToken = token;
+    this.saveSessionToken(token);
   }
   clearSession() {
     const previous = this.accessToken;
     this.accessToken = null;
     this.sessionToken = null;
-    if (typeof window !== "undefined" && window.localStorage) {
-      localStorage.removeItem(SESSION_TOKEN_STORAGE_KEY);
+    this.sessionEpoch++;
+    try {
+      this.safeStorage()?.removeItem(SESSION_TOKEN_STORAGE_KEY);
+    } catch {
     }
     this.sessionToken = this.mintSessionToken();
+    if (this.sessionToken) {
+      this.broadcastSessionSync({ type: "cleared", token: this.sessionToken });
+    }
     this.hooks.onSessionChange?.({
       previousToken: previous,
       newToken: null,
       source: "clear"
     });
+    this.events.emit(AUTH_TOKEN_CHANGED, { token: null });
+    this.events.emit(SESSION_CLEARED, {});
+  }
+  getSessionEpoch() {
+    return this.sessionEpoch;
+  }
+  publishSessionClaimed(customerName) {
+    if (!this.sessionToken) return;
+    this.broadcastSessionSync({
+      type: "claimed",
+      token: this.sessionToken,
+      name: customerName
+    });
   }
-  setOrderToken(orderId, token) {
-    if (typeof window !== "undefined" && window.localStorage) {
+  broadcastSessionSync(payload) {
+    try {
+      this.safeStorage()?.setItem(
+        SESSION_SYNC_STORAGE_KEY,
+        JSON.stringify({ ...payload, at: Date.now() })
+      );
+    } catch {
+    }
+  }
+  watchCrossTabSession() {
+    if (typeof window === "undefined" || typeof window.addEventListener !== "function") return;
+    window.addEventListener("storage", (event) => {
+      if (event.key !== SESSION_SYNC_STORAGE_KEY || !event.newValue) return;
+      let payload;
       try {
-        const entry = JSON.stringify({ token, storedAt: Date.now() });
-        localStorage.setItem(`${ORDER_TOKEN_PREFIX}${orderId}`, entry);
+        payload = JSON.parse(event.newValue);
       } catch {
+        return;
+      }
+      if (!payload?.token || payload.token === this.sessionToken) return;
+      if (payload.type === "claimed") {
+        this.sessionToken = payload.token;
+        this.events.emit(SESSION_CLAIMED, {
+          sessionToken: payload.token,
+          threadId: null,
+          customerName: payload.name ?? ""
+        });
+      } else if (payload.type === "cleared") {
+        this.accessToken = null;
+        this.sessionToken = payload.token;
+        this.sessionEpoch++;
+        this.events.emit(AUTH_TOKEN_CHANGED, { token: null });
+        this.events.emit(SESSION_CLEARED, {});
       }
+    });
+  }
+  setOrderToken(orderId, token) {
+    try {
+      const entry = JSON.stringify({ token, storedAt: Date.now() });
+      this.safeStorage()?.setItem(`${ORDER_TOKEN_PREFIX}${orderId}`, entry);
+    } catch {
     }
   }
   getOrderToken(orderId) {
-    if (typeof window !== "undefined" && window.localStorage) {
-      try {
-        const raw = localStorage.getItem(`${ORDER_TOKEN_PREFIX}${orderId}`);
-        if (!raw) return null;
-        const entry = JSON.parse(raw);
-        if (Date.now() - entry.storedAt > ORDER_TOKEN_TTL_MS) {
-          localStorage.removeItem(`${ORDER_TOKEN_PREFIX}${orderId}`);
-          return null;
-        }
-        return entry.token;
-      } catch {
+    try {
+      const storage = this.safeStorage();
+      if (!storage) return null;
+      const raw = storage.getItem(`${ORDER_TOKEN_PREFIX}${orderId}`);
+      if (!raw) return null;
+      const entry = JSON.parse(raw);
+      if (Date.now() - entry.storedAt > ORDER_TOKEN_TTL_MS) {
+        storage.removeItem(`${ORDER_TOKEN_PREFIX}${orderId}`);
         return null;
       }
+      return entry.token;
+    } catch {
+      return null;
     }
-    return null;
   }
   clearOrderTokens() {
-    if (typeof window !== "undefined" && window.localStorage) {
+    try {
+      const storage = this.safeStorage();
+      if (!storage) return;
       const keysToRemove = [];
-      for (let i = 0; i < localStorage.length; i++) {
-        const key = localStorage.key(i);
+      for (let i = 0; i < storage.length; i++) {
+        const key = storage.key(i);
         if (key?.startsWith(ORDER_TOKEN_PREFIX)) {
           keysToRemove.push(key);
         }
       }
-      keysToRemove.forEach((k) => localStorage.removeItem(k));
+      keysToRemove.forEach((k) => storage.removeItem(k));
+    } catch {
     }
   }
   setLocationId(locationId) {
@@ -686,22 +880,29 @@ var CimplifyClient = class {
       this.businessIdResolvePromise = null;
     }
   }
-  async authedFetch(url, options) {
-    return this.resilientFetch(url, options);
+  async authedFetch(url, options, timeoutMs) {
+    return this.resilientFetch(url, options, timeoutMs);
   }
   // Storage guards: even the `window.localStorage` property access throws in
   // some sandboxed iframes and strict private-browsing modes. These run in the
   // constructor at module load, so a throw would white-screen the whole app —
   // fall back to an in-memory session token instead.
-  loadSessionToken() {
+  safeStorage() {
     try {
       if (typeof window !== "undefined" && window.localStorage) {
-        return localStorage.getItem(SESSION_TOKEN_STORAGE_KEY);
+        return window.localStorage;
       }
     } catch {
     }
     return null;
   }
+  loadSessionToken() {
+    try {
+      return this.safeStorage()?.getItem(SESSION_TOKEN_STORAGE_KEY) ?? null;
+    } catch {
+      return null;
+    }
+  }
   /**
    * Mint the session token client-side so the very first request already
    * carries it. Without this, parallel first-load requests each get a
@@ -721,15 +922,15 @@ var CimplifyClient = class {
   }
   saveSessionToken(token) {
     try {
-      if (typeof window !== "undefined" && window.localStorage) {
-        localStorage.setItem(SESSION_TOKEN_STORAGE_KEY, token);
-      }
+      this.safeStorage()?.setItem(SESSION_TOKEN_STORAGE_KEY, token);
     } catch {
     }
   }
   captureSessionToken(response) {
+    if (typeof window === "undefined") return;
+    if (this.sessionToken) return;
     const token = response.headers.get(SESSION_TOKEN_HEADER);
-    if (token && token !== this.sessionToken) {
+    if (token) {
       this.sessionToken = token;
       this.saveSessionToken(token);
     }
@@ -757,7 +958,7 @@ var CimplifyClient = class {
     }
     return headers;
   }
-  async resilientFetch(url, options) {
+  async resilientFetch(url, options, timeoutMs) {
     const method = options.method || "GET";
     const path = url.replace(this.baseUrl, "").replace(this.linkApiUrl, "");
     const startTime = Date.now();
@@ -774,7 +975,7 @@ var CimplifyClient = class {
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
       try {
         const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs ?? this.timeout);
         const response = await this.fetchImpl(url, {
           ...options,
           signal: controller.signal
@@ -905,29 +1106,41 @@ var CimplifyClient = class {
     });
   }
   async post(path, body, opts) {
-    const response = await this.authedFetch(this.buildUrl(this.baseUrl, path), {
-      method: "POST",
-      credentials: this.credentials,
-      headers: mergeOptionHeaders(this.getHeaders(), opts),
-      body: body ? JSON.stringify(body) : void 0
-    });
+    const response = await this.authedFetch(
+      this.buildUrl(this.baseUrl, path),
+      {
+        method: "POST",
+        credentials: this.credentials,
+        headers: mergeOptionHeaders(this.getHeaders(), opts),
+        body: body ? JSON.stringify(body) : void 0
+      },
+      opts?.timeoutMs
+    );
     return this.handleRestResponse(response);
   }
   async patch(path, body, opts) {
-    const response = await this.authedFetch(this.buildUrl(this.baseUrl, path), {
-      method: "PATCH",
-      credentials: this.credentials,
-      headers: mergeOptionHeaders(this.getHeaders(), opts),
-      body: body ? JSON.stringify(body) : void 0
-    });
+    const response = await this.authedFetch(
+      this.buildUrl(this.baseUrl, path),
+      {
+        method: "PATCH",
+        credentials: this.credentials,
+        headers: mergeOptionHeaders(this.getHeaders(), opts),
+        body: body ? JSON.stringify(body) : void 0
+      },
+      opts?.timeoutMs
+    );
     return this.handleRestResponse(response);
   }
   async delete(path, opts) {
-    const response = await this.authedFetch(this.buildUrl(this.baseUrl, path), {
-      method: "DELETE",
-      credentials: this.credentials,
-      headers: mergeOptionHeaders(this.getHeaders(), opts)
-    });
+    const response = await this.authedFetch(
+      this.buildUrl(this.baseUrl, path),
+      {
+        method: "DELETE",
+        credentials: this.credentials,
+        headers: mergeOptionHeaders(this.getHeaders(), opts)
+      },
+      opts?.timeoutMs
+    );
     return this.handleRestResponse(response);
   }
   async linkGet(path, opts) {
@@ -943,12 +1156,16 @@ var CimplifyClient = class {
     });
   }
   async linkPost(path, body, opts) {
-    const response = await this.authedFetch(`${this.linkApiUrl}${path}`, {
-      method: "POST",
-      credentials: this.credentials,
-      headers: mergeOptionHeaders(this.getHeaders(), opts),
-      body: body ? JSON.stringify(body) : void 0
-    });
+    const response = await this.authedFetch(
+      `${this.linkApiUrl}${path}`,
+      {
+        method: "POST",
+        credentials: this.credentials,
+        headers: mergeOptionHeaders(this.getHeaders(), opts),
+        body: body ? JSON.stringify(body) : void 0
+      },
+      opts?.timeoutMs
+    );
     return this.handleRestResponse(response);
   }
   async linkDelete(path, opts) {
@@ -1123,4 +1340,4 @@ function createCimplifyClient(config = {}) {
   return new CimplifyClient(config);
 }
 
-export { ActivityService, CimplifyClient, DeliveryService, PlacesService, StoreCreditQueries, SubscriptionService, SupportService, UploadService, createCimplifyClient };
+export { ActivityService, CimplifyClient, DeliveryService, MUTATION_ERROR, PlacesService, SESSION_CLAIMED, SESSION_CLEARED, StoreCreditQueries, SubscriptionService, SupportService, UploadService, createCimplifyClient };

package/dist/{chunk-T7Z25EY4.js → chunk-HKN3YG76.js}

@@ -74,6 +74,85 @@ function getVariantDisplayName(variant, productName) {
   return productName || (variant.is_default ? "Default" : "Option");
 }
 
+// src/utils/price-basis.ts
+var MULTI_DAY_UNITS = /* @__PURE__ */ new Set([
+  "days",
+  "nights",
+  "weeks",
+  "months",
+  "years"
+]);
+var PERIOD_LABELS = {
+  minutes: "session",
+  hours: "session",
+  days: "day",
+  nights: "night",
+  weeks: "week",
+  months: "month",
+  years: "year"
+};
+function isMultiDayService(product) {
+  if ((product.type || "product") !== "service") return false;
+  if (product.scheduling_mode) return product.scheduling_mode === "multi_day";
+  return product.duration_unit != null && MULTI_DAY_UNITS.has(product.duration_unit);
+}
+function priceBasisLabel(product) {
+  if ((product.type || "product") !== "service") return null;
+  const basis = product.price_basis ?? (isMultiDayService(product) ? "per_duration_unit" : null);
+  if (basis === null || basis === "flat") return null;
+  if (basis === "per_person") return "person";
+  return PERIOD_LABELS[product.duration_unit ?? "nights"];
+}
+var DAY_MS = 864e5;
+function utcDateParts(iso) {
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return null;
+  return { year: date.getUTCFullYear(), month: date.getUTCMonth() + 1, day: date.getUTCDate() };
+}
+function stayPeriods(scheduledStart, scheduledEnd, durationUnit) {
+  const start = utcDateParts(scheduledStart);
+  const end = utcDateParts(scheduledEnd);
+  if (!start || !end) return 1;
+  const days = Math.max(
+    1,
+    Math.round(
+      (Date.UTC(end.year, end.month - 1, end.day) - Date.UTC(start.year, start.month - 1, start.day)) / DAY_MS
+    )
+  );
+  switch (durationUnit) {
+    case "weeks":
+      return Math.max(1, Math.ceil(days / 7));
+    case "months": {
+      let months = (end.year - start.year) * 12 + (end.month - start.month);
+      if (end.day > start.day) months += 1;
+      return Math.max(1, months);
+    }
+    case "years": {
+      let years = end.year - start.year;
+      if (end.month > start.month || end.month === start.month && end.day > start.day) {
+        years += 1;
+      }
+      return Math.max(1, years);
+    }
+    default:
+      return days;
+  }
+}
+function stayLength(scheduledStart, scheduledEnd, durationUnit) {
+  const periods = stayPeriods(scheduledStart, scheduledEnd, durationUnit);
+  const label = PERIOD_LABELS[durationUnit ?? "nights"];
+  return `${periods} ${label}${periods === 1 ? "" : "s"}`;
+}
+function serviceBillingMultiplier(product, selection) {
+  if ((product.type || "product") !== "service") return null;
+  const basis = product.price_basis ?? (isMultiDayService(product) ? "per_duration_unit" : "per_person");
+  const units = Math.max(1, selection.units ?? 1);
+  if (basis === "flat") return units;
+  if (basis === "per_person") return Math.max(1, selection.quantity) * units;
+  const periods = selection.scheduledStart && selection.scheduledEnd ? stayPeriods(selection.scheduledStart, selection.scheduledEnd, product.duration_unit) : 1;
+  return periods * units;
+}
+
 // src/types/product.ts
 var PRODUCT_TYPE = {
   Product: "product",
@@ -174,4 +253,9 @@ exports.allGalleryImages = allGalleryImages;
 exports.assetUrl = assetUrl;
 exports.getVariantDisplayName = getVariantDisplayName;
 exports.isCimplifyAsset = isCimplifyAsset;
+exports.isMultiDayService = isMultiDayService;
+exports.priceBasisLabel = priceBasisLabel;
 exports.resolveGallery = resolveGallery;
+exports.serviceBillingMultiplier = serviceBillingMultiplier;
+exports.stayLength = stayLength;
+exports.stayPeriods = stayPeriods;