@trigger.dev/core 0.0.0-v3-prerelease-20250108141813 → 0.0.0-v4-prerelease-20250916125920

package/dist/commonjs/v3/serverOnly/httpServer.js

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpServer = void 0;
+const node_http_1 = require("node:http");
+const zod_1 = require("zod");
+const structuredLogger_js_1 = require("../utils/structuredLogger.js");
+const http_js_1 = require("../apps/http.js");
+const prom_client_1 = require("prom-client");
+const utils_js_1 = require("../../utils.js");
+const logger = new structuredLogger_js_1.SimpleStructuredLogger("http-server");
+const HttpMethod = zod_1.z.enum([
+    "GET",
+    "POST",
+    "PUT",
+    "DELETE",
+    "PATCH",
+    "OPTIONS",
+    "HEAD",
+    "CONNECT",
+    "TRACE",
+]);
+class HttpServer {
+    static httpRequestDuration;
+    static httpRequestTotal;
+    metricsRegister;
+    port;
+    host;
+    routes = {};
+    server;
+    constructor(options) {
+        this.port = options.port;
+        this.host = options.host;
+        this.metricsRegister = options.metrics?.register;
+        const collectMetrics = options.metrics?.collect ?? true;
+        const exposeMetrics = options.metrics?.expose ?? false;
+        // Initialize metrics only if registry is provided and not already initialized
+        if (this.metricsRegister && collectMetrics) {
+            if (!HttpServer.httpRequestDuration) {
+                HttpServer.httpRequestDuration = new prom_client_1.Histogram({
+                    name: "http_request_duration_seconds",
+                    help: "Duration of HTTP requests in seconds",
+                    labelNames: ["method", "route", "status", "port", "host"],
+                    registers: [this.metricsRegister],
+                });
+            }
+            if (!HttpServer.httpRequestTotal) {
+                HttpServer.httpRequestTotal = new prom_client_1.Counter({
+                    name: "http_requests_total",
+                    help: "Total number of HTTP requests",
+                    labelNames: ["method", "route", "status", "port", "host"],
+                    registers: [this.metricsRegister],
+                });
+            }
+        }
+        if (exposeMetrics) {
+            // Register metrics route
+            this.route("/metrics", "GET", {
+                handler: async ({ reply }) => {
+                    if (!this.metricsRegister) {
+                        return reply.text("Metrics registry not found", 500);
+                    }
+                    return reply.text(await this.metricsRegister.metrics(), 200, this.metricsRegister.contentType);
+                },
+            });
+        }
+        this.server = (0, node_http_1.createServer)(async (req, res) => {
+            const reply = new http_js_1.HttpReply(res);
+            const startTime = process.hrtime();
+            try {
+                const { url, method } = req;
+                logger.debug(`${method} ${url?.split("?")[0]}`, { url });
+                if (!url) {
+                    logger.error("Request URL is empty", { method });
+                    return reply.text("Request URL is empty", 400);
+                }
+                if (!method) {
+                    logger.error("Request method is empty", { url });
+                    return reply.text("Request method is empty", 400);
+                }
+                const httpMethod = HttpMethod.safeParse(method);
+                if (!httpMethod.success) {
+                    logger.error("HTTP method not implemented", { url, method });
+                    return reply.text(`HTTP method ${method} not implemented`, 400);
+                }
+                const route = this.findRoute(url);
+                if (!route) {
+                    logger.error("No route match", { url, method });
+                    return reply.empty(404);
+                }
+                const routeDefinition = this.routes[route]?.[httpMethod.data];
+                if (!routeDefinition) {
+                    logger.error("Invalid method", { url, method, parsedMethod: httpMethod.data });
+                    return reply.empty(405);
+                }
+                const { handler, paramsSchema, querySchema, bodySchema, keepConnectionAlive } = routeDefinition;
+                const params = this.parseRouteParams(route, url);
+                const parsedParams = this.optionalSchema(paramsSchema, params);
+                if (!parsedParams.success) {
+                    logger.error("Failed to parse params schema", { url, method, params });
+                    return reply.text("Invalid params", 400);
+                }
+                const queryParams = this.parseQueryParams(url);
+                const parsedQueryParams = this.optionalSchema(querySchema, queryParams);
+                if (!parsedQueryParams.success) {
+                    logger.error("Failed to parse query params schema", { url, method, queryParams });
+                    return reply.text("Invalid query params", 400);
+                }
+                const body = await (0, http_js_1.getJsonBody)(req);
+                const parsedBody = this.optionalSchema(bodySchema, body);
+                if (!parsedBody.success) {
+                    logger.error("Failed to parse body schema", {
+                        url,
+                        method,
+                        body,
+                        error: parsedBody.error,
+                    });
+                    return reply.json({ ok: false, error: "Invalid body" }, false, 400);
+                }
+                const [error] = await (0, utils_js_1.tryCatch)(handler({
+                    reply,
+                    req,
+                    res,
+                    params: parsedParams.data,
+                    queryParams: parsedQueryParams.data,
+                    body: parsedBody.data,
+                }));
+                if (error) {
+                    logger.error("Route handler error", { error: this.formatError(error) });
+                    return reply.empty(500);
+                }
+                if (keepConnectionAlive) {
+                    // Return early to keep the connection alive
+                    return;
+                }
+            }
+            catch (error) {
+                logger.error("Failed to handle request", { error: this.formatError(error) });
+                return reply.empty(500);
+            }
+            finally {
+                this.collectMetrics(req, res, startTime);
+            }
+            return reply.empty(501);
+        });
+        this.server.on("clientError", (_, socket) => {
+            socket.end("HTTP/1.1 400 Bad Request\r\n\r\n");
+        });
+    }
+    route(path, method, definition) {
+        this.routes[path] = {
+            ...this.routes[path],
+            [method]: definition,
+        };
+        return this;
+    }
+    start() {
+        return new Promise((resolve) => {
+            this.server.listen(this.port, this.host, () => {
+                logger.log("HTTP server listening on port", { port: this.port });
+                resolve();
+            });
+        });
+    }
+    stop() {
+        return new Promise((resolve) => {
+            this.server.close(() => {
+                logger.log("HTTP server stopped");
+                resolve();
+            });
+        });
+    }
+    collectMetrics(req, res, startTime) {
+        if (!this.metricsRegister || !HttpServer.httpRequestDuration || !HttpServer.httpRequestTotal) {
+            return;
+        }
+        const [seconds, nanoseconds] = process.hrtime(startTime);
+        const duration = seconds + nanoseconds / 1e9;
+        const route = this.findRoute(req.url ?? "") ?? "unknown";
+        const method = req.method ?? "unknown";
+        const status = res.statusCode.toString();
+        HttpServer.httpRequestDuration.observe({ method, route, status, port: this.port, host: this.host }, duration);
+        HttpServer.httpRequestTotal.inc({ method, route, status, port: this.port, host: this.host });
+    }
+    optionalSchema(schema, data) {
+        if (!schema) {
+            return { success: true, data };
+        }
+        const parsed = schema.safeParse(data);
+        if (!parsed.success) {
+            return { success: false, error: parsed.error.message };
+        }
+        return { success: true, data: parsed.data };
+    }
+    parseQueryParams(url) {
+        const { searchParams } = new URL(url, "http://localhost");
+        return Object.fromEntries(searchParams.entries());
+    }
+    parseRouteParams(route, url) {
+        const params = {};
+        const routeParts = route.split("/");
+        const urlWithoutQueryParams = url.split("?")[0];
+        if (!urlWithoutQueryParams) {
+            return params;
+        }
+        const urlParts = urlWithoutQueryParams.split("/");
+        routeParts.forEach((part, index) => {
+            if (part.startsWith(":")) {
+                const paramName = part.slice(1);
+                const urlPart = urlParts[index];
+                if (!urlPart) {
+                    return;
+                }
+                params[paramName] = urlPart;
+            }
+        });
+        return params;
+    }
+    findRoute(url) {
+        for (const route in this.routes) {
+            const routeParts = route.split("/");
+            const urlWithoutQueryParams = url.split("?")[0];
+            if (!urlWithoutQueryParams) {
+                continue;
+            }
+            const urlParts = urlWithoutQueryParams.split("/");
+            if (routeParts.length !== urlParts.length) {
+                continue;
+            }
+            const matches = routeParts.every((part, i) => {
+                if (part.startsWith(":")) {
+                    // Always match route params
+                    return true;
+                }
+                return part === urlParts[i];
+            });
+            if (matches) {
+                return route;
+            }
+        }
+        return null;
+    }
+    formatError(error) {
+        if (error instanceof Error) {
+            return {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            };
+        }
+        return String(error);
+    }
+}
+exports.HttpServer = HttpServer;
+//# sourceMappingURL=httpServer.js.map

