@schoolpalm/message-bridge 1.1.0 → 1.3.0

package/dist/bridgeBase.d.ts

@@ -1,69 +1,18 @@
-/**
- * @fileoverview Base bridge class for message-based communication.
- * @module @schoolpalm/message-bridge/bridgeBase
- */
 import { MessageType } from './messageTypes';
-import { MessagePayload } from './payloadSchemas';
-/**
- * Type definition for message handler functions.
- * @template T - The type of message payload this handler accepts.
- */
-type MessageHandler<T extends MessagePayload> = (payload: T) => void;
-/**
- * Base class for Host and Module bridges.
- *
- * This abstract base class provides the core functionality for message-based
- * communication between windows using the postMessage API. It handles sending
- * messages, registering listeners, and managing event listeners.
- *
- * @example
- * ```typescript
- * class CustomBridge extends BridgeBase {
- *   constructor(targetWindow: Window) {
- *     super(targetWindow, 'https://example.com');
- *   }
- *
- *   // Add custom methods here
- * }
- * ```
- */
+import { MessagePayloadMap } from './payloadSchemas';
+import { RequestPayload } from './payloadSchemas';
+type MessageHandler<T> = (payload: T) => void;
 export declare class BridgeBase {
-    /** The target window to send messages to. */
     protected targetWindow: Window;
-    /** The origin to restrict messages to. */
     protected targetOrigin: string;
-    /** Map of message type to array of handler functions. */
     private listeners;
-    /**
-     * Creates a new BridgeBase instance.
-     * @param targetWindow - The window to send messages to.
-     * @param targetOrigin - The origin to restrict messages to (default: '*').
-     */
+    private pendingRequests;
+    private boundHandler;
     constructor(targetWindow: Window, targetOrigin?: string);
-    /**
-     * Sends a message to the target window.
-     * @template T - The type of the message payload.
-     * @param type - The message type to send.
-     * @param payload - The payload data to send.
-     */
-    send<T extends MessagePayload>(type: MessageType, payload: T): void;
-    /**
-     * Registers a listener for a specific message type.
-     * @template T - The type of the message payload.
-     * @param type - The message type to listen for.
-     * @param callback - The function to call when a message of this type is received.
-     */
-    on<T extends MessagePayload>(type: MessageType, callback: MessageHandler<T>): void;
-    /**
-     * Internal message handler for incoming postMessage events.
-     * @private
-     * @param event - The message event received.
-     */
-    private _handleMessage;
-    /**
-     * Cleans up event listeners and resources.
-     * Call this method when the bridge is no longer needed.
-     */
+    send<T extends MessageType>(type: T, payload: MessagePayloadMap[T]): void;
+    request<R = any>(type: MessageType, payload: RequestPayload, timeout?: number): Promise<R>;
+    on<T extends MessageType>(type: T, callback: MessageHandler<MessagePayloadMap[T]>): void;
+    protected handleMessage(event: MessageEvent): void;
     destroy(): void;
 }
 export {};

