@empire-builder-kit/nx 1.0.0-beta.9 → 1.0.0-rc.2

package/src/local-dev/fleet-process.js

@@ -0,0 +1,289 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FleetProcessController = void 0;
+exports.fleetRestartDelay = fleetRestartDelay;
+exports.planFleetRestart = planFleetRestart;
+exports.terminateOwnedChild = terminateOwnedChild;
+const node_child_process_1 = require("node:child_process");
+const errors_js_1 = require("./errors.js");
+function fleetRestartDelay(attempt) {
+    if (!Number.isInteger(attempt) || attempt < 0) {
+        throw new errors_js_1.LocalDevContractError('invalid-input', 'Fleet restart attempt must be a non-negative integer.');
+    }
+    return Math.min(1_000 * 2 ** Math.min(attempt, 5), 30_000);
+}
+function planFleetRestart(completedRestartAttempts, maxRestartAttempts) {
+    if (!Number.isInteger(maxRestartAttempts) ||
+        maxRestartAttempts < 0 ||
+        maxRestartAttempts > 10) {
+        throw new errors_js_1.LocalDevContractError('invalid-input', 'Fleet maximum restart attempts must be an integer from 0 through 10.');
+    }
+    if (completedRestartAttempts >= maxRestartAttempts) {
+        return { restart: false };
+    }
+    return {
+        delayMs: fleetRestartDelay(completedRestartAttempts),
+        nextAttempt: completedRestartAttempts + 1,
+        restart: true,
+    };
+}
+async function terminateOwnedChild(child) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return;
+    const exited = new Promise((resolvePromise) => child.once('exit', () => resolvePromise()));
+    if (process.platform === 'win32' && child.pid) {
+        const killer = (0, node_child_process_1.spawn)('taskkill', ['/pid', String(child.pid), '/t', '/f'], {
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        await new Promise((resolvePromise) => killer.once('exit', () => resolvePromise()));
+        await Promise.race([
+            exited,
+            new Promise((resolvePromise) => setTimeout(resolvePromise, 2_000)),
+        ]);
+        return;
+    }
+    if (child.pid) {
+        try {
+            process.kill(-child.pid, 'SIGTERM');
+        }
+        catch {
+            child.kill('SIGTERM');
+        }
+    }
+    const stopped = await Promise.race([
+        exited.then(() => true),
+        new Promise((resolvePromise) => setTimeout(() => resolvePromise(false), 5_000)),
+    ]);
+    if (!stopped && child.pid) {
+        try {
+            process.kill(-child.pid, 'SIGKILL');
+        }
+        catch {
+            child.kill('SIGKILL');
+        }
+        await Promise.race([
+            exited,
+            new Promise((resolvePromise) => setTimeout(resolvePromise, 1_000)),
+        ]);
+    }
+}
+async function defaultProbe(url, signal) {
+    try {
+        const response = await fetch(url, {
+            redirect: 'manual',
+            signal: AbortSignal.any([signal, AbortSignal.timeout(2_000)]),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+function defaultDelay(milliseconds, signal) {
+    return new Promise((resolvePromise) => {
+        if (signal.aborted) {
+            resolvePromise();
+            return;
+        }
+        const timer = setTimeout(resolvePromise, milliseconds);
+        signal.addEventListener('abort', () => {
+            clearTimeout(timer);
+            resolvePromise();
+        }, { once: true });
+    });
+}
+class FleetProcessController {
+    #activeAttempt = 0;
+    #adapter;
+    #child;
+    #cleanup;
+    #effects;
+    #healthTimeoutMs;
+    #lifetime = new AbortController();
+    #logStore;
+    #maxRestartAttempts;
+    #name;
+    #onStateChange;
+    #restartAttempts = 0;
+    #restartTask;
+    #state = 'remote';
+    #stopping = false;
+    #upstream;
+    constructor(options, effects) {
+        if (!Number.isInteger(options.maxRestartAttempts) ||
+            options.maxRestartAttempts < 0 ||
+            options.maxRestartAttempts > 10) {
+            throw new errors_js_1.LocalDevContractError('invalid-input', 'Fleet process restart limit is invalid.');
+        }
+        this.#adapter = options.adapter;
+        this.#cleanup =
+            options.adapter.adapterVersion === 2 && options.adapter.lifecycle
+                ? 'pending'
+                : 'not-declared';
+        this.#healthTimeoutMs = options.healthTimeoutMs ?? 120_000;
+        this.#logStore = options.logStore;
+        this.#maxRestartAttempts = options.maxRestartAttempts;
+        this.#name = options.name;
+        this.#onStateChange = options.onStateChange;
+        this.#upstream = options.upstream;
+        this.#effects = {
+            cleanup: effects.cleanup,
+            delay: effects.delay ?? defaultDelay,
+            launch: effects.launch,
+            prepareRestart: effects.prepareRestart,
+            probe: effects.probe ?? defaultProbe,
+            runnerGeneration: effects.runnerGeneration,
+            terminate: effects.terminate ?? terminateOwnedChild,
+        };
+    }
+    get restartAttempts() {
+        return this.#restartAttempts;
+    }
+    get cleanup() {
+        return this.#cleanup;
+    }
+    get runnerGeneration() {
+        return this.#effects.runnerGeneration?.();
+    }
+    get state() {
+        return this.#state;
+    }
+    #transition(state) {
+        this.#state = state;
+        this.#onStateChange?.(state, this.#restartAttempts);
+    }
+    #capture(child, attempt) {
+        child.stdout?.on('data', (chunk) => this.#logStore?.writeChunk(this.#name, 'stdout', attempt, chunk));
+        child.stderr?.on('data', (chunk) => this.#logStore?.writeChunk(this.#name, 'stderr', attempt, chunk));
+    }
+    #launch() {
+        this.#cleanup =
+            this.#adapter.adapterVersion === 2 && this.#adapter.lifecycle
+                ? 'pending'
+                : 'not-declared';
+        const launched = this.#effects.launch(this.#activeAttempt);
+        this.#child = launched.child;
+        this.#activeAttempt = launched.attempt;
+        this.#capture(launched.child, launched.attempt);
+        this.#transition('starting');
+        launched.child.once('exit', (code, signal) => {
+            if (this.#child === launched.child)
+                this.#child = undefined;
+            this.#logStore?.flush(this.#name, undefined, launched.attempt);
+            if (this.#stopping || this.#lifetime.signal.aborted)
+                return;
+            this.#transition('unavailable');
+            this.#logStore?.writeLine(this.#name, 'stderr', launched.attempt, `Local process exited with ${signal ? `signal ${signal}` : `status ${code ?? 'unknown'}`}.`);
+            if (signal || code !== 0) {
+                this.#cleanup =
+                    this.#adapter.adapterVersion === 2 && this.#adapter.lifecycle
+                        ? 'failed'
+                        : 'not-declared';
+                this.#logStore?.writeLine(this.#name, 'stderr', launched.attempt, 'Runner cleanup did not complete cleanly; automatic restart is blocked until declared cleanup succeeds.');
+                return;
+            }
+            this.#restartTask = this.#autoRestart();
+        });
+    }
+    async #waitForReadiness() {
+        const deadline = Date.now() + this.#healthTimeoutMs;
+        const target = new URL(this.#adapter.healthPath, this.#upstream);
+        while (!this.#lifetime.signal.aborted && Date.now() < deadline) {
+            if (!this.#child) {
+                throw new errors_js_1.LocalDevContractError('readiness-timeout', `${this.#name} exited before readiness.`);
+            }
+            if (await this.#effects.probe(target, this.#lifetime.signal)) {
+                this.#restartAttempts = 0;
+                this.#transition('ready');
+                return;
+            }
+            await this.#effects.delay(500, this.#lifetime.signal);
+        }
+        this.#transition('unavailable');
+        throw new errors_js_1.LocalDevContractError('readiness-timeout', `${this.#name} did not become ready within ${this.#healthTimeoutMs}ms.`);
+    }
+    async #autoRestart() {
+        const restart = planFleetRestart(this.#restartAttempts, this.#maxRestartAttempts);
+        if (!restart.restart) {
+            this.#logStore?.writeLine(this.#name, 'stderr', this.#activeAttempt, `Automatic restart stopped after ${this.#maxRestartAttempts} attempt(s).`);
+            return;
+        }
+        this.#restartAttempts = restart.nextAttempt;
+        await this.#effects.delay(restart.delayMs, this.#lifetime.signal);
+        if (this.#stopping || this.#lifetime.signal.aborted)
+            return;
+        this.#activeAttempt = restart.nextAttempt;
+        this.#launch();
+        try {
+            await this.#waitForReadiness();
+        }
+        catch (error) {
+            if (this.#child) {
+                await this.#effects.terminate(this.#child);
+            }
+            if (!this.#restartTask && !this.#lifetime.signal.aborted) {
+                this.#restartTask = this.#autoRestart();
+            }
+            this.#logStore?.writeLine(this.#name, 'stderr', this.#activeAttempt, error instanceof Error ? error.message : String(error));
+        }
+    }
+    async start() {
+        if (this.#child || this.#state !== 'remote') {
+            throw new errors_js_1.LocalDevContractError('operation-conflict', `${this.#name} is already selected.`);
+        }
+        this.#stopping = false;
+        this.#launch();
+        await this.#waitForReadiness();
+    }
+    async restart() {
+        if (this.#state === 'remote') {
+            throw new errors_js_1.LocalDevContractError('not-running', `${this.#name} is not selected.`);
+        }
+        this.#stopping = true;
+        try {
+            if (this.#child) {
+                await this.#effects.prepareRestart?.(this.#child);
+                await this.#effects.terminate(this.#child);
+            }
+            await this.#restartTask;
+            this.#restartTask = undefined;
+            this.#restartAttempts = 0;
+            this.#activeAttempt += 1;
+            this.#stopping = false;
+            this.#launch();
+            await this.#waitForReadiness();
+        }
+        catch (error) {
+            this.#stopping = false;
+            throw error;
+        }
+    }
+    async stop(options) {
+        if (this.#state === 'remote')
+            return;
+        this.#stopping = true;
+        if (this.#child)
+            await this.#effects.terminate(this.#child);
+        await this.#restartTask;
+        this.#restartTask = undefined;
+        this.#logStore?.flush(this.#name);
+        if (options.cleanup && this.#effects.cleanup) {
+            try {
+                await this.#effects.cleanup();
+                this.#cleanup = 'succeeded';
+            }
+            catch (error) {
+                this.#cleanup = 'failed';
+                throw error;
+            }
+        }
+        this.#transition('remote');
+    }
+    async dispose() {
+        this.#lifetime.abort();
+        await this.stop({ cleanup: false });
+    }
+}
+exports.FleetProcessController = FleetProcessController;
+//# sourceMappingURL=fleet-process.js.map

package/src/local-dev/fleet-process.js.map

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

package/src/local-dev/fleet-runtime.d.ts

@@ -0,0 +1,22 @@
+import { inspectLocalDevelopment } from '../executors/dev-doctor/dev-doctor.js';
+import { FleetSession } from './fleet-session.js';
+import { FleetSupervisor } from './fleet-supervisor.js';
+import { type FleetStartupRequest } from './fleet-startup.js';
+import { type WorkspaceFleetPlan } from './nx-workspace.js';
+import { allocateFleetPort } from './ports.js';
+import { type PersonalStageResolver } from './personal-stage.js';
+export interface RunningFleetRuntime {
+    fleetId: string;
+    origin: string;
+    session: FleetSession;
+    supervisor: FleetSupervisor;
+}
+export interface FleetRuntimeDependencies {
+    allocatePort?: typeof allocateFleetPort;
+    inspectDoctor?: typeof inspectLocalDevelopment;
+    loadPlan?: () => Promise<WorkspaceFleetPlan>;
+    personalStageResolver?: PersonalStageResolver;
+    resolveRouter?: (request: FleetStartupRequest) => Promise<URL>;
+}
+export declare function resolveDevelopmentRouter(request: FleetStartupRequest): Promise<URL>;
+export declare function startFleetRuntime(startupPath: string, dependencies?: FleetRuntimeDependencies): Promise<RunningFleetRuntime>;