@zhyi64/message-bridge 0.1.0

package/README.md

@@ -0,0 +1,117 @@
+# @zhyi64/message-bridge
+
+统一的跨 iframe 通信 SDK，用于多层嵌套 iframe 架构的消息路由与转发。
+
+## 架构
+
+```
+A (onepcweb)          ← 根节点
+    ↑ postMessage
+B (intelligent-web)   ← 中间层，自动路由
+    ↑ postMessage
+C (openclaw)          ← 叶节点
+```
+
+## 安装
+
+```bash
+npm install @zhyi64/message-bridge
+```
+
+## 快速开始
+
+### 叶节点 (C - openclaw)
+
+```typescript
+import { OnePcBridge } from '@zhyi64/message-bridge'
+
+const bridge = new OnePcBridge({
+  nodeId: 'openclaw',
+  allowedOrigins: ['https://...'],
+  parentWindow: window.parent,
+  debug: true,
+})
+bridge.init()
+
+// 直接发送给 A，无需知道中间经过 B
+bridge.send('onepcweb', 'menu', { currentMenu: 'settings' })
+
+// 监听来自 A 的消息
+bridge.on('theme', (payload) => {
+  document.documentElement.setAttribute('data-theme', payload.theme)
+})
+```
+
+### 中间节点 (B - intelligent-web)
+
+```typescript
+import { OnePcBridge } from '@zhyi64/message-bridge'
+
+const bridge = new OnePcBridge({
+  nodeId: 'intelligent',
+  allowedOrigins: [CHILD_ORIGIN, A_ORIGIN],
+  parentWindow: window.parent,
+  getChildWindow: () => iframeRef.value?.contentWindow ?? null,
+})
+
+// 注册自动路由 — 一行搞定，无需手动 if/switch 转发
+bridge.addRoute('openclaw', 'onepcweb')  // C→A
+bridge.addRoute('onepcweb', 'openclaw')  // A→C
+bridge.init()
+```
+
+### 根节点 (A - onepcweb)
+
+```typescript
+import { OnePcBridge } from '@zhyi64/message-bridge'
+
+const bridge = new OnePcBridge({
+  nodeId: 'onepcweb',
+  allowedOrigins: ['https://...'],
+  getChildWindow: () => document.querySelector('#iframe')?.contentWindow,
+})
+bridge.init()
+
+// 直接发送给 C，自动经过 B 中转
+bridge.send('openclaw', 'theme', { theme: 'dark' })
+
+// 监听来自 C 的消息
+bridge.on('menu', (payload, envelope) => {
+  console.log('来自 C 的菜单消息:', payload)
+})
+```
+
+## API
+
+### `new OnePcBridge(config)`
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `nodeId` | `NodeId` | 当前节点标识 |
+| `allowedOrigins` | `string[]` | Origin 白名单 |
+| `parentWindow?` | `Window` | 父窗口引用 |
+| `getChildWindow?` | `() => Window \| null` | 获取子窗口引用的函数 |
+| `debug?` | `boolean` | 开启调试日志 |
+
+### 方法
+
+| 方法 | 说明 |
+|------|------|
+| `init()` | 注册全局 message 监听 |
+| `destroy()` | 移除监听，清理资源 |
+| `send(target, type, payload?)` | 发送消息（自动路由） |
+| `on(type, handler)` | 注册消息处理器，返回 unsubscribe 函数 |
+| `addRoute(from, to)` | 注册自动路由（中间层使用） |
+| `removeRoute(from, to)` | 移除路由 |
+
+## 特性
+
+- **自动路由** — 中间层只需 `addRoute()`，无需手动转发
+- **旧格式兼容** — 自动识别新旧消息格式，新旧代码可并行
+- **Origin 安全** — 集中管理白名单
+- **无框架依赖** — 纯 JS，Vue/React/原生均可使用
+- **TypeScript 支持** — 内置类型声明
+
+## License
+
+MIT

package/dist/index.cjs.js

