@salla.sa/embedded-sdk 0.2.4 → 0.2.6

package/dist/esm/index.js

@@ -1,232 +1,263 @@
-const o = "embedded::", $ = {
+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`
-}, x = {
+  DESTROY: `${u}destroy`
+}, U = {
   /** Context data provision */
-  PROVIDE: `${o}context.provide`,
+  PROVIDE: `${u}context.provide`,
   /** Theme change notification */
-  THEME_CHANGE: `${o}theme.change`
+  THEME_CHANGE: `${u}theme.change`
 }, g = {
   /** Set loading state */
-  LOADING: `${o}ui.loading`,
+  LOADING: `${u}ui.loading`,
+  /** Set breadcrumbs visibility state */
+  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`
-}, K = {}, U = {
+  CONFIRM_RESPONSE: `${u}ui.confirm.response`
+}, Z = {}, X = {
   /** Request token refresh (re-renders iframe with new token) */
-  REFRESH: `${o}auth.refresh`
-}, p = {
+  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`
-}, w = {
+  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`
-}, m = {
+  ACTION_CLICK: `${u}nav.actionClick`,
+  /** Add one sub-navigation item (iframe → host) */
+  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: `${u}nav.itemClick`
+}, y = {
   /** 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`
-}, I = K.version || "", X = 1e4, W = [
+  GET_ADDONS_RESPONSE: `${u}checkout.getAddons.response`,
+  /** Reset checkout cache on host */
+  RESET_CACHE: `${u}checkout.resetCache`
+}, D = Z.version || "", ee = 1e4, te = [
   "localhost",
   "merchants.workers.dev",
   "s.salla.sa",
   ".salla.group",
   ".salla.sa"
-];
-let S = {
+], re = /* @__PURE__ */ new Set([
+  "ar",
+  // Arabic
+  "he",
+  // Hebrew
+  "fa",
+  // Persian / Farsi
+  "ur",
+  // Urdu
+  "ps",
+  // Pashto
+  "sd",
+  // Sindhi
+  "yi"
+  // Yiddish
+]);
+function ie(t) {
+  const e = (t ?? "ar").toLowerCase().split(/[-_]/)[0];
+  return re.has(e) ? "rtl" : "ltr";
+}
+let N = {
   showVersion: !0,
   debug: !1
 };
