@tangle-network/blueprint-ui 0.3.1 → 0.4.0

package/dist/iframe/index.js

@@ -0,0 +1,489 @@
+import {
+  NO_WALLET_ADDRESS,
+  TANGLE_CLOUD_ORIGINS_DEFAULT,
+  TANGLE_IFRAME_PROTOCOL_VERSION,
+  detectTangleCloudParentOrigin,
+  makeCorrelationId
+} from "../chunk-BLXSBQU4.js";
+
+// src/iframe/TangleIframeProvider.tsx
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef,
+  useState
+} from "react";
+
+// src/iframe/tangleIframeClient.ts
+var DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
+var NULL_WALLET = {
+  address: null,
+  chainId: null,
+  isConnected: false
+};
+var NULL_SERVICE = {
+  blueprintId: null,
+  serviceId: null,
+  operators: [],
+  jobs: [],
+  mode: null
+};
+var TangleIframeClient = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  wallet = NULL_WALLET;
+  service = NULL_SERVICE;
+  handshakeAcked = false;
+  handshakeWaiters = [];
+  installed = false;
+  listeners = {
+    wallet: /* @__PURE__ */ new Set(),
+    service: /* @__PURE__ */ new Set(),
+    job: /* @__PURE__ */ new Set()
+  };
+  pendingJobs = /* @__PURE__ */ new Map();
+  /** Wire the global message listener + initial handshake. Idempotent. */
+  install() {
+    if (this.installed || typeof window === "undefined") return;
+    this.installed = true;
+    window.addEventListener("message", this.handleParentMessage);
+    this.postHandshake();
+  }
+  uninstall() {
+    if (!this.installed || typeof window === "undefined") return;
+    this.installed = false;
+    window.removeEventListener("message", this.handleParentMessage);
+    for (const [, pending] of this.pendingJobs) {
+      clearTimeout(pending.timer);
+      pending.reject(new Error("Tangle iframe client uninstalled"));
+    }
+    this.pendingJobs.clear();
+  }
+  // ── State accessors ─────────────────────────────────────────────────────
+  getWallet() {
+    return this.wallet;
+  }
+  getService() {
+    return this.service;
+  }
+  // ── Subscription API (used by React hooks) ──────────────────────────────
+  subscribe(event, listener) {
+    this.listeners[event].add(listener);
+    return () => {
+      this.listeners[event].delete(listener);
+    };
+  }
+  // ── Wallet operations ───────────────────────────────────────────────────
+  async signMessage(message) {
+    await this.ensureBootstrapped();
+    return this.dispatchWallet("tangle.app.signMessage", {
+      chainId: this.wallet.chainId ?? 0,
+      message
+    }).then((data) => data.signature);
+  }
+  async sendTransaction(tx) {
+    await this.ensureBootstrapped();
+    return this.dispatchWallet("tangle.app.signTransaction", {
+      chainId: this.wallet.chainId ?? 0,
+      to: tx.to,
+      data: tx.data,
+      ...tx.value !== void 0 ? { value: tx.value.toString(10) } : {}
+    }).then((data) => data.txHash);
+  }
+  async switchChain(chainId) {
+    await this.ensureBootstrapped();
+    return this.dispatchWallet("tangle.app.switchChain", { chainId }).then(
+      (data) => data.chainId
+    );
+  }
+  // ── Job invocation ──────────────────────────────────────────────────────
+  /**
+   * Invoke a blueprint job. Returns a Promise that resolves on terminal
+   * status (`success` or `error`); subscribe to the `job` event for
+   * intermediate streaming chunks.
+   *
+   * Streaming opt-in: pass `stream: true` if the publisher's job emits
+   * chunks (LLM generation, video encoding). One-shot jobs (embeddings,
+   * classifications) skip the streaming machinery.
+   */
+  async callJob(args) {
+    await this.ensureBootstrapped();
+    const correlationId = makeCorrelationId("tangle.app.callJob");
+    const timeout = this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    return new Promise((resolve, reject) => {
+      const invocation = {
+        correlationId,
+        status: "pending",
+        chunks: []
+      };
+      const timer = setTimeout(() => {
+        this.pendingJobs.delete(correlationId);
+        reject(
+          bridgeError(4900, `Job did not respond within ${timeout}ms`)
+        );
+      }, timeout);
+      this.pendingJobs.set(correlationId, {
+        resolve,
+        reject,
+        timer,
+        invocation
+      });
+      const message = {
+        kind: "tangle.app.callJob",
+        correlationId,
+        jobIndex: args.jobIndex,
+        inputs: args.inputs,
+        ...args.stream !== void 0 ? { stream: args.stream } : {}
+      };
+      this.postToParent(message);
+      this.emit("job", invocation);
+    });
+  }
+  // ── Internals ───────────────────────────────────────────────────────────
+  postHandshake() {
+    this.postToParent({
+      kind: "tangle.app.handshake",
+      appId: this.options.appId,
+      version: TANGLE_IFRAME_PROTOCOL_VERSION
+    });
+  }
+  postToParent(message) {
+    if (typeof window === "undefined") return;
+    try {
+      window.parent.postMessage(message, this.options.parentOrigin);
+    } catch {
+    }
+  }
+  handleParentMessage = (event) => {
+    if (event.origin !== this.options.parentOrigin) return;
+    const data = event.data;
+    if (typeof data !== "object" || data === null) return;
+    const message = data;
+    switch (message.kind) {
+      case "tangle.app.handshakeAck":
+        this.handshakeAcked = true;
+        for (const resolve of this.handshakeWaiters) resolve();
+        this.handshakeWaiters = [];
+        return;
+      case "tangle.app.readAccountResult":
+        if (message.ok) {
+          this.updateWallet({
+            address: message.data.account === NO_WALLET_ADDRESS ? null : message.data.account,
+            chainId: message.data.chainId,
+            isConnected: message.data.account !== NO_WALLET_ADDRESS
+          });
+        }
+        return;
+      case "tangle.app.accountChanged":
+        this.updateWallet({
+          address: message.account,
+          chainId: this.wallet.chainId,
+          isConnected: message.account !== null
+        });
+        return;
+      case "tangle.app.chainChanged":
+        this.updateWallet({
+          address: this.wallet.address,
+          chainId: message.chainId,
+          isConnected: this.wallet.isConnected
+        });
+        return;
+      case "tangle.app.serviceContext":
+        this.updateService(message);
+        return;
+      case "tangle.app.jobResult":
+        this.handleJobResult(message);
+        return;
+      // Wallet-shape responses (signMessageResult etc.) are routed by
+      // dispatchWallet's promise resolver, not here.
+      default:
+        return;
+    }
+  };
+  async dispatchWallet(kind, payload) {
+    return new Promise((resolve, reject) => {
+      const correlationId = makeCorrelationId(kind);
+      const timeout = this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+      const expectedKind = {
+        "tangle.app.signMessage": "tangle.app.signMessageResult",
+        "tangle.app.signTransaction": "tangle.app.signTransactionResult",
+        "tangle.app.switchChain": "tangle.app.switchChainResult"
+      }[kind];
+      const timer = setTimeout(() => {
+        window.removeEventListener("message", listener);
+        reject(bridgeError(4900, `Parent did not respond to ${kind} in ${timeout}ms`));
+      }, timeout);
+      const listener = (event) => {
+        if (event.origin !== this.options.parentOrigin) return;
+        const data = event.data;
+        if (typeof data !== "object" || data === null) return;
+        const msg = data;
+        if (msg.kind !== expectedKind || !("correlationId" in msg) || msg.correlationId !== correlationId) {
+          return;
+        }
+        clearTimeout(timer);
+        window.removeEventListener("message", listener);
+        const env = msg;
+        if (env.ok) {
+          resolve(env.data);
+        } else {
+          reject(bridgeError(4001, env.error ?? "Parent rejected request"));
+        }
+      };
+      window.addEventListener("message", listener);
+      this.postToParent({ kind, correlationId, ...payload });
+    });
+  }
+  handleJobResult(message) {
+    const pending = this.pendingJobs.get(message.correlationId);
+    if (!pending) return;
+    const updated = {
+      correlationId: message.correlationId,
+      status: message.status,
+      chunks: message.chunk !== void 0 ? [...pending.invocation.chunks, message.chunk] : pending.invocation.chunks,
+      ...message.data !== void 0 ? { data: message.data } : {},
+      ...message.error !== void 0 ? { error: message.error } : {},
+      ...message.progress !== void 0 ? { progress: message.progress } : {}
+    };
+    pending.invocation = updated;
+    this.emit("job", updated);
+    if (message.status === "success" || message.status === "error") {
+      clearTimeout(pending.timer);
+      this.pendingJobs.delete(message.correlationId);
+      if (message.status === "success") {
+        pending.resolve(updated);
+      } else {
+        pending.reject(bridgeError(4001, message.error ?? "Job failed"));
+      }
+    }
+  }
+  updateWallet(next) {
+    if (this.wallet.address === next.address && this.wallet.chainId === next.chainId && this.wallet.isConnected === next.isConnected) {
+      return;
+    }
+    this.wallet = next;
+    this.emit("wallet", next);
+  }
+  updateService(broadcast) {
+    const next = {
+      blueprintId: broadcast.blueprintId,
+      serviceId: broadcast.serviceId,
+      operators: broadcast.operators,
+      jobs: broadcast.jobs,
+      mode: broadcast.mode
+    };
+    this.service = next;
+    this.emit("service", next);
+  }
+  emit(event, value) {
+    for (const listener of [...this.listeners[event]]) {
+      try {
+        listener(value);
+      } catch {
+      }
+    }
+  }
+  async ensureBootstrapped() {
+    if (this.handshakeAcked) return;
+    this.install();
+    await new Promise((resolve) => {
+      this.handshakeWaiters.push(resolve);
+      const retry = setInterval(() => {
+        if (this.handshakeAcked) {
+          clearInterval(retry);
+          return;
+        }
+        this.postHandshake();
+      }, 500);
+      setTimeout(() => clearInterval(retry), 1e4);
+    });
+  }
+};
+function bridgeError(code, message) {
+  const err = new Error(message);
+  err.code = code;
+  return err;
+}
+
+// src/iframe/TangleIframeProvider.tsx
+import { jsx } from "react/jsx-runtime";
+var TangleIframeContext = createContext(null);
+var NULL_WALLET2 = {
+  address: null,
+  chainId: null,
+  isConnected: false
+};
+var NULL_SERVICE2 = {
+  blueprintId: null,
+  serviceId: null,
+  operators: [],
+  jobs: [],
+  mode: null
+};
+function TangleIframeProvider({
+  appId,
+  parentOrigin: explicitOrigin,
+  extraOrigins,
+  mode: requestedMode = "auto",
+  children
+}) {
+  const resolution = useMemo(() => {
+    if (requestedMode === "dev") {
+      return { mode: "dev", parentOrigin: null };
+    }
+    const detected = explicitOrigin ?? detectTangleCloudParentOrigin({ extraOrigins });
+    if (requestedMode === "bridge") {
+      if (!detected) {
+        console.error(
+          '[TangleIframeProvider] mode="bridge" but no trusted parent was detected. Falling back to dev mode.'
+        );
+        return { mode: "dev", parentOrigin: null };
+      }
+      return { mode: "bridge", parentOrigin: detected };
+    }
+    return detected ? { mode: "bridge", parentOrigin: detected } : { mode: "dev", parentOrigin: null };
+  }, [requestedMode, explicitOrigin, extraOrigins]);
+  const clientRef = useRef(null);
+  const [wallet, setWallet] = useState(NULL_WALLET2);
+  const [service, setService] = useState(NULL_SERVICE2);
+  const [isReady, setIsReady] = useState(false);
+  useEffect(() => {
+    if (resolution.mode === "dev") {
+      setIsReady(true);
+      return void 0;
+    }
+    const options = {
+      parentOrigin: resolution.parentOrigin,
+      appId
+    };
+    const client = new TangleIframeClient(options);
+    clientRef.current = client;
+    const unsubWallet = client.subscribe("wallet", setWallet);
+    const unsubService = client.subscribe("service", setService);
+    client.install();
+    setIsReady(true);
+    return () => {
+      unsubWallet();
+      unsubService();
+      client.uninstall();
+      clientRef.current = null;
+      setIsReady(false);
+    };
+  }, [resolution, appId]);
+  const value = useMemo(
+    () => ({
+      client: clientRef.current,
+      wallet,
+      service,
+      mode: resolution.mode,
+      isReady
+    }),
+    [wallet, service, resolution.mode, isReady]
+  );
+  return /* @__PURE__ */ jsx(TangleIframeContext.Provider, { value, children });
+}
+function useTangleIframeContext() {
+  const ctx = useContext(TangleIframeContext);
+  if (!ctx) {
+    throw new Error(
+      "useTangleIframeContext must be used inside <TangleIframeProvider>."
+    );
+  }
+  return ctx;
+}
+
+// src/iframe/hooks.ts
+import { useCallback, useEffect as useEffect2, useMemo as useMemo2, useState as useState2 } from "react";
+function useTangleWallet() {
+  const { client, wallet } = useTangleIframeContext();
+  const signMessage = useCallback(
+    (message) => {
+      if (!client) throw new Error("Wallet not available in dev mode.");
+      return client.signMessage(message);
+    },
+    [client]
+  );
+  const sendTransaction = useCallback(
+    (tx) => {
+      if (!client) throw new Error("Wallet not available in dev mode.");
+      return client.sendTransaction(tx);
+    },
+    [client]
+  );
+  const switchChain = useCallback(
+    (chainId) => {
+      if (!client) throw new Error("Wallet not available in dev mode.");
+      return client.switchChain(chainId);
+    },
+    [client]
+  );
+  return { ...wallet, signMessage, sendTransaction, switchChain };
+}
+function useTangleService() {
+  return useTangleIframeContext().service;
+}
+function useCallJob() {
+  const { client } = useTangleIframeContext();
+  const [invocation, setInvocation] = useState2(null);
+  const [latestId, setLatestId] = useState2(null);
+  useEffect2(() => {
+    if (!client) return void 0;
+    return client.subscribe("job", (next) => {
+      setLatestId((prevLatest) => {
+        if (prevLatest === null || prevLatest === next.correlationId) {
+          setInvocation(next);
+          return next.correlationId;
+        }
+        return prevLatest;
+      });
+    });
+  }, [client]);
+  const call = useCallback(
+    async (args) => {
+      if (!client) {
+        throw new Error(
+          "Job invocation not available in dev mode without a configured stub. See `setDevJobHandler` in the testing harness."
+        );
+      }
+      setInvocation(null);
+      const result = await client.callJob(args);
+      setLatestId(result.correlationId);
+      return result;
+    },
+    [client]
+  );
+  const reset = useCallback(() => {
+    setInvocation(null);
+    setLatestId(null);
+  }, []);
+  return useMemo2(
+    () => ({ call, invocation, reset, isPending: invocation?.status === "pending" || invocation?.status === "streaming" }),
+    [call, invocation, reset]
+  );
+}
+function useTangleAddress() {
+  return useTangleIframeContext().wallet.address;
+}
+function useTangleReady() {
+  return useTangleIframeContext().isReady;
+}
+function useTangleMode() {
+  return useTangleIframeContext().mode;
+}
+export {
+  TANGLE_CLOUD_ORIGINS_DEFAULT,
+  TangleIframeClient,
+  TangleIframeProvider,
+  useCallJob,
+  useTangleAddress,
+  useTangleIframeContext,
+  useTangleMode,
+  useTangleReady,
+  useTangleService,
+  useTangleWallet
+};
+//# sourceMappingURL=index.js.map

