brainerce 1.51.0 → 1.53.0

package/dist/index.d.ts

@@ -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,49 @@ 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 the server resolves the
+     * coordinates itself from this `placeId` and never accepts them from the
+     * client. You can still spread `getAddressDetails().address` in here — the
+     * SDK drops its `lat`/`lng`/`formattedAddress` before sending, because the
+     * endpoint rejects any unknown property with a `400` that would otherwise
+     * block checkout entirely.
+     */
+    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)
@@ -3168,11 +3292,44 @@ interface AddressDetailsResult {
          */
         region: string;
         postalCode: string;
+        /**
+         * ISO-3166-1 alpha-2, or **an empty string** — Google omits the country
+         * outright for places whose sovereignty it declines to attribute, which in
+         * practice includes ordinary residential addresses (verified live: Ramat
+         * Shlomo, Giv'at Ze'ev, Modi'in Ilit, Ma'ale Adumim all come back with no
+         * country). The API deliberately does not guess one.
+         *
+         * Treat it exactly like `region`: when it's empty, leave your country
+         * field for the shopper to confirm rather than submitting a blank
+         * `SetShippingAddressDto.country`. Everything else on the address
+         * (`line1`, `city`, `lat`/`lng`, `formattedAddress`) is still valid and
+         * should still be filled in.
+         *
+         * Note that `region` is necessarily empty too whenever this is — region
+         * codes are resolved *within* a country, so with no country there is no
+         * region list to match against. Prompt for both.
+         */
         country: string;
+        /**
+         * Resolved coordinates, **for your own use only** — a map pin, a distance
+         * readout. They are not part of any address payload: zone matching decides
+         * which shipping rate is offered and charged, so the server re-resolves
+         * them from `placeId` instead of trusting the client. Sending them is
+         * harmless (the SDK strips `lat`/`lng`/`formattedAddress` from
+         * `setShippingAddress()` / `setBillingAddress()` bodies), but pass
+         * `placeId` — that is what actually reaches zone matching.
+         */
         lat: number;
         lng: number;
         formattedAddress: string;
     };
