@shivaedev/jobs 0.0.0-stage → 0.19.0

package/dist/server/schema.js

@@ -0,0 +1,67 @@
+import { Effect } from "effect";
+import { SqlClient } from "effect/sql";
+import { getConstructionPlans, getMigrationPlans, PgBoss } from "pg-boss";
+import pgBossPackage from "pg-boss/package.json" with { type: "json" };
+import { toPgBossError } from "#error.ts";
+import { deferralStorePlan } from "#internal/deferralStorePlan.ts";
+import { runSchemaPlan } from "#internal/runSchemaPlan.ts";
+import { resumeSchemaIndexes } from "#internal/schemaIndexBuilds.ts";
+async function installSchema(connection, options, run) {
+    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 = Array.from(await run(connection.executeUnprepared(`SELECT table_name AS "tableName", policy FROM ${schema}.queue WHERE partition = true`, [], undefined)));
+        await runSchemaPlan(connection, getMigrationPlans(schema, version, { partitionTables }), run, { schema, version: pgBossPackage.pgboss.schema });
+        await resumeSchemaIndexes(client, schema);
+    }
+}
+export function installPgBossSchema(options = {}) {
+    return Effect.scoped(Effect.gen(function* () {
+        const sql = yield* SqlClient.SqlClient;
+        const connection = yield* sql.reserve;
+        const run = Effect.runPromiseWith(yield* Effect.context());
+        yield* Effect.tryPromise({
+            catch: (error) => error,
+            try: async () => {
+                await installSchema(connection, options, run);
+                await run(connection.executeRaw(deferralStorePlan(options.schema ?? "pgboss"), []));
+            },
+        });
+    }).pipe(Effect.mapError((error) => toPgBossError("install", error)))).pipe(Effect.uninterruptible);
+}
+export function pgBossSchema(options = {}) {
+    const schema = options.schema ?? "pgboss";
+    return {
+        apply: installPgBossSchema(options),
+        name: `pg-boss:${schema}`,
+        pending: Effect.gen(function* () {
+            const sql = yield* SqlClient.SqlClient;
+            const table = sql `${sql(schema)}.${sql("version")}`;
+            const [installed] = yield* sql `select to_regclass(${table.compile()[0]})::text as name`.withoutTransform;
+            const [row] = installed === undefined || installed.name === null ? [] : yield* sql `select version from ${table}`.withoutTransform;
+            const required = pgBossPackage.pgboss.schema;
+            return row === undefined || row.version < required
+                ? `schema ${schema}, installed version ${row?.version ?? "missing"}, required version ${required}`
+                : undefined;
+        }),
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/server/schema.js.map

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

package/dist/server/service.d.ts

@@ -0,0 +1,29 @@
+import { Context, Effect, Layer, type Option, type Schema } from "effect";
+import type { ConstructorOptions, JobWithMetadata, SendOptions, StopOptions } from "pg-boss";
+import type { PgBossClientFactory } from "#client.ts";
+import type { JobPayloadSchema, JobRegistration, QueueDefinition, RegistrationRequirements } from "#definition.ts";
+import type { PgBossClientOptionsError, PgBossError, PgBossPayloadError, PgBossQueueOptionsError } from "#error.ts";
+import type { DeadLetteredJob, JobPage, JobPageOptions, JobsHealth, ListedJob, QueueCounts } from "#health.ts";
+export interface PgBossService {
+    readonly counts: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<QueueCounts, PgBossError>;
+    readonly deadLetteredJobs: <const TName extends string, const TPayload extends JobPayloadSchema>(queue: Pick<QueueDefinition<TName, TPayload>, "name" | "schema">, options: JobPageOptions) => Effect.Effect<JobPage<DeadLetteredJob<TPayload["Type"]>>, PgBossError | PgBossPayloadError, TPayload["DecodingServices"]>;
+    readonly enqueue: <const TName extends string, const TPayload extends JobPayloadSchema, const TQueue extends QueueDefinition<TName, TPayload>>(queue: QueueDefinition<TName, TPayload> & TQueue, payload: NoInfer<Schema.Schema.Type<TPayload>>, options?: NoInfer<TQueue["key"] extends undefined ? SendOptions : Omit<SendOptions, "singletonKey"> & {
+        readonly singletonKey?: never;
+    }>) => Effect.Effect<Option.Option<string>, PgBossError | PgBossPayloadError, TPayload["EncodingServices"]>;
+    readonly failedJobs: <const TName extends string, const TPayload extends JobPayloadSchema>(queue: Pick<QueueDefinition<TName, TPayload>, "name" | "schema">, options: JobPageOptions) => Effect.Effect<JobPage<ListedJob<TPayload["Type"]>>, PgBossError | PgBossPayloadError, TPayload["DecodingServices"]>;
+    readonly getJob: <const TName extends string, const TPayload extends JobPayloadSchema>(queue: Pick<QueueDefinition<TName, TPayload>, "name" | "schema">, id: string) => Effect.Effect<Option.Option<JobWithMetadata<TPayload["Type"]>>, PgBossError | PgBossPayloadError, TPayload["DecodingServices"]>;
+    readonly health: Effect.Effect<JobsHealth, PgBossError>;
+    readonly retry: (queue: Pick<QueueDefinition, "name">, id: string) => Effect.Effect<void, PgBossError>;
+}
+export type PgBossLayerOptions<TRegistrations extends readonly JobRegistration[], TErrorRequirements> = ConstructorOptions & {
+    readonly clientFactory?: PgBossClientFactory;
+    readonly clientCacheKey?: string | symbol | undefined;
+    readonly jobs: TRegistrations;
+    readonly onError?: (error: Error) => Effect.Effect<unknown, never, TErrorRequirements>;
+    readonly stop?: StopOptions;
+};
+export interface PgBossDefinition<TIdentifier extends string = string> extends Context.Service<TIdentifier, PgBossService> {
+    readonly layer: <const TRegistrations extends readonly JobRegistration[], TErrorRequirements = never>(options: PgBossLayerOptions<TRegistrations, TErrorRequirements>) => Layer.Layer<TIdentifier, PgBossError | PgBossQueueOptionsError | PgBossClientOptionsError, Exclude<RegistrationRequirements<TRegistrations>, TIdentifier> | TErrorRequirements>;
+}
+export declare function makePgBoss<const TIdentifier extends string>(identifier: TIdentifier): PgBossDefinition<TIdentifier>;
+//# sourceMappingURL=service.d.ts.map

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

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

package/dist/server/service.js

@@ -0,0 +1,33 @@
+import { Context, Effect, Layer } from "effect";
+import { logClientError, subscribeClientErrors } from "#internal/clientErrors.ts";
+import { acquireClient, releaseClient } from "#internal/lifecycle.ts";
+import { makeService } from "#internal/makeService.ts";
+import { registrationName } from "#internal/register.ts";
+import { registerReleasedJobs } from "#internal/registerReleasedJobs.ts";
+export function makePgBoss(identifier) {
+    const Service = Context.Service(identifier);
+    function layer(options) {
+        const names = options.jobs.map(registrationName);
+        const { clientFactory, clientCacheKey, jobs, onError, stop, ...constructorOptions } = options;
+        const acquire = Effect.acquireRelease(Effect.gen(function* () {
+            const dependencies = yield* Effect.context();
+            const acquired = yield* acquireClient({
+                clientCacheKey,
+                clientFactory,
+                constructor: constructorOptions,
+            });
+            const service = makeService(acquired.client, names, constructorOptions.schema);
+            const context = Context.add(dependencies, Service, service);
+            const reportError = onError ?? logClientError;
+            function errorListener(error) {
+                void Effect.runPromise(Effect.exit(Effect.provide(reportError(error), context)));
+            }
+            const unsubscribe = subscribeClientErrors(acquired.client, errorListener);
+            const registration = registerReleasedJobs(acquired.client, jobs, context, acquired.reused, constructorOptions.schema);
+            return yield* registration.pipe(Effect.as({ acquired, service, unsubscribe }), Effect.onError(() => releaseClient(acquired, stop).pipe(Effect.ensuring(Effect.sync(unsubscribe)))));
+        }), (resource) => releaseClient(resource.acquired, stop).pipe(Effect.ensuring(Effect.sync(resource.unsubscribe))));
+        return Layer.effect(Service, Effect.map(acquire, ({ service }) => service));
+    }
+    return Object.assign(Service, { layer });
+}
+//# sourceMappingURL=service.js.map

package/dist/server/service.js.map

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

package/dist/server/testing.d.ts

@@ -0,0 +1,77 @@
+import { type DateTime, Duration, Effect } from "effect";
+import type { PgBossClientFactory } from "#client.ts";
+import type { JobPayloadSchema, QueueDefinition } from "#definition.ts";
+import { PgBossTestingError } from "#error.ts";
+export type SnapshotQueue = Pick<QueueDefinition<string, JobPayloadSchema>, "name" | "schema">;
+export interface UnfinishedJob<TQueue extends SnapshotQueue> {
+    readonly data: TQueue["schema"]["Type"];
+    readonly id: string;
+    readonly queue: TQueue["name"];
+    readonly startAfter: DateTime.Utc;
+    readonly state: "active" | "created" | "failed" | "retry";
+}
+export declare const testRetryPolicy: Readonly<{
+    retryBackoff: false;
+    retryDelay: 0;
+}>;
+export interface PgBossTestingOptions {
+    readonly retryPolicy?: typeof testRetryPolicy;
+}
+export declare function makePgBossTesting(options?: PgBossTestingOptions): {
+    deferred: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<{
+        at: DateTime.Utc;
+        reason: string;
+    }[], PgBossTestingError, never>;
+    runDeferredNow: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<void, PgBossTestingError, never>;
+    checkBatchWindow: (queue: Pick<QueueDefinition, "name" | "workerOptions">, millisecondsPerJob: number) => Effect.Effect<void, PgBossTestingError, never>;
+    checkSchemaVersion: (expected: number) => Effect.Effect<void, PgBossTestingError, never>;
+    clientFactory: PgBossClientFactory;
+    expireAfter: (queue: Pick<QueueDefinition, "name">, attempts: number) => Effect.Effect<void, PgBossTestingError, never>;
+    expireIn: (queue: Pick<QueueDefinition, "name">, duration: Duration.Input) => Effect.Effect<void, PgBossTestingError, never>;
+    failNextSend: (queue: Pick<QueueDefinition, "name">) => Effect.Effect<void, never, never>;
+    jobs: <TName extends string, TPayload extends JobPayloadSchema>(queue: QueueDefinition<TName, TPayload>, options?: import("pg-boss").FindJobsOptions) => Effect.Effect<{
+        id: string;
+        name: string;
+        retryCount: number;
+        signal: AbortSignal;
+        groupId?: string | null;
+        groupTier?: string | null;
+        priority: number;
+        state: 'created' | 'retry' | 'active' | 'completed' | 'cancelled' | 'failed';
+        retryLimit: number;
+        retryDelay: number;
+        retryBackoff: boolean;
+        retryDelayMax?: number;
+        startAfter: Date;
+        startedOn: Date;
+        singletonKey: string | null;
+        singletonOn: Date | null;
+        expireInSeconds: number;
+        deleteAfterSeconds: number;
+        createdOn: Date;
+        completedOn: Date | null;
+        keepUntil: Date;
+        policy: import("pg-boss").QueuePolicy;
+        heartbeatOn: Date | null;
+        heartbeatSeconds: number | null;
+        blocked: boolean;
+        blocking: boolean;
+        pendingDependencies: number;
+        deadLetter: string;
+        output: object;
+        sourceName: string | null;
+        sourceId: string | null;
+        sourceCreatedOn: Date | null;
+        sourceRetryCount: number | null;
+        sourceOutput: object | null;
+        sourceRootId: string | null;
+        data: TPayload["Type"];
+    }[], import("#error.ts").PgBossPayloadError | PgBossTestingError, TPayload["DecodingServices"]>;
+    revision: Effect.Effect<number, never, never>;
+    schemaVersion: Effect.Effect<number | null, PgBossTestingError, never>;
+    snapshot: <const TQueues extends readonly SnapshotQueue[]>(queues: TQueues) => Effect.Effect<readonly UnfinishedJob<TQueues[number]>[], import("#error.ts").PgBossPayloadError | PgBossTestingError, TQueues[number]["schema"]["DecodingServices"]>;
+    waitForChange: (after: number) => Effect.Effect<number>;
+    waitForIdle: Effect.Effect<void, PgBossTestingError, never>;
+};
+export type PgBossTesting = ReturnType<typeof makePgBossTesting>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/server/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/server/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAY,MAAM,QAAQ,CAAC;AAEnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAS/C,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;AAE/F,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,aAAa;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC1D;AAED,eAAO,MAAM,eAAe;;;EAAwD,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,eAAe,CAAC;CAC9C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,oBAAyB;;;;;;8BA6BxC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,eAAe,CAAC,sBAAsB,MAAM;mCAqBtE,MAAM;;yBAOhB,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,YAAY,MAAM;sBAUlD,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,YAAY,QAAQ,CAAC,KAAK;0BAWnD,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQpD;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/server/testing.js

@@ -0,0 +1,90 @@
+import { Duration, Effect, Redacted } from "effect";
+import { PgBossTestingError } from "#error.ts";
+import { nativeClient } from "#internal/nativeClient.ts";
+import { testingClient } from "#internal/testingClient.ts";
+import { testingDeferrals } from "#internal/testingDeferrals.ts";
+import { testingIdle } from "#internal/testingIdle.ts";
+import { testingOperation, testingReadout } from "#internal/testingReadout.ts";
+import { testingSignal } from "#internal/testingSignal.ts";
+import { testingSnapshot } from "#internal/testingSnapshot.ts";
+export const testRetryPolicy = Object.freeze({ retryBackoff: false, retryDelay: 0 });
+export function makePgBossTesting(options = {}) {
+    let current;
+    let schema = "pgboss";
+    const signal = testingSignal();
+    const work = { batches: new Set(), queues: new Set() };
+    const controls = {
+        changed: signal.changed,
+        expirations: new Map(),
+        expirySeconds: new Map(),
+        failures: new Set(),
+        retryPolicy: options.retryPolicy ?? {},
+        work,
+    };
+    function client() {
+        if (current === undefined) {
+            throw new Error("Provide the testing clientFactory to a jobs Layer first");
+        }
+        return current;
+    }
+    const clientFactory = (clientOptions) => {
+        if (current !== undefined) {
+            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 });
+        return testingClient(current, clientOptions.schema ?? "pgboss", controls);
+    };
+    return {
+        ...testingDeferrals(client, () => schema, signal.changed),
+        checkBatchWindow: (queue, millisecondsPerJob) => testingOperation("checkBatchWindow", async () => {
+            const stored = await client().getQueue(queue.name);
+            if (stored === null) {
+                throw new Error("Queue is not registered");
+            }
+            if (stored.expireInSeconds === undefined) {
+                throw new Error("Queue has no expiry window");
+            }
+            if (!Number.isFinite(millisecondsPerJob) || millisecondsPerJob < 0) {
+                throw new RangeError("Job duration must be nonnegative and finite");
+            }
+            const required = (queue.workerOptions.batchSize ?? 10) * millisecondsPerJob;
+            if (required >= stored.expireInSeconds * 1000) {
+                throw new Error("Sequential batch work must fit within the queue expiry window");
+            }
+        }, queue.name),
+        checkSchemaVersion: (expected) => testingOperation("checkSchemaVersion", async () => {
+            if ((await client().schemaVersion()) !== expected) {
+                throw new Error(`Expected pg-boss schema version ${expected}`);
+            }
+        }),
+        clientFactory,
+        expireAfter: (queue, attempts) => Effect.try({
+            catch: (original) => new PgBossTestingError({ operation: "expireAfter", original: Redacted.make(original), queue: queue.name }),
+            try: () => {
+                if (!Number.isSafeInteger(attempts) || attempts < 1) {
+                    throw new RangeError("Attempts must be a positive integer");
+                }
+                controls.expirations.set(queue.name, attempts);
+            },
+        }),
+        expireIn: (queue, duration) => Effect.try({
+            catch: (original) => new PgBossTestingError({ operation: "expireIn", original: Redacted.make(original), queue: queue.name }),
+            try: () => {
+                const milliseconds = Duration.toMillis(Duration.fromInputUnsafe(duration));
+                if (!Number.isFinite(milliseconds) || milliseconds < 1000) {
+                    throw new RangeError("Expiry must be finite and at least one second");
+                }
+                controls.expirySeconds.set(queue.name, Math.ceil(milliseconds / 1000));
+            },
+        }),
+        failNextSend: (queue) => Effect.sync(() => controls.failures.add(queue.name)).pipe(Effect.asVoid),
+        jobs: testingReadout(client),
+        revision: signal.revision,
+        schemaVersion: testingOperation("schemaVersion", () => client().schemaVersion()),
+        snapshot: testingSnapshot(client, () => schema),
+        waitForChange: signal.waitForChange,
+        waitForIdle: testingIdle(client, () => schema, work, signal),
+    };
+}
+//# sourceMappingURL=testing.js.map

package/dist/server/testing.js.map

@@ -0,0 +1 @@
+{"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;AAInE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,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,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAY/D,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,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,YAAY,CAAC,EAAE,GAAG,aAAa,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,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,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,77 @@
 {
   "name": "@shivaedev/jobs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.19.0",
+  "description": "Effect-native jobs and lifecycle management for pg-boss",
+  "keywords": [
+    "effect"
+  ],
+  "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/jobs#readme",
+  "bugs": {
+    "url": "https://github.com/ShivaeDev/platform/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ShivaeDev/platform.git",
+    "directory": "packages/jobs"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "imports": {
+    "#test/*": "./src/test-support/*",
+    "#*.ts": {
+      "source": "./src/server/*.ts",
+      "types": "./dist/server/*.d.ts",
+      "default": "./dist/server/*.js"
+    }
+  },
+  "exports": {
+    "./*.ts": {
+      "source": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./package.json": "./package.json",
+    "./server/internal/*": null
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.spec.ts",
+    "!src/**/test-support",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "dependencies": {
+    "@shivaedev/sql": "0.21.0"
+  },
+  "devDependencies": {
+    "@shivaedev/quality": "0.41.1",
+    "@shivaedev/test": "0.9.0",
+    "@shivaedev/test-sql": "0.9.3",
+    "@shivaedev/test-story": "0.20.1",
+    "@types/node": "24.19.2",
+    "effect": "4.0.5",
+    "pg-boss": "12.38.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.5"
+  },
+  "peerDependencies": {
+    "effect": "4.0.5",
+    "pg-boss": "12.38.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "node --eval \"import('node:fs').then(({ rmSync }) => rmSync('dist', { force: true, recursive: true }))\" && tsc --project tsconfig.build.json",
+    "ready": "pnpm typecheck && pnpm test && pnpm build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }

package/src/server/client.ts

@@ -0,0 +1,40 @@
+import type {
+	ConstructorOptions,
+	FindJobsOptions,
+	Job,
+	JobWithMetadata,
+	PgBoss,
+	Queue,
+	QueueResult,
+	ScheduleOptions,
+	SendOptions,
+	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 fail?: PgBoss["fail"];
+	readonly findJobs?: (name: string, options?: FindJobsOptions) => Promise<readonly JobWithMetadata<unknown>[]>;
+	readonly getDb?: PgBoss["getDb"];
+	readonly getQueue: (name: string) => Promise<QueueResult | null>;
+	readonly getWipData?: PgBoss["getWipData"];
+	readonly notifyWorker?: PgBoss["notifyWorker"];
+	readonly off: (event: "error", listener: (error: Error) => void) => unknown;
+	readonly offWork: (name: string) => Promise<void>;
+	readonly on: (event: "error", listener: (error: Error) => void) => unknown;
+	readonly retry?: PgBoss["retry"];
+	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 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/definition.ts

@@ -0,0 +1,140 @@
+import { Clock, Duration, Effect, Schema } from "effect";
+import type { Job, policies, Queue, ScheduleOptions, WorkOptions } from "pg-boss";
+import { deadlineOf } from "#internal/deadlineOf.ts";
+import { maxDeferrals, nativeQueueOptions } from "#internal/definitionOptions.ts";
+import { scheduleDefinition } from "#internal/scheduleDefinition.ts";
+
+export class RetryAt extends Schema.TaggedError<RetryAt>()("RetryAt", {
+	at: Schema.DateTimeUtc,
+	reason: Schema.String,
+}) {}
+
+export type QueuePolicy = (typeof policies)[keyof typeof policies];
+export type QueueOptions = Omit<Queue, "name" | "deadLetter" | "policy"> & {
+	readonly maxDeferrals?: number;
+	readonly policy?: QueuePolicy;
+};
+
+export interface JobPayloadSchema extends Schema.Top {
+	readonly Encoded: object;
+	readonly Type: object;
+}
+
+export interface JobContext {
+	readonly expireInSeconds: number;
+	readonly heartbeatSeconds: number | null;
+	readonly id: string;
+	readonly name: string;
+	readonly remainingBudget: Effect.Effect<Duration.Duration>;
+	readonly signal: AbortSignal;
+}
+
+export interface QueueDefinition<TName extends string = string, TPayload extends JobPayloadSchema = JobPayloadSchema> {
+	readonly _tag: "QueueDefinition";
+	readonly handle: <E, R>(
+		handler: (payload: Schema.Schema.Type<TPayload>, job: JobContext) => Effect.Effect<unknown, E, R>,
+	) => QueueWorker<TPayload, R>;
+	readonly key?: ((payload: Schema.Schema.Type<TPayload>) => string) | undefined;
+	readonly maxDeferrals: number;
+	readonly name: TName;
+	readonly queueOptions: Omit<Queue, "name" | "deadLetter">;
+	readonly schema: TPayload;
+	readonly workerOptions: WorkOptions;
+}
+
+export interface QueueWorker<TPayload extends JobPayloadSchema = JobPayloadSchema, TRequirements = unknown> {
+	readonly _tag: "QueueWorker";
+	readonly handler: (payload: Schema.Schema.Type<TPayload>, job: JobContext) => Effect.Effect<unknown, unknown, TRequirements>;
+	readonly queue: QueueDefinition<string, TPayload>;
+}
+
+export interface JobRegistration {
+	readonly _tag: "QueueDefinition" | "QueueWorker" | "ScheduledWorker";
+}
+
+export interface ScheduleDefinition<TName extends string = string> {
+	readonly _tag: "ScheduleDefinition";
+	readonly cron: string;
+	readonly maxDeferrals: number;
+	readonly name: TName;
+	readonly queueOptions: Omit<Queue, "name" | "deadLetter">;
+	readonly run: <E, R>(effect: Effect.Effect<unknown, E, R>) => ScheduledWorker<R>;
+	readonly scheduleOptions: ScheduleOptions;
+	readonly workerOptions: WorkOptions;
+}
+
+export interface ScheduledWorker<TRequirements = unknown> {
+	readonly _tag: "ScheduledWorker";
+	readonly effect: Effect.Effect<unknown, unknown, TRequirements>;
+	readonly schedule: ScheduleDefinition;
+}
+
+export type RegistrationRequirements<TRegistrations extends readonly JobRegistration[]> = TRegistrations[number] extends infer TRegistration
+	? TRegistration extends QueueWorker<infer TPayload, infer TRequirements>
+		? TRequirements | TPayload["DecodingServices"]
+		: TRegistration extends ScheduledWorker<infer TRequirements>
+			? TRequirements
+			: never
+	: never;
+
+export type DefineQueueOptions<TName extends string, TPayload extends JobPayloadSchema> = {
+	readonly name: TName;
+	readonly schema: TPayload;
+	readonly worker?: WorkOptions;
+} & (
+	| { readonly key: (payload: Schema.Schema.Type<TPayload>) => string; readonly queue: QueueOptions & { readonly policy: "singleton" } }
+	| { readonly key?: never; readonly queue?: QueueOptions & { readonly policy?: Exclude<QueuePolicy, "singleton"> } }
+);
+
+export function defineQueue<const TName extends string, const TPayload extends JobPayloadSchema>(
+	options: DefineQueueOptions<TName, TPayload> & { readonly key: (payload: Schema.Schema.Type<TPayload>) => string },
+): QueueDefinition<TName, TPayload> & { readonly key: (payload: Schema.Schema.Type<TPayload>) => string };
+export function defineQueue<const TName extends string, const TPayload extends JobPayloadSchema>(
+	options: DefineQueueOptions<TName, TPayload> & { readonly key?: never },
+): QueueDefinition<TName, TPayload> & { readonly key?: never };
+export function defineQueue<const TName extends string, const TPayload extends JobPayloadSchema>(
+	options: DefineQueueOptions<TName, TPayload>,
+): QueueDefinition<TName, TPayload>;
+export function defineQueue<const TName extends string, const TPayload extends JobPayloadSchema>(
+	options: DefineQueueOptions<TName, TPayload>,
+): QueueDefinition<TName, TPayload> {
+	const definition: QueueDefinition<TName, TPayload> = {
+		_tag: "QueueDefinition",
+		...(options.key === undefined ? {} : { key: options.key }),
+		handle: (handler) =>
+			Object.freeze({
+				_tag: "QueueWorker" as const,
+				handler,
+				queue: definition,
+			}),
+		maxDeferrals: maxDeferrals(options.queue),
+		name: options.name,
+		queueOptions: nativeQueueOptions(options.queue),
+		schema: options.schema,
+		workerOptions: Object.freeze({ batchSize: 10, burstWhenBatchFull: true, ...options.worker }),
+	};
+	return Object.freeze(definition);
+}
+
+export interface DefineScheduleOptions<TName extends string> {
+	readonly cron: string;
+	readonly name: TName;
+	readonly queue?: QueueOptions;
+	readonly schedule?: ScheduleOptions;
+	readonly worker?: WorkOptions;
+}
+
+export function defineSchedule<const TName extends string>(options: DefineScheduleOptions<TName>): ScheduleDefinition<TName> {
+	return scheduleDefinition(options);
+}
+
+export function jobContext(job: Job<unknown>): JobContext {
+	return {
+		expireInSeconds: job.expireInSeconds,
+		heartbeatSeconds: job.heartbeatSeconds,
+		id: job.id,
+		name: job.name,
+		remainingBudget: Effect.map(Clock.currentTimeMillis, (now) => Duration.millis(Math.max(0, deadlineOf(job) - now))),
+		signal: job.signal,
+	};
+}