brainerce 1.0.0 → 1.0.2

package/dist/index.mjs

@@ -1,10 +1,3 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
 // src/dev-guards.ts
 var CART_GUARDS = [
   {
@@ -128,24 +121,31 @@ var BrainerceClient = class {
   constructor(options) {
     this.customerToken = null;
     this.customerCartId = null;
+    // Session cart state (server-side guest carts)
+    this.sessionCartId = null;
+    this.sessionToken = null;
+    this._sessionCartPromise = null;
+    this._migrationDone = false;
+    /** localStorage key for session cart reference (sessionToken + cartId) */
+    this.SESSION_CART_KEY = "brainerce_session";
     /**
      * Virtual cart ID used for localStorage carts (guest users not logged in).
-     * When a cart has this ID, operations use localStorage instead of server API.
+     * @deprecated Guest carts now use server-side sessions. Kept for backward compatibility.
      */
     this.VIRTUAL_LOCAL_CART_ID = "__local__";
     /**
      * localStorage key for persisting active checkout across page redirects.
      * This is needed because Stripe redirects lose in-memory state.
      */
-    this.ACTIVE_CHECKOUT_KEY = "omni_active_checkout";
+    this.ACTIVE_CHECKOUT_KEY = "brainerce_active_checkout";
     // -------------------- 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";
+    this.LOCAL_CART_KEY = "brainerce_cart";
     if (!options.apiKey && !options.storeId && !options.connectionId) {
       throw new Error("BrainerceClient: either connectionId, apiKey, or storeId is required");
     }
-    if (options.apiKey && !options.apiKey.startsWith("brainerce_") && !options.apiKey.startsWith("omni_")) {
+    if (options.apiKey && !options.apiKey.startsWith("brainerce_")) {
       console.warn('BrainerceClient: apiKey should start with "brainerce_"');
     }
     if (options.connectionId && !options.connectionId.startsWith("vc_")) {
@@ -162,6 +162,7 @@ var BrainerceClient = class {
     this.baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.timeout = options.timeout || DEFAULT_TIMEOUT;
     this.onAuthError = options.onAuthError;
+    this.hydrateSessionCart();
   }
   withGuards(result, type) {
     if (!isDevGuardsEnabled()) return result;
@@ -219,11 +220,11 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const auth = await omni.loginCustomer('user@example.com', 'password');
-   * omni.setCustomerToken(auth.token);
+   * const auth = await client.loginCustomer('user@example.com', 'password');
+   * client.setCustomerToken(auth.token);
    *
    * // Now can access customer data
-   * const profile = await omni.getMyProfile();
+   * const profile = await client.getMyProfile();
    * ```
    */
   setCustomerToken(token) {
@@ -461,10 +462,10 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Basic usage
-   * const products = await omni.getProducts({ page: 1, limit: 20 });
+   * const products = await client.getProducts({ page: 1, limit: 20 });
    *
    * // With filters (vibe-coded mode)
-   * const filtered = await omni.getProducts({
+   * const filtered = await client.getProducts({
    *   categories: ['cat_123', 'cat_456'],
    *   minPrice: 10,
    *   maxPrice: 100,
@@ -535,7 +536,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Get product by its URL-friendly slug
-   * const product = await omni.getProductBySlug('awesome-product-name');
+   * const product = await client.getProductBySlug('awesome-product-name');
    * ```
    */
   async getProductBySlug(slug) {
@@ -553,7 +554,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const { categories } = await omni.getCategories();
+   * const { categories } = await client.getCategories();
    * // categories is a tree structure with children
    * ```
    */
@@ -569,7 +570,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const { brands } = await omni.getBrands();
+   * const { brands } = await client.getBrands();
    * // Use brand IDs in getProducts({ brands: ['brand_id'] })
    * ```
    */
@@ -585,7 +586,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const { tags } = await omni.getTags();
+   * const { tags } = await client.getTags();
    * // Use tag IDs in getProducts({ tags: ['tag_id'] })
    * ```
    */
@@ -607,12 +608,12 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Basic autocomplete
-   * const suggestions = await omni.getSearchSuggestions('shirt');
+   * const suggestions = await client.getSearchSuggestions('shirt');
    * console.log(suggestions.products); // [{ id, name, image, basePrice, type }]
    * console.log(suggestions.categories); // [{ id, name, productCount }]
    *
    * // With custom limit
-   * const suggestions = await omni.getSearchSuggestions('dress', 3);
+   * const suggestions = await client.getSearchSuggestions('dress', 3);
    * ```
    */
   async getSearchSuggestions(query, limit) {
@@ -665,11 +666,11 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * // Delete from Omni only
-   * const result = await omni.deleteProduct('prod_123');
+   * // Delete from Brainerce only
+   * const result = await client.deleteProduct('prod_123');
    *
-   * // Delete from Omni and connected platforms
-   * const result = await omni.deleteProduct('prod_123', {
+   * // Delete from Brainerce and connected platforms
+   * const result = await client.deleteProduct('prod_123', {
    *   platforms: ['SHOPIFY', 'WOOCOMMERCE']
    * });
    * console.log(result.success); // true
@@ -691,7 +692,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const product = await omni.convertToVariable('prod_123');
+   * const product = await client.convertToVariable('prod_123');
    * console.log('Product type:', product.type); // 'VARIABLE'
    * ```
    */
@@ -704,7 +705,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const product = await omni.convertToSimple('prod_123');
+   * const product = await client.convertToSimple('prod_123');
    * console.log('Product type:', product.type); // 'SIMPLE'
    * ```
    */
@@ -716,7 +717,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const result = await omni.publishProduct('prod_123', ['SHOPIFY', 'WOOCOMMERCE']);
+   * const result = await client.publishProduct('prod_123', ['SHOPIFY', 'WOOCOMMERCE']);
    * console.log('Publish results:', result.results);
    * ```
    */
@@ -731,7 +732,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const variant = await omni.createVariant('prod_123', {
+   * const variant = await client.createVariant('prod_123', {
    *   sku: 'PROD-SM-RED',
    *   name: 'Small / Red',
    *   attributes: { size: 'S', color: 'Red' },
@@ -748,7 +749,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const result = await omni.bulkSaveVariants('prod_123', {
+   * const result = await client.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 },
@@ -770,7 +771,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const variant = await omni.updateVariant('prod_123', 'var_456', {
+   * const variant = await client.updateVariant('prod_123', 'var_456', {
    *   price: 34.99,
    *   salePrice: 29.99,
    * });
@@ -788,7 +789,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * await omni.deleteVariant('prod_123', 'var_456');
+   * await client.deleteVariant('prod_123', 'var_456');
    * ```
    */
   async deleteVariant(productId, variantId) {
@@ -799,7 +800,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const inventory = await omni.getVariantInventory('prod_123', 'var_456');
+   * const inventory = await client.getVariantInventory('prod_123', 'var_456');
    * console.log('Available:', inventory.available);
    * ```
    */
@@ -814,7 +815,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const inventory = await omni.updateVariantInventory('prod_123', 'var_456', {
+   * const inventory = await client.updateVariantInventory('prod_123', 'var_456', {
    *   newTotal: 50,
    *   reason: 'Restocked from supplier',
    * });
@@ -867,7 +868,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const order = await omni.updateOrderStatus('order_123', 'shipped');
+   * const order = await client.updateOrderStatus('order_123', 'shipped');
    * ```
    */
   async updateOrderStatus(orderId, status) {
@@ -879,7 +880,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const order = await omni.updatePaymentMethod('order_123', 'credit_card');
+   * const order = await client.updatePaymentMethod('order_123', 'credit_card');
    * ```
    */
   async updatePaymentMethod(orderId, paymentMethod) {
@@ -892,7 +893,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const order = await omni.updateOrderNotes('order_123', 'Customer requested gift wrapping');
+   * const order = await client.updateOrderNotes('order_123', 'Customer requested gift wrapping');
    * ```
    */
   async updateOrderNotes(orderId, notes) {
@@ -904,7 +905,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const refunds = await omni.getOrderRefunds('order_123');
+   * const refunds = await client.getOrderRefunds('order_123');
    * console.log('Total refunds:', refunds.length);
    * ```
    */
@@ -918,7 +919,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Full refund
-   * const refund = await omni.createRefund('order_123', {
+   * const refund = await client.createRefund('order_123', {
    *   type: 'full',
    *   restockInventory: true,
    *   notifyCustomer: true,
@@ -926,7 +927,7 @@ var BrainerceClient = class {
    * });
    *
    * // Partial refund
-   * const partialRefund = await omni.createRefund('order_123', {
+   * const partialRefund = await client.createRefund('order_123', {
    *   type: 'partial',
    *   items: [
    *     { lineItemId: 'item_456', quantity: 1 },
@@ -944,7 +945,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const order = await omni.updateOrderShipping('order_123', {
+   * const order = await client.updateOrderShipping('order_123', {
    *   firstName: 'John',
    *   lastName: 'Doe',
    *   line1: '456 New Address',
@@ -964,7 +965,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const order = await omni.cancelOrder('order_123');
+   * const order = await client.cancelOrder('order_123');
    * console.log('Order status:', order.status); // 'cancelled'
    * ```
    */
@@ -977,7 +978,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const order = await omni.fulfillOrder('order_123', {
+   * const order = await client.fulfillOrder('order_123', {
    *   trackingNumber: '1Z999AA10123456784',
    *   trackingCompany: 'UPS',
    *   notifyCustomer: true,
@@ -992,7 +993,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const result = await omni.syncDraftOrders();
+   * const result = await client.syncDraftOrders();
    * console.log('Draft orders synced');
    * ```
    */
@@ -1004,7 +1005,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const order = await omni.completeDraftOrder('draft_123', {
+   * const order = await client.completeDraftOrder('draft_123', {
    *   paymentPending: false,
    * });
    * ```
@@ -1017,7 +1018,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * await omni.sendDraftInvoice('draft_123', {
+   * await client.sendDraftInvoice('draft_123', {
    *   to: 'customer@example.com',
    *   subject: 'Your Invoice',
    *   customMessage: 'Thank you for your order!',
@@ -1036,7 +1037,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * await omni.deleteDraftOrder('draft_123');
+   * await client.deleteDraftOrder('draft_123');
    * ```
    */
   async deleteDraftOrder(orderId) {
@@ -1047,7 +1048,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const order = await omni.updateDraftOrder('draft_123', {
+   * const order = await client.updateDraftOrder('draft_123', {
    *   note: 'Updated customer note',
    *   email: 'newemail@example.com',
    *   shippingAddress: {
@@ -1084,7 +1085,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const inventory = await omni.editInventory({
+   * const inventory = await client.editInventory({
    *   productId: 'prod_123',
    *   newTotal: 100,
    *   reason: 'Restocked from warehouse',
@@ -1099,7 +1100,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const status = await omni.getInventorySyncStatus();
+   * const status = await client.getInventorySyncStatus();
    * console.log(`${status.pending} products pending sync`);
    * console.log(`Last sync: ${status.lastSyncAt}`);
    * ```
@@ -1112,7 +1113,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const inventories = await omni.getBulkInventory(['prod_123', 'prod_456', 'prod_789']);
+   * const inventories = await client.getBulkInventory(['prod_123', 'prod_456', 'prod_789']);
    * inventories.forEach(inv => {
    *   console.log(`${inv.productId}: ${inv.available} available`);
    * });
@@ -1128,10 +1129,10 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Reconcile single product (dry run)
-   * const result = await omni.reconcileInventory({ productId: 'prod_123' });
+   * const result = await client.reconcileInventory({ productId: 'prod_123' });
    *
    * // Reconcile all products with auto-fix
-   * const summary = await omni.reconcileInventory({ autoFix: true });
+   * const summary = await client.reconcileInventory({ autoFix: true });
    * console.log(`Reconciled ${summary.reconciled} products`);
    * ```
    */
@@ -1153,7 +1154,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Check if items are available before adding to cart
-   * const result = await omni.checkStockAvailability([
+   * const result = await client.checkStockAvailability([
    *   { productId: 'prod_123', quantity: 2 },
    *   { productId: 'prod_456', variantId: 'var_789', quantity: 1 }
    * ]);
@@ -1203,10 +1204,10 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Check all cart items (full checkout)
-   * const result = await omni.checkCartStock(cart);
+   * const result = await client.checkCartStock(cart);
    *
    * // Check only selected items (partial checkout - server cart only)
-   * const result = await omni.checkCartStock(cart, ['item_1', 'item_3']);
+   * const result = await client.checkCartStock(cart, ['item_1', 'item_3']);
    *
    * if (!result.allAvailable) {
    *   const unavailable = result.results.filter(r => !r.isAvailable);
@@ -1268,7 +1269,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const coupon = await omni.createCoupon({
+   * const coupon = await client.createCoupon({
    *   code: 'SUMMER20',
    *   type: 'PERCENTAGE',
    *   value: 20,
@@ -1312,7 +1313,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Only sync to WooCommerce and Shopify
-   * await omni.publishCoupon('coupon_123', ['WOOCOMMERCE', 'SHOPIFY']);
+   * await client.publishCoupon('coupon_123', ['WOOCOMMERCE', 'SHOPIFY']);
    * ```
    */
   async publishCoupon(couponId, platforms) {
@@ -1324,7 +1325,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const capabilities = await omni.getCouponPlatformCapabilities();
+   * const capabilities = await client.getCouponPlatformCapabilities();
    * if (!capabilities.SHOPIFY.supportsProductExclusions) {
    *   console.log('Shopify does not support product exclusions');
    * }
@@ -1342,7 +1343,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const customer = await omni.createCustomer({
+   * const customer = await client.createCustomer({
    *   email: 'customer@example.com',
    *   firstName: 'John',
    *   lastName: 'Doe',
@@ -1377,7 +1378,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const auth = await omni.loginCustomer('customer@example.com', 'password123');
+   * const auth = await client.loginCustomer('customer@example.com', 'password123');
    * console.log('Customer logged in:', auth.customer.email);
    * // Store auth.token for subsequent authenticated requests
    * ```
@@ -1406,7 +1407,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const auth = await omni.registerCustomer({
+   * const auth = await client.registerCustomer({
    *   email: 'newcustomer@example.com',
    *   password: 'securepassword123',
    *   firstName: 'Jane',
@@ -1452,14 +1453,14 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Option 1: Pass token directly (recommended for verification flow)
-   * const auth = await omni.registerCustomer({...});
+   * const auth = await client.registerCustomer({...});
    * if (auth.requiresVerification) {
-   *   const result = await omni.verifyEmail('123456', auth.token);
+   *   const result = await client.verifyEmail('123456', auth.token);
    * }
    *
    * // Option 2: Use setCustomerToken first
-   * omni.setCustomerToken(auth.token);
-   * const result = await omni.verifyEmail('123456');
+   * client.setCustomerToken(auth.token);
+   * const result = await client.verifyEmail('123456');
    * ```
    */
   async verifyEmail(code, token) {
@@ -1501,11 +1502,11 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Option 1: Pass token directly
-   * await omni.resendVerificationEmail(auth.token);
+   * await client.resendVerificationEmail(auth.token);
    *
    * // Option 2: Use setCustomerToken first
-   * omni.setCustomerToken(auth.token);
-   * await omni.resendVerificationEmail();
+   * client.setCustomerToken(auth.token);
+   * await client.resendVerificationEmail();
    * ```
    */
   async resendVerificationEmail(token) {
@@ -1546,7 +1547,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const { providers } = await omni.getAvailableOAuthProviders();
+   * const { providers } = await client.getAvailableOAuthProviders();
    * // providers: ['GOOGLE', 'FACEBOOK'] - array of strings, not objects!
    *
    * // To display with friendly names:
@@ -1586,7 +1587,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Get authorization URL (redirectUrl MUST be absolute with origin)
-   * const { authorizationUrl } = await omni.getOAuthAuthorizeUrl('GOOGLE', {
+   * const { authorizationUrl } = await client.getOAuthAuthorizeUrl('GOOGLE', {
    *   redirectUrl: window.location.origin + '/auth/callback'
    * });
    *
@@ -1597,7 +1598,7 @@ var BrainerceClient = class {
    * const params = new URLSearchParams(window.location.search);
    * if (params.get('oauth_success') === 'true') {
    *   const token = params.get('token');
-   *   omni.setCustomerToken(token);
+   *   client.setCustomerToken(token);
    *   // Also available: customer_id, customer_email, is_new
    * } else if (params.get('oauth_error')) {
    *   // Show error
@@ -1666,10 +1667,10 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Customer must be logged in first
-   * omni.setCustomerToken(auth.token);
+   * client.setCustomerToken(auth.token);
    *
    * // Get authorization URL for linking
-   * const { authorizationUrl } = await omni.linkOAuthProvider('GITHUB', {
+   * const { authorizationUrl } = await client.linkOAuthProvider('GITHUB', {
    *   redirectUrl: '/settings'
    * });
    *
@@ -1706,8 +1707,8 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * omni.setCustomerToken(auth.token);
-   * await omni.unlinkOAuthProvider('FACEBOOK');
+   * client.setCustomerToken(auth.token);
+   * await client.unlinkOAuthProvider('FACEBOOK');
    * ```
    */
   async unlinkOAuthProvider(provider) {
@@ -1731,8 +1732,8 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * omni.setCustomerToken(auth.token);
-   * const { connections } = await omni.getOAuthConnections();
+   * client.setCustomerToken(auth.token);
+   * const { connections } = await client.getOAuthConnections();
    * // connections: [{ id: '...', provider: 'GOOGLE', email: 'user@gmail.com', createdAt: '...' }]
    * ```
    */
@@ -1762,10 +1763,10 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // After login/register, set the token
-   * omni.setCustomerToken(auth.token);
+   * client.setCustomerToken(auth.token);
    *
    * // Then get the profile
-   * const profile = await omni.getCustomerProfile();
+   * const profile = await client.getCustomerProfile();
    * console.log('Customer:', profile.email);
    * ```
    */
@@ -1795,7 +1796,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const address = await omni.addCustomerAddress('cust_123', {
+   * const address = await client.addCustomerAddress('cust_123', {
    *   firstName: 'John',
    *   lastName: 'Doe',
    *   line1: '123 Main St',
@@ -1835,7 +1836,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const orders = await omni.getCustomerOrders('cust_123', { page: 1, limit: 10 });
+   * const orders = await client.getCustomerOrders('cust_123', { page: 1, limit: 10 });
    * console.log(`Customer has ${orders.meta.total} total orders`);
    * ```
    */
@@ -1854,16 +1855,12 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const cart = await omni.createCart();
+   * const cart = await client.createCart();
    * console.log('Cart session:', cart.sessionToken);
    * // Store sessionToken in localStorage or cookie
    * ```
    */
   async createCart() {
-    if (this.isVibeCodedMode() && !this.isCustomerLoggedIn()) {
-      const localCart = this.getLocalCart();
-      return this.localCartToCart(localCart);
-    }
     if (this.isVibeCodedMode()) {
       return this.vibeCodedRequest("POST", "/cart");
     }
@@ -1877,11 +1874,14 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const cart = await omni.getCartBySession('sess_abc123');
+   * const cart = await client.getCartBySession('sess_abc123');
    * console.log('Items in cart:', cart.itemCount);
    * ```
    */
   async getCartBySession(sessionToken) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", `/cart/session/${sessionToken}`);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("GET", `/cart/session/${sessionToken}`);
     }
@@ -1892,7 +1892,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const cart = await omni.getCartByCustomer('cust_123');
+   * const cart = await client.getCartByCustomer('cust_123');
    * console.log('Customer cart total:', cart.subtotal);
    * ```
    */
@@ -1907,6 +1907,7 @@ var BrainerceClient = class {
    */
   async getCart(cartId) {
     if (cartId === this.VIRTUAL_LOCAL_CART_ID) {
+      console.warn('getCart("__local__") is deprecated. Use smartGetCart() instead.');
       return this.withGuards(this.localCartToCart(this.getLocalCart()), "cart");
     }
     if (this.isVibeCodedMode()) {
@@ -1922,7 +1923,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const cart = await omni.addToCart('cart_123', {
+   * const cart = await client.addToCart('cart_123', {
    *   productId: 'prod_abc',
    *   quantity: 2,
    *   notes: 'Gift wrap please',
@@ -1931,38 +1932,14 @@ var BrainerceClient = class {
    */
   async addToCart(cartId, item) {
     if (cartId === this.VIRTUAL_LOCAL_CART_ID) {
-      let productName = "Unknown Product";
-      let productPrice = "0";
-      let productImage;
-      if (item.productInfo) {
-        productName = item.productInfo.name;
-        productPrice = item.productInfo.price;
-        productImage = item.productInfo.image;
-      } else {
-        try {
-          const product = await this.getProduct(item.productId);
-          productName = product.name;
-          productPrice = product.salePrice || product.basePrice;
-          productImage = product.images?.[0]?.url;
-          if (item.variantId && product.variants) {
-            const variant = product.variants.find((v) => v.id === item.variantId);
-            if (variant) {
-              productPrice = variant.salePrice || variant.price || productPrice;
-              if (variant.image) {
-                productImage = typeof variant.image === "string" ? variant.image : variant.image.url;
-              }
-            }
-          }
-        } catch {
-        }
-      }
+      console.warn('addToCart("__local__", ...) is deprecated. Use smartAddToCart() instead.');
       this.addToLocalCart({
         productId: item.productId,
         variantId: item.variantId,
         quantity: item.quantity,
-        name: productName,
-        price: productPrice,
-        image: productImage
+        name: item.productInfo?.name || "Unknown Product",
+        price: item.productInfo?.price || "0",
+        image: item.productInfo?.image
       });
       return this.withGuards(this.localCartToCart(this.getLocalCart()), "cart");
     }
@@ -1988,11 +1965,12 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const cart = await omni.updateCartItem('cart_123', 'item_456', { quantity: 3 });
+   * const cart = await client.updateCartItem('cart_123', 'item_456', { quantity: 3 });
    * ```
    */
   async updateCartItem(cartId, itemId, data) {
     if (cartId === this.VIRTUAL_LOCAL_CART_ID) {
+      console.warn('updateCartItem("__local__", ...) is deprecated. Use smartUpdateCartItem() instead.');
       const index = parseInt(itemId.replace("local_", ""), 10);
       const localCart = this.getLocalCart();
       if (index >= 0 && index < localCart.items.length) {
@@ -2023,11 +2001,12 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const cart = await omni.removeCartItem('cart_123', 'item_456');
+   * const cart = await client.removeCartItem('cart_123', 'item_456');
    * ```
    */
   async removeCartItem(cartId, itemId) {
     if (cartId === this.VIRTUAL_LOCAL_CART_ID) {
+      console.warn('removeCartItem("__local__", ...) is deprecated. Use smartRemoveFromCart() instead.');
       const index = parseInt(itemId.replace("local_", ""), 10);
       const localCart = this.getLocalCart();
       if (index >= 0 && index < localCart.items.length) {
@@ -2058,11 +2037,12 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * await omni.clearCart('cart_123');
+   * await client.clearCart('cart_123');
    * ```
    */
   async clearCart(cartId) {
     if (cartId === this.VIRTUAL_LOCAL_CART_ID) {
+      console.warn('clearCart("__local__") is deprecated. Use onCheckoutComplete() or clearLocalCart() directly.');
       this.clearLocalCart();
       return this.withGuards(this.localCartToCart(this.getLocalCart()), "cart");
     }
@@ -2081,7 +2061,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const cart = await omni.applyCoupon('cart_123', 'SAVE20');
+   * const cart = await client.applyCoupon('cart_123', 'SAVE20');
    * console.log('Discount:', cart.discountAmount);
    * ```
    */
@@ -2108,7 +2088,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const cart = await omni.removeCoupon('cart_123');
+   * const cart = await client.removeCoupon('cart_123');
    * ```
    */
   async removeCoupon(cartId) {
@@ -2141,8 +2121,8 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // After customer logs in
-   * omni.setCustomerToken(authResponse.token);
-   * const cart = await omni.linkCart('cart_123'); // cartId is REQUIRED
+   * client.setCustomerToken(authResponse.token);
+   * const cart = await client.linkCart('cart_123'); // cartId is REQUIRED
    * // Cart is now linked to the customer
    * ```
    */
@@ -2168,7 +2148,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // After customer logs in, merge their guest cart
-   * const mergedCart = await omni.mergeCarts({
+   * const mergedCart = await client.mergeCarts({
    *   sourceSessionToken: 'sess_guest_abc',
    *   targetCustomerId: 'cust_123',
    * });
@@ -2187,7 +2167,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const banners = await omni.getDiscountBanners();
+   * const banners = await client.getDiscountBanners();
    * banners.forEach(b => console.log(b.text));
    * ```
    */
@@ -2209,7 +2189,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const badge = await omni.getProductDiscountBadge('prod_123');
+   * const badge = await client.getProductDiscountBadge('prod_123');
    * if (badge) {
    *   console.log(badge.badgeText); // e.g., "20% OFF"
    *   console.log(badge.discountedPrice); // e.g., "39.99"
@@ -2242,7 +2222,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const nudges = await omni.getCartNudges('cart_123');
+   * const nudges = await client.getCartNudges('cart_123');
    * nudges.forEach(n => {
    *   console.log(n.text); // e.g., "Add $12.50 more for free shipping!"
    * });
@@ -2267,7 +2247,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const recs = await omni.getProductRecommendations('prod_123');
+   * const recs = await client.getProductRecommendations('prod_123');
    * console.log(recs.crossSells); // complementary products
    * console.log(recs.upsells);    // premium alternatives
    * console.log(recs.related);    // related products
@@ -2301,7 +2281,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const recs = await omni.getCartRecommendations('cart_123', 6);
+   * const recs = await client.getCartRecommendations('cart_123', 6);
    * recs.recommendations.forEach(product => {
    *   console.log(product.name, product.basePrice);
    * });
@@ -2333,7 +2313,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * if (omni.isCustomerLoggedIn()) {
+   * if (client.isCustomerLoggedIn()) {
    *   console.log('Cart will be stored on server');
    * } else {
    *   console.log('Cart will be stored in localStorage');
@@ -2343,6 +2323,230 @@ var BrainerceClient = class {
   isCustomerLoggedIn() {
     return !!this.customerToken;
   }
+  // -------------------- Session Cart Helpers --------------------
+  /**
+   * Hydrate session cart state from localStorage on construction.
+   * @internal
+   */
+  hydrateSessionCart() {
+    if (!this.isLocalStorageAvailable()) return;
+    try {
+      const stored = window.localStorage.getItem(this.SESSION_CART_KEY);
+      if (stored) {
+        const ref = JSON.parse(stored);
+        this.sessionToken = ref.sessionToken;
+        this.sessionCartId = ref.cartId;
+      }
+    } catch {
+    }
+  }
+  /**
+   * Persist session cart reference to localStorage.
+   * @internal
+   */
+  saveSessionCart(ref) {
+    this.sessionToken = ref.sessionToken;
+    this.sessionCartId = ref.cartId;
+    if (!this.isLocalStorageAvailable()) return;
+    window.localStorage.setItem(this.SESSION_CART_KEY, JSON.stringify(ref));
+  }
+  /**
+   * Clear session cart reference from localStorage and memory.
+   * @internal
+   */
+  clearSessionCart() {
+    this.sessionToken = null;
+    this.sessionCartId = null;
+    this._sessionCartPromise = null;
+    if (!this.isLocalStorageAvailable()) return;
+    window.localStorage.removeItem(this.SESSION_CART_KEY);
+  }
+  /**
+   * Update the cached item count in the session reference.
+   * @internal
+   */
+  updateSessionCartItemCount(count) {
+    if (!this.sessionToken || !this.sessionCartId) return;
+    this.saveSessionCart({
+      sessionToken: this.sessionToken,
+      cartId: this.sessionCartId,
+      itemCount: count
+    });
+  }
+  /**
+   * Return a synthetic empty Cart object for display when no server cart exists yet.
+   * Avoids creating a server cart just to show "your cart is empty."
+   * @internal
+   */
+  emptyCart() {
+    return {
+      id: "",
+      sessionToken: null,
+      customerId: null,
+      status: "ACTIVE",
+      currency: "USD",
+      notes: null,
+      subtotal: "0",
+      discountAmount: "0",
+      couponCode: null,
+      items: [],
+      itemCount: 0,
+      expiresAt: null,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  /**
+   * Create a server-side cart via API. Never falls back to localStorage.
+   * @internal
+   */
+  async createServerCart() {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/cart");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/cart");
+    }
+    return this.adminRequest("POST", "/api/v1/cart");
+  }
+  /**
+   * Get or create a server-side session cart for guest users.
+   * Lazily creates the cart on first call (e.g., first add-to-cart).
+   * Uses promise dedup lock to prevent race conditions on parallel calls.
+   * @internal
+   */
+  async getOrCreateSessionCart() {
+    if (this._sessionCartPromise) return this._sessionCartPromise;
+    this._sessionCartPromise = this._getOrCreateSessionCartImpl();
+    try {
+      return await this._sessionCartPromise;
+    } finally {
+      this._sessionCartPromise = null;
+    }
+  }
+  /** @internal */
+  async _getOrCreateSessionCartImpl() {
+    const migrated = await this.migrateLocalCartToSession();
+    if (migrated) return migrated;
+    if (this.sessionCartId && this.sessionToken) {
+      try {
+        const cart2 = await this.getCart(this.sessionCartId);
+        if (cart2.status === "ACTIVE") {
+          return cart2;
+        }
+        this.clearSessionCart();
+      } catch {
+        this.clearSessionCart();
+      }
+    }
+    if (this.sessionToken) {
+      try {
+        const cart2 = await this.getCartBySession(this.sessionToken);
+        if (cart2 && cart2.status === "ACTIVE") {
+          this.saveSessionCart({
+            sessionToken: this.sessionToken,
+            cartId: cart2.id,
+            itemCount: cart2.itemCount
+          });
+          return cart2;
+        }
+      } catch {
+        this.clearSessionCart();
+      }
+    }
+    const cart = await this.createServerCart();
+    if (cart.sessionToken) {
+      this.saveSessionCart({
+        sessionToken: cart.sessionToken,
+        cartId: cart.id,
+        itemCount: cart.itemCount
+      });
+    }
+    return cart;
+  }
+  /**
+   * Migrate legacy localStorage cart to server session cart.
+   * Called once, on first smart method call if migration is needed.
+   * @internal
+   */
+  async migrateLocalCartToSession() {
+    if (this._migrationDone) return null;
+    this._migrationDone = true;
+    if (this.sessionToken || this.sessionCartId) return null;
+    const localCart = this.getLocalCart();
+    if (localCart.items.length === 0) return null;
+    try {
+      const cart = await this.createServerCart();
+      for (const item of localCart.items) {
+        try {
+          await this.addToCart(cart.id, {
+            productId: item.productId,
+            variantId: item.variantId,
+            quantity: item.quantity
+          });
+        } catch {
+        }
+      }
+      if (cart.sessionToken) {
+        this.saveSessionCart({
+          sessionToken: cart.sessionToken,
+          cartId: cart.id
+        });
+      }
+      this.clearLocalCart();
+      return this.getCart(cart.id);
+    } catch {
+      this._migrationDone = false;
+      return null;
+    }
+  }
+  /**
+   * Merge the guest session cart into the customer's cart on the server.
+   * Tries linkCart first (fast, single call), falls back to mergeCarts endpoint.
+   * @internal
+   */
+  async mergeSessionCartOnLogin() {
+    if (this.sessionCartId) {
+      try {
+        return await this.linkCart(this.sessionCartId);
+      } catch {
+      }
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/cart/merge", {
+        sessionToken: this.sessionToken
+      });
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/cart/merge", {
+        sessionToken: this.sessionToken
+      });
+    }
+    return this.adminRequest("POST", "/api/v1/cart/merge", {
+      sessionToken: this.sessionToken
+    });
+  }
+  /**
+   * Get the cart item count without a full cart fetch.
+   * Returns the cached count from localStorage if available, or 0.
+   * For accurate counts, use smartGetCart() and read cart.itemCount.
+   */
+  getSmartCartItemCount() {
+    if (this.isCustomerLoggedIn()) {
+      return 0;
+    }
+    if (!this.isLocalStorageAvailable()) return 0;
+    try {
+      const stored = window.localStorage.getItem(this.SESSION_CART_KEY);
+      if (stored) {
+        const ref = JSON.parse(stored);
+        return ref.itemCount ?? 0;
+      }
+    } catch {
+    }
+    return 0;
+  }
+  // -------------------- Customer Cart --------------------
   /**
    * Get or create a server cart for the logged-in customer
    * Caches the cart ID for subsequent calls
@@ -2395,40 +2599,50 @@ var BrainerceClient = class {
     throw new BrainerceError("fetchCustomerCart requires vibe-coded or storefront mode", 400);
   }
   /**
-   * Smart add to cart - automatically uses localStorage or server based on auth state
+   * Smart add to cart - automatically uses the correct cart based on auth state
    *
-   * - **Guest (not logged in)**: Stores in localStorage
-   * - **Logged in**: Stores on server (database)
+   * - **Logged in**: Uses customer's server cart
+   * - **Guest**: Uses server-side session cart (creates one if needed)
    *
    * @example
    * ```typescript
    * // Works the same whether logged in or not
-   * await omni.smartAddToCart({
+   * await client.smartAddToCart({
    *   productId: 'prod_123',
    *   quantity: 2,
-   *   name: 'Cool Product', // Optional: for localStorage display
-   *   price: '29.99',
    * });
    * ```
    */
   async smartAddToCart(item) {
     if (this.isCustomerLoggedIn()) {
       const cart = await this.getOrCreateCustomerCart();
-      return this.addToCart(cart.id, {
+      const updated = await this.addToCart(cart.id, {
         productId: item.productId,
         variantId: item.variantId,
         quantity: item.quantity
       });
+      return updated;
     } else {
-      return this.addToLocalCart(item);
+      const cart = await this.getOrCreateSessionCart();
+      const updated = await this.addToCart(cart.id, {
+        productId: item.productId,
+        variantId: item.variantId,
+        quantity: item.quantity
+      });
+      this.updateSessionCartItemCount(updated.items?.length ?? 0);
+      return updated;
     }
   }
   /**
-   * Smart get cart - returns server cart if logged in, localStorage if guest
+   * Smart get cart - returns the current cart (server-side for both guests and logged-in users)
+   *
+   * - **Logged in**: Returns customer's server cart
+   * - **Guest with session**: Returns server-side session cart
+   * - **Guest without session**: Returns empty cart (no server call, cart created lazily on add)
    *
    * @example
    * ```typescript
-   * const cart = await omni.smartGetCart();
+   * const cart = await client.smartGetCart();
    * console.log('Items:', cart.items.length);
    * ```
    */
@@ -2436,7 +2650,10 @@ var BrainerceClient = class {
     if (this.isCustomerLoggedIn()) {
       return this.getOrCreateCustomerCart();
     } else {
-      return this.withGuards(this.getLocalCart(), "cart");
+      if (!this.sessionToken) {
+        return this.emptyCart();
+      }
+      return this.getOrCreateSessionCart();
     }
   }
   /**
@@ -2444,8 +2661,8 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * await omni.smartUpdateCartItem('prod_123', 3); // Set quantity to 3
-   * await omni.smartUpdateCartItem('prod_123', 0); // Remove item
+   * await client.smartUpdateCartItem('prod_123', 3); // Set quantity to 3
+   * await client.smartUpdateCartItem('prod_123', 0); // Remove item
    * ```
    */
   async smartUpdateCartItem(productId, quantity, variantId) {
@@ -2462,7 +2679,24 @@ var BrainerceClient = class {
       }
       return this.updateCartItem(cart.id, item.id, { quantity });
     } else {
-      return this.updateLocalCartItem(productId, quantity, variantId);
+      if (!this.sessionToken) {
+        return this.emptyCart();
+      }
+      const cart = await this.getOrCreateSessionCart();
+      const item = cart.items.find(
+        (i) => i.productId === productId && i.variantId === (variantId ?? null)
+      );
+      if (!item) {
+        return cart;
+      }
+      let updated;
+      if (quantity <= 0) {
+        updated = await this.removeCartItem(cart.id, item.id);
+      } else {
+        updated = await this.updateCartItem(cart.id, item.id, { quantity });
+      }
+      this.updateSessionCartItemCount(updated.items?.length ?? 0);
+      return updated;
     }
   }
   /**
@@ -2470,32 +2704,30 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * await omni.smartRemoveFromCart('prod_123');
-   * await omni.smartRemoveFromCart('prod_456', 'variant_789');
+   * await client.smartRemoveFromCart('prod_123');
+   * await client.smartRemoveFromCart('prod_456', 'variant_789');
    * ```
    */
   async smartRemoveFromCart(productId, variantId) {
     return this.smartUpdateCartItem(productId, 0, variantId);
   }
   /**
-   * Sync local cart to server on login
+   * Sync guest cart to customer cart on login
    *
    * Call this AFTER setCustomerToken() when a customer logs in.
    * This will:
-   * 1. Get or create a server cart for the customer
-   * 2. Add all items from localStorage to the server cart (merging with existing)
-   * 3. Clear localStorage
-   *
-   * Items that fail to sync (e.g., out of stock) are silently skipped.
+   * 1. If a server-side session cart exists, merge it into the customer cart (atomic, server-side)
+   * 2. If only a legacy localStorage cart exists, sync items one by one (backward compat)
+   * 3. Clear the session/localStorage after merge
    *
    * @example
    * ```typescript
    * // Customer logs in
-   * const auth = await omni.login(email, password);
-   * omni.setCustomerToken(auth.token);
+   * const auth = await client.login(email, password);
+   * client.setCustomerToken(auth.token);
    *
-   * // Sync their local cart to server
-   * const cart = await omni.syncCartOnLogin();
+   * // Merge their guest cart into customer cart
+   * const cart = await client.syncCartOnLogin();
    * console.log('Cart synced, items:', cart.items.length);
    * ```
    */
@@ -2506,6 +2738,14 @@ var BrainerceClient = class {
         401
       );
     }
+    if (this.sessionToken) {
+      try {
+        const merged = await this.mergeSessionCartOnLogin();
+        this.clearSessionCart();
+        return merged;
+      } catch {
+      }
+    }
     const localCart = this.getLocalCart();
     const serverCart = await this.getOrCreateCustomerCart();
     if (localCart.items.length === 0) {
@@ -2527,16 +2767,16 @@ var BrainerceClient = class {
   /**
    * Clear cart state on logout
    *
-   * Call this when a customer logs out to clear the cached cart ID.
-   * The localStorage cart remains available for the next guest session.
+   * Call this when a customer logs out to clear the cached customer cart ID.
+   * The session cart (if any) remains available for the next guest session.
    *
    * @example
    * ```typescript
-   * omni.clearCustomerToken();
-   * omni.onLogout();
+   * client.clearCustomerToken();
+   * client.onLogout();
    *
-   * // Now back to guest mode - cart uses localStorage
-   * await omni.smartAddToCart({ productId: 'prod_123', quantity: 1 });
+   * // Now back to guest mode - cart uses server-side session
+   * await client.smartAddToCart({ productId: 'prod_123', quantity: 1 });
    * ```
    */
   onLogout() {
@@ -2552,13 +2792,13 @@ var BrainerceClient = class {
    * ```typescript
    * // After payment success
    * if (paymentStatus === 'succeeded') {
-   *   omni.onCheckoutComplete();
-   *   omni.clearLocalCart(); // Also clear localStorage for guests
+   *   client.onCheckoutComplete();
    * }
    * ```
    */
   onCheckoutComplete() {
     this.customerCartId = null;
+    this.clearSessionCart();
   }
   // -------------------- Checkout --------------------
   /**
@@ -2573,10 +2813,10 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Full cart checkout (default)
-   * const checkout = await omni.createCheckout({ cartId: 'cart_123' });
+   * const checkout = await client.createCheckout({ cartId: 'cart_123' });
    *
    * // Partial checkout - only buy selected items
-   * const checkout = await omni.createCheckout({
+   * const checkout = await client.createCheckout({
    *   cartId: 'cart_123',
    *   selectedItemIds: ['item_1', 'item_3'], // Only these items will be purchased
    * });
@@ -2585,7 +2825,7 @@ var BrainerceClient = class {
   async createCheckout(data) {
     if (data.cartId === this.VIRTUAL_LOCAL_CART_ID) {
       throw new BrainerceError(
-        "Cannot create checkout from local cart directly. Use startGuestCheckout() for guest checkout with localStorage cart, or sync cart to server first with syncCartOnLogin().",
+        'Cannot create checkout from "__local__" cart. Use startGuestCheckout() or smartAddToCart() to create a server-side cart first.',
         400
       );
     }
@@ -2611,7 +2851,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const checkout = await omni.getCheckout('checkout_123');
+   * const checkout = await client.getCheckout('checkout_123');
    * console.log('Status:', checkout.status);
    * ```
    */
@@ -2638,7 +2878,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const checkout = await omni.setCheckoutCustomer('checkout_123', {
+   * const checkout = await client.setCheckoutCustomer('checkout_123', {
    *   email: 'customer@example.com',
    *   firstName: 'John',
    *   lastName: 'Doe',
@@ -2663,7 +2903,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const { checkout, rates } = await omni.setShippingAddress('checkout_123', {
+   * const { checkout, rates } = await client.setShippingAddress('checkout_123', {
    *   email: 'customer@example.com',  // Required!
    *   firstName: 'John',
    *   lastName: 'Doe',
@@ -2703,7 +2943,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const rates = await omni.getShippingRates('checkout_123');
+   * const rates = await client.getShippingRates('checkout_123');
    * console.log('Shipping options:', rates);
    * ```
    */
@@ -2731,7 +2971,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const checkout = await omni.selectShippingMethod('checkout_123', 'rate_express');
+   * const checkout = await client.selectShippingMethod('checkout_123', 'rate_express');
    * console.log('Shipping cost:', checkout.shippingAmount);
    * ```
    */
@@ -2766,13 +3006,13 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Use same as shipping
-   * const checkout = await omni.setBillingAddress('checkout_123', {
+   * const checkout = await client.setBillingAddress('checkout_123', {
    *   ...shippingAddress,
    *   sameAsShipping: true,
    * });
    *
    * // Or set different billing address
-   * const checkout = await omni.setBillingAddress('checkout_123', {
+   * const checkout = await client.setBillingAddress('checkout_123', {
    *   firstName: 'John',
    *   lastName: 'Doe',
    *   line1: '456 Business Ave',
@@ -2810,7 +3050,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const { orderId } = await omni.completeCheckout('checkout_123');
+   * const { orderId } = await client.completeCheckout('checkout_123');
    * console.log('Order created:', orderId);
    * ```
    */
@@ -2849,7 +3089,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const config = await omni.getPaymentConfig();
+   * const config = await client.getPaymentConfig();
    *
    * // Initialize Stripe.js with the public key
    * const stripe = Stripe(config.publicKey);
@@ -2882,7 +3122,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const { providers, hasPayments, defaultProvider } = await omni.getPaymentProviders();
+   * const { providers, hasPayments, defaultProvider } = await client.getPaymentProviders();
    *
    * if (!hasPayments) {
    *   // Show error: "Payment is not configured for this store"
@@ -2934,7 +3174,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // After completing checkout steps (shipping address, method, etc.)
-   * const intent = await omni.createPaymentIntent(checkout.id, {
+   * const intent = await client.createPaymentIntent(checkout.id, {
    *   successUrl: `${window.location.origin}/order-confirmation?checkout_id=${checkout.id}`,
    *   cancelUrl: `${window.location.origin}/checkout?error=cancelled`,
    * });
@@ -2981,7 +3221,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // After returning from Stripe redirect
-   * const status = await omni.getPaymentStatus(checkoutId);
+   * const status = await client.getPaymentStatus(checkoutId);
    *
    * if (status.status === 'succeeded') {
    *   // Redirect to order confirmation
@@ -3031,7 +3271,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Basic usage - wait up to 30 seconds
-   * const result = await omni.waitForOrder(checkoutId);
+   * const result = await client.waitForOrder(checkoutId);
    *
    * if (result.success) {
    *   console.log('Order created:', result.status.orderNumber);
@@ -3044,7 +3284,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // With progress callback for UI updates
-   * const result = await omni.waitForOrder(checkoutId, {
+   * const result = await client.waitForOrder(checkoutId, {
    *   maxWaitMs: 20000,
    *   onPollAttempt: (attempt, status) => {
    *     setLoadingMessage(`Confirming order... (attempt ${attempt})`);
@@ -3112,7 +3352,7 @@ var BrainerceClient = class {
       if (typeof window === "undefined" || !window.localStorage) {
         return false;
       }
-      const test = "__omni_test__";
+      const test = "__brainerce_test__";
       window.localStorage.setItem(test, test);
       window.localStorage.removeItem(test);
       return true;
@@ -3121,14 +3361,8 @@ var BrainerceClient = class {
     }
   }
   /**
-   * 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);
-   * ```
+   * @deprecated Use `smartGetCart()` instead. Guest carts are now stored on the server.
+   * Get local cart from localStorage. Returns empty cart if none exists.
    */
   getLocalCart() {
     if (!this.isLocalStorageAvailable()) {
@@ -3210,18 +3444,8 @@ var BrainerceClient = class {
     };
   }
   /**
-   * 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',
-   * });
-   * ```
+   * @deprecated Use `smartAddToCart()` instead. Guest carts are now stored on the server.
+   * Add item to local cart (NO API call). If item already exists, updates quantity.
    */
   addToLocalCart(item) {
     const cart = this.getLocalCart();
@@ -3243,14 +3467,8 @@ var BrainerceClient = class {
     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
-   * ```
+   * @deprecated Use `smartUpdateCartItem()` instead. Guest carts are now stored on the server.
+   * Update item quantity in local cart. Set quantity to 0 to remove item.
    */
   updateLocalCartItem(productId, quantity, variantId) {
     const cart = this.getLocalCart();
@@ -3268,24 +3486,13 @@ var BrainerceClient = class {
     return cart;
   }
   /**
-   * Remove item from local cart
-   *
-   * @example
-   * ```typescript
-   * omni.removeFromLocalCart('prod_123');
-   * omni.removeFromLocalCart('prod_456', 'variant_789');
-   * ```
+   * @deprecated Use `smartRemoveFromCart()` instead. Guest carts are now stored on the server.
    */
   removeFromLocalCart(productId, variantId) {
     return this.updateLocalCartItem(productId, 0, variantId);
   }
   /**
-   * Clear all items from local cart
-   *
-   * @example
-   * ```typescript
-   * omni.clearLocalCart();
-   * ```
+   * @deprecated Use `onCheckoutComplete()` instead. Guest carts are now stored on the server.
    */
   clearLocalCart() {
     const cart = { items: [], updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
@@ -3293,16 +3500,8 @@ var BrainerceClient = class {
     return cart;
   }
   /**
-   * Set customer info on local cart
-   *
-   * @example
-   * ```typescript
-   * omni.setLocalCartCustomer({
-   *   email: 'john@example.com',
-   *   firstName: 'John',
-   *   lastName: 'Doe',
-   * });
-   * ```
+   * @deprecated Customer info is now set via checkout address methods.
+   * Still used by `submitGuestOrder()` for backward compatibility.
    */
   setLocalCartCustomer(customer) {
     const cart = this.getLocalCart();
@@ -3311,19 +3510,8 @@ var BrainerceClient = class {
     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',
-   * });
-   * ```
+   * @deprecated Address is now set via `updateGuestCheckoutAddress()` after `startGuestCheckout()`.
+   * Still used by `submitGuestOrder()` for backward compatibility.
    */
   setLocalCartShippingAddress(address) {
     const cart = this.getLocalCart();
@@ -3332,7 +3520,8 @@ var BrainerceClient = class {
     return cart;
   }
   /**
-   * Set billing address on local cart
+   * @deprecated Address is now set via `updateGuestCheckoutAddress()` after `startGuestCheckout()`.
+   * Still used by `submitGuestOrder()` for backward compatibility.
    */
   setLocalCartBillingAddress(address) {
     const cart = this.getLocalCart();
@@ -3341,7 +3530,7 @@ var BrainerceClient = class {
     return cart;
   }
   /**
-   * Set coupon code on local cart
+   * @deprecated Coupons are now applied via `applyCoupon()` on the server cart.
    */
   setLocalCartCoupon(couponCode) {
     const cart = this.getLocalCart();
@@ -3350,7 +3539,7 @@ var BrainerceClient = class {
     return cart;
   }
   /**
-   * Get total items count in local cart
+   * @deprecated Use `getSmartCartItemCount()` instead.
    */
   getLocalCartItemCount() {
     const cart = this.getLocalCart();
@@ -3368,18 +3557,52 @@ var BrainerceClient = class {
    * @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({ ... });
+   * client.addToLocalCart({ productId: 'prod_123', quantity: 2 });
+   * client.setLocalCartCustomer({ email: 'john@example.com', firstName: 'John' });
+   * client.setLocalCartShippingAddress({ ... });
    *
    * // Then submit the order - tracking is automatic if enabled in admin!
-   * const result = await omni.submitGuestOrder();
+   * const result = await client.submitGuestOrder();
    * console.log('Order created:', result.orderId);
    *
    * // Cart is automatically cleared on success
    * ```
    */
   async submitGuestOrder(options) {
+    if (this.sessionToken) {
+      const serverCart = await this.getOrCreateSessionCart();
+      if (!serverCart.items || serverCart.items.length === 0) {
+        throw new BrainerceError("Cart is empty", 400);
+      }
+      const localCart = this.getLocalCart();
+      if (!localCart.customer?.email) {
+        throw new BrainerceError("Customer email is required. Call setLocalCartCustomer() first.", 400);
+      }
+      if (!localCart.shippingAddress) {
+        throw new BrainerceError("Shipping address is required. Call setLocalCartShippingAddress() first.", 400);
+      }
+      const trackingResult = await this.startGuestCheckout();
+      if (!trackingResult.tracked) {
+        throw new BrainerceError("Failed to create checkout from session cart", 500);
+      }
+      await this.updateGuestCheckoutAddress(trackingResult.checkoutId, {
+        shippingAddress: {
+          ...localCart.shippingAddress,
+          email: localCart.customer.email
+        },
+        billingAddress: localCart.billingAddress
+      });
+      const orderResult = await this.completeGuestCheckout(trackingResult.checkoutId, {
+        clearCartOnSuccess: options?.clearCartOnSuccess
+      });
+      return {
+        orderId: orderResult.orderId,
+        orderNumber: orderResult.orderNumber || orderResult.orderId,
+        status: orderResult.status || "pending",
+        total: orderResult.total ?? 0,
+        message: orderResult.message || "Order created successfully"
+      };
+    }
     const cart = this.getLocalCart();
     if (cart.items.length === 0) {
       throw new BrainerceError("Cart is empty", 400);
@@ -3397,7 +3620,6 @@ var BrainerceClient = class {
           shippingAddress: {
             ...cart.shippingAddress,
             email: cart.customer.email
-            // Already validated above
           },
           billingAddress: cart.billingAddress
         });
@@ -3456,14 +3678,14 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Full checkout (all items)
-   * const result = await omni.startGuestCheckout();
+   * const result = await client.startGuestCheckout();
    *
    * // Partial checkout (only items at index 0 and 2)
-   * const result = await omni.startGuestCheckout({ selectedIndices: [0, 2] });
+   * const result = await client.startGuestCheckout({ selectedIndices: [0, 2] });
    *
    * if (result.tracked) {
    *   // IMPORTANT: Fetch checkout and use checkout.lineItems for Order Summary!
-   *   const checkout = await omni.getCheckout(result.checkoutId);
+   *   const checkout = await client.getCheckout(result.checkoutId);
    *
    *   // Display Order Summary using checkout.lineItems (NOT localCart.items!)
    *   // checkout.lineItems contains ONLY the selected items
@@ -3472,19 +3694,47 @@ var BrainerceClient = class {
    *   });
    *
    *   // Update checkout with address
-   *   await omni.updateGuestCheckoutAddress(result.checkoutId, {
+   *   await client.updateGuestCheckoutAddress(result.checkoutId, {
    *     shippingAddress: { ... },
    *   });
    *
    *   // After payment success, call handlePaymentSuccess() to clear cart
-   *   omni.handlePaymentSuccess(result.checkoutId);
+   *   client.handlePaymentSuccess(result.checkoutId);
    * } else {
    *   // Tracking not enabled, use regular submitGuestOrder
-   *   const order = await omni.submitGuestOrder();
+   *   const order = await client.submitGuestOrder();
    * }
    * ```
    */
   async startGuestCheckout(options) {
+    if (this.sessionToken) {
+      const serverCart = await this.getOrCreateSessionCart();
+      if (!serverCart.items || serverCart.items.length === 0) {
+        throw new BrainerceError("Cart is empty", 400);
+      }
+      let selectedItemIds;
+      if (options?.selectedIndices?.length) {
+        selectedItemIds = options.selectedIndices.map((i) => serverCart.items[i]?.id).filter((id) => !!id);
+        if (selectedItemIds.length === 0) {
+          throw new BrainerceError("No items selected for checkout", 400);
+        }
+      }
+      const checkout = await this.createCheckout({
+        cartId: serverCart.id,
+        selectedItemIds
+      });
+      this.saveActiveCheckout({
+        checkoutId: checkout.id,
+        cartId: serverCart.id,
+        selectedIndices: options?.selectedIndices
+      });
+      return {
+        tracked: true,
+        checkoutId: checkout.id,
+        cartId: serverCart.id,
+        message: "Checkout created from session cart"
+      };
+    }
     const cart = this.getLocalCart();
     if (cart.items.length === 0) {
       throw new BrainerceError("Cart is empty", 400);
@@ -3548,16 +3798,8 @@ var BrainerceClient = class {
     }
   }
   /**
+   * @deprecated Partial checkout is now handled server-side via `selectedItemIds`.
    * Remove specific items from local cart by their indices.
-   * Use after partial checkout to remove only the purchased items.
-   *
-   * @param indices - Array of item indices to remove
-   *
-   * @example
-   * ```typescript
-   * // After partial checkout success, remove purchased items
-   * omni.removeLocalCartItemsByIndex([0, 2]); // Removes items at index 0 and 2
-   * ```
    */
   removeLocalCartItemsByIndex(indices) {
     const cart = this.getLocalCart();
@@ -3612,13 +3854,13 @@ var BrainerceClient = class {
    *
    * @example Full checkout (clears entire cart):
    * ```typescript
-   * await omni.completeGuestCheckout(checkoutId);
+   * await client.completeGuestCheckout(checkoutId);
    * ```
    *
    * @example Partial checkout (removes only purchased items):
    * ```typescript
    * // User selected items at indices 0 and 2 for checkout
-   * await omni.completeGuestCheckout(checkoutId, { selectedIndices: [0, 2] });
+   * await client.completeGuestCheckout(checkoutId, { selectedIndices: [0, 2] });
    * // Items at indices 1, 3, etc. remain in cart
    * ```
    */
@@ -3634,6 +3876,7 @@ var BrainerceClient = class {
         this.removeLocalCartItemsByIndex(indices);
       } else {
         this.clearLocalCart();
+        this.clearSessionCart();
       }
       this.customerCartId = null;
     }
@@ -3648,7 +3891,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const activeCheckout = omni.getActiveGuestCheckout();
+   * const activeCheckout = client.getActiveGuestCheckout();
    * if (activeCheckout) {
    *   console.log('Active checkout:', activeCheckout.checkoutId);
    *   console.log('Partial checkout:', activeCheckout.selectedIndices?.length);
@@ -3689,7 +3932,7 @@ var BrainerceClient = class {
    *
    * if (!error && paymentIntent?.status === 'succeeded') {
    *   // Clear the cart automatically - handles all scenarios!
-   *   const result = omni.handlePaymentSuccess(checkoutId);
+   *   const result = client.handlePaymentSuccess(checkoutId);
    *   console.log('Cart cleared:', result.cleared);
    *   console.log('User type:', result.userType); // 'guest' or 'customer'
    * }
@@ -3700,13 +3943,13 @@ var BrainerceClient = class {
    * // On success page (after redirect)
    * const checkoutId = new URLSearchParams(location.search).get('checkout_id');
    * if (checkoutId) {
-   *   omni.handlePaymentSuccess(checkoutId);
+   *   client.handlePaymentSuccess(checkoutId);
    * }
    * ```
    */
   handlePaymentSuccess(checkoutId) {
     const isLoggedIn = this.isCustomerLoggedIn();
-    const handledKey = `omni_payment_handled_${checkoutId || "latest"}`;
+    const handledKey = `brainerce_payment_handled_${checkoutId || "latest"}`;
     if (typeof window !== "undefined" && window.sessionStorage) {
       if (sessionStorage.getItem(handledKey)) {
         return {
@@ -3731,6 +3974,7 @@ var BrainerceClient = class {
     }
     if (isLoggedIn) {
       this.clearLocalCart();
+      this.clearSessionCart();
       return {
         cleared: true,
         mode: "full",
@@ -3747,6 +3991,7 @@ var BrainerceClient = class {
       };
     }
     this.clearLocalCart();
+    this.clearSessionCart();
     return {
       cleared: true,
       mode: "full",
@@ -3766,7 +4011,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const result = await omni.createGuestOrder({
+   * const result = await client.createGuestOrder({
    *   items: [{ productId: 'prod_123', quantity: 2 }],
    *   customer: { email: 'john@example.com' },
    *   shippingAddress: { firstName: 'John', ... },
@@ -3784,9 +4029,9 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const auth = await omni.loginCustomer('user@example.com', 'password');
-   * omni.setCustomerToken(auth.token);
-   * const profile = await omni.getMyProfile();
+   * const auth = await client.loginCustomer('user@example.com', 'password');
+   * client.setCustomerToken(auth.token);
+   * const profile = await client.getMyProfile();
    * ```
    */
   async getMyProfile() {
@@ -3814,9 +4059,9 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * omni.setCustomerToken(auth.token);
+   * client.setCustomerToken(auth.token);
    *
-   * const prefill = await omni.getCheckoutPrefillData();
+   * const prefill = await client.getCheckoutPrefillData();
    *
    * if (prefill.shippingAddress) {
    *   // Pre-fill shipping form with customer's default address
@@ -3913,7 +4158,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const links = await omni.getOrderDownloads('order_123');
+   * const links = await client.getOrderDownloads('order_123');
    * for (const link of links) {
    *   console.log(`${link.productName}: ${link.downloadUrl}`);
    * }
@@ -4066,7 +4311,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const integrations = await omni.getCustomApiIntegrations();
+   * const integrations = await client.getCustomApiIntegrations();
    * integrations.forEach(api => {
    *   console.log(`${api.name}: ${api.status}`);
    * });
@@ -4081,7 +4326,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const api = await omni.getCustomApiIntegration('api_123');
+   * const api = await client.getCustomApiIntegration('api_123');
    * console.log(`API: ${api.name}, URL: ${api.baseUrl}`);
    * ```
    */
@@ -4094,7 +4339,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const api = await omni.createCustomApiIntegration({
+   * const api = await client.createCustomApiIntegration({
    *   name: 'My External API',
    *   baseUrl: 'https://api.example.com',
    *   authType: 'api_key',
@@ -4120,7 +4365,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const api = await omni.updateCustomApiIntegration('api_123', {
+   * const api = await client.updateCustomApiIntegration('api_123', {
    *   enabled: false,
    *   syncConfig: { products: true, orders: false, inventory: true },
    * });
@@ -4139,7 +4384,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * await omni.deleteCustomApiIntegration('api_123');
+   * await client.deleteCustomApiIntegration('api_123');
    * ```
    */
   async deleteCustomApiIntegration(integrationId) {
@@ -4151,7 +4396,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const result = await omni.testCustomApiConnection('api_123');
+   * const result = await client.testCustomApiConnection('api_123');
    * if (result.success) {
    *   console.log(`Connection OK, latency: ${result.latency}ms`);
    * } else {
@@ -4179,7 +4424,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const availability = await omni.getAvailability(['prod_123', 'prod_456']);
+   * const availability = await client.getAvailability(['prod_123', 'prod_456']);
    * availability.forEach(item => {
    *   if (!item.canPurchase) {
    *     console.log(`${item.productId}: Cannot purchase`);
@@ -4213,7 +4458,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Extend reservation when customer shows activity
-   * const result = await omni.extendReservation({ checkoutId: 'chk_123' });
+   * const result = await client.extendReservation({ checkoutId: 'chk_123' });
    * if (result.success) {
    *   console.log(`Reservation extended until ${result.reservation.expiresAt}`);
    * }
@@ -4243,7 +4488,7 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Release reservation when customer abandons checkout
-   * await omni.releaseReservation({ checkoutId: 'chk_123' });
+   * await client.releaseReservation({ checkoutId: 'chk_123' });
    * ```
    */
   async releaseReservation(options) {
@@ -4266,7 +4511,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const categories = await omni.listCategories({ page: 1, limit: 20 });
+   * const categories = await client.listCategories({ page: 1, limit: 20 });
    * console.log(`Found ${categories.meta.total} categories`);
    * ```
    */
@@ -4291,7 +4536,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const category = await omni.createCategory({
+   * const category = await client.createCategory({
    *   name: 'Electronics',
    *   slug: 'electronics',
    *   description: 'Electronic devices and accessories',
@@ -4337,7 +4582,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const brand = await omni.createBrand({
+   * const brand = await client.createBrand({
    *   name: 'Nike',
    *   slug: 'nike',
    *   logoUrl: 'https://example.com/nike-logo.png',
@@ -4383,7 +4628,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const tag = await omni.createTag({
+   * const tag = await client.createTag({
    *   name: 'New Arrival',
    *   slug: 'new-arrival',
    * });
@@ -4433,7 +4678,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const attribute = await omni.createAttribute({
+   * const attribute = await client.createAttribute({
    *   name: 'Color',
    *   slug: 'color',
    *   source: 'custom',
@@ -4470,7 +4715,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const option = await omni.createAttributeOption('attr_123', {
+   * const option = await client.createAttributeOption('attr_123', {
    *   value: 'Red',
    *   slug: 'red',
    *   sortOrder: 1,
@@ -4532,7 +4777,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const zone = await omni.createShippingZone({
+   * const zone = await client.createShippingZone({
    *   name: 'US Domestic',
    *   countries: ['US'],
    *   regions: ['CA', 'NY', 'TX'],
@@ -4569,7 +4814,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const rate = await omni.createZoneShippingRate('zone_123', {
+   * const rate = await client.createZoneShippingRate('zone_123', {
    *   name: 'Standard Shipping',
    *   type: 'flat',
    *   price: 5.99,
@@ -4625,7 +4870,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const rate = await omni.createTaxRate({
+   * const rate = await client.createTaxRate({
    *   name: 'California Sales Tax',
    *   rate: 7.25,
    *   country: 'US',
@@ -4711,7 +4956,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const definition = await omni.createMetafieldDefinition({
+   * const definition = await client.createMetafieldDefinition({
    *   name: 'Care Instructions',
    *   key: 'care_instructions',
    *   type: 'multi_line_text',
@@ -4758,7 +5003,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const metafield = await omni.setProductMetafield('prod_123', 'def_456', {
+   * const metafield = await client.setProductMetafield('prod_123', 'def_456', {
    *   value: 'Machine wash cold, tumble dry low',
    * });
    * ```
@@ -4835,7 +5080,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const { members, invitations } = await omni.getStoreTeam('store_id');
+   * const { members, invitations } = await client.getStoreTeam('store_id');
    * ```
    */
   async getStoreTeam(storeId) {
@@ -4847,7 +5092,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const invitation = await omni.inviteStoreMember('store_id', {
+   * const invitation = await client.inviteStoreMember('store_id', {
    *   email: 'newmember@example.com',
    *   role: 'MANAGER', // 'MANAGER' | 'STAFF' | 'VIEWER'
    * });
@@ -4867,10 +5112,10 @@ var BrainerceClient = class {
    * @example
    * ```typescript
    * // Update role
-   * await omni.updateStoreMember('store_id', 'member_id', { role: 'MANAGER' });
+   * await client.updateStoreMember('store_id', 'member_id', { role: 'MANAGER' });
    *
    * // Set custom permissions (overrides role defaults)
-   * await omni.updateStoreMember('store_id', 'member_id', {
+   * await client.updateStoreMember('store_id', 'member_id', {
    *   permissions: ['VIEW_PRODUCTS', 'VIEW_ORDERS', 'FULFILL_ORDERS'],
    * });
    * ```
@@ -4929,7 +5174,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const stores = await omni.getMyStores();
+   * const stores = await client.getMyStores();
    * // Returns stores from all accounts where user is owner or team member
    * stores.forEach(store => {
    *   console.log(`${store.name} - ${store.role} (${store.context})`);
@@ -4945,7 +5190,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const { role, permissions } = await omni.getMyStorePermissions('store_id');
+   * const { role, permissions } = await client.getMyStorePermissions('store_id');
    * if (permissions.includes('MANAGE_TEAM')) {
    *   // Show team management UI
    * }
@@ -4993,7 +5238,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const template = await omni.createEmailTemplate({
+   * const template = await client.createEmailTemplate({
    *   name: 'Order Confirmation',
    *   eventType: 'ORDER_CONFIRMATION',
    *   subject: 'Your order #{{orderNumber}} has been confirmed',
@@ -5105,7 +5350,7 @@ var BrainerceClient = class {
    *
    * @example
    * ```typescript
-   * const config = await omni.configureOAuthProvider({
+   * const config = await client.configureOAuthProvider({
    *   provider: 'GOOGLE',
    *   clientId: 'your-google-client-id',
    *   clientSecret: 'your-google-client-secret',
@@ -5145,6 +5390,7 @@ var BrainerceError = class extends Error {
 };
 
 // src/webhooks.ts
+import crypto from "crypto";
 function verifyWebhook(payload, signature, secret) {
   if (!signature || !secret) {
     return false;
@@ -5154,12 +5400,6 @@ function verifyWebhook(payload, signature, secret) {
 }
 function verifyHmacSignature(payload, signature, secret) {
   try {
-    if (typeof globalThis.crypto === "undefined") {
-      const crypto2 = __require("crypto");
-      const expectedSignature2 = crypto2.createHmac("sha256", secret).update(payload).digest("hex");
-      return timingSafeEqual(signature, expectedSignature2);
-    }
-    const crypto = __require("crypto");
     const expectedSignature = crypto.createHmac("sha256", secret).update(payload).digest("hex");
     return timingSafeEqual(signature, expectedSignature);
   } catch (error) {
@@ -5385,15 +5625,9 @@ function isCouponApplicableToProduct(coupon, productId) {
   }
   return true;
 }
-
-// src/index.ts
-var OmniSyncClient = BrainerceClient;
-var OmniSyncError = BrainerceError;
 export {
   BrainerceClient,
   BrainerceError,
-  OmniSyncClient,
-  OmniSyncError,
   createWebhookHandler,
   enableDevGuards,
   formatPrice,