@cedarjs/cli 6.0.0-canary.2930 → 6.0.0-canary.2931

package/dist/commands/dev/devHandler.js

@@ -48,7 +48,8 @@ const handler = async ({
   apiDebugPort,
   debugBrk,
   ud = false,
-  nodeArgs = ""
+  nodeArgs = "",
+  jobs: jobsOption
 }) => {
   recordTelemetryAttributes({
     command: "dev",
@@ -280,6 +281,42 @@ const handler = async ({
       prefixColor: "green"
     });
   }
+  const jobsConfigured = jobsOption !== false && workspace.includes("api") && !!cedarPaths.api.jobsConfig && // `getPaths()` resolves `jobsConfig` once and caches it in-process, so
+  // if `api/src/lib/jobs.ts` is deleted mid-session the cached path would
+  // otherwise still look "configured". Guard against starting a worker
+  // that can't load a jobs config that no longer exists.
+  fs.existsSync(cedarPaths.api.jobsConfig) && fs.existsSync(cedarPaths.api.jobs) && // Job files always live in `api/src/jobs/<ComponentName>Job/`
+  // subdirectories (see `generate/job/jobHandler.ts`), so entries here are
+  // directories, not files — only the `.keep` placeholder (and any stray
+  // dotfiles, e.g. `.DS_Store`) should be excluded.
+  fs.readdirSync(cedarPaths.api.jobs).some((entry) => !entry.startsWith("."));
+  if (jobsConfigured && unifiedDevCommand) {
+    console.log(
+      c.warning(
+        "Background jobs are not yet supported with Unified Dev (--ud). Run `cedar jobs work` in a separate terminal once you have a production-like `api/dist` build, or omit --ud for now."
+      )
+    );
+  } else if (jobsConfigured) {
+    jobs.push({
+      name: "jobs",
+      // `cedar-jobs work` loads its config and job files from `api/dist`
+      // (compiled output), not `api/src`. That dist output is only written
+      // once the `api` watcher's initial build finishes, which happens
+      // asynchronously — so on a clean `cedar dev` start there's a window
+      // where `api/dist` doesn't exist yet and the worker would exit
+      // immediately. Wrapping it in nodemon (same tool the `api` job above
+      // uses) means it retries as soon as `api/dist` changes, instead of
+      // staying dead for the rest of the session. This also means the
+      // worker restarts automatically whenever job code is rebuilt, since
+      // Node's ESM cache would otherwise keep serving stale job code.
+      command: formatRunBinCommand("nodemon", [
+        "--quiet",
+        `--watch "${cedarPaths.api.dist}"`,
+        `--exec "${formatRunBinCommand("cedar-jobs", ["work"])}"`
+      ]),
+      prefixColor: "magenta"
+    });
+  }
   const packageWorkspaces = workspace.filter(
     (w) => w !== "api" && w !== "web" && w !== "gen"
   );

package/dist/commands/dev.js

@@ -31,6 +31,9 @@ const builder = (yargs) => {
   }).option("nodeArgs", {
     type: "string",
     description: 'CLI args to pass to the node process running the web dev server, for example: `--node-args="--inspect --max-old-space-size=8192"`.'
+  }).option("jobs", {
+    type: "boolean",
+    description: "Start the background jobs worker alongside the other dev servers when jobs are configured (`cedar setup jobs` + at least one `cedar g job`). Pass `--no-jobs` to opt out and run `cedar jobs work` yourself instead."
   }).middleware(() => {
     const check = checkNodeVersion();
     if (check.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cedarjs/cli",
-  "version": "6.0.0-canary.2930",
+  "version": "6.0.0-canary.2931",
   "description": "The CedarJS Command Line",
   "repository": {
     "type": "git",
@@ -36,17 +36,17 @@
     "@babel/preset-typescript": "7.29.7",
     "@babel/traverse": "7.29.7",
     "@babel/types": "7.29.7",
-    "@cedarjs/api-server": "6.0.0-canary.2930",
-    "@cedarjs/babel-config": "6.0.0-canary.2930",
-    "@cedarjs/cli-helpers": "6.0.0-canary.2930",
-    "@cedarjs/internal": "6.0.0-canary.2930",
-    "@cedarjs/prerender": "6.0.0-canary.2930",
-    "@cedarjs/project-config": "6.0.0-canary.2930",
-    "@cedarjs/structure": "6.0.0-canary.2930",
-    "@cedarjs/telemetry": "6.0.0-canary.2930",
-    "@cedarjs/utils": "6.0.0-canary.2930",
-    "@cedarjs/vite": "6.0.0-canary.2930",
-    "@cedarjs/web-server": "6.0.0-canary.2930",
+    "@cedarjs/api-server": "6.0.0-canary.2931",
+    "@cedarjs/babel-config": "6.0.0-canary.2931",
+    "@cedarjs/cli-helpers": "6.0.0-canary.2931",
+    "@cedarjs/internal": "6.0.0-canary.2931",
+    "@cedarjs/prerender": "6.0.0-canary.2931",
+    "@cedarjs/project-config": "6.0.0-canary.2931",
+    "@cedarjs/structure": "6.0.0-canary.2931",
+    "@cedarjs/telemetry": "6.0.0-canary.2931",
+    "@cedarjs/utils": "6.0.0-canary.2931",
+    "@cedarjs/vite": "6.0.0-canary.2931",
+    "@cedarjs/web-server": "6.0.0-canary.2931",
     "@listr2/prompt-adapter-enquirer": "4.3.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/core": "1.30.1",
@@ -94,7 +94,7 @@
     "yargs": "17.7.3"
   },
   "devDependencies": {
-    "@cedarjs/framework-tools": "6.0.0-canary.2930",
+    "@cedarjs/framework-tools": "6.0.0-canary.2931",
     "@prisma/dmmf": "7.8.0",
     "@types/archiver": "^7.0.0",
     "memfs": "4.68.1",