jsilnet 0.1.0 → 0.2.0

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.
Files changed (50) hide show
  1. package/README.md +25 -6
  2. package/REFERENCE.md +4 -0
  3. package/dist/browser/index.js +345 -0
  4. package/dist/browser/worker.js +42480 -0
  5. package/package.json +23 -4
  6. package/src/assembly/instruction-editing.js +165 -0
  7. package/src/assembly/method-removal.js +789 -0
  8. package/src/assembly/pointer-table-editing.js +506 -0
  9. package/src/assembly/portable-pdb-editing.js +441 -0
  10. package/src/browser/index.d.ts +123 -0
  11. package/src/browser/index.js +373 -0
  12. package/src/browser/worker-runtime.js +287 -0
  13. package/src/browser/worker.js +47 -0
  14. package/src/index.d.ts +267 -0
  15. package/src/index.js +107 -1574
  16. package/src/metadata/portable-pdb.js +2 -2
  17. package/src/metadata/strong-name.js +84 -83
  18. package/src/pe/headers.js +1 -1
  19. package/src/platform/bytes.js +21 -0
  20. package/src/platform/compression.js +24 -0
  21. package/src/platform/crypto.js +17 -0
  22. package/src/types/assembly/instruction-editing.d.ts +33 -0
  23. package/src/types/assembly/method-removal.d.ts +3 -0
  24. package/src/types/assembly/pointer-table-editing.d.ts +3 -0
  25. package/src/types/assembly/portable-pdb-editing.d.ts +23 -0
  26. package/src/types/binary/errors.d.ts +7 -0
  27. package/src/types/binary/reader.d.ts +30 -0
  28. package/src/types/il/body.d.ts +51 -0
  29. package/src/types/il/instructions.d.ts +33 -0
  30. package/src/types/il/opcodes.d.ts +2 -0
  31. package/src/types/il/rewrite.d.ts +38 -0
  32. package/src/types/index.d.ts +864 -0
  33. package/src/types/metadata/classic-pdb.d.ts +688 -0
  34. package/src/types/metadata/custom-attributes.d.ts +28 -0
  35. package/src/types/metadata/portable-pdb.d.ts +296 -0
  36. package/src/types/metadata/resources.d.ts +1 -0
  37. package/src/types/metadata/root-writer.d.ts +1 -0
  38. package/src/types/metadata/signatures.d.ts +5 -0
  39. package/src/types/metadata/streams.d.ts +26 -0
  40. package/src/types/metadata/strong-name.d.ts +11 -0
  41. package/src/types/metadata/tables.d.ts +25 -0
  42. package/src/types/metadata/writer.d.ts +16 -0
  43. package/src/types/pe/headers.d.ts +160 -0
  44. package/src/types/platform/bytes.d.ts +3 -0
  45. package/src/types/platform/compression.d.ts +2 -0
  46. package/src/types/platform/crypto.d.ts +4 -0
  47. package/src/types/resolution/module.d.ts +12 -0
  48. package/src/types/writer/patch.d.ts +4 -0
  49. package/src/types/writer/pe.d.ts +9 -0
  50. package/src/types/writer/structural.d.ts +4 -0
