@craftile/messenger 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Craftile Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@craftile/messenger",
+  "version": "0.1.0",
+  "description": "A type wrapper of window.postMessage for iframe/parent communication",
+  "keywords": [
+    "craftile",
+    "messenger",
+    "postMessage",
+    "events"
+  ],
+  "license": "MIT",
+  "authors": [
+    {
+      "name": "Eldo Magan",
+      "email": "magan.eldo@gmail.com"
+    }
+  ],
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": "./src/index.ts",
+  "files": [
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/craftile/editor.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,72 @@
+export interface TypedMessage<T = any> {
+  type: string;
+  payload: T | undefined;
+}
+
+export class WindowMessenger<Messages extends Record<string, any>> {
+  private handlers = new Map<keyof Messages, Function[]>();
+  private targetWindow: Window;
+  private targetOrigin: string;
+  private fallbackHandler?: (data: any, event: MessageEvent) => void;
+
+  constructor(targetWindow: Window, targetOrigin: string = '*') {
+    this.targetWindow = targetWindow;
+    this.targetOrigin = targetOrigin;
+
+    window.addEventListener('message', this.handleMessage.bind(this));
+  }
+
+  private handleMessage(event: MessageEvent) {
+    const message = event.data as TypedMessage;
+
+    if (!message.type) {
+      return;
+    }
+
+    const handlers = this.handlers.get(message.type);
+
+    if (handlers) {
+      handlers.forEach((handler) => handler(message.payload, event));
+    } else if (this.fallbackHandler) {
+      this.fallbackHandler(event.data, event);
+    }
+  }
+
+  send<K extends keyof Messages>(type: K, payload?: Messages[K]): void {
+    const message: TypedMessage<Messages[K]> = { type: type as string, payload };
+    this.targetWindow.postMessage(message, this.targetOrigin);
+  }
+
+  listen<K extends keyof Messages>(type: K, handler: (data: Messages[K], event: MessageEvent) => void): () => void {
+    if (!this.handlers.has(type)) {
+      this.handlers.set(type, []);
+    }
+
+    this.handlers.get(type)!.push(handler);
+
+    return () => {
+      const handlers = this.handlers.get(type);
+      if (handlers) {
+        const index = handlers.indexOf(handler);
+        if (index > -1) {
+          handlers.splice(index, 1);
+        }
+      }
+    };
+  }
+
+  registerFallbackHandler(handler: (data: any, event: MessageEvent) => void) {
+    this.fallbackHandler = handler;
+  }
+}
+
+export function createIframeMessenger<T extends Record<string, any>>(iframe: HTMLIFrameElement, targetOrigin = '*') {
+  return new WindowMessenger<T>(iframe.contentWindow!, targetOrigin);
+}
+
+export function createParentMessenger<T extends Record<string, any>>(targetOrigin = '*') {
+  if (window.parent === window) {
+    throw new Error('Not inside an iframe');
+  }
+  return new WindowMessenger<T>(window.parent, targetOrigin);
+}