@venizia/ignis-helpers 0.3.6 → 0.4.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 (246) hide show
  1. package/LICENSE.md +1 -1
  2. package/dist/cjs/common/redact.js +1 -1
  3. package/dist/cjs/common/redact.js.map +1 -1
  4. package/dist/cjs/modules/base.js +1 -1
  5. package/dist/cjs/modules/base.js.map +1 -1
  6. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js +1 -1
  7. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  8. package/dist/cjs/modules/logger/common/constants.js +1 -1
  9. package/dist/cjs/modules/logger/common/constants.js.map +1 -1
  10. package/dist/cjs/modules/logger/factory.js +1 -1
  11. package/dist/cjs/modules/logger/factory.js.map +1 -1
  12. package/dist/cjs/modules/logger/formatting/deep-splat.js +1 -1
  13. package/dist/cjs/modules/logger/formatting/deep-splat.js.map +1 -1
  14. package/dist/cjs/modules/logger/formatting/error-prettier.js +4 -4
  15. package/dist/cjs/modules/logger/formatting/error-prettier.js.map +1 -1
  16. package/dist/cjs/modules/logger/hf/flusher.js +3 -3
  17. package/dist/cjs/modules/logger/hf/flusher.js.map +1 -1
  18. package/dist/cjs/modules/logger/resolver.js +3 -3
  19. package/dist/cjs/modules/logger/resolver.js.map +1 -1
  20. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js +1 -1
  21. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  22. package/dist/cjs/modules/logger/winston/logger-factory.js +1 -1
  23. package/dist/cjs/modules/logger/winston/logger-factory.js.map +1 -1
  24. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js +2 -2
  25. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  26. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  27. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  28. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  29. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  30. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  31. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  32. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  33. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  34. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js +34 -11
  35. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  36. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  37. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  38. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
  39. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  40. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  41. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  42. package/dist/cjs/modules/network/utilities/query-string.d.ts +27 -2
  43. package/dist/cjs/modules/network/utilities/query-string.d.ts.map +1 -1
  44. package/dist/cjs/modules/network/utilities/query-string.js +34 -2
  45. package/dist/cjs/modules/network/utilities/query-string.js.map +1 -1
  46. package/dist/cjs/modules/network/utilities/url-safety/ingest.js +1 -1
  47. package/dist/cjs/modules/network/utilities/url-safety/ingest.js.map +1 -1
  48. package/dist/cjs/modules/network/utilities/url-safety/policy.js +1 -1
  49. package/dist/cjs/modules/network/utilities/url-safety/policy.js.map +1 -1
  50. package/dist/cjs/modules/pool/abstract.js +4 -4
  51. package/dist/cjs/modules/pool/abstract.js.map +1 -1
  52. package/dist/cjs/modules/queue/bullmq/helper.js +2 -2
  53. package/dist/cjs/modules/queue/bullmq/helper.js.map +1 -1
  54. package/dist/cjs/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  55. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  56. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  57. package/dist/cjs/modules/queue/kafka/consumer.js +2 -2
  58. package/dist/cjs/modules/queue/kafka/consumer.js.map +1 -1
  59. package/dist/cjs/modules/queue/mqtt/helper.js +4 -4
  60. package/dist/cjs/modules/queue/mqtt/helper.js.map +1 -1
  61. package/dist/cjs/modules/redis/base/abstract.helper.js +4 -4
  62. package/dist/cjs/modules/redis/base/abstract.helper.js.map +1 -1
  63. package/dist/cjs/modules/redis/cluster/cluster.helper.js +1 -1
  64. package/dist/cjs/modules/redis/cluster/cluster.helper.js.map +1 -1
  65. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js +1 -1
  66. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  67. package/dist/cjs/modules/secrets/base/abstract.helper.js +2 -2
  68. package/dist/cjs/modules/secrets/base/abstract.helper.js.map +1 -1
  69. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  70. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  71. package/dist/cjs/modules/socket/socket-io/browser.d.ts +5 -0
  72. package/dist/cjs/modules/socket/socket-io/browser.d.ts.map +1 -0
  73. package/dist/cjs/modules/socket/socket-io/browser.js +21 -0
  74. package/dist/cjs/modules/socket/socket-io/browser.js.map +1 -0
  75. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  76. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  77. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js +250 -0
  78. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  79. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts +8 -51
  80. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  81. package/dist/cjs/modules/socket/socket-io/client/helper.js +12 -230
  82. package/dist/cjs/modules/socket/socket-io/client/helper.js.map +1 -1
  83. package/dist/cjs/modules/socket/socket-io/server/helper.js +5 -5
  84. package/dist/cjs/modules/socket/socket-io/server/helper.js.map +1 -1
  85. package/dist/cjs/modules/socket/websocket/server/delivery.js +2 -2
  86. package/dist/cjs/modules/socket/websocket/server/delivery.js.map +1 -1
  87. package/dist/cjs/modules/socket/websocket/server/helper.js +4 -4
  88. package/dist/cjs/modules/socket/websocket/server/helper.js.map +1 -1
  89. package/dist/cjs/modules/storage/base.js +3 -3
  90. package/dist/cjs/modules/storage/base.js.map +1 -1
  91. package/dist/cjs/modules/storage/bun-s3/helper.js +1 -1
  92. package/dist/cjs/modules/storage/bun-s3/helper.js.map +1 -1
  93. package/dist/cjs/modules/storage/bun-s3/utility.js +6 -6
  94. package/dist/cjs/modules/storage/bun-s3/utility.js.map +1 -1
  95. package/dist/cjs/modules/storage/common/errors.js +1 -1
  96. package/dist/cjs/modules/storage/common/errors.js.map +1 -1
  97. package/dist/cjs/modules/storage/minio/helper.js +4 -4
  98. package/dist/cjs/modules/storage/minio/helper.js.map +1 -1
  99. package/dist/cjs/modules/temporal/abstract.js +5 -5
  100. package/dist/cjs/modules/temporal/abstract.js.map +1 -1
  101. package/dist/cjs/modules/temporal/adapters/intl.d.ts.map +1 -1
  102. package/dist/cjs/modules/temporal/adapters/intl.js +3 -1
  103. package/dist/cjs/modules/temporal/adapters/intl.js.map +1 -1
  104. package/dist/cjs/modules/temporal/locale/locale.js +4 -4
  105. package/dist/cjs/modules/temporal/locale/locale.js.map +1 -1
  106. package/dist/cjs/modules/tree/builder.js +2 -2
  107. package/dist/cjs/modules/tree/builder.js.map +1 -1
  108. package/dist/cjs/modules/uid/opaque.js +2 -2
  109. package/dist/cjs/modules/uid/opaque.js.map +1 -1
  110. package/dist/cjs/modules/uid/uuid/v5.js +1 -1
  111. package/dist/cjs/modules/uid/uuid/v5.js.map +1 -1
  112. package/dist/cjs/modules/worker-thread/bus/base.js +4 -4
  113. package/dist/cjs/modules/worker-thread/bus/base.js.map +1 -1
  114. package/dist/cjs/modules/worker-thread/worker/base.js +4 -4
  115. package/dist/cjs/modules/worker-thread/worker/base.js.map +1 -1
  116. package/dist/cjs/utilities/parse.utility.js +4 -4
  117. package/dist/cjs/utilities/parse.utility.js.map +1 -1
  118. package/dist/cjs/utilities/promise.utility.js +1 -1
  119. package/dist/cjs/utilities/promise.utility.js.map +1 -1
  120. package/dist/cjs/utilities/request.utility.js +1 -1
  121. package/dist/cjs/utilities/request.utility.js.map +1 -1
  122. package/dist/cjs/utilities/sleep.utility.js +1 -1
  123. package/dist/cjs/utilities/sleep.utility.js.map +1 -1
  124. package/dist/esm/common/redact.js +1 -1
  125. package/dist/esm/common/redact.js.map +1 -1
  126. package/dist/esm/modules/base.js +1 -1
  127. package/dist/esm/modules/base.js.map +1 -1
  128. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +1 -1
  129. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  130. package/dist/esm/modules/logger/common/constants.js +1 -1
  131. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  132. package/dist/esm/modules/logger/factory.js +1 -1
  133. package/dist/esm/modules/logger/factory.js.map +1 -1
  134. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -1
  135. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  136. package/dist/esm/modules/logger/formatting/error-prettier.js +4 -4
  137. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  138. package/dist/esm/modules/logger/hf/flusher.js +3 -3
  139. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  140. package/dist/esm/modules/logger/resolver.js +3 -3
  141. package/dist/esm/modules/logger/resolver.js.map +1 -1
  142. package/dist/esm/modules/logger/winston/formatters/deep-splat.js +1 -1
  143. package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  144. package/dist/esm/modules/logger/winston/logger-factory.js +1 -1
  145. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  146. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +2 -2
  147. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  148. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  149. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  150. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  151. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  152. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  153. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  154. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  155. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  156. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +36 -13
  157. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  158. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  159. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  160. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
  161. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  162. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  163. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  164. package/dist/esm/modules/network/utilities/query-string.d.ts +27 -2
  165. package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
  166. package/dist/esm/modules/network/utilities/query-string.js +31 -1
  167. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  168. package/dist/esm/modules/network/utilities/url-safety/ingest.js +1 -1
  169. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  170. package/dist/esm/modules/network/utilities/url-safety/policy.js +1 -1
  171. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  172. package/dist/esm/modules/pool/abstract.js +4 -4
  173. package/dist/esm/modules/pool/abstract.js.map +1 -1
  174. package/dist/esm/modules/queue/bullmq/helper.js +2 -2
  175. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  176. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  177. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  178. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  179. package/dist/esm/modules/queue/kafka/consumer.js +2 -2
  180. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  181. package/dist/esm/modules/queue/mqtt/helper.js +4 -4
  182. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  183. package/dist/esm/modules/redis/base/abstract.helper.js +4 -4
  184. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  185. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -1
  186. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  187. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -1
  188. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  189. package/dist/esm/modules/secrets/base/abstract.helper.js +2 -2
  190. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  191. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  192. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  193. package/dist/esm/modules/socket/socket-io/browser.d.ts +5 -0
  194. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +1 -0
  195. package/dist/esm/modules/socket/socket-io/browser.js +5 -0
  196. package/dist/esm/modules/socket/socket-io/browser.js.map +1 -0
  197. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  198. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  199. package/dist/esm/modules/socket/socket-io/client/browser-helper.js +246 -0
  200. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  201. package/dist/esm/modules/socket/socket-io/client/helper.d.ts +8 -51
  202. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  203. package/dist/esm/modules/socket/socket-io/client/helper.js +12 -230
  204. package/dist/esm/modules/socket/socket-io/client/helper.js.map +1 -1
  205. package/dist/esm/modules/socket/socket-io/server/helper.js +5 -5
  206. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  207. package/dist/esm/modules/socket/websocket/server/delivery.js +2 -2
  208. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  209. package/dist/esm/modules/socket/websocket/server/helper.js +4 -4
  210. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  211. package/dist/esm/modules/storage/base.js +3 -3
  212. package/dist/esm/modules/storage/base.js.map +1 -1
  213. package/dist/esm/modules/storage/bun-s3/helper.js +1 -1
  214. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  215. package/dist/esm/modules/storage/bun-s3/utility.js +6 -6
  216. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  217. package/dist/esm/modules/storage/common/errors.js +1 -1
  218. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  219. package/dist/esm/modules/storage/minio/helper.js +4 -4
  220. package/dist/esm/modules/storage/minio/helper.js.map +1 -1
  221. package/dist/esm/modules/temporal/abstract.js +5 -5
  222. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  223. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +1 -1
  224. package/dist/esm/modules/temporal/adapters/intl.js +3 -1
  225. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  226. package/dist/esm/modules/temporal/locale/locale.js +4 -4
  227. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  228. package/dist/esm/modules/tree/builder.js +2 -2
  229. package/dist/esm/modules/tree/builder.js.map +1 -1
  230. package/dist/esm/modules/uid/opaque.js +2 -2
  231. package/dist/esm/modules/uid/opaque.js.map +1 -1
  232. package/dist/esm/modules/uid/uuid/v5.js +1 -1
  233. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  234. package/dist/esm/modules/worker-thread/bus/base.js +4 -4
  235. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  236. package/dist/esm/modules/worker-thread/worker/base.js +4 -4
  237. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  238. package/dist/esm/utilities/parse.utility.js +4 -4
  239. package/dist/esm/utilities/parse.utility.js.map +1 -1
  240. package/dist/esm/utilities/promise.utility.js +1 -1
  241. package/dist/esm/utilities/promise.utility.js.map +1 -1
  242. package/dist/esm/utilities/request.utility.js +1 -1
  243. package/dist/esm/utilities/request.utility.js.map +1 -1
  244. package/dist/esm/utilities/sleep.utility.js +1 -1
  245. package/dist/esm/utilities/sleep.utility.js.map +1 -1
  246. package/package.json +69 -64
package/LICENSE.md CHANGED
@@ -36,7 +36,7 @@ This monorepo contains the following packages, all licensed under MIT:
36
36
  | `@venizia/ignis-boot` | Application bootstrapping & artifact auto-discovery |
37
37
  | `@venizia/ignis-helpers` | Utility helpers - logging, cron, Redis, queues, storage |
38
38
  | `@venizia/ignis-inversion` | Dependency Injection & IoC container |
39
- | `@venizia/dev-configs` | Shared ESLint, Prettier, TypeScript configurations |
39
+ | `@venizia/dev-configs` | Shared oxlint, ESLint, TypeScript configurations |
40
40
  | `@venizia/ignis-docs` | Documentation and MCP Server |
41
41
 
42
42
  ---
@@ -94,7 +94,7 @@ const deepSanitize = (value, context) => {
94
94
  return result;
95
95
  }
96
96
  if (Array.isArray(value)) {
97
- return value.map(entry => deepSanitize(entry, nested));
97
+ return value.map((entry) => deepSanitize(entry, nested));
98
98
  }
99
99
  const source = value;
100
100
  const result = {};
