omni-sync-sdk 0.1.1 → 0.3.0

package/dist/index.js

@@ -35,18 +35,86 @@ var DEFAULT_BASE_URL = "https://api.omni-sync.com";
 var DEFAULT_TIMEOUT = 3e4;
 var OmniSyncClient = class {
   constructor(options) {
-    if (!options.apiKey) {
-      throw new Error("OmniSyncClient: apiKey is required");
+    this.customerToken = null;
+    if (!options.apiKey && !options.storeId && !options.connectionId) {
+      throw new Error("OmniSyncClient: either connectionId, apiKey, or storeId is required");
     }
-    if (!options.apiKey.startsWith("omni_")) {
+    if (options.apiKey && !options.apiKey.startsWith("omni_")) {
       console.warn('OmniSyncClient: apiKey should start with "omni_"');
     }
+    if (options.connectionId && !options.connectionId.startsWith("vc_")) {
+      console.warn('OmniSyncClient: connectionId should start with "vc_"');
+    }
+    if (options.apiKey && typeof window !== "undefined") {
+      console.warn(
+        "OmniSyncClient: WARNING - API key detected in browser environment. This is a security risk! Use connectionId or storeId for frontend applications."
+      );
+    }
     this.apiKey = options.apiKey;
+    this.storeId = options.storeId;
+    this.connectionId = options.connectionId;
     this.baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.timeout = options.timeout || DEFAULT_TIMEOUT;
   }
+  // -------------------- Mode Detection --------------------
+  /**
+   * Check if client is in vibe-coded mode (using connectionId)
+   */
+  isVibeCodedMode() {
+    return !!this.connectionId && !this.apiKey;
+  }
+  /**
+   * Check if client is in storefront mode (using storeId)
+   */
+  isStorefrontMode() {
+    return !!this.storeId && !this.apiKey && !this.connectionId;
+  }
+  /**
+   * Check if client is in admin mode (using apiKey)
+   */
+  isAdminMode() {
+    return !!this.apiKey;
+  }
+  // -------------------- Customer Token Management --------------------
+  /**
+   * Set the customer authentication token (obtained from login/register).
+   * Required for accessing customer-specific data in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const auth = await omni.loginCustomer('user@example.com', 'password');
+   * omni.setCustomerToken(auth.token);
+   *
+   * // Now can access customer data
+   * const profile = await omni.getMyProfile();
+   * ```
+   */
+  setCustomerToken(token) {
+    this.customerToken = token;
+  }
+  /**
+   * Get the current customer token
+   */
+  getCustomerToken() {
+    return this.customerToken;
+  }
+  /**
+   * Clear the customer token (logout)
+   */
+  clearCustomerToken() {
+    this.customerToken = null;
+  }
   // -------------------- Private Methods --------------------
-  async request(method, path, body, queryParams) {
+  /**
+   * Make a request to the Admin API (requires apiKey)
+   */
+  async adminRequest(method, path, body, queryParams) {
+    if (!this.apiKey) {
+      throw new OmniSyncError(
+        "This operation requires an API key. Initialize with apiKey instead of storeId.",
+        403
+      );
+    }
     const url = new URL(`${this.baseUrl}${path}`);
     if (queryParams) {
       Object.entries(queryParams).forEach(([key, value]) => {
@@ -63,9 +131,8 @@ var OmniSyncClient = class {
         headers: {
           Authorization: `Bearer ${this.apiKey}`,
           "Content-Type": "application/json",
-          "X-SDK-Version": "0.1.0",
+          "X-SDK-Version": "0.3.0",
           "ngrok-skip-browser-warning": "true"
-          // Skip ngrok warning page for dev tunnels
         },
         body: body ? JSON.stringify(body) : void 0,
         signal: controller.signal
@@ -96,12 +163,149 @@ var OmniSyncClient = class {
       throw new OmniSyncError("Unknown error occurred", 0);
     }
   }
+  /**
+   * Make a request to the Vibe-Coded API (public, uses connectionId)
+   */
+  async vibeCodedRequest(method, path, body, queryParams) {
+    if (!this.connectionId) {
+      throw new OmniSyncError("connectionId is required for vibe-coded requests", 400);
+    }
+    const url = new URL(`${this.baseUrl}/api/vc/${this.connectionId}${path}`);
+    if (queryParams) {
+      Object.entries(queryParams).forEach(([key, value]) => {
+        if (value !== void 0) {
+          url.searchParams.set(key, String(value));
+        }
+      });
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const headers = {
+        "Content-Type": "application/json",
+        "X-SDK-Version": "0.3.0",
+        "ngrok-skip-browser-warning": "true"
+      };
+      const response = await fetch(url.toString(), {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new OmniSyncError(
+          errorData.message || `Request failed with status ${response.status}`,
+          response.status,
+          errorData
+        );
+      }
+      const text = await response.text();
+      if (!text) return {};
+      return JSON.parse(text);
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof OmniSyncError) {
+        throw error;
+      }
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new OmniSyncError("Request timeout", 408);
+        }
+        throw new OmniSyncError(error.message, 0);
+      }
+      throw new OmniSyncError("Unknown error occurred", 0);
+    }
+  }
+  /**
+   * Make a request to the Storefront API (public, uses storeId)
+   */
+  async storefrontRequest(method, path, body, queryParams) {
+    if (!this.storeId) {
+      throw new OmniSyncError("storeId is required for storefront requests", 400);
+    }
+    const url = new URL(`${this.baseUrl}/stores/${this.storeId}${path}`);
+    if (queryParams) {
+      Object.entries(queryParams).forEach(([key, value]) => {
+        if (value !== void 0) {
+          url.searchParams.set(key, String(value));
+        }
+      });
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const headers = {
+        "Content-Type": "application/json",
+        "X-SDK-Version": "0.3.0",
+        "ngrok-skip-browser-warning": "true"
+      };
+      if (this.customerToken) {
+        headers["Authorization"] = `Bearer ${this.customerToken}`;
+      }
+      const response = await fetch(url.toString(), {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new OmniSyncError(
+          errorData.message || `Request failed with status ${response.status}`,
+          response.status,
+          errorData
+        );
+      }
+      const text = await response.text();
+      if (!text) return {};
+      return JSON.parse(text);
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof OmniSyncError) {
+        throw error;
+      }
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new OmniSyncError("Request timeout", 408);
+        }
+        throw new OmniSyncError(error.message, 0);
+      }
+      throw new OmniSyncError("Unknown error occurred", 0);
+    }
+  }
+  /**
+   * Smart request - uses storefront or admin API based on client mode
+   */
+  async request(method, path, body, queryParams) {
+    if (this.apiKey) {
+      return this.adminRequest(method, path, body, queryParams);
+    }
+    return this.storefrontRequest(method, path, body, queryParams);
+  }
+  // -------------------- Store Info --------------------
+  /**
+   * Get store information
+   * Works in vibe-coded, storefront, and admin mode
+   */
+  async getStoreInfo() {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/info");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/info");
+    }
+    return this.adminRequest("GET", "/api/v1/store");
+  }
   // -------------------- Products --------------------
   /**
    * Get a list of products with pagination
+   * Works in vibe-coded, storefront (public), and admin mode
    */
   async getProducts(params) {
-    return this.request("GET", "/api/v1/products", void 0, {
+    const queryParams = {
       page: params?.page,
       limit: params?.limit,
       search: params?.search,
@@ -109,13 +313,42 @@ var OmniSyncClient = class {
       type: params?.type,
       sortBy: params?.sortBy,
       sortOrder: params?.sortOrder
-    });
+    };
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "GET",
+        "/products",
+        void 0,
+        queryParams
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "GET",
+        "/products",
+        void 0,
+        queryParams
+      );
+    }
+    return this.adminRequest(
+      "GET",
+      "/api/v1/products",
+      void 0,
+      queryParams
+    );
   }
   /**
    * Get a single product by ID
+   * Works in vibe-coded, storefront (public), and admin mode
    */
   async getProduct(productId) {
-    return this.request("GET", `/api/v1/products/${productId}`);
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", `/products/${productId}`);
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", `/products/${productId}`);
+    }
+    return this.adminRequest("GET", `/api/v1/products/${productId}`);
   }
   /**
    * Create a new product
@@ -135,6 +368,147 @@ var OmniSyncClient = class {
   async deleteProduct(productId) {
     await this.request("DELETE", `/api/v1/products/${productId}`);
   }
+  /**
+   * Convert a SIMPLE product to VARIABLE product
+   *
+   * @example
+   * ```typescript
+   * const product = await omni.convertToVariable('prod_123');
+   * console.log('Product type:', product.type); // 'VARIABLE'
+   * ```
+   */
+  async convertToVariable(productId) {
+    return this.request("PATCH", `/api/v1/products/${productId}/convert-to-variable`);
+  }
+  /**
+   * Convert a VARIABLE product to SIMPLE product
+   * Note: This will delete all variants
+   *
+   * @example
+   * ```typescript
+   * const product = await omni.convertToSimple('prod_123');
+   * console.log('Product type:', product.type); // 'SIMPLE'
+   * ```
+   */
+  async convertToSimple(productId) {
+    return this.request("PATCH", `/api/v1/products/${productId}/convert-to-simple`);
+  }
+  /**
+   * Publish a product to specific platforms
+   *
+   * @example
+   * ```typescript
+   * const result = await omni.publishProduct('prod_123', ['SHOPIFY', 'WOOCOMMERCE']);
+   * console.log('Publish results:', result.results);
+   * ```
+   */
+  async publishProduct(productId, platforms) {
+    return this.request("POST", `/api/v1/products/${productId}/publish`, {
+      platforms
+    });
+  }
+  // -------------------- Variants --------------------
+  /**
+   * Create a new variant for a product
+   *
+   * @example
+   * ```typescript
+   * const variant = await omni.createVariant('prod_123', {
+   *   sku: 'PROD-SM-RED',
+   *   name: 'Small / Red',
+   *   attributes: { size: 'S', color: 'Red' },
+   *   price: 29.99,
+   *   inventory: 100,
+   * });
+   * ```
+   */
+  async createVariant(productId, data) {
+    return this.request("POST", `/api/v1/products/${productId}/variants`, data);
+  }
+  /**
+   * Bulk save variants (create, update, delete in one operation)
+   *
+   * @example
+   * ```typescript
+   * const result = await omni.bulkSaveVariants('prod_123', {
+   *   variants: [
+   *     { sku: 'SM-RED', attributes: { size: 'S', color: 'Red' }, stock: 10, isEnabled: true },
+   *     { id: 'var_456', sku: 'MD-BLUE', attributes: { size: 'M', color: 'Blue' }, stock: 5, isEnabled: true },
+   *     { id: 'var_789', sku: 'LG-GREEN', attributes: {}, stock: 0, isEnabled: false, isDeleted: true },
+   *   ],
+   * });
+   * console.log(`Created: ${result.created}, Updated: ${result.updated}, Deleted: ${result.deleted}`);
+   * ```
+   */
+  async bulkSaveVariants(productId, data) {
+    return this.request(
+      "POST",
+      `/api/v1/products/${productId}/variants/bulk`,
+      data
+    );
+  }
+  /**
+   * Update a variant
+   *
+   * @example
+   * ```typescript
+   * const variant = await omni.updateVariant('prod_123', 'var_456', {
+   *   price: 34.99,
+   *   salePrice: 29.99,
+   * });
+   * ```
+   */
+  async updateVariant(productId, variantId, data) {
+    return this.request(
+      "PATCH",
+      `/api/v1/products/${productId}/variants/${variantId}`,
+      data
+    );
+  }
+  /**
+   * Delete a variant
+   *
+   * @example
+   * ```typescript
+   * await omni.deleteVariant('prod_123', 'var_456');
+   * ```
+   */
+  async deleteVariant(productId, variantId) {
+    await this.request("DELETE", `/api/v1/products/${productId}/variants/${variantId}`);
+  }
+  /**
+   * Get inventory for a specific variant
+   *
+   * @example
+   * ```typescript
+   * const inventory = await omni.getVariantInventory('prod_123', 'var_456');
+   * console.log('Available:', inventory.available);
+   * ```
+   */
+  async getVariantInventory(productId, variantId) {
+    return this.request(
+      "GET",
+      `/api/v1/products/${productId}/variants/${variantId}/inventory`
+    );
+  }
+  /**
+   * Update inventory for a specific variant
+   *
+   * @example
+   * ```typescript
+   * const inventory = await omni.updateVariantInventory('prod_123', 'var_456', {
+   *   newTotal: 50,
+   *   reason: 'Restocked from supplier',
+   * });
+   * ```
+   */
+  async updateVariantInventory(productId, variantId, data) {
+    return this.request(
+      "PATCH",
+      `/api/v1/products/${productId}/variants/${variantId}/inventory`,
+      data
+    );
+  }
   // -------------------- Orders --------------------
   /**
    * Get a list of orders with pagination
@@ -167,6 +541,209 @@ var OmniSyncClient = class {
   async updateOrder(orderId, data) {
     return this.request("PATCH", `/api/v1/orders/${orderId}`, data);
   }
+  /**
+   * Update order status
+   *
+   * @example
+   * ```typescript
+   * const order = await omni.updateOrderStatus('order_123', 'shipped');
+   * ```
+   */
+  async updateOrderStatus(orderId, status) {
+    return this.request("PATCH", `/api/v1/orders/${orderId}/status`, { status });
+  }
+  /**
+   * Update order payment method
+   * Note: Only WooCommerce supports syncing payment method changes back to platform
+   *
+   * @example
+   * ```typescript
+   * const order = await omni.updatePaymentMethod('order_123', 'credit_card');
+   * ```
+   */
+  async updatePaymentMethod(orderId, paymentMethod) {
+    return this.request("PATCH", `/api/v1/orders/${orderId}/payment-method`, {
+      paymentMethod
+    });
+  }
+  /**
+   * Update order notes
+   *
+   * @example
+   * ```typescript
+   * const order = await omni.updateOrderNotes('order_123', 'Customer requested gift wrapping');
+   * ```
+   */
+  async updateOrderNotes(orderId, notes) {
+    return this.request("PATCH", `/api/v1/orders/${orderId}/notes`, { notes });
+  }
+  /**
+   * Get refunds for an order
+   * Returns refunds from the source platform (Shopify/WooCommerce only)
+   *
+   * @example
+   * ```typescript
+   * const refunds = await omni.getOrderRefunds('order_123');
+   * console.log('Total refunds:', refunds.length);
+   * ```
+   */
+  async getOrderRefunds(orderId) {
+    return this.request("GET", `/api/v1/orders/${orderId}/refunds`);
+  }
+  /**
+   * Create a refund for an order
+   * Creates refund on the source platform (Shopify/WooCommerce only)
+   *
+   * @example
+   * ```typescript
+   * // Full refund
+   * const refund = await omni.createRefund('order_123', {
+   *   type: 'full',
+   *   restockInventory: true,
+   *   notifyCustomer: true,
+   *   reason: 'Customer request',
+   * });
+   *
+   * // Partial refund
+   * const partialRefund = await omni.createRefund('order_123', {
+   *   type: 'partial',
+   *   items: [
+   *     { lineItemId: 'item_456', quantity: 1 },
+   *   ],
+   *   restockInventory: true,
+   * });
+   * ```
+   */
+  async createRefund(orderId, data) {
+    return this.request("POST", `/api/v1/orders/${orderId}/refunds`, data);
+  }
+  /**
+   * Update order shipping address
+   * Syncs to source platform (Shopify/WooCommerce only)
+   *
+   * @example
+   * ```typescript
+   * const order = await omni.updateOrderShipping('order_123', {
+   *   firstName: 'John',
+   *   lastName: 'Doe',
+   *   line1: '456 New Address',
+   *   city: 'Los Angeles',
+   *   state: 'CA',
+   *   country: 'US',
+   *   postalCode: '90001',
+   * });
+   * ```
+   */
+  async updateOrderShipping(orderId, data) {
+    return this.request("PATCH", `/api/v1/orders/${orderId}/shipping`, data);
+  }
+  /**
+   * Cancel an order
+   * Works for Shopify and WooCommerce orders that haven't been fulfilled
+   *
+   * @example
+   * ```typescript
+   * const order = await omni.cancelOrder('order_123');
+   * console.log('Order status:', order.status); // 'cancelled'
+   * ```
+   */
+  async cancelOrder(orderId) {
+    return this.request("POST", `/api/v1/orders/${orderId}/cancel`);
+  }
+  /**
+   * Fulfill an order (mark as shipped)
+   * Works for Shopify and WooCommerce orders
+   *
+   * @example
+   * ```typescript
+   * const order = await omni.fulfillOrder('order_123', {
+   *   trackingNumber: '1Z999AA10123456784',
+   *   trackingCompany: 'UPS',
+   *   notifyCustomer: true,
+   * });
+   * ```
+   */
+  async fulfillOrder(orderId, data) {
+    return this.request("POST", `/api/v1/orders/${orderId}/fulfill`, data || {});
+  }
+  /**
+   * Sync draft orders from connected platforms
+   *
+   * @example
+   * ```typescript
+   * const result = await omni.syncDraftOrders();
+   * console.log('Draft orders synced');
+   * ```
+   */
+  async syncDraftOrders() {
+    return this.request("POST", "/api/v1/orders/sync-drafts");
+  }
+  /**
+   * Complete a draft order (convert to regular order)
+   *
+   * @example
+   * ```typescript
+   * const order = await omni.completeDraftOrder('draft_123', {
+   *   paymentPending: false,
+   * });
+   * ```
+   */
+  async completeDraftOrder(orderId, data) {
+    return this.request("POST", `/api/v1/orders/${orderId}/complete-draft`, data || {});
+  }
+  /**
+   * Send invoice for a draft order
+   *
+   * @example
+   * ```typescript
+   * await omni.sendDraftInvoice('draft_123', {
+   *   to: 'customer@example.com',
+   *   subject: 'Your Invoice',
+   *   customMessage: 'Thank you for your order!',
+   * });
+   * ```
+   */
+  async sendDraftInvoice(orderId, data) {
+    return this.request(
+      "POST",
+      `/api/v1/orders/${orderId}/send-invoice`,
+      data || {}
+    );
+  }
+  /**
+   * Delete a draft order
+   *
+   * @example
+   * ```typescript
+   * await omni.deleteDraftOrder('draft_123');
+   * ```
+   */
+  async deleteDraftOrder(orderId) {
+    await this.request("DELETE", `/api/v1/orders/${orderId}/draft`);
+  }
+  /**
+   * Update a draft order
+   *
+   * @example
+   * ```typescript
+   * const order = await omni.updateDraftOrder('draft_123', {
+   *   note: 'Updated customer note',
+   *   email: 'newemail@example.com',
+   *   shippingAddress: {
+   *     firstName: 'John',
+   *     lastName: 'Doe',
+   *     address1: '123 Main St',
+   *     city: 'New York',
+   *     province: 'NY',
+   *     country: 'US',
+   *     zip: '10001',
+   *   },
+   * });
+   * ```
+   */
+  async updateDraftOrder(orderId, data) {
+    return this.request("PATCH", `/api/v1/orders/${orderId}/draft`, data);
+  }
   // -------------------- Inventory --------------------
   /**
    * Update inventory for a product
@@ -179,7 +756,74 @@ var OmniSyncClient = class {
    * Get current inventory for a product
    */
   async getInventory(productId) {
-    return this.request("GET", `/api/v1/products/${productId}/inventory`);
+    return this.request("GET", `/api/v1/inventory/${productId}`);
+  }
+  /**
+   * Edit inventory manually with reason for audit trail
+   *
+   * @example
+   * ```typescript
+   * const inventory = await omni.editInventory({
+   *   productId: 'prod_123',
+   *   newTotal: 100,
+   *   reason: 'Restocked from warehouse',
+   * });
+   * ```
+   */
+  async editInventory(data) {
+    return this.request("POST", "/api/v1/inventory/edit", data);
+  }
+  /**
+   * Get inventory sync status for all products in the store
+   *
+   * @example
+   * ```typescript
+   * const status = await omni.getInventorySyncStatus();
+   * console.log(`${status.pending} products pending sync`);
+   * console.log(`Last sync: ${status.lastSyncAt}`);
+   * ```
+   */
+  async getInventorySyncStatus() {
+    return this.request("GET", "/api/v1/inventory/sync-status");
+  }
+  /**
+   * Get inventory for multiple products at once
+   *
+   * @example
+   * ```typescript
+   * const inventories = await omni.getBulkInventory(['prod_123', 'prod_456', 'prod_789']);
+   * inventories.forEach(inv => {
+   *   console.log(`${inv.productId}: ${inv.available} available`);
+   * });
+   * ```
+   */
+  async getBulkInventory(productIds) {
+    return this.request("POST", "/api/v1/inventory/bulk", { productIds });
+  }
+  /**
+   * Reconcile inventory between OmniSync and connected platforms
+   * Detects and optionally fixes discrepancies
+   *
+   * @example
+   * ```typescript
+   * // Reconcile single product (dry run)
+   * const result = await omni.reconcileInventory({ productId: 'prod_123' });
+   *
+   * // Reconcile all products with auto-fix
+   * const summary = await omni.reconcileInventory({ autoFix: true });
+   * console.log(`Reconciled ${summary.reconciled} products`);
+   * ```
+   */
+  async reconcileInventory(options) {
+    const queryParams = {};
+    if (options?.productId) queryParams.productId = options.productId;
+    if (options?.autoFix) queryParams.autoFix = "true";
+    return this.request(
+      "POST",
+      "/api/v1/inventory/reconcile",
+      void 0,
+      queryParams
+    );
   }
   // -------------------- Sync --------------------
   /**
@@ -194,13 +838,6 @@ var OmniSyncClient = class {
   async getSyncStatus(jobId) {
     return this.request("GET", `/api/v1/sync/${jobId}`);
   }
-  // -------------------- Store Info --------------------
-  /**
-   * Get information about the connected store
-   */
-  async getStoreInfo() {
-    return this.request("GET", "/api/v1/store");
-  }
   // -------------------- Coupons --------------------
   /**
    * Get a list of coupons with pagination
@@ -343,7 +980,13 @@ var OmniSyncClient = class {
    * ```
    */
   async loginCustomer(email, password) {
-    return this.request("POST", "/api/v1/customers/login", {
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/customers/login", {
+        email,
+        password
+      });
+    }
+    return this.adminRequest("POST", "/api/v1/customers/login", {
       email,
       password
     });
@@ -362,13 +1005,21 @@ var OmniSyncClient = class {
    * ```
    */
   async registerCustomer(data) {
-    return this.request("POST", "/api/v1/customers/register", data);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/customers/register", data);
+    }
+    return this.adminRequest("POST", "/api/v1/customers/register", data);
   }
   /**
    * Request a password reset email for a customer
    */
   async forgotPassword(email) {
-    return this.request("POST", "/api/v1/customers/forgot-password", {
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/customers/forgot-password", {
+        email
+      });
+    }
+    return this.adminRequest("POST", "/api/v1/customers/forgot-password", {
       email
     });
   }
@@ -448,7 +1099,10 @@ var OmniSyncClient = class {
    * ```
    */
   async createCart() {
-    return this.request("POST", "/api/v1/cart");
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/cart");
+    }
+    return this.adminRequest("POST", "/api/v1/cart");
   }
   /**
    * Get a cart by session token (for guest users)
@@ -460,7 +1114,10 @@ var OmniSyncClient = class {
    * ```
    */
   async getCartBySession(sessionToken) {
-    return this.request("GET", `/api/v1/cart/session/${sessionToken}`);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", `/cart/session/${sessionToken}`);
+    }
+    return this.adminRequest("GET", `/api/v1/cart/session/${sessionToken}`);
   }
   /**
    * Get a cart by customer ID (for authenticated users)
@@ -472,13 +1129,19 @@ var OmniSyncClient = class {
    * ```
    */
   async getCartByCustomer(customerId) {
-    return this.request("GET", `/api/v1/cart/customer/${customerId}`);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", `/cart/customer/${customerId}`);
+    }
+    return this.adminRequest("GET", `/api/v1/cart/customer/${customerId}`);
   }
   /**
    * Get a cart by ID
    */
   async getCart(cartId) {
-    return this.request("GET", `/api/v1/cart/${cartId}`);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", `/cart/${cartId}`);
+    }
+    return this.adminRequest("GET", `/api/v1/cart/${cartId}`);
   }
   /**
    * Add an item to the cart
@@ -493,7 +1156,10 @@ var OmniSyncClient = class {
    * ```
    */
   async addToCart(cartId, item) {
-    return this.request("POST", `/api/v1/cart/${cartId}/items`, item);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", `/cart/${cartId}/items`, item);
+    }
+    return this.adminRequest("POST", `/api/v1/cart/${cartId}/items`, item);
   }
   /**
    * Update an item quantity in the cart
@@ -504,7 +1170,10 @@ var OmniSyncClient = class {
    * ```
    */
   async updateCartItem(cartId, itemId, data) {
-    return this.request("PATCH", `/api/v1/cart/${cartId}/items/${itemId}`, data);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("PATCH", `/cart/${cartId}/items/${itemId}`, data);
+    }
+    return this.adminRequest("PATCH", `/api/v1/cart/${cartId}/items/${itemId}`, data);
   }
   /**
    * Remove an item from the cart
@@ -515,7 +1184,10 @@ var OmniSyncClient = class {
    * ```
    */
   async removeCartItem(cartId, itemId) {
-    return this.request("DELETE", `/api/v1/cart/${cartId}/items/${itemId}`);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("DELETE", `/cart/${cartId}/items/${itemId}`);
+    }
+    return this.adminRequest("DELETE", `/api/v1/cart/${cartId}/items/${itemId}`);
   }
   /**
    * Clear all items from the cart
@@ -526,7 +1198,11 @@ var OmniSyncClient = class {
    * ```
    */
   async clearCart(cartId) {
-    await this.request("DELETE", `/api/v1/cart/${cartId}/items`);
+    if (this.storeId && !this.apiKey) {
+      await this.storefrontRequest("DELETE", `/cart/${cartId}/items`);
+      return;
+    }
+    await this.adminRequest("DELETE", `/api/v1/cart/${cartId}/items`);
   }
   /**
    * Apply a coupon to the cart
@@ -538,7 +1214,10 @@ var OmniSyncClient = class {
    * ```
    */
   async applyCoupon(cartId, code) {
-    return this.request("POST", `/api/v1/cart/${cartId}/coupon`, { code });
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", `/cart/${cartId}/coupon`, { code });
+    }
+    return this.adminRequest("POST", `/api/v1/cart/${cartId}/coupon`, { code });
   }
   /**
    * Remove a coupon from the cart
@@ -549,7 +1228,10 @@ var OmniSyncClient = class {
    * ```
    */
   async removeCoupon(cartId) {
-    return this.request("DELETE", `/api/v1/cart/${cartId}/coupon`);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("DELETE", `/cart/${cartId}/coupon`);
+    }
+    return this.adminRequest("DELETE", `/api/v1/cart/${cartId}/coupon`);
   }
   /**
    * Merge a guest cart into a customer's cart (after login)
@@ -565,7 +1247,10 @@ var OmniSyncClient = class {
    * ```
    */
   async mergeCarts(data) {
-    return this.request("POST", "/api/v1/cart/merge", data);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/cart/merge", data);
+    }
+    return this.adminRequest("POST", "/api/v1/cart/merge", data);
   }
   // -------------------- Checkout --------------------
   /**
@@ -579,7 +1264,10 @@ var OmniSyncClient = class {
    * ```
    */
   async createCheckout(data) {
-    return this.request("POST", "/api/v1/checkout", data);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/checkout", data);
+    }
+    return this.adminRequest("POST", "/api/v1/checkout", data);
   }
   /**
    * Get a checkout by ID
@@ -591,7 +1279,10 @@ var OmniSyncClient = class {
    * ```
    */
   async getCheckout(checkoutId) {
-    return this.request("GET", `/api/v1/checkout/${checkoutId}`);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", `/checkout/${checkoutId}`);
+    }
+    return this.adminRequest("GET", `/api/v1/checkout/${checkoutId}`);
   }
   /**
    * Set customer information on checkout
@@ -606,7 +1297,10 @@ var OmniSyncClient = class {
    * ```
    */
   async setCheckoutCustomer(checkoutId, data) {
-    return this.request("PATCH", `/api/v1/checkout/${checkoutId}/customer`, data);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("PATCH", `/checkout/${checkoutId}/customer`, data);
+    }
+    return this.adminRequest("PATCH", `/api/v1/checkout/${checkoutId}/customer`, data);
   }
   /**
    * Set shipping address on checkout
@@ -627,7 +1321,14 @@ var OmniSyncClient = class {
    * ```
    */
   async setShippingAddress(checkoutId, address) {
-    return this.request(
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/shipping-address`,
+        address
+      );
+    }
+    return this.adminRequest(
       "PATCH",
       `/api/v1/checkout/${checkoutId}/shipping-address`,
       address
@@ -644,7 +1345,16 @@ var OmniSyncClient = class {
    * ```
    */
   async getShippingRates(checkoutId) {
-    return this.request("GET", `/api/v1/checkout/${checkoutId}/shipping-rates`);
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "GET",
+        `/checkout/${checkoutId}/shipping-rates`
+      );
+    }
+    return this.adminRequest(
+      "GET",
+      `/api/v1/checkout/${checkoutId}/shipping-rates`
+    );
   }
   /**
    * Select a shipping method for checkout
@@ -656,7 +1366,12 @@ var OmniSyncClient = class {
    * ```
    */
   async selectShippingMethod(checkoutId, shippingRateId) {
-    return this.request("PATCH", `/api/v1/checkout/${checkoutId}/shipping-method`, {
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("PATCH", `/checkout/${checkoutId}/shipping-method`, {
+        shippingRateId
+      });
+    }
+    return this.adminRequest("PATCH", `/api/v1/checkout/${checkoutId}/shipping-method`, {
       shippingRateId
     });
   }
@@ -685,7 +1400,14 @@ var OmniSyncClient = class {
    * ```
    */
   async setBillingAddress(checkoutId, address) {
-    return this.request(
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/billing-address`,
+        address
+      );
+    }
+    return this.adminRequest(
       "PATCH",
       `/api/v1/checkout/${checkoutId}/billing-address`,
       address
@@ -702,11 +1424,143 @@ var OmniSyncClient = class {
    * ```
    */
   async completeCheckout(checkoutId) {
-    return this.request(
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "POST",
+        `/checkout/${checkoutId}/complete`
+      );
+    }
+    return this.adminRequest(
       "POST",
       `/api/v1/checkout/${checkoutId}/complete`
     );
   }
+  // -------------------- Storefront Customer Self-Service --------------------
+  // These methods require customerToken to be set (call setCustomerToken after login)
+  /**
+   * Get the current customer's profile (requires customerToken)
+   * Only available in storefront mode
+   *
+   * @example
+   * ```typescript
+   * const auth = await omni.loginCustomer('user@example.com', 'password');
+   * omni.setCustomerToken(auth.token);
+   * const profile = await omni.getMyProfile();
+   * ```
+   */
+  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");
+  }
+  /**
+   * 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);
+  }
+  /**
+   * Get the current customer's orders (requires customerToken)
+   * Only available in storefront mode
+   */
+  async getMyOrders(params) {
+    if (!this.storeId) {
+      throw new OmniSyncError("getMyOrders 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/orders",
+      void 0,
+      {
+        page: params?.page,
+        limit: params?.limit
+      }
+    );
+  }
+  /**
+   * Get the current customer's addresses (requires customerToken)
+   * Only available in storefront mode
+   */
+  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");
+  }
+  /**
+   * Add an address to the current customer (requires customerToken)
+   * Only available in storefront mode
+   */
+  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);
+  }
+  /**
+   * Update a customer address (requires customerToken)
+   * Only available in storefront mode
+   */
+  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
+    );
+  }
+  /**
+   * Delete a customer address (requires customerToken)
+   * Only available in storefront mode
+   */
+  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}`);
+  }
+  /**
+   * Get the current customer's cart (requires customerToken)
+   * Creates a new cart if none exists
+   * Only available in storefront mode
+   */
+  async getMyCart() {
+    if (!this.storeId) {
+      throw new OmniSyncError("getMyCart 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/cart");
+  }
 };
 var OmniSyncError = class extends Error {
   constructor(message, statusCode, details) {