@relkit/providers-local 0.0.0

package/dist/jobs/admin.js

@@ -0,0 +1,89 @@
+import { randomUUID } from "node:crypto";
+import { normalizeId } from "@relkit/contracts";
+import { JobAdminError } from "./admin-errors.js";
+import { JOB_ADMIN_PROTOCOL, JOB_ADMIN_VERSION, } from "./admin-contracts.js";
+import { afterCursor, assertMode, assertVersion, cursor, failureFor, makeRecord, matches, pageLimit, readReason, recordAction, safeError, safeId, safeReason, toStatus, validateQuery, versioned, } from "./admin-utils.js";
+export * from "./admin-contracts.js";
+export { JobAdminError } from "./admin-errors.js";
+/** Exposes versioned local job inspection and explicitly audited mutations. */
+export function createJobAdmin(queue, options = {}) {
+    const mode = options.environment ?? options.mode ?? "development";
+    assertMode(mode);
+    const enabled = options.enabled ?? mode !== "production";
+    const records = [];
+    const status = (instanceId) => {
+        const entry = queue.get(normalizeId(instanceId));
+        return entry === undefined ? undefined : toStatus(entry);
+    };
+    const query = (request = {}) => {
+        assertVersion(request);
+        validateQuery(request);
+        const entries = queue
+            .snapshot()
+            .filter((entry) => matches(entry, request))
+            .filter((entry) => afterCursor(entry, request.cursor));
+        const limit = pageLimit(request.limit);
+        const page = entries.slice(0, limit).map(toStatus);
+        const next = entries.length > limit ? entries[limit - 1] : undefined;
+        return versioned({
+            items: Object.freeze(page),
+            counts: queue.counts(),
+            ...(next === undefined ? {} : { nextCursor: cursor(next) }),
+        });
+    };
+    const actions = () => Object.freeze([...records]);
+    const run = (action, request) => applyAction(action, request, {
+        queue,
+        mode,
+        enabled,
+        now: options.now ?? Date.now,
+        createActionId: options.createActionId ?? randomUUID,
+        ...(options.onAction === undefined ? {} : { onAction: options.onAction }),
+        records,
+    });
+    return Object.freeze({
+        protocol: JOB_ADMIN_PROTOCOL,
+        version: JOB_ADMIN_VERSION,
+        status,
+        query,
+        retry: (request) => run("retry", request),
+        cancel: (request) => run("cancel", request),
+        deadLetter: (request) => run("dead-letter", request),
+        actions,
+    });
+}
+async function applyAction(action, input, options) {
+    const request = typeof input === "string" ? { instanceId: input } : input;
+    const instanceId = safeId(request?.instanceId);
+    const actionId = safeId(options.createActionId()) ?? "invalid-action";
+    const requestedAt = options.now();
+    const before = instanceId === undefined ? undefined : options.queue.get(instanceId);
+    try {
+        assertVersion(request);
+        const reason = readReason(request);
+        if (!options.enabled || options.mode === "production")
+            throw new JobAdminError("RELKIT_JOB_ADMIN_MUTATION_DISABLED", "Local job mutations are disabled");
+        if (instanceId === undefined)
+            throw new JobAdminError("RELKIT_JOB_ADMIN_INSTANCE_INVALID", "Job instance ID is invalid");
+        if (before === undefined)
+            throw new JobAdminError("RELKIT_JOB_ADMIN_NOT_FOUND", `Job ${instanceId} is unknown`);
+        if (action === "retry") {
+            if (before.state !== "dead-lettered")
+                throw new JobAdminError("RELKIT_JOB_ADMIN_STATE_INELIGIBLE", "Only dead-lettered jobs can be retried");
+        }
+        else if (before.state === "completed" || before.state === "dead-lettered") {
+            throw new JobAdminError("RELKIT_JOB_ADMIN_STATE_INELIGIBLE", "Job state cannot be changed by this action");
+        }
+        const after = action === "retry"
+            ? await options.queue.adminRetry(instanceId)
+            : await options.queue.adminDeadLetter(instanceId, failureFor(action));
+        const record = await recordAction(options, makeRecord(action, actionId, instanceId, requestedAt, "applied", options.mode, before, after, undefined, reason));
+        return versioned({ action, status: toStatus(after), record });
+    }
+    catch (cause) {
+        const error = safeError(cause);
+        const record = await recordAction(options, makeRecord(action, actionId, instanceId ?? "invalid", requestedAt, "rejected", options.mode, before, undefined, error.code, safeReason(request)));
+        throw Object.assign(error, { action: record });
+    }
+}
+//# sourceMappingURL=admin.js.map

