@iota-uz/sdk 0.3.4 → 0.4.8

package/dist/applet/devtools.mjs

@@ -0,0 +1,128 @@
+import { createContext, useState, useEffect, useMemo, useContext } from 'react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// ui/src/applet-devtools/enabled.ts
+function shouldEnableAppletDevtools() {
+  if (typeof window === "undefined") return false;
+  const url = new URL(window.location.href);
+  if (url.searchParams.get("appletDebug") === "1") return true;
+  try {
+    return window.localStorage.getItem("iotaAppletDevtools") === "1";
+  } catch {
+    return false;
+  }
+}
+var AppletContext = createContext(null);
+function useAppletContext() {
+  const context = useContext(AppletContext);
+  if (!context) {
+    throw new Error("useAppletContext must be used within AppletProvider");
+  }
+  return context;
+}
+
+// ui/src/applet-core/hooks/useConfig.ts
+function useConfig() {
+  const { config } = useAppletContext();
+  return config;
+}
+
+// ui/src/applet-core/hooks/useAppletRuntime.ts
+function useAppletRuntime() {
+  const config = useConfig();
+  const basePath = config.basePath ?? "";
+  const normalizedBasePath = basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+  const assetsBasePath = config.assetsBasePath ?? `${normalizedBasePath || ""}/assets`;
+  const rpcEndpoint = config.rpcUIEndpoint;
+  const shellMode = config.shellMode;
+  return { basePath: normalizedBasePath, assetsBasePath, rpcEndpoint, shellMode };
+}
+function AppletDevtoolsOverlay() {
+  const ctx = useAppletContext();
+  const runtime = useAppletRuntime();
+  const [rpcEvents, setRPCEvents] = useState([]);
+  useEffect(() => {
+    const onEvent = (e) => {
+      if (!(e instanceof CustomEvent)) return;
+      const detail = e.detail;
+      if (!detail) return;
+      setRPCEvents((prev) => [detail, ...prev].slice(0, 50));
+    };
+    window.addEventListener("iota:applet-rpc", onEvent);
+    return () => window.removeEventListener("iota:applet-rpc", onEvent);
+  }, []);
+  const summary = useMemo(() => {
+    return {
+      basePath: runtime.basePath,
+      assetsBasePath: runtime.assetsBasePath,
+      rpcEndpoint: runtime.rpcEndpoint,
+      shellMode: runtime.shellMode,
+      route: ctx.route,
+      user: { id: ctx.user.id, email: ctx.user.email },
+      tenant: ctx.tenant
+    };
+  }, [ctx.route, ctx.tenant, ctx.user.email, ctx.user.id, runtime.assetsBasePath, runtime.basePath, runtime.rpcEndpoint, runtime.shellMode]);
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      style: {
+        position: "fixed",
+        right: 12,
+        bottom: 12,
+        width: 420,
+        maxHeight: "60vh",
+        overflow: "auto",
+        background: "rgba(17, 24, 39, 0.92)",
+        color: "#E5E7EB",
+        border: "1px solid rgba(255,255,255,0.12)",
+        borderRadius: 10,
+        padding: 12,
+        fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace',
+        fontSize: 12,
+        zIndex: 2147483647
+      },
+      children: [
+        /* @__PURE__ */ jsxs("div", { style: { display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: 8 }, children: [
+          /* @__PURE__ */ jsx("div", { style: { fontWeight: 700 }, children: "Applet Devtools" }),
+          /* @__PURE__ */ jsx("div", { style: { opacity: 0.7 }, children: runtime.shellMode ?? "unknown" })
+        ] }),
+        /* @__PURE__ */ jsxs("div", { style: { marginBottom: 10 }, children: [
+          /* @__PURE__ */ jsx("div", { style: { opacity: 0.85, marginBottom: 4 }, children: "Context" }),
+          /* @__PURE__ */ jsx("pre", { style: { margin: 0, whiteSpace: "pre-wrap", wordBreak: "break-word" }, children: JSON.stringify(summary, null, 2) })
+        ] }),
+        /* @__PURE__ */ jsxs("div", { children: [
+          /* @__PURE__ */ jsx("div", { style: { opacity: 0.85, marginBottom: 4 }, children: "RPC" }),
+          rpcEvents.length === 0 ? /* @__PURE__ */ jsx("div", { style: { opacity: 0.7 }, children: "No calls yet" }) : /* @__PURE__ */ jsx("div", { style: { display: "flex", flexDirection: "column", gap: 6 }, children: rpcEvents.map((ev) => /* @__PURE__ */ jsxs("div", { style: { padding: 8, border: "1px solid rgba(255,255,255,0.08)", borderRadius: 8 }, children: [
+            /* @__PURE__ */ jsxs("div", { style: { display: "flex", justifyContent: "space-between" }, children: [
+              /* @__PURE__ */ jsx("div", { children: ev.method }),
+              /* @__PURE__ */ jsxs("div", { style: { opacity: 0.8 }, children: [
+                ev.status,
+                typeof ev.durationMs === "number" ? ` (${ev.durationMs}ms)` : ""
+              ] })
+            ] }),
+            ev.status === "error" ? /* @__PURE__ */ jsx("pre", { style: { margin: "6px 0 0", opacity: 0.8, whiteSpace: "pre-wrap", wordBreak: "break-word" }, children: JSON.stringify(serializeError(ev.error) ?? {}, null, 2) }) : null
+          ] }, `${ev.id}:${ev.status}`)) })
+        ] })
+      ]
+    }
+  );
+}
+function serializeError(err) {
+  if (err instanceof Error) {
+    const anyErr = err;
+    const out = {
+      name: err.name,
+      message: err.message
+    };
+    if (err.stack) out.stack = err.stack;
+    if (typeof anyErr.code === "string") out.code = anyErr.code;
+    if (anyErr.details !== void 0) out.details = anyErr.details;
+    if (anyErr.cause !== void 0) out.cause = anyErr.cause;
+    return out;
+  }
+  return err;
+}
+
+export { AppletDevtoolsOverlay, shouldEnableAppletDevtools };
+//# sourceMappingURL=devtools.mjs.map
+//# sourceMappingURL=devtools.mjs.map

package/dist/applet/devtools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../ui/src/applet-devtools/enabled.ts","../../ui/src/applet-core/context/AppletContext.tsx","../../ui/src/applet-core/hooks/useConfig.ts","../../ui/src/applet-core/hooks/useAppletRuntime.ts","../../ui/src/applet-devtools/overlay.tsx"],"names":["jsx"],"mappings":"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","file":"devtools.mjs","sourcesContent":["export function shouldEnableAppletDevtools(): boolean {\n  if (typeof window === 'undefined') return false\n\n  const url = new URL(window.location.href)\n  if (url.searchParams.get('appletDebug') === '1') return true\n\n  try {\n    return window.localStorage.getItem('iotaAppletDevtools') === '1'\n  } catch {\n    return false\n  }\n}\n\n","import { createContext, useContext, ReactNode } from 'react'\nimport type { InitialContext } from '../types'\n\n/**\n * AppletContext provides access to the global context injected by the backend.\n * The context is read from window.__*_CONTEXT__ (configured via windowKey).\n */\nconst AppletContext = createContext<InitialContext | null>(null)\n\nconst REQUIRED_KEYS: Array<keyof InitialContext> = ['user', 'tenant', 'locale', 'config', 'route', 'session']\n\nfunction validateInitialContext(value: unknown, windowKey: string): InitialContext {\n  if (!value || typeof value !== 'object') {\n    throw new Error(`${windowKey}: expected an object, got ${typeof value}`)\n  }\n  const obj = value as Record<string, unknown>\n  const missing = REQUIRED_KEYS.filter((k) => !(k in obj))\n  if (missing.length > 0) {\n    throw new Error(`${windowKey}: missing required keys: ${missing.join(', ')}`)\n  }\n\n  // Deep validation for nested required fields\n  const user = obj.user as Record<string, unknown> | undefined\n  if (!user || typeof user !== 'object') {\n    throw new Error(`${windowKey}.user: expected an object, got ${typeof user}`)\n  }\n  if (typeof user.id !== 'number') {\n    throw new Error(`${windowKey}.user.id: expected number, got ${typeof user.id}`)\n  }\n  if (!Array.isArray(user.permissions)) {\n    throw new Error(`${windowKey}.user.permissions: expected array, got ${typeof user.permissions}`)\n  }\n\n  const tenant = obj.tenant as Record<string, unknown> | undefined\n  if (!tenant || typeof tenant !== 'object') {\n    throw new Error(`${windowKey}.tenant: expected an object, got ${typeof tenant}`)\n  }\n  if (typeof tenant.id !== 'string') {\n    throw new Error(`${windowKey}.tenant.id: expected string, got ${typeof tenant.id}`)\n  }\n\n  const session = obj.session as Record<string, unknown> | undefined\n  if (!session || typeof session !== 'object') {\n    throw new Error(`${windowKey}.session: expected an object, got ${typeof session}`)\n  }\n  if (typeof session.csrfToken !== 'string') {\n    throw new Error(`${windowKey}.session.csrfToken: expected string, got ${typeof session.csrfToken}`)\n  }\n  if (typeof session.expiresAt !== 'number') {\n    throw new Error(`${windowKey}.session.expiresAt: expected number, got ${typeof session.expiresAt}`)\n  }\n  if (typeof session.refreshURL !== 'string') {\n    throw new Error(`${windowKey}.session.refreshURL: expected string, got ${typeof session.refreshURL}`)\n  }\n\n  const config = obj.config\n  if (!config || typeof config !== 'object') {\n    throw new Error(`${windowKey}.config: expected object, got ${typeof config}`)\n  }\n\n  return value as InitialContext\n}\n\nexport interface AppletProviderProps {\n  children: ReactNode\n  windowKey: string\n  context?: InitialContext\n}\n\n/**\n * AppletProvider reads context from window global and provides it to hooks.\n *\n * Usage:\n * <AppletProvider windowKey=\"__BICHAT_CONTEXT__\">\n *   <App />\n * </AppletProvider>\n */\nexport function AppletProvider({ children, windowKey, context }: AppletProviderProps) {\n  // Use provided context or read from window global\n  const raw = context ?? (window as any)[windowKey]\n\n  if (!raw) {\n    throw new Error(`${windowKey} not found on window. Ensure backend context injection is working.`)\n  }\n\n  const initialContext = validateInitialContext(raw, windowKey)\n\n  return (\n    <AppletContext.Provider value={initialContext}>\n      {children}\n    </AppletContext.Provider>\n  )\n}\n\n/**\n * useAppletContext provides access to the full applet context.\n * Use specialized hooks (useUser, useConfig, etc.) for specific context parts.\n */\nexport function useAppletContext<T = InitialContext>(): T {\n  const context = useContext(AppletContext)\n  if (!context) {\n    throw new Error('useAppletContext must be used within AppletProvider')\n  }\n  return context as T\n}\n","import { useAppletContext } from '../context/AppletContext'\nimport type { AppConfig } from '../types'\n\n/**\n * useConfig provides access to applet configuration (endpoints, etc.)\n *\n * Usage:\n * const { graphQLEndpoint, streamEndpoint } = useConfig()\n */\nexport function useConfig(): AppConfig {\n  const { config } = useAppletContext()\n  return config\n}\n","import { useConfig } from './useConfig'\n\nexport type ShellMode = 'embedded' | 'standalone'\n\nexport interface AppletRuntime {\n  basePath: string\n  assetsBasePath: string\n  rpcEndpoint?: string\n  shellMode?: ShellMode\n}\n\nexport function useAppletRuntime(): AppletRuntime {\n  const config = useConfig()\n\n  const basePath = config.basePath ?? ''\n  const normalizedBasePath = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath\n  const assetsBasePath = config.assetsBasePath ?? `${normalizedBasePath || ''}/assets`\n  const rpcEndpoint = config.rpcUIEndpoint\n  const shellMode = config.shellMode\n\n  return { basePath: normalizedBasePath, assetsBasePath, rpcEndpoint, shellMode }\n}\n","import { useEffect, useMemo, useState } from 'react'\nimport { useAppletContext } from '../applet-core/context/AppletContext'\nimport { useAppletRuntime } from '../applet-core/hooks/useAppletRuntime'\n\ntype RPCEvent = {\n  id: string\n  method: string\n  status: 'start' | 'success' | 'error'\n  durationMs?: number\n  error?: unknown\n}\n\nexport function AppletDevtoolsOverlay() {\n  const ctx = useAppletContext()\n  const runtime = useAppletRuntime()\n  const [rpcEvents, setRPCEvents] = useState<RPCEvent[]>([])\n\n  useEffect(() => {\n    const onEvent = (e: Event) => {\n      if (!(e instanceof CustomEvent)) return\n      const detail = (e as CustomEvent<RPCEvent>).detail\n      if (!detail) return\n      setRPCEvents((prev) => [detail, ...prev].slice(0, 50))\n    }\n    window.addEventListener('iota:applet-rpc', onEvent as EventListener)\n    return () => window.removeEventListener('iota:applet-rpc', onEvent as EventListener)\n  }, [])\n\n  const summary = useMemo(() => {\n    return {\n      basePath: runtime.basePath,\n      assetsBasePath: runtime.assetsBasePath,\n      rpcEndpoint: runtime.rpcEndpoint,\n      shellMode: runtime.shellMode,\n      route: ctx.route,\n      user: { id: ctx.user.id, email: ctx.user.email },\n      tenant: ctx.tenant,\n    }\n  }, [ctx.route, ctx.tenant, ctx.user.email, ctx.user.id, runtime.assetsBasePath, runtime.basePath, runtime.rpcEndpoint, runtime.shellMode])\n\n  return (\n    <div\n      style={{\n        position: 'fixed',\n        right: 12,\n        bottom: 12,\n        width: 420,\n        maxHeight: '60vh',\n        overflow: 'auto',\n        background: 'rgba(17, 24, 39, 0.92)',\n        color: '#E5E7EB',\n        border: '1px solid rgba(255,255,255,0.12)',\n        borderRadius: 10,\n        padding: 12,\n        fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace',\n        fontSize: 12,\n        zIndex: 2147483647,\n      }}\n    >\n      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 8 }}>\n        <div style={{ fontWeight: 700 }}>Applet Devtools</div>\n        <div style={{ opacity: 0.7 }}>{runtime.shellMode ?? 'unknown'}</div>\n      </div>\n\n      <div style={{ marginBottom: 10 }}>\n        <div style={{ opacity: 0.85, marginBottom: 4 }}>Context</div>\n        <pre style={{ margin: 0, whiteSpace: 'pre-wrap', wordBreak: 'break-word' }}>{JSON.stringify(summary, null, 2)}</pre>\n      </div>\n\n      <div>\n        <div style={{ opacity: 0.85, marginBottom: 4 }}>RPC</div>\n        {rpcEvents.length === 0 ? (\n          <div style={{ opacity: 0.7 }}>No calls yet</div>\n        ) : (\n          <div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>\n            {rpcEvents.map((ev) => (\n              <div key={`${ev.id}:${ev.status}`} style={{ padding: 8, border: '1px solid rgba(255,255,255,0.08)', borderRadius: 8 }}>\n                <div style={{ display: 'flex', justifyContent: 'space-between' }}>\n                  <div>{ev.method}</div>\n                  <div style={{ opacity: 0.8 }}>\n                    {ev.status}\n                    {typeof ev.durationMs === 'number' ? ` (${ev.durationMs}ms)` : ''}\n                  </div>\n                </div>\n                {ev.status === 'error' ? (\n                  <pre style={{ margin: '6px 0 0', opacity: 0.8, whiteSpace: 'pre-wrap', wordBreak: 'break-word' }}>\n                    {JSON.stringify(serializeError(ev.error) ?? {}, null, 2)}\n                  </pre>\n                ) : null}\n              </div>\n            ))}\n          </div>\n        )}\n      </div>\n    </div>\n  )\n}\n\nfunction serializeError(err: unknown): unknown {\n  if (err instanceof Error) {\n    const anyErr = err as any\n    const out: Record<string, unknown> = {\n      name: err.name,\n      message: err.message,\n    }\n    if (err.stack) out.stack = err.stack\n    if (typeof anyErr.code === 'string') out.code = anyErr.code\n    if (anyErr.details !== undefined) out.details = anyErr.details\n    if (anyErr.cause !== undefined) out.cause = anyErr.cause\n    return out\n  }\n  return err\n}\n"]}

package/dist/applet/host.cjs

@@ -0,0 +1,256 @@
+'use strict';
+
+var client = require('react-dom/client');
+var jsxRuntime = require('react/jsx-runtime');
+
+// ui/src/applet-host/react-element.ts
+function defineReactAppletElement(options) {
+  const tagName = options.tagName.toLowerCase();
+  const registry = getRegistry();
+  const existing = registry.get(tagName);
+  if (existing) {
+    existing.options = options;
+    for (const a of options.observedAttributes ?? []) existing.observed.add(a);
+  } else {
+    const observed = /* @__PURE__ */ new Set(["base-path", "shell-mode", "router-mode"]);
+    for (const a of options.observedAttributes ?? []) observed.add(a);
+    registry.set(tagName, { options, observed });
+  }
+  if (customElements.get(tagName)) {
+    if (typeof window !== "undefined") {
+      window.dispatchEvent(new CustomEvent("iota:applet-host-update", { detail: { tagName } }));
+    }
+    return;
+  }
+  function getEntry() {
+    const entry = getRegistry().get(tagName);
+    if (!entry) throw new Error(`[${tagName}] applet host registry entry missing`);
+    return entry;
+  }
+  class ReactAppletElement extends HTMLElement {
+    constructor() {
+      super(...arguments);
+      this.reactRoot = null;
+      this.container = null;
+      this.darkModeObserver = null;
+      this.styleEl = null;
+      this.updateListener = null;
+    }
+    static get observedAttributes() {
+      return Array.from(getEntry().observed);
+    }
+    connectedCallback() {
+      const shadowRoot = this.shadowRoot ?? this.attachShadow({ mode: "open" });
+      if (!this.container) {
+        this.container = document.createElement("div");
+        this.container.id = "react-root";
+        this.container.style.display = "flex";
+        this.container.style.flexDirection = "column";
+        this.container.style.flex = "1";
+        this.container.style.minHeight = "0";
+        this.container.style.height = "100%";
+        this.container.style.width = "100%";
+      }
+      const existingContainer = shadowRoot.querySelector("#react-root");
+      if (!existingContainer) {
+        if (this.styleEl) shadowRoot.appendChild(this.styleEl);
+        shadowRoot.appendChild(this.container);
+      } else if (existingContainer !== this.container) {
+        this.container = existingContainer;
+      }
+      this.syncFromRegistry();
+      this.updateListener ?? (this.updateListener = (e) => {
+        if (!(e instanceof CustomEvent)) return;
+        const detail = e.detail;
+        if (!detail || detail.tagName !== tagName) return;
+        this.syncFromRegistry();
+        this.renderReact();
+      });
+      window.addEventListener("iota:applet-host-update", this.updateListener);
+      this.renderReact();
+    }
+    disconnectedCallback() {
+      if (this.updateListener) {
+        window.removeEventListener("iota:applet-host-update", this.updateListener);
+      }
+      this.darkModeObserver?.disconnect();
+      this.darkModeObserver = null;
+      this.reactRoot?.unmount();
+      this.reactRoot = null;
+    }
+    attributeChangedCallback(_name, oldValue, newValue) {
+      if (oldValue === newValue) return;
+      if (this.container) this.renderReact();
+    }
+    getHostConfig() {
+      const attrs = {};
+      for (const { name, value } of Array.from(this.attributes)) {
+        attrs[name] = value;
+      }
+      const basePath = this.getAttribute("base-path") ?? "";
+      const shellMode = this.getAttribute("shell-mode") ?? void 0;
+      const routerMode = this.getAttribute("router-mode") ?? "url";
+      return { basePath, shellMode, routerMode, attrs };
+    }
+    renderReact() {
+      if (!this.container) return;
+      if (!this.reactRoot) {
+        this.reactRoot = client.createRoot(this.container);
+      }
+      try {
+        this.reactRoot.render(getEntry().options.render(this.getHostConfig()));
+      } catch (err) {
+        console.error(`[${tagName}] failed to mount React app:`, err);
+      }
+    }
+    syncFromRegistry() {
+      const entry = getEntry();
+      const styles = typeof entry.options.styles === "function" ? entry.options.styles() : entry.options.styles;
+      if (styles) {
+        this.styleEl ?? (this.styleEl = document.createElement("style"));
+        this.styleEl.textContent = styles;
+        if (this.shadowRoot && !this.shadowRoot.contains(this.styleEl)) {
+          this.shadowRoot.insertBefore(this.styleEl, this.shadowRoot.firstChild);
+        }
+      } else if (this.styleEl) {
+        this.styleEl.remove();
+        this.styleEl = null;
+      }
+      if (entry.options.observeDarkMode !== false) {
+        this.darkModeObserver ?? (this.darkModeObserver = this.syncDarkMode());
+      } else if (this.darkModeObserver) {
+        this.darkModeObserver.disconnect();
+        this.darkModeObserver = null;
+      }
+    }
+    syncDarkMode() {
+      const root = this.container;
+      if (!root) throw new Error("react root container not found");
+      const apply = () => {
+        if (document.documentElement.classList.contains("dark")) root.classList.add("dark");
+        else root.classList.remove("dark");
+      };
+      apply();
+      const observer = new MutationObserver(apply);
+      observer.observe(document.documentElement, { attributes: true, attributeFilter: ["class"] });
+      return observer;
+    }
+  }
+  customElements.define(tagName, ReactAppletElement);
+}
+function getRegistry() {
+  const anyGlobal = globalThis;
+  anyGlobal.__IOTA_REACT_APPLET_HOST_REGISTRY__ ?? (anyGlobal.__IOTA_REACT_APPLET_HOST_REGISTRY__ = /* @__PURE__ */ new Map());
+  return anyGlobal.__IOTA_REACT_APPLET_HOST_REGISTRY__;
+}
+
+// ui/src/applet-devtools/enabled.ts
+function shouldEnableAppletDevtools() {
+  if (typeof window === "undefined") return false;
+  const url = new URL(window.location.href);
+  if (url.searchParams.get("appletDebug") === "1") return true;
+  try {
+    return window.localStorage.getItem("iotaAppletDevtools") === "1";
+  } catch {
+    return false;
+  }
+}
+
+// ui/src/applet-host/rpc.ts
+var AppletRPCException = class extends Error {
+  constructor(args) {
+    super(args.message);
+    this.name = "AppletRPCException";
+    this.code = args.code;
+    this.details = args.details;
+    this.cause = args.cause;
+  }
+};
+function createAppletRPCClient(options) {
+  const fetcher = options.fetcher ?? fetch;
+  async function call(method, params) {
+    const req = { id: crypto.randomUUID(), method, params };
+    const startedAt = typeof performance !== "undefined" ? performance.now() : Date.now();
+    maybeDispatchRPCEvent({
+      id: req.id,
+      method: req.method,
+      status: "start"
+    });
+    try {
+      const resp = await fetcher(options.endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(req)
+      });
+      if (!resp.ok) {
+        throw new AppletRPCException({
+          code: "http_error",
+          message: `HTTP ${resp.status}`,
+          details: { status: resp.status }
+        });
+      }
+      const json = await resp.json();
+      if (json.error) {
+        throw new AppletRPCException({
+          code: json.error.code,
+          message: json.error.message,
+          details: json.error.details
+        });
+      }
+      if (json.result === void 0) {
+        throw new AppletRPCException({
+          code: "invalid_response",
+          message: "Missing result in successful response"
+        });
+      }
+      maybeDispatchRPCEvent({
+        id: req.id,
+        method: req.method,
+        status: "success",
+        durationMs: elapsedMs(startedAt)
+      });
+      return json.result;
+    } catch (err) {
+      maybeDispatchRPCEvent({
+        id: req.id,
+        method: req.method,
+        status: "error",
+        durationMs: elapsedMs(startedAt),
+        error: err
+      });
+      throw err;
+    }
+  }
+  async function callTyped(method, params) {
+    return call(method, params);
+  }
+  return { call, callTyped };
+}
+function maybeDispatchRPCEvent(detail) {
+  if (typeof window === "undefined") return;
+  if (!shouldEnableAppletDevtools()) return;
+  window.dispatchEvent(new CustomEvent("iota:applet-rpc", { detail }));
+}
+function elapsedMs(startedAt) {
+  const now = typeof performance !== "undefined" ? performance.now() : Date.now();
+  return Math.max(0, Math.round(now - startedAt));
+}
+function createAppletRouter(options) {
+  const basePath = options.basePath ?? "";
+  const Router = ({ children }) => {
+    if (options.mode === "memory") {
+      const MemoryRouter = options.MemoryRouter;
+      return /* @__PURE__ */ jsxRuntime.jsx(MemoryRouter, { children });
+    }
+    const BrowserRouter = options.BrowserRouter;
+    return /* @__PURE__ */ jsxRuntime.jsx(BrowserRouter, { basename: basePath, children });
+  };
+  return { Router };
+}
+
+exports.AppletRPCException = AppletRPCException;
+exports.createAppletRPCClient = createAppletRPCClient;
+exports.createAppletRouter = createAppletRouter;
+exports.defineReactAppletElement = defineReactAppletElement;
+//# sourceMappingURL=host.cjs.map
+//# sourceMappingURL=host.cjs.map

package/dist/applet/host.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../ui/src/applet-host/react-element.ts","../../ui/src/applet-devtools/enabled.ts","../../ui/src/applet-host/rpc.ts","../../ui/src/applet-host/router.tsx"],"names":["createRoot","jsx"],"mappings":"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","file":"host.cjs","sourcesContent":["import type React from 'react'\nimport { createRoot, type Root } from 'react-dom/client'\n\nexport type RouterMode = 'url' | 'memory'\nexport type ShellMode = 'embedded' | 'standalone'\n\ntype RegistryEntry = {\n  options: DefineReactAppletElementOptions\n  observed: Set<string>\n}\n\nexport interface AppletHostConfig {\n  basePath: string\n  shellMode?: ShellMode\n  routerMode: RouterMode\n  attrs: Record<string, string>\n}\n\nexport interface DefineReactAppletElementOptions {\n  tagName: string\n  styles?: string | (() => string)\n  render: (host: AppletHostConfig) => React.ReactElement\n  observedAttributes?: string[]\n  observeDarkMode?: boolean\n}\n\nexport function defineReactAppletElement(options: DefineReactAppletElementOptions): void {\n  const tagName = options.tagName.toLowerCase()\n\n  const registry = getRegistry()\n  const existing = registry.get(tagName)\n  if (existing) {\n    existing.options = options\n    for (const a of options.observedAttributes ?? []) existing.observed.add(a)\n  } else {\n    const observed = new Set<string>(['base-path', 'shell-mode', 'router-mode'])\n    for (const a of options.observedAttributes ?? []) observed.add(a)\n    registry.set(tagName, { options, observed })\n  }\n\n  if (customElements.get(tagName)) {\n    if (typeof window !== 'undefined') {\n      window.dispatchEvent(new CustomEvent('iota:applet-host-update', { detail: { tagName } }))\n    }\n    return\n  }\n\n  function getEntry(): RegistryEntry {\n    const entry = getRegistry().get(tagName)\n    if (!entry) throw new Error(`[${tagName}] applet host registry entry missing`)\n    return entry\n  }\n\n  class ReactAppletElement extends HTMLElement {\n    private reactRoot: Root | null = null\n    private container: HTMLDivElement | null = null\n    private darkModeObserver: MutationObserver | null = null\n    private styleEl: HTMLStyleElement | null = null\n    private updateListener: ((e: Event) => void) | null = null\n\n    static get observedAttributes(): string[] {\n      return Array.from(getEntry().observed)\n    }\n\n    connectedCallback(): void {\n      const shadowRoot = this.shadowRoot ?? this.attachShadow({ mode: 'open' })\n\n      if (!this.container) {\n        this.container = document.createElement('div')\n        this.container.id = 'react-root'\n        this.container.style.display = 'flex'\n        this.container.style.flexDirection = 'column'\n        this.container.style.flex = '1'\n        this.container.style.minHeight = '0'\n        this.container.style.height = '100%'\n        this.container.style.width = '100%'\n      }\n\n      const existingContainer = shadowRoot.querySelector('#react-root')\n      if (!existingContainer) {\n        if (this.styleEl) shadowRoot.appendChild(this.styleEl)\n        shadowRoot.appendChild(this.container)\n      } else if (existingContainer !== this.container) {\n        this.container = existingContainer as HTMLDivElement\n      }\n\n      this.syncFromRegistry()\n\n      this.updateListener ??= (e: Event) => {\n        if (!(e instanceof CustomEvent)) return\n        const detail = (e as CustomEvent<{ tagName?: string }>).detail\n        if (!detail || detail.tagName !== tagName) return\n        this.syncFromRegistry()\n        this.renderReact()\n      }\n      window.addEventListener('iota:applet-host-update', this.updateListener as EventListener)\n\n      this.renderReact()\n    }\n\n    disconnectedCallback(): void {\n      if (this.updateListener) {\n        window.removeEventListener('iota:applet-host-update', this.updateListener as EventListener)\n      }\n\n      this.darkModeObserver?.disconnect()\n      this.darkModeObserver = null\n\n      this.reactRoot?.unmount()\n      this.reactRoot = null\n    }\n\n    attributeChangedCallback(_name: string, oldValue: string | null, newValue: string | null): void {\n      if (oldValue === newValue) return\n      if (this.container) this.renderReact()\n    }\n\n    private getHostConfig(): AppletHostConfig {\n      const attrs: Record<string, string> = {}\n      for (const { name, value } of Array.from(this.attributes)) {\n        attrs[name] = value\n      }\n\n      const basePath = this.getAttribute('base-path') ?? ''\n      const shellMode = (this.getAttribute('shell-mode') as ShellMode | null) ?? undefined\n      const routerMode = (this.getAttribute('router-mode') as RouterMode | null) ?? 'url'\n\n      return { basePath, shellMode, routerMode, attrs }\n    }\n\n    private renderReact(): void {\n      if (!this.container) return\n\n      if (!this.reactRoot) {\n        this.reactRoot = createRoot(this.container)\n      }\n\n      try {\n        this.reactRoot.render(getEntry().options.render(this.getHostConfig()))\n      } catch (err) {\n        console.error(`[${tagName}] failed to mount React app:`, err)\n      }\n    }\n\n    private syncFromRegistry(): void {\n      const entry = getEntry()\n\n      const styles = typeof entry.options.styles === 'function' ? entry.options.styles() : entry.options.styles\n      if (styles) {\n        this.styleEl ??= document.createElement('style')\n        this.styleEl.textContent = styles\n        if (this.shadowRoot && !this.shadowRoot.contains(this.styleEl)) {\n          this.shadowRoot.insertBefore(this.styleEl, this.shadowRoot.firstChild)\n        }\n      } else if (this.styleEl) {\n        this.styleEl.remove()\n        this.styleEl = null\n      }\n\n      if (entry.options.observeDarkMode !== false) {\n        this.darkModeObserver ??= this.syncDarkMode()\n      } else if (this.darkModeObserver) {\n        this.darkModeObserver.disconnect()\n        this.darkModeObserver = null\n      }\n    }\n\n    private syncDarkMode(): MutationObserver {\n      const root = this.container\n      if (!root) throw new Error('react root container not found')\n\n      const apply = () => {\n        if (document.documentElement.classList.contains('dark')) root.classList.add('dark')\n        else root.classList.remove('dark')\n      }\n\n      apply()\n\n      const observer = new MutationObserver(apply)\n      observer.observe(document.documentElement, { attributes: true, attributeFilter: ['class'] })\n      return observer\n    }\n  }\n\n  customElements.define(tagName, ReactAppletElement)\n}\n\nfunction getRegistry(): Map<string, RegistryEntry> {\n  const anyGlobal = globalThis as any\n  anyGlobal.__IOTA_REACT_APPLET_HOST_REGISTRY__ ??= new Map<string, RegistryEntry>()\n  return anyGlobal.__IOTA_REACT_APPLET_HOST_REGISTRY__ as Map<string, RegistryEntry>\n}\n","export function shouldEnableAppletDevtools(): boolean {\n  if (typeof window === 'undefined') return false\n\n  const url = new URL(window.location.href)\n  if (url.searchParams.get('appletDebug') === '1') return true\n\n  try {\n    return window.localStorage.getItem('iotaAppletDevtools') === '1'\n  } catch {\n    return false\n  }\n}\n\n","import { shouldEnableAppletDevtools } from '../applet-devtools/enabled'\n\nexport interface AppletRPCError {\n  code: string\n  message: string\n  details?: unknown\n}\n\nexport class AppletRPCException extends Error {\n  code: string\n  details?: unknown\n  cause?: unknown\n\n  constructor(args: { code: string; message: string; details?: unknown; cause?: unknown }) {\n    super(args.message)\n    this.name = 'AppletRPCException'\n    this.code = args.code\n    this.details = args.details\n    this.cause = args.cause\n  }\n}\n\nexport type AppletRPCSchema = Record<string, { params: unknown; result: unknown }>\n\ninterface RPCRequest {\n  id: string\n  method: string\n  params: unknown\n}\n\ninterface RPCResponse<TResult> {\n  id: string\n  result?: TResult\n  error?: AppletRPCError\n}\n\nexport interface CreateAppletRPCClientOptions {\n  endpoint: string\n  fetcher?: typeof fetch\n}\n\nexport function createAppletRPCClient(options: CreateAppletRPCClientOptions) {\n  const fetcher = options.fetcher ?? fetch\n\n  async function call<TParams, TResult>(method: string, params: TParams): Promise<TResult> {\n    const req: RPCRequest = { id: crypto.randomUUID(), method, params }\n    const startedAt = typeof performance !== 'undefined' ? performance.now() : Date.now()\n    maybeDispatchRPCEvent({\n      id: req.id,\n      method: req.method,\n      status: 'start',\n    })\n\n    try {\n      const resp = await fetcher(options.endpoint, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(req),\n      })\n\n      if (!resp.ok) {\n        throw new AppletRPCException({\n          code: 'http_error',\n          message: `HTTP ${resp.status}`,\n          details: { status: resp.status },\n        })\n      }\n\n      const json = (await resp.json()) as RPCResponse<TResult>\n      if (json.error) {\n        throw new AppletRPCException({\n          code: json.error.code,\n          message: json.error.message,\n          details: json.error.details,\n        })\n      }\n\n      if (json.result === undefined) {\n        throw new AppletRPCException({\n          code: 'invalid_response',\n          message: 'Missing result in successful response',\n        })\n      }\n\n      maybeDispatchRPCEvent({\n        id: req.id,\n        method: req.method,\n        status: 'success',\n        durationMs: elapsedMs(startedAt),\n      })\n\n      return json.result as TResult\n    } catch (err) {\n      maybeDispatchRPCEvent({\n        id: req.id,\n        method: req.method,\n        status: 'error',\n        durationMs: elapsedMs(startedAt),\n        error: err,\n      })\n      throw err\n    }\n  }\n\n  async function callTyped<\n    TRouter extends AppletRPCSchema,\n    TMethod extends keyof TRouter & string,\n  >(method: TMethod, params: TRouter[TMethod]['params']): Promise<TRouter[TMethod]['result']> {\n    return call(method, params) as Promise<TRouter[TMethod]['result']>\n  }\n\n  return { call, callTyped }\n}\n\ntype RPCDevEvent = {\n  id: string\n  method: string\n  status: 'start' | 'success' | 'error'\n  durationMs?: number\n  error?: unknown\n}\n\nfunction maybeDispatchRPCEvent(detail: RPCDevEvent) {\n  if (typeof window === 'undefined') return\n\n  if (!shouldEnableAppletDevtools()) return\n\n  window.dispatchEvent(new CustomEvent('iota:applet-rpc', { detail }))\n}\n\nfunction elapsedMs(startedAt: number): number {\n  const now = typeof performance !== 'undefined' ? performance.now() : Date.now()\n  return Math.max(0, Math.round(now - startedAt))\n}\n","import type React from 'react'\n\nexport type RouterMode = 'url' | 'memory'\n\nexport interface CreateAppletRouterOptions {\n  mode: RouterMode\n  basePath?: string\n  BrowserRouter: React.ComponentType<any>\n  MemoryRouter: React.ComponentType<any>\n}\n\nexport function createAppletRouter(options: CreateAppletRouterOptions) {\n  const basePath = options.basePath ?? ''\n\n  const Router: React.FC<React.PropsWithChildren> = ({ children }) => {\n    if (options.mode === 'memory') {\n      const MemoryRouter = options.MemoryRouter\n      return <MemoryRouter>{children}</MemoryRouter>\n    }\n\n    const BrowserRouter = options.BrowserRouter\n    return <BrowserRouter basename={basePath}>{children}</BrowserRouter>\n  }\n\n  return { Router }\n}\n\n"]}

package/dist/applet/host.d.cts

@@ -0,0 +1,62 @@
+import react__default from 'react';
+
+type RouterMode$1 = 'url' | 'memory';
+type ShellMode = 'embedded' | 'standalone';
+interface AppletHostConfig {
+    basePath: string;
+    shellMode?: ShellMode;
+    routerMode: RouterMode$1;
+    attrs: Record<string, string>;
+}
+interface DefineReactAppletElementOptions {
+    tagName: string;
+    styles?: string | (() => string);
+    render: (host: AppletHostConfig) => react__default.ReactElement;
+    observedAttributes?: string[];
+    observeDarkMode?: boolean;
+}
+declare function defineReactAppletElement(options: DefineReactAppletElementOptions): void;
+
+interface AppletRPCError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+declare class AppletRPCException extends Error {
+    code: string;
+    details?: unknown;
+    cause?: unknown;
+    constructor(args: {
+        code: string;
+        message: string;
+        details?: unknown;
+        cause?: unknown;
+    });
+}
+type AppletRPCSchema = Record<string, {
+    params: unknown;
+    result: unknown;
+}>;
+interface CreateAppletRPCClientOptions {
+    endpoint: string;
+    fetcher?: typeof fetch;
+}
+declare function createAppletRPCClient(options: CreateAppletRPCClientOptions): {
+    call: <TParams, TResult>(method: string, params: TParams) => Promise<TResult>;
+    callTyped: <TRouter extends AppletRPCSchema, TMethod extends keyof TRouter & string>(method: TMethod, params: TRouter[TMethod]["params"]) => Promise<TRouter[TMethod]["result"]>;
+};
+
+type RouterMode = 'url' | 'memory';
+interface CreateAppletRouterOptions {
+    mode: RouterMode;
+    basePath?: string;
+    BrowserRouter: react__default.ComponentType<any>;
+    MemoryRouter: react__default.ComponentType<any>;
+}
+declare function createAppletRouter(options: CreateAppletRouterOptions): {
+    Router: react__default.FC<{
+        children?: react__default.ReactNode | undefined;
+    }>;
+};
+
+export { type AppletRPCError, AppletRPCException, type AppletRPCSchema, type RouterMode, createAppletRPCClient, createAppletRouter, defineReactAppletElement };

