omni-sync-sdk 0.9.0 → 0.11.0

package/README.md

@@ -280,9 +280,9 @@ const response: PaginatedResponse<Product> = await omni.getProducts({
   sortOrder: 'desc', // Optional: 'asc' | 'desc'
 });
 
-console.log(response.data); // Product[]
-console.log(response.meta.total); // Total number of products
-console.log(response.meta.totalPages); // Total pages
+console.log(response.items); // Product[]
+console.log(response.total); // Total number of products
+console.log(response.totalPages); // Total pages
 ```
 
 #### Get Single Product
@@ -1710,8 +1710,8 @@ export default function ProductsPage() {
         <button onClick={() => setPage(p => Math.max(1, p - 1))} disabled={page === 1}>
           Previous
         </button>
-        <span>Page {data.meta.page} of {data.meta.totalPages}</span>
-        <button onClick={() => setPage(p => p + 1)} disabled={page >= data.meta.totalPages}>
+        <span>Page {data.page} of {data.totalPages}</span>
+        <button onClick={() => setPage(p => p + 1)} disabled={page >= data.totalPages}>
           Next
         </button>
       </div>
@@ -2606,7 +2606,7 @@ export default function AccountPage() {
           omni.getMyOrders({ limit: 10 }),
         ]);
         setProfile(p);
-        setOrders(o.data);
+        setOrders(o.items);
       } finally {
         setLoading(false);
       }

package/dist/index.d.mts

@@ -149,13 +149,11 @@ interface SearchSuggestions {
     categories: CategorySuggestion[];
 }
 interface PaginatedResponse<T> {
-    data: T[];
-    meta: {
-        page: number;
-        limit: number;
-        total: number;
-        totalPages: number;
-    };
+    items: T[];
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
 }
 interface CreateProductDto {
     name: string;
@@ -1967,7 +1965,7 @@ declare class OmniSyncClient {
      * @example
      * ```typescript
      * const orders = await omni.getCustomerOrders('cust_123', { page: 1, limit: 10 });
-     * console.log(`Customer has ${orders.meta.total} total orders`);
+     * console.log(`Customer has ${orders.total} total orders`);
      * ```
      */
     getCustomerOrders(customerId: string, params?: {
@@ -2431,22 +2429,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>;
     /**

package/dist/index.d.ts

@@ -149,13 +149,11 @@ interface SearchSuggestions {
     categories: CategorySuggestion[];
 }
 interface PaginatedResponse<T> {
-    data: T[];
-    meta: {
-        page: number;
-        limit: number;
-        total: number;
-        totalPages: number;
-    };
+    items: T[];
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
 }
 interface CreateProductDto {
     name: string;
@@ -1967,7 +1965,7 @@ declare class OmniSyncClient {
      * @example
      * ```typescript
      * const orders = await omni.getCustomerOrders('cust_123', { page: 1, limit: 10 });
-     * console.log(`Customer has ${orders.meta.total} total orders`);
+     * console.log(`Customer has ${orders.total} total orders`);
      * ```
      */
     getCustomerOrders(customerId: string, params?: {
@@ -2431,22 +2429,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>;
     /**

package/dist/index.js

@@ -915,11 +915,9 @@ var OmniSyncClient = class {
         { items }
       );
     }
-    return this.request(
-      "POST",
-      "/api/v1/inventory/check-availability",
-      { items }
-    );
+    return this.request("POST", "/api/v1/inventory/check-availability", {
+      items
+    });
   }
   // -------------------- Sync --------------------
   /**
@@ -1499,7 +1497,7 @@ var OmniSyncClient = class {
    * @example
    * ```typescript
    * const orders = await omni.getCustomerOrders('cust_123', { page: 1, limit: 10 });
-   * console.log(`Customer has ${orders.meta.total} total orders`);
+   * console.log(`Customer has ${orders.total} total orders`);
    * ```
    */
   async getCustomerOrders(customerId, params) {
@@ -2342,26 +2340,35 @@ 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)
@@ -2395,59 +2402,86 @@ 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

@@ -890,11 +890,9 @@ var OmniSyncClient = class {
         { items }
       );
     }
-    return this.request(
-      "POST",
-      "/api/v1/inventory/check-availability",
-      { items }
-    );
+    return this.request("POST", "/api/v1/inventory/check-availability", {
+      items
+    });
   }
   // -------------------- Sync --------------------
   /**
@@ -1474,7 +1472,7 @@ var OmniSyncClient = class {
    * @example
    * ```typescript
    * const orders = await omni.getCustomerOrders('cust_123', { page: 1, limit: 10 });
-   * console.log(`Customer has ${orders.meta.total} total orders`);
+   * console.log(`Customer has ${orders.total} total orders`);
    * ```
    */
   async getCustomerOrders(customerId, params) {
@@ -2317,26 +2315,35 @@ 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)
@@ -2370,59 +2377,86 @@ 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.9.0",
+  "version": "0.11.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",