express-file-cluster 0.11.0 → 0.12.0

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 (133) 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-WHBSVYUY.cjs → chunk-4FQP6QX3.cjs} +3 -3
  8. package/dist/{chunk-WHBSVYUY.cjs.map → chunk-4FQP6QX3.cjs.map} +1 -1
  9. package/dist/chunk-546TNO2V.js +226 -0
  10. package/dist/chunk-546TNO2V.js.map +1 -0
  11. package/dist/{chunk-EJDZZ4KX.js → chunk-74R37C4I.js} +48 -21
  12. package/dist/chunk-74R37C4I.js.map +1 -0
  13. package/dist/{chunk-H2PVWCWC.cjs → chunk-A2QGDWCG.cjs} +15 -8
  14. package/dist/chunk-A2QGDWCG.cjs.map +1 -0
  15. package/dist/{chunk-O2E7H2XA.js → chunk-BCSJOPYH.js} +2 -2
  16. package/dist/{chunk-DGYPIIJE.cjs → chunk-BJR42CN3.cjs} +89 -62
  17. package/dist/chunk-BJR42CN3.cjs.map +1 -0
  18. package/dist/{chunk-OM2XJJWX.js → chunk-EBJELA7T.js} +30 -25
  19. package/dist/chunk-EBJELA7T.js.map +1 -0
  20. package/dist/{chunk-IEF6AEK3.cjs → chunk-H6MHRHUP.cjs} +104 -50
  21. package/dist/chunk-H6MHRHUP.cjs.map +1 -0
  22. package/dist/{chunk-6WTMRZS7.cjs → chunk-IG3V2IOK.cjs} +57 -30
  23. package/dist/chunk-IG3V2IOK.cjs.map +1 -0
  24. package/dist/chunk-JAPZYQVJ.cjs +143 -0
  25. package/dist/chunk-JAPZYQVJ.cjs.map +1 -0
  26. package/dist/{chunk-QSIP7YLW.cjs → chunk-JHCXIYJH.cjs} +25 -48
  27. package/dist/chunk-JHCXIYJH.cjs.map +1 -0
  28. package/dist/{chunk-GWMW6XY7.cjs → chunk-JVB5NLEM.cjs} +15 -13
  29. package/dist/chunk-JVB5NLEM.cjs.map +1 -0
  30. package/dist/{chunk-LECHRAU3.js → chunk-LIAGVWFQ.js} +83 -56
  31. package/dist/chunk-LIAGVWFQ.js.map +1 -0
  32. package/dist/chunk-PUM5ZDAH.js +140 -0
  33. package/dist/chunk-PUM5ZDAH.js.map +1 -0
  34. package/dist/{chunk-CGY7JU4Y.cjs → chunk-PUYBKDYD.cjs} +11 -2
  35. package/dist/chunk-PUYBKDYD.cjs.map +1 -0
  36. package/dist/{chunk-336IU55W.js → chunk-QLM3JEER.js} +5 -3
  37. package/dist/{chunk-336IU55W.js.map → chunk-QLM3JEER.js.map} +1 -1
  38. package/dist/{chunk-SOU3PBJC.cjs → chunk-SV4C4HWP.cjs} +89 -89
  39. package/dist/{chunk-SOU3PBJC.cjs.map → chunk-SV4C4HWP.cjs.map} +1 -1
  40. package/dist/{chunk-2IDRC7RK.js → chunk-UJ2ISRLP.js} +11 -34
  41. package/dist/chunk-UJ2ISRLP.js.map +1 -0
  42. package/dist/chunk-URKE3OXN.cjs +226 -0
  43. package/dist/chunk-URKE3OXN.cjs.map +1 -0
  44. package/dist/{chunk-DTMDJGRW.cjs → chunk-VLGN3XUM.cjs} +40 -35
  45. package/dist/chunk-VLGN3XUM.cjs.map +1 -0
  46. package/dist/{chunk-R6GPQZLI.js → chunk-X2B7WBKH.js} +88 -34
  47. package/dist/chunk-X2B7WBKH.js.map +1 -0
  48. package/dist/chunk-Y7I2633P.js +12 -0
  49. package/dist/chunk-Y7I2633P.js.map +1 -0
  50. package/dist/{chunk-B6MB6HEG.js → chunk-ZBQUYFI3.js} +14 -7
  51. package/dist/chunk-ZBQUYFI3.js.map +1 -0
  52. package/dist/cli/db-runner.cjs +26 -25
  53. package/dist/cli/db-runner.cjs.map +1 -1
  54. package/dist/cli/db-runner.js +5 -3
  55. package/dist/cli/db-runner.js.map +1 -1
  56. package/dist/cli/index.cjs +16 -15
  57. package/dist/cli/index.cjs.map +1 -1
  58. package/dist/cli/index.js +9 -7
  59. package/dist/cli/index.js.map +1 -1
  60. package/dist/docs/api-reference/auth.md +2 -0
  61. package/dist/docs/api-reference/ignite.md +2 -0
  62. package/dist/docs/api-reference/tasks.md +5 -1
  63. package/dist/docs/api-reference/testing.md +2 -0
  64. package/dist/docs/api-reference/tracing.md +18 -0
  65. package/dist/docs/cli/add.md +1 -1
  66. package/dist/docs/core-concepts/background-tasks.md +5 -1
  67. package/dist/docs/core-concepts/file-based-routing.md +2 -0
  68. package/dist/docs/core-concepts/middleware.md +2 -0
  69. package/dist/docs/guides/caching.md +12 -0
  70. package/dist/docs/guides/error-handling.md +2 -0
  71. package/dist/docs/guides/feature-matrix.md +7 -0
  72. package/dist/docs/guides/logging.md +2 -0
  73. package/dist/docs/guides/tracing.md +64 -0
  74. package/dist/docs/index.md +2 -1
  75. package/dist/docs/skills/SKILL.md +5 -3
  76. package/dist/docs/skills/api-surface.md +8 -0
  77. package/dist/docs/skills/auth-internals.md +4 -2
  78. package/dist/docs/skills/pre-flight.md +4 -0
  79. package/dist/docs/skills/routing-rules.md +2 -0
  80. package/dist/docs/skills/tasks-internals.md +10 -2
  81. package/dist/docs/skills/what-not-to-invent.md +2 -0
  82. package/dist/index.cjs +163 -70
  83. package/dist/index.cjs.map +1 -1
  84. package/dist/index.d.cts +5 -14
  85. package/dist/index.d.ts +5 -14
  86. package/dist/index.js +120 -26
  87. package/dist/index.js.map +1 -1
  88. package/dist/pgboss-backend-5DXF4G22.js +16 -0
  89. package/dist/pgboss-backend-KRTFHRNZ.cjs +16 -0
  90. package/dist/pgboss-backend-KRTFHRNZ.cjs.map +1 -0
  91. package/dist/registry/index.json +1 -1
  92. package/dist/tasks/index.cjs +3 -3
  93. package/dist/tasks/index.d.cts +2 -2
  94. package/dist/tasks/index.d.ts +2 -2
  95. package/dist/tasks/index.js +2 -1
  96. package/dist/testing.cjs +16 -14
  97. package/dist/testing.cjs.map +1 -1
  98. package/dist/testing.d.cts +2 -1
  99. package/dist/testing.d.ts +2 -1
  100. package/dist/testing.js +10 -7
  101. package/dist/testing.js.map +1 -1
  102. package/dist/thread-runner.cjs +5 -4
  103. package/dist/thread-runner.cjs.map +1 -1
  104. package/dist/thread-runner.d.cts +1 -1
  105. package/dist/thread-runner.d.ts +1 -1
  106. package/dist/thread-runner.js +4 -2
  107. package/dist/{types-D3QmZgeX.d.ts → types-Bgeqpm-n.d.cts} +12 -1
  108. package/dist/{types-D3QmZgeX.d.cts → types-Bgeqpm-n.d.ts} +12 -1
  109. package/package.json +7 -3
  110. package/dist/chunk-2IDRC7RK.js.map +0 -1
  111. package/dist/chunk-3SWI46YK.js +0 -74
  112. package/dist/chunk-3SWI46YK.js.map +0 -1
  113. package/dist/chunk-6WTMRZS7.cjs.map +0 -1
  114. package/dist/chunk-B6MB6HEG.js.map +0 -1
  115. package/dist/chunk-CGY7JU4Y.cjs.map +0 -1
  116. package/dist/chunk-DGYPIIJE.cjs.map +0 -1
  117. package/dist/chunk-DTMDJGRW.cjs.map +0 -1
  118. package/dist/chunk-EJDZZ4KX.js.map +0 -1
  119. package/dist/chunk-GWMW6XY7.cjs.map +0 -1
  120. package/dist/chunk-H2PVWCWC.cjs.map +0 -1
  121. package/dist/chunk-IEF6AEK3.cjs.map +0 -1
  122. package/dist/chunk-LECHRAU3.js.map +0 -1
  123. package/dist/chunk-OM2XJJWX.js.map +0 -1
  124. package/dist/chunk-QSIP7YLW.cjs.map +0 -1
  125. package/dist/chunk-R6GPQZLI.js.map +0 -1
  126. package/dist/chunk-RPL2IFWK.cjs +0 -77
  127. package/dist/chunk-RPL2IFWK.cjs.map +0 -1
  128. package/dist/pgboss-backend-PQW6I3VF.js +0 -14
  129. package/dist/pgboss-backend-QVXISTLP.cjs +0 -15
  130. package/dist/pgboss-backend-QVXISTLP.cjs.map +0 -1
  131. /package/dist/{chunk-JBOMTZT5.js.map → chunk-3JQWQF2M.js.map} +0 -0
  132. /package/dist/{chunk-O2E7H2XA.js.map → chunk-BCSJOPYH.js.map} +0 -0
  133. /package/dist/{pgboss-backend-PQW6I3VF.js.map → pgboss-backend-5DXF4G22.js.map} +0 -0