@@ -1 +1 @@
1
- {"version":3,"file":"redact.js","sourceRoot":"","sources":["../../../src/common/redact.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyObject } from './types';\n\n/** Keys whose VALUES must never reach a log line - matched case-insensitively on the key name, at any depth. */\nconst SECRET_KEY_PATTERN = new RegExp(\n [\n // Options-object spellings (camelCase / snake_case).\n '^(pass|password|passphrase|secret|token|apiKey|api_key|accessKey|access_key',\n '|secretKey|secret_key|privateKey|private_key|key|cert|ca|pfx|credentials',\n '|authorization|auth|jwtSecret|applicationSecret|connectionString)$',\n\n // Vault wire spellings (snake_case): node-vault's AppRole login/response bodies carry these exact keys, and none are matched by the anchored options list above.\n '|^(client_token|secret_id|role_id)$',\n\n // Any `*_token` (snake_case) or `*Token` (camelCase) key; a preceding character is required so the bare word `token` (already covered above) is not the whole match, and so ordinary words are not swallowed.\n '|_token$|[a-z0-9]token$',\n\n // The `*Secret` counterpart the `*Token` rule always lacked. `clientSecret` / `client_secret` is the RFC 6749 parameter name and a live field on the search connector's model options, and `webhookSecret` is the standard spelling everywhere; none of them matched the anchored list above.\n '|_secret$|[a-z0-9]secret$',\n\n // Connection descriptors: `connectionString` was anchored above but its snake_case twin was not, and `dsn` is the third common spelling for the same thing.\n '|^(connection_string|dsn|database_url|databaseUrl)$',\n\n // Any `*_password` / `*Password` key - `dbPassword`, `admin_password`. The bare word is anchored above; this catches the prefixed forms.\n '|_password$|[a-z0-9]password$',\n\n // HTTP HEADER spellings: header names are kebab-case and often `x-`-prefixed, none of which the camelCase list above matches; `vault` is included so `X-Vault-Token` (node-vault's auth header) is caught.\n '|^(x-)?(api|auth|access|secret|session|csrf|xsrf|vault)-(key|token|secret|id)$',\n '|^(cookie|set-cookie|proxy-authorization|www-authenticate)$',\n ].join(''),\n 'i',\n);\n\nexport const REDACTED = '[REDACTED]';\n\n/** Kill-switch for local debugging: only the literal `false` disables redaction (fail-closed); read per call so it can be flipped at runtime. Never disable in production. */\nconst isRedactionEnabled = (): boolean =>\n globalThis.process?.env?.APP_ENV_LOGGER_DO_REDACT !== 'false';\n\n/** Longest string a log line carries whole. `APP_ENV_LOGGER_MAX_STRING_LENGTH=0` turns capping off. */\nconst DEFAULT_MAX_STRING_LENGTH = 2048;\n\nconst resolveMaxStringLength = (): number => {\n const configured = Number(globalThis.process?.env?.APP_ENV_LOGGER_MAX_STRING_LENGTH);\n return Number.isFinite(configured) && configured >= 0 ? configured : DEFAULT_MAX_STRING_LENGTH;\n};\n\n/**\n * Keys whose value is long BY NATURE and useless truncated. A stack trace is the whole reason you\n * are reading the line.\n */\nconst UNCAPPED_KEYS = new Set(['stack', 'stacktrace', 'stack_trace']);\n\n/**\n * Caps a long string, keeping the ORIGINAL LENGTH in the marker - that number is what tells you the\n * payload was a 300 KB image rather than a truncated sentence.\n *\n * A base64 body is the case this exists for: one `data:image/png;base64,...` field turns a request\n * log into hundreds of kilobytes, and nothing about it is readable.\n */\nconst capString = (opts: { value: string; key?: string; limit: number }): string => {\n const { value, key, limit } = opts;\n\n if (limit === 0 || value.length <= limit || (key && UNCAPPED_KEYS.has(key.toLowerCase()))) {\n return value;\n }\n\n return `${value.slice(0, limit)}... [truncated, ${value.length} chars total]`;\n};\n\ntype TSanitizeContext = {\n seen: WeakSet<object>;\n doRedact: boolean;\n /** Levels still allowed BELOW the current one; `Infinity` walks the whole graph. */\n depth: number;\n /** Longest string kept whole; 0 keeps every string. */\n maxStringLength: number;\n /** The key this value was found under, so a stack trace can be exempted from capping. */\n key?: string;\n};\n\nconst deepSanitize = (value: unknown, context: TSanitizeContext): unknown => {\n const { seen, doRedact, depth } = context;\n\n if (typeof value === 'string') {\n return capString({ value, key: context.key, limit: context.maxStringLength });\n }\n\n if (value === null || typeof value !== 'object') {\n return value;\n }\n\n // A Date holds its value in an internal slot, so the generic branch below - which reads Object.keys() - would flatten it to `{}`. Checked BEFORE `seen`: a Date cannot carry a cycle, and entering the set would make a second reference to the same instance read as `[Circular]`.\n if (value instanceof Date) {\n return value;\n }\n\n if (seen.has(value)) {\n return '[Circular]';\n }\n\n if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer) {\n return `[Binary ${(value as ArrayBufferView).byteLength ?? 0} bytes]`;\n }\n\n if (depth <= 0) {\n return Array.isArray(value) ? '[Array]' : '[Object]';\n }\n\n seen.add(value);\n const nested: TSanitizeContext = {\n seen,\n doRedact,\n depth: depth - 1,\n maxStringLength: context.maxStringLength,\n };\n\n // Error keeps name/message/stack NON-enumerable, so Object.keys() skips them and naive redaction would drop the message - reproject into a plain object carrying those fields plus its redacted enumerable own-props.\n if (value instanceof Error) {\n const source = value;\n const result: AnyObject = {\n name: value.name,\n message: value.message,\n stack: value.stack,\n };\n\n for (const [key, entry] of Object.entries(source)) {\n result[key] =\n doRedact && SECRET_KEY_PATTERN.test(key)\n ? REDACTED\n : deepSanitize(entry, { ...nested, key });\n }\n\n return result;\n }\n\n if (Array.isArray(value)) {\n return value.map(entry => deepSanitize(entry, nested));\n }\n\n const source = value;\n const result: AnyObject = {};\n\n for (const [key, entry] of Object.entries(source)) {\n if (doRedact && SECRET_KEY_PATTERN.test(key)) {\n result[key] = REDACTED;\n continue;\n }\n\n result[key] = deepSanitize(entry, { ...nested, key });\n }\n\n return result;\n};\n\n/**\n * Redacts every secret-looking KEY (not value shape - buffers/typed arrays are summarized, not\n * serialized). `APP_ENV_LOGGER_DO_REDACT=false` makes this the identity function.\n *\n * `depth` bounds the walk, exactly as {@link toJsonSafe} already does. It defaults to `Infinity` for\n * callers that really do want the whole graph, but the logger passes its own bound: rendering only\n * inspects a handful of levels, so walking to `Infinity` did work whose result was thrown away -\n * 12x on a deep graph, and a `RangeError` on a very deep chain.\n */\nexport const redactSecrets = (\n value: unknown,\n seen?: WeakSet<object>,\n depth: number = Infinity,\n): unknown => {\n if (!isRedactionEnabled()) {\n return value;\n }\n\n return deepSanitize(value, {\n seen: seen ?? new WeakSet<object>(),\n doRedact: true,\n depth,\n maxStringLength: resolveMaxStringLength(),\n });\n};\n\n/** Projects a value into something `JSON.stringify` can render: it answers `[Circular]` for the WHOLE payload when one cycle sits anywhere inside it, so cycles must be broken per-branch first. `depth` bounds the walk the way `util.inspect` does - a log argument may hold a live connector or request context, whose graph is effectively unbounded. The projection itself is unconditional: `APP_ENV_LOGGER_DO_REDACT=false` turns off the key masking, never the structural pass. */\nexport const toJsonSafe = (opts: { value: unknown; depth?: number }): unknown => {\n return deepSanitize(opts.value, {\n seen: new WeakSet<object>(),\n doRedact: isRedactionEnabled(),\n depth: opts.depth ?? Infinity,\n // Capping is STRUCTURAL, like the projection itself: turning redaction off is about key masking,\n // never about letting a 300 KB base64 field through.\n maxStringLength: resolveMaxStringLength(),\n });\n};\n\n/** Strips credentials from a connection URL's authority section (`user:hunter2@host` -> `user:[REDACTED]@host`) - {@link redactSecrets} matches on KEY names and can't see them there. A value that fails to parse as a URL is returned unchanged. */\nexport const redactUrlCredentials = (url: string): string => {\n if (!isRedactionEnabled()) {\n return url;\n }\n\n let parsed: URL;\n\n try {\n parsed = new URL(url);\n } catch {\n return url;\n }\n\n if (!parsed.password) {\n return url;\n }\n\n parsed.password = REDACTED;\n return decodeURIComponent(parsed.toString());\n};\n"]}
1
+ {"version":3,"file":"redact.js","sourceRoot":"","sources":["../../../src/common/redact.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyObject } from './types';\n\n/** Keys whose VALUES must never reach a log line - matched case-insensitively on the key name, at any depth. */\nconst SECRET_KEY_PATTERN = new RegExp(\n [\n // Options-object spellings (camelCase / snake_case).\n '^(pass|password|passphrase|secret|token|apiKey|api_key|accessKey|access_key',\n '|secretKey|secret_key|privateKey|private_key|key|cert|ca|pfx|credentials',\n '|authorization|auth|jwtSecret|applicationSecret|connectionString)$',\n\n // Vault wire spellings (snake_case): node-vault's AppRole login/response bodies carry these exact keys, and none are matched by the anchored options list above.\n '|^(client_token|secret_id|role_id)$',\n\n // Any `*_token` (snake_case) or `*Token` (camelCase) key; a preceding character is required so the bare word `token` (already covered above) is not the whole match, and so ordinary words are not swallowed.\n '|_token$|[a-z0-9]token$',\n\n // The `*Secret` counterpart the `*Token` rule always lacked. `clientSecret` / `client_secret` is the RFC 6749 parameter name and a live field on the search connector's model options, and `webhookSecret` is the standard spelling everywhere; none of them matched the anchored list above.\n '|_secret$|[a-z0-9]secret$',\n\n // Connection descriptors: `connectionString` was anchored above but its snake_case twin was not, and `dsn` is the third common spelling for the same thing.\n '|^(connection_string|dsn|database_url|databaseUrl)$',\n\n // Any `*_password` / `*Password` key - `dbPassword`, `admin_password`. The bare word is anchored above; this catches the prefixed forms.\n '|_password$|[a-z0-9]password$',\n\n // HTTP HEADER spellings: header names are kebab-case and often `x-`-prefixed, none of which the camelCase list above matches; `vault` is included so `X-Vault-Token` (node-vault's auth header) is caught.\n '|^(x-)?(api|auth|access|secret|session|csrf|xsrf|vault)-(key|token|secret|id)$',\n '|^(cookie|set-cookie|proxy-authorization|www-authenticate)$',\n ].join(''),\n 'i',\n);\n\nexport const REDACTED = '[REDACTED]';\n\n/** Kill-switch for local debugging: only the literal `false` disables redaction (fail-closed); read per call so it can be flipped at runtime. Never disable in production. */\nconst isRedactionEnabled = (): boolean =>\n globalThis.process?.env?.APP_ENV_LOGGER_DO_REDACT !== 'false';\n\n/** Longest string a log line carries whole. `APP_ENV_LOGGER_MAX_STRING_LENGTH=0` turns capping off. */\nconst DEFAULT_MAX_STRING_LENGTH = 2048;\n\nconst resolveMaxStringLength = (): number => {\n const configured = Number(globalThis.process?.env?.APP_ENV_LOGGER_MAX_STRING_LENGTH);\n return Number.isFinite(configured) && configured >= 0 ? configured : DEFAULT_MAX_STRING_LENGTH;\n};\n\n/**\n * Keys whose value is long BY NATURE and useless truncated. A stack trace is the whole reason you\n * are reading the line.\n */\nconst UNCAPPED_KEYS = new Set(['stack', 'stacktrace', 'stack_trace']);\n\n/**\n * Caps a long string, keeping the ORIGINAL LENGTH in the marker - that number is what tells you the\n * payload was a 300 KB image rather than a truncated sentence.\n *\n * A base64 body is the case this exists for: one `data:image/png;base64,...` field turns a request\n * log into hundreds of kilobytes, and nothing about it is readable.\n */\nconst capString = (opts: { value: string; key?: string; limit: number }): string => {\n const { value, key, limit } = opts;\n\n if (limit === 0 || value.length <= limit || (key && UNCAPPED_KEYS.has(key.toLowerCase()))) {\n return value;\n }\n\n return `${value.slice(0, limit)}... [truncated, ${value.length} chars total]`;\n};\n\ntype TSanitizeContext = {\n seen: WeakSet<object>;\n doRedact: boolean;\n /** Levels still allowed BELOW the current one; `Infinity` walks the whole graph. */\n depth: number;\n /** Longest string kept whole; 0 keeps every string. */\n maxStringLength: number;\n /** The key this value was found under, so a stack trace can be exempted from capping. */\n key?: string;\n};\n\nconst deepSanitize = (value: unknown, context: TSanitizeContext): unknown => {\n const { seen, doRedact, depth } = context;\n\n if (typeof value === 'string') {\n return capString({ value, key: context.key, limit: context.maxStringLength });\n }\n\n if (value === null || typeof value !== 'object') {\n return value;\n }\n\n // A Date holds its value in an internal slot, so the generic branch below - which reads Object.keys() - would flatten it to `{}`. Checked BEFORE `seen`: a Date cannot carry a cycle, and entering the set would make a second reference to the same instance read as `[Circular]`.\n if (value instanceof Date) {\n return value;\n }\n\n if (seen.has(value)) {\n return '[Circular]';\n }\n\n if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer) {\n return `[Binary ${(value as ArrayBufferView).byteLength ?? 0} bytes]`;\n }\n\n if (depth <= 0) {\n return Array.isArray(value) ? '[Array]' : '[Object]';\n }\n\n seen.add(value);\n const nested: TSanitizeContext = {\n seen,\n doRedact,\n depth: depth - 1,\n maxStringLength: context.maxStringLength,\n };\n\n // Error keeps name/message/stack NON-enumerable, so Object.keys() skips them and naive redaction would drop the message - reproject into a plain object carrying those fields plus its redacted enumerable own-props.\n if (value instanceof Error) {\n const source = value;\n const result: AnyObject = {\n name: value.name,\n message: value.message,\n stack: value.stack,\n };\n\n for (const [key, entry] of Object.entries(source)) {\n result[key] =\n doRedact && SECRET_KEY_PATTERN.test(key)\n ? REDACTED\n : deepSanitize(entry, { ...nested, key });\n }\n\n return result;\n }\n\n if (Array.isArray(value)) {\n return value.map((entry) => deepSanitize(entry, nested));\n }\n\n const source = value;\n const result: AnyObject = {};\n\n for (const [key, entry] of Object.entries(source)) {\n if (doRedact && SECRET_KEY_PATTERN.test(key)) {\n result[key] = REDACTED;\n continue;\n }\n\n result[key] = deepSanitize(entry, { ...nested, key });\n }\n\n return result;\n};\n\n/**\n * Redacts every secret-looking KEY (not value shape - buffers/typed arrays are summarized, not\n * serialized). `APP_ENV_LOGGER_DO_REDACT=false` makes this the identity function.\n *\n * `depth` bounds the walk, exactly as {@link toJsonSafe} already does. It defaults to `Infinity` for\n * callers that really do want the whole graph, but the logger passes its own bound: rendering only\n * inspects a handful of levels, so walking to `Infinity` did work whose result was thrown away -\n * 12x on a deep graph, and a `RangeError` on a very deep chain.\n */\nexport const redactSecrets = (\n value: unknown,\n seen?: WeakSet<object>,\n depth: number = Infinity,\n): unknown => {\n if (!isRedactionEnabled()) {\n return value;\n }\n\n return deepSanitize(value, {\n seen: seen ?? new WeakSet<object>(),\n doRedact: true,\n depth,\n maxStringLength: resolveMaxStringLength(),\n });\n};\n\n/** Projects a value into something `JSON.stringify` can render: it answers `[Circular]` for the WHOLE payload when one cycle sits anywhere inside it, so cycles must be broken per-branch first. `depth` bounds the walk the way `util.inspect` does - a log argument may hold a live connector or request context, whose graph is effectively unbounded. The projection itself is unconditional: `APP_ENV_LOGGER_DO_REDACT=false` turns off the key masking, never the structural pass. */\nexport const toJsonSafe = (opts: { value: unknown; depth?: number }): unknown => {\n return deepSanitize(opts.value, {\n seen: new WeakSet<object>(),\n doRedact: isRedactionEnabled(),\n depth: opts.depth ?? Infinity,\n // Capping is STRUCTURAL, like the projection itself: turning redaction off is about key masking,\n // never about letting a 300 KB base64 field through.\n maxStringLength: resolveMaxStringLength(),\n });\n};\n\n/** Strips credentials from a connection URL's authority section (`user:hunter2@host` -> `user:[REDACTED]@host`) - {@link redactSecrets} matches on KEY names and can't see them there. A value that fails to parse as a URL is returned unchanged. */\nexport const redactUrlCredentials = (url: string): string => {\n if (!isRedactionEnabled()) {\n return url;\n }\n\n let parsed: URL;\n\n try {\n parsed = new URL(url);\n } catch {\n return url;\n }\n\n if (!parsed.password) {\n return url;\n }\n\n parsed.password = REDACTED;\n return decodeURIComponent(parsed.toString());\n};\n"]}
@@ -9,7 +9,7 @@ class BaseHelper {
9
9
  }
10
10
  /** The helper's logger, resolved on first read - a helper that never logs never builds one. */
