@gjsify/message-channel 0.4.12

package/globals.mjs

@@ -0,0 +1,13 @@
+/**
+ * Re-exports native MessageChannel/MessagePort globals for Node.js builds.
+ *
+ * On Node 22+ these are real globals (HTML spec implementation lives in
+ * the runtime since Node 15). The `ALIASES_WEB_FOR_NODE` redirect in
+ * `@gjsify/resolve-npm` points bare `message-channel` imports here on
+ * Node so consumer code gets the native implementation.
+ *
+ * On GJS the bare `message-channel` specifier resolves to
+ * `@gjsify/message-channel` instead — see `ALIASES_WEB_FOR_GJS`.
+ */
+export const MessageChannel = globalThis.MessageChannel;
+export const MessagePort = globalThis.MessagePort;

package/lib/esm/_virtual/_rolldown/runtime.js

@@ -0,0 +1 @@
+var e=Object.defineProperty,__name=(t,n)=>e(t,`name`,{value:n,configurable:!0});export{__name};

package/lib/esm/index.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";import{EventTarget as e,MessageEvent as t}from"@gjsify/dom-events";let n=1;var MessagePort=class extends e{_partner=null;_portId=n++;_transferred=!1;_transport=null;_started=!1;_queue=[];_closed=!1;_onmessage=null;_onmessageerror=null;postMessage(e,t){if(this._transferred)throw DOMException_(`Cannot post on a transferred MessagePort`,`InvalidStateError`);if(!this._closed){if(this._transport!==null){this._transport.send(this._portId,e);return}this._partner&&!this._partner._closed&&this._partner._receive(e)}}start(){if(this._started||this._closed)return;this._started=!0;let e=this._queue;this._queue=[];for(let t of e)this._dispatch(t)}close(){this._closed||(this._closed=!0,this._transport!==null&&(this._transport.close(this._portId),this._transport=null),this._partner=null,this._queue.length=0)}_receive(e){if(!this._closed){if(!this._started){this._queue.push(e);return}this._dispatch(e)}}_dispatch(e){Promise.resolve().then(()=>{this._closed||this.dispatchEvent(new t(`message`,{data:e}))})}get onmessage(){return this._onmessage}set onmessage(e){this._onmessage&&this.removeEventListener(`message`,this._onmessage),this._onmessage=e,e&&this.addEventListener(`message`,e)}get onmessageerror(){return this._onmessageerror}set onmessageerror(e){this._onmessageerror&&this.removeEventListener(`messageerror`,this._onmessageerror),this._onmessageerror=e,e&&this.addEventListener(`messageerror`,e)}addEventListener(e,t,n){super.addEventListener(e,t,n),e===`message`&&this.start()}get[Symbol.toStringTag](){return`MessagePort`}},MessageChannel=class{port1;port2;constructor(){this.port1=new MessagePort,this.port2=new MessagePort,this.port1._partner=this.port2,this.port2._partner=this.port1}get[Symbol.toStringTag](){return`MessageChannel`}};function DOMException_(e,t){let n=globalThis.DOMException;if(typeof n==`function`)return new n(e,t);let r=Error(e);return r.name=t,r}export{MessageChannel,MessagePort};

package/lib/esm/register.js

@@ -0,0 +1 @@
+import{MessageChannel as e,MessagePort as t}from"./index.js";globalThis.MessageChannel===void 0&&(globalThis.MessageChannel=e),globalThis.MessagePort===void 0&&(globalThis.MessagePort=t);

package/lib/types/index.d.ts

@@ -0,0 +1,62 @@
+import { EventTarget, MessageEvent } from '@gjsify/dom-events';
+/**
+ * Pluggable transport interface that lets a MessagePort route its
+ * outbound messages through something other than its in-process partner.
+ *
+ * @gjsify/iframe attaches a transport that JSON-serialises + sends over
+ * a WebKit script-message-handler. Future transports might attach a
+ * stdin-pipe writer (worker_threads) or a BroadcastChannel relay.
+ *
+ * @internal
+ */
+export interface MessagePortTransport {
+    /** Send a payload along this port's wire. */
+    send(portId: number, data: unknown): void;
+    /** Close this port's wire endpoint. */
+    close(portId: number): void;
+}
+export declare class MessagePort extends EventTarget {
+    /** @internal In-process partner; null after transfer attaches a transport. */
+    _partner: MessagePort | null;
+    /** @internal Per-port unique id. Used by transports for routing. */
+    _portId: number;
+    /** @internal True once the port has been listed in a transferList. Future
+     *  postMessage calls on this instance throw — see HTML spec. */
+    _transferred: boolean;
+    /** @internal Outbound-message router. When set, postMessage routes via
+     *  `transport.send(portId, data)` instead of the in-process partner. */
+    _transport: MessagePortTransport | null;
+    /** @internal HTML implicit-start gate: messages received before start()
+     *  (or before the first addEventListener('message')) buffer here. */
+    _started: boolean;
+    _queue: unknown[];
+    _closed: boolean;
+    /** @internal onmessage / onmessageerror IDL attribute backing field. */
+    _onmessage: ((evt: MessageEvent) => unknown) | null;
+    _onmessageerror: ((evt: MessageEvent) => unknown) | null;
+    postMessage(data: unknown, _transfer?: unknown[]): void;
+    /**
+     * Per W3C: enables dispatching of queued messages. Explicit `start()`
+     * is rarely needed — adding a `'message'` listener via
+     * addEventListener (or assigning to `.onmessage`) auto-starts the
+     * port. This method exists for code that defers listener attachment.
+     */
+    start(): void;
+    close(): void;
+    /** @internal Wire-side delivery point: called by the in-process partner
+     *  OR by the transport's recv-loop when a message arrives off the wire. */
+    _receive(data: unknown): void;
+    private _dispatch;
+    get onmessage(): ((evt: MessageEvent) => unknown) | null;
+    set onmessage(fn: ((evt: MessageEvent) => unknown) | null);
+    get onmessageerror(): ((evt: MessageEvent) => unknown) | null;
+    set onmessageerror(fn: ((evt: MessageEvent) => unknown) | null);
+    addEventListener(type: string, listener: any, options?: any): void;
+    get [Symbol.toStringTag](): string;
+}
+export declare class MessageChannel {
+    readonly port1: MessagePort;
+    readonly port2: MessagePort;
+    constructor();
+    get [Symbol.toStringTag](): string;
+}

package/lib/types/message-channel.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/register.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,57 @@
+{
+    "name": "@gjsify/message-channel",
+    "version": "0.4.12",
+    "description": "W3C MessageChannel + MessagePort for GJS — EventTarget-based, transport-pluggable. Same surface backs in-process channels (default), the @gjsify/iframe WebKit bridge, and (future) @gjsify/worker_threads cross-process workers.",
+    "type": "module",
+    "module": "lib/esm/index.js",
+    "types": "lib/types/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./lib/types/index.d.ts",
+            "default": "./lib/esm/index.js"
+        },
+        "./register": {
+            "types": "./lib/types/register.d.ts",
+            "default": "./lib/esm/register.js"
+        },
+        "./globals": "./globals.mjs"
+    },
+    "files": [
+        "lib",
+        "globals.mjs"
+    ],
+    "sideEffects": [
+        "./lib/esm/register.js",
+        "./globals.mjs"
+    ],
+    "scripts": {
+        "clear": "rm -rf lib tsconfig.tsbuildinfo tsconfig.types.tsbuildinfo test.gjs.mjs test.node.mjs || exit 0",
+        "check": "tsc --noEmit",
+        "build": "gjsify run build:gjsify && gjsify run build:types",
+        "build:gjsify": "gjsify build --library 'src/**/*.{ts,js}' --exclude 'src/**/*.spec.{mts,ts}' 'src/test.{mts,ts}'",
+        "build:types": "tsc",
+        "build:test": "gjsify run build:test:gjs && gjsify run build:test:node",
+        "build:test:gjs": "gjsify build src/test.mts --app gjs --outfile test.gjs.mjs",
+        "build:test:node": "gjsify build src/test.mts --app node --outfile test.node.mjs",
+        "test": "gjsify run build:gjsify && gjsify run build:test && gjsify run test:node && gjsify run test:gjs",
+        "test:gjs": "gjsify run test.gjs.mjs",
+        "test:node": "node test.node.mjs"
+    },
+    "keywords": [
+        "gjs",
+        "web",
+        "messagechannel",
+        "messageport"
+    ],
+    "devDependencies": {
+        "@gjsify/cli": "^0.4.12",
+        "@gjsify/unit": "^0.4.12",
+        "@types/node": "^25.6.2",
+        "typescript": "^6.0.3"
+    },
+    "dependencies": {
+        "@gjsify/dom-events": "^0.4.12"
+    },
+    "license": "MIT",
+    "author": "Pascal Garber <pascal@artandcode.studio>"
+}