@storyshelf/core 0.7.0 → 0.9.0-next-d2cc082

package/dist/capture/consumer/loop.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { REAL_TIMERS } from "../db-queue/timers.mjs";
 import { idleDelayMs, isFastEmptyPoll } from "./idle.mjs";
-//#region src/capture/consumer/loop.ts
+// src/capture/consumer/loop.ts
 /** Pause after a failed poll. */
 const POLL_ERROR_DELAY_MS = 1e3;
 /** Start consuming `queue` with `slots` concurrent jobs. */
@@ -104,7 +104,6 @@ async function sleep(state, timers, ms) {
 	await promise;
 	if (handle !== null) clock.clearTimeout(handle);
 }
-//#endregion
 export { POLL_ERROR_DELAY_MS, startSlotLoop };
 
 //# sourceMappingURL=loop.mjs.map

package/dist/capture/consumer/metrics.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import "../../logger.mjs";
 import { PollableCaptureQueue } from "../../adapter/capture-queue.mjs";
 import { CaptureJobKind } from "../../schema/capture-job.mjs";
-//#region src/capture/consumer/metrics.d.ts
 /** How a consumed job ended. */
 type JobOutcome = "completed" | "retried" | "failed" | "cancelled" | "lost" | "dropped" | "unhandled";
 /** A job the consumer finished with. */
@@ -36,6 +35,5 @@ interface ConsumerMetrics {
 declare const DEFAULT_SAMPLE_MS = 30000;
 /** Read the backlog of `queue` from its `active()` view. */
 declare function sampleQueue(queue: PollableCaptureQueue, now: number): Promise<QueueSample>;
-//#endregion
 export { ConsumerMetrics, DEFAULT_SAMPLE_MS, JobFinishedEvent, JobOutcome, QueueSample, sampleQueue };
 //# sourceMappingURL=metrics.d.mts.map

package/dist/capture/consumer/metrics.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { repeatEvery } from "../db-queue/timers.mjs";
-//#region src/capture/consumer/metrics.ts
+// src/capture/consumer/metrics.ts
 /** Default interval between queue samples. */
 const DEFAULT_SAMPLE_MS = 3e4;
 /** Read the backlog of `queue` from its `active()` view. */
@@ -32,7 +32,6 @@ function reportFinished(metrics, event) {
 		metrics?.jobFinished?.(event);
 	} catch {}
 }
-//#endregion
 export { DEFAULT_SAMPLE_MS, reportFinished, sampleQueue, startQueueSampling };
 
 //# sourceMappingURL=metrics.mjs.map

package/dist/capture/consumer/retry.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { PollableJob } from "../../adapter/capture-queue.mjs";
-//#region src/capture/consumer/retry.d.ts
 /** Retries after the first attempt before a job is failed for good (three attempts in total). */
 declare const DEFAULT_MAX_RETRIES = 2;
 /** Base of the exponential retry delay: the n-th retry waits `base * 2^n` ms. */
@@ -28,6 +27,5 @@ declare function isFinalAttempt(job: PollableJob & {
   attempt?: number;
   maxAttempts?: number;
 }, maxRetries?: number): boolean;
-//#endregion
 export { DEFAULT_BACKOFF_MS, DEFAULT_MAX_RETRIES, DEFAULT_WAIT_TIME_SECONDS, MAX_BACKOFF_MS, RetryConfig, backoffDelayMs, isFinalAttempt };
 //# sourceMappingURL=retry.d.mts.map

package/dist/capture/consumer/retry.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/consumer/retry.ts
+// src/capture/consumer/retry.ts
 /** Retries after the first attempt before a job is failed for good (three attempts in total). */
 const DEFAULT_MAX_RETRIES = 2;
 /** Base of the exponential retry delay: the n-th retry waits `base * 2^n` ms. */
