express-file-cluster 0.11.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/dist/auth/index.cjs +8 -7
  2. package/dist/auth/index.cjs.map +1 -1
  3. package/dist/auth/index.d.cts +1 -1
  4. package/dist/auth/index.d.ts +1 -1
  5. package/dist/auth/index.js +7 -5
  6. package/dist/{chunk-JBOMTZT5.js → chunk-3JQWQF2M.js} +3 -3
  7. package/dist/chunk-3ROVNEDR.js +20 -0
  8. package/dist/chunk-3ROVNEDR.js.map +1 -0
  9. package/dist/{chunk-WHBSVYUY.cjs → chunk-4FQP6QX3.cjs} +3 -3
  10. package/dist/{chunk-WHBSVYUY.cjs.map → chunk-4FQP6QX3.cjs.map} +1 -1
  11. package/dist/chunk-546TNO2V.js +226 -0
  12. package/dist/chunk-546TNO2V.js.map +1 -0
  13. package/dist/{chunk-EJDZZ4KX.js → chunk-74R37C4I.js} +48 -21
  14. package/dist/chunk-74R37C4I.js.map +1 -0
  15. package/dist/{chunk-H2PVWCWC.cjs → chunk-A2QGDWCG.cjs} +15 -8
  16. package/dist/chunk-A2QGDWCG.cjs.map +1 -0
  17. package/dist/{chunk-DGYPIIJE.cjs → chunk-AG7PVYPE.cjs} +90 -64
  18. package/dist/chunk-AG7PVYPE.cjs.map +1 -0
  19. package/dist/{chunk-O2E7H2XA.js → chunk-BCSJOPYH.js} +2 -2
  20. package/dist/{chunk-OM2XJJWX.js → chunk-EBJELA7T.js} +30 -25
  21. package/dist/chunk-EBJELA7T.js.map +1 -0
  22. package/dist/{chunk-IEF6AEK3.cjs → chunk-H6MHRHUP.cjs} +104 -50
  23. package/dist/chunk-H6MHRHUP.cjs.map +1 -0
  24. package/dist/chunk-I2IVJURJ.cjs +20 -0
  25. package/dist/chunk-I2IVJURJ.cjs.map +1 -0
  26. package/dist/{chunk-6WTMRZS7.cjs → chunk-IG3V2IOK.cjs} +57 -30
  27. package/dist/chunk-IG3V2IOK.cjs.map +1 -0
  28. package/dist/chunk-JAPZYQVJ.cjs +143 -0
  29. package/dist/chunk-JAPZYQVJ.cjs.map +1 -0
  30. package/dist/{chunk-QSIP7YLW.cjs → chunk-JHCXIYJH.cjs} +25 -48
  31. package/dist/chunk-JHCXIYJH.cjs.map +1 -0
  32. package/dist/{chunk-GWMW6XY7.cjs → chunk-JVB5NLEM.cjs} +15 -13
  33. package/dist/chunk-JVB5NLEM.cjs.map +1 -0
  34. package/dist/chunk-PUM5ZDAH.js +140 -0
  35. package/dist/chunk-PUM5ZDAH.js.map +1 -0
  36. package/dist/{chunk-CGY7JU4Y.cjs → chunk-PUYBKDYD.cjs} +11 -2
  37. package/dist/chunk-PUYBKDYD.cjs.map +1 -0
  38. package/dist/{chunk-336IU55W.js → chunk-QLM3JEER.js} +5 -3
  39. package/dist/{chunk-336IU55W.js.map → chunk-QLM3JEER.js.map} +1 -1
  40. package/dist/{chunk-SOU3PBJC.cjs → chunk-SV4C4HWP.cjs} +89 -89
  41. package/dist/{chunk-SOU3PBJC.cjs.map → chunk-SV4C4HWP.cjs.map} +1 -1
  42. package/dist/{chunk-2IDRC7RK.js → chunk-UJ2ISRLP.js} +11 -34
  43. package/dist/chunk-UJ2ISRLP.js.map +1 -0
  44. package/dist/chunk-URKE3OXN.cjs +226 -0
  45. package/dist/chunk-URKE3OXN.cjs.map +1 -0
  46. package/dist/{chunk-DTMDJGRW.cjs → chunk-VLGN3XUM.cjs} +40 -35
  47. package/dist/chunk-VLGN3XUM.cjs.map +1 -0
  48. package/dist/{chunk-R6GPQZLI.js → chunk-X2B7WBKH.js} +88 -34
  49. package/dist/chunk-X2B7WBKH.js.map +1 -0
  50. package/dist/chunk-Y7I2633P.js +12 -0
  51. package/dist/chunk-Y7I2633P.js.map +1 -0
  52. package/dist/{chunk-B6MB6HEG.js → chunk-ZBQUYFI3.js} +14 -7
  53. package/dist/chunk-ZBQUYFI3.js.map +1 -0
  54. package/dist/{chunk-LECHRAU3.js → chunk-ZU2GK5WY.js} +84 -58
  55. package/dist/chunk-ZU2GK5WY.js.map +1 -0
  56. package/dist/cli/db-runner.cjs +26 -25
  57. package/dist/cli/db-runner.cjs.map +1 -1
  58. package/dist/cli/db-runner.js +5 -3
  59. package/dist/cli/db-runner.js.map +1 -1
  60. package/dist/cli/index.cjs +20 -16
  61. package/dist/cli/index.cjs.map +1 -1
  62. package/dist/cli/index.js +13 -8
  63. package/dist/cli/index.js.map +1 -1
  64. package/dist/docs/api-reference/auth.md +2 -0
  65. package/dist/docs/api-reference/ignite.md +4 -0
  66. package/dist/docs/api-reference/tasks.md +6 -2
  67. package/dist/docs/api-reference/testing.md +2 -0
  68. package/dist/docs/api-reference/tracing.md +18 -0
  69. package/dist/docs/cli/add.md +1 -1
  70. package/dist/docs/cli/diagnostics.md +1 -1
  71. package/dist/docs/cli/index.md +1 -1
  72. package/dist/docs/core-concepts/background-tasks.md +7 -1
  73. package/dist/docs/core-concepts/file-based-routing.md +4 -0
  74. package/dist/docs/core-concepts/middleware.md +2 -0
  75. package/dist/docs/guides/caching.md +12 -0
  76. package/dist/docs/guides/error-handling.md +2 -0
  77. package/dist/docs/guides/feature-matrix.md +7 -0
  78. package/dist/docs/guides/logging.md +2 -0
  79. package/dist/docs/guides/tracing.md +64 -0
  80. package/dist/docs/index.md +2 -1
  81. package/dist/docs/skills/SKILL.md +5 -3
  82. package/dist/docs/skills/api-surface.md +8 -0
  83. package/dist/docs/skills/auth-internals.md +4 -2
  84. package/dist/docs/skills/pre-flight.md +4 -0
  85. package/dist/docs/skills/routing-rules.md +3 -1
  86. package/dist/docs/skills/tasks-internals.md +12 -4
  87. package/dist/docs/skills/what-not-to-invent.md +2 -0
  88. package/dist/index.cjs +167 -71
  89. package/dist/index.cjs.map +1 -1
  90. package/dist/index.d.cts +5 -14
  91. package/dist/index.d.ts +5 -14
  92. package/dist/index.js +124 -27
  93. package/dist/index.js.map +1 -1
  94. package/dist/pgboss-backend-5DXF4G22.js +16 -0
  95. package/dist/pgboss-backend-KRTFHRNZ.cjs +16 -0
  96. package/dist/pgboss-backend-KRTFHRNZ.cjs.map +1 -0
  97. package/dist/registry/index.json +1 -1
  98. package/dist/tasks/index.cjs +3 -3
  99. package/dist/tasks/index.d.cts +2 -2
  100. package/dist/tasks/index.d.ts +2 -2
  101. package/dist/tasks/index.js +2 -1
  102. package/dist/testing.cjs +16 -14
  103. package/dist/testing.cjs.map +1 -1
  104. package/dist/testing.d.cts +2 -1
  105. package/dist/testing.d.ts +2 -1
  106. package/dist/testing.js +10 -7
  107. package/dist/testing.js.map +1 -1
  108. package/dist/thread-runner.cjs +5 -4
  109. package/dist/thread-runner.cjs.map +1 -1
  110. package/dist/thread-runner.d.cts +1 -1
  111. package/dist/thread-runner.d.ts +1 -1
  112. package/dist/thread-runner.js +4 -2
  113. package/dist/{types-D3QmZgeX.d.ts → types-Bgeqpm-n.d.cts} +12 -1
  114. package/dist/{types-D3QmZgeX.d.cts → types-Bgeqpm-n.d.ts} +12 -1
  115. package/package.json +7 -3
  116. package/dist/chunk-2IDRC7RK.js.map +0 -1
  117. package/dist/chunk-3SWI46YK.js +0 -74
  118. package/dist/chunk-3SWI46YK.js.map +0 -1
  119. package/dist/chunk-6WTMRZS7.cjs.map +0 -1
  120. package/dist/chunk-B6MB6HEG.js.map +0 -1
  121. package/dist/chunk-CGY7JU4Y.cjs.map +0 -1
  122. package/dist/chunk-DGYPIIJE.cjs.map +0 -1
  123. package/dist/chunk-DTMDJGRW.cjs.map +0 -1
  124. package/dist/chunk-EJDZZ4KX.js.map +0 -1
  125. package/dist/chunk-GWMW6XY7.cjs.map +0 -1
  126. package/dist/chunk-H2PVWCWC.cjs.map +0 -1
  127. package/dist/chunk-IEF6AEK3.cjs.map +0 -1
  128. package/dist/chunk-LECHRAU3.js.map +0 -1
  129. package/dist/chunk-OM2XJJWX.js.map +0 -1
  130. package/dist/chunk-QSIP7YLW.cjs.map +0 -1
  131. package/dist/chunk-R6GPQZLI.js.map +0 -1
  132. package/dist/chunk-RPL2IFWK.cjs +0 -77
  133. package/dist/chunk-RPL2IFWK.cjs.map +0 -1
  134. package/dist/pgboss-backend-PQW6I3VF.js +0 -14
  135. package/dist/pgboss-backend-QVXISTLP.cjs +0 -15
  136. package/dist/pgboss-backend-QVXISTLP.cjs.map +0 -1
  137. /package/dist/{chunk-JBOMTZT5.js.map → chunk-3JQWQF2M.js.map} +0 -0
  138. /package/dist/{chunk-O2E7H2XA.js.map → chunk-BCSJOPYH.js.map} +0 -0
  139. /package/dist/{pgboss-backend-PQW6I3VF.js.map → pgboss-backend-5DXF4G22.js.map} +0 -0
package/dist/index.js CHANGED
@@ -6,7 +6,7 @@ import {
6
6
  mountErrorHandler,
7
7
  mountOpenAPI,
8
8
  mountRoutes
9
- } from "./chunk-LECHRAU3.js";
9
+ } from "./chunk-ZU2GK5WY.js";
10
10
  import {
11
11
  cache,
12
12
  closeCache,
@@ -15,14 +15,17 @@ import {
15
15
  isCacheConfigured,
16
16
  rawIncr,
17
17
  servePrimaryCache
18
- } from "./chunk-R6GPQZLI.js";
18
+ } from "./chunk-X2B7WBKH.js";
19
+ import {
20
+ listTaskFiles
21
+ } from "./chunk-3ROVNEDR.js";
19
22
  import {
20
23
  scanDir
21
- } from "./chunk-O2E7H2XA.js";
24
+ } from "./chunk-BCSJOPYH.js";
22
25
  import {
23
26
  closeBullMQ,
24
27
  initBullMQ
25
- } from "./chunk-OM2XJJWX.js";
28
+ } from "./chunk-EBJELA7T.js";
26
29
  import {
27
30
  connectMongo,
28
31
  db,
@@ -32,12 +35,12 @@ import {
32
35
  getDbClient,
33
36
  setDbClient,
34
37
  transaction
35
- } from "./chunk-JBOMTZT5.js";
38
+ } from "./chunk-3JQWQF2M.js";
36
39
  import {
37
40
  ModelValidationError,
38
41
  setAutoSync,
39
42
  setDbEngine
40
- } from "./chunk-336IU55W.js";
43
+ } from "./chunk-QLM3JEER.js";
41
44
  import {
42
45
  HttpError,
43
46
  isHttpError
@@ -45,23 +48,46 @@ import {
45
48
  import {
46
49
  closePgBoss,
47
50
  initPgBoss
48
- } from "./chunk-EJDZZ4KX.js";
49
- import "./chunk-3SWI46YK.js";
51
+ } from "./chunk-74R37C4I.js";
52
+ import "./chunk-PUM5ZDAH.js";
50
53
  import {
51
54
  listTasks,
52
55
  registerTask
53
- } from "./chunk-B6MB6HEG.js";
56
+ } from "./chunk-ZBQUYFI3.js";
54
57
  import {
55
58
  checkConnectionBudget,
56
59
  configureLogger,
57
60
  configureQueryLog,
58
61
  connectPostgres,
59
- getCurrentUser,
60
62
  getLogger,
61
63
  getQueryMetrics,
62
64
  logger,
63
65
  resetQueryMetrics
64
- } from "./chunk-2IDRC7RK.js";
66
+ } from "./chunk-UJ2ISRLP.js";
67
+ import {
68
+ configureTracing,
69
+ getCurrentUser,
70
+ shutdownTracing
71
+ } from "./chunk-546TNO2V.js";
72
+ import "./chunk-Y7I2633P.js";
73
+
74
+ // src/shutdown.ts
75
+ async function drainServices(options) {
76
+ const errors = [];
77
+ const outcomes = await Promise.allSettled([
78
+ ...options.transports,
79
+ ...options.tasks.map((close) => Promise.resolve().then(close))
80
+ ]);
81
+ for (const outcome of outcomes) if (outcome.status === "rejected") errors.push(outcome.reason);
82
+ for (const close of [options.cache, options.tracing]) {
83
+ try {
84
+ await close();
85
+ } catch (error) {
86
+ errors.push(error);
87
+ }
88
+ }
89
+ if (errors.length) throw new AggregateError(errors, "Service shutdown failed");
90
+ }
65
91
 
66
92
  // src/index.ts
67
93
  import http from "http";
@@ -115,7 +141,7 @@ import fs from "fs";
115
141
  import path from "path";
116
142
  async function scanTasks(tasksDir) {
117
143
  if (!fs.existsSync(tasksDir)) return;
118
- const files = fs.readdirSync(tasksDir).filter((f) => /\.(ts|js|mts|mjs)$/.test(f));
144
+ const files = listTaskFiles(tasksDir);
119
145
  for (const file of files) {
120
146
  const filePath = path.join(tasksDir, file);
121
147
  const taskName = path.basename(file, path.extname(file));
@@ -735,18 +761,19 @@ function generateDashboard(routes, basePath, port, projectName, projectVersion)
735
761
  // src/rate-limit.ts
736
762
  var UNITS = { s: 1, m: 60, h: 3600, d: 86400 };
737
763
  function parseWindow(window) {
738
- if (typeof window === "number") {
739
- if (window > 0) return window;
740
- } else {
741
- const m = /^(\d+(?:\.\d+)?)\s*(s|m|h|d)$/.exec(window.trim());
742
- if (m) return Number(m[1]) * UNITS[m[2]];
764
+ let seconds = typeof window === "number" ? window : NaN;
765
+ if (typeof window === "string") {
766
+ const match = /^(\d+(?:\.\d+)?)\s*(s|m|h|d)$/.exec(window.trim());
767
+ if (match) seconds = Number(match[1]) * UNITS[match[2]];
743
768
  }
769
+ if (Number.isFinite(seconds) && seconds * 1e3 >= 1 && seconds * 1e3 <= Number.MAX_SAFE_INTEGER)
770
+ return seconds;
744
771
  throw new Error(`[EFC] rateLimit: window must be seconds or like '15m' \u2014 got ${String(window)}`);
745
772
  }
746
773
  var lastCacheError = 0;
747
774
  function rateLimit(options) {
748
775
  const windowSeconds = parseWindow(options.window);
749
- if (!Number.isInteger(options.max) || options.max < 1) {
776
+ if (!Number.isSafeInteger(options.max) || options.max < 1) {
750
777
  throw new Error("[EFC] rateLimit: max must be a positive integer");
751
778
  }
752
779
  const keyOf = options.key ?? ((req) => req.ip ?? req.socket.remoteAddress);
@@ -766,7 +793,10 @@ function rateLimit(options) {
766
793
  const resetMs = (slot + 1) * windowMs - now;
767
794
  let count;
768
795
  try {
769
- count = (await rawIncr(`rl:${bucket}:${who}:${slot}`, Math.ceil(resetMs / 1e3) + 1)).value;
796
+ count = (await rawIncr(
797
+ `rl:${JSON.stringify([String(bucket), who, slot])}`,
798
+ Math.ceil(resetMs / 1e3) + 1
799
+ )).value;
770
800
  } catch (err) {
771
801
  if (Date.now() - lastCacheError > 3e4) {
772
802
  lastCacheError = Date.now();
@@ -798,7 +828,18 @@ function rateLimit(options) {
798
828
  }
799
829
 
800
830
  // src/cache/response.ts
831
+ import { createHash } from "crypto";
801
832
  var RESPONSE_PREFIX = "res:";
833
+ var representationHeaders = [
834
+ "content-type",
835
+ "cache-control",
836
+ "vary",
837
+ "content-language",
838
+ "content-disposition",
839
+ "etag",
840
+ "last-modified"
841
+ ];
842
+ var variant = (req, names) => createHash("sha256").update(JSON.stringify(names.map((name) => [name, req.get(name) ?? null]))).digest("hex");
802
843
  function cacheResponse(options) {
803
844
  const opts = typeof options === "number" ? { ttl: options } : options;
804
845
  return (req, res, next) => {
@@ -807,23 +848,65 @@ function cacheResponse(options) {
807
848
  if (opts.perUser) {
808
849
  const user = getCurrentUser();
809
850
  const id = user?.["sub"] ?? user?.["id"];
810
- if (id === void 0) return next();
811
- scope = `u:${String(id)}:`;
851
+ if (typeof id !== "string" && (typeof id !== "number" || !Number.isFinite(id))) return next();
852
+ scope = `u:${JSON.stringify([id])}:`;
812
853
  }
813
- const key = RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl);
854
+ const key = RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl) + "\0" + req.method;
814
855
  void (async () => {
815
856
  const hit = await cache.get(key);
816
- if (hit) {
857
+ if (hit && typeof hit.json === "string" && Array.isArray(hit.vary) && hit.variant === variant(req, hit.vary)) {
858
+ res.set(hit.headers);
817
859
  res.setHeader("X-Cache", "HIT");
818
- res.status(hit.status).json(hit.body);
860
+ res.status(hit.status).send(hit.json);
819
861
  return;
820
862
  }
821
863
  res.setHeader("X-Cache", "MISS");
864
+ let captured = false;
865
+ let snapshot = "";
822
866
  const json = res.json.bind(res);
823
867
  res.json = (body) => {
824
- if (res.statusCode === 200) void cache.set(key, { status: 200, body }, { ttl: opts.ttl });
825
- return json(body);
868
+ const send = res.send;
869
+ const eligible = !res.headersSent && res.statusCode === 200;
870
+ res.send = (rendered) => {
871
+ if (eligible && typeof rendered === "string") {
872
+ try {
873
+ JSON.parse(rendered);
874
+ snapshot = rendered;
875
+ captured = true;
876
+ } catch {
877
+ }
878
+ }
879
+ return send.call(res, rendered);
880
+ };
881
+ try {
882
+ return json(body);
883
+ } finally {
884
+ res.send = send;
885
+ }
826
886
  };
887
+ res.once("finish", () => {
888
+ if (!captured || res.statusCode !== 200 || res.getHeader("set-cookie") !== void 0)
889
+ return;
890
+ const control = String(res.getHeader("cache-control") ?? "");
891
+ if (/(?:^|,)\s*(?:no-store|no-cache)(?:\s|,|=|$)/i.test(control) || !opts.perUser && /(?:^|,)\s*private(?:\s|,|=|$)/i.test(control))
892
+ return;
893
+ const vary = String(res.getHeader("vary") ?? "").split(",").map((name) => name.trim().toLowerCase()).filter(Boolean);
894
+ if (vary.includes("*")) return;
895
+ const headers = {};
896
+ for (const name of representationHeaders) {
897
+ const value = res.getHeader(name);
898
+ if (value !== void 0)
899
+ headers[name] = Array.isArray(value) ? value.join(", ") : String(value);
900
+ }
901
+ const stored = {
902
+ status: 200,
903
+ json: snapshot,
904
+ headers,
905
+ vary,
906
+ variant: variant(req, vary)
907
+ };
908
+ void cache.set(key, stored, { ttl: opts.ttl }).catch((error) => getLogger().debug({ err: error }, "Response cache write failed"));
909
+ });
827
910
  next();
828
911
  })().catch(next);
829
912
  };
@@ -902,6 +985,7 @@ async function ignite(config) {
902
985
  );
903
986
  }
904
987
  configureQueryLog(config.logging);
988
+ configureTracing(config.tracing);
905
989
  if (clusterEnabled && cluster2.isPrimary) {
906
990
  if (config.cache && config.cache.backend === "memory") {
907
991
  servePrimaryCache(config.cache.maxEntries ?? 1e4);
@@ -954,6 +1038,7 @@ async function ignite(config) {
954
1038
  if (config.tasks) {
955
1039
  if (config.tasks.backend === "bullmq") {
956
1040
  await initBullMQ({
1041
+ tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),
957
1042
  redisUrl: config.tasks.redisUrl ?? "redis://localhost:6379",
958
1043
  concurrency: config.tasks.concurrency ?? 5,
959
1044
  enqueueTimeout: config.tasks.enqueueTimeout ?? 5e3,
@@ -967,6 +1052,7 @@ async function ignite(config) {
967
1052
  );
968
1053
  }
969
1054
  await initPgBoss({
1055
+ tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),
970
1056
  connectionString,
971
1057
  concurrency: config.tasks.concurrency ?? 5,
972
1058
  enqueueTimeout: config.tasks.enqueueTimeout ?? 5e3,
@@ -1021,7 +1107,18 @@ function gracefulShutdown(server, timeoutMs = 1e4) {
1021
1107
  server.closeIdleConnections();
1022
1108
  server.close(() => {
1023
1109
  getLogger().info("Server closed");
1024
- Promise.all([websocketDrain, closeBullMQ(), closePgBoss(), closeCache()]).catch((err) => getLogger().error({ err }, "Task backend close failed")).finally(() => process.exit(0));
1110
+ drainServices({
1111
+ transports: [websocketDrain],
1112
+ tasks: [closeBullMQ, closePgBoss],
1113
+ cache: closeCache,
1114
+ tracing: shutdownTracing
1115
+ }).then(
1116
+ () => process.exit(0),
1117
+ (err) => {
1118
+ getLogger().error({ err }, "Service shutdown failed");
1119
+ process.exit(1);
1120
+ }
1121
+ );
1025
1122
  });
1026
1123
  setTimeout(() => {
1027
1124
  getLogger().error("Forced exit after timeout");
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/cluster/index.ts","../src/tasks/scanner.ts","../src/dashboard.ts","../src/rate-limit.ts","../src/cache/response.ts","../src/compose.ts"],"sourcesContent":["import http from 'node:http';\nimport fs from 'node:fs';\nimport express from 'express';\nimport cluster from 'node:cluster';\nimport os from 'node:os';\nimport path from 'node:path';\nimport type { EFCConfig, MountedRoute } from './types.js';\nexport type {\n TableModel,\n TableRecord,\n TableCreateInput,\n TableWhere,\n TableWhereUnique,\n TableUpdateData,\n TableCreateData,\n TableUpdateInput,\n TableOrderBy,\n TableSelect,\n TableInclude,\n TableResult,\n Tables,\n TableFindManyArgs,\n TableAggregateArgs,\n TableGroupByArgs,\n TableAggregateResult,\n ScalarFilter,\n StringFilter,\n ListFilter,\n JsonFilter,\n InferTableRecord,\n} from './table-types.js';\nimport { scanDir } from './router/scan.js';\nimport { mountRoutes } from './router/mount.js';\nimport { mountOpenAPI } from './openapi.js';\nimport { attachWebSockets, closeWebSockets } from './websocket.js';\nimport { runMaster, shutdownMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { setDbEngine, setAutoSync } from './db/engine.js';\nimport { checkConnectionBudget, connectPostgres } from './db/postgres.js';\nimport { configureLogger, getLogger } from './logger.js';\nimport { configureQueryLog } from './db/query-log.js';\nimport { scanTasks } from './tasks/scanner.js';\nimport { initBullMQ, closeBullMQ } from './tasks/bullmq-backend.js';\nimport { initPgBoss, closePgBoss } from './tasks/pgboss-backend.js';\nimport { configureCache, closeCache } from './cache/index.js';\nimport { servePrimaryCache } from './cache/ipc.js';\nimport { generateDashboard } from './dashboard.js';\nimport { createHttpApp, mountErrorHandler } from './http-app.js';\n\nfunction detectDatabase(url?: string): 'mongodb' | 'postgresql' | undefined {\n if (!url) return undefined;\n if (url.startsWith('mongodb')) return 'mongodb';\n if (url.startsWith('postgres')) return 'postgresql';\n return undefined;\n}\n\nexport async function ignite(config: EFCConfig): Promise<http.Server | undefined> {\n const { port: _port, workers, onWorkerReady, onWorkerCrash, onError } = config;\n\n // Resolve api/tasks dirs from convention. argv[1]-based resolution is unreliable in tsx watch\n // + cluster workers (argv[1] can point to the tsx binary instead of the user's script), so we\n // probe multiple candidates and use the first that exists on disk.\n function resolveConventionDir(name: string): string {\n const candidates: string[] = [\n ...(process.argv[1] ? [path.join(path.dirname(process.argv[1]), name)] : []),\n path.join(process.cwd(), 'src', name),\n path.join(process.cwd(), name),\n path.join(process.cwd(), 'dist', name),\n ];\n return candidates.find((c) => fs.existsSync(c)) ?? candidates[0]!;\n }\n const apiDir = resolveConventionDir('api');\n const tasksDir = resolveConventionDir('tasks');\n const basePath = config.basePath ?? '/v1/api';\n\n function readProjectMeta(): { name: string; version: string } {\n try {\n const raw = fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8');\n const pkg = JSON.parse(raw) as { name?: string; version?: string };\n return { name: pkg.name ?? 'API', version: pkg.version ?? '' };\n } catch {\n return { name: 'API', version: '' };\n }\n }\n\n const port = _port != null && !Number.isNaN(_port) ? _port : 3000;\n const databaseUrl = config.databaseUrl;\n const database = config.database ?? detectDatabase(databaseUrl);\n const jwtSecret = config.jwtSecret;\n const authStrategy = config.authStrategy ?? 'http-only';\n // NODE_ENV is a Node/Express-wide runtime-mode signal set by the platform, not an app\n // secret — unlike PORT/DATABASE_URL/JWT_SECRET/etc. this one is still read directly.\n const clusterEnabled = config.cluster ?? process.env['NODE_ENV'] === 'production';\n\n configureLogger(config.logging);\n // Any value but 'http-only' acts as bearer, as it always has — an app may rely on that, so\n // 0.9.x only warns (a typo of 'http-only' silently means no cookie). 1.0 makes it an error.\n if (\n !['http-only', 'bearer', 'localStorage'].includes(authStrategy) &&\n (!clusterEnabled || cluster.isPrimary) // once, not once per worker\n ) {\n getLogger().warn(\n `[EFC] Unknown authStrategy \"${String(authStrategy)}\" — treated as 'bearer'. Use 'http-only' or 'bearer'; this will be an error in 1.0.`,\n );\n }\n // HS256 with a short secret can be brute-forced offline from any token a user holds.\n if (\n jwtSecret &&\n Buffer.byteLength(jwtSecret) < 32 &&\n process.env['NODE_ENV'] === 'production' &&\n (!clusterEnabled || cluster.isPrimary)\n ) {\n getLogger().warn(\n `[EFC] jwtSecret is ${Buffer.byteLength(jwtSecret)} bytes — use at least 32 random bytes in production (openssl rand -hex 64).`,\n );\n }\n configureQueryLog(config.logging);\n\n if (clusterEnabled && cluster.isPrimary) {\n // The memory cache lives in the primary so all workers share it (cache/ipc.ts).\n if (config.cache && config.cache.backend === 'memory') {\n servePrimaryCache(config.cache.maxEntries ?? 10_000);\n }\n runMaster({\n workers: workers ?? os.cpus().length,\n ...(onWorkerReady !== undefined && { onWorkerReady }),\n ...(onWorkerCrash !== undefined && { onWorkerCrash }),\n });\n return;\n }\n\n const app = createHttpApp(config);\n\n // Pre-Flight step 1: Connect database. The engine decides what defineModel compiles to.\n if (database) setDbEngine(database);\n setAutoSync(config.autoSync ?? true);\n // Pools are per worker; one process per machine reports the machine's total.\n const poolWorkers = clusterEnabled ? (workers ?? os.cpus().length) : 1;\n const reportsPools = !clusterEnabled || cluster.worker?.id === 1;\n if (database === 'mongodb' && databaseUrl) {\n const conn = await connectMongo(databaseUrl, config.databasePool);\n setDbClient(conn as unknown as Record<string, unknown>);\n if (reportsPools) {\n const max = config.databasePool?.max ?? 100; // mongoose's maxPoolSize default\n getLogger().info(\n `MongoDB connections: up to ${poolWorkers * max} from this machine (${poolWorkers} worker(s) × maxPoolSize ${max})`,\n );\n }\n } else if (database === 'postgresql' && databaseUrl) {\n const pool = await connectPostgres(databaseUrl, config.databasePool);\n setDbClient(pool as unknown as Record<string, unknown>);\n if (reportsPools) {\n const max = config.databasePool?.max ?? 10; // node-postgres' default\n // pg-boss on the same database opens its own pool (node-postgres default 10).\n const boss =\n config.tasks && config.tasks.backend === 'pg-boss' && !config.tasks.connectionString\n ? 10\n : 0;\n const breakdown = `${poolWorkers} worker(s) × (pool ${max}${boss ? ` + pg-boss ${boss}` : ''})`;\n await checkConnectionBudget(poolWorkers * (max + boss), breakdown);\n }\n }\n\n // Pre-Flight step 1b: Cache (also the session-revocation store requireAuth consults)\n if (config.cache) {\n await configureCache(config.cache);\n }\n\n // Pre-Flight step 2: Configure auth\n if (jwtSecret) {\n configureAuth({\n secret: jwtSecret,\n strategy: authStrategy,\n expiresIn: config.jwtExpiresIn ?? '7d',\n ...(config.cookieDomain !== undefined && { cookieDomain: config.cookieDomain }),\n });\n }\n\n // Pre-Flight step 3: Scan and register tasks\n if (tasksDir) {\n await scanTasks(tasksDir);\n }\n\n // Pre-Flight step 4: Start task queue backend\n if (config.tasks) {\n if (config.tasks.backend === 'bullmq') {\n await initBullMQ({\n 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 if (config.openapi) {\n const meta = readProjectMeta();\n const options = config.openapi === true ? {} : config.openapi;\n await mountOpenAPI(app, mounted, {\n info: { title: meta.name, version: meta.version },\n ...options,\n basePath,\n });\n }\n app.use(basePath, apiRouter);\n\n if (config.dashboard !== false && process.env['NODE_ENV'] === 'development') {\n app.get('/', (_req, res) => {\n const { name, version } = readProjectMeta();\n res.setHeader('Content-Type', 'text/html; charset=utf-8');\n res.send(generateDashboard(mounted, basePath, port, name, version));\n });\n }\n\n mountErrorHandler(app, onError);\n\n return new Promise<http.Server>((resolve, reject) => {\n const server = http.createServer(app);\n if (config.websocket !== false && mounted.some((route) => route.websocket))\n attachWebSockets(server, app, config.websocket);\n\n server.once('listening', () => {\n const wid = (cluster.worker as { id: number } | undefined)?.id ?? 'primary';\n const addr = server.address() as { port: number } | null;\n getLogger().info(`Worker ${wid} listening on :${addr?.port ?? port}`);\n resolve(server);\n });\n\n server.once('error', reject);\n server.listen(port);\n });\n}\n\nexport function gracefulShutdown(server: http.Server | undefined, timeoutMs = 10_000): void {\n let shuttingDown = false;\n const shutdown = (signal: string) => {\n // A worker can get the signal twice (process-group Ctrl+C plus the primary's\n // forward); the default handler for a repeat would kill it mid-drain.\n if (shuttingDown) return;\n shuttingDown = true;\n getLogger().info(`${signal} received — closing server gracefully…`);\n if (server) {\n const websocketDrain = closeWebSockets(server, Math.max(1, Math.min(1000, timeoutMs / 2)));\n server.closeIdleConnections();\n server.close(() => {\n getLogger().info('Server closed');\n // Let in-flight task jobs finish before exiting; the timeout below still caps it.\n Promise.all([websocketDrain, 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 { getQueryMetrics, resetQueryMetrics } from './db/query-log.js';\nexport type { QueryMetric, QueryMetricsSnapshot } from './db/query-log.js';\nexport { cache } from './cache/index.js';\nexport { rateLimit } from './rate-limit.js';\nexport type { RateLimitOptions } from './rate-limit.js';\nexport { cacheResponse } from './cache/response.js';\nexport { compose } from './compose.js';\nexport {\n db,\n setDbClient,\n getDbClient,\n defineModel,\n defineTable,\n defineCollection,\n} from './db/index.js';\nexport type {\n CollectionModel,\n CollectionOptions,\n CollectionFilter,\n CollectionUpdate,\n CollectionFindOptions,\n CollectionWriteResult,\n CollectionBulkResult,\n CollectionBulkOp,\n CollectionChange,\n CollectionChangeStream,\n} from './db/collection-model.js';\nexport type {\n Pipeline,\n FieldRef,\n Accumulator,\n GroupResult,\n LookedUp,\n LookupTarget,\n} from './db/pipeline.js';\nexport { transaction } from './db/transaction.js';\nexport { ModelValidationError } from './db/schema.js';\nexport { scanDir } from './router/scan.js';\nexport { listTasks } from './tasks/index.js';\nexport { workerCount } from './cluster/index.js';\nexport type {\n EFCConfig,\n DatabasePoolConfig,\n CollectionSchema,\n CollectionFieldDefinition,\n GeoPoint,\n CorsConfig,\n RouteEntry,\n RouteMeta,\n RouteMethodMeta,\n RouteSchema,\n LoggingConfig,\n QueryLogConfig,\n CacheConfig,\n RequestSchema,\n Validator,\n ValidationIssue,\n TaskOptions,\n TaskDefinition,\n DatabaseEngine,\n AuthStrategy,\n ModelSchema,\n TableSchema,\n TableSchemaField,\n TableFieldDefinition,\n TableOptions,\n TableRelation,\n MigrationContext,\n SchemaField,\n Filter,\n FilterOperators,\n Update,\n FindOptions,\n IndexDefinition,\n ModelRecord,\n InferRecord,\n InferCreate,\n InferSchema,\n InferCreateInput,\n ScalarKeys,\n SortDirection,\n ModelCRUD,\n ModelQueryOptions,\n ModelOptions,\n FieldDefinition,\n DefaultOperator,\n} from './types.js';\n\nexport { generateOpenAPI } from './openapi.js';\nexport type { OpenAPIOptions, OpenAPIDocument, JSONSchema } from './openapi.js';\nexport { attachWebSockets, closeWebSockets } from './websocket.js';\nexport type { WebSocketHandler, WebSocketOptions } from './websocket.js';\n","import cluster from 'node:cluster';\nimport { getLogger } from '../logger.js';\n\ninterface ClusterOptions {\n workers?: number;\n onWorkerReady?: ((id: number) => void) | undefined;\n onWorkerCrash?: ((id: number, code: number) => void) | undefined;\n}\n\nlet isShuttingDown = false;\n\n/**\n * Returns the number of currently alive (not yet exited) cluster workers.\n * Returns `0` when running in single-process mode.\n */\nexport function workerCount(): number {\n return Object.keys(cluster.workers ?? {}).length;\n}\n\nexport function shutdownMaster(): void {\n isShuttingDown = true;\n getLogger().info(`Cluster primary (pid=${process.pid}) shutting down, waiting for workers…`);\n if (workerCount() === 0) process.exit(0);\n // Orchestrators (docker stop, k8s) signal only PID 1 — the primary — so forward the\n // signal; each worker's gracefulShutdown drains its server and exits on its own.\n for (const worker of Object.values(cluster.workers ?? {})) {\n worker?.process.kill('SIGTERM');\n }\n}\n\nexport function runMaster(options: ClusterOptions = {}): void {\n const count = options.workers ?? 1;\n\n getLogger().info(`Primary ${process.pid} starting ${count} workers`);\n\n for (let i = 0; i < count; i++) {\n cluster.fork();\n }\n\n cluster.on('online', (worker) => {\n options.onWorkerReady?.(worker.id);\n });\n\n cluster.on('exit', (worker, code, signal) => {\n const exitCode = code ?? (signal ? -1 : 0);\n if (isShuttingDown) {\n getLogger().info(`Worker ${worker.id} gracefully exited`);\n if (workerCount() === 0) {\n getLogger().info('All workers exited. Primary exiting.');\n process.exit(0);\n }\n return;\n }\n\n getLogger().warn(`Worker ${worker.id} exited (code=${exitCode}), respawning…`);\n options.onWorkerCrash?.(worker.id, exitCode);\n cluster.fork();\n });\n}\n\nexport { cluster };\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { registerTask } from './index.js';\nimport { getLogger } from '../logger.js';\nimport type { TaskDefinition } from '../types.js';\n\nexport async function scanTasks(tasksDir: string): Promise<void> {\n if (!fs.existsSync(tasksDir)) return;\n\n const files = fs.readdirSync(tasksDir).filter((f) => /\\.(ts|js|mts|mjs)$/.test(f));\n\n for (const file of files) {\n const filePath = path.join(tasksDir, file);\n const taskName = path.basename(file, path.extname(file));\n\n try {\n const mod = (await import(filePath)) as Record<string, unknown>;\n const def = mod['default'] as TaskDefinition | undefined;\n\n if (!def || typeof def.handler !== 'function') {\n getLogger().warn(`Task file ${file} has no valid default export — skipping`);\n continue;\n }\n\n registerTask(taskName, { ...def, filePath });\n getLogger().debug(`Registered task: ${taskName}`);\n } catch (err) {\n getLogger().warn({ err }, `Failed to load task ${file}`);\n }\n }\n}\n","import type { MountedRoute } from './types.js';\n\nconst HTTP_STATUS: Record<number, string> = {\n 200: 'OK',\n 201: 'Created',\n 202: 'Accepted',\n 204: 'No Content',\n 400: 'Bad Request',\n 401: 'Unauthorized',\n 403: 'Forbidden',\n 404: 'Not Found',\n 405: 'Method Not Allowed',\n 409: 'Conflict',\n 422: 'Unprocessable Entity',\n 500: 'Internal Server Error',\n 503: 'Service Unavailable',\n};\n\nexport function generateDashboard(\n routes: MountedRoute[],\n basePath: string,\n port: number,\n projectName: string,\n projectVersion: string,\n): string {\n const safeRoutes = JSON.stringify(\n routes.map((r) => ({\n urlPath: r.urlPath,\n methods: r.websocket ? [...r.methods, 'WS'] : r.methods,\n params: r.params,\n meta: r.meta ?? null,\n })),\n ).replace(/<\\/script>/gi, '<\\\\/script>');\n const safeHttpStatus = JSON.stringify(HTTP_STATUS);\n\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>${projectName} — API Reference</title>\n <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n <link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin />\n <link href=\"https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap\" rel=\"stylesheet\" />\n <style>\n *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\n :root {\n --bg: #080b0f;\n --bg-card: #0d1117;\n --bg-raised: #111820;\n --border: #1e2832;\n --border-lit: #263040;\n --text: #e2e8f0;\n --text-dim: #64748b;\n --text-muted: #334155;\n --accent: #F0A030;\n --accent-dim: rgba(240,160,48,.12);\n --accent-glow: rgba(240,160,48,.22);\n --purple: #a78bfa;\n --blue: #60a5fa;\n --orange: #fb923c;\n --green: #7AAE8E;\n --radius: 10px;\n --radius-lg: 16px;\n --font-mono: 'JetBrains Mono', monospace;\n --font-sans: 'Inter', sans-serif;\n }\n html { scroll-behavior: smooth; }\n body {\n background: var(--bg); color: var(--text);\n font-family: var(--font-sans); font-size: 16px;\n line-height: 1.6; -webkit-font-smoothing: antialiased;\n position: relative;\n }\n body::before {\n content: ''; position: fixed; inset: 0; z-index: 0;\n background-image:\n linear-gradient(var(--border) 1px, transparent 1px),\n linear-gradient(90deg, var(--border) 1px, transparent 1px);\n background-size: 60px 60px; opacity: .28; pointer-events: none;\n }\n section, footer, .page-hero, .docs-layout { position: relative; z-index: 1; }\n a { text-decoration: none; color: inherit; }\n em { font-style: italic; }\n code {\n font-family: var(--font-mono); font-size: .85em;\n background: var(--bg-raised); border: 1px solid var(--border);\n border-radius: 4px; padding: 1px 6px; color: var(--accent);\n }\n .container { max-width: 1140px; margin: 0 auto; padding: 0 24px; }\n ::-webkit-scrollbar { width: 6px; }\n ::-webkit-scrollbar-track { background: var(--bg); }\n ::-webkit-scrollbar-thumb { background: var(--border-lit); border-radius: 3px; }\n\n /* ── PAGE HERO ── */\n .page-hero {\n padding: 48px 0 56px; border-bottom: 1px solid var(--border);\n }\n .page-hero .hero-glow {\n position: absolute; top: -40px; left: 10%; width: 500px; height: 350px;\n background: radial-gradient(ellipse, rgba(240,160,48,.1) 0%, transparent 68%);\n pointer-events: none;\n }\n .page-title {\n font-size: clamp(2rem, 5vw, 3.4rem); font-weight: 800;\n line-height: 1.1; letter-spacing: -.02em; margin-bottom: 24px;\n display: flex; align-items: baseline; gap: 16px; flex-wrap: wrap;\n }\n .project-version {\n font-family: var(--font-mono); font-size: clamp(.85rem, 2vw, 1.1rem);\n font-weight: 500; color: var(--accent);\n background: var(--accent-dim); border: 1px solid rgba(240,160,48,.3);\n border-radius: 6px; padding: 2px 10px; letter-spacing: .5px;\n }\n .hero-meta { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; margin-bottom: 40px; }\n .base-url-pill {\n display: flex; align-items: center; gap: 8px;\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: 7px; padding: 8px 14px;\n }\n .base-url-label { font-size: .72rem; font-family: var(--font-mono);\n color: var(--text-muted); text-transform: uppercase; letter-spacing: .5px; }\n .base-url-val { font-family: var(--font-mono); font-size: .8rem; color: var(--accent); }\n .count-pill {\n font-family: var(--font-mono); font-size: .72rem; color: var(--text-dim);\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: 7px; padding: 8px 14px;\n }\n\n /* ── TOOLBAR ── */\n .toolbar {\n display: flex; align-items: center; gap: 12px; flex-wrap: wrap;\n }\n .method-filters { display: flex; gap: 4px; flex-wrap: wrap; }\n .filter-btn {\n background: var(--bg-card); border: 1px solid var(--border);\n color: var(--text-dim); font-family: var(--font-mono);\n font-size: .72rem; font-weight: 600; letter-spacing: .5px;\n padding: 6px 12px; border-radius: 6px; cursor: pointer;\n transition: all .15s;\n }\n .filter-btn:hover { border-color: var(--border-lit); color: var(--text); }\n .filter-btn.active { background: var(--accent); color: #0d0d1a; border-color: var(--accent); }\n .filter-btn[data-method=\"GET\"].active { background: rgba(96,165,250,.18); color: #60a5fa; border-color: rgba(96,165,250,.4); }\n .filter-btn[data-method=\"POST\"].active { background: rgba(122,174,142,.18); color: #7AAE8E; border-color: rgba(122,174,142,.4); }\n .filter-btn[data-method=\"PUT\"].active { background: rgba(240,160,48,.18); color: #F0A030; border-color: rgba(240,160,48,.4); }\n .filter-btn[data-method=\"PATCH\"].active { background: rgba(251,191,36,.18); color: #fbbf24; border-color: rgba(251,191,36,.4); }\n .filter-btn[data-method=\"DELETE\"].active { background: rgba(248,113,113,.18); color: #f87171; border-color: rgba(248,113,113,.4); }\n .filter-btn[data-method=\"HEAD\"].active { background: rgba(167,139,250,.18); color: #a78bfa; border-color: rgba(167,139,250,.4); }\n .search-wrap { margin-left: auto; }\n .search-input {\n background: var(--bg-card); border: 1px solid var(--border);\n color: var(--text); font-family: var(--font-sans); font-size: .85rem;\n padding: 7px 14px; border-radius: 7px; width: 240px;\n outline: none; transition: border-color .2s;\n }\n .search-input::placeholder { color: var(--text-muted); }\n .search-input:focus { border-color: var(--border-lit); }\n\n /* ── DOCS LAYOUT ── */\n .docs-layout {\n display: grid; grid-template-columns: 260px 1fr;\n gap: 48px; padding: 52px 0 80px; max-width: 1140px;\n margin: 0 auto; padding-left: 24px; padding-right: 24px;\n align-items: start;\n }\n\n /* ── SIDEBAR ── */\n .docs-sidebar {\n position: sticky; top: 24px;\n max-height: calc(100vh - 48px);\n overflow-y: auto;\n overflow-x: hidden;\n scrollbar-width: none;\n padding-right: 4px;\n }\n .docs-sidebar::-webkit-scrollbar { display: none; }\n .sidebar-section { margin-bottom: 28px; }\n .sidebar-label {\n font-family: var(--font-mono); font-size: .68rem; font-weight: 600;\n color: var(--text-muted); letter-spacing: 1.2px; text-transform: uppercase;\n margin-bottom: 8px; padding: 0 4px;\n }\n .sidebar-link {\n display: flex; align-items: center; gap: 8px;\n padding: 7px 10px; border-radius: 6px;\n border-left: 2px solid transparent;\n font-size: .82rem; color: var(--text-dim); cursor: pointer;\n transition: background .15s, color .15s, border-color .15s;\n overflow: hidden; white-space: nowrap;\n }\n .sidebar-link:hover { background: var(--bg-raised); color: var(--text); }\n .sidebar-link.active { color: var(--accent); border-left-color: var(--accent); background: var(--accent-dim); }\n .sidebar-method-dot {\n width: 6px; height: 6px; border-radius: 50%; flex-shrink: 0;\n }\n .sidebar-path { font-family: var(--font-mono); font-size: .72rem; }\n\n /* ── ENDPOINT CARDS ── */\n .endpoint-card {\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: var(--radius-lg); margin-bottom: 20px;\n overflow: hidden; transition: border-color .2s;\n animation: fadeUp .45s ease both;\n }\n .endpoint-card:hover { border-color: var(--border-lit); }\n @keyframes fadeUp {\n from { opacity: 0; transform: translateY(16px); }\n to { opacity: 1; transform: translateY(0); }\n }\n @media (prefers-reduced-motion: reduce) {\n .endpoint-card { animation: none; }\n }\n .endpoint-header {\n display: flex; align-items: center; gap: 14px;\n padding: 20px 24px 18px; border-bottom: 1px solid var(--border);\n flex-wrap: wrap;\n }\n .method-badges { display: flex; gap: 6px; flex-wrap: wrap; }\n .method-badge {\n font-family: var(--font-mono); font-size: .7rem; font-weight: 600;\n letter-spacing: .8px; padding: 4px 10px; border-radius: 5px;\n border: 1px solid; text-transform: uppercase;\n }\n .endpoint-path {\n font-family: var(--font-mono); font-size: .9rem; color: var(--text);\n background: none; border: none; padding: 0;\n word-break: break-all;\n }\n .endpoint-body { padding: 6px 24px 24px; }\n .endpoint-desc { font-size: .9rem; color: var(--text-dim); line-height: 1.7; margin-bottom: 20px; }\n\n /* ── PER-METHOD DOC BLOCKS ── */\n .method-block { padding-top: 20px; }\n .method-block + .method-block { margin-top: 4px; border-top: 1px solid var(--border); }\n .method-block-header { display: flex; align-items: center; gap: 10px; margin-bottom: 12px; }\n .method-block-header .method-badge { font-size: .68rem; }\n .method-block-empty { font-size: .82rem; color: var(--text-muted); }\n\n /* ── CODE BLOCKS ── */\n .example-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }\n .code-block-wrap {\n background: var(--bg-raised); border: 1px solid var(--border);\n border-radius: var(--radius); overflow: hidden;\n }\n .code-bar {\n display: flex; align-items: center; gap: 6px;\n padding: 9px 14px; border-bottom: 1px solid var(--border);\n background: var(--bg-card);\n }\n .dot { width: 11px; height: 11px; border-radius: 50%; }\n .dot-r { background: #ff5f57; }\n .dot-y { background: #febc2e; }\n .dot-g { background: #28c840; }\n .code-label { font-family: var(--font-mono); font-size: .68rem; color: var(--text-dim); margin-left: 4px; }\n pre.code-pre {\n font-family: var(--font-mono); font-size: .78rem; line-height: 1.7;\n padding: 16px 18px; overflow-x: auto; tab-size: 2; white-space: pre;\n }\n .c-dim { color: var(--text-muted); }\n .c-green { color: #7AAE8E; }\n .c-blue { color: #60a5fa; }\n .c-orange { color: #fb923c; }\n .c-purple { color: #a78bfa; }\n .c-accent { color: var(--accent); }\n .status-2xx { color: #7AAE8E; }\n .status-4xx { color: #f87171; }\n .status-5xx { color: #fb923c; }\n\n /* ── EMPTY STATE ── */\n .empty-state {\n text-align: center; padding: 80px 24px;\n color: var(--text-muted); font-size: .9rem;\n }\n\n /* ── RESPONSIVE ── */\n @media (max-width: 900px) {\n .docs-layout { grid-template-columns: 1fr; }\n .docs-sidebar { position: static; max-height: none; overflow-y: visible; padding-right: 0; }\n .example-grid { grid-template-columns: 1fr; }\n .search-wrap { margin-left: 0; width: 100%; }\n .search-input { width: 100%; }\n }\n @media (max-width: 600px) {\n .page-hero { padding: 32px 0 32px; }\n .page-title { font-size: 2rem; }\n }\n </style>\n</head>\n<body>\n\n <div class=\"page-hero\">\n <div class=\"hero-glow\"></div>\n <div class=\"container\">\n <h1 class=\"page-title\">${projectName}${projectVersion ? `<span class=\"project-version\">v${projectVersion}</span>` : ''}</h1>\n <div class=\"hero-meta\">\n <div class=\"base-url-pill\">\n <span class=\"base-url-label\">Base</span>\n <span class=\"base-url-val\">http://localhost:${port}${basePath}</span>\n </div>\n <div class=\"count-pill\" id=\"countPill\"></div>\n </div>\n <div class=\"toolbar\">\n <div class=\"method-filters\" id=\"methodFilters\">\n <button class=\"filter-btn active\" data-method=\"ALL\">ALL</button>\n </div>\n <div class=\"search-wrap\">\n <input type=\"text\" id=\"searchInput\" class=\"search-input\" placeholder=\"Search endpoints…\" />\n </div>\n </div>\n </div>\n </div>\n\n <div class=\"docs-layout\">\n <aside class=\"docs-sidebar\" id=\"sidebar\"></aside>\n <main id=\"endpoints\"></main>\n </div>\n\n <script>\n const ROUTES = ${safeRoutes};\n const BASE_PATH = ${JSON.stringify(basePath)};\n const HTTP_STATUS = ${safeHttpStatus};\n\n const METHOD_STYLE = {\n GET: { bg: 'rgba(96,165,250,.14)', color: '#60a5fa', border: 'rgba(96,165,250,.35)' },\n POST: { bg: 'rgba(122,174,142,.14)', color: '#7AAE8E', border: 'rgba(122,174,142,.35)' },\n PUT: { bg: 'rgba(240,160,48,.14)', color: '#F0A030', border: 'rgba(240,160,48,.35)' },\n PATCH: { bg: 'rgba(251,191,36,.14)', color: '#fbbf24', border: 'rgba(251,191,36,.35)' },\n DELETE: { bg: 'rgba(248,113,113,.14)', color: '#f87171', border: 'rgba(248,113,113,.35)' },\n HEAD: { bg: 'rgba(167,139,250,.14)', color: '#a78bfa', border: 'rgba(167,139,250,.35)' },\n OPTIONS: { bg: 'rgba(148,163,184,.14)', color: '#94a3b8', border: 'rgba(148,163,184,.35)' },\n };\n\n function esc(s) {\n return String(s)\n .replace(/&/g,'&amp;').replace(/</g,'&lt;')\n .replace(/>/g,'&gt;').replace(/\"/g,'&quot;');\n }\n\n function methodBadge(m) {\n const s = METHOD_STYLE[m] || METHOD_STYLE.GET;\n return '<span class=\"method-badge\" style=\"background:' + s.bg + ';color:' + s.color + ';border-color:' + s.border + '\">' + m + '</span>';\n }\n\n function joinPath(base, p) {\n return (base.replace(/\\\\/+$/, '') + p) || '/';\n }\n\n function sidebarDot(method) {\n const s = METHOD_STYLE[method] || METHOD_STYLE.GET;\n return '<span class=\"sidebar-method-dot\" style=\"background:' + s.color + '\"></span>';\n }\n\n function statusClass(code) {\n if (code >= 200 && code < 300) return 'status-2xx';\n if (code >= 400 && code < 500) return 'status-4xx';\n if (code >= 500) return 'status-5xx';\n return '';\n }\n\n function renderSchema(val, indent) {\n const pad = ' '.repeat(indent || 0);\n if (val === null) return '<span class=\"c-dim\">null</span>';\n if (typeof val === 'string') {\n const isDate = /^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}/.test(val);\n return isDate ? '<span class=\"c-green\">Date</span>' : '<span class=\"c-purple\">String</span>';\n }\n if (typeof val === 'number') return '<span class=\"c-orange\">Number</span>';\n if (typeof val === 'boolean') return '<span class=\"c-purple\">Boolean</span>';\n if (Array.isArray(val)) {\n if (!val.length) return '[]';\n return '[\\\\n' + pad + ' ' + renderSchema(val[0], (indent || 0) + 1) + '\\\\n' + pad + ']';\n }\n if (typeof val === 'object') {\n const keys = Object.keys(val);\n if (!keys.length) return '{}';\n const inner = keys.map(function(k) {\n return pad + ' <span class=\"c-blue\">&quot;' + esc(k) + '&quot;</span>: ' + renderSchema(val[k], (indent || 0) + 1);\n }).join(',\\\\n');\n return '{\\\\n' + inner + '\\\\n' + pad + '}';\n }\n return esc(String(val));\n }\n\n function codeBlock(label, content) {\n return '<div class=\"code-block-wrap\">' +\n '<div class=\"code-bar\">' +\n '<span class=\"dot dot-r\"></span>' +\n '<span class=\"dot dot-y\"></span>' +\n '<span class=\"dot dot-g\"></span>' +\n '<span class=\"code-label\">' + esc(label) + '</span>' +\n '</div>' +\n '<pre class=\"code-pre\">' + content + '</pre>' +\n '</div>';\n }\n\n function buildRequestContent(route, method, example) {\n const req = example || {};\n let path = joinPath(BASE_PATH, route.urlPath);\n if (req.params) {\n for (const [k, v] of Object.entries(req.params)) {\n path = path.replace(':' + k, String(v));\n }\n }\n if (req.query && Object.keys(req.query).length) {\n path += '?' + new URLSearchParams(req.query).toString();\n }\n let lines = '<span class=\"c-accent\">' + esc(method) + '</span> <span class=\"c-blue\">' + esc(path) + '</span>';\n const headers = { ...(req.headers || {}) };\n if (req.body !== undefined && !headers['Content-Type']) {\n headers['Content-Type'] = 'application/json';\n }\n if (Object.keys(headers).length) {\n lines += '\\\\n' + Object.entries(headers)\n .map(([k, v]) => '<span class=\"c-dim\">' + esc(k) + ':</span> ' + esc(String(v)))\n .join('\\\\n');\n }\n if (req.body !== undefined) {\n lines += '\\\\n\\\\n' + renderSchema(req.body, 0);\n }\n return lines;\n }\n\n function buildResponseContent(example) {\n const resp = example || {};\n const code = resp.status || 200;\n const text = HTTP_STATUS[code] || 'OK';\n const cls = statusClass(code);\n let lines = 'HTTP/1.1 <span class=\"' + cls + '\">' + code + ' ' + esc(text) + '</span>';\n if (resp.body !== undefined) {\n lines += '\\\\n<span class=\"c-dim\">Content-Type:</span> application/json\\\\n\\\\n';\n lines += renderSchema(resp.body, 0);\n }\n return lines;\n }\n\n function renderMethodBlock(route, method) {\n const methodMeta = route.meta ? route.meta[method] : null;\n const header = '<div class=\"method-block-header\">' + methodBadge(method) + '</div>';\n\n if (!methodMeta) {\n return '<div class=\"method-block\" data-method=\"' + esc(method) + '\">' + header +\n '<p class=\"method-block-empty\">No documentation provided for this method.</p></div>';\n }\n\n const desc = methodMeta.description\n ? '<p class=\"endpoint-desc\">' + esc(methodMeta.description) + '</p>'\n : '';\n const reqHtml = methodMeta.request !== undefined\n ? codeBlock('request', buildRequestContent(route, method, methodMeta.request))\n : '';\n const respHtml = methodMeta.response !== undefined\n ? codeBlock('response', buildResponseContent(methodMeta.response))\n : '';\n const examples = reqHtml || respHtml\n ? '<div class=\"example-grid\">' + reqHtml + respHtml + '</div>'\n : '';\n\n return '<div class=\"method-block\" data-method=\"' + esc(method) + '\">' + header + desc + examples + '</div>';\n }\n\n function renderCard(route, index) {\n const id = 'ep-' + index;\n const fullPath = joinPath(BASE_PATH, route.urlPath);\n const badges = route.methods.map(methodBadge).join('');\n const body = route.methods.map(function(m) { return renderMethodBlock(route, m); }).join('');\n const delay = (index * 0.06).toFixed(2) + 's';\n return '<div class=\"endpoint-card\" id=\"' + id + '\" data-methods=\"' + route.methods.join(',') + '\" data-path=\"' + esc(fullPath) + '\" style=\"animation-delay:' + delay + '\">' +\n '<div class=\"endpoint-header\">' +\n '<div class=\"method-badges\">' + badges + '</div>' +\n '<code class=\"endpoint-path\">' + esc(fullPath) + '</code>' +\n '</div>' +\n '<div class=\"endpoint-body\">' + body + '</div>' +\n '</div>';\n }\n\n function buildMethodFilters() {\n const allMethods = [...new Set(ROUTES.flatMap(r => r.methods))].sort();\n const filtersEl = document.getElementById('methodFilters');\n allMethods.forEach(m => {\n const btn = document.createElement('button');\n btn.className = 'filter-btn';\n btn.dataset.method = m;\n btn.textContent = m;\n filtersEl.appendChild(btn);\n });\n }\n\n function buildSidebar(routes) {\n const sidebar = document.getElementById('sidebar');\n if (!routes.length) { sidebar.innerHTML = ''; return; }\n\n const label = document.createElement('div');\n label.className = 'sidebar-label';\n label.textContent = 'Endpoints';\n sidebar.appendChild(label);\n\n routes.forEach((route, i) => {\n const link = document.createElement('div');\n link.className = 'sidebar-link';\n link.dataset.target = 'ep-' + ROUTES.indexOf(route);\n link.innerHTML = sidebarDot(route.methods[0] || 'GET') +\n '<span class=\"sidebar-path\">' + esc(route.urlPath || '/') + '</span>';\n link.addEventListener('click', () => {\n const target = document.getElementById(link.dataset.target);\n if (target) target.scrollIntoView({ behavior: 'smooth', block: 'start' });\n });\n sidebar.appendChild(link);\n });\n }\n\n let activeFilter = 'ALL';\n let searchQuery = '';\n\n function applyFilters() {\n const cards = document.querySelectorAll('.endpoint-card');\n let visible = 0;\n cards.forEach(card => {\n const methods = card.dataset.methods.split(',');\n const path = card.dataset.path || '';\n const matchMethod = activeFilter === 'ALL' || methods.includes(activeFilter);\n const matchSearch = !searchQuery || path.toLowerCase().includes(searchQuery);\n const show = matchMethod && matchSearch;\n card.style.display = show ? '' : 'none';\n if (show) visible++;\n });\n document.getElementById('empty-state').style.display = visible ? 'none' : 'block';\n\n // Sync sidebar visibility\n document.querySelectorAll('.sidebar-link').forEach(link => {\n const targetId = link.dataset.target;\n const targetCard = document.getElementById(targetId);\n link.style.display = targetCard && targetCard.style.display !== 'none' ? '' : 'none';\n });\n }\n\n function init() {\n const count = ROUTES.length;\n document.getElementById('countPill').textContent = count + ' endpoint' + (count !== 1 ? 's' : '');\n\n buildMethodFilters();\n\n const container = document.getElementById('endpoints');\n container.innerHTML = ROUTES.map((r, i) => renderCard(r, i)).join('');\n\n // Add empty state after cards\n const emptyEl = document.createElement('div');\n emptyEl.id = 'empty-state';\n emptyEl.className = 'empty-state';\n emptyEl.style.display = 'none';\n emptyEl.innerHTML = '<p>No endpoints match your filter.</p>';\n container.after(emptyEl);\n\n buildSidebar(ROUTES);\n\n // Method filter clicks\n document.getElementById('methodFilters').addEventListener('click', e => {\n const btn = e.target.closest('.filter-btn');\n if (!btn) return;\n document.querySelectorAll('.filter-btn').forEach(b => b.classList.remove('active'));\n btn.classList.add('active');\n activeFilter = btn.dataset.method;\n applyFilters();\n });\n\n // Search\n document.getElementById('searchInput').addEventListener('input', e => {\n searchQuery = e.target.value.trim().toLowerCase();\n applyFilters();\n });\n\n // Scroll spy for sidebar\n const cardEls = document.querySelectorAll('.endpoint-card');\n const sidebarLinks = document.querySelectorAll('.sidebar-link');\n const observer = new IntersectionObserver(entries => {\n entries.forEach(entry => {\n if (entry.isIntersecting) {\n const id = entry.target.id;\n sidebarLinks.forEach(l => l.classList.toggle('active', l.dataset.target === id));\n const sidebar = document.getElementById('sidebar');\n const activeLink = sidebar && sidebar.querySelector('.sidebar-link.active');\n if (sidebar && activeLink) {\n const linkTop = activeLink.getBoundingClientRect().top - sidebar.getBoundingClientRect().top + sidebar.scrollTop;\n sidebar.scrollTo({ top: linkTop, behavior: 'smooth' });\n }\n }\n });\n }, { rootMargin: '-80px 0px -60% 0px' });\n cardEls.forEach(el => observer.observe(el));\n\n }\n\n try {\n init();\n } catch (e) {\n document.body.insertAdjacentHTML('afterbegin',\n '<div style=\"position:fixed;top:60px;left:0;right:0;z-index:9999;background:#7f1d1d;color:#fca5a5;padding:16px 24px;font-family:monospace;font-size:13px;border-bottom:1px solid #ef4444\">' +\n '<strong>Dashboard JS error:</strong> ' + (e && e.message ? e.message : String(e)) +\n (e && e.stack ? '<pre style=\"margin-top:8px;white-space:pre-wrap\">' + e.stack + '</pre>' : '') +\n '</div>'\n );\n }\n </script>\n</body>\n</html>`;\n}\n","import type { Request, RequestHandler } from 'express';\nimport { isCacheConfigured, rawIncr } from './cache/index.js';\nimport { getLogger } from './logger.js';\n\n// rateLimit(): a fixed-window limit (windows aligned to the clock) counted in the cache\n// (`cache.incr`), so every worker — and with Redis every instance — shares one count. An\n// in-memory counter per worker would let N workers accept N × max.\n\nexport interface RateLimitOptions {\n /** Window length: seconds, or `'30s'`, `'15m'`, `'1h'`, `'1d'`. */\n window: number | string;\n /** Requests allowed per window and key. */\n max: number;\n /**\n * Who a request counts against. Default: the client IP (`req.ip`) — behind a proxy or load\n * balancer set `trustProxy` in ignite(), or every client shares the proxy's IP. Return\n * `undefined` to not limit this request.\n */\n key?: (req: Request) => string | undefined;\n /**\n * Which counter: requests to routes with the same name share a limit. Default: the route\n * pattern (`/users/:id`), so each route file has its own — or the path, for middleware\n * that isn't on a route.\n */\n name?: string;\n /** Body of the 429 response. Default: `'Too many requests, try again later'`. */\n message?: string;\n /**\n * The cache can't be reached: `'allow'` (default) lets requests through — a limiter\n * shouldn't take the API down with it; `'reject'` answers 503.\n */\n onCacheError?: 'allow' | 'reject';\n /** Send `RateLimit-Limit/Remaining/Reset` (and `Retry-After` on 429). Default: true. */\n headers?: boolean;\n}\n\nconst UNITS: Record<string, number> = { s: 1, m: 60, h: 3600, d: 86_400 };\n\nexport function parseWindow(window: number | string): number {\n if (typeof window === 'number') {\n if (window > 0) return window;\n } else {\n const m = /^(\\d+(?:\\.\\d+)?)\\s*(s|m|h|d)$/.exec(window.trim());\n if (m) return Number(m[1]) * UNITS[m[2]!]!;\n }\n throw new Error(`[EFC] rateLimit: window must be seconds or like '15m' — got ${String(window)}`);\n}\n\nlet lastCacheError = 0;\n\n/**\n * Limits requests per key (default: client IP) to `max` per `window`, counted in the cache\n * so the limit holds across every worker and instance:\n *\n * ```ts\n * export const middlewares = [rateLimit({ window: '15m', max: 10 })];\n * ```\n *\n * Needs `cache` in ignite() — use the Redis backend when you run more than one instance.\n */\nexport function rateLimit(options: RateLimitOptions): RequestHandler {\n const windowSeconds = parseWindow(options.window);\n if (!Number.isInteger(options.max) || options.max < 1) {\n throw new Error('[EFC] rateLimit: max must be a positive integer');\n }\n const keyOf = options.key ?? ((req: Request) => req.ip ?? req.socket.remoteAddress);\n const message = options.message ?? 'Too many requests, try again later';\n const headers = options.headers ?? true;\n\n return (req, res, next) => {\n void (async () => {\n const who = keyOf(req);\n if (who === undefined) return next();\n if (!isCacheConfigured()) {\n throw new Error('[EFC] rateLimit needs a cache — pass cache: { backend } to ignite()');\n }\n const bucket = options.name ?? req.baseUrl + (req.route?.path ?? req.path);\n // Windows are aligned to the clock: every key restarts at the same boundary, and the\n // reset is exact. The key outlives its window by a second, then expires.\n const windowMs = windowSeconds * 1000;\n const now = Date.now();\n const slot = Math.floor(now / windowMs);\n const resetMs = (slot + 1) * windowMs - now;\n let count: number;\n try {\n count = (await rawIncr(`rl:${bucket}:${who}:${slot}`, Math.ceil(resetMs / 1000) + 1)).value;\n } catch (err) {\n if (Date.now() - lastCacheError > 30_000) {\n lastCacheError = Date.now();\n getLogger().error(\n { err },\n `rateLimit: cache unavailable — ${options.onCacheError === 'reject' ? 'rejecting with 503' : 'allowing requests'}`,\n );\n }\n if (options.onCacheError === 'reject') {\n res.status(503).json({ error: 'Service Unavailable', statusCode: 503 });\n return;\n }\n return next();\n }\n const resetSeconds = Math.max(1, Math.ceil(resetMs / 1000));\n if (headers) {\n res.setHeader('RateLimit-Limit', String(options.max));\n res.setHeader('RateLimit-Remaining', String(Math.max(0, options.max - count)));\n res.setHeader('RateLimit-Reset', String(resetSeconds));\n }\n if (count > options.max) {\n if (headers) res.setHeader('Retry-After', String(resetSeconds));\n res.status(429).json({ error: message, statusCode: 429 });\n return;\n }\n next();\n })().catch(next);\n };\n}\n","import 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(\n handler(req, res, (err?: unknown) => (err ? next(err) : dispatch(i + 1))),\n ).catch(next);\n } catch (err) {\n next(err);\n }\n }\n\n dispatch(0);\n };\n}\n"],"mappings":"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","names":["fs","cluster","path","path","fs","cluster"]}
1
+ {"version":3,"sources":["../src/shutdown.ts","../src/index.ts","../src/cluster/index.ts","../src/tasks/scanner.ts","../src/dashboard.ts","../src/rate-limit.ts","../src/cache/response.ts","../src/compose.ts"],"sourcesContent":["interface DrainOptions {\n transports: Promise<unknown>[];\n tasks: Array<() => Promise<unknown>>;\n cache: () => Promise<unknown>;\n tracing: () => Promise<unknown>;\n}\n/** Drain every producer/consumer before removing shared dependencies. Fail only\n * after all cleanup attempts, so a fast failure cannot cut off a slower job. */\nexport async function drainServices(options: DrainOptions): Promise<void> {\n const errors: unknown[] = [];\n const outcomes = await Promise.allSettled([\n ...options.transports,\n ...options.tasks.map((close) => Promise.resolve().then(close)),\n ]);\n for (const outcome of outcomes) if (outcome.status === 'rejected') errors.push(outcome.reason);\n for (const close of [options.cache, options.tracing]) {\n try {\n await close();\n } catch (error) {\n errors.push(error);\n }\n }\n if (errors.length) throw new AggregateError(errors, 'Service shutdown failed');\n}\n","import { drainServices } from './shutdown.js';\nimport { configureTracing, shutdownTracing } from './tracing.js';\nimport http from 'node:http';\nimport fs from 'node:fs';\nimport express from 'express';\nimport cluster from 'node:cluster';\nimport os from 'node:os';\nimport path from 'node:path';\nimport type { EFCConfig, MountedRoute } from './types.js';\nexport type {\n TableModel,\n TableRecord,\n TableCreateInput,\n TableWhere,\n TableWhereUnique,\n TableUpdateData,\n TableCreateData,\n TableUpdateInput,\n TableOrderBy,\n TableSelect,\n TableInclude,\n TableResult,\n Tables,\n TableFindManyArgs,\n TableAggregateArgs,\n TableGroupByArgs,\n TableAggregateResult,\n ScalarFilter,\n StringFilter,\n ListFilter,\n JsonFilter,\n InferTableRecord,\n} from './table-types.js';\nimport { scanDir } from './router/scan.js';\nimport { mountRoutes } from './router/mount.js';\nimport { mountOpenAPI } from './openapi.js';\nimport { attachWebSockets, closeWebSockets } from './websocket.js';\nimport { runMaster, shutdownMaster } from './cluster/index.js';\nimport { configureAuth } from './auth/index.js';\nimport { connectMongo } from './db/mongo.js';\nimport { setDbClient } from './db/index.js';\nimport { setDbEngine, setAutoSync } from './db/engine.js';\nimport { checkConnectionBudget, connectPostgres } from './db/postgres.js';\nimport { configureLogger, getLogger } from './logger.js';\nimport { configureQueryLog } from './db/query-log.js';\nimport { scanTasks } from './tasks/scanner.js';\nimport { initBullMQ, closeBullMQ } from './tasks/bullmq-backend.js';\nimport { initPgBoss, closePgBoss } from './tasks/pgboss-backend.js';\nimport { configureCache, closeCache } from './cache/index.js';\nimport { servePrimaryCache } from './cache/ipc.js';\nimport { generateDashboard } from './dashboard.js';\nimport { createHttpApp, mountErrorHandler } from './http-app.js';\n\nfunction detectDatabase(url?: string): 'mongodb' | 'postgresql' | undefined {\n if (!url) return undefined;\n if (url.startsWith('mongodb')) return 'mongodb';\n if (url.startsWith('postgres')) return 'postgresql';\n return undefined;\n}\n\nexport async function ignite(config: EFCConfig): Promise<http.Server | undefined> {\n const { port: _port, workers, onWorkerReady, onWorkerCrash, onError } = config;\n\n // Resolve api/tasks dirs from convention. argv[1]-based resolution is unreliable in tsx watch\n // + cluster workers (argv[1] can point to the tsx binary instead of the user's script), so we\n // probe multiple candidates and use the first that exists on disk.\n function resolveConventionDir(name: string): string {\n const candidates: string[] = [\n ...(process.argv[1] ? [path.join(path.dirname(process.argv[1]), name)] : []),\n path.join(process.cwd(), 'src', name),\n path.join(process.cwd(), name),\n path.join(process.cwd(), 'dist', name),\n ];\n return candidates.find((c) => fs.existsSync(c)) ?? candidates[0]!;\n }\n const apiDir = resolveConventionDir('api');\n const tasksDir = resolveConventionDir('tasks');\n const basePath = config.basePath ?? '/v1/api';\n\n function readProjectMeta(): { name: string; version: string } {\n try {\n const raw = fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8');\n const pkg = JSON.parse(raw) as { name?: string; version?: string };\n return { name: pkg.name ?? 'API', version: pkg.version ?? '' };\n } catch {\n return { name: 'API', version: '' };\n }\n }\n\n const port = _port != null && !Number.isNaN(_port) ? _port : 3000;\n const databaseUrl = config.databaseUrl;\n const database = config.database ?? detectDatabase(databaseUrl);\n const jwtSecret = config.jwtSecret;\n const authStrategy = config.authStrategy ?? 'http-only';\n // NODE_ENV is a Node/Express-wide runtime-mode signal set by the platform, not an app\n // secret — unlike PORT/DATABASE_URL/JWT_SECRET/etc. this one is still read directly.\n const clusterEnabled = config.cluster ?? process.env['NODE_ENV'] === 'production';\n\n configureLogger(config.logging);\n // Any value but 'http-only' acts as bearer, as it always has — an app may rely on that, so\n // 0.9.x only warns (a typo of 'http-only' silently means no cookie). 1.0 makes it an error.\n if (\n !['http-only', 'bearer', 'localStorage'].includes(authStrategy) &&\n (!clusterEnabled || cluster.isPrimary) // once, not once per worker\n ) {\n getLogger().warn(\n `[EFC] Unknown authStrategy \"${String(authStrategy)}\" — treated as 'bearer'. Use 'http-only' or 'bearer'; this will be an error in 1.0.`,\n );\n }\n // HS256 with a short secret can be brute-forced offline from any token a user holds.\n if (\n jwtSecret &&\n Buffer.byteLength(jwtSecret) < 32 &&\n process.env['NODE_ENV'] === 'production' &&\n (!clusterEnabled || cluster.isPrimary)\n ) {\n getLogger().warn(\n `[EFC] jwtSecret is ${Buffer.byteLength(jwtSecret)} bytes — use at least 32 random bytes in production (openssl rand -hex 64).`,\n );\n }\n configureQueryLog(config.logging);\n configureTracing(config.tracing);\n\n if (clusterEnabled && cluster.isPrimary) {\n // The memory cache lives in the primary so all workers share it (cache/ipc.ts).\n if (config.cache && config.cache.backend === 'memory') {\n servePrimaryCache(config.cache.maxEntries ?? 10_000);\n }\n runMaster({\n workers: workers ?? os.cpus().length,\n ...(onWorkerReady !== undefined && { onWorkerReady }),\n ...(onWorkerCrash !== undefined && { onWorkerCrash }),\n });\n return;\n }\n\n const app = createHttpApp(config);\n\n // Pre-Flight step 1: Connect database. The engine decides what defineModel compiles to.\n if (database) setDbEngine(database);\n setAutoSync(config.autoSync ?? true);\n // Pools are per worker; one process per machine reports the machine's total.\n const poolWorkers = clusterEnabled ? (workers ?? os.cpus().length) : 1;\n const reportsPools = !clusterEnabled || cluster.worker?.id === 1;\n if (database === 'mongodb' && databaseUrl) {\n const conn = await connectMongo(databaseUrl, config.databasePool);\n setDbClient(conn as unknown as Record<string, unknown>);\n if (reportsPools) {\n const max = config.databasePool?.max ?? 100; // mongoose's maxPoolSize default\n getLogger().info(\n `MongoDB connections: up to ${poolWorkers * max} from this machine (${poolWorkers} worker(s) × maxPoolSize ${max})`,\n );\n }\n } else if (database === 'postgresql' && databaseUrl) {\n const pool = await connectPostgres(databaseUrl, config.databasePool);\n setDbClient(pool as unknown as Record<string, unknown>);\n if (reportsPools) {\n const max = config.databasePool?.max ?? 10; // node-postgres' default\n // pg-boss on the same database opens its own pool (node-postgres default 10).\n const boss =\n config.tasks && config.tasks.backend === 'pg-boss' && !config.tasks.connectionString\n ? 10\n : 0;\n const breakdown = `${poolWorkers} worker(s) × (pool ${max}${boss ? ` + pg-boss ${boss}` : ''})`;\n await checkConnectionBudget(poolWorkers * (max + boss), breakdown);\n }\n }\n\n // Pre-Flight step 1b: Cache (also the session-revocation store requireAuth consults)\n if (config.cache) {\n await configureCache(config.cache);\n }\n\n // Pre-Flight step 2: Configure auth\n if (jwtSecret) {\n configureAuth({\n secret: jwtSecret,\n strategy: authStrategy,\n expiresIn: config.jwtExpiresIn ?? '7d',\n ...(config.cookieDomain !== undefined && { cookieDomain: config.cookieDomain }),\n });\n }\n\n // Pre-Flight step 3: Scan and register tasks\n if (tasksDir) {\n await scanTasks(tasksDir);\n }\n\n // Pre-Flight step 4: Start task queue backend\n if (config.tasks) {\n if (config.tasks.backend === 'bullmq') {\n await initBullMQ({\n tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),\n redisUrl: config.tasks.redisUrl ?? 'redis://localhost:6379',\n concurrency: config.tasks.concurrency ?? 5,\n enqueueTimeout: config.tasks.enqueueTimeout ?? 5000,\n queue: config.tasks.queue ?? 'efc',\n });\n } else if (config.tasks.backend === 'pg-boss') {\n const connectionString = config.tasks.connectionString ?? databaseUrl;\n if (!connectionString) {\n throw new Error(\n '[EFC] tasks.backend \"pg-boss\" needs tasks.connectionString or databaseUrl',\n );\n }\n await initPgBoss({\n tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),\n connectionString,\n concurrency: config.tasks.concurrency ?? 5,\n enqueueTimeout: config.tasks.enqueueTimeout ?? 5000,\n queue: config.tasks.queue ?? 'efc',\n ...(config.tasks.schema !== undefined && { schema: config.tasks.schema }),\n });\n }\n }\n\n // Pre-Flight step 5: Scan routes and mount\n const routes = scanDir(apiDir);\n const apiRouter = express.Router();\n const mounted: MountedRoute[] = await mountRoutes(apiRouter, routes);\n if (config.openapi) {\n const meta = readProjectMeta();\n const options = config.openapi === true ? {} : config.openapi;\n await mountOpenAPI(app, mounted, {\n info: { title: meta.name, version: meta.version },\n ...options,\n basePath,\n });\n }\n app.use(basePath, apiRouter);\n\n if (config.dashboard !== false && process.env['NODE_ENV'] === 'development') {\n app.get('/', (_req, res) => {\n const { name, version } = readProjectMeta();\n res.setHeader('Content-Type', 'text/html; charset=utf-8');\n res.send(generateDashboard(mounted, basePath, port, name, version));\n });\n }\n\n mountErrorHandler(app, onError);\n\n return new Promise<http.Server>((resolve, reject) => {\n const server = http.createServer(app);\n if (config.websocket !== false && mounted.some((route) => route.websocket))\n attachWebSockets(server, app, config.websocket);\n\n server.once('listening', () => {\n const wid = (cluster.worker as { id: number } | undefined)?.id ?? 'primary';\n const addr = server.address() as { port: number } | null;\n getLogger().info(`Worker ${wid} listening on :${addr?.port ?? port}`);\n resolve(server);\n });\n\n server.once('error', reject);\n server.listen(port);\n });\n}\n\nexport function gracefulShutdown(server: http.Server | undefined, timeoutMs = 10_000): void {\n let shuttingDown = false;\n const shutdown = (signal: string) => {\n // A worker can get the signal twice (process-group Ctrl+C plus the primary's\n // forward); the default handler for a repeat would kill it mid-drain.\n if (shuttingDown) return;\n shuttingDown = true;\n getLogger().info(`${signal} received — closing server gracefully…`);\n if (server) {\n const websocketDrain = closeWebSockets(server, Math.max(1, Math.min(1000, timeoutMs / 2)));\n server.closeIdleConnections();\n server.close(() => {\n getLogger().info('Server closed');\n // Let in-flight task jobs finish before exiting; the timeout below still caps it.\n drainServices({\n transports: [websocketDrain],\n tasks: [closeBullMQ, closePgBoss],\n cache: closeCache,\n tracing: shutdownTracing,\n }).then(\n () => process.exit(0),\n (err: unknown) => {\n getLogger().error({ err }, 'Service shutdown failed');\n process.exit(1);\n },\n );\n });\n setTimeout(() => {\n getLogger().error('Forced exit after timeout');\n process.exit(1);\n }, timeoutMs).unref();\n } else {\n shutdownMaster();\n // Workers get the same budget plus a margin before the primary gives up on them.\n setTimeout(() => {\n getLogger().error('Workers did not exit in time — forcing primary exit');\n process.exit(1);\n }, timeoutMs + 2_000).unref();\n }\n };\n process.on('SIGTERM', () => shutdown('SIGTERM'));\n process.on('SIGINT', () => shutdown('SIGINT'));\n}\n\nexport { HttpError, isHttpError } from './errors.js';\nexport { logger, getLogger } from './logger.js';\nexport { getQueryMetrics, resetQueryMetrics } from './db/query-log.js';\nexport type { QueryMetric, QueryMetricsSnapshot } from './db/query-log.js';\nexport { cache } from './cache/index.js';\nexport { rateLimit } from './rate-limit.js';\nexport type { RateLimitOptions } from './rate-limit.js';\nexport { cacheResponse } from './cache/response.js';\nexport { compose } from './compose.js';\nexport {\n db,\n setDbClient,\n getDbClient,\n defineModel,\n defineTable,\n defineCollection,\n} from './db/index.js';\nexport type {\n CollectionModel,\n CollectionOptions,\n CollectionFilter,\n CollectionUpdate,\n CollectionFindOptions,\n CollectionWriteResult,\n CollectionBulkResult,\n CollectionBulkOp,\n CollectionChange,\n CollectionChangeStream,\n} from './db/collection-model.js';\nexport type {\n Pipeline,\n FieldRef,\n Accumulator,\n GroupResult,\n LookedUp,\n LookupTarget,\n} from './db/pipeline.js';\nexport { transaction } from './db/transaction.js';\nexport { ModelValidationError } from './db/schema.js';\nexport { scanDir } from './router/scan.js';\nexport { listTasks } from './tasks/index.js';\nexport { workerCount } from './cluster/index.js';\nexport type {\n EFCConfig,\n DatabasePoolConfig,\n CollectionSchema,\n CollectionFieldDefinition,\n GeoPoint,\n CorsConfig,\n RouteEntry,\n RouteMeta,\n RouteMethodMeta,\n RouteSchema,\n LoggingConfig,\n QueryLogConfig,\n CacheConfig,\n RequestSchema,\n Validator,\n ValidationIssue,\n TaskOptions,\n TaskDefinition,\n DatabaseEngine,\n AuthStrategy,\n ModelSchema,\n TableSchema,\n TableSchemaField,\n TableFieldDefinition,\n TableOptions,\n TableRelation,\n MigrationContext,\n SchemaField,\n Filter,\n FilterOperators,\n Update,\n FindOptions,\n IndexDefinition,\n ModelRecord,\n InferRecord,\n InferCreate,\n InferSchema,\n InferCreateInput,\n ScalarKeys,\n SortDirection,\n ModelCRUD,\n ModelQueryOptions,\n ModelOptions,\n FieldDefinition,\n DefaultOperator,\n} from './types.js';\n\nexport { generateOpenAPI } from './openapi.js';\nexport type { OpenAPIOptions, OpenAPIDocument, JSONSchema } from './openapi.js';\nexport { attachWebSockets, closeWebSockets } from './websocket.js';\nexport type { WebSocketHandler, WebSocketOptions } from './websocket.js';\n\nexport type { TracingOptions } from './tracing.js';\n","import cluster from 'node:cluster';\nimport { getLogger } from '../logger.js';\n\ninterface ClusterOptions {\n workers?: number;\n onWorkerReady?: ((id: number) => void) | undefined;\n onWorkerCrash?: ((id: number, code: number) => void) | undefined;\n}\n\nlet isShuttingDown = false;\n\n/**\n * Returns the number of currently alive (not yet exited) cluster workers.\n * Returns `0` when running in single-process mode.\n */\nexport function workerCount(): number {\n return Object.keys(cluster.workers ?? {}).length;\n}\n\nexport function shutdownMaster(): void {\n isShuttingDown = true;\n getLogger().info(`Cluster primary (pid=${process.pid}) shutting down, waiting for workers…`);\n if (workerCount() === 0) process.exit(0);\n // Orchestrators (docker stop, k8s) signal only PID 1 — the primary — so forward the\n // signal; each worker's gracefulShutdown drains its server and exits on its own.\n for (const worker of Object.values(cluster.workers ?? {})) {\n worker?.process.kill('SIGTERM');\n }\n}\n\nexport function runMaster(options: ClusterOptions = {}): void {\n const count = options.workers ?? 1;\n\n getLogger().info(`Primary ${process.pid} starting ${count} workers`);\n\n for (let i = 0; i < count; i++) {\n cluster.fork();\n }\n\n cluster.on('online', (worker) => {\n options.onWorkerReady?.(worker.id);\n });\n\n cluster.on('exit', (worker, code, signal) => {\n const exitCode = code ?? (signal ? -1 : 0);\n if (isShuttingDown) {\n getLogger().info(`Worker ${worker.id} gracefully exited`);\n if (workerCount() === 0) {\n getLogger().info('All workers exited. Primary exiting.');\n process.exit(0);\n }\n return;\n }\n\n getLogger().warn(`Worker ${worker.id} exited (code=${exitCode}), respawning…`);\n options.onWorkerCrash?.(worker.id, exitCode);\n cluster.fork();\n });\n}\n\nexport { cluster };\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { registerTask } from './index.js';\nimport { listTaskFiles } from './files.js';\nimport { getLogger } from '../logger.js';\nimport type { TaskDefinition } from '../types.js';\n\nexport async function scanTasks(tasksDir: string): Promise<void> {\n if (!fs.existsSync(tasksDir)) return;\n\n const files = listTaskFiles(tasksDir);\n\n for (const file of files) {\n const filePath = path.join(tasksDir, file);\n const taskName = path.basename(file, path.extname(file));\n\n try {\n const mod = (await import(filePath)) as Record<string, unknown>;\n const def = mod['default'] as TaskDefinition | undefined;\n\n if (!def || typeof def.handler !== 'function') {\n getLogger().warn(`Task file ${file} has no valid default export — skipping`);\n continue;\n }\n\n registerTask(taskName, { ...def, filePath });\n getLogger().debug(`Registered task: ${taskName}`);\n } catch (err) {\n getLogger().warn({ err }, `Failed to load task ${file}`);\n }\n }\n}\n","import type { MountedRoute } from './types.js';\n\nconst HTTP_STATUS: Record<number, string> = {\n 200: 'OK',\n 201: 'Created',\n 202: 'Accepted',\n 204: 'No Content',\n 400: 'Bad Request',\n 401: 'Unauthorized',\n 403: 'Forbidden',\n 404: 'Not Found',\n 405: 'Method Not Allowed',\n 409: 'Conflict',\n 422: 'Unprocessable Entity',\n 500: 'Internal Server Error',\n 503: 'Service Unavailable',\n};\n\nexport function generateDashboard(\n routes: MountedRoute[],\n basePath: string,\n port: number,\n projectName: string,\n projectVersion: string,\n): string {\n const safeRoutes = JSON.stringify(\n routes.map((r) => ({\n urlPath: r.urlPath,\n methods: r.websocket ? [...r.methods, 'WS'] : r.methods,\n params: r.params,\n meta: r.meta ?? null,\n })),\n ).replace(/<\\/script>/gi, '<\\\\/script>');\n const safeHttpStatus = JSON.stringify(HTTP_STATUS);\n\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>${projectName} — API Reference</title>\n <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n <link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin />\n <link href=\"https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap\" rel=\"stylesheet\" />\n <style>\n *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\n :root {\n --bg: #080b0f;\n --bg-card: #0d1117;\n --bg-raised: #111820;\n --border: #1e2832;\n --border-lit: #263040;\n --text: #e2e8f0;\n --text-dim: #64748b;\n --text-muted: #334155;\n --accent: #F0A030;\n --accent-dim: rgba(240,160,48,.12);\n --accent-glow: rgba(240,160,48,.22);\n --purple: #a78bfa;\n --blue: #60a5fa;\n --orange: #fb923c;\n --green: #7AAE8E;\n --radius: 10px;\n --radius-lg: 16px;\n --font-mono: 'JetBrains Mono', monospace;\n --font-sans: 'Inter', sans-serif;\n }\n html { scroll-behavior: smooth; }\n body {\n background: var(--bg); color: var(--text);\n font-family: var(--font-sans); font-size: 16px;\n line-height: 1.6; -webkit-font-smoothing: antialiased;\n position: relative;\n }\n body::before {\n content: ''; position: fixed; inset: 0; z-index: 0;\n background-image:\n linear-gradient(var(--border) 1px, transparent 1px),\n linear-gradient(90deg, var(--border) 1px, transparent 1px);\n background-size: 60px 60px; opacity: .28; pointer-events: none;\n }\n section, footer, .page-hero, .docs-layout { position: relative; z-index: 1; }\n a { text-decoration: none; color: inherit; }\n em { font-style: italic; }\n code {\n font-family: var(--font-mono); font-size: .85em;\n background: var(--bg-raised); border: 1px solid var(--border);\n border-radius: 4px; padding: 1px 6px; color: var(--accent);\n }\n .container { max-width: 1140px; margin: 0 auto; padding: 0 24px; }\n ::-webkit-scrollbar { width: 6px; }\n ::-webkit-scrollbar-track { background: var(--bg); }\n ::-webkit-scrollbar-thumb { background: var(--border-lit); border-radius: 3px; }\n\n /* ── PAGE HERO ── */\n .page-hero {\n padding: 48px 0 56px; border-bottom: 1px solid var(--border);\n }\n .page-hero .hero-glow {\n position: absolute; top: -40px; left: 10%; width: 500px; height: 350px;\n background: radial-gradient(ellipse, rgba(240,160,48,.1) 0%, transparent 68%);\n pointer-events: none;\n }\n .page-title {\n font-size: clamp(2rem, 5vw, 3.4rem); font-weight: 800;\n line-height: 1.1; letter-spacing: -.02em; margin-bottom: 24px;\n display: flex; align-items: baseline; gap: 16px; flex-wrap: wrap;\n }\n .project-version {\n font-family: var(--font-mono); font-size: clamp(.85rem, 2vw, 1.1rem);\n font-weight: 500; color: var(--accent);\n background: var(--accent-dim); border: 1px solid rgba(240,160,48,.3);\n border-radius: 6px; padding: 2px 10px; letter-spacing: .5px;\n }\n .hero-meta { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; margin-bottom: 40px; }\n .base-url-pill {\n display: flex; align-items: center; gap: 8px;\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: 7px; padding: 8px 14px;\n }\n .base-url-label { font-size: .72rem; font-family: var(--font-mono);\n color: var(--text-muted); text-transform: uppercase; letter-spacing: .5px; }\n .base-url-val { font-family: var(--font-mono); font-size: .8rem; color: var(--accent); }\n .count-pill {\n font-family: var(--font-mono); font-size: .72rem; color: var(--text-dim);\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: 7px; padding: 8px 14px;\n }\n\n /* ── TOOLBAR ── */\n .toolbar {\n display: flex; align-items: center; gap: 12px; flex-wrap: wrap;\n }\n .method-filters { display: flex; gap: 4px; flex-wrap: wrap; }\n .filter-btn {\n background: var(--bg-card); border: 1px solid var(--border);\n color: var(--text-dim); font-family: var(--font-mono);\n font-size: .72rem; font-weight: 600; letter-spacing: .5px;\n padding: 6px 12px; border-radius: 6px; cursor: pointer;\n transition: all .15s;\n }\n .filter-btn:hover { border-color: var(--border-lit); color: var(--text); }\n .filter-btn.active { background: var(--accent); color: #0d0d1a; border-color: var(--accent); }\n .filter-btn[data-method=\"GET\"].active { background: rgba(96,165,250,.18); color: #60a5fa; border-color: rgba(96,165,250,.4); }\n .filter-btn[data-method=\"POST\"].active { background: rgba(122,174,142,.18); color: #7AAE8E; border-color: rgba(122,174,142,.4); }\n .filter-btn[data-method=\"PUT\"].active { background: rgba(240,160,48,.18); color: #F0A030; border-color: rgba(240,160,48,.4); }\n .filter-btn[data-method=\"PATCH\"].active { background: rgba(251,191,36,.18); color: #fbbf24; border-color: rgba(251,191,36,.4); }\n .filter-btn[data-method=\"DELETE\"].active { background: rgba(248,113,113,.18); color: #f87171; border-color: rgba(248,113,113,.4); }\n .filter-btn[data-method=\"HEAD\"].active { background: rgba(167,139,250,.18); color: #a78bfa; border-color: rgba(167,139,250,.4); }\n .search-wrap { margin-left: auto; }\n .search-input {\n background: var(--bg-card); border: 1px solid var(--border);\n color: var(--text); font-family: var(--font-sans); font-size: .85rem;\n padding: 7px 14px; border-radius: 7px; width: 240px;\n outline: none; transition: border-color .2s;\n }\n .search-input::placeholder { color: var(--text-muted); }\n .search-input:focus { border-color: var(--border-lit); }\n\n /* ── DOCS LAYOUT ── */\n .docs-layout {\n display: grid; grid-template-columns: 260px 1fr;\n gap: 48px; padding: 52px 0 80px; max-width: 1140px;\n margin: 0 auto; padding-left: 24px; padding-right: 24px;\n align-items: start;\n }\n\n /* ── SIDEBAR ── */\n .docs-sidebar {\n position: sticky; top: 24px;\n max-height: calc(100vh - 48px);\n overflow-y: auto;\n overflow-x: hidden;\n scrollbar-width: none;\n padding-right: 4px;\n }\n .docs-sidebar::-webkit-scrollbar { display: none; }\n .sidebar-section { margin-bottom: 28px; }\n .sidebar-label {\n font-family: var(--font-mono); font-size: .68rem; font-weight: 600;\n color: var(--text-muted); letter-spacing: 1.2px; text-transform: uppercase;\n margin-bottom: 8px; padding: 0 4px;\n }\n .sidebar-link {\n display: flex; align-items: center; gap: 8px;\n padding: 7px 10px; border-radius: 6px;\n border-left: 2px solid transparent;\n font-size: .82rem; color: var(--text-dim); cursor: pointer;\n transition: background .15s, color .15s, border-color .15s;\n overflow: hidden; white-space: nowrap;\n }\n .sidebar-link:hover { background: var(--bg-raised); color: var(--text); }\n .sidebar-link.active { color: var(--accent); border-left-color: var(--accent); background: var(--accent-dim); }\n .sidebar-method-dot {\n width: 6px; height: 6px; border-radius: 50%; flex-shrink: 0;\n }\n .sidebar-path { font-family: var(--font-mono); font-size: .72rem; }\n\n /* ── ENDPOINT CARDS ── */\n .endpoint-card {\n background: var(--bg-card); border: 1px solid var(--border);\n border-radius: var(--radius-lg); margin-bottom: 20px;\n overflow: hidden; transition: border-color .2s;\n animation: fadeUp .45s ease both;\n }\n .endpoint-card:hover { border-color: var(--border-lit); }\n @keyframes fadeUp {\n from { opacity: 0; transform: translateY(16px); }\n to { opacity: 1; transform: translateY(0); }\n }\n @media (prefers-reduced-motion: reduce) {\n .endpoint-card { animation: none; }\n }\n .endpoint-header {\n display: flex; align-items: center; gap: 14px;\n padding: 20px 24px 18px; border-bottom: 1px solid var(--border);\n flex-wrap: wrap;\n }\n .method-badges { display: flex; gap: 6px; flex-wrap: wrap; }\n .method-badge {\n font-family: var(--font-mono); font-size: .7rem; font-weight: 600;\n letter-spacing: .8px; padding: 4px 10px; border-radius: 5px;\n border: 1px solid; text-transform: uppercase;\n }\n .endpoint-path {\n font-family: var(--font-mono); font-size: .9rem; color: var(--text);\n background: none; border: none; padding: 0;\n word-break: break-all;\n }\n .endpoint-body { padding: 6px 24px 24px; }\n .endpoint-desc { font-size: .9rem; color: var(--text-dim); line-height: 1.7; margin-bottom: 20px; }\n\n /* ── PER-METHOD DOC BLOCKS ── */\n .method-block { padding-top: 20px; }\n .method-block + .method-block { margin-top: 4px; border-top: 1px solid var(--border); }\n .method-block-header { display: flex; align-items: center; gap: 10px; margin-bottom: 12px; }\n .method-block-header .method-badge { font-size: .68rem; }\n .method-block-empty { font-size: .82rem; color: var(--text-muted); }\n\n /* ── CODE BLOCKS ── */\n .example-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }\n .code-block-wrap {\n background: var(--bg-raised); border: 1px solid var(--border);\n border-radius: var(--radius); overflow: hidden;\n }\n .code-bar {\n display: flex; align-items: center; gap: 6px;\n padding: 9px 14px; border-bottom: 1px solid var(--border);\n background: var(--bg-card);\n }\n .dot { width: 11px; height: 11px; border-radius: 50%; }\n .dot-r { background: #ff5f57; }\n .dot-y { background: #febc2e; }\n .dot-g { background: #28c840; }\n .code-label { font-family: var(--font-mono); font-size: .68rem; color: var(--text-dim); margin-left: 4px; }\n pre.code-pre {\n font-family: var(--font-mono); font-size: .78rem; line-height: 1.7;\n padding: 16px 18px; overflow-x: auto; tab-size: 2; white-space: pre;\n }\n .c-dim { color: var(--text-muted); }\n .c-green { color: #7AAE8E; }\n .c-blue { color: #60a5fa; }\n .c-orange { color: #fb923c; }\n .c-purple { color: #a78bfa; }\n .c-accent { color: var(--accent); }\n .status-2xx { color: #7AAE8E; }\n .status-4xx { color: #f87171; }\n .status-5xx { color: #fb923c; }\n\n /* ── EMPTY STATE ── */\n .empty-state {\n text-align: center; padding: 80px 24px;\n color: var(--text-muted); font-size: .9rem;\n }\n\n /* ── RESPONSIVE ── */\n @media (max-width: 900px) {\n .docs-layout { grid-template-columns: 1fr; }\n .docs-sidebar { position: static; max-height: none; overflow-y: visible; padding-right: 0; }\n .example-grid { grid-template-columns: 1fr; }\n .search-wrap { margin-left: 0; width: 100%; }\n .search-input { width: 100%; }\n }\n @media (max-width: 600px) {\n .page-hero { padding: 32px 0 32px; }\n .page-title { font-size: 2rem; }\n }\n </style>\n</head>\n<body>\n\n <div class=\"page-hero\">\n <div class=\"hero-glow\"></div>\n <div class=\"container\">\n <h1 class=\"page-title\">${projectName}${projectVersion ? `<span class=\"project-version\">v${projectVersion}</span>` : ''}</h1>\n <div class=\"hero-meta\">\n <div class=\"base-url-pill\">\n <span class=\"base-url-label\">Base</span>\n <span class=\"base-url-val\">http://localhost:${port}${basePath}</span>\n </div>\n <div class=\"count-pill\" id=\"countPill\"></div>\n </div>\n <div class=\"toolbar\">\n <div class=\"method-filters\" id=\"methodFilters\">\n <button class=\"filter-btn active\" data-method=\"ALL\">ALL</button>\n </div>\n <div class=\"search-wrap\">\n <input type=\"text\" id=\"searchInput\" class=\"search-input\" placeholder=\"Search endpoints…\" />\n </div>\n </div>\n </div>\n </div>\n\n <div class=\"docs-layout\">\n <aside class=\"docs-sidebar\" id=\"sidebar\"></aside>\n <main id=\"endpoints\"></main>\n </div>\n\n <script>\n const ROUTES = ${safeRoutes};\n const BASE_PATH = ${JSON.stringify(basePath)};\n const HTTP_STATUS = ${safeHttpStatus};\n\n const METHOD_STYLE = {\n GET: { bg: 'rgba(96,165,250,.14)', color: '#60a5fa', border: 'rgba(96,165,250,.35)' },\n POST: { bg: 'rgba(122,174,142,.14)', color: '#7AAE8E', border: 'rgba(122,174,142,.35)' },\n PUT: { bg: 'rgba(240,160,48,.14)', color: '#F0A030', border: 'rgba(240,160,48,.35)' },\n PATCH: { bg: 'rgba(251,191,36,.14)', color: '#fbbf24', border: 'rgba(251,191,36,.35)' },\n DELETE: { bg: 'rgba(248,113,113,.14)', color: '#f87171', border: 'rgba(248,113,113,.35)' },\n HEAD: { bg: 'rgba(167,139,250,.14)', color: '#a78bfa', border: 'rgba(167,139,250,.35)' },\n OPTIONS: { bg: 'rgba(148,163,184,.14)', color: '#94a3b8', border: 'rgba(148,163,184,.35)' },\n };\n\n function esc(s) {\n return String(s)\n .replace(/&/g,'&amp;').replace(/</g,'&lt;')\n .replace(/>/g,'&gt;').replace(/\"/g,'&quot;');\n }\n\n function methodBadge(m) {\n const s = METHOD_STYLE[m] || METHOD_STYLE.GET;\n return '<span class=\"method-badge\" style=\"background:' + s.bg + ';color:' + s.color + ';border-color:' + s.border + '\">' + m + '</span>';\n }\n\n function joinPath(base, p) {\n return (base.replace(/\\\\/+$/, '') + p) || '/';\n }\n\n function sidebarDot(method) {\n const s = METHOD_STYLE[method] || METHOD_STYLE.GET;\n return '<span class=\"sidebar-method-dot\" style=\"background:' + s.color + '\"></span>';\n }\n\n function statusClass(code) {\n if (code >= 200 && code < 300) return 'status-2xx';\n if (code >= 400 && code < 500) return 'status-4xx';\n if (code >= 500) return 'status-5xx';\n return '';\n }\n\n function renderSchema(val, indent) {\n const pad = ' '.repeat(indent || 0);\n if (val === null) return '<span class=\"c-dim\">null</span>';\n if (typeof val === 'string') {\n const isDate = /^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}/.test(val);\n return isDate ? '<span class=\"c-green\">Date</span>' : '<span class=\"c-purple\">String</span>';\n }\n if (typeof val === 'number') return '<span class=\"c-orange\">Number</span>';\n if (typeof val === 'boolean') return '<span class=\"c-purple\">Boolean</span>';\n if (Array.isArray(val)) {\n if (!val.length) return '[]';\n return '[\\\\n' + pad + ' ' + renderSchema(val[0], (indent || 0) + 1) + '\\\\n' + pad + ']';\n }\n if (typeof val === 'object') {\n const keys = Object.keys(val);\n if (!keys.length) return '{}';\n const inner = keys.map(function(k) {\n return pad + ' <span class=\"c-blue\">&quot;' + esc(k) + '&quot;</span>: ' + renderSchema(val[k], (indent || 0) + 1);\n }).join(',\\\\n');\n return '{\\\\n' + inner + '\\\\n' + pad + '}';\n }\n return esc(String(val));\n }\n\n function codeBlock(label, content) {\n return '<div class=\"code-block-wrap\">' +\n '<div class=\"code-bar\">' +\n '<span class=\"dot dot-r\"></span>' +\n '<span class=\"dot dot-y\"></span>' +\n '<span class=\"dot dot-g\"></span>' +\n '<span class=\"code-label\">' + esc(label) + '</span>' +\n '</div>' +\n '<pre class=\"code-pre\">' + content + '</pre>' +\n '</div>';\n }\n\n function buildRequestContent(route, method, example) {\n const req = example || {};\n let path = joinPath(BASE_PATH, route.urlPath);\n if (req.params) {\n for (const [k, v] of Object.entries(req.params)) {\n path = path.replace(':' + k, String(v));\n }\n }\n if (req.query && Object.keys(req.query).length) {\n path += '?' + new URLSearchParams(req.query).toString();\n }\n let lines = '<span class=\"c-accent\">' + esc(method) + '</span> <span class=\"c-blue\">' + esc(path) + '</span>';\n const headers = { ...(req.headers || {}) };\n if (req.body !== undefined && !headers['Content-Type']) {\n headers['Content-Type'] = 'application/json';\n }\n if (Object.keys(headers).length) {\n lines += '\\\\n' + Object.entries(headers)\n .map(([k, v]) => '<span class=\"c-dim\">' + esc(k) + ':</span> ' + esc(String(v)))\n .join('\\\\n');\n }\n if (req.body !== undefined) {\n lines += '\\\\n\\\\n' + renderSchema(req.body, 0);\n }\n return lines;\n }\n\n function buildResponseContent(example) {\n const resp = example || {};\n const code = resp.status || 200;\n const text = HTTP_STATUS[code] || 'OK';\n const cls = statusClass(code);\n let lines = 'HTTP/1.1 <span class=\"' + cls + '\">' + code + ' ' + esc(text) + '</span>';\n if (resp.body !== undefined) {\n lines += '\\\\n<span class=\"c-dim\">Content-Type:</span> application/json\\\\n\\\\n';\n lines += renderSchema(resp.body, 0);\n }\n return lines;\n }\n\n function renderMethodBlock(route, method) {\n const methodMeta = route.meta ? route.meta[method] : null;\n const header = '<div class=\"method-block-header\">' + methodBadge(method) + '</div>';\n\n if (!methodMeta) {\n return '<div class=\"method-block\" data-method=\"' + esc(method) + '\">' + header +\n '<p class=\"method-block-empty\">No documentation provided for this method.</p></div>';\n }\n\n const desc = methodMeta.description\n ? '<p class=\"endpoint-desc\">' + esc(methodMeta.description) + '</p>'\n : '';\n const reqHtml = methodMeta.request !== undefined\n ? codeBlock('request', buildRequestContent(route, method, methodMeta.request))\n : '';\n const respHtml = methodMeta.response !== undefined\n ? codeBlock('response', buildResponseContent(methodMeta.response))\n : '';\n const examples = reqHtml || respHtml\n ? '<div class=\"example-grid\">' + reqHtml + respHtml + '</div>'\n : '';\n\n return '<div class=\"method-block\" data-method=\"' + esc(method) + '\">' + header + desc + examples + '</div>';\n }\n\n function renderCard(route, index) {\n const id = 'ep-' + index;\n const fullPath = joinPath(BASE_PATH, route.urlPath);\n const badges = route.methods.map(methodBadge).join('');\n const body = route.methods.map(function(m) { return renderMethodBlock(route, m); }).join('');\n const delay = (index * 0.06).toFixed(2) + 's';\n return '<div class=\"endpoint-card\" id=\"' + id + '\" data-methods=\"' + route.methods.join(',') + '\" data-path=\"' + esc(fullPath) + '\" style=\"animation-delay:' + delay + '\">' +\n '<div class=\"endpoint-header\">' +\n '<div class=\"method-badges\">' + badges + '</div>' +\n '<code class=\"endpoint-path\">' + esc(fullPath) + '</code>' +\n '</div>' +\n '<div class=\"endpoint-body\">' + body + '</div>' +\n '</div>';\n }\n\n function buildMethodFilters() {\n const allMethods = [...new Set(ROUTES.flatMap(r => r.methods))].sort();\n const filtersEl = document.getElementById('methodFilters');\n allMethods.forEach(m => {\n const btn = document.createElement('button');\n btn.className = 'filter-btn';\n btn.dataset.method = m;\n btn.textContent = m;\n filtersEl.appendChild(btn);\n });\n }\n\n function buildSidebar(routes) {\n const sidebar = document.getElementById('sidebar');\n if (!routes.length) { sidebar.innerHTML = ''; return; }\n\n const label = document.createElement('div');\n label.className = 'sidebar-label';\n label.textContent = 'Endpoints';\n sidebar.appendChild(label);\n\n routes.forEach((route, i) => {\n const link = document.createElement('div');\n link.className = 'sidebar-link';\n link.dataset.target = 'ep-' + ROUTES.indexOf(route);\n link.innerHTML = sidebarDot(route.methods[0] || 'GET') +\n '<span class=\"sidebar-path\">' + esc(route.urlPath || '/') + '</span>';\n link.addEventListener('click', () => {\n const target = document.getElementById(link.dataset.target);\n if (target) target.scrollIntoView({ behavior: 'smooth', block: 'start' });\n });\n sidebar.appendChild(link);\n });\n }\n\n let activeFilter = 'ALL';\n let searchQuery = '';\n\n function applyFilters() {\n const cards = document.querySelectorAll('.endpoint-card');\n let visible = 0;\n cards.forEach(card => {\n const methods = card.dataset.methods.split(',');\n const path = card.dataset.path || '';\n const matchMethod = activeFilter === 'ALL' || methods.includes(activeFilter);\n const matchSearch = !searchQuery || path.toLowerCase().includes(searchQuery);\n const show = matchMethod && matchSearch;\n card.style.display = show ? '' : 'none';\n if (show) visible++;\n });\n document.getElementById('empty-state').style.display = visible ? 'none' : 'block';\n\n // Sync sidebar visibility\n document.querySelectorAll('.sidebar-link').forEach(link => {\n const targetId = link.dataset.target;\n const targetCard = document.getElementById(targetId);\n link.style.display = targetCard && targetCard.style.display !== 'none' ? '' : 'none';\n });\n }\n\n function init() {\n const count = ROUTES.length;\n document.getElementById('countPill').textContent = count + ' endpoint' + (count !== 1 ? 's' : '');\n\n buildMethodFilters();\n\n const container = document.getElementById('endpoints');\n container.innerHTML = ROUTES.map((r, i) => renderCard(r, i)).join('');\n\n // Add empty state after cards\n const emptyEl = document.createElement('div');\n emptyEl.id = 'empty-state';\n emptyEl.className = 'empty-state';\n emptyEl.style.display = 'none';\n emptyEl.innerHTML = '<p>No endpoints match your filter.</p>';\n container.after(emptyEl);\n\n buildSidebar(ROUTES);\n\n // Method filter clicks\n document.getElementById('methodFilters').addEventListener('click', e => {\n const btn = e.target.closest('.filter-btn');\n if (!btn) return;\n document.querySelectorAll('.filter-btn').forEach(b => b.classList.remove('active'));\n btn.classList.add('active');\n activeFilter = btn.dataset.method;\n applyFilters();\n });\n\n // Search\n document.getElementById('searchInput').addEventListener('input', e => {\n searchQuery = e.target.value.trim().toLowerCase();\n applyFilters();\n });\n\n // Scroll spy for sidebar\n const cardEls = document.querySelectorAll('.endpoint-card');\n const sidebarLinks = document.querySelectorAll('.sidebar-link');\n const observer = new IntersectionObserver(entries => {\n entries.forEach(entry => {\n if (entry.isIntersecting) {\n const id = entry.target.id;\n sidebarLinks.forEach(l => l.classList.toggle('active', l.dataset.target === id));\n const sidebar = document.getElementById('sidebar');\n const activeLink = sidebar && sidebar.querySelector('.sidebar-link.active');\n if (sidebar && activeLink) {\n const linkTop = activeLink.getBoundingClientRect().top - sidebar.getBoundingClientRect().top + sidebar.scrollTop;\n sidebar.scrollTo({ top: linkTop, behavior: 'smooth' });\n }\n }\n });\n }, { rootMargin: '-80px 0px -60% 0px' });\n cardEls.forEach(el => observer.observe(el));\n\n }\n\n try {\n init();\n } catch (e) {\n document.body.insertAdjacentHTML('afterbegin',\n '<div style=\"position:fixed;top:60px;left:0;right:0;z-index:9999;background:#7f1d1d;color:#fca5a5;padding:16px 24px;font-family:monospace;font-size:13px;border-bottom:1px solid #ef4444\">' +\n '<strong>Dashboard JS error:</strong> ' + (e && e.message ? e.message : String(e)) +\n (e && e.stack ? '<pre style=\"margin-top:8px;white-space:pre-wrap\">' + e.stack + '</pre>' : '') +\n '</div>'\n );\n }\n </script>\n</body>\n</html>`;\n}\n","import type { Request, RequestHandler } from 'express';\nimport { isCacheConfigured, rawIncr } from './cache/index.js';\nimport { getLogger } from './logger.js';\n\n// rateLimit(): a fixed-window limit (windows aligned to the clock) counted in the cache\n// (`cache.incr`), so every worker — and with Redis every instance — shares one count. An\n// in-memory counter per worker would let N workers accept N × max.\n\nexport interface RateLimitOptions {\n /** Window length: seconds, or `'30s'`, `'15m'`, `'1h'`, `'1d'`. */\n window: number | string;\n /** Requests allowed per window and key. */\n max: number;\n /**\n * Who a request counts against. Default: the client IP (`req.ip`) — behind a proxy or load\n * balancer set `trustProxy` in ignite(), or every client shares the proxy's IP. Return\n * `undefined` to not limit this request.\n */\n key?: (req: Request) => string | undefined;\n /**\n * Which counter: requests to routes with the same name share a limit. Default: the route\n * pattern (`/users/:id`), so each route file has its own — or the path, for middleware\n * that isn't on a route.\n */\n name?: string;\n /** Body of the 429 response. Default: `'Too many requests, try again later'`. */\n message?: string;\n /**\n * The cache can't be reached: `'allow'` (default) lets requests through — a limiter\n * shouldn't take the API down with it; `'reject'` answers 503.\n */\n onCacheError?: 'allow' | 'reject';\n /** Send `RateLimit-Limit/Remaining/Reset` (and `Retry-After` on 429). Default: true. */\n headers?: boolean;\n}\n\nconst UNITS: Record<string, number> = { s: 1, m: 60, h: 3600, d: 86_400 };\n\nexport function parseWindow(window: number | string): number {\n let seconds = typeof window === 'number' ? window : NaN;\n if (typeof window === 'string') {\n const match = /^(\\d+(?:\\.\\d+)?)\\s*(s|m|h|d)$/.exec(window.trim());\n if (match) seconds = Number(match[1]) * UNITS[match[2]!]!;\n }\n if (Number.isFinite(seconds) && seconds * 1000 >= 1 && seconds * 1000 <= Number.MAX_SAFE_INTEGER)\n return seconds;\n throw new Error(`[EFC] rateLimit: window must be seconds or like '15m' — got ${String(window)}`);\n}\n\nlet lastCacheError = 0;\n\n/**\n * Limits requests per key (default: client IP) to `max` per `window`, counted in the cache\n * so the limit holds across every worker and instance:\n *\n * ```ts\n * export const middlewares = [rateLimit({ window: '15m', max: 10 })];\n * ```\n *\n * Needs `cache` in ignite() — use the Redis backend when you run more than one instance.\n */\nexport function rateLimit(options: RateLimitOptions): RequestHandler {\n const windowSeconds = parseWindow(options.window);\n if (!Number.isSafeInteger(options.max) || options.max < 1) {\n throw new Error('[EFC] rateLimit: max must be a positive integer');\n }\n const keyOf = options.key ?? ((req: Request) => req.ip ?? req.socket.remoteAddress);\n const message = options.message ?? 'Too many requests, try again later';\n const headers = options.headers ?? true;\n\n return (req, res, next) => {\n void (async () => {\n const who = keyOf(req);\n if (who === undefined) return next();\n if (!isCacheConfigured()) {\n throw new Error('[EFC] rateLimit needs a cache — pass cache: { backend } to ignite()');\n }\n const bucket = options.name ?? req.baseUrl + (req.route?.path ?? req.path);\n // Windows are aligned to the clock: every key restarts at the same boundary, and the\n // reset is exact. The key outlives its window by a second, then expires.\n const windowMs = windowSeconds * 1000;\n const now = Date.now();\n const slot = Math.floor(now / windowMs);\n const resetMs = (slot + 1) * windowMs - now;\n let count: number;\n try {\n count = (\n await rawIncr(\n `rl:${JSON.stringify([String(bucket), who, slot])}`,\n Math.ceil(resetMs / 1000) + 1,\n )\n ).value;\n } catch (err) {\n if (Date.now() - lastCacheError > 30_000) {\n lastCacheError = Date.now();\n getLogger().error(\n { err },\n `rateLimit: cache unavailable — ${options.onCacheError === 'reject' ? 'rejecting with 503' : 'allowing requests'}`,\n );\n }\n if (options.onCacheError === 'reject') {\n res.status(503).json({ error: 'Service Unavailable', statusCode: 503 });\n return;\n }\n return next();\n }\n const resetSeconds = Math.max(1, Math.ceil(resetMs / 1000));\n if (headers) {\n res.setHeader('RateLimit-Limit', String(options.max));\n res.setHeader('RateLimit-Remaining', String(Math.max(0, options.max - count)));\n res.setHeader('RateLimit-Reset', String(resetSeconds));\n }\n if (count > options.max) {\n if (headers) res.setHeader('Retry-After', String(resetSeconds));\n res.status(429).json({ error: message, statusCode: 429 });\n return;\n }\n next();\n })().catch(next);\n };\n}\n","import { createHash } from 'node:crypto';\nimport type { Request, RequestHandler } from 'express';\nimport { cache } from './index.js';\nimport { getCurrentUser } from '../context.js';\nimport { getLogger } from '../logger.js';\n\nexport interface CacheResponseOptions {\n /** Seconds to keep a response. */\n ttl: number;\n /** Cache per authenticated string/numeric sub/id. Put requireAuth first. */\n perUser?: boolean;\n /** Custom URL identity. Default: original URL, including query. */\n key?: (req: Request) => string;\n}\ninterface Stored {\n status: number;\n json: string;\n headers: Record<string, string>;\n vary: string[];\n variant: string;\n}\nexport const RESPONSE_PREFIX = 'res:';\nconst representationHeaders = [\n 'content-type',\n 'cache-control',\n 'vary',\n 'content-language',\n 'content-disposition',\n 'etag',\n 'last-modified',\n];\nconst variant = (req: Request, names: string[]) =>\n createHash('sha256')\n .update(JSON.stringify(names.map((name) => [name, req.get(name) ?? null])))\n .digest('hex');\n\n/** Cache successful GET/HEAD JSON representations with method/user isolation. */\nexport function cacheResponse(options: number | CacheResponseOptions): RequestHandler {\n const opts: CacheResponseOptions = typeof options === 'number' ? { ttl: options } : options;\n return (req, res, next) => {\n if (req.method !== 'GET' && req.method !== 'HEAD') return next();\n let scope = '';\n if (opts.perUser) {\n const user = getCurrentUser();\n const id = user?.['sub'] ?? user?.['id'];\n if (typeof id !== 'string' && (typeof id !== 'number' || !Number.isFinite(id))) return next();\n scope = `u:${JSON.stringify([id])}:`;\n }\n // NUL cannot occur in an HTTP request URL. Keep URL-prefix invalidation while\n // preventing HEAD/GET and legacy-key collisions.\n const key =\n RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl) + '\\0' + req.method;\n void (async () => {\n const hit = await cache.get<Stored>(key);\n if (\n hit &&\n typeof hit.json === 'string' &&\n Array.isArray(hit.vary) &&\n hit.variant === variant(req, hit.vary)\n ) {\n res.set(hit.headers);\n res.setHeader('X-Cache', 'HIT');\n res.status(hit.status).send(hit.json);\n return;\n }\n res.setHeader('X-Cache', 'MISS');\n let captured = false;\n let snapshot = '';\n // Store the actual serialized JSON, not a mutable application object or a\n // different rendering that ignores Express's JSON replacer.\n const json = res.json.bind(res);\n res.json = (body: unknown) => {\n const send = res.send;\n const eligible = !res.headersSent && res.statusCode === 200;\n res.send = (rendered: unknown) => {\n if (eligible && typeof rendered === 'string') {\n try {\n JSON.parse(rendered);\n snapshot = rendered;\n captured = true;\n } catch {\n /* Not JSON. */\n }\n }\n return send.call(res, rendered);\n };\n try {\n return json(body);\n } finally {\n res.send = send;\n }\n };\n res.once('finish', () => {\n if (!captured || res.statusCode !== 200 || res.getHeader('set-cookie') !== undefined)\n return;\n const control = String(res.getHeader('cache-control') ?? '');\n if (\n /(?:^|,)\\s*(?:no-store|no-cache)(?:\\s|,|=|$)/i.test(control) ||\n (!opts.perUser && /(?:^|,)\\s*private(?:\\s|,|=|$)/i.test(control))\n )\n return;\n const vary = String(res.getHeader('vary') ?? '')\n .split(',')\n .map((name) => name.trim().toLowerCase())\n .filter(Boolean);\n if (vary.includes('*')) return;\n const headers: Record<string, string> = {};\n for (const name of representationHeaders) {\n const value = res.getHeader(name);\n if (value !== undefined)\n headers[name] = Array.isArray(value) ? value.join(', ') : String(value);\n }\n const stored: Stored = {\n status: 200,\n json: snapshot,\n headers,\n vary,\n variant: variant(req, vary),\n };\n void cache\n .set(key, stored, { ttl: opts.ttl })\n .catch((error) => getLogger().debug({ err: error }, 'Response cache write failed'));\n });\n next();\n })().catch(next);\n };\n}\n","import type { RequestHandler } from 'express';\n\n/**\n * Chains multiple Express request handlers into a single handler.\n * Each handler calls the next one via its `next` callback.\n *\n * @example\n * export const GET = compose(requireAuth, rateLimiter, myHandler);\n */\nexport function compose(...handlers: RequestHandler[]): RequestHandler {\n return (req, res, next) => {\n function dispatch(i: number): void {\n if (i >= handlers.length) {\n next();\n return;\n }\n const handler = handlers[i];\n if (!handler) {\n next();\n return;\n }\n try {\n Promise.resolve(\n handler(req, res, (err?: unknown) => (err ? next(err) : dispatch(i + 1))),\n ).catch(next);\n } catch (err) {\n next(err);\n }\n }\n\n dispatch(0);\n };\n}\n"],"mappings":"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","names":["fs","cluster","path","path","fs","cluster"]}