@rift-vs/rift-embedded 0.12.1-snapshot.104.g9a93306

package/dist/native-call.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The FFI call discipline (issue #8) — pure, koffi-free, unit-testable against a fake
+ * `NativeBinding`. Implements the last-error + decode + free contract every `librift_ffi` call
+ * must follow:
+ *
+ *   - A per-return-kind SENTINEL (`NULL` for `char*`/handle fns, `0` for `rift_create_imposter`,
+ *     `-1` for `int32` fns) means failure — read `rift_last_error()`; a populated slot decodes to
+ *     the engine's diagnostic (and gets freed), an empty slot ("no diagnostic") gets a generic,
+ *     fn-named message instead.
+ *   - A non-sentinel `char*` success gets decoded to a JS string and freed.
+ *   - Numeric/void successes pass through untouched — nothing to free.
+ *
+ * `rift_build_info` is deliberately NOT part of this dispatch table: it's a static, always-present
+ * probe read once at init via {@link readBuildInfo}, bypassing the sentinel path, and it is never
+ * freed (freeing a `const char*` the library owns statically would be a use-after-free/heap
+ * corruption bug on the native side).
+ */
+import type { NativeBinding, NativeCallableFn, NativePtr } from './native-binding.js';
+/** The worker's native state: the koffi binding, its decode fn, and the `RiftHandle*` from
+ * `rift_start` (worker-local — never crosses the structured-clone boundary). */
+export interface WorkerNativeState {
+    binding: NativeBinding;
+    decode: Decode;
+    handle: NativePtr;
+}
+/** Decodes a raw native pointer to a JS string. In production this is `(p) => koffi.decode(p,
+ * 'string')`; tests inject a fake so this module never has to import koffi. */
+export type Decode = (ptr: NativePtr) => string;
+export interface NativeCallRequest {
+    id: number;
+    fn: NativeCallableFn;
+    args: unknown[];
+}
+export interface NativeCallError {
+    message: string;
+    fn: string;
+}
+export interface NativeCallOk {
+    id: number;
+    ok: true;
+    value: string | number | null;
+}
+export interface NativeCallErr {
+    id: number;
+    ok: false;
+    error: NativeCallError;
+}
+export type NativeCallResponse = NativeCallOk | NativeCallErr;
+/**
+ * Reads and clears the last-error slot, producing the discipline's two failure shapes: the
+ * engine's own diagnostic when the slot is populated (freed after decode), or a generic
+ * "no diagnostic" message when it's empty — still a failure, just an undiagnosed one, never
+ * swallowed into a success. Shared by `handleCall`'s sentinel path and by the worker's
+ * `rift_start`-returned-NULL init failure, which needs the exact same discipline outside the
+ * dispatch table `handleCall` covers.
+ */
+export declare function readLastErrorMessage(binding: NativeBinding, decode: Decode, fn: string): NativeCallError;
+/** Reads the static `rift_build_info` string. Deliberately bypasses the sentinel path — it's
+ * always present by construction — and never frees the pointer (it's static, library-owned). */
+export declare function readBuildInfo(binding: NativeBinding, decode: Decode): string;
+/**
+ * Invokes `binding[req.fn](...req.args)` and applies the last-error + decode + free discipline
+ * described above. Pure and synchronous: its only I/O is calling the given `binding`/`decode`,
+ * which is exactly what makes it unit-testable with a FAKE binding — no worker thread, no koffi,
+ * no cdylib required.
+ */
+export declare function handleCall(binding: NativeBinding, req: NativeCallRequest, decode: Decode): NativeCallResponse;
+/**
+ * Dispatches a worker `call` message against the worker's native state: rejects a pre-init call,
+ * prepends the worker-local `handle` to the args, and — crucially — converts ANY throw out of the
+ * native call (a koffi arg/type mismatch, a bad pointer into `decode`, the exhaustiveness guards
+ * above) into an error response carrying `id`. Without this, a throwing call would escape the
+ * worker's message handler, emit `'error'` on the parent Worker, and never post a result — hanging
+ * the caller and risking a host-process crash. Pure and testable with a fake `WorkerNativeState`.
+ */
+export declare function handleCallMessage(native: WorkerNativeState | null, req: NativeCallRequest): NativeCallResponse;
+//# sourceMappingURL=native-call.d.ts.map

package/dist/native-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-call.d.ts","sourceRoot":"","sources":["../src/native-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAc,MAAM,qBAAqB,CAAC;AAElG;gFACgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;+EAC+E;AAC/E,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,aAAa,CAAC;AAO9D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,CAQxG;AAED;gGACgG;AAChG,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5E;AAmBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAyB7G;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAChC,GAAG,EAAE,iBAAiB,GACrB,kBAAkB,CAqBpB"}

package/dist/native-call.js

@@ -0,0 +1,118 @@
+/**
+ * The FFI call discipline (issue #8) — pure, koffi-free, unit-testable against a fake
+ * `NativeBinding`. Implements the last-error + decode + free contract every `librift_ffi` call
+ * must follow:
+ *
+ *   - A per-return-kind SENTINEL (`NULL` for `char*`/handle fns, `0` for `rift_create_imposter`,
+ *     `-1` for `int32` fns) means failure — read `rift_last_error()`; a populated slot decodes to
+ *     the engine's diagnostic (and gets freed), an empty slot ("no diagnostic") gets a generic,
+ *     fn-named message instead.
+ *   - A non-sentinel `char*` success gets decoded to a JS string and freed.
+ *   - Numeric/void successes pass through untouched — nothing to free.
+ *
+ * `rift_build_info` is deliberately NOT part of this dispatch table: it's a static, always-present
+ * probe read once at init via {@link readBuildInfo}, bypassing the sentinel path, and it is never
+ * freed (freeing a `const char*` the library owns statically would be a use-after-free/heap
+ * corruption bug on the native side).
+ */
+import { RETURN_KIND } from './native-binding.js';
+function invoke(binding, fn, args) {
+    const method = binding[fn];
+    return method.apply(binding, args);
+}
+/**
+ * Reads and clears the last-error slot, producing the discipline's two failure shapes: the
+ * engine's own diagnostic when the slot is populated (freed after decode), or a generic
+ * "no diagnostic" message when it's empty — still a failure, just an undiagnosed one, never
+ * swallowed into a success. Shared by `handleCall`'s sentinel path and by the worker's
+ * `rift_start`-returned-NULL init failure, which needs the exact same discipline outside the
+ * dispatch table `handleCall` covers.
+ */
+export function readLastErrorMessage(binding, decode, fn) {
+    const errPtr = binding.rift_last_error();
+    if (errPtr === null) {
+        return { message: `${fn} failed with no engine diagnostic`, fn };
+    }
+    const message = decode(errPtr);
+    binding.rift_free(errPtr);
+    return { message, fn };
+}
+/** Reads the static `rift_build_info` string. Deliberately bypasses the sentinel path — it's
+ * always present by construction — and never frees the pointer (it's static, library-owned). */
+export function readBuildInfo(binding, decode) {
+    return decode(binding.rift_build_info());
+}
+function isSentinel(kind, result) {
+    switch (kind) {
+        case 'uint16':
+            return result === 0;
+        case 'int32':
+            return result === -1;
+        case 'string':
+            return result === null;
+        case 'void':
+            return false;
+        default: {
+            const exhaustive = kind;
+            throw new Error(`native-call: unhandled return kind ${String(exhaustive)}`);
+        }
+    }
+}
+/**
+ * Invokes `binding[req.fn](...req.args)` and applies the last-error + decode + free discipline
+ * described above. Pure and synchronous: its only I/O is calling the given `binding`/`decode`,
+ * which is exactly what makes it unit-testable with a FAKE binding — no worker thread, no koffi,
+ * no cdylib required.
+ */
+export function handleCall(binding, req, decode) {
+    const { id, fn, args } = req;
+    const kind = RETURN_KIND[fn];
+    const result = invoke(binding, fn, args);
+    if (isSentinel(kind, result)) {
+        return { id, ok: false, error: readLastErrorMessage(binding, decode, fn) };
+    }
+    switch (kind) {
+        case 'void':
+            return { id, ok: true, value: null };
+        case 'uint16':
+        case 'int32':
+            return { id, ok: true, value: result };
+        case 'string': {
+            const value = decode(result);
+            binding.rift_free(result);
+            return { id, ok: true, value };
+        }
+        default: {
+            const exhaustive = kind;
+            throw new Error(`native-call: unhandled return kind ${String(exhaustive)}`);
+        }
+    }
+}
+/**
+ * Dispatches a worker `call` message against the worker's native state: rejects a pre-init call,
+ * prepends the worker-local `handle` to the args, and — crucially — converts ANY throw out of the
+ * native call (a koffi arg/type mismatch, a bad pointer into `decode`, the exhaustiveness guards
+ * above) into an error response carrying `id`. Without this, a throwing call would escape the
+ * worker's message handler, emit `'error'` on the parent Worker, and never post a result — hanging
+ * the caller and risking a host-process crash. Pure and testable with a fake `WorkerNativeState`.
+ */
+export function handleCallMessage(native, req) {
+    if (native === null) {
+        return {
+            id: req.id,
+            ok: false,
+            error: { message: 'embedded worker received a call before init completed', fn: req.fn },
+        };
+    }
+    try {
+        return handleCall(native.binding, { id: req.id, fn: req.fn, args: [native.handle, ...req.args] }, native.decode);
+    }
+    catch (err) {
+        return {
+            id: req.id,
+            ok: false,
+            error: { message: err instanceof Error ? err.message : String(err), fn: req.fn },
+        };
+    }
+}
+//# sourceMappingURL=native-call.js.map

package/dist/native-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-call.js","sourceRoot":"","sources":["../src/native-call.ts"],"names":[],"mappings":"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"}

package/dist/native.d.ts

@@ -0,0 +1,76 @@
+/**
+ * `NativeEngine` — the embedded transport's main-thread facade (issue #8).
+ *
+ * Owns the worker_threads lifecycle and the request/response correlation on top of the protocol
+ * in `protocol.ts`; the actual FFI discipline lives in `native-call.ts` and runs inside
+ * `worker.ts`, not here. `load()` spawns the worker, sends `{type:'init', libPath}`, and awaits
+ * `{type:'ready'}`/`{type:'init-error'}`. `close()` is idempotent, rejects in-flight calls with a
+ * clear error, and force-`terminate()`s if the worker doesn't exit within the shutdown timeout.
+ *
+ * The worker transport is injectable (`createWorker`) precisely so this protocol is unit-testable
+ * without spawning a real `worker_threads.Worker` — see `test/unit/embedded-worker.test.ts`.
+ */
+/** The subset of `worker_threads.Worker`'s surface `NativeEngine` depends on — small enough that
+ * tests can satisfy it with a plain fake, and a real `Worker` satisfies it structurally as-is. */
+export interface WorkerLike {
+    postMessage(message: unknown): void;
+    on(event: string, listener: (...args: unknown[]) => void): void;
+    off(event: string, listener: (...args: unknown[]) => void): void;
+    terminate(): Promise<number>;
+    ref(): void;
+    unref(): void;
+}
+export interface NativeEngineLoadOptions {
+    /** Injectable worker transport; defaults to a real `worker_threads.Worker` running `worker.js`. */
+    createWorker?: () => WorkerLike;
+    /** Keep the worker (and therefore the process) alive while the engine is open, instead of only
+     * while a call is in flight — the standalone mock-server shape (#70). Default false: an idle
+     * engine never blocks process exit. */
+    keepAlive?: boolean;
+}
+export declare class NativeEngine {
+    #private;
+    readonly buildInfo: string;
+    private constructor();
+    /**
+     * Spawns the worker, performs the init handshake, and resolves once it reports `ready`. Rejects
+     * with a `NativeLibraryError` on `init-error` (koffi missing, cdylib missing/incompatible, ABI
+     * v1), terminating the worker first so a failed load never leaks a thread.
+     */
+    static load(libPath: string, opts?: NativeEngineLoadOptions): Promise<NativeEngine>;
+    /**
+     * Idempotent: a second `close()` returns the same in-flight/completed close. Rejects every
+     * currently-pending call with a clear "closing" error (never lets one dangle waiting on a
+     * response that a shutting-down worker may never send), then asks the worker to stop gracefully;
+     * if it hasn't exited within {@link SHUTDOWN_TIMEOUT_MS}, force-`terminate()`s it.
+     */
+    close(): Promise<void>;
+    createImposter(json: string): Promise<number>;
+    replaceStubs(port: number, json: string): Promise<number>;
+    deleteImposter(port: number): Promise<number>;
+    deleteAll(): Promise<number>;
+    applyConfig(json: string): Promise<string>;
+    recorded(port: number): Promise<string>;
+    stubWarnings(port: number): Promise<string>;
+    /** `found: false` means the key simply isn't set — NOT an error; `rift_flow_state_get` always
+     * succeeds structurally (a real failure, e.g. an unknown port, still goes through the sentinel
+     * path and rejects). */
+    flowStateGet(port: number, flowId: string, key: string): Promise<{
+        found: boolean;
+        value?: unknown;
+    }>;
+    flowStatePut(port: number, flowId: string, key: string, valueJson: string): Promise<number>;
+    flowStateDelete(port: number, flowId: string, key: string): Promise<number>;
+    spaceAddStub(port: number, flowId: string, json: string): Promise<number>;
+    spaceListStubs(port: number, flowId: string): Promise<string>;
+    spaceDelete(port: number, flowId: string): Promise<number>;
+    spaceRecorded(port: number, flowId: string): Promise<string>;
+    startIntercept(optionsJson: string): Promise<Record<string, unknown>>;
+    interceptAddRules(json: string): Promise<number>;
+    interceptClearRules(): Promise<number>;
+    interceptListRules(): Promise<string>;
+    interceptCaPem(): Promise<string>;
+    interceptExportTruststore(format: string, password: string, outPath: string): Promise<number>;
+    serveAdmin(optionsJson: string): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"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"}

package/dist/native.js

@@ -0,0 +1,304 @@
+/**
+ * `NativeEngine` — the embedded transport's main-thread facade (issue #8).
+ *
+ * Owns the worker_threads lifecycle and the request/response correlation on top of the protocol
+ * in `protocol.ts`; the actual FFI discipline lives in `native-call.ts` and runs inside
+ * `worker.ts`, not here. `load()` spawns the worker, sends `{type:'init', libPath}`, and awaits
+ * `{type:'ready'}`/`{type:'init-error'}`. `close()` is idempotent, rejects in-flight calls with a
+ * clear error, and force-`terminate()`s if the worker doesn't exit within the shutdown timeout.
+ *
+ * The worker transport is injectable (`createWorker`) precisely so this protocol is unit-testable
+ * without spawning a real `worker_threads.Worker` — see `test/unit/embedded-worker.test.ts`.
+ */
+import { Worker } from 'worker_threads';
+import { EngineUnavailable, NativeLibraryError, RiftError } from '@rift-vs/rift';
+const SHUTDOWN_TIMEOUT_MS = 5000;
+function defaultCreateWorker() {
+    const url = new URL('./worker.js', import.meta.url);
+    return new Worker(url);
+}
+export class NativeEngine {
+    buildInfo;
+    #worker;
+    #nextId = 1;
+    #pending = new Map();
+    #state = 'open';
+    #closePromise = null;
+    #exitHandler = null;
+    #keepAlive;
+    constructor(worker, buildInfo, keepAlive) {
+        this.#worker = worker;
+        this.buildInfo = buildInfo;
+        this.#keepAlive = keepAlive;
+        worker.on('message', (raw) => this.#onMessage(raw));
+        worker.on('exit', () => this.#onUnexpectedExit());
+        // A post-init uncaught throw in the worker emits 'error'; with NO listener, Node's default is to
+        // rethrow on the main thread and crash the whole host process. Handle it: reject in-flight calls
+        // and mark the engine dead, turning a native fault into a recoverable error, not a crash.
+        worker.on('error', (err) => this.#onWorkerError(err));
+        this.#exitHandler = () => {
+            try {
+                worker.postMessage({ type: 'shutdown' });
+            }
+            catch {
+                // best-effort: the process is already tearing down.
+            }
+        };
+        process.on('exit', this.#exitHandler);
+    }
+    /**
+     * Spawns the worker, performs the init handshake, and resolves once it reports `ready`. Rejects
+     * with a `NativeLibraryError` on `init-error` (koffi missing, cdylib missing/incompatible, ABI
+     * v1), terminating the worker first so a failed load never leaks a thread.
+     */
+    static async load(libPath, opts = {}) {
+        const createWorker = opts.createWorker ?? defaultCreateWorker;
+        const worker = createWorker();
+        const handshake = new Promise((resolve, reject) => {
+            const onMessage = (raw) => {
+                const msg = raw;
+                if (msg.type === 'ready') {
+                    cleanup();
+                    resolve({ buildInfo: msg.buildInfo });
+                }
+                else if (msg.type === 'init-error') {
+                    cleanup();
+                    reject(new NativeLibraryError(msg.message, { path: libPath }));
+                }
+            };
+            const onError = (err) => {
+                cleanup();
+                reject(err instanceof Error ? err : new Error(String(err)));
+            };
+            const onExit = () => {
+                cleanup();
+                reject(new NativeLibraryError('embedded worker exited during init', { path: libPath }));
+            };
+            const cleanup = () => {
+                worker.off('message', onMessage);
+                worker.off('error', onError);
+                worker.off('exit', onExit);
+            };
+            worker.on('message', onMessage);
+            worker.on('error', onError);
+            worker.on('exit', onExit);
+        });
+        worker.postMessage({ type: 'init', libPath });
+        let ready;
+        try {
+            ready = await handshake;
+        }
+        catch (err) {
+            try {
+                await worker.terminate();
+            }
+            catch {
+                // best-effort cleanup of a worker that never finished initializing.
+            }
+            throw err;
+        }
+        const engine = new NativeEngine(worker, ready.buildInfo, opts.keepAlive === true);
+        // Idle engines must never block process exit — but ONLY idle ones: #call re-refs the worker
+        // while a call is in flight (an awaited call being dropped by loop-drain was #70), and
+        // `keepAlive` pins it for standalone mock-server processes.
+        if (opts.keepAlive !== true)
+            worker.unref();
+        return engine;
+    }
+    #onMessage(msg) {
+        if (msg.type !== 'result')
+            return;
+        const pending = this.#pending.get(msg.id);
+        if (!pending)
+            return; // late response for a call already rejected by close(), or unknown id.
+        this.#pending.delete(msg.id);
+        if (this.#pending.size === 0 && !this.#keepAlive)
+            this.#worker.unref();
+        if (msg.ok) {
+            pending.resolve(msg.value);
+        }
+        else {
+            pending.reject(new RiftError(`${msg.error.fn}: ${msg.error.message}`));
+        }
+    }
+    #onUnexpectedExit() {
+        if (this.#state !== 'open')
+            return; // exit is expected once close() is in progress.
+        this.#state = 'closed';
+        this.#rejectAllPending(new EngineUnavailable('embedded worker exited unexpectedly'));
+        this.#unregisterExitHandler();
+    }
+    #onWorkerError(err) {
+        if (this.#state === 'closed')
+            return; // a crash during/after close is moot.
+        this.#state = 'closed';
+        this.#rejectAllPending(new EngineUnavailable(`embedded worker crashed: ${err instanceof Error ? err.message : String(err)}`));
+        this.#unregisterExitHandler();
+    }
+    #rejectAllPending(err) {
+        const hadPending = this.#pending.size > 0;
+        for (const pending of this.#pending.values())
+            pending.reject(err);
+        this.#pending.clear();
+        // Drop the in-flight ref the drained calls were holding (a no-op on a terminated worker).
+        if (hadPending && !this.#keepAlive)
+            this.#worker.unref();
+    }
+    #unregisterExitHandler() {
+        if (this.#exitHandler) {
+            process.off('exit', this.#exitHandler);
+            this.#exitHandler = null;
+        }
+    }
+    #call(fn, args) {
+        if (this.#state !== 'open') {
+            return Promise.reject(new EngineUnavailable(`NativeEngine is ${this.#state}; cannot call ${fn}`));
+        }
+        const id = this.#nextId++;
+        return new Promise((resolve, reject) => {
+            // 0→1 transition holds the event loop for the duration of the in-flight window (#70): a bare
+            // script awaiting this call must not have Node drain the loop and exit with it unsettled.
+            if (this.#pending.size === 0 && !this.#keepAlive)
+                this.#worker.ref();
+            this.#pending.set(id, { fn, resolve: resolve, reject });
+            try {
+                this.#worker.postMessage({ type: 'call', id, fn, args });
+            }
+            catch (err) {
+                // A main-side postMessage throw (e.g. DataCloneError) never reaches the worker, so no
+                // response will ever drain this entry — undo the bookkeeping or the ref leaks forever.
+                this.#pending.delete(id);
+                if (this.#pending.size === 0 && !this.#keepAlive)
+                    this.#worker.unref();
+                throw err;
+            }
+        });
+    }
+    /**
+     * Idempotent: a second `close()` returns the same in-flight/completed close. Rejects every
+     * currently-pending call with a clear "closing" error (never lets one dangle waiting on a
+     * response that a shutting-down worker may never send), then asks the worker to stop gracefully;
+     * if it hasn't exited within {@link SHUTDOWN_TIMEOUT_MS}, force-`terminate()`s it.
+     */
+    close() {
+        if (this.#state === 'closed')
+            return Promise.resolve();
+        if (this.#closePromise)
+            return this.#closePromise;
+        this.#state = 'closing';
+        this.#rejectAllPending(new EngineUnavailable('NativeEngine is closing'));
+        this.#closePromise = this.#doClose();
+        return this.#closePromise;
+    }
+    async #doClose() {
+        const exited = new Promise((resolve) => {
+            const onExit = () => {
+                this.#worker.off('exit', onExit);
+                resolve();
+            };
+            this.#worker.on('exit', onExit);
+        });
+        try {
+            this.#worker.postMessage({ type: 'shutdown' });
+        }
+        catch {
+            // worker channel already gone (e.g. it crashed) — fall through to the timeout/terminate path.
+        }
+        const TIMED_OUT = Symbol('shutdown-timeout');
+        // An explicit, clearable timer — a bare `sleep().then()` would leak a live 5s timer on the
+        // (common) fast-close path where `exited` wins the race, delaying host process exit.
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => resolve(TIMED_OUT), SHUTDOWN_TIMEOUT_MS);
+        });
+        try {
+            const outcome = await Promise.race([exited.then(() => 'exited'), timeout]);
+            if (outcome === TIMED_OUT) {
+                try {
+                    await this.#worker.terminate();
+                }
+                catch (err) {
+                    // Nothing more we can do, but don't claim a clean close silently: the worker thread may
+                    // still be alive (unref'd, so it won't hold the process open, but a native handle leaks).
+                    console.error(`rift: embedded worker did not terminate cleanly: ${String(err)}`);
+                }
+            }
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+        }
+        this.#state = 'closed';
+        this.#unregisterExitHandler();
+    }
+    createImposter(json) {
+        return this.#call('rift_create_imposter', [json]);
+    }
+    replaceStubs(port, json) {
+        return this.#call('rift_replace_stubs', [port, json]);
+    }
+    deleteImposter(port) {
+        return this.#call('rift_delete_imposter', [port]);
+    }
+    deleteAll() {
+        return this.#call('rift_delete_all', []);
+    }
+    applyConfig(json) {
+        return this.#call('rift_apply_config', [json]);
+    }
+    recorded(port) {
+        return this.#call('rift_recorded', [port]);
+    }
+    stubWarnings(port) {
+        return this.#call('rift_stub_warnings', [port]);
+    }
+    /** `found: false` means the key simply isn't set — NOT an error; `rift_flow_state_get` always
+     * succeeds structurally (a real failure, e.g. an unknown port, still goes through the sentinel
+     * path and rejects). */
+    async flowStateGet(port, flowId, key) {
+        const raw = await this.#call('rift_flow_state_get', [port, flowId, key]);
+        return JSON.parse(raw);
+    }
+    flowStatePut(port, flowId, key, valueJson) {
+        return this.#call('rift_flow_state_put', [port, flowId, key, valueJson]);
+    }
+    flowStateDelete(port, flowId, key) {
+        return this.#call('rift_flow_state_delete', [port, flowId, key]);
+    }
+    spaceAddStub(port, flowId, json) {
+        return this.#call('rift_space_add_stub', [port, flowId, json]);
+    }
+    spaceListStubs(port, flowId) {
+        return this.#call('rift_space_list_stubs', [port, flowId]);
+    }
+    spaceDelete(port, flowId) {
+        return this.#call('rift_space_delete', [port, flowId]);
+    }
+    spaceRecorded(port, flowId) {
+        return this.#call('rift_space_recorded', [port, flowId]);
+    }
+    async startIntercept(optionsJson) {
+        const raw = await this.#call('rift_start_intercept', [optionsJson]);
+        return JSON.parse(raw);
+    }
+    interceptAddRules(json) {
+        return this.#call('rift_intercept_add_rules', [json]);
+    }
+    interceptClearRules() {
+        return this.#call('rift_intercept_clear_rules', []);
+    }
+    interceptListRules() {
+        return this.#call('rift_intercept_list_rules', []);
+    }
+    interceptCaPem() {
+        return this.#call('rift_intercept_ca_pem', []);
+    }
+    interceptExportTruststore(format, password, outPath) {
+        return this.#call('rift_intercept_export_truststore', [format, password, outPath]);
+    }
+    async serveAdmin(optionsJson) {
+        const raw = await this.#call('rift_serve_admin', [optionsJson]);
+        return JSON.parse(raw);
+    }
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"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"}

package/dist/protocol.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Message protocol between `native.ts` (the main-thread `NativeEngine` facade) and `worker.ts`
+ * (the worker_threads-side thin wrapper). Kept as plain, structurally-clonable data — no class
+ * instances, no pointers — since it crosses the worker `postMessage` boundary.
+ */
+import type { NativeCallableFn } from './native-binding.js';
+import type { NativeCallResponse } from './native-call.js';
+export type ToWorkerMessage = {
+    type: 'init';
+    libPath: string;
+} | {
+    type: 'call';
+    id: number;
+    fn: NativeCallableFn;
+    args: unknown[];
+} | {
+    type: 'shutdown';
+};
+export type FromWorkerMessage = {
+    type: 'ready';
+    buildInfo: string;
+} | {
+    type: 'init-error';
+    message: string;
+} | ({
+    type: 'result';
+} & NativeCallResponse) | {
+    type: 'shutdown-ack';
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,kBAAkB,CAAC,GACzC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,7 @@
+/**
+ * Message protocol between `native.ts` (the main-thread `NativeEngine` facade) and `worker.ts`
+ * (the worker_threads-side thin wrapper). Kept as plain, structurally-clonable data — no class
+ * instances, no pointers — since it crosses the worker `postMessage` boundary.
+ */
+export {};
+//# sourceMappingURL=protocol.js.map