effect-jobs 0.1.0-alpha.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## 0.1.0-alpha.0
+
+Initial alpha extraction of the Effect-native durable jobs mechanism from
+MIT-licensed effect-auth, with application-owned domains and infrastructure.
+
+- Schema-defined catalogs, typed producer slots and library-generated job IDs.
+- Transaction-bound production and immutable semantic duplicate comparison.
+- PostgreSQL two-table storage, fixed leases, fencing, retry and bounded recovery.
+- Explicit scoped workers, bounded cleanup and protected-payload projection.
+- Focused ESM exports and optional effect-native Drizzle migration declarations.
+
+This is an alpha, not a production qualification claim. Exact versions and
+unsupported cases are listed in README and the release qualification document.
+No registry publication or cryptographic build provenance is claimed by this file.

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 effect-jobs contributors
+Copyright (c) 2026 effect-auth contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# effect-jobs
+
+Effect-native durable jobs with atomic, transaction-bound production. Initial
+alpha: application-defined catalogs, semantic deduplication, fenced fixed leases,
+persisted fixed-delay retries, bounded recovery and explicit scoped workers.
+Applications own database pools, migrations, handlers, protection and domain receipts.
+
+## Install
+
+```sh
+npm install effect-jobs@alpha effect@4.0.0
+# Only when using the optional migration declarations:
+npm install drizzle-orm@1.0.0-rc.5-169397b
+```
+
+The root export is intentionally empty. Import the focused public modules:
+
+```ts
+import { Schema } from "effect"
+import * as Job from "effect-jobs/Job"
+import * as JobQueue from "effect-jobs/JobQueue"
+import * as JobProducer from "effect-jobs/JobProducer"
+import * as JobPolicy from "effect-jobs/JobPolicy"
+import { encodeJobPayload } from "effect-jobs/JobPayloadCodec"
+
+export const BillingQueue = JobQueue.make("billing")
+export const InvoiceProducer = JobProducer.make({
+  operation: "billing.issue-invoice",
+  slots: ["generate"]
+})
+export const GenerateInvoice = Job.make({
+  queue: BillingQueue,
+  kind: "invoice.generate",
+  version: 1,
+  payload: Schema.Struct({ invoiceId: Schema.String }),
+  encodePayload: encodeJobPayload
+})
+export const invoiceInput = (operationId: string, invoiceId: string) => ({
+  producer: InvoiceProducer.identity({ operationId, slot: "generate" }),
+  payload: { invoiceId },
+  policy: JobPolicy.make()
+})
+```
+
+Declare producers once and reuse a stable operation ID across business retries.
+`GenerateInvoice.enqueue(jobsTx, invoiceInput(...))` requires the explicit scoped
+transaction capability supplied by your backend's join callback. The library
+assigns the job ID; a matching duplicate returns the original ID and retains its
+first policy and availability. Changed catalog or semantic payload conflicts.
+Results are provisional until the application's transaction commits.
+
+## PostgreSQL setup
+
+`effect-jobs/PostgreSqlTransaction` defines the `PostgreSqlApplication` service
+and trusted `ApplicationAdapter` contract. Your adapter must bind registered
+handles to the exact active source, connection and lifetime. A query-shaped object
+or matching DSN is insufficient. It delegates transaction ownership to your
+application; joined enqueue must not borrow, open a savepoint, commit or replay.
+Worker and cleanup transactions must commit before returning and reject an
+ambient transaction. See the shipped [backend contract](specs/postgresql-backend.md).
+
+```ts
+import { Effect, Layer } from "effect"
+import * as PostgreSqlJobs from "effect-jobs/PostgreSqlJobs"
+import * as PostgreSqlSchema from "effect-jobs/PostgreSqlSchema"
+import { PostgreSqlApplication } from "effect-jobs/PostgreSqlTransaction"
+
+const tables = PostgreSqlSchema.tables({ schema: "billing" })
+// During application migration, after creating the schema:
+const migrationSql = PostgreSqlSchema.migration(tables)
+// applicationAdapter implements the full qualified contract above.
+const jobsLayer = PostgreSqlJobs.layerNoDeps({
+  ...tables,
+  operationResponseBudgetMillis: 100
+}).pipe(Layer.provide(Layer.succeed(PostgreSqlApplication, applicationAdapter)))
+```
+
+The application executes `migrationSql` with its migration credentials, supplies
+its adapter, and explicitly invokes backend `ready`. Runtime construction runs
+no DDL and creates or closes no pool. Optional
+`PostgreSqlDrizzleSchema.makeJobTables(tables)` supplies migration declarations;
+it does not supply a universal Drizzle transaction adapter. The concrete native
+qualification application is documented in
+[Drizzle compatibility](specs/drizzle-compatibility.md).
+
+## Handlers, workers and retention
+
+Install handlers with `definition.handlerLayer(execute, decodeJobPayload)` into
+`JobRegistry.layer`. Handler input is `{ payload, context }`; context contains
+job ID, catalog, producer and one-based attempt number. Provide handler services
+through ordinary Layers. Map domain errors to `JobFailures.Retry`, `Dead`,
+`Isolate` or `OutcomeUnknown` from `effect-jobs/JobFailure`.
+
+Compose `JobWorker.layer(store, options)` with the registry and store, then call
+`JobWorkerRuntime.drain(consumer)` for bounded work, or explicitly install
+`PollingJobWorker.layerForPlan(plan, options)` in an application-owned Scope.
+Use the same local concurrency for a queue across invocations. Imports and
+handler installation do not start workers or cleanup.
+
+Execution is at least once. Unknown outcomes and lease recovery can repeat a
+handler; external effects need application idempotency or reconciliation. An
+attempt number may repeat after recovery. Leases do not renew. No exactly-once
+external delivery, server-crash coverage or Cloudflare coordinator is promised.
+
+Default policy: 90-second lease, 30-second attempt timeout, 5-second fixed retry,
+3 finalized attempts, 1 stalled recovery, 90-day Completed retention and infinite
+Dead retention. Generic cleanup is bounded and explicitly selected. Applications
+with receipts or domain references must replace it with coordinated cleanup.
+Pending, Active and Isolated jobs are never automatically purged. Removing all
+identity evidence ends that job's deduplication window.
+
+`JobPayload.protected(schema)` marks an already protected envelope with an own
+`fingerprint` field; it does not encrypt. Applications seal/open sensitive data
+and manage separate encryption and stable fingerprint keys. Preserve old
+decryption keys while artifacts remain retained. Telemetry must exclude payloads,
+identifiers, SQL, provider messages and secret material.
+
+## Support and development
+
+Exact qualification pins: Node 24.15.0, Bun 1.4.2, Effect 4.0.0, PostgreSQL 16.15,
+pg 8.23.0 and optional Drizzle 1.0.0-rc.5-169397b. Other versions are unqualified.
+The npm engine range bounds installation to Node 24; it is not evidence for
+every patch release. Full upstream Drizzle declarations fail strict checking;
+the Drizzle consumer uses `skipLibCheck: true`. Non-Drizzle backend declarations
+are separately checked with `skipLibCheck: false`.
+
+See [release qualification](specs/release-qualification.md) for evidence scope,
+reproduction and limitations, and [accepted decisions](specs/architecture-decisions.md)
+for the full contracts. No recurring schedules, administration APIs, alternative
+backend or deployment is included in this alpha.
+
+```sh
+bun install --frozen-lockfile
+bun run build
+bun run verify
+bun run check:postgresql
+```
+
+Fixture dependencies also require frozen installs in `tests/postgresql` and
+`tests/qualification/d6-pg`; native qualification installs its own exact peers.
+Tools are patched explicitly by check/build/lint/test. Published consumers have
+no installation lifecycle scripts. MIT; see [LICENSE](LICENSE).

