@cimplify/sdk 0.3.5 → 0.4.0

package/dist/index.mjs

@@ -153,9 +153,6 @@ var CatalogueQueries = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // PRODUCTS
-  // --------------------------------------------------------------------------
   async getProducts(options) {
     let query2 = "products";
     const filters = [];
@@ -204,9 +201,6 @@ var CatalogueQueries = class {
     }
     return ok(result.value[0]);
   }
-  // --------------------------------------------------------------------------
-  // VARIANTS
-  // --------------------------------------------------------------------------
   async getVariants(productId) {
     return safe(this.client.query(`products.${productId}.variants`));
   }
@@ -230,15 +224,9 @@ var CatalogueQueries = class {
   async getVariantById(productId, variantId) {
     return safe(this.client.query(`products.${productId}.variant.${variantId}`));
   }
-  // --------------------------------------------------------------------------
-  // ADD-ONS
-  // --------------------------------------------------------------------------
   async getAddOns(productId) {
     return safe(this.client.query(`products.${productId}.add_ons`));
   }
-  // --------------------------------------------------------------------------
-  // CATEGORIES
-  // --------------------------------------------------------------------------
   async getCategories() {
     return safe(this.client.query("categories"));
   }
@@ -258,9 +246,6 @@ var CatalogueQueries = class {
   async getCategoryProducts(categoryId) {
     return safe(this.client.query(`products[?(@.category_id=='${categoryId}')]`));
   }
-  // --------------------------------------------------------------------------
-  // COLLECTIONS
-  // --------------------------------------------------------------------------
   async getCollections() {
     return safe(this.client.query("collections"));
   }
@@ -285,9 +270,6 @@ var CatalogueQueries = class {
       this.client.query(`collections[?(@.name contains '${query2}')]#limit(${limit})`)
     );
   }
-  // --------------------------------------------------------------------------
-  // BUNDLES
-  // --------------------------------------------------------------------------
   async getBundles() {
     return safe(this.client.query("bundles"));
   }
@@ -309,9 +291,6 @@ var CatalogueQueries = class {
       this.client.query(`bundles[?(@.name contains '${query2}')]#limit(${limit})`)
     );
   }
-  // --------------------------------------------------------------------------
-  // COMPOSITES (Build-Your-Own)
-  // --------------------------------------------------------------------------
   async getComposites(options) {
     let query2 = "composites";
     if (options?.limit) {
@@ -334,9 +313,6 @@ var CatalogueQueries = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // SEARCH
-  // --------------------------------------------------------------------------
   async search(query2, options) {
     const limit = options?.limit ?? 20;
     let searchQuery = `products[?(@.name contains '${query2}')]`;
@@ -355,9 +331,6 @@ var CatalogueQueries = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // MENU (Restaurant-specific)
-  // --------------------------------------------------------------------------
   async getMenu(options) {
     let query2 = "menu";
     if (options?.category) {
@@ -395,13 +368,6 @@ var CartOperations = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // CART QUERIES
-  // --------------------------------------------------------------------------
-  /**
-   * Get the enriched cart with product names, images, and details.
-   * This is the main method for storefront display.
-   */
   async get() {
     return safe2(this.client.query("cart#enriched"));
   }
@@ -431,33 +397,6 @@ var CartOperations = class {
       currency: cart.pricing.currency
     });
   }
-  // --------------------------------------------------------------------------
-  // CART MUTATIONS
-  // --------------------------------------------------------------------------
-  /**
-   * Add an item to the cart.
-   *
-   * @example
-   * ```typescript
-   * const result = await client.cart.addItem({
-   *   item_id: "prod_burger",
-   *   quantity: 2,
-   *   variant_id: "var_large",
-   *   add_on_options: ["addon_cheese", "addon_bacon"],
-   * });
-   *
-   * if (!result.ok) {
-   *   switch (result.error.code) {
-   *     case ErrorCode.ITEM_UNAVAILABLE:
-   *       toast.error("Item no longer available");
-   *       break;
-   *     case ErrorCode.VARIANT_OUT_OF_STOCK:
-   *       toast.error("Selected option is out of stock");
-   *       break;
-   *   }
-   * }
-   * ```
-   */
   async addItem(input) {
     return safe2(this.client.call("cart.addItem", input));
   }
@@ -487,9 +426,6 @@ var CartOperations = class {
   async clear() {
     return safe2(this.client.call("cart.clearCart"));
   }
-  // --------------------------------------------------------------------------
-  // COUPONS & DISCOUNTS
-  // --------------------------------------------------------------------------
   async applyCoupon(code) {
     return safe2(
       this.client.call("cart.applyCoupon", {
@@ -500,9 +436,6 @@ var CartOperations = class {
   async removeCoupon() {
     return safe2(this.client.call("cart.removeCoupon"));
   }
-  // --------------------------------------------------------------------------
-  // CONVENIENCE METHODS
-  // --------------------------------------------------------------------------
   async isEmpty() {
     const countResult = await this.getCount();
     if (!countResult.ok) return countResult;
@@ -586,6 +519,15 @@ var AUTHORIZATION_TYPE = {
   BIRTHDAY: "birthday",
   ADDRESS: "address"
 };
+var DEVICE_TYPE = {
+  MOBILE: "mobile",
+  DESKTOP: "desktop",
+  TABLET: "tablet"
+};
+var CONTACT_TYPE = {
+  PHONE: "phone",
+  EMAIL: "email"
+};
 var LINK_QUERY = {
   DATA: "link.data",
   ADDRESSES: "link.addresses",
@@ -655,35 +597,6 @@ var CheckoutService = class {
   constructor(client) {
     this.client = client;
   }
-  /**
-   * Process checkout with cart data.
-   *
-   * Automatically generates an idempotency key if not provided to ensure
-   * payment safety. The same key is used across retries, preventing
-   * duplicate charges if a network error occurs after payment processing.
-   *
-   * @example
-   * ```typescript
-   * const result = await client.checkout.process({
-   *   cart_id: cart.id,
-   *   customer: { name, email, phone, save_details: true },
-   *   order_type: "pickup",
-   *   payment_method: "mobile_money",
-   *   mobile_money_details: { phone_number, provider: "mtn" },
-   * });
-   *
-   * if (!result.ok) {
-   *   switch (result.error.code) {
-   *     case ErrorCode.CART_EMPTY:
-   *       toast.error("Your cart is empty");
-   *       break;
-   *     case ErrorCode.PAYMENT_FAILED:
-   *       toast.error("Payment failed. Please try again.");
-   *       break;
-   *   }
-   * }
-   * ```
-   */
   async process(data) {
     const checkoutData = {
       ...data,
@@ -801,9 +714,6 @@ var LinkService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // AUTHENTICATION
-  // --------------------------------------------------------------------------
   async requestOtp(input) {
     return safe5(this.client.linkPost("/v1/link/auth/request-otp", input));
   }
@@ -823,9 +733,6 @@ var LinkService = class {
     }
     return result;
   }
-  // --------------------------------------------------------------------------
-  // STATUS & DATA
-  // --------------------------------------------------------------------------
   async checkStatus(contact) {
     return safe5(
       this.client.call(LINK_MUTATION.CHECK_STATUS, {
@@ -845,9 +752,6 @@ var LinkService = class {
   async getPreferences() {
     return safe5(this.client.query(LINK_QUERY.PREFERENCES));
   }
-  // --------------------------------------------------------------------------
-  // ENROLLMENT
-  // --------------------------------------------------------------------------
   async enroll(data) {
     return safe5(this.client.call(LINK_MUTATION.ENROLL, data));
   }
@@ -856,15 +760,9 @@ var LinkService = class {
       this.client.call(LINK_MUTATION.ENROLL_AND_LINK_ORDER, data)
     );
   }
-  // --------------------------------------------------------------------------
-  // PREFERENCES
-  // --------------------------------------------------------------------------
   async updatePreferences(preferences) {
     return safe5(this.client.call(LINK_MUTATION.UPDATE_PREFERENCES, preferences));
   }
-  // --------------------------------------------------------------------------
-  // ADDRESSES
-  // --------------------------------------------------------------------------
   async createAddress(input) {
     return safe5(this.client.call(LINK_MUTATION.CREATE_ADDRESS, input));
   }
@@ -884,9 +782,6 @@ var LinkService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // MOBILE MONEY
-  // --------------------------------------------------------------------------
   async createMobileMoney(input) {
     return safe5(this.client.call(LINK_MUTATION.CREATE_MOBILE_MONEY, input));
   }
@@ -910,9 +805,6 @@ var LinkService = class {
       this.client.call(LINK_MUTATION.VERIFY_MOBILE_MONEY, mobileMoneyId)
     );
   }
-  // --------------------------------------------------------------------------
-  // SESSIONS
-  // --------------------------------------------------------------------------
   async getSessions() {
     return safe5(this.client.linkGet("/v1/link/sessions"));
   }
@@ -922,9 +814,6 @@ var LinkService = class {
   async revokeAllSessions() {
     return safe5(this.client.linkDelete("/v1/link/sessions"));
   }
-  // --------------------------------------------------------------------------
-  // REST ALTERNATIVES (for direct API access)
-  // --------------------------------------------------------------------------
   async getAddressesRest() {
     return safe5(this.client.linkGet("/v1/link/addresses"));
   }
@@ -972,9 +861,6 @@ var AuthService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // STATUS & USER
-  // --------------------------------------------------------------------------
   async getStatus() {
     return safe6(this.client.query("auth"));
   }
@@ -988,9 +874,6 @@ var AuthService = class {
     if (!result.ok) return result;
     return ok(result.value.is_authenticated);
   }
-  // --------------------------------------------------------------------------
-  // OTP AUTHENTICATION
-  // --------------------------------------------------------------------------
   async requestOtp(contact, contactType) {
     return safe6(
       this.client.call(AUTH_MUTATION.REQUEST_OTP, {
@@ -1007,15 +890,9 @@ var AuthService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // SESSION MANAGEMENT
-  // --------------------------------------------------------------------------
   async logout() {
     return safe6(this.client.call("auth.logout"));
   }
-  // --------------------------------------------------------------------------
-  // PROFILE MANAGEMENT
-  // --------------------------------------------------------------------------
   async updateProfile(input) {
     return safe6(this.client.call("auth.update_profile", input));
   }
@@ -1046,9 +923,6 @@ var BusinessService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // BUSINESS INFO
-  // --------------------------------------------------------------------------
   async getInfo() {
     return safe7(this.client.query("business.info"));
   }
@@ -1064,27 +938,18 @@ var BusinessService = class {
   async getTheme() {
     return safe7(this.client.query("business.theme"));
   }
-  // --------------------------------------------------------------------------
-  // LOCATIONS
-  // --------------------------------------------------------------------------
   async getLocations() {
     return safe7(this.client.query("business.locations"));
   }
   async getLocation(locationId) {
     return safe7(this.client.query(`business.locations.${locationId}`));
   }
-  // --------------------------------------------------------------------------
-  // HOURS
-  // --------------------------------------------------------------------------
   async getHours() {
     return safe7(this.client.query("business.hours"));
   }
   async getLocationHours(locationId) {
     return safe7(this.client.query(`business.locations.${locationId}.hours`));
   }
-  // --------------------------------------------------------------------------
-  // BOOTSTRAP (for storefront initialization)
-  // --------------------------------------------------------------------------
   async getBootstrap() {
     const [businessResult, locationsResult, categoriesResult] = await Promise.all([
       this.getInfo(),
@@ -1129,9 +994,6 @@ var InventoryService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // STOCK QUERIES
-  // --------------------------------------------------------------------------
   async getStockLevels() {
     return safe8(this.client.query("inventory.stock_levels"));
   }
@@ -1158,9 +1020,6 @@ var InventoryService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // AVAILABILITY CHECKS
-  // --------------------------------------------------------------------------
   async checkProductAvailability(productId, quantity, locationId) {
     return safe8(
       this.client.query("inventory.check_availability", {
@@ -1190,15 +1049,9 @@ var InventoryService = class {
     }
     return ok(results.map((r) => r.value));
   }
-  // --------------------------------------------------------------------------
-  // SUMMARY
-  // --------------------------------------------------------------------------
   async getSummary() {
     return safe8(this.client.query("inventory.summary"));
   }
-  // --------------------------------------------------------------------------
-  // CONVENIENCE METHODS
-  // --------------------------------------------------------------------------
   async isInStock(productId, locationId) {
     const result = await this.checkProductAvailability(productId, 1, locationId);
     if (!result.ok) return result;
@@ -1230,9 +1083,6 @@ var SchedulingService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // SERVICES
-  // --------------------------------------------------------------------------
   async getServices() {
     return safe9(this.client.query("scheduling.services"));
   }
@@ -1245,9 +1095,6 @@ var SchedulingService = class {
     if (!result.ok) return result;
     return ok(result.value.find((s) => s.id === serviceId) || null);
   }
-  // --------------------------------------------------------------------------
-  // AVAILABILITY
-  // --------------------------------------------------------------------------
   async getAvailableSlots(input) {
     return safe9(
       this.client.query(
@@ -1272,9 +1119,6 @@ var SchedulingService = class {
       )
     );
   }
-  // --------------------------------------------------------------------------
-  // BOOKINGS
-  // --------------------------------------------------------------------------
   async getBooking(bookingId) {
     return safe9(this.client.query(`scheduling.${bookingId}`));
   }
@@ -1295,18 +1139,12 @@ var SchedulingService = class {
       )
     );
   }
-  // --------------------------------------------------------------------------
-  // BOOKING MANAGEMENT
-  // --------------------------------------------------------------------------
   async cancelBooking(input) {
     return safe9(this.client.call("scheduling.cancel_booking", input));
   }
   async rescheduleBooking(input) {
     return safe9(this.client.call("scheduling.reschedule_booking", input));
   }
-  // --------------------------------------------------------------------------
-  // CONVENIENCE METHODS
-  // --------------------------------------------------------------------------
   async getNextAvailableSlot(serviceId, fromDate) {
     const date = fromDate || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const result = await this.getAvailableSlots({
@@ -1345,15 +1183,9 @@ var LiteService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // BOOTSTRAP
-  // --------------------------------------------------------------------------
   async getBootstrap() {
     return safe10(this.client.query("lite.bootstrap"));
   }
-  // --------------------------------------------------------------------------
-  // TABLE MANAGEMENT
-  // --------------------------------------------------------------------------
   async getTable(tableId) {
     return safe10(this.client.query(`lite.table.${tableId}`));
   }
@@ -1365,9 +1197,6 @@ var LiteService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // KITCHEN ORDERS
-  // --------------------------------------------------------------------------
   async sendToKitchen(tableId, items) {
     return safe10(
       this.client.call("lite.send_to_kitchen", {
@@ -1391,9 +1220,6 @@ var LiteService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // MENU (optimized for lite/QR experience)
-  // --------------------------------------------------------------------------
   async getMenu() {
     return safe10(this.client.query("lite.menu"));
   }
@@ -1402,6 +1228,297 @@ var LiteService = class {
   }
 };
 
+// src/types/elements.ts
+var ELEMENT_TYPES = {
+  AUTH: "auth",
+  ADDRESS: "address",
+  PAYMENT: "payment"
+};
+var MESSAGE_TYPES = {
+  // Parent → Iframe
+  INIT: "init",
+  SET_TOKEN: "set_token",
+  GET_DATA: "get_data",
+  REFRESH_TOKEN: "refresh_token",
+  LOGOUT: "logout",
+  // Iframe → Parent
+  READY: "ready",
+  HEIGHT_CHANGE: "height_change",
+  AUTHENTICATED: "authenticated",
+  REQUIRES_OTP: "requires_otp",
+  ERROR: "error",
+  ADDRESS_CHANGED: "address_changed",
+  ADDRESS_SELECTED: "address_selected",
+  PAYMENT_METHOD_SELECTED: "payment_method_selected",
+  TOKEN_REFRESHED: "token_refreshed",
+  LOGOUT_COMPLETE: "logout_complete"
+};
+var EVENT_TYPES = {
+  READY: "ready",
+  AUTHENTICATED: "authenticated",
+  REQUIRES_OTP: "requires_otp",
+  ERROR: "error",
+  CHANGE: "change",
+  BLUR: "blur",
+  FOCUS: "focus"
+};
+
+// src/elements.ts
+var DEFAULT_LINK_URL = "https://link.cimplify.io";
+var CimplifyElements = class {
+  constructor(client, businessId, options = {}) {
+    this.elements = /* @__PURE__ */ new Map();
+    this.accessToken = null;
+    this.accountId = null;
+    this.customerId = null;
+    this.addressData = null;
+    this.paymentData = null;
+    this.client = client;
+    this.businessId = businessId;
+    this.linkUrl = options.linkUrl || DEFAULT_LINK_URL;
+    this.options = options;
+    if (typeof window !== "undefined") {
+      window.addEventListener("message", this.handleMessage.bind(this));
+    }
+  }
+  create(type, options = {}) {
+    const existing = this.elements.get(type);
+    if (existing) return existing;
+    const element = new CimplifyElement(type, this.businessId, this.linkUrl, options, this);
+    this.elements.set(type, element);
+    return element;
+  }
+  getElement(type) {
+    return this.elements.get(type);
+  }
+  destroy() {
+    this.elements.forEach((element) => element.destroy());
+    this.elements.clear();
+    if (typeof window !== "undefined") {
+      window.removeEventListener("message", this.handleMessage.bind(this));
+    }
+  }
+  async submitCheckout(data) {
+    const addressElement = this.elements.get(ELEMENT_TYPES.ADDRESS);
+    if (addressElement) await addressElement.getData();
+    const paymentElement = this.elements.get(ELEMENT_TYPES.PAYMENT);
+    if (paymentElement) await paymentElement.getData();
+    const checkoutData = {
+      ...data,
+      customer: this.accountId ? { account_id: this.accountId, customer_id: this.customerId } : void 0,
+      address: this.addressData,
+      payment_method: this.paymentData
+    };
+    const result = await this.client.checkout.process(checkoutData);
+    if (result.ok) {
+      return { success: true, order: result.value };
+    }
+    return {
+      success: false,
+      error: {
+        code: result.error.code || "CHECKOUT_FAILED",
+        message: result.error.message || "Checkout failed"
+      }
+    };
+  }
+  isAuthenticated() {
+    return this.accessToken !== null;
+  }
+  getAccessToken() {
+    return this.accessToken;
+  }
+  handleMessage(event) {
+    if (!event.origin.includes("cimplify.io") && !event.origin.includes("localhost")) {
+      return;
+    }
+    const message = event.data;
+    if (!message?.type) return;
+    switch (message.type) {
+      case MESSAGE_TYPES.AUTHENTICATED:
+        this.accessToken = message.token;
+        this.accountId = message.accountId;
+        this.customerId = message.customerId;
+        this.elements.forEach((element, type) => {
+          if (type !== ELEMENT_TYPES.AUTH) {
+            element.sendMessage({ type: MESSAGE_TYPES.SET_TOKEN, token: message.token });
+          }
+        });
+        break;
+      case MESSAGE_TYPES.TOKEN_REFRESHED:
+        this.accessToken = message.token;
+        break;
+      case MESSAGE_TYPES.ADDRESS_CHANGED:
+      case MESSAGE_TYPES.ADDRESS_SELECTED:
+        this.addressData = message.address;
+        break;
+      case MESSAGE_TYPES.PAYMENT_METHOD_SELECTED:
+        this.paymentData = message.method;
+        break;
+      case MESSAGE_TYPES.LOGOUT_COMPLETE:
+        this.accessToken = null;
+        this.accountId = null;
+        this.customerId = null;
+        this.addressData = null;
+        this.paymentData = null;
+        break;
+    }
+  }
+  _setAddressData(data) {
+    this.addressData = data;
+  }
+  _setPaymentData(data) {
+    this.paymentData = data;
+  }
+};
+var CimplifyElement = class {
+  constructor(type, businessId, linkUrl, options, parent) {
+    this.iframe = null;
+    this.container = null;
+    this.mounted = false;
+    this.eventHandlers = /* @__PURE__ */ new Map();
+    this.resolvers = /* @__PURE__ */ new Map();
+    this.type = type;
+    this.businessId = businessId;
+    this.linkUrl = linkUrl;
+    this.options = options;
+    this.parent = parent;
+    if (typeof window !== "undefined") {
+      window.addEventListener("message", this.handleMessage.bind(this));
+    }
+  }
+  mount(container) {
+    if (this.mounted) {
+      console.warn(`Element ${this.type} is already mounted`);
+      return;
+    }
+    const target = typeof container === "string" ? document.querySelector(container) : container;
+    if (!target) {
+      console.error(`Container not found: ${container}`);
+      return;
+    }
+    this.container = target;
+    this.createIframe();
+    this.mounted = true;
+  }
+  destroy() {
+    if (this.iframe) {
+      this.iframe.remove();
+      this.iframe = null;
+    }
+    this.container = null;
+    this.mounted = false;
+    this.eventHandlers.clear();
+    if (typeof window !== "undefined") {
+      window.removeEventListener("message", this.handleMessage.bind(this));
+    }
+  }
+  on(event, handler) {
+    if (!this.eventHandlers.has(event)) {
+      this.eventHandlers.set(event, /* @__PURE__ */ new Set());
+    }
+    this.eventHandlers.get(event).add(handler);
+  }
+  off(event, handler) {
+    this.eventHandlers.get(event)?.delete(handler);
+  }
+  async getData() {
+    return new Promise((resolve) => {
+      const id = Math.random().toString(36).slice(2);
+      this.resolvers.set(id, resolve);
+      this.sendMessage({ type: MESSAGE_TYPES.GET_DATA });
+      setTimeout(() => {
+        if (this.resolvers.has(id)) {
+          this.resolvers.delete(id);
+          resolve(null);
+        }
+      }, 5e3);
+    });
+  }
+  sendMessage(message) {
+    if (this.iframe?.contentWindow) {
+      this.iframe.contentWindow.postMessage(message, this.linkUrl);
+    }
+  }
+  createIframe() {
+    if (!this.container) return;
+    const iframe = document.createElement("iframe");
+    const url = new URL(`${this.linkUrl}/elements/${this.type}`);
+    url.searchParams.set("businessId", this.businessId);
+    if (this.options.prefillEmail) url.searchParams.set("email", this.options.prefillEmail);
+    if (this.options.mode) url.searchParams.set("mode", this.options.mode);
+    iframe.src = url.toString();
+    iframe.style.border = "none";
+    iframe.style.width = "100%";
+    iframe.style.display = "block";
+    iframe.style.overflow = "hidden";
+    iframe.setAttribute("allowtransparency", "true");
+    iframe.setAttribute("frameborder", "0");
+    iframe.setAttribute("sandbox", "allow-scripts allow-same-origin allow-forms allow-popups");
+    this.iframe = iframe;
+    this.container.appendChild(iframe);
+    iframe.onload = () => {
+      this.sendMessage({
+        type: MESSAGE_TYPES.INIT,
+        businessId: this.businessId,
+        prefillEmail: this.options.prefillEmail
+      });
+      const token = this.parent.getAccessToken();
+      if (token && this.type !== ELEMENT_TYPES.AUTH) {
+        this.sendMessage({ type: MESSAGE_TYPES.SET_TOKEN, token });
+      }
+    };
+  }
+  handleMessage(event) {
+    if (!event.origin.includes("cimplify.io") && !event.origin.includes("localhost")) {
+      return;
+    }
+    const message = event.data;
+    if (!message?.type) return;
+    switch (message.type) {
+      case MESSAGE_TYPES.READY:
+        this.emit(EVENT_TYPES.READY, { height: message.height });
+        break;
+      case MESSAGE_TYPES.HEIGHT_CHANGE:
+        if (this.iframe) this.iframe.style.height = `${message.height}px`;
+        break;
+      case MESSAGE_TYPES.AUTHENTICATED:
+        this.emit(EVENT_TYPES.AUTHENTICATED, {
+          accountId: message.accountId,
+          customerId: message.customerId,
+          token: message.token
+        });
+        break;
+      case MESSAGE_TYPES.REQUIRES_OTP:
+        this.emit(EVENT_TYPES.REQUIRES_OTP, { contactMasked: message.contactMasked });
+        break;
+      case MESSAGE_TYPES.ERROR:
+        this.emit(EVENT_TYPES.ERROR, { code: message.code, message: message.message });
+        break;
+      case MESSAGE_TYPES.ADDRESS_CHANGED:
+      case MESSAGE_TYPES.ADDRESS_SELECTED:
+        this.parent._setAddressData(message.address);
+        this.emit(EVENT_TYPES.CHANGE, { address: message.address });
+        this.resolveData(message.address);
+        break;
+      case MESSAGE_TYPES.PAYMENT_METHOD_SELECTED:
+        this.parent._setPaymentData(message.method);
+        this.emit(EVENT_TYPES.CHANGE, { paymentMethod: message.method });
+        this.resolveData(message.method);
+        break;
+    }
+  }
+  emit(event, data) {
+    this.eventHandlers.get(event)?.forEach((handler) => handler(data));
+  }
+  resolveData(data) {
+    this.resolvers.forEach((resolve) => resolve(data));
+    this.resolvers.clear();
+  }
+};
+function createElements(client, businessId, options) {
+  return new CimplifyElements(client, businessId, options);
+}
+
 // src/client.ts
 var SESSION_TOKEN_HEADER = "x-session-token";
 var SESSION_STORAGE_KEY = "cimplify_session_token";
@@ -1467,7 +1584,6 @@ function deriveUrls() {
 var CimplifyClient = class {
   constructor(config = {}) {
     this.sessionToken = null;
-    /** In-flight request deduplication map */
     this.inflightRequests = /* @__PURE__ */ new Map();
     this.publicKey = config.publicKey || "";
     const urls = deriveUrls();
@@ -1541,10 +1657,6 @@ var CimplifyClient = class {
       });
     }
   }
-  /**
-   * Resilient fetch with timeout, automatic retries, and observability hooks.
-   * Uses exponential backoff: 1s, 2s, 4s between retries.
-   */
   async resilientFetch(url, options) {
     const method = options.method || "GET";
     const path = url.replace(this.baseUrl, "").replace(this.linkApiUrl, "");
@@ -1629,18 +1741,9 @@ var CimplifyClient = class {
     });
     throw finalError;
   }
-  /**
-   * Generate a deduplication key for a request.
-   * Same query + variables = same key = deduplicated.
-   */
   getDedupeKey(type, payload) {
     return `${type}:${JSON.stringify(payload)}`;
   }
-  /**
-   * Execute a request with deduplication.
-   * If an identical request is already in-flight, return the same promise.
-   * This prevents redundant network calls when multiple components request the same data.
-   */
   async deduplicatedRequest(key, requestFn) {
     const existing = this.inflightRequests.get(key);
     if (existing) {
@@ -1652,10 +1755,6 @@ var CimplifyClient = class {
     this.inflightRequests.set(key, request);
     return request;
   }
-  /**
-   * Execute a query with deduplication.
-   * Multiple identical queries made simultaneously will share a single network request.
-   */
   async query(query2, variables) {
     const body = { query: query2 };
     if (variables) {
@@ -1673,9 +1772,6 @@ var CimplifyClient = class {
       return this.handleResponse(response);
     });
   }
-  /**
-   * Execute a mutation. NOT deduplicated - mutations have side effects.
-   */
   async call(method, args) {
     const body = {
       method,
@@ -1834,6 +1930,23 @@ var CimplifyClient = class {
     }
     return this._lite;
   }
+  /**
+   * Create a CimplifyElements instance for embedding checkout components.
+   * Like Stripe's stripe.elements().
+   *
+   * @param businessId - The business ID for checkout context
+   * @param options - Optional configuration for elements
+   *
+   * @example
+   * ```ts
+   * const elements = client.elements('bus_xxx');
+   * const authElement = elements.create('auth');
+   * authElement.mount('#auth-container');
+   * ```
+   */
+  elements(businessId, options) {
+    return createElements(this, businessId, options);
+  }
 };
 function createCimplifyClient(config) {
   return new CimplifyClient(config);
@@ -2390,4 +2503,4 @@ function detectMobileMoneyProvider(phoneNumber) {
   return null;
 }
 
-export { AUTHORIZATION_TYPE, AUTH_MUTATION, AuthService, BusinessService, CHECKOUT_MODE, CHECKOUT_MUTATION, CHECKOUT_STEP, CURRENCY_SYMBOLS, CartOperations, CatalogueQueries, CheckoutService as CheckoutOperations, CheckoutService, CimplifyClient, CimplifyError, DEFAULT_COUNTRY, DEFAULT_CURRENCY, ErrorCode, InventoryService, LINK_MUTATION, LINK_QUERY, LinkService, LiteService, MOBILE_MONEY_PROVIDER, MOBILE_MONEY_PROVIDERS, ORDER_MUTATION, ORDER_TYPE, OrderQueries, PAYMENT_METHOD, PAYMENT_MUTATION, PAYMENT_STATE, PICKUP_TIME_TYPE, QueryBuilder, SchedulingService, categorizePaymentError, combine, combineObject, createCimplifyClient, detectMobileMoneyProvider, err, extractPriceInfo, flatMap, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatProductPrice, fromPromise, generateIdempotencyKey, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getMarkupPercentage, getOrElse, getProductCurrency, isCimplifyError, isErr, isOk, isOnSale, isRetryableError, mapError, mapResult, normalizePaymentResponse, normalizeStatusResponse, ok, parsePrice, parsePricePath, parsedPriceToPriceInfo, query, toNullable, tryCatch, unwrap };
+export { AUTHORIZATION_TYPE, AUTH_MUTATION, AuthService, BusinessService, CHECKOUT_MODE, CHECKOUT_MUTATION, CHECKOUT_STEP, CONTACT_TYPE, CURRENCY_SYMBOLS, CartOperations, CatalogueQueries, CheckoutService as CheckoutOperations, CheckoutService, CimplifyClient, CimplifyElement, CimplifyElements, CimplifyError, DEFAULT_COUNTRY, DEFAULT_CURRENCY, DEVICE_TYPE, ELEMENT_TYPES, EVENT_TYPES, ErrorCode, InventoryService, LINK_MUTATION, LINK_QUERY, LinkService, LiteService, MESSAGE_TYPES, MOBILE_MONEY_PROVIDER, MOBILE_MONEY_PROVIDERS, ORDER_MUTATION, ORDER_TYPE, OrderQueries, PAYMENT_METHOD, PAYMENT_MUTATION, PAYMENT_STATE, PICKUP_TIME_TYPE, QueryBuilder, SchedulingService, categorizePaymentError, combine, combineObject, createCimplifyClient, createElements, detectMobileMoneyProvider, err, extractPriceInfo, flatMap, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatProductPrice, fromPromise, generateIdempotencyKey, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getMarkupPercentage, getOrElse, getProductCurrency, isCimplifyError, isErr, isOk, isOnSale, isRetryableError, mapError, mapResult, normalizePaymentResponse, normalizeStatusResponse, ok, parsePrice, parsePricePath, parsedPriceToPriceInfo, query, toNullable, tryCatch, unwrap };