express-file-cluster 0.12.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/shutdown.ts","../src/index.ts","../src/cluster/index.ts","../src/tasks/scanner.ts","../src/dashboard.ts","../src/rate-limit.ts","../src/cache/response.ts","../src/compose.ts"],"sourcesContent":["interface DrainOptions {\n transports: Promise<unknown>[];\n tasks: Array<() => Promise<unknown>>;\n cache: () => Promise<unknown>;\n tracing: () => Promise<unknown>;\n}\n/** Drain every producer/consumer before removing shared dependencies. Fail only\n * after all cleanup attempts, so a fast failure cannot cut off a slower job. */\nexport async function drainServices(options: DrainOptions): Promise<void> {\n const errors: unknown[] = [];\n const outcomes = await Promise.allSettled([\n ...options.transports,\n ...options.tasks.map((close) => Promise.resolve().then(close)),\n ]);\n for (const outcome of outcomes) if (outcome.status === 'rejected') errors.push(outcome.reason);\n for (const close of [options.cache, options.tracing]) {\n try {\n await close();\n } catch (error) {\n errors.push(error);\n }\n }\n if (errors.length) throw new AggregateError(errors, 'Service shutdown failed');\n}\n","import { drainServices } from './shutdown.js';\nimport { configureTracing, shutdownTracing } from './tracing.js';\nimport http from 'node:http';\nimport fs from 'node:fs';\nimport express from 'express';\nimport cluster from 'node:cluster';\nimport os from 'node:os';\nimport path from 'node:path';\nimport type { EFCConfig, MountedRoute } from './types.js';\nexport type {\n TableModel,\n TableRecord,\n TableCreateInput,\n TableWhere,\n TableWhereUnique,\n TableUpdateData,\n TableCreateData,\n TableUpdateInput,\n TableOrderBy,\n TableSelect,\n TableInclude,\n TableResult,\n Tables,\n TableFindManyArgs,\n TableAggregateArgs,\n TableGroupByArgs,\n TableAggregateResult,\n ScalarFilter,\n StringFilter,\n ListFilter,\n JsonFilter,\n InferTableRecord,\n} from './table-types.js';\nimport { scanDir } from './router/scan.js';\nimport { mountRoutes } from './router/mount.js';\nimport { mountOpenAPI } from './openapi.js';\nimport { attachWebSockets, closeWebSockets } from './websocket.js';\nimport { runMaster, shutdownMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { setDbEngine, setAutoSync } from './db/engine.js';\nimport { checkConnectionBudget, connectPostgres } from './db/postgres.js';\nimport { configureLogger, getLogger } from './logger.js';\nimport { configureQueryLog } from './db/query-log.js';\nimport { scanTasks } from './tasks/scanner.js';\nimport { initBullMQ, closeBullMQ } from './tasks/bullmq-backend.js';\nimport { initPgBoss, closePgBoss } from './tasks/pgboss-backend.js';\nimport { configureCache, closeCache } from './cache/index.js';\nimport { servePrimaryCache } from './cache/ipc.js';\nimport { generateDashboard } from './dashboard.js';\nimport { createHttpApp, mountErrorHandler } from './http-app.js';\n\nfunction detectDatabase(url?: string): 'mongodb' | 'postgresql' | undefined {\n if (!url) return undefined;\n if (url.startsWith('mongodb')) return 'mongodb';\n if (url.startsWith('postgres')) return 'postgresql';\n return undefined;\n}\n\nexport async function ignite(config: EFCConfig): Promise<http.Server | undefined> {\n const { port: _port, workers, onWorkerReady, onWorkerCrash, onError } = config;\n\n // Resolve api/tasks dirs from convention. argv[1]-based resolution is unreliable in tsx watch\n // + cluster workers (argv[1] can point to the tsx binary instead of the user's script), so we\n // probe multiple candidates and use the first that exists on disk.\n function resolveConventionDir(name: string): string {\n const candidates: string[] = [\n ...(process.argv[1] ? [path.join(path.dirname(process.argv[1]), name)] : []),\n path.join(process.cwd(), 'src', name),\n path.join(process.cwd(), name),\n path.join(process.cwd(), 'dist', name),\n ];\n return candidates.find((c) => fs.existsSync(c)) ?? candidates[0]!;\n }\n const apiDir = resolveConventionDir('api');\n const tasksDir = resolveConventionDir('tasks');\n const basePath = config.basePath ?? '/v1/api';\n\n function readProjectMeta(): { name: string; version: string } {\n try {\n const raw = fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8');\n const pkg = JSON.parse(raw) as { name?: string; version?: string };\n return { name: pkg.name ?? 'API', version: pkg.version ?? '' };\n } catch {\n return { name: 'API', version: '' };\n }\n }\n\n const port = _port != null && !Number.isNaN(_port) ? _port : 3000;\n const databaseUrl = config.databaseUrl;\n const database = config.database ?? detectDatabase(databaseUrl);\n const jwtSecret = config.jwtSecret;\n const authStrategy = config.authStrategy ?? 'http-only';\n // NODE_ENV is a Node/Express-wide runtime-mode signal set by the platform, not an app\n // secret — unlike PORT/DATABASE_URL/JWT_SECRET/etc. this one is still read directly.\n const clusterEnabled = config.cluster ?? process.env['NODE_ENV'] === 'production';\n\n configureLogger(config.logging);\n // Any value but 'http-only' acts as bearer, as it always has — an app may rely on that, so\n // 0.9.x only warns (a typo of 'http-only' silently means no cookie). 1.0 makes it an error.\n if (\n !['http-only', 'bearer', 'localStorage'].includes(authStrategy) &&\n (!clusterEnabled || cluster.isPrimary) // once, not once per worker\n ) {\n getLogger().warn(\n `[EFC] Unknown authStrategy \"${String(authStrategy)}\" — treated as 'bearer'. Use 'http-only' or 'bearer'; this will be an error in 1.0.`,\n );\n }\n // HS256 with a short secret can be brute-forced offline from any token a user holds.\n if (\n jwtSecret &&\n Buffer.byteLength(jwtSecret) < 32 &&\n process.env['NODE_ENV'] === 'production' &&\n (!clusterEnabled || cluster.isPrimary)\n ) {\n getLogger().warn(\n `[EFC] jwtSecret is ${Buffer.byteLength(jwtSecret)} bytes — use at least 32 random bytes in production (openssl rand -hex 64).`,\n );\n }\n configureQueryLog(config.logging);\n configureTracing(config.tracing);\n\n if (clusterEnabled && cluster.isPrimary) {\n // The memory cache lives in the primary so all workers share it (cache/ipc.ts).\n if (config.cache && config.cache.backend === 'memory') {\n servePrimaryCache(config.cache.maxEntries ?? 10_000);\n }\n runMaster({\n workers: workers ?? os.cpus().length,\n ...(onWorkerReady !== undefined && { onWorkerReady }),\n ...(onWorkerCrash !== undefined && { onWorkerCrash }),\n });\n return;\n }\n\n const app = createHttpApp(config);\n\n // Pre-Flight step 1: Connect database. The engine decides what defineModel compiles to.\n if (database) setDbEngine(database);\n setAutoSync(config.autoSync ?? true);\n // Pools are per worker; one process per machine reports the machine's total.\n const poolWorkers = clusterEnabled ? (workers ?? os.cpus().length) : 1;\n const reportsPools = !clusterEnabled || cluster.worker?.id === 1;\n if (database === 'mongodb' && databaseUrl) {\n const conn = await connectMongo(databaseUrl, config.databasePool);\n setDbClient(conn as unknown as Record<string, unknown>);\n if (reportsPools) {\n const max = config.databasePool?.max ?? 100; // mongoose's maxPoolSize default\n getLogger().info(\n `MongoDB connections: up to ${poolWorkers * max} from this machine (${poolWorkers} worker(s) × maxPoolSize ${max})`,\n );\n }\n } else if (database === 'postgresql' && databaseUrl) {\n const pool = await connectPostgres(databaseUrl, config.databasePool);\n setDbClient(pool as unknown as Record<string, unknown>);\n if (reportsPools) {\n const max = config.databasePool?.max ?? 10; // node-postgres' default\n // pg-boss on the same database opens its own pool (node-postgres default 10).\n const boss =\n config.tasks && config.tasks.backend === 'pg-boss' && !config.tasks.connectionString\n ? 10\n : 0;\n const breakdown = `${poolWorkers} worker(s) × (pool ${max}${boss ? ` + pg-boss ${boss}` : ''})`;\n await checkConnectionBudget(poolWorkers * (max + boss), breakdown);\n }\n }\n\n // Pre-Flight step 1b: Cache (also the session-revocation store requireAuth consults)\n if (config.cache) {\n await configureCache(config.cache);\n }\n\n // Pre-Flight step 2: Configure auth\n if (jwtSecret) {\n configureAuth({\n secret: jwtSecret,\n strategy: authStrategy,\n expiresIn: config.jwtExpiresIn ?? '7d',\n ...(config.cookieDomain !== undefined && { cookieDomain: config.cookieDomain }),\n });\n }\n\n // Pre-Flight step 3: Scan and register tasks\n if (tasksDir) {\n await scanTasks(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 tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),\n redisUrl: config.tasks.redisUrl ?? 'redis://localhost:6379',\n concurrency: config.tasks.concurrency ?? 5,\n enqueueTimeout: config.tasks.enqueueTimeout ?? 5000,\n queue: config.tasks.queue ?? 'efc',\n });\n } else if (config.tasks.backend === 'pg-boss') {\n const connectionString = config.tasks.connectionString ?? databaseUrl;\n if (!connectionString) {\n throw new Error(\n '[EFC] tasks.backend \"pg-boss\" needs tasks.connectionString or databaseUrl',\n );\n }\n await initPgBoss({\n tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),\n connectionString,\n concurrency: config.tasks.concurrency ?? 5,\n enqueueTimeout: config.tasks.enqueueTimeout ?? 5000,\n queue: config.tasks.queue ?? 'efc',\n ...(config.tasks.schema !== undefined && { schema: config.tasks.schema }),\n });\n }\n }\n\n // Pre-Flight step 5: Scan routes and mount\n const routes = scanDir(apiDir);\n const apiRouter = express.Router();\n const mounted: MountedRoute[] = await mountRoutes(apiRouter, routes);\n if (config.openapi) {\n const meta = readProjectMeta();\n const options = config.openapi === true ? {} : config.openapi;\n await mountOpenAPI(app, mounted, {\n info: { title: meta.name, version: meta.version },\n ...options,\n basePath,\n });\n }\n app.use(basePath, apiRouter);\n\n if (config.dashboard !== false && process.env['NODE_ENV'] === 'development') {\n app.get('/', (_req, res) => {\n const { name, version } = readProjectMeta();\n res.setHeader('Content-Type', 'text/html; charset=utf-8');\n res.send(generateDashboard(mounted, basePath, port, name, version));\n });\n }\n\n mountErrorHandler(app, onError);\n\n return new Promise<http.Server>((resolve, reject) => {\n const server = http.createServer(app);\n if (config.websocket !== false && mounted.some((route) => route.websocket))\n attachWebSockets(server, app, config.websocket);\n\n server.once('listening', () => {\n const wid = (cluster.worker as { id: number } | undefined)?.id ?? 'primary';\n const addr = server.address() as { port: number } | null;\n getLogger().info(`Worker ${wid} listening on :${addr?.port ?? port}`);\n resolve(server);\n });\n\n server.once('error', reject);\n server.listen(port);\n });\n}\n\nexport function gracefulShutdown(server: http.Server | undefined, timeoutMs = 10_000): void {\n let shuttingDown = false;\n const shutdown = (signal: string) => {\n // A worker can get the signal twice (process-group Ctrl+C plus the primary's\n // forward); the default handler for a repeat would kill it mid-drain.\n if (shuttingDown) return;\n shuttingDown = true;\n getLogger().info(`${signal} received — closing server gracefully…`);\n if (server) {\n const websocketDrain = closeWebSockets(server, Math.max(1, Math.min(1000, timeoutMs / 2)));\n server.closeIdleConnections();\n server.close(() => {\n getLogger().info('Server closed');\n // Let in-flight task jobs finish before exiting; the timeout below still caps it.\n drainServices({\n transports: [websocketDrain],\n tasks: [closeBullMQ, closePgBoss],\n cache: closeCache,\n tracing: shutdownTracing,\n }).then(\n () => process.exit(0),\n (err: unknown) => {\n getLogger().error({ err }, 'Service shutdown failed');\n process.exit(1);\n },\n );\n });\n setTimeout(() => {\n getLogger().error('Forced exit after timeout');\n process.exit(1);\n }, timeoutMs).unref();\n } else {\n shutdownMaster();\n // Workers get the same budget plus a margin before the primary gives up on them.\n setTimeout(() => {\n getLogger().error('Workers did not exit in time — forcing primary exit');\n process.exit(1);\n }, timeoutMs + 2_000).unref();\n }\n };\n process.on('SIGTERM', () => shutdown('SIGTERM'));\n process.on('SIGINT', () => shutdown('SIGINT'));\n}\n\nexport { HttpError, isHttpError } from './errors.js';\nexport { logger, getLogger } from './logger.js';\nexport { getQueryMetrics, resetQueryMetrics } from './db/query-log.js';\nexport type { QueryMetric, QueryMetricsSnapshot } from './db/query-log.js';\nexport { cache } from './cache/index.js';\nexport { rateLimit } from './rate-limit.js';\nexport type { RateLimitOptions } from './rate-limit.js';\nexport { cacheResponse } from './cache/response.js';\nexport { compose } from './compose.js';\nexport {\n db,\n setDbClient,\n getDbClient,\n defineModel,\n defineTable,\n defineCollection,\n} from './db/index.js';\nexport type {\n CollectionModel,\n CollectionOptions,\n CollectionFilter,\n CollectionUpdate,\n CollectionFindOptions,\n CollectionWriteResult,\n CollectionBulkResult,\n CollectionBulkOp,\n CollectionChange,\n CollectionChangeStream,\n} from './db/collection-model.js';\nexport type {\n Pipeline,\n FieldRef,\n Accumulator,\n GroupResult,\n LookedUp,\n LookupTarget,\n} from './db/pipeline.js';\nexport { transaction } from './db/transaction.js';\nexport { ModelValidationError } from './db/schema.js';\nexport { scanDir } from './router/scan.js';\nexport { listTasks } from './tasks/index.js';\nexport { workerCount } from './cluster/index.js';\nexport type {\n EFCConfig,\n DatabasePoolConfig,\n CollectionSchema,\n CollectionFieldDefinition,\n GeoPoint,\n CorsConfig,\n RouteEntry,\n RouteMeta,\n RouteMethodMeta,\n RouteSchema,\n LoggingConfig,\n QueryLogConfig,\n CacheConfig,\n RequestSchema,\n Validator,\n ValidationIssue,\n TaskOptions,\n TaskDefinition,\n DatabaseEngine,\n AuthStrategy,\n ModelSchema,\n TableSchema,\n TableSchemaField,\n TableFieldDefinition,\n TableOptions,\n TableRelation,\n MigrationContext,\n SchemaField,\n Filter,\n FilterOperators,\n Update,\n FindOptions,\n IndexDefinition,\n ModelRecord,\n InferRecord,\n InferCreate,\n InferSchema,\n InferCreateInput,\n ScalarKeys,\n SortDirection,\n ModelCRUD,\n ModelQueryOptions,\n ModelOptions,\n FieldDefinition,\n DefaultOperator,\n} from './types.js';\n\nexport { generateOpenAPI } from './openapi.js';\nexport type { OpenAPIOptions, OpenAPIDocument, JSONSchema } from './openapi.js';\nexport { attachWebSockets, closeWebSockets } from './websocket.js';\nexport type { WebSocketHandler, WebSocketOptions } from './websocket.js';\n\nexport type { TracingOptions } from './tracing.js';\n","import cluster from 'node:cluster';\nimport { getLogger } from '../logger.js';\n\ninterface ClusterOptions {\n workers?: number;\n onWorkerReady?: ((id: number) => void) | undefined;\n onWorkerCrash?: ((id: number, code: number) => void) | undefined;\n}\n\nlet isShuttingDown = false;\n\n/**\n * Returns the number of currently alive (not yet exited) cluster workers.\n * Returns `0` when running in single-process mode.\n */\nexport function workerCount(): number {\n return Object.keys(cluster.workers ?? {}).length;\n}\n\nexport function shutdownMaster(): void {\n isShuttingDown = true;\n getLogger().info(`Cluster primary (pid=${process.pid}) shutting down, waiting for workers…`);\n if (workerCount() === 0) process.exit(0);\n // Orchestrators (docker stop, k8s) signal only PID 1 — the primary — so forward the\n // signal; each worker's gracefulShutdown drains its server and exits on its own.\n for (const worker of Object.values(cluster.workers ?? {})) {\n worker?.process.kill('SIGTERM');\n }\n}\n\nexport function runMaster(options: ClusterOptions = {}): void {\n const count = options.workers ?? 1;\n\n getLogger().info(`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 if (isShuttingDown) {\n getLogger().info(`Worker ${worker.id} gracefully exited`);\n if (workerCount() === 0) {\n getLogger().info('All workers exited. Primary exiting.');\n process.exit(0);\n }\n return;\n }\n\n getLogger().warn(`Worker ${worker.id} exited (code=${exitCode}), respawning…`);\n options.onWorkerCrash?.(worker.id, exitCode);\n cluster.fork();\n });\n}\n\nexport { cluster };\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { registerTask } from './index.js';\nimport { getLogger } from '../logger.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 getLogger().warn(`Task file ${file} has no valid default export — skipping`);\n continue;\n }\n\n registerTask(taskName, { ...def, filePath });\n getLogger().debug(`Registered task: ${taskName}`);\n } catch (err) {\n getLogger().warn({ err }, `Failed to load task ${file}`);\n }\n }\n}\n","import type { MountedRoute } from './types.js';\n\nconst HTTP_STATUS: Record<number, string> = {\n 200: 'OK',\n 201: 'Created',\n 202: 'Accepted',\n 204: 'No Content',\n 400: 'Bad Request',\n 401: 'Unauthorized',\n 403: 'Forbidden',\n 404: 'Not Found',\n 405: 'Method Not Allowed',\n 409: 'Conflict',\n 422: 'Unprocessable Entity',\n 500: 'Internal Server Error',\n 503: 'Service Unavailable',\n};\n\nexport function generateDashboard(\n routes: MountedRoute[],\n basePath: string,\n port: number,\n projectName: string,\n projectVersion: string,\n): string {\n const safeRoutes = JSON.stringify(\n routes.map((r) => ({\n urlPath: r.urlPath,\n methods: r.websocket ? [...r.methods, 'WS'] : r.methods,\n params: r.params,\n meta: r.meta ?? null,\n })),\n ).replace(/<\\/script>/gi, '<\\\\/script>');\n const safeHttpStatus = JSON.stringify(HTTP_STATUS);\n\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>${projectName} — API Reference</title>\n <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n <link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin />\n <link href=\"https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap\" rel=\"stylesheet\" />\n <style>\n *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\n :root {\n --bg: #080b0f;\n --bg-card: #0d1117;\n --bg-raised: #111820;\n --border: #1e2832;\n --border-lit: #263040;\n --text: #e2e8f0;\n --text-dim: #64748b;\n --text-muted: #334155;\n --accent: #F0A030;\n --accent-dim: rgba(240,160,48,.12);\n --accent-glow: rgba(240,160,48,.22);\n --purple: #a78bfa;\n --blue: #60a5fa;\n --orange: #fb923c;\n --green: #7AAE8E;\n --radius: 10px;\n --radius-lg: 16px;\n --font-mono: 'JetBrains Mono', monospace;\n --font-sans: 'Inter', sans-serif;\n }\n html { scroll-behavior: smooth; }\n body {\n background: var(--bg); color: var(--text);\n font-family: var(--font-sans); font-size: 16px;\n line-height: 1.6; -webkit-font-smoothing: antialiased;\n position: relative;\n }\n body::before {\n content: ''; position: fixed; inset: 0; z-index: 0;\n background-image:\n linear-gradient(var(--border) 1px, transparent 1px),\n linear-gradient(90deg, var(--border) 1px, transparent 1px);\n background-size: 60px 60px; opacity: .28; pointer-events: none;\n }\n section, footer, .page-hero, .docs-layout { position: relative; z-index: 1; }\n a { text-decoration: none; color: inherit; }\n em { font-style: italic; }\n code {\n font-family: var(--font-mono); font-size: .85em;\n background: var(--bg-raised); border: 1px solid var(--border);\n border-radius: 4px; padding: 1px 6px; color: var(--accent);\n }\n .container { max-width: 1140px; margin: 0 auto; padding: 0 24px; }\n ::-webkit-scrollbar { width: 6px; }\n ::-webkit-scrollbar-track { background: var(--bg); }\n ::-webkit-scrollbar-thumb { background: var(--border-lit); border-radius: 3px; }\n\n /* ── PAGE HERO ── */\n .page-hero {\n padding: 48px 0 56px; border-bottom: 1px solid var(--border);\n }\n .page-hero .hero-glow {\n position: absolute; top: -40px; left: 10%; width: 500px; height: 350px;\n background: radial-gradient(ellipse, rgba(240,160,48,.1) 0%, transparent 68%);\n pointer-events: none;\n }\n .page-title {\n font-size: clamp(2rem, 5vw, 3.4rem); font-weight: 800;\n line-height: 1.1; letter-spacing: -.02em; margin-bottom: 24px;\n display: flex; align-items: baseline; gap: 16px; flex-wrap: wrap;\n }\n .project-version {\n font-family: var(--font-mono); font-size: clamp(.85rem, 2vw, 1.1rem);\n font-weight: 500; color: var(--accent);\n background: var(--accent-dim); border: 1px solid rgba(240,160,48,.3);\n border-radius: 6px; padding: 2px 10px; letter-spacing: .5px;\n }\n .hero-meta { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; margin-bottom: 40px; }\n .base-url-pill {\n display: flex; align-items: center; gap: 8px;\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: 7px; padding: 8px 14px;\n }\n .base-url-label { font-size: .72rem; font-family: var(--font-mono);\n color: var(--text-muted); text-transform: uppercase; letter-spacing: .5px; }\n .base-url-val { font-family: var(--font-mono); font-size: .8rem; color: var(--accent); }\n .count-pill {\n font-family: var(--font-mono); font-size: .72rem; color: var(--text-dim);\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: 7px; padding: 8px 14px;\n }\n\n /* ── TOOLBAR ── */\n .toolbar {\n display: flex; align-items: center; gap: 12px; flex-wrap: wrap;\n }\n .method-filters { display: flex; gap: 4px; flex-wrap: wrap; }\n .filter-btn {\n background: var(--bg-card); border: 1px solid var(--border);\n color: var(--text-dim); font-family: var(--font-mono);\n font-size: .72rem; font-weight: 600; letter-spacing: .5px;\n padding: 6px 12px; border-radius: 6px; cursor: pointer;\n transition: all .15s;\n }\n .filter-btn:hover { border-color: var(--border-lit); color: var(--text); }\n .filter-btn.active { background: var(--accent); color: #0d0d1a; border-color: var(--accent); }\n .filter-btn[data-method=\"GET\"].active { background: rgba(96,165,250,.18); color: #60a5fa; border-color: rgba(96,165,250,.4); }\n .filter-btn[data-method=\"POST\"].active { background: rgba(122,174,142,.18); color: #7AAE8E; border-color: rgba(122,174,142,.4); }\n .filter-btn[data-method=\"PUT\"].active { background: rgba(240,160,48,.18); color: #F0A030; border-color: rgba(240,160,48,.4); }\n .filter-btn[data-method=\"PATCH\"].active { background: rgba(251,191,36,.18); color: #fbbf24; border-color: rgba(251,191,36,.4); }\n .filter-btn[data-method=\"DELETE\"].active { background: rgba(248,113,113,.18); color: #f87171; border-color: rgba(248,113,113,.4); }\n .filter-btn[data-method=\"HEAD\"].active { background: rgba(167,139,250,.18); color: #a78bfa; border-color: rgba(167,139,250,.4); }\n .search-wrap { margin-left: auto; }\n .search-input {\n background: var(--bg-card); border: 1px solid var(--border);\n color: var(--text); font-family: var(--font-sans); font-size: .85rem;\n padding: 7px 14px; border-radius: 7px; width: 240px;\n outline: none; transition: border-color .2s;\n }\n .search-input::placeholder { color: var(--text-muted); }\n .search-input:focus { border-color: var(--border-lit); }\n\n /* ── DOCS LAYOUT ── */\n .docs-layout {\n display: grid; grid-template-columns: 260px 1fr;\n gap: 48px; padding: 52px 0 80px; max-width: 1140px;\n margin: 0 auto; padding-left: 24px; padding-right: 24px;\n align-items: start;\n }\n\n /* ── SIDEBAR ── */\n .docs-sidebar {\n position: sticky; top: 24px;\n max-height: calc(100vh - 48px);\n overflow-y: auto;\n overflow-x: hidden;\n scrollbar-width: none;\n padding-right: 4px;\n }\n .docs-sidebar::-webkit-scrollbar { display: none; }\n .sidebar-section { margin-bottom: 28px; }\n .sidebar-label {\n font-family: var(--font-mono); font-size: .68rem; font-weight: 600;\n color: var(--text-muted); letter-spacing: 1.2px; text-transform: uppercase;\n margin-bottom: 8px; padding: 0 4px;\n }\n .sidebar-link {\n display: flex; align-items: center; gap: 8px;\n padding: 7px 10px; border-radius: 6px;\n border-left: 2px solid transparent;\n font-size: .82rem; color: var(--text-dim); cursor: pointer;\n transition: background .15s, color .15s, border-color .15s;\n overflow: hidden; white-space: nowrap;\n }\n .sidebar-link:hover { background: var(--bg-raised); color: var(--text); }\n .sidebar-link.active { color: var(--accent); border-left-color: var(--accent); background: var(--accent-dim); }\n .sidebar-method-dot {\n width: 6px; height: 6px; border-radius: 50%; flex-shrink: 0;\n }\n .sidebar-path { font-family: var(--font-mono); font-size: .72rem; }\n\n /* ── ENDPOINT CARDS ── */\n .endpoint-card {\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: var(--radius-lg); margin-bottom: 20px;\n overflow: hidden; transition: border-color .2s;\n animation: fadeUp .45s ease both;\n }\n .endpoint-card:hover { border-color: var(--border-lit); }\n @keyframes fadeUp {\n from { opacity: 0; transform: translateY(16px); }\n to { opacity: 1; transform: translateY(0); }\n }\n @media (prefers-reduced-motion: reduce) {\n .endpoint-card { animation: none; }\n }\n .endpoint-header {\n display: flex; align-items: center; gap: 14px;\n padding: 20px 24px 18px; border-bottom: 1px solid var(--border);\n flex-wrap: wrap;\n }\n .method-badges { display: flex; gap: 6px; flex-wrap: wrap; }\n .method-badge {\n font-family: var(--font-mono); font-size: .7rem; font-weight: 600;\n letter-spacing: .8px; padding: 4px 10px; border-radius: 5px;\n border: 1px solid; text-transform: uppercase;\n }\n .endpoint-path {\n font-family: var(--font-mono); font-size: .9rem; color: var(--text);\n background: none; border: none; padding: 0;\n word-break: break-all;\n }\n .endpoint-body { padding: 6px 24px 24px; }\n .endpoint-desc { font-size: .9rem; color: var(--text-dim); line-height: 1.7; margin-bottom: 20px; }\n\n /* ── PER-METHOD DOC BLOCKS ── */\n .method-block { padding-top: 20px; }\n .method-block + .method-block { margin-top: 4px; border-top: 1px solid var(--border); }\n .method-block-header { display: flex; align-items: center; gap: 10px; margin-bottom: 12px; }\n .method-block-header .method-badge { font-size: .68rem; }\n .method-block-empty { font-size: .82rem; color: var(--text-muted); }\n\n /* ── CODE BLOCKS ── */\n .example-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }\n .code-block-wrap {\n background: var(--bg-raised); border: 1px solid var(--border);\n border-radius: var(--radius); overflow: hidden;\n }\n .code-bar {\n display: flex; align-items: center; gap: 6px;\n padding: 9px 14px; border-bottom: 1px solid var(--border);\n background: var(--bg-card);\n }\n .dot { width: 11px; height: 11px; border-radius: 50%; }\n .dot-r { background: #ff5f57; }\n .dot-y { background: #febc2e; }\n .dot-g { background: #28c840; }\n .code-label { font-family: var(--font-mono); font-size: .68rem; color: var(--text-dim); margin-left: 4px; }\n pre.code-pre {\n font-family: var(--font-mono); font-size: .78rem; line-height: 1.7;\n padding: 16px 18px; overflow-x: auto; tab-size: 2; white-space: pre;\n }\n .c-dim { color: var(--text-muted); }\n .c-green { color: #7AAE8E; }\n .c-blue { color: #60a5fa; }\n .c-orange { color: #fb923c; }\n .c-purple { color: #a78bfa; }\n .c-accent { color: var(--accent); }\n .status-2xx { color: #7AAE8E; }\n .status-4xx { color: #f87171; }\n .status-5xx { color: #fb923c; }\n\n /* ── EMPTY STATE ── */\n .empty-state {\n text-align: center; padding: 80px 24px;\n color: var(--text-muted); font-size: .9rem;\n }\n\n /* ── RESPONSIVE ── */\n @media (max-width: 900px) {\n .docs-layout { grid-template-columns: 1fr; }\n .docs-sidebar { position: static; max-height: none; overflow-y: visible; padding-right: 0; }\n .example-grid { grid-template-columns: 1fr; }\n .search-wrap { margin-left: 0; width: 100%; }\n .search-input { width: 100%; }\n }\n @media (max-width: 600px) {\n .page-hero { padding: 32px 0 32px; }\n .page-title { font-size: 2rem; }\n }\n </style>\n</head>\n<body>\n\n <div class=\"page-hero\">\n <div class=\"hero-glow\"></div>\n <div class=\"container\">\n <h1 class=\"page-title\">${projectName}${projectVersion ? `<span class=\"project-version\">v${projectVersion}</span>` : ''}</h1>\n <div class=\"hero-meta\">\n <div class=\"base-url-pill\">\n <span class=\"base-url-label\">Base</span>\n <span class=\"base-url-val\">http://localhost:${port}${basePath}</span>\n </div>\n <div class=\"count-pill\" id=\"countPill\"></div>\n </div>\n <div class=\"toolbar\">\n <div class=\"method-filters\" id=\"methodFilters\">\n <button class=\"filter-btn active\" data-method=\"ALL\">ALL</button>\n </div>\n <div class=\"search-wrap\">\n <input type=\"text\" id=\"searchInput\" class=\"search-input\" placeholder=\"Search endpoints…\" />\n </div>\n </div>\n </div>\n </div>\n\n <div class=\"docs-layout\">\n <aside class=\"docs-sidebar\" id=\"sidebar\"></aside>\n <main id=\"endpoints\"></main>\n </div>\n\n <script>\n const ROUTES = ${safeRoutes};\n const BASE_PATH = ${JSON.stringify(basePath)};\n const HTTP_STATUS = ${safeHttpStatus};\n\n const METHOD_STYLE = {\n GET: { bg: 'rgba(96,165,250,.14)', color: '#60a5fa', border: 'rgba(96,165,250,.35)' },\n POST: { bg: 'rgba(122,174,142,.14)', color: '#7AAE8E', border: 'rgba(122,174,142,.35)' },\n PUT: { bg: 'rgba(240,160,48,.14)', color: '#F0A030', border: 'rgba(240,160,48,.35)' },\n PATCH: { bg: 'rgba(251,191,36,.14)', color: '#fbbf24', border: 'rgba(251,191,36,.35)' },\n DELETE: { bg: 'rgba(248,113,113,.14)', color: '#f87171', border: 'rgba(248,113,113,.35)' },\n HEAD: { bg: 'rgba(167,139,250,.14)', color: '#a78bfa', border: 'rgba(167,139,250,.35)' },\n OPTIONS: { bg: 'rgba(148,163,184,.14)', color: '#94a3b8', border: 'rgba(148,163,184,.35)' },\n };\n\n function esc(s) {\n return String(s)\n .replace(/&/g,'&amp;').replace(/</g,'&lt;')\n .replace(/>/g,'&gt;').replace(/\"/g,'&quot;');\n }\n\n function methodBadge(m) {\n const s = METHOD_STYLE[m] || METHOD_STYLE.GET;\n return '<span class=\"method-badge\" style=\"background:' + s.bg + ';color:' + s.color + ';border-color:' + s.border + '\">' + m + '</span>';\n }\n\n function joinPath(base, p) {\n return (base.replace(/\\\\/+$/, '') + p) || '/';\n }\n\n function sidebarDot(method) {\n const s = METHOD_STYLE[method] || METHOD_STYLE.GET;\n return '<span class=\"sidebar-method-dot\" style=\"background:' + s.color + '\"></span>';\n }\n\n function statusClass(code) {\n if (code >= 200 && code < 300) return 'status-2xx';\n if (code >= 400 && code < 500) return 'status-4xx';\n if (code >= 500) return 'status-5xx';\n return '';\n }\n\n function renderSchema(val, indent) {\n const pad = ' '.repeat(indent || 0);\n if (val === null) return '<span class=\"c-dim\">null</span>';\n if (typeof val === 'string') {\n const isDate = /^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}/.test(val);\n return isDate ? '<span class=\"c-green\">Date</span>' : '<span class=\"c-purple\">String</span>';\n }\n if (typeof val === 'number') return '<span class=\"c-orange\">Number</span>';\n if (typeof val === 'boolean') return '<span class=\"c-purple\">Boolean</span>';\n if (Array.isArray(val)) {\n if (!val.length) return '[]';\n return '[\\\\n' + pad + ' ' + renderSchema(val[0], (indent || 0) + 1) + '\\\\n' + pad + ']';\n }\n if (typeof val === 'object') {\n const keys = Object.keys(val);\n if (!keys.length) return '{}';\n const inner = keys.map(function(k) {\n return pad + ' <span class=\"c-blue\">&quot;' + esc(k) + '&quot;</span>: ' + renderSchema(val[k], (indent || 0) + 1);\n }).join(',\\\\n');\n return '{\\\\n' + inner + '\\\\n' + pad + '}';\n }\n return esc(String(val));\n }\n\n function codeBlock(label, content) {\n return '<div class=\"code-block-wrap\">' +\n '<div class=\"code-bar\">' +\n '<span class=\"dot dot-r\"></span>' +\n '<span class=\"dot dot-y\"></span>' +\n '<span class=\"dot dot-g\"></span>' +\n '<span class=\"code-label\">' + esc(label) + '</span>' +\n '</div>' +\n '<pre class=\"code-pre\">' + content + '</pre>' +\n '</div>';\n }\n\n function buildRequestContent(route, method, example) {\n const req = example || {};\n let path = joinPath(BASE_PATH, route.urlPath);\n if (req.params) {\n for (const [k, v] of Object.entries(req.params)) {\n path = path.replace(':' + k, String(v));\n }\n }\n if (req.query && Object.keys(req.query).length) {\n path += '?' + new URLSearchParams(req.query).toString();\n }\n let lines = '<span class=\"c-accent\">' + esc(method) + '</span> <span class=\"c-blue\">' + esc(path) + '</span>';\n const headers = { ...(req.headers || {}) };\n if (req.body !== undefined && !headers['Content-Type']) {\n headers['Content-Type'] = 'application/json';\n }\n if (Object.keys(headers).length) {\n lines += '\\\\n' + Object.entries(headers)\n .map(([k, v]) => '<span class=\"c-dim\">' + esc(k) + ':</span> ' + esc(String(v)))\n .join('\\\\n');\n }\n if (req.body !== undefined) {\n lines += '\\\\n\\\\n' + renderSchema(req.body, 0);\n }\n return lines;\n }\n\n function buildResponseContent(example) {\n const resp = example || {};\n const code = resp.status || 200;\n const text = HTTP_STATUS[code] || 'OK';\n const cls = statusClass(code);\n let lines = 'HTTP/1.1 <span class=\"' + cls + '\">' + code + ' ' + esc(text) + '</span>';\n if (resp.body !== undefined) {\n lines += '\\\\n<span class=\"c-dim\">Content-Type:</span> application/json\\\\n\\\\n';\n lines += renderSchema(resp.body, 0);\n }\n return lines;\n }\n\n function renderMethodBlock(route, method) {\n const methodMeta = route.meta ? route.meta[method] : null;\n const header = '<div class=\"method-block-header\">' + methodBadge(method) + '</div>';\n\n if (!methodMeta) {\n return '<div class=\"method-block\" data-method=\"' + esc(method) + '\">' + header +\n '<p class=\"method-block-empty\">No documentation provided for this method.</p></div>';\n }\n\n const desc = methodMeta.description\n ? '<p class=\"endpoint-desc\">' + esc(methodMeta.description) + '</p>'\n : '';\n const reqHtml = methodMeta.request !== undefined\n ? codeBlock('request', buildRequestContent(route, method, methodMeta.request))\n : '';\n const respHtml = methodMeta.response !== undefined\n ? codeBlock('response', buildResponseContent(methodMeta.response))\n : '';\n const examples = reqHtml || respHtml\n ? '<div class=\"example-grid\">' + reqHtml + respHtml + '</div>'\n : '';\n\n return '<div class=\"method-block\" data-method=\"' + esc(method) + '\">' + header + desc + examples + '</div>';\n }\n\n function renderCard(route, index) {\n const id = 'ep-' + index;\n const fullPath = joinPath(BASE_PATH, route.urlPath);\n const badges = route.methods.map(methodBadge).join('');\n const body = route.methods.map(function(m) { return renderMethodBlock(route, m); }).join('');\n const delay = (index * 0.06).toFixed(2) + 's';\n return '<div class=\"endpoint-card\" id=\"' + id + '\" data-methods=\"' + route.methods.join(',') + '\" data-path=\"' + esc(fullPath) + '\" style=\"animation-delay:' + delay + '\">' +\n '<div class=\"endpoint-header\">' +\n '<div class=\"method-badges\">' + badges + '</div>' +\n '<code class=\"endpoint-path\">' + esc(fullPath) + '</code>' +\n '</div>' +\n '<div class=\"endpoint-body\">' + body + '</div>' +\n '</div>';\n }\n\n function buildMethodFilters() {\n const allMethods = [...new Set(ROUTES.flatMap(r => r.methods))].sort();\n const filtersEl = document.getElementById('methodFilters');\n allMethods.forEach(m => {\n const btn = document.createElement('button');\n btn.className = 'filter-btn';\n btn.dataset.method = m;\n btn.textContent = m;\n filtersEl.appendChild(btn);\n });\n }\n\n function buildSidebar(routes) {\n const sidebar = document.getElementById('sidebar');\n if (!routes.length) { sidebar.innerHTML = ''; return; }\n\n const label = document.createElement('div');\n label.className = 'sidebar-label';\n label.textContent = 'Endpoints';\n sidebar.appendChild(label);\n\n routes.forEach((route, i) => {\n const link = document.createElement('div');\n link.className = 'sidebar-link';\n link.dataset.target = 'ep-' + ROUTES.indexOf(route);\n link.innerHTML = sidebarDot(route.methods[0] || 'GET') +\n '<span class=\"sidebar-path\">' + esc(route.urlPath || '/') + '</span>';\n link.addEventListener('click', () => {\n const target = document.getElementById(link.dataset.target);\n if (target) target.scrollIntoView({ behavior: 'smooth', block: 'start' });\n });\n sidebar.appendChild(link);\n });\n }\n\n let activeFilter = 'ALL';\n let searchQuery = '';\n\n function applyFilters() {\n const cards = document.querySelectorAll('.endpoint-card');\n let visible = 0;\n cards.forEach(card => {\n const methods = card.dataset.methods.split(',');\n const path = card.dataset.path || '';\n const matchMethod = activeFilter === 'ALL' || methods.includes(activeFilter);\n const matchSearch = !searchQuery || path.toLowerCase().includes(searchQuery);\n const show = matchMethod && matchSearch;\n card.style.display = show ? '' : 'none';\n if (show) visible++;\n });\n document.getElementById('empty-state').style.display = visible ? 'none' : 'block';\n\n // Sync sidebar visibility\n document.querySelectorAll('.sidebar-link').forEach(link => {\n const targetId = link.dataset.target;\n const targetCard = document.getElementById(targetId);\n link.style.display = targetCard && targetCard.style.display !== 'none' ? '' : 'none';\n });\n }\n\n function init() {\n const count = ROUTES.length;\n document.getElementById('countPill').textContent = count + ' endpoint' + (count !== 1 ? 's' : '');\n\n buildMethodFilters();\n\n const container = document.getElementById('endpoints');\n container.innerHTML = ROUTES.map((r, i) => renderCard(r, i)).join('');\n\n // Add empty state after cards\n const emptyEl = document.createElement('div');\n emptyEl.id = 'empty-state';\n emptyEl.className = 'empty-state';\n emptyEl.style.display = 'none';\n emptyEl.innerHTML = '<p>No endpoints match your filter.</p>';\n container.after(emptyEl);\n\n buildSidebar(ROUTES);\n\n // Method filter clicks\n document.getElementById('methodFilters').addEventListener('click', e => {\n const btn = e.target.closest('.filter-btn');\n if (!btn) return;\n document.querySelectorAll('.filter-btn').forEach(b => b.classList.remove('active'));\n btn.classList.add('active');\n activeFilter = btn.dataset.method;\n applyFilters();\n });\n\n // Search\n document.getElementById('searchInput').addEventListener('input', e => {\n searchQuery = e.target.value.trim().toLowerCase();\n applyFilters();\n });\n\n // Scroll spy for sidebar\n const cardEls = document.querySelectorAll('.endpoint-card');\n const sidebarLinks = document.querySelectorAll('.sidebar-link');\n const observer = new IntersectionObserver(entries => {\n entries.forEach(entry => {\n if (entry.isIntersecting) {\n const id = entry.target.id;\n sidebarLinks.forEach(l => l.classList.toggle('active', l.dataset.target === id));\n const sidebar = document.getElementById('sidebar');\n const activeLink = sidebar && sidebar.querySelector('.sidebar-link.active');\n if (sidebar && activeLink) {\n const linkTop = activeLink.getBoundingClientRect().top - sidebar.getBoundingClientRect().top + sidebar.scrollTop;\n sidebar.scrollTo({ top: linkTop, behavior: 'smooth' });\n }\n }\n });\n }, { rootMargin: '-80px 0px -60% 0px' });\n cardEls.forEach(el => observer.observe(el));\n\n }\n\n try {\n init();\n } catch (e) {\n document.body.insertAdjacentHTML('afterbegin',\n '<div style=\"position:fixed;top:60px;left:0;right:0;z-index:9999;background:#7f1d1d;color:#fca5a5;padding:16px 24px;font-family:monospace;font-size:13px;border-bottom:1px solid #ef4444\">' +\n '<strong>Dashboard JS error:</strong> ' + (e && e.message ? e.message : String(e)) +\n (e && e.stack ? '<pre style=\"margin-top:8px;white-space:pre-wrap\">' + e.stack + '</pre>' : '') +\n '</div>'\n );\n }\n </script>\n</body>\n</html>`;\n}\n","import type { Request, RequestHandler } from 'express';\nimport { isCacheConfigured, rawIncr } from './cache/index.js';\nimport { getLogger } from './logger.js';\n\n// rateLimit(): a fixed-window limit (windows aligned to the clock) counted in the cache\n// (`cache.incr`), so every worker — and with Redis every instance — shares one count. An\n// in-memory counter per worker would let N workers accept N × max.\n\nexport interface RateLimitOptions {\n /** Window length: seconds, or `'30s'`, `'15m'`, `'1h'`, `'1d'`. */\n window: number | string;\n /** Requests allowed per window and key. */\n max: number;\n /**\n * Who a request counts against. Default: the client IP (`req.ip`) — behind a proxy or load\n * balancer set `trustProxy` in ignite(), or every client shares the proxy's IP. Return\n * `undefined` to not limit this request.\n */\n key?: (req: Request) => string | undefined;\n /**\n * Which counter: requests to routes with the same name share a limit. Default: the route\n * pattern (`/users/:id`), so each route file has its own — or the path, for middleware\n * that isn't on a route.\n */\n name?: string;\n /** Body of the 429 response. Default: `'Too many requests, try again later'`. */\n message?: string;\n /**\n * The cache can't be reached: `'allow'` (default) lets requests through — a limiter\n * shouldn't take the API down with it; `'reject'` answers 503.\n */\n onCacheError?: 'allow' | 'reject';\n /** Send `RateLimit-Limit/Remaining/Reset` (and `Retry-After` on 429). Default: true. */\n headers?: boolean;\n}\n\nconst UNITS: Record<string, number> = { s: 1, m: 60, h: 3600, d: 86_400 };\n\nexport function parseWindow(window: number | string): number {\n let seconds = typeof window === 'number' ? window : NaN;\n if (typeof window === 'string') {\n const match = /^(\\d+(?:\\.\\d+)?)\\s*(s|m|h|d)$/.exec(window.trim());\n if (match) seconds = Number(match[1]) * UNITS[match[2]!]!;\n }\n if (Number.isFinite(seconds) && seconds * 1000 >= 1 && seconds * 1000 <= Number.MAX_SAFE_INTEGER)\n return seconds;\n throw new Error(`[EFC] rateLimit: window must be seconds or like '15m' — got ${String(window)}`);\n}\n\nlet lastCacheError = 0;\n\n/**\n * Limits requests per key (default: client IP) to `max` per `window`, counted in the cache\n * so the limit holds across every worker and instance:\n *\n * ```ts\n * export const middlewares = [rateLimit({ window: '15m', max: 10 })];\n * ```\n *\n * Needs `cache` in ignite() — use the Redis backend when you run more than one instance.\n */\nexport function rateLimit(options: RateLimitOptions): RequestHandler {\n const windowSeconds = parseWindow(options.window);\n if (!Number.isSafeInteger(options.max) || options.max < 1) {\n throw new Error('[EFC] rateLimit: max must be a positive integer');\n }\n const keyOf = options.key ?? ((req: Request) => req.ip ?? req.socket.remoteAddress);\n const message = options.message ?? 'Too many requests, try again later';\n const headers = options.headers ?? true;\n\n return (req, res, next) => {\n void (async () => {\n const who = keyOf(req);\n if (who === undefined) return next();\n if (!isCacheConfigured()) {\n throw new Error('[EFC] rateLimit needs a cache — pass cache: { backend } to ignite()');\n }\n const bucket = options.name ?? req.baseUrl + (req.route?.path ?? req.path);\n // Windows are aligned to the clock: every key restarts at the same boundary, and the\n // reset is exact. The key outlives its window by a second, then expires.\n const windowMs = windowSeconds * 1000;\n const now = Date.now();\n const slot = Math.floor(now / windowMs);\n const resetMs = (slot + 1) * windowMs - now;\n let count: number;\n try {\n count = (\n await rawIncr(\n `rl:${JSON.stringify([String(bucket), who, slot])}`,\n Math.ceil(resetMs / 1000) + 1,\n )\n ).value;\n } catch (err) {\n if (Date.now() - lastCacheError > 30_000) {\n lastCacheError = Date.now();\n getLogger().error(\n { err },\n `rateLimit: cache unavailable — ${options.onCacheError === 'reject' ? 'rejecting with 503' : 'allowing requests'}`,\n );\n }\n if (options.onCacheError === 'reject') {\n res.status(503).json({ error: 'Service Unavailable', statusCode: 503 });\n return;\n }\n return next();\n }\n const resetSeconds = Math.max(1, Math.ceil(resetMs / 1000));\n if (headers) {\n res.setHeader('RateLimit-Limit', String(options.max));\n res.setHeader('RateLimit-Remaining', String(Math.max(0, options.max - count)));\n res.setHeader('RateLimit-Reset', String(resetSeconds));\n }\n if (count > options.max) {\n if (headers) res.setHeader('Retry-After', String(resetSeconds));\n res.status(429).json({ error: message, statusCode: 429 });\n return;\n }\n next();\n })().catch(next);\n };\n}\n","import { createHash } from 'node:crypto';\nimport type { Request, RequestHandler } from 'express';\nimport { cache } from './index.js';\nimport { getCurrentUser } from '../context.js';\nimport { getLogger } from '../logger.js';\n\nexport interface CacheResponseOptions {\n /** Seconds to keep a response. */\n ttl: number;\n /** Cache per authenticated string/numeric sub/id. Put requireAuth first. */\n perUser?: boolean;\n /** Custom URL identity. Default: original URL, including query. */\n key?: (req: Request) => string;\n}\ninterface Stored {\n status: number;\n json: string;\n headers: Record<string, string>;\n vary: string[];\n variant: string;\n}\nexport const RESPONSE_PREFIX = 'res:';\nconst representationHeaders = [\n 'content-type',\n 'cache-control',\n 'vary',\n 'content-language',\n 'content-disposition',\n 'etag',\n 'last-modified',\n];\nconst variant = (req: Request, names: string[]) =>\n createHash('sha256')\n .update(JSON.stringify(names.map((name) => [name, req.get(name) ?? null])))\n .digest('hex');\n\n/** Cache successful GET/HEAD JSON representations with method/user isolation. */\nexport function cacheResponse(options: number | CacheResponseOptions): RequestHandler {\n const opts: CacheResponseOptions = typeof options === 'number' ? { ttl: options } : options;\n return (req, res, next) => {\n if (req.method !== 'GET' && req.method !== 'HEAD') return next();\n let scope = '';\n if (opts.perUser) {\n const user = getCurrentUser();\n const id = user?.['sub'] ?? user?.['id'];\n if (typeof id !== 'string' && (typeof id !== 'number' || !Number.isFinite(id))) return next();\n scope = `u:${JSON.stringify([id])}:`;\n }\n // NUL cannot occur in an HTTP request URL. Keep URL-prefix invalidation while\n // preventing HEAD/GET and legacy-key collisions.\n const key =\n RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl) + '\\0' + req.method;\n void (async () => {\n const hit = await cache.get<Stored>(key);\n if (\n hit &&\n typeof hit.json === 'string' &&\n Array.isArray(hit.vary) &&\n hit.variant === variant(req, hit.vary)\n ) {\n res.set(hit.headers);\n res.setHeader('X-Cache', 'HIT');\n res.status(hit.status).send(hit.json);\n return;\n }\n res.setHeader('X-Cache', 'MISS');\n let captured = false;\n let snapshot = '';\n // Store the actual serialized JSON, not a mutable application object or a\n // different rendering that ignores Express's JSON replacer.\n const json = res.json.bind(res);\n res.json = (body: unknown) => {\n const send = res.send;\n const eligible = !res.headersSent && res.statusCode === 200;\n res.send = (rendered: unknown) => {\n if (eligible && typeof rendered === 'string') {\n try {\n JSON.parse(rendered);\n snapshot = rendered;\n captured = true;\n } catch {\n /* Not JSON. */\n }\n }\n return send.call(res, rendered);\n };\n try {\n return json(body);\n } finally {\n res.send = send;\n }\n };\n res.once('finish', () => {\n if (!captured || res.statusCode !== 200 || res.getHeader('set-cookie') !== undefined)\n return;\n const control = String(res.getHeader('cache-control') ?? '');\n if (\n /(?:^|,)\\s*(?:no-store|no-cache)(?:\\s|,|=|$)/i.test(control) ||\n (!opts.perUser && /(?:^|,)\\s*private(?:\\s|,|=|$)/i.test(control))\n )\n return;\n const vary = String(res.getHeader('vary') ?? '')\n .split(',')\n .map((name) => name.trim().toLowerCase())\n .filter(Boolean);\n if (vary.includes('*')) return;\n const headers: Record<string, string> = {};\n for (const name of representationHeaders) {\n const value = res.getHeader(name);\n if (value !== undefined)\n headers[name] = Array.isArray(value) ? value.join(', ') : String(value);\n }\n const stored: Stored = {\n status: 200,\n json: snapshot,\n headers,\n vary,\n variant: variant(req, vary),\n };\n void cache\n .set(key, stored, { ttl: opts.ttl })\n .catch((error) => getLogger().debug({ err: error }, 'Response cache write failed'));\n });\n next();\n })().catch(next);\n };\n}\n","import type { RequestHandler } from 'express';\n\n/**\n * Chains multiple Express request handlers into a single handler.\n * Each handler calls the next one via its `next` callback.\n *\n * @example\n * export const GET = compose(requireAuth, rateLimiter, myHandler);\n */\nexport function compose(...handlers: RequestHandler[]): RequestHandler {\n return (req, res, next) => {\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(\n handler(req, res, (err?: unknown) => (err ? next(err) : dispatch(i + 1))),\n ).catch(next);\n } catch (err) {\n next(err);\n }\n }\n\n dispatch(0);\n };\n}\n"],"mappings":"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","names":["fs","cluster","path","path","fs","cluster"]}
1
+ {"version":3,"sources":["../src/shutdown.ts","../src/index.ts","../src/cluster/index.ts","../src/tasks/scanner.ts","../src/dashboard.ts","../src/rate-limit.ts","../src/cache/response.ts","../src/compose.ts"],"sourcesContent":["interface DrainOptions {\n transports: Promise<unknown>[];\n tasks: Array<() => Promise<unknown>>;\n cache: () => Promise<unknown>;\n tracing: () => Promise<unknown>;\n}\n/** Drain every producer/consumer before removing shared dependencies. Fail only\n * after all cleanup attempts, so a fast failure cannot cut off a slower job. */\nexport async function drainServices(options: DrainOptions): Promise<void> {\n const errors: unknown[] = [];\n const outcomes = await Promise.allSettled([\n ...options.transports,\n ...options.tasks.map((close) => Promise.resolve().then(close)),\n ]);\n for (const outcome of outcomes) if (outcome.status === 'rejected') errors.push(outcome.reason);\n for (const close of [options.cache, options.tracing]) {\n try {\n await close();\n } catch (error) {\n errors.push(error);\n }\n }\n if (errors.length) throw new AggregateError(errors, 'Service shutdown failed');\n}\n","import { drainServices } from './shutdown.js';\nimport { configureTracing, shutdownTracing } from './tracing.js';\nimport http from 'node:http';\nimport fs from 'node:fs';\nimport express from 'express';\nimport cluster from 'node:cluster';\nimport os from 'node:os';\nimport path from 'node:path';\nimport type { EFCConfig, MountedRoute } from './types.js';\nexport type {\n TableModel,\n TableRecord,\n TableCreateInput,\n TableWhere,\n TableWhereUnique,\n TableUpdateData,\n TableCreateData,\n TableUpdateInput,\n TableOrderBy,\n TableSelect,\n TableInclude,\n TableResult,\n Tables,\n TableFindManyArgs,\n TableAggregateArgs,\n TableGroupByArgs,\n TableAggregateResult,\n ScalarFilter,\n StringFilter,\n ListFilter,\n JsonFilter,\n InferTableRecord,\n} from './table-types.js';\nimport { scanDir } from './router/scan.js';\nimport { mountRoutes } from './router/mount.js';\nimport { mountOpenAPI } from './openapi.js';\nimport { attachWebSockets, closeWebSockets } from './websocket.js';\nimport { runMaster, shutdownMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { setDbEngine, setAutoSync } from './db/engine.js';\nimport { checkConnectionBudget, connectPostgres } from './db/postgres.js';\nimport { configureLogger, getLogger } from './logger.js';\nimport { configureQueryLog } from './db/query-log.js';\nimport { scanTasks } from './tasks/scanner.js';\nimport { initBullMQ, closeBullMQ } from './tasks/bullmq-backend.js';\nimport { initPgBoss, closePgBoss } from './tasks/pgboss-backend.js';\nimport { configureCache, closeCache } from './cache/index.js';\nimport { servePrimaryCache } from './cache/ipc.js';\nimport { generateDashboard } from './dashboard.js';\nimport { createHttpApp, mountErrorHandler } from './http-app.js';\n\nfunction detectDatabase(url?: string): 'mongodb' | 'postgresql' | undefined {\n if (!url) return undefined;\n if (url.startsWith('mongodb')) return 'mongodb';\n if (url.startsWith('postgres')) return 'postgresql';\n return undefined;\n}\n\nexport async function ignite(config: EFCConfig): Promise<http.Server | undefined> {\n const { port: _port, workers, onWorkerReady, onWorkerCrash, onError } = config;\n\n // Resolve api/tasks dirs from convention. argv[1]-based resolution is unreliable in tsx watch\n // + cluster workers (argv[1] can point to the tsx binary instead of the user's script), so we\n // probe multiple candidates and use the first that exists on disk.\n function resolveConventionDir(name: string): string {\n const candidates: string[] = [\n ...(process.argv[1] ? [path.join(path.dirname(process.argv[1]), name)] : []),\n path.join(process.cwd(), 'src', name),\n path.join(process.cwd(), name),\n path.join(process.cwd(), 'dist', name),\n ];\n return candidates.find((c) => fs.existsSync(c)) ?? candidates[0]!;\n }\n const apiDir = resolveConventionDir('api');\n const tasksDir = resolveConventionDir('tasks');\n const basePath = config.basePath ?? '/v1/api';\n\n function readProjectMeta(): { name: string; version: string } {\n try {\n const raw = fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8');\n const pkg = JSON.parse(raw) as { name?: string; version?: string };\n return { name: pkg.name ?? 'API', version: pkg.version ?? '' };\n } catch {\n return { name: 'API', version: '' };\n }\n }\n\n const port = _port != null && !Number.isNaN(_port) ? _port : 3000;\n const databaseUrl = config.databaseUrl;\n const database = config.database ?? detectDatabase(databaseUrl);\n const jwtSecret = config.jwtSecret;\n const authStrategy = config.authStrategy ?? 'http-only';\n // NODE_ENV is a Node/Express-wide runtime-mode signal set by the platform, not an app\n // secret — unlike PORT/DATABASE_URL/JWT_SECRET/etc. this one is still read directly.\n const clusterEnabled = config.cluster ?? process.env['NODE_ENV'] === 'production';\n\n configureLogger(config.logging);\n // Any value but 'http-only' acts as bearer, as it always has — an app may rely on that, so\n // 0.9.x only warns (a typo of 'http-only' silently means no cookie). 1.0 makes it an error.\n if (\n !['http-only', 'bearer', 'localStorage'].includes(authStrategy) &&\n (!clusterEnabled || cluster.isPrimary) // once, not once per worker\n ) {\n getLogger().warn(\n `[EFC] Unknown authStrategy \"${String(authStrategy)}\" — treated as 'bearer'. Use 'http-only' or 'bearer'; this will be an error in 1.0.`,\n );\n }\n // HS256 with a short secret can be brute-forced offline from any token a user holds.\n if (\n jwtSecret &&\n Buffer.byteLength(jwtSecret) < 32 &&\n process.env['NODE_ENV'] === 'production' &&\n (!clusterEnabled || cluster.isPrimary)\n ) {\n getLogger().warn(\n `[EFC] jwtSecret is ${Buffer.byteLength(jwtSecret)} bytes — use at least 32 random bytes in production (openssl rand -hex 64).`,\n );\n }\n configureQueryLog(config.logging);\n configureTracing(config.tracing);\n\n if (clusterEnabled && cluster.isPrimary) {\n // The memory cache lives in the primary so all workers share it (cache/ipc.ts).\n if (config.cache && config.cache.backend === 'memory') {\n servePrimaryCache(config.cache.maxEntries ?? 10_000);\n }\n runMaster({\n workers: workers ?? os.cpus().length,\n ...(onWorkerReady !== undefined && { onWorkerReady }),\n ...(onWorkerCrash !== undefined && { onWorkerCrash }),\n });\n return;\n }\n\n const app = createHttpApp(config);\n\n // Pre-Flight step 1: Connect database. The engine decides what defineModel compiles to.\n if (database) setDbEngine(database);\n setAutoSync(config.autoSync ?? true);\n // Pools are per worker; one process per machine reports the machine's total.\n const poolWorkers = clusterEnabled ? (workers ?? os.cpus().length) : 1;\n const reportsPools = !clusterEnabled || cluster.worker?.id === 1;\n if (database === 'mongodb' && databaseUrl) {\n const conn = await connectMongo(databaseUrl, config.databasePool);\n setDbClient(conn as unknown as Record<string, unknown>);\n if (reportsPools) {\n const max = config.databasePool?.max ?? 100; // mongoose's maxPoolSize default\n getLogger().info(\n `MongoDB connections: up to ${poolWorkers * max} from this machine (${poolWorkers} worker(s) × maxPoolSize ${max})`,\n );\n }\n } else if (database === 'postgresql' && databaseUrl) {\n const pool = await connectPostgres(databaseUrl, config.databasePool);\n setDbClient(pool as unknown as Record<string, unknown>);\n if (reportsPools) {\n const max = config.databasePool?.max ?? 10; // node-postgres' default\n // pg-boss on the same database opens its own pool (node-postgres default 10).\n const boss =\n config.tasks && config.tasks.backend === 'pg-boss' && !config.tasks.connectionString\n ? 10\n : 0;\n const breakdown = `${poolWorkers} worker(s) × (pool ${max}${boss ? ` + pg-boss ${boss}` : ''})`;\n await checkConnectionBudget(poolWorkers * (max + boss), breakdown);\n }\n }\n\n // Pre-Flight step 1b: Cache (also the session-revocation store requireAuth consults)\n if (config.cache) {\n await configureCache(config.cache);\n }\n\n // Pre-Flight step 2: Configure auth\n if (jwtSecret) {\n configureAuth({\n secret: jwtSecret,\n strategy: authStrategy,\n expiresIn: config.jwtExpiresIn ?? '7d',\n ...(config.cookieDomain !== undefined && { cookieDomain: config.cookieDomain }),\n });\n }\n\n // Pre-Flight step 3: Scan and register tasks\n if (tasksDir) {\n await scanTasks(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 tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),\n redisUrl: config.tasks.redisUrl ?? 'redis://localhost:6379',\n concurrency: config.tasks.concurrency ?? 5,\n enqueueTimeout: config.tasks.enqueueTimeout ?? 5000,\n queue: config.tasks.queue ?? 'efc',\n });\n } else if (config.tasks.backend === 'pg-boss') {\n const connectionString = config.tasks.connectionString ?? databaseUrl;\n if (!connectionString) {\n throw new Error(\n '[EFC] tasks.backend \"pg-boss\" needs tasks.connectionString or databaseUrl',\n );\n }\n await initPgBoss({\n tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),\n connectionString,\n concurrency: config.tasks.concurrency ?? 5,\n enqueueTimeout: config.tasks.enqueueTimeout ?? 5000,\n queue: config.tasks.queue ?? 'efc',\n ...(config.tasks.schema !== undefined && { schema: config.tasks.schema }),\n });\n }\n }\n\n // Pre-Flight step 5: Scan routes and mount\n const routes = scanDir(apiDir);\n const apiRouter = express.Router();\n const mounted: MountedRoute[] = await mountRoutes(apiRouter, routes);\n if (config.openapi) {\n const meta = readProjectMeta();\n const options = config.openapi === true ? {} : config.openapi;\n await mountOpenAPI(app, mounted, {\n info: { title: meta.name, version: meta.version },\n ...options,\n basePath,\n });\n }\n app.use(basePath, apiRouter);\n\n if (config.dashboard !== false && process.env['NODE_ENV'] === 'development') {\n app.get('/', (_req, res) => {\n const { name, version } = readProjectMeta();\n res.setHeader('Content-Type', 'text/html; charset=utf-8');\n res.send(generateDashboard(mounted, basePath, port, name, version));\n });\n }\n\n mountErrorHandler(app, onError);\n\n return new Promise<http.Server>((resolve, reject) => {\n const server = http.createServer(app);\n if (config.websocket !== false && mounted.some((route) => route.websocket))\n attachWebSockets(server, app, config.websocket);\n\n server.once('listening', () => {\n const wid = (cluster.worker as { id: number } | undefined)?.id ?? 'primary';\n const addr = server.address() as { port: number } | null;\n getLogger().info(`Worker ${wid} listening on :${addr?.port ?? port}`);\n resolve(server);\n });\n\n server.once('error', reject);\n server.listen(port);\n });\n}\n\nexport function gracefulShutdown(server: http.Server | undefined, timeoutMs = 10_000): void {\n let shuttingDown = false;\n const shutdown = (signal: string) => {\n // A worker can get the signal twice (process-group Ctrl+C plus the primary's\n // forward); the default handler for a repeat would kill it mid-drain.\n if (shuttingDown) return;\n shuttingDown = true;\n getLogger().info(`${signal} received — closing server gracefully…`);\n if (server) {\n const websocketDrain = closeWebSockets(server, Math.max(1, Math.min(1000, timeoutMs / 2)));\n server.closeIdleConnections();\n server.close(() => {\n getLogger().info('Server closed');\n // Let in-flight task jobs finish before exiting; the timeout below still caps it.\n drainServices({\n transports: [websocketDrain],\n tasks: [closeBullMQ, closePgBoss],\n cache: closeCache,\n tracing: shutdownTracing,\n }).then(\n () => process.exit(0),\n (err: unknown) => {\n getLogger().error({ err }, 'Service shutdown failed');\n process.exit(1);\n },\n );\n });\n setTimeout(() => {\n getLogger().error('Forced exit after timeout');\n process.exit(1);\n }, timeoutMs).unref();\n } else {\n shutdownMaster();\n // Workers get the same budget plus a margin before the primary gives up on them.\n setTimeout(() => {\n getLogger().error('Workers did not exit in time — forcing primary exit');\n process.exit(1);\n }, timeoutMs + 2_000).unref();\n }\n };\n process.on('SIGTERM', () => shutdown('SIGTERM'));\n process.on('SIGINT', () => shutdown('SIGINT'));\n}\n\nexport { HttpError, isHttpError } from './errors.js';\nexport { logger, getLogger } from './logger.js';\nexport { getQueryMetrics, resetQueryMetrics } from './db/query-log.js';\nexport type { QueryMetric, QueryMetricsSnapshot } from './db/query-log.js';\nexport { cache } from './cache/index.js';\nexport { rateLimit } from './rate-limit.js';\nexport type { RateLimitOptions } from './rate-limit.js';\nexport { cacheResponse } from './cache/response.js';\nexport { compose } from './compose.js';\nexport {\n db,\n setDbClient,\n getDbClient,\n defineModel,\n defineTable,\n defineCollection,\n} from './db/index.js';\nexport type {\n CollectionModel,\n CollectionOptions,\n CollectionFilter,\n CollectionUpdate,\n CollectionFindOptions,\n CollectionWriteResult,\n CollectionBulkResult,\n CollectionBulkOp,\n CollectionChange,\n CollectionChangeStream,\n} from './db/collection-model.js';\nexport type {\n Pipeline,\n FieldRef,\n Accumulator,\n GroupResult,\n LookedUp,\n LookupTarget,\n} from './db/pipeline.js';\nexport { transaction } from './db/transaction.js';\nexport { ModelValidationError } from './db/schema.js';\nexport { scanDir } from './router/scan.js';\nexport { listTasks } from './tasks/index.js';\nexport { workerCount } from './cluster/index.js';\nexport type {\n EFCConfig,\n DatabasePoolConfig,\n CollectionSchema,\n CollectionFieldDefinition,\n GeoPoint,\n CorsConfig,\n RouteEntry,\n RouteMeta,\n RouteMethodMeta,\n RouteSchema,\n LoggingConfig,\n QueryLogConfig,\n CacheConfig,\n RequestSchema,\n Validator,\n ValidationIssue,\n TaskOptions,\n TaskDefinition,\n DatabaseEngine,\n AuthStrategy,\n ModelSchema,\n TableSchema,\n TableSchemaField,\n TableFieldDefinition,\n TableOptions,\n TableRelation,\n MigrationContext,\n SchemaField,\n Filter,\n FilterOperators,\n Update,\n FindOptions,\n IndexDefinition,\n ModelRecord,\n InferRecord,\n InferCreate,\n InferSchema,\n InferCreateInput,\n ScalarKeys,\n SortDirection,\n ModelCRUD,\n ModelQueryOptions,\n ModelOptions,\n FieldDefinition,\n DefaultOperator,\n} from './types.js';\n\nexport { generateOpenAPI } from './openapi.js';\nexport type { OpenAPIOptions, OpenAPIDocument, JSONSchema } from './openapi.js';\nexport { attachWebSockets, closeWebSockets } from './websocket.js';\nexport type { WebSocketHandler, WebSocketOptions } from './websocket.js';\n\nexport type { TracingOptions } from './tracing.js';\n","import cluster from 'node:cluster';\nimport { getLogger } from '../logger.js';\n\ninterface ClusterOptions {\n workers?: number;\n onWorkerReady?: ((id: number) => void) | undefined;\n onWorkerCrash?: ((id: number, code: number) => void) | undefined;\n}\n\nlet isShuttingDown = false;\n\n/**\n * Returns the number of currently alive (not yet exited) cluster workers.\n * Returns `0` when running in single-process mode.\n */\nexport function workerCount(): number {\n return Object.keys(cluster.workers ?? {}).length;\n}\n\nexport function shutdownMaster(): void {\n isShuttingDown = true;\n getLogger().info(`Cluster primary (pid=${process.pid}) shutting down, waiting for workers…`);\n if (workerCount() === 0) process.exit(0);\n // Orchestrators (docker stop, k8s) signal only PID 1 — the primary — so forward the\n // signal; each worker's gracefulShutdown drains its server and exits on its own.\n for (const worker of Object.values(cluster.workers ?? {})) {\n worker?.process.kill('SIGTERM');\n }\n}\n\nexport function runMaster(options: ClusterOptions = {}): void {\n const count = options.workers ?? 1;\n\n getLogger().info(`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 if (isShuttingDown) {\n getLogger().info(`Worker ${worker.id} gracefully exited`);\n if (workerCount() === 0) {\n getLogger().info('All workers exited. Primary exiting.');\n process.exit(0);\n }\n return;\n }\n\n getLogger().warn(`Worker ${worker.id} exited (code=${exitCode}), respawning…`);\n options.onWorkerCrash?.(worker.id, exitCode);\n cluster.fork();\n });\n}\n\nexport { cluster };\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { registerTask } from './index.js';\nimport { listTaskFiles } from './files.js';\nimport { getLogger } from '../logger.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 = listTaskFiles(tasksDir);\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 getLogger().warn(`Task file ${file} has no valid default export — skipping`);\n continue;\n }\n\n registerTask(taskName, { ...def, filePath });\n getLogger().debug(`Registered task: ${taskName}`);\n } catch (err) {\n getLogger().warn({ err }, `Failed to load task ${file}`);\n }\n }\n}\n","import type { MountedRoute } from './types.js';\n\nconst HTTP_STATUS: Record<number, string> = {\n 200: 'OK',\n 201: 'Created',\n 202: 'Accepted',\n 204: 'No Content',\n 400: 'Bad Request',\n 401: 'Unauthorized',\n 403: 'Forbidden',\n 404: 'Not Found',\n 405: 'Method Not Allowed',\n 409: 'Conflict',\n 422: 'Unprocessable Entity',\n 500: 'Internal Server Error',\n 503: 'Service Unavailable',\n};\n\nexport function generateDashboard(\n routes: MountedRoute[],\n basePath: string,\n port: number,\n projectName: string,\n projectVersion: string,\n): string {\n const safeRoutes = JSON.stringify(\n routes.map((r) => ({\n urlPath: r.urlPath,\n methods: r.websocket ? [...r.methods, 'WS'] : r.methods,\n params: r.params,\n meta: r.meta ?? null,\n })),\n ).replace(/<\\/script>/gi, '<\\\\/script>');\n const safeHttpStatus = JSON.stringify(HTTP_STATUS);\n\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>${projectName} — API Reference</title>\n <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n <link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin />\n <link href=\"https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap\" rel=\"stylesheet\" />\n <style>\n *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\n :root {\n --bg: #080b0f;\n --bg-card: #0d1117;\n --bg-raised: #111820;\n --border: #1e2832;\n --border-lit: #263040;\n --text: #e2e8f0;\n --text-dim: #64748b;\n --text-muted: #334155;\n --accent: #F0A030;\n --accent-dim: rgba(240,160,48,.12);\n --accent-glow: rgba(240,160,48,.22);\n --purple: #a78bfa;\n --blue: #60a5fa;\n --orange: #fb923c;\n --green: #7AAE8E;\n --radius: 10px;\n --radius-lg: 16px;\n --font-mono: 'JetBrains Mono', monospace;\n --font-sans: 'Inter', sans-serif;\n }\n html { scroll-behavior: smooth; }\n body {\n background: var(--bg); color: var(--text);\n font-family: var(--font-sans); font-size: 16px;\n line-height: 1.6; -webkit-font-smoothing: antialiased;\n position: relative;\n }\n body::before {\n content: ''; position: fixed; inset: 0; z-index: 0;\n background-image:\n linear-gradient(var(--border) 1px, transparent 1px),\n linear-gradient(90deg, var(--border) 1px, transparent 1px);\n background-size: 60px 60px; opacity: .28; pointer-events: none;\n }\n section, footer, .page-hero, .docs-layout { position: relative; z-index: 1; }\n a { text-decoration: none; color: inherit; }\n em { font-style: italic; }\n code {\n font-family: var(--font-mono); font-size: .85em;\n background: var(--bg-raised); border: 1px solid var(--border);\n border-radius: 4px; padding: 1px 6px; color: var(--accent);\n }\n .container { max-width: 1140px; margin: 0 auto; padding: 0 24px; }\n ::-webkit-scrollbar { width: 6px; }\n ::-webkit-scrollbar-track { background: var(--bg); }\n ::-webkit-scrollbar-thumb { background: var(--border-lit); border-radius: 3px; }\n\n /* ── PAGE HERO ── */\n .page-hero {\n padding: 48px 0 56px; border-bottom: 1px solid var(--border);\n }\n .page-hero .hero-glow {\n position: absolute; top: -40px; left: 10%; width: 500px; height: 350px;\n background: radial-gradient(ellipse, rgba(240,160,48,.1) 0%, transparent 68%);\n pointer-events: none;\n }\n .page-title {\n font-size: clamp(2rem, 5vw, 3.4rem); font-weight: 800;\n line-height: 1.1; letter-spacing: -.02em; margin-bottom: 24px;\n display: flex; align-items: baseline; gap: 16px; flex-wrap: wrap;\n }\n .project-version {\n font-family: var(--font-mono); font-size: clamp(.85rem, 2vw, 1.1rem);\n font-weight: 500; color: var(--accent);\n background: var(--accent-dim); border: 1px solid rgba(240,160,48,.3);\n border-radius: 6px; padding: 2px 10px; letter-spacing: .5px;\n }\n .hero-meta { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; margin-bottom: 40px; }\n .base-url-pill {\n display: flex; align-items: center; gap: 8px;\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: 7px; padding: 8px 14px;\n }\n .base-url-label { font-size: .72rem; font-family: var(--font-mono);\n color: var(--text-muted); text-transform: uppercase; letter-spacing: .5px; }\n .base-url-val { font-family: var(--font-mono); font-size: .8rem; color: var(--accent); }\n .count-pill {\n font-family: var(--font-mono); font-size: .72rem; color: var(--text-dim);\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: 7px; padding: 8px 14px;\n }\n\n /* ── TOOLBAR ── */\n .toolbar {\n display: flex; align-items: center; gap: 12px; flex-wrap: wrap;\n }\n .method-filters { display: flex; gap: 4px; flex-wrap: wrap; }\n .filter-btn {\n background: var(--bg-card); border: 1px solid var(--border);\n color: var(--text-dim); font-family: var(--font-mono);\n font-size: .72rem; font-weight: 600; letter-spacing: .5px;\n padding: 6px 12px; border-radius: 6px; cursor: pointer;\n transition: all .15s;\n }\n .filter-btn:hover { border-color: var(--border-lit); color: var(--text); }\n .filter-btn.active { background: var(--accent); color: #0d0d1a; border-color: var(--accent); }\n .filter-btn[data-method=\"GET\"].active { background: rgba(96,165,250,.18); color: #60a5fa; border-color: rgba(96,165,250,.4); }\n .filter-btn[data-method=\"POST\"].active { background: rgba(122,174,142,.18); color: #7AAE8E; border-color: rgba(122,174,142,.4); }\n .filter-btn[data-method=\"PUT\"].active { background: rgba(240,160,48,.18); color: #F0A030; border-color: rgba(240,160,48,.4); }\n .filter-btn[data-method=\"PATCH\"].active { background: rgba(251,191,36,.18); color: #fbbf24; border-color: rgba(251,191,36,.4); }\n .filter-btn[data-method=\"DELETE\"].active { background: rgba(248,113,113,.18); color: #f87171; border-color: rgba(248,113,113,.4); }\n .filter-btn[data-method=\"HEAD\"].active { background: rgba(167,139,250,.18); color: #a78bfa; border-color: rgba(167,139,250,.4); }\n .search-wrap { margin-left: auto; }\n .search-input {\n background: var(--bg-card); border: 1px solid var(--border);\n color: var(--text); font-family: var(--font-sans); font-size: .85rem;\n padding: 7px 14px; border-radius: 7px; width: 240px;\n outline: none; transition: border-color .2s;\n }\n .search-input::placeholder { color: var(--text-muted); }\n .search-input:focus { border-color: var(--border-lit); }\n\n /* ── DOCS LAYOUT ── */\n .docs-layout {\n display: grid; grid-template-columns: 260px 1fr;\n gap: 48px; padding: 52px 0 80px; max-width: 1140px;\n margin: 0 auto; padding-left: 24px; padding-right: 24px;\n align-items: start;\n }\n\n /* ── SIDEBAR ── */\n .docs-sidebar {\n position: sticky; top: 24px;\n max-height: calc(100vh - 48px);\n overflow-y: auto;\n overflow-x: hidden;\n scrollbar-width: none;\n padding-right: 4px;\n }\n .docs-sidebar::-webkit-scrollbar { display: none; }\n .sidebar-section { margin-bottom: 28px; }\n .sidebar-label {\n font-family: var(--font-mono); font-size: .68rem; font-weight: 600;\n color: var(--text-muted); letter-spacing: 1.2px; text-transform: uppercase;\n margin-bottom: 8px; padding: 0 4px;\n }\n .sidebar-link {\n display: flex; align-items: center; gap: 8px;\n padding: 7px 10px; border-radius: 6px;\n border-left: 2px solid transparent;\n font-size: .82rem; color: var(--text-dim); cursor: pointer;\n transition: background .15s, color .15s, border-color .15s;\n overflow: hidden; white-space: nowrap;\n }\n .sidebar-link:hover { background: var(--bg-raised); color: var(--text); }\n .sidebar-link.active { color: var(--accent); border-left-color: var(--accent); background: var(--accent-dim); }\n .sidebar-method-dot {\n width: 6px; height: 6px; border-radius: 50%; flex-shrink: 0;\n }\n .sidebar-path { font-family: var(--font-mono); font-size: .72rem; }\n\n /* ── ENDPOINT CARDS ── */\n .endpoint-card {\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: var(--radius-lg); margin-bottom: 20px;\n overflow: hidden; transition: border-color .2s;\n animation: fadeUp .45s ease both;\n }\n .endpoint-card:hover { border-color: var(--border-lit); }\n @keyframes fadeUp {\n from { opacity: 0; transform: translateY(16px); }\n to { opacity: 1; transform: translateY(0); }\n }\n @media (prefers-reduced-motion: reduce) {\n .endpoint-card { animation: none; }\n }\n .endpoint-header {\n display: flex; align-items: center; gap: 14px;\n padding: 20px 24px 18px; border-bottom: 1px solid var(--border);\n flex-wrap: wrap;\n }\n .method-badges { display: flex; gap: 6px; flex-wrap: wrap; }\n .method-badge {\n font-family: var(--font-mono); font-size: .7rem; font-weight: 600;\n letter-spacing: .8px; padding: 4px 10px; border-radius: 5px;\n border: 1px solid; text-transform: uppercase;\n }\n .endpoint-path {\n font-family: var(--font-mono); font-size: .9rem; color: var(--text);\n background: none; border: none; padding: 0;\n word-break: break-all;\n }\n .endpoint-body { padding: 6px 24px 24px; }\n .endpoint-desc { font-size: .9rem; color: var(--text-dim); line-height: 1.7; margin-bottom: 20px; }\n\n /* ── PER-METHOD DOC BLOCKS ── */\n .method-block { padding-top: 20px; }\n .method-block + .method-block { margin-top: 4px; border-top: 1px solid var(--border); }\n .method-block-header { display: flex; align-items: center; gap: 10px; margin-bottom: 12px; }\n .method-block-header .method-badge { font-size: .68rem; }\n .method-block-empty { font-size: .82rem; color: var(--text-muted); }\n\n /* ── CODE BLOCKS ── */\n .example-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }\n .code-block-wrap {\n background: var(--bg-raised); border: 1px solid var(--border);\n border-radius: var(--radius); overflow: hidden;\n }\n .code-bar {\n display: flex; align-items: center; gap: 6px;\n padding: 9px 14px; border-bottom: 1px solid var(--border);\n background: var(--bg-card);\n }\n .dot { width: 11px; height: 11px; border-radius: 50%; }\n .dot-r { background: #ff5f57; }\n .dot-y { background: #febc2e; }\n .dot-g { background: #28c840; }\n .code-label { font-family: var(--font-mono); font-size: .68rem; color: var(--text-dim); margin-left: 4px; }\n pre.code-pre {\n font-family: var(--font-mono); font-size: .78rem; line-height: 1.7;\n padding: 16px 18px; overflow-x: auto; tab-size: 2; white-space: pre;\n }\n .c-dim { color: var(--text-muted); }\n .c-green { color: #7AAE8E; }\n .c-blue { color: #60a5fa; }\n .c-orange { color: #fb923c; }\n .c-purple { color: #a78bfa; }\n .c-accent { color: var(--accent); }\n .status-2xx { color: #7AAE8E; }\n .status-4xx { color: #f87171; }\n .status-5xx { color: #fb923c; }\n\n /* ── EMPTY STATE ── */\n .empty-state {\n text-align: center; padding: 80px 24px;\n color: var(--text-muted); font-size: .9rem;\n }\n\n /* ── RESPONSIVE ── */\n @media (max-width: 900px) {\n .docs-layout { grid-template-columns: 1fr; }\n .docs-sidebar { position: static; max-height: none; overflow-y: visible; padding-right: 0; }\n .example-grid { grid-template-columns: 1fr; }\n .search-wrap { margin-left: 0; width: 100%; }\n .search-input { width: 100%; }\n }\n @media (max-width: 600px) {\n .page-hero { padding: 32px 0 32px; }\n .page-title { font-size: 2rem; }\n }\n </style>\n</head>\n<body>\n\n <div class=\"page-hero\">\n <div class=\"hero-glow\"></div>\n <div class=\"container\">\n <h1 class=\"page-title\">${projectName}${projectVersion ? `<span class=\"project-version\">v${projectVersion}</span>` : ''}</h1>\n <div class=\"hero-meta\">\n <div class=\"base-url-pill\">\n <span class=\"base-url-label\">Base</span>\n <span class=\"base-url-val\">http://localhost:${port}${basePath}</span>\n </div>\n <div class=\"count-pill\" id=\"countPill\"></div>\n </div>\n <div class=\"toolbar\">\n <div class=\"method-filters\" id=\"methodFilters\">\n <button class=\"filter-btn active\" data-method=\"ALL\">ALL</button>\n </div>\n <div class=\"search-wrap\">\n <input type=\"text\" id=\"searchInput\" class=\"search-input\" placeholder=\"Search endpoints…\" />\n </div>\n </div>\n </div>\n </div>\n\n <div class=\"docs-layout\">\n <aside class=\"docs-sidebar\" id=\"sidebar\"></aside>\n <main id=\"endpoints\"></main>\n </div>\n\n <script>\n const ROUTES = ${safeRoutes};\n const BASE_PATH = ${JSON.stringify(basePath)};\n const HTTP_STATUS = ${safeHttpStatus};\n\n const METHOD_STYLE = {\n GET: { bg: 'rgba(96,165,250,.14)', color: '#60a5fa', border: 'rgba(96,165,250,.35)' },\n POST: { bg: 'rgba(122,174,142,.14)', color: '#7AAE8E', border: 'rgba(122,174,142,.35)' },\n PUT: { bg: 'rgba(240,160,48,.14)', color: '#F0A030', border: 'rgba(240,160,48,.35)' },\n PATCH: { bg: 'rgba(251,191,36,.14)', color: '#fbbf24', border: 'rgba(251,191,36,.35)' },\n DELETE: { bg: 'rgba(248,113,113,.14)', color: '#f87171', border: 'rgba(248,113,113,.35)' },\n HEAD: { bg: 'rgba(167,139,250,.14)', color: '#a78bfa', border: 'rgba(167,139,250,.35)' },\n OPTIONS: { bg: 'rgba(148,163,184,.14)', color: '#94a3b8', border: 'rgba(148,163,184,.35)' },\n };\n\n function esc(s) {\n return String(s)\n .replace(/&/g,'&amp;').replace(/</g,'&lt;')\n .replace(/>/g,'&gt;').replace(/\"/g,'&quot;');\n }\n\n function methodBadge(m) {\n const s = METHOD_STYLE[m] || METHOD_STYLE.GET;\n return '<span class=\"method-badge\" style=\"background:' + s.bg + ';color:' + s.color + ';border-color:' + s.border + '\">' + m + '</span>';\n }\n\n function joinPath(base, p) {\n return (base.replace(/\\\\/+$/, '') + p) || '/';\n }\n\n function sidebarDot(method) {\n const s = METHOD_STYLE[method] || METHOD_STYLE.GET;\n return '<span class=\"sidebar-method-dot\" style=\"background:' + s.color + '\"></span>';\n }\n\n function statusClass(code) {\n if (code >= 200 && code < 300) return 'status-2xx';\n if (code >= 400 && code < 500) return 'status-4xx';\n if (code >= 500) return 'status-5xx';\n return '';\n }\n\n function renderSchema(val, indent) {\n const pad = ' '.repeat(indent || 0);\n if (val === null) return '<span class=\"c-dim\">null</span>';\n if (typeof val === 'string') {\n const isDate = /^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}/.test(val);\n return isDate ? '<span class=\"c-green\">Date</span>' : '<span class=\"c-purple\">String</span>';\n }\n if (typeof val === 'number') return '<span class=\"c-orange\">Number</span>';\n if (typeof val === 'boolean') return '<span class=\"c-purple\">Boolean</span>';\n if (Array.isArray(val)) {\n if (!val.length) return '[]';\n return '[\\\\n' + pad + ' ' + renderSchema(val[0], (indent || 0) + 1) + '\\\\n' + pad + ']';\n }\n if (typeof val === 'object') {\n const keys = Object.keys(val);\n if (!keys.length) return '{}';\n const inner = keys.map(function(k) {\n return pad + ' <span class=\"c-blue\">&quot;' + esc(k) + '&quot;</span>: ' + renderSchema(val[k], (indent || 0) + 1);\n }).join(',\\\\n');\n return '{\\\\n' + inner + '\\\\n' + pad + '}';\n }\n return esc(String(val));\n }\n\n function codeBlock(label, content) {\n return '<div class=\"code-block-wrap\">' +\n '<div class=\"code-bar\">' +\n '<span class=\"dot dot-r\"></span>' +\n '<span class=\"dot dot-y\"></span>' +\n '<span class=\"dot dot-g\"></span>' +\n '<span class=\"code-label\">' + esc(label) + '</span>' +\n '</div>' +\n '<pre class=\"code-pre\">' + content + '</pre>' +\n '</div>';\n }\n\n function buildRequestContent(route, method, example) {\n const req = example || {};\n let path = joinPath(BASE_PATH, route.urlPath);\n if (req.params) {\n for (const [k, v] of Object.entries(req.params)) {\n path = path.replace(':' + k, String(v));\n }\n }\n if (req.query && Object.keys(req.query).length) {\n path += '?' + new URLSearchParams(req.query).toString();\n }\n let lines = '<span class=\"c-accent\">' + esc(method) + '</span> <span class=\"c-blue\">' + esc(path) + '</span>';\n const headers = { ...(req.headers || {}) };\n if (req.body !== undefined && !headers['Content-Type']) {\n headers['Content-Type'] = 'application/json';\n }\n if (Object.keys(headers).length) {\n lines += '\\\\n' + Object.entries(headers)\n .map(([k, v]) => '<span class=\"c-dim\">' + esc(k) + ':</span> ' + esc(String(v)))\n .join('\\\\n');\n }\n if (req.body !== undefined) {\n lines += '\\\\n\\\\n' + renderSchema(req.body, 0);\n }\n return lines;\n }\n\n function buildResponseContent(example) {\n const resp = example || {};\n const code = resp.status || 200;\n const text = HTTP_STATUS[code] || 'OK';\n const cls = statusClass(code);\n let lines = 'HTTP/1.1 <span class=\"' + cls + '\">' + code + ' ' + esc(text) + '</span>';\n if (resp.body !== undefined) {\n lines += '\\\\n<span class=\"c-dim\">Content-Type:</span> application/json\\\\n\\\\n';\n lines += renderSchema(resp.body, 0);\n }\n return lines;\n }\n\n function renderMethodBlock(route, method) {\n const methodMeta = route.meta ? route.meta[method] : null;\n const header = '<div class=\"method-block-header\">' + methodBadge(method) + '</div>';\n\n if (!methodMeta) {\n return '<div class=\"method-block\" data-method=\"' + esc(method) + '\">' + header +\n '<p class=\"method-block-empty\">No documentation provided for this method.</p></div>';\n }\n\n const desc = methodMeta.description\n ? '<p class=\"endpoint-desc\">' + esc(methodMeta.description) + '</p>'\n : '';\n const reqHtml = methodMeta.request !== undefined\n ? codeBlock('request', buildRequestContent(route, method, methodMeta.request))\n : '';\n const respHtml = methodMeta.response !== undefined\n ? codeBlock('response', buildResponseContent(methodMeta.response))\n : '';\n const examples = reqHtml || respHtml\n ? '<div class=\"example-grid\">' + reqHtml + respHtml + '</div>'\n : '';\n\n return '<div class=\"method-block\" data-method=\"' + esc(method) + '\">' + header + desc + examples + '</div>';\n }\n\n function renderCard(route, index) {\n const id = 'ep-' + index;\n const fullPath = joinPath(BASE_PATH, route.urlPath);\n const badges = route.methods.map(methodBadge).join('');\n const body = route.methods.map(function(m) { return renderMethodBlock(route, m); }).join('');\n const delay = (index * 0.06).toFixed(2) + 's';\n return '<div class=\"endpoint-card\" id=\"' + id + '\" data-methods=\"' + route.methods.join(',') + '\" data-path=\"' + esc(fullPath) + '\" style=\"animation-delay:' + delay + '\">' +\n '<div class=\"endpoint-header\">' +\n '<div class=\"method-badges\">' + badges + '</div>' +\n '<code class=\"endpoint-path\">' + esc(fullPath) + '</code>' +\n '</div>' +\n '<div class=\"endpoint-body\">' + body + '</div>' +\n '</div>';\n }\n\n function buildMethodFilters() {\n const allMethods = [...new Set(ROUTES.flatMap(r => r.methods))].sort();\n const filtersEl = document.getElementById('methodFilters');\n allMethods.forEach(m => {\n const btn = document.createElement('button');\n btn.className = 'filter-btn';\n btn.dataset.method = m;\n btn.textContent = m;\n filtersEl.appendChild(btn);\n });\n }\n\n function buildSidebar(routes) {\n const sidebar = document.getElementById('sidebar');\n if (!routes.length) { sidebar.innerHTML = ''; return; }\n\n const label = document.createElement('div');\n label.className = 'sidebar-label';\n label.textContent = 'Endpoints';\n sidebar.appendChild(label);\n\n routes.forEach((route, i) => {\n const link = document.createElement('div');\n link.className = 'sidebar-link';\n link.dataset.target = 'ep-' + ROUTES.indexOf(route);\n link.innerHTML = sidebarDot(route.methods[0] || 'GET') +\n '<span class=\"sidebar-path\">' + esc(route.urlPath || '/') + '</span>';\n link.addEventListener('click', () => {\n const target = document.getElementById(link.dataset.target);\n if (target) target.scrollIntoView({ behavior: 'smooth', block: 'start' });\n });\n sidebar.appendChild(link);\n });\n }\n\n let activeFilter = 'ALL';\n let searchQuery = '';\n\n function applyFilters() {\n const cards = document.querySelectorAll('.endpoint-card');\n let visible = 0;\n cards.forEach(card => {\n const methods = card.dataset.methods.split(',');\n const path = card.dataset.path || '';\n const matchMethod = activeFilter === 'ALL' || methods.includes(activeFilter);\n const matchSearch = !searchQuery || path.toLowerCase().includes(searchQuery);\n const show = matchMethod && matchSearch;\n card.style.display = show ? '' : 'none';\n if (show) visible++;\n });\n document.getElementById('empty-state').style.display = visible ? 'none' : 'block';\n\n // Sync sidebar visibility\n document.querySelectorAll('.sidebar-link').forEach(link => {\n const targetId = link.dataset.target;\n const targetCard = document.getElementById(targetId);\n link.style.display = targetCard && targetCard.style.display !== 'none' ? '' : 'none';\n });\n }\n\n function init() {\n const count = ROUTES.length;\n document.getElementById('countPill').textContent = count + ' endpoint' + (count !== 1 ? 's' : '');\n\n buildMethodFilters();\n\n const container = document.getElementById('endpoints');\n container.innerHTML = ROUTES.map((r, i) => renderCard(r, i)).join('');\n\n // Add empty state after cards\n const emptyEl = document.createElement('div');\n emptyEl.id = 'empty-state';\n emptyEl.className = 'empty-state';\n emptyEl.style.display = 'none';\n emptyEl.innerHTML = '<p>No endpoints match your filter.</p>';\n container.after(emptyEl);\n\n buildSidebar(ROUTES);\n\n // Method filter clicks\n document.getElementById('methodFilters').addEventListener('click', e => {\n const btn = e.target.closest('.filter-btn');\n if (!btn) return;\n document.querySelectorAll('.filter-btn').forEach(b => b.classList.remove('active'));\n btn.classList.add('active');\n activeFilter = btn.dataset.method;\n applyFilters();\n });\n\n // Search\n document.getElementById('searchInput').addEventListener('input', e => {\n searchQuery = e.target.value.trim().toLowerCase();\n applyFilters();\n });\n\n // Scroll spy for sidebar\n const cardEls = document.querySelectorAll('.endpoint-card');\n const sidebarLinks = document.querySelectorAll('.sidebar-link');\n const observer = new IntersectionObserver(entries => {\n entries.forEach(entry => {\n if (entry.isIntersecting) {\n const id = entry.target.id;\n sidebarLinks.forEach(l => l.classList.toggle('active', l.dataset.target === id));\n const sidebar = document.getElementById('sidebar');\n const activeLink = sidebar && sidebar.querySelector('.sidebar-link.active');\n if (sidebar && activeLink) {\n const linkTop = activeLink.getBoundingClientRect().top - sidebar.getBoundingClientRect().top + sidebar.scrollTop;\n sidebar.scrollTo({ top: linkTop, behavior: 'smooth' });\n }\n }\n });\n }, { rootMargin: '-80px 0px -60% 0px' });\n cardEls.forEach(el => observer.observe(el));\n\n }\n\n try {\n init();\n } catch (e) {\n document.body.insertAdjacentHTML('afterbegin',\n '<div style=\"position:fixed;top:60px;left:0;right:0;z-index:9999;background:#7f1d1d;color:#fca5a5;padding:16px 24px;font-family:monospace;font-size:13px;border-bottom:1px solid #ef4444\">' +\n '<strong>Dashboard JS error:</strong> ' + (e && e.message ? e.message : String(e)) +\n (e && e.stack ? '<pre style=\"margin-top:8px;white-space:pre-wrap\">' + e.stack + '</pre>' : '') +\n '</div>'\n );\n }\n </script>\n</body>\n</html>`;\n}\n","import type { Request, RequestHandler } from 'express';\nimport { isCacheConfigured, rawIncr } from './cache/index.js';\nimport { getLogger } from './logger.js';\n\n// rateLimit(): a fixed-window limit (windows aligned to the clock) counted in the cache\n// (`cache.incr`), so every worker — and with Redis every instance — shares one count. An\n// in-memory counter per worker would let N workers accept N × max.\n\nexport interface RateLimitOptions {\n /** Window length: seconds, or `'30s'`, `'15m'`, `'1h'`, `'1d'`. */\n window: number | string;\n /** Requests allowed per window and key. */\n max: number;\n /**\n * Who a request counts against. Default: the client IP (`req.ip`) — behind a proxy or load\n * balancer set `trustProxy` in ignite(), or every client shares the proxy's IP. Return\n * `undefined` to not limit this request.\n */\n key?: (req: Request) => string | undefined;\n /**\n * Which counter: requests to routes with the same name share a limit. Default: the route\n * pattern (`/users/:id`), so each route file has its own — or the path, for middleware\n * that isn't on a route.\n */\n name?: string;\n /** Body of the 429 response. Default: `'Too many requests, try again later'`. */\n message?: string;\n /**\n * The cache can't be reached: `'allow'` (default) lets requests through — a limiter\n * shouldn't take the API down with it; `'reject'` answers 503.\n */\n onCacheError?: 'allow' | 'reject';\n /** Send `RateLimit-Limit/Remaining/Reset` (and `Retry-After` on 429). Default: true. */\n headers?: boolean;\n}\n\nconst UNITS: Record<string, number> = { s: 1, m: 60, h: 3600, d: 86_400 };\n\nexport function parseWindow(window: number | string): number {\n let seconds = typeof window === 'number' ? window : NaN;\n if (typeof window === 'string') {\n const match = /^(\\d+(?:\\.\\d+)?)\\s*(s|m|h|d)$/.exec(window.trim());\n if (match) seconds = Number(match[1]) * UNITS[match[2]!]!;\n }\n if (Number.isFinite(seconds) && seconds * 1000 >= 1 && seconds * 1000 <= Number.MAX_SAFE_INTEGER)\n return seconds;\n throw new Error(`[EFC] rateLimit: window must be seconds or like '15m' — got ${String(window)}`);\n}\n\nlet lastCacheError = 0;\n\n/**\n * Limits requests per key (default: client IP) to `max` per `window`, counted in the cache\n * so the limit holds across every worker and instance:\n *\n * ```ts\n * export const middlewares = [rateLimit({ window: '15m', max: 10 })];\n * ```\n *\n * Needs `cache` in ignite() — use the Redis backend when you run more than one instance.\n */\nexport function rateLimit(options: RateLimitOptions): RequestHandler {\n const windowSeconds = parseWindow(options.window);\n if (!Number.isSafeInteger(options.max) || options.max < 1) {\n throw new Error('[EFC] rateLimit: max must be a positive integer');\n }\n const keyOf = options.key ?? ((req: Request) => req.ip ?? req.socket.remoteAddress);\n const message = options.message ?? 'Too many requests, try again later';\n const headers = options.headers ?? true;\n\n return (req, res, next) => {\n void (async () => {\n const who = keyOf(req);\n if (who === undefined) return next();\n if (!isCacheConfigured()) {\n throw new Error('[EFC] rateLimit needs a cache — pass cache: { backend } to ignite()');\n }\n const bucket = options.name ?? req.baseUrl + (req.route?.path ?? req.path);\n // Windows are aligned to the clock: every key restarts at the same boundary, and the\n // reset is exact. The key outlives its window by a second, then expires.\n const windowMs = windowSeconds * 1000;\n const now = Date.now();\n const slot = Math.floor(now / windowMs);\n const resetMs = (slot + 1) * windowMs - now;\n let count: number;\n try {\n count = (\n await rawIncr(\n `rl:${JSON.stringify([String(bucket), who, slot])}`,\n Math.ceil(resetMs / 1000) + 1,\n )\n ).value;\n } catch (err) {\n if (Date.now() - lastCacheError > 30_000) {\n lastCacheError = Date.now();\n getLogger().error(\n { err },\n `rateLimit: cache unavailable — ${options.onCacheError === 'reject' ? 'rejecting with 503' : 'allowing requests'}`,\n );\n }\n if (options.onCacheError === 'reject') {\n res.status(503).json({ error: 'Service Unavailable', statusCode: 503 });\n return;\n }\n return next();\n }\n const resetSeconds = Math.max(1, Math.ceil(resetMs / 1000));\n if (headers) {\n res.setHeader('RateLimit-Limit', String(options.max));\n res.setHeader('RateLimit-Remaining', String(Math.max(0, options.max - count)));\n res.setHeader('RateLimit-Reset', String(resetSeconds));\n }\n if (count > options.max) {\n if (headers) res.setHeader('Retry-After', String(resetSeconds));\n res.status(429).json({ error: message, statusCode: 429 });\n return;\n }\n next();\n })().catch(next);\n };\n}\n","import { createHash } from 'node:crypto';\nimport type { Request, RequestHandler } from 'express';\nimport { cache } from './index.js';\nimport { getCurrentUser } from '../context.js';\nimport { getLogger } from '../logger.js';\n\nexport interface CacheResponseOptions {\n /** Seconds to keep a response. */\n ttl: number;\n /** Cache per authenticated string/numeric sub/id. Put requireAuth first. */\n perUser?: boolean;\n /** Custom URL identity. Default: original URL, including query. */\n key?: (req: Request) => string;\n}\ninterface Stored {\n status: number;\n json: string;\n headers: Record<string, string>;\n vary: string[];\n variant: string;\n}\nexport const RESPONSE_PREFIX = 'res:';\nconst representationHeaders = [\n 'content-type',\n 'cache-control',\n 'vary',\n 'content-language',\n 'content-disposition',\n 'etag',\n 'last-modified',\n];\nconst variant = (req: Request, names: string[]) =>\n createHash('sha256')\n .update(JSON.stringify(names.map((name) => [name, req.get(name) ?? null])))\n .digest('hex');\n\n/** Cache successful GET/HEAD JSON representations with method/user isolation. */\nexport function cacheResponse(options: number | CacheResponseOptions): RequestHandler {\n const opts: CacheResponseOptions = typeof options === 'number' ? { ttl: options } : options;\n return (req, res, next) => {\n if (req.method !== 'GET' && req.method !== 'HEAD') return next();\n let scope = '';\n if (opts.perUser) {\n const user = getCurrentUser();\n const id = user?.['sub'] ?? user?.['id'];\n if (typeof id !== 'string' && (typeof id !== 'number' || !Number.isFinite(id))) return next();\n scope = `u:${JSON.stringify([id])}:`;\n }\n // NUL cannot occur in an HTTP request URL. Keep URL-prefix invalidation while\n // preventing HEAD/GET and legacy-key collisions.\n const key =\n RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl) + '\\0' + req.method;\n void (async () => {\n const hit = await cache.get<Stored>(key);\n if (\n hit &&\n typeof hit.json === 'string' &&\n Array.isArray(hit.vary) &&\n hit.variant === variant(req, hit.vary)\n ) {\n res.set(hit.headers);\n res.setHeader('X-Cache', 'HIT');\n res.status(hit.status).send(hit.json);\n return;\n }\n res.setHeader('X-Cache', 'MISS');\n let captured = false;\n let snapshot = '';\n // Store the actual serialized JSON, not a mutable application object or a\n // different rendering that ignores Express's JSON replacer.\n const json = res.json.bind(res);\n res.json = (body: unknown) => {\n const send = res.send;\n const eligible = !res.headersSent && res.statusCode === 200;\n res.send = (rendered: unknown) => {\n if (eligible && typeof rendered === 'string') {\n try {\n JSON.parse(rendered);\n snapshot = rendered;\n captured = true;\n } catch {\n /* Not JSON. */\n }\n }\n return send.call(res, rendered);\n };\n try {\n return json(body);\n } finally {\n res.send = send;\n }\n };\n res.once('finish', () => {\n if (!captured || res.statusCode !== 200 || res.getHeader('set-cookie') !== undefined)\n return;\n const control = String(res.getHeader('cache-control') ?? '');\n if (\n /(?:^|,)\\s*(?:no-store|no-cache)(?:\\s|,|=|$)/i.test(control) ||\n (!opts.perUser && /(?:^|,)\\s*private(?:\\s|,|=|$)/i.test(control))\n )\n return;\n const vary = String(res.getHeader('vary') ?? '')\n .split(',')\n .map((name) => name.trim().toLowerCase())\n .filter(Boolean);\n if (vary.includes('*')) return;\n const headers: Record<string, string> = {};\n for (const name of representationHeaders) {\n const value = res.getHeader(name);\n if (value !== undefined)\n headers[name] = Array.isArray(value) ? value.join(', ') : String(value);\n }\n const stored: Stored = {\n status: 200,\n json: snapshot,\n headers,\n vary,\n variant: variant(req, vary),\n };\n void cache\n .set(key, stored, { ttl: opts.ttl })\n .catch((error) => getLogger().debug({ err: error }, 'Response cache write failed'));\n });\n next();\n })().catch(next);\n };\n}\n","import type { RequestHandler } from 'express';\n\n/**\n * Chains multiple Express request handlers into a single handler.\n * Each handler calls the next one via its `next` callback.\n *\n * @example\n * export const GET = compose(requireAuth, rateLimiter, myHandler);\n */\nexport function compose(...handlers: RequestHandler[]): RequestHandler {\n return (req, res, next) => {\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(\n handler(req, res, (err?: unknown) => (err ? next(err) : dispatch(i + 1))),\n ).catch(next);\n } catch (err) {\n next(err);\n }\n }\n\n dispatch(0);\n };\n}\n"],"mappings":"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","names":["fs","cluster","path","path","fs","cluster"]}
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "0.12.0",
2
+ "version": "0.12.1",
3
3
  "variants": [
4
4
  {
5
5
  "key": "ts-mongo",
package/dist/testing.cjs CHANGED
@@ -3,7 +3,7 @@
3
3
 
4
4
 
5
5
 
6
- var _chunkBJR42CN3cjs = require('./chunk-BJR42CN3.cjs');
6
+ var _chunkAG7PVYPEcjs = require('./chunk-AG7PVYPE.cjs');
7
7
 
8
8
 
9
9
  var _chunkH6MHRHUPcjs = require('./chunk-H6MHRHUP.cjs');
@@ -41,7 +41,7 @@ async function createTestApp(options) {
41
41
  ...options.auth.cookieDomain !== void 0 && { cookieDomain: options.auth.cookieDomain }
42
42
  });
43
43
  }
44
- const app = _chunkBJR42CN3cjs.createHttpApp.call(void 0, {
44
+ const app = _chunkAG7PVYPEcjs.createHttpApp.call(void 0, {
45
45
  cors: false,
46
46
  ...options.tracing !== void 0 && { tracing: options.tracing },
47
47
  ...options.globalMiddlewares !== void 0 && {
@@ -51,14 +51,14 @@ async function createTestApp(options) {
51
51
  ...options.trustProxy !== void 0 && { trustProxy: options.trustProxy }
52
52
  });
53
53
  const router = _express2.default.Router();
54
- const mounted = await _chunkBJR42CN3cjs.mountRoutes.call(void 0, router, _chunk4FQP6QX3cjs.scanDir.call(void 0, apiDir));
54
+ const mounted = await _chunkAG7PVYPEcjs.mountRoutes.call(void 0, router, _chunk4FQP6QX3cjs.scanDir.call(void 0, apiDir));
55
55
  if (options.openapi)
56
- await _chunkBJR42CN3cjs.mountOpenAPI.call(void 0, app, mounted, {
56
+ await _chunkAG7PVYPEcjs.mountOpenAPI.call(void 0, app, mounted, {
57
57
  ...options.openapi === true ? {} : options.openapi,
58
58
  basePath: _nullishCoalesce(options.basePath, () => ( "/v1/api"))
59
59
  });
60
60
  app.use(_nullishCoalesce(options.basePath, () => ( "/v1/api")), router);
61
- _chunkBJR42CN3cjs.mountErrorHandler.call(void 0, app, options.onError);
61
+ _chunkAG7PVYPEcjs.mountErrorHandler.call(void 0, app, options.onError);
62
62
  return app;
63
63
  }
64
64
 
package/dist/testing.js CHANGED
@@ -3,7 +3,7 @@ import {
3
3
  mountErrorHandler,
4
4
  mountOpenAPI,
5
5
  mountRoutes
6
- } from "./chunk-LIAGVWFQ.js";
6
+ } from "./chunk-ZU2GK5WY.js";
7
7
  import {
8
8
  configureAuth
9
9
  } from "./chunk-X2B7WBKH.js";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "express-file-cluster",
3
- "version": "0.12.0",
3
+ "version": "0.12.1",
4
4
  "description": "Enterprise-grade, zero-boilerplate backend framework with file-based routing and multi-core clustering",
5
5
  "homepage": "https://efc.prashantadhikari7.com.np/",
6
6
  "repository": {
@@ -1 +0,0 @@
1
- {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-BJR42CN3.cjs","../src/websocket.ts","../src/middleware.ts","../src/router/validate.ts","../src/router/mount.ts","../src/openapi.ts","../src/http-app.ts"],"names":["path"],"mappings":"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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-BJR42CN3.cjs","sourcesContent":[null,"import http from 'node:http';\nimport type { Socket } from 'node:net';\nimport type { Express, Request, RequestHandler, Response } from 'express';\nimport { WebSocketServer, WebSocket } from 'ws';\nimport { getRequestContext, runWithContext } from './context.js';\nimport { getLogger } from './logger.js';\nimport { processState } from './process-state.js';\n\nexport type WebSocketHandler = (socket: WebSocket, request: Request) => void | Promise<void>;\nexport interface WebSocketOptions {\n /** Default 1 MiB. Compression is disabled. */\n maxPayload?: number;\n /** Browser origins; default is same-origin. Clients without Origin are allowed. */\n origins?: string[];\n /** Default 30 seconds; 0 disables heartbeat. */\n heartbeatIntervalMs?: number;\n /** Default 10 seconds to finish upgrade middleware. */\n handshakeTimeoutMs?: number;\n}\ninterface Upgrade {\n options: WebSocketOptions;\n accepted: boolean;\n accept: (handler: WebSocketHandler, req: Request, res: Response) => void;\n}\nconst UPGRADE = Symbol.for('express-file-cluster.websocket-upgrade.v1');\ntype UpgradeRequest = Request & { [UPGRADE]?: Upgrade };\ninterface State {\n wss: WebSocketServer;\n pending: Set<Socket>;\n stopHeartbeat: () => void;\n closing?: Promise<void>;\n}\nconst servers = processState('websocket-servers', () => new WeakMap<http.Server, State>());\nexport const isUpgrade = (req: Request): boolean => !!(req as UpgradeRequest)[UPGRADE];\n\n/** Gate mounted before file middleware: ordinary HTTP continues to its own handler. */\nexport const websocketOnly: RequestHandler = (req, res, next) => {\n const upgrade = (req as UpgradeRequest)[UPGRADE];\n if (!upgrade) return next('route');\n const origin = req.headers.origin;\n if (origin !== undefined) {\n let valid = false;\n try {\n const parsed = new URL(origin);\n valid =\n parsed.origin === origin &&\n ['http:', 'https:'].includes(parsed.protocol) &&\n (upgrade.options.origins\n ? upgrade.options.origins.includes(origin)\n : origin === `${req.protocol}://${req.get('host')}`);\n } catch {\n /* malformed and opaque origins are refused */\n }\n if (!valid) {\n res.status(403).json({ error: 'WebSocket origin rejected' });\n return;\n }\n }\n next();\n};\nexport function websocketHandler(handler: WebSocketHandler): RequestHandler {\n return (req, res) => {\n (req as UpgradeRequest)[UPGRADE]!.accept(handler, req, res);\n };\n}\n\n/** Attach upgrade handling to an EFC HTTP app/server (also useful with createTestApp). */\nexport function attachWebSockets(\n server: http.Server,\n app: Express,\n options: WebSocketOptions = {},\n): WebSocketServer {\n if (servers.has(server)) throw new Error('[EFC] WebSockets already attached to this server');\n const maxPayload = options.maxPayload ?? 1024 * 1024;\n const heartbeat = options.heartbeatIntervalMs ?? 30000;\n const timeout = options.handshakeTimeoutMs ?? 10000;\n for (const [name, value, minimum] of [\n ['maxPayload', maxPayload, 1],\n ['heartbeatIntervalMs', heartbeat, 0],\n ['handshakeTimeoutMs', timeout, 1],\n ] as const) {\n // ws coerces maxPayload to int32; Node timers also have a signed int32 ceiling.\n if (!Number.isSafeInteger(value) || value < minimum || value > 0x7fffffff)\n throw new Error(`[EFC] websocket.${name} must be an integer from ${minimum} to 2147483647`);\n }\n for (const origin of options.origins ?? []) {\n const parsed = new URL(origin);\n if (parsed.origin !== origin || !['http:', 'https:'].includes(parsed.protocol))\n throw new Error('[EFC] websocket.origins must contain HTTP(S) origins');\n }\n const wss = new WebSocketServer({ noServer: true, maxPayload, perMessageDeflate: false });\n // ws writes the 101 response itself; preserve ordinary middleware headers without\n // allowing them to replace protocol framing/negotiation headers.\n const reserved = new Set([\n 'upgrade',\n 'connection',\n 'sec-websocket-accept',\n 'sec-websocket-protocol',\n 'sec-websocket-extensions',\n 'content-length',\n 'transfer-encoding',\n 'content-type',\n ]);\n wss.on('headers', (headers, incoming) => {\n const response = (incoming as Request).res;\n for (const [name, value] of Object.entries(response?.getHeaders() ?? {})) {\n if (reserved.has(name.toLowerCase()) || value === undefined) continue;\n for (const entry of Array.isArray(value) ? value : [value])\n headers.push(name + ': ' + String(entry));\n }\n });\n const alive = new WeakSet<WebSocket>();\n const interval = heartbeat\n ? setInterval(() => {\n for (const client of wss.clients) {\n if (!alive.has(client)) {\n client.terminate();\n continue;\n }\n alive.delete(client);\n if (client.readyState === WebSocket.OPEN) client.ping();\n }\n }, heartbeat)\n : undefined;\n interval?.unref();\n const state: State = {\n wss,\n pending: new Set(),\n stopHeartbeat: () => {\n if (interval) clearInterval(interval);\n },\n };\n servers.set(server, state);\n server.on('upgrade', (incoming, socket, head) => {\n if (state.closing) {\n socket.destroy();\n return;\n }\n const req = incoming as UpgradeRequest;\n const response = new http.ServerResponse(incoming) as Response;\n try {\n response.assignSocket(socket as Socket);\n } catch {\n // A pipelined upgrade can arrive while the preceding HTTP response still\n // owns this socket. Reject the connection instead of crashing the worker.\n socket.destroy();\n return;\n }\n state.pending.add(socket as Socket);\n const onError = () => socket.destroy();\n socket.on('error', onError);\n const timer = setTimeout(() => {\n if (!response.headersSent)\n response.status(408).json({ error: 'WebSocket upgrade timed out' });\n socket.end();\n }, timeout);\n timer.unref();\n socket.once('close', () => {\n state.pending.delete(socket as Socket);\n clearTimeout(timer);\n socket.removeListener('error', onError);\n });\n const upgrade: Upgrade = {\n options,\n accepted: false,\n accept(handler, request, res) {\n if (upgrade.accepted || res.headersSent || socket.destroyed || state.closing) return;\n upgrade.accepted = true;\n clearTimeout(timer);\n wss.handleUpgrade(incoming, socket, head, (ws) => {\n state.pending.delete(socket as Socket);\n res.detachSocket(socket as Socket);\n res.statusCode = 101;\n res.emit('finish'); // Finish HTTP accounting and clear requestTimeout without writing HTTP bytes.\n socket.removeListener('error', onError);\n alive.add(ws);\n ws.on('pong', () => alive.add(ws));\n const context = {\n ...getRequestContext(),\n user: (request as Request & { user?: Record<string, unknown> }).user,\n };\n const emit = ws.emit;\n ws.emit = ((event: string | symbol, ...args: unknown[]) =>\n runWithContext({ ...context, queryCounts: new Map() }, () =>\n Reflect.apply(emit, ws, [event, ...args]),\n )) as typeof ws.emit;\n ws.on('error', (error) => getLogger().warn({ err: error }, 'WebSocket error'));\n const failed = (error: unknown) => {\n getLogger().error({ err: error }, 'WebSocket handler failed');\n ws.close(1011, 'Internal Server Error');\n };\n try {\n void Promise.resolve(\n runWithContext(context, () => {\n wss.emit('connection', ws, incoming);\n return handler(ws, request);\n }),\n ).catch(failed);\n } catch (error) {\n failed(error);\n }\n });\n },\n };\n req[UPGRADE] = upgrade;\n response.once('finish', () => {\n clearTimeout(timer);\n if (!upgrade.accepted) socket.end();\n });\n app(req, response);\n });\n // HTTP server.close() alone does not drain upgraded sockets.\n const close = server.close;\n server.close = function (callback?: (error?: Error) => void) {\n void closeWebSockets(server);\n return close.call(this, callback);\n };\n server.once('close', () => {\n state.stopHeartbeat();\n });\n return wss;\n}\n\n/** Close upgraded sockets with 1001, then terminate peers that do not acknowledge. */\nexport function closeWebSockets(server: http.Server, timeoutMs = 1000): Promise<void> {\n const state = servers.get(server);\n if (!state) return Promise.resolve();\n if (state.closing) return state.closing;\n state.stopHeartbeat();\n state.closing = new Promise<void>((resolve) => {\n for (const socket of state.pending) socket.destroy();\n state.pending.clear();\n const timer = setTimeout(() => {\n for (const client of state.wss.clients) client.terminate();\n }, timeoutMs);\n timer.unref();\n state.wss.close(() => {\n clearTimeout(timer);\n resolve();\n });\n for (const client of state.wss.clients) client.close(1001, 'Server shutting down');\n });\n return state.closing;\n}\n","import type { RequestHandler, ErrorRequestHandler } from 'express';\n\n/** Express 4 does not observe returned promises. Keep its next/skip semantics. */\nexport function asyncWrap(handler: RequestHandler): RequestHandler {\n if (typeof handler !== 'function') throw new TypeError('[EFC] Middleware must be a function');\n return (req, res, next) => {\n try {\n void Promise.resolve(handler(req, res, next)).catch(next);\n } catch (error) {\n next(error);\n }\n };\n}\nexport function asyncErrorWrap(handler: ErrorRequestHandler): ErrorRequestHandler {\n return (error, req, res, next) => {\n try {\n void Promise.resolve(handler(error, req, res, next)).catch(next);\n } catch (failure) {\n next(failure);\n }\n };\n}\n","import type { Request, RequestHandler } from 'express';\nimport type { RequestSchema, RouteSchema, ValidationIssue, Validator } from '../types.js';\n\nconst LOCATIONS = ['params', 'query', 'body'] as const;\ntype Location = (typeof LOCATIONS)[number];\n\ninterface StandardResult {\n value?: unknown;\n issues?: ReadonlyArray<{\n message: string;\n path?: ReadonlyArray<PropertyKey | { key: PropertyKey }>;\n }>;\n}\n\nfunction isRequestSchema(value: unknown): value is RequestSchema {\n return (\n value != null &&\n typeof value === 'object' &&\n LOCATIONS.some((loc) => loc in (value as Record<string, unknown>))\n );\n}\n\n/** Picks the schema for `method`: a method-keyed entry wins over a file-wide one. */\nexport function schemaFor(\n schema: RouteSchema | undefined,\n method: string,\n): RequestSchema | undefined {\n if (!schema) return undefined;\n const byMethod = (schema as Record<string, unknown>)[method];\n if (isRequestSchema(byMethod)) return byMethod;\n return isRequestSchema(schema) ? schema : undefined;\n}\n\ntype IssuePath = ReadonlyArray<PropertyKey | { key: PropertyKey }> | undefined;\n\nfunction pathToString(path: IssuePath): string {\n if (!path) return '';\n return path\n .map((p) => (typeof p === 'object' && p !== null && 'key' in p ? p.key : p))\n .map(String)\n .join('.');\n}\n\n// Standard Schema (zod >=3.24, valibot, arktype, ...) first; plain zod-style\n// safeParse as a fallback so older zod 3 releases work too.\nasync function run(validator: Validator, input: unknown): Promise<StandardResult> {\n const std = (validator as { '~standard'?: { validate: (v: unknown) => unknown } })['~standard'];\n if (std && typeof std.validate === 'function') {\n return (await std.validate(input)) as StandardResult;\n }\n const v = validator as {\n safeParseAsync?: (x: unknown) => Promise<unknown>;\n safeParse?: (x: unknown) => unknown;\n };\n const parse = v.safeParseAsync ?? v.safeParse;\n if (typeof parse !== 'function') {\n throw new Error('[EFC] Route schema entries must be Standard Schema validators (e.g. zod)');\n }\n const r = (await parse.call(validator, input)) as {\n success: boolean;\n data?: unknown;\n error?: { issues: Array<{ message: string; path: PropertyKey[] }> };\n };\n return r.success ? { value: r.data } : { issues: r.error?.issues ?? [{ message: 'Invalid' }] };\n}\n\n/**\n * Validates params/query/body against the route's schema. On success the parsed\n * output replaces the raw input (so coercions and defaults apply); on failure\n * responds 400 with every issue across all locations.\n */\nexport function validateRequest(schema: RequestSchema): RequestHandler {\n return (req, res, next) => {\n void (async () => {\n const issues: ValidationIssue[] = [];\n const parsed: Partial<Record<Location, unknown>> = {};\n\n for (const location of LOCATIONS) {\n const validator = schema[location];\n if (!validator) continue;\n const result = await run(validator, req[location]);\n if (result.issues) {\n for (const issue of result.issues) {\n issues.push({ location, path: pathToString(issue.path), message: issue.message });\n }\n } else {\n parsed[location] = result.value;\n }\n }\n\n if (issues.length > 0) {\n res.status(400).json({ error: 'Validation failed', statusCode: 400, issues });\n return;\n }\n\n for (const location of LOCATIONS) {\n if (location in parsed) {\n // req.query is a getter in some Express setups — define rather than assign.\n Object.defineProperty(req as Request, location, {\n value: parsed[location],\n writable: true,\n configurable: true,\n enumerable: true,\n });\n }\n }\n next();\n })().catch(next);\n };\n}\n","import { asyncWrap } from '../middleware.js';\nimport type { IRouter, RequestHandler } from 'express';\nimport type { MountedRoute, RouteMeta, RouteEntry, RouteSchema } from '../types.js';\nimport { schemaFor, validateRequest } from './validate.js';\nimport { isUpgrade, websocketOnly, websocketHandler, type WebSocketHandler } from '../websocket.js';\n\nimport { traceRoute } from '../tracing.js';\n\nconst HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'] as const;\ntype HttpMethod = (typeof HTTP_METHODS)[number];\n\n/**\n * For RegExp-mounted (catch-all) routes, Express exposes captures as params[0..n].\n * Rename them to the segment names from the file path; catch-alls become string\n * arrays (`[...slug]` → `['a', 'b']`), absent optional segments become undefined.\n */\nfunction namedParams(route: RouteEntry): RequestHandler {\n const catchAlls = new Set([...route.urlPath.matchAll(/:([A-Za-z0-9_$]+)\\*/g)].map((m) => m[1]!));\n return (req, _res, next) => {\n // Express has already decoded req.params. Read the raw captures so splitting\n // happens before decoding (an encoded slash belongs to a single segment).\n const captures = route.pattern!.exec(req.path);\n const named: Record<string, unknown> = {};\n route.params.forEach((name, i) => {\n const value = captures?.[i + 1];\n if (value === undefined || value === '') {\n named[name] = catchAlls.has(name) ? [] : undefined;\n } else if (catchAlls.has(name)) {\n named[name] = value.split('/').filter(Boolean).map(decodeURIComponent);\n } else {\n named[name] = decodeURIComponent(value);\n }\n });\n req.params = named as typeof req.params;\n next();\n };\n}\n\nexport async function mountRoutes(app: IRouter, routes: RouteEntry[]): Promise<MountedRoute[]> {\n const mounted: MountedRoute[] = [];\n\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 raw = mod['meta'];\n const meta: RouteMeta | undefined =\n raw != null && typeof raw === 'object' && !Array.isArray(raw)\n ? (raw as RouteMeta)\n : undefined;\n\n const schema =\n mod['schema'] != null && typeof mod['schema'] === 'object'\n ? (mod['schema'] as RouteSchema)\n : undefined;\n\n const routePath = route.pattern ?? route.urlPath;\n const paramMapper = route.pattern ? [namedParams(route)] : [];\n\n const websocket = typeof mod['WS'] === 'function';\n if (mod['WS'] !== undefined && !websocket)\n throw new Error(`[EFC] WS must be a function: ${route.filePath}`);\n if (websocket) {\n const validation = schemaFor(schema, 'WS');\n app.all(\n routePath,\n websocketOnly,\n traceRoute(route.urlPath),\n ...paramMapper,\n ...routeMiddlewares.map(asyncWrap),\n ...(validation ? [validateRequest(validation)] : []),\n websocketHandler(mod['WS'] as WebSocketHandler),\n );\n }\n const httpOnly: RequestHandler = (req, _res, next) => (isUpgrade(req) ? next('route') : next());\n const implemented = HTTP_METHODS.filter((method) => typeof mod[method] === 'function');\n const unimplemented = HTTP_METHODS.filter((method) => typeof mod[method] !== 'function');\n // Express GET also matches HEAD, so explicit HEAD must be registered first.\n const order = ['HEAD', ...HTTP_METHODS.filter((method) => method !== 'HEAD')] as HttpMethod[];\n for (const method of order) {\n if (!implemented.includes(method)) continue;\n const methodSchema = schemaFor(schema, method);\n const validation = methodSchema ? [validateRequest(methodSchema)] : [];\n app[method.toLowerCase() as Lowercase<HttpMethod>](\n routePath,\n httpOnly,\n traceRoute(route.urlPath),\n ...paramMapper,\n ...routeMiddlewares.map(asyncWrap),\n ...validation,\n asyncWrap(mod[method] as RequestHandler),\n );\n }\n\n if (implemented.length > 0 && unimplemented.length > 0) {\n const allowHeader = implemented.join(', ');\n app.all(routePath, (req, res, next) => {\n if (isUpgrade(req)) return next();\n if ((unimplemented as string[]).includes(req.method)) {\n traceRoute(route.urlPath)(req, res, () => {});\n res.set('Allow', allowHeader).status(405).json({ error: 'Method Not Allowed' });\n } else {\n next();\n }\n });\n }\n\n mounted.push({\n ...route,\n methods: implemented,\n ...(meta !== undefined && { meta }),\n ...(schema && { schema }),\n ...(websocket && { websocket }),\n });\n }\n\n return mounted;\n}\n\nexport { asyncWrap };\n","import { Router, type Express, type Request, type Response } from 'express';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { scanDir } from './router/scan.js';\nimport type { MountedRoute, Validator } from './types.js';\nimport { schemaFor } from './router/validate.js';\n\nexport type JSONSchema = boolean | Record<string, unknown>;\nexport interface OpenAPIOptions {\n /** Absolute static URL for the document. Default /openapi.json. */\n path?: string;\n info?: { title: string; version: string; description?: string };\n servers?: Array<{ url: string; description?: string }>;\n components?: Record<string, unknown>;\n /** Adapter for validators without Standard JSON Schema support. */\n schemaToJSONSchema?: (validator: Validator) => JSONSchema | Promise<JSONSchema>;\n}\nexport interface OpenAPIDocument {\n openapi: '3.1.0';\n info: { title: string; version: string; description?: string };\n paths: Record<string, Record<string, unknown>>;\n components: Record<string, unknown> & { schemas: Record<string, JSONSchema> };\n servers?: Array<{ url: string; description?: string }>;\n}\nconst pointer = (value: string) => value.replace(/~/g, '~0').replace(/\\//g, '~1');\nconst record = (value: unknown): Record<string, unknown> | undefined =>\n value !== null && typeof value === 'object' && !Array.isArray(value)\n ? (value as Record<string, unknown>)\n : undefined;\n\n/** Expand optional URL segments: OpenAPI requires every path parameter to be present. */\nfunction variants(url: string): string[] {\n let paths = [''];\n for (const segment of url.split('/').filter(Boolean)) {\n const optional = /^:([\\w$]+)(\\*)?\\?$/.test(segment);\n const formatted = segment.replace(/:([\\w$]+)\\*?\\??/g, '{$1}');\n paths = paths.flatMap((path) =>\n optional ? [path + '/' + formatted, path] : [path + '/' + formatted],\n );\n if (paths.length > 256) throw new Error('[EFC] OpenAPI: too many optional path variants');\n }\n // Express greedily fills earlier optional parameters. Keep that binding when\n // several expansions describe the same URL shape, which OAS cannot duplicate.\n const shapes = new Set<string>();\n return paths\n .map((path) => path || '/')\n .filter((path) => {\n const shape = path.replace(/\\{[^}]+\\}/g, '{}');\n if (shapes.has(shape)) return false;\n shapes.add(shape);\n return true;\n });\n}\nfunction rebase(value: unknown, root: string, resource = false): unknown {\n if (Array.isArray(value)) return value.map((child) => rebase(child, root, resource));\n const object = record(value);\n if (!object) return value;\n resource = resource || typeof object.$id === 'string';\n const maps = new Set([\n 'properties',\n 'patternProperties',\n '$defs',\n 'definitions',\n 'dependentSchemas',\n ]);\n const children = new Set([\n 'items',\n 'additionalProperties',\n 'contains',\n 'propertyNames',\n 'not',\n 'if',\n 'then',\n 'else',\n 'unevaluatedProperties',\n 'unevaluatedItems',\n 'contentSchema',\n 'allOf',\n 'anyOf',\n 'oneOf',\n 'prefixItems',\n ]);\n return Object.fromEntries(\n Object.entries(object).map(([key, child]) => {\n if (\n !resource &&\n (key === '$ref' || key === '$dynamicRef') &&\n typeof child === 'string' &&\n (child === '#' || child.startsWith('#/'))\n )\n return [key, root + child.slice(1)];\n if (maps.has(key) && record(child))\n return [\n key,\n Object.fromEntries(\n Object.entries(child as Record<string, unknown>).map(([name, schema]) => [\n name,\n rebase(schema, root, resource),\n ]),\n ),\n ];\n return [key, children.has(key) ? rebase(child, root, resource) : child];\n }),\n );\n}\n\ninterface ParameterField {\n schema: JSONSchema;\n object: boolean;\n array: boolean;\n}\ninterface ParameterShape {\n properties: Map<string, ParameterField>;\n required: Set<string>;\n}\n\nfunction parameterObject(schema: JSONSchema | undefined, rootRef: string): ParameterShape {\n const empty = (): ParameterShape => ({ properties: new Map(), required: new Set() });\n if (schema === undefined) return empty();\n const target = (ref: string): unknown => {\n if (!ref.startsWith('#/')) throw new Error('parameter schemas need local JSON pointers');\n let value: unknown = schema;\n for (const part of ref.slice(2).split('/')) {\n const key = part.replace(/~1/g, '/').replace(/~0/g, '~');\n const object = record(value);\n // Arrays occur in pointers into anyOf/allOf/oneOf branches.\n value = Array.isArray(value)\n ? value[Number(key)]\n : object && Object.hasOwn(object, key)\n ? object[key]\n : undefined;\n }\n return value;\n };\n const hasType = (value: unknown, type: 'object' | 'array', seen = new Set<string>()): boolean => {\n const object = record(value);\n if (!object) return false;\n if (object.type === type || (type === 'object' && object.properties)) return true;\n if (typeof object.$ref === 'string' && object.$ref.startsWith('#/') && !seen.has(object.$ref)) {\n return hasType(target(object.$ref), type, new Set([...seen, object.$ref]));\n }\n return ['allOf', 'anyOf', 'oneOf'].some(\n (key) =>\n Array.isArray(object[key]) &&\n object[key].some((child: unknown) => hasType(child, type, seen)),\n );\n };\n const merge = (shapes: ParameterShape[], mode: 'allOf' | 'anyOf'): ParameterShape => {\n const result = empty();\n const names = new Set(shapes.flatMap((shape) => [...shape.properties.keys()]));\n for (const name of names) {\n const fields = shapes.flatMap((shape) => {\n const field = shape.properties.get(name);\n return field ? [field] : [];\n });\n result.properties.set(name, {\n schema:\n fields.length === 1 ? fields[0]!.schema : { [mode]: fields.map((field) => field.schema) },\n object: fields.some((field) => field.object),\n array: fields.some((field) => field.array),\n });\n }\n const required = new Set(shapes.flatMap((shape) => [...shape.required]));\n for (const name of required) {\n if (mode === 'allOf' || shapes.every((shape) => shape.required.has(name)))\n result.required.add(name);\n }\n return result;\n };\n const visit = (value: unknown, fragment: string, seen: Set<string>): ParameterShape => {\n const object = record(value);\n if (!object) throw new Error('query/params schemas must describe objects');\n const shapes: ParameterShape[] = [];\n const properties = record(object.properties);\n if (properties || object.type === 'object' || Array.isArray(object.required)) {\n const direct = empty();\n for (const [name, child] of Object.entries(properties ?? {})) {\n direct.properties.set(name, {\n schema: { $ref: rootRef + fragment + '/properties/' + pointer(name) },\n object: hasType(child, 'object'),\n array: hasType(child, 'array'),\n });\n }\n if (Array.isArray(object.required)) {\n for (const name of object.required) if (typeof name === 'string') direct.required.add(name);\n }\n shapes.push(direct);\n }\n if (typeof object.$ref === 'string') {\n if (seen.has(object.$ref)) throw new Error('cyclic parameter object reference');\n shapes.push(\n visit(target(object.$ref), object.$ref.slice(1), new Set([...seen, object.$ref])),\n );\n }\n for (const key of ['allOf', 'anyOf', 'oneOf'] as const) {\n const branches = object[key];\n if (!Array.isArray(branches) || !branches.length) continue;\n shapes.push(\n merge(\n branches.map((branch, index) => visit(branch, fragment + '/' + key + '/' + index, seen)),\n key === 'allOf' ? 'allOf' : 'anyOf',\n ),\n );\n }\n if (!shapes.length)\n throw new Error(\n 'query/params schemas must describe objects; use explicit openapi.parameters for other shapes',\n );\n return merge(shapes, 'allOf');\n };\n return visit(schema, '', new Set());\n}\n\n/** Missing JSON bodies are {} after Express's parsers. Unknown external refs\n * remain conservative; explicit requestBody metadata can override requiredness. */\nfunction acceptsEmptyObject(\n schema: JSONSchema,\n root = schema,\n seen = new Set<string>(),\n): boolean | undefined {\n if (typeof schema === 'boolean') return schema;\n if (schema !== root && typeof schema.$id === 'string') {\n root = schema;\n seen = new Set();\n }\n const results: Array<boolean | undefined> = [];\n if (typeof schema.$dynamicRef === 'string') results.push(undefined);\n if (schema.type !== undefined) {\n const types = Array.isArray(schema.type) ? schema.type : [schema.type];\n results.push(types.includes('object'));\n }\n const isEmpty = (value: unknown) => !!record(value) && Object.keys(value as object).length === 0;\n if ('const' in schema) results.push(isEmpty(schema.const));\n if (Array.isArray(schema.enum)) results.push(schema.enum.some(isEmpty));\n if (Array.isArray(schema.required)) results.push(schema.required.length === 0);\n if (typeof schema.minProperties === 'number') results.push(schema.minProperties <= 0);\n if (typeof schema.$ref === 'string') {\n const ref = schema.$ref;\n if ((!ref.startsWith('#/') && ref !== '#') || seen.has(ref)) results.push(undefined);\n else {\n let target: unknown = root;\n for (const part of ref === '#' ? [] : ref.slice(2).split('/')) {\n const key = part.replace(/~1/g, '/').replace(/~0/g, '~');\n target = Array.isArray(target) ? target[Number(key)] : record(target)?.[key];\n }\n results.push(\n typeof target === 'boolean' || record(target)\n ? acceptsEmptyObject(target as JSONSchema, root, new Set([...seen, ref]))\n : undefined,\n );\n }\n }\n for (const key of ['allOf', 'anyOf', 'oneOf'] as const) {\n if (!Array.isArray(schema[key])) continue;\n const values = schema[key].map((child: JSONSchema) => acceptsEmptyObject(child, root, seen));\n if (key === 'allOf')\n results.push(values.includes(false) ? false : values.includes(undefined) ? undefined : true);\n if (key === 'anyOf')\n results.push(values.includes(true) ? true : values.includes(undefined) ? undefined : false);\n if (key === 'oneOf')\n results.push(\n values.filter((value) => value === true).length > 1\n ? false\n : values.includes(undefined)\n ? undefined\n : values.filter((value) => value === true).length === 1,\n );\n }\n if (typeof schema.not === 'boolean' || record(schema.not)) {\n const value = acceptsEmptyObject(schema.not as JSONSchema, root, seen);\n results.push(value === undefined ? undefined : !value);\n }\n if (typeof schema.if === 'boolean' || record(schema.if)) {\n const condition = acceptsEmptyObject(schema.if as JSONSchema, root, seen);\n const branch = (key: 'then' | 'else') =>\n typeof schema[key] === 'boolean' || record(schema[key])\n ? acceptsEmptyObject(schema[key] as JSONSchema, root, seen)\n : true;\n results.push(\n condition === undefined\n ? branch('then') === branch('else')\n ? branch('then')\n : undefined\n : branch(condition ? 'then' : 'else'),\n );\n }\n return results.includes(false) ? false : results.includes(undefined) ? undefined : true;\n}\n\n/** Generate a document from the same mounted route exports used by the HTTP router. */\nexport async function generateOpenAPI(\n input: MountedRoute[] | string,\n options: OpenAPIOptions & { basePath?: string } = {},\n): Promise<OpenAPIDocument> {\n let routes: MountedRoute[];\n if (typeof input === 'string') {\n if (!input.trim() || !fs.existsSync(input) || !fs.statSync(input).isDirectory())\n throw new Error('[EFC] OpenAPI apiDir must be an existing directory');\n routes = [];\n for (const route of scanDir(path.resolve(input))) {\n const mod = (await import(route.filePath)) as Record<string, unknown>;\n routes.push({\n ...route,\n methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'].filter(\n (method) => typeof mod[method] === 'function',\n ),\n ...(record(mod.meta) && { meta: mod.meta as NonNullable<MountedRoute['meta']> }),\n ...(record(mod.schema) && { schema: mod.schema as NonNullable<MountedRoute['schema']> }),\n });\n }\n } else routes = input;\n const schemas: Record<string, JSONSchema> = {\n ...(record(options.components?.schemas) as Record<string, JSONSchema> | undefined),\n };\n const doc: OpenAPIDocument = {\n openapi: '3.1.0',\n info: options.info ?? { title: 'EFC API', version: '1.0.0' },\n paths: {},\n components: { ...options.components, schemas },\n ...(options.servers && { servers: options.servers }),\n };\n const prefix = (options.basePath ?? '/v1/api').replace(/\\/+$/, '');\n const ids = new Set<string>();\n const pathShapes = new Map<string, string>();\n let sequence = 0;\n const convert = async (validator: Validator, label: string) => {\n const standard = (\n validator as {\n '~standard'?: { jsonSchema?: { input?: (options: { target: string }) => unknown } };\n }\n )['~standard'];\n let converted: unknown;\n try {\n if (standard?.jsonSchema?.input)\n converted = await standard.jsonSchema.input({ target: 'draft-2020-12' });\n else if (options.schemaToJSONSchema) converted = await options.schemaToJSONSchema(validator);\n else throw new Error('validator needs Standard JSON Schema support or schemaToJSONSchema');\n } catch (error) {\n throw new Error(`[EFC] OpenAPI ${label}: ${(error as Error).message}`, { cause: error });\n }\n if (typeof converted !== 'boolean' && !record(converted))\n throw new Error(`[EFC] OpenAPI ${label}: invalid JSON Schema`);\n let name: string;\n do {\n name = 'EfcRequest' + ++sequence;\n } while (Object.hasOwn(schemas, name));\n const ref = '#/components/schemas/' + pointer(name);\n schemas[name] = rebase(converted, ref) as JSONSchema;\n return { ref, schema: converted as JSONSchema };\n };\n for (const route of routes) {\n const paths = variants(prefix + (route.urlPath === '/' ? '' : route.urlPath));\n for (const method of route.methods) {\n const meta = route.meta?.[method];\n const explicit = meta?.openapi ?? {};\n if (explicit.hidden) continue;\n const request = schemaFor(route.schema, method);\n const roots: Partial<\n Record<'params' | 'query' | 'body', Awaited<ReturnType<typeof convert>>>\n > = {};\n for (const location of ['params', 'query', 'body'] as const) {\n if (request?.[location])\n roots[location] = await convert(\n request[location]!,\n `${method} ${route.urlPath} ${location}`,\n );\n }\n for (const [index, path] of paths.entries()) {\n const shape = path.replace(/\\{[^}]+\\}/g, '{}');\n const previous = pathShapes.get(shape);\n if (previous && previous !== path)\n throw new Error(`[EFC] OpenAPI: ambiguous paths ${previous} and ${path}`);\n pathShapes.set(shape, path);\n const item = (doc.paths[path] ??= {});\n if (Object.hasOwn(item, method.toLowerCase())) continue; // Router precedence: first handler wins.\n const pathNames = [...path.matchAll(/\\{([^}]+)\\}/g)].map((match) => match[1]!);\n const parameters: Record<string, unknown>[] = [];\n for (const location of ['params', 'query'] as const) {\n if (explicit.parameters !== undefined) break;\n const root = roots[location];\n let fields: ParameterShape;\n try {\n fields = parameterObject(root?.schema, root?.ref ?? '');\n } catch (error) {\n throw new Error(\n `[EFC] OpenAPI ${method} ${route.urlPath} ${location}: ${(error as Error).message}`,\n { cause: error },\n );\n }\n const { properties, required } = fields;\n const names =\n location === 'params'\n ? pathNames\n : [...new Set([...properties.keys(), ...Object.keys(meta?.request?.query ?? {})])];\n for (const name of names) {\n const field = properties.get(name);\n parameters.push({\n // Brackets keep one-element arrays as arrays in Express's query parser.\n name: location === 'query' && field?.array ? name + '[]' : name,\n in: location === 'params' ? 'path' : 'query',\n required: location === 'params' || required.has(name),\n schema: field?.schema ?? { type: 'string' },\n ...(location === 'query' && field?.object && { style: 'deepObject', explode: true }),\n ...(location === 'query' && field?.array && { style: 'form', explode: true }),\n ...(meta?.request?.[location]?.[name] !== undefined && {\n example: meta.request[location]![name],\n }),\n });\n }\n }\n for (const [name, example] of Object.entries(meta?.request?.headers ?? {})) {\n parameters.push({ name, in: 'header', schema: { type: 'string' }, example });\n }\n const requestedId =\n typeof explicit.operationId === 'string' ? explicit.operationId : meta?.operationId;\n const baseId =\n (requestedId ?? `${method.toLowerCase()}_${path.replace(/[^a-zA-Z0-9_]/g, '_')}`) +\n (requestedId && paths.length > 1 ? '_' + index : '');\n let id = baseId;\n if (requestedId && ids.has(id))\n throw new Error(`[EFC] OpenAPI: duplicate operationId ${id}`);\n let suffix = 2;\n while (ids.has(id)) id = baseId + '_' + suffix++;\n ids.add(id);\n const status = String(meta?.response?.status ?? 200);\n const response = {\n description: 'Response',\n ...(meta?.response?.body !== undefined && {\n content: { 'application/json': { example: meta.response.body } },\n }),\n };\n const overrides = { ...explicit };\n delete overrides.hidden;\n delete overrides.operationId;\n item[method.toLowerCase()] = {\n operationId: id,\n ...(meta?.description && { description: meta.description }),\n ...(meta?.summary && { summary: meta.summary }),\n ...(meta?.tags && { tags: meta.tags }),\n ...(parameters.length && { parameters }),\n ...(roots.query && { 'x-efc-query-schema': { $ref: roots.query.ref } }),\n ...((roots.body || meta?.request?.body !== undefined) && {\n requestBody: {\n required: roots.body ? acceptsEmptyObject(roots.body.schema) !== true : false,\n content: {\n 'application/json': {\n ...(roots.body && { schema: { $ref: roots.body.ref } }),\n ...(meta?.request?.body !== undefined && { example: meta.request.body }),\n },\n },\n },\n }),\n responses: {\n [status]: response,\n ...(request &&\n status !== '400' && { '400': { description: 'Request validation failed' } }),\n },\n ...(route.urlPath.includes('*') && { 'x-efc-catch-all': true }),\n ...overrides,\n };\n }\n }\n }\n return doc;\n}\n\nexport async function mountOpenAPI(\n app: Express,\n routes: MountedRoute[],\n options: OpenAPIOptions & { basePath?: string },\n) {\n const path = options.path ?? '/openapi.json';\n if (!path.startsWith('/') || /[?*:[\\](){}#]/.test(path))\n throw new Error('[EFC] openapi.path must be an absolute static URL path');\n // Probe the actual Express matchers before filtering hidden operations. This\n // also respects case/trailing-slash rules, dynamic routes and implicit HEAD.\n const conflict = await new Promise<boolean>((resolve, reject) => {\n const probe = Router();\n const api = Router();\n for (const route of routes) {\n if (route.methods.some((method) => method === 'GET' || method === 'HEAD'))\n api.get(route.pattern ?? route.urlPath, (_req, _res) => resolve(true));\n }\n probe.use(options.basePath ?? '/v1/api', api);\n probe({ method: 'GET', url: path } as Request, {} as Response, (error?: unknown) => {\n if (error) reject(error);\n else resolve(false);\n });\n });\n if (conflict) throw new Error(`[EFC] OpenAPI URL conflicts with a GET/HEAD route: ${path}`);\n const document = await generateOpenAPI(routes, options);\n app.get(path, (req, res, next) => {\n if (req.headers.upgrade) return next();\n res.json(document);\n });\n return document;\n}\n","import { asyncWrap, asyncErrorWrap } from './middleware.js';\nimport express from 'express';\nimport cors from 'cors';\nimport cookieParser from 'cookie-parser';\nimport type { EFCConfig } from './types.js';\nimport { runWithContext } from './context.js';\nimport { requestLogger, getLogger } from './logger.js';\nimport { httpTracing, traceHttpError } from './tracing.js';\nimport { isHttpError } from './errors.js';\n\n/** Shared production/test HTTP middleware stack; service boot remains in ignite(). */\nexport function createHttpApp(config: EFCConfig): express.Express {\n const globalMiddlewares = config.globalMiddlewares ?? [];\n const app = express();\n if (config.trustProxy !== undefined) app.set('trust proxy', config.trustProxy);\n // defineTable returns `bigint` for bigint columns and bigserial ids, which JSON.stringify\n // rejects; send them as strings (exact — a JS number would lose precision past 2^53).\n app.set('json replacer', (_key: string, value: unknown) =>\n typeof value === 'bigint' ? value.toString() : value,\n );\n\n // Wraps every request in its own AsyncLocalStorage context, first thing, so\n // requireAuth (below) and any downstream code — including a `$currentUser`\n // default resolved inside a mongoose `.create()` call — share the same store.\n app.use((_req, _res, next) => {\n runWithContext({}, next);\n });\n if (config.tracing && (config.tracing === true || config.tracing.http !== false))\n app.use(httpTracing());\n app.use(requestLogger());\n\n if (config.requestTimeout) {\n const ms = config.requestTimeout;\n app.use((_req, res, next) => {\n const timer = setTimeout(() => {\n if (!res.headersSent) res.status(408).json({ error: 'Request Timeout', statusCode: 408 });\n }, ms);\n const clear = () => clearTimeout(timer);\n res.once('finish', clear);\n res.once('close', clear);\n next();\n });\n }\n\n const corsOption = config.cors ?? true;\n if (corsOption !== false) {\n const origin =\n typeof corsOption === 'object' && corsOption.origin !== undefined ? corsOption.origin : true;\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(asyncWrap(mw));\n }\n\n return app;\n}\n\nexport function mountErrorHandler(\n app: express.Express,\n onError?: express.ErrorRequestHandler,\n): void {\n app.use(traceHttpError);\n if (onError) {\n app.use(asyncErrorWrap(onError));\n }\n app.use(\n (err: unknown, _req: express.Request, res: express.Response, _next: express.NextFunction) => {\n // e.g. a handler that kept going after requestTimeout already answered 408.\n if (res.headersSent) {\n getLogger().warn({ err }, 'Error after the response was sent');\n if (!res.writableEnded) res.destroy();\n return;\n }\n // isHttpError() covers the common case, but errors can also arrive as plain\n // objects with a numeric statusCode (e.g. thrown across a module boundary, or\n // duck-typed by user code) — fall back to that shape before giving up to 500.\n // Only 4xx: a library's 5xx message can describe internals (hosts, SQL, paths).\n const status = (err as { statusCode?: unknown } | null)?.statusCode;\n const duckTyped =\n err instanceof Error && typeof status === 'number' && status >= 400 && status < 500\n ? (err as Error & { statusCode: number })\n : null;\n\n if (isHttpError(err)) {\n // ModelValidationError carries per-field issues; surface them like route validation does.\n const issues = (err as { issues?: unknown }).issues;\n res.status(err.statusCode).json({\n error: err.message,\n statusCode: err.statusCode,\n ...(issues !== undefined && { issues }),\n });\n } else if (duckTyped) {\n res\n .status(duckTyped.statusCode)\n .json({ error: duckTyped.message, statusCode: duckTyped.statusCode });\n } else {\n getLogger().error({ err }, 'Unhandled error');\n res.status(500).json({ error: 'Internal Server Error', statusCode: 500 });\n }\n },\n );\n}\n"]}