package/dist/Job.d.ts

@@ -0,0 +1,33 @@
+import { Effect, Layer, Schema } from "effect";
+import type { EnqueueInput, EnqueueResult, HandlerInput, JobPayloadDecoder, JobPayloadEncoder } from "./JobContract.js";
+import type { JobFailure } from "./JobFailure.js";
+import { CatalogIdentity } from "./JobIdentity.js";
+import type { JobQueue } from "./JobQueue.js";
+import { JobRegistry, type DuplicateJobHandler } from "./JobRegistry.js";
+import type { JobEnqueueError, JobsTransaction } from "./JobTransaction.js";
+declare const InvalidJobDefinition_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InvalidJobDefinition";
+} & Readonly<A>;
+export declare class InvalidJobDefinition extends InvalidJobDefinition_base<{
+    readonly expected: string;
+}> {
+}
+export interface JobDefinition<Payload extends Schema.Top = Schema.Top, Kind extends string = string, Version extends number = number, Queue extends string = string> {
+    readonly kind: Kind;
+    readonly version: Version;
+    readonly queue: JobQueue<Queue>;
+    readonly payload: Payload;
+    readonly catalog: CatalogIdentity<Queue, Kind, Version>;
+    readonly enqueue: <E, R>(tx: JobsTransaction<E, R>, input: EnqueueInput<Payload["Type"]>) => Effect.Effect<EnqueueResult, E | JobEnqueueError, R | Payload["EncodingServices"]>;
+    readonly handlerLayer: <R>(execute: (input: HandlerInput<Payload["Type"]>) => Effect.Effect<void, JobFailure, R>, decodePayload: JobPayloadDecoder) => Layer.Layer<never, DuplicateJobHandler, JobRegistry | R | Payload["DecodingServices"]>;
+}
+/** Codec dependency is explicit until serial integration supplies the qualified implementation. */
+export declare const make: <Payload extends Schema.Top, const Kind extends string, const Version extends number, const Queue extends string>(options: {
+    readonly kind: Kind;
+    readonly version: Version;
+    readonly queue: JobQueue<Queue>;
+    readonly payload: Payload;
+    readonly encodePayload: JobPayloadEncoder;
+}) => JobDefinition<Payload, Kind, Version, Queue>;
+export {};
+//# sourceMappingURL=Job.d.ts.map

package/dist/Job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Job.d.ts","sourceRoot":"","sources":["../src/Job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpD,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAoB,MAAM,kBAAkB,CAAA;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;;;;AAG3E,qBAAa,oBAAqB,SAAQ,0BAAyC;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAC;CAAG;AAEL,MAAM,WAAW,aAAa,CAC5B,OAAO,SAAS,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,EACvC,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,KAAK,SAAS,MAAM,GAAG,MAAM;IAE7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EACrB,EAAE,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EACzB,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KACjC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAA;IACvF,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,EACvB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,EACrF,aAAa,EAAE,iBAAiB,KAC7B,KAAK,CAAC,KAAK,CACd,KAAK,EACL,mBAAmB,EACnB,WAAW,GAAG,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAC9C,CAAA;CACF;AAED,mGAAmG;AACnG,eAAO,MAAM,IAAI,GACf,OAAO,SAAS,MAAM,CAAC,GAAG,EAC1B,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,OAAO,SAAS,MAAM,EAC5B,KAAK,CAAC,KAAK,SAAS,MAAM,WACjB;IACT,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAA;CAC1C,KAAG,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAwE9C,CAAA"}

package/dist/Job.js

@@ -0,0 +1,66 @@
+import { Data, Effect, Layer, Schema } from "effect";
+import { InvalidJobInput } from "./JobContract.js";
+import { CatalogIdentity, ProducerIdentity } from "./JobIdentity.js";
+import { EpochMillis, PersistedJobPolicy } from "./JobPolicy.js";
+import { JobRegistry } from "./JobRegistry.js";
+import { insertPrepared } from "./internal/JobTransaction.js";
+export class InvalidJobDefinition extends Data.TaggedError("InvalidJobDefinition") {
+}
+/** Codec dependency is explicit until serial integration supplies the qualified implementation. */
+export const make = (options) => {
+    const { kind, version, queue, payload, encodePayload } = options;
+    const catalog = Object.freeze({ queue: queue.name, kind, version });
+    if (!Schema.is(CatalogIdentity)(catalog) || !Schema.isSchema(payload)) {
+        throw new InvalidJobDefinition({
+            expected: "valid queue/kind/version and payload Schema"
+        });
+    }
+    return Object.freeze({
+        kind,
+        version,
+        queue,
+        payload,
+        catalog,
+        enqueue: Effect.fnUntraced(function* (tx, input) {
+            if (!Schema.is(ProducerIdentity)(input.producer)) {
+                return yield* new InvalidJobInput({ field: "producer" });
+            }
+            if (!Schema.is(PersistedJobPolicy)(input.policy)) {
+                return yield* new InvalidJobInput({ field: "policy" });
+            }
+            if (input.availableAt !== undefined && !Schema.is(EpochMillis)(input.availableAt)) {
+                return yield* new InvalidJobInput({ field: "availableAt" });
+            }
+            // Snapshot configuration before asynchronous encoding; the backend owns IDs and equality.
+            const producer = Object.freeze({
+                operation: input.producer.operation,
+                operationId: input.producer.operationId,
+                slot: input.producer.slot
+            });
+            const policy = Object.freeze({
+                ...input.policy,
+                retrySchedule: Object.freeze({ ...input.policy.retrySchedule }),
+                completedRetention: Object.freeze({ ...input.policy.completedRetention }),
+                deadRetention: Object.freeze({ ...input.policy.deadRetention })
+            });
+            const availableAt = input.availableAt;
+            const encoded = yield* encodePayload(payload, input.payload);
+            return yield* insertPrepared(tx, Object.freeze({
+                catalog,
+                producer,
+                policy,
+                encoded,
+                ...(availableAt === undefined ? {} : { availableAt })
+            }));
+        }),
+        handlerLayer: (execute, decodePayload) => Layer.effectDiscard(Effect.gen(function* () {
+            const registry = yield* JobRegistry;
+            const services = yield* Effect.context();
+            yield* registry.install({
+                catalog,
+                execute: (encoded, context) => Effect.flatMap(decodePayload(payload, encoded), (decoded) => Effect.suspend(() => execute({ payload: decoded, context }))).pipe(Effect.provide(services))
+            });
+        }))
+    });
+};
+//# sourceMappingURL=Job.js.map

package/dist/Job.js.map

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

package/dist/JobConsumer.d.ts

@@ -0,0 +1,34 @@
+import { Effect, Schema } from "effect";
+import type { JobQueue } from "./JobQueue.js";
+declare const ConsumerOptions: Schema.Struct<{
+    readonly localConcurrency: Schema.Int;
+    readonly claimLimitPerRun: Schema.Int;
+    readonly recoveryLimitPerRun: Schema.Int;
+}>;
+export interface JobConsumer<Q extends JobQueue = JobQueue> extends ConsumerOptions {
+    readonly queue: Q;
+}
+type ConsumerOptions = typeof ConsumerOptions.Type;
+declare const InvalidJobConsumer_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InvalidJobConsumer";
+} & Readonly<A>;
+export declare class InvalidJobConsumer extends InvalidJobConsumer_base<{
+    readonly reason: "invalid-options";
+}> {
+}
+declare const DuplicateJobConsumer_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "DuplicateJobConsumer";
+} & Readonly<A>;
+export declare class DuplicateJobConsumer extends DuplicateJobConsumer_base<{
+    readonly queue: string;
+}> {
+    get message(): string;
+}
+/** Bounded configuration, not a running worker. */
+export declare const make: <Q extends JobQueue>(queue: Q, options: ConsumerOptions) => Effect.Effect<JobConsumer<Q>, InvalidJobConsumer>;
+export interface JobPlan<Consumers extends ReadonlyArray<JobConsumer> = ReadonlyArray<JobConsumer>> {
+    readonly consumers: Readonly<Consumers>;
+}
+export declare const plan: <const Consumers extends ReadonlyArray<JobConsumer>>(...consumers: Consumers) => Effect.Effect<JobPlan<Consumers>, DuplicateJobConsumer>;
+export {};
+//# sourceMappingURL=JobConsumer.d.ts.map

package/dist/JobConsumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobConsumer.d.ts","sourceRoot":"","sources":["../src/JobConsumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,QAAA,MAAM,eAAe;;;;EAUnB,CAAA;AAEF,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,eAAe;IACjF,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAClB;AACD,KAAK,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;;;;AAElD,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;CACnC,CAAC;CAAG;;;;AACL,qBAAa,oBAAqB,SAAQ,0BAAyC;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAC;IACA,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;AAED,mDAAmD;AACnD,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,QAAQ,SAC9B,CAAC,WACC,eAAe,KACvB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAIhD,CAAA;AAEH,MAAM,WAAW,OAAO,CACtB,SAAS,SAAS,aAAa,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC;IAEzE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;CACxC;AAED,eAAO,MAAM,IAAI,GAAI,KAAK,CAAC,SAAS,SAAS,aAAa,CAAC,WAAW,CAAC,gBACvD,SAAS,KACtB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAcrD,CAAA"}

package/dist/JobConsumer.js

@@ -0,0 +1,28 @@
+import { Data, Effect, Schema } from "effect";
+const ConsumerOptions = Schema.Struct({
+    localConcurrency: Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 1, maximum: 64 }))),
+    claimLimitPerRun: Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 1, maximum: 10_000 }))),
+    recoveryLimitPerRun: Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 1, maximum: 10_000 })))
+});
+export class InvalidJobConsumer extends Data.TaggedError("InvalidJobConsumer") {
+}
+export class DuplicateJobConsumer extends Data.TaggedError("DuplicateJobConsumer") {
+    get message() {
+        return `Duplicate consumer for ${this.queue}; configure one consumer per logical queue`;
+    }
+}
+/** Bounded configuration, not a running worker. */
+export const make = (queue, options) => Schema.decodeEffect(ConsumerOptions)(options, { onExcessProperty: "error" }).pipe(Effect.map((decoded) => Object.freeze({ queue, ...decoded })), Effect.mapError(() => new InvalidJobConsumer({ reason: "invalid-options" })));
+export const plan = (...consumers) => Effect.suspend(() => {
+    const queues = new Set();
+    for (const consumer of consumers) {
+        if (queues.has(consumer.queue.name)) {
+            return Effect.fail(new DuplicateJobConsumer({ queue: consumer.queue.name }));
+        }
+        queues.add(consumer.queue.name);
+    }
+    return Effect.succeed(Object.freeze({
+        consumers: Object.freeze([...consumers])
+    }));
+});
+//# sourceMappingURL=JobConsumer.js.map

package/dist/JobConsumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobConsumer.js","sourceRoot":"","sources":["../src/JobConsumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG7C,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAC5D;IACD,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAChE;IACD,mBAAmB,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAClC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAChE;CACF,CAAC,CAAA;AAOF,MAAM,OAAO,kBAAmB,SAAQ,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAE3E;CAAG;AACL,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAE/E;IACA,IAAa,OAAO;QAClB,OAAO,0BAA0B,IAAI,CAAC,KAAK,4CAA4C,CAAA;IACzF,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,KAAQ,EACR,OAAwB,EAC2B,EAAE,CACrD,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAC/E,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,EAC7D,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAC7E,CAAA;AAQH,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,GAAG,SAAoB,EACkC,EAAE,CAC3D,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;IAClB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;IAChC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC9E,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CACnB,MAAM,CAAC,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAmC;KAC3E,CAAC,CACH,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/JobContract.d.ts

@@ -0,0 +1,128 @@
+import { Data } from "effect";
+import type { Effect, Schema } from "effect";
+import type { JobId } from "./JobId.js";
+import type { CatalogIdentity, ProducerIdentity } from "./JobIdentity.js";
+import type { JobPolicy } from "./JobPolicy.js";
+export interface HandlerContext {
+    readonly jobId: JobId;
+    readonly catalog: CatalogIdentity;
+    readonly producer: ProducerIdentity;
+    /** attemptsMade + 1; may repeat after unknown outcomes and stalled recovery. */
+    readonly attemptNumber: number;
+}
+export interface HandlerInput<Payload> {
+    readonly payload: Payload;
+    readonly context: HandlerContext;
+}
+export interface EnqueueInput<Payload> {
+    readonly producer: ProducerIdentity;
+    readonly payload: Payload;
+    readonly policy: JobPolicy;
+    /** Omitted means database time on first insertion, never on matching duplicate. */
+    readonly availableAt?: number;
+}
+export type EnqueueResult = Data.TaggedEnum<{
+    Inserted: {
+        readonly jobId: JobId;
+    };
+    AlreadyPresent: {
+        readonly jobId: JobId;
+    };
+}>;
+export declare const EnqueueResults: {
+    readonly $is: <Tag extends "AlreadyPresent" | "Inserted">(tag: Tag) => (u: unknown) => u is Extract<{
+        readonly _tag: "AlreadyPresent";
+        readonly jobId: JobId;
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Inserted";
+        readonly jobId: JobId;
+    }, {
+        readonly _tag: Tag;
+    }>;
+    readonly $match: {
+        <Cases extends { readonly [Tag in "AlreadyPresent" | "Inserted"]: (args: Extract<{
+            readonly _tag: "AlreadyPresent";
+            readonly jobId: JobId;
+        } | {
+            readonly _tag: "Inserted";
+            readonly jobId: JobId;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(cases: Cases): (value: {
+            readonly _tag: "AlreadyPresent";
+            readonly jobId: JobId;
+        } | {
+            readonly _tag: "Inserted";
+            readonly jobId: JobId;
+        }) => import("effect/Unify").Unify<ReturnType<Cases["AlreadyPresent" | "Inserted"]>>;
+        <Cases extends { readonly [Tag in "AlreadyPresent" | "Inserted"]: (args: Extract<{
+            readonly _tag: "AlreadyPresent";
+            readonly jobId: JobId;
+        } | {
+            readonly _tag: "Inserted";
+            readonly jobId: JobId;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(value: {
+            readonly _tag: "AlreadyPresent";
+            readonly jobId: JobId;
+        } | {
+            readonly _tag: "Inserted";
+            readonly jobId: JobId;
+        }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["AlreadyPresent" | "Inserted"]>>;
+    };
+    readonly AlreadyPresent: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "AlreadyPresent";
+        readonly jobId: JobId;
+    }, "_tag">;
+    readonly Inserted: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Inserted";
+        readonly jobId: JobId;
+    }, "_tag">;
+};
+export declare const jobPayloadFormatVersion = 1;
+export declare const maximumJobPayloadBytes = 65536;
+export declare const maximumJobSemanticProjectionBytes = 65536;
+export declare const maximumProtectedJobPayloadSubtrees = 16;
+export declare const maximumJobPayloadSchemaPathBytes = 256;
+export declare const maximumJobPayloadDepth = 32;
+/** Codec owns validated canonical bytes; receivers copy bytes before retaining them. */
+export interface EncodedJobPayload {
+    readonly formatVersion: typeof jobPayloadFormatVersion;
+    readonly payloadBytes: Uint8Array;
+    readonly semanticProjectionBytes: Uint8Array;
+}
+/** Signatures implemented by the codec unit; Schema services stay explicit. */
+export type JobPayloadEncoder = <S extends Schema.Top>(schema: S, payload: S["Type"]) => Effect.Effect<EncodedJobPayload, JobPayloadCodecError, S["EncodingServices"]>;
+export type JobPayloadDecoder = <S extends Schema.Top>(schema: S, encoded: EncodedJobPayload) => Effect.Effect<S["Type"], JobPayloadCodecError, S["DecodingServices"]>;
+/** Producer-to-backend seam: no caller-supplied JobId. */
+export interface PreparedJob {
+    readonly catalog: CatalogIdentity;
+    readonly producer: ProducerIdentity;
+    readonly policy: JobPolicy;
+    readonly availableAt?: number;
+    readonly encoded: EncodedJobPayload;
+}
+declare const InvalidJobInput_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InvalidJobInput";
+} & Readonly<A>;
+export declare class InvalidJobInput extends InvalidJobInput_base<{
+    readonly field: "catalog" | "producer" | "policy" | "availableAt" | "payload";
+}> {
+}
+declare const JobIntegrityConflict_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "JobIntegrityConflict";
+} & Readonly<A>;
+export declare class JobIntegrityConflict extends JobIntegrityConflict_base<{}> {
+}
+declare const JobPayloadCodecError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "JobPayloadCodecError";
+} & Readonly<A>;
+export declare class JobPayloadCodecError extends JobPayloadCodecError_base<{
+    readonly reason: "invalid-json-value" | "invalid-encoding" | "invalid-schema" | "invalid-protected-value" | "payload-too-large" | "projection-too-large" | "too-many-protected-subtrees" | "schema-path-too-long" | "payload-too-deep" | "projection-mismatch";
+}> {
+}
+export {};
+//# sourceMappingURL=JobContract.d.ts.map

package/dist/JobContract.d.ts.map

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

package/dist/JobContract.js

@@ -0,0 +1,15 @@
+import { Data } from "effect";
+export const EnqueueResults = Data.taggedEnum();
+export const jobPayloadFormatVersion = 1;
+export const maximumJobPayloadBytes = 65_536;
+export const maximumJobSemanticProjectionBytes = 65_536;
+export const maximumProtectedJobPayloadSubtrees = 16;
+export const maximumJobPayloadSchemaPathBytes = 256;
+export const maximumJobPayloadDepth = 32;
+export class InvalidJobInput extends Data.TaggedError("InvalidJobInput") {
+}
+export class JobIntegrityConflict extends Data.TaggedError("JobIntegrityConflict") {
+}
+export class JobPayloadCodecError extends Data.TaggedError("JobPayloadCodecError") {
+}
+//# sourceMappingURL=JobContract.js.map

package/dist/JobContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobContract.js","sourceRoot":"","sources":["../src/JobContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AA4B7B,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAiB,CAAA;AAE9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAA;AAC5C,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAA;AACvD,MAAM,CAAC,MAAM,kCAAkC,GAAG,EAAE,CAAA;AACpD,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,CAAA;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAA;AAyBxC,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAErE;CAAG;AACL,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAK;CAAG;AACzF,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAY/E;CAAG"}

package/dist/JobFailure.d.ts

@@ -0,0 +1,51 @@
+import { Schema } from "effect";
+export declare const FailureCode: Schema.String;
+export declare const JobFailure: Schema.Union<readonly [Schema.TaggedStruct<"Retry", {
+    readonly code: Schema.String;
+    readonly notAfter: Schema.optional<Schema.Int>;
+}>, Schema.TaggedStruct<"Dead", {
+    readonly code: Schema.String;
+}>, Schema.TaggedStruct<"Isolate", {
+    readonly code: Schema.String;
+}>, Schema.TaggedStruct<"OutcomeUnknown", {
+    readonly code: Schema.String;
+}>]>;
+export type JobFailure = typeof JobFailure.Type;
+declare const InvalidJobFailure_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InvalidJobFailure";
+} & Readonly<A>;
+export declare class InvalidJobFailure extends InvalidJobFailure_base<{
+    readonly field: "code" | "notAfter";
+}> {
+}
+/** Explicit outcomes, not error-message or Cause persistence. */
+export declare const JobFailures: Readonly<{
+    Retry: (input: {
+        readonly code: string;
+        readonly notAfter?: number;
+    }) => {
+        readonly _tag: "Retry";
+        readonly code: string;
+        readonly notAfter?: number | undefined;
+    };
+    Dead: (input: {
+        readonly code: string;
+    }) => {
+        readonly _tag: "Dead";
+        readonly code: string;
+    };
+    Isolate: (input: {
+        readonly code: string;
+    }) => {
+        readonly _tag: "Isolate";
+        readonly code: string;
+    };
+    OutcomeUnknown: (input: {
+        readonly code: string;
+    }) => {
+        readonly _tag: "OutcomeUnknown";
+        readonly code: string;
+    };
+}>;
+export {};
+//# sourceMappingURL=JobFailure.d.ts.map

package/dist/JobFailure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobFailure.d.ts","sourceRoot":"","sources":["../src/JobFailure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAA;AAGrC,eAAO,MAAM,WAAW,eAMvB,CAAA;AACD,eAAO,MAAM,UAAU;;;;;;;;;IAQrB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;;;;AAG/C,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAA;CACpC,CAAC;CAAG;AAcL,iEAAiE;AACjE,eAAO,MAAM,WAAW;mBACP;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;kBAEtD;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;qBACtB;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;4BAClB;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;EAEjD,CAAA"}

package/dist/JobFailure.js

@@ -0,0 +1,34 @@
+import { Data, Schema } from "effect";
+import { EpochMillis } from "./JobPolicy.js";
+export const FailureCode = Schema.String.pipe(Schema.check(Schema.isMinLength(1), Schema.isMaxLength(64), Schema.isPattern(/^[a-z0-9][a-z0-9_-]*$/u)));
+export const JobFailure = Schema.Union([
+    Schema.TaggedStruct("Retry", {
+        code: FailureCode,
+        notAfter: Schema.optional(EpochMillis)
+    }),
+    Schema.TaggedStruct("Dead", { code: FailureCode }),
+    Schema.TaggedStruct("Isolate", { code: FailureCode }),
+    Schema.TaggedStruct("OutcomeUnknown", { code: FailureCode })
+]);
+const failures = Data.taggedEnum();
+export class InvalidJobFailure extends Data.TaggedError("InvalidJobFailure") {
+}
+const checked = (value) => {
+    if (!Schema.is(FailureCode)(value.code)) {
+        throw new InvalidJobFailure({ field: "code" });
+    }
+    if (value._tag === "Retry" &&
+        value.notAfter !== undefined &&
+        !Schema.is(EpochMillis)(value.notAfter)) {
+        throw new InvalidJobFailure({ field: "notAfter" });
+    }
+    return Object.freeze(value);
+};
+/** Explicit outcomes, not error-message or Cause persistence. */
+export const JobFailures = Object.freeze({
+    Retry: (input) => checked(failures.Retry(input)),
+    Dead: (input) => checked(failures.Dead(input)),
+    Isolate: (input) => checked(failures.Isolate(input)),
+    OutcomeUnknown: (input) => checked(failures.OutcomeUnknown(input))
+});
+//# sourceMappingURL=JobFailure.js.map

package/dist/JobFailure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobFailure.js","sourceRoot":"","sources":["../src/JobFailure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC3C,MAAM,CAAC,KAAK,CACV,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EACrB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,EACtB,MAAM,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAC3C,CACF,CAAA;AACD,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC;IACrC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;KACvC,CAAC;IACF,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAClD,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACrD,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CAC7D,CAAC,CAAA;AAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAc,CAAA;AAE9C,MAAM,OAAO,iBAAkB,SAAQ,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAEzE;CAAG;AACL,MAAM,OAAO,GAAG,CAAuB,KAAQ,EAAK,EAAE;IACpD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IAChD,CAAC;IACD,IACE,KAAK,CAAC,IAAI,KAAK,OAAO;QACtB,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EACvC,CAAC;QACD,MAAM,IAAI,iBAAiB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;IACpD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC7B,CAAC,CAAA;AACD,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,KAA4D,EAAE,EAAE,CACtE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,KAAgC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzE,OAAO,EAAE,CAAC,KAAgC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/E,cAAc,EAAE,CAAC,KAAgC,EAAE,EAAE,CACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;CAC1C,CAAC,CAAA"}

package/dist/JobId.d.ts

@@ -0,0 +1,5 @@
+import { Schema } from "effect";
+/** Opaque library-assigned identifier. Applications must not supply enqueue IDs. */
+export declare const JobId: Schema.brand<Schema.String, "effect-jobs/JobId">;
+export type JobId = typeof JobId.Type;
+//# sourceMappingURL=JobId.d.ts.map

package/dist/JobId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobId.d.ts","sourceRoot":"","sources":["../src/JobId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,oFAAoF;AACpF,eAAO,MAAM,KAAK,kDAGjB,CAAA;AACD,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAA"}

package/dist/JobId.js

@@ -0,0 +1,4 @@
+import { Schema } from "effect";
+/** Opaque library-assigned identifier. Applications must not supply enqueue IDs. */
+export const JobId = Schema.String.pipe(Schema.check(Schema.isMinLength(1)), Schema.brand("effect-jobs/JobId"));
+//# sourceMappingURL=JobId.js.map