omni-sync-sdk 0.8.3 → 0.10.0

package/dist/index.d.mts

@@ -1000,6 +1000,37 @@ interface ReconcileInventoryResponse {
     reconciled?: number;
     discrepancies?: number;
 }
+interface StockAvailabilityRequest {
+    productId: string;
+    variantId?: string;
+    quantity: number;
+}
+interface StockAvailabilityResult {
+    productId: string;
+    variantId?: string | null;
+    isAvailable: boolean;
+    available: number;
+    requested: number;
+    shortfall: number;
+}
+interface StockAvailabilityResponse {
+    allAvailable: boolean;
+    results: StockAvailabilityResult[];
+}
+interface InsufficientStockError {
+    code: 'INSUFFICIENT_STOCK';
+    message: string;
+    available: number;
+    requested: number;
+    productId?: string;
+    variantId?: string;
+    items?: Array<{
+        productId: string;
+        variantId?: string;
+        available: number;
+        requested: number;
+    }>;
+}
 interface PublishProductResponse {
     productId: string;
     results: Record<string, {
@@ -1568,6 +1599,27 @@ declare class OmniSyncClient {
         productId?: string;
         autoFix?: boolean;
     }): Promise<ReconcileInventoryResponse>;
+    /**
+     * Check stock availability for one or more items before adding to cart or checkout
+     * Use this to validate stock before operations that might fail due to insufficient inventory
+     *
+     * @example
+     * ```typescript
+     * // Check if items are available before adding to cart
+     * const result = await omni.checkStockAvailability([
+     *   { productId: 'prod_123', quantity: 2 },
+     *   { productId: 'prod_456', variantId: 'var_789', quantity: 1 }
+     * ]);
+     *
+     * if (!result.allAvailable) {
+     *   const unavailable = result.results.filter(r => !r.isAvailable);
+     *   unavailable.forEach(item => {
+     *     console.log(`Only ${item.available} available for product ${item.productId}`);
+     *   });
+     * }
+     * ```
+     */
+    checkStockAvailability(items: StockAvailabilityRequest[]): Promise<StockAvailabilityResponse>;
     /**
      * Trigger a sync to a specific platform or all platforms
      */
@@ -2379,22 +2431,22 @@ declare class OmniSyncClient {
     }): Promise<PaginatedResponse<Order>>;
     /**
      * Get the current customer's addresses (requires customerToken)
-     * Only available in storefront mode
+     * Works in vibe-coded and storefront modes
      */
     getMyAddresses(): Promise<CustomerAddress[]>;
     /**
      * Add an address to the current customer (requires customerToken)
-     * Only available in storefront mode
+     * Works in vibe-coded and storefront modes
      */
     addMyAddress(address: CreateAddressDto): Promise<CustomerAddress>;
     /**
      * Update a customer address (requires customerToken)
-     * Only available in storefront mode
+     * Works in vibe-coded and storefront modes
      */
     updateMyAddress(addressId: string, data: UpdateAddressDto): Promise<CustomerAddress>;
     /**
      * Delete a customer address (requires customerToken)
-     * Only available in storefront mode
+     * Works in vibe-coded and storefront modes
      */
     deleteMyAddress(addressId: string): Promise<void>;
     /**
@@ -2556,4 +2608,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 FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, 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 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 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 WebhookEvent, type WebhookEventType, createWebhookHandler, isCouponApplicableToProduct, 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 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 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 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 WebhookEvent, type WebhookEventType, createWebhookHandler, isCouponApplicableToProduct, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.d.ts

@@ -1000,6 +1000,37 @@ interface ReconcileInventoryResponse {
     reconciled?: number;
     discrepancies?: number;
 }
+interface StockAvailabilityRequest {
+    productId: string;
+    variantId?: string;
+    quantity: number;
+}
+interface StockAvailabilityResult {
+    productId: string;
+    variantId?: string | null;
+    isAvailable: boolean;
+    available: number;
+    requested: number;
+    shortfall: number;
+}
+interface StockAvailabilityResponse {
+    allAvailable: boolean;
+    results: StockAvailabilityResult[];
+}
+interface InsufficientStockError {
+    code: 'INSUFFICIENT_STOCK';
+    message: string;
+    available: number;
+    requested: number;
+    productId?: string;
+    variantId?: string;
+    items?: Array<{
+        productId: string;
+        variantId?: string;
+        available: number;
+        requested: number;
+    }>;
+}
 interface PublishProductResponse {
     productId: string;
     results: Record<string, {
@@ -1568,6 +1599,27 @@ declare class OmniSyncClient {
         productId?: string;
         autoFix?: boolean;
     }): Promise<ReconcileInventoryResponse>;
+    /**
+     * Check stock availability for one or more items before adding to cart or checkout
+     * Use this to validate stock before operations that might fail due to insufficient inventory
+     *
+     * @example
+     * ```typescript
+     * // Check if items are available before adding to cart
+     * const result = await omni.checkStockAvailability([
+     *   { productId: 'prod_123', quantity: 2 },
+     *   { productId: 'prod_456', variantId: 'var_789', quantity: 1 }
+     * ]);
+     *
+     * if (!result.allAvailable) {
+     *   const unavailable = result.results.filter(r => !r.isAvailable);
+     *   unavailable.forEach(item => {
+     *     console.log(`Only ${item.available} available for product ${item.productId}`);
+     *   });
+     * }
+     * ```
+     */
+    checkStockAvailability(items: StockAvailabilityRequest[]): Promise<StockAvailabilityResponse>;
     /**
      * Trigger a sync to a specific platform or all platforms
      */