package/dist/index.cjs CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
 
8
8
 
9
- var _chunkDGYPIIJEcjs = require('./chunk-DGYPIIJE.cjs');
9
+ var _chunkBJR42CN3cjs = require('./chunk-BJR42CN3.cjs');
10
10
 
11
11
 
12
12
 
@@ -15,14 +15,14 @@ var _chunkDGYPIIJEcjs = require('./chunk-DGYPIIJE.cjs');
15
15
 
16
16
 
17
17
 
18
- var _chunkIEF6AEK3cjs = require('./chunk-IEF6AEK3.cjs');
18
+ var _chunkH6MHRHUPcjs = require('./chunk-H6MHRHUP.cjs');
19
19
 
20
20
 
21
- var _chunkWHBSVYUYcjs = require('./chunk-WHBSVYUY.cjs');
21
+ var _chunk4FQP6QX3cjs = require('./chunk-4FQP6QX3.cjs');
22
22
 
23
23
 
24
24
 
25
- var _chunkDTMDJGRWcjs = require('./chunk-DTMDJGRW.cjs');
25
+ var _chunkVLGN3XUMcjs = require('./chunk-VLGN3XUM.cjs');
26
26
 
27
27
 
28
28
 
@@ -32,12 +32,12 @@ var _chunkDTMDJGRWcjs = require('./chunk-DTMDJGRW.cjs');
32
32
 
