@electron-stagewright/host-supervisor 0.0.0-stage → 0.2.0

package/dist/serve.js

@@ -0,0 +1,287 @@
+/**
+ * Host side: answers the supervisor from a worker thread or a utility process. Never imports
+ * Electron, so the same entry runs under Node.
+ */
+import { performance } from 'node:perf_hooks';
+import { getHeapStatistics } from 'node:v8';
+import { parentPort } from 'node:worker_threads';
+import { PROTOCOL_VERSION, parseSupervisorMessage, serializeError, } from './protocol.js';
+/** The port this host was started with, or null outside a worker or utility process. */
+export function defaultHostPort() {
+    const electronPort = process.parentPort;
+    if (electronPort) {
+        return {
+            post: (message) => electronPort.postMessage(message),
+            onMessage: (listener) => void electronPort.on('message', (event) => listener(event.data)),
+            // A utility process stays alive while its parent port listens. The delay lets the stop
+            // reply leave first; the supervisor terminates a host that lingers after it.
+            close: () => void setTimeout(() => process.exit(0), 50),
+        };
+    }
+    const port = parentPort;
+    if (port) {
+        return {
+            post: (message) => port.postMessage(message),
+            onMessage: (listener) => void port.on('message', listener),
+            close: () => port.close(),
+        };
+    }
+    return null;
+}
+const toMb = (bytes) => Math.round((bytes / 1_048_576) * 10) / 10;
+function rejected(message, code) {
+    return { name: 'HostError', message, code };
+}
+/** A handler's error never crosses as `HostError`, so it cannot pass for the supervisor's own. */
+function handlerError(error, options) {
+    const serialized = serializeError(error, options);
+    return serialized.name === 'HostError' ? { ...serialized, name: 'Error' } : serialized;
+}
+function withoutData(message) {
+    if (!('error' in message) || message.error?.data === undefined)
+        return null;
+    const { name, message: text, code } = message.error;
+    return { ...message, error: { name, message: text, ...(code ? { code } : {}) } };
+}
+/** Serves one host until the supervisor sends `stop`. */
+export function serveHost(options) {
+    const found = options.port ?? defaultHostPort();
+    if (!found)
+        throw new Error('serveHost must run in a worker thread or a utility process');
+    const port = found;
+    const callOps = new Set(options.operations);
+    const streamOps = new Set(options.streams ?? []);
+    let handlers = null;
+    let starting = null;
+    let accepting = true;
+    let statsTimer = null;
+    const inflight = new Set();
+    const controllers = new Map();
+    const streams = new Map();
+    /** An error whose detail cannot be cloned still crosses, without the detail. */
+    const post = (message) => {
+        try {
+            port.post(message);
+        }
+        catch (error) {
+            const fallback = withoutData(message);
+            if (!fallback)
+                throw error;
+            port.post(fallback);
+        }
+    };
+    const failure = (error) => handlerError(error, options.errors);
+    function track(work) {
+        inflight.add(work);
+        void work.finally(() => inflight.delete(work));
+    }
+    /** A value that cannot be cloned still answers its call. */
+    function answer(id, message) {
+        try {
+            post(message);
+        }
+        catch (error) {
+            post({ type: 'result', id, ok: false, error: failure(error) });
+        }
+    }
+    let lastElu = performance.eventLoopUtilization();
+    const heapLimitMb = toMb(getHeapStatistics().heap_size_limit);
+    function postStats() {
+        const memory = process.memoryUsage();
+        const elu = performance.eventLoopUtilization(lastElu);
+        lastElu = performance.eventLoopUtilization();
+        post({
+            type: 'stats',
+            stats: {
+                rssMb: toMb(memory.rss),
+                heapUsedMb: toMb(memory.heapUsed),
+                heapLimitMb,
+                externalMb: toMb(memory.external + memory.arrayBuffers),
+                eventLoopUtilization: Math.round(elu.utilization * 1000) / 1000,
+            },
+        });
+    }
+    async function start(version, payload) {
+        try {
+            if (version !== PROTOCOL_VERSION) {
+                throw new Error(`The host speaks protocol ${PROTOCOL_VERSION}, not ${version}`);
+            }
+            let info;
+            let hasInfo = false;
+            let settled = false;
+            const context = {
+                setInfo: (value) => {
+                    if (settled)
+                        throw new Error('setInfo must be called before start resolves');
+                    info = value;
+                    hasInfo = true;
+                },
+            };
+            const served = (await options.start(payload, context));
+            for (const op of [...callOps, ...streamOps]) {
+                if (typeof served[op] !== 'function')
+                    throw new Error(`No handler for ${op}`);
+            }
+            settled = true;
+            try {
+                post(hasInfo ? { type: 'started', info } : { type: 'started' });
+            }
+            catch (error) {
+                throw new Error('setInfo received a value that cannot be cloned', { cause: error });
+            }
+            handlers = served;
+            if (options.statsIntervalMs !== undefined) {
+                postStats();
+                statsTimer = setInterval(postStats, options.statsIntervalMs);
+                statsTimer.unref();
+            }
+        }
+        catch (error) {
+            post({ type: 'start-failed', error: failure(error) });
+        }
+    }
+    function call(id, op, args, stream) {
+        const served = handlers;
+        if (!served || !accepting) {
+            post({
+                type: 'result',
+                id,
+                ok: false,
+                error: rejected('The host is not serving', 'HOST_STOPPED'),
+            });
+            return;
+        }
+        if (!(stream ? streamOps : callOps).has(op)) {
+            post({
+                type: 'result',
+                id,
+                ok: false,
+                error: rejected(`${op} is not an operation of this host`, 'HOST_OPERATION_REJECTED'),
+            });
+            return;
+        }
+        const controller = new AbortController();
+        const context = { signal: controller.signal };
+        const handler = served[op];
+        if (stream) {
+            try {
+                const iterable = handler.apply(served, [...args, context]);
+                const iterator = Symbol.asyncIterator in iterable
+                    ? iterable[Symbol.asyncIterator]()
+                    : iterable[Symbol.iterator]();
+                streams.set(id, { iterator, controller });
+            }
+            catch (error) {
+                post({ type: 'result', id, ok: false, error: failure(error) });
+            }
+            return;
+        }
+        controllers.set(id, controller);
+        track(Promise.resolve()
+            .then(() => handler.apply(served, [...args, context]))
+            .then((value) => answer(id, { type: 'result', id, ok: true, value }), (error) => post({ type: 'result', id, ok: false, error: failure(error) }))
+            .finally(() => controllers.delete(id)));
+    }
+    function next(id) {
+        const open = streams.get(id);
+        if (!open) {
+            post({
+                type: 'result',
+                id,
+                ok: false,
+                error: rejected('The stream is not open', 'HOST_STOPPED'),
+            });
+            return;
+        }
+        track(Promise.resolve()
+            .then(() => open.iterator.next())
+            .then((result) => {
+            if (result.done) {
+                streams.delete(id);
+                post({ type: 'item', id, done: true });
+            }
+            else {
+                try {
+                    post({ type: 'item', id, done: false, value: result.value });
+                }
+                catch (error) {
+                    // An item that cannot be cloned ends the stream and frees its producer.
+                    cancel(id);
+                    post({ type: 'result', id, ok: false, error: failure(error) });
+                }
+            }
+        }, (error) => {
+            streams.delete(id);
+            post({ type: 'result', id, ok: false, error: failure(error) });
+        }));
+    }
+    function cancel(id) {
+        controllers.get(id)?.abort();
+        const open = streams.get(id);
+        if (!open)
+            return;
+        streams.delete(id);
+        open.controller.abort();
+        track(Promise.resolve()
+            .then(() => open.iterator.return?.())
+            .then(() => undefined, () => undefined));
+    }
+    async function stop() {
+        // Close admission before yielding, so a later message cannot reach a closing resource.
+        accepting = false;
+        let stopFailure = null;
+        try {
+            await starting;
+            for (const id of [...streams.keys()])
+                cancel(id);
+            while (inflight.size > 0)
+                await Promise.allSettled([...inflight]);
+            await options.stop?.();
+        }
+        catch (error) {
+            stopFailure = error;
+        }
+        handlers = null;
+        if (statsTimer)
+            clearInterval(statsTimer);
+        post(stopFailure ? { type: 'stopped', error: failure(stopFailure) } : { type: 'stopped' });
+        port.close();
+    }
+    if (options.reportCrashes !== false) {
+        process.on('uncaughtExceptionMonitor', (error) => {
+            try {
+                post({ type: 'crashed', error: failure(error) });
+            }
+            catch {
+                // The host is ending either way.
+            }
+        });
+    }
+    let stopped = false;
+    port.onMessage((raw) => {
+        const message = parseSupervisorMessage(raw);
+        if (!message)
+            return;
+        switch (message.type) {
+            case 'start':
+                starting ??= start(message.version, message.payload);
+                return;
+            case 'call':
+                call(message.id, message.op, message.args, message.stream === true);
+                return;
+            case 'next':
+                next(message.id);
+                return;
+            case 'cancel':
+                cancel(message.id);
+                return;
+            case 'stop':
+                if (stopped)
+                    return;
+                stopped = true;
+                void stop();
+                return;
+        }
+    });
+}
+//# sourceMappingURL=serve.js.map

