rimless 0.5.0 → 0.6.0

package/README.md

@@ -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
@@ -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.

package/lib/guest.d.ts

@@ -0,0 +1,6 @@
+import { EventHandlers, Connection, Schema } from './types';
+declare function connect(schema?: Schema, eventHandlers?: EventHandlers): Promise<Connection>;
+declare const _default: {
+    connect: typeof connect;
+};
+export default _default;

package/lib/helpers.d.ts

@@ -0,0 +1,57 @@
+import { Guest, NodeWorker, Target, WorkerLike } from './types';
+/**
+ * check if run in a webworker
+ *
+ * @returns boolean
+ */
+export declare function isWorker(): boolean;
+/**
+ * check if run in a Node.js environment
+ *
+ * @returns boolean
+ */
+export declare function isNodeEnv(): boolean;
+/**
+ * check if run in an iframe
+ *
+ * @returns boolean
+ */
+export declare function isIframe(): boolean;
+/**
+ * we cannot send functions through postMessage
+ * extract the path to all functions in the schema
+ *
+ * @param obj
+ */
+export declare function extractMethods(obj: any): Record<string, (...args: any) => any>;
+/**
+ * convert the url into an origin (remove paths)
+ *
+ * @param url
+ */
+export declare function getOriginFromURL(url: string | null): string | null;
+export declare function get(obj: any, path: string | Array<string | number>, defaultValue?: any): any;
+export declare function set(obj: any, path: string | (string | number)[], value: any): any;
+export declare function generateId(length?: number): string;
+/**
+ * Get the appropriate target host for messaging based on the current environment
+ * @returns The messaging target for the current environment
+ */
+export declare function getTargetHost(): any;
+/**
+ * Send a message to a target, handling different environments (iframe, web worker, node worker)
+ * @param target The target to send the message to
+ * @param message The message to send
+ * @param origin Optional origin for iframe communication
+ */
+export declare function postMessageToTarget(target: Target, message: any, origin?: string): 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;
+export declare function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject): void;
+/**
+ * Normalize message event data across Web and Node.js environments
+ * In web, data is in event.data
+ * In Node.js, the event itself contains the data
+ */
+export declare function getEventData(event: any): any;

package/lib/host.d.ts

@@ -0,0 +1,14 @@
+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 schema
+ * @returns Promise
+ */
+declare function connect(guest: Guest, schema?: Schema): Promise<Connection>;
+declare const _default: {
+    connect: typeof connect;
+};
+export default _default;

package/lib/index.d.ts

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

package/lib/rimless.js

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

package/lib/rimless.js.map

@@ -0,0 +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 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 */\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  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/**\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      // 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        const result = await method(...args, remote);\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'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","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 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      // 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        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","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","isNodeWorker","guest","isWorkerLike","addEventListener","event","handler","removeEventListener","getEventData","events","actions","registerLocalMethods","rpcConnectionID","listenTo","sendTo","remote","listeners","methodName","method","handleCall","eventData","action","callID","connectionID","callName","args","payload","error","unregister","createRPC","rpcCallName","resolve","reject","requestID","handleResponse","registerRemoteMethods","schema","methodNames","rpc","connect","eventHandlers","localMethods","handleHandshakeResponse","unregisterRemote","unregisterLocal","connection","connections","isValidTarget","iframe","childURL","childOrigin","hasProperOrigin","hasProperSource","guestIsWorker","handleHandshake","handleHandshakeReply","host"],"mappings":"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"}

package/lib/rimless.min.js

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

package/lib/rimless.min.js.map

@@ -0,0 +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 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 */\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  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/**\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      // 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        const result = await method(...args, remote);\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'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","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 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      // 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        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","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","isNodeWorker","guest","isWorkerLike","addEventListener","event","handler","removeEventListener","getEventData","events","actions","registerLocalMethods","rpcConnectionID","listenTo","sendTo","remote","listeners","methodName","method","handleCall","eventData","action","callID","connectionID","callName","args","payload","error","unregister","createRPC","rpcCallName","resolve","reject","requestID","handleResponse","registerRemoteMethods","schema","methodNames","rpc","connect","eventHandlers","localMethods","handleHandshakeResponse","unregisterRemote","unregisterLocal","connection","connections","isValidTarget","iframe","childURL","childOrigin","hasProperOrigin","hasProperSource","e","guestIsWorker","handleHandshake","handleHandshakeReply","host"],"mappings":"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"}

package/lib/rpc.d.ts

@@ -0,0 +1,43 @@
+import { Environment, RimlessEvent, Schema, Target } from './types';
+/**
+ * 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 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(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.
+ *
+ * @param rpcCallName
+ * @param rpcConnectionID
+ * @param event
+ * @param listeners
+ * @param guest
+ *
+ * @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>;
+/**
+ * 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
+ * @param methods
+ * @param connectionID
+ * @param event
+ * @param guest
+ */
+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;
+};

