brainerce 1.50.0 → 1.52.0

package/dist/index.d.mts

@@ -1522,6 +1522,30 @@ interface Order {
     shippedAt?: string | null;
     /** ISO-8601 timestamp when the order was delivered. */
     deliveredAt?: string | null;
+    /**
+     * The live carrier service the shopper chose and was charged for at
+     * checkout. Admin reads only (`getOrder` / `getOrders`); the buyer-facing
+     * order endpoints never return it.
+     *
+     * `null` when no live carrier rate was sold — flat-rate or zone shipping,
+     * pickup, or an imported order. Use it to re-find the service the shopper
+     * paid for in a fresh quote from {@link BrainerceClient.getOrderShippingRates}
+     * before buying a label: match on `carrier` + `service`, case- and
+     * whitespace-insensitively. The rate id itself is not carried, because it
+     * names a shipment the carrier created at quote time and does not survive a
+     * re-quote.
+     */
+    shippingSelection?: {
+        /** Carrier code as the carrier reported it, e.g. `"USPS"`. */
+        carrier: string | null;
+        /** Service code as the carrier reported it, e.g. `"Priority"`. */
+        service: string | null;
+        /** The label the shopper actually saw, e.g. `"USPS Priority Mail"`. */
+        methodName: string | null;
+        /** Shipping charged at checkout, in the order's `currency`. `"0"` when a
+         *  free-shipping threshold zeroed it — the shopper still chose the service. */
+        amount: string | null;
+    } | null;
     /** Status timeline entries in chronological order. */
     statusHistory?: OrderStatusChange[] | null;
 }
@@ -2278,6 +2302,13 @@ interface Cart {
     currency: string;
     /** Optional notes on the cart */
     notes?: string | null;
+    /**
+     * GA4 gtag.js stitch ids, if the storefront forwarded them (via
+     * `loadGoogleAnalytics()` or manually). Used server-side to join a
+     * server-sent purchase conversion to this browser's GA4 session.
+     */
+    analyticsClientId?: string | null;
+    analyticsSessionId?: string | null;
     /**
      * Cart subtotal as a string (e.g., "59.98").
      * Use parseFloat() for calculations.
@@ -2327,12 +2358,33 @@ interface Cart {
      */
     reservation?: ReservationInfo;
 }
+interface CreateCartOptions {
+    /** Existing session token to re-attach to (rare — usually omit and let the server mint one). */
+    sessionToken?: string;
+    /** Customer id to associate the cart with (admin / server-to-server callers only). */
+    customerId?: string;
+    /**
+     * GA4 gtag.js stitch ids. Auto-attached by the SDK when
+     * `loadGoogleAnalytics()` has resolved them; pass explicitly to override.
+     */
+    analyticsClientId?: string;
+    analyticsSessionId?: string;
+}
 interface AddToCartDto {
     productId: string;
     variantId?: string;
     quantity: number;
     notes?: string;
     metadata?: Record<string, unknown>;
+    /**
+     * GA4 gtag.js `client_id` (from `gtag('get', measurementId, 'client_id', cb)`).
+     * Auto-attached by the SDK when `loadGoogleAnalytics()` has resolved one;
+     * pass explicitly to override. Omit if unavailable — never send a
+     * synthesized id.
+     */
+    analyticsClientId?: string;
+    /** GA4 gtag.js `session_id`, forwarded alongside `analyticsClientId`. */
+    analyticsSessionId?: string;
     /**
      * Modifier-group selections for restaurant / customizable products
      * (e.g., toppings, sauces, sides). The server validates against effective
@@ -2785,6 +2837,29 @@ interface ShippingRate {
     carrier?: string;
     /** Service level (e.g., "ground", "express") - only for carrier rates */
     service?: string;
+    /**
+     * Where this rate sits among the live carrier options.
+     *
+     * **Render this and `estimatedDays`, not `name`.** A shopper chooses between
+     * how fast and how much; `name` carries the carrier's own service identifier
+     * — `USPS ExpressMailInternational`, `USAExportPBA USAExportStandard` — which
+     * tells them nothing. Label the tiers in your own words and locale:
+     *
+     * ```typescript
+     * const label = {
+     *   cheapest: 'Standard delivery',
+     *   balanced: 'Express delivery',
+     *   fastest:  'Priority delivery',
+     * }[rate.speedTier ?? 'cheapest'];
+     * ```
+     *
+     * Derived per quote rather than mapped from service names, so a carrier you
+     * have never heard of tiers correctly with no lookup table.
+     *
+     * Absent on manual zone rates — the merchant named those deliberately, and
+     * you should show their name as written.
+     */
+    speedTier?: 'cheapest' | 'balanced' | 'fastest';
 }
 /**
  * Pickup location details for local pickup orders.
@@ -3054,6 +3129,12 @@ interface SetCheckoutCustomerDto {
      * Send an empty string to clear a previously-set note.
      */
     notes?: string;
+    /**
+     * GA4 gtag.js stitch ids. Auto-attached by the SDK when
+     * `loadGoogleAnalytics()` has resolved them; pass explicitly to override.
+     */
+    analyticsClientId?: string;
+    analyticsSessionId?: string;
 }
 /**
  * Shipping address with customer email (required for checkout).
@@ -3081,6 +3162,45 @@ interface SetShippingAddressDto {
      * the dashboard and included in the confirmation email. Max 2000 chars.
      */
     notes?: string;
+    /**
+     * GA4 gtag.js stitch ids. Auto-attached by the SDK when
+     * `loadGoogleAnalytics()` has resolved them; pass explicitly to override.
+     */
+    analyticsClientId?: string;
+    analyticsSessionId?: string;
+    /**
+     * The `placeId` of the autocomplete suggestion the shopper picked (from
+     * `addressAutocomplete()`). Send it whenever the address came from the
+     * autocomplete.
+     *
+     * The server re-resolves it to exact rooftop coordinates and matches
+     * polygon ("draw on map") shipping zones against those. Without it, zone
+     * matching falls back to geocoding the address lines, which is materially
+     * less accurate — a same-named street in a neighbouring city can outrank
+     * the right one, putting the shopper in the wrong zone or in none at all.
+     * If your store uses polygon zones, passing this is the difference between
+     * reliable and roughly-right delivery pricing.
+     *
+     * **Clear it if the shopper edits any address field after picking.** The
+     * coordinates belong to the suggestion, not to whatever is in the inputs
+     * now — a stale `placeId` would match zones against the address they
+     * originally picked. Dropping it falls back to geocoding the edited text,
+     * which is the correct behaviour once the two no longer agree.
+     *
+     * Note there is deliberately no `lat`/`lng` field: zone matching decides
+     * which shipping rate is offered and charged, so coordinates are never
+     * accepted from the client.
+     */
+    placeId?: string;
+    /**
+     * The same `sessionToken` you passed to `addressAutocomplete()` for the
+     * calls that produced `placeId`. Optional — the resolved place is cached
+     * server-side for 24h by `placeId`, so the normal
+     * autocomplete → `getAddressDetails()` → here flow hits that cache. Pass it
+     * when you have it so a cache miss still bills within the original
+     * autocomplete session instead of opening a new one.
+     */
+    placeSessionToken?: string;
 }
 /**
  * Billing address (email not required - already set in shipping address)
@@ -3335,9 +3455,29 @@ interface UpdateOrderShippingDto {
     phone?: string;
 }
 interface FulfillOrderDto {
+    /** Carrier tracking number. Send an empty string to clear a wrong one. */
     trackingNumber?: string;
+    /** Carrier name/code shown to the shopper (`ups`, `Israel Post`, …). */
     trackingCompany?: string;
