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

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

@@ -0,0 +1,92 @@
+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;
+export class ActiveJobRuntimeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ActiveJobRuntimeError";
+    }
+}
+export 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";
+    }
+}
+_JobCancellationToken_controller = new WeakMap(), _JobCancellationToken_reason = new WeakMap();
+export 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,
+        });
+    }
+}
+_ActiveJob_job = new WeakMap(), _ActiveJob_cancellation = new WeakMap(), _ActiveJob_hooks = new WeakMap(), _ActiveJob_metadata = new WeakMap();

package/esm/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/esm/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/esm/npm/src/server/internal_jobs/bindings.js

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

package/esm/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/esm/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/esm/npm/src/server/internal_jobs/cancellation-registry.js

@@ -0,0 +1,71 @@
+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;
+export 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"));
+    }
+}
+_ActiveJobCancellationGuard_key = new WeakMap(), _ActiveJobCancellationGuard_token = new WeakMap(), _ActiveJobCancellationGuard_registry = new WeakMap(), _ActiveJobCancellationGuard_disposed = new WeakMap();
+export 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);
+        }
+    }
+}
+_ActiveJobCancellationRegistry_tokens = new WeakMap(), _ActiveJobCancellationRegistry_pending = new WeakMap();

package/esm/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/esm/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"}

package/esm/npm/src/server/internal_jobs/heartbeat.js

@@ -0,0 +1,65 @@
+export class WorkerHeartbeatLoopError extends AggregateError {
+    constructor(errors) {
+        super(errors, "worker heartbeat loop failed");
+        this.name = "WorkerHeartbeatLoopError";
+    }
+}
+export function workerHeartbeatSubject(service, jobType, instanceId) {
+    return `trellis.jobs.workers.${service}.${jobType}.${instanceId}.heartbeat`;
+}
+export function newWorkerHeartbeat(options) {
+    return {
+        service: options.service,
+        jobType: options.jobType,
+        instanceId: options.instanceId,
+        ...(options.concurrency !== undefined
+            ? { concurrency: options.concurrency }
+            : {}),
+        ...(options.version !== undefined ? { version: options.version } : {}),
+        timestamp: options.timestamp,
+    };
+}
+export async function publishWorkerHeartbeat(publisher, heartbeat) {
+    await publisher.publish(workerHeartbeatSubject(heartbeat.service, heartbeat.jobType, heartbeat.instanceId), new TextEncoder().encode(JSON.stringify(heartbeat)));
+}
+export async function startWorkerHeartbeatLoop(options) {
+    const nowIso = options.nowIso ?? (() => new Date().toISOString());
+    const intervalMs = options.intervalMs ?? 30000;
+    const errors = [];
+    const inFlight = new Set();
+    const publish = async () => {
+        await publishWorkerHeartbeat(options.publisher, newWorkerHeartbeat({
+            service: options.service,
+            jobType: options.jobType,
+            instanceId: options.instanceId,
+            ...(options.concurrency !== undefined
+                ? { concurrency: options.concurrency }
+                : {}),
+            ...(options.version !== undefined ? { version: options.version } : {}),
+            timestamp: nowIso(),
+        }));
+    };
+    const publishSafely = () => {
+        const task = publish()
+            .catch((error) => {
+            errors.push(error);
+        })
+            .finally(() => {
+            inFlight.delete(task);
+        });
+        inFlight.add(task);
+    };
+    await publish();
+    const timer = setInterval(() => {
+        publishSafely();
+    }, intervalMs);
+    return {
+        async stop() {
+            clearInterval(timer);
+            await Promise.all(inFlight);
+            if (errors.length > 0) {
+                throw new WorkerHeartbeatLoopError(errors);
+            }
+        },
+    };
+}

package/esm/npm/src/server/internal_jobs/job-manager.d.ts

