express-file-cluster 0.8.0 → 0.9.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.
Files changed (58) hide show
  1. package/README.md +1 -1
  2. package/dist/auth/index.cjs +3 -3
  3. package/dist/auth/index.d.cts +1 -1
  4. package/dist/auth/index.d.ts +1 -1
  5. package/dist/auth/index.js +2 -2
  6. package/dist/{chunk-ZDM5JHVK.cjs → chunk-2J3HHQKP.cjs} +3 -3
  7. package/dist/{chunk-ZDM5JHVK.cjs.map → chunk-2J3HHQKP.cjs.map} +1 -1
  8. package/dist/{chunk-BUBXO7WU.js → chunk-HXV543HZ.js} +10 -3
  9. package/dist/chunk-HXV543HZ.js.map +1 -0
  10. package/dist/{chunk-OSES7ZQ5.js → chunk-QKQZF573.js} +27 -5
  11. package/dist/chunk-QKQZF573.js.map +1 -0
  12. package/dist/{chunk-B2I7SYQ3.js → chunk-RRQ2RK5M.js} +371 -8
  13. package/dist/chunk-RRQ2RK5M.js.map +1 -0
  14. package/dist/{chunk-TRC4DUZB.js → chunk-RSZB7VAO.js} +2 -2
  15. package/dist/{chunk-FQFKHPLR.cjs → chunk-RTF7PHS2.cjs} +473 -110
  16. package/dist/chunk-RTF7PHS2.cjs.map +1 -0
  17. package/dist/{chunk-MGH4VDV3.cjs → chunk-VQSWSYK6.cjs} +10 -3
  18. package/dist/chunk-VQSWSYK6.cjs.map +1 -0
  19. package/dist/{chunk-75O3WQKR.cjs → chunk-X2US4RAM.cjs} +30 -8
  20. package/dist/chunk-X2US4RAM.cjs.map +1 -0
  21. package/dist/cli/db-runner.cjs +19 -19
  22. package/dist/cli/db-runner.js +3 -3
  23. package/dist/cli/index.cjs +364 -27
  24. package/dist/cli/index.cjs.map +1 -1
  25. package/dist/cli/index.js +344 -7
  26. package/dist/cli/index.js.map +1 -1
  27. package/dist/docs/api-reference/collection.md +155 -0
  28. package/dist/docs/api-reference/ignite.md +19 -0
  29. package/dist/docs/api-reference/table.md +3 -0
  30. package/dist/docs/cli/add.md +36 -7
  31. package/dist/docs/guides/authentication.md +50 -0
  32. package/dist/docs/guides/coming-from-mongoose.md +60 -0
  33. package/dist/docs/guides/database.md +2 -0
  34. package/dist/docs/guides/relations.md +147 -0
  35. package/dist/docs/guides/which-api.md +59 -0
  36. package/dist/docs/index.md +5 -1
  37. package/dist/docs/skills/SKILL.md +3 -3
  38. package/dist/docs/skills/api-surface.md +9 -0
  39. package/dist/docs/skills/what-not-to-invent.md +3 -2
  40. package/dist/index.cjs +21 -19
  41. package/dist/index.cjs.map +1 -1
  42. package/dist/index.d.cts +193 -3
  43. package/dist/index.d.ts +193 -3
  44. package/dist/index.js +8 -6
  45. package/dist/index.js.map +1 -1
  46. package/dist/registry/index.json +1 -1
  47. package/dist/tasks/index.d.cts +1 -1
  48. package/dist/tasks/index.d.ts +1 -1
  49. package/dist/{types-B1tJoI4g.d.cts → types-BY-ObnZH.d.cts} +47 -7
  50. package/dist/{types-B1tJoI4g.d.ts → types-BY-ObnZH.d.ts} +47 -7
  51. package/package.json +1 -1
  52. package/dist/chunk-75O3WQKR.cjs.map +0 -1
  53. package/dist/chunk-B2I7SYQ3.js.map +0 -1
  54. package/dist/chunk-BUBXO7WU.js.map +0 -1
  55. package/dist/chunk-FQFKHPLR.cjs.map +0 -1
  56. package/dist/chunk-MGH4VDV3.cjs.map +0 -1
  57. package/dist/chunk-OSES7ZQ5.js.map +0 -1
  58. /package/dist/{chunk-TRC4DUZB.js.map → chunk-RSZB7VAO.js.map} +0 -0
@@ -35,6 +35,14 @@ function defineModel(name: string, schema: ModelSchema, options?: ModelOptions):
35
35
  type InferRecord<typeof Model> // record incl. id + timestamps per options (defineModel and defineTable)
36
36
  type InferCreate<typeof Model> // create() input: required w/o default/sequence mandatory; dates accept string|number
