npm - knitting - Versions diffs - 0.1.46 → 0.1.51 - Mend

knitting 0.1.46 → 0.1.51

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 (62) hide show

package/README.md +326 -95
package/map.md +52 -8
package/package.json +4 -3
package/prebuilds/darwin-arm64-node-127/knitting_shared_memory.node +0 -0
package/prebuilds/darwin-arm64-node-137/knitting_shared_memory.node +0 -0
package/prebuilds/darwin-x64-node-127/knitting_shared_memory.node +0 -0
package/prebuilds/darwin-x64-node-137/knitting_shared_memory.node +0 -0
package/prebuilds/linux-x64-node-127/knitting_shared_memory.node +0 -0
package/prebuilds/linux-x64-node-137/knitting_shared_memory.node +0 -0
package/prebuilds/win32-x64/knitting_windows_shared_memory.dll +0 -0
package/prebuilds/win32-x64-node-127/knitting_shared_memory.node +0 -0
package/prebuilds/win32-x64-node-127/knitting_shm.node +0 -0
package/prebuilds/win32-x64-node-137/knitting_shared_memory.node +0 -0
package/prebuilds/win32-x64-node-137/knitting_shm.node +0 -0
package/scripts/build-native-addons.ts +31 -5
package/src/api.d.ts +3 -2
package/src/api.js +135 -34
package/src/common/task-source.d.ts +1 -0
package/src/common/task-source.js +5 -0
package/src/connections/bun.d.ts +2 -0
package/src/connections/bun.js +64 -9
package/src/connections/deno.d.ts +2 -0
package/src/connections/deno.js +64 -9
package/src/connections/file-descriptor.d.ts +2 -0
package/src/connections/file-descriptor.js +24 -2
package/src/connections/node.d.ts +2 -1
package/src/connections/node.js +17 -14
package/src/connections/posix.d.ts +1 -0
package/src/connections/posix.js +6 -0
package/src/connections/process-shared-buffer.d.ts +3 -1
package/src/connections/process-shared-buffer.js +19 -13
package/src/connections/types.d.ts +2 -0
package/src/connections/windows.d.ts +28 -0
package/src/connections/windows.js +224 -0
package/src/knitting_shared_memory.cc +319 -26
package/src/knitting_windows_shared_memory.cc +156 -0
package/src/memory/lock.js +8 -168
package/src/memory/payloadCodec.js +28 -34
package/src/memory/shared-buffer-io.d.ts +2 -0
package/src/memory/shared-buffer-io.js +23 -0
package/src/runtime/inline-executor.d.ts +2 -2
package/src/runtime/inline-executor.js +15 -3
package/src/runtime/pool.d.ts +3 -14
package/src/runtime/pool.js +12 -543
package/src/runtime/process-worker.d.ts +92 -0
package/src/runtime/process-worker.js +670 -0
package/src/runtime/tx-queue.d.ts +1 -1
package/src/runtime/tx-queue.js +3 -1
package/src/shared/abortSignal.d.ts +1 -1
package/src/shared/abortSignal.js +10 -2
package/src/types.d.ts +67 -8
package/src/worker/bootstrap.d.ts +5 -0
package/src/worker/bootstrap.js +78 -0
package/src/worker/composable-runners.js +0 -8
package/src/worker/loop.js +23 -156
package/src/worker/process-worker-bootstrap.d.ts +8 -0
package/src/worker/process-worker-bootstrap.js +160 -0
package/src/worker/safety/startup.d.ts +2 -1
package/src/worker/safety/startup.js +5 -2
package/src/worker/task-loader.d.ts +2 -1
package/src/worker/task-loader.js +14 -2
package/src/worker/timers.js +19 -5

package/src/shared/abortSignal.js CHANGED Viewed