33
33
 
34
34
 
35
- var _chunkSOU3PBJCcjs = require('./chunk-SOU3PBJC.cjs');
35
+ var _chunkSV4C4HWPcjs = require('./chunk-SV4C4HWP.cjs');
36
36
 
37
37
 
38
38
 
39
39
 
40
- var _chunkGWMW6XY7cjs = require('./chunk-GWMW6XY7.cjs');
40
+ var _chunkJVB5NLEMcjs = require('./chunk-JVB5NLEM.cjs');
41
41
 
42
42
 
43
43
 
@@ -45,12 +45,12 @@ var _chunkAGOYTFROcjs = require('./chunk-AGOYTFRO.cjs');
45
45
 
46
46
 
47
47
 
48
- var _chunk6WTMRZS7cjs = require('./chunk-6WTMRZS7.cjs');
49
- require('./chunk-RPL2IFWK.cjs');
48
+ var _chunkIG3V2IOKcjs = require('./chunk-IG3V2IOK.cjs');
49
+ require('./chunk-JAPZYQVJ.cjs');
50
50
 
51
51
 
52
52
 
53
- var _chunkH2PVWCWCcjs = require('./chunk-H2PVWCWC.cjs');
53
+ var _chunkA2QGDWCGcjs = require('./chunk-A2QGDWCG.cjs');
54
54
 
55
55
 
56
56
 
@@ -60,9 +60,31 @@ var _chunkH2PVWCWCcjs = require('./chunk-H2PVWCWC.cjs');
60
60
 
61
61
 
62
62
 
63
+ var _chunkJHCXIYJHcjs = require('./chunk-JHCXIYJH.cjs');
63
64
 
64
- var _chunkQSIP7YLWcjs = require('./chunk-QSIP7YLW.cjs');
65
- require('./chunk-CGY7JU4Y.cjs');
65
+
66
+
67
+
68
+ var _chunkURKE3OXNcjs = require('./chunk-URKE3OXN.cjs');
69
+ require('./chunk-PUYBKDYD.cjs');
70
+
71
+ // src/shutdown.ts
72
+ async function drainServices(options) {
73
+ const errors = [];
74
+ const outcomes = await Promise.allSettled([
75
+ ...options.transports,
76
+ ...options.tasks.map((close) => Promise.resolve().then(close))
77
+ ]);
78
+ for (const outcome of outcomes) if (outcome.status === "rejected") errors.push(outcome.reason);
79
+ for (const close of [options.cache, options.tracing]) {
80
+ try {
81
+ await close();
82
+ } catch (error) {
83
+ errors.push(error);
84
+ }
85
+ }
86
+ if (errors.length) throw new AggregateError(errors, "Service shutdown failed");
87
+ }
66
88
 
67
89
  // src/index.ts
68
90
  var _http = require('http'); var _http2 = _interopRequireDefault(_http);
@@ -80,7 +102,7 @@ function workerCount() {
80
102
  }
81
103
  function shutdownMaster() {
82
104
  isShuttingDown = true;
83
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).info(`Cluster primary (pid=${process.pid}) shutting down, waiting for workers\u2026`);
105
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info(`Cluster primary (pid=${process.pid}) shutting down, waiting for workers\u2026`);
84
106
  if (workerCount() === 0) process.exit(0);
85
107
  for (const worker of Object.values(_nullishCoalesce(_cluster2.default.workers, () => ( {})))) {
86
108
  _optionalChain([worker, 'optionalAccess', _ => _.process, 'access', _2 => _2.kill, 'call', _3 => _3("SIGTERM")]);
@@ -88,7 +110,7 @@ function shutdownMaster() {
88
110
  }
89
111
  function runMaster(options = {}) {
90
112
  const count = _nullishCoalesce(options.workers, () => ( 1));
91
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).info(`Primary ${process.pid} starting ${count} workers`);
113
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info(`Primary ${process.pid} starting ${count} workers`);
92
114
  for (let i = 0; i < count; i++) {
93
115
  _cluster2.default.fork();
94
116
  }
@@ -98,14 +120,14 @@ function runMaster(options = {}) {
98
120
  _cluster2.default.on("exit", (worker, code, signal) => {
99
121
  const exitCode = _nullishCoalesce(code, () => ( (signal ? -1 : 0)));
100
122
  if (isShuttingDown) {
101
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).info(`Worker ${worker.id} gracefully exited`);
123
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info(`Worker ${worker.id} gracefully exited`);
102
124
  if (workerCount() === 0) {
103
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).info("All workers exited. Primary exiting.");
125
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info("All workers exited. Primary exiting.");
104
126
  process.exit(0);
105
127
  }
106
128
  return;
107
129
  }
108
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).warn(`Worker ${worker.id} exited (code=${exitCode}), respawning\u2026`);
130
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).warn(`Worker ${worker.id} exited (code=${exitCode}), respawning\u2026`);
109
131
  _optionalChain([options, 'access', _6 => _6.onWorkerCrash, 'optionalCall', _7 => _7(worker.id, exitCode)]);
110
132
  _cluster2.default.fork();
111
133
  });
@@ -124,13 +146,13 @@ async function scanTasks(tasksDir) {
124
146
  const mod = await Promise.resolve().then(() => _interopRequireWildcard(require(filePath)));
125
147
  const def = mod["default"];
126
148
  if (!def || typeof def.handler !== "function") {
127
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).warn(`Task file ${file} has no valid default export \u2014 skipping`);
149
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).warn(`Task file ${file} has no valid default export \u2014 skipping`);
128
150
  continue;
129
151
  }
130
- _chunkH2PVWCWCcjs.registerTask.call(void 0, taskName, { ...def, filePath });
131
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).debug(`Registered task: ${taskName}`);
152
+ _chunkA2QGDWCGcjs.registerTask.call(void 0, taskName, { ...def, filePath });
153
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).debug(`Registered task: ${taskName}`);
132
154
  } catch (err) {
133
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).warn({ err }, `Failed to load task ${file}`);
155
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).warn({ err }, `Failed to load task ${file}`);
134
156
  }
135
157
  }
136
158
  }
@@ -736,18 +758,19 @@ function generateDashboard(routes, basePath, port, projectName, projectVersion)
736
758
  // src/rate-limit.ts
737
759
  var UNITS = { s: 1, m: 60, h: 3600, d: 86400 };
738
760
  function parseWindow(window) {
739
- if (typeof window === "number") {
740
- if (window > 0) return window;
741
- } else {
742
- const m = /^(\d+(?:\.\d+)?)\s*(s|m|h|d)$/.exec(window.trim());
743
- if (m) return Number(m[1]) * UNITS[m[2]];
761
+ let seconds = typeof window === "number" ? window : NaN;
762
+ if (typeof window === "string") {
763
+ const match = /^(\d+(?:\.\d+)?)\s*(s|m|h|d)$/.exec(window.trim());
764
+ if (match) seconds = Number(match[1]) * UNITS[match[2]];
744
765
  }
766
+ if (Number.isFinite(seconds) && seconds * 1e3 >= 1 && seconds * 1e3 <= Number.MAX_SAFE_INTEGER)
767
+ return seconds;
745
768
  throw new Error(`[EFC] rateLimit: window must be seconds or like '15m' \u2014 got ${String(window)}`);
746
769
  }
747
770
  var lastCacheError = 0;
748
771
  function rateLimit(options) {
749
772
  const windowSeconds = parseWindow(options.window);
750
- if (!Number.isInteger(options.max) || options.max < 1) {
773
+ if (!Number.isSafeInteger(options.max) || options.max < 1) {
751
774
  throw new Error("[EFC] rateLimit: max must be a positive integer");
752
775
  }
753
776
  const keyOf = _nullishCoalesce(options.key, () => ( ((req) => _nullishCoalesce(req.ip, () => ( req.socket.remoteAddress)))));
@@ -757,7 +780,7 @@ function rateLimit(options) {
757
780
  void (async () => {
758
781
  const who = keyOf(req);
759
782
  if (who === void 0) return next();
760
- if (!_chunkIEF6AEK3cjs.isCacheConfigured.call(void 0, )) {
783
+ if (!_chunkH6MHRHUPcjs.isCacheConfigured.call(void 0, )) {
761
784
  throw new Error("[EFC] rateLimit needs a cache \u2014 pass cache: { backend } to ignite()");
762
785
  }
763
786
  const bucket = _nullishCoalesce(options.name, () => ( req.baseUrl + (_nullishCoalesce(_optionalChain([req, 'access', _8 => _8.route, 'optionalAccess', _9 => _9.path]), () => ( req.path)))));
@@ -767,11 +790,14 @@ function rateLimit(options) {
767
790
  const resetMs = (slot + 1) * windowMs - now;
768
791
  let count;
769
792
  try {
770
- count = (await _chunkIEF6AEK3cjs.rawIncr.call(void 0, `rl:${bucket}:${who}:${slot}`, Math.ceil(resetMs / 1e3) + 1)).value;
793
+ count = (await _chunkH6MHRHUPcjs.rawIncr.call(void 0,
794
+ `rl:${JSON.stringify([String(bucket), who, slot])}`,
795
+ Math.ceil(resetMs / 1e3) + 1
796
+ )).value;
771
797
  } catch (err) {
772
798
  if (Date.now() - lastCacheError > 3e4) {
773
799
  lastCacheError = Date.now();
774
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).error(
800
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).error(
775
801
  { err },
776
802
  `rateLimit: cache unavailable \u2014 ${options.onCacheError === "reject" ? "rejecting with 503" : "allowing requests"}`
777
803
  );
@@ -799,32 +825,85 @@ function rateLimit(options) {
799
825
  }
800
826
 
801
827
  // src/cache/response.ts
828
+ var _crypto = require('crypto');
802
829
  var RESPONSE_PREFIX = "res:";
830
+ var representationHeaders = [
831
+ "content-type",
832
+ "cache-control",
833
+ "vary",
834
+ "content-language",
835
+ "content-disposition",
836
+ "etag",
837
+ "last-modified"
838
+ ];
839
+ var variant = (req, names) => _crypto.createHash.call(void 0, "sha256").update(JSON.stringify(names.map((name) => [name, _nullishCoalesce(req.get(name), () => ( null))]))).digest("hex");
803
840
  function cacheResponse(options) {
804
841
  const opts = typeof options === "number" ? { ttl: options } : options;
805
842
  return (req, res, next) => {
806
843
  if (req.method !== "GET" && req.method !== "HEAD") return next();
807
844
  let scope = "";
808
845
  if (opts.perUser) {
809
- const user = _chunkQSIP7YLWcjs.getCurrentUser.call(void 0, );
846
+ const user = _chunkURKE3OXNcjs.getCurrentUser.call(void 0, );
810
847
  const id = _nullishCoalesce(_optionalChain([user, 'optionalAccess', _10 => _10["sub"]]), () => ( _optionalChain([user, 'optionalAccess', _11 => _11["id"]])));
811
- if (id === void 0) return next();
812
- scope = `u:${String(id)}:`;
848
+ if (typeof id !== "string" && (typeof id !== "number" || !Number.isFinite(id))) return next();
849
+ scope = `u:${JSON.stringify([id])}:`;
813
850
  }
814
- const key = RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl);
851
+ const key = RESPONSE_PREFIX + scope + (opts.key ? opts.key(req) : req.originalUrl) + "\0" + req.method;
815
852
  void (async () => {
816
- const hit = await _chunkIEF6AEK3cjs.cache.get(key);
817
- if (hit) {
853
+ const hit = await _chunkH6MHRHUPcjs.cache.get(key);
854
+ if (hit && typeof hit.json === "string" && Array.isArray(hit.vary) && hit.variant === variant(req, hit.vary)) {
855
+ res.set(hit.headers);
818
856
  res.setHeader("X-Cache", "HIT");
819
- res.status(hit.status).json(hit.body);
857
+ res.status(hit.status).send(hit.json);
820
858
  return;
821
859
  }
822
860
  res.setHeader("X-Cache", "MISS");
861
+ let captured = false;
862
+ let snapshot = "";
823
863
  const json = res.json.bind(res);
824
864
  res.json = (body) => {
825
- if (res.statusCode === 200) void _chunkIEF6AEK3cjs.cache.set(key, { status: 200, body }, { ttl: opts.ttl });
826
- return json(body);
865
+ const send = res.send;
866
+ const eligible = !res.headersSent && res.statusCode === 200;
867
+ res.send = (rendered) => {
868
+ if (eligible && typeof rendered === "string") {
869
+ try {
870
+ JSON.parse(rendered);
871
+ snapshot = rendered;
872
+ captured = true;
873
+ } catch (e) {
874
+ }
875
+ }
876
+ return send.call(res, rendered);
877
+ };
878
+ try {
879
+ return json(body);
880
+ } finally {
881
+ res.send = send;
882
+ }
827
883
  };
884
+ res.once("finish", () => {
885
+ if (!captured || res.statusCode !== 200 || res.getHeader("set-cookie") !== void 0)
886
+ return;
887
+ const control = String(_nullishCoalesce(res.getHeader("cache-control"), () => ( "")));
888
+ if (/(?:^|,)\s*(?:no-store|no-cache)(?:\s|,|=|$)/i.test(control) || !opts.perUser && /(?:^|,)\s*private(?:\s|,|=|$)/i.test(control))
889
+ return;
890
+ const vary = String(_nullishCoalesce(res.getHeader("vary"), () => ( ""))).split(",").map((name) => name.trim().toLowerCase()).filter(Boolean);
891
+ if (vary.includes("*")) return;
892
+ const headers = {};
893
+ for (const name of representationHeaders) {
894
+ const value = res.getHeader(name);
895
+ if (value !== void 0)
896
+ headers[name] = Array.isArray(value) ? value.join(", ") : String(value);
897
+ }
898
+ const stored = {
899
+ status: 200,
900
+ json: snapshot,
901
+ headers,
902
+ vary,
903
+ variant: variant(req, vary)
904
+ };
905
+ void _chunkH6MHRHUPcjs.cache.set(key, stored, { ttl: opts.ttl }).catch((error) => _chunkJHCXIYJHcjs.getLogger.call(void 0, ).debug({ err: error }, "Response cache write failed"));
906
+ });
828
907
  next();
829
908
  })().catch(next);
830
909
  };
@@ -881,7 +960,7 @@ async function ignite(config) {
881
960
  const raw = _fs2.default.readFileSync(_path2.default.join(process.cwd(), "package.json"), "utf8");
882
961
  const pkg = JSON.parse(raw);
883
962
  return { name: _nullishCoalesce(pkg.name, () => ( "API")), version: _nullishCoalesce(pkg.version, () => ( "")) };
884
- } catch (e) {
963
+ } catch (e2) {
885
964
  return { name: "API", version: "" };
886
965
  }
887
966
  }
@@ -891,21 +970,22 @@ async function ignite(config) {
891
970
  const jwtSecret = config.jwtSecret;
892
971
  const authStrategy = _nullishCoalesce(config.authStrategy, () => ( "http-only"));
893
972
  const clusterEnabled = _nullishCoalesce(config.cluster, () => ( process.env["NODE_ENV"] === "production"));
894
- _chunkQSIP7YLWcjs.configureLogger.call(void 0, config.logging);
973
+ _chunkJHCXIYJHcjs.configureLogger.call(void 0, config.logging);
895
974
  if (!["http-only", "bearer", "localStorage"].includes(authStrategy) && (!clusterEnabled || _cluster2.default.isPrimary)) {
896
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).warn(
975
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).warn(
897
976
  `[EFC] Unknown authStrategy "${String(authStrategy)}" \u2014 treated as 'bearer'. Use 'http-only' or 'bearer'; this will be an error in 1.0.`
898
977
  );
899
978
  }
900
979
  if (jwtSecret && Buffer.byteLength(jwtSecret) < 32 && process.env["NODE_ENV"] === "production" && (!clusterEnabled || _cluster2.default.isPrimary)) {
901
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).warn(
980
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).warn(
902
981
  `[EFC] jwtSecret is ${Buffer.byteLength(jwtSecret)} bytes \u2014 use at least 32 random bytes in production (openssl rand -hex 64).`
903
982
  );
904
983
  }
905
- _chunkQSIP7YLWcjs.configureQueryLog.call(void 0, config.logging);
984
+ _chunkJHCXIYJHcjs.configureQueryLog.call(void 0, config.logging);
985
+ _chunkURKE3OXNcjs.configureTracing.call(void 0, config.tracing);
906
986
  if (clusterEnabled && _cluster2.default.isPrimary) {
907
987
  if (config.cache && config.cache.backend === "memory") {
908
- _chunkIEF6AEK3cjs.servePrimaryCache.call(void 0, _nullishCoalesce(config.cache.maxEntries, () => ( 1e4)));
988
+ _chunkH6MHRHUPcjs.servePrimaryCache.call(void 0, _nullishCoalesce(config.cache.maxEntries, () => ( 1e4)));
909
989
  }
910
990
  runMaster({
911
991
  workers: _nullishCoalesce(workers, () => ( _os2.default.cpus().length)),
@@ -914,35 +994,35 @@ async function ignite(config) {
914
994
  });
915
995
  return;
916
996
  }
917
- const app = _chunkDGYPIIJEcjs.createHttpApp.call(void 0, config);
918
- if (database) _chunkGWMW6XY7cjs.setDbEngine.call(void 0, database);
919
- _chunkGWMW6XY7cjs.setAutoSync.call(void 0, _nullishCoalesce(config.autoSync, () => ( true)));
997
+ const app = _chunkBJR42CN3cjs.createHttpApp.call(void 0, config);
998
+ if (database) _chunkJVB5NLEMcjs.setDbEngine.call(void 0, database);
999
+ _chunkJVB5NLEMcjs.setAutoSync.call(void 0, _nullishCoalesce(config.autoSync, () => ( true)));
920
1000
  const poolWorkers = clusterEnabled ? _nullishCoalesce(workers, () => ( _os2.default.cpus().length)) : 1;
921
1001
  const reportsPools = !clusterEnabled || _optionalChain([_cluster2.default, 'access', _12 => _12.worker, 'optionalAccess', _13 => _13.id]) === 1;
922
1002
  if (database === "mongodb" && databaseUrl) {
923
- const conn = await _chunkSOU3PBJCcjs.connectMongo.call(void 0, databaseUrl, config.databasePool);
924
- _chunkSOU3PBJCcjs.setDbClient.call(void 0, conn);
1003
+ const conn = await _chunkSV4C4HWPcjs.connectMongo.call(void 0, databaseUrl, config.databasePool);
1004
+ _chunkSV4C4HWPcjs.setDbClient.call(void 0, conn);
925
1005
  if (reportsPools) {
926
1006
  const max = _nullishCoalesce(_optionalChain([config, 'access', _14 => _14.databasePool, 'optionalAccess', _15 => _15.max]), () => ( 100));
927
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).info(
1007
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info(
928
1008
  `MongoDB connections: up to ${poolWorkers * max} from this machine (${poolWorkers} worker(s) \xD7 maxPoolSize ${max})`
929
1009
  );
930
1010
  }
931
1011
  } else if (database === "postgresql" && databaseUrl) {
932
- const pool = await _chunkQSIP7YLWcjs.connectPostgres.call(void 0, databaseUrl, config.databasePool);
933
- _chunkSOU3PBJCcjs.setDbClient.call(void 0, pool);
1012
+ const pool = await _chunkJHCXIYJHcjs.connectPostgres.call(void 0, databaseUrl, config.databasePool);
1013
+ _chunkSV4C4HWPcjs.setDbClient.call(void 0, pool);
934
1014
  if (reportsPools) {
935
1015
  const max = _nullishCoalesce(_optionalChain([config, 'access', _16 => _16.databasePool, 'optionalAccess', _17 => _17.max]), () => ( 10));
936
1016
  const boss = config.tasks && config.tasks.backend === "pg-boss" && !config.tasks.connectionString ? 10 : 0;
937
1017
  const breakdown = `${poolWorkers} worker(s) \xD7 (pool ${max}${boss ? ` + pg-boss ${boss}` : ""})`;
938
- await _chunkQSIP7YLWcjs.checkConnectionBudget.call(void 0, poolWorkers * (max + boss), breakdown);
1018
+ await _chunkJHCXIYJHcjs.checkConnectionBudget.call(void 0, poolWorkers * (max + boss), breakdown);
939
1019
  }
940
1020
  }
941
1021
  if (config.cache) {
942
- await _chunkIEF6AEK3cjs.configureCache.call(void 0, config.cache);
1022
+ await _chunkH6MHRHUPcjs.configureCache.call(void 0, config.cache);
943
1023
  }
944
1024
  if (jwtSecret) {
945
- _chunkIEF6AEK3cjs.configureAuth.call(void 0, {
1025
+ _chunkH6MHRHUPcjs.configureAuth.call(void 0, {
946
1026
  secret: jwtSecret,
947
1027
  strategy: authStrategy,
948
1028
  expiresIn: _nullishCoalesce(config.jwtExpiresIn, () => ( "7d")),
@@ -954,7 +1034,8 @@ async function ignite(config) {
954
1034
  }
955
1035
  if (config.tasks) {
956
1036
  if (config.tasks.backend === "bullmq") {
957
- await _chunkDTMDJGRWcjs.initBullMQ.call(void 0, {
1037
+ await _chunkVLGN3XUMcjs.initBullMQ.call(void 0, {
1038
+ tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),
958
1039
  redisUrl: _nullishCoalesce(config.tasks.redisUrl, () => ( "redis://localhost:6379")),
959
1040
  concurrency: _nullishCoalesce(config.tasks.concurrency, () => ( 5)),
960
1041
  enqueueTimeout: _nullishCoalesce(config.tasks.enqueueTimeout, () => ( 5e3)),
@@ -967,7 +1048,8 @@ async function ignite(config) {
967
1048
  '[EFC] tasks.backend "pg-boss" needs tasks.connectionString or databaseUrl'
968
1049
  );
969
1050
  }
970
- await _chunk6WTMRZS7cjs.initPgBoss.call(void 0, {
1051
+ await _chunkIG3V2IOKcjs.initPgBoss.call(void 0, {
1052
+ tracing: !!config.tracing && (config.tracing === true || config.tracing.tasks !== false),
971
1053
  connectionString,
972
1054
  concurrency: _nullishCoalesce(config.tasks.concurrency, () => ( 5)),
973
1055
  enqueueTimeout: _nullishCoalesce(config.tasks.enqueueTimeout, () => ( 5e3)),
@@ -976,13 +1058,13 @@ async function ignite(config) {
976
1058
  });
977
1059
  }
978
1060
  }
979
- const routes = _chunkWHBSVYUYcjs.scanDir.call(void 0, apiDir);
1061
+ const routes = _chunk4FQP6QX3cjs.scanDir.call(void 0, apiDir);
980
1062
  const apiRouter = _express2.default.Router();
981
- const mounted = await _chunkDGYPIIJEcjs.mountRoutes.call(void 0, apiRouter, routes);
1063
+ const mounted = await _chunkBJR42CN3cjs.mountRoutes.call(void 0, apiRouter, routes);
982
1064
  if (config.openapi) {
983
1065
  const meta = readProjectMeta();
984
1066
  const options = config.openapi === true ? {} : config.openapi;
985
- await _chunkDGYPIIJEcjs.mountOpenAPI.call(void 0, app, mounted, {
1067
+ await _chunkBJR42CN3cjs.mountOpenAPI.call(void 0, app, mounted, {
986
1068
  info: { title: meta.name, version: meta.version },
987
1069
  ...options,
988
1070
  basePath
@@ -996,15 +1078,15 @@ async function ignite(config) {
996
1078
  res.send(generateDashboard(mounted, basePath, port, name, version));
997
1079
  });
998
1080
  }
999
- _chunkDGYPIIJEcjs.mountErrorHandler.call(void 0, app, onError);
1081
+ _chunkBJR42CN3cjs.mountErrorHandler.call(void 0, app, onError);
1000
1082
  return new Promise((resolve, reject) => {
1001
1083
  const server = _http2.default.createServer(app);
1002
1084
  if (config.websocket !== false && mounted.some((route) => route.websocket))
1003
- _chunkDGYPIIJEcjs.attachWebSockets.call(void 0, server, app, config.websocket);
1085
+ _chunkBJR42CN3cjs.attachWebSockets.call(void 0, server, app, config.websocket);
1004
1086
  server.once("listening", () => {
1005
1087
  const wid = _nullishCoalesce(_optionalChain([_cluster2.default, 'access', _18 => _18.worker, 'optionalAccess', _19 => _19.id]), () => ( "primary"));
1006
1088
  const addr = server.address();
1007
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).info(`Worker ${wid} listening on :${_nullishCoalesce(_optionalChain([addr, 'optionalAccess', _20 => _20.port]), () => ( port))}`);
1089
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info(`Worker ${wid} listening on :${_nullishCoalesce(_optionalChain([addr, 'optionalAccess', _20 => _20.port]), () => ( port))}`);
1008
1090
  resolve(server);
1009
1091
  });
1010
1092
  server.once("error", reject);
@@ -1016,22 +1098,33 @@ function gracefulShutdown(server, timeoutMs = 1e4) {
1016
1098
  const shutdown = (signal) => {
1017
1099
  if (shuttingDown) return;
1018
1100
  shuttingDown = true;
1019
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).info(`${signal} received \u2014 closing server gracefully\u2026`);
1101
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info(`${signal} received \u2014 closing server gracefully\u2026`);
1020
1102
  if (server) {
1021
- const websocketDrain = _chunkDGYPIIJEcjs.closeWebSockets.call(void 0, server, Math.max(1, Math.min(1e3, timeoutMs / 2)));
1103
+ const websocketDrain = _chunkBJR42CN3cjs.closeWebSockets.call(void 0, server, Math.max(1, Math.min(1e3, timeoutMs / 2)));
1022
1104
  server.closeIdleConnections();
1023
1105
  server.close(() => {
1024
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).info("Server closed");
1025
- Promise.all([websocketDrain, _chunkDTMDJGRWcjs.closeBullMQ.call(void 0, ), _chunk6WTMRZS7cjs.closePgBoss.call(void 0, ), _chunkIEF6AEK3cjs.closeCache.call(void 0, )]).catch((err) => _chunkQSIP7YLWcjs.getLogger.call(void 0, ).error({ err }, "Task backend close failed")).finally(() => process.exit(0));
1106
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info("Server closed");
1107
+ drainServices({
1108
+ transports: [websocketDrain],
1109
+ tasks: [_chunkVLGN3XUMcjs.closeBullMQ, _chunkIG3V2IOKcjs.closePgBoss],
1110
+ cache: _chunkH6MHRHUPcjs.closeCache,
1111
+ tracing: _chunkURKE3OXNcjs.shutdownTracing
1112
+ }).then(
1113
+ () => process.exit(0),
1114
+ (err) => {
1115
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).error({ err }, "Service shutdown failed");
1116
+ process.exit(1);
1117
+ }
1118
+ );
1026
1119
  });
1027
1120
  setTimeout(() => {
1028
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).error("Forced exit after timeout");
1121
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).error("Forced exit after timeout");
1029
1122
  process.exit(1);
1030
1123
  }, timeoutMs).unref();
1031
1124
  } else {
1032
1125
  shutdownMaster();
1033
1126
  setTimeout(() => {
1034
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).error("Workers did not exit in time \u2014 forcing primary exit");
1127
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).error("Workers did not exit in time \u2014 forcing primary exit");
1035
1128
  process.exit(1);
1036
1129
  }, timeoutMs + 2e3).unref();
1037
1130
  }
@@ -1066,6 +1159,6 @@ function gracefulShutdown(server, timeoutMs = 1e4) {
1066
1159
 
1067
1160
 
1068
1161
 
1069
- exports.HttpError = _chunkAGOYTFROcjs.HttpError; exports.ModelValidationError = _chunkGWMW6XY7cjs.ModelValidationError; exports.attachWebSockets = _chunkDGYPIIJEcjs.attachWebSockets; exports.cache = _chunkIEF6AEK3cjs.cache; exports.cacheResponse = cacheResponse; exports.closeWebSockets = _chunkDGYPIIJEcjs.closeWebSockets; exports.compose = compose; exports.db = _chunkSOU3PBJCcjs.db; exports.defineCollection = _chunkSOU3PBJCcjs.defineCollection; exports.defineModel = _chunkSOU3PBJCcjs.defineModel; exports.defineTable = _chunkSOU3PBJCcjs.defineTable; exports.generateOpenAPI = _chunkDGYPIIJEcjs.generateOpenAPI; exports.getDbClient = _chunkSOU3PBJCcjs.getDbClient; exports.getLogger = _chunkQSIP7YLWcjs.getLogger; exports.getQueryMetrics = _chunkQSIP7YLWcjs.getQueryMetrics; exports.gracefulShutdown = gracefulShutdown; exports.ignite = ignite; exports.isHttpError = _chunkAGOYTFROcjs.isHttpError; exports.listTasks = _chunkH2PVWCWCcjs.listTasks; exports.logger = _chunkQSIP7YLWcjs.logger; exports.rateLimit = rateLimit; exports.resetQueryMetrics = _chunkQSIP7YLWcjs.resetQueryMetrics; exports.scanDir = _chunkWHBSVYUYcjs.scanDir; exports.setDbClient = _chunkSOU3PBJCcjs.setDbClient; exports.transaction = _chunkSOU3PBJCcjs.transaction; exports.workerCount = workerCount;
1162
+ exports.HttpError = _chunkAGOYTFROcjs.HttpError; exports.ModelValidationError = _chunkJVB5NLEMcjs.ModelValidationError; exports.attachWebSockets = _chunkBJR42CN3cjs.attachWebSockets; exports.cache = _chunkH6MHRHUPcjs.cache; exports.cacheResponse = cacheResponse; exports.closeWebSockets = _chunkBJR42CN3cjs.closeWebSockets; exports.compose = compose; exports.db = _chunkSV4C4HWPcjs.db; exports.defineCollection = _chunkSV4C4HWPcjs.defineCollection; exports.defineModel = _chunkSV4C4HWPcjs.defineModel; exports.defineTable = _chunkSV4C4HWPcjs.defineTable; exports.generateOpenAPI = _chunkBJR42CN3cjs.generateOpenAPI; exports.getDbClient = _chunkSV4C4HWPcjs.getDbClient; exports.getLogger = _chunkJHCXIYJHcjs.getLogger; exports.getQueryMetrics = _chunkJHCXIYJHcjs.getQueryMetrics; exports.gracefulShutdown = gracefulShutdown; exports.ignite = ignite; exports.isHttpError = _chunkAGOYTFROcjs.isHttpError; exports.listTasks = _chunkA2QGDWCGcjs.listTasks; exports.logger = _chunkJHCXIYJHcjs.logger; exports.rateLimit = rateLimit; exports.resetQueryMetrics = _chunkJHCXIYJHcjs.resetQueryMetrics; exports.scanDir = _chunk4FQP6QX3cjs.scanDir; exports.setDbClient = _chunkSV4C4HWPcjs.setDbClient; exports.transaction = _chunkSV4C4HWPcjs.transaction; exports.workerCount = workerCount;
1070
1163
  //# sourceMappingURL=index.cjs.map
1071
1164
  exports.generateOpenAPI = require("./openapi-cjs.cjs").generateOpenAPI;