@12-apps/jobs 4.3.0 → 4.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/jobs",
-  "version": "4.3.0",
+  "version": "4.4.0",
   "type": "module",
   "description": "Generic background-job library: a typed job registry with retries, exponential backoff and cron schedules, behind a swappable driver port (BullMQ/Redis in production, inline execution in tests and zero-config dev). The runtime half (./server) is one factory — createApiJobs: driver resolution, worker bootstrap, graceful drain, the single-writer sweep lease and a health endpoint — with a Hono adapter (./hono) and the package-owned SweepLease Prisma partial + migrations. Knows nothing about the host app's domain, ORM or transport.",
   "exports": {
@@ -24,8 +24,8 @@
     "bullmq": "^5.81.2"
   },
   "devDependencies": {
-    "@12-apps/eslint-config": "^1.21.0",
-    "@12-apps/typescript-config": "^1.20.0",
+    "@12-apps/eslint-config": "^1.21.1",
+    "@12-apps/typescript-config": "^1.20.1",
     "eslint": "^9.39.1",
     "eslint-plugin-test-flakiness": "^1.4.0",
     "hono": "^4.6.0",
@@ -71,6 +71,10 @@
     "!**/test-helpers.*"
   ],
   "wiring": {
+    "db": {
+      "partial": "prisma/jobs.prisma",
+      "migrations": "prisma/migrations"
+    },
     "env": [
       {
         "name": "REDIS_URL",

package/src/manifest/index.ts

@@ -1,8 +1,8 @@
 /**
  * `@12-apps/jobs/manifest` — the SHARED wiring manifest.
  *
- * A pure-data manifest: identity plus the env surface, nothing else. The
- * runtime capabilities deliberately stay UNDECLARED for now — hosts mount
+ * A pure-data manifest: identity, the env surface and the db contribution.
+ * The runtime capabilities deliberately stay UNDECLARED for now — hosts mount
  * this package directly (`createJobs`, the Hono adapter) rather than through
  * the wiring consumer, and inventorying `server` here would oblige every one
  * of them to adopt or decline it. The env declaration carries its own weight
@@ -10,6 +10,15 @@
  * `package.json` for tooling that cannot execute TypeScript, so a host's
  * `.env.example` can stop rotting by hand.
  *
+ * The db contribution is the SweepLease partial — the single-flight lease
+ * table `withSweepLease` claims its names in. It was the one capability this
+ * package shipped that no manifest said so: the partial and its migration
+ * rode the tarball while every host discovered them through a sync script's
+ * comment, which is exactly the silent-arrival the declaration (and its
+ * `package.json` mirror, readable by plain-Node assemblers) exists to end.
+ * Host-agnostic by construction: the lease names a JOB, so the model carries
+ * no relation into any host table — the `composed` mode's qualification.
+ *
  * Every key is OPTIONAL by this package's own design: absence selects the
  * inline/off driver and logs the decision — it never throws. Config always
  * wins over env (`config.x ?? process.env.Y`). `NODE_ENV` is read too, but
@@ -27,6 +36,7 @@
 export const jobsManifest = {
   name: "@12-apps/jobs",
   contract: 1,
+  db: { partial: "prisma/jobs.prisma", migrations: "prisma/migrations" },
   env: [
     { name: "REDIS_URL", description: "Set it and the queue turns itself on; unset selects the inline/off driver." },
     { name: "JOBS_DRIVER", description: "bullmq | inline | off; unset picks by REDIS_URL and NODE_ENV." },