11
11
  get logger() {
12
- const scopes = [this.scope, this.identifier].filter(scope => typeof scope === 'string' && scope.length > 0);
12
+ const scopes = [this.scope, this.identifier].filter((scope) => typeof scope === 'string' && scope.length > 0);
13
13
  const logger = (0, slot_1.resolveHelperLogger)({ scopes });
14
14
  // Read off a prototype (reflection walks them), pinning would shadow this getter for every instance.
15
15
  if (Object.hasOwn(this, 'scope')) {
@@ -1 +1 @@
1
- {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":";;;AACA,gDAA6E;AAE7E,MAAa,UAAU;IAIrB,YAAY,IAA4C;QACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,+FAA+F;IAC/F,IAAI,MAAM;QACR,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CACjD,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CACvD,CAAC;QACF,MAAM,MAAM,GAAG,IAAA,0BAAmB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/C,qGAAqG;QACrG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YACjC,IAAA,sBAAe,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iGAAiG;IACjG,IAAI,MAAM,CAAC,KAAc;QACvB,IAAA,sBAAe,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAnCD,gCAmCC","sourcesContent":["import { type ILogger } from '@/modules/logger/common/types';\nimport { pinHelperLogger, resolveHelperLogger } from '@/modules/logger/slot';\n\nexport class BaseHelper {\n scope: string;\n identifier: string;\n\n constructor(opts: { scope: string; identifier?: string }) {\n this.scope = opts.scope ?? '';\n this.identifier = opts.identifier ?? '';\n }\n\n /** The helper's logger, resolved on first read - a helper that never logs never builds one. */\n get logger(): ILogger {\n const scopes = [this.scope, this.identifier].filter(\n scope => typeof scope === 'string' && scope.length > 0,\n );\n const logger = resolveHelperLogger({ scopes });\n\n // Read off a prototype (reflection walks them), pinning would shadow this getter for every instance.\n if (Object.hasOwn(this, 'scope')) {\n pinHelperLogger({ helper: this, logger });\n }\n return logger;\n }\n\n /** Installs one logger on this helper - a test spy, or a host overriding the global resolver. */\n set logger(value: ILogger) {\n pinHelperLogger({ helper: this, logger: value });\n }\n\n getIdentifier() {\n return this.identifier;\n }\n\n getLogger(): ILogger {\n return this.logger;\n }\n}\n"]}
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":";;;AACA,gDAA6E;AAE7E,MAAa,UAAU;IAIrB,YAAY,IAA4C;QACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,+FAA+F;IAC/F,IAAI,MAAM;QACR,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CACjD,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CACzD,CAAC;QACF,MAAM,MAAM,GAAG,IAAA,0BAAmB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/C,qGAAqG;QACrG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YACjC,IAAA,sBAAe,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iGAAiG;IACjG,IAAI,MAAM,CAAC,KAAc;QACvB,IAAA,sBAAe,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAnCD,gCAmCC","sourcesContent":["import { type ILogger } from '@/modules/logger/common/types';\nimport { pinHelperLogger, resolveHelperLogger } from '@/modules/logger/slot';\n\nexport class BaseHelper {\n scope: string;\n identifier: string;\n\n constructor(opts: { scope: string; identifier?: string }) {\n this.scope = opts.scope ?? '';\n this.identifier = opts.identifier ?? '';\n }\n\n /** The helper's logger, resolved on first read - a helper that never logs never builds one. */\n get logger(): ILogger {\n const scopes = [this.scope, this.identifier].filter(\n (scope) => typeof scope === 'string' && scope.length > 0,\n );\n const logger = resolveHelperLogger({ scopes });\n\n // Read off a prototype (reflection walks them), pinning would shadow this getter for every instance.\n if (Object.hasOwn(this, 'scope')) {\n pinHelperLogger({ helper: this, logger });\n }\n return logger;\n }\n\n /** Installs one logger on this helper - a test spy, or a host overriding the global resolver. */\n set logger(value: ILogger) {\n pinHelperLogger({ helper: this, logger: value });\n }\n\n getIdentifier() {\n return this.identifier;\n }\n\n getLogger(): ILogger {\n return this.logger;\n }\n}\n"]}
@@ -39,7 +39,7 @@ class AES extends base_algorithm_1.BaseCryptoAlgorithm {
39
39
  if (!Array.isArray(secret)) {
40
40
  return this.normalizeSecretKey({ secret, length, kdfSalt, kdfIterations });
41
41
  }
42
- const entry = secret.find(e => e.id === id);
42
+ const entry = secret.find((e) => e.id === id);
43
43
  if (!entry) {
44
44
  throw (0, error_1.getError)({
45
45
  message: `[AES][resolveDecryptKey] No key in keyring matches ciphertext key id "${id}"`,
@@ -1 +1 @@
1
- {"version":3,"file":"aes.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEmpty } from '@venizia/ignis-inversion';\nimport C from 'node:crypto';\nimport fs from 'node:fs';\nimport { getError } from '@/modules/error';\nimport { BaseCryptoAlgorithm } from './base.algorithm';\n\nconst DEFAULT_LENGTH = 16;\nconst CIPHERTEXT_VERSION = 0x01;\nconst DEFAULT_KEY_ID = '0';\n\ninterface IAESDecryptOptions {\n inputEncoding?: BufferEncoding;\n outputEncoding?: BufferEncoding;\n doThrow?: boolean;\n /** Per-deployment PBKDF2 salt override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */\n kdfSalt?: string;\n /** PBKDF2 iteration count override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */\n kdfIterations?: number;\n}\n\n/** `iv` is encrypt-only: the envelope carries the IV, so decrypt reads it from there and a supplied one would be silently ignored. */\ninterface IAESExtraOptions extends IAESDecryptOptions {\n iv?: Buffer;\n}\n\nexport interface IAESKeyringEntry {\n id: string;\n secret: string;\n}\n\nexport type TAESSecret = string | IAESKeyringEntry[];\n\nexport type AESAlgorithmType = 'aes-256-cbc' | 'aes-256-gcm';\n\nexport class AES extends BaseCryptoAlgorithm<\n AESAlgorithmType,\n string,\n string,\n TAESSecret,\n string,\n string,\n IAESExtraOptions\n> {\n constructor(opts: { algorithm: AESAlgorithmType }) {\n super({ scope: AES.name, ...opts });\n }\n\n static withAlgorithm(algorithm: AESAlgorithmType) {\n return new AES({ algorithm });\n }\n\n protected resolveEncryptKey(opts: {\n secret: TAESSecret;\n kdfSalt?: string;\n kdfIterations?: number;\n }): { id: string; key: Buffer } {\n const { secret, kdfSalt, kdfIterations } = opts;\n const entry = Array.isArray(secret) ? secret[0] : { id: DEFAULT_KEY_ID, secret };\n\n if (!entry || isEmpty({ value: entry.secret })) {\n throw getError({ message: '[AES][resolveEncryptKey] Missing secret or empty keyring' });\n }\n\n const key = this.normalizeSecretKey({\n secret: entry.secret,\n length: this.getAlgorithmKeySize(),\n kdfSalt,\n kdfIterations,\n });\n return { id: entry.id, key };\n }\n\n protected resolveDecryptKey(opts: {\n secret: TAESSecret;\n id: string;\n kdfSalt?: string;\n kdfIterations?: number;\n }): Buffer {\n const { secret, id, kdfSalt, kdfIterations } = opts;\n const length = this.getAlgorithmKeySize();\n\n if (!Array.isArray(secret)) {\n return this.normalizeSecretKey({ secret, length, kdfSalt, kdfIterations });\n }\n\n const entry = secret.find(e => e.id === id);\n if (!entry) {\n throw getError({\n message: `[AES][resolveDecryptKey] No key in keyring matches ciphertext key id \"${id}\"`,\n });\n }\n\n // Without this the empty secret derives a key from '' and fails as an opaque OpenSSL error, hiding a plain configuration mistake.\n if (isEmpty({ value: entry.secret })) {\n throw getError({\n message: `[AES][resolveDecryptKey] Keyring entry for key id \"${id}\" has an empty secret`,\n });\n }\n\n return this.normalizeSecretKey({ secret: entry.secret, length, kdfSalt, kdfIterations });\n }\n\n encrypt(opts: { message: string; secret: TAESSecret; opts?: IAESExtraOptions }) {\n const { message, secret } = opts;\n const {\n iv = C.randomBytes(DEFAULT_LENGTH),\n inputEncoding = 'utf-8',\n outputEncoding = 'base64',\n doThrow = true,\n kdfSalt,\n kdfIterations,\n } = opts.opts ?? {};\n\n try {\n const { id, key } = this.resolveEncryptKey({ secret, kdfSalt, kdfIterations });\n const idBuffer = Buffer.from(id, 'utf-8');\n if (idBuffer.length > 0xff) {\n throw getError({ message: '[AES][encrypt] Key id too long (max 255 bytes)' });\n }\n\n const cipher = C.createCipheriv(this.algorithm, key, iv);\n\n // Envelope: [version(1)][idLen(1)][id(idLen)][iv(16)][authTag(16, gcm only)][cipher]\n const header = Buffer.from([CIPHERTEXT_VERSION, idBuffer.length]);\n const parts = [header, idBuffer, iv];\n\n const cipherText = cipher.update(message, inputEncoding);\n const cipherFinal = cipher.final();\n\n switch (this.algorithm) {\n case 'aes-256-cbc': {\n break;\n }\n case 'aes-256-gcm': {\n parts.push((cipher as C.CipherGCM).getAuthTag());\n break;\n }\n }\n parts.push(cipherText);\n parts.push(cipherFinal);\n\n return Buffer.concat(parts).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n encryptFile(opts: { absolutePath: string; secret: TAESSecret }): string {\n const { absolutePath, secret } = opts;\n\n if (!absolutePath || isEmpty({ value: absolutePath })) {\n return '';\n }\n\n const buffer = fs.readFileSync(absolutePath);\n const fileContent = buffer?.toString('utf-8');\n const encrypted = this.encrypt({ message: fileContent, secret });\n return encrypted;\n }\n\n decrypt(opts: { message: string; secret: TAESSecret; opts?: IAESDecryptOptions }) {\n const { message, secret } = opts;\n const {\n inputEncoding = 'base64',\n outputEncoding = 'utf-8',\n doThrow = true,\n kdfSalt,\n kdfIterations,\n } = opts.opts ?? {};\n\n try {\n const raw = Buffer.from(message, inputEncoding);\n\n const version = raw[0];\n if (version !== CIPHERTEXT_VERSION) {\n throw getError({ message: `[AES][decrypt] Unsupported ciphertext version: ${version}` });\n }\n\n const idLength = raw[1];\n let cursor = 2;\n\n const id = raw.subarray(cursor, cursor + idLength).toString('utf-8');\n cursor += idLength;\n\n const iv = raw.subarray(cursor, cursor + DEFAULT_LENGTH);\n cursor += DEFAULT_LENGTH;\n\n const key = this.resolveDecryptKey({ secret, id, kdfSalt, kdfIterations });\n const decipher = C.createDecipheriv(this.algorithm, key, iv);\n\n switch (this.algorithm) {\n case 'aes-256-cbc': {\n break;\n }\n case 'aes-256-gcm': {\n const authTag = raw.subarray(cursor, cursor + DEFAULT_LENGTH);\n cursor += DEFAULT_LENGTH;\n (decipher as C.DecipherGCM).setAuthTag(authTag);\n break;\n }\n }\n\n const cipherText = raw.subarray(cursor);\n return Buffer.concat([decipher.update(cipherText), decipher.final()]).toString(\n outputEncoding,\n );\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n decryptFile(opts: { absolutePath: string; secret: TAESSecret }) {\n const { absolutePath, secret } = opts;\n\n if (!absolutePath || isEmpty({ value: absolutePath })) {\n return '';\n }\n\n const buffer = fs.readFileSync(absolutePath);\n const fileContent = buffer?.toString('utf-8');\n const decrypted = this.decrypt({ message: fileContent, secret });\n return decrypted;\n }\n}\n"]}
1
+ {"version":3,"file":"aes.algorithm.js","sourceRoot":"","sources":["../../../../../src/modules/crypto/algorithms/aes.algorithm.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEmpty } from '@venizia/ignis-inversion';\nimport C from 'node:crypto';\nimport fs from 'node:fs';\nimport { getError } from '@/modules/error';\nimport { BaseCryptoAlgorithm } from './base.algorithm';\n\nconst DEFAULT_LENGTH = 16;\nconst CIPHERTEXT_VERSION = 0x01;\nconst DEFAULT_KEY_ID = '0';\n\ninterface IAESDecryptOptions {\n inputEncoding?: BufferEncoding;\n outputEncoding?: BufferEncoding;\n doThrow?: boolean;\n /** Per-deployment PBKDF2 salt override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */\n kdfSalt?: string;\n /** PBKDF2 iteration count override. Must be supplied identically on encrypt and decrypt; omit for the shipped default. */\n kdfIterations?: number;\n}\n\n/** `iv` is encrypt-only: the envelope carries the IV, so decrypt reads it from there and a supplied one would be silently ignored. */\ninterface IAESExtraOptions extends IAESDecryptOptions {\n iv?: Buffer;\n}\n\nexport interface IAESKeyringEntry {\n id: string;\n secret: string;\n}\n\nexport type TAESSecret = string | IAESKeyringEntry[];\n\nexport type AESAlgorithmType = 'aes-256-cbc' | 'aes-256-gcm';\n\nexport class AES extends BaseCryptoAlgorithm<\n AESAlgorithmType,\n string,\n string,\n TAESSecret,\n string,\n string,\n IAESExtraOptions\n> {\n constructor(opts: { algorithm: AESAlgorithmType }) {\n super({ scope: AES.name, ...opts });\n }\n\n static withAlgorithm(algorithm: AESAlgorithmType) {\n return new AES({ algorithm });\n }\n\n protected resolveEncryptKey(opts: {\n secret: TAESSecret;\n kdfSalt?: string;\n kdfIterations?: number;\n }): { id: string; key: Buffer } {\n const { secret, kdfSalt, kdfIterations } = opts;\n const entry = Array.isArray(secret) ? secret[0] : { id: DEFAULT_KEY_ID, secret };\n\n if (!entry || isEmpty({ value: entry.secret })) {\n throw getError({ message: '[AES][resolveEncryptKey] Missing secret or empty keyring' });\n }\n\n const key = this.normalizeSecretKey({\n secret: entry.secret,\n length: this.getAlgorithmKeySize(),\n kdfSalt,\n kdfIterations,\n });\n return { id: entry.id, key };\n }\n\n protected resolveDecryptKey(opts: {\n secret: TAESSecret;\n id: string;\n kdfSalt?: string;\n kdfIterations?: number;\n }): Buffer {\n const { secret, id, kdfSalt, kdfIterations } = opts;\n const length = this.getAlgorithmKeySize();\n\n if (!Array.isArray(secret)) {\n return this.normalizeSecretKey({ secret, length, kdfSalt, kdfIterations });\n }\n\n const entry = secret.find((e) => e.id === id);\n if (!entry) {\n throw getError({\n message: `[AES][resolveDecryptKey] No key in keyring matches ciphertext key id \"${id}\"`,\n });\n }\n\n // Without this the empty secret derives a key from '' and fails as an opaque OpenSSL error, hiding a plain configuration mistake.\n if (isEmpty({ value: entry.secret })) {\n throw getError({\n message: `[AES][resolveDecryptKey] Keyring entry for key id \"${id}\" has an empty secret`,\n });\n }\n\n return this.normalizeSecretKey({ secret: entry.secret, length, kdfSalt, kdfIterations });\n }\n\n encrypt(opts: { message: string; secret: TAESSecret; opts?: IAESExtraOptions }) {\n const { message, secret } = opts;\n const {\n iv = C.randomBytes(DEFAULT_LENGTH),\n inputEncoding = 'utf-8',\n outputEncoding = 'base64',\n doThrow = true,\n kdfSalt,\n kdfIterations,\n } = opts.opts ?? {};\n\n try {\n const { id, key } = this.resolveEncryptKey({ secret, kdfSalt, kdfIterations });\n const idBuffer = Buffer.from(id, 'utf-8');\n if (idBuffer.length > 0xff) {\n throw getError({ message: '[AES][encrypt] Key id too long (max 255 bytes)' });\n }\n\n const cipher = C.createCipheriv(this.algorithm, key, iv);\n\n // Envelope: [version(1)][idLen(1)][id(idLen)][iv(16)][authTag(16, gcm only)][cipher]\n const header = Buffer.from([CIPHERTEXT_VERSION, idBuffer.length]);\n const parts = [header, idBuffer, iv];\n\n const cipherText = cipher.update(message, inputEncoding);\n const cipherFinal = cipher.final();\n\n switch (this.algorithm) {\n case 'aes-256-cbc': {\n break;\n }\n case 'aes-256-gcm': {\n parts.push((cipher as C.CipherGCM).getAuthTag());\n break;\n }\n }\n parts.push(cipherText);\n parts.push(cipherFinal);\n\n return Buffer.concat(parts).toString(outputEncoding);\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n encryptFile(opts: { absolutePath: string; secret: TAESSecret }): string {\n const { absolutePath, secret } = opts;\n\n if (!absolutePath || isEmpty({ value: absolutePath })) {\n return '';\n }\n\n const buffer = fs.readFileSync(absolutePath);\n const fileContent = buffer?.toString('utf-8');\n const encrypted = this.encrypt({ message: fileContent, secret });\n return encrypted;\n }\n\n decrypt(opts: { message: string; secret: TAESSecret; opts?: IAESDecryptOptions }) {\n const { message, secret } = opts;\n const {\n inputEncoding = 'base64',\n outputEncoding = 'utf-8',\n doThrow = true,\n kdfSalt,\n kdfIterations,\n } = opts.opts ?? {};\n\n try {\n const raw = Buffer.from(message, inputEncoding);\n\n const version = raw[0];\n if (version !== CIPHERTEXT_VERSION) {\n throw getError({ message: `[AES][decrypt] Unsupported ciphertext version: ${version}` });\n }\n\n const idLength = raw[1];\n let cursor = 2;\n\n const id = raw.subarray(cursor, cursor + idLength).toString('utf-8');\n cursor += idLength;\n\n const iv = raw.subarray(cursor, cursor + DEFAULT_LENGTH);\n cursor += DEFAULT_LENGTH;\n\n const key = this.resolveDecryptKey({ secret, id, kdfSalt, kdfIterations });\n const decipher = C.createDecipheriv(this.algorithm, key, iv);\n\n switch (this.algorithm) {\n case 'aes-256-cbc': {\n break;\n }\n case 'aes-256-gcm': {\n const authTag = raw.subarray(cursor, cursor + DEFAULT_LENGTH);\n cursor += DEFAULT_LENGTH;\n (decipher as C.DecipherGCM).setAuthTag(authTag);\n break;\n }\n }\n\n const cipherText = raw.subarray(cursor);\n return Buffer.concat([decipher.update(cipherText), decipher.final()]).toString(\n outputEncoding,\n );\n } catch (error) {\n if (doThrow) {\n throw error;\n }\n\n return message;\n }\n }\n\n decryptFile(opts: { absolutePath: string; secret: TAESSecret }) {\n const { absolutePath, secret } = opts;\n\n if (!absolutePath || isEmpty({ value: absolutePath })) {\n return '';\n }\n\n const buffer = fs.readFileSync(absolutePath);\n const fileContent = buffer?.toString('utf-8');\n const decrypted = this.decrypt({ message: fileContent, secret });\n return decrypted;\n }\n}\n"]}
@@ -15,7 +15,7 @@ class LoggerFormats {
15
15
  }
16
16
  exports.LoggerFormats = LoggerFormats;
17
17
  // -------------------------------------------------------------
18
- const extraLogEnvs = (process.env.APP_ENV_EXTRA_LOG_ENVS ?? '').split(',').map(el => el.trim());
18
+ const extraLogEnvs = (process.env.APP_ENV_EXTRA_LOG_ENVS ?? '').split(',').map((el) => el.trim());
19
19
  const LOG_ENVIRONMENTS = new Set([...Array.from(env_1.Environment.COMMON_ENVS), ...extraLogEnvs]);
20
20
  /** debug() gate, computed ONCE at module load: DEBUG truthy and NODE_ENV unset or allowlisted. Shared across every logger implementation - runtime env changes need a restart. */
21
21
  const { DEBUG } = process.env;
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/constants.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TConstValue } from '@/common/types';\nimport { Environment } from '@/modules/env';\nimport { toBoolean } from '@/utilities/parse.utility';\nimport { LogLevels, type TLogLevel } from './types';\n\n// -------------------------------------------------------------\nexport class LoggerFormats {\n static readonly JSON = 'json';\n static readonly TEXT = 'text';\n\n static readonly SCHEME_SET = new Set([this.JSON, this.TEXT]);\n\n static isValid(input: string): input is TLoggerFormat {\n return this.SCHEME_SET.has(input);\n }\n}\n\nexport type TLoggerFormat = TConstValue<typeof LoggerFormats>;\n\n// -------------------------------------------------------------\nconst extraLogEnvs = (process.env.APP_ENV_EXTRA_LOG_ENVS ?? '').split(',').map(el => el.trim());\nconst LOG_ENVIRONMENTS = new Set([...Array.from(Environment.COMMON_ENVS), ...extraLogEnvs]);\n\n/** debug() gate, computed ONCE at module load: DEBUG truthy and NODE_ENV unset or allowlisted. Shared across every logger implementation - runtime env changes need a restart. */\nconst { DEBUG } = process.env;\nexport const SHOULD_LOG_DEBUG =\n toBoolean(DEBUG) && (!Environment.ambient || LOG_ENVIRONMENTS.has(Environment.ambient));\n\n/** The logger's own level, below which a line never reaches ANY transport. Defaults to `debug` - level gating belongs to the wrapper and each transport, and a stricter default here would silently drop lines the wrapper already let through. */\nexport const resolveLoggerLevel = (opts: { configured?: string }): TLogLevel => {\n const { configured } = opts;\n\n if (!configured || configured.trim() === '') {\n return LogLevels.DEBUG;\n }\n\n const normalized = configured.trim().toLowerCase();\n if (!LogLevels.isValid(normalized)) {\n // console, not Logger: the logger is being built - routing this warning through it would re-enter the very pipeline that is not configured yet.\n console.warn(\n '[resolveLoggerLevel] Invalid logger level | value: %s | valids: %s | fallback: %s',\n configured,\n [...LogLevels.SCHEME_SET],\n LogLevels.DEBUG,\n );\n return LogLevels.DEBUG;\n }\n\n return normalized as TLogLevel;\n};\n\n/**\n * Whether log lines may carry ANSI color, resolved at CALL time. First match wins:\n *\n * 1. `APP_ENV_LOGGER_COLOR` - an explicit yes or no from the operator.\n * 2. `NO_COLOR`, set to anything non-empty - the no-color.org convention.\n * 3. `NODE_ENV` outside {@link Environment.DEVELOPMENT_ENVS} - production, staging, uat and any\n * unrecognized name. Fail-closed, the same boundary the error sanitizer draws: colors are a\n * terminal affordance, and in a deployed environment the same bytes land in a file or an\n * aggregator as escape noise every grep then has to strip.\n *\n * `undefined` means the framework has no opinion, so a provider that detects a terminal itself\n * keeps deciding - which is why the pino path forwards nothing in that case.\n */\nexport const resolveLoggerColorize = (opts?: {\n configured?: string;\n environment?: string;\n}): boolean | undefined => {\n const configured = opts?.configured ?? process.env.APP_ENV_LOGGER_COLOR;\n if (configured !== undefined && configured.trim() !== '') {\n return toBoolean(configured.trim().toLowerCase());\n }\n\n const noColor = process.env.NO_COLOR;\n if (noColor !== undefined && noColor !== '') {\n return false;\n }\n\n const environment = opts?.environment ?? Environment.current;\n if (!Environment.DEVELOPMENT_ENVS.has(environment)) {\n return false;\n }\n\n return undefined;\n};\n"]}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/constants.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TConstValue } from '@/common/types';\nimport { Environment } from '@/modules/env';\nimport { toBoolean } from '@/utilities/parse.utility';\nimport { LogLevels, type TLogLevel } from './types';\n\n// -------------------------------------------------------------\nexport class LoggerFormats {\n static readonly JSON = 'json';\n static readonly TEXT = 'text';\n\n static readonly SCHEME_SET = new Set([this.JSON, this.TEXT]);\n\n static isValid(input: string): input is TLoggerFormat {\n return this.SCHEME_SET.has(input);\n }\n}\n\nexport type TLoggerFormat = TConstValue<typeof LoggerFormats>;\n\n// -------------------------------------------------------------\nconst extraLogEnvs = (process.env.APP_ENV_EXTRA_LOG_ENVS ?? '').split(',').map((el) => el.trim());\nconst LOG_ENVIRONMENTS = new Set([...Array.from(Environment.COMMON_ENVS), ...extraLogEnvs]);\n\n/** debug() gate, computed ONCE at module load: DEBUG truthy and NODE_ENV unset or allowlisted. Shared across every logger implementation - runtime env changes need a restart. */\nconst { DEBUG } = process.env;\nexport const SHOULD_LOG_DEBUG =\n toBoolean(DEBUG) && (!Environment.ambient || LOG_ENVIRONMENTS.has(Environment.ambient));\n\n/** The logger's own level, below which a line never reaches ANY transport. Defaults to `debug` - level gating belongs to the wrapper and each transport, and a stricter default here would silently drop lines the wrapper already let through. */\nexport const resolveLoggerLevel = (opts: { configured?: string }): TLogLevel => {\n const { configured } = opts;\n\n if (!configured || configured.trim() === '') {\n return LogLevels.DEBUG;\n }\n\n const normalized = configured.trim().toLowerCase();\n if (!LogLevels.isValid(normalized)) {\n // console, not Logger: the logger is being built - routing this warning through it would re-enter the very pipeline that is not configured yet.\n console.warn(\n '[resolveLoggerLevel] Invalid logger level | value: %s | valids: %s | fallback: %s',\n configured,\n [...LogLevels.SCHEME_SET],\n LogLevels.DEBUG,\n );\n return LogLevels.DEBUG;\n }\n\n return normalized as TLogLevel;\n};\n\n/**\n * Whether log lines may carry ANSI color, resolved at CALL time. First match wins:\n *\n * 1. `APP_ENV_LOGGER_COLOR` - an explicit yes or no from the operator.\n * 2. `NO_COLOR`, set to anything non-empty - the no-color.org convention.\n * 3. `NODE_ENV` outside {@link Environment.DEVELOPMENT_ENVS} - production, staging, uat and any\n * unrecognized name. Fail-closed, the same boundary the error sanitizer draws: colors are a\n * terminal affordance, and in a deployed environment the same bytes land in a file or an\n * aggregator as escape noise every grep then has to strip.\n *\n * `undefined` means the framework has no opinion, so a provider that detects a terminal itself\n * keeps deciding - which is why the pino path forwards nothing in that case.\n */\nexport const resolveLoggerColorize = (opts?: {\n configured?: string;\n environment?: string;\n}): boolean | undefined => {\n const configured = opts?.configured ?? process.env.APP_ENV_LOGGER_COLOR;\n if (configured !== undefined && configured.trim() !== '') {\n return toBoolean(configured.trim().toLowerCase());\n }\n\n const noColor = process.env.NO_COLOR;\n if (noColor !== undefined && noColor !== '') {\n return false;\n }\n\n const environment = opts?.environment ?? Environment.current;\n if (!Environment.DEVELOPMENT_ENVS.has(environment)) {\n return false;\n }\n\n return undefined;\n};\n"]}
@@ -102,5 +102,5 @@ exports.ApplicationLogger = {
102
102
  get: (scope) => LoggerFactory.getLogger([scope]),
103
103
  };
104
104
  // Runs whenever LoggerFactory is imported as a value - which core's Container and every application entrypoint already do. This is what makes BaseHelper resolve real loggers on the server while its own import graph stays browser-pure.
105
- resolver_1.LoggerResolver.use({ resolver: opts => LoggerFactory.getLogger(opts.scopes) });
105
+ resolver_1.LoggerResolver.use({ resolver: (opts) => LoggerFactory.getLogger(opts.scopes) });
106
106
  //# sourceMappingURL=factory.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/logger/factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { getError } from '@venizia/ignis-inversion';\nimport { createRequire } from 'node:module';\nimport { AbstractLogger } from './base/abstract';\nimport { type ILogger, type ILoggerProvider, type TLogLevel } from './common/types';\nimport { LoggerResolver } from './resolver';\n\n/** Stable wrapper the factory hands out; the delegate resolves lazily (first log call or `use()`), never at construction, so no provider loads until needed. Mutual reference with LoggerFactory is by design - hence the `no-use-before-define` disables. */\nclass LoggerDelegator extends AbstractLogger {\n private _delegate?: ILogger;\n\n constructor(private readonly scope: string) {\n super();\n }\n\n repoint(provider: ILoggerProvider): void {\n this._delegate = provider.get(this.scope);\n }\n\n private delegate(): ILogger {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return (this._delegate ??= LoggerFactory.currentProvider().get(this.scope));\n }\n\n debug(message: string, ...args: AnyType[]) {\n this.delegate().debug(message, ...args);\n }\n\n info(message: string, ...args: AnyType[]) {\n this.delegate().info(message, ...args);\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.delegate().warn(message, ...args);\n }\n\n error(message: string, ...args: AnyType[]) {\n this.delegate().error(message, ...args);\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.delegate().emerg(message, ...args);\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n this.delegate().log(level, message, ...args);\n }\n\n for(methodName: string): ILogger {\n const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return LoggerFactory.getLogger([childScope]);\n }\n}\n\n/** A bundle can carry two copies of this module - the application's ESM import and core's CJS require. The provider lives in this globalThis slot so `use()` in one copy is seen by the other. */\nconst PROVIDER_SLOT = Symbol.for('ignis:logger-provider');\n\n/** Provider-agnostic acquisition path. Exactly ONE provider is ever loaded - the one registered via `use()`, or the winston default at first unregistered log call. */\nexport class LoggerFactory {\n private static provider?: ILoggerProvider;\n private static cache = new Map<string, LoggerDelegator>();\n\n /** Register the application's provider. Re-points every wrapper issued so far. */\n static use(opts: { provider: ILoggerProvider }): void {\n this.provider = opts.provider;\n Reflect.set(globalThis, PROVIDER_SLOT, opts.provider);\n const cacheValues = this.cache.values();\n for (const wrapper of cacheValues) {\n wrapper.repoint(opts.provider);\n }\n }\n\n static currentProvider(): ILoggerProvider {\n if (!this.provider) {\n this.provider = this.sharedProvider() ?? this.loadDefaultProvider();\n Reflect.set(globalThis, PROVIDER_SLOT, this.provider);\n }\n\n return this.provider;\n }\n\n /** The provider another copy of this module registered, if any. */\n private static sharedProvider(): ILoggerProvider | undefined {\n const shared: ILoggerProvider | undefined = Reflect.get(globalThis, PROVIDER_SLOT);\n return shared;\n }\n\n // winston is an optional peer; compiled binaries must register a provider explicitly because only a class reference carries a provider into a bundle.\n private static loadDefaultProvider(): ILoggerProvider {\n try {\n return createRequire(__filename)('./winston').WinstonLogger;\n } catch (error) {\n throw getError({\n message: [\n '[LoggerFactory] No logger provider is registered and the default (winston) could not be loaded.',\n 'Either install it: `bun add winston winston-transport winston-daily-rotate-file`,',\n 'or register a provider at your entrypoint: `LoggerFactory.use({ provider })` with a class',\n \"from '@venizia/ignis-helpers/winston' or '@venizia/ignis-helpers/pino'.\",\n 'Compiled binaries (bun build --compile) MUST register explicitly.',\n `Cause: ${error instanceof Error ? error.message : String(error)}`,\n ].join(' '),\n });\n }\n }\n\n static getLogger(scopes: string[]): ILogger {\n const scope = scopes.join('-');\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new LoggerDelegator(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n}\n\n/** Provider-following facade: always resolves through the registered provider. */\nexport const ApplicationLogger = {\n get: (scope: string): ILogger => LoggerFactory.getLogger([scope]),\n};\n\n// Runs whenever LoggerFactory is imported as a value - which core's Container and every application entrypoint already do. This is what makes BaseHelper resolve real loggers on the server while its own import graph stays browser-pure.\nLoggerResolver.use({ resolver: opts => LoggerFactory.getLogger(opts.scopes) });\n"]}
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/logger/factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { getError } from '@venizia/ignis-inversion';\nimport { createRequire } from 'node:module';\nimport { AbstractLogger } from './base/abstract';\nimport { type ILogger, type ILoggerProvider, type TLogLevel } from './common/types';\nimport { LoggerResolver } from './resolver';\n\n/** Stable wrapper the factory hands out; the delegate resolves lazily (first log call or `use()`), never at construction, so no provider loads until needed. Mutual reference with LoggerFactory is by design - hence the `no-use-before-define` disables. */\nclass LoggerDelegator extends AbstractLogger {\n private _delegate?: ILogger;\n\n constructor(private readonly scope: string) {\n super();\n }\n\n repoint(provider: ILoggerProvider): void {\n this._delegate = provider.get(this.scope);\n }\n\n private delegate(): ILogger {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return (this._delegate ??= LoggerFactory.currentProvider().get(this.scope));\n }\n\n debug(message: string, ...args: AnyType[]) {\n this.delegate().debug(message, ...args);\n }\n\n info(message: string, ...args: AnyType[]) {\n this.delegate().info(message, ...args);\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.delegate().warn(message, ...args);\n }\n\n error(message: string, ...args: AnyType[]) {\n this.delegate().error(message, ...args);\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.delegate().emerg(message, ...args);\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n this.delegate().log(level, message, ...args);\n }\n\n for(methodName: string): ILogger {\n const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return LoggerFactory.getLogger([childScope]);\n }\n}\n\n/** A bundle can carry two copies of this module - the application's ESM import and core's CJS require. The provider lives in this globalThis slot so `use()` in one copy is seen by the other. */\nconst PROVIDER_SLOT = Symbol.for('ignis:logger-provider');\n\n/** Provider-agnostic acquisition path. Exactly ONE provider is ever loaded - the one registered via `use()`, or the winston default at first unregistered log call. */\nexport class LoggerFactory {\n private static provider?: ILoggerProvider;\n private static cache = new Map<string, LoggerDelegator>();\n\n /** Register the application's provider. Re-points every wrapper issued so far. */\n static use(opts: { provider: ILoggerProvider }): void {\n this.provider = opts.provider;\n Reflect.set(globalThis, PROVIDER_SLOT, opts.provider);\n const cacheValues = this.cache.values();\n for (const wrapper of cacheValues) {\n wrapper.repoint(opts.provider);\n }\n }\n\n static currentProvider(): ILoggerProvider {\n if (!this.provider) {\n this.provider = this.sharedProvider() ?? this.loadDefaultProvider();\n Reflect.set(globalThis, PROVIDER_SLOT, this.provider);\n }\n\n return this.provider;\n }\n\n /** The provider another copy of this module registered, if any. */\n private static sharedProvider(): ILoggerProvider | undefined {\n const shared: ILoggerProvider | undefined = Reflect.get(globalThis, PROVIDER_SLOT);\n return shared;\n }\n\n // winston is an optional peer; compiled binaries must register a provider explicitly because only a class reference carries a provider into a bundle.\n private static loadDefaultProvider(): ILoggerProvider {\n try {\n return createRequire(__filename)('./winston').WinstonLogger;\n } catch (error) {\n throw getError({\n message: [\n '[LoggerFactory] No logger provider is registered and the default (winston) could not be loaded.',\n 'Either install it: `bun add winston winston-transport winston-daily-rotate-file`,',\n 'or register a provider at your entrypoint: `LoggerFactory.use({ provider })` with a class',\n \"from '@venizia/ignis-helpers/winston' or '@venizia/ignis-helpers/pino'.\",\n 'Compiled binaries (bun build --compile) MUST register explicitly.',\n `Cause: ${error instanceof Error ? error.message : String(error)}`,\n ].join(' '),\n });\n }\n }\n\n static getLogger(scopes: string[]): ILogger {\n const scope = scopes.join('-');\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new LoggerDelegator(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n}\n\n/** Provider-following facade: always resolves through the registered provider. */\nexport const ApplicationLogger = {\n get: (scope: string): ILogger => LoggerFactory.getLogger([scope]),\n};\n\n// Runs whenever LoggerFactory is imported as a value - which core's Container and every application entrypoint already do. This is what makes BaseHelper resolve real loggers on the server while its own import graph stays browser-pure.\nLoggerResolver.use({ resolver: (opts) => LoggerFactory.getLogger(opts.scopes) });\n"]}
@@ -35,7 +35,7 @@ const buildInspectOptions = () => {
35
35
  /** Formats like `util.format`, but `%s` inspects to configured depth instead of Node's hard-coded `depth: 0` (no inspect option overrides that), and `%j` is projected into a JSON-safe shape first. Per-placeholder only - handing `%j` the widened STRING would emit a JSON-quoted inspect dump instead of an object. */
36
36
  const formatLogMessage = (opts) => {
37
37
  const { message, args, inspectOptions = buildInspectOptions() } = opts;
38
- const placeholders = (message.match(PLACEHOLDER_PATTERN) ?? []).filter(token => token !== '%%');
38
+ const placeholders = (message.match(PLACEHOLDER_PATTERN) ?? []).filter((token) => token !== '%%');
39
39
  const widened = args.map((arg, index) => {
40
40
  const placeholder = placeholders[index];
41
41
  const isInspectable = typeof arg === 'object' && arg !== null;
@@ -1 +1 @@
1
- {"version":3,"file":"deep-splat.js","sourceRoot":"","sources":["../../../../../src/modules/logger/formatting/deep-splat.ts"],"names":[],"mappings":"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","sourcesContent":["import { redactSecrets, toJsonSafe } from '@/common/redact';\nimport util from 'node:util';\nimport { ErrorPrettier } from './error-prettier';\n\n/** The placeholders `util.format` understands. `%%` is an escape, not a placeholder. */\nconst PLACEHOLDER_PATTERN = /%[sjdifoOc%]/g;\n\n/** How deep an object is inspected before it collapses to `[Object]`: Node's default of 2 hides nested data (e.g. wrapped `cause`), 5 reaches it while staying bounded. `APP_ENV_LOGGER_INSPECT_DEPTH` overrides with a NON-NEGATIVE number - no unlimited setting. */\nconst DEFAULT_INSPECT_DEPTH = 5;\n\nconst resolveDepth = (): number => {\n const configured = process.env.APP_ENV_LOGGER_INSPECT_DEPTH;\n\n // Not `int()`: it answers 0 for an ABSENT value, which would silently mean \"depth 0\" - the one setting that hides everything.\n if (configured === undefined || configured.trim() === '') {\n return DEFAULT_INSPECT_DEPTH;\n }\n\n const parsed = Number.parseInt(configured, 10);\n\n // A negative or unparseable value is a misconfiguration, not a request: fall back rather than hand `util.inspect` a depth it reads as \"unlimited\".\n if (Number.isNaN(parsed) || parsed < 0) {\n return DEFAULT_INSPECT_DEPTH;\n }\n\n return parsed;\n};\n\nconst buildInspectOptions = (): util.InspectOptions => {\n return {\n depth: resolveDepth(),\n maxArrayLength: null,\n maxStringLength: null,\n breakLength: Infinity,\n };\n};\n\n/** Formats like `util.format`, but `%s` inspects to configured depth instead of Node's hard-coded `depth: 0` (no inspect option overrides that), and `%j` is projected into a JSON-safe shape first. Per-placeholder only - handing `%j` the widened STRING would emit a JSON-quoted inspect dump instead of an object. */\nexport const formatLogMessage = (opts: {\n message: string;\n args: Array<unknown>;\n inspectOptions?: util.InspectOptions;\n}): string => {\n const { message, args, inspectOptions = buildInspectOptions() } = opts;\n\n const placeholders = (message.match(PLACEHOLDER_PATTERN) ?? []).filter(token => token !== '%%');\n\n const widened = args.map((arg, index) => {\n const placeholder = placeholders[index];\n const isInspectable = typeof arg === 'object' && arg !== null;\n\n if (!isInspectable) {\n return arg;\n }\n\n // `%j` runs JSON.stringify, which answers `[Circular]` for the WHOLE argument when one cycle sits anywhere inside it - a transaction handle in the payload wipes out every other field. It also has no notion of secret keys, and no depth limit of its own. Project the value first, under the same depth cap `%s` gets.\n if (placeholder === '%j') {\n return toJsonSafe({ value: arg, depth: inspectOptions.depth ?? resolveDepth() });\n }\n\n // `%o`, `%O` and arguments with NO placeholder (`util.format` appends those) are redacted but\n // left as objects, so `util.formatWithOptions` still renders them the way that placeholder\n // means. Pre-inspecting them into a string here would make `%o` print a quoted, escaped string\n // instead of an object. Only the redaction is added; the rendering is unchanged.\n //\n // Before this, `logger.info('login failed', { password })` printed the password verbatim: the\n // redactor only ever saw `%s`, while the reference docs recommend `%o` for data objects.\n //\n // Bounded like the `%s` path below, and for the same reason: an unbounded walk on a very deep\n // graph is work whose result the renderer discards, and deep enough it is a `RangeError` on a\n // call that could not throw before. `%o` renders at `depth`, so `+2` covers what is shown.\n if (placeholder === undefined || placeholder === '%o' || placeholder === '%O') {\n return redactSecrets(arg, undefined, (inspectOptions.depth ?? resolveDepth()) + 2);\n }\n\n if (placeholder !== '%s') {\n return arg;\n }\n\n // Inspecting an Error dumps every own property - a `jose` failure carries the whole JWT payload, a driver failure the whole query. Project it instead, onto its own line so it never trails off the end of the caller's sentence.\n if (arg instanceof Error) {\n return `\\n${ErrorPrettier.format({ error: arg, inspectOptions })}`;\n }\n\n // Bounded to just past what `util.inspect` will actually render. `+2`, not `+1`: at exactly\n // `depth + 1` the redactor replaces the last level with a string, and inspect then prints a\n // QUOTED `'[Object]'` instead of its own bare `[Object]`.\n return util.inspect(\n redactSecrets(arg, undefined, (inspectOptions.depth ?? resolveDepth()) + 2),\n inspectOptions,\n );\n });\n\n return util.formatWithOptions(inspectOptions, message, ...widened);\n};\n"]}
1
+ {"version":3,"file":"deep-splat.js","sourceRoot":"","sources":["../../../../../src/modules/logger/formatting/deep-splat.ts"],"names":[],"mappings":"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","sourcesContent":["import { redactSecrets, toJsonSafe } from '@/common/redact';\nimport util from 'node:util';\nimport { ErrorPrettier } from './error-prettier';\n\n/** The placeholders `util.format` understands. `%%` is an escape, not a placeholder. */\nconst PLACEHOLDER_PATTERN = /%[sjdifoOc%]/g;\n\n/** How deep an object is inspected before it collapses to `[Object]`: Node's default of 2 hides nested data (e.g. wrapped `cause`), 5 reaches it while staying bounded. `APP_ENV_LOGGER_INSPECT_DEPTH` overrides with a NON-NEGATIVE number - no unlimited setting. */\nconst DEFAULT_INSPECT_DEPTH = 5;\n\nconst resolveDepth = (): number => {\n const configured = process.env.APP_ENV_LOGGER_INSPECT_DEPTH;\n\n // Not `int()`: it answers 0 for an ABSENT value, which would silently mean \"depth 0\" - the one setting that hides everything.\n if (configured === undefined || configured.trim() === '') {\n return DEFAULT_INSPECT_DEPTH;\n }\n\n const parsed = Number.parseInt(configured, 10);\n\n // A negative or unparseable value is a misconfiguration, not a request: fall back rather than hand `util.inspect` a depth it reads as \"unlimited\".\n if (Number.isNaN(parsed) || parsed < 0) {\n return DEFAULT_INSPECT_DEPTH;\n }\n\n return parsed;\n};\n\nconst buildInspectOptions = (): util.InspectOptions => {\n return {\n depth: resolveDepth(),\n maxArrayLength: null,\n maxStringLength: null,\n breakLength: Infinity,\n };\n};\n\n/** Formats like `util.format`, but `%s` inspects to configured depth instead of Node's hard-coded `depth: 0` (no inspect option overrides that), and `%j` is projected into a JSON-safe shape first. Per-placeholder only - handing `%j` the widened STRING would emit a JSON-quoted inspect dump instead of an object. */\nexport const formatLogMessage = (opts: {\n message: string;\n args: Array<unknown>;\n inspectOptions?: util.InspectOptions;\n}): string => {\n const { message, args, inspectOptions = buildInspectOptions() } = opts;\n\n const placeholders = (message.match(PLACEHOLDER_PATTERN) ?? []).filter((token) => token !== '%%');\n\n const widened = args.map((arg, index) => {\n const placeholder = placeholders[index];\n const isInspectable = typeof arg === 'object' && arg !== null;\n\n if (!isInspectable) {\n return arg;\n }\n\n // `%j` runs JSON.stringify, which answers `[Circular]` for the WHOLE argument when one cycle sits anywhere inside it - a transaction handle in the payload wipes out every other field. It also has no notion of secret keys, and no depth limit of its own. Project the value first, under the same depth cap `%s` gets.\n if (placeholder === '%j') {\n return toJsonSafe({ value: arg, depth: inspectOptions.depth ?? resolveDepth() });\n }\n\n // `%o`, `%O` and arguments with NO placeholder (`util.format` appends those) are redacted but\n // left as objects, so `util.formatWithOptions` still renders them the way that placeholder\n // means. Pre-inspecting them into a string here would make `%o` print a quoted, escaped string\n // instead of an object. Only the redaction is added; the rendering is unchanged.\n //\n // Before this, `logger.info('login failed', { password })` printed the password verbatim: the\n // redactor only ever saw `%s`, while the reference docs recommend `%o` for data objects.\n //\n // Bounded like the `%s` path below, and for the same reason: an unbounded walk on a very deep\n // graph is work whose result the renderer discards, and deep enough it is a `RangeError` on a\n // call that could not throw before. `%o` renders at `depth`, so `+2` covers what is shown.\n if (placeholder === undefined || placeholder === '%o' || placeholder === '%O') {\n return redactSecrets(arg, undefined, (inspectOptions.depth ?? resolveDepth()) + 2);\n }\n\n if (placeholder !== '%s') {\n return arg;\n }\n\n // Inspecting an Error dumps every own property - a `jose` failure carries the whole JWT payload, a driver failure the whole query. Project it instead, onto its own line so it never trails off the end of the caller's sentence.\n if (arg instanceof Error) {\n return `\\n${ErrorPrettier.format({ error: arg, inspectOptions })}`;\n }\n\n // Bounded to just past what `util.inspect` will actually render. `+2`, not `+1`: at exactly\n // `depth + 1` the redactor replaces the last level with a string, and inspect then prints a\n // QUOTED `'[Object]'` instead of its own bare `[Object]`.\n return util.inspect(\n redactSecrets(arg, undefined, (inspectOptions.depth ?? resolveDepth()) + 2),\n inspectOptions,\n );\n });\n\n return util.formatWithOptions(inspectOptions, message, ...widened);\n};\n"]}
@@ -85,7 +85,7 @@ class ErrorPrettier {
85
85
  if (!Array.isArray(issues) || issues.length === 0) {
86
86
  return message;
87
87
  }
88
- const lines = issues.slice(0, this.MAX_ZOD_ISSUES).map(issue => {
88
+ const lines = issues.slice(0, this.MAX_ZOD_ISSUES).map((issue) => {
89
89
  const entry = issue;
90
90
  const path = Array.isArray(entry.path) && entry.path.length > 0 ? entry.path.join('.') : '(root)';
91
91
  return `${path}: ${entry.message ?? entry.code ?? 'invalid'}`;
@@ -163,7 +163,7 @@ class ErrorPrettier {
163
163
  }
164
164
  // A protocol client reports one member per thing that failed; the wrapper carries only a generic sentence.
165
165
  if (Array.isArray(source.errors) && source.errors.length > 0 && depthLeft > 0) {
166
- const members = source.errors.slice(0, this.MAX_AGGREGATED_ERRORS).map(member => this.summarizeNode({
166
+ const members = source.errors.slice(0, this.MAX_AGGREGATED_ERRORS).map((member) => this.summarizeNode({
167
167
  value: member,
168
168
  depthLeft: depthLeft - 1,
169
169
  seen,
@@ -274,7 +274,7 @@ class ErrorPrettier {
274
274
  }
275
275
  // An ARRAY, not the newline-joined string `text` prints: a monitor can count and slice frames.
276
276
  if (summary.stack !== undefined) {
277
- payload.stack = summary.stack.split('\n').map(frame => frame.trim());
277
+ payload.stack = summary.stack.split('\n').map((frame) => frame.trim());
278
278
  }
279
279
  return this.safeStringify(payload);
280
280
  }
@@ -320,7 +320,7 @@ class ErrorPrettier {
320
320
  if (summary.stack !== undefined) {
321
321
  lines.push(`stack:\n${summary.stack}`);
322
322
  }
323
- return lines.map(line => `- ${line}`).join('\n');
323
+ return lines.map((line) => `- ${line}`).join('\n');
324
324
  }
325
325
  /** Renders {@link summarize}. `text` returns a block whose newlines survive `%s`; `json` returns one line. */
326
326
  static format(opts) {
@@ -1 +1 @@
1
- {"version":3,"file":"error-prettier.js","sourceRoot":"","sources":["../../../../../src/modules/logger/formatting/error-prettier.ts"],"names":[],"mappings":"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","sourcesContent":["import { redactSecrets } from '@/common/redact';\nimport { MessageCode } from '@/modules/error';\nimport util from 'node:util';\nimport { LoggerFormats, type TLoggerFormat } from '../common';\n\n/** Useful-only projection of an error: a driver's `query`/`params` repeat the message and are dropped. */\nexport interface IErrorSummary {\n name?: string;\n message?: string;\n /** The error's OWN code - a driver's `23505`, a gRPC `14`. Belongs with the name, not with the message. */\n code?: string | number;\n /** An `ApplicationError`'s `normalized.code` - the identifier an application filters on. `MessageCode.DEFAULT` never surfaces. */\n messageCode?: string;\n /** Frames ONLY - V8's `Error: <message>` header is stripped so the message is not repeated. */\n stack?: string;\n hint?: string;\n detail?: string;\n table?: string;\n constraint?: string;\n /** Values for the `%{placeholder}` tokens left unresolved in `message` - i18n resolves them downstream, so the log must carry them or the message names no field. */\n args?: Record<string, unknown>;\n /** An `ApplicationError`'s caller context - the one unmodelled payload worth keeping. */\n extra?: Record<string, unknown>;\n cause?: IErrorSummary;\n /** Every reason an `AggregateError` collected. Its own message names none of them, so without this the log says only that something failed. */\n errors?: Array<IErrorSummary>;\n}\n\n/** Turns a thrown value into something a human can read in a console - log this, never the raw error. */\nexport class ErrorPrettier {\n /** Bounds a pathological or cyclic `cause` chain. */\n static readonly DEFAULT_MAX_CAUSE_DEPTH = 5;\n\n /** The throw site is near the top; the tail is identical framework plumbing for every request. */\n static readonly DEFAULT_MAX_STACK_FRAMES = 10;\n\n /** Driver diagnostics that are actionable and absent from `message` - `pg` supplies all four. */\n private static readonly DIAGNOSTIC_KEYS = ['hint', 'detail', 'table', 'constraint'] as const;\n\n /** A stack frame line in every V8 stack: ` at fn (file:line:col)`. */\n private static readonly FRAME_PATTERN = /^\\s+at /;\n\n /** A frame inside an installed package - `node_modules/` covers bun's `.bun/` store too. */\n private static readonly DEPENDENCY_FRAME_PATTERN = /node_modules[/\\\\]/;\n\n /** `getError` sits on top of every `ApplicationError` stack and names no call site. Installed, it is also the FIRST dependency frame, so the keep-the-first rule would preserve exactly the wrong one. Anchored on `inversion` so an application's own `modules/error/app-error` is not swallowed with it. */\n private static readonly ERROR_FACTORY_FRAME_PATTERN =\n /inversion[/\\\\].*modules[/\\\\]error[/\\\\]app-error/;\n\n /** Issues rendered from a ZodError before the rest are counted off. */\n private static readonly MAX_ZOD_ISSUES = 10;\n\n /** Members of an `AggregateError` rendered before the rest are counted off. */\n private static readonly MAX_AGGREGATED_ERRORS = 10;\n\n private static readonly INSPECT_OPTIONS: util.InspectOptions = {\n depth: 5,\n maxArrayLength: null,\n maxStringLength: null,\n breakLength: Infinity,\n };\n\n private static extractFrames(opts: { stack: unknown; maxFrames: number }): string | undefined {\n const { stack, maxFrames } = opts;\n\n if (typeof stack !== 'string') {\n return undefined;\n }\n\n const frames: Array<string> = [];\n let keptDependencyFrame = false;\n let omitted = 0;\n\n // Hand-rolled over split+filter+slice: it stops at maxFrames instead of walking the whole stack.\n const lines = stack.split('\\n');\n for (const line of lines) {\n if (!this.FRAME_PATTERN.test(line)) {\n continue;\n }\n\n // Not counted as omitted: a factory frame is noise, and reporting it would imply signal was dropped.\n if (this.ERROR_FACTORY_FRAME_PATTERN.test(line)) {\n continue;\n }\n\n // The FIRST dependency frame is often the throw site (drizzle, jose); every later one is plumbing.\n const isDependencyFrame = this.DEPENDENCY_FRAME_PATTERN.test(line);\n\n if (isDependencyFrame && keptDependencyFrame) {\n omitted += 1;\n continue;\n }\n\n keptDependencyFrame = keptDependencyFrame || isDependencyFrame;\n frames.push(line);\n\n if (frames.length === maxFrames) {\n break;\n }\n }\n\n // Emit nothing rather than the header, which would repeat the message.\n if (frames.length === 0) {\n return undefined;\n }\n\n // Never truncate silently - a reader must know frames are missing, not assume the stack ended.\n return omitted > 0\n ? `${frames.join('\\n')}\\n ... ${omitted} dependency frames`\n : frames.join('\\n');\n }\n\n /** A ZodError's `message` is its issue array as pretty JSON - dozens of lines for one bad field. Render `path: reason` instead. */\n private static compressZodMessage(opts: { message: string }): string {\n const { message } = opts;\n\n let issues: unknown;\n\n try {\n issues = JSON.parse(message);\n } catch {\n // Not the JSON form (an already-formatted or hand-built ZodError) - leave it alone.\n return message;\n }\n\n if (!Array.isArray(issues) || issues.length === 0) {\n return message;\n }\n\n const lines = issues.slice(0, this.MAX_ZOD_ISSUES).map(issue => {\n const entry = issue as { path?: Array<string | number>; message?: string; code?: string };\n const path =\n Array.isArray(entry.path) && entry.path.length > 0 ? entry.path.join('.') : '(root)';\n\n return `${path}: ${entry.message ?? entry.code ?? 'invalid'}`;\n });\n\n const remaining = issues.length - lines.length;\n\n return remaining > 0 ? `${lines.join('\\n')}\\n... and ${remaining} more` : lines.join('\\n');\n }\n\n private static summarizeNode(opts: {\n value: unknown;\n depthLeft: number;\n seen: WeakSet<object>;\n isRoot: boolean;\n includeStack: boolean;\n maxStackFrames: number;\n }): IErrorSummary {\n const { value, depthLeft, seen, isRoot, includeStack, maxStackFrames } = opts;\n\n // A primitive - a string thrown as `cause`, a numeric code - is its own message.\n if (typeof value !== 'object' || value === null) {\n return { message: String(value) };\n }\n\n if (seen.has(value)) {\n return { message: '[Circular]' };\n }\n seen.add(value);\n\n const source = value as Record<string, unknown>;\n const summary: IErrorSummary = {};\n\n if (typeof source.name === 'string') {\n summary.name = source.name;\n }\n\n if (typeof source.message === 'string') {\n summary.message =\n source.name === 'ZodError'\n ? this.compressZodMessage({ message: source.message })\n : source.message;\n }\n\n if (typeof source.code === 'string' || typeof source.code === 'number') {\n summary.code = source.code;\n }\n\n const normalized =\n typeof source.normalized === 'object' && source.normalized !== null\n ? (source.normalized as { code?: unknown; args?: unknown })\n : undefined;\n\n // `MessageCode.resolve` stamps DEFAULT on every codeless error, so surfacing it blindly would put a meaningless line on every log.\n if (typeof normalized?.code === 'string' && normalized.code !== MessageCode.DEFAULT) {\n summary.messageCode = normalized.code;\n }\n\n // Root only: a cause's frames point into the same libraries and add no location the root lacks.\n if (isRoot && includeStack) {\n const frames = this.extractFrames({ stack: source.stack, maxFrames: maxStackFrames });\n if (frames !== undefined) {\n summary.stack = frames;\n }\n }\n\n for (const key of this.DIAGNOSTIC_KEYS) {\n const diagnostic = source[key];\n if (typeof diagnostic === 'string' && diagnostic.length > 0) {\n summary[key] = diagnostic;\n }\n }\n\n // Root only: the args fill the ROOT's message; a cause's belong to a message this block does not print.\n if (isRoot && typeof normalized?.args === 'object' && normalized.args !== null) {\n const args = normalized.args as Record<string, unknown>;\n if (Object.keys(args).length > 0) {\n summary.args = args;\n }\n }\n\n // Root only: `extra` is what a throw site deliberately attached, so a direct log call keeps it.\n if (isRoot && typeof source.extra === 'object' && source.extra !== null) {\n const extra = source.extra as Record<string, unknown>;\n if (Object.keys(extra).length > 0) {\n summary.extra = extra;\n }\n }\n\n if (source.cause !== undefined && source.cause !== null && depthLeft > 0) {\n summary.cause = this.summarizeNode({\n value: source.cause,\n depthLeft: depthLeft - 1,\n seen,\n isRoot: false,\n includeStack,\n maxStackFrames,\n });\n }\n\n // A protocol client reports one member per thing that failed; the wrapper carries only a generic sentence.\n if (Array.isArray(source.errors) && source.errors.length > 0 && depthLeft > 0) {\n const members = source.errors.slice(0, this.MAX_AGGREGATED_ERRORS).map(member =>\n this.summarizeNode({\n value: member,\n depthLeft: depthLeft - 1,\n seen,\n isRoot: false,\n includeStack,\n maxStackFrames,\n }),\n );\n\n const remaining = source.errors.length - members.length;\n if (remaining > 0) {\n members.push({ message: `... and ${remaining} more` });\n }\n\n summary.errors = members;\n }\n\n // Nothing recognizable: inspect it (redacted) so an unmodelled shape still reaches the log.\n if (Object.keys(summary).length === 0) {\n return { message: util.inspect(redactSecrets(value), this.INSPECT_OPTIONS) };\n }\n\n return summary;\n }\n\n private static pushDiagnostics(opts: { node: IErrorSummary; lines: Array<string> }): void {\n const { node, lines } = opts;\n\n for (const key of this.DIAGNOSTIC_KEYS) {\n const diagnostic = node[key];\n if (diagnostic !== undefined) {\n lines.push(`${key}: ${diagnostic}`);\n }\n }\n }\n\n /** Under whichever node collected them - a wrapped `AggregateError` is the common shape. */\n private static pushAggregatedErrors(opts: { node: IErrorSummary; lines: Array<string> }): void {\n const { node, lines } = opts;\n\n node.errors?.forEach((member, index) => {\n const memberCode = member.code ?? member.messageCode;\n const code = memberCode === undefined ? '' : ` (code ${memberCode})`;\n lines.push(`errors[${index}]: ${member.message ?? ''}${code}`);\n this.pushDiagnostics({ node: member, lines });\n });\n }\n\n /** Reduces any thrown value to {@link IErrorSummary} - always a summary, never a bare primitive. */\n static summarize(opts: {\n error: unknown;\n includeStack?: boolean;\n maxCauseDepth?: number;\n maxStackFrames?: number;\n }): IErrorSummary {\n const {\n error,\n includeStack = true,\n maxCauseDepth = this.DEFAULT_MAX_CAUSE_DEPTH,\n maxStackFrames = this.DEFAULT_MAX_STACK_FRAMES,\n } = opts;\n\n return this.summarizeNode({\n value: error,\n depthLeft: maxCauseDepth,\n seen: new WeakSet(),\n isRoot: true,\n includeStack,\n maxStackFrames,\n });\n }\n\n /** Resolved per call, not at module load, so a test passes a value instead of mutating the environment. */\n private static resolveFormat(configured?: TLoggerFormat): TLoggerFormat {\n if (configured !== undefined) {\n return configured;\n }\n\n const fromEnv = process.env.APP_ENV_LOGGER_FORMAT;\n\n return fromEnv !== undefined && LoggerFormats.isValid(fromEnv) ? fromEnv : LoggerFormats.TEXT;\n }\n\n /** `JSON.stringify` throws on a cycle, and `format` runs inside the error handler - a throw there turns a handled failure into an unhandled one. `redactSecrets` breaks cycles on its own, but it is switched off by `APP_ENV_LOGGER_DO_REDACT=false`, so structural safety cannot lean on it. A repeated reference reads as `[Circular]` too: the first occurrence still carries the data. */\n private static safeStringify(payload: Record<string, unknown>): string {\n const seen = new WeakSet<object>();\n\n return JSON.stringify(payload, (_key, value: unknown) => {\n if (typeof value !== 'object' || value === null) {\n return value;\n }\n\n if (seen.has(value)) {\n return '[Circular]';\n }\n\n seen.add(value);\n return value;\n });\n }\n\n /** One line, so a log monitor keeps the error as ONE record instead of one per bullet. */\n private static renderJson(opts: {\n summary: IErrorSummary;\n messageCode?: string;\n extra?: Record<string, unknown>;\n }): string {\n const { summary, messageCode, extra } = opts;\n\n const payload: Record<string, unknown> = {};\n\n if (summary.message !== undefined) {\n payload.message = summary.message;\n }\n\n if (summary.args !== undefined) {\n payload.args = redactSecrets(summary.args);\n }\n\n // An ApplicationError has no own `code` and a driver error has no `normalized`, so one field never hides the other.\n const code =\n messageCode !== undefined && messageCode !== ''\n ? messageCode\n : (summary.messageCode ?? summary.code);\n if (code !== undefined) {\n payload.code = code;\n }\n\n // A bare `Error` says nothing; the text block drops it for the same reason.\n if (summary.name !== undefined && summary.name !== 'Error') {\n payload.name = summary.name;\n }\n\n for (const key of this.DIAGNOSTIC_KEYS) {\n if (summary[key] !== undefined) {\n payload[key] = summary[key];\n }\n }\n\n const context = extra ?? summary.extra;\n if (context !== undefined && Object.keys(context).length > 0) {\n payload.extra = redactSecrets(context);\n }\n\n if (summary.cause !== undefined) {\n payload.cause = summary.cause;\n }\n\n if (summary.errors !== undefined) {\n payload.errors = summary.errors;\n }\n\n // An ARRAY, not the newline-joined string `text` prints: a monitor can count and slice frames.\n if (summary.stack !== undefined) {\n payload.stack = summary.stack.split('\\n').map(frame => frame.trim());\n }\n\n return this.safeStringify(payload);\n }\n\n private static renderText(opts: {\n summary: IErrorSummary;\n messageCode?: string;\n extra?: Record<string, unknown>;\n inspectOptions: util.InspectOptions;\n }): string {\n const { summary, messageCode, extra, inspectOptions } = opts;\n\n const lines: Array<string> = [];\n\n // What happened, then why, then who/where - a reader stops as soon as they have the answer.\n if (summary.message !== undefined) {\n lines.push(`message: ${summary.message}`);\n }\n\n // Straight after the message: the reader is looking at `%{field}` and needs the value now, not below the stack.\n if (summary.args !== undefined) {\n lines.push(`args: ${util.inspect(redactSecrets(summary.args), inspectOptions)}`);\n }\n\n this.pushAggregatedErrors({ node: summary, lines });\n\n let cause = summary.cause;\n while (cause !== undefined) {\n const causeCode = cause.code ?? cause.messageCode;\n const code = causeCode === undefined ? '' : ` (code ${causeCode})`;\n lines.push(`cause: ${cause.message ?? ''}${code}`);\n this.pushDiagnostics({ node: cause, lines });\n this.pushAggregatedErrors({ node: cause, lines });\n cause = cause.cause;\n }\n\n const identity = [summary.name, summary.code === undefined ? '' : `(code ${summary.code})`]\n .filter(Boolean)\n .join(' ');\n\n // A bare `name: Error` says nothing; keep the line only when it is specific or carries a code.\n if (identity !== '' && identity !== 'Error') {\n lines.push(`name: ${identity}`);\n }\n\n // The caller's code wins; otherwise the error's own, so a direct log call keeps its identifier too.\n const code =\n messageCode !== undefined && messageCode !== '' ? messageCode : summary.messageCode;\n if (code !== undefined) {\n lines.push(`code: ${code}`);\n }\n\n this.pushDiagnostics({ node: summary, lines });\n\n // An explicit `extra` wins; otherwise fall back to the one the error carries itself.\n const context = extra ?? summary.extra;\n\n if (context !== undefined && Object.keys(context).length > 0) {\n lines.push(`extra: ${util.inspect(redactSecrets(context), inspectOptions)}`);\n }\n\n if (summary.stack !== undefined) {\n lines.push(`stack:\\n${summary.stack}`);\n }\n\n return lines.map(line => `- ${line}`).join('\\n');\n }\n\n /** Renders {@link summarize}. `text` returns a block whose newlines survive `%s`; `json` returns one line. */\n static format(opts: {\n error: unknown;\n messageCode?: string;\n extra?: Record<string, unknown>;\n includeStack?: boolean;\n maxStackFrames?: number;\n format?: TLoggerFormat;\n inspectOptions?: util.InspectOptions;\n }): string {\n const {\n error,\n messageCode,\n extra,\n includeStack = true,\n maxStackFrames,\n format,\n inspectOptions = this.INSPECT_OPTIONS,\n } = opts;\n\n const summary = this.summarize({ error, includeStack, maxStackFrames });\n\n if (this.resolveFormat(format) === LoggerFormats.JSON) {\n return this.renderJson({ summary, messageCode, extra });\n }\n\n return this.renderText({ summary, messageCode, extra, inspectOptions });\n }\n}\n"]}
1
+ {"version":3,"file":"error-prettier.js","sourceRoot":"","sources":["../../../../../src/modules/logger/formatting/error-prettier.ts"],"names":[],"mappings":"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","sourcesContent":["import { redactSecrets } from '@/common/redact';\nimport { MessageCode } from '@/modules/error';\nimport util from 'node:util';\nimport { LoggerFormats, type TLoggerFormat } from '../common';\n\n/** Useful-only projection of an error: a driver's `query`/`params` repeat the message and are dropped. */\nexport interface IErrorSummary {\n name?: string;\n message?: string;\n /** The error's OWN code - a driver's `23505`, a gRPC `14`. Belongs with the name, not with the message. */\n code?: string | number;\n /** An `ApplicationError`'s `normalized.code` - the identifier an application filters on. `MessageCode.DEFAULT` never surfaces. */\n messageCode?: string;\n /** Frames ONLY - V8's `Error: <message>` header is stripped so the message is not repeated. */\n stack?: string;\n hint?: string;\n detail?: string;\n table?: string;\n constraint?: string;\n /** Values for the `%{placeholder}` tokens left unresolved in `message` - i18n resolves them downstream, so the log must carry them or the message names no field. */\n args?: Record<string, unknown>;\n /** An `ApplicationError`'s caller context - the one unmodelled payload worth keeping. */\n extra?: Record<string, unknown>;\n cause?: IErrorSummary;\n /** Every reason an `AggregateError` collected. Its own message names none of them, so without this the log says only that something failed. */\n errors?: Array<IErrorSummary>;\n}\n\n/** Turns a thrown value into something a human can read in a console - log this, never the raw error. */\nexport class ErrorPrettier {\n /** Bounds a pathological or cyclic `cause` chain. */\n static readonly DEFAULT_MAX_CAUSE_DEPTH = 5;\n\n /** The throw site is near the top; the tail is identical framework plumbing for every request. */\n static readonly DEFAULT_MAX_STACK_FRAMES = 10;\n\n /** Driver diagnostics that are actionable and absent from `message` - `pg` supplies all four. */\n private static readonly DIAGNOSTIC_KEYS = ['hint', 'detail', 'table', 'constraint'] as const;\n\n /** A stack frame line in every V8 stack: ` at fn (file:line:col)`. */\n private static readonly FRAME_PATTERN = /^\\s+at /;\n\n /** A frame inside an installed package - `node_modules/` covers bun's `.bun/` store too. */\n private static readonly DEPENDENCY_FRAME_PATTERN = /node_modules[/\\\\]/;\n\n /** `getError` sits on top of every `ApplicationError` stack and names no call site. Installed, it is also the FIRST dependency frame, so the keep-the-first rule would preserve exactly the wrong one. Anchored on `inversion` so an application's own `modules/error/app-error` is not swallowed with it. */\n private static readonly ERROR_FACTORY_FRAME_PATTERN =\n /inversion[/\\\\].*modules[/\\\\]error[/\\\\]app-error/;\n\n /** Issues rendered from a ZodError before the rest are counted off. */\n private static readonly MAX_ZOD_ISSUES = 10;\n\n /** Members of an `AggregateError` rendered before the rest are counted off. */\n private static readonly MAX_AGGREGATED_ERRORS = 10;\n\n private static readonly INSPECT_OPTIONS: util.InspectOptions = {\n depth: 5,\n maxArrayLength: null,\n maxStringLength: null,\n breakLength: Infinity,\n };\n\n private static extractFrames(opts: { stack: unknown; maxFrames: number }): string | undefined {\n const { stack, maxFrames } = opts;\n\n if (typeof stack !== 'string') {\n return undefined;\n }\n\n const frames: Array<string> = [];\n let keptDependencyFrame = false;\n let omitted = 0;\n\n // Hand-rolled over split+filter+slice: it stops at maxFrames instead of walking the whole stack.\n const lines = stack.split('\\n');\n for (const line of lines) {\n if (!this.FRAME_PATTERN.test(line)) {\n continue;\n }\n\n // Not counted as omitted: a factory frame is noise, and reporting it would imply signal was dropped.\n if (this.ERROR_FACTORY_FRAME_PATTERN.test(line)) {\n continue;\n }\n\n // The FIRST dependency frame is often the throw site (drizzle, jose); every later one is plumbing.\n const isDependencyFrame = this.DEPENDENCY_FRAME_PATTERN.test(line);\n\n if (isDependencyFrame && keptDependencyFrame) {\n omitted += 1;\n continue;\n }\n\n keptDependencyFrame = keptDependencyFrame || isDependencyFrame;\n frames.push(line);\n\n if (frames.length === maxFrames) {\n break;\n }\n }\n\n // Emit nothing rather than the header, which would repeat the message.\n if (frames.length === 0) {\n return undefined;\n }\n\n // Never truncate silently - a reader must know frames are missing, not assume the stack ended.\n return omitted > 0\n ? `${frames.join('\\n')}\\n ... ${omitted} dependency frames`\n : frames.join('\\n');\n }\n\n /** A ZodError's `message` is its issue array as pretty JSON - dozens of lines for one bad field. Render `path: reason` instead. */\n private static compressZodMessage(opts: { message: string }): string {\n const { message } = opts;\n\n let issues: unknown;\n\n try {\n issues = JSON.parse(message);\n } catch {\n // Not the JSON form (an already-formatted or hand-built ZodError) - leave it alone.\n return message;\n }\n\n if (!Array.isArray(issues) || issues.length === 0) {\n return message;\n }\n\n const lines = issues.slice(0, this.MAX_ZOD_ISSUES).map((issue) => {\n const entry = issue as { path?: Array<string | number>; message?: string; code?: string };\n const path =\n Array.isArray(entry.path) && entry.path.length > 0 ? entry.path.join('.') : '(root)';\n\n return `${path}: ${entry.message ?? entry.code ?? 'invalid'}`;\n });\n\n const remaining = issues.length - lines.length;\n\n return remaining > 0 ? `${lines.join('\\n')}\\n... and ${remaining} more` : lines.join('\\n');\n }\n\n private static summarizeNode(opts: {\n value: unknown;\n depthLeft: number;\n seen: WeakSet<object>;\n isRoot: boolean;\n includeStack: boolean;\n maxStackFrames: number;\n }): IErrorSummary {\n const { value, depthLeft, seen, isRoot, includeStack, maxStackFrames } = opts;\n\n // A primitive - a string thrown as `cause`, a numeric code - is its own message.\n if (typeof value !== 'object' || value === null) {\n return { message: String(value) };\n }\n\n if (seen.has(value)) {\n return { message: '[Circular]' };\n }\n seen.add(value);\n\n const source = value as Record<string, unknown>;\n const summary: IErrorSummary = {};\n\n if (typeof source.name === 'string') {\n summary.name = source.name;\n }\n\n if (typeof source.message === 'string') {\n summary.message =\n source.name === 'ZodError'\n ? this.compressZodMessage({ message: source.message })\n : source.message;\n }\n\n if (typeof source.code === 'string' || typeof source.code === 'number') {\n summary.code = source.code;\n }\n\n const normalized =\n typeof source.normalized === 'object' && source.normalized !== null\n ? (source.normalized as { code?: unknown; args?: unknown })\n : undefined;\n\n // `MessageCode.resolve` stamps DEFAULT on every codeless error, so surfacing it blindly would put a meaningless line on every log.\n if (typeof normalized?.code === 'string' && normalized.code !== MessageCode.DEFAULT) {\n summary.messageCode = normalized.code;\n }\n\n // Root only: a cause's frames point into the same libraries and add no location the root lacks.\n if (isRoot && includeStack) {\n const frames = this.extractFrames({ stack: source.stack, maxFrames: maxStackFrames });\n if (frames !== undefined) {\n summary.stack = frames;\n }\n }\n\n for (const key of this.DIAGNOSTIC_KEYS) {\n const diagnostic = source[key];\n if (typeof diagnostic === 'string' && diagnostic.length > 0) {\n summary[key] = diagnostic;\n }\n }\n\n // Root only: the args fill the ROOT's message; a cause's belong to a message this block does not print.\n if (isRoot && typeof normalized?.args === 'object' && normalized.args !== null) {\n const args = normalized.args as Record<string, unknown>;\n if (Object.keys(args).length > 0) {\n summary.args = args;\n }\n }\n\n // Root only: `extra` is what a throw site deliberately attached, so a direct log call keeps it.\n if (isRoot && typeof source.extra === 'object' && source.extra !== null) {\n const extra = source.extra as Record<string, unknown>;\n if (Object.keys(extra).length > 0) {\n summary.extra = extra;\n }\n }\n\n if (source.cause !== undefined && source.cause !== null && depthLeft > 0) {\n summary.cause = this.summarizeNode({\n value: source.cause,\n depthLeft: depthLeft - 1,\n seen,\n isRoot: false,\n includeStack,\n maxStackFrames,\n });\n }\n\n // A protocol client reports one member per thing that failed; the wrapper carries only a generic sentence.\n if (Array.isArray(source.errors) && source.errors.length > 0 && depthLeft > 0) {\n const members = source.errors.slice(0, this.MAX_AGGREGATED_ERRORS).map((member) =>\n this.summarizeNode({\n value: member,\n depthLeft: depthLeft - 1,\n seen,\n isRoot: false,\n includeStack,\n maxStackFrames,\n }),\n );\n\n const remaining = source.errors.length - members.length;\n if (remaining > 0) {\n members.push({ message: `... and ${remaining} more` });\n }\n\n summary.errors = members;\n }\n\n // Nothing recognizable: inspect it (redacted) so an unmodelled shape still reaches the log.\n if (Object.keys(summary).length === 0) {\n return { message: util.inspect(redactSecrets(value), this.INSPECT_OPTIONS) };\n }\n\n return summary;\n }\n\n private static pushDiagnostics(opts: { node: IErrorSummary; lines: Array<string> }): void {\n const { node, lines } = opts;\n\n for (const key of this.DIAGNOSTIC_KEYS) {\n const diagnostic = node[key];\n if (diagnostic !== undefined) {\n lines.push(`${key}: ${diagnostic}`);\n }\n }\n }\n\n /** Under whichever node collected them - a wrapped `AggregateError` is the common shape. */\n private static pushAggregatedErrors(opts: { node: IErrorSummary; lines: Array<string> }): void {\n const { node, lines } = opts;\n\n node.errors?.forEach((member, index) => {\n const memberCode = member.code ?? member.messageCode;\n const code = memberCode === undefined ? '' : ` (code ${memberCode})`;\n lines.push(`errors[${index}]: ${member.message ?? ''}${code}`);\n this.pushDiagnostics({ node: member, lines });\n });\n }\n\n /** Reduces any thrown value to {@link IErrorSummary} - always a summary, never a bare primitive. */\n static summarize(opts: {\n error: unknown;\n includeStack?: boolean;\n maxCauseDepth?: number;\n maxStackFrames?: number;\n }): IErrorSummary {\n const {\n error,\n includeStack = true,\n maxCauseDepth = this.DEFAULT_MAX_CAUSE_DEPTH,\n maxStackFrames = this.DEFAULT_MAX_STACK_FRAMES,\n } = opts;\n\n return this.summarizeNode({\n value: error,\n depthLeft: maxCauseDepth,\n seen: new WeakSet(),\n isRoot: true,\n includeStack,\n maxStackFrames,\n });\n }\n\n /** Resolved per call, not at module load, so a test passes a value instead of mutating the environment. */\n private static resolveFormat(configured?: TLoggerFormat): TLoggerFormat {\n if (configured !== undefined) {\n return configured;\n }\n\n const fromEnv = process.env.APP_ENV_LOGGER_FORMAT;\n\n return fromEnv !== undefined && LoggerFormats.isValid(fromEnv) ? fromEnv : LoggerFormats.TEXT;\n }\n\n /** `JSON.stringify` throws on a cycle, and `format` runs inside the error handler - a throw there turns a handled failure into an unhandled one. `redactSecrets` breaks cycles on its own, but it is switched off by `APP_ENV_LOGGER_DO_REDACT=false`, so structural safety cannot lean on it. A repeated reference reads as `[Circular]` too: the first occurrence still carries the data. */\n private static safeStringify(payload: Record<string, unknown>): string {\n const seen = new WeakSet<object>();\n\n return JSON.stringify(payload, (_key, value: unknown) => {\n if (typeof value !== 'object' || value === null) {\n return value;\n }\n\n if (seen.has(value)) {\n return '[Circular]';\n }\n\n seen.add(value);\n return value;\n });\n }\n\n /** One line, so a log monitor keeps the error as ONE record instead of one per bullet. */\n private static renderJson(opts: {\n summary: IErrorSummary;\n messageCode?: string;\n extra?: Record<string, unknown>;\n }): string {\n const { summary, messageCode, extra } = opts;\n\n const payload: Record<string, unknown> = {};\n\n if (summary.message !== undefined) {\n payload.message = summary.message;\n }\n\n if (summary.args !== undefined) {\n payload.args = redactSecrets(summary.args);\n }\n\n // An ApplicationError has no own `code` and a driver error has no `normalized`, so one field never hides the other.\n const code =\n messageCode !== undefined && messageCode !== ''\n ? messageCode\n : (summary.messageCode ?? summary.code);\n if (code !== undefined) {\n payload.code = code;\n }\n\n // A bare `Error` says nothing; the text block drops it for the same reason.\n if (summary.name !== undefined && summary.name !== 'Error') {\n payload.name = summary.name;\n }\n\n for (const key of this.DIAGNOSTIC_KEYS) {\n if (summary[key] !== undefined) {\n payload[key] = summary[key];\n }\n }\n\n const context = extra ?? summary.extra;\n if (context !== undefined && Object.keys(context).length > 0) {\n payload.extra = redactSecrets(context);\n }\n\n if (summary.cause !== undefined) {\n payload.cause = summary.cause;\n }\n\n if (summary.errors !== undefined) {\n payload.errors = summary.errors;\n }\n\n // An ARRAY, not the newline-joined string `text` prints: a monitor can count and slice frames.\n if (summary.stack !== undefined) {\n payload.stack = summary.stack.split('\\n').map((frame) => frame.trim());\n }\n\n return this.safeStringify(payload);\n }\n\n private static renderText(opts: {\n summary: IErrorSummary;\n messageCode?: string;\n extra?: Record<string, unknown>;\n inspectOptions: util.InspectOptions;\n }): string {\n const { summary, messageCode, extra, inspectOptions } = opts;\n\n const lines: Array<string> = [];\n\n // What happened, then why, then who/where - a reader stops as soon as they have the answer.\n if (summary.message !== undefined) {\n lines.push(`message: ${summary.message}`);\n }\n\n // Straight after the message: the reader is looking at `%{field}` and needs the value now, not below the stack.\n if (summary.args !== undefined) {\n lines.push(`args: ${util.inspect(redactSecrets(summary.args), inspectOptions)}`);\n }\n\n this.pushAggregatedErrors({ node: summary, lines });\n\n let cause = summary.cause;\n while (cause !== undefined) {\n const causeCode = cause.code ?? cause.messageCode;\n const code = causeCode === undefined ? '' : ` (code ${causeCode})`;\n lines.push(`cause: ${cause.message ?? ''}${code}`);\n this.pushDiagnostics({ node: cause, lines });\n this.pushAggregatedErrors({ node: cause, lines });\n cause = cause.cause;\n }\n\n const identity = [summary.name, summary.code === undefined ? '' : `(code ${summary.code})`]\n .filter(Boolean)\n .join(' ');\n\n // A bare `name: Error` says nothing; keep the line only when it is specific or carries a code.\n if (identity !== '' && identity !== 'Error') {\n lines.push(`name: ${identity}`);\n }\n\n // The caller's code wins; otherwise the error's own, so a direct log call keeps its identifier too.\n const code =\n messageCode !== undefined && messageCode !== '' ? messageCode : summary.messageCode;\n if (code !== undefined) {\n lines.push(`code: ${code}`);\n }\n\n this.pushDiagnostics({ node: summary, lines });\n\n // An explicit `extra` wins; otherwise fall back to the one the error carries itself.\n const context = extra ?? summary.extra;\n\n if (context !== undefined && Object.keys(context).length > 0) {\n lines.push(`extra: ${util.inspect(redactSecrets(context), inspectOptions)}`);\n }\n\n if (summary.stack !== undefined) {\n lines.push(`stack:\\n${summary.stack}`);\n }\n\n return lines.map((line) => `- ${line}`).join('\\n');\n }\n\n /** Renders {@link summarize}. `text` returns a block whose newlines survive `%s`; `json` returns one line. */\n static format(opts: {\n error: unknown;\n messageCode?: string;\n extra?: Record<string, unknown>;\n includeStack?: boolean;\n maxStackFrames?: number;\n format?: TLoggerFormat;\n inspectOptions?: util.InspectOptions;\n }): string {\n const {\n error,\n messageCode,\n extra,\n includeStack = true,\n maxStackFrames,\n format,\n inspectOptions = this.INSPECT_OPTIONS,\n } = opts;\n\n const summary = this.summarize({ error, includeStack, maxStackFrames });\n\n if (this.resolveFormat(format) === LoggerFormats.JSON) {\n return this.renderJson({ summary, messageCode, extra });\n }\n\n return this.renderText({ summary, messageCode, extra, inspectOptions });\n }\n}\n"]}
@@ -38,7 +38,7 @@ class HfLogFlusher {
38
38
  return `${iso} [${levelName}] ${scope} ${message}`;
39
39
  }
40
40
  static buildDefaultSink(filePath) {
41
- return batch => {
41
+ return (batch) => {
42
42
  const rendered = (batch.dropped > 0
43
43
  ? `${new Date().toISOString()} [warn] HfLogFlusher ring lapped - ${batch.dropped} entries overwritten before they could be read\n`
44
44
  : '') +
@@ -77,7 +77,7 @@ class HfLogFlusher {
77
77
  }
78
78
  await this.deliverBatch({ lines, dropped });
79
79
  if (this.flushIndex < ring.writeIndex) {
80
- await new Promise(resolve => setImmediate(resolve));
80
+ await new Promise((resolve) => setImmediate(resolve));
81
81
  }
82
82
  }
83
83
  }
@@ -96,7 +96,7 @@ class HfLogFlusher {
96
96
  start(intervalMs = common_1.HF_DEFAULT_FLUSH_INTERVAL_MS) {
97
97
  this.stop();
98
98
  this.timer = setInterval(() => {
99
- this.flush().catch(error => {
99
+ this.flush().catch((error) => {
100
100
  console.error('[HfLogFlusher][start] Flush failed | error: ', error);
101
101
  });
102
102
  }, intervalMs);
@@ -1 +1 @@
1
- {"version":3,"file":"flusher.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/flusher.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'node:fs';\nimport { type AnyType } from '@/common/types';\nimport { isPromiseLike } from '@/utilities/promise.utility';\nimport {\n BUFFER_SIZE,\n ENTRY_SIZE,\n HF_DEFAULT_BATCH_SIZE,\n HF_DEFAULT_FLUSH_INTERVAL_MS,\n HF_LEVEL_NAMES,\n type IHfLogFlusherOptions,\n OFFSET_LEVEL,\n OFFSET_MESSAGE,\n OFFSET_MESSAGE_LENGTH,\n OFFSET_SCOPE,\n OFFSET_SCOPE_LENGTH,\n type THfSink,\n type TRingState,\n} from './common';\nimport { HfLogRing } from './ring';\n\n/** Drains the ring in bounded batches, yielding between them - see the spec's lap accounting. */\nexport class HfLogFlusher {\n private static readonly textDecoder = new TextDecoder();\n\n private flushIndex = 0;\n private inFlightDrain: Promise<void> | null = null;\n private timer: ReturnType<typeof setInterval> | null = null;\n private readonly sink: THfSink;\n private readonly batchSize: number;\n\n constructor(options?: IHfLogFlusherOptions) {\n this.sink = options?.sink ?? HfLogFlusher.buildDefaultSink(options?.filePath);\n\n const batchSize = options?.batchSize ?? HF_DEFAULT_BATCH_SIZE;\n if (!Number.isInteger(batchSize) || batchSize < 1) {\n // console, not the Logger: this IS the drain path - routing through a logger re-enters it.\n console.warn(\n '[HfLogFlusher] Invalid batchSize | value: %s | fallback: %s',\n batchSize,\n HF_DEFAULT_BATCH_SIZE,\n );\n this.batchSize = HF_DEFAULT_BATCH_SIZE;\n } else {\n this.batchSize = batchSize;\n }\n }\n\n private static renderEntry(ring: TRingState, sequence: number): string {\n const offset = (sequence & (BUFFER_SIZE - 1)) * ENTRY_SIZE;\n const bytes = ring.bytes;\n const iso = new Date(ring.f64[offset >> 3]).toISOString();\n const levelName = HF_LEVEL_NAMES[bytes[offset + OFFSET_LEVEL]] ?? 'info';\n const scopeLength = bytes[offset + OFFSET_SCOPE_LENGTH];\n const scope = HfLogFlusher.textDecoder.decode(\n bytes.subarray(offset + OFFSET_SCOPE, offset + OFFSET_SCOPE + scopeLength),\n );\n const messageLength = bytes[offset + OFFSET_MESSAGE_LENGTH];\n const message = HfLogFlusher.textDecoder.decode(\n bytes.subarray(offset + OFFSET_MESSAGE, offset + OFFSET_MESSAGE + messageLength),\n );\n return `${iso} [${levelName}] ${scope} ${message}`;\n }\n\n private static buildDefaultSink(filePath?: string): THfSink {\n return batch => {\n const rendered =\n (batch.dropped > 0\n ? `${new Date().toISOString()} [warn] HfLogFlusher ring lapped - ${batch.dropped} entries overwritten before they could be read\\n`\n : '') +\n batch.lines.join('\\n') +\n '\\n';\n\n if (filePath) {\n fs.appendFileSync(filePath, rendered);\n return;\n }\n process.stdout.write(rendered);\n };\n }\n\n flush(): Promise<void> {\n if (this.inFlightDrain) {\n return this.inFlightDrain;\n }\n this.inFlightDrain = this.drain().finally(() => {\n this.inFlightDrain = null;\n });\n return this.inFlightDrain;\n }\n\n private async drain(): Promise<void> {\n const ring = HfLogRing.get();\n\n while (this.flushIndex < ring.writeIndex) {\n // Lap accounting, re-checked every batch: the producer may advance during yields.\n let dropped = 0;\n const backlog = ring.writeIndex - this.flushIndex;\n if (backlog > BUFFER_SIZE) {\n dropped = backlog - BUFFER_SIZE;\n this.flushIndex = ring.writeIndex - BUFFER_SIZE;\n }\n\n const count = Math.min(this.batchSize, ring.writeIndex - this.flushIndex);\n const lines: Array<string> = [];\n for (let index = 0; index < count; index++) {\n lines.push(HfLogFlusher.renderEntry(ring, this.flushIndex++));\n }\n\n await this.deliverBatch({ lines, dropped });\n\n if (this.flushIndex < ring.writeIndex) {\n await new Promise(resolve => setImmediate(resolve));\n }\n }\n }\n\n private async deliverBatch(opts: { lines: Array<string>; dropped: number }): Promise<void> {\n try {\n // THfSink is typed `=> void`, but an async sink still returns a thenable at runtime - await it inside the try so its rejection is caught here, never unhandled.\n const delivered = this.sink(opts) as AnyType;\n if (isPromiseLike(delivered)) {\n await delivered;\n }\n } catch (error) {\n console.error('[HfLogFlusher][drain] Sink failed | error: ', error);\n }\n }\n\n start(intervalMs = HF_DEFAULT_FLUSH_INTERVAL_MS): void {\n this.stop();\n this.timer = setInterval(() => {\n this.flush().catch(error => {\n console.error('[HfLogFlusher][start] Flush failed | error: ', error);\n });\n }, intervalMs);\n this.timer.unref?.();\n }\n\n stop(): void {\n if (this.timer) {\n clearInterval(this.timer);\n this.timer = null;\n }\n }\n}\n"]}
1
+ {"version":3,"file":"flusher.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/flusher.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'node:fs';\nimport { type AnyType } from '@/common/types';\nimport { isPromiseLike } from '@/utilities/promise.utility';\nimport {\n BUFFER_SIZE,\n ENTRY_SIZE,\n HF_DEFAULT_BATCH_SIZE,\n HF_DEFAULT_FLUSH_INTERVAL_MS,\n HF_LEVEL_NAMES,\n type IHfLogFlusherOptions,\n OFFSET_LEVEL,\n OFFSET_MESSAGE,\n OFFSET_MESSAGE_LENGTH,\n OFFSET_SCOPE,\n OFFSET_SCOPE_LENGTH,\n type THfSink,\n type TRingState,\n} from './common';\nimport { HfLogRing } from './ring';\n\n/** Drains the ring in bounded batches, yielding between them - see the spec's lap accounting. */\nexport class HfLogFlusher {\n private static readonly textDecoder = new TextDecoder();\n\n private flushIndex = 0;\n private inFlightDrain: Promise<void> | null = null;\n private timer: ReturnType<typeof setInterval> | null = null;\n private readonly sink: THfSink;\n private readonly batchSize: number;\n\n constructor(options?: IHfLogFlusherOptions) {\n this.sink = options?.sink ?? HfLogFlusher.buildDefaultSink(options?.filePath);\n\n const batchSize = options?.batchSize ?? HF_DEFAULT_BATCH_SIZE;\n if (!Number.isInteger(batchSize) || batchSize < 1) {\n // console, not the Logger: this IS the drain path - routing through a logger re-enters it.\n console.warn(\n '[HfLogFlusher] Invalid batchSize | value: %s | fallback: %s',\n batchSize,\n HF_DEFAULT_BATCH_SIZE,\n );\n this.batchSize = HF_DEFAULT_BATCH_SIZE;\n } else {\n this.batchSize = batchSize;\n }\n }\n\n private static renderEntry(ring: TRingState, sequence: number): string {\n const offset = (sequence & (BUFFER_SIZE - 1)) * ENTRY_SIZE;\n const bytes = ring.bytes;\n const iso = new Date(ring.f64[offset >> 3]).toISOString();\n const levelName = HF_LEVEL_NAMES[bytes[offset + OFFSET_LEVEL]] ?? 'info';\n const scopeLength = bytes[offset + OFFSET_SCOPE_LENGTH];\n const scope = HfLogFlusher.textDecoder.decode(\n bytes.subarray(offset + OFFSET_SCOPE, offset + OFFSET_SCOPE + scopeLength),\n );\n const messageLength = bytes[offset + OFFSET_MESSAGE_LENGTH];\n const message = HfLogFlusher.textDecoder.decode(\n bytes.subarray(offset + OFFSET_MESSAGE, offset + OFFSET_MESSAGE + messageLength),\n );\n return `${iso} [${levelName}] ${scope} ${message}`;\n }\n\n private static buildDefaultSink(filePath?: string): THfSink {\n return (batch) => {\n const rendered =\n (batch.dropped > 0\n ? `${new Date().toISOString()} [warn] HfLogFlusher ring lapped - ${batch.dropped} entries overwritten before they could be read\\n`\n : '') +\n batch.lines.join('\\n') +\n '\\n';\n\n if (filePath) {\n fs.appendFileSync(filePath, rendered);\n return;\n }\n process.stdout.write(rendered);\n };\n }\n\n flush(): Promise<void> {\n if (this.inFlightDrain) {\n return this.inFlightDrain;\n }\n this.inFlightDrain = this.drain().finally(() => {\n this.inFlightDrain = null;\n });\n return this.inFlightDrain;\n }\n\n private async drain(): Promise<void> {\n const ring = HfLogRing.get();\n\n while (this.flushIndex < ring.writeIndex) {\n // Lap accounting, re-checked every batch: the producer may advance during yields.\n let dropped = 0;\n const backlog = ring.writeIndex - this.flushIndex;\n if (backlog > BUFFER_SIZE) {\n dropped = backlog - BUFFER_SIZE;\n this.flushIndex = ring.writeIndex - BUFFER_SIZE;\n }\n\n const count = Math.min(this.batchSize, ring.writeIndex - this.flushIndex);\n const lines: Array<string> = [];\n for (let index = 0; index < count; index++) {\n lines.push(HfLogFlusher.renderEntry(ring, this.flushIndex++));\n }\n\n await this.deliverBatch({ lines, dropped });\n\n if (this.flushIndex < ring.writeIndex) {\n await new Promise((resolve) => setImmediate(resolve));\n }\n }\n }\n\n private async deliverBatch(opts: { lines: Array<string>; dropped: number }): Promise<void> {\n try {\n // THfSink is typed `=> void`, but an async sink still returns a thenable at runtime - await it inside the try so its rejection is caught here, never unhandled.\n const delivered = this.sink(opts) as AnyType;\n if (isPromiseLike(delivered)) {\n await delivered;\n }\n } catch (error) {\n console.error('[HfLogFlusher][drain] Sink failed | error: ', error);\n }\n }\n\n start(intervalMs = HF_DEFAULT_FLUSH_INTERVAL_MS): void {\n this.stop();\n this.timer = setInterval(() => {\n this.flush().catch((error) => {\n console.error('[HfLogFlusher][start] Flush failed | error: ', error);\n });\n }, intervalMs);\n this.timer.unref?.();\n }\n\n stop(): void {\n if (this.timer) {\n clearInterval(this.timer);\n this.timer = null;\n }\n }\n}\n"]}