@cimplify/sdk 0.3.5 → 0.4.0

package/dist/index.js

@@ -155,9 +155,6 @@ var CatalogueQueries = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // PRODUCTS
-  // --------------------------------------------------------------------------
   async getProducts(options) {
     let query2 = "products";
     const filters = [];
@@ -206,9 +203,6 @@ var CatalogueQueries = class {
     }
     return ok(result.value[0]);
   }
-  // --------------------------------------------------------------------------
-  // VARIANTS
-  // --------------------------------------------------------------------------
   async getVariants(productId) {
     return safe(this.client.query(`products.${productId}.variants`));
   }
@@ -232,15 +226,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"));
   }
@@ -260,9 +248,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"));
   }
@@ -287,9 +272,6 @@ var CatalogueQueries = class {
       this.client.query(`collections[?(@.name contains '${query2}')]#limit(${limit})`)
     );
   }
-  // --------------------------------------------------------------------------
-  // BUNDLES
-  // --------------------------------------------------------------------------
   async getBundles() {
     return safe(this.client.query("bundles"));
   }
@@ -311,9 +293,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) {
@@ -336,9 +315,6 @@ var CatalogueQueries = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // SEARCH
-  // --------------------------------------------------------------------------
   async search(query2, options) {
     const limit = options?.limit ?? 20;
     let searchQuery = `products[?(@.name contains '${query2}')]`;
@@ -357,9 +333,6 @@ var CatalogueQueries = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // MENU (Restaurant-specific)
-  // --------------------------------------------------------------------------
   async getMenu(options) {
     let query2 = "menu";
     if (options?.category) {
@@ -397,13 +370,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"));
   }
@@ -433,33 +399,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));
   }
@@ -489,9 +428,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", {
@@ -502,9 +438,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;
@@ -588,6 +521,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",
@@ -657,35 +599,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,
@@ -803,9 +716,6 @@ var LinkService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // AUTHENTICATION
-  // --------------------------------------------------------------------------
   async requestOtp(input) {
     return safe5(this.client.linkPost("/v1/link/auth/request-otp", input));
   }
@@ -825,9 +735,6 @@ var LinkService = class {
     }
     return result;
   }
-  // --------------------------------------------------------------------------
-  // STATUS & DATA
-  // --------------------------------------------------------------------------
   async checkStatus(contact) {
     return safe5(
       this.client.call(LINK_MUTATION.CHECK_STATUS, {
@@ -847,9 +754,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));
   }
@@ -858,15 +762,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));
   }
@@ -886,9 +784,6 @@ var LinkService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // MOBILE MONEY
-  // --------------------------------------------------------------------------
   async createMobileMoney(input) {
     return safe5(this.client.call(LINK_MUTATION.CREATE_MOBILE_MONEY, input));
   }
@@ -912,9 +807,6 @@ var LinkService = class {
       this.client.call(LINK_MUTATION.VERIFY_MOBILE_MONEY, mobileMoneyId)
     );
   }
-  // --------------------------------------------------------------------------
-  // SESSIONS
-  // --------------------------------------------------------------------------
   async getSessions() {
     return safe5(this.client.linkGet("/v1/link/sessions"));
   }
@@ -924,9 +816,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"));
   }
@@ -974,9 +863,6 @@ var AuthService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // STATUS & USER
-  // --------------------------------------------------------------------------
   async getStatus() {
     return safe6(this.client.query("auth"));
   }
@@ -990,9 +876,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, {
@@ -1009,15 +892,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));
   }
@@ -1048,9 +925,6 @@ var BusinessService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // BUSINESS INFO
-  // --------------------------------------------------------------------------
   async getInfo() {
     return safe7(this.client.query("business.info"));
   }
@@ -1066,27 +940,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(),
@@ -1131,9 +996,6 @@ var InventoryService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // STOCK QUERIES
-  // --------------------------------------------------------------------------
   async getStockLevels() {
     return safe8(this.client.query("inventory.stock_levels"));
   }
