rimless 0.5.0 → 0.5.1

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): string[];
+/**
+ * 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,258 @@
+function I() {
+  return typeof window > "u" && typeof self < "u";
+}
+function y() {
+  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 (y())
+  try {
+    w = require("worker_threads").parentPort;
+  } catch {
+  }
+function $() {
+  if (y())
+    return w;
+  if (I())
+    return self;
+  if (H())
+    return window.parent;
+  throw new Error("No valid target found for postMessage");
+}
+function N(n, r, t) {
+  if (!n)
+    throw new Error("Rimless Error: No target specified for postMessage");
+  if (y() && 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 x(n) {
+  return L(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 D(n, r, t) {
+  L(n) ? n.off(r, t) : "removeEventListener" in n && n.removeEventListener(r, t);
+}
+function M(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;
+      const S = {
+        action: a.RPC_RESOLVE,
+        callID: d,
+        callName: h,
+        connectionID: p,
+        error: null,
+        result: null
+      };
+      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)));
+      }
+      N(i, S, f == null ? void 0 : f.origin);
+    }
+    m(e, R.MESSAGE, l), o.push(() => D(e, R.MESSAGE, l));
+  }), () => o.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);
+      }
+    }
+    const d = {
+      action: a.RPC_REQUEST,
+      args: JSON.parse(JSON.stringify(c)),
+      callID: s,
+      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);
+  });
+}
+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);
+  }), {
+    remote: c,
+    unregisterRemote: () => l.forEach((f) => f())
+  };
+}
+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
+      };
+      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);
+    }
+    self.addEventListener(R.MESSAGE, c);
+    const l = {
+      action: a.HANDSHAKE_REQUEST,
+      methods: e,
+      schema: JSON.parse(JSON.stringify(n))
+    };
+    N(i, l);
+  });
+}
+const F = {
+  connect: V
+}, A = {};
+function q(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 B(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(
+        E.schema,
+        E.methods,
+        o,
+        f,
+        e,
+        s
+      ), S = {
+        action: a.HANDSHAKE_REPLY,
+        connectionID: o,
+        schema: r,
+        methods: d
+      };
+      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;
+    }
+    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])
+          throw new Error("Rimless Error: No connection found for this connectionID");
+        return i(A[s.connectionID]);
+      }
+    }
+    m(e, R.MESSAGE, l);
+  });
+}
+const z = {
+  connect: B
+};
+export {
+  a as actions,
+  R as events,
+  F as guest,
+  z 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 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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"}

package/lib/rimless.min.js

@@ -0,0 +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}({});
+//# 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 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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"}

package/lib/rpc.d.ts

@@ -0,0 +1,40 @@
+import { Environment, RimlessEvent, Schema, Target } from './types';
+/**
+ * for each function in the schema
+ * 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 rpcConnectionID
+ * @return a function to cancel all subscriptions
+ */
+export declare function registerLocalMethods(schema: Schema | undefined, methods: string[] | undefined, rpcConnectionID: string, listenTo: Environment, sendTo: Target): () => 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 and 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, methods: 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;
+    methods: string[];
+    schema: Schema;
+}
+export interface HandshakeConfirmationPayload {
+    action: actions.HANDSHAKE_REPLY;
+    connectionID: string;
+    methods: 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.5.1",
   "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",