package/dist/serve.js.map

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

package/dist/utility.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Electron `utilityProcess` transport. The host gets its own process: a native crash ends only the
+ * host, at the cost of a slower start and more memory than a worker.
+ */
+import type { HostTransport } from './contract.js';
+/** The part of Electron's `UtilityProcess` the transport relies on. */
+export interface UtilityProcessLike {
+    readonly pid?: number | undefined;
+    postMessage(message: unknown): void;
+    on(event: 'spawn', listener: () => void): unknown;
+    on(event: 'message', listener: (message: unknown) => void): unknown;
+    on(event: 'exit', listener: (code: number) => void): unknown;
+    on(event: 'error', listener: (type: string, location: string, report: string) => void): unknown;
+    kill(): boolean;
+}
+/** The `utilityProcess.fork` options the transport passes through. */
+export interface UtilityForkOptions {
+    readonly env?: Record<string, string>;
+    readonly execArgv?: string[];
+    readonly cwd?: string;
+    readonly stdio?: 'pipe' | 'ignore' | 'inherit';
+    readonly serviceName?: string;
+    readonly allowLoadingUnsignedLibraries?: boolean;
+}
+export interface UtilityProcessTransportOptions {
+    /** The host entry: a file that calls `serveHost`. */
+    readonly entry: string;
+    readonly args?: readonly string[];
+    /** Shown in the OS task manager and in `app.getAppMetrics()`. */
+    readonly serviceName?: string;
+    /** Defaults to `minimalEnvironment(process.env)`, not the whole parent environment. */
+    readonly env?: Record<string, string>;
+    readonly execArgv?: readonly string[];
+    readonly cwd?: string;
+    readonly stdio?: 'pipe' | 'ignore' | 'inherit';
+    /** macOS: lets the hardened runtime load unsigned `.node` and `.dylib` files. Avoid in release builds. */
+    readonly allowLoadingUnsignedLibraries?: boolean;
+    /**
+     * Electron's `utilityProcess.fork`. Pass it when the main process is bundled (CommonJS, or any
+     * build where this package cannot `require('electron')` itself); tests pass a fake.
+     */
+    readonly fork?: (entry: string, args: string[], options: UtilityForkOptions) => UtilityProcessLike;
+}
+export declare function utilityProcessTransport(options: UtilityProcessTransportOptions): HostTransport;
+export { minimalEnvironment } from './env.js';
+//# sourceMappingURL=utility.d.ts.map

