brainerce 2.5.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
@@ -874,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;
     /**
@@ -920,6 +935,10 @@ interface Product {
      * 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';
     /**
@@ -950,6 +969,11 @@ interface Product {
      * 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. */
@@ -4517,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;
@@ -4595,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;
@@ -7321,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;
@@ -8715,8 +8921,13 @@ declare class BrainerceClient {
      *
      * 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, and the same slot
-     * listed twice.
+     * 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
@@ -9172,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.
      *
@@ -9898,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
@@ -9917,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."
@@ -13857,7 +14186,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "2.5.0";
+declare const SDK_VERSION = "2.7.0";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -14358,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 };