@procwire/transport 0.1.3 → 0.3.0

package/dist/resilience/handle.js

@@ -0,0 +1,371 @@
+/**
+ * ResilientProcessHandle implementation.
+ *
+ * Wraps a ProcessHandle with heartbeat monitoring, auto-reconnect,
+ * and graceful shutdown capabilities.
+ *
+ * @packageDocumentation
+ * @module Resilience
+ */
+import { EventEmitter } from "../utils/events.js";
+import { HeartbeatManager, DEFAULT_HEARTBEAT_OPTIONS } from "../heartbeat/index.js";
+import { ReconnectManager, DEFAULT_RECONNECT_OPTIONS } from "../reconnect/index.js";
+import { ShutdownManager, DEFAULT_SHUTDOWN_OPTIONS } from "../shutdown/index.js";
+import { ReservedMethods } from "../protocol/reserved-methods.js";
+/**
+ * Creates a Reconnectable adapter from a ProcessHandle.
+ *
+ * Note: Reconnection is NOT supported for stdio-based ProcessHandle.
+ * stdio streams are bound to a specific process - when the process dies,
+ * the streams are destroyed and cannot be "reconnected".
+ *
+ * For ProcessHandle, "reconnection" means restarting the process, which is
+ * the responsibility of ProcessManager at a higher level, not ResilientProcessHandle.
+ *
+ * Reconnection IS supported for socket-based transports (TCP, named pipes as server)
+ * where a new connection can be established to a listening endpoint.
+ *
+ * @internal
+ */
+function createReconnectable(_handle) {
+    return {
+        connect: async () => {
+            // stdio-based handles cannot be reconnected - the streams are bound
+            // to a specific process and are destroyed when the process exits.
+            // Use ProcessManager.restart() to restart the entire process instead.
+            throw new Error("Reconnection not supported for ProcessHandle. " +
+                "Use ProcessManager.restart() to restart the process.");
+        },
+    };
+}
+/**
+ * Creates a Shutdownable adapter from a ProcessHandle and control channel.
+ */
+function createShutdownable(handle, kill) {
+    return {
+        id: handle.id,
+        pid: handle.pid,
+        request: (method, params, timeout) => handle.request(method, params, timeout),
+        kill,
+        onNotification: (method, handler) => {
+            // Subscribe to notifications from the control channel
+            // The channel's onNotification returns an unsubscribe function
+            const channel = handle.controlChannel;
+            // We need to filter notifications by method
+            const wrappedHandler = (notification) => {
+                // Check if this notification has the expected method
+                // The notification format depends on the protocol
+                const notif = notification;
+                if (notif.method === method) {
+                    handler(notif.params);
+                }
+            };
+            return channel.onNotification(wrappedHandler);
+        },
+    };
+}
+/**
+ * Default resilient process options.
+ *
+ * Note: Reconnect is disabled by default for ProcessHandle because stdio-based
+ * transports cannot be reconnected. See createReconnectable() for details.
+ */
+export const DEFAULT_RESILIENT_OPTIONS = {
+    heartbeat: DEFAULT_HEARTBEAT_OPTIONS,
+    reconnect: { ...DEFAULT_RECONNECT_OPTIONS, enabled: false },
+    shutdown: DEFAULT_SHUTDOWN_OPTIONS,
+};
+/**
+ * A process handle with resilience features.
+ *
+ * Combines heartbeat monitoring, auto-reconnect, and graceful shutdown
+ * with a standard ProcessHandle.
+ *
+ * @example
+ * ```typescript
+ * const resilientHandle = new ResilientProcessHandle(processHandle, {
+ *   heartbeat: { intervalMs: 5000, timeoutMs: 1000, maxMissed: 3 },
+ *   reconnect: { maxAttempts: 5, initialDelay: 100 },
+ *   shutdown: { gracefulTimeoutMs: 5000 },
+ * });
+ *
+ * resilientHandle.on('heartbeatDead', () => {
+ *   console.log('Worker is unresponsive');
+ * });
+ *
+ * resilientHandle.on('reconnected', ({ attempt }) => {
+ *   console.log(`Reconnected after ${attempt} attempts`);
+ * });
+ *
+ * resilientHandle.start();
+ *
+ * // Later
+ * await resilientHandle.shutdown('user_requested');
+ * ```
+ */
+export class ResilientProcessHandle {
+    _handle;
+    events = new EventEmitter();
+    heartbeatManager = null;
+    reconnectManager = null;
+    shutdownManager = null;
+    handleEventSubscriptions = [];
+    resilienceSubscriptions = [];
+    _isHealthy = true;
+    killFn = null;
+    /**
+     * Creates a new ResilientProcessHandle.
+     *
+     * @param handle - The underlying ProcessHandle
+     * @param options - Resilience configuration options
+     * @param killFn - Function to kill the process (injected for testability)
+     */
+    constructor(handle, options = {}, killFn) {
+        this._handle = handle;
+        this.killFn = killFn ?? null;
+        // Initialize heartbeat manager if not disabled
+        if (options.heartbeat !== false) {
+            const heartbeatOptions = {
+                ...DEFAULT_HEARTBEAT_OPTIONS,
+                ...(options.heartbeat ?? {}),
+            };
+            this.heartbeatManager = new HeartbeatManager(handle.controlChannel, heartbeatOptions);
+            this.setupHeartbeatListeners();
+        }
+        // Initialize reconnect manager if not disabled
+        if (options.reconnect !== false) {
+            const reconnectOptions = {
+                ...DEFAULT_RECONNECT_OPTIONS,
+                ...(options.reconnect ?? {}),
+            };
+            this.reconnectManager = new ReconnectManager(createReconnectable(handle), reconnectOptions);
+            this.setupReconnectListeners();
+        }
+        // Initialize shutdown manager if not disabled
+        if (options.shutdown !== false) {
+            const shutdownOptions = {
+                ...DEFAULT_SHUTDOWN_OPTIONS,
+                ...(options.shutdown ?? {}),
+            };
+            this.shutdownManager = new ShutdownManager(shutdownOptions);
+            this.setupShutdownListeners();
+        }
+        // Forward base handle events
+        this.setupHandleEventForwarding();
+    }
+    // ProcessHandle interface delegation
+    get id() {
+        return this._handle.id;
+    }
+    get pid() {
+        return this._handle.pid;
+    }
+    get state() {
+        return this._handle.state;
+    }
+    get isHealthy() {
+        return this._isHealthy;
+    }
+    get isReconnecting() {
+        return this.reconnectManager?.isReconnecting() ?? false;
+    }
+    get controlChannel() {
+        return this._handle.controlChannel;
+    }
+    get dataChannel() {
+        return this._handle.dataChannel;
+    }
+    get handle() {
+        return this._handle;
+    }
+    /**
+     * Sends a request, optionally queueing during reconnection.
+     * Successful requests signal activity to the heartbeat manager (implicit heartbeat).
+     */
+    async request(method, params, timeout) {
+        // If reconnecting and queueing is enabled, queue the request
+        if (this.reconnectManager?.isReconnecting()) {
+            const queued = this.reconnectManager.queueRequest(method, async () => {
+                return this._handle.request(method, params, timeout);
+            });
+            if (queued !== null) {
+                return queued;
+            }
+        }
+        const result = await this._handle.request(method, params, timeout);
+        // Signal activity to heartbeat manager (implicit heartbeat mode)
+        // This prevents healthy workers from being marked dead just because
+        // they don't respond to ping/pong while actively processing requests
+        this.heartbeatManager?.onActivity();
+        return result;
+    }
+    async notify(method, params) {
+        return this._handle.notify(method, params);
+    }
+    async requestViaData(method, params, timeout) {
+        if (!this._handle.dataChannel) {
+            throw new Error(`Data channel not available for process '${this.id}'`);
+        }
+        return this._handle.dataChannel.request(method, params, timeout);
+    }
+    /**
+     * Initiates graceful shutdown of the process.
+     */
+    async shutdown(reason = "user_requested") {
+        if (!this.shutdownManager) {
+            // No graceful shutdown - force kill and close
+            this.forceKill();
+            await this.close();
+            return;
+        }
+        // Stop heartbeat during shutdown
+        this.heartbeatManager?.stop();
+        const shutdownable = createShutdownable(this._handle, (signal) => {
+            if (this.killFn) {
+                this.killFn(signal);
+            }
+            else if (this._handle.pid !== null) {
+                // Fallback to process.kill() if no killFn provided
+                try {
+                    process.kill(this._handle.pid, signal ?? "SIGTERM");
+                }
+                catch {
+                    // Process may already be dead
+                }
+            }
+        });
+        await this.shutdownManager.initiateShutdown(shutdownable, reason);
+    }
+    async close() {
+        this.stop();
+        this.cleanupAllSubscriptions();
+        await this._handle.close();
+    }
+    on(event, handler) {
+        return this.events.on(event, handler);
+    }
+    /**
+     * Starts resilience features.
+     */
+    start() {
+        if (this.heartbeatManager) {
+            this.setupHeartbeatPongListener();
+            this.heartbeatManager.start();
+        }
+    }
+    /**
+     * Stops resilience features.
+     * Note: Base handle event forwarding continues after stop().
+     */
+    stop() {
+        this.heartbeatManager?.stop();
+        this.reconnectManager?.cancel();
+        // Cleanup resilience subscriptions only (not handle event forwarding)
+        for (const unsub of this.resilienceSubscriptions) {
+            unsub();
+        }
+        this.resilienceSubscriptions.length = 0;
+    }
+    // Private methods
+    setupHeartbeatListeners() {
+        if (!this.heartbeatManager)
+            return;
+        this.heartbeatManager.on("heartbeat:missed", ({ missedCount }) => {
+            this.events.emit("heartbeatMissed", { missedCount });
+        });
+        this.heartbeatManager.on("heartbeat:recovered", ({ missedCount }) => {
+            this._isHealthy = true;
+            this.events.emit("heartbeatRecovered", { missedCount });
+        });
+        this.heartbeatManager.on("heartbeat:dead", ({ missedCount, lastPongAt }) => {
+            this._isHealthy = false;
+            this.events.emit("heartbeatDead", { missedCount, lastPongAt });
+        });
+    }
+    setupReconnectListeners() {
+        if (!this.reconnectManager)
+            return;
+        this.reconnectManager.on("reconnect:attempting", ({ attempt, delay }) => {
+            this.events.emit("reconnecting", { attempt, delay });
+        });
+        this.reconnectManager.on("reconnect:success", ({ attempt, totalTimeMs }) => {
+            this.events.emit("reconnected", { attempt, totalTimeMs });
+        });
+        this.reconnectManager.on("reconnect:failed", ({ attempts, lastError }) => {
+            this.events.emit("reconnectFailed", { attempts, lastError });
+        });
+    }
+    setupShutdownListeners() {
+        if (!this.shutdownManager)
+            return;
+        this.shutdownManager.on("shutdown:start", ({ reason }) => {
+            this.events.emit("shutdownStarted", { reason });
+        });
+        this.shutdownManager.on("shutdown:ack", ({ pendingRequests }) => {
+            this.events.emit("shutdownAcknowledged", { pendingRequests });
+        });
+        this.shutdownManager.on("shutdown:done", ({ graceful, durationMs }) => {
+            this.events.emit("shutdownComplete", { graceful, durationMs });
+        });
+    }
+    setupHandleEventForwarding() {
+        const unsub1 = this._handle.on("stateChange", (data) => {
+            this.events.emit("stateChange", data);
+        });
+        const unsub2 = this._handle.on("exit", (data) => {
+            this.events.emit("exit", data);
+        });
+        const unsub3 = this._handle.on("error", (error) => {
+            this.events.emit("error", error);
+        });
+        this.handleEventSubscriptions.push(unsub1, unsub2, unsub3);
+    }
+    setupHeartbeatPongListener() {
+        if (!this.heartbeatManager)
+            return;
+        // Listen for notifications from worker
+        const channel = this._handle.controlChannel;
+        const unsubNotification = channel.onNotification((notification) => {
+            const notif = notification;
+            // Forward pong to HeartbeatManager for latency tracking
+            if (notif.method === ReservedMethods.HEARTBEAT_PONG) {
+                this.heartbeatManager.handlePong(notif.params);
+            }
+            // Any notification from worker counts as activity for implicit heartbeat.
+            // This prevents marking active workers as dead just because they don't
+            // respond to ping/pong while sending progress updates, metrics, etc.
+            this.heartbeatManager.onActivity();
+        });
+        this.resilienceSubscriptions.push(unsubNotification);
+    }
+    /**
+     * Force kills the process with SIGKILL.
+     */
+    forceKill() {
+        if (this.killFn) {
+            this.killFn("SIGKILL");
+        }
+        else if (this._handle.pid !== null) {
+            try {
+                process.kill(this._handle.pid, "SIGKILL");
+            }
+            catch {
+                // Process may already be dead
+            }
+        }
+    }
+    /**
+     * Cleanup all subscriptions (called by close()).
+     */
+    cleanupAllSubscriptions() {
+        for (const unsub of this.resilienceSubscriptions) {
+            unsub();
+        }
+        this.resilienceSubscriptions.length = 0;
+        for (const unsub of this.handleEventSubscriptions) {
+            unsub();
+        }
+        this.handleEventSubscriptions.length = 0;
+    }
+}
+//# sourceMappingURL=handle.js.map