package/dist/jobs/admin.js.map

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

package/dist/jobs/cron.d.ts

@@ -0,0 +1,10 @@
+export interface CronScheduleOptions {
+    readonly timezone: string;
+    readonly currentDate: Date;
+}
+/**
+ * Returns the next fire time while keeping the parser and its date type
+ * private to the local job provider.
+ */
+export declare function nextCronFire(expression: string, options: CronScheduleOptions): Date;
+//# sourceMappingURL=cron.d.ts.map

package/dist/jobs/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/jobs/cron.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAOnF"}

package/dist/jobs/cron.js

@@ -0,0 +1,18 @@
+import { CronExpressionParser } from "cron-parser";
+/**
+ * Returns the next fire time while keeping the parser and its date type
+ * private to the local job provider.
+ */
+export function nextCronFire(expression, options) {
+    const schedule = CronExpressionParser.parse(withSeconds(expression), {
+        currentDate: options.currentDate,
+        strict: true,
+        tz: options.timezone,
+    });
+    return schedule.next().toDate();
+}
+function withSeconds(expression) {
+    const trimmed = expression.trim();
+    return trimmed.split(/\s+/).length === 5 ? `0 ${trimmed}` : trimmed;
+}
+//# sourceMappingURL=cron.js.map

package/dist/jobs/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","sourceRoot":"","sources":["../../src/jobs/cron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAOnD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,OAA4B;IAC3E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE;QACnE,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,OAAO,CAAC,QAAQ;KACrB,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAClC,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACtE,CAAC"}

package/dist/jobs/idempotency.d.ts

@@ -0,0 +1,18 @@
+import type { JsonValue } from "@relkit/contracts";
+import { type JobIdempotencyDefinition, type JobIdempotencyRecord, type JobQueueAcceptance, type JobQueueEntry } from "./queue-utils.js";
+export interface IdempotencyPreparation {
+    readonly record?: JobIdempotencyRecord;
+    readonly duplicate?: JobQueueAcceptance;
+}
+/** Validates the static idempotency policy supplied by a job descriptor. */
+export declare function validateIdempotencyDefinition(value: unknown): JobIdempotencyDefinition;
+/** Extracts and validates the non-empty string value used as a job idempotency key. */
+export declare function extractIdempotencyRecord(input: JsonValue, definition: JobIdempotencyDefinition, acceptedAt: number): JobIdempotencyRecord;
+/** Validates the compact durable record stored alongside its accepted job. */
+export declare function assertIdempotencyRecord(value: JobIdempotencyRecord): void;
+export declare function readIdempotencyRecord(value: JsonValue | undefined): JobIdempotencyRecord | undefined;
+/** Finds the oldest still-retained acceptance for a key. Expired records are ignored. */
+export declare function findActiveIdempotency(entries: Iterable<JobQueueEntry>, key: string, now: number): JobQueueEntry | undefined;
+export declare function prepareIdempotency(input: JsonValue, definition: JobIdempotencyDefinition | undefined, entries: Iterable<JobQueueEntry>, now: number, acceptedAt: number): IdempotencyPreparation;
+export declare function acceptance(entry: JobQueueEntry, duplicate: boolean): JobQueueAcceptance;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/jobs/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/jobs/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAQtF;AAED,uFAAuF;AACvF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,wBAAwB,EACpC,UAAU,EAAE,MAAM,GACjB,oBAAoB,CActB;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CASzE;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,GAAG,SAAS,GAC3B,oBAAoB,GAAG,SAAS,CAMlC;AAED,yFAAyF;AACzF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,aAAa,GAAG,SAAS,CAQ3B;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,wBAAwB,GAAG,SAAS,EAChD,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAKxB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,GAAG,kBAAkB,CAYvF"}

package/dist/jobs/idempotency.js

@@ -0,0 +1,82 @@
+import { assertTime, JobQueueStateError, } from "./queue-utils.js";
+/** Validates the static idempotency policy supplied by a job descriptor. */
+export function validateIdempotencyDefinition(value) {
+    if (!isRecord(value))
+        throw new JobQueueStateError("Idempotency definition is invalid");
+    if (typeof value.key !== "string" || value.key.trim() === "")
+        throw new JobQueueStateError("Idempotency key field is required");
+    const retentionMs = value.retentionMs;
+    if (typeof retentionMs !== "number" || !Number.isSafeInteger(retentionMs) || retentionMs < 1)
+        throw new JobQueueStateError("Idempotency retention must be a positive integer");
+    return Object.freeze({ key: value.key.trim(), retentionMs });
+}
+/** Extracts and validates the non-empty string value used as a job idempotency key. */
+export function extractIdempotencyRecord(input, definition, acceptedAt) {
+    const policy = validateIdempotencyDefinition(definition);
+    assertTime(acceptedAt, "accepted time");
+    if (input === null || typeof input !== "object" || Array.isArray(input))
+        throw new JobQueueStateError("Idempotency input must be an object");
+    const record = input;
+    if (!Object.prototype.hasOwnProperty.call(record, policy.key))
+        throw new JobQueueStateError(`Idempotency input is missing "${policy.key}"`);
+    const value = record[policy.key];
+    if (typeof value !== "string" || value.trim() === "")
+        throw new JobQueueStateError(`Idempotency input "${policy.key}" must be non-empty text`);
+    if (policy.retentionMs > Number.MAX_SAFE_INTEGER - acceptedAt)
+        throw new JobQueueStateError("Idempotency expiry is invalid");
+    return Object.freeze({ key: value.trim(), expiresAt: acceptedAt + policy.retentionMs });
+}
+/** Validates the compact durable record stored alongside its accepted job. */
+export function assertIdempotencyRecord(value) {
+    if (typeof value.key !== "string" ||
+        value.key.trim() === "" ||
+        value.key !== value.key.trim() ||
+        !Number.isSafeInteger(value.expiresAt) ||
+        value.expiresAt < 1)
+        throw new JobQueueStateError("Job idempotency record is invalid");
+}
+export function readIdempotencyRecord(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        throw new JobQueueStateError("Job idempotency record is invalid");
+    const record = value;
+    assertIdempotencyRecord(record);
+    return record;
+}
+/** Finds the oldest still-retained acceptance for a key. Expired records are ignored. */
+export function findActiveIdempotency(entries, key, now) {
+    assertTime(now, "idempotency time");
+    let match;
+    for (const entry of entries) {
+        if (entry.idempotency?.key !== key || entry.idempotency.expiresAt <= now)
+            continue;
+        if (match === undefined || entry.order < match.order)
+            match = entry;
+    }
+    return match;
+}
+export function prepareIdempotency(input, definition, entries, now, acceptedAt) {
+    if (definition === undefined)
+        return {};
+    const record = extractIdempotencyRecord(input, definition, acceptedAt);
+    const duplicate = findActiveIdempotency(entries, record.key, now);
+    return duplicate === undefined ? { record } : { duplicate: acceptance(duplicate, true) };
+}
+export function acceptance(entry, duplicate) {
+    return Object.freeze({
+        ...entry,
+        accepted: true,
+        duplicate,
+        ...(entry.idempotency === undefined
+            ? {}
+            : {
+                idempotencyKey: entry.idempotency.key,
+                idempotencyExpiresAt: entry.idempotency.expiresAt,
+            }),
+    });
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/jobs/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../src/jobs/idempotency.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,kBAAkB,GAKnB,MAAM,kBAAkB,CAAC;AAO1B,4EAA4E;AAC5E,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,kBAAkB,CAAC,mCAAmC,CAAC,CAAC;IACxF,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAC1D,MAAM,IAAI,kBAAkB,CAAC,mCAAmC,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC;QAC1F,MAAM,IAAI,kBAAkB,CAAC,kDAAkD,CAAC,CAAC;IACnF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,wBAAwB,CACtC,KAAgB,EAChB,UAAoC,EACpC,UAAkB;IAElB,MAAM,MAAM,GAAG,6BAA6B,CAAC,UAAU,CAAC,CAAC;IACzD,UAAU,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrE,MAAM,IAAI,kBAAkB,CAAC,qCAAqC,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,KAA8C,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;QAC3D,MAAM,IAAI,kBAAkB,CAAC,iCAAiC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAClD,MAAM,IAAI,kBAAkB,CAAC,sBAAsB,MAAM,CAAC,GAAG,0BAA0B,CAAC,CAAC;IAC3F,IAAI,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,gBAAgB,GAAG,UAAU;QAC3D,MAAM,IAAI,kBAAkB,CAAC,+BAA+B,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB,CAAC,KAA2B;IACjE,IACE,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QACvB,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;QAC9B,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC;QACtC,KAAK,CAAC,SAAS,GAAG,CAAC;QAEnB,MAAM,IAAI,kBAAkB,CAAC,mCAAmC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAA4B;IAE5B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,kBAAkB,CAAC,mCAAmC,CAAC,CAAC;IACxF,MAAM,MAAM,GAAG,KAAwC,CAAC;IACxD,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,qBAAqB,CACnC,OAAgC,EAChC,GAAW,EACX,GAAW;IAEX,UAAU,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IACpC,IAAI,KAAgC,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,SAAS,IAAI,GAAG;YAAE,SAAS;QACnF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;YAAE,KAAK,GAAG,KAAK,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAgB,EAChB,UAAgD,EAChD,OAAgC,EAChC,GAAW,EACX,UAAkB;IAElB,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAoB,EAAE,SAAkB;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,KAAK;QACR,QAAQ,EAAE,IAAa;QACvB,SAAS;QACT,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS;YACjC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG;gBACrC,oBAAoB,EAAE,KAAK,CAAC,WAAW,CAAC,SAAS;aAClD,CAAC;KACP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/jobs/lease-utils.d.ts

@@ -0,0 +1,9 @@
+import type { JobQueueEntry, JobQueueLeaseOptions, JobQueueTransitionOptions } from "./queue-utils.js";
+export declare const DEFAULT_LEASE_DURATION_MS = 30000;
+export declare function normalizeOwnerToken(value: string): string;
+export declare function resolveLeaseExpiry(now: number, defaultDurationMs: number, options: JobQueueLeaseOptions): number;
+export declare function leaseTransitionOptions(now: number, defaultDurationMs: number, options: JobQueueLeaseOptions, ownerToken: string): JobQueueTransitionOptions;
+export declare function assertLeaseDuration(value: number): void;
+export declare function assertLeaseOwner(entry: JobQueueEntry, ownerToken: string): void;
+export declare function isLeaseExpired(entry: JobQueueEntry, now: number): boolean;
+//# sourceMappingURL=lease-utils.d.ts.map

package/dist/jobs/lease-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-utils.d.ts","sourceRoot":"","sources":["../../src/jobs/lease-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAKR;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,MAAM,GACjB,yBAAyB,CAK3B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGvD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAG/E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAIzE"}

package/dist/jobs/lease-utils.js

@@ -0,0 +1,31 @@
+import { normalizeId } from "@relkit/contracts";
+import { assertTime, JobQueueStateError } from "./queue-utils.js";
+export const DEFAULT_LEASE_DURATION_MS = 30_000;
+export function normalizeOwnerToken(value) {
+    return normalizeId(value);
+}
+export function resolveLeaseExpiry(now, defaultDurationMs, options) {
+    const expiresAt = options.leaseExpiresAt ?? now + (options.leaseDurationMs ?? defaultDurationMs);
+    assertTime(expiresAt, "lease expiry");
+    if (expiresAt <= now)
+        throw new JobQueueStateError("Lease expiry must be in the future");
+    return expiresAt;
+}
+export function leaseTransitionOptions(now, defaultDurationMs, options, ownerToken) {
+    return {
+        leaseExpiresAt: resolveLeaseExpiry(now, defaultDurationMs, options),
+        leaseOwner: ownerToken,
+    };
+}
+export function assertLeaseDuration(value) {
+    if (!Number.isSafeInteger(value) || value <= 0)
+        throw new JobQueueStateError("Lease duration is invalid");
+}
+export function assertLeaseOwner(entry, ownerToken) {
+    if (entry.leaseOwner !== ownerToken)
+        throw new JobQueueStateError(`Job ${entry.instanceId} is owned by another process`);
+}
+export function isLeaseExpired(entry, now) {
+    return (entry.state === "leased" && entry.leaseExpiresAt !== undefined && entry.leaseExpiresAt <= now);
+}
+//# sourceMappingURL=lease-utils.js.map

package/dist/jobs/lease-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-utils.js","sourceRoot":"","sources":["../../src/jobs/lease-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAOlE,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,iBAAyB,EACzB,OAA6B;IAE7B,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,iBAAiB,CAAC,CAAC;IACjG,UAAU,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACtC,IAAI,SAAS,IAAI,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,oCAAoC,CAAC,CAAC;IACzF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,GAAW,EACX,iBAAyB,EACzB,OAA6B,EAC7B,UAAkB;IAElB,OAAO;QACL,cAAc,EAAE,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,CAAC;QACnE,UAAU,EAAE,UAAU;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAC5C,MAAM,IAAI,kBAAkB,CAAC,2BAA2B,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAoB,EAAE,UAAkB;IACvE,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU;QACjC,MAAM,IAAI,kBAAkB,CAAC,OAAO,KAAK,CAAC,UAAU,8BAA8B,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAoB,EAAE,GAAW;IAC9D,OAAO,CACL,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,cAAc,IAAI,GAAG,CAC9F,CAAC;AACJ,CAAC"}

package/dist/jobs/queue-admin.d.ts

@@ -0,0 +1,12 @@
+import type { JobStore } from "./store.js";
+import { type JobFailureMetadata, type JobQueueAdminRetryOptions, type JobQueueEntry } from "./queue-utils.js";
+export interface JobQueueAdminMutations {
+    readonly adminRetry: (instanceId: string, options?: JobQueueAdminRetryOptions) => Promise<JobQueueEntry>;
+    readonly adminDeadLetter: (instanceId: string, failure: JobFailureMetadata) => Promise<JobQueueEntry>;
+}
+/** Adds explicit administrative transitions without changing worker transitions. */
+export declare function createJobQueueAdminMutations(store: JobStore, entries: Map<string, JobQueueEntry>, options: {
+    readonly clock: () => number;
+    readonly serialize: <T>(work: () => Promise<T>) => Promise<T>;
+}): JobQueueAdminMutations;
+//# sourceMappingURL=queue-admin.d.ts.map

package/dist/jobs/queue-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-admin.d.ts","sourceRoot":"","sources":["../../src/jobs/queue-admin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,yBAAyB,KAChC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,CACxB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,KACxB,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B;AAED,oFAAoF;AACpF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,OAAO,EAAE;IACP,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/D,GACA,sBAAsB,CAsCxB"}

package/dist/jobs/queue-admin.js

@@ -0,0 +1,42 @@
+import { normalizeId } from "@relkit/contracts";
+import { nextEntry, persist } from "./queue-entry.js";
+import { recoverQueueEntries } from "./queue-recovery.js";
+import { assertTime, JobQueueStateError, } from "./queue-utils.js";
+/** Adds explicit administrative transitions without changing worker transitions. */
+export function createJobQueueAdminMutations(store, entries, options) {
+    const adminRetry = (instanceId, retryOptions = {}) => options.serialize(async () => {
+        const time = options.clock();
+        assertTime(time, "admin retry time");
+        await recoverQueueEntries(store, entries, time, false, options.clock);
+        const current = getEntry(entries, instanceId);
+        if (current.state !== "dead-lettered")
+            throw new JobQueueStateError(`Job ${current.instanceId} is not dead-lettered`);
+        const availableAt = retryOptions.availableAt ?? time;
+        assertTime(availableAt, "admin retry availability time");
+        const next = nextEntry(current, "available", { availableAt, attempt: 0 }, options.clock);
+        await persist(store, next);
+        entries.set(current.instanceId, next);
+        return next;
+    });
+    const adminDeadLetter = (instanceId, failure) => options.serialize(async () => {
+        const time = options.clock();
+        assertTime(time, "admin dead-letter time");
+        await recoverQueueEntries(store, entries, time, false, options.clock);
+        const current = getEntry(entries, instanceId);
+        if (current.state === "completed" || current.state === "dead-lettered")
+            throw new JobQueueStateError(`Job ${current.instanceId} is terminal`);
+        const next = nextEntry(current, "dead-lettered", { failure }, options.clock);
+        await persist(store, next);
+        entries.set(current.instanceId, next);
+        return next;
+    });
+    return { adminRetry, adminDeadLetter };
+}
+function getEntry(entries, instanceId) {
+    const normalized = normalizeId(instanceId);
+    const entry = entries.get(normalized);
+    if (entry === undefined)
+        throw new JobQueueStateError(`Job ${normalized} is unknown`);
+    return entry;
+}
+//# sourceMappingURL=queue-admin.js.map

package/dist/jobs/queue-admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-admin.js","sourceRoot":"","sources":["../../src/jobs/queue-admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,UAAU,EACV,kBAAkB,GAInB,MAAM,kBAAkB,CAAC;AAa1B,oFAAoF;AACpF,MAAM,UAAU,4BAA4B,CAC1C,KAAe,EACf,OAAmC,EACnC,OAGC;IAED,MAAM,UAAU,GAAG,CACjB,UAAkB,EAClB,eAA0C,EAAE,EACpB,EAAE,CAC1B,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QACrC,MAAM,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,KAAK,KAAK,eAAe;YACnC,MAAM,IAAI,kBAAkB,CAAC,OAAO,OAAO,CAAC,UAAU,uBAAuB,CAAC,CAAC;QACjF,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,IAAI,IAAI,CAAC;QACrD,UAAU,CAAC,WAAW,EAAE,+BAA+B,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACzF,MAAM,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEL,MAAM,eAAe,GAAG,CACtB,UAAkB,EAClB,OAA2B,EACH,EAAE,CAC1B,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;QAC3C,MAAM,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,IAAI,OAAO,CAAC,KAAK,KAAK,eAAe;YACpE,MAAM,IAAI,kBAAkB,CAAC,OAAO,OAAO,CAAC,UAAU,cAAc,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7E,MAAM,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEL,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,OAAmC,EAAE,UAAkB;IACvE,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,kBAAkB,CAAC,OAAO,UAAU,aAAa,CAAC,CAAC;IACtF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/jobs/queue-entry.d.ts

@@ -0,0 +1,8 @@
+import { type JsonValue } from "@relkit/contracts";
+import type { JobRecord, JobStore } from "./store.js";
+import { type JobIdempotencyRecord, type JobQueueEntry, type JobFailureMetadata, type JobQueueState, type JobQueueTransitionOptions } from "./queue-utils.js";
+export declare function persist(store: JobStore, entry: JobQueueEntry): Promise<void>;
+export declare function nextEntry(current: JobQueueEntry, state: JobQueueState, options: JobQueueTransitionOptions, clock: () => number): JobQueueEntry;
+export declare function makeEntry(instanceId: string, state: JobQueueState, input: JsonValue, profile: string, acceptedAt: number, order: number, attempt: number, availableAt?: number, leaseExpiresAt?: number, leaseOwner?: string, idempotency?: JobIdempotencyRecord, failure?: JobFailureMetadata): JobQueueEntry;
+export declare function readEntry(record: JobRecord): JobQueueEntry | undefined;
+//# sourceMappingURL=queue-entry.d.ts.map

package/dist/jobs/queue-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-entry.d.ts","sourceRoot":"","sources":["../../src/jobs/queue-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,yBAAyB,EAC/B,MAAM,kBAAkB,CAAC;AAE1B,wBAAsB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,MAAM,MAAM,GAClB,aAAa,CA4Cf;AAED,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,EACvB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,oBAAoB,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAwBf;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CA2BtE"}

package/dist/jobs/queue-entry.js

@@ -0,0 +1,130 @@
+import { canonicalJson, deepFreeze, normalizeId } from "@relkit/contracts";
+import { assertIdempotencyRecord, readIdempotencyRecord } from "./idempotency.js";
+import { JOB_QUEUE_STATES, JobQueueStateError, assertTime, } from "./queue-utils.js";
+export async function persist(store, entry) {
+    await store.append({ instanceId: entry.instanceId, kind: entry.state, data: encode(entry) });
+}
+export function nextEntry(current, state, options, clock) {
+    const attempt = options.attempt ?? current.attempt;
+    if (!Number.isSafeInteger(attempt) || attempt < 0)
+        throw new JobQueueStateError("Attempt is invalid");
+    if (state === "delayed" && options.availableAt === undefined)
+        throw new JobQueueStateError("Delayed jobs require an available time");
+    if (state === "leased" && options.leaseExpiresAt === undefined)
+        throw new JobQueueStateError("Leased jobs require an expiry");
+    if (state === "leased" && options.availableAt !== undefined)
+        throw new JobQueueStateError("Leased jobs cannot have an available time");
+    if ((state === "completed" || state === "dead-lettered") &&
+        (options.availableAt !== undefined || options.leaseExpiresAt !== undefined))
+        throw new JobQueueStateError("Terminal jobs cannot retain lease metadata");
+    const availableAt = state === "available"
+        ? (options.availableAt ?? clock())
+        : state === "delayed"
+            ? options.availableAt
+            : undefined;
+    const leaseExpiresAt = state === "leased" ? options.leaseExpiresAt : undefined;
+    const leaseOwner = state === "leased" ? optionalOwner(options.leaseOwner) : undefined;
+    const failure = state === "delayed" || state === "dead-lettered"
+        ? (options.failure ?? current.failure)
+        : undefined;
+    const idempotency = current.idempotency;
+    if (availableAt !== undefined)
+        assertTime(availableAt, "available time");
+    if (leaseExpiresAt !== undefined)
+        assertTime(leaseExpiresAt, "lease expiry");
+    return makeEntry(current.instanceId, state, current.input, current.profile, current.acceptedAt, current.order, attempt, availableAt, leaseExpiresAt, leaseOwner, idempotency, failure);
+}
+export function makeEntry(instanceId, state, input, profile, acceptedAt, order, attempt, availableAt, leaseExpiresAt, leaseOwner, idempotency, failure) {
+    assertTime(acceptedAt, "accepted time");
+    if (!Number.isSafeInteger(order) || order < 1)
+        throw new JobQueueStateError("Queue order is invalid");
+    if (!Number.isSafeInteger(attempt) || attempt < 0)
+        throw new JobQueueStateError("Attempt is invalid");
+    if (failure !== undefined)
+        assertFailure(failure);
+    if (idempotency !== undefined)
+        assertIdempotencyRecord(idempotency);
+    return deepFreeze({
+        instanceId: normalizeId(instanceId),
+        state,
+        input: JSON.parse(canonicalJson(input)),
+        profile: normalizeId(profile),
+        attempt,
+        acceptedAt,
+        order,
+        ...(availableAt === undefined ? {} : { availableAt }),
+        ...(leaseOwner === undefined ? {} : { leaseOwner: normalizeId(leaseOwner) }),
+        ...(leaseExpiresAt === undefined ? {} : { leaseExpiresAt }),
+        ...(idempotency === undefined ? {} : { idempotency: { ...idempotency } }),
+        ...(failure === undefined
+            ? {}
+            : { failure: JSON.parse(canonicalJson(failure)) }),
+    });
+}
+export function readEntry(record) {
+    if (!isState(record.kind))
+        return undefined;
+    if (!isRecord(record.data))
+        throw new JobQueueStateError(`Job ${record.instanceId} data is invalid`);
+    const data = record.data;
+    if (data.input === undefined ||
+        data.profile === undefined ||
+        data.acceptedAt === undefined ||
+        data.attempt === undefined ||
+        data.order === undefined)
+        throw new JobQueueStateError(`Job ${record.instanceId} data is incomplete`);
+    return makeEntry(record.instanceId, record.kind, data.input, normalizeId(data.profile), numberValue(data.acceptedAt, "accepted time"), numberValue(data.order, "queue order"), numberValue(data.attempt, "attempt"), optionalNumber(data.availableAt, "available time"), optionalNumber(data.leaseExpiresAt, "lease expiry"), optionalOwner(data.leaseOwner), readIdempotencyRecord(data.idempotency), optionalFailure(data.failure));
+}
+function encode(entry) {
+    return JSON.parse(canonicalJson(entry));
+}
+function isState(value) {
+    return JOB_QUEUE_STATES.includes(value);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function optionalNumber(value, label) {
+    return value === undefined ? undefined : numberValue(value, label);
+}
+function optionalOwner(value) {
+    return value === undefined ? undefined : normalizeId(value);
+}
+function optionalFailure(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        throw new JobQueueStateError("Job failure metadata is invalid");
+    const failure = value;
+    assertFailure(failure);
+    return failure;
+}
+function assertFailure(value) {
+    if (!isFailureKind(value.kind) ||
+        !isFailureOutcome(value.outcome) ||
+        typeof value.code !== "string" ||
+        value.code.trim() === "" ||
+        typeof value.message !== "string" ||
+        value.message.trim() === "")
+        throw new JobQueueStateError("Job failure metadata is invalid");
+    if (value.status !== undefined && !Number.isSafeInteger(value.status))
+        throw new JobQueueStateError("Job failure status is invalid");
+    if (value.retry !== undefined && value.retry !== "never" && value.retry !== "later")
+        throw new JobQueueStateError("Job failure retry classification is invalid");
+    if (value.afterMs !== undefined && (!Number.isSafeInteger(value.afterMs) || value.afterMs < 0))
+        throw new JobQueueStateError("Job failure retry delay is invalid");
+    if (value.data !== undefined)
+        canonicalJson(value.data);
+}
+function isFailureKind(value) {
+    return ["application", "provider", "cancellation", "timeout", "defect"].includes(value);
+}
+function isFailureOutcome(value) {
+    return ["declared-error", "provider-failure", "cancelled", "timeout", "defect"].includes(value);
+}
+function numberValue(value, label) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+        throw new JobQueueStateError(`Job ${label} is invalid`);
+    return value;
+}
+//# sourceMappingURL=queue-entry.js.map

package/dist/jobs/queue-entry.js.map

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

package/dist/jobs/queue-lease.d.ts

@@ -0,0 +1,4 @@
+import type { JobStore } from "./store.js";
+import type { JobQueueEntry, JobQueueLeaseOptions } from "./queue-utils.js";
+export declare function acquireQueueLease(store: JobStore, entries: Map<string, JobQueueEntry>, current: JobQueueEntry, time: number, leaseOptions: JobQueueLeaseOptions, attempt: number, clock: () => number, ownerToken: string, defaultDurationMs: number): Promise<JobQueueEntry>;
+//# sourceMappingURL=queue-lease.d.ts.map

package/dist/jobs/queue-lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-lease.d.ts","sourceRoot":"","sources":["../../src/jobs/queue-lease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,oBAAoB,EAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,CAAC,CAaxB"}

package/dist/jobs/queue-lease.js

@@ -0,0 +1,12 @@
+import { nextEntry, persist } from "./queue-entry.js";
+import { leaseTransitionOptions } from "./lease-utils.js";
+export async function acquireQueueLease(store, entries, current, time, leaseOptions, attempt, clock, ownerToken, defaultDurationMs) {
+    const next = nextEntry(current, "leased", {
+        ...leaseTransitionOptions(time, defaultDurationMs, leaseOptions, ownerToken),
+        attempt,
+    }, clock);
+    await persist(store, next);
+    entries.set(current.instanceId, next);
+    return next;
+}
+//# sourceMappingURL=queue-lease.js.map

package/dist/jobs/queue-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-lease.js","sourceRoot":"","sources":["../../src/jobs/queue-lease.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAe,EACf,OAAmC,EACnC,OAAsB,EACtB,IAAY,EACZ,YAAkC,EAClC,OAAe,EACf,KAAmB,EACnB,UAAkB,EAClB,iBAAyB;IAEzB,MAAM,IAAI,GAAG,SAAS,CACpB,OAAO,EACP,QAAQ,EACR;QACE,GAAG,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,CAAC;QAC5E,OAAO;KACR,EACD,KAAK,CACN,CAAC;IACF,MAAM,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/jobs/queue-operations.d.ts

@@ -0,0 +1,16 @@
+import type { JobStore } from "./store.js";
+import { type JobQueueEnqueue, type JobQueueEntry, type JobQueue } from "./queue-utils.js";
+import { type JobQueueAdminMutations } from "./queue-admin.js";
+export interface MutableQueueState {
+    readonly entries: Map<string, JobQueueEntry>;
+    nextOrder: number;
+}
+export type JobQueueMutations = Pick<JobQueue, "ready" | "enqueue" | "acquire" | "renew" | "transition" | "recover" | "expire"> & JobQueueAdminMutations;
+export declare function createJobQueueMutations(store: JobStore, state: MutableQueueState, options: {
+    readonly clock: () => number;
+    readonly createInstanceId?: () => string;
+    readonly ownerToken: string;
+    readonly leaseDurationMs: number;
+    readonly idempotency?: JobQueueEnqueue["idempotency"];
+}): JobQueueMutations;
+//# sourceMappingURL=queue-operations.d.ts.map

package/dist/jobs/queue-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-operations.d.ts","sourceRoot":"","sources":["../../src/jobs/queue-operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAGL,KAAK,eAAe,EAEpB,KAAK,aAAa,EAClB,KAAK,QAAQ,EAKd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE7F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,QAAQ,EACR,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAChF,GACC,sBAAsB,CAAC;AAEzB,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE;IACP,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;CACvD,GACA,iBAAiB,CA+JnB"}