rimless 0.5.1 → 0.7.0

package/README.md

@@ -14,9 +14,9 @@
 [![Commitizen friendly][commitizen-image]][commitizen-url]
 ![npm bundle size](https://img.shields.io/bundlephobia/minzip/rimless)
 
-> Rimless makes event based communication easy with a promise-based API wrapping [postMessage](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage). Works with both **iframes** and **webworkers**.
+> Rimless makes event based communication easy with a promise-based API wrapping [postMessage](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage). Works with **iframes**, **webworkers**, and **Node.js worker threads**.
 
-You can use `rimless` to call remote procedures, exchange data or expose local functions with **iframes**/**webworkers**.
+You can use `rimless` to call remote procedures, exchange data or expose local functions with **iframes**, **webworkers**, or **Node.js workers**.
 
 You can see it in action in the code sandbox below:
 
@@ -42,50 +42,69 @@ or from a CDN
 
 ## Example Usage
 
-**in the host website**
+Below is a minimal but complete round‑trip that shows how each side can:
+
+1. expose variables and functions,
+2. read the other side’s variables,
+3. invoke the other side’s functions,
+4. finally close the link.
+
+**Host (page that embeds the iframe)**
 
 ```js
 import { host } from "rimless";
 
-const connection = await host.connect(iframe, {
+const iframe = document.getElementById("myIframe");
+
+// Everything inside this object is exported to the guest
+const hostApi = {
   someHostVariable: 12,
   someHostFunction: (value) => `hello ${value}`,
-});
+};
 
-// access variables on the iframe
-console.log(connection.remote.someGuestVariable); // 42
+const connection = await host.connect(iframe, hostApi);
 
-// call remote procedures on the iframe
-const result = await connection.remote.someGuestFunction("here");
+// ↘︎  Access data that the iframe exposed
+console.log(connection.remote.someGuestVariable); // → 42
 
-console.log(result); // hello here
+// ↘︎  Call a guest‑side RPC and await its result
+const result = await connection.remote.someGuestFunction("here");
+console.log(result); // → "hello here"
 
-// close the connection
+// Done talking? Tear down the channel.
 connection.close();
 ```
 
-**in the iframe**
+**Guest (code that runs inside the iframe)**
 
 ```js
 import { guest } from "rimless";
 
-const connection = await guest.connect({
+// The object you pass to guest.connect is your public surface
+const guestApi = {
   someGuestVariable: 42,
   someGuestFunction: (value) => `hello ${value}`,
-});
+};
 
-// access variables on the host
-console.log(connection.remote.someHostVariable); // 12
+const connection = await guest.connect(guestApi);
 
-// call remote procedures on host
-const res = await connection.remote.someHostFunction("there");
+// ↗︎  Read a host‑side value
+console.log(connection.remote.someHostVariable); // → 12
 
-console.log(res); // hello there
+// ↗︎  Invoke a host‑side RPC
+const res = await connection.remote.someHostFunction("there");
+console.log(res); // → "hello there"
 
-// close the connection
+// Close when finished to free resources
 connection.close();
 ```
 
+**What to remember**
+
+- `connection.remote` is the automatically generated proxy for the other side’s exports.
+- Every remote call returns a Promise, so feel free to await it.
+- Always call `connection.close()` when you no longer need the tunnel—this removes event listeners and avoids memory leaks.
+
 ---
 
 ## Getting Started
@@ -129,7 +148,7 @@ guest.connect();
 
 ### Exposing an API
 
-To do anything meaningful with this connection you need to provide a schema that defines **the API** of the host/iframe/webworker. Any serializeable values as well as functions are ok to use. In the example below the host website provides a function that will update its background color when invoked.
+To do anything meaningful with this connection you need to provide a schema that defines **the API** of the host/iframe/webworker. Any serializable values as well as functions are ok to use. In the example below the host website provides a function that will update its background color when invoked.
 
 ```js
 import { host } from "rimless";
@@ -161,6 +180,59 @@ guest.connect().then((connection) => {
 });
 ```
 
+### Calling the remote from an RPC
+
+Every RPC handler you expose receives the caller’s method collection as its last parameter—conventionally named `remote`.
+That means an RPC can immediately call back into the opposite context to acknowledge success, return extra data, or kick‑off a follow‑up action.
+
+**Why it’s useful**
+
+- Confirm completion – send a quick “done!” message when a long‑running task finishes.
+- Chain operations – perform a host‑side update, then ask the guest to re‑render.
+- Stream results – push incremental data to the caller instead of waiting for one big response.
+
+```js
+// host (parent window)
+import { host } from "rimless";
+
+const api = {
+  /**
+   * Change the page background, then notify the guest.
+   * @param {string} color  Hex or CSS color string
+   * @param {object} remote Automatically injected guest‑side RPCs
+   */
+  setColor: (color, remote) => {
+    document.body.style.background = color;
+    remote.logMessage("Background updated ✔");
+  },
+};
+
+const iframe = document.getElementById("myIframe");
+host.connect(iframe, api);
+```
+
+```js
+// guest (inside the iframe)
+import { guest } from "rimless";
+
+const api = {
+  /** Show messages from the host */
+  logMessage: (msg) => console.log(msg),
+};
+
+const { remote } = await guest.connect(api);
+
+// Ask the host to change its background.
+// Afterwards, the guest will receive logMessage("Background updated ✔").
+remote.setColor("#011627");
+```
+
+**Key points**
+
+- Handler signature – (…args, remote); you can ignore remote if you don’t need it.
+- Promises everywhere – RPC calls return promises, so you can await remote.someMethod().
+- Keep it short – avoid deep call‑chains that bounce endlessly between host and guest.
+
 ### Closing a connection
 
 Closing a connection will remove all event listeners that were registered.
@@ -187,7 +259,7 @@ Now both can make use of the APIs they have shared with each other, e.g.
 
 ## Limitations
 
-All parameters passed through `postMessage` need to be serializeable. This applies also for all return values of the functions you expose.
+All parameters passed through `postMessage` need to be serializable. This applies also for all return values of the functions you expose.
 
 ```js
 // someFunction would return undefined when called in the remote.
@@ -203,9 +275,11 @@ This library is inspired by [Postmate](https://www.npmjs.com/package/postmate) a
 ### So why does this library exist?
 
 - works with webworkers!
+- works with Node.js worker threads
 - does not create the iframe (easier to work with libraries like react)
 - works with iframes using srcdoc
 - works with multiple iframes from the same origin
+- remote RPC handlers receive the caller's API as the last argument
 
 ---
 
@@ -223,11 +297,10 @@ host.connect(iframe, {
 });
 ```
 
-| Name      | Type                            | Description                          | Required |
-| --------- | ------------------------------- | ------------------------------------ | -------- |
-| `guest`   | `HTMLIFrameElement` or `Worker` | Target of the connection             | required |
-| `schema`  | `object`                        | schema of the api you want to expose | -        |
-| `options` | `object`                        | -                                    | -        |
+| Name     | Type                            | Description                          | Required |
+| -------- | ------------------------------- | ------------------------------------ | -------- |
+| `guest`  | `HTMLIFrameElement` or `Worker` | Target of the connection             | required |
+| `schema` | `object`                        | schema of the api you want to expose | -        |
 
 > ### `guest.connect`
 
@@ -239,10 +312,50 @@ guest.connect({
 });
 ```
 
-| Name      | Type     | Description                          | Default |
-| --------- | -------- | ------------------------------------ | ------- |
-| `schema`  | `object` | schema of the api you want to expose | -       |
-| `options` | `object` | -                                    | -       |
+| Name            | Type     | Description                                  | Default |
+| --------------- | -------- | -------------------------------------------- | ------- |
+| `schema`        | `object` | schema of the api you want to expose         | -       |
+| `eventHandlers` | `object` | lifecycle callbacks like `onConnectionSetup` | -       |
+
+`onConnectionSetup(remote)` is called once the handshake completes. It receives the remote API so you can perform setup logic before using the connection.
+
+> ### `withTransferable`
+
+Wrap RPC payloads that contain [transferable objects](https://developer.mozilla.org/en-US/docs/Glossary/Transferable_objects) so ownership moves between contexts instead of cloning the data. Useful for `ArrayBuffer`, `MessagePort`, `ReadableStream`, and similar types.
+
+```js
+import { withTransferable } from "rimless";
+
+const buffer = await file.arrayBuffer();
+
+await connection.remote.processFile(
+  withTransferable((transfer) => ({
+    name: file.name,
+    buffer: transfer(buffer), // moves the ArrayBuffer to the worker
+  })),
+);
+```
+
+`withTransferable` invokes your callback with a `transfer` helper. Call it for every object you want to mark as transferable; the helper returns the same value so you can build payloads inline. The metadata is attached to the wrapper object without mutating your data.
+
+Workers can also return transferables back to the caller:
+
+```js
+import { guest, withTransferable } from "rimless";
+
+const api = {
+  async processFile({ name, buffer }) {
+    const size = buffer.byteLength;
+
+    return withTransferable((transfer) => ({
+      summary: `Processed ${name} (${size} bytes)`,
+      buffer: transfer(buffer), // hands ownership back to the host
+    }));
+  },
+};
+
+await guest.connect(api);
+```
 
 ---
 

package/lib/helpers.d.ts

@@ -23,7 +23,7 @@ export declare function isIframe(): boolean;
  *
  * @param obj
  */
-export declare function extractMethods(obj: any): string[];
+export declare function extractMethods(obj: any): Record<string, (...args: any) => any>;
 /**
  * convert the url into an origin (remove paths)
  *
@@ -43,8 +43,9 @@ export declare function getTargetHost(): any;
  * @param target The target to send the message to
  * @param message The message to send
  * @param origin Optional origin for iframe communication
+ * @param transferables Optional transferables for postMessage
  */
-export declare function postMessageToTarget(target: Target, message: any, origin?: string): void;
+export declare function postMessageToTarget(target: Target, message: any, origin?: string, transferables?: Transferable[]): void;
 export declare function isNodeWorker(guest: Guest | Target): guest is NodeWorker;
 export declare function isWorkerLike(guest: Guest): guest is WorkerLike;
 export declare function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject): void;

package/lib/host.d.ts

@@ -3,7 +3,7 @@ import { Guest, Connection, Schema } from './types';
  * Perform a handshake with the target iframe, when the handshake is confirmed
  * resolve the connection object containing RPCs and properties
  *
- * @param iframe
+ * @param guest
  * @param schema
  * @returns Promise
  */

package/lib/index.d.ts

@@ -1,4 +1,5 @@
 import { default as guest } from './guest';
 import { default as host } from './host';
-export { host, guest };
+import { withTransferable } from './rpc';
+export { host, guest, withTransferable };
 export * from './types';

package/lib/rimless.js

@@ -1,258 +1,260 @@
-function I() {
+function _() {
   return typeof window > "u" && typeof self < "u";
 }
-function y() {
-  var n;
-  return typeof process < "u" && !!((n = process.versions) != null && n.node);
+function D() {
+  return typeof process < "u" && !!process.versions?.node;
 }
-function H() {
+function K() {
   return window.self !== window.top;
 }
-function _(n) {
-  const r = [];
-  return function t(e, i = "") {
-    Object.keys(e).forEach((o) => {
-      const c = i ? `${i}.${o}` : o;
-      e[o] === Object(e[o]) && t(e[o], c), typeof e[o] == "function" && r.push(c);
+function k(n) {
+  const r = {};
+  return function o(e, s = "") {
+    Object.keys(e).forEach((t) => {
+      const c = s ? `${s}.${t}` : t;
+      e[t] === Object(e[t]) && o(e[t], c), typeof e[t] == "function" && (r[c] = e[t], delete e[t]);
     });
   }(n), r;
 }
-const G = /^(https?:|file:)?\/\/([^/:]+)?(:(\d+))?/, K = { "http:": "80", "https:": "443" };
-function U(n) {
+const U = /^(https?:|file:)?\/\/([^/:]+)?(:(\d+))?/, W = { "http:": "80", "https:": "443" };
+function Q(n) {
   if (!n) return null;
-  const r = G.exec(n);
+  const r = U.exec(n);
   if (!r) return null;
-  const [, t = "http:", e, , i] = r;
-  if (t === "file:")
+  const [, o = "http:", e, , s] = r;
+  if (o === "file:")
     return "file://";
-  const o = i && i !== K[t] ? `:${i}` : "";
-  return `${t}//${e}${o}`;
+  const t = s && s !== W[o] ? `:${s}` : "";
+  return `${o}//${e}${t}`;
 }
-function W(n, r, t) {
-  const e = Array.isArray(r) ? r : r.split(".").filter(Boolean);
-  let i = n;
-  for (const o of e)
-    if (i = i == null ? void 0 : i[o], i === void 0)
-      return t;
-  return i;
-}
-function Q(n, r, t) {
+function Y(n, r, o) {
   if (!n || typeof n != "object") return n;
-  const e = Array.isArray(r) ? r : r.split(".").map((o) => o.match(/^\d+$/) ? Number(o) : o);
-  let i = n;
-  for (let o = 0; o < e.length; o++) {
-    const c = e[o];
-    o === e.length - 1 ? i[c] = t : ((!i[c] || typeof i[c] != "object") && (i[c] = typeof e[o + 1] == "number" ? [] : {}), i = i[c]);
+  const e = Array.isArray(r) ? r : r.split(".").map((t) => t.match(/^\d+$/) ? Number(t) : t);
+  let s = n;
+  for (let t = 0; t < e.length; t++) {
+    const c = e[t];
+    t === e.length - 1 ? s[c] = o : ((!s[c] || typeof s[c] != "object") && (s[c] = typeof e[t + 1] == "number" ? [] : {}), s = s[c]);
   }
   return n;
 }
-function T(n = 10) {
+function C(n = 10) {
   const r = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-  let t = "";
+  let o = "";
   for (let e = 0; e < n; e++)
-    t += r.charAt(Math.floor(Math.random() * r.length));
-  return t;
+    o += r.charAt(Math.floor(Math.random() * r.length));
+  return o;
 }
-let w = null;
-if (y())
+let y = null;
+if (D())
   try {
-    w = require("worker_threads").parentPort;
+    y = require("worker_threads").parentPort;
   } catch {
   }
 function $() {
-  if (y())
-    return w;
-  if (I())
+  if (D())
+    return y;
+  if (_())
     return self;
-  if (H())
+  if (K())
     return window.parent;
   throw new Error("No valid target found for postMessage");
 }
-function N(n, r, t) {
+function g(n, r, o, e) {
   if (!n)
     throw new Error("Rimless Error: No target specified for postMessage");
-  if (y() && n === w) {
-    n.postMessage(JSON.parse(JSON.stringify(r)));
+  if (D() && n === y) {
+    n.postMessage(r, { transfer: e });
     return;
   }
-  if (I()) {
-    n.postMessage(JSON.parse(JSON.stringify(r)));
+  if (_()) {
+    n.postMessage(r, { transfer: e });
     return;
   }
   if (n.postMessage) {
-    n.postMessage(JSON.parse(JSON.stringify(r)), { targetOrigin: t || "*" });
+    n.postMessage(r, { targetOrigin: o || "*", transfer: e });
     return;
   }
   throw new Error("Rimless Error: Invalid target for postMessage");
 }
-function L(n) {
-  return w !== null && n === w;
+function H(n) {
+  return y !== null && n === y;
 }
 function x(n) {
-  return L(n) || typeof Worker < "u" && n instanceof Worker;
+  return H(n) || typeof Worker < "u" && n instanceof Worker;
 }
-function m(n, r, t) {
-  L(n) ? n.on(r, t) : "addEventListener" in n && n.addEventListener(r, t);
+function L(n, r, o) {
+  H(n) ? n.on(r, o) : "addEventListener" in n && n.addEventListener(r, o);
 }
-function D(n, r, t) {
-  L(n) ? n.off(r, t) : "removeEventListener" in n && n.removeEventListener(r, t);
+function N(n, r, o) {
+  H(n) ? n.off(r, o) : "removeEventListener" in n && n.removeEventListener(r, o);
 }
-function M(n) {
+function P(n) {
   return n.data || n;
 }
-var R = /* @__PURE__ */ ((n) => (n.MESSAGE = "message", n))(R || {}), a = /* @__PURE__ */ ((n) => (n.HANDSHAKE_REQUEST = "RIMLESS/HANDSHAKE_REQUEST", n.HANDSHAKE_REPLY = "RIMLESS/HANDSHAKE_REPLY", n.RPC_REQUEST = "RIMLESS/RPC_REQUEST", n.RPC_RESOLVE = "RIMLESS/RPC_RESOLVE", n.RPC_REJECT = "RIMLESS/RPC_REJECT", n))(a || {});
-function J(n = {}, r = [], t, e, i) {
-  const o = [];
-  return r.forEach((c) => {
-    async function l(f) {
-      const s = M(f), { action: E, callID: d, connectionID: p, callName: h, args: g = [] } = s;
-      if (E !== a.RPC_REQUEST || !d || !h || h !== c || p !== t) return;
+var h = /* @__PURE__ */ ((n) => (n.MESSAGE = "message", n))(h || {}), u = /* @__PURE__ */ ((n) => (n.HANDSHAKE_REQUEST = "RIMLESS/HANDSHAKE_REQUEST", n.HANDSHAKE_REPLY = "RIMLESS/HANDSHAKE_REPLY", n.RPC_REQUEST = "RIMLESS/RPC_REQUEST", n.RPC_RESOLVE = "RIMLESS/RPC_RESOLVE", n.RPC_REJECT = "RIMLESS/RPC_REJECT", n))(u || {});
+const w = Symbol();
+function O(n = {}, r, o, e, s) {
+  const t = [];
+  for (const [c, f] of Object.entries(n)) {
+    async function a(i) {
+      const E = P(i), { action: m, callID: R, connectionID: l, callName: d, args: p = [] } = E;
+      if (m !== u.RPC_REQUEST || !R || !d || d !== c || l !== r) return;
       const S = {
-        action: a.RPC_RESOLVE,
-        callID: d,
-        callName: h,
-        connectionID: p,
+        action: u.RPC_RESOLVE,
+        callID: R,
+        callName: d,
+        connectionID: l,
         error: null,
         result: null
       };
+      let A;
       try {
-        const u = await W(n, c)(...g);
-        u ? S.result = JSON.parse(JSON.stringify(u)) : S.result = u;
-      } catch (u) {
-        S.action = a.RPC_REJECT, S.error = JSON.parse(JSON.stringify(u, Object.getOwnPropertyNames(u)));
+        S.result = await f(...p, s), S.result && S.result[w] && (A = S.result[w] ?? [], delete S.result[w]);
+      } catch (I) {
+        S.action = u.RPC_REJECT, S.error = JSON.parse(JSON.stringify(I, Object.getOwnPropertyNames(I)));
       }
-      N(i, S, f == null ? void 0 : f.origin);
+      g(e, S, i?.origin, A);
     }
-    m(e, R.MESSAGE, l), o.push(() => D(e, R.MESSAGE, l));
-  }), () => o.forEach((c) => c());
+    L(o, h.MESSAGE, a), t.push(() => N(o, h.MESSAGE, a));
+  }
+  return () => t.forEach((c) => c());
 }
-function Y(n, r, t, e = [], i, o) {
-  return (...c) => new Promise((l, f) => {
-    const s = T();
-    function E(p) {
-      const h = M(p), { callID: g, connectionID: S, callName: u, result: P, error: C, action: O } = h;
-      if (!(!g || !u) && u === n && g === s && S === r) {
-        if (O === a.RPC_RESOLVE) return l(P);
-        if (O === a.RPC_REJECT) return f(C);
+function J(n, r, o, e = [], s, t) {
+  return (...c) => new Promise((f, a) => {
+    const i = C();
+    function E(l) {
+      const d = P(l), { callID: p, connectionID: S, callName: A, result: I, error: G, action: T } = d;
+      if (!(!p || !A) && A === n && p === i && S === r) {
+        if (T === u.RPC_RESOLVE) return f(I);
+        if (T === u.RPC_REJECT) return a(G);
       }
     }
-    const d = {
-      action: a.RPC_REQUEST,
-      args: JSON.parse(JSON.stringify(c)),
-      callID: s,
+    const m = {
+      action: u.RPC_REQUEST,
+      args: c,
+      callID: i,
       callName: n,
       connectionID: r
-    };
-    m(i, R.MESSAGE, E), e.push(() => D(i, R.MESSAGE, E)), N(o, d, t == null ? void 0 : t.origin);
+    }, R = c.reduce(
+      (l, d) => d[w]?.length ? l.concat(d[w]) : l,
+      // @ts-expect-error: we know this is an array of transferables (if it exists)
+      c[w] ?? []
+    );
+    L(s, h.MESSAGE, E), e.push(() => N(s, h.MESSAGE, E)), g(t, m, o?.origin, R);
   });
 }
-function k(n = {}, r = [], t, e, i, o) {
-  const c = { ...n }, l = [];
-  return r.forEach((f) => {
-    const s = Y(f, t, e, l, i, o);
-    Q(c, f, s);
-  }), {
+function v(n = {}, r = [], o, e, s, t) {
+  const c = { ...n }, f = [];
+  for (const a of r) {
+    const i = J(a, o, e, f, s, t);
+    Y(c, a, i);
+  }
+  return {
     remote: c,
-    unregisterRemote: () => l.forEach((f) => f())
+    unregisterRemote: () => f.forEach((a) => a())
   };
 }
+const F = (n) => {
+  const r = [], e = n((s) => (r.push(s), s));
+  return Object.assign(e, { [w]: r });
+};
 function V(n = {}, r) {
-  return new Promise(async (t) => {
-    const e = _(n), i = $(), o = self || window;
-    async function c(f) {
-      var u;
-      const s = M(f);
-      if ((s == null ? void 0 : s.action) !== a.HANDSHAKE_REPLY) return;
-      const E = J(n, e, s.connectionID, o, i), { remote: d, unregisterRemote: p } = k(
-        s.schema,
-        s.methods,
-        s.connectionID,
-        f,
-        o,
-        i
-      );
-      await ((u = r == null ? void 0 : r.onConnectionSetup) == null ? void 0 : u.call(r, d));
-      const h = {
-        action: a.HANDSHAKE_REPLY,
-        connectionID: s.connectionID
+  return new Promise(async (o) => {
+    const e = k(n), s = $(), t = self || window;
+    async function c(a) {
+      const i = P(a);
+      if (i?.action !== u.HANDSHAKE_REPLY) return;
+      const { remote: E, unregisterRemote: m } = v(
+        i.schema,
+        i.methodNames,
+        i.connectionID,
+        a,
+        t,
+        s
+      ), R = O(e, i.connectionID, t, s, E);
+      await r?.onConnectionSetup?.(E);
+      const l = {
+        action: u.HANDSHAKE_REPLY,
+        connectionID: i.connectionID
       };
-      N(i, h, f == null ? void 0 : f.origin);
-      const S = { remote: d, close: () => {
-        self.removeEventListener(R.MESSAGE, c), p(), E();
-      }, id: s.connectionID };
-      return t(S);
+      g(s, l, a?.origin);
+      const p = { remote: E, close: () => {
+        N(t, h.MESSAGE, c), m(), R();
+      }, id: i.connectionID };
+      return o(p);
     }
-    self.addEventListener(R.MESSAGE, c);
-    const l = {
-      action: a.HANDSHAKE_REQUEST,
-      methods: e,
-      schema: JSON.parse(JSON.stringify(n))
+    L(t, h.MESSAGE, c);
+    const f = {
+      action: u.HANDSHAKE_REQUEST,
+      methodNames: Object.keys(e),
+      schema: n
     };
-    N(i, l);
+    g(s, f);
   });
 }
-const F = {
+const B = {
   connect: V
-}, A = {};
-function q(n, r) {
-  if (L(n) || typeof Worker < "u" && n instanceof Worker)
+}, M = {};
+function b(n, r) {
+  if (H(n) || typeof Worker < "u" && n instanceof Worker)
     return !0;
-  const t = n;
+  const o = n;
   try {
-    const e = t.src, i = U(e), o = r.origin === i, c = r.source === t.contentWindow;
-    return o && c || !e;
+    const e = o.src, s = typeof o.srcdoc == "string" && o.srcdoc.length > 0, t = Q(e), c = r.origin === t, f = r.source === o.contentWindow;
+    return s || e === "about:blank" ? f : c && f || !e;
   } catch (e) {
     return console.warn("Error checking iframe target:", e), !1;
   }
 }
-function B(n, r = {}) {
+function q(n, r = {}) {
   if (!n) throw new Error("a target is required");
-  const t = x(n), e = t || y() ? n : window;
-  return new Promise((i) => {
-    const o = T();
-    function c(f) {
-      const s = t || y() ? n : f.source;
-      if (!t && !y() && !q(n, f)) return;
-      const E = M(f);
-      if ((E == null ? void 0 : E.action) !== a.HANDSHAKE_REQUEST || A[o]) return;
-      const d = _(r), p = J(r, d, o, e, s), { remote: h, unregisterRemote: g } = k(
+  const o = x(n), e = o || D() ? n : window;
+  return new Promise((s) => {
+    const t = C();
+    function c(a) {
+      const i = o || D() ? n : a.source;
+      if (!o && !D() && !b(n, a)) return;
+      const E = P(a);
+      if (E?.action !== u.HANDSHAKE_REQUEST || M[t]) return;
+      const m = k(r), { remote: R, unregisterRemote: l } = v(
         E.schema,
-        E.methods,
-        o,
-        f,
+        E.methodNames,
+        t,
+        a,
         e,
-        s
-      ), S = {
-        action: a.HANDSHAKE_REPLY,
-        connectionID: o,
+        i
+      ), d = O(m, t, e, i, R), p = {
+        action: u.HANDSHAKE_REPLY,
+        connectionID: t,
         schema: r,
-        methods: d
+        methodNames: Object.keys(m)
       };
-      N(s, S, f.origin);
-      const P = { remote: h, close: () => {
-        delete A[o], D(e, R.MESSAGE, c), g(), p(), t && n.terminate();
-      }, id: o };
-      A[o] = P;
+      g(i, p, a.origin);
+      const A = { remote: R, close: () => {
+        delete M[t], N(e, h.MESSAGE, c), N(e, h.MESSAGE, f), l(), d(), o && n.terminate();
+      }, id: t };
+      M[t] = A;
     }
-    m(e, R.MESSAGE, c);
-    function l(f) {
-      const s = M(f);
-      if ((s == null ? void 0 : s.action) === a.HANDSHAKE_REPLY && o === s.connectionID) {
-        if (!A[s.connectionID])
+    L(e, h.MESSAGE, c);
+    function f(a) {
+      const i = P(a);
+      if (i?.action === u.HANDSHAKE_REPLY && t === i.connectionID) {
+        if (!M[i.connectionID])
           throw new Error("Rimless Error: No connection found for this connectionID");
-        return i(A[s.connectionID]);
+        return s(M[i.connectionID]);
       }
     }
-    m(e, R.MESSAGE, l);
+    L(e, h.MESSAGE, f);
   });
 }
 const z = {
-  connect: B
+  connect: q
 };
 export {
-  a as actions,
-  R as events,
-  F as guest,
-  z as host
+  u as actions,
+  h as events,
+  B as guest,
+  z as host,
+  F as withTransferable
 };
 //# sourceMappingURL=rimless.js.map

package/lib/rimless.js.map

@@ -1 +1 @@
-{"version":3,"file":"rimless.js","sources":["../src/helpers.ts","../src/types.ts","../src/rpc.ts","../src/guest.ts","../src/host.ts"],"sourcesContent":["import { Guest, NodeWorker, Target, WorkerLike } from \"./types\";\n\n/**\n * check if run in a webworker\n *\n * @returns boolean\n */\nexport function isWorker(): boolean {\n  return typeof window === \"undefined\" && typeof self !== \"undefined\";\n}\n\n/**\n * check if run in a Node.js environment\n *\n * @returns boolean\n */\nexport function isNodeEnv(): boolean {\n  return typeof process !== \"undefined\" && !!(process as any).versions?.node;\n}\n\n/**\n * check if run in an iframe\n *\n * @returns boolean\n */\nexport function isIframe() {\n  return window.self !== window.top;\n}\n\n/**\n * we cannot send functions through postMessage\n * extract the path to all functions in the schema\n *\n * @param obj\n */\nexport function extractMethods(obj: any) {\n  const paths: string[] = [];\n  (function parse(obj: any, path = \"\") {\n    Object.keys(obj).forEach((prop) => {\n      const propPath = path ? `${path}.${prop}` : prop;\n      if (obj[prop] === Object(obj[prop])) {\n        parse(obj[prop], propPath);\n      }\n      if (typeof obj[prop] === \"function\") {\n        paths.push(propPath);\n      }\n    });\n  })(obj);\n  return paths;\n}\n\nconst urlRegex = /^(https?:|file:)?\\/\\/([^/:]+)?(:(\\d+))?/;\nconst ports: any = { \"http:\": \"80\", \"https:\": \"443\" };\n\n/**\n * convert the url into an origin (remove paths)\n *\n * @param url\n */\nexport function getOriginFromURL(url: string | null) {\n  if (!url) return null;\n\n  const regexResult = urlRegex.exec(url);\n  if (!regexResult) return null;\n\n  const [, protocol = \"http:\", hostname, , port] = regexResult;\n\n  // If the protocol is file, return file://\n  if (protocol === \"file:\") {\n    return \"file://\";\n  }\n\n  // If the port is the default for the protocol, we don't want to add it to the origin string\n  const portSuffix = port && port !== ports[protocol] ? `:${port}` : \"\";\n  return `${protocol}//${hostname}${portSuffix}`;\n}\n\nexport function get(obj: any, path: string | Array<string | number>, defaultValue?: any): any {\n  const keys = Array.isArray(path) ? path : path.split(\".\").filter(Boolean);\n  let result = obj;\n\n  for (const key of keys) {\n    result = result?.[key];\n    if (result === undefined) {\n      return defaultValue;\n    }\n  }\n\n  return result;\n}\n\nexport function set(obj: any, path: string | (string | number)[], value: any): any {\n  if (!obj || typeof obj !== \"object\") return obj;\n\n  const pathArray = Array.isArray(path) ? path : path.split(\".\").map((key) => (key.match(/^\\d+$/) ? Number(key) : key));\n\n  let current = obj;\n\n  for (let i = 0; i < pathArray.length; i++) {\n    const key = pathArray[i];\n\n    if (i === pathArray.length - 1) {\n      current[key] = value;\n    } else {\n      if (!current[key] || typeof current[key] !== \"object\") {\n        current[key] = typeof pathArray[i + 1] === \"number\" ? [] : {};\n      }\n      current = current[key];\n    }\n  }\n\n  return obj;\n}\n\nexport function generateId(length: number = 10): string {\n  const chars = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\n  let result = \"\";\n  for (let i = 0; i < length; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n\nlet parentPort: any = null;\n\nif (isNodeEnv()) {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const workerThreads = require(\"worker_threads\");\n    parentPort = workerThreads.parentPort;\n  } catch (e) {\n    // Not in worker thread context\n  }\n}\n\n/**\n * Get the appropriate target host for messaging based on the current environment\n * @returns The messaging target for the current environment\n */\nexport function getTargetHost(): any {\n  if (isNodeEnv()) {\n    return parentPort;\n  }\n\n  if (isWorker()) {\n    return self;\n  }\n\n  if (isIframe()) {\n    return window.parent;\n  }\n\n  throw new Error(\"No valid target found for postMessage\");\n}\n\n/**\n * Send a message to a target, handling different environments (iframe, web worker, node worker)\n * @param target The target to send the message to\n * @param message The message to send\n * @param origin Optional origin for iframe communication\n */\nexport function postMessageToTarget(target: Target, message: any, origin?: string): void {\n  if (!target) {\n    throw new Error(\"Rimless Error: No target specified for postMessage\");\n  }\n\n  // Node.js Worker\n  if (isNodeEnv() && target === parentPort) {\n    target.postMessage(JSON.parse(JSON.stringify(message)));\n    return;\n  }\n\n  // Web Worker\n  if (isWorker()) {\n    target.postMessage(JSON.parse(JSON.stringify(message)));\n    return;\n  }\n\n  // iframe or window\n  if (target.postMessage) {\n    target.postMessage(JSON.parse(JSON.stringify(message)), { targetOrigin: origin || \"*\" });\n    return;\n  }\n\n  throw new Error(\"Rimless Error: Invalid target for postMessage\");\n}\n\nexport function isNodeWorker(guest: Guest | Target): guest is NodeWorker {\n  return parentPort !== null && guest === parentPort;\n}\n\nexport function isWorkerLike(guest: Guest): guest is WorkerLike {\n  return isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker);\n}\n\nexport function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n  if (isNodeWorker(target)) {\n    target.on(event, handler);\n  } else if (\"addEventListener\" in target) {\n    target.addEventListener(event, handler);\n  }\n}\n\nexport function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n  if (isNodeWorker(target)) {\n    target.off(event, handler);\n  } else if (\"removeEventListener\" in target) {\n    target.removeEventListener(event, handler);\n  }\n}\n\n/**\n * Normalize message event data across Web and Node.js environments\n * In web, data is in event.data\n * In Node.js, the event itself contains the data\n */\nexport function getEventData(event: any) {\n  return event.data || event;\n}\n","export interface NodeWorker {\n  on(event: string, handler: any): void;\n  off(event: string, handler: any): void;\n  postMessage(message: any): void;\n  terminate(): void;\n}\n\nexport type WorkerLike = Worker | NodeWorker;\n\nexport enum events {\n  MESSAGE = \"message\",\n}\n\nexport enum actions {\n  HANDSHAKE_REQUEST = \"RIMLESS/HANDSHAKE_REQUEST\",\n  HANDSHAKE_REPLY = \"RIMLESS/HANDSHAKE_REPLY\",\n  RPC_REQUEST = \"RIMLESS/RPC_REQUEST\",\n  RPC_RESOLVE = \"RIMLESS/RPC_RESOLVE\",\n  RPC_REJECT = \"RIMLESS/RPC_REJECT\",\n}\n\nexport type Schema = Record<string, any>;\n\nexport interface Connection {\n  id: string;\n  remote: Schema;\n  close: () => void;\n}\n\nexport type Connections = Record<string, Connection>;\n\nexport interface RimlessEvent extends EventListener {\n  source?: Window;\n  origin?: string;\n  data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;\n}\n\nexport interface HandshakeRequestPayload {\n  action: actions.HANDSHAKE_REQUEST;\n  connectionID: string;\n  methods: string[];\n  schema: Schema;\n}\n\nexport interface HandshakeConfirmationPayload {\n  action: actions.HANDSHAKE_REPLY;\n  connectionID: string;\n  methods: string[];\n  schema: Schema;\n}\n\nexport interface RPCRequestPayload {\n  action: actions.RPC_REQUEST;\n  args: any[];\n  callID: string;\n  callName: string;\n  connectionID: string;\n}\n\nexport interface RPCResolvePayload {\n  action: actions.RPC_RESOLVE | actions.RPC_REJECT;\n  result?: any | null;\n  error?: Error | null;\n  callID: string;\n  callName: string;\n  connectionID: string;\n}\n\nexport interface EventHandlers {\n  onConnectionSetup: (remote: Schema) => Promise<void>;\n}\n\nexport type Guest = WorkerLike | HTMLIFrameElement;\nexport type Target = Window | WorkerLike;\nexport type Environment = Window | WorkerLike;\n","import {\n  addEventListener,\n  generateId,\n  get,\n  getEventData,\n  postMessageToTarget,\n  removeEventListener,\n  set,\n} from \"./helpers\";\nimport {\n  actions,\n  Environment,\n  events,\n  RimlessEvent,\n  RPCRequestPayload,\n  RPCResolvePayload,\n  Schema,\n  Target,\n} from \"./types\";\n\n/**\n * for each function in the schema\n * 1. subscribe to an event that the remote can call\n * 2. listen for calls from the remote. When called execute the function and emit the results.\n *\n * @param methods an array of method ids from the local schema\n * @param rpcConnectionID\n * @return a function to cancel all subscriptions\n */\nexport function registerLocalMethods(\n  schema: Schema = {},\n  methods: string[] = [],\n  rpcConnectionID: string,\n  listenTo: Environment,\n  sendTo: Target,\n) {\n  const listeners: any[] = [];\n\n  methods.forEach((methodName) => {\n    // handle a remote calling a local method\n    async function handleCall(event: any) {\n      const eventData = getEventData(event);\n      const { action, callID, connectionID, callName, args = [] } = eventData as RPCRequestPayload;\n\n      if (action !== actions.RPC_REQUEST) return;\n      if (!callID || !callName) return;\n      if (callName !== methodName) return;\n      if (connectionID !== rpcConnectionID) return;\n\n      const payload: RPCResolvePayload = {\n        action: actions.RPC_RESOLVE,\n        callID,\n        callName,\n        connectionID,\n        error: null,\n        result: null,\n      };\n\n      // run function and return the results to the remote\n      try {\n        const result = await get(schema, methodName)(...args);\n\n        if (!result) {\n          // if the result is falsy (null, undefined, \"\", etc), set it directly\n          payload.result = result;\n        } else {\n          // otherwise parse a stringified version of it\n          payload.result = JSON.parse(JSON.stringify(result));\n        }\n      } catch (error) {\n        payload.action = actions.RPC_REJECT;\n        payload.error = JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)));\n      }\n\n      postMessageToTarget(sendTo, payload, event?.origin);\n    }\n\n    // subscribe to the call event\n    addEventListener(listenTo, events.MESSAGE, handleCall);\n    listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleCall));\n  });\n\n  return () => listeners.forEach((unregister) => unregister());\n}\n\n/**\n * Create a function that will make an RPC request to the remote with some arguments.\n * Listen to an event that returns the results from the remote.\n *\n * @param rpcCallName\n * @param rpcConnectionID\n * @param event\n * @param listeners\n * @param guest\n *\n * @returns a promise with the result of the RPC\n */\nexport function createRPC(\n  rpcCallName: string,\n  rpcConnectionID: string,\n  event: RimlessEvent,\n  listeners: Array<() => void> = [],\n  listenTo: Environment,\n  sendTo: Target,\n) {\n  return (...args: any) => {\n    return new Promise((resolve, reject) => {\n      const requestID = generateId();\n\n      // on RPC response\n      function handleResponse(event: any) {\n        const eventData = getEventData(event);\n        const { callID, connectionID, callName, result, error, action } = eventData as RPCResolvePayload;\n\n        if (!callID || !callName) return;\n        if (callName !== rpcCallName) return;\n        if (callID !== requestID) return;\n        if (connectionID !== rpcConnectionID) return;\n\n        // resolve the response\n        if (action === actions.RPC_RESOLVE) return resolve(result);\n        if (action === actions.RPC_REJECT) return reject(error);\n      }\n\n      // send the RPC request with arguments\n      const payload = {\n        action: actions.RPC_REQUEST,\n        args: JSON.parse(JSON.stringify(args)),\n        callID: requestID,\n        callName: rpcCallName,\n        connectionID: rpcConnectionID,\n      };\n\n      addEventListener(listenTo, events.MESSAGE, handleResponse);\n      listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleResponse));\n\n      postMessageToTarget(sendTo, payload, event?.origin);\n    });\n  };\n}\n\n/**\n * create an object based on the remote schema and methods. Functions in that object will\n * emit an event that will trigger the RPC on the remote.\n *\n * @param schema\n * @param methods\n * @param connectionID\n * @param event\n * @param guest\n */\nexport function registerRemoteMethods(\n  schema: Schema = {},\n  methods: string[] = [],\n  connectionID: string,\n  event: RimlessEvent,\n  listenTo: Environment,\n  sendTo: Target,\n) {\n  const remote = { ...schema };\n  const listeners: Array<() => void> = [];\n\n  methods.forEach((methodName) => {\n    const rpc = createRPC(methodName, connectionID, event, listeners, listenTo, sendTo);\n    set(remote, methodName, rpc);\n  });\n\n  return {\n    remote,\n    unregisterRemote: () => listeners.forEach((unregister) => unregister()),\n  };\n}\n","import { extractMethods, getEventData, getTargetHost, postMessageToTarget } from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, EventHandlers, events, Connection, Schema } from \"./types\";\n\nfunction connect(schema: Schema = {}, eventHandlers?: EventHandlers): Promise<Connection> {\n  return new Promise(async (resolve) => {\n    const localMethods = extractMethods(schema);\n    const sendTo = getTargetHost();\n    const listenTo = self || window;\n\n    // on handshake response\n    async function handleHandshakeResponse(event: any) {\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n\n      // register local methods\n      const unregisterLocal = registerLocalMethods(schema, localMethods, eventData.connectionID, listenTo, sendTo);\n\n      // register remote methods\n      const { remote, unregisterRemote } = registerRemoteMethods(\n        eventData.schema,\n        eventData.methods,\n        eventData.connectionID,\n        event,\n        listenTo,\n        sendTo,\n      );\n\n      await eventHandlers?.onConnectionSetup?.(remote);\n\n      // send a HANDSHAKE REPLY to the host\n      const payload = {\n        action: actions.HANDSHAKE_REPLY,\n        connectionID: eventData.connectionID,\n      };\n\n      postMessageToTarget(sendTo, payload, event?.origin);\n\n      // close the connection and all listeners when called\n      const close = () => {\n        self.removeEventListener(events.MESSAGE, handleHandshakeResponse);\n        unregisterRemote();\n        unregisterLocal();\n      };\n\n      // resolve connection object\n      const connection = { remote, close, id: eventData.connectionID };\n      return resolve(connection);\n    }\n\n    // subscribe to HANDSHAKE RESPONSE MESSAGES\n    self.addEventListener(events.MESSAGE, handleHandshakeResponse);\n\n    const payload = {\n      action: actions.HANDSHAKE_REQUEST,\n      methods: localMethods,\n      schema: JSON.parse(JSON.stringify(schema)),\n    };\n\n    postMessageToTarget(sendTo, payload);\n  });\n}\n\nexport default {\n  connect,\n};\n","import {\n  addEventListener,\n  extractMethods,\n  generateId,\n  getEventData,\n  getOriginFromURL,\n  isNodeEnv,\n  isNodeWorker,\n  isWorkerLike,\n  postMessageToTarget,\n  removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, events, Guest, Connection, Connections, Schema } from \"./types\";\n\nconst connections: Connections = {};\n\nfunction isValidTarget(guest: Guest, event: any) {\n  // If it's a worker, we don't need to validate origin\n  if (isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker)) {\n    return true;\n  }\n\n  // For iframes, check origin and source\n  const iframe = guest as HTMLIFrameElement;\n  try {\n    const childURL = iframe.src;\n    const childOrigin = getOriginFromURL(childURL);\n    const hasProperOrigin = event.origin === childOrigin;\n    const hasProperSource = event.source === iframe.contentWindow;\n\n    return (hasProperOrigin && hasProperSource) || !childURL;\n  } catch (e) {\n    console.warn(\"Error checking iframe target:\", e);\n    return false;\n  }\n}\n\n/**\n * Perform a handshake with the target iframe, when the handshake is confirmed\n * resolve the connection object containing RPCs and properties\n *\n * @param iframe\n * @param schema\n * @returns Promise\n */\nfunction connect(guest: Guest, schema: Schema = {}): Promise<Connection> {\n  if (!guest) throw new Error(\"a target is required\");\n\n  const guestIsWorker = isWorkerLike(guest);\n\n  const listenTo = guestIsWorker || isNodeEnv() ? (guest as Worker) : window;\n\n  return new Promise((resolve) => {\n    const connectionID = generateId();\n\n    // on handshake request\n    function handleHandshake(event: any) {\n      const sendTo = guestIsWorker || isNodeEnv() ? (guest as Worker) : event.source;\n\n      if (!guestIsWorker && !isNodeEnv() && !isValidTarget(guest, event)) return;\n\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REQUEST) return;\n      if (connections[connectionID]) return;\n\n      // register local methods\n      const localMethods = extractMethods(schema);\n      const unregisterLocal = registerLocalMethods(schema, localMethods, connectionID, listenTo, sendTo);\n\n      // register remote methods\n      const { remote, unregisterRemote } = registerRemoteMethods(\n        eventData.schema,\n        eventData.methods,\n        connectionID,\n        event,\n        listenTo,\n        sendTo,\n      );\n\n      // send a HANDSHAKE REPLY to the guest\n      const payload = {\n        action: actions.HANDSHAKE_REPLY,\n        connectionID,\n        schema,\n        methods: localMethods,\n      };\n\n      postMessageToTarget(sendTo, payload, event.origin);\n\n      // close the connection and all listeners when called\n      const close = () => {\n        delete connections[connectionID];\n        removeEventListener(listenTo, events.MESSAGE, handleHandshake);\n        unregisterRemote();\n        unregisterLocal();\n        if (guestIsWorker) {\n          (guest as Worker).terminate();\n        }\n      };\n\n      const connection: Connection = { remote, close, id: connectionID };\n      connections[connectionID] = connection;\n    }\n\n    // subscribe to HANDSHAKE MESSAGES\n    addEventListener(listenTo, events.MESSAGE, handleHandshake);\n\n    // on handshake reply\n    function handleHandshakeReply(event: any) {\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n      if (connectionID !== eventData.connectionID) return;\n\n      if (!connections[eventData.connectionID]) {\n        throw new Error(\"Rimless Error: No connection found for this connectionID\");\n      }\n\n      return resolve(connections[eventData.connectionID]);\n    }\n\n    addEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n  });\n}\n\nexport default {\n  connect,\n};\n"],"names":["isWorker","isNodeEnv","_a","isIframe","extractMethods","obj","paths","parse","path","prop","propPath","urlRegex","ports","getOriginFromURL","url","regexResult","protocol","hostname","port","portSuffix","get","defaultValue","keys","result","key","set","value","pathArray","current","i","generateId","length","chars","parentPort","getTargetHost","postMessageToTarget","target","message","origin","isNodeWorker","guest","isWorkerLike","addEventListener","event","handler","removeEventListener","getEventData","events","actions","registerLocalMethods","schema","methods","rpcConnectionID","listenTo","sendTo","listeners","methodName","handleCall","eventData","action","callID","connectionID","callName","args","payload","error","unregister","createRPC","rpcCallName","resolve","reject","requestID","handleResponse","registerRemoteMethods","remote","rpc","connect","eventHandlers","localMethods","handleHandshakeResponse","unregisterLocal","unregisterRemote","connection","connections","isValidTarget","iframe","childURL","childOrigin","hasProperOrigin","hasProperSource","guestIsWorker","handleHandshake","handleHandshakeReply","host"],"mappings":"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"}
+{"version":3,"file":"rimless.js","sources":["../src/helpers.ts","../src/types.ts","../src/rpc.ts","../src/guest.ts","../src/host.ts"],"sourcesContent":["import { Guest, NodeWorker, Target, WorkerLike } from \"./types\";\n\n/**\n * check if run in a webworker\n *\n * @returns boolean\n */\nexport function isWorker(): boolean {\n  return typeof window === \"undefined\" && typeof self !== \"undefined\";\n}\n\n/**\n * check if run in a Node.js environment\n *\n * @returns boolean\n */\nexport function isNodeEnv(): boolean {\n  return typeof process !== \"undefined\" && !!(process as any).versions?.node;\n}\n\n/**\n * check if run in an iframe\n *\n * @returns boolean\n */\nexport function isIframe() {\n  return window.self !== window.top;\n}\n\n/**\n * we cannot send functions through postMessage\n * extract the path to all functions in the schema\n *\n * @param obj\n */\nexport function extractMethods(obj: any) {\n  const methods: Record<string, (...args: any) => any> = {};\n  (function parse(obj: any, path = \"\") {\n    Object.keys(obj).forEach((prop) => {\n      const propPath = path ? `${path}.${prop}` : prop;\n      if (obj[prop] === Object(obj[prop])) {\n        parse(obj[prop], propPath);\n      }\n      if (typeof obj[prop] === \"function\") {\n        methods[propPath] = obj[prop];\n        delete obj[prop];\n      }\n    });\n  })(obj);\n  return methods;\n}\n\nconst urlRegex = /^(https?:|file:)?\\/\\/([^/:]+)?(:(\\d+))?/;\nconst ports: any = { \"http:\": \"80\", \"https:\": \"443\" };\n\n/**\n * convert the url into an origin (remove paths)\n *\n * @param url\n */\nexport function getOriginFromURL(url: string | null) {\n  if (!url) return null;\n\n  const regexResult = urlRegex.exec(url);\n  if (!regexResult) return null;\n\n  const [, protocol = \"http:\", hostname, , port] = regexResult;\n\n  // If the protocol is file, return file://\n  if (protocol === \"file:\") {\n    return \"file://\";\n  }\n\n  // If the port is the default for the protocol, we don't want to add it to the origin string\n  const portSuffix = port && port !== ports[protocol] ? `:${port}` : \"\";\n  return `${protocol}//${hostname}${portSuffix}`;\n}\n\nexport function get(obj: any, path: string | Array<string | number>, defaultValue?: any): any {\n  const keys = Array.isArray(path) ? path : path.split(\".\").filter(Boolean);\n  let result = obj;\n\n  for (const key of keys) {\n    result = result?.[key];\n    if (result === undefined) {\n      return defaultValue;\n    }\n  }\n\n  return result;\n}\n\nexport function set(obj: any, path: string | (string | number)[], value: any): any {\n  if (!obj || typeof obj !== \"object\") return obj;\n\n  const pathArray = Array.isArray(path) ? path : path.split(\".\").map((key) => (key.match(/^\\d+$/) ? Number(key) : key));\n\n  let current = obj;\n\n  for (let i = 0; i < pathArray.length; i++) {\n    const key = pathArray[i];\n\n    if (i === pathArray.length - 1) {\n      current[key] = value;\n    } else {\n      if (!current[key] || typeof current[key] !== \"object\") {\n        current[key] = typeof pathArray[i + 1] === \"number\" ? [] : {};\n      }\n      current = current[key];\n    }\n  }\n\n  return obj;\n}\n\nexport function generateId(length: number = 10): string {\n  const chars = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\n  let result = \"\";\n  for (let i = 0; i < length; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n\nlet parentPort: any = null;\n\nif (isNodeEnv()) {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const workerThreads = require(\"worker_threads\");\n    parentPort = workerThreads.parentPort;\n  } catch (e) {\n    // Not in worker thread context\n  }\n}\n\n/**\n * Get the appropriate target host for messaging based on the current environment\n * @returns The messaging target for the current environment\n */\nexport function getTargetHost(): any {\n  if (isNodeEnv()) {\n    return parentPort;\n  }\n\n  if (isWorker()) {\n    return self;\n  }\n\n  if (isIframe()) {\n    return window.parent;\n  }\n\n  throw new Error(\"No valid target found for postMessage\");\n}\n\n/**\n * Send a message to a target, handling different environments (iframe, web worker, node worker)\n * @param target The target to send the message to\n * @param message The message to send\n * @param origin Optional origin for iframe communication\n * @param transferables Optional transferables for postMessage\n */\nexport function postMessageToTarget(\n  target: Target,\n  message: any,\n  origin?: string,\n  transferables?: Transferable[],\n): void {\n  if (!target) {\n    throw new Error(\"Rimless Error: No target specified for postMessage\");\n  }\n\n  // Node.js Worker\n  if (isNodeEnv() && target === parentPort) {\n    target.postMessage(message, { transfer: transferables });\n    return;\n  }\n\n  // Web Worker\n  if (isWorker()) {\n    target.postMessage(message, { transfer: transferables });\n    return;\n  }\n\n  // iframe or window\n  if (target.postMessage) {\n    target.postMessage(message, { targetOrigin: origin || \"*\", transfer: transferables });\n    return;\n  }\n\n  throw new Error(\"Rimless Error: Invalid target for postMessage\");\n}\n\nexport function isNodeWorker(guest: Guest | Target): guest is NodeWorker {\n  return parentPort !== null && guest === parentPort;\n}\n\nexport function isWorkerLike(guest: Guest): guest is WorkerLike {\n  return isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker);\n}\n\nexport function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n  if (isNodeWorker(target)) {\n    target.on(event, handler);\n  } else if (\"addEventListener\" in target) {\n    target.addEventListener(event, handler);\n  }\n}\n\nexport function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n  if (isNodeWorker(target)) {\n    target.off(event, handler);\n  } else if (\"removeEventListener\" in target) {\n    target.removeEventListener(event, handler);\n  }\n}\n\n/**\n * Normalize message event data across Web and Node.js environments\n * In web, data is in event.data\n * In Node.js, the event itself contains the data\n */\nexport function getEventData(event: any) {\n  return event.data || event;\n}\n","export interface NodeWorker {\n  on(event: string, handler: any): void;\n  off(event: string, handler: any): void;\n  postMessage(message: any): void;\n  terminate(): void;\n}\n\nexport type WorkerLike = Worker | NodeWorker;\n\nexport enum events {\n  MESSAGE = \"message\",\n}\n\nexport enum actions {\n  HANDSHAKE_REQUEST = \"RIMLESS/HANDSHAKE_REQUEST\",\n  HANDSHAKE_REPLY = \"RIMLESS/HANDSHAKE_REPLY\",\n  RPC_REQUEST = \"RIMLESS/RPC_REQUEST\",\n  RPC_RESOLVE = \"RIMLESS/RPC_RESOLVE\",\n  RPC_REJECT = \"RIMLESS/RPC_REJECT\",\n}\n\nexport type Schema = Record<string, any>;\n\nexport interface Connection {\n  id: string;\n  remote: Schema;\n  close: () => void;\n}\n\nexport type Connections = Record<string, Connection>;\n\nexport interface RimlessEvent extends EventListener {\n  source?: Window;\n  origin?: string;\n  data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;\n}\n\nexport interface HandshakeRequestPayload {\n  action: actions.HANDSHAKE_REQUEST;\n  connectionID: string;\n  methodNames: string[];\n  schema: Schema;\n}\n\nexport interface HandshakeConfirmationPayload {\n  action: actions.HANDSHAKE_REPLY;\n  connectionID: string;\n  methodNames: string[];\n  schema: Schema;\n}\n\nexport interface RPCRequestPayload {\n  action: actions.RPC_REQUEST;\n  args: any[];\n  callID: string;\n  callName: string;\n  connectionID: string;\n}\n\nexport interface RPCResolvePayload {\n  action: actions.RPC_RESOLVE | actions.RPC_REJECT;\n  result?: any | null;\n  error?: Error | null;\n  callID: string;\n  callName: string;\n  connectionID: string;\n}\n\nexport interface EventHandlers {\n  onConnectionSetup: (remote: Schema) => Promise<void>;\n}\n\nexport type Guest = WorkerLike | HTMLIFrameElement;\nexport type Target = Window | WorkerLike;\nexport type Environment = Window | WorkerLike;\n","import { addEventListener, generateId, getEventData, postMessageToTarget, removeEventListener, set } from \"./helpers\";\nimport {\n  actions,\n  Environment,\n  events,\n  RimlessEvent,\n  RPCRequestPayload,\n  RPCResolvePayload,\n  Schema,\n  Target,\n} from \"./types\";\n\n/** Private symbol to which we will assign transferable objects */\nconst SYM_TRANSFERABLES = Symbol();\n\n/**\n * for each function in methods\n * 1. subscribe to an event that the remote can call\n * 2. listen for calls from the remote. When called execute the function and emit the results.\n *\n * @param methods an object of method ids : methods from the local schema\n * @param rpcConnectionID\n * @param listenTo Environment to listen for incoming messages\n * @param sendTo Target to send outgoing messages\n * @param remote The remote API object for the current connection\n * @return a function to cancel all subscriptions\n */\nexport function registerLocalMethods(\n  methods: Record<string, (...args: any[]) => any> = {},\n  rpcConnectionID: string,\n  listenTo: Environment,\n  sendTo: Target,\n  remote: Schema // Add remote parameter\n) {\n  const listeners: any[] = [];\n  for (const [methodName, method] of Object.entries(methods)) {\n    // handle a remote calling a local method\n    async function handleCall(event: any) {\n      const eventData = getEventData(event);\n      const { action, callID, connectionID, callName, args = [] } = eventData as RPCRequestPayload;\n\n      if (action !== actions.RPC_REQUEST) return;\n      if (!callID || !callName) return;\n      if (callName !== methodName) return;\n      if (connectionID !== rpcConnectionID) return;\n\n      const payload: RPCResolvePayload = {\n        action: actions.RPC_RESOLVE,\n        callID,\n        callName,\n        connectionID,\n        error: null,\n        result: null,\n      };\n\n      // when a host function returns transferable results to the remote, the\n      // transferables are assigned to a special symbol on each function's result\n      let transferables: Transferable[] | undefined = undefined;\n\n      // run function and return the results to the remote\n      try {\n        // Pass the remote object as the LAST argument to the local method\n        payload.result = await method(...args, remote);\n\n        if (payload.result && payload.result[SYM_TRANSFERABLES]) {\n          transferables = payload.result[SYM_TRANSFERABLES] ?? [];\n          delete payload.result[SYM_TRANSFERABLES];\n        }\n      } catch (error) {\n        payload.action = actions.RPC_REJECT;\n        payload.error = JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)));\n      }\n\n      postMessageToTarget(sendTo, payload, event?.origin, transferables);\n    }\n\n    // subscribe to the call event\n    addEventListener(listenTo, events.MESSAGE, handleCall);\n    listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleCall));\n  }\n\n  return () => listeners.forEach((unregister) => unregister());\n}\n\n/**\n * Create a function that will make an RPC request to the remote with some arguments.\n * Listen to an event that returns the results from the remote.\n *\n * @param rpcCallName\n * @param rpcConnectionID\n * @param event\n * @param listeners\n * @param guest\n *\n * @returns a promise with the result of the RPC\n */\nexport function createRPC(\n  rpcCallName: string,\n  rpcConnectionID: string,\n  event: RimlessEvent,\n  listeners: Array<() => void> = [],\n  listenTo: Environment,\n  sendTo: Target\n) {\n  return (...args: any[]) => {\n    return new Promise((resolve, reject) => {\n      const requestID = generateId();\n\n      // on RPC response\n      function handleResponse(event: any) {\n        const eventData = getEventData(event);\n        const { callID, connectionID, callName, result, error, action } = eventData as RPCResolvePayload;\n\n        if (!callID || !callName) return;\n        if (callName !== rpcCallName) return;\n        if (callID !== requestID) return;\n        if (connectionID !== rpcConnectionID) return;\n\n        // resolve the response\n        if (action === actions.RPC_RESOLVE) return resolve(result);\n        if (action === actions.RPC_REJECT) return reject(error);\n      }\n\n      // send the RPC request with arguments\n      const payload = {\n        action: actions.RPC_REQUEST,\n        args,\n        callID: requestID,\n        callName: rpcCallName,\n        connectionID: rpcConnectionID,\n      };\n\n      // if the arguments have transferables, post them as well\n      const transferables = args.reduce(\n        (transferables, arg) =>\n          arg[SYM_TRANSFERABLES]?.length ? transferables.concat(arg[SYM_TRANSFERABLES]) : transferables,\n        // @ts-expect-error: we know this is an array of transferables (if it exists)\n        args[SYM_TRANSFERABLES] ?? []\n      );\n\n      addEventListener(listenTo, events.MESSAGE, handleResponse);\n      listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleResponse));\n\n      postMessageToTarget(sendTo, payload, event?.origin, transferables);\n    });\n  };\n}\n\n/**\n * create an object based on the remote schema's methods. Functions in that object will\n * emit an event that will trigger the RPC on the remote.\n *\n * @param schema\n * @param methods\n * @param connectionID\n * @param event\n * @param guest\n */\nexport function registerRemoteMethods(\n  schema: Schema = {},\n  methodNames: Iterable<string> = [],\n  connectionID: string,\n  event: RimlessEvent,\n  listenTo: Environment,\n  sendTo: Target\n) {\n  const remote = { ...schema };\n  const listeners: Array<() => void> = [];\n\n  for (const methodName of methodNames) {\n    const rpc = createRPC(methodName, connectionID, event, listeners, listenTo, sendTo);\n    set(remote, methodName, rpc);\n  }\n\n  return {\n    remote,\n    unregisterRemote: () => listeners.forEach((unregister) => unregister()),\n  };\n}\n\n/**\n * This function is used by API schema declarations and remote function calls alike to\n * indicate which variables should be declared as transferable over `postMessage` calls.\n *\n * @param cb a function that takes a transfer function as an argument and returns an object\n *           (in the loose, `typeof foo === \"object\"` sense)\n * @return result the callback's return value, with an extra array of transferable objects\n *                assigned to rimless' private symbol `SYM_TRANSFERABLES`\n *\n * The `transfer(...)` function is called with an object to transfer; if there\n * are many objects to transfer, you may call it multiple times. It will always\n * return the input object. Calling `transfer` only modifies the callback\n * result, not the transferred object itself (or objects themselves).\n *\n * @example\n * host.connect({\n *   foo: (...args) => {\n *     const foo = new ArrayBuffer(8);\n *     return withTransferable((transfer) => transfer(foo));\n *   }),\n * });\n *\n * @example\n * host.remote.foo(withTransferable((transfer) => ({\n *   stream: transfer(new ReadableStream()),\n * })));\n */\nexport const withTransferable = <Transferable, Result extends object>(\n  cb: (transfer: <T extends Transferable>(transferable: T) => T) => Result\n) => {\n  const transferables: Transferable[] = [];\n  const transfer = <T extends Transferable>(transferable: T) => {\n    transferables.push(transferable);\n    return transferable;\n  };\n\n  const result = cb(transfer);\n\n  return Object.assign(result, { [SYM_TRANSFERABLES]: transferables });\n};\n","import {\n  extractMethods,\n  getEventData,\n  getTargetHost,\n  postMessageToTarget,\n  addEventListener,\n  removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, EventHandlers, events, Connection, Schema } from \"./types\";\n\nfunction connect(schema: Schema = {}, eventHandlers?: EventHandlers): Promise<Connection> {\n  return new Promise(async (resolve) => {\n    const localMethods = extractMethods(schema);\n    const sendTo = getTargetHost();\n    const listenTo = self || window;\n\n    // on handshake response\n    async function handleHandshakeResponse(event: any) {\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n\n      // register remote methods\n      const { remote, unregisterRemote } = registerRemoteMethods(\n        eventData.schema,\n        eventData.methodNames,\n        eventData.connectionID,\n        event,\n        listenTo,\n        sendTo,\n      );\n\n      // register local methods, passing the remote object\n      const unregisterLocal = registerLocalMethods(localMethods, eventData.connectionID, listenTo, sendTo, remote);\n\n      await eventHandlers?.onConnectionSetup?.(remote);\n\n      // send a HANDSHAKE REPLY to the host\n      const payload = {\n        action: actions.HANDSHAKE_REPLY,\n        connectionID: eventData.connectionID,\n      };\n\n      postMessageToTarget(sendTo, payload, event?.origin);\n\n      // close the connection and all listeners when called\n      const close = () => {\n        removeEventListener(listenTo, events.MESSAGE, handleHandshakeResponse);\n        unregisterRemote();\n        unregisterLocal();\n      };\n\n      // resolve connection object\n      const connection = { remote, close, id: eventData.connectionID };\n      return resolve(connection);\n    }\n\n    // subscribe to HANDSHAKE RESPONSE MESSAGES\n    addEventListener(listenTo, events.MESSAGE, handleHandshakeResponse);\n\n    const payload = {\n      action: actions.HANDSHAKE_REQUEST,\n      methodNames: Object.keys(localMethods),\n      schema: schema,\n    };\n\n    postMessageToTarget(sendTo, payload);\n  });\n}\n\nexport default {\n  connect,\n};\n","import {\n  addEventListener,\n  extractMethods,\n  generateId,\n  getEventData,\n  getOriginFromURL,\n  isNodeEnv,\n  isNodeWorker,\n  isWorkerLike,\n  postMessageToTarget,\n  removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, events, Guest, Connection, Connections, Schema } from \"./types\";\n\nconst connections: Connections = {};\n\nfunction isValidTarget(guest: Guest, event: any) {\n  // If it's a worker, we don't need to validate origin\n  if (isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker)) {\n    return true;\n  }\n\n  // For iframes, check origin and source\n  const iframe = guest as HTMLIFrameElement;\n  try {\n    const childURL = iframe.src;\n    const hasInlineContent = typeof iframe.srcdoc === \"string\" && iframe.srcdoc.length > 0;\n    const childOrigin = getOriginFromURL(childURL);\n    const hasProperOrigin = event.origin === childOrigin;\n    const hasProperSource = event.source === iframe.contentWindow;\n\n    // For inline iframes (srcdoc/about:blank) we can only rely on source matching\n    if (hasInlineContent || childURL === \"about:blank\") {\n      return hasProperSource;\n    }\n\n    return (hasProperOrigin && hasProperSource) || !childURL;\n  } catch (e) {\n    console.warn(\"Error checking iframe target:\", e);\n    return false;\n  }\n}\n\n/**\n * Perform a handshake with the target iframe, when the handshake is confirmed\n * resolve the connection object containing RPCs and properties\n *\n * @param guest\n * @param schema\n * @returns Promise\n */\nfunction connect(guest: Guest, schema: Schema = {}): Promise<Connection> {\n  if (!guest) throw new Error(\"a target is required\");\n\n  const guestIsWorker = isWorkerLike(guest);\n\n  const listenTo = guestIsWorker || isNodeEnv() ? (guest as Worker) : window;\n\n  return new Promise((resolve) => {\n    const connectionID = generateId();\n\n    // on handshake request\n    function handleHandshake(event: any) {\n      const sendTo = guestIsWorker || isNodeEnv() ? (guest as Worker) : event.source;\n\n      if (!guestIsWorker && !isNodeEnv() && !isValidTarget(guest, event)) return;\n\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REQUEST) return;\n      if (connections[connectionID]) return;\n\n      // Extract local methods first (doesn't need remote yet)\n      const localMethods = extractMethods(schema);\n\n      // Register remote methods first to get the remote object\n      const { remote, unregisterRemote } = registerRemoteMethods(\n        eventData.schema,\n        eventData.methodNames,\n        connectionID,\n        event,\n        listenTo,\n        sendTo,\n      );\n\n      // Now register local methods, passing the remote object\n      const unregisterLocal = registerLocalMethods(localMethods, connectionID, listenTo, sendTo, remote);\n\n      // send a HANDSHAKE REPLY to the guest\n      const payload = {\n        action: actions.HANDSHAKE_REPLY,\n        connectionID,\n        schema: schema,\n        methodNames: Object.keys(localMethods),\n      };\n\n      postMessageToTarget(sendTo, payload, event.origin);\n\n      // close the connection and all listeners when called\n      const close = () => {\n        delete connections[connectionID];\n        removeEventListener(listenTo, events.MESSAGE, handleHandshake);\n        removeEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n        unregisterRemote();\n        unregisterLocal();\n        if (guestIsWorker) {\n          (guest as Worker).terminate();\n        }\n      };\n\n      const connection: Connection = { remote, close, id: connectionID };\n      connections[connectionID] = connection;\n    }\n\n    // subscribe to HANDSHAKE MESSAGES\n    addEventListener(listenTo, events.MESSAGE, handleHandshake);\n\n    // on handshake reply\n    function handleHandshakeReply(event: any) {\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n      if (connectionID !== eventData.connectionID) return;\n\n      if (!connections[eventData.connectionID]) {\n        throw new Error(\"Rimless Error: No connection found for this connectionID\");\n      }\n\n      return resolve(connections[eventData.connectionID]);\n    }\n\n    addEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n  });\n}\n\nexport default {\n  connect,\n};\n"],"names":["isWorker","isNodeEnv","isIframe","extractMethods","obj","methods","parse","path","prop","propPath","urlRegex","ports","getOriginFromURL","url","regexResult","protocol","hostname","port","portSuffix","set","value","pathArray","key","current","i","generateId","length","chars","result","parentPort","getTargetHost","postMessageToTarget","target","message","origin","transferables","isNodeWorker","guest","isWorkerLike","addEventListener","event","handler","removeEventListener","getEventData","events","actions","SYM_TRANSFERABLES","registerLocalMethods","rpcConnectionID","listenTo","sendTo","remote","listeners","methodName","method","handleCall","eventData","action","callID","connectionID","callName","args","payload","error","unregister","createRPC","rpcCallName","resolve","reject","requestID","handleResponse","arg","registerRemoteMethods","schema","methodNames","rpc","withTransferable","cb","transferable","connect","eventHandlers","localMethods","handleHandshakeResponse","unregisterRemote","unregisterLocal","connection","connections","isValidTarget","iframe","childURL","hasInlineContent","childOrigin","hasProperOrigin","hasProperSource","guestIsWorker","handleHandshake","handleHandshakeReply","host"],"mappings":"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"}

package/lib/rimless.min.js

@@ -1,2 +1,2 @@
-var rimless=function(y){"use strict";function I(){return typeof window>"u"&&typeof self<"u"}function A(){var n;return typeof process<"u"&&!!((n=process.versions)!=null&&n.node)}function H(){return window.self!==window.top}function _(n){const r=[];return function t(e,i=""){Object.keys(e).forEach(o=>{const c=i?`${i}.${o}`:o;e[o]===Object(e[o])&&t(e[o],c),typeof e[o]=="function"&&r.push(c)})}(n),r}const G=/^(https?:|file:)?\/\/([^/:]+)?(:(\d+))?/,K={"http:":"80","https:":"443"};function U(n){if(!n)return null;const r=G.exec(n);if(!r)return null;const[,t="http:",e,,i]=r;if(t==="file:")return"file://";const o=i&&i!==K[t]?`:${i}`:"";return`${t}//${e}${o}`}function W(n,r,t){const e=Array.isArray(r)?r:r.split(".").filter(Boolean);let i=n;for(const o of e)if(i=i==null?void 0:i[o],i===void 0)return t;return i}function Q(n,r,t){if(!n||typeof n!="object")return n;const e=Array.isArray(r)?r:r.split(".").map(o=>o.match(/^\d+$/)?Number(o):o);let i=n;for(let o=0;o<e.length;o++){const c=e[o];o===e.length-1?i[c]=t:((!i[c]||typeof i[c]!="object")&&(i[c]=typeof e[o+1]=="number"?[]:{}),i=i[c])}return n}function T(n=10){const r="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";let t="";for(let e=0;e<n;e++)t+=r.charAt(Math.floor(Math.random()*r.length));return t}let w=null;if(A())try{w=require("worker_threads").parentPort}catch{}function $(){if(A())return w;if(I())return self;if(H())return window.parent;throw new Error("No valid target found for postMessage")}function m(n,r,t){if(!n)throw new Error("Rimless Error: No target specified for postMessage");if(A()&&n===w){n.postMessage(JSON.parse(JSON.stringify(r)));return}if(I()){n.postMessage(JSON.parse(JSON.stringify(r)));return}if(n.postMessage){n.postMessage(JSON.parse(JSON.stringify(r)),{targetOrigin:t||"*"});return}throw new Error("Rimless Error: Invalid target for postMessage")}function L(n){return w!==null&&n===w}function Y(n){return L(n)||typeof Worker<"u"&&n instanceof Worker}function P(n,r,t){L(n)?n.on(r,t):"addEventListener"in n&&n.addEventListener(r,t)}function O(n,r,t){L(n)?n.off(r,t):"removeEventListener"in n&&n.removeEventListener(r,t)}function M(n){return n.data||n}var l=(n=>(n.MESSAGE="message",n))(l||{}),u=(n=>(n.HANDSHAKE_REQUEST="RIMLESS/HANDSHAKE_REQUEST",n.HANDSHAKE_REPLY="RIMLESS/HANDSHAKE_REPLY",n.RPC_REQUEST="RIMLESS/RPC_REQUEST",n.RPC_RESOLVE="RIMLESS/RPC_RESOLVE",n.RPC_REJECT="RIMLESS/RPC_REJECT",n))(u||{});function k(n={},r=[],t,e,i){const o=[];return r.forEach(c=>{async function S(f){const s=M(f),{action:E,callID:R,connectionID:p,callName:h,args:g=[]}=s;if(E!==u.RPC_REQUEST||!R||!h||h!==c||p!==t)return;const d={action:u.RPC_RESOLVE,callID:R,callName:h,connectionID:p,error:null,result:null};try{const a=await W(n,c)(...g);a?d.result=JSON.parse(JSON.stringify(a)):d.result=a}catch(a){d.action=u.RPC_REJECT,d.error=JSON.parse(JSON.stringify(a,Object.getOwnPropertyNames(a)))}m(i,d,f==null?void 0:f.origin)}P(e,l.MESSAGE,S),o.push(()=>O(e,l.MESSAGE,S))}),()=>o.forEach(c=>c())}function V(n,r,t,e=[],i,o){return(...c)=>new Promise((S,f)=>{const s=T();function E(p){const h=M(p),{callID:g,connectionID:d,callName:a,result:D,error:z,action:C}=h;if(!(!g||!a)&&a===n&&g===s&&d===r){if(C===u.RPC_RESOLVE)return S(D);if(C===u.RPC_REJECT)return f(z)}}const R={action:u.RPC_REQUEST,args:JSON.parse(JSON.stringify(c)),callID:s,callName:n,connectionID:r};P(i,l.MESSAGE,E),e.push(()=>O(i,l.MESSAGE,E)),m(o,R,t==null?void 0:t.origin)})}function J(n={},r=[],t,e,i,o){const c={...n},S=[];return r.forEach(f=>{const s=V(f,t,e,S,i,o);Q(c,f,s)}),{remote:c,unregisterRemote:()=>S.forEach(f=>f())}}function q(n={},r){return new Promise(async t=>{const e=_(n),i=$(),o=self||window;async function c(f){var a;const s=M(f);if((s==null?void 0:s.action)!==u.HANDSHAKE_REPLY)return;const E=k(n,e,s.connectionID,o,i),{remote:R,unregisterRemote:p}=J(s.schema,s.methods,s.connectionID,f,o,i);await((a=r==null?void 0:r.onConnectionSetup)==null?void 0:a.call(r,R));const h={action:u.HANDSHAKE_REPLY,connectionID:s.connectionID};m(i,h,f==null?void 0:f.origin);const d={remote:R,close:()=>{self.removeEventListener(l.MESSAGE,c),p(),E()},id:s.connectionID};return t(d)}self.addEventListener(l.MESSAGE,c);const S={action:u.HANDSHAKE_REQUEST,methods:e,schema:JSON.parse(JSON.stringify(n))};m(i,S)})}const b={connect:q},N={};function B(n,r){if(L(n)||typeof Worker<"u"&&n instanceof Worker)return!0;const t=n;try{const e=t.src,i=U(e),o=r.origin===i,c=r.source===t.contentWindow;return o&&c||!e}catch(e){return console.warn("Error checking iframe target:",e),!1}}function F(n,r={}){if(!n)throw new Error("a target is required");const t=Y(n),e=t||A()?n:window;return new Promise(i=>{const o=T();function c(f){const s=t||A()?n:f.source;if(!t&&!A()&&!B(n,f))return;const E=M(f);if((E==null?void 0:E.action)!==u.HANDSHAKE_REQUEST||N[o])return;const R=_(r),p=k(r,R,o,e,s),{remote:h,unregisterRemote:g}=J(E.schema,E.methods,o,f,e,s),d={action:u.HANDSHAKE_REPLY,connectionID:o,schema:r,methods:R};m(s,d,f.origin);const D={remote:h,close:()=>{delete N[o],O(e,l.MESSAGE,c),g(),p(),t&&n.terminate()},id:o};N[o]=D}P(e,l.MESSAGE,c);function S(f){const s=M(f);if((s==null?void 0:s.action)===u.HANDSHAKE_REPLY&&o===s.connectionID){if(!N[s.connectionID])throw new Error("Rimless Error: No connection found for this connectionID");return i(N[s.connectionID])}}P(e,l.MESSAGE,S)})}const x={connect:F};return y.actions=u,y.events=l,y.guest=b,y.host=x,Object.defineProperty(y,Symbol.toStringTag,{value:"Module"}),y}({});
+var rimless=function(w){"use strict";function _(){return typeof window>"u"&&typeof self<"u"}function p(){return typeof process<"u"&&!!process.versions?.node}function K(){return window.self!==window.top}function k(n){const r={};return function o(e,s=""){Object.keys(e).forEach(t=>{const c=s?`${s}.${t}`:t;e[t]===Object(e[t])&&o(e[t],c),typeof e[t]=="function"&&(r[c]=e[t],delete e[t])})}(n),r}const U=/^(https?:|file:)?\/\/([^/:]+)?(:(\d+))?/,W={"http:":"80","https:":"443"};function Q(n){if(!n)return null;const r=U.exec(n);if(!r)return null;const[,o="http:",e,,s]=r;if(o==="file:")return"file://";const t=s&&s!==W[o]?`:${s}`:"";return`${o}//${e}${t}`}function b(n,r,o){if(!n||typeof n!="object")return n;const e=Array.isArray(r)?r:r.split(".").map(t=>t.match(/^\d+$/)?Number(t):t);let s=n;for(let t=0;t<e.length;t++){const c=e[t];t===e.length-1?s[c]=o:((!s[c]||typeof s[c]!="object")&&(s[c]=typeof e[t+1]=="number"?[]:{}),s=s[c])}return n}function O(n=10){const r="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";let o="";for(let e=0;e<n;e++)o+=r.charAt(Math.floor(Math.random()*r.length));return o}let y=null;if(p())try{y=require("worker_threads").parentPort}catch{}function Y(){if(p())return y;if(_())return self;if(K())return window.parent;throw new Error("No valid target found for postMessage")}function D(n,r,o,e){if(!n)throw new Error("Rimless Error: No target specified for postMessage");if(p()&&n===y){n.postMessage(r,{transfer:e});return}if(_()){n.postMessage(r,{transfer:e});return}if(n.postMessage){n.postMessage(r,{targetOrigin:o||"*",transfer:e});return}throw new Error("Rimless Error: Invalid target for postMessage")}function H(n){return y!==null&&n===y}function $(n){return H(n)||typeof Worker<"u"&&n instanceof Worker}function P(n,r,o){H(n)?n.on(r,o):"addEventListener"in n&&n.addEventListener(r,o)}function L(n,r,o){H(n)?n.off(r,o):"removeEventListener"in n&&n.removeEventListener(r,o)}function N(n){return n.data||n}var l=(n=>(n.MESSAGE="message",n))(l||{}),f=(n=>(n.HANDSHAKE_REQUEST="RIMLESS/HANDSHAKE_REQUEST",n.HANDSHAKE_REPLY="RIMLESS/HANDSHAKE_REPLY",n.RPC_REQUEST="RIMLESS/RPC_REQUEST",n.RPC_RESOLVE="RIMLESS/RPC_RESOLVE",n.RPC_REJECT="RIMLESS/RPC_REJECT",n))(f||{});const M=Symbol();function C(n={},r,o,e,s){const t=[];for(const[c,u]of Object.entries(n)){async function a(i){const E=N(i),{action:m,callID:R,connectionID:d,callName:S,args:A=[]}=E;if(m!==f.RPC_REQUEST||!R||!S||S!==c||d!==r)return;const h={action:f.RPC_RESOLVE,callID:R,callName:S,connectionID:d,error:null,result:null};let g;try{h.result=await u(...A,s),h.result&&h.result[M]&&(g=h.result[M]??[],delete h.result[M])}catch(T){h.action=f.RPC_REJECT,h.error=JSON.parse(JSON.stringify(T,Object.getOwnPropertyNames(T)))}D(e,h,i?.origin,g)}P(o,l.MESSAGE,a),t.push(()=>L(o,l.MESSAGE,a))}return()=>t.forEach(c=>c())}function J(n,r,o,e=[],s,t){return(...c)=>new Promise((u,a)=>{const i=O();function E(d){const S=N(d),{callID:A,connectionID:h,callName:g,result:T,error:X,action:G}=S;if(!(!A||!g)&&g===n&&A===i&&h===r){if(G===f.RPC_RESOLVE)return u(T);if(G===f.RPC_REJECT)return a(X)}}const m={action:f.RPC_REQUEST,args:c,callID:i,callName:n,connectionID:r},R=c.reduce((d,S)=>S[M]?.length?d.concat(S[M]):d,c[M]??[]);P(s,l.MESSAGE,E),e.push(()=>L(s,l.MESSAGE,E)),D(t,m,o?.origin,R)})}function v(n={},r=[],o,e,s,t){const c={...n},u=[];for(const a of r){const i=J(a,o,e,u,s,t);b(c,a,i)}return{remote:c,unregisterRemote:()=>u.forEach(a=>a())}}const V=n=>{const r=[],e=n(s=>(r.push(s),s));return Object.assign(e,{[M]:r})};function q(n={},r){return new Promise(async o=>{const e=k(n),s=Y(),t=self||window;async function c(a){const i=N(a);if(i?.action!==f.HANDSHAKE_REPLY)return;const{remote:E,unregisterRemote:m}=v(i.schema,i.methodNames,i.connectionID,a,t,s),R=C(e,i.connectionID,t,s,E);await r?.onConnectionSetup?.(E);const d={action:f.HANDSHAKE_REPLY,connectionID:i.connectionID};D(s,d,a?.origin);const A={remote:E,close:()=>{L(t,l.MESSAGE,c),m(),R()},id:i.connectionID};return o(A)}P(t,l.MESSAGE,c);const u={action:f.HANDSHAKE_REQUEST,methodNames:Object.keys(e),schema:n};D(s,u)})}const F={connect:q},I={};function B(n,r){if(H(n)||typeof Worker<"u"&&n instanceof Worker)return!0;const o=n;try{const e=o.src,s=typeof o.srcdoc=="string"&&o.srcdoc.length>0,t=Q(e),c=r.origin===t,u=r.source===o.contentWindow;return s||e==="about:blank"?u:c&&u||!e}catch(e){return console.warn("Error checking iframe target:",e),!1}}function j(n,r={}){if(!n)throw new Error("a target is required");const o=$(n),e=o||p()?n:window;return new Promise(s=>{const t=O();function c(a){const i=o||p()?n:a.source;if(!o&&!p()&&!B(n,a))return;const E=N(a);if(E?.action!==f.HANDSHAKE_REQUEST||I[t])return;const m=k(r),{remote:R,unregisterRemote:d}=v(E.schema,E.methodNames,t,a,e,i),S=C(m,t,e,i,R),A={action:f.HANDSHAKE_REPLY,connectionID:t,schema:r,methodNames:Object.keys(m)};D(i,A,a.origin);const g={remote:R,close:()=>{delete I[t],L(e,l.MESSAGE,c),L(e,l.MESSAGE,u),d(),S(),o&&n.terminate()},id:t};I[t]=g}P(e,l.MESSAGE,c);function u(a){const i=N(a);if(i?.action===f.HANDSHAKE_REPLY&&t===i.connectionID){if(!I[i.connectionID])throw new Error("Rimless Error: No connection found for this connectionID");return s(I[i.connectionID])}}P(e,l.MESSAGE,u)})}const z={connect:j};return w.actions=f,w.events=l,w.guest=F,w.host=z,w.withTransferable=V,Object.defineProperty(w,Symbol.toStringTag,{value:"Module"}),w}({});
 //# sourceMappingURL=rimless.min.js.map

package/lib/rimless.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"rimless.min.js","sources":["../src/helpers.ts","../src/types.ts","../src/rpc.ts","../src/guest.ts","../src/host.ts"],"sourcesContent":["import { Guest, NodeWorker, Target, WorkerLike } from \"./types\";\n\n/**\n * check if run in a webworker\n *\n * @returns boolean\n */\nexport function isWorker(): boolean {\n  return typeof window === \"undefined\" && typeof self !== \"undefined\";\n}\n\n/**\n * check if run in a Node.js environment\n *\n * @returns boolean\n */\nexport function isNodeEnv(): boolean {\n  return typeof process !== \"undefined\" && !!(process as any).versions?.node;\n}\n\n/**\n * check if run in an iframe\n *\n * @returns boolean\n */\nexport function isIframe() {\n  return window.self !== window.top;\n}\n\n/**\n * we cannot send functions through postMessage\n * extract the path to all functions in the schema\n *\n * @param obj\n */\nexport function extractMethods(obj: any) {\n  const paths: string[] = [];\n  (function parse(obj: any, path = \"\") {\n    Object.keys(obj).forEach((prop) => {\n      const propPath = path ? `${path}.${prop}` : prop;\n      if (obj[prop] === Object(obj[prop])) {\n        parse(obj[prop], propPath);\n      }\n      if (typeof obj[prop] === \"function\") {\n        paths.push(propPath);\n      }\n    });\n  })(obj);\n  return paths;\n}\n\nconst urlRegex = /^(https?:|file:)?\\/\\/([^/:]+)?(:(\\d+))?/;\nconst ports: any = { \"http:\": \"80\", \"https:\": \"443\" };\n\n/**\n * convert the url into an origin (remove paths)\n *\n * @param url\n */\nexport function getOriginFromURL(url: string | null) {\n  if (!url) return null;\n\n  const regexResult = urlRegex.exec(url);\n  if (!regexResult) return null;\n\n  const [, protocol = \"http:\", hostname, , port] = regexResult;\n\n  // If the protocol is file, return file://\n  if (protocol === \"file:\") {\n    return \"file://\";\n  }\n\n  // If the port is the default for the protocol, we don't want to add it to the origin string\n  const portSuffix = port && port !== ports[protocol] ? `:${port}` : \"\";\n  return `${protocol}//${hostname}${portSuffix}`;\n}\n\nexport function get(obj: any, path: string | Array<string | number>, defaultValue?: any): any {\n  const keys = Array.isArray(path) ? path : path.split(\".\").filter(Boolean);\n  let result = obj;\n\n  for (const key of keys) {\n    result = result?.[key];\n    if (result === undefined) {\n      return defaultValue;\n    }\n  }\n\n  return result;\n}\n\nexport function set(obj: any, path: string | (string | number)[], value: any): any {\n  if (!obj || typeof obj !== \"object\") return obj;\n\n  const pathArray = Array.isArray(path) ? path : path.split(\".\").map((key) => (key.match(/^\\d+$/) ? Number(key) : key));\n\n  let current = obj;\n\n  for (let i = 0; i < pathArray.length; i++) {\n    const key = pathArray[i];\n\n    if (i === pathArray.length - 1) {\n      current[key] = value;\n    } else {\n      if (!current[key] || typeof current[key] !== \"object\") {\n        current[key] = typeof pathArray[i + 1] === \"number\" ? [] : {};\n      }\n      current = current[key];\n    }\n  }\n\n  return obj;\n}\n\nexport function generateId(length: number = 10): string {\n  const chars = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\n  let result = \"\";\n  for (let i = 0; i < length; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n\nlet parentPort: any = null;\n\nif (isNodeEnv()) {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const workerThreads = require(\"worker_threads\");\n    parentPort = workerThreads.parentPort;\n  } catch (e) {\n    // Not in worker thread context\n  }\n}\n\n/**\n * Get the appropriate target host for messaging based on the current environment\n * @returns The messaging target for the current environment\n */\nexport function getTargetHost(): any {\n  if (isNodeEnv()) {\n    return parentPort;\n  }\n\n  if (isWorker()) {\n    return self;\n  }\n\n  if (isIframe()) {\n    return window.parent;\n  }\n\n  throw new Error(\"No valid target found for postMessage\");\n}\n\n/**\n * Send a message to a target, handling different environments (iframe, web worker, node worker)\n * @param target The target to send the message to\n * @param message The message to send\n * @param origin Optional origin for iframe communication\n */\nexport function postMessageToTarget(target: Target, message: any, origin?: string): void {\n  if (!target) {\n    throw new Error(\"Rimless Error: No target specified for postMessage\");\n  }\n\n  // Node.js Worker\n  if (isNodeEnv() && target === parentPort) {\n    target.postMessage(JSON.parse(JSON.stringify(message)));\n    return;\n  }\n\n  // Web Worker\n  if (isWorker()) {\n    target.postMessage(JSON.parse(JSON.stringify(message)));\n    return;\n  }\n\n  // iframe or window\n  if (target.postMessage) {\n    target.postMessage(JSON.parse(JSON.stringify(message)), { targetOrigin: origin || \"*\" });\n    return;\n  }\n\n  throw new Error(\"Rimless Error: Invalid target for postMessage\");\n}\n\nexport function isNodeWorker(guest: Guest | Target): guest is NodeWorker {\n  return parentPort !== null && guest === parentPort;\n}\n\nexport function isWorkerLike(guest: Guest): guest is WorkerLike {\n  return isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker);\n}\n\nexport function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n  if (isNodeWorker(target)) {\n    target.on(event, handler);\n  } else if (\"addEventListener\" in target) {\n    target.addEventListener(event, handler);\n  }\n}\n\nexport function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n  if (isNodeWorker(target)) {\n    target.off(event, handler);\n  } else if (\"removeEventListener\" in target) {\n    target.removeEventListener(event, handler);\n  }\n}\n\n/**\n * Normalize message event data across Web and Node.js environments\n * In web, data is in event.data\n * In Node.js, the event itself contains the data\n */\nexport function getEventData(event: any) {\n  return event.data || event;\n}\n","export interface NodeWorker {\n  on(event: string, handler: any): void;\n  off(event: string, handler: any): void;\n  postMessage(message: any): void;\n  terminate(): void;\n}\n\nexport type WorkerLike = Worker | NodeWorker;\n\nexport enum events {\n  MESSAGE = \"message\",\n}\n\nexport enum actions {\n  HANDSHAKE_REQUEST = \"RIMLESS/HANDSHAKE_REQUEST\",\n  HANDSHAKE_REPLY = \"RIMLESS/HANDSHAKE_REPLY\",\n  RPC_REQUEST = \"RIMLESS/RPC_REQUEST\",\n  RPC_RESOLVE = \"RIMLESS/RPC_RESOLVE\",\n  RPC_REJECT = \"RIMLESS/RPC_REJECT\",\n}\n\nexport type Schema = Record<string, any>;\n\nexport interface Connection {\n  id: string;\n  remote: Schema;\n  close: () => void;\n}\n\nexport type Connections = Record<string, Connection>;\n\nexport interface RimlessEvent extends EventListener {\n  source?: Window;\n  origin?: string;\n  data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;\n}\n\nexport interface HandshakeRequestPayload {\n  action: actions.HANDSHAKE_REQUEST;\n  connectionID: string;\n  methods: string[];\n  schema: Schema;\n}\n\nexport interface HandshakeConfirmationPayload {\n  action: actions.HANDSHAKE_REPLY;\n  connectionID: string;\n  methods: string[];\n  schema: Schema;\n}\n\nexport interface RPCRequestPayload {\n  action: actions.RPC_REQUEST;\n  args: any[];\n  callID: string;\n  callName: string;\n  connectionID: string;\n}\n\nexport interface RPCResolvePayload {\n  action: actions.RPC_RESOLVE | actions.RPC_REJECT;\n  result?: any | null;\n  error?: Error | null;\n  callID: string;\n  callName: string;\n  connectionID: string;\n}\n\nexport interface EventHandlers {\n  onConnectionSetup: (remote: Schema) => Promise<void>;\n}\n\nexport type Guest = WorkerLike | HTMLIFrameElement;\nexport type Target = Window | WorkerLike;\nexport type Environment = Window | WorkerLike;\n","import {\n  addEventListener,\n  generateId,\n  get,\n  getEventData,\n  postMessageToTarget,\n  removeEventListener,\n  set,\n} from \"./helpers\";\nimport {\n  actions,\n  Environment,\n  events,\n  RimlessEvent,\n  RPCRequestPayload,\n  RPCResolvePayload,\n  Schema,\n  Target,\n} from \"./types\";\n\n/**\n * for each function in the schema\n * 1. subscribe to an event that the remote can call\n * 2. listen for calls from the remote. When called execute the function and emit the results.\n *\n * @param methods an array of method ids from the local schema\n * @param rpcConnectionID\n * @return a function to cancel all subscriptions\n */\nexport function registerLocalMethods(\n  schema: Schema = {},\n  methods: string[] = [],\n  rpcConnectionID: string,\n  listenTo: Environment,\n  sendTo: Target,\n) {\n  const listeners: any[] = [];\n\n  methods.forEach((methodName) => {\n    // handle a remote calling a local method\n    async function handleCall(event: any) {\n      const eventData = getEventData(event);\n      const { action, callID, connectionID, callName, args = [] } = eventData as RPCRequestPayload;\n\n      if (action !== actions.RPC_REQUEST) return;\n      if (!callID || !callName) return;\n      if (callName !== methodName) return;\n      if (connectionID !== rpcConnectionID) return;\n\n      const payload: RPCResolvePayload = {\n        action: actions.RPC_RESOLVE,\n        callID,\n        callName,\n        connectionID,\n        error: null,\n        result: null,\n      };\n\n      // run function and return the results to the remote\n      try {\n        const result = await get(schema, methodName)(...args);\n\n        if (!result) {\n          // if the result is falsy (null, undefined, \"\", etc), set it directly\n          payload.result = result;\n        } else {\n          // otherwise parse a stringified version of it\n          payload.result = JSON.parse(JSON.stringify(result));\n        }\n      } catch (error) {\n        payload.action = actions.RPC_REJECT;\n        payload.error = JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)));\n      }\n\n      postMessageToTarget(sendTo, payload, event?.origin);\n    }\n\n    // subscribe to the call event\n    addEventListener(listenTo, events.MESSAGE, handleCall);\n    listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleCall));\n  });\n\n  return () => listeners.forEach((unregister) => unregister());\n}\n\n/**\n * Create a function that will make an RPC request to the remote with some arguments.\n * Listen to an event that returns the results from the remote.\n *\n * @param rpcCallName\n * @param rpcConnectionID\n * @param event\n * @param listeners\n * @param guest\n *\n * @returns a promise with the result of the RPC\n */\nexport function createRPC(\n  rpcCallName: string,\n  rpcConnectionID: string,\n  event: RimlessEvent,\n  listeners: Array<() => void> = [],\n  listenTo: Environment,\n  sendTo: Target,\n) {\n  return (...args: any) => {\n    return new Promise((resolve, reject) => {\n      const requestID = generateId();\n\n      // on RPC response\n      function handleResponse(event: any) {\n        const eventData = getEventData(event);\n        const { callID, connectionID, callName, result, error, action } = eventData as RPCResolvePayload;\n\n        if (!callID || !callName) return;\n        if (callName !== rpcCallName) return;\n        if (callID !== requestID) return;\n        if (connectionID !== rpcConnectionID) return;\n\n        // resolve the response\n        if (action === actions.RPC_RESOLVE) return resolve(result);\n        if (action === actions.RPC_REJECT) return reject(error);\n      }\n\n      // send the RPC request with arguments\n      const payload = {\n        action: actions.RPC_REQUEST,\n        args: JSON.parse(JSON.stringify(args)),\n        callID: requestID,\n        callName: rpcCallName,\n        connectionID: rpcConnectionID,\n      };\n\n      addEventListener(listenTo, events.MESSAGE, handleResponse);\n      listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleResponse));\n\n      postMessageToTarget(sendTo, payload, event?.origin);\n    });\n  };\n}\n\n/**\n * create an object based on the remote schema and methods. Functions in that object will\n * emit an event that will trigger the RPC on the remote.\n *\n * @param schema\n * @param methods\n * @param connectionID\n * @param event\n * @param guest\n */\nexport function registerRemoteMethods(\n  schema: Schema = {},\n  methods: string[] = [],\n  connectionID: string,\n  event: RimlessEvent,\n  listenTo: Environment,\n  sendTo: Target,\n) {\n  const remote = { ...schema };\n  const listeners: Array<() => void> = [];\n\n  methods.forEach((methodName) => {\n    const rpc = createRPC(methodName, connectionID, event, listeners, listenTo, sendTo);\n    set(remote, methodName, rpc);\n  });\n\n  return {\n    remote,\n    unregisterRemote: () => listeners.forEach((unregister) => unregister()),\n  };\n}\n","import { extractMethods, getEventData, getTargetHost, postMessageToTarget } from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, EventHandlers, events, Connection, Schema } from \"./types\";\n\nfunction connect(schema: Schema = {}, eventHandlers?: EventHandlers): Promise<Connection> {\n  return new Promise(async (resolve) => {\n    const localMethods = extractMethods(schema);\n    const sendTo = getTargetHost();\n    const listenTo = self || window;\n\n    // on handshake response\n    async function handleHandshakeResponse(event: any) {\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n\n      // register local methods\n      const unregisterLocal = registerLocalMethods(schema, localMethods, eventData.connectionID, listenTo, sendTo);\n\n      // register remote methods\n      const { remote, unregisterRemote } = registerRemoteMethods(\n        eventData.schema,\n        eventData.methods,\n        eventData.connectionID,\n        event,\n        listenTo,\n        sendTo,\n      );\n\n      await eventHandlers?.onConnectionSetup?.(remote);\n\n      // send a HANDSHAKE REPLY to the host\n      const payload = {\n        action: actions.HANDSHAKE_REPLY,\n        connectionID: eventData.connectionID,\n      };\n\n      postMessageToTarget(sendTo, payload, event?.origin);\n\n      // close the connection and all listeners when called\n      const close = () => {\n        self.removeEventListener(events.MESSAGE, handleHandshakeResponse);\n        unregisterRemote();\n        unregisterLocal();\n      };\n\n      // resolve connection object\n      const connection = { remote, close, id: eventData.connectionID };\n      return resolve(connection);\n    }\n\n    // subscribe to HANDSHAKE RESPONSE MESSAGES\n    self.addEventListener(events.MESSAGE, handleHandshakeResponse);\n\n    const payload = {\n      action: actions.HANDSHAKE_REQUEST,\n      methods: localMethods,\n      schema: JSON.parse(JSON.stringify(schema)),\n    };\n\n    postMessageToTarget(sendTo, payload);\n  });\n}\n\nexport default {\n  connect,\n};\n","import {\n  addEventListener,\n  extractMethods,\n  generateId,\n  getEventData,\n  getOriginFromURL,\n  isNodeEnv,\n  isNodeWorker,\n  isWorkerLike,\n  postMessageToTarget,\n  removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, events, Guest, Connection, Connections, Schema } from \"./types\";\n\nconst connections: Connections = {};\n\nfunction isValidTarget(guest: Guest, event: any) {\n  // If it's a worker, we don't need to validate origin\n  if (isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker)) {\n    return true;\n  }\n\n  // For iframes, check origin and source\n  const iframe = guest as HTMLIFrameElement;\n  try {\n    const childURL = iframe.src;\n    const childOrigin = getOriginFromURL(childURL);\n    const hasProperOrigin = event.origin === childOrigin;\n    const hasProperSource = event.source === iframe.contentWindow;\n\n    return (hasProperOrigin && hasProperSource) || !childURL;\n  } catch (e) {\n    console.warn(\"Error checking iframe target:\", e);\n    return false;\n  }\n}\n\n/**\n * Perform a handshake with the target iframe, when the handshake is confirmed\n * resolve the connection object containing RPCs and properties\n *\n * @param iframe\n * @param schema\n * @returns Promise\n */\nfunction connect(guest: Guest, schema: Schema = {}): Promise<Connection> {\n  if (!guest) throw new Error(\"a target is required\");\n\n  const guestIsWorker = isWorkerLike(guest);\n\n  const listenTo = guestIsWorker || isNodeEnv() ? (guest as Worker) : window;\n\n  return new Promise((resolve) => {\n    const connectionID = generateId();\n\n    // on handshake request\n    function handleHandshake(event: any) {\n      const sendTo = guestIsWorker || isNodeEnv() ? (guest as Worker) : event.source;\n\n      if (!guestIsWorker && !isNodeEnv() && !isValidTarget(guest, event)) return;\n\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REQUEST) return;\n      if (connections[connectionID]) return;\n\n      // register local methods\n      const localMethods = extractMethods(schema);\n      const unregisterLocal = registerLocalMethods(schema, localMethods, connectionID, listenTo, sendTo);\n\n      // register remote methods\n      const { remote, unregisterRemote } = registerRemoteMethods(\n        eventData.schema,\n        eventData.methods,\n        connectionID,\n        event,\n        listenTo,\n        sendTo,\n      );\n\n      // send a HANDSHAKE REPLY to the guest\n      const payload = {\n        action: actions.HANDSHAKE_REPLY,\n        connectionID,\n        schema,\n        methods: localMethods,\n      };\n\n      postMessageToTarget(sendTo, payload, event.origin);\n\n      // close the connection and all listeners when called\n      const close = () => {\n        delete connections[connectionID];\n        removeEventListener(listenTo, events.MESSAGE, handleHandshake);\n        unregisterRemote();\n        unregisterLocal();\n        if (guestIsWorker) {\n          (guest as Worker).terminate();\n        }\n      };\n\n      const connection: Connection = { remote, close, id: connectionID };\n      connections[connectionID] = connection;\n    }\n\n    // subscribe to HANDSHAKE MESSAGES\n    addEventListener(listenTo, events.MESSAGE, handleHandshake);\n\n    // on handshake reply\n    function handleHandshakeReply(event: any) {\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n      if (connectionID !== eventData.connectionID) return;\n\n      if (!connections[eventData.connectionID]) {\n        throw new Error(\"Rimless Error: No connection found for this connectionID\");\n      }\n\n      return resolve(connections[eventData.connectionID]);\n    }\n\n    addEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n  });\n}\n\nexport default {\n  connect,\n};\n"],"names":["isWorker","isNodeEnv","_a","isIframe","extractMethods","obj","paths","parse","path","prop","propPath","urlRegex","ports","getOriginFromURL","url","regexResult","protocol","hostname","port","portSuffix","get","defaultValue","keys","result","key","set","value","pathArray","current","i","generateId","length","chars","parentPort","getTargetHost","postMessageToTarget","target","message","origin","isNodeWorker","guest","isWorkerLike","addEventListener","event","handler","removeEventListener","getEventData","events","actions","registerLocalMethods","schema","methods","rpcConnectionID","listenTo","sendTo","listeners","methodName","handleCall","eventData","action","callID","connectionID","callName","args","payload","error","unregister","createRPC","rpcCallName","resolve","reject","requestID","handleResponse","registerRemoteMethods","remote","rpc","connect","eventHandlers","localMethods","handleHandshakeResponse","unregisterLocal","unregisterRemote","connection","connections","isValidTarget","iframe","childURL","childOrigin","hasProperOrigin","hasProperSource","guestIsWorker","handleHandshake","handleHandshakeReply","host"],"mappings":"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"}
+{"version":3,"file":"rimless.min.js","sources":["../src/helpers.ts","../src/types.ts","../src/rpc.ts","../src/guest.ts","../src/host.ts"],"sourcesContent":["import { Guest, NodeWorker, Target, WorkerLike } from \"./types\";\n\n/**\n * check if run in a webworker\n *\n * @returns boolean\n */\nexport function isWorker(): boolean {\n  return typeof window === \"undefined\" && typeof self !== \"undefined\";\n}\n\n/**\n * check if run in a Node.js environment\n *\n * @returns boolean\n */\nexport function isNodeEnv(): boolean {\n  return typeof process !== \"undefined\" && !!(process as any).versions?.node;\n}\n\n/**\n * check if run in an iframe\n *\n * @returns boolean\n */\nexport function isIframe() {\n  return window.self !== window.top;\n}\n\n/**\n * we cannot send functions through postMessage\n * extract the path to all functions in the schema\n *\n * @param obj\n */\nexport function extractMethods(obj: any) {\n  const methods: Record<string, (...args: any) => any> = {};\n  (function parse(obj: any, path = \"\") {\n    Object.keys(obj).forEach((prop) => {\n      const propPath = path ? `${path}.${prop}` : prop;\n      if (obj[prop] === Object(obj[prop])) {\n        parse(obj[prop], propPath);\n      }\n      if (typeof obj[prop] === \"function\") {\n        methods[propPath] = obj[prop];\n        delete obj[prop];\n      }\n    });\n  })(obj);\n  return methods;\n}\n\nconst urlRegex = /^(https?:|file:)?\\/\\/([^/:]+)?(:(\\d+))?/;\nconst ports: any = { \"http:\": \"80\", \"https:\": \"443\" };\n\n/**\n * convert the url into an origin (remove paths)\n *\n * @param url\n */\nexport function getOriginFromURL(url: string | null) {\n  if (!url) return null;\n\n  const regexResult = urlRegex.exec(url);\n  if (!regexResult) return null;\n\n  const [, protocol = \"http:\", hostname, , port] = regexResult;\n\n  // If the protocol is file, return file://\n  if (protocol === \"file:\") {\n    return \"file://\";\n  }\n\n  // If the port is the default for the protocol, we don't want to add it to the origin string\n  const portSuffix = port && port !== ports[protocol] ? `:${port}` : \"\";\n  return `${protocol}//${hostname}${portSuffix}`;\n}\n\nexport function get(obj: any, path: string | Array<string | number>, defaultValue?: any): any {\n  const keys = Array.isArray(path) ? path : path.split(\".\").filter(Boolean);\n  let result = obj;\n\n  for (const key of keys) {\n    result = result?.[key];\n    if (result === undefined) {\n      return defaultValue;\n    }\n  }\n\n  return result;\n}\n\nexport function set(obj: any, path: string | (string | number)[], value: any): any {\n  if (!obj || typeof obj !== \"object\") return obj;\n\n  const pathArray = Array.isArray(path) ? path : path.split(\".\").map((key) => (key.match(/^\\d+$/) ? Number(key) : key));\n\n  let current = obj;\n\n  for (let i = 0; i < pathArray.length; i++) {\n    const key = pathArray[i];\n\n    if (i === pathArray.length - 1) {\n      current[key] = value;\n    } else {\n      if (!current[key] || typeof current[key] !== \"object\") {\n        current[key] = typeof pathArray[i + 1] === \"number\" ? [] : {};\n      }\n      current = current[key];\n    }\n  }\n\n  return obj;\n}\n\nexport function generateId(length: number = 10): string {\n  const chars = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\n  let result = \"\";\n  for (let i = 0; i < length; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n\nlet parentPort: any = null;\n\nif (isNodeEnv()) {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const workerThreads = require(\"worker_threads\");\n    parentPort = workerThreads.parentPort;\n  } catch (e) {\n    // Not in worker thread context\n  }\n}\n\n/**\n * Get the appropriate target host for messaging based on the current environment\n * @returns The messaging target for the current environment\n */\nexport function getTargetHost(): any {\n  if (isNodeEnv()) {\n    return parentPort;\n  }\n\n  if (isWorker()) {\n    return self;\n  }\n\n  if (isIframe()) {\n    return window.parent;\n  }\n\n  throw new Error(\"No valid target found for postMessage\");\n}\n\n/**\n * Send a message to a target, handling different environments (iframe, web worker, node worker)\n * @param target The target to send the message to\n * @param message The message to send\n * @param origin Optional origin for iframe communication\n * @param transferables Optional transferables for postMessage\n */\nexport function postMessageToTarget(\n  target: Target,\n  message: any,\n  origin?: string,\n  transferables?: Transferable[],\n): void {\n  if (!target) {\n    throw new Error(\"Rimless Error: No target specified for postMessage\");\n  }\n\n  // Node.js Worker\n  if (isNodeEnv() && target === parentPort) {\n    target.postMessage(message, { transfer: transferables });\n    return;\n  }\n\n  // Web Worker\n  if (isWorker()) {\n    target.postMessage(message, { transfer: transferables });\n    return;\n  }\n\n  // iframe or window\n  if (target.postMessage) {\n    target.postMessage(message, { targetOrigin: origin || \"*\", transfer: transferables });\n    return;\n  }\n\n  throw new Error(\"Rimless Error: Invalid target for postMessage\");\n}\n\nexport function isNodeWorker(guest: Guest | Target): guest is NodeWorker {\n  return parentPort !== null && guest === parentPort;\n}\n\nexport function isWorkerLike(guest: Guest): guest is WorkerLike {\n  return isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker);\n}\n\nexport function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n  if (isNodeWorker(target)) {\n    target.on(event, handler);\n  } else if (\"addEventListener\" in target) {\n    target.addEventListener(event, handler);\n  }\n}\n\nexport function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n  if (isNodeWorker(target)) {\n    target.off(event, handler);\n  } else if (\"removeEventListener\" in target) {\n    target.removeEventListener(event, handler);\n  }\n}\n\n/**\n * Normalize message event data across Web and Node.js environments\n * In web, data is in event.data\n * In Node.js, the event itself contains the data\n */\nexport function getEventData(event: any) {\n  return event.data || event;\n}\n","export interface NodeWorker {\n  on(event: string, handler: any): void;\n  off(event: string, handler: any): void;\n  postMessage(message: any): void;\n  terminate(): void;\n}\n\nexport type WorkerLike = Worker | NodeWorker;\n\nexport enum events {\n  MESSAGE = \"message\",\n}\n\nexport enum actions {\n  HANDSHAKE_REQUEST = \"RIMLESS/HANDSHAKE_REQUEST\",\n  HANDSHAKE_REPLY = \"RIMLESS/HANDSHAKE_REPLY\",\n  RPC_REQUEST = \"RIMLESS/RPC_REQUEST\",\n  RPC_RESOLVE = \"RIMLESS/RPC_RESOLVE\",\n  RPC_REJECT = \"RIMLESS/RPC_REJECT\",\n}\n\nexport type Schema = Record<string, any>;\n\nexport interface Connection {\n  id: string;\n  remote: Schema;\n  close: () => void;\n}\n\nexport type Connections = Record<string, Connection>;\n\nexport interface RimlessEvent extends EventListener {\n  source?: Window;\n  origin?: string;\n  data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;\n}\n\nexport interface HandshakeRequestPayload {\n  action: actions.HANDSHAKE_REQUEST;\n  connectionID: string;\n  methodNames: string[];\n  schema: Schema;\n}\n\nexport interface HandshakeConfirmationPayload {\n  action: actions.HANDSHAKE_REPLY;\n  connectionID: string;\n  methodNames: string[];\n  schema: Schema;\n}\n\nexport interface RPCRequestPayload {\n  action: actions.RPC_REQUEST;\n  args: any[];\n  callID: string;\n  callName: string;\n  connectionID: string;\n}\n\nexport interface RPCResolvePayload {\n  action: actions.RPC_RESOLVE | actions.RPC_REJECT;\n  result?: any | null;\n  error?: Error | null;\n  callID: string;\n  callName: string;\n  connectionID: string;\n}\n\nexport interface EventHandlers {\n  onConnectionSetup: (remote: Schema) => Promise<void>;\n}\n\nexport type Guest = WorkerLike | HTMLIFrameElement;\nexport type Target = Window | WorkerLike;\nexport type Environment = Window | WorkerLike;\n","import { addEventListener, generateId, getEventData, postMessageToTarget, removeEventListener, set } from \"./helpers\";\nimport {\n  actions,\n  Environment,\n  events,\n  RimlessEvent,\n  RPCRequestPayload,\n  RPCResolvePayload,\n  Schema,\n  Target,\n} from \"./types\";\n\n/** Private symbol to which we will assign transferable objects */\nconst SYM_TRANSFERABLES = Symbol();\n\n/**\n * for each function in methods\n * 1. subscribe to an event that the remote can call\n * 2. listen for calls from the remote. When called execute the function and emit the results.\n *\n * @param methods an object of method ids : methods from the local schema\n * @param rpcConnectionID\n * @param listenTo Environment to listen for incoming messages\n * @param sendTo Target to send outgoing messages\n * @param remote The remote API object for the current connection\n * @return a function to cancel all subscriptions\n */\nexport function registerLocalMethods(\n  methods: Record<string, (...args: any[]) => any> = {},\n  rpcConnectionID: string,\n  listenTo: Environment,\n  sendTo: Target,\n  remote: Schema // Add remote parameter\n) {\n  const listeners: any[] = [];\n  for (const [methodName, method] of Object.entries(methods)) {\n    // handle a remote calling a local method\n    async function handleCall(event: any) {\n      const eventData = getEventData(event);\n      const { action, callID, connectionID, callName, args = [] } = eventData as RPCRequestPayload;\n\n      if (action !== actions.RPC_REQUEST) return;\n      if (!callID || !callName) return;\n      if (callName !== methodName) return;\n      if (connectionID !== rpcConnectionID) return;\n\n      const payload: RPCResolvePayload = {\n        action: actions.RPC_RESOLVE,\n        callID,\n        callName,\n        connectionID,\n        error: null,\n        result: null,\n      };\n\n      // when a host function returns transferable results to the remote, the\n      // transferables are assigned to a special symbol on each function's result\n      let transferables: Transferable[] | undefined = undefined;\n\n      // run function and return the results to the remote\n      try {\n        // Pass the remote object as the LAST argument to the local method\n        payload.result = await method(...args, remote);\n\n        if (payload.result && payload.result[SYM_TRANSFERABLES]) {\n          transferables = payload.result[SYM_TRANSFERABLES] ?? [];\n          delete payload.result[SYM_TRANSFERABLES];\n        }\n      } catch (error) {\n        payload.action = actions.RPC_REJECT;\n        payload.error = JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)));\n      }\n\n      postMessageToTarget(sendTo, payload, event?.origin, transferables);\n    }\n\n    // subscribe to the call event\n    addEventListener(listenTo, events.MESSAGE, handleCall);\n    listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleCall));\n  }\n\n  return () => listeners.forEach((unregister) => unregister());\n}\n\n/**\n * Create a function that will make an RPC request to the remote with some arguments.\n * Listen to an event that returns the results from the remote.\n *\n * @param rpcCallName\n * @param rpcConnectionID\n * @param event\n * @param listeners\n * @param guest\n *\n * @returns a promise with the result of the RPC\n */\nexport function createRPC(\n  rpcCallName: string,\n  rpcConnectionID: string,\n  event: RimlessEvent,\n  listeners: Array<() => void> = [],\n  listenTo: Environment,\n  sendTo: Target\n) {\n  return (...args: any[]) => {\n    return new Promise((resolve, reject) => {\n      const requestID = generateId();\n\n      // on RPC response\n      function handleResponse(event: any) {\n        const eventData = getEventData(event);\n        const { callID, connectionID, callName, result, error, action } = eventData as RPCResolvePayload;\n\n        if (!callID || !callName) return;\n        if (callName !== rpcCallName) return;\n        if (callID !== requestID) return;\n        if (connectionID !== rpcConnectionID) return;\n\n        // resolve the response\n        if (action === actions.RPC_RESOLVE) return resolve(result);\n        if (action === actions.RPC_REJECT) return reject(error);\n      }\n\n      // send the RPC request with arguments\n      const payload = {\n        action: actions.RPC_REQUEST,\n        args,\n        callID: requestID,\n        callName: rpcCallName,\n        connectionID: rpcConnectionID,\n      };\n\n      // if the arguments have transferables, post them as well\n      const transferables = args.reduce(\n        (transferables, arg) =>\n          arg[SYM_TRANSFERABLES]?.length ? transferables.concat(arg[SYM_TRANSFERABLES]) : transferables,\n        // @ts-expect-error: we know this is an array of transferables (if it exists)\n        args[SYM_TRANSFERABLES] ?? []\n      );\n\n      addEventListener(listenTo, events.MESSAGE, handleResponse);\n      listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleResponse));\n\n      postMessageToTarget(sendTo, payload, event?.origin, transferables);\n    });\n  };\n}\n\n/**\n * create an object based on the remote schema's methods. Functions in that object will\n * emit an event that will trigger the RPC on the remote.\n *\n * @param schema\n * @param methods\n * @param connectionID\n * @param event\n * @param guest\n */\nexport function registerRemoteMethods(\n  schema: Schema = {},\n  methodNames: Iterable<string> = [],\n  connectionID: string,\n  event: RimlessEvent,\n  listenTo: Environment,\n  sendTo: Target\n) {\n  const remote = { ...schema };\n  const listeners: Array<() => void> = [];\n\n  for (const methodName of methodNames) {\n    const rpc = createRPC(methodName, connectionID, event, listeners, listenTo, sendTo);\n    set(remote, methodName, rpc);\n  }\n\n  return {\n    remote,\n    unregisterRemote: () => listeners.forEach((unregister) => unregister()),\n  };\n}\n\n/**\n * This function is used by API schema declarations and remote function calls alike to\n * indicate which variables should be declared as transferable over `postMessage` calls.\n *\n * @param cb a function that takes a transfer function as an argument and returns an object\n *           (in the loose, `typeof foo === \"object\"` sense)\n * @return result the callback's return value, with an extra array of transferable objects\n *                assigned to rimless' private symbol `SYM_TRANSFERABLES`\n *\n * The `transfer(...)` function is called with an object to transfer; if there\n * are many objects to transfer, you may call it multiple times. It will always\n * return the input object. Calling `transfer` only modifies the callback\n * result, not the transferred object itself (or objects themselves).\n *\n * @example\n * host.connect({\n *   foo: (...args) => {\n *     const foo = new ArrayBuffer(8);\n *     return withTransferable((transfer) => transfer(foo));\n *   }),\n * });\n *\n * @example\n * host.remote.foo(withTransferable((transfer) => ({\n *   stream: transfer(new ReadableStream()),\n * })));\n */\nexport const withTransferable = <Transferable, Result extends object>(\n  cb: (transfer: <T extends Transferable>(transferable: T) => T) => Result\n) => {\n  const transferables: Transferable[] = [];\n  const transfer = <T extends Transferable>(transferable: T) => {\n    transferables.push(transferable);\n    return transferable;\n  };\n\n  const result = cb(transfer);\n\n  return Object.assign(result, { [SYM_TRANSFERABLES]: transferables });\n};\n","import {\n  extractMethods,\n  getEventData,\n  getTargetHost,\n  postMessageToTarget,\n  addEventListener,\n  removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, EventHandlers, events, Connection, Schema } from \"./types\";\n\nfunction connect(schema: Schema = {}, eventHandlers?: EventHandlers): Promise<Connection> {\n  return new Promise(async (resolve) => {\n    const localMethods = extractMethods(schema);\n    const sendTo = getTargetHost();\n    const listenTo = self || window;\n\n    // on handshake response\n    async function handleHandshakeResponse(event: any) {\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n\n      // register remote methods\n      const { remote, unregisterRemote } = registerRemoteMethods(\n        eventData.schema,\n        eventData.methodNames,\n        eventData.connectionID,\n        event,\n        listenTo,\n        sendTo,\n      );\n\n      // register local methods, passing the remote object\n      const unregisterLocal = registerLocalMethods(localMethods, eventData.connectionID, listenTo, sendTo, remote);\n\n      await eventHandlers?.onConnectionSetup?.(remote);\n\n      // send a HANDSHAKE REPLY to the host\n      const payload = {\n        action: actions.HANDSHAKE_REPLY,\n        connectionID: eventData.connectionID,\n      };\n\n      postMessageToTarget(sendTo, payload, event?.origin);\n\n      // close the connection and all listeners when called\n      const close = () => {\n        removeEventListener(listenTo, events.MESSAGE, handleHandshakeResponse);\n        unregisterRemote();\n        unregisterLocal();\n      };\n\n      // resolve connection object\n      const connection = { remote, close, id: eventData.connectionID };\n      return resolve(connection);\n    }\n\n    // subscribe to HANDSHAKE RESPONSE MESSAGES\n    addEventListener(listenTo, events.MESSAGE, handleHandshakeResponse);\n\n    const payload = {\n      action: actions.HANDSHAKE_REQUEST,\n      methodNames: Object.keys(localMethods),\n      schema: schema,\n    };\n\n    postMessageToTarget(sendTo, payload);\n  });\n}\n\nexport default {\n  connect,\n};\n","import {\n  addEventListener,\n  extractMethods,\n  generateId,\n  getEventData,\n  getOriginFromURL,\n  isNodeEnv,\n  isNodeWorker,\n  isWorkerLike,\n  postMessageToTarget,\n  removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, events, Guest, Connection, Connections, Schema } from \"./types\";\n\nconst connections: Connections = {};\n\nfunction isValidTarget(guest: Guest, event: any) {\n  // If it's a worker, we don't need to validate origin\n  if (isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker)) {\n    return true;\n  }\n\n  // For iframes, check origin and source\n  const iframe = guest as HTMLIFrameElement;\n  try {\n    const childURL = iframe.src;\n    const hasInlineContent = typeof iframe.srcdoc === \"string\" && iframe.srcdoc.length > 0;\n    const childOrigin = getOriginFromURL(childURL);\n    const hasProperOrigin = event.origin === childOrigin;\n    const hasProperSource = event.source === iframe.contentWindow;\n\n    // For inline iframes (srcdoc/about:blank) we can only rely on source matching\n    if (hasInlineContent || childURL === \"about:blank\") {\n      return hasProperSource;\n    }\n\n    return (hasProperOrigin && hasProperSource) || !childURL;\n  } catch (e) {\n    console.warn(\"Error checking iframe target:\", e);\n    return false;\n  }\n}\n\n/**\n * Perform a handshake with the target iframe, when the handshake is confirmed\n * resolve the connection object containing RPCs and properties\n *\n * @param guest\n * @param schema\n * @returns Promise\n */\nfunction connect(guest: Guest, schema: Schema = {}): Promise<Connection> {\n  if (!guest) throw new Error(\"a target is required\");\n\n  const guestIsWorker = isWorkerLike(guest);\n\n  const listenTo = guestIsWorker || isNodeEnv() ? (guest as Worker) : window;\n\n  return new Promise((resolve) => {\n    const connectionID = generateId();\n\n    // on handshake request\n    function handleHandshake(event: any) {\n      const sendTo = guestIsWorker || isNodeEnv() ? (guest as Worker) : event.source;\n\n      if (!guestIsWorker && !isNodeEnv() && !isValidTarget(guest, event)) return;\n\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REQUEST) return;\n      if (connections[connectionID]) return;\n\n      // Extract local methods first (doesn't need remote yet)\n      const localMethods = extractMethods(schema);\n\n      // Register remote methods first to get the remote object\n      const { remote, unregisterRemote } = registerRemoteMethods(\n        eventData.schema,\n        eventData.methodNames,\n        connectionID,\n        event,\n        listenTo,\n        sendTo,\n      );\n\n      // Now register local methods, passing the remote object\n      const unregisterLocal = registerLocalMethods(localMethods, connectionID, listenTo, sendTo, remote);\n\n      // send a HANDSHAKE REPLY to the guest\n      const payload = {\n        action: actions.HANDSHAKE_REPLY,\n        connectionID,\n        schema: schema,\n        methodNames: Object.keys(localMethods),\n      };\n\n      postMessageToTarget(sendTo, payload, event.origin);\n\n      // close the connection and all listeners when called\n      const close = () => {\n        delete connections[connectionID];\n        removeEventListener(listenTo, events.MESSAGE, handleHandshake);\n        removeEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n        unregisterRemote();\n        unregisterLocal();\n        if (guestIsWorker) {\n          (guest as Worker).terminate();\n        }\n      };\n\n      const connection: Connection = { remote, close, id: connectionID };\n      connections[connectionID] = connection;\n    }\n\n    // subscribe to HANDSHAKE MESSAGES\n    addEventListener(listenTo, events.MESSAGE, handleHandshake);\n\n    // on handshake reply\n    function handleHandshakeReply(event: any) {\n      const eventData = getEventData(event);\n      if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n      if (connectionID !== eventData.connectionID) return;\n\n      if (!connections[eventData.connectionID]) {\n        throw new Error(\"Rimless Error: No connection found for this connectionID\");\n      }\n\n      return resolve(connections[eventData.connectionID]);\n    }\n\n    addEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n  });\n}\n\nexport default {\n  connect,\n};\n"],"names":["isWorker","isNodeEnv","isIframe","extractMethods","obj","methods","parse","path","prop","propPath","urlRegex","ports","getOriginFromURL","url","regexResult","protocol","hostname","port","portSuffix","set","value","pathArray","key","current","i","generateId","length","chars","result","parentPort","getTargetHost","postMessageToTarget","target","message","origin","transferables","isNodeWorker","guest","isWorkerLike","addEventListener","event","handler","removeEventListener","getEventData","events","actions","SYM_TRANSFERABLES","registerLocalMethods","rpcConnectionID","listenTo","sendTo","remote","listeners","methodName","method","handleCall","eventData","action","callID","connectionID","callName","args","payload","error","unregister","createRPC","rpcCallName","resolve","reject","requestID","handleResponse","arg","registerRemoteMethods","schema","methodNames","rpc","withTransferable","cb","transferable","connect","eventHandlers","localMethods","handleHandshakeResponse","unregisterRemote","unregisterLocal","connection","connections","isValidTarget","iframe","childURL","hasInlineContent","childOrigin","hasProperOrigin","hasProperSource","guestIsWorker","handleHandshake","handleHandshakeReply","host"],"mappings":"qCAOO,SAASA,GAAoB,CAClC,OAAO,OAAO,OAAW,KAAe,OAAO,KAAS,GAC1D,CAOO,SAASC,GAAqB,CACnC,OAAO,OAAO,QAAY,KAAe,CAAC,CAAE,QAAgB,UAAU,IACxE,CAOO,SAASC,GAAW,CACzB,OAAO,OAAO,OAAS,OAAO,GAChC,CAQO,SAASC,EAAeC,EAAU,CACvC,MAAMC,EAAiD,CAAA,EACvD,OAAC,SAASC,EAAMF,EAAUG,EAAO,GAAI,CACnC,OAAO,KAAKH,CAAG,EAAE,QAASI,GAAS,CACjC,MAAMC,EAAWF,EAAO,GAAGA,CAAI,IAAIC,CAAI,GAAKA,EACxCJ,EAAII,CAAI,IAAM,OAAOJ,EAAII,CAAI,CAAC,GAChCF,EAAMF,EAAII,CAAI,EAAGC,CAAQ,EAEvB,OAAOL,EAAII,CAAI,GAAM,aACvBH,EAAQI,CAAQ,EAAIL,EAAII,CAAI,EAC5B,OAAOJ,EAAII,CAAI,EAEnB,CAAC,CACH,EAAGJ,CAAG,EACCC,CACT,CAEA,MAAMK,EAAW,0CACXC,EAAa,CAAE,QAAS,KAAM,SAAU,KAAA,EAOvC,SAASC,EAAiBC,EAAoB,CACnD,GAAI,CAACA,EAAK,OAAO,KAEjB,MAAMC,EAAcJ,EAAS,KAAKG,CAAG,EACrC,GAAI,CAACC,EAAa,OAAO,KAEzB,KAAM,CAAA,CAAGC,EAAW,QAASC,EAAA,CAAYC,CAAI,EAAIH,EAGjD,GAAIC,IAAa,QACf,MAAO,UAIT,MAAMG,EAAaD,GAAQA,IAASN,EAAMI,CAAQ,EAAI,IAAIE,CAAI,GAAK,GACnE,MAAO,GAAGF,CAAQ,KAAKC,CAAQ,GAAGE,CAAU,EAC9C,CAgBO,SAASC,EAAIf,EAAUG,EAAoCa,EAAiB,CACjF,GAAI,CAAChB,GAAO,OAAOA,GAAQ,SAAU,OAAOA,EAE5C,MAAMiB,EAAY,MAAM,QAAQd,CAAI,EAAIA,EAAOA,EAAK,MAAM,GAAG,EAAE,IAAKe,GAASA,EAAI,MAAM,OAAO,EAAI,OAAOA,CAAG,EAAIA,CAAI,EAEpH,IAAIC,EAAUnB,EAEd,QAASoB,EAAI,EAAGA,EAAIH,EAAU,OAAQG,IAAK,CACzC,MAAMF,EAAMD,EAAUG,CAAC,EAEnBA,IAAMH,EAAU,OAAS,EAC3BE,EAAQD,CAAG,EAAIF,IAEX,CAACG,EAAQD,CAAG,GAAK,OAAOC,EAAQD,CAAG,GAAM,YAC3CC,EAAQD,CAAG,EAAI,OAAOD,EAAUG,EAAI,CAAC,GAAM,SAAW,CAAA,EAAK,CAAA,GAE7DD,EAAUA,EAAQD,CAAG,EAEzB,CAEA,OAAOlB,CACT,CAEO,SAASqB,EAAWC,EAAiB,GAAY,CACtD,MAAMC,EAAQ,iEACd,IAAIC,EAAS,GACb,QAASJ,EAAI,EAAGA,EAAIE,EAAQF,IAC1BI,GAAUD,EAAM,OAAO,KAAK,MAAM,KAAK,OAAA,EAAWA,EAAM,MAAM,CAAC,EAEjE,OAAOC,CACT,CAEA,IAAIC,EAAkB,KAEtB,GAAI5B,IACF,GAAI,CAGF4B,EADsB,QAAQ,gBAAgB,EACnB,UAC7B,MAAY,CAEZ,CAOK,SAASC,GAAqB,CACnC,GAAI7B,IACF,OAAO4B,EAGT,GAAI7B,IACF,OAAO,KAGT,GAAIE,IACF,OAAO,OAAO,OAGhB,MAAM,IAAI,MAAM,uCAAuC,CACzD,CASO,SAAS6B,EACdC,EACAC,EACAC,EACAC,EACM,CACN,GAAI,CAACH,EACH,MAAM,IAAI,MAAM,oDAAoD,EAItE,GAAI/B,EAAA,GAAe+B,IAAWH,EAAY,CACxCG,EAAO,YAAYC,EAAS,CAAE,SAAUE,EAAe,EACvD,MACF,CAGA,GAAInC,IAAY,CACdgC,EAAO,YAAYC,EAAS,CAAE,SAAUE,EAAe,EACvD,MACF,CAGA,GAAIH,EAAO,YAAa,CACtBA,EAAO,YAAYC,EAAS,CAAE,aAAcC,GAAU,IAAK,SAAUC,EAAe,EACpF,MACF,CAEA,MAAM,IAAI,MAAM,+CAA+C,CACjE,CAEO,SAASC,EAAaC,EAA4C,CACvE,OAAOR,IAAe,MAAQQ,IAAUR,CAC1C,CAEO,SAASS,EAAaD,EAAmC,CAC9D,OAAOD,EAAaC,CAAK,GAAM,OAAO,OAAW,KAAeA,aAAiB,MACnF,CAEO,SAASE,EAAiBP,EAAgBQ,EAAeC,EAA6C,CACvGL,EAAaJ,CAAM,EACrBA,EAAO,GAAGQ,EAAOC,CAAO,EACf,qBAAsBT,GAC/BA,EAAO,iBAAiBQ,EAAOC,CAAO,CAE1C,CAEO,SAASC,EAAoBV,EAAgBQ,EAAeC,EAA6C,CAC1GL,EAAaJ,CAAM,EACrBA,EAAO,IAAIQ,EAAOC,CAAO,EAChB,wBAAyBT,GAClCA,EAAO,oBAAoBQ,EAAOC,CAAO,CAE7C,CAOO,SAASE,EAAaH,EAAY,CACvC,OAAOA,EAAM,MAAQA,CACvB,CCxNO,IAAKI,GAAAA,IACVA,EAAA,QAAU,UADAA,IAAAA,GAAA,CAAA,CAAA,EAIAC,GAAAA,IACVA,EAAA,kBAAoB,4BACpBA,EAAA,gBAAkB,0BAClBA,EAAA,YAAc,sBACdA,EAAA,YAAc,sBACdA,EAAA,WAAa,qBALHA,IAAAA,GAAA,CAAA,CAAA,ECAZ,MAAMC,EAAoB,OAAA,EAcnB,SAASC,EACd1C,EAAmD,CAAA,EACnD2C,EACAC,EACAC,EACAC,EACA,CACA,MAAMC,EAAmB,CAAA,EACzB,SAAW,CAACC,EAAYC,CAAM,IAAK,OAAO,QAAQjD,CAAO,EAAG,CAE1D,eAAekD,EAAWf,EAAY,CACpC,MAAMgB,EAAYb,EAAaH,CAAK,EAC9B,CAAE,OAAAiB,EAAQ,OAAAC,EAAQ,aAAAC,EAAc,SAAAC,EAAU,KAAAC,EAAO,CAAA,GAAOL,EAK9D,GAHIC,IAAWZ,EAAQ,aACnB,CAACa,GAAU,CAACE,GACZA,IAAaP,GACbM,IAAiBX,EAAiB,OAEtC,MAAMc,EAA6B,CACjC,OAAQjB,EAAQ,YAChB,OAAAa,EACA,SAAAE,EACA,aAAAD,EACA,MAAO,KACP,OAAQ,IAAA,EAKV,IAAIxB,EAGJ,GAAI,CAEF2B,EAAQ,OAAS,MAAMR,EAAO,GAAGO,EAAMV,CAAM,EAEzCW,EAAQ,QAAUA,EAAQ,OAAOhB,CAAiB,IACpDX,EAAgB2B,EAAQ,OAAOhB,CAAiB,GAAK,CAAA,EACrD,OAAOgB,EAAQ,OAAOhB,CAAiB,EAE3C,OAASiB,EAAO,CACdD,EAAQ,OAASjB,EAAQ,WACzBiB,EAAQ,MAAQ,KAAK,MAAM,KAAK,UAAUC,EAAO,OAAO,oBAAoBA,CAAK,CAAC,CAAC,CACrF,CAEAhC,EAAoBmB,EAAQY,EAAStB,GAAO,OAAQL,CAAa,CACnE,CAGAI,EAAiBU,EAAUL,EAAO,QAASW,CAAU,EACrDH,EAAU,KAAK,IAAMV,EAAoBO,EAAUL,EAAO,QAASW,CAAU,CAAC,CAChF,CAEA,MAAO,IAAMH,EAAU,QAASY,GAAeA,GAAY,CAC7D,CAcO,SAASC,EACdC,EACAlB,EACAR,EACAY,EAA+B,CAAA,EAC/BH,EACAC,EACA,CACA,MAAO,IAAIW,IACF,IAAI,QAAQ,CAACM,EAASC,IAAW,CACtC,MAAMC,EAAY5C,EAAA,EAGlB,SAAS6C,EAAe9B,EAAY,CAClC,MAAMgB,EAAYb,EAAaH,CAAK,EAC9B,CAAE,OAAAkB,EAAQ,aAAAC,EAAc,SAAAC,EAAU,OAAAhC,EAAQ,MAAAmC,EAAO,OAAAN,GAAWD,EAElE,GAAI,GAACE,GAAU,CAACE,IACZA,IAAaM,GACbR,IAAWW,GACXV,IAAiBX,EAGrB,IAAIS,IAAWZ,EAAQ,YAAa,OAAOsB,EAAQvC,CAAM,EACzD,GAAI6B,IAAWZ,EAAQ,WAAY,OAAOuB,EAAOL,CAAK,EACxD,CAGA,MAAMD,EAAU,CACd,OAAQjB,EAAQ,YAChB,KAAAgB,EACA,OAAQQ,EACR,SAAUH,EACV,aAAclB,CAAA,EAIVb,EAAgB0B,EAAK,OACzB,CAAC1B,EAAeoC,IACdA,EAAIzB,CAAiB,GAAG,OAASX,EAAc,OAAOoC,EAAIzB,CAAiB,CAAC,EAAIX,EAElF0B,EAAKf,CAAiB,GAAK,CAAA,CAAC,EAG9BP,EAAiBU,EAAUL,EAAO,QAAS0B,CAAc,EACzDlB,EAAU,KAAK,IAAMV,EAAoBO,EAAUL,EAAO,QAAS0B,CAAc,CAAC,EAElFvC,EAAoBmB,EAAQY,EAAStB,GAAO,OAAQL,CAAa,CACnE,CAAC,CAEL,CAYO,SAASqC,EACdC,EAAiB,CAAA,EACjBC,EAAgC,CAAA,EAChCf,EACAnB,EACAS,EACAC,EACA,CACA,MAAMC,EAAS,CAAE,GAAGsB,CAAA,EACdrB,EAA+B,CAAA,EAErC,UAAWC,KAAcqB,EAAa,CACpC,MAAMC,EAAMV,EAAUZ,EAAYM,EAAcnB,EAAOY,EAAWH,EAAUC,CAAM,EAClF/B,EAAIgC,EAAQE,EAAYsB,CAAG,CAC7B,CAEA,MAAO,CACL,OAAAxB,EACA,iBAAkB,IAAMC,EAAU,QAASY,GAAeA,GAAY,CAAA,CAE1E,CA6BO,MAAMY,EACXC,GACG,CACH,MAAM1C,EAAgC,CAAA,EAMhCP,EAASiD,EAL2BC,IACxC3C,EAAc,KAAK2C,CAAY,EACxBA,EAGiB,EAE1B,OAAO,OAAO,OAAOlD,EAAQ,CAAE,CAACkB,CAAiB,EAAGX,EAAe,CACrE,EChNA,SAAS4C,EAAQN,EAAiB,CAAA,EAAIO,EAAoD,CACxF,OAAO,IAAI,QAAQ,MAAOb,GAAY,CACpC,MAAMc,EAAe9E,EAAesE,CAAM,EACpCvB,EAASpB,EAAA,EACTmB,EAAW,MAAQ,OAGzB,eAAeiC,EAAwB1C,EAAY,CACjD,MAAMgB,EAAYb,EAAaH,CAAK,EACpC,GAAIgB,GAAW,SAAWX,EAAQ,gBAAiB,OAGnD,KAAM,CAAE,OAAAM,EAAQ,iBAAAgC,CAAA,EAAqBX,EACnChB,EAAU,OACVA,EAAU,YACVA,EAAU,aACVhB,EACAS,EACAC,CAAA,EAIIkC,EAAkBrC,EAAqBkC,EAAczB,EAAU,aAAcP,EAAUC,EAAQC,CAAM,EAE3G,MAAM6B,GAAe,oBAAoB7B,CAAM,EAG/C,MAAMW,EAAU,CACd,OAAQjB,EAAQ,gBAChB,aAAcW,EAAU,YAAA,EAG1BzB,EAAoBmB,EAAQY,EAAStB,GAAO,MAAM,EAUlD,MAAM6C,EAAa,CAAE,OAAAlC,EAAQ,MAPf,IAAM,CAClBT,EAAoBO,EAAUL,EAAO,QAASsC,CAAuB,EACrEC,EAAA,EACAC,EAAA,CACF,EAGoC,GAAI5B,EAAU,YAAA,EAClD,OAAOW,EAAQkB,CAAU,CAC3B,CAGA9C,EAAiBU,EAAUL,EAAO,QAASsC,CAAuB,EAElE,MAAMpB,EAAU,CACd,OAAQjB,EAAQ,kBAChB,YAAa,OAAO,KAAKoC,CAAY,EACrC,OAAAR,CAAA,EAGF1C,EAAoBmB,EAAQY,CAAO,CACrC,CAAC,CACH,CAEA,MAAAzB,EAAe,CAAA,QACb0C,CACF,ECzDMO,EAA2B,CAAA,EAEjC,SAASC,EAAclD,EAAcG,EAAY,CAE/C,GAAIJ,EAAaC,CAAK,GAAM,OAAO,OAAW,KAAeA,aAAiB,OAC5E,MAAO,GAIT,MAAMmD,EAASnD,EACf,GAAI,CACF,MAAMoD,EAAWD,EAAO,IAClBE,EAAmB,OAAOF,EAAO,QAAW,UAAYA,EAAO,OAAO,OAAS,EAC/EG,EAAc/E,EAAiB6E,CAAQ,EACvCG,EAAkBpD,EAAM,SAAWmD,EACnCE,EAAkBrD,EAAM,SAAWgD,EAAO,cAGhD,OAAIE,GAAoBD,IAAa,cAC5BI,EAGDD,GAAmBC,GAAoB,CAACJ,CAClD,OAAS,EAAG,CACV,eAAQ,KAAK,gCAAiC,CAAC,EACxC,EACT,CACF,CAUA,SAASV,EAAQ1C,EAAcoC,EAAiB,GAAyB,CACvE,GAAI,CAACpC,EAAO,MAAM,IAAI,MAAM,sBAAsB,EAElD,MAAMyD,EAAgBxD,EAAaD,CAAK,EAElCY,EAAW6C,GAAiB7F,EAAA,EAAeoC,EAAmB,OAEpE,OAAO,IAAI,QAAS8B,GAAY,CAC9B,MAAMR,EAAelC,EAAA,EAGrB,SAASsE,EAAgBvD,EAAY,CACnC,MAAMU,EAAS4C,GAAiB7F,EAAA,EAAeoC,EAAmBG,EAAM,OAExE,GAAI,CAACsD,GAAiB,CAAC7F,EAAA,GAAe,CAACsF,EAAclD,EAAOG,CAAK,EAAG,OAEpE,MAAMgB,EAAYb,EAAaH,CAAK,EAEpC,GADIgB,GAAW,SAAWX,EAAQ,mBAC9ByC,EAAY3B,CAAY,EAAG,OAG/B,MAAMsB,EAAe9E,EAAesE,CAAM,EAGpC,CAAE,OAAAtB,EAAQ,iBAAAgC,CAAA,EAAqBX,EACnChB,EAAU,OACVA,EAAU,YACVG,EACAnB,EACAS,EACAC,CAAA,EAIIkC,EAAkBrC,EAAqBkC,EAActB,EAAcV,EAAUC,EAAQC,CAAM,EAG3FW,EAAU,CACd,OAAQjB,EAAQ,gBAChB,aAAAc,EACA,OAAAc,EACA,YAAa,OAAO,KAAKQ,CAAY,CAAA,EAGvClD,EAAoBmB,EAAQY,EAAStB,EAAM,MAAM,EAcjD,MAAM6C,EAAyB,CAAE,OAAAlC,EAAQ,MAX3B,IAAM,CAClB,OAAOmC,EAAY3B,CAAY,EAC/BjB,EAAoBO,EAAUL,EAAO,QAASmD,CAAe,EAC7DrD,EAAoBO,EAAUL,EAAO,QAASoD,CAAoB,EAClEb,EAAA,EACAC,EAAA,EACIU,GACDzD,EAAiB,UAAA,CAEtB,EAEgD,GAAIsB,CAAA,EACpD2B,EAAY3B,CAAY,EAAI0B,CAC9B,CAGA9C,EAAiBU,EAAUL,EAAO,QAASmD,CAAe,EAG1D,SAASC,EAAqBxD,EAAY,CACxC,MAAMgB,EAAYb,EAAaH,CAAK,EACpC,GAAIgB,GAAW,SAAWX,EAAQ,iBAC9Bc,IAAiBH,EAAU,aAE/B,IAAI,CAAC8B,EAAY9B,EAAU,YAAY,EACrC,MAAM,IAAI,MAAM,0DAA0D,EAG5E,OAAOW,EAAQmB,EAAY9B,EAAU,YAAY,CAAC,EACpD,CAEAjB,EAAiBU,EAAUL,EAAO,QAASoD,CAAoB,CACjE,CAAC,CACH,CAEA,MAAAC,EAAe,CACb,QAAAlB,CACF"}

package/lib/rpc.d.ts

@@ -1,14 +1,19 @@
 import { Environment, RimlessEvent, Schema, Target } from './types';
+/** Private symbol to which we will assign transferable objects */
+declare const SYM_TRANSFERABLES: unique symbol;
 /**
- * for each function in the schema
+ * for each function in methods
  * 1. subscribe to an event that the remote can call
  * 2. listen for calls from the remote. When called execute the function and emit the results.
  *
- * @param methods an array of method ids from the local schema
+ * @param methods an object of method ids : methods from the local schema
  * @param rpcConnectionID
+ * @param listenTo Environment to listen for incoming messages
+ * @param sendTo Target to send outgoing messages
+ * @param remote The remote API object for the current connection
  * @return a function to cancel all subscriptions
  */
-export declare function registerLocalMethods(schema: Schema | undefined, methods: string[] | undefined, rpcConnectionID: string, listenTo: Environment, sendTo: Target): () => void;
+export declare function registerLocalMethods(methods: Record<string, (...args: any[]) => any> | undefined, rpcConnectionID: string, listenTo: Environment, sendTo: Target, remote: Schema): () => void;
 /**
  * Create a function that will make an RPC request to the remote with some arguments.
  * Listen to an event that returns the results from the remote.
@@ -21,9 +26,9 @@ export declare function registerLocalMethods(schema: Schema | undefined, methods
  *
  * @returns a promise with the result of the RPC
  */
-export declare function createRPC(rpcCallName: string, rpcConnectionID: string, event: RimlessEvent, listeners: Array<() => void> | undefined, listenTo: Environment, sendTo: Target): (...args: any) => Promise<unknown>;
+export declare function createRPC(rpcCallName: string, rpcConnectionID: string, event: RimlessEvent, listeners: Array<() => void> | undefined, listenTo: Environment, sendTo: Target): (...args: any[]) => Promise<unknown>;
 /**
- * create an object based on the remote schema and methods. Functions in that object will
+ * create an object based on the remote schema's methods. Functions in that object will
  * emit an event that will trigger the RPC on the remote.
  *
  * @param schema
@@ -32,9 +37,40 @@ export declare function createRPC(rpcCallName: string, rpcConnectionID: string,
  * @param event
  * @param guest
  */
-export declare function registerRemoteMethods(schema: Schema | undefined, methods: string[] | undefined, connectionID: string, event: RimlessEvent, listenTo: Environment, sendTo: Target): {
+export declare function registerRemoteMethods(schema: Schema | undefined, methodNames: Iterable<string> | undefined, connectionID: string, event: RimlessEvent, listenTo: Environment, sendTo: Target): {
     remote: {
         [x: string]: any;
     };
     unregisterRemote: () => void;
 };
+/**
+ * This function is used by API schema declarations and remote function calls alike to
+ * indicate which variables should be declared as transferable over `postMessage` calls.
+ *
+ * @param cb a function that takes a transfer function as an argument and returns an object
+ *           (in the loose, `typeof foo === "object"` sense)
+ * @return result the callback's return value, with an extra array of transferable objects
+ *                assigned to rimless' private symbol `SYM_TRANSFERABLES`
+ *
+ * The `transfer(...)` function is called with an object to transfer; if there
+ * are many objects to transfer, you may call it multiple times. It will always
+ * return the input object. Calling `transfer` only modifies the callback
+ * result, not the transferred object itself (or objects themselves).
+ *
+ * @example
+ * host.connect({
+ *   foo: (...args) => {
+ *     const foo = new ArrayBuffer(8);
+ *     return withTransferable((transfer) => transfer(foo));
+ *   }),
+ * });
+ *
+ * @example
+ * host.remote.foo(withTransferable((transfer) => ({
+ *   stream: transfer(new ReadableStream()),
+ * })));
+ */
+export declare const withTransferable: <Transferable, Result extends object>(cb: (transfer: <T extends Transferable>(transferable: T) => T) => Result) => Result & {
+    [SYM_TRANSFERABLES]: Transferable[];
+};
+export {};

package/lib/types.d.ts

@@ -30,13 +30,13 @@ export interface RimlessEvent extends EventListener {
 export interface HandshakeRequestPayload {
     action: actions.HANDSHAKE_REQUEST;
     connectionID: string;
-    methods: string[];
+    methodNames: string[];
     schema: Schema;
 }
 export interface HandshakeConfirmationPayload {
     action: actions.HANDSHAKE_REPLY;
     connectionID: string;
-    methods: string[];
+    methodNames: string[];
     schema: Schema;
 }
 export interface RPCRequestPayload {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rimless",
   "author": "Aurélien Franky",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "license": "MIT",
   "homepage": "https://github.com/au-re/rimless",
   "description": "event base communication made easy with a promise-based API wrapping `postMessage`",
@@ -15,10 +15,11 @@
   "scripts": {
     "dev": "vite",
     "format": "npx prettier --check \"./src/**/*.{js,jsx,ts,tsx,css,scss,html,md}\" --write",
-    "build": "tsc -b && vite build",
+    "build": "tsc -b && tsc --noEmit -p tsconfig.test.json && vite build",
     "prepublishOnly": "npm run build",
     "lint": "eslint . --ignore-pattern='lib/*' --ignore-pattern='lib/**' --ignore-pattern '**/*.min.js'",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "preview": "vite preview",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
@@ -29,32 +30,30 @@
     "url": "https://github.com/au-re/rimless.git"
   },
   "devDependencies": {
-    "@chromatic-com/storybook": "^1.7.0",
-    "@eslint/js": "^9.9.0",
-    "@storybook/addon-essentials": "^8.2.9",
-    "@storybook/addon-interactions": "^8.2.9",
-    "@storybook/addon-links": "^8.2.9",
-    "@storybook/addon-onboarding": "^8.2.9",
-    "@storybook/blocks": "^8.2.9",
-    "@storybook/react": "^8.2.9",
-    "@storybook/react-vite": "^8.2.9",
-    "@storybook/test": "^8.2.9",
+    "@chromatic-com/storybook": "^4.1.1",
+    "@eslint/js": "^9.38.0",
+    "@storybook/addon-docs": "^9.1.15",
+    "@storybook/addon-links": "^9.1.15",
+    "@storybook/addon-onboarding": "^9.1.15",
+    "@storybook/react-vite": "^9.1.15",
     "@types/lodash.set": "^4.3.9",
-    "@types/node": "^22.7.5",
-    "@vitejs/plugin-react": "^4.3.1",
-    "eslint": "^9.12.0",
-    "globals": "^15.11.0",
-    "happy-dom": "^15.7.4",
-    "prettier": "^3.5.3",
-    "storybook": "^8.2.9",
-    "terser": "^5.34.1",
-    "typescript": "^5.5.3",
-    "typescript-eslint": "^8.8.1",
-    "vite": "^6.3.3",
-    "vite-plugin-dts": "^4.2.4",
-    "vitest": "^2.0.5"
+    "@types/node": "^24.9.1",
+    "@vitejs/plugin-react": "^5.1.0",
+    "@vitest/coverage-v8": "^4.0.3",
+    "eslint": "^9.38.0",
+    "eslint-plugin-storybook": "9.1.15",
+    "globals": "^16.4.0",
+    "happy-dom": "^20.0.8",
+    "prettier": "^3.6.2",
+    "storybook": "^9.1.15",
+    "terser": "^5.44.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.2",
+    "vite": "^7.1.12",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.3"
   },
   "volta": {
-    "node": "18.19.0"
+    "node": "22.21.0"
   }
 }