@@ -111,7 +111,7 @@ export const signalAbortFactory = ({ sab, maxSignals, }) => {
 };
 export class OneShotDeferred {
     #triggered = false;
-    constructor(deferred, onSettle) {
+    constructor(deferred, onSettle, onEmptyReject) {
         const settleOnce = (fn) => (...args) => {
             if (this.#triggered)
                 return;
@@ -121,6 +121,14 @@ export class OneShotDeferred {
         };
         deferred.resolve = settleOnce(deferred.resolve);
         deferred.reject = settleOnce(deferred.reject);
-        deferred.promise.reject = deferred.reject;
+        deferred.promise.reject = (reason) => {
+            if (this.#triggered)
+                return;
+            if (reason === undefined && onEmptyReject !== undefined) {
+                onEmptyReject();
+                return;
+            }
+            deferred.reject(reason);
+        };
     }
 }

package/src/types.d.ts CHANGED Viewed

@@ -22,6 +22,7 @@ type WorkerData = {
     abortSignalMax?: number;
     list: string[];
     ids: number[];
+    names: string[];
     thread: number;
     totalNumberOfThread: number;
     debug?: DebugOptions;
@@ -81,8 +82,9 @@ type TaskLike<AS extends AbortSignalOption = AbortSignalOption> = {
 } : {
     readonly abortSignal: AS;
 });
+type TaskFunctionLike = (...args: any[]) => any;
 type Composed<A extends TaskInput = Args, B extends Args = Args, AS extends AbortSignalOption = undefined> = FixPoint<A, B, AS> & SecondPart;
-type tasks = Record<string, Composed<any, any, AbortSignalOption>>;
+type tasks = Record<string, Composed<any, any, AbortSignalOption> | TaskFunctionLike>;
 type ComposedWithKey = Composed<any, any, AbortSignalOption> & {
     name: string;
 };
@@ -95,11 +97,12 @@ type NormalizeUndefinedSingleArg<T extends unknown[]> = T extends [undefined] ?
 type AbortAwareCallArgs<T extends unknown[]> = T extends [...infer Head, AbortSignalToolkit<any>] ? NormalizeUndefinedSingleArg<Head> : NormalizeUndefinedSingleArg<T>;
 type HostCallArgs<F extends (...args: any[]) => any, AS extends AbortSignalOption> = AS extends undefined ? Parameters<F> : AbortAwareCallArgs<Parameters<F>>;
 type PromisifyCallArgs<F extends (...args: any[]) => any, AS extends AbortSignalOption> = HostCallArgs<F, AS> extends infer T ? T extends unknown[] ? PromisifyArgs<T> : never : never;
-type AbortSignalOfTask<T extends TaskLike<any>> = T extends {
+type TaskCallable<T> = T extends TaskLike<any> ? T["f"] : T extends TaskFunctionLike ? T : never;
+type AbortSignalOfTask<T> = T extends {
     readonly abortSignal: infer AS;
 } ? Extract<AS, AbortSignalOption> : undefined;
-type FunctionMapType<T extends Record<string, TaskLike<any>>> = {
-    [K in keyof T]: PromiseWrapped<T[K]["f"], AbortSignalOfTask<T[K]>>;
+type FunctionMapType<T extends Record<string, TaskLike<any> | TaskFunctionLike>> = {
+    [K in keyof T]: PromiseWrapped<TaskCallable<T[K]>, AbortSignalOfTask<T[K]>>;
 };
 interface FixPointBase<A extends TaskInput, B extends Args, AS extends AbortSignalOption = undefined> {
     readonly f: TaskFn<A, B, AS>;
@@ -125,13 +128,23 @@ type SecondPart = {
      */
     readonly at: number;
     readonly importedFrom: string;
+    /**
+     * Marks a task whose worker-side function is imported dynamically (via
+     * `importTask`). Such tasks must never run on the host inliner lane: their
+     * module import is meant to happen inside the worker so worker permission
+     * policies apply. The pool routes them to worker lanes only, even when the
+     * inliner is enabled for other tasks.
+     */
+    readonly imported?: boolean;
 };
 type SingleTaskPool<A extends TaskInput = Args, B extends Args = Args, AS extends AbortSignalOption = undefined> = {
     call: PromiseWrapped<TaskFn<A, B, AS>, AS>;
     shutdown: (delayMs?: number) => Promise<void>;
+    [Symbol.dispose]: () => void;
 };
-type Pool<T extends Record<string, TaskLike<any>>> = {
+type Pool<T extends Record<string, TaskLike<any> | TaskFunctionLike>> = {
     shutdown: (delayMs?: number) => Promise<void>;
+    [Symbol.dispose]: () => void;
     call: FunctionMapType<T>;
 };
 type ReturnFixed<A extends TaskInput = undefined, B extends Args = undefined, AS extends AbortSignalOption = undefined> = FixPoint<A, B, AS> & SecondPart & {
@@ -164,8 +177,34 @@ type DebugOptions = {
     logHref?: boolean;
     logImportedUrl?: boolean;
 };
+type WorkerBootstrapContext = {
+    readonly thread: number;
+    readonly totalNumberOfThread: number;
+    readonly runtime: "node" | "deno" | "bun" | "unknown";
+};
+type WorkerBootstrapFunction<Data = unknown> = (data: Data, context: WorkerBootstrapContext) => MaybePromise<void>;
+type WorkerBootstrapOptions<Data = unknown> = {
+    /**
+     * Module imported inside the worker before task modules are imported.
+     * Relative paths are resolved from the `createPool(...)` caller.
+     */
+    href: string;
+    /**
+     * Exported bootstrap function name. Defaults to `"default"`.
+     */
+    name?: string;
+    /**
+     * Structured data passed to the bootstrap function.
+     */
+    data?: Data;
+};
 type WorkerSettings = {
     resolveAfterFinishingAll?: true;
+    /**
+     * Privileged async worker hook that runs once before task modules import.
+     * Use it to shape the worker environment before user task code loads.
+     */
+    bootstrap?: WorkerBootstrapOptions;
     /**
      * Experimental worker runtime.
      * "thread" uses Worker/worker_threads. "process" spawns another JavaScript
@@ -173,17 +212,31 @@ type WorkerSettings = {
      */
     runtime?: "thread" | "process";
     /**
-     * Runtime executable to use when runtime is "process". Defaults to "bun".
+     * Runtime executable to use when runtime is "process". Defaults to "deno".
      */
     processRuntime?: "bun" | "deno" | "node";
     /**
      * Command argv to prepend before the process worker runtime command.
-     * Useful for wrappers such as systemd-run, cgexec, nice, or taskset.
+     * Useful for wrappers such as systemd-run, cgexec, nice, taskset, or
+     * docker. Knitting appends the runtime command after this prefix.
      *
      * Example:
      * ["systemd-run", "--scope", "-p", "MemoryMax=500M", "-p", "CPUQuota=25%"]
+     *
+     * With containers, use processSharedMemory: "named", share the IPC
+     * namespace, mount the worker files at the same path, and forward
+     * KNITTING_PROCESS_WORKER plus KNITTING_PROCESS_WORKER_BOOT.
      */
     processCommandPrefix?: string[];
+    /**
+     * How process workers discover their shared-memory control channel.
+     *
+     * "inherit" keeps the POSIX fd-inheritance path and is the default outside
+     * Windows. "named" creates an OS-named shared-memory object that wrappers
+     * such as containers can reopen by name when they share the same IPC
+     * namespace.
+     */
+    processSharedMemory?: ProcessSharedMemoryMode | ProcessSharedMemorySettings;
     timers?: WorkerTimers;
     /**
      * Hard task execution timeout in milliseconds.
@@ -191,6 +244,12 @@ type WorkerSettings = {
      */
     hardTimeoutMs?: number;
 };
+type ProcessSharedMemoryMode = "inherit" | "named";
+type ProcessSharedMemorySettings = {
+    mode?: ProcessSharedMemoryMode;
+    namePrefix?: string;
+    unlinkOnShutdown?: boolean;
+};
 type WorkerTimers = {
     /**
      * Busy-spin budget before parking (microseconds).
@@ -277,7 +336,7 @@ type CreatePool = {
     debug?: DebugOptions;
     source?: string;
 };
-export type { WorkerCall as WorkerCall, WorkerInvoke as WorkerInvoke, WorkerContext as WorkerContext, CreateContext as CreateContext, WorkerData as WorkerData, LockBuffers as LockBuffers, ValidInput as ValidInput, Args as Args, MaybePromise as MaybePromise, TaskInput as TaskInput, TaskTimeout as TaskTimeout, TaskFn as TaskFn, AbortSignalConfig as AbortSignalConfig, AbortSignalOption as AbortSignalOption, AbortSignalMethods as AbortSignalMethods, AbortSignalToolkit as AbortSignalToolkit, Composed as Composed, tasks as tasks, ComposedWithKey as ComposedWithKey, FunctionMapType as FunctionMapType, FixPoint as FixPoint, ImportTaskOptions as ImportTaskOptions, SecondPart as SecondPart, SingleTaskPool as SingleTaskPool, Pool as Pool, ReturnFixed as ReturnFixed, External as External, Inliner as Inliner, BalancerStrategy as BalancerStrategy, Balancer as Balancer, DebugOptions as DebugOptions, WorkerSettings as WorkerSettings, WorkerTimers as WorkerTimers, DispatcherSettings as DispatcherSettings, CreatePool as CreatePool, PayloadBufferMode as PayloadBufferMode, PayloadBufferOptions as PayloadBufferOptions, PermissionProtocol as PermissionProtocol, PermissionProtocolInput as PermissionProtocolInput, ResolvedPermissionProtocol as ResolvedPermissionProtocol, Envelope as Envelope, SharedBufferTextCompat as SharedBufferTextCompat, LockBufferTextCompat as LockBufferTextCompat, SharedBufferRegion as SharedBufferRegion, SharedBufferSource as SharedBufferSource, };
+export type { WorkerCall as WorkerCall, WorkerInvoke as WorkerInvoke, WorkerContext as WorkerContext, CreateContext as CreateContext, WorkerData as WorkerData, LockBuffers as LockBuffers, ValidInput as ValidInput, Args as Args, MaybePromise as MaybePromise, TaskInput as TaskInput, TaskTimeout as TaskTimeout, TaskFn as TaskFn, AbortSignalConfig as AbortSignalConfig, AbortSignalOption as AbortSignalOption, AbortSignalMethods as AbortSignalMethods, AbortSignalToolkit as AbortSignalToolkit, Composed as Composed, tasks as tasks, ComposedWithKey as ComposedWithKey, FunctionMapType as FunctionMapType, FixPoint as FixPoint, ImportTaskOptions as ImportTaskOptions, SecondPart as SecondPart, SingleTaskPool as SingleTaskPool, Pool as Pool, ReturnFixed as ReturnFixed, External as External, Inliner as Inliner, BalancerStrategy as BalancerStrategy, Balancer as Balancer, DebugOptions as DebugOptions, WorkerBootstrapContext as WorkerBootstrapContext, WorkerBootstrapFunction as WorkerBootstrapFunction, WorkerBootstrapOptions as WorkerBootstrapOptions, WorkerSettings as WorkerSettings, ProcessSharedMemoryMode as ProcessSharedMemoryMode, ProcessSharedMemorySettings as ProcessSharedMemorySettings, WorkerTimers as WorkerTimers, DispatcherSettings as DispatcherSettings, CreatePool as CreatePool, PayloadBufferMode as PayloadBufferMode, PayloadBufferOptions as PayloadBufferOptions, PermissionProtocol as PermissionProtocol, PermissionProtocolInput as PermissionProtocolInput, ResolvedPermissionProtocol as ResolvedPermissionProtocol, Envelope as Envelope, SharedBufferTextCompat as SharedBufferTextCompat, LockBufferTextCompat as LockBufferTextCompat, SharedBufferRegion as SharedBufferRegion, SharedBufferSource as SharedBufferSource, };
 export type { Task as Task } from "./memory/lock.js";
 export { LockBound as LockBound, PayloadBuffer as PayloadBuffer, PayloadSignal as PayloadSignal, TaskIndex as TaskIndex, } from "./memory/lock.js";
 export type { RegisterMalloc as RegisterMalloc } from "./memory/regionRegistry.js";

package/src/worker/bootstrap.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export declare const runWorkerBootstrap: ({ bootstrap, thread, totalNumberOfThread, }: {
+    bootstrap: unknown;
+    thread: number;
+    totalNumberOfThread: number;
+}) => Promise<void>;

package/src/worker/bootstrap.js ADDED Viewed

@@ -0,0 +1,78 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { RUNTIME } from "../common/runtime.js";
+import { toModuleUrl } from "../common/module-url.js";
+import { ProcessSharedBuffer } from "../connections/process-shared-buffer.js";
+const DEFAULT_BOOTSTRAP_EXPORT_NAME = "default";
+const isWorkerBootstrapOptions = (value) => {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    return typeof candidate.href === "string" &&
+        candidate.href.length > 0 &&
+        (candidate.name === undefined ||
+            (typeof candidate.name === "string" && candidate.name.length > 0));
+};
+const isProcessSharedBufferMetadata = (value) => {
+    try {
+        ProcessSharedBuffer.fromMetadata(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const reviveWorkerBootstrapValue = (value, seen = new WeakMap()) => {
+    if (isProcessSharedBufferMetadata(value)) {
+        return ProcessSharedBuffer.fromMetadata(value);
+    }
+    if (value === null || typeof value !== "object")
+        return value;
+    const existing = seen.get(value);
+    if (existing !== undefined)
+        return existing;
+    if (Array.isArray(value)) {
+        const out = [];
+        seen.set(value, out);
+        for (const item of value) {
+            out.push(reviveWorkerBootstrapValue(item, seen));
+        }
+        return out;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null)
+        return value;
+    const out = {};
+    seen.set(value, out);
+    for (const [key, item] of Object.entries(value)) {
+        out[key] = reviveWorkerBootstrapValue(item, seen);
+    }
+    return out;
+};
+export const runWorkerBootstrap = async ({ bootstrap, thread, totalNumberOfThread, }) => {
+    if (bootstrap === undefined)
+        return;
+    if (!isWorkerBootstrapOptions(bootstrap)) {
+        throw new TypeError("worker.bootstrap must include a non-empty href");
+    }
+    const module = await import(__rewriteRelativeImportExtension(toModuleUrl(bootstrap.href)));
+    const name = bootstrap.name ?? DEFAULT_BOOTSTRAP_EXPORT_NAME;
+    const selected = module[name];
+    if (typeof selected !== "function") {
+        const available = Object.keys(module).join(", ");
+        throw new TypeError(`worker.bootstrap expected export "${name}" from "${bootstrap.href}" to be a function.` +
+            ` Available exports: ${available || "(none)"}`);
+    }
+    const context = Object.freeze({
+        thread,
+        totalNumberOfThread,
+        runtime: RUNTIME,
+    });
+    await selected(reviveWorkerBootstrapValue(bootstrap.data), context);
+};

package/src/worker/composable-runners.js CHANGED Viewed

@@ -49,12 +49,6 @@ const readSignal = (slot) => {
     const signal = (encodedSignal - ABORT_SIGNAL_META_OFFSET) | 0;
     return signal >= 0 ? signal : NO_ABORT_SIGNAL;
 };
-const throwIfAborted = (signal, hasAborted) => {
-    if (signal === NO_ABORT_SIGNAL)
-        return;
-    if (hasAborted(signal))
-        throw new Error("Task aborted");
-};
 const makeToolkitCache = (hasAborted) => {
     const bySignal = [];
     return (signal) => {
@@ -86,7 +80,6 @@ export const composeWorkerRunner = ({ job, timeout, hasAborted, now, }) => {
     if (!timeout) {
         return (slot) => {
             const signal = readSignal(slot);
-            throwIfAborted(signal, hasAborted);
             if (signal === NO_ABORT_SIGNAL)
                 return job(slot.value);
             return job(slot.value, getToolkit(signal));
@@ -94,7 +87,6 @@ export const composeWorkerRunner = ({ job, timeout, hasAborted, now, }) => {
     }
     return (slot) => {
         const signal = readSignal(slot);
-        throwIfAborted(signal, hasAborted);
         const result = signal === NO_ABORT_SIGNAL
             ? job(slot.value)
             : job(slot.value, getToolkit(signal));

package/src/worker/loop.js CHANGED Viewed

@@ -1,30 +1,18 @@
-import { RUNTIME_IS_MAIN_THREAD, RUNTIME_IS_PROCESS_WORKER, RUNTIME_PARENT_PORT, RUNTIME_PROCESS_WORKER_BOOT_ENV, RUNTIME_PROCESS_WORKER_BOOT_VERSION, RUNTIME_WORKER_DATA, createRuntimeMessageChannel, } from "../common/worker-runtime.js";
-import { isSharedBufferSource, } from "../common/shared-buffer-region.js";
+import { createRuntimeMessageChannel, RUNTIME_IS_MAIN_THREAD, RUNTIME_IS_PROCESS_WORKER, RUNTIME_PARENT_PORT, RUNTIME_WORKER_DATA, } from "../common/worker-runtime.js";
+import { isSharedBufferSource } from "../common/shared-buffer-region.js";
 import { isLockBufferTextCompat } from "../common/shared-buffer-text.js";
 import { createWorkerRxQueue } from "./rx-queue.js";
-import { createSharedMemoryTransport, } from "../ipc/transport/shared-memory.js";
+import { createSharedMemoryTransport } from "../ipc/transport/shared-memory.js";
 import { lock2 } from "../memory/lock.js";
 import { getFunctions } from "./task-loader.js";
-import { pauseGeneric, sleepUntilChanged, whilePausing, } from "./timers.js";
+import { pauseGeneric, sleepUntilChanged, whilePausing } from "./timers.js";
 import { RUNTIME, SET_IMMEDIATE } from "../common/runtime.js";
 import { getNodeProcess } from "../common/node-compat.js";
-import { getDefaultProcessSharedBufferPrimitives, ProcessSharedBuffer, setDefaultProcessSharedBufferPrimitives, } from "../connections/process-shared-buffer.js";
-import { createBunConnectionPrimitives } from "../connections/bun.js";
-import { createDenoConnectionPrimitives } from "../connections/deno.js";
-import { loadNodeFutexAddon } from "../connections/node.js";
-import { installTerminationGuard, installUnhandledRejectionSilencer, installPerformanceNowGuard, scrubWorkerDataSensitiveBuffers, assertWorkerSharedMemoryBootData, assertWorkerImportsResolved, } from "./safety/index.js";
+import { assertWorkerImportsResolved, assertWorkerSharedMemoryBootData, installPerformanceNowGuard, installTerminationGuard, installUnhandledRejectionSilencer, scrubWorkerDataSensitiveBuffers, } from "./safety/index.js";
 import { signalAbortFactory } from "../shared/abortSignal.js";
+import { runWorkerBootstrap } from "./bootstrap.js";
+import { getProcessWorkerNativeWaitU32, installProcessWorkerBootstrap, } from "./process-worker-bootstrap.js";
 const WORKER_FATAL_MESSAGE_KEY = "__knittingWorkerFatal";
-const getProcessWorkerNativeWaitU32 = () => {
-    if (!RUNTIME_IS_PROCESS_WORKER || RUNTIME !== "node")
-        return undefined;
-    try {
-        return loadNodeFutexAddon().waitU32;
-    }
-    catch {
-        return undefined;
-    }
-};
 const reportWorkerStartupFatal = (error) => {
     const message = String(error?.message ?? error);
     const payload = {
@@ -65,7 +53,7 @@ export const workerMainLoop = async (startupData) => {
     installTerminationGuard();
     installUnhandledRejectionSilencer();
     installPerformanceNowGuard();
-    const { debug, sab, thread, startAt, workerOptions, lock, returnLock, abortSignalSAB, abortSignalMax, payloadConfig, permission, totalNumberOfThread, list, ids, at, } = startupData;
+    const { debug, sab, thread, startAt, workerOptions, lock, returnLock, abortSignalSAB, abortSignalMax, payloadConfig, permission, totalNumberOfThread, list, ids, names, at, } = startupData;
     scrubWorkerDataSensitiveBuffers(startupData);
     assertWorkerSharedMemoryBootData({ sab, lock, returnLock });
     let Comment;
@@ -114,14 +102,20 @@ export const workerMainLoop = async (startupData) => {
     const a_store = Atomics.store;
     const a_load = Atomics.load;
     const nativeWaitU32 = getProcessWorkerNativeWaitU32();
+    await runWorkerBootstrap({
+        bootstrap: workerOptions?.bootstrap,
+        thread,
+        totalNumberOfThread,
+    });
     const listOfFunctions = await getFunctions({
         list,
         isWorker: true,
         ids,
+        names,
         at,
         permission,
     });
-    assertWorkerImportsResolved({ debug, list, ids, listOfFunctions });
+    assertWorkerImportsResolved({ debug, list, ids, names, listOfFunctions });
     const abortSignals = abortSignalSAB
         ? signalAbortFactory({
             sab: abortSignalSAB,
@@ -267,6 +261,7 @@ const isWorkerBootPayload = (value) => {
     return isSharedBufferSource(candidate.sab) &&
         Array.isArray(candidate.list) &&
         Array.isArray(candidate.ids) &&
+        Array.isArray(candidate.names) &&
         Array.isArray(candidate.at) &&
         typeof candidate.thread === "number" &&
         typeof candidate.totalNumberOfThread === "number" &&
@@ -307,146 +302,18 @@ const installWorkerGlobalBootstrap = () => {
         start(data);
     };
 };
-const isProcessSharedBufferMetadata = (value) => {
-    try {
-        ProcessSharedBuffer.fromMetadata(value);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-const isProcessWorkerWireLockBuffers = (value) => {
-    if (!value || typeof value !== "object")
-        return false;
-    const candidate = value;
-    return isProcessSharedBufferMetadata(candidate.headers) &&
-        isProcessSharedBufferMetadata(candidate.lockSector) &&
-        isProcessSharedBufferMetadata(candidate.payload) &&
-        isProcessSharedBufferMetadata(candidate.payloadSector) &&
-        (candidate.textCompat === undefined ||
-            isLockBufferTextCompat(candidate.textCompat));
-};
-const isProcessWorkerBootPayload = (value) => {
-    if (!value || typeof value !== "object")
-        return false;
-    const candidate = value;
-    const workerData = candidate.workerData;
-    return candidate.version === RUNTIME_PROCESS_WORKER_BOOT_VERSION &&
-        !!workerData &&
-        isProcessSharedBufferMetadata(workerData.sab) &&
-        Array.isArray(workerData.list) &&
-        Array.isArray(workerData.ids) &&
-        Array.isArray(workerData.at) &&
-        typeof workerData.thread === "number" &&
-        typeof workerData.totalNumberOfThread === "number" &&
-        typeof workerData.startAt === "number" &&
-        (workerData.abortSignalSAB === undefined ||
-            isProcessSharedBufferMetadata(workerData.abortSignalSAB)) &&
-        isProcessWorkerWireLockBuffers(workerData.lock) &&
-        isProcessWorkerWireLockBuffers(workerData.returnLock);
-};
-const getProcessWorkerPrimitives = () => {
-    const primitives = RUNTIME === "bun"
-        ? createBunConnectionPrimitives()
-        : RUNTIME === "deno"
-            ? createDenoConnectionPrimitives()
-            : getDefaultProcessSharedBufferPrimitives();
-    setDefaultProcessSharedBufferPrimitives(primitives);
-    return primitives;
-};
-const reviveProcessWorkerData = (wire) => {
-    const primitives = getProcessWorkerPrimitives();
-    const mappings = new Map();
-    const reviveRegion = (metadata) => {
-        const processBuffer = ProcessSharedBuffer.fromMetadata(metadata);
-        const descriptor = processBuffer.descriptor;
-        const key = `${descriptor.fd}:${descriptor.size}:${descriptor.runtime ?? ""}`;
-        let mapping = mappings.get(key);
-        if (mapping === undefined) {
-            mapping = descriptor.map(primitives);
-            mappings.set(key, mapping);
-        }
-        else {
-            descriptor.attach(mapping);
-        }
-        return {
-            sab: mapping.buffer,
-            byteOffset: processBuffer.byteOffset,
-            byteLength: processBuffer.byteLength,
-        };
-    };
-    const reviveLockBuffers = (lock) => ({
-        ...lock,
-        headers: reviveRegion(lock.headers),
-        lockSector: reviveRegion(lock.lockSector),
-        payload: reviveRegion(lock.payload),
-        payloadSector: reviveRegion(lock.payloadSector),
-    });
-    return {
-        ...wire,
-        sab: reviveRegion(wire.sab),
-        abortSignalSAB: wire.abortSignalSAB === undefined
-            ? undefined
-            : reviveRegion(wire.abortSignalSAB),
-        lock: reviveLockBuffers(wire.lock),
-        returnLock: reviveLockBuffers(wire.returnLock),
-    };
-};
-const installProcessWorkerBootstrap = () => {
-    const processLike = getNodeProcess();
-    const start = (payload) => {
-        const data = reviveProcessWorkerData(payload.workerData);
-        if (!isWorkerBootPayload(data)) {
-            throw new TypeError("invalid process worker boot payload");
-        }
-        void workerMainLoop(data).catch(reportWorkerStartupFatal);
-    };
-    const envBoot = processLike?.env?.[RUNTIME_PROCESS_WORKER_BOOT_ENV];
-    if (typeof envBoot === "string" && envBoot.length > 0) {
-        try {
-            const payload = JSON.parse(envBoot);
-            if (!isProcessWorkerBootPayload(payload)) {
-                throw new TypeError("invalid process worker boot payload");
-            }
-            try {
-                delete processLike?.env?.[RUNTIME_PROCESS_WORKER_BOOT_ENV];
-            }
-            catch {
-            }
-            start(payload);
-        }
-        catch (error) {
-            reportWorkerStartupFatal(error);
-        }
-        return;
-    }
-    if (typeof processLike?.on !== "function")
-        return;
-    const onMessage = (message) => {
-        if (!isProcessWorkerBootPayload(message))
-            return;
-        try {
-            processLike.off?.("message", onMessage);
-            processLike.removeListener?.("message", onMessage);
-        }
-        catch {
-        }
-        try {
-            start(message);
-        }
-        catch (error) {
-            reportWorkerStartupFatal(error);
-        }
-    };
-    processLike.on("message", onMessage);
-};
 if (RUNTIME_IS_MAIN_THREAD === false &&
     isWorkerBootPayload(RUNTIME_WORKER_DATA)) {
     void workerMainLoop(RUNTIME_WORKER_DATA).catch(reportWorkerStartupFatal);
 }
 else if (RUNTIME_IS_PROCESS_WORKER) {
-    installProcessWorkerBootstrap();
+    installProcessWorkerBootstrap({
+        isWorkerBootPayload,
+        reportWorkerStartupFatal,
+        startWorker: (data) => {
+            void workerMainLoop(data).catch(reportWorkerStartupFatal);
+        },
+    });
 }
 else if (isWorkerGlobalScope()) {
     installWorkerGlobalBootstrap();

package/src/worker/process-worker-bootstrap.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import type { WorkerData } from "../types.js";
+import type { NativeWaitU32 } from "./timers.js";
+export declare const getProcessWorkerNativeWaitU32: () => NativeWaitU32 | undefined;
+export declare const installProcessWorkerBootstrap: ({ isWorkerBootPayload, reportWorkerStartupFatal, startWorker, }: {
+    isWorkerBootPayload: (value: unknown) => value is WorkerData;
+    reportWorkerStartupFatal: (error: unknown) => void;
+    startWorker: (data: WorkerData) => void;
+}) => void;