@venizia/ignis-helpers 0.4.7 → 0.4.8-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 (678) hide show
  1. package/README.md +2 -2
  2. package/dist/esm/common/constants/app.d.ts +15 -0
  3. package/dist/esm/common/constants/app.js +14 -0
  4. package/dist/esm/common/constants/app.js.map +1 -1
  5. package/dist/esm/common/constants/duration.d.ts +2 -0
  6. package/dist/esm/common/constants/duration.js.map +1 -1
  7. package/dist/esm/common/constants/grpc.d.ts +3 -0
  8. package/dist/esm/common/constants/grpc.js +1 -0
  9. package/dist/esm/common/constants/grpc.js.map +1 -1
  10. package/dist/esm/common/constants/http.d.ts +4 -0
  11. package/dist/esm/common/constants/http.js +1 -0
  12. package/dist/esm/common/constants/http.js.map +1 -1
  13. package/dist/esm/common/constants/mime.d.ts +4 -0
  14. package/dist/esm/common/constants/mime.js +1 -0
  15. package/dist/esm/common/constants/mime.js.map +1 -1
  16. package/dist/esm/common/redact.d.ts +2 -0
  17. package/dist/esm/common/redact.js +2 -0
  18. package/dist/esm/common/redact.js.map +1 -1
  19. package/dist/esm/common/resolvers.d.ts +1 -0
  20. package/dist/esm/common/resolvers.js +1 -0
  21. package/dist/esm/common/resolvers.js.map +1 -1
  22. package/dist/esm/common/types/class.d.ts +6 -0
  23. package/dist/esm/common/types/class.js.map +1 -1
  24. package/dist/esm/common/types/const-value.d.ts +3 -0
  25. package/dist/esm/common/types/const-value.js.map +1 -1
  26. package/dist/esm/common/types/field-mapping.d.ts +3 -0
  27. package/dist/esm/common/types/field-mapping.js.map +1 -1
  28. package/dist/esm/common/types/injection.d.ts +2 -0
  29. package/dist/esm/common/types/injection.js.map +1 -1
  30. package/dist/esm/common/types/utility.d.ts +9 -0
  31. package/dist/esm/common/types/utility.js.map +1 -1
  32. package/dist/esm/modules/base.d.ts +1 -0
  33. package/dist/esm/modules/base.js +1 -0
  34. package/dist/esm/modules/base.js.map +1 -1
  35. package/dist/esm/modules/cron/helper.d.ts +7 -0
  36. package/dist/esm/modules/cron/helper.js +1 -0
  37. package/dist/esm/modules/cron/helper.js.map +1 -1
  38. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts +2 -0
  39. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  40. package/dist/esm/modules/crypto/algorithms/aes.engine.js.map +1 -1
  41. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts +1 -0
  42. package/dist/esm/modules/crypto/algorithms/base.algorithm.js +1 -0
  43. package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
  44. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts +12 -4
  45. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js +4 -4
  46. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js.map +1 -1
  47. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts +3 -0
  48. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.js.map +1 -1
  49. package/dist/esm/modules/crypto/algorithms/hash.algorithm.js.map +1 -1
  50. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts +1 -0
  51. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.js.map +1 -1
  52. package/dist/esm/modules/crypto/common/constants.d.ts +12 -1
  53. package/dist/esm/modules/crypto/common/constants.js +9 -1
  54. package/dist/esm/modules/crypto/common/constants.js.map +1 -1
  55. package/dist/esm/modules/crypto/common/types.d.ts +1 -0
  56. package/dist/esm/modules/crypto/common/types.js.map +1 -1
  57. package/dist/esm/modules/env/app-env.d.ts +3 -0
  58. package/dist/esm/modules/env/app-env.js +3 -0
  59. package/dist/esm/modules/env/app-env.js.map +1 -1
  60. package/dist/esm/modules/env/common/types.d.ts +1 -0
  61. package/dist/esm/modules/env/common/types.js.map +1 -1
  62. package/dist/esm/modules/logger/base/base.js.map +1 -1
  63. package/dist/esm/modules/logger/base/console.js.map +1 -1
  64. package/dist/esm/modules/logger/common/constants.d.ts +3 -0
  65. package/dist/esm/modules/logger/common/constants.js +2 -0
  66. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  67. package/dist/esm/modules/logger/common/debug-gate.js.map +1 -1
  68. package/dist/esm/modules/logger/common/types.d.ts +2 -0
  69. package/dist/esm/modules/logger/common/types.js +1 -0
  70. package/dist/esm/modules/logger/common/types.js.map +1 -1
  71. package/dist/esm/modules/logger/factory.js.map +1 -1
  72. package/dist/esm/modules/logger/formatting/deep-splat.d.ts +1 -0
  73. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -0
  74. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  75. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  76. package/dist/esm/modules/logger/hf/common/types.d.ts +7 -2
  77. package/dist/esm/modules/logger/hf/common/types.js.map +1 -1
  78. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  79. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  80. package/dist/esm/modules/logger/hf/ring.js.map +1 -1
  81. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  82. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  83. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  84. package/dist/esm/modules/logger/winston/common/types.d.ts +31 -3
  85. package/dist/esm/modules/logger/winston/common/types.js.map +1 -1
  86. package/dist/esm/modules/logger/winston/define.d.ts +1 -0
  87. package/dist/esm/modules/logger/winston/define.js +1 -0
  88. package/dist/esm/modules/logger/winston/define.js.map +1 -1
  89. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  90. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  91. package/dist/esm/modules/logger/winston/logger.d.ts +1 -0
  92. package/dist/esm/modules/logger/winston/logger.js +1 -0
  93. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  94. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -0
  95. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -0
  96. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  97. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts +1 -0
  98. package/dist/esm/modules/network/http-request/base-network-request.helper.js +1 -0
  99. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  100. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +8 -8
  101. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +2 -0
  102. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  103. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +2 -0
  104. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  105. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +5 -1
  106. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +2 -0
  107. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  108. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts +11 -0
  109. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -0
  110. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  111. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts +3 -0
  112. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +1 -0
  113. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  114. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts +1 -0
  115. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js +1 -0
  116. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js.map +1 -1
  117. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts +1 -0
  118. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js +1 -0
  119. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js.map +1 -1
  120. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts +1 -0
  121. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js +1 -0
  122. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js.map +1 -1
  123. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts +1 -0
  124. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js +1 -0
  125. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js.map +1 -1
  126. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts +4 -0
  127. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +4 -0
  128. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  129. package/dist/esm/modules/network/utilities/query-string.d.ts +13 -2
  130. package/dist/esm/modules/network/utilities/query-string.js +2 -1
  131. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  132. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +2 -1
  133. package/dist/esm/modules/network/utilities/url-safety/common/constants.js +1 -1
  134. package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
  135. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts +18 -5
  136. package/dist/esm/modules/network/utilities/url-safety/common/types.js.map +1 -1
  137. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  138. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  139. package/dist/esm/modules/pool/abstract.js.map +1 -1
  140. package/dist/esm/modules/pool/common/types.d.ts +5 -1
  141. package/dist/esm/modules/pool/common/types.js.map +1 -1
  142. package/dist/esm/modules/queue/bullmq/helper.d.ts +13 -0
  143. package/dist/esm/modules/queue/bullmq/helper.js +4 -0
  144. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  145. package/dist/esm/modules/queue/common/hook.d.ts +1 -0
  146. package/dist/esm/modules/queue/common/hook.js +1 -0
  147. package/dist/esm/modules/queue/common/hook.js.map +1 -1
  148. package/dist/esm/modules/queue/internal/hf/helper.js.map +1 -1
  149. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +8 -0
  150. package/dist/esm/modules/queue/internal/sequential/common/types.js +1 -0
  151. package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
  152. package/dist/esm/modules/queue/internal/sequential/helper.d.ts +4 -0
  153. package/dist/esm/modules/queue/internal/sequential/helper.js +4 -0
  154. package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
  155. package/dist/esm/modules/queue/kafka/base.d.ts +5 -0
  156. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  157. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts +3 -0
  158. package/dist/esm/modules/queue/kafka/bundler/common/constants.js +3 -0
  159. package/dist/esm/modules/queue/kafka/bundler/common/constants.js.map +1 -1
  160. package/dist/esm/modules/queue/kafka/common/constants.d.ts +8 -0
  161. package/dist/esm/modules/queue/kafka/common/constants.js +5 -0
  162. package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
  163. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts +1 -0
  164. package/dist/esm/modules/queue/kafka/common/types/admin.js.map +1 -1
  165. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts +12 -0
  166. package/dist/esm/modules/queue/kafka/common/types/callbacks.js.map +1 -1
  167. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts +2 -0
  168. package/dist/esm/modules/queue/kafka/common/types/connection.js.map +1 -1
  169. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts +62 -0
  170. package/dist/esm/modules/queue/kafka/common/types/consumer.js.map +1 -1
  171. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts +1 -0
  172. package/dist/esm/modules/queue/kafka/common/types/producer.js.map +1 -1
  173. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  174. package/dist/esm/modules/queue/mqtt/helper.d.ts +2 -0
  175. package/dist/esm/modules/queue/mqtt/helper.js +1 -0
  176. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  177. package/dist/esm/modules/redis/base/abstract.helper.d.ts +2 -0
  178. package/dist/esm/modules/redis/base/abstract.helper.js +2 -0
  179. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  180. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -0
  181. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -0
  182. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  183. package/dist/esm/modules/redis/common/constants.d.ts +4 -0
  184. package/dist/esm/modules/redis/common/constants.js +2 -0
  185. package/dist/esm/modules/redis/common/constants.js.map +1 -1
  186. package/dist/esm/modules/redis/common/interfaces.d.ts +12 -0
  187. package/dist/esm/modules/redis/common/interfaces.js.map +1 -1
  188. package/dist/esm/modules/redis/common/types.d.ts +21 -1
  189. package/dist/esm/modules/redis/common/types.js.map +1 -1
  190. package/dist/esm/modules/redis/factory.d.ts +2 -0
  191. package/dist/esm/modules/redis/factory.js +1 -0
  192. package/dist/esm/modules/redis/factory.js.map +1 -1
  193. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -0
  194. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -0
  195. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  196. package/dist/esm/modules/redis/single/single.helper.d.ts +1 -0
  197. package/dist/esm/modules/redis/single/single.helper.js +1 -0
  198. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  199. package/dist/esm/modules/redis/utility.d.ts +1 -0
  200. package/dist/esm/modules/redis/utility.js +1 -0
  201. package/dist/esm/modules/redis/utility.js.map +1 -1
  202. package/dist/esm/modules/retry/common/constants.d.ts +4 -0
  203. package/dist/esm/modules/retry/common/constants.js +2 -0
  204. package/dist/esm/modules/retry/common/constants.js.map +1 -1
  205. package/dist/esm/modules/retry/common/types.d.ts +19 -5
  206. package/dist/esm/modules/retry/common/types.js.map +1 -1
  207. package/dist/esm/modules/retry/helper.d.ts +4 -4
  208. package/dist/esm/modules/retry/helper.js.map +1 -1
  209. package/dist/esm/modules/secrets/base/abstract.helper.d.ts +1 -0
  210. package/dist/esm/modules/secrets/base/abstract.helper.js +1 -0
  211. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  212. package/dist/esm/modules/secrets/common/constants.d.ts +4 -0
  213. package/dist/esm/modules/secrets/common/constants.js +2 -0
  214. package/dist/esm/modules/secrets/common/constants.js.map +1 -1
  215. package/dist/esm/modules/secrets/common/types/helper.d.ts +13 -0
  216. package/dist/esm/modules/secrets/common/types/helper.js.map +1 -1
  217. package/dist/esm/modules/secrets/common/types/lease.d.ts +2 -0
  218. package/dist/esm/modules/secrets/common/types/lease.js.map +1 -1
  219. package/dist/esm/modules/secrets/common/types/registration.d.ts +13 -2
  220. package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
  221. package/dist/esm/modules/secrets/common/types/timer.d.ts +1 -0
  222. package/dist/esm/modules/secrets/common/types/timer.js.map +1 -1
  223. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts +8 -0
  224. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -0
  225. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  226. package/dist/esm/modules/secrets/factory.d.ts +1 -0
  227. package/dist/esm/modules/secrets/factory.js +1 -0
  228. package/dist/esm/modules/secrets/factory.js.map +1 -1
  229. package/dist/esm/modules/secrets/hashicorp/auth.d.ts +2 -0
  230. package/dist/esm/modules/secrets/hashicorp/auth.js +1 -0
  231. package/dist/esm/modules/secrets/hashicorp/auth.js.map +1 -1
  232. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +2 -0
  233. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +1 -0
  234. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  235. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts +1 -0
  236. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js +1 -0
  237. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js.map +1 -1
  238. package/dist/esm/modules/slug/common/constants.d.ts +1 -0
  239. package/dist/esm/modules/slug/common/constants.js +1 -0
  240. package/dist/esm/modules/slug/common/constants.js.map +1 -1
  241. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
  242. package/dist/esm/modules/socket/socket-io/common/constants.d.ts +2 -0
  243. package/dist/esm/modules/socket/socket-io/common/constants.js +2 -0
  244. package/dist/esm/modules/socket/socket-io/common/constants.js.map +1 -1
  245. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +5 -0
  246. package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
  247. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts +4 -0
  248. package/dist/esm/modules/socket/socket-io/common/types/hooks.js.map +1 -1
  249. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +6 -0
  250. package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
  251. package/dist/esm/modules/socket/socket-io/server/helper.d.ts +1 -0
  252. package/dist/esm/modules/socket/socket-io/server/helper.js +1 -0
  253. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  254. package/dist/esm/modules/socket/websocket/common/constants.d.ts +7 -0
  255. package/dist/esm/modules/socket/websocket/common/constants.js +5 -0
  256. package/dist/esm/modules/socket/websocket/common/constants.js.map +1 -1
  257. package/dist/esm/modules/socket/websocket/common/types/client.d.ts +4 -0
  258. package/dist/esm/modules/socket/websocket/common/types/client.js.map +1 -1
  259. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts +7 -0
  260. package/dist/esm/modules/socket/websocket/common/types/hooks.js.map +1 -1
  261. package/dist/esm/modules/socket/websocket/common/types/server.d.ts +30 -0
  262. package/dist/esm/modules/socket/websocket/common/types/server.js.map +1 -1
  263. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts +1 -0
  264. package/dist/esm/modules/socket/websocket/emitter/helper.js +1 -0
  265. package/dist/esm/modules/socket/websocket/emitter/helper.js.map +1 -1
  266. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  267. package/dist/esm/modules/socket/websocket/server/helper.d.ts +1 -0
  268. package/dist/esm/modules/socket/websocket/server/helper.js +1 -0
  269. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  270. package/dist/esm/modules/storage/base.d.ts +6 -1
  271. package/dist/esm/modules/storage/base.js +1 -0
  272. package/dist/esm/modules/storage/base.js.map +1 -1
  273. package/dist/esm/modules/storage/bun-s3/helper.d.ts +9 -1
  274. package/dist/esm/modules/storage/bun-s3/helper.js +2 -1
  275. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  276. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  277. package/dist/esm/modules/storage/common/constants.d.ts +1 -0
  278. package/dist/esm/modules/storage/common/constants.js.map +1 -1
  279. package/dist/esm/modules/storage/common/types.d.ts +17 -1
  280. package/dist/esm/modules/storage/common/types.js.map +1 -1
  281. package/dist/esm/modules/storage/common/utility.d.ts +1 -0
  282. package/dist/esm/modules/storage/common/utility.js +1 -0
  283. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  284. package/dist/esm/modules/storage/disk/helper.d.ts +2 -0
  285. package/dist/esm/modules/storage/disk/helper.js +1 -0
  286. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  287. package/dist/esm/modules/temporal/abstract.d.ts +5 -0
  288. package/dist/esm/modules/temporal/abstract.js +2 -1
  289. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  290. package/dist/esm/modules/temporal/adapters/dayjs.js.map +1 -1
  291. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  292. package/dist/esm/modules/temporal/adapters/luxon.js.map +1 -1
  293. package/dist/esm/modules/temporal/adapters/native.js.map +1 -1
  294. package/dist/esm/modules/temporal/calendar/calendar.js.map +1 -1
  295. package/dist/esm/modules/temporal/common/constants.d.ts +3 -0
  296. package/dist/esm/modules/temporal/common/constants.js.map +1 -1
  297. package/dist/esm/modules/temporal/common/types.js.map +1 -1
  298. package/dist/esm/modules/temporal/duration/duration.js.map +1 -1
  299. package/dist/esm/modules/temporal/helper.js.map +1 -1
  300. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  301. package/dist/esm/modules/temporal/pattern/pattern.js.map +1 -1
  302. package/dist/esm/modules/temporal/pattern/tokens.js.map +1 -1
  303. package/dist/esm/modules/tree/builder.js.map +1 -1
  304. package/dist/esm/modules/tree/common/types.d.ts +6 -0
  305. package/dist/esm/modules/tree/common/types.js.map +1 -1
  306. package/dist/esm/modules/uid/common/constants.d.ts +1 -0
  307. package/dist/esm/modules/uid/common/constants.js.map +1 -1
  308. package/dist/esm/modules/uid/common/types.d.ts +28 -7
  309. package/dist/esm/modules/uid/common/types.js.map +1 -1
  310. package/dist/esm/modules/uid/helper.d.ts +12 -0
  311. package/dist/esm/modules/uid/helper.js.map +1 -1
  312. package/dist/esm/modules/uid/opaque.js.map +1 -1
  313. package/dist/esm/modules/uid/uuid/helper.js.map +1 -1
  314. package/dist/esm/modules/uid/uuid/sha1.js.map +1 -1
  315. package/dist/esm/modules/uid/uuid/v4.d.ts +1 -0
  316. package/dist/esm/modules/uid/uuid/v4.js +1 -0
  317. package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
  318. package/dist/esm/modules/uid/uuid/v5.d.ts +1 -0
  319. package/dist/esm/modules/uid/uuid/v5.js +1 -0
  320. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  321. package/dist/esm/modules/uid/uuid/v7.d.ts +1 -0
  322. package/dist/esm/modules/uid/uuid/v7.js +1 -0
  323. package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
  324. package/dist/esm/modules/worker-thread/bus/abstract.d.ts +1 -0
  325. package/dist/esm/modules/worker-thread/bus/abstract.js +1 -0
  326. package/dist/esm/modules/worker-thread/bus/abstract.js.map +1 -1
  327. package/dist/esm/modules/worker-thread/bus/base.d.ts +1 -0
  328. package/dist/esm/modules/worker-thread/bus/base.js +1 -0
  329. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  330. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts +1 -0
  331. package/dist/esm/modules/worker-thread/bus/handler/abstract.js +1 -0
  332. package/dist/esm/modules/worker-thread/bus/handler/abstract.js.map +1 -1
  333. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts +1 -0
  334. package/dist/esm/modules/worker-thread/bus/handler/base.js +1 -0
  335. package/dist/esm/modules/worker-thread/bus/handler/base.js.map +1 -1
  336. package/dist/esm/modules/worker-thread/common/types.d.ts +4 -0
  337. package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
  338. package/dist/esm/modules/worker-thread/thread/abstract.d.ts +1 -0
  339. package/dist/esm/modules/worker-thread/thread/abstract.js +1 -0
  340. package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
  341. package/dist/esm/modules/worker-thread/thread/base.d.ts +1 -0
  342. package/dist/esm/modules/worker-thread/thread/base.js +1 -0
  343. package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
  344. package/dist/esm/modules/worker-thread/worker/abstract.d.ts +1 -0
  345. package/dist/esm/modules/worker-thread/worker/abstract.js +1 -0
  346. package/dist/esm/modules/worker-thread/worker/abstract.js.map +1 -1
  347. package/dist/esm/modules/worker-thread/worker/base.d.ts +1 -0
  348. package/dist/esm/modules/worker-thread/worker/base.js +1 -0
  349. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  350. package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -0
  351. package/dist/esm/modules/worker-thread/worker-pool.js +1 -0
  352. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  353. package/dist/esm/utilities/error.utility.d.ts +1 -0
  354. package/dist/esm/utilities/error.utility.js +1 -0
  355. package/dist/esm/utilities/error.utility.js.map +1 -1
  356. package/dist/esm/utilities/form-body.utility.d.ts +1 -0
  357. package/dist/esm/utilities/form-body.utility.js +1 -0
  358. package/dist/esm/utilities/form-body.utility.js.map +1 -1
  359. package/dist/esm/utilities/hr-time.utility.d.ts +1 -0
  360. package/dist/esm/utilities/hr-time.utility.js +1 -0
  361. package/dist/esm/utilities/hr-time.utility.js.map +1 -1
  362. package/dist/esm/utilities/module.utility.js.map +1 -1
  363. package/dist/esm/utilities/parse.utility.js.map +1 -1
  364. package/dist/esm/utilities/performance.utility.d.ts +1 -0
  365. package/dist/esm/utilities/performance.utility.js +1 -0
  366. package/dist/esm/utilities/performance.utility.js.map +1 -1
  367. package/dist/esm/utilities/promise.utility.d.ts +1 -0
  368. package/dist/esm/utilities/promise.utility.js.map +1 -1
  369. package/dist/esm/utilities/request.utility.d.ts +2 -0
  370. package/dist/esm/utilities/request.utility.js +1 -0
  371. package/dist/esm/utilities/request.utility.js.map +1 -1
  372. package/package.json +4 -4
  373. package/dist/esm/common/constants/app.d.ts.map +0 -1
  374. package/dist/esm/common/constants/duration.d.ts.map +0 -1
  375. package/dist/esm/common/constants/grpc.d.ts.map +0 -1
  376. package/dist/esm/common/constants/http.d.ts.map +0 -1
  377. package/dist/esm/common/constants/index.d.ts.map +0 -1
  378. package/dist/esm/common/constants/mime.d.ts.map +0 -1
  379. package/dist/esm/common/index.d.ts.map +0 -1
  380. package/dist/esm/common/jsx.d.ts.map +0 -1
  381. package/dist/esm/common/redact.d.ts.map +0 -1
  382. package/dist/esm/common/resolvers.d.ts.map +0 -1
  383. package/dist/esm/common/types/class.d.ts.map +0 -1
  384. package/dist/esm/common/types/const-value.d.ts.map +0 -1
  385. package/dist/esm/common/types/field-mapping.d.ts.map +0 -1
  386. package/dist/esm/common/types/index.d.ts.map +0 -1
  387. package/dist/esm/common/types/injection.d.ts.map +0 -1
  388. package/dist/esm/common/types/resolver.d.ts.map +0 -1
  389. package/dist/esm/common/types/utility.d.ts.map +0 -1
  390. package/dist/esm/core.d.ts.map +0 -1
  391. package/dist/esm/index.d.ts.map +0 -1
  392. package/dist/esm/modules/base.d.ts.map +0 -1
  393. package/dist/esm/modules/cron/helper.d.ts.map +0 -1
  394. package/dist/esm/modules/cron/index.d.ts.map +0 -1
  395. package/dist/esm/modules/crypto/algorithms/abstract.algorithm.d.ts.map +0 -1
  396. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts.map +0 -1
  397. package/dist/esm/modules/crypto/algorithms/aes.constants.d.ts.map +0 -1
  398. package/dist/esm/modules/crypto/algorithms/aes.engine.d.ts.map +0 -1
  399. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts.map +0 -1
  400. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts.map +0 -1
  401. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts.map +0 -1
  402. package/dist/esm/modules/crypto/algorithms/hash.algorithm.d.ts.map +0 -1
  403. package/dist/esm/modules/crypto/algorithms/index.d.ts.map +0 -1
  404. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts.map +0 -1
  405. package/dist/esm/modules/crypto/common/constants.d.ts.map +0 -1
  406. package/dist/esm/modules/crypto/common/index.d.ts.map +0 -1
  407. package/dist/esm/modules/crypto/common/types.d.ts.map +0 -1
  408. package/dist/esm/modules/crypto/index.d.ts.map +0 -1
  409. package/dist/esm/modules/env/app-env.d.ts.map +0 -1
  410. package/dist/esm/modules/env/common/index.d.ts.map +0 -1
  411. package/dist/esm/modules/env/common/types.d.ts.map +0 -1
  412. package/dist/esm/modules/env/index.d.ts.map +0 -1
  413. package/dist/esm/modules/env/names.d.ts.map +0 -1
  414. package/dist/esm/modules/error/index.d.ts.map +0 -1
  415. package/dist/esm/modules/index.d.ts.map +0 -1
  416. package/dist/esm/modules/logger/base/abstract.d.ts.map +0 -1
  417. package/dist/esm/modules/logger/base/base.d.ts.map +0 -1
  418. package/dist/esm/modules/logger/base/console.d.ts.map +0 -1
  419. package/dist/esm/modules/logger/base/index.d.ts.map +0 -1
  420. package/dist/esm/modules/logger/common/constants.d.ts.map +0 -1
  421. package/dist/esm/modules/logger/common/debug-gate.d.ts.map +0 -1
  422. package/dist/esm/modules/logger/common/index.d.ts.map +0 -1
  423. package/dist/esm/modules/logger/common/types.d.ts.map +0 -1
  424. package/dist/esm/modules/logger/factory.d.ts.map +0 -1
  425. package/dist/esm/modules/logger/formatting/deep-splat.d.ts.map +0 -1
  426. package/dist/esm/modules/logger/formatting/error-prettier.d.ts.map +0 -1
  427. package/dist/esm/modules/logger/formatting/index.d.ts.map +0 -1
  428. package/dist/esm/modules/logger/hf/common/constants.d.ts.map +0 -1
  429. package/dist/esm/modules/logger/hf/common/index.d.ts.map +0 -1
  430. package/dist/esm/modules/logger/hf/common/types.d.ts.map +0 -1
  431. package/dist/esm/modules/logger/hf/flusher.d.ts.map +0 -1
  432. package/dist/esm/modules/logger/hf/index.d.ts.map +0 -1
  433. package/dist/esm/modules/logger/hf/logger.d.ts.map +0 -1
  434. package/dist/esm/modules/logger/hf/ring.d.ts.map +0 -1
  435. package/dist/esm/modules/logger/index.d.ts.map +0 -1
  436. package/dist/esm/modules/logger/pino/backing.d.ts.map +0 -1
  437. package/dist/esm/modules/logger/pino/common/constants.d.ts.map +0 -1
  438. package/dist/esm/modules/logger/pino/common/index.d.ts.map +0 -1
  439. package/dist/esm/modules/logger/pino/common/types.d.ts.map +0 -1
  440. package/dist/esm/modules/logger/pino/destination.d.ts.map +0 -1
  441. package/dist/esm/modules/logger/pino/index.d.ts.map +0 -1
  442. package/dist/esm/modules/logger/pino/logger.d.ts.map +0 -1
  443. package/dist/esm/modules/logger/winston/common/constants.d.ts.map +0 -1
  444. package/dist/esm/modules/logger/winston/common/index.d.ts.map +0 -1
  445. package/dist/esm/modules/logger/winston/common/types.d.ts.map +0 -1
  446. package/dist/esm/modules/logger/winston/define.d.ts.map +0 -1
  447. package/dist/esm/modules/logger/winston/formats.d.ts.map +0 -1
  448. package/dist/esm/modules/logger/winston/index.d.ts.map +0 -1
  449. package/dist/esm/modules/logger/winston/logger-factory.d.ts.map +0 -1
  450. package/dist/esm/modules/logger/winston/logger.d.ts.map +0 -1
  451. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts.map +0 -1
  452. package/dist/esm/modules/logger/winston/transports/index.d.ts.map +0 -1
  453. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts.map +0 -1
  454. package/dist/esm/modules/network/http-request/common/constants.d.ts.map +0 -1
  455. package/dist/esm/modules/network/http-request/common/index.d.ts.map +0 -1
  456. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts.map +0 -1
  457. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +0 -1
  458. package/dist/esm/modules/network/http-request/fetcher/common/index.d.ts.map +0 -1
  459. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts.map +0 -1
  460. package/dist/esm/modules/network/http-request/fetcher/index.d.ts.map +0 -1
  461. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +0 -1
  462. package/dist/esm/modules/network/http-request/index.d.ts.map +0 -1
  463. package/dist/esm/modules/network/index.d.ts.map +0 -1
  464. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts.map +0 -1
  465. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +0 -1
  466. package/dist/esm/modules/network/tcp-socket/index.d.ts.map +0 -1
  467. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts.map +0 -1
  468. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts.map +0 -1
  469. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts.map +0 -1
  470. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts.map +0 -1
  471. package/dist/esm/modules/network/udp-socket/index.d.ts.map +0 -1
  472. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts.map +0 -1
  473. package/dist/esm/modules/network/utilities/index.d.ts.map +0 -1
  474. package/dist/esm/modules/network/utilities/query-string.d.ts.map +0 -1
  475. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts.map +0 -1
  476. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts.map +0 -1
  477. package/dist/esm/modules/network/utilities/url-safety/common/index.d.ts.map +0 -1
  478. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts.map +0 -1
  479. package/dist/esm/modules/network/utilities/url-safety/index.d.ts.map +0 -1
  480. package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts.map +0 -1
  481. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts.map +0 -1
  482. package/dist/esm/modules/pool/abstract.d.ts.map +0 -1
  483. package/dist/esm/modules/pool/base.d.ts.map +0 -1
  484. package/dist/esm/modules/pool/common/index.d.ts.map +0 -1
  485. package/dist/esm/modules/pool/common/types.d.ts.map +0 -1
  486. package/dist/esm/modules/pool/index.d.ts.map +0 -1
  487. package/dist/esm/modules/queue/bullmq/helper.d.ts.map +0 -1
  488. package/dist/esm/modules/queue/bullmq/index.d.ts.map +0 -1
  489. package/dist/esm/modules/queue/common/constants.d.ts.map +0 -1
  490. package/dist/esm/modules/queue/common/hook.d.ts.map +0 -1
  491. package/dist/esm/modules/queue/common/index.d.ts.map +0 -1
  492. package/dist/esm/modules/queue/index.d.ts.map +0 -1
  493. package/dist/esm/modules/queue/internal/hf/common/index.d.ts.map +0 -1
  494. package/dist/esm/modules/queue/internal/hf/common/types.d.ts.map +0 -1
  495. package/dist/esm/modules/queue/internal/hf/helper.d.ts.map +0 -1
  496. package/dist/esm/modules/queue/internal/hf/index.d.ts.map +0 -1
  497. package/dist/esm/modules/queue/internal/index.d.ts.map +0 -1
  498. package/dist/esm/modules/queue/internal/sequential/common/index.d.ts.map +0 -1
  499. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts.map +0 -1
  500. package/dist/esm/modules/queue/internal/sequential/helper.d.ts.map +0 -1
  501. package/dist/esm/modules/queue/internal/sequential/index.d.ts.map +0 -1
  502. package/dist/esm/modules/queue/kafka/admin.d.ts.map +0 -1
  503. package/dist/esm/modules/queue/kafka/base.d.ts.map +0 -1
  504. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts.map +0 -1
  505. package/dist/esm/modules/queue/kafka/bundler/common/index.d.ts.map +0 -1
  506. package/dist/esm/modules/queue/kafka/bundler/index.d.ts.map +0 -1
  507. package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts.map +0 -1
  508. package/dist/esm/modules/queue/kafka/common/constants.d.ts.map +0 -1
  509. package/dist/esm/modules/queue/kafka/common/index.d.ts.map +0 -1
  510. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts.map +0 -1
  511. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts.map +0 -1
  512. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts.map +0 -1
  513. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts.map +0 -1
  514. package/dist/esm/modules/queue/kafka/common/types/index.d.ts.map +0 -1
  515. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts.map +0 -1
  516. package/dist/esm/modules/queue/kafka/consumer.d.ts.map +0 -1
  517. package/dist/esm/modules/queue/kafka/index.d.ts.map +0 -1
  518. package/dist/esm/modules/queue/kafka/producer.d.ts.map +0 -1
  519. package/dist/esm/modules/queue/kafka/schema/index.d.ts.map +0 -1
  520. package/dist/esm/modules/queue/kafka/schema/registry.d.ts.map +0 -1
  521. package/dist/esm/modules/queue/mqtt/helper.d.ts.map +0 -1
  522. package/dist/esm/modules/queue/mqtt/index.d.ts.map +0 -1
  523. package/dist/esm/modules/redis/base/abstract.helper.d.ts.map +0 -1
  524. package/dist/esm/modules/redis/base/index.d.ts.map +0 -1
  525. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts.map +0 -1
  526. package/dist/esm/modules/redis/cluster/index.d.ts.map +0 -1
  527. package/dist/esm/modules/redis/common/constants.d.ts.map +0 -1
  528. package/dist/esm/modules/redis/common/index.d.ts.map +0 -1
  529. package/dist/esm/modules/redis/common/interfaces.d.ts.map +0 -1
  530. package/dist/esm/modules/redis/common/types.d.ts.map +0 -1
  531. package/dist/esm/modules/redis/factory.d.ts.map +0 -1
  532. package/dist/esm/modules/redis/index.d.ts.map +0 -1
  533. package/dist/esm/modules/redis/sentinel/index.d.ts.map +0 -1
  534. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts.map +0 -1
  535. package/dist/esm/modules/redis/single/index.d.ts.map +0 -1
  536. package/dist/esm/modules/redis/single/single.helper.d.ts.map +0 -1
  537. package/dist/esm/modules/redis/utility.d.ts.map +0 -1
  538. package/dist/esm/modules/retry/common/constants.d.ts.map +0 -1
  539. package/dist/esm/modules/retry/common/index.d.ts.map +0 -1
  540. package/dist/esm/modules/retry/common/types.d.ts.map +0 -1
  541. package/dist/esm/modules/retry/helper.d.ts.map +0 -1
  542. package/dist/esm/modules/retry/index.d.ts.map +0 -1
  543. package/dist/esm/modules/secrets/base/abstract.helper.d.ts.map +0 -1
  544. package/dist/esm/modules/secrets/base/index.d.ts.map +0 -1
  545. package/dist/esm/modules/secrets/common/constants.d.ts.map +0 -1
  546. package/dist/esm/modules/secrets/common/index.d.ts.map +0 -1
  547. package/dist/esm/modules/secrets/common/types/helper.d.ts.map +0 -1
  548. package/dist/esm/modules/secrets/common/types/index.d.ts.map +0 -1
  549. package/dist/esm/modules/secrets/common/types/lease.d.ts.map +0 -1
  550. package/dist/esm/modules/secrets/common/types/registration.d.ts.map +0 -1
  551. package/dist/esm/modules/secrets/common/types/timer.d.ts.map +0 -1
  552. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts.map +0 -1
  553. package/dist/esm/modules/secrets/dotenv/index.d.ts.map +0 -1
  554. package/dist/esm/modules/secrets/factory.d.ts.map +0 -1
  555. package/dist/esm/modules/secrets/hashicorp/auth.d.ts.map +0 -1
  556. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts.map +0 -1
  557. package/dist/esm/modules/secrets/hashicorp/index.d.ts.map +0 -1
  558. package/dist/esm/modules/secrets/index.d.ts.map +0 -1
  559. package/dist/esm/modules/secrets/system-envs/index.d.ts.map +0 -1
  560. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts.map +0 -1
  561. package/dist/esm/modules/slug/common/constants.d.ts.map +0 -1
  562. package/dist/esm/modules/slug/common/index.d.ts.map +0 -1
  563. package/dist/esm/modules/slug/helper.d.ts.map +0 -1
  564. package/dist/esm/modules/slug/index.d.ts.map +0 -1
  565. package/dist/esm/modules/socket/index.d.ts.map +0 -1
  566. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +0 -1
  567. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +0 -1
  568. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +0 -1
  569. package/dist/esm/modules/socket/socket-io/client/index.d.ts.map +0 -1
  570. package/dist/esm/modules/socket/socket-io/common/constants.d.ts.map +0 -1
  571. package/dist/esm/modules/socket/socket-io/common/index.d.ts.map +0 -1
  572. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts.map +0 -1
  573. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts.map +0 -1
  574. package/dist/esm/modules/socket/socket-io/common/types/index.d.ts.map +0 -1
  575. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts.map +0 -1
  576. package/dist/esm/modules/socket/socket-io/index.d.ts.map +0 -1
  577. package/dist/esm/modules/socket/socket-io/server/helper.d.ts.map +0 -1
  578. package/dist/esm/modules/socket/socket-io/server/index.d.ts.map +0 -1
  579. package/dist/esm/modules/socket/websocket/common/constants.d.ts.map +0 -1
  580. package/dist/esm/modules/socket/websocket/common/index.d.ts.map +0 -1
  581. package/dist/esm/modules/socket/websocket/common/types/client.d.ts.map +0 -1
  582. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts.map +0 -1
  583. package/dist/esm/modules/socket/websocket/common/types/index.d.ts.map +0 -1
  584. package/dist/esm/modules/socket/websocket/common/types/message.d.ts.map +0 -1
  585. package/dist/esm/modules/socket/websocket/common/types/server.d.ts.map +0 -1
  586. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts.map +0 -1
  587. package/dist/esm/modules/socket/websocket/emitter/index.d.ts.map +0 -1
  588. package/dist/esm/modules/socket/websocket/index.d.ts.map +0 -1
  589. package/dist/esm/modules/socket/websocket/server/delivery.d.ts.map +0 -1
  590. package/dist/esm/modules/socket/websocket/server/helper.d.ts.map +0 -1
  591. package/dist/esm/modules/socket/websocket/server/index.d.ts.map +0 -1
  592. package/dist/esm/modules/storage/base.d.ts.map +0 -1
  593. package/dist/esm/modules/storage/bun-s3/helper.d.ts.map +0 -1
  594. package/dist/esm/modules/storage/bun-s3/index.d.ts.map +0 -1
  595. package/dist/esm/modules/storage/bun-s3/utility.d.ts.map +0 -1
  596. package/dist/esm/modules/storage/common/constants.d.ts.map +0 -1
  597. package/dist/esm/modules/storage/common/errors.d.ts.map +0 -1
  598. package/dist/esm/modules/storage/common/index.d.ts.map +0 -1
  599. package/dist/esm/modules/storage/common/types.d.ts.map +0 -1
  600. package/dist/esm/modules/storage/common/utility.d.ts.map +0 -1
  601. package/dist/esm/modules/storage/disk/helper.d.ts.map +0 -1
  602. package/dist/esm/modules/storage/disk/index.d.ts.map +0 -1
  603. package/dist/esm/modules/storage/in-memory/helper.d.ts.map +0 -1
  604. package/dist/esm/modules/storage/in-memory/index.d.ts.map +0 -1
  605. package/dist/esm/modules/storage/index.d.ts.map +0 -1
  606. package/dist/esm/modules/temporal/abstract.d.ts.map +0 -1
  607. package/dist/esm/modules/temporal/adapters/dayjs.d.ts.map +0 -1
  608. package/dist/esm/modules/temporal/adapters/index.d.ts.map +0 -1
  609. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +0 -1
  610. package/dist/esm/modules/temporal/adapters/luxon.d.ts.map +0 -1
  611. package/dist/esm/modules/temporal/adapters/native.d.ts.map +0 -1
  612. package/dist/esm/modules/temporal/calendar/calendar.d.ts.map +0 -1
  613. package/dist/esm/modules/temporal/calendar/index.d.ts.map +0 -1
  614. package/dist/esm/modules/temporal/common/constants.d.ts.map +0 -1
  615. package/dist/esm/modules/temporal/common/index.d.ts.map +0 -1
  616. package/dist/esm/modules/temporal/common/types.d.ts.map +0 -1
  617. package/dist/esm/modules/temporal/duration/duration.d.ts.map +0 -1
  618. package/dist/esm/modules/temporal/duration/index.d.ts.map +0 -1
  619. package/dist/esm/modules/temporal/helper.d.ts.map +0 -1
  620. package/dist/esm/modules/temporal/index.d.ts.map +0 -1
  621. package/dist/esm/modules/temporal/locale/index.d.ts.map +0 -1
  622. package/dist/esm/modules/temporal/locale/locale.d.ts.map +0 -1
  623. package/dist/esm/modules/temporal/pattern/common/constants.d.ts.map +0 -1
  624. package/dist/esm/modules/temporal/pattern/common/index.d.ts.map +0 -1
  625. package/dist/esm/modules/temporal/pattern/common/types.d.ts.map +0 -1
  626. package/dist/esm/modules/temporal/pattern/index.d.ts.map +0 -1
  627. package/dist/esm/modules/temporal/pattern/pattern.d.ts.map +0 -1
  628. package/dist/esm/modules/temporal/pattern/tokens.d.ts.map +0 -1
  629. package/dist/esm/modules/tree/builder.d.ts.map +0 -1
  630. package/dist/esm/modules/tree/common/index.d.ts.map +0 -1
  631. package/dist/esm/modules/tree/common/types.d.ts.map +0 -1
  632. package/dist/esm/modules/tree/index.d.ts.map +0 -1
  633. package/dist/esm/modules/tree/walk.d.ts.map +0 -1
  634. package/dist/esm/modules/uid/common/constants.d.ts.map +0 -1
  635. package/dist/esm/modules/uid/common/index.d.ts.map +0 -1
  636. package/dist/esm/modules/uid/common/types.d.ts.map +0 -1
  637. package/dist/esm/modules/uid/helper.d.ts.map +0 -1
  638. package/dist/esm/modules/uid/index.d.ts.map +0 -1
  639. package/dist/esm/modules/uid/opaque.d.ts.map +0 -1
  640. package/dist/esm/modules/uid/request-id.d.ts.map +0 -1
  641. package/dist/esm/modules/uid/uuid/common/constants.d.ts.map +0 -1
  642. package/dist/esm/modules/uid/uuid/common/index.d.ts.map +0 -1
  643. package/dist/esm/modules/uid/uuid/common/types.d.ts.map +0 -1
  644. package/dist/esm/modules/uid/uuid/helper.d.ts.map +0 -1
  645. package/dist/esm/modules/uid/uuid/index.d.ts.map +0 -1
  646. package/dist/esm/modules/uid/uuid/sha1.d.ts.map +0 -1
  647. package/dist/esm/modules/uid/uuid/v4.d.ts.map +0 -1
  648. package/dist/esm/modules/uid/uuid/v5.d.ts.map +0 -1
  649. package/dist/esm/modules/uid/uuid/v7.d.ts.map +0 -1
  650. package/dist/esm/modules/worker-thread/bus/abstract.d.ts.map +0 -1
  651. package/dist/esm/modules/worker-thread/bus/base.d.ts.map +0 -1
  652. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts.map +0 -1
  653. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts.map +0 -1
  654. package/dist/esm/modules/worker-thread/bus/handler/index.d.ts.map +0 -1
  655. package/dist/esm/modules/worker-thread/bus/index.d.ts.map +0 -1
  656. package/dist/esm/modules/worker-thread/common/index.d.ts.map +0 -1
  657. package/dist/esm/modules/worker-thread/common/types.d.ts.map +0 -1
  658. package/dist/esm/modules/worker-thread/index.d.ts.map +0 -1
  659. package/dist/esm/modules/worker-thread/thread/abstract.d.ts.map +0 -1
  660. package/dist/esm/modules/worker-thread/thread/base.d.ts.map +0 -1
  661. package/dist/esm/modules/worker-thread/thread/index.d.ts.map +0 -1
  662. package/dist/esm/modules/worker-thread/worker/abstract.d.ts.map +0 -1
  663. package/dist/esm/modules/worker-thread/worker/base.d.ts.map +0 -1
  664. package/dist/esm/modules/worker-thread/worker/index.d.ts.map +0 -1
  665. package/dist/esm/modules/worker-thread/worker-pool.d.ts.map +0 -1
  666. package/dist/esm/temporal.d.ts.map +0 -1
  667. package/dist/esm/utilities/build-info.utility.d.ts.map +0 -1
  668. package/dist/esm/utilities/error.utility.d.ts.map +0 -1
  669. package/dist/esm/utilities/form-body.utility.d.ts.map +0 -1
  670. package/dist/esm/utilities/hr-time.utility.d.ts.map +0 -1
  671. package/dist/esm/utilities/index.d.ts.map +0 -1
  672. package/dist/esm/utilities/module.utility.d.ts.map +0 -1
  673. package/dist/esm/utilities/parse.utility.d.ts.map +0 -1
  674. package/dist/esm/utilities/performance.utility.d.ts.map +0 -1
  675. package/dist/esm/utilities/project-root.utility.d.ts.map +0 -1
  676. package/dist/esm/utilities/promise.utility.d.ts.map +0 -1
  677. package/dist/esm/utilities/request.utility.d.ts.map +0 -1
  678. package/dist/esm/uuid.d.ts.map +0 -1
@@ -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 { RedactUtility } 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 {\n message: util.inspect(RedactUtility.redactSecrets({ value }), this.INSPECT_OPTIONS),\n };\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 = RedactUtility.redactSecrets({ value: 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 = RedactUtility.redactSecrets({ value: 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(\n `args: ${util.inspect(RedactUtility.redactSecrets({ value: summary.args }), inspectOptions)}`,\n );\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(\n `extra: ${util.inspect(RedactUtility.redactSecrets({ value: context }), inspectOptions)}`,\n );\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 { RedactUtility } 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\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\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\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\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\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\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\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 {\n message: util.inspect(RedactUtility.redactSecrets({ value }), this.INSPECT_OPTIONS),\n };\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\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\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 = RedactUtility.redactSecrets({ value: 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\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\n if (context !== undefined && Object.keys(context).length > 0) {\n payload.extra = RedactUtility.redactSecrets({ value: 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(\n `args: ${util.inspect(RedactUtility.redactSecrets({ value: summary.args }), inspectOptions)}`,\n );\n }\n\n this.pushAggregatedErrors({ node: summary, lines });\n\n let cause = summary.cause;\n\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\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(\n `extra: ${util.inspect(RedactUtility.redactSecrets({ value: context }), inspectOptions)}`,\n );\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,18 +1,23 @@
1
1
  import type { TLogLevel } from '../../common/index.js';
2
2
  /** The levels the high-frequency logger writes: the shared log levels. */
3
3
  export type THfLogLevel = TLogLevel;
4
+ /** One batch handed to a sink: the rendered `lines`, and `dropped`, the number of entries overwritten in the ring before they could be read. */
4
5
  export type THfSinkBatch = {
5
6
  lines: Array<string>;
6
7
  dropped: number;
7
8
  };
8
9
  /** Declared `=> void` ON PURPOSE: TS's void-return exemption lets both sync and `async` sinks assign to it (`void | Promise<void>` would reject the sync form); the flusher still awaits a returned thenable, so a rejection is caught and logged, never unhandled. */
9
10
  export type THfSink = (batch: THfSinkBatch) => void;
11
+ /** Where the high-frequency logger flusher delivers batches: a custom `sink`, a `filePath`, or stdout when neither is set. */
10
12
  export interface IHfLogFlusherOptions {
11
13
  /** Full custom delivery. Overrides filePath. */
12
14
  sink?: THfSink;
13
- /** Default sink appends here instead of writing to stdout. */
15
+ /** File the default sink appends to instead of writing to stdout. */
14
16
  filePath?: string;
15
- /** Entries rendered per batch before yielding. Defaults to HF_DEFAULT_BATCH_SIZE. */
17
+ /**
18
+ * Entries rendered per batch before yielding.
19
+ * @default HF_DEFAULT_BATCH_SIZE
20
+ */
16
21
  batchSize?: number;
17
22
  }
18
23
  export type TRingState = {
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/hf/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TLogLevel } from '../../common';\n\n/** The levels the high-frequency logger writes: the shared log levels. */\nexport type THfLogLevel = TLogLevel;\n\nexport type THfSinkBatch = { lines: Array<string>; dropped: number };\n\n/** Declared `=> void` ON PURPOSE: TS's void-return exemption lets both sync and `async` sinks assign to it (`void | Promise<void>` would reject the sync form); the flusher still awaits a returned thenable, so a rejection is caught and logged, never unhandled. */\nexport type THfSink = (batch: THfSinkBatch) => void;\n\nexport interface IHfLogFlusherOptions {\n /** Full custom delivery. Overrides filePath. */\n sink?: THfSink;\n /** Default sink appends here instead of writing to stdout. */\n filePath?: string;\n /** Entries rendered per batch before yielding. Defaults to HF_DEFAULT_BATCH_SIZE. */\n batchSize?: number;\n}\n\nexport type TRingState = { bytes: Uint8Array; f64: Float64Array; writeIndex: number };\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/hf/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TLogLevel } from '../../common';\n\n/** The levels the high-frequency logger writes: the shared log levels. */\nexport type THfLogLevel = TLogLevel;\n\n/** One batch handed to a sink: the rendered `lines`, and `dropped`, the number of entries overwritten in the ring before they could be read. */\nexport type THfSinkBatch = { lines: Array<string>; dropped: number };\n\n/** Declared `=> void` ON PURPOSE: TS's void-return exemption lets both sync and `async` sinks assign to it (`void | Promise<void>` would reject the sync form); the flusher still awaits a returned thenable, so a rejection is caught and logged, never unhandled. */\nexport type THfSink = (batch: THfSinkBatch) => void;\n\n/** Where the high-frequency logger flusher delivers batches: a custom `sink`, a `filePath`, or stdout when neither is set. */\nexport interface IHfLogFlusherOptions {\n /** Full custom delivery. Overrides filePath. */\n sink?: THfSink;\n /** File the default sink appends to instead of writing to stdout. */\n filePath?: string;\n /**\n * Entries rendered per batch before yielding.\n * @default HF_DEFAULT_BATCH_SIZE\n */\n batchSize?: number;\n}\n\nexport type TRingState = { bytes: Uint8Array; f64: Float64Array; writeIndex: number };\n"]}
@@ -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\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\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\n return;\n }\n\n process.stdout.write(rendered);\n };\n }\n\n flush(): Promise<void> {\n if (this.inFlightDrain) {\n return this.inFlightDrain;\n }\n\n this.inFlightDrain = this.drain().finally(() => {\n this.inFlightDrain = null;\n });\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\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\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\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 +1 @@
1
- {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { AbstractLogger } from '../base';\nimport { type ILogger, LogLevels, LoggerDebugGate, type TLogLevel } from '../common';\nimport { LogFormatUtility } from '../formatting';\nimport {\n BUFFER_SIZE,\n ENTRY_SIZE,\n HF_LEVEL_CODES,\n HF_MESSAGE_MAX_BYTES,\n HF_SCOPE_MAX_BYTES,\n MESSAGE_CACHE_CAP,\n OFFSET_LEVEL,\n OFFSET_MESSAGE,\n OFFSET_MESSAGE_LENGTH,\n OFFSET_SCOPE,\n OFFSET_SCOPE_LENGTH,\n type TRingState,\n} from './common';\nimport { HfLogRing } from './ring';\n\n/** Ring-buffer logger for hot paths; extends AbstractLogger, NOT BaseLogger - BaseLogger's string-sink plumbing is exactly the cost this implementation exists to avoid. */\nexport class HfLogger extends AbstractLogger {\n private static readonly textEncoder = new TextEncoder();\n private static readonly scopeCache = new Map<string, Uint8Array>();\n private static cache = new Map<string, HfLogger>();\n private static messageCache = new Map<string, Uint8Array>();\n\n private readonly scope: string;\n private readonly scopeBytes: Uint8Array;\n private readonly scopeLength: number;\n // Resolved once at construction (get() has already allocated the ring): saves a call and a null-check per log on a path budgeted in nanoseconds.\n private readonly ring: TRingState;\n\n private constructor(scope: string) {\n super();\n this.scope = scope;\n this.scopeBytes = HfLogger.encodeScope(scope);\n this.scopeLength = this.scopeBytes.length;\n this.ring = HfLogRing.get();\n }\n\n private static encodeScope(scope: string): Uint8Array {\n let bytes = HfLogger.scopeCache.get(scope);\n if (!bytes) {\n bytes = HfLogger.textEncoder.encode(scope).subarray(0, HF_SCOPE_MAX_BYTES);\n HfLogger.scopeCache.set(scope, bytes);\n }\n return bytes;\n }\n\n static get(scope: string): HfLogger {\n let logger = this.cache.get(scope);\n if (!logger) {\n logger = new HfLogger(scope); // first logger allocates the ring - never at import\n this.cache.set(scope, logger);\n }\n return logger;\n }\n\n /** Pre-encode a message at initialization time; the cache is FIFO-bounded so dynamic strings can't grow it without limit. */\n static encodeMessage(message: string): Uint8Array {\n const cached = this.messageCache.get(message);\n if (cached) {\n return cached;\n }\n\n const bytes = HfLogger.textEncoder.encode(message);\n if (this.messageCache.size >= MESSAGE_CACHE_CAP) {\n this.evictOldestMessage();\n }\n this.messageCache.set(message, bytes);\n return bytes;\n }\n\n private static evictOldestMessage(): void {\n const oldest = this.messageCache.keys().next().value;\n if (oldest === undefined) {\n return;\n }\n this.messageCache.delete(oldest);\n }\n\n private writeEntry(levelCode: number, messageBytes: Uint8Array): void {\n const ring = this.ring;\n const slot = ring.writeIndex++ & (BUFFER_SIZE - 1);\n const offset = slot * ENTRY_SIZE;\n ring.f64[offset >> 3] = performance.timeOrigin + performance.now();\n const bytes = ring.bytes;\n bytes[offset + OFFSET_LEVEL] = levelCode;\n bytes[offset + OFFSET_SCOPE_LENGTH] = this.scopeLength;\n bytes.set(this.scopeBytes, offset + OFFSET_SCOPE);\n const messageLength =\n messageBytes.length < HF_MESSAGE_MAX_BYTES ? messageBytes.length : HF_MESSAGE_MAX_BYTES;\n bytes[offset + OFFSET_MESSAGE_LENGTH] = messageLength;\n bytes.set(\n messageLength === messageBytes.length\n ? messageBytes\n : messageBytes.subarray(0, messageLength),\n offset + OFFSET_MESSAGE,\n );\n }\n\n private writeString(levelCode: number, message: string, args: Array<AnyType>): void {\n if (args.length > 0) {\n // Slow path, documented: args are formatted (deep inspection + redaction) - never dropped.\n this.writeEntry(\n levelCode,\n HfLogger.textEncoder.encode(LogFormatUtility.formatMessage({ message, args })),\n );\n return;\n }\n this.writeEntry(levelCode, HfLogger.encodeMessage(message));\n }\n\n debug(message: string, ...args: AnyType[]): void {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n this.writeString(HF_LEVEL_CODES.debug, message, args);\n }\n\n info(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.info, message, args);\n }\n\n warn(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.warn, message, args);\n }\n\n error(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.error, message, args);\n }\n\n emerg(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.emerg, message, args);\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]): void;\n log(level: TLogLevel, messageBytes: Uint8Array): void;\n log(level: TLogLevel, message: string | Uint8Array, ...args: AnyType[]): void {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return;\n }\n const levelCode = Object.hasOwn(HF_LEVEL_CODES, level)\n ? HF_LEVEL_CODES[level]\n : HF_LEVEL_CODES.info;\n if (typeof message === 'string') {\n this.writeString(levelCode, message, args);\n return;\n }\n this.writeEntry(levelCode, message);\n }\n\n for(methodName: string): ILogger {\n return HfLogger.get(`${this.scope}-${methodName}`);\n }\n}\n"]}
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { AbstractLogger } from '../base';\nimport { type ILogger, LogLevels, LoggerDebugGate, type TLogLevel } from '../common';\nimport { LogFormatUtility } from '../formatting';\nimport {\n BUFFER_SIZE,\n ENTRY_SIZE,\n HF_LEVEL_CODES,\n HF_MESSAGE_MAX_BYTES,\n HF_SCOPE_MAX_BYTES,\n MESSAGE_CACHE_CAP,\n OFFSET_LEVEL,\n OFFSET_MESSAGE,\n OFFSET_MESSAGE_LENGTH,\n OFFSET_SCOPE,\n OFFSET_SCOPE_LENGTH,\n type TRingState,\n} from './common';\nimport { HfLogRing } from './ring';\n\n/** Ring-buffer logger for hot paths; extends AbstractLogger, NOT BaseLogger - BaseLogger's string-sink plumbing is exactly the cost this implementation exists to avoid. */\nexport class HfLogger extends AbstractLogger {\n private static readonly textEncoder = new TextEncoder();\n private static readonly scopeCache = new Map<string, Uint8Array>();\n private static cache = new Map<string, HfLogger>();\n private static messageCache = new Map<string, Uint8Array>();\n\n private readonly scope: string;\n private readonly scopeBytes: Uint8Array;\n private readonly scopeLength: number;\n // Resolved once at construction (get() has already allocated the ring): saves a call and a null-check per log on a path budgeted in nanoseconds.\n private readonly ring: TRingState;\n\n private constructor(scope: string) {\n super();\n this.scope = scope;\n this.scopeBytes = HfLogger.encodeScope(scope);\n this.scopeLength = this.scopeBytes.length;\n this.ring = HfLogRing.get();\n }\n\n private static encodeScope(scope: string): Uint8Array {\n let bytes = HfLogger.scopeCache.get(scope);\n\n if (!bytes) {\n bytes = HfLogger.textEncoder.encode(scope).subarray(0, HF_SCOPE_MAX_BYTES);\n HfLogger.scopeCache.set(scope, bytes);\n }\n\n return bytes;\n }\n\n static get(scope: string): HfLogger {\n let logger = this.cache.get(scope);\n\n if (!logger) {\n logger = new HfLogger(scope); // first logger allocates the ring - never at import\n this.cache.set(scope, logger);\n }\n\n return logger;\n }\n\n /** Pre-encode a message at initialization time; the cache is FIFO-bounded so dynamic strings can't grow it without limit. */\n static encodeMessage(message: string): Uint8Array {\n const cached = this.messageCache.get(message);\n\n if (cached) {\n return cached;\n }\n\n const bytes = HfLogger.textEncoder.encode(message);\n\n if (this.messageCache.size >= MESSAGE_CACHE_CAP) {\n this.evictOldestMessage();\n }\n\n this.messageCache.set(message, bytes);\n\n return bytes;\n }\n\n private static evictOldestMessage(): void {\n const oldest = this.messageCache.keys().next().value;\n\n if (oldest === undefined) {\n return;\n }\n\n this.messageCache.delete(oldest);\n }\n\n private writeEntry(levelCode: number, messageBytes: Uint8Array): void {\n const ring = this.ring;\n const slot = ring.writeIndex++ & (BUFFER_SIZE - 1);\n const offset = slot * ENTRY_SIZE;\n ring.f64[offset >> 3] = performance.timeOrigin + performance.now();\n const bytes = ring.bytes;\n bytes[offset + OFFSET_LEVEL] = levelCode;\n bytes[offset + OFFSET_SCOPE_LENGTH] = this.scopeLength;\n bytes.set(this.scopeBytes, offset + OFFSET_SCOPE);\n const messageLength =\n messageBytes.length < HF_MESSAGE_MAX_BYTES ? messageBytes.length : HF_MESSAGE_MAX_BYTES;\n bytes[offset + OFFSET_MESSAGE_LENGTH] = messageLength;\n bytes.set(\n messageLength === messageBytes.length\n ? messageBytes\n : messageBytes.subarray(0, messageLength),\n offset + OFFSET_MESSAGE,\n );\n }\n\n private writeString(levelCode: number, message: string, args: Array<AnyType>): void {\n if (args.length > 0) {\n // Slow path, documented: args are formatted (deep inspection + redaction) - never dropped.\n this.writeEntry(\n levelCode,\n HfLogger.textEncoder.encode(LogFormatUtility.formatMessage({ message, args })),\n );\n\n return;\n }\n\n this.writeEntry(levelCode, HfLogger.encodeMessage(message));\n }\n\n debug(message: string, ...args: AnyType[]): void {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.writeString(HF_LEVEL_CODES.debug, message, args);\n }\n\n info(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.info, message, args);\n }\n\n warn(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.warn, message, args);\n }\n\n error(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.error, message, args);\n }\n\n emerg(message: string, ...args: AnyType[]): void {\n this.writeString(HF_LEVEL_CODES.emerg, message, args);\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]): void;\n log(level: TLogLevel, messageBytes: Uint8Array): void;\n log(level: TLogLevel, message: string | Uint8Array, ...args: AnyType[]): void {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return;\n }\n\n const levelCode = Object.hasOwn(HF_LEVEL_CODES, level)\n ? HF_LEVEL_CODES[level]\n : HF_LEVEL_CODES.info;\n\n if (typeof message === 'string') {\n this.writeString(levelCode, message, args);\n\n return;\n }\n\n this.writeEntry(levelCode, message);\n }\n\n for(methodName: string): ILogger {\n return HfLogger.get(`${this.scope}-${methodName}`);\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"ring.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/ring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAmB,MAAM,UAAU,CAAC;AAEpE,mKAAmK;AACnK,MAAM,OAAO,SAAS;aACL,UAAK,GAAsB,IAAI,CAAC;IAE/C,MAAM,CAAC,GAAG;QACR,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,WAAW,GAAG,UAAU,CAAC,CAAC;QACzD,SAAS,CAAC,KAAK,GAAG;YAChB,KAAK,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC;YAC7B,GAAG,EAAE,IAAI,YAAY,CAAC,MAAM,CAAC;YAC7B,UAAU,EAAE,CAAC;SACd,CAAC;QACF,OAAO,SAAS,CAAC,KAAK,CAAC;IACzB,CAAC","sourcesContent":["import { BUFFER_SIZE, ENTRY_SIZE, type TRingState } from './common';\n\n/** One ring per process, allocated on FIRST use. Plain ArrayBuffer on purpose - single hot thread design, so shared memory/atomics would only tax the hot path. */\nexport class HfLogRing {\n private static state: TRingState | null = null;\n\n static get(): TRingState {\n if (HfLogRing.state) {\n return HfLogRing.state;\n }\n\n const buffer = new ArrayBuffer(BUFFER_SIZE * ENTRY_SIZE);\n HfLogRing.state = {\n bytes: new Uint8Array(buffer),\n f64: new Float64Array(buffer),\n writeIndex: 0,\n };\n return HfLogRing.state;\n }\n}\n"]}
1
+ {"version":3,"file":"ring.js","sourceRoot":"","sources":["../../../../../src/modules/logger/hf/ring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAmB,MAAM,UAAU,CAAC;AAEpE,mKAAmK;AACnK,MAAM,OAAO,SAAS;aACL,UAAK,GAAsB,IAAI,CAAC;IAE/C,MAAM,CAAC,GAAG;QACR,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,WAAW,GAAG,UAAU,CAAC,CAAC;QACzD,SAAS,CAAC,KAAK,GAAG;YAChB,KAAK,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC;YAC7B,GAAG,EAAE,IAAI,YAAY,CAAC,MAAM,CAAC;YAC7B,UAAU,EAAE,CAAC;SACd,CAAC;QAEF,OAAO,SAAS,CAAC,KAAK,CAAC;IACzB,CAAC","sourcesContent":["import { BUFFER_SIZE, ENTRY_SIZE, type TRingState } from './common';\n\n/** One ring per process, allocated on FIRST use. Plain ArrayBuffer on purpose - single hot thread design, so shared memory/atomics would only tax the hot path. */\nexport class HfLogRing {\n private static state: TRingState | null = null;\n\n static get(): TRingState {\n if (HfLogRing.state) {\n return HfLogRing.state;\n }\n\n const buffer = new ArrayBuffer(BUFFER_SIZE * ENTRY_SIZE);\n HfLogRing.state = {\n bytes: new Uint8Array(buffer),\n f64: new Float64Array(buffer),\n writeIndex: 0,\n };\n\n return HfLogRing.state;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"backing.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/backing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAsB,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,oGAAoG;AACpG,MAAM,OAAO,iBAAiB;IAK5B,8KAA8K;IAC9K,MAAM,CAAC,YAAY;QACjB,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,gBAAgB;YAC/B,KAAK,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;YACzF,YAAY,EAAE,kBAAkB;SACjC,CAAC;IACJ,CAAC;IAED,sQAAsQ;IACtQ,MAAM,CAAC,GAAG;QACR,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACnF,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAC/B,iBAAiB,CAAC,YAAY,EAAE,EAChC,WAAW,CACK,CAAC;YACnB,iBAAiB,CAAC,SAAS,GAAG,WAAW,CAAC;QAC5C,CAAC;QACD,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED,4QAA4Q;IAC5Q,MAAM,CAAC,GAAG,CAAC,IAAiC;QAC1C,IAAI,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAC/B,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,iBAAiB,CAAC,cAAc,EAAE,CAAC;QACrC,CAAC;QAED,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3C,iBAAiB,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1C,CAAC;IAEO,MAAM,CAAC,cAAc;QAC3B,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACF,iBAAiB,CAAC,SAAqB,CAAC,GAAG,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kEAAkE,EAAE,KAAK,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;CACF","sourcesContent":["import { Defaults } from '@/common/constants';\nimport { type AnyType } from '@/common/types';\nimport pino from 'pino';\nimport { LoggerConfigUtility } from '../common';\n\nimport { PINO_CUSTOM_LEVELS, type TPinoInstance } from './common';\nimport { PinoDestination } from './destination';\n\n/** Owns the single pino instance every scope writes through, and the transport thread behind it. */\nexport class PinoBackingLogger {\n private static instance: TPinoInstance | undefined;\n /** The `ThreadStream` behind `instance`, held ONLY when built via a transport (pretty/roll) and `undefined` for `stdout` or an injected instance - tracked so a replacement can close the worker instead of orphaning it. */\n private static transport: pino.DestinationStream | undefined;\n\n /** Pure: pino constructor options derived from env at CALL time. Public so tests can build a REAL instance against an in-memory destination, without the impure singleton. */\n static buildOptions() {\n return {\n name: Defaults.APPLICATION_NAME,\n level: LoggerConfigUtility.resolveLevel({ configured: process.env.APP_ENV_LOGGER_LEVEL }),\n customLevels: PINO_CUSTOM_LEVELS,\n };\n }\n\n /** Lazy, env-driven singleton, built once and reused by every scope entirely synchronously - the very first log line already targets the real env-configured destination, no stdout bootstrap. `set()` is the only way to replace it; this getter never resets it. */\n static get(): TPinoInstance {\n if (!PinoBackingLogger.instance) {\n const destination = PinoDestination.build({ plan: PinoDestination.resolvePlan() });\n PinoBackingLogger.instance = pino(\n PinoBackingLogger.buildOptions(),\n destination,\n ) as TPinoInstance;\n PinoBackingLogger.transport = destination;\n }\n return PinoBackingLogger.instance;\n }\n\n /** Replaces the singleton outright: an outgoing transport-backed instance (pretty/roll) is a `ThreadStream` on a live worker thread, so this flushes then `.end()`s it first rather than orphaning the worker; failures are logged via `console.error`, never swallowed. */\n static set(opts: { instance: TPinoInstance }): void {\n if (PinoBackingLogger.instance) {\n PinoBackingLogger.instance.flush();\n PinoBackingLogger.closeTransport();\n }\n\n PinoBackingLogger.instance = opts.instance;\n PinoBackingLogger.transport = undefined;\n }\n\n private static closeTransport(): void {\n if (!PinoBackingLogger.transport) {\n return;\n }\n\n try {\n (PinoBackingLogger.transport as AnyType).end();\n } catch (error) {\n console.error('[setPinoBackingLogger] Failed to close previous transport stream', error);\n }\n }\n}\n"]}
1
+ {"version":3,"file":"backing.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/backing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAsB,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,oGAAoG;AACpG,MAAM,OAAO,iBAAiB;IAK5B,8KAA8K;IAC9K,MAAM,CAAC,YAAY;QACjB,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,gBAAgB;YAC/B,KAAK,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;YACzF,YAAY,EAAE,kBAAkB;SACjC,CAAC;IACJ,CAAC;IAED,sQAAsQ;IACtQ,MAAM,CAAC,GAAG;QACR,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACnF,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAC/B,iBAAiB,CAAC,YAAY,EAAE,EAChC,WAAW,CACK,CAAC;YACnB,iBAAiB,CAAC,SAAS,GAAG,WAAW,CAAC;QAC5C,CAAC;QAED,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED,4QAA4Q;IAC5Q,MAAM,CAAC,GAAG,CAAC,IAAiC;QAC1C,IAAI,iBAAiB,CAAC,QAAQ,EAAE,CAAC;YAC/B,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnC,iBAAiB,CAAC,cAAc,EAAE,CAAC;QACrC,CAAC;QAED,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3C,iBAAiB,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1C,CAAC;IAEO,MAAM,CAAC,cAAc;QAC3B,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACF,iBAAiB,CAAC,SAAqB,CAAC,GAAG,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kEAAkE,EAAE,KAAK,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;CACF","sourcesContent":["import { Defaults } from '@/common/constants';\nimport { type AnyType } from '@/common/types';\nimport pino from 'pino';\nimport { LoggerConfigUtility } from '../common';\n\nimport { PINO_CUSTOM_LEVELS, type TPinoInstance } from './common';\nimport { PinoDestination } from './destination';\n\n/** Owns the single pino instance every scope writes through, and the transport thread behind it. */\nexport class PinoBackingLogger {\n private static instance: TPinoInstance | undefined;\n /** The `ThreadStream` behind `instance`, held ONLY when built via a transport (pretty/roll) and `undefined` for `stdout` or an injected instance - tracked so a replacement can close the worker instead of orphaning it. */\n private static transport: pino.DestinationStream | undefined;\n\n /** Pure: pino constructor options derived from env at CALL time. Public so tests can build a REAL instance against an in-memory destination, without the impure singleton. */\n static buildOptions() {\n return {\n name: Defaults.APPLICATION_NAME,\n level: LoggerConfigUtility.resolveLevel({ configured: process.env.APP_ENV_LOGGER_LEVEL }),\n customLevels: PINO_CUSTOM_LEVELS,\n };\n }\n\n /** Lazy, env-driven singleton, built once and reused by every scope entirely synchronously - the very first log line already targets the real env-configured destination, no stdout bootstrap. `set()` is the only way to replace it; this getter never resets it. */\n static get(): TPinoInstance {\n if (!PinoBackingLogger.instance) {\n const destination = PinoDestination.build({ plan: PinoDestination.resolvePlan() });\n PinoBackingLogger.instance = pino(\n PinoBackingLogger.buildOptions(),\n destination,\n ) as TPinoInstance;\n PinoBackingLogger.transport = destination;\n }\n\n return PinoBackingLogger.instance;\n }\n\n /** Replaces the singleton outright: an outgoing transport-backed instance (pretty/roll) is a `ThreadStream` on a live worker thread, so this flushes then `.end()`s it first rather than orphaning the worker; failures are logged via `console.error`, never swallowed. */\n static set(opts: { instance: TPinoInstance }): void {\n if (PinoBackingLogger.instance) {\n PinoBackingLogger.instance.flush();\n PinoBackingLogger.closeTransport();\n }\n\n PinoBackingLogger.instance = opts.instance;\n PinoBackingLogger.transport = undefined;\n }\n\n private static closeTransport(): void {\n if (!PinoBackingLogger.transport) {\n return;\n }\n\n try {\n (PinoBackingLogger.transport as AnyType).end();\n } catch (error) {\n console.error('[setPinoBackingLogger] Failed to close previous transport stream', error);\n }\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"destination.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/destination.ts"],"names":[],"mappings":"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","sourcesContent":["import { Defaults } from '@/common/constants';\nimport { ParseUtility } from '@/utilities/parse.utility';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport path from 'node:path';\nimport pino from 'pino';\nimport { LoggerFormats, LoggerConfigUtility } from '../common';\n\nimport { PinoFrequencies, type TFrequency } from './common';\n\n/** Pure description of where pino should write, derived from env; `PinoDestination.build()` is the impure half that acts on it. */\nexport type TDestinationPlan =\n | { kind: 'stdout' }\n | { kind: 'pretty' }\n | {\n kind: 'roll';\n options: {\n file: string;\n frequency: TFrequency;\n size: string;\n limit: { count: number };\n mkdir: true;\n };\n };\n\n/** Reads `APP_ENV_LOGGER_*` and turns it into a destination. Warning prefixes name the operation, not the class - the tests and the published API still call these `mapFrequency`/`mapMaxFilesToCount`. */\nexport class PinoDestination {\n private static readonly DEFAULT_FREQUENCY: TFrequency = PinoFrequencies.HOURLY;\n private static readonly DEFAULT_MAX_FILES = '5d';\n\n /** `APP_ENV_LOGGER_FILE_FREQUENCY` -> pino-roll's `frequency`; an unrecognized value warns and falls back rather than throwing, so the app still boots. */\n static mapFrequency(opts: { value?: string }): TFrequency {\n const { value } = opts;\n const normalized = (value ?? '1h').trim().toLowerCase();\n\n switch (normalized) {\n case '1h': {\n return PinoFrequencies.HOURLY;\n }\n case '1d':\n case '24h': {\n return PinoFrequencies.DAILY;\n }\n default: {\n console.warn(\n '[mapFrequency] Invalid logger file frequency | value: %s | fallback: %s',\n value,\n PinoDestination.DEFAULT_FREQUENCY,\n );\n return PinoDestination.DEFAULT_FREQUENCY;\n }\n }\n }\n\n /** `null` means \"not a recognized shape\" - the caller decides what default to fall back to. */\n private static parseMaxFilesValue(value: string, frequency: TFrequency): number | null {\n const dayMatch = /^(\\d+)d$/i.exec(value);\n if (dayMatch) {\n const days = Number.parseInt(dayMatch[1], 10);\n return frequency === 'hourly' ? days * 24 : days;\n }\n\n const bareMatch = /^\\d+$/.exec(value);\n if (bareMatch) {\n return Number.parseInt(value, 10);\n }\n\n return null;\n }\n\n /** `APP_ENV_LOGGER_FILE_MAX_FILES` -> pino-roll's `limit.count`: `'<n>d'` scales by frequency (hourly: days*24), a bare integer is a literal count, unrecognized falls back to `'5d'`. */\n static mapMaxFilesToCount(opts: { value?: string; frequency: TFrequency }): number {\n const { value, frequency } = opts;\n const normalized = value?.trim();\n\n if (normalized) {\n const parsed = PinoDestination.parseMaxFilesValue(normalized, frequency);\n if (parsed !== null) {\n return parsed;\n }\n }\n\n // Unset is a normal configuration (mirror the sibling defaults) - only a PROVIDED value that failed to parse deserves a warning.\n if (normalized && normalized !== PinoDestination.DEFAULT_MAX_FILES) {\n console.warn(\n '[mapMaxFilesToCount] Invalid logger file max files value | value: %s | fallback: %s',\n value,\n PinoDestination.DEFAULT_MAX_FILES,\n );\n }\n\n return PinoDestination.parseMaxFilesValue(\n PinoDestination.DEFAULT_MAX_FILES,\n frequency,\n ) as number;\n }\n\n /** Pure: which destination pino should write to, derived from `APP_ENV_LOGGER_*` at CALL time. `DATE_PATTERN` is deliberately not read - pino-roll has no equivalent. */\n static resolvePlan(): TDestinationPlan {\n const folderPath = process.env.APP_ENV_LOGGER_FOLDER_PATH;\n\n if (folderPath && folderPath.trim() !== '') {\n const frequency = PinoDestination.mapFrequency({\n value: process.env.APP_ENV_LOGGER_FILE_FREQUENCY,\n });\n const count = PinoDestination.mapMaxFilesToCount({\n value: process.env.APP_ENV_LOGGER_FILE_MAX_FILES,\n frequency,\n });\n\n return {\n kind: 'roll',\n options: {\n file: path.join(folderPath, Defaults.APPLICATION_NAME),\n frequency,\n size:\n ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FILE_MAX_SIZE }) ??\n '100m',\n limit: { count },\n mkdir: true,\n },\n };\n }\n\n // UNSET means NDJSON to stdout, the locked default for this provider; only an EXPLICIT `text` opts into pino-pretty, and falling back to TEXT here (winston's default) would make the documented minimal install (pino only, no pino-pretty) crash on its first log line.\n if (process.env.APP_ENV_LOGGER_FORMAT === LoggerFormats.TEXT) {\n return { kind: 'pretty' };\n }\n\n return { kind: 'stdout' };\n }\n\n /** `pino.transport()` is SYNCHRONOUS - it returns a `ThreadStream` that BUFFERS writes until its worker thread loads, so no async gating is needed; `ModuleUtility.assertInstalled` runs first so a missing optional peer fails loudly here, not as an opaque worker-thread crash. */\n static build(opts: { plan: TDestinationPlan }): pino.DestinationStream | undefined {\n const { plan } = opts;\n\n switch (plan.kind) {\n case 'stdout': {\n return undefined;\n }\n case 'pretty': {\n ModuleUtility.assertInstalled({ scope: 'PinoLogger', modules: ['pino-pretty'] });\n\n // Only a decision is forwarded. Left alone, pino-pretty's own `isColorSupported` still\n // suppresses color when stdout is not a terminal - a check winston has no equivalent of.\n const colorize = LoggerConfigUtility.resolveColorize();\n return pino.transport({\n target: 'pino-pretty',\n ...(colorize === undefined ? {} : { options: { colorize } }),\n });\n }\n case 'roll': {\n ModuleUtility.assertInstalled({ scope: 'PinoLogger', modules: ['pino-roll'] });\n return pino.transport({ target: 'pino-roll', options: plan.options });\n }\n default: {\n return undefined;\n }\n }\n }\n}\n"]}
1
+ {"version":3,"file":"destination.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/destination.ts"],"names":[],"mappings":"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","sourcesContent":["import { Defaults } from '@/common/constants';\nimport { ParseUtility } from '@/utilities/parse.utility';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport path from 'node:path';\nimport pino from 'pino';\nimport { LoggerFormats, LoggerConfigUtility } from '../common';\n\nimport { PinoFrequencies, type TFrequency } from './common';\n\n/** Pure description of where pino should write, derived from env; `PinoDestination.build()` is the impure half that acts on it. */\nexport type TDestinationPlan =\n | { kind: 'stdout' }\n | { kind: 'pretty' }\n | {\n kind: 'roll';\n options: {\n file: string;\n frequency: TFrequency;\n size: string;\n limit: { count: number };\n mkdir: true;\n };\n };\n\n/** Reads `APP_ENV_LOGGER_*` and turns it into a destination. Warning prefixes name the operation, not the class - the tests and the published API still call these `mapFrequency`/`mapMaxFilesToCount`. */\nexport class PinoDestination {\n private static readonly DEFAULT_FREQUENCY: TFrequency = PinoFrequencies.HOURLY;\n private static readonly DEFAULT_MAX_FILES = '5d';\n\n /** `APP_ENV_LOGGER_FILE_FREQUENCY` -> pino-roll's `frequency`; an unrecognized value warns and falls back rather than throwing, so the app still boots. */\n static mapFrequency(opts: { value?: string }): TFrequency {\n const { value } = opts;\n const normalized = (value ?? '1h').trim().toLowerCase();\n\n switch (normalized) {\n case '1h': {\n return PinoFrequencies.HOURLY;\n }\n case '1d':\n case '24h': {\n return PinoFrequencies.DAILY;\n }\n default: {\n console.warn(\n '[mapFrequency] Invalid logger file frequency | value: %s | fallback: %s',\n value,\n PinoDestination.DEFAULT_FREQUENCY,\n );\n\n return PinoDestination.DEFAULT_FREQUENCY;\n }\n }\n }\n\n /** `null` means \"not a recognized shape\" - the caller decides what default to fall back to. */\n private static parseMaxFilesValue(value: string, frequency: TFrequency): number | null {\n const dayMatch = /^(\\d+)d$/i.exec(value);\n\n if (dayMatch) {\n const days = Number.parseInt(dayMatch[1], 10);\n\n return frequency === 'hourly' ? days * 24 : days;\n }\n\n const bareMatch = /^\\d+$/.exec(value);\n\n if (bareMatch) {\n return Number.parseInt(value, 10);\n }\n\n return null;\n }\n\n /** `APP_ENV_LOGGER_FILE_MAX_FILES` -> pino-roll's `limit.count`: `'<n>d'` scales by frequency (hourly: days*24), a bare integer is a literal count, unrecognized falls back to `'5d'`. */\n static mapMaxFilesToCount(opts: { value?: string; frequency: TFrequency }): number {\n const { value, frequency } = opts;\n const normalized = value?.trim();\n\n if (normalized) {\n const parsed = PinoDestination.parseMaxFilesValue(normalized, frequency);\n\n if (parsed !== null) {\n return parsed;\n }\n }\n\n // Unset is a normal configuration (mirror the sibling defaults) - only a PROVIDED value that failed to parse deserves a warning.\n if (normalized && normalized !== PinoDestination.DEFAULT_MAX_FILES) {\n console.warn(\n '[mapMaxFilesToCount] Invalid logger file max files value | value: %s | fallback: %s',\n value,\n PinoDestination.DEFAULT_MAX_FILES,\n );\n }\n\n return PinoDestination.parseMaxFilesValue(\n PinoDestination.DEFAULT_MAX_FILES,\n frequency,\n ) as number;\n }\n\n /** Pure: which destination pino should write to, derived from `APP_ENV_LOGGER_*` at CALL time. `DATE_PATTERN` is deliberately not read - pino-roll has no equivalent. */\n static resolvePlan(): TDestinationPlan {\n const folderPath = process.env.APP_ENV_LOGGER_FOLDER_PATH;\n\n if (folderPath && folderPath.trim() !== '') {\n const frequency = PinoDestination.mapFrequency({\n value: process.env.APP_ENV_LOGGER_FILE_FREQUENCY,\n });\n const count = PinoDestination.mapMaxFilesToCount({\n value: process.env.APP_ENV_LOGGER_FILE_MAX_FILES,\n frequency,\n });\n\n return {\n kind: 'roll',\n options: {\n file: path.join(folderPath, Defaults.APPLICATION_NAME),\n frequency,\n size:\n ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FILE_MAX_SIZE }) ??\n '100m',\n limit: { count },\n mkdir: true,\n },\n };\n }\n\n // UNSET means NDJSON to stdout, the locked default for this provider; only an EXPLICIT `text` opts into pino-pretty, and falling back to TEXT here (winston's default) would make the documented minimal install (pino only, no pino-pretty) crash on its first log line.\n if (process.env.APP_ENV_LOGGER_FORMAT === LoggerFormats.TEXT) {\n return { kind: 'pretty' };\n }\n\n return { kind: 'stdout' };\n }\n\n /** `pino.transport()` is SYNCHRONOUS - it returns a `ThreadStream` that BUFFERS writes until its worker thread loads, so no async gating is needed; `ModuleUtility.assertInstalled` runs first so a missing optional peer fails loudly here, not as an opaque worker-thread crash. */\n static build(opts: { plan: TDestinationPlan }): pino.DestinationStream | undefined {\n const { plan } = opts;\n\n switch (plan.kind) {\n case 'stdout': {\n return undefined;\n }\n case 'pretty': {\n ModuleUtility.assertInstalled({ scope: 'PinoLogger', modules: ['pino-pretty'] });\n\n // Only a decision is forwarded. Left alone, pino-pretty's own `isColorSupported` still\n // suppresses color when stdout is not a terminal - a check winston has no equivalent of.\n const colorize = LoggerConfigUtility.resolveColorize();\n\n return pino.transport({\n target: 'pino-pretty',\n ...(colorize === undefined ? {} : { options: { colorize } }),\n });\n }\n case 'roll': {\n ModuleUtility.assertInstalled({ scope: 'PinoLogger', modules: ['pino-roll'] });\n\n return pino.transport({ target: 'pino-roll', options: plan.options });\n }\n default: {\n return undefined;\n }\n }\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,kRAAkR;AAClR,MAAM,OAAO,UAAW,SAAQ,UAAU;aACzB,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAErD,YAAoB,KAAa;QAC/B,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6JAA6J;IACnJ,KAAK,CAAC,IAAiE;QAC/E,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5E,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAEnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAa,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAES,KAAK,CAAC,IAAuB;QACrC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { BaseLogger } from '../base';\nimport { type ILogger, type TLogLevel } from '../common';\nimport { LogFormatUtility } from '../formatting';\nimport { PinoBackingLogger } from './backing';\n\n/** pino provider satisfying `ILoggerProvider`, staying pino-native: numeric levels, `msg`, epoch `time`, pid/hostname pass through unchanged. No custom-instance param on `get()` unlike `WinstonLogger.get` - advanced/test injection goes through `PinoBackingLogger.set()`. */\nexport class PinoLogger extends BaseLogger {\n private static cache = new Map<string, PinoLogger>();\n\n private constructor(scope: string) {\n super({ scope });\n }\n\n static get(scope: string): PinoLogger {\n let cached = this.cache.get(scope);\n if (!cached) {\n cached = new PinoLogger(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n\n /** Resolves the backing instance at WRITE time and never caches it, so `PinoBackingLogger.set()` takes effect for every already-issued scope immediately. */\n protected write(opts: { level: TLogLevel; message: string; args: Array<AnyType> }) {\n const line =\n opts.args.length > 0\n ? LogFormatUtility.formatMessage({ message: opts.message, args: opts.args })\n : opts.message;\n\n const backing = PinoBackingLogger.get() as AnyType;\n backing[opts.level](this._formattedPrefix + line);\n }\n\n protected child(opts: { scope: string }): ILogger {\n return PinoLogger.get(opts.scope);\n }\n}\n"]}
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,kRAAkR;AAClR,MAAM,OAAO,UAAW,SAAQ,UAAU;aACzB,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAErD,YAAoB,KAAa;QAC/B,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6JAA6J;IACnJ,KAAK,CAAC,IAAiE;QAC/E,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5E,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAEnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAa,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAES,KAAK,CAAC,IAAuB;QACrC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { BaseLogger } from '../base';\nimport { type ILogger, type TLogLevel } from '../common';\nimport { LogFormatUtility } from '../formatting';\nimport { PinoBackingLogger } from './backing';\n\n/** pino provider satisfying `ILoggerProvider`, staying pino-native: numeric levels, `msg`, epoch `time`, pid/hostname pass through unchanged. No custom-instance param on `get()` unlike `WinstonLogger.get` - advanced/test injection goes through `PinoBackingLogger.set()`. */\nexport class PinoLogger extends BaseLogger {\n private static cache = new Map<string, PinoLogger>();\n\n private constructor(scope: string) {\n super({ scope });\n }\n\n static get(scope: string): PinoLogger {\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new PinoLogger(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n\n /** Resolves the backing instance at WRITE time and never caches it, so `PinoBackingLogger.set()` takes effect for every already-issued scope immediately. */\n protected write(opts: { level: TLogLevel; message: string; args: Array<AnyType> }) {\n const line =\n opts.args.length > 0\n ? LogFormatUtility.formatMessage({ message: opts.message, args: opts.args })\n : opts.message;\n\n const backing = PinoBackingLogger.get() as AnyType;\n backing[opts.level](this._formattedPrefix + line);\n }\n\n protected child(opts: { scope: string }): ILogger {\n return PinoLogger.get(opts.scope);\n }\n}\n"]}
@@ -2,6 +2,7 @@ import type dgram from 'node:dgram';
2
2
  import type winston from 'winston';
3
3
  import type Transport from 'winston-transport';
4
4
  import { type TLogLevel, type TLoggerFormat } from '../../common/index.js';
5
+ /** Options of `DgramTransport`. Only lines whose level is in `levels` are sent, as UDP datagrams to `host:port`, tagged with `label`; `socketOptions` go to `dgram.createSocket`. */
5
6
  export interface IDgramTransportOptions extends Transport.TransportStreamOptions {
6
7
  label: string;
7
8
  host: string;
@@ -9,14 +10,32 @@ export interface IDgramTransportOptions extends Transport.TransportStreamOptions
9
10
  levels: Array<string>;
10
11
  socketOptions: dgram.SocketOptions;
11
12
  }
13
+ /** Daily-rotating log file written to `<folder>/<prefix>-<level>-%DATE%.log`. */
12
14
  export interface IFileTransportOptions {
13
15
  prefix: string;
14
16
  folder: string;
17
+ /**
18
+ * How often the file rotates.
19
+ * @default the `APP_ENV_LOGGER_FILE_FREQUENCY` setting, else `'1h'`
20
+ */
15
21
  frequency?: string;
22
+ /**
23
+ * Size at which a file rotates.
24
+ * @default the `APP_ENV_LOGGER_FILE_MAX_SIZE` setting, else `'100m'`
25
+ */
16
26
  maxSize?: string;
27
+ /**
28
+ * How many files, or days of files, are kept.
29
+ * @default the `APP_ENV_LOGGER_FILE_MAX_FILES` setting, else `'5d'`
30
+ */
17
31
  maxFiles?: string;
32
+ /**
33
+ * The date format in the file name.
34
+ * @default the `APP_ENV_LOGGER_FILE_DATE_PATTERN` setting, else `'YYYYMMDD_HH'`
35
+ */
18
36
  datePattern?: string;
19
37
  }
38
+ /** Options for building a winston logger; `transports.info` and `transports.error` each take an optional file and datagram transport. */
20
39
  export interface ICustomLoggerOptions {
21
40
  levels?: {
22
41
  [name: string | symbol]: number;
@@ -26,11 +45,20 @@ export interface ICustomLoggerOptions {
26
45
  };
27
46
  /** Full override of the logger-level format; when provided, transports get NO format of their own - the override is applied once for every transport, exactly as it produces the line. */
28
47
  formatter?: ReturnType<typeof winston.format.combine>;
29
- /** Output shape per transport. Defaults to `APP_ENV_LOGGER_FORMAT` (`text`). */
48
+ /**
49
+ * Output shape per transport.
50
+ * @default the `APP_ENV_LOGGER_FORMAT` setting, else `'text'`
51
+ */
30
52
  format?: TLoggerFormat;
31
- /** Logger-level floor. Defaults to `APP_ENV_LOGGER_LEVEL`, then `debug`. */
53
+ /**
54
+ * Logger-level floor.
55
+ * @default the `APP_ENV_LOGGER_LEVEL` setting, else `'debug'`
56
+ */
32
57
  level?: TLogLevel;
33
- /** ANSI color on the console transport in `text` mode. Defaults to `APP_ENV_LOGGER_COLOR`, then OFF outside a development `NODE_ENV`. Ignored when `formatter` is set - that override owns the whole line. */
58
+ /**
59
+ * ANSI color on the console transport in `text` mode. Ignored when `formatter` is set - that override owns the whole line.
60
+ * @default the `APP_ENV_LOGGER_COLOR` setting; else `false` under `NO_COLOR` or outside a development `NODE_ENV`; else `true`
61
+ */
34
62
  colorize?: boolean;
35
63
  transports: {
36
64
  info: {
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type dgram from 'node:dgram';\nimport type winston from 'winston';\nimport type Transport from 'winston-transport';\nimport { type TLogLevel, type TLoggerFormat } from '../../common';\n\nexport interface IDgramTransportOptions extends Transport.TransportStreamOptions {\n label: string;\n host: string;\n port: number;\n levels: Array<string>;\n socketOptions: dgram.SocketOptions;\n}\n\nexport interface IFileTransportOptions {\n prefix: string;\n folder: string;\n frequency?: string;\n maxSize?: string;\n maxFiles?: string;\n datePattern?: string;\n}\n\nexport interface ICustomLoggerOptions {\n levels?: { [name: string | symbol]: number };\n colors?: { [name: string | symbol]: string };\n\n /** Full override of the logger-level format; when provided, transports get NO format of their own - the override is applied once for every transport, exactly as it produces the line. */\n formatter?: ReturnType<typeof winston.format.combine>;\n\n /** Output shape per transport. Defaults to `APP_ENV_LOGGER_FORMAT` (`text`). */\n format?: TLoggerFormat;\n\n /** Logger-level floor. Defaults to `APP_ENV_LOGGER_LEVEL`, then `debug`. */\n level?: TLogLevel;\n\n /** ANSI color on the console transport in `text` mode. Defaults to `APP_ENV_LOGGER_COLOR`, then OFF outside a development `NODE_ENV`. Ignored when `formatter` is set - that override owns the whole line. */\n colorize?: boolean;\n\n transports: {\n info: {\n file?: IFileTransportOptions;\n dgram?: Partial<IDgramTransportOptions>;\n };\n error: {\n file?: IFileTransportOptions;\n dgram?: Partial<IDgramTransportOptions>;\n };\n };\n}\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type dgram from 'node:dgram';\nimport type winston from 'winston';\nimport type Transport from 'winston-transport';\nimport { type TLogLevel, type TLoggerFormat } from '../../common';\n\n/** Options of `DgramTransport`. Only lines whose level is in `levels` are sent, as UDP datagrams to `host:port`, tagged with `label`; `socketOptions` go to `dgram.createSocket`. */\nexport interface IDgramTransportOptions extends Transport.TransportStreamOptions {\n label: string;\n host: string;\n port: number;\n levels: Array<string>;\n socketOptions: dgram.SocketOptions;\n}\n\n/** Daily-rotating log file written to `<folder>/<prefix>-<level>-%DATE%.log`. */\nexport interface IFileTransportOptions {\n prefix: string;\n folder: string;\n /**\n * How often the file rotates.\n * @default the `APP_ENV_LOGGER_FILE_FREQUENCY` setting, else `'1h'`\n */\n frequency?: string;\n /**\n * Size at which a file rotates.\n * @default the `APP_ENV_LOGGER_FILE_MAX_SIZE` setting, else `'100m'`\n */\n maxSize?: string;\n /**\n * How many files, or days of files, are kept.\n * @default the `APP_ENV_LOGGER_FILE_MAX_FILES` setting, else `'5d'`\n */\n maxFiles?: string;\n /**\n * The date format in the file name.\n * @default the `APP_ENV_LOGGER_FILE_DATE_PATTERN` setting, else `'YYYYMMDD_HH'`\n */\n datePattern?: string;\n}\n\n/** Options for building a winston logger; `transports.info` and `transports.error` each take an optional file and datagram transport. */\nexport interface ICustomLoggerOptions {\n levels?: { [name: string | symbol]: number };\n colors?: { [name: string | symbol]: string };\n\n /** Full override of the logger-level format; when provided, transports get NO format of their own - the override is applied once for every transport, exactly as it produces the line. */\n formatter?: ReturnType<typeof winston.format.combine>;\n\n /**\n * Output shape per transport.\n * @default the `APP_ENV_LOGGER_FORMAT` setting, else `'text'`\n */\n format?: TLoggerFormat;\n\n /**\n * Logger-level floor.\n * @default the `APP_ENV_LOGGER_LEVEL` setting, else `'debug'`\n */\n level?: TLogLevel;\n\n /**\n * ANSI color on the console transport in `text` mode. Ignored when `formatter` is set - that override owns the whole line.\n * @default the `APP_ENV_LOGGER_COLOR` setting; else `false` under `NO_COLOR` or outside a development `NODE_ENV`; else `true`\n */\n colorize?: boolean;\n\n transports: {\n info: {\n file?: IFileTransportOptions;\n dgram?: Partial<IDgramTransportOptions>;\n };\n error: {\n file?: IFileTransportOptions;\n dgram?: Partial<IDgramTransportOptions>;\n };\n };\n}\n"]}
@@ -1,4 +1,5 @@
1
1
  import type winston from 'winston';
2
+ /** The winston format that renders an application log line; the default logger uses it. */
2
3
  export declare const applicationLogFormatter: winston.Logform.Format;
3
4
  /** Module-internal only - NOT re-exported from `winston/index.ts`; the default winston backing WinstonLogger falls back to. */
4
5
  export declare const defaultWinstonLogger: winston.Logger;
@@ -1,5 +1,6 @@
1
1
  import { WinstonFormatFactory } from './formats.js';
2
2
  import { WinstonLoggerFactory } from './logger-factory.js';
3
+ /** The winston format that renders an application log line; the default logger uses it. */
3
4
  export const applicationLogFormatter = WinstonFormatFactory.applicationLogFormatter;
4
5
  /** Module-internal only - NOT re-exported from `winston/index.ts`; the default winston backing WinstonLogger falls back to. */
5
6
  export const defaultWinstonLogger = WinstonLoggerFactory.defaultLogger();
@@ -1 +1 @@
1
- {"version":3,"file":"define.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/define.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,CAAC,MAAM,uBAAuB,GAClC,oBAAoB,CAAC,uBAAuB,CAAC;AAE/C,+HAA+H;AAC/H,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,aAAa,EAAE,CAAC","sourcesContent":["import type winston from 'winston';\nimport { WinstonFormatFactory } from './formats';\nimport { WinstonLoggerFactory } from './logger-factory';\n\nexport const applicationLogFormatter: winston.Logform.Format =\n WinstonFormatFactory.applicationLogFormatter;\n\n/** Module-internal only - NOT re-exported from `winston/index.ts`; the default winston backing WinstonLogger falls back to. */\nexport const defaultWinstonLogger = WinstonLoggerFactory.defaultLogger();\n"]}
1
+ {"version":3,"file":"define.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/define.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,uBAAuB,GAClC,oBAAoB,CAAC,uBAAuB,CAAC;AAE/C,+HAA+H;AAC/H,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,aAAa,EAAE,CAAC","sourcesContent":["import type winston from 'winston';\nimport { WinstonFormatFactory } from './formats';\nimport { WinstonLoggerFactory } from './logger-factory';\n\n/** The winston format that renders an application log line; the default logger uses it. */\nexport const applicationLogFormatter: winston.Logform.Format =\n WinstonFormatFactory.applicationLogFormatter;\n\n/** Module-internal only - NOT re-exported from `winston/index.ts`; the default winston backing WinstonLogger falls back to. */\nexport const defaultWinstonLogger = WinstonLoggerFactory.defaultLogger();\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"formats.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/formats.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@venizia/ignis-inversion';\nimport winston from 'winston';\nimport { type AnyType } from '@/common/types';\nimport { LOGGER_FORMAT, LOGGER_PREFIX } from './common/constants';\nimport { LoggerFormats, LoggerConfigUtility, type TLoggerFormat } from '../common';\nimport { LogFormatUtility } from '../formatting';\n\nconst f = winston.format;\n\n/** Winston stashes the extra arguments of `logger.error(msg, ...args)` under this well-known key. */\nconst SPLAT = Symbol.for('splat');\n\n/**\n * Static methods never reach a sibling through `this` - the exported names in `define.ts` are\n * unbound aliases (`WinstonFormatFactory.method`), so `this` would be `undefined` there.\n */\nexport class WinstonFormatFactory {\n /** Per-line prep: label, timestamp, error normalization, deep splat. Final-string assembly is per-transport, so console can colorize while files/UDP get plain lines. */\n static prep(opts: { label: string }) {\n return f.combine(\n f.label({ label: opts.label }),\n f.timestamp(),\n f.errors({ stack: true }),\n WinstonFormatFactory.deepSplat(),\n );\n }\n\n /** Drop-in replacement for `winston.format.splat()` that formats through {@link LogFormatUtility.formatMessage}; every transport reads `info.message`, so widening it here widens console, file and dgram at once. */\n static deepSplat() {\n return f((info) => {\n const args = (info as AnyType)[SPLAT] as Array<unknown> | undefined;\n\n if (!args?.length || typeof info.message !== 'string') {\n return info;\n }\n\n info.message = LogFormatUtility.formatMessage({ message: info.message, args });\n return info;\n })();\n }\n\n static textLine() {\n return f.printf(({ level, message, label, timestamp }) => {\n return `${timestamp} [${label}] ${level}: ${message}`;\n });\n }\n\n static json(opts: { label: string }) {\n return f.combine(WinstonFormatFactory.prep({ label: opts.label }), f.json());\n }\n\n static pretty(opts: { label: string; colorize?: boolean }) {\n // winston has no terminal detection of its own, so \"no opinion\" keeps the historical default.\n const { label, colorize = LoggerConfigUtility.resolveColorize() ?? true } = opts;\n\n if (colorize) {\n return f.combine(\n WinstonFormatFactory.prep({ label }),\n f.align(),\n f.colorize(),\n WinstonFormatFactory.textLine(),\n );\n }\n\n return f.combine(\n WinstonFormatFactory.prep({ label }),\n f.align(),\n WinstonFormatFactory.textLine(),\n );\n }\n\n static log(opts: { label: string; format?: TLoggerFormat }) {\n const format = opts.format ?? (LOGGER_FORMAT as TLoggerFormat);\n\n switch (format) {\n case LoggerFormats.JSON: {\n return WinstonFormatFactory.json({ label: opts.label });\n }\n case LoggerFormats.TEXT: {\n return WinstonFormatFactory.pretty({ label: opts.label });\n }\n default: {\n throw getError({\n message: `[defineLogger] Invalid logger format | format: ${format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,\n });\n }\n }\n }\n\n /** Per-transport assembly formats: console may colorize, a file never does - ANSI bytes in a rotated log file are noise every grep has to strip. */\n static assembly(opts: { format: TLoggerFormat; colorize: boolean }) {\n switch (opts.format) {\n case LoggerFormats.JSON: {\n return { console: f.json(), file: f.json() };\n }\n case LoggerFormats.TEXT: {\n return {\n console: opts.colorize\n ? f.combine(f.align(), f.colorize(), WinstonFormatFactory.textLine())\n : f.combine(f.align(), WinstonFormatFactory.textLine()),\n file: f.combine(f.align(), WinstonFormatFactory.textLine()),\n };\n }\n default: {\n throw getError({\n message: `[defineCustomLogger] Invalid logger format | format: ${opts.format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,\n });\n }\n }\n }\n\n static readonly applicationLogFormatter: winston.Logform.Format = WinstonFormatFactory.log({\n label: LOGGER_PREFIX,\n });\n}\n"]}
1
+ {"version":3,"file":"formats.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/formats.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@venizia/ignis-inversion';\nimport winston from 'winston';\nimport { type AnyType } from '@/common/types';\nimport { LOGGER_FORMAT, LOGGER_PREFIX } from './common/constants';\nimport { LoggerFormats, LoggerConfigUtility, type TLoggerFormat } from '../common';\nimport { LogFormatUtility } from '../formatting';\n\nconst f = winston.format;\n\n/** Winston stashes the extra arguments of `logger.error(msg, ...args)` under this well-known key. */\nconst SPLAT = Symbol.for('splat');\n\n/**\n * Static methods never reach a sibling through `this` - the exported names in `define.ts` are\n * unbound aliases (`WinstonFormatFactory.method`), so `this` would be `undefined` there.\n */\nexport class WinstonFormatFactory {\n /** Per-line prep: label, timestamp, error normalization, deep splat. Final-string assembly is per-transport, so console can colorize while files/UDP get plain lines. */\n static prep(opts: { label: string }) {\n return f.combine(\n f.label({ label: opts.label }),\n f.timestamp(),\n f.errors({ stack: true }),\n WinstonFormatFactory.deepSplat(),\n );\n }\n\n /** Drop-in replacement for `winston.format.splat()` that formats through {@link LogFormatUtility.formatMessage}; every transport reads `info.message`, so widening it here widens console, file and dgram at once. */\n static deepSplat() {\n return f((info) => {\n const args = (info as AnyType)[SPLAT] as Array<unknown> | undefined;\n\n if (!args?.length || typeof info.message !== 'string') {\n return info;\n }\n\n info.message = LogFormatUtility.formatMessage({ message: info.message, args });\n\n return info;\n })();\n }\n\n static textLine() {\n return f.printf(({ level, message, label, timestamp }) => {\n return `${timestamp} [${label}] ${level}: ${message}`;\n });\n }\n\n static json(opts: { label: string }) {\n return f.combine(WinstonFormatFactory.prep({ label: opts.label }), f.json());\n }\n\n static pretty(opts: { label: string; colorize?: boolean }) {\n // winston has no terminal detection of its own, so \"no opinion\" keeps the historical default.\n const { label, colorize = LoggerConfigUtility.resolveColorize() ?? true } = opts;\n\n if (colorize) {\n return f.combine(\n WinstonFormatFactory.prep({ label }),\n f.align(),\n f.colorize(),\n WinstonFormatFactory.textLine(),\n );\n }\n\n return f.combine(\n WinstonFormatFactory.prep({ label }),\n f.align(),\n WinstonFormatFactory.textLine(),\n );\n }\n\n static log(opts: { label: string; format?: TLoggerFormat }) {\n const format = opts.format ?? (LOGGER_FORMAT as TLoggerFormat);\n\n switch (format) {\n case LoggerFormats.JSON: {\n return WinstonFormatFactory.json({ label: opts.label });\n }\n case LoggerFormats.TEXT: {\n return WinstonFormatFactory.pretty({ label: opts.label });\n }\n default: {\n throw getError({\n message: `[defineLogger] Invalid logger format | format: ${format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,\n });\n }\n }\n }\n\n /** Per-transport assembly formats: console may colorize, a file never does - ANSI bytes in a rotated log file are noise every grep has to strip. */\n static assembly(opts: { format: TLoggerFormat; colorize: boolean }) {\n switch (opts.format) {\n case LoggerFormats.JSON: {\n return { console: f.json(), file: f.json() };\n }\n case LoggerFormats.TEXT: {\n return {\n console: opts.colorize\n ? f.combine(f.align(), f.colorize(), WinstonFormatFactory.textLine())\n : f.combine(f.align(), WinstonFormatFactory.textLine()),\n file: f.combine(f.align(), WinstonFormatFactory.textLine()),\n };\n }\n default: {\n throw getError({\n message: `[defineCustomLogger] Invalid logger format | format: ${opts.format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,\n });\n }\n }\n }\n\n static readonly applicationLogFormatter: winston.Logform.Format = WinstonFormatFactory.log({\n label: LOGGER_PREFIX,\n });\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"logger-factory.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/logger-factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { ParseUtility } from '@/utilities/parse.utility';\nimport path from 'node:path';\nimport winston from 'winston';\nimport 'winston-daily-rotate-file';\nimport { DgramTransport } from './transports';\nimport { type ICustomLoggerOptions, type IDgramTransportOptions } from './common';\nimport {\n LOGGER_FILE_DATE_PATTERN,\n LOGGER_FILE_FREQUENCY,\n LOGGER_FILE_MAX_FILES,\n LOGGER_FILE_MAX_SIZE,\n LOGGER_FORMAT,\n LOGGER_PREFIX,\n} from './common/constants';\nimport { LoggerConfigUtility, type TLoggerFormat } from '../common';\nimport { WinstonFormatFactory } from './formats';\n\n/**\n * Static methods never reach a sibling through `this` - the exported names in `define.ts` are\n * unbound aliases (`WinstonLoggerFactory.method`), so `this` would be `undefined` there.\n */\nexport class WinstonLoggerFactory {\n private static _defaultLogger?: winston.Logger;\n\n static defineCustomLogger(opts: ICustomLoggerOptions) {\n const {\n levels = {\n error: 0,\n emerg: 0,\n warn: 1,\n info: 2,\n debug: 3,\n },\n colors = {\n error: 'red',\n emerg: 'red',\n warn: 'yellow',\n info: 'green',\n debug: 'blue',\n },\n formatter,\n format = LOGGER_FORMAT as TLoggerFormat,\n level = LoggerConfigUtility.resolveLevel({ configured: process.env.APP_ENV_LOGGER_LEVEL }),\n colorize = LoggerConfigUtility.resolveColorize() ?? true,\n transports: { info: infoTransportOptions, error: errorTransportOptions },\n } = opts;\n\n const assemblyFormats = formatter ? null : WinstonFormatFactory.assembly({ format, colorize });\n const loggerFormat = formatter ?? WinstonFormatFactory.prep({ label: LOGGER_PREFIX });\n\n const consoleLogTransport = new winston.transports.Console({\n format: assemblyFormats?.console,\n });\n const transports: {\n general: Array<winston.transport>;\n exception: Array<winston.transport>;\n } = {\n general: [consoleLogTransport],\n exception: [consoleLogTransport],\n };\n\n if (infoTransportOptions.file) {\n const fileOpts = infoTransportOptions.file;\n const transport = new winston.transports.DailyRotateFile({\n frequency: fileOpts.frequency ?? LOGGER_FILE_FREQUENCY,\n maxSize: fileOpts.maxSize ?? LOGGER_FILE_MAX_SIZE,\n maxFiles: fileOpts.maxFiles ?? LOGGER_FILE_MAX_FILES,\n datePattern: fileOpts.datePattern ?? LOGGER_FILE_DATE_PATTERN,\n filename: path.join(fileOpts.folder, `/${fileOpts.prefix}-info-%DATE%.log`),\n level: 'info',\n format: assemblyFormats?.file,\n });\n\n transports.general.push(transport);\n }\n\n if (errorTransportOptions.file) {\n const fileOpts = errorTransportOptions.file;\n const transport = new winston.transports.DailyRotateFile({\n frequency: fileOpts.frequency ?? LOGGER_FILE_FREQUENCY,\n maxSize: fileOpts.maxSize ?? LOGGER_FILE_MAX_SIZE,\n maxFiles: fileOpts.maxFiles ?? LOGGER_FILE_MAX_FILES,\n datePattern: fileOpts.datePattern ?? LOGGER_FILE_DATE_PATTERN,\n filename: path.join(fileOpts.folder, `/${fileOpts.prefix}-error-%DATE%.log`),\n level: 'error',\n format: assemblyFormats?.file,\n });\n\n transports.general.push(transport);\n transports.exception.push(transport);\n }\n\n if (infoTransportOptions.dgram) {\n const transport = DgramTransport.fromPartial(infoTransportOptions.dgram);\n if (transport) {\n transports.general.push(transport);\n }\n }\n\n // Deliberate asymmetry with the file pair: error.dgram registers ONLY as an exception handler - ordinary error-level lines already ship over info.dgram's transport, and adding it to general would double-send every error line.\n if (errorTransportOptions.dgram) {\n const transport = DgramTransport.fromPartial(errorTransportOptions.dgram);\n if (transport) {\n transports.exception.push(transport);\n }\n }\n\n winston.addColors(colors);\n\n return winston.createLogger({\n levels,\n level,\n format: loggerFormat,\n exitOnError: false,\n transports: transports.general,\n exceptionHandlers: transports.exception,\n });\n }\n\n /** Default transports from `APP_ENV_LOGGER_*`, resolved at CALL time. File logging is opt-in - without `APP_ENV_LOGGER_FOLDER_PATH` no rotating file is created. */\n static resolveDefaultTransportOptions(): ICustomLoggerOptions['transports'] {\n const folderPath = process.env.APP_ENV_LOGGER_FOLDER_PATH;\n const fileOptions =\n folderPath && folderPath.trim() !== ''\n ? { folder: folderPath, prefix: LOGGER_PREFIX }\n : undefined;\n\n const dgramOptions: Partial<IDgramTransportOptions> = {\n socketOptions: { type: 'udp4' },\n host: process.env.APP_ENV_LOGGER_DGRAM_HOST,\n port: ParseUtility.toInt({ input: process.env.APP_ENV_LOGGER_DGRAM_PORT }),\n label: process.env.APP_ENV_LOGGER_DGRAM_LABEL,\n levels: process.env.APP_ENV_LOGGER_DGRAM_LEVELS?.split(',').map((el) => el.trim()) ?? [],\n };\n\n return {\n info: { file: fileOptions, dgram: dgramOptions },\n error: { file: fileOptions, dgram: dgramOptions },\n };\n }\n\n /**\n * Lazy and cached - a plain module-level eager instance would build a winston logger (and read\n * env vars) at import time for every consumer of the barrel, even one that never logs through\n * the default.\n */\n static defaultLogger(): winston.Logger {\n return (WinstonLoggerFactory._defaultLogger ??= WinstonLoggerFactory.defineCustomLogger({\n transports: WinstonLoggerFactory.resolveDefaultTransportOptions(),\n }));\n }\n}\n"]}
1
+ {"version":3,"file":"logger-factory.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/logger-factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { ParseUtility } from '@/utilities/parse.utility';\nimport path from 'node:path';\nimport winston from 'winston';\nimport 'winston-daily-rotate-file';\nimport { DgramTransport } from './transports';\nimport { type ICustomLoggerOptions, type IDgramTransportOptions } from './common';\nimport {\n LOGGER_FILE_DATE_PATTERN,\n LOGGER_FILE_FREQUENCY,\n LOGGER_FILE_MAX_FILES,\n LOGGER_FILE_MAX_SIZE,\n LOGGER_FORMAT,\n LOGGER_PREFIX,\n} from './common/constants';\nimport { LoggerConfigUtility, type TLoggerFormat } from '../common';\nimport { WinstonFormatFactory } from './formats';\n\n/**\n * Static methods never reach a sibling through `this` - the exported names in `define.ts` are\n * unbound aliases (`WinstonLoggerFactory.method`), so `this` would be `undefined` there.\n */\nexport class WinstonLoggerFactory {\n private static _defaultLogger?: winston.Logger;\n\n static defineCustomLogger(opts: ICustomLoggerOptions) {\n const {\n levels = {\n error: 0,\n emerg: 0,\n warn: 1,\n info: 2,\n debug: 3,\n },\n colors = {\n error: 'red',\n emerg: 'red',\n warn: 'yellow',\n info: 'green',\n debug: 'blue',\n },\n formatter,\n format = LOGGER_FORMAT as TLoggerFormat,\n level = LoggerConfigUtility.resolveLevel({ configured: process.env.APP_ENV_LOGGER_LEVEL }),\n colorize = LoggerConfigUtility.resolveColorize() ?? true,\n transports: { info: infoTransportOptions, error: errorTransportOptions },\n } = opts;\n\n const assemblyFormats = formatter ? null : WinstonFormatFactory.assembly({ format, colorize });\n const loggerFormat = formatter ?? WinstonFormatFactory.prep({ label: LOGGER_PREFIX });\n\n const consoleLogTransport = new winston.transports.Console({\n format: assemblyFormats?.console,\n });\n const transports: {\n general: Array<winston.transport>;\n exception: Array<winston.transport>;\n } = {\n general: [consoleLogTransport],\n exception: [consoleLogTransport],\n };\n\n if (infoTransportOptions.file) {\n const fileOpts = infoTransportOptions.file;\n const transport = new winston.transports.DailyRotateFile({\n frequency: fileOpts.frequency ?? LOGGER_FILE_FREQUENCY,\n maxSize: fileOpts.maxSize ?? LOGGER_FILE_MAX_SIZE,\n maxFiles: fileOpts.maxFiles ?? LOGGER_FILE_MAX_FILES,\n datePattern: fileOpts.datePattern ?? LOGGER_FILE_DATE_PATTERN,\n filename: path.join(fileOpts.folder, `/${fileOpts.prefix}-info-%DATE%.log`),\n level: 'info',\n format: assemblyFormats?.file,\n });\n\n transports.general.push(transport);\n }\n\n if (errorTransportOptions.file) {\n const fileOpts = errorTransportOptions.file;\n const transport = new winston.transports.DailyRotateFile({\n frequency: fileOpts.frequency ?? LOGGER_FILE_FREQUENCY,\n maxSize: fileOpts.maxSize ?? LOGGER_FILE_MAX_SIZE,\n maxFiles: fileOpts.maxFiles ?? LOGGER_FILE_MAX_FILES,\n datePattern: fileOpts.datePattern ?? LOGGER_FILE_DATE_PATTERN,\n filename: path.join(fileOpts.folder, `/${fileOpts.prefix}-error-%DATE%.log`),\n level: 'error',\n format: assemblyFormats?.file,\n });\n\n transports.general.push(transport);\n transports.exception.push(transport);\n }\n\n if (infoTransportOptions.dgram) {\n const transport = DgramTransport.fromPartial(infoTransportOptions.dgram);\n\n if (transport) {\n transports.general.push(transport);\n }\n }\n\n // Deliberate asymmetry with the file pair: error.dgram registers ONLY as an exception handler - ordinary error-level lines already ship over info.dgram's transport, and adding it to general would double-send every error line.\n if (errorTransportOptions.dgram) {\n const transport = DgramTransport.fromPartial(errorTransportOptions.dgram);\n\n if (transport) {\n transports.exception.push(transport);\n }\n }\n\n winston.addColors(colors);\n\n return winston.createLogger({\n levels,\n level,\n format: loggerFormat,\n exitOnError: false,\n transports: transports.general,\n exceptionHandlers: transports.exception,\n });\n }\n\n /** Default transports from `APP_ENV_LOGGER_*`, resolved at CALL time. File logging is opt-in - without `APP_ENV_LOGGER_FOLDER_PATH` no rotating file is created. */\n static resolveDefaultTransportOptions(): ICustomLoggerOptions['transports'] {\n const folderPath = process.env.APP_ENV_LOGGER_FOLDER_PATH;\n const fileOptions =\n folderPath && folderPath.trim() !== ''\n ? { folder: folderPath, prefix: LOGGER_PREFIX }\n : undefined;\n\n const dgramOptions: Partial<IDgramTransportOptions> = {\n socketOptions: { type: 'udp4' },\n host: process.env.APP_ENV_LOGGER_DGRAM_HOST,\n port: ParseUtility.toInt({ input: process.env.APP_ENV_LOGGER_DGRAM_PORT }),\n label: process.env.APP_ENV_LOGGER_DGRAM_LABEL,\n levels: process.env.APP_ENV_LOGGER_DGRAM_LEVELS?.split(',').map((el) => el.trim()) ?? [],\n };\n\n return {\n info: { file: fileOptions, dgram: dgramOptions },\n error: { file: fileOptions, dgram: dgramOptions },\n };\n }\n\n /**\n * Lazy and cached - a plain module-level eager instance would build a winston logger (and read\n * env vars) at import time for every consumer of the barrel, even one that never logs through\n * the default.\n */\n static defaultLogger(): winston.Logger {\n return (WinstonLoggerFactory._defaultLogger ??= WinstonLoggerFactory.defineCustomLogger({\n transports: WinstonLoggerFactory.resolveDefaultTransportOptions(),\n }));\n }\n}\n"]}