brainerce 2.0.0 → 2.1.0

package/dist/index.d.mts

@@ -14,7 +14,7 @@ interface BrainerceClientOptions {
     salesChannelId?: string;
     /**
      * @deprecated Use `salesChannelId` instead. `connectionId` is kept as a
-     * backwards-compatible alias and will be removed in SDK 2.0.
+     * backwards-compatible alias. It is permanent and is not scheduled for removal.
      */
     connectionId?: string;
     /**
@@ -202,13 +202,13 @@ interface StoreInfo {
     socialLinks?: Record<string, string> | null;
     /** Sales Channel ID (sales-channel mode only) */
     salesChannelId?: string;
-    /** @deprecated alias of `salesChannelId` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `salesChannelId` — not scheduled for removal */
     connectionId?: string;
     /** Store name (sales-channel mode only - same as name) */
     storeName?: string;
     /** Sales channel status (sales-channel mode only) */
     salesChannelStatus?: string;
-    /** @deprecated alias of `salesChannelStatus` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `salesChannelStatus` — not scheduled for removal */
     status?: string;
     /** Allowed API scopes (sales-channel mode only) */
     allowedScopes?: string[];
@@ -224,6 +224,21 @@ interface StoreInfo {
      * like it worked and quietly does nothing.
      */
     stockAlertsEnabled?: boolean;
+    /**
+     * Whether this store takes donations.
+     *
+     * Gate the whole donation page on it. Unlike almost every other conditional
+     * surface in this SDK, a donation page does NOT auto-hide: `createDonation`
+     * is rejected outright while donations are closed, so a page built for a
+     * store that has not opened them collects a donor's name, email and card
+     * details and then fails on submit.
+     *
+     * Present on both `/info` endpoints, so this works in storefront mode as well
+     * as vibe-coded mode. `getStoreCapabilities().features.hasDonations` carries
+     * the same fact but is vibe-coded only. Absent on an older backend, and
+     * absent means closed.
+     */
+    donationsEnabled?: boolean;
     /**
      * Whether new customer registrations require email verification.
      * If true, your site MUST implement an email verification flow:
@@ -398,6 +413,116 @@ interface SupportedLocaleObject {
     /** Whether this is the store's default locale */
     isDefault: boolean;
 }
+/**
+ * What the merchant has actually configured on this sales channel — the
+ * response of {@link BrainerceClient.getStoreCapabilities}.
+ *
+ * Build against this instead of hardcoding. A storefront that hardcodes a
+ * low-stock threshold shows the wrong badge on every store whose merchant
+ * chose a different one, and a storefront that renders a feature the merchant
+ * never switched on ships a control that does nothing.
+ */
+interface StoreCapabilities {
+    store: {
+        /** Parent store name (account level). */
+        name: string;
+        /** Per-channel display name — what the merchant sees in the dashboard. */
+        channelName: string;
+        /** ISO 4217 code the store prices in. */
+        currency: string;
+        /** The store's content language (BCP-47). */
+        language: string;
+        /**
+         * Present ONLY when the merchant enabled multi-language on this store.
+         * Absent means single-language: render `language` and do not build a
+         * locale switcher. When present, `enabled` is always `true`.
+         */
+        i18n?: I18nSettings;
+    };
+    connection: {
+        /** API scopes granted to this channel. A call outside them is rejected. */
+        allowedScopes: string[];
+        /** Whether this channel may create orders (`orders:write`). */
+        ordersWriteEnabled: boolean;
+        /** Whether guest checkout sessions are recorded for abandoned-cart recovery. */
+        guestCheckoutTracking: boolean;
+        /** Whether a newly registered customer must verify their email address. */
+        requireEmailVerification: boolean;
+        /**
+         * The merchant made the birthday mandatory at registration on this channel.
+         * Render the signup form's month and day as required when true: the register
+         * route rejects a registration without one, and a form that does not read
+         * this cannot be submitted and tells the shopper nothing about why.
+         */
+        requireBirthday: boolean;
+        /** Whether test orders may complete without a real payment. */
+        sandboxPaymentsEnabled: boolean;
+        /** When stock is held: at cart, at checkout creation, or at payment. */
+        reservationStrategy: 'ON_CART' | 'ON_CHECKOUT' | 'ON_PAYMENT';
+        /** Minutes a reservation is held before it expires. */
+        reservationTimeout: number;
+        /**
+         * Whether the storefront should call out low stock at all. When `false`,
+         * show no low-stock treatment regardless of `lowStockThreshold` — the
+         * merchant turned the urgency messaging off on purpose.
+         */
+        lowStockWarning: boolean;
+        /** Units at or below which stock counts as low. Merchant-configured; defaults to 5. */
+        lowStockThreshold: number;
+        /**
+         * Whether the storefront should offer "email me when this is back" on a
+         * sold-out product. When `false`, do not render the affordance at all:
+         * `stockAlerts.subscribe()` still answers `{ ok: true }` and records
+         * nothing, so a button left up looks like it worked and quietly does not.
+         */
+        stockAlertsEnabled: boolean;
+    };
+    features: {
+        /** Payment gateways the merchant installed. Empty means checkout cannot take money yet. */
+        paymentProviders: Array<{
+            name: string;
+            provider: string;
+        }>;
+        /** Social login providers configured on the store, with their on/off state. */
+        oauthProviders: Array<{
+            provider: string;
+            isEnabled: boolean;
+        }>;
+        /** At least one active shipping zone exists. */
+        hasShippingZones: boolean;
+        /** At least one enabled automatic discount rule exists. */
+        hasDiscountRules: boolean;
+        /** At least one product is a digital download. */
+        hasDownloadableProducts: boolean;
+        /** At least one coupon exists. */
+        hasCoupons: boolean;
+        /** At least one active checkout custom field is defined. */
+        hasCheckoutCustomFields: boolean;
+        /**
+         * Gift cards are switched on for this store.
+         *
+         * A per-store switch, not a count — a store that has issued no cards yet
+         * still reports true once the merchant enables the feature. Build the
+         * redemption field regardless: it auto-hides, and the day a card is issued
+         * the storefront already honours it.
+         */
+        hasGiftCards: boolean;
+        /** At least one PUBLISHED content entry (page, blog post, FAQ) exists. */
+        hasContent: boolean;
+        /** The store has an ACTIVE loyalty program. */
+        hasLoyaltyProgram: boolean;
+        /** The loyalty program has referrals enabled. */
+        hasReferralProgram: boolean;
+        /** The loyalty program has birthday gifts enabled. */
+        hasBirthdayRewards: boolean;
+        /** The loyalty program has at least one milestone badge configured. */
+        hasBadges: boolean;
+        /** The loyalty program has at least one active paid membership plan. */
+        hasPaidMembership: boolean;
+        /** AI reward recommendation is available — true whenever loyalty is active. */
+        hasAiRewardRecommendation: boolean;
+    };
+}
 /** Upsell feature configuration exposed to the storefront */
 interface UpsellSettings {
     /** Minimum cart amount for free shipping (null = disabled) */
@@ -765,7 +890,7 @@ interface Product {
         attribute: {
             id: string;
             name: string;
-            displayType?: string;
+            displayType?: AttributeDisplayType;
             translations?: Record<string, Record<string, string>> | null;
         } | null;
         attributeOption: {
@@ -785,14 +910,14 @@ interface Product {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -2144,14 +2269,14 @@ interface Coupon {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -2582,6 +2707,47 @@ interface OAuthCallbackResponse extends CustomerAuthResponse {
     provider: CustomerOAuthProvider;
     redirectUrl?: string;
 }
+/**
+ * Values the `?oauth_error=` query param can take when a social sign-in fails.
+ *
+ * The post-OAuth redirect follows the RFC 6749 §4.1.2.1 shape: a stable
+ * machine-readable code in `oauth_error`, plus an English `error_description`
+ * meant for developers. Switch on the code to render localized copy — the
+ * description is not shopper-facing copy and its wording may change.
+ *
+ * The list is open: the provider's own codes (`access_denied`,
+ * `temporarily_unavailable`, `admin_policy_enforced`, ...) are passed through,
+ * so always handle the unknown case.
+ */
+type OAuthErrorCode = 
+/** Callback arrived without a usable `code`/`state` pair. */
+'invalid_request'
+/** `state` matches no outstanding authorization request. */
+ | 'invalid_state'
+/** `state` was already consumed — a replay or a double-submitted callback. */
+ | 'state_already_used'
+/** `state` sat unused past its 10-minute TTL. Ask the shopper to retry. */
+ | 'state_expired'
+/** Provider is recognised but not implemented yet. */
+ | 'provider_unsupported'
+/** Provider reported a failure we could not map onto a safe code. */
+ | 'provider_error'
+/** Shopper declined consent at the provider. */
+ | 'access_denied'
+/** The store has this provider turned off. Hide the button. */
+ | 'provider_disabled'
+/** This customer already has a different account linked for this provider. */
+ | 'provider_already_linked'
+/** This provider account is already linked to a different customer. */
+ | 'oauth_account_linked_to_another_customer'
+/**
+ * An account with this email has an unverified password credential, and the
+ * provider would not attest ownership of the address either. Send the shopper
+ * to email verification, not to a retry.
+ */
+ | 'link_blocked_unverified_password_account'
+/** Unexpected server-side failure. Details are in the platform logs, not here. */
+ | 'server_error' | (string & {});
 interface OAuthConnection {
     id: string;
     provider: CustomerOAuthProvider;
@@ -2900,7 +3066,7 @@ interface AddToCartDto {
      * a picked modifier carries `referencedProductId` and that referenced product
      * itself has modifier groups. Server enforces depth ≤ 3.
      */
-    nestedByModifierId?: Record<string, ModifierSelection[]>;
+    nestedByModifierId?: Record<string, NestedModifierSelection>;
     /**
      * Optional product info for local cart (guest mode).
      * If provided, SDK uses this directly without fetching from API.
@@ -2922,7 +3088,7 @@ interface UpdateCartItemDto {
      */
     selections?: ModifierSelection[];
     /** Nested-combo selections (see `AddToCartDto.nestedByModifierId`). */
-    nestedByModifierId?: Record<string, ModifierSelection[]>;
+    nestedByModifierId?: Record<string, NestedModifierSelection>;
 }
 interface ApplyCouponDto {
     code: string;
@@ -3126,7 +3292,15 @@ type DeliveryType = 'shipping' | 'pickup';
  * ```
  */
 interface TaxBreakdownItem {
-    /** Tax name (e.g., "Israel VAT 18%", "California Sales Tax") */
+    /**
+     * Tax name (e.g. "Israel VAT 18%", "California Sales Tax", "GST", "QST").
+     *
+     * `breakdown` carries ONE ROW PER RATE and has always been able to hold
+     * several. In Canada it routinely does: a Quebec order has a "GST" row and a
+     * "QST" row, a British Columbia order has "GST" and "PST". Render every row —
+     * a GST/QST-registered merchant is required to itemise them, and collapsing
+     * them into one "Tax" line loses information the buyer's own accountant needs.
+     */
     name: string;
     /** Tax rate as decimal (0.17 = 17%) */
     rate: number;
@@ -3141,15 +3315,19 @@ interface TaxBreakdownItem {
  * Tax calculation result with itemized breakdown.
  * Included in checkout response after shipping address is set.
  *
+ * `breakdown` can hold SEVERAL rows and often does — a Quebec address is taxed
+ * GST 5% + QST 9.975%, a British Columbia one GST 5% + PST 7%. Loop it rather
+ * than reading `breakdown[0]`.
+ *
  * @example
  * ```typescript
  * // Check if tax applies
  * if (checkout.taxBreakdown && checkout.taxBreakdown.totalTax > 0) {
  *   console.log(`Tax: $${checkout.taxBreakdown.totalTax.toFixed(2)}`);
  *
- *   // Show breakdown
+ *   // Show EVERY row — Quebec prints two: GST then QST.
  *   checkout.taxBreakdown.breakdown.forEach(tax => {
- *     const percent = (tax.rate * 100).toFixed(2);
+ *     const percent = (tax.rate * 100).toFixed(3);
  *     console.log(`  ${tax.name} (${percent}%): $${tax.amount.toFixed(2)}`);
  *   });
  * }
@@ -3479,6 +3657,137 @@ interface SelectPickupLocationDto {
  * @see CheckoutLineItem for item structure
  * @see ShippingRate for shipping rate structure
  */
+/**
+ * A gift card applied to a checkout.
+ *
+ * Returned by `applyGiftCard`. Note what is NOT here: the code, the card id, or
+ * anything about who owns it. A storefront needs the tender id (to remove it),
+ * how much went on, and what the provider will now be charged.
+ */
+interface CheckoutTender {
+    /** Pass this to `removeGiftCard` — a checkout can carry more than one card. */
+    tenderId: string;
+    /**
+     * How much of the card was applied. Capped at what the order still owes, so a
+     * ₪200 card on a ₪50 order applies ₪50 and leaves ₪150 for next time.
+     */
+    amountApplied: string;
+    /**
+     * What the payment provider will be charged.
+     *
+     * The order `total` is deliberately UNCHANGED. A gift card is a tender, not a
+     * discount: the order is still worth what it is worth and tax is still
+     * calculated on that, which is why this is a separate field and not a
+     * reduction of `discountAmount`.
+     */
+    providerAmountDue: string;
+}
+/**
+ * The answer from `checkGiftCardBalance`.
+ *
+ * Identical for an unknown code, a disabled card and an expired one. That is on
+ * purpose — see the method's own documentation.
+ */
+interface GiftCardBalance {
+    /** Spendable balance, or '0.00' when the card cannot be used. */
+    balance: string;
+    currency: string;
+    /** Whether this code can be applied to a checkout right now. */
+    usable: boolean;
+}
+/**
+ * A tribute gift.
+ *
+ * `IN_HONOR` for someone living, `IN_MEMORY` for someone who has died. Setting
+ * either requires `tributeName`; the API rejects a tribute with nobody named.
+ */
+type DonationTributeType = 'IN_HONOR' | 'IN_MEMORY';
+/**
+ * `PENDING` means an intent exists and no money has moved. A donation is only a
+ * gift once it is `PAID`, which happens when the provider's webhook confirms
+ * it — never when `createDonation` returns.
+ *
+ * There is no `REFUNDED` member on purpose: a refund is recorded against the
+ * payment, not the donation, so one fact lives in one place.
+ */
+type DonationStatus = 'PENDING' | 'PAID' | 'FAILED' | 'CANCELLED';
+/** What `createDonation` accepts. */
+interface CreateDonationInput {
+    /**
+     * The gift itself, in the store's base currency. EXCLUDES `feeCoverAmount` —
+     * this is the figure the donor is credited with.
+     */
+    amount: number;
+    /**
+     * Processing fee the donor volunteered to absorb. Charged on TOP of `amount`,
+     * never subtracted from it. Roughly 55-60% of donors accept this when a form
+     * offers it, so it is worth offering.
+     */
+    feeCoverAmount?: number;
+    /** Required. Also how the donor's giving history is found later. */
+    donorEmail: string;
+    donorName?: string;
+    /**
+     * Hides the donor's name on public surfaces (a donor wall, a thank-you page).
+     * It does NOT hide them from the organisation, which still needs the donor
+     * for its own records.
+     */
+    isAnonymous?: boolean;
+    /** Requires `tributeName` when set. */
+    tributeType?: DonationTributeType;
+    tributeName?: string;
+    /** The donor's own words. Plain text — never render it as HTML. */
+    message?: string;
+    /**
+     * Where to land the donor after paying, as a PATH on your own storefront
+     * (e.g. `/thank-you`). A full URL is rejected: the payment provider redirects
+     * a real browser here, so accepting one would be an open redirect.
+     */
+    returnPath?: string;
+}
+/**
+ * What `createDonation` returns.
+ *
+ * ⛔ This is NOT a paid donation. `status` is `PENDING` and the money has not
+ * moved: you have a provider intent to complete, exactly as you would after
+ * `createPaymentIntent` on a checkout. Credit the gift only after the donation
+ * reads back as `PAID`.
+ */
+interface DonationIntent {
+    donationId: string;
+    status: DonationStatus;
+    /** The gift, excluding any covered fee. */
+    amount: string;
+    feeCoverAmount: string;
+    /** What the provider is actually charging: `amount` + `feeCoverAmount`. */
+    chargeAmount: string;
+    currency: string;
+    payment: {
+        intentId: string;
+        clientSecret?: string | null;
+        clientSdk?: unknown;
+        redirectUrl?: string | null;
+        providerType: string | null;
+    };
+}
+/**
+ * A donation read back for a thank-you page.
+ *
+ * Deliberately narrow. There is no failure reason (a decline message tells a
+ * card tester which card is live) and `donorName` is `null` whenever the gift
+ * was marked anonymous.
+ */
+interface PublicDonation {
+    id: string;
+    status: DonationStatus;
+    amount: string;
+    feeCoverAmount: string;
+    currency: string;
+    donorName: string | null;
+    tributeType: DonationTributeType | null;
+    tributeName: string | null;
+    paidAt: string | null;
+}
 interface Checkout {
     /** Unique checkout identifier */
     id: string;
@@ -3542,6 +3851,30 @@ interface Checkout {
     customFieldValues?: Record<string, unknown> | null;
     /** Applied coupon code */
     couponCode?: string | null;
+    /**
+     * Gift cards held against this checkout, oldest first.
+     *
+     * Read these to render applied cards after a page reload — a checkout keeps
+     * its holds server-side, so a storefront that only tracks the response from
+     * `applyGiftCard` loses them on refresh and shows a shopper a card they no
+     * longer appear to have.
+     *
+     * Remove one with its `tenderId`, never the code.
+     */
+    tenders?: Array<{
+        tenderId: string;
+        amountApplied: string;
+    }>;
+    /**
+     * What the payment provider will be charged: `total` minus every gift card
+     * applied.
+     *
+     * `total` is deliberately UNCHANGED by a gift card. A gift card is a means of
+     * payment, not a discount — the order is still worth what it is worth and tax
+     * is still calculated on that. Show this as its own line beside the total
+     * ("Gift card −₪54.50"), never folded into `discountAmount`.
+     */
+    providerAmountDue?: string;
     /**
      * Order-level note from the shopper (set via setCheckoutCustomer).
      * Copied onto the order at completion and shown to the merchant.
@@ -3886,7 +4219,7 @@ interface WebhookEvent {
     data: unknown;
     timestamp: string;
 }
-type WebhookEventType = 'product.created' | 'product.updated' | 'product.deleted' | 'inventory.updated' | 'order.created' | 'order.updated' | 'coupon.created' | 'coupon.updated' | 'coupon.deleted' | 'cart.created' | 'cart.updated' | 'cart.abandoned' | 'checkout.started' | 'checkout.completed' | 'checkout.failed';
+type WebhookEventType = 'order.created' | 'order.updated' | 'order.paid' | 'order.fulfilled' | 'order.cancelled' | 'order.refunded' | 'customer.created' | 'customer.updated' | 'customer.deleted' | 'product.created' | 'product.updated' | 'product.deleted' | 'inventory.updated' | 'inventory.low' | 'checkout.completed' | 'checkout.abandoned' | 'payment.succeeded' | 'payment.failed' | 'payment.refunded' | 'blog.post.published' | 'blog.post.updated' | 'donation.paid' | 'donation.refunded';
 type VariantStatus = 'active' | 'draft';
 interface CreateVariantDto {
     sku?: string;
@@ -4259,63 +4592,6 @@ interface PublishProductResponse {
         error?: string;
     }>;
 }
-type CustomApiAuthType = 'api_key' | 'bearer' | 'basic' | 'oauth2';
-type CustomApiSyncDirection = 'inbound' | 'outbound' | 'bidirectional';
-type CustomApiConnectionStatus = 'CONNECTED' | 'DISCONNECTED' | 'PAUSED' | 'ERROR';
-interface CustomApiCredentials {
-    apiKey?: string;
-    bearerToken?: string;
-    username?: string;
-    password?: string;
-    headerName?: string;
-}
-interface CustomApiSyncConfig {
-    products?: boolean;
-    orders?: boolean;
-    inventory?: boolean;
-}
-interface CustomApiIntegration {
-    id: string;
-    storeId: string;
-    name: string;
-    description?: string | null;
-    baseUrl: string;
-    authType: CustomApiAuthType;
-    credentials?: CustomApiCredentials;
-    status: CustomApiConnectionStatus;
-    enabled: boolean;
-    syncDirection: CustomApiSyncDirection;
-    syncConfig?: CustomApiSyncConfig | null;
-    lastSyncAt?: string | null;
-    lastError?: string | null;
-    lastErrorAt?: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreateCustomApiDto {
-    name: string;
-    description?: string;
-    baseUrl: string;
-    authType: CustomApiAuthType;
-    credentials?: CustomApiCredentials;
-    syncDirection?: CustomApiSyncDirection;
-    syncConfig?: CustomApiSyncConfig;
-}
-interface UpdateCustomApiDto {
-    name?: string;
-    description?: string;
-    baseUrl?: string;
-    authType?: CustomApiAuthType;
-    credentials?: CustomApiCredentials;
-    enabled?: boolean;
-    syncDirection?: CustomApiSyncDirection;
-    syncConfig?: CustomApiSyncConfig;
-}
-interface CustomApiTestResult {
-    success: boolean;
-    latency?: number;
-    error?: string;
-}
 /**
  * Client-side SDK configuration for payment providers that render a widget.
  * Returned by the backend in provider config and payment intents.
@@ -4697,14 +4973,14 @@ interface Category {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -4785,14 +5061,14 @@ interface Brand {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -4854,14 +5130,14 @@ interface Tag {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -4890,6 +5166,11 @@ interface UpdateTagDto {
  * Attribute source type
  */
 type AttributeSource = 'GLOBAL' | 'PLATFORM';
+/**
+ * How an attribute's options render as swatches on the storefront.
+ * `'DEFAULT'` is a plain text/dropdown option list.
+ */
+type AttributeDisplayType = 'DEFAULT' | 'COLOR_SWATCH' | 'IMAGE_SWATCH' | 'MIXED_SWATCH';
 /**
  * Attribute for product variations
  */
@@ -4898,7 +5179,7 @@ interface Attribute {
     accountId: string;
     storeId?: string | null;
     name: string;
-    displayType?: string;
+    displayType?: AttributeDisplayType;
     source: AttributeSource;
     platform?: ConnectorPlatform | null;
     externalId?: string | null;
@@ -4930,7 +5211,7 @@ interface AttributeOption {
 }
 interface CreateAttributeDto {
     name: string;
-    displayType?: string;
+    displayType?: AttributeDisplayType;
     source: AttributeSource;
     platform?: ConnectorPlatform;
     storeId?: string;
@@ -4940,7 +5221,7 @@ interface CreateAttributeDto {
 }
 interface UpdateAttributeDto {
     name?: string;
-    displayType?: string;
+    displayType?: AttributeDisplayType;
     platformMetadata?: Record<string, unknown>;
     isActive?: boolean;
 }
@@ -5054,7 +5335,33 @@ interface ShippingRateConfig {
     createdAt: string;
     updatedAt: string;
 }
-type ShippingRateType = 'FLAT' | 'FREE' | 'WEIGHT_BASED' | 'PRICE_BASED' | 'QUANTITY_BASED';
+/**
+ * How a shipping rate computes its price.
+ *
+ * Mirrors the `ShippingRateType` enum the API validates against with
+ * `@IsEnum`; a value outside this set is rejected with 400.
+ *
+ * ⛔ This list was wrong until SDK 2.0.3 and the two corrections bite in
+ * opposite directions, so read both before pinning an older version:
+ *
+ * - It declared `'FLAT'`, which the API has never accepted — the member is
+ *   `'FLAT_RATE'`. Flat rate is the commonest rate there is, and no server-side
+ *   normaliser exists, so every `createShippingRate` written against the old
+ *   type failed with 400 no matter how correct it looked.
+ * - It omitted `'LOCAL_PICKUP'` entirely, which is the only way to express
+ *   click-and-collect, and invented `'QUANTITY_BASED'`, which does not exist.
+ */
+type ShippingRateType = 
+/** One price for the whole order, in `rateConfig.amount`. */
+'FLAT_RATE'
+/** No charge. Pair with `minOrderAmount` for "free over X". */
+ | 'FREE'
+/** Priced from total cart weight. */
+ | 'WEIGHT_BASED'
+/** Priced from order value. */
+ | 'PRICE_BASED'
+/** Collection in person — nothing ships, so no address is required. */
+ | 'LOCAL_PICKUP';
 interface CreateShippingZoneDto {
     name: string;
     countries: string[];
@@ -5125,6 +5432,72 @@ interface ShippingZoneQueryParams {
     sortBy?: string;
     sortOrder?: 'asc' | 'desc';
 }
+/**
+ * Parcel override for a return label. Omit to use the installed shipping
+ * app's configured defaults — what the customer packs a return into is
+ * rarely what left the warehouse.
+ */
+interface ReturnLabelParcel {
+    length?: string;
+    width?: string;
+    height?: string;
+    weight?: string;
+    distanceUnit?: 'in' | 'cm';
+    massUnit?: 'lb' | 'oz' | 'g' | 'kg';
+}
+/**
+ * Buy a return label for an order: the customer ships, the merchant receives.
+ * See {@link BrainerceClient.createReturnLabel}.
+ *
+ * There is no `rateId` here, unlike a normal shipment. A return is a distinct
+ * kind of shipment at the carrier, fixed when it is created and not amendable
+ * afterwards, so it cannot be rate-shopped first — this quotes and buys in
+ * one call. `preferredCarrier` / `preferredService` are the only steering;
+ * omit both and the cheapest rate wins, with the response reporting what was
+ * actually billed.
+ *
+ * The merchant's carrier account pays. There is no mechanism for charging the
+ * customer for return postage — the cost lands on
+ * {@link CreateReturnLabelResponse.rate} so it can be deducted from a refund
+ * deliberately rather than absorbed silently.
+ */
+interface CreateReturnLabelDto {
+    /** Parcel dimensions for the return. Defaults to the shipping app config. */
+    parcel?: ReturnLabelParcel;
+    /**
+     * Label file format. `'PDF'` prints from a browser, which is what a
+     * customer needs; `'ZPL'`/`'EPL'` drive warehouse thermal printers.
+     * Defaults to `'PDF'`. If the carrier cannot produce the requested format
+     * it returns its closest match rather than failing the purchase.
+     */
+    labelFormat?: 'PDF' | 'PNG' | 'ZPL' | 'EPL';
+    /** Preferred carrier slug (e.g. `'USPS'`). Falls back to the cheapest rate. */
+    preferredCarrier?: string;
+    /** Preferred service slug (e.g. `'GroundAdvantage'`). Falls back to the cheapest rate. */
+    preferredService?: string;
+    /**
+     * The outbound `Shipment.id` this return reverses. Recorded on the return
+     * for the merchant's own records; not required, since a return can predate
+     * any shipment record.
+     */
+    returnForShipmentId?: string;
+    /** Why the customer is returning it. Stored on the shipment, shown to the merchant. */
+    reason?: string;
+}
+/** Response from {@link BrainerceClient.createReturnLabel}. */
+interface CreateReturnLabelResponse {
+    shipmentId: string;
+    labelUrl: string;
+    trackingNumber: string;
+    carrier: string;
+    /**
+     * What the merchant's carrier account was billed for this return. `null`
+     * only when the app reported no usable figure — the label is real either
+     * way, and showing nothing beats showing a guess.
+     */
+    rate: string | null;
+    rateCurrency: string | null;
+}
 /**
  * Tax rate configuration
  */
@@ -5159,6 +5532,21 @@ interface TaxRate {
     isCompound: boolean;
     /** Whether tax is included in prices */
     isInclusive: boolean;
+    /**
+     * Charge this rate TOGETHER WITH the other stackable rates matching the same
+     * address, instead of only the most specific one.
+     *
+     * `false` (the default, and every rate created before this field existed) is
+     * the historic rule: the most specific match wins alone and the rest are
+     * discarded. `true` opts into summation — Canada's GST 5% (country row) plus
+     * a province's PST/QST, both charged on the same pre-tax base, producing two
+     * `TaxBreakdownItem` rows.
+     *
+     * Additive, never compound — see the deprecated {@link TaxRate.isCompound}.
+     * Stacking also never crosses a tax class: a class-specific rate REPLACES the
+     * Standard rates rather than adding to them.
+     */
+    stackable: boolean;
     priority: number;
     isActive: boolean;
     /** Countries where this tax rate applies as exception */
@@ -5183,6 +5571,12 @@ interface CreateTaxRateDto {
      */
     isCompound?: boolean;
     isInclusive?: boolean;
+    /**
+     * Charge this rate together with the other stackable rates matching the same
+     * address (Canada GST + PST/QST) rather than only the most specific one.
+     * Defaults to `false`, which keeps the most-specific-wins rule.
+     */
+    stackable?: boolean;
     /** Tax class this rate applies to. Omit/null = Standard. */
     taxClassId?: string;
     priority?: number;
@@ -5204,6 +5598,12 @@ interface UpdateTaxRateDto {
      */
     isCompound?: boolean;
     isInclusive?: boolean;
+    /**
+     * Charge this rate together with the other stackable rates matching the same
+     * address. Flipping an existing rate to `true` changes what future checkouts
+     * collect: rates that used to be mutually exclusive start being summed.
+     */
+    stackable?: boolean;
     priority?: number;
     isActive?: boolean;
     exceptionCountries?: string[];
@@ -5350,9 +5750,27 @@ interface UpsertRegionPricesResult {
 }
 interface TaxEstimateResponse {
     appliesTax: boolean;
-    /** Percent — e.g. 18 for 18%. `null` when no matching rule. */
+    /**
+     * Percent — e.g. 18 for 18%. In a stacked jurisdiction this is the SUMMED
+     * effective rate of every rate in `rates`. `null` when no matching rule.
+     */
     rate: number | null;
+    /** One rate's name, or several joined with `" + "` ("GST + QST"). */
     rateName: string | null;
+    /**
+     * One entry per rate behind the estimate. Amounts are 2dp and sum exactly to
+     * `estimatedTax`.
+     *
+     * A preview has no province, so a Canadian estimate shows the federal GST
+     * alone; the provincial PST/QST joins it at checkout once the buyer gives a
+     * shipping address. That is precisely what `note` is for — render it.
+     */
+    rates: Array<{
+        rateId: string;
+        name: string;
+        rate: number;
+        amount: number;
+    }>;
     /** Tax portion of `subtotal` at the store's `pricesIncludeTax` mode. */
     estimatedTax: number;
     pricesIncludeTax: boolean;
@@ -5507,14 +5925,14 @@ interface MetafieldDefinition {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -5799,8 +6217,15 @@ interface UpdateMemberRoleDto {
 }
 /** Store-level team member role */
 type StoreRole = 'OWNER' | 'MANAGER' | 'STAFF' | 'VIEWER';
-/** Granular store permission */
-type StorePermission = 'VIEW_PRODUCTS' | 'CREATE_PRODUCTS' | 'EDIT_PRODUCTS' | 'DELETE_PRODUCTS' | 'MANAGE_PRODUCT_CATEGORIES' | 'VIEW_ORDERS' | 'UPDATE_ORDER_STATUS' | 'FULFILL_ORDERS' | 'CANCEL_ORDERS' | 'REFUND_ORDERS' | 'VIEW_INVENTORY' | 'UPDATE_INVENTORY' | 'VIEW_CUSTOMERS' | 'EDIT_CUSTOMERS' | 'VIEW_ANALYTICS' | 'MANAGE_STORE_SETTINGS' | 'MANAGE_INTEGRATIONS' | 'MANAGE_TEAM' | 'MANAGE_BILLING';
+/**
+ * Granular store permission.
+ *
+ * Mirrors the `StorePermission` enum in the platform database exactly — the
+ * team endpoints return and accept every member below. Keep in sync with
+ * `packages/database/prisma/schema.prisma`; a value missing here is a value
+ * `getMyStorePermissions()` can return that will not type-check for callers.
+ */
+type StorePermission = 'VIEW_PRODUCTS' | 'CREATE_PRODUCTS' | 'EDIT_PRODUCTS' | 'DELETE_PRODUCTS' | 'MANAGE_PRODUCT_CATEGORIES' | 'VIEW_ORDERS' | 'UPDATE_ORDER_STATUS' | 'FULFILL_ORDERS' | 'CANCEL_ORDERS' | 'REFUND_ORDERS' | 'VIEW_INVENTORY' | 'UPDATE_INVENTORY' | 'VIEW_CUSTOMERS' | 'EDIT_CUSTOMERS' | 'VIEW_CONTACT_INQUIRIES' | 'MANAGE_CONTACT_INQUIRIES' | 'DELETE_CONTACT_INQUIRIES' | 'VIEW_CONTENT' | 'MANAGE_CONTENT' | 'VIEW_BLOG' | 'MANAGE_BLOG' | 'VIEW_ANALYTICS' | 'VIEW_COUPONS' | 'CREATE_COUPONS' | 'EDIT_COUPONS' | 'DELETE_COUPONS' | 'VIEW_DISCOUNT_RULES' | 'CREATE_DISCOUNT_RULES' | 'EDIT_DISCOUNT_RULES' | 'DELETE_DISCOUNT_RULES' | 'VIEW_PRICING_FORMULAS' | 'CREATE_PRICING_FORMULAS' | 'EDIT_PRICING_FORMULAS' | 'DELETE_PRICING_FORMULAS' | 'VIEW_TAXONOMY' | 'MANAGE_TAXONOMY' | 'VIEW_CONNECTORS' | 'VIEW_API_KEYS' | 'MANAGE_API_KEYS' | 'VIEW_WEBHOOKS' | 'MANAGE_WEBHOOKS' | 'VIEW_APPS' | 'INSTALL_APPS' | 'CONFIGURE_APPS' | 'MANAGE_APPS' | 'VIEW_STORE_SETTINGS' | 'MANAGE_STORE_SETTINGS' | 'MANAGE_INTEGRATIONS' | 'MANAGE_TEAM' | 'VIEW_STOREFRONT_BOT_SETTINGS' | 'MANAGE_STOREFRONT_BOT_SETTINGS' | 'VIEW_STOREFRONT_BOT_CONVERSATIONS' | 'MANAGE_STOREFRONT_BOT_CONVERSATIONS' | 'MANAGE_BILLING' | 'MANAGE_DEVELOPER' | 'USE_AI_ASSISTANT' | 'VIEW_LOYALTY' | 'MANAGE_LOYALTY' | 'VIEW_SEO' | 'MANAGE_SEO' | 'VIEW_DONATIONS' | 'MANAGE_DONATIONS' | 'VIEW_GIFT_CARDS' | 'ISSUE_GIFT_CARDS' | 'ADJUST_GIFT_CARDS' | 'MANAGE_GIFT_CARDS';
 /** Store team member info */
 interface StoreMember {
     id: string;
@@ -5910,7 +6335,22 @@ interface UserStorePermissions {
     permissions: StorePermission[];
 }
 /** Email event types */
-type EmailEventType = 'ORDER_CONFIRMATION' | 'ORDER_SHIPPED' | 'ORDER_CANCELLED' | 'NEW_CUSTOMER' | 'LOW_STOCK_ALERT' | 'CART_ABANDONED' | 'TEAM_INVITATION';
+/**
+ * The transactional emails a merchant can template and configure.
+ *
+ * Mirrors the `EmailEventType` enum in `create-email-template.dto.ts`, which is
+ * what `@IsEnum` actually validates `eventType` against — a value missing here
+ * is a template the API accepts and this SDK refuses to type.
+ *
+ * That DTO enum is deliberately a SUBSET of the platform's `EmailEventType`:
+ * the wider database enum also carries billing, plan-limit, ops and
+ * platform-notice mails (`PLAN_*`, `PAYMENT_*`, `OPS_ALERT`, `SDK_UPDATE`,
+ * `TEST_SEND`, `SUPPORT_MESSAGE`, the ownership-transfer pair, ...). Those are
+ * sent by the platform on its own behalf and are not a merchant's to rewrite,
+ * so they are correctly absent. Do not "complete" this list against
+ * `schema.prisma`.
+ */
+type EmailEventType = 'ORDER_CONFIRMATION' | 'ORDER_SHIPPED' | 'ORDER_CANCELLED' | 'ORDER_COMPLETED' | 'ORDER_REFUNDED' | 'ORDER_NOTE' | 'ORDERS_LINKED' | 'NEW_ORDER_ADMIN' | 'NEW_CUSTOMER' | 'EMAIL_VERIFICATION' | 'PASSWORD_RESET' | 'INQUIRY_NEW_ADMIN' | 'INQUIRY_REPLY_CUSTOMER' | 'INQUIRY_CONFIRMATION_CUSTOMER' | 'CART_ABANDONED' | 'MARKETING_CAMPAIGN' | 'LOW_STOCK_ALERT' | 'TEAM_INVITATION' | 'STORE_INVITATION' | 'STORE_ROLE_CHANGED' | 'STORE_DELETED' | 'EXPORT_COMPLETE' | 'SCHEDULED_BACKUP_SUCCESS' | 'SCHEDULED_BACKUP_FAILED';
 /** Email event settings */
 interface EmailEventSettings {
     enabled: boolean;
@@ -6488,6 +6928,13 @@ interface CreateInquiryInput {
     locale?: string;
     /** Provenance metadata (referrer, UTM, origin page, etc.). */
     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.
+     * The API validates this field, but the type omitted it, so a typed caller
+     * could not reach the check at all.
+     */
+    honeypot?: string;
     customerId?: string;
     metadata?: Record<string, unknown>;
 }
@@ -6875,6 +7322,29 @@ interface ModifierSelection {
     modifierGroupId: string;
     modifierIds: string[];
 }
+/**
+ * One nested-combo node: the product a picked modifier references, plus that
+ * product's own modifier selections, recursing while depth stays ≤ 3.
+ *
+ * Mirrors the backend `NestedSelectionDto`
+ * (`apps/backend/src/modules/cart/dto/add-to-cart.dto.ts`), where `productId`
+ * is REQUIRED. The field used to be typed `Record<string, ModifierSelection[]>`,
+ * which no valid payload could satisfy — a `ModifierSelection` carries no
+ * `productId`, so a caller following the type sent a body the server rejects.
+ * The backend guards the field with `@IsObject()` rather than `@ValidateNested`,
+ * so the shape is enforced downstream in `ModifierGroupsService`, not by the
+ * validator, and the mismatch surfaced as a pricing failure rather than a 400.
+ */
+interface NestedModifierSelection {
+    /** The nested product referenced by the parent modifier's `referencedProductId`. */
+    productId: string;
+    /** Variant of the nested product, when it has variants. */
+    variantId?: string;
+    /** The nested product's own modifier-group selections. */
+    selections: ModifierSelection[];
+    /** Deeper nesting, keyed by the parent modifier's id. Server enforces depth ≤ 3. */
+    nestedByModifierId?: Record<string, NestedModifierSelection>;
+}
 /**
  * Per-line modifier breakdown surfaced on `CartItem` and `OrderItem`
  * once the cart line includes selections.
@@ -7046,6 +7516,75 @@ interface BlogPostListResponse {
         totalPages: number;
     };
 }
+/**
+ * Entity types that carry a `translations` JSON blob and are reachable via
+ * the Translations admin API (`client.getTranslations`, `setTranslation`,
+ * `deleteTranslation`, `aiTranslateSingle`, `aiTranslateBulk`,
+ * `getTranslationStatus`).
+ */
+type TranslatableEntityType = 'store' | 'product' | 'category' | 'brand' | 'tag' | 'variant' | 'attribute' | 'attributeOption' | 'metafield' | 'metafieldDefinition' | 'contactForm' | 'contactFormField' | 'modifierGroup' | 'modifier' | 'bundleOffer' | 'orderBump' | 'discountRule' | 'blogPost';
+/** One locale's translated field values for an entity. `undefined`/missing keys fall back to the base (default-locale) field. */
+type LocaleTranslation = Record<string, string | undefined>;
+/** All persisted translations for one entity, keyed by BCP-47 locale (e.g. `"he"`, `"fr-CA"`). */
+type TranslationsMap = Record<string, LocaleTranslation>;
+/**
+ * Body for `setTranslation`. Only the fields valid for the target
+ * `entityType` are persisted server-side (e.g. `blogPost` accepts
+ * `title`/`excerpt`/`content`/`seoTitle`/`seoDescription`/`slug`; `category`
+ * accepts `name`/`description`/`slug`) — passing others is a silent no-op,
+ * not an error. Omitted fields leave the existing translation untouched.
+ */
+interface SetTranslationFields {
+    name?: string;
+    description?: string;
+    title?: string;
+    excerpt?: string;
+    content?: string;
+    seoTitle?: string;
+    seoDescription?: string;
+    slug?: string;
+}
+/** Input for `aiTranslateSingle`. */
+interface AiTranslateSingleInput {
+    entityType: TranslatableEntityType;
+    entityId: string;
+    /** BCP-47 locale code, e.g. `"he"`, `"fr-CA"`. */
+    targetLocale: string;
+    /**
+     * Optional in-flight source text (e.g. unsaved editor state) to translate
+     * from instead of the entity's persisted base fields. Keys must match the
+     * entity's translatable fields (e.g. `seoDescription`, not `metaDescription`);
+     * unrecognized keys are ignored.
+     */
+    sourceFields?: Record<string, string>;
+}
+/** Input for `aiTranslateBulk`. */
+interface AiTranslateBulkInput {
+    /** Bulk-supported types: `product`, `category`, `brand`, `tag`, `attribute`, `modifierGroup`, `metafieldDefinition`, `blogPost`. */
+    entityType: TranslatableEntityType;
+    /** Explicit ids to translate. Omitted = every entity of `entityType` in the store missing a complete translation for `targetLocale`. */
+    entityIds?: string[];
+    /** BCP-47 locale code, e.g. `"he"`, `"fr-CA"`. Must differ from the store's default language. */
+    targetLocale: string;
+}
+/** Result of `aiTranslateBulk` — job count, not finished translations (the work runs async). */
+interface AiTranslateBulkResult {
+    queued: number;
+}
+/** One row of `getTranslationStatus`'s per-entity-type, per-locale breakdown. */
+interface TranslationStatusEntry {
+    entityType: TranslatableEntityType;
+    /** BCP-47 locale code this row's counts apply to. */
+    locale: string;
+    /** Total entities of this type in the store (exact count, not sampled). */
+    total: number;
+    /** Entities with every translatable field filled for `locale`. */
+    translated: number;
+    /** Entities with some but not all translatable fields filled for `locale`. */
+    partial: number;
+    /** Entities with no translation for `locale` at all. */
+    missing: number;
+}
 /**
  * Payload for `client.trackEvent()` — the programmatic counterpart to the
  * `t.js` script-tag pixel. Every field is optional; the server degrades
@@ -7118,8 +7657,9 @@ declare function getDirectionForLocale(locale: string | undefined | null): 'ltr'
  * const client = new BrainerceClient({ salesChannelId: 'vc_abc123...' });
  * const products = await client.getProducts();
  * ```
- * (`connectionId` is a deprecated alias of `salesChannelId`. It still works but
- * logs a deprecation warning on every construction and is removed in SDK 2.0.)
+ * (`connectionId` is a deprecated alias of `salesChannelId`. It still works and
+ * logs a deprecation warning on every construction — it is a permanent
+ * backward-compat alias and is not scheduled for removal.)
  *
  * **Storefront Mode (Frontend)** - Use storeId for public access:
  * ```typescript
@@ -7299,6 +7839,40 @@ declare class BrainerceClient {
      *   `'ltr'` for everything else (including unknown locales).
      */
     getStoreDirection(locale?: string | null): 'ltr' | 'rtl';
+    /**
+     * Get what the merchant actually configured on this sales channel: store
+     * identity and multi-language setup, the channel's own settings (low-stock
+     * warning and threshold, reservation strategy and timeout, birthday and
+     * email-verification requirements, granted scopes) and which optional
+     * features are switched on (payment providers, social login, coupons,
+     * discount rules, shipping zones, downloadables, content, loyalty).
+     *
+     * Read this instead of hardcoding. A storefront with a hardcoded low-stock
+     * threshold shows the wrong badge on every store whose merchant chose a
+     * different one, and a storefront that renders a feature nobody enabled
+     * ships a control that silently does nothing.
+     *
+     * Only available in vibe-coded mode (`salesChannelId`). The payload belongs
+     * to one sales channel: `storeId` mode has no channel to read it from, and
+     * an `apiKey` addresses the store rather than any single channel.
+     *
+     * Call it once for the whole app and share the result. It is per channel,
+     * not per product, so fetching it on every page is wasted work.
+     *
+     * @example
+     * ```typescript
+     * const caps = await client.getStoreCapabilities();
+     *
+     * // Low stock: honour the switch before the number.
+     * const threshold = caps.connection.lowStockWarning
+     *   ? caps.connection.lowStockThreshold
+     *   : 0;
+     *
+     * if (caps.features.hasCoupons) renderCouponInput();
+     * if (caps.store.i18n?.enabled) renderLocaleSwitcher(caps.store.i18n.supportedLocales);
+     * ```
+     */
+    getStoreCapabilities(): Promise<StoreCapabilities>;
     /**
      * Send a storefront analytics beacon (pageview or engagement).
      *
@@ -8128,6 +8702,29 @@ declare class BrainerceClient {
             occurredAt: string;
         }>;
     }>>;
+    /**
+     * Buy a return label the merchant sends to their customer to print.
+     *
+     * Requires admin mode (`apiKey`) with `FULFILL_ORDERS` permission — it
+     * spends the store's carrier balance, same as {@link createShippingLabel}.
+     *
+     * Unlike {@link createShippingLabel}, this is **not** on the API-key `/v1`
+     * surface — it calls the internal `/api/orders/:id/shipments/return-label`
+     * route, which takes `storeId` explicitly rather than resolving it from the
+     * key. There is no `rateId` in the body: a return is quoted and bought in
+     * one call at the shipping app, because the carrier fixes a shipment as a
+     * return when it is created and will not amend it afterwards.
+     *
+     * @example
+     * ```typescript
+     * const label = await client.createReturnLabel('store_abc', 'order_abc', {
+     *   reason: 'Wrong size',
+     *   returnForShipmentId: 'shp_original123',
+     * });
+     * console.log('Return label URL:', label.labelUrl);
+     * ```
+     */
+    createReturnLabel(storeId: string, orderId: string, data: CreateReturnLabelDto): Promise<CreateReturnLabelResponse>;
     /**
      * Cancel an order.
      *
@@ -8380,14 +8977,20 @@ declare class BrainerceClient {
      */
     publishCoupon(couponId: string, platforms: ConnectorPlatform[]): Promise<SyncJob>;
     /**
-     * Get platform capabilities for coupon features.
-     * Use this to understand what features each platform supports.
+     * Get platform capabilities for coupon features, keyed by platform.
+     *
+     * ⛔ **Returns an empty object today.** Platform coupon capabilities moved
+     * into the standalone connector apps and are not re-exposed here yet, so the
+     * endpoint answers `{}` for every store. Treat a missing key as "unknown",
+     * never as "the platform lacks the feature", and do not index into a platform
+     * key without checking it exists first — there are none to find.
      *
      * @example
      * ```typescript
      * const capabilities = await client.getCouponPlatformCapabilities();
-     * if (!capabilities.SHOPIFY.supportsProductExclusions) {
-     *   console.log('Shopify does not support product exclusions');
+     * const meta = capabilities['GOOGLE'];
+     * if (meta && !meta.supportsProducts) {
+     *   console.log('This platform cannot target individual products');
      * }
      * ```
      */
@@ -9761,7 +10364,7 @@ declare class BrainerceClient {
         /** Modifier-group selections (PRD §7.3 / §8.4). */
         selections?: ModifierSelection[];
         /** Nested-combo selections keyed by parent modifierId. */
-        nestedByModifierId?: Record<string, ModifierSelection[]>;
+        nestedByModifierId?: Record<string, NestedModifierSelection>;
     }): Promise<Cart>;
     /**
      * Smart get cart - returns the current cart (server-side for both guests and logged-in users)
@@ -9918,6 +10521,106 @@ declare class BrainerceClient {
      * ```
      */
     removeCheckoutCoupon(checkoutId: string): Promise<Checkout>;
+    /**
+     * Apply a gift card to a checkout.
+     *
+     * Merchants issue cards from the dashboard, so live codes exist and this field
+     * is worth building. There is still no way for a shopper to BUY a gift card —
+     * no product type, no purchase flow — so every card in circulation was issued
+     * by hand.
+     *
+     * Redemption is deliberately NOT gated on the store's gift-card switch: a
+     * store that turned the feature off still owes every card already in a
+     * customer's hand, so the field keeps working. Build it unconditionally.
+     *
+     * A gift card is a **means of payment, not a discount**. The order total does
+     * not change and tax stays calculated on the full value; what changes is
+     * `providerAmountDue`, the amount the payment provider will be charged.
+     *
+     * Render it as its own line — "Gift card −₪54.50" beside the total — and NOT
+     * by adding it to `discountAmount`. A shopper who sees stored value folded
+     * into a discount is being shown the wrong thing, and so is their receipt.
+     *
+     * Only as much of the card as the order still owes is applied, so a card
+     * larger than the basket leaves a balance on it for next time, and a smaller
+     * one leaves an amount for the provider to charge.
+     *
+     * @example
+     * const { amountApplied, providerAmountDue, tenderId } =
+     *   await client.applyGiftCard('checkout_123', 'A1B2-C3D4-E5F6-G7H8-J9K0');
+     * // total is unchanged; charge the provider providerAmountDue
+     */
+    applyGiftCard(checkoutId: string, code: string): Promise<CheckoutTender>;
+    /**
+     * Remove a previously applied gift card from a checkout.
+     *
+     * Takes the `tenderId` returned by {@link applyGiftCard}, not the code — a
+     * checkout can carry more than one card, and the code is never echoed back.
+     *
+     * The held value goes straight back to the card. Nothing was ever debited
+     * while it was applied, so removing costs the shopper nothing.
+     */
+    removeGiftCard(checkoutId: string, tenderId: string): Promise<{
+        removed: boolean;
+        providerAmountDue: string;
+    }>;
+    /**
+     * Check what is left on a gift card.
+     *
+     * Rate limited, and deliberately uninformative: a code that does not exist,
+     * one that has been disabled and one that has expired all return the SAME
+     * response — `{ balance: '0.00', usable: false }` — and take the same time to
+     * do it. Do not build UI that tries to tell those apart, because the API will
+     * not tell you, by design: a gift-card code is bearer value, and an endpoint
+     * that confirmed which codes were real would be a free way to find them.
+     *
+     * Show "we cannot use this code" and let the shopper re-enter it.
+     */
+    checkGiftCardBalance(code: string): Promise<GiftCardBalance>;
+    /**
+     * Start a donation.
+     *
+     * A donation does not go through the cart. There is no line item, no
+     * quantity, no shipping and no order — a donor names an amount and pays it,
+     * which is a different shape of transaction from a purchase. Do not model a
+     * donation as a product; if you already have, the amount is the giveaway:
+     * you cannot let a donor type one.
+     *
+     * ⛔ A successful return is NOT a completed gift. You get back a PENDING
+     * donation and a provider intent to complete, exactly as with a checkout.
+     * The gift is only real once the provider's webhook confirms it, which is
+     * when the donation reads back as `PAID`. Show a thank-you that reflects
+     * that, and never send a receipt off the back of this call.
+     *
+     * Requires donations to be switched on for the store; a store that has not
+     * turned them on is rejected rather than silently accepting money.
+     *
+     * ```ts
+     * const donation = await brainerce.createDonation({
+     *   amount: 180,
+     *   feeCoverAmount: 6.3,        // offered as a checkbox; most donors accept
+     *   donorEmail: 'sarah@example.com',
+     *   donorName: 'Sarah Cohen',
+     *   tributeType: 'IN_MEMORY',
+     *   tributeName: 'Avraham Cohen',
+     *   returnPath: '/thank-you',
+     * });
+     * // → complete donation.payment with your provider, then poll getDonation()
+     * ```
+     */
+    createDonation(input: CreateDonationInput): Promise<DonationIntent>;
+    /**
+     * Read a donation back — for a thank-you page, and to see whether it is paid.
+     *
+     * Rate limited to 5 requests a minute, because an id that either resolves or
+     * 404s is a way to enumerate them. Poll it a handful of times after the donor
+     * returns from the provider; do not put it behind a 1-second interval.
+     *
+     * The payload is narrow on purpose: no failure reason, and `donorName` comes
+     * back `null` whenever the gift was marked anonymous — so you can render this
+     * straight onto a public page without leaking anything.
+     */
+    getDonation(donationId: string): Promise<PublicDonation>;
     /**
      * Set customer information on checkout
      *
@@ -11014,92 +11717,6 @@ declare class BrainerceClient {
      * Only available in storefront mode
      */
     getMyCart(): Promise<Cart>;
-    /**
-     * Get all Custom API integrations for a store
-     * Requires Admin mode (apiKey)
-     *
-     * @example
-     * ```typescript
-     * const integrations = await client.getCustomApiIntegrations();
-     * integrations.forEach(api => {
-     *   console.log(`${api.name}: ${api.status}`);
-     * });
-     * ```
-     */
-    getCustomApiIntegrations(): Promise<CustomApiIntegration[]>;
-    /**
-     * Get a single Custom API integration by ID
-     * Requires Admin mode (apiKey)
-     *
-     * @example
-     * ```typescript
-     * const api = await client.getCustomApiIntegration('api_123');
-     * console.log(`API: ${api.name}, URL: ${api.baseUrl}`);
-     * ```
-     */
-    getCustomApiIntegration(integrationId: string): Promise<CustomApiIntegration>;
-    /**
-     * Create a new Custom API integration
-     * Requires Admin mode (apiKey)
-     *
-     * @example
-     * ```typescript
-     * const api = await client.createCustomApiIntegration({
-     *   name: 'My External API',
-     *   baseUrl: 'https://api.example.com',
-     *   authType: 'api_key',
-     *   credentials: {
-     *     apiKey: 'sk_123...',
-     *     headerName: 'X-API-Key',
-     *   },
-     *   syncDirection: 'bidirectional',
-     *   syncConfig: {
-     *     products: true,
-     *     orders: true,
-     *     inventory: true,
-     *   },
-     * });
-     * ```
-     */
-    createCustomApiIntegration(data: CreateCustomApiDto): Promise<CustomApiIntegration>;
-    /**
-     * Update a Custom API integration
-     * Requires Admin mode (apiKey)
-     *
-     * @example
-     * ```typescript
-     * const api = await client.updateCustomApiIntegration('api_123', {
-     *   enabled: false,
-     *   syncConfig: { products: true, orders: false, inventory: true },
-     * });
-     * ```
-     */
-    updateCustomApiIntegration(integrationId: string, data: UpdateCustomApiDto): Promise<CustomApiIntegration>;
-    /**
-     * Delete a Custom API integration
-     * Requires Admin mode (apiKey)
-     *
-     * @example
-     * ```typescript
-     * await client.deleteCustomApiIntegration('api_123');
-     * ```
-     */
-    deleteCustomApiIntegration(integrationId: string): Promise<void>;
-    /**
-     * Test connection to a Custom API
-     * Requires Admin mode (apiKey)
-     *
-     * @example
-     * ```typescript
-     * const result = await client.testCustomApiConnection('api_123');
-     * if (result.success) {
-     *   console.log(`Connection OK, latency: ${result.latency}ms`);
-     * } else {
-     *   console.error(`Connection failed: ${result.error}`);
-     * }
-     * ```
-     */
-    testCustomApiConnection(integrationId: string): Promise<CustomApiTestResult>;
     /**
      * Get product availability including reserved quantities.
      * Use this to show accurate stock to customers when reservations are enabled.
@@ -11510,12 +12127,18 @@ declare class BrainerceClient {
      * ```typescript
      * const rate = await client.createZoneShippingRate('zone_123', {
      *   name: 'Standard Shipping',
-     *   type: 'flat',
-     *   price: 5.99,
-     *   minOrderValue: 0,
-     *   estimatedDays: '3-5',
+     *   type: 'FLAT_RATE',
+     *   rateConfig: { amount: 5.99 },
+     *   minDeliveryDays: 3,
+     *   maxDeliveryDays: 5,
      * });
      * ```
+     *
+     * The price lives in `rateConfig`, whose shape follows `type` — `FLAT_RATE`
+     * takes `{ amount }`, `WEIGHT_BASED` and `PRICE_BASED` take tier arrays, and
+     * `FREE` and `LOCAL_PICKUP` take none. Unknown top-level properties are
+     * rejected outright rather than ignored, so a stray `price` or
+     * `estimatedDays` fails the whole call with 400.
      */
     createZoneShippingRate(zoneId: string, data: CreateShippingRateDto): Promise<ShippingRateConfig>;
     /**
@@ -11604,6 +12227,10 @@ declare class BrainerceClient {
      *
      * Returns `appliesTax=false` when tax is disabled, the country is missing,
      * or no active rate covers it.
+     *
+     * The preview has no province, so it only sees country-level rates: a
+     * Canadian estimate shows the federal GST alone and the provincial PST/QST
+     * joins it at checkout. Render `note` so the buyer is not surprised.
      */
     estimateTax(params: {
         country?: string;
@@ -11644,8 +12271,47 @@ declare class BrainerceClient {
     /**
      * Get all tax rates for the store
      * Requires Admin mode (apiKey)
+     *
+     * A jurisdiction can need more than one rate. Canada is the common case: a
+     * country-level `GST` row plus a province-level `PST`/`QST` row, both with
+     * `stackable: true`, which the checkout charges together. Provinces on HST
+     * carry a single combined row with `stackable: false`.
      */
     getTaxRates(): Promise<TaxRate[]>;
+    /**
+     * List the country tax presets available to apply.
+     * Requires Admin mode (apiKey)
+     */
+    getTaxPresets(): Promise<Array<{
+        key: string;
+        country: string;
+        label: string;
+        description: string;
+        rateCount: number;
+    }>>;
+    /**
+     * Apply a country's whole tax table in one call, instead of creating a rate
+     * per province by hand. Requires Admin mode (apiKey).
+     *
+     * `CA` writes ten rates: federal GST 5% country-wide, one combined HST row
+     * each for ON/NB/NL/NS/PE, and PST/RST/QST for BC/SK/MB/QC charged on top of
+     * the GST. Alberta and the territories need no row — the GST covers them.
+     *
+     * Throws 409 when the store already has rates for that country; delete those
+     * first if you meant to replace them. Rates land in the Standard tax class.
+     *
+     * Brainerce does not register the store for GST/HST and does not file returns.
+     *
+     * @example
+     * ```typescript
+     * const { created } = await client.applyTaxPreset('CA'); // created === 10
+     * ```
+     */
+    applyTaxPreset(presetKey: string): Promise<{
+        preset: string;
+        created: number;
+        rates: TaxRate[];
+    }>;
     /**
      * Get a single tax rate by ID
      * Requires Admin mode (apiKey)
@@ -12283,6 +12949,110 @@ declare class BrainerceClient {
      * Requires Admin mode (apiKey)
      */
     deleteOAuthProvider(provider: OAuthProviderType): Promise<void>;
+    /**
+     * Get translation completeness across every translatable entity type, for
+     * one or more locales. Useful as a pre-flight before a bulk import to see
+     * which entity types/locales still need coverage.
+     * Requires Admin mode (apiKey).
+     *
+     * @param storeId - Store to inspect.
+     * @param locales - BCP-47 locale codes to check (e.g. `['he', 'fr']`). Omit
+     *   or pass an empty array to get rows with `total` populated but no
+     *   locale breakdown.
+     *
+     * @example
+     * ```typescript
+     * const status = await client.getTranslationStatus('store_123', ['he', 'fr']);
+     * const blogHe = status.find((s) => s.entityType === 'blogPost' && s.locale === 'he');
+     * console.log(`${blogHe?.missing} blog posts still need Hebrew`);
+     * ```
+     */
+    getTranslationStatus(storeId: string, locales?: string[]): Promise<TranslationStatusEntry[]>;
+    /**
+     * Get every persisted translation for a single entity, keyed by locale.
+     * Requires Admin mode (apiKey).
+     *
+     * @example
+     * ```typescript
+     * const translations = await client.getTranslations('store_123', 'product', 'prod_abc');
+     * console.log(translations.he?.name); // Hebrew product name, if set
+     * ```
+     */
+    getTranslations(storeId: string, entityType: TranslatableEntityType, entityId: string): Promise<TranslationsMap>;
+    /**
+     * Set/update one locale's translation for an entity. Only the fields valid
+     * for `entityType` are persisted (e.g. `title`/`excerpt`/`content` for
+     * `blogPost`, `name`/`description` for `category`) — fields outside that
+     * entity's allowlist are silently ignored server-side, and omitted fields
+     * leave any existing translation for them untouched (this is a merge, not
+     * a replace, of the locale's fields).
+     * Requires Admin mode (apiKey) with `products:write` (or the equivalent
+     * scope for the target entity type).
+     *
+     * @example
+     * ```typescript
+     * // Bulk-import a pre-translated blog post
+     * await client.setTranslation('store_123', 'blogPost', 'post_abc', 'fr', {
+     *   title: 'Le titre en français',
+     *   excerpt: "L'extrait en français",
+     *   content: '<p>Le contenu en français</p>',
+     * });
+     * ```
+     */
+    setTranslation(storeId: string, entityType: TranslatableEntityType, entityId: string, locale: string, fields: SetTranslationFields): Promise<TranslationsMap>;
+    /**
+     * Delete one locale's translation for an entity. The entity's base
+     * (default-locale) fields are unaffected.
+     * Requires Admin mode (apiKey) with `products:write` (or the equivalent
+     * scope for the target entity type).
+     */
+    deleteTranslation(storeId: string, entityType: TranslatableEntityType, entityId: string, locale: string): Promise<void>;
+    /**
+     * AI-translate a single entity into one target locale and persist the
+     * result inline (synchronous — the response already reflects the write).
+     * Only fields that are still empty for `targetLocale` are filled; existing
+     * translated values are never overwritten.
+     * Requires Admin mode (apiKey) with `products:write` (or the equivalent
+     * scope for the target entity type).
+     *
+     * @param sourceFields - Optional override of the source-language text to
+     *   translate from (e.g. unsaved edits from an open editor), instead of the
+     *   entity's persisted base fields. Keys outside the entity's translatable
+     *   field set are ignored.
+     *
+     * @example
+     * ```typescript
+     * const translations = await client.aiTranslateSingle('store_123', {
+     *   entityType: 'product',
+     *   entityId: 'prod_abc',
+     *   targetLocale: 'he',
+     * });
+     * ```
+     */
+    aiTranslateSingle(storeId: string, input: AiTranslateSingleInput): Promise<TranslationsMap>;
+    /**
+     * Bulk AI-translate — enqueues a background job per entity (and, for
+     * `entityType: 'attribute'`, one per attribute option too) rather than
+     * translating inline. Returns the number of jobs queued, not the finished
+     * translations; poll `getTranslationStatus` or `getTranslations` to see
+     * results land.
+     * Requires Admin mode (apiKey) with `products:write` (or the equivalent
+     * scope for the target entity type).
+     *
+     * @param entityIds - Optional explicit ids to translate. Omit to target
+     *   every entity of `entityType` in the store that isn't already fully
+     *   translated for `targetLocale`.
+     *
+     * @example
+     * ```typescript
+     * // Translate every blog post missing French coverage
+     * const { queued } = await client.aiTranslateBulk('store_123', {
+     *   entityType: 'blogPost',
+     *   targetLocale: 'fr',
+     * });
+     * ```
+     */
+    aiTranslateBulk(storeId: string, input: AiTranslateBulkInput): Promise<AiTranslateBulkResult>;
 }
 /**
  * Custom error class for Brainerce API errors
@@ -12293,7 +13063,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "2.0.0";
+declare const SDK_VERSION = "2.0.3";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -12794,4 +13564,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 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 DeliveryType, 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 PaymentRecordStatus, 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 ProductStatus, 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 ReviewStatus, 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 };
+export { type AddToCartDto, type AddressDetailsResult, type AddressSuggestion, type AiTranslateBulkInput, type AiTranslateBulkResult, type AiTranslateSingleInput, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AssignTaxClassDto, type AttachModifierGroupInput, type Attribute, type AttributeDisplayType, type AttributeOption, type AttributeSource, type AutoRegionResponse, 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 CartBundleOfferOfferedProduct, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartItemUnavailableReason, 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 CheckoutTender, 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 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 CreateRegionDto, type CreateReturnLabelDto as CreateReturnLabelInput, type CreateReturnLabelResponse, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateStockAlertInput, type CreateTagDto as CreateTagInput, type CreateTaxClassDto, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type CustomizationFieldOption, type DateAvailabilityConstraints, type DateAvailabilitySurface, type DateFieldParseResult, type DeleteProductResponse, type DeliveryType, 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 GiftCardBalance, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type I18nSettings, 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 LocaleTranslation, type LockedVariant, type LoyaltyBadge, type LoyaltyMembershipPlan, type LoyaltyNextTierSummary, type LoyaltyReward, type LoyaltyRewardRecommendation, 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 NestedModifierSelection, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthErrorCode, 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 PaidMembershipInfo, type ParsedDateFieldValue, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentRecordStatus, 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 ProductReviewImage, type ProductReviewImageAdmin, type ProductSitemapOptions, type ProductStatus, type ProductSuggestion, type ProductUnavailableError, type ProductVariant, type PublicMetafieldDefinition, type PublicRegion, type PublicRegionDetail, type PublicRegionPaymentProvider, type PublicTaxClass, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type RedeemRewardResult, type ReferralInfo, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type Region, type RegionPaymentProvider, type RegisterCustomerDto, type RelativeDateBounds, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type ReturnLabelParcel, type ReviewPhotoUpload, type ReviewStatus, type RichTextContent, SDK_VERSION, type SavedPaymentMethodSummary, 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 SetTranslationFields, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingSummaryEntry, type ShippingZone, type ShippingZoneQueryParams, type SitemapEntry, type StockAlertResponse, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreCapabilities, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type StoreTracking, type StorefrontSavedPaymentMethod, type SubmitProductReviewInput, type SubscribeMarketingInput, type SubscribeMarketingResponse, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxClass, type TaxEstimateResponse, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type TrackingEventItem, type TrackingEventName, type TrackingEventPayload, type TranslatableEntityType, type TranslationStatusEntry, type TranslationsMap, 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 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 UpdateRegionDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxClassDto, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsellSettings, 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 };