@ultimat3/jobs 4.0.0 → 5.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/jobs",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "description": "Durable background work: steps, transactional outbox, cron tasks, one driver interface",
   "license": "MIT",
   "type": "module",
@@ -32,9 +32,9 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "4.0.0",
-    "@ultimat3/entity": "4.0.0",
-    "@ultimat3/schema": "4.0.0",
-    "@ultimat3/time": "4.0.0"
+    "@ultimat3/core": "5.0.0",
+    "@ultimat3/entity": "5.0.0",
+    "@ultimat3/schema": "5.0.0",
+    "@ultimat3/time": "5.0.0"
   }
 }

package/src/driver-nats.ts

@@ -16,10 +16,13 @@ import type {
 import { JobsNotImplementedError } from './errors';
 import type { StepRecord, StepStore } from './steps';
 
-// Names the config edit that actually removes the stub, plus the runnable command for whatever
-// is already queued. The nats driver lands in v2; there is no flag that turns this one on.
+// Names the seam that actually replaces the stub, plus the runnable command for whatever is
+// already queued. NOT `jobs: { driver }` in app.config.ts, which this line said until 2026-08-20:
+// `JobsConfig.driver` has no reader anywhere (see `driver.ts`'s header), so that edit repairs
+// nothing and the reader is sent back to the same throw. #223 removes the field.
+// The nats driver lands in v2; there is no flag that turns this one on.
 const FIX =
-  "set jobs: { driver: 'postgres' } in app.config.ts, then: x jobs drain --to memory --json";
+  'call setJobDriver(createPgDriver()) at boot instead of this driver, then move what is already queued: x jobs drain --to memory --json';
 
 const unavailable = (method: string): never => {
   throw new JobsNotImplementedError({ feature: `nats jobs driver (${method})`, fix: FIX });

package/src/driver-redis.ts

@@ -19,10 +19,13 @@ import type {
 import { JobsNotImplementedError } from './errors';
 import type { StepRecord, StepStore } from './steps';
 
-// Names the config edit that actually removes the stub, plus the runnable command for whatever
-// is already queued. The redis driver lands in v2; there is no flag that turns this one on.
+// Names the seam that actually replaces the stub, plus the runnable command for whatever is
+// already queued. NOT `jobs: { driver }` in app.config.ts, which this line said until 2026-08-20:
+// `JobsConfig.driver` has no reader anywhere (see `driver.ts`'s header), so that edit repairs
+// nothing and the reader is sent back to the same throw. #223 removes the field.
+// The redis driver lands in v2; there is no flag that turns this one on.
 const FIX =
-  "set jobs: { driver: 'postgres' } in app.config.ts, then: x jobs drain --to memory --json";
+  'call setJobDriver(createPgDriver()) at boot instead of this driver, then move what is already queued: x jobs drain --to memory --json';
 
 const unavailable = (method: string): never => {
   throw new JobsNotImplementedError({ feature: `redis jobs driver (${method})`, fix: FIX });

package/src/errors.ts

@@ -355,7 +355,7 @@ export class CancelUnsupportedError extends UltimateError {
     super({
       code: 'X_JOB_NOT_CANCELLABLE',
       cause: `the "${input.driver}" jobs driver cannot cancel a single job`,
-      fix: "set jobs: { driver: 'postgres' } in app.config.ts, then: x jobs cancel <id> --json",
+      fix: 'call setJobDriver(createPgDriver()) at boot — only the pg driver implements introspect.cancel — then: x jobs cancel <id> --json',
       docs: docsFor('X_JOB_NOT_CANCELLABLE'),
     });
   }
@@ -372,7 +372,7 @@ export class ConcurrencyUnenforceableError extends UltimateError {
     super({
       code: 'X_JOB_CONCURRENCY_UNENFORCEABLE',
       cause: `${input.jobs.join(', ')} declare concurrency and the "${input.driver}" jobs driver has no lease store, so the cap would hold per process and the fleet would run concurrency x replicas`,
-      fix: `remove concurrency from job("${input.jobs[0] ?? 'the job'}"), or set jobs: { driver: 'postgres' } in app.config.ts`,
+      fix: `remove concurrency from job("${input.jobs[0] ?? 'the job'}"), or call setJobDriver(createPgDriver()) at boot — the pg driver is the one with a lease store`,
       docs: docsFor('X_JOB_CONCURRENCY_UNENFORCEABLE'),
     });
   }

package/src/inspect.ts

@@ -91,7 +91,7 @@ function requireIntrospection(driver: JobDriver): NonNullable<JobDriver['introsp
   if (driver.introspect === undefined) {
     throw new JobsNotImplementedError({
       feature: `introspection for the "${driver.name}" jobs driver`,
-      fix: "set jobs: { driver: 'postgres' } in app.config.ts, then: x jobs ls --json",
+      fix: 'call setJobDriver(createPgDriver()) at boot — only the pg driver implements introspect — then: x jobs ls --json',
     });
   }
   return driver.introspect;

package/src/outbox.ts

@@ -338,7 +338,7 @@ export function jobsFacade(): JobsFacade {
           throw new DriverUnavailableError({
             driver: 'none',
             cause: 'no queue driver is installed in this process',
-            fix: 'call setJobDriver(createMemoryDriver()) before enqueuing — or set jobs.driver in app.config.ts and run `x dev`',
+            fix: 'call setJobDriver(createMemoryDriver()) before enqueuing, or setJobDriver(createPgDriver()) for a real queue',
           });
         }
         return installed;