@engjts/nexus 0.1.0

package/dist/database/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/database/schema.ts"],"names":[],"mappings":";;;AAsBA,kCAgBC;AAED,oCAEC;AApBD,SAAgB,WAAW,CAKvB,OAAsD;IAEtD,OAAO;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAA0B;QACjE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAK,EAAiB;QAClD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;KACrB,CAAC;AACN,CAAC;AAED,SAAgB,YAAY,CAAmC,MAAe;IAC1E,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAa,eAAe;IACK;IAA7B,YAA6B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAEhD,KAAK,CAAuC,IAAW;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,gCAAgC,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,UAAU;QACN,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,CAAC,SAAiC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpC,OAAO;YACH,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO;YACrC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC;IACN,CAAC;CACJ;AAzBD,0CAyBC"}

package/dist/database/transactions.d.ts

@@ -0,0 +1,13 @@
+import { DatabaseAdapter } from './adapter';
+import { TransactionContext } from './types';
+export interface TransactionOptions {
+    label?: string;
+    useSavepoints?: boolean;
+}
+export declare class TransactionManager {
+    private readonly adapter;
+    constructor(adapter: DatabaseAdapter);
+    run<T>(callback: (ctx: TransactionContext) => Promise<T>, options?: TransactionOptions): Promise<T>;
+    withSavepoint<T>(callback: () => Promise<T>, context: TransactionContext): Promise<T>;
+}
+//# sourceMappingURL=transactions.d.ts.map

package/dist/database/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../src/database/transactions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,kBAAkB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,eAAe;IAE/C,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;IAyBvG,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;CAiB9F"}

package/dist/database/transactions.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionManager = void 0;
+const crypto_1 = require("crypto");
+class TransactionManager {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async run(callback, options = {}) {
+        const context = {
+            id: options.label ?? (0, crypto_1.randomUUID)(),
+            depth: 0,
+            savepoints: []
+        };
+        const supportsTransactions = this.adapter.capabilities?.transactional !== false;
+        if (!supportsTransactions) {
+            return callback(context);
+        }
+        await this.adapter.beginTransaction?.();
+        try {
+            const result = await callback(context);
+            await this.adapter.commitTransaction?.();
+            return result;
+        }
+        catch (error) {
+            await this.adapter.rollbackTransaction?.();
+            throw error;
+        }
+    }
+    async withSavepoint(callback, context) {
+        const savepoint = `${context.id}-sp-${context.depth}`;
+        context.depth += 1;
+        context.savepoints.push(savepoint);
+        try {
+            await this.adapter.createSavepoint?.(savepoint);
+            const result = await callback();
+            await this.adapter.releaseSavepoint?.(savepoint);
+            return result;
+        }
+        catch (error) {
+            await this.adapter.rollbackTransaction?.(savepoint);
+            throw error;
+        }
+        finally {
+            context.depth -= 1;
+        }
+    }
+}
+exports.TransactionManager = TransactionManager;
+//# sourceMappingURL=transactions.js.map

package/dist/database/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../src/database/transactions.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AASpC,MAAa,kBAAkB;IACE;IAA7B,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;IAAG,CAAC;IAEzD,KAAK,CAAC,GAAG,CAAI,QAAiD,EAAE,UAA8B,EAAE;QAC5F,MAAM,OAAO,GAAuB;YAChC,EAAE,EAAE,OAAO,CAAC,KAAK,IAAI,IAAA,mBAAU,GAAE;YACjC,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,EAAE;SACjB,CAAC;QAEF,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,aAAa,KAAK,KAAK,CAAC;QAEhF,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAExC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACzC,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC3C,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAI,QAA0B,EAAE,OAA2B;QAC1E,MAAM,SAAS,GAAG,GAAG,OAAO,CAAC,EAAE,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;QACtD,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACnB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEnC,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,SAAS,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC;YACjD,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,SAAS,CAAC,CAAC;YACpD,MAAM,KAAK,CAAC;QAChB,CAAC;gBAAS,CAAC;YACP,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;CACJ;AA7CD,gDA6CC"}

package/dist/database/types.d.ts

@@ -0,0 +1,68 @@
+import { z, ZodObject, ZodRawShape } from 'zod';
+export type ColumnShape = ZodRawShape;
+export type RelationType = 'hasOne' | 'hasMany' | 'belongsTo' | 'manyToMany';
+export interface RelationDefinition<TRelated extends string = string, TLocalKey extends string = string, TForeignKey extends string = string> {
+    type: RelationType;
+    relatedTable: TRelated;
+    localKey?: TLocalKey;
+    foreignKey: TForeignKey;
+    through?: {
+        table: string;
+        localPivotKey: string;
+        foreignPivotKey: string;
+    };
+    eager?: {
+        strategy: 'join' | 'separate';
+        limit?: number;
+    };
+}
+export interface IndexDefinition<TColumn extends string = string> {
+    name?: string;
+    columns: TColumn[];
+    unique?: boolean;
+    concurrent?: boolean;
+    suggestion?: string;
+}
+export interface TableDefinition<TName extends string = string, TShape extends ColumnShape = ColumnShape, TRelations extends Record<string, RelationDefinition> = Record<string, RelationDefinition>> {
+    name: TName;
+    schema: ZodObject<TShape>;
+    primaryKey: keyof TShape & string;
+    timestamps?: boolean;
+    relations: TRelations;
+    indexes: IndexDefinition<keyof TShape & string>[];
+    meta?: Record<string, unknown>;
+}
+export type InferRow<TDefinition extends TableDefinition> = z.infer<TDefinition['schema']>;
+export type SchemaDefinition = Record<string, TableDefinition>;
+export interface DatabaseOptions {
+    readonly name?: string;
+    readonly logQueries?: boolean;
+    readonly optimizer?: {
+        nPlusOneThreshold?: number;
+        slowQueryThresholdMs?: number;
+    };
+    readonly realtime?: {
+        enabled?: boolean;
+        bufferSize?: number;
+    };
+}
+export interface QueryMetrics {
+    sql: string;
+    params: unknown[];
+    duration: number;
+    timestamp: number;
+    table: string;
+    plan?: string;
+}
+export interface QueryContext {
+    label?: string;
+    requestId?: string;
+    route?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface TransactionContext {
+    id: string;
+    depth: number;
+    savepoints: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/database/types.d.ts.map

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

package/dist/database/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/database/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/database/types.ts"],"names":[],"mappings":""}

package/dist/deployment/cluster.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Cluster Manager
+ * Provides multi-process clustering for high availability and performance
+ */
+import { Worker } from 'cluster';
+import { EventEmitter } from 'events';
+export interface ClusterOptions {
+    /**
+     * Number of worker processes
+     * @default 'auto' (number of CPU cores)
+     */
+    workers?: number | 'auto';
+    /**
+     * Restart strategy for workers
+     * @default 'rolling'
+     */
+    restartStrategy?: 'rolling' | 'all-at-once' | 'none';
+    /**
+     * Delay between worker restarts (ms)
+     * @default 5000
+     */
+    restartDelay?: number;
+    /**
+     * Maximum restart attempts per worker
+     * @default 10
+     */
+    maxRestarts?: number;
+    /**
+     * Time window for counting restarts (ms)
+     * @default 60000
+     */
+    restartWindow?: number;
+    /**
+     * Callback when a worker starts
+     */
+    onWorkerStart?: (worker: Worker) => void;
+    /**
+     * Callback when a worker exits
+     */
+    onWorkerExit?: (worker: Worker, code: number, signal: string) => void;
+    /**
+     * Callback when a worker sends a message
+     */
+    onWorkerMessage?: (worker: Worker, message: any) => void;
+    /**
+     * Enable sticky sessions for WebSocket support
+     * @default false
+     */
+    stickySessions?: boolean;
+    /**
+     * Enable verbose logging
+     * @default false
+     */
+    verbose?: boolean;
+    /**
+     * Environment variables for workers
+     */
+    env?: Record<string, string>;
+}
+export interface WorkerInfo {
+    id: number;
+    pid: number;
+    startTime: number;
+    restartCount: number;
+    lastRestartTime?: number;
+    status: 'starting' | 'online' | 'listening' | 'disconnecting' | 'dead';
+    memoryUsage?: NodeJS.MemoryUsage;
+}
+export interface ClusterStats {
+    workers: WorkerInfo[];
+    totalWorkers: number;
+    activeWorkers: number;
+    uptime: number;
+    totalRestarts: number;
+    isPrimary: boolean;
+}
+/**
+ * Cluster Manager for multi-process deployment
+ */
+export declare class ClusterManager extends EventEmitter {
+    private options;
+    private workerRestarts;
+    private workerInfo;
+    private startTime;
+    private isShuttingDown;
+    constructor(options?: ClusterOptions);
+    /**
+     * Check if current process is the primary/master
+     */
+    isPrimary(): boolean;
+    /**
+     * Check if current process is a worker
+     */
+    isWorker(): boolean;
+    /**
+     * Get current worker ID (only valid in worker process)
+     */
+    getWorkerId(): number | undefined;
+    /**
+     * Start the cluster
+     */
+    start(workerFn: () => void | Promise<void>): void;
+    /**
+     * Start the primary process
+     */
+    private startPrimary;
+    /**
+     * Start a worker process
+     */
+    private startWorker;
+    /**
+     * Fork a new worker
+     */
+    private forkWorker;
+    /**
+     * Handle worker exit
+     */
+    private handleWorkerExit;
+    /**
+     * Check if worker can be restarted
+     */
+    private canRestart;
+    /**
+     * Schedule worker restart
+     */
+    private scheduleRestart;
+    /**
+     * Update worker status
+     */
+    private updateWorkerStatus;
+    /**
+     * Send message to all workers
+     */
+    broadcast(message: any): void;
+    /**
+     * Send message to specific worker
+     */
+    sendToWorker(workerId: number, message: any): boolean;
+    /**
+     * Rolling restart all workers
+     */
+    rollingRestart(): Promise<void>;
+    /**
+     * Get cluster statistics
+     */
+    getStats(): ClusterStats;
+    /**
+     * Graceful shutdown of all workers
+     */
+    gracefulShutdown(): Promise<void>;
+    private log;
+}
+/**
+ * Create a cluster manager
+ */
+export declare function createCluster(options?: ClusterOptions): ClusterManager;
+/**
+ * Simple cluster helper for common use case
+ */
+export declare function runClustered(workerFn: () => void | Promise<void>, options?: ClusterOptions): ClusterManager;
+//# sourceMappingURL=cluster.d.ts.map

package/dist/deployment/cluster.d.ts.map

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

package/dist/deployment/cluster.js

@@ -0,0 +1,336 @@
+"use strict";
+/**
+ * Cluster Manager
+ * Provides multi-process clustering for high availability and performance
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClusterManager = void 0;
+exports.createCluster = createCluster;
+exports.runClustered = runClustered;
+const cluster_1 = __importDefault(require("cluster"));
+const os_1 = require("os");
+const events_1 = require("events");
+/**
+ * Cluster Manager for multi-process deployment
+ */
+class ClusterManager extends events_1.EventEmitter {
+    options;
+    workerRestarts = new Map();
+    workerInfo = new Map();
+    startTime = Date.now();
+    isShuttingDown = false;
+    constructor(options = {}) {
+        super();
+        const numCPUs = (0, os_1.cpus)().length;
+        this.options = {
+            workers: options.workers === 'auto' ? numCPUs : (options.workers ?? numCPUs),
+            restartStrategy: options.restartStrategy ?? 'rolling',
+            restartDelay: options.restartDelay ?? 5000,
+            maxRestarts: options.maxRestarts ?? 10,
+            restartWindow: options.restartWindow ?? 60000,
+            onWorkerStart: options.onWorkerStart ?? (() => { }),
+            onWorkerExit: options.onWorkerExit ?? (() => { }),
+            onWorkerMessage: options.onWorkerMessage ?? (() => { }),
+            stickySessions: options.stickySessions ?? false,
+            verbose: options.verbose ?? false,
+            env: options.env ?? {}
+        };
+    }
+    /**
+     * Check if current process is the primary/master
+     */
+    isPrimary() {
+        return cluster_1.default.isPrimary || cluster_1.default.isMaster;
+    }
+    /**
+     * Check if current process is a worker
+     */
+    isWorker() {
+        return cluster_1.default.isWorker;
+    }
+    /**
+     * Get current worker ID (only valid in worker process)
+     */
+    getWorkerId() {
+        return cluster_1.default.worker?.id;
+    }
+    /**
+     * Start the cluster
+     */
+    start(workerFn) {
+        if (this.isPrimary()) {
+            this.startPrimary();
+        }
+        else {
+            this.startWorker(workerFn);
+        }
+    }
+    /**
+     * Start the primary process
+     */
+    startPrimary() {
+        const numWorkers = this.options.workers;
+        this.log(`Primary ${process.pid} is running`);
+        this.log(`Starting ${numWorkers} workers...`);
+        // Fork workers
+        for (let i = 0; i < numWorkers; i++) {
+            this.forkWorker();
+        }
+        // Handle worker events
+        cluster_1.default.on('online', (worker) => {
+            this.updateWorkerStatus(worker.id, 'online');
+            this.log(`Worker ${worker.id} (pid: ${worker.process.pid}) is online`);
+            this.options.onWorkerStart(worker);
+            this.emit('worker:online', worker);
+        });
+        cluster_1.default.on('listening', (worker, address) => {
+            this.updateWorkerStatus(worker.id, 'listening');
+            this.log(`Worker ${worker.id} is listening on ${address.port}`);
+            this.emit('worker:listening', worker, address);
+        });
+        cluster_1.default.on('disconnect', (worker) => {
+            this.updateWorkerStatus(worker.id, 'disconnecting');
+            this.log(`Worker ${worker.id} disconnected`);
+            this.emit('worker:disconnect', worker);
+        });
+        cluster_1.default.on('exit', (worker, code, signal) => {
+            this.handleWorkerExit(worker, code, signal);
+        });
+        cluster_1.default.on('message', (worker, message) => {
+            this.options.onWorkerMessage(worker, message);
+            this.emit('worker:message', worker, message);
+        });
+        // Handle graceful shutdown
+        process.on('SIGTERM', () => this.gracefulShutdown());
+        process.on('SIGINT', () => this.gracefulShutdown());
+    }
+    /**
+     * Start a worker process
+     */
+    startWorker(workerFn) {
+        this.log(`Worker ${cluster_1.default.worker?.id} (pid: ${process.pid}) starting...`);
+        Promise.resolve(workerFn()).catch((err) => {
+            console.error(`Worker ${cluster_1.default.worker?.id} failed to start:`, err);
+            process.exit(1);
+        });
+    }
+    /**
+     * Fork a new worker
+     */
+    forkWorker() {
+        const worker = cluster_1.default.fork(this.options.env);
+        this.workerInfo.set(worker.id, {
+            id: worker.id,
+            pid: worker.process.pid,
+            startTime: Date.now(),
+            restartCount: 0,
+            status: 'starting'
+        });
+        return worker;
+    }
+    /**
+     * Handle worker exit
+     */
+    handleWorkerExit(worker, code, signal) {
+        this.updateWorkerStatus(worker.id, 'dead');
+        this.log(`Worker ${worker.id} exited (code: ${code}, signal: ${signal})`);
+        this.options.onWorkerExit(worker, code, signal);
+        this.emit('worker:exit', worker, code, signal);
+        // Don't restart if shutting down
+        if (this.isShuttingDown) {
+            return;
+        }
+        // Check restart limits
+        if (!this.canRestart(worker.id)) {
+            this.log(`Worker ${worker.id} exceeded restart limit, not restarting`);
+            this.emit('worker:restart-limit', worker.id);
+            return;
+        }
+        // Restart based on strategy
+        if (this.options.restartStrategy !== 'none') {
+            this.scheduleRestart(worker.id);
+        }
+    }
+    /**
+     * Check if worker can be restarted
+     */
+    canRestart(workerId) {
+        const now = Date.now();
+        const restartInfo = this.workerRestarts.get(workerId) || { count: 0, timestamps: [] };
+        // Clean old timestamps
+        restartInfo.timestamps = restartInfo.timestamps.filter((t) => now - t < this.options.restartWindow);
+        return restartInfo.timestamps.length < this.options.maxRestarts;
+    }
+    /**
+     * Schedule worker restart
+     */
+    scheduleRestart(workerId) {
+        const delay = this.options.restartStrategy === 'rolling' ? this.options.restartDelay : 0;
+        this.log(`Scheduling restart for worker ${workerId} in ${delay}ms`);
+        setTimeout(() => {
+            if (this.isShuttingDown)
+                return;
+            const restartInfo = this.workerRestarts.get(workerId) || { count: 0, timestamps: [] };
+            restartInfo.count++;
+            restartInfo.timestamps.push(Date.now());
+            this.workerRestarts.set(workerId, restartInfo);
+            const newWorker = this.forkWorker();
+            const info = this.workerInfo.get(newWorker.id);
+            if (info) {
+                info.restartCount = restartInfo.count;
+                info.lastRestartTime = Date.now();
+            }
+            this.log(`Restarted worker ${workerId} as worker ${newWorker.id}`);
+            this.emit('worker:restart', newWorker, workerId);
+        }, delay);
+    }
+    /**
+     * Update worker status
+     */
+    updateWorkerStatus(workerId, status) {
+        const info = this.workerInfo.get(workerId);
+        if (info) {
+            info.status = status;
+        }
+    }
+    /**
+     * Send message to all workers
+     */
+    broadcast(message) {
+        if (!this.isPrimary())
+            return;
+        for (const id in cluster_1.default.workers) {
+            const worker = cluster_1.default.workers[id];
+            if (worker) {
+                worker.send(message);
+            }
+        }
+    }
+    /**
+     * Send message to specific worker
+     */
+    sendToWorker(workerId, message) {
+        if (!this.isPrimary())
+            return false;
+        const worker = cluster_1.default.workers?.[workerId];
+        if (worker) {
+            worker.send(message);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Rolling restart all workers
+     */
+    async rollingRestart() {
+        if (!this.isPrimary())
+            return;
+        this.log('Starting rolling restart...');
+        const workerIds = Object.keys(cluster_1.default.workers || {}).map(Number);
+        for (const id of workerIds) {
+            const worker = cluster_1.default.workers?.[id];
+            if (worker) {
+                // Fork new worker first
+                const newWorker = this.forkWorker();
+                // Wait for new worker to be listening
+                await new Promise((resolve) => {
+                    const onListening = (w) => {
+                        if (w.id === newWorker.id) {
+                            cluster_1.default.off('listening', onListening);
+                            resolve();
+                        }
+                    };
+                    cluster_1.default.on('listening', onListening);
+                    // Timeout after 30 seconds
+                    setTimeout(resolve, 30000);
+                });
+                // Gracefully kill old worker
+                worker.disconnect();
+                // Wait for restart delay
+                await new Promise((resolve) => setTimeout(resolve, this.options.restartDelay));
+            }
+        }
+        this.log('Rolling restart complete');
+        this.emit('cluster:rolling-restart-complete');
+    }
+    /**
+     * Get cluster statistics
+     */
+    getStats() {
+        const workers = [];
+        let activeWorkers = 0;
+        let totalRestarts = 0;
+        for (const [id, info] of this.workerInfo) {
+            // Update memory usage if worker is alive
+            const worker = cluster_1.default.workers?.[id];
+            if (worker) {
+                activeWorkers++;
+            }
+            workers.push({ ...info });
+            totalRestarts += info.restartCount;
+        }
+        return {
+            workers,
+            totalWorkers: this.workerInfo.size,
+            activeWorkers,
+            uptime: Date.now() - this.startTime,
+            totalRestarts,
+            isPrimary: this.isPrimary()
+        };
+    }
+    /**
+     * Graceful shutdown of all workers
+     */
+    async gracefulShutdown() {
+        if (this.isShuttingDown)
+            return;
+        this.isShuttingDown = true;
+        this.log('Initiating graceful shutdown...');
+        this.emit('cluster:shutdown:start');
+        const workers = Object.values(cluster_1.default.workers || {}).filter(Boolean);
+        // Disconnect all workers
+        for (const worker of workers) {
+            worker.disconnect();
+        }
+        // Wait for all workers to exit (with timeout)
+        await Promise.race([
+            Promise.all(workers.map((worker) => new Promise((resolve) => {
+                if (worker.isDead()) {
+                    resolve();
+                }
+                else {
+                    worker.on('exit', () => resolve());
+                }
+            }))),
+            new Promise((resolve) => setTimeout(resolve, 30000))
+        ]);
+        this.log('All workers shut down');
+        this.emit('cluster:shutdown:complete');
+        process.exit(0);
+    }
+    log(message) {
+        if (this.options.verbose) {
+            const prefix = this.isPrimary() ? '[Primary]' : `[Worker ${cluster_1.default.worker?.id}]`;
+            console.log(`${prefix} ${message}`);
+        }
+    }
+}
+exports.ClusterManager = ClusterManager;
+/**
+ * Create a cluster manager
+ */
+function createCluster(options) {
+    return new ClusterManager(options);
+}
+/**
+ * Simple cluster helper for common use case
+ */
+function runClustered(workerFn, options) {
+    const manager = createCluster(options);
+    manager.start(workerFn);
+    return manager;
+}
+//# sourceMappingURL=cluster.js.map