@@ -0,0 +1,373 @@
1
+ import { FormatError, UnsupportedFormatError } from "../binary/errors.js";
2
+
3
+ let nextRequestId = 0;
4
+
5
+ function createWorker(workerFactory) {
6
+ if (workerFactory) return workerFactory();
7
+ if (typeof Worker === "undefined") {
8
+ throw new Error("jsILNET browser APIs require Web Worker support");
9
+ }
10
+ return new Worker(new URL("./worker.js", import.meta.url), { type: "module" });
11
+ }
12
+
13
+ function normalizeInput(input, transferInput) {
14
+ if (typeof Blob !== "undefined" && input instanceof Blob) {
15
+ return { input, transfer: [] };
16
+ }
17
+ if (input instanceof ArrayBuffer) {
18
+ const buffer = transferInput ? input : input.slice(0);
19
+ return { input: buffer, transfer: [buffer] };
20
+ }
21
+ if (input instanceof Uint8Array) {
22
+ if (transferInput && input.buffer instanceof ArrayBuffer &&
23
+ input.byteOffset === 0 && input.byteLength === input.buffer.byteLength) {
24
+ return { input: input.buffer, transfer: [input.buffer] };
25
+ }
26
+ const bytes = Uint8Array.from(input);
27
+ return { input: bytes.buffer, transfer: [bytes.buffer] };
28
+ }
29
+ throw new TypeError("Assembly input must be a Uint8Array, ArrayBuffer, or Blob");
30
+ }
31
+
32
+ function encodeCallbacks(value, callbacks, seen = new WeakMap()) {
33
+ if (typeof value === "function") {
34
+ const id = callbacks.size + 1;
35
+ callbacks.set(id, value);
36
+ return { __jsilnetCallback: id };
37
+ }
38
+ if (value === null || typeof value !== "object") return value;
39
+ if (seen.has(value)) return seen.get(value);
40
+ if (typeof Blob !== "undefined" && value instanceof Blob) return value;
41
+ if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) return value;
42
+ const output = value instanceof Map
43
+ ? new Map()
44
+ : value instanceof Set
45
+ ? new Set()
46
+ : Array.isArray(value)
47
+ ? []
48
+ : {};
49
+ seen.set(value, output);
50
+ if (value instanceof Map) {
51
+ for (const [key, item] of value) {
52
+ output.set(encodeCallbacks(key, callbacks, seen), encodeCallbacks(item, callbacks, seen));
53
+ }
54
+ } else if (value instanceof Set) {
55
+ for (const item of value) output.add(encodeCallbacks(item, callbacks, seen));
56
+ } else if (Array.isArray(value)) {
57
+ for (const item of value) output.push(encodeCallbacks(item, callbacks, seen));
58
+ } else {
59
+ for (const key of Object.keys(value)) {
60
+ output[key] = encodeCallbacks(value[key], callbacks, seen);
61
+ }
62
+ }
63
+ return output;
64
+ }
65
+
66
+ function decodeAssemblyReferences(value, assembly, seen = new WeakMap()) {
67
+ if (value === null || typeof value !== "object") return value;
68
+ if (value.__jsilnetAssembly === true) return assembly;
69
+ if (seen.has(value)) return seen.get(value);
70
+ if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) return value;
71
+ const output = value instanceof Map
72
+ ? new Map()
73
+ : value instanceof Set
74
+ ? new Set()
75
+ : Array.isArray(value)
76
+ ? []
77
+ : {};
78
+ seen.set(value, output);
79
+ if (value instanceof Map) {
80
+ for (const [key, item] of value) {
81
+ output.set(
82
+ decodeAssemblyReferences(key, assembly, seen),
83
+ decodeAssemblyReferences(item, assembly, seen)
84
+ );
85
+ }
86
+ } else if (value instanceof Set) {
87
+ for (const item of value) output.add(decodeAssemblyReferences(item, assembly, seen));
88
+ } else if (Array.isArray(value)) {
89
+ for (const item of value) output.push(decodeAssemblyReferences(item, assembly, seen));
90
+ } else {
91
+ for (const key of Object.keys(value)) {
92
+ output[key] = decodeAssemblyReferences(value[key], assembly, seen);
93
+ }
94
+ }
95
+ return output;
96
+ }
97
+
98
+ async function encodeResolverResult(value, currentAssembly, seen = new WeakMap()) {
99
+ if (value instanceof BrowserAssembly) {
100
+ return value === currentAssembly
101
+ ? { __jsilnetAssemblyReference: true }
102
+ : { __jsilnetSerializedAssembly: await value.serialize() };
103
+ }
104
+ if (value === null || typeof value !== "object") {
105
+ if (typeof value === "function" || typeof value === "symbol") {
106
+ throw new TypeError("Resolver results must be structured-cloneable values");
107
+ }
108
+ return value;
109
+ }
110
+ if (seen.has(value)) return seen.get(value);
111
+ if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) return value;
112
+ const output = value instanceof Map
113
+ ? new Map()
114
+ : value instanceof Set
115
+ ? new Set()
116
+ : Array.isArray(value)
117
+ ? []
118
+ : {};
119
+ seen.set(value, output);
120
+ if (value instanceof Map) {
121
+ for (const [key, item] of value) {
122
+ output.set(
123
+ await encodeResolverResult(key, currentAssembly, seen),
124
+ await encodeResolverResult(item, currentAssembly, seen)
125
+ );
126
+ }
127
+ } else if (value instanceof Set) {
128
+ for (const item of value) {
129
+ output.add(await encodeResolverResult(item, currentAssembly, seen));
130
+ }
131
+ } else if (Array.isArray(value)) {
132
+ for (const item of value) output.push(await encodeResolverResult(item, currentAssembly, seen));
133
+ } else {
134
+ for (const key of Object.keys(value)) {
135
+ output[key] = await encodeResolverResult(value[key], currentAssembly, seen);
136
+ }
137
+ }
138
+ return output;
139
+ }
140
+
141
+ function makeError(data) {
142
+ const error = data?.name === "FormatError"
143
+ ? new FormatError(data.message)
144
+ : data?.name === "UnsupportedFormatError"
145
+ ? new UnsupportedFormatError(data.message)
146
+ : new Error(data?.message ?? "Browser worker request failed");
147
+ if (data?.name && data.name !== "FormatError" && data.name !== "UnsupportedFormatError") {
148
+ error.name = data.name;
149
+ }
150
+ if (data && "offset" in data) error.offset = data.offset;
151
+ if (data && "context" in data) error.context = data.context;
152
+ return error;
153
+ }
154
+
155
+ function addRvaMapper(pe) {
156
+ if (!pe || !Array.isArray(pe.sections) || !Number.isInteger(pe.sectionOffset)) return pe;
157
+ pe.rvaToOffset = (rva, size = 1) => {
158
+ if (!Number.isInteger(rva) || !Number.isInteger(size) || rva < 0 || size < 0) {
159
+ throw new FormatError("Invalid RVA range (RVA mapping)");
160
+ }
161
+ if (rva === 0 && size === 0) return 0;
162
+ for (const section of pe.sections) {
163
+ const span = Math.max(section.virtualSize, section.rawSize);
164
+ if (rva < section.virtualAddress || rva - section.virtualAddress >= span) continue;
165
+ const delta = rva - section.virtualAddress;
166
+ if (delta + size > section.rawSize || section.rawPointer + delta + size > pe.bytes.length) {
167
+ throw new FormatError(
168
+ "RVA range is not backed by file data",
169
+ { offset: section.rawPointer + delta, context: `section ${section.name}` }
170
+ );
171
+ }
172
+ return section.rawPointer + delta;
173
+ }
174
+ if (rva < pe.sectionOffset && rva + size <= pe.bytes.length) return rva;
175
+ throw new FormatError(`RVA 0x${rva.toString(16)} is not mapped by a PE section (RVA mapping)`);
176
+ };
177
+ return pe;
178
+ }
179
+
180
+ class WorkerClient {
181
+ #worker;
182
+ #pending = new Map();
183
+ #onMessage;
184
+ #onError;
185
+ #onMessageError;
186
+ #closed = false;
187
+
188
+ constructor(worker) {
189
+ this.#worker = worker;
190
+ this.#onMessage = (event) => {
191
+ const response = event.data;
192
+ const pending = this.#pending.get(response?.id);
193
+ if (!pending) return;
194
+ if (response.type === "resolver") {
195
+ void this.#resolveCallback(response, pending);
196
+ return;
197
+ }
198
+ this.#pending.delete(response.id);
199
+ if (response.ok) pending.resolve(response.value);
200
+ else pending.reject(makeError(response.error));
201
+ };
202
+ this.#onError = (event) => {
203
+ const error = event.error ?? new Error(event.message || "Browser worker failed");
204
+ for (const pending of this.#pending.values()) pending.reject(error);
205
+ this.#pending.clear();
206
+ this.#close();
207
+ };
208
+ this.#onMessageError = () => {
209
+ const error = new Error("Browser worker sent an uncloneable response");
210
+ for (const pending of this.#pending.values()) pending.reject(error);
211
+ this.#pending.clear();
212
+ this.#close();
213
+ };
214
+ worker.addEventListener("message", this.#onMessage);
215
+ worker.addEventListener("error", this.#onError);
216
+ worker.addEventListener("messageerror", this.#onMessageError);
217
+ }
218
+
219
+ request(type, payload = {}, transfer = [], resolverOptions = {}) {
220
+ if (this.#closed) {
221
+ return Promise.reject(new Error("Browser worker is closed"));
222
+ }
223
+ const id = ++nextRequestId;
224
+ return new Promise((resolve, reject) => {
225
+ const callbacks = new Map();
226
+ const encodedPayload = encodeCallbacks(payload, callbacks);
227
+ this.#pending.set(id, { resolve, reject, callbacks, resolverOptions });
228
+ try {
229
+ this.#worker.postMessage({ id, type, ...encodedPayload }, transfer);
230
+ } catch (error) {
231
+ this.#pending.delete(id);
232
+ if (error?.name === "DataCloneError") {
233
+ reject(new TypeError("Browser Worker request contains a non-cloneable value"));
234
+ } else {
235
+ reject(error);
236
+ }
237
+ }
238
+ });
239
+ }
240
+
241
+ async #resolveCallback(response, pending) {
242
+ const callback = pending.callbacks.get(response.callbackId);
243
+ try {
244
+ if (!callback) throw new TypeError("Worker requested an unknown resolver callback");
245
+ const args = pending.resolverOptions.decodeArguments
246
+ ? pending.resolverOptions.decodeArguments(response.args)
247
+ : response.args;
248
+ const result = await callback(...args);
249
+ if (this.#closed || !this.#pending.has(response.id)) return;
250
+ const value = pending.resolverOptions.encodeResult
251
+ ? await pending.resolverOptions.encodeResult(result)
252
+ : result;
253
+ if (this.#closed || !this.#pending.has(response.id)) return;
254
+ this.#worker.postMessage({
255
+ type: "resolverResult",
256
+ id: response.id,
257
+ resolverRequestId: response.resolverRequestId,
258
+ ok: true,
259
+ value
260
+ });
261
+ } catch (error) {
262
+ if (this.#closed || !this.#pending.has(response.id)) return;
263
+ this.#worker.postMessage({
264
+ type: "resolverResult",
265
+ id: response.id,
266
+ resolverRequestId: response.resolverRequestId,
267
+ ok: false,
268
+ error: {
269
+ name: error?.name ?? "Error",
270
+ message: error?.message ?? String(error)
271
+ }
272
+ });
273
+ }
274
+ }
275
+
276
+ dispose() {
277
+ if (this.#closed) return;
278
+ for (const pending of this.#pending.values()) {
279
+ pending.reject(new Error("Browser worker was disposed"));
280
+ }
281
+ this.#pending.clear();
282
+ this.#close();
283
+ }
284
+
285
+ #close() {
286
+ if (this.#closed) return;
287
+ this.#closed = true;
288
+ this.#worker.removeEventListener("message", this.#onMessage);
289
+ this.#worker.removeEventListener("error", this.#onError);
290
+ this.#worker.removeEventListener("messageerror", this.#onMessageError);
291
+ this.#worker.terminate();
292
+ }
293
+ }
294
+
295
+ export class BrowserAssembly {
296
+ #client;
297
+ #proxy;
298
+
299
+ constructor(client) {
300
+ this.#client = client;
301
+ }
302
+
303
+ static async from(input, { workerFactory, transferInput = false } = {}) {
304
+ const normalizedInput = normalizeInput(input, transferInput);
305
+ const worker = createWorker(workerFactory);
306
+ const client = new WorkerClient(worker);
307
+ const { input: inputValue, transfer } = normalizedInput;
308
+ try {
309
+ await client.request("parse", { input: inputValue }, transfer);
310
+ const instance = new BrowserAssembly(client);
311
+ instance.#proxy = new Proxy(instance, {
312
+ get(target, property, receiver) {
313
+ if (property === "then") return undefined;
314
+ if (Reflect.has(target, property)) {
315
+ const value = Reflect.get(target, property, target);
316
+ return typeof value === "function" ? value.bind(target) : value;
317
+ }
318
+ if (typeof property === "string") {
319
+ return (...args) => target.#call(property, args);
320
+ }
321
+ return undefined;
322
+ }
323
+ });
324
+ return instance.#proxy;
325
+ } catch (error) {
326
+ client.dispose();
327
+ throw error;
328
+ }
329
+ }
330
+
331
+ async getState() {
332
+ return this.#client.request("state");
333
+ }
334
+
335
+ async callUtility(name, ...args) {
336
+ const result = await this.#client.request("utility", { name, args });
337
+ return name === "parsePE" ? addRvaMapper(result) : result;
338
+ }
339
+
340
+ async #call(name, args) {
341
+ const result = await this.#client.request(
342
+ "call",
343
+ { name, args },
344
+ [],
345
+ {
346
+ decodeArguments: (value) => decodeAssemblyReferences(value, this.#proxy),
347
+ encodeResult: (value) => encodeResolverResult(value, this.#proxy)
348
+ }
349
+ );
350
+ return result?.__jsilnetAssembly === true ? this.#proxy : result;
351
+ }
352
+
353
+ dispose() {
354
+ this.#client.dispose();
355
+ }
356
+ }
357
+
358
+ export async function parseAssembly(input, options) {
359
+ return BrowserAssembly.from(input, options);
360
+ }
361
+
362
+ export async function callUtility(name, ...args) {
363
+ const worker = createWorker();
364
+ const client = new WorkerClient(worker);
365
+ try {
366
+ const result = await client.request("utility", { name, args });
367
+ return name === "parsePE" ? addRvaMapper(result) : result;
368
+ } finally {
369
+ client.dispose();
370
+ }
371
+ }
372
+
373
+ export { BrowserAssembly as Assembly, FormatError, UnsupportedFormatError };
@@ -0,0 +1,287 @@
1
+ import * as core from "../index.js";
2
+ import { Assembly, parseAssembly } from "../index.js";
3
+
4
+ const assemblyMethods = new Set(
5
+ Object.getOwnPropertyNames(Assembly.prototype).filter((name) => name !== "constructor")
6
+ );
7
+
8
+ function cloneValue(value, assembly, seen = new WeakMap(), functionMode = "omit") {
9
+ if (assembly !== null && value === assembly) return { __jsilnetAssembly: true };
10
+ if (value === null || typeof value !== "object") {
11
+ if (typeof value !== "function") return value;
12
+ if (functionMode === "omit") return undefined;
13
+ if (value.name === "rvaToOffset") return { __jsilnetFunction: "pe.rvaToOffset" };
14
+ throw new TypeError("Browser utility returned an unsupported function-valued property");
15
+ }
16
+ if (seen.has(value)) return seen.get(value);
17
+ if (value instanceof ArrayBuffer) return value.slice(0);
18
+ if (ArrayBuffer.isView(value)) {
19
+ if (value instanceof DataView) {
20
+ return new DataView(value.buffer.slice(value.byteOffset, value.byteOffset + value.byteLength));
21
+ }
22
+ if (value instanceof Uint8Array) return Uint8Array.from(value);
23
+ return new value.constructor(value);
24
+ }
25
+ if (value instanceof Map) {
26
+ const output = new Map();
27
+ seen.set(value, output);
28
+ for (const [key, item] of value) {
29
+ output.set(
30
+ cloneValue(key, assembly, seen, functionMode),
31
+ cloneValue(item, assembly, seen, functionMode)
32
+ );
33
+ }
34
+ return output;
35
+ }
36
+ if (value instanceof Set) {
37
+ const output = new Set();
38
+ seen.set(value, output);
39
+ for (const item of value) output.add(cloneValue(item, assembly, seen, functionMode));
40
+ return output;
41
+ }
42
+ if (Array.isArray(value)) {
43
+ const output = [];
44
+ seen.set(value, output);
45
+ for (const item of value) output.push(cloneValue(item, assembly, seen, functionMode));
46
+ return output;
47
+ }
48
+ const output = {};
49
+ seen.set(value, output);
50
+ for (const key of Object.keys(value)) {
51
+ const item = cloneValue(value[key], assembly, seen, functionMode);
52
+ if (item !== undefined) output[key] = item;
53
+ }
54
+ return output;
55
+ }
56
+
57
+ class ResolverRequest extends Error {
58
+ constructor(callbackId, args) {
59
+ super("Browser resolver callback required");
60
+ this.callbackId = callbackId;
61
+ this.args = args;
62
+ }
63
+ }
64
+
65
+ function stableValue(value, assembly, seen = new WeakSet()) {
66
+ if (assembly !== null && value === assembly) return { assembly: true };
67
+ if (value === null || typeof value !== "object") {
68
+ if (typeof value === "bigint") return `${value}n`;
69
+ if (typeof value === "undefined") return "__undefined";
70
+ return value;
71
+ }
72
+ if (seen.has(value)) return "__cycle";
73
+ seen.add(value);
74
+ if (value instanceof ArrayBuffer) return [...new Uint8Array(value)];
75
+ if (ArrayBuffer.isView(value)) {
76
+ return {
77
+ type: value.constructor.name,
78
+ values: [...new Uint8Array(value.buffer, value.byteOffset, value.byteLength)]
79
+ };
80
+ }
81
+ if (value instanceof Map) {
82
+ return [...value].map(([key, item]) => [
83
+ stableValue(key, assembly, seen),
84
+ stableValue(item, assembly, seen)
85
+ ]);
86
+ }
87
+ if (value instanceof Set) return [...value].map((item) => stableValue(item, assembly, seen));
88
+ if (Array.isArray(value)) return value.map((item) => stableValue(item, assembly, seen));
89
+ return Object.fromEntries(Object.keys(value).sort().map((key) => [
90
+ key,
91
+ stableValue(value[key], assembly, seen)
92
+ ]));
93
+ }
94
+
95
+ function decodeResolverResult(value, assembly, seen = new WeakMap()) {
96
+ if (value === null || typeof value !== "object") return value;
97
+ if (value.__jsilnetAssemblyReference === true) return assembly;
98
+ if (value.__jsilnetSerializedAssembly instanceof Uint8Array) {
99
+ return parseAssembly(value.__jsilnetSerializedAssembly);
100
+ }
101
+ if (seen.has(value)) return seen.get(value);
102
+ if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) return value;
103
+ const output = value instanceof Map
104
+ ? new Map()
105
+ : value instanceof Set
106
+ ? new Set()
107
+ : Array.isArray(value)
108
+ ? []
109
+ : {};
110
+ seen.set(value, output);
111
+ if (value instanceof Map) {
112
+ for (const [key, item] of value) {
113
+ output.set(
114
+ decodeResolverResult(key, assembly, seen),
115
+ decodeResolverResult(item, assembly, seen)
116
+ );
117
+ }
118
+ } else if (value instanceof Set) {
119
+ for (const item of value) output.add(decodeResolverResult(item, assembly, seen));
120
+ } else if (Array.isArray(value)) {
121
+ for (const item of value) output.push(decodeResolverResult(item, assembly, seen));
122
+ } else {
123
+ for (const key of Object.keys(value)) {
124
+ output[key] = decodeResolverResult(value[key], assembly, seen);
125
+ }
126
+ }
127
+ return output;
128
+ }
129
+
130
+ function restoreCallbacks(value, cache, assembly, seen = new WeakMap()) {
131
+ if (value === null || typeof value !== "object") return value;
132
+ if (Number.isInteger(value.__jsilnetCallback)) {
133
+ const callbackId = value.__jsilnetCallback;
134
+ return (...args) => {
135
+ const key = `${callbackId}:${JSON.stringify(stableValue(args, assembly))}`;
136
+ if (cache.has(key)) return cache.get(key);
137
+ throw new ResolverRequest(callbackId, args);
138
+ };
139
+ }
140
+ if (seen.has(value)) return seen.get(value);
141
+ if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) return value;
142
+ const output = value instanceof Map
143
+ ? new Map()
144
+ : value instanceof Set
145
+ ? new Set()
146
+ : Array.isArray(value)
147
+ ? []
148
+ : {};
149
+ seen.set(value, output);
150
+ if (value instanceof Map) {
151
+ for (const [key, item] of value) {
152
+ output.set(
153
+ restoreCallbacks(key, cache, assembly, seen),
154
+ restoreCallbacks(item, cache, assembly, seen)
155
+ );
156
+ }
157
+ } else if (value instanceof Set) {
158
+ for (const item of value) output.add(restoreCallbacks(item, cache, assembly, seen));
159
+ } else if (Array.isArray(value)) {
160
+ for (const item of value) output.push(restoreCallbacks(item, cache, assembly, seen));
161
+ } else {
162
+ for (const key of Object.keys(value)) {
163
+ output[key] = restoreCallbacks(value[key], cache, assembly, seen);
164
+ }
165
+ }
166
+ return output;
167
+ }
168
+
169
+ function getState(assembly) {
170
+ const state = {};
171
+ for (const key of Object.keys(assembly)) {
172
+ if (!key.startsWith("_")) state[key] = cloneValue(assembly[key], assembly);
173
+ }
174
+ state.bytes = cloneValue(assembly.bytes, assembly);
175
+ state.modified = assembly.modified;
176
+ return state;
177
+ }
178
+
179
+ function serializeError(error) {
180
+ return {
181
+ name: error?.name ?? "Error",
182
+ message: error?.message ?? String(error),
183
+ offset: error?.offset,
184
+ context: error?.context
185
+ };
186
+ }
187
+
188
+ export function createWorkerController({ requestResolver } = {}) {
189
+ let assembly = null;
190
+ let nextResolverRequestId = 0;
191
+ async function invokeWithResolvers(message, operation, input, activeAssembly, resolveCallback) {
192
+ const resolverCache = new Map();
193
+ while (true) {
194
+ try {
195
+ return operation(...restoreCallbacks(input, resolverCache, activeAssembly));
196
+ } catch (error) {
197
+ if (!(error instanceof ResolverRequest)) throw error;
198
+ if (typeof resolveCallback !== "function") {
199
+ throw new Error("Browser resolver callback channel is unavailable");
200
+ }
201
+ const resolverRequestId = ++nextResolverRequestId;
202
+ const value = await new Promise((resolve, reject) => {
203
+ resolveCallback(
204
+ message.id,
205
+ resolverRequestId,
206
+ error.callbackId,
207
+ cloneValue(error.args, activeAssembly),
208
+ (response) => {
209
+ if (response.ok) resolve(response.value);
210
+ else {
211
+ const failure = new Error(
212
+ response.error?.message ?? "Resolver callback failed"
213
+ );
214
+ failure.name = response.error?.name ?? "Error";
215
+ reject(failure);
216
+ }
217
+ }
218
+ );
219
+ });
220
+ const key = `${error.callbackId}:${JSON.stringify(
221
+ stableValue(error.args, activeAssembly)
222
+ )}`;
223
+ resolverCache.set(key, decodeResolverResult(value, activeAssembly));
224
+ }
225
+ }
226
+ }
227
+ return async function handle(message, resolveCallback = requestResolver) {
228
+ try {
229
+ if (message?.type === "parse") {
230
+ const input = typeof Blob !== "undefined" && message.input instanceof Blob
231
+ ? await message.input.arrayBuffer()
232
+ : message.input;
233
+ assembly = parseAssembly(input);
234
+ return { id: message.id, ok: true, value: null };
235
+ }
236
+ if (message?.type === "dispose") {
237
+ assembly = null;
238
+ return { id: message.id, ok: true, value: null };
239
+ }
240
+ if (message?.type === "state") {
241
+ if (!assembly) throw new Error("No assembly has been loaded");
242
+ return { id: message.id, ok: true, value: getState(assembly) };
243
+ }
244
+ if (message?.type === "call") {
245
+ if (!assembly) throw new Error("No assembly has been loaded");
246
+ if (!assemblyMethods.has(message.name)) {
247
+ throw new TypeError(`Assembly method ${String(message.name)} is not available`);
248
+ }
249
+ const result = await invokeWithResolvers(
250
+ message,
251
+ (...args) => assembly[message.name](...args),
252
+ message.args,
253
+ assembly,
254
+ resolveCallback
255
+ );
256
+ return {
257
+ id: message.id,
258
+ ok: true,
259
+ value: result === assembly
260
+ ? { __jsilnetAssembly: true }
261
+ : cloneValue(result, assembly)
262
+ };
263
+ }
264
+ if (message?.type === "utility") {
265
+ const operation = core[message.name];
266
+ if (typeof operation !== "function" || message.name === "parseAssembly") {
267
+ throw new TypeError(`Library utility ${String(message.name)} is not available`);
268
+ }
269
+ const result = await invokeWithResolvers(
270
+ message,
271
+ operation,
272
+ message.args,
273
+ assembly,
274
+ resolveCallback
275
+ );
276
+ return {
277
+ id: message.id,
278
+ ok: true,
279
+ value: cloneValue(result, assembly, new WeakMap(), "encode")
280
+ };
281
+ }
282
+ throw new TypeError("Unknown browser worker request");
283
+ } catch (error) {
284
+ return { id: message?.id, ok: false, error: serializeError(error) };
285
+ }
286
+ };
287
+ }
@@ -0,0 +1,47 @@
1
+ import { createWorkerController } from "./worker-runtime.js";
2
+
3
+ const handle = createWorkerController();
4
+ const pendingResolvers = new Map();
5
+
6
+ function collectTransferables(value, transferables = new Set(), seen = new WeakSet()) {
7
+ if (value === null || typeof value !== "object" || seen.has(value)) return transferables;
8
+ seen.add(value);
9
+ if (value instanceof ArrayBuffer) {
10
+ transferables.add(value);
11
+ } else if (ArrayBuffer.isView(value)) {
12
+ if (value.buffer instanceof ArrayBuffer) transferables.add(value.buffer);
13
+ } else if (value instanceof Map) {
14
+ for (const [key, item] of value) {
15
+ collectTransferables(key, transferables, seen);
16
+ collectTransferables(item, transferables, seen);
17
+ }
18
+ } else if (value instanceof Set || Array.isArray(value)) {
19
+ for (const item of value) collectTransferables(item, transferables, seen);
20
+ } else {
21
+ for (const item of Object.values(value)) collectTransferables(item, transferables, seen);
22
+ }
23
+ return transferables;
24
+ }
25
+
26
+ function requestResolver(id, resolverRequestId, callbackId, args, resolve) {
27
+ const key = `${id}:${resolverRequestId}`;
28
+ pendingResolvers.set(key, resolve);
29
+ const request = { type: "resolver", id, resolverRequestId, callbackId, args };
30
+ self.postMessage(request, [...collectTransferables(request)]);
31
+ }
32
+
33
+ self.addEventListener("message", async (event) => {
34
+ const message = event.data;
35
+ if (message?.type === "resolverResult") {
36
+ const key = `${message.id}:${message.resolverRequestId}`;
37
+ const resolve = pendingResolvers.get(key);
38
+ if (!resolve) return;
39
+ pendingResolvers.delete(key);
40
+ resolve(message);
41
+ return;
42
+ }
43
+ const response = await handle(message, (id, resolverRequestId, callbackId, args, resolve) => {
44
+ requestResolver(id, resolverRequestId, callbackId, args, resolve);
45
+ });
46
+ self.postMessage(response, [...collectTransferables(response)]);
47
+ });