@webreflection/bindings 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2026-today, Andrea Giammarchi, @WebReflection
+
+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/README.md

@@ -0,0 +1,32 @@
+# @webreflection/bindings
+
+A (soon to be) collection of bindings for various scenarios.
+
+### Example
+
+```js
+import bindings from '@webreflection/bindings/port';
+
+const { port1, port2 } = new MessageChannel;
+
+// expose bindings the remote can invoke
+// the `remote` itself can invoke (asynchronously)
+// bindings exposed via the other port
+const remote = bindings(port1, {
+  log(...values) {
+    console.log(...values);
+  }
+});
+
+// assuming this is an iframe
+parent.postMessage(null, '*', [port2]);
+
+// later on ...
+const value = await remote.doThings(1, 2, 3);
+```
+
+The remote counterpart can use or expose bindings in a similar way, this module just orchestrate a reliable way to invoke exposed APIs via `postMessage` dances.
+
+## Currently Available
+
+  * `@webreflection/bindings/port` to add bindings via *MessagePort* orchestration

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@webreflection/bindings",
+  "version": "0.0.0",
+  "description": "",
+  "exports": {
+    "./message-port": "./src/message-port.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "MessagePort"
+  ],
+  "author": "Andrea Giammarchi",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@webreflection/utils": "^0.3.6",
+    "next-resolver": "^0.2.0"
+  }
+}

package/src/message-port.js

@@ -0,0 +1,29 @@
+import nextResolver from 'next-resolver';
+import { nil } from '@webreflection/utils/empty';
+
+const [next, resolve] = nextResolver();
+
+/**
+ * Creates a proxy that can be used to call methods remotely via the port.
+ * @param {MessagePort} port - The port to use for communication.
+ * @param {Record<string, (...args: any[]) => Promise<any>>} bindings - The bindings to use for the methods.
+ * @returns {Record<string, (...args: any[]) => Promise<any>>}
+ */
+export default (port, bindings) => {
+  port.onmessage = async ({ data: [exec, id, name, args] }) => {
+    if (exec) {
+      try { port.postMessage([!exec, id, await bindings[name](...args), null]) }
+      catch (error) { port.postMessage([!exec, id, null, error]) }
+    }
+    else resolve(id, name, args);
+  };
+  return new Proxy(nil, {
+    get(_, name) {
+      return (...args) => {
+        const [id, promise] = next();
+        port.postMessage([true, id, name, args]);
+        return promise;
+      };
+    }
+  });
+};