@shivaedev/effect-pg-boss 0.0.0

package/dist/internal/register.js

@@ -0,0 +1,72 @@
+import { Effect, Redacted, Schema } from "effect";
+import { jobContext, } from "../definition.js";
+import { PgBossPayloadError, toPgBossError } from "../error.js";
+import { deadLetterQueueName } from "../health.js";
+const queueOptions = (options) => ({
+    retryBackoff: true,
+    retryLimit: 3,
+    ...options,
+});
+const runQueueWorker = (worker, job, context) => Effect.runPromise(Schema.decodeUnknownEffect(worker.queue.schema)(job.data).pipe(Effect.mapError((error) => new PgBossPayloadError({
+    direction: "decode",
+    original: Redacted.make(error),
+    queue: worker.queue.name,
+})), Effect.flatMap((payload) => worker.handler(payload, jobContext(job))), Effect.provide(context)), { signal: job.signal });
+const registerQueue = async (client, worker, context, replaceWorker) => {
+    const name = worker.queue.name;
+    const deadLetter = deadLetterQueueName(name);
+    if (replaceWorker)
+        await client.offWork(name);
+    await client.createQueue(deadLetter);
+    await client.createQueue(name, {
+        ...queueOptions(worker.queue.queueOptions),
+        deadLetter,
+    });
+    await client.work(name, worker.queue.workerOptions, async (jobs) => {
+        for (const job of jobs)
+            await runQueueWorker(worker, job, context);
+    });
+};
+const registerSchedule = async (client, worker, context, replaceWorker) => {
+    const { schedule } = worker;
+    const deadLetter = deadLetterQueueName(schedule.name);
+    if (replaceWorker)
+        await client.offWork(schedule.name);
+    await client.createQueue(deadLetter);
+    await client.createQueue(schedule.name, {
+        ...queueOptions(schedule.queueOptions),
+        deadLetter,
+    });
+    await client.work(schedule.name, schedule.workerOptions, async (jobs) => {
+        for (const job of jobs) {
+            await Effect.runPromise(Effect.provide(worker.effect, context), {
+                signal: job.signal,
+            });
+        }
+    });
+    await client.schedule(schedule.name, schedule.cron, null, schedule.scheduleOptions);
+};
+export const registrationNames = (registrations) => {
+    const names = registrations.map((registration) => registration._tag === "QueueWorker"
+        ? registration.queue.name
+        : registration.schedule.name);
+    if (new Set(names).size !== names.length) {
+        throw new TypeError("pg-boss job names must be unique");
+    }
+    return names;
+};
+export const registerJobs = (client, registrations, context, replaceWorkers) => Effect.tryPromise({
+    try: async () => {
+        registrationNames(registrations);
+        for (const registration of registrations) {
+            if (registration._tag === "QueueWorker") {
+                await registerQueue(client, registration, context, replaceWorkers);
+            }
+            else {
+                await registerSchedule(client, registration, context, replaceWorkers);
+            }
+        }
+    },
+    catch: (error) => toPgBossError("register", error),
+});
+//# sourceMappingURL=register.js.map

package/dist/internal/register.js.map

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

package/dist/internal/service.d.ts

@@ -0,0 +1,4 @@
+import type { PgBossService } from "../service.js";
+import type { PgBossClient } from "./client.js";
+export declare const makeService: (client: PgBossClient, names: readonly string[]) => PgBossService;
+//# sourceMappingURL=service.d.ts.map

package/dist/internal/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/internal/service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,eAAO,MAAM,WAAW,GACvB,QAAQ,YAAY,EACpB,OAAO,SAAS,MAAM,EAAE,KACtB,aAqCD,CAAC"}

package/dist/internal/service.js

