@c9up/bay 0.1.12 → 0.2.0

package/dist/jobs.js

@@ -0,0 +1,105 @@
+/**
+ * Finding the job classes an application wrote.
+ *
+ * A job class carries its own name, and a worker resolves a queued record by
+ * that name — so the worker process has to have imported the class. Written by
+ * hand that is a registration list to keep in step with a directory:
+ *
+ *     queue.registerJob(SendEmail)
+ *     queue.registerJob(SendInvoice)   // …and the one nobody added
+ *
+ * `locations` in `config/queue.ts` is the directory instead. Every module under
+ * it is imported once at boot, and a default export that is a job class is
+ * registered under its own name.
+ *
+ * Directories, not globs. `'./app/jobs/**\/*.{ts,js}'` — the spelling upstream's
+ * config uses — is accepted and read as the directory it starts with, so a
+ * config copied from there works; bay ships no glob engine and adding a
+ * dependency for one path shape is not worth it.
+ */
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { pathToFileURL } from "node:url";
+import { isJobClass } from "./Job.js";
+/** Where `make:job` writes, and where discovery looks when nothing is declared. */
+export const DEFAULT_JOBS_DIR = "app/jobs";
+let jobsDir = DEFAULT_JOBS_DIR;
+/** @internal Told by the provider what the config declared. */
+export function setJobsDir(dir) {
+    jobsDir = dir;
+}
+/** Where job files live — the first `locations` entry, or the default. */
+export function getJobsDir() {
+    return jobsDir;
+}
+/**
+ * The directory a `locations` entry names.
+ *
+ * Everything from the first glob character on is dropped: `app/jobs/** /*.ts`
+ * and `app/jobs` name the same directory, and the walk below is recursive
+ * either way.
+ */
+export function directoryOf(location) {
+    const withoutGlob = location.split(/[*?[{]/)[0] ?? location;
+    const trimmed = withoutGlob.replace(/\/+$/, "");
+    return trimmed.replace(/^\.\//, "") || ".";
+}
+/** Every module file under `dir`, recursively. */
+async function walk(dir, depth = 0) {
+    // A jobs directory is a flat convention with the occasional subdirectory;
+    // an unbounded walk would follow whatever happens to live under it.
+    if (depth > 8)
+        return [];
+    let entries;
+    try {
+        entries = await fsp.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        // A declared directory that does not exist yet is not an error: a project
+        // can name where its jobs will go before writing the first one.
+        return [];
+    }
+    const found = [];
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            found.push(...(await walk(full, depth + 1)));
+            continue;
+        }
+        // `.d.ts` is a declaration, not a module with a job in it.
+        if (/\.d\.[cm]?ts$/.test(entry.name))
+            continue;
+        if (/\.[cm]?[jt]s$/.test(entry.name))
+            found.push(full);
+    }
+    return found.sort();
+}
+/**
+ * Import every module under `locations` and return the job classes they
+ * default-export.
+ *
+ * A module that throws on import is reported and skipped: one unfinished job
+ * file must not stop the worker from running every other job.
+ */
+export async function discoverJobs(locations) {
+    const found = [];
+    for (const location of locations) {
+        for (const file of await walk(directoryOf(location))) {
+            let module;
+            try {
+                module = await import(pathToFileURL(path.resolve(file)).href);
+            }
+            catch (err) {
+                process.stderr.write(`[bay] could not load '${file}': ${err instanceof Error ? err.message : String(err)}\n`);
+                continue;
+            }
+            if (typeof module !== "object" || module === null)
+                continue;
+            const exported = Reflect.get(module, "default");
+            if (isJobClass(exported))
+                found.push(exported);
+        }
+    }
+    return found;
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

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

package/dist/nodeEnv.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Reading `NODE_ENV`, with the aliases people actually set.
+ *
+ * `NODE_ENV=prod` is ordinary in a Dockerfile or a platform dashboard. Read
+ * verbatim it answers "not production" — and here that decides whether a queue
+ * silently accepts a delivery guarantee weaker than the one it advertises.
+ *
+ * Duplicated rather than imported: bay depends on no other package in this
+ * workspace, and a safety decision that only holds when an optional peer is
+ * installed is not a decision.
+ */
+/** The canonical name for whatever `NODE_ENV` holds. */
+export declare function normalizeNodeEnv(value: string | undefined): string;
+/** Whether this process is running in production, under any spelling. */
+export declare function inProduction(): boolean;
+//# sourceMappingURL=nodeEnv.d.ts.map

package/dist/nodeEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeEnv.d.ts","sourceRoot":"","sources":["../src/nodeEnv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAOlE;AAED,yEAAyE;AACzE,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/nodeEnv.js

@@ -0,0 +1,32 @@
+/**
+ * Reading `NODE_ENV`, with the aliases people actually set.
+ *
+ * `NODE_ENV=prod` is ordinary in a Dockerfile or a platform dashboard. Read
+ * verbatim it answers "not production" — and here that decides whether a queue
+ * silently accepts a delivery guarantee weaker than the one it advertises.
+ *
+ * Duplicated rather than imported: bay depends on no other package in this
+ * workspace, and a safety decision that only holds when an optional peer is
+ * installed is not a decision.
+ */
+const DEV_ENVS = ["dev", "develop", "development"];
+const PROD_ENVS = ["prod", "production"];
+const TEST_ENVS = ["test", "testing"];
+/** The canonical name for whatever `NODE_ENV` holds. */
+export function normalizeNodeEnv(value) {
+    if (!value || typeof value !== "string")
+        return "unknown";
+    const env = value.toLowerCase();
+    if (DEV_ENVS.includes(env))
+        return "development";
+    if (PROD_ENVS.includes(env))
+        return "production";
+    if (TEST_ENVS.includes(env))
+        return "test";
+    return env;
+}
+/** Whether this process is running in production, under any spelling. */
+export function inProduction() {
+    return normalizeNodeEnv(process.env.NODE_ENV) === "production";
+}
+//# sourceMappingURL=nodeEnv.js.map

package/dist/nodeEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeEnv.js","sourceRoot":"","sources":["../src/nodeEnv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACnD,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACzC,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEtC,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC;IACjD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC;IACjD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,YAAY;IAC3B,OAAO,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,YAAY,CAAC;AAChE,CAAC"}

package/dist/quasar.d.ts

@@ -3,7 +3,7 @@
  *
  * Bay does not depend on quasar: it is an optional peer, and this module
  * never imports it statically. The specifier is built at runtime so the
- * TypeScript build stays free of it too — a hard type import would make echo
+ * TypeScript build stays free of it too — a hard type import would make bay
  * unbuildable for anyone who queues in memory.
  *
  * The shape is checked before use rather than asserted, the same way bay

package/dist/quasar.js

@@ -3,7 +3,7 @@
  *
  * Bay does not depend on quasar: it is an optional peer, and this module
  * never imports it statically. The specifier is built at runtime so the
- * TypeScript build stays free of it too — a hard type import would make echo
+ * TypeScript build stays free of it too — a hard type import would make bay
  * unbuildable for anyone who queues in memory.
  *
  * The shape is checked before use rather than asserted, the same way bay

package/dist/services/main.d.ts

@@ -17,6 +17,11 @@ import type { QueueManager } from "../QueueManager.js";
 export declare function setQueue(value: QueueManager): void;
 /** @internal Read the singleton (or `undefined` pre-boot). */
 export declare function getQueue(): QueueManager | undefined;
+/**
+ * @internal Release the singleton, so a shut-down application does not leave a
+ * dead queue reachable through `services/main`.
+ */
+export declare function clearQueue(): void;
 declare const queue: QueueManager;
 export default queue;
 //# sourceMappingURL=main.d.ts.map

package/dist/services/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAElD;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,IAAI,YAAY,GAAG,SAAS,CAEnD;AAED,QAAA,MAAM,KAAK,EAAE,YAoBX,CAAC;AAEH,eAAe,KAAK,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAElD;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,IAAI,YAAY,GAAG,SAAS,CAEnD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,QAAA,MAAM,KAAK,EAAE,YAoBX,CAAC;AAEH,eAAe,KAAK,CAAC"}

package/dist/services/main.js

@@ -21,6 +21,13 @@ export function setQueue(value) {
 export function getQueue() {
     return instance;
 }
+/**
+ * @internal Release the singleton, so a shut-down application does not leave a
+ * dead queue reachable through `services/main`.
+ */
+export function clearQueue() {
+    instance = undefined;
+}
 const queue = new Proxy({}, {
     get(_target, prop) {
         // A module loader inspects what it imports before anyone uses it: it reads

package/dist/services/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,IAAI,QAAkC,CAAC;AAEvC,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,KAAmB;IAC3C,QAAQ,GAAG,KAAK,CAAC;AAClB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ;IACvB,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,KAAK,GAAiB,IAAI,KAAK,CAAC,EAAkB,EAAE;IACzD,GAAG,CAAC,OAAO,EAAE,IAAI;QAChB,2EAA2E;QAC3E,0EAA0E;QAC1E,8DAA8D;QAC9D,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACjD,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,sEAAsE;gBACrE,4DAA4D,CAC7D,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,KAAK,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,IAAI,QAAkC,CAAC;AAEvC,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,KAAmB;IAC3C,QAAQ,GAAG,KAAK,CAAC;AAClB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ;IACvB,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACzB,QAAQ,GAAG,SAAS,CAAC;AACtB,CAAC;AAED,MAAM,KAAK,GAAiB,IAAI,KAAK,CAAC,EAAkB,EAAE;IACzD,GAAG,CAAC,OAAO,EAAE,IAAI;QAChB,2EAA2E;QAC3E,0EAA0E;QAC1E,8DAA8D;QAC9D,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACjD,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,sEAAsE;gBACrE,4DAA4D,CAC7D,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,KAAK,CAAC"}

package/dist/testing/FakeQueue.d.ts

@@ -8,7 +8,7 @@
  * `@c9up/bay/testing` so production code never accidentally pulls
  * the fake into a runtime build.
  */
-import type { Job, QueueDriver } from "../QueueManager.js";
+import type { JobRecord, QueueDriver } from "../QueueManager.js";
 export interface FakeQueuePredicate {
     /** Custom payload predicate — receives the job's `payload` and
      *  returns `true` to match. The job name is always taken from the
@@ -18,25 +18,31 @@ export interface FakeQueuePredicate {
      *  matches 'b' but the error message says 'a'). */
     payloadMatches?: (payload: unknown) => boolean;
 }
-export type FakeQueuePredicateArg = FakeQueuePredicate | ((job: Job) => boolean);
+export type FakeQueuePredicateArg = FakeQueuePredicate | ((job: JobRecord) => boolean);
 export declare class FakeQueue implements QueueDriver {
     #private;
-    push(job: Job): Promise<void>;
+    push(job: JobRecord): Promise<void>;
     /** Always returns `null` — fake queues never auto-dispatch.
      *  Tests that need handler execution should use the memory
      *  driver directly. */
-    pop(): Promise<Job | null>;
-    fail(job: Job, error: string): Promise<void>;
-    complete(job: Job): Promise<void>;
-    retry(job: Job): Promise<void>;
-    failed(): Promise<Job[]>;
+    /**
+     * Always empty: this fake captures what was dispatched, it does not run it.
+     *
+     * The parameter is declared so the queue names a caller asks for are part of
+     * the signature a test reads, even though nothing here serves them.
+     */
+    pop(_queues?: readonly string[]): Promise<JobRecord | null>;
+    fail(job: JobRecord, error: string): Promise<void>;
+    complete(job: JobRecord): Promise<void>;
+    retry(job: JobRecord): Promise<void>;
+    failed(): Promise<JobRecord[]>;
     size(): Promise<number>;
     /**
      * Defensive snapshot of every captured job. Each entry is a
      * shallow clone so test-side mutations can't bleed back into the
      * internal capture store — avoids cross-test contamination.
      */
-    getPushed(): Job[];
+    getPushed(): JobRecord[];
     reset(): void;
     assertPushed(name: string, predicate?: FakeQueuePredicateArg): void;
     assertNotPushed(name: string, predicate?: FakeQueuePredicateArg): void;

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

@@ -1 +1 @@
-{"version":3,"file":"FakeQueue.d.ts","sourceRoot":"","sources":["../../src/testing/FakeQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IAClC;;;;;uDAKmD;IACnD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAC/C;AAED,MAAM,MAAM,qBAAqB,GAC9B,kBAAkB,GAClB,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;AAE3B,qBAAa,SAAU,YAAW,WAAW;;IAGtC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnC;;2BAEuB;IACjB,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAI1B,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B9B,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAMxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;;;OAIG;IACH,SAAS,IAAI,GAAG,EAAE;IAIlB,KAAK,IAAI,IAAI;IAIb,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAQnE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,qBAAqB,GAAG,IAAI;CAQtE"}
+{"version":3,"file":"FakeQueue.d.ts","sourceRoot":"","sources":["../../src/testing/FakeQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IAClC;;;;;uDAKmD;IACnD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAC/C;AAED,MAAM,MAAM,qBAAqB,GAC9B,kBAAkB,GAClB,CAAC,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC;AAEjC,qBAAa,SAAU,YAAW,WAAW;;IAGtC,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC;;2BAEuB;IACvB;;;;;OAKG;IACG,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAI3D,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BpC,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAM9B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;;;OAIG;IACH,SAAS,IAAI,SAAS,EAAE;IAIxB,KAAK,IAAI,IAAI;IAIb,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAQnE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,qBAAqB,GAAG,IAAI;CAQtE"}

package/dist/testing/FakeQueue.js

@@ -22,7 +22,13 @@ export class FakeQueue {
     /** Always returns `null` — fake queues never auto-dispatch.
      *  Tests that need handler execution should use the memory
      *  driver directly. */
-    async pop() {
+    /**
+     * Always empty: this fake captures what was dispatched, it does not run it.
+     *
+     * The parameter is declared so the queue names a caller asks for are part of
+     * the signature a test reads, even though nothing here serves them.
+     */
+    async pop(_queues) {
         return null;
     }
     async fail(job, error) {
@@ -37,7 +43,11 @@ export class FakeQueue {
     }
     async retry(job) {
         const found = this.#requireJob(job, "retry");
-        found.attempts += 1;
+        // `attempts` is the WORKER's counter, not the driver's: `processOne`
+        // increments it before it calls this, and neither real driver touches it
+        // again. Incrementing here counted the same attempt twice, so a fake
+        // exhausted `maxAttempts` in half the tries the real queue takes — a
+        // test double that disagrees with what it stands in for.
         found.status = "pending";
         // Reset transient state from the prior failure so a retried
         // job's invariants match a fresh push (a real driver would
@@ -48,7 +58,7 @@ export class FakeQueue {
     }
     /** Look up the captured copy of a job by id. Throws when the id
      *  isn't present — silent no-op on a missing job is the most
-     *  insidious test bug (caller's local Job ref shows the new
+     *  insidious test bug (caller's local job ref shows the new
      *  status while the FakeQueue's internal capture is unchanged). */
     #requireJob(job, verb) {
         const found = this.#pushed.find((j) => j.id === job.id);

package/dist/testing/FakeQueue.js.map

@@ -1 +1 @@
-{"version":3,"file":"FakeQueue.js","sourceRoot":"","sources":["../../src/testing/FakeQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH,MAAM,OAAO,SAAS;IACrB,OAAO,GAAU,EAAE,CAAC;IAEpB,KAAK,CAAC,IAAI,CAAC,GAAQ;QAClB,+DAA+D;QAC/D,4DAA4D;QAC5D,6DAA6D;QAC7D,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACd,gCAAgC,GAAG,CAAC,EAAE,wGAAwG,CAC9I,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED;;2BAEuB;IACvB,KAAK,CAAC,GAAG;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAQ,EAAE,KAAa;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;QACxB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAQ;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAChD,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;QAC3B,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAQ;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7C,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;QACpB,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;QACzB,4DAA4D;QAC5D,2DAA2D;QAC3D,8DAA8D;QAC9D,4BAA4B;QAC5B,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QACxB,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;;uEAGmE;IACnE,WAAW,CAAC,GAAQ,EAAE,IAAY;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACd,aAAa,IAAI,aAAa,GAAG,CAAC,EAAE,iGAAiG,CACrI,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM;QACX,OAAO,IAAI,CAAC,OAAO;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,SAAS;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,SAAiC;QAC3D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO;QACrC,MAAM,IAAI,KAAK,CACd,uBAAuB,IAAI,IAAI,iBAAiB,CAAC,SAAS,CAAC,wCAAwC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CACnI,CAAC;IACH,CAAC;IAED,eAAe,CAAC,IAAY,EAAE,SAAiC;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,IAAI,KAAK,CACd,0BAA0B,IAAI,IAAI,iBAAiB,CAAC,SAAS,CAAC,kDAAkD,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAChJ,CAAC;IACH,CAAC;CACD;AAED,SAAS,WAAW,CACnB,IAAY,EACZ,SAA4C;IAE5C,8DAA8D;IAC9D,2CAA2C;IAC3C,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;IAC/B,CAAC;IACD,gEAAgE;IAChE,wCAAwC;IACxC,OAAO,CAAC,CAAC,EAAE,EAAE;QACZ,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,SAAS,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACtE,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACzB,SAA4C;IAE5C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,OAAO,SAAS,KAAK,UAAU;QAAE,OAAO,wBAAwB,CAAC;IACrE,kEAAkE;IAClE,iEAAiE;IACjE,oDAAoD;IACpD,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QACtC,OAAO,iCAAiC,CAAC;IAC1C,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAe;IACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC;IACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CACzB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACR,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,WAAW,EAAE,CACvF,CAAC;IACF,OAAO,aAAa,QAAQ,CAAC,MAAM,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"FakeQueue.js","sourceRoot":"","sources":["../../src/testing/FakeQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH,MAAM,OAAO,SAAS;IACrB,OAAO,GAAgB,EAAE,CAAC;IAE1B,KAAK,CAAC,IAAI,CAAC,GAAc;QACxB,+DAA+D;QAC/D,4DAA4D;QAC5D,6DAA6D;QAC7D,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACd,gCAAgC,GAAG,CAAC,EAAE,wGAAwG,CAC9I,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED;;2BAEuB;IACvB;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,OAA2B;QACpC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAc,EAAE,KAAa;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;QACxB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAc;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAChD,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;QAC3B,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAc;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7C,qEAAqE;QACrE,yEAAyE;QACzE,qEAAqE;QACrE,qEAAqE;QACrE,yDAAyD;QACzD,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;QACzB,4DAA4D;QAC5D,2DAA2D;QAC3D,8DAA8D;QAC9D,4BAA4B;QAC5B,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QACxB,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;;uEAGmE;IACnE,WAAW,CAAC,GAAc,EAAE,IAAY;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACd,aAAa,IAAI,aAAa,GAAG,CAAC,EAAE,iGAAiG,CACrI,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM;QACX,OAAO,IAAI,CAAC,OAAO;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,SAAS;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,SAAiC;QAC3D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO;QACrC,MAAM,IAAI,KAAK,CACd,uBAAuB,IAAI,IAAI,iBAAiB,CAAC,SAAS,CAAC,wCAAwC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CACnI,CAAC;IACH,CAAC;IAED,eAAe,CAAC,IAAY,EAAE,SAAiC;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,IAAI,KAAK,CACd,0BAA0B,IAAI,IAAI,iBAAiB,CAAC,SAAS,CAAC,kDAAkD,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAChJ,CAAC;IACH,CAAC;CACD;AAED,SAAS,WAAW,CACnB,IAAY,EACZ,SAA4C;IAE5C,8DAA8D;IAC9D,2CAA2C;IAC3C,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;IAC/B,CAAC;IACD,gEAAgE;IAChE,wCAAwC;IACxC,OAAO,CAAC,CAAC,EAAE,EAAE;QACZ,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,SAAS,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACtE,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACzB,SAA4C;IAE5C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,OAAO,SAAS,KAAK,UAAU;QAAE,OAAO,wBAAwB,CAAC;IACrE,kEAAkE;IAClE,iEAAiE;IACjE,oDAAoD;IACpD,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QACtC,OAAO,iCAAiC,CAAC;IAC1C,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAqB;IAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC;IACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CACzB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACR,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,WAAW,EAAE,CACvF,CAAC;IACF,OAAO,aAAa,QAAQ,CAAC,MAAM,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/bay",
-  "version": "0.1.12",
+  "version": "0.2.0",
   "description": "Queue — pluggable job-queue contract with memory + Redis drivers for the Ream framework",
   "license": "MIT",
   "type": "module",
@@ -15,6 +15,10 @@
       "types": "./dist/BayProvider.d.ts",
       "import": "./dist/BayProvider.js"
     },
+    "./configure": {
+      "types": "./dist/configure.d.ts",
+      "import": "./dist/configure.js"
+    },
     "./services/main": {
       "types": "./dist/services/main.d.ts",
       "import": "./dist/services/main.js"
@@ -32,8 +36,10 @@
     "@biomejs/biome": "^2.4.10",
     "@c9up/quasar": "^0.1.0",
     "@types/node": "^22.19.15",
+    "@vitest/coverage-v8": "^4.1.2",
     "typescript": "^6.0.2",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.2",
+    "@c9up/ream": "^0.2.0"
   },
   "engines": {
     "node": ">=22.0.0"
@@ -62,7 +68,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "test": "vitest run",
-    "lint": "biome check src/",
+    "lint": "biome check src/ tests/",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit"
   }

package/src/BayProvider.ts

@@ -1,6 +1,15 @@
+import type { AdapterFactory } from "./adapters.js";
+import "./augmentations.js";
 import { MemoryDriver } from "./drivers/MemoryDriver.js";
-import { QueueManager } from "./QueueManager.js";
-import { setQueue } from "./services/main.js";
+import {
+	DEFAULT_JOBS_DIR,
+	directoryOf,
+	discoverJobs,
+	setJobsDir,
+} from "./jobs.js";
+import type { QueueDriver } from "./QueueManager.js";
+import { QueueManager, type WorkerOptions } from "./QueueManager.js";
+import { clearQueue, getQueue, setQueue } from "./services/main.js";
 
 /**
  * Slim, duck-typed host context — bay stays publishable without
@@ -8,11 +17,16 @@ import { setQueue } from "./services/main.js";
  * `singleton(token, factory)` + `resolve(token)` and a config store
  * with `get(key)` satisfies the contract.
  */
-interface BayContainer {
+/**
+ * The slice of a host container bay uses. Exported because `BayAppContext` is:
+ * a host — or a test — cannot describe one without being able to name its
+ * members, and the two that could not were reached for with `as any` instead.
+ */
+export interface BayContainer {
 	singleton(token: unknown, factory: () => unknown): void;
 	resolve<T = unknown>(token: unknown): Promise<T>;
 }
-interface BayConfigStore {
+export interface BayConfigStore {
 	get<T = unknown>(key: string): T | undefined;
 }
 export interface BayAppContext {
@@ -22,16 +36,45 @@ export interface BayAppContext {
 
 export interface BayProviderConfig {
 	/**
-	 * Driver to bind by default. The provider only auto-wires `"memory"`
-	 * (the default) — it has no Redis connection to build a `RedisDriver`
-	 * from. For Redis, a custom driver, or a pre-built instance, wire
-	 * `QueueManager` directly in your app's startup and skip the provider;
-	 * the `services/main` singleton resolves whatever is registered.
-	 * Passing anything other than `"memory"` throws at boot.
-	 *
-	 * Default `"memory"`.
+	 * Which named adapter to use — a key of {@link adapters}. Read from the
+	 * environment in the generated config, so a deployment picks its queue
+	 * backend without editing a file.
+	 */
+	default?: string;
+	/**
+	 * The queue adapters this application can use, by name. Each is a factory
+	 * from `drivers.*`, built only when it is the one selected.
+	 */
+	adapters?: Record<string, AdapterFactory>;
+	/**
+	 * The name this key had before it matched upstream's. Read when `adapters`
+	 * is absent, so a config written against the older spelling keeps selecting
+	 * the backend it named — silently falling back to an in-process queue is the
+	 * one outcome `buildDriver` exists to prevent.
+	 */
+	stores?: Record<string, AdapterFactory>;
+	/**
+	 * The single-adapter form, kept for configs written against it: only
+	 * `"memory"` was ever accepted. Prefer `default` + `adapters`, which is how
+	 * a pluggable backend is configured everywhere else and what lets the
+	 * environment choose.
 	 */
 	driver?: "memory";
+	/**
+	 * Defaults for the worker `queue.work()` starts — upstream's `worker` block,
+	 * by the names it gives them. An argument to `work()` still wins.
+	 */
+	worker?: WorkerOptions;
+	/**
+	 * Where the application's job classes live. Default `['app/jobs']`.
+	 *
+	 * Every module under them is imported at boot and a default export that is
+	 * a job class is registered under its own name — which is what lets a
+	 * worker process resolve a record queued by an HTTP one. Without it the
+	 * registration list is a directory kept in step by hand, and the job
+	 * nobody added to it fails as "no handler registered".
+	 */
+	locations?: readonly string[];
 }
 
 /**
@@ -56,31 +99,106 @@ export interface BayProviderConfig {
  *   queue.register('send-email', new SendEmailJob())
  *   await queue.dispatch('send-email', { to: 'user@example.com' })
  */
+/**
+ * The driver the config asks for.
+ *
+ * `default` + `stores` first — the form an environment variable can steer. The
+ * `driver` key is the single-store form kept for configs written against it.
+ * Naming a store that does not exist throws rather than falling back to memory:
+ * an application that meant to queue in Redis and silently got an in-process
+ * queue would only find out when a restart dropped every pending job.
+ */
+function buildDriver(config: BayProviderConfig | undefined): QueueDriver {
+	// `adapters` first, `stores` when it is absent: the key was renamed to the
+	// one upstream reads, and a config that still says `stores` must keep
+	// selecting its backend rather than quietly landing on memory.
+	const adapters = config?.adapters ?? config?.stores;
+	const key = config?.adapters ? "adapters" : "stores";
+	const name = config?.default;
+
+	if (adapters && name !== undefined) {
+		const selected = adapters[name];
+		if (!selected) {
+			const known = Object.keys(adapters);
+			throw new Error(
+				`[bay] config.queue names the adapter '${name}', which is not in \`${key}\`. ` +
+					(known.length > 0
+						? `Declared: ${known.join(", ")}.`
+						: `\`${key}\` is empty — declare one with drivers.memory() or drivers.redis().`),
+			);
+		}
+		return selected();
+	}
+
+	if (adapters && name === undefined) {
+		throw new Error(
+			`[bay] config.queue declares \`${key}\` but no \`default\` naming which one to use. ` +
+				`Set default to one of: ${Object.keys(adapters).join(", ")}.`,
+		);
+	}
+
+	const driverName = config?.driver ?? "memory";
+	if (driverName !== "memory") {
+		throw new Error(
+			`[bay] Unsupported driver '${driverName}' — name it under \`adapters\` instead: ` +
+				"adapters: { redis: drivers.redis({ connection: 'main' }) }.",
+		);
+	}
+	return new MemoryDriver();
+}
+
 export default class BayProvider {
 	constructor(protected app: BayAppContext) {}
 
 	register(): void {
 		this.app.container.singleton(QueueManager, () => {
 			const config = this.app.config.get<BayProviderConfig>("queue");
-			const driverName = config?.driver ?? "memory";
-			if (driverName !== "memory") {
-				throw new Error(
-					`[bay] Unsupported driver '${driverName}' for default provider — ` +
-						"wire QueueManager yourself in start/queue.ts for non-memory drivers.",
-				);
-			}
-			return new QueueManager(new MemoryDriver());
+			return new QueueManager(buildDriver(config), config?.worker);
 		});
-		this.app.container.singleton("queue", () =>
-			this.app.container.resolve<QueueManager>(QueueManager),
-		);
+		// Namespaced by the package that owns it, the way upstream namespaces
+		// `lucid.db`, `auth.manager` and `drive.manager` by theirs. The bare
+		// token stays bound beside it: it is what every existing
+		// `container.make(...)` asks for, and a token is not worth breaking an
+		// application over.
+		const queue = (): Promise<QueueManager> =>
+			this.app.container.resolve<QueueManager>(QueueManager);
+		this.app.container.singleton("bay.queue", queue);
+		this.app.container.singleton("queue", queue);
 	}
 
+	/** The queue THIS provider booted — not whatever the module singleton holds. */
+	#queue: QueueManager | undefined;
+
 	async boot(): Promise<void> {
 		// Populate the `@c9up/bay/services/main` singleton so apps can
 		// `import queue from '@c9up/bay/services/main'` from anywhere.
-		setQueue(await this.app.container.resolve<QueueManager>(QueueManager));
+		this.#queue = await this.app.container.resolve<QueueManager>(QueueManager);
+		setQueue(this.#queue);
+
+		const config = this.app.config.get<BayProviderConfig>("queue");
+		const locations = config?.locations ?? [DEFAULT_JOBS_DIR];
+		// `make:job` writes where discovery reads, so the two cannot drift.
+		const first = locations[0];
+		if (first !== undefined) setJobsDir(directoryOf(first));
+		for (const job of await discoverJobs(locations)) {
+			this.#queue.registerJob(job);
+		}
 	}
 
-	async shutdown(): Promise<void> {}
+	/**
+	 * Stop the worker the app started, and let the job in flight finish.
+	 *
+	 * A worker polls on a timer. Left running, it survives a dev reload, a test
+	 * teardown and a SIGTERM — so the old process keeps pulling jobs the new
+	 * one is also pulling, and the same job runs twice.
+	 */
+	async shutdown(): Promise<void> {
+		if (!this.#queue) return;
+		await this.#queue.stop();
+		// Two applications can share a process — parallel tests, a hot reload.
+		// The module singleton holds whichever booted last, so it is only ours
+		// to clear while it still points at the queue this provider booted.
+		if (getQueue() === this.#queue) clearQueue();
+		this.#queue = undefined;
+	}
 }