@smartorg/bridge-client

Typed postMessage bridge between aiNav (iframe) and Rakaposhi (host).

Install

npm install github:SmartOrgDevelopment/bridge-client

Usage

aiNav (iframe side)

import{createAiNavBridge}from"@smartorg/bridge-client";constbridge=createAiNavBridge({allowedOrigins: ["https://app.smartorg.com"],strictOriginCheck: true,});bridge.send("NODE_DATA_UPDATED",{tool_name: "save_node_description",node_data: {nodeId: "...",treeId: "...",nodeName: "..."},});

Rakaposhi (host side)

import{createHostBridge}from"@smartorg/bridge-client";constbridge=createHostBridge({allowedOrigins: ["https://ainav.smartorg.com"],strictOriginCheck: true,});constunsubscribe=bridge.onMessage({type: "NODE_DATA_UPDATED",handler: (payload)=>{// typed payload},});// Cleanup on destroyunsubscribe();bridge.destroy();

With Zod validation

import{z}from"zod";constNodeDataSchema=z.object({nodeId: z.string(),treeId: z.string(),});bridge.onMessage({type: "NODE_DATA_UPDATED",schema: NodeDataSchema,handler: (payload)=>{// payload is typed as z.infer<typeof NodeDataSchema>// schema mismatch logs an error instead of crashing},});

API

createBridge(options)

Option	Type	Default	Description
source	"ainav-web" | "rakaposhi-host"	required	Identifies the caller
allowedOrigins	string[]	[]	Allowed origins (empty = allow all)
strictOriginCheck	boolean	false	Enable origin validation
targetOrigin	string	"*"	Target origin for postMessage
validate	boolean	true	Validate outgoing envelope schema

createAiNavBridge(options) / createHostBridge(options)

Shorthands that set source automatically.

bridge.send(type, payload)

Send a message to the host window.

bridge.onMessage(handler) → unsubscribe()

Register a typed handler. Returns a cleanup function.

bridge.destroy()

Remove listeners and release resources.