package/dist/commonjs/v3/serverOnly/httpServer.js.map

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

package/dist/commonjs/v3/serverOnly/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./checkpointClient.js";
+export * from "./checkpointTest.js";
+export * from "./httpServer.js";
+export * from "./singleton.js";
+export * from "./shutdownManager.js";
+export * from "./k8s.js";
+export * from "./jumpHash.js";
+export * from "../apiClient/version.js";
+export * from "./placementTags.js";

package/dist/commonjs/v3/serverOnly/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./checkpointClient.js"), exports);
+__exportStar(require("./checkpointTest.js"), exports);
+__exportStar(require("./httpServer.js"), exports);
+__exportStar(require("./singleton.js"), exports);
+__exportStar(require("./shutdownManager.js"), exports);
+__exportStar(require("./k8s.js"), exports);
+__exportStar(require("./jumpHash.js"), exports);
+__exportStar(require("../apiClient/version.js"), exports);
+__exportStar(require("./placementTags.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/commonjs/v3/serverOnly/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,sDAAoC;AACpC,kDAAgC;AAChC,iDAA+B;AAC/B,uDAAqC;AACrC,2CAAyB;AACzB,gDAA8B;AAC9B,0DAAwC;AACxC,qDAAmC"}

package/dist/commonjs/v3/serverOnly/jumpHash.d.ts

@@ -0,0 +1 @@
+export declare function jumpHash(key: string, buckets: number): number;

package/dist/commonjs/v3/serverOnly/jumpHash.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jumpHash = jumpHash;
+const node_crypto_1 = require("node:crypto");
+/**
+ * Returns the binary hash of a binary value. Hash function and output length are configurable.
+ */
+function hash(data, outputLength = 32, type = "sha256") {
+    const hasher = (0, node_crypto_1.createHash)(type);
+    hasher.update(data);
+    let hash = new Uint8Array(hasher.digest());
+    hash = hash.subarray(0, outputLength);
+    return hash;
+}
+function jumpHash(key, buckets) {
+    return jumpConsistentHash(hash(Buffer.from(key)), buckets);
+}
+/**
+ * Based on Node.js's Buffer implementation: https://github.com/nodejs/node/blob/ed8fc7e11d688cbcdf33d0d149830064758bdcd2/lib/internal/buffer.js#L98
+ * @param bytes
+ */
+function bytesToBigInt(bytes) {
+    const hi = bytes[0] * 2 ** 24 + bytes[1] * 2 ** 16 + bytes[2] * 2 ** 8 + bytes[3];
+    const lo = bytes[4] * 2 ** 24 + bytes[5] * 2 ** 16 + bytes[6] * 2 ** 8 + bytes[7];
+    // tslint:disable-next-line:no-bitwise
+    return (BigInt(hi) << 32n) + BigInt(lo);
+}
+/**
+ * @param {Uint8Array} key 8 bytes (represents uint64 number)
+ * @param {number} numBuckets Up to 32-bit number
+ *
+ * @return {number} Bucket from `[0, numBuckets)` range
+ */
+function jumpConsistentHash(key, numBuckets) {
+    let keyBigInt = bytesToBigInt(key);
+    let b = -1n;
+    let j = 0n;
+    while (j < numBuckets) {
+        b = j;
+        // We fit the number after multiplication within 64-bit range, just like in C++ implementation from paper
+        keyBigInt = ((keyBigInt * 2862933555777941757n) % 2n ** 64n) + 1n;
+        // Here we need to divide numbers as double (like in C++ implementation from paper), hence converting back to numbers for that
+        // tslint:disable-next-line:no-bitwise
+        j = BigInt(Math.floor(((Number(b) + 1) * Number(1n << 31n)) / Number((keyBigInt >> 33n) + 1n)));
+    }
+    return Number(b);
+}
+//# sourceMappingURL=jumpHash.js.map

package/dist/commonjs/v3/serverOnly/jumpHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jumpHash.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/jumpHash.ts"],"names":[],"mappings":";;AAaA,4BAEC;AAfD,6CAAyC;AAEzC;;GAEG;AACH,SAAS,IAAI,CAAC,IAAgB,EAAE,YAAY,GAAG,EAAE,EAAE,IAAI,GAAG,QAAQ;IAChE,MAAM,MAAM,GAAG,IAAA,wBAAU,EAAC,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,IAAI,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,QAAQ,CAAC,GAAW,EAAE,OAAe;IACnD,OAAO,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAiB;IACtC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACtF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IAEtF,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,GAAe,EAAE,UAAkB;IAC7D,IAAI,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACZ,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,OAAO,CAAC,GAAG,UAAU,EAAE,CAAC;QACtB,CAAC,GAAG,CAAC,CAAC;QACN,yGAAyG;QACzG,SAAS,GAAG,CAAC,CAAC,SAAS,GAAG,oBAAoB,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QAClE,8HAA8H;QAC9H,sCAAsC;QACtC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/commonjs/v3/serverOnly/k8s.d.ts

@@ -0,0 +1 @@
+export declare function isKubernetesEnvironment(override?: boolean): boolean;

package/dist/commonjs/v3/serverOnly/k8s.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isKubernetesEnvironment = isKubernetesEnvironment;
+const std_env_1 = require("std-env");
+function isKubernetesEnvironment(override) {
+    if (override !== undefined) {
+        return override;
+    }
+    // Then check for common Kubernetes environment variables
+    const k8sIndicators = [
+        std_env_1.env.KUBERNETES_PORT,
+        std_env_1.env.KUBERNETES_SERVICE_HOST,
+        std_env_1.env.KUBERNETES_SERVICE_PORT,
+    ];
+    console.debug("k8sIndicators", { k8sIndicators });
+    return k8sIndicators.some(Boolean);
+}
+//# sourceMappingURL=k8s.js.map

package/dist/commonjs/v3/serverOnly/k8s.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"k8s.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/k8s.ts"],"names":[],"mappings":";;AAEA,0DAeC;AAjBD,qCAA8B;AAE9B,SAAgB,uBAAuB,CAAC,QAAkB;IACxD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,yDAAyD;IACzD,MAAM,aAAa,GAAG;QACpB,aAAG,CAAC,eAAe;QACnB,aAAG,CAAC,uBAAuB;QAC3B,aAAG,CAAC,uBAAuB;KAC5B,CAAC;IAEF,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAElD,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/commonjs/v3/serverOnly/placementTags.d.ts

