@generacy-ai/orchestrator 0.0.0-preview-20260304013206

package/dist/types/sse.d.ts

@@ -0,0 +1,224 @@
+import { z } from 'zod';
+import type { ServerResponse, IncomingMessage } from 'http';
+import type { DecisionQueueItem, DecisionResponse, ConnectedAgent } from './api.js';
+export declare const SSEChannelSchema: z.ZodEnum<["workflows", "queue", "agents"]>;
+export type SSEChannel = z.infer<typeof SSEChannelSchema>;
+export declare const WorkflowEventTypeSchema: z.ZodEnum<["workflow:started", "workflow:completed", "workflow:failed", "workflow:paused", "workflow:resumed", "workflow:cancelled", "step:started", "step:completed", "step:failed", "decision:requested", "decision:resolved"]>;
+export type WorkflowEventType = z.infer<typeof WorkflowEventTypeSchema>;
+export declare const SSEEventTypeSchema: z.ZodEnum<["workflow:started", "workflow:completed", "workflow:failed", "workflow:paused", "workflow:resumed", "workflow:cancelled", "step:started", "step:completed", "step:failed", "decision:requested", "decision:resolved", "queue:updated", "queue:item:added", "queue:item:removed", "agent:connected", "agent:disconnected", "agent:status", "error", "connected"]>;
+export type SSEEventType = z.infer<typeof SSEEventTypeSchema>;
+/**
+ * Base SSE event structure
+ */
+export interface SSEEvent<T = unknown> {
+    /** Event type (maps to SSE 'event:' field) */
+    event: SSEEventType;
+    /** Unique event ID (maps to SSE 'id:' field) */
+    id: string;
+    /** Event payload (serialized to SSE 'data:' field) */
+    data: T;
+    /** Event timestamp */
+    timestamp: string;
+}
+/**
+ * Workflow event data payload
+ */
+export interface WorkflowEventData {
+    workflowId: string;
+    stepId?: string;
+    progress?: number;
+    status?: string;
+    error?: {
+        type: string;
+        message: string;
+    };
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Workflow-specific SSE event
+ */
+export interface WorkflowSSEEvent extends SSEEvent<WorkflowEventData> {
+    event: WorkflowEventType;
+}
+/**
+ * Queue event data payload
+ */
+export interface QueueEventData {
+    action: 'added' | 'removed' | 'updated';
+    item?: DecisionQueueItem;
+    items?: DecisionQueueItem[];
+    queueSize: number;
+    /** Included on 'removed' events when a decision has been responded to */
+    response?: DecisionResponse;
+}
+/**
+ * Queue update SSE event
+ */
+export interface QueueSSEEvent extends SSEEvent<QueueEventData> {
+    event: 'queue:updated' | 'queue:item:added' | 'queue:item:removed';
+}
+/**
+ * Agent event data payload
+ */
+export interface AgentEventData {
+    agentId: string;
+    status: 'connected' | 'disconnected' | 'busy' | 'idle';
+    capabilities?: string[];
+    metadata?: Record<string, unknown>;
+    agent?: ConnectedAgent;
+}
+/**
+ * Agent status SSE event
+ */
+export interface AgentSSEEvent extends SSEEvent<AgentEventData> {
+    event: 'agent:connected' | 'agent:disconnected' | 'agent:status';
+}
+/**
+ * Error event data payload
+ */
+export interface ErrorEventData {
+    type: string;
+    title: string;
+    status: number;
+    detail?: string;
+    traceId?: string;
+}
+/**
+ * Error SSE event
+ */
+export interface ErrorSSEEvent extends SSEEvent<ErrorEventData> {
+    event: 'error';
+}
+/**
+ * Connected event data payload
+ */
+export interface ConnectedEventData {
+    connectionId: string;
+    channels: SSEChannel[];
+    timestamp: string;
+}
+/**
+ * Connection confirmation SSE event
+ */
+export interface ConnectedSSEEvent extends SSEEvent<ConnectedEventData> {
+    event: 'connected';
+}
+/**
+ * Union of all SSE event types
+ */
+export type AnySSEEvent = WorkflowSSEEvent | QueueSSEEvent | AgentSSEEvent | ErrorSSEEvent | ConnectedSSEEvent;
+/**
+ * Subscription filter options
+ */
+export interface SSEFilters {
+    /** Filter to specific workflow */
+    workflowId?: string;
+    /** Filter by tags */
+    tags?: string[];
+}
+/**
+ * SSE client subscription
+ */
+export interface SSESubscription {
+    /** Subscribed channels */
+    channels: Set<SSEChannel>;
+    /** Active filters */
+    filters: SSEFilters;
+    /** Last event ID received (for reconnection) */
+    lastEventId?: string;
+}
+/**
+ * Active SSE connection
+ */
+export interface SSEConnection {
+    /** Unique connection identifier */
+    id: string;
+    /** Node.js response stream */
+    response: ServerResponse;
+    /** Original request (for correlation ID) */
+    request: IncomingMessage;
+    /** Client's user ID (from auth) */
+    userId: string;
+    /** Subscription configuration */
+    subscription: SSESubscription;
+    /** Connection established timestamp */
+    connectedAt: Date;
+    /** Heartbeat timer reference */
+    heartbeatTimer?: NodeJS.Timeout;
+    /** Event sequence counter */
+    sequenceCounter: number;
+}
+/**
+ * SSE connection options
+ */
+export interface SSEConnectionOptions {
+    /** Channels to subscribe to */
+    channels?: SSEChannel[];
+    /** Filter options */
+    filters?: SSEFilters;
+    /** Resume from last event ID */
+    lastEventId?: string;
+}
+/**
+ * SSE stream configuration
+ */
+export interface SSEStreamConfig {
+    /** Heartbeat interval in milliseconds (default: 30000) */
+    heartbeatInterval: number;
+    /** Maximum connections per client (default: 3) */
+    maxConnectionsPerClient: number;
+    /** Buffer size for missed events (default: 100) */
+    eventBufferSize: number;
+    /** Event retention duration in ms (default: 60000) */
+    eventRetentionMs: number;
+}
+/**
+ * Default SSE configuration
+ */
+export declare const DEFAULT_SSE_CONFIG: SSEStreamConfig;
+/**
+ * SSE filters validation schema
+ */
+export declare const SSEFiltersSchema: z.ZodOptional<z.ZodObject<{
+    workflowId: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    tags?: string[] | undefined;
+    workflowId?: string | undefined;
+}, {
+    tags?: string[] | undefined;
+    workflowId?: string | undefined;
+}>>;
+/**
+ * Query parameters for SSE endpoints
+ */
+export declare const SSEQuerySchema: z.ZodObject<{
+    channels: z.ZodOptional<z.ZodString>;
+    workflowId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    workflowId?: string | undefined;
+    channels?: string | undefined;
+}, {
+    workflowId?: string | undefined;
+    channels?: string | undefined;
+}>;
+export type SSEQuery = z.infer<typeof SSEQuerySchema>;
+/**
+ * Parse channels from query string
+ */
+export declare function parseChannels(channelsParam?: string): SSEChannel[];
+/**
+ * Event ID structure
+ * Format: {timestamp}_{connectionId}_{sequence}
+ * Example: 1706123456789_conn_abc123_42
+ */
+export interface EventIdComponents {
+    timestamp: number;
+    connectionId: string;
+    sequence: number;
+}
+/**
+ * Parse event ID components
+ */
+export declare function parseEventId(id: string): EventIdComponents | null;
+//# sourceMappingURL=sse.d.ts.map

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

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

package/dist/types/sse.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+// ============================================================================
+// Channel Types (shared with WebSocket, will be sole source after migration)
+// ============================================================================
+export const SSEChannelSchema = z.enum(['workflows', 'queue', 'agents']);
+// ============================================================================
+// SSE Event Types
+// ============================================================================
+export const WorkflowEventTypeSchema = z.enum([
+    'workflow:started',
+    'workflow:completed',
+    'workflow:failed',
+    'workflow:paused',
+    'workflow:resumed',
+    'workflow:cancelled',
+    'step:started',
+    'step:completed',
+    'step:failed',
+    'decision:requested',
+    'decision:resolved',
+]);
+export const SSEEventTypeSchema = z.enum([
+    // Workflow events
+    'workflow:started',
+    'workflow:completed',
+    'workflow:failed',
+    'workflow:paused',
+    'workflow:resumed',
+    'workflow:cancelled',
+    'step:started',
+    'step:completed',
+    'step:failed',
+    'decision:requested',
+    'decision:resolved',
+    // Queue events
+    'queue:updated',
+    'queue:item:added',
+    'queue:item:removed',
+    // Agent events
+    'agent:connected',
+    'agent:disconnected',
+    'agent:status',
+    // System events
+    'error',
+    'connected',
+]);
+/**
+ * Default SSE configuration
+ */
+export const DEFAULT_SSE_CONFIG = {
+    heartbeatInterval: 30000,
+    maxConnectionsPerClient: 3,
+    eventBufferSize: 100,
+    eventRetentionMs: 60000,
+};
+// ============================================================================
+// Query Parameter Validation
+// ============================================================================
+/**
+ * SSE filters validation schema
+ */
+export const SSEFiltersSchema = z
+    .object({
+    workflowId: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+})
+    .optional();
+/**
+ * Query parameters for SSE endpoints
+ */
+export const SSEQuerySchema = z.object({
+    channels: z.string().optional(), // comma-separated
+    workflowId: z.string().optional(),
+});
+/**
+ * Parse channels from query string
+ */
+export function parseChannels(channelsParam) {
+    if (!channelsParam) {
+        return ['workflows', 'queue', 'agents']; // default: all
+    }
+    const channels = channelsParam.split(',').map((c) => c.trim());
+    return channels.filter((c) => SSEChannelSchema.safeParse(c).success);
+}
+/**
+ * Parse event ID components
+ */
+export function parseEventId(id) {
+    const parts = id.split('_');
+    if (parts.length < 3)
+        return null;
+    const firstPart = parts[0];
+    const lastPart = parts[parts.length - 1];
+    if (!firstPart || !lastPart)
+        return null;
+    const timestamp = parseInt(firstPart, 10);
+    const connectionId = parts.slice(1, -1).join('_');
+    const sequence = parseInt(lastPart, 10);
+    if (isNaN(timestamp) || isNaN(sequence))
+        return null;
+    return { timestamp, connectionId, sequence };
+}
+//# sourceMappingURL=sse.js.map

package/dist/types/sse.js.map

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

package/dist/types/webhook.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Minimal GitHub webhook response type.
+ * Only includes fields needed for matching and reactivation.
+ */
+export interface GitHubWebhook {
+    /** Webhook ID */
+    id: number;
+    /** Whether webhook is active */
+    active: boolean;
+    /** Webhook configuration */
+    config: {
+        /** Target URL */
+        url: string;
+    };
+    /** Event types webhook subscribes to */
+    events: string[];
+}
+/**
+ * Summary of webhook setup operation across multiple repositories
+ */
+export interface WebhookSetupSummary {
+    /** Total repositories checked */
+    total: number;
+    /** Webhooks created */
+    created: number;
+    /** Webhooks skipped (already exist) */
+    skipped: number;
+    /** Webhooks reactivated */
+    reactivated: number;
+    /** Repositories that failed */
+    failed: number;
+    /** Per-repository results */
+    results: WebhookSetupResult[];
+}
+/**
+ * Result of webhook setup for a single repository
+ */
+export interface WebhookSetupResult {
+    /** Repository owner */
+    owner: string;
+    /** Repository name */
+    repo: string;
+    /** Action taken */
+    action: 'created' | 'skipped' | 'reactivated' | 'failed';
+    /** Webhook ID (if applicable) */
+    webhookId?: number;
+    /** Error message (if action === 'failed') */
+    error?: string;
+}
+/**
+ * Repository configuration for webhook setup
+ */
+export interface RepositoryConfig {
+    /** Repository owner */
+    owner: string;
+    /** Repository name */
+    repo: string;
+}
+//# sourceMappingURL=webhook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/types/webhook.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE;QACN,iBAAiB;QACjB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;IACzD,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types/webhook.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=webhook.js.map

package/dist/types/webhook.js.map

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

package/dist/utils/correlation.d.ts

@@ -0,0 +1,30 @@
+import type { FastifyRequest, FastifyReply } from 'fastify';
+/**
+ * Header name for request correlation ID
+ */
+export declare const CORRELATION_ID_HEADER = "x-request-id";
+/**
+ * Augment FastifyRequest to include correlation ID
+ */
+declare module 'fastify' {
+    interface FastifyRequest {
+        correlationId: string;
+    }
+}
+/**
+ * Generate a new correlation ID
+ */
+export declare function generateCorrelationId(): string;
+/**
+ * Extract correlation ID from request headers or generate a new one
+ */
+export declare function getCorrelationId(request: FastifyRequest): string;
+/**
+ * Fastify hook to add correlation ID to requests (async for Fastify v5)
+ */
+export declare function correlationIdHook(request: FastifyRequest, _reply: FastifyReply): Promise<void>;
+/**
+ * Fastify hook to add correlation ID to response headers (async for Fastify v5)
+ */
+export declare function correlationIdResponseHook(request: FastifyRequest, reply: FastifyReply): Promise<void>;
+//# sourceMappingURL=correlation.d.ts.map

package/dist/utils/correlation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../../src/utils/correlation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD;;GAEG;AACH,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB;CACF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAMhE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/utils/correlation.js

@@ -0,0 +1,34 @@
+import { randomUUID } from 'node:crypto';
+/**
+ * Header name for request correlation ID
+ */
+export const CORRELATION_ID_HEADER = 'x-request-id';
+/**
+ * Generate a new correlation ID
+ */
+export function generateCorrelationId() {
+    return randomUUID();
+}
+/**
+ * Extract correlation ID from request headers or generate a new one
+ */
+export function getCorrelationId(request) {
+    const headerValue = request.headers[CORRELATION_ID_HEADER];
+    if (typeof headerValue === 'string' && headerValue.length > 0) {
+        return headerValue;
+    }
+    return generateCorrelationId();
+}
+/**
+ * Fastify hook to add correlation ID to requests (async for Fastify v5)
+ */
+export async function correlationIdHook(request, _reply) {
+    request.correlationId = getCorrelationId(request);
+}
+/**
+ * Fastify hook to add correlation ID to response headers (async for Fastify v5)
+ */
+export async function correlationIdResponseHook(request, reply) {
+    reply.header(CORRELATION_ID_HEADER, request.correlationId);
+}
+//# sourceMappingURL=correlation.js.map

package/dist/utils/correlation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.js","sourceRoot":"","sources":["../../src/utils/correlation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAWpD;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC3D,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,qBAAqB,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAuB,EACvB,MAAoB;IAEpB,OAAO,CAAC,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAuB,EACvB,KAAmB;IAEnB,KAAK,CAAC,MAAM,CAAC,qBAAqB,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;AAC7D,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { CORRELATION_ID_HEADER, generateCorrelationId, getCorrelationId, correlationIdHook, correlationIdResponseHook, } from './correlation.js';
+export { setupGracefulShutdown, isShuttingDown, resetShutdownState, type ShutdownOptions, } from './shutdown.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export { CORRELATION_ID_HEADER, generateCorrelationId, getCorrelationId, correlationIdHook, correlationIdResponseHook, } from './correlation.js';
+export { setupGracefulShutdown, isShuttingDown, resetShutdownState, } from './shutdown.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GAEnB,MAAM,eAAe,CAAC"}

package/dist/utils/shutdown.d.ts

@@ -0,0 +1,28 @@
+import type { FastifyInstance } from 'fastify';
+/**
+ * Shutdown options
+ */
+export interface ShutdownOptions {
+    /** Timeout for graceful shutdown in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Logger for shutdown messages */
+    logger?: {
+        info: (msg: string) => void;
+        error: (msg: string, error?: Error) => void;
+    };
+    /** Additional cleanup functions to run */
+    cleanup?: Array<() => Promise<void>>;
+}
+/**
+ * Setup graceful shutdown handlers for SIGTERM and SIGINT
+ */
+export declare function setupGracefulShutdown(server: FastifyInstance, options?: ShutdownOptions): () => Promise<void>;
+/**
+ * Check if shutdown is in progress
+ */
+export declare function isShuttingDown(): boolean;
+/**
+ * Reset shutdown state (for testing)
+ */
+export declare function resetShutdownState(): void;
+//# sourceMappingURL=shutdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/utils/shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAe/C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;KAC7C,CAAC;IACF,0CAA0C;IAC1C,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CACtC;AAyCD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,eAAoB,GAC5B,MAAM,OAAO,CAAC,IAAI,CAAC,CAsCrB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/utils/shutdown.js

@@ -0,0 +1,86 @@
+const state = {
+    isShuttingDown: false,
+    shutdownPromise: null,
+};
+/**
+ * Perform graceful shutdown
+ */
+async function performShutdown(server, options) {
+    const { timeout = 30000, logger, cleanup = [] } = options;
+    logger?.info('Starting graceful shutdown...');
+    // Create timeout promise
+    const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => {
+            reject(new Error(`Shutdown timed out after ${timeout}ms`));
+        }, timeout);
+    });
+    try {
+        // Close server (stops accepting new connections)
+        await Promise.race([server.close(), timeoutPromise]);
+        logger?.info('Server closed, stopping new connections');
+        // Run cleanup functions
+        for (const cleanupFn of cleanup) {
+            try {
+                await Promise.race([cleanupFn(), timeoutPromise]);
+            }
+            catch (error) {
+                logger?.error('Cleanup function failed', error);
+            }
+        }
+        logger?.info('Graceful shutdown complete');
+    }
+    catch (error) {
+        logger?.error('Shutdown failed', error);
+        throw error;
+    }
+}
+/**
+ * Setup graceful shutdown handlers for SIGTERM and SIGINT
+ */
+export function setupGracefulShutdown(server, options = {}) {
+    const { logger } = options;
+    const handleSignal = (signal) => {
+        return () => {
+            if (state.isShuttingDown) {
+                logger?.info(`Received ${signal} but already shutting down`);
+                return;
+            }
+            logger?.info(`Received ${signal}, initiating graceful shutdown`);
+            state.isShuttingDown = true;
+            state.shutdownPromise = performShutdown(server, options)
+                .then(() => {
+                process.exit(0);
+            })
+                .catch((error) => {
+                logger?.error('Shutdown failed, forcing exit', error);
+                process.exit(1);
+            });
+        };
+    };
+    // Register signal handlers
+    process.on('SIGTERM', handleSignal('SIGTERM'));
+    process.on('SIGINT', handleSignal('SIGINT'));
+    // Return a function to manually trigger shutdown (for testing)
+    return async () => {
+        if (state.isShuttingDown && state.shutdownPromise) {
+            return state.shutdownPromise;
+        }
+        state.isShuttingDown = true;
+        state.shutdownPromise = performShutdown(server, options);
+        return state.shutdownPromise;
+    };
+}
+/**
+ * Check if shutdown is in progress
+ */
+export function isShuttingDown() {
+    return state.isShuttingDown;
+}
+/**
+ * Reset shutdown state (for testing)
+ */
+export function resetShutdownState() {
+    state.isShuttingDown = false;
+    state.shutdownPromise = null;
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/utils/shutdown.js.map

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