nmtjs 0.16.0 → 0.17.0-beta.1

package/dist/runtime/server/lifecycle.d.ts

@@ -1,85 +0,0 @@
-import EventEmitter from 'node:events';
-import type { Logger } from '@nmtjs/core';
-import type { RuntimeEnvironment } from './environment.ts';
-import type { ApplicationServer } from './server.ts';
-/**
- * States in the server lifecycle state machine.
- */
-export type LifecycleState = 'idle' | 'starting' | 'running' | 'reloading' | 'stopping' | 'stopped' | 'failed';
-/**
- * Events emitted by the ServerLifecycle.
- */
-export interface LifecycleEvents {
-    'state-change': [from: LifecycleState, to: LifecycleState];
-    error: [error: Error, handled: boolean];
-}
-/**
- * Factory function type for creating ApplicationServer instances.
- */
-export type ServerFactory = () => ApplicationServer | Promise<ApplicationServer>;
-/**
- * ServerLifecycle manages the application server lifecycle with a clean state machine.
- *
- * States:
- * - idle: Initial state, server not started
- * - starting: Server is being started
- * - running: Server is running normally
- * - reloading: Server is being reloaded (stop + start)
- * - stopping: Server is being stopped
- * - stopped: Server has been stopped (terminal state)
- * - failed: Server failed to start (can recover via reload in dev mode)
- *
- * Transitions:
- * - idle -> starting (via start())
- * - starting -> running (success) | failed (error)
- * - running -> reloading (via reload()) | stopping (via stop())
- * - reloading -> running (success) | failed (error)
- * - failed -> reloading (via reload()) | stopping (via stop())
- * - stopping -> stopped
- */
-export declare class ServerLifecycle extends EventEmitter<LifecycleEvents> {
-    private readonly env;
-    private readonly createServer;
-    private state;
-    private server;
-    private logger;
-    constructor(env: RuntimeEnvironment, createServer: ServerFactory, logger: Logger);
-    /** Current lifecycle state */
-    get currentState(): LifecycleState;
-    /** Whether the server is currently running */
-    get isRunning(): boolean;
-    /** Whether the server can be started */
-    get canStart(): boolean;
-    /** Whether the server can be stopped */
-    get canStop(): boolean;
-    /** Whether the server can be reloaded */
-    get canReload(): boolean;
-    /** Get the current server instance (if running) */
-    getServer(): ApplicationServer | null;
-    /**
-     * Start the server.
-     * Can only be called from 'idle' or 'failed' states.
-     */
-    start(): Promise<void>;
-    /**
-     * Stop the server.
-     * Can be called from 'running', 'failed', or 'reloading' states.
-     * No-op if already stopped or idle.
-     */
-    stop(): Promise<void>;
-    /**
-     * Reload the server (stop current instance and start a new one).
-     * Can be called from 'running' or 'failed' states.
-     */
-    reload(): Promise<void>;
-    private handleStartupError;
-    /**
-     * Transition to a new state, emitting the state-change event.
-     */
-    private transition;
-    /**
-     * Assert that the current state is one of the allowed states.
-     * Throws if not.
-     */
-    private assertState;
-}

package/dist/runtime/server/lifecycle.js

