@trigger.dev/core 0.0.0-python-preview-20250226140121 → 0.0.0-rc-4-8-0-20261021151928

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

@@ -0,0 +1,255 @@
+import { createServer } from "node:http";
+import { z } from "zod/v4";
+import { SimpleStructuredLogger } from "../utils/structuredLogger.js";
+import { HttpReply, getJsonBody } from "../apps/http.js";
+import { Histogram, Counter } from "prom-client";
+import { tryCatch } from "../../utils.js";
+const logger = new SimpleStructuredLogger("http-server");
+const HttpMethod = z.enum([
+    "GET",
+    "POST",
+    "PUT",
+    "DELETE",
+    "PATCH",
+    "OPTIONS",
+    "HEAD",
+    "CONNECT",
+    "TRACE",
+]);
+export 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 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 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 = createServer(async (req, res) => {
+            const reply = new 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, skipBodyParsing, } = 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 = skipBodyParsing ? undefined : await 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 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) {
+            if (!Object.hasOwn(this.routes, route))
+                continue;
+            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);
+    }
+}
+//# sourceMappingURL=httpServer.js.map

package/dist/esm/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/esm/v3/serverOnly/idempotencyKeys.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Safely parses idempotencyKeyOptions from a database record and extracts the user-provided key.
+ * Returns the user-provided key if valid options exist, otherwise falls back to the hash.
+ *
+ * @param run - Object containing idempotencyKey (the hash) and idempotencyKeyOptions (JSON from DB)
+ * @returns The user-provided key, the hash as fallback, or null if neither exists
+ */
+export declare function getUserProvidedIdempotencyKey(run: {
+    idempotencyKey: string | null | undefined;
+    idempotencyKeyOptions: unknown;
+}): string | undefined;
+/**
+ * Safely parses idempotencyKeyOptions and extracts the scope.
+ *
+ * @param run - Object containing idempotencyKeyOptions (JSON from DB)
+ * @returns The scope if valid options exist, otherwise undefined
+ */
+export declare function extractIdempotencyKeyScope(run: {
+    idempotencyKeyOptions: unknown;
+}): "run" | "attempt" | "global" | undefined;
+export declare function unsafeExtractIdempotencyKeyScope(run: {
+    idempotencyKeyOptions: unknown;
+}): "run" | "attempt" | "global" | undefined;
+/**
+ * Extracts just the user-provided key from idempotencyKeyOptions, without falling back to the hash.
+ * Useful for ClickHouse replication where we want to store only the explicit user key.
+ *
+ * @param run - Object containing idempotencyKeyOptions (JSON from DB)
+ * @returns The user-provided key if valid options exist, otherwise undefined
+ */
+export declare function extractIdempotencyKeyUser(run: {
+    idempotencyKeyOptions: unknown;
+}): string | undefined;
+export declare function unsafeExtractIdempotencyKeyUser(run: {
+    idempotencyKeyOptions: unknown;
+}): string | undefined;

package/dist/esm/v3/serverOnly/idempotencyKeys.js

@@ -0,0 +1,51 @@
+import { IdempotencyKeyOptionsSchema } from "../schemas/api.js";
+/**
+ * Safely parses idempotencyKeyOptions from a database record and extracts the user-provided key.
+ * Returns the user-provided key if valid options exist, otherwise falls back to the hash.
+ *
+ * @param run - Object containing idempotencyKey (the hash) and idempotencyKeyOptions (JSON from DB)
+ * @returns The user-provided key, the hash as fallback, or null if neither exists
+ */
+export function getUserProvidedIdempotencyKey(run) {
+    const parsed = IdempotencyKeyOptionsSchema.safeParse(run.idempotencyKeyOptions);
+    if (parsed.success) {
+        return parsed.data.key;
+    }
+    return run.idempotencyKey ?? undefined;
+}
+/**
+ * Safely parses idempotencyKeyOptions and extracts the scope.
+ *
+ * @param run - Object containing idempotencyKeyOptions (JSON from DB)
+ * @returns The scope if valid options exist, otherwise undefined
+ */
+export function extractIdempotencyKeyScope(run) {
+    const parsed = IdempotencyKeyOptionsSchema.safeParse(run.idempotencyKeyOptions);
+    if (parsed.success) {
+        return parsed.data.scope;
+    }
+    return undefined;
+}
+export function unsafeExtractIdempotencyKeyScope(run) {
+    const unsafe = run.idempotencyKeyOptions;
+    return unsafe?.scope ?? undefined;
+}
+/**
+ * Extracts just the user-provided key from idempotencyKeyOptions, without falling back to the hash.
+ * Useful for ClickHouse replication where we want to store only the explicit user key.
+ *
+ * @param run - Object containing idempotencyKeyOptions (JSON from DB)
+ * @returns The user-provided key if valid options exist, otherwise undefined
+ */
+export function extractIdempotencyKeyUser(run) {
+    const parsed = IdempotencyKeyOptionsSchema.safeParse(run.idempotencyKeyOptions);
+    if (parsed.success) {
+        return parsed.data.key;
+    }
+    return undefined;
+}
+export function unsafeExtractIdempotencyKeyUser(run) {
+    const unsafe = run.idempotencyKeyOptions;
+    return unsafe?.key ?? undefined;
+}
+//# sourceMappingURL=idempotencyKeys.js.map

package/dist/esm/v3/serverOnly/idempotencyKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/idempotencyKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAG7C;IACC,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAChF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC,cAAc,IAAI,SAAS,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAE1C;IACC,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAChF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,GAEhD;IACC,MAAM,MAAM,GAAG,GAAG,CAAC,qBAGX,CAAC;IACT,OAAO,MAAM,EAAE,KAAK,IAAI,SAAS,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAEzC;IACC,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAChF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,GAE/C;IACC,MAAM,MAAM,GAAG,GAAG,CAAC,qBAA4D,CAAC;IAEhF,OAAO,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,9 @@
+export * from "./checkpointClient.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";
+export * from "./idempotencyKeys.js";

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

@@ -0,0 +1,10 @@
+export * from "./checkpointClient.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";
+export * from "./idempotencyKeys.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

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

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

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

@@ -0,0 +1,45 @@
+import { createHash } from "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 = createHash(type);
+    hasher.update(data);
+    let hash = new Uint8Array(hasher.digest());
+    hash = hash.subarray(0, outputLength);
+    return hash;
+}
+export 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/esm/v3/serverOnly/jumpHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jumpHash.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/jumpHash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,SAAS,IAAI,CAAC,IAAgB,EAAE,YAAY,GAAG,EAAE,EAAE,IAAI,GAAG,QAAQ;IAChE,MAAM,MAAM,GAAG,UAAU,CAAC,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,MAAM,UAAU,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/esm/v3/serverOnly/k8s.d.ts

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

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

@@ -0,0 +1,15 @@
+import { env } from "std-env";
+export function isKubernetesEnvironment(override) {
+    if (override !== undefined) {
+        return override;
+    }
+    // Then check for common Kubernetes environment variables
+    const k8sIndicators = [
+        env.KUBERNETES_PORT,
+        env.KUBERNETES_SERVICE_HOST,
+        env.KUBERNETES_SERVICE_PORT,
+    ];
+    console.debug("k8sIndicators", { k8sIndicators });
+    return k8sIndicators.some(Boolean);
+}
+//# sourceMappingURL=k8s.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"k8s.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/k8s.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAE9B,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,yDAAyD;IACzD,MAAM,aAAa,GAAG;QACpB,GAAG,CAAC,eAAe;QACnB,GAAG,CAAC,uBAAuB;QAC3B,GAAG,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/esm/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/esm/v3/serverOnly/placementTags.js

@@ -0,0 +1,44 @@
+import { SimpleStructuredLogger } from "../utils/structuredLogger.js";
+export class PlacementTagProcessor {
+    config;
+    logger = new 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);
+        }
+    }
+}
+/**
+ * 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 function placementTag(key, value) {
+    return { key, values: [value] };
+}
+//# sourceMappingURL=placementTags.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"placementTags.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/placementTags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAOtE,MAAM,OAAO,qBAAqB;IAGH,MAAM;IAFlB,MAAM,GAAG,IAAI,sBAAsB,CAAC,yBAAyB,CAAC,CAAC;IAEhF,YAA6B,MAAuB;sBAAvB,MAAM;IAAoB,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;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAa;IACrD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/dist/esm/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/esm/v3/serverOnly/shutdownManager.js

@@ -0,0 +1,88 @@
+import { isTest } from "std-env";
+import { SimpleStructuredLogger } from "../utils/structuredLogger.js";
+import { singleton } from "./singleton.js";
+export class ShutdownManager {
+    disableForTesting;
+    isShuttingDown = false;
+    signalNumbers = {
+        SIGINT: 2,
+        SIGTERM: 15,
+    };
+    logger = new 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 !isTest;
+    }
+    // Only for testing
+    _getHandlersForTesting() {
+        return new Map(this.handlers);
+    }
+}
+export const shutdownManager = singleton("shutdownManager", () => new ShutdownManager());
+//# sourceMappingURL=shutdownManager.js.map