37
37
  async function transaction<T>(fn: () => Promise<T>): Promise<T> // model calls inside join automatically
38
+ // MongoDB-native (mongoose vocabulary + BSON types); PostgreSQL → [EFC] error at first use
39
+ function defineCollection(name: string, schema: CollectionSchema, options?: CollectionOptions): CollectionModel<S, O>
40
+ // types: + 'decimal128' (string) 'long' (bigint) 'geoPoint' ({ type: 'Point', coordinates: [lng, lat] }) 'binary' (Buffer)
41
+ // index: true | '2dsphere' | 'text' | 'hashed'; options.indexes + partialFilterExpression; options.collation
42
+ // find(filter, { projection, sort, skip, limit, populate, collation }) · findOne · findById · exists · countDocuments · distinct
43
+ // create · insertMany · updateOne/updateMany/replaceOne(f, u, { upsert }) → { matchedCount, modifiedCount, upsertedCount, upsertedId }
44
+ // findOneAndUpdate(f, u, { upsert, returnDocument: 'before' (default) | 'after' }) · findByIdAndUpdate · findOneAndDelete · findByIdAndDelete
45
+ // deleteOne/deleteMany → { deletedCount } · bulkWrite(ops) · aggregate<T>(pipeline) · watch(pipeline) (replica set; for await)
38
46
  // PostgreSQL-native (Prisma vocabulary + SQL types); MongoDB → [EFC] error at first use
39
47
  function defineTable(name: string, schema: TableSchema, options?: TableOptions): TableModel<S, O>
40
48
  // types: + 'integer' (number) 'bigint' (bigint) 'decimal' {precision, scale} (string, exact) 'uuid' 'json'
@@ -91,6 +99,7 @@ interface EFCConfig {
91
99
  dashboard?: boolean; // dev-only route docs at '/'
92
100
  database?: 'mongodb' | 'postgresql'; // default: inferred from databaseUrl scheme
93
101
  databaseUrl?: string;
102
+ databasePool?: { max?: number; idleTimeoutMs?: number; connectionTimeoutMs?: number }; // per worker
94
103
  authStrategy?: 'http-only' | 'localStorage';
95
104
  jwtSecret?: string;
96
105
  jwtExpiresIn?: string; // default '7d'
@@ -36,7 +36,8 @@ defineMiddleware()
36
36
  defineModel() // ← WAIT — this DOES exist, from main path
37
37
  createModel() // ← does NOT exist (it's defineModel, not createModel)
38
38
  defineTable() // ← EXISTS (PostgreSQL-only, Prisma-style) — see api-surface.md
39
- defineCollection() // ← NOT YET — planned (MongoDB-native API, prisma-parity-plan M5)
39
+ defineCollection() // ← EXISTS (MongoDB-only, mongoose vocabulary) — see api-surface.md
40
+ Collection.findMany() / include // ← defineTable vocabulary, NOT on defineCollection
40
41
  Model.findMany() / findUnique() / groupBy() // ← only on defineTable, NOT on defineModel
41
42
  Table.find() / findById() / $gt / $inc // ← defineModel vocabulary, NOT on defineTable
42
43
  Table.findMany({ include }) // ← EXISTS; so do relation filters `{ posts: { some } }` and nested writes `{ connect }` (defineTable only)
@@ -140,7 +141,7 @@ efc remove <item> # NOT IMPLEMENTED — `efc add` copies files; delete them yo
140
141
  efc add <url|@ns/x> # NOT IMPLEMENTED — only the built-in registry (efc list); no third-party registries
141
142
  ```
142
143
 
143
- `efc add | list | view | diff | init` DO exist (the feature registry, `docs/cli/add.md`).
144
+ `efc add | list | view | diff | init` DO exist (the feature registry, `docs/cli/add.md`). Custom auth entities can be scaffolded via `efc add auth --entity <name>`, `efc add auth:<name>`, or `efc add auth new <name>` (e.g. `efc add auth:merchant`).
144
145
  OAuth sign-in exists only as registry items (`efc add auth@google`, `efc add auth@apple`) —
145
146
  app code in `src/api/auth/<provider>/` + `src/lib/oauth`; there is NO framework OAuth API
146
147
  (no `passport`, no `oauth` option on `ignite()`, no other providers).
package/dist/index.cjs CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
 
6
6
 
7
- var _chunkZDM5JHVKcjs = require('./chunk-ZDM5JHVK.cjs');
7
+ var _chunk2J3HHQKPcjs = require('./chunk-2J3HHQKP.cjs');
8
8
 
9
9
 
10
10
  var _chunkR34R7QPDcjs = require('./chunk-R34R7QPD.cjs');
@@ -20,18 +20,19 @@ var _chunkT4OHFU5Tcjs = require('./chunk-T4OHFU5T.cjs');
20
20
 
21
21
 
22
22
 
23
- var _chunkFQFKHPLRcjs = require('./chunk-FQFKHPLR.cjs');
24
23
 
24
+ var _chunkRTF7PHS2cjs = require('./chunk-RTF7PHS2.cjs');
25
25
 
26
26
 
27
27
 
28
28
 
29
29
 
30
- var _chunk75O3WQKRcjs = require('./chunk-75O3WQKR.cjs');
31
30
 
31
+ var _chunkX2US4RAMcjs = require('./chunk-X2US4RAM.cjs');
32
32
 
33
33
 
34
- var _chunkMGH4VDV3cjs = require('./chunk-MGH4VDV3.cjs');
34
+
35
+ var _chunkVQSWSYK6cjs = require('./chunk-VQSWSYK6.cjs');
35
36
 
36
37
 
37
38
 
@@ -868,7 +869,7 @@ function cacheResponse(options) {
868
869
  }
869
870
  const key = RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl);
870
871
  void (async () => {
871
- const hit = await _chunkZDM5JHVKcjs.cache.get(key);
872
+ const hit = await _chunk2J3HHQKPcjs.cache.get(key);
872
873
  if (hit) {
873
874
  res.setHeader("X-Cache", "HIT");
874
875
  res.status(hit.status).json(hit.body);
@@ -877,7 +878,7 @@ function cacheResponse(options) {
877
878
  res.setHeader("X-Cache", "MISS");
878
879
  const json = res.json.bind(res);
879
880
  res.json = (body) => {
880
- if (res.statusCode === 200) void _chunkZDM5JHVKcjs.cache.set(key, { status: 200, body }, { ttl: opts.ttl });
881
+ if (res.statusCode === 200) void _chunk2J3HHQKPcjs.cache.set(key, { status: 200, body }, { ttl: opts.ttl });
881
882
  return json(body);
882
883
  };
883
884
  next();
@@ -952,10 +953,10 @@ async function ignite(config) {
952
953
  const authStrategy = _nullishCoalesce(config.authStrategy, () => ( "http-only"));
953
954
  const clusterEnabled = _nullishCoalesce(config.cluster, () => ( process.env["NODE_ENV"] === "production"));
954
955
  _chunkYL37D6KMcjs.configureLogger.call(void 0, config.logging);
955
- _chunkMGH4VDV3cjs.configureQueryLog.call(void 0, config.logging);
956
+ _chunkVQSWSYK6cjs.configureQueryLog.call(void 0, config.logging);
956
957
  if (clusterEnabled && _cluster2.default.isPrimary) {
957
958
  if (config.cache && config.cache.backend === "memory") {
958
- _chunkZDM5JHVKcjs.servePrimaryCache.call(void 0, _nullishCoalesce(config.cache.maxEntries, () => ( 1e4)));
959
+ _chunk2J3HHQKPcjs.servePrimaryCache.call(void 0, _nullishCoalesce(config.cache.maxEntries, () => ( 1e4)));
959
960
  }
960
961
  runMaster({
961
962
  workers: _nullishCoalesce(workers, () => ( _os2.default.cpus().length)),
@@ -997,20 +998,20 @@ async function ignite(config) {
997
998
  for (const mw of globalMiddlewares) {
998
999
  app.use(mw);
999
1000
  }
1000
- if (database) _chunk75O3WQKRcjs.setDbEngine.call(void 0, database);
1001
- _chunk75O3WQKRcjs.setAutoSync.call(void 0, _nullishCoalesce(config.autoSync, () => ( true)));
1001
+ if (database) _chunkX2US4RAMcjs.setDbEngine.call(void 0, database);
1002
+ _chunkX2US4RAMcjs.setAutoSync.call(void 0, _nullishCoalesce(config.autoSync, () => ( true)));
1002
1003
  if (database === "mongodb" && databaseUrl) {
1003
- const conn = await _chunkFQFKHPLRcjs.connectMongo.call(void 0, databaseUrl);
1004
- _chunkFQFKHPLRcjs.setDbClient.call(void 0, conn);
1004
+ const conn = await _chunkRTF7PHS2cjs.connectMongo.call(void 0, databaseUrl, config.databasePool);
1005
+ _chunkRTF7PHS2cjs.setDbClient.call(void 0, conn);
1005
1006
  } else if (database === "postgresql" && databaseUrl) {
1006
- const pool = await _chunkMGH4VDV3cjs.connectPostgres.call(void 0, databaseUrl);
1007
- _chunkFQFKHPLRcjs.setDbClient.call(void 0, pool);
1007
+ const pool = await _chunkVQSWSYK6cjs.connectPostgres.call(void 0, databaseUrl, config.databasePool);
1008
+ _chunkRTF7PHS2cjs.setDbClient.call(void 0, pool);
1008
1009
  }
1009
1010
  if (config.cache) {
1010
- await _chunkZDM5JHVKcjs.configureCache.call(void 0, config.cache);
1011
+ await _chunk2J3HHQKPcjs.configureCache.call(void 0, config.cache);
1011
1012
  }
1012
1013
  if (jwtSecret) {
1013
- _chunkZDM5JHVKcjs.configureAuth.call(void 0, {
1014
+ _chunk2J3HHQKPcjs.configureAuth.call(void 0, {
1014
1015
  secret: jwtSecret,
1015
1016
  strategy: authStrategy,
1016
1017
  expiresIn: _nullishCoalesce(config.jwtExpiresIn, () => ( "7d")),
@@ -1065,7 +1066,7 @@ async function ignite(config) {
1065
1066
  return;
1066
1067
  }
1067
1068
  const duckTyped = err instanceof Error && typeof err.statusCode === "number" ? err : null;
1068
- if (_chunk75O3WQKRcjs.isHttpError.call(void 0, err)) {
1069
+ if (_chunkX2US4RAMcjs.isHttpError.call(void 0, err)) {
1069
1070
  const issues = err.issues;
1070
1071
  res.status(err.statusCode).json({
1071
1072
  error: err.message,
@@ -1102,7 +1103,7 @@ function gracefulShutdown(server, timeoutMs = 1e4) {
1102
1103
  server.closeIdleConnections();
1103
1104
  server.close(() => {
1104
1105
  _chunkYL37D6KMcjs.getLogger.call(void 0, ).info("Server closed");
1105
- Promise.all([_chunkT4OHFU5Tcjs.closeBullMQ.call(void 0, ), _chunkTYR2GZZEcjs.closePgBoss.call(void 0, ), _chunkZDM5JHVKcjs.closeCache.call(void 0, )]).catch((err) => _chunkYL37D6KMcjs.getLogger.call(void 0, ).error({ err }, "Task backend close failed")).finally(() => process.exit(0));
1106
+ Promise.all([_chunkT4OHFU5Tcjs.closeBullMQ.call(void 0, ), _chunkTYR2GZZEcjs.closePgBoss.call(void 0, ), _chunk2J3HHQKPcjs.closeCache.call(void 0, )]).catch((err) => _chunkYL37D6KMcjs.getLogger.call(void 0, ).error({ err }, "Task backend close failed")).finally(() => process.exit(0));
1106
1107
  });
1107
1108
  setTimeout(() => {
1108
1109
  _chunkYL37D6KMcjs.getLogger.call(void 0, ).error("Forced exit after timeout");
@@ -1139,5 +1140,6 @@ function gracefulShutdown(server, timeoutMs = 1e4) {
1139
1140
 
1140
1141
 
1141
1142
 
1142
- exports.HttpError = _chunk75O3WQKRcjs.HttpError; exports.ModelValidationError = _chunk75O3WQKRcjs.ModelValidationError; exports.cache = _chunkZDM5JHVKcjs.cache; exports.cacheResponse = cacheResponse; exports.compose = compose; exports.db = _chunkFQFKHPLRcjs.db; exports.defineModel = _chunkFQFKHPLRcjs.defineModel; exports.defineTable = _chunkFQFKHPLRcjs.defineTable; exports.getDbClient = _chunkFQFKHPLRcjs.getDbClient; exports.getLogger = _chunkYL37D6KMcjs.getLogger; exports.gracefulShutdown = gracefulShutdown; exports.ignite = ignite; exports.isHttpError = _chunk75O3WQKRcjs.isHttpError; exports.listTasks = _chunkTI24L4XEcjs.listTasks; exports.logger = _chunkYL37D6KMcjs.logger; exports.scanDir = _chunkR34R7QPDcjs.scanDir; exports.setDbClient = _chunkFQFKHPLRcjs.setDbClient; exports.transaction = _chunkFQFKHPLRcjs.transaction; exports.workerCount = workerCount;
1143
+
1144
+ exports.HttpError = _chunkX2US4RAMcjs.HttpError; exports.ModelValidationError = _chunkX2US4RAMcjs.ModelValidationError; exports.cache = _chunk2J3HHQKPcjs.cache; exports.cacheResponse = cacheResponse; exports.compose = compose; exports.db = _chunkRTF7PHS2cjs.db; exports.defineCollection = _chunkRTF7PHS2cjs.defineCollection; exports.defineModel = _chunkRTF7PHS2cjs.defineModel; exports.defineTable = _chunkRTF7PHS2cjs.defineTable; exports.getDbClient = _chunkRTF7PHS2cjs.getDbClient; exports.getLogger = _chunkYL37D6KMcjs.getLogger; exports.gracefulShutdown = gracefulShutdown; exports.ignite = ignite; exports.isHttpError = _chunkX2US4RAMcjs.isHttpError; exports.listTasks = _chunkTI24L4XEcjs.listTasks; exports.logger = _chunkYL37D6KMcjs.logger; exports.scanDir = _chunkR34R7QPDcjs.scanDir; exports.setDbClient = _chunkRTF7PHS2cjs.setDbClient; exports.transaction = _chunkRTF7PHS2cjs.transaction; exports.workerCount = workerCount;
1143
1145
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/index.cjs","../src/index.ts","../src/router/validate.ts","../src/router/mount.ts","../src/cluster/index.ts","../src/tasks/scanner.ts","../src/dashboard.ts","../src/cache/response.ts","../src/compose.ts"],"names":["path"],"mappings":"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AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8PuB,6BAAA;AAA+E;AAAA;AAAA;AAAA,sDAAA;AAIrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBxC,mBAAA;AACiB,sBAAA;AACR,wBAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAAA;AA4RxC;ANyPqD;AACA;AOj0BtB;AASuD;AACZ,EAAA;AAC7C,EAAA;AACkB,IAAA;AAE/B,IAAA;AACM,IAAA;AACY,MAAA;AACW,MAAA;AAEL,MAAA;AACX,MAAA;AACzB,IAAA;AAC4C,IAAA;AAE1B,IAAA;AACuB,MAAA;AAC9B,MAAA;AACuB,QAAA;AACM,QAAA;AACpC,QAAA;AACF,MAAA;AAC+B,MAAA;AACD,MAAA;AACA,MAAA;AACe,QAAA;AAC3B,QAAA;AAClB,MAAA;AACK,MAAA;AACQ,IAAA;AACjB,EAAA;AACF;APwzBqD;AACA;AQ92BkB;AAC1C,EAAA;AACU,IAAA;AACP,MAAA;AACnB,QAAA;AACL,QAAA;AACF,MAAA;AAC0B,MAAA;AACZ,MAAA;AACP,QAAA;AACL,QAAA;AACF,MAAA;AACI,MAAA;AACsC,QAAA;AAC5B,MAAA;AACJ,QAAA;AACV,MAAA;AACF,IAAA;AAEU,IAAA;AACZ,EAAA;AACF;AR+2BqD;AACA;AC11BuB;AACzD,EAAA;AACqB,EAAA;AACC,EAAA;AAChC,EAAA;AACT;AAEkF;AAC1E,EAAA;AACE,IAAA;AACN,IAAA;AACqB,IAAA;AACrB,IAAA;AACA,IAAA;AACA,IAAA;AACE,EAAA;AAKgD,EAAA;AACrB,IAAA;AACmB,MAAA;AACV,MAAA;AACP,MAAA;AACQ,MAAA;AACvC,IAAA;AAC8C,IAAA;AAChD,EAAA;AACyC,EAAA;AACI,EAAA;AACT,EAAA;AAE0B,EAAA;AACxD,IAAA;AACoC,MAAA;AACZ,MAAA;AACqB,MAAA;AACzC,IAAA;AAC4B,MAAA;AACpC,IAAA;AACF,EAAA;AAEiD,EAAA;AACtB,EAAA;AACwB,EAAA;AAC1B,EAAA;AACmB,EAAA;AAGK,EAAA;AAEnB,EAAA;AACE,EAAA;AAES,EAAA;AAEM,IAAA;AACE,MAAA;AAC/C,IAAA;AACU,IAAA;AACsB,MAAA;AACqB,MAAA;AACA,MAAA;AACpD,IAAA;AACD,IAAA;AACF,EAAA;AAEoB,EAAA;AAGhB,EAAA;AAAI,IAAA;AACsB,IAAA;AAC9B,EAAA;AAK8B,EAAA;AACL,IAAA;AACxB,EAAA;AACsB,EAAA;AAEI,EAAA;AACP,IAAA;AACW,IAAA;AACI,MAAA;AACgB,QAAA;AAC1C,MAAA;AACiC,MAAA;AACd,MAAA;AACD,MAAA;AAClB,MAAA;AACN,IAAA;AACH,EAAA;AAEkC,EAAA;AACR,EAAA;AAEY,IAAA;AACG,IAAA;AACjB,IAAA;AACxB,EAAA;AAEsB,EAAA;AACwB,EAAA;AACxB,EAAA;AAEc,EAAA;AACxB,IAAA;AACZ,EAAA;AAGkC,EAAA;AACC,EAAA;AACQ,EAAA;AACE,IAAA;AACW,IAAA;AAChB,EAAA;AACQ,IAAA;AACQ,IAAA;AACxD,EAAA;AAGkB,EAAA;AACiB,IAAA;AACnC,EAAA;AAGe,EAAA;AACC,IAAA;AACJ,MAAA;AACE,MAAA;AACwB,MAAA;AACS,MAAA;AAC5C,IAAA;AACH,EAAA;AAGc,EAAA;AACY,IAAA;AAC1B,EAAA;AAGkB,EAAA;AACuB,IAAA;AACpB,MAAA;AACoB,QAAA;AACM,QAAA;AACZ,QAAA;AACA,QAAA;AAC9B,MAAA;AAC4C,IAAA;AACP,MAAA;AACf,MAAA;AACX,QAAA;AACR,UAAA;AACF,QAAA;AACF,MAAA;AACiB,MAAA;AACf,QAAA;AACyC,QAAA;AACZ,QAAA;AACA,QAAA;AACc,QAAA;AAC5C,MAAA;AACH,IAAA;AACF,EAAA;AAG6B,EAAA;AACI,EAAA;AACkC,EAAA;AACxC,EAAA;AAEmB,EAAA;AAChB,IAAA;AACgB,MAAA;AACZ,MAAA;AACgB,MAAA;AAC/C,IAAA;AACH,EAAA;AAEa,EAAA;AACI,IAAA;AACV,EAAA;AACD,IAAA;AAC2F,MAAA;AAEtE,QAAA;AACO,UAAA;AAC1B,UAAA;AACF,QAAA;AAK0B,QAAA;AAIJ,QAAA;AAEyB,UAAA;AACb,UAAA;AACnB,YAAA;AACK,YAAA;AACqB,YAAA;AACtC,UAAA;AACmB,QAAA;AAGV,UAAA;AACL,QAAA;AACsB,UAAA;AACG,UAAA;AAChC,QAAA;AACF,MAAA;AACF,IAAA;AACF,EAAA;AAEqD,EAAA;AACrB,IAAA;AAEC,IAAA;AACqC,MAAA;AACtC,MAAA;AACE,MAAA;AAChB,MAAA;AACf,IAAA;AAE0B,IAAA;AAC5B,EAAA;AACH;AAE4F;AACvE,EAAA;AACkB,EAAA;AAGjB,IAAA;AACH,IAAA;AACW,IAAA;AACd,IAAA;AACkB,MAAA;AACT,MAAA;AACe,QAAA;AAEW,QAAA;AAG5C,MAAA;AACgB,MAAA;AAC8B,QAAA;AAC/B,QAAA;AACI,MAAA;AACf,IAAA;AACU,MAAA;AAEE,MAAA;AACG,QAAA;AACJ,QAAA;AACY,MAAA;AAC9B,IAAA;AACF,EAAA;AAC+C,EAAA;AACF,EAAA;AAC/C;ADkyBqD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/index.cjs","sourcesContent":[null,"import type http from 'node:http';\nimport fs from 'node:fs';\nimport express from 'express';\nimport cors from 'cors';\nimport cookieParser from 'cookie-parser';\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 { runMaster, shutdownMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { isHttpError } from './errors.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { setDbEngine, setAutoSync } from './db/engine.js';\nimport { connectPostgres } from './db/postgres.js';\nimport { runWithContext } from './context.js';\nimport { configureLogger, getLogger, requestLogger } 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';\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 {\n port: _port,\n workers,\n globalMiddlewares = [],\n onWorkerReady,\n onWorkerCrash,\n onError,\n } = 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 configureQueryLog(config.logging);\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 = express();\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 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(mw);\n }\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 if (database === 'mongodb' && databaseUrl) {\n const conn = await connectMongo(databaseUrl);\n setDbClient(conn as unknown as Record<string, unknown>);\n } else if (database === 'postgresql' && databaseUrl) {\n const pool = await connectPostgres(databaseUrl);\n setDbClient(pool as unknown as Record<string, unknown>);\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 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 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 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 if (onError) {\n app.use(onError);\n } else {\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 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 const duckTyped =\n err instanceof Error && typeof (err as { statusCode?: unknown }).statusCode === 'number'\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\n return new Promise<http.Server>((resolve, reject) => {\n const server = app.listen(port);\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 });\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 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 Promise.all([closeBullMQ(), closePgBoss(), closeCache()])\n .catch((err: unknown) => getLogger().error({ err }, 'Task backend close failed'))\n .finally(() => process.exit(0));\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 { cache } from './cache/index.js';\nexport { cacheResponse } from './cache/response.js';\nexport { compose } from './compose.js';\nexport { db, setDbClient, getDbClient, defineModel, defineTable } from './db/index.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 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","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 type { IRouter, RequestHandler } from 'express';\nimport type { MountedRoute, RouteMeta, RouteEntry, RouteSchema } from '../types.js';\nimport { schemaFor, validateRequest } from './validate.js';\n\nconst HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'] as const;\ntype HttpMethod = (typeof HTTP_METHODS)[number];\n\nfunction asyncWrap(handler: RequestHandler): RequestHandler {\n return (req, res, next) => {\n Promise.resolve(handler(req, res, next)).catch(next);\n };\n}\n\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 const positional = req.params as Record<string, string | undefined>;\n const named: Record<string, unknown> = {};\n route.params.forEach((name, i) => {\n const value = positional[String(i)];\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 implemented: HttpMethod[] = [];\n const unimplemented: HttpMethod[] = [];\n\n for (const method of HTTP_METHODS) {\n if (typeof mod[method] === 'function') {\n implemented.push(method);\n const methodSchema = schemaFor(schema, method);\n const validation = methodSchema ? [validateRequest(methodSchema)] : [];\n app[method.toLowerCase() as Lowercase<HttpMethod>](\n routePath,\n ...paramMapper,\n ...routeMiddlewares,\n ...validation,\n asyncWrap(mod[method] as RequestHandler),\n );\n } else {\n unimplemented.push(method);\n }\n }\n\n if (implemented.length > 0 && unimplemented.length > 0) {\n const allowHeader = implemented.join(', ');\n app.all(routePath, (req, res, next) => {\n if ((unimplemented as string[]).includes(req.method)) {\n res.set('Allow', allowHeader).status(405).json({ error: 'Method Not Allowed' });\n } else {\n next();\n }\n });\n }\n\n mounted.push({ ...route, methods: implemented, ...(meta !== undefined && { meta }) });\n }\n\n return mounted;\n}\n\nexport { asyncWrap };\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.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 { cache } from './index.js';\nimport { getCurrentUser } from '../context.js';\n\nexport interface CacheResponseOptions {\n /** Seconds to keep a response. */\n ttl: number;\n /**\n * Cache per authenticated user (keyed by the JWT's `sub`/`id`). Put `requireAuth`\n * before this middleware. Without it, a response is shared by everyone hitting the URL.\n */\n perUser?: boolean;\n /** Custom cache key. Default: the request's original URL (path + query). */\n key?: (req: Request) => string;\n}\n\ninterface Stored {\n status: number;\n body: unknown;\n}\n\n/** Key prefix for cached responses — `cache.clear(RESPONSE_PREFIX + '/v1/api/posts')` drops those. */\nexport const RESPONSE_PREFIX = 'res:';\n\n/**\n * Caches successful (200) JSON responses of GET/HEAD requests. Adds `X-Cache: HIT|MISS`.\n *\n * @example\n * export const middlewares = [cacheResponse(60)];\n * export const middlewares = [requireAuth, cacheResponse({ ttl: 30, perUser: true })];\n */\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\n let scope = '';\n if (opts.perUser) {\n const user = getCurrentUser();\n const id = user?.['sub'] ?? user?.['id'];\n // Never fall back to a shared entry for a per-user route.\n if (id === undefined) return next();\n scope = `u:${String(id)}:`;\n }\n const key = RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl);\n\n void (async () => {\n const hit = await cache.get<Stored>(key);\n if (hit) {\n res.setHeader('X-Cache', 'HIT');\n res.status(hit.status).json(hit.body);\n return;\n }\n res.setHeader('X-Cache', 'MISS');\n const json = res.json.bind(res);\n res.json = (body: unknown) => {\n if (res.statusCode === 200) void cache.set(key, { status: 200, body }, { ttl: opts.ttl });\n return json(body);\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(handler(req, res, () => dispatch(i + 1))).catch(next);\n } catch (err) {\n next(err);\n }\n }\n\n dispatch(0);\n };\n}\n"]}
1
+ {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/index.cjs","../src/index.ts","../src/router/validate.ts","../src/router/mount.ts","../src/cluster/index.ts","../src/tasks/scanner.ts","../src/dashboard.ts","../src/cache/response.ts","../src/compose.ts"],"names":["path"],"mappings":"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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8PuB,6BAAA;AAA+E;AAAA;AAAA;AAAA,sDAAA;AAIrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBxC,mBAAA;AACiB,sBAAA;AACR,wBAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/index.cjs","sourcesContent":[null,"import type http from 'node:http';\nimport fs from 'node:fs';\nimport express from 'express';\nimport cors from 'cors';\nimport cookieParser from 'cookie-parser';\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 { runMaster, shutdownMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { isHttpError } from './errors.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { setDbEngine, setAutoSync } from './db/engine.js';\nimport { connectPostgres } from './db/postgres.js';\nimport { runWithContext } from './context.js';\nimport { configureLogger, getLogger, requestLogger } 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';\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 {\n port: _port,\n workers,\n globalMiddlewares = [],\n onWorkerReady,\n onWorkerCrash,\n onError,\n } = 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 configureQueryLog(config.logging);\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 = express();\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 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(mw);\n }\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 if (database === 'mongodb' && databaseUrl) {\n const conn = await connectMongo(databaseUrl, config.databasePool);\n setDbClient(conn as unknown as Record<string, unknown>);\n } else if (database === 'postgresql' && databaseUrl) {\n const pool = await connectPostgres(databaseUrl, config.databasePool);\n setDbClient(pool as unknown as Record<string, unknown>);\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 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 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 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 if (onError) {\n app.use(onError);\n } else {\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 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 const duckTyped =\n err instanceof Error && typeof (err as { statusCode?: unknown }).statusCode === 'number'\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\n return new Promise<http.Server>((resolve, reject) => {\n const server = app.listen(port);\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 });\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 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 Promise.all([closeBullMQ(), closePgBoss(), closeCache()])\n .catch((err: unknown) => getLogger().error({ err }, 'Task backend close failed'))\n .finally(() => process.exit(0));\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 { cache } from './cache/index.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 { 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","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 type { IRouter, RequestHandler } from 'express';\nimport type { MountedRoute, RouteMeta, RouteEntry, RouteSchema } from '../types.js';\nimport { schemaFor, validateRequest } from './validate.js';\n\nconst HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'] as const;\ntype HttpMethod = (typeof HTTP_METHODS)[number];\n\nfunction asyncWrap(handler: RequestHandler): RequestHandler {\n return (req, res, next) => {\n Promise.resolve(handler(req, res, next)).catch(next);\n };\n}\n\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 const positional = req.params as Record<string, string | undefined>;\n const named: Record<string, unknown> = {};\n route.params.forEach((name, i) => {\n const value = positional[String(i)];\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 implemented: HttpMethod[] = [];\n const unimplemented: HttpMethod[] = [];\n\n for (const method of HTTP_METHODS) {\n if (typeof mod[method] === 'function') {\n implemented.push(method);\n const methodSchema = schemaFor(schema, method);\n const validation = methodSchema ? [validateRequest(methodSchema)] : [];\n app[method.toLowerCase() as Lowercase<HttpMethod>](\n routePath,\n ...paramMapper,\n ...routeMiddlewares,\n ...validation,\n asyncWrap(mod[method] as RequestHandler),\n );\n } else {\n unimplemented.push(method);\n }\n }\n\n if (implemented.length > 0 && unimplemented.length > 0) {\n const allowHeader = implemented.join(', ');\n app.all(routePath, (req, res, next) => {\n if ((unimplemented as string[]).includes(req.method)) {\n res.set('Allow', allowHeader).status(405).json({ error: 'Method Not Allowed' });\n } else {\n next();\n }\n });\n }\n\n mounted.push({ ...route, methods: implemented, ...(meta !== undefined && { meta }) });\n }\n\n return mounted;\n}\n\nexport { asyncWrap };\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.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 { cache } from './index.js';\nimport { getCurrentUser } from '../context.js';\n\nexport interface CacheResponseOptions {\n /** Seconds to keep a response. */\n ttl: number;\n /**\n * Cache per authenticated user (keyed by the JWT's `sub`/`id`). Put `requireAuth`\n * before this middleware. Without it, a response is shared by everyone hitting the URL.\n */\n perUser?: boolean;\n /** Custom cache key. Default: the request's original URL (path + query). */\n key?: (req: Request) => string;\n}\n\ninterface Stored {\n status: number;\n body: unknown;\n}\n\n/** Key prefix for cached responses — `cache.clear(RESPONSE_PREFIX + '/v1/api/posts')` drops those. */\nexport const RESPONSE_PREFIX = 'res:';\n\n/**\n * Caches successful (200) JSON responses of GET/HEAD requests. Adds `X-Cache: HIT|MISS`.\n *\n * @example\n * export const middlewares = [cacheResponse(60)];\n * export const middlewares = [requireAuth, cacheResponse({ ttl: 30, perUser: true })];\n */\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\n let scope = '';\n if (opts.perUser) {\n const user = getCurrentUser();\n const id = user?.['sub'] ?? user?.['id'];\n // Never fall back to a shared entry for a per-user route.\n if (id === undefined) return next();\n scope = `u:${String(id)}:`;\n }\n const key = RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl);\n\n void (async () => {\n const hit = await cache.get<Stored>(key);\n if (hit) {\n res.setHeader('X-Cache', 'HIT');\n res.status(hit.status).json(hit.body);\n return;\n }\n res.setHeader('X-Cache', 'MISS');\n const json = res.json.bind(res);\n res.json = (body: unknown) => {\n if (res.statusCode === 200) void cache.set(key, { status: 200, body }, { ttl: opts.ttl });\n return json(body);\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(handler(req, res, () => dispatch(i + 1))).catch(next);\n } catch (err) {\n next(err);\n }\n }\n\n dispatch(0);\n };\n}\n"]}