express-file-cluster 0.3.15 → 0.7.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 (116) hide show
  1. package/README.md +71 -33
  2. package/dist/auth/index.cjs +12 -2
  3. package/dist/auth/index.cjs.map +1 -1
  4. package/dist/auth/index.d.cts +13 -2
  5. package/dist/auth/index.d.ts +13 -2
  6. package/dist/auth/index.js +12 -2
  7. package/dist/chunk-277BSYVH.js +127 -0
  8. package/dist/chunk-277BSYVH.js.map +1 -0
  9. package/dist/chunk-6OGOVV57.js +3847 -0
  10. package/dist/chunk-6OGOVV57.js.map +1 -0
  11. package/dist/chunk-7YEX4MQV.cjs +38 -0
  12. package/dist/chunk-7YEX4MQV.cjs.map +1 -0
  13. package/dist/chunk-AZYXQU3Z.cjs +3847 -0
  14. package/dist/chunk-AZYXQU3Z.cjs.map +1 -0
  15. package/dist/chunk-BUBXO7WU.js +170 -0
  16. package/dist/chunk-BUBXO7WU.js.map +1 -0
  17. package/dist/chunk-LJNSJFOL.js +38 -0
  18. package/dist/chunk-LJNSJFOL.js.map +1 -0
  19. package/dist/chunk-MGH4VDV3.cjs +170 -0
  20. package/dist/chunk-MGH4VDV3.cjs.map +1 -0
  21. package/dist/chunk-R34R7QPD.cjs +116 -0
  22. package/dist/chunk-R34R7QPD.cjs.map +1 -0
  23. package/dist/chunk-RS4MXCPW.js +116 -0
  24. package/dist/chunk-RS4MXCPW.js.map +1 -0
  25. package/dist/chunk-T4OHFU5T.cjs +154 -0
  26. package/dist/chunk-T4OHFU5T.cjs.map +1 -0
  27. package/dist/chunk-TI24L4XE.cjs.map +1 -1
  28. package/dist/chunk-TRC4DUZB.js +438 -0
  29. package/dist/chunk-TRC4DUZB.js.map +1 -0
  30. package/dist/chunk-TYR2GZZE.cjs +196 -0
  31. package/dist/chunk-TYR2GZZE.cjs.map +1 -0
  32. package/dist/chunk-UBQYQPBU.js +154 -0
  33. package/dist/chunk-UBQYQPBU.js.map +1 -0
  34. package/dist/chunk-UTM4PEVG.js +196 -0
  35. package/dist/chunk-UTM4PEVG.js.map +1 -0
  36. package/dist/chunk-YL37D6KM.cjs +127 -0
  37. package/dist/chunk-YL37D6KM.cjs.map +1 -0
  38. package/dist/chunk-ZDM5JHVK.cjs +438 -0
  39. package/dist/chunk-ZDM5JHVK.cjs.map +1 -0
  40. package/dist/cli/db-runner.cjs +497 -0
  41. package/dist/cli/db-runner.cjs.map +1 -0
  42. package/dist/cli/db-runner.d.cts +2 -0
  43. package/dist/cli/db-runner.d.ts +2 -0
  44. package/dist/cli/db-runner.js +497 -0
  45. package/dist/cli/db-runner.js.map +1 -0
  46. package/dist/cli/index.cjs +447 -69
  47. package/dist/cli/index.cjs.map +1 -1
  48. package/dist/cli/index.js +473 -95
  49. package/dist/cli/index.js.map +1 -1
  50. package/dist/docs/api-reference/auth.md +232 -0
  51. package/dist/docs/api-reference/compose.md +78 -0
  52. package/dist/docs/api-reference/db.md +351 -0
  53. package/dist/docs/api-reference/http-error.md +109 -0
  54. package/dist/docs/api-reference/ignite.md +326 -0
  55. package/dist/docs/api-reference/table.md +458 -0
  56. package/dist/docs/api-reference/tasks.md +140 -0
  57. package/dist/docs/cli/db.md +38 -0
  58. package/dist/docs/cli/diagnostics.md +145 -0
  59. package/dist/docs/cli/generate.md +120 -0
  60. package/dist/docs/cli/index.md +48 -0
  61. package/dist/docs/cli/start.md +112 -0
  62. package/dist/docs/contributing/index.md +139 -0
  63. package/dist/docs/core-concepts/background-tasks.md +228 -0
  64. package/dist/docs/core-concepts/clustering.md +114 -0
  65. package/dist/docs/core-concepts/file-based-routing.md +235 -0
  66. package/dist/docs/core-concepts/index.md +79 -0
  67. package/dist/docs/core-concepts/middleware.md +144 -0
  68. package/dist/docs/getting-started/index.md +91 -0
  69. package/dist/docs/getting-started/project-structure.md +154 -0
  70. package/dist/docs/guides/ai-agents.md +48 -0
  71. package/dist/docs/guides/authentication.md +196 -0
  72. package/dist/docs/guides/caching.md +124 -0
  73. package/dist/docs/guides/database.md +217 -0
  74. package/dist/docs/guides/deployment.md +171 -0
  75. package/dist/docs/guides/environment-variables.md +106 -0
  76. package/dist/docs/guides/error-handling.md +172 -0
  77. package/dist/docs/guides/generated-portals.md +115 -0
  78. package/dist/docs/guides/logging.md +108 -0
  79. package/dist/docs/guides/mailer.md +166 -0
  80. package/dist/docs/guides/migrations.md +106 -0
  81. package/dist/docs/guides/rbac.md +89 -0
  82. package/dist/docs/guides/validation.md +95 -0
  83. package/dist/docs/index.md +93 -0
  84. package/dist/docs/skills/SKILL.md +44 -0
  85. package/dist/docs/skills/api-surface.md +309 -0
  86. package/dist/docs/skills/auth-internals.md +141 -0
  87. package/dist/docs/skills/pre-flight.md +142 -0
  88. package/dist/docs/skills/routing-rules.md +114 -0
  89. package/dist/docs/skills/tasks-internals.md +172 -0
  90. package/dist/docs/skills/what-not-to-invent.md +251 -0
  91. package/dist/index.cjs +264 -391
  92. package/dist/index.cjs.map +1 -1
  93. package/dist/index.d.cts +699 -7
  94. package/dist/index.d.ts +699 -7
  95. package/dist/index.js +258 -385
  96. package/dist/index.js.map +1 -1
  97. package/dist/pgboss-backend-QKBXVJ6B.js +14 -0
  98. package/dist/pgboss-backend-QKBXVJ6B.js.map +1 -0
  99. package/dist/pgboss-backend-TCHI7CHM.cjs +14 -0
  100. package/dist/pgboss-backend-TCHI7CHM.cjs.map +1 -0
  101. package/dist/tasks/index.cjs.map +1 -1
  102. package/dist/tasks/index.d.cts +1 -1
  103. package/dist/tasks/index.d.ts +1 -1
  104. package/dist/types-B6lVw4bj.d.cts +588 -0
  105. package/dist/types-B6lVw4bj.d.ts +588 -0
  106. package/package.json +28 -5
  107. package/dist/chunk-6522HS2J.cjs +0 -99
  108. package/dist/chunk-6522HS2J.cjs.map +0 -1
  109. package/dist/chunk-DGVOJNR6.cjs +0 -55
  110. package/dist/chunk-DGVOJNR6.cjs.map +0 -1
  111. package/dist/chunk-KOHLLUN7.js +0 -55
  112. package/dist/chunk-KOHLLUN7.js.map +0 -1
  113. package/dist/chunk-VIP3PFWZ.js +0 -99
  114. package/dist/chunk-VIP3PFWZ.js.map +0 -1
  115. package/dist/types-BusbSenn.d.cts +0 -162
  116. package/dist/types-BusbSenn.d.ts +0 -162
