omni-sync-sdk 0.4.0 → 0.6.0

package/dist/index.mjs

@@ -11,6 +11,10 @@ var DEFAULT_TIMEOUT = 3e4;
 var OmniSyncClient = class {
   constructor(options) {
     this.customerToken = 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
+    this.LOCAL_CART_KEY = "omni_cart";
     if (!options.apiKey && !options.storeId && !options.connectionId) {
       throw new Error("OmniSyncClient: either connectionId, apiKey, or storeId is required");
     }
@@ -1074,6 +1078,9 @@ var OmniSyncClient = class {
    * ```
    */
   async createCart() {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/cart");
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/cart");
     }
@@ -1113,6 +1120,9 @@ var OmniSyncClient = class {
    * Get a cart by ID
    */
   async getCart(cartId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", `/cart/${cartId}`);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("GET", `/cart/${cartId}`);
     }
@@ -1131,6 +1141,9 @@ var OmniSyncClient = class {
    * ```
    */
   async addToCart(cartId, item) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", `/cart/${cartId}/items`, item);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", `/cart/${cartId}/items`, item);
     }
@@ -1145,6 +1158,9 @@ var OmniSyncClient = class {
    * ```
    */
   async updateCartItem(cartId, itemId, data) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("PATCH", `/cart/${cartId}/items/${itemId}`, data);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("PATCH", `/cart/${cartId}/items/${itemId}`, data);
     }
@@ -1159,6 +1175,9 @@ var OmniSyncClient = class {
    * ```
    */
   async removeCartItem(cartId, itemId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("DELETE", `/cart/${cartId}/items/${itemId}`);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("DELETE", `/cart/${cartId}/items/${itemId}`);
     }
@@ -1173,11 +1192,15 @@ var OmniSyncClient = class {
    * ```
    */
   async clearCart(cartId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("DELETE", `/cart/${cartId}`);
+    }
     if (this.storeId && !this.apiKey) {
       await this.storefrontRequest("DELETE", `/cart/${cartId}/items`);
-      return;
+      return {};
     }
     await this.adminRequest("DELETE", `/api/v1/cart/${cartId}/items`);
+    return {};
   }
   /**
    * Apply a coupon to the cart
@@ -1189,6 +1212,9 @@ var OmniSyncClient = class {
    * ```
    */
   async applyCoupon(cartId, code) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", `/cart/${cartId}/coupon`, { code });
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", `/cart/${cartId}/coupon`, { code });
     }
@@ -1203,6 +1229,9 @@ var OmniSyncClient = class {
    * ```
    */
   async removeCoupon(cartId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("DELETE", `/cart/${cartId}/coupon`);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("DELETE", `/cart/${cartId}/coupon`);
     }
@@ -1239,6 +1268,9 @@ var OmniSyncClient = class {
    * ```
    */
   async createCheckout(data) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/checkout", data);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/checkout", data);
     }
@@ -1254,6 +1286,9 @@ var OmniSyncClient = class {
    * ```
    */
   async getCheckout(checkoutId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", `/checkout/${checkoutId}`);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("GET", `/checkout/${checkoutId}`);
     }
@@ -1272,6 +1307,9 @@ var OmniSyncClient = class {
    * ```
    */
   async setCheckoutCustomer(checkoutId, data) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("PATCH", `/checkout/${checkoutId}/customer`, data);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("PATCH", `/checkout/${checkoutId}/customer`, data);
     }
@@ -1296,6 +1334,13 @@ var OmniSyncClient = class {
    * ```
    */
   async setShippingAddress(checkoutId, address) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/shipping-address`,
+        address
+      );
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest(
         "PATCH",
@@ -1320,6 +1365,13 @@ var OmniSyncClient = class {
    * ```
    */
   async getShippingRates(checkoutId) {
+    if (this.isVibeCodedMode()) {
+      const result = await this.vibeCodedRequest(
+        "GET",
+        `/checkout/${checkoutId}/shipping-rates`
+      );
+      return result.rates;
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest(
         "GET",
@@ -1341,6 +1393,11 @@ var OmniSyncClient = class {
    * ```
    */
   async selectShippingMethod(checkoutId, shippingRateId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("PATCH", `/checkout/${checkoutId}/shipping-method`, {
+        shippingMethodId: shippingRateId
+      });
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("PATCH", `/checkout/${checkoutId}/shipping-method`, {
         shippingRateId
@@ -1375,6 +1432,13 @@ var OmniSyncClient = class {
    * ```
    */
   async setBillingAddress(checkoutId, address) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/billing-address`,
+        address
+      );
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest(
         "PATCH",
@@ -1399,6 +1463,12 @@ var OmniSyncClient = class {
    * ```
    */
   async completeCheckout(checkoutId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "POST",
+        `/checkout/${checkoutId}/complete`
+      );
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest(
         "POST",
@@ -1410,6 +1480,268 @@ var OmniSyncClient = class {
       `/api/v1/checkout/${checkoutId}/complete`
     );
   }
+  /**
+   * Check if localStorage is available (browser environment)
+   */
+  isLocalStorageAvailable() {
+    try {
+      if (typeof window === "undefined" || !window.localStorage) {
+        return false;
+      }
+      const test = "__omni_test__";
+      window.localStorage.setItem(test, test);
+      window.localStorage.removeItem(test);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Get local cart from localStorage
+   * Returns empty cart if none exists
+   *
+   * @example
+   * ```typescript
+   * const cart = omni.getLocalCart();
+   * console.log('Items in cart:', cart.items.length);
+   * ```
+   */
+  getLocalCart() {
+    if (!this.isLocalStorageAvailable()) {
+      return { items: [], updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+    }
+    try {
+      const stored = window.localStorage.getItem(this.LOCAL_CART_KEY);
+      if (stored) {
+        return JSON.parse(stored);
+      }
+    } catch {
+    }
+    return { items: [], updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  }
+  /**
+   * Save local cart to localStorage
+   */
+  saveLocalCart(cart) {
+    if (!this.isLocalStorageAvailable()) {
+      return;
+    }
+    cart.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    window.localStorage.setItem(this.LOCAL_CART_KEY, JSON.stringify(cart));
+  }
+  /**
+   * Add item to local cart (NO API call)
+   * If item already exists, updates quantity
+   *
+   * @example
+   * ```typescript
+   * omni.addToLocalCart({
+   *   productId: 'prod_123',
+   *   quantity: 2,
+   *   name: 'Cool Shirt',
+   *   price: '29.99',
+   * });
+   * ```
+   */
+  addToLocalCart(item) {
+    const cart = this.getLocalCart();
+    const existingIndex = cart.items.findIndex(
+      (i) => i.productId === item.productId && i.variantId === item.variantId
+    );
+    if (existingIndex >= 0) {
+      cart.items[existingIndex].quantity += item.quantity;
+      if (item.name) cart.items[existingIndex].name = item.name;
+      if (item.price) cart.items[existingIndex].price = item.price;
+      if (item.image) cart.items[existingIndex].image = item.image;
+    } else {
+      cart.items.push({
+        ...item,
+        addedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+    this.saveLocalCart(cart);
+    return cart;
+  }
+  /**
+   * Update item quantity in local cart
+   * Set quantity to 0 to remove item
+   *
+   * @example
+   * ```typescript
+   * omni.updateLocalCartItem('prod_123', 3); // Set quantity to 3
+   * omni.updateLocalCartItem('prod_123', 0); // Remove item
+   * ```
+   */
+  updateLocalCartItem(productId, quantity, variantId) {
+    const cart = this.getLocalCart();
+    const index = cart.items.findIndex(
+      (i) => i.productId === productId && i.variantId === variantId
+    );
+    if (index >= 0) {
+      if (quantity <= 0) {
+        cart.items.splice(index, 1);
+      } else {
+        cart.items[index].quantity = quantity;
+      }
+      this.saveLocalCart(cart);
+    }
+    return cart;
+  }
+  /**
+   * Remove item from local cart
+   *
+   * @example
+   * ```typescript
+   * omni.removeFromLocalCart('prod_123');
+   * omni.removeFromLocalCart('prod_456', 'variant_789');
+   * ```
+   */
+  removeFromLocalCart(productId, variantId) {
+    return this.updateLocalCartItem(productId, 0, variantId);
+  }
+  /**
+   * Clear all items from local cart
+   *
+   * @example
+   * ```typescript
+   * omni.clearLocalCart();
+   * ```
+   */
+  clearLocalCart() {
+    const cart = { items: [], updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+    this.saveLocalCart(cart);
+    return cart;
+  }
+  /**
+   * Set customer info on local cart
+   *
+   * @example
+   * ```typescript
+   * omni.setLocalCartCustomer({
+   *   email: 'john@example.com',
+   *   firstName: 'John',
+   *   lastName: 'Doe',
+   * });
+   * ```
+   */
+  setLocalCartCustomer(customer) {
+    const cart = this.getLocalCart();
+    cart.customer = customer;
+    this.saveLocalCart(cart);
+    return cart;
+  }
+  /**
+   * Set shipping address on local cart
+   *
+   * @example
+   * ```typescript
+   * omni.setLocalCartShippingAddress({
+   *   firstName: 'John',
+   *   lastName: 'Doe',
+   *   line1: '123 Main St',
+   *   city: 'Tel Aviv',
+   *   postalCode: '6100000',
+   *   country: 'IL',
+   * });
+   * ```
+   */
+  setLocalCartShippingAddress(address) {
+    const cart = this.getLocalCart();
+    cart.shippingAddress = address;
+    this.saveLocalCart(cart);
+    return cart;
+  }
+  /**
+   * Set billing address on local cart
+   */
+  setLocalCartBillingAddress(address) {
+    const cart = this.getLocalCart();
+    cart.billingAddress = address;
+    this.saveLocalCart(cart);
+    return cart;
+  }
+  /**
+   * Set coupon code on local cart
+   */
+  setLocalCartCoupon(couponCode) {
+    const cart = this.getLocalCart();
+    cart.couponCode = couponCode;
+    this.saveLocalCart(cart);
+    return cart;
+  }
+  /**
+   * Get total items count in local cart
+   */
+  getLocalCartItemCount() {
+    const cart = this.getLocalCart();
+    return cart.items.reduce((sum, item) => sum + item.quantity, 0);
+  }
+  // -------------------- Guest Order (Direct Checkout) --------------------
+  /**
+   * Create order directly from local cart (guest checkout)
+   * This is the main checkout method for vibe-coded sites!
+   * Sends cart data to server and creates order in ONE API call.
+   *
+   * @example
+   * ```typescript
+   * // Build up the local cart first
+   * omni.addToLocalCart({ productId: 'prod_123', quantity: 2 });
+   * omni.setLocalCartCustomer({ email: 'john@example.com', firstName: 'John' });
+   * omni.setLocalCartShippingAddress({ ... });
+   *
+   * // Then submit the order
+   * const result = await omni.submitGuestOrder();
+   * console.log('Order created:', result.orderId);
+   *
+   * // Clear cart after successful order
+   * omni.clearLocalCart();
+   * ```
+   */
+  async submitGuestOrder(options) {
+    const cart = this.getLocalCart();
+    if (cart.items.length === 0) {
+      throw new OmniSyncError("Cart is empty", 400);
+    }
+    if (!cart.customer?.email) {
+      throw new OmniSyncError("Customer email is required", 400);
+    }
+    if (!cart.shippingAddress) {
+      throw new OmniSyncError("Shipping address is required", 400);
+    }
+    const orderData = {
+      items: cart.items.map((item) => ({
+        productId: item.productId,
+        variantId: item.variantId,
+        quantity: item.quantity
+      })),
+      customer: cart.customer,
+      shippingAddress: cart.shippingAddress,
+      billingAddress: cart.billingAddress,
+      couponCode: cart.couponCode,
+      notes: cart.notes
+    };
+    const result = await this.vibeCodedRequest("POST", "/orders", orderData);
+    if (options?.clearCartOnSuccess !== false) {
+      this.clearLocalCart();
+    }
+    return result;
+  }
+  /**
+   * Create order from custom data (not from local cart)
+   * Use this if you manage cart state yourself
+   *
+   * @example
+   * ```typescript
+   * const result = await omni.createGuestOrder({
+   *   items: [{ productId: 'prod_123', quantity: 2 }],
+   *   customer: { email: 'john@example.com' },
+   *   shippingAddress: { firstName: 'John', ... },
+   * });
+   * ```
+   */
+  async createGuestOrder(data) {
+    return this.vibeCodedRequest("POST", "/orders", data);
+  }
   // -------------------- Storefront Customer Self-Service --------------------
   // These methods require customerToken to be set (call setCustomerToken after login)
   /**

package/package.json

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