omni-sync-sdk 0.16.0 → 0.16.2

package/dist/index.d.mts

@@ -125,9 +125,12 @@ interface Product {
     description?: string | null;
     descriptionFormat?: 'text' | 'html' | 'markdown';
     sku: string;
-    basePrice: number;
-    salePrice?: number | null;
-    costPrice?: number | null;
+    /** Base price as string (e.g., "29.99"). Use parseFloat() for calculations. */
+    basePrice: string;
+    /** Sale price as string. Use parseFloat() for calculations. */
+    salePrice?: string | null;
+    /** Cost price as string. Use parseFloat() for calculations. */
+    costPrice?: string | null;
     status: 'active' | 'draft' | 'archived';
     type: 'SIMPLE' | 'VARIABLE';
     isDownloadable?: boolean;
@@ -150,9 +153,12 @@ interface ProductVariant {
     id: string;
     sku?: string | null;
     name?: string | null;
-    price?: number | null;
-    salePrice?: number | null;
-    attributes?: Record<string, string>;
+    /** Variant price as string. Use parseFloat() for calculations. */
+    price?: string | null;
+    /** Variant sale price as string. Use parseFloat() for calculations. */
+    salePrice?: string | null;
+    /** Variant attributes (e.g., { "Color": "Red", "Size": "M" }) */
+    attributes?: Record<string, unknown>;
     inventory?: InventoryInfo | null;
 }
 /**
@@ -351,8 +357,10 @@ interface ProductSuggestion {
     name: string;
     slug: string | null;
     image: string | null;
-    basePrice: number;
-    salePrice?: number | null;
+    /** Base price as string. Use parseFloat() for calculations. */
+    basePrice: string;
+    /** Sale price as string. Use parseFloat() for calculations. */
+    salePrice?: string | null;
     type: 'SIMPLE' | 'VARIABLE';
 }
 /**
@@ -667,6 +675,41 @@ interface CustomerAddress {
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * Pre-fill data for checkout forms when customer is logged in.
+ * Use getCheckoutPrefillData() to retrieve this data.
+ */
+interface CheckoutPrefillData {
+    /** Customer profile information */
+    customer: {
+        id: string;
+        email: string;
+        firstName?: string;
+        lastName?: string;
+        phone?: string;
+        emailVerified: boolean;
+    };
+    /** Customer's default address (if any) */
+    defaultAddress: CustomerAddress | null;
+    /**
+     * Pre-formatted address data ready to pass to setShippingAddress().
+     * Combines customer email with default address fields.
+     * Null if customer has no saved addresses.
+     */
+    shippingAddress: {
+        email: string;
+        firstName: string;
+        lastName: string;
+        company?: string;
+        line1: string;
+        line2?: string;
+        city: string;
+        region?: string;
+        postalCode: string;
+        country: string;
+        phone?: string;
+    } | null;
+}
 interface CreateCustomerDto {
     email: string;
     phone?: string;
@@ -832,7 +875,7 @@ interface CartItem {
         id: string;
         name: string;
         sku: string;
-        images?: unknown[];
+        images?: ProductImage[];
     };
     /**
      * Nested variant information (null for simple products).
@@ -842,7 +885,7 @@ interface CartItem {
         id: string;
         name?: string | null;
         sku?: string | null;
-        image?: unknown;
+        image?: ProductImage | string | null;
     } | null;
     /** ISO timestamp when item was added */
     createdAt: string;
@@ -1194,7 +1237,7 @@ interface CheckoutLineItem {
         id: string;
         name: string;
         sku: string;
-        images?: unknown[];
+        images?: ProductImage[];
     };
     /**
      * Nested variant information (null for simple products).
@@ -1204,6 +1247,7 @@ interface CheckoutLineItem {
         id: string;
         name?: string | null;
         sku?: string | null;
+        image?: ProductImage | string | null;
     } | null;
 }
 /**
@@ -1293,7 +1337,7 @@ interface ShippingRate {
  * console.log(`Total: $${total.toFixed(2)}`);
  *
  * // Access line items (nested structure)
- * checkout.items.forEach(item => {
+ * checkout.lineItems.forEach(item => {
  *   console.log(item.product.name, item.quantity);
  * });
  * ```
@@ -1339,7 +1383,7 @@ interface Checkout {
     /** Applied coupon code */
     couponCode?: string | null;
     /** Line items with nested product/variant data */
-    items: CheckoutLineItem[];
+    lineItems: CheckoutLineItem[];
     /** Total item count */
     itemCount: number;
     /** Available shipping rates (after address is set) */
@@ -1950,6 +1994,7 @@ declare class OmniSyncClient {
     private readonly baseUrl;
     private readonly timeout;
     private customerToken;
+    private customerCartId;
     private readonly onAuthError?;
     constructor(options: OmniSyncClientOptions);
     /**
@@ -2992,6 +3037,113 @@ declare class OmniSyncClient {
      * ```
      */
     mergeCarts(data: MergeCartsDto): Promise<Cart>;
+    /**
+     * Check if customer is currently authenticated
+     * Used internally by smart cart methods to determine storage strategy
+     *
+     * @example
+     * ```typescript
+     * if (omni.isCustomerLoggedIn()) {
+     *   console.log('Cart will be stored on server');
+     * } else {
+     *   console.log('Cart will be stored in localStorage');
+     * }
+     * ```
+     */
+    isCustomerLoggedIn(): boolean;
+    /**
+     * Get or create a server cart for the logged-in customer
+     * Caches the cart ID for subsequent calls
+     * @internal
+     */
+    private getOrCreateCustomerCart;
+    /**
+     * Smart add to cart - automatically uses localStorage or server based on auth state
+     *
+     * - **Guest (not logged in)**: Stores in localStorage
+     * - **Logged in**: Stores on server (database)
+     *
+     * @example
+     * ```typescript
+     * // Works the same whether logged in or not
+     * await omni.smartAddToCart({
+     *   productId: 'prod_123',
+     *   quantity: 2,
+     *   name: 'Cool Product', // Optional: for localStorage display
+     *   price: '29.99',
+     * });
+     * ```
+     */
+    smartAddToCart(item: Omit<LocalCartItem, 'addedAt'>): Promise<Cart | LocalCart>;
+    /**
+     * Smart get cart - returns server cart if logged in, localStorage if guest
+     *
+     * @example
+     * ```typescript
+     * const cart = await omni.smartGetCart();
+     * console.log('Items:', cart.items.length);
+     * ```
+     */
+    smartGetCart(): Promise<Cart | LocalCart>;
+    /**
+     * Smart update cart item quantity
+     *
+     * @example
+     * ```typescript
+     * await omni.smartUpdateCartItem('prod_123', 3); // Set quantity to 3
+     * await omni.smartUpdateCartItem('prod_123', 0); // Remove item
+     * ```
+     */
+    smartUpdateCartItem(productId: string, quantity: number, variantId?: string): Promise<Cart | LocalCart>;
+    /**
+     * Smart remove from cart
+     *
+     * @example
+     * ```typescript
+     * await omni.smartRemoveFromCart('prod_123');
+     * await omni.smartRemoveFromCart('prod_456', 'variant_789');
+     * ```
+     */
+    smartRemoveFromCart(productId: string, variantId?: string): Promise<Cart | LocalCart>;
+    /**
+     * Sync local cart to server 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.
+     *
+     * @example
+     * ```typescript
+     * // Customer logs in
+     * const auth = await omni.login(email, password);
+     * omni.setCustomerToken(auth.token);
+     *
+     * // Sync their local cart to server
+     * const cart = await omni.syncCartOnLogin();
+     * console.log('Cart synced, items:', cart.items.length);
+     * ```
+     */
+    syncCartOnLogin(): Promise<Cart>;
+    /**
+     * 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.
+     *
+     * @example
+     * ```typescript
+     * omni.clearCustomerToken();
+     * omni.onLogout();
+     *
+     * // Now back to guest mode - cart uses localStorage
+     * await omni.smartAddToCart({ productId: 'prod_123', quantity: 1 });
+     * ```
+     */
+    onLogout(): void;
     /**
      * Create a checkout from a cart
      * Starts the checkout process and returns checkout with available options
@@ -3486,6 +3638,28 @@ declare class OmniSyncClient {
      * ```
      */
     getMyProfile(): Promise<CustomerProfile>;
+    /**
+     * Get pre-fill data for checkout forms (requires customerToken).
+     * Returns customer profile and default address formatted for checkout.
+     * Use this to pre-populate shipping forms for logged-in customers.
+     *
+     * @example
+     * ```typescript
+     * omni.setCustomerToken(auth.token);
+     *
+     * const prefill = await omni.getCheckoutPrefillData();
+     *
+     * if (prefill.shippingAddress) {
+     *   // Pre-fill shipping form with customer's default address
+     *   setFormValues(prefill.shippingAddress);
+     * } else {
+     *   // Customer has no saved addresses, show empty form
+     *   // But still pre-fill email from customer profile
+     *   setFormValues({ email: prefill.customer.email });
+     * }
+     * ```
+     */
+    getCheckoutPrefillData(): Promise<CheckoutPrefillData>;
     /**
      * Update the current customer's profile (requires customerToken)
      * Only available in storefront mode
@@ -3749,4 +3923,4 @@ declare function isWebhookEventType(event: WebhookEvent, type: WebhookEventType)
  */
 declare function createWebhookHandler(handlers: Partial<Record<WebhookEventType, (event: WebhookEvent) => Promise<void>>>): (payload: unknown) => Promise<void>;
 
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateGuestOrderDto, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, 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 DraftLineItem, type EditInventoryDto, type EmailVerificationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncJob, type UpdateAddressDto, type UpdateCartItemDto, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateInventoryDto, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateVariantDto, type UpdateVariantInventoryDto, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getDescriptionContent, formatPrice as getPriceDisplay, getStockStatus, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateGuestOrderDto, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, 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 DraftLineItem, type EditInventoryDto, type EmailVerificationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncJob, type UpdateAddressDto, type UpdateCartItemDto, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateInventoryDto, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateVariantDto, type UpdateVariantInventoryDto, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getDescriptionContent, formatPrice as getPriceDisplay, getStockStatus, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.d.ts

@@ -125,9 +125,12 @@ interface Product {
     description?: string | null;
     descriptionFormat?: 'text' | 'html' | 'markdown';
     sku: string;
-    basePrice: number;
-    salePrice?: number | null;
-    costPrice?: number | null;
+    /** Base price as string (e.g., "29.99"). Use parseFloat() for calculations. */
+    basePrice: string;
+    /** Sale price as string. Use parseFloat() for calculations. */
+    salePrice?: string | null;
+    /** Cost price as string. Use parseFloat() for calculations. */
+    costPrice?: string | null;
     status: 'active' | 'draft' | 'archived';
     type: 'SIMPLE' | 'VARIABLE';
     isDownloadable?: boolean;
@@ -150,9 +153,12 @@ interface ProductVariant {
     id: string;
     sku?: string | null;
     name?: string | null;
-    price?: number | null;
-    salePrice?: number | null;
-    attributes?: Record<string, string>;
+    /** Variant price as string. Use parseFloat() for calculations. */
+    price?: string | null;
+    /** Variant sale price as string. Use parseFloat() for calculations. */
+    salePrice?: string | null;
+    /** Variant attributes (e.g., { "Color": "Red", "Size": "M" }) */
+    attributes?: Record<string, unknown>;
     inventory?: InventoryInfo | null;
 }
 /**
@@ -351,8 +357,10 @@ interface ProductSuggestion {
     name: string;
     slug: string | null;
     image: string | null;
-    basePrice: number;
-    salePrice?: number | null;
+    /** Base price as string. Use parseFloat() for calculations. */
+    basePrice: string;
+    /** Sale price as string. Use parseFloat() for calculations. */
+    salePrice?: string | null;
     type: 'SIMPLE' | 'VARIABLE';
 }
 /**
@@ -667,6 +675,41 @@ interface CustomerAddress {
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * Pre-fill data for checkout forms when customer is logged in.
+ * Use getCheckoutPrefillData() to retrieve this data.
+ */
+interface CheckoutPrefillData {
+    /** Customer profile information */
+    customer: {
+        id: string;
+        email: string;
+        firstName?: string;
+        lastName?: string;
+        phone?: string;
+        emailVerified: boolean;
+    };
+    /** Customer's default address (if any) */
+    defaultAddress: CustomerAddress | null;
+    /**
+     * Pre-formatted address data ready to pass to setShippingAddress().
+     * Combines customer email with default address fields.
+     * Null if customer has no saved addresses.
+     */
+    shippingAddress: {
+        email: string;
+        firstName: string;
+        lastName: string;
+        company?: string;
+        line1: string;
+        line2?: string;
+        city: string;
+        region?: string;
+        postalCode: string;
+        country: string;
+        phone?: string;
+    } | null;
+}
 interface CreateCustomerDto {
     email: string;
     phone?: string;
@@ -832,7 +875,7 @@ interface CartItem {
         id: string;
         name: string;
         sku: string;
-        images?: unknown[];
+        images?: ProductImage[];
     };
     /**
      * Nested variant information (null for simple products).
@@ -842,7 +885,7 @@ interface CartItem {
         id: string;
         name?: string | null;
         sku?: string | null;
-        image?: unknown;
+        image?: ProductImage | string | null;
     } | null;
     /** ISO timestamp when item was added */
     createdAt: string;
@@ -1194,7 +1237,7 @@ interface CheckoutLineItem {
         id: string;
         name: string;
         sku: string;
-        images?: unknown[];
+        images?: ProductImage[];
     };
     /**
      * Nested variant information (null for simple products).
@@ -1204,6 +1247,7 @@ interface CheckoutLineItem {
         id: string;
         name?: string | null;
         sku?: string | null;
+        image?: ProductImage | string | null;
     } | null;
 }
 /**
@@ -1293,7 +1337,7 @@ interface ShippingRate {
  * console.log(`Total: $${total.toFixed(2)}`);
  *
  * // Access line items (nested structure)
- * checkout.items.forEach(item => {
+ * checkout.lineItems.forEach(item => {
  *   console.log(item.product.name, item.quantity);
  * });
  * ```
@@ -1339,7 +1383,7 @@ interface Checkout {
     /** Applied coupon code */
     couponCode?: string | null;
     /** Line items with nested product/variant data */
-    items: CheckoutLineItem[];
+    lineItems: CheckoutLineItem[];
     /** Total item count */
     itemCount: number;
     /** Available shipping rates (after address is set) */
@@ -1950,6 +1994,7 @@ declare class OmniSyncClient {
     private readonly baseUrl;
     private readonly timeout;
     private customerToken;
+    private customerCartId;
     private readonly onAuthError?;
     constructor(options: OmniSyncClientOptions);
     /**
@@ -2992,6 +3037,113 @@ declare class OmniSyncClient {
      * ```
      */
     mergeCarts(data: MergeCartsDto): Promise<Cart>;
+    /**
+     * Check if customer is currently authenticated
+     * Used internally by smart cart methods to determine storage strategy
+     *
+     * @example
+     * ```typescript
+     * if (omni.isCustomerLoggedIn()) {
+     *   console.log('Cart will be stored on server');
+     * } else {
+     *   console.log('Cart will be stored in localStorage');
+     * }
+     * ```
+     */
+    isCustomerLoggedIn(): boolean;
+    /**
+     * Get or create a server cart for the logged-in customer
+     * Caches the cart ID for subsequent calls
+     * @internal
+     */
+    private getOrCreateCustomerCart;
+    /**
+     * Smart add to cart - automatically uses localStorage or server based on auth state
+     *
+     * - **Guest (not logged in)**: Stores in localStorage
+     * - **Logged in**: Stores on server (database)
+     *
+     * @example
+     * ```typescript
+     * // Works the same whether logged in or not
+     * await omni.smartAddToCart({
+     *   productId: 'prod_123',
+     *   quantity: 2,
+     *   name: 'Cool Product', // Optional: for localStorage display
+     *   price: '29.99',
+     * });
+     * ```
+     */
+    smartAddToCart(item: Omit<LocalCartItem, 'addedAt'>): Promise<Cart | LocalCart>;
+    /**
+     * Smart get cart - returns server cart if logged in, localStorage if guest
+     *
+     * @example
+     * ```typescript
+     * const cart = await omni.smartGetCart();
+     * console.log('Items:', cart.items.length);
+     * ```
+     */
+    smartGetCart(): Promise<Cart | LocalCart>;
+    /**
+     * Smart update cart item quantity
+     *
+     * @example
+     * ```typescript
+     * await omni.smartUpdateCartItem('prod_123', 3); // Set quantity to 3
+     * await omni.smartUpdateCartItem('prod_123', 0); // Remove item
+     * ```
+     */
+    smartUpdateCartItem(productId: string, quantity: number, variantId?: string): Promise<Cart | LocalCart>;
+    /**
+     * Smart remove from cart
+     *
+     * @example
+     * ```typescript
+     * await omni.smartRemoveFromCart('prod_123');
+     * await omni.smartRemoveFromCart('prod_456', 'variant_789');
+     * ```
+     */
+    smartRemoveFromCart(productId: string, variantId?: string): Promise<Cart | LocalCart>;
+    /**
+     * Sync local cart to server 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.
+     *
+     * @example
+     * ```typescript
+     * // Customer logs in
+     * const auth = await omni.login(email, password);
+     * omni.setCustomerToken(auth.token);
+     *
+     * // Sync their local cart to server
+     * const cart = await omni.syncCartOnLogin();
+     * console.log('Cart synced, items:', cart.items.length);
+     * ```
+     */
+    syncCartOnLogin(): Promise<Cart>;
+    /**
+     * 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.
+     *
+     * @example
+     * ```typescript
+     * omni.clearCustomerToken();
+     * omni.onLogout();
+     *
+     * // Now back to guest mode - cart uses localStorage
+     * await omni.smartAddToCart({ productId: 'prod_123', quantity: 1 });
+     * ```
+     */
+    onLogout(): void;
     /**
      * Create a checkout from a cart
      * Starts the checkout process and returns checkout with available options
@@ -3486,6 +3638,28 @@ declare class OmniSyncClient {
      * ```
      */
     getMyProfile(): Promise<CustomerProfile>;
+    /**
+     * Get pre-fill data for checkout forms (requires customerToken).
+     * Returns customer profile and default address formatted for checkout.
+     * Use this to pre-populate shipping forms for logged-in customers.
+     *
+     * @example
+     * ```typescript
+     * omni.setCustomerToken(auth.token);
+     *
+     * const prefill = await omni.getCheckoutPrefillData();
+     *
+     * if (prefill.shippingAddress) {
+     *   // Pre-fill shipping form with customer's default address
+     *   setFormValues(prefill.shippingAddress);
+     * } else {
+     *   // Customer has no saved addresses, show empty form
+     *   // But still pre-fill email from customer profile
+     *   setFormValues({ email: prefill.customer.email });
+     * }
+     * ```
+     */
+    getCheckoutPrefillData(): Promise<CheckoutPrefillData>;
     /**
      * Update the current customer's profile (requires customerToken)
      * Only available in storefront mode
@@ -3749,4 +3923,4 @@ declare function isWebhookEventType(event: WebhookEvent, type: WebhookEventType)
  */
 declare function createWebhookHandler(handlers: Partial<Record<WebhookEventType, (event: WebhookEvent) => Promise<void>>>): (payload: unknown) => Promise<void>;
 
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateGuestOrderDto, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, 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 DraftLineItem, type EditInventoryDto, type EmailVerificationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncJob, type UpdateAddressDto, type UpdateCartItemDto, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateInventoryDto, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateVariantDto, type UpdateVariantInventoryDto, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getDescriptionContent, formatPrice as getPriceDisplay, getStockStatus, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateGuestOrderDto, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, 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 DraftLineItem, type EditInventoryDto, type EmailVerificationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncJob, type UpdateAddressDto, type UpdateCartItemDto, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateInventoryDto, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateVariantDto, type UpdateVariantInventoryDto, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getDescriptionContent, formatPrice as getPriceDisplay, getStockStatus, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.js

@@ -41,6 +41,7 @@ var DEFAULT_TIMEOUT = 3e4;
 var OmniSyncClient = class {
   constructor(options) {
     this.customerToken = null;
+    this.customerCartId = null;
     // -------------------- Local Cart (Client-Side for Guests) --------------------
     // These methods store cart data in localStorage - NO API calls!
     // Use for guest users in vibe-coded sites
@@ -1838,6 +1839,194 @@ var OmniSyncClient = class {
     }
     return this.adminRequest("POST", "/api/v1/cart/merge", data);
   }
+  // -------------------- Smart Cart (Auto-sync) --------------------
+  /**
+   * Check if customer is currently authenticated
+   * Used internally by smart cart methods to determine storage strategy
+   *
+   * @example
+   * ```typescript
+   * if (omni.isCustomerLoggedIn()) {
+   *   console.log('Cart will be stored on server');
+   * } else {
+   *   console.log('Cart will be stored in localStorage');
+   * }
+   * ```
+   */
+  isCustomerLoggedIn() {
+    return !!this.customerToken;
+  }
+  /**
+   * Get or create a server cart for the logged-in customer
+   * Caches the cart ID for subsequent calls
+   * @internal
+   */
+  async getOrCreateCustomerCart() {
+    if (this.customerCartId) {
+      try {
+        return await this.getCart(this.customerCartId);
+      } catch {
+        this.customerCartId = null;
+      }
+    }
+    const cart = await this.createCart();
+    this.customerCartId = cart.id;
+    if (this.customerToken) {
+      try {
+        await this.linkCart(cart.id);
+      } catch {
+      }
+    }
+    return cart;
+  }
+  /**
+   * Smart add to cart - automatically uses localStorage or server based on auth state
+   *
+   * - **Guest (not logged in)**: Stores in localStorage
+   * - **Logged in**: Stores on server (database)
+   *
+   * @example
+   * ```typescript
+   * // Works the same whether logged in or not
+   * await omni.smartAddToCart({
+   *   productId: 'prod_123',
+   *   quantity: 2,
+   *   name: 'Cool Product', // Optional: for localStorage display
+   *   price: '29.99',
+   * });
+   * ```
+   */
+  async smartAddToCart(item) {
+    if (this.isCustomerLoggedIn()) {
+      const cart = await this.getOrCreateCustomerCart();
+      return this.addToCart(cart.id, {
+        productId: item.productId,
+        variantId: item.variantId,
+        quantity: item.quantity
+      });
+    } else {
+      return this.addToLocalCart(item);
+    }
+  }
+  /**
+   * Smart get cart - returns server cart if logged in, localStorage if guest
+   *
+   * @example
+   * ```typescript
+   * const cart = await omni.smartGetCart();
+   * console.log('Items:', cart.items.length);
+   * ```
+   */
+  async smartGetCart() {
+    if (this.isCustomerLoggedIn()) {
+      return this.getOrCreateCustomerCart();
+    } else {
+      return this.getLocalCart();
+    }
+  }
+  /**
+   * Smart update cart item quantity
+   *
+   * @example
+   * ```typescript
+   * await omni.smartUpdateCartItem('prod_123', 3); // Set quantity to 3
+   * await omni.smartUpdateCartItem('prod_123', 0); // Remove item
+   * ```
+   */
+  async smartUpdateCartItem(productId, quantity, variantId) {
+    if (this.isCustomerLoggedIn()) {
+      const cart = await this.getOrCreateCustomerCart();
+      const item = cart.items.find(
+        (i) => i.productId === productId && i.variantId === (variantId ?? null)
+      );
+      if (!item) {
+        return cart;
+      }
+      if (quantity <= 0) {
+        return this.removeCartItem(cart.id, item.id);
+      }
+      return this.updateCartItem(cart.id, item.id, { quantity });
+    } else {
+      return this.updateLocalCartItem(productId, quantity, variantId);
+    }
+  }
+  /**
+   * Smart remove from cart
+   *
+   * @example
+   * ```typescript
+   * await omni.smartRemoveFromCart('prod_123');
+   * await omni.smartRemoveFromCart('prod_456', 'variant_789');
+   * ```
+   */
+  async smartRemoveFromCart(productId, variantId) {
+    return this.smartUpdateCartItem(productId, 0, variantId);
+  }
+  /**
+   * Sync local cart to server 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.
+   *
+   * @example
+   * ```typescript
+   * // Customer logs in
+   * const auth = await omni.login(email, password);
+   * omni.setCustomerToken(auth.token);
+   *
+   * // Sync their local cart to server
+   * const cart = await omni.syncCartOnLogin();
+   * console.log('Cart synced, items:', cart.items.length);
+   * ```
+   */
+  async syncCartOnLogin() {
+    if (!this.isCustomerLoggedIn()) {
+      throw new OmniSyncError(
+        "Must be logged in to sync cart. Call setCustomerToken() first.",
+        401
+      );
+    }
+    const localCart = this.getLocalCart();
+    const serverCart = await this.getOrCreateCustomerCart();
+    if (localCart.items.length === 0) {
+      return serverCart;
+    }
+    for (const item of localCart.items) {
+      try {
+        await this.addToCart(serverCart.id, {
+          productId: item.productId,
+          variantId: item.variantId,
+          quantity: item.quantity
+        });
+      } catch {
+      }
+    }
+    this.clearLocalCart();
+    return this.getCart(serverCart.id);
+  }
+  /**
+   * 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.
+   *
+   * @example
+   * ```typescript
+   * omni.clearCustomerToken();
+   * omni.onLogout();
+   *
+   * // Now back to guest mode - cart uses localStorage
+   * await omni.smartAddToCart({ productId: 'prod_123', quantity: 1 });
+   * ```
+   */
+  onLogout() {
+    this.customerCartId = null;
+  }
   // -------------------- Checkout --------------------
   /**
    * Create a checkout from a cart
@@ -2727,6 +2916,42 @@ var OmniSyncClient = class {
     }
     throw new OmniSyncError("getMyProfile is only available in vibe-coded or storefront mode", 400);
   }
+  /**
+   * Get pre-fill data for checkout forms (requires customerToken).
+   * Returns customer profile and default address formatted for checkout.
+   * Use this to pre-populate shipping forms for logged-in customers.
+   *
+   * @example
+   * ```typescript
+   * omni.setCustomerToken(auth.token);
+   *
+   * const prefill = await omni.getCheckoutPrefillData();
+   *
+   * if (prefill.shippingAddress) {
+   *   // Pre-fill shipping form with customer's default address
+   *   setFormValues(prefill.shippingAddress);
+   * } else {
+   *   // Customer has no saved addresses, show empty form
+   *   // But still pre-fill email from customer profile
+   *   setFormValues({ email: prefill.customer.email });
+   * }
+   * ```
+   */
+  async getCheckoutPrefillData() {
+    if (!this.customerToken) {
+      throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/customers/me/checkout-prefill");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/customers/me/checkout-prefill");
+    }
+    throw new OmniSyncError(
+      "getCheckoutPrefillData is only available in vibe-coded or storefront mode",
+      400
+    );
+  }
   /**
    * Update the current customer's profile (requires customerToken)
    * Only available in storefront mode

package/dist/index.mjs

@@ -11,6 +11,7 @@ var DEFAULT_TIMEOUT = 3e4;
 var OmniSyncClient = class {
   constructor(options) {
     this.customerToken = null;
+    this.customerCartId = null;
     // -------------------- Local Cart (Client-Side for Guests) --------------------
     // These methods store cart data in localStorage - NO API calls!
     // Use for guest users in vibe-coded sites
@@ -1808,6 +1809,194 @@ var OmniSyncClient = class {
     }
     return this.adminRequest("POST", "/api/v1/cart/merge", data);
   }
+  // -------------------- Smart Cart (Auto-sync) --------------------
+  /**
+   * Check if customer is currently authenticated
+   * Used internally by smart cart methods to determine storage strategy
+   *
+   * @example
+   * ```typescript
+   * if (omni.isCustomerLoggedIn()) {
+   *   console.log('Cart will be stored on server');
+   * } else {
+   *   console.log('Cart will be stored in localStorage');
+   * }
+   * ```
+   */
+  isCustomerLoggedIn() {
+    return !!this.customerToken;
+  }
+  /**
+   * Get or create a server cart for the logged-in customer
+   * Caches the cart ID for subsequent calls
+   * @internal
+   */
+  async getOrCreateCustomerCart() {
+    if (this.customerCartId) {
+      try {
+        return await this.getCart(this.customerCartId);
+      } catch {
+        this.customerCartId = null;
+      }
+    }
+    const cart = await this.createCart();
+    this.customerCartId = cart.id;
+    if (this.customerToken) {
+      try {
+        await this.linkCart(cart.id);
+      } catch {
+      }
+    }
+    return cart;
+  }
+  /**
+   * Smart add to cart - automatically uses localStorage or server based on auth state
+   *
+   * - **Guest (not logged in)**: Stores in localStorage
+   * - **Logged in**: Stores on server (database)
+   *
+   * @example
+   * ```typescript
+   * // Works the same whether logged in or not
+   * await omni.smartAddToCart({
+   *   productId: 'prod_123',
+   *   quantity: 2,
+   *   name: 'Cool Product', // Optional: for localStorage display
+   *   price: '29.99',
+   * });
+   * ```
+   */
+  async smartAddToCart(item) {
+    if (this.isCustomerLoggedIn()) {
+      const cart = await this.getOrCreateCustomerCart();
+      return this.addToCart(cart.id, {
+        productId: item.productId,
+        variantId: item.variantId,
+        quantity: item.quantity
+      });
+    } else {
+      return this.addToLocalCart(item);
+    }
+  }
+  /**
+   * Smart get cart - returns server cart if logged in, localStorage if guest
+   *
+   * @example
+   * ```typescript
+   * const cart = await omni.smartGetCart();
+   * console.log('Items:', cart.items.length);
+   * ```
+   */
+  async smartGetCart() {
+    if (this.isCustomerLoggedIn()) {
+      return this.getOrCreateCustomerCart();
+    } else {
+      return this.getLocalCart();
+    }
+  }
+  /**
+   * Smart update cart item quantity
+   *
+   * @example
+   * ```typescript
+   * await omni.smartUpdateCartItem('prod_123', 3); // Set quantity to 3
+   * await omni.smartUpdateCartItem('prod_123', 0); // Remove item
+   * ```
+   */
+  async smartUpdateCartItem(productId, quantity, variantId) {
+    if (this.isCustomerLoggedIn()) {
+      const cart = await this.getOrCreateCustomerCart();
+      const item = cart.items.find(
+        (i) => i.productId === productId && i.variantId === (variantId ?? null)
+      );
+      if (!item) {
+        return cart;
+      }
+      if (quantity <= 0) {
+        return this.removeCartItem(cart.id, item.id);
+      }
+      return this.updateCartItem(cart.id, item.id, { quantity });
+    } else {
+      return this.updateLocalCartItem(productId, quantity, variantId);
+    }
+  }
+  /**
+   * Smart remove from cart
+   *
+   * @example
+   * ```typescript
+   * await omni.smartRemoveFromCart('prod_123');
+   * await omni.smartRemoveFromCart('prod_456', 'variant_789');
+   * ```
+   */
+  async smartRemoveFromCart(productId, variantId) {
+    return this.smartUpdateCartItem(productId, 0, variantId);
+  }
+  /**
+   * Sync local cart to server 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.
+   *
+   * @example
+   * ```typescript
+   * // Customer logs in
+   * const auth = await omni.login(email, password);
+   * omni.setCustomerToken(auth.token);
+   *
+   * // Sync their local cart to server
+   * const cart = await omni.syncCartOnLogin();
+   * console.log('Cart synced, items:', cart.items.length);
+   * ```
+   */
+  async syncCartOnLogin() {
+    if (!this.isCustomerLoggedIn()) {
+      throw new OmniSyncError(
+        "Must be logged in to sync cart. Call setCustomerToken() first.",
+        401
+      );
+    }
+    const localCart = this.getLocalCart();
+    const serverCart = await this.getOrCreateCustomerCart();
+    if (localCart.items.length === 0) {
+      return serverCart;
+    }
+    for (const item of localCart.items) {
+      try {
+        await this.addToCart(serverCart.id, {
+          productId: item.productId,
+          variantId: item.variantId,
+          quantity: item.quantity
+        });
+      } catch {
+      }
+    }
+    this.clearLocalCart();
+    return this.getCart(serverCart.id);
+  }
+  /**
+   * 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.
+   *
+   * @example
+   * ```typescript
+   * omni.clearCustomerToken();
+   * omni.onLogout();
+   *
+   * // Now back to guest mode - cart uses localStorage
+   * await omni.smartAddToCart({ productId: 'prod_123', quantity: 1 });
+   * ```
+   */
+  onLogout() {
+    this.customerCartId = null;
+  }
   // -------------------- Checkout --------------------
   /**
    * Create a checkout from a cart
@@ -2697,6 +2886,42 @@ var OmniSyncClient = class {
     }
     throw new OmniSyncError("getMyProfile is only available in vibe-coded or storefront mode", 400);
   }
+  /**
+   * Get pre-fill data for checkout forms (requires customerToken).
+   * Returns customer profile and default address formatted for checkout.
+   * Use this to pre-populate shipping forms for logged-in customers.
+   *
+   * @example
+   * ```typescript
+   * omni.setCustomerToken(auth.token);
+   *
+   * const prefill = await omni.getCheckoutPrefillData();
+   *
+   * if (prefill.shippingAddress) {
+   *   // Pre-fill shipping form with customer's default address
+   *   setFormValues(prefill.shippingAddress);
+   * } else {
+   *   // Customer has no saved addresses, show empty form
+   *   // But still pre-fill email from customer profile
+   *   setFormValues({ email: prefill.customer.email });
+   * }
+   * ```
+   */
+  async getCheckoutPrefillData() {
+    if (!this.customerToken) {
+      throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/customers/me/checkout-prefill");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/customers/me/checkout-prefill");
+    }
+    throw new OmniSyncError(
+      "getCheckoutPrefillData is only available in vibe-coded or storefront mode",
+      400
+    );
+  }
   /**
    * Update the current customer's profile (requires customerToken)
    * Only available in storefront mode

package/package.json

@@ -1,76 +1,75 @@
-{
-  "name": "omni-sync-sdk",
-  "version": "0.16.0",
-  "description": "Official SDK for building e-commerce storefronts with OmniSync Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "eslint \"src/**/*.ts\"",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "pnpm build"
-  },
-  "keywords": [
-    "omni-sync",
-    "e-commerce",
-    "ecommerce",
-    "sdk",
-    "vibe-coding",
-    "vibe-coded",
-    "ai-commerce",
-    "storefront",
-    "headless-commerce",
-    "multi-platform",
-    "shopify",
-    "tiktok",
-    "cursor",
-    "lovable",
-    "v0",
-    "cart",
-    "checkout",
-    "products",
-    "sync"
-  ],
-  "author": "Omni-Sync Platform",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/omni-sync/omni-sync-platform.git",
-    "directory": "packages/sdk"
-  },
-  "homepage": "https://omni-sync.com",
-  "bugs": {
-    "url": "https://github.com/omni-sync/omni-sync-platform/issues"
-  },
-  "devDependencies": {
-    "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.1",
-    "@typescript-eslint/parser": "^8.50.1",
-    "eslint": "^9.39.2",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.0.0"
-  },
-  "peerDependencies": {
-    "typescript": ">=4.7.0"
-  },
-  "peerDependenciesMeta": {
-    "typescript": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "omni-sync-sdk",
+  "version": "0.16.2",
+  "description": "Official SDK for building e-commerce storefronts with OmniSync Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "omni-sync",
+    "e-commerce",
+    "ecommerce",
+    "sdk",
+    "vibe-coding",
+    "vibe-coded",
+    "ai-commerce",
+    "storefront",
+    "headless-commerce",
+    "multi-platform",
+    "shopify",
+    "tiktok",
+    "cursor",
+    "lovable",
+    "v0",
+    "cart",
+    "checkout",
+    "products",
+    "sync"
+  ],
+  "author": "Omni-Sync Platform",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/omni-sync/omni-sync-platform.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://omni-sync.com",
+  "bugs": {
+    "url": "https://github.com/omni-sync/omni-sync-platform/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint": "^9.39.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.7.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}