@@ -0,0 +1,24 @@
+import { Effect, Option, Redacted, Schema } from "effect";
+import { PgBossPayloadError, toPgBossError, } from "../error.js";
+import { healthFor } from "./health.js";
+export const makeService = (client, names) => ({
+    enqueue: (queue, payload, options) => Schema.encodeUnknownEffect(queue.schema)(payload).pipe(Effect.mapError((error) => new PgBossPayloadError({
+        direction: "encode",
+        original: Redacted.make(error),
+        queue: queue.name,
+    })), Effect.flatMap((encoded) => {
+        if (typeof encoded !== "object" || encoded === null) {
+            return Effect.fail(new PgBossPayloadError({
+                direction: "encode",
+                original: Redacted.make(new TypeError("pg-boss payloads must encode to objects")),
+                queue: queue.name,
+            }));
+        }
+        return Effect.tryPromise({
+            try: () => client.send(queue.name, encoded, options),
+            catch: (error) => toPgBossError("enqueue", error, queue.name),
+        }).pipe(Effect.map(Option.fromNullishOr));
+    })),
+    health: healthFor(client, names),
+});
+//# sourceMappingURL=service.js.map

package/dist/internal/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/internal/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAEN,kBAAkB,EAClB,aAAa,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GAAG,CAC1B,MAAoB,EACpB,KAAwB,EACR,EAAE,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CACpC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CACrD,MAAM,CAAC,QAAQ,CACd,CAAC,KAAK,EAAE,EAAE,CACT,IAAI,kBAAkB,CAAC;QACtB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9B,KAAK,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CACH,EACD,MAAM,CAAC,OAAO,CACb,CACC,OAAO,EAIN,EAAE;QACH,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrD,OAAO,MAAM,CAAC,IAAI,CACjB,IAAI,kBAAkB,CAAC;gBACtB,SAAS,EAAE,QAAQ;gBACnB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CACtB,IAAI,SAAS,CAAC,yCAAyC,CAAC,CACxD;gBACD,KAAK,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CACF,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,UAAU,CAAC;YACxB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;YACpD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;SAC7D,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3C,CAAC,CACD,CACD;IACF,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;CAChC,CAAC,CAAC"}

package/dist/service.d.ts

@@ -0,0 +1,27 @@
+import { Context, Effect, Layer, type Option, type Schema } from "effect";
+import type { ConstructorOptions, SendOptions, StopOptions } from "pg-boss";
+import type { JobPayloadSchema, JobRegistration, QueueDefinition, RegistrationRequirements } from "./definition.js";
+import type { PgBossError, PgBossPayloadError } from "./error.js";
+import type { JobsHealth } from "./health.js";
+import type { PgBossClientFactory } from "./internal/client.js";
+export interface PgBossService {
+    readonly enqueue: <const Name extends string, const Payload extends JobPayloadSchema>(queue: QueueDefinition<Name, Payload>, payload: Schema.Schema.Type<Payload>, options?: SendOptions) => Effect.Effect<Option.Option<string>, PgBossError | PgBossPayloadError, Payload["EncodingServices"]>;
+    readonly health: Effect.Effect<JobsHealth, PgBossError>;
+}
+interface PgBossIdentifier {
+    readonly _pgBossIdentifier: unique symbol;
+}
+export type PgBossLayerOptions<Registrations extends readonly JobRegistration[], ErrorRequirements> = ConstructorOptions & {
+    /** Override client construction for compatible clients or deterministic tests. */
+    readonly clientFactory?: PgBossClientFactory;
+    readonly developmentCacheKey?: string | symbol;
+    readonly jobs: Registrations;
+    readonly onError?: (error: Error) => Effect.Effect<unknown, never, ErrorRequirements>;
+    readonly stop?: StopOptions;
+};
+export interface PgBossDefinition extends Context.Service<PgBossIdentifier, PgBossService> {
+    readonly layer: <const Registrations extends readonly JobRegistration[], ErrorRequirements = never>(options: PgBossLayerOptions<Registrations, ErrorRequirements>) => Layer.Layer<PgBossIdentifier, PgBossError, RegistrationRequirements<Registrations> | ErrorRequirements>;
+}
+export declare const makePgBoss: (identifier: string) => PgBossDefinition;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,KAAK,EACX,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAKhE,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,CACjB,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,OAAO,SAAS,gBAAgB,EAEtC,KAAK,EAAE,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,EACrC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,WAAW,KACjB,MAAM,CAAC,MAAM,CACjB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EACrB,WAAW,GAAG,kBAAkB,EAChC,OAAO,CAAC,kBAAkB,CAAC,CAC3B,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;CACxD;AAED,UAAU,gBAAgB;IACzB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,MAAM,CAAC;CAC1C;AAED,MAAM,MAAM,kBAAkB,CAC7B,aAAa,SAAS,SAAS,eAAe,EAAE,EAChD,iBAAiB,IACd,kBAAkB,GAAG;IACxB,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAClB,KAAK,EAAE,KAAK,KACR,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;CAC5B,CAAC;AAEF,MAAM,WAAW,gBAChB,SAAQ,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,aAAa,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,CACf,KAAK,CAAC,aAAa,SAAS,SAAS,eAAe,EAAE,EACtD,iBAAiB,GAAG,KAAK,EAEzB,OAAO,EAAE,kBAAkB,CAAC,aAAa,EAAE,iBAAiB,CAAC,KACzD,KAAK,CAAC,KAAK,CACf,gBAAgB,EAChB,WAAW,EACX,wBAAwB,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAC3D,CAAC;CACF;AAED,eAAO,MAAM,UAAU,GAAI,YAAY,MAAM,KAAG,gBAoF/C,CAAC"}