@@ -0,0 +1,20 @@
+import { type PlacementTag } from "../schemas/index.js";
+export interface PlacementConfig {
+    enabled: boolean;
+    prefix: string;
+}
+export declare class PlacementTagProcessor {
+    private readonly config;
+    private readonly logger;
+    constructor(config: PlacementConfig);
+    /**
+     * Converts placement tags to Kubernetes nodeSelector labels
+     */
+    convertToNodeSelector(placementTags?: PlacementTag[], existingNodeSelector?: Record<string, string>): Record<string, string>;
+    private printTagWarnings;
+}
+/**
+ * Helper function to create a placement tag. In the future this will be able to support multiple values and operators.
+ * For now it's just a single value.
+ */
+export declare function placementTag(key: string, value: string): PlacementTag;

package/dist/commonjs/v3/serverOnly/placementTags.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlacementTagProcessor = void 0;
+exports.placementTag = placementTag;
+const structuredLogger_js_1 = require("../utils/structuredLogger.js");
+class PlacementTagProcessor {
+    config;
+    logger = new structuredLogger_js_1.SimpleStructuredLogger("placement-tag-processor");
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Converts placement tags to Kubernetes nodeSelector labels
+     */
+    convertToNodeSelector(placementTags, existingNodeSelector) {
+        if (!this.config.enabled || !placementTags || placementTags.length === 0) {
+            return existingNodeSelector ?? {};
+        }
+        const nodeSelector = { ...existingNodeSelector };
+        // Convert placement tags to nodeSelector labels
+        for (const tag of placementTags) {
+            const labelKey = `${this.config.prefix}/${tag.key}`;
+            // Print warnings (if any)
+            this.printTagWarnings(tag);
+            // For now we only support single values via nodeSelector
+            nodeSelector[labelKey] = tag.values?.[0] ?? "";
+        }
+        return nodeSelector;
+    }
+    printTagWarnings(tag) {
+        if (!tag.values || tag.values.length === 0) {
+            // No values provided
+            this.logger.warn("Placement tag has no values, using empty string", tag);
+        }
+        else if (tag.values.length > 1) {
+            // Multiple values provided
+            this.logger.warn("Placement tag has multiple values, only using first one", tag);
+        }
+    }
+}
+exports.PlacementTagProcessor = PlacementTagProcessor;
+/**
+ * Helper function to create a placement tag. In the future this will be able to support multiple values and operators.
+ * For now it's just a single value.
+ */
+function placementTag(key, value) {
+    return { key, values: [value] };
+}
+//# sourceMappingURL=placementTags.js.map

package/dist/commonjs/v3/serverOnly/placementTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placementTags.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/placementTags.ts"],"names":[],"mappings":";;;AAuDA,oCAEC;AAxDD,sEAAsE;AAOtE,MAAa,qBAAqB;IAGH;IAFZ,MAAM,GAAG,IAAI,4CAAsB,CAAC,yBAAyB,CAAC,CAAC;IAEhF,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD;;OAEG;IACH,qBAAqB,CACnB,aAA8B,EAC9B,oBAA6C;QAE7C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzE,OAAO,oBAAoB,IAAI,EAAE,CAAC;QACpC,CAAC;QAED,MAAM,YAAY,GAA2B,EAAE,GAAG,oBAAoB,EAAE,CAAC;QAEzE,gDAAgD;QAChD,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YAEpD,0BAA0B;YAC1B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAE3B,yDAAyD;YACzD,YAAY,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,gBAAgB,CAAC,GAAiB;QACxC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,qBAAqB;YACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,2BAA2B;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yDAAyD,EAAE,GAAG,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;CACF;AAzCD,sDAyCC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,GAAW,EAAE,KAAa;IACrD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/dist/commonjs/v3/serverOnly/shutdownManager.d.ts

@@ -0,0 +1,20 @@
+type ShutdownHandler = NodeJS.SignalsListener;
+type ShutdownSignal = Extract<NodeJS.Signals, "SIGTERM" | "SIGINT">;
+export declare class ShutdownManager {
+    private disableForTesting;
+    private isShuttingDown;
+    private signalNumbers;
+    private logger;
+    private handlers;
+    constructor(disableForTesting?: boolean);
+    register(name: string, handler: ShutdownHandler, signals?: ShutdownSignal[]): void;
+    unregister(name: string): void;
+    shutdown(signal: ShutdownSignal): Promise<void>;
+    private isEnabled;
+    _getHandlersForTesting(): ReadonlyMap<string, {
+        handler: ShutdownHandler;
+        signals: ShutdownSignal[];
+    }>;
+}
+export declare const shutdownManager: ShutdownManager;
+export {};

package/dist/commonjs/v3/serverOnly/shutdownManager.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shutdownManager = exports.ShutdownManager = void 0;
+const std_env_1 = require("std-env");
+const structuredLogger_js_1 = require("../utils/structuredLogger.js");
+const singleton_js_1 = require("./singleton.js");
+class ShutdownManager {
+    disableForTesting;
+    isShuttingDown = false;
+    signalNumbers = {
+        SIGINT: 2,
+        SIGTERM: 15,
+    };
+    logger = new structuredLogger_js_1.SimpleStructuredLogger("shutdownManager");
+    handlers = new Map();
+    constructor(disableForTesting = true) {
+        this.disableForTesting = disableForTesting;
+        if (disableForTesting)
+            return;
+        process.on("SIGTERM", () => this.shutdown("SIGTERM"));
+        process.on("SIGINT", () => this.shutdown("SIGINT"));
+    }
+    register(name, handler, signals = ["SIGTERM", "SIGINT"]) {
+        if (!this.isEnabled())
+            return;
+        if (this.handlers.has(name)) {
+            throw new Error(`Shutdown handler "${name}" already registered`);
+        }
+        this.handlers.set(name, { handler, signals });
+    }
+    unregister(name) {
+        if (!this.isEnabled())
+            return;
+        if (!this.handlers.has(name)) {
+            throw new Error(`Shutdown handler "${name}" not registered`);
+        }
+        this.handlers.delete(name);
+    }
+    async shutdown(signal) {
+        if (!this.isEnabled())
+            return;
+        if (this.isShuttingDown)
+            return;
+        this.isShuttingDown = true;
+        this.logger.info(`Received ${signal}. Starting graceful shutdown...`);
+        // Get handlers that are registered for this signal
+        const handlersToRun = Array.from(this.handlers.entries()).filter(([_, { signals }]) => signals.includes(signal));
+        try {
+            const results = await Promise.allSettled(handlersToRun.map(async ([name, { handler }]) => {
+                try {
+                    this.logger.info(`Running shutdown handler: ${name}`);
+                    await handler(signal);
+                    this.logger.info(`Shutdown handler completed: ${name}`);
+                }
+                catch (error) {
+                    this.logger.error(`Shutdown handler failed: ${name}`, { error });
+                    throw error;
+                }
+            }));
+            // Log any failures
+            results.forEach((result, index) => {
+                if (result.status === "rejected") {
+                    const handlerEntry = handlersToRun[index];
+                    if (handlerEntry) {
+                        const [name] = handlerEntry;
+                        this.logger.error(`Shutdown handler "${name}" failed:`, { reason: result.reason });
+                    }
+                }
+            });
+        }
+        catch (error) {
+            this.logger.error("Error during shutdown:", { error });
+        }
+        finally {
+            // Exit with the correct signal number
+            process.exit(128 + this.signalNumbers[signal]);
+        }
+    }
+    isEnabled() {
+        if (!this.disableForTesting) {
+            return true;
+        }
+        return !std_env_1.isTest;
+    }
+    // Only for testing
+    _getHandlersForTesting() {
+        return new Map(this.handlers);
+    }
+}
+exports.ShutdownManager = ShutdownManager;
+exports.shutdownManager = (0, singleton_js_1.singleton)("shutdownManager", () => new ShutdownManager());
+//# sourceMappingURL=shutdownManager.js.map

package/dist/commonjs/v3/serverOnly/shutdownManager.js.map

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

package/dist/commonjs/v3/serverOnly/shutdownManager.test.d.ts

@@ -0,0 +1 @@
+export {};