express-file-cluster 0.11.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/dist/auth/index.cjs +8 -7
  2. package/dist/auth/index.cjs.map +1 -1
  3. package/dist/auth/index.d.cts +1 -1
  4. package/dist/auth/index.d.ts +1 -1
  5. package/dist/auth/index.js +7 -5
  6. package/dist/{chunk-JBOMTZT5.js → chunk-3JQWQF2M.js} +3 -3
  7. package/dist/chunk-3ROVNEDR.js +20 -0
  8. package/dist/chunk-3ROVNEDR.js.map +1 -0
  9. package/dist/{chunk-WHBSVYUY.cjs → chunk-4FQP6QX3.cjs} +3 -3
  10. package/dist/{chunk-WHBSVYUY.cjs.map → chunk-4FQP6QX3.cjs.map} +1 -1
  11. package/dist/chunk-546TNO2V.js +226 -0
  12. package/dist/chunk-546TNO2V.js.map +1 -0
  13. package/dist/{chunk-EJDZZ4KX.js → chunk-74R37C4I.js} +48 -21
  14. package/dist/chunk-74R37C4I.js.map +1 -0
  15. package/dist/{chunk-H2PVWCWC.cjs → chunk-A2QGDWCG.cjs} +15 -8
  16. package/dist/chunk-A2QGDWCG.cjs.map +1 -0
  17. package/dist/{chunk-DGYPIIJE.cjs → chunk-AG7PVYPE.cjs} +90 -64
  18. package/dist/chunk-AG7PVYPE.cjs.map +1 -0
  19. package/dist/{chunk-O2E7H2XA.js → chunk-BCSJOPYH.js} +2 -2
  20. package/dist/{chunk-OM2XJJWX.js → chunk-EBJELA7T.js} +30 -25
  21. package/dist/chunk-EBJELA7T.js.map +1 -0
  22. package/dist/{chunk-IEF6AEK3.cjs → chunk-H6MHRHUP.cjs} +104 -50
  23. package/dist/chunk-H6MHRHUP.cjs.map +1 -0
  24. package/dist/chunk-I2IVJURJ.cjs +20 -0
  25. package/dist/chunk-I2IVJURJ.cjs.map +1 -0
  26. package/dist/{chunk-6WTMRZS7.cjs → chunk-IG3V2IOK.cjs} +57 -30
  27. package/dist/chunk-IG3V2IOK.cjs.map +1 -0
  28. package/dist/chunk-JAPZYQVJ.cjs +143 -0
  29. package/dist/chunk-JAPZYQVJ.cjs.map +1 -0
  30. package/dist/{chunk-QSIP7YLW.cjs → chunk-JHCXIYJH.cjs} +25 -48
  31. package/dist/chunk-JHCXIYJH.cjs.map +1 -0
  32. package/dist/{chunk-GWMW6XY7.cjs → chunk-JVB5NLEM.cjs} +15 -13
  33. package/dist/chunk-JVB5NLEM.cjs.map +1 -0
  34. package/dist/chunk-PUM5ZDAH.js +140 -0
  35. package/dist/chunk-PUM5ZDAH.js.map +1 -0
  36. package/dist/{chunk-CGY7JU4Y.cjs → chunk-PUYBKDYD.cjs} +11 -2
  37. package/dist/chunk-PUYBKDYD.cjs.map +1 -0
  38. package/dist/{chunk-336IU55W.js → chunk-QLM3JEER.js} +5 -3
  39. package/dist/{chunk-336IU55W.js.map → chunk-QLM3JEER.js.map} +1 -1
  40. package/dist/{chunk-SOU3PBJC.cjs → chunk-SV4C4HWP.cjs} +89 -89
  41. package/dist/{chunk-SOU3PBJC.cjs.map → chunk-SV4C4HWP.cjs.map} +1 -1
  42. package/dist/{chunk-2IDRC7RK.js → chunk-UJ2ISRLP.js} +11 -34
  43. package/dist/chunk-UJ2ISRLP.js.map +1 -0
  44. package/dist/chunk-URKE3OXN.cjs +226 -0
  45. package/dist/chunk-URKE3OXN.cjs.map +1 -0
  46. package/dist/{chunk-DTMDJGRW.cjs → chunk-VLGN3XUM.cjs} +40 -35
  47. package/dist/chunk-VLGN3XUM.cjs.map +1 -0
  48. package/dist/{chunk-R6GPQZLI.js → chunk-X2B7WBKH.js} +88 -34
  49. package/dist/chunk-X2B7WBKH.js.map +1 -0
  50. package/dist/chunk-Y7I2633P.js +12 -0
  51. package/dist/chunk-Y7I2633P.js.map +1 -0
  52. package/dist/{chunk-B6MB6HEG.js → chunk-ZBQUYFI3.js} +14 -7
  53. package/dist/chunk-ZBQUYFI3.js.map +1 -0
  54. package/dist/{chunk-LECHRAU3.js → chunk-ZU2GK5WY.js} +84 -58
  55. package/dist/chunk-ZU2GK5WY.js.map +1 -0
  56. package/dist/cli/db-runner.cjs +26 -25
  57. package/dist/cli/db-runner.cjs.map +1 -1
  58. package/dist/cli/db-runner.js +5 -3
  59. package/dist/cli/db-runner.js.map +1 -1
  60. package/dist/cli/index.cjs +20 -16
  61. package/dist/cli/index.cjs.map +1 -1
  62. package/dist/cli/index.js +13 -8
  63. package/dist/cli/index.js.map +1 -1
  64. package/dist/docs/api-reference/auth.md +2 -0
  65. package/dist/docs/api-reference/ignite.md +4 -0
  66. package/dist/docs/api-reference/tasks.md +6 -2
  67. package/dist/docs/api-reference/testing.md +2 -0
  68. package/dist/docs/api-reference/tracing.md +18 -0
  69. package/dist/docs/cli/add.md +1 -1
  70. package/dist/docs/cli/diagnostics.md +1 -1
  71. package/dist/docs/cli/index.md +1 -1
  72. package/dist/docs/core-concepts/background-tasks.md +7 -1
  73. package/dist/docs/core-concepts/file-based-routing.md +4 -0
  74. package/dist/docs/core-concepts/middleware.md +2 -0
  75. package/dist/docs/guides/caching.md +12 -0
  76. package/dist/docs/guides/error-handling.md +2 -0
  77. package/dist/docs/guides/feature-matrix.md +7 -0
  78. package/dist/docs/guides/logging.md +2 -0
  79. package/dist/docs/guides/tracing.md +64 -0
  80. package/dist/docs/index.md +2 -1
  81. package/dist/docs/skills/SKILL.md +5 -3
  82. package/dist/docs/skills/api-surface.md +8 -0
  83. package/dist/docs/skills/auth-internals.md +4 -2
  84. package/dist/docs/skills/pre-flight.md +4 -0
  85. package/dist/docs/skills/routing-rules.md +3 -1
  86. package/dist/docs/skills/tasks-internals.md +12 -4
  87. package/dist/docs/skills/what-not-to-invent.md +2 -0
  88. package/dist/index.cjs +167 -71
  89. package/dist/index.cjs.map +1 -1
  90. package/dist/index.d.cts +5 -14
  91. package/dist/index.d.ts +5 -14
  92. package/dist/index.js +124 -27
  93. package/dist/index.js.map +1 -1
  94. package/dist/pgboss-backend-5DXF4G22.js +16 -0
  95. package/dist/pgboss-backend-KRTFHRNZ.cjs +16 -0
  96. package/dist/pgboss-backend-KRTFHRNZ.cjs.map +1 -0
  97. package/dist/registry/index.json +1 -1
  98. package/dist/tasks/index.cjs +3 -3
  99. package/dist/tasks/index.d.cts +2 -2
  100. package/dist/tasks/index.d.ts +2 -2
  101. package/dist/tasks/index.js +2 -1
  102. package/dist/testing.cjs +16 -14
  103. package/dist/testing.cjs.map +1 -1
  104. package/dist/testing.d.cts +2 -1
  105. package/dist/testing.d.ts +2 -1
  106. package/dist/testing.js +10 -7
  107. package/dist/testing.js.map +1 -1
  108. package/dist/thread-runner.cjs +5 -4
  109. package/dist/thread-runner.cjs.map +1 -1
  110. package/dist/thread-runner.d.cts +1 -1
  111. package/dist/thread-runner.d.ts +1 -1
  112. package/dist/thread-runner.js +4 -2
  113. package/dist/{types-D3QmZgeX.d.ts → types-Bgeqpm-n.d.cts} +12 -1
  114. package/dist/{types-D3QmZgeX.d.cts → types-Bgeqpm-n.d.ts} +12 -1
  115. package/package.json +7 -3
  116. package/dist/chunk-2IDRC7RK.js.map +0 -1
  117. package/dist/chunk-3SWI46YK.js +0 -74
  118. package/dist/chunk-3SWI46YK.js.map +0 -1
  119. package/dist/chunk-6WTMRZS7.cjs.map +0 -1
  120. package/dist/chunk-B6MB6HEG.js.map +0 -1
  121. package/dist/chunk-CGY7JU4Y.cjs.map +0 -1
  122. package/dist/chunk-DGYPIIJE.cjs.map +0 -1
  123. package/dist/chunk-DTMDJGRW.cjs.map +0 -1
  124. package/dist/chunk-EJDZZ4KX.js.map +0 -1
  125. package/dist/chunk-GWMW6XY7.cjs.map +0 -1
  126. package/dist/chunk-H2PVWCWC.cjs.map +0 -1
  127. package/dist/chunk-IEF6AEK3.cjs.map +0 -1
  128. package/dist/chunk-LECHRAU3.js.map +0 -1
  129. package/dist/chunk-OM2XJJWX.js.map +0 -1
  130. package/dist/chunk-QSIP7YLW.cjs.map +0 -1
  131. package/dist/chunk-R6GPQZLI.js.map +0 -1
  132. package/dist/chunk-RPL2IFWK.cjs +0 -77
  133. package/dist/chunk-RPL2IFWK.cjs.map +0 -1
  134. package/dist/pgboss-backend-PQW6I3VF.js +0 -14
  135. package/dist/pgboss-backend-QVXISTLP.cjs +0 -15
  136. package/dist/pgboss-backend-QVXISTLP.cjs.map +0 -1
  137. /package/dist/{chunk-JBOMTZT5.js.map → chunk-3JQWQF2M.js.map} +0 -0
  138. /package/dist/{chunk-O2E7H2XA.js.map → chunk-BCSJOPYH.js.map} +0 -0
  139. /package/dist/{pgboss-backend-PQW6I3VF.js.map → pgboss-backend-5DXF4G22.js.map} +0 -0
