@ultimat3/jobs 1.0.0 → 1.2.0

package/src/driver-pg.js

@@ -1,246 +0,0 @@
-// The DEFAULT driver: a Postgres queue. Zero infra to start — the database you already have
-// is the queue. `SELECT ... FOR UPDATE SKIP LOCKED` lets N workers claim disjoint batches
-// without a coordinator, and the visibility timeout (`visible_at`) makes a worker crash cost
-// one lease instead of one job. The statements themselves live in `driver-pg-sql.ts`.
-import { systemClock, uuid } from '@ultimat3/core';
-import { nowMs } from './clock';
-import { DEFAULT_QUEUE } from './driver';
-import { SQL_ACK, SQL_ADVISORY_UNLOCK, SQL_CLAIM, SQL_ENQUEUE, SQL_FIND_LIVE_BY_KEY, SQL_HEARTBEAT, SQL_NACK, SQL_STATS, SQL_STEP_GET, SQL_STEP_PUT, SQL_TRY_ADVISORY_LOCK, } from './driver-pg-sql';
-import { DriverUnavailableError, JobDuplicateError } from './errors';
-const num = (value) => value === null || value === undefined ? 0 : Number(value);
-const optionalNum = (value) => value === null || value === undefined ? undefined : Number(value);
-function toJobRecord(row) {
-    const visibleAt = optionalNum(row.visible_at);
-    return {
-        id: row.id,
-        name: row.name,
-        queue: row.queue,
-        input: row.input,
-        idempotencyKey: row.idempotency_key,
-        runId: row.run_id,
-        attempt: row.attempt,
-        maxAttempts: row.max_attempts,
-        state: row.state,
-        runAt: num(row.run_at),
-        createdAt: num(row.created_at),
-        updatedAt: num(row.updated_at),
-        ...(row.tenant_id === null ? {} : { tenantId: row.tenant_id }),
-        ...(row.last_error === null ? {} : { lastError: row.last_error }),
-        ...(row.claimed_by === null ? {} : { claimedBy: row.claimed_by }),
-        ...(visibleAt === undefined ? {} : { visibleAt }),
-    };
-}
-function toStepRecord(row) {
-    const completedAt = optionalNum(row.completed_at);
-    const wakeAt = optionalNum(row.wake_at);
-    return {
-        runId: row.run_id,
-        name: row.name,
-        status: row.status,
-        output: row.output,
-        startedAt: num(row.started_at),
-        attempts: row.attempts,
-        ...(completedAt === undefined ? {} : { completedAt }),
-        ...(wakeAt === undefined ? {} : { wakeAt }),
-        ...(row.event === null ? {} : { event: row.event }),
-        ...(row.correlation_key === null ? {} : { correlationKey: row.correlation_key }),
-        ...(row.error === null ? {} : { error: row.error }),
-    };
-}
-function resolveExecutor(injected) {
-    if (injected !== undefined)
-        return injected;
-    throw new DriverUnavailableError({
-        driver: 'pg',
-        cause: 'no PgExecutor was provided and Bun.sql is not configured',
-        fix: 'set DATABASE_URL in .env then run `x db up`, or use driver: "memory" in app.config.ts',
-    });
-}
-function pgStepStore(exec) {
-    return {
-        async get(runId, name) {
-            const rows = await exec().query(SQL_STEP_GET, [runId, name]);
-            const row = rows[0];
-            return row === undefined ? undefined : toStepRecord(row);
-        },
-        async put(record) {
-            await exec().query(SQL_STEP_PUT, [
-                record.runId,
-                record.name,
-                record.status,
-                JSON.stringify(record.output ?? null),
-                record.startedAt,
-                record.completedAt ?? null,
-                record.wakeAt ?? null,
-                record.event ?? null,
-                record.correlationKey ?? null,
-                record.attempts,
-                record.error ?? null,
-            ]);
-        },
-        async list(runId) {
-            const rows = await exec().query(`select * from x_job_steps where run_id = $1 order by started_at`, [runId]);
-            return rows.map(toStepRecord);
-        },
-        async del(runId, name) {
-            await exec().query(`delete from x_job_steps where run_id = $1 and name = $2`, [runId, name]);
-        },
-        async clear(runId) {
-            await exec().query(`delete from x_job_steps where run_id = $1`, [runId]);
-        },
-    };
-}
-export function createPgDriver(options = {}) {
-    const clock = options.clock ?? systemClock;
-    let executor;
-    const exec = () => {
-        executor ??= resolveExecutor(options.executor);
-        return executor;
-    };
-    const introspect = {
-        async job(jobId) {
-            const rows = await exec().query(`select * from x_jobs where id = $1`, [jobId]);
-            const row = rows[0];
-            return row === undefined ? undefined : toJobRecord(row);
-        },
-        async list(filter = {}) {
-            const rows = await exec().query(`select * from x_jobs
-          where ($1::text is null or queue = $1)
-            and ($2::text is null or name  = $2)
-            and ($3::text is null or state = $3)
-          order by created_at desc
-          limit $4`, [filter.queue ?? null, filter.name ?? null, filter.state ?? null, filter.limit ?? 100]);
-            return rows.map(toJobRecord);
-        },
-        async deadLetters(limit = 100) {
-            const rows = await exec().query(`select * from x_jobs where state = 'dead' order by updated_at desc limit $1`, [limit]);
-            return rows.map(toJobRecord);
-        },
-        async requeue(jobId, requeueOptions) {
-            if (requeueOptions?.fromStep !== undefined) {
-                const current = await this.job(jobId);
-                if (current !== undefined) {
-                    await exec().query(`delete from x_job_steps where run_id = $1 and name = $2`, [
-                        current.runId,
-                        requeueOptions.fromStep,
-                    ]);
-                }
-            }
-            const rows = await exec().query(`update x_jobs set state = 'ready', attempt = 0, run_at = now(), updated_at = now()
-          where id = $1 returning *`, [jobId]);
-            const row = rows[0];
-            if (row === undefined) {
-                throw new DriverUnavailableError({
-                    driver: 'pg',
-                    cause: `job ${jobId} does not exist`,
-                    fix: 'x jobs list --state dead --json',
-                });
-            }
-            return toJobRecord(row);
-        },
-    };
-    return {
-        name: 'pg',
-        steps: pgStepStore(exec),
-        introspect,
-        async enqueue(request) {
-            const runAt = request.runAt ?? nowMs(clock);
-            const rows = await exec().query(SQL_ENQUEUE, [
-                uuid(),
-                request.name,
-                request.queue || DEFAULT_QUEUE,
-                JSON.stringify(request.input ?? null),
-                request.idempotencyKey,
-                request.runId ?? uuid(),
-                request.maxAttempts,
-                runAt,
-                request.tenantId ?? null,
-            ]);
-            const inserted = rows[0];
-            if (inserted !== undefined) {
-                return { id: inserted.id, runId: inserted.run_id, deduped: false };
-            }
-            // `do nothing` fired: a live job already owns this idempotency key.
-            const existing = await exec().query(SQL_FIND_LIVE_BY_KEY, [
-                request.idempotencyKey,
-            ]);
-            const found = existing[0];
-            if (found === undefined) {
-                throw new DriverUnavailableError({
-                    driver: 'pg',
-                    cause: `enqueue of "${request.name}" was rejected but no live row holds its idempotency key`,
-                    fix: 'x db check — the x_jobs_idempotency_live_idx index is missing or stale',
-                });
-            }
-            if (request.onConflict === 'error') {
-                throw new JobDuplicateError({
-                    job: request.name,
-                    idempotencyKey: request.idempotencyKey,
-                    existingId: found.id,
-                });
-            }
-            return { id: found.id, runId: found.run_id, deduped: true };
-        },
-        async claim(claimOptions) {
-            const queues = claimOptions.queues.length > 0 ? claimOptions.queues : [DEFAULT_QUEUE];
-            const rows = await exec().query(SQL_CLAIM, [
-                queues,
-                claimOptions.limit,
-                claimOptions.workerId,
-                claimOptions.visibilityTimeoutMs,
-            ]);
-            const at = nowMs(clock);
-            return rows.map((row) => {
-                const record = toJobRecord(row);
-                return {
-                    ...record,
-                    claimedAt: at,
-                    visibleAt: record.visibleAt ?? at + claimOptions.visibilityTimeoutMs,
-                };
-            });
-        },
-        async ack(jobId) {
-            await exec().query(SQL_ACK, [jobId]);
-        },
-        async nack(jobId, nackOptions) {
-            const counts = nackOptions.countsAsAttempt !== false;
-            const state = nackOptions.deadLetter === true ? 'dead' : counts ? 'ready' : 'suspended';
-            await exec().query(SQL_NACK, [
-                jobId,
-                state,
-                counts,
-                nackOptions.delayMs,
-                nackOptions.error ?? null,
-            ]);
-        },
-        async heartbeat(jobId, heartbeatOptions) {
-            await exec().query(SQL_HEARTBEAT, [jobId, heartbeatOptions.visibilityTimeoutMs]);
-        },
-        async stats() {
-            const rows = await exec().query(SQL_STATS, []);
-            return rows.map((row) => ({
-                queue: row.queue,
-                ready: num(row.ready),
-                delayed: num(row.delayed),
-                running: num(row.running),
-                suspended: num(row.suspended),
-                dead: num(row.dead),
-                oldestReadyMs: Math.round(num(row.oldest_ready_ms)),
-            }));
-        },
-    };
-}
-/** Advisory-lock leader election, used by the `scheduler` role. */
-export function createPgLeader(lockKey, options = {}) {
-    const exec = () => resolveExecutor(options.executor);
-    return {
-        async acquire() {
-            const rows = await exec().query(SQL_TRY_ADVISORY_LOCK, [lockKey]);
-            return rows[0]?.locked === true;
-        },
-        async release() {
-            await exec().query(SQL_ADVISORY_UNLOCK, [lockKey]);
-        },
-    };
-}
-//# sourceMappingURL=driver-pg.js.map

package/src/driver-pg.js.map

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

package/src/driver-redis.d.ts

@@ -1,7 +0,0 @@
-import type { JobDriver } from './driver';
-export interface RedisDriverOptions {
-    readonly url?: string;
-    readonly consumerGroup?: string;
-}
-export declare function createRedisDriver(_options?: RedisDriverOptions): JobDriver;
-//# sourceMappingURL=driver-redis.d.ts.map

package/src/driver-redis.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"driver-redis.d.ts","sourceRoot":"","sources":["driver-redis.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAKV,SAAS,EAGV,MAAM,UAAU,CAAC;AA4BlB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,kBAAuB,GAAG,SAAS,CAuB9E"}

package/src/driver-redis.js

@@ -1,54 +0,0 @@
-// Redis driver — interface-complete, not implemented. Honest stub: correct types so an app
-// can be written against it and `x verify` typechecks, with one labelled throw per method so
-// nobody discovers the gap from a silently-dropped job.
-//
-// Design it will implement when written: a per-queue Redis Stream with a consumer group
-// (XADD / XREADGROUP / XACK), `XAUTOCLAIM` for the visibility timeout, a ZSET for delayed
-// and suspended runs, and step records in a hash keyed by run id.
-import { JobsNotImplementedError } from './errors';
-const FIX = 'use driver: "pg" (default) or "memory" — see docs/jobs/drivers.md#redis';
-const unavailable = (method) => {
-    throw new JobsNotImplementedError({ feature: `redis jobs driver (${method})`, fix: FIX });
-};
-const redisStepStore = () => ({
-    get(_runId, _name) {
-        return unavailable('steps.get');
-    },
-    put(_record) {
-        return unavailable('steps.put');
-    },
-    list(_runId) {
-        return unavailable('steps.list');
-    },
-    del(_runId, _name) {
-        return unavailable('steps.del');
-    },
-    clear(_runId) {
-        return unavailable('steps.clear');
-    },
-});
-export function createRedisDriver(_options = {}) {
-    return {
-        name: 'redis',
-        steps: redisStepStore(),
-        enqueue(_request) {
-            return unavailable('enqueue');
-        },
-        claim(_options) {
-            return unavailable('claim');
-        },
-        ack(_jobId) {
-            return unavailable('ack');
-        },
-        nack(_jobId, _options) {
-            return unavailable('nack');
-        },
-        heartbeat(_jobId, _options) {
-            return unavailable('heartbeat');
-        },
-        stats() {
-            return unavailable('stats');
-        },
-    };
-}
-//# sourceMappingURL=driver-redis.js.map

package/src/driver-redis.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"driver-redis.js","sourceRoot":"","sources":["driver-redis.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,6FAA6F;AAC7F,wDAAwD;AACxD,EAAE;AACF,wFAAwF;AACxF,0FAA0F;AAC1F,kEAAkE;AAWlE,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGnD,MAAM,GAAG,GAAG,yEAAyE,CAAC;AAEtF,MAAM,WAAW,GAAG,CAAC,MAAc,EAAS,EAAE;IAC5C,MAAM,IAAI,uBAAuB,CAAC,EAAE,OAAO,EAAE,sBAAsB,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AAC5F,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,GAAc,EAAE,CAAC,CAAC;IACvC,GAAG,CAAC,MAAc,EAAE,KAAa;QAC/B,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,GAAG,CAAC,OAAmB;QACrB,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,MAAc;QACjB,OAAO,WAAW,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IACD,GAAG,CAAC,MAAc,EAAE,KAAa;QAC/B,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,KAAK,CAAC,MAAc;QAClB,OAAO,WAAW,CAAC,aAAa,CAAC,CAAC;IACpC,CAAC;CACF,CAAC,CAAC;AAOH,MAAM,UAAU,iBAAiB,CAAC,QAAQ,GAAuB,EAAE;IACjE,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,cAAc,EAAE;QACvB,OAAO,CAAC,QAAwB;YAC9B,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,CAAC,QAAsB;YAC1B,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QACD,GAAG,CAAC,MAAc;YAChB,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,MAAc,EAAE,QAAqB;YACxC,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,SAAS,CAAC,MAAc,EAAE,QAAkD;YAC1E,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;QACD,KAAK;YACH,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/src/driver.d.ts

@@ -1,114 +0,0 @@
-import type { StepStore } from './steps';
-export type JobState = 'ready' | 'delayed' | 'running' | 'suspended' | 'done' | 'failed' | 'dead';
-export interface JobRecord {
-    readonly id: string;
-    readonly name: string;
-    readonly queue: string;
-    readonly input: unknown;
-    /** Dedupe key from the job definition. At-least-once delivery leans on this. */
-    readonly idempotencyKey: string;
-    /** Stable across retries and suspensions — the key every step record hangs off. */
-    readonly runId: string;
-    readonly attempt: number;
-    readonly maxAttempts: number;
-    readonly state: JobState;
-    /** Epoch ms; the job is invisible until then. */
-    readonly runAt: number;
-    readonly createdAt: number;
-    readonly updatedAt: number;
-    /** Actor's orgId, for per-tenant limits. */
-    readonly tenantId?: string;
-    readonly lastError?: string;
-    readonly claimedBy?: string;
-    readonly visibleAt?: number;
-}
-export type ConflictPolicy = 'dedupe' | 'error';
-export interface EnqueueRequest {
-    readonly name: string;
-    readonly queue: string;
-    readonly input: unknown;
-    readonly idempotencyKey: string;
-    readonly maxAttempts: number;
-    /** Epoch ms. Omit for "now". */
-    readonly runAt?: number;
-    readonly tenantId?: string;
-    /** Reuse an existing run id when resuming, so step history is preserved. */
-    readonly runId?: string;
-    readonly onConflict?: ConflictPolicy;
-}
-export interface EnqueueResult {
-    readonly id: string;
-    readonly runId: string;
-    /** True when an in-flight job already held this idempotency key. */
-    readonly deduped: boolean;
-}
-export interface ClaimOptions {
-    readonly queues: readonly string[];
-    readonly limit: number;
-    /** Lease length. A worker that dies without ack makes the job claimable again after this. */
-    readonly visibilityTimeoutMs: number;
-    readonly workerId: string;
-}
-export interface ClaimedJob extends JobRecord {
-    readonly claimedAt: number;
-    readonly visibleAt: number;
-}
-export interface NackOptions {
-    /** Delay before the job becomes claimable again. */
-    readonly delayMs: number;
-    readonly error?: string;
-    /**
-     * False for a suspension (`step.sleep`): parking a run is not a failure and must not burn
-     * a retry attempt, or a 3-day sleep would dead-letter the job.
-     */
-    readonly countsAsAttempt?: boolean;
-    readonly deadLetter?: boolean;
-}
-export interface QueueStats {
-    readonly queue: string;
-    readonly ready: number;
-    readonly delayed: number;
-    readonly running: number;
-    readonly suspended: number;
-    readonly dead: number;
-    /** Age in ms of the oldest claimable job — the number that decides autoscaling. */
-    readonly oldestReadyMs: number;
-}
-export interface JobFilter {
-    readonly queue?: string;
-    readonly name?: string;
-    readonly state?: JobState;
-    readonly limit?: number;
-}
-/** Optional: powers `/_x` and the MCP tools. A minimal driver may omit it. */
-export interface JobIntrospection {
-    job(jobId: string): Promise<JobRecord | undefined>;
-    list(filter?: JobFilter): Promise<readonly JobRecord[]>;
-    deadLetters(limit?: number): Promise<readonly JobRecord[]>;
-    /** Re-queue a dead/failed job. `fromStep` drops step records from that step onward. */
-    requeue(jobId: string, options?: {
-        readonly fromStep?: string;
-    }): Promise<JobRecord>;
-}
-export interface JobDriver {
-    readonly name: string;
-    /** Step persistence lives with the queue: one store, one transaction boundary. */
-    readonly steps: StepStore;
-    enqueue(request: EnqueueRequest): Promise<EnqueueResult>;
-    claim(options: ClaimOptions): Promise<readonly ClaimedJob[]>;
-    ack(jobId: string): Promise<void>;
-    nack(jobId: string, options: NackOptions): Promise<void>;
-    /** Extends the lease of a long-running job so it is not double-claimed. */
-    heartbeat(jobId: string, options: {
-        readonly visibilityTimeoutMs: number;
-    }): Promise<void>;
-    stats(): Promise<readonly QueueStats[]>;
-    readonly introspect?: JobIntrospection;
-    close?(): Promise<void>;
-}
-export declare const DEFAULT_QUEUE = "default";
-export declare const DEFAULT_VISIBILITY_TIMEOUT_MS = 30000;
-/** Set once at boot from `app.config.ts`. Roles share one driver instance per process. */
-export declare function setJobDriver(driver: JobDriver): void;
-export declare function jobDriver(): JobDriver | undefined;
-//# sourceMappingURL=driver.d.ts.map

package/src/driver.d.ts.map

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

package/src/driver.js

@@ -1,14 +0,0 @@
-// The queue contract. Every driver (pg, memory, redis, nats) implements exactly this, so
-// switching backends is a config line and ZERO job-code change. Six methods and no more:
-// claim/ack/nack with a visibility timeout is the smallest set that survives a worker crash.
-export const DEFAULT_QUEUE = 'default';
-export const DEFAULT_VISIBILITY_TIMEOUT_MS = 30_000;
-let ambient;
-/** Set once at boot from `app.config.ts`. Roles share one driver instance per process. */
-export function setJobDriver(driver) {
-    ambient = driver;
-}
-export function jobDriver() {
-    return ambient;
-}
-//# sourceMappingURL=driver.js.map

package/src/driver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"driver.js","sourceRoot":"","sources":["driver.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,yFAAyF;AACzF,6FAA6F;AAuH7F,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AAEpD,IAAI,OAA8B,CAAC;AAEnC,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/src/errors.d.ts

@@ -1,63 +0,0 @@
-import { UltimateError } from '@ultimat3/core';
-export declare const JOB_ERROR_CODES: readonly ['X_JOB_DUPLICATE', 'X_STEP_DUPLICATE', 'X_JOB_TIMEOUT', 'X_JOB_MAX_ATTEMPTS', 'X_DRIVER_UNAVAILABLE', 'X_IDEMPOTENCY_REQUIRED', 'X_OUTBOX_NO_TX', 'X_NOT_IMPLEMENTED'];
-export type JobErrorCode = (typeof JOB_ERROR_CODES)[number];
-/** An enqueue collided with a live job holding the same idempotency key under `onConflict: 'error'`. */
-export declare class JobDuplicateError extends UltimateError {
-    constructor(input: {
-        job: string;
-        idempotencyKey: string;
-        existingId: string;
-    });
-}
-/** Two steps in one run share a name, so replay cannot tell their persisted results apart. */
-export declare class StepDuplicateError extends UltimateError {
-    constructor(input: {
-        job: string;
-        step: string;
-    });
-}
-export declare class JobTimeoutError extends UltimateError {
-    constructor(input: {
-        job: string;
-        timeoutMs: number;
-        step?: string;
-    });
-}
-/** Retries exhausted. The job is in the dead-letter queue, not lost. */
-export declare class JobMaxAttemptsError extends UltimateError {
-    constructor(input: {
-        job: string;
-        jobId: string;
-        attempts: number;
-        lastError: string;
-    });
-}
-export declare class DriverUnavailableError extends UltimateError {
-    constructor(input: {
-        driver: string;
-        cause: string;
-        fix: string;
-    });
-}
-/**
- * The type signature already requires `idempotencyKey`; this is the runtime backstop for
- * generated code and JS callers, so the guarantee holds at both ends.
- */
-export declare class IdempotencyRequiredError extends UltimateError {
-    constructor(input: {
-        job: string;
-    });
-}
-/** An outbox enqueue happened with no ambient transaction to join. */
-export declare class OutboxNoTxError extends UltimateError {
-    constructor(input: {
-        job: string;
-    });
-}
-export declare class JobsNotImplementedError extends UltimateError {
-    constructor(input: {
-        feature: string;
-        fix: string;
-    });
-}
-//# sourceMappingURL=errors.d.ts.map

package/src/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["errors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,eAAO,MAAM,eAAe,YAC1B,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,CACX,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAI5D,wGAAwG;AACxG,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,YAAY,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAO7E;CACF;AAED,8FAA8F;AAC9F,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,YAAY,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAO/C;CACF;AAED,qBAAa,eAAgB,SAAQ,aAAa;IAChD,YAAY,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAUnE;CACF;AAED,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,YAAY,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAOrF;CACF;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,YAAY,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAOhE;CACF;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,YAAY,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EAOjC;CACF;AAED,sEAAsE;AACtE,qBAAa,eAAgB,SAAQ,aAAa;IAChD,YAAY,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EAOjC;CACF;AAED,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,YAAY,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAOlD;CACF"}

package/src/errors.js

@@ -1,105 +0,0 @@
-// The X_* codes owned by @ultimat3/jobs. Every one names the command or code change that
-// fixes it — a job failure an agent cannot act on is a job failure that gets retried forever.
-import { UltimateError } from '@ultimat3/core';
-export const JOB_ERROR_CODES = [
-    'X_JOB_DUPLICATE',
-    'X_STEP_DUPLICATE',
-    'X_JOB_TIMEOUT',
-    'X_JOB_MAX_ATTEMPTS',
-    'X_DRIVER_UNAVAILABLE',
-    'X_IDEMPOTENCY_REQUIRED',
-    'X_OUTBOX_NO_TX',
-    'X_NOT_IMPLEMENTED',
-];
-const docsFor = (code) => `https://ultimate.dev/errors/${code}`;
-/** An enqueue collided with a live job holding the same idempotency key under `onConflict: 'error'`. */
-export class JobDuplicateError extends UltimateError {
-    constructor(input) {
-        super({
-            code: 'X_JOB_DUPLICATE',
-            cause: `job "${input.job}" already queued as ${input.existingId} with idempotencyKey "${input.idempotencyKey}"`,
-            fix: 'pass onConflict: "dedupe" to enqueue, or make idempotencyKey narrower',
-            docs: docsFor('X_JOB_DUPLICATE'),
-        });
-    }
-}
-/** Two steps in one run share a name, so replay cannot tell their persisted results apart. */
-export class StepDuplicateError extends UltimateError {
-    constructor(input) {
-        super({
-            code: 'X_STEP_DUPLICATE',
-            cause: `job "${input.job}" used step name "${input.step}" twice in one run`,
-            fix: `rename one of them, e.g. step.run('${input.step}-2', ...) — step names are the replay key`,
-            docs: docsFor('X_STEP_DUPLICATE'),
-        });
-    }
-}
-export class JobTimeoutError extends UltimateError {
-    constructor(input) {
-        super({
-            code: 'X_JOB_TIMEOUT',
-            cause: input.step === undefined
-                ? `job "${input.job}" exceeded its ${input.timeoutMs}ms timeout`
-                : `job "${input.job}" step "${input.step}" exceeded its ${input.timeoutMs}ms timeout`,
-            fix: `raise timeout on the job definition, or split the work into step.run() calls`,
-            docs: docsFor('X_JOB_TIMEOUT'),
-        });
-    }
-}
-/** Retries exhausted. The job is in the dead-letter queue, not lost. */
-export class JobMaxAttemptsError extends UltimateError {
-    constructor(input) {
-        super({
-            code: 'X_JOB_MAX_ATTEMPTS',
-            cause: `job "${input.job}" failed ${input.attempts} times, last error: ${input.lastError}`,
-            fix: `x jobs retry ${input.jobId}`,
-            docs: docsFor('X_JOB_MAX_ATTEMPTS'),
-        });
-    }
-}
-export class DriverUnavailableError extends UltimateError {
-    constructor(input) {
-        super({
-            code: 'X_DRIVER_UNAVAILABLE',
-            cause: `jobs driver "${input.driver}" is unavailable: ${input.cause}`,
-            fix: input.fix,
-            docs: docsFor('X_DRIVER_UNAVAILABLE'),
-        });
-    }
-}
-/**
- * The type signature already requires `idempotencyKey`; this is the runtime backstop for
- * generated code and JS callers, so the guarantee holds at both ends.
- */
-export class IdempotencyRequiredError extends UltimateError {
-    constructor(input) {
-        super({
-            code: 'X_IDEMPOTENCY_REQUIRED',
-            cause: `job "${input.job}" has no idempotencyKey — at-least-once delivery would run it twice`,
-            fix: `add idempotencyKey: (input) => \`${input.job}:\${input.id}\` to the job definition`,
-            docs: docsFor('X_IDEMPOTENCY_REQUIRED'),
-        });
-    }
-}
-/** An outbox enqueue happened with no ambient transaction to join. */
-export class OutboxNoTxError extends UltimateError {
-    constructor(input) {
-        super({
-            code: 'X_OUTBOX_NO_TX',
-            cause: `ctx.jobs.enqueue(${input.job}) ran outside a transaction with outbox: 'required'`,
-            fix: 'wrap the call in ctx.tx(async (tx) => ...), or enqueue with { outbox: false }',
-            docs: docsFor('X_OUTBOX_NO_TX'),
-        });
-    }
-}
-export class JobsNotImplementedError extends UltimateError {
-    constructor(input) {
-        super({
-            code: 'X_NOT_IMPLEMENTED',
-            cause: `${input.feature} is declared but not implemented in @ultimat3/jobs`,
-            fix: input.fix,
-            docs: docsFor('X_NOT_IMPLEMENTED'),
-        });
-    }
-}
-//# sourceMappingURL=errors.js.map

package/src/errors.js.map

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