@@ -0,0 +1,127 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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/context.ts
2
+ var _async_hooks = require('async_hooks');
3
+ var storage = new (0, _async_hooks.AsyncLocalStorage)();
4
+ function runWithContext(ctx, fn) {
5
+ return storage.run(ctx, fn);
6
+ }
7
+ function getRequestContext() {
8
+ return storage.getStore();
9
+ }
10
+ function setCurrentUser(user) {
11
+ const store = storage.getStore();
12
+ if (store) store.user = user;
13
+ }
14
+ function getCurrentUser() {
15
+ return _optionalChain([storage, 'access', _ => _.getStore, 'call', _2 => _2(), 'optionalAccess', _3 => _3.user]);
16
+ }
17
+
18
+ // src/logger.ts
19
+ var _cluster = require('cluster'); var _cluster2 = _interopRequireDefault(_cluster);
20
+ var _crypto = require('crypto');
21
+ var _picocolors = require('picocolors'); var _picocolors2 = _interopRequireDefault(_picocolors);
22
+ var _pino = require('pino');
23
+ var LEVEL_LABELS = {
24
+ 10: _picocolors2.default.gray("TRACE"),
25
+ 20: _picocolors2.default.blue("DEBUG"),
26
+ 30: _picocolors2.default.green("INFO "),
27
+ 40: _picocolors2.default.yellow("WARN "),
28
+ 50: _picocolors2.default.red("ERROR"),
29
+ 60: _picocolors2.default.bgRed("FATAL")
30
+ };
31
+ var OMIT = /* @__PURE__ */ new Set(["level", "time", "msg", "pid", "hostname", "worker", "reqId"]);
32
+ function prettyStream(out = process.stdout) {
33
+ return {
34
+ write(line) {
35
+ let rec;
36
+ try {
37
+ rec = JSON.parse(line);
38
+ } catch (e) {
39
+ out.write(line);
40
+ return;
41
+ }
42
+ const time = new Date(rec["time"]).toTimeString().slice(0, 8);
43
+ const level = _nullishCoalesce(LEVEL_LABELS[rec["level"]], () => ( String(rec["level"])));
44
+ const worker = rec["worker"] !== void 0 ? _picocolors2.default.dim(`[${String(rec["worker"])}] `) : "";
45
+ const reqId = rec["reqId"] ? _picocolors2.default.magenta(String(rec["reqId"]).slice(0, 8)) + " " : "";
46
+ const extra = Object.entries(rec).filter(([k]) => !OMIT.has(k));
47
+ const err = rec["err"];
48
+ const fields = extra.filter(([k]) => k !== "err").map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`).join(" ");
49
+ out.write(
50
+ `${_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"
51
+ );
52
+ }
53
+ };
54
+ }
55
+ function workerLabel() {
56
+ return _cluster2.default.isWorker ? `w${_nullishCoalesce(_optionalChain([_cluster2.default, 'access', _5 => _5.worker, 'optionalAccess', _6 => _6.id]), () => ( "?"))}` : "primary";
57
+ }
58
+ function build(config) {
59
+ if (config === false) return _pino.pino.call(void 0, { level: "silent" });
60
+ const opts = _nullishCoalesce(config, () => ( {}));
61
+ const pretty = _nullishCoalesce(opts.pretty, () => ( (process.env["NODE_ENV"] !== "production" && process.stdout.isTTY === true)));
62
+ const base = { worker: workerLabel() };
63
+ const level = _nullishCoalesce(opts.level, () => ( "info"));
64
+ return pretty ? _pino.pino.call(void 0, { level, base, errorKey: "err" }, prettyStream()) : _pino.pino.call(void 0, { level, base, errorKey: "err", timestamp: _pino.pino.stdTimeFunctions.isoTime });
65
+ }
66
+ var rootLogger = build(void 0);
67
+ var logRequests = true;
68
+ function configureLogger(config) {
69
+ rootLogger = build(config);
70
+ logRequests = config !== false && (_nullishCoalesce(_optionalChain([config, 'optionalAccess', _7 => _7.requests]), () => ( true)));
71
+ }
72
+ function getLogger() {
73
+ return _nullishCoalesce(_optionalChain([getRequestContext, 'call', _8 => _8(), 'optionalAccess', _9 => _9.log]), () => ( rootLogger));
74
+ }
75
+ var logger = new Proxy({}, {
76
+ get(_t, prop) {
77
+ const target = getLogger();
78
+ const value = target[prop];
79
+ return typeof value === "function" ? value.bind(target) : value;
80
+ }
81
+ });
82
+ var SAFE_REQUEST_ID = /^[\w.:-]{1,128}$/;
83
+ function requestLogger() {
84
+ return (req, res, next) => {
85
+ const incoming = req.get("x-request-id");
86
+ const id = incoming && SAFE_REQUEST_ID.test(incoming) ? incoming : _crypto.randomUUID.call(void 0, );
87
+ const log = rootLogger.child({ reqId: id });
88
+ req.id = id;
89
+ req.log = log;
90
+ res.setHeader("X-Request-Id", id);
91
+ const ctx = getRequestContext();
92
+ if (ctx) {
93
+ ctx.requestId = id;
94
+ ctx.log = log;
95
+ }
96
+ if (logRequests) {
97
+ const start = process.hrtime.bigint();
98
+ res.on("finish", () => {
99
+ const durationMs = Number(process.hrtime.bigint() - start) / 1e6;
100
+ const status = res.statusCode;
101
+ const line = {
102
+ method: req.method,
103
+ url: req.originalUrl,
104
+ status,
105
+ durationMs: Math.round(durationMs * 10) / 10
106
+ };
107
+ const msg = `${req.method} ${req.originalUrl} ${status}`;
108
+ if (status >= 500) log.error(line, msg);
109
+ else if (status >= 400) log.warn(line, msg);
110
+ else log.info(line, msg);
111
+ });
112
+ }
113
+ next();
114
+ };
115
+ }
116
+
117
+
118
+
119
+
120
+
121
+
122
+
123
+
124
+
125
+
126
+ exports.runWithContext = runWithContext; exports.getRequestContext = getRequestContext; exports.setCurrentUser = setCurrentUser; exports.getCurrentUser = getCurrentUser; exports.configureLogger = configureLogger; exports.getLogger = getLogger; exports.logger = logger; exports.requestLogger = requestLogger;
127
+ //# sourceMappingURL=chunk-YL37D6KM.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-YL37D6KM.cjs","../src/context.ts","../src/logger.ts"],"names":[],"mappings":"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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-YL37D6KM.cjs","sourcesContent":[null,"import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Logger } from 'pino';\n\nexport interface RequestContext {\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 = 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 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 return getRequestContext()?.log ?? rootLogger;\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 });\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"]}
@@ -0,0 +1,438 @@
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(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await 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
+
3
+ var _chunkT4OHFU5Tcjs = require('./chunk-T4OHFU5T.cjs');
4
+
5
+
6
+ var _chunkMGH4VDV3cjs = require('./chunk-MGH4VDV3.cjs');
7
+
8
+
9
+
10
+ var _chunkYL37D6KMcjs = require('./chunk-YL37D6KM.cjs');
11
+
12
+ // src/auth/index.ts
13
+ var _crypto = require('crypto');
14
+ var _jose = require('jose');
15
+
16
+ // src/cache/index.ts
17
+ var _cluster = require('cluster'); var _cluster2 = _interopRequireDefault(_cluster);
18
+
19
+ // src/cache/ipc.ts
20
+
21
+
22
+ var TAG = "__efcCache";
23
+ var TIMEOUT_MS = 2e3;
24
+ var isTagged = (msg) => msg !== null && typeof msg === "object" && msg[TAG] === true;
25
+ function servePrimaryCache(maxEntries) {
26
+ const store = memoryBackend(maxEntries);
27
+ _cluster2.default.on("message", (worker, msg) => {
28
+ if (!isTagged(msg)) return;
29
+ const req = msg;
30
+ const run = async () => {
31
+ switch (req.op) {
32
+ case "ping":
33
+ return "pong";
34
+ case "get":
35
+ return store.get(req.args[0]);
36
+ case "set":
37
+ return store.set(
38
+ req.args[0],
39
+ req.args[1],
40
+ req.args[2]
41
+ );
42
+ case "del":
43
+ return store.del(req.args[0]);
44
+ case "clear":
45
+ return store.clear(req.args[0]);
46
+ }
47
+ };
48
+ run().then(
49
+ (result) => worker.isConnected() && worker.send({ [TAG]: true, id: req.id, ok: true, result }),
50
+ (err) => worker.isConnected() && worker.send({ [TAG]: true, id: req.id, ok: false, error: String(err) })
51
+ );
52
+ });
53
+ }
54
+ async function connectPrimaryCache() {
55
+ if (!process.send) return null;
56
+ const pending2 = /* @__PURE__ */ new Map();
57
+ const onMessage = (msg) => {
58
+ if (!isTagged(msg)) return;
59
+ const res = msg;
60
+ const p = pending2.get(res.id);
61
+ if (!p) return;
62
+ pending2.delete(res.id);
63
+ clearTimeout(p.timer);
64
+ if (res.ok) p.resolve(res.result);
65
+ else p.reject(new Error(res.error));
66
+ };
67
+ process.on("message", onMessage);
68
+ const call = (op, ...args) => new Promise((resolve, reject) => {
69
+ const id = _crypto.randomUUID.call(void 0, );
70
+ const timer = setTimeout(() => {
71
+ pending2.delete(id);
72
+ reject(new Error(`[EFC] cache IPC "${op}" timed out`));
73
+ }, TIMEOUT_MS);
74
+ timer.unref();
75
+ pending2.set(id, { resolve, reject, timer });
76
+ process.send({ [TAG]: true, id, op, args });
77
+ });
78
+ try {
79
+ await call("ping");
80
+ } catch (e) {
81
+ process.off("message", onMessage);
82
+ _chunkYL37D6KMcjs.getLogger.call(void 0, ).warn(
83
+ 'cache backend "memory": no EFC cluster primary answered \u2014 using a per-worker store (entries and revoked sessions are not shared)'
84
+ );
85
+ return null;
86
+ }
87
+ return {
88
+ get: async (key) => await call("get", key),
89
+ set: async (key, value, ttl) => {
90
+ await call("set", key, value, ttl);
91
+ },
92
+ del: async (keys) => await call("del", keys),
93
+ clear: async (prefix2) => await call("clear", prefix2),
94
+ close: async () => {
95
+ process.off("message", onMessage);
96
+ for (const p of pending2.values()) clearTimeout(p.timer);
97
+ pending2.clear();
98
+ }
99
+ };
100
+ }
101
+
102
+ // src/cache/index.ts
103
+ function memoryBackend(maxEntries) {
104
+ const store = /* @__PURE__ */ new Map();
105
+ const live = (key) => {
106
+ const hit = store.get(key);
107
+ if (!hit) return void 0;
108
+ if (hit.expires !== 0 && hit.expires <= Date.now()) {
109
+ store.delete(key);
110
+ return void 0;
111
+ }
112
+ return hit;
113
+ };
114
+ return {
115
+ async get(key) {
116
+ const hit = live(key);
117
+ if (!hit) return null;
118
+ store.delete(key);
119
+ store.set(key, hit);
120
+ return hit.value;
121
+ },
122
+ async set(key, value, ttl) {
123
+ store.delete(key);
124
+ store.set(key, { value, expires: ttl ? Date.now() + ttl * 1e3 : 0 });
125
+ while (store.size > maxEntries) store.delete(store.keys().next().value);
126
+ },
127
+ async del(keys) {
128
+ let n = 0;
129
+ for (const k of keys) if (live(k) && store.delete(k)) n++;
130
+ return n;
131
+ },
132
+ async clear(prefix2) {
133
+ let n = 0;
134
+ for (const k of [...store.keys()]) if (k.startsWith(prefix2) && store.delete(k)) n++;
135
+ return n;
136
+ },
137
+ async close() {
138
+ store.clear();
139
+ }
140
+ };
141
+ }
142
+ async function redisBackend(url, timeout) {
143
+ let Redis;
144
+ try {
145
+ const mod = await Promise.resolve().then(() => _interopRequireWildcard(require("ioredis")));
146
+ Redis = _nullishCoalesce(mod.Redis, () => ( mod.default));
147
+ } catch (err) {
148
+ throw _chunkMGH4VDV3cjs.notInstalled.call(void 0, err, "ioredis", "npm install ioredis");
149
+ }
150
+ const client = new Redis({
151
+ ..._chunkT4OHFU5Tcjs.parseRedisUrl.call(void 0, url),
152
+ // Fail fast instead of queueing commands while disconnected; callers treat
153
+ // a rejected command as a miss.
154
+ enableOfflineQueue: false,
155
+ maxRetriesPerRequest: 1,
156
+ commandTimeout: timeout
157
+ });
158
+ let lastWarn = 0;
159
+ client.on("error", (err) => {
160
+ if (Date.now() - lastWarn > 3e4) {
161
+ lastWarn = Date.now();
162
+ _chunkYL37D6KMcjs.getLogger.call(void 0, ).warn(`Cache Redis unavailable: ${err.message} (serving cache misses)`);
163
+ }
164
+ });
165
+ await new Promise((resolve) => {
166
+ const timer = setTimeout(resolve, Math.max(2e3, timeout * 2));
167
+ client.once("ready", () => {
168
+ clearTimeout(timer);
169
+ resolve();
170
+ });
171
+ });
172
+ return {
173
+ get: (key) => client.get(key),
174
+ async set(key, value, ttl) {
175
+ if (ttl) await client.set(key, value, "EX", Math.max(1, Math.ceil(ttl)));
176
+ else await client.set(key, value);
177
+ },
178
+ del: (keys) => keys.length ? client.del(...keys) : Promise.resolve(0),
179
+ async clear(prefix2) {
180
+ let n = 0;
181
+ let cursor = "0";
182
+ const match = prefix2.replace(/[*?[\]\\]/g, "\\$&") + "*";
183
+ do {
184
+ const [next, keys] = await client.scan(cursor, "MATCH", match, "COUNT", 500);
185
+ cursor = next;
186
+ if (keys.length) n += await client.unlink(...keys);
187
+ } while (cursor !== "0");
188
+ return n;
189
+ },
190
+ async close() {
191
+ await client.quit().catch(() => client.disconnect());
192
+ }
193
+ };
194
+ }
195
+ var backend = null;
196
+ var prefix = "efc:";
197
+ var revocationFailure = "reject";
198
+ function revocationFailureMode() {
199
+ return revocationFailure;
200
+ }
201
+ var pending = /* @__PURE__ */ new Map();
202
+ async function configureCache(config) {
203
+ await closeCache();
204
+ prefix = _nullishCoalesce(config.prefix, () => ( "efc:"));
205
+ revocationFailure = _nullishCoalesce(config.onRevocationCheckError, () => ( "reject"));
206
+ if (config.backend === "redis") {
207
+ backend = await redisBackend(_nullishCoalesce(config.url, () => ( "redis://localhost:6379")), _nullishCoalesce(config.timeout, () => ( 1e3)));
208
+ } else if (_cluster2.default.isWorker) {
209
+ backend = await _asyncNullishCoalesce(await connectPrimaryCache(), async () => ( memoryBackend(_nullishCoalesce(config.maxEntries, () => ( 1e4)))));
210
+ } else {
211
+ backend = memoryBackend(_nullishCoalesce(config.maxEntries, () => ( 1e4)));
212
+ }
213
+ }
214
+ function isCacheConfigured() {
215
+ return backend !== null;
216
+ }
217
+ async function closeCache() {
218
+ const b = backend;
219
+ backend = null;
220
+ pending.clear();
221
+ await _optionalChain([b, 'optionalAccess', _ => _.close, 'call', _2 => _2()]);
222
+ }
223
+ function requireBackend() {
224
+ if (!backend) throw new Error("[EFC] Cache not configured \u2014 pass cache: { backend } to ignite()");
225
+ return backend;
226
+ }
227
+ async function safely(op, fn, fallback) {
228
+ const b = requireBackend();
229
+ try {
230
+ return await fn(b);
231
+ } catch (err) {
232
+ _chunkYL37D6KMcjs.getLogger.call(void 0, ).debug({ err }, `cache ${op} failed`);
233
+ return fallback;
234
+ }
235
+ }
236
+ var cache = {
237
+ async get(key) {
238
+ const raw = await safely("get", (b) => b.get(prefix + key), null);
239
+ return raw === null ? void 0 : JSON.parse(raw);
240
+ },
241
+ async set(key, value, options) {
242
+ if (value === void 0) return;
243
+ await safely("set", (b) => b.set(prefix + key, JSON.stringify(value), _optionalChain([options, 'optionalAccess', _3 => _3.ttl])), void 0);
244
+ },
245
+ async has(key) {
246
+ return await safely("get", (b) => b.get(prefix + key), null) !== null;
247
+ },
248
+ async del(...keys) {
249
+ return safely("del", (b) => b.del(keys.map((k) => prefix + k)), 0);
250
+ },
251
+ async wrap(key, options, fn) {
252
+ const hit = await cache.get(key);
253
+ if (hit !== void 0) return hit;
254
+ const inflight = pending.get(key);
255
+ if (inflight) return inflight;
256
+ const run = (async () => {
257
+ try {
258
+ const value = await fn();
259
+ await cache.set(key, value, typeof options === "number" ? { ttl: options } : options);
260
+ return value;
261
+ } finally {
262
+ pending.delete(key);
263
+ }
264
+ })();
265
+ pending.set(key, run);
266
+ return run;
267
+ },
268
+ async clear(keyPrefix = "") {
269
+ return safely("clear", (b) => b.clear(prefix + keyPrefix), 0);
270
+ }
271
+ };
272
+ async function rawGet(key) {
273
+ return requireBackend().get(prefix + key);
274
+ }
275
+ async function rawSet(key, value, ttlSeconds) {
276
+ await requireBackend().set(prefix + key, value, ttlSeconds);
277
+ }
278
+
279
+ // src/auth/index.ts
280
+ var _config = null;
281
+ function configureAuth(config) {
282
+ _config = config;
283
+ }
284
+ function getConfig() {
285
+ if (!_config) throw new Error("[EFC] Auth not configured \u2014 pass jwtSecret to ignite()");
286
+ return _config;
287
+ }
288
+ async function sign(payload) {
289
+ const { secret, expiresIn } = getConfig();
290
+ return new (0, _jose.SignJWT)({ ...payload, efc_iat: Date.now() }).setProtectedHeader({ alg: "HS256" }).setJti(_crypto.randomUUID.call(void 0, )).setIssuedAt().setExpirationTime(expiresIn).sign(new TextEncoder().encode(secret));
291
+ }
292
+ async function issueToken(res, payload) {
293
+ const { cookieDomain } = getConfig();
294
+ const token = await sign(payload);
295
+ res.cookie("efc_token", token, {
296
+ httpOnly: true,
297
+ secure: process.env["NODE_ENV"] === "production",
298
+ sameSite: "strict",
299
+ ...cookieDomain !== void 0 && { domain: cookieDomain }
300
+ });
301
+ }
302
+ function revokeToken(res) {
303
+ res.clearCookie("efc_token");
304
+ }
305
+ async function signToken(payload) {
306
+ return sign(payload);
307
+ }
308
+ function tokenFrom(req) {
309
+ if (getConfig().strategy === "http-only") {
310
+ return _optionalChain([req, 'access', _4 => _4.cookies, 'optionalAccess', _5 => _5["efc_token"]]);
311
+ }
312
+ const auth = req.headers["authorization"];
313
+ return typeof auth === "string" && auth.startsWith("Bearer ") ? auth.slice(7) : void 0;
314
+ }
315
+ async function verify(token) {
316
+ const { payload } = await _jose.jwtVerify.call(void 0, token, new TextEncoder().encode(getConfig().secret));
317
+ return payload;
318
+ }
319
+ var userIdOf = (payload) => {
320
+ const id = _nullishCoalesce(payload.sub, () => ( payload["id"]));
321
+ return id === void 0 || id === null ? void 0 : String(id);
322
+ };
323
+ function tokenLifetimeSeconds() {
324
+ const m = /^(\d+(?:\.\d+)?)\s*(s|sec|secs|seconds?|m|min|mins|minutes?|h|hr|hrs|hours?|d|days?|w|weeks?|y|yrs?|years?)?$/i.exec(
325
+ getConfig().expiresIn.trim()
326
+ );
327
+ if (!m) return 30 * 86400;
328
+ const n = Number(m[1]);
329
+ const unit = (_nullishCoalesce(m[2], () => ( "s")))[0].toLowerCase();
330
+ const factor = _nullishCoalesce({ s: 1, m: 60, h: 3600, d: 86400, w: 604800, y: 31557600 }[unit], () => ( 1));
331
+ return Math.ceil(n * factor);
332
+ }
333
+ var lastRevocationError = 0;
334
+ async function isRevoked(payload) {
335
+ if (payload.jti && await rawGet(`sess:jti:${payload.jti}`) !== null) return true;
336
+ const userId = userIdOf(payload);
337
+ if (userId === void 0) return false;
338
+ const cutoff = await rawGet(`sess:user:${userId}`);
339
+ if (cutoff === null) return false;
340
+ const issuedMs = typeof payload["efc_iat"] === "number" ? payload["efc_iat"] : (_nullishCoalesce(payload.iat, () => ( 0))) * 1e3;
341
+ return issuedMs < Number(cutoff);
342
+ }
343
+ function requireRevocationStore() {
344
+ if (!isCacheConfigured()) {
345
+ throw new Error(
346
+ '[EFC] Session revocation needs a cache \u2014 pass cache: { backend: "redis" } to ignite()'
347
+ );
348
+ }
349
+ }
350
+ async function revokeSession(req, res) {
351
+ requireRevocationStore();
352
+ const token = tokenFrom(req);
353
+ if (res && getConfig().strategy === "http-only") res.clearCookie("efc_token");
354
+ if (!token) return;
355
+ let payload;
356
+ try {
357
+ payload = await verify(token);
358
+ } catch (e2) {
359
+ return;
360
+ }
361
+ if (!payload.jti) return;
362
+ const ttl = payload.exp ? payload.exp - Math.floor(Date.now() / 1e3) : tokenLifetimeSeconds();
363
+ if (ttl > 0) await rawSet(`sess:jti:${payload.jti}`, "1", ttl);
364
+ }
365
+ async function revokeAllSessions(userId) {
366
+ requireRevocationStore();
367
+ await rawSet(`sess:user:${String(userId)}`, String(Date.now()), tokenLifetimeSeconds());
368
+ }
369
+ async function authenticate(req, res, next, roles) {
370
+ try {
371
+ const token = tokenFrom(req);
372
+ if (!token) {
373
+ res.status(401).json({ error: "Unauthorized" });
374
+ return;
375
+ }
376
+ const payload = await verify(token);
377
+ if (isCacheConfigured()) {
378
+ let revoked = false;
379
+ try {
380
+ revoked = await isRevoked(payload);
381
+ } catch (err) {
382
+ const reject = revocationFailureMode() === "reject";
383
+ if (Date.now() - lastRevocationError > 3e4) {
384
+ lastRevocationError = Date.now();
385
+ _chunkYL37D6KMcjs.getLogger.call(void 0, ).error(
386
+ { err },
387
+ `Session revocation check failed \u2014 ${reject ? "rejecting with 503" : "allowing"} authenticated requests`
388
+ );
389
+ }
390
+ if (reject) {
391
+ res.status(503).json({ error: "Service Unavailable", statusCode: 503 });
392
+ return;
393
+ }
394
+ }
395
+ if (revoked) {
396
+ res.status(401).json({ error: "Unauthorized" });
397
+ return;
398
+ }
399
+ }
400
+ if (roles.length > 0) {
401
+ const role = payload["role"];
402
+ if (typeof role !== "string" || !roles.includes(role)) {
403
+ res.status(403).json({ error: "Forbidden" });
404
+ return;
405
+ }
406
+ }
407
+ req.user = payload;
408
+ _chunkYL37D6KMcjs.setCurrentUser.call(void 0, payload);
409
+ next();
410
+ } catch (e3) {
411
+ res.status(401).json({ error: "Unauthorized" });
412
+ }
413
+ }
414
+ var requireAuth = ((...args) => {
415
+ if (args.length > 0 && typeof args[0] === "string") {
416
+ const roles = args;
417
+ return (req2, res2, next2) => {
418
+ void authenticate(req2, res2, next2, roles);
419
+ };
420
+ }
421
+ const [req, res, next] = args;
422
+ void authenticate(req, res, next, []);
423
+ });
424
+
425
+
426
+
427
+
428
+
429
+
430
+
431
+
432
+
433
+
434
+
435
+
436
+
437
+ exports.servePrimaryCache = servePrimaryCache; exports.configureCache = configureCache; exports.closeCache = closeCache; exports.cache = cache; exports.configureAuth = configureAuth; exports.issueToken = issueToken; exports.revokeToken = revokeToken; exports.signToken = signToken; exports.revokeSession = revokeSession; exports.revokeAllSessions = revokeAllSessions; exports.requireAuth = requireAuth;
438
+ //# sourceMappingURL=chunk-ZDM5JHVK.cjs.map