@@ -9,14 +9,15 @@
9
9
 
10
10
 
11
11
 
12
- var _chunkIEF6AEK3cjs = require('../chunk-IEF6AEK3.cjs');
13
- require('../chunk-DTMDJGRW.cjs');
14
- require('../chunk-RPL2IFWK.cjs');
15
- require('../chunk-H2PVWCWC.cjs');
12
+ var _chunkH6MHRHUPcjs = require('../chunk-H6MHRHUP.cjs');
13
+ require('../chunk-VLGN3XUM.cjs');
14
+ require('../chunk-JAPZYQVJ.cjs');
15
+ require('../chunk-A2QGDWCG.cjs');
16
+ require('../chunk-JHCXIYJH.cjs');
16
17
 
17
18
 
18
- var _chunkQSIP7YLWcjs = require('../chunk-QSIP7YLW.cjs');
19
- require('../chunk-CGY7JU4Y.cjs');
19
+ var _chunkURKE3OXNcjs = require('../chunk-URKE3OXN.cjs');
20
+ require('../chunk-PUYBKDYD.cjs');
20
21
 
21
22
 
22
23
 
@@ -29,5 +30,5 @@ require('../chunk-CGY7JU4Y.cjs');
29
30
 
30
31
 
31
32
 
32
- exports.configureAuth = _chunkIEF6AEK3cjs.configureAuth; exports.getCurrentUser = _chunkQSIP7YLWcjs.getCurrentUser; exports.hashPassword = _chunkIEF6AEK3cjs.hashPassword; exports.issueToken = _chunkIEF6AEK3cjs.issueToken; exports.passwordNeedsRehash = _chunkIEF6AEK3cjs.passwordNeedsRehash; exports.requireAuth = _chunkIEF6AEK3cjs.requireAuth; exports.revokeAllSessions = _chunkIEF6AEK3cjs.revokeAllSessions; exports.revokeSession = _chunkIEF6AEK3cjs.revokeSession; exports.revokeToken = _chunkIEF6AEK3cjs.revokeToken; exports.signToken = _chunkIEF6AEK3cjs.signToken; exports.verifyPassword = _chunkIEF6AEK3cjs.verifyPassword;
33
+ exports.configureAuth = _chunkH6MHRHUPcjs.configureAuth; exports.getCurrentUser = _chunkURKE3OXNcjs.getCurrentUser; exports.hashPassword = _chunkH6MHRHUPcjs.hashPassword; exports.issueToken = _chunkH6MHRHUPcjs.issueToken; exports.passwordNeedsRehash = _chunkH6MHRHUPcjs.passwordNeedsRehash; exports.requireAuth = _chunkH6MHRHUPcjs.requireAuth; exports.revokeAllSessions = _chunkH6MHRHUPcjs.revokeAllSessions; exports.revokeSession = _chunkH6MHRHUPcjs.revokeSession; exports.revokeToken = _chunkH6MHRHUPcjs.revokeToken; exports.signToken = _chunkH6MHRHUPcjs.signToken; exports.verifyPassword = _chunkH6MHRHUPcjs.verifyPassword;
33
34
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/auth/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,knBAAC","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/auth/index.cjs"}
1
+ {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/auth/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,knBAAC","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/auth/index.cjs"}
@@ -1,5 +1,5 @@
1
1
  import { Request, Response, NextFunction, RequestHandler } from 'express';
2
- import { A as AuthStrategy } from '../types-D3QmZgeX.cjs';
2
+ import { A as AuthStrategy } from '../types-Bgeqpm-n.cjs';
3
3
  import 'node:http';
4
4
  import 'ws';
5
5
 
@@ -1,5 +1,5 @@
1
1
  import { Request, Response, NextFunction, RequestHandler } from 'express';
2
- import { A as AuthStrategy } from '../types-D3QmZgeX.js';
2
+ import { A as AuthStrategy } from '../types-Bgeqpm-n.js';
3
3
  import 'node:http';
4
4
  import 'ws';
5
5
 
@@ -9,13 +9,15 @@ import {
9
9
  revokeToken,
10
10
  signToken,
11
11
  verifyPassword
12
- } from "../chunk-R6GPQZLI.js";
13
- import "../chunk-OM2XJJWX.js";
14
- import "../chunk-3SWI46YK.js";
15
- import "../chunk-B6MB6HEG.js";
12
+ } from "../chunk-X2B7WBKH.js";
13
+ import "../chunk-EBJELA7T.js";
14
+ import "../chunk-PUM5ZDAH.js";
15
+ import "../chunk-ZBQUYFI3.js";
16
+ import "../chunk-UJ2ISRLP.js";
16
17
  import {
17
18
  getCurrentUser
18
- } from "../chunk-2IDRC7RK.js";
19
+ } from "../chunk-546TNO2V.js";
20
+ import "../chunk-Y7I2633P.js";
19
21
  export {
20
22
  configureAuth,
21
23
  getCurrentUser,
@@ -16,7 +16,7 @@ import {
16
16
  tableNameFor,
17
17
  timestampFields,
18
18
  validateAtPath
19
- } from "./chunk-336IU55W.js";
19
+ } from "./chunk-QLM3JEER.js";
20
20
  import {
21
21
  HttpError,
22
22
  isHttpError
@@ -29,7 +29,7 @@ import {
29
29
  traceOps,
30
30
  untracked,
31
31
  whenQueryTracking
32
- } from "./chunk-2IDRC7RK.js";
32
+ } from "./chunk-UJ2ISRLP.js";
33
33
 
34
34
  // src/db/mongo-model.ts
35
35
  var mongoosePromise;
@@ -3235,4 +3235,4 @@ export {
3235
3235
  getDbClient,
3236
3236
  db
3237
3237
  };
3238
- //# sourceMappingURL=chunk-JBOMTZT5.js.map
3238
+ //# sourceMappingURL=chunk-3JQWQF2M.js.map
@@ -0,0 +1,20 @@
1
+ // src/tasks/files.ts
2
+ import fs from "fs";
3
+ import path from "path";
4
+ function listTaskFiles(tasksDir) {
5
+ return fs.readdirSync(tasksDir, { withFileTypes: true }).filter((entry) => {
6
+ if (!/\.(ts|js|mts|mjs)$/.test(entry.name)) return false;
7
+ if (entry.isFile()) return true;
8
+ if (!entry.isSymbolicLink()) return false;
9
+ try {
10
+ return fs.statSync(path.join(tasksDir, entry.name)).isFile();
11
+ } catch {
12
+ return false;
13
+ }
14
+ }).map((entry) => entry.name);
15
+ }
16
+
17
+ export {
18
+ listTaskFiles
19
+ };
20
+ //# sourceMappingURL=chunk-3ROVNEDR.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/tasks/files.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nexport function listTaskFiles(tasksDir: string): string[] {\n return fs\n .readdirSync(tasksDir, { withFileTypes: true })\n .filter((entry) => {\n if (!/\\.(ts|js|mts|mjs)$/.test(entry.name)) return false;\n if (entry.isFile()) return true;\n if (!entry.isSymbolicLink()) return false;\n try {\n return fs.statSync(path.join(tasksDir, entry.name)).isFile();\n } catch {\n return false;\n }\n })\n .map((entry) => entry.name);\n}\n"],"mappings":";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAEV,SAAS,cAAc,UAA4B;AACxD,SAAO,GACJ,YAAY,UAAU,EAAE,eAAe,KAAK,CAAC,EAC7C,OAAO,CAAC,UAAU;AACjB,QAAI,CAAC,qBAAqB,KAAK,MAAM,IAAI,EAAG,QAAO;AACnD,QAAI,MAAM,OAAO,EAAG,QAAO;AAC3B,QAAI,CAAC,MAAM,eAAe,EAAG,QAAO;AACpC,QAAI;AACF,aAAO,GAAG,SAAS,KAAK,KAAK,UAAU,MAAM,IAAI,CAAC,EAAE,OAAO;AAAA,IAC7D,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,CAAC,EACA,IAAI,CAAC,UAAU,MAAM,IAAI;AAC9B;","names":[]}
@@ -1,6 +1,6 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
2
2
 
3
- var _chunkQSIP7YLWcjs = require('./chunk-QSIP7YLW.cjs');
3
+ var _chunkJHCXIYJHcjs = require('./chunk-JHCXIYJH.cjs');
4
4
 
5
5
  // src/router/scan.ts
6
6
  var _fs = require('fs'); var _fs2 = _interopRequireDefault(_fs);
@@ -82,7 +82,7 @@ function compareSpecificity(a, b) {
82
82
  function scanDir(dir, base = dir, maxDepth = DEFAULT_MAX_DEPTH, _depth = 0) {
83
83
  if (!_fs2.default.existsSync(dir)) return [];
84
84
  if (_depth > maxDepth) {
85
- _chunkQSIP7YLWcjs.getLogger.call(void 0, ).warn(`scanDir: max depth (${maxDepth}) reached at ${dir}, skipping subtree`);
85
+ _chunkJHCXIYJHcjs.getLogger.call(void 0, ).warn(`scanDir: max depth (${maxDepth}) reached at ${dir}, skipping subtree`);
86
86
  return [];
87
87
  }
88
88
  const entries = [];
@@ -113,4 +113,4 @@ function scanDir(dir, base = dir, maxDepth = DEFAULT_MAX_DEPTH, _depth = 0) {
113
113
 
114
114
 
115
115
  exports.scanDir = scanDir;
116
- //# sourceMappingURL=chunk-WHBSVYUY.cjs.map
116
+ //# sourceMappingURL=chunk-4FQP6QX3.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-WHBSVYUY.cjs","../src/router/scan.ts"],"names":[],"mappings":"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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-WHBSVYUY.cjs","sourcesContent":[null,"import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\nimport { getLogger } from '../logger.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\n/** Maximum directory depth scanDir will recurse into by default. */\nconst DEFAULT_MAX_DEPTH = 10;\n\n// Match order within one position: static, then [id], then [[id]], then [...slug],\n// then [[...slug]]. Comparing these ranks segment by segment means a more specific\n// route always registers (and so matches) first.\nconst enum Rank {\n Static = 0,\n Dynamic = 1,\n Optional = 2,\n CatchAll = 3,\n OptionalCatchAll = 4,\n}\n\ninterface Segment {\n rank: Rank;\n /** Express-style display/path form: `users`, `:id`, `:id?`, `:slug*`, `:slug*?`. */\n display: string;\n name?: string;\n}\n\nfunction parseSegment(raw: string): Segment {\n let m: RegExpMatchArray | null;\n if ((m = raw.match(/^\\[\\[\\.\\.\\.([^\\]]+)\\]\\]$/)))\n return { rank: Rank.OptionalCatchAll, display: `:${m[1]}*?`, name: m[1]! };\n if ((m = raw.match(/^\\[\\.\\.\\.([^\\]]+)\\]$/)))\n return { rank: Rank.CatchAll, display: `:${m[1]}*`, name: m[1]! };\n if ((m = raw.match(/^\\[\\[([^\\]]+)\\]\\]$/)))\n return { rank: Rank.Optional, display: `:${m[1]}?`, name: m[1]! };\n if (raw.includes('['))\n return { rank: Rank.Dynamic, display: raw.replace(DYNAMIC_SEGMENT_RE, ':$1') };\n return { rank: Rank.Static, display: raw };\n}\n\nfunction segmentsOf(relativePath: string): Segment[] {\n const p = relativePath.replace(ROUTE_FILE_RE, '').replace(/(^|\\/)index$/, '');\n return p.split('/').filter(Boolean).map(parseSegment);\n}\n\nfunction filePathToUrlPath(relativePath: string): string {\n const segs = segmentsOf(relativePath);\n return segs.length === 0 ? '/' : '/' + segs.map((s) => s.display).join('/');\n}\n\nfunction extractParams(relativePath: string): string[] {\n const params: string[] = [];\n for (const raw of relativePath.split('/')) {\n const re = /\\[+(?:\\.\\.\\.)?([^\\]]+)\\]+/g;\n let match: RegExpExecArray | null;\n while ((match = re.exec(raw)) !== null) {\n if (match[1]) params.push(match[1]);\n }\n }\n return params;\n}\n\nfunction escapeRegExp(s: string): string {\n return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Express 4's string paths can't express a multi-segment catch-all with a name, so\n * routes containing one are mounted on a RegExp; captures come back in segment order\n * and mount.ts maps them onto the names in `params`.\n */\nfunction buildPattern(segs: Segment[]): RegExp | undefined {\n const last = segs.length - 1;\n segs.forEach((s, i) => {\n if (i !== last && (s.rank === Rank.CatchAll || s.rank === Rank.OptionalCatchAll)) {\n throw new Error(`[EFC] Catch-all segment \"${s.display}\" must be the last path segment`);\n }\n });\n if (!segs.some((s) => s.rank >= Rank.CatchAll)) return undefined;\n\n let src = '';\n for (const s of segs) {\n switch (s.rank) {\n case Rank.Static:\n src += '/' + escapeRegExp(s.display);\n break;\n case Rank.Dynamic:\n src += '/' + escapeRegExp(s.display).replace(/:[A-Za-z0-9_$]+/g, '([^/]+?)');\n break;\n case Rank.Optional:\n src += '(?:/([^/]+?))?';\n break;\n case Rank.CatchAll:\n src += '/(.+?)';\n break;\n case Rank.OptionalCatchAll:\n src += '(?:/(.*?))?';\n break;\n }\n }\n return new RegExp(`^${src || ''}/?$`, 'i');\n}\n\nfunction compareSpecificity(a: Segment[], b: Segment[]): number {\n for (let i = 0; i < Math.min(a.length, b.length); i++) {\n const diff = a[i]!.rank - b[i]!.rank;\n if (diff !== 0) return diff;\n }\n return 0;\n}\n\n/**\n * Recursively scans `dir` for route files and returns a sorted list of\n * `RouteEntry` objects, most specific first: at each path position a static\n * segment beats `[id]`, which beats `[[id]]`, then `[...slug]`, then\n * `[[...slug]]`. Ties are sorted alphabetically.\n *\n * @param dir - Root directory to scan (must exist).\n * @param base - Base directory used to derive relative URL paths; defaults to `dir`.\n * @param maxDepth - Maximum recursion depth (default: 10). Guards against\n * circular symlinks or unexpectedly deep directory trees.\n * @param _depth - Internal current depth counter — do not pass externally.\n */\nexport function scanDir(\n dir: string,\n base: string = dir,\n maxDepth: number = DEFAULT_MAX_DEPTH,\n _depth: number = 0,\n): RouteEntry[] {\n if (!fs.existsSync(dir)) return [];\n if (_depth > maxDepth) {\n getLogger().warn(`scanDir: max depth (${maxDepth}) reached at ${dir}, skipping subtree`);\n return [];\n }\n\n const entries: RouteEntry[] = [];\n const items = fs.readdirSync(dir, { withFileTypes: true });\n\n for (const item of items) {\n const fullPath = path.join(dir, item.name);\n if (item.isDirectory()) {\n entries.push(...scanDir(fullPath, base, maxDepth, _depth + 1));\n } else if (ROUTE_FILE_RE.test(item.name)) {\n const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n const segs = segmentsOf(relative);\n const pattern = buildPattern(segs);\n entries.push({\n urlPath: filePathToUrlPath(relative),\n filePath: fullPath,\n params: extractParams(relative),\n ...(pattern !== undefined && { pattern }),\n });\n }\n }\n\n // Most specific first (segment-by-segment rank), ties broken alphabetically.\n const rel = (e: RouteEntry) => '/' + path.relative(base, e.filePath).replace(/\\\\/g, '/');\n return entries.sort((a, b) => {\n const diff = compareSpecificity(segmentsOf(rel(a)), segmentsOf(rel(b)));\n return diff !== 0 ? diff : a.urlPath.localeCompare(b.urlPath);\n });\n}\n\nexport { filePathToUrlPath };\n"]}
1
+ {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-4FQP6QX3.cjs","../src/router/scan.ts"],"names":[],"mappings":"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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-4FQP6QX3.cjs","sourcesContent":[null,"import fs from 'node:fs';\nimport path from 'node:path';\nimport type { RouteEntry } from '../types.js';\nimport { getLogger } from '../logger.js';\n\nconst ROUTE_FILE_RE = /\\.(ts|js|mts|mjs|cts|cjs)$/;\nconst DYNAMIC_SEGMENT_RE = /\\[([^\\]]+)\\]/g;\n\n/** Maximum directory depth scanDir will recurse into by default. */\nconst DEFAULT_MAX_DEPTH = 10;\n\n// Match order within one position: static, then [id], then [[id]], then [...slug],\n// then [[...slug]]. Comparing these ranks segment by segment means a more specific\n// route always registers (and so matches) first.\nconst enum Rank {\n Static = 0,\n Dynamic = 1,\n Optional = 2,\n CatchAll = 3,\n OptionalCatchAll = 4,\n}\n\ninterface Segment {\n rank: Rank;\n /** Express-style display/path form: `users`, `:id`, `:id?`, `:slug*`, `:slug*?`. */\n display: string;\n name?: string;\n}\n\nfunction parseSegment(raw: string): Segment {\n let m: RegExpMatchArray | null;\n if ((m = raw.match(/^\\[\\[\\.\\.\\.([^\\]]+)\\]\\]$/)))\n return { rank: Rank.OptionalCatchAll, display: `:${m[1]}*?`, name: m[1]! };\n if ((m = raw.match(/^\\[\\.\\.\\.([^\\]]+)\\]$/)))\n return { rank: Rank.CatchAll, display: `:${m[1]}*`, name: m[1]! };\n if ((m = raw.match(/^\\[\\[([^\\]]+)\\]\\]$/)))\n return { rank: Rank.Optional, display: `:${m[1]}?`, name: m[1]! };\n if (raw.includes('['))\n return { rank: Rank.Dynamic, display: raw.replace(DYNAMIC_SEGMENT_RE, ':$1') };\n return { rank: Rank.Static, display: raw };\n}\n\nfunction segmentsOf(relativePath: string): Segment[] {\n const p = relativePath.replace(ROUTE_FILE_RE, '').replace(/(^|\\/)index$/, '');\n return p.split('/').filter(Boolean).map(parseSegment);\n}\n\nfunction filePathToUrlPath(relativePath: string): string {\n const segs = segmentsOf(relativePath);\n return segs.length === 0 ? '/' : '/' + segs.map((s) => s.display).join('/');\n}\n\nfunction extractParams(relativePath: string): string[] {\n const params: string[] = [];\n for (const raw of relativePath.split('/')) {\n const re = /\\[+(?:\\.\\.\\.)?([^\\]]+)\\]+/g;\n let match: RegExpExecArray | null;\n while ((match = re.exec(raw)) !== null) {\n if (match[1]) params.push(match[1]);\n }\n }\n return params;\n}\n\nfunction escapeRegExp(s: string): string {\n return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Express 4's string paths can't express a multi-segment catch-all with a name, so\n * routes containing one are mounted on a RegExp; captures come back in segment order\n * and mount.ts maps them onto the names in `params`.\n */\nfunction buildPattern(segs: Segment[]): RegExp | undefined {\n const last = segs.length - 1;\n segs.forEach((s, i) => {\n if (i !== last && (s.rank === Rank.CatchAll || s.rank === Rank.OptionalCatchAll)) {\n throw new Error(`[EFC] Catch-all segment \"${s.display}\" must be the last path segment`);\n }\n });\n if (!segs.some((s) => s.rank >= Rank.CatchAll)) return undefined;\n\n let src = '';\n for (const s of segs) {\n switch (s.rank) {\n case Rank.Static:\n src += '/' + escapeRegExp(s.display);\n break;\n case Rank.Dynamic:\n src += '/' + escapeRegExp(s.display).replace(/:[A-Za-z0-9_$]+/g, '([^/]+?)');\n break;\n case Rank.Optional:\n src += '(?:/([^/]+?))?';\n break;\n case Rank.CatchAll:\n src += '/(.+?)';\n break;\n case Rank.OptionalCatchAll:\n src += '(?:/(.*?))?';\n break;\n }\n }\n return new RegExp(`^${src || ''}/?$`, 'i');\n}\n\nfunction compareSpecificity(a: Segment[], b: Segment[]): number {\n for (let i = 0; i < Math.min(a.length, b.length); i++) {\n const diff = a[i]!.rank - b[i]!.rank;\n if (diff !== 0) return diff;\n }\n return 0;\n}\n\n/**\n * Recursively scans `dir` for route files and returns a sorted list of\n * `RouteEntry` objects, most specific first: at each path position a static\n * segment beats `[id]`, which beats `[[id]]`, then `[...slug]`, then\n * `[[...slug]]`. Ties are sorted alphabetically.\n *\n * @param dir - Root directory to scan (must exist).\n * @param base - Base directory used to derive relative URL paths; defaults to `dir`.\n * @param maxDepth - Maximum recursion depth (default: 10). Guards against\n * circular symlinks or unexpectedly deep directory trees.\n * @param _depth - Internal current depth counter — do not pass externally.\n */\nexport function scanDir(\n dir: string,\n base: string = dir,\n maxDepth: number = DEFAULT_MAX_DEPTH,\n _depth: number = 0,\n): RouteEntry[] {\n if (!fs.existsSync(dir)) return [];\n if (_depth > maxDepth) {\n getLogger().warn(`scanDir: max depth (${maxDepth}) reached at ${dir}, skipping subtree`);\n return [];\n }\n\n const entries: RouteEntry[] = [];\n const items = fs.readdirSync(dir, { withFileTypes: true });\n\n for (const item of items) {\n const fullPath = path.join(dir, item.name);\n if (item.isDirectory()) {\n entries.push(...scanDir(fullPath, base, maxDepth, _depth + 1));\n } else if (ROUTE_FILE_RE.test(item.name)) {\n const relative = '/' + path.relative(base, fullPath).replace(/\\\\/g, '/');\n const segs = segmentsOf(relative);\n const pattern = buildPattern(segs);\n entries.push({\n urlPath: filePathToUrlPath(relative),\n filePath: fullPath,\n params: extractParams(relative),\n ...(pattern !== undefined && { pattern }),\n });\n }\n }\n\n // Most specific first (segment-by-segment rank), ties broken alphabetically.\n const rel = (e: RouteEntry) => '/' + path.relative(base, e.filePath).replace(/\\\\/g, '/');\n return entries.sort((a, b) => {\n const diff = compareSpecificity(segmentsOf(rel(a)), segmentsOf(rel(b)));\n return diff !== 0 ? diff : a.urlPath.localeCompare(b.urlPath);\n });\n}\n\nexport { filePathToUrlPath };\n"]}
@@ -0,0 +1,226 @@
1
+ import {
2
+ processState
3
+ } from "./chunk-Y7I2633P.js";
4
+
5
+ // src/context.ts
6
+ import { AsyncLocalStorage } from "async_hooks";
7
+ var storage = processState("request-context", () => new AsyncLocalStorage());
8
+ function runWithContext(ctx, fn) {
9
+ return storage.run(ctx, fn);
10
+ }
11
+ function getRequestContext() {
12
+ return storage.getStore();
13
+ }
14
+ function setCurrentUser(user) {
15
+ const store = storage.getStore();
16
+ if (store) store.user = user;
17
+ }
18
+ function getCurrentUser() {
19
+ return storage.getStore()?.user;
20
+ }
21
+
22
+ // src/tracing.ts
23
+ import { W3CTraceContextPropagator } from "@opentelemetry/core";
24
+ import {
25
+ context,
26
+ trace,
27
+ ROOT_CONTEXT,
28
+ defaultTextMapSetter,
29
+ defaultTextMapGetter,
30
+ SpanKind,
31
+ SpanStatusCode,
32
+ isSpanContextValid
33
+ } from "@opentelemetry/api";
34
+ var lifecycle = processState("tracing-lifecycle", () => ({
35
+ shutdown: void 0,
36
+ pending: void 0
37
+ }));
38
+ function configureTracing(options) {
39
+ lifecycle.shutdown = typeof options === "object" ? options.shutdown : void 0;
40
+ lifecycle.pending = void 0;
41
+ }
42
+ function shutdownTracing() {
43
+ const shutdown = lifecycle.shutdown;
44
+ return lifecycle.pending ??= Promise.resolve().then(() => shutdown?.());
45
+ }
46
+ function activeTracingContext() {
47
+ const current = context.active();
48
+ const span = trace.getSpanContext(current);
49
+ return span && isSpanContextValid(span) ? current : getRequestContext()?.otelContext ?? current;
50
+ }
51
+ var keys = ["traceparent", "tracestate"];
52
+ var w3c = new W3CTraceContextPropagator();
53
+ function carrierOnly(carrier) {
54
+ const input = carrier && typeof carrier === "object" ? carrier : {};
55
+ const result = {};
56
+ for (const key of keys) {
57
+ const value = input[key];
58
+ if (typeof value === "string" && value.length <= 512) result[key] = value;
59
+ }
60
+ return result;
61
+ }
62
+ function injectTrace(ctx = activeTracingContext()) {
63
+ const carrier = {};
64
+ w3c.inject(ctx, carrier, defaultTextMapSetter);
65
+ return carrierOnly(carrier);
66
+ }
67
+ function extractTrace(carrier) {
68
+ return w3c.extract(ROOT_CONTEXT, carrierOnly(carrier), defaultTextMapGetter);
69
+ }
70
+ var tracePropagator = {
71
+ inject(ctx, carrier, setter) {
72
+ for (const [key, value] of Object.entries(injectTrace(ctx))) setter.set(carrier, key, value);
73
+ },
74
+ extract(_ctx, carrier, getter) {
75
+ return extractTrace(Object.fromEntries(keys.map((key) => [key, getter.get(carrier, key)])));
76
+ },
77
+ fields: () => [...keys]
78
+ };
79
+ function traceLogFields() {
80
+ const span = trace.getSpanContext(activeTracingContext());
81
+ return span && isSpanContextValid(span) ? { trace_id: span.traceId, span_id: span.spanId } : {};
82
+ }
83
+ function httpTracing() {
84
+ return (req, res, next) => {
85
+ const method = [
86
+ "GET",
87
+ "HEAD",
88
+ "POST",
89
+ "PUT",
90
+ "DELETE",
91
+ "CONNECT",
92
+ "OPTIONS",
93
+ "TRACE",
94
+ "PATCH"
95
+ ].includes(req.method) ? req.method : "_OTHER";
96
+ const span = trace.getTracer("express-file-cluster").startSpan(
97
+ method,
98
+ {
99
+ kind: SpanKind.SERVER,
100
+ attributes: { "http.request.method": method }
101
+ },
102
+ extractTrace(req.headers)
103
+ );
104
+ const ctx = trace.setSpan(ROOT_CONTEXT, span);
105
+ const store = getRequestContext();
106
+ if (store) {
107
+ store.otelContext = ctx;
108
+ store.httpSpan = span;
109
+ }
110
+ let ended = false;
111
+ const end = (aborted) => {
112
+ if (ended) return;
113
+ ended = true;
114
+ res.removeListener("finish", finished);
115
+ res.removeListener("close", closed);
116
+ if (!aborted || res.headersSent)
117
+ span.setAttribute("http.response.status_code", res.statusCode);
118
+ if (aborted || res.statusCode >= 500) {
119
+ span.setStatus({ code: SpanStatusCode.ERROR });
120
+ span.setAttribute("error.type", aborted ? "connection_closed" : String(res.statusCode));
121
+ }
122
+ span.end();
123
+ };
124
+ const finished = () => end(false);
125
+ const closed = () => end(!res.writableFinished);
126
+ res.once("finish", finished);
127
+ res.once("close", closed);
128
+ context.with(ctx, next);
129
+ };
130
+ }
131
+ function traceRoute(urlPath) {
132
+ return (req, _res, next) => {
133
+ const span = getRequestContext()?.httpSpan;
134
+ if (span) {
135
+ const route = req.baseUrl + (urlPath === "/" ? "" : urlPath) || "/";
136
+ span.setAttribute("http.route", route);
137
+ span.updateName(`${req.method} ${route}`);
138
+ }
139
+ next();
140
+ };
141
+ }
142
+ var traceHttpError = (error, _req, _res, next) => {
143
+ const status = error?.statusCode ?? error?.status ?? 500;
144
+ if (typeof status !== "number" || status >= 500) {
145
+ const span = getRequestContext()?.httpSpan;
146
+ if (error instanceof Error) span?.recordException(error);
147
+ span?.setStatus({ code: SpanStatusCode.ERROR });
148
+ }
149
+ next(error);
150
+ };
151
+ function bullMQTelemetry() {
152
+ return {
153
+ contextManager: {
154
+ active: activeTracingContext,
155
+ with: (ctx, fn) => context.with(ctx, fn),
156
+ getMetadata: (ctx) => JSON.stringify(injectTrace(ctx)),
157
+ fromMetadata(_active, metadata) {
158
+ try {
159
+ return extractTrace(JSON.parse(metadata));
160
+ } catch {
161
+ return ROOT_CONTEXT;
162
+ }
163
+ }
164
+ },
165
+ tracer: {
166
+ startSpan(name, options, parent) {
167
+ const span = trace.getTracer("express-file-cluster.bullmq").startSpan(
168
+ name,
169
+ { kind: options?.kind ?? SpanKind.INTERNAL },
170
+ parent ?? activeTracingContext()
171
+ );
172
+ return {
173
+ setSpanOnContext: (ctx) => trace.setSpan(ctx, span),
174
+ setAttribute: (key, value) => {
175
+ span.setAttribute(key, value);
176
+ },
177
+ setAttributes: (attributes) => {
178
+ span.setAttributes(attributes);
179
+ },
180
+ addEvent: (name2, attributes) => {
181
+ span.addEvent(name2, attributes);
182
+ },
183
+ recordException: (error, time) => {
184
+ span.recordException(error, time);
185
+ span.setStatus({ code: SpanStatusCode.ERROR });
186
+ },
187
+ end: () => span.end()
188
+ };
189
+ }
190
+ }
191
+ };
192
+ }
193
+ async function taskContext(fn, recordErrors = false) {
194
+ const ctx = activeTracingContext();
195
+ return runWithContext({ otelContext: ctx }, async () => {
196
+ try {
197
+ return await fn();
198
+ } catch (error) {
199
+ if (recordErrors) {
200
+ const span = trace.getSpan(ctx);
201
+ if (error instanceof Error) span?.recordException(error);
202
+ span?.setStatus({ code: SpanStatusCode.ERROR });
203
+ }
204
+ throw error;
205
+ }
206
+ });
207
+ }
208
+
209
+ export {
210
+ runWithContext,
211
+ getRequestContext,
212
+ setCurrentUser,
213
+ getCurrentUser,
214
+ configureTracing,
215
+ shutdownTracing,
216
+ injectTrace,
217
+ extractTrace,
218
+ tracePropagator,
219
+ traceLogFields,
220
+ httpTracing,
221
+ traceRoute,
222
+ traceHttpError,
223
+ bullMQTelemetry,
224
+ taskContext
225
+ };
226
+ //# sourceMappingURL=chunk-546TNO2V.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/context.ts","../src/tracing.ts"],"sourcesContent":["import type { Context, Span } from '@opentelemetry/api';\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Logger } from 'pino';\nimport { processState } from './process-state.js';\n\nexport interface RequestContext {\n otelContext?: Context;\n httpSpan?: Span;\n user?: Record<string, unknown> | undefined;\n requestId?: string;\n log?: Logger;\n /** Model operations run so far in this request, by `Model.op` (N+1 detection). */\n queryCounts?: Map<string, number>;\n}\n\nconst storage = processState('request-context', () => new AsyncLocalStorage<RequestContext>());\n\n// Wraps one request's lifecycle in an AsyncLocalStorage context. Node propagates\n// the store through the async chain the callback initiates (awaits, .then, etc.),\n// so anything running as part of the same request — including a `$currentUser`\n// default resolved deep inside a mongoose `.create()` call — can read it back.\nexport function runWithContext<T>(ctx: RequestContext, fn: () => T): T {\n return storage.run(ctx, fn);\n}\n\nexport function getRequestContext(): RequestContext | undefined {\n return storage.getStore();\n}\n\nexport function setCurrentUser(user: Record<string, unknown> | undefined): void {\n const store = storage.getStore();\n if (store) store.user = user;\n}\n\nexport function getCurrentUser(): Record<string, unknown> | undefined {\n return storage.getStore()?.user;\n}\n","import { W3CTraceContextPropagator } from '@opentelemetry/core';\nimport {\n context,\n trace,\n ROOT_CONTEXT,\n defaultTextMapSetter,\n defaultTextMapGetter,\n SpanKind,\n SpanStatusCode,\n isSpanContextValid,\n type Context,\n type TextMapPropagator,\n} from '@opentelemetry/api';\nimport type { RequestHandler, ErrorRequestHandler } from 'express';\nimport type { Telemetry } from 'bullmq';\nimport { getRequestContext, runWithContext } from './context.js';\nimport { processState } from './process-state.js';\n\nexport interface TracingOptions {\n /** Instrument HTTP, including upgrade handshakes. Default true. */\n http?: boolean;\n /** Instrument the queue backends and propagate context to tasks. Default true. */\n tasks?: boolean;\n /** App-owned SDK shutdown/flush, called after HTTP and tasks drain. */\n shutdown?: () => Promise<void>;\n}\nexport type TraceCarrier = Record<string, string>;\nconst lifecycle = processState('tracing-lifecycle', () => ({\n shutdown: undefined as (() => Promise<void>) | undefined,\n pending: undefined as Promise<void> | undefined,\n}));\nexport function configureTracing(options: boolean | TracingOptions | undefined): void {\n lifecycle.shutdown = typeof options === 'object' ? options.shutdown : undefined;\n lifecycle.pending = undefined;\n}\nexport function shutdownTracing(): Promise<void> {\n const shutdown = lifecycle.shutdown;\n return (lifecycle.pending ??= Promise.resolve().then(() => shutdown?.()));\n}\nexport function activeTracingContext(): Context {\n const current = context.active();\n const span = trace.getSpanContext(current);\n return span && isSpanContextValid(span) ? current : (getRequestContext()?.otelContext ?? current);\n}\nconst keys = ['traceparent', 'tracestate'] as const;\nconst w3c = new W3CTraceContextPropagator();\nfunction carrierOnly(carrier: unknown): TraceCarrier {\n const input = carrier && typeof carrier === 'object' ? (carrier as Record<string, unknown>) : {};\n const result: TraceCarrier = {};\n for (const key of keys) {\n const value = input[key];\n if (typeof value === 'string' && value.length <= 512) result[key] = value;\n }\n return result;\n}\n/** W3C trace fields only: never persist baggage, credentials or task payloads. */\nexport function injectTrace(ctx = activeTracingContext()): TraceCarrier {\n const carrier: TraceCarrier = {};\n w3c.inject(ctx, carrier, defaultTextMapSetter);\n return carrierOnly(carrier);\n}\nexport function extractTrace(carrier: unknown): Context {\n return w3c.extract(ROOT_CONTEXT, carrierOnly(carrier), defaultTextMapGetter);\n}\nexport const tracePropagator: TextMapPropagator = {\n inject(ctx, carrier, setter) {\n for (const [key, value] of Object.entries(injectTrace(ctx))) setter.set(carrier, key, value);\n },\n extract(_ctx, carrier, getter) {\n return extractTrace(Object.fromEntries(keys.map((key) => [key, getter.get(carrier, key)])));\n },\n fields: () => [...keys],\n};\nexport function traceLogFields(): Record<string, string> {\n const span = trace.getSpanContext(activeTracingContext());\n return span && isSpanContextValid(span) ? { trace_id: span.traceId, span_id: span.spanId } : {};\n}\nexport function httpTracing(): RequestHandler {\n return (req, res, next) => {\n const method = [\n 'GET',\n 'HEAD',\n 'POST',\n 'PUT',\n 'DELETE',\n 'CONNECT',\n 'OPTIONS',\n 'TRACE',\n 'PATCH',\n ].includes(req.method)\n ? req.method\n : '_OTHER';\n const span = trace.getTracer('express-file-cluster').startSpan(\n method,\n {\n kind: SpanKind.SERVER,\n attributes: { 'http.request.method': method },\n },\n extractTrace(req.headers),\n );\n const ctx = trace.setSpan(ROOT_CONTEXT, span);\n const store = getRequestContext();\n if (store) {\n store.otelContext = ctx;\n store.httpSpan = span;\n }\n let ended = false;\n const end = (aborted: boolean) => {\n if (ended) return;\n ended = true;\n res.removeListener('finish', finished);\n res.removeListener('close', closed);\n if (!aborted || res.headersSent)\n span.setAttribute('http.response.status_code', res.statusCode);\n if (aborted || res.statusCode >= 500) {\n span.setStatus({ code: SpanStatusCode.ERROR });\n span.setAttribute('error.type', aborted ? 'connection_closed' : String(res.statusCode));\n }\n span.end();\n };\n const finished = () => end(false);\n const closed = () => end(!res.writableFinished);\n res.once('finish', finished);\n res.once('close', closed);\n context.with(ctx, next);\n };\n}\nexport function traceRoute(urlPath: string): RequestHandler {\n return (req, _res, next) => {\n const span = getRequestContext()?.httpSpan;\n if (span) {\n const route = req.baseUrl + (urlPath === '/' ? '' : urlPath) || '/';\n span.setAttribute('http.route', route);\n span.updateName(`${req.method} ${route}`);\n }\n next();\n };\n}\nexport const traceHttpError: ErrorRequestHandler = (error, _req, _res, next) => {\n const status = error?.statusCode ?? error?.status ?? 500;\n if (typeof status !== 'number' || status >= 500) {\n const span = getRequestContext()?.httpSpan;\n if (error instanceof Error) span?.recordException(error);\n span?.setStatus({ code: SpanStatusCode.ERROR });\n }\n next(error);\n};\n/** Native BullMQ metadata keeps the application job data unchanged. */\nexport function bullMQTelemetry(): Telemetry<Context> {\n return {\n contextManager: {\n active: activeTracingContext,\n with: (ctx, fn) => context.with(ctx, fn),\n getMetadata: (ctx: Context) => JSON.stringify(injectTrace(ctx)),\n fromMetadata(_active: Context, metadata: string) {\n try {\n return extractTrace(JSON.parse(metadata) as TraceCarrier);\n } catch {\n return ROOT_CONTEXT;\n }\n },\n },\n tracer: {\n startSpan(name, options, parent) {\n const span = trace\n .getTracer('express-file-cluster.bullmq')\n .startSpan(\n name,\n { kind: options?.kind ?? SpanKind.INTERNAL },\n parent ?? activeTracingContext(),\n );\n return {\n setSpanOnContext: (ctx: Context) => trace.setSpan(ctx, span),\n setAttribute: (key, value) => {\n span.setAttribute(key, value);\n },\n setAttributes: (attributes) => {\n span.setAttributes(attributes);\n },\n addEvent: (name, attributes) => {\n span.addEvent(name, attributes);\n },\n recordException: (error, time) => {\n span.recordException(error, time);\n span.setStatus({ code: SpanStatusCode.ERROR });\n },\n end: () => span.end(),\n };\n },\n },\n };\n}\n/** Job handlers start with a clean EFC auth/request scope, under the native task span. */\nexport async function taskContext<T>(fn: () => Promise<T>, recordErrors = false): Promise<T> {\n const ctx = activeTracingContext();\n return runWithContext({ otelContext: ctx }, async () => {\n try {\n return await fn();\n } catch (error) {\n // BullMQ settles failures inside its span callback instead of rethrowing\n // them; mark that attempt here. pg-boss records its own failure status.\n if (recordErrors) {\n const span = trace.getSpan(ctx);\n if (error instanceof Error) span?.recordException(error);\n span?.setStatus({ code: SpanStatusCode.ERROR });\n }\n throw error;\n }\n });\n}\n"],"mappings":"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","names":["name"]}
@@ -1,19 +1,37 @@
1
1
  import {
2
2
  runInThread
3
- } from "./chunk-3SWI46YK.js";
3
+ } from "./chunk-PUM5ZDAH.js";
4
4
  import {
5
5
  setEnqueueImpl,
6
6
  taskRegistry
7
- } from "./chunk-B6MB6HEG.js";
7
+ } from "./chunk-ZBQUYFI3.js";
8
8
  import {
9
9
  explainPostgresError,
10
10
  getLogger
11
- } from "./chunk-2IDRC7RK.js";
11
+ } from "./chunk-UJ2ISRLP.js";
12
+ import {
13
+ taskContext,
14
+ tracePropagator
15
+ } from "./chunk-546TNO2V.js";
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: def.options.retries ?? 3,
@@ -39,6 +57,11 @@ 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: tracePropagator
64
+ },
42
65
  ...opts.schema !== void 0 && { schema: opts.schema }
43
66
  });
44
67
  boss.on("error", (err) => getLogger().error({ err }, "pg-boss error"));
@@ -57,10 +80,11 @@ async function initPgBoss(opts) {
57
80
  { localConcurrency: 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 runInThread(def.filePath, payload);
63
- else await def.handler(payload);
85
+ if (def.options.thread && def.filePath)
86
+ await taskContext(() => runInThread(def.filePath, payload, !!opts.tracing));
87
+ else await taskContext(() => def.handler(payload));
64
88
  getLogger().info({ task: def.name, jobId: job.id }, `Task ${def.name} completed`);
65
89
  } catch (err) {
66
90
  getLogger().error(
@@ -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(
@@ -130,6 +158,7 @@ async function pgBossAdmin(connectionString, queue = "efc", schema = "pgboss") {
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(r.output?.message ?? r.output ?? ""),
175
- attempts: r.retry_count + 1,
176
- failedAt: 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(r.output?.message ?? r.output ?? ""),
203
+ attempts: r.retry_count + 1,
204
+ failedAt: r.completed_on ?? void 0
205
+ }));
179
206
  },
180
207
  async retry(ids) {
181
208
  const rows = await failedRows(ids);
@@ -198,4 +225,4 @@ export {
198
225
  initPgBoss,
199
226
  pgBossAdmin
200
227
  };
201
- //# sourceMappingURL=chunk-EJDZZ4KX.js.map
228
+ //# sourceMappingURL=chunk-74R37C4I.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/tasks/payload.ts","../src/tasks/pgboss-backend.ts"],"sourcesContent":["// 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"],"mappings":"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","names":[]}