@schoolpalm/message-bridge 1.2.0 → 1.4.0

package/dist/bridgeBase.d.ts

@@ -1,23 +1,18 @@
 import { MessageType } from './messageTypes';
-import { MessagePayload } from './payloadSchemas';
-/** Type definition for message handler functions */
-type MessageHandler<T extends MessagePayload> = (payload: T) => void;
-/**
- * Base class for Host and Module bridges.
- *
- * Handles sending, receiving, and dispatching messages via postMessage,
- * with type-safe payloads, origin validation, and optional request/response support.
- */
+import { MessagePayloadMap } from './payloadSchemas';
+import { RequestPayload } from './payloadSchemas';
+type MessageHandler<T = any> = (payload: T) => void;
 export declare class BridgeBase {
     protected targetWindow: Window;
     protected targetOrigin: string;
     private listeners;
     private pendingRequests;
+    private boundHandler;
     constructor(targetWindow: Window, targetOrigin?: string);
-    send<T extends MessagePayload>(type: MessageType, payload: T): void;
-    request<T = any, R = any>(type: MessageType, payload?: T, timeout?: number): Promise<R>;
-    on<T extends MessagePayload>(type: MessageType, callback: MessageHandler<T>): void;
-    protected _handleMessage(event: MessageEvent): void;
+    send<T extends keyof MessagePayloadMap | string>(type: T, payload?: T extends keyof MessagePayloadMap ? MessagePayloadMap[T] : any): void;
+    request<R = any>(type: MessageType, payload: RequestPayload, timeout?: number): Promise<R>;
+    on<T extends keyof MessagePayloadMap | string>(type: T, callback: MessageHandler<T extends keyof MessagePayloadMap ? MessagePayloadMap[T] : any>): 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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAmC,MAAM,kBAAkB,CAAA;AAElF,oDAAoD;AACpD,KAAK,cAAc,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AAEpE;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,SAAS,CAAC,YAAY,EAAE,MAAM,CAAA;IAC9B,SAAS,CAAC,YAAY,EAAE,MAAM,CAAA;IAC9B,OAAO,CAAC,SAAS,CAAqD;IACtE,OAAO,CAAC,eAAe,CAAiD;gBAE5D,YAAY,EAAE,MAAM,EAAE,YAAY,GAAE,MAAY;IAO5D,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAK5D,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBrF,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;IAK3E,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY;IAwB5C,OAAO;CAKR"}
+{"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,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AAEnD,qBAAa,UAAU;IACrB,SAAS,CAAC,YAAY,EAAE,MAAM,CAAA;IAC9B,SAAS,CAAC,YAAY,EAAE,MAAM,CAAA;IAE9B,OAAO,CAAC,SAAS,CAAqE;IACtF,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,YAAY,CAA+B;gBAEvC,YAAY,EAAE,MAAM,EAAE,YAAY,GAAE,MAAY;IAW5D,IAAI,CAAC,CAAC,SAAS,MAAM,iBAAiB,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,GAAG;IAOlI,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBxF,EAAE,CAAC,CAAC,SAAS,MAAM,iBAAiB,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,SAAS,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAQhJ,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY;IA+B3C,OAAO;CAKR"}

package/dist/bridgeBase.js

@@ -1,67 +1,81 @@
-// src/bridgeBase.ts
 import { MessageType } from './messageTypes';
-/**
- * Base class for Host and Module bridges.
- *
- * Handles sending, receiving, and dispatching messages via postMessage,
- * with type-safe payloads, origin validation, and optional request/response support.
- */
 export class BridgeBase {
     constructor(targetWindow, targetOrigin = '*') {
         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);
     }
-    // ---------- Send messages ----------
+    // --------------------
+    // Send message (typed)
+    // --------------------
     send(type, payload) {
         this.targetWindow.postMessage({ type, payload }, this.targetOrigin);
     }
-    // ---------- Request/Response ----------
+    // --------------------
+    // Request / Response (async)
+    // --------------------
     request(type, payload, timeout = 5000) {
         return new Promise((resolve, reject) => {
-            const requestId = crypto.randomUUID();
-            this.pendingRequests.set(requestId, resolve);
-            this.send(MessageType.DATA_REQUEST, { requestId, type, payload });
+            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 ${type} timed out`));
+                    reject(new Error(`Request ${payload.type} timed out`));
                 }
             }, timeout);
         });
     }
-    // ---------- Event handling ----------
+    // --------------------
+    // Listen to message
+    // --------------------
     on(type, callback) {
         if (!this.listeners.has(type))
             this.listeners.set(type, []);
-        this.listeners.get(type)?.push(callback);
+        this.listeners.get(type).push(callback);
     }
-    _handleMessage(event) {
-        // Strict origin check
+    // --------------------
+    // Dispatcher
+    // --------------------
+    handleMessage(event) {
         if (this.targetOrigin !== '*' && event.origin !== this.targetOrigin)
             return;
         const { type, payload } = event.data || {};
         if (!type)
             return;
         // Handle DATA_RESPONSE automatically
-        if (type === MessageType.DATA_RESPONSE && payload?.requestId) {
-            const resolver = this.pendingRequests.get(payload.requestId);
+        if (type === MessageType.DATA_RESPONSE) {
+            const response = payload;
+            const resolver = this.pendingRequests.get(response.requestId);
             if (resolver) {
-                resolver(payload);
-                this.pendingRequests.delete(payload.requestId);
+                resolver(response);
+                this.pendingRequests.delete(response.requestId);
                 return;
             }
         }
-        // Dispatch to listeners
-        if (this.listeners.has(type)) {
-            this.listeners.get(type)?.forEach(cb => cb(payload));
+        // Call all registered listeners
+        const handlers = this.listeners.get(type);
+        handlers?.forEach(cb => cb(payload));
+        // Optional: handle CUSTOM messages
+        if (type.startsWith(MessageType.CUSTOM_PREFIX)) {
+            const customHandlers = this.listeners.get(type);
+            customHandlers?.forEach(cb => cb(payload));
         }
     }
-    // ---------- Cleanup ----------
+    // --------------------
+    // Cleanup
+    // --------------------
     destroy() {
-        window.removeEventListener('message', this._handleMessage.bind(this));
+        window.removeEventListener('message', this.boundHandler);
         this.listeners.clear();
         this.pendingRequests.clear();
     }

package/dist/bridgeBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridgeBase.js","sourceRoot":"","sources":["../src/bridgeBase.ts"],"names":[],"mappings":"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"}
+{"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,14 +1,16 @@
 import { BridgeBase } from './bridgeBase';
 import { ModuleStartPayload, UIUpdatePayload, ErrorPayload, ModuleContextPayload, HandshakeReadyPayload } from './payloadSchemas';
-/**
- * HostBridge: communication from Host → Module iframe
- */
 export declare class HostBridge extends BridgeBase {
+    private handshakeCompleted;
+    private handshakePayload;
+    private pendingStartPayload;
+    private heartbeatTimer?;
+    private lastHeartbeat;
     constructor(iframe: HTMLIFrameElement, targetOrigin?: string);
     onHandshakeReady(callback: (payload: HandshakeReadyPayload) => void): void;
-    /**
-     * Start module safely after handshake
-     */
+    startHeartbeat(interval?: number): void;
+    stopHeartbeat(): void;
+    listenHeartbeat(timeout?: number): void;
     startModule(payload: ModuleStartPayload, timeout?: number): void;
     sendModuleStart(payload: ModuleStartPayload): void;
     sendModuleExit(reason?: string): void;
@@ -16,5 +18,21 @@ export declare class HostBridge extends BridgeBase {
     onError(callback: (payload: ErrorPayload) => void): void;
     sendContextUpdate(payload: ModuleContextPayload): void;
     requestData<T = any, R = any>(type: string, payload?: T, timeout?: number): Promise<R>;
+    loadPage(component: string, params?: Record<string, any>): void;
+    navigateBack(): void;
+    navigateForward(): void;
+    setBreadcrumb(breadcrumb: string[]): void;
+    showLoader(): void;
+    hideLoader(): void;
+    notify(message: string, type?: 'info' | 'success' | 'warning' | 'error'): void;
+    dialog(title: string, message: string): void;
+    confirm(title: string, message: string): void;
+    pauseModule(): void;
+    resumeModule(): void;
+    updatePermissions(permissions: string[]): void;
+    toggleFeatures(features: Record<string, boolean>): void;
+    preloadResources(resources: string[]): void;
+    notifyResourceLoaded(resource: string): void;
+    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":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EACL,kBAAkB,EAElB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,kBAAkB,CAAA;AAEzB;;GAEG;AACH,qBAAa,UAAW,SAAQ,UAAU;gBAC5B,MAAM,EAAE,iBAAiB,EAAE,YAAY,GAAE,MAAY;IAQjE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI;IAInE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,MAAa;IAY/D,eAAe,CAAC,OAAO,EAAE,kBAAkB;IAI3C,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM;IAK9B,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI;IAIvD,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI;IAKjD,iBAAiB,CAAC,OAAO,EAAE,oBAAoB;IAKhD,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CASpF"}
+{"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,EAWtB,MAAM,kBAAkB,CAAA;AAGzB,qBAAa,UAAW,SAAQ,UAAU;IACxC,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,mBAAmB,CAAkC;IAE7D,OAAO,CAAC,cAAc,CAAC,CAAQ;IAC/B,OAAO,CAAC,aAAa,CAAa;gBAEtB,MAAM,EAAE,iBAAiB,EAAE,YAAY,GAAE,MAAY;IAQjE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI;IA0BnE,cAAc,CAAC,QAAQ,SAAO;IAO9B,aAAa;IAOb,eAAe,CAAC,OAAO,SAAQ;IAgB/B,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,SAAO;IAYvD,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;IAIjD,iBAAiB,CAAC,OAAO,EAAE,oBAAoB;IAO/C,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAYpF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAKxD,YAAY;IAIZ,eAAe;IAIf,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE;IAKlC,UAAU;IAIV,UAAU;IAIV,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAgB;IAK/E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAKrC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAKtC,WAAW;IAIX,YAAY;IAIZ,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE;IAKvC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKhD,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE;IAKpC,oBAAoB,CAAC,QAAQ,EAAE,MAAM;IAQrC,KAAK;CAKN"}

package/dist/hostBridge.js

@@ -1,58 +1,168 @@
-// src/hostBridge.ts
 import { BridgeBase } from './bridgeBase';
 import { MessageType } from './messageTypes';
-/**
- * HostBridge: communication from Host → Module iframe
- */
+import { PROTOCOL_VERSION } from './protocol';
 export class HostBridge extends BridgeBase {
     constructor(iframe, targetOrigin = '*') {
-        if (!iframe.contentWindow) {
+        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();
     }
-    // ---------- Lifecycle / handshake ----------
+    // --------------------
+    // Handshake
+    // --------------------
     onHandshakeReady(callback) {
-        this.on(MessageType.HANDSHAKE_READY, callback);
+        if (this.handshakeCompleted && this.handshakePayload) {
+            callback(this.handshakePayload);
+            return;
+        }
+        this.on(MessageType.HANDSHAKE_READY, payload => {
+            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;
+            }
+        });
     }
-    /**
-     * Start module safely after handshake
-     */
-    startModule(payload, timeout = 5000) {
-        const timer = setTimeout(() => {
-            console.error('Module handshake timeout');
+    // --------------------
+    // Heartbeat
+    // --------------------
+    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);
-        this.onHandshakeReady(() => {
-            clearTimeout(timer);
+    }
+    // --------------------
+    // Module Start / Exit
+    // --------------------
+    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));
     }
-    // ---------- Module control ----------
     sendModuleStart(payload) {
         this.send(MessageType.MODULE_START, payload);
     }
     sendModuleExit(reason) {
         this.send(MessageType.MODULE_EXIT, { reason });
     }
-    // ---------- UI events ----------
+    // --------------------
+    // UI / Errors
+    // --------------------
     onUIUpdate(callback) {
         this.on(MessageType.UI_UPDATE, callback);
     }
     onError(callback) {
         this.on(MessageType.ERROR, callback);
     }
-    // ---------- Context / theme sync ----------
     sendContextUpdate(payload) {
         this.send(MessageType.CONTEXT_UPDATE, payload);
     }
-    // ---------- Request / response ----------
+    // --------------------
+    // Requests
+    // --------------------
     requestData(type, payload, timeout = 5000) {
-        const requestPayload = {
+        const request = {
             requestId: crypto.randomUUID(),
             type,
-            payload: payload
+            payload: payload,
         };
-        return this.request(MessageType.DATA_REQUEST, requestPayload, timeout);
+        return this.request(MessageType.DATA_REQUEST, request, timeout);
+    }
+    // --------------------
+    // Convenience methods for new features
+    // --------------------
+    loadPage(component, params) {
+        const payload = { component, params };
+        this.send(MessageType.LOAD_PAGE, payload);
+    }
+    navigateBack() {
+        this.send(MessageType.NAVIGATE_BACK);
+    }
+    navigateForward() {
+        this.send(MessageType.NAVIGATE_FORWARD);
+    }
+    setBreadcrumb(breadcrumb) {
+        const payload = { breadcrumb };
+        this.send(MessageType.SET_BREADCRUMB, payload);
+    }
+    showLoader() {
+        this.send(MessageType.SHOW_LOADER);
+    }
+    hideLoader() {
+        this.send(MessageType.HIDE_LOADER);
+    }
+    notify(message, type = 'info') {
+        const payload = { message, type };
+        this.send(MessageType.NOTIFICATION, payload);
+    }
+    dialog(title, message) {
+        const payload = { title, message };
+        this.send(MessageType.DIALOG, payload);
+    }
+    confirm(title, message) {
+        const payload = { title, message };
+        this.send(MessageType.CONFIRM, payload);
+    }
+    pauseModule() {
+        this.send(MessageType.MODULE_PAUSE);
+    }
+    resumeModule() {
+        this.send(MessageType.MODULE_RESUME);
+    }
+    updatePermissions(permissions) {
+        const payload = { permissions };
+        this.send(MessageType.PERMISSION_UPDATE, payload);
+    }
+    toggleFeatures(features) {
+        const payload = { features };
+        this.send(MessageType.FEATURE_TOGGLE, payload);
+    }
+    preloadResources(resources) {
+        const payload = { resources };
+        this.send(MessageType.PRELOAD_RESOURCE, payload);
+    }
+    notifyResourceLoaded(resource) {
+        const payload = { resource };
+        this.send(MessageType.RESOURCE_LOADED, payload);
+    }
+    // --------------------
+    // Reset
+    // --------------------
+    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,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAW5C;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IACxC,YAAY,MAAyB,EAAE,eAAuB,GAAG;QAC/D,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAChD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;IAC3C,CAAC;IAED,8CAA8C;IAC9C,gBAAgB,CAAC,QAAkD;QACjE,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;IAChD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAA2B,EAAE,UAAkB,IAAI;QAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAC3C,CAAC,EAAE,OAAO,CAAC,CAAA;QAEX,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,uCAAuC;IACvC,eAAe,CAAC,OAA2B;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,cAAc,CAAC,MAAe;QAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,MAAM,EAAuB,CAAC,CAAA;IACrE,CAAC;IAED,kCAAkC;IAClC,UAAU,CAAC,QAA4C;QACrD,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAC1C,CAAC;IAED,OAAO,CAAC,QAAyC;QAC/C,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACtC,CAAC;IAED,6CAA6C;IAC7C,iBAAiB,CAAC,OAA6B;QAC7C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAChD,CAAC;IAED,2CAA2C;IAC5C,WAAW,CAAmB,IAAY,EAAE,OAAW,EAAE,OAAO,GAAG,IAAI;QACtE,MAAM,cAAc,GAAmB;YACrC,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE;YAC9B,IAAI;YACJ,OAAO,EAAE,OAAc;SACxB,CAAA;QACD,OAAO,IAAI,CAAC,OAAO,CAAoB,WAAW,CAAC,YAAY,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;IAC3F,CAAC;CAEA"}
+{"version":3,"file":"hostBridge.js","sourceRoot":"","sources":["../src/hostBridge.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -9,12 +9,13 @@
  *
  * @example
  * ```typescript
- * import { HostBridge, ModuleBridge, MessageType } from '@schoolpalm/message-bridge';
+ * import { HostBridge, ModuleBridge, MessageType, ProtocolState, PROTOCOL_VERSION } from '@schoolpalm/message-bridge';
  * ```
  */
 export { BridgeBase } from './bridgeBase';
 export { HostBridge } from './hostBridge';
 export { ModuleBridge } from './moduleBridge';
 export { MessageType } from './messageTypes';
+export { ProtocolState, PROTOCOL_VERSION } from './protocol';
 export * from './payloadSchemas';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7D,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -9,12 +9,13 @@
  *
  * @example
  * ```typescript
- * import { HostBridge, ModuleBridge, MessageType } from '@schoolpalm/message-bridge';
+ * import { HostBridge, ModuleBridge, MessageType, ProtocolState, PROTOCOL_VERSION } from '@schoolpalm/message-bridge';
  * ```
  */
 export { BridgeBase } from './bridgeBase';
 export { HostBridge } from './hostBridge';
 export { ModuleBridge } from './moduleBridge';
 export { MessageType } from './messageTypes';
+export { ProtocolState, PROTOCOL_VERSION } from './protocol'; // ✅ new export
 export * from './payloadSchemas';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC,CAAC,eAAe;AAC7E,cAAc,kBAAkB,CAAC"}

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

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Message type definitions for bridge communication.
+ * @fileoverview Message type definitions for Host ↔ Module communication.
  * @module @schoolpalm/message-bridge/messageTypes
  */
 /**
@@ -9,31 +9,70 @@
  * application and embedded modules. Each type indicates the direction and
  * purpose of the message.
  *
- * @example
- * ```typescript
- * import { MessageType } from '@schoolpalm/message-bridge';
- *
- * // Listen for UI updates from modules
- * bridge.on(MessageType.UI_UPDATE, (payload) => {
- *   console.log('UI updated:', payload);
- * });
- * ```
+ * ⚡ Future-proof: additional custom messages can be sent via
+ * `CUSTOM:<name>` without editing this enum.
  */
 export declare enum MessageType {
     /** Module → Host: Indicates the module is ready for communication. */
     HANDSHAKE_READY = "handshake:ready",
+    /** Module → Host: Indicates the module is ready for communication. */
+    MODULE_READY = "module:ready",
+    /** Module → Host: Signals the module is unready/destroyed. */
+    MODULE_UNREADY = "module:unready",
+    /** Host → Module: Signals the module to pause processing. */
+    MODULE_PAUSE = "module:pause",
+    /** Host → Module: Signals the module to resume processing. */
+    MODULE_RESUME = "module:resume",
     /** Host → Module: Signals the module to start with provided context. */
     MODULE_START = "module:start",
-    /** Module → Host: Updates the host UI (title, breadcrumb, theme). */
-    UI_UPDATE = "ui:update",
+    /** Host → Module: Signals the module to exit and clean up. */
+    MODULE_EXIT = "module:exit",
     /** Module → Host: Requests data from the host. */
     DATA_REQUEST = "data:request",
     /** Host → Module: Responds to a data request. */
     DATA_RESPONSE = "data:response",
+    /** Host → Module: Updates module context dynamically. */
+    CONTEXT_UPDATE = "context:update",
+    /** Module → Host: Requests full host context. */
+    CONTEXT_REQUEST = "context:request",
+    /** Module → Host: Subscribe to host data changes. */
+    DATA_SUBSCRIBE = "data:subscribe",
+    /** Module → Host: Unsubscribe from host data changes. */
+    DATA_UNSUBSCRIBE = "data:unsubscribe",
+    /** Module → Host: Updates the host UI (title, breadcrumb, theme). */
+    UI_UPDATE = "ui:update",
+    /** Host → Module: Show loader overlay or spinner. */
+    SHOW_LOADER = "show:loader",
+    /** Host → Module: Hide loader overlay or spinner. */
+    HIDE_LOADER = "hide:loader",
+    /** Module → Host: Request a toast/notification. */
+    NOTIFICATION = "notification",
+    /** Module → Host: Request a modal/dialog confirmation. */
+    DIALOG = "dialog",
+    CONFIRM = "dialog",
+    /** Module → Host: Logs messages/warnings for centralized logging. */
+    LOG = "log",
     /** Module → Host: Reports an error to the host. */
     ERROR = "error",
-    /** Host → Module: Signals the module to exit and clean up. */
-    MODULE_EXIT = "module:exit",
-    CONTEXT_UPDATE = "context:update"
+    /** Host → Module: Load a specific page/component. */
+    LOAD_PAGE = "load:page",
+    /** Host → Module: Navigate module back in internal history. */
+    NAVIGATE_BACK = "navigate:back",
+    /** Host → Module: Navigate module forward in internal history. */
+    NAVIGATE_FORWARD = "navigate:forward",
+    /** Module → Host: Update breadcrumbs in host UI. */
+    SET_BREADCRUMB = "set:breadcrumb",
+    /** Host → Module: Update allowed actions for module. */
+    PERMISSION_UPDATE = "permission:update",
+    /** Host → Module: Enable/disable optional features. */
+    FEATURE_TOGGLE = "feature:toggle",
+    /** Host → Module: Preload additional JS/CSS/images. */
+    PRELOAD_RESOURCE = "preload:resource",
+    /** Module → Host: Notify that a lazy resource is loaded. */
+    RESOURCE_LOADED = "resource:loaded",
+    /** Heartbeat for liveliness checks. Can be Module → Host or Host → Module. */
+    HEARTBEAT = "heartbeat",
+    /** Use this prefix to send custom messages without modifying the core library. */
+    CUSTOM_PREFIX = "CUSTOM:"
 }
 //# 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;IAC3B,cAAc,mBAAmB;CAClC"}
+{"version":3,"file":"messageTypes.d.ts","sourceRoot":"","sources":["../src/messageTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,oBAAY,WAAW;IAKrB,sEAAsE;IACtE,eAAe,oBAAoB;IAMnC,sEAAsE;IACtE,YAAY,iBAAiB;IAC7B,8DAA8D;IAC9D,cAAc,mBAAmB;IACjC,6DAA6D;IAC7D,YAAY,iBAAiB;IAC7B,8DAA8D;IAC9D,aAAa,kBAAkB;IAC/B,wEAAwE;IACxE,YAAY,iBAAiB;IAC7B,8DAA8D;IAC9D,WAAW,gBAAgB;IAK3B,kDAAkD;IAClD,YAAY,iBAAiB;IAC7B,iDAAiD;IACjD,aAAa,kBAAkB;IAC/B,yDAAyD;IACzD,cAAc,mBAAmB;IACjC,iDAAiD;IACjD,eAAe,oBAAoB;IACnC,qDAAqD;IACrD,cAAc,mBAAmB;IACjC,yDAAyD;IACzD,gBAAgB,qBAAqB;IAKrC,qEAAqE;IACrE,SAAS,cAAc;IACvB,qDAAqD;IACrD,WAAW,gBAAgB;IAC3B,qDAAqD;IACrD,WAAW,gBAAgB;IAC3B,mDAAmD;IACnD,YAAY,iBAAiB;IAC7B,0DAA0D;IAC1D,MAAM,WAAW;IACjB,OAAO,WAAW;IAClB,qEAAqE;IACrE,GAAG,QAAQ;IACX,mDAAmD;IACnD,KAAK,UAAU;IAKf,qDAAqD;IACrD,SAAS,cAAc;IACvB,+DAA+D;IAC/D,aAAa,kBAAkB;IAC/B,kEAAkE;IAClE,gBAAgB,qBAAqB;IACrC,oDAAoD;IACpD,cAAc,mBAAmB;IAKjC,wDAAwD;IACxD,iBAAiB,sBAAsB;IACvC,uDAAuD;IACvD,cAAc,mBAAmB;IAKjC,uDAAuD;IACvD,gBAAgB,qBAAqB;IACrC,4DAA4D;IAC5D,eAAe,oBAAoB;IAKnC,8EAA8E;IAC9E,SAAS,cAAc;IAKvB,kFAAkF;IAClF,aAAa,YAAY;CAC1B"}

package/dist/messageTypes.js

@@ -1,8 +1,7 @@
 /**
- * @fileoverview Message type definitions for bridge communication.
+ * @fileoverview Message type definitions for Host ↔ Module communication.
  * @module @schoolpalm/message-bridge/messageTypes
  */
-// src/messageTypes.ts
 /**
  * Enumeration of all allowed message types for Host ↔ Module communication.
  *
@@ -10,32 +9,98 @@
  * application and embedded modules. Each type indicates the direction and
  * purpose of the message.
  *
- * @example
- * ```typescript
- * import { MessageType } from '@schoolpalm/message-bridge';
- *
- * // Listen for UI updates from modules
- * bridge.on(MessageType.UI_UPDATE, (payload) => {
- *   console.log('UI updated:', payload);
- * });
- * ```
+ * ⚡ Future-proof: additional custom messages can be sent via
+ * `CUSTOM:<name>` without editing this enum.
  */
 export var MessageType;
 (function (MessageType) {
+    // -----------------------
+    // Lifecycle
+    // -----------------------
     /** Module → Host: Indicates the module is ready for communication. */
     MessageType["HANDSHAKE_READY"] = "handshake:ready";
+    // -----------------------
+    // UI & UX
+    // -----------------------
+    /** Module → Host: Indicates the module is ready for communication. */
+    MessageType["MODULE_READY"] = "module:ready";
+    /** Module → Host: Signals the module is unready/destroyed. */
+    MessageType["MODULE_UNREADY"] = "module:unready";
+    /** Host → Module: Signals the module to pause processing. */
+    MessageType["MODULE_PAUSE"] = "module:pause";
+    /** Host → Module: Signals the module to resume processing. */
+    MessageType["MODULE_RESUME"] = "module:resume";
     /** Host → Module: Signals the module to start with provided context. */
     MessageType["MODULE_START"] = "module:start";
-    /** Module → Host: Updates the host UI (title, breadcrumb, theme). */
-    MessageType["UI_UPDATE"] = "ui:update";
+    /** Host → Module: Signals the module to exit and clean up. */
+    MessageType["MODULE_EXIT"] = "module:exit";
+    // -----------------------
+    // Data & Context
+    // -----------------------
     /** Module → Host: Requests data from the host. */
     MessageType["DATA_REQUEST"] = "data:request";
     /** Host → Module: Responds to a data request. */
     MessageType["DATA_RESPONSE"] = "data:response";
+    /** Host → Module: Updates module context dynamically. */
+    MessageType["CONTEXT_UPDATE"] = "context:update";
+    /** Module → Host: Requests full host context. */
+    MessageType["CONTEXT_REQUEST"] = "context:request";
+    /** Module → Host: Subscribe to host data changes. */
+    MessageType["DATA_SUBSCRIBE"] = "data:subscribe";
+    /** Module → Host: Unsubscribe from host data changes. */
+    MessageType["DATA_UNSUBSCRIBE"] = "data:unsubscribe";
+    // -----------------------
+    // UI / UX
+    // -----------------------
+    /** Module → Host: Updates the host UI (title, breadcrumb, theme). */
+    MessageType["UI_UPDATE"] = "ui:update";
+    /** Host → Module: Show loader overlay or spinner. */
+    MessageType["SHOW_LOADER"] = "show:loader";
+    /** Host → Module: Hide loader overlay or spinner. */
+    MessageType["HIDE_LOADER"] = "hide:loader";
+    /** Module → Host: Request a toast/notification. */
+    MessageType["NOTIFICATION"] = "notification";
+    /** Module → Host: Request a modal/dialog confirmation. */
+    MessageType["DIALOG"] = "dialog";
+    MessageType["CONFIRM"] = "dialog";
+    /** Module → Host: Logs messages/warnings for centralized logging. */
+    MessageType["LOG"] = "log";
     /** Module → Host: Reports an error to the host. */
     MessageType["ERROR"] = "error";
-    /** Host → Module: Signals the module to exit and clean up. */
-    MessageType["MODULE_EXIT"] = "module:exit";
-    MessageType["CONTEXT_UPDATE"] = "context:update";
+    // -----------------------
+    // Navigation / Page Control
+    // -----------------------
+    /** Host → Module: Load a specific page/component. */
+    MessageType["LOAD_PAGE"] = "load:page";
+    /** Host → Module: Navigate module back in internal history. */
+    MessageType["NAVIGATE_BACK"] = "navigate:back";
+    /** Host → Module: Navigate module forward in internal history. */
+    MessageType["NAVIGATE_FORWARD"] = "navigate:forward";
+    /** Module → Host: Update breadcrumbs in host UI. */
+    MessageType["SET_BREADCRUMB"] = "set:breadcrumb";
+    // -----------------------
+    // Permissions & Feature Flags
+    // -----------------------
+    /** Host → Module: Update allowed actions for module. */
+    MessageType["PERMISSION_UPDATE"] = "permission:update";
+    /** Host → Module: Enable/disable optional features. */
+    MessageType["FEATURE_TOGGLE"] = "feature:toggle";
+    // -----------------------
+    // Assets / Resources
+    // -----------------------
+    /** Host → Module: Preload additional JS/CSS/images. */
+    MessageType["PRELOAD_RESOURCE"] = "preload:resource";
+    /** Module → Host: Notify that a lazy resource is loaded. */
+    MessageType["RESOURCE_LOADED"] = "resource:loaded";
+    // -----------------------
+    // Lifecycle / Health
+    // -----------------------
+    /** Heartbeat for liveliness checks. Can be Module → Host or Host → Module. */
+    MessageType["HEARTBEAT"] = "heartbeat";
+    // -----------------------
+    // Future-proof / Custom
+    // -----------------------
+    /** Use this prefix to send custom messages without modifying the core library. */
+    MessageType["CUSTOM_PREFIX"] = "CUSTOM:";
 })(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,WAgBX;AAhBD,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;AACnC,CAAC,EAhBW,WAAW,KAAX,WAAW,QAgBtB"}
+{"version":3,"file":"messageTypes.js","sourceRoot":"","sources":["../src/messageTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,WAmGX;AAnGD,WAAY,WAAW;IAEpB,0BAA0B;IAC3B,YAAY;IACZ,0BAA0B;IAC1B,sEAAsE;IACtE,kDAAmC,CAAA;IAEnC,0BAA0B;IAC1B,UAAU;IACV,0BAA0B;IAE1B,sEAAsE;IACtE,4CAA6B,CAAA;IAC7B,8DAA8D;IAC9D,gDAAiC,CAAA;IACjC,6DAA6D;IAC7D,4CAA6B,CAAA;IAC7B,8DAA8D;IAC9D,8CAA+B,CAAA;IAC/B,wEAAwE;IACxE,4CAA6B,CAAA;IAC7B,8DAA8D;IAC9D,0CAA2B,CAAA;IAE3B,0BAA0B;IAC1B,iBAAiB;IACjB,0BAA0B;IAC1B,kDAAkD;IAClD,4CAA6B,CAAA;IAC7B,iDAAiD;IACjD,8CAA+B,CAAA;IAC/B,yDAAyD;IACzD,gDAAiC,CAAA;IACjC,iDAAiD;IACjD,kDAAmC,CAAA;IACnC,qDAAqD;IACrD,gDAAiC,CAAA;IACjC,yDAAyD;IACzD,oDAAqC,CAAA;IAErC,0BAA0B;IAC1B,UAAU;IACV,0BAA0B;IAC1B,qEAAqE;IACrE,sCAAuB,CAAA;IACvB,qDAAqD;IACrD,0CAA2B,CAAA;IAC3B,qDAAqD;IACrD,0CAA2B,CAAA;IAC3B,mDAAmD;IACnD,4CAA6B,CAAA;IAC7B,0DAA0D;IAC1D,gCAAiB,CAAA;IACjB,iCAAkB,CAAA;IAClB,qEAAqE;IACrE,0BAAW,CAAA;IACX,mDAAmD;IACnD,8BAAe,CAAA;IAEf,0BAA0B;IAC1B,4BAA4B;IAC5B,0BAA0B;IAC1B,qDAAqD;IACrD,sCAAuB,CAAA;IACvB,+DAA+D;IAC/D,8CAA+B,CAAA;IAC/B,kEAAkE;IAClE,oDAAqC,CAAA;IACrC,oDAAoD;IACpD,gDAAiC,CAAA;IAEjC,0BAA0B;IAC1B,8BAA8B;IAC9B,0BAA0B;IAC1B,wDAAwD;IACxD,sDAAuC,CAAA;IACvC,uDAAuD;IACvD,gDAAiC,CAAA;IAEjC,0BAA0B;IAC1B,qBAAqB;IACrB,0BAA0B;IAC1B,uDAAuD;IACvD,oDAAqC,CAAA;IACrC,4DAA4D;IAC5D,kDAAmC,CAAA;IAEnC,0BAA0B;IAC1B,qBAAqB;IACrB,0BAA0B;IAC1B,8EAA8E;IAC9E,sCAAuB,CAAA;IAEvB,0BAA0B;IAC1B,wBAAwB;IACxB,0BAA0B;IAC1B,kFAAkF;IAClF,wCAAyB,CAAA;AAC3B,CAAC,EAnGW,WAAW,KAAX,WAAW,QAmGtB"}

package/dist/moduleBridge.d.ts

@@ -1,21 +1,30 @@
 import { BridgeBase } from './bridgeBase';
-import { HandshakeReadyPayload, UIUpdatePayload, ErrorPayload } from './payloadSchemas';
-/**
- * Module-side bridge for communication with the host application.
- */
+import { HandshakeReadyPayload, UIUpdatePayload, ErrorPayload, HeartbeatPayload, LoadPagePayload, BreadcrumbPayload, NotificationPayload, DialogPayload, PermissionPayload, FeatureTogglePayload, PreloadResourcePayload, ResourceLoadedPayload } from './payloadSchemas';
 export declare class ModuleBridge extends BridgeBase {
+    private startedPayload;
     constructor(targetOrigin?: string);
     sendHandshake(payload: HandshakeReadyPayload): void;
     onModuleStart(callback: (payload: any) => void): void;
+    onHeartbeat(callback?: (payload: HeartbeatPayload) => void): void;
     sendUIUpdate(payload: UIUpdatePayload): void;
     sendError(payload: ErrorPayload): void;
-    /**
-     * Module requests data from host
-     */
     requestData<T = any, R = any>(type: string, payload?: T, timeout?: number): Promise<R>;
-    /**
-     * Respond to a host request
-     */
     respondData(requestId: string, data: any, status?: 'success' | 'error'): void;
+    onLoadPage(callback: (payload: LoadPagePayload) => void): void;
+    onNavigateBack(callback: () => void): void;
+    onNavigateForward(callback: () => void): void;
+    onSetBreadcrumb(callback: (payload: BreadcrumbPayload) => void): void;
+    onShowLoader(callback: () => void): void;
+    onHideLoader(callback: () => void): void;
+    onNotification(callback: (payload: NotificationPayload) => void): void;
+    onDialog(callback: (payload: DialogPayload) => void): void;
+    onConfirm(callback: (payload: DialogPayload) => void): void;
+    onPause(callback: () => void): void;
+    onResume(callback: () => void): void;
+    onPermissionUpdate(callback: (payload: PermissionPayload) => void): void;
+    onFeatureToggle(callback: (payload: FeatureTogglePayload) => void): void;
+    onPreloadResources(callback: (payload: PreloadResourcePayload) => void): void;
+    onResourceLoaded(callback: (payload: ResourceLoadedPayload) => void): void;
+    notifyResourceLoaded(resource: string): 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":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,YAAY,EAGb,MAAM,kBAAkB,CAAA;AAEzB;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,YAAY,GAAE,MAAY;IAKtC,aAAa,CAAC,OAAO,EAAE,qBAAqB;IAI5C,aAAa,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;IAI9C,YAAY,CAAC,OAAO,EAAE,eAAe;IAIrC,SAAS,CAAC,OAAO,EAAE,YAAY;IAK/B;;OAEG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IASpF;;OAEG;IACJ,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAE,SAAS,GAAG,OAAmB;CASjF"}
+{"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,EAChB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EAEtB,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;IAY9C,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI;IAY1D,YAAY,CAAC,OAAO,EAAE,eAAe;IAIrC,SAAS,CAAC,OAAO,EAAE,YAAY;IAOzB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB1F,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAE,SAAS,GAAG,OAAmB;IAQjF,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI;IAIvD,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI;IAInC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI;IAItC,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI;IAI9D,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI;IAIjC,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI;IAIjC,cAAc,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI;IAI/D,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI;IAInD,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI;IAIpD,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI;IAI5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI;IAI7B,kBAAkB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI;IAIjE,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI;IAIjE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI;IAItE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI;IAOnE,oBAAoB,CAAC,QAAQ,EAAE,MAAM;CAGtC"}

package/dist/moduleBridge.js

@@ -1,48 +1,119 @@
-// src/moduleBridge.ts
 import { BridgeBase } from './bridgeBase';
 import { MessageType } from './messageTypes';
-/**
- * Module-side bridge for communication with the host application.
- */
 export class ModuleBridge extends BridgeBase {
     constructor(targetOrigin = '*') {
         super(window.parent, targetOrigin);
+        this.startedPayload = null;
     }
-    // ---------- Lifecycle / handshake ----------
+    // --------------------
+    // Handshake
+    // --------------------
     sendHandshake(payload) {
         this.send(MessageType.HANDSHAKE_READY, payload);
     }
+    // --------------------
+    // Module Start
+    // --------------------
     onModuleStart(callback) {
-        this.on(MessageType.MODULE_START, 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;
+            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);
     }
     sendError(payload) {
         this.send(MessageType.ERROR, payload);
     }
-    // ---------- Request / response ----------
-    /**
-     * Module requests data from host
-     */
-    requestData(type, payload, timeout = 5000) {
-        const requestPayload = {
+    // --------------------
+    // Requests
+    // --------------------
+    async requestData(type, payload, timeout = 5000) {
+        const request = {
             requestId: crypto.randomUUID(),
             type,
             payload: payload
         };
-        return this.request(MessageType.DATA_REQUEST, requestPayload, timeout);
+        const response = (await this.request(MessageType.DATA_REQUEST, request, timeout));
+        if (response.status === 'error')
+            throw new Error(response.error || 'Unknown error from host');
+        return response.payload;
     }
-    /**
-     * Respond to a host request
-     */
     respondData(requestId, data, status = 'success') {
-        const response = {
-            requestId,
-            status,
-            payload: data
-        };
+        const response = { requestId, status, payload: data };
         this.send(MessageType.DATA_RESPONSE, response);
     }
+    // --------------------
+    // Convenience methods to handle host messages
+    // --------------------
+    onLoadPage(callback) {
+        this.on(MessageType.LOAD_PAGE, callback);
+    }
+    onNavigateBack(callback) {
+        this.on(MessageType.NAVIGATE_BACK, callback);
+    }
+    onNavigateForward(callback) {
+        this.on(MessageType.NAVIGATE_FORWARD, callback);
+    }
+    onSetBreadcrumb(callback) {
+        this.on(MessageType.SET_BREADCRUMB, callback);
+    }
+    onShowLoader(callback) {
+        this.on(MessageType.SHOW_LOADER, callback);
+    }
+    onHideLoader(callback) {
+        this.on(MessageType.HIDE_LOADER, callback);
+    }
+    onNotification(callback) {
+        this.on(MessageType.NOTIFICATION, callback);
+    }
+    onDialog(callback) {
+        this.on(MessageType.DIALOG, callback);
+    }
+    onConfirm(callback) {
+        this.on(MessageType.CONFIRM, callback);
+    }
+    onPause(callback) {
+        this.on(MessageType.MODULE_PAUSE, callback);
+    }
+    onResume(callback) {
+        this.on(MessageType.MODULE_RESUME, callback);
+    }
+    onPermissionUpdate(callback) {
+        this.on(MessageType.PERMISSION_UPDATE, callback);
+    }
+    onFeatureToggle(callback) {
+        this.on(MessageType.FEATURE_TOGGLE, callback);
+    }
+    onPreloadResources(callback) {
+        this.on(MessageType.PRELOAD_RESOURCE, callback);
+    }
+    onResourceLoaded(callback) {
+        this.on(MessageType.RESOURCE_LOADED, callback);
+    }
+    // --------------------
+    // Notify host about resource ready
+    // --------------------
+    notifyResourceLoaded(resource) {
+        this.send(MessageType.RESOURCE_LOADED, { resource });
+    }
 }
 //# sourceMappingURL=moduleBridge.js.map

package/dist/moduleBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"moduleBridge.js","sourceRoot":"","sources":["../src/moduleBridge.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAS5C;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C,YAAY,eAAuB,GAAG;QACpC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACpC,CAAC;IAED,8CAA8C;IAC9C,aAAa,CAAC,OAA8B;QAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;IAED,aAAa,CAAC,QAAgC;QAC5C,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;IAC7C,CAAC;IAED,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,2CAA2C;IAC3C;;OAEG;IACH,WAAW,CAAmB,IAAY,EAAE,OAAW,EAAE,OAAO,GAAG,IAAI;QACrE,MAAM,cAAc,GAAmB;YACrC,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE;YAC9B,IAAI;YACJ,OAAO,EAAE,OAAc;SACxB,CAAA;QACD,OAAO,IAAI,CAAC,OAAO,CAAoB,WAAW,CAAC,YAAY,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;IAC3F,CAAC;IAED;;OAEG;IACJ,WAAW,CAAC,SAAiB,EAAE,IAAS,EAAE,SAA8B,SAAS;QAChF,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;CAEA"}
+{"version":3,"file":"moduleBridge.js","sourceRoot":"","sources":["../src/moduleBridge.ts"],"names":[],"mappings":"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"}

package/dist/payloadSchemas.d.ts

@@ -1,76 +1,111 @@
-/**
- * Payload for handshake ready message.
- * Module → Host
- */
+import { MessageType } from './messageTypes';
 export interface HandshakeReadyPayload {
     version: string;
     timestamp: number;
+    capabilities?: string[];
 }
-/**
- * Payload for starting a module.
- * Host → Module
- */
 export interface ModuleStartPayload {
     moduleId: string;
     route: string;
     context: Record<string, any>;
     timestamp: number;
 }
-/**
- * Payload for module exit
- * Host → Module
- */
 export interface ModuleExitPayload {
     reason?: string;
 }
-/**
- * Payload for UI updates from module
- * Module → Host
- */
 export interface UIUpdatePayload {
     title: string;
     breadcrumb: string[];
     theme?: string;
 }
-/**
- * Payload for errors
- * Module → Host
- */
 export interface ErrorPayload {
     code: string;
     message: string;
     details?: any;
 }
-/**
- * Payload for context updates
- * Host → Module
- */
 export interface ModuleContextPayload {
     user?: Record<string, any>;
     tenant?: Record<string, any>;
     permissions?: string[];
     theme?: string;
 }
-/**
- * Request payload (sent by requester)
- * Can be Module → Host or Host → Module
- */
 export interface RequestPayload {
     requestId: string;
     type: string;
-    payload?: Record<string, any>;
+    payload?: any;
 }
-/**
- * Response payload (sent by responder)
- */
 export interface ResponsePayload {
     requestId: string;
     status: 'success' | 'error';
     payload?: any;
     error?: string;
 }
-/**
- * Union type representing all payloads
- */
-export type MessagePayload = HandshakeReadyPayload | ModuleStartPayload | ModuleExitPayload | UIUpdatePayload | ErrorPayload | ModuleContextPayload | RequestPayload | ResponsePayload;
+export interface HeartbeatPayload {
+    timestamp: number;
+    ack?: boolean;
+}
+export interface LoadPagePayload {
+    component: string;
+    params?: Record<string, any>;
+}
+export interface NavigationPayload {
+}
+export interface BreadcrumbPayload {
+    breadcrumb: string[];
+}
+export interface NotificationPayload {
+    message: string;
+    type: 'info' | 'success' | 'warning' | 'error';
+}
+export interface DialogPayload {
+    title?: string;
+    message: string;
+}
+export interface PauseResumePayload {
+}
+export interface PermissionPayload {
+    permissions: string[];
+}
+export interface FeatureTogglePayload {
+    features: Record<string, boolean>;
+}
+export interface PreloadResourcePayload {
+    resources: string[];
+}
+export interface ResourceLoadedPayload {
+    resource: string;
+}
+export type LogPayload = {
+    message: string;
+    level?: 'info' | 'warn' | 'error';
+};
+export type MessagePayload = HandshakeReadyPayload | ModuleStartPayload | ModuleExitPayload | UIUpdatePayload | ErrorPayload | ModuleContextPayload | RequestPayload | ResponsePayload | HeartbeatPayload | LoadPagePayload | NavigationPayload | BreadcrumbPayload | NotificationPayload | DialogPayload | PauseResumePayload | PermissionPayload | FeatureTogglePayload | PreloadResourcePayload | ResourceLoadedPayload | LogPayload | undefined | any;
+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;
+    [MessageType.LOAD_PAGE]: LoadPagePayload;
+    [MessageType.NAVIGATE_BACK]: NavigationPayload;
+    [MessageType.NAVIGATE_FORWARD]: NavigationPayload;
+    [MessageType.SET_BREADCRUMB]: BreadcrumbPayload;
+    [MessageType.SHOW_LOADER]: undefined;
+    [MessageType.HIDE_LOADER]: undefined;
+    [MessageType.NOTIFICATION]: NotificationPayload;
+    [MessageType.DIALOG]: DialogPayload;
+    [MessageType.CONFIRM]: DialogPayload;
+    [MessageType.MODULE_PAUSE]: PauseResumePayload;
+    [MessageType.MODULE_RESUME]: PauseResumePayload;
+    [MessageType.PERMISSION_UPDATE]: PermissionPayload;
+    [MessageType.FEATURE_TOGGLE]: FeatureTogglePayload;
+    [MessageType.PRELOAD_RESOURCE]: PreloadResourcePayload;
+    [MessageType.RESOURCE_LOADED]: ResourceLoadedPayload;
+    [MessageType.LOG]: LogPayload;
+    [key: `CUSTOM:${string}`]: any;
+}
 //# 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":"AAGA;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,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;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,GAAG,CAAA;CACd;AAED;;;GAGG;AACH,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;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,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;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,YAAY,GACZ,oBAAoB,GACpB,cAAc,GACd,eAAe,CAAA"}
+{"version":3,"file":"payloadSchemas.d.ts","sourceRoot":"","sources":["../src/payloadSchemas.ts"],"names":[],"mappings":"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"}

package/dist/payloadSchemas.js

@@ -1,2 +1,3 @@
-export {};
+// src/payloadSchemas.ts
+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":""}
+{"version":3,"file":"payloadSchemas.js","sourceRoot":"","sources":["../src/payloadSchemas.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,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.2.0",
+  "version": "1.4.0",
   "description": "TypeScript SDK for message-based communication between SchoolPalm host and vendor modules.",
   "type": "module",
   "main": "dist/index.js",