brainerce 2.1.0 → 2.3.0

package/dist/index.d.ts

@@ -579,8 +579,25 @@ interface LoyaltyNextTierSummary extends LoyaltyTierSummary {
 interface LoyaltyStatus {
     /** Whether the customer has a membership in the program. */
     enrolled: boolean;
-    /** Redeemable points balance (pending earns excluded). */
+    /** Redeemable points balance (pending earns excluded — see `pendingPoints`). */
     pointsBalance: number;
+    /**
+     * Points already earned but still inside the program's return window, so not
+     * yet spendable and NOT counted in `pointsBalance`.
+     *
+     * ⛔ Render this whenever it is above zero. A shopper who just ordered has
+     * their points here, not in the balance, and a panel that shows only
+     * `pointsBalance` tells them "0" the day they bought something — which reads
+     * as a broken programme rather than a waiting period.
+     */
+    pendingPoints: number;
+    /**
+     * When `pendingPoints` becomes spendable — the nightly confirm run after the
+     * oldest pending earn's window closes. ISO 8601, or null when nothing is
+     * pending. Later pending earns confirm on their own later dates; this is the
+     * next date on which the balance goes up.
+     */
+    pendingPointsConfirmAt: string | null;
     /** Total points ever earned (confirmed). */
     lifetimeEarned: number;
     /** Program display config, or null when the store has no loyalty program. */
@@ -589,6 +606,12 @@ interface LoyaltyStatus {
         pointsName: string;
         /** Points needed to redeem one unit of store currency. */
         currencyRatio: number;
+        /**
+         * Days a new earn stays pending before it can be spent — the merchant's
+         * return window. Use it to explain the wait ("points arrive 14 days after
+         * your order"); use `pendingPointsConfirmAt` for the actual date.
+         */
+        pendingDays: number;
         status: 'DRAFT' | 'ACTIVE' | 'PAUSED';
     } | null;
     /** The customer's current tier, or null if untiered / no tiers configured. */
@@ -842,7 +865,13 @@ interface Product {
     displayCurrency?: string;
     /** Product status (active, draft). Always returned by backend. */
     status: ProductStatus;
-    type: 'SIMPLE' | 'VARIABLE';
+    /**
+     * 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.
+     */
+    type: 'SIMPLE' | 'VARIABLE' | 'KIT';
     /** Whether product is downloadable/digital. */
     isDownloadable?: boolean;
     /** Download files available for this product (when isDownloadable is true) */
@@ -1651,7 +1680,7 @@ interface ProductQueryParams {
      *  `salePrice` stay in the store currency. Display-only — checkout still
      *  charges in the store currency. */
     regionId?: string;
-    type?: 'SIMPLE' | 'VARIABLE';
+    type?: 'SIMPLE' | 'VARIABLE' | 'KIT';
     isDownloadable?: boolean;
 }
 /**
@@ -1675,7 +1704,7 @@ interface ProductSuggestion {
     basePrice: string;
     /** Sale price as string. Use parseFloat() for calculations. */
     salePrice?: string | null;
-    type: 'SIMPLE' | 'VARIABLE';
+    type: 'SIMPLE' | 'VARIABLE' | 'KIT';
 }
 /**
  * Category node in the tree returned by `getCategories()`.
@@ -1771,7 +1800,12 @@ interface CreateProductDto {
     salePrice?: number;
     costPrice?: number;
     status?: ProductStatus;
-    type?: 'SIMPLE' | 'VARIABLE';
+    /**
+     * `KIT` creates an EMPTY kit. It is not purchasable until components are
+     * added — this endpoint cannot carry them, so a kit created here still needs
+     * its contents set before it can be sold.
+     */
+    type?: 'SIMPLE' | 'VARIABLE' | 'KIT';
     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[];
@@ -2010,6 +2044,31 @@ interface Order {
      * order reads `"paid"` with no provider behind it.
      */
     financialStatus?: string | null;
+    /**
+     * Gift cards that settled part of this order.
+     *
+     * `total` is what the order was WORTH; these are what actually paid for it.
+     * A receipt showing only the total tells a customer they handed over money
+     * they did not — so render each tender as its own line and, when there is at
+     * least one, an "amount charged" figure of `total` minus their sum.
+     *
+     * Empty or absent on an order paid entirely by card or cash. Snapshotted at
+     * order creation, so this is a historical record: it does not change if the
+     * gift card is later adjusted, disabled or re-issued.
+     */
+    tenders?: Array<{
+        id: string;
+        /** `GIFT_CARD` today. The field exists so a second internal tender type does not break callers. */
+        type: string;
+        /** What this tender paid, in `currencyBase`. Decimal string. */
+        amountBase: string;
+        currencyBase: string;
+        /** Last four of the code. The full code is stored as an HMAC and cannot be returned. */
+        giftCard?: {
+            id: string;
+            codeLast4: string;
+        } | null;
+    }>;
     /** Fulfillment status: "unfulfilled", "partial", "fulfilled". */
     fulfillmentStatus?: string | null;
     /** Tracking number, e.g., "1Z999AA10123456784". */
@@ -2180,7 +2239,10 @@ interface OrderQueryParams {
      * not model. Cast if you need to filter by a label id.
      */
     status?: OrderStatus;
-    sortBy?: 'createdAt' | 'totalAmount';
+    /** Mirrors `VALID_ORDER_SORT` (orders.service.ts:674), the allowlist that
+     *  actually gates this — the v1 route takes `sortBy` as a bare string with no
+     *  `@IsEnum`, so the service set is the contract. */
+    sortBy?: 'createdAt' | 'totalAmount' | 'status';
     sortOrder?: 'asc' | 'desc';
 }
 interface CreateOrderDto {
@@ -2299,7 +2361,12 @@ interface CouponQueryParams {
     status?: CouponStatus;
     type?: CouponType;
     platform?: ConnectorPlatform;
-    sortBy?: 'code' | 'createdAt' | 'updatedAt' | 'value';
+    /**
+     * Mirrors the `@IsIn` on `coupon-query.dto.ts:44` exactly. It previously
+     * offered `'value'`, which the API rejects with a 400, and omitted three
+     * members it accepts.
+     */
+    sortBy?: 'code' | 'createdAt' | 'updatedAt' | 'startsAt' | 'endsAt' | 'usageCount';
     sortOrder?: 'asc' | 'desc';
 }
 interface CreateCouponDto {
@@ -3664,6 +3731,136 @@ interface SelectPickupLocationDto {
  * 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.
  */
+/**
+ * A gift card as the admin API returns it.
+ *
+ * The full code is NOT here and never will be: only an HMAC of it is stored, so
+ * there is nothing to return. `maskedCode` and `codeLast4` are the whole of what
+ * can be shown after issuance.
+ */
+interface GiftCardAdmin {
+    id: string;
+    /** `••••-••••-••••-••••-V2D3`. */
+    maskedCode: string;
+    codeLast4: string;
+    /** Decimal strings, all of them. These are balances; never parse them to float for arithmetic. */
+    initialAmount: string;
+    /** Settled value on the card. */
+    balance: string;
+    /** Reserved by a checkout in progress and not available to spend. */
+    heldAmount: string;
+    /** `balance - heldAmount` — what a shopper could actually use right now. */
+    spendable: string;
+    currency: string;
+    status: 'ACTIVE' | 'DISABLED' | 'REVOKED';
+    customerId: string | null;
+    recipientEmail: string | null;
+    expiresAt: string | null;
+    /**
+     * Always `null` today. Nothing stamps it: there is no expiry job anywhere in
+     * the platform, and no `EXPIRE` ledger row is ever written. Expiry is enforced
+     * at read time instead — branch on `expired`, never on this. The balance is
+     * deliberately NOT zeroed when a card lapses.
+     */
+    expiredAt: string | null;
+    /** Derived at read time, so it is true the moment validity lapses. */
+    expired: boolean;
+    createdAt: string;
+}
+/** One movement of value. The ledger is append-only — nothing here is ever rewritten. */
+interface GiftCardTransaction {
+    id: string;
+    /**
+     * `EXPIRE` is declared for a write-off that does not exist yet: nothing in the
+     * platform writes one, for the same reason nothing stamps
+     * {@link GiftCardAdmin.expiredAt}. Handle it — the union is the contract — but
+     * do not build a report that expects to find any.
+     */
+    type: 'ISSUE' | 'REDEEM' | 'REFUND' | 'ADJUST' | 'EXPIRE';
+    /** Signed decimal string. Negative debits the card. */
+    amount: string;
+    balanceAfter: string;
+    orderId: string | null;
+    actorUserId: string | null;
+    note: string | null;
+    createdAt: string;
+}
+/** A card with its full history. */
+interface GiftCardAdminDetail extends GiftCardAdmin {
+    recipientName: string | null;
+    orderId: string | null;
+    transactions: GiftCardTransaction[];
+}
+/**
+ * Outstanding liability for a store — the figure reconciled at month-end close.
+ *
+ * Reported PER CURRENCY. Balances in different currencies do not add up, so the
+ * top-level figures cover one currency and `byCurrency` carries the rest.
+ * Expired value is separate and is NOT written off: whether expiry extinguishes
+ * the obligation is an open legal question, so it is never folded into either
+ * side.
+ */
+interface GiftCardLiability {
+    active: string;
+    held: string;
+    expiredNotWrittenOff: string;
+    currency: string | null;
+    byCurrency: Array<{
+        currency: string;
+        active: string;
+        held: string;
+        expiredNotWrittenOff: string;
+    }>;
+    /** Whether the store may issue at all. Redemption is NOT gated on this. */
+    enabled: boolean;
+}
+/**
+ * The response to issuing or re-issuing.
+ *
+ * ⚠️ `plaintextCode` is returned EXACTLY ONCE. Persist it from this response or
+ * deliver it now — it is stored only as an HMAC and no API, dashboard or
+ * database query can produce it again.
+ */
+interface IssuedGiftCardAdmin {
+    giftCardId: string;
+    plaintextCode: string;
+    last4: string;
+}
+/** Re-issue also reports what moved across from the card it revoked. */
+interface ReissuedGiftCardAdmin extends IssuedGiftCardAdmin {
+    movedAmount: string;
+    /** Where the replacement was emailed, or null if the merchant must hand it over. */
+    deliveredTo: string | null;
+}
+/**
+ * Per-call options for a write that the server accepts an `Idempotency-Key` on.
+ *
+ * The SDK sends the value as the HTTP header; it never goes in the request body,
+ * because the backend DTOs reject unknown properties. Without a key a retried
+ * timeout runs the write twice — on a gift-card issue that means a second card
+ * and a second real liability nobody asked for.
+ *
+ * Any string up to 255 characters. Use one the caller can reproduce for the
+ * SAME logical operation (an order id, a support-ticket id, a UUID you stored
+ * before the first attempt) — a fresh random key on every retry defeats the
+ * whole mechanism. Keys are remembered for 24 hours and are scoped to the API
+ * key, so two integrations cannot collide.
+ */
+interface IdempotentRequestOptions {
+    idempotencyKey?: string;
+}
+interface IssueGiftCardAdminDto {
+    /** Decimal string, e.g. "200.00". Must be greater than zero. */
+    amount: string;
+    /** REQUIRED. Written to the ledger — issuing value with no stated reason is not auditable. */
+    note: string;
+    customerId?: string;
+    /** ISO 8601. Must be in the future. Omit for a card that never expires. */
+    expiresAt?: string;
+    recipientEmail?: string;
+    recipientName?: string;
+    personalMessage?: string;
+}
 interface CheckoutTender {
     /** Pass this to `removeGiftCard` — a checkout can carry more than one card. */
     tenderId: string;
@@ -6707,7 +6904,7 @@ interface ProductRecommendation {
     basePrice: string;
     salePrice: string | null;
     images: ProductImage[];
-    type: 'SIMPLE' | 'VARIABLE';
+    type: 'SIMPLE' | 'VARIABLE' | 'KIT';
     inventory?: InventoryInfo | null;
     relationType: ProductRelationType;
     /** Pinned variant of the target (VARIABLE only); null = customer chooses. */
@@ -7807,6 +8004,13 @@ declare class BrainerceClient {
      * Clear the customer token (logout)
      */
     clearCustomerToken(): void;
+    /**
+     * Turn an `idempotencyKey` option into the header the backend reads.
+     *
+     * Returns `undefined` when there is no key, so the header is absent rather
+     * than empty — the interceptor rejects a present-but-blank key with a 400.
+     */
+    private idempotencyHeaders;
     /**
      * Make a request to the Admin API (requires apiKey)
      */
@@ -8392,13 +8596,18 @@ declare class BrainerceClient {
      */
     convertToSimple(productId: string): Promise<Product>;
     /**
-     * Publish a product to specific platforms
+     * Publish a product to specific platforms.
      *
-     * @example
-     * ```typescript
-     * const result = await client.publishProduct('prod_123', ['SHOPIFY', 'WOOCOMMERCE']);
-     * console.log('Publish results:', result.results);
-     * ```
+     * **Not callable.** The API-key `/v1` surface has no `products/:id/publish`
+     * route. Platform publishing for products exists only on the dashboard
+     * surface (`POST /api/products/:id/publish?storeId=`,
+     * `products.controller.ts:556`), which resolves the acting user from a
+     * dashboard session an API key does not carry. The generic trigger
+     * `POST /v1/sync` answers `501 Not Implemented` and points at per-resource
+     * publish endpoints — and products have none.
+     *
+     * {@link publishProductToSalesChannel} is a DIFFERENT operation: it controls
+     * visibility on a vibe-coded storefront, not a push to an external platform.
      */
     publishProduct(productId: string, platforms: string[]): Promise<PublishProductResponse>;
     /**
@@ -9582,7 +9791,7 @@ declare class BrainerceClient {
      * 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/v1/content/...` with
+     *     `remove`): admin mode only — they call `/api/content/...` with
      *     the API key. Calling from storefront / vibe-coded mode throws.
      *
      * **Default key:** every type has `'main'` as its universal default key.
@@ -9923,6 +10132,9 @@ declare class BrainerceClient {
      * flags reflect the live state. Call this on cart load if you want to
      * surface drift to the customer before they reach checkout.
      *
+     * **Storefront and vibe-coded modes only.** There is no admin (`apiKey`)
+     * route for this, so an admin-mode client throws instead of 404ing.
+     *
      * @example
      * ```typescript
      * const cart = await client.recalculateCart('cart_123');
@@ -9938,6 +10150,9 @@ declare class BrainerceClient {
      * subsequent `createCheckout` call will then succeed (it would otherwise
      * throw `PRICE_DRIFT`).
      *
+     * **Storefront and vibe-coded modes only.** There is no admin (`apiKey`)
+     * route for this, so an admin-mode client throws instead of 404ing.
+     *
      * @example
      * ```typescript
      * try {
@@ -10577,6 +10792,137 @@ declare class BrainerceClient {
      * Show "we cannot use this code" and let the shopper re-enter it.
      */
     checkGiftCardBalance(code: string): Promise<GiftCardBalance>;
+    /**
+     * List gift cards.
+     *
+     * `search` matches the LAST FOUR of a code or part of a recipient email. It
+     * cannot match a full code: only an HMAC is stored, so there is nothing to
+     * search against.
+     *
+     * Requires `gift_cards:read`.
+     */
+    listGiftCards(params?: {
+        page?: number;
+        limit?: number;
+        /** `all` | `active` | `withBalance` | `expired` | `disabled` */
+        filter?: string;
+        search?: string;
+    }): Promise<PaginatedResponse<GiftCardAdmin>>;
+    /**
+     * Outstanding gift card liability, per currency.
+     *
+     * This is the month-end number. Read `byCurrency` if the store sells in more
+     * than one — currencies are never summed together.
+     *
+     * Requires `gift_cards:read`.
+     */
+    getGiftCardLiability(): Promise<GiftCardLiability>;
+    /**
+     * One gift card with its full ledger.
+     *
+     * Requires `gift_cards:read`.
+     */
+    getGiftCard(giftCardId: string): Promise<GiftCardAdminDetail>;
+    /**
+     * Issue a gift card.
+     *
+     * ⚠️ **The code comes back exactly once.** It is stored only as an HMAC, so
+     * this response is the only time it exists in readable form anywhere. Persist
+     * it or deliver it before you discard the response — no later call, dashboard
+     * screen or database query can recover it.
+     *
+     * A `note` is required. Refused when gift cards are switched off for the
+     * store.
+     *
+     * ⚠️ **Pass an `idempotencyKey`.** It is the ONLY recovery that exists here:
+     * re-sending the identical request with the same key inside 24 hours replays
+     * the cached response, code included. Without one, a retried timeout mints a
+     * SECOND card and a second real liability. The key is sent as the
+     * `Idempotency-Key` header; reuse the same value across retries of the same
+     * logical issue, never a fresh random one.
+     *
+     * Requires `gift_cards:issue`.
+     *
+     * @example
+     * ```typescript
+     * const card = await client.issueGiftCard(
+     *   {
+     *     amount: '200.00',
+     *     note: 'Compensation for order #1042',
+     *     recipientEmail: 'dana@example.com',
+     *   },
+     *   { idempotencyKey: 'compensation-order-1042' }
+     * );
+     * await sendToCustomer(card.plaintextCode); // your only chance
+     * ```
+     */
+    issueGiftCard(data: IssueGiftCardAdminDto, options?: IdempotentRequestOptions): Promise<IssuedGiftCardAdmin>;
+    /**
+     * Re-issue a gift card onto a new code.
+     *
+     * The answer to a customer losing their code. Mints a new code, moves the
+     * WHOLE balance to it, and REVOKES the old card.
+     *
+     * **This is not a resend.** The old code stops working the moment this
+     * returns — if the customer still holds a printed card, it dies. Refused
+     * while a checkout holds value on the card. The original expiry carries
+     * forward, so this cannot be used to restart an expiry clock.
+     *
+     * The new code is returned exactly once, under the same rules as issuance —
+     * so pass an `idempotencyKey` here for the same reason, and with the same
+     * force: a retried timeout without one revokes the replacement it just made
+     * and mints another.
+     *
+     * Requires `gift_cards:issue`.
+     */
+    reissueGiftCard(giftCardId: string, note: string, options?: IdempotentRequestOptions): Promise<ReissuedGiftCardAdmin>;
+    /**
+     * Adjust a gift card balance.
+     *
+     * `delta` is a SIGNED decimal string: `"25.00"` adds, `"-25.00"` takes away.
+     * The `note` is required and is written to the ledger permanently — it is the
+     * row a finance review reads a year from now.
+     *
+     * A debit cannot take the balance below what live checkout holds have already
+     * reserved; that refusal names the held amount so you can act on it.
+     *
+     * Pass an `idempotencyKey`: an adjustment is a relative move, so a retried
+     * timeout without one applies the delta twice.
+     *
+     * Requires `gift_cards:adjust`.
+     */
+    adjustGiftCardBalance(giftCardId: string, delta: string, note: string, options?: IdempotentRequestOptions): Promise<{
+        balanceAfter: string;
+    }>;
+    /**
+     * Enable, disable or revoke one gift card.
+     *
+     * Deliberately does NOT touch live holds: a checkout that already reserved
+     * value settles normally, because pulling it out from under a shopper
+     * mid-payment would strand a provider charge already in flight. Disabling
+     * stops NEW holds, which is what "off" actually means.
+     *
+     * Requires `gift_cards:write`.
+     */
+    setGiftCardStatus(giftCardId: string, status: 'ACTIVE' | 'DISABLED' | 'REVOKED', options?: IdempotentRequestOptions): Promise<{
+        success: true;
+    }>;
+    /**
+     * Disable or reactivate many gift cards at once.
+     *
+     * `REVOKED` is not accepted here — it belongs to re-issue, which moves the
+     * balance to a replacement first. Revoking in bulk would strand balances with
+     * nowhere to go. Cards already revoked are skipped, so the returned count is
+     * the honest one and may be lower than the ids you sent.
+     *
+     * There is no bulk delete, here or anywhere: the ledger is append-only and a
+     * card may carry a statutory retention life.
+     *
+     * Requires `gift_cards:write`.
+     */
+    bulkSetGiftCardStatus(giftCardIds: string[], status: 'ACTIVE' | 'DISABLED', options?: IdempotentRequestOptions): Promise<{
+        updated: number;
+    }>;
     /**
      * Start a donation.
      *
@@ -10785,6 +11131,9 @@ declare class BrainerceClient {
     /**
      * Set delivery type on checkout (shipping or pickup).
      *
+     * **Storefront and vibe-coded modes only.** There is no admin (`apiKey`)
+     * route for this, so an admin-mode client throws instead of 404ing.
+     *
      * @example
      * ```typescript
      * const checkout = await client.setDeliveryType('checkout_123', 'pickup');
@@ -10796,6 +11145,9 @@ declare class BrainerceClient {
      * This sets the delivery type to "pickup", records customer info, and prepares for payment.
      * Equivalent to setShippingAddress + selectShippingMethod for delivery orders.
      *
+     * **Storefront and vibe-coded modes only.** There is no admin (`apiKey`)
+     * route for this, so an admin-mode client throws instead of 404ing.
+     *
      * @example
      * ```typescript
      * const checkout = await client.selectPickupLocation('checkout_123', {
@@ -11487,13 +11839,17 @@ declare class BrainerceClient {
      * lifetime earned, the program's display config, earned milestone `badges`,
      * and the `paidMembership` subscription state (null for free members).
      * Requires customerToken. Only available in storefront mode. `program` is
-     * null when the store has no loyalty program.
+     * null when the store has no loyalty program. `pointsBalance` excludes points
+     * still inside the return window - those are in `pendingPoints`, and a panel
+     * that ignores them shows a shopper 0 the day they order.
      *
      * @example
      * ```typescript
      * client.setCustomerToken(auth.token);
      * const status = await client.getLoyaltyStatus();
      * if (status.enrolled) console.log(`${status.pointsBalance} ${status.program?.pointsName}`);
+     * // Points from an order just placed are in pendingPoints, NOT pointsBalance.
+     * if (status.pendingPoints > 0) console.log(`+${status.pendingPoints} on ${status.pendingPointsConfirmAt}`);
      * status.badges?.forEach((b) => console.log(`🏅 ${b.name}`));
      * if (status.paidMembership?.status === 'ACTIVE') showPremiumPerks(status.paidMembership.plan);
      * ```
@@ -11881,8 +12237,20 @@ declare class BrainerceClient {
      */
     createTag(data: CreateTagDto): Promise<Tag>;
     /**
-     * Update an existing tag
-     * Requires Admin mode (apiKey)
+     * Update an existing tag.
+     *
+     * **Not callable.** The API-key `/v1` surface serves `GET`, `POST` and
+     * `DELETE` on tags (`external-api.controller.ts:3276`, `:3310`, `:3331`) but
+     * no update verb — `PATCH /api/v1/tags/:id` 404'd silently. Tag editing lives
+     * only on the dashboard surface (`PATCH /api/stores/:storeId/tags/:id`,
+     * `tags.controller.ts:127`), which needs a `storeId` in the path that this
+     * signature does not carry, and resolves the acting user from a dashboard
+     * session an API key does not have.
+     *
+     * Edit the tag in the Brainerce dashboard. {@link deleteTag} +
+     * {@link createTag} is NOT an equivalent workaround: it drops the tag's
+     * product assignments, and `CreateTagDto` has no `translations` field, so any
+     * per-locale names are lost too.
      */
     updateTag(tagId: string, data: UpdateTagDto): Promise<Tag>;
     /**
@@ -11944,13 +12312,26 @@ declare class BrainerceClient {
      */
     createAttributeOption(attributeId: string, data: CreateAttributeOptionDto): Promise<AttributeOption>;
     /**
-     * Update an attribute option
-     * Requires Admin mode (apiKey)
+     * Update an attribute option.
+     *
+     * **Not callable.** The API-key `/v1` surface serves attribute options for
+     * list and create only (`external-api.controller.ts:3517`, `:3543`); there is
+     * no per-option route, so this 404'd silently. Editing an option lives on the
+     * dashboard surface (`PUT /api/stores/:storeId/attributes/:id/options/:optionId`,
+     * `attributes.controller.ts:132` — note it is `PUT` there, not `PATCH`), which
+     * needs a path `storeId` this signature does not carry.
+     *
+     * Edit the option in the Brainerce dashboard.
      */
     updateAttributeOption(attributeId: string, optionId: string, data: UpdateAttributeOptionDto): Promise<AttributeOption>;
     /**
-     * Delete an attribute option
-     * Requires Admin mode (apiKey)
+     * Delete an attribute option.
+     *
+     * **Not callable.** Same gap as {@link updateAttributeOption}: the `/v1`
+     * surface has no per-option route. Deleting an option lives on the dashboard
+     * surface (`DELETE /api/stores/:storeId/attributes/:id/options/:optionId`,
+     * `attributes.controller.ts:145`), which needs a path `storeId` this signature
+     * does not carry.
      */
     deleteAttributeOption(attributeId: string, optionId: string): Promise<void>;
     /**
@@ -12430,16 +12811,37 @@ declare class BrainerceClient {
      */
     setMetafieldPlatforms(definitionId: string, data: SetMetafieldPlatformsDto): Promise<MetafieldDefinition>;
     /**
-     * Publish a metafield definition to a vibe-coded site (admin mode).
-     * @example
-     * ```typescript
-     * await client.publishMetafieldDefinitionToVibeCodedSite('def_123', 'conn_456');
-     * ```
+     * Publish a metafield definition to a sales channel (admin mode).
+     *
+     * **Not callable.** This asked for `publish-vibe-coded`, which is a
+     * deprecated backend alias, not the canonical route. The canonical spelling
+     * is `publish-sales-channel`, and the `/v1` surface serves it for products
+     * (`external-api.controller.ts:862`), coupons (`:947`), customers (`:1548`),
+     * categories (`:3039`), brands (`:3211`) and tags (`:3349`) — but NOT for
+     * metafield definitions. Both spellings 404 there.
+     *
+     * The operation exists only on the dashboard surface
+     * (`POST /api/stores/:storeId/metafield-definitions/:id/publish-sales-channel`,
+     * `metafields.controller.ts:190`), which needs a path `storeId` this signature
+     * does not carry.
+     *
+     * Publish the definition to a sales channel from the Brainerce dashboard. A
+     * definition with no publishes stays visible to every sales channel of the
+     * store, so leaving it unpublished is the permissive default, not a lockout.
      */
     publishMetafieldDefinitionToVibeCodedSite(definitionId: string, vibeCodedConnectionId: string): Promise<{
         success: boolean;
     }>;
-    /** Unpublish a metafield definition from a vibe-coded site (admin mode). */
+    /**
+     * Unpublish a metafield definition from a sales channel (admin mode).
+     *
+     * **Not callable.** Same gap as
+     * {@link publishMetafieldDefinitionToVibeCodedSite} — the `/v1` surface
+     * carries no per-sales-channel routes for metafield definitions under either
+     * the canonical `unpublish-sales-channel` spelling or the deprecated
+     * `unpublish-vibe-coded` alias. The dashboard route is
+     * `metafields.controller.ts:217`.
+     */
     unpublishMetafieldDefinitionFromVibeCodedSite(definitionId: string, vibeCodedConnectionId: string): Promise<{
         success: boolean;
     }>;
@@ -12562,13 +12964,28 @@ declare class BrainerceClient {
     deleteProductMetafield(productId: string, definitionId: string): Promise<void>;
     /**
      * Get customization fields assigned to a product.
-     * Requires Admin mode (apiKey).
+     *
+     * **Not callable.** The API-key `/v1` surface has no
+     * `metafield-definitions/products/:productId/customization-fields` route, so
+     * this 404'd silently. It exists only on the dashboard surface
+     * (`GET /api/stores/:storeId/metafield-definitions/products/:productId/customization-fields`,
+     * `metafields.controller.ts:277`), which needs a path `storeId` this signature
+     * does not carry.
+     *
+     * {@link getProductMetafields} is the closest working call — it returns the
+     * metafield VALUES stored on a product over
+     * `GET /api/v1/products/:productId/metafields`, not the customer-input field
+     * definitions attached to it.
      */
     getProductCustomizationFields(productId: string): Promise<ProductCustomizationField[]>;
     /**
      * Set customization fields for a product (replaces all existing assignments).
-     * Only definitions marked as `isCustomerInput: true` can be assigned.
-     * Requires Admin mode (apiKey).
+     *
+     * **Not callable.** Same gap as {@link getProductCustomizationFields}: the
+     * `/v1` surface carries no customization-field routes. The dashboard route is
+     * `PATCH /api/stores/:storeId/metafield-definitions/products/:productId/customization-fields`
+     * (`metafields.controller.ts:298`), which needs a path `storeId` this
+     * signature does not carry.
      */
     setProductCustomizationFields(productId: string, definitionIds: string[]): Promise<ProductCustomizationField[]>;
     /**
@@ -12685,6 +13102,22 @@ declare class BrainerceClient {
      * is dashboard-only (403 for api_key). Keep using this until one ships.
      */
     removeTeamMember(memberId: string): Promise<void>;
+    /**
+     * Every store-level team operation is dashboard-only.
+     *
+     * `store-team.controller.ts:53` carries `DashboardOnlyGuard`, which rejects
+     * `api_key` and `app_installation` principals outright, so no SDK caller can
+     * reach these however the URL is spelled. They additionally pointed at
+     * `/api/v1/stores/:storeId/team*`, and `@Controller('v1')`
+     * (external-api.controller.ts:181) has no `stores` root — so what they
+     * actually returned was a 404, not the 403 you would expect from the guard.
+     *
+     * Throwing beats either status code: a 404 reads as "wrong id" and a 403 as
+     * "missing permission", and both send the caller looking for a fix that does
+     * not exist. Use the account-level `getTeamMembers()` family, or the
+     * dashboard.
+     */
+    private dashboardOnlyTeamOperation;
     /**
      * Get the team for a specific store (members + pending invitations)
      * Requires Admin mode (apiKey) and MANAGE_TEAM permission
@@ -12694,7 +13127,7 @@ declare class BrainerceClient {
      * const { members, invitations } = await client.getStoreTeam('store_id');
      * ```
      */
-    getStoreTeam(storeId: string): Promise<StoreTeamResponse>;
+    getStoreTeam(_storeId: string): Promise<StoreTeamResponse>;
     /**
      * Invite a new member to a store
      * Requires Admin mode (apiKey) and MANAGE_TEAM permission
@@ -12710,7 +13143,7 @@ declare class BrainerceClient {
      * });
      * ```
      */
-    inviteStoreMember(storeId: string, data: InviteStoreMemberDto): Promise<StoreInvitation>;
+    inviteStoreMember(_storeId: string, _data: InviteStoreMemberDto): Promise<StoreInvitation>;
     /**
      * Update a store team member's role and/or permissions
      * Requires Admin mode (apiKey) and MANAGE_TEAM permission
@@ -12726,7 +13159,7 @@ declare class BrainerceClient {
      * });
      * ```
      */
-    updateStoreMember(storeId: string, memberId: string, data: UpdateStoreMemberDto): Promise<StoreMember>;
+    updateStoreMember(_storeId: string, _memberId: string, _data: UpdateStoreMemberDto): Promise<StoreMember>;
     /**
      * Replace the set of vibe-coded sales channels a store member is restricted to.
      * Channels are identified by their public `connectionId` (`vc_*` format). Pass
@@ -12746,22 +13179,22 @@ declare class BrainerceClient {
      * });
      * ```
      */
-    updateStoreMemberSalesChannels(storeId: string, memberId: string, data: UpdateStoreMemberSalesChannelsDto): Promise<StoreMember>;
+    updateStoreMemberSalesChannels(_storeId: string, _memberId: string, _data: UpdateStoreMemberSalesChannelsDto): Promise<StoreMember>;
     /**
      * Remove a member from a store team
      * Requires Admin mode (apiKey) and MANAGE_TEAM permission
      */
-    removeStoreMember(storeId: string, memberId: string): Promise<void>;
+    removeStoreMember(_storeId: string, _memberId: string): Promise<void>;
     /**
      * Resend a store invitation email
      * Requires Admin mode (apiKey) and MANAGE_TEAM permission
      */
-    resendStoreInvitation(storeId: string, invitationId: string): Promise<StoreInvitation>;
+    resendStoreInvitation(_storeId: string, _invitationId: string): Promise<StoreInvitation>;
     /**
      * Revoke a store invitation
      * Requires Admin mode (apiKey) and MANAGE_TEAM permission
      */
-    revokeStoreInvitation(storeId: string, invitationId: string): Promise<void>;
+    revokeStoreInvitation(_storeId: string, _invitationId: string): Promise<void>;
     /**
      * Get public invitation details by token (no auth required)
      * Used on the invitation acceptance page
@@ -12798,7 +13231,18 @@ declare class BrainerceClient {
      * }
      * ```
      */
-    getMyStorePermissions(storeId: string): Promise<UserStorePermissions>;
+    getMyStorePermissions(_storeId: string): Promise<UserStorePermissions>;
+    /**
+     * `/me/*` answers "who am I and what can I reach", which only a real user can
+     * ask. `UserContextController` (store-team.controller.ts:246) is guarded by
+     * `DashboardOnlyGuard` for a load-bearing reason its own G16 comment spells
+     * out: both routes resolve access purely from `@CurrentUserId()`, which is
+     * `undefined` for an api_key principal, so the store filter would be stripped
+     * and every store on the platform returned. The guard is the control. These
+     * also pointed at `/api/v1/me/*`, which no controller serves, so the observed
+     * failure was a 404 rather than the guard's 403.
+     */
+    private dashboardOnlyUserContext;
     /**
      * Get email settings for the store
      * Requires Admin mode (apiKey)
@@ -12896,6 +13340,21 @@ declare class BrainerceClient {
      * @param resolution - 'MERGE' to link to existing product, 'CREATE_NEW' to create new product
      */
     resolveSyncConflict(conflictId: string, resolution: SyncConflictResolution): Promise<SyncConflict>;
+    /**
+     * Sync conflicts were never implemented on the server.
+     *
+     * There is no `sync-conflict` route anywhere in the backend — not under
+     * `@Controller('v1')`, not on any other controller. These two methods have
+     * called a URL that has never existed, and `SyncConflict` /
+     * `SyncConflictResolution` / `ResolveSyncConflictDto` are exported types with
+     * no producer. The METAFIELD conflict siblings below are real
+     * (external-api.controller.ts:4788, :4802) and are easy to mistake for these.
+     *
+     * Kept as throwing stubs rather than deleted: removing exported methods from a
+     * published package is a breaking change, and a caller who has been swallowing
+     * a 404 deserves to be told why.
+     */
+    private syncConflictsNotImplemented;
     /**
      * Get pending metafield conflicts for the store
      * Requires Admin mode (apiKey)
@@ -13063,7 +13522,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "2.0.3";
+declare const SDK_VERSION = "2.3.0";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -13564,4 +14023,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 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 };
+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 };