@venizia/ignis-helpers 0.4.0 → 0.4.2

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 (273) hide show
  1. package/dist/cjs/common/constants/duration.d.ts +4 -1
  2. package/dist/cjs/common/constants/duration.d.ts.map +1 -1
  3. package/dist/cjs/common/constants/duration.js +13 -8
  4. package/dist/cjs/common/constants/duration.js.map +1 -1
  5. package/dist/cjs/common/redact.js +1 -1
  6. package/dist/cjs/common/redact.js.map +1 -1
  7. package/dist/cjs/modules/base.js +1 -1
  8. package/dist/cjs/modules/base.js.map +1 -1
  9. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js +1 -1
  10. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  11. package/dist/cjs/modules/env/app-env.d.ts.map +1 -1
  12. package/dist/cjs/modules/env/app-env.js +1 -1
  13. package/dist/cjs/modules/env/app-env.js.map +1 -1
  14. package/dist/cjs/modules/logger/common/constants.js +1 -1
  15. package/dist/cjs/modules/logger/common/constants.js.map +1 -1
  16. package/dist/cjs/modules/logger/factory.js +1 -1
  17. package/dist/cjs/modules/logger/factory.js.map +1 -1
  18. package/dist/cjs/modules/logger/formatting/deep-splat.js +1 -1
  19. package/dist/cjs/modules/logger/formatting/deep-splat.js.map +1 -1
  20. package/dist/cjs/modules/logger/formatting/error-prettier.js +4 -4
  21. package/dist/cjs/modules/logger/formatting/error-prettier.js.map +1 -1
  22. package/dist/cjs/modules/logger/hf/flusher.js +3 -3
  23. package/dist/cjs/modules/logger/hf/flusher.js.map +1 -1
  24. package/dist/cjs/modules/logger/hf/logger.d.ts.map +1 -1
  25. package/dist/cjs/modules/logger/hf/logger.js +3 -1
  26. package/dist/cjs/modules/logger/hf/logger.js.map +1 -1
  27. package/dist/cjs/modules/logger/resolver.js +3 -3
  28. package/dist/cjs/modules/logger/resolver.js.map +1 -1
  29. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js +1 -1
  30. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  31. package/dist/cjs/modules/logger/winston/logger-factory.js +1 -1
  32. package/dist/cjs/modules/logger/winston/logger-factory.js.map +1 -1
  33. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js +2 -2
  34. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  35. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  36. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  37. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  38. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  39. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  40. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  41. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  42. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  43. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js +34 -11
  44. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  45. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  46. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  47. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +1 -1
  48. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js +7 -6
  49. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  50. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  51. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  52. package/dist/cjs/modules/network/utilities/query-string.d.ts +27 -2
  53. package/dist/cjs/modules/network/utilities/query-string.d.ts.map +1 -1
  54. package/dist/cjs/modules/network/utilities/query-string.js +34 -2
  55. package/dist/cjs/modules/network/utilities/query-string.js.map +1 -1
  56. package/dist/cjs/modules/network/utilities/url-safety/ingest.js +1 -1
  57. package/dist/cjs/modules/network/utilities/url-safety/ingest.js.map +1 -1
  58. package/dist/cjs/modules/network/utilities/url-safety/policy.js +1 -1
  59. package/dist/cjs/modules/network/utilities/url-safety/policy.js.map +1 -1
  60. package/dist/cjs/modules/pool/abstract.js +4 -4
  61. package/dist/cjs/modules/pool/abstract.js.map +1 -1
  62. package/dist/cjs/modules/queue/bullmq/helper.js +2 -2
  63. package/dist/cjs/modules/queue/bullmq/helper.js.map +1 -1
  64. package/dist/cjs/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  65. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  66. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  67. package/dist/cjs/modules/queue/kafka/consumer.js +2 -2
  68. package/dist/cjs/modules/queue/kafka/consumer.js.map +1 -1
  69. package/dist/cjs/modules/queue/mqtt/helper.js +4 -4
  70. package/dist/cjs/modules/queue/mqtt/helper.js.map +1 -1
  71. package/dist/cjs/modules/redis/base/abstract.helper.js +4 -4
  72. package/dist/cjs/modules/redis/base/abstract.helper.js.map +1 -1
  73. package/dist/cjs/modules/redis/cluster/cluster.helper.js +1 -1
  74. package/dist/cjs/modules/redis/cluster/cluster.helper.js.map +1 -1
  75. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js +1 -1
  76. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  77. package/dist/cjs/modules/secrets/base/abstract.helper.d.ts.map +1 -1
  78. package/dist/cjs/modules/secrets/base/abstract.helper.js +7 -3
  79. package/dist/cjs/modules/secrets/base/abstract.helper.js.map +1 -1
  80. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  81. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  82. package/dist/cjs/modules/socket/socket-io/browser.d.ts +5 -0
  83. package/dist/cjs/modules/socket/socket-io/browser.d.ts.map +1 -0
  84. package/dist/cjs/modules/socket/socket-io/browser.js +21 -0
  85. package/dist/cjs/modules/socket/socket-io/browser.js.map +1 -0
  86. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  87. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  88. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js +250 -0
  89. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  90. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts +8 -51
  91. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  92. package/dist/cjs/modules/socket/socket-io/client/helper.js +12 -230
  93. package/dist/cjs/modules/socket/socket-io/client/helper.js.map +1 -1
  94. package/dist/cjs/modules/socket/socket-io/server/helper.js +5 -5
  95. package/dist/cjs/modules/socket/socket-io/server/helper.js.map +1 -1
  96. package/dist/cjs/modules/socket/websocket/server/delivery.js +2 -2
  97. package/dist/cjs/modules/socket/websocket/server/delivery.js.map +1 -1
  98. package/dist/cjs/modules/socket/websocket/server/helper.js +4 -4
  99. package/dist/cjs/modules/socket/websocket/server/helper.js.map +1 -1
  100. package/dist/cjs/modules/storage/base.js +3 -3
  101. package/dist/cjs/modules/storage/base.js.map +1 -1
  102. package/dist/cjs/modules/storage/bun-s3/helper.js +1 -1
  103. package/dist/cjs/modules/storage/bun-s3/helper.js.map +1 -1
  104. package/dist/cjs/modules/storage/bun-s3/utility.js +6 -6
  105. package/dist/cjs/modules/storage/bun-s3/utility.js.map +1 -1
  106. package/dist/cjs/modules/storage/common/errors.js +1 -1
  107. package/dist/cjs/modules/storage/common/errors.js.map +1 -1
  108. package/dist/cjs/modules/storage/minio/helper.js +4 -4
  109. package/dist/cjs/modules/storage/minio/helper.js.map +1 -1
  110. package/dist/cjs/modules/temporal/abstract.js +5 -5
  111. package/dist/cjs/modules/temporal/abstract.js.map +1 -1
  112. package/dist/cjs/modules/temporal/adapters/intl.d.ts.map +1 -1
  113. package/dist/cjs/modules/temporal/adapters/intl.js +3 -1
  114. package/dist/cjs/modules/temporal/adapters/intl.js.map +1 -1
  115. package/dist/cjs/modules/temporal/locale/locale.js +4 -4
  116. package/dist/cjs/modules/temporal/locale/locale.js.map +1 -1
  117. package/dist/cjs/modules/tree/builder.js +2 -2
  118. package/dist/cjs/modules/tree/builder.js.map +1 -1
  119. package/dist/cjs/modules/uid/opaque.js +2 -2
  120. package/dist/cjs/modules/uid/opaque.js.map +1 -1
  121. package/dist/cjs/modules/uid/uuid/v5.js +1 -1
  122. package/dist/cjs/modules/uid/uuid/v5.js.map +1 -1
  123. package/dist/cjs/modules/worker-thread/bus/base.js +4 -4
  124. package/dist/cjs/modules/worker-thread/bus/base.js.map +1 -1
  125. package/dist/cjs/modules/worker-thread/thread/base.js +2 -2
  126. package/dist/cjs/modules/worker-thread/thread/base.js.map +1 -1
  127. package/dist/cjs/modules/worker-thread/worker/base.js +4 -4
  128. package/dist/cjs/modules/worker-thread/worker/base.js.map +1 -1
  129. package/dist/cjs/utilities/parse.utility.js +4 -4
  130. package/dist/cjs/utilities/parse.utility.js.map +1 -1
  131. package/dist/cjs/utilities/promise.utility.js +1 -1
  132. package/dist/cjs/utilities/promise.utility.js.map +1 -1
  133. package/dist/cjs/utilities/request.utility.js +1 -1
  134. package/dist/cjs/utilities/request.utility.js.map +1 -1
  135. package/dist/cjs/utilities/sleep.utility.js +1 -1
  136. package/dist/cjs/utilities/sleep.utility.js.map +1 -1
  137. package/dist/esm/common/constants/duration.d.ts +4 -1
  138. package/dist/esm/common/constants/duration.d.ts.map +1 -1
  139. package/dist/esm/common/constants/duration.js +13 -8
  140. package/dist/esm/common/constants/duration.js.map +1 -1
  141. package/dist/esm/common/redact.js +1 -1
  142. package/dist/esm/common/redact.js.map +1 -1
  143. package/dist/esm/modules/base.js +1 -1
  144. package/dist/esm/modules/base.js.map +1 -1
  145. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +1 -1
  146. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  147. package/dist/esm/modules/env/app-env.d.ts.map +1 -1
  148. package/dist/esm/modules/env/app-env.js +1 -1
  149. package/dist/esm/modules/env/app-env.js.map +1 -1
  150. package/dist/esm/modules/logger/common/constants.js +1 -1
  151. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  152. package/dist/esm/modules/logger/factory.js +1 -1
  153. package/dist/esm/modules/logger/factory.js.map +1 -1
  154. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -1
  155. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  156. package/dist/esm/modules/logger/formatting/error-prettier.js +4 -4
  157. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  158. package/dist/esm/modules/logger/hf/flusher.js +3 -3
  159. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  160. package/dist/esm/modules/logger/hf/logger.d.ts.map +1 -1
  161. package/dist/esm/modules/logger/hf/logger.js +3 -1
  162. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  163. package/dist/esm/modules/logger/resolver.js +3 -3
  164. package/dist/esm/modules/logger/resolver.js.map +1 -1
  165. package/dist/esm/modules/logger/winston/formatters/deep-splat.js +1 -1
  166. package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  167. package/dist/esm/modules/logger/winston/logger-factory.js +1 -1
  168. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  169. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +2 -2
  170. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  171. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  172. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  173. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  174. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  175. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  176. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  177. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  178. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  179. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +36 -13
  180. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  181. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  182. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  183. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +1 -1
  184. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +7 -6
  185. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  186. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  187. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  188. package/dist/esm/modules/network/utilities/query-string.d.ts +27 -2
  189. package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
  190. package/dist/esm/modules/network/utilities/query-string.js +31 -1
  191. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  192. package/dist/esm/modules/network/utilities/url-safety/ingest.js +1 -1
  193. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  194. package/dist/esm/modules/network/utilities/url-safety/policy.js +1 -1
  195. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  196. package/dist/esm/modules/pool/abstract.js +4 -4
  197. package/dist/esm/modules/pool/abstract.js.map +1 -1
  198. package/dist/esm/modules/queue/bullmq/helper.js +2 -2
  199. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  200. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  201. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  202. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  203. package/dist/esm/modules/queue/kafka/consumer.js +2 -2
  204. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  205. package/dist/esm/modules/queue/mqtt/helper.js +4 -4
  206. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  207. package/dist/esm/modules/redis/base/abstract.helper.js +4 -4
  208. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  209. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -1
  210. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  211. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -1
  212. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  213. package/dist/esm/modules/secrets/base/abstract.helper.d.ts.map +1 -1
  214. package/dist/esm/modules/secrets/base/abstract.helper.js +7 -3
  215. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  216. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  217. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  218. package/dist/esm/modules/socket/socket-io/browser.d.ts +5 -0
  219. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +1 -0
  220. package/dist/esm/modules/socket/socket-io/browser.js +5 -0
  221. package/dist/esm/modules/socket/socket-io/browser.js.map +1 -0
  222. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  223. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  224. package/dist/esm/modules/socket/socket-io/client/browser-helper.js +246 -0
  225. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  226. package/dist/esm/modules/socket/socket-io/client/helper.d.ts +8 -51
  227. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  228. package/dist/esm/modules/socket/socket-io/client/helper.js +12 -230
  229. package/dist/esm/modules/socket/socket-io/client/helper.js.map +1 -1
  230. package/dist/esm/modules/socket/socket-io/server/helper.js +5 -5
  231. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  232. package/dist/esm/modules/socket/websocket/server/delivery.js +2 -2
  233. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  234. package/dist/esm/modules/socket/websocket/server/helper.js +4 -4
  235. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  236. package/dist/esm/modules/storage/base.js +3 -3
  237. package/dist/esm/modules/storage/base.js.map +1 -1
  238. package/dist/esm/modules/storage/bun-s3/helper.js +1 -1
  239. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  240. package/dist/esm/modules/storage/bun-s3/utility.js +6 -6
  241. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  242. package/dist/esm/modules/storage/common/errors.js +1 -1
  243. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  244. package/dist/esm/modules/storage/minio/helper.js +4 -4
  245. package/dist/esm/modules/storage/minio/helper.js.map +1 -1
  246. package/dist/esm/modules/temporal/abstract.js +5 -5
  247. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  248. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +1 -1
  249. package/dist/esm/modules/temporal/adapters/intl.js +3 -1
  250. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  251. package/dist/esm/modules/temporal/locale/locale.js +4 -4
  252. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  253. package/dist/esm/modules/tree/builder.js +2 -2
  254. package/dist/esm/modules/tree/builder.js.map +1 -1
  255. package/dist/esm/modules/uid/opaque.js +2 -2
  256. package/dist/esm/modules/uid/opaque.js.map +1 -1
  257. package/dist/esm/modules/uid/uuid/v5.js +1 -1
  258. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  259. package/dist/esm/modules/worker-thread/bus/base.js +4 -4
  260. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  261. package/dist/esm/modules/worker-thread/thread/base.js +2 -2
  262. package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
  263. package/dist/esm/modules/worker-thread/worker/base.js +4 -4
  264. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  265. package/dist/esm/utilities/parse.utility.js +4 -4
  266. package/dist/esm/utilities/parse.utility.js.map +1 -1
  267. package/dist/esm/utilities/promise.utility.js +1 -1
  268. package/dist/esm/utilities/promise.utility.js.map +1 -1
  269. package/dist/esm/utilities/request.utility.js +1 -1
  270. package/dist/esm/utilities/request.utility.js.map +1 -1
  271. package/dist/esm/utilities/sleep.utility.js +1 -1
  272. package/dist/esm/utilities/sleep.utility.js.map +1 -1
  273. package/package.json +10 -4
@@ -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, SHOULD_LOG_DEBUG, type TLogLevel } from '../common';\nimport { formatLogMessage } 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(levelCode, HfLogger.textEncoder.encode(formatLogMessage({ message, args })));\n return;\n }\n this.writeEntry(levelCode, HfLogger.encodeMessage(message));\n }\n\n debug(message: string, ...args: AnyType[]): void {\n if (!SHOULD_LOG_DEBUG) {\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 && !SHOULD_LOG_DEBUG) {\n return;\n }\n const levelCode = HF_LEVEL_CODES[level] ?? 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, SHOULD_LOG_DEBUG, type TLogLevel } from '../common';\nimport { formatLogMessage } 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(levelCode, HfLogger.textEncoder.encode(formatLogMessage({ message, args })));\n return;\n }\n this.writeEntry(levelCode, HfLogger.encodeMessage(message));\n }\n\n debug(message: string, ...args: AnyType[]): void {\n if (!SHOULD_LOG_DEBUG) {\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 && !SHOULD_LOG_DEBUG) {\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"]}
@@ -43,10 +43,10 @@ class ResolvedLogger extends AbstractLogger {
43
43
  /** The only logger code `BaseHelper` reaches, so this module must stay free of node imports - `BaseHelper` sits under every base class in the framework. */
44
44
  export class LoggerResolver {
45
45
  /** Declared before `active` because static field initialisers run in declaration order. */
46
- static { this.consoleResolver = opts => {
46
+ static { this.consoleResolver = (opts) => {
47
47
  // Warned here, on the first line actually routed to the console, not when a helper merely acquires its logger: a script that imports the barrel and installs a provider before logging must stay silent.
48
48
  LoggerResolver.warnConsoleFallbackOnce();
49
- return ConsoleLogger.get({ scope: opts.scopes.filter(el => el && el.length > 0).join('-') });
49
+ return ConsoleLogger.get({ scope: opts.scopes.filter((el) => el && el.length > 0).join('-') });
50
50
  }; }
51
51
  static { this.active = this.consoleResolver; }
52
52
  static { this.generation = 0; }
@@ -91,5 +91,5 @@ export class LoggerResolver {
91
91
  // graph carrying `LoggerFactory` does - is what upgrades every helper from the console fallback,
92
92
  // including helpers constructed before it loaded: the logger is resolved on first use, not in the
93
93
  // constructor.
94
- loggerSlot.resolve = opts => LoggerResolver.resolve({ scopes: opts.scopes });
94
+ loggerSlot.resolve = (opts) => LoggerResolver.resolve({ scopes: opts.scopes });
95
95
  //# sourceMappingURL=resolver.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../../src/modules/logger/resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { AbstractLogger } from './base/abstract';\nimport { ConsoleLogger } from './base/console';\nimport { type ILogger, type TLogLevel } from './common/types';\nimport { loggerSlot } from './slot';\n\nexport type TLoggerResolver = (opts: { scopes: Array<string> }) => ILogger;\n\n/** Caches the resolved target and re-reads it only when `LoggerResolver`'s generation moves - one integer compare per call, so an instance built before `LoggerFactory` loaded upgrades the moment it does, without being reconstructed. Mutual reference with LoggerResolver is by design - hence the `no-use-before-define` disables. */\nclass ResolvedLogger extends AbstractLogger {\n private target?: ILogger;\n private targetGeneration = -1;\n\n constructor(private readonly scopes: Array<string>) {\n super();\n }\n\n private resolveTarget(): ILogger {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const generation = LoggerResolver.currentGeneration();\n if (!this.target || this.targetGeneration !== generation) {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this.target = LoggerResolver.resolveNow({ scopes: this.scopes });\n this.targetGeneration = generation;\n }\n\n return this.target;\n }\n\n debug(message: string, ...args: AnyType[]) {\n this.resolveTarget().debug(message, ...args);\n }\n\n info(message: string, ...args: AnyType[]) {\n this.resolveTarget().info(message, ...args);\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.resolveTarget().warn(message, ...args);\n }\n\n error(message: string, ...args: AnyType[]) {\n this.resolveTarget().error(message, ...args);\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.resolveTarget().emerg(message, ...args);\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n this.resolveTarget().log(level, message, ...args);\n }\n\n for(methodName: string): ILogger {\n return new ResolvedLogger([...this.scopes, methodName]);\n }\n}\n\n/** The only logger code `BaseHelper` reaches, so this module must stay free of node imports - `BaseHelper` sits under every base class in the framework. */\nexport class LoggerResolver {\n /** Declared before `active` because static field initialisers run in declaration order. */\n private static readonly consoleResolver: TLoggerResolver = opts => {\n // Warned here, on the first line actually routed to the console, not when a helper merely acquires its logger: a script that imports the barrel and installs a provider before logging must stay silent.\n LoggerResolver.warnConsoleFallbackOnce();\n return ConsoleLogger.get({ scope: opts.scopes.filter(el => el && el.length > 0).join('-') });\n };\n\n private static active: TLoggerResolver = this.consoleResolver;\n private static generation = 0;\n\n /** `LoggerFactory` installs itself here from its own module body, so importing `LoggerFactory` as a value is what wires the real logger up - a side-effect-only import would not survive `sideEffects: false`. */\n static use(opts: { resolver: TLoggerResolver }): void {\n this.active = opts.resolver;\n this.generation += 1;\n }\n\n static reset(): void {\n this.active = this.consoleResolver;\n this.generation += 1;\n }\n\n /** Internal to this module - `ResolvedLogger` reads it to decide whether its cached target is stale. */\n static currentGeneration(): number {\n return this.generation;\n }\n\n /** Internal to this module - resolves through whatever is installed right now. */\n static resolveNow(opts: { scopes: Array<string> }): ILogger {\n return this.active({ scopes: opts.scopes });\n }\n\n /**\n * Without this, a node process logs to stdout while `APP_ENV_LOGGER_FOLDER_PATH` silently receives\n * nothing. A guarded property read, never an import: even a dynamic `import('@venizia/ignis-helpers')`\n * behind a node check puts the root barrel in this bundle and turns `/core` impure.\n */\n static warnConsoleFallbackOnce(): void {\n if (this.hasWarnedConsoleFallback || this.generation > 0) {\n return;\n }\n\n if (!globalThis.process?.versions?.node) {\n return;\n }\n\n this.hasWarnedConsoleFallback = true;\n ConsoleLogger.get({ scope: LoggerResolver.name }).warn(\n 'Logging to the console: no logger provider is installed. Import `LoggerFactory` from `@venizia/ignis-helpers` once at startup - `@venizia/ignis` does it for you, a connectors-only or script-only import graph does not. Loggers built before that import upgrade themselves on their next call.',\n );\n }\n\n static resolve(opts: { scopes: Array<string> }): ILogger {\n return new ResolvedLogger(opts.scopes);\n }\n\n private static hasWarnedConsoleFallback = false;\n}\n\n// Registers the real resolver with the slot `BaseHelper` reads. Importing this module - which any\n// graph carrying `LoggerFactory` does - is what upgrades every helper from the console fallback,\n// including helpers constructed before it loaded: the logger is resolved on first use, not in the\n// constructor.\nloggerSlot.resolve = opts => LoggerResolver.resolve({ scopes: opts.scopes });\n"]}
1
+ {"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../../src/modules/logger/resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { AbstractLogger } from './base/abstract';\nimport { ConsoleLogger } from './base/console';\nimport { type ILogger, type TLogLevel } from './common/types';\nimport { loggerSlot } from './slot';\n\nexport type TLoggerResolver = (opts: { scopes: Array<string> }) => ILogger;\n\n/** Caches the resolved target and re-reads it only when `LoggerResolver`'s generation moves - one integer compare per call, so an instance built before `LoggerFactory` loaded upgrades the moment it does, without being reconstructed. Mutual reference with LoggerResolver is by design - hence the `no-use-before-define` disables. */\nclass ResolvedLogger extends AbstractLogger {\n private target?: ILogger;\n private targetGeneration = -1;\n\n constructor(private readonly scopes: Array<string>) {\n super();\n }\n\n private resolveTarget(): ILogger {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const generation = LoggerResolver.currentGeneration();\n if (!this.target || this.targetGeneration !== generation) {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this.target = LoggerResolver.resolveNow({ scopes: this.scopes });\n this.targetGeneration = generation;\n }\n\n return this.target;\n }\n\n debug(message: string, ...args: AnyType[]) {\n this.resolveTarget().debug(message, ...args);\n }\n\n info(message: string, ...args: AnyType[]) {\n this.resolveTarget().info(message, ...args);\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.resolveTarget().warn(message, ...args);\n }\n\n error(message: string, ...args: AnyType[]) {\n this.resolveTarget().error(message, ...args);\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.resolveTarget().emerg(message, ...args);\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n this.resolveTarget().log(level, message, ...args);\n }\n\n for(methodName: string): ILogger {\n return new ResolvedLogger([...this.scopes, methodName]);\n }\n}\n\n/** The only logger code `BaseHelper` reaches, so this module must stay free of node imports - `BaseHelper` sits under every base class in the framework. */\nexport class LoggerResolver {\n /** Declared before `active` because static field initialisers run in declaration order. */\n private static readonly consoleResolver: TLoggerResolver = (opts) => {\n // Warned here, on the first line actually routed to the console, not when a helper merely acquires its logger: a script that imports the barrel and installs a provider before logging must stay silent.\n LoggerResolver.warnConsoleFallbackOnce();\n return ConsoleLogger.get({ scope: opts.scopes.filter((el) => el && el.length > 0).join('-') });\n };\n\n private static active: TLoggerResolver = this.consoleResolver;\n private static generation = 0;\n\n /** `LoggerFactory` installs itself here from its own module body, so importing `LoggerFactory` as a value is what wires the real logger up - a side-effect-only import would not survive `sideEffects: false`. */\n static use(opts: { resolver: TLoggerResolver }): void {\n this.active = opts.resolver;\n this.generation += 1;\n }\n\n static reset(): void {\n this.active = this.consoleResolver;\n this.generation += 1;\n }\n\n /** Internal to this module - `ResolvedLogger` reads it to decide whether its cached target is stale. */\n static currentGeneration(): number {\n return this.generation;\n }\n\n /** Internal to this module - resolves through whatever is installed right now. */\n static resolveNow(opts: { scopes: Array<string> }): ILogger {\n return this.active({ scopes: opts.scopes });\n }\n\n /**\n * Without this, a node process logs to stdout while `APP_ENV_LOGGER_FOLDER_PATH` silently receives\n * nothing. A guarded property read, never an import: even a dynamic `import('@venizia/ignis-helpers')`\n * behind a node check puts the root barrel in this bundle and turns `/core` impure.\n */\n static warnConsoleFallbackOnce(): void {\n if (this.hasWarnedConsoleFallback || this.generation > 0) {\n return;\n }\n\n if (!globalThis.process?.versions?.node) {\n return;\n }\n\n this.hasWarnedConsoleFallback = true;\n ConsoleLogger.get({ scope: LoggerResolver.name }).warn(\n 'Logging to the console: no logger provider is installed. Import `LoggerFactory` from `@venizia/ignis-helpers` once at startup - `@venizia/ignis` does it for you, a connectors-only or script-only import graph does not. Loggers built before that import upgrade themselves on their next call.',\n );\n }\n\n static resolve(opts: { scopes: Array<string> }): ILogger {\n return new ResolvedLogger(opts.scopes);\n }\n\n private static hasWarnedConsoleFallback = false;\n}\n\n// Registers the real resolver with the slot `BaseHelper` reads. Importing this module - which any\n// graph carrying `LoggerFactory` does - is what upgrades every helper from the console fallback,\n// including helpers constructed before it loaded: the logger is resolved on first use, not in the\n// constructor.\nloggerSlot.resolve = (opts) => LoggerResolver.resolve({ scopes: opts.scopes });\n"]}
@@ -3,7 +3,7 @@ import { formatLogMessage } from '../../formatting/index.js';
3
3
  /** Winston stashes the extra arguments of `logger.error(msg, ...args)` under this well-known key. */
4
4
  const SPLAT = Symbol.for('splat');
5
5
  /** Drop-in replacement for `winston.format.splat()` that formats through {@link formatLogMessage}; every transport reads `info.message`, so widening it here widens console, file and dgram at once. */
6
- export const deepSplat = winston.format(info => {
6
+ export const deepSplat = winston.format((info) => {
7
7
  const args = info[SPLAT];
8
8
  if (!args?.length || typeof info.message !== 'string') {
9
9
  return info;
@@ -1 +1 @@
1
- {"version":3,"file":"deep-splat.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/formatters/deep-splat.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,qGAAqG;AACrG,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAElC,wMAAwM;AACxM,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;IAC7C,MAAM,IAAI,GAAI,IAAgB,CAAC,KAAK,CAA+B,CAAC;IAEpE,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,GAAG,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC","sourcesContent":["import winston from 'winston';\nimport { type AnyType } from '@/common/types';\nimport { formatLogMessage } from '../../formatting';\n\n/** Winston stashes the extra arguments of `logger.error(msg, ...args)` under this well-known key. */\nconst SPLAT = Symbol.for('splat');\n\n/** Drop-in replacement for `winston.format.splat()` that formats through {@link formatLogMessage}; every transport reads `info.message`, so widening it here widens console, file and dgram at once. */\nexport const deepSplat = winston.format(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 = formatLogMessage({ message: info.message, args });\n return info;\n});\n"]}
1
+ {"version":3,"file":"deep-splat.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/formatters/deep-splat.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,qGAAqG;AACrG,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAElC,wMAAwM;AACxM,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;IAC/C,MAAM,IAAI,GAAI,IAAgB,CAAC,KAAK,CAA+B,CAAC;IAEpE,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,GAAG,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC","sourcesContent":["import winston from 'winston';\nimport { type AnyType } from '@/common/types';\nimport { formatLogMessage } from '../../formatting';\n\n/** Winston stashes the extra arguments of `logger.error(msg, ...args)` under this well-known key. */\nconst SPLAT = Symbol.for('splat');\n\n/** Drop-in replacement for `winston.format.splat()` that formats through {@link formatLogMessage}; every transport reads `info.message`, so widening it here widens console, file and dgram at once. */\nexport const deepSplat = winston.format((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 = formatLogMessage({ message: info.message, args });\n return info;\n});\n"]}
@@ -95,7 +95,7 @@ export class WinstonLoggerFactory {
95
95
  host: process.env.APP_ENV_LOGGER_DGRAM_HOST,
96
96
  port: int(process.env.APP_ENV_LOGGER_DGRAM_PORT),
97
97
  label: process.env.APP_ENV_LOGGER_DGRAM_LABEL,
98
- levels: process.env.APP_ENV_LOGGER_DGRAM_LEVELS?.split(',').map(el => el.trim()) ?? [],
98
+ levels: process.env.APP_ENV_LOGGER_DGRAM_LEVELS?.split(',').map((el) => el.trim()) ?? [],
99
99
  };
100
100
  return {
101
101
  info: { file: fileOptions, dgram: dgramOptions },
@@ -1 +1 @@
1
- {"version":3,"file":"logger-factory.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/logger-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAsB,MAAM,WAAW,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAG/B,MAAM,CAAC,kBAAkB,CAAC,IAA0B;QAClD,MAAM,EACJ,MAAM,GAAG;YACP,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;SACT,EACD,MAAM,GAAG;YACP,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,MAAM;SACd,EACD,SAAS,EACT,MAAM,GAAG,aAA8B,EACvC,KAAK,GAAG,kBAAkB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,EAC5E,QAAQ,GAAG,qBAAqB,EAAE,IAAI,IAAI,EAC1C,UAAU,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,qBAAqB,EAAE,GACzE,GAAG,IAAI,CAAC;QAET,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/F,MAAM,YAAY,GAAG,SAAS,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAEtF,MAAM,mBAAmB,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YACzD,MAAM,EAAE,eAAe,EAAE,OAAO;SACjC,CAAC,CAAC;QACH,MAAM,UAAU,GAGZ;YACF,OAAO,EAAE,CAAC,mBAAmB,CAAC;YAC9B,SAAS,EAAE,CAAC,mBAAmB,CAAC;SACjC,CAAC;QAEF,IAAI,oBAAoB,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC;YAC3C,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC;gBACvD,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,qBAAqB;gBACtD,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,oBAAoB;gBACjD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,qBAAqB;gBACpD,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,wBAAwB;gBAC7D,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,MAAM,kBAAkB,CAAC;gBAC3E,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,eAAe,EAAE,IAAI;aAC9B,CAAC,CAAC;YAEH,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,qBAAqB,CAAC,IAAI,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC;YAC5C,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC;gBACvD,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,qBAAqB;gBACtD,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,oBAAoB;gBACjD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,qBAAqB;gBACpD,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,wBAAwB;gBAC7D,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,MAAM,mBAAmB,CAAC;gBAC5E,KAAK,EAAE,OAAO;gBACd,MAAM,EAAE,eAAe,EAAE,IAAI;aAC9B,CAAC,CAAC;YAEH,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,oBAAoB,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACzE,IAAI,SAAS,EAAE,CAAC;gBACd,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,kOAAkO;QAClO,IAAI,qBAAqB,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAC1E,IAAI,SAAS,EAAE,CAAC;gBACd,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAE1B,OAAO,OAAO,CAAC,YAAY,CAAC;YAC1B,MAAM;YACN,KAAK;YACL,MAAM,EAAE,YAAY;YACpB,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,UAAU,CAAC,OAAO;YAC9B,iBAAiB,EAAE,UAAU,CAAC,SAAS;SACxC,CAAC,CAAC;IACL,CAAC;IAED,oKAAoK;IACpK,MAAM,CAAC,8BAA8B;QACnC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAC1D,MAAM,WAAW,GACf,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE;YACpC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE;YAC/C,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,YAAY,GAAoC;YACpD,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;YAC/B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;YAC3C,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;YAChD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B;YAC7C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;SACvF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE;YAChD,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE;SAClD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa;QAClB,OAAO,CAAC,oBAAoB,CAAC,cAAc,KAAK,oBAAoB,CAAC,kBAAkB,CAAC;YACtF,UAAU,EAAE,oBAAoB,CAAC,8BAA8B,EAAE;SAClE,CAAC,CAAC,CAAC;IACN,CAAC;CACF","sourcesContent":["import { int } 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 { resolveLoggerColorize, resolveLoggerLevel, 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 = resolveLoggerLevel({ configured: process.env.APP_ENV_LOGGER_LEVEL }),\n colorize = resolveLoggerColorize() ?? 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: int(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 { int } 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 { resolveLoggerColorize, resolveLoggerLevel, 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 = resolveLoggerLevel({ configured: process.env.APP_ENV_LOGGER_LEVEL }),\n colorize = resolveLoggerColorize() ?? 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: int(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"]}
@@ -23,7 +23,7 @@ export class DgramTransport extends Transport {
23
23
  }
24
24
  establish(opts) {
25
25
  this.client = dgram.createSocket(opts.socketOptions);
26
- this.client.on('error', error => {
26
+ this.client.on('error', (error) => {
27
27
  this.client?.close();
28
28
  this.client = null;
29
29
  console.error('[dgram][error] Error: ', error);
@@ -46,7 +46,7 @@ export class DgramTransport extends Transport {
46
46
  this.establish({ socketOptions: this.socketOptions });
47
47
  }
48
48
  const message = this.formatMessage(opts);
49
- this.client?.send(message, this.port, this.host, error => {
49
+ this.client?.send(message, this.port, this.host, (error) => {
50
50
  if (error) {
51
51
  // console, not the Logger and not an 'error' EVENT: routing through the Logger would re-enter this very transport, and emitting 'error' with no listener attached kills the process over one lost UDP log line. Drop the socket so the next line reconnects.
52
52
  console.error('[DgramTransport][log] Failed to ship log line | error: ', error);
@@ -1 +1 @@
1
- {"version":3,"file":"dgram.transport.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/transports/dgram.transport.ts"],"names":[],"mappings":"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","sourcesContent":["import dgram from 'node:dgram';\nimport Transport from 'winston-transport';\nimport { type IDgramTransportOptions } from '../common';\n\nexport class DgramTransport extends Transport {\n private label: string;\n private host: string;\n private port: number;\n private triggerLevels: Set<string>;\n private socketOptions: dgram.SocketOptions;\n\n private client: dgram.Socket | null;\n\n constructor(opts: IDgramTransportOptions) {\n const { label, host, port, levels, socketOptions, ...defaultTransportOptions } = opts;\n super(defaultTransportOptions);\n\n this.label = label;\n this.host = host;\n this.port = port;\n this.triggerLevels = new Set(levels);\n this.socketOptions = socketOptions;\n\n this.establish({ socketOptions: this.socketOptions });\n }\n\n static fromPartial(opts?: Partial<IDgramTransportOptions>): DgramTransport | null {\n if (\n !opts?.label ||\n !opts?.host ||\n !opts?.port ||\n !opts?.levels?.length ||\n !opts?.socketOptions\n ) {\n return null;\n }\n\n return new DgramTransport(opts as IDgramTransportOptions);\n }\n\n private establish(opts: { socketOptions: dgram.SocketOptions }) {\n this.client = dgram.createSocket(opts.socketOptions);\n\n this.client.on('error', error => {\n this.client?.close();\n this.client = null;\n\n console.error('[dgram][error] Error: ', error);\n });\n }\n\n private formatMessage(opts: { [extra: string | symbol]: any }) {\n const { timestamp, label, message, ...rest } = opts;\n return [timestamp, `[${this.label ?? label}]`, rest[Symbol.for('level')], message].join(' ');\n }\n\n override log(\n opts: {\n level: string;\n message: string;\n label?: string;\n timestamp?: string;\n [extra: symbol]: any;\n },\n callback: () => void,\n ) {\n setImmediate(() => {\n this.emit('logged', opts);\n });\n\n const logLevel = opts[Symbol.for('level')];\n if (!this.triggerLevels.has(logLevel)) {\n callback();\n return;\n }\n\n if (!this.client) {\n this.establish({ socketOptions: this.socketOptions });\n }\n\n const message = this.formatMessage(opts);\n this.client?.send(message, this.port, this.host, error => {\n if (error) {\n // console, not the Logger and not an 'error' EVENT: routing through the Logger would re-enter this very transport, and emitting 'error' with no listener attached kills the process over one lost UDP log line. Drop the socket so the next line reconnects.\n console.error('[DgramTransport][log] Failed to ship log line | error: ', error);\n this.client?.close();\n this.client = null;\n }\n\n callback();\n });\n }\n}\n"]}
1
+ {"version":3,"file":"dgram.transport.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/transports/dgram.transport.ts"],"names":[],"mappings":"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","sourcesContent":["import dgram from 'node:dgram';\nimport Transport from 'winston-transport';\nimport { type IDgramTransportOptions } from '../common';\n\nexport class DgramTransport extends Transport {\n private label: string;\n private host: string;\n private port: number;\n private triggerLevels: Set<string>;\n private socketOptions: dgram.SocketOptions;\n\n private client: dgram.Socket | null;\n\n constructor(opts: IDgramTransportOptions) {\n const { label, host, port, levels, socketOptions, ...defaultTransportOptions } = opts;\n super(defaultTransportOptions);\n\n this.label = label;\n this.host = host;\n this.port = port;\n this.triggerLevels = new Set(levels);\n this.socketOptions = socketOptions;\n\n this.establish({ socketOptions: this.socketOptions });\n }\n\n static fromPartial(opts?: Partial<IDgramTransportOptions>): DgramTransport | null {\n if (\n !opts?.label ||\n !opts?.host ||\n !opts?.port ||\n !opts?.levels?.length ||\n !opts?.socketOptions\n ) {\n return null;\n }\n\n return new DgramTransport(opts as IDgramTransportOptions);\n }\n\n private establish(opts: { socketOptions: dgram.SocketOptions }) {\n this.client = dgram.createSocket(opts.socketOptions);\n\n this.client.on('error', (error) => {\n this.client?.close();\n this.client = null;\n\n console.error('[dgram][error] Error: ', error);\n });\n }\n\n private formatMessage(opts: { [extra: string | symbol]: any }) {\n const { timestamp, label, message, ...rest } = opts;\n return [timestamp, `[${this.label ?? label}]`, rest[Symbol.for('level')], message].join(' ');\n }\n\n override log(\n opts: {\n level: string;\n message: string;\n label?: string;\n timestamp?: string;\n [extra: symbol]: any;\n },\n callback: () => void,\n ) {\n setImmediate(() => {\n this.emit('logged', opts);\n });\n\n const logLevel = opts[Symbol.for('level')];\n if (!this.triggerLevels.has(logLevel)) {\n callback();\n return;\n }\n\n if (!this.client) {\n this.establish({ socketOptions: this.socketOptions });\n }\n\n const message = this.formatMessage(opts);\n this.client?.send(message, this.port, this.host, (error) => {\n if (error) {\n // console, not the Logger and not an 'error' EVENT: routing through the Logger would re-enter this very transport, and emitting 'error' with no listener attached kills the process over one lost UDP log line. Drop the socket so the next line reconnects.\n console.error('[DgramTransport][log] Failed to ship log line | error: ', error);\n this.client?.close();\n this.client = null;\n }\n\n callback();\n });\n }\n}\n"]}
@@ -24,7 +24,7 @@ export class AxiosFetcher extends AbstractNetworkFetchableHelper {
24
24
  params,
25
25
  data,
26
26
  headers,
27
- paramsSerializer: { serialize: p => stringify(p) },
27
+ paramsSerializer: { serialize: (p) => stringify(p) },
28
28
  ...rest,
29
29
  };
30
30
  const protocol = this.getProtocol(url);
@@ -1 +1 @@
1
- {"version":3,"file":"axios-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/axios-fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyObject, HTTP, type THttpMethod } from '@/common';\nimport { redactSecrets } from '@/common/redact';\nimport axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios';\nimport https from 'node:https';\nimport { stringify } from 'node:querystring';\nimport { BaseNetworkRequest } from '../base-network-request.helper';\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { AbstractNetworkFetchableHelper, type IRequestOptions } from './base-fetcher';\n\nexport interface IAxiosRequestOptions extends AxiosRequestConfig, IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: AnyObject;\n body?: AnyObject;\n headers?: AnyObject;\n /**\n * Declared so the opt-out is TYPED. It used to reach the agent only through the\n * `[extra: string]: any` index signature on {@link IRequestOptions}, which meant nothing told a\n * caller the option existed, and nothing stopped a typo from silently doing nothing.\n */\n rejectUnauthorized?: boolean;\n}\n\nexport class AxiosFetcher extends AbstractNetworkFetchableHelper<\n 'axios',\n IAxiosRequestOptions,\n // The named type, not the `axios.` NAMESPACE: the namespace form resolves only under node16\n // module resolution, and this package also emits an ESM build under `bundler` resolution.\n AxiosResponse<any, any>['data'],\n AxiosInstance\n> {\n /**\n * One agent for the instance, not one per request. Built here so TLS verification is decided\n * ONCE, at construction, rather than per call - and so connections are actually reused: a fresh\n * agent per request forces a new TCP and TLS handshake every time (measured: 10 handshakes for 10\n * requests, versus 1).\n */\n private readonly httpsAgent: https.Agent;\n\n constructor(opts: {\n name: string;\n defaultConfigs: AxiosRequestConfig;\n logger?: ILogger;\n /**\n * Turns OFF certificate verification for this instance. Node's own default is `true` and so is\n * this one; the previous code defaulted it to `false`, which silently accepted any certificate\n * on every HTTPS request the framework made.\n */\n rejectUnauthorized?: boolean;\n }) {\n super({ name: opts.name, variant: 'axios' });\n const { defaultConfigs } = opts;\n opts?.logger?.info('Creating new network request worker instance! Name: %s', this.name);\n\n this.httpsAgent = new https.Agent({\n keepAlive: true,\n rejectUnauthorized: opts.rejectUnauthorized ?? true,\n });\n\n this.worker = axios.create({ ...defaultConfigs });\n }\n\n override send<T = any>(opts: IAxiosRequestOptions, logger?: ILogger) {\n const { url, method = HTTP.Methods.GET, params = {}, body: data, headers, ...rest } = opts;\n const props: AxiosRequestConfig = {\n url,\n method: method.toUpperCase(),\n params,\n data,\n headers,\n paramsSerializer: { serialize: p => stringify(p) },\n ...rest,\n };\n\n const protocol = this.getProtocol(url);\n if (protocol === HTTP.Protocols.HTTPS) {\n // A caller's own agent WINS. The previous code assigned after the `...rest` spread, so a\n // hardened agent - custom CA, pinning, mTLS - was overwritten and the secure path was\n // unreachable through the public seam.\n props.httpsAgent =\n rest.httpsAgent ??\n (opts.rejectUnauthorized === undefined\n ? this.httpsAgent\n : new https.Agent({ keepAlive: true, rejectUnauthorized: opts.rejectUnauthorized }));\n }\n\n logger?.for(this.send.name).info('URL: %s | Props: %s', url, redactSecrets(props));\n return this.worker.request<T>(props);\n }\n}\n\nexport interface IAxiosNetworkRequestOptions {\n name: string;\n networkOptions: Omit<AxiosRequestConfig, 'baseURL'> & {\n baseUrl?: string;\n };\n}\n\nexport class AxiosNetworkRequest extends BaseNetworkRequest<'axios'> {\n constructor(opts: IAxiosNetworkRequestOptions) {\n const { name, networkOptions } = opts;\n const { headers, baseUrl, timeout, ...rest } = networkOptions;\n\n const mergedHeaders: AnyObject = {\n ['content-type']: 'application/json; charset=utf-8',\n ...headers,\n };\n\n const defaultConfigs: AxiosRequestConfig = {\n withCredentials: true,\n validateStatus: (status: number) => status < 500,\n timeout: timeout ?? 60 * 1000,\n ...rest,\n baseURL: baseUrl,\n headers: mergedHeaders,\n };\n\n super({\n name,\n baseUrl,\n fetcher: new AxiosFetcher({ name, defaultConfigs }),\n });\n }\n}\n"]}
1
+ {"version":3,"file":"axios-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/axios-fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyObject, HTTP, type THttpMethod } from '@/common';\nimport { redactSecrets } from '@/common/redact';\nimport axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios';\nimport https from 'node:https';\nimport { stringify } from 'node:querystring';\nimport { BaseNetworkRequest } from '../base-network-request.helper';\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { AbstractNetworkFetchableHelper, type IRequestOptions } from './base-fetcher';\n\nexport interface IAxiosRequestOptions extends AxiosRequestConfig, IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: AnyObject;\n body?: AnyObject;\n headers?: AnyObject;\n /**\n * Declared so the opt-out is TYPED. It used to reach the agent only through the\n * `[extra: string]: any` index signature on {@link IRequestOptions}, which meant nothing told a\n * caller the option existed, and nothing stopped a typo from silently doing nothing.\n */\n rejectUnauthorized?: boolean;\n}\n\nexport class AxiosFetcher extends AbstractNetworkFetchableHelper<\n 'axios',\n IAxiosRequestOptions,\n // The named type, not the `axios.` NAMESPACE: the namespace form resolves only under node16\n // module resolution, and this package also emits an ESM build under `bundler` resolution.\n AxiosResponse<any, any>['data'],\n AxiosInstance\n> {\n /**\n * One agent for the instance, not one per request. Built here so TLS verification is decided\n * ONCE, at construction, rather than per call - and so connections are actually reused: a fresh\n * agent per request forces a new TCP and TLS handshake every time (measured: 10 handshakes for 10\n * requests, versus 1).\n */\n private readonly httpsAgent: https.Agent;\n\n constructor(opts: {\n name: string;\n defaultConfigs: AxiosRequestConfig;\n logger?: ILogger;\n /**\n * Turns OFF certificate verification for this instance. Node's own default is `true` and so is\n * this one; the previous code defaulted it to `false`, which silently accepted any certificate\n * on every HTTPS request the framework made.\n */\n rejectUnauthorized?: boolean;\n }) {\n super({ name: opts.name, variant: 'axios' });\n const { defaultConfigs } = opts;\n opts?.logger?.info('Creating new network request worker instance! Name: %s', this.name);\n\n this.httpsAgent = new https.Agent({\n keepAlive: true,\n rejectUnauthorized: opts.rejectUnauthorized ?? true,\n });\n\n this.worker = axios.create({ ...defaultConfigs });\n }\n\n override send<T = any>(opts: IAxiosRequestOptions, logger?: ILogger) {\n const { url, method = HTTP.Methods.GET, params = {}, body: data, headers, ...rest } = opts;\n const props: AxiosRequestConfig = {\n url,\n method: method.toUpperCase(),\n params,\n data,\n headers,\n paramsSerializer: { serialize: (p) => stringify(p) },\n ...rest,\n };\n\n const protocol = this.getProtocol(url);\n if (protocol === HTTP.Protocols.HTTPS) {\n // A caller's own agent WINS. The previous code assigned after the `...rest` spread, so a\n // hardened agent - custom CA, pinning, mTLS - was overwritten and the secure path was\n // unreachable through the public seam.\n props.httpsAgent =\n rest.httpsAgent ??\n (opts.rejectUnauthorized === undefined\n ? this.httpsAgent\n : new https.Agent({ keepAlive: true, rejectUnauthorized: opts.rejectUnauthorized }));\n }\n\n logger?.for(this.send.name).info('URL: %s | Props: %s', url, redactSecrets(props));\n return this.worker.request<T>(props);\n }\n}\n\nexport interface IAxiosNetworkRequestOptions {\n name: string;\n networkOptions: Omit<AxiosRequestConfig, 'baseURL'> & {\n baseUrl?: string;\n };\n}\n\nexport class AxiosNetworkRequest extends BaseNetworkRequest<'axios'> {\n constructor(opts: IAxiosNetworkRequestOptions) {\n const { name, networkOptions } = opts;\n const { headers, baseUrl, timeout, ...rest } = networkOptions;\n\n const mergedHeaders: AnyObject = {\n ['content-type']: 'application/json; charset=utf-8',\n ...headers,\n };\n\n const defaultConfigs: AxiosRequestConfig = {\n withCredentials: true,\n validateStatus: (status: number) => status < 500,\n timeout: timeout ?? 60 * 1000,\n ...rest,\n baseURL: baseUrl,\n headers: mergedHeaders,\n };\n\n super({\n name,\n baseUrl,\n fetcher: new AxiosFetcher({ name, defaultConfigs }),\n });\n }\n}\n"]}
@@ -2,6 +2,8 @@ import { type THttpMethod } from '../../../../common/constants/http.js';
2
2
  import { type AnyObject } from '../../../../common/types/index.js';
3
3
  import type { ILogger } from '../../../logger/common/types.js';
4
4
  import { type TFetcherVariant } from '../common/index.js';
5
+ /** What a fetcher calls on the logger it is handed, so a host logger with only these two (a browser app's) is accepted as is. */
6
+ export type TFetcherLogger = Pick<ILogger, 'debug' | 'info'>;
5
7
  export interface IRequestOptions {
6
8
  url: string;
7
9
  method?: THttpMethod;
@@ -10,13 +12,13 @@ export interface IRequestOptions {
10
12
  [extra: symbol | string]: any;
11
13
  }
12
14
  export interface IFetchable<V extends TFetcherVariant, RQ extends IRequestOptions, RS, W = unknown> {
13
- send(opts: RQ, logger?: ILogger): Promise<RS>;
14
- get(opts: RQ, logger?: ILogger): Promise<RS>;
15
- post(opts: RQ, logger?: ILogger): Promise<RS>;
16
- put(opts: RQ, logger?: ILogger): Promise<RS>;
17
- patch(opts: RQ, logger?: ILogger): Promise<RS>;
18
- delete(opts: RQ, logger?: ILogger): Promise<RS>;
19
- query(opts: RQ, logger?: ILogger): Promise<RS>;
15
+ send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
16
+ get(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
17
+ post(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
18
+ put(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
19
+ patch(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
20
+ delete(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
21
+ query(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
20
22
  getVariant(): V;
21
23
  getWorker(): W;
22
24
  }
@@ -28,16 +30,17 @@ export declare abstract class AbstractNetworkFetchableHelper<V extends TFetcherV
28
30
  constructor(opts: {
29
31
  name: string;
30
32
  variant: V;
33
+ worker?: W;
31
34
  });
32
- abstract send(opts: RQ, logger?: ILogger): Promise<RS>;
35
+ abstract send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
33
36
  getProtocol(url: string): "http" | "https";
34
37
  getVariant(): V;
35
38
  getWorker(): W;
36
- get(opts: RQ, logger?: ILogger): Promise<RS>;
37
- post(opts: RQ, logger?: ILogger): Promise<RS>;
38
- put(opts: RQ, logger?: ILogger): Promise<RS>;
39
- patch(opts: RQ, logger?: ILogger): Promise<RS>;
40
- delete(opts: RQ, logger?: ILogger): Promise<RS>;
41
- query(opts: RQ, logger?: ILogger): Promise<RS>;
39
+ get(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
40
+ post(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
41
+ put(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
42
+ patch(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
43
+ delete(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
44
+ query(opts: RQ, logger?: TFetcherLogger): Promise<RS>;
42
45
  }
43
46
  //# sourceMappingURL=base-fetcher.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"base-fetcher.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/base-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU,CACzB,CAAC,SAAS,eAAe,EACzB,EAAE,SAAS,eAAe,EAC1B,EAAE,EACF,CAAC,GAAG,OAAO;IAEX,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9C,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9C,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAE/C,UAAU,IAAI,CAAC,CAAC;IAChB,SAAS,IAAI,CAAC,CAAC;CAChB;AAED,yNAAyN;AACzN,8BAAsB,8BAA8B,CAClD,CAAC,SAAS,eAAe,EACzB,EAAE,SAAS,eAAe,EAC1B,EAAE,EACF,CAAC,GAAG,OAAO,CACX,YAAW,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IACrB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;gBAER,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,CAAA;KAAE;IAK9C,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;IAEtD,WAAW,CAAC,GAAG,EAAE,MAAM;IAIvB,UAAU;IAIV,SAAS,IAAI,CAAC;IAId,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO;IAK9B,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO;IAK/B,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO;IAK9B,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO;IAKhC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO;IAKjC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO;CAIjC"}
1
+ {"version":3,"file":"base-fetcher.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/base-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,iIAAiI;AACjI,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU,CACzB,CAAC,SAAS,eAAe,EACzB,EAAE,SAAS,eAAe,EAC1B,EAAE,EACF,CAAC,GAAG,OAAO;IAEX,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACtD,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAEtD,UAAU,IAAI,CAAC,CAAC;IAChB,SAAS,IAAI,CAAC,CAAC;CAChB;AAED,yNAAyN;AACzN,8BAAsB,8BAA8B,CAClD,CAAC,SAAS,eAAe,EACzB,EAAE,SAAS,eAAe,EAC1B,EAAE,EACF,CAAC,GAAG,OAAO,CACX,YAAW,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IACrB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;gBAER,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE;IAS1D,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,EAAE,CAAC;IAE7D,WAAW,CAAC,GAAG,EAAE,MAAM;IAIvB,UAAU;IAIV,SAAS,IAAI,CAAC;IAId,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc;IAKrC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc;IAKtC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc;IAKrC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc;IAKvC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc;IAKxC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc;CAIxC"}
@@ -4,6 +4,9 @@ export class AbstractNetworkFetchableHelper {
4
4
  constructor(opts) {
5
5
  this.name = opts.name;
6
6
  this.variant = opts.variant;
7
+ if (opts.worker !== undefined) {
8
+ this.worker = opts.worker;
9
+ }
7
10
  }
8
11
  getProtocol(url) {
9
12
  return url.startsWith('http:') ? HTTP.Protocols.HTTP : HTTP.Protocols.HTTPS;
@@ -1 +1 @@
1
- {"version":3,"file":"base-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/base-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,yBAAyB,CAAC;AAiCjE,yNAAyN;AACzN,MAAM,OAAgB,8BAA8B;IAUlD,YAAY,IAAkC;QAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAID,WAAW,CAAC,GAAW;QACrB,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IAC9E,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,IAAQ,EAAE,MAAgB;QAC5B,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,IAAQ,EAAE,MAAgB;QAC7B,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,IAAQ,EAAE,MAAgB;QAC5B,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAgB;QAC9B,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,IAAQ,EAAE,MAAgB;QAC/B,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAgB;QAC9B,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;CACF","sourcesContent":["import { HTTP, type THttpMethod } from '@/common/constants/http';\nimport { type AnyObject } from '@/common/types';\n// The leaf file, never the logger BARREL: that barrel reaches `node:module` and would drag this\n// browser-pure fetcher contract with it.\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { type TFetcherVariant } from '../common';\n\nexport interface IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: AnyObject;\n timeout?: number;\n [extra: symbol | string]: any;\n}\n\nexport interface IFetchable<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> {\n send(opts: RQ, logger?: ILogger): Promise<RS>;\n get(opts: RQ, logger?: ILogger): Promise<RS>;\n post(opts: RQ, logger?: ILogger): Promise<RS>;\n put(opts: RQ, logger?: ILogger): Promise<RS>;\n patch(opts: RQ, logger?: ILogger): Promise<RS>;\n delete(opts: RQ, logger?: ILogger): Promise<RS>;\n query(opts: RQ, logger?: ILogger): Promise<RS>;\n\n getVariant(): V;\n getWorker(): W;\n}\n\n/** `W` defaults to `unknown` so this stays free of `axios` - a concrete fetcher binds it to its real worker type (`AxiosInstance`, `typeof fetch`), which is then inherited on `this.worker` with no override needed. */\nexport abstract class AbstractNetworkFetchableHelper<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> implements IFetchable<V, RQ, RS, W> {\n protected name: string;\n protected variant: V;\n protected worker: W;\n\n constructor(opts: { name: string; variant: V }) {\n this.name = opts.name;\n this.variant = opts.variant;\n }\n\n abstract send(opts: RQ, logger?: ILogger): Promise<RS>;\n\n getProtocol(url: string) {\n return url.startsWith('http:') ? HTTP.Protocols.HTTP : HTTP.Protocols.HTTPS;\n }\n\n getVariant() {\n return this.variant;\n }\n\n getWorker(): W {\n return this.worker;\n }\n\n get(opts: RQ, logger?: ILogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.GET }, logger);\n }\n\n post(opts: RQ, logger?: ILogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.POST }, logger);\n }\n\n put(opts: RQ, logger?: ILogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.PUT }, logger);\n }\n\n patch(opts: RQ, logger?: ILogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.PATCH }, logger);\n }\n\n delete(opts: RQ, logger?: ILogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.DELETE }, logger);\n }\n\n query(opts: RQ, logger?: ILogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.QUERY }, logger);\n }\n}\n"]}
1
+ {"version":3,"file":"base-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/base-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,yBAAyB,CAAC;AAoCjE,yNAAyN;AACzN,MAAM,OAAgB,8BAA8B;IAUlD,YAAY,IAA8C;QACxD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE5B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAID,WAAW,CAAC,GAAW;QACrB,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IAC9E,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,IAAQ,EAAE,MAAuB;QACnC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,IAAQ,EAAE,MAAuB;QACpC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,IAAQ,EAAE,MAAuB;QACnC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAuB;QACrC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,IAAQ,EAAE,MAAuB;QACtC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAuB;QACrC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;CACF","sourcesContent":["import { HTTP, type THttpMethod } from '@/common/constants/http';\nimport { type AnyObject } from '@/common/types';\n// The leaf file, never the logger BARREL: that barrel reaches `node:module` and would drag this\n// browser-pure fetcher contract with it.\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { type TFetcherVariant } from '../common';\n\n/** What a fetcher calls on the logger it is handed, so a host logger with only these two (a browser app's) is accepted as is. */\nexport type TFetcherLogger = Pick<ILogger, 'debug' | 'info'>;\n\nexport interface IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: AnyObject;\n timeout?: number;\n [extra: symbol | string]: any;\n}\n\nexport interface IFetchable<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> {\n send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n get(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n post(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n put(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n patch(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n delete(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n query(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n\n getVariant(): V;\n getWorker(): W;\n}\n\n/** `W` defaults to `unknown` so this stays free of `axios` - a concrete fetcher binds it to its real worker type (`AxiosInstance`, `typeof fetch`), which is then inherited on `this.worker` with no override needed. */\nexport abstract class AbstractNetworkFetchableHelper<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> implements IFetchable<V, RQ, RS, W> {\n protected name: string;\n protected variant: V;\n protected worker: W;\n\n constructor(opts: { name: string; variant: V; worker?: W }) {\n this.name = opts.name;\n this.variant = opts.variant;\n\n if (opts.worker !== undefined) {\n this.worker = opts.worker;\n }\n }\n\n abstract send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n\n getProtocol(url: string) {\n return url.startsWith('http:') ? HTTP.Protocols.HTTP : HTTP.Protocols.HTTPS;\n }\n\n getVariant() {\n return this.variant;\n }\n\n getWorker(): W {\n return this.worker;\n }\n\n get(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.GET }, logger);\n }\n\n post(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.POST }, logger);\n }\n\n put(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.PUT }, logger);\n }\n\n patch(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.PATCH }, logger);\n }\n\n delete(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.DELETE }, logger);\n }\n\n query(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n return this.send({ ...rest, method: HTTP.Methods.QUERY }, logger);\n }\n}\n"]}
@@ -1,8 +1,8 @@
1
1
  import { type THttpMethod } from '../../../../common/constants/http.js';
2
2
  import { type AnyObject } from '../../../../common/types/index.js';
3
+ import { type IQueryStringOptions } from '../../utilities/query-string.js';
3
4
  import { BaseNetworkRequest } from '../base-network-request.helper.js';
4
- import type { ILogger } from '../../../logger/common/types.js';
5
- import { AbstractNetworkFetchableHelper, type IRequestOptions } from './base-fetcher.js';
5
+ import { AbstractNetworkFetchableHelper, type IRequestOptions, type TFetcherLogger } from './base-fetcher.js';
6
6
  export interface INodeFetchRequestOptions extends RequestInit, IRequestOptions {
7
7
  url: string;
8
8
  method?: THttpMethod;
@@ -10,17 +10,26 @@ export interface INodeFetchRequestOptions extends RequestInit, IRequestOptions {
10
10
  }
11
11
  export declare class NodeFetcher extends AbstractNetworkFetchableHelper<'node-fetch', INodeFetchRequestOptions, Awaited<ReturnType<typeof fetch>>, typeof fetch> {
12
12
  private defaultConfigs;
13
+ private queryString;
13
14
  constructor(opts: {
14
15
  name: string;
15
16
  defaultConfigs: RequestInit;
16
- logger?: ILogger;
17
+ /** How `params` are written into the url; the defaults are `node:querystring`'s. */
18
+ queryString?: IQueryStringOptions;
19
+ logger?: TFetcherLogger;
17
20
  });
18
- send(opts: INodeFetchRequestOptions, logger?: ILogger): Promise<Response>;
21
+ /** A raw body passes through; a plain object or an array is JSON-encoded; no body stays no body. */
22
+ protected serializeBody(opts: {
23
+ body: unknown;
24
+ }): RequestInit['body'] | undefined;
25
+ send(opts: INodeFetchRequestOptions, logger?: TFetcherLogger): Promise<Response>;
19
26
  }
20
27
  export interface INodeFetchNetworkRequestOptions {
21
28
  name: string;
22
29
  networkOptions: RequestInit & {
23
30
  baseUrl?: string;
31
+ /** How `params` are written into every url this request sends; see {@link IQueryStringOptions}. */
32
+ queryString?: IQueryStringOptions;
24
33
  };
25
34
  }
26
35
  export declare class NodeFetchNetworkRequest extends BaseNetworkRequest<'node-fetch'> {
@@ -1 +1 @@
1
- {"version":3,"file":"node-fetcher.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/node-fetcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtF,MAAM,WAAW,wBAAyB,SAAQ,WAAW,EAAE,eAAe;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,qBAAa,WAAY,SAAQ,8BAA8B,CAC7D,YAAY,EACZ,wBAAwB,EACxB,OAAO,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,EACjC,OAAO,KAAK,CACb;IACC,OAAO,CAAC,cAAc,CAAc;gBAExB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;IASlE,IAAI,CAAC,IAAI,EAAE,wBAAwB,EAAE,MAAM,CAAC,EAAE,OAAO;CAkErE;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,WAAW,GAAG;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,qBAAa,uBAAwB,SAAQ,kBAAkB,CAAC,YAAY,CAAC;gBAC/D,IAAI,EAAE,+BAA+B;CAsBlD"}
1
+ {"version":3,"file":"node-fetcher.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/node-fetcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EACL,8BAA8B,EAC9B,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,wBAAyB,SAAQ,WAAW,EAAE,eAAe;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAcD,qBAAa,WAAY,SAAQ,8BAA8B,CAC7D,YAAY,EACZ,wBAAwB,EACxB,OAAO,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,EACjC,OAAO,KAAK,CACb;IACC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,WAAW,CAAsB;gBAE7B,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,WAAW,CAAC;QAC5B,oFAAoF;QACpF,WAAW,CAAC,EAAE,mBAAmB,CAAC;QAClC,MAAM,CAAC,EAAE,cAAc,CAAC;KACzB;IAUD,oGAAoG;IACpG,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS;IAUlE,IAAI,CAAC,IAAI,EAAE,wBAAwB,EAAE,MAAM,CAAC,EAAE,cAAc;CA6E5E;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,WAAW,GAAG;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,mGAAmG;QACnG,WAAW,CAAC,EAAE,mBAAmB,CAAC;KACnC,CAAC;CACH;AAED,qBAAa,uBAAwB,SAAQ,kBAAkB,CAAC,YAAY,CAAC;gBAC/D,IAAI,EAAE,+BAA+B;CAsBlD"}
@@ -1,15 +1,34 @@
1
1
  import { redactSecrets } from '../../../../common/redact.js';
2
2
  import { HTTP } from '../../../../common/constants/http.js';
3
- import { QueryStringSeparators, toQueryString } from '../../utilities/query-string.js';
3
+ import { QueryStringSeparators, toQueryString, } from '../../utilities/query-string.js';
4
4
  import { BaseNetworkRequest } from '../base-network-request.helper.js';
5
- import { AbstractNetworkFetchableHelper } from './base-fetcher.js';
5
+ import { AbstractNetworkFetchableHelper, } from './base-fetcher.js';
6
+ /** What `fetch` takes as a body as it is: encoding any of these again would change the bytes sent. A constructor is looked up on `globalThis` so a runtime without one (no `FormData`) just never matches it. */
7
+ const isRawBody = (body) => {
8
+ if (typeof body === 'string' || ArrayBuffer.isView(body) || body instanceof ArrayBuffer) {
9
+ return true;
10
+ }
11
+ return ['Blob', 'FormData', 'URLSearchParams', 'ReadableStream'].some((name) => {
12
+ const ctor = Reflect.get(globalThis, name);
13
+ return typeof ctor === 'function' && body instanceof ctor;
14
+ });
15
+ };
6
16
  export class NodeFetcher extends AbstractNetworkFetchableHelper {
7
17
  constructor(opts) {
8
- super({ name: opts.name, variant: 'node-fetch' });
18
+ super({ name: opts.name, variant: 'node-fetch', worker: fetch });
9
19
  const { name, defaultConfigs } = opts;
10
20
  this.name = name;
11
21
  opts?.logger?.info('Creating new network request worker instance! Name: %s', this.name);
12
22
  this.defaultConfigs = defaultConfigs;
23
+ this.queryString = opts.queryString ?? {};
24
+ }
25
+ /** A raw body passes through; a plain object or an array is JSON-encoded; no body stays no body. */
26
+ serializeBody(opts) {
27
+ const { body } = opts;
28
+ if (body === undefined || body === null) {
29
+ return undefined;
30
+ }
31
+ return isRawBody(body) ? body : JSON.stringify(body);
13
32
  }
14
33
  async send(opts, logger) {
15
34
  const { url, method = HTTP.Methods.GET, params, body, headers, timeout, signal, ...rest } = opts;
@@ -30,12 +49,13 @@ export class NodeFetcher extends AbstractNetworkFetchableHelper {
30
49
  ...this.defaultConfigs,
31
50
  ...rest,
32
51
  method: method.toUpperCase(),
33
- body,
34
- headers,
52
+ body: this.serializeBody({ body }),
53
+ // The call's headers REPLACE the defaults (a caller that sends a multipart body leaves the content type out so `fetch` can write the boundary); a call with none keeps them. Spreading an absent `headers` over the config used to erase the defaults.
54
+ headers: headers ?? this.defaultConfigs.headers,
35
55
  signal: effectiveSignal,
36
56
  };
37
57
  // `?` only when the url carries no query string of its own - a second `?` is not a separator, so the server would read the previous parameter's value as `1?extra=2`.
38
- const serializedParams = params ? toQueryString({ params }) : '';
58
+ const serializedParams = params ? toQueryString({ params, ...this.queryString }) : '';
39
59
  const requestUrl = serializedParams
40
60
  ? `${url}${url.includes(QueryStringSeparators.START) ? QueryStringSeparators.PAIR : QueryStringSeparators.START}${serializedParams}`
41
61
  : url;
@@ -45,12 +65,15 @@ export class NodeFetcher extends AbstractNetworkFetchableHelper {
45
65
  // because the `string[][]` form is a list of tuples, which key matching cannot see either.
46
66
  const loggableConfigs = {
47
67
  ...requestConfigs,
48
- body: typeof body === 'string' ? `[body ${body.length} chars]` : body ? '[body]' : undefined,
49
- headers: headers ? Object.fromEntries(new Headers(headers)) : undefined,
68
+ body: typeof requestConfigs.body === 'string'
69
+ ? `[body ${requestConfigs.body.length} chars]`
70
+ : requestConfigs.body
71
+ ? '[body]'
72
+ : undefined,
73
+ headers: requestConfigs.headers,
50
74
  };
51
- logger
52
- ?.for(this.send.name)
53
- .info('URL: %s | Props: %s | Timeout: %s', url, redactSecrets(loggableConfigs), timeout);
75
+ // Straight on the logger it was handed, never `logger.for(...)`: a host logger may carry only `debug` and `info`. With none handed, nothing is logged - no default logger is built, so a browser never reaches the node-only provider.
76
+ logger?.debug('[%s] URL: %s | Props: %s | Timeout: %s', this.send.name, url, redactSecrets(loggableConfigs), timeout);
54
77
  try {
55
78
  const rs = await fetch(requestUrl, requestConfigs);
56
79
  return rs;
@@ -65,7 +88,7 @@ export class NodeFetcher extends AbstractNetworkFetchableHelper {
65
88
  export class NodeFetchNetworkRequest extends BaseNetworkRequest {
66
89
  constructor(opts) {
67
90
  const { name, networkOptions } = opts;
68
- const { headers, baseUrl, ...rest } = networkOptions;
91
+ const { headers, baseUrl, queryString, ...rest } = networkOptions;
69
92
  const userHeaders = headers instanceof Headers ? Object.fromEntries(headers.entries()) : headers;
70
93
  const mergedHeaders = {
71
94
  ['content-type']: 'application/json; charset=utf-8',
@@ -78,7 +101,7 @@ export class NodeFetchNetworkRequest extends BaseNetworkRequest {
78
101
  super({
79
102
  name,
80
103
  baseUrl,
81
- fetcher: new NodeFetcher({ name, defaultConfigs }),
104
+ fetcher: new NodeFetcher({ name, defaultConfigs, queryString }),
82
105
  });
83
106
  }
84
107
  }
@@ -1 +1 @@
1
- {"version":3,"file":"node-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/node-fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { redactSecrets } from '@/common/redact';\nimport { HTTP, type THttpMethod } from '@/common/constants/http';\nimport { type AnyObject } from '@/common/types';\nimport { QueryStringSeparators, toQueryString } from '../../utilities/query-string';\n\nimport { BaseNetworkRequest } from '../base-network-request.helper';\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { AbstractNetworkFetchableHelper, type IRequestOptions } from './base-fetcher';\n\nexport interface INodeFetchRequestOptions extends RequestInit, IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: AnyObject;\n}\n\nexport class NodeFetcher extends AbstractNetworkFetchableHelper<\n 'node-fetch',\n INodeFetchRequestOptions,\n Awaited<ReturnType<typeof fetch>>,\n typeof fetch\n> {\n private defaultConfigs: RequestInit;\n\n constructor(opts: { name: string; defaultConfigs: RequestInit; logger?: ILogger }) {\n super({ name: opts.name, variant: 'node-fetch' });\n const { name, defaultConfigs } = opts;\n this.name = name;\n opts?.logger?.info('Creating new network request worker instance! Name: %s', this.name);\n\n this.defaultConfigs = defaultConfigs;\n }\n\n override async send(opts: INodeFetchRequestOptions, logger?: ILogger) {\n const {\n url,\n method = HTTP.Methods.GET,\n params,\n body,\n headers,\n timeout,\n signal,\n ...rest\n } = opts;\n\n let timeoutId: NodeJS.Timeout | undefined;\n let timeoutController: AbortController | undefined;\n let effectiveSignal = signal;\n\n if (timeout) {\n timeoutController = new AbortController();\n timeoutId = setTimeout(() => {\n timeoutController?.abort();\n }, timeout);\n\n // Composed, never substituted: a timeout must not silently swallow the caller's own signal, or the caller would believe it cancelled a request that is in fact still running. Either source - and a signal already aborted before the call - aborts the request.\n effectiveSignal = signal\n ? AbortSignal.any([signal, timeoutController.signal])\n : timeoutController.signal;\n }\n\n const requestConfigs: RequestInit = {\n ...this.defaultConfigs,\n ...rest,\n method: method.toUpperCase(),\n body,\n headers,\n signal: effectiveSignal,\n };\n\n // `?` only when the url carries no query string of its own - a second `?` is not a separator, so the server would read the previous parameter's value as `1?extra=2`.\n const serializedParams = params ? toQueryString({ params }) : '';\n const requestUrl = serializedParams\n ? `${url}${url.includes(QueryStringSeparators.START) ? QueryStringSeparators.PAIR : QueryStringSeparators.START}${serializedParams}`\n : url;\n\n // The body is NEVER logged, only its size. `fetch` bodies are strings, and `redactSecrets` walks\n // object keys - so a JSON credential payload passed straight through as a string was printed in\n // full, with no key for the redactor to match on. Headers are normalised through `Headers` first\n // because the `string[][]` form is a list of tuples, which key matching cannot see either.\n const loggableConfigs = {\n ...requestConfigs,\n body: typeof body === 'string' ? `[body ${body.length} chars]` : body ? '[body]' : undefined,\n headers: headers ? Object.fromEntries(new Headers(headers)) : undefined,\n };\n\n logger\n ?.for(this.send.name)\n .info('URL: %s | Props: %s | Timeout: %s', url, redactSecrets(loggableConfigs), timeout);\n\n try {\n const rs = await fetch(requestUrl, requestConfigs);\n return rs;\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n }\n}\n\nexport interface INodeFetchNetworkRequestOptions {\n name: string;\n networkOptions: RequestInit & {\n baseUrl?: string;\n };\n}\n\nexport class NodeFetchNetworkRequest extends BaseNetworkRequest<'node-fetch'> {\n constructor(opts: INodeFetchNetworkRequestOptions) {\n const { name, networkOptions } = opts;\n const { headers, baseUrl, ...rest } = networkOptions;\n\n const userHeaders =\n headers instanceof Headers ? Object.fromEntries(headers.entries()) : headers;\n const mergedHeaders: AnyObject = {\n ['content-type']: 'application/json; charset=utf-8',\n ...userHeaders,\n };\n\n const defaultConfigs: Partial<RequestInit> = {\n ...rest,\n headers: mergedHeaders,\n };\n\n super({\n name,\n baseUrl,\n fetcher: new NodeFetcher({ name, defaultConfigs }),\n });\n }\n}\n"]}
1
+ {"version":3,"file":"node-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/node-fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { redactSecrets } from '@/common/redact';\nimport { HTTP, type THttpMethod } from '@/common/constants/http';\nimport { type AnyObject } from '@/common/types';\nimport {\n type IQueryStringOptions,\n QueryStringSeparators,\n toQueryString,\n} from '../../utilities/query-string';\n\nimport { BaseNetworkRequest } from '../base-network-request.helper';\nimport {\n AbstractNetworkFetchableHelper,\n type IRequestOptions,\n type TFetcherLogger,\n} from './base-fetcher';\n\nexport interface INodeFetchRequestOptions extends RequestInit, IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: AnyObject;\n}\n\n/** What `fetch` takes as a body as it is: encoding any of these again would change the bytes sent. A constructor is looked up on `globalThis` so a runtime without one (no `FormData`) just never matches it. */\nconst isRawBody = (body: unknown): boolean => {\n if (typeof body === 'string' || ArrayBuffer.isView(body) || body instanceof ArrayBuffer) {\n return true;\n }\n\n return ['Blob', 'FormData', 'URLSearchParams', 'ReadableStream'].some((name) => {\n const ctor = Reflect.get(globalThis, name);\n return typeof ctor === 'function' && body instanceof ctor;\n });\n};\n\nexport class NodeFetcher extends AbstractNetworkFetchableHelper<\n 'node-fetch',\n INodeFetchRequestOptions,\n Awaited<ReturnType<typeof fetch>>,\n typeof fetch\n> {\n private defaultConfigs: RequestInit;\n private queryString: IQueryStringOptions;\n\n constructor(opts: {\n name: string;\n defaultConfigs: RequestInit;\n /** How `params` are written into the url; the defaults are `node:querystring`'s. */\n queryString?: IQueryStringOptions;\n logger?: TFetcherLogger;\n }) {\n super({ name: opts.name, variant: 'node-fetch', worker: fetch });\n const { name, defaultConfigs } = opts;\n this.name = name;\n opts?.logger?.info('Creating new network request worker instance! Name: %s', this.name);\n\n this.defaultConfigs = defaultConfigs;\n this.queryString = opts.queryString ?? {};\n }\n\n /** A raw body passes through; a plain object or an array is JSON-encoded; no body stays no body. */\n protected serializeBody(opts: { body: unknown }): RequestInit['body'] | undefined {\n const { body } = opts;\n\n if (body === undefined || body === null) {\n return undefined;\n }\n\n return isRawBody(body) ? (body as RequestInit['body']) : JSON.stringify(body);\n }\n\n override async send(opts: INodeFetchRequestOptions, logger?: TFetcherLogger) {\n const {\n url,\n method = HTTP.Methods.GET,\n params,\n body,\n headers,\n timeout,\n signal,\n ...rest\n } = opts;\n\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n let timeoutController: AbortController | undefined;\n let effectiveSignal = signal;\n\n if (timeout) {\n timeoutController = new AbortController();\n timeoutId = setTimeout(() => {\n timeoutController?.abort();\n }, timeout);\n\n // Composed, never substituted: a timeout must not silently swallow the caller's own signal, or the caller would believe it cancelled a request that is in fact still running. Either source - and a signal already aborted before the call - aborts the request.\n effectiveSignal = signal\n ? AbortSignal.any([signal, timeoutController.signal])\n : timeoutController.signal;\n }\n\n const requestConfigs: RequestInit = {\n ...this.defaultConfigs,\n ...rest,\n method: method.toUpperCase(),\n body: this.serializeBody({ body }),\n // The call's headers REPLACE the defaults (a caller that sends a multipart body leaves the content type out so `fetch` can write the boundary); a call with none keeps them. Spreading an absent `headers` over the config used to erase the defaults.\n headers: headers ?? this.defaultConfigs.headers,\n signal: effectiveSignal,\n };\n\n // `?` only when the url carries no query string of its own - a second `?` is not a separator, so the server would read the previous parameter's value as `1?extra=2`.\n const serializedParams = params ? toQueryString({ params, ...this.queryString }) : '';\n const requestUrl = serializedParams\n ? `${url}${url.includes(QueryStringSeparators.START) ? QueryStringSeparators.PAIR : QueryStringSeparators.START}${serializedParams}`\n : url;\n\n // The body is NEVER logged, only its size. `fetch` bodies are strings, and `redactSecrets` walks\n // object keys - so a JSON credential payload passed straight through as a string was printed in\n // full, with no key for the redactor to match on. Headers are normalised through `Headers` first\n // because the `string[][]` form is a list of tuples, which key matching cannot see either.\n const loggableConfigs = {\n ...requestConfigs,\n body:\n typeof requestConfigs.body === 'string'\n ? `[body ${requestConfigs.body.length} chars]`\n : requestConfigs.body\n ? '[body]'\n : undefined,\n headers: requestConfigs.headers,\n };\n\n // Straight on the logger it was handed, never `logger.for(...)`: a host logger may carry only `debug` and `info`. With none handed, nothing is logged - no default logger is built, so a browser never reaches the node-only provider.\n logger?.debug(\n '[%s] URL: %s | Props: %s | Timeout: %s',\n this.send.name,\n url,\n redactSecrets(loggableConfigs),\n timeout,\n );\n\n try {\n const rs = await fetch(requestUrl, requestConfigs);\n return rs;\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n }\n}\n\nexport interface INodeFetchNetworkRequestOptions {\n name: string;\n networkOptions: RequestInit & {\n baseUrl?: string;\n /** How `params` are written into every url this request sends; see {@link IQueryStringOptions}. */\n queryString?: IQueryStringOptions;\n };\n}\n\nexport class NodeFetchNetworkRequest extends BaseNetworkRequest<'node-fetch'> {\n constructor(opts: INodeFetchNetworkRequestOptions) {\n const { name, networkOptions } = opts;\n const { headers, baseUrl, queryString, ...rest } = networkOptions;\n\n const userHeaders =\n headers instanceof Headers ? Object.fromEntries(headers.entries()) : headers;\n const mergedHeaders: AnyObject = {\n ['content-type']: 'application/json; charset=utf-8',\n ...userHeaders,\n };\n\n const defaultConfigs: Partial<RequestInit> = {\n ...rest,\n headers: mergedHeaders,\n };\n\n super({\n name,\n baseUrl,\n fetcher: new NodeFetcher({ name, defaultConfigs, queryString }),\n });\n }\n}\n"]}