+    /**
+     * Absolute `http(s)` link to the carrier's tracking page. The shipped email
+     * only renders its "Track Your Order" button when this is present — a bare
+     * tracking number gives the shopper nothing to click. Any other scheme is
+     * rejected.
+     */
+    trackingUrl?: string;
+    /**
+     * Email the shopper. Defaults to `true` on a first fulfilment and to
+     * `false` when correcting the tracking of an order that already shipped.
+     */
     notifyCustomer?: boolean;
+    /**
+     * Ship an order whose payment was never confirmed — COD, bank transfer,
+     * net terms, or an order created through the API. Without it those orders
+     * are refused, and there is no other way to mark them paid. `CANCELLED`,
+     * `REFUNDED` and voided orders are still refused regardless.
+     */
+    allowUnpaidFulfillment?: boolean;
 }
 interface CompleteDraftDto {
     paymentPending?: boolean;
@@ -4660,6 +4800,38 @@ interface PublicMetafieldDefinition {
     defaultValue?: string | null;
     position: number;
 }
+/**
+ * One facet value bucket with the number of DISTINCT active products carrying
+ * it. For MULTI_SELECT definitions the stored arrays are split — a product
+ * holding `["a","b"]` counts once for `a` and once for `b`. BOOLEAN buckets
+ * normalize to `'true'` / `'false'`. Declared `enumValues` are always present
+ * (including zero-count entries, so the UI can render disabled options);
+ * stray stored values outside `enumValues` are reported as-is.
+ */
+interface MetafieldFilterValue {
+    value: string;
+    count: number;
+}
+/**
+ * A filterable metafield definition plus per-value product counts — one entry
+ * per facet the storefront should render. Returned by
+ * {@link BrainerceClient.getMetafieldFilters}. `name` is localized per the
+ * request locale. Pair the `key` with
+ * `getProducts({ metafields: { [key]: [value] } })`.
+ */
+interface MetafieldFilter {
+    id: string;
+    key: string;
+    name: string;
+    type: MetafieldType;
+    /** Declared allowed values for SELECT / MULTI_SELECT fields (with optional swatch metadata). */
+    enumValues: CustomizationFieldOption[];
+    values: MetafieldFilterValue[];
+}
+/** Response of `GET /metafield-filters` (vibe-coded and storefront modes). */
+interface MetafieldFiltersResponse {
+    filters: MetafieldFilter[];
+}
 /**
  * A single selectable option for a SELECT or MULTI_SELECT customization field.
  * Legacy string-only `enumValues` arrays are automatically promoted to this shape.
@@ -6065,6 +6237,12 @@ interface BrainerceApiError {
     details?: unknown;
 }
 
+declare global {
+    interface Window {
+        dataLayer?: unknown[];
+        gtag?: (...args: unknown[]) => void;
+    }
+}
 /**
  * BCP-47 primary subtags whose script is written right-to-left. Inlined in the
  * SDK so storefronts don't take a runtime dependency on `@brainerce/types`.
@@ -6123,6 +6301,8 @@ declare class BrainerceClient {
      * so the recovered cart shows up with zero per-store code.
      */
     private _pendingRecoverCartId;
+    private _ga4MeasurementId;
+    private _ga4StitchPromise;
     /** localStorage key for session cart reference (sessionToken + cartId) */
     private readonly SESSION_CART_KEY;
     /**
@@ -6293,6 +6473,58 @@ declare class BrainerceClient {
      * omits credentials (cookieless), and never throws.
      */
     private sendAnalyticsBeacon;
+    /**
+     * Load GA4's `gtag.js` and start resolving the `client_id`/`session_id`
+     * "stitch" ids Google needs to join a later server-side purchase conversion
+     * to this browser's GA4 session (without them, a server-sent purchase event
+     * either gets rejected or creates a phantom user in GA4). Call this once,
+     * as early as possible (app entry / root layout).
+     *
+     * `createCart()`, `addToCart()`, `setCheckoutCustomer()`, and
+     * `setShippingAddress()` all auto-attach the resolved ids once available —
+     * an explicit `analyticsClientId`/`analyticsSessionId` you pass to any of
+     * those always wins over the auto-captured value. You only need to call
+     * this once; every subsequent cart/checkout call benefits automatically.
+     *
+     * Ids are resolved via `gtag('get', measurementId, 'client_id' | 'session_id', cb)`
+     * — Google's documented method — never by parsing the `_ga` cookie, which
+     * is undocumented and breaks silently across cookie-format changes and
+     * Consent Mode v2 states. If the shopper has denied analytics consent,
+     * gtag reports no client_id and the ids are simply omitted — never
+     * synthesized.
+     *
+     * No-op outside the browser (SSR-safe) and never throws — a blocked or
+     * slow gtag just means server-side conversions won't stitch; it never
+     * breaks the storefront or delays checkout by more than `options.timeoutMs`.
+     *
+     * @example
+     * ```typescript
+     * // Call once, e.g. in your root layout / app entry point
+     * client.loadGoogleAnalytics('G-XXXXXXX');
+     *
+     * // Every cart/checkout call from here on auto-forwards the stitch ids —
+     * // no other code changes needed.
+     * const cart = await client.createCart();
+     * await client.addToCart(cart.id, { productId: 'prod_abc', quantity: 1 });
+     * ```
+     */
+    loadGoogleAnalytics(measurementId: string, options?: {
+        timeoutMs?: number;
+    }): void;
+    /**
+     * Resolve GA4's `client_id`/`session_id` via `gtag('get', ...)`, bounded by
+     * `timeoutMs` so a slow/blocked gtag never hangs a cart/checkout call.
+     * Resolves to `{}` (never rejects) on timeout, missing gtag, or denied
+     * consent.
+     */
+    private resolveGa4StitchIds;
+    /**
+     * Merge the resolved GA4 stitch ids onto a request body — only for fields
+     * the caller didn't already set explicitly (explicit values always win).
+     * No-op (returns `dto` unchanged) if `loadGoogleAnalytics()` was never
+     * called, or if it hasn't resolved any ids by the time this is awaited.
+     */
+    private withAnalyticsStitchIds;
     /**
      * Get a list of products with pagination and filtering
      * Works in vibe-coded, storefront (public), and admin mode
@@ -6736,13 +6968,23 @@ declare class BrainerceClient {
     updateOrderShipping(orderId: string, data: UpdateOrderShippingDto): Promise<Order>;
     /**
      * Create a shipping label for an order via the installed App Store shipping app.
-     * Pass the rate ID returned from checkout rate shopping. Billing goes directly
-     * to the merchant's carrier account — Brainerce is not a billing intermediary.
+     * Pass the rate ID returned from rate shopping — treat it as opaque and never
+     * parse it. Billing goes directly to the merchant's carrier account; Brainerce
+     * is not a billing intermediary.
+     *
+     * `labelFormat` defaults to `PDF`. Use `ZPL` or `EPL` for warehouse thermal
+     * printers. If the carrier cannot produce the requested format it returns its
+     * closest match rather than failing the purchase — check the response.
+     *
+     * Once the label exists, tracking updates arrive automatically: the carrier's
+     * webhooks move the shipment through in-transit → delivered and complete the
+     * order. No polling required.
      *
      * @example
      * ```typescript
      * const label = await client.createShippingLabel('order_abc', {
      *   rateId: 'rate_8f123456789abcdef',
+     *   labelFormat: 'ZPL',
      * });
      * console.log('Label URL:', label.labelUrl);
      * console.log('Tracking:', label.trackingNumber);
@@ -6751,12 +6993,83 @@ declare class BrainerceClient {
     createShippingLabel(orderId: string, data: {
         rateId: string;
         parcel?: Record<string, string>;
+        labelFormat?: 'PDF' | 'PNG' | 'ZPL' | 'EPL';
+        /**
+         * Cross-border only. The declaration itself is built from the order's
+         * line items; this just says what the parcel is. Ignored domestically.
+         */
+        customsContentsType?: 'merchandise' | 'gift' | 'documents' | 'sample' | 'return';
     }): Promise<{
         shipmentId: string;
         labelUrl: string;
         trackingNumber: string;
         carrier: string;
+        labelFormat?: string;
     }>;