@@ -1,177 +0,0 @@
-import EventEmitter from 'node:events';
-/**
- * ServerLifecycle manages the application server lifecycle with a clean state machine.
- *
- * States:
- * - idle: Initial state, server not started
- * - starting: Server is being started
- * - running: Server is running normally
- * - reloading: Server is being reloaded (stop + start)
- * - stopping: Server is being stopped
- * - stopped: Server has been stopped (terminal state)
- * - failed: Server failed to start (can recover via reload in dev mode)
- *
- * Transitions:
- * - idle -> starting (via start())
- * - starting -> running (success) | failed (error)
- * - running -> reloading (via reload()) | stopping (via stop())
- * - reloading -> running (success) | failed (error)
- * - failed -> reloading (via reload()) | stopping (via stop())
- * - stopping -> stopped
- */
-export class ServerLifecycle extends EventEmitter {
-    env;
-    createServer;
-    state = 'idle';
-    server = null;
-    logger;
-    constructor(env, createServer, logger) {
-        super();
-        this.env = env;
-        this.createServer = createServer;
-        this.logger = logger.child({ component: 'ServerLifecycle' });
-    }
-    /** Current lifecycle state */
-    get currentState() {
-        return this.state;
-    }
-    /** Whether the server is currently running */
-    get isRunning() {
-        return this.state === 'running';
-    }
-    /** Whether the server can be started */
-    get canStart() {
-        return this.state === 'idle' || this.state === 'failed';
-    }
-    /** Whether the server can be stopped */
-    get canStop() {
-        return (this.state === 'running' ||
-            this.state === 'failed' ||
-            this.state === 'reloading');
-    }
-    /** Whether the server can be reloaded */
-    get canReload() {
-        return this.state === 'running' || this.state === 'failed';
-    }
-    /** Get the current server instance (if running) */
-    getServer() {
-        return this.server;
-    }
-    /**
-     * Start the server.
-     * Can only be called from 'idle' or 'failed' states.
-     */
-    async start() {
-        this.assertState('idle', 'failed');
-        this.transition('starting');
-        try {
-            this.server = await this.createServer();
-            await this.server.start();
-            this.transition('running');
-        }
-        catch (error) {
-            this.transition('failed');
-            await this.handleStartupError(error);
-        }
-    }
-    /**
-     * Stop the server.
-     * Can be called from 'running', 'failed', or 'reloading' states.
-     * No-op if already stopped or idle.
-     */
-    async stop() {
-        if (this.state === 'stopped' || this.state === 'idle')
-            return;
-        this.assertState('running', 'failed', 'reloading');
-        this.transition('stopping');
-        try {
-            await this.server?.stop();
-        }
-        catch (error) {
-            this.logger.error(new Error('Error while stopping server (continuing shutdown)', {
-                cause: error,
-            }));
-        }
-        finally {
-            this.server = null;
-            this.transition('stopped');
-        }
-    }
-    /**
-     * Reload the server (stop current instance and start a new one).
-     * Can be called from 'running' or 'failed' states.
-     */
-    async reload() {
-        this.assertState('running', 'failed');
-        this.transition('reloading');
-        try {
-            // Stop current server if exists
-            if (this.server) {
-                await this.server.stop();
-                this.server = null;
-            }
-            // Create and start new server
-            this.server = await this.createServer();
-            await this.server.start();
-            this.transition('running');
-        }
-        catch (error) {
-            this.server = null;
-            this.transition('failed');
-            await this.handleStartupError(error);
-        }
-    }
-    /**
-     * Handle startup/reload error according to the error policy.
-     */
-    async handleStartupError(error) {
-        const action = this.env.errorPolicy.onStartupError(error);
-        const handled = action.type !== 'exit';
-        this.emit('error', error, handled);
-        switch (action.type) {
-            case 'exit':
-                this.logger.fatal(new Error('Startup failed, exiting', { cause: error }));
-                process.exit(action.code);
-                break;
-            case 'wait':
-                // Dev mode: stay alive, HMR will call reload()
-                this.logger.error(new Error('Startup failed, waiting for fix via HMR', {
-                    cause: error,
-                }));
-                break;
-            case 'restart':
-                this.logger.warn({ error, delay: action.delay }, 'Startup failed, scheduling restart');
-                setTimeout(() => {
-                    // Only restart if still in failed state
-                    if (this.state === 'failed') {
-                        this.start().catch((e) => {
-                            this.logger.error(new Error('Restart failed', { cause: e }));
-                        });
-                    }
-                }, action.delay);
-                break;
-            case 'ignore':
-                this.logger.warn({ error }, 'Startup failed, ignoring');
-                break;
-        }
-    }
-    /**
-     * Transition to a new state, emitting the state-change event.
-     */
-    transition(to) {
-        const from = this.state;
-        this.state = to;
-        this.logger.debug({ from, to }, 'State transition');
-        this.emit('state-change', from, to);
-    }
-    /**
-     * Assert that the current state is one of the allowed states.
-     * Throws if not.
-     */
-    assertState(...allowed) {
-        if (!allowed.includes(this.state)) {
-            throw new Error(`Invalid state: ${this.state}, expected one of: ${allowed.join(', ')}`);
-        }
-    }
-}
-//# sourceMappingURL=lifecycle.js.map

package/dist/runtime/server/lifecycle.js.map

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

package/dist/runtime/server/managed-worker.d.ts

@@ -1,158 +0,0 @@
-import type { MessagePort, WorkerOptions } from 'node:worker_threads';
-import EventEmitter from 'node:events';
-import { Worker } from 'node:worker_threads';
-import type { Logger } from '@nmtjs/core';
-import type { WorkerType } from '../enums.ts';
-import type { JobTaskResult, ServerPortMessageTypes, ThreadPortMessageTypes, WorkerJobTask, WorkerThreadError } from '../types.ts';
-import type { ErrorPolicy } from './error-policy.ts';
-/**
- * States in the worker state machine.
- */
-export type WorkerState = 'idle' | 'starting' | 'ready' | 'error' | 'restarting' | 'stopping' | 'stopped';
-/**
- * Context tracked for each managed worker.
- */
-export interface ManagedWorkerContext {
-    consecutiveFailures: number;
-    totalFailures: number;
-    lastStableTime: number | null;
-    lastError: Error | null;
-}
-/**
- * Configuration for creating a managed worker.
- */
-export interface ManagedWorkerConfig {
-    id: string;
-    name: string;
-    index: number;
-    workerType: WorkerType;
-    path: string;
-    workerData?: any;
-    workerOptions?: Partial<WorkerOptions>;
-    onWorker?: (registration: {
-        worker: Worker;
-        vitePort?: MessagePort;
-    }) => void;
-}
-/**
- * Events emitted by ManagedWorker.
- */
-export interface ManagedWorkerEvents {
-    'state-change': [from: WorkerState, to: WorkerState];
-    ready: [hosts?: ThreadPortMessageTypes['ready']['hosts']];
-    error: [error: WorkerThreadError];
-    task: [data: ThreadPortMessageTypes['task']];
-}
-/**
- * ManagedWorker wraps a Node.js Worker thread with:
- * - Explicit state machine
- * - Automatic restart with exponential backoff
- * - Error tracking and stability detection
- * - Integration with ErrorPolicy for restart decisions
- *
- * State Machine:
- * - idle: Initial state, worker not created
- * - starting: Worker created, waiting for ready message
- * - ready: Worker is running and healthy
- * - error: Worker crashed or failed to start
- * - restarting: Worker is scheduled for restart (waiting for delay)
- * - stopping: Worker is being terminated
- * - stopped: Worker has been terminated (terminal state)
- */
-export declare class ManagedWorker extends EventEmitter<ManagedWorkerEvents> {
-    readonly config: ManagedWorkerConfig;
-    protected readonly policy: ErrorPolicy;
-    protected state: WorkerState;
-    protected ctx: ManagedWorkerContext;
-    protected worker: Worker | null;
-    protected port: MessagePort | null;
-    protected vitePort: MessagePort | null;
-    protected restartTimer: ReturnType<typeof setTimeout> | null;
-    protected startPromise: Promise<void> | null;
-    protected pendingTaskIds: Set<string>;
-    protected logger: Logger;
-    constructor(config: ManagedWorkerConfig, policy: ErrorPolicy, logger: Logger);
-    /** Current worker state */
-    get currentState(): WorkerState;
-    /** Whether the worker is healthy (ready state) */
-    get isHealthy(): boolean;
-    /** Get a copy of the worker context */
-    get context(): ManagedWorkerContext;
-    /**
-     * Reset failure counts. Called when HMR update comes in to give the worker
-     * a fresh start after code has been fixed.
-     */
-    resetFailureCount(): void;
-    /** Get the underlying Worker instance (if exists) */
-    getWorker(): Worker | null;
-    /**
-     * Start the worker.
-     * Can only be called from 'idle' or 'error' states.
-     */
-    start(): Promise<void>;
-    /**
-     * Stop the worker.
-     * Can be called from any state except 'stopped'.
-     * Clears any pending restart timers and rejects pending run() tasks.
-     */
-    stop(): Promise<void>;
-    /**
-     * Run a task on this worker (for job workers).
-     * The worker must be in 'ready' state.
-     */
-    run(task: WorkerJobTask): Promise<JobTaskResult>;
-    /**
-     * Send a message to the worker.
-     */
-    send<T extends keyof ServerPortMessageTypes>(type: T, ...[data]: ServerPortMessageTypes[T] extends undefined ? [] : [data: ServerPortMessageTypes[T]]): void;
-    /**
-     * Internal: Start the worker and wait for it to be ready.
-     */
-    protected doStart(): Promise<void>;
-    /**
-     * Wait for the worker to emit a 'ready' message or timeout.
-     */
-    protected waitForReady(): Promise<void>;
-    /**
-     * Attach listeners for port and worker events.
-     */
-    protected attachListeners(): void;
-    /**
-     * Handle worker ready event.
-     */
-    protected handleReady(hosts?: ThreadPortMessageTypes['ready']['hosts']): void;
-    /**
-     * Handle worker error.
-     */
-    protected handleError(error: Error): void;
-    /**
-     * Schedule a restart after the given delay.
-     */
-    protected scheduleRestart(delay: number): void;
-    /**
-     * Clear any pending restart timer.
-     */
-    protected clearRestartTimer(): void;
-    /**
-     * Terminate the underlying worker thread.
-     */
-    protected terminateWorker(): Promise<void>;
-    /**
-     * Cleanup internal state.
-     */
-    protected cleanup(): void;
-    /**
-     * Reject all pending run() calls by emitting an error result
-     * for each tracked task id. This unblocks callers waiting on
-     * `once(this, 'task-<id>')` so they don't hang during shutdown.
-     */
-    protected rejectPendingTasks(): void;
-    /**
-     * Transition to a new state, emitting the state-change event.
-     */
-    protected transition(to: WorkerState): void;
-    /**
-     * Assert that the current state is one of the allowed states.
-     */
-    protected assertState(...allowed: WorkerState[]): void;
-}