package/dist/applet/host.d.ts

@@ -0,0 +1,62 @@
+import react__default from 'react';
+
+type RouterMode$1 = 'url' | 'memory';
+type ShellMode = 'embedded' | 'standalone';
+interface AppletHostConfig {
+    basePath: string;
+    shellMode?: ShellMode;
+    routerMode: RouterMode$1;
+    attrs: Record<string, string>;
+}
+interface DefineReactAppletElementOptions {
+    tagName: string;
+    styles?: string | (() => string);
+    render: (host: AppletHostConfig) => react__default.ReactElement;
+    observedAttributes?: string[];
+    observeDarkMode?: boolean;
+}
+declare function defineReactAppletElement(options: DefineReactAppletElementOptions): void;
+
+interface AppletRPCError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+declare class AppletRPCException extends Error {
+    code: string;
+    details?: unknown;
+    cause?: unknown;
+    constructor(args: {
+        code: string;
+        message: string;
+        details?: unknown;
+        cause?: unknown;
+    });
+}
+type AppletRPCSchema = Record<string, {
+    params: unknown;
+    result: unknown;
+}>;
+interface CreateAppletRPCClientOptions {
+    endpoint: string;
+    fetcher?: typeof fetch;
+}
+declare function createAppletRPCClient(options: CreateAppletRPCClientOptions): {
+    call: <TParams, TResult>(method: string, params: TParams) => Promise<TResult>;
+    callTyped: <TRouter extends AppletRPCSchema, TMethod extends keyof TRouter & string>(method: TMethod, params: TRouter[TMethod]["params"]) => Promise<TRouter[TMethod]["result"]>;
+};
+
+type RouterMode = 'url' | 'memory';
+interface CreateAppletRouterOptions {
+    mode: RouterMode;
+    basePath?: string;
+    BrowserRouter: react__default.ComponentType<any>;
+    MemoryRouter: react__default.ComponentType<any>;
+}
+declare function createAppletRouter(options: CreateAppletRouterOptions): {
+    Router: react__default.FC<{
+        children?: react__default.ReactNode | undefined;
+    }>;
+};
+
+export { type AppletRPCError, AppletRPCException, type AppletRPCSchema, type RouterMode, createAppletRPCClient, createAppletRouter, defineReactAppletElement };