+    /**
+     * Live carrier rates for an order, from the merchant's installed shipping app.
+     *
+     * Call this immediately before {@link createShippingLabel} and pass the chosen
+     * `id` straight through — the id is opaque and must not be parsed. It is also
+     * short-lived: this call is what creates the shipment at the carrier, so a
+     * rate from an old call may no longer be purchasable.
+     *
+     * Returns `[]` when the store has no shipping app installed, or when the
+     * order has no usable shipping address.
+     *
+     * @example
+     * ```typescript
+     * const rates = await client.getOrderShippingRates('order_abc');
+     * const cheapest = rates[0];
+     * const label = await client.createShippingLabel('order_abc', { rateId: cheapest.id });
+     * ```
+     */
+    getOrderShippingRates(orderId: string): Promise<Array<{
+        id: string;
+        name: string;
+        description: string | null;
+        price: string;
+        currency: string;
+        estimatedDays: number | null;
+        carrier: string | null;
+        service: string | null;
+    }>>;
+    /**
+     * Shipments recorded for an order, each with its tracking history.
+     *
+     * History arrives on its own: the carrier's webhooks flow through the
+     * installed shipping app and append events as the parcel moves. Poll this for
+     * display if you need it; do not poll expecting to *drive* anything.
+     */
+    getOrderShipments(orderId: string): Promise<Array<{
+        id: string;
+        carrier: string;
+        service: string | null;
+        status: string;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        labelUrl: string | null;
+        labelFormat: string | null;
+        estimatedDeliveryDate: string | null;
+        actualDeliveryDate: string | null;
+        /** What the carrier charged the merchant, in `rateCurrency`. */
+        rate: string | null;
+        rateCurrency: string;
+        createdAt: string;
+        /** Newest first, capped at the 200 most recent. */
+        events: Array<{
+            status: string;
+            statusDetail: string | null;
+            message: string;
+            location: {
+                city?: string;
+                state?: string;
+                country?: string;
+                zip?: string;
+            } | null;
+            occurredAt: string;
+        }>;
+    }>>;
     /**
      * Cancel an order
      * Works for Shopify and WooCommerce orders that haven't been fulfilled
@@ -6769,16 +7082,31 @@ declare class BrainerceClient {
      */
     cancelOrder(orderId: string): Promise<Order>;
     /**
-     * Fulfill an order (mark as shipped)
-     * Works for Shopify and WooCommerce orders
+     * Fulfill an order (mark as shipped), or correct the tracking of an order
+     * that has already shipped.
+     *
+     * Pass `trackingUrl` alongside the number — the shipped email only renders
+     * its "Track Your Order" button when a URL is present.
+     *
+     * Calling this again on an order that is already `SHIPPED`/`FULFILLED` with
+     * tracking fields edits only those fields: the status does not move, the
+     * ship date is not rewritten, and no fulfilment event fires. That is the way
+     * to fix a mistyped tracking number.
      *
      * @example
      * ```typescript
-     * const order = await client.fulfillOrder('order_123', {
+     * // First fulfilment — emails the shopper by default.
+     * await client.fulfillOrder('order_123', {
      *   trackingNumber: '1Z999AA10123456784',
      *   trackingCompany: 'UPS',
+     *   trackingUrl: 'https://www.ups.com/track?tracknum=1Z999AA10123456784',
      *   notifyCustomer: true,
      * });
+     *
+     * // Correction — silent unless you opt back in.
+     * await client.fulfillOrder('order_123', {
+     *   trackingNumber: '1Z999AA10123456785',
+     * });
      * ```
      */
     fulfillOrder(orderId: string, data?: FulfillOrderDto): Promise<Order>;