package/lib/types.d.ts

@@ -0,0 +1,62 @@
+export interface NodeWorker {
+    on(event: string, handler: any): void;
+    off(event: string, handler: any): void;
+    postMessage(message: any): void;
+    terminate(): void;
+}
+export type WorkerLike = Worker | NodeWorker;
+export declare enum events {
+    MESSAGE = "message"
+}
+export declare enum actions {
+    HANDSHAKE_REQUEST = "RIMLESS/HANDSHAKE_REQUEST",
+    HANDSHAKE_REPLY = "RIMLESS/HANDSHAKE_REPLY",
+    RPC_REQUEST = "RIMLESS/RPC_REQUEST",
+    RPC_RESOLVE = "RIMLESS/RPC_RESOLVE",
+    RPC_REJECT = "RIMLESS/RPC_REJECT"
+}
+export type Schema = Record<string, any>;
+export interface Connection {
+    id: string;
+    remote: Schema;
+    close: () => void;
+}
+export type Connections = Record<string, Connection>;
+export interface RimlessEvent extends EventListener {
+    source?: Window;
+    origin?: string;
+    data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;
+}
+export interface HandshakeRequestPayload {
+    action: actions.HANDSHAKE_REQUEST;
+    connectionID: string;
+    methodNames: string[];
+    schema: Schema;
+}
+export interface HandshakeConfirmationPayload {
+    action: actions.HANDSHAKE_REPLY;
+    connectionID: string;
+    methodNames: string[];
+    schema: Schema;
+}
+export interface RPCRequestPayload {
+    action: actions.RPC_REQUEST;
+    args: any[];
+    callID: string;
+    callName: string;
+    connectionID: string;
+}
+export interface RPCResolvePayload {
+    action: actions.RPC_RESOLVE | actions.RPC_REJECT;
+    result?: any | null;
+    error?: Error | null;
+    callID: string;
+    callName: string;
+    connectionID: string;
+}
+export interface EventHandlers {
+    onConnectionSetup: (remote: Schema) => Promise<void>;
+}
+export type Guest = WorkerLike | HTMLIFrameElement;
+export type Target = Window | WorkerLike;
+export type Environment = Window | WorkerLike;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rimless",
   "author": "Aurélien Franky",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "license": "MIT",
   "homepage": "https://github.com/au-re/rimless",
   "description": "event base communication made easy with a promise-based API wrapping `postMessage`",
@@ -16,6 +16,7 @@
     "dev": "vite",
     "format": "npx prettier --check \"./src/**/*.{js,jsx,ts,tsx,css,scss,html,md}\" --write",
     "build": "tsc -b && vite build",
+    "prepublishOnly": "npm run build",
     "lint": "eslint . --ignore-pattern='lib/*' --ignore-pattern='lib/**' --ignore-pattern '**/*.min.js'",
     "test": "vitest run",
     "preview": "vite preview",