@@ -0,0 +1,2 @@
+var c=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var w=Object.prototype.hasOwnProperty;var m=(i,e)=>{for(var t in e)c(i,t,{get:e[t],enumerable:!0})},b=(i,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of p(e))!w.call(i,r)&&r!==t&&c(i,r,{get:()=>e[r],enumerable:!(n=f(e,r))||n.enumerable});return i};var W=i=>b(c({},"__esModule",{value:!0}),i);var R={};m(R,{OnePcBridge:()=>u,Router:()=>o,createEnvelope:()=>a,parseEnvelope:()=>l,serializeEnvelope:()=>s});module.exports=W(R);var y=0;function h(){let i=Date.now().toString(36),e=(++y).toString(36);return`mb_${i}_${e}`}function a(i,e,t,n){return{protocol:"message-bridge-v1",id:h(),from:i,to:e,type:t,payload:n??null,timestamp:Date.now()}}function l(i){if(!i)return null;if(i.protocol==="message-bridge-v1")return i;let e=i;if(e.message&&e.message.subtype==="webToPc"){let t=e.message.data,n;if(typeof t=="string")try{n=JSON.parse(t)}catch{return null}else if(typeof t=="object")n=t;else return null;let{type:r,...d}=n;return r?{protocol:"message-bridge-v1",id:e.id||h(),from:g(e.from),to:E(e.to),type:String(r),payload:d,timestamp:Date.now()}:null}return e.message&&e.message.subtype==="openclawToPc"?{protocol:"message-bridge-v1",id:e.id||h(),from:g(e.from),to:"onepcweb",type:"openclawToPc",payload:e.message.data,timestamp:Date.now()}:null}function g(i){return i?i.includes("openclaw")||i.includes("claw")?"openclaw":i.includes("intelligent")?"intelligent":i.includes("vantage")||i.includes("onepc")?"onepcweb":"intelligent":"intelligent"}function E(i){return i?i.includes("pcWeb")||i.includes("pcMessage")?"onepcweb":i.includes("intelligent")?"intelligent":i.includes("openclaw")||i.includes("claw")?"openclaw":"intelligent":"intelligent"}function s(i){return{...i}}var o=class{constructor(e={}){this.routes=[],this.parentWindow=e.parentWindow??null,this.getChildWindow=e.getChildWindow??null,this.debug=e.debug??!1}addRoute(e,t){this.removeRoute(e,t),this.routes.push({from:e,to:t}),this.log("route registered:",`${e} \u2192 ${t}`)}removeRoute(e,t){this.routes=this.routes.filter(n=>!(n.from===e&&n.to===t))}clearRoutes(){this.routes=[]}getForwardTarget(e){return this.routes.find(n=>n.from===e.from&&n.to===e.to)?e.to==="onepcweb"&&this.parentWindow?this.parentWindow:e.from==="onepcweb"&&this.getChildWindow?this.getChildWindow():e.to!=="intelligent"&&this.parentWindow?this.parentWindow:null:null}forward(e){let t=this.getForwardTarget(e);if(!t)return!1;let n=s(e);return t.postMessage(n,"*"),this.log("forwarded:",`${e.from} \u2192 ${e.to} via postMessage`,e.type),!0}hasRoute(e,t){return this.routes.some(n=>n.from===e&&n.to===t)}process(e){return this.hasRoute(e.from,e.to)?this.forward(e):!1}log(...e){this.debug&&console.log("[OnePcBridge-Router]",...e)}};var u=class{constructor(e){this.config=e,this.handlers=new Map,this.router=new o({parentWindow:e.parentWindow,getChildWindow:e.getChildWindow,debug:e.debug??!1}),this.messageHandler=null,this.initialized=!1}init(){this.initialized||(this.messageHandler=this.handleMessage.bind(this),window.addEventListener("message",this.messageHandler),this.initialized=!0,this.log("initialized",this.config.nodeId))}destroy(){this.messageHandler&&(window.removeEventListener("message",this.messageHandler),this.messageHandler=null),this.handlers.clear(),this.initialized=!1,this.log("destroyed")}send(e,t,n){let r=a(this.config.nodeId,e,t,n);this.log("send:",`${this.config.nodeId} \u2192 ${e}`,t,n);let d=this.getTargetWindow(e);d?d.postMessage(s(r),"*"):this.warn("no target window for:",e)}on(e,t){return this.handlers.has(e)||this.handlers.set(e,new Set),this.handlers.get(e).add(t),()=>{let n=this.handlers.get(e);n&&(n.delete(t),n.size===0&&this.handlers.delete(e))}}addRoute(e,t){this.router?.addRoute(e,t)}removeRoute(e,t){this.router?.removeRoute(e,t)}handleMessage(e){if(e.origin&&!this.config.allowedOrigins.includes(e.origin))return;let t=l(e.data);if(t&&!(t.from===this.config.nodeId&&t.to===this.config.nodeId)){if(t.to!==this.config.nodeId){if(this.router?.process(t)){this.dispatch(t);return}return}this.dispatch(t)}}dispatch(e){let t=this.handlers.get(e.type);if(t)for(let n of t)try{n(e.payload,e)}catch(r){this.warn("handler error:",e.type,r)}}getTargetWindow(e){return this.config.parentWindow&&e!==this.config.nodeId?this.config.parentWindow:this.config.getChildWindow?this.config.getChildWindow():null}log(...e){this.config.debug&&console.log(`[OnePcBridge:${this.config.nodeId}]`,...e)}warn(...e){console.warn(`[OnePcBridge:${this.config.nodeId}]`,...e)}};
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.js", "../src/envelope.js", "../src/router.js", "../src/MessageBridge.js"],
+  "sourcesContent": ["export { OnePcBridge } from './MessageBridge'\nexport { createEnvelope, parseEnvelope, serializeEnvelope } from './envelope'\nexport { Router } from './router'\n", "let _counter = 0\n\n/**\n * Generate a lightweight unique ID without external dependencies.\n * Uses timestamp + counter for uniqueness within a session.\n */\nfunction generateId() {\n  const ts = Date.now().toString(36)\n  const seq = (++_counter).toString(36)\n  return `mb_${ts}_${seq}`\n}\n\n/**\n * Create a new message envelope (new protocol format).\n */\nexport function createEnvelope(from, to, type, payload) {\n  return {\n    protocol: 'message-bridge-v1',\n    id: generateId(),\n    from,\n    to,\n    type,\n    payload: payload ?? null,\n    timestamp: Date.now(),\n  }\n}\n\n/**\n * Parse a raw postMessage event into an Envelope.\n * Supports both the new protocol format and the legacy format\n * for backward compatibility during migration.\n *\n * New format:\n *   { protocol: 'message-bridge-v1', from, to, type, payload, ... }\n *\n * Legacy format:\n *   { to, from, id, message: { subtype: 'webToPc', data: JSON.stringify({type, ...}) } }\n */\nexport function parseEnvelope(raw) {\n  if (!raw) return null\n\n  // --- New protocol ---\n  if (raw.protocol === 'message-bridge-v1') {\n    return raw\n  }\n\n  // --- Legacy format detection ---\n  const legacy = raw\n  if (legacy.message && legacy.message.subtype === 'webToPc') {\n    const data = legacy.message.data\n    let parsed\n\n    if (typeof data === 'string') {\n      try {\n        parsed = JSON.parse(data)\n      } catch {\n        return null\n      }\n    } else if (typeof data === 'object') {\n      parsed = data\n    } else {\n      return null\n    }\n\n    const { type, ...restPayload } = parsed\n    if (!type) return null\n\n    return {\n      protocol: 'message-bridge-v1',\n      id: legacy.id || generateId(),\n      from: detectFromNode(legacy.from),\n      to: detectToNode(legacy.to),\n      type: String(type),\n      payload: restPayload,\n      timestamp: Date.now(),\n    }\n  }\n\n  // Legacy: openclawToPc subtype\n  if (legacy.message && legacy.message.subtype === 'openclawToPc') {\n    return {\n      protocol: 'message-bridge-v1',\n      id: legacy.id || generateId(),\n      from: detectFromNode(legacy.from),\n      to: 'onepcweb',\n      type: 'openclawToPc',\n      payload: legacy.message.data,\n      timestamp: Date.now(),\n    }\n  }\n\n  return null\n}\n\n/**\n * Detect the source NodeId from legacy message's `from` field.\n */\nfunction detectFromNode(from) {\n  if (!from) return 'intelligent'\n  if (from.includes('openclaw') || from.includes('claw')) return 'openclaw'\n  if (from.includes('intelligent')) return 'intelligent'\n  if (from.includes('vantage') || from.includes('onepc')) return 'onepcweb'\n  return 'intelligent'\n}\n\n/**\n * Detect the target NodeId from legacy message's `to` field.\n */\nfunction detectToNode(to) {\n  if (!to) return 'intelligent'\n  if (to.includes('pcWeb') || to.includes('pcMessage')) return 'onepcweb'\n  if (to.includes('intelligent')) return 'intelligent'\n  if (to.includes('openclaw') || to.includes('claw')) return 'openclaw'\n  return 'intelligent'\n}\n\n/**\n * Serialize an Envelope for postMessage transmission.\n */\nexport function serializeEnvelope(envelope) {\n  return { ...envelope }\n}\n", "import { createEnvelope, serializeEnvelope } from './envelope'\n\n/**\n * Router manages automatic message forwarding for middle-layer nodes.\n */\nexport class Router {\n  constructor(opts = {}) {\n    this.routes = []\n    this.parentWindow = opts.parentWindow ?? null\n    this.getChildWindow = opts.getChildWindow ?? null\n    this.debug = opts.debug ?? false\n  }\n\n  addRoute(from, to) {\n    this.removeRoute(from, to)\n    this.routes.push({ from, to })\n    this.log('route registered:', `${from} \u2192 ${to}`)\n  }\n\n  removeRoute(from, to) {\n    this.routes = this.routes.filter(\n      r => !(r.from === from && r.to === to)\n    )\n  }\n\n  clearRoutes() {\n    this.routes = []\n  }\n\n  getForwardTarget(envelope) {\n    const route = this.routes.find(\n      r => r.from === envelope.from && r.to === envelope.to\n    )\n    if (!route) return null\n\n    if (envelope.to === 'onepcweb' && this.parentWindow) {\n      return this.parentWindow\n    }\n    if (envelope.from === 'onepcweb' && this.getChildWindow) {\n      return this.getChildWindow()\n    }\n    if (envelope.to !== 'intelligent' && this.parentWindow) {\n      return this.parentWindow\n    }\n\n    return null\n  }\n\n  forward(envelope) {\n    const target = this.getForwardTarget(envelope)\n    if (!target) return false\n\n    const body = serializeEnvelope(envelope)\n    target.postMessage(body, '*')\n    this.log('forwarded:', `${envelope.from} \u2192 ${envelope.to} via postMessage`, envelope.type)\n    return true\n  }\n\n  hasRoute(from, to) {\n    return this.routes.some(r => r.from === from && r.to === to)\n  }\n\n  process(envelope) {\n    if (this.hasRoute(envelope.from, envelope.to)) {\n      return this.forward(envelope)\n    }\n    return false\n  }\n\n  log(...args) {\n    if (this.debug) {\n      console.log('[OnePcBridge-Router]', ...args)\n    }\n  }\n}\n", "import { createEnvelope, parseEnvelope, serializeEnvelope } from './envelope'\nimport { Router } from './router'\n\n/**\n * OnePcBridge \u2014 unified cross-iframe communication SDK.\n *\n * Usage:\n *   // Leaf node (C - openclaw)\n *   const bridge = new OnePcBridge({\n *     nodeId: 'openclaw',\n *     allowedOrigins: ['https://...'],\n *     parentWindow: window.parent,\n *   })\n *   bridge.init()\n *   bridge.send('onepcweb', 'menu', { data: '...' })\n *\n *   // Middle node (B - intelligent-web)\n *   const bridge = new OnePcBridge({\n *     nodeId: 'intelligent',\n *     allowedOrigins: ['https://...', CHILD_ORIGIN],\n *     parentWindow: window.parent,\n *     getChildWindow: () => iframeRef.value?.contentWindow,\n *   })\n *   bridge.addRoute('openclaw', 'onepcweb')\n *   bridge.init()\n */\nexport class OnePcBridge {\n  constructor(config) {\n    this.config = config\n    this.handlers = new Map()\n    this.router = new Router({\n      parentWindow: config.parentWindow,\n      getChildWindow: config.getChildWindow,\n      debug: config.debug ?? false,\n    })\n    this.messageHandler = null\n    this.initialized = false\n  }\n\n  init() {\n    if (this.initialized) return\n\n    this.messageHandler = this.handleMessage.bind(this)\n    window.addEventListener('message', this.messageHandler)\n    this.initialized = true\n    this.log('initialized', this.config.nodeId)\n  }\n\n  destroy() {\n    if (this.messageHandler) {\n      window.removeEventListener('message', this.messageHandler)\n      this.messageHandler = null\n    }\n    this.handlers.clear()\n    this.initialized = false\n    this.log('destroyed')\n  }\n\n  send(target, type, payload) {\n    const envelope = createEnvelope(this.config.nodeId, target, type, payload)\n    this.log('send:', `${this.config.nodeId} \u2192 ${target}`, type, payload)\n\n    const targetWindow = this.getTargetWindow(target)\n    if (targetWindow) {\n      targetWindow.postMessage(serializeEnvelope(envelope), '*')\n    } else {\n      this.warn('no target window for:', target)\n    }\n  }\n\n  on(type, handler) {\n    if (!this.handlers.has(type)) {\n      this.handlers.set(type, new Set())\n    }\n    this.handlers.get(type).add(handler)\n\n    return () => {\n      const set = this.handlers.get(type)\n      if (set) {\n        set.delete(handler)\n        if (set.size === 0) {\n          this.handlers.delete(type)\n        }\n      }\n    }\n  }\n\n  addRoute(from, to) {\n    this.router?.addRoute(from, to)\n  }\n\n  removeRoute(from, to) {\n    this.router?.removeRoute(from, to)\n  }\n\n  // \u2500\u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  handleMessage(event) {\n    if (event.origin && !this.config.allowedOrigins.includes(event.origin)) {\n      return\n    }\n\n    const envelope = parseEnvelope(event.data)\n    if (!envelope) return\n\n    if (envelope.from === this.config.nodeId && envelope.to === this.config.nodeId) {\n      return\n    }\n\n    if (envelope.to !== this.config.nodeId) {\n      if (this.router?.process(envelope)) {\n        this.dispatch(envelope)\n        return\n      }\n      return\n    }\n\n    this.dispatch(envelope)\n  }\n\n  dispatch(envelope) {\n    const typeHandlers = this.handlers.get(envelope.type)\n    if (typeHandlers) {\n      for (const handler of typeHandlers) {\n        try {\n          handler(envelope.payload, envelope)\n        } catch (err) {\n          this.warn('handler error:', envelope.type, err)\n        }\n      }\n    }\n  }\n\n  getTargetWindow(target) {\n    if (this.config.parentWindow && target !== this.config.nodeId) {\n      return this.config.parentWindow\n    }\n    if (this.config.getChildWindow) {\n      return this.config.getChildWindow()\n    }\n    return null\n  }\n\n  log(...args) {\n    if (this.config.debug) {\n      console.log(`[OnePcBridge:${this.config.nodeId}]`, ...args)\n    }\n  }\n\n  warn(...args) {\n    console.warn(`[OnePcBridge:${this.config.nodeId}]`, ...args)\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["index_exports", "__export", "OnePcBridge", "Router", "createEnvelope", "parseEnvelope", "serializeEnvelope", "__toCommonJS", "_counter", "generateId", "ts", "seq", "createEnvelope", "from", "to", "type", "payload", "parseEnvelope", "raw", "legacy", "data", "parsed", "restPayload", "detectFromNode", "detectToNode", "serializeEnvelope", "envelope", "Router", "opts", "from", "to", "r", "envelope", "target", "body", "serializeEnvelope", "args", "OnePcBridge", "config", "Router", "target", "type", "payload", "envelope", "createEnvelope", "targetWindow", "serializeEnvelope", "handler", "set", "from", "to", "event", "parseEnvelope", "typeHandlers", "err", "args"]
+}