@@ -0,0 +1,60 @@
+import { ActiveJob, ActiveJobRuntimeError, JobCancellationToken } from "./active-job.js";
+import type { JobsBinding, JobsQueueBinding } from "./bindings.js";
+import type { Job, JobLogEntry, JobProgress } from "./types.js";
+type Publisher = {
+    publish(subject: string, payload: Uint8Array): void | Promise<void>;
+};
+type JobMetaSource = {
+    nextJobId(): string;
+    nowIso(): string;
+};
+type JobManagerContext = {
+    nc: Publisher;
+    jobs?: JobsBinding;
+    meta?: JobMetaSource;
+};
+type ActiveJobRuntimeMetadata = {
+    redeliveryCount?: number;
+};
+type JobProcessValidation<TPayload, TResult> = {
+    validateResult?: (result: TResult, job: Job<TPayload, TResult>) => Promise<void> | void;
+};
+export declare class JobProcessError extends Error {
+    readonly kind: "retryable" | "failed";
+    constructor(kind: "retryable" | "failed", message: string);
+    static retryable(message: string): JobProcessError;
+    static failed(message: string): JobProcessError;
+}
+export type JobProcessOutcome<TResult> = {
+    outcome: "completed";
+    tries: number;
+    result: TResult;
+} | {
+    outcome: "retry";
+    tries: number;
+    error: string;
+} | {
+    outcome: "failed";
+    tries: number;
+    error: string;
+} | {
+    outcome: "cancelled";
+    tries: number;
+} | {
+    outcome: "interrupted";
+    tries: number;
+};
+export declare class JobManager<TPayload = unknown, TResult = unknown> {
+    #private;
+    constructor(context: JobManagerContext);
+    create(type: string, payload: TPayload): Promise<Job<TPayload, TResult>>;
+    process(job: Job<TPayload, TResult>, cancellation: JobCancellationToken, handler: (job: ActiveJob<TPayload, TResult>) => Promise<TResult>, metadata?: ActiveJobRuntimeMetadata, validation?: JobProcessValidation<TPayload, TResult>): Promise<JobProcessOutcome<TResult>>;
+    processWithHeartbeat(job: Job<TPayload, TResult>, cancellation: JobCancellationToken, heartbeat: () => Promise<void>, handler: (job: ActiveJob<TPayload, TResult>) => Promise<TResult>, metadata?: ActiveJobRuntimeMetadata, validation?: JobProcessValidation<TPayload, TResult>): Promise<JobProcessOutcome<TResult>>;
+    emitProgress(job: Job<TPayload, TResult>, progress: JobProgress): Promise<void>;
+    emitLog(job: Job<TPayload, TResult>, log: JobLogEntry): Promise<void>;
+    withActiveJob<T>(job: Job<TPayload, TResult>, cancellation: JobCancellationToken, f: (job: ActiveJob<TPayload, TResult>) => Promise<T>, metadata?: ActiveJobRuntimeMetadata): Promise<T>;
+    withActiveJobAndHeartbeat<T>(job: Job<TPayload, TResult>, cancellation: JobCancellationToken, heartbeat: () => Promise<void>, f: (job: ActiveJob<TPayload, TResult>) => Promise<T>, metadata?: ActiveJobRuntimeMetadata): Promise<T>;
+}
+export type { JobsBinding, JobsQueueBinding };
+export { ActiveJob, ActiveJobRuntimeError, JobCancellationToken };
+//# sourceMappingURL=job-manager.d.ts.map

package/esm/npm/src/server/internal_jobs/job-manager.d.ts.map

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

package/esm/npm/src/server/internal_jobs/job-manager.js

@@ -0,0 +1,251 @@
+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 _JobManager_instances, _JobManager_context, _JobManager_meta, _JobManager_getQueueBinding, _JobManager_publishJobEvent;
+import { ulid } from "ulid";
+import { ActiveJob, ActiveJobRuntimeError, JobCancellationToken, } from "./active-job.js";
+export class JobProcessError extends Error {
+    constructor(kind, message) {
+        super(message);
+        Object.defineProperty(this, "kind", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "JobProcessError";
+        this.kind = kind;
+    }
+    static retryable(message) {
+        return new JobProcessError("retryable", message);
+    }
+    static failed(message) {
+        return new JobProcessError("failed", message);
+    }
+}
+export class JobManager {
+    constructor(context) {
+        _JobManager_instances.add(this);
+        _JobManager_context.set(this, void 0);
+        __classPrivateFieldSet(this, _JobManager_context, context, "f");
+    }
+    async create(type, payload) {
+        const binding = __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_getQueueBinding).call(this, type);
+        const meta = __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_meta).call(this);
+        const now = meta.nowIso();
+        const id = meta.nextJobId();
+        const namespace = __classPrivateFieldGet(this, _JobManager_context, "f").jobs.namespace;
+        const deadline = computeDeadline(now, binding.defaultDeadlineMs);
+        const job = {
+            id,
+            service: namespace,
+            type,
+            state: "pending",
+            payload,
+            createdAt: now,
+            updatedAt: now,
+            tries: 0,
+            maxTries: binding.maxDeliver,
+            ...(deadline ? { deadline } : {}),
+        };
+        const event = {
+            jobId: id,
+            service: job.service,
+            jobType: type,
+            eventType: "created",
+            state: "pending",
+            tries: 0,
+            maxTries: binding.maxDeliver,
+            payload,
+            ...(deadline ? { deadline } : {}),
+            timestamp: now,
+        };
+        await __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_publishJobEvent).call(this, type, id, event);
+        return job;
+    }
+    process(job, cancellation, handler, metadata = {}, validation = {}) {
+        return this.processWithHeartbeat(job, cancellation, () => {
+            throw new ActiveJobRuntimeError("worker heartbeat unavailable");
+        }, handler, metadata, validation);
+    }
+    async processWithHeartbeat(job, cancellation, heartbeat, handler, metadata = {}, validation = {}) {
+        __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_getQueueBinding).call(this, job.type);
+        const tries = job.tries + 1;
+        await __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_publishJobEvent).call(this, job.type, job.id, {
+            jobId: job.id,
+            service: job.service,
+            jobType: job.type,
+            eventType: "started",
+            state: "active",
+            previousState: job.state,
+            tries,
+            timestamp: __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_meta).call(this).nowIso(),
+        });
+        try {
+            const result = await this.withActiveJobAndHeartbeat({ ...job, state: "active", tries }, cancellation, heartbeat, handler, metadata);
+            if (cancellation.isHostShutdown()) {
+                return { outcome: "interrupted", tries };
+            }
+            if (cancellation.isCancelled()) {
+                return { outcome: "cancelled", tries };
+            }
+            try {
+                await validation.validateResult?.(result, {
+                    ...job,
+                    state: "active",
+                    tries,
+                });
+            }
+            catch (error) {
+                throw JobProcessError.failed(error instanceof Error ? error.message : String(error));
+            }
+            await __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_publishJobEvent).call(this, job.type, job.id, {
+                jobId: job.id,
+                service: job.service,
+                jobType: job.type,
+                eventType: "completed",
+                state: "completed",
+                previousState: "active",
+                tries,
+                result,
+                timestamp: __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_meta).call(this).nowIso(),
+            });
+            return { outcome: "completed", tries, result };
+        }
+        catch (error) {
+            if (cancellation.isHostShutdown()) {
+                return { outcome: "interrupted", tries };
+            }
+            if (cancellation.isCancelled()) {
+                return { outcome: "cancelled", tries };
+            }
+            if (error instanceof JobProcessError) {
+                const detail = error.message;
+                if (error.kind === "retryable") {
+                    await __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_publishJobEvent).call(this, job.type, job.id, {
+                        jobId: job.id,
+                        service: job.service,
+                        jobType: job.type,
+                        eventType: "retry",
+                        state: "retry",
+                        previousState: "active",
+                        tries,
+                        error: detail,
+                        timestamp: __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_meta).call(this).nowIso(),
+                    });
+                    return { outcome: "retry", tries, error: detail };
+                }
+                await __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_publishJobEvent).call(this, job.type, job.id, {
+                    jobId: job.id,
+                    service: job.service,
+                    jobType: job.type,
+                    eventType: "failed",
+                    state: "failed",
+                    previousState: "active",
+                    tries,
+                    error: detail,
+                    timestamp: __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_meta).call(this).nowIso(),
+                });
+                return { outcome: "failed", tries, error: detail };
+            }
+            throw error;
+        }
+    }
+    async emitProgress(job, progress) {
+        const queue = __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_getQueueBinding).call(this, job.type);
+        if (!queue.progress) {
+            throw new Error(`Feature 'progress' is disabled for queue '${queue.queueType}'`);
+        }
+        if (job.state !== "active") {
+            throw new Error(`Cannot emit progress for job '${job.id}' in state '${job.state}'`);
+        }
+        await __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_publishJobEvent).call(this, job.type, job.id, {
+            jobId: job.id,
+            service: job.service,
+            jobType: job.type,
+            eventType: "progress",
+            state: "active",
+            previousState: "active",
+            tries: job.tries,
+            progress,
+            timestamp: __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_meta).call(this).nowIso(),
+        });
+    }
+    async emitLog(job, log) {
+        const queue = __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_getQueueBinding).call(this, job.type);
+        if (!queue.logs) {
+            throw new Error(`Feature 'logs' is disabled for queue '${queue.queueType}'`);
+        }
+        if (job.state !== "active") {
+            throw new Error(`Cannot emit log for job '${job.id}' in state '${job.state}'`);
+        }
+        await __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_publishJobEvent).call(this, job.type, job.id, {
+            jobId: job.id,
+            service: job.service,
+            jobType: job.type,
+            eventType: "logged",
+            state: "active",
+            previousState: "active",
+            tries: job.tries,
+            logs: [log],
+            timestamp: __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_meta).call(this).nowIso(),
+        });
+    }
+    withActiveJob(job, cancellation, f, metadata = {}) {
+        return this.withActiveJobAndHeartbeat(job, cancellation, () => {
+            throw new ActiveJobRuntimeError("worker heartbeat unavailable");
+        }, f, metadata);
+    }
+    async withActiveJobAndHeartbeat(job, cancellation, heartbeat, f, metadata = {}) {
+        const activeJob = new ActiveJob(job, cancellation, {
+            updateProgress: (progress) => this.emitProgress(job, progress),
+            log: (entry) => this.emitLog(job, entry),
+            heartbeat: async () => {
+                try {
+                    await heartbeat();
+                }
+                catch (error) {
+                    if (error instanceof ActiveJobRuntimeError) {
+                        throw error;
+                    }
+                    throw new ActiveJobRuntimeError(error instanceof Error ? error.message : String(error));
+                }
+            },
+        }, {
+            redeliveryCount: metadata.redeliveryCount ?? 0,
+        });
+        return await f(activeJob);
+    }
+}
+_JobManager_context = new WeakMap(), _JobManager_instances = new WeakSet(), _JobManager_meta = function _JobManager_meta() {
+    return {
+        nextJobId: __classPrivateFieldGet(this, _JobManager_context, "f").meta?.nextJobId ?? (() => ulid()),
+        nowIso: __classPrivateFieldGet(this, _JobManager_context, "f").meta?.nowIso ?? (() => new Date().toISOString()),
+    };
+}, _JobManager_getQueueBinding = function _JobManager_getQueueBinding(type) {
+    const binding = __classPrivateFieldGet(this, _JobManager_context, "f").jobs?.queues[type];
+    if (!binding || !__classPrivateFieldGet(this, _JobManager_context, "f").jobs) {
+        throw new Error(`Missing jobs binding for queue '${type}'`);
+    }
+    return binding;
+}, _JobManager_publishJobEvent = async function _JobManager_publishJobEvent(type, jobId, event) {
+    const binding = __classPrivateFieldGet(this, _JobManager_instances, "m", _JobManager_getQueueBinding).call(this, type);
+    await __classPrivateFieldGet(this, _JobManager_context, "f").nc.publish(`${binding.publishPrefix}.${jobId}.${event.eventType}`, new TextEncoder().encode(JSON.stringify(event)));
+};
+function computeDeadline(now, deadlineMs) {
+    if (deadlineMs === undefined) {
+        return undefined;
+    }
+    const timestamp = new Date(now);
+    timestamp.setTime(timestamp.getTime() + deadlineMs);
+    return timestamp.toISOString();
+}
+export { ActiveJob, ActiveJobRuntimeError, JobCancellationToken };

package/esm/npm/src/server/internal_jobs/projection.d.ts

@@ -0,0 +1,4 @@
+import type { Job, JobEvent, JobState } from "./types.js";
+export declare function isTerminal(state: JobState): boolean;
+export declare function jobFromWorkEvent<TPayload = unknown, TResult = unknown>(event: JobEvent<TPayload, TResult>): Job<TPayload, TResult> | undefined;
+//# sourceMappingURL=projection.d.ts.map

package/esm/npm/src/server/internal_jobs/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../../../src/server/internal_jobs/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAW1D,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAEnD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACpE,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,GACjC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,SAAS,CAQpC"}