npm - brainerce - Versions diffs - 1.16.0 → 1.18.0 - Mend

brainerce 1.16.0 → 1.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -572,7 +572,7 @@ declare function getProductPrice(product: Pick<Product, 'basePrice' | 'salePrice
  * }
  * ```
  */
-declare function getProductPriceInfo(product: Pick<Product, 'basePrice' | 'salePrice'> | null | undefined): {
+declare function getProductPriceInfo(product: Pick<Product, 'basePrice' | 'salePrice' | 'discount'> | null | undefined): {
     price: number;
     originalPrice: number;
     isOnSale: boolean;
@@ -961,10 +961,13 @@ interface OrderItem {
     totalPrice?: string;
     /** Product image URL (flat, not nested under product object) */
     image?: string;
-    /** Customer input field values captured at checkout (e.g., cake text, uploaded logo) */
+    /**
+     * Customer input field values captured at checkout (e.g., cake text, uploaded logo).
+     * `value` is `string[]` for MULTI_SELECT / GALLERY types, `string` otherwise.
+     */
     customizations?: Record<string, {
         label: string;
-        value: string;
+        value: string | string[];
         type: string;
     }>;
 }
@@ -2498,8 +2501,8 @@ interface CustomApiTestResult {
  * The frontend dynamically loads the SDK script and calls init/render methods.
  */
 interface PaymentClientSdk {
-    /** How the payment UI is rendered: 'sdk-widget' (JS SDK), 'iframe', 'redirect', or 'sandbox' (test orders) */
-    renderType: 'sdk-widget' | 'iframe' | 'redirect' | 'sandbox';
+    /** How the payment UI is rendered: 'sdk-widget' (JS SDK), 'iframe', 'redirect', 'sandbox' (test orders), or 'embedded-fields' (PCI-compliant provider-hosted fields embedded in merchant DOM, e.g. Cardcom OpenFields, Stripe Elements) */
+    renderType: 'sdk-widget' | 'iframe' | 'redirect' | 'sandbox' | 'embedded-fields';
     /** URL of the main SDK script to load */
     scriptUrl?: string;
     /** Name of the global variable set by the SDK script (e.g., 'growPayment') */
@@ -2521,6 +2524,12 @@ interface PaymentClientSdk {
     }>;
     /** CSS to inject into <head> when SDK is active (e.g., LTR overrides for body-level popups on RTL pages) */
     bodyStyles?: string;
+    /** For renderType='embedded-fields': base URL the sensitive-field iframes load (e.g. 'https://secure.cardcom.solutions'). postMessage origin is strictly validated against this. */
+    embeddedFieldsUrl?: string;
+    /** For renderType='embedded-fields': opaque provider session id used in the iframe init handshake (e.g., Cardcom LowProfileId) */
+    embeddedFieldsSessionId?: string;
+    /** Provider discriminator that selects the correct embedded-fields component on the storefront */
+    embeddedFieldsProvider?: 'cardcom';
 }
 /**
  * Payment provider configuration (returned by `getPaymentProviders()`).
@@ -3156,7 +3165,7 @@ interface UpdateTaxRateDto {
 /**
  * Metafield type for defining value structure
  */
-type MetafieldType = 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'DATETIME' | 'URL' | 'COLOR' | 'DIMENSION' | 'WEIGHT' | 'JSON' | 'IMAGE' | 'GALLERY';
+type MetafieldType = 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'DATETIME' | 'URL' | 'COLOR' | 'DIMENSION' | 'WEIGHT' | 'JSON' | 'IMAGE' | 'GALLERY' | 'SELECT' | 'MULTI_SELECT';
 /**
  * Metafield definition - schema for product metafields
  */
@@ -3456,6 +3465,7 @@ interface EmailTemplate {
     storeId: string;
     name: string;
     eventType: EmailEventType;
+    language: string;
     subject: string;
     htmlContent: string;
     textContent?: string | null;
@@ -3464,10 +3474,17 @@ interface EmailTemplate {
     createdAt: string;
     updatedAt: string;
 }
+/** Paginated response for email templates, grouped by (eventType, language). */
+interface EmailTemplatesResponse {
+    templates: EmailTemplate[];
+    language: string;
+    supportedLanguages: string[];
+}
 /** DTO for creating an email template */
 interface CreateEmailTemplateDto {
     name: string;
     eventType: EmailEventType;
+    language: string;
     subject: string;
     htmlContent: string;
     textContent?: string;
@@ -3580,7 +3597,7 @@ interface UpdateOAuthProviderDto {
     isEnabled?: boolean;
     providerConfig?: Record<string, unknown>;
 }
-type DiscountRuleType = 'PERCENTAGE' | 'FIXED_AMOUNT' | 'BUY_X_GET_Y' | 'QUANTITY_DISCOUNT' | 'FREE_SHIPPING';
+type DiscountRuleType = 'PRODUCT_DISCOUNT' | 'ORDER_DISCOUNT' | 'BUY_X_GET_Y' | 'BUY_X_GET_X' | 'VOLUME_DISCOUNT' | 'SHIPPING_DISCOUNT' | 'BUNDLE';
 /** Discount that was automatically applied to the cart by a rule */
 interface CartAppliedDiscount {
     ruleId: string;
@@ -3685,6 +3702,21 @@ interface CartBundleOffer {
 interface CartBundlesResponse {
     bundles: CartBundleOffer[];
 }
+/** Valid values for the cart `include` query parameter */
+type CartIncludeOption = 'recommendations' | 'upgrades' | 'bundles';
+/** Options for getCart / smartGetCart with optional includes */
+interface CartIncludeOptions {
+    include?: CartIncludeOption[];
+}
+/** Cart response enriched with optional included data */
+interface CartWithIncludes extends Cart {
+    /** Cross-sell recommendations (present when include contains 'recommendations') */
+    recommendations?: CartRecommendationsResponse;
+    /** Upgrade suggestions (present when include contains 'upgrades') */
+    upgrades?: CartUpgradesResponse;
+    /** Bundle offers (present when include contains 'bundles') */
+    bundles?: CartBundlesResponse;
+}
 interface OrderBump {
     id: string;
     title: string;
@@ -3988,7 +4020,9 @@ declare class BrainerceClient {
      * // Use tag IDs in getProducts({ tags: ['tag_id'] })
      * ```
      */
-    getTags(): Promise<{
+    getTags(options?: {
+        locale?: string;
+    }): Promise<{
         tags: Array<{
             id: string;
             name: string;
@@ -4901,18 +4935,60 @@ declare class BrainerceClient {
     getCartByCustomer(customerId: string): Promise<Cart>;
     /**
      * Get a cart by ID
+     *
+     * @param cartId - The cart ID
+     * @param options - Optional settings. Use `include` to fetch related data in a single request.
+     *
+     * @example
+     * ```typescript
+     * // Basic cart fetch
+     * const cart = await client.getCart('cart_123');
+     *
+     * // Fetch cart with recommendations, upgrades, and bundles in one call
+     * const enriched = await client.getCart('cart_123', {
+     *   include: ['recommendations', 'upgrades', 'bundles'],
+     * });
+     * console.log(enriched.recommendations); // { recommendations: [...] }
+     * console.log(enriched.upgrades);        // { upgrades: { ... } }
+     * console.log(enriched.bundles);         // { bundles: [...] }
+     * ```
      */
-    getCart(cartId: string): Promise<Cart>;
+    getCart(cartId: string, options?: CartIncludeOptions): Promise<CartWithIncludes>;
     /**
-     * Add an item to the cart
+     * Add an item to the cart.
+     *
+     * If the product has `customizationFields` (merchant-defined buyer input
+     * like engraving text, uploaded photos, select options), pass the buyer's
+     * values in `metadata`. Keys must match each field's `key`. For `IMAGE` /
+     * `GALLERY` types, upload the file first via `uploadCustomizationFile()`
+     * and pass the returned URL. The server validates every value against its
+     * `MetafieldDefinition` and rejects the request with HTTP 400 if anything
+     * fails (type mismatch, required missing, not in `enumValues`, etc.).
+     *
+     * Values are snapshotted onto the order line at checkout — later edits to
+     * the field definition do not retroactively change existing orders.
      *
      * @example
      * ```typescript
+     * // Product with no customization fields
      * const cart = await client.addToCart('cart_123', {
      *   productId: 'prod_abc',
      *   quantity: 2,
      *   notes: 'Gift wrap please',
      * });
+     *
+     * // Product WITH customization fields (engraving + photo + select + multi)
+     * const { url: photoUrl } = await client.uploadCustomizationFile(file);
+     * const cart = await client.addToCart('cart_123', {
+     *   productId: 'prod_mug',
+     *   quantity: 1,
+     *   metadata: {
+     *     engraving_text: 'Happy Birthday!',  // TEXT
+     *     frame_color: 'Gold',                // SELECT (must be in enumValues)
+     *     upload_photo: photoUrl,             // IMAGE
+     *     addons: ['Gift wrap'],              // MULTI_SELECT (always array)
+     *   },
+     * });
      * ```
      */
     addToCart(cartId: string, item: AddToCartDto): Promise<Cart>;
@@ -5253,6 +5329,7 @@ declare class BrainerceClient {
         productId: string;
         variantId?: string;
         quantity: number;
+        metadata?: Record<string, unknown>;
     }): Promise<Cart>;
     /**
      * Smart get cart - returns the current cart (server-side for both guests and logged-in users)
@@ -5261,13 +5338,21 @@ declare class BrainerceClient {
      * - **Guest with session**: Returns server-side session cart
      * - **Guest without session**: Returns empty cart (no server call, cart created lazily on add)
      *
+     * @param options - Optional. Use `include` to fetch recommendations, upgrades, and bundles
+     *   in a single request instead of separate calls.
+     *
      * @example
      * ```typescript
      * const cart = await client.smartGetCart();
      * console.log('Items:', cart.items.length);
+     *
+     * // With includes — single request for cart + extras
+     * const enriched = await client.smartGetCart({
+     *   include: ['recommendations', 'upgrades', 'bundles'],
+     * });
      * ```
      */
-    smartGetCart(): Promise<Cart>;
+    smartGetCart(options?: CartIncludeOptions): Promise<CartWithIncludes>;
     /**
      * Smart update cart item quantity
      *
@@ -6660,9 +6745,35 @@ declare class BrainerceClient {
      */
     setProductCustomizationFields(productId: string, definitionIds: string[]): Promise<ProductCustomizationField[]>;
     /**
-     * Upload a file for product customization (e.g., customer logo for printing).
-     * Available in storefront and vibe-coded modes.
-     * Returns the uploaded file URL and key.
+     * Upload a buyer-submitted file (engraving photo, custom image, etc.) for a
+     * product customization field of type `IMAGE` or `GALLERY`. The returned `url`
+     * is what you pass back in the add-to-cart `metadata` payload.
+     *
+     * Available in storefront and vibe-coded modes — no customer login required.
+     *
+     * Server rules:
+     * - `image/*` MIME only. Other types → HTTP 400.
+     * - Max 5 MB per file.
+     * - Throttled to 10 uploads / minute per IP → HTTP 429.
+     * - Retention: at least 7 days. If the cart never becomes an order, the file
+     *   is reclaimed automatically. Once the order exists, the file is kept for
+     *   order-history purposes.
+     *
+     * @example
+     * ```ts
+     * // On a product page with IMAGE/GALLERY customization fields:
+     * const { url } = await client.uploadCustomizationFile(fileInput.files[0]);
+     *
+     * // Then include the URL in the add-to-cart metadata:
+     * await client.addToCart(cart.id, {
+     *   productId: product.id,
+     *   quantity: 1,
+     *   metadata: {
+     *     engraving_text: 'Happy Birthday!',
+     *     upload_photo: url,
+     *   },
+     * });
+     * ```
      */
     uploadCustomizationFile(file: File | Blob): Promise<{
         url: string;
@@ -6798,10 +6909,12 @@ declare class BrainerceClient {
      */
     updateEmailSettings(data: UpdateEmailSettingsDto): Promise<EmailSettings>;
     /**
-     * Get all email templates for the store
+     * Get all email templates for the store, grouped by (eventType, language).
+     * Response includes the store's primary language and supported languages so
+     * the caller can render a locale selector.
      * Requires Admin mode (apiKey)
      */
-    getEmailTemplates(): Promise<EmailTemplate[]>;
+    getEmailTemplates(): Promise<EmailTemplatesResponse>;
     /**
      * Get a specific email template
      * Requires Admin mode (apiKey)
@@ -6987,4 +7100,4 @@ declare function enableDevGuards(options?: {
     force?: boolean;
 }): void;
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type Category, type CategoryNode, 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 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 CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, 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 PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, type RecommendationVariant, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, 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 UpdateAddressDto, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, 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 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, createWebhookHandler, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryNode, 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 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 CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 DeleteProductResponse, 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 FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, 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 PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, type RecommendationVariant, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, 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 UpdateAddressDto, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, 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 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, createWebhookHandler, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.d.ts CHANGED Viewed

@@ -572,7 +572,7 @@ declare function getProductPrice(product: Pick<Product, 'basePrice' | 'salePrice
  * }
  * ```
  */
-declare function getProductPriceInfo(product: Pick<Product, 'basePrice' | 'salePrice'> | null | undefined): {
+declare function getProductPriceInfo(product: Pick<Product, 'basePrice' | 'salePrice' | 'discount'> | null | undefined): {
     price: number;
     originalPrice: number;
     isOnSale: boolean;
@@ -961,10 +961,13 @@ interface OrderItem {
     totalPrice?: string;
     /** Product image URL (flat, not nested under product object) */
     image?: string;
-    /** Customer input field values captured at checkout (e.g., cake text, uploaded logo) */
+    /**
+     * Customer input field values captured at checkout (e.g., cake text, uploaded logo).
+     * `value` is `string[]` for MULTI_SELECT / GALLERY types, `string` otherwise.
+     */
     customizations?: Record<string, {
         label: string;
-        value: string;
+        value: string | string[];
         type: string;
     }>;
 }
@@ -2498,8 +2501,8 @@ interface CustomApiTestResult {
  * The frontend dynamically loads the SDK script and calls init/render methods.
  */
 interface PaymentClientSdk {
-    /** How the payment UI is rendered: 'sdk-widget' (JS SDK), 'iframe', 'redirect', or 'sandbox' (test orders) */
-    renderType: 'sdk-widget' | 'iframe' | 'redirect' | 'sandbox';
+    /** How the payment UI is rendered: 'sdk-widget' (JS SDK), 'iframe', 'redirect', 'sandbox' (test orders), or 'embedded-fields' (PCI-compliant provider-hosted fields embedded in merchant DOM, e.g. Cardcom OpenFields, Stripe Elements) */
+    renderType: 'sdk-widget' | 'iframe' | 'redirect' | 'sandbox' | 'embedded-fields';
     /** URL of the main SDK script to load */
     scriptUrl?: string;
     /** Name of the global variable set by the SDK script (e.g., 'growPayment') */
@@ -2521,6 +2524,12 @@ interface PaymentClientSdk {
     }>;
     /** CSS to inject into <head> when SDK is active (e.g., LTR overrides for body-level popups on RTL pages) */
     bodyStyles?: string;
+    /** For renderType='embedded-fields': base URL the sensitive-field iframes load (e.g. 'https://secure.cardcom.solutions'). postMessage origin is strictly validated against this. */
+    embeddedFieldsUrl?: string;
+    /** For renderType='embedded-fields': opaque provider session id used in the iframe init handshake (e.g., Cardcom LowProfileId) */
+    embeddedFieldsSessionId?: string;
+    /** Provider discriminator that selects the correct embedded-fields component on the storefront */
+    embeddedFieldsProvider?: 'cardcom';
 }
 /**
  * Payment provider configuration (returned by `getPaymentProviders()`).
@@ -3156,7 +3165,7 @@ interface UpdateTaxRateDto {
 /**
  * Metafield type for defining value structure
  */
-type MetafieldType = 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'DATETIME' | 'URL' | 'COLOR' | 'DIMENSION' | 'WEIGHT' | 'JSON' | 'IMAGE' | 'GALLERY';
+type MetafieldType = 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'DATETIME' | 'URL' | 'COLOR' | 'DIMENSION' | 'WEIGHT' | 'JSON' | 'IMAGE' | 'GALLERY' | 'SELECT' | 'MULTI_SELECT';
 /**
  * Metafield definition - schema for product metafields
  */
@@ -3456,6 +3465,7 @@ interface EmailTemplate {
     storeId: string;
     name: string;
     eventType: EmailEventType;
+    language: string;
     subject: string;
     htmlContent: string;
     textContent?: string | null;
@@ -3464,10 +3474,17 @@ interface EmailTemplate {
     createdAt: string;
     updatedAt: string;
 }
+/** Paginated response for email templates, grouped by (eventType, language). */
+interface EmailTemplatesResponse {
+    templates: EmailTemplate[];
+    language: string;
+    supportedLanguages: string[];
+}
 /** DTO for creating an email template */
 interface CreateEmailTemplateDto {
     name: string;
     eventType: EmailEventType;
+    language: string;
     subject: string;
     htmlContent: string;
     textContent?: string;
@@ -3580,7 +3597,7 @@ interface UpdateOAuthProviderDto {
     isEnabled?: boolean;
     providerConfig?: Record<string, unknown>;
 }
-type DiscountRuleType = 'PERCENTAGE' | 'FIXED_AMOUNT' | 'BUY_X_GET_Y' | 'QUANTITY_DISCOUNT' | 'FREE_SHIPPING';
+type DiscountRuleType = 'PRODUCT_DISCOUNT' | 'ORDER_DISCOUNT' | 'BUY_X_GET_Y' | 'BUY_X_GET_X' | 'VOLUME_DISCOUNT' | 'SHIPPING_DISCOUNT' | 'BUNDLE';
 /** Discount that was automatically applied to the cart by a rule */
 interface CartAppliedDiscount {
     ruleId: string;
@@ -3685,6 +3702,21 @@ interface CartBundleOffer {
 interface CartBundlesResponse {
     bundles: CartBundleOffer[];
 }
+/** Valid values for the cart `include` query parameter */
+type CartIncludeOption = 'recommendations' | 'upgrades' | 'bundles';
+/** Options for getCart / smartGetCart with optional includes */
+interface CartIncludeOptions {
+    include?: CartIncludeOption[];
+}
+/** Cart response enriched with optional included data */
+interface CartWithIncludes extends Cart {
+    /** Cross-sell recommendations (present when include contains 'recommendations') */
+    recommendations?: CartRecommendationsResponse;
+    /** Upgrade suggestions (present when include contains 'upgrades') */
+    upgrades?: CartUpgradesResponse;
+    /** Bundle offers (present when include contains 'bundles') */
+    bundles?: CartBundlesResponse;
+}
 interface OrderBump {
     id: string;
     title: string;
@@ -3988,7 +4020,9 @@ declare class BrainerceClient {
      * // Use tag IDs in getProducts({ tags: ['tag_id'] })
      * ```
      */
-    getTags(): Promise<{
+    getTags(options?: {
+        locale?: string;
+    }): Promise<{
         tags: Array<{
             id: string;
             name: string;
@@ -4901,18 +4935,60 @@ declare class BrainerceClient {
     getCartByCustomer(customerId: string): Promise<Cart>;
     /**
      * Get a cart by ID
+     *
+     * @param cartId - The cart ID
+     * @param options - Optional settings. Use `include` to fetch related data in a single request.
+     *
+     * @example
+     * ```typescript
+     * // Basic cart fetch
+     * const cart = await client.getCart('cart_123');
+     *
+     * // Fetch cart with recommendations, upgrades, and bundles in one call
+     * const enriched = await client.getCart('cart_123', {
+     *   include: ['recommendations', 'upgrades', 'bundles'],
+     * });
+     * console.log(enriched.recommendations); // { recommendations: [...] }
+     * console.log(enriched.upgrades);        // { upgrades: { ... } }
+     * console.log(enriched.bundles);         // { bundles: [...] }
+     * ```
      */
-    getCart(cartId: string): Promise<Cart>;
+    getCart(cartId: string, options?: CartIncludeOptions): Promise<CartWithIncludes>;
     /**
-     * Add an item to the cart
+     * Add an item to the cart.
+     *
+     * If the product has `customizationFields` (merchant-defined buyer input
+     * like engraving text, uploaded photos, select options), pass the buyer's
+     * values in `metadata`. Keys must match each field's `key`. For `IMAGE` /
+     * `GALLERY` types, upload the file first via `uploadCustomizationFile()`
+     * and pass the returned URL. The server validates every value against its
+     * `MetafieldDefinition` and rejects the request with HTTP 400 if anything
+     * fails (type mismatch, required missing, not in `enumValues`, etc.).
+     *
+     * Values are snapshotted onto the order line at checkout — later edits to
+     * the field definition do not retroactively change existing orders.
      *
      * @example
      * ```typescript
+     * // Product with no customization fields
      * const cart = await client.addToCart('cart_123', {
      *   productId: 'prod_abc',
      *   quantity: 2,
      *   notes: 'Gift wrap please',
      * });
+     *
+     * // Product WITH customization fields (engraving + photo + select + multi)
+     * const { url: photoUrl } = await client.uploadCustomizationFile(file);
+     * const cart = await client.addToCart('cart_123', {
+     *   productId: 'prod_mug',
+     *   quantity: 1,
+     *   metadata: {
+     *     engraving_text: 'Happy Birthday!',  // TEXT
+     *     frame_color: 'Gold',                // SELECT (must be in enumValues)
+     *     upload_photo: photoUrl,             // IMAGE
+     *     addons: ['Gift wrap'],              // MULTI_SELECT (always array)
+     *   },
+     * });
      * ```
      */
     addToCart(cartId: string, item: AddToCartDto): Promise<Cart>;
@@ -5253,6 +5329,7 @@ declare class BrainerceClient {
         productId: string;
         variantId?: string;
         quantity: number;
+        metadata?: Record<string, unknown>;
     }): Promise<Cart>;
     /**
      * Smart get cart - returns the current cart (server-side for both guests and logged-in users)
@@ -5261,13 +5338,21 @@ declare class BrainerceClient {
      * - **Guest with session**: Returns server-side session cart
      * - **Guest without session**: Returns empty cart (no server call, cart created lazily on add)
      *
+     * @param options - Optional. Use `include` to fetch recommendations, upgrades, and bundles
+     *   in a single request instead of separate calls.
+     *
      * @example
      * ```typescript
      * const cart = await client.smartGetCart();
      * console.log('Items:', cart.items.length);
+     *
+     * // With includes — single request for cart + extras
+     * const enriched = await client.smartGetCart({
+     *   include: ['recommendations', 'upgrades', 'bundles'],
+     * });
      * ```
      */
-    smartGetCart(): Promise<Cart>;
+    smartGetCart(options?: CartIncludeOptions): Promise<CartWithIncludes>;
     /**
      * Smart update cart item quantity
      *
@@ -6660,9 +6745,35 @@ declare class BrainerceClient {
      */
     setProductCustomizationFields(productId: string, definitionIds: string[]): Promise<ProductCustomizationField[]>;
     /**
-     * Upload a file for product customization (e.g., customer logo for printing).
-     * Available in storefront and vibe-coded modes.
-     * Returns the uploaded file URL and key.
+     * Upload a buyer-submitted file (engraving photo, custom image, etc.) for a
+     * product customization field of type `IMAGE` or `GALLERY`. The returned `url`
+     * is what you pass back in the add-to-cart `metadata` payload.
+     *
+     * Available in storefront and vibe-coded modes — no customer login required.
+     *
+     * Server rules:
+     * - `image/*` MIME only. Other types → HTTP 400.
+     * - Max 5 MB per file.
+     * - Throttled to 10 uploads / minute per IP → HTTP 429.
+     * - Retention: at least 7 days. If the cart never becomes an order, the file
+     *   is reclaimed automatically. Once the order exists, the file is kept for
+     *   order-history purposes.
+     *
+     * @example
+     * ```ts
+     * // On a product page with IMAGE/GALLERY customization fields:
+     * const { url } = await client.uploadCustomizationFile(fileInput.files[0]);
+     *
+     * // Then include the URL in the add-to-cart metadata:
+     * await client.addToCart(cart.id, {
+     *   productId: product.id,
+     *   quantity: 1,
+     *   metadata: {
+     *     engraving_text: 'Happy Birthday!',
+     *     upload_photo: url,
+     *   },
+     * });
+     * ```
      */
     uploadCustomizationFile(file: File | Blob): Promise<{
         url: string;
@@ -6798,10 +6909,12 @@ declare class BrainerceClient {
      */
     updateEmailSettings(data: UpdateEmailSettingsDto): Promise<EmailSettings>;
     /**
-     * Get all email templates for the store
+     * Get all email templates for the store, grouped by (eventType, language).
+     * Response includes the store's primary language and supported languages so
+     * the caller can render a locale selector.
      * Requires Admin mode (apiKey)
      */
-    getEmailTemplates(): Promise<EmailTemplate[]>;
+    getEmailTemplates(): Promise<EmailTemplatesResponse>;
     /**
      * Get a specific email template
      * Requires Admin mode (apiKey)
@@ -6987,4 +7100,4 @@ declare function enableDevGuards(options?: {
     force?: boolean;
 }): void;
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type Category, type CategoryNode, 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 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 CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, 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 PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, type RecommendationVariant, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, 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 UpdateAddressDto, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, 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 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, createWebhookHandler, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryNode, 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 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 CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 DeleteProductResponse, 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 FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, 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 PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, type RecommendationVariant, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, 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 UpdateAddressDto, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, 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 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, createWebhookHandler, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };