@suiteop/storefront 0.4.0 → 0.6.0

package/dist/{errors-DoXdi1vS.d.ts → errors-welPvrD6.d.cts}

@@ -1,100 +1,131 @@
-import { B as BookingResult, x as StorefrontQuote } from './client-oyYRhUv0.js';
+import { B as BookingResult, z as StorefrontQuote } from './client-CX8K7JNt.cjs';
 import { z } from 'zod';
 
 declare const storefrontClientEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    name: z.ZodLiteral<"page_view">;
     eventId: z.ZodUUID;
     ts: z.ZodNumber;
     path: z.ZodString;
     referrerHost: z.ZodNullable<z.ZodString>;
+    name: z.ZodLiteral<"page_view">;
 }, z.core.$strip>, z.ZodObject<{
+    eventId: z.ZodUUID;
+    ts: z.ZodNumber;
+    path: z.ZodString;
+    referrerHost: z.ZodNullable<z.ZodString>;
     name: z.ZodLiteral<"view_search_results">;
     checkIn: z.ZodOptional<z.ZodISODate>;
     checkOut: z.ZodOptional<z.ZodISODate>;
     guests: z.ZodOptional<z.ZodNumber>;
     locationId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>, z.ZodObject<{
     eventId: z.ZodUUID;
     ts: z.ZodNumber;
     path: z.ZodString;
     referrerHost: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
     name: z.ZodLiteral<"view_item_list">;
     listName: z.ZodString;
     itemCount: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
     eventId: z.ZodUUID;
     ts: z.ZodNumber;
     path: z.ZodString;
     referrerHost: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
     name: z.ZodLiteral<"view_item">;
     listingId: z.ZodUUID;
+}, z.core.$strip>, z.ZodObject<{
     eventId: z.ZodUUID;
     ts: z.ZodNumber;
     path: z.ZodString;
     referrerHost: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
     name: z.ZodLiteral<"view_quote">;
     listingId: z.ZodUUID;
     valueMinor: z.ZodNumber;
     currency: z.ZodString;
     nights: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
     eventId: z.ZodUUID;
     ts: z.ZodNumber;
     path: z.ZodString;
     referrerHost: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
     name: z.ZodLiteral<"begin_checkout">;
     checkoutSessionId: z.ZodUUID;
+}, z.core.$strip>, z.ZodObject<{
     eventId: z.ZodUUID;
     ts: z.ZodNumber;
     path: z.ZodString;
     referrerHost: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
     name: z.ZodLiteral<"add_payment_info">;
     checkoutSessionId: z.ZodUUID;
+}, z.core.$strip>, z.ZodObject<{
     eventId: z.ZodUUID;
     ts: z.ZodNumber;
     path: z.ZodString;
     referrerHost: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
     name: z.ZodLiteral<"generate_lead">;
     formId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
     eventId: z.ZodUUID;
     ts: z.ZodNumber;
     path: z.ZodString;
     referrerHost: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
     name: z.ZodLiteral<"sign_up">;
     method: z.ZodLiteral<"newsletter">;
-    eventId: z.ZodUUID;
-    ts: z.ZodNumber;
-    path: z.ZodString;
-    referrerHost: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>], "name">;
 type StorefrontClientEvent = z.infer<typeof storefrontClientEventSchema>;
 
 type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+/**
+ * An event as a page tracks it: the SDK fills `eventId`, `ts`, `path` and `referrerHost`.
+ * `purchase` is not among them — revenue is written by the server when a booking confirms.
+ */
 type TrackEvent = DistributiveOmit<StorefrontClientEvent, 'eventId' | 'ts' | 'path' | 'referrerHost'>;
+/** Called once per analytics instance, on the first failed send. */
 type AnalyticsReporter = (err: unknown) => void;
 interface AnalyticsOptions {
+    /** The site's publishable key — sent as `?key=` (`navigator.sendBeacon` cannot set headers). */
     publishableKey: string;
     report?: AnalyticsReporter;
 }
 interface StorefrontAnalytics {
     track(event: TrackEvent): void;
+    /** A `page_view` of the current location. */
     pageView(): void;
+    /** Send what is queued now; `beacon` for a page that is going away. */
     flush(opts?: {
         beacon?: boolean;
     }): void;
     dispose(): void;
 }
+/**
+ * The Meta Pixel `Purchase` for a confirmed booking, under ads consent only, with the booking
+ * request id as `eventID` — the same `event_id` the server's Conversions API purchase carries, so
+ * Meta keeps one. `value` / `currency` are sent when the caller has the amount (minor units,
+ * ×100). Never sent to gtag: GA4 and Google Ads get purchase from the server only.
+ */
 declare function trackPurchasePixel(booking: Pick<BookingResult, 'bookingRequestId'> & {
     totalMinor?: number | null;
     currency?: string | null;
 }): void;
+/**
+ * Storefront analytics: batches GA4-aligned events in memory and posts them to the
+ * storefront edge every 2 s, at 10 events, and on `pagehide` (`navigator.sendBeacon`, else
+ * `fetch` with `keepalive`). Sent regardless of consent: the edge stores labels only — no IP, no
+ * user agent, no identifier — and nothing here reads or writes a cookie or web storage. Each
+ * event is also mirrored to the site's client tags (`gtag` / `fbq`) when the consent allows.
+ * A 404 means the site is not behind the SuiteOp edge: the instance goes quiet.
+ */
 declare function createAnalytics(opts: AnalyticsOptions): StorefrontAnalytics;
+/**
+ * The document's one analytics instance for a publishable key. It outlives any component — an
+ * Astro island unmounted by a view transition keeps its queue — and flushes on `pagehide`.
+ */
 declare function analyticsFor(publishableKey: string): StorefrontAnalytics;
 
+/**
+ * Every `error.code` the Storefront API answers, the codes the SuiteOp storefront edge answers,
+ * and the SDK's own.
+ * `StorefrontError.code` stays `string`, so a code a newer API adds degrades, never throws.
+ */
 declare const STOREFRONT_ERROR_CODES: readonly ["wrong_region", "origin_not_allowed", "origin_required", "site_archived", "not_bookable", "quote_invalid", "quote_expired", "price_changed", "currency_unsupported", "payment_declined", "session_expired", "rate_limited", "contact_not_configured", "payment_account_unavailable", "idempotency_key_required", "idempotency_key_reused", "payment_mode_unsupported", "payment_not_authorized", "payment_method_required", "site_not_published", "preview_read_only", "bookings_closed", "extras_invalid", "UNAUTHORIZED", "VALIDATION_ERROR", "NOT_FOUND", "site_not_found", "upstream_timeout", "timeout", "network", "invalid_response", "internal_error", "checkout_unavailable"];
 type StorefrontErrorCode = (typeof STOREFRONT_ERROR_CODES)[number];
 type StorefrontRegion = 'us' | 'eu' | 'apac';
@@ -107,27 +138,36 @@ interface StorefrontErrorInit {
     details?: Record<string, unknown>;
     cause?: unknown;
 }
+/** Any failure the client reports: an API refusal, a malformed answer, a timeout, the network. */
 declare class StorefrontError extends Error {
     name: string;
+    /** HTTP status; 0 when no response arrived (timeout, network). */
     readonly status: number;
     readonly type: string;
+    /** `StorefrontErrorCode` for every code this version knows; any string for newer ones. */
     readonly code: StorefrontErrorCode | (string & {});
     readonly requestId: string | null;
     readonly details: Record<string, unknown>;
     constructor(init: StorefrontErrorInit);
 }
+/**
+ * `price_changed` (409). At checkout-session creation `quote` is the fresh quote to show the
+ * guest; at confirm it is null and `requiresNewSession` is true — start a new checkout.
+ */
 declare class PriceChangedError extends StorefrontError {
     name: string;
     readonly quote: StorefrontQuote | null;
     readonly requiresNewSession: boolean;
     constructor(init: StorefrontErrorInit);
 }
+/** `wrong_region` (421): the key belongs to another region. `baseUrl` is null when the API could not name it. */
 declare class WrongRegionError extends StorefrontError {
     name: string;
     readonly region: StorefrontRegion | null;
     readonly baseUrl: string | null;
     constructor(init: StorefrontErrorInit);
 }
+/** `rate_limited` (429). `scope` names the budget: this key, this visitor's IP, or the PMS account. */
 declare class RateLimitedError extends StorefrontError {
     name: string;
     readonly retryAfterSec: number | null;
@@ -144,6 +184,7 @@ declare class StorefrontNetworkError extends StorefrontError {
     name: string;
     constructor(cause: unknown);
 }
+/** A mistake in how the SDK is set up (bad key, bad base URL, hook outside its provider). */
 declare class StorefrontConfigError extends Error {
     name: string;
 }

package/dist/index.cjs

@@ -1,49 +1,49 @@
 'use strict';
 
-var chunkCTHHMNLE_cjs = require('./chunk-CTHHMNLE.cjs');
+var chunk3NE27PHL_cjs = require('./chunk-3NE27PHL.cjs');
 var chunkEVSAMV5K_cjs = require('./chunk-EVSAMV5K.cjs');
-require('./chunk-ZLAOY6IF.cjs');
-require('./chunk-E5CGGMCO.cjs');
-var chunkUSOISC2R_cjs = require('./chunk-USOISC2R.cjs');
-require('./chunk-LVFRVNT3.cjs');
+require('./chunk-JF245QUY.cjs');
+require('./chunk-QBHOJGZI.cjs');
+var chunkJ5FZ4WDQ_cjs = require('./chunk-J5FZ4WDQ.cjs');
+require('./chunk-EHQFWSP6.cjs');
 
 
 
 Object.defineProperty(exports, "SDK_VERSION", {
 	enumerable: true,
-	get: function () { return chunkCTHHMNLE_cjs.SDK_VERSION; }
+	get: function () { return chunk3NE27PHL_cjs.SDK_VERSION; }
 });
 Object.defineProperty(exports, "STOREFRONT_API_PATH", {
 	enumerable: true,
-	get: function () { return chunkCTHHMNLE_cjs.STOREFRONT_API_PATH; }
+	get: function () { return chunk3NE27PHL_cjs.STOREFRONT_API_PATH; }
 });
 Object.defineProperty(exports, "STOREFRONT_API_VERSION", {
 	enumerable: true,
-	get: function () { return chunkCTHHMNLE_cjs.STOREFRONT_API_VERSION; }
+	get: function () { return chunk3NE27PHL_cjs.STOREFRONT_API_VERSION; }
 });
 Object.defineProperty(exports, "analyticsFor", {
 	enumerable: true,
-	get: function () { return chunkCTHHMNLE_cjs.analyticsFor; }
+	get: function () { return chunk3NE27PHL_cjs.analyticsFor; }
 });
 Object.defineProperty(exports, "createAnalytics", {
 	enumerable: true,
-	get: function () { return chunkCTHHMNLE_cjs.createAnalytics; }
+	get: function () { return chunk3NE27PHL_cjs.createAnalytics; }
 });
 Object.defineProperty(exports, "createStorefrontClient", {
 	enumerable: true,
-	get: function () { return chunkCTHHMNLE_cjs.createStorefrontClient; }
+	get: function () { return chunk3NE27PHL_cjs.createStorefrontClient; }
 });
 Object.defineProperty(exports, "getAttribution", {
 	enumerable: true,
-	get: function () { return chunkCTHHMNLE_cjs.getAttribution; }
+	get: function () { return chunk3NE27PHL_cjs.getAttribution; }
 });
 Object.defineProperty(exports, "parsePublishableKey", {
 	enumerable: true,
-	get: function () { return chunkCTHHMNLE_cjs.parsePublishableKey; }
+	get: function () { return chunk3NE27PHL_cjs.parsePublishableKey; }
 });
 Object.defineProperty(exports, "trackPurchasePixel", {
 	enumerable: true,
-	get: function () { return chunkCTHHMNLE_cjs.trackPurchasePixel; }
+	get: function () { return chunk3NE27PHL_cjs.trackPurchasePixel; }
 });
 Object.defineProperty(exports, "IMAGE_WIDTHS", {
 	enumerable: true,
@@ -63,33 +63,33 @@ Object.defineProperty(exports, "imageUrl", {
 });
 Object.defineProperty(exports, "PriceChangedError", {
 	enumerable: true,
-	get: function () { return chunkUSOISC2R_cjs.PriceChangedError; }
+	get: function () { return chunkJ5FZ4WDQ_cjs.PriceChangedError; }
 });
 Object.defineProperty(exports, "RateLimitedError", {
 	enumerable: true,
-	get: function () { return chunkUSOISC2R_cjs.RateLimitedError; }
+	get: function () { return chunkJ5FZ4WDQ_cjs.RateLimitedError; }
 });
 Object.defineProperty(exports, "STOREFRONT_ERROR_CODES", {
 	enumerable: true,
-	get: function () { return chunkUSOISC2R_cjs.STOREFRONT_ERROR_CODES; }
+	get: function () { return chunkJ5FZ4WDQ_cjs.STOREFRONT_ERROR_CODES; }
 });
 Object.defineProperty(exports, "StorefrontConfigError", {
 	enumerable: true,
-	get: function () { return chunkUSOISC2R_cjs.StorefrontConfigError; }
+	get: function () { return chunkJ5FZ4WDQ_cjs.StorefrontConfigError; }
 });
 Object.defineProperty(exports, "StorefrontError", {
 	enumerable: true,
-	get: function () { return chunkUSOISC2R_cjs.StorefrontError; }
+	get: function () { return chunkJ5FZ4WDQ_cjs.StorefrontError; }
 });
 Object.defineProperty(exports, "StorefrontNetworkError", {
 	enumerable: true,
-	get: function () { return chunkUSOISC2R_cjs.StorefrontNetworkError; }
+	get: function () { return chunkJ5FZ4WDQ_cjs.StorefrontNetworkError; }
 });
 Object.defineProperty(exports, "StorefrontTimeoutError", {
 	enumerable: true,
-	get: function () { return chunkUSOISC2R_cjs.StorefrontTimeoutError; }
+	get: function () { return chunkJ5FZ4WDQ_cjs.StorefrontTimeoutError; }
 });
 Object.defineProperty(exports, "WrongRegionError", {
 	enumerable: true,
-	get: function () { return chunkUSOISC2R_cjs.WrongRegionError; }
+	get: function () { return chunkJ5FZ4WDQ_cjs.WrongRegionError; }
 });

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { S as StorefrontRegion } from './errors-CAW7nLHr.cjs';
-export { A as AnalyticsOptions, a as AnalyticsReporter, P as PriceChangedError, R as RateLimitedError, b as STOREFRONT_ERROR_CODES, c as StorefrontAnalytics, d as StorefrontConfigError, e as StorefrontError, f as StorefrontErrorCode, g as StorefrontErrorInit, h as StorefrontNetworkError, i as StorefrontTimeoutError, T as TrackEvent, W as WrongRegionError, j as analyticsFor, k as createAnalytics, t as trackPurchasePixel } from './errors-CAW7nLHr.cjs';
+import { S as StorefrontRegion } from './errors-welPvrD6.cjs';
+export { A as AnalyticsOptions, a as AnalyticsReporter, P as PriceChangedError, R as RateLimitedError, b as STOREFRONT_ERROR_CODES, c as StorefrontAnalytics, d as StorefrontConfigError, e as StorefrontError, f as StorefrontErrorCode, g as StorefrontErrorInit, h as StorefrontNetworkError, i as StorefrontTimeoutError, T as TrackEvent, W as WrongRegionError, j as analyticsFor, k as createAnalytics, t as trackPurchasePixel } from './errors-welPvrD6.cjs';
 import { z } from 'zod';
-export { B as BookingResult, C as CheckoutMountDescriptor, a as CheckoutSession, b as ConfirmCheckoutSessionInput, c as ConfirmCheckoutSessionRequest, d as ContentListQuery, e as CreateCheckoutSessionInput, f as CreateCheckoutSessionOptions, g as CreatedCheckoutSession, P as Page, R as RequestOptions, S as STOREFRONT_API_PATH, h as StorefrontBooking, i as StorefrontBuilding, j as StorefrontClient, k as StorefrontClientOptions, l as StorefrontContactInput, m as StorefrontContentItem, n as StorefrontContentModel, o as StorefrontContentRef, p as StorefrontGuestInput, q as StorefrontGuide, r as StorefrontGuideItem, s as StorefrontImage, t as StorefrontListing, u as StorefrontListingSummary, v as StorefrontListingsQuery, w as StorefrontLocation, x as StorefrontQuote, y as StorefrontQuoteInput, z as StorefrontRatePlanQuote, A as StorefrontReview, D as StorefrontReviewsQuery, E as StorefrontSite, F as createStorefrontClient } from './client-CZWN4im4.cjs';
-export { S as StorefrontAvailability, a as StorefrontCalendar, b as StorefrontCalendarDay, c as StorefrontCalendarQuery, d as StorefrontStay, e as StorefrontUnavailableReason } from './availability-CnzmxuV3.cjs';
+export { B as BookingResult, C as CheckoutMountDescriptor, a as CheckoutSession, b as ConfirmCheckoutSessionInput, c as ConfirmCheckoutSessionRequest, d as ContentListQuery, e as CreateCheckoutSessionInput, f as CreateCheckoutSessionOptions, g as CreatedCheckoutSession, P as Page, R as RequestOptions, S as STOREFRONT_API_PATH, h as StorefrontBooking, i as StorefrontBuilding, j as StorefrontClient, k as StorefrontClientOptions, l as StorefrontContactInput, m as StorefrontContentItem, n as StorefrontContentModel, o as StorefrontContentRef, p as StorefrontGuestInput, q as StorefrontGuide, r as StorefrontGuideItem, s as StorefrontImage, t as StorefrontListing, u as StorefrontListingFacets, v as StorefrontListingSort, w as StorefrontListingSummary, x as StorefrontListingsQuery, y as StorefrontLocation, z as StorefrontQuote, A as StorefrontQuoteInput, D as StorefrontRatePlanQuote, E as StorefrontReview, F as StorefrontReviewsQuery, G as StorefrontSite, H as createStorefrontClient } from './client-CX8K7JNt.cjs';
+export { S as StorefrontAvailability, a as StorefrontBuildingAvailabilityQuery, b as StorefrontCalendar, c as StorefrontCalendarDay, d as StorefrontCalendarQuery, e as StorefrontStay, f as StorefrontUnavailableReason, g as StorefrontUnitAvailability, h as StorefrontUnitUnavailableReason } from './availability.d-Cla9GuGc.cjs';
 
 declare const attributionTouchSchema: z.ZodObject<{
     ts: z.ZodISODateTime;
@@ -20,8 +20,8 @@ declare const attributionTouchSchema: z.ZodObject<{
     msclkid: z.ZodNullable<z.ZodString>;
     paidClick: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
         google: "google";
-        microsoft: "microsoft";
         meta: "meta";
+        microsoft: "microsoft";
     }>>>;
 }, z.core.$strip>;
 type AttributionTouch = z.infer<typeof attributionTouchSchema>;
@@ -49,8 +49,8 @@ declare const storefrontAttributionInputSchema: z.ZodObject<{
         msclkid: z.ZodNullable<z.ZodString>;
         paidClick: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
             google: "google";
-            microsoft: "microsoft";
             meta: "meta";
+            microsoft: "microsoft";
         }>>>;
     }, z.core.$strip>>;
     last: z.ZodNullable<z.ZodObject<{
@@ -69,8 +69,8 @@ declare const storefrontAttributionInputSchema: z.ZodObject<{
         msclkid: z.ZodNullable<z.ZodString>;
         paidClick: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
             google: "google";
-            microsoft: "microsoft";
             meta: "meta";
+            microsoft: "microsoft";
         }>>>;
     }, z.core.$strip>>;
     ids: z.ZodObject<{
@@ -87,8 +87,8 @@ declare const storefrontAttributionInputSchema: z.ZodObject<{
             user: "user";
         }>;
         region: z.ZodEnum<{
-            restricted: "restricted";
             other: "other";
+            restricted: "restricted";
         }>;
         decidedAt: z.ZodNullable<z.ZodISODateTime>;
     }, z.core.$strip>;
@@ -102,10 +102,19 @@ declare const storefrontAttributionInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 type StorefrontAttributionInput = z.infer<typeof storefrontAttributionInputSchema>;
 
+/** Called once per malformed input `getAttribution` skipped; `where` names the cookie or element. */
 type AttributionReporter = (err: unknown, where: string) => void;
 interface AttributionOptions {
+    /** Default: `console.warn`. Malformed input never throws — it is reported and read as null. */
     report?: AttributionReporter;
 }
+/**
+ * What the checkout session carries: the `so_attr` first/last touch (read only under
+ * analytics consent), with this page's own touch from the edge as `last` when it is not direct, the
+ * GA / Meta browser ids, the visitor's A/B variant when the site runs a split, and the page's
+ * consent. The API validates every field again, recomputes
+ * the channels and keeps each id only under the consent that covers it. Null outside a browser.
+ */
 declare function getAttribution(opts?: AttributionOptions): StorefrontAttributionInput | null;
 
 declare const CDN_IMAGE_WIDTHS: readonly [320, 640, 1080, 1600];
@@ -122,9 +131,19 @@ interface ParsedPublishableKey {
     environment: 'live' | 'test';
     region: StorefrontRegion;
 }
+/**
+ * Reads the environment and region a publishable key encodes
+ * (`pk_{live|test}_{us|eu|apac}_<24 base62>`). Throws `StorefrontConfigError`, whose message
+ * never repeats the key, for anything else — loudest for a secret key.
+ */
 declare function parsePublishableKey(key: string): ParsedPublishableKey;
 
+/** This package's version, stamped from package.json at build time. */
 declare const SDK_VERSION: string;
+/**
+ * The Storefront API version this SDK speaks, sent as `X-SuiteOp-Api-Version`. Pinned per SDK
+ * release so an API evolution never changes an installed SDK's behaviour (README §Versioning).
+ */
 declare const STOREFRONT_API_VERSION = "2026-09-27";
 
 export { type AttributionIds, type AttributionOptions, type AttributionReporter, type AttributionTouch, CDN_IMAGE_WIDTHS as IMAGE_WIDTHS, type CdnImageWidth as ImageWidth, type ParsedPublishableKey, SDK_VERSION, STOREFRONT_API_VERSION, type StorefrontAttributionInput, StorefrontRegion, getAttribution, cdnImageProps as imageProps, cdnImageSrcSet as imageSrcSet, cdnImageUrl as imageUrl, parsePublishableKey };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { S as StorefrontRegion } from './errors-DoXdi1vS.js';
-export { A as AnalyticsOptions, a as AnalyticsReporter, P as PriceChangedError, R as RateLimitedError, b as STOREFRONT_ERROR_CODES, c as StorefrontAnalytics, d as StorefrontConfigError, e as StorefrontError, f as StorefrontErrorCode, g as StorefrontErrorInit, h as StorefrontNetworkError, i as StorefrontTimeoutError, T as TrackEvent, W as WrongRegionError, j as analyticsFor, k as createAnalytics, t as trackPurchasePixel } from './errors-DoXdi1vS.js';
+import { S as StorefrontRegion } from './errors-Oax7djdp.js';
+export { A as AnalyticsOptions, a as AnalyticsReporter, P as PriceChangedError, R as RateLimitedError, b as STOREFRONT_ERROR_CODES, c as StorefrontAnalytics, d as StorefrontConfigError, e as StorefrontError, f as StorefrontErrorCode, g as StorefrontErrorInit, h as StorefrontNetworkError, i as StorefrontTimeoutError, T as TrackEvent, W as WrongRegionError, j as analyticsFor, k as createAnalytics, t as trackPurchasePixel } from './errors-Oax7djdp.js';
 import { z } from 'zod';
-export { B as BookingResult, C as CheckoutMountDescriptor, a as CheckoutSession, b as ConfirmCheckoutSessionInput, c as ConfirmCheckoutSessionRequest, d as ContentListQuery, e as CreateCheckoutSessionInput, f as CreateCheckoutSessionOptions, g as CreatedCheckoutSession, P as Page, R as RequestOptions, S as STOREFRONT_API_PATH, h as StorefrontBooking, i as StorefrontBuilding, j as StorefrontClient, k as StorefrontClientOptions, l as StorefrontContactInput, m as StorefrontContentItem, n as StorefrontContentModel, o as StorefrontContentRef, p as StorefrontGuestInput, q as StorefrontGuide, r as StorefrontGuideItem, s as StorefrontImage, t as StorefrontListing, u as StorefrontListingSummary, v as StorefrontListingsQuery, w as StorefrontLocation, x as StorefrontQuote, y as StorefrontQuoteInput, z as StorefrontRatePlanQuote, A as StorefrontReview, D as StorefrontReviewsQuery, E as StorefrontSite, F as createStorefrontClient } from './client-oyYRhUv0.js';
-export { S as StorefrontAvailability, a as StorefrontCalendar, b as StorefrontCalendarDay, c as StorefrontCalendarQuery, d as StorefrontStay, e as StorefrontUnavailableReason } from './availability-CnzmxuV3.js';
+export { B as BookingResult, C as CheckoutMountDescriptor, a as CheckoutSession, b as ConfirmCheckoutSessionInput, c as ConfirmCheckoutSessionRequest, d as ContentListQuery, e as CreateCheckoutSessionInput, f as CreateCheckoutSessionOptions, g as CreatedCheckoutSession, P as Page, R as RequestOptions, S as STOREFRONT_API_PATH, h as StorefrontBooking, i as StorefrontBuilding, j as StorefrontClient, k as StorefrontClientOptions, l as StorefrontContactInput, m as StorefrontContentItem, n as StorefrontContentModel, o as StorefrontContentRef, p as StorefrontGuestInput, q as StorefrontGuide, r as StorefrontGuideItem, s as StorefrontImage, t as StorefrontListing, u as StorefrontListingFacets, v as StorefrontListingSort, w as StorefrontListingSummary, x as StorefrontListingsQuery, y as StorefrontLocation, z as StorefrontQuote, A as StorefrontQuoteInput, D as StorefrontRatePlanQuote, E as StorefrontReview, F as StorefrontReviewsQuery, G as StorefrontSite, H as createStorefrontClient } from './client-s-lEwqzc.js';
+export { S as StorefrontAvailability, a as StorefrontBuildingAvailabilityQuery, b as StorefrontCalendar, c as StorefrontCalendarDay, d as StorefrontCalendarQuery, e as StorefrontStay, f as StorefrontUnavailableReason, g as StorefrontUnitAvailability, h as StorefrontUnitUnavailableReason } from './availability.d-Cla9GuGc.js';
 
 declare const attributionTouchSchema: z.ZodObject<{
     ts: z.ZodISODateTime;
@@ -20,8 +20,8 @@ declare const attributionTouchSchema: z.ZodObject<{
     msclkid: z.ZodNullable<z.ZodString>;
     paidClick: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
         google: "google";
-        microsoft: "microsoft";
         meta: "meta";
+        microsoft: "microsoft";
     }>>>;
 }, z.core.$strip>;
 type AttributionTouch = z.infer<typeof attributionTouchSchema>;
@@ -49,8 +49,8 @@ declare const storefrontAttributionInputSchema: z.ZodObject<{
         msclkid: z.ZodNullable<z.ZodString>;
         paidClick: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
             google: "google";
-            microsoft: "microsoft";
             meta: "meta";
+            microsoft: "microsoft";
         }>>>;
     }, z.core.$strip>>;
     last: z.ZodNullable<z.ZodObject<{
@@ -69,8 +69,8 @@ declare const storefrontAttributionInputSchema: z.ZodObject<{
         msclkid: z.ZodNullable<z.ZodString>;
         paidClick: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
             google: "google";
-            microsoft: "microsoft";
             meta: "meta";
+            microsoft: "microsoft";
         }>>>;
     }, z.core.$strip>>;
     ids: z.ZodObject<{
@@ -87,8 +87,8 @@ declare const storefrontAttributionInputSchema: z.ZodObject<{
             user: "user";
         }>;
         region: z.ZodEnum<{
-            restricted: "restricted";
             other: "other";
+            restricted: "restricted";
         }>;
         decidedAt: z.ZodNullable<z.ZodISODateTime>;
     }, z.core.$strip>;
@@ -102,10 +102,19 @@ declare const storefrontAttributionInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 type StorefrontAttributionInput = z.infer<typeof storefrontAttributionInputSchema>;
 
+/** Called once per malformed input `getAttribution` skipped; `where` names the cookie or element. */
 type AttributionReporter = (err: unknown, where: string) => void;
 interface AttributionOptions {
+    /** Default: `console.warn`. Malformed input never throws — it is reported and read as null. */
     report?: AttributionReporter;
 }
+/**
+ * What the checkout session carries: the `so_attr` first/last touch (read only under
+ * analytics consent), with this page's own touch from the edge as `last` when it is not direct, the
+ * GA / Meta browser ids, the visitor's A/B variant when the site runs a split, and the page's
+ * consent. The API validates every field again, recomputes
+ * the channels and keeps each id only under the consent that covers it. Null outside a browser.
+ */
 declare function getAttribution(opts?: AttributionOptions): StorefrontAttributionInput | null;
 
 declare const CDN_IMAGE_WIDTHS: readonly [320, 640, 1080, 1600];
@@ -122,9 +131,19 @@ interface ParsedPublishableKey {
     environment: 'live' | 'test';
     region: StorefrontRegion;
 }
+/**
+ * Reads the environment and region a publishable key encodes
+ * (`pk_{live|test}_{us|eu|apac}_<24 base62>`). Throws `StorefrontConfigError`, whose message
+ * never repeats the key, for anything else — loudest for a secret key.
+ */
 declare function parsePublishableKey(key: string): ParsedPublishableKey;
 
+/** This package's version, stamped from package.json at build time. */
 declare const SDK_VERSION: string;
+/**
+ * The Storefront API version this SDK speaks, sent as `X-SuiteOp-Api-Version`. Pinned per SDK
+ * release so an API evolution never changes an installed SDK's behaviour (README §Versioning).
+ */
 declare const STOREFRONT_API_VERSION = "2026-09-27";
 
 export { type AttributionIds, type AttributionOptions, type AttributionReporter, type AttributionTouch, CDN_IMAGE_WIDTHS as IMAGE_WIDTHS, type CdnImageWidth as ImageWidth, type ParsedPublishableKey, SDK_VERSION, STOREFRONT_API_VERSION, type StorefrontAttributionInput, StorefrontRegion, getAttribution, cdnImageProps as imageProps, cdnImageSrcSet as imageSrcSet, cdnImageUrl as imageUrl, parsePublishableKey };

package/dist/index.js

@@ -1,6 +1,6 @@
-export { SDK_VERSION, STOREFRONT_API_PATH, STOREFRONT_API_VERSION, analyticsFor, createAnalytics, createStorefrontClient, getAttribution, parsePublishableKey, trackPurchasePixel } from './chunk-UWUKERLK.js';
+export { SDK_VERSION, STOREFRONT_API_PATH, STOREFRONT_API_VERSION, analyticsFor, createAnalytics, createStorefrontClient, getAttribution, parsePublishableKey, trackPurchasePixel } from './chunk-YIYGBTAM.js';
 export { CDN_IMAGE_WIDTHS as IMAGE_WIDTHS, cdnImageProps as imageProps, cdnImageSrcSet as imageSrcSet, cdnImageUrl as imageUrl } from './chunk-A43EXKPY.js';
-import './chunk-PYVUDQSQ.js';
-import './chunk-TRXDDUEL.js';
-export { PriceChangedError, RateLimitedError, STOREFRONT_ERROR_CODES, StorefrontConfigError, StorefrontError, StorefrontNetworkError, StorefrontTimeoutError, WrongRegionError } from './chunk-ZI2PG7LS.js';
-import './chunk-6NFURJXI.js';
+import './chunk-UQWQPTHO.js';
+import './chunk-XOCFEVP4.js';
+export { PriceChangedError, RateLimitedError, STOREFRONT_ERROR_CODES, StorefrontConfigError, StorefrontError, StorefrontNetworkError, StorefrontTimeoutError, WrongRegionError } from './chunk-W5K7IDYN.js';
+import './chunk-IBCBDAGY.js';

package/dist/react.cjs

@@ -1,15 +1,15 @@
 'use strict';
 
-var chunkCTHHMNLE_cjs = require('./chunk-CTHHMNLE.cjs');
-var chunkVV2UNVQ2_cjs = require('./chunk-VV2UNVQ2.cjs');
-require('./chunk-ZLAOY6IF.cjs');
-require('./chunk-E5CGGMCO.cjs');
-var chunkUSOISC2R_cjs = require('./chunk-USOISC2R.cjs');
-require('./chunk-LVFRVNT3.cjs');
+var chunk3NE27PHL_cjs = require('./chunk-3NE27PHL.cjs');
+var chunkUMCI4YBN_cjs = require('./chunk-UMCI4YBN.cjs');
+require('./chunk-JF245QUY.cjs');
+require('./chunk-QBHOJGZI.cjs');
+var chunkJ5FZ4WDQ_cjs = require('./chunk-J5FZ4WDQ.cjs');
+require('./chunk-EHQFWSP6.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
-var SuiteOpContext=react.createContext(null);var ASTRO_PAGE_LOAD="astro:page-load";function SuiteOpProvider({client,children}){const value=react.useMemo(()=>({client,requests:new Map,analytics:chunkCTHHMNLE_cjs.analyticsFor(client.publishableKey)}),[client]);const{analytics}=value;react.useEffect(()=>{const onPageLoad=()=>analytics.pageView();onPageLoad();document.addEventListener(ASTRO_PAGE_LOAD,onPageLoad);return ()=>document.removeEventListener(ASTRO_PAGE_LOAD,onPageLoad)},[analytics]);return jsxRuntime.jsx(SuiteOpContext.Provider,{value,children})}function useTrack(){const{analytics}=useSuiteOpContext("useTrack");return analytics.track}function useSuiteOpContext(hookName){const value=react.useContext(SuiteOpContext);if(!value)throw new chunkUSOISC2R_cjs.StorefrontConfigError(`${hookName} must be used inside <SuiteOpProvider>`);return value}function useStorefrontClient(){return useSuiteOpContext("useStorefrontClient").client}var SHARED_TTL_MS=3e4;function toStorefrontError(err){if(err instanceof chunkUSOISC2R_cjs.StorefrontError)return err;return new chunkUSOISC2R_cjs.StorefrontError({status:0,code:"internal_error",message:err instanceof Error?err.message:"Unexpected error",cause:err})}function acquire(requests,key,run){const now=Date.now();for(const[k,entry2]of requests){if(entry2.refs===0&&entry2.settledAt!==null&&now-entry2.settledAt>=SHARED_TTL_MS){requests.delete(k);}}const cached=requests.get(key);if(cached&&(cached.settledAt===null||now-cached.settledAt<SHARED_TTL_MS)){cached.refs+=1;return cached}const controller=new AbortController;const entry={promise:Promise.resolve(),controller,refs:1,settledAt:null};entry.promise=run({signal:controller.signal}).then(data=>{entry.settledAt=Date.now();return data},err=>{if(requests.get(key)===entry)requests.delete(key);throw err});requests.set(key,entry);return entry}function release(requests,key,entry){entry.refs-=1;queueMicrotask(()=>{if(entry.refs>0||entry.settledAt!==null)return;entry.controller.abort();if(requests.get(key)===entry)requests.delete(key);});}function useSharedRead(hookName,key,run){const{requests}=useSuiteOpContext(hookName);const[current,setCurrent]=react.useState(null);const runRef=react.useRef(run);runRef.current=run;react.useEffect(()=>{if(key===null)return;let active=true;const entry=acquire(requests,key,opts=>runRef.current(opts));entry.promise.then(data=>{if(active)setCurrent({key,state:{status:"success",data}});},err=>{if(active&&!entry.controller.signal.aborted){setCurrent({key,state:{status:"error",error:toStorefrontError(err)}});}});return ()=>{active=false;release(requests,key,entry);}},[requests,key]);if(key===null)return {status:"idle"};return current?.key===key?current.state:{status:"loading"}}function useListing(id){const{client}=useSuiteOpContext("useListing");return useSharedRead("useListing",id===null?null:`listing:${id}`,opts=>client.listings.get(id,opts))}function useAvailability(listingId,stay){const{client}=useSuiteOpContext("useAvailability");const key=listingId===null||stay===null?null:`availability:${JSON.stringify([listingId,stay.checkIn,stay.checkOut,stay.guests])}`;return useSharedRead("useAvailability",key,opts=>client.availability.get(listingId,stay,opts))}function useMutationState(){const[state,setState]=react.useState({status:"idle"});const seq=react.useRef(0);const track=react.useCallback(async(work,onError)=>{const mine=++seq.current;setState({status:"loading"});try{const data=await work();if(mine===seq.current)setState({status:"success",data});return data}catch(err){if(mine===seq.current){onError?.(err);setState({status:"error",error:toStorefrontError(err)});}throw err}},[]);return {state,track}}function useQuote(){const{client}=useSuiteOpContext("useQuote");const{state,track}=useMutationState();const quote=react.useCallback(input=>track(()=>client.quotes.create(input)),[client,track]);return {quote,state}}function useCheckoutSession(){const{client}=useSuiteOpContext("useCheckoutSession");const{state,track}=useMutationState();const[priceChanged,setPriceChanged]=react.useState(null);const create=react.useCallback((input,opts)=>{setPriceChanged(null);return track(()=>client.checkoutSessions.create(input,opts),err=>{if(err instanceof chunkUSOISC2R_cjs.PriceChangedError)setPriceChanged(err.quote);})},[client,track]);return {create,session:state,priceChanged}}var EVENTS={"suiteop-checkout:ready":h=>h.onReady?.(),"suiteop-checkout:confirmed":(h,detail)=>h.onComplete(detail),"suiteop-checkout:pending":(h,detail)=>h.onPending?.(detail),"suiteop-checkout:error":(h,detail)=>{const error=detail;if(error.code==="price_changed"&&h.onPriceChanged)h.onPriceChanged();else h.onError?.(error);}};function SuiteOpCheckout(props){const client=useStorefrontClient();const ref=react.useRef(null);const handlers=react.useRef(props);handlers.current=props;react.useEffect(()=>{let active=true;chunkVV2UNVQ2_cjs.loadCheckout({origin:props.checkoutOrigin}).catch(err=>{if(!active)return;const code=err instanceof chunkUSOISC2R_cjs.StorefrontError?err.code:"checkout_unavailable";handlers.current.onError?.({code,requiresNewSession:false});});return ()=>{active=false;}},[props.checkoutOrigin]);react.useEffect(()=>{const element=ref.current;if(!element)return;const listeners=Object.entries(EVENTS).map(([type,handle])=>{const listener=event=>handle(handlers.current,event.detail);element.addEventListener(type,listener);return [type,listener]});return ()=>{for(const[type,listener]of listeners)element.removeEventListener(type,listener);}},[]);const apiBase=client.baseUrl.endsWith(chunkCTHHMNLE_cjs.STOREFRONT_API_PATH)?client.baseUrl.slice(0,-chunkCTHHMNLE_cjs.STOREFRONT_API_PATH.length):client.baseUrl;return react.createElement("suiteop-checkout",{ref,class:props.className,"session-id":props.checkoutSessionId,"quote-ref":props.quoteRef,"idempotency-key":props.idempotencyKey,"api-base":apiBase,"publishable-key":client.publishableKey,locale:props.locale})}
+var SuiteOpContext=react.createContext(null);var ASTRO_PAGE_LOAD="astro:page-load";function SuiteOpProvider({client,children}){const value=react.useMemo(()=>({client,requests:new Map,analytics:chunk3NE27PHL_cjs.analyticsFor(client.publishableKey)}),[client]);const{analytics}=value;react.useEffect(()=>{const onPageLoad=()=>analytics.pageView();onPageLoad();document.addEventListener(ASTRO_PAGE_LOAD,onPageLoad);return ()=>document.removeEventListener(ASTRO_PAGE_LOAD,onPageLoad)},[analytics]);return jsxRuntime.jsx(SuiteOpContext.Provider,{value,children})}function useTrack(){const{analytics}=useSuiteOpContext("useTrack");return analytics.track}function useSuiteOpContext(hookName){const value=react.useContext(SuiteOpContext);if(!value)throw new chunkJ5FZ4WDQ_cjs.StorefrontConfigError(`${hookName} must be used inside <SuiteOpProvider>`);return value}function useStorefrontClient(){return useSuiteOpContext("useStorefrontClient").client}var SHARED_TTL_MS=3e4;function toStorefrontError(err){if(err instanceof chunkJ5FZ4WDQ_cjs.StorefrontError)return err;return new chunkJ5FZ4WDQ_cjs.StorefrontError({status:0,code:"internal_error",message:err instanceof Error?err.message:"Unexpected error",cause:err})}function acquire(requests,key,run){const now=Date.now();for(const[k,entry2]of requests){if(entry2.refs===0&&entry2.settledAt!==null&&now-entry2.settledAt>=SHARED_TTL_MS){requests.delete(k);}}const cached=requests.get(key);if(cached&&(cached.settledAt===null||now-cached.settledAt<SHARED_TTL_MS)){cached.refs+=1;return cached}const controller=new AbortController;const entry={promise:Promise.resolve(),controller,refs:1,settledAt:null};entry.promise=run({signal:controller.signal}).then(data=>{entry.settledAt=Date.now();return data},err=>{if(requests.get(key)===entry)requests.delete(key);throw err});requests.set(key,entry);return entry}function release(requests,key,entry){entry.refs-=1;queueMicrotask(()=>{if(entry.refs>0||entry.settledAt!==null)return;entry.controller.abort();if(requests.get(key)===entry)requests.delete(key);});}function useSharedRead(hookName,key,run){const{requests}=useSuiteOpContext(hookName);const[current,setCurrent]=react.useState(null);const runRef=react.useRef(run);runRef.current=run;react.useEffect(()=>{if(key===null)return;let active=true;const entry=acquire(requests,key,opts=>runRef.current(opts));entry.promise.then(data=>{if(active)setCurrent({key,state:{status:"success",data}});},err=>{if(active&&!entry.controller.signal.aborted){setCurrent({key,state:{status:"error",error:toStorefrontError(err)}});}});return ()=>{active=false;release(requests,key,entry);}},[requests,key]);if(key===null)return {status:"idle"};return current?.key===key?current.state:{status:"loading"}}function useListing(id){const{client}=useSuiteOpContext("useListing");return useSharedRead("useListing",id===null?null:`listing:${id}`,opts=>client.listings.get(id,opts))}function useAvailability(listingId,stay){const{client}=useSuiteOpContext("useAvailability");const key=listingId===null||stay===null?null:`availability:${JSON.stringify([listingId,stay.checkIn,stay.checkOut,stay.guests])}`;return useSharedRead("useAvailability",key,opts=>client.availability.get(listingId,stay,opts))}function useMutationState(){const[state,setState]=react.useState({status:"idle"});const seq=react.useRef(0);const track=react.useCallback(async(work,onError)=>{const mine=++seq.current;setState({status:"loading"});try{const data=await work();if(mine===seq.current)setState({status:"success",data});return data}catch(err){if(mine===seq.current){onError?.(err);setState({status:"error",error:toStorefrontError(err)});}throw err}},[]);return {state,track}}function useQuote(){const{client}=useSuiteOpContext("useQuote");const{state,track}=useMutationState();const quote=react.useCallback(input=>track(()=>client.quotes.create(input)),[client,track]);return {quote,state}}function useCheckoutSession(){const{client}=useSuiteOpContext("useCheckoutSession");const{state,track}=useMutationState();const[priceChanged,setPriceChanged]=react.useState(null);const create=react.useCallback((input,opts)=>{setPriceChanged(null);return track(()=>client.checkoutSessions.create(input,opts),err=>{if(err instanceof chunkJ5FZ4WDQ_cjs.PriceChangedError)setPriceChanged(err.quote);})},[client,track]);return {create,session:state,priceChanged}}var EVENTS={"suiteop-checkout:ready":h=>h.onReady?.(),"suiteop-checkout:confirmed":(h,detail)=>h.onComplete(detail),"suiteop-checkout:pending":(h,detail)=>h.onPending?.(detail),"suiteop-checkout:error":(h,detail)=>{const error=detail;if(error.code==="price_changed"&&h.onPriceChanged)h.onPriceChanged();else h.onError?.(error);}};function SuiteOpCheckout(props){const client=useStorefrontClient();const ref=react.useRef(null);const handlers=react.useRef(props);handlers.current=props;react.useEffect(()=>{let active=true;chunkUMCI4YBN_cjs.loadCheckout({origin:props.checkoutOrigin}).catch(err=>{if(!active)return;const code=err instanceof chunkJ5FZ4WDQ_cjs.StorefrontError?err.code:"checkout_unavailable";handlers.current.onError?.({code,requiresNewSession:false});});return ()=>{active=false;}},[props.checkoutOrigin]);react.useEffect(()=>{const element=ref.current;if(!element)return;const listeners=Object.entries(EVENTS).map(([type,handle])=>{const listener=event=>handle(handlers.current,event.detail);element.addEventListener(type,listener);return [type,listener]});return ()=>{for(const[type,listener]of listeners)element.removeEventListener(type,listener);}},[]);const apiBase=client.baseUrl.endsWith(chunk3NE27PHL_cjs.STOREFRONT_API_PATH)?client.baseUrl.slice(0,-chunk3NE27PHL_cjs.STOREFRONT_API_PATH.length):client.baseUrl;return react.createElement("suiteop-checkout",{ref,class:props.className,"session-id":props.checkoutSessionId,"quote-ref":props.quoteRef,"idempotency-key":props.idempotencyKey,"api-base":apiBase,"publishable-key":client.publishableKey,locale:props.locale})}
 
 exports.SuiteOpCheckout = SuiteOpCheckout;
 exports.SuiteOpProvider = SuiteOpProvider;

package/dist/react.d.cts

@@ -1,6 +1,6 @@
-import { d as StorefrontStay, S as StorefrontAvailability } from './availability-CnzmxuV3.cjs';
-import { e as CreateCheckoutSessionInput, f as CreateCheckoutSessionOptions, g as CreatedCheckoutSession, x as StorefrontQuote, t as StorefrontListing, y as StorefrontQuoteInput, j as StorefrontClient, B as BookingResult } from './client-CZWN4im4.cjs';
-import { e as StorefrontError, T as TrackEvent } from './errors-CAW7nLHr.cjs';
+import { e as StorefrontStay, S as StorefrontAvailability } from './availability.d-Cla9GuGc.cjs';
+import { e as CreateCheckoutSessionInput, f as CreateCheckoutSessionOptions, g as CreatedCheckoutSession, z as StorefrontQuote, t as StorefrontListing, A as StorefrontQuoteInput, j as StorefrontClient, B as BookingResult } from './client-CX8K7JNt.cjs';
+import { e as StorefrontError, T as TrackEvent } from './errors-welPvrD6.cjs';
 import * as react from 'react';
 import { ReactNode, JSX } from 'react';
 import 'zod';
@@ -23,8 +23,10 @@ declare function useQuote(): {
     state: AsyncState<StorefrontQuote>;
 };
 declare function useCheckoutSession(): {
+    /** The client reuses one Idempotency-Key per quoteRef + rate plan, so a double click opens one session. */
     create(input: CreateCheckoutSessionInput, opts?: CreateCheckoutSessionOptions): Promise<CreatedCheckoutSession>;
     session: AsyncState<CreatedCheckoutSession>;
+    /** The fresh quote when the last create was refused with `price_changed`; show it, then re-create. */
     priceChanged: StorefrontQuote | null;
 };
 
@@ -32,7 +34,16 @@ interface SuiteOpProviderProps {
     client: StorefrontClient;
     children: ReactNode;
 }
+/**
+ * Provides the Storefront client to the hooks below it, and storefront analytics: a
+ * `page_view` on mount and on every Astro view-transition navigation to a new URL. JSON-LD
+ * arrives in a later minor.
+ */
 declare function SuiteOpProvider({ client, children }: SuiteOpProviderProps): react.JSX.Element;
+/**
+ * Track a storefront event (`view_item`, `begin_checkout`, `generate_lead` …); the SDK fills the
+ * event id, time, path and referrer. `purchase` does not type-check: the server records it.
+ */
 declare function useTrack(): (event: TrackEvent) => void;
 declare function useStorefrontClient(): StorefrontClient;
 
@@ -41,18 +52,28 @@ interface SuiteOpCheckoutError {
     requiresNewSession: boolean;
 }
 interface SuiteOpCheckoutProps {
+    /** The three values the session was created with — the element replays the create to recover the mount. */
     checkoutSessionId: string;
     quoteRef: string;
     idempotencyKey: string;
     locale?: string;
+    /** The storefront host serving the checkout bundle. Default: the page's own origin. */
     checkoutOrigin?: string;
     onReady?(): void;
     onComplete(result: BookingResult): void;
     onPending?(result: BookingResult): void;
+    /**
+     * `price_changed`: re-quote and create a new session. Without this handler it reaches `onError`.
+     */
     onPriceChanged?(): void;
     onError?(error: SuiteOpCheckoutError): void;
     className?: string;
 }
+/**
+ * The SuiteOp checkout (card entry + confirmation) for one checkout session. Loads the bundle on
+ * mount and renders `<suiteop-checkout>` with the `<SuiteOpProvider>` client's key and API origin.
+ * Card data only ever touches the bundle's provider elements.
+ */
 declare function SuiteOpCheckout(props: SuiteOpCheckoutProps): JSX.Element;
 
 export { type AsyncState, SuiteOpCheckout, type SuiteOpCheckoutError, type SuiteOpCheckoutProps, SuiteOpProvider, type SuiteOpProviderProps, useAvailability, useCheckoutSession, useListing, useQuote, useStorefrontClient, useTrack };