package/dist/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../src/utility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAA4B,aAAa,EAAE,MAAM,eAAe,CAAA;AAG5E,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACnC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAA;IACjD,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAA;IACnE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAA;IAC5D,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAA;IAC/F,IAAI,IAAI,OAAO,CAAA;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,6BAA6B,CAAC,EAAE,OAAO,CAAA;CACjD;AAED,MAAM,WAAW,8BAA8B;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,iEAAiE;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,uFAAuF;IACvF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC9C,0GAA0G;IAC1G,QAAQ,CAAC,6BAA6B,CAAC,EAAE,OAAO,CAAA;IAChD;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,KAAK,kBAAkB,CAAA;CACnG;AAmBD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,aAAa,CAiC9F;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA"}

package/dist/utility.js

@@ -0,0 +1,50 @@
+/**
+ * Electron `utilityProcess` transport. The host gets its own process: a native crash ends only the
+ * host, at the cost of a slower start and more memory than a worker.
+ */
+import { createRequire } from 'node:module';
+import { minimalEnvironment } from './env.js';
+function electronFork(entry, args, options) {
+    // Loaded on first launch, so importing this module never needs Electron.
+    const electron = createRequire(import.meta.url)('electron');
+    if (!electron.utilityProcess) {
+        throw new Error('utilityProcessTransport must run in the Electron main process');
+    }
+    return electron.utilityProcess.fork(entry, args, options);
+}
+export function utilityProcessTransport(options) {
+    const fork = options.fork ?? electronFork;
+    return {
+        launch() {
+            const env = options.env ?? minimalEnvironment(process.env);
+            const child = fork(options.entry, [...(options.args ?? [])], {
+                // Electron reads an empty env as unset and passes the whole parent environment.
+                env: Object.keys(env).length > 0 ? env : { HOST_SUPERVISOR_EMPTY_ENV: '1' },
+                ...(options.execArgv ? { execArgv: [...options.execArgv] } : {}),
+                ...(options.cwd ? { cwd: options.cwd } : {}),
+                ...(options.stdio ? { stdio: options.stdio } : {}),
+                ...(options.serviceName ? { serviceName: options.serviceName } : {}),
+                ...(options.allowLoadingUnsignedLibraries ? { allowLoadingUnsignedLibraries: true } : {}),
+            });
+            let error = null;
+            child.on('error', (type, location) => {
+                error = new Error(`The host process hit a fatal ${type} at ${location}`);
+            });
+            return {
+                send: (message) => child.postMessage(message),
+                onMessage: (listener) => void child.on('message', listener),
+                onExit: (listener) => void child.on('exit', (code) => {
+                    const exit = error ? { code, error, runtimeFatal: true } : { code };
+                    listener(exit);
+                }),
+                kill: () => {
+                    // Before 'spawn' Electron's kill() is a no-op that returns false.
+                    if (!child.kill())
+                        child.on('spawn', () => void child.kill());
+                },
+            };
+        },
+    };
+}
+export { minimalEnvironment } from './env.js';
+//# sourceMappingURL=utility.js.map