package/dist/iframe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/iframe/TangleIframeProvider.tsx","../../src/iframe/tangleIframeClient.ts","../../src/iframe/hooks.ts"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\n\nimport {\n  TangleIframeClient,\n  type ServiceSnapshot,\n  type TangleIframeClientOptions,\n  type WalletSnapshot,\n} from './tangleIframeClient';\nimport {\n  detectTangleCloudParentOrigin,\n  TANGLE_CLOUD_ORIGINS_DEFAULT,\n} from '../wallet/detectParentOrigin';\n\ntype Props = {\n  appId: string;\n  /** Override the detected parent origin (e.g. dev/staging deploys). */\n  parentOrigin?: string;\n  /** Extra trusted origins for `detectTangleCloudParentOrigin`. */\n  extraOrigins?: readonly string[];\n  /**\n   * Override the bootstrap behavior. When `'auto'` (default), the SDK\n   * sniffs the embed context: real parent → install the bridge, top-frame\n   * → drop into dev mode. `'bridge'` forces real-parent mode and throws\n   * if no parent is detected. `'dev'` forces dev mode even when embedded\n   * — useful for component-level tests.\n   */\n  mode?: 'auto' | 'bridge' | 'dev';\n  children: ReactNode;\n};\n\ntype ContextValue = {\n  readonly client: TangleIframeClient | null;\n  readonly wallet: WalletSnapshot;\n  readonly service: ServiceSnapshot;\n  readonly mode: 'bridge' | 'dev';\n  readonly isReady: boolean;\n};\n\nconst TangleIframeContext = createContext<ContextValue | null>(null);\n\nconst NULL_WALLET: WalletSnapshot = {\n  address: null,\n  chainId: null,\n  isConnected: false,\n};\nconst NULL_SERVICE: ServiceSnapshot = {\n  blueprintId: null,\n  serviceId: null,\n  operators: [],\n  jobs: [],\n  mode: null,\n};\n\n/**\n * Iframe-blueprint root provider. Wrap your app once at the entry point.\n *\n * In `auto` mode (default) the SDK detects whether the app is embedded by a\n * trusted Tangle Cloud parent. If yes → installs the postMessage bridge.\n * If no (running standalone at `localhost:5173` etc.) → enters **dev mode**\n * with an in-memory state machine that the developer can drive via the\n * exported debug controls. Dev mode keeps the hook surface identical to\n * production so component code never branches on embed-vs-not.\n *\n * Three lifecycle stages:\n *\n *   1. Mount — `client` is created, mode is decided.\n *   2. Bootstrap — handshake (bridge) or first-paint setup (dev). The\n *      `isReady` flag flips to true.\n *   3. Active — wallet + service snapshots flow in via subscriptions.\n */\nexport function TangleIframeProvider({\n  appId,\n  parentOrigin: explicitOrigin,\n  extraOrigins,\n  mode: requestedMode = 'auto',\n  children,\n}: Props) {\n  // Resolve the effective mode once at mount. Switching modes mid-session\n  // would tear down the bridge / dev state inconsistently; restart instead.\n  const resolution = useMemo(() => {\n    if (requestedMode === 'dev') {\n      return { mode: 'dev' as const, parentOrigin: null };\n    }\n    const detected =\n      explicitOrigin ?? detectTangleCloudParentOrigin({ extraOrigins });\n    if (requestedMode === 'bridge') {\n      if (!detected) {\n        // eslint-disable-next-line no-console\n        console.error(\n          '[TangleIframeProvider] mode=\"bridge\" but no trusted parent was detected. Falling back to dev mode.',\n        );\n        return { mode: 'dev' as const, parentOrigin: null };\n      }\n      return { mode: 'bridge' as const, parentOrigin: detected };\n    }\n    // auto: bridge when detected, dev otherwise.\n    return detected\n      ? { mode: 'bridge' as const, parentOrigin: detected }\n      : { mode: 'dev' as const, parentOrigin: null };\n  }, [requestedMode, explicitOrigin, extraOrigins]);\n\n  const clientRef = useRef<TangleIframeClient | null>(null);\n  const [wallet, setWallet] = useState<WalletSnapshot>(NULL_WALLET);\n  const [service, setService] = useState<ServiceSnapshot>(NULL_SERVICE);\n  const [isReady, setIsReady] = useState(false);\n\n  useEffect(() => {\n    if (resolution.mode === 'dev') {\n      // Dev mode: no bridge. The DevHarness component (or a test) seeds\n      // wallet + service via `setDevWallet` / `setDevService` on the\n      // returned context. Mark ready immediately so app code unblocks.\n      setIsReady(true);\n      return undefined;\n    }\n    // Bridge mode\n    const options: TangleIframeClientOptions = {\n      parentOrigin: resolution.parentOrigin,\n      appId,\n    };\n    const client = new TangleIframeClient(options);\n    clientRef.current = client;\n    const unsubWallet = client.subscribe('wallet', setWallet);\n    const unsubService = client.subscribe('service', setService);\n    client.install();\n    setIsReady(true);\n    return () => {\n      unsubWallet();\n      unsubService();\n      client.uninstall();\n      clientRef.current = null;\n      setIsReady(false);\n    };\n  }, [resolution, appId]);\n\n  const value = useMemo<ContextValue>(\n    () => ({\n      client: clientRef.current,\n      wallet,\n      service,\n      mode: resolution.mode,\n      isReady,\n    }),\n    [wallet, service, resolution.mode, isReady],\n  );\n\n  return (\n    <TangleIframeContext.Provider value={value}>\n      {children}\n    </TangleIframeContext.Provider>\n  );\n}\n\nexport function useTangleIframeContext(): ContextValue {\n  const ctx = useContext(TangleIframeContext);\n  if (!ctx) {\n    throw new Error(\n      'useTangleIframeContext must be used inside <TangleIframeProvider>.',\n    );\n  }\n  return ctx;\n}\n\nexport { TANGLE_CLOUD_ORIGINS_DEFAULT };\n","// Thin-iframe SDK client — the framework-agnostic state machine that talks\n// to a Tangle Cloud parent dapp over postMessage. React hooks (below) are\n// thin wrappers around an instance of this class.\n//\n// Why a class, not a bag of functions: the iframe lifecycle is stateful —\n// handshake, account changes, service-context broadcasts, in-flight job\n// requests. The class owns that state once; hooks subscribe via listeners.\n// Testing the protocol shape doesn't require React.\n\nimport type { Address, Hex } from 'viem';\n\nimport {\n  makeCorrelationId,\n  NO_WALLET_ADDRESS,\n  TANGLE_IFRAME_PROTOCOL_VERSION,\n  type CallJobRequest,\n  type JobInputs,\n  type JobResultEvent,\n  type JobResultStatus,\n  type ParentMessage,\n  type ServiceContextBroadcast,\n  type ServiceContextJob,\n  type ServiceContextOperator,\n} from '../wallet/parentBridgeProtocol';\n\nexport type WalletSnapshot = {\n  readonly address: Address | null;\n  readonly chainId: number | null;\n  readonly isConnected: boolean;\n};\n\nexport type ServiceSnapshot = {\n  readonly blueprintId: string | null;\n  readonly serviceId: string | null;\n  readonly operators: readonly ServiceContextOperator[];\n  readonly jobs: readonly ServiceContextJob[];\n  readonly mode: string | null;\n};\n\nexport type JobInvocation = {\n  readonly correlationId: string;\n  readonly status: JobResultStatus;\n  readonly data?: unknown;\n  readonly chunks: readonly unknown[];\n  readonly error?: string;\n  readonly progress?: { readonly percent?: number; readonly eta_ms?: number };\n};\n\nexport type ClientEventMap = {\n  wallet: WalletSnapshot;\n  service: ServiceSnapshot;\n  job: JobInvocation;\n};\n\ntype Listener<K extends keyof ClientEventMap> = (\n  value: ClientEventMap[K],\n) => void;\n\nexport type TangleIframeClientOptions = {\n  /**\n   * Origin of the parent dapp. The client posts every message with this\n   * exact `targetOrigin` and rejects inbound messages from any other origin.\n   * Pass `'*'` only in dev — production must pin to the real parent\n   * (`https://cloud.tangle.tools` etc.).\n   */\n  parentOrigin: string;\n  /**\n   * Stable identifier for this iframe app. The parent surfaces it in\n   * handshake logs + uses it for permission scoping.\n   */\n  appId: string;\n  /**\n   * Per-request timeout. Defaults to 60s — long enough for a user to\n   * read + approve a signing prompt in the parent. Long-running jobs\n   * stream progress events; the request \"completes\" only on terminal\n   * status, so the timeout protects against parents that drop replies\n   * entirely.\n   */\n  requestTimeoutMs?: number;\n};\n\nconst DEFAULT_REQUEST_TIMEOUT_MS = 60_000;\nconst NULL_WALLET: WalletSnapshot = {\n  address: null,\n  chainId: null,\n  isConnected: false,\n};\nconst NULL_SERVICE: ServiceSnapshot = {\n  blueprintId: null,\n  serviceId: null,\n  operators: [],\n  jobs: [],\n  mode: null,\n};\n\ntype PendingJob = {\n  resolve: (value: JobInvocation) => void;\n  reject: (reason: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n  invocation: JobInvocation;\n};\n\nexport class TangleIframeClient {\n  private wallet: WalletSnapshot = NULL_WALLET;\n  private service: ServiceSnapshot = NULL_SERVICE;\n  private handshakeAcked = false;\n  private handshakeWaiters: Array<() => void> = [];\n  private installed = false;\n  private listeners: {\n    [K in keyof ClientEventMap]: Set<Listener<K>>;\n  } = {\n    wallet: new Set(),\n    service: new Set(),\n    job: new Set(),\n  };\n  private pendingJobs = new Map<string, PendingJob>();\n\n  constructor(private readonly options: TangleIframeClientOptions) {}\n\n  /** Wire the global message listener + initial handshake. Idempotent. */\n  install(): void {\n    if (this.installed || typeof window === 'undefined') return;\n    this.installed = true;\n    window.addEventListener('message', this.handleParentMessage);\n    this.postHandshake();\n  }\n\n  uninstall(): void {\n    if (!this.installed || typeof window === 'undefined') return;\n    this.installed = false;\n    window.removeEventListener('message', this.handleParentMessage);\n    for (const [, pending] of this.pendingJobs) {\n      clearTimeout(pending.timer);\n      pending.reject(new Error('Tangle iframe client uninstalled'));\n    }\n    this.pendingJobs.clear();\n  }\n\n  // ── State accessors ─────────────────────────────────────────────────────\n\n  getWallet(): WalletSnapshot {\n    return this.wallet;\n  }\n  getService(): ServiceSnapshot {\n    return this.service;\n  }\n\n  // ── Subscription API (used by React hooks) ──────────────────────────────\n\n  subscribe<K extends keyof ClientEventMap>(\n    event: K,\n    listener: Listener<K>,\n  ): () => void {\n    this.listeners[event].add(listener);\n    return () => {\n      this.listeners[event].delete(listener);\n    };\n  }\n\n  // ── Wallet operations ───────────────────────────────────────────────────\n\n  async signMessage(message: string): Promise<Hex> {\n    await this.ensureBootstrapped();\n    return this.dispatchWallet('tangle.app.signMessage', {\n      chainId: this.wallet.chainId ?? 0,\n      message,\n    }).then((data) => (data as { signature: Hex }).signature);\n  }\n\n  async sendTransaction(tx: {\n    to: Address;\n    data: Hex;\n    value?: bigint;\n  }): Promise<Hex> {\n    await this.ensureBootstrapped();\n    return this.dispatchWallet('tangle.app.signTransaction', {\n      chainId: this.wallet.chainId ?? 0,\n      to: tx.to,\n      data: tx.data,\n      ...(tx.value !== undefined ? { value: tx.value.toString(10) } : {}),\n    }).then((data) => (data as { txHash: Hex }).txHash);\n  }\n\n  async switchChain(chainId: number): Promise<number> {\n    await this.ensureBootstrapped();\n    return this.dispatchWallet('tangle.app.switchChain', { chainId }).then(\n      (data) => (data as { chainId: number }).chainId,\n    );\n  }\n\n  // ── Job invocation ──────────────────────────────────────────────────────\n\n  /**\n   * Invoke a blueprint job. Returns a Promise that resolves on terminal\n   * status (`success` or `error`); subscribe to the `job` event for\n   * intermediate streaming chunks.\n   *\n   * Streaming opt-in: pass `stream: true` if the publisher's job emits\n   * chunks (LLM generation, video encoding). One-shot jobs (embeddings,\n   * classifications) skip the streaming machinery.\n   */\n  async callJob(args: {\n    jobIndex: number;\n    inputs: JobInputs;\n    stream?: boolean;\n  }): Promise<JobInvocation> {\n    await this.ensureBootstrapped();\n    const correlationId = makeCorrelationId('tangle.app.callJob');\n    const timeout =\n      this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n    return new Promise<JobInvocation>((resolve, reject) => {\n      const invocation: JobInvocation = {\n        correlationId,\n        status: 'pending',\n        chunks: [],\n      };\n      const timer = setTimeout(() => {\n        this.pendingJobs.delete(correlationId);\n        reject(\n          bridgeError(4900, `Job did not respond within ${timeout}ms`),\n        );\n      }, timeout);\n      this.pendingJobs.set(correlationId, {\n        resolve,\n        reject,\n        timer,\n        invocation,\n      });\n      const message: CallJobRequest = {\n        kind: 'tangle.app.callJob',\n        correlationId,\n        jobIndex: args.jobIndex,\n        inputs: args.inputs,\n        ...(args.stream !== undefined ? { stream: args.stream } : {}),\n      };\n      this.postToParent(message);\n      // Emit pending immediately so consumer UIs can show optimistic state.\n      this.emit('job', invocation);\n    });\n  }\n\n  // ── Internals ───────────────────────────────────────────────────────────\n\n  private postHandshake(): void {\n    this.postToParent({\n      kind: 'tangle.app.handshake',\n      appId: this.options.appId,\n      version: TANGLE_IFRAME_PROTOCOL_VERSION,\n    });\n  }\n\n  private postToParent(message: object): void {\n    if (typeof window === 'undefined') return;\n    try {\n      window.parent.postMessage(message, this.options.parentOrigin);\n    } catch {\n      // Cross-origin / sandboxed; defensive only — postMessage shouldn't throw.\n    }\n  }\n\n  private handleParentMessage = (event: MessageEvent): void => {\n    if (event.origin !== this.options.parentOrigin) return;\n    const data = event.data;\n    if (typeof data !== 'object' || data === null) return;\n    const message = data as ParentMessage;\n    switch (message.kind) {\n      case 'tangle.app.handshakeAck':\n        this.handshakeAcked = true;\n        for (const resolve of this.handshakeWaiters) resolve();\n        this.handshakeWaiters = [];\n        return;\n      case 'tangle.app.readAccountResult':\n        if (message.ok) {\n          this.updateWallet({\n            address:\n              message.data.account === NO_WALLET_ADDRESS\n                ? null\n                : message.data.account,\n            chainId: message.data.chainId,\n            isConnected: message.data.account !== NO_WALLET_ADDRESS,\n          });\n        }\n        return;\n      case 'tangle.app.accountChanged':\n        this.updateWallet({\n          address: message.account,\n          chainId: this.wallet.chainId,\n          isConnected: message.account !== null,\n        });\n        return;\n      case 'tangle.app.chainChanged':\n        this.updateWallet({\n          address: this.wallet.address,\n          chainId: message.chainId,\n          isConnected: this.wallet.isConnected,\n        });\n        return;\n      case 'tangle.app.serviceContext':\n        this.updateService(message);\n        return;\n      case 'tangle.app.jobResult':\n        this.handleJobResult(message);\n        return;\n      // Wallet-shape responses (signMessageResult etc.) are routed by\n      // dispatchWallet's promise resolver, not here.\n      default:\n        return;\n    }\n  };\n\n  private async dispatchWallet(\n    kind:\n      | 'tangle.app.signMessage'\n      | 'tangle.app.signTransaction'\n      | 'tangle.app.switchChain',\n    payload: Record<string, unknown>,\n  ): Promise<unknown> {\n    return new Promise((resolve, reject) => {\n      const correlationId = makeCorrelationId(kind);\n      const timeout =\n        this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n      const expectedKind = (\n        {\n          'tangle.app.signMessage': 'tangle.app.signMessageResult',\n          'tangle.app.signTransaction': 'tangle.app.signTransactionResult',\n          'tangle.app.switchChain': 'tangle.app.switchChainResult',\n        } as const\n      )[kind];\n      const timer = setTimeout(() => {\n        window.removeEventListener('message', listener);\n        reject(bridgeError(4900, `Parent did not respond to ${kind} in ${timeout}ms`));\n      }, timeout);\n      const listener = (event: MessageEvent) => {\n        if (event.origin !== this.options.parentOrigin) return;\n        const data = event.data;\n        if (typeof data !== 'object' || data === null) return;\n        const msg = data as ParentMessage;\n        if (\n          msg.kind !== expectedKind ||\n          !('correlationId' in msg) ||\n          msg.correlationId !== correlationId\n        ) {\n          return;\n        }\n        clearTimeout(timer);\n        window.removeEventListener('message', listener);\n        // Narrow the type — expectedKind is the wallet-shape `{ok, data|error}` envelope\n        const env = msg as {\n          ok: boolean;\n          data?: unknown;\n          error?: string;\n        };\n        if (env.ok) {\n          resolve(env.data);\n        } else {\n          reject(bridgeError(4001, env.error ?? 'Parent rejected request'));\n        }\n      };\n      window.addEventListener('message', listener);\n      this.postToParent({ kind, correlationId, ...payload });\n    });\n  }\n\n  private handleJobResult(message: JobResultEvent): void {\n    const pending = this.pendingJobs.get(message.correlationId);\n    if (!pending) return;\n    const updated: JobInvocation = {\n      correlationId: message.correlationId,\n      status: message.status,\n      chunks:\n        message.chunk !== undefined\n          ? [...pending.invocation.chunks, message.chunk]\n          : pending.invocation.chunks,\n      ...(message.data !== undefined ? { data: message.data } : {}),\n      ...(message.error !== undefined ? { error: message.error } : {}),\n      ...(message.progress !== undefined ? { progress: message.progress } : {}),\n    };\n    pending.invocation = updated;\n    this.emit('job', updated);\n    if (message.status === 'success' || message.status === 'error') {\n      clearTimeout(pending.timer);\n      this.pendingJobs.delete(message.correlationId);\n      if (message.status === 'success') {\n        pending.resolve(updated);\n      } else {\n        pending.reject(bridgeError(4001, message.error ?? 'Job failed'));\n      }\n    }\n  }\n\n  private updateWallet(next: WalletSnapshot): void {\n    if (\n      this.wallet.address === next.address &&\n      this.wallet.chainId === next.chainId &&\n      this.wallet.isConnected === next.isConnected\n    ) {\n      return;\n    }\n    this.wallet = next;\n    this.emit('wallet', next);\n  }\n\n  private updateService(broadcast: ServiceContextBroadcast): void {\n    const next: ServiceSnapshot = {\n      blueprintId: broadcast.blueprintId,\n      serviceId: broadcast.serviceId,\n      operators: broadcast.operators,\n      jobs: broadcast.jobs,\n      mode: broadcast.mode,\n    };\n    this.service = next;\n    this.emit('service', next);\n  }\n\n  private emit<K extends keyof ClientEventMap>(\n    event: K,\n    value: ClientEventMap[K],\n  ): void {\n    for (const listener of [...this.listeners[event]]) {\n      try {\n        (listener as Listener<K>)(value);\n      } catch {\n        // Listener bugs shouldn't break the bridge.\n      }\n    }\n  }\n\n  private async ensureBootstrapped(): Promise<void> {\n    if (this.handshakeAcked) return;\n    this.install();\n    await new Promise<void>((resolve) => {\n      this.handshakeWaiters.push(resolve);\n      const retry = setInterval(() => {\n        if (this.handshakeAcked) {\n          clearInterval(retry);\n          return;\n        }\n        this.postHandshake();\n      }, 500);\n      setTimeout(() => clearInterval(retry), 10_000);\n    });\n  }\n}\n\nfunction bridgeError(code: number, message: string): Error {\n  const err = new Error(message) as Error & { code?: number };\n  err.code = code;\n  return err;\n}\n","import { useCallback, useEffect, useMemo, useState } from 'react';\nimport type { Address, Hex } from 'viem';\n\nimport { useTangleIframeContext } from './TangleIframeProvider';\nimport type {\n  JobInvocation,\n  ServiceSnapshot,\n  WalletSnapshot,\n} from './tangleIframeClient';\nimport type { JobInputs } from '../wallet/parentBridgeProtocol';\n\n/**\n * Read-only view of the connected wallet, plus the operations the iframe\n * can request the parent to perform.\n *\n * The iframe never holds a private key, never sees `window.ethereum`, never\n * imports wagmi. All wallet work happens upstream in the Tangle Cloud\n * dapp's wagmi config + ConnectKit modal.\n */\nexport function useTangleWallet(): WalletSnapshot & {\n  signMessage: (message: string) => Promise<Hex>;\n  sendTransaction: (tx: {\n    to: Address;\n    data: Hex;\n    value?: bigint;\n  }) => Promise<Hex>;\n  switchChain: (chainId: number) => Promise<number>;\n} {\n  const { client, wallet } = useTangleIframeContext();\n  const signMessage = useCallback(\n    (message: string) => {\n      if (!client) throw new Error('Wallet not available in dev mode.');\n      return client.signMessage(message);\n    },\n    [client],\n  );\n  const sendTransaction = useCallback(\n    (tx: { to: Address; data: Hex; value?: bigint }) => {\n      if (!client) throw new Error('Wallet not available in dev mode.');\n      return client.sendTransaction(tx);\n    },\n    [client],\n  );\n  const switchChain = useCallback(\n    (chainId: number) => {\n      if (!client) throw new Error('Wallet not available in dev mode.');\n      return client.switchChain(chainId);\n    },\n    [client],\n  );\n  return { ...wallet, signMessage, sendTransaction, switchChain };\n}\n\n/**\n * The service the iframe is currently rendering for. Broadcast by the\n * parent dapp on mount + every time the service/mode changes — the iframe\n * never queries the chain or the indexer itself.\n *\n * `serviceId === null` means the operator hasn't deployed an instance yet;\n * the iframe should render its deploy-ready / configuration surface.\n */\nexport function useTangleService(): ServiceSnapshot {\n  return useTangleIframeContext().service;\n}\n\n/**\n * Invoke a blueprint job. Returns a callable + a snapshot of the most\n * recent invocation (or null if none yet).\n *\n * Streaming jobs (LLM, video, audio) opt in via `stream: true`. The hook's\n * `invocation.chunks` accumulates each streaming chunk so the UI can render\n * progressive output. For one-shot jobs (embeddings, classification), use\n * the `invocation.data` once `status === 'success'`.\n *\n * Multiple in-flight invocations are supported — each `call()` returns its\n * own correlationId. The hook tracks only the *latest* invocation in its\n * state; consumers that need all history can subscribe to the client's\n * `job` event directly.\n */\nexport function useCallJob() {\n  const { client } = useTangleIframeContext();\n  const [invocation, setInvocation] = useState<JobInvocation | null>(null);\n  const [latestId, setLatestId] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (!client) return undefined;\n    return client.subscribe('job', (next) => {\n      // Only update if this is the latest invocation, or no latest tracked.\n      setLatestId((prevLatest) => {\n        if (prevLatest === null || prevLatest === next.correlationId) {\n          setInvocation(next);\n          return next.correlationId;\n        }\n        return prevLatest;\n      });\n    });\n  }, [client]);\n\n  const call = useCallback(\n    async (args: { jobIndex: number; inputs: JobInputs; stream?: boolean }) => {\n      if (!client) {\n        throw new Error(\n          'Job invocation not available in dev mode without a configured stub. See `setDevJobHandler` in the testing harness.',\n        );\n      }\n      // Clear prior invocation state when starting a new call.\n      setInvocation(null);\n      const result = await client.callJob(args);\n      setLatestId(result.correlationId);\n      return result;\n    },\n    [client],\n  );\n\n  const reset = useCallback(() => {\n    setInvocation(null);\n    setLatestId(null);\n  }, []);\n\n  return useMemo(\n    () => ({ call, invocation, reset, isPending: invocation?.status === 'pending' || invocation?.status === 'streaming' }),\n    [call, invocation, reset],\n  );\n}\n\n/**\n * Convenience: returns just the address when connected, or `null`. Most\n * iframe components only care about the address.\n */\nexport function useTangleAddress(): Address | null {\n  return useTangleIframeContext().wallet.address;\n}\n\n/** Whether the iframe has completed its parent-handshake (or is in dev mode). */\nexport function useTangleReady(): boolean {\n  return useTangleIframeContext().isReady;\n}\n\n/** Resolved mode — `'bridge'` (real parent) or `'dev'` (standalone). */\nexport function useTangleMode(): 'bridge' | 'dev' {\n  return useTangleIframeContext().mode;\n}\n"],"mappings":"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","names":["NULL_WALLET","NULL_SERVICE","useEffect","useMemo","useState","useState","useEffect","useMemo"]}

package/dist/iframe/testing-index.d.ts

@@ -0,0 +1,81 @@
+import { FC, ReactNode } from 'react';
+import { Address } from 'viem';
+import { W as WalletSnapshot, S as ServiceSnapshot } from '../tangleIframeClient-D-PP-KhN.js';
+import { C as CallJobRequest, g as ServiceContextOperator, f as ServiceContextJob } from '../parentBridgeProtocol-CqK9e6Fk.js';
+
+type MockWalletInput = Partial<{
+    address: Address | null;
+    chainId: number;
+    isConnected: boolean;
+}>;
+type MockServiceInput = Partial<{
+    blueprintId: string;
+    serviceId: string | null;
+    operators: readonly ServiceContextOperator[];
+    jobs: readonly ServiceContextJob[];
+    mode: string | null;
+}>;
+/**
+ * Construct a deterministic wallet snapshot for tests. Defaults:
+ * connected, vitalik.eth's address, Base Sepolia (84532).
+ */
+declare function mockWallet(input?: MockWalletInput): WalletSnapshot;
+/**
+ * Construct a deterministic service snapshot for tests. Defaults: blueprint
+ * id `0`, no service deployed yet (serviceId null), single mock operator on
+ * the canonical local sidecar URL.
+ */
+declare function mockServiceContext(input?: MockServiceInput): ServiceSnapshot;
+type CallJobHandler = (request: CallJobRequest) => Promise<{
+    status: 'success' | 'error';
+    data?: unknown;
+    error?: string;
+    /** Streaming chunks emitted in order before the terminal status. */
+    chunks?: readonly unknown[];
+}>;
+type HarnessProps = {
+    appId?: string;
+    wallet?: WalletSnapshot;
+    service?: ServiceSnapshot;
+    /** Override callJob behavior. Default: returns a static `{ ok: true }`. */
+    onCallJob?: CallJobHandler;
+    /** Surface a floating debug panel that lets the developer flip state at runtime. */
+    showDebugPanel?: boolean;
+    children: ReactNode;
+};
+/**
+ * Drop-in parent simulator for tests + storybook + standalone dev. Wraps
+ * children in a fake parent that:
+ *
+ *   - Acks the iframe's handshake immediately
+ *   - Broadcasts the configured wallet + service context on mount
+ *   - Intercepts `callJob` requests and routes them through `onCallJob`
+ *   - (Optional) Mounts a floating debug panel so the developer can
+ *     mutate state at runtime: change account, switch chain, set
+ *     serviceId, fire a custom job
+ *
+ * The harness runs in the same JS context as the iframe app — there's no
+ * cross-frame postMessage, just same-window event dispatch. That keeps it
+ * fully synchronous + assertable, but the messages still flow through the
+ * exact same protocol surface the production bridge uses.
+ *
+ * Usage:
+ *
+ *   <TangleParentHarness wallet={mockWallet()} service={mockServiceContext()}>
+ *     <TangleIframeProvider appId="my-app" mode="bridge" parentOrigin="harness://">
+ *       <App />
+ *     </TangleIframeProvider>
+ *   </TangleParentHarness>
+ *
+ * Set `mode="bridge"` + `parentOrigin="harness://"` on the provider so it
+ * matches the harness's synthetic origin. In production, use `mode="auto"`
+ * (the default).
+ */
+declare const TangleParentHarness: FC<HarnessProps>;
+/**
+ * Synthetic origin every harness instance uses. Stable across tests so the
+ * iframe SDK + the harness can pin to the same string.
+ */
+declare const HARNESS_ORIGIN = "harness://tangle.local";
+
+export { type CallJobHandler, HARNESS_ORIGIN, type MockServiceInput, type MockWalletInput, TangleParentHarness, mockServiceContext, mockWallet };