package/dist/resilience/handle.js.map

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

package/dist/resilience/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resilience module combining heartbeat, reconnect, and shutdown.
+ *
+ * @packageDocumentation
+ * @module Resilience
+ */
+export * from "./types.js";
+export * from "./handle.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/resilience/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resilience/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/resilience/index.js

@@ -0,0 +1,9 @@
+/**
+ * Resilience module combining heartbeat, reconnect, and shutdown.
+ *
+ * @packageDocumentation
+ * @module Resilience
+ */
+export * from "./types.js";
+export * from "./handle.js";
+//# sourceMappingURL=index.js.map

package/dist/resilience/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resilience/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/resilience/types.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Type definitions for the Resilience module.
+ *
+ * @packageDocumentation
+ * @module Resilience
+ */
+import type { Unsubscribe } from "../utils/disposables.js";
+import type { HeartbeatOptions } from "../heartbeat/types.js";
+import type { ReconnectOptions } from "../reconnect/types.js";
+import type { ShutdownOptions } from "../shutdown/types.js";
+import type { ShutdownReason } from "../protocol/reserved-types.js";
+import type { ProcessHandle, ProcessState, ProcessHandleEvents } from "../process/types.js";
+import type { Channel } from "../channel/types.js";
+/**
+ * Options for creating a ResilientProcessHandle.
+ */
+export interface ResilientProcessOptions {
+    /**
+     * Heartbeat configuration.
+     * Set to false to disable heartbeat.
+     * Partial options will be merged with defaults.
+     */
+    heartbeat?: Partial<HeartbeatOptions> | false;
+    /**
+     * Reconnect configuration.
+     * Set to false to disable auto-reconnect.
+     * Partial options will be merged with defaults.
+     */
+    reconnect?: Partial<ReconnectOptions> | false;
+    /**
+     * Shutdown configuration.
+     * Set to false to disable graceful shutdown.
+     * Partial options will be merged with defaults.
+     */
+    shutdown?: Partial<ShutdownOptions> | false;
+}
+/**
+ * Extended events for resilient process handle.
+ */
+export interface ResilientProcessEvents extends ProcessHandleEvents {
+    /**
+     * Fired when heartbeat is missed (worker may be unresponsive).
+     */
+    heartbeatMissed: {
+        missedCount: number;
+    };
+    /**
+     * Fired when heartbeat recovers after misses.
+     */
+    heartbeatRecovered: {
+        missedCount: number;
+    };
+    /**
+     * Fired when worker is determined dead (max misses exceeded).
+     */
+    heartbeatDead: {
+        missedCount: number;
+        lastPongAt: number | null;
+    };
+    /**
+     * Fired when reconnection is attempting.
+     */
+    reconnecting: {
+        attempt: number;
+        delay: number;
+    };
+    /**
+     * Fired when reconnection succeeds.
+     */
+    reconnected: {
+        attempt: number;
+        totalTimeMs: number;
+    };
+    /**
+     * Fired when reconnection fails permanently.
+     */
+    reconnectFailed: {
+        attempts: number;
+        lastError: Error;
+    };
+    /**
+     * Fired when graceful shutdown starts.
+     */
+    shutdownStarted: {
+        reason: ShutdownReason;
+    };
+    /**
+     * Fired when worker acknowledges shutdown.
+     */
+    shutdownAcknowledged: {
+        pendingRequests: number;
+    };
+    /**
+     * Fired when shutdown completes (graceful or forced).
+     */
+    shutdownComplete: {
+        graceful: boolean;
+        durationMs: number;
+    };
+}
+/**
+ * Interface for a resilient process handle with heartbeat, reconnect, and shutdown.
+ */
+export interface IResilientProcessHandle {
+    /**
+     * Unique process identifier.
+     */
+    readonly id: string;
+    /**
+     * Process ID (OS-level).
+     */
+    readonly pid: number | null;
+    /**
+     * Current process state.
+     */
+    readonly state: ProcessState;
+    /**
+     * Whether the process is currently healthy (responding to heartbeats).
+     */
+    readonly isHealthy: boolean;
+    /**
+     * Whether the process is currently reconnecting.
+     */
+    readonly isReconnecting: boolean;
+    /**
+     * Control channel (stdio-based, always available).
+     */
+    readonly controlChannel: Channel;
+    /**
+     * Data channel (pipe-based, optional).
+     */
+    readonly dataChannel: Channel | null;
+    /**
+     * Underlying process handle.
+     */
+    readonly handle: ProcessHandle;
+    /**
+     * Sends a request via control channel.
+     * Requests are queued during reconnection if enabled.
+     *
+     * @param method - Method name
+     * @param params - Optional parameters
+     * @param timeout - Optional timeout override
+     * @returns Promise resolving to response result
+     */
+    request(method: string, params?: unknown, timeout?: number): Promise<unknown>;
+    /**
+     * Sends a notification via control channel.
+     *
+     * @param method - Method name
+     * @param params - Optional parameters
+     */
+    notify(method: string, params?: unknown): Promise<void>;
+    /**
+     * Sends a request via data channel.
+     *
+     * @param method - Method name
+     * @param params - Optional parameters
+     * @param timeout - Optional timeout override
+     * @returns Promise resolving to response result
+     * @throws {Error} if data channel is not available
+     */
+    requestViaData(method: string, params?: unknown, timeout?: number): Promise<unknown>;
+    /**
+     * Initiates graceful shutdown of the process.
+     *
+     * @param reason - Reason for shutdown
+     * @returns Promise that resolves when shutdown is complete
+     */
+    shutdown(reason?: ShutdownReason): Promise<void>;
+    /**
+     * Closes the handle and its channels.
+     * Does not terminate the process - use shutdown() for that.
+     */
+    close(): Promise<void>;
+    /**
+     * Subscribes to handle events.
+     *
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof ResilientProcessEvents>(event: K, handler: (data: ResilientProcessEvents[K]) => void): Unsubscribe;
+    /**
+     * Starts the resilience features (heartbeat monitoring, etc.).
+     */
+    start(): void;
+    /**
+     * Stops the resilience features.
+     */
+    stop(): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/resilience/types.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for the Resilience module.
+ *
+ * @packageDocumentation
+ * @module Resilience
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/resilience/types.js.map

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

package/dist/serialization/json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/serialization/json.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAEpD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAEnD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,kBAAkB,CAAC,CAAC,CAAC;IAClE,SAAgB,IAAI,UAAU;IAC9B,SAAgB,WAAW,sBAAsB;IAEjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyD;IACjF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;gBAExC,OAAO,GAAE,gBAAqB;IAM1C;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM;IAY3B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC;CAW/B"}
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/serialization/json.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAEpD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAEnD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,kBAAkB,CAAC,CAAC,CAAC;IAClE,SAAgB,IAAI,UAAU;IAC9B,SAAgB,WAAW,sBAAsB;IAEjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyD;IACjF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;gBAExC,OAAO,GAAE,gBAAqB;IAM1C;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM;IAgB3B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC;CAW/B"}

package/dist/serialization/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/serialization/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA0BxD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,SAAS;IACJ,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,kBAAkB,CAAC;IAEhC,QAAQ,CAAyD;IACjE,OAAO,CAAyD;IAChE,KAAK,CAA8B;IAEpD,YAAY,UAA4B,EAAE;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,KAAQ;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,QAAoD,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1G,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC9F,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,MAAc;QACxB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAmD,CAAM,CAAC;QACzF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACvF,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/serialization/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA0BxD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,SAAS;IACJ,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,kBAAkB,CAAC;IAEhC,QAAQ,CAAyD;IACjE,OAAO,CAAyD;IAChE,KAAK,CAA8B;IAEpD,YAAY,UAA4B,EAAE;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,KAAQ;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB,KAAK,EACL,IAAI,CAAC,QAAoD,EACzD,IAAI,CAAC,KAAK,CACX,CAAC;YACF,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC9F,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,MAAc;QACxB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAmD,CAAM,CAAC;QACzF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACvF,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/shutdown/constants.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Default options for ShutdownManager.
+ *
+ * @packageDocumentation
+ * @module Shutdown
+ */
+import type { ShutdownOptions } from "./types.js";
+/**
+ * Default shutdown options.
+ */
+export declare const DEFAULT_SHUTDOWN_OPTIONS: Required<ShutdownOptions>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/shutdown/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shutdown/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,eAAe,CAI9D,CAAC"}

package/dist/shutdown/constants.js

@@ -0,0 +1,15 @@
+/**
+ * Default options for ShutdownManager.
+ *
+ * @packageDocumentation
+ * @module Shutdown
+ */
+/**
+ * Default shutdown options.
+ */
+export const DEFAULT_SHUTDOWN_OPTIONS = {
+    enabled: true,
+    gracefulTimeoutMs: 5000,
+    exitWaitMs: 1000,
+};
+//# sourceMappingURL=constants.js.map