brainerce 2.0.0 → 2.0.2

package/dist/index.d.mts

@@ -14,7 +14,7 @@ interface BrainerceClientOptions {
     salesChannelId?: string;
     /**
      * @deprecated Use `salesChannelId` instead. `connectionId` is kept as a
-     * backwards-compatible alias and will be removed in SDK 2.0.
+     * backwards-compatible alias. It is permanent and is not scheduled for removal.
      */
     connectionId?: string;
     /**
@@ -202,13 +202,13 @@ interface StoreInfo {
     socialLinks?: Record<string, string> | null;
     /** Sales Channel ID (sales-channel mode only) */
     salesChannelId?: string;
-    /** @deprecated alias of `salesChannelId` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `salesChannelId` — not scheduled for removal */
     connectionId?: string;
     /** Store name (sales-channel mode only - same as name) */
     storeName?: string;
     /** Sales channel status (sales-channel mode only) */
     salesChannelStatus?: string;
-    /** @deprecated alias of `salesChannelStatus` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `salesChannelStatus` — not scheduled for removal */
     status?: string;
     /** Allowed API scopes (sales-channel mode only) */
     allowedScopes?: string[];
@@ -765,7 +765,7 @@ interface Product {
         attribute: {
             id: string;
             name: string;
-            displayType?: string;
+            displayType?: AttributeDisplayType;
             translations?: Record<string, Record<string, string>> | null;
         } | null;
         attributeOption: {
@@ -785,14 +785,14 @@ interface Product {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -2144,14 +2144,14 @@ interface Coupon {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -3886,7 +3886,7 @@ interface WebhookEvent {
     data: unknown;
     timestamp: string;
 }
-type WebhookEventType = 'product.created' | 'product.updated' | 'product.deleted' | 'inventory.updated' | 'order.created' | 'order.updated' | 'coupon.created' | 'coupon.updated' | 'coupon.deleted' | 'cart.created' | 'cart.updated' | 'cart.abandoned' | 'checkout.started' | 'checkout.completed' | 'checkout.failed';
+type WebhookEventType = 'order.created' | 'order.updated' | 'order.paid' | 'order.fulfilled' | 'order.cancelled' | 'order.refunded' | 'customer.created' | 'customer.updated' | 'customer.deleted' | 'product.created' | 'product.updated' | 'product.deleted' | 'inventory.updated' | 'inventory.low' | 'checkout.completed' | 'checkout.abandoned' | 'payment.succeeded' | 'payment.failed' | 'payment.refunded' | 'blog.post.published' | 'blog.post.updated';
 type VariantStatus = 'active' | 'draft';
 interface CreateVariantDto {
     sku?: string;
@@ -4697,14 +4697,14 @@ interface Category {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -4785,14 +4785,14 @@ interface Brand {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -4854,14 +4854,14 @@ interface Tag {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -4890,6 +4890,11 @@ interface UpdateTagDto {
  * Attribute source type
  */
 type AttributeSource = 'GLOBAL' | 'PLATFORM';
+/**
+ * How an attribute's options render as swatches on the storefront.
+ * `'DEFAULT'` is a plain text/dropdown option list.
+ */
+type AttributeDisplayType = 'DEFAULT' | 'COLOR_SWATCH' | 'IMAGE_SWATCH' | 'MIXED_SWATCH';
 /**
  * Attribute for product variations
  */
@@ -4898,7 +4903,7 @@ interface Attribute {
     accountId: string;
     storeId?: string | null;
     name: string;
-    displayType?: string;
+    displayType?: AttributeDisplayType;
     source: AttributeSource;
     platform?: ConnectorPlatform | null;
     externalId?: string | null;
@@ -4930,7 +4935,7 @@ interface AttributeOption {
 }
 interface CreateAttributeDto {
     name: string;
-    displayType?: string;
+    displayType?: AttributeDisplayType;
     source: AttributeSource;
     platform?: ConnectorPlatform;
     storeId?: string;
@@ -4940,7 +4945,7 @@ interface CreateAttributeDto {
 }
 interface UpdateAttributeDto {
     name?: string;
-    displayType?: string;
+    displayType?: AttributeDisplayType;
     platformMetadata?: Record<string, unknown>;
     isActive?: boolean;
 }
@@ -5125,6 +5130,72 @@ interface ShippingZoneQueryParams {
     sortBy?: string;
     sortOrder?: 'asc' | 'desc';
 }
+/**
+ * Parcel override for a return label. Omit to use the installed shipping
+ * app's configured defaults — what the customer packs a return into is
+ * rarely what left the warehouse.
+ */
+interface ReturnLabelParcel {
+    length?: string;
+    width?: string;
+    height?: string;
+    weight?: string;
+    distanceUnit?: 'in' | 'cm';
+    massUnit?: 'lb' | 'oz' | 'g' | 'kg';
+}
+/**
+ * Buy a return label for an order: the customer ships, the merchant receives.
+ * See {@link BrainerceClient.createReturnLabel}.
+ *
+ * There is no `rateId` here, unlike a normal shipment. A return is a distinct
+ * kind of shipment at the carrier, fixed when it is created and not amendable
+ * afterwards, so it cannot be rate-shopped first — this quotes and buys in
+ * one call. `preferredCarrier` / `preferredService` are the only steering;
+ * omit both and the cheapest rate wins, with the response reporting what was
+ * actually billed.
+ *
+ * The merchant's carrier account pays. There is no mechanism for charging the
+ * customer for return postage — the cost lands on
+ * {@link CreateReturnLabelResponse.rate} so it can be deducted from a refund
+ * deliberately rather than absorbed silently.
+ */
+interface CreateReturnLabelDto {
+    /** Parcel dimensions for the return. Defaults to the shipping app config. */
+    parcel?: ReturnLabelParcel;
+    /**
+     * Label file format. `'PDF'` prints from a browser, which is what a
+     * customer needs; `'ZPL'`/`'EPL'` drive warehouse thermal printers.
+     * Defaults to `'PDF'`. If the carrier cannot produce the requested format
+     * it returns its closest match rather than failing the purchase.
+     */
+    labelFormat?: 'PDF' | 'PNG' | 'ZPL' | 'EPL';
+    /** Preferred carrier slug (e.g. `'USPS'`). Falls back to the cheapest rate. */
+    preferredCarrier?: string;
+    /** Preferred service slug (e.g. `'GroundAdvantage'`). Falls back to the cheapest rate. */
+    preferredService?: string;
+    /**
+     * The outbound `Shipment.id` this return reverses. Recorded on the return
+     * for the merchant's own records; not required, since a return can predate
+     * any shipment record.
+     */
+    returnForShipmentId?: string;
+    /** Why the customer is returning it. Stored on the shipment, shown to the merchant. */
+    reason?: string;
+}
+/** Response from {@link BrainerceClient.createReturnLabel}. */
+interface CreateReturnLabelResponse {
+    shipmentId: string;
+    labelUrl: string;
+    trackingNumber: string;
+    carrier: string;
+    /**
+     * What the merchant's carrier account was billed for this return. `null`
+     * only when the app reported no usable figure — the label is real either
+     * way, and showing nothing beats showing a guess.
+     */
+    rate: string | null;
+    rateCurrency: string | null;
+}
 /**
  * Tax rate configuration
  */
@@ -5507,14 +5578,14 @@ interface MetafieldDefinition {
             name: string;
             connectionId: string;
         };
-        /** @deprecated alias of `salesChannel` — will be removed in SDK 2.0 */
+        /** @deprecated permanent back-compat alias of `salesChannel` — not scheduled for removal */
         connection?: {
             id: string;
             name: string;
             connectionId: string;
         };
     }>;
-    /** @deprecated alias of `channelPublishes` — will be removed in SDK 2.0 */
+    /** @deprecated permanent back-compat alias of `channelPublishes` — not scheduled for removal */
     vibeCodedPublishes?: Array<{
         salesChannel: {
             id: string;
@@ -7046,6 +7117,75 @@ interface BlogPostListResponse {
         totalPages: number;
     };
 }
+/**
+ * Entity types that carry a `translations` JSON blob and are reachable via
+ * the Translations admin API (`client.getTranslations`, `setTranslation`,
+ * `deleteTranslation`, `aiTranslateSingle`, `aiTranslateBulk`,
+ * `getTranslationStatus`).
+ */
+type TranslatableEntityType = 'store' | 'product' | 'category' | 'brand' | 'tag' | 'variant' | 'attribute' | 'attributeOption' | 'metafield' | 'metafieldDefinition' | 'contactForm' | 'contactFormField' | 'modifierGroup' | 'modifier' | 'bundleOffer' | 'orderBump' | 'discountRule' | 'blogPost';
+/** One locale's translated field values for an entity. `undefined`/missing keys fall back to the base (default-locale) field. */
+type LocaleTranslation = Record<string, string | undefined>;
+/** All persisted translations for one entity, keyed by BCP-47 locale (e.g. `"he"`, `"fr-CA"`). */
+type TranslationsMap = Record<string, LocaleTranslation>;
+/**
+ * Body for `setTranslation`. Only the fields valid for the target
+ * `entityType` are persisted server-side (e.g. `blogPost` accepts
+ * `title`/`excerpt`/`content`/`seoTitle`/`seoDescription`/`slug`; `category`
+ * accepts `name`/`description`/`slug`) — passing others is a silent no-op,
+ * not an error. Omitted fields leave the existing translation untouched.
+ */
+interface SetTranslationFields {
+    name?: string;
+    description?: string;
+    title?: string;
+    excerpt?: string;
+    content?: string;
+    seoTitle?: string;
+    seoDescription?: string;
+    slug?: string;
+}
+/** Input for `aiTranslateSingle`. */
+interface AiTranslateSingleInput {
+    entityType: TranslatableEntityType;
+    entityId: string;
+    /** BCP-47 locale code, e.g. `"he"`, `"fr-CA"`. */
+    targetLocale: string;
+    /**
+     * Optional in-flight source text (e.g. unsaved editor state) to translate
+     * from instead of the entity's persisted base fields. Keys must match the
+     * entity's translatable fields (e.g. `seoDescription`, not `metaDescription`);
+     * unrecognized keys are ignored.
+     */
+    sourceFields?: Record<string, string>;
+}
+/** Input for `aiTranslateBulk`. */
+interface AiTranslateBulkInput {
+    /** Bulk-supported types: `product`, `category`, `brand`, `tag`, `attribute`, `modifierGroup`, `metafieldDefinition`, `blogPost`. */
+    entityType: TranslatableEntityType;
+    /** Explicit ids to translate. Omitted = every entity of `entityType` in the store missing a complete translation for `targetLocale`. */
+    entityIds?: string[];
+    /** BCP-47 locale code, e.g. `"he"`, `"fr-CA"`. Must differ from the store's default language. */
+    targetLocale: string;
+}
+/** Result of `aiTranslateBulk` — job count, not finished translations (the work runs async). */
+interface AiTranslateBulkResult {
+    queued: number;
+}
+/** One row of `getTranslationStatus`'s per-entity-type, per-locale breakdown. */
+interface TranslationStatusEntry {
+    entityType: TranslatableEntityType;
+    /** BCP-47 locale code this row's counts apply to. */
+    locale: string;
+    /** Total entities of this type in the store (exact count, not sampled). */
+    total: number;
+    /** Entities with every translatable field filled for `locale`. */
+    translated: number;
+    /** Entities with some but not all translatable fields filled for `locale`. */
+    partial: number;
+    /** Entities with no translation for `locale` at all. */
+    missing: number;
+}
 /**
  * Payload for `client.trackEvent()` — the programmatic counterpart to the
  * `t.js` script-tag pixel. Every field is optional; the server degrades
@@ -7118,8 +7258,9 @@ declare function getDirectionForLocale(locale: string | undefined | null): 'ltr'
  * const client = new BrainerceClient({ salesChannelId: 'vc_abc123...' });
  * const products = await client.getProducts();
  * ```
- * (`connectionId` is a deprecated alias of `salesChannelId`. It still works but
- * logs a deprecation warning on every construction and is removed in SDK 2.0.)
+ * (`connectionId` is a deprecated alias of `salesChannelId`. It still works and
+ * logs a deprecation warning on every construction — it is a permanent
+ * backward-compat alias and is not scheduled for removal.)
  *
  * **Storefront Mode (Frontend)** - Use storeId for public access:
  * ```typescript
@@ -8128,6 +8269,29 @@ declare class BrainerceClient {
             occurredAt: string;
         }>;
     }>>;
+    /**
+     * Buy a return label the merchant sends to their customer to print.
+     *
+     * Requires admin mode (`apiKey`) with `FULFILL_ORDERS` permission — it
+     * spends the store's carrier balance, same as {@link createShippingLabel}.
+     *
+     * Unlike {@link createShippingLabel}, this is **not** on the API-key `/v1`
+     * surface — it calls the internal `/api/orders/:id/shipments/return-label`
+     * route, which takes `storeId` explicitly rather than resolving it from the
+     * key. There is no `rateId` in the body: a return is quoted and bought in
+     * one call at the shipping app, because the carrier fixes a shipment as a
+     * return when it is created and will not amend it afterwards.
+     *
+     * @example
+     * ```typescript
+     * const label = await client.createReturnLabel('store_abc', 'order_abc', {
+     *   reason: 'Wrong size',
+     *   returnForShipmentId: 'shp_original123',
+     * });
+     * console.log('Return label URL:', label.labelUrl);
+     * ```
+     */
+    createReturnLabel(storeId: string, orderId: string, data: CreateReturnLabelDto): Promise<CreateReturnLabelResponse>;
     /**
      * Cancel an order.
      *
@@ -12283,6 +12447,110 @@ declare class BrainerceClient {
      * Requires Admin mode (apiKey)
      */
     deleteOAuthProvider(provider: OAuthProviderType): Promise<void>;
+    /**
+     * Get translation completeness across every translatable entity type, for
+     * one or more locales. Useful as a pre-flight before a bulk import to see
+     * which entity types/locales still need coverage.
+     * Requires Admin mode (apiKey).
+     *
+     * @param storeId - Store to inspect.
+     * @param locales - BCP-47 locale codes to check (e.g. `['he', 'fr']`). Omit
+     *   or pass an empty array to get rows with `total` populated but no
+     *   locale breakdown.
+     *
+     * @example
+     * ```typescript
+     * const status = await client.getTranslationStatus('store_123', ['he', 'fr']);
+     * const blogHe = status.find((s) => s.entityType === 'blogPost' && s.locale === 'he');
+     * console.log(`${blogHe?.missing} blog posts still need Hebrew`);
+     * ```
+     */
+    getTranslationStatus(storeId: string, locales?: string[]): Promise<TranslationStatusEntry[]>;
+    /**
+     * Get every persisted translation for a single entity, keyed by locale.
+     * Requires Admin mode (apiKey).
+     *
+     * @example
+     * ```typescript
+     * const translations = await client.getTranslations('store_123', 'product', 'prod_abc');
+     * console.log(translations.he?.name); // Hebrew product name, if set
+     * ```
+     */
+    getTranslations(storeId: string, entityType: TranslatableEntityType, entityId: string): Promise<TranslationsMap>;
+    /**
+     * Set/update one locale's translation for an entity. Only the fields valid
+     * for `entityType` are persisted (e.g. `title`/`excerpt`/`content` for
+     * `blogPost`, `name`/`description` for `category`) — fields outside that
+     * entity's allowlist are silently ignored server-side, and omitted fields
+     * leave any existing translation for them untouched (this is a merge, not
+     * a replace, of the locale's fields).
+     * Requires Admin mode (apiKey) with `products:write` (or the equivalent
+     * scope for the target entity type).
+     *
+     * @example
+     * ```typescript
+     * // Bulk-import a pre-translated blog post
+     * await client.setTranslation('store_123', 'blogPost', 'post_abc', 'fr', {
+     *   title: 'Le titre en français',
+     *   excerpt: "L'extrait en français",
+     *   content: '<p>Le contenu en français</p>',
+     * });
+     * ```
+     */
+    setTranslation(storeId: string, entityType: TranslatableEntityType, entityId: string, locale: string, fields: SetTranslationFields): Promise<TranslationsMap>;
+    /**
+     * Delete one locale's translation for an entity. The entity's base
+     * (default-locale) fields are unaffected.
+     * Requires Admin mode (apiKey) with `products:write` (or the equivalent
+     * scope for the target entity type).
+     */
+    deleteTranslation(storeId: string, entityType: TranslatableEntityType, entityId: string, locale: string): Promise<void>;
+    /**
+     * AI-translate a single entity into one target locale and persist the
+     * result inline (synchronous — the response already reflects the write).
+     * Only fields that are still empty for `targetLocale` are filled; existing
+     * translated values are never overwritten.
+     * Requires Admin mode (apiKey) with `products:write` (or the equivalent
+     * scope for the target entity type).
+     *
+     * @param sourceFields - Optional override of the source-language text to
+     *   translate from (e.g. unsaved edits from an open editor), instead of the
+     *   entity's persisted base fields. Keys outside the entity's translatable
+     *   field set are ignored.
+     *
+     * @example
+     * ```typescript
+     * const translations = await client.aiTranslateSingle('store_123', {
+     *   entityType: 'product',
+     *   entityId: 'prod_abc',
+     *   targetLocale: 'he',
+     * });
+     * ```
+     */
+    aiTranslateSingle(storeId: string, input: AiTranslateSingleInput): Promise<TranslationsMap>;
+    /**
+     * Bulk AI-translate — enqueues a background job per entity (and, for
+     * `entityType: 'attribute'`, one per attribute option too) rather than
+     * translating inline. Returns the number of jobs queued, not the finished
+     * translations; poll `getTranslationStatus` or `getTranslations` to see
+     * results land.
+     * Requires Admin mode (apiKey) with `products:write` (or the equivalent
+     * scope for the target entity type).
+     *
+     * @param entityIds - Optional explicit ids to translate. Omit to target
+     *   every entity of `entityType` in the store that isn't already fully
+     *   translated for `targetLocale`.
+     *
+     * @example
+     * ```typescript
+     * // Translate every blog post missing French coverage
+     * const { queued } = await client.aiTranslateBulk('store_123', {
+     *   entityType: 'blogPost',
+     *   targetLocale: 'fr',
+     * });
+     * ```
+     */
+    aiTranslateBulk(storeId: string, input: AiTranslateBulkInput): Promise<AiTranslateBulkResult>;
 }
 /**
  * Custom error class for Brainerce API errors
@@ -12293,7 +12561,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "2.0.0";
+declare const SDK_VERSION = "2.0.1";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -12794,4 +13062,4 @@ interface CategorySitemapOptions {
  */
 declare function getCategorySitemapEntries(client: BrainerceClient, opts: CategorySitemapOptions): Promise<SitemapEntry[]>;
 
-export { type AddToCartDto, type AddressDetailsResult, type AddressSuggestion, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type AvailabilityClock, type BlogPost, type BlogPostListParams, type BlogPostListResponse, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkCreateProductsDto, type BulkCreateProductsError, type BulkCreateProductsJob, type BulkCreateProductsStatus, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type BusinessHoursWindow, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryDetail, type CategoryNode, type CategorySitemapOptions, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DateAvailabilityConstraints, type DateAvailabilitySurface, type DateFieldParseResult, type DeleteProductResponse, type DeliveryType, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type JsonLdOptions, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type LoyaltyNextTierSummary, type LoyaltyReward, type LoyaltyStatus, type LoyaltyTierSummary, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldFilter, type MetafieldFilterValue, type MetafieldFiltersResponse, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type ModifierValidationFailedError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type ParsedDateFieldValue, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentRecordStatus, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type PriceDriftError, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductSitemapOptions, type ProductStatus, type ProductSuggestion, type ProductUnavailableError, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type RedeemRewardResult, type ReferralInfo, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type RelativeDateBounds, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type ReviewStatus, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingSummaryEntry, type ShippingZone, type ShippingZoneQueryParams, type SitemapEntry, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type StoreTracking, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type TrackingEventItem, type TrackingEventName, type TrackingEventPayload, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, buildArticleJsonLd, buildBreadcrumbJsonLd, buildCollectionPageJsonLd, buildOrganizationJsonLd, buildProductFaqJsonLd, buildProductJsonLd, buildWebsiteJsonLd, computeAvailableSlots, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getBusinessHoursForDate, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSitemapEntries, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseDateFieldValue, parseWebhookEvent, resolveRelativeBounds, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };
+export { type AddToCartDto, type AddressDetailsResult, type AddressSuggestion, type AiTranslateBulkInput, type AiTranslateBulkResult, type AiTranslateSingleInput, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeDisplayType, type AttributeOption, type AttributeSource, type AvailabilityClock, type BlogPost, type BlogPostListParams, type BlogPostListResponse, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkCreateProductsDto, type BulkCreateProductsError, type BulkCreateProductsJob, type BulkCreateProductsStatus, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type BusinessHoursWindow, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryDetail, type CategoryNode, type CategorySitemapOptions, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateReturnLabelDto as CreateReturnLabelInput, type CreateReturnLabelResponse, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DateAvailabilityConstraints, type DateAvailabilitySurface, type DateFieldParseResult, type DeleteProductResponse, type DeliveryType, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type JsonLdOptions, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LocaleTranslation, type LockedVariant, type LoyaltyNextTierSummary, type LoyaltyReward, type LoyaltyStatus, type LoyaltyTierSummary, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldFilter, type MetafieldFilterValue, type MetafieldFiltersResponse, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type ModifierValidationFailedError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type ParsedDateFieldValue, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentRecordStatus, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type PriceDriftError, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductReviewImage, type ProductReviewImageAdmin, type ProductSitemapOptions, type ProductStatus, type ProductSuggestion, type ProductUnavailableError, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type RedeemRewardResult, type ReferralInfo, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type RelativeDateBounds, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type ReturnLabelParcel, type ReviewPhotoUpload, type ReviewStatus, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type SetTranslationFields, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingSummaryEntry, type ShippingZone, type ShippingZoneQueryParams, type SitemapEntry, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type StoreTracking, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type TrackingEventItem, type TrackingEventName, type TrackingEventPayload, type 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 UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, buildArticleJsonLd, buildBreadcrumbJsonLd, buildCollectionPageJsonLd, buildOrganizationJsonLd, buildProductFaqJsonLd, buildProductJsonLd, buildWebsiteJsonLd, computeAvailableSlots, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getBusinessHoursForDate, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSitemapEntries, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseDateFieldValue, parseWebhookEvent, resolveRelativeBounds, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };