@qlever-llc/trellis 0.7.0 → 0.8.0-rc.2

package/script/npm/src/server/health.js

@@ -0,0 +1,303 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _ServiceHealth_checks, _ServiceHealth_info;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceHealth = void 0;
+exports.runHealthCheck = runHealthCheck;
+exports.runServiceHealthCheck = runServiceHealthCheck;
+exports.runAllHealthChecks = runAllHealthChecks;
+exports.runAllServiceHealthChecks = runAllServiceHealthChecks;
+exports.createHealthHeartbeat = createHealthHeartbeat;
+/**
+ * Health check types and utility functions for Trellis services.
+ *
+ * This module provides a standardized way to implement health checks
+ * for services, with support for individual check results and
+ * aggregated health status (healthy, degraded, unhealthy).
+ *
+ * @module
+ */
+const dntShim = __importStar(require("../_dnt.shims.js"));
+function summarizeHealthStatus(results) {
+    const allOk = results.every((r) => r.status === "ok");
+    const anyOk = results.some((r) => r.status === "ok");
+    return allOk ? "healthy" : anyOk ? "degraded" : "unhealthy";
+}
+function summarizeHealthChecks(results) {
+    const failedCount = results.filter((r) => r.status === "failed").length;
+    if (failedCount === 0) {
+        return undefined;
+    }
+    return `${failedCount} check${failedCount === 1 ? "" : "s"} failing`;
+}
+function normalizeLegacyHealthCheck(check) {
+    return async () => {
+        const result = await check();
+        if (result.isErr()) {
+            return {
+                status: "failed",
+                error: result.error.message,
+                summary: result.error.message,
+            };
+        }
+        return { status: result.take() ? "ok" : "failed" };
+    };
+}
+function detectRuntime() {
+    const maybeDeno = Reflect.get(dntShim.dntGlobalThis, "Deno");
+    if (maybeDeno?.version?.deno) {
+        return { runtime: "deno", runtimeVersion: maybeDeno.version.deno };
+    }
+    const maybeProcess = Reflect.get(dntShim.dntGlobalThis, "process");
+    if (typeof maybeProcess?.version === "string") {
+        return { runtime: "node", runtimeVersion: maybeProcess.version };
+    }
+    return { runtime: "unknown" };
+}
+/**
+ * Runs a single health check and returns the result.
+ *
+ * @param name - Name to identify this health check
+ * @param check - The health check function to run
+ * @returns A HealthCheckResult with status, latency, and optional error
+ *
+ * @example
+ * ```typescript
+ * const result = await runHealthCheck("database", async () => {
+ *   const connected = await db.ping();
+ *   return Result.ok(connected);
+ * });
+ *
+ * if (result.status === "ok") {
+ *   console.log(`Database check passed in ${result.latencyMs}ms`);
+ * }
+ * ```
+ */
+async function runHealthCheck(name, check) {
+    return await runServiceHealthCheck(name, normalizeLegacyHealthCheck(check));
+}
+async function runServiceHealthCheck(name, check) {
+    const start = performance.now();
+    try {
+        const result = await check();
+        const latencyMs = performance.now() - start;
+        return {
+            name,
+            status: result.status,
+            error: result.error,
+            summary: result.summary,
+            info: result.info,
+            latencyMs,
+        };
+    }
+    catch (error) {
+        const latencyMs = performance.now() - start;
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            name,
+            status: "failed",
+            error: message,
+            summary: message,
+            latencyMs,
+        };
+    }
+}
+/**
+ * Runs all health checks and returns an aggregated health response.
+ *
+ * @param service - Name of the service being checked
+ * @param checks - Record of check names to check functions
+ * @returns A HealthResponse with overall status and individual check results
+ *
+ * @example
+ * ```typescript
+ * const health = await runAllHealthChecks("api-service", {
+ *   database: async () => Result.ok(await db.ping()),
+ *   cache: async () => Result.ok(await redis.ping()),
+ *   queue: async () => Result.ok(await rabbit.ping()),
+ * });
+ *
+ * if (health.status === "healthy") {
+ *   console.log("All systems operational");
+ * } else if (health.status === "degraded") {
+ *   console.warn("Some systems are failing");
+ * } else {
+ *   console.error("Service is unhealthy");
+ * }
+ * ```
+ */
+async function runAllHealthChecks(service, checks) {
+    const normalizedChecks = Object.fromEntries(Object.entries(checks).map(([name, check]) => [name, normalizeLegacyHealthCheck(check)]));
+    return await runAllServiceHealthChecks(service, normalizedChecks);
+}
+async function runAllServiceHealthChecks(service, checks) {
+    const results = await Promise.all(Object.entries(checks).map(([name, fn]) => runServiceHealthCheck(name, fn)));
+    return {
+        status: summarizeHealthStatus(results),
+        service,
+        timestamp: new Date().toISOString(),
+        checks: results,
+    };
+}
+function createHealthHeartbeat(args) {
+    const runtime = detectRuntime();
+    const summary = summarizeHealthChecks(args.checks);
+    return {
+        service: {
+            name: args.serviceName,
+            kind: args.kind ?? "service",
+            instanceId: args.instanceId,
+            contractId: args.contractId,
+            contractDigest: args.contractDigest,
+            startedAt: args.startedAt,
+            publishIntervalMs: args.publishIntervalMs,
+            runtime: runtime.runtime,
+            ...(runtime.runtimeVersion
+                ? { runtimeVersion: runtime.runtimeVersion }
+                : {}),
+            ...(args.info?.version ? { version: args.info.version } : {}),
+            ...(args.info?.info ? { info: args.info.info } : {}),
+        },
+        status: summarizeHealthStatus(args.checks),
+        ...(summary ? { summary } : {}),
+        checks: args.checks,
+    };
+}
+class ServiceHealth {
+    constructor(args) {
+        Object.defineProperty(this, "serviceName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "kind", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "instanceId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "contractId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "contractDigest", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "startedAt", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "publishIntervalMs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        _ServiceHealth_checks.set(this, new Map());
+        _ServiceHealth_info.set(this, void 0);
+        this.serviceName = args.serviceName;
+        this.kind = args.kind ?? "service";
+        this.instanceId = args.instanceId ?? crypto.randomUUID();
+        this.contractId = args.contractId;
+        this.contractDigest = args.contractDigest;
+        this.startedAt = new Date().toISOString();
+        this.publishIntervalMs = args.publishIntervalMs;
+        for (const [name, check] of Object.entries(args.checks ?? {})) {
+            __classPrivateFieldGet(this, _ServiceHealth_checks, "f").set(name, normalizeLegacyHealthCheck(check));
+        }
+    }
+    setInfo(info) {
+        if (typeof info === "function") {
+            __classPrivateFieldSet(this, _ServiceHealth_info, info, "f");
+            return;
+        }
+        __classPrivateFieldSet(this, _ServiceHealth_info, () => info, "f");
+    }
+    add(name, check) {
+        __classPrivateFieldGet(this, _ServiceHealth_checks, "f").set(name, check);
+        return () => {
+            __classPrivateFieldGet(this, _ServiceHealth_checks, "f").delete(name);
+        };
+    }
+    async checks() {
+        return await Promise.all(Array.from(__classPrivateFieldGet(this, _ServiceHealth_checks, "f").entries()).map(([name, check]) => runServiceHealthCheck(name, check)));
+    }
+    async response() {
+        const checks = Object.fromEntries(__classPrivateFieldGet(this, _ServiceHealth_checks, "f").entries());
+        return await runAllServiceHealthChecks(this.serviceName, checks);
+    }
+    async heartbeat() {
+        const checks = await this.checks();
+        const info = __classPrivateFieldGet(this, _ServiceHealth_info, "f") ? await __classPrivateFieldGet(this, _ServiceHealth_info, "f").call(this) : undefined;
+        return createHealthHeartbeat({
+            serviceName: this.serviceName,
+            kind: this.kind,
+            instanceId: this.instanceId,
+            contractId: this.contractId,
+            contractDigest: this.contractDigest,
+            startedAt: this.startedAt,
+            publishIntervalMs: this.publishIntervalMs,
+            checks,
+            info,
+        });
+    }
+}
+exports.ServiceHealth = ServiceHealth;
+_ServiceHealth_checks = new WeakMap(), _ServiceHealth_info = new WeakMap();

package/script/npm/src/server/health_rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health_rpc.d.ts","sourceRoot":"","sources":["../../../../src/server/health_rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AAErB,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,cAAc,EAAE;QAAE,QAAQ,IAAI,OAAO,CAAA;KAAE,CAAC;IACxC,KAAK,CAAC,CAAC,SAAS,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,EAC9C,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACvC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB,CAAC;AAUF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE;IACL,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CAC1C,GACA,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/script/npm/src/server/health_schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health_schemas.d.ts","sourceRoot":"","sources":["../../../../src/server/health_schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAE/C,eAAO,MAAM,gBAAgB,qCAA6C,CAAC;AAE3E,eAAO,MAAM,uBAAuB;;;;;;;EAOlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAS/B,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;EAGtC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;EAiBvC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUhC,CAAC"}

package/script/npm/src/server/internal_jobs/active-job.d.ts

@@ -0,0 +1,36 @@
+import type { Job, JobLogEntry, JobProgress } from "./types.js";
+export declare class ActiveJobRuntimeError extends Error {
+    constructor(message: string);
+}
+export type ActiveJobRuntimeMetadata = {
+    redeliveryCount: number;
+};
+export declare class JobCancellationToken {
+    #private;
+    cancel(): void;
+    cancelForShutdown(): void;
+    get signal(): AbortSignal;
+    isCancelled(): boolean;
+    isJobCancelled(): boolean;
+    isHostShutdown(): boolean;
+}
+type ActiveJobHooks = {
+    updateProgress: (progress: JobProgress) => Promise<void>;
+    log: (entry: JobLogEntry) => Promise<void>;
+    heartbeat: () => Promise<void>;
+};
+export declare class ActiveJob<TPayload = unknown, TResult = unknown> {
+    #private;
+    constructor(job: Job<TPayload, TResult>, cancellation: JobCancellationToken, hooks: ActiveJobHooks, metadata: ActiveJobRuntimeMetadata);
+    job(): Readonly<Job<TPayload, TResult>>;
+    get signal(): AbortSignal;
+    isCancelled(): boolean;
+    cancellationToken(): JobCancellationToken;
+    redeliveryCount(): number;
+    isRedelivery(): boolean;
+    heartbeat(): Promise<void>;
+    updateProgress(progress: JobProgress): Promise<void>;
+    log(level: JobLogEntry["level"], message: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=active-job.d.ts.map

package/script/npm/src/server/internal_jobs/active-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-job.d.ts","sourceRoot":"","sources":["../../../../../src/server/internal_jobs/active-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,qBAAa,oBAAoB;;IAI/B,MAAM,IAAI,IAAI;IAQd,iBAAiB,IAAI,IAAI;IAKzB,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,WAAW,IAAI,OAAO;IAItB,cAAc,IAAI,OAAO;IAIzB,cAAc,IAAI,OAAO;CAG1B;AAED,KAAK,cAAc,GAAG;IACpB,cAAc,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,GAAG,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,qBAAa,SAAS,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;;gBAOxD,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,EAC3B,YAAY,EAAE,oBAAoB,EAClC,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,wBAAwB;IAQpC,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAIvC,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,WAAW,IAAI,OAAO;IAItB,iBAAiB,IAAI,oBAAoB;IAIzC,eAAe,IAAI,MAAM;IAIzB,YAAY,IAAI,OAAO;IAIvB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOjE"}

package/script/npm/src/server/internal_jobs/active-job.js

@@ -0,0 +1,98 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _JobCancellationToken_controller, _JobCancellationToken_reason, _ActiveJob_job, _ActiveJob_cancellation, _ActiveJob_hooks, _ActiveJob_metadata;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActiveJob = exports.JobCancellationToken = exports.ActiveJobRuntimeError = void 0;
+class ActiveJobRuntimeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ActiveJobRuntimeError";
+    }
+}
+exports.ActiveJobRuntimeError = ActiveJobRuntimeError;
+class JobCancellationToken {
+    constructor() {
+        _JobCancellationToken_controller.set(this, new AbortController());
+        _JobCancellationToken_reason.set(this, "none");
+    }
+    cancel() {
+        if (__classPrivateFieldGet(this, _JobCancellationToken_reason, "f") === "shutdown") {
+            return;
+        }
+        __classPrivateFieldSet(this, _JobCancellationToken_reason, "job", "f");
+        __classPrivateFieldGet(this, _JobCancellationToken_controller, "f").abort("job");
+    }
+    cancelForShutdown() {
+        __classPrivateFieldSet(this, _JobCancellationToken_reason, "shutdown", "f");
+        __classPrivateFieldGet(this, _JobCancellationToken_controller, "f").abort("shutdown");
+    }
+    get signal() {
+        return __classPrivateFieldGet(this, _JobCancellationToken_controller, "f").signal;
+    }
+    isCancelled() {
+        return __classPrivateFieldGet(this, _JobCancellationToken_reason, "f") !== "none";
+    }
+    isJobCancelled() {
+        return __classPrivateFieldGet(this, _JobCancellationToken_reason, "f") === "job";
+    }
+    isHostShutdown() {
+        return __classPrivateFieldGet(this, _JobCancellationToken_reason, "f") === "shutdown";
+    }
+}
+exports.JobCancellationToken = JobCancellationToken;
+_JobCancellationToken_controller = new WeakMap(), _JobCancellationToken_reason = new WeakMap();
+class ActiveJob {
+    constructor(job, cancellation, hooks, metadata) {
+        _ActiveJob_job.set(this, void 0);
+        _ActiveJob_cancellation.set(this, void 0);
+        _ActiveJob_hooks.set(this, void 0);
+        _ActiveJob_metadata.set(this, void 0);
+        __classPrivateFieldSet(this, _ActiveJob_job, job, "f");
+        __classPrivateFieldSet(this, _ActiveJob_cancellation, cancellation, "f");
+        __classPrivateFieldSet(this, _ActiveJob_hooks, hooks, "f");
+        __classPrivateFieldSet(this, _ActiveJob_metadata, metadata, "f");
+    }
+    job() {
+        return __classPrivateFieldGet(this, _ActiveJob_job, "f");
+    }
+    get signal() {
+        return __classPrivateFieldGet(this, _ActiveJob_cancellation, "f").signal;
+    }
+    isCancelled() {
+        return __classPrivateFieldGet(this, _ActiveJob_cancellation, "f").isCancelled();
+    }
+    cancellationToken() {
+        return __classPrivateFieldGet(this, _ActiveJob_cancellation, "f");
+    }
+    redeliveryCount() {
+        return __classPrivateFieldGet(this, _ActiveJob_metadata, "f").redeliveryCount;
+    }
+    isRedelivery() {
+        return __classPrivateFieldGet(this, _ActiveJob_metadata, "f").redeliveryCount > 0;
+    }
+    heartbeat() {
+        return __classPrivateFieldGet(this, _ActiveJob_hooks, "f").heartbeat();
+    }
+    updateProgress(progress) {
+        return __classPrivateFieldGet(this, _ActiveJob_hooks, "f").updateProgress(progress);
+    }
+    log(level, message) {
+        return __classPrivateFieldGet(this, _ActiveJob_hooks, "f").log({
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+        });
+    }
+}
+exports.ActiveJob = ActiveJob;
+_ActiveJob_job = new WeakMap(), _ActiveJob_cancellation = new WeakMap(), _ActiveJob_hooks = new WeakMap(), _ActiveJob_metadata = new WeakMap();

package/script/npm/src/server/internal_jobs/bindings.d.ts

@@ -0,0 +1,29 @@
+export type JobsQueueBinding = {
+    queueType: string;
+    publishPrefix: string;
+    workSubject: string;
+    consumerName: string;
+    payload: {
+        schema: string;
+    };
+    result?: {
+        schema: string;
+    };
+    maxDeliver: number;
+    backoffMs: number[];
+    ackWaitMs: number;
+    defaultDeadlineMs?: number;
+    progress: boolean;
+    logs: boolean;
+    dlq: boolean;
+    concurrency: number;
+};
+export type JobsBinding = {
+    namespace: string;
+    queues: Record<string, JobsQueueBinding>;
+};
+export type JobsRuntimeBinding = {
+    jobs: JobsBinding;
+    workStream: string;
+};
+//# sourceMappingURL=bindings.d.ts.map

package/script/npm/src/server/internal_jobs/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../../../../src/server/internal_jobs/bindings.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/script/npm/src/server/internal_jobs/bindings.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/npm/src/server/internal_jobs/cancellation-registry.d.ts

@@ -0,0 +1,14 @@
+import type { JobCancellationToken } from "./active-job.js";
+export declare class ActiveJobCancellationGuard {
+    #private;
+    constructor(key: string, token: JobCancellationToken, registry: ActiveJobCancellationRegistry);
+    dispose(): void;
+}
+export declare class ActiveJobCancellationRegistry {
+    #private;
+    register(key: string, token: JobCancellationToken): ActiveJobCancellationGuard;
+    cancel(key: string): boolean;
+    clearPending(key: string): void;
+    unregister(key: string, token: JobCancellationToken): void;
+}
+//# sourceMappingURL=cancellation-registry.d.ts.map

package/script/npm/src/server/internal_jobs/cancellation-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation-registry.d.ts","sourceRoot":"","sources":["../../../../../src/server/internal_jobs/cancellation-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,qBAAa,0BAA0B;;gBAOnC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,6BAA6B;IAOzC,OAAO,IAAI,IAAI;CAOhB;AAED,qBAAa,6BAA6B;;IAIxC,QAAQ,CACN,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,oBAAoB,GAC1B,0BAA0B;IAU7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAY5B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/B,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI;CAU3D"}

package/script/npm/src/server/internal_jobs/cancellation-registry.js

@@ -0,0 +1,76 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ActiveJobCancellationGuard_key, _ActiveJobCancellationGuard_token, _ActiveJobCancellationGuard_registry, _ActiveJobCancellationGuard_disposed, _ActiveJobCancellationRegistry_tokens, _ActiveJobCancellationRegistry_pending;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActiveJobCancellationRegistry = exports.ActiveJobCancellationGuard = void 0;
+class ActiveJobCancellationGuard {
+    constructor(key, token, registry) {
+        _ActiveJobCancellationGuard_key.set(this, void 0);
+        _ActiveJobCancellationGuard_token.set(this, void 0);
+        _ActiveJobCancellationGuard_registry.set(this, void 0);
+        _ActiveJobCancellationGuard_disposed.set(this, false);
+        __classPrivateFieldSet(this, _ActiveJobCancellationGuard_key, key, "f");
+        __classPrivateFieldSet(this, _ActiveJobCancellationGuard_token, token, "f");
+        __classPrivateFieldSet(this, _ActiveJobCancellationGuard_registry, registry, "f");
+    }
+    dispose() {
+        if (__classPrivateFieldGet(this, _ActiveJobCancellationGuard_disposed, "f")) {
+            return;
+        }
+        __classPrivateFieldSet(this, _ActiveJobCancellationGuard_disposed, true, "f");
+        __classPrivateFieldGet(this, _ActiveJobCancellationGuard_registry, "f").unregister(__classPrivateFieldGet(this, _ActiveJobCancellationGuard_key, "f"), __classPrivateFieldGet(this, _ActiveJobCancellationGuard_token, "f"));
+    }
+}
+exports.ActiveJobCancellationGuard = ActiveJobCancellationGuard;
+_ActiveJobCancellationGuard_key = new WeakMap(), _ActiveJobCancellationGuard_token = new WeakMap(), _ActiveJobCancellationGuard_registry = new WeakMap(), _ActiveJobCancellationGuard_disposed = new WeakMap();
+class ActiveJobCancellationRegistry {
+    constructor() {
+        _ActiveJobCancellationRegistry_tokens.set(this, new Map());
+        _ActiveJobCancellationRegistry_pending.set(this, new Set());
+    }
+    register(key, token) {
+        const tokens = __classPrivateFieldGet(this, _ActiveJobCancellationRegistry_tokens, "f").get(key) ?? new Set();
+        tokens.add(token);
+        __classPrivateFieldGet(this, _ActiveJobCancellationRegistry_tokens, "f").set(key, tokens);
+        if (__classPrivateFieldGet(this, _ActiveJobCancellationRegistry_pending, "f").delete(key)) {
+            token.cancel();
+        }
+        return new ActiveJobCancellationGuard(key, token, this);
+    }
+    cancel(key) {
+        const tokens = __classPrivateFieldGet(this, _ActiveJobCancellationRegistry_tokens, "f").get(key);
+        if (!tokens || tokens.size === 0) {
+            __classPrivateFieldGet(this, _ActiveJobCancellationRegistry_pending, "f").add(key);
+            return false;
+        }
+        for (const token of tokens) {
+            token.cancel();
+        }
+        return true;
+    }
+    clearPending(key) {
+        __classPrivateFieldGet(this, _ActiveJobCancellationRegistry_pending, "f").delete(key);
+    }
+    unregister(key, token) {
+        const tokens = __classPrivateFieldGet(this, _ActiveJobCancellationRegistry_tokens, "f").get(key);
+        if (!tokens) {
+            return;
+        }
+        tokens.delete(token);
+        if (tokens.size === 0) {
+            __classPrivateFieldGet(this, _ActiveJobCancellationRegistry_tokens, "f").delete(key);
+        }
+    }
+}
+exports.ActiveJobCancellationRegistry = ActiveJobCancellationRegistry;
+_ActiveJobCancellationRegistry_tokens = new WeakMap(), _ActiveJobCancellationRegistry_pending = new WeakMap();

package/script/npm/src/server/internal_jobs/heartbeat.d.ts

@@ -0,0 +1,33 @@
+import type { WorkerHeartbeat } from "./types.js";
+type HeartbeatPublisher = {
+    publish(subject: string, payload: Uint8Array): void | Promise<void>;
+};
+type WorkerHeartbeatOptions = {
+    service: string;
+    jobType: string;
+    instanceId: string;
+    concurrency?: number;
+    version?: string;
+    timestamp: string;
+};
+type WorkerHeartbeatLoopOptions = {
+    publisher: HeartbeatPublisher;
+    service: string;
+    jobType: string;
+    instanceId: string;
+    concurrency?: number;
+    version?: string;
+    intervalMs?: number;
+    nowIso?: () => string;
+};
+export declare class WorkerHeartbeatLoopError extends AggregateError {
+    constructor(errors: unknown[]);
+}
+export declare function workerHeartbeatSubject(service: string, jobType: string, instanceId: string): string;
+export declare function newWorkerHeartbeat(options: WorkerHeartbeatOptions): WorkerHeartbeat;
+export declare function publishWorkerHeartbeat(publisher: HeartbeatPublisher, heartbeat: WorkerHeartbeat): Promise<void>;
+export declare function startWorkerHeartbeatLoop(options: WorkerHeartbeatLoopOptions): Promise<{
+    stop(): Promise<void>;
+}>;
+export {};
+//# sourceMappingURL=heartbeat.d.ts.map

package/script/npm/src/server/internal_jobs/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../../../src/server/internal_jobs/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,KAAK,kBAAkB,GAAG;IACxB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAa,wBAAyB,SAAQ,cAAc;gBAC9C,MAAM,EAAE,OAAO,EAAE;CAI9B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAWjB;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC;IAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CA+CpC"}