package/dist/service.js

@@ -0,0 +1,43 @@
+import { Context, Effect, Layer } from "effect";
+import { acquireClient, releaseClient } from "./internal/lifecycle.js";
+import { registerJobs } from "./internal/register.js";
+import { makeService } from "./internal/service.js";
+export const makePgBoss = (identifier) => {
+    const Service = Context.Service(identifier);
+    const layer = (options) => {
+        const names = options.jobs.map((registration) => registration._tag === "QueueWorker"
+            ? registration.queue.name
+            : registration.schedule
+                .name);
+        const { clientFactory, developmentCacheKey, jobs, onError, stop, ...constructorOptions } = options;
+        const acquire = Effect.acquireRelease(Effect.gen(function* () {
+            const context = yield* Effect.context();
+            const acquired = yield* acquireClient({
+                clientFactory,
+                constructor: constructorOptions,
+                developmentCacheKey,
+            });
+            const reportError = onError === undefined
+                ? (error) => Effect.logError({
+                    event: "pg_boss_error",
+                    message: error.message,
+                })
+                : onError;
+            const errorListener = (error) => {
+                void Effect.runPromise(Effect.exit(Effect.provide(reportError(error), context)));
+            };
+            acquired.client.on("error", errorListener);
+            const registration = registerJobs(acquired.client, jobs, context, acquired.reused);
+            return yield* registration.pipe(Effect.as({ acquired, context, errorListener }), Effect.onError(() => {
+                acquired.client.off("error", errorListener);
+                return releaseClient(acquired, stop);
+            }));
+        }), (resource) => {
+            resource.acquired.client.off("error", resource.errorListener);
+            return releaseClient(resource.acquired, stop);
+        });
+        return Layer.effect(Service, Effect.map(acquire, ({ acquired }) => makeService(acquired.client, names)));
+    };
+    return Object.assign(Service, { layer });
+};
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@shivaedev/effect-pg-boss",
+  "version": "0.0.0",
+  "description": "Effect-native jobs and lifecycle management for pg-boss",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ShivaeDev/platform.git",
+    "directory": "packages/effect-pg-boss"
+  },
+  "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/effect-pg-boss#readme",
+  "bugs": {
+    "url": "https://github.com/ShivaeDev/platform/issues"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "source": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "effect": "4.0.0-beta.102",
+    "pg-boss": "12.23.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "@typescript/native": "npm:typescript@7.0.2",
+    "effect": "4.0.0-beta.102",
+    "pg-boss": "12.23.1",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "4.1.9"
+  },
+  "scripts": {
+    "build": "node --eval \"import('node:fs').then(({ rmSync }) => rmSync('dist', { force: true, recursive: true }))\" && tsc6 --project tsconfig.build.json",
+    "check": "biome check .",
+    "test": "vitest run",
+    "test:package": "node scripts/test-package.mjs",
+    "typecheck": "tsc --noEmit",
+    "typecheck:compat": "tsc6 --noEmit",
+    "ready": "pnpm check && pnpm typecheck && pnpm typecheck:compat && pnpm test && pnpm build && pnpm test:package"
+  }
+}

package/src/definition.ts

@@ -0,0 +1,144 @@
+import type { Effect, Schema } from "effect";
+import type { Job, QueueOptions, ScheduleOptions, WorkOptions } from "pg-boss";
+
+export interface JobPayloadSchema extends Schema.Top {
+	readonly Encoded: object;
+	readonly Type: object;
+}
+
+export interface JobContext {
+	readonly id: string;
+	readonly name: string;
+	readonly signal: AbortSignal;
+	readonly expireInSeconds: number;
+	readonly heartbeatSeconds: number | null;
+}
+
+export interface QueueDefinition<
+	Name extends string = string,
+	Payload extends JobPayloadSchema = JobPayloadSchema,
+> {
+	readonly _tag: "QueueDefinition";
+	readonly name: Name;
+	readonly schema: Payload;
+	readonly queueOptions: Omit<QueueOptions, "deadLetter">;
+	readonly workerOptions: WorkOptions;
+	readonly handle: <E, R>(
+		handler: (
+			payload: Schema.Schema.Type<Payload>,
+			job: JobContext,
+		) => Effect.Effect<unknown, E, R>,
+	) => QueueWorker<Payload, R>;
+}
+
+export interface QueueWorker<
+	Payload extends JobPayloadSchema = JobPayloadSchema,
+	Requirements = unknown,
+> {
+	readonly _tag: "QueueWorker";
+	readonly queue: QueueDefinition<string, Payload>;
+	readonly handler: (
+		payload: Schema.Schema.Type<Payload>,
+		job: JobContext,
+	) => Effect.Effect<unknown, unknown, Requirements>;
+}
+
+export interface JobRegistration {
+	readonly _tag: "QueueWorker" | "ScheduledWorker";
+}
+
+export interface ScheduleDefinition<Name extends string = string> {
+	readonly _tag: "ScheduleDefinition";
+	readonly cron: string;
+	readonly name: Name;
+	readonly queueOptions: Omit<QueueOptions, "deadLetter">;
+	readonly scheduleOptions: ScheduleOptions;
+	readonly workerOptions: WorkOptions;
+	readonly run: <E, R>(
+		effect: Effect.Effect<unknown, E, R>,
+	) => ScheduledWorker<R>;
+}
+
+export interface ScheduledWorker<Requirements = unknown> {
+	readonly _tag: "ScheduledWorker";
+	readonly schedule: ScheduleDefinition;
+	readonly effect: Effect.Effect<unknown, unknown, Requirements>;
+}
+
+export type RegistrationRequirements<
+	Registrations extends readonly JobRegistration[],
+> = Registrations[number] extends infer Registration
+	? Registration extends QueueWorker<infer Payload, infer Requirements>
+		? Requirements | Payload["DecodingServices"]
+		: Registration extends ScheduledWorker<infer Requirements>
+			? Requirements
+			: never
+	: never;
+
+export interface DefineQueueOptions<
+	Name extends string,
+	Payload extends JobPayloadSchema,
+> {
+	readonly name: Name;
+	readonly schema: Payload;
+	readonly queue?: Omit<QueueOptions, "deadLetter">;
+	readonly worker?: WorkOptions;
+}
+
+export const defineQueue = <
+	const Name extends string,
+	const Payload extends JobPayloadSchema,
+>(
+	options: DefineQueueOptions<Name, Payload>,
+): QueueDefinition<Name, Payload> => {
+	const definition: QueueDefinition<Name, Payload> = {
+		_tag: "QueueDefinition",
+		name: options.name,
+		queueOptions: Object.freeze({ ...options.queue }),
+		schema: options.schema,
+		workerOptions: Object.freeze({ batchSize: 1, ...options.worker }),
+		handle: (handler) =>
+			Object.freeze({
+				_tag: "QueueWorker" as const,
+				handler,
+				queue: definition,
+			}),
+	};
+	return Object.freeze(definition);
+};
+
+export interface DefineScheduleOptions<Name extends string> {
+	readonly cron: string;
+	readonly name: Name;
+	readonly queue?: Omit<QueueOptions, "deadLetter">;
+	readonly schedule?: ScheduleOptions;
+	readonly worker?: WorkOptions;
+}
+
+export const defineSchedule = <const Name extends string>(
+	options: DefineScheduleOptions<Name>,
+): ScheduleDefinition<Name> => {
+	const definition: ScheduleDefinition<Name> = {
+		_tag: "ScheduleDefinition",
+		cron: options.cron,
+		name: options.name,
+		queueOptions: Object.freeze({ ...options.queue }),
+		scheduleOptions: Object.freeze({ tz: "UTC", ...options.schedule }),
+		workerOptions: Object.freeze({ batchSize: 1, ...options.worker }),
+		run: (effect) =>
+			Object.freeze({
+				_tag: "ScheduledWorker" as const,
+				effect,
+				schedule: definition,
+			}),
+	};
+	return Object.freeze(definition);
+};
+
+export const jobContext = (job: Job<unknown>): JobContext => ({
+	expireInSeconds: job.expireInSeconds,
+	heartbeatSeconds: job.heartbeatSeconds,
+	id: job.id,
+	name: job.name,
+	signal: job.signal,
+});

