effect-mq 0.1.0 → 0.3.0

package/README.md

@@ -14,7 +14,8 @@ One package, tree-shakeable modules:
 | Import | Contents | Extra peers |
 | --- | --- | --- |
 | `effect-mq` | `Job`, `JobStore`, `MemoryJobStore`, `Worker` | — |
-| `effect-mq/drizzle` | drizzle schema factories + the Postgres `JobStore` | `drizzle-orm` (v1), `@effect/sql-pg` |
+| `effect-mq/drizzle-postgres` | drizzle-postgres schema factories + the Postgres `JobStore` | `drizzle-orm` (v1), `@effect/sql-pg` |
+| `effect-mq/redis` | the Redis `JobStore` (Lua-script atomicity) | a `Redis` service (`@effect/platform-node`/`-bun`) |
 | `effect-mq/testing` | the `JobStore` conformance suite for driver authors | `@effect/vitest` |
 
 ## Five-minute tour
@@ -73,6 +74,156 @@ What you get out of the box:
   and per-job retention via `keep: { count, age }`.
 - **Graceful shutdown** — interrupting a worker releases in-flight jobs back
   to `waiting` without consuming an attempt.
+- **Repeatable jobs** — durable cron/interval schedules
+  (`MyJob.schedule(key, { cron })`) that fire exactly once per occurrence
+  across any number of workers.
+- **Admin verbs** — `cancel` (including *running* jobs, whose handler fiber is
+  interrupted cross-process), `promote` (delayed → now), and queue-level
+  `pause`/`resume`.
+- **Handler timeouts** — `defaults: { timeout: "30 seconds" }` interrupts the
+  handler cleanly and routes through normal retry accounting; something BullMQ
+  can't do to a running processor.
+- **Unrecoverable errors** — `Job.unrecoverable(error)` or a `retryable`
+  predicate skips the remaining retry budget when retrying can't help.
+- **Deduplication** — pending-dedup, throttle, debounce, and
+  replace-while-delayed via a dedup key that never touches your job ids.
+
+## Repeatable jobs
+
+Schedules are durable rows in the store — not process-local timers — so they
+survive restarts and coordinate across workers. Ticks enqueue with a
+slot-deterministic job id (`sched/<key>/<slot>`), which makes every occurrence
+exactly-once no matter how many workers sweep:
+
+```ts
+// Create or replace (same key = replace; upsert is idempotent to deploy).
+yield* SendDigest.schedule("daily", {
+  cron: "0 9 * * *",              // or: every: "10 minutes"
+  tz: "America/New_York",         // IANA zone, cron only
+  payload: { edition: "morning" }
+})
+
+yield* SendDigest.unschedule("daily")
+```
+
+`cron` fires at the next matching occurrence; `every` first fires one interval
+from now and stays on its original grid. If workers are down over several
+occurrences, missed slots collapse into one run (the next sweep enqueues the
+overdue slot once, then advances past `now`). Options mirror `enqueue`:
+`metadata`, `priority`, `attempts`, `backoff`, `keep`, `timeout`.
+
+## Timeouts, cancellation, and unrecoverable errors
+
+Because handlers are Effect fibers, the runtime can *actually stop them* —
+these verbs interrupt cleanly (finalizers run) instead of abandoning work:
+
+```ts
+class GenerateInvoice extends Job.make("generate-invoice", {
+  payload: { invoiceId: Schema.String },
+  error: InvoiceError,
+  defaults: { attempts: 5, timeout: "2 minutes" },  // per-run limit
+  retryable: (e) => e.reason !== "invoice-voided"   // skip retries when futile
+}) {}
+
+// Inside a handler, mark a specific failure as not worth retrying:
+Effect.fail(Job.unrecoverable(new InvoiceError({ reason: "customer deleted" })))
+
+// From anywhere (a dashboard, another process):
+yield* GenerateInvoice.cancel(jobId)   // waiting/delayed: terminal immediately;
+                                       // running: the worker's next heartbeat
+                                       // interrupts the handler fiber
+yield* GenerateInvoice.promote(jobId)  // delayed -> runnable now
+
+// Store-level (definition-free) equivalents for generic dashboards:
+const store = yield* JobStore.JobStore
+yield* store.cancel(jobId)
+yield* store.pause(QueueName("email"))   // claims stop; producers unaffected
+yield* store.resume(QueueName("email"))  // wakes idle workers immediately
+```
+
+A timed-out run records a `TimeoutError` defect in the attempt ledger and
+consumes an attempt like any other failure. A cancelled job lands in the
+terminal `cancelled` state with a `cancelled` ledger entry; `awaitResult`
+treats it as a defect (`JobCancelledError`), not a typed failure.
+
+## History retention
+
+Two layers of control, both splittable by terminal state (completed jobs are
+usually noise, failed ones evidence):
+
+- **Per job**: `keep` prunes terminal records per name+state — flat
+  `{ count, age }` applies to all states, or split per state:
+
+```ts
+keep: { count: 100 }                                              // all states
+keep: { completed: { age: "1 day" }, failed: { age: "30 days" } } // split
+```
+
+- **Per store**: a retention ceiling swept periodically in the background —
+  one duration or a per-state split (an absent state has no ceiling; the
+  timer touches its rows only when they carry their own `keep.age`):
+
+```ts
+MemoryJobStore.layerWith({ historyTtl: "7 days" })
+DrizzleJobStore.layer({ ...tables, historyTtl: { completed: "1 day", failed: "90 days" } })
+```
+
+The sweep honours `min(per-row keep.age, ceiling)`, so a job name that goes
+quiet is still pruned on the timer, not only when its group is next acked.
+
+## Custom job ids
+
+Store-assigned ids default to a compact sequence (`j-<n>`). Bring your own
+generator when you want globally unique or prefixed ids:
+
+```ts
+import { ulid } from "ulid"
+
+DrizzleJobStore.layer({
+  jobs, attempts, schedules, queues,
+  idGenerator: ({ name }) => `${name}_${ulid()}`   // sync or Effect-returning
+})
+```
+
+The generator only runs for store-assigned ids — `idempotencyKey` ids and
+repeatable-schedule tick ids stay deterministic (exactly-once depends on
+them). Collisions are retried a bounded number of times, then the enqueue
+fails; bring real entropy.
+
+## Deduplication
+
+Dedup is a **separate key**, not id derivation — your ids (explicit,
+`idGenerator`, or store-assigned) are never rewritten. Keys are scoped per
+job name and picked per definition or per enqueue:
+
+```ts
+class SyncBenefits extends Job.make("sync-benefits", {
+  payload: { employerId: Schema.String },
+  dedupe: ({ employerId }) => employerId          // string shorthand = { key }
+}) {}
+
+// Per-enqueue, with modes:
+yield* SyncBenefits.enqueue(payload, { dedupe: { key: "emp-1", ttl: "1 minute" } })
+```
+
+Four behaviors, composable from three fields:
+
+| Options | Behavior |
+| --- | --- |
+| `{ key }` | dedupe while the keyed job is pending; finishing frees the key |
+| `{ key, ttl }` | throttle: at most one job per window, even after completion |
+| `{ key, ttl, extend: true }` | debounce: every dropped enqueue pushes the window out |
+| `{ key, replace: true }` | while the keyed job is still delayed, the newest payload/metadata/priority/attempts/backoff/keep/timeout/delay replace it (same id; a `ttl` window re-arms) |
+
+A deduplicated enqueue returns the keyed job's id (`duplicate: true` at the
+store level). `idempotencyKey` still exists and is different on purpose: it
+makes the job id *itself* deterministic (permanent identity, joinable from
+your domain tables), while `dedupe` is temporal policy with its own lifecycle.
+
+Postgres users: dedup adds one table and one jobs column — add
+`export const jobDedupe = mqDedupe()` to your schema and `drizzle-kit
+generate` diffs both (the table and the new `dedupe_key` column) into one
+migration. Memory and Redis need nothing.
 
 ## Postgres through drizzle
 