@@ -2379,22 +2431,22 @@ declare class OmniSyncClient {
     }): Promise<PaginatedResponse<Order>>;
     /**
      * Get the current customer's addresses (requires customerToken)
-     * Only available in storefront mode
+     * Works in vibe-coded and storefront modes
      */
     getMyAddresses(): Promise<CustomerAddress[]>;
     /**
      * Add an address to the current customer (requires customerToken)
-     * Only available in storefront mode
+     * Works in vibe-coded and storefront modes
      */
     addMyAddress(address: CreateAddressDto): Promise<CustomerAddress>;
     /**
      * Update a customer address (requires customerToken)
-     * Only available in storefront mode
+     * Works in vibe-coded and storefront modes
      */
     updateMyAddress(addressId: string, data: UpdateAddressDto): Promise<CustomerAddress>;
     /**
      * Delete a customer address (requires customerToken)
-     * Only available in storefront mode
+     * Works in vibe-coded and storefront modes
      */
     deleteMyAddress(addressId: string): Promise<void>;
     /**
@@ -2556,4 +2608,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 FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, 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 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 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 WebhookEvent, type WebhookEventType, createWebhookHandler, isCouponApplicableToProduct, 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 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 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 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 WebhookEvent, type WebhookEventType, createWebhookHandler, isCouponApplicableToProduct, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.js

@@ -880,6 +880,45 @@ var OmniSyncClient = class {
       queryParams
     );
   }
+  /**
+   * Check stock availability for one or more items before adding to cart or checkout
+   * Use this to validate stock before operations that might fail due to insufficient inventory
+   *
+   * @example
+   * ```typescript
+   * // Check if items are available before adding to cart
+   * const result = await omni.checkStockAvailability([
+   *   { productId: 'prod_123', quantity: 2 },
+   *   { productId: 'prod_456', variantId: 'var_789', quantity: 1 }
+   * ]);
+   *
+   * if (!result.allAvailable) {
+   *   const unavailable = result.results.filter(r => !r.isAvailable);
+   *   unavailable.forEach(item => {
+   *     console.log(`Only ${item.available} available for product ${item.productId}`);
+   *   });
+   * }
+   * ```
+   */
+  async checkStockAvailability(items) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "POST",
+        "/inventory/check-availability",
+        { items }
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "POST",
+        "/inventory/check-availability",
+        { items }
+      );
+    }
+    return this.request("POST", "/api/v1/inventory/check-availability", {
+      items
+    });
+  }
   // -------------------- Sync --------------------
   /**
    * Trigger a sync to a specific platform or all platforms
@@ -2301,26 +2340,32 @@ var OmniSyncClient = class {
    * ```
    */
   async getMyProfile() {
-    if (!this.storeId) {
-      throw new OmniSyncError("getMyProfile is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest("GET", "/customers/me");
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/customers/me");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/customers/me");
+    }
+    throw new OmniSyncError("getMyProfile is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Update the current customer's profile (requires customerToken)
    * Only available in storefront mode
    */
   async updateMyProfile(data) {
-    if (!this.storeId) {
-      throw new OmniSyncError("updateMyProfile is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest("PATCH", "/customers/me", data);
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("PATCH", "/customers/me", data);
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("PATCH", "/customers/me", data);
+    }
+    throw new OmniSyncError("updateMyProfile is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Get the current customer's orders (requires customerToken)
@@ -2354,59 +2399,77 @@ var OmniSyncClient = class {
   }
   /**
    * Get the current customer's addresses (requires customerToken)
-   * Only available in storefront mode
+   * Works in vibe-coded and storefront modes
    */
   async getMyAddresses() {
-    if (!this.storeId) {
-      throw new OmniSyncError("getMyAddresses is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest("GET", "/customers/me/addresses");
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/customers/me/addresses");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/customers/me/addresses");
+    }
+    throw new OmniSyncError("getMyAddresses is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Add an address to the current customer (requires customerToken)
-   * Only available in storefront mode
+   * Works in vibe-coded and storefront modes
    */
   async addMyAddress(address) {
-    if (!this.storeId) {
-      throw new OmniSyncError("addMyAddress is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest("POST", "/customers/me/addresses", address);
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/customers/me/addresses", address);
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/customers/me/addresses", address);
+    }
+    throw new OmniSyncError("addMyAddress is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Update a customer address (requires customerToken)
-   * Only available in storefront mode
+   * Works in vibe-coded and storefront modes
    */
   async updateMyAddress(addressId, data) {
-    if (!this.storeId) {
-      throw new OmniSyncError("updateMyAddress is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest(
-      "PATCH",
-      `/customers/me/addresses/${addressId}`,
-      data
-    );
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "PATCH",
+        `/customers/me/addresses/${addressId}`,
+        data
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "PATCH",
+        `/customers/me/addresses/${addressId}`,
+        data
+      );
+    }
+    throw new OmniSyncError("updateMyAddress is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Delete a customer address (requires customerToken)
-   * Only available in storefront mode
+   * Works in vibe-coded and storefront modes
    */
   async deleteMyAddress(addressId) {
-    if (!this.storeId) {
-      throw new OmniSyncError("deleteMyAddress is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    await this.storefrontRequest("DELETE", `/customers/me/addresses/${addressId}`);
+    if (this.isVibeCodedMode()) {
+      await this.vibeCodedRequest("DELETE", `/customers/me/addresses/${addressId}`);
+      return;
+    }
+    if (this.storeId && !this.apiKey) {
+      await this.storefrontRequest("DELETE", `/customers/me/addresses/${addressId}`);
+      return;
+    }
+    throw new OmniSyncError("deleteMyAddress is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Get the current customer's cart (requires customerToken)

package/dist/index.mjs

@@ -855,6 +855,45 @@ var OmniSyncClient = class {
       queryParams
     );
   }
+  /**
+   * Check stock availability for one or more items before adding to cart or checkout
+   * Use this to validate stock before operations that might fail due to insufficient inventory
+   *
+   * @example
+   * ```typescript
+   * // Check if items are available before adding to cart
+   * const result = await omni.checkStockAvailability([
+   *   { productId: 'prod_123', quantity: 2 },
+   *   { productId: 'prod_456', variantId: 'var_789', quantity: 1 }
+   * ]);
+   *
+   * if (!result.allAvailable) {
+   *   const unavailable = result.results.filter(r => !r.isAvailable);
+   *   unavailable.forEach(item => {
+   *     console.log(`Only ${item.available} available for product ${item.productId}`);
+   *   });
+   * }
+   * ```
+   */
+  async checkStockAvailability(items) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "POST",
+        "/inventory/check-availability",
+        { items }
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "POST",
+        "/inventory/check-availability",
+        { items }
+      );
+    }
+    return this.request("POST", "/api/v1/inventory/check-availability", {
+      items
+    });
+  }
   // -------------------- Sync --------------------
   /**
    * Trigger a sync to a specific platform or all platforms
@@ -2276,26 +2315,32 @@ var OmniSyncClient = class {
    * ```
    */
   async getMyProfile() {
-    if (!this.storeId) {
-      throw new OmniSyncError("getMyProfile is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest("GET", "/customers/me");
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/customers/me");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/customers/me");
+    }
+    throw new OmniSyncError("getMyProfile is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Update the current customer's profile (requires customerToken)
    * Only available in storefront mode
    */
   async updateMyProfile(data) {
-    if (!this.storeId) {
-      throw new OmniSyncError("updateMyProfile is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest("PATCH", "/customers/me", data);
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("PATCH", "/customers/me", data);
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("PATCH", "/customers/me", data);
+    }
+    throw new OmniSyncError("updateMyProfile is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Get the current customer's orders (requires customerToken)
@@ -2329,59 +2374,77 @@ var OmniSyncClient = class {
   }
   /**
    * Get the current customer's addresses (requires customerToken)
-   * Only available in storefront mode
+   * Works in vibe-coded and storefront modes
    */
   async getMyAddresses() {
-    if (!this.storeId) {
-      throw new OmniSyncError("getMyAddresses is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest("GET", "/customers/me/addresses");
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/customers/me/addresses");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/customers/me/addresses");
+    }
+    throw new OmniSyncError("getMyAddresses is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Add an address to the current customer (requires customerToken)
-   * Only available in storefront mode
+   * Works in vibe-coded and storefront modes
    */
   async addMyAddress(address) {
-    if (!this.storeId) {
-      throw new OmniSyncError("addMyAddress is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest("POST", "/customers/me/addresses", address);
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/customers/me/addresses", address);
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/customers/me/addresses", address);
+    }
+    throw new OmniSyncError("addMyAddress is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Update a customer address (requires customerToken)
-   * Only available in storefront mode
+   * Works in vibe-coded and storefront modes
    */
   async updateMyAddress(addressId, data) {
-    if (!this.storeId) {
-      throw new OmniSyncError("updateMyAddress is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    return this.storefrontRequest(
-      "PATCH",
-      `/customers/me/addresses/${addressId}`,
-      data
-    );
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "PATCH",
+        `/customers/me/addresses/${addressId}`,
+        data
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "PATCH",
+        `/customers/me/addresses/${addressId}`,
+        data
+      );
+    }
+    throw new OmniSyncError("updateMyAddress is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Delete a customer address (requires customerToken)
-   * Only available in storefront mode
+   * Works in vibe-coded and storefront modes
    */
   async deleteMyAddress(addressId) {
-    if (!this.storeId) {
-      throw new OmniSyncError("deleteMyAddress is only available in storefront mode", 400);
-    }
     if (!this.customerToken) {
       throw new OmniSyncError("Customer token required. Call setCustomerToken() after login.", 401);
     }
-    await this.storefrontRequest("DELETE", `/customers/me/addresses/${addressId}`);
+    if (this.isVibeCodedMode()) {
+      await this.vibeCodedRequest("DELETE", `/customers/me/addresses/${addressId}`);
+      return;
+    }
+    if (this.storeId && !this.apiKey) {
+      await this.storefrontRequest("DELETE", `/customers/me/addresses/${addressId}`);
+      return;
+    }
+    throw new OmniSyncError("deleteMyAddress is only available in vibe-coded or storefront mode", 400);
   }
   /**
    * Get the current customer's cart (requires customerToken)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-sync-sdk",
-  "version": "0.8.3",
+  "version": "0.10.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",