package/src/error.ts

@@ -0,0 +1,31 @@
+import { Data, Redacted } from "effect";
+
+export type PgBossOperation =
+	| "enqueue"
+	| "health"
+	| "register"
+	| "start"
+	| "stop";
+
+export class PgBossError extends Data.TaggedError("PgBossError")<{
+	readonly operation: PgBossOperation;
+	readonly queue?: string;
+	readonly original: Redacted.Redacted<unknown>;
+}> {}
+
+export class PgBossPayloadError extends Data.TaggedError("PgBossPayloadError")<{
+	readonly direction: "decode" | "encode";
+	readonly queue: string;
+	readonly original: Redacted.Redacted<unknown>;
+}> {}
+
+export const toPgBossError = (
+	operation: PgBossOperation,
+	error: unknown,
+	queue?: string,
+): PgBossError =>
+	new PgBossError({
+		operation,
+		queue,
+		original: Redacted.make(error),
+	});

package/src/health.ts

@@ -0,0 +1,20 @@
+export interface QueueHealth {
+	readonly activeCount: number;
+	readonly deadLetteredCount: number;
+	readonly failedCount: number;
+	readonly name: string;
+	readonly queuedCount: number;
+	readonly readyCount: number;
+}
+
+export interface JobsHealth {
+	readonly activeTotal: number;
+	readonly deadLetteredTotal: number;
+	readonly failedTotal: number;
+	readonly jobs: readonly QueueHealth[];
+	readonly queuedTotal: number;
+	readonly readyTotal: number;
+}
+
+export const deadLetterQueueName = (queueName: string): string =>
+	`${queueName}-dlq`;

package/src/index.ts

