express-file-cluster 0.10.2 → 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 (142) 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 +3 -1
  4. package/dist/auth/index.d.ts +3 -1
  5. package/dist/auth/index.js +7 -5
  6. package/dist/{chunk-BG4A7Z32.js → chunk-3JQWQF2M.js} +3 -3
  7. package/dist/{chunk-4GHK27JA.cjs → chunk-4FQP6QX3.cjs} +3 -3
  8. package/dist/{chunk-4GHK27JA.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-MUVO7MGS.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-5LPRKZPB.js → chunk-BCSJOPYH.js} +2 -2
  16. package/dist/chunk-BJR42CN3.cjs +872 -0
  17. package/dist/chunk-BJR42CN3.cjs.map +1 -0
  18. package/dist/{chunk-C2FOZ7ME.js → chunk-EBJELA7T.js} +30 -25
  19. package/dist/chunk-EBJELA7T.js.map +1 -0
  20. package/dist/{chunk-Y4NKIXUL.cjs → chunk-H6MHRHUP.cjs} +104 -50
  21. package/dist/chunk-H6MHRHUP.cjs.map +1 -0
  22. package/dist/{chunk-7BC3AN7R.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-JP36TLL4.cjs → chunk-JHCXIYJH.cjs} +25 -47
  27. package/dist/chunk-JHCXIYJH.cjs.map +1 -0
  28. package/dist/{chunk-IUZ6A7PB.cjs → chunk-JVB5NLEM.cjs} +15 -13
  29. package/dist/chunk-JVB5NLEM.cjs.map +1 -0
  30. package/dist/chunk-LIAGVWFQ.js +872 -0
  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-RETV3GKE.js → chunk-QLM3JEER.js} +5 -3
  37. package/dist/{chunk-RETV3GKE.js.map → chunk-QLM3JEER.js.map} +1 -1
  38. package/dist/{chunk-R2K7AFIB.cjs → chunk-SV4C4HWP.cjs} +89 -89
  39. package/dist/{chunk-R2K7AFIB.cjs.map → chunk-SV4C4HWP.cjs.map} +1 -1
  40. package/dist/{chunk-V73R76I4.js → chunk-UJ2ISRLP.js} +11 -33
  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-TBIVIR6L.cjs → chunk-VLGN3XUM.cjs} +40 -35
  45. package/dist/chunk-VLGN3XUM.cjs.map +1 -0
  46. package/dist/{chunk-Y75V5FCU.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 +6 -0
  62. package/dist/docs/api-reference/openapi.md +36 -0
  63. package/dist/docs/api-reference/tasks.md +5 -1
  64. package/dist/docs/api-reference/testing.md +4 -0
  65. package/dist/docs/api-reference/tracing.md +18 -0
  66. package/dist/docs/api-reference/websockets.md +23 -0
  67. package/dist/docs/cli/add.md +1 -1
  68. package/dist/docs/core-concepts/background-tasks.md +5 -1
  69. package/dist/docs/core-concepts/clustering.md +2 -0
  70. package/dist/docs/core-concepts/file-based-routing.md +4 -0
  71. package/dist/docs/core-concepts/middleware.md +2 -0
  72. package/dist/docs/guides/caching.md +12 -0
  73. package/dist/docs/guides/error-handling.md +2 -0
  74. package/dist/docs/guides/feature-matrix.md +16 -0
  75. package/dist/docs/guides/logging.md +2 -0
  76. package/dist/docs/guides/openapi.md +57 -0
  77. package/dist/docs/guides/tracing.md +64 -0
  78. package/dist/docs/guides/validation.md +2 -0
  79. package/dist/docs/guides/websockets.md +60 -0
  80. package/dist/docs/index.md +4 -1
  81. package/dist/docs/skills/SKILL.md +7 -3
  82. package/dist/docs/skills/api-surface.md +18 -0
  83. package/dist/docs/skills/auth-internals.md +4 -2
  84. package/dist/docs/skills/pre-flight.md +6 -0
  85. package/dist/docs/skills/routing-rules.md +6 -0
  86. package/dist/docs/skills/tasks-internals.md +10 -2
  87. package/dist/docs/skills/what-not-to-invent.md +4 -0
  88. package/dist/index.cjs +185 -70
  89. package/dist/index.cjs.map +1 -1
  90. package/dist/index.d.cts +6 -14
  91. package/dist/index.d.ts +6 -14
  92. package/dist/index.js +143 -28
  93. package/dist/index.js.map +1 -1
  94. package/dist/openapi-cjs.cjs +5 -0
  95. package/dist/pgboss-backend-5DXF4G22.js +16 -0
  96. package/dist/pgboss-backend-KRTFHRNZ.cjs +16 -0
  97. package/dist/pgboss-backend-KRTFHRNZ.cjs.map +1 -0
  98. package/dist/registry/index.json +1 -1
  99. package/dist/tasks/index.cjs +3 -3
  100. package/dist/tasks/index.d.cts +4 -2
  101. package/dist/tasks/index.d.ts +4 -2
  102. package/dist/tasks/index.js +2 -1
  103. package/dist/testing.cjs +21 -13
  104. package/dist/testing.cjs.map +1 -1
  105. package/dist/testing.d.cts +5 -1
  106. package/dist/testing.d.ts +5 -1
  107. package/dist/testing.js +17 -8
  108. package/dist/testing.js.map +1 -1
  109. package/dist/thread-runner.cjs +5 -4
  110. package/dist/thread-runner.cjs.map +1 -1
  111. package/dist/thread-runner.d.cts +1 -1
  112. package/dist/thread-runner.d.ts +1 -1
  113. package/dist/thread-runner.js +4 -2
  114. package/dist/{types-CPMFTVXm.d.ts → types-Bgeqpm-n.d.cts} +91 -2
  115. package/dist/{types-CPMFTVXm.d.cts → types-Bgeqpm-n.d.ts} +91 -2
  116. package/package.json +11 -5
  117. package/dist/chunk-3SWI46YK.js +0 -74
  118. package/dist/chunk-3SWI46YK.js.map +0 -1
  119. package/dist/chunk-74BSJXWD.cjs +0 -220
  120. package/dist/chunk-74BSJXWD.cjs.map +0 -1
  121. package/dist/chunk-7BC3AN7R.cjs.map +0 -1
  122. package/dist/chunk-B6MB6HEG.js.map +0 -1
  123. package/dist/chunk-C2FOZ7ME.js.map +0 -1
  124. package/dist/chunk-CGY7JU4Y.cjs.map +0 -1
  125. package/dist/chunk-H2PVWCWC.cjs.map +0 -1
  126. package/dist/chunk-IUZ6A7PB.cjs.map +0 -1
  127. package/dist/chunk-JP36TLL4.cjs.map +0 -1
  128. package/dist/chunk-KLWL7XSC.js +0 -220
  129. package/dist/chunk-KLWL7XSC.js.map +0 -1
  130. package/dist/chunk-MUVO7MGS.js.map +0 -1
  131. package/dist/chunk-RPL2IFWK.cjs +0 -77
  132. package/dist/chunk-RPL2IFWK.cjs.map +0 -1
  133. package/dist/chunk-TBIVIR6L.cjs.map +0 -1
  134. package/dist/chunk-V73R76I4.js.map +0 -1
  135. package/dist/chunk-Y4NKIXUL.cjs.map +0 -1
  136. package/dist/chunk-Y75V5FCU.js.map +0 -1
  137. package/dist/pgboss-backend-4X2YT4RB.js +0 -14
  138. package/dist/pgboss-backend-UXQ3O2WT.cjs +0 -15
  139. package/dist/pgboss-backend-UXQ3O2WT.cjs.map +0 -1
  140. /package/dist/{chunk-BG4A7Z32.js.map → chunk-3JQWQF2M.js.map} +0 -0
  141. /package/dist/{chunk-5LPRKZPB.js.map → chunk-BCSJOPYH.js.map} +0 -0
  142. /package/dist/{pgboss-backend-4X2YT4RB.js.map → pgboss-backend-5DXF4G22.js.map} +0 -0
@@ -1,19 +1,37 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
2
2
 
3
- var _chunkRPL2IFWKcjs = require('./chunk-RPL2IFWK.cjs');
3
+ var _chunkJAPZYQVJcjs = require('./chunk-JAPZYQVJ.cjs');
4
4
 
5
5
 
6
6
 
7
- var _chunkH2PVWCWCcjs = require('./chunk-H2PVWCWC.cjs');
7
+ var _chunkA2QGDWCGcjs = require('./chunk-A2QGDWCG.cjs');
8
8
 
9
9
 
10
10
 
11
- var _chunkJP36TLL4cjs = require('./chunk-JP36TLL4.cjs');
11
+ var _chunkJHCXIYJHcjs = require('./chunk-JHCXIYJH.cjs');
12
+
13
+
14
+
15
+ var _chunkURKE3OXNcjs = require('./chunk-URKE3OXN.cjs');
16
+
17
+ // src/tasks/payload.ts
18
+ var VALUE = "__efcValue";
19
+ var VERSION = "__efcBox";
20
+ function boxPgPayload(payload) {
21
+ if (payload === void 0) return {};
22
+ if (payload !== null && typeof payload === "object" && !Array.isArray(payload) && !Object.hasOwn(payload, VALUE))
23
+ return payload;
24
+ return { [VERSION]: 1, [VALUE]: payload };
25
+ }
26
+ function unboxPgPayload(data) {
27
+ if (data === null || typeof data !== "object" || !Object.hasOwn(data, VALUE)) return data;
28
+ const keys = Object.keys(data);
29
+ if (keys.length === 1 || keys.length === 2 && Object.hasOwn(data, VERSION) && data[VERSION] === 1)
30
+ return data[VALUE];
31
+ return data;
32
+ }
12
33
 
13
34
  // src/tasks/pgboss-backend.ts
14
- var BOX = "__efcValue";
15
- var box = (payload) => payload !== null && typeof payload === "object" && !Array.isArray(payload) ? payload : { [BOX]: payload };
16
- var unbox = (data) => data !== null && typeof data === "object" && BOX in data ? data[BOX] : data;
17
35
  var retryOptions = (def) => ({
18
36
  // pg-boss's retryLimit counts re-runs, exactly like EFC's `retries`.
19
37
  retryLimit: _nullishCoalesce(def.options.retries, () => ( 3)),
@@ -39,17 +57,22 @@ async function initPgBoss(opts) {
39
57
  const PgBoss = await loadPgBoss();
40
58
  const boss = new PgBoss({
41
59
  connectionString: opts.connectionString,
60
+ openTelemetry: {
61
+ enabled: !!opts.tracing,
62
+ propagateContext: !!opts.tracing,
63
+ propagator: _chunkURKE3OXNcjs.tracePropagator
64
+ },
42
65
  ...opts.schema !== void 0 && { schema: opts.schema }
43
66
  });
44
- boss.on("error", (err) => _chunkJP36TLL4cjs.getLogger.call(void 0, ).error({ err }, "pg-boss error"));
67
+ boss.on("error", (err) => _chunkJHCXIYJHcjs.getLogger.call(void 0, ).error({ err }, "pg-boss error"));
45
68
  try {
46
69
  await boss.start();
47
70
  } catch (err) {
48
- throw _chunkJP36TLL4cjs.explainPostgresError.call(void 0, err, opts.connectionString);
71
+ throw _chunkJHCXIYJHcjs.explainPostgresError.call(void 0, err, opts.connectionString);
49
72
  }
50
73
  const queueFor = (name) => `${opts.queue}.${name}`;
51
74
  const wantedSchedules = /* @__PURE__ */ new Set();
52
- for (const def of _chunkH2PVWCWCcjs.taskRegistry.values()) {
75
+ for (const def of _chunkA2QGDWCGcjs.taskRegistry.values()) {
53
76
  const queue = queueFor(def.name);
54
77
  await boss.createQueue(queue, retryOptions(def));
55
78
  await boss.work(
@@ -57,13 +80,14 @@ async function initPgBoss(opts) {
57
80
  { localConcurrency: _nullishCoalesce(def.options.concurrency, () => ( opts.concurrency)) },
58
81
  async (jobs) => {
59
82
  for (const job of jobs) {
60
- const payload = unbox(job.data);
83
+ const payload = unboxPgPayload(job.data);
61
84
  try {
62
- if (def.options.thread && def.filePath) await _chunkRPL2IFWKcjs.runInThread.call(void 0, def.filePath, payload);
63
- else await def.handler(payload);
64
- _chunkJP36TLL4cjs.getLogger.call(void 0, ).info({ task: def.name, jobId: job.id }, `Task ${def.name} completed`);
85
+ if (def.options.thread && def.filePath)
86
+ await _chunkURKE3OXNcjs.taskContext.call(void 0, () => _chunkJAPZYQVJcjs.runInThread.call(void 0, def.filePath, payload, !!opts.tracing));
87
+ else await _chunkURKE3OXNcjs.taskContext.call(void 0, () => def.handler(payload));
88
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info({ task: def.name, jobId: job.id }, `Task ${def.name} completed`);
65
89
  } catch (err) {
66
- _chunkJP36TLL4cjs.getLogger.call(void 0, ).error(
90
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).error(
67
91
  { task: def.name, jobId: job.id, attempt: job.retryCount + 1, err },
68
92
  `Task ${def.name} failed`
69
93
  );
@@ -90,9 +114,9 @@ async function initPgBoss(opts) {
90
114
  await boss.unschedule(s.name);
91
115
  }
92
116
  }
93
- if (wantedSchedules.size > 0) _chunkJP36TLL4cjs.getLogger.call(void 0, ).info(`Scheduled ${wantedSchedules.size} cron task(s)`);
94
- _chunkH2PVWCWCcjs.setEnqueueImpl.call(void 0, async (name, payload) => {
95
- const def = _chunkH2PVWCWCcjs.taskRegistry.get(name);
117
+ if (wantedSchedules.size > 0) _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info(`Scheduled ${wantedSchedules.size} cron task(s)`);
118
+ _chunkA2QGDWCGcjs.setEnqueueImpl.call(void 0, async (name, payload) => {
119
+ const def = _chunkA2QGDWCGcjs.taskRegistry.get(name);
96
120
  if (!def) {
97
121
  throw new Error(
98
122
  `[EFC] Cannot enqueue unknown task: "${name}". Is the task file in tasksDir?`
@@ -110,7 +134,11 @@ async function initPgBoss(opts) {
110
134
  );
111
135
  });
112
136
  try {
113
- await Promise.race([boss.send(queueFor(name), box(payload), retryOptions(def)), timeout]);
137
+ const id = await Promise.race([
138
+ boss.send(queueFor(name), boxPgPayload(payload), retryOptions(def)),
139
+ timeout
140
+ ]);
141
+ if (id === null) throw new Error(`[EFC] Queue did not accept task "${name}"`);
114
142
  } catch (err) {
115
143
  if (err instanceof Error && err.message.startsWith("[EFC]")) throw err;
116
144
  throw new Error(
@@ -123,13 +151,14 @@ async function initPgBoss(opts) {
123
151
  closeImpl = async () => {
124
152
  await boss.stop({ graceful: true, timeout: 1e4 });
125
153
  };
126
- _chunkJP36TLL4cjs.getLogger.call(void 0, ).info("pg-boss backend initialised");
154
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).info("pg-boss backend initialised");
127
155
  }
128
156
  async function pgBossAdmin(connectionString, queue = "efc", schema = "pgboss") {
129
157
  const PgBoss = await loadPgBoss();
130
158
  const boss = new PgBoss({
131
159
  connectionString,
132
160
  schema,
161
+ openTelemetry: { enabled: false },
133
162
  supervise: false,
134
163
  schedule: false,
135
164
  migrate: false
@@ -166,16 +195,14 @@ async function pgBossAdmin(connectionString, queue = "efc", schema = "pgboss") {
166
195
  const rows = (await failedRows([], name ? 1e4 : limit)).filter(
167
196
  (r) => !name || taskOf(r.name) === name
168
197
  );
169
- return rows.slice(0, limit).map(
170
- (r) => ({
171
- id: r.id,
172
- name: taskOf(r.name),
173
- data: unbox(r.data),
174
- error: String(_nullishCoalesce(_nullishCoalesce(_optionalChain([r, 'access', _3 => _3.output, 'optionalAccess', _4 => _4.message]), () => ( r.output)), () => ( ""))),
175
- attempts: r.retry_count + 1,
176
- failedAt: _nullishCoalesce(r.completed_on, () => ( void 0))
177
- })
178
- );
198
+ return rows.slice(0, limit).map((r) => ({
199
+ id: r.id,
200
+ name: taskOf(r.name),
201
+ data: unboxPgPayload(r.data),
202
+ error: String(_nullishCoalesce(_nullishCoalesce(_optionalChain([r, 'access', _3 => _3.output, 'optionalAccess', _4 => _4.message]), () => ( r.output)), () => ( ""))),
203
+ attempts: r.retry_count + 1,
204
+ failedAt: _nullishCoalesce(r.completed_on, () => ( void 0))
205
+ }));
179
206
  },
180
207
  async retry(ids) {
181
208
  const rows = await failedRows(ids);
@@ -198,4 +225,4 @@ async function pgBossAdmin(connectionString, queue = "efc", schema = "pgboss") {
198
225
 
199
226
 
200
227
  exports.closePgBoss = closePgBoss; exports.initPgBoss = initPgBoss; exports.pgBossAdmin = pgBossAdmin;
201
- //# sourceMappingURL=chunk-7BC3AN7R.cjs.map
228
+ //# sourceMappingURL=chunk-IG3V2IOK.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-IG3V2IOK.cjs","../src/tasks/payload.ts","../src/tasks/pgboss-backend.ts"],"names":[],"mappings":"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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-IG3V2IOK.cjs","sourcesContent":[null,"// pg-boss accepts object payloads. Escape user objects that contain the legacy\n// box key, and retain support for jobs written by older EFC versions.\nconst VALUE = '__efcValue';\nconst VERSION = '__efcBox';\nexport function boxPgPayload(payload: unknown): object {\n if (payload === undefined) return {}; // Same JSON-queue normalization as BullMQ.\n if (\n payload !== null &&\n typeof payload === 'object' &&\n !Array.isArray(payload) &&\n !Object.hasOwn(payload, VALUE)\n )\n return payload;\n return { [VERSION]: 1, [VALUE]: payload };\n}\nexport function unboxPgPayload(data: unknown): unknown {\n if (data === null || typeof data !== 'object' || !Object.hasOwn(data, VALUE)) return data;\n const keys = Object.keys(data);\n if (\n keys.length === 1 ||\n (keys.length === 2 &&\n Object.hasOwn(data, VERSION) &&\n (data as Record<string, unknown>)[VERSION] === 1)\n )\n return (data as Record<string, unknown>)[VALUE];\n return data;\n}\n","import { boxPgPayload as box, unboxPgPayload as unbox } from './payload.js';\nimport { taskContext, tracePropagator } from '../tracing.js';\nimport type { PgBoss as PgBossType } from 'pg-boss';\nimport type { TaskDefinition } from '../types.js';\nimport { taskRegistry, setEnqueueImpl } from './index.js';\nimport { runInThread } from './thread-runner.js';\nimport { getLogger } from '../logger.js';\nimport { explainPostgresError } from '../db/postgres.js';\nimport type { FailedJob, TaskAdmin } from './admin.js';\n\n// pg-boss keeps one queue per job name, so each task gets its own pg-boss queue\n// named `<tasks.queue>.<TaskName>` — the prefix keeps apps sharing a database apart.\n\ninterface PgBossOpts {\n tracing?: boolean;\n connectionString: string;\n concurrency: number;\n enqueueTimeout: number;\n queue: string;\n schema?: string;\n}\n\nconst retryOptions = (def: TaskDefinition) => ({\n // pg-boss's retryLimit counts re-runs, exactly like EFC's `retries`.\n retryLimit: def.options.retries ?? 3,\n retryDelay: 1,\n retryBackoff: (def.options.backoff ?? 'exponential') === 'exponential',\n});\n\nasync function loadPgBoss(): Promise<typeof PgBossType> {\n try {\n const mod = (await import('pg-boss')) as unknown as {\n PgBoss?: typeof PgBossType;\n default?: typeof PgBossType | { PgBoss: typeof PgBossType };\n };\n const ctor =\n mod.PgBoss ??\n (typeof mod.default === 'function'\n ? mod.default\n : (mod.default as { PgBoss: typeof PgBossType }).PgBoss);\n return ctor;\n } catch {\n throw new Error('[EFC] pg-boss is not installed. Run: npm install pg-boss');\n }\n}\n\nlet closeImpl: (() => Promise<void>) | null = null;\n\nexport async function closePgBoss(): Promise<void> {\n const close = closeImpl;\n closeImpl = null;\n await close?.();\n}\n\nexport async function initPgBoss(opts: PgBossOpts): Promise<void> {\n const PgBoss = await loadPgBoss();\n const boss = new PgBoss({\n connectionString: opts.connectionString,\n openTelemetry: {\n enabled: !!opts.tracing,\n propagateContext: !!opts.tracing,\n propagator: tracePropagator,\n },\n ...(opts.schema !== undefined && { schema: opts.schema }),\n });\n boss.on('error', (err: Error) => getLogger().error({ err }, 'pg-boss error'));\n try {\n await boss.start();\n } catch (err) {\n throw explainPostgresError(err, opts.connectionString);\n }\n\n const queueFor = (name: string) => `${opts.queue}.${name}`;\n const wantedSchedules = new Set<string>();\n\n for (const def of taskRegistry.values()) {\n const queue = queueFor(def.name);\n await boss.createQueue(queue, retryOptions(def));\n await boss.work(\n queue,\n { localConcurrency: def.options.concurrency ?? opts.concurrency },\n async (jobs: { id: string; data: unknown; retryCount: number }[]) => {\n for (const job of jobs) {\n const payload = unbox(job.data);\n try {\n if (def.options.thread && def.filePath)\n await taskContext(() => runInThread(def.filePath!, payload, !!opts.tracing));\n else await taskContext(() => def.handler(payload));\n getLogger().info({ task: def.name, jobId: job.id }, `Task ${def.name} completed`);\n } catch (err) {\n getLogger().error(\n { task: def.name, jobId: job.id, attempt: job.retryCount + 1, err },\n `Task ${def.name} failed`,\n );\n throw err;\n }\n }\n },\n );\n if (def.options.schedule) {\n wantedSchedules.add(queue);\n await boss.schedule(\n queue,\n def.options.schedule,\n {},\n {\n ...retryOptions(def),\n ...(def.options.timezone !== undefined && { tz: def.options.timezone }),\n },\n );\n }\n }\n\n // Drop schedules for tasks that lost their `schedule` or no longer exist.\n for (const s of await boss.getSchedules()) {\n if (s.name.startsWith(`${opts.queue}.`) && !wantedSchedules.has(s.name)) {\n await boss.unschedule(s.name);\n }\n }\n if (wantedSchedules.size > 0) getLogger().info(`Scheduled ${wantedSchedules.size} cron task(s)`);\n\n setEnqueueImpl(async (name, payload) => {\n const def = taskRegistry.get(name);\n if (!def) {\n throw new Error(\n `[EFC] Cannot enqueue unknown task: \"${name}\". Is the task file in tasksDir?`,\n );\n }\n let timer: NodeJS.Timeout | undefined;\n const timeout = new Promise<never>((_, reject) => {\n timer = setTimeout(\n () =>\n reject(\n new Error(\n `[EFC] Cannot enqueue task \"${name}\": PostgreSQL did not respond within ${opts.enqueueTimeout}ms`,\n ),\n ),\n opts.enqueueTimeout,\n );\n });\n try {\n const id = await Promise.race([\n boss.send(queueFor(name), box(payload), retryOptions(def)),\n timeout,\n ]);\n if (id === null) throw new Error(`[EFC] Queue did not accept task \"${name}\"`);\n } catch (err) {\n if (err instanceof Error && err.message.startsWith('[EFC]')) throw err;\n throw new Error(\n `[EFC] Cannot enqueue task \"${name}\": ${err instanceof Error ? err.message : String(err)}`,\n );\n } finally {\n clearTimeout(timer);\n }\n });\n\n closeImpl = async () => {\n // graceful: lets in-flight jobs finish before the connection pool closes.\n await boss.stop({ graceful: true, timeout: 10_000 });\n };\n\n getLogger().info('pg-boss backend initialised');\n}\n\n/** Dead-letter inspection for `efc tasks failed | retry | purge` on pg-boss. */\nexport async function pgBossAdmin(\n connectionString: string,\n queue = 'efc',\n schema = 'pgboss',\n): Promise<TaskAdmin> {\n const PgBoss = await loadPgBoss();\n // No supervision or cron here: this instance only reads and settles jobs.\n const boss = new PgBoss({\n connectionString,\n schema,\n openTelemetry: { enabled: false },\n supervise: false,\n schedule: false,\n migrate: false,\n });\n boss.on('error', () => {});\n await boss.start();\n const db = boss.getDb();\n const prefix = `${queue}.`;\n const taskOf = (name: string) => name.slice(prefix.length);\n const table = `\"${schema.replace(/\"/g, '\"\"')}\".job`;\n\n const failedRows = async (ids: string[], limit = 10_000) =>\n (\n await db.executeSql(\n `SELECT id, name, data, output, retry_count, completed_on FROM ${table}\n WHERE state = 'failed' AND starts_with(name, $1) ${ids.length ? 'AND id = ANY($3::uuid[])' : ''}\n ORDER BY completed_on DESC NULLS LAST LIMIT $2`,\n ids.length ? [prefix, limit, ids] : [prefix, limit],\n )\n ).rows as {\n id: string;\n name: string;\n data: unknown;\n output: unknown;\n retry_count: number;\n completed_on: Date | null;\n }[];\n\n const byQueue = (rows: { id: string; name: string }[]) => {\n const groups = new Map<string, string[]>();\n for (const r of rows) groups.set(r.name, [...(groups.get(r.name) ?? []), r.id]);\n return groups;\n };\n\n return {\n async counts() {\n const { rows } = await db.executeSql(\n `SELECT state, count(*)::int AS n FROM ${table} WHERE starts_with(name, $1) GROUP BY state`,\n [prefix],\n );\n return Object.fromEntries(\n (rows as { state: string; n: number }[]).map((r) => [r.state, r.n]),\n );\n },\n async listFailed({ limit, name }) {\n const rows = (await failedRows([], name ? 10_000 : limit)).filter(\n (r) => !name || taskOf(r.name) === name,\n );\n return rows.slice(0, limit).map((r): FailedJob => ({\n id: r.id,\n name: taskOf(r.name),\n data: unbox(r.data),\n error: String((r.output as { message?: string } | null)?.message ?? r.output ?? ''),\n attempts: r.retry_count + 1,\n failedAt: r.completed_on ?? undefined,\n }));\n },\n async retry(ids) {\n const rows = await failedRows(ids);\n for (const [q, list] of byQueue(rows)) await boss.retry(q, list);\n return rows.length;\n },\n async purge(ids) {\n const rows = await failedRows(ids);\n for (const [q, list] of byQueue(rows)) await boss.deleteJob(q, list);\n return rows.length;\n },\n async close() {\n await boss.stop({ graceful: false });\n },\n };\n}\n"]}
@@ -0,0 +1,143 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
2
+
3
+
4
+ var _chunkA2QGDWCGcjs = require('./chunk-A2QGDWCG.cjs');
5
+
6
+
7
+
8
+
9
+ var _chunkURKE3OXNcjs = require('./chunk-URKE3OXN.cjs');
10
+
11
+
12
+ var _chunkPUYBKDYDcjs = require('./chunk-PUYBKDYD.cjs');
13
+
14
+ // src/tasks/thread-runner.ts
15
+ var _crypto = require('crypto');
16
+ var _api = require('@opentelemetry/api');
17
+ var _worker_threads = require('worker_threads');
18
+ if (!_worker_threads.isMainThread && _worker_threads.parentPort && _optionalChain([_worker_threads.workerData, 'optionalAccess', _ => _.efcTask])) {
19
+ const port = _worker_threads.parentPort;
20
+ const {
21
+ handlerPath,
22
+ payload,
23
+ token,
24
+ trace: parentTrace
25
+ } = _worker_threads.workerData;
26
+ const waiting = /* @__PURE__ */ new Map();
27
+ let seq = 0;
28
+ port.unref();
29
+ port.on("message", (msg) => {
30
+ if (_optionalChain([msg, 'optionalAccess', _2 => _2.type]) !== "enqueued" || msg.token !== token) return;
31
+ const w = waiting.get(msg.id);
32
+ if (!w) return;
33
+ waiting.delete(msg.id);
34
+ if (waiting.size === 0) port.unref();
35
+ if (msg.error === void 0) w.resolve();
36
+ else w.reject(new Error(msg.error));
37
+ });
38
+ globalThis[_chunkA2QGDWCGcjs.ENQUEUE_BRIDGE] = (name, payload2) => new Promise((resolve, reject) => {
39
+ const id = ++seq;
40
+ waiting.set(id, { resolve, reject });
41
+ port.ref();
42
+ port.postMessage({
43
+ type: "enqueue",
44
+ token,
45
+ id,
46
+ name,
47
+ payload: payload2,
48
+ ...parentTrace && { trace: _chunkURKE3OXNcjs.injectTrace.call(void 0, ) }
49
+ });
50
+ });
51
+ (async () => {
52
+ try {
53
+ const mod = await Promise.resolve().then(() => _interopRequireWildcard(require(handlerPath)));
54
+ const def = mod["default"];
55
+ if (!def || typeof def.handler !== "function") {
56
+ throw new Error(`[EFC] Thread runner: no valid task export in ${handlerPath}`);
57
+ }
58
+ const ctx = parentTrace ? _chunkURKE3OXNcjs.extractTrace.call(void 0, parentTrace) : _api.context.active();
59
+ await _chunkURKE3OXNcjs.runWithContext.call(void 0,
60
+ { otelContext: ctx },
61
+ () => _api.context.with(ctx, () => def.handler(payload))
62
+ );
63
+ port.postMessage({ type: "done", ok: true, token });
64
+ } catch (err) {
65
+ port.postMessage({ type: "done", ok: false, error: String(err), token });
66
+ }
67
+ })();
68
+ }
69
+ function runInThread(handlerPath, payload, tracing = false) {
70
+ return new Promise((resolve, reject) => {
71
+ const token = _crypto.randomUUID.call(void 0, );
72
+ const worker = new (0, _worker_threads.Worker)(new URL("./thread-runner.js", _chunkPUYBKDYDcjs.importMetaUrl), {
73
+ workerData: {
74
+ efcTask: true,
75
+ handlerPath,
76
+ payload,
77
+ token,
78
+ ...tracing && { trace: _chunkURKE3OXNcjs.injectTrace.call(void 0, ) }
79
+ }
80
+ });
81
+ let completed = false;
82
+ let exited = false;
83
+ let settled = false;
84
+ const pending = /* @__PURE__ */ new Set();
85
+ const settle = (error) => {
86
+ if (settled) return;
87
+ settled = true;
88
+ if (error) reject(error);
89
+ else resolve();
90
+ };
91
+ worker.on("message", (message) => {
92
+ if (!message || typeof message !== "object" || message.token !== token)
93
+ return;
94
+ const msg = message;
95
+ if (msg.type === "enqueue") {
96
+ if (completed || !Number.isSafeInteger(msg.id) || typeof msg.name !== "string") return;
97
+ const reply = (error) => {
98
+ if (exited) return;
99
+ try {
100
+ worker.postMessage({
101
+ type: "enqueued",
102
+ token,
103
+ id: msg.id,
104
+ ...error !== void 0 && { error }
105
+ });
106
+ } catch (e) {
107
+ }
108
+ };
109
+ const parent = msg.trace ? _chunkURKE3OXNcjs.extractTrace.call(void 0, msg.trace) : _api.context.active();
110
+ const operation = Promise.resolve().then(() => _api.context.with(parent, () => _chunkA2QGDWCGcjs.enqueue.call(void 0, msg.name, msg.payload))).then(
111
+ () => reply(),
112
+ (err) => reply(err instanceof Error ? err.message : String(err))
113
+ );
114
+ pending.add(operation);
115
+ void operation.then(() => pending.delete(operation));
116
+ return;
117
+ }
118
+ if (msg.type !== "done" || typeof msg.ok !== "boolean" || completed) return;
119
+ completed = true;
120
+ void Promise.allSettled([...pending]).then(() => worker.terminate()).then(
121
+ () => settle(
122
+ msg.ok ? void 0 : new Error(typeof msg.error === "string" ? msg.error : "Thread task failed")
123
+ ),
124
+ (error) => settle(error instanceof Error ? error : new Error(String(error)))
125
+ );
126
+ });
127
+ worker.on("error", (error) => {
128
+ void worker.terminate().catch(() => {
129
+ });
130
+ settle(error);
131
+ });
132
+ worker.on("exit", (code) => {
133
+ exited = true;
134
+ if (!completed)
135
+ settle(new Error(`Thread worker exited with code ${code} before reporting completion`));
136
+ });
137
+ });
138
+ }
139
+
140
+
141
+
142
+ exports.runInThread = runInThread;
143
+ //# sourceMappingURL=chunk-JAPZYQVJ.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-JAPZYQVJ.cjs","../src/tasks/thread-runner.ts"],"names":["payload"],"mappings":"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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-JAPZYQVJ.cjs","sourcesContent":[null,"import { randomUUID } from 'node:crypto';\nimport { context } from '@opentelemetry/api';\nimport { injectTrace, extractTrace, type TraceCarrier } from '../tracing.js';\nimport { runWithContext } from '../context.js';\nimport { Worker, workerData, parentPort, isMainThread } from 'node:worker_threads';\nimport type { TaskDefinition } from '../types.js';\nimport { enqueue, ENQUEUE_BRIDGE } from './index.js';\n\n// `{ thread: true }` tasks run here, in a worker_thread. The task queue lives on the main\n// thread, so `enqueue()` inside the thread is bridged: the thread posts the call, the main\n// thread runs the real enqueue() and posts back the outcome.\n\ntype FromThread = (\n | { type: 'done'; ok: true }\n | { type: 'done'; ok: false; error: string }\n | { type: 'enqueue'; id: number; name: string; payload: unknown; trace?: TraceCarrier }\n) & { token: string };\ntype ToThread = { type: 'enqueued'; id: number; error?: string; token: string };\n\n// ── Worker-thread side ────────────────────────────────────────────────────────\nif (!isMainThread && parentPort && (workerData as { efcTask?: boolean })?.efcTask) {\n const port = parentPort;\n const {\n handlerPath,\n payload,\n token,\n trace: parentTrace,\n } = workerData as { handlerPath: string; payload: unknown; trace?: TraceCarrier; token: string };\n const waiting = new Map<number, { resolve: () => void; reject: (e: Error) => void }>();\n let seq = 0;\n // The port only keeps the thread alive while an enqueue waits for its answer, so a\n // finished task's thread still exits.\n port.unref();\n port.on('message', (msg: ToThread) => {\n if (msg?.type !== 'enqueued' || msg.token !== token) return;\n const w = waiting.get(msg.id);\n if (!w) return;\n waiting.delete(msg.id);\n if (waiting.size === 0) port.unref();\n if (msg.error === undefined) w.resolve();\n else w.reject(new Error(msg.error));\n });\n // On globalThis, so the task's own copy of express-file-cluster/tasks (ESM or CJS)\n // finds it too.\n (globalThis as Record<symbol, unknown>)[ENQUEUE_BRIDGE] = (name: string, payload: unknown) =>\n new Promise<void>((resolve, reject) => {\n const id = ++seq;\n waiting.set(id, { resolve, reject });\n port.ref();\n port.postMessage({\n type: 'enqueue',\n token,\n id,\n name,\n payload,\n ...(parentTrace && { trace: injectTrace() }),\n } satisfies FromThread);\n });\n\n (async () => {\n try {\n const mod = (await import(handlerPath)) as Record<string, unknown>;\n const def = mod['default'] as TaskDefinition | undefined;\n if (!def || typeof def.handler !== 'function') {\n throw new Error(`[EFC] Thread runner: no valid task export in ${handlerPath}`);\n }\n const ctx = parentTrace ? extractTrace(parentTrace) : context.active();\n // A thread has no SDK unless the app initializes one there. Preserve the\n // carrier for nested enqueue even with the API's no-op context manager.\n await runWithContext({ otelContext: ctx }, () =>\n context.with(ctx, () => def.handler(payload)),\n );\n port.postMessage({ type: 'done', ok: true, token } satisfies FromThread);\n } catch (err) {\n port.postMessage({ type: 'done', ok: false, error: String(err), token } satisfies FromThread);\n }\n })();\n}\n\n// ── Main-thread side ──────────────────────────────────────────────────────────\nexport function runInThread(handlerPath: string, payload: unknown, tracing = false): Promise<void> {\n return new Promise((resolve, reject) => {\n const token = randomUUID();\n const worker = new Worker(new URL('./thread-runner.js', import.meta.url), {\n workerData: {\n efcTask: true,\n handlerPath,\n payload,\n token,\n ...(tracing && { trace: injectTrace() }),\n },\n });\n\n let completed = false;\n let exited = false;\n let settled = false;\n const pending = new Set<Promise<void>>();\n const settle = (error?: Error) => {\n if (settled) return;\n settled = true;\n if (error) reject(error);\n else resolve();\n };\n worker.on('message', (message: unknown) => {\n if (\n !message ||\n typeof message !== 'object' ||\n (message as { token?: unknown }).token !== token\n )\n return;\n const msg = message as FromThread;\n if (msg.type === 'enqueue') {\n if (completed || !Number.isSafeInteger(msg.id) || typeof msg.name !== 'string') return;\n const reply = (error?: string) => {\n if (exited) return;\n try {\n worker.postMessage({\n type: 'enqueued',\n token,\n id: msg.id,\n ...(error !== undefined && { error }),\n } satisfies ToThread);\n } catch {\n /* An exited worker has nobody left waiting for the reply. */\n }\n };\n const parent = msg.trace ? extractTrace(msg.trace) : context.active();\n const operation = Promise.resolve()\n .then(() => context.with(parent, () => enqueue(msg.name, msg.payload)))\n .then(\n () => reply(),\n (err: unknown) => reply(err instanceof Error ? err.message : String(err)),\n );\n pending.add(operation);\n void operation.then(() => pending.delete(operation));\n return;\n }\n if (msg.type !== 'done' || typeof msg.ok !== 'boolean' || completed) return;\n completed = true;\n // The job owns this isolate. Wait for bridge acknowledgments, then dispose\n // timers/open handles before releasing its queue slot or retrying it.\n void Promise.allSettled([...pending])\n .then(() => worker.terminate())\n .then(\n () =>\n settle(\n msg.ok\n ? undefined\n : new Error(typeof msg.error === 'string' ? msg.error : 'Thread task failed'),\n ),\n (error: unknown) => settle(error instanceof Error ? error : new Error(String(error))),\n );\n });\n worker.on('error', (error) => {\n void worker.terminate().catch(() => {});\n settle(error);\n });\n worker.on('exit', (code) => {\n exited = true;\n if (!completed)\n settle(new Error(`Thread worker exited with code ${code} before reporting completion`));\n });\n });\n}\n"]}
@@ -1,27 +1,7 @@
1
- "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/process-state.ts
2
- function processState(name, initialize) {
3
- const key = /* @__PURE__ */ Symbol.for("express-file-cluster.runtime.v1." + name);
4
- const globals = globalThis;
5
- if (!(key in globals)) globals[key] = initialize();
6
- return globals[key];
7
- }
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
8
2
 
9
- // src/context.ts
10
- var _async_hooks = require('async_hooks');
11
- var storage = processState("request-context", () => new (0, _async_hooks.AsyncLocalStorage)());
12
- function runWithContext(ctx, fn) {
13
- return storage.run(ctx, fn);
14
- }
15
- function getRequestContext() {
16
- return storage.getStore();
17
- }
18
- function setCurrentUser(user) {
19
- const store = storage.getStore();
20
- if (store) store.user = user;
21
- }
22
- function getCurrentUser() {
23
- return _optionalChain([storage, 'access', _ => _.getStore, 'call', _2 => _2(), 'optionalAccess', _3 => _3.user]);
24
- }
3
+
4
+ var _chunkURKE3OXNcjs = require('./chunk-URKE3OXN.cjs');
25
5
 
26
6
  // src/logger.ts
27
7
  var _cluster = require('cluster'); var _cluster2 = _interopRequireDefault(_cluster);
@@ -55,13 +35,13 @@ function prettyStream(out = process.stdout) {
55
35
  const err = rec["err"];
56
36
  const fields = extra.filter(([k]) => k !== "err").map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`).join(" ");
57
37
  out.write(
58
- `${_picocolors2.default.dim(time)} ${level} ${worker}${reqId}${String(_nullishCoalesce(rec["msg"], () => ( "")))}` + (fields ? " " + _picocolors2.default.dim(fields) : "") + (_optionalChain([err, 'optionalAccess', _4 => _4.stack]) ? "\n" + _picocolors2.default.red(err.stack) : "") + "\n"
38
+ `${_picocolors2.default.dim(time)} ${level} ${worker}${reqId}${String(_nullishCoalesce(rec["msg"], () => ( "")))}` + (fields ? " " + _picocolors2.default.dim(fields) : "") + (_optionalChain([err, 'optionalAccess', _ => _.stack]) ? "\n" + _picocolors2.default.red(err.stack) : "") + "\n"
59
39
  );
60
40
  }
61
41
  };
62
42
  }
63
43
  function workerLabel() {
64
- return _cluster2.default.isWorker ? `w${_nullishCoalesce(_optionalChain([_cluster2.default, 'access', _5 => _5.worker, 'optionalAccess', _6 => _6.id]), () => ( "?"))}` : "primary";
44
+ return _cluster2.default.isWorker ? `w${_nullishCoalesce(_optionalChain([_cluster2.default, 'access', _2 => _2.worker, 'optionalAccess', _3 => _3.id]), () => ( "?"))}` : "primary";
65
45
  }
66
46
  function build(config2) {
67
47
  if (config2 === false) return _pino.pino.call(void 0, { level: "silent" });
@@ -75,10 +55,12 @@ var rootLogger = build(void 0);
75
55
  var logRequests = true;
76
56
  function configureLogger(config2) {
77
57
  rootLogger = build(config2);
78
- logRequests = config2 !== false && (_nullishCoalesce(_optionalChain([config2, 'optionalAccess', _7 => _7.requests]), () => ( true)));
58
+ logRequests = config2 !== false && (_nullishCoalesce(_optionalChain([config2, 'optionalAccess', _4 => _4.requests]), () => ( true)));
79
59
  }
80
60
  function getLogger() {
81
- return _nullishCoalesce(_optionalChain([getRequestContext, 'call', _8 => _8(), 'optionalAccess', _9 => _9.log]), () => ( rootLogger));
61
+ const log = _nullishCoalesce(_optionalChain([_chunkURKE3OXNcjs.getRequestContext.call(void 0, ), 'optionalAccess', _5 => _5.log]), () => ( rootLogger));
62
+ const fields = _chunkURKE3OXNcjs.traceLogFields.call(void 0, );
63
+ return fields.span_id && log.bindings().span_id !== fields.span_id ? log.child(fields) : log;
82
64
  }
83
65
  var logger = new Proxy({}, {
84
66
  get(_t, prop) {
@@ -92,11 +74,11 @@ function requestLogger() {
92
74
  return (req, res, next) => {
93
75
  const incoming = req.get("x-request-id");
94
76
  const id = incoming && SAFE_REQUEST_ID.test(incoming) ? incoming : _crypto.randomUUID.call(void 0, );
95
- const log = rootLogger.child({ reqId: id });
77
+ const log = rootLogger.child({ reqId: id, ..._chunkURKE3OXNcjs.traceLogFields.call(void 0, ) });
96
78
  req.id = id;
97
79
  req.log = log;
98
80
  res.setHeader("X-Request-Id", id);
99
- const ctx = getRequestContext();
81
+ const ctx = _chunkURKE3OXNcjs.getRequestContext.call(void 0, );
100
82
  if (ctx) {
101
83
  ctx.requestId = id;
102
84
  ctx.log = log;
@@ -123,13 +105,13 @@ function requestLogger() {
123
105
  }
124
106
 
125
107
  // src/db/query-log.ts
126
-
108
+ var _async_hooks = require('async_hooks');
127
109
  var metrics = /* @__PURE__ */ new Map();
128
110
  var metricsSince = Date.now();
129
111
  var metricsDropped = 0;
130
112
  function getQueryMetrics() {
131
113
  return {
132
- enabled: !!_optionalChain([config, 'optionalAccess', _10 => _10.metricsLimit]),
114
+ enabled: !!_optionalChain([config, 'optionalAccess', _6 => _6.metricsLimit]),
133
115
  since: metricsSince,
134
116
  dropped: metricsDropped,
135
117
  entries: [...metrics.values()].map((entry) => ({ ...entry })).sort((a, b) => a.model.localeCompare(b.model) || a.op.localeCompare(b.op))
@@ -141,7 +123,7 @@ function resetQueryMetrics() {
141
123
  metricsSince = Date.now();
142
124
  }
143
125
  function collectMetric(event) {
144
- if (!_optionalChain([config, 'optionalAccess', _11 => _11.metricsLimit])) return;
126
+ if (!_optionalChain([config, 'optionalAccess', _7 => _7.metricsLimit])) return;
145
127
  const key = event.model + "\0" + event.op;
146
128
  let metric = metrics.get(key);
147
129
  if (!metric) {
@@ -177,7 +159,7 @@ var config;
177
159
  var listeners = /* @__PURE__ */ new Set();
178
160
  var enableHooks = [];
179
161
  function configureQueryLog(logging) {
180
- const q = logging === false ? void 0 : _optionalChain([logging, 'optionalAccess', _12 => _12.queries]);
162
+ const q = logging === false ? void 0 : _optionalChain([logging, 'optionalAccess', _8 => _8.queries]);
181
163
  config = !q ? void 0 : q === true ? { all: true, ...DEFAULTS, metricsLimit: 0 } : {
182
164
  all: _nullishCoalesce(q.all, () => ( false)),
183
165
  slowMs: _nullishCoalesce(q.slowMs, () => ( DEFAULTS.slowMs)),
@@ -209,8 +191,8 @@ function untracked(fn) {
209
191
  function callSite(callee) {
210
192
  const holder = {};
211
193
  Error.captureStackTrace(holder, callee);
212
- const line = _optionalChain([holder, 'access', _13 => _13.stack, 'optionalAccess', _14 => _14.split, 'call', _15 => _15("\n"), 'access', _16 => _16[1]]);
213
- return _optionalChain([line, 'optionalAccess', _17 => _17.trim, 'call', _18 => _18(), 'access', _19 => _19.replace, 'call', _20 => _20(/^at /, "")]);
194
+ const line = _optionalChain([holder, 'access', _9 => _9.stack, 'optionalAccess', _10 => _10.split, 'call', _11 => _11("\n"), 'access', _12 => _12[1]]);
195
+ return _optionalChain([line, 'optionalAccess', _13 => _13.trim, 'call', _14 => _14(), 'access', _15 => _15.replace, 'call', _16 => _16(/^at /, "")]);
214
196
  }
215
197
  function emit(event, site, top) {
216
198
  for (const listener of listeners) listener(event);
@@ -228,7 +210,7 @@ function emit(event, site, top) {
228
210
  if (top && config.nPlusOne !== false) detectNPlusOne(event, site, config.nPlusOne);
229
211
  }
230
212
  function detectNPlusOne(event, site, threshold) {
231
- const ctx = getRequestContext();
213
+ const ctx = _chunkURKE3OXNcjs.getRequestContext.call(void 0, );
232
214
  if (!ctx) return;
233
215
  const key = `${event.model}.${event.op}`;
234
216
  const counts = ctx.queryCounts ??= /* @__PURE__ */ new Map();
@@ -252,7 +234,7 @@ function traceOps(model, target, ops) {
252
234
  const start = process.hrtime.bigint();
253
235
  const finish = (error) => {
254
236
  const durationMs = Math.round(Number(process.hrtime.bigint() - start) / 1e5) / 10;
255
- const reqId = _optionalChain([getRequestContext, 'call', _21 => _21(), 'optionalAccess', _22 => _22.requestId]);
237
+ const reqId = _optionalChain([_chunkURKE3OXNcjs.getRequestContext.call(void 0, ), 'optionalAccess', _17 => _17.requestId]);
256
238
  emit(
257
239
  {
258
240
  model,
@@ -260,7 +242,7 @@ function traceOps(model, target, ops) {
260
242
  durationMs,
261
243
  statements: frame.statements,
262
244
  ...reqId !== void 0 && { reqId },
263
- ...error !== void 0 && { error: _nullishCoalesce(_optionalChain([error, 'optionalAccess', _23 => _23.message]), () => ( String(error))) }
245
+ ...error !== void 0 && { error: _nullishCoalesce(_optionalChain([error, 'optionalAccess', _18 => _18.message]), () => ( String(error))) }
264
246
  },
265
247
  site,
266
248
  !parent
@@ -286,7 +268,7 @@ function traceOps(model, target, ops) {
286
268
 
287
269
  var invalidators = /* @__PURE__ */ new WeakMap();
288
270
  function invalidatePreparedStatements(pool2) {
289
- _optionalChain([invalidators, 'access', _24 => _24.get, 'call', _25 => _25(pool2), 'optionalCall', _26 => _26()]);
271
+ _optionalChain([invalidators, 'access', _19 => _19.get, 'call', _20 => _20(pool2), 'optionalCall', _21 => _21()]);
290
272
  }
291
273
  function preparedDriver(pool2, max) {
292
274
  if (!Number.isSafeInteger(max) || max < 0) {
@@ -373,7 +355,7 @@ async function connectPostgres(url, poolConfig = {}) {
373
355
  let PoolCtor;
374
356
  try {
375
357
  const pg = await Promise.resolve().then(() => _interopRequireWildcard(require("pg")));
376
- PoolCtor = _nullishCoalesce(_optionalChain([pg, 'access', _27 => _27.default, 'optionalAccess', _28 => _28.Pool]), () => ( pg.Pool));
358
+ PoolCtor = _nullishCoalesce(_optionalChain([pg, 'access', _22 => _22.default, 'optionalAccess', _23 => _23.Pool]), () => ( pg.Pool));
377
359
  } catch (err) {
378
360
  throw notInstalled(err, "pg", "npm install pg drizzle-orm");
379
361
  }
@@ -492,7 +474,7 @@ async function closePostgres() {
492
474
  const p = pool;
493
475
  pool = void 0;
494
476
  orm = void 0;
495
- await _optionalChain([p, 'optionalAccess', _29 => _29.end, 'call', _30 => _30()]);
477
+ await _optionalChain([p, 'optionalAccess', _24 => _24.end, 'call', _25 => _25()]);
496
478
  }
497
479
 
498
480
 
@@ -515,9 +497,5 @@ async function closePostgres() {
515
497
 
516
498
 
517
499
 
518
-
519
-
520
-
521
-
522
- exports.processState = processState; exports.runWithContext = runWithContext; exports.setCurrentUser = setCurrentUser; exports.getCurrentUser = getCurrentUser; exports.configureLogger = configureLogger; exports.getLogger = getLogger; exports.logger = logger; exports.requestLogger = requestLogger; exports.getQueryMetrics = getQueryMetrics; exports.resetQueryMetrics = resetQueryMetrics; exports.configureQueryLog = configureQueryLog; exports.whenQueryTracking = whenQueryTracking; exports.countStatement = countStatement; exports.untracked = untracked; exports.traceOps = traceOps; exports.invalidatePreparedStatements = invalidatePreparedStatements; exports.notInstalled = notInstalled; exports.connectPostgres = connectPostgres; exports.explainPostgresError = explainPostgresError; exports.checkConnectionBudget = checkConnectionBudget; exports.getOrm = getOrm; exports.getPool = getPool; exports.closePostgres = closePostgres;
523
- //# sourceMappingURL=chunk-JP36TLL4.cjs.map
500
+ exports.configureLogger = configureLogger; exports.getLogger = getLogger; exports.logger = logger; exports.requestLogger = requestLogger; exports.getQueryMetrics = getQueryMetrics; exports.resetQueryMetrics = resetQueryMetrics; exports.configureQueryLog = configureQueryLog; exports.whenQueryTracking = whenQueryTracking; exports.countStatement = countStatement; exports.untracked = untracked; exports.traceOps = traceOps; exports.invalidatePreparedStatements = invalidatePreparedStatements; exports.notInstalled = notInstalled; exports.connectPostgres = connectPostgres; exports.explainPostgresError = explainPostgresError; exports.checkConnectionBudget = checkConnectionBudget; exports.getOrm = getOrm; exports.getPool = getPool; exports.closePostgres = closePostgres;
501
+ //# sourceMappingURL=chunk-JHCXIYJH.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-JHCXIYJH.cjs","../src/logger.ts","../src/db/query-log.ts","../src/db/prepared-statements.ts","../src/db/postgres.ts"],"names":["pool"],"mappings":"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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-JHCXIYJH.cjs","sourcesContent":[null,"import { traceLogFields } from './tracing.js';\nimport cluster from 'node:cluster';\nimport { randomUUID } from 'node:crypto';\nimport type { RequestHandler } from 'express';\nimport pc from 'picocolors';\nimport { pino, type Logger, type DestinationStream } from 'pino';\nimport type { LoggingConfig } from './types.js';\nimport { getRequestContext } from './context.js';\n\nexport type { Logger };\n\nconst LEVEL_LABELS: Record<number, string> = {\n 10: pc.gray('TRACE'),\n 20: pc.blue('DEBUG'),\n 30: pc.green('INFO '),\n 40: pc.yellow('WARN '),\n 50: pc.red('ERROR'),\n 60: pc.bgRed('FATAL'),\n};\n\nconst OMIT = new Set(['level', 'time', 'msg', 'pid', 'hostname', 'worker', 'reqId']);\n\n// Dev-friendly one-line renderer, so readable output doesn't need pino-pretty or a\n// transport worker thread: `12:00:01 INFO [w2] a1b2c3d4 GET /users 200 (3ms)`.\nfunction prettyStream(out: NodeJS.WritableStream = process.stdout): DestinationStream {\n return {\n write(line: string) {\n let rec: Record<string, unknown>;\n try {\n rec = JSON.parse(line) as Record<string, unknown>;\n } catch {\n out.write(line);\n return;\n }\n const time = new Date(rec['time'] as number).toTimeString().slice(0, 8);\n const level = LEVEL_LABELS[rec['level'] as number] ?? String(rec['level']);\n const worker = rec['worker'] !== undefined ? pc.dim(`[${String(rec['worker'])}] `) : '';\n const reqId = rec['reqId'] ? pc.magenta(String(rec['reqId']).slice(0, 8)) + ' ' : '';\n const extra = Object.entries(rec).filter(([k]) => !OMIT.has(k));\n const err = rec['err'] as { stack?: string } | undefined;\n const fields = extra\n .filter(([k]) => k !== 'err')\n .map(([k, v]) => `${k}=${typeof v === 'string' ? v : JSON.stringify(v)}`)\n .join(' ');\n out.write(\n `${pc.dim(time)} ${level} ${worker}${reqId}${String(rec['msg'] ?? '')}` +\n (fields ? ' ' + pc.dim(fields) : '') +\n (err?.stack ? '\\n' + pc.red(err.stack) : '') +\n '\\n',\n );\n },\n };\n}\n\nfunction workerLabel(): string {\n return cluster.isWorker ? `w${cluster.worker?.id ?? '?'}` : 'primary';\n}\n\nfunction build(config: LoggingConfig | false | undefined): Logger {\n if (config === false) return pino({ level: 'silent' });\n const opts = config ?? {};\n const pretty =\n opts.pretty ?? (process.env['NODE_ENV'] !== 'production' && process.stdout.isTTY === true);\n const base = { worker: workerLabel() };\n const level = opts.level ?? 'info';\n return pretty\n ? pino({ level, base, errorKey: 'err' }, prettyStream())\n : pino({ level, base, errorKey: 'err', timestamp: pino.stdTimeFunctions.isoTime });\n}\n\nlet rootLogger: Logger = build(undefined);\nlet logRequests = true;\n\n/** Called by ignite() during Pre-Flight; before that the defaults apply. */\nexport function configureLogger(config: LoggingConfig | false | undefined): void {\n rootLogger = build(config);\n logRequests = config !== false && (config?.requests ?? true);\n}\n\n/**\n * The logger for the current scope: inside a request it is a child carrying that\n * request's `reqId`, so everything logged while handling it can be correlated;\n * elsewhere (startup, task handlers, timers) it is the root logger.\n */\nexport function getLogger(): Logger {\n const log = getRequestContext()?.log ?? rootLogger;\n const fields = traceLogFields();\n return fields.span_id && log.bindings().span_id !== fields.span_id ? log.child(fields) : log;\n}\n\n/** Root logger proxy — always reflects the latest configureLogger() call. */\nexport const logger: Logger = new Proxy({} as Logger, {\n get(_t, prop) {\n const target = getLogger() as unknown as Record<PropertyKey, unknown>;\n const value = target[prop];\n return typeof value === 'function'\n ? (value as (...a: unknown[]) => unknown).bind(target)\n : value;\n },\n});\n\nconst SAFE_REQUEST_ID = /^[\\w.:-]{1,128}$/;\n\n/**\n * Assigns the request ID (trusting a well-formed incoming `X-Request-Id`, e.g. from\n * a load balancer), echoes it back, attaches `req.id` / `req.log`, and logs one\n * line per completed request. Must run inside the request's context.\n */\nexport function requestLogger(): RequestHandler {\n return (req, res, next) => {\n const incoming = req.get('x-request-id');\n const id = incoming && SAFE_REQUEST_ID.test(incoming) ? incoming : randomUUID();\n const log = rootLogger.child({ reqId: id, ...traceLogFields() });\n\n req.id = id;\n req.log = log;\n res.setHeader('X-Request-Id', id);\n const ctx = getRequestContext();\n if (ctx) {\n ctx.requestId = id;\n ctx.log = log;\n }\n\n if (logRequests) {\n const start = process.hrtime.bigint();\n res.on('finish', () => {\n const durationMs = Number(process.hrtime.bigint() - start) / 1e6;\n const status = res.statusCode;\n const line = {\n method: req.method,\n url: req.originalUrl,\n status,\n durationMs: Math.round(durationMs * 10) / 10,\n };\n const msg = `${req.method} ${req.originalUrl} ${status}`;\n if (status >= 500) log.error(line, msg);\n else if (status >= 400) log.warn(line, msg);\n else log.info(line, msg);\n });\n }\n next();\n };\n}\n\ndeclare module 'express-serve-static-core' {\n interface Request {\n /** Request ID — the incoming `X-Request-Id` if well-formed, else a UUID. */\n id: string;\n /** Logger bound to this request's ID. */\n log: Logger;\n }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { LoggingConfig } from '../types.js';\nimport { getRequestContext } from '../context.js';\nimport { getLogger } from '../logger.js';\n\n// Query logging (`logging.queries`): one event per model operation — model, operation,\n// duration, how many database statements it issued, and the request ID — plus slow-query\n// warnings and an N+1 detector. Statements are counted at the driver: Drizzle's logger on\n// PostgreSQL, mongoose's debug hook on MongoDB.\n\n/** One finished model operation. */\nexport interface QueryEvent {\n model: string;\n op: string;\n durationMs: number;\n /** Database statements (SQL statements / MongoDB commands) issued, nested calls included. */\n statements: number;\n /** The request it ran in, if any. */\n reqId?: string;\n /** Set when it threw. */\n error?: string;\n}\n\n/** Aggregated per-process model operation statistics; never contains SQL/parameter values. */\nexport interface QueryMetric {\n model: string;\n op: string;\n calls: number;\n errors: number;\n statements: number;\n totalMs: number;\n minMs: number;\n maxMs: number;\n meanMs: number;\n slow: number;\n}\nexport interface QueryMetricsSnapshot {\n enabled: boolean;\n since: number;\n dropped: number;\n entries: ReadonlyArray<QueryMetric>;\n}\nconst metrics = new Map<string, QueryMetric>();\nlet metricsSince = Date.now();\nlet metricsDropped = 0;\n\n/** Returns detached, deterministically ordered counters; no logs or SQL are exposed. */\nexport function getQueryMetrics(): QueryMetricsSnapshot {\n return {\n enabled: !!config?.metricsLimit,\n since: metricsSince,\n dropped: metricsDropped,\n entries: [...metrics.values()]\n .map((entry) => ({ ...entry }))\n .sort((a, b) => a.model.localeCompare(b.model) || a.op.localeCompare(b.op)),\n };\n}\n/** Clears this process's counters/window; does not disable collection. */\nexport function resetQueryMetrics(): void {\n metrics.clear();\n metricsDropped = 0;\n metricsSince = Date.now();\n}\nfunction collectMetric(event: QueryEvent): void {\n if (!config?.metricsLimit) return;\n const key = event.model + '\\0' + event.op;\n let metric = metrics.get(key);\n if (!metric) {\n if (metrics.size >= config.metricsLimit) {\n metricsDropped++;\n return;\n }\n metric = {\n model: event.model,\n op: event.op,\n calls: 0,\n errors: 0,\n statements: 0,\n totalMs: 0,\n minMs: event.durationMs,\n maxMs: event.durationMs,\n meanMs: 0,\n slow: 0,\n };\n metrics.set(key, metric);\n }\n metric.calls++;\n if (event.error !== undefined) metric.errors++;\n metric.statements += event.statements;\n metric.totalMs += event.durationMs;\n metric.minMs = Math.min(metric.minMs, event.durationMs);\n metric.maxMs = Math.max(metric.maxMs, event.durationMs);\n metric.meanMs = metric.totalMs / metric.calls;\n if (event.durationMs >= config.slowMs) metric.slow++;\n}\n\ninterface Resolved {\n all: boolean;\n slowMs: number;\n nPlusOne: number | false;\n metricsLimit: number;\n}\n\nconst DEFAULTS = { slowMs: 500, nPlusOne: 10 } as const;\n\nlet config: Resolved | undefined;\nconst listeners = new Set<(event: QueryEvent) => void>();\nconst enableHooks: (() => void)[] = [];\n\n/** Called by ignite() during Pre-Flight, next to configureLogger(). */\nexport function configureQueryLog(logging: LoggingConfig | false | undefined): void {\n const q = logging === false ? undefined : logging?.queries;\n config = !q\n ? undefined\n : q === true\n ? { all: true, ...DEFAULTS, metricsLimit: 0 }\n : {\n all: q.all ?? false,\n slowMs: q.slowMs ?? DEFAULTS.slowMs,\n nPlusOne: q.nPlusOne ?? DEFAULTS.nPlusOne,\n metricsLimit: !q.metrics\n ? 0\n : typeof q.metrics === 'object'\n ? (q.metrics.maxEntries ?? 1000)\n : 1000,\n };\n if (config && (!Number.isSafeInteger(config.metricsLimit) || config.metricsLimit < 0)) {\n config = undefined;\n resetQueryMetrics();\n throw new Error('[EFC] logging.queries.metrics.maxEntries must be a nonnegative safe integer');\n }\n resetQueryMetrics();\n if (config) for (const hook of enableHooks) hook();\n}\n\nfunction active(): boolean {\n return config !== undefined || listeners.size > 0;\n}\n\n/**\n * Receives every model operation while subscribed (whether or not `logging.queries` is\n * on). Returns the unsubscribe function. Internal — tests use it to count statements.\n */\nexport function onQuery(listener: (event: QueryEvent) => void): () => void {\n listeners.add(listener);\n for (const hook of enableHooks) hook();\n return () => listeners.delete(listener);\n}\n\n/** Registers a driver hook to install once query tracking is first needed. */\nexport function whenQueryTracking(install: () => void): void {\n enableHooks.push(install);\n if (active()) install();\n}\n\ninterface Frame {\n statements: number;\n parent: Frame | undefined;\n}\n\nconst frames = new AsyncLocalStorage<Frame | undefined>();\n\n/** Called by the driver hooks for each statement sent to the database. */\nexport function countStatement(): void {\n for (let f = frames.getStore(); f; f = f.parent) f.statements++;\n}\n\n/** Runs `fn` outside any operation, so its statements (e.g. auto-sync) are not counted. */\nexport function untracked<R>(fn: () => R): R {\n return frames.run(undefined, fn);\n}\n\n// The first stack frame outside EFC: the line in the app that made the call.\nfunction callSite(callee: (...args: never[]) => unknown): string | undefined {\n const holder: { stack?: string } = {};\n Error.captureStackTrace(holder, callee);\n const line = holder.stack?.split('\\n')[1];\n return line?.trim().replace(/^at /, '');\n}\n\nfunction emit(event: QueryEvent, site: string | undefined, top: boolean): void {\n for (const listener of listeners) listener(event);\n if (!config) return;\n collectMetric(event);\n const log = getLogger();\n const msg = `${event.model}.${event.op} ${event.durationMs}ms`;\n // The request's logger already carries reqId.\n const fields: Partial<QueryEvent> = { ...event };\n delete fields.reqId;\n if (event.durationMs >= config.slowMs) {\n log.warn({ ...fields, slow: true }, `Slow query: ${msg}`);\n } else if (config.all) {\n log.info(fields, msg);\n }\n if (top && config.nPlusOne !== false) detectNPlusOne(event, site, config.nPlusOne);\n}\n\nfunction detectNPlusOne(event: QueryEvent, site: string | undefined, threshold: number): void {\n const ctx = getRequestContext();\n if (!ctx) return;\n const key = `${event.model}.${event.op}`;\n const counts = (ctx.queryCounts ??= new Map());\n const n = (counts.get(key) ?? 0) + 1;\n counts.set(key, n);\n if (n !== threshold) return;\n getLogger().warn(\n { model: event.model, op: event.op, count: n, ...(site !== undefined && { site }) },\n `Possible N+1: ${key} ran ${n} times in one request — load them in one query instead`,\n );\n}\n\n/**\n * Wraps a model's public operations so each call is timed, its statements counted and\n * the result reported. A no-op wrapper while query logging is off.\n */\nexport function traceOps<M extends object>(model: string, target: M, ops: readonly string[]): M {\n const t = target as Record<string, unknown>;\n for (const op of ops) {\n const fn = t[op] as (...args: unknown[]) => Promise<unknown>;\n const traced = function (this: unknown, ...args: unknown[]): Promise<unknown> {\n if (!active()) return fn.apply(this, args);\n const parent = frames.getStore();\n const frame: Frame = { statements: 0, parent };\n // Only N+1 checks need the call site; capture it while the caller is on the stack.\n const site = !parent && config && config.nPlusOne !== false ? callSite(traced) : undefined;\n const start = process.hrtime.bigint();\n const finish = (error?: unknown) => {\n const durationMs = Math.round(Number(process.hrtime.bigint() - start) / 1e5) / 10;\n const reqId = getRequestContext()?.requestId;\n emit(\n {\n model,\n op,\n durationMs,\n statements: frame.statements,\n ...(reqId !== undefined && { reqId }),\n ...(error !== undefined && { error: (error as Error)?.message ?? String(error) }),\n },\n site,\n !parent,\n );\n };\n return frames\n .run(frame, () => fn.apply(this, args))\n .then(\n (result) => {\n finish();\n return result;\n },\n (err: unknown) => {\n finish(err);\n throw err;\n },\n );\n };\n t[op] = traced;\n }\n return target;\n}\n","import { createHash } from 'node:crypto';\nimport type { Pool, PoolClient } from 'pg';\n\nconst invalidators = new WeakMap<Pool, () => void>();\n\n/** Clear reusable shapes after EFC changes a table; existing server names stay bounded. */\nexport function invalidatePreparedStatements(pool: Pool): void {\n invalidators.get(pool)?.();\n}\n\n/**\n * Private Drizzle driver view. The exported native Pool is unchanged. Each real\n * connection owns its names, including connections checked out for transactions.\n * Once its lifetime budget is full, new shapes use the ordinary unnamed protocol.\n */\nexport function preparedDriver(pool: Pool, max: number): Pool {\n if (!Number.isSafeInteger(max) || max < 0) {\n throw new Error('[EFC] databasePool.preparedStatements.max must be a nonnegative safe integer');\n }\n if (max === 0) return pool;\n let generation = 0;\n invalidators.set(pool, () => {\n generation++;\n });\n const clients = new WeakMap<PoolClient, PoolClient>();\n const wrap = (client: PoolClient): PoolClient => {\n const existing = clients.get(client);\n if (existing) return existing;\n let allocated = 0;\n let seenGeneration = generation;\n const names = new Map<string, string>();\n const proxy = new Proxy(client, {\n get(target, prop) {\n if (prop === 'query')\n return (...args: unknown[]) => {\n if (seenGeneration !== generation) {\n names.clear();\n seenGeneration = generation;\n }\n const query = args[0];\n if (query && typeof query === 'object' && 'text' in query) {\n const config = query as Record<string, unknown>;\n const text = config.text;\n // No DDL, transaction control, multi-statements, or caller-named queries.\n if (\n !config.name &&\n typeof text === 'string' &&\n /^\\s*(select|insert|update|delete|with)\\b/i.test(text) &&\n !text.trim().replace(/;$/, '').includes(';')\n ) {\n let name = names.get(text);\n if (!name && allocated < max) {\n name =\n 'efc_auto_' +\n createHash('sha256')\n .update(generation + ':' + text)\n .digest('hex')\n .slice(0, 48);\n names.set(text, name);\n allocated++;\n }\n if (name) args[0] = { ...config, name };\n }\n }\n return Reflect.apply(target.query, target, args);\n };\n const value = Reflect.get(target, prop, target) as unknown;\n return typeof value === 'function' ? value.bind(target) : value;\n },\n });\n clients.set(client, proxy);\n return proxy;\n };\n return new Proxy(pool, {\n get(target, prop) {\n if (prop === 'connect') return async () => wrap(await target.connect());\n if (prop === 'query')\n return async (...args: unknown[]) => {\n const client = await target.connect();\n // Match Pool.query's connection-error ownership while checked out: do\n // not leave a network error unhandled, and discard failed connections.\n let failure: Error | undefined;\n const onError = (err: Error) => {\n failure = err;\n };\n client.once('error', onError);\n try {\n return await Reflect.apply(wrap(client).query, wrap(client), args);\n } catch (err) {\n failure = err instanceof Error ? err : new Error(String(err));\n throw err;\n } finally {\n client.removeListener('error', onError);\n client.release(failure);\n }\n };\n const value = Reflect.get(target, prop, target) as unknown;\n return typeof value === 'function' ? value.bind(target) : value;\n },\n });\n}\n","import type { Pool } from 'pg';\nimport { getLogger } from '../logger.js';\nimport { countStatement } from './query-log.js';\nimport type { DatabasePoolConfig } from '../types.js';\nimport { preparedDriver } from './prepared-statements.js';\n\n// Pre-Flight's PostgreSQL connection: a node-postgres Pool (exposed as `db`) plus a\n// Drizzle instance over it that the model adapter queries through.\n\n/* eslint-disable @typescript-eslint/no-explicit-any -- drizzle is an optional peer, loaded dynamically */\nlet pool: Pool | undefined;\n\n/** Only a genuinely missing package becomes \"not installed\"; other load errors surface as-is. */\nexport function notInstalled(err: unknown, pkg: string, install: string): Error {\n const code = (err as { code?: string }).code;\n return code === 'ERR_MODULE_NOT_FOUND' || code === 'MODULE_NOT_FOUND'\n ? new Error(`[EFC] ${pkg} is not installed. Run: ${install}`)\n : (err as Error);\n}\nlet orm: any;\n\nexport async function connectPostgres(\n url: string,\n poolConfig: DatabasePoolConfig = {},\n): Promise<Pool> {\n let PoolCtor: typeof Pool;\n try {\n const pg = (await import('pg')) as unknown as {\n default?: { Pool: typeof Pool };\n Pool?: typeof Pool;\n };\n PoolCtor = (pg.default?.Pool ?? pg.Pool)!;\n } catch (err) {\n throw notInstalled(err, 'pg', 'npm install pg drizzle-orm');\n }\n let drizzle: (client: Pool, config: object) => unknown;\n try {\n ({ drizzle } = (await import('drizzle-orm/node-postgres')) as unknown as {\n drizzle: (client: Pool, config: object) => unknown;\n });\n } catch (err) {\n throw notInstalled(err, 'drizzle-orm', 'npm install drizzle-orm');\n }\n\n const next = new PoolCtor({\n connectionString: url,\n ...(poolConfig.max !== undefined && { max: poolConfig.max }),\n ...(poolConfig.idleTimeoutMs !== undefined && { idleTimeoutMillis: poolConfig.idleTimeoutMs }),\n ...(poolConfig.connectionTimeoutMs !== undefined && {\n connectionTimeoutMillis: poolConfig.connectionTimeoutMs,\n }),\n });\n const prepared = poolConfig.preparedStatements;\n const maxStatements =\n prepared === false ? 0 : typeof prepared === 'object' ? (prepared.max ?? 100) : 100;\n let driver: Pool;\n try {\n driver = preparedDriver(next, maxStatements);\n } catch (err) {\n await next.end();\n throw err;\n }\n // Idle-client errors (e.g. the server restarting) are emitted on the pool; unhandled\n // they would crash the process.\n next.on('error', (err) => getLogger().error({ err }, 'PostgreSQL pool error'));\n try {\n await next.query('select 1');\n } catch (err) {\n await next.end().catch(() => {});\n throw explainPostgresError(err, url);\n }\n pool = next;\n // Every model statement goes through Drizzle, in or out of a transaction: count it.\n orm = drizzle(driver, { logger: { logQuery: countStatement } });\n getLogger().info('PostgreSQL connected');\n return next;\n}\n\n/** Where a connection string points, without the password (for error messages). */\nfunction describeUrl(url: string): { where: string; user: string; database: string } {\n try {\n const u = new URL(url);\n const database = decodeURIComponent(u.pathname.slice(1)) || '(default)';\n return {\n where: `${u.hostname || 'localhost'}:${u.port || '5432'}`,\n user: decodeURIComponent(u.username) || '(none)',\n database,\n };\n } catch {\n return { where: '(unparsable DATABASE_URL)', user: '?', database: '?' };\n }\n}\n\n/**\n * node-postgres' connection errors, said in terms of DATABASE_URL — e.g. a URL with no password\n * surfaces from pg as \"SASL: SCRAM-SERVER-FIRST-MESSAGE: client password must be a string\".\n * Unrecognised errors come back unchanged. The original is kept as `cause`.\n */\nexport function explainPostgresError(err: unknown, url: string): Error {\n const e = err as { code?: string; message?: string };\n const msg = e.message ?? '';\n const { where, user, database } = describeUrl(url);\n const hosted = 'For Neon, Supabase or RDS, copy the full connection string from the dashboard.';\n let text: string | undefined;\n if (/client password must be a string/.test(msg)) {\n text = `PostgreSQL asked for a password and DATABASE_URL has none (user \"${user}\" at ${where}). Put it in the URL: postgres://${user === '(none)' ? 'user' : user}:<password>@${where}/${database === '(default)' ? 'db' : database}. ${hosted}`;\n } else if (e.code === '28P01') {\n text = `PostgreSQL rejected the password for user \"${user}\" at ${where}. Check DATABASE_URL (special characters in the password must be URL-encoded). ${hosted}`;\n } else if (e.code === '28000' && /role .* does not exist/.test(msg)) {\n text = `PostgreSQL has no user \"${user}\" at ${where}. Create it (CREATE ROLE ${user} LOGIN PASSWORD '…';) or fix the user in DATABASE_URL.`;\n } else if (/no pg_hba\\.conf entry.*no encryption/.test(msg)) {\n text = `PostgreSQL at ${where} only accepts encrypted connections. Add ?sslmode=require to DATABASE_URL.`;\n } else if (e.code === '28000') {\n text = `PostgreSQL at ${where} refused user \"${user}\": ${msg}`;\n } else if (e.code === '3D000') {\n text = `Database \"${database}\" does not exist at ${where}. Create it first: createdb ${database} (or CREATE DATABASE \"${database}\";).`;\n } else if (/does not support SSL/.test(msg)) {\n text = `PostgreSQL at ${where} doesn't support SSL. Remove sslmode / ssl from DATABASE_URL (local servers usually run without it).`;\n } else if (e.code === 'ECONNREFUSED') {\n text = `Nothing is accepting connections at ${where}. Is PostgreSQL running, and is the host/port in DATABASE_URL right?`;\n } else if (e.code === 'ENOTFOUND' || e.code === 'EAI_AGAIN') {\n text = `Can't resolve the PostgreSQL host in DATABASE_URL (${where}). Check the hostname.`;\n } else if (e.code === 'ETIMEDOUT' || /timeout/i.test(msg)) {\n text = `Timed out connecting to PostgreSQL at ${where}. Check the host, and that a firewall / the provider's IP allow-list lets this machine in.`;\n }\n return text ? new Error(`[EFC] ${text}`, { cause: err }) : (err as Error);\n}\n\n/**\n * Every cluster worker opens its own pools, so a machine's total is `workers × (pool + …)`.\n * Logs that total against the server's limit, warning when this machine alone can exhaust it.\n * Best effort: a failure to read the limit is ignored.\n */\nexport async function checkConnectionBudget(perMachine: number, breakdown: string): Promise<void> {\n const log = getLogger();\n try {\n const { rows } = await getPool().query<{ max: number; reserved: number }>(\n `select current_setting('max_connections')::int as max,\n current_setting('superuser_reserved_connections')::int as reserved`,\n );\n const { max, reserved } = rows[0]!;\n const usable = max - reserved;\n if (perMachine > usable) {\n log.warn(\n `[EFC] PostgreSQL connections: up to ${perMachine} from this machine (${breakdown}), but the server allows ${usable} (max_connections ${max} − ${reserved} reserved). Under load, queries will fail with \"too many clients\". Lower databasePool.max or workers, or put PgBouncer in front.`,\n );\n } else {\n log.info(\n `PostgreSQL connections: up to ${perMachine} from this machine (${breakdown}) of ${usable} allowed — multiply by your instance count if you run several`,\n );\n }\n } catch {\n /* can't read the limit (permissions, pooler) — nothing to compare against */\n }\n}\n\nexport function getOrm(): any {\n if (!orm) {\n throw new Error(\n '[EFC] PostgreSQL not connected — set database/databaseUrl in ignite() (or call connectPostgres)',\n );\n }\n return orm;\n}\n\nexport function getPool(): Pool {\n if (!pool) throw new Error('[EFC] PostgreSQL not connected');\n return pool;\n}\n\nexport async function closePostgres(): Promise<void> {\n const p = pool;\n pool = undefined;\n orm = undefined;\n await p?.end();\n}\n"]}