rimless 0.7.1 → 0.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/rimless.js +248 -279
- package/lib/rimless.js.map +1 -1
- package/lib/rimless.min.js +2 -2
- package/lib/rimless.min.js.map +1 -1
- package/package.json +32 -27
- package/lib/guest.d.ts +0 -6
- package/lib/helpers.d.ts +0 -64
- package/lib/host.d.ts +0 -14
- package/lib/index.d.ts +0 -5
- package/lib/rpc.d.ts +0 -76
- package/lib/types.d.ts +0 -62
package/lib/rimless.js
CHANGED
|
@@ -1,281 +1,250 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
}
|
|
17
|
-
function
|
|
18
|
-
|
|
19
|
-
}
|
|
20
|
-
function
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
}
|
|
27
|
-
function
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
const Q = /^(https?:|file:)?\/\/([^/:]+)?(:(\d+))?/, Y = { "http:": "80", "https:": "443" };
|
|
40
|
-
function $(e) {
|
|
41
|
-
if (!e) return null;
|
|
42
|
-
const o = Q.exec(e);
|
|
43
|
-
if (!o) return null;
|
|
44
|
-
const [, t = "http:", n, , s] = o;
|
|
45
|
-
if (t === "file:")
|
|
46
|
-
return "file://";
|
|
47
|
-
const r = s && s !== Y[t] ? `:${s}` : "";
|
|
48
|
-
return `${t}//${n}${r}`;
|
|
49
|
-
}
|
|
50
|
-
function x(e, o, t) {
|
|
51
|
-
if (!e || typeof e != "object") return e;
|
|
52
|
-
const n = Array.isArray(o) ? o : o.split(".").map((r) => r.match(/^\d+$/) ? Number(r) : r);
|
|
53
|
-
let s = e;
|
|
54
|
-
for (let r = 0; r < n.length; r++) {
|
|
55
|
-
const c = n[r];
|
|
56
|
-
r === n.length - 1 ? s[c] = t : ((!s[c] || typeof s[c] != "object") && (s[c] = typeof n[r + 1] == "number" ? [] : {}), s = s[c]);
|
|
57
|
-
}
|
|
58
|
-
return e;
|
|
59
|
-
}
|
|
60
|
-
function C(e = 10) {
|
|
61
|
-
const o = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
|
|
62
|
-
let t = "";
|
|
63
|
-
for (let n = 0; n < e; n++)
|
|
64
|
-
t += o.charAt(Math.floor(Math.random() * o.length));
|
|
65
|
-
return t;
|
|
66
|
-
}
|
|
67
|
-
const _ = H();
|
|
68
|
-
let D = null;
|
|
69
|
-
if (_ === "node" || _ === "bun")
|
|
70
|
-
try {
|
|
71
|
-
D = require("worker_threads").parentPort;
|
|
72
|
-
} catch {
|
|
73
|
-
}
|
|
74
|
-
function J() {
|
|
75
|
-
if (g())
|
|
76
|
-
return D;
|
|
77
|
-
if (b())
|
|
78
|
-
return self;
|
|
79
|
-
if (U())
|
|
80
|
-
return window.parent;
|
|
81
|
-
throw new Error("No valid target found for postMessage");
|
|
82
|
-
}
|
|
83
|
-
function M(e, o, t, n) {
|
|
84
|
-
if (!e)
|
|
85
|
-
throw new Error("Rimless Error: No target specified for postMessage");
|
|
86
|
-
if (g() && e === D) {
|
|
87
|
-
e.postMessage(o, { transfer: n });
|
|
88
|
-
return;
|
|
89
|
-
}
|
|
90
|
-
if (b()) {
|
|
91
|
-
e.postMessage(o, { transfer: n });
|
|
92
|
-
return;
|
|
93
|
-
}
|
|
94
|
-
if (e.postMessage) {
|
|
95
|
-
e.postMessage(o, { targetOrigin: t || "*", transfer: n });
|
|
96
|
-
return;
|
|
97
|
-
}
|
|
98
|
-
throw new Error("Rimless Error: Invalid target for postMessage");
|
|
99
|
-
}
|
|
100
|
-
function k(e) {
|
|
101
|
-
return D !== null && e === D;
|
|
102
|
-
}
|
|
103
|
-
function V(e) {
|
|
104
|
-
return k(e) || typeof Worker < "u" && e instanceof Worker;
|
|
105
|
-
}
|
|
106
|
-
function L(e, o, t) {
|
|
107
|
-
k(e) ? e.on(o, t) : "addEventListener" in e && e.addEventListener(o, t);
|
|
108
|
-
}
|
|
109
|
-
function N(e, o, t) {
|
|
110
|
-
k(e) ? e.off(o, t) : "removeEventListener" in e && e.removeEventListener(o, t);
|
|
111
|
-
}
|
|
112
|
-
function P(e) {
|
|
113
|
-
return e.data || e;
|
|
114
|
-
}
|
|
115
|
-
var h = /* @__PURE__ */ ((e) => (e.MESSAGE = "message", e))(h || {}), a = /* @__PURE__ */ ((e) => (e.HANDSHAKE_REQUEST = "RIMLESS/HANDSHAKE_REQUEST", e.HANDSHAKE_REPLY = "RIMLESS/HANDSHAKE_REPLY", e.RPC_REQUEST = "RIMLESS/RPC_REQUEST", e.RPC_RESOLVE = "RIMLESS/RPC_RESOLVE", e.RPC_REJECT = "RIMLESS/RPC_REJECT", e))(a || {});
|
|
116
|
-
const y = Symbol();
|
|
117
|
-
function G(e = {}, o, t, n, s) {
|
|
118
|
-
const r = [];
|
|
119
|
-
for (const [c, u] of Object.entries(e)) {
|
|
120
|
-
async function f(i) {
|
|
121
|
-
const l = P(i), { action: m, callID: R, connectionID: E, callName: d, args: p = [] } = l;
|
|
122
|
-
if (m !== a.RPC_REQUEST || !R || !d || d !== c || E !== o) return;
|
|
123
|
-
const S = {
|
|
124
|
-
action: a.RPC_RESOLVE,
|
|
125
|
-
callID: R,
|
|
126
|
-
callName: d,
|
|
127
|
-
connectionID: E,
|
|
128
|
-
error: null,
|
|
129
|
-
result: null
|
|
130
|
-
};
|
|
131
|
-
let w;
|
|
132
|
-
try {
|
|
133
|
-
S.result = await u(...p, s), S.result && S.result[y] && (w = S.result[y] ?? [], delete S.result[y]);
|
|
134
|
-
} catch (I) {
|
|
135
|
-
S.action = a.RPC_REJECT, S.error = JSON.parse(JSON.stringify(I, Object.getOwnPropertyNames(I)));
|
|
136
|
-
}
|
|
137
|
-
M(n, S, i?.origin, w);
|
|
138
|
-
}
|
|
139
|
-
L(t, h.MESSAGE, f), r.push(() => N(t, h.MESSAGE, f));
|
|
140
|
-
}
|
|
141
|
-
return () => r.forEach((c) => c());
|
|
142
|
-
}
|
|
143
|
-
function q(e, o, t, n = [], s, r) {
|
|
144
|
-
return (...c) => new Promise((u, f) => {
|
|
145
|
-
const i = C();
|
|
146
|
-
function l(E) {
|
|
147
|
-
const d = P(E), { callID: p, connectionID: S, callName: w, result: I, error: W, action: T } = d;
|
|
148
|
-
if (!(!p || !w) && w === e && p === i && S === o) {
|
|
149
|
-
if (T === a.RPC_RESOLVE) return u(I);
|
|
150
|
-
if (T === a.RPC_REJECT) return f(W);
|
|
151
|
-
}
|
|
152
|
-
}
|
|
153
|
-
const m = {
|
|
154
|
-
action: a.RPC_REQUEST,
|
|
155
|
-
args: c,
|
|
156
|
-
callID: i,
|
|
157
|
-
callName: e,
|
|
158
|
-
connectionID: o
|
|
159
|
-
}, R = c.reduce(
|
|
160
|
-
(E, d) => d[y]?.length ? E.concat(d[y]) : E,
|
|
161
|
-
// @ts-expect-error: we know this is an array of transferables (if it exists)
|
|
162
|
-
c[y] ?? []
|
|
163
|
-
);
|
|
164
|
-
L(s, h.MESSAGE, l), n.push(() => N(s, h.MESSAGE, l)), M(r, m, t?.origin, R);
|
|
165
|
-
});
|
|
166
|
-
}
|
|
167
|
-
function v(e = {}, o = [], t, n, s, r) {
|
|
168
|
-
const c = { ...e }, u = [];
|
|
169
|
-
for (const f of o) {
|
|
170
|
-
const i = q(f, t, n, u, s, r);
|
|
171
|
-
x(c, f, i);
|
|
172
|
-
}
|
|
173
|
-
return {
|
|
174
|
-
remote: c,
|
|
175
|
-
unregisterRemote: () => u.forEach((f) => f())
|
|
176
|
-
};
|
|
177
|
-
}
|
|
178
|
-
const z = (e) => {
|
|
179
|
-
const o = [], n = e((s) => (o.push(s), s));
|
|
180
|
-
return Object.assign(n, { [y]: o });
|
|
181
|
-
};
|
|
182
|
-
function B(e = {}, o) {
|
|
183
|
-
return new Promise(async (t) => {
|
|
184
|
-
const n = O(e), s = J(), r = self || window;
|
|
185
|
-
async function c(f) {
|
|
186
|
-
const i = P(f);
|
|
187
|
-
if (i?.action !== a.HANDSHAKE_REPLY) return;
|
|
188
|
-
const { remote: l, unregisterRemote: m } = v(
|
|
189
|
-
i.schema,
|
|
190
|
-
i.methodNames,
|
|
191
|
-
i.connectionID,
|
|
192
|
-
f,
|
|
193
|
-
r,
|
|
194
|
-
s
|
|
195
|
-
), R = G(n, i.connectionID, r, s, l);
|
|
196
|
-
await o?.onConnectionSetup?.(l);
|
|
197
|
-
const E = {
|
|
198
|
-
action: a.HANDSHAKE_REPLY,
|
|
199
|
-
connectionID: i.connectionID
|
|
200
|
-
};
|
|
201
|
-
M(s, E, f?.origin);
|
|
202
|
-
const p = { remote: l, close: () => {
|
|
203
|
-
N(r, h.MESSAGE, c), m(), R();
|
|
204
|
-
}, id: i.connectionID };
|
|
205
|
-
return t(p);
|
|
206
|
-
}
|
|
207
|
-
L(r, h.MESSAGE, c);
|
|
208
|
-
const u = {
|
|
209
|
-
action: a.HANDSHAKE_REQUEST,
|
|
210
|
-
methodNames: Object.keys(n),
|
|
211
|
-
schema: e
|
|
212
|
-
};
|
|
213
|
-
M(s, u);
|
|
214
|
-
});
|
|
215
|
-
}
|
|
216
|
-
const X = {
|
|
217
|
-
connect: B
|
|
218
|
-
}, A = {};
|
|
219
|
-
function F(e, o) {
|
|
220
|
-
if (k(e) || typeof Worker < "u" && e instanceof Worker)
|
|
221
|
-
return !0;
|
|
222
|
-
const t = e;
|
|
223
|
-
try {
|
|
224
|
-
const n = t.src, s = typeof t.srcdoc == "string" && t.srcdoc.length > 0, r = $(n), c = o.origin === r, u = o.source === t.contentWindow;
|
|
225
|
-
return s || n === "about:blank" ? u : c && u || !n;
|
|
226
|
-
} catch (n) {
|
|
227
|
-
return console.warn("Error checking iframe target:", n), !1;
|
|
228
|
-
}
|
|
229
|
-
}
|
|
230
|
-
function j(e, o = {}) {
|
|
231
|
-
if (!e) throw new Error("a target is required");
|
|
232
|
-
const t = V(e), n = t || g() ? e : window;
|
|
233
|
-
return new Promise((s) => {
|
|
234
|
-
const r = C();
|
|
235
|
-
function c(f) {
|
|
236
|
-
const i = t || g() ? e : f.source;
|
|
237
|
-
if (!t && !g() && !F(e, f)) return;
|
|
238
|
-
const l = P(f);
|
|
239
|
-
if (l?.action !== a.HANDSHAKE_REQUEST || A[r]) return;
|
|
240
|
-
const m = O(o), { remote: R, unregisterRemote: E } = v(
|
|
241
|
-
l.schema,
|
|
242
|
-
l.methodNames,
|
|
243
|
-
r,
|
|
244
|
-
f,
|
|
245
|
-
n,
|
|
246
|
-
i
|
|
247
|
-
), d = G(m, r, n, i, R), p = {
|
|
248
|
-
action: a.HANDSHAKE_REPLY,
|
|
249
|
-
connectionID: r,
|
|
250
|
-
schema: o,
|
|
251
|
-
methodNames: Object.keys(m)
|
|
252
|
-
};
|
|
253
|
-
M(i, p, f.origin);
|
|
254
|
-
const w = { remote: R, close: () => {
|
|
255
|
-
delete A[r], N(n, h.MESSAGE, c), N(n, h.MESSAGE, u), E(), d(), t && e.terminate();
|
|
256
|
-
}, id: r };
|
|
257
|
-
A[r] = w;
|
|
258
|
-
}
|
|
259
|
-
L(n, h.MESSAGE, c);
|
|
260
|
-
function u(f) {
|
|
261
|
-
const i = P(f);
|
|
262
|
-
if (i?.action === a.HANDSHAKE_REPLY && r === i.connectionID) {
|
|
263
|
-
if (!A[i.connectionID])
|
|
264
|
-
throw new Error("Rimless Error: No connection found for this connectionID");
|
|
265
|
-
return s(A[i.connectionID]);
|
|
266
|
-
}
|
|
267
|
-
}
|
|
268
|
-
L(n, h.MESSAGE, u);
|
|
269
|
-
});
|
|
270
|
-
}
|
|
271
|
-
const Z = {
|
|
272
|
-
connect: j
|
|
1
|
+
//#region src/helpers.ts
|
|
2
|
+
function e() {
|
|
3
|
+
let e = globalThis;
|
|
4
|
+
if (e.window !== void 0 && e.document !== void 0) return "browser";
|
|
5
|
+
if (e.WorkerGlobalScope !== void 0 && e.self !== void 0 && e.self instanceof e.WorkerGlobalScope || e.window === void 0 && e.self !== void 0 && typeof e.importScripts == "function") return "worker";
|
|
6
|
+
let t = e.process;
|
|
7
|
+
if (t && typeof t == "object") {
|
|
8
|
+
let n = t.versions ?? {}, r = t.release?.name;
|
|
9
|
+
if (n.bun || r === "bun" || e.Bun !== void 0) return "bun";
|
|
10
|
+
if (n.node && r === "node") return "node";
|
|
11
|
+
}
|
|
12
|
+
return e.Bun === void 0 ? "browser" : "bun";
|
|
13
|
+
}
|
|
14
|
+
function t() {
|
|
15
|
+
return e();
|
|
16
|
+
}
|
|
17
|
+
function n() {
|
|
18
|
+
return t() === "worker";
|
|
19
|
+
}
|
|
20
|
+
function r() {
|
|
21
|
+
let e = t();
|
|
22
|
+
return e === "node" || e === "bun";
|
|
23
|
+
}
|
|
24
|
+
function i() {
|
|
25
|
+
return window.self !== window.top;
|
|
26
|
+
}
|
|
27
|
+
function a(e) {
|
|
28
|
+
let t = {};
|
|
29
|
+
return (function e(n, r = "") {
|
|
30
|
+
Object.keys(n).forEach((i) => {
|
|
31
|
+
let a = r ? `${r}.${i}` : i;
|
|
32
|
+
n[i] === Object(n[i]) && e(n[i], a), typeof n[i] == "function" && (t[a] = n[i], delete n[i]);
|
|
33
|
+
});
|
|
34
|
+
})(e), t;
|
|
35
|
+
}
|
|
36
|
+
var o = /^(https?:|file:)?\/\/([^/:]+)?(:(\d+))?/, s = {
|
|
37
|
+
"http:": "80",
|
|
38
|
+
"https:": "443"
|
|
273
39
|
};
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
40
|
+
function c(e) {
|
|
41
|
+
if (!e) return null;
|
|
42
|
+
let t = o.exec(e);
|
|
43
|
+
if (!t) return null;
|
|
44
|
+
let [, n = "http:", r, , i] = t;
|
|
45
|
+
return n === "file:" ? "file://" : `${n}//${r}${i && i !== s[n] ? `:${i}` : ""}`;
|
|
46
|
+
}
|
|
47
|
+
function l(e) {
|
|
48
|
+
return !e || e === "null" ? "*" : e;
|
|
49
|
+
}
|
|
50
|
+
function u(e, t, n) {
|
|
51
|
+
if (!e || typeof e != "object") return e;
|
|
52
|
+
let r = Array.isArray(t) ? t : t.split(".").map((e) => e.match(/^\d+$/) ? Number(e) : e), i = e;
|
|
53
|
+
for (let e = 0; e < r.length; e++) {
|
|
54
|
+
let t = r[e];
|
|
55
|
+
e === r.length - 1 ? i[t] = n : ((!i[t] || typeof i[t] != "object") && (i[t] = typeof r[e + 1] == "number" ? [] : {}), i = i[t]);
|
|
56
|
+
}
|
|
57
|
+
return e;
|
|
58
|
+
}
|
|
59
|
+
function d(e = 10) {
|
|
60
|
+
let t = "";
|
|
61
|
+
for (let n = 0; n < e; n++) t += "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789".charAt(Math.floor(Math.random() * 62));
|
|
62
|
+
return t;
|
|
63
|
+
}
|
|
64
|
+
var f = t(), p = null;
|
|
65
|
+
if (f === "node" || f === "bun") try {
|
|
66
|
+
let e = globalThis.require;
|
|
67
|
+
p = e?.("node:worker_threads")?.parentPort ?? null;
|
|
68
|
+
} catch {}
|
|
69
|
+
function m() {
|
|
70
|
+
if (r()) return p;
|
|
71
|
+
if (n()) return self;
|
|
72
|
+
if (i()) return window.parent;
|
|
73
|
+
throw Error("No valid target found for postMessage");
|
|
74
|
+
}
|
|
75
|
+
function h(e, t, i, a) {
|
|
76
|
+
if (!e) throw Error("Rimless Error: No target specified for postMessage");
|
|
77
|
+
if (r() && e === p) {
|
|
78
|
+
e.postMessage(t, { transfer: a });
|
|
79
|
+
return;
|
|
80
|
+
}
|
|
81
|
+
if (n()) {
|
|
82
|
+
e.postMessage(t, { transfer: a });
|
|
83
|
+
return;
|
|
84
|
+
}
|
|
85
|
+
if (e.postMessage) {
|
|
86
|
+
e.postMessage(t, {
|
|
87
|
+
targetOrigin: l(i),
|
|
88
|
+
transfer: a
|
|
89
|
+
});
|
|
90
|
+
return;
|
|
91
|
+
}
|
|
92
|
+
throw Error("Rimless Error: Invalid target for postMessage");
|
|
93
|
+
}
|
|
94
|
+
function g(e) {
|
|
95
|
+
return p !== null && e === p;
|
|
96
|
+
}
|
|
97
|
+
function _(e) {
|
|
98
|
+
return g(e) || typeof Worker < "u" && e instanceof Worker;
|
|
99
|
+
}
|
|
100
|
+
function v(e, t, n) {
|
|
101
|
+
g(e) ? e.on(t, n) : "addEventListener" in e && e.addEventListener(t, n);
|
|
102
|
+
}
|
|
103
|
+
function y(e, t, n) {
|
|
104
|
+
g(e) ? e.off(t, n) : "removeEventListener" in e && e.removeEventListener(t, n);
|
|
105
|
+
}
|
|
106
|
+
function b(e) {
|
|
107
|
+
return e.data || e;
|
|
108
|
+
}
|
|
109
|
+
//#endregion
|
|
110
|
+
//#region src/types.ts
|
|
111
|
+
var x = /* @__PURE__ */ function(e) {
|
|
112
|
+
return e.MESSAGE = "message", e;
|
|
113
|
+
}({}), S = /* @__PURE__ */ function(e) {
|
|
114
|
+
return e.HANDSHAKE_REQUEST = "RIMLESS/HANDSHAKE_REQUEST", e.HANDSHAKE_REPLY = "RIMLESS/HANDSHAKE_REPLY", e.RPC_REQUEST = "RIMLESS/RPC_REQUEST", e.RPC_RESOLVE = "RIMLESS/RPC_RESOLVE", e.RPC_REJECT = "RIMLESS/RPC_REJECT", e;
|
|
115
|
+
}({}), C = Symbol();
|
|
116
|
+
function w(e = {}, t, n, r, i) {
|
|
117
|
+
let a = [];
|
|
118
|
+
for (let [o, s] of Object.entries(e)) {
|
|
119
|
+
async function e(e) {
|
|
120
|
+
let { action: n, callID: a, connectionID: c, callName: l, args: u = [] } = b(e);
|
|
121
|
+
if (n !== S.RPC_REQUEST || !a || !l || l !== o || c !== t) return;
|
|
122
|
+
let d = {
|
|
123
|
+
action: S.RPC_RESOLVE,
|
|
124
|
+
callID: a,
|
|
125
|
+
callName: l,
|
|
126
|
+
connectionID: c,
|
|
127
|
+
error: null,
|
|
128
|
+
result: null
|
|
129
|
+
}, f;
|
|
130
|
+
try {
|
|
131
|
+
d.result = await s(...u, i), d.result?.[C] && (f = d.result[C] ?? [], delete d.result[C]);
|
|
132
|
+
} catch (e) {
|
|
133
|
+
d.action = S.RPC_REJECT, d.error = JSON.parse(JSON.stringify(e, Object.getOwnPropertyNames(e)));
|
|
134
|
+
}
|
|
135
|
+
h(r, d, e?.origin, f);
|
|
136
|
+
}
|
|
137
|
+
v(n, x.MESSAGE, e), a.push(() => y(n, x.MESSAGE, e));
|
|
138
|
+
}
|
|
139
|
+
return () => a.forEach((e) => e());
|
|
140
|
+
}
|
|
141
|
+
function T(e, t, n, r = [], i, a) {
|
|
142
|
+
return (...o) => new Promise((s, c) => {
|
|
143
|
+
let l = d();
|
|
144
|
+
function u(n) {
|
|
145
|
+
let { callID: r, connectionID: i, callName: a, result: o, error: u, action: d } = b(n);
|
|
146
|
+
if (!(!r || !a) && a === e && r === l && i === t) {
|
|
147
|
+
if (d === S.RPC_RESOLVE) return s(o);
|
|
148
|
+
if (d === S.RPC_REJECT) return c(u);
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
let f = {
|
|
152
|
+
action: S.RPC_REQUEST,
|
|
153
|
+
args: o,
|
|
154
|
+
callID: l,
|
|
155
|
+
callName: e,
|
|
156
|
+
connectionID: t
|
|
157
|
+
}, p = o.reduce((e, t) => t[C]?.length ? e.concat(t[C]) : e, o[C] ?? []);
|
|
158
|
+
v(i, x.MESSAGE, u), r.push(() => y(i, x.MESSAGE, u)), h(a, f, n?.origin, p);
|
|
159
|
+
});
|
|
160
|
+
}
|
|
161
|
+
function E(e = {}, t = [], n, r, i, a) {
|
|
162
|
+
let o = { ...e }, s = [];
|
|
163
|
+
for (let e of t) u(o, e, T(e, n, r, s, i, a));
|
|
164
|
+
return {
|
|
165
|
+
remote: o,
|
|
166
|
+
unregisterRemote: () => s.forEach((e) => e())
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
var D = (e) => {
|
|
170
|
+
let t = [], n = e((e) => (t.push(e), e));
|
|
171
|
+
return Object.assign(n, { [C]: t });
|
|
280
172
|
};
|
|
281
|
-
//#
|
|
173
|
+
//#endregion
|
|
174
|
+
//#region src/guest.ts
|
|
175
|
+
function O(e = {}, t) {
|
|
176
|
+
return new Promise(async (n) => {
|
|
177
|
+
let r = a(e), i = m(), o = self || window;
|
|
178
|
+
async function s(e) {
|
|
179
|
+
let a = b(e);
|
|
180
|
+
if (a?.action !== S.HANDSHAKE_REPLY) return;
|
|
181
|
+
let { remote: c, unregisterRemote: l } = E(a.schema, a.methodNames, a.connectionID, e, o, i), u = w(r, a.connectionID, o, i, c);
|
|
182
|
+
return await t?.onConnectionSetup?.(c), h(i, {
|
|
183
|
+
action: S.HANDSHAKE_REPLY,
|
|
184
|
+
connectionID: a.connectionID
|
|
185
|
+
}, e?.origin), n({
|
|
186
|
+
remote: c,
|
|
187
|
+
close: () => {
|
|
188
|
+
y(o, x.MESSAGE, s), l(), u();
|
|
189
|
+
},
|
|
190
|
+
id: a.connectionID
|
|
191
|
+
});
|
|
192
|
+
}
|
|
193
|
+
v(o, x.MESSAGE, s), h(i, {
|
|
194
|
+
action: S.HANDSHAKE_REQUEST,
|
|
195
|
+
methodNames: Object.keys(r),
|
|
196
|
+
schema: e
|
|
197
|
+
});
|
|
198
|
+
});
|
|
199
|
+
}
|
|
200
|
+
var k = { connect: O }, A = {};
|
|
201
|
+
function j(e, t) {
|
|
202
|
+
if (g(e) || typeof Worker < "u" && e instanceof Worker) return !0;
|
|
203
|
+
let n = e;
|
|
204
|
+
try {
|
|
205
|
+
let e = n.src, r = typeof n.srcdoc == "string" && n.srcdoc.length > 0, i = c(e), a = t.origin === i, o = t.source === n.contentWindow;
|
|
206
|
+
return t.origin === "null" && n.hasAttribute("sandbox") && !n.sandbox.contains("allow-same-origin") || r || e === "about:blank" ? o : a && o || !e;
|
|
207
|
+
} catch (e) {
|
|
208
|
+
return console.warn("Error checking iframe target:", e), !1;
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
function M(e, t = {}) {
|
|
212
|
+
if (!e) throw Error("a target is required");
|
|
213
|
+
let n = _(e), i = n || r() ? e : window;
|
|
214
|
+
return new Promise((o) => {
|
|
215
|
+
let s = d();
|
|
216
|
+
function c(o) {
|
|
217
|
+
let u = n || r() ? e : o.source;
|
|
218
|
+
if (!n && !r() && !j(e, o)) return;
|
|
219
|
+
let d = b(o);
|
|
220
|
+
if (d?.action !== S.HANDSHAKE_REQUEST || A[s]) return;
|
|
221
|
+
let f = a(t), { remote: p, unregisterRemote: m } = E(d.schema, d.methodNames, s, o, i, u), g = w(f, s, i, u, p);
|
|
222
|
+
h(u, {
|
|
223
|
+
action: S.HANDSHAKE_REPLY,
|
|
224
|
+
connectionID: s,
|
|
225
|
+
schema: t,
|
|
226
|
+
methodNames: Object.keys(f)
|
|
227
|
+
}, o.origin), A[s] = {
|
|
228
|
+
remote: p,
|
|
229
|
+
close: () => {
|
|
230
|
+
delete A[s], y(i, x.MESSAGE, c), y(i, x.MESSAGE, l), m(), g(), n && e.terminate();
|
|
231
|
+
},
|
|
232
|
+
id: s
|
|
233
|
+
};
|
|
234
|
+
}
|
|
235
|
+
v(i, x.MESSAGE, c);
|
|
236
|
+
function l(e) {
|
|
237
|
+
let t = b(e);
|
|
238
|
+
if (t?.action === S.HANDSHAKE_REPLY && s === t.connectionID) {
|
|
239
|
+
if (!A[t.connectionID]) throw Error("Rimless Error: No connection found for this connectionID");
|
|
240
|
+
return o(A[t.connectionID]);
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
v(i, x.MESSAGE, l);
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
var N = { connect: M };
|
|
247
|
+
//#endregion
|
|
248
|
+
export { S as actions, x as events, k as guest, N as host, D as withTransferable };
|
|
249
|
+
|
|
250
|
+
//# sourceMappingURL=rimless.js.map
|
package/lib/rimless.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rimless.js","sources":["../src/helpers.ts","../src/types.ts","../src/rpc.ts","../src/guest.ts","../src/host.ts"],"sourcesContent":["import { Guest, NodeWorker, Target, WorkerLike } from \"./types\";\n\ntype RuntimeEnvironment = \"browser\" | \"worker\" | \"node\" | \"bun\";\n\nfunction detectRuntime(): RuntimeEnvironment {\n const globalObject = globalThis as Record<string, any>;\n\n // Prefer explicit browser detection before checking shims\n if (typeof globalObject.window !== \"undefined\" && typeof globalObject.document !== \"undefined\") {\n return \"browser\";\n }\n\n const hasWorkerGlobalScope =\n typeof globalObject.WorkerGlobalScope !== \"undefined\" &&\n typeof globalObject.self !== \"undefined\" &&\n globalObject.self instanceof globalObject.WorkerGlobalScope;\n\n if (\n hasWorkerGlobalScope ||\n (typeof globalObject.window === \"undefined\" &&\n typeof globalObject.self !== \"undefined\" &&\n typeof globalObject.importScripts === \"function\")\n ) {\n return \"worker\";\n }\n\n const processRef = globalObject.process;\n if (processRef && typeof processRef === \"object\") {\n const versions = processRef.versions ?? {};\n const releaseName = processRef.release?.name;\n\n if (versions.bun || releaseName === \"bun\" || typeof globalObject.Bun !== \"undefined\") {\n return \"bun\";\n }\n\n if (versions.node && releaseName === \"node\") {\n return \"node\";\n }\n }\n\n if (typeof globalObject.Bun !== \"undefined\") {\n return \"bun\";\n }\n\n return \"browser\";\n}\n\nexport function getRuntimeEnvironment(): RuntimeEnvironment {\n return detectRuntime();\n}\n\nexport function isBrowserEnv(): boolean {\n return getRuntimeEnvironment() === \"browser\";\n}\n\n/**\n * check if run in a webworker\n *\n * @returns boolean\n */\nexport function isWorker(): boolean {\n return getRuntimeEnvironment() === \"worker\";\n}\n\n/**\n * check if run in a Node.js environment\n *\n * @returns boolean\n */\nexport function isNodeEnv(): boolean {\n return getRuntimeEnvironment() === \"node\";\n}\n\nexport function isBunEnv(): boolean {\n return getRuntimeEnvironment() === \"bun\";\n}\n\nexport function isServerEnv(): boolean {\n const runtime = getRuntimeEnvironment();\n return runtime === \"node\" || runtime === \"bun\";\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\nconst initialRuntime = getRuntimeEnvironment();\nlet parentPort: any = null;\n\nif (initialRuntime === \"node\" || initialRuntime === \"bun\") {\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 (isServerEnv()) {\n return parentPort;\n }\n\n if (isWorker()) {\n return self;\n }\n\n if (isIframe()) {\n return window.parent;\n }\n\n throw new Error(\"No valid target found for postMessage\");\n}\n\n/**\n * Send a message to a target, handling different environments (iframe, web worker, node worker)\n * @param target The target to send the message to\n * @param message The message to send\n * @param origin Optional origin for iframe communication\n * @param transferables Optional transferables for postMessage\n */\nexport function postMessageToTarget(\n target: Target,\n message: any,\n origin?: string,\n transferables?: Transferable[],\n): void {\n if (!target) {\n throw new Error(\"Rimless Error: No target specified for postMessage\");\n }\n\n // Node.js Worker\n if (isServerEnv() && target === parentPort) {\n target.postMessage(message, { transfer: transferables });\n return;\n }\n\n // Web Worker\n if (isWorker()) {\n target.postMessage(message, { transfer: transferables });\n return;\n }\n\n // iframe or window\n if (target.postMessage) {\n target.postMessage(message, { targetOrigin: origin || \"*\", transfer: transferables });\n return;\n }\n\n throw new Error(\"Rimless Error: Invalid target for postMessage\");\n}\n\nexport function isNodeWorker(guest: Guest | Target): guest is NodeWorker {\n return parentPort !== null && guest === parentPort;\n}\n\nexport function isWorkerLike(guest: Guest): guest is WorkerLike {\n return isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker);\n}\n\nexport function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n if (isNodeWorker(target)) {\n target.on(event, handler);\n } else if (\"addEventListener\" in target) {\n target.addEventListener(event, handler);\n }\n}\n\nexport function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n if (isNodeWorker(target)) {\n target.off(event, handler);\n } else if (\"removeEventListener\" in target) {\n target.removeEventListener(event, handler);\n }\n}\n\n/**\n * Normalize message event data across Web and Node.js environments\n * In web, data is in event.data\n * In Node.js, the event itself contains the data\n */\nexport function getEventData(event: any) {\n return event.data || event;\n}\n","export interface NodeWorker {\n on(event: string, handler: any): void;\n off(event: string, handler: any): void;\n postMessage(message: any): void;\n terminate(): void;\n}\n\nexport type WorkerLike = Worker | NodeWorker;\n\nexport enum events {\n MESSAGE = \"message\",\n}\n\nexport enum actions {\n HANDSHAKE_REQUEST = \"RIMLESS/HANDSHAKE_REQUEST\",\n HANDSHAKE_REPLY = \"RIMLESS/HANDSHAKE_REPLY\",\n RPC_REQUEST = \"RIMLESS/RPC_REQUEST\",\n RPC_RESOLVE = \"RIMLESS/RPC_RESOLVE\",\n RPC_REJECT = \"RIMLESS/RPC_REJECT\",\n}\n\nexport type Schema = Record<string, any>;\n\nexport interface Connection {\n id: string;\n remote: Schema;\n close: () => void;\n}\n\nexport type Connections = Record<string, Connection>;\n\nexport interface RimlessEvent extends EventListener {\n source?: Window;\n origin?: string;\n data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;\n}\n\nexport interface HandshakeRequestPayload {\n action: actions.HANDSHAKE_REQUEST;\n connectionID: string;\n methodNames: string[];\n schema: Schema;\n}\n\nexport interface HandshakeConfirmationPayload {\n action: actions.HANDSHAKE_REPLY;\n connectionID: string;\n methodNames: string[];\n schema: Schema;\n}\n\nexport interface RPCRequestPayload {\n action: actions.RPC_REQUEST;\n args: any[];\n callID: string;\n callName: string;\n connectionID: string;\n}\n\nexport interface RPCResolvePayload {\n action: actions.RPC_RESOLVE | actions.RPC_REJECT;\n result?: any | null;\n error?: Error | null;\n callID: string;\n callName: string;\n connectionID: string;\n}\n\nexport interface EventHandlers {\n onConnectionSetup: (remote: Schema) => Promise<void>;\n}\n\nexport type Guest = WorkerLike | HTMLIFrameElement;\nexport type Target = Window | WorkerLike;\nexport type Environment = Window | WorkerLike;\n","import { addEventListener, generateId, getEventData, postMessageToTarget, removeEventListener, set } from \"./helpers\";\nimport {\n actions,\n Environment,\n events,\n RimlessEvent,\n RPCRequestPayload,\n RPCResolvePayload,\n Schema,\n Target,\n} from \"./types\";\n\n/** Private symbol to which we will assign transferable objects */\nconst SYM_TRANSFERABLES = Symbol();\n\n/**\n * for each function in methods\n * 1. subscribe to an event that the remote can call\n * 2. listen for calls from the remote. When called execute the function and emit the results.\n *\n * @param methods an object of method ids : methods from the local schema\n * @param rpcConnectionID\n * @param listenTo Environment to listen for incoming messages\n * @param sendTo Target to send outgoing messages\n * @param remote The remote API object for the current connection\n * @return a function to cancel all subscriptions\n */\nexport function registerLocalMethods(\n methods: Record<string, (...args: any[]) => any> = {},\n rpcConnectionID: string,\n listenTo: Environment,\n sendTo: Target,\n remote: Schema, // Add remote parameter\n) {\n const listeners: any[] = [];\n for (const [methodName, method] of Object.entries(methods)) {\n // handle a remote calling a local method\n async function handleCall(event: any) {\n const eventData = getEventData(event);\n const { action, callID, connectionID, callName, args = [] } = eventData as RPCRequestPayload;\n\n if (action !== actions.RPC_REQUEST) return;\n if (!callID || !callName) return;\n if (callName !== methodName) return;\n if (connectionID !== rpcConnectionID) return;\n\n const payload: RPCResolvePayload = {\n action: actions.RPC_RESOLVE,\n callID,\n callName,\n connectionID,\n error: null,\n result: null,\n };\n\n // when a host function returns transferable results to the remote, the\n // transferables are assigned to a special symbol on each function's result\n let transferables: Transferable[] | undefined = undefined;\n\n // run function and return the results to the remote\n try {\n // Pass the remote object as the LAST argument to the local method\n payload.result = await method(...args, remote);\n\n if (payload.result && payload.result[SYM_TRANSFERABLES]) {\n transferables = payload.result[SYM_TRANSFERABLES] ?? [];\n delete payload.result[SYM_TRANSFERABLES];\n }\n } catch (error) {\n payload.action = actions.RPC_REJECT;\n payload.error = JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)));\n }\n\n postMessageToTarget(sendTo, payload, event?.origin, transferables);\n }\n\n // subscribe to the call event\n addEventListener(listenTo, events.MESSAGE, handleCall);\n listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleCall));\n }\n\n return () => listeners.forEach((unregister) => unregister());\n}\n\n/**\n * Create a function that will make an RPC request to the remote with some arguments.\n * Listen to an event that returns the results from the remote.\n *\n * @param rpcCallName\n * @param rpcConnectionID\n * @param event\n * @param listeners\n * @param guest\n *\n * @returns a promise with the result of the RPC\n */\nexport function createRPC(\n rpcCallName: string,\n rpcConnectionID: string,\n event: RimlessEvent,\n listeners: Array<() => void> = [],\n listenTo: Environment,\n sendTo: Target,\n) {\n return (...args: any[]) => {\n return new Promise((resolve, reject) => {\n const requestID = generateId();\n\n // on RPC response\n function handleResponse(event: any) {\n const eventData = getEventData(event);\n const { callID, connectionID, callName, result, error, action } = eventData as RPCResolvePayload;\n\n if (!callID || !callName) return;\n if (callName !== rpcCallName) return;\n if (callID !== requestID) return;\n if (connectionID !== rpcConnectionID) return;\n\n // resolve the response\n if (action === actions.RPC_RESOLVE) return resolve(result);\n if (action === actions.RPC_REJECT) return reject(error);\n }\n\n // send the RPC request with arguments\n const payload = {\n action: actions.RPC_REQUEST,\n args,\n callID: requestID,\n callName: rpcCallName,\n connectionID: rpcConnectionID,\n };\n\n // if the arguments have transferables, post them as well\n const transferables = args.reduce(\n (transferables, arg) =>\n arg[SYM_TRANSFERABLES]?.length ? transferables.concat(arg[SYM_TRANSFERABLES]) : transferables,\n // @ts-expect-error: we know this is an array of transferables (if it exists)\n args[SYM_TRANSFERABLES] ?? [],\n );\n\n addEventListener(listenTo, events.MESSAGE, handleResponse);\n listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleResponse));\n\n postMessageToTarget(sendTo, payload, event?.origin, transferables);\n });\n };\n}\n\n/**\n * create an object based on the remote schema's methods. Functions in that object will\n * emit an event that will trigger the RPC on the remote.\n *\n * @param schema\n * @param methods\n * @param connectionID\n * @param event\n * @param guest\n */\nexport function registerRemoteMethods(\n schema: Schema = {},\n methodNames: Iterable<string> = [],\n connectionID: string,\n event: RimlessEvent,\n listenTo: Environment,\n sendTo: Target,\n) {\n const remote = { ...schema };\n const listeners: Array<() => void> = [];\n\n for (const methodName of methodNames) {\n const rpc = createRPC(methodName, connectionID, event, listeners, listenTo, sendTo);\n set(remote, methodName, rpc);\n }\n\n return {\n remote,\n unregisterRemote: () => listeners.forEach((unregister) => unregister()),\n };\n}\n\n/**\n * This function is used by API schema declarations and remote function calls alike to\n * indicate which variables should be declared as transferable over `postMessage` calls.\n *\n * @param cb a function that takes a transfer function as an argument and returns an object\n * (in the loose, `typeof foo === \"object\"` sense)\n * @return result the callback's return value, with an extra array of transferable objects\n * assigned to rimless' private symbol `SYM_TRANSFERABLES`\n *\n * The `transfer(...)` function is called with an object to transfer; if there\n * are many objects to transfer, you may call it multiple times. It will always\n * return the input object. Calling `transfer` only modifies the callback\n * result, not the transferred object itself (or objects themselves).\n *\n * @example\n * host.connect({\n * foo: (...args) => {\n * const foo = new ArrayBuffer(8);\n * return withTransferable((transfer) => transfer(foo));\n * }),\n * });\n *\n * @example\n * host.remote.foo(withTransferable((transfer) => ({\n * stream: transfer(new ReadableStream()),\n * })));\n */\nexport const withTransferable = <Transferable, Result extends object>(\n cb: (transfer: <T extends Transferable>(transferable: T) => T) => Result,\n) => {\n const transferables: Transferable[] = [];\n const transfer = <T extends Transferable>(transferable: T) => {\n transferables.push(transferable);\n return transferable;\n };\n\n const result = cb(transfer);\n\n return Object.assign(result, { [SYM_TRANSFERABLES]: transferables });\n};\n","import {\n extractMethods,\n getEventData,\n getTargetHost,\n postMessageToTarget,\n addEventListener,\n removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, EventHandlers, events, Connection, Schema } from \"./types\";\n\nfunction connect(schema: Schema = {}, eventHandlers?: EventHandlers): Promise<Connection> {\n return new Promise(async (resolve) => {\n const localMethods = extractMethods(schema);\n const sendTo = getTargetHost();\n const listenTo = self || window;\n\n // on handshake response\n async function handleHandshakeResponse(event: any) {\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n\n // register remote methods\n const { remote, unregisterRemote } = registerRemoteMethods(\n eventData.schema,\n eventData.methodNames,\n eventData.connectionID,\n event,\n listenTo,\n sendTo,\n );\n\n // register local methods, passing the remote object\n const unregisterLocal = registerLocalMethods(localMethods, eventData.connectionID, listenTo, sendTo, remote);\n\n await eventHandlers?.onConnectionSetup?.(remote);\n\n // send a HANDSHAKE REPLY to the host\n const payload = {\n action: actions.HANDSHAKE_REPLY,\n connectionID: eventData.connectionID,\n };\n\n postMessageToTarget(sendTo, payload, event?.origin);\n\n // close the connection and all listeners when called\n const close = () => {\n removeEventListener(listenTo, events.MESSAGE, handleHandshakeResponse);\n unregisterRemote();\n unregisterLocal();\n };\n\n // resolve connection object\n const connection = { remote, close, id: eventData.connectionID };\n return resolve(connection);\n }\n\n // subscribe to HANDSHAKE RESPONSE MESSAGES\n addEventListener(listenTo, events.MESSAGE, handleHandshakeResponse);\n\n const payload = {\n action: actions.HANDSHAKE_REQUEST,\n methodNames: Object.keys(localMethods),\n schema: schema,\n };\n\n postMessageToTarget(sendTo, payload);\n });\n}\n\nexport default {\n connect,\n};\n","import {\n addEventListener,\n extractMethods,\n generateId,\n getEventData,\n getOriginFromURL,\n isServerEnv,\n isNodeWorker,\n isWorkerLike,\n postMessageToTarget,\n removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, events, Guest, Connection, Connections, Schema } from \"./types\";\n\nconst connections: Connections = {};\n\nfunction isValidTarget(guest: Guest, event: any) {\n // If it's a worker, we don't need to validate origin\n if (isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker)) {\n return true;\n }\n\n // For iframes, check origin and source\n const iframe = guest as HTMLIFrameElement;\n try {\n const childURL = iframe.src;\n const hasInlineContent = typeof iframe.srcdoc === \"string\" && iframe.srcdoc.length > 0;\n const childOrigin = getOriginFromURL(childURL);\n const hasProperOrigin = event.origin === childOrigin;\n const hasProperSource = event.source === iframe.contentWindow;\n\n // For inline iframes (srcdoc/about:blank) we can only rely on source matching\n if (hasInlineContent || childURL === \"about:blank\") {\n return hasProperSource;\n }\n\n return (hasProperOrigin && hasProperSource) || !childURL;\n } catch (e) {\n console.warn(\"Error checking iframe target:\", e);\n return false;\n }\n}\n\n/**\n * Perform a handshake with the target iframe, when the handshake is confirmed\n * resolve the connection object containing RPCs and properties\n *\n * @param guest\n * @param schema\n * @returns Promise\n */\nfunction connect(guest: Guest, schema: Schema = {}): Promise<Connection> {\n if (!guest) throw new Error(\"a target is required\");\n\n const guestIsWorker = isWorkerLike(guest);\n\n const listenTo = guestIsWorker || isServerEnv() ? (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 || isServerEnv() ? (guest as Worker) : event.source;\n\n if (!guestIsWorker && !isServerEnv() && !isValidTarget(guest, event)) return;\n\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REQUEST) return;\n if (connections[connectionID]) return;\n\n // Extract local methods first (doesn't need remote yet)\n const localMethods = extractMethods(schema);\n\n // Register remote methods first to get the remote object\n const { remote, unregisterRemote } = registerRemoteMethods(\n eventData.schema,\n eventData.methodNames,\n connectionID,\n event,\n listenTo,\n sendTo,\n );\n\n // Now register local methods, passing the remote object\n const unregisterLocal = registerLocalMethods(localMethods, connectionID, listenTo, sendTo, remote);\n\n // send a HANDSHAKE REPLY to the guest\n const payload = {\n action: actions.HANDSHAKE_REPLY,\n connectionID,\n schema: schema,\n methodNames: Object.keys(localMethods),\n };\n\n postMessageToTarget(sendTo, payload, event.origin);\n\n // close the connection and all listeners when called\n const close = () => {\n delete connections[connectionID];\n removeEventListener(listenTo, events.MESSAGE, handleHandshake);\n removeEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n unregisterRemote();\n unregisterLocal();\n if (guestIsWorker) {\n (guest as Worker).terminate();\n }\n };\n\n const connection: Connection = { remote, close, id: connectionID };\n connections[connectionID] = connection;\n }\n\n // subscribe to HANDSHAKE MESSAGES\n addEventListener(listenTo, events.MESSAGE, handleHandshake);\n\n // on handshake reply\n function handleHandshakeReply(event: any) {\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n if (connectionID !== eventData.connectionID) return;\n\n if (!connections[eventData.connectionID]) {\n throw new Error(\"Rimless Error: No connection found for this connectionID\");\n }\n\n return resolve(connections[eventData.connectionID]);\n }\n\n addEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n });\n}\n\nexport default {\n connect,\n};\n"],"names":["detectRuntime","globalObject","processRef","versions","releaseName","getRuntimeEnvironment","isWorker","isServerEnv","runtime","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","initialRuntime","parentPort","getTargetHost","postMessageToTarget","target","message","origin","transferables","isNodeWorker","guest","isWorkerLike","addEventListener","event","handler","removeEventListener","getEventData","events","actions","SYM_TRANSFERABLES","registerLocalMethods","rpcConnectionID","listenTo","sendTo","remote","listeners","methodName","method","handleCall","eventData","action","callID","connectionID","callName","args","payload","error","unregister","createRPC","rpcCallName","resolve","reject","requestID","handleResponse","arg","registerRemoteMethods","schema","methodNames","rpc","withTransferable","cb","transferable","connect","eventHandlers","localMethods","handleHandshakeResponse","unregisterRemote","unregisterLocal","connection","connections","isValidTarget","iframe","childURL","hasInlineContent","childOrigin","hasProperOrigin","hasProperSource","e","guestIsWorker","handleHandshake","handleHandshakeReply","host"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"rimless.js","names":[],"sources":["../src/helpers.ts","../src/types.ts","../src/rpc.ts","../src/guest.ts","../src/host.ts"],"sourcesContent":["import type { Guest, NodeWorker, Target, WorkerLike } from \"./types\";\n\ntype RuntimeEnvironment = \"browser\" | \"worker\" | \"node\" | \"bun\";\n\nfunction detectRuntime(): RuntimeEnvironment {\n const globalObject = globalThis as Record<string, any>;\n\n // Prefer explicit browser detection before checking shims\n if (typeof globalObject.window !== \"undefined\" && typeof globalObject.document !== \"undefined\") {\n return \"browser\";\n }\n\n const hasWorkerGlobalScope =\n typeof globalObject.WorkerGlobalScope !== \"undefined\" &&\n typeof globalObject.self !== \"undefined\" &&\n globalObject.self instanceof globalObject.WorkerGlobalScope;\n\n if (\n hasWorkerGlobalScope ||\n (typeof globalObject.window === \"undefined\" &&\n typeof globalObject.self !== \"undefined\" &&\n typeof globalObject.importScripts === \"function\")\n ) {\n return \"worker\";\n }\n\n const processRef = globalObject.process;\n if (processRef && typeof processRef === \"object\") {\n const versions = processRef.versions ?? {};\n const releaseName = processRef.release?.name;\n\n if (versions.bun || releaseName === \"bun\" || typeof globalObject.Bun !== \"undefined\") {\n return \"bun\";\n }\n\n if (versions.node && releaseName === \"node\") {\n return \"node\";\n }\n }\n\n if (typeof globalObject.Bun !== \"undefined\") {\n return \"bun\";\n }\n\n return \"browser\";\n}\n\nexport function getRuntimeEnvironment(): RuntimeEnvironment {\n return detectRuntime();\n}\n\nexport function isBrowserEnv(): boolean {\n return getRuntimeEnvironment() === \"browser\";\n}\n\n/**\n * check if run in a webworker\n *\n * @returns boolean\n */\nexport function isWorker(): boolean {\n return getRuntimeEnvironment() === \"worker\";\n}\n\n/**\n * check if run in a Node.js environment\n *\n * @returns boolean\n */\nexport function isNodeEnv(): boolean {\n return getRuntimeEnvironment() === \"node\";\n}\n\nexport function isBunEnv(): boolean {\n return getRuntimeEnvironment() === \"bun\";\n}\n\nexport function isServerEnv(): boolean {\n const runtime = getRuntimeEnvironment();\n return runtime === \"node\" || runtime === \"bun\";\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 resolveTargetOrigin(origin?: string | null) {\n if (!origin || origin === \"null\") return \"*\";\n return origin;\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\nconst initialRuntime = getRuntimeEnvironment();\nlet parentPort: any = null;\n\nif (initialRuntime === \"node\" || initialRuntime === \"bun\") {\n try {\n const nodeRequire = (globalThis as { require?: (id: string) => any }).require;\n const workerThreads = nodeRequire?.(\"node:worker_threads\");\n parentPort = workerThreads?.parentPort ?? null;\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 (isServerEnv()) {\n return parentPort;\n }\n\n if (isWorker()) {\n return self;\n }\n\n if (isIframe()) {\n return window.parent;\n }\n\n throw new Error(\"No valid target found for postMessage\");\n}\n\n/**\n * Send a message to a target, handling different environments (iframe, web worker, node worker)\n * @param target The target to send the message to\n * @param message The message to send\n * @param origin Optional origin for iframe communication\n * @param transferables Optional transferables for postMessage\n */\nexport function postMessageToTarget(\n target: Target,\n message: any,\n origin?: string | null,\n transferables?: Transferable[],\n): void {\n if (!target) {\n throw new Error(\"Rimless Error: No target specified for postMessage\");\n }\n\n // Node.js Worker\n if (isServerEnv() && target === parentPort) {\n target.postMessage(message, { transfer: transferables });\n return;\n }\n\n // Web Worker\n if (isWorker()) {\n target.postMessage(message, { transfer: transferables });\n return;\n }\n\n // iframe or window\n if (target.postMessage) {\n target.postMessage(message, { targetOrigin: resolveTargetOrigin(origin), transfer: transferables });\n return;\n }\n\n throw new Error(\"Rimless Error: Invalid target for postMessage\");\n}\n\nexport function isNodeWorker(guest: Guest | Target): guest is NodeWorker {\n return parentPort !== null && guest === parentPort;\n}\n\nexport function isWorkerLike(guest: Guest): guest is WorkerLike {\n return isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker);\n}\n\nexport function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n if (isNodeWorker(target)) {\n target.on(event, handler);\n } else if (\"addEventListener\" in target) {\n target.addEventListener(event, handler);\n }\n}\n\nexport function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n if (isNodeWorker(target)) {\n target.off(event, handler);\n } else if (\"removeEventListener\" in target) {\n target.removeEventListener(event, handler);\n }\n}\n\n/**\n * Normalize message event data across Web and Node.js environments\n * In web, data is in event.data\n * In Node.js, the event itself contains the data\n */\nexport function getEventData(event: any) {\n return event.data || event;\n}\n","export interface NodeWorker {\n on(event: string, handler: any): void;\n off(event: string, handler: any): void;\n postMessage(message: any): void;\n terminate(): void;\n}\n\nexport type WorkerLike = Worker | NodeWorker;\n\nexport enum events {\n MESSAGE = \"message\",\n}\n\nexport enum actions {\n HANDSHAKE_REQUEST = \"RIMLESS/HANDSHAKE_REQUEST\",\n HANDSHAKE_REPLY = \"RIMLESS/HANDSHAKE_REPLY\",\n RPC_REQUEST = \"RIMLESS/RPC_REQUEST\",\n RPC_RESOLVE = \"RIMLESS/RPC_RESOLVE\",\n RPC_REJECT = \"RIMLESS/RPC_REJECT\",\n}\n\nexport type Schema = Record<string, any>;\n\nexport interface Connection {\n id: string;\n remote: Schema;\n close: () => void;\n}\n\nexport type Connections = Record<string, Connection>;\n\nexport interface RimlessEvent extends EventListener {\n source?: Window;\n origin?: string;\n data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;\n}\n\nexport interface HandshakeRequestPayload {\n action: actions.HANDSHAKE_REQUEST;\n connectionID: string;\n methodNames: string[];\n schema: Schema;\n}\n\nexport interface HandshakeConfirmationPayload {\n action: actions.HANDSHAKE_REPLY;\n connectionID: string;\n methodNames: string[];\n schema: Schema;\n}\n\nexport interface RPCRequestPayload {\n action: actions.RPC_REQUEST;\n args: any[];\n callID: string;\n callName: string;\n connectionID: string;\n}\n\nexport interface RPCResolvePayload {\n action: actions.RPC_RESOLVE | actions.RPC_REJECT;\n result?: any | null;\n error?: Error | null;\n callID: string;\n callName: string;\n connectionID: string;\n}\n\nexport interface EventHandlers {\n onConnectionSetup: (remote: Schema) => Promise<void>;\n}\n\nexport type Guest = WorkerLike | HTMLIFrameElement;\nexport type Target = Window | WorkerLike;\nexport type Environment = Window | WorkerLike;\n","import { addEventListener, generateId, getEventData, postMessageToTarget, removeEventListener, set } from \"./helpers\";\nimport {\n actions,\n type Environment,\n events,\n type RimlessEvent,\n type RPCRequestPayload,\n type RPCResolvePayload,\n type Schema,\n type Target,\n} from \"./types\";\n\n/** Private symbol to which we will assign transferable objects */\nconst SYM_TRANSFERABLES = Symbol();\n\n/**\n * for each function in methods\n * 1. subscribe to an event that the remote can call\n * 2. listen for calls from the remote. When called execute the function and emit the results.\n *\n * @param methods an object of method ids : methods from the local schema\n * @param rpcConnectionID\n * @param listenTo Environment to listen for incoming messages\n * @param sendTo Target to send outgoing messages\n * @param remote The remote API object for the current connection\n * @return a function to cancel all subscriptions\n */\nexport function registerLocalMethods(\n methods: Record<string, (...args: any[]) => any> = {},\n rpcConnectionID: string,\n listenTo: Environment,\n sendTo: Target,\n remote: Schema, // Add remote parameter\n) {\n const listeners: any[] = [];\n for (const [methodName, method] of Object.entries(methods)) {\n // handle a remote calling a local method\n async function handleCall(event: any) {\n const eventData = getEventData(event);\n const { action, callID, connectionID, callName, args = [] } = eventData as RPCRequestPayload;\n\n if (action !== actions.RPC_REQUEST) return;\n if (!callID || !callName) return;\n if (callName !== methodName) return;\n if (connectionID !== rpcConnectionID) return;\n\n const payload: RPCResolvePayload = {\n action: actions.RPC_RESOLVE,\n callID,\n callName,\n connectionID,\n error: null,\n result: null,\n };\n\n // when a host function returns transferable results to the remote, the\n // transferables are assigned to a special symbol on each function's result\n let transferables: Transferable[] | undefined;\n\n // run function and return the results to the remote\n try {\n // Pass the remote object as the LAST argument to the local method\n payload.result = await method(...args, remote);\n\n if (payload.result?.[SYM_TRANSFERABLES]) {\n transferables = payload.result[SYM_TRANSFERABLES] ?? [];\n delete payload.result[SYM_TRANSFERABLES];\n }\n } catch (error) {\n payload.action = actions.RPC_REJECT;\n payload.error = JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)));\n }\n\n postMessageToTarget(sendTo, payload, event?.origin, transferables);\n }\n\n // subscribe to the call event\n addEventListener(listenTo, events.MESSAGE, handleCall);\n listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleCall));\n }\n\n return () => listeners.forEach((unregister) => unregister());\n}\n\n/**\n * Create a function that will make an RPC request to the remote with some arguments.\n * Listen to an event that returns the results from the remote.\n *\n * @param rpcCallName\n * @param rpcConnectionID\n * @param event\n * @param listeners\n * @param guest\n *\n * @returns a promise with the result of the RPC\n */\nexport function createRPC(\n rpcCallName: string,\n rpcConnectionID: string,\n event: RimlessEvent,\n listeners: Array<() => void> = [],\n listenTo: Environment,\n sendTo: Target,\n) {\n return (...args: any[]) => {\n return new Promise((resolve, reject) => {\n const requestID = generateId();\n\n // on RPC response\n function handleResponse(event: any) {\n const eventData = getEventData(event);\n const { callID, connectionID, callName, result, error, action } = eventData as RPCResolvePayload;\n\n if (!callID || !callName) return;\n if (callName !== rpcCallName) return;\n if (callID !== requestID) return;\n if (connectionID !== rpcConnectionID) return;\n\n // resolve the response\n if (action === actions.RPC_RESOLVE) return resolve(result);\n if (action === actions.RPC_REJECT) return reject(error);\n }\n\n // send the RPC request with arguments\n const payload = {\n action: actions.RPC_REQUEST,\n args,\n callID: requestID,\n callName: rpcCallName,\n connectionID: rpcConnectionID,\n };\n\n // if the arguments have transferables, post them as well\n const transferables = args.reduce(\n (transferables, arg) =>\n arg[SYM_TRANSFERABLES]?.length ? transferables.concat(arg[SYM_TRANSFERABLES]) : transferables,\n // @ts-expect-error: we know this is an array of transferables (if it exists)\n args[SYM_TRANSFERABLES] ?? [],\n );\n\n addEventListener(listenTo, events.MESSAGE, handleResponse);\n listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleResponse));\n\n postMessageToTarget(sendTo, payload, event?.origin, transferables);\n });\n };\n}\n\n/**\n * create an object based on the remote schema's methods. Functions in that object will\n * emit an event that will trigger the RPC on the remote.\n *\n * @param schema\n * @param methods\n * @param connectionID\n * @param event\n * @param guest\n */\nexport function registerRemoteMethods(\n schema: Schema = {},\n methodNames: Iterable<string> = [],\n connectionID: string,\n event: RimlessEvent,\n listenTo: Environment,\n sendTo: Target,\n) {\n const remote = { ...schema };\n const listeners: Array<() => void> = [];\n\n for (const methodName of methodNames) {\n const rpc = createRPC(methodName, connectionID, event, listeners, listenTo, sendTo);\n set(remote, methodName, rpc);\n }\n\n return {\n remote,\n unregisterRemote: () => listeners.forEach((unregister) => unregister()),\n };\n}\n\n/**\n * This function is used by API schema declarations and remote function calls alike to\n * indicate which variables should be declared as transferable over `postMessage` calls.\n *\n * @param cb a function that takes a transfer function as an argument and returns an object\n * (in the loose, `typeof foo === \"object\"` sense)\n * @return result the callback's return value, with an extra array of transferable objects\n * assigned to rimless' private symbol `SYM_TRANSFERABLES`\n *\n * The `transfer(...)` function is called with an object to transfer; if there\n * are many objects to transfer, you may call it multiple times. It will always\n * return the input object. Calling `transfer` only modifies the callback\n * result, not the transferred object itself (or objects themselves).\n *\n * @example\n * host.connect({\n * foo: (...args) => {\n * const foo = new ArrayBuffer(8);\n * return withTransferable((transfer) => transfer(foo));\n * }),\n * });\n *\n * @example\n * host.remote.foo(withTransferable((transfer) => ({\n * stream: transfer(new ReadableStream()),\n * })));\n */\nexport const withTransferable = <Transferable, Result extends object>(\n cb: (transfer: <T extends Transferable>(transferable: T) => T) => Result,\n) => {\n const transferables: Transferable[] = [];\n const transfer = <T extends Transferable>(transferable: T) => {\n transferables.push(transferable);\n return transferable;\n };\n\n const result = cb(transfer);\n\n return Object.assign(result, { [SYM_TRANSFERABLES]: transferables });\n};\n","import {\n addEventListener,\n extractMethods,\n getEventData,\n getTargetHost,\n postMessageToTarget,\n removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, type Connection, type EventHandlers, events, type 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 isNodeWorker,\n isServerEnv,\n isWorkerLike,\n postMessageToTarget,\n removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, type Connection, type Connections, events, type Guest, type Schema } from \"./types\";\n\nconst connections: Connections = {};\n\nfunction isValidTarget(guest: Guest, event: any) {\n // If it's a worker, we don't need to validate origin\n if (isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker)) {\n return true;\n }\n\n // For iframes, check origin and source\n const iframe = guest as HTMLIFrameElement;\n try {\n const childURL = iframe.src;\n const hasInlineContent = typeof iframe.srcdoc === \"string\" && iframe.srcdoc.length > 0;\n const childOrigin = getOriginFromURL(childURL);\n const hasProperOrigin = event.origin === childOrigin;\n const hasProperSource = event.source === iframe.contentWindow;\n const hasOpaqueOrigin = event.origin === \"null\";\n const isSandboxedOpaqueIframe =\n hasOpaqueOrigin && iframe.hasAttribute(\"sandbox\") && !iframe.sandbox.contains(\"allow-same-origin\");\n\n if (isSandboxedOpaqueIframe) {\n return hasProperSource;\n }\n\n // For inline iframes (srcdoc/about:blank) we can only rely on source matching\n if (hasInlineContent || childURL === \"about:blank\") {\n return hasProperSource;\n }\n\n return (hasProperOrigin && hasProperSource) || !childURL;\n } catch (e) {\n console.warn(\"Error checking iframe target:\", e);\n return false;\n }\n}\n\n/**\n * Perform a handshake with the target iframe, when the handshake is confirmed\n * resolve the connection object containing RPCs and properties\n *\n * @param guest\n * @param schema\n * @returns Promise\n */\nfunction connect(guest: Guest, schema: Schema = {}): Promise<Connection> {\n if (!guest) throw new Error(\"a target is required\");\n\n const guestIsWorker = isWorkerLike(guest);\n\n const listenTo = guestIsWorker || isServerEnv() ? (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 || isServerEnv() ? (guest as Worker) : event.source;\n\n if (!guestIsWorker && !isServerEnv() && !isValidTarget(guest, event)) return;\n\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REQUEST) return;\n if (connections[connectionID]) return;\n\n // Extract local methods first (doesn't need remote yet)\n const localMethods = extractMethods(schema);\n\n // Register remote methods first to get the remote object\n const { remote, unregisterRemote } = registerRemoteMethods(\n eventData.schema,\n eventData.methodNames,\n connectionID,\n event,\n listenTo,\n sendTo,\n );\n\n // Now register local methods, passing the remote object\n const unregisterLocal = registerLocalMethods(localMethods, connectionID, listenTo, sendTo, remote);\n\n // send a HANDSHAKE REPLY to the guest\n const payload = {\n action: actions.HANDSHAKE_REPLY,\n connectionID,\n schema: schema,\n methodNames: Object.keys(localMethods),\n };\n\n postMessageToTarget(sendTo, payload, event.origin);\n\n // close the connection and all listeners when called\n const close = () => {\n delete connections[connectionID];\n removeEventListener(listenTo, events.MESSAGE, handleHandshake);\n removeEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n unregisterRemote();\n unregisterLocal();\n if (guestIsWorker) {\n (guest as Worker).terminate();\n }\n };\n\n const connection: Connection = { remote, close, id: connectionID };\n connections[connectionID] = connection;\n }\n\n // subscribe to HANDSHAKE MESSAGES\n addEventListener(listenTo, events.MESSAGE, handleHandshake);\n\n // on handshake reply\n function handleHandshakeReply(event: any) {\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n if (connectionID !== eventData.connectionID) return;\n\n if (!connections[eventData.connectionID]) {\n throw new Error(\"Rimless Error: No connection found for this connectionID\");\n }\n\n return resolve(connections[eventData.connectionID]);\n }\n\n addEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n });\n}\n\nexport default {\n connect,\n};\n"],"mappings":"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"}
|
package/lib/rimless.min.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
var rimless=function(
|
|
2
|
-
//# sourceMappingURL=rimless.min.js.map
|
|
1
|
+
var rimless=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});function t(){let e=globalThis;if(e.window!==void 0&&e.document!==void 0)return`browser`;if(e.WorkerGlobalScope!==void 0&&e.self!==void 0&&e.self instanceof e.WorkerGlobalScope||e.window===void 0&&e.self!==void 0&&typeof e.importScripts==`function`)return`worker`;let t=e.process;if(t&&typeof t==`object`){let n=t.versions??{},r=t.release?.name;if(n.bun||r===`bun`||e.Bun!==void 0)return`bun`;if(n.node&&r===`node`)return`node`}return e.Bun===void 0?`browser`:`bun`}function n(){return t()}function r(){return n()===`worker`}function i(){let e=n();return e===`node`||e===`bun`}function a(){return window.self!==window.top}function o(e){let t={};return(function e(n,r=``){Object.keys(n).forEach(i=>{let a=r?`${r}.${i}`:i;n[i]===Object(n[i])&&e(n[i],a),typeof n[i]==`function`&&(t[a]=n[i],delete n[i])})})(e),t}var s=/^(https?:|file:)?\/\/([^/:]+)?(:(\d+))?/,c={"http:":`80`,"https:":`443`};function l(e){if(!e)return null;let t=s.exec(e);if(!t)return null;let[,n=`http:`,r,,i]=t;return n===`file:`?`file://`:`${n}//${r}${i&&i!==c[n]?`:${i}`:``}`}function u(e){return!e||e===`null`?`*`:e}function d(e,t,n){if(!e||typeof e!=`object`)return e;let r=Array.isArray(t)?t:t.split(`.`).map(e=>e.match(/^\d+$/)?Number(e):e),i=e;for(let e=0;e<r.length;e++){let t=r[e];e===r.length-1?i[t]=n:((!i[t]||typeof i[t]!=`object`)&&(i[t]=typeof r[e+1]==`number`?[]:{}),i=i[t])}return e}function f(e=10){let t=``;for(let n=0;n<e;n++)t+=`ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789`.charAt(Math.floor(Math.random()*62));return t}var p=n(),m=null;if(p===`node`||p===`bun`)try{let e=globalThis.require;m=e?.(`node:worker_threads`)?.parentPort??null}catch{}function h(){if(i())return m;if(r())return self;if(a())return window.parent;throw Error(`No valid target found for postMessage`)}function g(e,t,n,a){if(!e)throw Error(`Rimless Error: No target specified for postMessage`);if(i()&&e===m){e.postMessage(t,{transfer:a});return}if(r()){e.postMessage(t,{transfer:a});return}if(e.postMessage){e.postMessage(t,{targetOrigin:u(n),transfer:a});return}throw Error(`Rimless Error: Invalid target for postMessage`)}function _(e){return m!==null&&e===m}function v(e){return _(e)||typeof Worker<`u`&&e instanceof Worker}function y(e,t,n){_(e)?e.on(t,n):`addEventListener`in e&&e.addEventListener(t,n)}function b(e,t,n){_(e)?e.off(t,n):`removeEventListener`in e&&e.removeEventListener(t,n)}function x(e){return e.data||e}var S=function(e){return e.MESSAGE=`message`,e}({}),C=function(e){return e.HANDSHAKE_REQUEST=`RIMLESS/HANDSHAKE_REQUEST`,e.HANDSHAKE_REPLY=`RIMLESS/HANDSHAKE_REPLY`,e.RPC_REQUEST=`RIMLESS/RPC_REQUEST`,e.RPC_RESOLVE=`RIMLESS/RPC_RESOLVE`,e.RPC_REJECT=`RIMLESS/RPC_REJECT`,e}({}),w=Symbol();function T(e={},t,n,r,i){let a=[];for(let[o,s]of Object.entries(e)){async function e(e){let{action:n,callID:a,connectionID:c,callName:l,args:u=[]}=x(e);if(n!==C.RPC_REQUEST||!a||!l||l!==o||c!==t)return;let d={action:C.RPC_RESOLVE,callID:a,callName:l,connectionID:c,error:null,result:null},f;try{d.result=await s(...u,i),d.result?.[w]&&(f=d.result[w]??[],delete d.result[w])}catch(e){d.action=C.RPC_REJECT,d.error=JSON.parse(JSON.stringify(e,Object.getOwnPropertyNames(e)))}g(r,d,e?.origin,f)}y(n,S.MESSAGE,e),a.push(()=>b(n,S.MESSAGE,e))}return()=>a.forEach(e=>e())}function E(e,t,n,r=[],i,a){return(...o)=>new Promise((s,c)=>{let l=f();function u(n){let{callID:r,connectionID:i,callName:a,result:o,error:u,action:d}=x(n);if(!(!r||!a)&&a===e&&r===l&&i===t){if(d===C.RPC_RESOLVE)return s(o);if(d===C.RPC_REJECT)return c(u)}}let d={action:C.RPC_REQUEST,args:o,callID:l,callName:e,connectionID:t},p=o.reduce((e,t)=>t[w]?.length?e.concat(t[w]):e,o[w]??[]);y(i,S.MESSAGE,u),r.push(()=>b(i,S.MESSAGE,u)),g(a,d,n?.origin,p)})}function D(e={},t=[],n,r,i,a){let o={...e},s=[];for(let e of t)d(o,e,E(e,n,r,s,i,a));return{remote:o,unregisterRemote:()=>s.forEach(e=>e())}}var O=e=>{let t=[],n=e(e=>(t.push(e),e));return Object.assign(n,{[w]:t})};function k(e={},t){return new Promise(async n=>{let r=o(e),i=h(),a=self||window;async function s(e){let o=x(e);if(o?.action!==C.HANDSHAKE_REPLY)return;let{remote:c,unregisterRemote:l}=D(o.schema,o.methodNames,o.connectionID,e,a,i),u=T(r,o.connectionID,a,i,c);return await t?.onConnectionSetup?.(c),g(i,{action:C.HANDSHAKE_REPLY,connectionID:o.connectionID},e?.origin),n({remote:c,close:()=>{b(a,S.MESSAGE,s),l(),u()},id:o.connectionID})}y(a,S.MESSAGE,s),g(i,{action:C.HANDSHAKE_REQUEST,methodNames:Object.keys(r),schema:e})})}var A={connect:k},j={};function M(e,t){if(_(e)||typeof Worker<`u`&&e instanceof Worker)return!0;let n=e;try{let e=n.src,r=typeof n.srcdoc==`string`&&n.srcdoc.length>0,i=l(e),a=t.origin===i,o=t.source===n.contentWindow;return t.origin===`null`&&n.hasAttribute(`sandbox`)&&!n.sandbox.contains(`allow-same-origin`)||r||e===`about:blank`?o:a&&o||!e}catch(e){return console.warn(`Error checking iframe target:`,e),!1}}function N(e,t={}){if(!e)throw Error(`a target is required`);let n=v(e),r=n||i()?e:window;return new Promise(a=>{let s=f();function c(a){let u=n||i()?e:a.source;if(!n&&!i()&&!M(e,a))return;let d=x(a);if(d?.action!==C.HANDSHAKE_REQUEST||j[s])return;let f=o(t),{remote:p,unregisterRemote:m}=D(d.schema,d.methodNames,s,a,r,u),h=T(f,s,r,u,p);g(u,{action:C.HANDSHAKE_REPLY,connectionID:s,schema:t,methodNames:Object.keys(f)},a.origin),j[s]={remote:p,close:()=>{delete j[s],b(r,S.MESSAGE,c),b(r,S.MESSAGE,l),m(),h(),n&&e.terminate()},id:s}}y(r,S.MESSAGE,c);function l(e){let t=x(e);if(t?.action===C.HANDSHAKE_REPLY&&s===t.connectionID){if(!j[t.connectionID])throw Error(`Rimless Error: No connection found for this connectionID`);return a(j[t.connectionID])}}y(r,S.MESSAGE,l)})}var P={connect:N};return e.actions=C,e.events=S,e.guest=A,e.host=P,e.withTransferable=O,e})({});
|
|
2
|
+
//# sourceMappingURL=rimless.min.js.map
|
package/lib/rimless.min.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rimless.min.js","sources":["../src/helpers.ts","../src/types.ts","../src/rpc.ts","../src/guest.ts","../src/host.ts"],"sourcesContent":["import { Guest, NodeWorker, Target, WorkerLike } from \"./types\";\n\ntype RuntimeEnvironment = \"browser\" | \"worker\" | \"node\" | \"bun\";\n\nfunction detectRuntime(): RuntimeEnvironment {\n const globalObject = globalThis as Record<string, any>;\n\n // Prefer explicit browser detection before checking shims\n if (typeof globalObject.window !== \"undefined\" && typeof globalObject.document !== \"undefined\") {\n return \"browser\";\n }\n\n const hasWorkerGlobalScope =\n typeof globalObject.WorkerGlobalScope !== \"undefined\" &&\n typeof globalObject.self !== \"undefined\" &&\n globalObject.self instanceof globalObject.WorkerGlobalScope;\n\n if (\n hasWorkerGlobalScope ||\n (typeof globalObject.window === \"undefined\" &&\n typeof globalObject.self !== \"undefined\" &&\n typeof globalObject.importScripts === \"function\")\n ) {\n return \"worker\";\n }\n\n const processRef = globalObject.process;\n if (processRef && typeof processRef === \"object\") {\n const versions = processRef.versions ?? {};\n const releaseName = processRef.release?.name;\n\n if (versions.bun || releaseName === \"bun\" || typeof globalObject.Bun !== \"undefined\") {\n return \"bun\";\n }\n\n if (versions.node && releaseName === \"node\") {\n return \"node\";\n }\n }\n\n if (typeof globalObject.Bun !== \"undefined\") {\n return \"bun\";\n }\n\n return \"browser\";\n}\n\nexport function getRuntimeEnvironment(): RuntimeEnvironment {\n return detectRuntime();\n}\n\nexport function isBrowserEnv(): boolean {\n return getRuntimeEnvironment() === \"browser\";\n}\n\n/**\n * check if run in a webworker\n *\n * @returns boolean\n */\nexport function isWorker(): boolean {\n return getRuntimeEnvironment() === \"worker\";\n}\n\n/**\n * check if run in a Node.js environment\n *\n * @returns boolean\n */\nexport function isNodeEnv(): boolean {\n return getRuntimeEnvironment() === \"node\";\n}\n\nexport function isBunEnv(): boolean {\n return getRuntimeEnvironment() === \"bun\";\n}\n\nexport function isServerEnv(): boolean {\n const runtime = getRuntimeEnvironment();\n return runtime === \"node\" || runtime === \"bun\";\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\nconst initialRuntime = getRuntimeEnvironment();\nlet parentPort: any = null;\n\nif (initialRuntime === \"node\" || initialRuntime === \"bun\") {\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 (isServerEnv()) {\n return parentPort;\n }\n\n if (isWorker()) {\n return self;\n }\n\n if (isIframe()) {\n return window.parent;\n }\n\n throw new Error(\"No valid target found for postMessage\");\n}\n\n/**\n * Send a message to a target, handling different environments (iframe, web worker, node worker)\n * @param target The target to send the message to\n * @param message The message to send\n * @param origin Optional origin for iframe communication\n * @param transferables Optional transferables for postMessage\n */\nexport function postMessageToTarget(\n target: Target,\n message: any,\n origin?: string,\n transferables?: Transferable[],\n): void {\n if (!target) {\n throw new Error(\"Rimless Error: No target specified for postMessage\");\n }\n\n // Node.js Worker\n if (isServerEnv() && target === parentPort) {\n target.postMessage(message, { transfer: transferables });\n return;\n }\n\n // Web Worker\n if (isWorker()) {\n target.postMessage(message, { transfer: transferables });\n return;\n }\n\n // iframe or window\n if (target.postMessage) {\n target.postMessage(message, { targetOrigin: origin || \"*\", transfer: transferables });\n return;\n }\n\n throw new Error(\"Rimless Error: Invalid target for postMessage\");\n}\n\nexport function isNodeWorker(guest: Guest | Target): guest is NodeWorker {\n return parentPort !== null && guest === parentPort;\n}\n\nexport function isWorkerLike(guest: Guest): guest is WorkerLike {\n return isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker);\n}\n\nexport function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n if (isNodeWorker(target)) {\n target.on(event, handler);\n } else if (\"addEventListener\" in target) {\n target.addEventListener(event, handler);\n }\n}\n\nexport function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n if (isNodeWorker(target)) {\n target.off(event, handler);\n } else if (\"removeEventListener\" in target) {\n target.removeEventListener(event, handler);\n }\n}\n\n/**\n * Normalize message event data across Web and Node.js environments\n * In web, data is in event.data\n * In Node.js, the event itself contains the data\n */\nexport function getEventData(event: any) {\n return event.data || event;\n}\n","export interface NodeWorker {\n on(event: string, handler: any): void;\n off(event: string, handler: any): void;\n postMessage(message: any): void;\n terminate(): void;\n}\n\nexport type WorkerLike = Worker | NodeWorker;\n\nexport enum events {\n MESSAGE = \"message\",\n}\n\nexport enum actions {\n HANDSHAKE_REQUEST = \"RIMLESS/HANDSHAKE_REQUEST\",\n HANDSHAKE_REPLY = \"RIMLESS/HANDSHAKE_REPLY\",\n RPC_REQUEST = \"RIMLESS/RPC_REQUEST\",\n RPC_RESOLVE = \"RIMLESS/RPC_RESOLVE\",\n RPC_REJECT = \"RIMLESS/RPC_REJECT\",\n}\n\nexport type Schema = Record<string, any>;\n\nexport interface Connection {\n id: string;\n remote: Schema;\n close: () => void;\n}\n\nexport type Connections = Record<string, Connection>;\n\nexport interface RimlessEvent extends EventListener {\n source?: Window;\n origin?: string;\n data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;\n}\n\nexport interface HandshakeRequestPayload {\n action: actions.HANDSHAKE_REQUEST;\n connectionID: string;\n methodNames: string[];\n schema: Schema;\n}\n\nexport interface HandshakeConfirmationPayload {\n action: actions.HANDSHAKE_REPLY;\n connectionID: string;\n methodNames: string[];\n schema: Schema;\n}\n\nexport interface RPCRequestPayload {\n action: actions.RPC_REQUEST;\n args: any[];\n callID: string;\n callName: string;\n connectionID: string;\n}\n\nexport interface RPCResolvePayload {\n action: actions.RPC_RESOLVE | actions.RPC_REJECT;\n result?: any | null;\n error?: Error | null;\n callID: string;\n callName: string;\n connectionID: string;\n}\n\nexport interface EventHandlers {\n onConnectionSetup: (remote: Schema) => Promise<void>;\n}\n\nexport type Guest = WorkerLike | HTMLIFrameElement;\nexport type Target = Window | WorkerLike;\nexport type Environment = Window | WorkerLike;\n","import { addEventListener, generateId, getEventData, postMessageToTarget, removeEventListener, set } from \"./helpers\";\nimport {\n actions,\n Environment,\n events,\n RimlessEvent,\n RPCRequestPayload,\n RPCResolvePayload,\n Schema,\n Target,\n} from \"./types\";\n\n/** Private symbol to which we will assign transferable objects */\nconst SYM_TRANSFERABLES = Symbol();\n\n/**\n * for each function in methods\n * 1. subscribe to an event that the remote can call\n * 2. listen for calls from the remote. When called execute the function and emit the results.\n *\n * @param methods an object of method ids : methods from the local schema\n * @param rpcConnectionID\n * @param listenTo Environment to listen for incoming messages\n * @param sendTo Target to send outgoing messages\n * @param remote The remote API object for the current connection\n * @return a function to cancel all subscriptions\n */\nexport function registerLocalMethods(\n methods: Record<string, (...args: any[]) => any> = {},\n rpcConnectionID: string,\n listenTo: Environment,\n sendTo: Target,\n remote: Schema, // Add remote parameter\n) {\n const listeners: any[] = [];\n for (const [methodName, method] of Object.entries(methods)) {\n // handle a remote calling a local method\n async function handleCall(event: any) {\n const eventData = getEventData(event);\n const { action, callID, connectionID, callName, args = [] } = eventData as RPCRequestPayload;\n\n if (action !== actions.RPC_REQUEST) return;\n if (!callID || !callName) return;\n if (callName !== methodName) return;\n if (connectionID !== rpcConnectionID) return;\n\n const payload: RPCResolvePayload = {\n action: actions.RPC_RESOLVE,\n callID,\n callName,\n connectionID,\n error: null,\n result: null,\n };\n\n // when a host function returns transferable results to the remote, the\n // transferables are assigned to a special symbol on each function's result\n let transferables: Transferable[] | undefined = undefined;\n\n // run function and return the results to the remote\n try {\n // Pass the remote object as the LAST argument to the local method\n payload.result = await method(...args, remote);\n\n if (payload.result && payload.result[SYM_TRANSFERABLES]) {\n transferables = payload.result[SYM_TRANSFERABLES] ?? [];\n delete payload.result[SYM_TRANSFERABLES];\n }\n } catch (error) {\n payload.action = actions.RPC_REJECT;\n payload.error = JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)));\n }\n\n postMessageToTarget(sendTo, payload, event?.origin, transferables);\n }\n\n // subscribe to the call event\n addEventListener(listenTo, events.MESSAGE, handleCall);\n listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleCall));\n }\n\n return () => listeners.forEach((unregister) => unregister());\n}\n\n/**\n * Create a function that will make an RPC request to the remote with some arguments.\n * Listen to an event that returns the results from the remote.\n *\n * @param rpcCallName\n * @param rpcConnectionID\n * @param event\n * @param listeners\n * @param guest\n *\n * @returns a promise with the result of the RPC\n */\nexport function createRPC(\n rpcCallName: string,\n rpcConnectionID: string,\n event: RimlessEvent,\n listeners: Array<() => void> = [],\n listenTo: Environment,\n sendTo: Target,\n) {\n return (...args: any[]) => {\n return new Promise((resolve, reject) => {\n const requestID = generateId();\n\n // on RPC response\n function handleResponse(event: any) {\n const eventData = getEventData(event);\n const { callID, connectionID, callName, result, error, action } = eventData as RPCResolvePayload;\n\n if (!callID || !callName) return;\n if (callName !== rpcCallName) return;\n if (callID !== requestID) return;\n if (connectionID !== rpcConnectionID) return;\n\n // resolve the response\n if (action === actions.RPC_RESOLVE) return resolve(result);\n if (action === actions.RPC_REJECT) return reject(error);\n }\n\n // send the RPC request with arguments\n const payload = {\n action: actions.RPC_REQUEST,\n args,\n callID: requestID,\n callName: rpcCallName,\n connectionID: rpcConnectionID,\n };\n\n // if the arguments have transferables, post them as well\n const transferables = args.reduce(\n (transferables, arg) =>\n arg[SYM_TRANSFERABLES]?.length ? transferables.concat(arg[SYM_TRANSFERABLES]) : transferables,\n // @ts-expect-error: we know this is an array of transferables (if it exists)\n args[SYM_TRANSFERABLES] ?? [],\n );\n\n addEventListener(listenTo, events.MESSAGE, handleResponse);\n listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleResponse));\n\n postMessageToTarget(sendTo, payload, event?.origin, transferables);\n });\n };\n}\n\n/**\n * create an object based on the remote schema's methods. Functions in that object will\n * emit an event that will trigger the RPC on the remote.\n *\n * @param schema\n * @param methods\n * @param connectionID\n * @param event\n * @param guest\n */\nexport function registerRemoteMethods(\n schema: Schema = {},\n methodNames: Iterable<string> = [],\n connectionID: string,\n event: RimlessEvent,\n listenTo: Environment,\n sendTo: Target,\n) {\n const remote = { ...schema };\n const listeners: Array<() => void> = [];\n\n for (const methodName of methodNames) {\n const rpc = createRPC(methodName, connectionID, event, listeners, listenTo, sendTo);\n set(remote, methodName, rpc);\n }\n\n return {\n remote,\n unregisterRemote: () => listeners.forEach((unregister) => unregister()),\n };\n}\n\n/**\n * This function is used by API schema declarations and remote function calls alike to\n * indicate which variables should be declared as transferable over `postMessage` calls.\n *\n * @param cb a function that takes a transfer function as an argument and returns an object\n * (in the loose, `typeof foo === \"object\"` sense)\n * @return result the callback's return value, with an extra array of transferable objects\n * assigned to rimless' private symbol `SYM_TRANSFERABLES`\n *\n * The `transfer(...)` function is called with an object to transfer; if there\n * are many objects to transfer, you may call it multiple times. It will always\n * return the input object. Calling `transfer` only modifies the callback\n * result, not the transferred object itself (or objects themselves).\n *\n * @example\n * host.connect({\n * foo: (...args) => {\n * const foo = new ArrayBuffer(8);\n * return withTransferable((transfer) => transfer(foo));\n * }),\n * });\n *\n * @example\n * host.remote.foo(withTransferable((transfer) => ({\n * stream: transfer(new ReadableStream()),\n * })));\n */\nexport const withTransferable = <Transferable, Result extends object>(\n cb: (transfer: <T extends Transferable>(transferable: T) => T) => Result,\n) => {\n const transferables: Transferable[] = [];\n const transfer = <T extends Transferable>(transferable: T) => {\n transferables.push(transferable);\n return transferable;\n };\n\n const result = cb(transfer);\n\n return Object.assign(result, { [SYM_TRANSFERABLES]: transferables });\n};\n","import {\n extractMethods,\n getEventData,\n getTargetHost,\n postMessageToTarget,\n addEventListener,\n removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, EventHandlers, events, Connection, Schema } from \"./types\";\n\nfunction connect(schema: Schema = {}, eventHandlers?: EventHandlers): Promise<Connection> {\n return new Promise(async (resolve) => {\n const localMethods = extractMethods(schema);\n const sendTo = getTargetHost();\n const listenTo = self || window;\n\n // on handshake response\n async function handleHandshakeResponse(event: any) {\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n\n // register remote methods\n const { remote, unregisterRemote } = registerRemoteMethods(\n eventData.schema,\n eventData.methodNames,\n eventData.connectionID,\n event,\n listenTo,\n sendTo,\n );\n\n // register local methods, passing the remote object\n const unregisterLocal = registerLocalMethods(localMethods, eventData.connectionID, listenTo, sendTo, remote);\n\n await eventHandlers?.onConnectionSetup?.(remote);\n\n // send a HANDSHAKE REPLY to the host\n const payload = {\n action: actions.HANDSHAKE_REPLY,\n connectionID: eventData.connectionID,\n };\n\n postMessageToTarget(sendTo, payload, event?.origin);\n\n // close the connection and all listeners when called\n const close = () => {\n removeEventListener(listenTo, events.MESSAGE, handleHandshakeResponse);\n unregisterRemote();\n unregisterLocal();\n };\n\n // resolve connection object\n const connection = { remote, close, id: eventData.connectionID };\n return resolve(connection);\n }\n\n // subscribe to HANDSHAKE RESPONSE MESSAGES\n addEventListener(listenTo, events.MESSAGE, handleHandshakeResponse);\n\n const payload = {\n action: actions.HANDSHAKE_REQUEST,\n methodNames: Object.keys(localMethods),\n schema: schema,\n };\n\n postMessageToTarget(sendTo, payload);\n });\n}\n\nexport default {\n connect,\n};\n","import {\n addEventListener,\n extractMethods,\n generateId,\n getEventData,\n getOriginFromURL,\n isServerEnv,\n isNodeWorker,\n isWorkerLike,\n postMessageToTarget,\n removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, events, Guest, Connection, Connections, Schema } from \"./types\";\n\nconst connections: Connections = {};\n\nfunction isValidTarget(guest: Guest, event: any) {\n // If it's a worker, we don't need to validate origin\n if (isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker)) {\n return true;\n }\n\n // For iframes, check origin and source\n const iframe = guest as HTMLIFrameElement;\n try {\n const childURL = iframe.src;\n const hasInlineContent = typeof iframe.srcdoc === \"string\" && iframe.srcdoc.length > 0;\n const childOrigin = getOriginFromURL(childURL);\n const hasProperOrigin = event.origin === childOrigin;\n const hasProperSource = event.source === iframe.contentWindow;\n\n // For inline iframes (srcdoc/about:blank) we can only rely on source matching\n if (hasInlineContent || childURL === \"about:blank\") {\n return hasProperSource;\n }\n\n return (hasProperOrigin && hasProperSource) || !childURL;\n } catch (e) {\n console.warn(\"Error checking iframe target:\", e);\n return false;\n }\n}\n\n/**\n * Perform a handshake with the target iframe, when the handshake is confirmed\n * resolve the connection object containing RPCs and properties\n *\n * @param guest\n * @param schema\n * @returns Promise\n */\nfunction connect(guest: Guest, schema: Schema = {}): Promise<Connection> {\n if (!guest) throw new Error(\"a target is required\");\n\n const guestIsWorker = isWorkerLike(guest);\n\n const listenTo = guestIsWorker || isServerEnv() ? (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 || isServerEnv() ? (guest as Worker) : event.source;\n\n if (!guestIsWorker && !isServerEnv() && !isValidTarget(guest, event)) return;\n\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REQUEST) return;\n if (connections[connectionID]) return;\n\n // Extract local methods first (doesn't need remote yet)\n const localMethods = extractMethods(schema);\n\n // Register remote methods first to get the remote object\n const { remote, unregisterRemote } = registerRemoteMethods(\n eventData.schema,\n eventData.methodNames,\n connectionID,\n event,\n listenTo,\n sendTo,\n );\n\n // Now register local methods, passing the remote object\n const unregisterLocal = registerLocalMethods(localMethods, connectionID, listenTo, sendTo, remote);\n\n // send a HANDSHAKE REPLY to the guest\n const payload = {\n action: actions.HANDSHAKE_REPLY,\n connectionID,\n schema: schema,\n methodNames: Object.keys(localMethods),\n };\n\n postMessageToTarget(sendTo, payload, event.origin);\n\n // close the connection and all listeners when called\n const close = () => {\n delete connections[connectionID];\n removeEventListener(listenTo, events.MESSAGE, handleHandshake);\n removeEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n unregisterRemote();\n unregisterLocal();\n if (guestIsWorker) {\n (guest as Worker).terminate();\n }\n };\n\n const connection: Connection = { remote, close, id: connectionID };\n connections[connectionID] = connection;\n }\n\n // subscribe to HANDSHAKE MESSAGES\n addEventListener(listenTo, events.MESSAGE, handleHandshake);\n\n // on handshake reply\n function handleHandshakeReply(event: any) {\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n if (connectionID !== eventData.connectionID) return;\n\n if (!connections[eventData.connectionID]) {\n throw new Error(\"Rimless Error: No connection found for this connectionID\");\n }\n\n return resolve(connections[eventData.connectionID]);\n }\n\n addEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n });\n}\n\nexport default {\n connect,\n};\n"],"names":["detectRuntime","globalObject","processRef","versions","releaseName","getRuntimeEnvironment","isWorker","isServerEnv","runtime","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","initialRuntime","parentPort","getTargetHost","postMessageToTarget","target","message","origin","transferables","isNodeWorker","guest","isWorkerLike","addEventListener","event","handler","removeEventListener","getEventData","events","actions","SYM_TRANSFERABLES","registerLocalMethods","rpcConnectionID","listenTo","sendTo","remote","listeners","methodName","method","handleCall","eventData","action","callID","connectionID","callName","args","payload","error","unregister","createRPC","rpcCallName","resolve","reject","requestID","handleResponse","arg","registerRemoteMethods","schema","methodNames","rpc","withTransferable","cb","transferable","connect","eventHandlers","localMethods","handleHandshakeResponse","unregisterRemote","unregisterLocal","connection","connections","isValidTarget","iframe","childURL","hasInlineContent","childOrigin","hasProperOrigin","hasProperSource","e","guestIsWorker","handleHandshake","handleHandshakeReply","host"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"rimless.min.js","names":[],"sources":["../src/helpers.ts","../src/types.ts","../src/rpc.ts","../src/guest.ts","../src/host.ts"],"sourcesContent":["import type { Guest, NodeWorker, Target, WorkerLike } from \"./types\";\n\ntype RuntimeEnvironment = \"browser\" | \"worker\" | \"node\" | \"bun\";\n\nfunction detectRuntime(): RuntimeEnvironment {\n const globalObject = globalThis as Record<string, any>;\n\n // Prefer explicit browser detection before checking shims\n if (typeof globalObject.window !== \"undefined\" && typeof globalObject.document !== \"undefined\") {\n return \"browser\";\n }\n\n const hasWorkerGlobalScope =\n typeof globalObject.WorkerGlobalScope !== \"undefined\" &&\n typeof globalObject.self !== \"undefined\" &&\n globalObject.self instanceof globalObject.WorkerGlobalScope;\n\n if (\n hasWorkerGlobalScope ||\n (typeof globalObject.window === \"undefined\" &&\n typeof globalObject.self !== \"undefined\" &&\n typeof globalObject.importScripts === \"function\")\n ) {\n return \"worker\";\n }\n\n const processRef = globalObject.process;\n if (processRef && typeof processRef === \"object\") {\n const versions = processRef.versions ?? {};\n const releaseName = processRef.release?.name;\n\n if (versions.bun || releaseName === \"bun\" || typeof globalObject.Bun !== \"undefined\") {\n return \"bun\";\n }\n\n if (versions.node && releaseName === \"node\") {\n return \"node\";\n }\n }\n\n if (typeof globalObject.Bun !== \"undefined\") {\n return \"bun\";\n }\n\n return \"browser\";\n}\n\nexport function getRuntimeEnvironment(): RuntimeEnvironment {\n return detectRuntime();\n}\n\nexport function isBrowserEnv(): boolean {\n return getRuntimeEnvironment() === \"browser\";\n}\n\n/**\n * check if run in a webworker\n *\n * @returns boolean\n */\nexport function isWorker(): boolean {\n return getRuntimeEnvironment() === \"worker\";\n}\n\n/**\n * check if run in a Node.js environment\n *\n * @returns boolean\n */\nexport function isNodeEnv(): boolean {\n return getRuntimeEnvironment() === \"node\";\n}\n\nexport function isBunEnv(): boolean {\n return getRuntimeEnvironment() === \"bun\";\n}\n\nexport function isServerEnv(): boolean {\n const runtime = getRuntimeEnvironment();\n return runtime === \"node\" || runtime === \"bun\";\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 resolveTargetOrigin(origin?: string | null) {\n if (!origin || origin === \"null\") return \"*\";\n return origin;\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\nconst initialRuntime = getRuntimeEnvironment();\nlet parentPort: any = null;\n\nif (initialRuntime === \"node\" || initialRuntime === \"bun\") {\n try {\n const nodeRequire = (globalThis as { require?: (id: string) => any }).require;\n const workerThreads = nodeRequire?.(\"node:worker_threads\");\n parentPort = workerThreads?.parentPort ?? null;\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 (isServerEnv()) {\n return parentPort;\n }\n\n if (isWorker()) {\n return self;\n }\n\n if (isIframe()) {\n return window.parent;\n }\n\n throw new Error(\"No valid target found for postMessage\");\n}\n\n/**\n * Send a message to a target, handling different environments (iframe, web worker, node worker)\n * @param target The target to send the message to\n * @param message The message to send\n * @param origin Optional origin for iframe communication\n * @param transferables Optional transferables for postMessage\n */\nexport function postMessageToTarget(\n target: Target,\n message: any,\n origin?: string | null,\n transferables?: Transferable[],\n): void {\n if (!target) {\n throw new Error(\"Rimless Error: No target specified for postMessage\");\n }\n\n // Node.js Worker\n if (isServerEnv() && target === parentPort) {\n target.postMessage(message, { transfer: transferables });\n return;\n }\n\n // Web Worker\n if (isWorker()) {\n target.postMessage(message, { transfer: transferables });\n return;\n }\n\n // iframe or window\n if (target.postMessage) {\n target.postMessage(message, { targetOrigin: resolveTargetOrigin(origin), transfer: transferables });\n return;\n }\n\n throw new Error(\"Rimless Error: Invalid target for postMessage\");\n}\n\nexport function isNodeWorker(guest: Guest | Target): guest is NodeWorker {\n return parentPort !== null && guest === parentPort;\n}\n\nexport function isWorkerLike(guest: Guest): guest is WorkerLike {\n return isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker);\n}\n\nexport function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n if (isNodeWorker(target)) {\n target.on(event, handler);\n } else if (\"addEventListener\" in target) {\n target.addEventListener(event, handler);\n }\n}\n\nexport function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject) {\n if (isNodeWorker(target)) {\n target.off(event, handler);\n } else if (\"removeEventListener\" in target) {\n target.removeEventListener(event, handler);\n }\n}\n\n/**\n * Normalize message event data across Web and Node.js environments\n * In web, data is in event.data\n * In Node.js, the event itself contains the data\n */\nexport function getEventData(event: any) {\n return event.data || event;\n}\n","export interface NodeWorker {\n on(event: string, handler: any): void;\n off(event: string, handler: any): void;\n postMessage(message: any): void;\n terminate(): void;\n}\n\nexport type WorkerLike = Worker | NodeWorker;\n\nexport enum events {\n MESSAGE = \"message\",\n}\n\nexport enum actions {\n HANDSHAKE_REQUEST = \"RIMLESS/HANDSHAKE_REQUEST\",\n HANDSHAKE_REPLY = \"RIMLESS/HANDSHAKE_REPLY\",\n RPC_REQUEST = \"RIMLESS/RPC_REQUEST\",\n RPC_RESOLVE = \"RIMLESS/RPC_RESOLVE\",\n RPC_REJECT = \"RIMLESS/RPC_REJECT\",\n}\n\nexport type Schema = Record<string, any>;\n\nexport interface Connection {\n id: string;\n remote: Schema;\n close: () => void;\n}\n\nexport type Connections = Record<string, Connection>;\n\nexport interface RimlessEvent extends EventListener {\n source?: Window;\n origin?: string;\n data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;\n}\n\nexport interface HandshakeRequestPayload {\n action: actions.HANDSHAKE_REQUEST;\n connectionID: string;\n methodNames: string[];\n schema: Schema;\n}\n\nexport interface HandshakeConfirmationPayload {\n action: actions.HANDSHAKE_REPLY;\n connectionID: string;\n methodNames: string[];\n schema: Schema;\n}\n\nexport interface RPCRequestPayload {\n action: actions.RPC_REQUEST;\n args: any[];\n callID: string;\n callName: string;\n connectionID: string;\n}\n\nexport interface RPCResolvePayload {\n action: actions.RPC_RESOLVE | actions.RPC_REJECT;\n result?: any | null;\n error?: Error | null;\n callID: string;\n callName: string;\n connectionID: string;\n}\n\nexport interface EventHandlers {\n onConnectionSetup: (remote: Schema) => Promise<void>;\n}\n\nexport type Guest = WorkerLike | HTMLIFrameElement;\nexport type Target = Window | WorkerLike;\nexport type Environment = Window | WorkerLike;\n","import { addEventListener, generateId, getEventData, postMessageToTarget, removeEventListener, set } from \"./helpers\";\nimport {\n actions,\n type Environment,\n events,\n type RimlessEvent,\n type RPCRequestPayload,\n type RPCResolvePayload,\n type Schema,\n type Target,\n} from \"./types\";\n\n/** Private symbol to which we will assign transferable objects */\nconst SYM_TRANSFERABLES = Symbol();\n\n/**\n * for each function in methods\n * 1. subscribe to an event that the remote can call\n * 2. listen for calls from the remote. When called execute the function and emit the results.\n *\n * @param methods an object of method ids : methods from the local schema\n * @param rpcConnectionID\n * @param listenTo Environment to listen for incoming messages\n * @param sendTo Target to send outgoing messages\n * @param remote The remote API object for the current connection\n * @return a function to cancel all subscriptions\n */\nexport function registerLocalMethods(\n methods: Record<string, (...args: any[]) => any> = {},\n rpcConnectionID: string,\n listenTo: Environment,\n sendTo: Target,\n remote: Schema, // Add remote parameter\n) {\n const listeners: any[] = [];\n for (const [methodName, method] of Object.entries(methods)) {\n // handle a remote calling a local method\n async function handleCall(event: any) {\n const eventData = getEventData(event);\n const { action, callID, connectionID, callName, args = [] } = eventData as RPCRequestPayload;\n\n if (action !== actions.RPC_REQUEST) return;\n if (!callID || !callName) return;\n if (callName !== methodName) return;\n if (connectionID !== rpcConnectionID) return;\n\n const payload: RPCResolvePayload = {\n action: actions.RPC_RESOLVE,\n callID,\n callName,\n connectionID,\n error: null,\n result: null,\n };\n\n // when a host function returns transferable results to the remote, the\n // transferables are assigned to a special symbol on each function's result\n let transferables: Transferable[] | undefined;\n\n // run function and return the results to the remote\n try {\n // Pass the remote object as the LAST argument to the local method\n payload.result = await method(...args, remote);\n\n if (payload.result?.[SYM_TRANSFERABLES]) {\n transferables = payload.result[SYM_TRANSFERABLES] ?? [];\n delete payload.result[SYM_TRANSFERABLES];\n }\n } catch (error) {\n payload.action = actions.RPC_REJECT;\n payload.error = JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)));\n }\n\n postMessageToTarget(sendTo, payload, event?.origin, transferables);\n }\n\n // subscribe to the call event\n addEventListener(listenTo, events.MESSAGE, handleCall);\n listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleCall));\n }\n\n return () => listeners.forEach((unregister) => unregister());\n}\n\n/**\n * Create a function that will make an RPC request to the remote with some arguments.\n * Listen to an event that returns the results from the remote.\n *\n * @param rpcCallName\n * @param rpcConnectionID\n * @param event\n * @param listeners\n * @param guest\n *\n * @returns a promise with the result of the RPC\n */\nexport function createRPC(\n rpcCallName: string,\n rpcConnectionID: string,\n event: RimlessEvent,\n listeners: Array<() => void> = [],\n listenTo: Environment,\n sendTo: Target,\n) {\n return (...args: any[]) => {\n return new Promise((resolve, reject) => {\n const requestID = generateId();\n\n // on RPC response\n function handleResponse(event: any) {\n const eventData = getEventData(event);\n const { callID, connectionID, callName, result, error, action } = eventData as RPCResolvePayload;\n\n if (!callID || !callName) return;\n if (callName !== rpcCallName) return;\n if (callID !== requestID) return;\n if (connectionID !== rpcConnectionID) return;\n\n // resolve the response\n if (action === actions.RPC_RESOLVE) return resolve(result);\n if (action === actions.RPC_REJECT) return reject(error);\n }\n\n // send the RPC request with arguments\n const payload = {\n action: actions.RPC_REQUEST,\n args,\n callID: requestID,\n callName: rpcCallName,\n connectionID: rpcConnectionID,\n };\n\n // if the arguments have transferables, post them as well\n const transferables = args.reduce(\n (transferables, arg) =>\n arg[SYM_TRANSFERABLES]?.length ? transferables.concat(arg[SYM_TRANSFERABLES]) : transferables,\n // @ts-expect-error: we know this is an array of transferables (if it exists)\n args[SYM_TRANSFERABLES] ?? [],\n );\n\n addEventListener(listenTo, events.MESSAGE, handleResponse);\n listeners.push(() => removeEventListener(listenTo, events.MESSAGE, handleResponse));\n\n postMessageToTarget(sendTo, payload, event?.origin, transferables);\n });\n };\n}\n\n/**\n * create an object based on the remote schema's methods. Functions in that object will\n * emit an event that will trigger the RPC on the remote.\n *\n * @param schema\n * @param methods\n * @param connectionID\n * @param event\n * @param guest\n */\nexport function registerRemoteMethods(\n schema: Schema = {},\n methodNames: Iterable<string> = [],\n connectionID: string,\n event: RimlessEvent,\n listenTo: Environment,\n sendTo: Target,\n) {\n const remote = { ...schema };\n const listeners: Array<() => void> = [];\n\n for (const methodName of methodNames) {\n const rpc = createRPC(methodName, connectionID, event, listeners, listenTo, sendTo);\n set(remote, methodName, rpc);\n }\n\n return {\n remote,\n unregisterRemote: () => listeners.forEach((unregister) => unregister()),\n };\n}\n\n/**\n * This function is used by API schema declarations and remote function calls alike to\n * indicate which variables should be declared as transferable over `postMessage` calls.\n *\n * @param cb a function that takes a transfer function as an argument and returns an object\n * (in the loose, `typeof foo === \"object\"` sense)\n * @return result the callback's return value, with an extra array of transferable objects\n * assigned to rimless' private symbol `SYM_TRANSFERABLES`\n *\n * The `transfer(...)` function is called with an object to transfer; if there\n * are many objects to transfer, you may call it multiple times. It will always\n * return the input object. Calling `transfer` only modifies the callback\n * result, not the transferred object itself (or objects themselves).\n *\n * @example\n * host.connect({\n * foo: (...args) => {\n * const foo = new ArrayBuffer(8);\n * return withTransferable((transfer) => transfer(foo));\n * }),\n * });\n *\n * @example\n * host.remote.foo(withTransferable((transfer) => ({\n * stream: transfer(new ReadableStream()),\n * })));\n */\nexport const withTransferable = <Transferable, Result extends object>(\n cb: (transfer: <T extends Transferable>(transferable: T) => T) => Result,\n) => {\n const transferables: Transferable[] = [];\n const transfer = <T extends Transferable>(transferable: T) => {\n transferables.push(transferable);\n return transferable;\n };\n\n const result = cb(transfer);\n\n return Object.assign(result, { [SYM_TRANSFERABLES]: transferables });\n};\n","import {\n addEventListener,\n extractMethods,\n getEventData,\n getTargetHost,\n postMessageToTarget,\n removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, type Connection, type EventHandlers, events, type 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 isNodeWorker,\n isServerEnv,\n isWorkerLike,\n postMessageToTarget,\n removeEventListener,\n} from \"./helpers\";\nimport { registerLocalMethods, registerRemoteMethods } from \"./rpc\";\nimport { actions, type Connection, type Connections, events, type Guest, type Schema } from \"./types\";\n\nconst connections: Connections = {};\n\nfunction isValidTarget(guest: Guest, event: any) {\n // If it's a worker, we don't need to validate origin\n if (isNodeWorker(guest) || (typeof Worker !== \"undefined\" && guest instanceof Worker)) {\n return true;\n }\n\n // For iframes, check origin and source\n const iframe = guest as HTMLIFrameElement;\n try {\n const childURL = iframe.src;\n const hasInlineContent = typeof iframe.srcdoc === \"string\" && iframe.srcdoc.length > 0;\n const childOrigin = getOriginFromURL(childURL);\n const hasProperOrigin = event.origin === childOrigin;\n const hasProperSource = event.source === iframe.contentWindow;\n const hasOpaqueOrigin = event.origin === \"null\";\n const isSandboxedOpaqueIframe =\n hasOpaqueOrigin && iframe.hasAttribute(\"sandbox\") && !iframe.sandbox.contains(\"allow-same-origin\");\n\n if (isSandboxedOpaqueIframe) {\n return hasProperSource;\n }\n\n // For inline iframes (srcdoc/about:blank) we can only rely on source matching\n if (hasInlineContent || childURL === \"about:blank\") {\n return hasProperSource;\n }\n\n return (hasProperOrigin && hasProperSource) || !childURL;\n } catch (e) {\n console.warn(\"Error checking iframe target:\", e);\n return false;\n }\n}\n\n/**\n * Perform a handshake with the target iframe, when the handshake is confirmed\n * resolve the connection object containing RPCs and properties\n *\n * @param guest\n * @param schema\n * @returns Promise\n */\nfunction connect(guest: Guest, schema: Schema = {}): Promise<Connection> {\n if (!guest) throw new Error(\"a target is required\");\n\n const guestIsWorker = isWorkerLike(guest);\n\n const listenTo = guestIsWorker || isServerEnv() ? (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 || isServerEnv() ? (guest as Worker) : event.source;\n\n if (!guestIsWorker && !isServerEnv() && !isValidTarget(guest, event)) return;\n\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REQUEST) return;\n if (connections[connectionID]) return;\n\n // Extract local methods first (doesn't need remote yet)\n const localMethods = extractMethods(schema);\n\n // Register remote methods first to get the remote object\n const { remote, unregisterRemote } = registerRemoteMethods(\n eventData.schema,\n eventData.methodNames,\n connectionID,\n event,\n listenTo,\n sendTo,\n );\n\n // Now register local methods, passing the remote object\n const unregisterLocal = registerLocalMethods(localMethods, connectionID, listenTo, sendTo, remote);\n\n // send a HANDSHAKE REPLY to the guest\n const payload = {\n action: actions.HANDSHAKE_REPLY,\n connectionID,\n schema: schema,\n methodNames: Object.keys(localMethods),\n };\n\n postMessageToTarget(sendTo, payload, event.origin);\n\n // close the connection and all listeners when called\n const close = () => {\n delete connections[connectionID];\n removeEventListener(listenTo, events.MESSAGE, handleHandshake);\n removeEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n unregisterRemote();\n unregisterLocal();\n if (guestIsWorker) {\n (guest as Worker).terminate();\n }\n };\n\n const connection: Connection = { remote, close, id: connectionID };\n connections[connectionID] = connection;\n }\n\n // subscribe to HANDSHAKE MESSAGES\n addEventListener(listenTo, events.MESSAGE, handleHandshake);\n\n // on handshake reply\n function handleHandshakeReply(event: any) {\n const eventData = getEventData(event);\n if (eventData?.action !== actions.HANDSHAKE_REPLY) return;\n if (connectionID !== eventData.connectionID) return;\n\n if (!connections[eventData.connectionID]) {\n throw new Error(\"Rimless Error: No connection found for this connectionID\");\n }\n\n return resolve(connections[eventData.connectionID]);\n }\n\n addEventListener(listenTo, events.MESSAGE, handleHandshakeReply);\n });\n}\n\nexport default {\n connect,\n};\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "rimless",
|
|
3
3
|
"author": "Aurélien Franky",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.8.1",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"homepage": "https://github.com/au-re/rimless",
|
|
7
7
|
"description": "event base communication made easy with a promise-based API wrapping `postMessage`",
|
|
@@ -14,45 +14,50 @@
|
|
|
14
14
|
],
|
|
15
15
|
"scripts": {
|
|
16
16
|
"dev": "vite",
|
|
17
|
-
"format": "npx prettier --check \"./src/**/*.{js,jsx,ts,tsx,css,scss,html,md}\" --write",
|
|
18
17
|
"build": "tsc -b && tsc --noEmit -p tsconfig.test.json && vite build",
|
|
19
|
-
"prepublishOnly": "
|
|
20
|
-
"
|
|
18
|
+
"prepublishOnly": "bun run build",
|
|
19
|
+
"format": "biome check --write .",
|
|
20
|
+
"format:check": "biome check .",
|
|
21
|
+
"lint": "biome lint .",
|
|
21
22
|
"test": "vitest run",
|
|
23
|
+
"test:browser": "bun run build && node tests/browser/opaque-origin-iframe.mjs",
|
|
22
24
|
"test:coverage": "vitest run --coverage",
|
|
23
25
|
"preview": "vite preview",
|
|
24
26
|
"storybook": "storybook dev -p 6006",
|
|
25
27
|
"build-storybook": "storybook build",
|
|
26
|
-
"visualize-bundle": "
|
|
28
|
+
"visualize-bundle": "bunx vite-bundle-visualizer",
|
|
29
|
+
"changeset": "changeset",
|
|
30
|
+
"release": "bun run build && changeset publish",
|
|
31
|
+
"validate": "bun run format:check && bun run lint && bun run build && bun run test"
|
|
27
32
|
},
|
|
28
33
|
"repository": {
|
|
29
34
|
"type": "git",
|
|
30
|
-
"url": "https://github.com/au-re/rimless.git"
|
|
35
|
+
"url": "git+https://github.com/au-re/rimless.git"
|
|
31
36
|
},
|
|
32
37
|
"devDependencies": {
|
|
33
|
-
"@
|
|
34
|
-
"@
|
|
35
|
-
"@storybook
|
|
36
|
-
"@storybook/addon-
|
|
37
|
-
"@storybook/addon-
|
|
38
|
-
"@storybook/
|
|
38
|
+
"@biomejs/biome": "2.4.15",
|
|
39
|
+
"@changesets/cli": "2.31.0",
|
|
40
|
+
"@chromatic-com/storybook": "^5.1.2",
|
|
41
|
+
"@storybook/addon-docs": "^10.3.6",
|
|
42
|
+
"@storybook/addon-links": "^10.3.6",
|
|
43
|
+
"@storybook/addon-onboarding": "^10.3.6",
|
|
44
|
+
"@storybook/react-vite": "^10.3.6",
|
|
39
45
|
"@types/lodash.set": "^4.3.9",
|
|
40
|
-
"@types/node": "^
|
|
41
|
-
"@vitejs/plugin-react": "^
|
|
42
|
-
"@vitest/coverage-v8": "
|
|
43
|
-
"
|
|
44
|
-
"
|
|
45
|
-
"
|
|
46
|
-
"
|
|
47
|
-
"
|
|
48
|
-
"
|
|
49
|
-
"
|
|
50
|
-
"typescript": "^5.9.3",
|
|
51
|
-
"typescript-eslint": "^8.46.2",
|
|
52
|
-
"vite": "^7.1.12",
|
|
53
|
-
"vite-plugin-dts": "^4.5.4",
|
|
54
|
-
"vitest": "^4.0.3"
|
|
46
|
+
"@types/node": "^22.19.18",
|
|
47
|
+
"@vitejs/plugin-react": "^6.0.1",
|
|
48
|
+
"@vitest/coverage-v8": "4.1.5",
|
|
49
|
+
"happy-dom": "^20.9.0",
|
|
50
|
+
"storybook": "^10.3.6",
|
|
51
|
+
"terser": "^5.47.1",
|
|
52
|
+
"typescript": "^6.0.3",
|
|
53
|
+
"vite": "^8.0.11",
|
|
54
|
+
"vite-plugin-dts": "^5.0.0",
|
|
55
|
+
"vitest": "4.1.5"
|
|
55
56
|
},
|
|
57
|
+
"engines": {
|
|
58
|
+
"bun": ">=1.3.13"
|
|
59
|
+
},
|
|
60
|
+
"packageManager": "bun@1.3.13",
|
|
56
61
|
"volta": {
|
|
57
62
|
"node": "22.21.0"
|
|
58
63
|
}
|
package/lib/guest.d.ts
DELETED
package/lib/helpers.d.ts
DELETED
|
@@ -1,64 +0,0 @@
|
|
|
1
|
-
import { Guest, NodeWorker, Target, WorkerLike } from './types';
|
|
2
|
-
type RuntimeEnvironment = "browser" | "worker" | "node" | "bun";
|
|
3
|
-
export declare function getRuntimeEnvironment(): RuntimeEnvironment;
|
|
4
|
-
export declare function isBrowserEnv(): boolean;
|
|
5
|
-
/**
|
|
6
|
-
* check if run in a webworker
|
|
7
|
-
*
|
|
8
|
-
* @returns boolean
|
|
9
|
-
*/
|
|
10
|
-
export declare function isWorker(): boolean;
|
|
11
|
-
/**
|
|
12
|
-
* check if run in a Node.js environment
|
|
13
|
-
*
|
|
14
|
-
* @returns boolean
|
|
15
|
-
*/
|
|
16
|
-
export declare function isNodeEnv(): boolean;
|
|
17
|
-
export declare function isBunEnv(): boolean;
|
|
18
|
-
export declare function isServerEnv(): boolean;
|
|
19
|
-
/**
|
|
20
|
-
* check if run in an iframe
|
|
21
|
-
*
|
|
22
|
-
* @returns boolean
|
|
23
|
-
*/
|
|
24
|
-
export declare function isIframe(): boolean;
|
|
25
|
-
/**
|
|
26
|
-
* we cannot send functions through postMessage
|
|
27
|
-
* extract the path to all functions in the schema
|
|
28
|
-
*
|
|
29
|
-
* @param obj
|
|
30
|
-
*/
|
|
31
|
-
export declare function extractMethods(obj: any): Record<string, (...args: any) => any>;
|
|
32
|
-
/**
|
|
33
|
-
* convert the url into an origin (remove paths)
|
|
34
|
-
*
|
|
35
|
-
* @param url
|
|
36
|
-
*/
|
|
37
|
-
export declare function getOriginFromURL(url: string | null): string | null;
|
|
38
|
-
export declare function get(obj: any, path: string | Array<string | number>, defaultValue?: any): any;
|
|
39
|
-
export declare function set(obj: any, path: string | (string | number)[], value: any): any;
|
|
40
|
-
export declare function generateId(length?: number): string;
|
|
41
|
-
/**
|
|
42
|
-
* Get the appropriate target host for messaging based on the current environment
|
|
43
|
-
* @returns The messaging target for the current environment
|
|
44
|
-
*/
|
|
45
|
-
export declare function getTargetHost(): any;
|
|
46
|
-
/**
|
|
47
|
-
* Send a message to a target, handling different environments (iframe, web worker, node worker)
|
|
48
|
-
* @param target The target to send the message to
|
|
49
|
-
* @param message The message to send
|
|
50
|
-
* @param origin Optional origin for iframe communication
|
|
51
|
-
* @param transferables Optional transferables for postMessage
|
|
52
|
-
*/
|
|
53
|
-
export declare function postMessageToTarget(target: Target, message: any, origin?: string, transferables?: Transferable[]): void;
|
|
54
|
-
export declare function isNodeWorker(guest: Guest | Target): guest is NodeWorker;
|
|
55
|
-
export declare function isWorkerLike(guest: Guest): guest is WorkerLike;
|
|
56
|
-
export declare function addEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject): void;
|
|
57
|
-
export declare function removeEventListener(target: Target, event: string, handler: EventListenerOrEventListenerObject): void;
|
|
58
|
-
/**
|
|
59
|
-
* Normalize message event data across Web and Node.js environments
|
|
60
|
-
* In web, data is in event.data
|
|
61
|
-
* In Node.js, the event itself contains the data
|
|
62
|
-
*/
|
|
63
|
-
export declare function getEventData(event: any): any;
|
|
64
|
-
export {};
|
package/lib/host.d.ts
DELETED
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
import { Guest, Connection, Schema } from './types';
|
|
2
|
-
/**
|
|
3
|
-
* Perform a handshake with the target iframe, when the handshake is confirmed
|
|
4
|
-
* resolve the connection object containing RPCs and properties
|
|
5
|
-
*
|
|
6
|
-
* @param guest
|
|
7
|
-
* @param schema
|
|
8
|
-
* @returns Promise
|
|
9
|
-
*/
|
|
10
|
-
declare function connect(guest: Guest, schema?: Schema): Promise<Connection>;
|
|
11
|
-
declare const _default: {
|
|
12
|
-
connect: typeof connect;
|
|
13
|
-
};
|
|
14
|
-
export default _default;
|
package/lib/index.d.ts
DELETED
package/lib/rpc.d.ts
DELETED
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
import { Environment, RimlessEvent, Schema, Target } from './types';
|
|
2
|
-
/** Private symbol to which we will assign transferable objects */
|
|
3
|
-
declare const SYM_TRANSFERABLES: unique symbol;
|
|
4
|
-
/**
|
|
5
|
-
* for each function in methods
|
|
6
|
-
* 1. subscribe to an event that the remote can call
|
|
7
|
-
* 2. listen for calls from the remote. When called execute the function and emit the results.
|
|
8
|
-
*
|
|
9
|
-
* @param methods an object of method ids : methods from the local schema
|
|
10
|
-
* @param rpcConnectionID
|
|
11
|
-
* @param listenTo Environment to listen for incoming messages
|
|
12
|
-
* @param sendTo Target to send outgoing messages
|
|
13
|
-
* @param remote The remote API object for the current connection
|
|
14
|
-
* @return a function to cancel all subscriptions
|
|
15
|
-
*/
|
|
16
|
-
export declare function registerLocalMethods(methods: Record<string, (...args: any[]) => any> | undefined, rpcConnectionID: string, listenTo: Environment, sendTo: Target, remote: Schema): () => void;
|
|
17
|
-
/**
|
|
18
|
-
* Create a function that will make an RPC request to the remote with some arguments.
|
|
19
|
-
* Listen to an event that returns the results from the remote.
|
|
20
|
-
*
|
|
21
|
-
* @param rpcCallName
|
|
22
|
-
* @param rpcConnectionID
|
|
23
|
-
* @param event
|
|
24
|
-
* @param listeners
|
|
25
|
-
* @param guest
|
|
26
|
-
*
|
|
27
|
-
* @returns a promise with the result of the RPC
|
|
28
|
-
*/
|
|
29
|
-
export declare function createRPC(rpcCallName: string, rpcConnectionID: string, event: RimlessEvent, listeners: Array<() => void> | undefined, listenTo: Environment, sendTo: Target): (...args: any[]) => Promise<unknown>;
|
|
30
|
-
/**
|
|
31
|
-
* create an object based on the remote schema's methods. Functions in that object will
|
|
32
|
-
* emit an event that will trigger the RPC on the remote.
|
|
33
|
-
*
|
|
34
|
-
* @param schema
|
|
35
|
-
* @param methods
|
|
36
|
-
* @param connectionID
|
|
37
|
-
* @param event
|
|
38
|
-
* @param guest
|
|
39
|
-
*/
|
|
40
|
-
export declare function registerRemoteMethods(schema: Schema | undefined, methodNames: Iterable<string> | undefined, connectionID: string, event: RimlessEvent, listenTo: Environment, sendTo: Target): {
|
|
41
|
-
remote: {
|
|
42
|
-
[x: string]: any;
|
|
43
|
-
};
|
|
44
|
-
unregisterRemote: () => void;
|
|
45
|
-
};
|
|
46
|
-
/**
|
|
47
|
-
* This function is used by API schema declarations and remote function calls alike to
|
|
48
|
-
* indicate which variables should be declared as transferable over `postMessage` calls.
|
|
49
|
-
*
|
|
50
|
-
* @param cb a function that takes a transfer function as an argument and returns an object
|
|
51
|
-
* (in the loose, `typeof foo === "object"` sense)
|
|
52
|
-
* @return result the callback's return value, with an extra array of transferable objects
|
|
53
|
-
* assigned to rimless' private symbol `SYM_TRANSFERABLES`
|
|
54
|
-
*
|
|
55
|
-
* The `transfer(...)` function is called with an object to transfer; if there
|
|
56
|
-
* are many objects to transfer, you may call it multiple times. It will always
|
|
57
|
-
* return the input object. Calling `transfer` only modifies the callback
|
|
58
|
-
* result, not the transferred object itself (or objects themselves).
|
|
59
|
-
*
|
|
60
|
-
* @example
|
|
61
|
-
* host.connect({
|
|
62
|
-
* foo: (...args) => {
|
|
63
|
-
* const foo = new ArrayBuffer(8);
|
|
64
|
-
* return withTransferable((transfer) => transfer(foo));
|
|
65
|
-
* }),
|
|
66
|
-
* });
|
|
67
|
-
*
|
|
68
|
-
* @example
|
|
69
|
-
* host.remote.foo(withTransferable((transfer) => ({
|
|
70
|
-
* stream: transfer(new ReadableStream()),
|
|
71
|
-
* })));
|
|
72
|
-
*/
|
|
73
|
-
export declare const withTransferable: <Transferable, Result extends object>(cb: (transfer: <T extends Transferable>(transferable: T) => T) => Result) => Result & {
|
|
74
|
-
[SYM_TRANSFERABLES]: Transferable[];
|
|
75
|
-
};
|
|
76
|
-
export {};
|
package/lib/types.d.ts
DELETED
|
@@ -1,62 +0,0 @@
|
|
|
1
|
-
export interface NodeWorker {
|
|
2
|
-
on(event: string, handler: any): void;
|
|
3
|
-
off(event: string, handler: any): void;
|
|
4
|
-
postMessage(message: any): void;
|
|
5
|
-
terminate(): void;
|
|
6
|
-
}
|
|
7
|
-
export type WorkerLike = Worker | NodeWorker;
|
|
8
|
-
export declare enum events {
|
|
9
|
-
MESSAGE = "message"
|
|
10
|
-
}
|
|
11
|
-
export declare enum actions {
|
|
12
|
-
HANDSHAKE_REQUEST = "RIMLESS/HANDSHAKE_REQUEST",
|
|
13
|
-
HANDSHAKE_REPLY = "RIMLESS/HANDSHAKE_REPLY",
|
|
14
|
-
RPC_REQUEST = "RIMLESS/RPC_REQUEST",
|
|
15
|
-
RPC_RESOLVE = "RIMLESS/RPC_RESOLVE",
|
|
16
|
-
RPC_REJECT = "RIMLESS/RPC_REJECT"
|
|
17
|
-
}
|
|
18
|
-
export type Schema = Record<string, any>;
|
|
19
|
-
export interface Connection {
|
|
20
|
-
id: string;
|
|
21
|
-
remote: Schema;
|
|
22
|
-
close: () => void;
|
|
23
|
-
}
|
|
24
|
-
export type Connections = Record<string, Connection>;
|
|
25
|
-
export interface RimlessEvent extends EventListener {
|
|
26
|
-
source?: Window;
|
|
27
|
-
origin?: string;
|
|
28
|
-
data: HandshakeRequestPayload | HandshakeConfirmationPayload | RPCRequestPayload | RPCResolvePayload;
|
|
29
|
-
}
|
|
30
|
-
export interface HandshakeRequestPayload {
|
|
31
|
-
action: actions.HANDSHAKE_REQUEST;
|
|
32
|
-
connectionID: string;
|
|
33
|
-
methodNames: string[];
|
|
34
|
-
schema: Schema;
|
|
35
|
-
}
|
|
36
|
-
export interface HandshakeConfirmationPayload {
|
|
37
|
-
action: actions.HANDSHAKE_REPLY;
|
|
38
|
-
connectionID: string;
|
|
39
|
-
methodNames: string[];
|
|
40
|
-
schema: Schema;
|
|
41
|
-
}
|
|
42
|
-
export interface RPCRequestPayload {
|
|
43
|
-
action: actions.RPC_REQUEST;
|
|
44
|
-
args: any[];
|
|
45
|
-
callID: string;
|
|
46
|
-
callName: string;
|
|
47
|
-
connectionID: string;
|
|
48
|
-
}
|
|
49
|
-
export interface RPCResolvePayload {
|
|
50
|
-
action: actions.RPC_RESOLVE | actions.RPC_REJECT;
|
|
51
|
-
result?: any | null;
|
|
52
|
-
error?: Error | null;
|
|
53
|
-
callID: string;
|
|
54
|
-
callName: string;
|
|
55
|
-
connectionID: string;
|
|
56
|
-
}
|
|
57
|
-
export interface EventHandlers {
|
|
58
|
-
onConnectionSetup: (remote: Schema) => Promise<void>;
|
|
59
|
-
}
|
|
60
|
-
export type Guest = WorkerLike | HTMLIFrameElement;
|
|
61
|
-
export type Target = Window | WorkerLike;
|
|
62
|
-
export type Environment = Window | WorkerLike;
|