@@ -28,7 +28,6 @@ function isFinalAttempt(job, maxRetries = 2) {
 function retriesOf(job, fallback = 2) {
 	return typeof job.maxAttempts === "number" ? Math.max(0, job.maxAttempts - 1) : fallback;
 }
-//#endregion
 export { DEFAULT_BACKOFF_MS, DEFAULT_MAX_RETRIES, DEFAULT_WAIT_TIME_SECONDS, MAX_BACKOFF_MS, backoffDelayMs, isFinalAttempt, retriesOf };
 
 //# sourceMappingURL=retry.mjs.map

package/dist/capture/consumer/run-job.mjs

@@ -5,7 +5,7 @@ import { roundedTimings, runWithTimings } from "../../utils/timing.mjs";
 import { backoffDelayMs, isFinalAttempt } from "./retry.mjs";
 import { keepJobLease } from "../db-queue/keeper.mjs";
 import { reportFinished } from "./metrics.mjs";
-//#region src/capture/consumer/run-job.ts
+// src/capture/consumer/run-job.ts
 /** Run `job` in the slot the caller holds; never rejects. */
 async function runJob(rt, job) {
 	const kind = job.kind ?? "capture";
@@ -189,7 +189,6 @@ async function failJob(rt, job, message, logger) {
 		await rt.queue.ack(job);
 	}
 }
-//#endregion
 export { runJob };
 
 //# sourceMappingURL=run-job.mjs.map

package/dist/capture/consumer/startup.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { sweepOrphanedScratch } from "../scratch.mjs";
 import { configureImages, verifyImageEngine } from "../../diff.mjs";
-//#region src/capture/consumer/startup.ts
+// src/capture/consumer/startup.ts
 /**
 * Only touch the process-wide image settings when asked, so a consumer created next to an app in
 * one process does not undo the app's own `images`/`compare` options.
@@ -32,7 +32,6 @@ async function sweepScratch(scratchDir, logger) {
 		logger.warn({ err: error }, "scratch sweep failed");
 	}
 }
-//#endregion
 export { applyImageSettings, ensureImageEngine, sweepScratch };
 
 //# sourceMappingURL=startup.mjs.map

package/dist/capture/consumer/types.d.mts

@@ -9,7 +9,6 @@ import { QueueTimers } from "../db-queue/timers.mjs";
 import { CaptureHandlerOptions } from "./capture-handler.mjs";
 import { ConsumerMetrics } from "./metrics.mjs";
 import { RetryConfig } from "./retry.mjs";
-//#region src/capture/consumer/types.d.ts
 /** A polled job as the consumer sees it: database jobs carry the extra fields, others omit them. */
 type ConsumerJob = PollableJob & {
   /** Job kind; absent on queues that only carry capture jobs (remote, IPC). */
@@ -92,6 +91,5 @@ interface CaptureConsumer {
   stop(): Promise<void>;
   isRunning(): boolean;
 }
-//#endregion
 export { CaptureConsumer, CaptureConsumerOptions, ConsumerConfig, ConsumerJob, JobHandlers, JobRunContext, KindHandler };
 //# sourceMappingURL=types.d.mts.map

package/dist/capture/crash-failure.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DispatchDeps } from "./dispatch.mjs";
-//#region src/capture/crash-failure.d.ts
 /** What {@link failCrashedCapture} did. */
 type CrashFailureOutcome =
 /** The build was failed. */
@@ -20,6 +19,5 @@ declare function failCrashedCapture(deps: DispatchDeps, job: {
   buildId: string;
   shard?: string | undefined;
 }, error: string): Promise<CrashFailureOutcome>;
-//#endregion
 export { CrashFailureOutcome, failCrashedCapture };
 //# sourceMappingURL=crash-failure.d.mts.map

package/dist/capture/crash-failure.mjs

@@ -6,7 +6,7 @@ import { BuildModel } from "../models/build.mjs";
 import { CaptureShardModel } from "../models/capture-shard.mjs";
 import { ProjectModel } from "../models/project.mjs";
 import { reduceBuild } from "./shards/reduce.mjs";
-//#region src/capture/crash-failure.ts
+// src/capture/crash-failure.ts
 /**
 * The terminal path for a capture job the forked parent gave up on because the child kept dying on
 * it (ADR 0005 phase 3). The child never got to record the failure, so the parent writes it: the
@@ -64,7 +64,6 @@ async function closeOpenAttempts(deps, buildId, error) {
 	const open = (await attempts.listByBuild(buildId)).filter((attempt) => attempt.status === "queued" || attempt.status === "running");
 	await Promise.all(open.map(async (attempt) => await attempts.markFinished(attempt.id, "failed", error)));
 }
-//#endregion
 export { failCrashedCapture };
 
 //# sourceMappingURL=crash-failure.mjs.map

package/dist/capture/db-queue/cadence.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/capture/db-queue/cadence.d.ts
 /** Poll and cancel-check cadence of the database queue (ADR 0006, decision 11). */
 /** Poll interval of an idle instance. */
 declare const IDLE_POLL_MS = 15000;
@@ -27,6 +26,5 @@ declare const DEFAULT_CADENCE: PollCadence;
  * `[0, jitter)` of it, so instances started together drift apart instead of probing in lockstep.
  */
 declare function nextPollDelay(lastWorkAt: number | null, now: number, cadence?: PollCadence, random?: () => number): number;
-//#endregion
 export { ACTIVE_POLL_MS, ACTIVE_WINDOW_MS, CANCEL_CHECK_MS, DEFAULT_CADENCE, IDLE_POLL_MS, POLL_JITTER, PollCadence, nextPollDelay };
 //# sourceMappingURL=cadence.d.mts.map

package/dist/capture/db-queue/cadence.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/db-queue/cadence.ts
+// src/capture/db-queue/cadence.ts
 /** Poll and cancel-check cadence of the database queue (ADR 0006, decision 11). */
 /** Poll interval of an idle instance. */
 const IDLE_POLL_MS = 15e3;
@@ -32,7 +32,6 @@ function nextPollDelay(lastWorkAt, now, cadence = DEFAULT_CADENCE, random = Math
 function clampUnit(value) {
 	return Math.min(Math.max(value, 0), .999999);
 }
-//#endregion
 export { ACTIVE_POLL_MS, ACTIVE_WINDOW_MS, CANCEL_CHECK_MS, DEFAULT_CADENCE, IDLE_POLL_MS, POLL_JITTER, nextPollDelay };
 
 //# sourceMappingURL=cadence.mjs.map

package/dist/capture/db-queue/claim.d.mts

@@ -1,9 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import "./types.mjs";
-//#region src/capture/db-queue/claim.d.ts
 /** Error recorded on a job whose last allowed attempt lost its lease. */
 declare const LEASE_EXHAUSTED_ERROR = "lease expired on the final attempt";
-//#endregion
 export { LEASE_EXHAUSTED_ERROR };
 //# sourceMappingURL=claim.d.mts.map

package/dist/capture/db-queue/claim.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { attemptRowId, isTerminalJob } from "../../models/capture-job.mjs";
 import { toDatabaseJob } from "./codec.mjs";
 import { isoAt } from "./clock.mjs";
-//#region src/capture/db-queue/claim.ts
+// src/capture/db-queue/claim.ts
 /**
 * The claim algorithm of the database queue. A poll probes for the oldest candidate row (a queued
 * job whose `visibleAt` passed, or a running attempt whose lease ran out), then claims the job's
@@ -114,19 +114,35 @@ async function exhaust(rt, job, stale) {
 	}, "job failed: lease exhausted");
 	await reportExhausted(rt, job);
 }
+/** Sleep for `ms`, using injected timers when available. */
+async function sleep(rt, ms) {
+	if (rt.timers === void 0) {
+		await new Promise((resolve) => {
+			setTimeout(resolve, ms);
+		});
+		return;
+	}
+	await new Promise((resolve) => {
+		rt.timers?.setTimeout(resolve, ms);
+	});
+}
 /** Tell the host a job ended without any holder to record it; its failure never blocks the poll. */
 async function reportExhausted(rt, job) {
 	if (rt.onExhausted === void 0) return;
-	try {
+	const attempts = 3;
+	for (let attempt = 1; attempt <= attempts; attempt += 1) try {
 		await rt.onExhausted(toDatabaseJob(job, job.attempt, rt.leaseMs), LEASE_EXHAUSTED_ERROR);
+		return;
 	} catch (error) {
 		rt.logger?.error({
 			err: error,
-			jobId: job.jobId
+			jobId: job.jobId,
+			attempt,
+			attempts
 		}, "exhausted-job hook failed");
+		if (attempt < attempts) await sleep(rt, 100 * attempt);
 	}
 }
-//#endregion
 export { LEASE_EXHAUSTED_ERROR, claimCandidate, claimNext };
 
 //# sourceMappingURL=claim.mjs.map

package/dist/capture/db-queue/claim.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"claim.mjs","names":[],"sources":["../../../src/capture/db-queue/claim.ts"],"sourcesContent":["/**\n * The claim algorithm of the database queue. A poll probes for the oldest candidate row (a queued\n * job whose `visibleAt` passed, or a running attempt whose lease ran out), then claims the job's\n * next attempt by inserting its row: the unique key lets exactly one instance win. The winner\n * retires the expired attempt it replaced and marks the job row running.\n */\nimport { attemptRowId, isTerminalJob } from \"../../models/capture-job.ts\";\nimport type { CaptureJobRow } from \"../../schema/capture-job.ts\";\nimport { isoAt } from \"./clock.ts\";\nimport { toDatabaseJob } from \"./codec.ts\";\nimport type { DatabaseJob, QueueRuntime } from \"./types.ts\";\n\n/** Candidates tried per poll when other instances win the race for them. */\nconst MAX_CLAIM_TRIES = 3;\n\n/** Error recorded on a job whose last allowed attempt lost its lease. */\nexport const LEASE_EXHAUSTED_ERROR = \"lease expired on the final attempt\";\n\n/** Probe once and claim the job found; on a lost race, try the next candidate (a few times). */\nexport async function claimNext(rt: QueueRuntime): Promise<DatabaseJob | null> {\n  for (let tries = 0; tries < MAX_CLAIM_TRIES; tries += 1) {\n    // oxlint-disable-next-line no-await-in-loop -- one candidate at a time, in order\n    const candidate = await rt.model.nextCandidate(rt.kinds, isoAt(rt));\n    if (candidate === null) {\n      return null;\n    }\n    // oxlint-disable-next-line no-await-in-loop -- see above\n    const job = await claimCandidate(rt, candidate);\n    if (job !== null) {\n      return job;\n    }\n  }\n  return null;\n}\n\n/** Claim the job behind a candidate row; null when it is gone, over, exhausted or lost to a race. */\nexport async function claimCandidate(\n  rt: QueueRuntime,\n  candidate: CaptureJobRow,\n): Promise<DatabaseJob | null> {\n  if (candidate.entry === \"job\" && candidate.status !== \"queued\") {\n    // A running job row put back in range by a late deferral (see `deferBehind`): not claimable.\n    await rt.model.clearVisibility(candidate.id, isoAt(rt));\n    return null;\n  }\n  const stale = candidate.entry === \"attempt\" ? candidate : null;\n  const job = stale === null ? candidate : await rt.model.get(candidate.jobId);\n  if (job === null || isTerminalJob(job) || (stale !== null && stale.attempt < job.attempt)) {\n    // Nothing left to claim: the expired attempt is just cleaned out of the poll's range.\n    await retire(rt, stale);\n    return null;\n  }\n  return await claimNextAttempt(rt, job, stale);\n}\n\n/** Claim the attempt after the last one made, or fail the job when none is left. */\nasync function claimNextAttempt(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  stale: CaptureJobRow | null,\n): Promise<DatabaseJob | null> {\n  // An attempt row ahead of its job row belongs to a claimer that died before marking the job.\n  const made = Math.max(job.attempt, stale?.attempt ?? 0);\n  if (made >= job.maxAttempts) {\n    await exhaust(rt, job, stale);\n    return null;\n  }\n  return await claimAttempt(rt, job, made + 1, stale);\n}\n\nasync function claimAttempt(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  attempt: number,\n  stale: CaptureJobRow | null,\n): Promise<DatabaseJob | null> {\n  const leaseUntil = isoAt(rt, rt.leaseMs);\n  const won = await rt.model.claim({ job, attempt, owner: rt.owner, leaseUntil }, isoAt(rt));\n  if (!won) {\n    return stale === null ? await afterLostRace(rt, job, attempt) : null;\n  }\n  const fresh = await rt.model.get(job.jobId);\n  if (fresh === null || isTerminalJob(fresh)) {\n    // Cancelled (or finished by a late holder) between the probe and the insert.\n    await rt.model.finishAttempt(attemptRowId(job.jobId, attempt), \"expired\", isoAt(rt));\n    return null;\n  }\n  return await takeOver(rt, fresh, attempt, stale);\n}\n\n/**\n * Another instance holds attempt `attempt` of a job whose row still reads queued. Usually that\n * winner is about to mark the job running. If it died before doing so, its attempt's lease decides:\n * once expired, the attempt is claimed like any expired one; until then the job row is moved\n * behind that lease, so it does not sit at the head of the queue losing every claim. Only\n * `visibleAt` is written, never the status, so a winner that finished meanwhile keeps its outcome.\n */\nasync function afterLostRace(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  attempt: number,\n): Promise<DatabaseJob | null> {\n  const id = attemptRowId(job.jobId, attempt);\n  const expired = await rt.model.expiredAttempt(id, isoAt(rt));\n  if (expired !== null) {\n    return await claimCandidate(rt, expired);\n  }\n  await deferBehind(rt, job, await rt.model.get(id));\n  return null;\n}\n\nasync function deferBehind(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  holder: CaptureJobRow | null,\n): Promise<void> {\n  const current = await rt.model.get(job.jobId);\n  if (holder?.visibleAt && current?.status === \"queued\" && current.attempt === job.attempt) {\n    await rt.model.defer(job.jobId, holder.visibleAt, isoAt(rt));\n  }\n}\n\n/** The claim won: retire the attempt it replaced and record the new one on the job row. */\nasync function takeOver(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  attempt: number,\n  stale: CaptureJobRow | null,\n): Promise<DatabaseJob> {\n  await retire(rt, stale);\n  await rt.model.markRunning(job.jobId, attempt, isoAt(rt));\n  rt.logger?.debug({ jobId: job.jobId, attempt }, \"job claimed\");\n  return toDatabaseJob(job, attempt, rt.leaseMs);\n}\n\n/** Mark an expired attempt row `expired`: it leaves the poll's range, and its holder sees `lost`. */\nasync function retire(rt: QueueRuntime, stale: CaptureJobRow | null): Promise<void> {\n  if (stale !== null) {\n    await rt.model.finishAttempt(stale.id, \"expired\", isoAt(rt));\n  }\n}\n\n/**\n * The final attempt lost its lease: the job fails (one limit covers failed attempts and lost\n * leases). Idempotent, so two instances finding the same row write the same outcome. If the late\n * holder finished after all, its `done` wins.\n */\nasync function exhaust(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  stale: CaptureJobRow | null,\n): Promise<void> {\n  const now = isoAt(rt);\n  if (stale !== null && (await rt.model.get(stale.id))?.status === \"done\") {\n    await rt.model.finishJob(job.jobId, \"done\", now);\n    return;\n  }\n  await retire(rt, stale);\n  await rt.model.finishJob(job.jobId, \"failed\", now, LEASE_EXHAUSTED_ERROR);\n  rt.logger?.warn({ jobId: job.jobId, attempts: job.attempt }, \"job failed: lease exhausted\");\n  await reportExhausted(rt, job);\n}\n\n/** Tell the host a job ended without any holder to record it; its failure never blocks the poll. */\nasync function reportExhausted(rt: QueueRuntime, job: CaptureJobRow): Promise<void> {\n  if (rt.onExhausted === undefined) {\n    return;\n  }\n  try {\n    await rt.onExhausted(toDatabaseJob(job, job.attempt, rt.leaseMs), LEASE_EXHAUSTED_ERROR);\n  } catch (error) {\n    rt.logger?.error({ err: error, jobId: job.jobId }, \"exhausted-job hook failed\");\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"claim.mjs","names":[],"sources":["../../../src/capture/db-queue/claim.ts"],"sourcesContent":["/**\n * The claim algorithm of the database queue. A poll probes for the oldest candidate row (a queued\n * job whose `visibleAt` passed, or a running attempt whose lease ran out), then claims the job's\n * next attempt by inserting its row: the unique key lets exactly one instance win. The winner\n * retires the expired attempt it replaced and marks the job row running.\n */\nimport { attemptRowId, isTerminalJob } from \"../../models/capture-job.ts\";\nimport type { CaptureJobRow } from \"../../schema/capture-job.ts\";\nimport { isoAt } from \"./clock.ts\";\nimport { toDatabaseJob } from \"./codec.ts\";\nimport type { DatabaseJob, QueueRuntime } from \"./types.ts\";\n\n/** Candidates tried per poll when other instances win the race for them. */\nconst MAX_CLAIM_TRIES = 3;\n\n/** Error recorded on a job whose last allowed attempt lost its lease. */\nexport const LEASE_EXHAUSTED_ERROR = \"lease expired on the final attempt\";\n\n/** Probe once and claim the job found; on a lost race, try the next candidate (a few times). */\nexport async function claimNext(rt: QueueRuntime): Promise<DatabaseJob | null> {\n  for (let tries = 0; tries < MAX_CLAIM_TRIES; tries += 1) {\n    // oxlint-disable-next-line no-await-in-loop -- one candidate at a time, in order\n    const candidate = await rt.model.nextCandidate(rt.kinds, isoAt(rt));\n    if (candidate === null) {\n      return null;\n    }\n    // oxlint-disable-next-line no-await-in-loop -- see above\n    const job = await claimCandidate(rt, candidate);\n    if (job !== null) {\n      return job;\n    }\n  }\n  return null;\n}\n\n/** Claim the job behind a candidate row; null when it is gone, over, exhausted or lost to a race. */\nexport async function claimCandidate(\n  rt: QueueRuntime,\n  candidate: CaptureJobRow,\n): Promise<DatabaseJob | null> {\n  if (candidate.entry === \"job\" && candidate.status !== \"queued\") {\n    // A running job row put back in range by a late deferral (see `deferBehind`): not claimable.\n    await rt.model.clearVisibility(candidate.id, isoAt(rt));\n    return null;\n  }\n  const stale = candidate.entry === \"attempt\" ? candidate : null;\n  const job = stale === null ? candidate : await rt.model.get(candidate.jobId);\n  if (job === null || isTerminalJob(job) || (stale !== null && stale.attempt < job.attempt)) {\n    // Nothing left to claim: the expired attempt is just cleaned out of the poll's range.\n    await retire(rt, stale);\n    return null;\n  }\n  return await claimNextAttempt(rt, job, stale);\n}\n\n/** Claim the attempt after the last one made, or fail the job when none is left. */\nasync function claimNextAttempt(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  stale: CaptureJobRow | null,\n): Promise<DatabaseJob | null> {\n  // An attempt row ahead of its job row belongs to a claimer that died before marking the job.\n  const made = Math.max(job.attempt, stale?.attempt ?? 0);\n  if (made >= job.maxAttempts) {\n    await exhaust(rt, job, stale);\n    return null;\n  }\n  return await claimAttempt(rt, job, made + 1, stale);\n}\n\nasync function claimAttempt(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  attempt: number,\n  stale: CaptureJobRow | null,\n): Promise<DatabaseJob | null> {\n  const leaseUntil = isoAt(rt, rt.leaseMs);\n  const won = await rt.model.claim({ job, attempt, owner: rt.owner, leaseUntil }, isoAt(rt));\n  if (!won) {\n    return stale === null ? await afterLostRace(rt, job, attempt) : null;\n  }\n  const fresh = await rt.model.get(job.jobId);\n  if (fresh === null || isTerminalJob(fresh)) {\n    // Cancelled (or finished by a late holder) between the probe and the insert.\n    await rt.model.finishAttempt(attemptRowId(job.jobId, attempt), \"expired\", isoAt(rt));\n    return null;\n  }\n  return await takeOver(rt, fresh, attempt, stale);\n}\n\n/**\n * Another instance holds attempt `attempt` of a job whose row still reads queued. Usually that\n * winner is about to mark the job running. If it died before doing so, its attempt's lease decides:\n * once expired, the attempt is claimed like any expired one; until then the job row is moved\n * behind that lease, so it does not sit at the head of the queue losing every claim. Only\n * `visibleAt` is written, never the status, so a winner that finished meanwhile keeps its outcome.\n */\nasync function afterLostRace(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  attempt: number,\n): Promise<DatabaseJob | null> {\n  const id = attemptRowId(job.jobId, attempt);\n  const expired = await rt.model.expiredAttempt(id, isoAt(rt));\n  if (expired !== null) {\n    return await claimCandidate(rt, expired);\n  }\n  await deferBehind(rt, job, await rt.model.get(id));\n  return null;\n}\n\nasync function deferBehind(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  holder: CaptureJobRow | null,\n): Promise<void> {\n  const current = await rt.model.get(job.jobId);\n  if (holder?.visibleAt && current?.status === \"queued\" && current.attempt === job.attempt) {\n    await rt.model.defer(job.jobId, holder.visibleAt, isoAt(rt));\n  }\n}\n\n/** The claim won: retire the attempt it replaced and record the new one on the job row. */\nasync function takeOver(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  attempt: number,\n  stale: CaptureJobRow | null,\n): Promise<DatabaseJob> {\n  await retire(rt, stale);\n  await rt.model.markRunning(job.jobId, attempt, isoAt(rt));\n  rt.logger?.debug({ jobId: job.jobId, attempt }, \"job claimed\");\n  return toDatabaseJob(job, attempt, rt.leaseMs);\n}\n\n/** Mark an expired attempt row `expired`: it leaves the poll's range, and its holder sees `lost`. */\nasync function retire(rt: QueueRuntime, stale: CaptureJobRow | null): Promise<void> {\n  if (stale !== null) {\n    await rt.model.finishAttempt(stale.id, \"expired\", isoAt(rt));\n  }\n}\n\n/**\n * The final attempt lost its lease: the job fails (one limit covers failed attempts and lost\n * leases). Idempotent, so two instances finding the same row write the same outcome. If the late\n * holder finished after all, its `done` wins.\n */\nasync function exhaust(\n  rt: QueueRuntime,\n  job: CaptureJobRow,\n  stale: CaptureJobRow | null,\n): Promise<void> {\n  const now = isoAt(rt);\n  if (stale !== null && (await rt.model.get(stale.id))?.status === \"done\") {\n    await rt.model.finishJob(job.jobId, \"done\", now);\n    return;\n  }\n  await retire(rt, stale);\n  await rt.model.finishJob(job.jobId, \"failed\", now, LEASE_EXHAUSTED_ERROR);\n  rt.logger?.warn({ jobId: job.jobId, attempts: job.attempt }, \"job failed: lease exhausted\");\n  await reportExhausted(rt, job);\n}\n\n/** Sleep for `ms`, using injected timers when available. */\nasync function sleep(rt: QueueRuntime, ms: number): Promise<void> {\n  if (rt.timers === undefined) {\n    await new Promise<void>((resolve) => {\n      setTimeout(resolve, ms);\n    });\n    return;\n  }\n  await new Promise<void>((resolve) => {\n    rt.timers?.setTimeout(resolve, ms);\n  });\n}\n\n/** Tell the host a job ended without any holder to record it; its failure never blocks the poll. */\nasync function reportExhausted(rt: QueueRuntime, job: CaptureJobRow): Promise<void> {\n  if (rt.onExhausted === undefined) {\n    return;\n  }\n  const attempts = 3;\n  for (let attempt = 1; attempt <= attempts; attempt += 1) {\n    try {\n      // oxlint-disable-next-line eslint/no-await-in-loop -- sequential retries\n      await rt.onExhausted(toDatabaseJob(job, job.attempt, rt.leaseMs), LEASE_EXHAUSTED_ERROR);\n      return;\n    } catch (error) {\n      rt.logger?.error(\n        { err: error, jobId: job.jobId, attempt, attempts },\n        \"exhausted-job hook failed\",\n      );\n      if (attempt < attempts) {\n        // oxlint-disable-next-line eslint/no-await-in-loop -- sequential retries\n        await sleep(rt, 100 * attempt);\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/capture/db-queue/clock.mjs

@@ -1,12 +1,11 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/db-queue/clock.ts
+// src/capture/db-queue/clock.ts
 /** ISO-8601 time `plusMs` from now on the queue's clock. */
 function isoAt(rt, plusMs = 0) {
 	return new Date(rt.now() + plusMs).toISOString();
 }
-//#endregion
 export { isoAt };
 
 //# sourceMappingURL=clock.mjs.map

package/dist/capture/db-queue/codec.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { attemptRowId } from "../../models/capture-job.mjs";
-//#region src/capture/db-queue/codec.ts
+// src/capture/db-queue/codec.ts
 /** Serialize the request id, trace context and kind-specific fields of a job; null when empty. */
 function encodePayload(job) {
 	const stored = {};
@@ -70,7 +70,6 @@ function pickPayload(parsed) {
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-//#endregion
 export { decodePayload, encodePayload, toDatabaseJob, toQueueEntry };
 
 //# sourceMappingURL=codec.mjs.map

package/dist/capture/db-queue/index.d.mts

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../../adapter/database.mjs";
 import { DEFAULT_LEASE_MS, DEFAULT_RETRIES, DatabaseCaptureQueue, DatabaseCaptureQueueOptions, DatabaseJob, QueueJobInput } from "./types.mjs";
 import { LEASE_EXHAUSTED_ERROR } from "./claim.mjs";
 import { MAX_NACK_DELAY_MS } from "./poll.mjs";
-//#region src/capture/db-queue/index.d.ts
 /** What the database queue reports about itself; hosts show it before the queue is built. */
 declare const DATABASE_QUEUE_METADATA: {
   readonly name: "Database Queue";
@@ -15,6 +14,5 @@ declare const DATABASE_QUEUE_METADATA: {
 };
 /** A `PollableCaptureQueue` over `db`'s `capture_jobs` table. */
 declare function createDatabaseCaptureQueue(db: DatabaseAdapter, options?: DatabaseCaptureQueueOptions): DatabaseCaptureQueue;
-//#endregion
 export { DATABASE_QUEUE_METADATA, DEFAULT_LEASE_MS, DEFAULT_RETRIES, type DatabaseCaptureQueue, type DatabaseCaptureQueueOptions, type DatabaseJob, LEASE_EXHAUSTED_ERROR, MAX_NACK_DELAY_MS, type QueueJobInput, createDatabaseCaptureQueue };
 //# sourceMappingURL=index.d.mts.map

package/dist/capture/db-queue/index.mjs

@@ -11,7 +11,7 @@ import { activeEntries, cancelJobs, enqueueCapture, enqueueJob, recentEntries, s
 import { DEFAULT_LEASE_MS, DEFAULT_RETRIES } from "./types.mjs";
 import { createWakeSignal } from "./wake.mjs";
 import { hostname } from "node:os";
-//#region src/capture/db-queue/index.ts
+// src/capture/db-queue/index.ts
 /**
 * Create the database capture queue (ADR 0006, decision 4): `capture_jobs` on the app's own
 * `DatabaseAdapter` is the queue, safe with any number of instances.
@@ -24,7 +24,7 @@ import { hostname } from "node:os";
 /** What the database queue reports about itself; hosts show it before the queue is built. */
 const DATABASE_QUEUE_METADATA = {
 	name: "Database Queue",
-	version: "0.7.0",
+	version: "0.9.0-next-d2cc082",
 	description: "Capture queue on the app database (capture_jobs)",
 	kind: "database",
 	category: "capture-queue"
@@ -70,6 +70,7 @@ function resolveRuntime(db, options) {
 		maxAttempts: retries + 1,
 		owner: options.owner ?? `${hostname()}:${String(process.pid)}:${ulid().slice(-6)}`,
 		now: options.now ?? Date.now,
+		timers: options.timers,
 		wake: createWakeSignal(options.timers),
 		pollVersion: 0
 	}, options);
@@ -83,7 +84,6 @@ function withHooks(rt, options) {
 function positive(value, fallback) {
 	return value !== void 0 && Number.isFinite(value) && value > 0 ? value : fallback;
 }
-//#endregion
 export { DATABASE_QUEUE_METADATA, DEFAULT_LEASE_MS, DEFAULT_RETRIES, LEASE_EXHAUSTED_ERROR, MAX_NACK_DELAY_MS, createDatabaseCaptureQueue };
 
 //# sourceMappingURL=index.mjs.map

package/dist/capture/db-queue/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/capture/db-queue/index.ts"],"sourcesContent":["/**\n * Create the database capture queue (ADR 0006, decision 4): `capture_jobs` on the app's own\n * `DatabaseAdapter` is the queue, safe with any number of instances.\n *\n * Composition root: wires the runtime, lifecycle, enqueue/cancel/views (`operations`), the claim\n * (`claim`, `poll`) and the lease (`lease`) into a `PollableCaptureQueue`. Every attempt has its own\n * row `<jobId>:<attempt>`, created by a unique-key insert, so claiming needs no compare-and-swap and\n * a holder only ever writes its own attempt row.\n */\nimport { hostname } from \"node:os\";\nimport type { DatabaseAdapter } from \"../../adapters/database.ts\";\nimport type { Logger } from \"../../logger.ts\";\nimport { CaptureJobModel } from \"../../models/capture-job.ts\";\nimport { ulid } from \"../../utils/ulid.ts\";\nimport { extendJob, inspectJob } from \"./lease.ts\";\nimport { buildQueueLifecycle } from \"./lifecycle.ts\";\nimport {\n  activeEntries,\n  cancelJobs,\n  enqueueCapture,\n  enqueueJob,\n  recentEntries,\n  statusOf,\n} from \"./operations.ts\";\nimport { ackJob, nackJob, pollJob } from \"./poll.ts\";\nimport {\n  DEFAULT_LEASE_MS,\n  DEFAULT_RETRIES,\n  type DatabaseCaptureQueue,\n  type DatabaseCaptureQueueOptions,\n  type QueueRuntime,\n} from \"./types.ts\";\nimport { createWakeSignal } from \"./wake.ts\";\n\ndeclare const __PKG_VERSION__: string | undefined;\n\n/** What the database queue reports about itself; hosts show it before the queue is built. */\nexport const DATABASE_QUEUE_METADATA = {\n  name: \"Database Queue\",\n  version: typeof __PKG_VERSION__ === \"string\" ? __PKG_VERSION__ : \"0.0.0\",\n  description: \"Capture queue on the app database (capture_jobs)\",\n  kind: \"database\",\n  category: \"capture-queue\",\n} as const;\n\n/** A `PollableCaptureQueue` over `db`'s `capture_jobs` table. */\nexport function createDatabaseCaptureQueue(\n  db: DatabaseAdapter,\n  options: DatabaseCaptureQueueOptions = {},\n): DatabaseCaptureQueue {\n  const rt = resolveRuntime(db, options);\n  return {\n    metadata: DATABASE_QUEUE_METADATA,\n    lifecycle: buildQueueLifecycle(rt),\n    setLogger(bound: Logger): void {\n      rt.logger ??= bound;\n    },\n    enqueue: async (job) => {\n      await enqueueCapture(rt, job);\n    },\n    enqueueJob: async (job) => await enqueueJob(rt, job),\n    status: async (buildId) => await statusOf(rt, buildId),\n    active: async () => await activeEntries(rt),\n    recent: async (limit) => await recentEntries(rt, limit),\n    cancel: async (id) => await cancelJobs(rt, id),\n    poll: async (pollOptions) => await pollJob(rt, pollOptions),\n    ack: async (job) => {\n      await ackJob(rt, job);\n    },\n    nack: async (job, nackOptions) => {\n      await nackJob(rt, job, nackOptions);\n    },\n    extend: async (job) => await extendJob(rt, job),\n    inspect: async (job) => await inspectJob(rt, job),\n    waitForWork: async (ms) => await rt.wake.wait(ms, rt.pollVersion),\n  };\n}\n\nfunction resolveRuntime(db: DatabaseAdapter, options: DatabaseCaptureQueueOptions): QueueRuntime {\n  const kinds = options.kinds ?? [\"capture\"];\n  const retries = options.retries ?? DEFAULT_RETRIES;\n  if (kinds.length === 0) {\n    throw new Error(\"createDatabaseCaptureQueue: `kinds` must name at least one job kind\");\n  }\n  if (!Number.isInteger(retries) || retries < 0) {\n    throw new Error(\"createDatabaseCaptureQueue: `retries` must be a non-negative integer\");\n  }\n  const rt: QueueRuntime = {\n    model: new CaptureJobModel(db),\n    kinds,\n    leaseMs: positive(options.leaseMs, DEFAULT_LEASE_MS),\n    maxAttempts: retries + 1,\n    owner: options.owner ?? `${hostname()}:${String(process.pid)}:${ulid().slice(-6)}`,\n    now: options.now ?? Date.now,\n    wake: createWakeSignal(options.timers),\n    pollVersion: 0,\n  };\n  return withHooks(rt, options);\n}\n\n/** The optional logger and exhausted-job hook, when given. */\nfunction withHooks(rt: QueueRuntime, options: DatabaseCaptureQueueOptions): QueueRuntime {\n  if (options.logger !== undefined) {\n    rt.logger = options.logger;\n  }\n  if (options.onExhausted !== undefined) {\n    rt.onExhausted = options.onExhausted;\n  }\n  return rt;\n}\n\nfunction positive(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;\n}\n\nexport {\n  DEFAULT_LEASE_MS,\n  DEFAULT_RETRIES,\n  type DatabaseCaptureQueue,\n  type DatabaseCaptureQueueOptions,\n  type DatabaseJob,\n  type QueueJobInput,\n} from \"./types.ts\";\nexport { LEASE_EXHAUSTED_ERROR } from \"./claim.ts\";\nexport { MAX_NACK_DELAY_MS } from \"./poll.ts\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,0BAA0B;CACrC,MAAM;CACN,SAAA;CACA,aAAa;CACb,MAAM;CACN,UAAU;AACZ;;AAGA,SAAgB,2BACd,IACA,UAAuC,CAAC,GAClB;CACtB,MAAM,KAAK,eAAe,IAAI,OAAO;CACrC,OAAO;EACL,UAAU;EACV,WAAW,oBAAoB,EAAE;EACjC,UAAU,OAAqB;GAC7B,GAAG,WAAW;EAChB;EACA,SAAS,OAAO,QAAQ;GACtB,MAAM,eAAe,IAAI,GAAG;EAC9B;EACA,YAAY,OAAO,QAAQ,MAAM,WAAW,IAAI,GAAG;EACnD,QAAQ,OAAO,YAAY,MAAM,SAAS,IAAI,OAAO;EACrD,QAAQ,YAAY,MAAM,cAAc,EAAE;EAC1C,QAAQ,OAAO,UAAU,MAAM,cAAc,IAAI,KAAK;EACtD,QAAQ,OAAO,OAAO,MAAM,WAAW,IAAI,EAAE;EAC7C,MAAM,OAAO,gBAAgB,MAAM,QAAQ,IAAI,WAAW;EAC1D,KAAK,OAAO,QAAQ;GAClB,MAAM,OAAO,IAAI,GAAG;EACtB;EACA,MAAM,OAAO,KAAK,gBAAgB;GAChC,MAAM,QAAQ,IAAI,KAAK,WAAW;EACpC;EACA,QAAQ,OAAO,QAAQ,MAAM,UAAU,IAAI,GAAG;EAC9C,SAAS,OAAO,QAAQ,MAAM,WAAW,IAAI,GAAG;EAChD,aAAa,OAAO,OAAO,MAAM,GAAG,KAAK,KAAK,IAAI,GAAG,WAAW;CAClE;AACF;AAEA,SAAS,eAAe,IAAqB,SAAoD;CAC/F,MAAM,QAAQ,QAAQ,SAAS,CAAC,SAAS;CACzC,MAAM,UAAU,QAAQ,WAAA;CACxB,IAAI,MAAM,WAAW,GACnB,MAAM,IAAI,MAAM,qEAAqE;CAEvF,IAAI,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,GAC1C,MAAM,IAAI,MAAM,sEAAsE;CAYxF,OAAO,UAAU;EATf,OAAO,IAAI,gBAAgB,EAAE;EAC7B;EACA,SAAS,SAAS,QAAQ,SAAS,gBAAgB;EACnD,aAAa,UAAU;EACvB,OAAO,QAAQ,SAAS,GAAG,SAAS,EAAE,GAAG,OAAO,QAAQ,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE;EAC/E,KAAK,QAAQ,OAAO,KAAK;EACzB,MAAM,iBAAiB,QAAQ,MAAM;EACrC,aAAa;CAEG,GAAG,OAAO;AAC9B;;AAGA,SAAS,UAAU,IAAkB,SAAoD;CACvF,IAAI,QAAQ,WAAW,KAAA,GACrB,GAAG,SAAS,QAAQ;CAEtB,IAAI,QAAQ,gBAAgB,KAAA,GAC1B,GAAG,cAAc,QAAQ;CAE3B,OAAO;AACT;AAEA,SAAS,SAAS,OAA2B,UAA0B;CACrE,OAAO,UAAU,KAAA,KAAa,OAAO,SAAS,KAAK,KAAK,QAAQ,IAAI,QAAQ;AAC9E"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/capture/db-queue/index.ts"],"sourcesContent":["/**\n * Create the database capture queue (ADR 0006, decision 4): `capture_jobs` on the app's own\n * `DatabaseAdapter` is the queue, safe with any number of instances.\n *\n * Composition root: wires the runtime, lifecycle, enqueue/cancel/views (`operations`), the claim\n * (`claim`, `poll`) and the lease (`lease`) into a `PollableCaptureQueue`. Every attempt has its own\n * row `<jobId>:<attempt>`, created by a unique-key insert, so claiming needs no compare-and-swap and\n * a holder only ever writes its own attempt row.\n */\nimport { hostname } from \"node:os\";\nimport type { DatabaseAdapter } from \"../../adapters/database.ts\";\nimport type { Logger } from \"../../logger.ts\";\nimport { CaptureJobModel } from \"../../models/capture-job.ts\";\nimport { ulid } from \"../../utils/ulid.ts\";\nimport { extendJob, inspectJob } from \"./lease.ts\";\nimport { buildQueueLifecycle } from \"./lifecycle.ts\";\nimport {\n  activeEntries,\n  cancelJobs,\n  enqueueCapture,\n  enqueueJob,\n  recentEntries,\n  statusOf,\n} from \"./operations.ts\";\nimport { ackJob, nackJob, pollJob } from \"./poll.ts\";\nimport {\n  DEFAULT_LEASE_MS,\n  DEFAULT_RETRIES,\n  type DatabaseCaptureQueue,\n  type DatabaseCaptureQueueOptions,\n  type QueueRuntime,\n} from \"./types.ts\";\nimport { createWakeSignal } from \"./wake.ts\";\n\ndeclare const __PKG_VERSION__: string | undefined;\n\n/** What the database queue reports about itself; hosts show it before the queue is built. */\nexport const DATABASE_QUEUE_METADATA = {\n  name: \"Database Queue\",\n  version: typeof __PKG_VERSION__ === \"string\" ? __PKG_VERSION__ : \"0.0.0\",\n  description: \"Capture queue on the app database (capture_jobs)\",\n  kind: \"database\",\n  category: \"capture-queue\",\n} as const;\n\n/** A `PollableCaptureQueue` over `db`'s `capture_jobs` table. */\nexport function createDatabaseCaptureQueue(\n  db: DatabaseAdapter,\n  options: DatabaseCaptureQueueOptions = {},\n): DatabaseCaptureQueue {\n  const rt = resolveRuntime(db, options);\n  return {\n    metadata: DATABASE_QUEUE_METADATA,\n    lifecycle: buildQueueLifecycle(rt),\n    setLogger(bound: Logger): void {\n      rt.logger ??= bound;\n    },\n    enqueue: async (job) => {\n      await enqueueCapture(rt, job);\n    },\n    enqueueJob: async (job) => await enqueueJob(rt, job),\n    status: async (buildId) => await statusOf(rt, buildId),\n    active: async () => await activeEntries(rt),\n    recent: async (limit) => await recentEntries(rt, limit),\n    cancel: async (id) => await cancelJobs(rt, id),\n    poll: async (pollOptions) => await pollJob(rt, pollOptions),\n    ack: async (job) => {\n      await ackJob(rt, job);\n    },\n    nack: async (job, nackOptions) => {\n      await nackJob(rt, job, nackOptions);\n    },\n    extend: async (job) => await extendJob(rt, job),\n    inspect: async (job) => await inspectJob(rt, job),\n    waitForWork: async (ms) => await rt.wake.wait(ms, rt.pollVersion),\n  };\n}\n\nfunction resolveRuntime(db: DatabaseAdapter, options: DatabaseCaptureQueueOptions): QueueRuntime {\n  const kinds = options.kinds ?? [\"capture\"];\n  const retries = options.retries ?? DEFAULT_RETRIES;\n  if (kinds.length === 0) {\n    throw new Error(\"createDatabaseCaptureQueue: `kinds` must name at least one job kind\");\n  }\n  if (!Number.isInteger(retries) || retries < 0) {\n    throw new Error(\"createDatabaseCaptureQueue: `retries` must be a non-negative integer\");\n  }\n  const rt: QueueRuntime = {\n    model: new CaptureJobModel(db),\n    kinds,\n    leaseMs: positive(options.leaseMs, DEFAULT_LEASE_MS),\n    maxAttempts: retries + 1,\n    owner: options.owner ?? `${hostname()}:${String(process.pid)}:${ulid().slice(-6)}`,\n    now: options.now ?? Date.now,\n    timers: options.timers,\n    wake: createWakeSignal(options.timers),\n    pollVersion: 0,\n  };\n  return withHooks(rt, options);\n}\n\n/** The optional logger and exhausted-job hook, when given. */\nfunction withHooks(rt: QueueRuntime, options: DatabaseCaptureQueueOptions): QueueRuntime {\n  if (options.logger !== undefined) {\n    rt.logger = options.logger;\n  }\n  if (options.onExhausted !== undefined) {\n    rt.onExhausted = options.onExhausted;\n  }\n  return rt;\n}\n\nfunction positive(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;\n}\n\nexport {\n  DEFAULT_LEASE_MS,\n  DEFAULT_RETRIES,\n  type DatabaseCaptureQueue,\n  type DatabaseCaptureQueueOptions,\n  type DatabaseJob,\n  type QueueJobInput,\n} from \"./types.ts\";\nexport { LEASE_EXHAUSTED_ERROR } from \"./claim.ts\";\nexport { MAX_NACK_DELAY_MS } from \"./poll.ts\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,0BAA0B;CACrC,MAAM;CACN,SAAA;CACA,aAAa;CACb,MAAM;CACN,UAAU;AACZ;;AAGA,SAAgB,2BACd,IACA,UAAuC,CAAC,GAClB;CACtB,MAAM,KAAK,eAAe,IAAI,OAAO;CACrC,OAAO;EACL,UAAU;EACV,WAAW,oBAAoB,EAAE;EACjC,UAAU,OAAqB;GAC7B,GAAG,WAAW;EAChB;EACA,SAAS,OAAO,QAAQ;GACtB,MAAM,eAAe,IAAI,GAAG;EAC9B;EACA,YAAY,OAAO,QAAQ,MAAM,WAAW,IAAI,GAAG;EACnD,QAAQ,OAAO,YAAY,MAAM,SAAS,IAAI,OAAO;EACrD,QAAQ,YAAY,MAAM,cAAc,EAAE;EAC1C,QAAQ,OAAO,UAAU,MAAM,cAAc,IAAI,KAAK;EACtD,QAAQ,OAAO,OAAO,MAAM,WAAW,IAAI,EAAE;EAC7C,MAAM,OAAO,gBAAgB,MAAM,QAAQ,IAAI,WAAW;EAC1D,KAAK,OAAO,QAAQ;GAClB,MAAM,OAAO,IAAI,GAAG;EACtB;EACA,MAAM,OAAO,KAAK,gBAAgB;GAChC,MAAM,QAAQ,IAAI,KAAK,WAAW;EACpC;EACA,QAAQ,OAAO,QAAQ,MAAM,UAAU,IAAI,GAAG;EAC9C,SAAS,OAAO,QAAQ,MAAM,WAAW,IAAI,GAAG;EAChD,aAAa,OAAO,OAAO,MAAM,GAAG,KAAK,KAAK,IAAI,GAAG,WAAW;CAClE;AACF;AAEA,SAAS,eAAe,IAAqB,SAAoD;CAC/F,MAAM,QAAQ,QAAQ,SAAS,CAAC,SAAS;CACzC,MAAM,UAAU,QAAQ,WAAA;CACxB,IAAI,MAAM,WAAW,GACnB,MAAM,IAAI,MAAM,qEAAqE;CAEvF,IAAI,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,GAC1C,MAAM,IAAI,MAAM,sEAAsE;CAaxF,OAAO,UAAU;EAVf,OAAO,IAAI,gBAAgB,EAAE;EAC7B;EACA,SAAS,SAAS,QAAQ,SAAS,gBAAgB;EACnD,aAAa,UAAU;EACvB,OAAO,QAAQ,SAAS,GAAG,SAAS,EAAE,GAAG,OAAO,QAAQ,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE;EAC/E,KAAK,QAAQ,OAAO,KAAK;EACzB,QAAQ,QAAQ;EAChB,MAAM,iBAAiB,QAAQ,MAAM;EACrC,aAAa;CAEG,GAAG,OAAO;AAC9B;;AAGA,SAAS,UAAU,IAAkB,SAAoD;CACvF,IAAI,QAAQ,WAAW,KAAA,GACrB,GAAG,SAAS,QAAQ;CAEtB,IAAI,QAAQ,gBAAgB,KAAA,GAC1B,GAAG,cAAc,QAAQ;CAE3B,OAAO;AACT;AAEA,SAAS,SAAS,OAA2B,UAA0B;CACrE,OAAO,UAAU,KAAA,KAAa,OAAO,SAAS,KAAK,KAAK,QAAQ,IAAI,QAAQ;AAC9E"}

package/dist/capture/db-queue/keeper.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { Logger } from "../../logger.mjs";
 import { LeaseRenewal, PollableCaptureQueue, PollableJob } from "../../adapter/capture-queue.mjs";
 import { QueueTimers } from "./timers.mjs";
-//#region src/capture/db-queue/keeper.d.ts
 /** Longest gap between two renewals while progress keeps coming. */
 declare const RENEW_THROTTLE_MS = 30000;
 /** Why a held job must stop. */
@@ -31,6 +30,5 @@ interface JobLeaseKeeper {
 }
 /** Keep `job`'s lease on `queue` while the caller reports progress through `touch`. */
 declare function keepJobLease(queue: Pick<PollableCaptureQueue, "extend" | "inspect">, job: PollableJob, options?: LeaseKeeperOptions): JobLeaseKeeper;
-//#endregion
 export { JobLeaseKeeper, LeaseEnd, LeaseKeeperOptions, RENEW_THROTTLE_MS, keepJobLease };
 //# sourceMappingURL=keeper.d.mts.map

package/dist/capture/db-queue/keeper.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { REAL_TIMERS, repeatEvery } from "./timers.mjs";
 import "./cadence.mjs";
-//#region src/capture/db-queue/keeper.ts
+// src/capture/db-queue/keeper.ts
 /** Longest gap between two renewals while progress keeps coming. */
 const RENEW_THROTTLE_MS = 3e4;
 /** Keep `job`'s lease on `queue` while the caller reports progress through `touch`. */
@@ -86,7 +86,6 @@ function renewInterval(job, options) {
 	const third = job.leaseMs === void 0 ? RENEW_THROTTLE_MS : Math.floor(job.leaseMs / 3);
 	return Math.max(1, Math.min(RENEW_THROTTLE_MS, third));
 }
-//#endregion
 export { RENEW_THROTTLE_MS, keepJobLease };
 
 //# sourceMappingURL=keeper.mjs.map

package/dist/capture/db-queue/lease.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { isTerminalJob } from "../../models/capture-job.mjs";
 import { isoAt } from "./clock.mjs";
 import { attemptRef } from "./poll.mjs";
-//#region src/capture/db-queue/lease.ts
+// src/capture/db-queue/lease.ts
 /**
 * Renew the lease by another `leaseMs`. The write touches only the holder's attempt row and returns
 * it: an attempt retired by another instance reads `expired` (lost), a flagged one `cancelled`.
@@ -40,7 +40,6 @@ async function renewOwn(rt, receipt) {
 		throw error;
 	}
 }
-//#endregion
 export { extendJob, inspectJob };
 
 //# sourceMappingURL=lease.mjs.map

package/dist/capture/db-queue/lifecycle.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/db-queue/lifecycle.ts
+// src/capture/db-queue/lifecycle.ts
 /** Id no row ever has: the health probe is a primary-key read that finds nothing. */
 const HEALTH_PROBE_ID = "~health";
 /**
@@ -30,7 +30,6 @@ function buildQueueLifecycle(rt) {
 		}
 	};
 }
-//#endregion
 export { buildQueueLifecycle };
 
 //# sourceMappingURL=lifecycle.mjs.map

package/dist/capture/db-queue/operations.mjs

@@ -5,7 +5,7 @@ import { ulid } from "../../utils/ulid.mjs";
 import { attemptRowId, isTerminalJob } from "../../models/capture-job.mjs";
 import { encodePayload, toQueueEntry } from "./codec.mjs";
 import { isoAt } from "./clock.mjs";
-//#region src/capture/db-queue/operations.ts
+// src/capture/db-queue/operations.ts
 /** Insert a queued job row and wake this instance's poller; resolves to the job id. */
 async function enqueueJob(rt, job) {
 	const id = ulid();
@@ -88,7 +88,6 @@ async function cancelOne(rt, row) {
 async function flagAttempt(rt, attemptId, now) {
 	if ((await rt.model.get(attemptId))?.status === "running") await rt.model.flagCancel(attemptId, now);
 }
-//#endregion
 export { activeEntries, cancelJobs, enqueueCapture, enqueueJob, recentEntries, statusOf };
 
 //# sourceMappingURL=operations.mjs.map

package/dist/capture/db-queue/poll-loop.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { Logger } from "../../logger.mjs";
 import { PollCadence } from "./cadence.mjs";
 import { DatabaseCaptureQueue, DatabaseJob } from "./types.mjs";
-//#region src/capture/db-queue/poll-loop.d.ts
 /** Options of {@link startPollLoop}. */
 interface PollLoopOptions {
   queue: Pick<DatabaseCaptureQueue, "poll" | "waitForWork">;
@@ -25,6 +24,5 @@ interface PollLoop {
 }
 /** Start polling `queue` with `slots` concurrent jobs. */
 declare function startPollLoop(options: PollLoopOptions): PollLoop;
-//#endregion
 export { PollLoop, PollLoopOptions, startPollLoop };
 //# sourceMappingURL=poll-loop.d.mts.map

package/dist/capture/db-queue/poll-loop.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { DEFAULT_CADENCE, nextPollDelay } from "./cadence.mjs";
-//#region src/capture/db-queue/poll-loop.ts
+// src/capture/db-queue/poll-loop.ts
 /** Start polling `queue` with `slots` concurrent jobs. */
 function startPollLoop(options) {
 	const state = {
@@ -83,7 +83,6 @@ async function nudged(state) {
 	};
 	await promise;
 }
-//#endregion
 export { startPollLoop };
 
 //# sourceMappingURL=poll-loop.mjs.map

package/dist/capture/db-queue/poll.d.mts

@@ -2,9 +2,7 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import "../../adapter/capture-queue.mjs";
 import "./types.mjs";
-//#region src/capture/db-queue/poll.d.ts
 /** Longest a nack may delay a retry; larger delays are clamped. */
 declare const MAX_NACK_DELAY_MS: number;
-//#endregion
 export { MAX_NACK_DELAY_MS };
 //# sourceMappingURL=poll.d.mts.map

package/dist/capture/db-queue/poll.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { isTerminalJob, parseAttemptRowId } from "../../models/capture-job.mjs";
 import { isoAt } from "./clock.mjs";
 import { claimNext } from "./claim.mjs";
-//#region src/capture/db-queue/poll.ts
+// src/capture/db-queue/poll.ts
 /** Longest a nack may delay a retry; larger delays are clamped. */
 const MAX_NACK_DELAY_MS = 36e5;
 /**
@@ -63,7 +63,6 @@ function attemptRef(job) {
 		...parsed
 	};
 }
-//#endregion
 export { MAX_NACK_DELAY_MS, ackJob, attemptRef, nackJob, pollJob };
 
 //# sourceMappingURL=poll.mjs.map

package/dist/capture/db-queue/timers.d.mts

@@ -1,12 +1,10 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/capture/db-queue/timers.d.ts
 /** Timer seam of the database queue: production uses the global timers, tests a manual clock. */
 /** The two timer calls the queue, its wake signal and the lease keeper make. */
 interface QueueTimers {
   setTimeout(callback: () => void, ms: number): unknown;
   clearTimeout(handle: unknown): void;
 }
-//#endregion
 export { QueueTimers };
 //# sourceMappingURL=timers.d.mts.map

package/dist/capture/db-queue/timers.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/db-queue/timers.ts
+// src/capture/db-queue/timers.ts
 /** Global timers, unref'd so a waiting poll or a lease check never holds the process open. */
 const REAL_TIMERS = {
 	setTimeout: (callback, ms) => {
@@ -31,7 +31,6 @@ function repeatEvery(timers, ms, callback) {
 		timers.clearTimeout(handle);
 	};
 }
-//#endregion
 export { REAL_TIMERS, repeatEvery };
 
 //# sourceMappingURL=timers.mjs.map

package/dist/capture/db-queue/types.d.mts

@@ -6,7 +6,6 @@ import { CaptureJob, LeaseRenewal, PollableCaptureQueue, PollableJob } from "../
 import { CaptureJobKind } from "../../schema/capture-job.mjs";
 import { QueueTimers } from "./timers.mjs";
 import "../../models/capture-job.mjs";
-//#region src/capture/db-queue/types.d.ts
 /** Options of {@link createDatabaseCaptureQueue}. */
 interface DatabaseCaptureQueueOptions {
   /** Job kinds this instance polls (default `["capture"]`); enqueue accepts every kind. */
@@ -78,6 +77,5 @@ interface DatabaseCaptureQueue extends PollableCaptureQueue {
    */
   waitForWork(ms: number): Promise<boolean>;
 }
-//#endregion
 export { DEFAULT_LEASE_MS, DEFAULT_RETRIES, DatabaseCaptureQueue, DatabaseCaptureQueueOptions, DatabaseJob, QueueJobInput };
 //# sourceMappingURL=types.d.mts.map