nuxt-processor 0.0.12 → 0.0.15

package/README.md

@@ -20,6 +20,14 @@ Note: This package is under very active development! Please consider creating is
 - **Scalability**: Run multiple worker processes and instances across machines.
 - **Simple DX**: Define queues/workers using first-class helpers.
 
+## Used by
+
+<div>
+  <a href="https://getminds.ai/" target="_blank" rel="noreferrer">
+    <img src="https://media.licdn.com/dms/image/v2/D4D0BAQFsL_KsNSWwow/company-logo_200_200/B4DZvtmrYRJQAI-/0/1769217898466/mindsaicompany_logo?e=1771459200&v=beta&t=FRLR2608GdLLgD9dIPqIs8wtdk-_ZAG_bWahup1kTr4" alt="Minds AI" height="72" />
+  </a>
+</div>
+
 ## Sections
 
 - [Install](#install)
@@ -33,7 +41,7 @@ Note: This package is under very active development! Please consider creating is
 ## Install
 
 ```bash
-npx nuxi@latest module add nuxt-processor
+npx nuxi@latest module add nuxt-processor@latest
 ```
 
 Add the module in `nuxt.config.ts` and set your Redis connection.
@@ -113,13 +121,22 @@ nuxi dev
 node .nuxt/dev/workers/index.mjs
 ```
 
+By default all workers run. To run only specific workers, use the `--workers=` flag with a comma-separated list of worker names:
+
+```bash
+node .nuxt/dev/workers/index.mjs --workers=basic,hello
+```
+
 ### CLI
 
-A simple CLI is provided to run workers in development.
+A simple CLI is provided to run workers in development (with file watching and restarts).
 
 ```bash
-# from your project root
+# from your project root – runs all workers
 npx nuxt-processor dev
+
+# run only specific workers
+npx nuxt-processor dev --workers=basic,hello
 ```
 
 Notes:
@@ -147,6 +164,12 @@ nuxi build
 node .output/server/workers/index.mjs
 ```
 
+To run only specific workers in production:
+
+```bash
+node .output/server/workers/index.mjs --workers=basic,hello
+```
+
 ## Bull Board
 
 [Bull Board](https://github.com/felixmosh/bull-board) is an excellent UI for watching your queues, you can follow the setup in the playground to use it.

package/dist/cli.cjs

@@ -2,28 +2,76 @@
 
 const node_child_process = require('node:child_process');
 const node_fs = require('node:fs');
-const promises = require('node:readline/promises');
-const node_process = require('node:process');
 const pathe = require('pathe');
-const consola = require('consola');
 const citty = require('citty');
 const kit = require('@nuxt/kit');
-const _package = require('./shared/nuxt-processor.XeX-J1zD.cjs');
+const logger = require('./shared/nuxt-processor.anOQG_7p.cjs');
+const promises = require('node:readline/promises');
+const node_process = require('node:process');
+require('consola');
 
 const ensureNuxtProject = async (args) => {
   const dir = pathe.resolve(args.dir);
   const nuxtConfig = await kit.loadNuxtConfig({ cwd: dir });
   if (!nuxtConfig || !nuxtConfig._layers[0]?.configFile) {
-    consola.consola.error("You are not in a Nuxt project.");
-    process.exit();
+    logger.logger.error("You are not in a Nuxt project.");
+    process.exit(1);
   }
 };
 
+const PROCESSOR_DEV_SCRIPT = "nuxt-processor dev";
+async function ensureProcessorDevScript(projectRoot, options) {
+  const pkgPath = pathe.resolve(projectRoot, "package.json");
+  if (!node_fs.existsSync(pkgPath)) {
+    return false;
+  }
+  let pkg;
+  try {
+    const pkgRaw = JSON.parse(node_fs.readFileSync(pkgPath, "utf8"));
+    pkg = pkgRaw;
+  } catch (error) {
+    logger.logger.error("Failed to parse", error);
+    return false;
+  }
+  if (pkg?.scripts?.["processor:dev"]) {
+    return true;
+  }
+  logger.logger.warn('No "processor:dev" script found in package.json.');
+  let answer;
+  {
+    const rl = promises.createInterface({ input: node_process.stdin, output: node_process.stdout });
+    try {
+      answer = await rl.question("Add script to package.json? (y/N) ");
+    } finally {
+      rl.close();
+    }
+  }
+  const isYes = typeof answer === "string" && /^y(?:es)?$/i.test(answer.trim());
+  if (!isYes) {
+    return false;
+  }
+  const updated = {
+    ...pkg,
+    scripts: {
+      ...pkg.scripts ?? {},
+      "processor:dev": PROCESSOR_DEV_SCRIPT
+    }
+  };
+  try {
+    node_fs.writeFileSync(pkgPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
+    logger.logger.success('Added "processor:dev" script to package.json');
+    return true;
+  } catch {
+    logger.logger.error("Failed to write to package.json");
+    return false;
+  }
+}
+
 const main = citty.createMain({
   meta: {
-    name: _package.name,
-    description: _package.description,
-    version: _package.version
+    name: logger.name,
+    description: logger.description,
+    version: logger.version
   },
   subCommands: {
     dev: citty.defineCommand({
@@ -39,6 +87,10 @@ const main = citty.createMain({
         nodeArgs: {
           type: "string",
           description: "Extra Node args (e.g. --inspect)"
+        },
+        workers: {
+          type: "string",
+          description: "Workers to run, comma-separated; use --workers=name1,name2 (default: all)"
         }
       },
       async run({ args }) {
@@ -47,88 +99,31 @@ const main = citty.createMain({
         const projectRoot = pathe.resolve(dirArg);
         const indexFile = pathe.resolve(projectRoot, ".nuxt/dev/workers/index.mjs");
         const watchDir = pathe.resolve(projectRoot, ".nuxt/dev/workers");
-        if (node_fs.existsSync(indexFile)) {
-          const pkgPath = pathe.resolve(projectRoot, "package.json");
-          if (node_fs.existsSync(pkgPath)) {
-            try {
-              const pkgRaw = JSON.parse(node_fs.readFileSync(pkgPath, "utf8"));
-              const pkg = pkgRaw;
-              const hasProcessorDev = Boolean(pkg && pkg.scripts && pkg.scripts["processor:dev"]);
-              if (!hasProcessorDev) {
-                consola.consola.warn('No "processor:dev" script found in package.json.');
-                const rl = promises.createInterface({ input: node_process.stdin, output: node_process.stdout });
-                const answer = await rl.question("Add script to package.json? (y/N) ");
-                rl.close();
-                const isYes = typeof answer === "string" && /^y(?:es)?$/i.test(answer.trim());
-                if (isYes) {
-                  const updated = {
-                    ...pkg,
-                    scripts: {
-                      ...pkg.scripts ?? {},
-                      "processor:dev": "nuxt-processor dev"
-                    }
-                  };
-                  try {
-                    node_fs.writeFileSync(pkgPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
-                    consola.consola.success('Added "processor:dev" script to package.json');
-                  } catch {
-                    consola.consola.error("Failed to write to package.json");
-                  }
-                }
-              }
-            } catch {
-            }
-          }
-        }
+        const scriptEnsured = await ensureProcessorDevScript(projectRoot);
         if (!node_fs.existsSync(indexFile)) {
-          const pkgPath = pathe.resolve(projectRoot, "package.json");
-          let hasProcessorDev = false;
-          if (node_fs.existsSync(pkgPath)) {
-            try {
-              const pkgRaw = JSON.parse(node_fs.readFileSync(pkgPath, "utf8"));
-              const pkg = pkgRaw;
-              hasProcessorDev = Boolean(pkg && pkg.scripts && pkg.scripts["processor:dev"]);
-              if (!hasProcessorDev) {
-                consola.consola.warn('No "processor:dev" script found in package.json.');
-                const rl = promises.createInterface({ input: node_process.stdin, output: node_process.stdout });
-                const answer = await rl.question("Add script to package.json? (y/N) ");
-                rl.close();
-                const isYes = typeof answer === "string" && /^y(?:es)?$/i.test(answer.trim());
-                if (isYes) {
-                  const updated = {
-                    ...pkg,
-                    scripts: {
-                      ...pkg.scripts || {},
-                      "processor:dev": "nuxt-processor dev"
-                    }
-                  };
-                  try {
-                    node_fs.writeFileSync(pkgPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
-                    consola.consola.success('Added "processor:dev" script to package.json');
-                  } catch {
-                    consola.consola.error("Failed to write to package.json");
-                  }
-                }
-              }
-            } catch {
-            }
-          }
-          consola.consola.error("No entry file found at .nuxt/dev/workers/index.mjs");
-          consola.consola.info("Please start your Nuxt dev server (e.g. `npm run dev`).");
-          consola.consola.info("After it starts, run `npx nuxt-processor dev` again to start the processor.");
+          logger.logger.error("No entry file found at .nuxt/dev/workers/index.mjs");
+          logger.logger.info("Please start your Nuxt dev server (e.g. `npm run dev`).");
+          logger.logger.info("After it starts, run `npx nuxt-processor dev` again to start the processor.");
+          process.exit(1);
+        }
+        if (!scriptEnsured) {
+          logger.logger.error("Could not ensure processor:dev script in package.json.");
           process.exit(1);
         }
         const nodeBin = process.execPath;
         const nodeArgsInput = Array.isArray(args.nodeArgs) ? args.nodeArgs : typeof args.nodeArgs === "string" ? args.nodeArgs.split(" ") : [];
         const extraArgs = nodeArgsInput.filter(Boolean);
+        const workersValue = typeof args.workers === "string" ? args.workers.trim() : "";
+        const workersFlag = workersValue ? `--workers=${workersValue}` : null;
         const nodeArgs = [
           ...extraArgs,
           "--watch",
           "--watch-path",
           watchDir,
-          indexFile
+          indexFile,
+          ...workersFlag ? [workersFlag] : []
         ];
-        consola.consola.info(`Running watcher for processor`);
+        logger.logger.info(`Running watcher for processor`);
         const child = node_child_process.spawn(nodeBin, nodeArgs, {
           stdio: "inherit",
           cwd: projectRoot,

package/dist/cli.mjs

@@ -1,22 +1,70 @@
 import { spawn } from 'node:child_process';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { createInterface } from 'node:readline/promises';
-import { stdout, stdin } from 'node:process';
 import { resolve } from 'pathe';
-import { consola } from 'consola';
 import { createMain, defineCommand } from 'citty';
 import { loadNuxtConfig } from '@nuxt/kit';
-import { v as version, d as description, n as name } from './shared/nuxt-processor.Bp92mFhC.mjs';
+import { l as logger, v as version, d as description, n as name } from './shared/nuxt-processor.Ff27cxgy.mjs';
+import { createInterface } from 'node:readline/promises';
+import { stdout, stdin } from 'node:process';
+import 'consola';
 
 const ensureNuxtProject = async (args) => {
   const dir = resolve(args.dir);
   const nuxtConfig = await loadNuxtConfig({ cwd: dir });
   if (!nuxtConfig || !nuxtConfig._layers[0]?.configFile) {
-    consola.error("You are not in a Nuxt project.");
-    process.exit();
+    logger.error("You are not in a Nuxt project.");
+    process.exit(1);
   }
 };
 
+const PROCESSOR_DEV_SCRIPT = "nuxt-processor dev";
+async function ensureProcessorDevScript(projectRoot, options) {
+  const pkgPath = resolve(projectRoot, "package.json");
+  if (!existsSync(pkgPath)) {
+    return false;
+  }
+  let pkg;
+  try {
+    const pkgRaw = JSON.parse(readFileSync(pkgPath, "utf8"));
+    pkg = pkgRaw;
+  } catch (error) {
+    logger.error("Failed to parse", error);
+    return false;
+  }
+  if (pkg?.scripts?.["processor:dev"]) {
+    return true;
+  }
+  logger.warn('No "processor:dev" script found in package.json.');
+  let answer;
+  {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+      answer = await rl.question("Add script to package.json? (y/N) ");
+    } finally {
+      rl.close();
+    }
+  }
+  const isYes = typeof answer === "string" && /^y(?:es)?$/i.test(answer.trim());
+  if (!isYes) {
+    return false;
+  }
+  const updated = {
+    ...pkg,
+    scripts: {
+      ...pkg.scripts ?? {},
+      "processor:dev": PROCESSOR_DEV_SCRIPT
+    }
+  };
+  try {
+    writeFileSync(pkgPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
+    logger.success('Added "processor:dev" script to package.json');
+    return true;
+  } catch {
+    logger.error("Failed to write to package.json");
+    return false;
+  }
+}
+
 const main = createMain({
   meta: {
     name,
@@ -37,6 +85,10 @@ const main = createMain({
         nodeArgs: {
           type: "string",
           description: "Extra Node args (e.g. --inspect)"
+        },
+        workers: {
+          type: "string",
+          description: "Workers to run, comma-separated; use --workers=name1,name2 (default: all)"
         }
       },
       async run({ args }) {
@@ -45,88 +97,31 @@ const main = createMain({
         const projectRoot = resolve(dirArg);
         const indexFile = resolve(projectRoot, ".nuxt/dev/workers/index.mjs");
         const watchDir = resolve(projectRoot, ".nuxt/dev/workers");
-        if (existsSync(indexFile)) {
-          const pkgPath = resolve(projectRoot, "package.json");
-          if (existsSync(pkgPath)) {
-            try {
-              const pkgRaw = JSON.parse(readFileSync(pkgPath, "utf8"));
-              const pkg = pkgRaw;
-              const hasProcessorDev = Boolean(pkg && pkg.scripts && pkg.scripts["processor:dev"]);
-              if (!hasProcessorDev) {
-                consola.warn('No "processor:dev" script found in package.json.');
-                const rl = createInterface({ input: stdin, output: stdout });
-                const answer = await rl.question("Add script to package.json? (y/N) ");
-                rl.close();
-                const isYes = typeof answer === "string" && /^y(?:es)?$/i.test(answer.trim());
-                if (isYes) {
-                  const updated = {
-                    ...pkg,
-                    scripts: {
-                      ...pkg.scripts ?? {},
-                      "processor:dev": "nuxt-processor dev"
-                    }
-                  };
-                  try {
-                    writeFileSync(pkgPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
-                    consola.success('Added "processor:dev" script to package.json');
-                  } catch {
-                    consola.error("Failed to write to package.json");
-                  }
-                }
-              }
-            } catch {
-            }
-          }
-        }
+        const scriptEnsured = await ensureProcessorDevScript(projectRoot);
         if (!existsSync(indexFile)) {
-          const pkgPath = resolve(projectRoot, "package.json");
-          let hasProcessorDev = false;
-          if (existsSync(pkgPath)) {
-            try {
-              const pkgRaw = JSON.parse(readFileSync(pkgPath, "utf8"));
-              const pkg = pkgRaw;
-              hasProcessorDev = Boolean(pkg && pkg.scripts && pkg.scripts["processor:dev"]);
-              if (!hasProcessorDev) {
-                consola.warn('No "processor:dev" script found in package.json.');
-                const rl = createInterface({ input: stdin, output: stdout });
-                const answer = await rl.question("Add script to package.json? (y/N) ");
-                rl.close();
-                const isYes = typeof answer === "string" && /^y(?:es)?$/i.test(answer.trim());
-                if (isYes) {
-                  const updated = {
-                    ...pkg,
-                    scripts: {
-                      ...pkg.scripts || {},
-                      "processor:dev": "nuxt-processor dev"
-                    }
-                  };
-                  try {
-                    writeFileSync(pkgPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
-                    consola.success('Added "processor:dev" script to package.json');
-                  } catch {
-                    consola.error("Failed to write to package.json");
-                  }
-                }
-              }
-            } catch {
-            }
-          }
-          consola.error("No entry file found at .nuxt/dev/workers/index.mjs");
-          consola.info("Please start your Nuxt dev server (e.g. `npm run dev`).");
-          consola.info("After it starts, run `npx nuxt-processor dev` again to start the processor.");
+          logger.error("No entry file found at .nuxt/dev/workers/index.mjs");
+          logger.info("Please start your Nuxt dev server (e.g. `npm run dev`).");
+          logger.info("After it starts, run `npx nuxt-processor dev` again to start the processor.");
+          process.exit(1);
+        }
+        if (!scriptEnsured) {
+          logger.error("Could not ensure processor:dev script in package.json.");
           process.exit(1);
         }
         const nodeBin = process.execPath;
         const nodeArgsInput = Array.isArray(args.nodeArgs) ? args.nodeArgs : typeof args.nodeArgs === "string" ? args.nodeArgs.split(" ") : [];
         const extraArgs = nodeArgsInput.filter(Boolean);
+        const workersValue = typeof args.workers === "string" ? args.workers.trim() : "";
+        const workersFlag = workersValue ? `--workers=${workersValue}` : null;
         const nodeArgs = [
           ...extraArgs,
           "--watch",
           "--watch-path",
           watchDir,
-          indexFile
+          indexFile,
+          ...workersFlag ? [workersFlag] : []
         ];
-        consola.info(`Running watcher for processor`);
+        logger.info(`Running watcher for processor`);
         const child = spawn(nodeBin, nodeArgs, {
           stdio: "inherit",
           cwd: projectRoot,

package/dist/module.cjs

@@ -1,9 +1,10 @@
 'use strict';
 
 const kit = require('@nuxt/kit');
-const _package = require('./shared/nuxt-processor.XeX-J1zD.cjs');
+const logger = require('./shared/nuxt-processor.anOQG_7p.cjs');
 const node_path = require('node:path');
 const fg = require('fast-glob');
+require('consola');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
@@ -21,15 +22,126 @@ const scanFolder = async (path) => {
     onlyFiles: true
   });
   files.push(...new Set(updatedFiles));
+  if (files.length === 0) {
+    logger.logger.warn("No worker files found in project");
+  }
   return files;
 };
 
+function generateWorkersEntryContent(workerFiles, redisInline) {
+  const toImportArray = workerFiles.map((id) => `() => import(${JSON.stringify(id)})`).join(",\n    ");
+  return `
+import { fileURLToPath } from 'node:url'
+import { resolve as resolvePath } from 'node:path'
+import { consola } from 'consola'
+import { $workers } from '#processor-utils'
+
+// Initialize connection as early as possible so any imports that register
+// workers/queues have a valid connection available.
+const api = $workers()
+api.setConnection(${redisInline})
+
+export async function createWorkersApp() {
+// Avoid EPIPE when stdout/stderr are closed by terminal (e.g., Ctrl+C piping)
+const handleStreamError = (err) => {
+try {
+  const code = (typeof err === 'object' && err && 'code' in err) ? err.code : null
+  if (code === 'EPIPE') return
+} catch (e) { console.warn?.('nuxt-processor: stream error inspection failed', e) }
+throw err
+}
+try { process.stdout?.on?.('error', handleStreamError) } catch (err) { console.warn('nuxt-processor: failed to attach stdout error handler', err) }
+try { process.stderr?.on?.('error', handleStreamError) } catch (err) { console.warn('nuxt-processor: failed to attach stderr error handler', err) }
+const modules = [
+${toImportArray}
+]
+for (const loader of modules) {
+await loader()
+}
+// Parse --workers flag (e.g. --workers=basic,hello)
+const workersArg = process.argv.find(a => typeof a === 'string' && a.startsWith('--workers='))
+const selectedWorkers = workersArg
+  ? workersArg.split('=')[1].split(',').map(s => s.trim()).filter(Boolean)
+  : null
+const workersToRun = selectedWorkers
+  ? (Array.isArray(api.workers) ? api.workers.filter(w => w && selectedWorkers.includes(w.name)) : [])
+  : (Array.isArray(api.workers) ? api.workers : [])
+const logger = consola.create({}).withTag('nuxt-processor')
+if (selectedWorkers && workersToRun.length === 0) {
+  const available = (Array.isArray(api.workers) ? api.workers.map(w => w && w.name).filter(Boolean) : [])
+  logger.warn('No workers matched --workers=' + selectedWorkers.join(',') + (available.length ? '. Available: ' + available.join(', ') : '.'))
+  process.exit(1)
+}
+try {
+const workerNames = workersToRun.map(w => w && w.name).filter(Boolean)
+logger.info('starting workers:\\n' + workerNames.map(n => ' - ' + n).join('\\n'))
+for (const w of workersToRun) {
+  w.on('error', (err) => logger.error('worker error', err))
+}
+// Explicitly start workers since autorun is disabled
+for (const w of workersToRun) {
+  try {
+    // run() returns a promise that resolves when the worker stops; do not await to avoid blocking
+    // eslint-disable-next-line promise/catch-or-return
+    w.run().catch((err) => logger.error('worker run error', err))
+  }
+  catch (err) {
+    logger.error('failed to start worker', err)
+  }
+}
+logger.success('workers started')
+} catch (err) {
+logger.error('failed to initialize workers', err)
+}
+const closeRunningWorkers = async () => {
+  await Promise.allSettled(workersToRun.map(w => w.close()))
+}
+return { stop: closeRunningWorkers, workers: workersToRun }
+}
+
+const isMain = (() => {
+try {
+if (typeof process === 'undefined' || !process.argv || !process.argv[1]) return false
+const argvPath = resolvePath(process.cwd?.() || '.', process.argv[1])
+const filePath = fileURLToPath(import.meta.url)
+return filePath === argvPath
+} catch {
+return false
+}
+})()
+if (isMain) {
+const logger = consola.create({}).withTag('nuxt-processor')
+const appPromise = createWorkersApp().catch((err) => {
+logger.error('failed to start workers', err)
+process.exit(1)
+})
+const shutdown = async () => {
+try { logger.info('closing workers...') } catch (err) { console.warn('nuxt-processor: failed to log shutdown start', err) }
+try {
+  const app = await appPromise
+  try {
+    const names = (app?.workers || []).map(w => w && w.name).filter(Boolean)
+    logger.info('closing workers:\\n' + names.map(n => ' - ' + n).join('\\n'))
+  } catch (eL) { console.warn('nuxt-processor: failed to log workers list on shutdown', eL) }
+  await app.stop()
+  try { logger.success('workers closed') } catch (err2) { console.warn('nuxt-processor: failed to log shutdown complete', err2) }
+}
+finally { process.exit(0) }
+}
+;['SIGINT','SIGTERM','SIGQUIT'].forEach(sig => process.on(sig, shutdown))
+process.on('beforeExit', shutdown)
+}
+
+export default { createWorkersApp }
+`;
+}
+
 const module$1 = kit.defineNuxtModule({
   meta: {
-    name: _package.name,
-    version: _package.version,
-    compatibility: _package.compatibility,
-    configKey: _package.configKey
+    name: logger.name,
+    version: logger.version,
+    compatibility: logger.compatibility,
+    configKey: logger.configKey
   },
   // Default configuration options of the Nuxt module
   defaults: {
@@ -64,97 +176,6 @@ const module$1 = kit.defineNuxtModule({
       getContents: () => nitroPlugin
     });
     kit.addServerPlugin(tpl.dst);
-    function generateWorkersEntryContent(workerFiles) {
-      const toImportArray = workerFiles.map((id) => `() => import(${JSON.stringify(id)})`).join(",\n    ");
-      return `
-import { fileURLToPath } from 'node:url'
-import { resolve as resolvePath } from 'node:path'
-import { consola } from 'consola'
-import { $workers } from '#processor-utils'
-
-// Initialize connection as early as possible so any imports that register
-// workers/queues have a valid connection available.
-const api = $workers()
-api.setConnection(${redisInline})
-
-export async function createWorkersApp() {
-  // Avoid EPIPE when stdout/stderr are closed by terminal (e.g., Ctrl+C piping)
-  const handleStreamError = (err) => {
-    try {
-      const code = (typeof err === 'object' && err && 'code' in err) ? err.code : null
-      if (code === 'EPIPE') return
-    } catch (e) { console.warn?.('nuxt-processor: stream error inspection failed', e) }
-    throw err
-  }
-  try { process.stdout?.on?.('error', handleStreamError) } catch (err) { console.warn('nuxt-processor: failed to attach stdout error handler', err) }
-  try { process.stderr?.on?.('error', handleStreamError) } catch (err) { console.warn('nuxt-processor: failed to attach stderr error handler', err) }
-  const modules = [
-    ${toImportArray}
-  ]
-  for (const loader of modules) {
-    await loader()
-  }
-  const logger = consola.create({}).withTag('nuxt-processor')
-  try {
-    const workerNames = Array.isArray(api.workers) ? api.workers.map(w => w && w.name).filter(Boolean) : []
-    logger.info('starting workers:\\n' + workerNames.map(n => ' - ' + n).join('\\n'))
-    for (const w of api.workers) {
-      w.on('error', (err) => logger.error('worker error', err))
-    }
-    // Explicitly start workers since autorun is disabled
-    for (const w of api.workers) {
-      try {
-        // run() returns a promise that resolves when the worker stops; do not await to avoid blocking
-        // eslint-disable-next-line promise/catch-or-return
-        w.run().catch((err) => logger.error('worker run error', err))
-      }
-      catch (err) {
-        logger.error('failed to start worker', err)
-      }
-    }
-    logger.success('workers started')
-  } catch (err) {
-    logger.error('failed to initialize workers', err)
-  }
-  return { stop: api.stopAll, workers: api.workers }
-}
-
-const isMain = (() => {
-  try {
-    if (typeof process === 'undefined' || !process.argv || !process.argv[1]) return false
-    const argvPath = resolvePath(process.cwd?.() || '.', process.argv[1])
-    const filePath = fileURLToPath(import.meta.url)
-    return filePath === argvPath
-  } catch {
-    return false
-  }
-})()
-if (isMain) {
-  const logger = consola.create({}).withTag('nuxt-processor')
-  const appPromise = createWorkersApp().catch((err) => {
-    logger.error('failed to start workers', err)
-    process.exit(1)
-  })
-  const shutdown = async () => {
-    try { logger.info('closing workers...') } catch (err) { console.warn('nuxt-processor: failed to log shutdown start', err) }
-    try {
-      const app = await appPromise
-      try {
-        const names = (app?.workers || []).map(w => w && w.name).filter(Boolean)
-        logger.info('closing workers:\\n' + names.map(n => ' - ' + n).join('\\n'))
-      } catch (eL) { console.warn('nuxt-processor: failed to log workers list on shutdown', eL) }
-      await app.stop()
-      try { logger.success('workers closed') } catch (err2) { console.warn('nuxt-processor: failed to log shutdown complete', err2) }
-    }
-    finally { process.exit(0) }
-  }
-  ;['SIGINT','SIGTERM','SIGQUIT'].forEach(sig => process.on(sig, shutdown))
-  process.on('beforeExit', shutdown)
-}
-
-export default { createWorkersApp }
-`;
-    }
     nuxt.options.alias = nuxt.options.alias ?? {};
     nuxt.options.alias["nuxt-processor"] = resolve("./runtime/server/handlers");
     nuxt.options.alias["#processor"] = resolve("./runtime/server/handlers");
@@ -196,7 +217,7 @@ declare module '#bullmq' {
             virtualCode = "";
             return;
           }
-          virtualCode = generateWorkersEntryContent(workerFiles);
+          virtualCode = generateWorkersEntryContent(workerFiles, redisInline);
           for (const id of workerFiles) {
             this.addWatchFile(id);
           }

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-processor",
-  "version": "0.0.12",
+  "version": "0.0.15",
   "compatibility": {
     "nuxt": "^4.0.0 || ^3.0.0"
   },

package/dist/module.mjs

@@ -1,7 +1,8 @@
 import { useNuxt, createResolver, defineNuxtModule, addTemplate, addServerPlugin, addTypeTemplate } from '@nuxt/kit';
-import { c as configKey, a as compatibility, v as version, n as name } from './shared/nuxt-processor.Bp92mFhC.mjs';
+import { l as logger, c as configKey, a as compatibility, v as version, n as name } from './shared/nuxt-processor.Ff27cxgy.mjs';
 import { relative } from 'node:path';
 import fg from 'fast-glob';
+import 'consola';
 
 const scanFolder = async (path) => {
   const nuxt = useNuxt();
@@ -14,10 +15,121 @@ const scanFolder = async (path) => {
     onlyFiles: true
   });
   files.push(...new Set(updatedFiles));
+  if (files.length === 0) {
+    logger.warn("No worker files found in project");
+  }
   return files;
 };
 
-const module = defineNuxtModule({
+function generateWorkersEntryContent(workerFiles, redisInline) {
+  const toImportArray = workerFiles.map((id) => `() => import(${JSON.stringify(id)})`).join(",\n    ");
+  return `
+import { fileURLToPath } from 'node:url'
+import { resolve as resolvePath } from 'node:path'
+import { consola } from 'consola'
+import { $workers } from '#processor-utils'
+
+// Initialize connection as early as possible so any imports that register
+// workers/queues have a valid connection available.
+const api = $workers()
+api.setConnection(${redisInline})
+
+export async function createWorkersApp() {
+// Avoid EPIPE when stdout/stderr are closed by terminal (e.g., Ctrl+C piping)
+const handleStreamError = (err) => {
+try {
+  const code = (typeof err === 'object' && err && 'code' in err) ? err.code : null
+  if (code === 'EPIPE') return
+} catch (e) { console.warn?.('nuxt-processor: stream error inspection failed', e) }
+throw err
+}
+try { process.stdout?.on?.('error', handleStreamError) } catch (err) { console.warn('nuxt-processor: failed to attach stdout error handler', err) }
+try { process.stderr?.on?.('error', handleStreamError) } catch (err) { console.warn('nuxt-processor: failed to attach stderr error handler', err) }
+const modules = [
+${toImportArray}
+]
+for (const loader of modules) {
+await loader()
+}
+// Parse --workers flag (e.g. --workers=basic,hello)
+const workersArg = process.argv.find(a => typeof a === 'string' && a.startsWith('--workers='))
+const selectedWorkers = workersArg
+  ? workersArg.split('=')[1].split(',').map(s => s.trim()).filter(Boolean)
+  : null
+const workersToRun = selectedWorkers
+  ? (Array.isArray(api.workers) ? api.workers.filter(w => w && selectedWorkers.includes(w.name)) : [])
+  : (Array.isArray(api.workers) ? api.workers : [])
+const logger = consola.create({}).withTag('nuxt-processor')
+if (selectedWorkers && workersToRun.length === 0) {
+  const available = (Array.isArray(api.workers) ? api.workers.map(w => w && w.name).filter(Boolean) : [])
+  logger.warn('No workers matched --workers=' + selectedWorkers.join(',') + (available.length ? '. Available: ' + available.join(', ') : '.'))
+  process.exit(1)
+}
+try {
+const workerNames = workersToRun.map(w => w && w.name).filter(Boolean)
+logger.info('starting workers:\\n' + workerNames.map(n => ' - ' + n).join('\\n'))
+for (const w of workersToRun) {
+  w.on('error', (err) => logger.error('worker error', err))
+}
+// Explicitly start workers since autorun is disabled
+for (const w of workersToRun) {
+  try {
+    // run() returns a promise that resolves when the worker stops; do not await to avoid blocking
+    // eslint-disable-next-line promise/catch-or-return
+    w.run().catch((err) => logger.error('worker run error', err))
+  }
+  catch (err) {
+    logger.error('failed to start worker', err)
+  }
+}
+logger.success('workers started')
+} catch (err) {
+logger.error('failed to initialize workers', err)
+}
+const closeRunningWorkers = async () => {
+  await Promise.allSettled(workersToRun.map(w => w.close()))
+}
+return { stop: closeRunningWorkers, workers: workersToRun }
+}
+
+const isMain = (() => {
+try {
+if (typeof process === 'undefined' || !process.argv || !process.argv[1]) return false
+const argvPath = resolvePath(process.cwd?.() || '.', process.argv[1])
+const filePath = fileURLToPath(import.meta.url)
+return filePath === argvPath
+} catch {
+return false
+}
+})()
+if (isMain) {
+const logger = consola.create({}).withTag('nuxt-processor')
+const appPromise = createWorkersApp().catch((err) => {
+logger.error('failed to start workers', err)
+process.exit(1)
+})
+const shutdown = async () => {
+try { logger.info('closing workers...') } catch (err) { console.warn('nuxt-processor: failed to log shutdown start', err) }
+try {
+  const app = await appPromise
+  try {
+    const names = (app?.workers || []).map(w => w && w.name).filter(Boolean)
+    logger.info('closing workers:\\n' + names.map(n => ' - ' + n).join('\\n'))
+  } catch (eL) { console.warn('nuxt-processor: failed to log workers list on shutdown', eL) }
+  await app.stop()
+  try { logger.success('workers closed') } catch (err2) { console.warn('nuxt-processor: failed to log shutdown complete', err2) }
+}
+finally { process.exit(0) }
+}
+;['SIGINT','SIGTERM','SIGQUIT'].forEach(sig => process.on(sig, shutdown))
+process.on('beforeExit', shutdown)
+}
+
+export default { createWorkersApp }
+`;
+}
+
+const module$1 = defineNuxtModule({
   meta: {
     name,
     version,
@@ -57,97 +169,6 @@ const module = defineNuxtModule({
       getContents: () => nitroPlugin
     });
     addServerPlugin(tpl.dst);
-    function generateWorkersEntryContent(workerFiles) {
-      const toImportArray = workerFiles.map((id) => `() => import(${JSON.stringify(id)})`).join(",\n    ");
-      return `
-import { fileURLToPath } from 'node:url'
-import { resolve as resolvePath } from 'node:path'
-import { consola } from 'consola'
-import { $workers } from '#processor-utils'
-
-// Initialize connection as early as possible so any imports that register
-// workers/queues have a valid connection available.
-const api = $workers()
-api.setConnection(${redisInline})
-
-export async function createWorkersApp() {
-  // Avoid EPIPE when stdout/stderr are closed by terminal (e.g., Ctrl+C piping)
-  const handleStreamError = (err) => {
-    try {
-      const code = (typeof err === 'object' && err && 'code' in err) ? err.code : null
-      if (code === 'EPIPE') return
-    } catch (e) { console.warn?.('nuxt-processor: stream error inspection failed', e) }
-    throw err
-  }
-  try { process.stdout?.on?.('error', handleStreamError) } catch (err) { console.warn('nuxt-processor: failed to attach stdout error handler', err) }
-  try { process.stderr?.on?.('error', handleStreamError) } catch (err) { console.warn('nuxt-processor: failed to attach stderr error handler', err) }
-  const modules = [
-    ${toImportArray}
-  ]
-  for (const loader of modules) {
-    await loader()
-  }
-  const logger = consola.create({}).withTag('nuxt-processor')
-  try {
-    const workerNames = Array.isArray(api.workers) ? api.workers.map(w => w && w.name).filter(Boolean) : []
-    logger.info('starting workers:\\n' + workerNames.map(n => ' - ' + n).join('\\n'))
-    for (const w of api.workers) {
-      w.on('error', (err) => logger.error('worker error', err))
-    }
-    // Explicitly start workers since autorun is disabled
-    for (const w of api.workers) {
-      try {
-        // run() returns a promise that resolves when the worker stops; do not await to avoid blocking
-        // eslint-disable-next-line promise/catch-or-return
-        w.run().catch((err) => logger.error('worker run error', err))
-      }
-      catch (err) {
-        logger.error('failed to start worker', err)
-      }
-    }
-    logger.success('workers started')
-  } catch (err) {
-    logger.error('failed to initialize workers', err)
-  }
-  return { stop: api.stopAll, workers: api.workers }
-}
-
-const isMain = (() => {
-  try {
-    if (typeof process === 'undefined' || !process.argv || !process.argv[1]) return false
-    const argvPath = resolvePath(process.cwd?.() || '.', process.argv[1])
-    const filePath = fileURLToPath(import.meta.url)
-    return filePath === argvPath
-  } catch {
-    return false
-  }
-})()
-if (isMain) {
-  const logger = consola.create({}).withTag('nuxt-processor')
-  const appPromise = createWorkersApp().catch((err) => {
-    logger.error('failed to start workers', err)
-    process.exit(1)
-  })
-  const shutdown = async () => {
-    try { logger.info('closing workers...') } catch (err) { console.warn('nuxt-processor: failed to log shutdown start', err) }
-    try {
-      const app = await appPromise
-      try {
-        const names = (app?.workers || []).map(w => w && w.name).filter(Boolean)
-        logger.info('closing workers:\\n' + names.map(n => ' - ' + n).join('\\n'))
-      } catch (eL) { console.warn('nuxt-processor: failed to log workers list on shutdown', eL) }
-      await app.stop()
-      try { logger.success('workers closed') } catch (err2) { console.warn('nuxt-processor: failed to log shutdown complete', err2) }
-    }
-    finally { process.exit(0) }
-  }
-  ;['SIGINT','SIGTERM','SIGQUIT'].forEach(sig => process.on(sig, shutdown))
-  process.on('beforeExit', shutdown)
-}
-
-export default { createWorkersApp }
-`;
-    }
     nuxt.options.alias = nuxt.options.alias ?? {};
     nuxt.options.alias["nuxt-processor"] = resolve("./runtime/server/handlers");
     nuxt.options.alias["#processor"] = resolve("./runtime/server/handlers");
@@ -189,7 +210,7 @@ declare module '#bullmq' {
             virtualCode = "";
             return;
           }
-          virtualCode = generateWorkersEntryContent(workerFiles);
+          virtualCode = generateWorkersEntryContent(workerFiles, redisInline);
           for (const id of workerFiles) {
             this.addWatchFile(id);
           }
@@ -234,4 +255,4 @@ process.on('beforeExit', () => shutdown('beforeExit'))
   }
 });
 
-export { module as default };
+export { module$1 as default };

package/dist/runtime/server/utils/workers.d.ts

@@ -9,7 +9,7 @@ export declare function $workers(): {
         path: string;
     }> & {
         disconnectTimeout?: number;
-        tls?: import("tls").ConnectionOptions;
+        tls?: import("node:tls").ConnectionOptions;
     } & {
         url?: string;
     })) => void;

package/dist/shared/nuxt-processor.Ff27cxgy.mjs

@@ -0,0 +1,13 @@
+import { createConsola } from 'consola';
+
+const name = "nuxt-processor";
+const version = "0.0.15";
+const description = "Nuxt Processor";
+const configKey = "processor";
+const compatibility = {
+	nuxt: "^4.0.0 || ^3.0.0"
+};
+
+const logger = createConsola({}).withTag(name);
+
+export { compatibility as a, configKey as c, description as d, logger as l, name as n, version as v };

package/dist/shared/{nuxt-processor.XeX-J1zD.cjs → nuxt-processor.anOQG_7p.cjs}

@@ -1,15 +1,20 @@
 'use strict';
 
+const consola = require('consola');
+
 const name = "nuxt-processor";
-const version = "0.0.12";
+const version = "0.0.15";
 const description = "Nuxt Processor";
 const configKey = "processor";
 const compatibility = {
 	nuxt: "^4.0.0 || ^3.0.0"
 };
 
+const logger = consola.createConsola({}).withTag(name);
+
 exports.compatibility = compatibility;
 exports.configKey = configKey;
 exports.description = description;
+exports.logger = logger;
 exports.name = name;
 exports.version = version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-processor",
-  "version": "0.0.12",
+  "version": "0.0.15",
   "description": "Nuxt Processor",
   "repository": "https://github.com/aidanhibbard/nuxt-processor",
   "license": "MIT",
@@ -35,9 +35,9 @@
     "dev": "npm run dev:prepare && nuxi dev playground",
     "dev:build": "nuxi build playground",
     "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare playground",
-    "ci:dev:build": "npm run dev:prepare && cd playground && npm i && cd ../ && npm run dev:build",
     "release": "npm run lint && npm run prepack && changelogen --release && npm publish && git push --follow-tags",
     "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest watch",
@@ -47,13 +47,13 @@
     "vp:preview": "vitepress preview docs"
   },
   "dependencies": {
-    "@nuxt/kit": "^4.0.3",
-    "bullmq": "^5.58.2",
-    "citty": "^0.1.6",
-    "consola": "^3.2.3",
+    "@nuxt/kit": "^4.3.0",
+    "bullmq": "^5.67.2",
+    "citty": "^0.2.0",
+    "consola": "^3.4.2",
     "fast-glob": "^3.3.3",
-    "ioredis": "^5.7.0",
-    "pathe": "^1.1.2"
+    "ioredis": "^5.9.2",
+    "pathe": "^2.0.3"
   },
   "devDependencies": {
     "@nuxt/devtools": "^2.6.3",
@@ -66,7 +66,7 @@
     "@vitest/coverage-v8": "^3.2.4",
     "changelogen": "^0.6.2",
     "eslint": "^9.34.0",
-    "happy-dom": "^18.0.1",
+    "happy-dom": "^20.0.11",
     "nuxt": "^4.0.3",
     "typescript": "~5.9.2",
     "vitepress": "^2.0.0-alpha.12",

package/dist/shared/nuxt-processor.Bp92mFhC.mjs

@@ -1,9 +0,0 @@
-const name = "nuxt-processor";
-const version = "0.0.12";
-const description = "Nuxt Processor";
-const configKey = "processor";
-const compatibility = {
-	nuxt: "^4.0.0 || ^3.0.0"
-};
-
-export { compatibility as a, configKey as c, description as d, name as n, version as v };