package/dist/utility.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `worker_threads` transport. Cheap to start and close to the caller, but the host shares the
+ * process: a native crash in it ends the whole app.
+ */
+import { type ResourceLimits, type WorkerOptions } from 'node:worker_threads';
+import type { HostTransport } from './contract.js';
+/** The part of `Worker` the transport relies on. */
+export interface WorkerLike {
+    postMessage(message: unknown): void;
+    on(event: 'message', listener: (message: unknown) => void): unknown;
+    on(event: 'error', listener: (error: unknown) => void): unknown;
+    on(event: 'exit', listener: (code: number) => void): unknown;
+    terminate(): Promise<number>;
+}
+export interface WorkerThreadTransportOptions {
+    /** The host entry: a file that calls `serveHost`. */
+    readonly entry: string | URL;
+    /**
+     * V8 heap caps; past them Node usually ends only the worker, reported as `out-of-memory`. One
+     * allocation far past the cap can still abort the whole process.
+     */
+    readonly resourceLimits?: ResourceLimits;
+    readonly env?: WorkerOptions['env'];
+    readonly execArgv?: readonly string[];
+    readonly argv?: readonly unknown[];
+    readonly name?: string;
+    /** Replaces `new Worker`, for tests. */
+    readonly createWorker?: (entry: string | URL, options: WorkerOptions) => WorkerLike;
+}
+export declare function workerThreadTransport(options: WorkerThreadTransportOptions): HostTransport;
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAU,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAErF,OAAO,KAAK,EAA4B,aAAa,EAAE,MAAM,eAAe,CAAA;AAE5E,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACnC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAA;IACnE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAA;IAC/D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAA;IAC5D,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,wCAAwC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,aAAa,KAAK,UAAU,CAAA;CACpF;AAKD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,aAAa,CA4C1F"}

package/dist/worker.js

@@ -0,0 +1,50 @@
+/**
+ * `worker_threads` transport. Cheap to start and close to the caller, but the host shares the
+ * process: a native crash in it ends the whole app.
+ */
+import { Worker } from 'node:worker_threads';
+const createNodeWorker = (entry, options) => new Worker(entry, options);
+export function workerThreadTransport(options) {
+    const create = options.createWorker ?? createNodeWorker;
+    return {
+        launch() {
+            const worker = create(options.entry, {
+                ...(options.resourceLimits ? { resourceLimits: options.resourceLimits } : {}),
+                ...(options.env === undefined ? {} : { env: options.env }),
+                ...(options.execArgv ? { execArgv: [...options.execArgv] } : {}),
+                ...(options.argv ? { argv: [...options.argv] } : {}),
+                ...(options.name ? { name: options.name } : {}),
+            });
+            let error = null;
+            // Node emits its own heap-limit error in the same tick as 'exit'; an uncaught error that
+            // merely carries that code (from an inner worker, say) arrives earlier.
+            let errorThisTick = false;
+            // A worker can throw any value, falsy ones included.
+            worker.on('error', (cause) => {
+                error =
+                    cause instanceof Error
+                        ? cause
+                        : new Error(`The host threw a non-error value: ${String(cause)}`);
+                errorThisTick = true;
+                queueMicrotask(() => (errorThisTick = false));
+            });
+            return {
+                send: (message) => worker.postMessage(message),
+                onMessage: (listener) => void worker.on('message', listener),
+                onExit: (listener) => void worker.on('exit', (code) => {
+                    const exit = error
+                        ? {
+                            code,
+                            error,
+                            outOfMemory: errorThisTick &&
+                                error.code === 'ERR_WORKER_OUT_OF_MEMORY',
+                        }
+                        : { code };
+                    listener(exit);
+                }),
+                kill: () => void worker.terminate().catch(() => undefined),
+            };
+        },
+    };
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAA2C,MAAM,qBAAqB,CAAA;AA6BrF,MAAM,gBAAgB,GAAG,CAAC,KAAmB,EAAE,OAAsB,EAAc,EAAE,CACnF,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;AAE5B,MAAM,UAAU,qBAAqB,CAAC,OAAqC;IACzE,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,IAAI,gBAAgB,CAAA;IACvD,OAAO;QACL,MAAM;YACJ,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE;gBACnC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7E,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC1D,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChD,CAAC,CAAA;YACF,IAAI,KAAK,GAAiB,IAAI,CAAA;YAC9B,yFAAyF;YACzF,wEAAwE;YACxE,IAAI,aAAa,GAAG,KAAK,CAAA;YACzB,qDAAqD;YACrD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE;gBACpC,KAAK;oBACH,KAAK,YAAY,KAAK;wBACpB,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBACrE,aAAa,GAAG,IAAI,CAAA;gBACpB,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC,CAAA;YAC/C,CAAC,CAAC,CAAA;YACF,OAAO;gBACL,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;gBAC9C,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;gBAC5D,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CACnB,KAAK,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBAC9B,MAAM,IAAI,GAAgB,KAAK;wBAC7B,CAAC,CAAC;4BACE,IAAI;4BACJ,KAAK;4BACL,WAAW,EACT,aAAa;gCACZ,KAA4B,CAAC,IAAI,KAAK,0BAA0B;yBACpE;wBACH,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;oBACZ,QAAQ,CAAC,IAAI,CAAC,CAAA;gBAChB,CAAC,CAAC;gBACJ,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;aAC3D,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@electron-stagewright/host-supervisor",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Supervisor for one stateful host off the Electron main thread: a closed operation list, lazy start, drain on stop, per-call timeout and AbortSignal, a pending limit, and bounded restart, over worker_threads or utilityProcess.",
+  "type": "module",
+  "license": "MIT",
+  "author": "johnny4young <johnny.iv.young@gmail.com>",
+  "homepage": "https://electron-stagewright.github.io/electron-stagewright/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/electron-stagewright/electron-stagewright.git",
+    "directory": "packages/host-supervisor"
+  },
+  "bugs": {
+    "url": "https://github.com/electron-stagewright/electron-stagewright/issues"
+  },
+  "keywords": [
+    "electron",
+    "utility-process",
+    "worker-threads",
+    "supervisor",
+    "rpc",
+    "performance"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./worker": {
+      "types": "./dist/worker.d.ts",
+      "import": "./dist/worker.js"
+    },
+    "./utility": {
+      "types": "./dist/utility.d.ts",
+      "import": "./dist/utility.js"
+    }
+  },
+  "engines": {
+    "node": ">=26.13.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "electron": "^42.11.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }