effect-mq 0.1.0

package/dist/JobStore.js

@@ -0,0 +1,89 @@
+/**
+ * The storage seam of effect-mq.
+ *
+ * `JobStore` is the minimal, storage-agnostic interface a queue backend must
+ * implement. Every method must be atomic within the driver. The reference
+ * implementation is `MemoryJobStore`; Postgres (via `effect-mq/drizzle`),
+ * Redis, etc. drivers implement the same service.
+ *
+ * The store works entirely on *encoded* (JSON-safe) payloads and exits —
+ * schema encoding/decoding happens in `Job` (producer side) and `Worker`
+ * (consumer side), so drivers stay dumb.
+ *
+ * Multiple stores can coexist in one application via named store keys (see
+ * `named`): each job definition binds to a store key, so business-critical
+ * jobs can live in Postgres while disposable ones live elsewhere.
+ *
+ * @since 0.1.0
+ */
+import { Brand, Context, Data, Predicate } from "effect";
+/**
+ * Brand a raw string as a `JobId`.
+ *
+ * @since 0.1.0
+ */
+export const JobId = Brand.nominal();
+/**
+ * Brand a raw string as a `QueueName`.
+ *
+ * @since 0.1.0
+ */
+export const QueueName = Brand.nominal();
+/**
+ * A transient or fatal driver error (connection loss, serialization, etc.).
+ *
+ * @since 0.1.0
+ */
+export class JobStoreError extends Data.TaggedError("JobStoreError") {
+}
+/**
+ * Tag-based guard (safe across duplicate module copies, unlike `instanceof`).
+ *
+ * @since 0.1.0
+ */
+// oxlint-disable-next-line anti-slop/no-unknown-parameters -- a type guard IS the boundary parser; `unknown` input is its purpose
+export const isJobStoreError = (u) => Predicate.hasProperty(u, "_tag") && u._tag === "JobStoreError";
+/**
+ * The presented lock token no longer owns the job (it stalled and was
+ * recovered, or another worker claimed it).
+ *
+ * @since 0.1.0
+ */
+export class LockLostError extends Data.TaggedError("LockLostError") {
+}
+/**
+ * @since 0.1.0
+ */
+export class JobNotFoundError extends Data.TaggedError("JobNotFoundError") {
+}
+/**
+ * `retry` was called on a job that is not in the `failed` state.
+ *
+ * @since 0.1.0
+ */
+export class JobNotRetryableError extends Data.TaggedError("JobNotRetryableError") {
+}
+/**
+ * The default store key. Jobs without an explicit `store` binding use this.
+ *
+ * @since 0.1.0
+ */
+export class JobStore extends Context.Service()("effect-mq/JobStore") {
+}
+/**
+ * Create a named store key. Jobs bound to it (via `Job.make`'s `store`
+ * option) require it in `R` instead of the default `JobStore`, letting
+ * different jobs run on different storage infrastructure:
+ *
+ * ```ts
+ * const Durable = JobStore.named("durable")     // -> Postgres in prod
+ * const Ephemeral = JobStore.named("ephemeral") // -> Redis in prod
+ * ```
+ *
+ * Keys are identified by their name string: two `named("durable")` calls are
+ * interchangeable.
+ *
+ * @since 0.1.0
+ */
+export const named = (name) => Context.Service(`effect-mq/JobStore/${name}`);
+//# sourceMappingURL=JobStore.js.map

package/dist/JobStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobStore.js","sourceRoot":"","sources":["../src/JobStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAA4B,SAAS,EAAE,MAAM,QAAQ,CAAA;AAUlF;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAA6B,KAAK,CAAC,OAAO,EAAS,CAAA;AASrE;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAiC,KAAK,CAAC,OAAO,EAAa,CAAA;AAoMjF;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,IAAI,CAAC,WAAW,CAAC,eAAe,CAGjE;CAAG;AAEL;;;;GAIG;AACH,kIAAkI;AAClI,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAU,EAAsB,EAAE,CAChE,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,CAAA;AAGhE;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,IAAI,CAAC,WAAW,CAAC,eAAe,CAEjE;CAAG;AAEL;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAEvE;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAG/E;CAAG;AAiHL;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,OAAO,CAAC,OAAO,EAAqB,CAChE,oBAAoB,CACrB;CAAG;AAYJ;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,IAAU,EACyB,EAAE,CACrC,OAAO,CAAC,OAAO,CAAuB,sBAAsB,IAAI,EAAE,CAAC,CAAA"}

package/dist/MemoryJobStore.d.ts

@@ -0,0 +1,34 @@
+/**
+ * In-memory `JobStore` built purely on Effect primitives.
+ *
+ * The reference driver: used for tests, local development and as the template
+ * for real storage adapters. Time comes from `Clock`, so everything is fully
+ * `TestClock`-compatible.
+ *
+ * Atomicity note: every operation reads the clock once and then mutates state
+ * in a single synchronous block, which is atomic on the JavaScript runtime.
+ *
+ * @since 0.1.0
+ */
+import { type Context, Effect, Layer } from "effect";
+import { JobStore, type Service } from "./JobStore.ts";
+/**
+ * Build a fresh in-memory `JobStore` implementation.
+ *
+ * @since 0.1.0
+ */
+export declare const make: Effect.Effect<Service>;
+/**
+ * A fresh in-memory `JobStore` layer. Pass a named store key to provide a
+ * `JobStore.named(...)` slot instead of the default.
+ *
+ * @since 0.1.0
+ */
+export declare const layer: Layer.Layer<JobStore>;
+/**
+ * An in-memory layer for a specific store key.
+ *
+ * @since 0.1.0
+ */
+export declare const layerFor: <Id>(store: Context.Key<Id, Service>) => Layer.Layer<Id>;
+//# sourceMappingURL=MemoryJobStore.d.ts.map

package/dist/MemoryJobStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryJobStore.d.ts","sourceRoot":"","sources":["../src/MemoryJobStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAS,KAAK,OAAO,EAAY,MAAM,EAAQ,KAAK,EAAU,MAAM,QAAQ,CAAA;AACnF,OAAO,EASL,QAAQ,EAIR,KAAK,OAAO,EACb,MAAM,eAAe,CAAA;AA0DtB;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAuWtC,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAgC,CAAA;AAExE;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,EAAE,SAClB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,KAC9B,KAAK,CAAC,KAAK,CAAC,EAAE,CAA8B,CAAA"}

package/dist/MemoryJobStore.js

@@ -0,0 +1,381 @@
+/**
+ * In-memory `JobStore` built purely on Effect primitives.
+ *
+ * The reference driver: used for tests, local development and as the template
+ * for real storage adapters. Time comes from `Clock`, so everything is fully
+ * `TestClock`-compatible.
+ *
+ * Atomicity note: every operation reads the clock once and then mutates state
+ * in a single synchronous block, which is atomic on the JavaScript runtime.
+ *
+ * @since 0.1.0
+ */
+import { Clock, Deferred, Effect, Exit, Layer, Option } from "effect";
+import { JobId, JobNotFoundError, JobNotRetryableError, JobStore, LockLostError } from "./JobStore.js";
+const snapshot = (job) => ({
+    id: job.id,
+    name: job.name,
+    queue: job.queue,
+    payload: job.payload,
+    metadata: job.metadata,
+    state: job.state,
+    priority: job.priority,
+    attemptsMax: job.attemptsMax,
+    attemptsMade: job.attemptsMade,
+    stalledCount: job.stalledCount,
+    backoff: job.backoff,
+    keep: job.keep,
+    runAt: job.runAt,
+    enqueuedAt: job.enqueuedAt,
+    processedAt: job.processedAt,
+    finishedAt: job.finishedAt,
+    exit: job.exit,
+    failedReason: job.failedReason
+});
+const metadataMatches = (record, filter) => {
+    for (const [key, value] of Object.entries(filter)) {
+        if (record[key] !== value)
+            return false;
+    }
+    return true;
+};
+/**
+ * Build a fresh in-memory `JobStore` implementation.
+ *
+ * @since 0.1.0
+ */
+export const make = Effect.sync(() => {
+    const jobs = new Map();
+    let seq = 0;
+    let idCounter = 0;
+    let wakeVersion = 0;
+    let wake = Deferred.makeUnsafe();
+    // Synchronous on purpose: it is called inside the same synchronous block as
+    // the state mutation, so no effect-op boundary (where an interrupt could
+    // land) can separate a mutation from its wake-up signal.
+    const signalWake = () => {
+        wakeVersion += 1;
+        const current = wake;
+        wake = Deferred.makeUnsafe();
+        Deferred.doneUnsafe(current, Exit.succeed(void 0));
+    };
+    const promoteDue = (now) => {
+        for (const job of jobs.values()) {
+            if (job.state === "delayed" && job.runAt <= now) {
+                job.state = "waiting";
+            }
+        }
+    };
+    const clearLock = (job) => {
+        job.lockToken = undefined;
+        job.lockExpiresAt = undefined;
+    };
+    const recordAttempt = (job, outcome, finishedAt, exit) => {
+        job.attempts.push({
+            attempt: job.attempts.length + 1,
+            startedAt: job.processedAt,
+            finishedAt,
+            outcome,
+            exit
+        });
+    };
+    // Terminal retention: keep at most `count` and drop older than `ageMs`
+    // among terminal jobs sharing this job's name + state.
+    const applyKeep = (job, now) => {
+        if (job.keep === undefined)
+            return;
+        const peers = Array.from(jobs.values())
+            .filter((peer) => peer.name === job.name && peer.state === job.state)
+            .toSorted((a, b) => ((b.finishedAt ?? 0) - (a.finishedAt ?? 0)) || (b.seq - a.seq));
+        const remove = new Set();
+        if (job.keep.ageMs !== undefined) {
+            for (const peer of peers) {
+                if (peer.finishedAt !== undefined && peer.finishedAt <= now - job.keep.ageMs) {
+                    remove.add(peer.id);
+                }
+            }
+        }
+        if (job.keep.count !== undefined) {
+            for (const peer of peers.slice(Math.max(0, job.keep.count))) {
+                remove.add(peer.id);
+            }
+        }
+        for (const id of remove) {
+            jobs.delete(id);
+        }
+    };
+    return JobStore.of({
+        enqueue: (request) => Effect.gen(function* () {
+            const now = yield* Clock.currentTimeMillis;
+            let id = request.id;
+            if (id === undefined) {
+                // Store-assigned ids must never collide with user-supplied ones.
+                do {
+                    id = JobId(`j-${++idCounter}`);
+                } while (jobs.has(id));
+            }
+            else if (jobs.has(id)) {
+                return { id, duplicate: true };
+            }
+            jobs.set(id, {
+                id,
+                name: request.name,
+                queue: request.queue,
+                payload: request.payload,
+                metadata: request.metadata,
+                state: request.delayMs > 0 ? "delayed" : "waiting",
+                priority: request.priority,
+                attemptsMax: request.attemptsMax,
+                attemptsMade: 0,
+                stalledCount: 0,
+                backoff: request.backoff,
+                keep: request.keep,
+                runAt: now + Math.max(0, request.delayMs),
+                enqueuedAt: now,
+                processedAt: undefined,
+                finishedAt: undefined,
+                exit: undefined,
+                failedReason: undefined,
+                attempts: [],
+                seq: ++seq,
+                lockToken: undefined,
+                lockExpiresAt: undefined
+            });
+            signalWake();
+            return { id, duplicate: false };
+        }),
+        claim: (options) => Effect.gen(function* () {
+            const now = yield* Clock.currentTimeMillis;
+            promoteDue(now);
+            const names = new Set(options.names);
+            let best;
+            let nextRunAt;
+            for (const job of jobs.values()) {
+                if (job.queue !== options.queue || !names.has(job.name))
+                    continue;
+                if (job.state === "waiting") {
+                    if (best === undefined ||
+                        job.priority > best.priority ||
+                        (job.priority === best.priority && job.seq < best.seq)) {
+                        best = job;
+                    }
+                }
+                else if (job.state === "delayed") {
+                    if (nextRunAt === undefined || job.runAt < nextRunAt) {
+                        nextRunAt = job.runAt;
+                    }
+                }
+            }
+            if (best === undefined) {
+                const empty = { _tag: "Empty", nextRunAt, wakeToken: wakeVersion };
+                return empty;
+            }
+            best.state = "active";
+            best.lockToken = options.token;
+            best.lockExpiresAt = now + options.lockDurationMs;
+            best.processedAt = now;
+            const claimed = { _tag: "Claimed", job: snapshot(best) };
+            return claimed;
+        }),
+        ack: (id, token, outcome) => Effect.gen(function* () {
+            const now = yield* Clock.currentTimeMillis;
+            const job = jobs.get(id);
+            if (job === undefined) {
+                return yield* new JobNotFoundError({ jobId: id });
+            }
+            if (job.state !== "active" || job.lockToken !== token) {
+                return yield* new LockLostError({ jobId: id });
+            }
+            clearLock(job);
+            job.attemptsMade += 1;
+            switch (outcome._tag) {
+                case "Complete": {
+                    job.state = "completed";
+                    job.exit = outcome.exit;
+                    job.finishedAt = now;
+                    recordAttempt(job, "completed", now, outcome.exit);
+                    applyKeep(job, now);
+                    break;
+                }
+                case "Fail": {
+                    job.state = "failed";
+                    job.exit = outcome.exit;
+                    job.finishedAt = now;
+                    recordAttempt(job, "failed", now, outcome.exit);
+                    applyKeep(job, now);
+                    break;
+                }
+                case "Retry": {
+                    recordAttempt(job, "retried", now, outcome.exit);
+                    job.runAt = now + Math.max(0, outcome.delayMs);
+                    job.state = outcome.delayMs > 0 ? "delayed" : "waiting";
+                    job.seq = ++seq;
+                    signalWake();
+                    break;
+                }
+            }
+        }),
+        release: (id, token) => Effect.gen(function* () {
+            const job = jobs.get(id);
+            if (job === undefined) {
+                return yield* new JobNotFoundError({ jobId: id });
+            }
+            if (job.state !== "active" || job.lockToken !== token) {
+                return yield* new LockLostError({ jobId: id });
+            }
+            clearLock(job);
+            job.state = "waiting";
+            signalWake();
+        }),
+        extendLocks: (locks, durationMs) => Effect.gen(function* () {
+            const now = yield* Clock.currentTimeMillis;
+            const lost = [];
+            for (const lock of locks) {
+                const job = jobs.get(lock.id);
+                if (job !== undefined &&
+                    job.state === "active" &&
+                    job.lockToken === lock.token) {
+                    job.lockExpiresAt = now + durationMs;
+                }
+                else {
+                    lost.push(lock.id);
+                }
+            }
+            return lost;
+        }),
+        recoverStalled: (options) => Effect.gen(function* () {
+            const now = yield* Clock.currentTimeMillis;
+            const recovered = [];
+            for (const job of jobs.values()) {
+                if (job.state !== "active" ||
+                    job.lockExpiresAt === undefined ||
+                    job.lockExpiresAt > now) {
+                    continue;
+                }
+                clearLock(job);
+                job.stalledCount += 1;
+                recordAttempt(job, "stalled", now, undefined);
+                if (job.stalledCount > options.maxStalledCount) {
+                    job.state = "failed";
+                    job.finishedAt = now;
+                    job.failedReason = "job stalled more than allowable limit";
+                    recovered.push({ id: job.id, failed: true });
+                }
+                else {
+                    job.state = "waiting";
+                    recovered.push({ id: job.id, failed: false });
+                }
+            }
+            if (recovered.some((entry) => !entry.failed)) {
+                signalWake();
+            }
+            return recovered;
+        }),
+        awaitWake: (_queues, wakeToken) => Effect.suspend(() => {
+            if (wakeVersion > wakeToken)
+                return Effect.void;
+            return Deferred.await(wake);
+        }),
+        getJob: (id) => Effect.sync(() => {
+            const job = jobs.get(id);
+            return job === undefined ? Option.none() : Option.some(snapshot(job));
+        }),
+        getAttempts: (id) => Effect.sync(() => {
+            const job = jobs.get(id);
+            return job === undefined ? [] : [...job.attempts];
+        }),
+        list: (options) => Effect.sync(() => {
+            const limit = Math.max(1, options.limit ?? 50);
+            const states = options.states === undefined ? undefined : new Set(options.states);
+            // Newest first, stable across retries: (enqueuedAt desc, id desc).
+            let cursor;
+            if (options.cursor !== undefined) {
+                const split = options.cursor.indexOf(":");
+                cursor = {
+                    at: Number(options.cursor.slice(0, split)),
+                    id: options.cursor.slice(split + 1)
+                };
+            }
+            const matches = Array.from(jobs.values())
+                .filter((job) => (options.queue === undefined || job.queue === options.queue) &&
+                (options.name === undefined || job.name === options.name) &&
+                (states === undefined || states.has(job.state)) &&
+                (options.metadata === undefined || metadataMatches(job.metadata, options.metadata)))
+                .toSorted((a, b) => b.enqueuedAt !== a.enqueuedAt
+                ? b.enqueuedAt - a.enqueuedAt
+                : b.id < a.id
+                    ? -1
+                    : b.id > a.id
+                        ? 1
+                        : 0)
+                .filter((job) => cursor === undefined ||
+                job.enqueuedAt < cursor.at ||
+                (job.enqueuedAt === cursor.at && job.id < cursor.id));
+            const items = matches.slice(0, limit).map(snapshot);
+            const last = items[items.length - 1];
+            const result = {
+                items,
+                cursor: matches.length > limit && last !== undefined
+                    ? `${last.enqueuedAt}:${last.id}`
+                    : undefined
+            };
+            return result;
+        }),
+        retry: (id) => Effect.gen(function* () {
+            const job = jobs.get(id);
+            if (job === undefined) {
+                return yield* new JobNotFoundError({ jobId: id });
+            }
+            if (job.state !== "failed") {
+                return yield* new JobNotRetryableError({ jobId: id, state: job.state });
+            }
+            const now = yield* Clock.currentTimeMillis;
+            job.state = "waiting";
+            job.attemptsMade = 0;
+            job.stalledCount = 0;
+            job.exit = undefined;
+            job.failedReason = undefined;
+            job.finishedAt = undefined;
+            job.processedAt = undefined;
+            job.runAt = now;
+            job.seq = ++seq;
+            signalWake();
+        }),
+        counts: (queue) => Effect.sync(() => {
+            const counts = {
+                waiting: 0,
+                delayed: 0,
+                active: 0,
+                completed: 0,
+                failed: 0
+            };
+            for (const job of jobs.values()) {
+                if (queue !== undefined && job.queue !== queue)
+                    continue;
+                counts[job.state] += 1;
+            }
+            return counts;
+        }),
+        remove: (id) => Effect.sync(() => {
+            const job = jobs.get(id);
+            if (job === undefined || job.state === "active")
+                return false;
+            jobs.delete(id);
+            return true;
+        })
+    });
+});
+/**
+ * A fresh in-memory `JobStore` layer. Pass a named store key to provide a
+ * `JobStore.named(...)` slot instead of the default.
+ *
+ * @since 0.1.0
+ */
+export const layer = Layer.effect(JobStore, make);
+/**
+ * An in-memory layer for a specific store key.
+ *
+ * @since 0.1.0
+ */
+export const layerFor = (store) => Layer.effect(store, make);
+//# sourceMappingURL=MemoryJobStore.js.map

