brainerce 1.0.1 → 1.1.0

package/dist/index.d.mts

@@ -1969,6 +1969,31 @@ interface SetShippingAddressResponse {
     checkout: Checkout;
     rates: ShippingRate[];
 }
+/**
+ * Available shipping destinations for a store.
+ *
+ * Use `getShippingDestinations()` to populate country/region `<select>` elements
+ * in your checkout form instead of free-text fields.
+ *
+ * - If `worldwide` is true, the store ships to all countries (use a full country list).
+ * - `countries` contains the specific country codes/names the store ships to.
+ * - `regions` contains region restrictions per country. If a country has no entry,
+ *   all regions within it are available.
+ */
+interface ShippingDestinations {
+    /** Whether the store ships worldwide (has a zone covering all countries) */
+    worldwide: boolean;
+    /** Countries the store ships to */
+    countries: Array<{
+        code: string;
+        name: string;
+    }>;
+    /** Region restrictions per country code. Empty object means no region restrictions. */
+    regions: Record<string, Array<{
+        code: string;
+        name: string;
+    }>>;
+}
 interface CompleteCheckoutResponse {
     orderId: string;
 }
@@ -3362,9 +3387,15 @@ declare class BrainerceClient {
     private readonly timeout;
     private customerToken;
     private customerCartId;
+    private sessionCartId;
+    private sessionToken;
+    private _sessionCartPromise;
+    private _migrationDone;
+    /** localStorage key for session cart reference (sessionToken + cartId) */
+    private readonly SESSION_CART_KEY;
     /**
      * Virtual cart ID used for localStorage carts (guest users not logged in).
-     * When a cart has this ID, operations use localStorage instead of server API.
+     * @deprecated Guest carts now use server-side sessions. Kept for backward compatibility.
      */
     private readonly VIRTUAL_LOCAL_CART_ID;
     /**
@@ -4585,6 +4616,64 @@ declare class BrainerceClient {
      * ```
      */
     isCustomerLoggedIn(): boolean;
+    /**
+     * Hydrate session cart state from localStorage on construction.
+     * @internal
+     */
+    private hydrateSessionCart;
+    /**
+     * Persist session cart reference to localStorage.
+     * @internal
+     */
+    private saveSessionCart;
+    /**
+     * Clear session cart reference from localStorage and memory.
+     * @internal
+     */
+    private clearSessionCart;
+    /**
+     * Update the cached item count in the session reference.
+     * @internal
+     */
+    private updateSessionCartItemCount;
+    /**
+     * Return a synthetic empty Cart object for display when no server cart exists yet.
+     * Avoids creating a server cart just to show "your cart is empty."
+     * @internal
+     */
+    private emptyCart;
+    /**
+     * Create a server-side cart via API. Never falls back to localStorage.
+     * @internal
+     */
+    private createServerCart;
+    /**
+     * Get or create a server-side session cart for guest users.
+     * Lazily creates the cart on first call (e.g., first add-to-cart).
+     * Uses promise dedup lock to prevent race conditions on parallel calls.
+     * @internal
+     */
+    private getOrCreateSessionCart;
+    /** @internal */
+    private _getOrCreateSessionCartImpl;
+    /**
+     * Migrate legacy localStorage cart to server session cart.
+     * Called once, on first smart method call if migration is needed.
+     * @internal
+     */
+    private migrateLocalCartToSession;
+    /**
+     * Merge the guest session cart into the customer's cart on the server.
+     * Tries linkCart first (fast, single call), falls back to mergeCarts endpoint.
+     * @internal
+     */
+    private mergeSessionCartOnLogin;
+    /**
+     * Get the cart item count without a full cart fetch.
+     * Returns the cached count from localStorage if available, or 0.
+     * For accurate counts, use smartGetCart() and read cart.itemCount.
+     */
+    getSmartCartItemCount(): number;
     /**
      * Get or create a server cart for the logged-in customer
      * Caches the cart ID for subsequent calls
@@ -4597,10 +4686,10 @@ declare class BrainerceClient {
      */
     private fetchCustomerCart;
     /**
-     * Smart add to cart - automatically uses localStorage or server based on auth state
+     * Smart add to cart - automatically uses the correct cart based on auth state
      *
-     * - **Guest (not logged in)**: Stores in localStorage
-     * - **Logged in**: Stores on server (database)
+     * - **Logged in**: Uses customer's server cart
+     * - **Guest**: Uses server-side session cart (creates one if needed)
      *
      * @example
      * ```typescript
@@ -4608,14 +4697,20 @@ declare class BrainerceClient {
      * await client.smartAddToCart({
      *   productId: 'prod_123',
      *   quantity: 2,
-     *   name: 'Cool Product', // Optional: for localStorage display
-     *   price: '29.99',
      * });
      * ```
      */
-    smartAddToCart(item: Omit<LocalCartItem, 'addedAt'>): Promise<Cart | LocalCart>;
+    smartAddToCart(item: {
+        productId: string;
+        variantId?: string;
+        quantity: number;
+    }): Promise<Cart>;
     /**
-     * Smart get cart - returns server cart if logged in, localStorage if guest
+     * Smart get cart - returns the current cart (server-side for both guests and logged-in users)
+     *
+     * - **Logged in**: Returns customer's server cart
+     * - **Guest with session**: Returns server-side session cart
+     * - **Guest without session**: Returns empty cart (no server call, cart created lazily on add)
      *
      * @example
      * ```typescript
@@ -4623,7 +4718,7 @@ declare class BrainerceClient {
      * console.log('Items:', cart.items.length);
      * ```
      */
-    smartGetCart(): Promise<Cart | LocalCart>;
+    smartGetCart(): Promise<Cart>;
     /**
      * Smart update cart item quantity
      *
@@ -4633,7 +4728,7 @@ declare class BrainerceClient {
      * await client.smartUpdateCartItem('prod_123', 0); // Remove item
      * ```
      */
-    smartUpdateCartItem(productId: string, quantity: number, variantId?: string): Promise<Cart | LocalCart>;
+    smartUpdateCartItem(productId: string, quantity: number, variantId?: string): Promise<Cart>;
     /**
      * Smart remove from cart
      *
@@ -4643,17 +4738,15 @@ declare class BrainerceClient {
      * await client.smartRemoveFromCart('prod_456', 'variant_789');
      * ```
      */
-    smartRemoveFromCart(productId: string, variantId?: string): Promise<Cart | LocalCart>;
+    smartRemoveFromCart(productId: string, variantId?: string): Promise<Cart>;
     /**
-     * Sync local cart to server on login
+     * Sync guest cart to customer cart on login
      *
      * Call this AFTER setCustomerToken() when a customer logs in.
      * This will:
-     * 1. Get or create a server cart for the customer
-     * 2. Add all items from localStorage to the server cart (merging with existing)
-     * 3. Clear localStorage
-     *
-     * Items that fail to sync (e.g., out of stock) are silently skipped.
+     * 1. If a server-side session cart exists, merge it into the customer cart (atomic, server-side)
+     * 2. If only a legacy localStorage cart exists, sync items one by one (backward compat)
+     * 3. Clear the session/localStorage after merge
      *
      * @example
      * ```typescript
@@ -4661,7 +4754,7 @@ declare class BrainerceClient {
      * const auth = await client.login(email, password);
      * client.setCustomerToken(auth.token);
      *
-     * // Sync their local cart to server
+     * // Merge their guest cart into customer cart
      * const cart = await client.syncCartOnLogin();
      * console.log('Cart synced, items:', cart.items.length);
      * ```
@@ -4670,15 +4763,15 @@ declare class BrainerceClient {
     /**
      * Clear cart state on logout
      *
-     * Call this when a customer logs out to clear the cached cart ID.
-     * The localStorage cart remains available for the next guest session.
+     * Call this when a customer logs out to clear the cached customer cart ID.
+     * The session cart (if any) remains available for the next guest session.
      *
      * @example
      * ```typescript
      * client.clearCustomerToken();
      * client.onLogout();
      *
-     * // Now back to guest mode - cart uses localStorage
+     * // Now back to guest mode - cart uses server-side session
      * await client.smartAddToCart({ productId: 'prod_123', quantity: 1 });
      * ```
      */
@@ -4694,7 +4787,6 @@ declare class BrainerceClient {
      * // After payment success
      * if (paymentStatus === 'succeeded') {
      *   client.onCheckoutComplete();
-     *   client.clearLocalCart(); // Also clear localStorage for guests
      * }
      * ```
      */
@@ -4744,6 +4836,32 @@ declare class BrainerceClient {
      * ```
      */
     setCheckoutCustomer(checkoutId: string, data: SetCheckoutCustomerDto): Promise<Checkout>;
+    /**
+     * Get available shipping destinations for this store.
+     *
+     * Returns which countries and regions the store ships to,
+     * so you can populate `<select>` dropdowns in your checkout form.
+     *
+     * @example
+     * ```typescript
+     * const dest = await client.getShippingDestinations();
+     *
+     * if (dest.worldwide) {
+     *   // Store ships everywhere — use a full country list
+     * } else {
+     *   // Only show available countries
+     *   dest.countries.forEach(c => console.log(c.code, c.name));
+     * }
+     *
+     * // Check region restrictions for a country
+     * const usRegions = dest.regions['US'];
+     * if (usRegions) {
+     *   // Only these US states are available
+     *   usRegions.forEach(r => console.log(r.code, r.name));
+     * }
+     * ```
+     */
+    getShippingDestinations(): Promise<ShippingDestinations>;
     /**
      * Set shipping address on checkout (includes customer email).
      * Returns the checkout and available shipping rates for the address.
@@ -5016,14 +5134,8 @@ declare class BrainerceClient {
      */
     private isLocalStorageAvailable;
     /**
-     * Get local cart from localStorage
-     * Returns empty cart if none exists
-     *
-     * @example
-     * ```typescript
-     * const cart = client.getLocalCart();
-     * console.log('Items in cart:', cart.items.length);
-     * ```
+     * @deprecated Use `smartGetCart()` instead. Guest carts are now stored on the server.
+     * Get local cart from localStorage. Returns empty cart if none exists.
      */
     getLocalCart(): LocalCart;
     /**
@@ -5041,89 +5153,44 @@ declare class BrainerceClient {
      */
     private localCartToCart;
     /**
-     * Add item to local cart (NO API call)
-     * If item already exists, updates quantity
-     *
-     * @example
-     * ```typescript
-     * client.addToLocalCart({
-     *   productId: 'prod_123',
-     *   quantity: 2,
-     *   name: 'Cool Shirt',
-     *   price: '29.99',
-     * });
-     * ```
+     * @deprecated Use `smartAddToCart()` instead. Guest carts are now stored on the server.
+     * Add item to local cart (NO API call). If item already exists, updates quantity.
      */
     addToLocalCart(item: Omit<LocalCartItem, 'addedAt'>): LocalCart;
     /**
-     * Update item quantity in local cart
-     * Set quantity to 0 to remove item
-     *
-     * @example
-     * ```typescript
-     * client.updateLocalCartItem('prod_123', 3); // Set quantity to 3
-     * client.updateLocalCartItem('prod_123', 0); // Remove item
-     * ```
+     * @deprecated Use `smartUpdateCartItem()` instead. Guest carts are now stored on the server.
+     * Update item quantity in local cart. Set quantity to 0 to remove item.
      */
     updateLocalCartItem(productId: string, quantity: number, variantId?: string): LocalCart;
     /**
-     * Remove item from local cart
-     *
-     * @example
-     * ```typescript
-     * client.removeFromLocalCart('prod_123');
-     * client.removeFromLocalCart('prod_456', 'variant_789');
-     * ```
+     * @deprecated Use `smartRemoveFromCart()` instead. Guest carts are now stored on the server.
      */
     removeFromLocalCart(productId: string, variantId?: string): LocalCart;
     /**
-     * Clear all items from local cart
-     *
-     * @example
-     * ```typescript
-     * client.clearLocalCart();
-     * ```
+     * @deprecated Use `onCheckoutComplete()` instead. Guest carts are now stored on the server.
      */
     clearLocalCart(): LocalCart;
     /**
-     * Set customer info on local cart
-     *
-     * @example
-     * ```typescript
-     * client.setLocalCartCustomer({
-     *   email: 'john@example.com',
-     *   firstName: 'John',
-     *   lastName: 'Doe',
-     * });
-     * ```
+     * @deprecated Customer info is now set via checkout address methods.
+     * Still used by `submitGuestOrder()` for backward compatibility.
      */
     setLocalCartCustomer(customer: LocalCart['customer']): LocalCart;
     /**
-     * Set shipping address on local cart
-     *
-     * @example
-     * ```typescript
-     * client.setLocalCartShippingAddress({
-     *   firstName: 'John',
-     *   lastName: 'Doe',
-     *   line1: '123 Main St',
-     *   city: 'Tel Aviv',
-     *   postalCode: '6100000',
-     *   country: 'IL',
-     * });
-     * ```
+     * @deprecated Address is now set via `updateGuestCheckoutAddress()` after `startGuestCheckout()`.
+     * Still used by `submitGuestOrder()` for backward compatibility.
      */
     setLocalCartShippingAddress(address: LocalCart['shippingAddress']): LocalCart;
     /**
-     * Set billing address on local cart
+     * @deprecated Address is now set via `updateGuestCheckoutAddress()` after `startGuestCheckout()`.
+     * Still used by `submitGuestOrder()` for backward compatibility.
      */
     setLocalCartBillingAddress(address: LocalCart['billingAddress']): LocalCart;
     /**
-     * Set coupon code on local cart
+     * @deprecated Coupons are now applied via `applyCoupon()` on the server cart.
      */
     setLocalCartCoupon(couponCode: string | undefined): LocalCart;
     /**
-     * Get total items count in local cart
+     * @deprecated Use `getSmartCartItemCount()` instead.
      */
     getLocalCartItemCount(): number;
     /**
@@ -5222,16 +5289,8 @@ declare class BrainerceClient {
      */
     private clearActiveCheckoutStorage;
     /**
+     * @deprecated Partial checkout is now handled server-side via `selectedItemIds`.
      * Remove specific items from local cart by their indices.
-     * Use after partial checkout to remove only the purchased items.
-     *
-     * @param indices - Array of item indices to remove
-     *
-     * @example
-     * ```typescript
-     * // After partial checkout success, remove purchased items
-     * client.removeLocalCartItemsByIndex([0, 2]); // Removes items at index 0 and 2
-     * ```
      */
     removeLocalCartItemsByIndex(indices: number[]): void;
     /**
@@ -6255,4 +6314,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 CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, 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 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 OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, 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 ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, 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, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, 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 CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, 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 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 OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, 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 ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, 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, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };