@shivaedev/jobs 0.25.0 → 0.27.0

package/dist/server/testing.js

@@ -1,6 +1,7 @@
 import { Duration, Effect, Redacted } from "effect";
+import { defaultClientFactory } from "#defaultClientFactory.ts";
 import { PgBossTestingError } from "#error.ts";
-import { nativeClient } from "#internal/nativeClient.ts";
+import { testingFetches } from "#internal/adapters/testingFetches.ts";
 import { testingClient } from "#internal/testingClient.ts";
 import { testingDeferrals } from "#internal/testingDeferrals.ts";
 import { testingIdle } from "#internal/testingIdle.ts";
@@ -8,9 +9,11 @@ import { testingOperation, testingReadout } from "#internal/testingReadout.ts";
 import { testingSchedules } from "#internal/testingSchedules.ts";
 import { testingSignal } from "#internal/testingSignal.ts";
 import { testingSnapshot } from "#internal/testingSnapshot.ts";
+import { testingWaits } from "#internal/testingWaits.ts";
 export const testRetryPolicy = Object.freeze({ retryBackoff: false, retryDelay: 0 });
 export function makePgBossTesting(options = {}) {
     let current;
+    let fetches;
     let schema = "pgboss";
     const signal = testingSignal();
     const work = { batches: new Set(), queues: new Set() };
@@ -33,12 +36,14 @@ export function makePgBossTesting(options = {}) {
             throw new Error("A testing controller owns one jobs client; create a controller per runtime");
         }
         schema = clientOptions.schema ?? "pgboss";
-        current = nativeClient({ ...clientOptions, "__test__enableSpies": true });
+        current = defaultClientFactory({ ...clientOptions, "__test__enableSpies": true });
+        fetches = testingFetches(current.getDb(), signal.changed);
         return testingClient(current, clientOptions.schema ?? "pgboss", controls);
     };
     return {
         ...testingDeferrals(client, () => schema, signal.changed),
         ...testingSchedules(client, signal.changed),
+        ...testingWaits(client, () => fetches, signal),
         checkBatchWindow: (queue, millisecondsPerJob) => testingOperation("checkBatchWindow", async () => {
             const stored = await client().getQueue(queue.name);
             if (stored === null) {

package/dist/server/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/server/testing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/server/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAuB,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAoB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAgBzD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;AAMrF,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAyB,EAAE;IACnE,IAAI,OAA2B,CAAC;IAChC,IAAI,OAAmC,CAAC;IACxC,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAgB,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IACpE,MAAM,QAAQ,GAAG;QAChB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,IAAI,GAAG,EAAkB;QACtC,aAAa,EAAE,IAAI,GAAG,EAAkB;QACxC,QAAQ,EAAE,IAAI,GAAG,EAAU;QAC3B,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,IAAI;KACJ,CAAC;IACF,SAAS,MAAM;QACd,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,MAAM,aAAa,GAAwB,CAAC,aAAa,EAAE,EAAE;QAC5D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,GAAG,aAAa,CAAC,MAAM,IAAI,QAAQ,CAAC;QAC1C,OAAO,GAAG,oBAAoB,CAAC,EAAE,GAAG,aAAa,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1D,OAAO,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,IAAI,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3E,CAAC,CAAC;IACF,OAAO;QACN,GAAG,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;QACzD,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;QAC3C,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;QAC9C,gBAAgB,EAAE,CAAC,KAAsD,EAAE,kBAA0B,EAAE,EAAE,CACxG,gBAAgB,CACf,kBAAkB,EAClB,KAAK,IAAI,EAAE;YACV,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;gBACpE,MAAM,IAAI,UAAU,CAAC,6CAA6C,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC,GAAG,kBAAkB,CAAC;YAC5E,IAAI,QAAQ,IAAI,MAAM,CAAC,eAAe,GAAG,IAAI,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;YAClF,CAAC;QACF,CAAC,EACD,KAAK,CAAC,IAAI,CACV;QACF,kBAAkB,EAAE,CAAC,QAAgB,EAAE,EAAE,CACxC,gBAAgB,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;YACjD,IAAI,CAAC,MAAM,MAAM,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACnD,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;YAChE,CAAC;QACF,CAAC,CAAC;QACH,aAAa;QACb,WAAW,EAAE,CAAC,KAAoC,EAAE,QAAgB,EAAE,EAAE,CACvE,MAAM,CAAC,GAAG,CAAC;YACV,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC/H,GAAG,EAAE,GAAG,EAAE;gBACT,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;oBACrD,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;gBAC7D,CAAC;gBACD,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAChD,CAAC;SACD,CAAC;QACH,QAAQ,EAAE,CAAC,KAAoC,EAAE,QAAwB,EAAE,EAAE,CAC5E,MAAM,CAAC,GAAG,CAAC;YACV,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC5H,GAAG,EAAE,GAAG,EAAE;gBACT,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC3E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,IAAI,EAAE,CAAC;oBAC3D,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;gBACvE,CAAC;gBACD,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;YACxE,CAAC;SACD,CAAC;QACH,YAAY,EAAE,CAAC,KAAoC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAChI,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,gBAAgB,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,CAAC;QAChF,QAAQ,EAAE,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC;QAC/C,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;KAC5D,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/jobs",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "Effect-native jobs and lifecycle management for pg-boss",
   "keywords": [
     "effect"
@@ -48,16 +48,16 @@
     "README.md"
   ],
   "dependencies": {
-    "@shivaedev/errors": "0.1.3",
+    "@shivaedev/errors": "0.3.0",
     "@shivaedev/service": "0.6.0",
     "@shivaedev/sql": "0.27.0"
   },
   "devDependencies": {
     "@shivaedev/http": "0.3.1",
-    "@shivaedev/quality": "0.48.2",
+    "@shivaedev/quality": "0.50.0",
     "@shivaedev/test": "0.12.0",
     "@shivaedev/test-sql": "0.15.0",
-    "@shivaedev/test-story": "0.28.0",
+    "@shivaedev/test-story": "0.30.0",
     "@types/node": "24.19.2",
     "effect": "4.0.6",
     "pg-boss": "12.38.0",

package/src/server/adapters/clientErrorReporter.ts

@@ -0,0 +1,8 @@
+import { Effect } from "effect";
+
+export const clientErrorReporter = Effect.fnUntraced(function* <R>(report: (error: Error) => Effect.Effect<unknown, never, R>) {
+	const run = Effect.runPromiseWith(yield* Effect.context<R>());
+	return (error: Error): void => {
+		void run(Effect.exit(report(error)));
+	};
+});

package/src/server/adapters/installSchema.ts

@@ -0,0 +1,68 @@
+import { Effect, Schema } from "effect";
+import { SqlClient } from "effect/sql";
+import type { Connection } from "effect/sql/SqlConnection";
+import { getConstructionPlans, getMigrationPlans, PgBoss } from "pg-boss";
+import pgBossPackage from "pg-boss/package.json" with { type: "json" };
+import { jobStorePlans } from "#internal/jobStorePlans.ts";
+import type { PgBossSchemaOptions } from "#schema.ts";
+import { runSchemaPlan } from "./runSchemaPlan.ts";
+import { resumeSchemaIndexes } from "./schemaIndexBuilds.ts";
+
+const Partitions = Schema.Array(
+	Schema.Struct({
+		policy: Schema.String,
+		tableName: Schema.String,
+	}),
+);
+async function installNativeSchema(
+	connection: Connection,
+	options: PgBossSchemaOptions,
+	run: <A, E>(effect: Effect.Effect<A, E>) => Promise<A>,
+): Promise<void> {
+	const schema = options.schema ?? "pgboss";
+	const construction = getConstructionPlans(schema);
+	const client = new PgBoss({
+		db: { executeSql: async (text, values = []) => ({ rows: Array.from(await run(connection.executeUnprepared(text, values, undefined))) }) },
+		schema,
+	});
+	if (!(await client.isInstalled())) {
+		await runSchemaPlan(connection, construction, run);
+		return;
+	}
+	const version = await client.schemaVersion();
+	if (version === null) {
+		throw new Error("The pg-boss version table is empty");
+	}
+	if (version > pgBossPackage.pgboss.schema) {
+		return;
+	}
+	if (version >= 27) {
+		await resumeSchemaIndexes(client, schema);
+	}
+	if (version < pgBossPackage.pgboss.schema) {
+		const partitionTables = Schema.decodeUnknownSync(Partitions)(
+			await run(connection.executeUnprepared(`SELECT table_name AS "tableName", policy FROM ${schema}.queue WHERE partition = true`, [], undefined)),
+		);
+		await runSchemaPlan(connection, getMigrationPlans(schema, version, { partitionTables: Array.from(partitionTables) }), run, {
+			schema,
+			version: pgBossPackage.pgboss.schema,
+		});
+		await resumeSchemaIndexes(client, schema);
+	}
+}
+
+export const installSchema = Effect.fnUntraced(function* (options: PgBossSchemaOptions) {
+	const sql = yield* SqlClient.SqlClient;
+	const connection = yield* sql.reserve;
+	const run = Effect.runPromiseWith(yield* Effect.context<never>());
+	yield* Effect.tryPromise({
+		catch: (error) => error,
+		try: async (signal) => {
+			const execute: typeof run = (effect) => run(effect, { signal });
+			await installNativeSchema(connection, options, execute);
+		},
+	});
+	for (const plan of jobStorePlans(options.schema ?? "pgboss")) {
+		yield* connection.executeRaw(plan, []);
+	}
+});

package/src/server/{internal → adapters}/registerWorker.ts

@@ -1,27 +1,26 @@
-import { type Context, Effect, Fiber, Scope } from "effect";
+import { Effect, Fiber, Scope } from "effect";
 import type { Job, WorkOptions } from "pg-boss";
 import type { PgBossClient } from "#client.ts";
 import { toPgBossError } from "#error.ts";
-import { batchHandler, type PgBossRunner } from "#internal/batchHandler.ts";
+import { batchHandler } from "#internal/batchHandler.ts";
 import { deferrableAttempt } from "#internal/deferrableAttempt.ts";
 import { retryWake } from "#internal/retryWake.ts";
 import { traceJob } from "#internal/tracing.ts";
 
-export const registerWorker = Effect.fnUntraced(function* (
+export const registerWorker = Effect.fnUntraced(function* <R>(
 	client: PgBossClient,
 	name: string,
 	options: WorkOptions,
-	run: (job: Job<unknown>, deadline: number) => Effect.Effect<unknown, unknown, unknown>,
+	run: (job: Job<unknown>, deadline: number) => Effect.Effect<unknown, unknown, R>,
 	scope: Scope.Scope,
 	schema: string,
 	maxDeferrals: number,
-	context: Context.Context<unknown>,
-	execute: PgBossRunner,
 	graceful: boolean,
 ) {
+	const execute = Effect.runPromiseWith(yield* Effect.context<R>());
 	const fibers = yield* Scope.fork(scope);
 	function runJob(job: Job<unknown>, deadline: number) {
-		return Effect.provide(traceJob(deferrableAttempt(run(job, deadline), client, schema, job, maxDeferrals), job, name), context);
+		return traceJob(deferrableAttempt(run(job, deadline), client, schema, job, maxDeferrals), job, name);
 	}
 	function afterFailure(attempt: Job<unknown>) {
 		return retryWake(client, name, attempt.id, registration).pipe(Effect.forkIn(fibers), Effect.asVoid);

package/src/server/adapters/retireJobs.ts

@@ -0,0 +1,30 @@
+import { Effect } from "effect";
+import type { PgBossClient } from "#client.ts";
+import type { JobRegistration } from "#definition.ts";
+import { toPgBossError } from "#error.ts";
+import { deadLetterQueueName } from "#health.ts";
+import { registrationNames } from "#internal/register.ts";
+
+export const retireJobs = Effect.fnUntraced(function* (client: PgBossClient, jobs: readonly JobRegistration[], retired: readonly string[]) {
+	yield* Effect.try({
+		catch: (error) => toPgBossError("register", error),
+		try: () => {
+			const active = registrationNames(jobs).flatMap((name) => [name, deadLetterQueueName(name)]);
+			if (retired.some((name) => active.includes(name))) {
+				throw new TypeError("Retired queues must not be registered or used as dead-letter queues");
+			}
+		},
+	});
+	for (const name of retired) {
+		yield* Effect.tryPromise({
+			catch: (error) => toPgBossError("register", error, name),
+			try: async () => {
+				if (client.deleteQueue === undefined) {
+					throw new TypeError("This pg-boss client does not support deleteQueue");
+				}
+				await client.offWork(name);
+				await client.deleteQueue(name);
+			},
+		});
+	}
+});

package/src/server/adapters/workerDiagnostics.ts

@@ -0,0 +1,28 @@
+import { Context, Effect, Logger, References } from "effect";
+import { redact } from "@shivaedev/errors/redact.ts";
+import { redactDiagnosticCause } from "@shivaedev/errors/redactCause.ts";
+import { isSensitiveKey, REDACTED } from "@shivaedev/errors/sensitive.ts";
+
+function maskedLogger(logger: Logger.Logger<unknown, unknown>) {
+	return Logger.make((options) => {
+		const context = options.fiber.context;
+		const annotations = Object.fromEntries(
+			Object.entries(options.fiber.getRef(References.CurrentLogAnnotations)).map(([key, value]) => [
+				key,
+				isSensitiveKey(key) ? REDACTED : redact(value),
+			]),
+		);
+		options.fiber.setContext(Context.add(context, References.CurrentLogAnnotations, annotations));
+		try {
+			return logger.log({ ...options, cause: redactDiagnosticCause(options.cause), message: redact(options.message) });
+		} finally {
+			options.fiber.setContext(context);
+		}
+	});
+}
+
+export function workerDiagnostics<A, E, R>(effect: Effect.Effect<A, E, R>) {
+	return Effect.flatMap(Logger.CurrentLoggers, (loggers) =>
+		Effect.provideService(effect, Logger.CurrentLoggers, new Set([...loggers].map(maskedLogger))),
+	);
+}

package/src/server/client.ts

@@ -11,11 +11,11 @@ import type {
 	StopOptions,
 	WorkOptions,
 } from "pg-boss";
-import { nativeClient } from "#internal/nativeClient.ts";
 
 export interface PgBossClient {
 	readonly complete?: PgBoss["complete"];
 	readonly createQueue: (name: string, options?: Omit<Queue, "name">) => Promise<void>;
+	readonly deleteQueue?: PgBoss["deleteQueue"];
 	readonly fail?: PgBoss["fail"];
 	readonly findJobs?: (name: string, options?: FindJobsOptions) => Promise<readonly JobWithMetadata<unknown>[]>;
 	readonly getDb?: PgBoss["getDb"];
@@ -30,11 +30,10 @@ export interface PgBossClient {
 	readonly send: (name: string, data?: object | null, options?: SendOptions) => Promise<string | null>;
 	readonly start: () => Promise<unknown>;
 	readonly stop: (options?: StopOptions) => Promise<void>;
+	readonly unschedule?: PgBoss["unschedule"];
 	readonly update?: PgBoss["update"];
 	readonly updateQueue?: PgBoss["updateQueue"];
 	readonly work: (name: string, options: WorkOptions, handler: (jobs: readonly Job<unknown>[]) => Promise<unknown>) => Promise<string>;
 }
 
 export type PgBossClientFactory = (options: ConstructorOptions) => PgBossClient;
-
-export const defaultClientFactory: PgBossClientFactory = nativeClient;

package/src/server/{internal/nativeClient.ts → defaultClientFactory.ts}

@@ -1,7 +1,7 @@
 import { Socket } from "node:net";
 import { type ConstructorOptions, PgBoss } from "pg-boss";
 
-export function nativeClient(options: ConstructorOptions) {
+export function defaultClientFactory(options: ConstructorOptions) {
 	const disconnected = new Set<Promise<void>>();
 	const config = {
 		...options,

package/src/server/{internal/scheduleDefinition.ts → defineSchedule.ts}

@@ -1,7 +1,7 @@
 import type { DefineScheduleOptions, ScheduleDefinition } from "#definition.ts";
 import { maxDeferrals, nativeQueueOptions } from "#internal/definitionOptions.ts";
 
-export function scheduleDefinition<const TName extends string>(options: DefineScheduleOptions<TName>): ScheduleDefinition<TName> {
+export function defineSchedule<const TName extends string>(options: DefineScheduleOptions<TName>): ScheduleDefinition<TName> {
 	const definition: ScheduleDefinition<TName> = {
 		_tag: "ScheduleDefinition",
 		cron: options.cron,

package/src/server/definition.ts

@@ -1,7 +1,6 @@
 import { Clock, Duration, Effect, Schema } from "effect";
 import type { Job, policies, Queue, ScheduleOptions, WorkOptions } from "pg-boss";
 import { maxDeferrals, nativeQueueOptions } from "#internal/definitionOptions.ts";
-import { scheduleDefinition } from "#internal/scheduleDefinition.ts";
 
 export class RetryAt extends Schema.TaggedError<RetryAt>()("RetryAt", {
 	at: Schema.DateTimeUtc,
@@ -123,10 +122,6 @@ export interface DefineScheduleOptions<TName extends string> {
 	readonly worker?: WorkOptions;
 }
 
-export function defineSchedule<const TName extends string>(options: DefineScheduleOptions<TName>): ScheduleDefinition<TName> {
-	return scheduleDefinition(options);
-}
-
 export function jobContext(job: Job<unknown>, deadline: number): JobContext {
 	return {
 		expireInSeconds: job.expireInSeconds,

package/src/server/error.ts

@@ -1,4 +1,4 @@
-import { Cause, Data, Redacted } from "effect";
+import { Cause, Data, Duration, Redacted } from "effect";
 import { failureOutput } from "#internal/failureOutput.ts";
 
 export type PgBossOperation =
@@ -76,6 +76,16 @@ export class PgBossTestingError extends Data.TaggedError("PgBossTestingError")<{
 	readonly queue?: string | undefined;
 }> {}
 
+export class PgBossWaitError extends Data.TaggedError("PgBossWaitError")<{
+	readonly lastSeen: string;
+	readonly waitingFor: string;
+	readonly within: Duration.Duration;
+}> {
+	override get message(): string {
+		return `Gave up after ${Duration.format(this.within)} waiting until ${this.waitingFor}; last seen: ${this.lastSeen}`;
+	}
+}
+
 export function toPgBossError(operation: PgBossOperation, error: unknown, queue?: string): PgBossError {
 	return new PgBossError({
 		operation,

package/src/server/health.ts

@@ -48,6 +48,7 @@ export interface ListedJob<TData> {
 export interface DeadLetteredJob<TData> extends ListedJob<TData> {
 	readonly sourceId: Option.Option<string>;
 	readonly sourceOutput: JobFailure | null;
+	readonly sourceQueue: string;
 }
 
 export interface JobPageOptions {

package/src/server/internal/adapters/testingFetches.ts

@@ -0,0 +1,36 @@
+import type { PgBoss } from "pg-boss";
+
+// pg-boss offers no hook for a worker fetch that finds nothing, so the controller recognizes its claim statement on the client's database.
+const claim = /UPDATE\s+\S+\s+j\s+SET\s+state\s*=\s*'active'/u;
+const claimedQueue = /\bj\.name\s*=\s*'(?<queue>[^']+)'/u;
+
+export interface TestingFetches {
+	readonly begun: (queue: string) => number;
+	readonly passedSince: (queue: string, begun: number) => number;
+}
+
+export function testingFetches(db: ReturnType<PgBoss["getDb"]>, changed: () => void): TestingFetches {
+	const begun = new Map<string, number>();
+	const passed = new Map<string, number[]>();
+	const executeSql = db.executeSql.bind(db);
+	db.executeSql = async (text: string, values?: unknown[]) => {
+		const queue = claim.test(text) ? claimedQueue.exec(text)?.groups?.queue : undefined;
+		if (queue === undefined) {
+			return executeSql(text, values);
+		}
+		const ordinal = (begun.get(queue) ?? 0) + 1;
+		begun.set(queue, ordinal);
+		try {
+			return await executeSql(text, values);
+		} finally {
+			const ordinals = passed.get(queue) ?? [];
+			ordinals.push(ordinal);
+			passed.set(queue, ordinals);
+			changed();
+		}
+	};
+	return {
+		begun: (queue) => begun.get(queue) ?? 0,
+		passedSince: (queue, mark) => (passed.get(queue) ?? []).filter((ordinal) => ordinal > mark).length,
+	};
+}

package/src/server/internal/batchHandler.ts

@@ -24,7 +24,14 @@ function settleAttempt(
 	});
 }
 
-export type PgBossRunner = <A, E>(effect: Effect.Effect<A, E>) => Promise<A>;
+const interruptAt = Effect.fnUntraced(function* (deadline: number) {
+	let remaining = deadline - (yield* Clock.currentTimeMillis);
+	while (remaining > 0) {
+		yield* Effect.sleep(remaining);
+		remaining = deadline - (yield* Clock.currentTimeMillis);
+	}
+	return yield* Effect.interrupt;
+});
 
 function aborted(signal: AbortSignal) {
 	return Effect.callback<never>((resume) => {
@@ -40,11 +47,11 @@ function aborted(signal: AbortSignal) {
 	});
 }
 
-export function batchHandler(
+export function batchHandler<R>(
 	client: PgBossClient,
 	name: string,
 	schema: string,
-	run: (job: Job<unknown>, deadline: number) => Effect.Effect<unknown, unknown>,
+	run: (job: Job<unknown>, deadline: number) => Effect.Effect<unknown, unknown, R>,
 	afterFailure: (job: Job<unknown>) => Effect.Effect<void, unknown> = () => Effect.void,
 ) {
 	const complete = client.complete?.bind(client);
@@ -61,11 +68,7 @@ export function batchHandler(
 		if (remaining <= 0) {
 			return "expired";
 		}
-		const exit = yield* run(job, deadline).pipe(
-			Effect.timeoutOrElse({ duration: remaining, orElse: () => Effect.interrupt }),
-			Effect.raceFirst(aborted(job.signal)),
-			Effect.exit,
-		);
+		const exit = yield* run(job, deadline).pipe(Effect.raceFirst(interruptAt(deadline)), Effect.raceFirst(aborted(job.signal)), Effect.exit);
 		if (job.signal.aborted || (Exit.isFailure(exit) && Cause.hasInterrupts(exit.cause))) {
 			return "interrupted";
 		}

package/src/server/internal/deadLetterResolutionPlan.ts

@@ -0,0 +1,28 @@
+import { quotedSchema } from "#internal/storedRows.ts";
+
+export function deadLetterResolutionPlan(schema: string): string {
+	const quoted = quotedSchema(schema);
+	const jobTable = `${quoted}.job`.replaceAll("'", "''");
+	const body = `BEGIN
+		PERFORM pg_advisory_xact_lock(hashtextextended('${jobTable}.effect_dead_letter_resolution', 0));
+		CREATE OR REPLACE FUNCTION ${quoted}.effect_dead_letter_resolution() RETURNS trigger LANGUAGE plpgsql AS $resolve$
+		BEGIN
+			DELETE FROM ${quoted}.job
+			WHERE name = NEW.name || '-dlq' AND source_name = NEW.name AND source_id = NEW.id
+				AND source_created_on = NEW.created_on;
+			RETURN NEW;
+		END
+		$resolve$;
+		IF NOT EXISTS (
+			SELECT 1 FROM pg_trigger WHERE tgrelid = '${jobTable}'::regclass AND tgname = 'effect_dead_letter_resolution'
+		) THEN
+			CREATE TRIGGER effect_dead_letter_resolution AFTER UPDATE OF state ON ${quoted}.job
+			FOR EACH ROW WHEN (NEW.state = 'completed' AND OLD.state IS DISTINCT FROM NEW.state)
+			EXECUTE FUNCTION ${quoted}.effect_dead_letter_resolution();
+			DELETE FROM ${quoted}.job AS copy USING ${quoted}.job AS source
+			WHERE source.state = 'completed' AND copy.name = source.name || '-dlq'
+				AND copy.source_name = source.name AND copy.source_id = source.id AND copy.source_created_on = source.created_on;
+		END IF;
+	END`;
+	return `DO '${body.replaceAll("'", "''")}'`;
+}

package/src/server/internal/enqueueFor.ts

@@ -1,14 +1,14 @@
 import { Effect, Option, Redacted, Schema } from "effect";
+import { transactionDb } from "#adapters/transactionDb.ts";
 import type { PgBossClient } from "#client.ts";
 import { PgBossPayloadError, toPgBossError } from "#error.ts";
 import { capturePayload } from "#internal/tracing.ts";
-import { transactionDb } from "#internal/transactionDb.ts";
 import type { PgBossService } from "#service.ts";
 
 export function enqueueFor(client: PgBossClient): PgBossService["enqueue"] {
 	return (queue, payload, options) =>
 		Effect.gen(function* () {
-			const encoded = yield* Schema.encodeUnknownEffect(queue.schema)(payload).pipe(
+			const encoded = yield* Schema.encodeUnknownEffect(Schema.toCodecJson(queue.schema))(payload).pipe(
 				Effect.mapError((error) => new PgBossPayloadError({ direction: "encode", original: Redacted.make(error), queue: queue.name })),
 			);
 			if (typeof encoded !== "object" || encoded === null) {

package/src/server/internal/jobControl.ts

@@ -1,4 +1,5 @@
 import { Effect, Option } from "effect";
+import { redact } from "@shivaedev/errors/redact.ts";
 import type { PgBossClient } from "#client.ts";
 import { toPgBossError } from "#error.ts";
 import { decodeStoredData } from "#internal/storedRows.ts";
@@ -18,7 +19,7 @@ export function getJobFor(client: PgBossClient): PgBossService["getJob"] {
 			Effect.flatMap((job) =>
 				job === undefined
 					? Effect.succeed(Option.none())
-					: decodeStoredData(queue, job.data).pipe(Effect.map((data) => Option.some({ ...job, data }))),
+					: decodeStoredData(queue, job.data).pipe(Effect.map((data) => Option.some({ ...job, data: redact(data) }))),
 			),
 		);
 }

package/src/server/internal/jobStorePlans.ts

@@ -0,0 +1,6 @@
+import { deadLetterResolutionPlan } from "#internal/deadLetterResolutionPlan.ts";
+import { deferralStorePlan } from "#internal/deferralStorePlan.ts";
+
+export function jobStorePlans(schema: string): readonly string[] {
+	return [deferralStorePlan(schema), deadLetterResolutionPlan(schema)];
+}

package/src/server/internal/lifecycle.ts

@@ -1,8 +1,9 @@
 import { Effect } from "effect";
 import type { ConstructorOptions, StopOptions } from "pg-boss";
-import { defaultClientFactory, type PgBossClient, type PgBossClientFactory } from "#client.ts";
+import type { PgBossClient, PgBossClientFactory } from "#client.ts";
+import { defaultClientFactory } from "#defaultClientFactory.ts";
 import { PgBossClientOptionsError, type PgBossError, toPgBossError } from "#error.ts";
-import { deferralStorePlan } from "#internal/deferralStorePlan.ts";
+import { jobStorePlans } from "#internal/jobStorePlans.ts";
 import { acquireCachedClient, releaseCachedClient } from "./clientCache.ts";
 import { observeClientErrors } from "./clientErrors.ts";
 
@@ -24,7 +25,9 @@ async function startClient(options: AcquireClientOptions, report: (error: Error)
 	try {
 		await client.start();
 		if (options.constructor.migrate !== false && client.getDb !== undefined) {
-			await client.getDb().executeSql(deferralStorePlan(options.constructor.schema ?? "pgboss"));
+			for (const plan of jobStorePlans(options.constructor.schema ?? "pgboss")) {
+				await client.getDb().executeSql(plan);
+			}
 		}
 		return client;
 	} catch (error) {

package/src/server/internal/listJobs.ts

@@ -1,4 +1,5 @@
 import { Effect, Option, Redacted, Schema } from "effect";
+import { redact } from "@shivaedev/errors/redact.ts";
 import type { PgBossClient } from "#client.ts";
 import type { JobPayloadSchema } from "#definition.ts";
 import { type PgBossError, PgBossPayloadError, toPgBossError } from "#error.ts";
@@ -50,7 +51,10 @@ export function failedJobsFor(client: PgBossClient, schema: string): PgBossServi
 }
 
 export function deadLetteredJobsFor(client: PgBossClient, schema: string): PgBossService["deadLetteredJobs"] {
-	return (queue, options) => listJobs(client, schema, "deadLetteredJobs", queue, options);
+	return (queue, options) =>
+		listJobs(client, schema, "deadLetteredJobs", queue, options).pipe(
+			Effect.map(({ jobs, next }) => ({ jobs: jobs.map((job) => ({ ...job, sourceQueue: queue.name })), next })),
+		);
 }
 
 const listJobs = Effect.fnUntraced(function* <const TName extends string, const TPayload extends JobPayloadSchema | typeof Schema.Null>(
@@ -59,7 +63,11 @@ const listJobs = Effect.fnUntraced(function* <const TName extends string, const
 	listing: Listing,
 	queue: { readonly name: TName; readonly schema: TPayload },
 	options: JobPageOptions,
-): Effect.fn.Return<JobPage<DeadLetteredJob<TPayload["Type"]>>, PgBossError | PgBossPayloadError | Schema.SchemaError, TPayload["DecodingServices"]> {
+): Effect.fn.Return<
+	JobPage<Omit<DeadLetteredJob<unknown>, "sourceQueue">>,
+	PgBossError | PgBossPayloadError | Schema.SchemaError,
+	TPayload["DecodingServices"]
+> {
 	const { cursor: after, limit } = yield* Schema.decodeUnknownEffect(PageOptions)(options);
 	const rows = yield* Effect.tryPromise({
 		catch: (error) => toPgBossError(listing, error, queue.name),
@@ -102,7 +110,7 @@ const listJobs = Effect.fnUntraced(function* <const TName extends string, const
 	const next = decodedRows.length > limit && last !== undefined ? Option.some(Schema.encodeSync(Cursor)([last.cursorAt, last.id])) : Option.none();
 	return yield* Effect.forEach(page, ({ cursorAt: _, data, ...row }) =>
 		decodeStoredData(queue, data).pipe(
-			Effect.map((decoded) => ({ ...row, attempt: Option.isSome(row.startedOn) ? row.retryCount + 1 : 0, data: decoded })),
+			Effect.map((decoded) => ({ ...row, attempt: Option.isSome(row.startedOn) ? row.retryCount + 1 : 0, data: redact(decoded) })),
 		),
 	).pipe(Effect.map((jobs) => ({ jobs, next })));
 });

package/src/server/internal/makeService.ts

@@ -13,7 +13,7 @@ export function makeService(client: PgBossClient, names: readonly string[], sche
 		enqueue: enqueueFor(client),
 		failedJobs: failedJobsFor(client, schema),
 		getJob: getJobFor(client),
-		health: () => healthFor(client, names),
+		health: (queues) => healthFor(client, queues === undefined ? names : queues.map((queue) => queue.name)),
 		retry: retryFor(client),
 	};
 }