brainerce 2.4.0 → 2.7.0

package/dist/index.d.mts

@@ -294,7 +294,7 @@ interface StoreInfo {
      * Marketing tag ids for this sales channel (sales-channel mode only).
      *
      * Resolved server-side from the marketplace apps the merchant already
-     * connected — connecting the Google & YouTube app runs GA4 discovery and the
+     * connected — connecting the Google app runs GA4 discovery and the
      * measurement id lands here on its own; same for the Meta and TikTok pixels.
      * The merchant types nothing, and the storefront needs no redeploy: a newly
      * connected app shows up here within 5 minutes.
@@ -313,7 +313,7 @@ interface StoreInfo {
  * it is safe to interpolate into a tag bootstrap.
  */
 interface StoreTracking {
-    /** GA4 measurement id, `G-XXXXXXX`. Auto-discovered by the Google & YouTube app. */
+    /** GA4 measurement id, `G-XXXXXXX`. Auto-discovered by the Google app. */
     ga4MeasurementId?: string;
     /**
      * Google Tag Manager container id, `GTM-XXXXXX`. The one tag that cannot be
@@ -776,6 +776,52 @@ interface ProductMetafield {
  * platform. Archiving exists for modifier groups and modifiers, not products.
  */
 type ProductStatus = 'active' | 'draft';
+/** One product inside a KIT, as the storefront sees it. Display only. */
+interface KitComponentSummary {
+    productId: string;
+    /** Set when the kit pins one variant of a variable component. */
+    variantId: string | null;
+    /** Component name, variant included when one is pinned. */
+    name: string;
+    sku: string | null;
+    /** Units of this component in ONE kit. A box with two glasses reads `2`. */
+    quantity: number;
+    /** Thumbnail: the pinned variant's image, else the product's first. */
+    image: string | null;
+}
+/** A kit's contents and derived pricing, from `getKitComponents`. */
+interface KitDetail {
+    components: Array<KitComponentSummary & {
+        id: string;
+        position: number;
+        /** Effective unit price of the component. String decimal. */
+        unitPrice: string;
+        /** `null` = not stock-tracked, and never limits the kit. */
+        available: number | null;
+    }>;
+    /** How the kit is priced. */
+    pricingMode: 'FIXED' | 'SUM' | 'SUM_MINUS_PERCENT';
+    /** Percent off the component sum. Only for `SUM_MINUS_PERCENT`. */
+    discountValue: number | null;
+    /** Resolved kit price. String decimal. */
+    price: string;
+    /**
+     * How `price` divides across the components, in order, in MINOR units.
+     * Sums exactly to `price`. This is the taxable amount per component and the
+     * credit amount per component on a refund.
+     */
+    allocationMinor: number[];
+    /** Sellable kits. `null` = unlimited; `0` = not sellable. */
+    available: number | null;
+}
+/** One component slot to write with `setKitComponents`. */
+interface KitComponentWriteInput {
+    componentProductId: string;
+    /** Required when the component product is VARIABLE. */
+    componentVariantId?: string | null;
+    /** Units of this component in ONE kit. */
+    quantity: number;
+}
 interface Product {
     id: string;
     name: string;
@@ -828,6 +874,21 @@ interface Product {
      * single product card always shows the lowest available price. Matches
      * WooCommerce / Shopify storefront semantics. For `SIMPLE` products it is
      * the product's own stored price.
+     *
+     * ⛔ ONE EXCEPTION, and the type does not model it: a `KIT` with nothing
+     * inside it, or one the server could not resolve, comes back from the public
+     * product reads with **no `basePrice` and no `salePrice` at all**, alongside
+     * `kitAvailable: 0`. Such a kit has no price — it resolves to zero, and
+     * returning that zero published a product that costs nothing. The fields are
+     * omitted rather than nulled on purpose: `Number(null)` is `0` and would put
+     * the free price straight back, while `Number(undefined)` is `NaN` and
+     * cannot be mistaken for an amount.
+     *
+     * So guard the kit case before you format: `product.basePrice` is
+     * `string | undefined` in practice, and calling `parseFloat` on it yields
+     * `NaN` for an unsellable kit. It is typed as required because widening it
+     * would be a breaking change for every storefront that reads an ordinary
+     * product's price, which is the overwhelmingly common case.
      */
     basePrice: string;
     /**
@@ -866,12 +927,55 @@ interface Product {
     /** Product status (active, draft). Always returned by backend. */
     status: ProductStatus;
     /**
-     * Catalog structure. `KIT` is a sellable kit ("maaraz") whose price and
-     * availability derive from its component products — it carries no inventory
-     * row of its own, and outside FIXED pricing its `basePrice` is a placeholder.
-     * Treat it as not-directly-purchasable unless you resolve its components.
+     * Catalog structure. `KIT` is a sellable kit ("maaraz") assembled from other
+     * catalog products. It IS directly purchasable: add the KIT'S OWN `productId`
+     * as ONE cart line, with no `variantId` (a kit has no variants and passing
+     * one is rejected) and no modifier `selections`. NEVER add its components as
+     * separate lines — that charges twice and reserves twice. It carries no
+     * inventory row of its own (read `kitAvailable`), and outside FIXED pricing
+     * its stored `basePrice` is a placeholder, though storefront reads overlay it
+     * with the resolved price.
+     *
+     * A kit with NOTHING inside it has no price to overlay: the public reads omit
+     * `basePrice` and `salePrice` entirely and return `kitAvailable: 0`. Do not
+     * coerce the missing price to a number — see `basePrice`.
      */
     type: 'SIMPLE' | 'VARIABLE' | 'KIT';
+    /**
+     * What a KIT contains, returned on the single-product (by slug) read only.
+     * Absent on every other product type and on list responses.
+     *
+     * Render it: a shopper looking at a gift box needs to see what is inside
+     * before buying. These are display rows, NOT separate line items — the kit is
+     * added to the cart as ONE line, and its components are reserved behind the
+     * scenes. Do not add them individually.
+     */
+    kitComponents?: KitComponentSummary[];
+    /**
+     * How many of this KIT can be sold: the component that runs out first decides.
+     * `null` means unlimited (every component untracked). `0` means not sellable,
+     * including a kit with no components. Absent on non-kits — a kit has no
+     * `inventory` block, so this is the field to read for stock.
+     */
+    kitAvailable?: number | null;
+    /**
+     * How this KIT is priced, and therefore whether its prices are real numbers
+     * or placeholders. Absent on non-kits.
+     *
+     * `FIXED` — `basePrice` and `salePrice` are the merchant's own values and
+     * behave exactly like any other product's, sale logic included.
+     * `SUM` / `SUM_MINUS_PERCENT` — the price is recomputed from the components on
+     * every read, so the storefront read overlays `basePrice` with the resolved
+     * figure and returns `salePrice: null`. Never cache a kit price or recompute
+     * one client-side in these modes, and do not present a "was" price: there
+     * isn't one.
+     *
+     * Present in every mode, EXCEPT on a kit the server could not resolve at all
+     * — that one arrives with no pricing mode and no prices, only
+     * `kitAvailable: 0`. Treat a kit with no `basePrice` as not for sale
+     * whatever its mode says.
+     */
+    kitPricingMode?: 'FIXED' | 'SUM' | 'SUM_MINUS_PERCENT';
     /** Whether product is downloadable/digital. */
     isDownloadable?: boolean;
     /** Download files available for this product (when isDownloadable is true) */
@@ -1806,6 +1910,15 @@ interface CreateProductDto {
      * its contents set before it can be sold.
      */
     type?: 'SIMPLE' | 'VARIABLE' | 'KIT';
+    /**
+     * How a `KIT` is priced. `FIXED` (default) — you set `basePrice` and it stays.
+     * `SUM` — the kit costs what its components cost, recomputed on every read.
+     * `SUM_MINUS_PERCENT` — that sum less `kitDiscountValue` percent.
+     * Ignored on `SIMPLE` and `VARIABLE`.
+     */
+    kitPricingMode?: 'FIXED' | 'SUM' | 'SUM_MINUS_PERCENT';
+    /** Percent off the component sum, 0-100. Only for `SUM_MINUS_PERCENT`. */
+    kitDiscountValue?: number;
     isDownloadable?: boolean;
     /** Existing category IDs to assign. Unknown/cross-store IDs are rejected with 400. To assign by name (auto-creating if missing), use `categoryNames`. */
     categories?: string[];
@@ -1927,6 +2040,15 @@ interface BulkCreateProductsError {
     message: string;
 }
 interface UpdateProductDto {
+    /**
+     * How a `KIT` is priced. `FIXED` (default) — you set `basePrice` and it stays.
+     * `SUM` — the kit costs what its components cost, recomputed on every read.
+     * `SUM_MINUS_PERCENT` — that sum less `kitDiscountValue` percent.
+     * Omit to leave the kit's current mode unchanged.
+     */
+    kitPricingMode?: 'FIXED' | 'SUM' | 'SUM_MINUS_PERCENT';
+    /** Percent off the component sum, 0-100. Only for `SUM_MINUS_PERCENT`. */
+    kitDiscountValue?: number;
     name?: string;
     slug?: string;
     sku?: string;
@@ -4419,6 +4541,20 @@ interface AddressDetailsResult {
 }
 interface CompleteCheckoutResponse {
     orderId: string;
+    /** Human-readable order number, e.g. `"ORD-20260907-0012"`. */
+    orderNumber: string;
+    /** Order status after completion. */
+    status: string;
+    /**
+     * Order total as a decimal STRING, e.g. `"46.96"`.
+     *
+     * It was a JSON number until 2026-09-07, which disagreed with the sibling
+     * `POST /v1/orders` and with every other money field on the API. Use
+     * `parseFloat` if you need to compute on it.
+     */
+    total: string;
+    /** Confirmation message, e.g. `"Order created successfully"`. */
+    message: string;
 }
 interface WebhookEvent {
     event: WebhookEventType;
@@ -4497,6 +4633,34 @@ interface UpdateVariantInventoryDto {
     newTotal: number;
     reason?: string;
 }
+/**
+ * `GET /v1/products/{id}/inventory` — the product's inventory state.
+ *
+ * The endpoint returns the whole `InventoryItem`, not just the three counters
+ * it used to be documented as. Its `PUT` sibling has always returned this
+ * shape.
+ *
+ * ⛔ **Two shapes, one status code.** A product with **no inventory row** (and
+ * an id this key cannot see) reads back as the three counters at zero and
+ * nothing else, rather than a 404 — every field below `total` is absent on
+ * that branch. Branch on `id` being present, not on a 404.
+ */
+interface ProductInventoryResponse {
+    /** `total - reserved`. */
+    available: number;
+    reserved: number;
+    total: number;
+    /** The `InventoryItem` id. Absent on the all-zeroes no-row response. */
+    id?: string;
+    productId?: string;
+    trackingMode?: InventoryTrackingMode;
+    /** Backorder policy for this item, e.g. `"NONE"`. */
+    backorderMode?: string;
+    backorderLimit?: number | null;
+    lowStockThreshold?: number | null;
+    lastInventorySyncAt?: string | null;
+    updatedAt?: string;
+}
 interface VariantInventoryResponse {
     trackingMode: InventoryTrackingMode;
     total: number;
@@ -7223,6 +7387,146 @@ interface SubscribeMarketingInput {
 interface SubscribeMarketingResponse {
     ok: true;
 }
+type NewsletterBenefitDiscountKind = 'PERCENTAGE' | 'FIXED_AMOUNT';
+/**
+ * The offer to render beside a newsletter signup field.
+ *
+ * `null` from `marketing.getBenefit()` means the store offers nothing — render
+ * the plain signup form and promise nothing.
+ */
+interface PublicNewsletterBenefitOffer {
+    enabled: boolean;
+    discountType: NewsletterBenefitDiscountKind;
+    /** Percent for PERCENTAGE, an amount in the store currency for FIXED_AMOUNT. */
+    discountValue: number;
+    /** How long the coupon lasts once issued, in days. */
+    validityDays: number;
+    minimumOrderAmount: number | null;
+    /** Cap on the discount a percentage offer can produce. Null for no cap. */
+    maximumDiscount: number | null;
+    /** Restricted to buyers with no previous order. Guest orders count. */
+    firstOrderOnly: boolean;
+    /** Merchant-written, resolved for the requested locale. May be null. */
+    headline: string | null;
+    /** Merchant-written terms, resolved for the requested locale. May be null. */
+    terms: string | null;
+}
+/** Lifecycle of one address's benefit. */
+type NewsletterBenefitGrantState = 'PENDING' | 'ISSUING' | 'ISSUED' | 'EXPIRED' | 'FAILED';
+/** The merchant's configuration, as the admin API returns it. */
+interface NewsletterBenefitSettings {
+    id: string;
+    storeId: string;
+    enabled: boolean;
+    /** Bumped on every save and copied into each new grant. */
+    version: number;
+    discountType: NewsletterBenefitDiscountKind;
+    discountValue: number;
+    minimumOrderAmount: number | null;
+    maximumDiscount: number | null;
+    combinesWithOther: boolean;
+    validityDays: number;
+    eligibilityTtlHours: number;
+    firstOrderOnly: boolean;
+    applicableProducts: string[];
+    excludedProducts: string[];
+    applicableCategories: string[];
+    excludedCategories: string[];
+    /** `salesChannelId` values. Empty means every enabled channel. */
+    salesChannelIds: string[];
+    content: Record<string, {
+        headline?: string;
+        terms?: string;
+    }>;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * A FULL REPLACEMENT, not a patch. Every field is written, so omitting one
+ * clears it rather than leaving it alone.
+ */
+interface UpdateNewsletterBenefitSettingsInput {
+    enabled: boolean;
+    discountType: NewsletterBenefitDiscountKind;
+    /** 1-100 for PERCENTAGE, an amount in the store currency for FIXED_AMOUNT. */
+    discountValue: number;
+    minimumOrderAmount?: number;
+    /** Percentage offers only. Ignored, and stored as null, for a fixed amount. */
+    maximumDiscount?: number;
+    combinesWithOther: boolean;
+    /** 1-365. Counted from issuance, not from the signup. */
+    validityDays: number;
+    /**
+     * 1-8760. How long a signup stays eligible, counted from the moment the form
+     * was submitted.
+     *
+     * ⛔ THE ONLY DEADLINE IN THE FLOW. The confirmation link itself never
+     * expires, so a click after this window still subscribes the address and
+     * earns no coupon.
+     */
+    eligibilityTtlHours: number;
+    firstOrderOnly: boolean;
+    applicableProducts?: string[];
+    excludedProducts?: string[];
+    applicableCategories?: string[];
+    excludedCategories?: string[];
+    /**
+     * `salesChannelId` values the coupon may be redeemed on. Leave empty for
+     * every enabled channel: empty is expanded at issuance, because a coupon with
+     * no channel rows is refused on every vibe-coded storefront.
+     */
+    salesChannelIds?: string[];
+    /** `{ en: { headline, terms }, he: { … } }`. Shown on the form and in the email. */
+    content?: Record<string, {
+        headline?: string;
+        terms?: string;
+    }>;
+}
+/** One row of the issued-benefits list. */
+interface NewsletterBenefitGrant {
+    id: string;
+    email: string;
+    status: NewsletterBenefitGrantState;
+    /** Where the signup came from. A CSV-imported contact never gets a row here. */
+    source: string;
+    couponCode: string | null;
+    /** Derived from the coupon being used, so it is true the moment an order completes. */
+    redeemed: boolean;
+    expiresAt: string | null;
+    /** Deadline for confirming. A click after this subscribes but earns nothing. */
+    eligibleUntil: string | null;
+    confirmedAt: string | null;
+    emailSentAt: string | null;
+    attempts: number;
+    lastError: string | null;
+    settingsVersion: number;
+    createdAt: string;
+}
+/**
+ * Filters for the issued-benefits list.
+ *
+ * ⛔ NO EMAIL FILTER, and the API refuses one. A lookup-by-address would turn a
+ * merchant list into a "does this person shop here" probe for any leaked key.
+ */
+interface ListNewsletterBenefitGrantsParams {
+    page?: number;
+    /** Max 100, like every other paginated list. */
+    limit?: number;
+    status?: NewsletterBenefitGrantState;
+    /** ISO-8601. Signups created on or after this moment. */
+    from?: string;
+    /** ISO-8601. Signups created on or before this moment. */
+    to?: string;
+}
+/** What a resend hands back: the coupon that was re-sent, never a new one. */
+interface ResendNewsletterBenefitResult {
+    code: string;
+    discountType: NewsletterBenefitDiscountKind;
+    discountValue: number;
+    expiresAt: string;
+    minimumOrderAmount: number | null;
+    firstOrderOnly: boolean;
+}
 interface CreateStockAlertInput {
     /** Address to notify. Lowercased and trimmed server-side. */
     email: string;
@@ -8591,6 +8895,57 @@ declare class BrainerceClient {
      * console.log('Product type:', product.type); // 'VARIABLE'
      * ```
      */
+    /**
+     * Read a kit's contents, with its resolved price and how many can be sold.
+     *
+     * A KIT is one purchasable product assembled from other catalog products. It
+     * holds no inventory of its own: `available` is whichever component runs out
+     * first. Outside `FIXED` pricing the product row's `basePrice` is a
+     * placeholder, so use the `price` returned here.
+     *
+     * Safe to call for any product — a non-KIT returns an empty, unsellable
+     * shape rather than throwing, so callers need not branch on product type.
+     *
+     * @example
+     * ```typescript
+     * const kit = await client.getKitComponents('prod_123');
+     * console.log(kit.price, kit.available, kit.components.length);
+     * ```
+     */
+    getKitComponents(productId: string): Promise<KitDetail>;
+    /**
+     * Replace a kit's contents, and optionally how it is priced.
+     *
+     * A full replace, not a patch: send the list you want the kit to end up with.
+     * Omit `pricingMode` to leave the kit's current mode untouched.
+     *
+     * Rejected: a product that is not a KIT, a component from another store, a
+     * component that is itself a KIT, a VARIABLE component with no variant
+     * pinned, a variant that does not belong to its product, the same slot
+     * listed twice, and a component whose product or pinned variant is not
+     * published.
+     *
+     * That last one is checked over the WHOLE list you send, not just the rows
+     * you changed. Once a product already inside a kit is unpublished, no edit
+     * to that kit saves until you publish it again or drop it from the list.
+     *
+     * @example
+     * ```typescript
+     * await client.setKitComponents('prod_123', {
+     *   components: [
+     *     { componentProductId: 'prod_bottle', quantity: 1 },
+     *     { componentProductId: 'prod_glass', quantity: 2 },
+     *   ],
+     *   pricingMode: 'SUM_MINUS_PERCENT',
+     *   discountValue: 10,
+     * });
+     * ```
+     */
+    setKitComponents(productId: string, body: {
+        components: KitComponentWriteInput[];
+        pricingMode?: 'FIXED' | 'SUM' | 'SUM_MINUS_PERCENT';
+        discountValue?: number;
+    }): Promise<KitDetail>;
     convertToVariable(productId: string): Promise<Product>;
     /**
      * Convert a VARIABLE product back to SIMPLE.
@@ -9028,12 +9383,15 @@ declare class BrainerceClient {
      * exist and 404'd silently. The live route is product-scoped:
      * `GET /api/v1/products/:id/inventory`. A product with no inventory row
      * reads back as all zeroes rather than 404ing.
+     *
+     * The response carries the whole {@link ProductInventoryResponse} — the
+     * `InventoryItem` id, `trackingMode`, `backorderMode`, `backorderLimit`,
+     * `lowStockThreshold`, `lastInventorySyncAt` and `updatedAt` alongside the
+     * three counters. It always did; only the three counters were declared.
+     * On the all-zeroes no-row branch everything but the counters is absent,
+     * so test `id` rather than expecting a 404.
      */
-    getInventory(productId: string): Promise<{
-        available: number;
-        reserved: number;
-        total: number;
-    }>;
+    getInventory(productId: string): Promise<ProductInventoryResponse>;
     /**
      * Edit inventory manually with a reason for the audit trail.
      *
@@ -9754,10 +10112,14 @@ declare class BrainerceClient {
      * 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.
+     * **Where the discount goes.** Configure the newsletter welcome offer and the
+     * platform issues the coupon itself: read it with `marketing.getBenefit()`,
+     * show those terms beside the field, and stop there.
+     *
+     * ⛔ DO NOT SHOW A CODE AFTER THIS CALL RESOLVES. No coupon exists yet. It is
+     * minted when the recipient clicks the confirmation link, and it is mailed to
+     * them at that moment — a code rendered here is a code that was never issued.
+     * Say "check your email", the same as for the subscription itself.
      *
      * @example
      * ```typescript
@@ -9773,6 +10135,117 @@ declare class BrainerceClient {
      */
     marketing: {
         subscribe: (input: SubscribeMarketingInput) => Promise<SubscribeMarketingResponse>;
+        /**
+         * The welcome offer to render beside the signup field, or `null` when this
+         * store offers none.
+         *
+         * Show the discount, how long the coupon lasts, any minimum order, whether
+         * it is first-order only, and the merchant's own headline and terms. Then
+         * post to `marketing.subscribe()` and tell the shopper to check their
+         * inbox.
+         *
+         * ⛔ THE COUPON DOES NOT EXIST YET at any point in that sequence. It is
+         * created when the recipient clicks the confirmation link in their email,
+         * and it is mailed to them there. Rendering a code on this screen renders a
+         * code nobody was issued.
+         *
+         * ⛔ Takes no email address and returns nothing about any individual, on
+         * purpose. There is no "has this person already claimed" call, because an
+         * unauthenticated one would be an oracle for who shops here. If you need to
+         * discourage a repeat signup, say the offer is one per address; do not try
+         * to detect it.
+         *
+         * `null` is the common case on a store that never set this up, so handle it
+         * rather than assuming the object. Cache it per page load: it belongs to
+         * the store, not to the visitor.
+         *
+         * Storefront (public) and vibe-coded modes.
+         *
+         * @param locale - Storefront locale, e.g. `"he"`. Picks the language of the
+         *   headline and terms; falls back to the store language when omitted.
+         *
+         * @example
+         * ```typescript
+         * const offer = await brainerce.marketing.getBenefit('he');
+         * if (offer) {
+         *   // "10% הנחה על ההזמנה הראשונה"
+         *   render(offer.headline ?? defaultHeadline(offer), offer.terms);
+         * }
+         * await brainerce.marketing.subscribe({ email, locale: 'he', honeypot });
+         * // → "בדקו את המייל שלכם" — never a coupon code
+         * ```
+         */
+        getBenefit: (locale?: string) => Promise<PublicNewsletterBenefitOffer | null>;
+    };
+    /**
+     * Manage the newsletter welcome offer: the terms merchants configure, and the
+     * benefits that offer has produced.
+     *
+     * Admin mode (`apiKey`) only, on the `coupons:read` / `coupons:write` scopes.
+     * The benefit IS a coupon feature — it mints a Coupon row and the coupon
+     * machinery enforces it — so it carries no scope of its own.
+     *
+     * ⛔ THERE IS NO "ISSUE A BENEFIT TO THIS ADDRESS" CALL, and there will not
+     * be one. A benefit exists because someone submitted the signup form AND
+     * clicked the confirmation link; handing one out directly would skip the
+     * consent the double opt-in exists to collect and break the one-per-address
+     * guarantee that the grant's unique constraint provides. `resend` re-sends a
+     * code that already exists; it never creates one.
+     */
+    newsletterBenefit: {
+        /**
+         * The store's configuration, or `null` when none was ever saved.
+         *
+         * `null` and `{ enabled: false }` are different: never configured, versus
+         * configured and switched off. Both mean "offer nothing" to a storefront.
+         */
+        getSettings: () => Promise<NewsletterBenefitSettings | null>;
+        /**
+         * Create or replace the offer.
+         *
+         * ⛔ A FULL REPLACEMENT, not a patch. Every field is written, so a field you
+         * omit is cleared rather than kept.
+         *
+         * Saving never rewrites a promise already made: signups still waiting for a
+         * confirmation click keep the terms they were shown, and coupons already
+         * issued are untouched. Switching `enabled` off stops new offers and leaves
+         * every issued coupon working until it expires.
+         *
+         * @example
+         * ```typescript
+         * await brainerce.newsletterBenefit.updateSettings({
+         *   enabled: true,
+         *   discountType: 'PERCENTAGE',
+         *   discountValue: 10,
+         *   minimumOrderAmount: 200,
+         *   combinesWithOther: false,
+         *   validityDays: 7,
+         *   eligibilityTtlHours: 168,
+         *   firstOrderOnly: true,
+         *   content: { he: { headline: '10% הנחה על ההזמנה הראשונה' } },
+         * });
+         * ```
+         */
+        updateSettings: (input: UpdateNewsletterBenefitSettingsInput) => Promise<NewsletterBenefitSettings>;
+        /**
+         * Issued benefits, newest first, as `{ data, meta }`.
+         *
+         * ⛔ NO EMAIL FILTER — the API refuses the parameter. Filter the page you
+         * get back rather than asking the server about one address.
+         */
+        listGrants: (params?: ListNewsletterBenefitGrantsParams) => Promise<PaginatedResponse<NewsletterBenefitGrant>>;
+        /**
+         * Re-send one benefit that went astray.
+         *
+         * ⛔ SENDS THE SAME CODE. It never mints a second coupon, so a support
+         * ticket cannot become two discounts. For a benefit whose issuance failed
+         * before any coupon existed, this retries the issuance and mails the result.
+         *
+         * Rejects a signup that has not been confirmed and one that lapsed before a
+         * coupon was minted: there is nothing to re-send in either case, and
+         * nothing that may be created.
+         */
+        resend: (grantId: string) => Promise<ResendNewsletterBenefitResult | null>;
     };
     /**
      * "Email me when this is back."
@@ -9801,10 +10274,20 @@ declare class BrainerceClient {
      * Rich Text, and Page.
      *
      * Works in all three SDK modes (vibe-coded, storefront, admin):
-     *   - **Public reads** (`get`, `list`, `getBySlug`): work in any mode.
-     *   - **Write operations** (`create`, `update`, `publish`, `unpublish`,
-     *     `remove`): admin mode only — they call `/api/content/...` with
-     *     the API key. Calling from storefront / vibe-coded mode throws.
+     *   - **Public reads** (`get`, `list`, `getBySlug`): storefront and
+     *     vibe-coded mode. There is no admin equivalent of a by-key/by-slug
+     *     read — in admin mode they throw and point you at `listAdmin()` /
+     *     `findById()`.
+     *   - **Admin reads** (`listAdmin`, `findById`) and **writes** (`create`,
+     *     `update`, `publish`, `unpublish`, `remove`): admin mode only — they
+     *     call `/api/content/...` with the API key. Calling from storefront /
+     *     vibe-coded mode throws.
+     *
+     * **⚠️ Every admin method takes an explicit `storeId`.** Admin mode has no
+     * ambient store (`storeId` is only set in storefront mode), and the routes
+     * are store-scoped: omitting it is rejected fail-closed by the store scope
+     * guard (`403 STORE_SCOPE_REQUIRED`). Pass the id of the store your API key
+     * is bound to — naming any other store is rejected as cross-tenant.
      *
      * **Default key:** every type has `'main'` as its universal default key.
      * Pass no argument to fetch the main entry; pass a custom key (e.g.
@@ -9829,12 +10312,15 @@ declare class BrainerceClient {
      *   });
      * }
      *
-     * // Admin — create a shipping FAQ in DRAFT
-     * await client.content.faq.create({
-     *   key: 'shipping',
-     *   name: 'Shipping FAQ',
-     *   data: { items: [{ question: '…', answer: '…' }] },
-     * });
+     * // Admin — create a shipping FAQ in DRAFT (storeId is required)
+     * await client.content.faq.create(
+     *   {
+     *     key: 'shipping',
+     *     name: 'Shipping FAQ',
+     *     data: { items: [{ question: '…', answer: '…' }] },
+     *   },
+     *   'store_123'
+     * );
      * ```
      */
     content: {
@@ -9845,10 +10331,17 @@ declare class BrainerceClient {
              * hasn't seeded yet.
              */
             get: (key?: string, locale?: string) => Promise<Content<"FAQ"> | null>;
-            /** List all PUBLISHED entries of this type. */
+            /**
+             * List all PUBLISHED entries of this type (storefront / vibe-coded
+             * mode). In admin mode this throws — use
+             * `client.content.listAdmin({ storeId, type })`.
+             */
             list: (locale?: string) => Promise<Content<"FAQ">[]>;
-            /** Create a new entry in DRAFT (admin mode). */
-            create: (input: Omit<CreateContentInput<"FAQ">, "type">) => Promise<Content<"FAQ">>;
+            /**
+             * Create a new entry in DRAFT (admin mode).
+             * `storeId` is required — see the namespace docs above.
+             */
+            create: (input: Omit<CreateContentInput<"FAQ">, "type">, storeId: string) => Promise<Content<"FAQ">>;
         };
         footer: {
             /**
@@ -9857,10 +10350,17 @@ declare class BrainerceClient {
              * hasn't seeded yet.
              */
             get: (key?: string, locale?: string) => Promise<Content<"FOOTER"> | null>;
-            /** List all PUBLISHED entries of this type. */
+            /**
+             * List all PUBLISHED entries of this type (storefront / vibe-coded
+             * mode). In admin mode this throws — use
+             * `client.content.listAdmin({ storeId, type })`.
+             */
             list: (locale?: string) => Promise<Content<"FOOTER">[]>;
-            /** Create a new entry in DRAFT (admin mode). */
-            create: (input: Omit<CreateContentInput<"FOOTER">, "type">) => Promise<Content<"FOOTER">>;
+            /**
+             * Create a new entry in DRAFT (admin mode).
+             * `storeId` is required — see the namespace docs above.
+             */
+            create: (input: Omit<CreateContentInput<"FOOTER">, "type">, storeId: string) => Promise<Content<"FOOTER">>;
         };
         header: {
             /**
@@ -9869,10 +10369,17 @@ declare class BrainerceClient {
              * hasn't seeded yet.
              */
             get: (key?: string, locale?: string) => Promise<Content<"HEADER"> | null>;
-            /** List all PUBLISHED entries of this type. */
+            /**
+             * List all PUBLISHED entries of this type (storefront / vibe-coded
+             * mode). In admin mode this throws — use
+             * `client.content.listAdmin({ storeId, type })`.
+             */
             list: (locale?: string) => Promise<Content<"HEADER">[]>;
-            /** Create a new entry in DRAFT (admin mode). */
-            create: (input: Omit<CreateContentInput<"HEADER">, "type">) => Promise<Content<"HEADER">>;
+            /**
+             * Create a new entry in DRAFT (admin mode).
+             * `storeId` is required — see the namespace docs above.
+             */
+            create: (input: Omit<CreateContentInput<"HEADER">, "type">, storeId: string) => Promise<Content<"HEADER">>;
         };
         announcement: {
             /**
@@ -9881,10 +10388,17 @@ declare class BrainerceClient {
              * hasn't seeded yet.
              */
             get: (key?: string, locale?: string) => Promise<Content<"ANNOUNCEMENT"> | null>;
-            /** List all PUBLISHED entries of this type. */
+            /**
+             * List all PUBLISHED entries of this type (storefront / vibe-coded
+             * mode). In admin mode this throws — use
+             * `client.content.listAdmin({ storeId, type })`.
+             */
             list: (locale?: string) => Promise<Content<"ANNOUNCEMENT">[]>;
-            /** Create a new entry in DRAFT (admin mode). */
-            create: (input: Omit<CreateContentInput<"ANNOUNCEMENT">, "type">) => Promise<Content<"ANNOUNCEMENT">>;
+            /**
+             * Create a new entry in DRAFT (admin mode).
+             * `storeId` is required — see the namespace docs above.
+             */
+            create: (input: Omit<CreateContentInput<"ANNOUNCEMENT">, "type">, storeId: string) => Promise<Content<"ANNOUNCEMENT">>;
         };
         richText: {
             /**
@@ -9893,10 +10407,17 @@ declare class BrainerceClient {
              * hasn't seeded yet.
              */
             get: (key?: string, locale?: string) => Promise<Content<"RICH_TEXT"> | null>;
-            /** List all PUBLISHED entries of this type. */
+            /**
+             * List all PUBLISHED entries of this type (storefront / vibe-coded
+             * mode). In admin mode this throws — use
+             * `client.content.listAdmin({ storeId, type })`.
+             */
             list: (locale?: string) => Promise<Content<"RICH_TEXT">[]>;
-            /** Create a new entry in DRAFT (admin mode). */
-            create: (input: Omit<CreateContentInput<"RICH_TEXT">, "type">) => Promise<Content<"RICH_TEXT">>;
+            /**
+             * Create a new entry in DRAFT (admin mode).
+             * `storeId` is required — see the namespace docs above.
+             */
+            create: (input: Omit<CreateContentInput<"RICH_TEXT">, "type">, storeId: string) => Promise<Content<"RICH_TEXT">>;
         };
         page: {
             /**
@@ -9911,62 +10432,191 @@ declare class BrainerceClient {
              * hasn't seeded yet.
              */
             get: (key?: string, locale?: string) => Promise<Content<"PAGE"> | null>;
-            /** List all PUBLISHED entries of this type. */
+            /**
+             * List all PUBLISHED entries of this type (storefront / vibe-coded
+             * mode). In admin mode this throws — use
+             * `client.content.listAdmin({ storeId, type })`.
+             */
             list: (locale?: string) => Promise<Content<"PAGE">[]>;
-            /** Create a new entry in DRAFT (admin mode). */
-            create: (input: Omit<CreateContentInput<"PAGE">, "type">) => Promise<Content<"PAGE">>;
+            /**
+             * Create a new entry in DRAFT (admin mode).
+             * `storeId` is required — see the namespace docs above.
+             */
+            create: (input: Omit<CreateContentInput<"PAGE">, "type">, storeId: string) => Promise<Content<"PAGE">>;
         };
-        /** Find a single row by its admin id (admin mode). */
-        findById: <T_1 extends ContentType = ContentType>(id: string) => Promise<Content<T_1>>;
-        /** List rows in admin mode with optional filters. */
-        listAdmin: <T_1 extends ContentType = ContentType>(filters?: {
+        /**
+         * Find a single row by its admin id (admin mode).
+         *
+         * @example
+         * ```typescript
+         * const row = await client.content.findById('cnt_123', 'store_123');
+         * ```
+         */
+        findById: <T_1 extends ContentType = ContentType>(id: string, storeId: string) => Promise<Content<T_1>>;
+        /**
+         * List rows in admin mode. `storeId` is required; `type` and `status`
+         * are optional filters.
+         *
+         * @example
+         * ```typescript
+         * const faqs = await client.content.listAdmin({
+         *   storeId: 'store_123',
+         *   type: 'FAQ',
+         *   status: 'DRAFT',
+         * });
+         * ```
+         */
+        listAdmin: <T_1 extends ContentType = ContentType>(filters: {
+            storeId: string;
             type?: T_1;
             status?: "DRAFT" | "PUBLISHED";
         }) => Promise<Array<Content<T_1>>>;
-        /** Replace `data` (and optional metadata) on an existing row. */
-        update: <T_1 extends ContentType>(id: string, input: UpdateContentInput<T_1>) => Promise<Content<T_1>>;
-        /** Transition status DRAFT → PUBLISHED. */
-        publish: (id: string) => Promise<Content>;
-        /** Transition status PUBLISHED → DRAFT. */
-        unpublish: (id: string) => Promise<Content>;
-        /** Hard delete the row. Admin mode only. */
-        remove: (id: string) => Promise<void>;
+        /**
+         * Replace `data` (and optional metadata) on an existing row.
+         *
+         * @example
+         * ```typescript
+         * await client.content.update('cnt_123', { name: 'Shipping FAQ' }, 'store_123');
+         * ```
+         */
+        update: <T_1 extends ContentType>(id: string, input: UpdateContentInput<T_1>, storeId: string) => Promise<Content<T_1>>;
+        /**
+         * Transition status DRAFT → PUBLISHED.
+         *
+         * @example
+         * ```typescript
+         * await client.content.publish('cnt_123', 'store_123');
+         * ```
+         */
+        publish: (id: string, storeId: string) => Promise<Content>;
+        /**
+         * Transition status PUBLISHED → DRAFT.
+         *
+         * @example
+         * ```typescript
+         * await client.content.unpublish('cnt_123', 'store_123');
+         * ```
+         */
+        unpublish: (id: string, storeId: string) => Promise<Content>;
+        /**
+         * Hard delete the row. Admin mode only.
+         *
+         * @example
+         * ```typescript
+         * await client.content.remove('cnt_123', 'store_123');
+         * ```
+         */
+        remove: (id: string, storeId: string) => Promise<void>;
     };
     /**
      * Read and manage blog posts.
      *
+     * **⚠️ Every admin call takes an explicit `storeId`.** Admin mode has no
+     * ambient store (`storeId` is only set in storefront mode) and the admin
+     * routes are store-scoped: omitting it is rejected fail-closed by the store
+     * scope guard (`403 STORE_SCOPE_REQUIRED`). Pass the id of the store your
+     * API key is bound to — naming any other store is rejected as cross-tenant.
+     *
+     * Admin lookups are **by id**, not by slug (`getPost(slug)` is a public read
+     * and throws in admin mode — use `findById(id, storeId)`).
+     *
      * ```typescript
      * // Storefront / vibe-coded: list published posts
      * const { data: posts } = await brainerce.blog.getPosts({ category: 'news' });
      *
-     * // Fetch one by slug
+     * // Fetch one by slug (storefront / vibe-coded)
      * const post = await brainerce.blog.getPost('my-first-post');
      *
-     * // Admin: create a draft
-     * const draft = await brainerce.blog.create({ title: 'Hello World' });
+     * // Admin: list, read one, and create a draft
+     * const all = await brainerce.blog.getPosts({}, 'store_123');
+     * const one = await brainerce.blog.findById('post_123', 'store_123');
+     * const draft = await brainerce.blog.create({ title: 'Hello World' }, 'store_123');
      * ```
      */
     blog: {
         /**
-         * List published posts. Works in all modes.
-         * Filters: `category`, `tag`, `page`, `limit`.
+         * List posts. Filters: `category`, `tag`, `page`, `limit`.
+         *
+         * Storefront / vibe-coded mode lists PUBLISHED posts and ignores
+         * `storeId` (the store is already in the base URL). Admin mode lists
+         * drafts too and REQUIRES `storeId`.
+         *
+         * @example
+         * ```typescript
+         * const { data } = await client.blog.getPosts({ category: 'news' });      // storefront
+         * const { data } = await client.blog.getPosts({}, 'store_123');           // admin
+         * ```
          */
-        getPosts: (params?: BlogPostListParams) => Promise<BlogPostListResponse>;
+        getPosts: (params?: BlogPostListParams, storeId?: string) => Promise<BlogPostListResponse>;
         /**
-         * Fetch one published post by its slug. Returns `null` on 404.
-         * Works in all modes.
+         * Fetch one PUBLISHED post by its slug. Returns `null` on 404.
+         *
+         * Storefront / vibe-coded mode only — the admin API has no by-slug
+         * lookup (`GET /api/blog/posts/:id` is by id), so this throws in admin
+         * mode rather than issuing a request that can only 404.
+         *
+         * @example
+         * ```typescript
+         * const post = await client.blog.getPost('my-first-post');
+         * ```
          */
         getPost: (slug: string) => Promise<BlogPost | null>;
-        /** Create a blog post in DRAFT status. Admin mode only. */
-        create: (input: CreateBlogPostInput) => Promise<BlogPost>;
-        /** Update a blog post by ID. Admin mode only. */
-        update: (id: string, input: UpdateBlogPostInput) => Promise<BlogPost>;
-        /** Transition status → PUBLISHED (sets publishedAt = now if unset). Admin mode only. */
-        publish: (id: string) => Promise<BlogPost>;
-        /** Transition status PUBLISHED → DRAFT. Admin mode only. */
-        unpublish: (id: string) => Promise<BlogPost>;
-        /** Hard-delete a blog post. Admin mode only. */
-        remove: (id: string) => Promise<void>;
+        /**
+         * Fetch one post by its admin id — drafts included. Admin mode only.
+         * Returns `null` on 404.
+         *
+         * @example
+         * ```typescript
+         * const post = await client.blog.findById('post_123', 'store_123');
+         * ```
+         */
+        findById: (id: string, storeId: string) => Promise<BlogPost | null>;
+        /**
+         * Create a blog post in DRAFT status. Admin mode only.
+         *
+         * @example
+         * ```typescript
+         * const draft = await client.blog.create({ title: 'Hello World' }, 'store_123');
+         * ```
+         */
+        create: (input: CreateBlogPostInput, storeId: string) => Promise<BlogPost>;
+        /**
+         * Update a blog post by ID. Admin mode only.
+         *
+         * @example
+         * ```typescript
+         * await client.blog.update('post_123', { title: 'Renamed' }, 'store_123');
+         * ```
+         */
+        update: (id: string, input: UpdateBlogPostInput, storeId: string) => Promise<BlogPost>;
+        /**
+         * Transition status → PUBLISHED (sets publishedAt = now if unset).
+         * Admin mode only.
+         *
+         * @example
+         * ```typescript
+         * await client.blog.publish('post_123', 'store_123');
+         * ```
+         */
+        publish: (id: string, storeId: string) => Promise<BlogPost>;
+        /**
+         * Transition status PUBLISHED → DRAFT. Admin mode only.
+         *
+         * @example
+         * ```typescript
+         * await client.blog.unpublish('post_123', 'store_123');
+         * ```
+         */
+        unpublish: (id: string, storeId: string) => Promise<BlogPost>;
+        /**
+         * Hard-delete a blog post. Admin mode only.
+         *
+         * @example
+         * ```typescript
+         * await client.blog.remove('post_123', 'store_123');
+         * ```
+         */
+        remove: (id: string, storeId: string) => Promise<void>;
     };
     /**
      * Submit a contact inquiry from a storefront contact form.
@@ -13079,41 +13729,43 @@ declare class BrainerceClient {
      * ```
      */
     uploadReviewPhoto(productId: string, file: File | Blob): Promise<ReviewPhotoUpload>;
+    /** The message every team method throws. One string so they cannot drift. */
+    private teamIsDashboardOnly;
     /**
-     * @deprecated Retiring, but there is no API-key replacement yet: `getStoreTeam`
-     * is dashboard-only (403 for api_key). Keep using this until one ships.
+     * @deprecated Retiring, but this ALWAYS throws: `/v1/team/*` rejects the
+     * api_key principal and `getStoreTeam` is dashboard-only. Use the dashboard.
      */
     getTeamMembers(): Promise<TeamMembersResponse>;
     /**
-     * @deprecated Retiring, but there is no API-key replacement yet: `getStoreTeam`
-     * is dashboard-only (403 for api_key). Keep using this until one ships.
+     * @deprecated Retiring, but this ALWAYS throws: `/v1/team/*` rejects the
+     * api_key principal and `getStoreTeam` is dashboard-only. Use the dashboard.
      */
     getTeamInvitations(): Promise<TeamInvitationsResponse>;
     /**
-     * @deprecated Retiring, but there is no API-key replacement yet: `inviteStoreMember`
-     * is dashboard-only (403 for api_key). Keep using this until one ships.
+     * @deprecated Retiring, but this ALWAYS throws: `/v1/team/*` rejects the
+     * api_key principal and the store-level route is dashboard-only. Use the dashboard.
      */
-    inviteTeamMember(data: InviteMemberDto): Promise<TeamInvitation>;
+    inviteTeamMember(_data: InviteMemberDto): Promise<TeamInvitation>;
     /**
-     * @deprecated Retiring, but there is no API-key replacement yet: `resendStoreInvitation`
-     * is dashboard-only (403 for api_key). Keep using this until one ships.
+     * @deprecated Retiring, but this ALWAYS throws: `/v1/team/*` rejects the
+     * api_key principal and the store-level route is dashboard-only. Use the dashboard.
      */
-    resendTeamInvitation(invitationId: string): Promise<TeamInvitation>;
+    resendTeamInvitation(_invitationId: string): Promise<TeamInvitation>;
     /**
-     * @deprecated Retiring, but there is no API-key replacement yet: `revokeStoreInvitation`
-     * is dashboard-only (403 for api_key). Keep using this until one ships.
+     * @deprecated Retiring, but this ALWAYS throws: `/v1/team/*` rejects the
+     * api_key principal and the store-level route is dashboard-only. Use the dashboard.
      */
-    revokeTeamInvitation(invitationId: string): Promise<void>;
+    revokeTeamInvitation(_invitationId: string): Promise<void>;
     /**
-     * @deprecated Retiring, but there is no API-key replacement yet: `updateStoreMember`
-     * is dashboard-only (403 for api_key). Keep using this until one ships.
+     * @deprecated Retiring, but this ALWAYS throws: `/v1/team/*` rejects the
+     * api_key principal and the store-level route is dashboard-only. Use the dashboard.
      */
-    updateTeamMemberRole(memberId: string, data: UpdateMemberRoleDto): Promise<TeamMember>;
+    updateTeamMemberRole(_memberId: string, _data: UpdateMemberRoleDto): Promise<TeamMember>;
     /**
-     * @deprecated Retiring, but there is no API-key replacement yet: `removeStoreMember`
-     * is dashboard-only (403 for api_key). Keep using this until one ships.
+     * @deprecated Retiring, but this ALWAYS throws: `/v1/team/*` rejects the
+     * api_key principal and the store-level route is dashboard-only. Use the dashboard.
      */
-    removeTeamMember(memberId: string): Promise<void>;
+    removeTeamMember(_memberId: string): Promise<void>;
     /**
      * Every store-level team operation is dashboard-only.
      *
@@ -13534,7 +14186,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "2.4.0";
+declare const SDK_VERSION = "2.7.0";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -14035,4 +14687,4 @@ interface CategorySitemapOptions {
  */
 declare function getCategorySitemapEntries(client: BrainerceClient, opts: CategorySitemapOptions): Promise<SitemapEntry[]>;
 
-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 GiftCardAdmin, type GiftCardAdminDetail, type GiftCardBalance, type GiftCardLiability, type GiftCardTransaction, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type I18nSettings, type IdempotentRequestOptions, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type IssueGiftCardAdminDto, type IssuedGiftCardAdmin, 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 ReissuedGiftCardAdmin, 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 };
+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 GiftCardAdmin, type GiftCardAdminDetail, type GiftCardBalance, type GiftCardLiability, type GiftCardTransaction, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type I18nSettings, type IdempotentRequestOptions, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type IssueGiftCardAdminDto, type IssuedGiftCardAdmin, type JsonLdOptions, type ListModifierGroupsParams, type ListNewsletterBenefitGrantsParams, 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 NewsletterBenefitDiscountKind, type NewsletterBenefitGrant, type NewsletterBenefitGrantState, type NewsletterBenefitSettings, 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 ProductInventoryResponse, 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 PublicNewsletterBenefitOffer, 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 ReissuedGiftCardAdmin, type RelativeDateBounds, type ResendNewsletterBenefitResult, 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 UpdateNewsletterBenefitSettingsInput, 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 };