@@ -1160,9 +1022,6 @@ var InventoryService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // AVAILABILITY CHECKS
-  // --------------------------------------------------------------------------
   async checkProductAvailability(productId, quantity, locationId) {
     return safe8(
       this.client.query("inventory.check_availability", {
@@ -1192,15 +1051,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;
@@ -1232,9 +1085,6 @@ var SchedulingService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // SERVICES
-  // --------------------------------------------------------------------------
   async getServices() {
     return safe9(this.client.query("scheduling.services"));
   }
@@ -1247,9 +1097,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(
@@ -1274,9 +1121,6 @@ var SchedulingService = class {
       )
     );
   }
-  // --------------------------------------------------------------------------
-  // BOOKINGS
-  // --------------------------------------------------------------------------
   async getBooking(bookingId) {
     return safe9(this.client.query(`scheduling.${bookingId}`));
   }
@@ -1297,18 +1141,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({
@@ -1347,15 +1185,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}`));
   }
@@ -1367,9 +1199,6 @@ var LiteService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // KITCHEN ORDERS
-  // --------------------------------------------------------------------------
   async sendToKitchen(tableId, items) {
     return safe10(
       this.client.call("lite.send_to_kitchen", {
@@ -1393,9 +1222,6 @@ var LiteService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // MENU (optimized for lite/QR experience)
-  // --------------------------------------------------------------------------
   async getMenu() {
     return safe10(this.client.query("lite.menu"));
   }
@@ -1404,6 +1230,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";
@@ -1469,7 +1586,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();
@@ -1543,10 +1659,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, "");
@@ -1631,18 +1743,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) {
@@ -1654,10 +1757,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) {
@@ -1675,9 +1774,6 @@ var CimplifyClient = class {
       return this.handleResponse(response);
     });
   }
-  /**
-   * Execute a mutation. NOT deduplicated - mutations have side effects.
-   */
   async call(method, args) {
     const body = {
       method,
@@ -1836,6 +1932,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);
@@ -2399,21 +2512,28 @@ exports.BusinessService = BusinessService;
 exports.CHECKOUT_MODE = CHECKOUT_MODE;
 exports.CHECKOUT_MUTATION = CHECKOUT_MUTATION;
 exports.CHECKOUT_STEP = CHECKOUT_STEP;
+exports.CONTACT_TYPE = CONTACT_TYPE;
 exports.CURRENCY_SYMBOLS = CURRENCY_SYMBOLS;
 exports.CartOperations = CartOperations;
 exports.CatalogueQueries = CatalogueQueries;
 exports.CheckoutOperations = CheckoutService;
 exports.CheckoutService = CheckoutService;
 exports.CimplifyClient = CimplifyClient;
+exports.CimplifyElement = CimplifyElement;
+exports.CimplifyElements = CimplifyElements;
 exports.CimplifyError = CimplifyError;
 exports.DEFAULT_COUNTRY = DEFAULT_COUNTRY;
 exports.DEFAULT_CURRENCY = DEFAULT_CURRENCY;
+exports.DEVICE_TYPE = DEVICE_TYPE;
+exports.ELEMENT_TYPES = ELEMENT_TYPES;
+exports.EVENT_TYPES = EVENT_TYPES;
 exports.ErrorCode = ErrorCode;
 exports.InventoryService = InventoryService;
 exports.LINK_MUTATION = LINK_MUTATION;
 exports.LINK_QUERY = LINK_QUERY;
 exports.LinkService = LinkService;
 exports.LiteService = LiteService;
+exports.MESSAGE_TYPES = MESSAGE_TYPES;
 exports.MOBILE_MONEY_PROVIDER = MOBILE_MONEY_PROVIDER;
 exports.MOBILE_MONEY_PROVIDERS = MOBILE_MONEY_PROVIDERS;
 exports.ORDER_MUTATION = ORDER_MUTATION;
@@ -2429,6 +2549,7 @@ exports.categorizePaymentError = categorizePaymentError;
 exports.combine = combine;
 exports.combineObject = combineObject;
 exports.createCimplifyClient = createCimplifyClient;
+exports.createElements = createElements;
 exports.detectMobileMoneyProvider = detectMobileMoneyProvider;
 exports.err = err;
 exports.extractPriceInfo = extractPriceInfo;