@@ -93,15 +244,62 @@ migrations** — no library-run DDL, no parallel migration system:
 
 ```ts
 // db/schema.ts
-import { mqJobAttempts, mqJobs } from "effect-mq/drizzle"
+import { mqDedupe, mqJobAttempts, mqJobs, mqQueueControl, mqSchedules } from "effect-mq/drizzle-postgres"
 
 // The `name` column is typed to your job tags (derived, not hand-written):
-type JobNames = typeof SyncBenefits._tag | typeof GenerateReport._tag
+type JobNames = typeof GenerateInvoice._tag | typeof SendEmail._tag
 
 export const jobs = mqJobs<JobNames>()          // default table: effect_mq_jobs
 export const jobAttempts = mqJobAttempts(jobs)  // default: effect_mq_job_attempts
+export const jobSchedules = mqSchedules()       // default: effect_mq_schedules
+export const jobQueues = mqQueueControl()       // default: effect_mq_queue_control
+export const jobDedupe = mqDedupe()             // default: effect_mq_dedupe
 ```
 
+Need more indexes (the built-ins cover claiming, listing, metadata
+containment, and `name`/`state`/`finishedAt` history)? Every factory takes an
+`extraConfig` callback — the same shape as drizzle's third `pgTable` argument —
+appended after the built-in indexes and owned by your migrations like
+everything else:
+
+```ts
+export const jobs = mqJobs<JobNames>("effect_mq_jobs", {
+  extraConfig: (t) => [index("jobs_name_recent_idx").on(t.name, t.enqueuedAt.desc())]
+})
+```
+
+### Custom columns
+
+Need real columns — a tenant id you can FK, RLS-scope, and join — populated
+at job creation instead of patched in from job logic? `extend` the jobs
+table; at enqueue the store fills each extended column from the job's
+`metadata` entry with the same TS key (the definition's
+`metadata: (payload) => ...` is your creation-time hook), NULL when absent:
+
+```ts
+class SyncBenefits extends Job.make("sync-benefits", {
+  payload: { companyId: Schema.String, objectId: Schema.String },
+  metadata: ({ companyId, objectId }) => ({ companyId, objectId })
+}) {}
+
+export const jobs = mqJobs<JobNames>("effect_mq_jobs", {
+  extend: {
+    companyId: text("company_id").notNull(),
+    objectId: text("object_id")
+  },
+  extraConfig: (t) => [index("jobs_company_idx").on(t.companyId, t.state)]
+})
+
+// Coercion/renames when the metadata convention isn't enough:
+DrizzleJobStore.layer({ ...tables, extraValues: ({ metadata }) => ({ companyId: metadata.companyId }) })
+```
+
+`db.select().from(jobs).where(eq(jobs.companyId, tenant))` is fully typed; a
+dedupe `replace` rewrites the extended columns with the latest values; a
+missing metadata key on a `NOT NULL` column fails the enqueue loudly. Memory
+and Redis need nothing — there the metadata projection is already the
+queryable surface (`store.list({ metadata: { companyId } })`).
+
 ```
 drizzle-kit generate   # emits the CREATE TABLE migration next to your others
 drizzle-kit migrate
@@ -113,12 +311,18 @@ When a future effect-mq version changes the layout, the factory changes and
 ### 2. Provide the store layer
 
 ```ts
-import { DrizzleJobStore } from "effect-mq/drizzle"
+import { DrizzleJobStore } from "effect-mq/drizzle-postgres"
 import { PgClient } from "@effect/sql-pg"
 import { Layer, Redacted } from "effect"
-import { jobAttempts, jobs } from "./db/schema.ts"
-
-const JobStoreLive = DrizzleJobStore.layer({ jobs, attempts: jobAttempts }).pipe(
+import { jobAttempts, jobDedupe, jobQueues, jobs, jobSchedules } from "./db/schema.ts"
+
+const JobStoreLive = DrizzleJobStore.layer({
+  jobs,
+  attempts: jobAttempts,
+  schedules: jobSchedules,
+  queues: jobQueues,
+  dedupe: jobDedupe
+}).pipe(
   Layer.provide(PgClient.layer({ url: Redacted.make(process.env.DATABASE_URL!) }))
 )
 ```
@@ -132,8 +336,8 @@ Product UIs read the tables directly with drizzle — fully typed:
 
 ```ts
 db.select().from(jobs).where(and(
-  eq(jobs.name, "sync-benefits"),                    // a typo is a compile error
-  sql`${jobs.metadata} @> ${{ employerId }}::jsonb`  // GIN-indexed containment
+  eq(jobs.name, "generate-invoice"),                 // a typo is a compile error
+  sql`${jobs.metadata} @> ${{ customerId }}::jsonb`  // GIN-indexed containment
 ))
 
 db.select().from(jobAttempts)
@@ -145,9 +349,44 @@ db.select().from(jobAttempts)
 `MyJob.retry(id)`, `store.remove(id)` — so lock tokens, attempt accounting,
 and wake-up notifications stay coherent.
 
-Worker tip: `awaitWake` is LISTEN/NOTIFY-driven, and the worker's
-`pollInterval` is the fallback — `Worker.layer({ pollInterval: "500 millis" })`
-is a good Postgres setting.
+Worker tip: `awaitWake` is LISTEN/NOTIFY-driven and **queue-filtered** (the
+NOTIFY payload names the queue, so an enqueue wakes only the takers watching
+that queue — many queues don't amplify into many claims). The worker's
+`pollInterval` is just the fallback; the 5s default is fine.
+
+## Redis store
+
+The Redis store (`effect-mq/redis`) implements every `JobStore` operation as
+one atomic Lua script, so it is safe across any number of producer and worker
+processes. It builds on Effect's client-agnostic `Redis` service — provide it
+from your platform package (no extra peers beyond what you already run):
+
+```ts
+import { RedisJobStore } from "effect-mq/redis"
+import { NodeRedis } from "@effect/platform-node"   // node-redis under the hood
+// import { BunRedis } from "@effect/platform-bun"  // Bun.redis under the hood
+import { Layer } from "effect"
+
+const JobStoreLive = RedisJobStore.layer({
+  prefix: "myapp-jobs",          // key namespace (default "effect-mq")
+  historyTtl: "30 days"          // optional retention ceiling
+}).pipe(
+  Layer.provide(NodeRedis.layer({ url: process.env.REDIS_URL }))
+)
+```
+
+Wake-ups ride pub/sub (`<prefix>:wake`) with queue-filtered messages, so
+idle workers in other processes pick new jobs up promptly and an enqueue
+wakes only the takers watching its queue; the worker's `pollInterval` is the
+fallback. Notes:
+
+- Keys are plain-prefixed (no hash tags) — point it at a single Redis /
+  Valkey node or a cluster-unaware proxy, not Redis Cluster.
+- `list` filters scan server-side in Lua: fine for dashboards, not for
+  millions of terminal rows — set `historyTtl`/`keep` accordingly. `counts`
+  is O(1) (maintained counters).
+- The same conformance suite that runs against Postgres runs against a real
+  Redis in this repo, TestClock included (scripts take time via ARGV).
 
 ## Multiple stores on different infrastructure
 
@@ -158,17 +397,17 @@ disposable ones live elsewhere — enforced by the type system:
 import { Job, JobStore, MemoryJobStore, Worker } from "effect-mq"
 
 const Durable = JobStore.named("durable")       // -> Postgres in prod
-const Ephemeral = JobStore.named("ephemeral")   // -> memory/Redis
+const Ephemeral = JobStore.named("ephemeral")   // -> Redis or memory
 
-class SyncBenefits extends Job.make("sync-benefits", {
-  payload: { employerId: Schema.String },
-  idempotencyKey: ({ employerId }) => employerId,
+class GenerateInvoice extends Job.make("generate-invoice", {
+  payload: { invoiceId: Schema.String },
+  idempotencyKey: ({ invoiceId }) => invoiceId,
   store: Durable
 }) {}
 
 // Forgetting the Durable layer is now a COMPILE error at every enqueue site.
 // Workers bind to one store:
-const durableWorkers = SyncBenefits.toLayer(handler).pipe(
+const durableWorkers = GenerateInvoice.toLayer(handler).pipe(
   Layer.provide(Worker.layer({ store: Durable }))     // local provide: several
 )                                                     // workers can coexist
 ```
@@ -181,11 +420,11 @@ a **store** is an infrastructure/durability domain hosting many queues.
 
 Two kinds of "business context", two homes:
 
-- **Ops UI** ("list sync runs for employer X, retry that one"): use the
+- **Ops UI** ("list invoice runs for customer X, retry that one"): use the
   `metadata` projection — a flat `Record<string, string>` derived from the
   payload, indexed by every driver, filterable via `store.list` or raw SQL.
-- **Domain history** ("what did this sync actually change"): your own table,
-  joined by the *deterministic* job id from `idempotencyKey`. The queue's
+- **Domain history** ("what did this invoice run actually produce"): your own
+  table, joined by the *deterministic* job id from `idempotencyKey`. The queue's
   retention (`keep`) can then prune freely while your business history lives
   forever. Don't let queue infrastructure own business data lifecycles.
 
@@ -205,12 +444,51 @@ store un-encoded. For `Schema.Redacted` fields, Effect's semantics apply:
 
 Both behaviors are pinned by tests.
 
+## Reference: knobs at a glance
+
+Everything a job definition, an enqueue, and a worker can be tuned with:
+
+**`Job.make(name, options)`** — `payload` (schema or struct fields),
+`success`/`error` schemas, `idempotencyKey(payload)`, `dedupe(payload)`,
+`metadata(payload)`, `retryable(error)`, `queue`, `store`, and `defaults`
+(any per-enqueue option below).
+
+**Per enqueue** (`enqueue`/`execute` options) — `jobId`, `queue`,
+`metadata`, `dedupe`, `delay`, `priority` (higher first), `attempts`,
+`backoff` (`fixed`/`exponential`), `keep` (`count`/`age`), `timeout`.
+
+**Job verbs** — `enqueue`, `execute` (enqueue + await the typed result),
+`poll`, `awaitResult`, `attempts` (the decoded run ledger), `retry`,
+`cancel`, `promote`, `schedule`/`unschedule`, `toLayer` (register the
+handler).
+
+**`Worker.layer(options)`** — all durations take `Duration.Input`:
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `store` | default `JobStore` | which named store this worker claims from |
+| `concurrency` | 1 | taker fibers per queue |
+| `queues` | — | per-queue overrides: `{ email: { concurrency: 5 } }` |
+| `lockDuration` | 30s | how long a claim's lock lasts before it counts as stalled |
+| `lockRenewInterval` | half of `lockDuration` | heartbeat cadence (also delivers cross-process cancels) |
+| `stalledInterval` | 30s | how often to sweep for stalled jobs |
+| `maxStalledCount` | 1 | stalls tolerated before a job is failed outright |
+| `pollInterval` | 5s | idle fallback when no wake-up arrives (wake-ups are queue-filtered and push-based, so the default is fine even on Postgres) |
+| `scheduleSweepInterval` | 15s | how often to tick due repeatable-job schedules |
+| `id` | random | identifier used in lock tokens |
+
+**Store construction** — every driver accepts `idGenerator`, `historyTtl`,
+and `historySweepInterval`; drizzle-postgres additionally takes the table
+instances (+ `validate`), Redis a key `prefix`.
+
 ## Writing a storage driver
 
 Implement the `JobStore` service (one atomic seam: `enqueue`, `claim`, `ack`,
 `release`, `extendLocks`, `recoverStalled`, `awaitWake`, `getJob`,
-`getAttempts`, `list`, `retry`, `counts`, `remove`) and run the conformance
-suite against it:
+`getAttempts`, `list`, `retry`, `counts`, `remove`, `cancel`, `promote`,
+`pause`/`resume`/`pausedQueues`, and the schedule ops
+`upsertSchedule`/`removeSchedule`/`listSchedules`/`dueSchedules`/`advanceSchedule`)
+and run the conformance suite against it:
 
 ```ts
 import { jobStoreConformance } from "effect-mq/testing"
@@ -226,9 +504,11 @@ suite in this repo runs the same conformance tests against a real database.
 
 ## Roadmap
 
-- `effect-mq/redis` (Bun.redis / ioredis-free) behind the same conformance suite
-- A standalone non-drizzle Postgres driver on plain `@effect/sql-pg`
-- Repeatable/cron jobs, rate limiting, a reference dashboard
+Next up: trace propagation, a cross-process event stream, batch enqueue,
+custom drizzle columns, and parent-child fan-out. Full prioritized list:
+[ROADMAP.md](https://github.com/TeamWarp/effect-mq/blob/main/ROADMAP.md);
+release history:
+[CHANGELOG.md](https://github.com/TeamWarp/effect-mq/blob/main/CHANGELOG.md).
 
 ## License
 

package/dist/Job.d.ts

@@ -31,7 +31,15 @@
  * @since 0.1.0
  */
 import { type Context, Duration, Effect, type Exit, Layer, Option, Schedule, Schema } from "effect";
-import { type BackoffPolicy, JobId, JobNotFoundError, type JobNotRetryableError, type JobState, JobStore, type KeepPolicy, QueueName, type Service as StoreService } from "./JobStore.ts";
+import { type BackoffPolicy, JobId, type JobNotCancellableError, JobNotFoundError, type JobNotPromotableError, type JobNotRetryableError, type JobState, JobStore, type KeepPolicy, QueueName, ScheduleKey, type Service as StoreService, unrecoverable } from "./JobStore.ts";
+export { 
+/**
+ * Mark an error value as unrecoverable: the worker skips the remaining
+ * retry budget and fails the job immediately. Returns the error unchanged.
+ *
+ * @since 0.2.0
+ */
+unrecoverable };
 import { type JobContext, type RegisterOptions, Worker } from "./Worker.ts";
 declare const TypeId: "~effect-mq/Job";
 /**
@@ -58,12 +66,30 @@ export interface BackoffInput {
  *
  * @since 0.1.0
  */
-export interface KeepInput {
+export interface KeepStateInput {
     /** Keep at most this many terminal records (per name + state). */
     readonly count?: number | undefined;
     /** Remove terminal records older than this. */
     readonly age?: Duration.Input | undefined;
 }
+/**
+ * Retention input: a flat `{ count, age }` applies to all terminal states;
+ * the split form sets independent rules per state (completed jobs are
+ * usually noise, failed ones evidence) — an absent state keeps its records
+ * until the store's `historyTtl` ceiling:
+ *
+ * ```ts
+ * keep: { count: 100 }                                        // all states
+ * keep: { completed: { age: "1 day" }, failed: { age: "30 days" } }
+ * ```
+ *
+ * @since 0.1.0
+ */
+export type KeepInput = KeepStateInput | {
+    readonly completed?: KeepStateInput | undefined;
+    readonly failed?: KeepStateInput | undefined;
+    readonly cancelled?: KeepStateInput | undefined;
+};
 /**
  * Options shared between job defaults and per-enqueue overrides.
  *
@@ -79,7 +105,35 @@ export interface JobOptions {
     readonly backoff?: BackoffInput | undefined;
     /** Retention for terminal records. Default: keep forever. */
     readonly keep?: KeepInput | undefined;
+    /**
+     * Per-run execution time limit; the worker interrupts the handler fiber
+     * past it and the run counts as a failed attempt (retried per backoff).
+     */
+    readonly timeout?: Duration.Input | undefined;
 }
+/**
+ * @since 0.1.0
+ */
+/**
+ * Deduplication input for `Job.make({ dedupe })` and per-enqueue overrides.
+ * A bare string is shorthand for `{ key }`. Dedup never changes the job id —
+ * it is a separate, name-scoped key:
+ *
+ * - `{ key }`: dedupe while the keyed job is pending; done jobs free the key.
+ * - `{ key, ttl }`: throttle — at most one job per window.
+ * - `{ key, ttl, extend: true }`: debounce — dropped enqueues push the
+ *   window out.
+ * - `{ key, replace: true }`: while the keyed job is still delayed, the new
+ *   enqueue's content replaces it (latest wins).
+ *
+ * @since 0.3.0
+ */
+export type DedupeInput = string | {
+    readonly key: string;
+    readonly ttl?: Duration.Input | undefined;
+    readonly extend?: boolean | undefined;
+    readonly replace?: boolean | undefined;
+};
 /**
  * @since 0.1.0
  */
@@ -94,6 +148,8 @@ export interface EnqueueOptions extends JobOptions {
     readonly queue?: string | undefined;
     /** Queryable business context, merged over the definition's `metadata`. */
     readonly metadata?: Readonly<Record<string, string>> | undefined;
+    /** Deduplicate by key (see `DedupeInput`); overrides the definition's `dedupe`. */
+    readonly dedupe?: DedupeInput | undefined;
 }
 interface ResolvedDefaults {
     readonly delayMs: number;
@@ -101,6 +157,27 @@ interface ResolvedDefaults {
     readonly attempts: number;
     readonly backoff: BackoffPolicy | undefined;
     readonly keep: KeepPolicy | undefined;
+    readonly timeoutMs: number | undefined;
+}
+/**
+ * Options for `Job.schedule`. Exactly one of `cron` (with optional IANA `tz`)
+ * or `every` must be set. `cron` schedules first fire at the next matching
+ * occurrence; `every` schedules first fire one interval from now.
+ *
+ * @since 0.2.0
+ */
+export interface ScheduleOptions<PayloadInput> {
+    readonly cron?: string | undefined;
+    readonly tz?: string | undefined;
+    readonly every?: Duration.Input | undefined;
+    readonly payload: PayloadInput;
+    /** Queryable business context, merged over the definition's `metadata`. */
+    readonly metadata?: Readonly<Record<string, string>> | undefined;
+    readonly priority?: number | undefined;
+    readonly attempts?: number | undefined;
+    readonly backoff?: BackoffInput | undefined;
+    readonly keep?: KeepInput | undefined;
+    readonly timeout?: Duration.Input | undefined;
 }
 /**
  * The status of a job as seen by `poll`. Fetch the full run ledger with
@@ -125,8 +202,8 @@ export interface JobAttempt<A, E> {
     readonly attempt: number;
     readonly startedAt: number | undefined;
     readonly finishedAt: number;
-    readonly outcome: "completed" | "retried" | "failed" | "stalled";
-    /** Absent for `stalled` entries. */
+    readonly outcome: "completed" | "retried" | "failed" | "stalled" | "cancelled";
+    /** Absent for `stalled` and `cancelled` entries. */
     readonly exit: Option.Option<Exit.Exit<A, E>>;
 }
 /**
@@ -151,7 +228,9 @@ export interface Job<Name extends string, Payload extends AnyStructSchema, Succe
     /** JSON codec for handler exits — what is actually persisted. */
     readonly exitSchema: Schema.toCodecJson<Schema.Exit<Schema.toCodecJson<Success>, Schema.toCodecJson<Error>, Schema.Defect>>;
     readonly idempotencyKey: ((payload: Payload["Type"]) => string) | undefined;
+    readonly dedupe: ((payload: Payload["Type"]) => DedupeInput) | undefined;
     readonly metadata: ((payload: Payload["Type"]) => Readonly<Record<string, string>>) | undefined;
+    readonly retryable: ((error: Error["Type"]) => boolean) | undefined;
     readonly defaults: ResolvedDefaults;
     /**
      * Queue this job. Returns the job id. Duplicate ids (via `jobId` or
@@ -176,6 +255,30 @@ export interface Job<Name extends string, Payload extends AnyStructSchema, Succe
      * preserved. (The admin op behind a dashboard's "retry" button.)
      */
     readonly retry: (jobId: JobId) => Effect.Effect<void, JobNotFoundError | JobNotRetryableError, StoreId>;
+    /**
+     * Cancel a job: waiting/delayed become terminal (`cancelled`) immediately;
+     * a running job's handler fiber is interrupted by its worker on the next
+     * heartbeat (latency ≤ `lockRenewInterval`).
+     */
+    readonly cancel: (jobId: JobId) => Effect.Effect<void, JobNotFoundError | JobNotCancellableError, StoreId>;
+    /** Run a delayed job now. */
+    readonly promote: (jobId: JobId) => Effect.Effect<void, JobNotFoundError | JobNotPromotableError, StoreId>;
+    /**
+     * Create or replace a durable repeatable schedule for this job. Ticks
+     * enqueue with a slot-deterministic id, so schedules are exactly-once per
+     * occurrence across all workers (assuming history retention windows
+     * comfortably exceed the sweep interval — a pruned tick job cannot dedup a
+     * pathologically stale sweeper). Missed occurrences (downtime) collapse
+     * into a single catch-up run.
+     *
+     * Re-registering with an *unchanged* cadence (same `cron`/`tz`/`every`) is
+     * a no-op for the next occurrence — deploy-time re-registration neither
+     * re-anchors `every` grids nor drops a pending catch-up run. Changing the
+     * cadence resets the next occurrence.
+     */
+    readonly schedule: (key: string, options: ScheduleOptions<Payload["~type.make.in"]>) => Effect.Effect<ScheduleKey, never, StoreId | Payload["EncodingServices"]>;
+    /** Remove a schedule created by `schedule`. False when it did not exist. */
+    readonly unschedule: (key: string) => Effect.Effect<boolean, never, StoreId>;
     /**
      * Attach the handler that processes this job, as a layer to provide on top
      * of `Worker.layer` (bound to the same store).
@@ -204,11 +307,22 @@ export declare const make: <const Name extends string, Payload extends Schema.St
      * while the first job still exists is a no-op (returns the existing id).
      */
     readonly idempotencyKey?: ((payload: Payload extends Schema.Struct.Fields ? Schema.Struct.Type<Payload> : Payload["Type"]) => string) | undefined;
+    /**
+     * Derive a dedup key (and optional throttle/debounce/replace behavior)
+     * from the payload. Unlike `idempotencyKey`, this never changes the job
+     * id — see `DedupeInput` for the mode semantics.
+     */
+    readonly dedupe?: ((payload: Payload extends Schema.Struct.Fields ? Schema.Struct.Type<Payload> : Payload["Type"]) => DedupeInput) | undefined;
     /**
      * Derive queryable business context from the payload (flat string map, so
      * every driver can index it). Merged with per-enqueue `metadata`.
      */
     readonly metadata?: ((payload: Payload extends Schema.Struct.Fields ? Schema.Struct.Type<Payload> : Payload["Type"]) => Readonly<Record<string, string>>) | undefined;
+    /**
+     * When present, a typed handler failure for which this returns false
+     * skips the remaining retry budget (see also `Job.unrecoverable`).
+     */
+    readonly retryable?: ((error: Error["Type"]) => boolean) | undefined;
     /** The queue this job runs on. Default `"default"`. */
     readonly queue?: string | undefined;
     /**
@@ -218,5 +332,4 @@ export declare const make: <const Name extends string, Payload extends Schema.St
     readonly store?: Context.Key<StoreId, StoreService> | undefined;
     readonly defaults?: JobOptions | undefined;
 }) => Job<Name, Payload extends Schema.Struct.Fields ? Schema.Struct<Payload> : Payload, Success, Error, StoreId>;
-export {};
 //# sourceMappingURL=Job.d.ts.map

package/dist/Job.d.ts.map

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