@salla.sa/embedded-sdk 0.2.5 → 0.2.7

package/dist/esm/index.js

@@ -1,69 +1,69 @@
-const o = "embedded::", C = {
+const u = "embedded::", q = {
   /** Initialize handshake - iframe signals it's ready to receive context */
-  INIT: `${o}iframe.ready`,
+  INIT: `${u}iframe.ready`,
   /** App signals it's fully loaded and ready */
-  READY: `${o}ready`,
+  READY: `${u}ready`,
   /** App requests to be destroyed and navigate away */
-  DESTROY: `${o}destroy`
-}, O = {
+  DESTROY: `${u}destroy`
+}, j = {
   /** Context data provision */
-  PROVIDE: `${o}context.provide`,
+  PROVIDE: `${u}context.provide`,
   /** Theme change notification */
-  THEME_CHANGE: `${o}theme.change`
-}, h = {
+  THEME_CHANGE: `${u}theme.change`
+}, g = {
   /** Set loading state */
-  LOADING: `${o}ui.loading`,
+  LOADING: `${u}ui.loading`,
   /** Set breadcrumbs visibility state */
-  BREADCRUMBS: `${o}ui.breadcrumbs`,
+  BREADCRUMBS: `${u}ui.breadcrumbs`,
   /** Show toast notification */
-  TOAST: `${o}ui.toast`,
+  TOAST: `${u}ui.toast`,
   /** Show confirm dialog (async request) */
-  CONFIRM: `${o}ui.confirm`,
+  CONFIRM: `${u}ui.confirm`,
   /** Confirm dialog response (from host) */
-  CONFIRM_RESPONSE: `${o}ui.confirm.response`
-}, G = {}, V = {
+  CONFIRM_RESPONSE: `${u}ui.confirm.response`
+}, ne = {}, Z = {
   /** Request token refresh (re-renders iframe with new token) */
-  REFRESH: `${o}auth.refresh`
-}, b = {
+  REFRESH: `${u}auth.refresh`
+}, T = {
   /** Navigate using React Router (SPA navigation) */
-  NAVIGATE: `${o}page.navigate`,
+  NAVIGATE: `${u}page.navigate`,
   /** Redirect using window.location (full page reload) */
-  REDIRECT: `${o}page.redirect`,
+  REDIRECT: `${u}page.redirect`,
   /** Set page title */
-  SET_TITLE: `${o}page.setTitle`
-}, l = {
+  SET_TITLE: `${u}page.setTitle`
+}, h = {
   /** Set primary action button in navbar */
-  SET_ACTION: `${o}nav.setAction`,
+  SET_ACTION: `${u}nav.setAction`,
   /** Clear the primary action button */
-  CLEAR_ACTION: `${o}nav.clearAction`,
+  CLEAR_ACTION: `${u}nav.clearAction`,
   /** Notification when action button is clicked (host → iframe) */
-  ACTION_CLICK: `${o}nav.actionClick`,
+  ACTION_CLICK: `${u}nav.actionClick`,
   /** Add one sub-navigation item (iframe → host) */
-  ADD_ITEM: `${o}nav.addItem`,
-  /** Ack with generated opaque id (host → iframe; request response) */
-  ADD_ITEM_RESPONSE: `${o}nav.addItem.response`,
-  UPDATE_ITEM: `${o}nav.updateItem`,
-  REMOVE_ITEM: `${o}nav.removeItem`,
+  ADD_ITEM: `${u}nav.addItem`,
+  /** Ack with `value` and deprecated `id` (same string) (host → iframe; request response) */
+  ADD_ITEM_RESPONSE: `${u}nav.addItem.response`,
+  UPDATE_ITEM: `${u}nav.updateItem`,
+  REMOVE_ITEM: `${u}nav.removeItem`,
   /** Injected sub-nav item clicked (host → iframe) */
-  ITEM_CLICK: `${o}nav.itemClick`
-}, g = {
+  ITEM_CLICK: `${u}nav.itemClick`
+}, v = {
   /** Create checkout flow */
-  CREATE: `${o}checkout.create`,
+  CREATE: `${u}checkout.create`,
   /** Checkout response from host */
-  RESPONSE: `${o}checkout.response`,
+  RESPONSE: `${u}checkout.response`,
   /** Get available addons for the app */
-  GET_ADDONS: `${o}checkout.getAddons`,
+  GET_ADDONS: `${u}checkout.getAddons`,
   /** Get addons response from host */
-  GET_ADDONS_RESPONSE: `${o}checkout.getAddons.response`,
+  GET_ADDONS_RESPONSE: `${u}checkout.getAddons.response`,
   /** Reset checkout cache on host */
-  RESET_CACHE: `${o}checkout.resetCache`
-}, R = G.version || "", K = 1e4, B = [
+  RESET_CACHE: `${u}checkout.resetCache`
+}, M = ne.version || "", se = 1e4, ae = [
   "localhost",
   "merchants.workers.dev",
   "s.salla.sa",
   ".salla.group",
   ".salla.sa"
-], X = /* @__PURE__ */ new Set([
+], oe = /* @__PURE__ */ new Set([
   "ar",
   // Arabic
   "he",
@@ -79,155 +79,155 @@ const o = "embedded::", C = {
   "yi"
   // Yiddish
 ]);
-function W(t) {
+function ue(t) {
   const e = (t ?? "ar").toLowerCase().split(/[-_]/)[0];
-  return X.has(e) ? "rtl" : "ltr";
+  return oe.has(e) ? "rtl" : "ltr";
 }
-let S = {
+let N = {
   showVersion: !0,
   debug: !1
 };
-function Y(t) {
-  S = { ...S, ...t };
+function ce(t) {
+  N = { ...N, ...t };
 }
-function L(t) {
+function H(t) {
   return `%c${t}`;
 }
-function x(t, e = "#fff") {
+function K(t, e = "#fff") {
   return `background-color: ${t}; color: ${e}; padding: 2px 6px; border-radius: 3px; font-weight: 500; font-size: 11px;`;
 }
-function y(t, ...e) {
-  if (t === "debug" && !S.debug)
+function S(t, ...e) {
+  if (t === "debug" && !N.debug)
     return;
   const r = [], i = [];
-  r.push(L("EmbeddedSDK")), i.push(x("#10b981", "#fff")), S.showVersion && (r.push(L(`v${R}`)), i.push(x("#6b7280", "#fff")));
+  r.push(H("EmbeddedSDK")), i.push(K("#10b981", "#fff")), N.showVersion && (r.push(H(`v${M}`)), i.push(K("#6b7280", "#fff")));
   const n = r.join("").trim();
   (console[t] || console.log)(n, ...i, ...e);
 }
-const a = {
+const o = {
   log: (...t) => {
-    y("log", ...t);
+    S("log", ...t);
   },
   warn: (...t) => {
-    y("warn", ...t);
+    S("warn", ...t);
   },
   error: (...t) => {
-    y("error", ...t);
+    S("error", ...t);
   },
   info: (...t) => {
-    y("info", ...t);
+    S("info", ...t);
   },
   debug: (...t) => {
-    y("debug", ...t);
+    S("debug", ...t);
   }
 };
-function Q(t) {
+function de(t) {
   try {
     const r = new URL(t).hostname;
-    return B.some((i) => i.startsWith(".") ? r.endsWith(i) || r === i.slice(1) : r === i || r.startsWith(`${i}:`));
+    return ae.some((i) => i.startsWith(".") ? r.endsWith(i) || r === i.slice(1) : r === i || r.startsWith(`${i}:`));
   } catch {
     return !1;
   }
 }
-function J() {
+function le() {
   return typeof window > "u" || window.parent === window ? null : window.parent;
 }
-function u(t, e, r = "*", i, n) {
-  const s = J();
+function d(t, e, r = "*", i, n) {
+  const s = le();
   if (!s) {
-    a.warn("Not running in an iframe, cannot post to host");
+    o.warn("Not running in an iframe, cannot post to host");
     return;
   }
-  const d = {
+  const a = {
     event: t,
     payload: e || {},
     timestamp: Date.now(),
     source: "embedded-app",
     ...i && { requestId: i },
     metadata: {
-      version: R
+      version: M
     }
   };
-  s.postMessage(d, r);
+  s.postMessage(a, r);
 }
-const p = /* @__PURE__ */ new Map();
-let A = !1;
-function j(t) {
-  if (process.env.NODE_ENV === "production" && !Q(t.origin))
+const b = /* @__PURE__ */ new Map();
+let C = !1;
+function ee(t) {
+  if (process.env.NODE_ENV === "production" && !de(t.origin))
     return;
   const e = t.data;
   if (!e || typeof e.event != "string" || !e.payload || typeof e.timestamp != "number" || !e.source) {
-    a.warn("Invalid message structure received:", e);
+    o.warn("Invalid message structure received:", e);
     return;
   }
-  const r = p.get(e.event);
+  const r = b.get(e.event);
   r && r.forEach((n) => {
     try {
       n(e);
     } catch (s) {
-      a.error("Error in message handler:", s);
+      o.error("Error in message handler:", s);
     }
   });
-  const i = p.get("*");
+  const i = b.get("*");
   i && i.forEach((n) => {
     try {
       n(e);
     } catch (s) {
-      a.error("Error in wildcard handler:", s);
+      o.error("Error in wildcard handler:", s);
     }
   });
 }
-function Z() {
-  A || typeof window > "u" || (window.addEventListener("message", j), A = !0);
+function fe() {
+  C || typeof window > "u" || (window.addEventListener("message", ee), C = !0);
 }
-function m(t, e) {
-  Z(), p.has(t) || p.set(t, /* @__PURE__ */ new Set());
-  const r = p.get(t);
+function y(t, e) {
+  fe(), b.has(t) || b.set(t, /* @__PURE__ */ new Set());
+  const r = b.get(t);
   return r.add(e), () => {
-    r.delete(e), r.size === 0 && p.delete(t);
+    r.delete(e), r.size === 0 && b.delete(t);
   };
 }
-function ee(t, e = K) {
+function he(t, e = se) {
   return new Promise((r, i) => {
     const n = setTimeout(() => {
       s(), i(new Error(`[EmbeddedSDK] Timeout waiting for "${t}" message`));
-    }, e), s = m(t, (d) => {
-      clearTimeout(n), s(), r(d);
+    }, e), s = y(t, (a) => {
+      clearTimeout(n), s(), r(a);
     });
   });
 }
-function te() {
-  p.clear(), A && typeof window < "u" && (window.removeEventListener("message", j), A = !1);
+function me() {
+  b.clear(), C && typeof window < "u" && (window.removeEventListener("message", ee), C = !1);
 }
-function re() {
+function pe() {
   return typeof window > "u" ? !1 : window.parent !== window;
 }
-function ie(t, e, r) {
+function ge(t, e, r) {
   const i = {
     event: t,
     payload: e,
     timestamp: Date.now(),
     source: "merchant-dashboard",
     ...r,
-    metadata: { version: R, synthetic: !0 }
+    metadata: { version: M, synthetic: !0 }
   };
-  p.get(t)?.forEach((s) => {
+  b.get(t)?.forEach((s) => {
     try {
       s(i);
-    } catch (d) {
-      a.error("Error in message handler:", d);
+    } catch (a) {
+      o.error("Error in message handler:", a);
     }
   });
 }
-const E = /* @__PURE__ */ new Map(), ne = 3e4;
-function F() {
+const E = /* @__PURE__ */ new Map(), ve = 3e4;
+function te() {
   const t = Date.now(), e = Math.random().toString(36).slice(2, 9);
   return `req_${t}_${e}`;
 }
-function $(t, e = {}, r = ne) {
-  const i = F();
+function V(t, e = {}, r = ve) {
+  const i = te();
   return new Promise((n, s) => {
-    const d = setTimeout(() => {
+    const a = setTimeout(() => {
       E.get(i) && (E.delete(i), s(
         new Error(
           `[EmbeddedSDK] Request "${t}" timed out after ${r}ms`
@@ -237,27 +237,27 @@ function $(t, e = {}, r = ne) {
     E.set(i, {
       resolve: n,
       reject: s,
-      timeout: d,
+      timeout: a,
       event: t
-    }), u(t, e, "*", i);
+    }), d(t, e, "*", i);
   });
 }
-function D(t, e, r) {
+function $(t, e, r) {
   const i = E.get(t);
   if (!i) {
-    a.warn(`Received response for unknown request: ${t}`);
+    o.warn(`Received response for unknown request: ${t}`);
     return;
   }
-  clearTimeout(i.timeout), E.delete(t), i.resolve(e);
+  clearTimeout(i.timeout), E.delete(t), r ? i.reject(new Error(r)) : i.resolve(e);
 }
-function se(t = "SDK cleanup") {
+function be(t = "SDK cleanup") {
   E.forEach((e, r) => {
     clearTimeout(e.timeout), e.reject(
       new Error(`[EmbeddedSDK] Request ${r} cancelled: ${t}`)
     );
   }), E.clear();
 }
-function w() {
+function R() {
   const t = /* @__PURE__ */ new Set();
   return {
     subscribe(e) {
@@ -270,7 +270,7 @@ function w() {
         try {
           r(...e);
         } catch (i) {
-          a.error("Error in subscription callback:", i);
+          o.error("Error in subscription callback:", i);
         }
       });
     },
@@ -282,40 +282,40 @@ function w() {
     }
   };
 }
-const ae = "https://api.salla.dev";
-class T extends Error {
+const ye = "https://api.salla.dev";
+class A extends Error {
   constructor(e, r, i) {
     super(e), this.status = r, this.response = i, this.name = "ApiError";
   }
 }
-async function oe(t, e = {}) {
-  const { method: r = "GET", headers: i = {}, body: n, timeout: s = 3e4 } = e, d = `${ae}${t}`, N = new AbortController(), M = setTimeout(() => {
-    N.abort();
+async function Ee(t, e = {}) {
+  const { method: r = "GET", headers: i = {}, body: n, timeout: s = 3e4 } = e, a = `${ye}${t}`, l = new AbortController(), f = setTimeout(() => {
+    l.abort();
   }, s);
   try {
-    const c = await fetch(d, {
+    const c = await fetch(a, {
       method: r,
       headers: {
         "Content-Type": "application/json",
         ...i
       },
       body: n ? JSON.stringify(n) : void 0,
-      signal: N.signal
+      signal: l.signal
     });
-    clearTimeout(M);
-    let I;
-    if (c.headers.get("content-type")?.includes("application/json") ? I = await c.json() : I = await c.text(), !c.ok)
-      throw new T(
+    clearTimeout(f);
+    let m;
+    if (c.headers.get("content-type")?.includes("application/json") ? m = await c.json() : m = await c.text(), !c.ok)
+      throw new A(
         `API request failed: ${c.statusText}`,
         c.status,
-        I
+        m
       );
-    return I;
+    return m;
   } catch (c) {
-    throw clearTimeout(M), c instanceof T ? c : c instanceof Error ? c.name === "AbortError" ? new T(`Request timeout after ${s}ms`) : new T(`Request failed: ${c.message}`) : new T("Unknown error occurred");
+    throw clearTimeout(f), c instanceof A ? c : c instanceof Error ? c.name === "AbortError" ? new A(`Request timeout after ${s}ms`) : new A(`Request failed: ${c.message}`) : new A("Unknown error occurred");
   }
 }
-function _(t) {
+function x(t) {
   return {
     isVerified: !1,
     isError: !0,
@@ -323,18 +323,18 @@ function _(t) {
     data: null
   };
 }
-async function ue(t) {
+async function Te(t) {
   const { token: e, appId: r, refreshOnError: i = !0 } = t;
   if (!e) {
     const n = "Token is required. Provide it as a parameter or in URL as ?token=XXX";
-    return a.error("Error in introspect:", n), _(n);
+    return o.error("Error in introspect:", n), x(n);
   }
   if (!r) {
     const n = "App ID is required. Provide it as a parameter or in URL as ?app_id=XXX";
-    return a.error("Error in introspect:", n), _(n);
+    return o.error("Error in introspect:", n), x(n);
   }
   try {
-    const n = await oe(
+    const n = await Ee(
       "/exchange-authority/v1/introspect",
       {
         method: "POST",
@@ -357,12 +357,12 @@ async function ue(t) {
       data: s ? n.data : null
     };
   } catch (n) {
-    i && (H().ui.toast.error(n?.toString() ?? "Introspect error"), u(V.REFRESH, {})), a.error("Error in introspect:", n);
+    i && (ie().ui.toast.error(n?.toString() ?? "Introspect error"), d(Z.REFRESH, {})), o.error("Error in introspect:", n);
     const s = n instanceof Error ? n.message : n;
-    return _(s);
+    return x(s);
   }
 }
-function de(t) {
+function Ie(t) {
   return {
     /**
      * Get the token from the URL query parameter.
@@ -397,7 +397,7 @@ function de(t) {
      * ```
      */
     refresh() {
-      u(V.REFRESH, {});
+      d(Z.REFRESH, {});
     },
     /**
      * Introspect (verify) a short-lived token with Salla's API.
@@ -408,7 +408,7 @@ function de(t) {
      */
     async introspect(e = {}) {
       const r = e.token ?? this.getToken() ?? "", i = e.appId ?? this.getAppId() ?? "";
-      return ue({
+      return Te({
         token: r,
         appId: i,
         refreshOnError: e.refreshOnError
@@ -416,44 +416,50 @@ function de(t) {
     }
   };
 }
-const k = ["success", "error", "warning", "info"];
-function ce(t) {
+const F = ["success", "error", "warning", "info"];
+function Se(t) {
   const e = [];
-  return t.type === void 0 || t.type === null ? e.push("Toast type is required") : (typeof t.type != "string" || !k.includes(t.type)) && e.push(
-    `Invalid toast type "${t.type}". Expected: ${k.join(" | ")}`
+  return t.type === void 0 || t.type === null ? e.push("Toast type is required") : (typeof t.type != "string" || !F.includes(t.type)) && e.push(
+    `Invalid toast type "${t.type}". Expected: ${F.join(" | ")}`
   ), t.message === void 0 || t.message === null ? e.push("Toast message is required") : typeof t.message != "string" ? e.push("Toast message must be a string") : t.message.trim() === "" && e.push("Toast message cannot be empty"), t.duration !== void 0 && t.duration !== null && (typeof t.duration != "number" ? e.push("Toast duration must be a number") : t.duration < 0 && e.push("Toast duration cannot be negative")), { valid: e.length === 0, errors: e };
 }
-function q(t, e) {
+function G(t, e) {
   const r = [];
   return typeof t != "object" || t === null ? (r.push(`${e} must be an object`), r) : ((typeof t.type != "string" || t.type.trim() === "") && r.push(`${e} must have a valid type`), (typeof t.slug != "string" || t.slug.trim() === "") && r.push(`${e} must have a valid slug`), t.quantity !== void 0 && (typeof t.quantity != "number" || t.quantity < 1) && r.push(`${e} must have a quantity >= 1`), r);
 }
-function le(t) {
+const Ae = /^[A-Za-z0-9_-]+$/, B = 64, U = "checkout_id cannot be combined with item or items";
+function we(t) {
+  return typeof t != "string" || t === "" ? ["checkout_id must be a non-empty string"] : t.length > B ? [`checkout_id must be at most ${B} characters`] : Ae.test(t) ? [] : ["checkout_id may only contain letters, numbers, '_' and '-'"];
+}
+function X(t) {
   const e = [];
   if (typeof t != "object" || t === null)
     return e.push("Checkout options must be an object"), { valid: !1, errors: e };
   const r = "item" in t, i = "items" in t;
+  if ("checkout_id" in t)
+    return r || i ? (e.push(U), { valid: !1, errors: e }) : (e.push(...we(t.checkout_id)), { valid: e.length === 0, errors: e });
   if (!r && !i)
     return e.push("Checkout requires either 'item' or 'items'"), { valid: !1, errors: e };
   if (r) {
-    const n = q(
+    const n = G(
       t.item,
       "Item"
     );
     return e.push(...n), { valid: e.length === 0, errors: e };
   }
   return Array.isArray(t.items) ? t.items.length === 0 ? (e.push("At least one item is required"), { valid: !1, errors: e }) : (t.items.forEach((n, s) => {
-    const d = q(
+    const a = G(
       n,
       `Item at index ${s}`
     );
-    e.push(...d);
+    e.push(...a);
   }), { valid: e.length === 0, errors: e }) : (e.push("Checkout items must be an array"), { valid: !1, errors: e });
 }
-function fe(t) {
+function Re(t) {
   const e = [];
   return t.path === void 0 || t.path === null ? e.push("Navigation path is required") : typeof t.path != "string" ? e.push("Navigation path must be a string") : t.path.trim() === "" && e.push("Navigation path cannot be empty"), t.replace !== void 0 && typeof t.replace != "boolean" && e.push("Navigation replace option must be a boolean"), { valid: e.length === 0, errors: e };
 }
-function he(t) {
+function _e(t) {
   const e = [];
   if (t.url === void 0 || t.url === null)
     e.push("Redirect URL is required");
@@ -469,7 +475,7 @@ function he(t) {
     }
   return { valid: e.length === 0, errors: e };
 }
-function pe(t) {
+function Ne(t) {
   const e = [];
   return t.title ? typeof t.title != "string" && e.push("Nav action title must be a string") : e.push("Nav action title is required"), t.value ? typeof t.value != "string" && e.push("Nav action value must be a string") : e.push("Nav action value is required"), t.subTitle !== void 0 && t.subTitle !== null && typeof t.subTitle != "string" && e.push("Nav action subTitle must be a string"), t.icon !== void 0 && t.icon !== null && typeof t.icon != "string" && e.push("Nav action icon must be a string"), t.disabled !== void 0 && t.disabled !== null && typeof t.disabled != "boolean" && e.push("Nav action disabled must be a boolean"), t.extendedActions !== void 0 && t.extendedActions !== null && (Array.isArray(t.extendedActions) ? t.extendedActions.forEach((r, i) => {
     if (typeof r != "object" || r === null) {
@@ -490,75 +496,153 @@ function pe(t) {
     );
   }) : e.push("Nav action extendedActions must be an array")), { valid: e.length === 0, errors: e };
 }
-function me(t) {
-  const e = [];
+const D = 50;
+function _(t, e) {
+  return t ? `${t}.${e}` : e;
+}
+function Ce(t, e) {
+  const r = [];
+  ["title", "value", "url"].forEach((s) => {
+    (typeof t[s] != "string" || !String(t[s]).trim()) && r.push(
+      `Sub-nav addItem "${_(e, s)}" must be non-empty string`
+    );
+  });
+  const i = _(e, "disabled"), n = _(e, "active");
+  return t.disabled !== void 0 && typeof t.disabled != "boolean" && r.push(`Sub-nav addItem "${i}" must be boolean`), t.active !== void 0 && typeof t.active != "boolean" && r.push(`Sub-nav addItem "${n}" must be boolean`), r;
+}
+function z(t, e, r) {
+  if (typeof t != "object" || t === null)
+    return [`Sub-nav addItem "${e || "item"}" must be an object`];
+  const i = t, n = Ce(i, e), s = _(e, "children");
+  return i.children === void 0 ? n : r ? Array.isArray(i.children) ? i.children.length > D ? (n.push(
+    `Sub-nav addItem "${s}" must have at most ${D} items`
+  ), n) : (i.children.forEach((a, l) => {
+    const f = e ? `${e}.children[${l}]` : `children[${l}]`;
+    n.push(...z(a, f, !1));
+  }), n) : (n.push(`Sub-nav addItem "${s}" must be an array`), n) : (Array.isArray(i.children) && i.children.length === 0 || n.push(
+    `Sub-nav addItem "${s}" is not supported on submenu rows (only one dropdown level)`
+  ), n);
+}
+function re(t, e, r, i) {
   if (typeof t != "object" || t === null)
-    return e.push("Nav addItem expects an object item"), { valid: !1, errors: e };
-  const r = t;
-  return ["title", "value", "url"].forEach((i) => {
-    (typeof r[i] != "string" || !String(r[i]).trim()) && e.push(`Sub-nav addItem "${i}" must be non-empty string`);
-  }), r.disabled !== void 0 && typeof r.disabled != "boolean" && e.push('Sub-nav addItem "disabled" must be boolean'), r.active !== void 0 && typeof r.active != "boolean" && e.push('Sub-nav addItem "active" must be boolean'), { valid: e.length === 0, errors: e };
+    return i;
+  const n = t;
+  return typeof n.value == "string" && n.value.trim() && i.push(n.value.trim()), !r || !Array.isArray(n.children) || n.children.forEach((s, a) => {
+    const l = e ? `${e}.children[${a}]` : `children[${a}]`;
+    re(s, l, !1, i);
+  }), i;
+}
+function $e(t) {
+  const e = re(t, "", !0, []), r = /* @__PURE__ */ new Set(), i = [];
+  for (const n of e)
+    r.has(n) && i.push(n), r.add(n);
+  return i.length === 0 ? [] : [
+    `Sub-nav addItem "value" must be globally unique within the item tree (duplicate: ${[...new Set(i)].join(", ")})`
+  ];
 }
-function ge(t) {
+function De(t) {
+  if (typeof t != "object" || t === null)
+    return {
+      valid: !1,
+      errors: ["Nav addItem expects an object item"]
+    };
+  const e = [
+    ...z(t, "", !0),
+    ...$e(t)
+  ];
+  return { valid: e.length === 0, errors: e };
+}
+function Me(t) {
   const e = [];
   if (typeof t != "object" || t === null)
     return e.push("Nav updateItem expects an object item"), { valid: !1, errors: e };
-  const r = t;
-  if (typeof r.id != "string" || !r.id.trim())
-    return e.push('Sub-nav updateItem requires string "id"'), { valid: !1, errors: e };
-  let i = 0;
-  return r.title !== void 0 && i++, r.value !== void 0 && i++, r.url !== void 0 && i++, r.disabled !== void 0 && i++, r.active !== void 0 && i++, i === 0 ? (e.push(
-    "Sub-nav updateItem must include at least one of title, value, url, disabled, active"
-  ), { valid: !1, errors: e }) : (["title", "value", "url"].forEach((n) => {
-    r[n] !== void 0 && (typeof r[n] != "string" || !r[n].trim()) && e.push(`Sub-nav updateItem "${n}" must be non-empty`);
-  }), r.disabled !== void 0 && typeof r.disabled != "boolean" && e.push('Sub-nav updateItem "disabled" must be boolean'), r.active !== void 0 && typeof r.active != "boolean" && e.push('Sub-nav updateItem "active" must be boolean'), { valid: e.length === 0, errors: e });
-}
-function Ee(t) {
+  const r = t, i = typeof r.value == "string" && String(r.value).trim().length > 0, n = typeof r.id == "string" && String(r.id).trim().length > 0, s = i ? String(r.value).trim() : "", a = n ? String(r.id).trim() : "";
+  if (!i && !n)
+    return e.push('Sub-nav updateItem requires non-empty string "value"'), { valid: !1, errors: e };
+  if (i && n && s !== a)
+    return e.push(
+      'Sub-nav updateItem must not specify different "id" and "value"; "value" is the immutable row key and cannot be renamed via patch'
+    ), { valid: !1, errors: e };
+  const l = s || a;
+  let f = 0;
+  if (r.title !== void 0 && f++, r.url !== void 0 && f++, r.disabled !== void 0 && f++, r.active !== void 0 && f++, r.children !== void 0 && f++, f === 0)
+    return e.push(
+      "Sub-nav updateItem must include at least one of title, url, disabled, active, children"
+    ), { valid: !1, errors: e };
+  if (["title", "url"].forEach((c) => {
+    r[c] !== void 0 && (typeof r[c] != "string" || !r[c].trim()) && e.push(`Sub-nav updateItem "${c}" must be non-empty`);
+  }), r.disabled !== void 0 && typeof r.disabled != "boolean" && e.push('Sub-nav updateItem "disabled" must be boolean'), r.active !== void 0 && typeof r.active != "boolean" && e.push('Sub-nav updateItem "active" must be boolean'), r.children !== void 0)
+    if (!Array.isArray(r.children))
+      e.push('Sub-nav updateItem "children" must be an array');
+    else if (r.children.length > D)
+      e.push(
+        `Sub-nav updateItem "children" must have at most ${D} items`
+      );
+    else {
+      const c = /* @__PURE__ */ new Set();
+      r.children.forEach((m, P) => {
+        const O = `children[${P}]`;
+        if (e.push(...z(m, O, !1)), typeof m == "object" && m !== null) {
+          const L = m.value;
+          if (typeof L == "string" && L.trim()) {
+            const k = L.trim();
+            k === l && e.push(
+              `Sub-nav updateItem "${O}.value" must not equal the parent row identifier`
+            ), c.has(k) && e.push(
+              `Sub-nav updateItem "${O}.value" must be unique within children`
+            ), c.add(k);
+          }
+        }
+      });
+    }
+  return { valid: e.length === 0, errors: e };
+}
+function Oe(t) {
   const e = [];
-  return (typeof t != "string" || !t.trim()) && e.push("Nav removeItem id must be non-empty string"), { valid: e.length === 0, errors: e };
+  return (typeof t != "string" || !t.trim()) && e.push("Nav removeItem value must be non-empty string"), { valid: e.length === 0, errors: e };
 }
-const z = ["danger", "warning", "info"];
-function be(t) {
+const W = ["danger", "warning", "info"];
+function Le(t) {
   const e = [];
-  return t.title === void 0 || t.title === null ? e.push("Confirm dialog title is required") : typeof t.title != "string" ? e.push("Confirm dialog title must be a string") : t.title.trim() === "" && e.push("Confirm dialog title cannot be empty"), t.message === void 0 || t.message === null ? e.push("Confirm dialog message is required") : typeof t.message != "string" ? e.push("Confirm dialog message must be a string") : t.message.trim() === "" && e.push("Confirm dialog message cannot be empty"), t.confirmText !== void 0 && t.confirmText !== null && typeof t.confirmText != "string" && e.push("Confirm dialog confirmText must be a string"), t.cancelText !== void 0 && t.cancelText !== null && typeof t.cancelText != "string" && e.push("Confirm dialog cancelText must be a string"), t.variant !== void 0 && t.variant !== null && (typeof t.variant != "string" || !z.includes(t.variant)) && e.push(
-    `Invalid confirm variant "${t.variant}". Expected: ${z.join(" | ")}`
+  return t.title === void 0 || t.title === null ? e.push("Confirm dialog title is required") : typeof t.title != "string" ? e.push("Confirm dialog title must be a string") : t.title.trim() === "" && e.push("Confirm dialog title cannot be empty"), t.message === void 0 || t.message === null ? e.push("Confirm dialog message is required") : typeof t.message != "string" ? e.push("Confirm dialog message must be a string") : t.message.trim() === "" && e.push("Confirm dialog message cannot be empty"), t.confirmText !== void 0 && t.confirmText !== null && typeof t.confirmText != "string" && e.push("Confirm dialog confirmText must be a string"), t.cancelText !== void 0 && t.cancelText !== null && typeof t.cancelText != "string" && e.push("Confirm dialog cancelText must be a string"), t.variant !== void 0 && t.variant !== null && (typeof t.variant != "string" || !W.includes(t.variant)) && e.push(
+    `Invalid confirm variant "${t.variant}". Expected: ${W.join(" | ")}`
   ), { valid: e.length === 0, errors: e };
 }
-function f(t, e) {
-  a.error(
+function p(t, e) {
+  o.error(
     `Validation failed for ${t}:
 ` + e.map((r) => `  • ${r}`).join(`
 `)
   );
 }
-function ve() {
+function ke() {
   return { resize: (i) => {
   }, autoResize: () => {
   }, stopAutoResize: () => {
   } };
 }
-function ye() {
-  const { resize: t, autoResize: e, stopAutoResize: r } = ve();
+function qe() {
+  const { resize: t, autoResize: e, stopAutoResize: r } = ke();
   return {
     navigate(i, n) {
-      const s = fe({ path: i, ...n });
+      const s = Re({ path: i, ...n });
       if (!s.valid) {
-        f(b.NAVIGATE, s.errors);
+        p(T.NAVIGATE, s.errors);
         return;
       }
-      u(b.NAVIGATE, {
+      d(T.NAVIGATE, {
         path: i,
         state: n?.state,
         replace: n?.replace
       });
     },
     redirect(i) {
-      const n = he({ url: i });
+      const n = _e({ url: i });
       if (!n.valid) {
-        f(b.REDIRECT, n.errors);
+        p(T.REDIRECT, n.errors);
         return;
       }
-      u(b.REDIRECT, { url: i });
+      d(T.REDIRECT, { url: i });
     },
     navTo(i, n) {
       if (i.startsWith("http://") || i.startsWith("https://")) {
@@ -569,41 +653,67 @@ function ye() {
     },
     setTitle(i) {
       if (typeof i != "string" || !i.trim()) {
-        f(b.SET_TITLE, [
+        p(T.SET_TITLE, [
           "Title must be a non-empty string"
         ]);
         return;
       }
-      u(b.SET_TITLE, { title: i });
+      d(T.SET_TITLE, { title: i });
     },
     resize: t,
     autoResize: e,
     stopAutoResize: r
   };
 }
-function Te() {
-  const t = w(), e = w(), r = [];
+function xe() {
+  const t = R(), e = R(), r = [];
   return r.push(
-    m(l.ACTION_CLICK, (i) => {
+    y(h.ACTION_CLICK, (i) => {
       t.notify(i.payload.value);
     })
   ), r.push(
-    m(l.ADD_ITEM_RESPONSE, (i) => {
-      const n = i.payload.item;
-      i.requestId && n && typeof n.id == "string" && typeof n.value == "string" && D(i.requestId, n);
+    y(h.ADD_ITEM_RESPONSE, (i) => {
+      if (!i.requestId) return;
+      const n = i.payload;
+      if (typeof n.error == "string" && n.error.trim()) {
+        const a = n.error.trim();
+        o.warn(`embedded::nav.addItem failed: ${a}`), $(
+          i.requestId,
+          {},
+          a
+        );
+        return;
+      }
+      const s = n.item;
+      if (s && typeof s.value == "string" && s.value.trim()) {
+        const a = s.value.trim(), l = {
+          value: a,
+          id: a
+        };
+        $(i.requestId, l);
+      }
     })
   ), r.push(
-    m(l.ITEM_CLICK, (i) => {
-      e.notify(i.payload);
+    y(h.ITEM_CLICK, (i) => {
+      const n = i.payload, s = typeof n.value == "string" && n.value.trim() ? n.value.trim() : typeof n.id == "string" && n.id.trim() ? n.id.trim() : "";
+      if (!s) {
+        e.notify(n);
+        return;
+      }
+      e.notify({
+        ...n,
+        value: s,
+        id: s
+      });
     })
   ), {
     setAction(i) {
-      const n = pe(i);
+      const n = Ne(i);
       if (!n.valid) {
-        f(l.SET_ACTION, n.errors);
+        p(h.SET_ACTION, n.errors);
         return;
       }
-      u(l.SET_ACTION, {
+      d(h.SET_ACTION, {
         title: i.title,
         value: i.value,
         subTitle: i.subTitle,
@@ -619,30 +729,33 @@ function Te() {
       });
     },
     clearAction() {
-      u(l.CLEAR_ACTION, {});
+      d(h.CLEAR_ACTION, {});
     },
     onActionClick(i) {
       return t.subscribe(i);
     },
     addNavItem(i) {
-      const n = me(i);
-      return n.valid ? $(l.ADD_ITEM, { item: i }, 2e3) : (f(l.ADD_ITEM, n.errors), Promise.reject(new Error(n.errors[0])));
+      const n = De(i);
+      return n.valid ? V(h.ADD_ITEM, { item: i }, 2e3) : (p(h.ADD_ITEM, n.errors), Promise.reject(new Error(n.errors[0])));
     },
     updateNavItem(i) {
-      const n = ge(i);
+      const n = Me(i);
       if (!n.valid) {
-        f(l.UPDATE_ITEM, n.errors);
+        p(h.UPDATE_ITEM, n.errors);
         return;
       }
-      u(l.UPDATE_ITEM, { item: i });
+      const s = i, a = typeof s.value == "string" ? s.value.trim() : "", l = typeof s.id == "string" ? s.id.trim() : "", f = a || l, { id: c, ...m } = s;
+      d(h.UPDATE_ITEM, {
+        item: { ...m, value: f }
+      });
     },
     removeNavItem(i) {
-      const n = Ee(i);
+      const n = Oe(i);
       if (!n.valid) {
-        f(l.REMOVE_ITEM, n.errors);
+        p(h.REMOVE_ITEM, n.errors);
         return;
       }
-      u(l.REMOVE_ITEM, { id: i });
+      d(h.REMOVE_ITEM, { value: i });
     },
     onNavItemClick(i) {
       return e.subscribe(i);
@@ -652,40 +765,40 @@ function Te() {
     }
   };
 }
-function we() {
+function Ue() {
   return {
     /**
      * Show loading indicator.
      */
     show() {
-      u(h.LOADING, { action: "show" });
+      d(g.LOADING, { action: "show" });
     },
     /**
      * Hide loading indicator.
      */
     hide() {
-      u(h.LOADING, { action: "hide" });
+      d(g.LOADING, { action: "hide" });
     }
   };
 }
-function Ie() {
+function Ve() {
   return {
     hide() {
-      u(h.BREADCRUMBS, { action: "hide" });
+      d(g.BREADCRUMBS, { action: "hide" });
     },
     show() {
-      u(h.BREADCRUMBS, { action: "show" });
+      d(g.BREADCRUMBS, { action: "show" });
     }
   };
 }
-function Se() {
+function ze() {
   const t = (e) => {
-    const r = ce(e);
+    const r = Se(e);
     if (!r.valid) {
-      f(h.TOAST, r.errors);
+      p(g.TOAST, r.errors);
       return;
     }
-    u(h.TOAST, {
+    d(g.TOAST, {
       type: e.type,
       message: e.message,
       duration: e.duration
@@ -722,43 +835,53 @@ function Se() {
     }
   };
 }
-function Ae() {
+function Pe() {
   return async (t) => {
-    const e = be(t);
-    return e.valid ? $(h.CONFIRM, {
+    const e = Le(t);
+    return e.valid ? V(g.CONFIRM, {
       title: t.title,
       message: t.message,
       confirmText: t.confirmText ?? "Confirm",
       cancelText: t.cancelText ?? "Cancel",
       variant: t.variant ?? "info"
-    }) : (f(h.CONFIRM, e.errors), Promise.reject(new Error(e.errors.join(", "))));
+    }) : (p(g.CONFIRM, e.errors), Promise.reject(new Error(e.errors.join(", "))));
   };
 }
-function Re() {
+function je() {
   return {
-    loading: we(),
-    breadcrumbs: Ie(),
-    toast: Se(),
-    confirm: Ae()
+    loading: Ue(),
+    breadcrumbs: Ve(),
+    toast: ze(),
+    confirm: Pe()
   };
 }
-function Ne() {
-  const t = w(), e = [];
+const He = "INVALID_CHECKOUT_INPUT";
+function w(t) {
+  const e = new Error(t);
+  return e.code = He, e;
+}
+const Ke = ["type", "slug", "quantity"];
+function Y(t) {
+  return typeof t == "object" && t !== null && !Array.isArray(t) && "checkout_id" in t && t.checkout_id !== void 0;
+}
+function Fe() {
+  const t = R(), e = [];
   return e.push(
-    m(g.RESPONSE, (r) => {
+    y(v.RESPONSE, (r) => {
       t.notify({
         success: r.payload.success,
         order_id: r.payload.order_id,
+        checkout_id: r.payload.checkout_id,
         status: r.payload.status,
         error: r.payload.error,
         context: r.payload.context
       });
     })
   ), e.push(
-    m(
-      g.GET_ADDONS_RESPONSE,
+    y(
+      v.GET_ADDONS_RESPONSE,
       (r) => {
-        r.requestId && D(r.requestId, {
+        r.requestId && $(r.requestId, {
           success: r.payload.success,
           addons: r.payload.addons,
           error: r.payload.error
@@ -767,21 +890,42 @@ function Ne() {
     )
   ), {
     create(r, i) {
-      const n = Array.isArray(r) ? r : [r], s = le({ items: n });
-      if (!s.valid)
-        throw f(g.CREATE, s.errors), new Error(s.errors[0]);
-      u(
-        g.CREATE,
+      if (Array.isArray(r) && r.some((s) => Y(s)))
+        throw w(U);
+      let n;
+      if (Y(r)) {
+        if ("context" in r)
+          throw w(
+            "context must be passed as the second argument (config.context)"
+          );
+        if (Ke.some((a) => a in r))
+          throw w(U);
+        const s = X(
+          r
+        );
+        if (!s.valid)
+          throw p(v.CREATE, s.errors), w(s.errors[0]);
+        n = { checkout_id: r.checkout_id };
+      } else {
+        const s = Array.isArray(r) ? r : [r], a = X({ items: s });
+        if (!a.valid)
+          throw p(v.CREATE, a.errors), w(a.errors[0]);
+        n = {
+          items: s.map((l) => ({
+            type: l.type,
+            slug: l.slug,
+            quantity: l.quantity ?? 1
+          }))
+        };
+      }
+      d(
+        v.CREATE,
         {
-          items: n.map((d) => ({
-            type: d.type,
-            slug: d.slug,
-            quantity: d.quantity ?? 1
-          })),
+          ...n,
           ...i?.context !== void 0 && { context: i.context }
         },
         "*",
-        F()
+        te()
       );
     },
     onResult(r) {
@@ -789,8 +933,8 @@ function Ne() {
     },
     async getAddons() {
       try {
-        return await $(
-          g.GET_ADDONS,
+        return await V(
+          v.GET_ADDONS,
           {},
           3e4
         );
@@ -805,28 +949,29 @@ function Ne() {
       }
     },
     resetCache() {
-      u(g.RESET_CACHE, {}, "*");
+      d(v.RESET_CACHE, {}, "*");
     },
     destroy() {
       e.forEach((r) => r()), e.length = 0, t.clear();
     }
   };
 }
-const P = {
+const Q = {
   theme: "light",
   dir: "rtl",
   width: 0,
   locale: "ar",
   currency: "SAR"
 };
-class Ce {
+class Ge {
   constructor() {
-    this.initialized = !1, this.initializing = !1, this.debugMode = !1, this.appReady = !1, this.layout = { ...P }, this.postInitHooks = [], this.themeSubscription = w(), this.initSubscription = w(), this.auth = de(), this.page = ye(), this.nav = Te(), this.ui = Re(), this.checkout = Ne(), this.registerPostInitHook((e) => {
+    this.initialized = !1, this.initializing = !1, this.debugMode = !1, this.appReady = !1, this.layout = { ...Q }, this.postInitHooks = [], this.themeSubscription = R(), this.initSubscription = R(), this.auth = Ie(), this.page = qe(), this.nav = xe(), this.ui = je(), this.checkout = Fe(), this.registerPostInitHook((e) => {
       const r = e.payload.pendingCheckoutResult;
-      r && (a.debug("Dispatching pending checkout result:", r), queueMicrotask(() => {
-        ie(g.RESPONSE, {
+      r && (o.debug("Dispatching pending checkout result:", r), queueMicrotask(() => {
+        ge(v.RESPONSE, {
           success: r.success,
           status: r.status,
+          checkout_id: r.checkout_id,
           error: r.error,
           context: r.context
         });
@@ -844,10 +989,10 @@ class Ce {
    * Set up core event listeners.
    */
   setupListeners() {
-    m(O.THEME_CHANGE, (e) => {
-      this.layout.theme = e.payload.theme, a.debug("Theme changed:", e.payload.theme), this.themeSubscription.notify(e.payload.theme);
-    }), m(h.CONFIRM_RESPONSE, (e) => {
-      a.debug("Received confirm response:", e), e.requestId && D(e.requestId, { confirmed: e.payload.confirmed });
+    y(j.THEME_CHANGE, (e) => {
+      this.layout.theme = e.payload.theme, o.debug("Theme changed:", e.payload.theme), this.themeSubscription.notify(e.payload.theme);
+    }), y(g.CONFIRM_RESPONSE, (e) => {
+      o.debug("Received confirm response:", e), e.requestId && $(e.requestId, { confirmed: e.payload.confirmed });
     });
   }
   /**
@@ -880,7 +1025,7 @@ class Ce {
       try {
         e(this.getState());
       } catch (r) {
-        a.error("Error in init callback:", r);
+        o.error("Error in init callback:", r);
       }
     return this.initSubscription.subscribe(e);
   }
@@ -889,40 +1034,40 @@ class Ce {
    */
   ready() {
     if (this.appReady) {
-      a.debug("App already signaled as ready");
+      o.debug("App already signaled as ready");
       return;
     }
     if (!this.initialized) {
-      a.warn("Cannot signal ready before init() is called");
+      o.warn("Cannot signal ready before init() is called");
       return;
     }
-    this.appReady = !0, u(C.READY, {}), a.debug("Sent ready signal to host");
+    this.appReady = !0, d(q.READY, {}), o.debug("Sent ready signal to host");
   }
   /**
    * Initialize the SDK and establish connection with the host.
    */
   async init(e = {}) {
     if (this.initialized)
-      return a.debug("Already initialized, returning current layout"), { layout: { ...this.layout } };
+      return o.debug("Already initialized, returning current layout"), { layout: { ...this.layout } };
     if (this.initializing)
-      return a.warn("Initialization already in progress"), new Promise((r) => {
+      return o.warn("Initialization already in progress"), new Promise((r) => {
         const i = this.onInit((n) => {
           i(), r({ layout: { ...n.layout } });
         });
       });
-    this.initializing = !0, this.debugMode = e.debug ?? !1, Y({ debug: this.debugMode }), re() || a.warn("Not running in an iframe. Some features may not work."), a.debug("Initializing SDK...");
+    this.initializing = !0, this.debugMode = e.debug ?? !1, ce({ debug: this.debugMode }), pe() || o.warn("Not running in an iframe. Some features may not work."), o.debug("Initializing SDK...");
     try {
-      u(C.INIT, {
+      d(q.INIT, {
         height: document.documentElement.scrollHeight
-      }), a.debug("Sent iframe.ready message, waiting for context...");
-      const r = await ee(
-        O.PROVIDE
+      }), o.debug("Sent iframe.ready message, waiting for context...");
+      const r = await he(
+        j.PROVIDE
       );
-      a.debug("Received context from host:", r);
+      o.debug("Received context from host:", r);
       const { layout: i } = r.payload;
       return this.layout = {
         theme: i?.theme ?? "light",
-        dir: i?.dir ?? W(i?.locale),
+        dir: i?.dir ?? ue(i?.locale),
         width: i?.width ?? 0,
         locale: i?.locale ?? "ar",
         currency: i?.currency ?? "SAR"
@@ -930,9 +1075,9 @@ class Ce {
         try {
           n(r);
         } catch (s) {
-          a.error("Error in post-init hook:", s);
+          o.error("Error in post-init hook:", s);
         }
-      }), this.initialized = !0, this.initializing = !1, a.debug("Initialization complete. Layout:", this.layout), this.initSubscription.notify(this.getState()), { layout: { ...this.layout } };
+      }), this.initialized = !0, this.initializing = !1, o.debug("Initialization complete. Layout:", this.layout), this.initSubscription.notify(this.getState()), { layout: { ...this.layout } };
     } catch (r) {
       throw this.initializing = !1, r;
     }
@@ -941,23 +1086,24 @@ class Ce {
    * Destroy the SDK instance and clean up resources.
    */
   destroy() {
-    a.debug("Destroying SDK instance"), this.initialized && (u(C.DESTROY, {}), a.debug("Sent destroy event to host")), this.checkout.destroy(), this.nav.destroy(), se("SDK destroyed"), te(), this.themeSubscription.clear(), this.initSubscription.clear(), this.postInitHooks = [], this.initialized = !1, this.initializing = !1, this.appReady = !1, this.layout = { ...P };
+    o.debug("Destroying SDK instance"), this.initialized && (d(q.DESTROY, {}), o.debug("Sent destroy event to host")), this.checkout.destroy(), this.nav.destroy(), be("SDK destroyed"), me(), this.themeSubscription.clear(), this.initSubscription.clear(), this.postInitHooks = [], this.initialized = !1, this.initializing = !1, this.appReady = !1, this.layout = { ...Q };
   }
 }
-let v = null;
-function H() {
-  return v || (v = new Ce()), v;
+let I = null;
+function ie() {
+  return I || (I = new Ge()), I;
 }
-function $e() {
-  v && (v.destroy(), v = null);
+function Be() {
+  I && (I.destroy(), I = null);
 }
-const U = H(), De = R;
-typeof window < "u" && (window.salla = window.salla || window.Salla || {}, window.Salla = window.salla, window.salla.embedded || (window.salla.embedded = U), window.Salla.embedded || (window.Salla.embedded = U));
+const J = ie(), Xe = M;
+typeof window < "u" && (window.salla = window.salla || window.Salla || {}, window.Salla = window.salla, window.salla.embedded || (window.salla.embedded = J), window.Salla.embedded || (window.Salla.embedded = J));
 export {
-  Ce as EmbeddedApp,
-  U as embedded,
-  H as getEmbeddedApp,
-  $e as resetEmbeddedApp,
-  De as version
+  Ge as EmbeddedApp,
+  He as INVALID_CHECKOUT_INPUT,
+  J as embedded,
+  ie as getEmbeddedApp,
+  Be as resetEmbeddedApp,
+  Xe as version
 };
 //# sourceMappingURL=index.js.map