package/dist/index.esm.js

@@ -0,0 +1,2 @@
+var g=0;function a(){let i=Date.now().toString(36),e=(++g).toString(36);return`mb_${i}_${e}`}function l(i,e,t,n){return{protocol:"message-bridge-v1",id:a(),from:i,to:e,type:t,payload:n??null,timestamp:Date.now()}}function u(i){if(!i)return null;if(i.protocol==="message-bridge-v1")return i;let e=i;if(e.message&&e.message.subtype==="webToPc"){let t=e.message.data,n;if(typeof t=="string")try{n=JSON.parse(t)}catch{return null}else if(typeof t=="object")n=t;else return null;let{type:r,...d}=n;return r?{protocol:"message-bridge-v1",id:e.id||a(),from:h(e.from),to:f(e.to),type:String(r),payload:d,timestamp:Date.now()}:null}return e.message&&e.message.subtype==="openclawToPc"?{protocol:"message-bridge-v1",id:e.id||a(),from:h(e.from),to:"onepcweb",type:"openclawToPc",payload:e.message.data,timestamp:Date.now()}:null}function h(i){return i?i.includes("openclaw")||i.includes("claw")?"openclaw":i.includes("intelligent")?"intelligent":i.includes("vantage")||i.includes("onepc")?"onepcweb":"intelligent":"intelligent"}function f(i){return i?i.includes("pcWeb")||i.includes("pcMessage")?"onepcweb":i.includes("intelligent")?"intelligent":i.includes("openclaw")||i.includes("claw")?"openclaw":"intelligent":"intelligent"}function s(i){return{...i}}var o=class{constructor(e={}){this.routes=[],this.parentWindow=e.parentWindow??null,this.getChildWindow=e.getChildWindow??null,this.debug=e.debug??!1}addRoute(e,t){this.removeRoute(e,t),this.routes.push({from:e,to:t}),this.log("route registered:",`${e} \u2192 ${t}`)}removeRoute(e,t){this.routes=this.routes.filter(n=>!(n.from===e&&n.to===t))}clearRoutes(){this.routes=[]}getForwardTarget(e){return this.routes.find(n=>n.from===e.from&&n.to===e.to)?e.to==="onepcweb"&&this.parentWindow?this.parentWindow:e.from==="onepcweb"&&this.getChildWindow?this.getChildWindow():e.to!=="intelligent"&&this.parentWindow?this.parentWindow:null:null}forward(e){let t=this.getForwardTarget(e);if(!t)return!1;let n=s(e);return t.postMessage(n,"*"),this.log("forwarded:",`${e.from} \u2192 ${e.to} via postMessage`,e.type),!0}hasRoute(e,t){return this.routes.some(n=>n.from===e&&n.to===t)}process(e){return this.hasRoute(e.from,e.to)?this.forward(e):!1}log(...e){this.debug&&console.log("[OnePcBridge-Router]",...e)}};var c=class{constructor(e){this.config=e,this.handlers=new Map,this.router=new o({parentWindow:e.parentWindow,getChildWindow:e.getChildWindow,debug:e.debug??!1}),this.messageHandler=null,this.initialized=!1}init(){this.initialized||(this.messageHandler=this.handleMessage.bind(this),window.addEventListener("message",this.messageHandler),this.initialized=!0,this.log("initialized",this.config.nodeId))}destroy(){this.messageHandler&&(window.removeEventListener("message",this.messageHandler),this.messageHandler=null),this.handlers.clear(),this.initialized=!1,this.log("destroyed")}send(e,t,n){let r=l(this.config.nodeId,e,t,n);this.log("send:",`${this.config.nodeId} \u2192 ${e}`,t,n);let d=this.getTargetWindow(e);d?d.postMessage(s(r),"*"):this.warn("no target window for:",e)}on(e,t){return this.handlers.has(e)||this.handlers.set(e,new Set),this.handlers.get(e).add(t),()=>{let n=this.handlers.get(e);n&&(n.delete(t),n.size===0&&this.handlers.delete(e))}}addRoute(e,t){this.router?.addRoute(e,t)}removeRoute(e,t){this.router?.removeRoute(e,t)}handleMessage(e){if(e.origin&&!this.config.allowedOrigins.includes(e.origin))return;let t=u(e.data);if(t&&!(t.from===this.config.nodeId&&t.to===this.config.nodeId)){if(t.to!==this.config.nodeId){if(this.router?.process(t)){this.dispatch(t);return}return}this.dispatch(t)}}dispatch(e){let t=this.handlers.get(e.type);if(t)for(let n of t)try{n(e.payload,e)}catch(r){this.warn("handler error:",e.type,r)}}getTargetWindow(e){return this.config.parentWindow&&e!==this.config.nodeId?this.config.parentWindow:this.config.getChildWindow?this.config.getChildWindow():null}log(...e){this.config.debug&&console.log(`[OnePcBridge:${this.config.nodeId}]`,...e)}warn(...e){console.warn(`[OnePcBridge:${this.config.nodeId}]`,...e)}};export{c as OnePcBridge,o as Router,l as createEnvelope,u as parseEnvelope,s as serializeEnvelope};
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/envelope.js", "../src/router.js", "../src/MessageBridge.js"],
+  "sourcesContent": ["let _counter = 0\n\n/**\n * Generate a lightweight unique ID without external dependencies.\n * Uses timestamp + counter for uniqueness within a session.\n */\nfunction generateId() {\n  const ts = Date.now().toString(36)\n  const seq = (++_counter).toString(36)\n  return `mb_${ts}_${seq}`\n}\n\n/**\n * Create a new message envelope (new protocol format).\n */\nexport function createEnvelope(from, to, type, payload) {\n  return {\n    protocol: 'message-bridge-v1',\n    id: generateId(),\n    from,\n    to,\n    type,\n    payload: payload ?? null,\n    timestamp: Date.now(),\n  }\n}\n\n/**\n * Parse a raw postMessage event into an Envelope.\n * Supports both the new protocol format and the legacy format\n * for backward compatibility during migration.\n *\n * New format:\n *   { protocol: 'message-bridge-v1', from, to, type, payload, ... }\n *\n * Legacy format:\n *   { to, from, id, message: { subtype: 'webToPc', data: JSON.stringify({type, ...}) } }\n */\nexport function parseEnvelope(raw) {\n  if (!raw) return null\n\n  // --- New protocol ---\n  if (raw.protocol === 'message-bridge-v1') {\n    return raw\n  }\n\n  // --- Legacy format detection ---\n  const legacy = raw\n  if (legacy.message && legacy.message.subtype === 'webToPc') {\n    const data = legacy.message.data\n    let parsed\n\n    if (typeof data === 'string') {\n      try {\n        parsed = JSON.parse(data)\n      } catch {\n        return null\n      }\n    } else if (typeof data === 'object') {\n      parsed = data\n    } else {\n      return null\n    }\n\n    const { type, ...restPayload } = parsed\n    if (!type) return null\n\n    return {\n      protocol: 'message-bridge-v1',\n      id: legacy.id || generateId(),\n      from: detectFromNode(legacy.from),\n      to: detectToNode(legacy.to),\n      type: String(type),\n      payload: restPayload,\n      timestamp: Date.now(),\n    }\n  }\n\n  // Legacy: openclawToPc subtype\n  if (legacy.message && legacy.message.subtype === 'openclawToPc') {\n    return {\n      protocol: 'message-bridge-v1',\n      id: legacy.id || generateId(),\n      from: detectFromNode(legacy.from),\n      to: 'onepcweb',\n      type: 'openclawToPc',\n      payload: legacy.message.data,\n      timestamp: Date.now(),\n    }\n  }\n\n  return null\n}\n\n/**\n * Detect the source NodeId from legacy message's `from` field.\n */\nfunction detectFromNode(from) {\n  if (!from) return 'intelligent'\n  if (from.includes('openclaw') || from.includes('claw')) return 'openclaw'\n  if (from.includes('intelligent')) return 'intelligent'\n  if (from.includes('vantage') || from.includes('onepc')) return 'onepcweb'\n  return 'intelligent'\n}\n\n/**\n * Detect the target NodeId from legacy message's `to` field.\n */\nfunction detectToNode(to) {\n  if (!to) return 'intelligent'\n  if (to.includes('pcWeb') || to.includes('pcMessage')) return 'onepcweb'\n  if (to.includes('intelligent')) return 'intelligent'\n  if (to.includes('openclaw') || to.includes('claw')) return 'openclaw'\n  return 'intelligent'\n}\n\n/**\n * Serialize an Envelope for postMessage transmission.\n */\nexport function serializeEnvelope(envelope) {\n  return { ...envelope }\n}\n", "import { createEnvelope, serializeEnvelope } from './envelope'\n\n/**\n * Router manages automatic message forwarding for middle-layer nodes.\n */\nexport class Router {\n  constructor(opts = {}) {\n    this.routes = []\n    this.parentWindow = opts.parentWindow ?? null\n    this.getChildWindow = opts.getChildWindow ?? null\n    this.debug = opts.debug ?? false\n  }\n\n  addRoute(from, to) {\n    this.removeRoute(from, to)\n    this.routes.push({ from, to })\n    this.log('route registered:', `${from} \u2192 ${to}`)\n  }\n\n  removeRoute(from, to) {\n    this.routes = this.routes.filter(\n      r => !(r.from === from && r.to === to)\n    )\n  }\n\n  clearRoutes() {\n    this.routes = []\n  }\n\n  getForwardTarget(envelope) {\n    const route = this.routes.find(\n      r => r.from === envelope.from && r.to === envelope.to\n    )\n    if (!route) return null\n\n    if (envelope.to === 'onepcweb' && this.parentWindow) {\n      return this.parentWindow\n    }\n    if (envelope.from === 'onepcweb' && this.getChildWindow) {\n      return this.getChildWindow()\n    }\n    if (envelope.to !== 'intelligent' && this.parentWindow) {\n      return this.parentWindow\n    }\n\n    return null\n  }\n\n  forward(envelope) {\n    const target = this.getForwardTarget(envelope)\n    if (!target) return false\n\n    const body = serializeEnvelope(envelope)\n    target.postMessage(body, '*')\n    this.log('forwarded:', `${envelope.from} \u2192 ${envelope.to} via postMessage`, envelope.type)\n    return true\n  }\n\n  hasRoute(from, to) {\n    return this.routes.some(r => r.from === from && r.to === to)\n  }\n\n  process(envelope) {\n    if (this.hasRoute(envelope.from, envelope.to)) {\n      return this.forward(envelope)\n    }\n    return false\n  }\n\n  log(...args) {\n    if (this.debug) {\n      console.log('[OnePcBridge-Router]', ...args)\n    }\n  }\n}\n", "import { createEnvelope, parseEnvelope, serializeEnvelope } from './envelope'\nimport { Router } from './router'\n\n/**\n * OnePcBridge \u2014 unified cross-iframe communication SDK.\n *\n * Usage:\n *   // Leaf node (C - openclaw)\n *   const bridge = new OnePcBridge({\n *     nodeId: 'openclaw',\n *     allowedOrigins: ['https://...'],\n *     parentWindow: window.parent,\n *   })\n *   bridge.init()\n *   bridge.send('onepcweb', 'menu', { data: '...' })\n *\n *   // Middle node (B - intelligent-web)\n *   const bridge = new OnePcBridge({\n *     nodeId: 'intelligent',\n *     allowedOrigins: ['https://...', CHILD_ORIGIN],\n *     parentWindow: window.parent,\n *     getChildWindow: () => iframeRef.value?.contentWindow,\n *   })\n *   bridge.addRoute('openclaw', 'onepcweb')\n *   bridge.init()\n */\nexport class OnePcBridge {\n  constructor(config) {\n    this.config = config\n    this.handlers = new Map()\n    this.router = new Router({\n      parentWindow: config.parentWindow,\n      getChildWindow: config.getChildWindow,\n      debug: config.debug ?? false,\n    })\n    this.messageHandler = null\n    this.initialized = false\n  }\n\n  init() {\n    if (this.initialized) return\n\n    this.messageHandler = this.handleMessage.bind(this)\n    window.addEventListener('message', this.messageHandler)\n    this.initialized = true\n    this.log('initialized', this.config.nodeId)\n  }\n\n  destroy() {\n    if (this.messageHandler) {\n      window.removeEventListener('message', this.messageHandler)\n      this.messageHandler = null\n    }\n    this.handlers.clear()\n    this.initialized = false\n    this.log('destroyed')\n  }\n\n  send(target, type, payload) {\n    const envelope = createEnvelope(this.config.nodeId, target, type, payload)\n    this.log('send:', `${this.config.nodeId} \u2192 ${target}`, type, payload)\n\n    const targetWindow = this.getTargetWindow(target)\n    if (targetWindow) {\n      targetWindow.postMessage(serializeEnvelope(envelope), '*')\n    } else {\n      this.warn('no target window for:', target)\n    }\n  }\n\n  on(type, handler) {\n    if (!this.handlers.has(type)) {\n      this.handlers.set(type, new Set())\n    }\n    this.handlers.get(type).add(handler)\n\n    return () => {\n      const set = this.handlers.get(type)\n      if (set) {\n        set.delete(handler)\n        if (set.size === 0) {\n          this.handlers.delete(type)\n        }\n      }\n    }\n  }\n\n  addRoute(from, to) {\n    this.router?.addRoute(from, to)\n  }\n\n  removeRoute(from, to) {\n    this.router?.removeRoute(from, to)\n  }\n\n  // \u2500\u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  handleMessage(event) {\n    if (event.origin && !this.config.allowedOrigins.includes(event.origin)) {\n      return\n    }\n\n    const envelope = parseEnvelope(event.data)\n    if (!envelope) return\n\n    if (envelope.from === this.config.nodeId && envelope.to === this.config.nodeId) {\n      return\n    }\n\n    if (envelope.to !== this.config.nodeId) {\n      if (this.router?.process(envelope)) {\n        this.dispatch(envelope)\n        return\n      }\n      return\n    }\n\n    this.dispatch(envelope)\n  }\n\n  dispatch(envelope) {\n    const typeHandlers = this.handlers.get(envelope.type)\n    if (typeHandlers) {\n      for (const handler of typeHandlers) {\n        try {\n          handler(envelope.payload, envelope)\n        } catch (err) {\n          this.warn('handler error:', envelope.type, err)\n        }\n      }\n    }\n  }\n\n  getTargetWindow(target) {\n    if (this.config.parentWindow && target !== this.config.nodeId) {\n      return this.config.parentWindow\n    }\n    if (this.config.getChildWindow) {\n      return this.config.getChildWindow()\n    }\n    return null\n  }\n\n  log(...args) {\n    if (this.config.debug) {\n      console.log(`[OnePcBridge:${this.config.nodeId}]`, ...args)\n    }\n  }\n\n  warn(...args) {\n    console.warn(`[OnePcBridge:${this.config.nodeId}]`, ...args)\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["_counter", "generateId", "ts", "seq", "createEnvelope", "from", "to", "type", "payload", "parseEnvelope", "raw", "legacy", "data", "parsed", "restPayload", "detectFromNode", "detectToNode", "serializeEnvelope", "envelope", "Router", "opts", "from", "to", "r", "envelope", "target", "body", "serializeEnvelope", "args", "OnePcBridge", "config", "Router", "target", "type", "payload", "envelope", "createEnvelope", "targetWindow", "serializeEnvelope", "handler", "set", "from", "to", "event", "parseEnvelope", "typeHandlers", "err", "args"]
+}

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+export type NodeId = 'onepcweb' | 'intelligent' | 'openclaw'
+
+export interface Envelope {
+  protocol: 'message-bridge-v1'
+  id: string
+  from: NodeId
+  to: NodeId
+  type: string
+  payload: any
+  timestamp: number
+}
+
+export interface Config {
+  nodeId: NodeId
+  allowedOrigins: string[]
+  parentWindow?: Window
+  getChildWindow?: () => Window | null
+  debug?: boolean
+}
+
+export type Unsubscribe = () => void
+
+export type MessageHandler = (payload: any, envelope: Envelope) => void
+
+export class OnePcBridge {
+  constructor(config: Config)
+  init(): void
+  destroy(): void
+  send(target: NodeId, type: string, payload?: any): void
+  on(type: string, handler: MessageHandler): Unsubscribe
+  addRoute(from: NodeId, to: NodeId): void
+  removeRoute(from: NodeId, to: NodeId): void
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@zhyi64/message-bridge",
+  "version": "0.1.0",
+  "description": "Unified cross-iframe communication SDK for nested iframe architecture (onepcweb → intelligent-web → openclaw)",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/types.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "node build.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "iframe",
+    "postMessage",
+    "bridge",
+    "communication",
+    "onepcweb"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.0"
+  }
+}