-function Y(t) {
-  S = { ...S, ...t };
+function ne(t) {
+  N = { ...N, ...t };
 }
-function D(t) {
+function P(t) {
   return `%c${t}`;
 }
-function L(t, e = "#fff") {
+function j(t, e = "#fff") {
   return `background-color: ${t}; color: ${e}; padding: 2px 6px; border-radius: 3px; font-weight: 500; font-size: 11px;`;
 }
-function b(t, ...e) {
-  if (t === "debug" && !S.debug)
+function S(t, ...e) {
+  if (t === "debug" && !N.debug)
     return;
   const r = [], i = [];
-  r.push(D("EmbeddedSDK")), i.push(L("#10b981", "#fff")), S.showVersion && (r.push(D(`v${I}`)), i.push(L("#6b7280", "#fff")));
+  r.push(P("EmbeddedSDK")), i.push(j("#10b981", "#fff")), N.showVersion && (r.push(P(`v${D}`)), i.push(j("#6b7280", "#fff")));
   const n = r.join("").trim();
   (console[t] || console.log)(n, ...i, ...e);
 }
-const a = {
+const o = {
   log: (...t) => {
-    b("log", ...t);
+    S("log", ...t);
   },
   warn: (...t) => {
-    b("warn", ...t);
+    S("warn", ...t);
   },
   error: (...t) => {
-    b("error", ...t);
+    S("error", ...t);
   },
   info: (...t) => {
-    b("info", ...t);
+    S("info", ...t);
   },
   debug: (...t) => {
-    b("debug", ...t);
+    S("debug", ...t);
   }
 };
-function B(t) {
+function se(t) {
   try {
     const r = new URL(t).hostname;
-    return W.some((i) => i.startsWith(".") ? r.endsWith(i) || r === i.slice(1) : r === i || r.startsWith(`${i}:`));
+    return te.some((i) => i.startsWith(".") ? r.endsWith(i) || r === i.slice(1) : r === i || r.startsWith(`${i}:`));
   } catch {
     return !1;
   }
 }
-function Q() {
+function ae() {
   return typeof window > "u" || window.parent === window ? null : window.parent;
 }
 function c(t, e, r = "*", i, n) {
-  const s = Q();
+  const s = ae();
   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 u = {
+  const a = {
     event: t,
     payload: e || {},
     timestamp: Date.now(),
     source: "embedded-app",
     ...i && { requestId: i },
     metadata: {
-      version: I
+      version: D
     }
   };
-  s.postMessage(u, r);
+  s.postMessage(a, r);
 }
-const l = /* @__PURE__ */ new Map();
-let A = !1;
-function V(t) {
-  if (process.env.NODE_ENV === "production" && !B(t.origin))
+const v = /* @__PURE__ */ new Map();
+let $ = !1;
+function W(t) {
+  if (process.env.NODE_ENV === "production" && !se(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 = l.get(e.event);
+  const r = v.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 = l.get("*");
+  const i = v.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 J() {
-  A || typeof window > "u" || (window.addEventListener("message", V), A = !0);
+function oe() {
+  $ || typeof window > "u" || (window.addEventListener("message", W), $ = !0);
 }
-function y(t, e) {
-  J(), l.has(t) || l.set(t, /* @__PURE__ */ new Set());
-  const r = l.get(t);
+function b(t, e) {
+  oe(), v.has(t) || v.set(t, /* @__PURE__ */ new Set());
+  const r = v.get(t);
   return r.add(e), () => {
-    r.delete(e), r.size === 0 && l.delete(t);
+    r.delete(e), r.size === 0 && v.delete(t);
   };
 }
-function Z(t, e = X) {
+function ue(t, e = ee) {
   return new Promise((r, i) => {
     const n = setTimeout(() => {
       s(), i(new Error(`[EmbeddedSDK] Timeout waiting for "${t}" message`));
-    }, e), s = y(t, (u) => {
-      clearTimeout(n), s(), r(u);
+    }, e), s = b(t, (a) => {
+      clearTimeout(n), s(), r(a);
     });
   });
 }
-function ee() {
-  l.clear(), A && typeof window < "u" && (window.removeEventListener("message", V), A = !1);
+function de() {
+  v.clear(), $ && typeof window < "u" && (window.removeEventListener("message", W), $ = !1);
 }
-function te() {
+function ce() {
   return typeof window > "u" ? !1 : window.parent !== window;
 }
-function re(t, e, r) {
+function le(t, e, r) {
   const i = {
     event: t,
     payload: e,
     timestamp: Date.now(),
     source: "merchant-dashboard",
     ...r,
-    metadata: { version: I, synthetic: !0 }
-  }, n = l.get(t);
-  n == null || n.forEach((s) => {
+    metadata: { version: D, synthetic: !0 }
+  };
+  v.get(t)?.forEach((s) => {
     try {
       s(i);
-    } catch (u) {
-      a.error("Error in message handler:", u);
+    } catch (a) {
+      o.error("Error in message handler:", a);
     }
   });
 }
-const f = /* @__PURE__ */ new Map(), ie = 3e4;
-function F() {
+const E = /* @__PURE__ */ new Map(), fe = 3e4;
+function Y() {
   const t = Date.now(), e = Math.random().toString(36).slice(2, 9);
   return `req_${t}_${e}`;
 }
-function j(t, e = {}, r = ie) {
-  const i = F();
+function x(t, e = {}, r = fe) {
+  const i = Y();
   return new Promise((n, s) => {
-    const u = setTimeout(() => {
-      f.get(i) && (f.delete(i), s(
+    const a = setTimeout(() => {
+      E.get(i) && (E.delete(i), s(
         new Error(
           `[EmbeddedSDK] Request "${t}" timed out after ${r}ms`
         )
       ));
     }, r);
-    f.set(i, {
+    E.set(i, {
       resolve: n,
       reject: s,
-      timeout: u,
+      timeout: a,
       event: t
     }), c(t, e, "*", i);
   });
 }
-function H(t, e, r) {
-  const i = f.get(t);
+function C(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), f.delete(t), i.resolve(e);
+  clearTimeout(i.timeout), E.delete(t), r ? i.reject(new Error(r)) : i.resolve(e);
 }
-function ne(t = "SDK cleanup") {
-  f.forEach((e, r) => {
+function he(t = "SDK cleanup") {
+  E.forEach((e, r) => {
     clearTimeout(e.timeout), e.reject(
       new Error(`[EmbeddedSDK] Request ${r} cancelled: ${t}`)
     );
-  }), f.clear();
+  }), E.clear();
 }
-function R() {
+function A() {
   const t = /* @__PURE__ */ new Set();
   return {
     subscribe(e) {
@@ -239,7 +270,7 @@ function R() {
         try {
           r(...e);
         } catch (i) {
-          a.error("Error in subscription callback:", i);
+          o.error("Error in subscription callback:", i);
         }
       });
     },
@@ -251,41 +282,40 @@ function R() {
     }
   };
 }
-const se = "https://api.salla.dev";
-class T extends Error {
+const me = "https://api.salla.dev";
+class w extends Error {
   constructor(e, r, i) {
     super(e), this.status = r, this.response = i, this.name = "ApiError";
   }
 }
-async function ae(t, e = {}) {
-  const { method: r = "GET", headers: i = {}, body: n, timeout: s = 3e4 } = e, u = `${se}${t}`, N = new AbortController(), O = setTimeout(() => {
-    N.abort();
+async function pe(t, e = {}) {
+  const { method: r = "GET", headers: i = {}, body: n, timeout: s = 3e4 } = e, a = `${me}${t}`, l = new AbortController(), f = setTimeout(() => {
+    l.abort();
   }, s);
   try {
-    const d = await fetch(u, {
+    const d = 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(O);
-    let v;
-    const C = d.headers.get("content-type");
-    if (C != null && C.includes("application/json") ? v = await d.json() : v = await d.text(), !d.ok)
-      throw new T(
+    clearTimeout(f);
+    let m;
+    if (d.headers.get("content-type")?.includes("application/json") ? m = await d.json() : m = await d.text(), !d.ok)
+      throw new w(
         `API request failed: ${d.statusText}`,
         d.status,
-        v
+        m
       );
-    return v;
+    return m;
   } catch (d) {
-    throw clearTimeout(O), d instanceof T ? d : d instanceof Error ? d.name === "AbortError" ? new T(`Request timeout after ${s}ms`) : new T(`Request failed: ${d.message}`) : new T("Unknown error occurred");
+    throw clearTimeout(f), d instanceof w ? d : d instanceof Error ? d.name === "AbortError" ? new w(`Request timeout after ${s}ms`) : new w(`Request failed: ${d.message}`) : new w("Unknown error occurred");
   }
 }
-function _(t) {
+function k(t) {
   return {
     isVerified: !1,
     isError: !0,
@@ -293,18 +323,18 @@ function _(t) {
     data: null
   };
 }
-async function oe(t) {
+async function ge(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), k(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), k(n);
   }
   try {
-    const n = await ae(
+    const n = await pe(
       "/exchange-authority/v1/introspect",
       {
         method: "POST",
@@ -327,12 +357,12 @@ async function oe(t) {
       data: s ? n.data : null
     };
   } catch (n) {
-    i && (G().ui.toast.error((n == null ? void 0 : n.toString()) ?? "Introspect error"), c(U.REFRESH, {})), a.error("Error in introspect:", n);
+    i && (J().ui.toast.error(n?.toString() ?? "Introspect error"), c(X.REFRESH, {})), o.error("Error in introspect:", n);
     const s = n instanceof Error ? n.message : n;
-    return _(s);
+    return k(s);
   }
 }
-function ue(t) {
+function ve(t) {
   return {
     /**
      * Get the token from the URL query parameter.
@@ -367,7 +397,7 @@ function ue(t) {
      * ```
      */
     refresh() {
-      c(U.REFRESH, {});
+      c(X.REFRESH, {});
     },
     /**
      * Introspect (verify) a short-lived token with Salla's API.
@@ -378,7 +408,7 @@ function ue(t) {
      */
     async introspect(e = {}) {
       const r = e.token ?? this.getToken() ?? "", i = e.appId ?? this.getAppId() ?? "";
-      return oe({
+      return ge({
         token: r,
         appId: i,
         refreshOnError: e.refreshOnError
@@ -386,18 +416,18 @@ function ue(t) {
     }
   };
 }
-const k = ["success", "error", "warning", "info"];
-function ce(t) {
+const F = ["success", "error", "warning", "info"];
+function be(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 H(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 de(t) {
+function ye(t) {
   const e = [];
   if (typeof t != "object" || t === null)
     return e.push("Checkout options must be an object"), { valid: !1, errors: e };
@@ -405,25 +435,25 @@ function de(t) {
   if (!r && !i)
     return e.push("Checkout requires either 'item' or 'items'"), { valid: !1, errors: e };
   if (r) {
-    const n = q(
+    const n = H(
       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 u = q(
+    const a = H(
       n,
       `Item at index ${s}`
     );
-    e.push(...u);
+    e.push(...a);
   }), { valid: e.length === 0, errors: e }) : (e.push("Checkout items must be an array"), { valid: !1, errors: e });
 }
-function le(t) {
+function Ee(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 fe(t) {
+function Te(t) {
   const e = [];
   if (t.url === void 0 || t.url === null)
     e.push("Redirect URL is required");
@@ -439,7 +469,7 @@ function fe(t) {
     }
   return { valid: e.length === 0, errors: e };
 }
-function he(t) {
+function Ie(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) {
@@ -460,48 +490,153 @@ function he(t) {
     );
   }) : e.push("Nav action extendedActions must be an array")), { valid: e.length === 0, errors: e };
 }
-const z = ["danger", "warning", "info"];
-function ge(t) {
+const _ = 50;
+function R(t, e) {
+  return t ? `${t}.${e}` : e;
+}
+function Se(t, e) {
+  const r = [];
+  ["title", "value", "url"].forEach((s) => {
+    (typeof t[s] != "string" || !String(t[s]).trim()) && r.push(
+      `Sub-nav addItem "${R(e, s)}" must be non-empty string`
+    );
+  });
+  const i = R(e, "disabled"), n = R(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 = Se(i, e), s = R(e, "children");
+  return i.children === void 0 ? n : r ? Array.isArray(i.children) ? i.children.length > _ ? (n.push(
+    `Sub-nav addItem "${s}" must have at most ${_} 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 Q(t, e, r, i) {
+  if (typeof t != "object" || t === null)
+    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}]`;
+    Q(s, l, !1, i);
+  }), i;
+}
+function we(t) {
+  const e = Q(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 Ae(t) {
+  if (typeof t != "object" || t === null)
+    return {
+      valid: !1,
+      errors: ["Nav addItem expects an object item"]
+    };
+  const e = [
+    ...z(t, "", !0),
+    ...we(t)
+  ];
+  return { valid: e.length === 0, errors: e };
+}
+function Re(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, 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((d) => {
+    r[d] !== void 0 && (typeof r[d] != "string" || !r[d].trim()) && e.push(`Sub-nav updateItem "${d}" 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 > _)
+      e.push(
+        `Sub-nav updateItem "children" must have at most ${_} items`
+      );
+    else {
+      const d = /* @__PURE__ */ new Set();
+      r.children.forEach((m, V) => {
+        const M = `children[${V}]`;
+        if (e.push(...z(m, M, !1)), typeof m == "object" && m !== null) {
+          const O = m.value;
+          if (typeof O == "string" && O.trim()) {
+            const L = O.trim();
+            L === l && e.push(
+              `Sub-nav updateItem "${M}.value" must not equal the parent row identifier`
+            ), d.has(L) && e.push(
+              `Sub-nav updateItem "${M}.value" must be unique within children`
+            ), d.add(L);
+          }
+        }
+      });
+    }
+  return { valid: e.length === 0, errors: e };
+}
+function Ne(t) {
+  const e = [];
+  return (typeof t != "string" || !t.trim()) && e.push("Nav removeItem value must be non-empty string"), { valid: e.length === 0, errors: e };
+}
+const K = ["danger", "warning", "info"];
+function $e(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" || !K.includes(t.variant)) && e.push(
+    `Invalid confirm variant "${t.variant}". Expected: ${K.join(" | ")}`
   ), { valid: e.length === 0, errors: e };
 }
-function h(t, e) {
-  a.error(
+function p(t, e) {
+  o.error(
     `Validation failed for ${t}:
 ` + e.map((r) => `  • ${r}`).join(`
 `)
   );
 }
-function pe() {
+function Ce() {
   return { resize: (i) => {
   }, autoResize: () => {
   }, stopAutoResize: () => {
   } };
 }
-function me() {
-  const { resize: t, autoResize: e, stopAutoResize: r } = pe();
+function _e() {
+  const { resize: t, autoResize: e, stopAutoResize: r } = Ce();
   return {
     navigate(i, n) {
-      const s = le({ path: i, ...n });
+      const s = Ee({ path: i, ...n });
       if (!s.valid) {
-        h(p.NAVIGATE, s.errors);
+        p(T.NAVIGATE, s.errors);
         return;
       }
-      c(p.NAVIGATE, {
+      c(T.NAVIGATE, {
         path: i,
-        state: n == null ? void 0 : n.state,
-        replace: n == null ? void 0 : n.replace
+        state: n?.state,
+        replace: n?.replace
       });
     },
     redirect(i) {
-      const n = fe({ url: i });
+      const n = Te({ url: i });
       if (!n.valid) {
-        h(p.REDIRECT, n.errors);
+        p(T.REDIRECT, n.errors);
         return;
       }
-      c(p.REDIRECT, { url: i });
+      c(T.REDIRECT, { url: i });
     },
     navTo(i, n) {
       if (i.startsWith("http://") || i.startsWith("https://")) {
@@ -512,54 +647,119 @@ function me() {
     },
     setTitle(i) {
       if (typeof i != "string" || !i.trim()) {
-        h(p.SET_TITLE, [
+        p(T.SET_TITLE, [
           "Title must be a non-empty string"
         ]);
         return;
       }
-      c(p.SET_TITLE, { title: i });
+      c(T.SET_TITLE, { title: i });
     },
     resize: t,
     autoResize: e,
     stopAutoResize: r
   };
 }
-function Ee() {
-  const t = R();
-  return y(w.ACTION_CLICK, (e) => {
-    t.notify(e.payload.value);
-  }), {
-    setAction(e) {
-      var i;
-      const r = he(e);
-      if (!r.valid) {
-        h(w.SET_ACTION, r.errors);
+function De() {
+  const t = A(), e = A(), r = [];
+  return r.push(
+    b(h.ACTION_CLICK, (i) => {
+      t.notify(i.payload.value);
+    })
+  ), r.push(
+    b(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}`), C(
+          i.requestId,
+          {},
+          a
+        );
         return;
       }
-      c(w.SET_ACTION, {
-        title: e.title,
-        value: e.value,
-        subTitle: e.subTitle,
-        icon: e.icon,
-        disabled: e.disabled,
-        extendedActions: (i = e.extendedActions) == null ? void 0 : i.map((n) => ({
-          title: n.title,
-          value: n.value,
-          subTitle: n.subTitle,
-          icon: n.icon,
-          disabled: n.disabled
+      const s = n.item;
+      if (s && typeof s.value == "string" && s.value.trim()) {
+        const a = s.value.trim(), l = {
+          value: a,
+          id: a
+        };
+        C(i.requestId, l);
+      }
+    })
+  ), r.push(
+    b(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 = Ie(i);
+      if (!n.valid) {
+        p(h.SET_ACTION, n.errors);
+        return;
+      }
+      c(h.SET_ACTION, {
+        title: i.title,
+        value: i.value,
+        subTitle: i.subTitle,
+        icon: i.icon,
+        disabled: i.disabled,
+        extendedActions: i.extendedActions?.map((s) => ({
+          title: s.title,
+          value: s.value,
+          subTitle: s.subTitle,
+          icon: s.icon,
+          disabled: s.disabled
         }))
       });
     },
     clearAction() {
-      c(w.CLEAR_ACTION, {});
+      c(h.CLEAR_ACTION, {});
+    },
+    onActionClick(i) {
+      return t.subscribe(i);
+    },
+    addNavItem(i) {
+      const n = Ae(i);
+      return n.valid ? x(h.ADD_ITEM, { item: i }, 2e3) : (p(h.ADD_ITEM, n.errors), Promise.reject(new Error(n.errors[0])));
+    },
+    updateNavItem(i) {
+      const n = Re(i);
+      if (!n.valid) {
+        p(h.UPDATE_ITEM, n.errors);
+        return;
+      }
+      const s = i, a = typeof s.value == "string" ? s.value.trim() : "", l = typeof s.id == "string" ? s.id.trim() : "", f = a || l, { id: d, ...m } = s;
+      c(h.UPDATE_ITEM, {
+        item: { ...m, value: f }
+      });
+    },
+    removeNavItem(i) {
+      const n = Ne(i);
+      if (!n.valid) {
+        p(h.REMOVE_ITEM, n.errors);
+        return;
+      }
+      c(h.REMOVE_ITEM, { value: i });
+    },
+    onNavItemClick(i) {
+      return e.subscribe(i);
     },
-    onActionClick(e) {
-      return t.subscribe(e);
+    destroy() {
+      r.forEach((i) => i()), r.length = 0, t.clear(), e.clear();
     }
   };
 }
-function ye() {
+function Me() {
   return {
     /**
      * Show loading indicator.
@@ -575,11 +775,21 @@ function ye() {
     }
   };
 }
-function be() {
+function Oe() {
+  return {
+    hide() {
+      c(g.BREADCRUMBS, { action: "hide" });
+    },
+    show() {
+      c(g.BREADCRUMBS, { action: "show" });
+    }
+  };
+}
+function Le() {
   const t = (e) => {
-    const r = ce(e);
+    const r = be(e);
     if (!r.valid) {
-      h(g.TOAST, r.errors);
+      p(g.TOAST, r.errors);
       return;
     }
     c(g.TOAST, {
@@ -619,29 +829,30 @@ function be() {
     }
   };
 }
-function Te() {
+function qe() {
   return async (t) => {
-    const e = ge(t);
-    return e.valid ? j(g.CONFIRM, {
+    const e = $e(t);
+    return e.valid ? x(g.CONFIRM, {
       title: t.title,
       message: t.message,
       confirmText: t.confirmText ?? "Confirm",
       cancelText: t.cancelText ?? "Cancel",
       variant: t.variant ?? "info"
-    }) : (h(g.CONFIRM, e.errors), Promise.reject(new Error(e.errors.join(", "))));
+    }) : (p(g.CONFIRM, e.errors), Promise.reject(new Error(e.errors.join(", "))));
   };
 }
-function ve() {
+function ke() {
   return {
-    loading: ye(),
-    toast: be(),
-    confirm: Te()
+    loading: Me(),
+    breadcrumbs: Oe(),
+    toast: Le(),
+    confirm: qe()
   };
 }
-function we() {
-  const t = R(), e = [];
+function xe() {
+  const t = A(), e = [];
   return e.push(
-    y(m.RESPONSE, (r) => {
+    b(y.RESPONSE, (r) => {
       t.notify({
         success: r.payload.success,
         order_id: r.payload.order_id,
@@ -651,10 +862,10 @@ function we() {
       });
     })
   ), e.push(
-    y(
-      m.GET_ADDONS_RESPONSE,
+    b(
+      y.GET_ADDONS_RESPONSE,
       (r) => {
-        r.requestId && H(r.requestId, {
+        r.requestId && C(r.requestId, {
           success: r.payload.success,
           addons: r.payload.addons,
           error: r.payload.error
@@ -663,21 +874,21 @@ function we() {
     )
   ), {
     create(r, i) {
-      const n = Array.isArray(r) ? r : [r], s = de({ items: n });
+      const n = Array.isArray(r) ? r : [r], s = ye({ items: n });
       if (!s.valid)
-        throw h(m.CREATE, s.errors), new Error(s.errors[0]);
+        throw p(y.CREATE, s.errors), new Error(s.errors[0]);
       c(
-        m.CREATE,
+        y.CREATE,
         {
-          items: n.map((u) => ({
-            type: u.type,
-            slug: u.slug,
-            quantity: u.quantity ?? 1
+          items: n.map((a) => ({
+            type: a.type,
+            slug: a.slug,
+            quantity: a.quantity ?? 1
           })),
-          ...(i == null ? void 0 : i.context) !== void 0 && { context: i.context }
+          ...i?.context !== void 0 && { context: i.context }
         },
         "*",
-        F()
+        Y()
       );
     },
     onResult(r) {
@@ -685,8 +896,8 @@ function we() {
     },
     async getAddons() {
       try {
-        return await j(
-          m.GET_ADDONS,
+        return await x(
+          y.GET_ADDONS,
           {},
           3e4
         );
@@ -700,23 +911,27 @@ function we() {
         };
       }
     },
+    resetCache() {
+      c(y.RESET_CACHE, {}, "*");
+    },
     destroy() {
       e.forEach((r) => r()), e.length = 0, t.clear();
     }
   };
 }
-const M = {
+const G = {
   theme: "light",
+  dir: "rtl",
   width: 0,
   locale: "ar",
   currency: "SAR"
 };
-class Se {
+class ze {
   constructor() {
-    this.initialized = !1, this.initializing = !1, this.debugMode = !1, this.appReady = !1, this.layout = { ...M }, this.postInitHooks = [], this.themeSubscription = R(), this.initSubscription = R(), this.auth = ue(), this.page = me(), this.nav = Ee(), this.ui = ve(), this.checkout = we(), this.registerPostInitHook((e) => {
+    this.initialized = !1, this.initializing = !1, this.debugMode = !1, this.appReady = !1, this.layout = { ...G }, this.postInitHooks = [], this.themeSubscription = A(), this.initSubscription = A(), this.auth = ve(), this.page = _e(), this.nav = De(), this.ui = ke(), this.checkout = xe(), this.registerPostInitHook((e) => {
       const r = e.payload.pendingCheckoutResult;
-      r && (a.debug("Dispatching pending checkout result:", r), queueMicrotask(() => {
-        re(m.RESPONSE, {
+      r && (o.debug("Dispatching pending checkout result:", r), queueMicrotask(() => {
+        le(y.RESPONSE, {
           success: r.success,
           status: r.status,
           error: r.error,
@@ -736,10 +951,10 @@ class Se {
    * Set up core event listeners.
    */
   setupListeners() {
-    y(x.THEME_CHANGE, (e) => {
-      this.layout.theme = e.payload.theme, a.debug("Theme changed:", e.payload.theme), this.themeSubscription.notify(e.payload.theme);
-    }), y(g.CONFIRM_RESPONSE, (e) => {
-      a.debug("Received confirm response:", e), e.requestId && H(e.requestId, { confirmed: e.payload.confirmed });
+    b(U.THEME_CHANGE, (e) => {
+      this.layout.theme = e.payload.theme, o.debug("Theme changed:", e.payload.theme), this.themeSubscription.notify(e.payload.theme);
+    }), b(g.CONFIRM_RESPONSE, (e) => {
+      o.debug("Received confirm response:", e), e.requestId && C(e.requestId, { confirmed: e.payload.confirmed });
     });
   }
   /**
@@ -772,7 +987,7 @@ class Se {
       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);
   }
@@ -781,49 +996,50 @@ class Se {
    */
   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, c($.READY, {}), a.debug("Sent ready signal to host");
+    this.appReady = !0, c(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 }), te() || a.warn("Not running in an iframe. Some features may not work."), a.debug("Initializing SDK...");
+    this.initializing = !0, this.debugMode = e.debug ?? !1, ne({ debug: this.debugMode }), ce() || o.warn("Not running in an iframe. Some features may not work."), o.debug("Initializing SDK...");
     try {
-      c($.INIT, {
+      c(q.INIT, {
         height: document.documentElement.scrollHeight
-      }), a.debug("Sent iframe.ready message, waiting for context...");
-      const r = await Z(
-        x.PROVIDE
+      }), o.debug("Sent iframe.ready message, waiting for context...");
+      const r = await ue(
+        U.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 == null ? void 0 : i.theme) ?? "light",
-        width: (i == null ? void 0 : i.width) ?? 0,
-        locale: (i == null ? void 0 : i.locale) ?? "ar",
-        currency: (i == null ? void 0 : i.currency) ?? "SAR"
+        theme: i?.theme ?? "light",
+        dir: i?.dir ?? ie(i?.locale),
+        width: i?.width ?? 0,
+        locale: i?.locale ?? "ar",
+        currency: i?.currency ?? "SAR"
       }, this.postInitHooks.forEach((n) => {
         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;
     }
@@ -832,23 +1048,23 @@ class Se {
    * Destroy the SDK instance and clean up resources.
    */
   destroy() {
-    a.debug("Destroying SDK instance"), this.initialized && (c($.DESTROY, {}), a.debug("Sent destroy event to host")), this.checkout.destroy(), ne("SDK destroyed"), ee(), this.themeSubscription.clear(), this.initSubscription.clear(), this.postInitHooks = [], this.initialized = !1, this.initializing = !1, this.appReady = !1, this.layout = { ...M };
+    o.debug("Destroying SDK instance"), this.initialized && (c(q.DESTROY, {}), o.debug("Sent destroy event to host")), this.checkout.destroy(), this.nav.destroy(), he("SDK destroyed"), de(), this.themeSubscription.clear(), this.initSubscription.clear(), this.postInitHooks = [], this.initialized = !1, this.initializing = !1, this.appReady = !1, this.layout = { ...G };
   }
 }
-let E = null;
-function G() {
-  return E || (E = new Se()), E;
+let I = null;
+function J() {
+  return I || (I = new ze()), I;
 }
-function Ae() {
-  E && (E.destroy(), E = null);
+function Ve() {
+  I && (I.destroy(), I = null);
 }
-const P = G(), Re = I;
-typeof window < "u" && (window.salla = window.salla || window.Salla || {}, window.Salla = window.salla, window.salla.embedded || (window.salla.embedded = P), window.Salla.embedded || (window.Salla.embedded = P));
+const B = J(), Ue = D;
+typeof window < "u" && (window.salla = window.salla || window.Salla || {}, window.Salla = window.salla, window.salla.embedded || (window.salla.embedded = B), window.Salla.embedded || (window.Salla.embedded = B));
 export {
-  Se as EmbeddedApp,
-  P as embedded,
-  G as getEmbeddedApp,
-  Ae as resetEmbeddedApp,
-  Re as version
+  ze as EmbeddedApp,
+  B as embedded,
+  J as getEmbeddedApp,
+  Ve as resetEmbeddedApp,
+  Ue as version
 };
 //# sourceMappingURL=index.js.map