@@ -0,0 +1,33 @@
+export {
+	type DefineQueueOptions,
+	type DefineScheduleOptions,
+	defineQueue,
+	defineSchedule,
+	type JobContext,
+	type JobPayloadSchema,
+	type JobRegistration,
+	type QueueDefinition,
+	type QueueWorker,
+	type ScheduleDefinition,
+	type ScheduledWorker,
+} from "./definition.js";
+export {
+	PgBossError,
+	type PgBossOperation,
+	PgBossPayloadError,
+} from "./error.js";
+export {
+	deadLetterQueueName,
+	type JobsHealth,
+	type QueueHealth,
+} from "./health.js";
+export type {
+	PgBossClient,
+	PgBossClientFactory,
+} from "./internal/client.js";
+export {
+	makePgBoss,
+	type PgBossDefinition,
+	type PgBossLayerOptions,
+	type PgBossService,
+} from "./service.js";

package/src/internal/client.ts

@@ -0,0 +1,45 @@
+import type {
+	ConstructorOptions,
+	Job,
+	Queue,
+	QueueResult,
+	ScheduleOptions,
+	SendOptions,
+	StopOptions,
+	WorkOptions,
+} from "pg-boss";
+import { PgBoss } from "pg-boss";
+
+export interface PgBossClient {
+	readonly createQueue: (
+		name: string,
+		options?: Omit<Queue, "name">,
+	) => Promise<void>;
+	readonly getQueue: (name: string) => Promise<QueueResult | null>;
+	readonly offWork: (name: string) => Promise<void>;
+	readonly on: (event: "error", listener: (error: Error) => void) => unknown;
+	readonly off: (event: "error", listener: (error: Error) => void) => unknown;
+	readonly schedule: (
+		name: string,
+		cron: string,
+		data?: object | null,
+		options?: ScheduleOptions,
+	) => Promise<void>;
+	readonly send: (
+		name: string,
+		data?: object | null,
+		options?: SendOptions,
+	) => Promise<string | null>;
+	readonly start: () => Promise<unknown>;
+	readonly stop: (options?: StopOptions) => Promise<void>;
+	readonly work: <Payload>(
+		name: string,
+		options: WorkOptions,
+		handler: (jobs: readonly Job<Payload>[]) => Promise<unknown>,
+	) => Promise<string>;
+}
+
+export type PgBossClientFactory = (options: ConstructorOptions) => PgBossClient;
+
+export const defaultClientFactory: PgBossClientFactory = (options) =>
+	new PgBoss(options);

package/src/internal/health.ts

@@ -0,0 +1,47 @@
+import { Effect } from "effect";
+import { toPgBossError } from "../error.js";
+import {
+	deadLetterQueueName,
+	type JobsHealth,
+	type QueueHealth,
+} from "../health.js";
+import type { PgBossClient } from "./client.js";
+
+export const healthFor = (
+	client: PgBossClient,
+	names: readonly string[],
+): Effect.Effect<JobsHealth, import("../error.js").PgBossError> =>
+	Effect.forEach(
+		names,
+		(name) =>
+			Effect.tryPromise({
+				try: async (): Promise<QueueHealth> => {
+					const [queue, deadLetter] = await Promise.all([
+						client.getQueue(name),
+						client.getQueue(deadLetterQueueName(name)),
+					]);
+					return {
+						activeCount: queue?.activeCount ?? 0,
+						deadLetteredCount: deadLetter?.queuedCount ?? 0,
+						failedCount: queue?.failedCount ?? 0,
+						name,
+						queuedCount: queue?.queuedCount ?? 0,
+						readyCount: queue?.readyCount ?? 0,
+					};
+				},
+				catch: (error) => toPgBossError("health", error, name),
+			}),
+		{ concurrency: "unbounded" },
+	).pipe(
+		Effect.map((jobs) => ({
+			activeTotal: jobs.reduce((sum, job) => sum + job.activeCount, 0),
+			deadLetteredTotal: jobs.reduce(
+				(sum, job) => sum + job.deadLetteredCount,
+				0,
+			),
+			failedTotal: jobs.reduce((sum, job) => sum + job.failedCount, 0),
+			jobs,
+			queuedTotal: jobs.reduce((sum, job) => sum + job.queuedCount, 0),
+			readyTotal: jobs.reduce((sum, job) => sum + job.readyCount, 0),
+		})),
+	);