@12-apps/jobs 4.2.0 → 4.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/jobs",
-  "version": "4.2.0",
+  "version": "4.3.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": {
@@ -9,6 +9,7 @@
     "./hono": "./src/hono/index.ts",
     "./bullmq": "./src/drivers/bullmq.ts",
     "./inline": "./src/drivers/inline.ts",
+    "./manifest": "./src/manifest/index.ts",
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -23,7 +24,7 @@
     "bullmq": "^5.81.2"
   },
   "devDependencies": {
-    "@12-apps/eslint-config": "^1.20.0",
+    "@12-apps/eslint-config": "^1.21.0",
     "@12-apps/typescript-config": "^1.20.0",
     "eslint": "^9.39.1",
     "eslint-plugin-test-flakiness": "^1.4.0",
@@ -68,5 +69,26 @@
     "!**/*.stories.*",
     "!**/*.test-story.*",
     "!**/test-helpers.*"
-  ]
+  ],
+  "wiring": {
+    "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."
+      },
+      {
+        "name": "JOBS_WORKER",
+        "scope": "worker",
+        "description": "\"1\" on the ONE process that consumes the queue and runs schedules."
+      },
+      {
+        "name": "JOBS_QUEUE_PREFIX",
+        "description": "Optional key prefix, to share one Redis across environments."
+      }
+    ]
+  }
 }

package/src/manifest/index.ts

@@ -0,0 +1,36 @@
+/**
+ * `@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
+ * 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
+ * today: the exact `process.env` keys the queue reads, mirrored into
+ * `package.json` for tooling that cannot execute TypeScript, so a host's
+ * `.env.example` can stop rotting by hand.
+ *
+ * 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
+ * it is platform vocabulary, not a contribution.
+ *
+ * This package depends on `@12-apps/wiring` in NEITHER direction — wiring
+ * already devDepends on jobs for its blueprint-compat suite, so an edge back
+ * would close a turbo build cycle. The manifest is therefore untyped pure
+ * data here, and the producer assertions (defineManifest, both mirrors, the
+ * exports tripwire) run in WIRING's own suite, which imports this subpath —
+ * the same "fails in a test run before any host sees it" guarantee, one
+ * package over, along the dependency edge that already exists.
+ */
+
+export const jobsManifest = {
+  name: "@12-apps/jobs",
+  contract: 1,
+  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." },
+    { name: "JOBS_WORKER", scope: "worker", description: "\"1\" on the ONE process that consumes the queue and runs schedules." },
+    { name: "JOBS_QUEUE_PREFIX", description: "Optional key prefix, to share one Redis across environments." },
+  ],
+} as const;