package/src/MessageBridge.js

@@ -0,0 +1,153 @@
+import { createEnvelope, parseEnvelope, serializeEnvelope } from './envelope'
+import { Router } from './router'
+
+/**
+ * OnePcBridge — unified cross-iframe communication SDK.
+ *
+ * Usage:
+ *   // Leaf node (C - openclaw)
+ *   const bridge = new OnePcBridge({
+ *     nodeId: 'openclaw',
+ *     allowedOrigins: ['https://...'],
+ *     parentWindow: window.parent,
+ *   })
+ *   bridge.init()
+ *   bridge.send('onepcweb', 'menu', { data: '...' })
+ *
+ *   // Middle node (B - intelligent-web)
+ *   const bridge = new OnePcBridge({
+ *     nodeId: 'intelligent',
+ *     allowedOrigins: ['https://...', CHILD_ORIGIN],
+ *     parentWindow: window.parent,
+ *     getChildWindow: () => iframeRef.value?.contentWindow,
+ *   })
+ *   bridge.addRoute('openclaw', 'onepcweb')
+ *   bridge.init()
+ */
+export class OnePcBridge {
+  constructor(config) {
+    this.config = config
+    this.handlers = new Map()
+    this.router = new Router({
+      parentWindow: config.parentWindow,
+      getChildWindow: config.getChildWindow,
+      debug: config.debug ?? false,
+    })
+    this.messageHandler = null
+    this.initialized = false
+  }
+
+  init() {
+    if (this.initialized) return
+
+    this.messageHandler = this.handleMessage.bind(this)
+    window.addEventListener('message', this.messageHandler)
+    this.initialized = true
+    this.log('initialized', this.config.nodeId)
+  }
+
+  destroy() {
+    if (this.messageHandler) {
+      window.removeEventListener('message', this.messageHandler)
+      this.messageHandler = null
+    }
+    this.handlers.clear()
+    this.initialized = false
+    this.log('destroyed')
+  }
+
+  send(target, type, payload) {
+    const envelope = createEnvelope(this.config.nodeId, target, type, payload)
+    this.log('send:', `${this.config.nodeId} → ${target}`, type, payload)
+
+    const targetWindow = this.getTargetWindow(target)
+    if (targetWindow) {
+      targetWindow.postMessage(serializeEnvelope(envelope), '*')
+    } else {
+      this.warn('no target window for:', target)
+    }
+  }
+
+  on(type, handler) {
+    if (!this.handlers.has(type)) {
+      this.handlers.set(type, new Set())
+    }
+    this.handlers.get(type).add(handler)
+
+    return () => {
+      const set = this.handlers.get(type)
+      if (set) {
+        set.delete(handler)
+        if (set.size === 0) {
+          this.handlers.delete(type)
+        }
+      }
+    }
+  }
+
+  addRoute(from, to) {
+    this.router?.addRoute(from, to)
+  }
+
+  removeRoute(from, to) {
+    this.router?.removeRoute(from, to)
+  }
+
+  // ─── Private ────────────────────────────────────────────────
+
+  handleMessage(event) {
+    if (event.origin && !this.config.allowedOrigins.includes(event.origin)) {
+      return
+    }
+
+    const envelope = parseEnvelope(event.data)
+    if (!envelope) return
+
+    if (envelope.from === this.config.nodeId && envelope.to === this.config.nodeId) {
+      return
+    }
+
+    if (envelope.to !== this.config.nodeId) {
+      if (this.router?.process(envelope)) {
+        this.dispatch(envelope)
+        return
+      }
+      return
+    }
+
+    this.dispatch(envelope)
+  }
+
+  dispatch(envelope) {
+    const typeHandlers = this.handlers.get(envelope.type)
+    if (typeHandlers) {
+      for (const handler of typeHandlers) {
+        try {
+          handler(envelope.payload, envelope)
+        } catch (err) {
+          this.warn('handler error:', envelope.type, err)
+        }
+      }
+    }
+  }
+
+  getTargetWindow(target) {
+    if (this.config.parentWindow && target !== this.config.nodeId) {
+      return this.config.parentWindow
+    }
+    if (this.config.getChildWindow) {
+      return this.config.getChildWindow()
+    }
+    return null
+  }
+
+  log(...args) {
+    if (this.config.debug) {
+      console.log(`[OnePcBridge:${this.config.nodeId}]`, ...args)
+    }
+  }
+
+  warn(...args) {
+    console.warn(`[OnePcBridge:${this.config.nodeId}]`, ...args)
+  }
+}

package/src/envelope.js

@@ -0,0 +1,122 @@
+let _counter = 0
+
+/**
+ * Generate a lightweight unique ID without external dependencies.
+ * Uses timestamp + counter for uniqueness within a session.
+ */
+function generateId() {
+  const ts = Date.now().toString(36)
+  const seq = (++_counter).toString(36)
+  return `mb_${ts}_${seq}`
+}
+
+/**
+ * Create a new message envelope (new protocol format).
+ */
+export function createEnvelope(from, to, type, payload) {
+  return {
+    protocol: 'message-bridge-v1',
+    id: generateId(),
+    from,
+    to,
+    type,
+    payload: payload ?? null,
+    timestamp: Date.now(),
+  }
+}
+
+/**
+ * Parse a raw postMessage event into an Envelope.
+ * Supports both the new protocol format and the legacy format
+ * for backward compatibility during migration.
+ *
+ * New format:
+ *   { protocol: 'message-bridge-v1', from, to, type, payload, ... }
+ *
+ * Legacy format:
+ *   { to, from, id, message: { subtype: 'webToPc', data: JSON.stringify({type, ...}) } }
+ */
+export function parseEnvelope(raw) {
+  if (!raw) return null
+
+  // --- New protocol ---
+  if (raw.protocol === 'message-bridge-v1') {
+    return raw
+  }
+
+  // --- Legacy format detection ---
+  const legacy = raw
+  if (legacy.message && legacy.message.subtype === 'webToPc') {
+    const data = legacy.message.data
+    let parsed
+
+    if (typeof data === 'string') {
+      try {
+        parsed = JSON.parse(data)
+      } catch {
+        return null
+      }
+    } else if (typeof data === 'object') {
+      parsed = data
+    } else {
+      return null
+    }
+
+    const { type, ...restPayload } = parsed
+    if (!type) return null
+
+    return {
+      protocol: 'message-bridge-v1',
+      id: legacy.id || generateId(),
+      from: detectFromNode(legacy.from),
+      to: detectToNode(legacy.to),
+      type: String(type),
+      payload: restPayload,
+      timestamp: Date.now(),
+    }
+  }
+
+  // Legacy: openclawToPc subtype
+  if (legacy.message && legacy.message.subtype === 'openclawToPc') {
+    return {
+      protocol: 'message-bridge-v1',
+      id: legacy.id || generateId(),
+      from: detectFromNode(legacy.from),
+      to: 'onepcweb',
+      type: 'openclawToPc',
+      payload: legacy.message.data,
+      timestamp: Date.now(),
+    }
+  }
+
+  return null
+}
+
+/**
+ * Detect the source NodeId from legacy message's `from` field.
+ */
+function detectFromNode(from) {
+  if (!from) return 'intelligent'
+  if (from.includes('openclaw') || from.includes('claw')) return 'openclaw'
+  if (from.includes('intelligent')) return 'intelligent'
+  if (from.includes('vantage') || from.includes('onepc')) return 'onepcweb'
+  return 'intelligent'
+}
+
+/**
+ * Detect the target NodeId from legacy message's `to` field.
+ */
+function detectToNode(to) {
+  if (!to) return 'intelligent'
+  if (to.includes('pcWeb') || to.includes('pcMessage')) return 'onepcweb'
+  if (to.includes('intelligent')) return 'intelligent'
+  if (to.includes('openclaw') || to.includes('claw')) return 'openclaw'
+  return 'intelligent'
+}
+
+/**
+ * Serialize an Envelope for postMessage transmission.
+ */
+export function serializeEnvelope(envelope) {
+  return { ...envelope }
+}

package/src/index.js

@@ -0,0 +1,3 @@
+export { OnePcBridge } from './MessageBridge'
+export { createEnvelope, parseEnvelope, serializeEnvelope } from './envelope'
+export { Router } from './router'

package/src/router.js

@@ -0,0 +1,75 @@
+import { createEnvelope, serializeEnvelope } from './envelope'
+
+/**
+ * Router manages automatic message forwarding for middle-layer nodes.
+ */
+export class Router {
+  constructor(opts = {}) {
+    this.routes = []
+    this.parentWindow = opts.parentWindow ?? null
+    this.getChildWindow = opts.getChildWindow ?? null
+    this.debug = opts.debug ?? false
+  }
+
+  addRoute(from, to) {
+    this.removeRoute(from, to)
+    this.routes.push({ from, to })
+    this.log('route registered:', `${from} → ${to}`)
+  }
+
+  removeRoute(from, to) {
+    this.routes = this.routes.filter(
+      r => !(r.from === from && r.to === to)
+    )
+  }
+
+  clearRoutes() {
+    this.routes = []
+  }
+
+  getForwardTarget(envelope) {
+    const route = this.routes.find(
+      r => r.from === envelope.from && r.to === envelope.to
+    )
+    if (!route) return null
+
+    if (envelope.to === 'onepcweb' && this.parentWindow) {
+      return this.parentWindow
+    }
+    if (envelope.from === 'onepcweb' && this.getChildWindow) {
+      return this.getChildWindow()
+    }
+    if (envelope.to !== 'intelligent' && this.parentWindow) {
+      return this.parentWindow
+    }
+
+    return null
+  }
+
+  forward(envelope) {
+    const target = this.getForwardTarget(envelope)
+    if (!target) return false
+
+    const body = serializeEnvelope(envelope)
+    target.postMessage(body, '*')
+    this.log('forwarded:', `${envelope.from} → ${envelope.to} via postMessage`, envelope.type)
+    return true
+  }
+
+  hasRoute(from, to) {
+    return this.routes.some(r => r.from === from && r.to === to)
+  }
+
+  process(envelope) {
+    if (this.hasRoute(envelope.from, envelope.to)) {
+      return this.forward(envelope)
+    }
+    return false
+  }
+
+  log(...args) {
+    if (this.debug) {
+      console.log('[OnePcBridge-Router]', ...args)
+    }
+  }
+}

package/src/types.d.ts

@@ -0,0 +1,33 @@
+export type NodeId = 'onepcweb' | 'intelligent' | 'openclaw'
+
+export interface Envelope {
+  protocol: 'message-bridge-v1'
+  id: string
+  from: NodeId
+  to: NodeId
+  type: string
+  payload: any
+  timestamp: number
+}
+
+export interface Config {
+  nodeId: NodeId
+  allowedOrigins: string[]
+  parentWindow?: Window
+  getChildWindow?: () => Window | null
+  debug?: boolean
+}
+
+export type Unsubscribe = () => void
+
+export type MessageHandler = (payload: any, envelope: Envelope) => void
+
+export class OnePcBridge {
+  constructor(config: Config)
+  init(): void
+  destroy(): void
+  send(target: NodeId, type: string, payload?: any): void
+  on(type: string, handler: MessageHandler): Unsubscribe
+  addRoute(from: NodeId, to: NodeId): void
+  removeRoute(from: NodeId, to: NodeId): void
+}