brainerce 1.59.0 → 1.63.0

package/dist/index.d.mts

@@ -216,6 +216,14 @@ interface StoreInfo {
     ordersWriteEnabled?: boolean;
     /** Whether guest checkout is tracked (sales-channel mode only) */
     guestCheckoutTracking?: boolean;
+    /**
+     * Whether the merchant has back-in-stock alerts switched on for this
+     * storefront (sales-channel mode only). When false, do not render the
+     * "email me when this is back" affordance at all — `stockAlerts.subscribe()`
+     * still answers `{ ok: true }` and records nothing, so a button left up looks
+     * like it worked and quietly does nothing.
+     */
+    stockAlertsEnabled?: boolean;
     /**
      * Whether new customer registrations require email verification.
      * If true, your site MUST implement an email verification flow:
@@ -224,6 +232,17 @@ interface StoreInfo {
      * 3. Call verifyEmail(code) with the code they received via email
      */
     requireEmailVerification?: boolean;
+    /**
+     * Whether the merchant requires a birthday at registration on this channel.
+     * When true, `registerCustomer()` is rejected with HTTP 400 unless the call
+     * carries both `birthMonth` and `birthDay`, so render the two fields on the
+     * signup form and validate them before you submit.
+     *
+     * Sales-channel mode only, because the flag lives on the sales channel: a
+     * `storeId`-mode storefront never receives it and its register route never
+     * enforces it. Absent (an older API build) means the same as false.
+     */
+    requireBirthday?: boolean;
     /** Upsell feature settings (storefront mode) */
     upsell?: UpsellSettings;
     /** Multi-language / i18n settings */
@@ -404,6 +423,14 @@ interface CustomerProfile {
     acceptsMarketing: boolean;
     /** Free-form segment set by the merchant (e.g. "wholesale", "vip") — use to gate custom storefront features. Admin-set only, never customer-editable. */
     role?: string;
+    /**
+     * Birthday month (1-12) the customer saved on their profile. Month and day
+     * only, never a year. Returned together with `birthDay` or not at all, so a
+     * form can test one field and trust the other.
+     */
+    birthMonth?: number;
+    /** Birthday day of the month (1-31). Returned together with `birthMonth` or not at all. */
+    birthDay?: number;
     addresses: CustomerAddress[];
     createdAt: string;
     updatedAt: string;
@@ -787,6 +814,30 @@ interface Product {
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * A customer-uploaded photo on a review, as shoppers see it.
+ * `width`/`height` are the intrinsic pixel size — set them on your `<img>` so the
+ * gallery reserves space instead of shifting layout as photos load.
+ */
+interface ProductReviewImage {
+    id: string;
+    url: string;
+    thumbnailUrl: string | null;
+    width: number | null;
+    height: number | null;
+    position: number;
+}
+/**
+ * Moderation view of a photo — adds the two states a shopper never sees.
+ * `approvedAt: null` means the photo is waiting on the merchant, which only ever
+ * happens on stores that opted into review-photo approval.
+ */
+interface ProductReviewImageAdmin extends ProductReviewImage {
+    assetKey: string;
+    approvedAt: string | null;
+    hiddenAt: string | null;
+    createdAt: string;
+}
 /**
  * Product review submitted by a customer.
  * Reviews publish immediately (no PENDING state). Merchants hide via the admin
@@ -802,13 +853,17 @@ interface ProductReview {
     /** Only present in admin responses; null on storefront responses. */
     hiddenAt?: string | null;
     createdAt: string;
+    /** Visible photos, in display order. Always an array; empty when there are none. */
+    images: ProductReviewImage[];
 }
 /** Admin-mode review with full PII. Returned by `client.adminReviews.*`. */
-interface ProductReviewAdmin extends ProductReview {
+interface ProductReviewAdmin extends Omit<ProductReview, 'images'> {
     customerId: string | null;
     authorEmail: string | null;
     orderId: string | null;
     updatedAt: string;
+    /** ALL photos, including pending and hidden — this is the moderation surface. */
+    images: ProductReviewImageAdmin[];
 }
 /**
  * Body for customer-authenticated submit / update.
@@ -817,6 +872,16 @@ interface ProductReviewAdmin extends ProductReview {
 interface WriteProductReviewInput {
     rating: number;
     body?: string;
+    /**
+     * Storage keys from `uploadReviewPhoto()`, in display order. Keys, not URLs —
+     * the server resolves each one against the store's own assets and rejects
+     * anything that is not a review photo.
+     *
+     * On update this REPLACES the photo set, so pass the keys you want to keep.
+     * OMITTING the field leaves the existing photos untouched; passing `[]` removes
+     * them all.
+     */
+    imageKeys?: string[];
 }
 /**
  * @deprecated Use `WriteProductReviewInput`. Customers no longer pass author info
@@ -826,6 +891,15 @@ interface SubmitProductReviewInput extends WriteProductReviewInput {
     authorName?: string;
     authorEmail?: string;
 }
+/** What `uploadReviewPhoto()` gives back. Pass `key` to the submit/update call. */
+interface ReviewPhotoUpload {
+    /** The value to put in `imageKeys`. */
+    key: string;
+    /** For rendering a local preview before submitting. Not what you send back. */
+    url: string;
+    width: number | null;
+    height: number | null;
+}
 /**
  * Returned by `client.getMyProductReview(productId)`. Tells the storefront which
  * UI to render: sign-in / not-eligible / submit / edit.
@@ -836,6 +910,24 @@ interface MyProductReview {
     reason: 'no_eligible_order' | 'reviews_disabled' | 'product_not_found' | null;
     /** The customer's existing review for this product, or null. */
     myReview: ProductReview | null;
+    /**
+     * The store's photo policy. Read this instead of hard-coding limits: render the
+     * picker only when `enabled`, cap selection at `maxPerReview`, reject oversized
+     * files client-side at `maxBytes`, and when `requiresApproval` is true tell the
+     * customer their photo waits for the merchant before it appears.
+     */
+    photos: {
+        enabled: boolean;
+        maxPerReview: number;
+        maxBytes: number;
+        requiresApproval: boolean;
+    };
+    /**
+     * The customer's OWN photos including any still pending, so you can show them
+     * their upload sitting in the queue rather than looking like it failed. Note
+     * `myReview.images` carries only the publicly visible subset.
+     */
+    myImages: ProductReviewImageAdmin[];
 }
 interface ProductImage {
     url: string;
@@ -940,6 +1032,18 @@ interface InventoryInfo {
      * false if trackingMode is DISABLED or if out of stock.
      */
     canPurchase: boolean;
+    /**
+     * Whether the merchant lets this item be ordered while out of stock.
+     * Present on `TRACKED` items only — the one mode where it means anything.
+     *
+     * Use it to decide where a back-in-stock alert belongs: an alert on a
+     * backorderable item tells someone to come back and do what they can already
+     * do, so `stockAlerts.subscribe()` silently discards those requests. The gate
+     * is `!canPurchase && trackingMode === 'TRACKED' && backorderMode === 'NONE'`.
+     *
+     * Absent on older backends — treat `undefined` as `'NONE'`.
+     */
+    backorderMode?: 'NONE' | 'ALLOW' | 'NOTIFY';
     /** Last inventory sync timestamp (admin mode only) */
     lastInventorySyncAt?: string | null;
 }
@@ -1725,7 +1829,14 @@ interface Order {
     notes?: string | null;
     /** Payment method used (e.g., "card", "paypal", "cash_on_delivery"). */
     paymentMethod?: string | null;
-    /** Financial status: "pending", "paid", "refunded", "partially_refunded", "voided". */
+    /**
+     * Financial status: "pending", "authorized", "partially_paid", "paid",
+     * "partially_refunded", "refunded", "voided".
+     *
+     * `"paid"` does not imply a payment provider was involved — a merchant can
+     * record an out-of-band payment (cash on delivery, bank transfer) and the
+     * order reads `"paid"` with no provider behind it.
+     */
     financialStatus?: string | null;
     /** Fulfillment status: "unfulfilled", "partial", "fulfilled". */
     fulfillmentStatus?: string | null;
@@ -2114,9 +2225,32 @@ interface Customer {
     hasAccount: boolean;
     emailVerified: boolean;
     acceptsMarketing: boolean;
+    /**
+     * Whether a marketing campaign can actually REACH this address — a different
+     * question from `acceptsMarketing`. Audience resolution drops a recipient on
+     * either the consent flag or a suppression row, and the suppression row wins:
+     * an address whose consent box was re-ticked in the dashboard still reads
+     * `'UNSUBSCRIBED'`, because only the recipient's own confirmed opt-in clears
+     * it. `'BLOCKED'` cannot be cleared at all. Only `'SUBSCRIBED'` is mailable.
+     *
+     * Returned by the single-customer read (`GET /api/v1/customers/{id}`) and by
+     * the customer list. Optional because it is computed, not stored: responses
+     * that never compute it (create, update, register) omit it rather than
+     * guessing, and an older API build omits it everywhere. Fall back to
+     * `acceptsMarketing` when it is absent.
+     */
+    marketingStatus?: 'SUBSCRIBED' | 'NOT_SUBSCRIBED' | 'UNSUBSCRIBED' | 'BOUNCED' | 'COMPLAINED' | 'BLOCKED';
     tags: string[];
     /** Free-form segment set by the merchant (e.g. "wholesale", "vip") — use to gate custom storefront features. Admin-set only, never customer-editable. */
     role?: string;
+    /**
+     * Birthday month (1-12) the customer saved. Month and day only, never a
+     * year. Returned together with `birthDay` or not at all, so a form can test
+     * one field and trust the other.
+     */
+    birthMonth?: number;
+    /** Birthday day of the month (1-31). Returned together with `birthMonth` or not at all. */
+    birthDay?: number;
     totalOrders: number;
     lastOrderAt?: string;
     metadata?: Record<string, unknown>;
@@ -2217,6 +2351,13 @@ interface CheckoutPrefillData {
         lastName?: string;
         phone?: string;
         emailVerified: boolean;
+        /**
+         * Birthday month (1-12). Month and day only, never a year. Returned
+         * together with `birthDay` or not at all.
+         */
+        birthMonth?: number;
+        /** Birthday day of the month (1-31). Returned together with `birthMonth` or not at all. */
+        birthDay?: number;
     };
     /** Customer's default address (if any) */
     defaultAddress: CustomerAddress | null;
@@ -2249,6 +2390,15 @@ interface CreateCustomerDto {
     tags?: string[];
     /** Free-form merchant-set segment (e.g. "wholesale", "vip"), max 50 chars. */
     role?: string;
+    /**
+     * Birthday month (1-12). Month and day only, never a year, so there is no
+     * age to store. Send `birthMonth` and `birthDay` together: one without the
+     * other is rejected with HTTP 400, and so is a day the month does not have
+     * (February has no 31st).
+     */
+    birthMonth?: number;
+    /** Birthday day of the month (1-31). Send it together with `birthMonth`. */
+    birthDay?: number;
     /**
      * Explicit FIRST-TOUCH channel (internal SalesChannel id or public `vc_*`).
      * Creating a customer through the API is not itself a channel sighting, so
@@ -2388,6 +2538,19 @@ interface RegisterCustomerDto {
     lastName?: string;
     phone?: string;
     acceptsMarketing?: boolean;
+    /**
+     * Birthday month (1-12). Month and day only, never a year, so there is no
+     * age to store. Send `birthMonth` and `birthDay` together: one without the
+     * other is rejected with HTTP 400, and so is a day the month does not have.
+     *
+     * Optional by default. A merchant can make the birthday mandatory at
+     * registration on a sales channel, which surfaces as `requireBirthday` on
+     * `getStoreInfo()`; on such a channel a register call that omits the two
+     * fields is rejected with HTTP 400.
+     */
+    birthMonth?: number;
+    /** Birthday day of the month (1-31). Send it together with `birthMonth`. */
+    birthDay?: number;
     /**
      * Loyalty referral share code (REF-XXXXXXXX) from a referrer's link.
      * Validated asynchronously after registration — an invalid code never fails
@@ -5124,6 +5287,25 @@ interface DateAvailabilityConstraints {
     minDate?: string;
     /** "YYYY-MM-DD", inclusive. */
     maxDate?: string;
+    /**
+     * Preparation time in minutes. The earliest bookable moment is
+     * `now + leadTimeMinutes`, re-resolved on every call. This is the thing
+     * `minDate` cannot express: an absolute date authored to mean "tomorrow"
+     * is wrong by the following morning and goes on being wrong.
+     */
+    leadTimeMinutes?: number;
+    /**
+     * Rolling ceiling in days, counted from today store-local. Stands to
+     * `leadTimeMinutes` as `maxDate` stands to `minDate`, without the rot.
+     * Both may be set at once; whichever ceiling falls earlier wins.
+     */
+    maxDaysAhead?: number;
+    /**
+     * Daily order deadline, store-local "HH:mm". At or past it, the earliest
+     * bookable date moves on by a further day. This is the rule that keeps new
+     * orders out of a day whose picking run has already been planned.
+     */
+    cutoffTime?: string;
     /** Subset of 0-6; any weekday(s) fully blocked regardless of date. */
     blockedWeekdays?: number[];
     /** Specific blocked calendar dates, e.g. holidays: ["2026-12-25"]. */
@@ -6234,6 +6416,72 @@ interface ContactFormSummary {
     name: string;
     isDefault: boolean;
 }
+interface SubscribeMarketingInput {
+    /** Address to subscribe. Lowercased and trimmed server-side. */
+    email: string;
+    /** Given name, when the form collects one — greets them in the confirmation email. */
+    firstName?: string;
+    /** Family name, when the form collects one. */
+    lastName?: string;
+    /**
+     * Storefront locale at submission time, e.g. `"he"`. Picks the language of
+     * the confirmation email. Falls back to the store language when omitted —
+     * pass it on a multi-language storefront or Hebrew shoppers get English.
+     */
+    locale?: string;
+    /** Where the signup came from — `"popup"`, `"footer"`, `"exit-intent"`. Free-form. */
+    source?: string;
+    /** Arbitrary provenance: referrer, UTM params, the page the popup fired on. */
+    sourceMetadata?: Record<string, unknown>;
+    /**
+     * Anti-bot honeypot. Render a hidden input and pass whatever it holds; a
+     * non-empty value rejects the request. Bots fill every text input.
+     */
+    honeypot?: string;
+}
+/**
+ * Deliberately uniform — identical for a brand-new address, one that already
+ * confirmed, and one suppressed for a hard bounce. The endpoint cannot be used
+ * to test whether somebody is a customer of the store, so there is nothing here
+ * to branch on: show one "check your email" message for every success.
+ */
+interface SubscribeMarketingResponse {
+    ok: true;
+}
+interface CreateStockAlertInput {
+    /** Address to notify. Lowercased and trimmed server-side. */
+    email: string;
+    /** Product the shopper is waiting for. */
+    productId: string;
+    /**
+     * Specific variant, when the product has them. An alert on the blue medium
+     * fires only when the blue medium is back, never when another size returns —
+     * so pass this on any variable product, or shoppers get alerts for stock they
+     * cannot use.
+     */
+    variantId?: string;
+    /**
+     * Storefront locale at submission time, e.g. `"he"`. Sets the language of the
+     * alert email. Falls back to the store language when omitted, so pass it on a
+     * multi-language storefront or Hebrew shoppers get English.
+     */
+    locale?: string;
+    /**
+     * Anti-bot honeypot. Render a hidden input and pass whatever it holds; a
+     * non-empty value rejects the request. Bots fill every text input.
+     */
+    honeypot?: string;
+}
+/**
+ * Deliberately uniform — identical for a new request, a duplicate, an unknown
+ * product, an item that is already in stock, and an address that has bounced
+ * before. The endpoint cannot be used to read a store's stock levels or
+ * customer list, so there is nothing here to branch on: show one "we will email
+ * you" message for every success.
+ */
+interface StockAlertResponse {
+    ok: true;
+}
 type ContentType = 'FAQ' | 'FOOTER' | 'HEADER' | 'ANNOUNCEMENT' | 'RICH_TEXT' | 'PAGE';
 type ContentStatus = 'DRAFT' | 'PUBLISHED';
 interface FaqItem {
@@ -8215,6 +8463,11 @@ declare class BrainerceClient {
      * Register a new customer with password (creates account)
      * Works in vibe-coded, storefront, and admin mode
      *
+     * `birthMonth`/`birthDay` are optional and must be sent together. When
+     * `getStoreInfo().requireBirthday` is true the merchant made the birthday
+     * mandatory on that sales channel, and a call without both fields is
+     * rejected with HTTP 400.
+     *
      * @example
      * ```typescript
      * const auth = await client.registerCustomer({
@@ -8222,6 +8475,8 @@ declare class BrainerceClient {
      *   password: 'securepassword123',
      *   firstName: 'Jane',
      *   lastName: 'Doe',
+     *   birthMonth: 4, // optional, unless the channel requires a birthday
+     *   birthDay: 17,
      * });
      * ```
      */
@@ -8595,6 +8850,67 @@ declare class BrainerceClient {
          */
         get: (formKey?: string, locale?: string) => Promise<ContactFormPublic>;
     };
+    /**
+     * Email marketing signup for a storefront — a newsletter popup, a footer
+     * capture bar, an exit-intent modal.
+     *
+     * **Confirmed opt-in, always.** `subscribe()` creates the contact and mails
+     * them a confirmation link. The address is NOT subscribed and CANNOT receive
+     * a campaign until the recipient clicks that link. This is not a setting:
+     * consent has to come from the mailbox, or anyone could subscribe anyone.
+     *
+     * So do not render "You're subscribed!" on success — render "Check your
+     * email to confirm." The one is a lie until the click lands.
+     *
+     * The response is identical for a brand-new address, one that is already
+     * subscribed, and one suppressed after a bounce, so the form can't be used to
+     * probe who shops here. Show the same message for every success.
+     *
+     * Storefront (public) and vibe-coded modes only. Rate-limited server-side to
+     * 3 requests / 60s per IP, plus one confirmation email per address per 24h.
+     *
+     * **Where the discount goes.** A "10% off your first order" popup needs a
+     * coupon from the dashboard — create one with the `customer_first_order`
+     * condition and show the code after a successful call. Subscribing does not
+     * mint a code on its own.
+     *
+     * @example
+     * ```typescript
+     * // Newsletter popup — hidden honeypot input, Hebrew storefront
+     * await brainerce.marketing.subscribe({
+     *   email: 'jane@example.com',
+     *   locale: 'he',
+     *   source: 'popup',
+     *   honeypot: hiddenFieldValue,
+     * });
+     * // → show "בדקו את המייל שלכם כדי לאשר" — NOT "נרשמת בהצלחה"
+     * ```
+     */
+    marketing: {
+        subscribe: (input: SubscribeMarketingInput) => Promise<SubscribeMarketingResponse>;
+    };
+    /**
+     * "Email me when this is back."
+     *
+     * ⛔ Not a newsletter signup, and must not be worded as one. It grants no
+     * marketing consent, creates no customer account, and the person is never
+     * mailed anything else as a result — exactly one message, about this item,
+     * with a link that stops it. Someone who unsubscribed from marketing can
+     * still use this, so do not gate it on consent.
+     *
+     * Show the affordance only on an item that is out of stock AND cannot be
+     * backordered. Every other case is silently ignored server-side — the
+     * response is uniform on purpose, so it cannot be used to read stock levels
+     * or test who is a customer — which means a button on an in-stock item looks
+     * like it worked and does nothing.
+     *
+     * Pass `variantId` on any product with variants. Without it the alert waits
+     * on the product as a whole, and a shopper who wanted the medium hears when
+     * the small comes back.
+     */
+    stockAlerts: {
+        subscribe: (input: CreateStockAlertInput) => Promise<StockAlertResponse>;
+    };
     /**
      * Typed merchant content store: FAQ, Footer, Header, Announcement,
      * Rich Text, and Page.
@@ -9069,15 +9385,26 @@ declare class BrainerceClient {
      * List visible reviews for a product (storefront / sales-channel modes).
      * Reviews that the merchant has hidden are excluded.
      *
+     * Each review carries `images` — the photos its author attached, already
+     * filtered to the ones shoppers are allowed to see. Always an array.
+     *
+     * Ordering defaults to `photos_first`: reviews carrying photos lead, newest-first
+     * within each group. Pass `sort: 'newest'` for plain chronological order. On a
+     * store with no review photos the two are identical.
+     *
      * @example
      * ```typescript
      * const { data, meta } = await client.listProductReviews('prod_123', { page: 1, limit: 20 });
-     * data.forEach(r => console.log(r.rating, r.body, r.verifiedPurchase));
+     * data.forEach(r => {
+     *   console.log(r.rating, r.body, r.verifiedPurchase);
+     *   r.images.forEach(img => console.log(img.thumbnailUrl ?? img.url));
+     * });
      * ```
      */
     listProductReviews(productId: string, params?: {
         page?: number;
         limit?: number;
+        sort?: 'photos_first' | 'newest';
     }): Promise<PaginatedResponse<ProductReview>>;
     /**
      * Get the current customer's review state for a product (storefront / sales-channel modes).
@@ -9136,6 +9463,17 @@ declare class BrainerceClient {
     }): Promise<PaginatedResponse<ProductReviewAdmin>>;
     /** Admin: hide a review (sets hiddenAt). */
     hideProductReview(reviewId: string, storeId?: string): Promise<ProductReviewAdmin>;
+    /**
+     * Admin: hide ONE photo on a review, leaving the review and its other photos
+     * visible. Requires an API key with `reviews:write`.
+     */
+    hideProductReviewImage(imageId: string, storeId?: string): Promise<ProductReviewImageAdmin>;
+    /**
+     * Admin: show one review photo. This is also the approve action — a photo that
+     * has never been approved carries no `approvedAt`, and showing it stamps one, so
+     * stores using review-photo approval need no separate verb.
+     */
+    showProductReviewImage(imageId: string, storeId?: string): Promise<ProductReviewImageAdmin>;
     /** Admin: unhide a previously hidden review. */
     showProductReview(reviewId: string, storeId?: string): Promise<ProductReviewAdmin>;
     /**
@@ -10357,19 +10695,28 @@ declare class BrainerceClient {
      */
     getCheckoutPrefillData(): Promise<CheckoutPrefillData>;
     /**
-     * Update the current customer's profile (requires customerToken)
-     * Only available in storefront mode
+     * Update the current customer's profile (requires customerToken).
+     * Only available in storefront and vibe-coded mode.
      *
-     * `birthMonth`/`birthDay` (1-12 / 1-31, no year — privacy) power the loyalty
-     * birthday gift; they must be provided together.
+     * `birthMonth`/`birthDay` (1-12 / 1-31) power the loyalty birthday gift.
+     * Month and day only, never a year, for privacy. Send both or neither, and
+     * the day has to exist in the month: anything else is rejected with HTTP 400.
+     * Send `null` for both to REMOVE a stored birthday. Leaving the keys out is a
+     * different request and keeps the stored value, so a profile form whose
+     * fields the shopper cleared has to send nulls, not omit them.
+     *
+     * The saved values now come back on the returned `CustomerProfile`, on
+     * `getMyProfile()` and on every customer read type, so a profile form can
+     * re-render the birthday it just saved. Before this, no API returned the two
+     * fields at all and the form always came back blank.
      */
     updateMyProfile(data: {
         firstName?: string;
         lastName?: string;
         phone?: string;
         acceptsMarketing?: boolean;
-        birthMonth?: number;
-        birthDay?: number;
+        birthMonth?: number | null;
+        birthDay?: number | null;
     }): Promise<CustomerProfile>;
     /**
      * Get the logged-in customer's loyalty status: enrollment, points balance,
@@ -11532,6 +11879,50 @@ declare class BrainerceClient {
         url: string;
         key: string;
     }>;
+    /**
+     * Upload one photo to attach to a product review.
+     *
+     * Available in storefront and vibe-coded modes, and — unlike
+     * `uploadCustomizationFile` — it REQUIRES a logged-in customer who has actually
+     * bought the product. Call `setCustomerToken(...)` first. That is the same bar as
+     * writing the review itself, checked here so an ineligible shopper is told before
+     * they wait for the upload rather than after.
+     *
+     * Returns a storage `key`. Collect the keys and pass them as `imageKeys` when you
+     * submit or update the review — the `url` is for a local preview only, and sending
+     * it back instead of the key will be rejected.
+     *
+     * Server rules:
+     * - `image/jpeg|png|webp|gif` only, cross-checked against the file's real bytes.
+     * - Max 5 MB and 40 megapixels per file.
+     * - Throttled to 10 uploads / minute → HTTP 429.
+     * - 403 when the store has review photos turned off, or the customer has not
+     *   bought the product; 400 once the review is already at its photo cap.
+     * - EXIF is stripped (so GPS coordinates never reach the storefront) while the
+     *   orientation tag is applied first, so phone photos stay upright.
+     * - A photo uploaded but never attached to a submitted review is reclaimed after
+     *   7 days.
+     *
+     * Read `photos` from `getMyProductReview()` for the store's live limits rather
+     * than hard-coding them.
+     *
+     * @example
+     * ```ts
+     * const { photos } = await client.getMyProductReview(productId);
+     * if (photos.enabled) {
+     *   const uploads = await Promise.all(
+     *     [...fileInput.files].slice(0, photos.maxPerReview)
+     *       .map(f => client.uploadReviewPhoto(productId, f))
+     *   );
+     *   await client.submitProductReview(productId, {
+     *     rating: 5,
+     *     body: 'Arrived beautifully wrapped.',
+     *     imageKeys: uploads.map(u => u.key),
+     *   });
+     * }
+     * ```
+     */
+    uploadReviewPhoto(productId: string, file: File | Blob): Promise<ReviewPhotoUpload>;
     /**
      * @deprecated Retiring, but there is no API-key replacement yet: `getStoreTeam`
      * is dashboard-only (403 for api_key). Keep using this until one ships.
@@ -11841,7 +12232,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "1.54.0";
+declare const SDK_VERSION = "1.60.0";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -11987,7 +12378,20 @@ declare function formatMoney(amount: number, currency: string, locale?: string):
  * generally need this (only admins author the config), but it's exposed for
  * any storefront building its own admin-like UI on top of the SDK.
  */
-declare function validateDateAvailabilityConfig(config: DateAvailabilityConstraints | null | undefined, fieldType: 'DATE' | 'DATETIME'): string[];
+/**
+ * Which definition family a config belongs to. It matters because the relative
+ * bounds are answers to "how long before the requested date must the ORDER
+ * arrive", and only the checkout surface has an order arriving.
+ *
+ * A product metafield and an order custom field are both written by an admin,
+ * often long after the fact: a merchant correcting yesterday's delivery date
+ * would be refused against a lead time measured from today. So those two
+ * surfaces reject the relative keys outright, the same way a DATE field
+ * already rejects `businessHours`. `minDate`/`maxDate`/`blockedDates` stay
+ * available everywhere.
+ */
+type DateAvailabilitySurface = 'checkout' | 'product' | 'order';
+declare function validateDateAvailabilityConfig(config: DateAvailabilityConstraints | null | undefined, fieldType: 'DATE' | 'DATETIME', surface?: DateAvailabilitySurface): string[];
 interface StoreLocalParts {
     /** "YYYY-MM-DD" in the given timezone. */
     dateYYYYMMDD: string;
@@ -12004,6 +12408,56 @@ interface StoreLocalParts {
  * Falls back to UTC parts on an invalid IANA timezone string — never throws.
  */
 declare function resolveStoreLocalParts(instant: Date, timezone: string): StoreLocalParts;
+/**
+ * The "when is now" half of a relative constraint. `leadTimeMinutes`,
+ * `cutoffTime` and `maxDaysAhead` cannot be resolved from the config alone,
+ * so every function that honours them accepts one of these.
+ *
+ * Leaving it out is allowed and means "skip the relative bounds"; the
+ * absolute ones (min/max date, blocked days, business hours) still apply.
+ * That degradation is deliberate and safe in exactly one direction: a picker
+ * built without a clock offers MORE dates than the server will accept, never
+ * fewer. The server always passes one, so this is never the enforcement path.
+ */
+interface AvailabilityClock {
+    /** IANA timezone of the store: `getStoreInfo().timezone`, never the buyer's. */
+    timezone: string;
+    /** Defaults to the current instant. Pass it explicitly to keep tests deterministic. */
+    now?: Date;
+}
+/** The concrete dates the relative constraints resolve to at one moment in time. */
+interface RelativeDateBounds {
+    /** Earliest bookable calendar date, "YYYY-MM-DD" store-local. Absent = no relative floor. */
+    earliestDate?: string;
+    /** Latest bookable calendar date, "YYYY-MM-DD" store-local. Absent = no relative ceiling. */
+    latestDate?: string;
+    /**
+     * Earliest bookable instant, from `leadTimeMinutes` alone. Finer-grained
+     * than `earliestDate`: on the boundary day this is what rules out the slots
+     * that have already gone past, without ruling out the whole date.
+     */
+    earliestInstant?: Date;
+}
+/**
+ * Resolves the relative constraints into the concrete dates they mean right now.
+ *
+ * `minDate`/`maxDate` are absolute strings compared lexically, so a merchant
+ * who means "earliest is tomorrow" watches that answer rot overnight and go on
+ * rotting. These three keys are the relative counterparts, re-resolved on
+ * every call:
+ *
+ * - `leadTimeMinutes` — preparation time. The floor is `now + leadTime`.
+ * - `cutoffTime` — the daily order deadline, store-local "HH:mm". Once the
+ *   store-local clock reaches it, the floor moves on by a further day. This is
+ *   the rule that stops orders pouring in for a day whose picking run is
+ *   already planned, which is where a holiday-eve backlog actually starts.
+ * - `maxDaysAhead` — a rolling ceiling measured from today rather than from a
+ *   fixed calendar date.
+ *
+ * Returns an empty object when no relative key is set or no clock was given,
+ * which is what lets every caller take `clock` as an optional argument.
+ */
+declare function resolveRelativeBounds(config: DateAvailabilityConstraints | null | undefined, clock: AvailabilityClock | null | undefined): RelativeDateBounds;
 interface ParsedDateFieldValue {
     /**
      * The absolute instant the value denotes. For a DATE field this is UTC
@@ -12052,7 +12506,7 @@ type DateFieldParseResult = {
  */
 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;
+declare function isCalendarDateAllowed(dateYYYYMMDD: string, config: DateAvailabilityConstraints | null | undefined, clock?: AvailabilityClock | null): boolean;
 /**
  * Discrete slot starts ("HH:mm", store-local) for one calendar date. Empty
  * array if: the date fails `isCalendarDateAllowed`, no `businessHours` window
@@ -12069,7 +12523,7 @@ declare function isCalendarDateAllowed(dateYYYYMMDD: string, config: DateAvailab
  * const slots = computeAvailableSlots(deliveryField?.dateAvailability, local.dateYYYYMMDD);
  * ```
  */
-declare function computeAvailableSlots(config: DateAvailabilityConstraints | null | undefined, dateYYYYMMDD: string): string[];
+declare function computeAvailableSlots(config: DateAvailabilityConstraints | null | undefined, dateYYYYMMDD: string, clock?: AvailabilityClock | null): 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
@@ -12082,14 +12536,14 @@ declare function computeAvailableSlots(config: DateAvailabilityConstraints | nul
  * 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[];
+declare function getBusinessHoursForDate(config: DateAvailabilityConstraints | null | undefined, dateYYYYMMDD: string, clock?: AvailabilityClock | null): 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
  * backend's own (authoritative) rejection would otherwise surface as an
  * error after a round trip.
  */
-declare function isDateValueAllowed(instant: Date, config: DateAvailabilityConstraints | null | undefined, fieldType: 'DATE' | 'DATETIME', timezone: string): {
+declare function isDateValueAllowed(instant: Date, config: DateAvailabilityConstraints | null | undefined, fieldType: 'DATE' | 'DATETIME', timezone: string, now?: Date): {
     allowed: boolean;
     reason?: string;
 };
@@ -12279,4 +12733,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 BlogPost, type BlogPostListParams, type BlogPostListResponse, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkCreateProductsDto, type BulkCreateProductsError, type BulkCreateProductsJob, type BulkCreateProductsStatus, 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 ModifierValidationFailedError, 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 PriceDriftError, 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 ProductSitemapOptions, type ProductSuggestion, type ProductUnavailableError, 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 StoreTracking, 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 TrackingEventItem, type TrackingEventName, type TrackingEventPayload, 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, buildProductFaqJsonLd, 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, getProductSitemapEntries, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseDateFieldValue, 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 AvailabilityClock, type BlogPost, type BlogPostListParams, type BlogPostListResponse, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkCreateProductsDto, type BulkCreateProductsError, type BulkCreateProductsJob, type BulkCreateProductsStatus, 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 DateAvailabilitySurface, 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 ModifierValidationFailedError, 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 PriceDriftError, 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 ProductSitemapOptions, type ProductSuggestion, type ProductUnavailableError, 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 RelativeDateBounds, 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 StoreTracking, 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 TrackingEventItem, type TrackingEventName, type TrackingEventPayload, 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, buildProductFaqJsonLd, 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, getProductSitemapEntries, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseDateFieldValue, parseWebhookEvent, resolveRelativeBounds, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };