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

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

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FleetControlServer = exports.FLEET_CONTROL_RESPONSE_MAX_BYTES = void 0;
+exports.validateFleetControlResponse = validateFleetControlResponse;
+exports.sendFleetControlRequest = sendFleetControlRequest;
+const node_fs_1 = require("node:fs");
+const node_net_1 = require("node:net");
+const contract_validation_js_1 = require("./contract-validation.js");
+const control_contract_js_1 = require("./control-contract.js");
+const errors_js_1 = require("./errors.js");
+exports.FLEET_CONTROL_RESPONSE_MAX_BYTES = 64 * 1024;
+function boundedResponse(value) {
+    const encoded = `${(0, contract_validation_js_1.canonicalJson)(value)}\n`;
+    if (Buffer.byteLength(encoded) > exports.FLEET_CONTROL_RESPONSE_MAX_BYTES) {
+        throw new errors_js_1.LocalDevContractError('invalid-state', 'Fleet control response exceeds its bounded size.');
+    }
+    return encoded;
+}
+function safeFailure(requestId, error) {
+    const classification = error instanceof errors_js_1.LocalDevContractError
+        ? error.classification
+        : 'internal-error';
+    const rawMessage = error instanceof errors_js_1.LocalDevContractError
+        ? error.message
+        : 'The Fleet supervisor could not complete the request.';
+    return {
+        error: {
+            classification,
+            message: rawMessage.slice(0, 1_024),
+        },
+        ok: false,
+        protocolVersion: control_contract_js_1.FLEET_CONTROL_PROTOCOL_VERSION,
+        requestId,
+    };
+}
+function validateFleetControlResponse(value) {
+    if (!(0, contract_validation_js_1.isRecord)(value) || typeof value.ok !== 'boolean') {
+        throw new errors_js_1.LocalDevContractError('protocol-mismatch', 'Fleet control response is malformed.');
+    }
+    if (value.protocolVersion !== control_contract_js_1.FLEET_CONTROL_PROTOCOL_VERSION) {
+        throw new errors_js_1.LocalDevContractError('protocol-mismatch', 'Fleet control response protocol is incompatible.');
+    }
+    const requestId = (0, contract_validation_js_1.requireBoundedString)(value.requestId, 'Fleet control response requestId', {
+        maximumLength: 128,
+        pattern: /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/,
+    });
+    if (value.ok) {
+        const keys = Object.keys(value);
+        if (keys.length !== 4 ||
+            !keys.every((key) => ['ok', 'protocolVersion', 'requestId', 'result'].includes(key))) {
+            throw new errors_js_1.LocalDevContractError('protocol-mismatch', 'Fleet control success response has unsupported members.');
+        }
+        return {
+            ok: true,
+            protocolVersion: control_contract_js_1.FLEET_CONTROL_PROTOCOL_VERSION,
+            requestId,
+            result: value.result,
+        };
+    }
+    const keys = Object.keys(value);
+    if (keys.length !== 4 ||
+        !keys.every((key) => ['error', 'ok', 'protocolVersion', 'requestId'].includes(key)) ||
+        !(0, contract_validation_js_1.isRecord)(value.error)) {
+        throw new errors_js_1.LocalDevContractError('protocol-mismatch', 'Fleet control failure response has unsupported members.');
+    }
+    const errorKeys = Object.keys(value.error);
+    if (errorKeys.length !== 2 ||
+        !errorKeys.every((key) => ['classification', 'message'].includes(key)) ||
+        !errors_js_1.LOCAL_DEV_FAILURE_CLASSIFICATIONS.includes(value.error.classification)) {
+        throw new errors_js_1.LocalDevContractError('protocol-mismatch', 'Fleet control failure classification is invalid.');
+    }
+    return {
+        error: {
+            classification: value.error
+                .classification,
+            message: (0, contract_validation_js_1.requireBoundedString)(value.error.message, 'Fleet control response error message', { maximumLength: 1_024 }),
+        },
+        ok: false,
+        protocolVersion: control_contract_js_1.FLEET_CONTROL_PROTOCOL_VERSION,
+        requestId,
+    };
+}
+function writeAndClose(socket, value) {
+    try {
+        socket.end(boundedResponse(value));
+    }
+    catch {
+        socket.destroy();
+    }
+}
+class FleetControlServer {
+    #capabilityDigest;
+    #handler;
+    #path;
+    #server;
+    constructor(path, capabilityDigest, handler) {
+        this.#path = path;
+        this.#capabilityDigest = capabilityDigest;
+        this.#handler = handler;
+    }
+    async listen() {
+        if (this.#server) {
+            throw new errors_js_1.LocalDevContractError('invalid-state', 'Fleet control server is already listening.');
+        }
+        if (process.platform !== 'win32' && (0, node_fs_1.existsSync)(this.#path)) {
+            (0, node_fs_1.rmSync)(this.#path, { force: true });
+        }
+        const server = (0, node_net_1.createServer)((socket) => this.#accept(socket));
+        this.#server = server;
+        await new Promise((resolvePromise, reject) => {
+            const fail = (error) => {
+                server.off('listening', ready);
+                reject(error);
+            };
+            const ready = () => {
+                server.off('error', fail);
+                resolvePromise();
+            };
+            server.once('error', fail);
+            server.once('listening', ready);
+            server.listen({
+                path: this.#path,
+                readableAll: false,
+                writableAll: false,
+            });
+        });
+        if (process.platform !== 'win32')
+            (0, node_fs_1.chmodSync)(this.#path, 0o600);
+    }
+    #accept(socket) {
+        let bytes = 0;
+        let buffer = '';
+        let complete = false;
+        const rejectMalformed = () => {
+            if (complete)
+                return;
+            complete = true;
+            writeAndClose(socket, {
+                error: {
+                    classification: 'invalid-input',
+                    message: 'Fleet control request is malformed.',
+                },
+                ok: false,
+                protocolVersion: control_contract_js_1.FLEET_CONTROL_PROTOCOL_VERSION,
+                requestId: 'invalid-request',
+            });
+        };
+        socket.setTimeout(5_000, rejectMalformed);
+        socket.on('error', () => undefined);
+        socket.on('data', (chunk) => {
+            if (complete)
+                return;
+            bytes += chunk.length;
+            if (bytes > control_contract_js_1.FLEET_CONTROL_REQUEST_MAX_BYTES) {
+                rejectMalformed();
+                return;
+            }
+            buffer += chunk.toString('utf8');
+            const newline = buffer.indexOf('\n');
+            if (newline === -1)
+                return;
+            if (buffer.slice(newline + 1).trim().length > 0) {
+                rejectMalformed();
+                return;
+            }
+            complete = true;
+            void this.#dispatch(socket, buffer.slice(0, newline));
+        });
+        socket.once('end', () => {
+            if (!complete)
+                rejectMalformed();
+        });
+    }
+    async #dispatch(socket, line) {
+        let request;
+        try {
+            request = (0, control_contract_js_1.parseFleetControlLine)(line);
+            (0, control_contract_js_1.authorizeFleetControlCapability)(request.capability, this.#capabilityDigest);
+        }
+        catch (error) {
+            if (error instanceof control_contract_js_1.FleetControlUnauthorizedError) {
+                writeAndClose(socket, control_contract_js_1.FIXED_UNAUTHORIZED_CONTROL_RESPONSE);
+                return;
+            }
+            writeAndClose(socket, {
+                error: {
+                    classification: error instanceof errors_js_1.LocalDevContractError
+                        ? error.classification
+                        : 'invalid-input',
+                    message: 'Fleet control request is invalid.',
+                },
+                ok: false,
+                protocolVersion: control_contract_js_1.FLEET_CONTROL_PROTOCOL_VERSION,
+                requestId: 'invalid-request',
+            });
+            return;
+        }
+        try {
+            const result = await this.#handler(request);
+            writeAndClose(socket, {
+                ok: true,
+                protocolVersion: control_contract_js_1.FLEET_CONTROL_PROTOCOL_VERSION,
+                requestId: request.requestId,
+                result,
+            });
+        }
+        catch (error) {
+            writeAndClose(socket, safeFailure(request.requestId, error));
+        }
+    }
+    async close() {
+        const server = this.#server;
+        this.#server = undefined;
+        if (server) {
+            await new Promise((resolvePromise) => server.close(() => resolvePromise()));
+        }
+        if (process.platform !== 'win32')
+            (0, node_fs_1.rmSync)(this.#path, { force: true });
+    }
+}
+exports.FleetControlServer = FleetControlServer;
+async function sendFleetControlRequest(path, request, timeoutMs = 5_000) {
+    const payload = `${(0, contract_validation_js_1.canonicalJson)(request)}\n`;
+    if (Buffer.byteLength(payload) > control_contract_js_1.FLEET_CONTROL_REQUEST_MAX_BYTES) {
+        throw new errors_js_1.LocalDevContractError('invalid-input', 'Fleet control request exceeds its bounded size.');
+    }
+    return new Promise((resolvePromise, reject) => {
+        const socket = (0, node_net_1.createConnection)({ path });
+        let bytes = 0;
+        let buffer = '';
+        const fail = (error) => {
+            socket.destroy();
+            reject(error instanceof errors_js_1.LocalDevContractError ||
+                error instanceof control_contract_js_1.FleetControlUnauthorizedError
+                ? error
+                : new errors_js_1.LocalDevContractError('supervisor-unreachable', `Fleet supervisor is unreachable: ${error instanceof Error ? error.message : String(error)}`));
+        };
+        socket.setTimeout(timeoutMs, () => fail(new Error(`timed out after ${timeoutMs}ms`)));
+        socket.once('error', fail);
+        socket.once('connect', () => socket.end(payload));
+        socket.on('data', (chunk) => {
+            bytes += chunk.length;
+            if (bytes > exports.FLEET_CONTROL_RESPONSE_MAX_BYTES) {
+                fail(new errors_js_1.LocalDevContractError('protocol-mismatch', 'Fleet control response exceeds its bounded size.'));
+                return;
+            }
+            buffer += chunk.toString('utf8');
+        });
+        socket.once('end', () => {
+            try {
+                const parsed = JSON.parse(buffer.trim());
+                if ((0, contract_validation_js_1.isRecord)(parsed) &&
+                    parsed.ok === false &&
+                    parsed.error === 'unauthorized') {
+                    return fail(new control_contract_js_1.FleetControlUnauthorizedError());
+                }
+                resolvePromise(validateFleetControlResponse(parsed));
+            }
+            catch (error) {
+                fail(error instanceof errors_js_1.LocalDevContractError
+                    ? error
+                    : new errors_js_1.LocalDevContractError('protocol-mismatch', 'Fleet control response is malformed.'));
+            }
+        });
+    });
+}
+//# sourceMappingURL=fleet-ipc.js.map

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

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

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

@@ -0,0 +1,53 @@
+import { spawn } from 'node:child_process';
+import { FleetClient } from './fleet-client.js';
+import { type FleetRouterSource } from './fleet-configuration.js';
+import { startFleetRuntime, type RunningFleetRuntime } from './fleet-runtime.js';
+import { type FleetStartupRequest } from './fleet-startup.js';
+import type { LocalDevContext } from './local-context.js';
+import { type WorkspaceFleetPlan, type WorkspaceNxRuntime } from './nx-workspace.js';
+import { type PersonalStageResolver, type PersonalStageResolution } from './personal-stage.js';
+import { fleetRuntimePaths } from './runtime-paths.js';
+import { type FleetProcessIdentity, type ProcessIdentityProbe } from './fleet-lock.js';
+import { type PrivateStateSecurity } from './private-state.js';
+export interface FleetLaunchInput {
+    appData: string;
+    context: LocalDevContext;
+    foreground: boolean;
+    frameworkVersion: string;
+    sstMode?: 'mono' | 'multiplexer';
+    workspaceRoot: string;
+}
+export interface PreparedFleetLaunch {
+    configurationFingerprint: string;
+    identity: PersonalStageResolution;
+    nxVersion: string;
+    paths: ReturnType<typeof fleetRuntimePaths>;
+    plan: WorkspaceFleetPlan;
+    request: FleetStartupRequest;
+    routerOrigin: string;
+    routerSource: FleetRouterSource;
+}
+export interface FleetLaunchResult {
+    attached: boolean;
+    client: FleetClient;
+    fleetId: string;
+    runtime?: RunningFleetRuntime;
+}
+export interface FleetLauncherDependencies {
+    daemonPath?: string;
+    generation?: () => string;
+    gitCommonDirectory?: (workspaceRoot: string) => string;
+    loadPlan?: () => Promise<WorkspaceFleetPlan>;
+    launcherIdentity?: () => FleetProcessIdentity;
+    personalStageResolver?: PersonalStageResolver;
+    processProbe?: (identity: FleetProcessIdentity) => ProcessIdentityProbe;
+    resolveNxRuntime?: (workspaceRoot: string) => WorkspaceNxRuntime;
+    resolveRouter?: (request: FleetStartupRequest) => Promise<URL>;
+    security?: PrivateStateSecurity;
+    spawn?: typeof spawn;
+    startRuntime?: typeof startFleetRuntime;
+}
+export declare function resolveGitCommonDirectory(workspaceRoot: string): string;
+export declare function prepareFleetLaunch(input: FleetLaunchInput, dependencies?: FleetLauncherDependencies): Promise<PreparedFleetLaunch>;
+export declare function verifyAttachedState(prepared: PreparedFleetLaunch, client: Pick<FleetClient, 'status'>): Promise<void>;
+export declare function launchOrAttachFleet(input: FleetLaunchInput, dependencies?: FleetLauncherDependencies): Promise<FleetLaunchResult>;