package/dist/bridgeBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridgeBase.d.ts","sourceRoot":"","sources":["../src/bridgeBase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,KAAK,cAAc,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAU;IACrB,6CAA6C;IAC7C,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,OAAO,CAAC,SAAS,CAAsD;IAEvE;;;;OAIG;gBACS,YAAY,EAAE,MAAM,EAAE,YAAY,GAAE,MAAY;IAM5D;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAI5D;;;;;OAKG;IACH,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;IAK3E;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAMtB;;;OAGG;IACH,OAAO;CAIR"}
+{"version":3,"file":"bridgeBase.d.ts","sourceRoot":"","sources":["../src/bridgeBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAA;AAElE,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AAE7C,qBAAa,UAAU;IACrB,SAAS,CAAC,YAAY,EAAE,MAAM,CAAA;IAC9B,SAAS,CAAC,YAAY,EAAE,MAAM,CAAA;IAE9B,OAAO,CAAC,SAAS,CAAgD;IACjE,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,YAAY,CAA+B;gBAEvC,YAAY,EAAE,MAAM,EAAE,YAAY,GAAE,MAAY;IAW5D,IAAI,CAAC,CAAC,SAAS,WAAW,EACxB,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAQhC,OAAO,CAAC,CAAC,GAAG,GAAG,EACd,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,cAAc,EACvB,OAAO,SAAO,GACb,OAAO,CAAC,CAAC,CAAC;IA2BX,EAAE,CAAC,CAAC,SAAS,WAAW,EACtB,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAWhD,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY;IAqB3C,OAAO;CAKR"}

package/dist/bridgeBase.js

@@ -1,76 +1,77 @@
-/**
- * @fileoverview Base bridge class for message-based communication.
- * @module @schoolpalm/message-bridge/bridgeBase
- */
-/**
- * Base class for Host and Module bridges.
- *
- * This abstract base class provides the core functionality for message-based
- * communication between windows using the postMessage API. It handles sending
- * messages, registering listeners, and managing event listeners.
- *
- * @example
- * ```typescript
- * class CustomBridge extends BridgeBase {
- *   constructor(targetWindow: Window) {
- *     super(targetWindow, 'https://example.com');
- *   }
- *
- *   // Add custom methods here
- * }
- * ```
- */
+import { MessageType } from './messageTypes';
 export class BridgeBase {
-    /**
-     * Creates a new BridgeBase instance.
-     * @param targetWindow - The window to send messages to.
-     * @param targetOrigin - The origin to restrict messages to (default: '*').
-     */
     constructor(targetWindow, targetOrigin = '*') {
-        /** Map of message type to array of handler functions. */
         this.listeners = new Map();
+        this.pendingRequests = new Map();
         this.targetWindow = targetWindow;
         this.targetOrigin = targetOrigin;
-        window.addEventListener('message', this._handleMessage.bind(this));
+        this.boundHandler = this.handleMessage.bind(this);
+        window.addEventListener('message', this.boundHandler);
     }
-    /**
-     * Sends a message to the target window.
-     * @template T - The type of the message payload.
-     * @param type - The message type to send.
-     * @param payload - The payload data to send.
-     */
+    // --------------------
+    // Send (typed)
+    // --------------------
     send(type, payload) {
         this.targetWindow.postMessage({ type, payload }, this.targetOrigin);
     }
-    /**
-     * Registers a listener for a specific message type.
-     * @template T - The type of the message payload.
-     * @param type - The message type to listen for.
-     * @param callback - The function to call when a message of this type is received.
-     */
+    // --------------------
+    // Request / Response
+    // --------------------
+    request(type, payload, timeout = 5000) {
+        return new Promise((resolve, reject) => {
+            const requestId = payload.requestId;
+            this.pendingRequests.set(requestId, (response) => {
+                if (response.status === 'error') {
+                    reject(new Error(response.error ?? 'Unknown error'));
+                }
+                else {
+                    resolve(response.payload);
+                }
+            });
+            this.send(type, payload);
+            setTimeout(() => {
+                if (this.pendingRequests.has(requestId)) {
+                    this.pendingRequests.delete(requestId);
+                    reject(new Error(`Request ${payload.type} timed out`));
+                }
+            }, timeout);
+        });
+    }
+    // --------------------
+    // Listeners (typed)
+    // --------------------
     on(type, callback) {
-        if (!this.listeners.has(type))
+        if (!this.listeners.has(type)) {
             this.listeners.set(type, []);
-        this.listeners.get(type)?.push(callback);
+        }
+        this.listeners.get(type).push(callback);
     }
-    /**
-     * Internal message handler for incoming postMessage events.
-     * @private
-     * @param event - The message event received.
-     */
-    _handleMessage(event) {
+    // --------------------
+    // Dispatcher
+    // --------------------
+    handleMessage(event) {
+        if (this.targetOrigin !== '*' && event.origin !== this.targetOrigin)
+            return;
         const { type, payload } = event.data || {};
-        if (!type || !this.listeners.has(type))
+        if (!type)
             return;
-        this.listeners.get(type)?.forEach(cb => cb(payload));
+        // Handle responses
+        if (type === MessageType.DATA_RESPONSE) {
+            const response = payload;
+            const resolver = this.pendingRequests.get(response.requestId);
+            if (resolver) {
+                resolver(response);
+                this.pendingRequests.delete(response.requestId);
+                return;
+            }
+        }
+        const handlers = this.listeners.get(type);
+        handlers?.forEach(cb => cb(payload));
     }
-    /**
-     * Cleans up event listeners and resources.
-     * Call this method when the bridge is no longer needed.
-     */
     destroy() {
-        window.removeEventListener('message', this._handleMessage.bind(this));
+        window.removeEventListener('message', this.boundHandler);
         this.listeners.clear();
+        this.pendingRequests.clear();
     }
 }
 //# sourceMappingURL=bridgeBase.js.map

package/dist/bridgeBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridgeBase.js","sourceRoot":"","sources":["../src/bridgeBase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,UAAU;IAQrB;;;;OAIG;IACH,YAAY,YAAoB,EAAE,eAAuB,GAAG;QAR5D,yDAAyD;QACjD,cAAS,GAA4C,IAAI,GAAG,EAAE,CAAC;QAQrE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAA2B,IAAiB,EAAE,OAAU;QAC1D,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,EAAE,CAA2B,IAAiB,EAAE,QAA2B;QACzE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,KAAmB;QACxC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"bridgeBase.js","sourceRoot":"","sources":["../src/bridgeBase.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class BridgeError extends Error {
+    code: string;
+    constructor(message: string, code: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IACA,IAAI,EAAE,MAAM;gBAApC,OAAO,EAAE,MAAM,EAAS,IAAI,EAAE,MAAM;CAGjD"}

package/dist/errors.js

@@ -0,0 +1,7 @@
+export class BridgeError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe,EAAS,IAAY;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAA;QADoB,SAAI,GAAJ,IAAI,CAAQ;IAEhD,CAAC;CACF"}

package/dist/hostBridge.d.ts

@@ -1,52 +1,23 @@
-/**
- * @fileoverview Host-side bridge for communication with embedded modules.
- * @module @schoolpalm/message-bridge/hostBridge
- */
 import { BridgeBase } from './bridgeBase';
-import { ModuleStartPayload } from './payloadSchemas';
-/**
- * Host-side bridge for communication with embedded modules.
- *
- * This class extends BridgeBase to provide host-specific functionality for
- * communicating with modules embedded in iframes. It handles initialization
- * and termination of modules.
- *
- * @example
- * ```typescript
- * const iframe = document.getElementById('module-iframe') as HTMLIFrameElement;
- * const hostBridge = new HostBridge(iframe, 'https://module.example.com');
- *
- * // Start a module
- * hostBridge.sendModuleStart({
- *   route: '/dashboard',
- *   context: { userId: 123 },
- *   timestamp: Date.now()
- * });
- *
- * // Listen for UI updates from the module
- * hostBridge.on(MessageType.UI_UPDATE, (payload) => {
- *   console.log('UI Update:', payload);
- * });
- * ```
- */
+import { ModuleStartPayload, UIUpdatePayload, ErrorPayload, ModuleContextPayload, HandshakeReadyPayload } from './payloadSchemas';
 export declare class HostBridge extends BridgeBase {
-    /**
-     * Creates a new HostBridge instance.
-     * @param iframe - The iframe element containing the module.
-     * @param targetOrigin - The origin to restrict messages to (default: '*').
-     */
+    private handshakeCompleted;
+    private handshakePayload;
+    private pendingStartPayload;
     constructor(iframe: HTMLIFrameElement, targetOrigin?: string);
-    /**
-     * Sends a module-start message to the embedded module.
-     * This initializes the module with the provided route and context.
-     * @param payload - The module start payload containing route, context, and timestamp.
-     */
+    onHandshakeReady(callback: (payload: HandshakeReadyPayload) => void): void;
+    private heartbeatTimer?;
+    startHeartbeat(interval?: number): void;
+    stopHeartbeat(): void;
+    private lastHeartbeat;
+    listenHeartbeat(timeout?: number): void;
+    startModule(payload: ModuleStartPayload, timeout?: number): void;
     sendModuleStart(payload: ModuleStartPayload): void;
-    /**
-     * Sends a module-exit message to the embedded module.
-     * This signals the module to clean up and terminate.
-     * @param reason - Optional reason for the module exit.
-     */
     sendModuleExit(reason?: string): void;
+    onUIUpdate(callback: (payload: UIUpdatePayload) => void): void;
+    onError(callback: (payload: ErrorPayload) => void): void;
+    sendContextUpdate(payload: ModuleContextPayload): void;
+    requestData<T = any, R = any>(type: string, payload?: T, timeout?: number): Promise<R>;
+    reset(): void;
 }
 //# sourceMappingURL=hostBridge.d.ts.map

package/dist/hostBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostBridge.d.ts","sourceRoot":"","sources":["../src/hostBridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC;;;;OAIG;gBACS,MAAM,EAAE,iBAAiB,EAAE,YAAY,GAAE,MAAY;IAIjE;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,kBAAkB;IAI3C;;;;OAIG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM;CAG/B"}
+{"version":3,"file":"hostBridge.d.ts","sourceRoot":"","sources":["../src/hostBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EACL,kBAAkB,EAElB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EAGtB,MAAM,kBAAkB,CAAA;AAGzB,qBAAa,UAAW,SAAQ,UAAU;IACxC,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,mBAAmB,CAAkC;gBAEjD,MAAM,EAAE,iBAAiB,EAAE,YAAY,GAAE,MAAY;IAUnE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI;IA2BnE,OAAO,CAAC,cAAc,CAAC,CAAQ;IAE/B,cAAc,CAAC,QAAQ,SAAO;IAS9B,aAAa;IAOb,OAAO,CAAC,aAAa,CAAa;IAElC,eAAe,CAAC,OAAO,SAAQ;IAiB7B,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,SAAO;IAevD,eAAe,CAAC,OAAO,EAAE,kBAAkB;IAI3C,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM;IAO9B,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI;IAIvD,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI;IAOjD,iBAAiB,CAAC,OAAO,EAAE,oBAAoB;IAOhD,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,CAAC,EACX,OAAO,SAAO,GACb,OAAO,CAAC,CAAC,CAAC;IAiBX,KAAK;CAKN"}

package/dist/hostBridge.js

@@ -1,59 +1,115 @@
-/**
- * @fileoverview Host-side bridge for communication with embedded modules.
- * @module @schoolpalm/message-bridge/hostBridge
- */
-// src/hostBridge.ts
 import { BridgeBase } from './bridgeBase';
 import { MessageType } from './messageTypes';
-/**
- * Host-side bridge for communication with embedded modules.
- *
- * This class extends BridgeBase to provide host-specific functionality for
- * communicating with modules embedded in iframes. It handles initialization
- * and termination of modules.
- *
- * @example
- * ```typescript
- * const iframe = document.getElementById('module-iframe') as HTMLIFrameElement;
- * const hostBridge = new HostBridge(iframe, 'https://module.example.com');
- *
- * // Start a module
- * hostBridge.sendModuleStart({
- *   route: '/dashboard',
- *   context: { userId: 123 },
- *   timestamp: Date.now()
- * });
- *
- * // Listen for UI updates from the module
- * hostBridge.on(MessageType.UI_UPDATE, (payload) => {
- *   console.log('UI Update:', payload);
- * });
- * ```
- */
+import { PROTOCOL_VERSION } from './protocol';
 export class HostBridge extends BridgeBase {
-    /**
-     * Creates a new HostBridge instance.
-     * @param iframe - The iframe element containing the module.
-     * @param targetOrigin - The origin to restrict messages to (default: '*').
-     */
     constructor(iframe, targetOrigin = '*') {
+        if (!iframe.contentWindow) {
+            throw new Error('Iframe has no contentWindow');
+        }
         super(iframe.contentWindow, targetOrigin);
+        this.handshakeCompleted = false;
+        this.handshakePayload = null;
+        this.pendingStartPayload = null;
+        this.lastHeartbeat = Date.now();
+    }
+    // --------------------
+    // Handshake (sticky)
+    // --------------------
+    onHandshakeReady(callback) {
+        if (this.handshakeCompleted && this.handshakePayload) {
+            callback(this.handshakePayload);
+            return;
+        }
+        this.on(MessageType.HANDSHAKE_READY, payload => {
+            // ✅ payload is HandshakeReadyPayload
+            if (payload.version !== PROTOCOL_VERSION) {
+                console.warn(`Protocol mismatch: host=${PROTOCOL_VERSION}, module=${payload.version}`);
+            }
+            this.handshakeCompleted = true;
+            this.handshakePayload = payload;
+            callback(payload);
+            if (this.pendingStartPayload) {
+                this.sendModuleStart(this.pendingStartPayload);
+                this.pendingStartPayload = null;
+            }
+        });
+    }
+    startHeartbeat(interval = 5000) {
+        this.stopHeartbeat();
+        this.heartbeatTimer = window.setInterval(() => {
+            this.send(MessageType.HEARTBEAT, { timestamp: Date.now() });
+        }, interval);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+    }
+    listenHeartbeat(timeout = 15000) {
+        this.on(MessageType.HEARTBEAT, () => {
+            this.lastHeartbeat = Date.now();
+        });
+        setInterval(() => {
+            if (Date.now() - this.lastHeartbeat > timeout) {
+                console.error('Module heartbeat lost');
+                this.sendModuleExit('heartbeat-timeout');
+            }
+        }, timeout);
+    }
+    // --------------------
+    // Start (idempotent)
+    // --------------------
+    startModule(payload, timeout = 5000) {
+        if (this.handshakeCompleted) {
+            this.sendModuleStart(payload);
+            return;
+        }
+        this.pendingStartPayload = payload;
+        const timer = setTimeout(() => {
+            console.error('Module handshake timeout');
+        }, timeout);
+        this.onHandshakeReady(() => clearTimeout(timer));
     }
-    /**
-     * Sends a module-start message to the embedded module.
-     * This initializes the module with the provided route and context.
-     * @param payload - The module start payload containing route, context, and timestamp.
-     */
     sendModuleStart(payload) {
         this.send(MessageType.MODULE_START, payload);
     }
-    /**
-     * Sends a module-exit message to the embedded module.
-     * This signals the module to clean up and terminate.
-     * @param reason - Optional reason for the module exit.
-     */
     sendModuleExit(reason) {
         this.send(MessageType.MODULE_EXIT, { reason });
     }
+    // --------------------
+    // UI / Errors
+    // --------------------
+    onUIUpdate(callback) {
+        this.on(MessageType.UI_UPDATE, callback);
+    }
+    onError(callback) {
+        this.on(MessageType.ERROR, callback);
+    }
+    // --------------------
+    // Context sync
+    // --------------------
+    sendContextUpdate(payload) {
+        this.send(MessageType.CONTEXT_UPDATE, payload);
+    }
+    // --------------------
+    // Requests
+    // --------------------
+    requestData(type, payload, timeout = 5000) {
+        const request = {
+            requestId: crypto.randomUUID(),
+            type,
+            payload: payload,
+        };
+        return this.request(MessageType.DATA_REQUEST, request, timeout);
+    }
+    // --------------------
+    // Reset (reconnect)
+    // --------------------
+    reset() {
+        this.handshakeCompleted = false;
+        this.handshakePayload = null;
+        this.pendingStartPayload = null;
+    }
 }
 //# sourceMappingURL=hostBridge.js.map

package/dist/hostBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"hostBridge.js","sourceRoot":"","sources":["../src/hostBridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IACxC;;;;OAIG;IACH,YAAY,MAAyB,EAAE,eAAuB,GAAG;QAC/D,KAAK,CAAC,MAAM,CAAC,aAAc,EAAE,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,OAA2B;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,MAAe;QAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"hostBridge.js","sourceRoot":"","sources":["../src/hostBridge.ts"],"names":[],"mappings":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,2 @@
+export declare const debug: (...args: any[]) => void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,GAAG,EAAE,SAGnC,CAAA"}

package/dist/logger.js

@@ -0,0 +1,4 @@
+export const debug = (...args) => {
+    console.debug('[MessageBridge]', ...args);
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;IACpC,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,CAAA;AAE7C,CAAC,CAAA"}

package/dist/messageTypes.d.ts

@@ -33,6 +33,8 @@ export declare enum MessageType {
     /** Module → Host: Reports an error to the host. */
     ERROR = "error",
     /** Host → Module: Signals the module to exit and clean up. */
-    MODULE_EXIT = "module:exit"
+    MODULE_EXIT = "module:exit",
+    CONTEXT_UPDATE = "context:update",
+    HEARTBEAT = "heartbeat"
 }
 //# sourceMappingURL=messageTypes.d.ts.map

package/dist/messageTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messageTypes.d.ts","sourceRoot":"","sources":["../src/messageTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,WAAW;IACrB,sEAAsE;IACtE,eAAe,oBAAoB;IACnC,wEAAwE;IACxE,YAAY,iBAAiB;IAC7B,qEAAqE;IACrE,SAAS,cAAc;IACvB,kDAAkD;IAClD,YAAY,iBAAiB;IAC7B,iDAAiD;IACjD,aAAa,kBAAkB;IAC/B,mDAAmD;IACnD,KAAK,UAAU;IACf,8DAA8D;IAC9D,WAAW,gBAAgB;CAC5B"}
+{"version":3,"file":"messageTypes.d.ts","sourceRoot":"","sources":["../src/messageTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,WAAW;IACrB,sEAAsE;IACtE,eAAe,oBAAoB;IACnC,wEAAwE;IACxE,YAAY,iBAAiB;IAC7B,qEAAqE;IACrE,SAAS,cAAc;IACvB,kDAAkD;IAClD,YAAY,iBAAiB;IAC7B,iDAAiD;IACjD,aAAa,kBAAkB;IAC/B,mDAAmD;IACnD,KAAK,UAAU;IACf,8DAA8D;IAC9D,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IAEjC,SAAS,cAAc;CAExB"}

package/dist/messageTypes.js

@@ -36,5 +36,8 @@ export var MessageType;
     MessageType["ERROR"] = "error";
     /** Host → Module: Signals the module to exit and clean up. */
     MessageType["MODULE_EXIT"] = "module:exit";
+    MessageType["CONTEXT_UPDATE"] = "context:update";
+    // messageTypes.ts
+    MessageType["HEARTBEAT"] = "heartbeat";
 })(MessageType || (MessageType = {}));
 //# sourceMappingURL=messageTypes.js.map

package/dist/messageTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"messageTypes.js","sourceRoot":"","sources":["../src/messageTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sBAAsB;AAEtB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAN,IAAY,WAeX;AAfD,WAAY,WAAW;IACrB,sEAAsE;IACtE,kDAAmC,CAAA;IACnC,wEAAwE;IACxE,4CAA6B,CAAA;IAC7B,qEAAqE;IACrE,sCAAuB,CAAA;IACvB,kDAAkD;IAClD,4CAA6B,CAAA;IAC7B,iDAAiD;IACjD,8CAA+B,CAAA;IAC/B,mDAAmD;IACnD,8BAAe,CAAA;IACf,8DAA8D;IAC9D,0CAA2B,CAAA;AAC7B,CAAC,EAfW,WAAW,KAAX,WAAW,QAetB"}
+{"version":3,"file":"messageTypes.js","sourceRoot":"","sources":["../src/messageTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sBAAsB;AAEtB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAN,IAAY,WAmBX;AAnBD,WAAY,WAAW;IACrB,sEAAsE;IACtE,kDAAmC,CAAA;IACnC,wEAAwE;IACxE,4CAA6B,CAAA;IAC7B,qEAAqE;IACrE,sCAAuB,CAAA;IACvB,kDAAkD;IAClD,4CAA6B,CAAA;IAC7B,iDAAiD;IACjD,8CAA+B,CAAA;IAC/B,mDAAmD;IACnD,8BAAe,CAAA;IACf,8DAA8D;IAC9D,0CAA2B,CAAA;IAC3B,gDAAiC,CAAA;IACjC,kBAAkB;IAClB,sCAAuB,CAAA;AAEzB,CAAC,EAnBW,WAAW,KAAX,WAAW,QAmBtB"}

package/dist/moduleBridge.d.ts

@@ -1,61 +1,14 @@
-/**
- * @fileoverview Module-side bridge for communication with the host application.
- * @module @schoolpalm/message-bridge/moduleBridge
- */
 import { BridgeBase } from './bridgeBase';
-import { HandshakeReadyPayload, UIUpdatePayload, ErrorPayload } from './payloadSchemas';
-/**
- * Module-side bridge for communication with the host application.
- *
- * This class extends BridgeBase to provide module-specific functionality for
- * communicating with the parent host application. It handles handshake,
- * UI updates, and error reporting from the embedded module.
- *
- * @example
- * ```typescript
- * const moduleBridge = new ModuleBridge('https://host.example.com');
- *
- * // Send handshake when module is ready
- * moduleBridge.sendHandshake({
- *   version: '1.0.0',
- *   timestamp: Date.now()
- * });
- *
- * // Update UI in the host
- * moduleBridge.sendUIUpdate({
- *   title: 'Dashboard',
- *   breadcrumb: ['Home', 'Dashboard'],
- *   theme: 'dark'
- * });
- *
- * // Listen for module start from host
- * moduleBridge.on(MessageType.MODULE_START, (payload) => {
- *   console.log('Module started:', payload.route);
- * });
- * ```
- */
+import { HandshakeReadyPayload, UIUpdatePayload, ErrorPayload, HeartbeatPayload } from './payloadSchemas';
 export declare class ModuleBridge extends BridgeBase {
-    /**
-     * Creates a new ModuleBridge instance.
-     * @param targetOrigin - The origin to restrict messages to (default: '*').
-     */
+    private startedPayload;
     constructor(targetOrigin?: string);
-    /**
-     * Notifies the host application that the module is ready.
-     * This should be called after the module has initialized.
-     * @param payload - The handshake payload containing version and timestamp.
-     */
     sendHandshake(payload: HandshakeReadyPayload): void;
-    /**
-     * Notifies the host application of UI updates.
-     * This includes changes to title, breadcrumb, and theme.
-     * @param payload - The UI update payload.
-     */
+    onModuleStart(callback: (payload: any) => void): void;
+    onHeartbeat(callback?: (payload: HeartbeatPayload) => void): void;
     sendUIUpdate(payload: UIUpdatePayload): void;
-    /**
-     * Notifies the host application of an error.
-     * @param payload - The error payload containing error details.
-     */
     sendError(payload: ErrorPayload): void;
+    requestData<T = any, R = any>(type: string, payload?: T, timeout?: number): Promise<R>;
+    respondData(requestId: string, data: any, status?: 'success' | 'error'): void;
 }
 //# sourceMappingURL=moduleBridge.d.ts.map

package/dist/moduleBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"moduleBridge.d.ts","sourceRoot":"","sources":["../src/moduleBridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C;;;OAGG;gBACS,YAAY,GAAE,MAAY;IAItC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,qBAAqB;IAI5C;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,eAAe;IAIrC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,YAAY;CAGhC"}
+{"version":3,"file":"moduleBridge.d.ts","sourceRoot":"","sources":["../src/moduleBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,YAAY,EAGZ,gBAAgB,EAEjB,MAAM,kBAAkB,CAAA;AAEzB,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAO,CAAC,cAAc,CAAmB;gBAE7B,YAAY,GAAE,MAAY;IAOtC,aAAa,CAAC,OAAO,EAAE,qBAAqB;IAO5C,aAAa,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;IAc9C,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI;IAmB1D,YAAY,CAAC,OAAO,EAAE,eAAe;IAIrC,SAAS,CAAC,OAAO,EAAE,YAAY;IAO3B,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,CAAC,EACX,OAAO,SAAO,GACb,OAAO,CAAC,CAAC,CAAC;IAyBX,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAE,SAAS,GAAG,OAAmB;CAQlF"}

package/dist/moduleBridge.js

@@ -1,70 +1,79 @@
-/**
- * @fileoverview Module-side bridge for communication with the host application.
- * @module @schoolpalm/message-bridge/moduleBridge
- */
-// src/moduleBridge.ts
 import { BridgeBase } from './bridgeBase';
 import { MessageType } from './messageTypes';
-/**
- * Module-side bridge for communication with the host application.
- *
- * This class extends BridgeBase to provide module-specific functionality for
- * communicating with the parent host application. It handles handshake,
- * UI updates, and error reporting from the embedded module.
- *
- * @example
- * ```typescript
- * const moduleBridge = new ModuleBridge('https://host.example.com');
- *
- * // Send handshake when module is ready
- * moduleBridge.sendHandshake({
- *   version: '1.0.0',
- *   timestamp: Date.now()
- * });
- *
- * // Update UI in the host
- * moduleBridge.sendUIUpdate({
- *   title: 'Dashboard',
- *   breadcrumb: ['Home', 'Dashboard'],
- *   theme: 'dark'
- * });
- *
- * // Listen for module start from host
- * moduleBridge.on(MessageType.MODULE_START, (payload) => {
- *   console.log('Module started:', payload.route);
- * });
- * ```
- */
 export class ModuleBridge extends BridgeBase {
-    /**
-     * Creates a new ModuleBridge instance.
-     * @param targetOrigin - The origin to restrict messages to (default: '*').
-     */
     constructor(targetOrigin = '*') {
         super(window.parent, targetOrigin);
+        this.startedPayload = null;
     }
-    /**
-     * Notifies the host application that the module is ready.
-     * This should be called after the module has initialized.
-     * @param payload - The handshake payload containing version and timestamp.
-     */
+    // --------------------
+    // Handshake
+    // --------------------
     sendHandshake(payload) {
         this.send(MessageType.HANDSHAKE_READY, payload);
     }
-    /**
-     * Notifies the host application of UI updates.
-     * This includes changes to title, breadcrumb, and theme.
-     * @param payload - The UI update payload.
-     */
+    // --------------------
+    // Start (sticky)
+    // --------------------
+    onModuleStart(callback) {
+        if (this.startedPayload) {
+            callback(this.startedPayload);
+        }
+        this.on(MessageType.MODULE_START, payload => {
+            this.startedPayload = payload;
+            callback(payload);
+        });
+    }
+    // --------------------
+    // Heartbeat
+    // --------------------
+    onHeartbeat(callback) {
+        this.on(MessageType.HEARTBEAT, (payload) => {
+            const hb = payload;
+            // Ignore ACK-only heartbeats
+            if (hb.ack)
+                return;
+            callback?.(hb);
+            this.send(MessageType.HEARTBEAT, {
+                timestamp: Date.now(),
+                ack: true
+            });
+        });
+    }
+    // --------------------
+    // UI / Errors
+    // --------------------
     sendUIUpdate(payload) {
         this.send(MessageType.UI_UPDATE, payload);
     }
-    /**
-     * Notifies the host application of an error.
-     * @param payload - The error payload containing error details.
-     */
     sendError(payload) {
         this.send(MessageType.ERROR, payload);
     }
+    // --------------------
+    // Requests
+    // --------------------
+    async requestData(type, payload, timeout = 5000) {
+        const request = {
+            requestId: crypto.randomUUID(),
+            type,
+            payload: payload
+        };
+        // Call base request (returns generic MessagePayload)
+        const response = (await this.request(MessageType.DATA_REQUEST, request, timeout)); // Cast safely here
+        if (response.status === 'error') {
+            throw new Error(response.error || 'Unknown error from host');
+        }
+        return response.payload;
+    }
+    // --------------------
+    // Respond to host requests
+    // --------------------
+    respondData(requestId, data, status = 'success') {
+        const response = {
+            requestId,
+            status,
+            payload: data
+        };
+        this.send(MessageType.DATA_RESPONSE, response);
+    }
 }
 //# sourceMappingURL=moduleBridge.js.map

package/dist/moduleBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"moduleBridge.js","sourceRoot":"","sources":["../src/moduleBridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C;;;OAGG;IACH,YAAY,eAAuB,GAAG;QACpC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,OAA8B;QAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,OAAwB;QACnC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,OAAqB;QAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"moduleBridge.js","sourceRoot":"","sources":["../src/moduleBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAW5C,MAAM,OAAO,YAAa,SAAQ,UAAU;IAG1C,YAAY,eAAuB,GAAG;QACpC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QAH5B,mBAAc,GAAe,IAAI,CAAA;IAIzC,CAAC;IAED,uBAAuB;IACvB,YAAY;IACZ,uBAAuB;IACvB,aAAa,CAAC,OAA8B;QAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;IAED,uBAAuB;IACvB,iBAAiB;IACjB,uBAAuB;IACvB,aAAa,CAAC,QAAgC;QAC5C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC/B,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE;YAC1C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAA;YAC7B,QAAQ,CAAC,OAAO,CAAC,CAAA;QACnB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,uBAAuB;IACvB,YAAY;IACZ,uBAAuB;IACvB,WAAW,CAAC,QAA8C;QACxD,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,OAAuB,EAAE,EAAE;YACzD,MAAM,EAAE,GAAG,OAA2B,CAAA;YAEtC,6BAA6B;YAC7B,IAAI,EAAE,CAAC,GAAG;gBAAE,OAAM;YAElB,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAA;YAEd,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE;gBAC/B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,GAAG,EAAE,IAAI;aACU,CAAC,CAAA;QACxB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,uBAAuB;IACvB,cAAc;IACd,uBAAuB;IACvB,YAAY,CAAC,OAAwB;QACnC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,SAAS,CAAC,OAAqB;QAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,uBAAuB;IACvB,WAAW;IACX,uBAAuB;IACzB,KAAK,CAAC,WAAW,CACf,IAAY,EACZ,OAAW,EACX,OAAO,GAAG,IAAI;QAEd,MAAM,OAAO,GAAmB;YAC9B,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE;YAC9B,IAAI;YACJ,OAAO,EAAE,OAAc;SACxB,CAAA;QAED,qDAAqD;QACrD,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAClC,WAAW,CAAC,YAAY,EACxB,OAAO,EACP,OAAO,CACR,CAAoB,CAAA,CAAC,mBAAmB;QAEzC,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAA;QAC9D,CAAC;QAED,OAAO,QAAQ,CAAC,OAAY,CAAA;IAC9B,CAAC;IAGC,uBAAuB;IACvB,2BAA2B;IAC3B,uBAAuB;IACvB,WAAW,CAAC,SAAiB,EAAE,IAAS,EAAE,SAA8B,SAAS;QAC/E,MAAM,QAAQ,GAAoB;YAChC,SAAS;YACT,MAAM;YACN,OAAO,EAAE,IAAI;SACd,CAAA;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;IAChD,CAAC;CACF"}

package/dist/payloadSchemas.d.ts

@@ -1,97 +1,63 @@
-/**
- * @fileoverview Payload schema definitions for message-based communication.
- * @module @schoolpalm/message-bridge/payloadSchemas
- */
-/**
- * Payload interfaces for each message type in the bridge communication protocol.
- *
- * These interfaces define the structure of data exchanged between host applications
- * and embedded modules. Each payload corresponds to a specific message type and
- * contains the necessary information for that communication scenario.
- */
-/**
- * Payload for handshake ready message.
- * Sent by modules to indicate they are ready for communication.
- */
 export interface HandshakeReadyPayload {
-    /** Version of the module or SDK */
     version: string;
-    /** Timestamp when the handshake was initiated */
     timestamp: number;
+    capabilities?: string[];
 }
-/**
- * Payload for module start message.
- * Sent by host to initialize a module with context.
- */
 export interface ModuleStartPayload {
-    /** Route or path to navigate to in the module */
+    moduleId: string;
     route: string;
-    /** Context data passed to the module (user info, permissions, etc.) */
     context: Record<string, any>;
-    /** Timestamp when the module start was requested */
     timestamp: number;
 }
-/**
- * Payload for UI update message.
- * Sent by modules to update the host application's UI.
- */
+export interface ModuleExitPayload {
+    reason?: string;
+}
 export interface UIUpdatePayload {
-    /** Title to display in the host UI */
     title: string;
-    /** Breadcrumb navigation path */
     breadcrumb: string[];
-    /** Optional theme to apply to the host UI */
     theme?: string;
 }
-/**
- * Payload for data request message.
- * Sent by modules to request data from the host.
- */
-export interface DataRequestPayload {
-    /** Unique identifier for tracking the request */
+export interface ErrorPayload {
+    code: string;
+    message: string;
+    details?: any;
+}
+export interface ModuleContextPayload {
+    user?: Record<string, any>;
+    tenant?: Record<string, any>;
+    permissions?: string[];
+    theme?: string;
+}
+export interface RequestPayload {
     requestId: string;
-    /** Action or endpoint to request data from */
-    action: string;
-    /** Optional payload data for the request */
-    payload?: Record<string, any>;
+    type: string;
+    payload?: any;
 }
-/**
- * Payload for data response message.
- * Sent by host in response to data requests.
- */
-export interface DataResponsePayload {
-    /** Unique identifier matching the original request */
+export interface ResponsePayload {
     requestId: string;
-    /** Status of the response */
     status: 'success' | 'error';
-    /** Response data (present on success) */
     payload?: any;
+    error?: string;
 }
 /**
- * Payload for error message.
- * Sent by modules to report errors to the host.
+ * Payload for heartbeat messages.
+ * Host ↔ Module
  */
-export interface ErrorPayload {
-    /** Error code for categorization */
-    code: string;
-    /** Human-readable error message */
-    message: string;
-    /** Optional additional error details */
-    details?: any;
+export interface HeartbeatPayload {
+    timestamp: number;
+    ack?: boolean;
 }
-/**
- * Payload for module exit message.
- * Sent by host to signal module termination.
- */
-export interface ModuleExitPayload {
-    /** Optional reason for the module exit */
-    reason?: string;
+export type MessagePayload = HandshakeReadyPayload | ModuleStartPayload | ModuleExitPayload | UIUpdatePayload | ErrorPayload | ModuleContextPayload | RequestPayload | ResponsePayload | HeartbeatPayload;
+import { MessageType } from './messageTypes';
+export interface MessagePayloadMap {
+    [MessageType.HANDSHAKE_READY]: HandshakeReadyPayload;
+    [MessageType.MODULE_START]: ModuleStartPayload;
+    [MessageType.MODULE_EXIT]: ModuleExitPayload;
+    [MessageType.UI_UPDATE]: UIUpdatePayload;
+    [MessageType.ERROR]: ErrorPayload;
+    [MessageType.CONTEXT_UPDATE]: ModuleContextPayload;
+    [MessageType.DATA_REQUEST]: RequestPayload;
+    [MessageType.DATA_RESPONSE]: ResponsePayload;
+    [MessageType.HEARTBEAT]: HeartbeatPayload;
 }
-/**
- * Union type representing all possible message payloads.
- *
- * This type is used internally for type safety when handling messages
- * of any type in the bridge classes.
- */
-export type MessagePayload = HandshakeReadyPayload | ModuleStartPayload | UIUpdatePayload | DataRequestPayload | DataResponsePayload | ErrorPayload | ModuleExitPayload;
 //# sourceMappingURL=payloadSchemas.d.ts.map

package/dist/payloadSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payloadSchemas.d.ts","sourceRoot":"","sources":["../src/payloadSchemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,yCAAyC;IACzC,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,YAAY,GACZ,iBAAiB,CAAC"}
+{"version":3,"file":"payloadSchemas.d.ts","sourceRoot":"","sources":["../src/payloadSchemas.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,GAAG,CAAA;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,GAAG,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;IAC3B,OAAO,CAAC,EAAE,GAAG,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAGD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,YAAY,GACZ,oBAAoB,GACpB,cAAc,GACd,eAAe,GACf,gBAAgB,CAAA;AAGpB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C,MAAM,WAAW,iBAAiB;IAChC,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE,qBAAqB,CAAA;IACpD,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAA;IAC9C,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC5C,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,eAAe,CAAA;IACxC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,YAAY,CAAA;IACjC,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAA;IAClD,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,cAAc,CAAA;IAC1C,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,eAAe,CAAA;IAC5C,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAC1C"}

package/dist/payloadSchemas.js

@@ -1,6 +1,2 @@
-/**
- * @fileoverview Payload schema definitions for message-based communication.
- * @module @schoolpalm/message-bridge/payloadSchemas
- */
-export {};
+import { MessageType } from './messageTypes';
 //# sourceMappingURL=payloadSchemas.js.map

package/dist/payloadSchemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"payloadSchemas.js","sourceRoot":"","sources":["../src/payloadSchemas.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"payloadSchemas.js","sourceRoot":"","sources":["../src/payloadSchemas.ts"],"names":[],"mappings":"AAuEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/protocol.d.ts

@@ -0,0 +1,8 @@
+export declare enum ProtocolState {
+    INIT = "init",
+    HANDSHAKEN = "handshaken",
+    STARTED = "started",
+    EXITED = "exited"
+}
+export declare const PROTOCOL_VERSION = "1.0.0";
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAEA,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,eAAO,MAAM,gBAAgB,UAAU,CAAA"}

package/dist/protocol.js

@@ -0,0 +1,10 @@
+// src/protocol.ts
+export var ProtocolState;
+(function (ProtocolState) {
+    ProtocolState["INIT"] = "init";
+    ProtocolState["HANDSHAKEN"] = "handshaken";
+    ProtocolState["STARTED"] = "started";
+    ProtocolState["EXITED"] = "exited";
+})(ProtocolState || (ProtocolState = {}));
+export const PROTOCOL_VERSION = '1.0.0';
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,0CAAyB,CAAA;IACzB,oCAAmB,CAAA;IACnB,kCAAiB,CAAA;AACnB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schoolpalm/message-bridge",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "TypeScript SDK for message-based communication between SchoolPalm host and vendor modules.",
   "type": "module",
   "main": "dist/index.js",