@schoolpalm/message-bridge 1.3.0 → 1.4.0

package/dist/bridgeBase.d.ts

@@ -1,7 +1,7 @@
 import { MessageType } from './messageTypes';
 import { MessagePayloadMap } from './payloadSchemas';
 import { RequestPayload } from './payloadSchemas';
-type MessageHandler<T> = (payload: T) => void;
+type MessageHandler<T = any> = (payload: T) => void;
 export declare class BridgeBase {
     protected targetWindow: Window;
     protected targetOrigin: string;
@@ -9,9 +9,9 @@ export declare class BridgeBase {
     private pendingRequests;
     private boundHandler;
     constructor(targetWindow: Window, targetOrigin?: string);
-    send<T extends MessageType>(type: T, payload: MessagePayloadMap[T]): 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 MessageType>(type: T, callback: MessageHandler<MessagePayloadMap[T]>): void;
+    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;
 }

package/dist/bridgeBase.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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

@@ -9,24 +9,22 @@ export class BridgeBase {
         window.addEventListener('message', this.boundHandler);
     }
     // --------------------
-    // Send (typed)
+    // 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 = payload.requestId;
             this.pendingRequests.set(requestId, (response) => {
-                if (response.status === 'error') {
+                if (response.status === 'error')
                     reject(new Error(response.error ?? 'Unknown error'));
-                }
-                else {
+                else
                     resolve(response.payload);
-                }
             });
             this.send(type, payload);
             setTimeout(() => {
@@ -38,12 +36,11 @@ export class BridgeBase {
         });
     }
     // --------------------
-    // Listeners (typed)
+    // Listen to message
     // --------------------
     on(type, callback) {
-        if (!this.listeners.has(type)) {
+        if (!this.listeners.has(type))
             this.listeners.set(type, []);
-        }
         this.listeners.get(type).push(callback);
     }
     // --------------------
@@ -55,7 +52,7 @@ export class BridgeBase {
         const { type, payload } = event.data || {};
         if (!type)
             return;
-        // Handle responses
+        // Handle DATA_RESPONSE automatically
         if (type === MessageType.DATA_RESPONSE) {
             const response = payload;
             const resolver = this.pendingRequests.get(response.requestId);
@@ -65,9 +62,18 @@ export class BridgeBase {
                 return;
             }
         }
+        // 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
+    // --------------------
     destroy() {
         window.removeEventListener('message', this.boundHandler);
         this.listeners.clear();

package/dist/bridgeBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridgeBase.js","sourceRoot":"","sources":["../src/bridgeBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAM5C,MAAM,OAAO,UAAU;IAQrB,YAAY,YAAoB,EAAE,eAAuB,GAAG;QAJpD,cAAS,GAAG,IAAI,GAAG,EAAsC,CAAA;QACzD,oBAAe,GAAG,IAAI,GAAG,EAAkC,CAAA;QAIjE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAEhC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IACvD,CAAC;IAED,uBAAuB;IACvB,eAAe;IACf,uBAAuB;IACvB,IAAI,CACF,IAAO,EACP,OAA6B;QAE7B,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IACrE,CAAC;IAED,uBAAuB;IACvB,qBAAqB;IACrB,uBAAuB;IACxB,OAAO,CACN,IAAiB,EACjB,OAAuB,EACvB,OAAO,GAAG,IAAI;QAEd,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;YAEnC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,QAAyB,EAAE,EAAE;gBAChE,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC,CAAA;gBACtD,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,QAAQ,CAAC,OAAY,CAAC,CAAA;gBAChC,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAExB,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBACxC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;oBACtC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,OAAO,CAAC,IAAI,YAAY,CAAC,CAAC,CAAA;gBACxD,CAAC;YACH,CAAC,EAAE,OAAO,CAAC,CAAA;QACb,CAAC,CAAC,CAAA;IACJ,CAAC;IAGC,uBAAuB;IACvB,oBAAoB;IACpB,uBAAuB;IACvB,EAAE,CACA,IAAO,EACP,QAA8C;QAE9C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC9B,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC1C,CAAC;IAED,uBAAuB;IACvB,aAAa;IACb,uBAAuB;IACb,aAAa,CAAC,KAAmB;QACzC,IAAI,IAAI,CAAC,YAAY,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,YAAY;YAAE,OAAM;QAE3E,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;QAC1C,IAAI,CAAC,IAAI;YAAE,OAAM;QAEjB,mBAAmB;QACnB,IAAI,IAAI,KAAK,WAAW,CAAC,aAAa,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,OAA0B,CAAA;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;YAC7D,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,QAAQ,CAAC,CAAA;gBAClB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;gBAC/C,OAAM;YACR,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACzC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IACtC,CAAC;IAED,OAAO;QACL,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QACxD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;QACtB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAA;IAC9B,CAAC;CACF"}
+{"version":3,"file":"bridgeBase.js","sourceRoot":"","sources":["../src/bridgeBase.ts"],"names":[],"mappings":"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"}

package/dist/hostBridge.d.ts

@@ -4,12 +4,12 @@ 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;
-    private heartbeatTimer?;
     startHeartbeat(interval?: number): void;
     stopHeartbeat(): void;
-    private lastHeartbeat;
     listenHeartbeat(timeout?: number): void;
     startModule(payload: ModuleStartPayload, timeout?: number): void;
     sendModuleStart(payload: ModuleStartPayload): void;
@@ -18,6 +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":"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"}
+{"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

@@ -3,9 +3,8 @@ import { MessageType } from './messageTypes';
 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;
@@ -13,7 +12,7 @@ export class HostBridge extends BridgeBase {
         this.lastHeartbeat = Date.now();
     }
     // --------------------
-    // Handshake (sticky)
+    // Handshake
     // --------------------
     onHandshakeReady(callback) {
         if (this.handshakeCompleted && this.handshakePayload) {
@@ -21,7 +20,6 @@ export class HostBridge extends BridgeBase {
             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}`);
             }
@@ -34,6 +32,9 @@ export class HostBridge extends BridgeBase {
             }
         });
     }
+    // --------------------
+    // Heartbeat
+    // --------------------
     startHeartbeat(interval = 5000) {
         this.stopHeartbeat();
         this.heartbeatTimer = window.setInterval(() => {
@@ -58,7 +59,7 @@ export class HostBridge extends BridgeBase {
         }, timeout);
     }
     // --------------------
-    // Start (idempotent)
+    // Module Start / Exit
     // --------------------
     startModule(payload, timeout = 5000) {
         if (this.handshakeCompleted) {
@@ -66,9 +67,7 @@ export class HostBridge extends BridgeBase {
             return;
         }
         this.pendingStartPayload = payload;
-        const timer = setTimeout(() => {
-            console.error('Module handshake timeout');
-        }, timeout);
+        const timer = setTimeout(() => console.error('Module handshake timeout'), timeout);
         this.onHandshakeReady(() => clearTimeout(timer));
     }
     sendModuleStart(payload) {
@@ -86,9 +85,6 @@ export class HostBridge extends BridgeBase {
     onError(callback) {
         this.on(MessageType.ERROR, callback);
     }
-    // --------------------
-    // Context sync
-    // --------------------
     sendContextUpdate(payload) {
         this.send(MessageType.CONTEXT_UPDATE, payload);
     }
@@ -104,7 +100,64 @@ export class HostBridge extends BridgeBase {
         return this.request(MessageType.DATA_REQUEST, request, timeout);
     }
     // --------------------
-    // Reset (reconnect)
+    // 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;

package/dist/hostBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"hostBridge.js","sourceRoot":"","sources":["../src/hostBridge.ts"],"names":[],"mappings":"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"}
+{"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/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,32 +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",
-    HEARTBEAT = "heartbeat"
+    /** 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;IAEjC,SAAS,cAAc;CAExB"}
+{"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,34 +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";
-    // messageTypes.ts
+    // -----------------------
+    // 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,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"}
+{"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,5 +1,5 @@
 import { BridgeBase } from './bridgeBase';
-import { HandshakeReadyPayload, UIUpdatePayload, ErrorPayload, HeartbeatPayload } from './payloadSchemas';
+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);
@@ -10,5 +10,21 @@ export declare class ModuleBridge extends BridgeBase {
     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;
+    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":"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"}
+{"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

@@ -12,12 +12,11 @@ export class ModuleBridge extends BridgeBase {
         this.send(MessageType.HANDSHAKE_READY, payload);
     }
     // --------------------
-    // Start (sticky)
+    // Module Start
     // --------------------
     onModuleStart(callback) {
-        if (this.startedPayload) {
+        if (this.startedPayload)
             callback(this.startedPayload);
-        }
         this.on(MessageType.MODULE_START, payload => {
             this.startedPayload = payload;
             callback(payload);
@@ -29,14 +28,10 @@ export class ModuleBridge extends BridgeBase {
     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
-            });
+            this.send(MessageType.HEARTBEAT, { timestamp: Date.now(), ack: true });
         });
     }
     // --------------------
@@ -57,23 +52,68 @@ export class ModuleBridge extends BridgeBase {
             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') {
+        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 host requests
-    // --------------------
     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,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"}
+{"version":3,"file":"moduleBridge.js","sourceRoot":"","sources":["../src/moduleBridge.ts"],"names":[],"mappings":"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"}

package/dist/payloadSchemas.d.ts

@@ -1,3 +1,4 @@
+import { MessageType } from './messageTypes';
 export interface HandshakeReadyPayload {
     version: string;
     timestamp: number;
@@ -39,16 +40,46 @@ export interface ResponsePayload {
     payload?: any;
     error?: string;
 }
-/**
- * Payload for heartbeat messages.
- * Host ↔ Module
- */
 export interface HeartbeatPayload {
     timestamp: number;
     ack?: boolean;
 }
-export type MessagePayload = HandshakeReadyPayload | ModuleStartPayload | ModuleExitPayload | UIUpdatePayload | ErrorPayload | ModuleContextPayload | RequestPayload | ResponsePayload | HeartbeatPayload;
-import { MessageType } from './messageTypes';
+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;
@@ -59,5 +90,22 @@ export interface MessagePayloadMap {
     [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":"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"}
+{"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 @@
+// 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":"AAuEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"payloadSchemas.js","sourceRoot":"","sources":["../src/payloadSchemas.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}

package/package.json

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