@nicnocquee/dataqueue 1.32.0 → 1.33.0

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"names":[],"mappings":";;;;;AAKA,IAAM,UAAA,GAAa,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AAChD,IAAM,SAAA,GAAY,IAAA,CAAK,OAAA,CAAQ,UAAU,CAAA;AAUlC,SAAS,OACd,IAAA,EACA;AAAA,EACE,MAAM,OAAA,CAAQ,GAAA;AAAA,EACd,IAAA,GAAO,CAAC,IAAA,KAAiB,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,EAC1C,aAAA,GAAgB,SAAA;AAAA,EAChB,aAAA,GAAgB,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,eAAe;AACtD,CAAA,GAAa,EAAC,EACR;AACN,EAAA,MAAM,KAAK,OAAA,EAAS,GAAG,QAAQ,CAAA,GAAI,IAAA;AAEnC,EAAA,SAAS,UAAA,GAAa;AACpB,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA,CAAI,EAAE,CAAA;AACN,IAAA,GAAA,CAAI,UAAU,CAAA;AACd,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA,CAAI,EAAE,CAAA;AACN,IAAA,GAAA,CAAI,QAAQ,CAAA;AACZ,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,GAAA;AAAA,MACE;AAAA,KACF;AACA,IAAA,IAAA,CAAK,CAAC,CAAA;AAAA;AAGR,EAAA,IAAI,YAAY,SAAA,EAAW;AAEzB,IAAA,IAAI,YAAsB,EAAC;AAC3B,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,OAAA,CAAQ,IAAI,CAAA;AACpC,IAAA,MAAM,WAAA,GAAc,QAAA,CAAS,OAAA,CAAQ,UAAU,CAAA;AAC/C,IAAA,IAAI,MAAA,KAAW,EAAA,IAAM,QAAA,CAAS,MAAA,GAAS,CAAC,CAAA,EAAG;AACzC,MAAA,SAAA,GAAY,CAAC,IAAA,EAAM,QAAA,CAAS,MAAA,GAAS,CAAC,GAAG,iBAAiB,CAAA;AAC1D,MAAA,QAAA,CAAS,MAAA,CAAO,QAAQ,CAAC,CAAA;AAAA,eAChB,WAAA,KAAgB,EAAA,IAAM,QAAA,CAAS,WAAA,GAAc,CAAC,CAAA,EAAG;AAC1D,MAAA,SAAA,GAAY,CAAC,IAAA,EAAM,QAAA,CAAS,WAAA,GAAc,CAAC,GAAG,iBAAiB,CAAA;AAC/D,MAAA,QAAA,CAAS,MAAA,CAAO,aAAa,CAAC,CAAA;AAAA;AAIhC,IAAA,IAAI,aAAuB,EAAC;AAC5B,IAAA,MAAM,YAAA,GAAe,QAAA,CAAS,OAAA,CAAQ,WAAW,CAAA;AACjD,IAAA,IAAI,YAAA,KAAiB,EAAA,IAAM,QAAA,CAAS,YAAA,GAAe,CAAC,CAAA,EAAG;AACrD,MAAA,UAAA,GAAa,CAAC,WAAA,EAAa,QAAA,CAAS,YAAA,GAAe,CAAC,CAAC,CAAA;AAAA;AAGvD,IAAA,MAAM,MAAA,GAAgC,aAAA;AAAA,MACpC,KAAA;AAAA,MACA;AAAA,QACE,iBAAA;AAAA,QACA,IAAA;AAAA,QACA,IAAA;AAAA,QACA,yBAAA;AAAA,QACA,IAAA;AAAA,QACA,uBAAA;AAAA,QACA,IAAA;AAAA,QACA,aAAA;AAAA,QACA,GAAG,SAAA;AAAA,QACH,GAAG,UAAA;AAAA,QACH,GAAG;AAAA,OACL;AAAA,MACA,EAAE,OAAO,SAAA;AAAU,KACrB;AACA,IAAA,IAAA,CAAK,MAAA,CAAO,UAAU,CAAC,CAAA;AAAA,GACzB,MAAO;AACL,IAAA,UAAA,EAAW;AAAA;AAEf","file":"cli.js","sourcesContent":["// Testable CLI logic for dataqueue\nimport { spawnSync, SpawnSyncReturns } from 'child_process';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport interface CliDeps {\n  log?: (...args: any[]) => void;\n  error?: (...args: any[]) => void;\n  exit?: (code: number) => void;\n  spawnSyncImpl?: (...args: any[]) => SpawnSyncReturns<any>;\n  migrationsDir?: string;\n}\n\nexport function runCli(\n  argv: string[],\n  {\n    log = console.log,\n    exit = (code: number) => process.exit(code),\n    spawnSyncImpl = spawnSync,\n    migrationsDir = path.join(__dirname, '../migrations'),\n  }: CliDeps = {},\n): void {\n  const [, , command, ...restArgs] = argv;\n\n  function printUsage() {\n    log(\n      'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',\n    );\n    log('');\n    log('Options:');\n    log(\n      '  --envPath <path>   Path to a .env file to load environment variables (passed to node-pg-migrate)',\n    );\n    log(\n      '  -s, --schema <schema>  Set the schema to use (passed to node-pg-migrate)',\n    );\n    log('');\n    log('Notes:');\n    log(\n      '  - The PG_DATAQUEUE_DATABASE environment variable must be set to your Postgres connection string.',\n    );\n    log(\n      '  - For managed Postgres (e.g., DigitalOcean) with SSL, set PGSSLMODE=require and PGSSLROOTCERT to your CA .crt file.',\n    );\n    log(\n      '    Example: PGSSLMODE=require NODE_EXTRA_CA_CERTS=/absolute/path/to/ca.crt PG_DATAQUEUE_DATABASE=... npx dataqueue-cli migrate',\n    );\n    exit(1);\n  }\n\n  if (command === 'migrate') {\n    // Support for -s or --schema argument\n    let schemaArg: string[] = [];\n    const sIndex = restArgs.indexOf('-s');\n    const schemaIndex = restArgs.indexOf('--schema');\n    if (sIndex !== -1 && restArgs[sIndex + 1]) {\n      schemaArg = ['-s', restArgs[sIndex + 1], '--create-schema'];\n      restArgs.splice(sIndex, 2);\n    } else if (schemaIndex !== -1 && restArgs[schemaIndex + 1]) {\n      schemaArg = ['-s', restArgs[schemaIndex + 1], '--create-schema'];\n      restArgs.splice(schemaIndex, 2);\n    }\n\n    // Support for --envPath argument\n    let envPathArg: string[] = [];\n    const envPathIndex = restArgs.indexOf('--envPath');\n    if (envPathIndex !== -1 && restArgs[envPathIndex + 1]) {\n      envPathArg = ['--envPath', restArgs[envPathIndex + 1]];\n    }\n\n    const result: SpawnSyncReturns<any> = spawnSyncImpl(\n      'npx',\n      [\n        'node-pg-migrate',\n        'up',\n        '-t',\n        'dataqueuedev_migrations',\n        '-d',\n        'PG_DATAQUEUE_DATABASE',\n        '-m',\n        migrationsDir,\n        ...schemaArg,\n        ...envPathArg,\n        ...restArgs,\n      ],\n      { stdio: 'inherit' },\n    );\n    exit(result.status ?? 1);\n  } else {\n    printUsage();\n  }\n}\n"]}
+{"version":3,"sources":["../src/init-command.ts","../src/cli.ts"],"names":["path"],"mappings":"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","file":"cli.js","sourcesContent":["import {\n  chmodSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  writeFileSync,\n} from 'fs';\nimport path from 'path';\n\ntype JsonObject = Record<string, unknown>;\ntype JsonMap = Record<string, string>;\n\nconst DEPENDENCIES_TO_ADD = [\n  '@nicnocquee/dataqueue',\n  '@nicnocquee/dataqueue-dashboard',\n  '@nicnocquee/dataqueue-react',\n] as const;\n\nconst DEV_DEPENDENCIES_TO_ADD = [\n  'dotenv-cli',\n  'ts-node',\n  'node-pg-migrate',\n] as const;\n\nconst SCRIPTS_TO_ADD = {\n  cron: 'bash cron.sh',\n  'migrate-dataqueue': 'dotenv -e .env.local -- dataqueue-cli migrate',\n} as const;\n\n/**\n * App router endpoint template for queue management.\n */\nexport const APP_ROUTER_ROUTE_TEMPLATE = `/**\n * This end point is used to manage the job queue.\n * It supports the following tasks:\n * - reclaim: Reclaim stuck jobs\n * - cleanup: Cleanup old jobs\n * - process: Process jobs\n *\n * Example usage with default values (reclaim stuck jobs for 10 minutes, cleanup old jobs for 30 days, and process jobs with batch size 3, concurrency 2, and verbose true):\n * curl -X POST http://localhost:3000/api/dataqueue/manage/reclaim -H \"Authorization: Bearer $CRON_SECRET\"\n * curl -X POST http://localhost:3000/api/dataqueue/manage/cleanup -H \"Authorization: Bearer $CRON_SECRET\"\n * curl -X POST http://localhost:3000/api/dataqueue/manage/process -H \"Authorization: Bearer $CRON_SECRET\"\n *\n * Example usage with custom values:\n * curl -X POST http://localhost:3000/api/dataqueue/manage/reclaim -H \"Authorization: Bearer $CRON_SECRET\" -d '{\"maxProcessingTimeMinutes\": 15}' -H \"Content-Type: application/json\"\n * curl -X POST http://localhost:3000/api/dataqueue/manage/cleanup -H \"Authorization: Bearer $CRON_SECRET\" -d '{\"daysToKeep\": 15}' -H \"Content-Type: application/json\"\n * curl -X POST http://localhost:3000/api/dataqueue/manage/process -H \"Authorization: Bearer $CRON_SECRET\" -d '{\"batchSize\": 5, \"concurrency\": 3, \"verbose\": false, \"workerId\": \"custom-worker-id\"}' -H \"Content-Type: application/json\"\n *\n * During development, you can run the following script to run the cron jobs continuously in the background:\n * pnpm cron\n */\nimport { getJobQueue, jobHandlers } from '@/lib/dataqueue/queue';\nimport { NextResponse } from 'next/server';\n\nexport async function POST(\n  request: Request,\n  { params }: { params: Promise<{ task: string[] }> },\n) {\n  const { task } = await params;\n  const authHeader = request.headers.get('authorization');\n  if (authHeader !== \\`Bearer \\${process.env.CRON_SECRET}\\`) {\n    return NextResponse.json({ message: 'Unauthorized' }, { status: 401 });\n  }\n\n  if (!task || task.length === 0) {\n    return NextResponse.json({ message: 'Task is required' }, { status: 400 });\n  }\n\n  const supportedTasks = ['reclaim', 'cleanup', 'process'];\n  const theTask = task[0];\n  if (!supportedTasks.includes(theTask)) {\n    return NextResponse.json(\n      { message: 'Task not supported' },\n      { status: 400 },\n    );\n  }\n\n  try {\n    const jobQueue = getJobQueue();\n\n    if (theTask === 'reclaim') {\n      let maxProcessingTimeMinutes = 10;\n      try {\n        const body = await request.json();\n        maxProcessingTimeMinutes = body.maxProcessingTimeMinutes || 10;\n      } catch {\n        // ignore parsing error and use default value\n      }\n      const reclaimed = await jobQueue.reclaimStuckJobs(\n        maxProcessingTimeMinutes,\n      );\n      console.log(\\`Reclaimed \\${reclaimed} stuck jobs\\`);\n      return NextResponse.json({\n        message: \\`Stuck jobs reclaimed: \\${reclaimed} with maxProcessingTimeMinutes: \\${maxProcessingTimeMinutes}\\`,\n        reclaimed,\n      });\n    }\n\n    if (theTask === 'cleanup') {\n      let daysToKeep = 30;\n      try {\n        const body = await request.json();\n        daysToKeep = body.daysToKeep || 30;\n      } catch {\n        // ignore parsing error and use default value\n      }\n      const deleted = await jobQueue.cleanupOldJobs(daysToKeep);\n      console.log(\\`Deleted \\${deleted} old jobs\\`);\n      return NextResponse.json({\n        message: \\`Old jobs cleaned up: \\${deleted} with daysToKeep: \\${daysToKeep}\\`,\n        deleted,\n      });\n    }\n\n    if (theTask === 'process') {\n      let batchSize = 3;\n      let concurrency = 2;\n      let verbose = true;\n      let workerId = \\`manage-\\${theTask}-\\${Date.now()}\\`;\n      try {\n        const body = await request.json();\n        batchSize = body.batchSize || 3;\n        concurrency = body.concurrency || 2;\n        verbose = body.verbose || true;\n        workerId = body.workerId || \\`manage-\\${theTask}-\\${Date.now()}\\`;\n      } catch {\n        // ignore parsing error and use default value\n      }\n      const processor = jobQueue.createProcessor(jobHandlers, {\n        workerId,\n        batchSize,\n        concurrency,\n        verbose,\n      });\n      const processed = await processor.start();\n\n      return NextResponse.json({\n        message: \\`Jobs processed: \\${processed} with workerId: \\${workerId}, batchSize: \\${batchSize}, concurrency: \\${concurrency}, and verbose: \\${verbose}\\`,\n        processed,\n      });\n    }\n\n    return NextResponse.json(\n      { message: 'Task not supported' },\n      { status: 400 },\n    );\n  } catch (error) {\n    console.error('Error processing jobs:', error);\n    return NextResponse.json(\n      { message: 'Failed to process jobs' },\n      { status: 500 },\n    );\n  }\n}\n`;\n\n/**\n * Pages router endpoint template for queue management.\n */\nexport const PAGES_ROUTER_ROUTE_TEMPLATE = `/**\n * This end point is used to manage the job queue.\n * It supports the following tasks:\n * - reclaim: Reclaim stuck jobs\n * - cleanup: Cleanup old jobs\n * - process: Process jobs\n *\n * Example usage with default values (reclaim stuck jobs for 10 minutes, cleanup old jobs for 30 days, and process jobs with batch size 3, concurrency 2, and verbose true):\n * curl -X POST http://localhost:3000/api/dataqueue/manage/reclaim -H \"Authorization: Bearer $CRON_SECRET\"\n * curl -X POST http://localhost:3000/api/dataqueue/manage/cleanup -H \"Authorization: Bearer $CRON_SECRET\"\n * curl -X POST http://localhost:3000/api/dataqueue/manage/process -H \"Authorization: Bearer $CRON_SECRET\"\n *\n * Example usage with custom values:\n * curl -X POST http://localhost:3000/api/dataqueue/manage/reclaim -H \"Authorization: Bearer $CRON_SECRET\" -d '{\"maxProcessingTimeMinutes\": 15}' -H \"Content-Type: application/json\"\n * curl -X POST http://localhost:3000/api/dataqueue/manage/cleanup -H \"Authorization: Bearer $CRON_SECRET\" -d '{\"daysToKeep\": 15}' -H \"Content-Type: application/json\"\n * curl -X POST http://localhost:3000/api/dataqueue/manage/process -H \"Authorization: Bearer $CRON_SECRET\" -d '{\"batchSize\": 5, \"concurrency\": 3, \"verbose\": false, \"workerId\": \"custom-worker-id\"}' -H \"Content-Type: application/json\"\n *\n * During development, you can run the following script to run the cron jobs continuously in the background:\n * pnpm cron\n */\nimport type { NextApiRequest, NextApiResponse } from 'next';\nimport { getJobQueue, jobHandlers } from '@/lib/dataqueue/queue';\n\ntype ResponseBody = {\n  message: string;\n  reclaimed?: number;\n  deleted?: number;\n  processed?: number;\n};\n\nexport default async function handler(\n  req: NextApiRequest,\n  res: NextApiResponse<ResponseBody>,\n) {\n  if (req.method !== 'POST') {\n    res.setHeader('Allow', 'POST');\n    return res.status(405).json({ message: 'Method not allowed' });\n  }\n\n  const authHeader = req.headers.authorization;\n  if (authHeader !== \\`Bearer \\${process.env.CRON_SECRET}\\`) {\n    return res.status(401).json({ message: 'Unauthorized' });\n  }\n\n  const task = req.query.task;\n  const taskArray = Array.isArray(task) ? task : task ? [task] : [];\n  if (!taskArray.length) {\n    return res.status(400).json({ message: 'Task is required' });\n  }\n\n  const supportedTasks = ['reclaim', 'cleanup', 'process'];\n  const theTask = taskArray[0];\n  if (!supportedTasks.includes(theTask)) {\n    return res.status(400).json({ message: 'Task not supported' });\n  }\n\n  try {\n    const jobQueue = getJobQueue();\n    const body = typeof req.body === 'object' && req.body ? req.body : {};\n\n    if (theTask === 'reclaim') {\n      const maxProcessingTimeMinutes = body.maxProcessingTimeMinutes || 10;\n      const reclaimed = await jobQueue.reclaimStuckJobs(maxProcessingTimeMinutes);\n      console.log(\\`Reclaimed \\${reclaimed} stuck jobs\\`);\n      return res.status(200).json({\n        message: \\`Stuck jobs reclaimed: \\${reclaimed} with maxProcessingTimeMinutes: \\${maxProcessingTimeMinutes}\\`,\n        reclaimed,\n      });\n    }\n\n    if (theTask === 'cleanup') {\n      const daysToKeep = body.daysToKeep || 30;\n      const deleted = await jobQueue.cleanupOldJobs(daysToKeep);\n      console.log(\\`Deleted \\${deleted} old jobs\\`);\n      return res.status(200).json({\n        message: \\`Old jobs cleaned up: \\${deleted} with daysToKeep: \\${daysToKeep}\\`,\n        deleted,\n      });\n    }\n\n    const batchSize = body.batchSize || 3;\n    const concurrency = body.concurrency || 2;\n    const verbose = body.verbose || true;\n    const workerId = body.workerId || \\`manage-\\${theTask}-\\${Date.now()}\\`;\n    const processor = jobQueue.createProcessor(jobHandlers, {\n      workerId,\n      batchSize,\n      concurrency,\n      verbose,\n    });\n    const processed = await processor.start();\n\n    return res.status(200).json({\n      message: \\`Jobs processed: \\${processed} with workerId: \\${workerId}, batchSize: \\${batchSize}, concurrency: \\${concurrency}, and verbose: \\${verbose}\\`,\n      processed,\n    });\n  } catch (error) {\n    console.error('Error processing jobs:', error);\n    return res.status(500).json({ message: 'Failed to process jobs' });\n  }\n}\n`;\n\n/**\n * Cron script template for local queue processing.\n */\nexport const CRON_SH_TEMPLATE = `#!/bin/bash\n\n# This script is used to run the cron jobs for the demo app during development.\n# Run it with \\`pnpm cron\\` from the apps/demo directory.\n\nset -a\nsource \"$(dirname \"$0\")/.env.local\"\nset +a\n\nif [ -z \"$CRON_SECRET\" ]; then\n  echo \"Error: CRON_SECRET environment variable is not set in .env.local\"\n  exit 1\nfi\n\ncleanup() {\n  kill 0\n  wait\n}\ntrap cleanup SIGINT SIGTERM\n\nwhile true; do\n  echo \"Processing jobs...\"\n  curl http://localhost:3000/api/dataqueue/manage/process -X POST -H \"Authorization: Bearer $CRON_SECRET\"\n  echo \"\"\n  sleep 10 # Process jobs every 10 seconds\ndone &\n\nwhile true; do\n  echo \"Reclaiming stuck jobs...\"\n  curl http://localhost:3000/api/dataqueue/manage/reclaim -X POST -H \"Authorization: Bearer $CRON_SECRET\"\n  echo \"\"\n  sleep 20 # Reclaim stuck jobs every 20 seconds\ndone &\n\nwhile true; do\n  echo \"Cleaning up old jobs...\"\n  curl http://localhost:3000/api/dataqueue/manage/cleanup -X POST -H \"Authorization: Bearer $CRON_SECRET\"\n  echo \"\"\n  sleep 30 # Cleanup old jobs every 30 seconds\ndone &\n\nwait\n`;\n\n/**\n * Queue placeholder template with a single `send_email` job.\n */\nexport const QUEUE_TEMPLATE = `import { initJobQueue, JobHandlers } from '@nicnocquee/dataqueue';\n\nexport type JobPayloadMap = {\n  send_email: {\n    to: string;\n    subject: string;\n    body: string;\n  };\n};\n\nlet jobQueue: ReturnType<typeof initJobQueue<JobPayloadMap>> | null = null;\n\nexport const getJobQueue = () => {\n  if (!jobQueue) {\n    jobQueue = initJobQueue<JobPayloadMap>({\n      databaseConfig: {\n        connectionString: process.env.PG_DATAQUEUE_DATABASE,\n      },\n      verbose: process.env.NODE_ENV === 'development',\n    });\n  }\n  return jobQueue;\n};\n\nexport const jobHandlers: JobHandlers<JobPayloadMap> = {\n  send_email: async (payload) => {\n    const { to, subject, body } = payload;\n    console.log('send_email placeholder:', { to, subject, body });\n  },\n};\n`;\n\nexport interface InitDeps {\n  log?: (...args: any[]) => void;\n  error?: (...args: any[]) => void;\n  exit?: (code: number) => void;\n  cwd?: string;\n  readFileSyncImpl?: typeof readFileSync;\n  writeFileSyncImpl?: typeof writeFileSync;\n  existsSyncImpl?: typeof existsSync;\n  mkdirSyncImpl?: typeof mkdirSync;\n  chmodSyncImpl?: typeof chmodSync;\n}\n\ntype RouterKind = 'app' | 'pages';\n\ninterface ProjectDetails {\n  cwd: string;\n  packageJsonPath: string;\n  packageJson: JsonObject;\n  srcRoot: string;\n  router: RouterKind;\n}\n\n/**\n * Runs the `dataqueue-cli init` command.\n */\nexport function runInit({\n  log = console.log,\n  error = console.error,\n  exit = (code: number) => process.exit(code),\n  cwd = process.cwd(),\n  readFileSyncImpl = readFileSync,\n  writeFileSyncImpl = writeFileSync,\n  existsSyncImpl = existsSync,\n  mkdirSyncImpl = mkdirSync,\n  chmodSyncImpl = chmodSync,\n}: InitDeps = {}): void {\n  try {\n    log(`dataqueue: Initializing in ${cwd}...`);\n    log('');\n\n    const details = detectNextJsAndRouter({\n      cwd,\n      existsSyncImpl,\n      readFileSyncImpl,\n    });\n\n    createScaffoldFiles({\n      details,\n      log,\n      existsSyncImpl,\n      mkdirSyncImpl,\n      writeFileSyncImpl,\n      chmodSyncImpl,\n    });\n\n    updatePackageJson({\n      details,\n      log,\n      writeFileSyncImpl,\n    });\n\n    log('');\n    log(\n      \"Done! Run your package manager's install command to install new dependencies.\",\n    );\n    exit(0);\n  } catch (cause) {\n    const message = cause instanceof Error ? cause.message : String(cause);\n    error(`dataqueue: ${message}`);\n    exit(1);\n  }\n}\n\n/**\n * Detects that the current directory is a Next.js app and chooses the router.\n */\nexport function detectNextJsAndRouter({\n  cwd,\n  existsSyncImpl,\n  readFileSyncImpl,\n}: {\n  cwd: string;\n  existsSyncImpl: typeof existsSync;\n  readFileSyncImpl: typeof readFileSync;\n}): ProjectDetails {\n  const packageJsonPath = path.join(cwd, 'package.json');\n  if (!existsSyncImpl(packageJsonPath)) {\n    throw new Error('package.json not found in current directory.');\n  }\n\n  const packageJson = parsePackageJson(\n    readFileSyncImpl(packageJsonPath, 'utf8'),\n    packageJsonPath,\n  );\n  if (!isNextJsProject(packageJson)) {\n    throw new Error(\n      \"Not a Next.js project. Could not find 'next' in package.json dependencies.\",\n    );\n  }\n\n  const srcDir = path.join(cwd, 'src');\n  const srcRoot = existsSyncImpl(srcDir) ? 'src' : '.';\n  const appDir = path.join(cwd, srcRoot, 'app');\n  const pagesDir = path.join(cwd, srcRoot, 'pages');\n  const hasAppDir = existsSyncImpl(appDir);\n  const hasPagesDir = existsSyncImpl(pagesDir);\n\n  if (!hasAppDir && !hasPagesDir) {\n    throw new Error(\n      'Could not detect Next.js router. Expected either app/ or pages/ directory.',\n    );\n  }\n\n  const router: RouterKind = hasAppDir ? 'app' : 'pages';\n  return { cwd, packageJsonPath, packageJson, srcRoot, router };\n}\n\n/**\n * Updates package.json with required dependencies and scripts.\n */\nfunction updatePackageJson({\n  details,\n  log,\n  writeFileSyncImpl,\n}: {\n  details: ProjectDetails;\n  log: (...args: any[]) => void;\n  writeFileSyncImpl: typeof writeFileSync;\n}): void {\n  const packageJson = details.packageJson;\n  const dependencies = ensureStringMapSection(packageJson, 'dependencies');\n  const devDependencies = ensureStringMapSection(\n    packageJson,\n    'devDependencies',\n  );\n  const scripts = ensureStringMapSection(packageJson, 'scripts');\n\n  for (const dependency of DEPENDENCIES_TO_ADD) {\n    if (dependencies[dependency]) {\n      log(`  [skipped] dependency ${dependency} (already exists)`);\n      continue;\n    }\n    dependencies[dependency] = 'latest';\n    log(`  [added]   dependency ${dependency}`);\n  }\n\n  for (const devDependency of DEV_DEPENDENCIES_TO_ADD) {\n    if (devDependencies[devDependency]) {\n      log(`  [skipped] devDependency ${devDependency} (already exists)`);\n      continue;\n    }\n    devDependencies[devDependency] = 'latest';\n    log(`  [added]   devDependency ${devDependency}`);\n  }\n\n  for (const [scriptName, scriptValue] of Object.entries(SCRIPTS_TO_ADD)) {\n    if (scripts[scriptName]) {\n      log(`  [skipped] script \"${scriptName}\" (already exists)`);\n      continue;\n    }\n    scripts[scriptName] = scriptValue;\n    log(`  [added]   script \"${scriptName}\"`);\n  }\n\n  writeFileSyncImpl(\n    details.packageJsonPath,\n    `${JSON.stringify(packageJson, null, 2)}\\n`,\n  );\n}\n\n/**\n * Creates all scaffold files for the detected router without overwriting.\n */\nfunction createScaffoldFiles({\n  details,\n  log,\n  existsSyncImpl,\n  mkdirSyncImpl,\n  writeFileSyncImpl,\n  chmodSyncImpl,\n}: {\n  details: ProjectDetails;\n  log: (...args: any[]) => void;\n  existsSyncImpl: typeof existsSync;\n  mkdirSyncImpl: typeof mkdirSync;\n  writeFileSyncImpl: typeof writeFileSync;\n  chmodSyncImpl: typeof chmodSync;\n}): void {\n  const appRoutePath = path.join(\n    details.cwd,\n    details.srcRoot,\n    'app',\n    'api',\n    'dataqueue',\n    'manage',\n    '[[...task]]',\n    'route.ts',\n  );\n  const pagesRoutePath = path.join(\n    details.cwd,\n    details.srcRoot,\n    'pages',\n    'api',\n    'dataqueue',\n    'manage',\n    '[[...task]].ts',\n  );\n  const queuePath = path.join(\n    details.cwd,\n    details.srcRoot,\n    'lib',\n    'dataqueue',\n    'queue.ts',\n  );\n  const cronPath = path.join(details.cwd, 'cron.sh');\n\n  if (details.router === 'app') {\n    createFileIfMissing({\n      absolutePath: appRoutePath,\n      content: APP_ROUTER_ROUTE_TEMPLATE,\n      existsSyncImpl,\n      mkdirSyncImpl,\n      writeFileSyncImpl,\n      log,\n      logPath: toRelativePath(details.cwd, appRoutePath),\n    });\n    log(\n      '  [skipped] pages/api/dataqueue/manage/[[...task]].ts (router not selected)',\n    );\n  } else {\n    log(\n      '  [skipped] app/api/dataqueue/manage/[[...task]]/route.ts (router not selected)',\n    );\n    createFileIfMissing({\n      absolutePath: pagesRoutePath,\n      content: PAGES_ROUTER_ROUTE_TEMPLATE,\n      existsSyncImpl,\n      mkdirSyncImpl,\n      writeFileSyncImpl,\n      log,\n      logPath: toRelativePath(details.cwd, pagesRoutePath),\n    });\n  }\n\n  createFileIfMissing({\n    absolutePath: cronPath,\n    content: CRON_SH_TEMPLATE,\n    existsSyncImpl,\n    mkdirSyncImpl,\n    writeFileSyncImpl,\n    log,\n    logPath: 'cron.sh',\n  });\n  if (existsSyncImpl(cronPath)) {\n    chmodSyncImpl(cronPath, 0o755);\n  }\n\n  createFileIfMissing({\n    absolutePath: queuePath,\n    content: QUEUE_TEMPLATE,\n    existsSyncImpl,\n    mkdirSyncImpl,\n    writeFileSyncImpl,\n    log,\n    logPath: toRelativePath(details.cwd, queuePath),\n  });\n}\n\n/**\n * Creates a file only if it does not already exist.\n */\nfunction createFileIfMissing({\n  absolutePath,\n  content,\n  existsSyncImpl,\n  mkdirSyncImpl,\n  writeFileSyncImpl,\n  log,\n  logPath,\n}: {\n  absolutePath: string;\n  content: string;\n  existsSyncImpl: typeof existsSync;\n  mkdirSyncImpl: typeof mkdirSync;\n  writeFileSyncImpl: typeof writeFileSync;\n  log: (...args: any[]) => void;\n  logPath: string;\n}): void {\n  if (existsSyncImpl(absolutePath)) {\n    log(`  [skipped] ${logPath} (already exists)`);\n    return;\n  }\n\n  mkdirSyncImpl(path.dirname(absolutePath), { recursive: true });\n  writeFileSyncImpl(absolutePath, content);\n  log(`  [created] ${logPath}`);\n}\n\n/**\n * Parses package.json content with clear source context.\n */\nfunction parsePackageJson(content: string, filePath: string): JsonObject {\n  try {\n    const parsed = JSON.parse(content);\n    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n      throw new Error('package.json must contain an object.');\n    }\n    return parsed as JsonObject;\n  } catch (cause) {\n    throw new Error(\n      `Failed to parse package.json at ${filePath}: ${\n        cause instanceof Error ? cause.message : String(cause)\n      }`,\n    );\n  }\n}\n\n/**\n * Returns true when package.json declares Next.js in deps or devDeps.\n */\nfunction isNextJsProject(packageJson: JsonObject): boolean {\n  const dependencies = packageJson.dependencies;\n  const devDependencies = packageJson.devDependencies;\n\n  return (\n    hasPackage(dependencies, 'next') || hasPackage(devDependencies, 'next')\n  );\n}\n\n/**\n * Returns true when a package name exists in a dependency section object.\n */\nfunction hasPackage(section: unknown, packageName: string): boolean {\n  if (!section || typeof section !== 'object' || Array.isArray(section)) {\n    return false;\n  }\n  return Boolean((section as JsonMap)[packageName]);\n}\n\n/**\n * Ensures package.json has a string map section and returns it.\n */\nfunction ensureStringMapSection(\n  packageJson: JsonObject,\n  sectionName: 'dependencies' | 'devDependencies' | 'scripts',\n): JsonMap {\n  const currentValue = packageJson[sectionName];\n  if (\n    !currentValue ||\n    typeof currentValue !== 'object' ||\n    Array.isArray(currentValue)\n  ) {\n    packageJson[sectionName] = {};\n  }\n  return packageJson[sectionName] as JsonMap;\n}\n\n/**\n * Converts an absolute path to a stable relative path for log output.\n */\nfunction toRelativePath(cwd: string, absolutePath: string): string {\n  const relative = path.relative(cwd, absolutePath);\n  return relative || '.';\n}\n","// Testable CLI logic for dataqueue\nimport { spawnSync, SpawnSyncReturns } from 'child_process';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { InitDeps, runInit } from './init-command.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport interface CliDeps {\n  log?: (...args: any[]) => void;\n  error?: (...args: any[]) => void;\n  exit?: (code: number) => void;\n  spawnSyncImpl?: (...args: any[]) => SpawnSyncReturns<any>;\n  migrationsDir?: string;\n  initDeps?: InitDeps;\n  runInitImpl?: (deps?: InitDeps) => void;\n}\n\nexport function runCli(\n  argv: string[],\n  {\n    log = console.log,\n    error = console.error,\n    exit = (code: number) => process.exit(code),\n    spawnSyncImpl = spawnSync,\n    migrationsDir = path.join(__dirname, '../migrations'),\n    initDeps,\n    runInitImpl = runInit,\n  }: CliDeps = {},\n): void {\n  const [, , command, ...restArgs] = argv;\n\n  /**\n   * Prints CLI usage and exits with non-zero code.\n   */\n  function printUsage() {\n    log('Usage:');\n    log(\n      '  dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',\n    );\n    log('  dataqueue-cli init');\n    log('');\n    log('Options for migrate:');\n    log(\n      '  --envPath <path>   Path to a .env file to load environment variables (passed to node-pg-migrate)',\n    );\n    log(\n      '  -s, --schema <schema>  Set the schema to use (passed to node-pg-migrate)',\n    );\n    log('');\n    log('Notes:');\n    log(\n      '  - The PG_DATAQUEUE_DATABASE environment variable must be set to your Postgres connection string.',\n    );\n    log(\n      '  - For managed Postgres (e.g., DigitalOcean) with SSL, set PGSSLMODE=require and PGSSLROOTCERT to your CA .crt file.',\n    );\n    log(\n      '    Example: PGSSLMODE=require NODE_EXTRA_CA_CERTS=/absolute/path/to/ca.crt PG_DATAQUEUE_DATABASE=... npx dataqueue-cli migrate',\n    );\n    log('');\n    log('Notes for init:');\n    log(\n      '  - Supports both Next.js App Router and Pages Router (prefers App Router if both exist).',\n    );\n    log(\n      '  - Scaffolds endpoint, cron.sh, queue placeholder, and package.json entries.',\n    );\n    exit(1);\n  }\n\n  if (command === 'migrate') {\n    // Support for -s or --schema argument\n    let schemaArg: string[] = [];\n    const sIndex = restArgs.indexOf('-s');\n    const schemaIndex = restArgs.indexOf('--schema');\n    if (sIndex !== -1 && restArgs[sIndex + 1]) {\n      schemaArg = ['-s', restArgs[sIndex + 1], '--create-schema'];\n      restArgs.splice(sIndex, 2);\n    } else if (schemaIndex !== -1 && restArgs[schemaIndex + 1]) {\n      schemaArg = ['-s', restArgs[schemaIndex + 1], '--create-schema'];\n      restArgs.splice(schemaIndex, 2);\n    }\n\n    // Support for --envPath argument\n    let envPathArg: string[] = [];\n    const envPathIndex = restArgs.indexOf('--envPath');\n    if (envPathIndex !== -1 && restArgs[envPathIndex + 1]) {\n      envPathArg = ['--envPath', restArgs[envPathIndex + 1]];\n    }\n\n    const result: SpawnSyncReturns<any> = spawnSyncImpl(\n      'npx',\n      [\n        'node-pg-migrate',\n        'up',\n        '-t',\n        'dataqueuedev_migrations',\n        '-d',\n        'PG_DATAQUEUE_DATABASE',\n        '-m',\n        migrationsDir,\n        ...schemaArg,\n        ...envPathArg,\n        ...restArgs,\n      ],\n      { stdio: 'inherit' },\n    );\n    exit(result.status ?? 1);\n  } else if (command === 'init') {\n    runInitImpl({\n      log,\n      error,\n      exit,\n      ...initDeps,\n    });\n  } else {\n    printUsage();\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicnocquee/dataqueue",
-  "version": "1.32.0",
+  "version": "1.33.0",
   "description": "PostgreSQL or Redis-backed job queue for Node.js applications with support for serverless environments",
   "type": "module",
   "main": "dist/index.js",

package/src/cli.test.ts

@@ -22,6 +22,7 @@ function makeDeps() {
     exit: vi.fn(),
     spawnSyncImpl: vi.fn(() => makeSpawnSyncReturns(0)),
     migrationsDir: '/migrations',
+    runInitImpl: vi.fn(),
   } satisfies CliDeps;
 }
 
@@ -34,20 +35,30 @@ describe('runCli', () => {
 
   it('prints usage and exits with code 1 for no command', () => {
     runCli(['node', 'cli.js'], deps);
-    expect(deps.log).toHaveBeenCalledWith(
-      'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',
-    );
+    expect(deps.log).toHaveBeenCalledWith('Usage:');
+    expect(deps.log).toHaveBeenCalledWith('  dataqueue-cli init');
     expect(deps.exit).toHaveBeenCalledWith(1);
   });
 
   it('prints usage and exits with code 1 for unknown command', () => {
     runCli(['node', 'cli.js', 'unknown'], deps);
-    expect(deps.log).toHaveBeenCalledWith(
-      'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',
-    );
+    expect(deps.log).toHaveBeenCalledWith('Usage:');
+    expect(deps.log).toHaveBeenCalledWith('  dataqueue-cli init');
     expect(deps.exit).toHaveBeenCalledWith(1);
   });
 
+  it('routes init command to runInitImpl', () => {
+    runCli(['node', 'cli.js', 'init'], deps);
+    expect(deps.runInitImpl).toHaveBeenCalledWith(
+      expect.objectContaining({
+        log: deps.log,
+        error: deps.error,
+        exit: deps.exit,
+      }),
+    );
+    expect(deps.spawnSyncImpl).not.toHaveBeenCalled();
+  });
+
   it('calls spawnSyncImpl with correct args for migrate', () => {
     runCli(['node', 'cli.js', 'migrate'], deps);
     expect(deps.spawnSyncImpl).toHaveBeenCalledWith(

package/src/cli.ts

@@ -2,6 +2,7 @@
 import { spawnSync, SpawnSyncReturns } from 'child_process';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { InitDeps, runInit } from './init-command.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -12,25 +13,35 @@ export interface CliDeps {
   exit?: (code: number) => void;
   spawnSyncImpl?: (...args: any[]) => SpawnSyncReturns<any>;
   migrationsDir?: string;
+  initDeps?: InitDeps;
+  runInitImpl?: (deps?: InitDeps) => void;
 }
 
 export function runCli(
   argv: string[],
   {
     log = console.log,
+    error = console.error,
     exit = (code: number) => process.exit(code),
     spawnSyncImpl = spawnSync,
     migrationsDir = path.join(__dirname, '../migrations'),
+    initDeps,
+    runInitImpl = runInit,
   }: CliDeps = {},
 ): void {
   const [, , command, ...restArgs] = argv;
 
+  /**
+   * Prints CLI usage and exits with non-zero code.
+   */
   function printUsage() {
+    log('Usage:');
     log(
-      'Usage: dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',
+      '  dataqueue-cli migrate [--envPath <path>] [-s <schema> | --schema <schema>]',
     );
+    log('  dataqueue-cli init');
     log('');
-    log('Options:');
+    log('Options for migrate:');
     log(
       '  --envPath <path>   Path to a .env file to load environment variables (passed to node-pg-migrate)',
     );
@@ -48,6 +59,14 @@ export function runCli(
     log(
       '    Example: PGSSLMODE=require NODE_EXTRA_CA_CERTS=/absolute/path/to/ca.crt PG_DATAQUEUE_DATABASE=... npx dataqueue-cli migrate',
     );
+    log('');
+    log('Notes for init:');
+    log(
+      '  - Supports both Next.js App Router and Pages Router (prefers App Router if both exist).',
+    );
+    log(
+      '  - Scaffolds endpoint, cron.sh, queue placeholder, and package.json entries.',
+    );
     exit(1);
   }
 
@@ -89,6 +108,13 @@ export function runCli(
       { stdio: 'inherit' },
     );
     exit(result.status ?? 1);
+  } else if (command === 'init') {
+    runInitImpl({
+      log,
+      error,
+      exit,
+      ...initDeps,
+    });
   } else {
     printUsage();
   }

package/src/init-command.test.ts

@@ -0,0 +1,449 @@
+import path from 'path';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import {
+  APP_ROUTER_ROUTE_TEMPLATE,
+  CRON_SH_TEMPLATE,
+  PAGES_ROUTER_ROUTE_TEMPLATE,
+  QUEUE_TEMPLATE,
+  detectNextJsAndRouter,
+  runInit,
+} from './init-command.js';
+
+type VirtualFsState = {
+  files: Map<string, string>;
+  dirs: Set<string>;
+  chmodCalls: Array<{ filePath: string; mode: number }>;
+};
+
+/**
+ * Builds a fake filesystem API surface compatible with `InitDeps`.
+ */
+function createVirtualFs(
+  cwd: string,
+  initialFiles: Record<string, string> = {},
+  initialDirs: string[] = [],
+) {
+  const state: VirtualFsState = {
+    files: new Map(),
+    dirs: new Set([cwd, ...initialDirs.map((dir) => resolvePath(cwd, dir))]),
+    chmodCalls: [],
+  };
+
+  for (const [filePath, content] of Object.entries(initialFiles)) {
+    const absolutePath = resolvePath(cwd, filePath);
+    state.files.set(absolutePath, content);
+    state.dirs.add(path.dirname(absolutePath));
+  }
+
+  return {
+    state,
+    existsSyncImpl: vi.fn((targetPath: string) => {
+      return state.files.has(targetPath) || state.dirs.has(targetPath);
+    }),
+    mkdirSyncImpl: vi.fn((targetPath: string) => {
+      state.dirs.add(targetPath);
+    }),
+    readFileSyncImpl: vi.fn((targetPath: string) => {
+      const content = state.files.get(targetPath);
+      if (typeof content !== 'string') {
+        throw new Error(`ENOENT: ${targetPath}`);
+      }
+      return content;
+    }),
+    writeFileSyncImpl: vi.fn((targetPath: string, content: string) => {
+      state.files.set(targetPath, content);
+      state.dirs.add(path.dirname(targetPath));
+    }),
+    chmodSyncImpl: vi.fn((filePath: string, mode: number) => {
+      state.chmodCalls.push({ filePath, mode });
+    }),
+  };
+}
+
+/**
+ * Resolves a project-relative path to absolute for tests.
+ */
+function resolvePath(cwd: string, maybeRelativePath: string): string {
+  if (path.isAbsolute(maybeRelativePath)) {
+    return maybeRelativePath;
+  }
+  return path.join(cwd, maybeRelativePath);
+}
+
+describe('detectNextJsAndRouter', () => {
+  const cwd = '/project';
+
+  it('throws if package.json is missing', () => {
+    const fs = createVirtualFs(cwd);
+    expect(() =>
+      detectNextJsAndRouter({
+        cwd,
+        existsSyncImpl: fs.existsSyncImpl as any,
+        readFileSyncImpl: fs.readFileSyncImpl as any,
+      }),
+    ).toThrow('package.json not found in current directory.');
+  });
+
+  it('throws if next dependency is missing', () => {
+    const fs = createVirtualFs(cwd, {
+      'package.json': JSON.stringify({ name: 'app' }),
+    });
+
+    expect(() =>
+      detectNextJsAndRouter({
+        cwd,
+        existsSyncImpl: fs.existsSyncImpl as any,
+        readFileSyncImpl: fs.readFileSyncImpl as any,
+      }),
+    ).toThrow(
+      "Not a Next.js project. Could not find 'next' in package.json dependencies.",
+    );
+  });
+
+  it('detects app router when app exists', () => {
+    const fs = createVirtualFs(
+      cwd,
+      {
+        'package.json': JSON.stringify({
+          dependencies: { next: '15.0.0' },
+        }),
+      },
+      ['app'],
+    );
+
+    const result = detectNextJsAndRouter({
+      cwd,
+      existsSyncImpl: fs.existsSyncImpl as any,
+      readFileSyncImpl: fs.readFileSyncImpl as any,
+    });
+
+    expect(result.router).toBe('app');
+    expect(result.srcRoot).toBe('.');
+  });
+
+  it('detects pages router when only pages exists', () => {
+    const fs = createVirtualFs(
+      cwd,
+      {
+        'package.json': JSON.stringify({
+          devDependencies: { next: '15.0.0' },
+        }),
+      },
+      ['pages'],
+    );
+
+    const result = detectNextJsAndRouter({
+      cwd,
+      existsSyncImpl: fs.existsSyncImpl as any,
+      readFileSyncImpl: fs.readFileSyncImpl as any,
+    });
+
+    expect(result.router).toBe('pages');
+    expect(result.srcRoot).toBe('.');
+  });
+
+  it('prefers app router when both app and pages exist', () => {
+    const fs = createVirtualFs(
+      cwd,
+      {
+        'package.json': JSON.stringify({
+          dependencies: { next: '15.0.0' },
+        }),
+      },
+      ['app', 'pages'],
+    );
+
+    const result = detectNextJsAndRouter({
+      cwd,
+      existsSyncImpl: fs.existsSyncImpl as any,
+      readFileSyncImpl: fs.readFileSyncImpl as any,
+    });
+
+    expect(result.router).toBe('app');
+  });
+
+  it('uses src as root when src exists', () => {
+    const fs = createVirtualFs(
+      cwd,
+      {
+        'package.json': JSON.stringify({
+          dependencies: { next: '15.0.0' },
+        }),
+      },
+      ['src', 'src/pages'],
+    );
+
+    const result = detectNextJsAndRouter({
+      cwd,
+      existsSyncImpl: fs.existsSyncImpl as any,
+      readFileSyncImpl: fs.readFileSyncImpl as any,
+    });
+
+    expect(result.srcRoot).toBe('src');
+    expect(result.router).toBe('pages');
+  });
+
+  it('throws when neither app nor pages exists', () => {
+    const fs = createVirtualFs(cwd, {
+      'package.json': JSON.stringify({
+        dependencies: { next: '15.0.0' },
+      }),
+    });
+
+    expect(() =>
+      detectNextJsAndRouter({
+        cwd,
+        existsSyncImpl: fs.existsSyncImpl as any,
+        readFileSyncImpl: fs.readFileSyncImpl as any,
+      }),
+    ).toThrow(
+      'Could not detect Next.js router. Expected either app/ or pages/ directory.',
+    );
+  });
+});
+
+describe('runInit', () => {
+  const cwd = '/project';
+  let log: ReturnType<typeof vi.fn>;
+  let error: ReturnType<typeof vi.fn>;
+  let exit: ReturnType<typeof vi.fn>;
+
+  beforeEach(() => {
+    log = vi.fn();
+    error = vi.fn();
+    exit = vi.fn();
+  });
+
+  it('creates app router files, updates package.json, and exits successfully', () => {
+    const fs = createVirtualFs(
+      cwd,
+      {
+        'package.json': JSON.stringify({
+          name: 'app',
+          dependencies: { next: '15.0.0' },
+        }),
+      },
+      ['app'],
+    );
+
+    runInit({
+      cwd,
+      log,
+      error,
+      exit,
+      existsSyncImpl: fs.existsSyncImpl as any,
+      mkdirSyncImpl: fs.mkdirSyncImpl as any,
+      readFileSyncImpl: fs.readFileSyncImpl as any,
+      writeFileSyncImpl: fs.writeFileSyncImpl as any,
+      chmodSyncImpl: fs.chmodSyncImpl as any,
+    });
+
+    expect(
+      fs.state.files.get(
+        resolvePath(cwd, 'app/api/dataqueue/manage/[[...task]]/route.ts'),
+      ),
+    ).toBe(APP_ROUTER_ROUTE_TEMPLATE);
+    expect(fs.state.files.get(resolvePath(cwd, 'lib/dataqueue/queue.ts'))).toBe(
+      QUEUE_TEMPLATE,
+    );
+    expect(fs.state.files.get(resolvePath(cwd, 'cron.sh'))).toBe(
+      CRON_SH_TEMPLATE,
+    );
+    expect(fs.state.chmodCalls).toEqual([
+      { filePath: resolvePath(cwd, 'cron.sh'), mode: 0o755 },
+    ]);
+
+    const updatedPackageJson = JSON.parse(
+      fs.state.files.get(resolvePath(cwd, 'package.json')) || '{}',
+    );
+    expect(updatedPackageJson.dependencies['@nicnocquee/dataqueue']).toBe(
+      'latest',
+    );
+    expect(
+      updatedPackageJson.dependencies['@nicnocquee/dataqueue-dashboard'],
+    ).toBe('latest');
+    expect(updatedPackageJson.dependencies['@nicnocquee/dataqueue-react']).toBe(
+      'latest',
+    );
+    expect(updatedPackageJson.devDependencies['dotenv-cli']).toBe('latest');
+    expect(updatedPackageJson.devDependencies['ts-node']).toBe('latest');
+    expect(updatedPackageJson.devDependencies['node-pg-migrate']).toBe(
+      'latest',
+    );
+    expect(updatedPackageJson.scripts.cron).toBe('bash cron.sh');
+    expect(updatedPackageJson.scripts['migrate-dataqueue']).toBe(
+      'dotenv -e .env.local -- dataqueue-cli migrate',
+    );
+
+    expect(log).toHaveBeenCalledWith(
+      '  [skipped] pages/api/dataqueue/manage/[[...task]].ts (router not selected)',
+    );
+    expect(log).toHaveBeenCalledWith(
+      "Done! Run your package manager's install command to install new dependencies.",
+    );
+    expect(error).not.toHaveBeenCalled();
+    expect(exit).toHaveBeenCalledWith(0);
+  });
+
+  it('creates pages router file when only pages router exists', () => {
+    const fs = createVirtualFs(
+      cwd,
+      {
+        'package.json': JSON.stringify({
+          name: 'app',
+          dependencies: { next: '15.0.0' },
+        }),
+      },
+      ['pages'],
+    );
+
+    runInit({
+      cwd,
+      log,
+      error,
+      exit,
+      existsSyncImpl: fs.existsSyncImpl as any,
+      mkdirSyncImpl: fs.mkdirSyncImpl as any,
+      readFileSyncImpl: fs.readFileSyncImpl as any,
+      writeFileSyncImpl: fs.writeFileSyncImpl as any,
+      chmodSyncImpl: fs.chmodSyncImpl as any,
+    });
+
+    expect(
+      fs.state.files.get(
+        resolvePath(cwd, 'pages/api/dataqueue/manage/[[...task]].ts'),
+      ),
+    ).toBe(PAGES_ROUTER_ROUTE_TEMPLATE);
+    expect(log).toHaveBeenCalledWith(
+      '  [skipped] app/api/dataqueue/manage/[[...task]]/route.ts (router not selected)',
+    );
+    expect(exit).toHaveBeenCalledWith(0);
+  });
+
+  it('skips existing files and existing package entries', () => {
+    const existingRoute = '/* existing */';
+    const existingCron = '#!/bin/bash\n# existing';
+    const existingQueue = '// existing queue';
+    const fs = createVirtualFs(
+      cwd,
+      {
+        'package.json': JSON.stringify({
+          dependencies: {
+            next: '15.0.0',
+            '@nicnocquee/dataqueue': '^1.0.0',
+          },
+          devDependencies: {
+            'dotenv-cli': '^8.0.0',
+          },
+          scripts: {
+            cron: 'bash cron.sh',
+          },
+        }),
+        'app/api/dataqueue/manage/[[...task]]/route.ts': existingRoute,
+        'cron.sh': existingCron,
+        'lib/dataqueue/queue.ts': existingQueue,
+      },
+      ['app'],
+    );
+
+    runInit({
+      cwd,
+      log,
+      error,
+      exit,
+      existsSyncImpl: fs.existsSyncImpl as any,
+      mkdirSyncImpl: fs.mkdirSyncImpl as any,
+      readFileSyncImpl: fs.readFileSyncImpl as any,
+      writeFileSyncImpl: fs.writeFileSyncImpl as any,
+      chmodSyncImpl: fs.chmodSyncImpl as any,
+    });
+
+    expect(
+      fs.state.files.get(
+        resolvePath(cwd, 'app/api/dataqueue/manage/[[...task]]/route.ts'),
+      ),
+    ).toBe(existingRoute);
+    expect(fs.state.files.get(resolvePath(cwd, 'cron.sh'))).toBe(existingCron);
+    expect(fs.state.files.get(resolvePath(cwd, 'lib/dataqueue/queue.ts'))).toBe(
+      existingQueue,
+    );
+
+    const updatedPackageJson = JSON.parse(
+      fs.state.files.get(resolvePath(cwd, 'package.json')) || '{}',
+    );
+    expect(updatedPackageJson.dependencies['@nicnocquee/dataqueue']).toBe(
+      '^1.0.0',
+    );
+    expect(updatedPackageJson.scripts.cron).toBe('bash cron.sh');
+    expect(updatedPackageJson.scripts['migrate-dataqueue']).toBe(
+      'dotenv -e .env.local -- dataqueue-cli migrate',
+    );
+    expect(log).toHaveBeenCalledWith(
+      '  [skipped] dependency @nicnocquee/dataqueue (already exists)',
+    );
+    expect(log).toHaveBeenCalledWith(
+      '  [skipped] script "cron" (already exists)',
+    );
+    expect(exit).toHaveBeenCalledWith(0);
+  });
+
+  it('works for a monorepo sub-app by using cwd package.json', () => {
+    const subAppCwd = '/repo/apps/web';
+    const fs = createVirtualFs(
+      subAppCwd,
+      {
+        'package.json': JSON.stringify({
+          dependencies: { next: '15.0.0' },
+        }),
+      },
+      ['app'],
+    );
+
+    runInit({
+      cwd: subAppCwd,
+      log,
+      error,
+      exit,
+      existsSyncImpl: fs.existsSyncImpl as any,
+      mkdirSyncImpl: fs.mkdirSyncImpl as any,
+      readFileSyncImpl: fs.readFileSyncImpl as any,
+      writeFileSyncImpl: fs.writeFileSyncImpl as any,
+      chmodSyncImpl: fs.chmodSyncImpl as any,
+    });
+
+    expect(
+      fs.state.files.has(
+        resolvePath(subAppCwd, 'app/api/dataqueue/manage/[[...task]]/route.ts'),
+      ),
+    ).toBe(true);
+    expect(exit).toHaveBeenCalledWith(0);
+  });
+
+  it('logs an error and exits with code 1 for invalid package.json', () => {
+    const fs = createVirtualFs(
+      cwd,
+      {
+        'package.json': '{invalid json',
+      },
+      ['app'],
+    );
+
+    runInit({
+      cwd,
+      log,
+      error,
+      exit,
+      existsSyncImpl: fs.existsSyncImpl as any,
+      mkdirSyncImpl: fs.mkdirSyncImpl as any,
+      readFileSyncImpl: fs.readFileSyncImpl as any,
+      writeFileSyncImpl: fs.writeFileSyncImpl as any,
+      chmodSyncImpl: fs.chmodSyncImpl as any,
+    });
+
+    expect(error).toHaveBeenCalledTimes(1);
+    expect(String(error.mock.calls[0][0])).toContain(
+      'Failed to parse package.json',
+    );
+    expect(exit).toHaveBeenCalledWith(1);
+  });
+});