express-file-cluster 0.1.0 → 0.1.2

package/dist/auth/index.d.cts

@@ -1,5 +1,5 @@
 import { Response, RequestHandler } from 'express';
-import { A as AuthStrategy } from '../types-DNdkDUPX.cjs';
+import { A as AuthStrategy } from '../types-CkpRAA3y.cjs';
 
 interface AuthConfig {
     secret: string;

package/dist/auth/index.d.ts

@@ -1,5 +1,5 @@
 import { Response, RequestHandler } from 'express';
-import { A as AuthStrategy } from '../types-DNdkDUPX.js';
+import { A as AuthStrategy } from '../types-CkpRAA3y.js';
 
 interface AuthConfig {
     secret: string;

package/dist/cli/index.cjs

@@ -46,6 +46,15 @@ function startCommand() {
   });
   return cmd;
 }
+function buildDevEnv(cwd) {
+  const env = { ...process.env, NODE_ENV: "development" };
+  const envFile = import_node_path.default.join(cwd, ".env");
+  if (import_node_fs.default.existsSync(envFile)) {
+    const existing = (process.env["NODE_OPTIONS"] ?? "").trim();
+    env["NODE_OPTIONS"] = `${existing} --env-file ${envFile}`.trim();
+  }
+  return env;
+}
 function startDev() {
   const entry = resolveEntry();
   if (!entry) {
@@ -54,11 +63,13 @@ function startDev() {
   }
   console.log(import_chalk.default.cyan("[EFC] Starting development server\u2026"));
   console.log(import_chalk.default.dim(`  Entry: ${entry}`));
-  const child = (0, import_node_child_process.spawn)(
-    "node",
-    ["--import", "tsx/esm", "--watch", entry],
-    { stdio: "inherit", env: { ...process.env, NODE_ENV: "development" } }
-  );
+  const cwd = process.cwd();
+  const localTsx = import_node_path.default.join(cwd, "node_modules", ".bin", "tsx");
+  const tsx = import_node_fs.default.existsSync(localTsx) ? localTsx : "tsx";
+  const child = (0, import_node_child_process.spawn)(tsx, ["watch", entry], {
+    stdio: "inherit",
+    env: buildDevEnv(cwd)
+  });
   child.on("exit", (code) => process.exit(code ?? 0));
 }
 function startProd() {
@@ -69,7 +80,9 @@ function startProd() {
     process.exit(1);
   }
   console.log(import_chalk.default.cyan("[EFC] Starting production server\u2026"));
-  const child = (0, import_node_child_process.spawn)("node", [distEntry], {
+  const envFile = import_node_path.default.join(cwd, ".env");
+  const nodeArgs = import_node_fs.default.existsSync(envFile) ? ["--env-file", envFile, distEntry] : [distEntry];
+  const child = (0, import_node_child_process.spawn)("node", nodeArgs, {
     stdio: "inherit",
     env: { ...process.env, NODE_ENV: "production" }
   });

package/dist/cli/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/commands/start.ts","../../src/cli/commands/build.ts","../../src/cli/commands/run.ts","../../src/cli/commands/generate.ts","../../src/cli/commands/diagnostics.ts","../../src/router/scan.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { startCommand } from './commands/start.js';\nimport { buildCommand } from './commands/build.js';\nimport { runCommand } from './commands/run.js';\nimport { generateCommand } from './commands/generate.js';\nimport { diagnosticsCommands } from './commands/diagnostics.js';\n\nconst program = new Command('efc')\n  .description('Express File Cluster CLI')\n  .version('0.1.0');\n\nprogram.addCommand(startCommand());\nprogram.addCommand(buildCommand());\nprogram.addCommand(runCommand());\nprogram.addCommand(generateCommand());\n\nfor (const cmd of diagnosticsCommands()) {\n  program.addCommand(cmd);\n}\n\nprogram.parse(process.argv);\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport chalk from 'chalk';\n\nexport function startCommand(): Command {\n  const cmd = new Command('start');\n\n  cmd\n    .argument('<mode>', 'dev | prod')\n    .description('Start the EFC server')\n    .action((mode: string) => {\n      if (mode === 'dev') {\n        startDev();\n      } else if (mode === 'prod') {\n        startProd();\n      } else {\n        console.error(chalk.red(`Unknown mode: ${mode}. Use 'dev' or 'prod'.`));\n        process.exit(1);\n      }\n    });\n\n  return cmd;\n}\n\nfunction startDev(): void {\n  const entry = resolveEntry();\n  if (!entry) {\n    console.error(chalk.red('[EFC] Could not find entry point. Expected src/index.ts or index.ts'));\n    process.exit(1);\n  }\n\n  console.log(chalk.cyan('[EFC] Starting development server…'));\n  console.log(chalk.dim(`  Entry: ${entry}`));\n\n  const child = spawn(\n    'node',\n    ['--import', 'tsx/esm', '--watch', entry],\n    { stdio: 'inherit', env: { ...process.env, NODE_ENV: 'development' } },\n  );\n\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n\nfunction startProd(): void {\n  const cwd = process.cwd();\n  const distEntry = path.join(cwd, 'dist', 'index.js');\n\n  if (!fs.existsSync(distEntry)) {\n    console.error(chalk.red('[EFC] dist/index.js not found. Run `efc build prod` first.'));\n    process.exit(1);\n  }\n\n  console.log(chalk.cyan('[EFC] Starting production server…'));\n\n  const child = spawn('node', [distEntry], {\n    stdio: 'inherit',\n    env: { ...process.env, NODE_ENV: 'production' },\n  });\n\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n\nfunction resolveEntry(): string | null {\n  const cwd = process.cwd();\n  const candidates = [\n    path.join(cwd, 'src', 'index.ts'),\n    path.join(cwd, 'index.ts'),\n    path.join(cwd, 'src', 'index.js'),\n    path.join(cwd, 'index.js'),\n  ];\n  return candidates.find((f) => fs.existsSync(f)) ?? null;\n}\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\n\nexport function buildCommand(): Command {\n  const cmd = new Command('build');\n\n  cmd\n    .argument('<mode>', 'prod')\n    .description('Build the application for production')\n    .action((mode: string) => {\n      if (mode !== 'prod') {\n        console.error(chalk.red(`Unknown build mode: ${mode}. Use 'prod'.`));\n        process.exit(1);\n      }\n      buildProd();\n    });\n\n  return cmd;\n}\n\nfunction buildProd(): void {\n  console.log(chalk.cyan('[EFC] Building for production…'));\n\n  // Type-check first\n  const tsc = spawn('npx', ['tsc', '--noEmit'], { stdio: 'inherit' });\n\n  tsc.on('exit', (code) => {\n    if (code !== 0) {\n      console.error(chalk.red('[EFC] TypeScript errors found. Fix them before building.'));\n      process.exit(1);\n    }\n\n    const tsup = spawn('npx', ['tsup'], { stdio: 'inherit' });\n    tsup.on('exit', (tsupCode) => {\n      if (tsupCode === 0) {\n        console.log(chalk.green('[EFC] Build complete → dist/'));\n      } else {\n        process.exit(tsupCode ?? 1);\n      }\n    });\n  });\n}\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\n\nexport function runCommand(): Command {\n  const cmd = new Command('run');\n\n  cmd\n    .argument('<runner>', 'tests')\n    .description('Run EFC sub-commands (tests)')\n    .allowUnknownOption()\n    .action((runner: string) => {\n      if (runner === 'tests') {\n        runTests(cmd.args.slice(1));\n      } else {\n        console.error(chalk.red(`Unknown runner: ${runner}. Use 'tests'.`));\n        process.exit(1);\n      }\n    });\n\n  return cmd;\n}\n\nfunction runTests(extraArgs: string[]): void {\n  console.log(chalk.cyan('[EFC] Running tests via Vitest…'));\n  const child = spawn('npx', ['vitest', 'run', ...extraArgs], { stdio: 'inherit' });\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n","import { Command } from 'commander';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport chalk from 'chalk';\n\nexport function generateCommand(): Command {\n  const cmd = new Command('generate').alias('g').description('Scaffold EFC modules');\n\n  cmd\n    .command('route <routePath>')\n    .description('Scaffold a route module, e.g. users/[id]')\n    .action((routePath: string) => generateRoute(routePath));\n\n  cmd\n    .command('task <name>')\n    .description('Scaffold a background task module')\n    .action((name: string) => generateTask(name));\n\n  cmd\n    .command('middleware <name>')\n    .description('Scaffold a middleware module')\n    .action((name: string) => generateMiddleware(name));\n\n  return cmd;\n}\n\nfunction writeFile(filePath: string, content: string): void {\n  const dir = path.dirname(filePath);\n  fs.mkdirSync(dir, { recursive: true });\n  if (fs.existsSync(filePath)) {\n    console.error(chalk.red(`File already exists: ${filePath}`));\n    process.exit(1);\n  }\n  fs.writeFileSync(filePath, content, 'utf8');\n  console.log(chalk.green(`  created  ${path.relative(process.cwd(), filePath)}`));\n}\n\nfunction generateRoute(routePath: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'api', `${routePath}.ts`);\n\n  const content = `import type { Request, Response } from 'express';\n\nexport const GET = async (req: Request, res: Response) => {\n  res.json({ message: 'OK' });\n};\n\nexport const POST = async (req: Request, res: Response) => {\n  res.status(201).json({ message: 'Created' });\n};\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Route scaffolded`));\n}\n\nfunction generateTask(name: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'tasks', `${name}.ts`);\n\n  const content = `import { defineTask } from 'express-file-cluster/tasks';\n\ninterface ${name}Payload {\n  // TODO: define payload fields\n}\n\nexport default defineTask<${name}Payload>(async (payload) => {\n  // TODO: implement task logic\n  console.log('[Task:${name}]', payload);\n});\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Task scaffolded`));\n}\n\nfunction generateMiddleware(name: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'middlewares', `${name}.ts`);\n\n  const content = `import type { Request, Response, NextFunction } from 'express';\n\nexport function ${name}(req: Request, res: Response, next: NextFunction): void {\n  // TODO: implement middleware logic\n  next();\n}\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Middleware scaffolded`));\n}\n","import { Command } from 'commander';\nimport { scanDir } from '../../router/scan.js';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport chalk from 'chalk';\n\nexport function diagnosticsCommands(): Command[] {\n  return [routesCommand(), tasksCommand(), doctorCommand()];\n}\n\nfunction routesCommand(): Command {\n  return new Command('routes')\n    .description('Print the resolved route table')\n    .action(() => {\n      const apiDir = resolveApiDir();\n      if (!apiDir) {\n        console.error(chalk.red('[EFC] Could not find apiDir (expected src/api)'));\n        process.exit(1);\n      }\n\n      const routes = scanDir(apiDir);\n      if (routes.length === 0) {\n        console.log(chalk.yellow('No routes found.'));\n        return;\n      }\n\n      console.log(chalk.bold('\\n  Route Table\\n'));\n      console.log(chalk.dim('  ' + '─'.repeat(60)));\n      for (const route of routes) {\n        const rel = path.relative(process.cwd(), route.filePath);\n        console.log(`  ${chalk.cyan(route.urlPath.padEnd(35))} ${chalk.dim(rel)}`);\n      }\n      console.log(chalk.dim('  ' + '─'.repeat(60)));\n      console.log(chalk.dim(`\\n  ${routes.length} route(s) found\\n`));\n    });\n}\n\nfunction tasksCommand(): Command {\n  return new Command('tasks')\n    .description('List registered background tasks')\n    .action(() => {\n      const tasksDir = resolveTasksDir();\n      if (!tasksDir || !fs.existsSync(tasksDir)) {\n        console.log(chalk.yellow('No tasks directory found.'));\n        return;\n      }\n\n      const files = fs.readdirSync(tasksDir).filter((f) => /\\.(ts|js)$/.test(f));\n      if (files.length === 0) {\n        console.log(chalk.yellow('No tasks found.'));\n        return;\n      }\n\n      console.log(chalk.bold('\\n  Background Tasks\\n'));\n      for (const file of files) {\n        console.log(`  ${chalk.cyan(path.basename(file, path.extname(file)))}`);\n      }\n      console.log();\n    });\n}\n\nfunction doctorCommand(): Command {\n  return new Command('doctor')\n    .description('Validate config, env vars, and project setup')\n    .action(() => {\n      const cwd = process.cwd();\n      const checks: { label: string; ok: boolean; hint?: string }[] = [\n        {\n          label: 'package.json exists',\n          ok: fs.existsSync(path.join(cwd, 'package.json')),\n        },\n        {\n          label: 'tsconfig.json exists',\n          ok: fs.existsSync(path.join(cwd, 'tsconfig.json')),\n          hint: 'Run `tsc --init` to create one',\n        },\n        {\n          label: 'src/api directory exists',\n          ok: fs.existsSync(path.join(cwd, 'src', 'api')),\n          hint: 'Create src/api/ and add route files',\n        },\n        {\n          label: 'DATABASE_URL set',\n          ok: Boolean(process.env['DATABASE_URL']),\n          hint: 'Add DATABASE_URL to .env',\n        },\n        {\n          label: 'JWT_SECRET set',\n          ok: Boolean(process.env['JWT_SECRET']),\n          hint: 'Add JWT_SECRET to .env (generate: openssl rand -hex 64)',\n        },\n      ];\n\n      console.log(chalk.bold('\\n  EFC Doctor\\n'));\n      let allOk = true;\n      for (const check of checks) {\n        const icon = check.ok ? chalk.green('✓') : chalk.red('✗');\n        console.log(`  ${icon}  ${check.label}`);\n        if (!check.ok) {\n          allOk = false;\n          if (check.hint) console.log(chalk.dim(`       → ${check.hint}`));\n        }\n      }\n      console.log();\n      if (allOk) {\n        console.log(chalk.green('  All checks passed!\\n'));\n      } else {\n        console.log(chalk.yellow('  Some checks failed. Fix the issues above.\\n'));\n        process.exit(1);\n      }\n    });\n}\n\nfunction resolveApiDir(): string | null {\n  const cwd = process.cwd();\n  const candidates = [path.join(cwd, 'src', 'api'), path.join(cwd, 'api')];\n  return candidates.find((d) => fs.existsSync(d)) ?? null;\n}\n\nfunction resolveTasksDir(): string | null {\n  const cwd = process.cwd();\n  const candidates = [path.join(cwd, 'src', 'tasks'), path.join(cwd, 'tasks')];\n  return candidates.find((d) => fs.existsSync(d)) ?? null;\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\nfunction filePathToUrlPath(relativePath: string): string {\n  let p = relativePath.replace(ROUTE_FILE_RE, '');\n  // index files map to parent path\n  p = p.replace(/\\/index$/, '');\n  // [param] → :param\n  p = p.replace(DYNAMIC_SEGMENT_RE, ':$1');\n  return p === '' ? '/' : p.startsWith('/') ? p : `/${p}`;\n}\n\nfunction extractParams(relativePath: string): string[] {\n  const params: string[] = [];\n  let match: RegExpExecArray | null;\n  const re = new RegExp(DYNAMIC_SEGMENT_RE.source, 'g');\n  while ((match = re.exec(relativePath)) !== null) {\n    if (match[1]) params.push(match[1]);\n  }\n  return params;\n}\n\nexport function scanDir(dir: string, base: string = dir): RouteEntry[] {\n  if (!fs.existsSync(dir)) return [];\n\n  const entries: RouteEntry[] = [];\n  const items = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const item of items) {\n    const fullPath = path.join(dir, item.name);\n    if (item.isDirectory()) {\n      entries.push(...scanDir(fullPath, base));\n    } else if (ROUTE_FILE_RE.test(item.name)) {\n      const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n      entries.push({\n        urlPath: filePathToUrlPath(relative),\n        filePath: fullPath,\n        params: extractParams(relative),\n      });\n    }\n  }\n\n  // Sort: static routes before dynamic ones at each segment level\n  return entries.sort((a, b) => {\n    const aDynamic = a.urlPath.includes(':') ? 1 : 0;\n    const bDynamic = b.urlPath.includes(':') ? 1 : 0;\n    return aDynamic - bDynamic || a.urlPath.localeCompare(b.urlPath);\n  });\n}\n\nexport { filePathToUrlPath };\n"],"mappings":"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","names":["import_commander","chalk","path","fs","import_commander","import_node_child_process","import_chalk","chalk","import_commander","import_node_child_process","import_chalk","chalk","import_commander","import_node_fs","import_node_path","import_chalk","path","fs","chalk","import_commander","import_node_fs","import_node_path","fs","path","import_node_path","import_node_fs","import_chalk","chalk","path","fs"]}
+{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/commands/start.ts","../../src/cli/commands/build.ts","../../src/cli/commands/run.ts","../../src/cli/commands/generate.ts","../../src/cli/commands/diagnostics.ts","../../src/router/scan.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { startCommand } from './commands/start.js';\nimport { buildCommand } from './commands/build.js';\nimport { runCommand } from './commands/run.js';\nimport { generateCommand } from './commands/generate.js';\nimport { diagnosticsCommands } from './commands/diagnostics.js';\n\nconst program = new Command('efc')\n  .description('Express File Cluster CLI')\n  .version('0.1.0');\n\nprogram.addCommand(startCommand());\nprogram.addCommand(buildCommand());\nprogram.addCommand(runCommand());\nprogram.addCommand(generateCommand());\n\nfor (const cmd of diagnosticsCommands()) {\n  program.addCommand(cmd);\n}\n\nprogram.parse(process.argv);\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport chalk from 'chalk';\n\nexport function startCommand(): Command {\n  const cmd = new Command('start');\n\n  cmd\n    .argument('<mode>', 'dev | prod')\n    .description('Start the EFC server')\n    .action((mode: string) => {\n      if (mode === 'dev') {\n        startDev();\n      } else if (mode === 'prod') {\n        startProd();\n      } else {\n        console.error(chalk.red(`Unknown mode: ${mode}. Use 'dev' or 'prod'.`));\n        process.exit(1);\n      }\n    });\n\n  return cmd;\n}\n\nfunction buildDevEnv(cwd: string): NodeJS.ProcessEnv {\n  const env: NodeJS.ProcessEnv = { ...process.env, NODE_ENV: 'development' };\n  const envFile = path.join(cwd, '.env');\n  if (fs.existsSync(envFile)) {\n    const existing = (process.env['NODE_OPTIONS'] ?? '').trim();\n    env['NODE_OPTIONS'] = `${existing} --env-file ${envFile}`.trim();\n  }\n  return env;\n}\n\nfunction startDev(): void {\n  const entry = resolveEntry();\n  if (!entry) {\n    console.error(chalk.red('[EFC] Could not find entry point. Expected src/index.ts or index.ts'));\n    process.exit(1);\n  }\n\n  console.log(chalk.cyan('[EFC] Starting development server…'));\n  console.log(chalk.dim(`  Entry: ${entry}`));\n\n  const cwd = process.cwd();\n  const localTsx = path.join(cwd, 'node_modules', '.bin', 'tsx');\n  const tsx = fs.existsSync(localTsx) ? localTsx : 'tsx';\n\n  const child = spawn(tsx, ['watch', entry], {\n    stdio: 'inherit',\n    env: buildDevEnv(cwd),\n  });\n\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n\nfunction startProd(): void {\n  const cwd = process.cwd();\n  const distEntry = path.join(cwd, 'dist', 'index.js');\n\n  if (!fs.existsSync(distEntry)) {\n    console.error(chalk.red('[EFC] dist/index.js not found. Run `efc build prod` first.'));\n    process.exit(1);\n  }\n\n  console.log(chalk.cyan('[EFC] Starting production server…'));\n\n  const envFile = path.join(cwd, '.env');\n  const nodeArgs = fs.existsSync(envFile) ? ['--env-file', envFile, distEntry] : [distEntry];\n\n  const child = spawn('node', nodeArgs, {\n    stdio: 'inherit',\n    env: { ...process.env, NODE_ENV: 'production' },\n  });\n\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n\nfunction resolveEntry(): string | null {\n  const cwd = process.cwd();\n  const candidates = [\n    path.join(cwd, 'src', 'index.ts'),\n    path.join(cwd, 'index.ts'),\n    path.join(cwd, 'src', 'index.js'),\n    path.join(cwd, 'index.js'),\n  ];\n  return candidates.find((f) => fs.existsSync(f)) ?? null;\n}\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\n\nexport function buildCommand(): Command {\n  const cmd = new Command('build');\n\n  cmd\n    .argument('<mode>', 'prod')\n    .description('Build the application for production')\n    .action((mode: string) => {\n      if (mode !== 'prod') {\n        console.error(chalk.red(`Unknown build mode: ${mode}. Use 'prod'.`));\n        process.exit(1);\n      }\n      buildProd();\n    });\n\n  return cmd;\n}\n\nfunction buildProd(): void {\n  console.log(chalk.cyan('[EFC] Building for production…'));\n\n  // Type-check first\n  const tsc = spawn('npx', ['tsc', '--noEmit'], { stdio: 'inherit' });\n\n  tsc.on('exit', (code) => {\n    if (code !== 0) {\n      console.error(chalk.red('[EFC] TypeScript errors found. Fix them before building.'));\n      process.exit(1);\n    }\n\n    const tsup = spawn('npx', ['tsup'], { stdio: 'inherit' });\n    tsup.on('exit', (tsupCode) => {\n      if (tsupCode === 0) {\n        console.log(chalk.green('[EFC] Build complete → dist/'));\n      } else {\n        process.exit(tsupCode ?? 1);\n      }\n    });\n  });\n}\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\n\nexport function runCommand(): Command {\n  const cmd = new Command('run');\n\n  cmd\n    .argument('<runner>', 'tests')\n    .description('Run EFC sub-commands (tests)')\n    .allowUnknownOption()\n    .action((runner: string) => {\n      if (runner === 'tests') {\n        runTests(cmd.args.slice(1));\n      } else {\n        console.error(chalk.red(`Unknown runner: ${runner}. Use 'tests'.`));\n        process.exit(1);\n      }\n    });\n\n  return cmd;\n}\n\nfunction runTests(extraArgs: string[]): void {\n  console.log(chalk.cyan('[EFC] Running tests via Vitest…'));\n  const child = spawn('npx', ['vitest', 'run', ...extraArgs], { stdio: 'inherit' });\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n","import { Command } from 'commander';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport chalk from 'chalk';\n\nexport function generateCommand(): Command {\n  const cmd = new Command('generate').alias('g').description('Scaffold EFC modules');\n\n  cmd\n    .command('route <routePath>')\n    .description('Scaffold a route module, e.g. users/[id]')\n    .action((routePath: string) => generateRoute(routePath));\n\n  cmd\n    .command('task <name>')\n    .description('Scaffold a background task module')\n    .action((name: string) => generateTask(name));\n\n  cmd\n    .command('middleware <name>')\n    .description('Scaffold a middleware module')\n    .action((name: string) => generateMiddleware(name));\n\n  return cmd;\n}\n\nfunction writeFile(filePath: string, content: string): void {\n  const dir = path.dirname(filePath);\n  fs.mkdirSync(dir, { recursive: true });\n  if (fs.existsSync(filePath)) {\n    console.error(chalk.red(`File already exists: ${filePath}`));\n    process.exit(1);\n  }\n  fs.writeFileSync(filePath, content, 'utf8');\n  console.log(chalk.green(`  created  ${path.relative(process.cwd(), filePath)}`));\n}\n\nfunction generateRoute(routePath: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'api', `${routePath}.ts`);\n\n  const content = `import type { Request, Response } from 'express';\n\nexport const GET = async (req: Request, res: Response) => {\n  res.json({ message: 'OK' });\n};\n\nexport const POST = async (req: Request, res: Response) => {\n  res.status(201).json({ message: 'Created' });\n};\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Route scaffolded`));\n}\n\nfunction generateTask(name: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'tasks', `${name}.ts`);\n\n  const content = `import { defineTask } from 'express-file-cluster/tasks';\n\ninterface ${name}Payload {\n  // TODO: define payload fields\n}\n\nexport default defineTask<${name}Payload>(async (payload) => {\n  // TODO: implement task logic\n  console.log('[Task:${name}]', payload);\n});\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Task scaffolded`));\n}\n\nfunction generateMiddleware(name: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'middlewares', `${name}.ts`);\n\n  const content = `import type { Request, Response, NextFunction } from 'express';\n\nexport function ${name}(req: Request, res: Response, next: NextFunction): void {\n  // TODO: implement middleware logic\n  next();\n}\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Middleware scaffolded`));\n}\n","import { Command } from 'commander';\nimport { scanDir } from '../../router/scan.js';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport chalk from 'chalk';\n\nexport function diagnosticsCommands(): Command[] {\n  return [routesCommand(), tasksCommand(), doctorCommand()];\n}\n\nfunction routesCommand(): Command {\n  return new Command('routes')\n    .description('Print the resolved route table')\n    .action(() => {\n      const apiDir = resolveApiDir();\n      if (!apiDir) {\n        console.error(chalk.red('[EFC] Could not find apiDir (expected src/api)'));\n        process.exit(1);\n      }\n\n      const routes = scanDir(apiDir);\n      if (routes.length === 0) {\n        console.log(chalk.yellow('No routes found.'));\n        return;\n      }\n\n      console.log(chalk.bold('\\n  Route Table\\n'));\n      console.log(chalk.dim('  ' + '─'.repeat(60)));\n      for (const route of routes) {\n        const rel = path.relative(process.cwd(), route.filePath);\n        console.log(`  ${chalk.cyan(route.urlPath.padEnd(35))} ${chalk.dim(rel)}`);\n      }\n      console.log(chalk.dim('  ' + '─'.repeat(60)));\n      console.log(chalk.dim(`\\n  ${routes.length} route(s) found\\n`));\n    });\n}\n\nfunction tasksCommand(): Command {\n  return new Command('tasks')\n    .description('List registered background tasks')\n    .action(() => {\n      const tasksDir = resolveTasksDir();\n      if (!tasksDir || !fs.existsSync(tasksDir)) {\n        console.log(chalk.yellow('No tasks directory found.'));\n        return;\n      }\n\n      const files = fs.readdirSync(tasksDir).filter((f) => /\\.(ts|js)$/.test(f));\n      if (files.length === 0) {\n        console.log(chalk.yellow('No tasks found.'));\n        return;\n      }\n\n      console.log(chalk.bold('\\n  Background Tasks\\n'));\n      for (const file of files) {\n        console.log(`  ${chalk.cyan(path.basename(file, path.extname(file)))}`);\n      }\n      console.log();\n    });\n}\n\nfunction doctorCommand(): Command {\n  return new Command('doctor')\n    .description('Validate config, env vars, and project setup')\n    .action(() => {\n      const cwd = process.cwd();\n      const checks: { label: string; ok: boolean; hint?: string }[] = [\n        {\n          label: 'package.json exists',\n          ok: fs.existsSync(path.join(cwd, 'package.json')),\n        },\n        {\n          label: 'tsconfig.json exists',\n          ok: fs.existsSync(path.join(cwd, 'tsconfig.json')),\n          hint: 'Run `tsc --init` to create one',\n        },\n        {\n          label: 'src/api directory exists',\n          ok: fs.existsSync(path.join(cwd, 'src', 'api')),\n          hint: 'Create src/api/ and add route files',\n        },\n        {\n          label: 'DATABASE_URL set',\n          ok: Boolean(process.env['DATABASE_URL']),\n          hint: 'Add DATABASE_URL to .env',\n        },\n        {\n          label: 'JWT_SECRET set',\n          ok: Boolean(process.env['JWT_SECRET']),\n          hint: 'Add JWT_SECRET to .env (generate: openssl rand -hex 64)',\n        },\n      ];\n\n      console.log(chalk.bold('\\n  EFC Doctor\\n'));\n      let allOk = true;\n      for (const check of checks) {\n        const icon = check.ok ? chalk.green('✓') : chalk.red('✗');\n        console.log(`  ${icon}  ${check.label}`);\n        if (!check.ok) {\n          allOk = false;\n          if (check.hint) console.log(chalk.dim(`       → ${check.hint}`));\n        }\n      }\n      console.log();\n      if (allOk) {\n        console.log(chalk.green('  All checks passed!\\n'));\n      } else {\n        console.log(chalk.yellow('  Some checks failed. Fix the issues above.\\n'));\n        process.exit(1);\n      }\n    });\n}\n\nfunction resolveApiDir(): string | null {\n  const cwd = process.cwd();\n  const candidates = [path.join(cwd, 'src', 'api'), path.join(cwd, 'api')];\n  return candidates.find((d) => fs.existsSync(d)) ?? null;\n}\n\nfunction resolveTasksDir(): string | null {\n  const cwd = process.cwd();\n  const candidates = [path.join(cwd, 'src', 'tasks'), path.join(cwd, 'tasks')];\n  return candidates.find((d) => fs.existsSync(d)) ?? null;\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\nfunction filePathToUrlPath(relativePath: string): string {\n  let p = relativePath.replace(ROUTE_FILE_RE, '');\n  // index files map to parent path\n  p = p.replace(/\\/index$/, '');\n  // [param] → :param\n  p = p.replace(DYNAMIC_SEGMENT_RE, ':$1');\n  return p === '' ? '/' : p.startsWith('/') ? p : `/${p}`;\n}\n\nfunction extractParams(relativePath: string): string[] {\n  const params: string[] = [];\n  let match: RegExpExecArray | null;\n  const re = new RegExp(DYNAMIC_SEGMENT_RE.source, 'g');\n  while ((match = re.exec(relativePath)) !== null) {\n    if (match[1]) params.push(match[1]);\n  }\n  return params;\n}\n\nexport function scanDir(dir: string, base: string = dir): RouteEntry[] {\n  if (!fs.existsSync(dir)) return [];\n\n  const entries: RouteEntry[] = [];\n  const items = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const item of items) {\n    const fullPath = path.join(dir, item.name);\n    if (item.isDirectory()) {\n      entries.push(...scanDir(fullPath, base));\n    } else if (ROUTE_FILE_RE.test(item.name)) {\n      const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n      entries.push({\n        urlPath: filePathToUrlPath(relative),\n        filePath: fullPath,\n        params: extractParams(relative),\n      });\n    }\n  }\n\n  // Sort: static routes before dynamic ones at each segment level\n  return entries.sort((a, b) => {\n    const aDynamic = a.urlPath.includes(':') ? 1 : 0;\n    const bDynamic = b.urlPath.includes(':') ? 1 : 0;\n    return aDynamic - bDynamic || a.urlPath.localeCompare(b.urlPath);\n  });\n}\n\nexport { filePathToUrlPath };\n"],"mappings":"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","names":["import_commander","chalk","path","fs","import_commander","import_node_child_process","import_chalk","chalk","import_commander","import_node_child_process","import_chalk","chalk","import_commander","import_node_fs","import_node_path","import_chalk","path","fs","chalk","import_commander","import_node_fs","import_node_path","fs","path","import_node_path","import_node_fs","import_chalk","chalk","path","fs"]}

package/dist/cli/index.js

@@ -23,6 +23,15 @@ function startCommand() {
   });
   return cmd;
 }
+function buildDevEnv(cwd) {
+  const env = { ...process.env, NODE_ENV: "development" };
+  const envFile = path.join(cwd, ".env");
+  if (fs.existsSync(envFile)) {
+    const existing = (process.env["NODE_OPTIONS"] ?? "").trim();
+    env["NODE_OPTIONS"] = `${existing} --env-file ${envFile}`.trim();
+  }
+  return env;
+}
 function startDev() {
   const entry = resolveEntry();
   if (!entry) {
@@ -31,11 +40,13 @@ function startDev() {
   }
   console.log(chalk.cyan("[EFC] Starting development server\u2026"));
   console.log(chalk.dim(`  Entry: ${entry}`));
-  const child = spawn(
-    "node",
-    ["--import", "tsx/esm", "--watch", entry],
-    { stdio: "inherit", env: { ...process.env, NODE_ENV: "development" } }
-  );
+  const cwd = process.cwd();
+  const localTsx = path.join(cwd, "node_modules", ".bin", "tsx");
+  const tsx = fs.existsSync(localTsx) ? localTsx : "tsx";
+  const child = spawn(tsx, ["watch", entry], {
+    stdio: "inherit",
+    env: buildDevEnv(cwd)
+  });
   child.on("exit", (code) => process.exit(code ?? 0));
 }
 function startProd() {
@@ -46,7 +57,9 @@ function startProd() {
     process.exit(1);
   }
   console.log(chalk.cyan("[EFC] Starting production server\u2026"));
-  const child = spawn("node", [distEntry], {
+  const envFile = path.join(cwd, ".env");
+  const nodeArgs = fs.existsSync(envFile) ? ["--env-file", envFile, distEntry] : [distEntry];
+  const child = spawn("node", nodeArgs, {
     stdio: "inherit",
     env: { ...process.env, NODE_ENV: "production" }
   });

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/commands/start.ts","../../src/cli/commands/build.ts","../../src/cli/commands/run.ts","../../src/cli/commands/generate.ts","../../src/cli/commands/diagnostics.ts","../../src/router/scan.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { startCommand } from './commands/start.js';\nimport { buildCommand } from './commands/build.js';\nimport { runCommand } from './commands/run.js';\nimport { generateCommand } from './commands/generate.js';\nimport { diagnosticsCommands } from './commands/diagnostics.js';\n\nconst program = new Command('efc')\n  .description('Express File Cluster CLI')\n  .version('0.1.0');\n\nprogram.addCommand(startCommand());\nprogram.addCommand(buildCommand());\nprogram.addCommand(runCommand());\nprogram.addCommand(generateCommand());\n\nfor (const cmd of diagnosticsCommands()) {\n  program.addCommand(cmd);\n}\n\nprogram.parse(process.argv);\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport chalk from 'chalk';\n\nexport function startCommand(): Command {\n  const cmd = new Command('start');\n\n  cmd\n    .argument('<mode>', 'dev | prod')\n    .description('Start the EFC server')\n    .action((mode: string) => {\n      if (mode === 'dev') {\n        startDev();\n      } else if (mode === 'prod') {\n        startProd();\n      } else {\n        console.error(chalk.red(`Unknown mode: ${mode}. Use 'dev' or 'prod'.`));\n        process.exit(1);\n      }\n    });\n\n  return cmd;\n}\n\nfunction startDev(): void {\n  const entry = resolveEntry();\n  if (!entry) {\n    console.error(chalk.red('[EFC] Could not find entry point. Expected src/index.ts or index.ts'));\n    process.exit(1);\n  }\n\n  console.log(chalk.cyan('[EFC] Starting development server…'));\n  console.log(chalk.dim(`  Entry: ${entry}`));\n\n  const child = spawn(\n    'node',\n    ['--import', 'tsx/esm', '--watch', entry],\n    { stdio: 'inherit', env: { ...process.env, NODE_ENV: 'development' } },\n  );\n\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n\nfunction startProd(): void {\n  const cwd = process.cwd();\n  const distEntry = path.join(cwd, 'dist', 'index.js');\n\n  if (!fs.existsSync(distEntry)) {\n    console.error(chalk.red('[EFC] dist/index.js not found. Run `efc build prod` first.'));\n    process.exit(1);\n  }\n\n  console.log(chalk.cyan('[EFC] Starting production server…'));\n\n  const child = spawn('node', [distEntry], {\n    stdio: 'inherit',\n    env: { ...process.env, NODE_ENV: 'production' },\n  });\n\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n\nfunction resolveEntry(): string | null {\n  const cwd = process.cwd();\n  const candidates = [\n    path.join(cwd, 'src', 'index.ts'),\n    path.join(cwd, 'index.ts'),\n    path.join(cwd, 'src', 'index.js'),\n    path.join(cwd, 'index.js'),\n  ];\n  return candidates.find((f) => fs.existsSync(f)) ?? null;\n}\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\n\nexport function buildCommand(): Command {\n  const cmd = new Command('build');\n\n  cmd\n    .argument('<mode>', 'prod')\n    .description('Build the application for production')\n    .action((mode: string) => {\n      if (mode !== 'prod') {\n        console.error(chalk.red(`Unknown build mode: ${mode}. Use 'prod'.`));\n        process.exit(1);\n      }\n      buildProd();\n    });\n\n  return cmd;\n}\n\nfunction buildProd(): void {\n  console.log(chalk.cyan('[EFC] Building for production…'));\n\n  // Type-check first\n  const tsc = spawn('npx', ['tsc', '--noEmit'], { stdio: 'inherit' });\n\n  tsc.on('exit', (code) => {\n    if (code !== 0) {\n      console.error(chalk.red('[EFC] TypeScript errors found. Fix them before building.'));\n      process.exit(1);\n    }\n\n    const tsup = spawn('npx', ['tsup'], { stdio: 'inherit' });\n    tsup.on('exit', (tsupCode) => {\n      if (tsupCode === 0) {\n        console.log(chalk.green('[EFC] Build complete → dist/'));\n      } else {\n        process.exit(tsupCode ?? 1);\n      }\n    });\n  });\n}\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\n\nexport function runCommand(): Command {\n  const cmd = new Command('run');\n\n  cmd\n    .argument('<runner>', 'tests')\n    .description('Run EFC sub-commands (tests)')\n    .allowUnknownOption()\n    .action((runner: string) => {\n      if (runner === 'tests') {\n        runTests(cmd.args.slice(1));\n      } else {\n        console.error(chalk.red(`Unknown runner: ${runner}. Use 'tests'.`));\n        process.exit(1);\n      }\n    });\n\n  return cmd;\n}\n\nfunction runTests(extraArgs: string[]): void {\n  console.log(chalk.cyan('[EFC] Running tests via Vitest…'));\n  const child = spawn('npx', ['vitest', 'run', ...extraArgs], { stdio: 'inherit' });\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n","import { Command } from 'commander';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport chalk from 'chalk';\n\nexport function generateCommand(): Command {\n  const cmd = new Command('generate').alias('g').description('Scaffold EFC modules');\n\n  cmd\n    .command('route <routePath>')\n    .description('Scaffold a route module, e.g. users/[id]')\n    .action((routePath: string) => generateRoute(routePath));\n\n  cmd\n    .command('task <name>')\n    .description('Scaffold a background task module')\n    .action((name: string) => generateTask(name));\n\n  cmd\n    .command('middleware <name>')\n    .description('Scaffold a middleware module')\n    .action((name: string) => generateMiddleware(name));\n\n  return cmd;\n}\n\nfunction writeFile(filePath: string, content: string): void {\n  const dir = path.dirname(filePath);\n  fs.mkdirSync(dir, { recursive: true });\n  if (fs.existsSync(filePath)) {\n    console.error(chalk.red(`File already exists: ${filePath}`));\n    process.exit(1);\n  }\n  fs.writeFileSync(filePath, content, 'utf8');\n  console.log(chalk.green(`  created  ${path.relative(process.cwd(), filePath)}`));\n}\n\nfunction generateRoute(routePath: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'api', `${routePath}.ts`);\n\n  const content = `import type { Request, Response } from 'express';\n\nexport const GET = async (req: Request, res: Response) => {\n  res.json({ message: 'OK' });\n};\n\nexport const POST = async (req: Request, res: Response) => {\n  res.status(201).json({ message: 'Created' });\n};\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Route scaffolded`));\n}\n\nfunction generateTask(name: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'tasks', `${name}.ts`);\n\n  const content = `import { defineTask } from 'express-file-cluster/tasks';\n\ninterface ${name}Payload {\n  // TODO: define payload fields\n}\n\nexport default defineTask<${name}Payload>(async (payload) => {\n  // TODO: implement task logic\n  console.log('[Task:${name}]', payload);\n});\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Task scaffolded`));\n}\n\nfunction generateMiddleware(name: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'middlewares', `${name}.ts`);\n\n  const content = `import type { Request, Response, NextFunction } from 'express';\n\nexport function ${name}(req: Request, res: Response, next: NextFunction): void {\n  // TODO: implement middleware logic\n  next();\n}\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Middleware scaffolded`));\n}\n","import { Command } from 'commander';\nimport { scanDir } from '../../router/scan.js';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport chalk from 'chalk';\n\nexport function diagnosticsCommands(): Command[] {\n  return [routesCommand(), tasksCommand(), doctorCommand()];\n}\n\nfunction routesCommand(): Command {\n  return new Command('routes')\n    .description('Print the resolved route table')\n    .action(() => {\n      const apiDir = resolveApiDir();\n      if (!apiDir) {\n        console.error(chalk.red('[EFC] Could not find apiDir (expected src/api)'));\n        process.exit(1);\n      }\n\n      const routes = scanDir(apiDir);\n      if (routes.length === 0) {\n        console.log(chalk.yellow('No routes found.'));\n        return;\n      }\n\n      console.log(chalk.bold('\\n  Route Table\\n'));\n      console.log(chalk.dim('  ' + '─'.repeat(60)));\n      for (const route of routes) {\n        const rel = path.relative(process.cwd(), route.filePath);\n        console.log(`  ${chalk.cyan(route.urlPath.padEnd(35))} ${chalk.dim(rel)}`);\n      }\n      console.log(chalk.dim('  ' + '─'.repeat(60)));\n      console.log(chalk.dim(`\\n  ${routes.length} route(s) found\\n`));\n    });\n}\n\nfunction tasksCommand(): Command {\n  return new Command('tasks')\n    .description('List registered background tasks')\n    .action(() => {\n      const tasksDir = resolveTasksDir();\n      if (!tasksDir || !fs.existsSync(tasksDir)) {\n        console.log(chalk.yellow('No tasks directory found.'));\n        return;\n      }\n\n      const files = fs.readdirSync(tasksDir).filter((f) => /\\.(ts|js)$/.test(f));\n      if (files.length === 0) {\n        console.log(chalk.yellow('No tasks found.'));\n        return;\n      }\n\n      console.log(chalk.bold('\\n  Background Tasks\\n'));\n      for (const file of files) {\n        console.log(`  ${chalk.cyan(path.basename(file, path.extname(file)))}`);\n      }\n      console.log();\n    });\n}\n\nfunction doctorCommand(): Command {\n  return new Command('doctor')\n    .description('Validate config, env vars, and project setup')\n    .action(() => {\n      const cwd = process.cwd();\n      const checks: { label: string; ok: boolean; hint?: string }[] = [\n        {\n          label: 'package.json exists',\n          ok: fs.existsSync(path.join(cwd, 'package.json')),\n        },\n        {\n          label: 'tsconfig.json exists',\n          ok: fs.existsSync(path.join(cwd, 'tsconfig.json')),\n          hint: 'Run `tsc --init` to create one',\n        },\n        {\n          label: 'src/api directory exists',\n          ok: fs.existsSync(path.join(cwd, 'src', 'api')),\n          hint: 'Create src/api/ and add route files',\n        },\n        {\n          label: 'DATABASE_URL set',\n          ok: Boolean(process.env['DATABASE_URL']),\n          hint: 'Add DATABASE_URL to .env',\n        },\n        {\n          label: 'JWT_SECRET set',\n          ok: Boolean(process.env['JWT_SECRET']),\n          hint: 'Add JWT_SECRET to .env (generate: openssl rand -hex 64)',\n        },\n      ];\n\n      console.log(chalk.bold('\\n  EFC Doctor\\n'));\n      let allOk = true;\n      for (const check of checks) {\n        const icon = check.ok ? chalk.green('✓') : chalk.red('✗');\n        console.log(`  ${icon}  ${check.label}`);\n        if (!check.ok) {\n          allOk = false;\n          if (check.hint) console.log(chalk.dim(`       → ${check.hint}`));\n        }\n      }\n      console.log();\n      if (allOk) {\n        console.log(chalk.green('  All checks passed!\\n'));\n      } else {\n        console.log(chalk.yellow('  Some checks failed. Fix the issues above.\\n'));\n        process.exit(1);\n      }\n    });\n}\n\nfunction resolveApiDir(): string | null {\n  const cwd = process.cwd();\n  const candidates = [path.join(cwd, 'src', 'api'), path.join(cwd, 'api')];\n  return candidates.find((d) => fs.existsSync(d)) ?? null;\n}\n\nfunction resolveTasksDir(): string | null {\n  const cwd = process.cwd();\n  const candidates = [path.join(cwd, 'src', 'tasks'), path.join(cwd, 'tasks')];\n  return candidates.find((d) => fs.existsSync(d)) ?? null;\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\nfunction filePathToUrlPath(relativePath: string): string {\n  let p = relativePath.replace(ROUTE_FILE_RE, '');\n  // index files map to parent path\n  p = p.replace(/\\/index$/, '');\n  // [param] → :param\n  p = p.replace(DYNAMIC_SEGMENT_RE, ':$1');\n  return p === '' ? '/' : p.startsWith('/') ? p : `/${p}`;\n}\n\nfunction extractParams(relativePath: string): string[] {\n  const params: string[] = [];\n  let match: RegExpExecArray | null;\n  const re = new RegExp(DYNAMIC_SEGMENT_RE.source, 'g');\n  while ((match = re.exec(relativePath)) !== null) {\n    if (match[1]) params.push(match[1]);\n  }\n  return params;\n}\n\nexport function scanDir(dir: string, base: string = dir): RouteEntry[] {\n  if (!fs.existsSync(dir)) return [];\n\n  const entries: RouteEntry[] = [];\n  const items = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const item of items) {\n    const fullPath = path.join(dir, item.name);\n    if (item.isDirectory()) {\n      entries.push(...scanDir(fullPath, base));\n    } else if (ROUTE_FILE_RE.test(item.name)) {\n      const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n      entries.push({\n        urlPath: filePathToUrlPath(relative),\n        filePath: fullPath,\n        params: extractParams(relative),\n      });\n    }\n  }\n\n  // Sort: static routes before dynamic ones at each segment level\n  return entries.sort((a, b) => {\n    const aDynamic = a.urlPath.includes(':') ? 1 : 0;\n    const bDynamic = b.urlPath.includes(':') ? 1 : 0;\n    return aDynamic - bDynamic || a.urlPath.localeCompare(b.urlPath);\n  });\n}\n\nexport { filePathToUrlPath };\n"],"mappings":"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","names":["Command","Command","spawn","chalk","Command","spawn","chalk","Command","fs","path","chalk","Command","fs","path","path","fs","chalk","Command","Command"]}
+{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/commands/start.ts","../../src/cli/commands/build.ts","../../src/cli/commands/run.ts","../../src/cli/commands/generate.ts","../../src/cli/commands/diagnostics.ts","../../src/router/scan.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { startCommand } from './commands/start.js';\nimport { buildCommand } from './commands/build.js';\nimport { runCommand } from './commands/run.js';\nimport { generateCommand } from './commands/generate.js';\nimport { diagnosticsCommands } from './commands/diagnostics.js';\n\nconst program = new Command('efc')\n  .description('Express File Cluster CLI')\n  .version('0.1.0');\n\nprogram.addCommand(startCommand());\nprogram.addCommand(buildCommand());\nprogram.addCommand(runCommand());\nprogram.addCommand(generateCommand());\n\nfor (const cmd of diagnosticsCommands()) {\n  program.addCommand(cmd);\n}\n\nprogram.parse(process.argv);\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport chalk from 'chalk';\n\nexport function startCommand(): Command {\n  const cmd = new Command('start');\n\n  cmd\n    .argument('<mode>', 'dev | prod')\n    .description('Start the EFC server')\n    .action((mode: string) => {\n      if (mode === 'dev') {\n        startDev();\n      } else if (mode === 'prod') {\n        startProd();\n      } else {\n        console.error(chalk.red(`Unknown mode: ${mode}. Use 'dev' or 'prod'.`));\n        process.exit(1);\n      }\n    });\n\n  return cmd;\n}\n\nfunction buildDevEnv(cwd: string): NodeJS.ProcessEnv {\n  const env: NodeJS.ProcessEnv = { ...process.env, NODE_ENV: 'development' };\n  const envFile = path.join(cwd, '.env');\n  if (fs.existsSync(envFile)) {\n    const existing = (process.env['NODE_OPTIONS'] ?? '').trim();\n    env['NODE_OPTIONS'] = `${existing} --env-file ${envFile}`.trim();\n  }\n  return env;\n}\n\nfunction startDev(): void {\n  const entry = resolveEntry();\n  if (!entry) {\n    console.error(chalk.red('[EFC] Could not find entry point. Expected src/index.ts or index.ts'));\n    process.exit(1);\n  }\n\n  console.log(chalk.cyan('[EFC] Starting development server…'));\n  console.log(chalk.dim(`  Entry: ${entry}`));\n\n  const cwd = process.cwd();\n  const localTsx = path.join(cwd, 'node_modules', '.bin', 'tsx');\n  const tsx = fs.existsSync(localTsx) ? localTsx : 'tsx';\n\n  const child = spawn(tsx, ['watch', entry], {\n    stdio: 'inherit',\n    env: buildDevEnv(cwd),\n  });\n\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n\nfunction startProd(): void {\n  const cwd = process.cwd();\n  const distEntry = path.join(cwd, 'dist', 'index.js');\n\n  if (!fs.existsSync(distEntry)) {\n    console.error(chalk.red('[EFC] dist/index.js not found. Run `efc build prod` first.'));\n    process.exit(1);\n  }\n\n  console.log(chalk.cyan('[EFC] Starting production server…'));\n\n  const envFile = path.join(cwd, '.env');\n  const nodeArgs = fs.existsSync(envFile) ? ['--env-file', envFile, distEntry] : [distEntry];\n\n  const child = spawn('node', nodeArgs, {\n    stdio: 'inherit',\n    env: { ...process.env, NODE_ENV: 'production' },\n  });\n\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n\nfunction resolveEntry(): string | null {\n  const cwd = process.cwd();\n  const candidates = [\n    path.join(cwd, 'src', 'index.ts'),\n    path.join(cwd, 'index.ts'),\n    path.join(cwd, 'src', 'index.js'),\n    path.join(cwd, 'index.js'),\n  ];\n  return candidates.find((f) => fs.existsSync(f)) ?? null;\n}\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\n\nexport function buildCommand(): Command {\n  const cmd = new Command('build');\n\n  cmd\n    .argument('<mode>', 'prod')\n    .description('Build the application for production')\n    .action((mode: string) => {\n      if (mode !== 'prod') {\n        console.error(chalk.red(`Unknown build mode: ${mode}. Use 'prod'.`));\n        process.exit(1);\n      }\n      buildProd();\n    });\n\n  return cmd;\n}\n\nfunction buildProd(): void {\n  console.log(chalk.cyan('[EFC] Building for production…'));\n\n  // Type-check first\n  const tsc = spawn('npx', ['tsc', '--noEmit'], { stdio: 'inherit' });\n\n  tsc.on('exit', (code) => {\n    if (code !== 0) {\n      console.error(chalk.red('[EFC] TypeScript errors found. Fix them before building.'));\n      process.exit(1);\n    }\n\n    const tsup = spawn('npx', ['tsup'], { stdio: 'inherit' });\n    tsup.on('exit', (tsupCode) => {\n      if (tsupCode === 0) {\n        console.log(chalk.green('[EFC] Build complete → dist/'));\n      } else {\n        process.exit(tsupCode ?? 1);\n      }\n    });\n  });\n}\n","import { Command } from 'commander';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\n\nexport function runCommand(): Command {\n  const cmd = new Command('run');\n\n  cmd\n    .argument('<runner>', 'tests')\n    .description('Run EFC sub-commands (tests)')\n    .allowUnknownOption()\n    .action((runner: string) => {\n      if (runner === 'tests') {\n        runTests(cmd.args.slice(1));\n      } else {\n        console.error(chalk.red(`Unknown runner: ${runner}. Use 'tests'.`));\n        process.exit(1);\n      }\n    });\n\n  return cmd;\n}\n\nfunction runTests(extraArgs: string[]): void {\n  console.log(chalk.cyan('[EFC] Running tests via Vitest…'));\n  const child = spawn('npx', ['vitest', 'run', ...extraArgs], { stdio: 'inherit' });\n  child.on('exit', (code) => process.exit(code ?? 0));\n}\n","import { Command } from 'commander';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport chalk from 'chalk';\n\nexport function generateCommand(): Command {\n  const cmd = new Command('generate').alias('g').description('Scaffold EFC modules');\n\n  cmd\n    .command('route <routePath>')\n    .description('Scaffold a route module, e.g. users/[id]')\n    .action((routePath: string) => generateRoute(routePath));\n\n  cmd\n    .command('task <name>')\n    .description('Scaffold a background task module')\n    .action((name: string) => generateTask(name));\n\n  cmd\n    .command('middleware <name>')\n    .description('Scaffold a middleware module')\n    .action((name: string) => generateMiddleware(name));\n\n  return cmd;\n}\n\nfunction writeFile(filePath: string, content: string): void {\n  const dir = path.dirname(filePath);\n  fs.mkdirSync(dir, { recursive: true });\n  if (fs.existsSync(filePath)) {\n    console.error(chalk.red(`File already exists: ${filePath}`));\n    process.exit(1);\n  }\n  fs.writeFileSync(filePath, content, 'utf8');\n  console.log(chalk.green(`  created  ${path.relative(process.cwd(), filePath)}`));\n}\n\nfunction generateRoute(routePath: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'api', `${routePath}.ts`);\n\n  const content = `import type { Request, Response } from 'express';\n\nexport const GET = async (req: Request, res: Response) => {\n  res.json({ message: 'OK' });\n};\n\nexport const POST = async (req: Request, res: Response) => {\n  res.status(201).json({ message: 'Created' });\n};\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Route scaffolded`));\n}\n\nfunction generateTask(name: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'tasks', `${name}.ts`);\n\n  const content = `import { defineTask } from 'express-file-cluster/tasks';\n\ninterface ${name}Payload {\n  // TODO: define payload fields\n}\n\nexport default defineTask<${name}Payload>(async (payload) => {\n  // TODO: implement task logic\n  console.log('[Task:${name}]', payload);\n});\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Task scaffolded`));\n}\n\nfunction generateMiddleware(name: string): void {\n  const cwd = process.cwd();\n  const filePath = path.join(cwd, 'src', 'middlewares', `${name}.ts`);\n\n  const content = `import type { Request, Response, NextFunction } from 'express';\n\nexport function ${name}(req: Request, res: Response, next: NextFunction): void {\n  // TODO: implement middleware logic\n  next();\n}\n`;\n\n  writeFile(filePath, content);\n  console.log(chalk.cyan(`[EFC] Middleware scaffolded`));\n}\n","import { Command } from 'commander';\nimport { scanDir } from '../../router/scan.js';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport chalk from 'chalk';\n\nexport function diagnosticsCommands(): Command[] {\n  return [routesCommand(), tasksCommand(), doctorCommand()];\n}\n\nfunction routesCommand(): Command {\n  return new Command('routes')\n    .description('Print the resolved route table')\n    .action(() => {\n      const apiDir = resolveApiDir();\n      if (!apiDir) {\n        console.error(chalk.red('[EFC] Could not find apiDir (expected src/api)'));\n        process.exit(1);\n      }\n\n      const routes = scanDir(apiDir);\n      if (routes.length === 0) {\n        console.log(chalk.yellow('No routes found.'));\n        return;\n      }\n\n      console.log(chalk.bold('\\n  Route Table\\n'));\n      console.log(chalk.dim('  ' + '─'.repeat(60)));\n      for (const route of routes) {\n        const rel = path.relative(process.cwd(), route.filePath);\n        console.log(`  ${chalk.cyan(route.urlPath.padEnd(35))} ${chalk.dim(rel)}`);\n      }\n      console.log(chalk.dim('  ' + '─'.repeat(60)));\n      console.log(chalk.dim(`\\n  ${routes.length} route(s) found\\n`));\n    });\n}\n\nfunction tasksCommand(): Command {\n  return new Command('tasks')\n    .description('List registered background tasks')\n    .action(() => {\n      const tasksDir = resolveTasksDir();\n      if (!tasksDir || !fs.existsSync(tasksDir)) {\n        console.log(chalk.yellow('No tasks directory found.'));\n        return;\n      }\n\n      const files = fs.readdirSync(tasksDir).filter((f) => /\\.(ts|js)$/.test(f));\n      if (files.length === 0) {\n        console.log(chalk.yellow('No tasks found.'));\n        return;\n      }\n\n      console.log(chalk.bold('\\n  Background Tasks\\n'));\n      for (const file of files) {\n        console.log(`  ${chalk.cyan(path.basename(file, path.extname(file)))}`);\n      }\n      console.log();\n    });\n}\n\nfunction doctorCommand(): Command {\n  return new Command('doctor')\n    .description('Validate config, env vars, and project setup')\n    .action(() => {\n      const cwd = process.cwd();\n      const checks: { label: string; ok: boolean; hint?: string }[] = [\n        {\n          label: 'package.json exists',\n          ok: fs.existsSync(path.join(cwd, 'package.json')),\n        },\n        {\n          label: 'tsconfig.json exists',\n          ok: fs.existsSync(path.join(cwd, 'tsconfig.json')),\n          hint: 'Run `tsc --init` to create one',\n        },\n        {\n          label: 'src/api directory exists',\n          ok: fs.existsSync(path.join(cwd, 'src', 'api')),\n          hint: 'Create src/api/ and add route files',\n        },\n        {\n          label: 'DATABASE_URL set',\n          ok: Boolean(process.env['DATABASE_URL']),\n          hint: 'Add DATABASE_URL to .env',\n        },\n        {\n          label: 'JWT_SECRET set',\n          ok: Boolean(process.env['JWT_SECRET']),\n          hint: 'Add JWT_SECRET to .env (generate: openssl rand -hex 64)',\n        },\n      ];\n\n      console.log(chalk.bold('\\n  EFC Doctor\\n'));\n      let allOk = true;\n      for (const check of checks) {\n        const icon = check.ok ? chalk.green('✓') : chalk.red('✗');\n        console.log(`  ${icon}  ${check.label}`);\n        if (!check.ok) {\n          allOk = false;\n          if (check.hint) console.log(chalk.dim(`       → ${check.hint}`));\n        }\n      }\n      console.log();\n      if (allOk) {\n        console.log(chalk.green('  All checks passed!\\n'));\n      } else {\n        console.log(chalk.yellow('  Some checks failed. Fix the issues above.\\n'));\n        process.exit(1);\n      }\n    });\n}\n\nfunction resolveApiDir(): string | null {\n  const cwd = process.cwd();\n  const candidates = [path.join(cwd, 'src', 'api'), path.join(cwd, 'api')];\n  return candidates.find((d) => fs.existsSync(d)) ?? null;\n}\n\nfunction resolveTasksDir(): string | null {\n  const cwd = process.cwd();\n  const candidates = [path.join(cwd, 'src', 'tasks'), path.join(cwd, 'tasks')];\n  return candidates.find((d) => fs.existsSync(d)) ?? null;\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\nfunction filePathToUrlPath(relativePath: string): string {\n  let p = relativePath.replace(ROUTE_FILE_RE, '');\n  // index files map to parent path\n  p = p.replace(/\\/index$/, '');\n  // [param] → :param\n  p = p.replace(DYNAMIC_SEGMENT_RE, ':$1');\n  return p === '' ? '/' : p.startsWith('/') ? p : `/${p}`;\n}\n\nfunction extractParams(relativePath: string): string[] {\n  const params: string[] = [];\n  let match: RegExpExecArray | null;\n  const re = new RegExp(DYNAMIC_SEGMENT_RE.source, 'g');\n  while ((match = re.exec(relativePath)) !== null) {\n    if (match[1]) params.push(match[1]);\n  }\n  return params;\n}\n\nexport function scanDir(dir: string, base: string = dir): RouteEntry[] {\n  if (!fs.existsSync(dir)) return [];\n\n  const entries: RouteEntry[] = [];\n  const items = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const item of items) {\n    const fullPath = path.join(dir, item.name);\n    if (item.isDirectory()) {\n      entries.push(...scanDir(fullPath, base));\n    } else if (ROUTE_FILE_RE.test(item.name)) {\n      const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n      entries.push({\n        urlPath: filePathToUrlPath(relative),\n        filePath: fullPath,\n        params: extractParams(relative),\n      });\n    }\n  }\n\n  // Sort: static routes before dynamic ones at each segment level\n  return entries.sort((a, b) => {\n    const aDynamic = a.urlPath.includes(':') ? 1 : 0;\n    const bDynamic = b.urlPath.includes(':') ? 1 : 0;\n    return aDynamic - bDynamic || a.urlPath.localeCompare(b.urlPath);\n  });\n}\n\nexport { filePathToUrlPath };\n"],"mappings":"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","names":["Command","Command","spawn","chalk","Command","spawn","chalk","Command","fs","path","chalk","Command","fs","path","path","fs","chalk","Command","Command"]}

package/dist/index.cjs

@@ -40,7 +40,9 @@ __export(src_exports, {
   setDbClient: () => setDbClient
 });
 module.exports = __toCommonJS(src_exports);
+var import_config = require("dotenv/config");
 var import_express = __toESM(require("express"), 1);
+var import_cors = __toESM(require("cors"), 1);
 var import_cookie_parser = __toESM(require("cookie-parser"), 1);
 var import_node_cluster2 = __toESM(require("cluster"), 1);
 var import_node_os2 = __toESM(require("os"), 1);
@@ -453,7 +455,7 @@ function compose(...handlers) {
 // src/index.ts
 async function ignite(config) {
   const {
-    port = 3e3,
+    port: _port,
     cluster: clusterEnabled = true,
     workers,
     apiDir,
@@ -464,6 +466,7 @@ async function ignite(config) {
     onWorkerCrash,
     onError
   } = config;
+  const port = _port != null && !Number.isNaN(_port) ? _port : Number(process.env["PORT"]) || 3e3;
   if (clusterEnabled && import_node_cluster2.default.isPrimary) {
     runMaster({
       workers: workers ?? import_node_os2.default.cpus().length,
@@ -473,6 +476,21 @@ async function ignite(config) {
     return;
   }
   const app = (0, import_express.default)();
+  const corsOption = config.cors ?? true;
+  if (corsOption !== false) {
+    const envOrigins = process.env["CORS_ORIGINS"];
+    let origin;
+    if (envOrigins) {
+      const list = envOrigins.split(",").map((o) => o.trim()).filter(Boolean);
+      origin = list.length === 1 ? list[0] : list;
+    } else if (typeof corsOption === "object" && corsOption.origin !== void 0) {
+      origin = corsOption.origin;
+    } else {
+      origin = true;
+    }
+    const corsOpts = typeof corsOption === "object" ? { ...corsOption, origin } : { origin };
+    app.use((0, import_cors.default)(corsOpts));
+  }
   app.use(import_express.default.json());
   app.use(import_express.default.urlencoded({ extended: true }));
   app.use((0, import_cookie_parser.default)());

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/router/scan.ts","../src/router/mount.ts","../src/cluster/index.ts","../src/auth/index.ts","../src/errors.ts","../src/db/mongo.ts","../src/db/model.ts","../src/db/index.ts","../src/tasks/scanner.ts","../src/tasks/index.ts","../src/tasks/thread-runner.ts","../src/tasks/bullmq-backend.ts","../src/compose.ts"],"sourcesContent":["import express from 'express';\nimport cookieParser from 'cookie-parser';\nimport cluster from 'node:cluster';\nimport os from 'node:os';\nimport type { EFCConfig } from './types.js';\nimport { scanDir } from './router/scan.js';\nimport { mountRoutes } from './router/mount.js';\nimport { runMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { HttpError } from './errors.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { scanTasks } from './tasks/scanner.js';\nimport { initBullMQ } from './tasks/bullmq-backend.js';\n\nexport async function ignite(config: EFCConfig): Promise<void> {\n  const {\n    port = 3000,\n    cluster: clusterEnabled = true,\n    workers,\n    apiDir,\n    jwtSecret,\n    authStrategy = 'http-only',\n    globalMiddlewares = [],\n    onWorkerReady,\n    onWorkerCrash,\n    onError,\n  } = config;\n\n  if (clusterEnabled && cluster.isPrimary) {\n    runMaster({\n      workers: workers ?? os.cpus().length,\n      ...(onWorkerReady !== undefined && { onWorkerReady }),\n      ...(onWorkerCrash !== undefined && { onWorkerCrash }),\n    });\n    return;\n  }\n\n  const app = express();\n\n  app.use(express.json());\n  app.use(express.urlencoded({ extended: true }));\n  app.use(cookieParser());\n\n  for (const mw of globalMiddlewares) {\n    app.use(mw);\n  }\n\n  // Pre-Flight step 1: Connect database\n  if (config.database === 'mongodb' && config.databaseUrl) {\n    const conn = await connectMongo(config.databaseUrl);\n    setDbClient(conn as unknown as Record<string, unknown>);\n  }\n\n  // Pre-Flight step 2: Configure auth\n  if (jwtSecret) {\n    const cookieDomain = process.env['COOKIE_DOMAIN'];\n    configureAuth({\n      secret: jwtSecret,\n      strategy: authStrategy,\n      expiresIn: process.env['JWT_EXPIRES_IN'] ?? '7d',\n      ...(cookieDomain !== undefined && { cookieDomain }),\n    });\n  }\n\n  // Pre-Flight step 3: Scan and register tasks\n  if (config.tasksDir) {\n    await scanTasks(config.tasksDir);\n  }\n\n  // Pre-Flight step 4: Start task queue backend\n  if (config.tasks) {\n    if (config.tasks.backend === 'bullmq') {\n      await initBullMQ({\n        redisUrl: config.tasks.redisUrl ?? 'redis://localhost:6379',\n        concurrency: config.tasks.concurrency ?? 5,\n      });\n    }\n  }\n\n  // Pre-Flight step 5: Scan routes and mount\n  const routes = scanDir(apiDir);\n  await mountRoutes(app, routes);\n\n  if (onError) {\n    app.use(onError);\n  } else {\n    app.use(\n      (\n        err: unknown,\n        _req: express.Request,\n        res: express.Response,\n        _next: express.NextFunction,\n      ) => {\n        if (err instanceof HttpError) {\n          res.status(err.statusCode).json({ error: err.message, statusCode: err.statusCode });\n        } else {\n          console.error('[EFC] Unhandled error:', err);\n          res.status(500).json({ error: 'Internal Server Error', statusCode: 500 });\n        }\n      },\n    );\n  }\n\n  await new Promise<void>((resolve) => {\n    app.listen(port, () => {\n      const wid = (cluster.worker as { id: number } | undefined)?.id ?? 'primary';\n      console.log(`[EFC] Worker ${wid} listening on :${port}`);\n      resolve();\n    });\n  });\n}\n\nexport { HttpError } from './errors.js';\nexport { compose } from './compose.js';\nexport { db, setDbClient, getDbClient, defineModel } from './db/index.js';\nexport { scanDir } from './router/scan.js';\nexport type {\n  EFCConfig,\n  RouteEntry,\n  TaskOptions,\n  TaskDefinition,\n  DatabaseEngine,\n  AuthStrategy,\n  ModelSchema,\n  ModelCRUD,\n} from './types.js';\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\nfunction filePathToUrlPath(relativePath: string): string {\n  let p = relativePath.replace(ROUTE_FILE_RE, '');\n  // index files map to parent path\n  p = p.replace(/\\/index$/, '');\n  // [param] → :param\n  p = p.replace(DYNAMIC_SEGMENT_RE, ':$1');\n  return p === '' ? '/' : p.startsWith('/') ? p : `/${p}`;\n}\n\nfunction extractParams(relativePath: string): string[] {\n  const params: string[] = [];\n  let match: RegExpExecArray | null;\n  const re = new RegExp(DYNAMIC_SEGMENT_RE.source, 'g');\n  while ((match = re.exec(relativePath)) !== null) {\n    if (match[1]) params.push(match[1]);\n  }\n  return params;\n}\n\nexport function scanDir(dir: string, base: string = dir): RouteEntry[] {\n  if (!fs.existsSync(dir)) return [];\n\n  const entries: RouteEntry[] = [];\n  const items = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const item of items) {\n    const fullPath = path.join(dir, item.name);\n    if (item.isDirectory()) {\n      entries.push(...scanDir(fullPath, base));\n    } else if (ROUTE_FILE_RE.test(item.name)) {\n      const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n      entries.push({\n        urlPath: filePathToUrlPath(relative),\n        filePath: fullPath,\n        params: extractParams(relative),\n      });\n    }\n  }\n\n  // Sort: static routes before dynamic ones at each segment level\n  return entries.sort((a, b) => {\n    const aDynamic = a.urlPath.includes(':') ? 1 : 0;\n    const bDynamic = b.urlPath.includes(':') ? 1 : 0;\n    return aDynamic - bDynamic || a.urlPath.localeCompare(b.urlPath);\n  });\n}\n\nexport { filePathToUrlPath };\n","import type { Application, RequestHandler } from 'express';\nimport type { RouteEntry } from '../types.js';\n\nconst HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'] as const;\ntype HttpMethod = (typeof HTTP_METHODS)[number];\n\nfunction asyncWrap(handler: RequestHandler): RequestHandler {\n  return (req, res, next) => {\n    Promise.resolve(handler(req, res, next)).catch(next);\n  };\n}\n\nexport async function mountRoutes(app: Application, routes: RouteEntry[]): Promise<void> {\n  for (const route of routes) {\n    const mod = (await import(route.filePath)) as Record<string, unknown>;\n    const routeMiddlewares: RequestHandler[] = Array.isArray(mod['middlewares'])\n      ? (mod['middlewares'] as RequestHandler[])\n      : [];\n\n    const implemented: HttpMethod[] = [];\n    const unimplemented: HttpMethod[] = [];\n\n    for (const method of HTTP_METHODS) {\n      if (typeof mod[method] === 'function') {\n        implemented.push(method);\n        app[method.toLowerCase() as Lowercase<HttpMethod>](\n          route.urlPath,\n          ...routeMiddlewares,\n          asyncWrap(mod[method] as RequestHandler),\n        );\n      } else {\n        unimplemented.push(method);\n      }\n    }\n\n    if (implemented.length > 0 && unimplemented.length > 0) {\n      const allowHeader = implemented.join(', ');\n      app.all(route.urlPath, (req, res, next) => {\n        if ((unimplemented as string[]).includes(req.method)) {\n          res.set('Allow', allowHeader).status(405).json({ error: 'Method Not Allowed' });\n        } else {\n          next();\n        }\n      });\n    }\n  }\n}\n\nexport { asyncWrap };\n","import cluster from 'node:cluster';\nimport os from 'node:os';\n\ninterface ClusterOptions {\n  workers?: number;\n  onWorkerReady?: ((id: number) => void) | undefined;\n  onWorkerCrash?: ((id: number, code: number) => void) | undefined;\n}\n\nexport function runMaster(options: ClusterOptions = {}): void {\n  const count = options.workers ?? os.cpus().length;\n\n  console.log(`[EFC] Primary ${process.pid} starting ${count} workers`);\n\n  for (let i = 0; i < count; i++) {\n    cluster.fork();\n  }\n\n  cluster.on('online', (worker) => {\n    options.onWorkerReady?.(worker.id);\n  });\n\n  cluster.on('exit', (worker, code, signal) => {\n    const exitCode = code ?? (signal ? -1 : 0);\n    console.warn(`[EFC] Worker ${worker.id} exited (code=${exitCode}), respawning…`);\n    options.onWorkerCrash?.(worker.id, exitCode);\n    cluster.fork();\n  });\n}\n\nexport { cluster };\n","import type { RequestHandler, Response } from 'express';\nimport jwt from 'jsonwebtoken';\nimport type { AuthStrategy } from '../types.js';\n\ninterface AuthConfig {\n  secret: string;\n  strategy: AuthStrategy;\n  expiresIn: string;\n  cookieDomain?: string | undefined;\n}\n\nlet _config: AuthConfig | null = null;\n\nexport function configureAuth(config: AuthConfig): void {\n  _config = config;\n}\n\nfunction getConfig(): AuthConfig {\n  if (!_config) throw new Error('[EFC] Auth not configured — pass jwtSecret to ignite()');\n  return _config;\n}\n\nexport function issueToken(res: Response, payload: Record<string, unknown>): void {\n  const { secret, expiresIn, cookieDomain } = getConfig();\n  // expiresIn is a plain string (e.g. '7d'); cast satisfies jwt's branded StringValue\n  const token = jwt.sign(payload, secret, { expiresIn: expiresIn as jwt.SignOptions['expiresIn'] & string });\n  res.cookie('efc_token', token, {\n    httpOnly: true,\n    secure: process.env['NODE_ENV'] === 'production',\n    sameSite: 'strict',\n    ...(cookieDomain !== undefined && { domain: cookieDomain }),\n  });\n}\n\nexport function revokeToken(res: Response): void {\n  res.clearCookie('efc_token');\n}\n\nexport function signToken(payload: Record<string, unknown>): string {\n  const { secret, expiresIn } = getConfig();\n  return jwt.sign(payload, secret, { expiresIn: expiresIn as jwt.SignOptions['expiresIn'] & string });\n}\n\nexport const requireAuth: RequestHandler = (req, res, next) => {\n  const { secret, strategy } = getConfig();\n\n  try {\n    let token: string | undefined;\n\n    if (strategy === 'http-only') {\n      const cookies = (req as typeof req & { cookies: Record<string, string> }).cookies;\n      token = cookies['efc_token'];\n    } else {\n      const auth = req.headers['authorization'];\n      if (typeof auth === 'string' && auth.startsWith('Bearer ')) {\n        token = auth.slice(7);\n      }\n    }\n\n    if (!token) {\n      res.status(401).json({ error: 'Unauthorized' });\n      return;\n    }\n\n    const decoded = jwt.verify(token, secret);\n    (req as typeof req & { user: unknown }).user = decoded;\n    next();\n  } catch {\n    res.status(401).json({ error: 'Unauthorized' });\n  }\n};\n","export class HttpError extends Error {\n  readonly statusCode: number;\n\n  constructor(statusCode: number, message: string) {\n    super(message);\n    this.name = 'HttpError';\n    this.statusCode = statusCode;\n    Error.captureStackTrace(this, HttpError);\n  }\n}\n","// Wraps mongoose connection for Pre-Flight. Throws clearly if mongoose isn't installed.\n\nlet mongoose: typeof import('mongoose');\n\nasync function loadMongoose(): Promise<typeof import('mongoose')> {\n  if (mongoose) return mongoose;\n  try {\n    mongoose = await import('mongoose');\n    return mongoose;\n  } catch {\n    throw new Error(\n      '[EFC] mongoose is not installed. Run: npm install mongoose',\n    );\n  }\n}\n\nexport async function connectMongo(url: string): Promise<import('mongoose').Connection> {\n  const mg = await loadMongoose();\n  await mg.connect(url);\n  console.log('[EFC] MongoDB connected');\n  return mg.connection;\n}\n","import type { ModelSchema, ModelCRUD } from '../types.js';\n\ntype AnyRecord = Record<string, unknown> & { id: string };\n\nfunction normalise(doc: Record<string, unknown>): AnyRecord {\n  const id = doc['_id'] ? String(doc['_id']) : '';\n  return { ...doc, id } as AnyRecord;\n}\n\nasync function getModel(name: string, schemaObj: Record<string, unknown>): Promise<import('mongoose').Model<Record<string, unknown>>> {\n  let mg: typeof import('mongoose');\n  try {\n    mg = await import('mongoose');\n  } catch {\n    throw new Error('[EFC] mongoose is not installed. Run: npm install mongoose');\n  }\n\n  if (mg.models[name]) return mg.models[name] as import('mongoose').Model<Record<string, unknown>>;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const schema = new mg.Schema(schemaObj as any, { timestamps: true });\n  return mg.model<Record<string, unknown>>(name, schema);\n}\n\nfunction buildMongooseSchema(schema: ModelSchema): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, def] of Object.entries(schema)) {\n    const entry: Record<string, unknown> = {};\n    switch (def.type) {\n      case 'string':   entry['type'] = String; break;\n      case 'number':   entry['type'] = Number; break;\n      case 'boolean':  entry['type'] = Boolean; break;\n      case 'date':     entry['type'] = Date; break;\n      case 'object':   entry['type'] = Object; break;\n      case 'array':    entry['type'] = Array; break;\n    }\n    if (def.required !== undefined) entry['required'] = def.required;\n    if (def.unique !== undefined)   entry['unique'] = def.unique;\n    if (def.default !== undefined)  entry['default'] = def.default;\n    out[key] = entry;\n  }\n  return out;\n}\n\nexport function defineModel<T extends Record<string, unknown>>(\n  name: string,\n  schema: ModelSchema,\n): ModelCRUD<T> {\n  const mongooseSchema = buildMongooseSchema(schema);\n\n  return {\n    async find(filter = {}) {\n      const M = await getModel(name, mongooseSchema);\n      const docs = await M.find(filter as Record<string, unknown>).lean();\n      return (docs as Record<string, unknown>[]).map(normalise) as (T & { id: string })[];\n    },\n\n    async findById(id) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findById(id).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async findOne(filter) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findOne(filter as Record<string, unknown>).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async create(data) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.create(data);\n      return normalise(doc.toObject() as Record<string, unknown>) as T & { id: string };\n    },\n\n    async update(id, data) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findByIdAndUpdate(id, data, { new: true }).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async delete(id) {\n      const M = await getModel(name, mongooseSchema);\n      await M.findByIdAndDelete(id);\n    },\n\n    async count(filter = {}) {\n      const M = await getModel(name, mongooseSchema);\n      return M.countDocuments(filter as Record<string, unknown>);\n    },\n  };\n}\n","// Thread-local DB client populated during Pre-Flight.\n// The Proxy ensures callers import `db` once and never null-check it —\n// it throws with a helpful message if accessed before Pre-Flight completes.\n\ntype AnyClient = Record<string, unknown>;\n\nlet _client: AnyClient | null = null;\n\nexport function setDbClient(client: AnyClient): void {\n  _client = client;\n}\n\nexport function getDbClient(): AnyClient {\n  if (!_client) {\n    throw new Error('[EFC] db not ready — accessed before Pre-Flight completed');\n  }\n  return _client;\n}\n\nexport const db: AnyClient = new Proxy({} as AnyClient, {\n  get(_target, prop: string) {\n    return getDbClient()[prop];\n  },\n  set(_target, prop: string, value: unknown) {\n    getDbClient()[prop] = value;\n    return true;\n  },\n});\n\nexport { connectMongo } from './mongo.js';\nexport { defineModel } from './model.js';\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { registerTask } from './index.js';\nimport type { TaskDefinition } from '../types.js';\n\nexport async function scanTasks(tasksDir: string): Promise<void> {\n  if (!fs.existsSync(tasksDir)) return;\n\n  const files = fs.readdirSync(tasksDir).filter((f) => /\\.(ts|js|mts|mjs)$/.test(f));\n\n  for (const file of files) {\n    const filePath = path.join(tasksDir, file);\n    const taskName = path.basename(file, path.extname(file));\n\n    try {\n      const mod = await import(filePath) as Record<string, unknown>;\n      const def = mod['default'] as TaskDefinition | undefined;\n\n      if (!def || typeof def.handler !== 'function') {\n        console.warn(`[EFC] Task file ${file} has no valid default export — skipping`);\n        continue;\n      }\n\n      registerTask(taskName, { ...def, filePath });\n      console.log(`[EFC] Registered task: ${taskName}`);\n    } catch (err) {\n      console.warn(`[EFC] Failed to load task ${file}:`, err);\n    }\n  }\n}\n","import type { TaskDefinition, TaskOptions } from '../types.js';\n\nexport const taskRegistry = new Map<string, TaskDefinition>();\n\ntype HandlerFn<T> = (payload: T) => Promise<void>;\ntype DefineTaskOverload = {\n  <T>(handler: HandlerFn<T>): TaskDefinition<T>;\n  <T>(options: TaskOptions, handler: HandlerFn<T>): TaskDefinition<T>;\n};\n\nexport const defineTask: DefineTaskOverload = <T>(\n  handlerOrOptions: HandlerFn<T> | TaskOptions,\n  maybeHandler?: HandlerFn<T>,\n): TaskDefinition<T> => {\n  let options: TaskOptions = {};\n  let handler: HandlerFn<T>;\n\n  if (typeof handlerOrOptions === 'function') {\n    handler = handlerOrOptions;\n  } else {\n    options = handlerOrOptions;\n    if (!maybeHandler) throw new Error('[EFC] defineTask: handler function is required');\n    handler = maybeHandler;\n  }\n\n  return {\n    handler: handler as (payload: unknown) => Promise<void>,\n    options,\n    name: '',\n  };\n};\n\ntype EnqueueImpl = (name: string, payload: unknown) => Promise<void>;\nlet _impl: EnqueueImpl | null = null;\n\nexport function setEnqueueImpl(impl: EnqueueImpl): void {\n  _impl = impl;\n}\n\nexport async function enqueue<T>(name: string, payload: T): Promise<void> {\n  if (!_impl) {\n    throw new Error(\n      `[EFC] Task queue not initialised. Set tasks.backend in ignite() config.`,\n    );\n  }\n  return _impl(name, payload as unknown);\n}\n\nexport function registerTask(name: string, def: TaskDefinition): void {\n  taskRegistry.set(name, { ...def, name });\n}\n","import { Worker, workerData, parentPort, isMainThread } from 'node:worker_threads';\nimport type { TaskDefinition } from '../types.js';\n\n// ── Worker-thread side ────────────────────────────────────────────────────────\nif (!isMainThread) {\n  const { handlerPath, payload } = workerData as { handlerPath: string; payload: unknown };\n\n  (async () => {\n    try {\n      const mod = await import(handlerPath) as Record<string, unknown>;\n      const def = mod['default'] as TaskDefinition | undefined;\n      if (!def || typeof def.handler !== 'function') {\n        throw new Error(`[EFC] Thread runner: no valid task export in ${handlerPath}`);\n      }\n      await def.handler(payload);\n      parentPort?.postMessage({ ok: true });\n    } catch (err) {\n      parentPort?.postMessage({ ok: false, error: String(err) });\n    }\n  })();\n}\n\n// ── Main-thread side ──────────────────────────────────────────────────────────\nexport function runInThread(handlerPath: string, payload: unknown): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const worker = new Worker(new URL('./thread-runner.js', import.meta.url), {\n      workerData: { handlerPath, payload },\n    });\n\n    worker.on('message', (msg: { ok: boolean; error?: string }) => {\n      if (msg.ok) resolve();\n      else reject(new Error(msg.error ?? 'Thread task failed'));\n    });\n\n    worker.on('error', reject);\n    worker.on('exit', (code) => {\n      if (code !== 0) reject(new Error(`Thread worker exited with code ${code}`));\n    });\n  });\n}\n","import type { Job } from 'bullmq';\nimport { taskRegistry, setEnqueueImpl } from './index.js';\nimport { runInThread } from './thread-runner.js';\n\ninterface BullMQOpts {\n  redisUrl: string;\n  concurrency: number;\n}\n\nexport async function initBullMQ(opts: BullMQOpts): Promise<void> {\n  let bullmq: typeof import('bullmq');\n  try {\n    bullmq = await import('bullmq');\n  } catch {\n    throw new Error('[EFC] bullmq is not installed. Run: npm install bullmq');\n  }\n\n  const connection = parseRedisUrl(opts.redisUrl);\n  const queue = new bullmq.Queue('efc', { connection });\n\n  const worker = new bullmq.Worker(\n    'efc',\n    async (job: Job) => {\n      const def = taskRegistry.get(job.name);\n      if (!def) {\n        throw new Error(`[EFC] No task registered for name: ${job.name}`);\n      }\n\n      if (def.options.thread && def.filePath) {\n        await runInThread(def.filePath, job.data);\n      } else {\n        await def.handler(job.data);\n      }\n    },\n    { connection, concurrency: opts.concurrency },\n  );\n\n  worker.on('failed', (job: Job | undefined, err: Error) => {\n    console.error(`[EFC] Task ${job?.name ?? 'unknown'} failed:`, err.message);\n  });\n\n  worker.on('completed', (job: Job) => {\n    console.log(`[EFC] Task ${job.name} completed (id=${job.id})`);\n  });\n\n  setEnqueueImpl(async (name, payload) => {\n    const def = taskRegistry.get(name);\n    if (!def) {\n      throw new Error(`[EFC] Cannot enqueue unknown task: \"${name}\". Is the task file in tasksDir?`);\n    }\n\n    await queue.add(name, payload, {\n      attempts: def.options.retries ?? 3,\n      backoff: {\n        type: def.options.backoff ?? 'exponential',\n        delay: 1000,\n      },\n    });\n  });\n\n  console.log('[EFC] BullMQ backend initialised');\n}\n\nfunction parseRedisUrl(url: string): { host: string; port: number; password?: string } {\n  try {\n    const u = new URL(url);\n    const result: { host: string; port: number; password?: string } = {\n      host: u.hostname || 'localhost',\n      port: parseInt(u.port || '6379', 10),\n    };\n    if (u.password) result.password = u.password;\n    return result;\n  } catch {\n    return { host: 'localhost', port: 6379 };\n  }\n}\n","import type { RequestHandler } from 'express';\n\nexport function compose(...handlers: RequestHandler[]): RequestHandler {\n  return (req, res, next) => {\n    let index = 0;\n\n    function dispatch(i: number): void {\n      if (i >= handlers.length) {\n        next();\n        return;\n      }\n      const handler = handlers[i];\n      if (!handler) {\n        next();\n        return;\n      }\n      try {\n        Promise.resolve(handler(req, res, () => dispatch(i + 1))).catch(next);\n      } catch (err) {\n        next(err);\n      }\n    }\n\n    dispatch(index);\n  };\n}\n"],"mappings":"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","names":["import_node_cluster","import_node_os","fs","path","os","cluster","import_node_fs","import_node_path","fs","path","cluster","os","express","cookieParser"]}
+{"version":3,"sources":["../src/index.ts","../src/router/scan.ts","../src/router/mount.ts","../src/cluster/index.ts","../src/auth/index.ts","../src/errors.ts","../src/db/mongo.ts","../src/db/model.ts","../src/db/index.ts","../src/tasks/scanner.ts","../src/tasks/index.ts","../src/tasks/thread-runner.ts","../src/tasks/bullmq-backend.ts","../src/compose.ts"],"sourcesContent":["import 'dotenv/config';\nimport express from 'express';\nimport cors from 'cors';\nimport cookieParser from 'cookie-parser';\nimport cluster from 'node:cluster';\nimport os from 'node:os';\nimport type { EFCConfig } from './types.js';\nimport { scanDir } from './router/scan.js';\nimport { mountRoutes } from './router/mount.js';\nimport { runMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { HttpError } from './errors.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { scanTasks } from './tasks/scanner.js';\nimport { initBullMQ } from './tasks/bullmq-backend.js';\n\nexport async function ignite(config: EFCConfig): Promise<void> {\n  const {\n    port: _port,\n    cluster: clusterEnabled = true,\n    workers,\n    apiDir,\n    jwtSecret,\n    authStrategy = 'http-only',\n    globalMiddlewares = [],\n    onWorkerReady,\n    onWorkerCrash,\n    onError,\n  } = config;\n\n  const port =\n    _port != null && !Number.isNaN(_port)\n      ? _port\n      : Number(process.env['PORT']) || 3000;\n\n  if (clusterEnabled && cluster.isPrimary) {\n    runMaster({\n      workers: workers ?? os.cpus().length,\n      ...(onWorkerReady !== undefined && { onWorkerReady }),\n      ...(onWorkerCrash !== undefined && { onWorkerCrash }),\n    });\n    return;\n  }\n\n  const app = express();\n\n  const corsOption = config.cors ?? true;\n  if (corsOption !== false) {\n    const envOrigins = process.env['CORS_ORIGINS'];\n    let origin: string | string[] | boolean;\n    if (envOrigins) {\n      const list = envOrigins.split(',').map((o) => o.trim()).filter(Boolean);\n      origin = list.length === 1 ? list[0]! : list;\n    } else if (typeof corsOption === 'object' && corsOption.origin !== undefined) {\n      origin = corsOption.origin;\n    } else {\n      origin = true;\n    }\n    const corsOpts = typeof corsOption === 'object' ? { ...corsOption, origin } : { origin };\n    app.use(cors(corsOpts));\n  }\n\n  app.use(express.json());\n  app.use(express.urlencoded({ extended: true }));\n  app.use(cookieParser());\n\n  for (const mw of globalMiddlewares) {\n    app.use(mw);\n  }\n\n  // Pre-Flight step 1: Connect database\n  if (config.database === 'mongodb' && config.databaseUrl) {\n    const conn = await connectMongo(config.databaseUrl);\n    setDbClient(conn as unknown as Record<string, unknown>);\n  }\n\n  // Pre-Flight step 2: Configure auth\n  if (jwtSecret) {\n    const cookieDomain = process.env['COOKIE_DOMAIN'];\n    configureAuth({\n      secret: jwtSecret,\n      strategy: authStrategy,\n      expiresIn: process.env['JWT_EXPIRES_IN'] ?? '7d',\n      ...(cookieDomain !== undefined && { cookieDomain }),\n    });\n  }\n\n  // Pre-Flight step 3: Scan and register tasks\n  if (config.tasksDir) {\n    await scanTasks(config.tasksDir);\n  }\n\n  // Pre-Flight step 4: Start task queue backend\n  if (config.tasks) {\n    if (config.tasks.backend === 'bullmq') {\n      await initBullMQ({\n        redisUrl: config.tasks.redisUrl ?? 'redis://localhost:6379',\n        concurrency: config.tasks.concurrency ?? 5,\n      });\n    }\n  }\n\n  // Pre-Flight step 5: Scan routes and mount\n  const routes = scanDir(apiDir);\n  await mountRoutes(app, routes);\n\n  if (onError) {\n    app.use(onError);\n  } else {\n    app.use(\n      (\n        err: unknown,\n        _req: express.Request,\n        res: express.Response,\n        _next: express.NextFunction,\n      ) => {\n        if (err instanceof HttpError) {\n          res.status(err.statusCode).json({ error: err.message, statusCode: err.statusCode });\n        } else {\n          console.error('[EFC] Unhandled error:', err);\n          res.status(500).json({ error: 'Internal Server Error', statusCode: 500 });\n        }\n      },\n    );\n  }\n\n  await new Promise<void>((resolve) => {\n    app.listen(port, () => {\n      const wid = (cluster.worker as { id: number } | undefined)?.id ?? 'primary';\n      console.log(`[EFC] Worker ${wid} listening on :${port}`);\n      resolve();\n    });\n  });\n}\n\nexport { HttpError } from './errors.js';\nexport { compose } from './compose.js';\nexport { db, setDbClient, getDbClient, defineModel } from './db/index.js';\nexport { scanDir } from './router/scan.js';\nexport type {\n  EFCConfig,\n  CorsConfig,\n  RouteEntry,\n  TaskOptions,\n  TaskDefinition,\n  DatabaseEngine,\n  AuthStrategy,\n  ModelSchema,\n  ModelCRUD,\n} from './types.js';\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\nfunction filePathToUrlPath(relativePath: string): string {\n  let p = relativePath.replace(ROUTE_FILE_RE, '');\n  // index files map to parent path\n  p = p.replace(/\\/index$/, '');\n  // [param] → :param\n  p = p.replace(DYNAMIC_SEGMENT_RE, ':$1');\n  return p === '' ? '/' : p.startsWith('/') ? p : `/${p}`;\n}\n\nfunction extractParams(relativePath: string): string[] {\n  const params: string[] = [];\n  let match: RegExpExecArray | null;\n  const re = new RegExp(DYNAMIC_SEGMENT_RE.source, 'g');\n  while ((match = re.exec(relativePath)) !== null) {\n    if (match[1]) params.push(match[1]);\n  }\n  return params;\n}\n\nexport function scanDir(dir: string, base: string = dir): RouteEntry[] {\n  if (!fs.existsSync(dir)) return [];\n\n  const entries: RouteEntry[] = [];\n  const items = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const item of items) {\n    const fullPath = path.join(dir, item.name);\n    if (item.isDirectory()) {\n      entries.push(...scanDir(fullPath, base));\n    } else if (ROUTE_FILE_RE.test(item.name)) {\n      const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n      entries.push({\n        urlPath: filePathToUrlPath(relative),\n        filePath: fullPath,\n        params: extractParams(relative),\n      });\n    }\n  }\n\n  // Sort: static routes before dynamic ones at each segment level\n  return entries.sort((a, b) => {\n    const aDynamic = a.urlPath.includes(':') ? 1 : 0;\n    const bDynamic = b.urlPath.includes(':') ? 1 : 0;\n    return aDynamic - bDynamic || a.urlPath.localeCompare(b.urlPath);\n  });\n}\n\nexport { filePathToUrlPath };\n","import type { Application, RequestHandler } from 'express';\nimport type { RouteEntry } from '../types.js';\n\nconst HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'] as const;\ntype HttpMethod = (typeof HTTP_METHODS)[number];\n\nfunction asyncWrap(handler: RequestHandler): RequestHandler {\n  return (req, res, next) => {\n    Promise.resolve(handler(req, res, next)).catch(next);\n  };\n}\n\nexport async function mountRoutes(app: Application, routes: RouteEntry[]): Promise<void> {\n  for (const route of routes) {\n    const mod = (await import(route.filePath)) as Record<string, unknown>;\n    const routeMiddlewares: RequestHandler[] = Array.isArray(mod['middlewares'])\n      ? (mod['middlewares'] as RequestHandler[])\n      : [];\n\n    const implemented: HttpMethod[] = [];\n    const unimplemented: HttpMethod[] = [];\n\n    for (const method of HTTP_METHODS) {\n      if (typeof mod[method] === 'function') {\n        implemented.push(method);\n        app[method.toLowerCase() as Lowercase<HttpMethod>](\n          route.urlPath,\n          ...routeMiddlewares,\n          asyncWrap(mod[method] as RequestHandler),\n        );\n      } else {\n        unimplemented.push(method);\n      }\n    }\n\n    if (implemented.length > 0 && unimplemented.length > 0) {\n      const allowHeader = implemented.join(', ');\n      app.all(route.urlPath, (req, res, next) => {\n        if ((unimplemented as string[]).includes(req.method)) {\n          res.set('Allow', allowHeader).status(405).json({ error: 'Method Not Allowed' });\n        } else {\n          next();\n        }\n      });\n    }\n  }\n}\n\nexport { asyncWrap };\n","import cluster from 'node:cluster';\nimport os from 'node:os';\n\ninterface ClusterOptions {\n  workers?: number;\n  onWorkerReady?: ((id: number) => void) | undefined;\n  onWorkerCrash?: ((id: number, code: number) => void) | undefined;\n}\n\nexport function runMaster(options: ClusterOptions = {}): void {\n  const count = options.workers ?? os.cpus().length;\n\n  console.log(`[EFC] Primary ${process.pid} starting ${count} workers`);\n\n  for (let i = 0; i < count; i++) {\n    cluster.fork();\n  }\n\n  cluster.on('online', (worker) => {\n    options.onWorkerReady?.(worker.id);\n  });\n\n  cluster.on('exit', (worker, code, signal) => {\n    const exitCode = code ?? (signal ? -1 : 0);\n    console.warn(`[EFC] Worker ${worker.id} exited (code=${exitCode}), respawning…`);\n    options.onWorkerCrash?.(worker.id, exitCode);\n    cluster.fork();\n  });\n}\n\nexport { cluster };\n","import type { RequestHandler, Response } from 'express';\nimport jwt from 'jsonwebtoken';\nimport type { AuthStrategy } from '../types.js';\n\ninterface AuthConfig {\n  secret: string;\n  strategy: AuthStrategy;\n  expiresIn: string;\n  cookieDomain?: string | undefined;\n}\n\nlet _config: AuthConfig | null = null;\n\nexport function configureAuth(config: AuthConfig): void {\n  _config = config;\n}\n\nfunction getConfig(): AuthConfig {\n  if (!_config) throw new Error('[EFC] Auth not configured — pass jwtSecret to ignite()');\n  return _config;\n}\n\nexport function issueToken(res: Response, payload: Record<string, unknown>): void {\n  const { secret, expiresIn, cookieDomain } = getConfig();\n  // expiresIn is a plain string (e.g. '7d'); cast satisfies jwt's branded StringValue\n  const token = jwt.sign(payload, secret, { expiresIn: expiresIn as jwt.SignOptions['expiresIn'] & string });\n  res.cookie('efc_token', token, {\n    httpOnly: true,\n    secure: process.env['NODE_ENV'] === 'production',\n    sameSite: 'strict',\n    ...(cookieDomain !== undefined && { domain: cookieDomain }),\n  });\n}\n\nexport function revokeToken(res: Response): void {\n  res.clearCookie('efc_token');\n}\n\nexport function signToken(payload: Record<string, unknown>): string {\n  const { secret, expiresIn } = getConfig();\n  return jwt.sign(payload, secret, { expiresIn: expiresIn as jwt.SignOptions['expiresIn'] & string });\n}\n\nexport const requireAuth: RequestHandler = (req, res, next) => {\n  const { secret, strategy } = getConfig();\n\n  try {\n    let token: string | undefined;\n\n    if (strategy === 'http-only') {\n      const cookies = (req as typeof req & { cookies: Record<string, string> }).cookies;\n      token = cookies['efc_token'];\n    } else {\n      const auth = req.headers['authorization'];\n      if (typeof auth === 'string' && auth.startsWith('Bearer ')) {\n        token = auth.slice(7);\n      }\n    }\n\n    if (!token) {\n      res.status(401).json({ error: 'Unauthorized' });\n      return;\n    }\n\n    const decoded = jwt.verify(token, secret);\n    (req as typeof req & { user: unknown }).user = decoded;\n    next();\n  } catch {\n    res.status(401).json({ error: 'Unauthorized' });\n  }\n};\n","export class HttpError extends Error {\n  readonly statusCode: number;\n\n  constructor(statusCode: number, message: string) {\n    super(message);\n    this.name = 'HttpError';\n    this.statusCode = statusCode;\n    Error.captureStackTrace(this, HttpError);\n  }\n}\n","// Wraps mongoose connection for Pre-Flight. Throws clearly if mongoose isn't installed.\n\nlet mongoose: typeof import('mongoose');\n\nasync function loadMongoose(): Promise<typeof import('mongoose')> {\n  if (mongoose) return mongoose;\n  try {\n    mongoose = await import('mongoose');\n    return mongoose;\n  } catch {\n    throw new Error(\n      '[EFC] mongoose is not installed. Run: npm install mongoose',\n    );\n  }\n}\n\nexport async function connectMongo(url: string): Promise<import('mongoose').Connection> {\n  const mg = await loadMongoose();\n  await mg.connect(url);\n  console.log('[EFC] MongoDB connected');\n  return mg.connection;\n}\n","import type { ModelSchema, ModelCRUD } from '../types.js';\n\ntype AnyRecord = Record<string, unknown> & { id: string };\n\nfunction normalise(doc: Record<string, unknown>): AnyRecord {\n  const id = doc['_id'] ? String(doc['_id']) : '';\n  return { ...doc, id } as AnyRecord;\n}\n\nasync function getModel(name: string, schemaObj: Record<string, unknown>): Promise<import('mongoose').Model<Record<string, unknown>>> {\n  let mg: typeof import('mongoose');\n  try {\n    mg = await import('mongoose');\n  } catch {\n    throw new Error('[EFC] mongoose is not installed. Run: npm install mongoose');\n  }\n\n  if (mg.models[name]) return mg.models[name] as import('mongoose').Model<Record<string, unknown>>;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const schema = new mg.Schema(schemaObj as any, { timestamps: true });\n  return mg.model<Record<string, unknown>>(name, schema);\n}\n\nfunction buildMongooseSchema(schema: ModelSchema): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, def] of Object.entries(schema)) {\n    const entry: Record<string, unknown> = {};\n    switch (def.type) {\n      case 'string':   entry['type'] = String; break;\n      case 'number':   entry['type'] = Number; break;\n      case 'boolean':  entry['type'] = Boolean; break;\n      case 'date':     entry['type'] = Date; break;\n      case 'object':   entry['type'] = Object; break;\n      case 'array':    entry['type'] = Array; break;\n    }\n    if (def.required !== undefined) entry['required'] = def.required;\n    if (def.unique !== undefined)   entry['unique'] = def.unique;\n    if (def.default !== undefined)  entry['default'] = def.default;\n    out[key] = entry;\n  }\n  return out;\n}\n\nexport function defineModel<T extends Record<string, unknown>>(\n  name: string,\n  schema: ModelSchema,\n): ModelCRUD<T> {\n  const mongooseSchema = buildMongooseSchema(schema);\n\n  return {\n    async find(filter = {}) {\n      const M = await getModel(name, mongooseSchema);\n      const docs = await M.find(filter as Record<string, unknown>).lean();\n      return (docs as Record<string, unknown>[]).map(normalise) as (T & { id: string })[];\n    },\n\n    async findById(id) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findById(id).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async findOne(filter) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findOne(filter as Record<string, unknown>).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async create(data) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.create(data);\n      return normalise(doc.toObject() as Record<string, unknown>) as T & { id: string };\n    },\n\n    async update(id, data) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findByIdAndUpdate(id, data, { new: true }).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async delete(id) {\n      const M = await getModel(name, mongooseSchema);\n      await M.findByIdAndDelete(id);\n    },\n\n    async count(filter = {}) {\n      const M = await getModel(name, mongooseSchema);\n      return M.countDocuments(filter as Record<string, unknown>);\n    },\n  };\n}\n","// Thread-local DB client populated during Pre-Flight.\n// The Proxy ensures callers import `db` once and never null-check it —\n// it throws with a helpful message if accessed before Pre-Flight completes.\n\ntype AnyClient = Record<string, unknown>;\n\nlet _client: AnyClient | null = null;\n\nexport function setDbClient(client: AnyClient): void {\n  _client = client;\n}\n\nexport function getDbClient(): AnyClient {\n  if (!_client) {\n    throw new Error('[EFC] db not ready — accessed before Pre-Flight completed');\n  }\n  return _client;\n}\n\nexport const db: AnyClient = new Proxy({} as AnyClient, {\n  get(_target, prop: string) {\n    return getDbClient()[prop];\n  },\n  set(_target, prop: string, value: unknown) {\n    getDbClient()[prop] = value;\n    return true;\n  },\n});\n\nexport { connectMongo } from './mongo.js';\nexport { defineModel } from './model.js';\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { registerTask } from './index.js';\nimport type { TaskDefinition } from '../types.js';\n\nexport async function scanTasks(tasksDir: string): Promise<void> {\n  if (!fs.existsSync(tasksDir)) return;\n\n  const files = fs.readdirSync(tasksDir).filter((f) => /\\.(ts|js|mts|mjs)$/.test(f));\n\n  for (const file of files) {\n    const filePath = path.join(tasksDir, file);\n    const taskName = path.basename(file, path.extname(file));\n\n    try {\n      const mod = await import(filePath) as Record<string, unknown>;\n      const def = mod['default'] as TaskDefinition | undefined;\n\n      if (!def || typeof def.handler !== 'function') {\n        console.warn(`[EFC] Task file ${file} has no valid default export — skipping`);\n        continue;\n      }\n\n      registerTask(taskName, { ...def, filePath });\n      console.log(`[EFC] Registered task: ${taskName}`);\n    } catch (err) {\n      console.warn(`[EFC] Failed to load task ${file}:`, err);\n    }\n  }\n}\n","import type { TaskDefinition, TaskOptions } from '../types.js';\n\nexport const taskRegistry = new Map<string, TaskDefinition>();\n\ntype HandlerFn<T> = (payload: T) => Promise<void>;\ntype DefineTaskOverload = {\n  <T>(handler: HandlerFn<T>): TaskDefinition<T>;\n  <T>(options: TaskOptions, handler: HandlerFn<T>): TaskDefinition<T>;\n};\n\nexport const defineTask: DefineTaskOverload = <T>(\n  handlerOrOptions: HandlerFn<T> | TaskOptions,\n  maybeHandler?: HandlerFn<T>,\n): TaskDefinition<T> => {\n  let options: TaskOptions = {};\n  let handler: HandlerFn<T>;\n\n  if (typeof handlerOrOptions === 'function') {\n    handler = handlerOrOptions;\n  } else {\n    options = handlerOrOptions;\n    if (!maybeHandler) throw new Error('[EFC] defineTask: handler function is required');\n    handler = maybeHandler;\n  }\n\n  return {\n    handler: handler as (payload: unknown) => Promise<void>,\n    options,\n    name: '',\n  };\n};\n\ntype EnqueueImpl = (name: string, payload: unknown) => Promise<void>;\nlet _impl: EnqueueImpl | null = null;\n\nexport function setEnqueueImpl(impl: EnqueueImpl): void {\n  _impl = impl;\n}\n\nexport async function enqueue<T>(name: string, payload: T): Promise<void> {\n  if (!_impl) {\n    throw new Error(\n      `[EFC] Task queue not initialised. Set tasks.backend in ignite() config.`,\n    );\n  }\n  return _impl(name, payload as unknown);\n}\n\nexport function registerTask(name: string, def: TaskDefinition): void {\n  taskRegistry.set(name, { ...def, name });\n}\n","import { Worker, workerData, parentPort, isMainThread } from 'node:worker_threads';\nimport type { TaskDefinition } from '../types.js';\n\n// ── Worker-thread side ────────────────────────────────────────────────────────\nif (!isMainThread) {\n  const { handlerPath, payload } = workerData as { handlerPath: string; payload: unknown };\n\n  (async () => {\n    try {\n      const mod = await import(handlerPath) as Record<string, unknown>;\n      const def = mod['default'] as TaskDefinition | undefined;\n      if (!def || typeof def.handler !== 'function') {\n        throw new Error(`[EFC] Thread runner: no valid task export in ${handlerPath}`);\n      }\n      await def.handler(payload);\n      parentPort?.postMessage({ ok: true });\n    } catch (err) {\n      parentPort?.postMessage({ ok: false, error: String(err) });\n    }\n  })();\n}\n\n// ── Main-thread side ──────────────────────────────────────────────────────────\nexport function runInThread(handlerPath: string, payload: unknown): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const worker = new Worker(new URL('./thread-runner.js', import.meta.url), {\n      workerData: { handlerPath, payload },\n    });\n\n    worker.on('message', (msg: { ok: boolean; error?: string }) => {\n      if (msg.ok) resolve();\n      else reject(new Error(msg.error ?? 'Thread task failed'));\n    });\n\n    worker.on('error', reject);\n    worker.on('exit', (code) => {\n      if (code !== 0) reject(new Error(`Thread worker exited with code ${code}`));\n    });\n  });\n}\n","import type { Job } from 'bullmq';\nimport { taskRegistry, setEnqueueImpl } from './index.js';\nimport { runInThread } from './thread-runner.js';\n\ninterface BullMQOpts {\n  redisUrl: string;\n  concurrency: number;\n}\n\nexport async function initBullMQ(opts: BullMQOpts): Promise<void> {\n  let bullmq: typeof import('bullmq');\n  try {\n    bullmq = await import('bullmq');\n  } catch {\n    throw new Error('[EFC] bullmq is not installed. Run: npm install bullmq');\n  }\n\n  const connection = parseRedisUrl(opts.redisUrl);\n  const queue = new bullmq.Queue('efc', { connection });\n\n  const worker = new bullmq.Worker(\n    'efc',\n    async (job: Job) => {\n      const def = taskRegistry.get(job.name);\n      if (!def) {\n        throw new Error(`[EFC] No task registered for name: ${job.name}`);\n      }\n\n      if (def.options.thread && def.filePath) {\n        await runInThread(def.filePath, job.data);\n      } else {\n        await def.handler(job.data);\n      }\n    },\n    { connection, concurrency: opts.concurrency },\n  );\n\n  worker.on('failed', (job: Job | undefined, err: Error) => {\n    console.error(`[EFC] Task ${job?.name ?? 'unknown'} failed:`, err.message);\n  });\n\n  worker.on('completed', (job: Job) => {\n    console.log(`[EFC] Task ${job.name} completed (id=${job.id})`);\n  });\n\n  setEnqueueImpl(async (name, payload) => {\n    const def = taskRegistry.get(name);\n    if (!def) {\n      throw new Error(`[EFC] Cannot enqueue unknown task: \"${name}\". Is the task file in tasksDir?`);\n    }\n\n    await queue.add(name, payload, {\n      attempts: def.options.retries ?? 3,\n      backoff: {\n        type: def.options.backoff ?? 'exponential',\n        delay: 1000,\n      },\n    });\n  });\n\n  console.log('[EFC] BullMQ backend initialised');\n}\n\nfunction parseRedisUrl(url: string): { host: string; port: number; password?: string } {\n  try {\n    const u = new URL(url);\n    const result: { host: string; port: number; password?: string } = {\n      host: u.hostname || 'localhost',\n      port: parseInt(u.port || '6379', 10),\n    };\n    if (u.password) result.password = u.password;\n    return result;\n  } catch {\n    return { host: 'localhost', port: 6379 };\n  }\n}\n","import type { RequestHandler } from 'express';\n\nexport function compose(...handlers: RequestHandler[]): RequestHandler {\n  return (req, res, next) => {\n    let index = 0;\n\n    function dispatch(i: number): void {\n      if (i >= handlers.length) {\n        next();\n        return;\n      }\n      const handler = handlers[i];\n      if (!handler) {\n        next();\n        return;\n      }\n      try {\n        Promise.resolve(handler(req, res, () => dispatch(i + 1))).catch(next);\n      } catch (err) {\n        next(err);\n      }\n    }\n\n    dispatch(index);\n  };\n}\n"],"mappings":"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","names":["import_node_cluster","import_node_os","fs","path","os","cluster","import_node_fs","import_node_path","fs","path","cluster","os","express","cors","cookieParser"]}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { M as ModelSchema, b as ModelCRUD, R as RouteEntry, E as EFCConfig } from './types-DNdkDUPX.cjs';
-export { A as AuthStrategy, D as DatabaseEngine, T as TaskDefinition, a as TaskOptions } from './types-DNdkDUPX.cjs';
+import { M as ModelSchema, b as ModelCRUD, R as RouteEntry, E as EFCConfig } from './types-CkpRAA3y.cjs';
+export { A as AuthStrategy, C as CorsConfig, D as DatabaseEngine, T as TaskDefinition, a as TaskOptions } from './types-CkpRAA3y.cjs';
 import { RequestHandler } from 'express';
 
 declare class HttpError extends Error {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as ModelSchema, b as ModelCRUD, R as RouteEntry, E as EFCConfig } from './types-DNdkDUPX.js';
-export { A as AuthStrategy, D as DatabaseEngine, T as TaskDefinition, a as TaskOptions } from './types-DNdkDUPX.js';
+import { M as ModelSchema, b as ModelCRUD, R as RouteEntry, E as EFCConfig } from './types-CkpRAA3y.js';
+export { A as AuthStrategy, C as CorsConfig, D as DatabaseEngine, T as TaskDefinition, a as TaskOptions } from './types-CkpRAA3y.js';
 import { RequestHandler } from 'express';
 
 declare class HttpError extends Error {

package/dist/index.js

@@ -1,5 +1,7 @@
 // src/index.ts
+import "dotenv/config";
 import express from "express";
+import cors from "cors";
 import cookieParser from "cookie-parser";
 import cluster2 from "cluster";
 import os2 from "os";
@@ -411,7 +413,7 @@ function compose(...handlers) {
 // src/index.ts
 async function ignite(config) {
   const {
-    port = 3e3,
+    port: _port,
     cluster: clusterEnabled = true,
     workers,
     apiDir,
@@ -422,6 +424,7 @@ async function ignite(config) {
     onWorkerCrash,
     onError
   } = config;
+  const port = _port != null && !Number.isNaN(_port) ? _port : Number(process.env["PORT"]) || 3e3;
   if (clusterEnabled && cluster2.isPrimary) {
     runMaster({
       workers: workers ?? os2.cpus().length,
@@ -431,6 +434,21 @@ async function ignite(config) {
     return;
   }
   const app = express();
+  const corsOption = config.cors ?? true;
+  if (corsOption !== false) {
+    const envOrigins = process.env["CORS_ORIGINS"];
+    let origin;
+    if (envOrigins) {
+      const list = envOrigins.split(",").map((o) => o.trim()).filter(Boolean);
+      origin = list.length === 1 ? list[0] : list;
+    } else if (typeof corsOption === "object" && corsOption.origin !== void 0) {
+      origin = corsOption.origin;
+    } else {
+      origin = true;
+    }
+    const corsOpts = typeof corsOption === "object" ? { ...corsOption, origin } : { origin };
+    app.use(cors(corsOpts));
+  }
   app.use(express.json());
   app.use(express.urlencoded({ extended: true }));
   app.use(cookieParser());

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/router/scan.ts","../src/router/mount.ts","../src/cluster/index.ts","../src/auth/index.ts","../src/errors.ts","../src/db/mongo.ts","../src/db/model.ts","../src/db/index.ts","../src/tasks/scanner.ts","../src/tasks/index.ts","../src/tasks/thread-runner.ts","../src/tasks/bullmq-backend.ts","../src/compose.ts"],"sourcesContent":["import express from 'express';\nimport cookieParser from 'cookie-parser';\nimport cluster from 'node:cluster';\nimport os from 'node:os';\nimport type { EFCConfig } from './types.js';\nimport { scanDir } from './router/scan.js';\nimport { mountRoutes } from './router/mount.js';\nimport { runMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { HttpError } from './errors.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { scanTasks } from './tasks/scanner.js';\nimport { initBullMQ } from './tasks/bullmq-backend.js';\n\nexport async function ignite(config: EFCConfig): Promise<void> {\n  const {\n    port = 3000,\n    cluster: clusterEnabled = true,\n    workers,\n    apiDir,\n    jwtSecret,\n    authStrategy = 'http-only',\n    globalMiddlewares = [],\n    onWorkerReady,\n    onWorkerCrash,\n    onError,\n  } = config;\n\n  if (clusterEnabled && cluster.isPrimary) {\n    runMaster({\n      workers: workers ?? os.cpus().length,\n      ...(onWorkerReady !== undefined && { onWorkerReady }),\n      ...(onWorkerCrash !== undefined && { onWorkerCrash }),\n    });\n    return;\n  }\n\n  const app = express();\n\n  app.use(express.json());\n  app.use(express.urlencoded({ extended: true }));\n  app.use(cookieParser());\n\n  for (const mw of globalMiddlewares) {\n    app.use(mw);\n  }\n\n  // Pre-Flight step 1: Connect database\n  if (config.database === 'mongodb' && config.databaseUrl) {\n    const conn = await connectMongo(config.databaseUrl);\n    setDbClient(conn as unknown as Record<string, unknown>);\n  }\n\n  // Pre-Flight step 2: Configure auth\n  if (jwtSecret) {\n    const cookieDomain = process.env['COOKIE_DOMAIN'];\n    configureAuth({\n      secret: jwtSecret,\n      strategy: authStrategy,\n      expiresIn: process.env['JWT_EXPIRES_IN'] ?? '7d',\n      ...(cookieDomain !== undefined && { cookieDomain }),\n    });\n  }\n\n  // Pre-Flight step 3: Scan and register tasks\n  if (config.tasksDir) {\n    await scanTasks(config.tasksDir);\n  }\n\n  // Pre-Flight step 4: Start task queue backend\n  if (config.tasks) {\n    if (config.tasks.backend === 'bullmq') {\n      await initBullMQ({\n        redisUrl: config.tasks.redisUrl ?? 'redis://localhost:6379',\n        concurrency: config.tasks.concurrency ?? 5,\n      });\n    }\n  }\n\n  // Pre-Flight step 5: Scan routes and mount\n  const routes = scanDir(apiDir);\n  await mountRoutes(app, routes);\n\n  if (onError) {\n    app.use(onError);\n  } else {\n    app.use(\n      (\n        err: unknown,\n        _req: express.Request,\n        res: express.Response,\n        _next: express.NextFunction,\n      ) => {\n        if (err instanceof HttpError) {\n          res.status(err.statusCode).json({ error: err.message, statusCode: err.statusCode });\n        } else {\n          console.error('[EFC] Unhandled error:', err);\n          res.status(500).json({ error: 'Internal Server Error', statusCode: 500 });\n        }\n      },\n    );\n  }\n\n  await new Promise<void>((resolve) => {\n    app.listen(port, () => {\n      const wid = (cluster.worker as { id: number } | undefined)?.id ?? 'primary';\n      console.log(`[EFC] Worker ${wid} listening on :${port}`);\n      resolve();\n    });\n  });\n}\n\nexport { HttpError } from './errors.js';\nexport { compose } from './compose.js';\nexport { db, setDbClient, getDbClient, defineModel } from './db/index.js';\nexport { scanDir } from './router/scan.js';\nexport type {\n  EFCConfig,\n  RouteEntry,\n  TaskOptions,\n  TaskDefinition,\n  DatabaseEngine,\n  AuthStrategy,\n  ModelSchema,\n  ModelCRUD,\n} from './types.js';\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\nfunction filePathToUrlPath(relativePath: string): string {\n  let p = relativePath.replace(ROUTE_FILE_RE, '');\n  // index files map to parent path\n  p = p.replace(/\\/index$/, '');\n  // [param] → :param\n  p = p.replace(DYNAMIC_SEGMENT_RE, ':$1');\n  return p === '' ? '/' : p.startsWith('/') ? p : `/${p}`;\n}\n\nfunction extractParams(relativePath: string): string[] {\n  const params: string[] = [];\n  let match: RegExpExecArray | null;\n  const re = new RegExp(DYNAMIC_SEGMENT_RE.source, 'g');\n  while ((match = re.exec(relativePath)) !== null) {\n    if (match[1]) params.push(match[1]);\n  }\n  return params;\n}\n\nexport function scanDir(dir: string, base: string = dir): RouteEntry[] {\n  if (!fs.existsSync(dir)) return [];\n\n  const entries: RouteEntry[] = [];\n  const items = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const item of items) {\n    const fullPath = path.join(dir, item.name);\n    if (item.isDirectory()) {\n      entries.push(...scanDir(fullPath, base));\n    } else if (ROUTE_FILE_RE.test(item.name)) {\n      const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n      entries.push({\n        urlPath: filePathToUrlPath(relative),\n        filePath: fullPath,\n        params: extractParams(relative),\n      });\n    }\n  }\n\n  // Sort: static routes before dynamic ones at each segment level\n  return entries.sort((a, b) => {\n    const aDynamic = a.urlPath.includes(':') ? 1 : 0;\n    const bDynamic = b.urlPath.includes(':') ? 1 : 0;\n    return aDynamic - bDynamic || a.urlPath.localeCompare(b.urlPath);\n  });\n}\n\nexport { filePathToUrlPath };\n","import type { Application, RequestHandler } from 'express';\nimport type { RouteEntry } from '../types.js';\n\nconst HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'] as const;\ntype HttpMethod = (typeof HTTP_METHODS)[number];\n\nfunction asyncWrap(handler: RequestHandler): RequestHandler {\n  return (req, res, next) => {\n    Promise.resolve(handler(req, res, next)).catch(next);\n  };\n}\n\nexport async function mountRoutes(app: Application, routes: RouteEntry[]): Promise<void> {\n  for (const route of routes) {\n    const mod = (await import(route.filePath)) as Record<string, unknown>;\n    const routeMiddlewares: RequestHandler[] = Array.isArray(mod['middlewares'])\n      ? (mod['middlewares'] as RequestHandler[])\n      : [];\n\n    const implemented: HttpMethod[] = [];\n    const unimplemented: HttpMethod[] = [];\n\n    for (const method of HTTP_METHODS) {\n      if (typeof mod[method] === 'function') {\n        implemented.push(method);\n        app[method.toLowerCase() as Lowercase<HttpMethod>](\n          route.urlPath,\n          ...routeMiddlewares,\n          asyncWrap(mod[method] as RequestHandler),\n        );\n      } else {\n        unimplemented.push(method);\n      }\n    }\n\n    if (implemented.length > 0 && unimplemented.length > 0) {\n      const allowHeader = implemented.join(', ');\n      app.all(route.urlPath, (req, res, next) => {\n        if ((unimplemented as string[]).includes(req.method)) {\n          res.set('Allow', allowHeader).status(405).json({ error: 'Method Not Allowed' });\n        } else {\n          next();\n        }\n      });\n    }\n  }\n}\n\nexport { asyncWrap };\n","import cluster from 'node:cluster';\nimport os from 'node:os';\n\ninterface ClusterOptions {\n  workers?: number;\n  onWorkerReady?: ((id: number) => void) | undefined;\n  onWorkerCrash?: ((id: number, code: number) => void) | undefined;\n}\n\nexport function runMaster(options: ClusterOptions = {}): void {\n  const count = options.workers ?? os.cpus().length;\n\n  console.log(`[EFC] Primary ${process.pid} starting ${count} workers`);\n\n  for (let i = 0; i < count; i++) {\n    cluster.fork();\n  }\n\n  cluster.on('online', (worker) => {\n    options.onWorkerReady?.(worker.id);\n  });\n\n  cluster.on('exit', (worker, code, signal) => {\n    const exitCode = code ?? (signal ? -1 : 0);\n    console.warn(`[EFC] Worker ${worker.id} exited (code=${exitCode}), respawning…`);\n    options.onWorkerCrash?.(worker.id, exitCode);\n    cluster.fork();\n  });\n}\n\nexport { cluster };\n","import type { RequestHandler, Response } from 'express';\nimport jwt from 'jsonwebtoken';\nimport type { AuthStrategy } from '../types.js';\n\ninterface AuthConfig {\n  secret: string;\n  strategy: AuthStrategy;\n  expiresIn: string;\n  cookieDomain?: string | undefined;\n}\n\nlet _config: AuthConfig | null = null;\n\nexport function configureAuth(config: AuthConfig): void {\n  _config = config;\n}\n\nfunction getConfig(): AuthConfig {\n  if (!_config) throw new Error('[EFC] Auth not configured — pass jwtSecret to ignite()');\n  return _config;\n}\n\nexport function issueToken(res: Response, payload: Record<string, unknown>): void {\n  const { secret, expiresIn, cookieDomain } = getConfig();\n  // expiresIn is a plain string (e.g. '7d'); cast satisfies jwt's branded StringValue\n  const token = jwt.sign(payload, secret, { expiresIn: expiresIn as jwt.SignOptions['expiresIn'] & string });\n  res.cookie('efc_token', token, {\n    httpOnly: true,\n    secure: process.env['NODE_ENV'] === 'production',\n    sameSite: 'strict',\n    ...(cookieDomain !== undefined && { domain: cookieDomain }),\n  });\n}\n\nexport function revokeToken(res: Response): void {\n  res.clearCookie('efc_token');\n}\n\nexport function signToken(payload: Record<string, unknown>): string {\n  const { secret, expiresIn } = getConfig();\n  return jwt.sign(payload, secret, { expiresIn: expiresIn as jwt.SignOptions['expiresIn'] & string });\n}\n\nexport const requireAuth: RequestHandler = (req, res, next) => {\n  const { secret, strategy } = getConfig();\n\n  try {\n    let token: string | undefined;\n\n    if (strategy === 'http-only') {\n      const cookies = (req as typeof req & { cookies: Record<string, string> }).cookies;\n      token = cookies['efc_token'];\n    } else {\n      const auth = req.headers['authorization'];\n      if (typeof auth === 'string' && auth.startsWith('Bearer ')) {\n        token = auth.slice(7);\n      }\n    }\n\n    if (!token) {\n      res.status(401).json({ error: 'Unauthorized' });\n      return;\n    }\n\n    const decoded = jwt.verify(token, secret);\n    (req as typeof req & { user: unknown }).user = decoded;\n    next();\n  } catch {\n    res.status(401).json({ error: 'Unauthorized' });\n  }\n};\n","export class HttpError extends Error {\n  readonly statusCode: number;\n\n  constructor(statusCode: number, message: string) {\n    super(message);\n    this.name = 'HttpError';\n    this.statusCode = statusCode;\n    Error.captureStackTrace(this, HttpError);\n  }\n}\n","// Wraps mongoose connection for Pre-Flight. Throws clearly if mongoose isn't installed.\n\nlet mongoose: typeof import('mongoose');\n\nasync function loadMongoose(): Promise<typeof import('mongoose')> {\n  if (mongoose) return mongoose;\n  try {\n    mongoose = await import('mongoose');\n    return mongoose;\n  } catch {\n    throw new Error(\n      '[EFC] mongoose is not installed. Run: npm install mongoose',\n    );\n  }\n}\n\nexport async function connectMongo(url: string): Promise<import('mongoose').Connection> {\n  const mg = await loadMongoose();\n  await mg.connect(url);\n  console.log('[EFC] MongoDB connected');\n  return mg.connection;\n}\n","import type { ModelSchema, ModelCRUD } from '../types.js';\n\ntype AnyRecord = Record<string, unknown> & { id: string };\n\nfunction normalise(doc: Record<string, unknown>): AnyRecord {\n  const id = doc['_id'] ? String(doc['_id']) : '';\n  return { ...doc, id } as AnyRecord;\n}\n\nasync function getModel(name: string, schemaObj: Record<string, unknown>): Promise<import('mongoose').Model<Record<string, unknown>>> {\n  let mg: typeof import('mongoose');\n  try {\n    mg = await import('mongoose');\n  } catch {\n    throw new Error('[EFC] mongoose is not installed. Run: npm install mongoose');\n  }\n\n  if (mg.models[name]) return mg.models[name] as import('mongoose').Model<Record<string, unknown>>;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const schema = new mg.Schema(schemaObj as any, { timestamps: true });\n  return mg.model<Record<string, unknown>>(name, schema);\n}\n\nfunction buildMongooseSchema(schema: ModelSchema): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, def] of Object.entries(schema)) {\n    const entry: Record<string, unknown> = {};\n    switch (def.type) {\n      case 'string':   entry['type'] = String; break;\n      case 'number':   entry['type'] = Number; break;\n      case 'boolean':  entry['type'] = Boolean; break;\n      case 'date':     entry['type'] = Date; break;\n      case 'object':   entry['type'] = Object; break;\n      case 'array':    entry['type'] = Array; break;\n    }\n    if (def.required !== undefined) entry['required'] = def.required;\n    if (def.unique !== undefined)   entry['unique'] = def.unique;\n    if (def.default !== undefined)  entry['default'] = def.default;\n    out[key] = entry;\n  }\n  return out;\n}\n\nexport function defineModel<T extends Record<string, unknown>>(\n  name: string,\n  schema: ModelSchema,\n): ModelCRUD<T> {\n  const mongooseSchema = buildMongooseSchema(schema);\n\n  return {\n    async find(filter = {}) {\n      const M = await getModel(name, mongooseSchema);\n      const docs = await M.find(filter as Record<string, unknown>).lean();\n      return (docs as Record<string, unknown>[]).map(normalise) as (T & { id: string })[];\n    },\n\n    async findById(id) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findById(id).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async findOne(filter) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findOne(filter as Record<string, unknown>).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async create(data) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.create(data);\n      return normalise(doc.toObject() as Record<string, unknown>) as T & { id: string };\n    },\n\n    async update(id, data) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findByIdAndUpdate(id, data, { new: true }).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async delete(id) {\n      const M = await getModel(name, mongooseSchema);\n      await M.findByIdAndDelete(id);\n    },\n\n    async count(filter = {}) {\n      const M = await getModel(name, mongooseSchema);\n      return M.countDocuments(filter as Record<string, unknown>);\n    },\n  };\n}\n","// Thread-local DB client populated during Pre-Flight.\n// The Proxy ensures callers import `db` once and never null-check it —\n// it throws with a helpful message if accessed before Pre-Flight completes.\n\ntype AnyClient = Record<string, unknown>;\n\nlet _client: AnyClient | null = null;\n\nexport function setDbClient(client: AnyClient): void {\n  _client = client;\n}\n\nexport function getDbClient(): AnyClient {\n  if (!_client) {\n    throw new Error('[EFC] db not ready — accessed before Pre-Flight completed');\n  }\n  return _client;\n}\n\nexport const db: AnyClient = new Proxy({} as AnyClient, {\n  get(_target, prop: string) {\n    return getDbClient()[prop];\n  },\n  set(_target, prop: string, value: unknown) {\n    getDbClient()[prop] = value;\n    return true;\n  },\n});\n\nexport { connectMongo } from './mongo.js';\nexport { defineModel } from './model.js';\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { registerTask } from './index.js';\nimport type { TaskDefinition } from '../types.js';\n\nexport async function scanTasks(tasksDir: string): Promise<void> {\n  if (!fs.existsSync(tasksDir)) return;\n\n  const files = fs.readdirSync(tasksDir).filter((f) => /\\.(ts|js|mts|mjs)$/.test(f));\n\n  for (const file of files) {\n    const filePath = path.join(tasksDir, file);\n    const taskName = path.basename(file, path.extname(file));\n\n    try {\n      const mod = await import(filePath) as Record<string, unknown>;\n      const def = mod['default'] as TaskDefinition | undefined;\n\n      if (!def || typeof def.handler !== 'function') {\n        console.warn(`[EFC] Task file ${file} has no valid default export — skipping`);\n        continue;\n      }\n\n      registerTask(taskName, { ...def, filePath });\n      console.log(`[EFC] Registered task: ${taskName}`);\n    } catch (err) {\n      console.warn(`[EFC] Failed to load task ${file}:`, err);\n    }\n  }\n}\n","import type { TaskDefinition, TaskOptions } from '../types.js';\n\nexport const taskRegistry = new Map<string, TaskDefinition>();\n\ntype HandlerFn<T> = (payload: T) => Promise<void>;\ntype DefineTaskOverload = {\n  <T>(handler: HandlerFn<T>): TaskDefinition<T>;\n  <T>(options: TaskOptions, handler: HandlerFn<T>): TaskDefinition<T>;\n};\n\nexport const defineTask: DefineTaskOverload = <T>(\n  handlerOrOptions: HandlerFn<T> | TaskOptions,\n  maybeHandler?: HandlerFn<T>,\n): TaskDefinition<T> => {\n  let options: TaskOptions = {};\n  let handler: HandlerFn<T>;\n\n  if (typeof handlerOrOptions === 'function') {\n    handler = handlerOrOptions;\n  } else {\n    options = handlerOrOptions;\n    if (!maybeHandler) throw new Error('[EFC] defineTask: handler function is required');\n    handler = maybeHandler;\n  }\n\n  return {\n    handler: handler as (payload: unknown) => Promise<void>,\n    options,\n    name: '',\n  };\n};\n\ntype EnqueueImpl = (name: string, payload: unknown) => Promise<void>;\nlet _impl: EnqueueImpl | null = null;\n\nexport function setEnqueueImpl(impl: EnqueueImpl): void {\n  _impl = impl;\n}\n\nexport async function enqueue<T>(name: string, payload: T): Promise<void> {\n  if (!_impl) {\n    throw new Error(\n      `[EFC] Task queue not initialised. Set tasks.backend in ignite() config.`,\n    );\n  }\n  return _impl(name, payload as unknown);\n}\n\nexport function registerTask(name: string, def: TaskDefinition): void {\n  taskRegistry.set(name, { ...def, name });\n}\n","import { Worker, workerData, parentPort, isMainThread } from 'node:worker_threads';\nimport type { TaskDefinition } from '../types.js';\n\n// ── Worker-thread side ────────────────────────────────────────────────────────\nif (!isMainThread) {\n  const { handlerPath, payload } = workerData as { handlerPath: string; payload: unknown };\n\n  (async () => {\n    try {\n      const mod = await import(handlerPath) as Record<string, unknown>;\n      const def = mod['default'] as TaskDefinition | undefined;\n      if (!def || typeof def.handler !== 'function') {\n        throw new Error(`[EFC] Thread runner: no valid task export in ${handlerPath}`);\n      }\n      await def.handler(payload);\n      parentPort?.postMessage({ ok: true });\n    } catch (err) {\n      parentPort?.postMessage({ ok: false, error: String(err) });\n    }\n  })();\n}\n\n// ── Main-thread side ──────────────────────────────────────────────────────────\nexport function runInThread(handlerPath: string, payload: unknown): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const worker = new Worker(new URL('./thread-runner.js', import.meta.url), {\n      workerData: { handlerPath, payload },\n    });\n\n    worker.on('message', (msg: { ok: boolean; error?: string }) => {\n      if (msg.ok) resolve();\n      else reject(new Error(msg.error ?? 'Thread task failed'));\n    });\n\n    worker.on('error', reject);\n    worker.on('exit', (code) => {\n      if (code !== 0) reject(new Error(`Thread worker exited with code ${code}`));\n    });\n  });\n}\n","import type { Job } from 'bullmq';\nimport { taskRegistry, setEnqueueImpl } from './index.js';\nimport { runInThread } from './thread-runner.js';\n\ninterface BullMQOpts {\n  redisUrl: string;\n  concurrency: number;\n}\n\nexport async function initBullMQ(opts: BullMQOpts): Promise<void> {\n  let bullmq: typeof import('bullmq');\n  try {\n    bullmq = await import('bullmq');\n  } catch {\n    throw new Error('[EFC] bullmq is not installed. Run: npm install bullmq');\n  }\n\n  const connection = parseRedisUrl(opts.redisUrl);\n  const queue = new bullmq.Queue('efc', { connection });\n\n  const worker = new bullmq.Worker(\n    'efc',\n    async (job: Job) => {\n      const def = taskRegistry.get(job.name);\n      if (!def) {\n        throw new Error(`[EFC] No task registered for name: ${job.name}`);\n      }\n\n      if (def.options.thread && def.filePath) {\n        await runInThread(def.filePath, job.data);\n      } else {\n        await def.handler(job.data);\n      }\n    },\n    { connection, concurrency: opts.concurrency },\n  );\n\n  worker.on('failed', (job: Job | undefined, err: Error) => {\n    console.error(`[EFC] Task ${job?.name ?? 'unknown'} failed:`, err.message);\n  });\n\n  worker.on('completed', (job: Job) => {\n    console.log(`[EFC] Task ${job.name} completed (id=${job.id})`);\n  });\n\n  setEnqueueImpl(async (name, payload) => {\n    const def = taskRegistry.get(name);\n    if (!def) {\n      throw new Error(`[EFC] Cannot enqueue unknown task: \"${name}\". Is the task file in tasksDir?`);\n    }\n\n    await queue.add(name, payload, {\n      attempts: def.options.retries ?? 3,\n      backoff: {\n        type: def.options.backoff ?? 'exponential',\n        delay: 1000,\n      },\n    });\n  });\n\n  console.log('[EFC] BullMQ backend initialised');\n}\n\nfunction parseRedisUrl(url: string): { host: string; port: number; password?: string } {\n  try {\n    const u = new URL(url);\n    const result: { host: string; port: number; password?: string } = {\n      host: u.hostname || 'localhost',\n      port: parseInt(u.port || '6379', 10),\n    };\n    if (u.password) result.password = u.password;\n    return result;\n  } catch {\n    return { host: 'localhost', port: 6379 };\n  }\n}\n","import type { RequestHandler } from 'express';\n\nexport function compose(...handlers: RequestHandler[]): RequestHandler {\n  return (req, res, next) => {\n    let index = 0;\n\n    function dispatch(i: number): void {\n      if (i >= handlers.length) {\n        next();\n        return;\n      }\n      const handler = handlers[i];\n      if (!handler) {\n        next();\n        return;\n      }\n      try {\n        Promise.resolve(handler(req, res, () => dispatch(i + 1))).catch(next);\n      } catch (err) {\n        next(err);\n      }\n    }\n\n    dispatch(index);\n  };\n}\n"],"mappings":"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","names":["cluster","os","fs","path","fs","path","cluster","os"]}
+{"version":3,"sources":["../src/index.ts","../src/router/scan.ts","../src/router/mount.ts","../src/cluster/index.ts","../src/auth/index.ts","../src/errors.ts","../src/db/mongo.ts","../src/db/model.ts","../src/db/index.ts","../src/tasks/scanner.ts","../src/tasks/index.ts","../src/tasks/thread-runner.ts","../src/tasks/bullmq-backend.ts","../src/compose.ts"],"sourcesContent":["import 'dotenv/config';\nimport express from 'express';\nimport cors from 'cors';\nimport cookieParser from 'cookie-parser';\nimport cluster from 'node:cluster';\nimport os from 'node:os';\nimport type { EFCConfig } from './types.js';\nimport { scanDir } from './router/scan.js';\nimport { mountRoutes } from './router/mount.js';\nimport { runMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { HttpError } from './errors.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { scanTasks } from './tasks/scanner.js';\nimport { initBullMQ } from './tasks/bullmq-backend.js';\n\nexport async function ignite(config: EFCConfig): Promise<void> {\n  const {\n    port: _port,\n    cluster: clusterEnabled = true,\n    workers,\n    apiDir,\n    jwtSecret,\n    authStrategy = 'http-only',\n    globalMiddlewares = [],\n    onWorkerReady,\n    onWorkerCrash,\n    onError,\n  } = config;\n\n  const port =\n    _port != null && !Number.isNaN(_port)\n      ? _port\n      : Number(process.env['PORT']) || 3000;\n\n  if (clusterEnabled && cluster.isPrimary) {\n    runMaster({\n      workers: workers ?? os.cpus().length,\n      ...(onWorkerReady !== undefined && { onWorkerReady }),\n      ...(onWorkerCrash !== undefined && { onWorkerCrash }),\n    });\n    return;\n  }\n\n  const app = express();\n\n  const corsOption = config.cors ?? true;\n  if (corsOption !== false) {\n    const envOrigins = process.env['CORS_ORIGINS'];\n    let origin: string | string[] | boolean;\n    if (envOrigins) {\n      const list = envOrigins.split(',').map((o) => o.trim()).filter(Boolean);\n      origin = list.length === 1 ? list[0]! : list;\n    } else if (typeof corsOption === 'object' && corsOption.origin !== undefined) {\n      origin = corsOption.origin;\n    } else {\n      origin = true;\n    }\n    const corsOpts = typeof corsOption === 'object' ? { ...corsOption, origin } : { origin };\n    app.use(cors(corsOpts));\n  }\n\n  app.use(express.json());\n  app.use(express.urlencoded({ extended: true }));\n  app.use(cookieParser());\n\n  for (const mw of globalMiddlewares) {\n    app.use(mw);\n  }\n\n  // Pre-Flight step 1: Connect database\n  if (config.database === 'mongodb' && config.databaseUrl) {\n    const conn = await connectMongo(config.databaseUrl);\n    setDbClient(conn as unknown as Record<string, unknown>);\n  }\n\n  // Pre-Flight step 2: Configure auth\n  if (jwtSecret) {\n    const cookieDomain = process.env['COOKIE_DOMAIN'];\n    configureAuth({\n      secret: jwtSecret,\n      strategy: authStrategy,\n      expiresIn: process.env['JWT_EXPIRES_IN'] ?? '7d',\n      ...(cookieDomain !== undefined && { cookieDomain }),\n    });\n  }\n\n  // Pre-Flight step 3: Scan and register tasks\n  if (config.tasksDir) {\n    await scanTasks(config.tasksDir);\n  }\n\n  // Pre-Flight step 4: Start task queue backend\n  if (config.tasks) {\n    if (config.tasks.backend === 'bullmq') {\n      await initBullMQ({\n        redisUrl: config.tasks.redisUrl ?? 'redis://localhost:6379',\n        concurrency: config.tasks.concurrency ?? 5,\n      });\n    }\n  }\n\n  // Pre-Flight step 5: Scan routes and mount\n  const routes = scanDir(apiDir);\n  await mountRoutes(app, routes);\n\n  if (onError) {\n    app.use(onError);\n  } else {\n    app.use(\n      (\n        err: unknown,\n        _req: express.Request,\n        res: express.Response,\n        _next: express.NextFunction,\n      ) => {\n        if (err instanceof HttpError) {\n          res.status(err.statusCode).json({ error: err.message, statusCode: err.statusCode });\n        } else {\n          console.error('[EFC] Unhandled error:', err);\n          res.status(500).json({ error: 'Internal Server Error', statusCode: 500 });\n        }\n      },\n    );\n  }\n\n  await new Promise<void>((resolve) => {\n    app.listen(port, () => {\n      const wid = (cluster.worker as { id: number } | undefined)?.id ?? 'primary';\n      console.log(`[EFC] Worker ${wid} listening on :${port}`);\n      resolve();\n    });\n  });\n}\n\nexport { HttpError } from './errors.js';\nexport { compose } from './compose.js';\nexport { db, setDbClient, getDbClient, defineModel } from './db/index.js';\nexport { scanDir } from './router/scan.js';\nexport type {\n  EFCConfig,\n  CorsConfig,\n  RouteEntry,\n  TaskOptions,\n  TaskDefinition,\n  DatabaseEngine,\n  AuthStrategy,\n  ModelSchema,\n  ModelCRUD,\n} from './types.js';\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\nfunction filePathToUrlPath(relativePath: string): string {\n  let p = relativePath.replace(ROUTE_FILE_RE, '');\n  // index files map to parent path\n  p = p.replace(/\\/index$/, '');\n  // [param] → :param\n  p = p.replace(DYNAMIC_SEGMENT_RE, ':$1');\n  return p === '' ? '/' : p.startsWith('/') ? p : `/${p}`;\n}\n\nfunction extractParams(relativePath: string): string[] {\n  const params: string[] = [];\n  let match: RegExpExecArray | null;\n  const re = new RegExp(DYNAMIC_SEGMENT_RE.source, 'g');\n  while ((match = re.exec(relativePath)) !== null) {\n    if (match[1]) params.push(match[1]);\n  }\n  return params;\n}\n\nexport function scanDir(dir: string, base: string = dir): RouteEntry[] {\n  if (!fs.existsSync(dir)) return [];\n\n  const entries: RouteEntry[] = [];\n  const items = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const item of items) {\n    const fullPath = path.join(dir, item.name);\n    if (item.isDirectory()) {\n      entries.push(...scanDir(fullPath, base));\n    } else if (ROUTE_FILE_RE.test(item.name)) {\n      const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n      entries.push({\n        urlPath: filePathToUrlPath(relative),\n        filePath: fullPath,\n        params: extractParams(relative),\n      });\n    }\n  }\n\n  // Sort: static routes before dynamic ones at each segment level\n  return entries.sort((a, b) => {\n    const aDynamic = a.urlPath.includes(':') ? 1 : 0;\n    const bDynamic = b.urlPath.includes(':') ? 1 : 0;\n    return aDynamic - bDynamic || a.urlPath.localeCompare(b.urlPath);\n  });\n}\n\nexport { filePathToUrlPath };\n","import type { Application, RequestHandler } from 'express';\nimport type { RouteEntry } from '../types.js';\n\nconst HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'] as const;\ntype HttpMethod = (typeof HTTP_METHODS)[number];\n\nfunction asyncWrap(handler: RequestHandler): RequestHandler {\n  return (req, res, next) => {\n    Promise.resolve(handler(req, res, next)).catch(next);\n  };\n}\n\nexport async function mountRoutes(app: Application, routes: RouteEntry[]): Promise<void> {\n  for (const route of routes) {\n    const mod = (await import(route.filePath)) as Record<string, unknown>;\n    const routeMiddlewares: RequestHandler[] = Array.isArray(mod['middlewares'])\n      ? (mod['middlewares'] as RequestHandler[])\n      : [];\n\n    const implemented: HttpMethod[] = [];\n    const unimplemented: HttpMethod[] = [];\n\n    for (const method of HTTP_METHODS) {\n      if (typeof mod[method] === 'function') {\n        implemented.push(method);\n        app[method.toLowerCase() as Lowercase<HttpMethod>](\n          route.urlPath,\n          ...routeMiddlewares,\n          asyncWrap(mod[method] as RequestHandler),\n        );\n      } else {\n        unimplemented.push(method);\n      }\n    }\n\n    if (implemented.length > 0 && unimplemented.length > 0) {\n      const allowHeader = implemented.join(', ');\n      app.all(route.urlPath, (req, res, next) => {\n        if ((unimplemented as string[]).includes(req.method)) {\n          res.set('Allow', allowHeader).status(405).json({ error: 'Method Not Allowed' });\n        } else {\n          next();\n        }\n      });\n    }\n  }\n}\n\nexport { asyncWrap };\n","import cluster from 'node:cluster';\nimport os from 'node:os';\n\ninterface ClusterOptions {\n  workers?: number;\n  onWorkerReady?: ((id: number) => void) | undefined;\n  onWorkerCrash?: ((id: number, code: number) => void) | undefined;\n}\n\nexport function runMaster(options: ClusterOptions = {}): void {\n  const count = options.workers ?? os.cpus().length;\n\n  console.log(`[EFC] Primary ${process.pid} starting ${count} workers`);\n\n  for (let i = 0; i < count; i++) {\n    cluster.fork();\n  }\n\n  cluster.on('online', (worker) => {\n    options.onWorkerReady?.(worker.id);\n  });\n\n  cluster.on('exit', (worker, code, signal) => {\n    const exitCode = code ?? (signal ? -1 : 0);\n    console.warn(`[EFC] Worker ${worker.id} exited (code=${exitCode}), respawning…`);\n    options.onWorkerCrash?.(worker.id, exitCode);\n    cluster.fork();\n  });\n}\n\nexport { cluster };\n","import type { RequestHandler, Response } from 'express';\nimport jwt from 'jsonwebtoken';\nimport type { AuthStrategy } from '../types.js';\n\ninterface AuthConfig {\n  secret: string;\n  strategy: AuthStrategy;\n  expiresIn: string;\n  cookieDomain?: string | undefined;\n}\n\nlet _config: AuthConfig | null = null;\n\nexport function configureAuth(config: AuthConfig): void {\n  _config = config;\n}\n\nfunction getConfig(): AuthConfig {\n  if (!_config) throw new Error('[EFC] Auth not configured — pass jwtSecret to ignite()');\n  return _config;\n}\n\nexport function issueToken(res: Response, payload: Record<string, unknown>): void {\n  const { secret, expiresIn, cookieDomain } = getConfig();\n  // expiresIn is a plain string (e.g. '7d'); cast satisfies jwt's branded StringValue\n  const token = jwt.sign(payload, secret, { expiresIn: expiresIn as jwt.SignOptions['expiresIn'] & string });\n  res.cookie('efc_token', token, {\n    httpOnly: true,\n    secure: process.env['NODE_ENV'] === 'production',\n    sameSite: 'strict',\n    ...(cookieDomain !== undefined && { domain: cookieDomain }),\n  });\n}\n\nexport function revokeToken(res: Response): void {\n  res.clearCookie('efc_token');\n}\n\nexport function signToken(payload: Record<string, unknown>): string {\n  const { secret, expiresIn } = getConfig();\n  return jwt.sign(payload, secret, { expiresIn: expiresIn as jwt.SignOptions['expiresIn'] & string });\n}\n\nexport const requireAuth: RequestHandler = (req, res, next) => {\n  const { secret, strategy } = getConfig();\n\n  try {\n    let token: string | undefined;\n\n    if (strategy === 'http-only') {\n      const cookies = (req as typeof req & { cookies: Record<string, string> }).cookies;\n      token = cookies['efc_token'];\n    } else {\n      const auth = req.headers['authorization'];\n      if (typeof auth === 'string' && auth.startsWith('Bearer ')) {\n        token = auth.slice(7);\n      }\n    }\n\n    if (!token) {\n      res.status(401).json({ error: 'Unauthorized' });\n      return;\n    }\n\n    const decoded = jwt.verify(token, secret);\n    (req as typeof req & { user: unknown }).user = decoded;\n    next();\n  } catch {\n    res.status(401).json({ error: 'Unauthorized' });\n  }\n};\n","export class HttpError extends Error {\n  readonly statusCode: number;\n\n  constructor(statusCode: number, message: string) {\n    super(message);\n    this.name = 'HttpError';\n    this.statusCode = statusCode;\n    Error.captureStackTrace(this, HttpError);\n  }\n}\n","// Wraps mongoose connection for Pre-Flight. Throws clearly if mongoose isn't installed.\n\nlet mongoose: typeof import('mongoose');\n\nasync function loadMongoose(): Promise<typeof import('mongoose')> {\n  if (mongoose) return mongoose;\n  try {\n    mongoose = await import('mongoose');\n    return mongoose;\n  } catch {\n    throw new Error(\n      '[EFC] mongoose is not installed. Run: npm install mongoose',\n    );\n  }\n}\n\nexport async function connectMongo(url: string): Promise<import('mongoose').Connection> {\n  const mg = await loadMongoose();\n  await mg.connect(url);\n  console.log('[EFC] MongoDB connected');\n  return mg.connection;\n}\n","import type { ModelSchema, ModelCRUD } from '../types.js';\n\ntype AnyRecord = Record<string, unknown> & { id: string };\n\nfunction normalise(doc: Record<string, unknown>): AnyRecord {\n  const id = doc['_id'] ? String(doc['_id']) : '';\n  return { ...doc, id } as AnyRecord;\n}\n\nasync function getModel(name: string, schemaObj: Record<string, unknown>): Promise<import('mongoose').Model<Record<string, unknown>>> {\n  let mg: typeof import('mongoose');\n  try {\n    mg = await import('mongoose');\n  } catch {\n    throw new Error('[EFC] mongoose is not installed. Run: npm install mongoose');\n  }\n\n  if (mg.models[name]) return mg.models[name] as import('mongoose').Model<Record<string, unknown>>;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const schema = new mg.Schema(schemaObj as any, { timestamps: true });\n  return mg.model<Record<string, unknown>>(name, schema);\n}\n\nfunction buildMongooseSchema(schema: ModelSchema): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, def] of Object.entries(schema)) {\n    const entry: Record<string, unknown> = {};\n    switch (def.type) {\n      case 'string':   entry['type'] = String; break;\n      case 'number':   entry['type'] = Number; break;\n      case 'boolean':  entry['type'] = Boolean; break;\n      case 'date':     entry['type'] = Date; break;\n      case 'object':   entry['type'] = Object; break;\n      case 'array':    entry['type'] = Array; break;\n    }\n    if (def.required !== undefined) entry['required'] = def.required;\n    if (def.unique !== undefined)   entry['unique'] = def.unique;\n    if (def.default !== undefined)  entry['default'] = def.default;\n    out[key] = entry;\n  }\n  return out;\n}\n\nexport function defineModel<T extends Record<string, unknown>>(\n  name: string,\n  schema: ModelSchema,\n): ModelCRUD<T> {\n  const mongooseSchema = buildMongooseSchema(schema);\n\n  return {\n    async find(filter = {}) {\n      const M = await getModel(name, mongooseSchema);\n      const docs = await M.find(filter as Record<string, unknown>).lean();\n      return (docs as Record<string, unknown>[]).map(normalise) as (T & { id: string })[];\n    },\n\n    async findById(id) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findById(id).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async findOne(filter) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findOne(filter as Record<string, unknown>).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async create(data) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.create(data);\n      return normalise(doc.toObject() as Record<string, unknown>) as T & { id: string };\n    },\n\n    async update(id, data) {\n      const M = await getModel(name, mongooseSchema);\n      const doc = await M.findByIdAndUpdate(id, data, { new: true }).lean();\n      if (!doc) return null;\n      return normalise(doc as Record<string, unknown>) as T & { id: string };\n    },\n\n    async delete(id) {\n      const M = await getModel(name, mongooseSchema);\n      await M.findByIdAndDelete(id);\n    },\n\n    async count(filter = {}) {\n      const M = await getModel(name, mongooseSchema);\n      return M.countDocuments(filter as Record<string, unknown>);\n    },\n  };\n}\n","// Thread-local DB client populated during Pre-Flight.\n// The Proxy ensures callers import `db` once and never null-check it —\n// it throws with a helpful message if accessed before Pre-Flight completes.\n\ntype AnyClient = Record<string, unknown>;\n\nlet _client: AnyClient | null = null;\n\nexport function setDbClient(client: AnyClient): void {\n  _client = client;\n}\n\nexport function getDbClient(): AnyClient {\n  if (!_client) {\n    throw new Error('[EFC] db not ready — accessed before Pre-Flight completed');\n  }\n  return _client;\n}\n\nexport const db: AnyClient = new Proxy({} as AnyClient, {\n  get(_target, prop: string) {\n    return getDbClient()[prop];\n  },\n  set(_target, prop: string, value: unknown) {\n    getDbClient()[prop] = value;\n    return true;\n  },\n});\n\nexport { connectMongo } from './mongo.js';\nexport { defineModel } from './model.js';\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { registerTask } from './index.js';\nimport type { TaskDefinition } from '../types.js';\n\nexport async function scanTasks(tasksDir: string): Promise<void> {\n  if (!fs.existsSync(tasksDir)) return;\n\n  const files = fs.readdirSync(tasksDir).filter((f) => /\\.(ts|js|mts|mjs)$/.test(f));\n\n  for (const file of files) {\n    const filePath = path.join(tasksDir, file);\n    const taskName = path.basename(file, path.extname(file));\n\n    try {\n      const mod = await import(filePath) as Record<string, unknown>;\n      const def = mod['default'] as TaskDefinition | undefined;\n\n      if (!def || typeof def.handler !== 'function') {\n        console.warn(`[EFC] Task file ${file} has no valid default export — skipping`);\n        continue;\n      }\n\n      registerTask(taskName, { ...def, filePath });\n      console.log(`[EFC] Registered task: ${taskName}`);\n    } catch (err) {\n      console.warn(`[EFC] Failed to load task ${file}:`, err);\n    }\n  }\n}\n","import type { TaskDefinition, TaskOptions } from '../types.js';\n\nexport const taskRegistry = new Map<string, TaskDefinition>();\n\ntype HandlerFn<T> = (payload: T) => Promise<void>;\ntype DefineTaskOverload = {\n  <T>(handler: HandlerFn<T>): TaskDefinition<T>;\n  <T>(options: TaskOptions, handler: HandlerFn<T>): TaskDefinition<T>;\n};\n\nexport const defineTask: DefineTaskOverload = <T>(\n  handlerOrOptions: HandlerFn<T> | TaskOptions,\n  maybeHandler?: HandlerFn<T>,\n): TaskDefinition<T> => {\n  let options: TaskOptions = {};\n  let handler: HandlerFn<T>;\n\n  if (typeof handlerOrOptions === 'function') {\n    handler = handlerOrOptions;\n  } else {\n    options = handlerOrOptions;\n    if (!maybeHandler) throw new Error('[EFC] defineTask: handler function is required');\n    handler = maybeHandler;\n  }\n\n  return {\n    handler: handler as (payload: unknown) => Promise<void>,\n    options,\n    name: '',\n  };\n};\n\ntype EnqueueImpl = (name: string, payload: unknown) => Promise<void>;\nlet _impl: EnqueueImpl | null = null;\n\nexport function setEnqueueImpl(impl: EnqueueImpl): void {\n  _impl = impl;\n}\n\nexport async function enqueue<T>(name: string, payload: T): Promise<void> {\n  if (!_impl) {\n    throw new Error(\n      `[EFC] Task queue not initialised. Set tasks.backend in ignite() config.`,\n    );\n  }\n  return _impl(name, payload as unknown);\n}\n\nexport function registerTask(name: string, def: TaskDefinition): void {\n  taskRegistry.set(name, { ...def, name });\n}\n","import { Worker, workerData, parentPort, isMainThread } from 'node:worker_threads';\nimport type { TaskDefinition } from '../types.js';\n\n// ── Worker-thread side ────────────────────────────────────────────────────────\nif (!isMainThread) {\n  const { handlerPath, payload } = workerData as { handlerPath: string; payload: unknown };\n\n  (async () => {\n    try {\n      const mod = await import(handlerPath) as Record<string, unknown>;\n      const def = mod['default'] as TaskDefinition | undefined;\n      if (!def || typeof def.handler !== 'function') {\n        throw new Error(`[EFC] Thread runner: no valid task export in ${handlerPath}`);\n      }\n      await def.handler(payload);\n      parentPort?.postMessage({ ok: true });\n    } catch (err) {\n      parentPort?.postMessage({ ok: false, error: String(err) });\n    }\n  })();\n}\n\n// ── Main-thread side ──────────────────────────────────────────────────────────\nexport function runInThread(handlerPath: string, payload: unknown): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const worker = new Worker(new URL('./thread-runner.js', import.meta.url), {\n      workerData: { handlerPath, payload },\n    });\n\n    worker.on('message', (msg: { ok: boolean; error?: string }) => {\n      if (msg.ok) resolve();\n      else reject(new Error(msg.error ?? 'Thread task failed'));\n    });\n\n    worker.on('error', reject);\n    worker.on('exit', (code) => {\n      if (code !== 0) reject(new Error(`Thread worker exited with code ${code}`));\n    });\n  });\n}\n","import type { Job } from 'bullmq';\nimport { taskRegistry, setEnqueueImpl } from './index.js';\nimport { runInThread } from './thread-runner.js';\n\ninterface BullMQOpts {\n  redisUrl: string;\n  concurrency: number;\n}\n\nexport async function initBullMQ(opts: BullMQOpts): Promise<void> {\n  let bullmq: typeof import('bullmq');\n  try {\n    bullmq = await import('bullmq');\n  } catch {\n    throw new Error('[EFC] bullmq is not installed. Run: npm install bullmq');\n  }\n\n  const connection = parseRedisUrl(opts.redisUrl);\n  const queue = new bullmq.Queue('efc', { connection });\n\n  const worker = new bullmq.Worker(\n    'efc',\n    async (job: Job) => {\n      const def = taskRegistry.get(job.name);\n      if (!def) {\n        throw new Error(`[EFC] No task registered for name: ${job.name}`);\n      }\n\n      if (def.options.thread && def.filePath) {\n        await runInThread(def.filePath, job.data);\n      } else {\n        await def.handler(job.data);\n      }\n    },\n    { connection, concurrency: opts.concurrency },\n  );\n\n  worker.on('failed', (job: Job | undefined, err: Error) => {\n    console.error(`[EFC] Task ${job?.name ?? 'unknown'} failed:`, err.message);\n  });\n\n  worker.on('completed', (job: Job) => {\n    console.log(`[EFC] Task ${job.name} completed (id=${job.id})`);\n  });\n\n  setEnqueueImpl(async (name, payload) => {\n    const def = taskRegistry.get(name);\n    if (!def) {\n      throw new Error(`[EFC] Cannot enqueue unknown task: \"${name}\". Is the task file in tasksDir?`);\n    }\n\n    await queue.add(name, payload, {\n      attempts: def.options.retries ?? 3,\n      backoff: {\n        type: def.options.backoff ?? 'exponential',\n        delay: 1000,\n      },\n    });\n  });\n\n  console.log('[EFC] BullMQ backend initialised');\n}\n\nfunction parseRedisUrl(url: string): { host: string; port: number; password?: string } {\n  try {\n    const u = new URL(url);\n    const result: { host: string; port: number; password?: string } = {\n      host: u.hostname || 'localhost',\n      port: parseInt(u.port || '6379', 10),\n    };\n    if (u.password) result.password = u.password;\n    return result;\n  } catch {\n    return { host: 'localhost', port: 6379 };\n  }\n}\n","import type { RequestHandler } from 'express';\n\nexport function compose(...handlers: RequestHandler[]): RequestHandler {\n  return (req, res, next) => {\n    let index = 0;\n\n    function dispatch(i: number): void {\n      if (i >= handlers.length) {\n        next();\n        return;\n      }\n      const handler = handlers[i];\n      if (!handler) {\n        next();\n        return;\n      }\n      try {\n        Promise.resolve(handler(req, res, () => dispatch(i + 1))).catch(next);\n      } catch (err) {\n        next(err);\n      }\n    }\n\n    dispatch(index);\n  };\n}\n"],"mappings":"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","names":["cluster","os","fs","path","fs","path","cluster","os"]}

package/dist/tasks/index.d.cts

@@ -1,4 +1,4 @@
-import { T as TaskDefinition, a as TaskOptions } from '../types-DNdkDUPX.cjs';
+import { T as TaskDefinition, a as TaskOptions } from '../types-CkpRAA3y.cjs';
 import 'express';
 
 declare const taskRegistry: Map<string, TaskDefinition<unknown>>;

package/dist/tasks/index.d.ts

@@ -1,4 +1,4 @@
-import { T as TaskDefinition, a as TaskOptions } from '../types-DNdkDUPX.js';
+import { T as TaskDefinition, a as TaskOptions } from '../types-CkpRAA3y.js';
 import 'express';
 
 declare const taskRegistry: Map<string, TaskDefinition<unknown>>;

package/dist/{types-DNdkDUPX.d.cts → types-CkpRAA3y.d.cts}

@@ -8,6 +8,13 @@ interface TaskConfig {
     redisUrl?: string;
     concurrency?: number;
 }
+interface CorsConfig {
+    origin?: string | string[] | boolean;
+    methods?: string | string[];
+    allowedHeaders?: string | string[];
+    credentials?: boolean;
+    maxAge?: number;
+}
 interface EFCConfig {
     port?: number;
     apiDir: string;
@@ -19,6 +26,7 @@ interface EFCConfig {
     cluster?: boolean;
     workers?: number;
     tasks?: TaskConfig | false;
+    cors?: boolean | CorsConfig;
     globalMiddlewares?: RequestHandler[];
     onWorkerReady?: (id: number) => void;
     onWorkerCrash?: (id: number, code: number) => void;
@@ -67,4 +75,4 @@ interface ModelCRUD<T extends Record<string, unknown>> {
     count(filter?: Partial<T>): Promise<number>;
 }
 
-export type { AuthStrategy as A, DatabaseEngine as D, EFCConfig as E, ModelSchema as M, RouteEntry as R, TaskDefinition as T, TaskOptions as a, ModelCRUD as b };
+export type { AuthStrategy as A, CorsConfig as C, DatabaseEngine as D, EFCConfig as E, ModelSchema as M, RouteEntry as R, TaskDefinition as T, TaskOptions as a, ModelCRUD as b };

package/dist/{types-DNdkDUPX.d.ts → types-CkpRAA3y.d.ts}

@@ -8,6 +8,13 @@ interface TaskConfig {
     redisUrl?: string;
     concurrency?: number;
 }
+interface CorsConfig {
+    origin?: string | string[] | boolean;
+    methods?: string | string[];
+    allowedHeaders?: string | string[];
+    credentials?: boolean;
+    maxAge?: number;
+}
 interface EFCConfig {
     port?: number;
     apiDir: string;
@@ -19,6 +26,7 @@ interface EFCConfig {
     cluster?: boolean;
     workers?: number;
     tasks?: TaskConfig | false;
+    cors?: boolean | CorsConfig;
     globalMiddlewares?: RequestHandler[];
     onWorkerReady?: (id: number) => void;
     onWorkerCrash?: (id: number, code: number) => void;
@@ -67,4 +75,4 @@ interface ModelCRUD<T extends Record<string, unknown>> {
     count(filter?: Partial<T>): Promise<number>;
 }
 
-export type { AuthStrategy as A, DatabaseEngine as D, EFCConfig as E, ModelSchema as M, RouteEntry as R, TaskDefinition as T, TaskOptions as a, ModelCRUD as b };
+export type { AuthStrategy as A, CorsConfig as C, DatabaseEngine as D, EFCConfig as E, ModelSchema as M, RouteEntry as R, TaskDefinition as T, TaskOptions as a, ModelCRUD as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "express-file-cluster",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Enterprise-grade, zero-boilerplate backend framework with file-based routing and multi-core clustering",
   "license": "MIT",
   "type": "module",
@@ -37,11 +37,14 @@
     "chokidar": "^4.0.0",
     "commander": "^12.0.0",
     "cookie-parser": "^1.4.6",
+    "cors": "^2.8.6",
+    "dotenv": "^17.4.2",
     "express": "^4.19.0",
     "jsonwebtoken": "^9.0.0"
   },
   "devDependencies": {
     "@types/cookie-parser": "^1.4.7",
+    "@types/cors": "^2.8.19",
     "@types/express": "^4.17.21",
     "@types/jsonwebtoken": "^9.0.6",
     "@types/node": "^22.0.0",

package/src/cli/commands/start.ts

@@ -24,6 +24,16 @@ export function startCommand(): Command {
   return cmd;
 }
 
+function buildDevEnv(cwd: string): NodeJS.ProcessEnv {
+  const env: NodeJS.ProcessEnv = { ...process.env, NODE_ENV: 'development' };
+  const envFile = path.join(cwd, '.env');
+  if (fs.existsSync(envFile)) {
+    const existing = (process.env['NODE_OPTIONS'] ?? '').trim();
+    env['NODE_OPTIONS'] = `${existing} --env-file ${envFile}`.trim();
+  }
+  return env;
+}
+
 function startDev(): void {
   const entry = resolveEntry();
   if (!entry) {
@@ -34,11 +44,14 @@ function startDev(): void {
   console.log(chalk.cyan('[EFC] Starting development server…'));
   console.log(chalk.dim(`  Entry: ${entry}`));
 
-  const child = spawn(
-    'node',
-    ['--import', 'tsx/esm', '--watch', entry],
-    { stdio: 'inherit', env: { ...process.env, NODE_ENV: 'development' } },
-  );
+  const cwd = process.cwd();
+  const localTsx = path.join(cwd, 'node_modules', '.bin', 'tsx');
+  const tsx = fs.existsSync(localTsx) ? localTsx : 'tsx';
+
+  const child = spawn(tsx, ['watch', entry], {
+    stdio: 'inherit',
+    env: buildDevEnv(cwd),
+  });
 
   child.on('exit', (code) => process.exit(code ?? 0));
 }
@@ -54,7 +67,10 @@ function startProd(): void {
 
   console.log(chalk.cyan('[EFC] Starting production server…'));
 
-  const child = spawn('node', [distEntry], {
+  const envFile = path.join(cwd, '.env');
+  const nodeArgs = fs.existsSync(envFile) ? ['--env-file', envFile, distEntry] : [distEntry];
+
+  const child = spawn('node', nodeArgs, {
     stdio: 'inherit',
     env: { ...process.env, NODE_ENV: 'production' },
   });

package/src/index.ts

@@ -1,4 +1,6 @@
+import 'dotenv/config';
 import express from 'express';
+import cors from 'cors';
 import cookieParser from 'cookie-parser';
 import cluster from 'node:cluster';
 import os from 'node:os';
@@ -15,7 +17,7 @@ import { initBullMQ } from './tasks/bullmq-backend.js';
 
 export async function ignite(config: EFCConfig): Promise<void> {
   const {
-    port = 3000,
+    port: _port,
     cluster: clusterEnabled = true,
     workers,
     apiDir,
@@ -27,6 +29,11 @@ export async function ignite(config: EFCConfig): Promise<void> {
     onError,
   } = config;
 
+  const port =
+    _port != null && !Number.isNaN(_port)
+      ? _port
+      : Number(process.env['PORT']) || 3000;
+
   if (clusterEnabled && cluster.isPrimary) {
     runMaster({
       workers: workers ?? os.cpus().length,
@@ -38,6 +45,22 @@ export async function ignite(config: EFCConfig): Promise<void> {
 
   const app = express();
 
+  const corsOption = config.cors ?? true;
+  if (corsOption !== false) {
+    const envOrigins = process.env['CORS_ORIGINS'];
+    let origin: string | string[] | boolean;
+    if (envOrigins) {
+      const list = envOrigins.split(',').map((o) => o.trim()).filter(Boolean);
+      origin = list.length === 1 ? list[0]! : list;
+    } else if (typeof corsOption === 'object' && corsOption.origin !== undefined) {
+      origin = corsOption.origin;
+    } else {
+      origin = true;
+    }
+    const corsOpts = typeof corsOption === 'object' ? { ...corsOption, origin } : { origin };
+    app.use(cors(corsOpts));
+  }
+
   app.use(express.json());
   app.use(express.urlencoded({ extended: true }));
   app.use(cookieParser());
@@ -117,6 +140,7 @@ export { db, setDbClient, getDbClient, defineModel } from './db/index.js';
 export { scanDir } from './router/scan.js';
 export type {
   EFCConfig,
+  CorsConfig,
   RouteEntry,
   TaskOptions,
   TaskDefinition,

package/src/types.ts

@@ -10,6 +10,14 @@ export interface TaskConfig {
   concurrency?: number;
 }
 
+export interface CorsConfig {
+  origin?: string | string[] | boolean;
+  methods?: string | string[];
+  allowedHeaders?: string | string[];
+  credentials?: boolean;
+  maxAge?: number;
+}
+
 export interface EFCConfig {
   port?: number;
   apiDir: string;
@@ -21,6 +29,7 @@ export interface EFCConfig {
   cluster?: boolean;
   workers?: number;
   tasks?: TaskConfig | false;
+  cors?: boolean | CorsConfig;
   globalMiddlewares?: RequestHandler[];
   onWorkerReady?: (id: number) => void;
   onWorkerCrash?: (id: number, code: number) => void;