+    /**
+     * Soft coverage hint, never a rejection. Note it can read `false` purely
+     * because `country` came back empty and the store's zones are country-listed
+     * — a polygon zone can still match this address, since the server matches it
+     * against the coordinates it resolves from `placeId`. Show a "we'll confirm
+     * by phone" banner; do not block the shopper.
+     */
     inZone: boolean;
 }
 interface CompleteCheckoutResponse {
@@ -3335,9 +3492,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;
@@ -6097,6 +6274,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`.
@@ -6155,6 +6338,16 @@ declare class BrainerceClient {
      * so the recovered cart shows up with zero per-store code.
      */
     private _pendingRecoverCartId;
+    private _ga4MeasurementId;
+    private _ga4StitchPromise;
+    /**
+     * Fields present on `getAddressDetails().address` that the address endpoints
+     * do NOT accept — stripped by `stripResolvedOnlyAddressFields()` so a
+     * `{ ...address }` spread doesn't 400 the whole checkout.
+     */
+    private static readonly RESOLVED_ONLY_ADDRESS_FIELDS;
+    /** One warning per client, not per keystroke-driven address submit. */
+    private _warnedResolvedOnlyAddressFields;
     /** localStorage key for session cart reference (sessionToken + cartId) */
     private readonly SESSION_CART_KEY;
     /**
@@ -6228,10 +6421,19 @@ declare class BrainerceClient {
      * Set the customer authentication token (obtained from login/register).
      * Required for accessing customer-specific data in storefront mode.
      *
+     * This is a plain setter — it authenticates subsequent requests and nothing
+     * else. In particular it does NOT attach the shopper's existing guest cart to
+     * their account. Pair every sign-in with {@link syncCartOnLogin}, or the cart
+     * stays anonymous and every feature keyed on buyer identity degrades quietly:
+     * "first order only" discounts keep applying to returning customers,
+     * per-customer usage caps stop being enforced at cart time, and abandoned-cart
+     * recovery can't identify who to email.
+     *
      * @example
      * ```typescript
      * const auth = await client.loginCustomer('user@example.com', 'password');
      * client.setCustomerToken(auth.token);
+     * await client.syncCartOnLogin(); // claim the guest cart for this account
      *
      * // Now can access customer data
      * const profile = await client.getMyProfile();
@@ -6325,6 +6527,76 @@ 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;
+    /**
+     * Drop the fields `getAddressDetails()` returns that no address endpoint
+     * accepts, so spreading its `address` straight into `setShippingAddress()`
+     * / `setBillingAddress()` works instead of failing the whole request.
+     *
+     * The address endpoints validate against a strict allow-list: ONE unknown
+     * property rejects the call with `400 "property lat should not exist"`, and
+     * the shopper cannot check out at all. `lat`/`lng`/`formattedAddress` are
+     * the only realistic way to hit that — they come out of this SDK's own
+     * resolved-address shape, so this SDK cleans up after itself rather than
+     * making every storefront remember to. Nothing else is stripped: a genuine
+     * typo still reaches the server and still fails loudly.
+     *
+     * Coordinates are dropped rather than forwarded because zone matching picks
+     * which shipping rate is offered and charged — the server resolves them
+     * itself from `placeId`, and never takes them from the caller.
+     */
+    private stripResolvedOnlyAddressFields;
     /**
      * Get a list of products with pagination and filtering
      * Works in vibe-coded, storefront (public), and admin mode
@@ -6768,13 +7040,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);
@@ -6783,12 +7065,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
@@ -6801,16 +7154,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>;
@@ -7314,11 +7682,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'
      * });
@@ -7333,9 +7715,25 @@ declare class BrainerceClient {
      * if (params.get('oauth_success') === 'true' && params.get('auth_code')) {
      *   const result = await client.exchangeOAuthCode(params.get('auth_code')!);
      *   client.setCustomerToken(result.token);
+     *   // REQUIRED: setCustomerToken only stores the JWT — it does NOT attach the
+     *   // guest cart to the account. Without this call the cart stays anonymous,
+     *   // and anything keyed on the buyer's identity misbehaves: "first order
+     *   // only" discounts re-apply to returning customers, per-customer usage
+     *   // caps go unenforced, and abandoned-cart recovery can't reach them.
+     *   await client.syncCartOnLogin();
      *   // 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')
+     *   );
      * }
      * ```
      */
@@ -7357,6 +7755,11 @@ declare class BrainerceClient {
      *
      * @param authCode - The single-use code from the `?auth_code=` URL param.
      *
+     * Always follow a successful exchange with `syncCartOnLogin()`. Storing the
+     * token does not claim the guest cart, and an unclaimed cart has no buyer
+     * identity — which silently breaks first-order discounts, per-customer usage
+     * caps, and abandoned-cart recovery for everyone who signs in with OAuth.
+     *
      * @example
      * ```typescript
      * const params = new URLSearchParams(window.location.search);
@@ -7365,6 +7768,7 @@ declare class BrainerceClient {
      *   const { token, customer, isNewCustomer, redirectUrl } =
      *     await client.exchangeOAuthCode(code);
      *   client.setCustomerToken(token);
+     *   await client.syncCartOnLogin(); // attach the guest cart to the account
      * }
      * ```
      */
@@ -7741,6 +8145,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();
@@ -7748,7 +8155,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)
      *
@@ -8511,6 +8918,17 @@ 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.
+     *
+     * Spreading `getAddressDetails().address` in here is safe: its `lat`, `lng`
+     * and `formattedAddress` are dropped before the request goes out (the
+     * endpoint rejects unknown properties outright, and coordinates are never
+     * taken from the client — the server resolves them from `placeId`).
+     *
      * @example
      * ```typescript
      * const { checkout, rates } = await client.setShippingAddress('checkout_123', {
@@ -8523,6 +8941,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);
      * ```
@@ -10706,7 +11126,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "1.51.0";
+declare const SDK_VERSION = "1.53.0";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -10869,6 +11289,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;
 /**
@@ -10888,6 +11355,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
@@ -11044,4 +11524,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 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 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 };