package/dist/MemoryJobStore.js.map

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

package/dist/Worker.d.ts

@@ -0,0 +1,127 @@
+/**
+ * The worker runtime of effect-mq.
+ *
+ * `Worker` is a service that runs registered job handlers against a
+ * `JobStore`. Handlers are registered through `Job.toLayer(handler)`; the
+ * worker starts a set of taker fibers per queue (bounded by the queue's
+ * concurrency), each running the loop:
+ *
+ *   claim -> decode payload -> run handler -> ack (complete | retry | fail)
+ *
+ * plus two maintenance fibers: lock renewal for in-flight jobs, and stalled
+ * job recovery. On scope close, in-flight handlers are interrupted and their
+ * jobs released back to `waiting` without consuming an attempt.
+ *
+ * @since 0.1.0
+ */
+import { Context, Duration, Effect, Exit, Layer, Schema, type Scope } from "effect";
+import { type BackoffPolicy, type JobId, JobStore, QueueName, type Service as StoreService } from "./JobStore.ts";
+/**
+ * Information about the currently running attempt, passed to handlers as the
+ * second argument.
+ *
+ * @since 0.1.0
+ */
+export interface JobContext {
+    readonly jobId: JobId;
+    readonly name: string;
+    readonly queue: QueueName;
+    /** 1-based attempt number. */
+    readonly attempt: number;
+    /** Total attempts allowed for this job. */
+    readonly attemptsMax: number;
+}
+/**
+ * The structural shape of a job definition the worker needs for
+ * registration. `Job.Job` satisfies this — the indirection avoids a module
+ * cycle between `Job` and `Worker`.
+ *
+ * @since 0.1.0
+ */
+export interface JobDescriptor<Payload extends Schema.Top, Success extends Schema.Top, Error extends Schema.Top> {
+    readonly _tag: string;
+    readonly queue: QueueName;
+    /** The store this job is bound to; must match the worker's store. */
+    readonly store: Context.Key<any, StoreService>;
+    readonly payloadSchema: Payload;
+    /** JSON codec for the payload (what is actually stored). */
+    readonly payloadJsonSchema: Schema.Top & {
+        readonly Type: Payload["Type"];
+    };
+    /** JSON codec for handler exits (what is actually stored). */
+    readonly exitSchema: Schema.Top & {
+        readonly Type: Exit.Exit<Success["Type"], Error["Type"]>;
+    };
+}
+/**
+ * @since 0.1.0
+ */
+export interface RegisterOptions {
+    /**
+     * Taker fibers for this job's queue. The first registration for a queue
+     * decides; later values for the same queue are ignored.
+     */
+    readonly concurrency?: number | undefined;
+    /** Override the queue this handler consumes (defaults to the job's queue). */
+    readonly queue?: string | undefined;
+}
+/**
+ * @since 0.1.0
+ */
+export interface WorkerOptions<StoreId = JobStore> {
+    /**
+     * The store this worker claims from (a `JobStore.named(...)` key). Default:
+     * the default `JobStore`. To run workers for several stores in one process,
+     * provide each `Worker.layer({ store })` *locally* to its handler group via
+     * `Layer.provide` (not `provideMerge`).
+     */
+    readonly store?: Context.Key<StoreId, StoreService> | undefined;
+    /** Default taker fibers per queue (default 1). */
+    readonly concurrency?: number | undefined;
+    /** Per-queue configuration, keyed by queue name. */
+    readonly queues?: Readonly<Record<string, {
+        readonly concurrency?: number | undefined;
+    }>> | undefined;
+    /** How long a claim's lock lasts before the job counts as stalled (default 30s). */
+    readonly lockDuration?: Duration.Input | undefined;
+    /** Lock heartbeat interval (default half of `lockDuration`). */
+    readonly lockRenewInterval?: Duration.Input | undefined;
+    /** How often to sweep for stalled jobs (default 30s). */
+    readonly stalledInterval?: Duration.Input | undefined;
+    /** Stalls tolerated before a job is failed outright (default 1). */
+    readonly maxStalledCount?: number | undefined;
+    /** Fallback polling interval when idle and no wake-up arrives (default 5s). */
+    readonly pollInterval?: Duration.Input | undefined;
+    /** Identifier used in lock tokens (default: random). */
+    readonly id?: string | undefined;
+}
+declare const Worker_base: Context.ServiceClass<Worker, "effect-mq/Worker", {
+    readonly register: <Payload extends Schema.Top, Success extends Schema.Top, Error extends Schema.Top, R>(job: JobDescriptor<Payload, Success, Error>, handler: (payload: Payload["Type"], context: JobContext) => Effect.Effect<Success["Type"], Error["Type"], R>, options?: RegisterOptions | undefined) => Effect.Effect<void, never, Scope.Scope | R | Payload["DecodingServices"] | Success["EncodingServices"] | Error["EncodingServices"]>;
+}>;
+/**
+ * @since 0.1.0
+ */
+export declare class Worker extends Worker_base {
+}
+/**
+ * Delay before attempt `attempt` (1-based) re-runs, per the job's policy.
+ *
+ * @internal
+ */
+export declare const backoffDelayMs: (backoff: BackoffPolicy | undefined, attempt: number) => number;
+/**
+ * Build the worker service. Requires a `Scope` (fibers live in it) and the
+ * `JobStore`.
+ *
+ * @since 0.1.0
+ */
+export declare const make: <StoreId = JobStore>(options?: WorkerOptions<StoreId> | undefined) => Effect.Effect<Worker["Service"], never, Scope.Scope | StoreId>;
+/**
+ * Run a worker as a layer. Provide handler layers (`Job.toLayer(...)`) on top
+ * of this, and a `JobStore` below it.
+ *
+ * @since 0.1.0
+ */
+export declare const layer: <StoreId = JobStore>(options?: WorkerOptions<StoreId> | undefined) => Layer.Layer<Worker, never, StoreId>;
+export {};
+//# sourceMappingURL=Worker.d.ts.map

package/dist/Worker.d.ts.map

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