@@ -7282,11 +7610,25 @@ declare class BrainerceClient {
      *
      * @param provider - OAuth provider ('GOOGLE', 'FACEBOOK', 'GITHUB')
      * @param options - Optional configuration
-     * @param options.redirectUrl - Full absolute URL to redirect to after OAuth completes (must include origin)
-     *
-     * @example
-     * ```typescript
-     * // Get authorization URL (redirectUrl MUST be absolute with origin)
+     * @param options.redirectUrl - Where to send the browser once OAuth finishes —
+     *   on success *and* on failure. Validated server-side against the sales
+     *   channel's trusted origins, so what is accepted depends on the mode:
+     *   - vibe-coded (`salesChannelId: 'vc_*'`): an absolute URL on the channel's
+     *     registered `domain` or one of its `allowedOrigins`; in TEST mode, any
+     *     `localhost`/`127.0.0.1` port. A relative path (`/auth/callback`) also
+     *     works — it is resolved against the channel's `domain` on the way back,
+     *     so the channel must have one registered.
+     *   - storefront (`storeId`): **social login cannot round-trip in this mode.**
+     *     No channel is bound to the request, so an absolute URL has no
+     *     trusted-origin list to match (400 at this call) and a relative path has
+     *     no origin to resolve against on the way back. Use a `salesChannelId`
+     *     connection for OAuth.
+     *   Anything invalid fails fast here, before the shopper ever reaches the
+     *   provider.
+     *
+     * @example
+     * ```typescript
+     * // Vibe-coded mode — absolute URL on the registered storefront domain
      * const { authorizationUrl } = await client.getOAuthAuthorizeUrl('GOOGLE', {
      *   redirectUrl: window.location.origin + '/auth/callback'
      * });
@@ -7303,7 +7645,17 @@ declare class BrainerceClient {
      *   client.setCustomerToken(result.token);
      *   // result.customer, result.isNewCustomer, result.redirectUrl, ...
      * } else if (params.get('oauth_error')) {
-     *   // Show error
+     *   // Failures land on this same page, on `redirectUrl` — never on the API
+     *   // host. `oauth_error` is a stable snake_case code (see OAuthErrorCode);
+     *   // `error_description` is English developer detail, not shopper copy.
+     *   const code = params.get('oauth_error') as OAuthErrorCode;
+     *   showMessage(
+     *     code === 'link_blocked_unverified_password_account'
+     *       ? t('auth.verifyEmailFirst')   // send them to email verification
+     *       : code === 'state_expired'
+     *         ? t('auth.sessionExpiredRetry')
+     *         : t('auth.signInFailed')
+     *   );
      * }
      * ```
      */
@@ -7709,6 +8061,9 @@ declare class BrainerceClient {
      * Create a new cart for a guest user
      * Returns a cart with a sessionToken that identifies this cart
      *
+     * If `loadGoogleAnalytics()` was called and has resolved a GA4 client/session
+     * id, it's auto-attached unless `options` already specifies one.
+     *
      * @example
      * ```typescript
      * const cart = await client.createCart();
@@ -7716,7 +8071,7 @@ declare class BrainerceClient {
      * // Store sessionToken in localStorage or cookie
      * ```
      */
-    createCart(): Promise<Cart>;
+    createCart(options?: CreateCartOptions): Promise<Cart>;
     /**
      * Get a cart by session token (for guest users)
      *
@@ -8479,6 +8834,12 @@ declare class BrainerceClient {
      * should include an optional "Order notes" textarea by default and send its
      * value here (or via `setCheckoutCustomer`). The note lands on the order.
      *
+     * **Pass `placeId` whenever the address came from `addressAutocomplete()`.**
+     * The server re-resolves it to exact coordinates and matches polygon
+     * ("draw on map") shipping zones against those instead of re-geocoding the
+     * address text — which is materially less accurate and can place the
+     * shopper in a neighbouring city's zone, or in none at all.
+     *
      * @example
      * ```typescript
      * const { checkout, rates } = await client.setShippingAddress('checkout_123', {
@@ -8491,6 +8852,8 @@ declare class BrainerceClient {
      *   postalCode: '10001',
      *   country: 'US',
      *   notes: 'Please leave the package at the door', // optional order notes
+     *   placeId: suggestion.placeId,          // from addressAutocomplete()
+     *   placeSessionToken: sessionToken,      // the same token used for it
      * });
      * console.log('Available rates:', rates);
      * ```
@@ -10144,6 +10507,29 @@ declare class BrainerceClient {
     getPublicMetafieldDefinitions(): Promise<{
         definitions: PublicMetafieldDefinition[];
     }>;
+    /**
+     * Get facet value counts for filterable metafield definitions — one entry
+     * per definition the merchant marked `filterable: true` (types SELECT /
+     * MULTI_SELECT / BOOLEAN), each with DISTINCT-product counts per value.
+     * Powers faceted navigation ("Color: red (12) / blue (3)") without one
+     * `getProducts` round trip per candidate value.
+     *
+     * Available in vibe-coded and storefront modes. On the vibe-coded surface
+     * only definitions published to your connection are returned, and counts
+     * reflect only products published to it.
+     *
+     * @example
+     * ```typescript
+     * const { filters } = await client.getMetafieldFilters();
+     * for (const f of filters) {
+     *   // f.key pairs with getProducts({ metafields: { [f.key]: [value] } })
+     *   console.log(f.name, f.values); // [{ value: 'red', count: 12 }, ...]
+     * }
+     * ```
+     */
+    getMetafieldFilters(params?: {
+        locale?: string;
+    }): Promise<MetafieldFiltersResponse>;
     /**
      * Get all metafield definitions for the store
      * Requires Admin mode (apiKey)
@@ -10651,7 +11037,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "1.48.0";
+declare const SDK_VERSION = "1.52.0";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -10814,6 +11200,53 @@ interface StoreLocalParts {
  * Falls back to UTC parts on an invalid IANA timezone string — never throws.
  */
 declare function resolveStoreLocalParts(instant: Date, timezone: string): StoreLocalParts;
+interface ParsedDateFieldValue {
+    /**
+     * The absolute instant the value denotes. For a DATE field this is UTC
+     * midnight of the authored day, matching what `isDateValueAllowed`'s DATE
+     * branch expects.
+     */
+    instant: Date;
+    /**
+     * The canonical form to persist: `"YYYY-MM-DD"` for DATE, an ISO-8601 UTC
+     * instant (`"…Z"`) for DATETIME. Storing this instead of the caller's raw
+     * string is what keeps a column from accumulating `"2026-08-06"`,
+     * `"2026-07-16 10:00"` and `"2026-08-13T13:00-14:00"` side by side.
+     */
+    normalized: string;
+}
+/**
+ * Discriminated by a STRING, not a boolean: `apps/backend` compiles with
+ * `strictNullChecks: false`, where TypeScript refuses to narrow a union on a
+ * `true`/`false` literal discriminant, so `if (!result.ok)` would leave every
+ * backend call site unable to reach `.reason`. Do not "simplify" this back to
+ * `ok: boolean`.
+ */
+type DateFieldParseResult = {
+    status: 'valid';
+    value: ParsedDateFieldValue;
+} | {
+    status: 'invalid';
+    reason: string;
+};
+/**
+ * Strict parse of a customer- or admin-submitted DATE/DATETIME field value.
+ *
+ * Replaces a bare `new Date(raw)`, which is far too permissive for a value that
+ * gets persisted: it accepts implementation-defined shapes, silently reads a
+ * trailing `-14:00` slot label as a UTC offset, and resolves an offsetless
+ * datetime in the *server's* timezone rather than the store's.
+ *
+ * Accepted:
+ * - DATE: `YYYY-MM-DD` only. A time-of-day would be meaningless and, worse,
+ *   could shift the authored calendar day, so a datetime is truncated to its
+ *   literal date part rather than round-tripped through a timezone.
+ * - DATETIME: `YYYY-MM-DDTHH:mm[:ss[.sss]]` with an optional `Z` or
+ *   `±HH:mm` offset (a space may replace the `T`). **Without an offset the
+ *   value is resolved in the store's timezone**, the only frame a store-scoped
+ *   field has. A date with no time at all means midnight, store-local.
+ */
+declare function parseDateFieldValue(raw: unknown, fieldType: 'DATE' | 'DATETIME', timezone: string): DateFieldParseResult;
 /** Day-level gate: minDate/maxDate/blockedWeekdays/blockedDates only (no time-of-day). */
 declare function isCalendarDateAllowed(dateYYYYMMDD: string, config: DateAvailabilityConstraints | null | undefined): boolean;
 /**
@@ -10833,6 +11266,19 @@ declare function isCalendarDateAllowed(dateYYYYMMDD: string, config: DateAvailab
  * ```
  */
 declare function computeAvailableSlots(config: DateAvailabilityConstraints | null | undefined, dateYYYYMMDD: string): string[];
+/**
+ * The open/close windows that apply on one calendar date — `[]` when the date
+ * is blocked outright or the weekday has no window (which, per
+ * `BusinessHoursWindow`'s contract, means closed all day).
+ *
+ * Exists because `computeAvailableSlots` returns `[]` in two very different
+ * situations: "nothing is bookable that day" and "this field isn't slot-based
+ * at all" (`slotDurationMinutes` unset). A storefront rendering a picker needs
+ * to tell those apart — non-empty here with empty slots means "bound a free
+ * time input by these windows", which is exactly what `isDateValueAllowed`
+ * enforces on the way back in.
+ */
+declare function getBusinessHoursForDate(config: DateAvailabilityConstraints | null | undefined, dateYYYYMMDD: string): BusinessHoursWindow[];
 /**
  * Full value validation for a candidate date/datetime a shopper is about to
  * submit — use this to disable a "Continue" button client-side before the
@@ -10989,4 +11435,4 @@ interface CategorySitemapOptions {
  */
 declare function getCategorySitemapEntries(client: BrainerceClient, opts: CategorySitemapOptions): Promise<SitemapEntry[]>;
 
-export { type AddToCartDto, type AddressDetailsResult, type AddressSuggestion, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type BusinessHoursWindow, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryDetail, type CategoryNode, type CategorySitemapOptions, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DateAvailabilityConstraints, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type JsonLdOptions, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type LoyaltyNextTierSummary, type LoyaltyReward, type LoyaltyStatus, type LoyaltyTierSummary, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type RedeemRewardResult, type ReferralInfo, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingSummaryEntry, type ShippingZone, type ShippingZoneQueryParams, type SitemapEntry, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, buildArticleJsonLd, buildBreadcrumbJsonLd, buildCollectionPageJsonLd, buildOrganizationJsonLd, buildProductJsonLd, buildWebsiteJsonLd, computeAvailableSlots, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseWebhookEvent, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };
+export { type AddToCartDto, type AddressDetailsResult, type AddressSuggestion, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type BusinessHoursWindow, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryDetail, type CategoryNode, type CategorySitemapOptions, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DateAvailabilityConstraints, type DateFieldParseResult, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type JsonLdOptions, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type LoyaltyNextTierSummary, type LoyaltyReward, type LoyaltyStatus, type LoyaltyTierSummary, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldFilter, type MetafieldFilterValue, type MetafieldFiltersResponse, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type ParsedDateFieldValue, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type RedeemRewardResult, type ReferralInfo, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingSummaryEntry, type ShippingZone, type ShippingZoneQueryParams, type SitemapEntry, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, buildArticleJsonLd, buildBreadcrumbJsonLd, buildCollectionPageJsonLd, buildOrganizationJsonLd, buildProductJsonLd, buildWebsiteJsonLd, computeAvailableSlots, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getBusinessHoursForDate, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseDateFieldValue, parseWebhookEvent, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };