@venizia/ignis-helpers 0.4.8-9 → 0.5.0-0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (261) hide show
  1. package/README.md +2 -3
  2. package/dist/esm/common/constants/app.d.ts +1 -3
  3. package/dist/esm/common/constants/app.js +1 -11
  4. package/dist/esm/common/constants/app.js.map +1 -1
  5. package/dist/esm/common/constants/http.d.ts +5 -0
  6. package/dist/esm/common/constants/http.js +6 -0
  7. package/dist/esm/common/constants/http.js.map +1 -1
  8. package/dist/esm/common/constants/mime.d.ts +0 -2
  9. package/dist/esm/common/constants/mime.js +0 -4
  10. package/dist/esm/common/constants/mime.js.map +1 -1
  11. package/dist/esm/common/redact.js +2 -0
  12. package/dist/esm/common/redact.js.map +1 -1
  13. package/dist/esm/common/types/class.d.ts +14 -12
  14. package/dist/esm/common/types/class.js.map +1 -1
  15. package/dist/esm/common/types/const-value.d.ts +3 -3
  16. package/dist/esm/common/types/const-value.js.map +1 -1
  17. package/dist/esm/common/types/field-mapping.d.ts +6 -8
  18. package/dist/esm/common/types/field-mapping.js +0 -10
  19. package/dist/esm/common/types/field-mapping.js.map +1 -1
  20. package/dist/esm/common/types/index.d.ts +1 -0
  21. package/dist/esm/common/types/index.js +1 -0
  22. package/dist/esm/common/types/index.js.map +1 -1
  23. package/dist/esm/common/types/injection.d.ts +1 -1
  24. package/dist/esm/common/types/injection.js.map +1 -1
  25. package/dist/esm/common/types/json.d.ts +14 -0
  26. package/dist/esm/common/types/json.js +2 -0
  27. package/dist/esm/common/types/json.js.map +1 -0
  28. package/dist/esm/common/types/utility.d.ts +0 -4
  29. package/dist/esm/common/types/utility.js.map +1 -1
  30. package/dist/esm/core.d.ts +5 -2
  31. package/dist/esm/core.js +5 -2
  32. package/dist/esm/core.js.map +1 -1
  33. package/dist/esm/modules/env/app-env.d.ts +17 -8
  34. package/dist/esm/modules/env/app-env.js +18 -15
  35. package/dist/esm/modules/env/app-env.js.map +1 -1
  36. package/dist/esm/modules/env/common/types.d.ts +22 -6
  37. package/dist/esm/modules/env/common/types.js.map +1 -1
  38. package/dist/esm/modules/logger/base/abstract.d.ts +6 -7
  39. package/dist/esm/modules/logger/base/abstract.js.map +1 -1
  40. package/dist/esm/modules/logger/base/base.d.ts +7 -8
  41. package/dist/esm/modules/logger/base/base.js.map +1 -1
  42. package/dist/esm/modules/logger/base/console.d.ts +6 -7
  43. package/dist/esm/modules/logger/base/console.js.map +1 -1
  44. package/dist/esm/modules/logger/common/types.d.ts +7 -7
  45. package/dist/esm/modules/logger/common/types.js.map +1 -1
  46. package/dist/esm/modules/logger/factory.js.map +1 -1
  47. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  48. package/dist/esm/modules/logger/hf/logger.d.ts +6 -7
  49. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  50. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  51. package/dist/esm/modules/logger/pino/destination.d.ts +1 -1
  52. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  53. package/dist/esm/modules/logger/pino/logger.d.ts +1 -2
  54. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  55. package/dist/esm/modules/logger/winston/formats.js +2 -2
  56. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  57. package/dist/esm/modules/logger/winston/logger.d.ts +1 -2
  58. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  59. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -1
  60. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -1
  61. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  62. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts +5 -0
  63. package/dist/esm/modules/network/http-request/base-network-request.helper.js +14 -17
  64. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  65. package/dist/esm/modules/network/http-request/common/constants.d.ts +2 -3
  66. package/dist/esm/modules/network/http-request/common/constants.js +2 -5
  67. package/dist/esm/modules/network/http-request/common/constants.js.map +1 -1
  68. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +40 -14
  69. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +181 -38
  70. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  71. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +206 -21
  72. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +433 -13
  73. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  74. package/dist/esm/modules/network/http-request/fetcher/common/body-limit.d.ts +36 -0
  75. package/dist/esm/modules/network/http-request/fetcher/common/body-limit.js +119 -0
  76. package/dist/esm/modules/network/http-request/fetcher/common/body-limit.js.map +1 -0
  77. package/dist/esm/modules/network/http-request/fetcher/common/errors.d.ts +40 -0
  78. package/dist/esm/modules/network/http-request/fetcher/common/errors.js +37 -0
  79. package/dist/esm/modules/network/http-request/fetcher/common/errors.js.map +1 -0
  80. package/dist/esm/modules/network/http-request/fetcher/common/guard.d.ts +27 -0
  81. package/dist/esm/modules/network/http-request/fetcher/common/guard.js +2 -0
  82. package/dist/esm/modules/network/http-request/fetcher/common/guard.js.map +1 -0
  83. package/dist/esm/modules/network/http-request/fetcher/common/index.d.ts +6 -0
  84. package/dist/esm/modules/network/http-request/fetcher/common/index.js +6 -0
  85. package/dist/esm/modules/network/http-request/fetcher/common/index.js.map +1 -1
  86. package/dist/esm/modules/network/http-request/fetcher/common/request-context.d.ts +15 -0
  87. package/dist/esm/modules/network/http-request/fetcher/common/request-context.js +11 -0
  88. package/dist/esm/modules/network/http-request/fetcher/common/request-context.js.map +1 -0
  89. package/dist/esm/modules/network/http-request/fetcher/common/response-reader.d.ts +9 -0
  90. package/dist/esm/modules/network/http-request/fetcher/common/response-reader.js +14 -0
  91. package/dist/esm/modules/network/http-request/fetcher/common/response-reader.js.map +1 -0
  92. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts +65 -1
  93. package/dist/esm/modules/network/http-request/fetcher/common/types.js.map +1 -1
  94. package/dist/esm/modules/network/http-request/fetcher/common/utilities.d.ts +68 -0
  95. package/dist/esm/modules/network/http-request/fetcher/common/utilities.js +143 -0
  96. package/dist/esm/modules/network/http-request/fetcher/common/utilities.js.map +1 -0
  97. package/dist/esm/modules/network/http-request/fetcher/index.d.ts +2 -1
  98. package/dist/esm/modules/network/http-request/fetcher/index.js +2 -1
  99. package/dist/esm/modules/network/http-request/fetcher/index.js.map +1 -1
  100. package/dist/esm/modules/network/http-request/fetcher/native-fetcher.d.ts +83 -0
  101. package/dist/esm/modules/network/http-request/fetcher/native-fetcher.js +221 -0
  102. package/dist/esm/modules/network/http-request/fetcher/native-fetcher.js.map +1 -0
  103. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts +4 -4
  104. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  105. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  106. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts +3 -5
  107. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +0 -8
  108. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  109. package/dist/esm/modules/network/utilities/index.d.ts +1 -0
  110. package/dist/esm/modules/network/utilities/index.js +1 -0
  111. package/dist/esm/modules/network/utilities/index.js.map +1 -1
  112. package/dist/esm/modules/network/utilities/query-string.d.ts +7 -24
  113. package/dist/esm/modules/network/utilities/query-string.js +3 -17
  114. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  115. package/dist/esm/modules/network/utilities/url-builder.d.ts +39 -0
  116. package/dist/esm/modules/network/utilities/url-builder.js +102 -0
  117. package/dist/esm/modules/network/utilities/url-builder.js.map +1 -0
  118. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +0 -5
  119. package/dist/esm/modules/network/utilities/url-safety/common/constants.js +0 -4
  120. package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
  121. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts +38 -0
  122. package/dist/esm/modules/network/utilities/url-safety/common/errors.js +33 -1
  123. package/dist/esm/modules/network/utilities/url-safety/common/errors.js.map +1 -1
  124. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts +26 -3
  125. package/dist/esm/modules/network/utilities/url-safety/common/types.js.map +1 -1
  126. package/dist/esm/modules/network/utilities/url-safety/guard.d.ts +46 -0
  127. package/dist/esm/modules/network/utilities/url-safety/guard.js +145 -0
  128. package/dist/esm/modules/network/utilities/url-safety/guard.js.map +1 -0
  129. package/dist/esm/modules/network/utilities/url-safety/index.d.ts +1 -1
  130. package/dist/esm/modules/network/utilities/url-safety/index.js +1 -1
  131. package/dist/esm/modules/network/utilities/url-safety/index.js.map +1 -1
  132. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts +52 -2
  133. package/dist/esm/modules/network/utilities/url-safety/policy.js +161 -14
  134. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  135. package/dist/esm/modules/queue/bullmq/helper.d.ts +61 -12
  136. package/dist/esm/modules/queue/bullmq/helper.js +125 -10
  137. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  138. package/dist/esm/modules/queue/common/constants.d.ts +6 -2
  139. package/dist/esm/modules/queue/common/constants.js +6 -4
  140. package/dist/esm/modules/queue/common/constants.js.map +1 -1
  141. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +2 -4
  142. package/dist/esm/modules/queue/internal/sequential/common/types.js +0 -4
  143. package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
  144. package/dist/esm/modules/queue/kafka/base.d.ts +1 -1
  145. package/dist/esm/modules/queue/kafka/base.js +13 -2
  146. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  147. package/dist/esm/modules/queue/kafka/common/constants.d.ts +0 -4
  148. package/dist/esm/modules/queue/kafka/common/constants.js +0 -8
  149. package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
  150. package/dist/esm/modules/redis/base/abstract.helper.d.ts +13 -2
  151. package/dist/esm/modules/redis/base/abstract.helper.js +53 -45
  152. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  153. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -2
  154. package/dist/esm/modules/redis/cluster/cluster.helper.js +21 -9
  155. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  156. package/dist/esm/modules/redis/cluster/index.d.ts +1 -0
  157. package/dist/esm/modules/redis/cluster/index.js +1 -0
  158. package/dist/esm/modules/redis/cluster/index.js.map +1 -1
  159. package/dist/esm/modules/redis/cluster/types.d.ts +20 -0
  160. package/dist/esm/modules/redis/cluster/types.js +2 -0
  161. package/dist/esm/modules/redis/cluster/types.js.map +1 -0
  162. package/dist/esm/modules/redis/common/constants.d.ts +15 -19
  163. package/dist/esm/modules/redis/common/constants.js +16 -18
  164. package/dist/esm/modules/redis/common/constants.js.map +1 -1
  165. package/dist/esm/modules/redis/common/types.d.ts +10 -60
  166. package/dist/esm/modules/redis/common/types.js.map +1 -1
  167. package/dist/esm/modules/redis/factory.d.ts +7 -25
  168. package/dist/esm/modules/redis/factory.js +9 -18
  169. package/dist/esm/modules/redis/factory.js.map +1 -1
  170. package/dist/esm/modules/redis/sentinel/constants.d.ts +14 -0
  171. package/dist/esm/modules/redis/sentinel/constants.js +11 -0
  172. package/dist/esm/modules/redis/sentinel/constants.js.map +1 -0
  173. package/dist/esm/modules/redis/sentinel/index.d.ts +2 -0
  174. package/dist/esm/modules/redis/sentinel/index.js +2 -0
  175. package/dist/esm/modules/redis/sentinel/index.js.map +1 -1
  176. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -2
  177. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +25 -15
  178. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  179. package/dist/esm/modules/redis/sentinel/types.d.ts +26 -0
  180. package/dist/esm/modules/redis/sentinel/types.js +2 -0
  181. package/dist/esm/modules/redis/sentinel/types.js.map +1 -0
  182. package/dist/esm/modules/redis/single/index.d.ts +1 -0
  183. package/dist/esm/modules/redis/single/index.js +1 -0
  184. package/dist/esm/modules/redis/single/index.js.map +1 -1
  185. package/dist/esm/modules/redis/single/single.helper.d.ts +1 -2
  186. package/dist/esm/modules/redis/single/single.helper.js +5 -6
  187. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  188. package/dist/esm/modules/redis/single/types.d.ts +15 -0
  189. package/dist/esm/modules/redis/single/types.js +2 -0
  190. package/dist/esm/modules/redis/single/types.js.map +1 -0
  191. package/dist/esm/modules/retry/helper.d.ts +3 -1
  192. package/dist/esm/modules/retry/helper.js +8 -4
  193. package/dist/esm/modules/retry/helper.js.map +1 -1
  194. package/dist/esm/modules/secrets/base/abstract.helper.js +6 -1
  195. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  196. package/dist/esm/modules/secrets/common/types/registration.d.ts +25 -6
  197. package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
  198. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -1
  199. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  200. package/dist/esm/modules/secrets/factory.js +7 -6
  201. package/dist/esm/modules/secrets/factory.js.map +1 -1
  202. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +12 -10
  203. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +50 -25
  204. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  205. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
  206. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +2 -2
  207. package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
  208. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +3 -1
  209. package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
  210. package/dist/esm/modules/socket/socket-io/server/helper.d.ts +2 -2
  211. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  212. package/dist/esm/modules/storage/base.d.ts +24 -60
  213. package/dist/esm/modules/storage/base.js +66 -123
  214. package/dist/esm/modules/storage/base.js.map +1 -1
  215. package/dist/esm/modules/storage/bun-s3/helper.d.ts +21 -35
  216. package/dist/esm/modules/storage/bun-s3/helper.js +126 -128
  217. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  218. package/dist/esm/modules/storage/bun-s3/utility.d.ts +13 -7
  219. package/dist/esm/modules/storage/bun-s3/utility.js +63 -45
  220. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  221. package/dist/esm/modules/storage/common/constants.d.ts +29 -2
  222. package/dist/esm/modules/storage/common/constants.js +29 -4
  223. package/dist/esm/modules/storage/common/constants.js.map +1 -1
  224. package/dist/esm/modules/storage/common/errors.d.ts +9 -0
  225. package/dist/esm/modules/storage/common/errors.js +9 -0
  226. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  227. package/dist/esm/modules/storage/common/types.d.ts +90 -61
  228. package/dist/esm/modules/storage/common/types.js.map +1 -1
  229. package/dist/esm/modules/storage/common/utility.d.ts +8 -0
  230. package/dist/esm/modules/storage/common/utility.js +14 -2
  231. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  232. package/dist/esm/modules/storage/disk/helper.d.ts +3 -8
  233. package/dist/esm/modules/storage/disk/helper.js +1 -0
  234. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  235. package/dist/esm/modules/storage/in-memory/helper.d.ts +2 -3
  236. package/dist/esm/modules/storage/in-memory/helper.js.map +1 -1
  237. package/dist/esm/modules/worker-thread/common/types.d.ts +2 -2
  238. package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
  239. package/dist/esm/modules/worker-thread/thread/abstract.d.ts +2 -2
  240. package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
  241. package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -1
  242. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  243. package/dist/esm/utilities/module.utility.d.ts +8 -5
  244. package/dist/esm/utilities/module.utility.js +5 -1
  245. package/dist/esm/utilities/module.utility.js.map +1 -1
  246. package/dist/esm/utilities/parse.utility.d.ts +34 -6
  247. package/dist/esm/utilities/parse.utility.js +82 -15
  248. package/dist/esm/utilities/parse.utility.js.map +1 -1
  249. package/dist/esm/utilities/performance.utility.d.ts +3 -3
  250. package/dist/esm/utilities/performance.utility.js.map +1 -1
  251. package/dist/esm/utilities/promise.utility.d.ts +1 -1
  252. package/dist/esm/utilities/promise.utility.js.map +1 -1
  253. package/dist/esm/utilities/request.utility.d.ts +9 -11
  254. package/dist/esm/utilities/request.utility.js.map +1 -1
  255. package/package.json +3 -3
  256. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +0 -42
  257. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +0 -112
  258. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +0 -1
  259. package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts +0 -95
  260. package/dist/esm/modules/network/utilities/url-safety/ingest.js +0 -328
  261. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +0 -1
@@ -0,0 +1,14 @@
1
+ /** A JSON scalar. */
2
+ export type TJsonPrimitive = string | number | boolean | null;
3
+ /**
4
+ * Any value JSON can hold: a scalar, an array of JSON values, or an object whose values are JSON values. The type of a
5
+ * `jsonb` or JSON column that stores whatever the app puts in it (`jValue` of the data-type enrichers).
6
+ *
7
+ * A value typed as an `interface` is not assignable, because an interface has no index signature: spread it
8
+ * (`{ ...meta }`) or declare its shape as a `type`. A `readonly` array is refused too, at any depth, so an `as const` object that holds one is refused:
9
+ * copy each array (`[...list]`). An `as const` object of scalars is accepted.
10
+ */
11
+ export type TJsonValue = TJsonPrimitive | TJsonValue[] | {
12
+ [key: string]: TJsonValue;
13
+ };
14
+ //# sourceMappingURL=json.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=json.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json.js","sourceRoot":"","sources":["../../../../src/common/types/json.ts"],"names":[],"mappings":"","sourcesContent":["/** A JSON scalar. */\nexport type TJsonPrimitive = string | number | boolean | null;\n\n/**\n * Any value JSON can hold: a scalar, an array of JSON values, or an object whose values are JSON values. The type of a\n * `jsonb` or JSON column that stores whatever the app puts in it (`jValue` of the data-type enrichers).\n *\n * A value typed as an `interface` is not assignable, because an interface has no index signature: spread it\n * (`{ ...meta }`) or declare its shape as a `type`. A `readonly` array is refused too, at any depth, so an `as const` object that holds one is refused:\n * copy each array (`[...list]`). An `as const` object of scalars is accepted.\n */\nexport type TJsonValue = TJsonPrimitive | TJsonValue[] | { [key: string]: TJsonValue };\n"]}
@@ -1,9 +1,5 @@
1
1
  /** `T`, `undefined` or `null`. */
2
2
  export type TNullable<T> = T | undefined | null;
3
- /** Escape hatch for a value of unknown shape; prefer a real type. */
4
- export type AnyType = any;
5
- /** An object with any string, number or symbol keys. */
6
- export type AnyObject = Record<string | symbol | number, any>;
7
3
  /** An options object of shape `T`; empty by default. */
8
4
  export type TOptions<T extends object = {}> = T;
9
5
  /** `T` or a promise of `T`; `await` it to get `T` either way. */
@@ -1 +1 @@
1
- {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../src/common/types/utility.ts"],"names":[],"mappings":"","sourcesContent":["/** `T`, `undefined` or `null`. */\nexport type TNullable<T> = T | undefined | null;\n\n/** Escape hatch for a value of unknown shape; prefer a real type. */\nexport type AnyType = any;\n/** An object with any string, number or symbol keys. */\nexport type AnyObject = Record<string | symbol | number, any>;\n\n/** An options object of shape `T`; empty by default. */\nexport type TOptions<T extends object = {}> = T;\n\n/** `T` or a promise of `T`; `await` it to get `T` either way. */\nexport type ValueOrPromise<T> = T | Promise<T>;\n/** The union of the property value types of `T`. */\nexport type ValueOf<T> = T[keyof T];\n\n/** `T` with the keys `K` made optional. */\nexport type ValueOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;\n/** `T` with every key optional except `K`. */\nexport type ValueOptionalExcept<T, K extends keyof T> = Pick<T, K> & Partial<Omit<T, K>>;\n\n/** Flattens an intersection of types into one object type, for readable hovers. */\nexport type TPrettify<T> = { [K in keyof T]: T[K] } & {};\n"]}
1
+ {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../src/common/types/utility.ts"],"names":[],"mappings":"","sourcesContent":["/** `T`, `undefined` or `null`. */\nexport type TNullable<T> = T | undefined | null;\n\n/** An options object of shape `T`; empty by default. */\nexport type TOptions<T extends object = {}> = T;\n\n/** `T` or a promise of `T`; `await` it to get `T` either way. */\nexport type ValueOrPromise<T> = T | Promise<T>;\n/** The union of the property value types of `T`. */\nexport type ValueOf<T> = T[keyof T];\n\n/** `T` with the keys `K` made optional. */\nexport type ValueOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;\n/** `T` with every key optional except `K`. */\nexport type ValueOptionalExcept<T, K extends keyof T> = Pick<T, K> & Partial<Omit<T, K>>;\n\n/** Flattens an intersection of types into one object type, for readable hovers. */\nexport type TPrettify<T> = { [K in keyof T]: T[K] } & {};\n"]}
@@ -6,16 +6,19 @@ export type { ILogger, ILoggerProvider, TLogLevel } from './modules/logger/commo
6
6
  export { ConsoleLogger } from './modules/logger/base/console.js';
7
7
  export { LoggerFactory } from './modules/logger/factory.js';
8
8
  export * from './modules/network/http-request/fetcher/base-fetcher.js';
9
- export * from './modules/network/http-request/fetcher/node-fetcher.js';
9
+ export * from './modules/network/http-request/fetcher/common/index.js';
10
+ export * from './modules/network/http-request/fetcher/native-fetcher.js';
10
11
  export * from './modules/network/http-request/base-network-request.helper.js';
11
12
  export * from './modules/pool/index.js';
12
13
  export * from './modules/queue/internal/hf/index.js';
13
14
  export * from './modules/temporal/index.js';
14
15
  export * from './modules/uid/index.js';
15
16
  export * from './modules/network/utilities/url-safety/common/constants.js';
16
- export type { IUrlSafetyPolicy } from './modules/network/utilities/url-safety/common/types.js';
17
+ export type { IUrlSafetyPolicy, IUrlTrustedHosts, TTrustedOrigin, } from './modules/network/utilities/url-safety/common/types.js';
18
+ export { UrlFetchError, UrlSafetyErrors, } from './modules/network/utilities/url-safety/common/errors.js';
17
19
  export * from './modules/network/utilities/url-safety/policy.js';
18
20
  export * from './modules/network/utilities/query-string.js';
21
+ export * from './modules/network/utilities/url-builder.js';
19
22
  export { RetryBackoffStrategies, RetryJitterModes } from './modules/retry/common/constants.js';
20
23
  export type { TRetryBackoffStrategy, TRetryJitterMode } from './modules/retry/common/constants.js';
21
24
  export type { IRetryBackoffOptions, IRetryContext } from './modules/retry/common/types.js';
package/dist/esm/core.js CHANGED
@@ -9,20 +9,23 @@ export { LogLevels } from './modules/logger/common/types.js';
9
9
  export { ConsoleLogger } from './modules/logger/base/console.js';
10
10
  export { LoggerFactory } from './modules/logger/factory.js';
11
11
  export * from './modules/network/http-request/fetcher/base-fetcher.js';
12
+ export * from './modules/network/http-request/fetcher/common/index.js';
12
13
  // The node fetcher carries no node builtin - its one `querystring.stringify` is written out - so the
13
14
  // framework HTTP layer is reachable from a browser bundle, and a connector on HTTP need not
14
15
  // re-implement one.
15
- export * from './modules/network/http-request/fetcher/node-fetcher.js';
16
+ export * from './modules/network/http-request/fetcher/native-fetcher.js';
16
17
  export * from './modules/network/http-request/base-network-request.helper.js';
17
18
  export * from './modules/pool/index.js';
18
19
  export * from './modules/queue/internal/hf/index.js';
19
20
  export * from './modules/temporal/index.js';
20
21
  export * from './modules/uid/index.js';
21
22
  // The url guard, pure half only: `UrlPolicy` decides a url and a literal address with string and
22
- // number work. Its sibling `UrlIngest` reaches `node:dns` and stays out of this subpath.
23
+ // number work. Its sibling `UrlGuard` reaches `node:dns` and stays out of this subpath.
23
24
  export * from './modules/network/utilities/url-safety/common/constants.js';
25
+ export { UrlFetchError, UrlSafetyErrors, } from './modules/network/utilities/url-safety/common/errors.js';
24
26
  export * from './modules/network/utilities/url-safety/policy.js';
25
27
  export * from './modules/network/utilities/query-string.js';
28
+ export * from './modules/network/utilities/url-builder.js';
26
29
  export { RetryBackoffStrategies, RetryJitterModes } from './modules/retry/common/constants.js';
27
30
  export { RetryHelper } from './modules/retry/helper.js';
28
31
  export { SlugHelper } from './modules/slug/helper.js';
@@ -1 +1 @@
1
- {"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,6FAA6F;AAC7F,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,6HAA6H;AAC7H,iHAAiH;AACjH,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,cAAc,qDAAqD,CAAC;AACpE,qGAAqG;AACrG,4FAA4F;AAC5F,oBAAoB;AACpB,cAAc,qDAAqD,CAAC;AACpE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,iGAAiG;AACjG,yFAAyF;AACzF,cAAc,yDAAyD,CAAC;AAExE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0CAA0C,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAG5F,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAcrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,gGAAgG;AAChG,6FAA6F;AAC7F,iGAAiG;AACjG,0DAA0D;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,uHAAuH;AACvH,gGAAgG;AAChG,0EAA0E;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,4CAA4C,CAAC;AAOlE,+FAA+F;AAC/F,6GAA6G;AAC7G,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC","sourcesContent":["export { BaseHelper } from './modules/base';\n// By name, never `export *` from `./modules/env`: that barrel also carries `Environment` and\n// `applicationEnvironment`, both of which read `process.env`.\nexport { EnvironmentNames } from './modules/env/names';\nexport * from './modules/error';\nexport { LogLevels } from './modules/logger/common/types';\nexport type { ILogger, ILoggerProvider, TLogLevel } from './modules/logger/common/types';\n// The one way to get a logger, the same in the browser and on the server: `LoggerFactory` imports nothing from node, and its\n// default provider is the console. An application chooses another with `LoggerFactory.use({ provider, level })`.\nexport { ConsoleLogger } from './modules/logger/base/console';\nexport { LoggerFactory } from './modules/logger/factory';\nexport * from './modules/network/http-request/fetcher/base-fetcher';\n// The node fetcher carries no node builtin - its one `querystring.stringify` is written out - so the\n// framework HTTP layer is reachable from a browser bundle, and a connector on HTTP need not\n// re-implement one.\nexport * from './modules/network/http-request/fetcher/node-fetcher';\nexport * from './modules/network/http-request/base-network-request.helper';\nexport * from './modules/pool';\nexport * from './modules/queue/internal/hf';\nexport * from './modules/temporal';\nexport * from './modules/uid';\n// The url guard, pure half only: `UrlPolicy` decides a url and a literal address with string and\n// number work. Its sibling `UrlIngest` reaches `node:dns` and stays out of this subpath.\nexport * from './modules/network/utilities/url-safety/common/constants';\nexport type { IUrlSafetyPolicy } from './modules/network/utilities/url-safety/common/types';\nexport * from './modules/network/utilities/url-safety/policy';\nexport * from './modules/network/utilities/query-string';\nexport { RetryBackoffStrategies, RetryJitterModes } from './modules/retry/common/constants';\nexport type { TRetryBackoffStrategy, TRetryJitterMode } from './modules/retry/common/constants';\nexport type { IRetryBackoffOptions, IRetryContext } from './modules/retry/common/types';\nexport { RetryHelper } from './modules/retry/helper';\nexport { SlugHelper } from './modules/slug/helper';\nexport { TreeBuilder } from './modules/tree/builder';\nexport type {\n IBuildOptions,\n IHeightWhereOptions,\n ILeavesOptions,\n INodeWithPath,\n IPrintOptions,\n ITreeNode,\n IWalkAsyncOptions,\n IWalkOptions,\n TNodePredicate,\n TOnVisit,\n TOnVisitAsync,\n} from './modules/tree/common/types';\nexport { TreeWalker } from './modules/tree/walk';\n\n// Pure value/type utilities that already live under the root barrel's `./utilities` re-export -\n// that barrel also carries node-only siblings (module.utility.ts, request.utility.ts), so it\n// cannot itself become a subpath. Named one at a time here instead of widening the barrel: every\n// symbol below is verified free of node builtins/globals.\nexport { BuildInfoRegistry } from './utilities/build-info.utility';\nexport type { IBuildInfo, TBuildInfoRecord } from './utilities/build-info.utility';\nexport { EchoUtility } from './utilities/echo.utility';\nexport { ParseUtility } from './utilities/parse.utility';\nexport { PerformanceUtility } from './utilities/performance.utility';\nexport { PromiseUtility } from './utilities/promise.utility';\nexport { RecordUtility } from './utilities/record.utility';\nexport { FormBodyUtility, RequestBodyErrors } from './utilities/form-body.utility';\nexport { ProjectRootRegistry } from './utilities/project-root.utility';\n\n// `ECDH` is the one crypto algorithm that is browser-pure: it runs over `crypto.subtle`, `btoa` and `atob`. It and its\n// base class come by leaf path, never the algorithms barrel, which also carries `AES` and `RSA`\n// (server code: they use `Buffer`, and `AES` reads files with `node:fs`).\nexport { AbstractCryptoAlgorithm } from './modules/crypto/algorithms/abstract.algorithm';\nexport { ECDH } from './modules/crypto/algorithms/ecdh.algorithm';\nexport type {\n ECDHAlgorithmType,\n IECDHEncryptedPayload,\n IECDHExtraOptions,\n} from './modules/crypto/algorithms/ecdh.algorithm';\n\n// Type-only: erased at compile time, so re-exporting these carries no runtime/bundle cost even\n// though the concrete classes they describe (the other crypto algorithms, the ioredis-backed helper) are not\n// themselves part of this pure surface.\nexport { AESAlgorithms } from './modules/crypto/algorithms/aes.constants';\nexport type { AESAlgorithmType } from './modules/crypto/algorithms/aes.constants';\nexport type { IRedisHelper } from './modules/redis/common/interfaces';\n"]}
1
+ {"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,6FAA6F;AAC7F,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,6HAA6H;AAC7H,iHAAiH;AACjH,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,cAAc,qDAAqD,CAAC;AACpE,cAAc,+CAA+C,CAAC;AAC9D,qGAAqG;AACrG,4FAA4F;AAC5F,oBAAoB;AACpB,cAAc,uDAAuD,CAAC;AACtE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,iGAAiG;AACjG,wFAAwF;AACxF,cAAc,yDAAyD,CAAC;AAMxE,OAAO,EACL,aAAa,EACb,eAAe,GAChB,MAAM,sDAAsD,CAAC;AAC9D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAG5F,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAcrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,gGAAgG;AAChG,6FAA6F;AAC7F,iGAAiG;AACjG,0DAA0D;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,uHAAuH;AACvH,gGAAgG;AAChG,0EAA0E;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,4CAA4C,CAAC;AAOlE,+FAA+F;AAC/F,6GAA6G;AAC7G,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC","sourcesContent":["export { BaseHelper } from './modules/base';\n// By name, never `export *` from `./modules/env`: that barrel also carries `Environment` and\n// `applicationEnvironment`, both of which read `process.env`.\nexport { EnvironmentNames } from './modules/env/names';\nexport * from './modules/error';\nexport { LogLevels } from './modules/logger/common/types';\nexport type { ILogger, ILoggerProvider, TLogLevel } from './modules/logger/common/types';\n// The one way to get a logger, the same in the browser and on the server: `LoggerFactory` imports nothing from node, and its\n// default provider is the console. An application chooses another with `LoggerFactory.use({ provider, level })`.\nexport { ConsoleLogger } from './modules/logger/base/console';\nexport { LoggerFactory } from './modules/logger/factory';\nexport * from './modules/network/http-request/fetcher/base-fetcher';\nexport * from './modules/network/http-request/fetcher/common';\n// The node fetcher carries no node builtin - its one `querystring.stringify` is written out - so the\n// framework HTTP layer is reachable from a browser bundle, and a connector on HTTP need not\n// re-implement one.\nexport * from './modules/network/http-request/fetcher/native-fetcher';\nexport * from './modules/network/http-request/base-network-request.helper';\nexport * from './modules/pool';\nexport * from './modules/queue/internal/hf';\nexport * from './modules/temporal';\nexport * from './modules/uid';\n// The url guard, pure half only: `UrlPolicy` decides a url and a literal address with string and\n// number work. Its sibling `UrlGuard` reaches `node:dns` and stays out of this subpath.\nexport * from './modules/network/utilities/url-safety/common/constants';\nexport type {\n IUrlSafetyPolicy,\n IUrlTrustedHosts,\n TTrustedOrigin,\n} from './modules/network/utilities/url-safety/common/types';\nexport {\n UrlFetchError,\n UrlSafetyErrors,\n} from './modules/network/utilities/url-safety/common/errors';\nexport * from './modules/network/utilities/url-safety/policy';\nexport * from './modules/network/utilities/query-string';\nexport * from './modules/network/utilities/url-builder';\nexport { RetryBackoffStrategies, RetryJitterModes } from './modules/retry/common/constants';\nexport type { TRetryBackoffStrategy, TRetryJitterMode } from './modules/retry/common/constants';\nexport type { IRetryBackoffOptions, IRetryContext } from './modules/retry/common/types';\nexport { RetryHelper } from './modules/retry/helper';\nexport { SlugHelper } from './modules/slug/helper';\nexport { TreeBuilder } from './modules/tree/builder';\nexport type {\n IBuildOptions,\n IHeightWhereOptions,\n ILeavesOptions,\n INodeWithPath,\n IPrintOptions,\n ITreeNode,\n IWalkAsyncOptions,\n IWalkOptions,\n TNodePredicate,\n TOnVisit,\n TOnVisitAsync,\n} from './modules/tree/common/types';\nexport { TreeWalker } from './modules/tree/walk';\n\n// Pure value/type utilities that already live under the root barrel's `./utilities` re-export -\n// that barrel also carries node-only siblings (module.utility.ts, request.utility.ts), so it\n// cannot itself become a subpath. Named one at a time here instead of widening the barrel: every\n// symbol below is verified free of node builtins/globals.\nexport { BuildInfoRegistry } from './utilities/build-info.utility';\nexport type { IBuildInfo, TBuildInfoRecord } from './utilities/build-info.utility';\nexport { EchoUtility } from './utilities/echo.utility';\nexport { ParseUtility } from './utilities/parse.utility';\nexport { PerformanceUtility } from './utilities/performance.utility';\nexport { PromiseUtility } from './utilities/promise.utility';\nexport { RecordUtility } from './utilities/record.utility';\nexport { FormBodyUtility, RequestBodyErrors } from './utilities/form-body.utility';\nexport { ProjectRootRegistry } from './utilities/project-root.utility';\n\n// `ECDH` is the one crypto algorithm that is browser-pure: it runs over `crypto.subtle`, `btoa` and `atob`. It and its\n// base class come by leaf path, never the algorithms barrel, which also carries `AES` and `RSA`\n// (server code: they use `Buffer`, and `AES` reads files with `node:fs`).\nexport { AbstractCryptoAlgorithm } from './modules/crypto/algorithms/abstract.algorithm';\nexport { ECDH } from './modules/crypto/algorithms/ecdh.algorithm';\nexport type {\n ECDHAlgorithmType,\n IECDHEncryptedPayload,\n IECDHExtraOptions,\n} from './modules/crypto/algorithms/ecdh.algorithm';\n\n// Type-only: erased at compile time, so re-exporting these carries no runtime/bundle cost even\n// though the concrete classes they describe (the other crypto algorithms, the ioredis-backed helper) are not\n// themselves part of this pure surface.\nexport { AESAlgorithms } from './modules/crypto/algorithms/aes.constants';\nexport type { AESAlgorithmType } from './modules/crypto/algorithms/aes.constants';\nexport type { IRedisHelper } from './modules/redis/common/interfaces';\n"]}
@@ -1,6 +1,6 @@
1
1
  import { BaseHelper } from '../base.js';
2
2
  import { EnvironmentNames } from './names.js';
3
- import { type IApplicationEnvironment } from './common/index.js';
3
+ import { type IApplicationEnvironment, type IApplicationEnvironmentDefaultedTransformOptions, type IApplicationEnvironmentTransformOptions } from './common/index.js';
4
4
  /** Adds the `NODE_ENV` reads to {@link EnvironmentNames}. Every name and set is inherited, so `Environment.PRODUCTION`, `Environment.COMMON_ENVS` and `Environment.DEVELOPMENT_ENVS` keep resolving here; only these two members need a `process`. */
5
5
  export declare class Environment extends EnvironmentNames {
6
6
  /** `NODE_ENV` exactly as the host has it, `undefined` when unset. Destructured on purpose: `bun build` rewrites `process.env.NODE_ENV` to a literal at build time, a destructured read stays a runtime read. */
@@ -16,7 +16,7 @@ export declare class ApplicationEnvironment extends BaseHelper implements IAppli
16
16
  private arguments;
17
17
  constructor(opts: {
18
18
  prefix: string;
19
- envs: Record<string, string | number | undefined>;
19
+ envs: Record<string, string | undefined>;
20
20
  });
21
21
  /**
22
22
  * Reads one name. A line that is present but empty - `KEY=`, or padded to `KEY= ` by a hand
@@ -29,13 +29,22 @@ export declare class ApplicationEnvironment extends BaseHelper implements IAppli
29
29
  * receives `''` unchanged, so no existing read changes shape. `'0'` and `'false'` are values and
30
30
  * are never normalised.
31
31
  */
32
- get<ReturnType, BeforeTransformType = unknown>(key: string, opts?: {
33
- defaultValue?: ReturnType;
34
- transform?: (value: BeforeTransformType) => ReturnType;
35
- }): ReturnType;
36
- set<ValueType>(key: string, value: ValueType): void;
32
+ get(key: string): string | undefined;
33
+ get(key: string, opts: {
34
+ defaultValue: string;
35
+ }): string;
36
+ get<R>(key: string, opts: IApplicationEnvironmentDefaultedTransformOptions<R>): R;
37
+ get<R>(key: string, opts: IApplicationEnvironmentTransformOptions<R>): R;
38
+ /**
39
+ * A variable the app cannot run without: it is set and not blank (the rule `get` applies to a `defaultValue`), or this throws an error naming the key. The check runs before `transform`, so `transform` receives a `string`; a `transform` that answers null or undefined throws too. A required value has no `defaultValue`.
40
+ */
41
+ getRequired(key: string): string;
42
+ getRequired<R>(key: string, opts: {
43
+ transform: (raw: string) => R | null | undefined;
44
+ }): R;
45
+ set(key: string, value: string | undefined): void;
37
46
  merge(opts: {
38
- envs: Record<string, string>;
47
+ envs: Record<string, string | undefined>;
39
48
  }): void;
40
49
  isDevelopment(): boolean;
41
50
  keys(): string[];
@@ -1,5 +1,6 @@
1
1
  import { ParseUtility } from '../../utilities/parse.utility.js';
2
2
  import { BaseHelper } from '../base.js';
3
+ import { getError } from '../error/index.js';
3
4
  import { EnvironmentNames } from './names.js';
4
5
  /** Adds the `NODE_ENV` reads to {@link EnvironmentNames}. Every name and set is inherited, so `Environment.PRODUCTION`, `Environment.COMMON_ENVS` and `Environment.DEVELOPMENT_ENVS` keep resolving here; only these two members need a `process`. */
5
6
  export class Environment extends EnvironmentNames {
@@ -28,26 +29,28 @@ export class ApplicationEnvironment extends BaseHelper {
28
29
  this.arguments[key] = opts.envs[key];
29
30
  }
30
31
  }
31
- /**
32
- * Reads one name. A line that is present but empty - `KEY=`, or padded to `KEY= ` by a hand
33
- * edit - is a pipeline that forgot to export the value, not a value: it is normalised to
34
- * `undefined` so `defaultValue` applies, and `transform` is handed that `undefined` rather than
35
- * the empty string.
36
- *
37
- * The normalisation runs ONLY when the caller supplied a `defaultValue`, because that call site
38
- * has already declared what it wants when the name carries nothing. A caller without one still
39
- * receives `''` unchanged, so no existing read changes shape. `'0'` and `'false'` are values and
40
- * are never normalised.
41
- */
42
32
  get(key, opts) {
43
33
  const raw = this.arguments[key];
44
- const isBlank = raw === undefined || raw === null || (typeof raw === 'string' && !raw.trim());
34
+ const isBlank = raw == null || (typeof raw === 'string' && !raw.trim());
45
35
  const rs = opts?.defaultValue !== undefined && isBlank ? undefined : raw;
46
36
  if (!opts?.transform) {
47
- return (rs ?? opts?.defaultValue);
37
+ return rs ?? opts?.defaultValue;
48
38
  }
49
- const transformed = opts.transform(rs);
50
- return (transformed ?? opts?.defaultValue);
39
+ return opts.transform(rs) ?? opts.defaultValue;
40
+ }
41
+ getRequired(key, opts) {
42
+ const value = this.get(key);
43
+ if (typeof value !== 'string' || !value.trim()) {
44
+ throw getError({ message: `[getRequired] ${key} is not set` });
45
+ }
46
+ if (!opts) {
47
+ return value;
48
+ }
49
+ const transformed = opts.transform(value);
50
+ if (transformed === null || transformed === undefined) {
51
+ throw getError({ message: `[getRequired] ${key} is not valid` });
52
+ }
53
+ return transformed;
51
54
  }
52
55
  set(key, value) {
53
56
  this.arguments[key] = value;
@@ -1 +1 @@
1
- {"version":3,"file":"app-env.js","sourceRoot":"","sources":["../../../../src/modules/env/app-env.ts"],"names":[],"mappings":"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","sourcesContent":["import { ParseUtility } from '@/utilities/parse.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { EnvironmentNames } from './names';\nimport { type IApplicationEnvironment } from './common';\n\n/** Adds the `NODE_ENV` reads to {@link EnvironmentNames}. Every name and set is inherited, so `Environment.PRODUCTION`, `Environment.COMMON_ENVS` and `Environment.DEVELOPMENT_ENVS` keep resolving here; only these two members need a `process`. */\nexport class Environment extends EnvironmentNames {\n /** `NODE_ENV` exactly as the host has it, `undefined` when unset. Destructured on purpose: `bun build` rewrites `process.env.NODE_ENV` to a literal at build time, a destructured read stays a runtime read. */\n static get ambient(): string | undefined {\n const { NODE_ENV } = process.env;\n\n return NODE_ENV;\n }\n\n static get current(): string {\n return Environment.ambient ?? Environment.DEVELOPMENT;\n }\n\n static is(opts: { name: string }) {\n return this.current === opts.name;\n }\n}\n\n/** Key-value store of the environment entries whose key starts with `prefix`; other keys are dropped at construction. `get` applies a default and an optional transform. Use the shared `applicationEnvironment` instance rather than constructing one. */\nexport class ApplicationEnvironment extends BaseHelper implements IApplicationEnvironment {\n private prefix: string;\n private arguments: Record<string, any> = Object.create(null);\n\n constructor(opts: { prefix: string; envs: Record<string, string | number | undefined> }) {\n super({ scope: ApplicationEnvironment.name });\n\n this.prefix = opts.prefix;\n\n for (const key in opts.envs) {\n if (!key.startsWith(this.prefix)) {\n continue;\n }\n\n this.arguments[key] = opts.envs[key];\n }\n }\n\n /**\n * Reads one name. A line that is present but empty - `KEY=`, or padded to `KEY= ` by a hand\n * edit - is a pipeline that forgot to export the value, not a value: it is normalised to\n * `undefined` so `defaultValue` applies, and `transform` is handed that `undefined` rather than\n * the empty string.\n *\n * The normalisation runs ONLY when the caller supplied a `defaultValue`, because that call site\n * has already declared what it wants when the name carries nothing. A caller without one still\n * receives `''` unchanged, so no existing read changes shape. `'0'` and `'false'` are values and\n * are never normalised.\n */\n get<ReturnType, BeforeTransformType = unknown>(\n key: string,\n opts?: {\n defaultValue?: ReturnType;\n transform?: (value: BeforeTransformType) => ReturnType;\n },\n ): ReturnType {\n const raw = this.arguments[key];\n\n const isBlank = raw === undefined || raw === null || (typeof raw === 'string' && !raw.trim());\n const rs = opts?.defaultValue !== undefined && isBlank ? undefined : raw;\n\n if (!opts?.transform) {\n return (rs ?? opts?.defaultValue) as ReturnType;\n }\n\n const transformed = opts.transform(rs);\n\n return (transformed ?? opts?.defaultValue) as ReturnType;\n }\n\n set<ValueType>(key: string, value: ValueType) {\n this.arguments[key] = value;\n }\n\n merge(opts: { envs: Record<string, string> }) {\n const envsEntries = Object.entries(opts.envs);\n\n for (const [key, value] of envsEntries) {\n this.arguments[key] = value;\n }\n }\n\n isDevelopment() {\n return Environment.ambient === 'development';\n }\n\n keys() {\n return Object.keys(this.arguments);\n }\n}\n\n/** A process can carry two copies of this module - an application's ESM import beside a CommonJS require. The instance lives in this globalThis slot so a `set()` through one copy is read through the other. */\nconst INSTANCE_SLOT = Symbol.for('ignis:application-environment');\n\nconst resolveApplicationEnvironment = (): ApplicationEnvironment => {\n const shared: ApplicationEnvironment | undefined = Reflect.get(globalThis, INSTANCE_SLOT);\n\n if (shared) {\n return shared;\n }\n\n const created = new ApplicationEnvironment({\n prefix:\n ParseUtility.blankToUndefined({ input: process.env.APPLICATION_ENV_PREFIX }) ?? 'APP_ENV',\n envs: process.env,\n });\n Reflect.set(globalThis, INSTANCE_SLOT, created);\n\n return created;\n};\n\n/** The process-wide environment store, built from `process.env` with the prefix in `APPLICATION_ENV_PREFIX` (`APP_ENV` when unset). One instance is shared by every copy of this module in the process. */\nexport const applicationEnvironment = resolveApplicationEnvironment();\n\n/** Alias of `applicationEnvironment`. */\nexport const AppEnvs = applicationEnvironment;\n"]}
1
+ {"version":3,"file":"app-env.js","sourceRoot":"","sources":["../../../../src/modules/env/app-env.ts"],"names":[],"mappings":"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","sourcesContent":["import { ParseUtility } from '@/utilities/parse.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { EnvironmentNames } from './names';\nimport {\n type IApplicationEnvironment,\n type IApplicationEnvironmentDefaultedTransformOptions,\n type IApplicationEnvironmentTransformOptions,\n} from './common';\n\n/** Adds the `NODE_ENV` reads to {@link EnvironmentNames}. Every name and set is inherited, so `Environment.PRODUCTION`, `Environment.COMMON_ENVS` and `Environment.DEVELOPMENT_ENVS` keep resolving here; only these two members need a `process`. */\nexport class Environment extends EnvironmentNames {\n /** `NODE_ENV` exactly as the host has it, `undefined` when unset. Destructured on purpose: `bun build` rewrites `process.env.NODE_ENV` to a literal at build time, a destructured read stays a runtime read. */\n static get ambient(): string | undefined {\n const { NODE_ENV } = process.env;\n\n return NODE_ENV;\n }\n\n static get current(): string {\n return Environment.ambient ?? Environment.DEVELOPMENT;\n }\n\n static is(opts: { name: string }) {\n return this.current === opts.name;\n }\n}\n\n/** Key-value store of the environment entries whose key starts with `prefix`; other keys are dropped at construction. `get` applies a default and an optional transform. Use the shared `applicationEnvironment` instance rather than constructing one. */\nexport class ApplicationEnvironment extends BaseHelper implements IApplicationEnvironment {\n private prefix: string;\n private arguments: Record<string, string | undefined> = Object.create(null);\n\n constructor(opts: { prefix: string; envs: Record<string, string | undefined> }) {\n super({ scope: ApplicationEnvironment.name });\n\n this.prefix = opts.prefix;\n\n for (const key in opts.envs) {\n if (!key.startsWith(this.prefix)) {\n continue;\n }\n\n this.arguments[key] = opts.envs[key];\n }\n }\n\n /**\n * Reads one name. A line that is present but empty - `KEY=`, or padded to `KEY= ` by a hand\n * edit - is a pipeline that forgot to export the value, not a value: it is normalised to\n * `undefined` so `defaultValue` applies, and `transform` is handed that `undefined` rather than\n * the empty string.\n *\n * The normalisation runs ONLY when the caller supplied a `defaultValue`, because that call site\n * has already declared what it wants when the name carries nothing. A caller without one still\n * receives `''` unchanged, so no existing read changes shape. `'0'` and `'false'` are values and\n * are never normalised.\n */\n get(key: string): string | undefined;\n get(key: string, opts: { defaultValue: string }): string;\n get<R>(key: string, opts: IApplicationEnvironmentDefaultedTransformOptions<R>): R;\n // oxlint-disable-next-line typescript/unified-signatures -- one union parameter infers `R` from the transform alone (`number | undefined`); two overloads let the `defaultValue` fix `R`\n get<R>(key: string, opts: IApplicationEnvironmentTransformOptions<R>): R;\n get<R>(\n key: string,\n opts?: {\n defaultValue?: string | R;\n transform?: (raw: string | undefined) => R | null | undefined;\n },\n ): string | R | undefined {\n const raw = this.arguments[key];\n\n const isBlank = raw == null || (typeof raw === 'string' && !raw.trim());\n const rs = opts?.defaultValue !== undefined && isBlank ? undefined : raw;\n\n if (!opts?.transform) {\n return rs ?? opts?.defaultValue;\n }\n\n return opts.transform(rs) ?? opts.defaultValue;\n }\n\n /**\n * A variable the app cannot run without: it is set and not blank (the rule `get` applies to a `defaultValue`), or this throws an error naming the key. The check runs before `transform`, so `transform` receives a `string`; a `transform` that answers null or undefined throws too. A required value has no `defaultValue`.\n */\n getRequired(key: string): string;\n getRequired<R>(key: string, opts: { transform: (raw: string) => R | null | undefined }): R;\n getRequired<R>(\n key: string,\n opts?: { transform: (raw: string) => R | null | undefined },\n ): string | R {\n const value = this.get(key);\n\n if (typeof value !== 'string' || !value.trim()) {\n throw getError({ message: `[getRequired] ${key} is not set` });\n }\n\n if (!opts) {\n return value;\n }\n\n const transformed = opts.transform(value);\n\n if (transformed === null || transformed === undefined) {\n throw getError({ message: `[getRequired] ${key} is not valid` });\n }\n\n return transformed;\n }\n\n set(key: string, value: string | undefined): void {\n this.arguments[key] = value;\n }\n\n merge(opts: { envs: Record<string, string | undefined> }) {\n const envsEntries = Object.entries(opts.envs);\n\n for (const [key, value] of envsEntries) {\n this.arguments[key] = value;\n }\n }\n\n isDevelopment() {\n return Environment.ambient === 'development';\n }\n\n keys() {\n return Object.keys(this.arguments);\n }\n}\n\n/** A process can carry two copies of this module - an application's ESM import beside a CommonJS require. The instance lives in this globalThis slot so a `set()` through one copy is read through the other. */\nconst INSTANCE_SLOT = Symbol.for('ignis:application-environment');\n\nconst resolveApplicationEnvironment = (): ApplicationEnvironment => {\n const shared: ApplicationEnvironment | undefined = Reflect.get(globalThis, INSTANCE_SLOT);\n\n if (shared) {\n return shared;\n }\n\n const created = new ApplicationEnvironment({\n prefix:\n ParseUtility.blankToUndefined({ input: process.env.APPLICATION_ENV_PREFIX }) ?? 'APP_ENV',\n envs: process.env,\n });\n Reflect.set(globalThis, INSTANCE_SLOT, created);\n\n return created;\n};\n\n/** The process-wide environment store, built from `process.env` with the prefix in `APPLICATION_ENV_PREFIX` (`APP_ENV` when unset). One instance is shared by every copy of this module in the process. */\nexport const applicationEnvironment = resolveApplicationEnvironment();\n\n/** Alias of `applicationEnvironment`. */\nexport const AppEnvs = applicationEnvironment;\n"]}
@@ -1,9 +1,25 @@
1
- /** Read and write contract of the application environment store; `get` returns `defaultValue` when the key is absent. */
1
+ /** Options of `get` that run a `transform` over the raw value; `defaultValue` applies when the value is absent or the transform answers null or undefined. */
2
+ export interface IApplicationEnvironmentTransformOptions<R> {
3
+ transform: (raw: string | undefined) => R;
4
+ defaultValue?: R;
5
+ }
6
+ /** A `transform` that may answer null or undefined, with the `defaultValue` that then applies: the read answers `R`. */
7
+ export interface IApplicationEnvironmentDefaultedTransformOptions<R> {
8
+ transform: (raw: string | undefined) => R | null | undefined;
9
+ defaultValue: R;
10
+ }
11
+ /** Read and write contract of the application environment store. Every value is a string: `get` answers the raw string (or `undefined`), the `defaultValue` of a string read, or what a `transform` makes of the raw string. */
2
12
  export interface IApplicationEnvironment {
3
- get<ReturnType, BeforeTransformType = unknown>(key: string, opts?: {
4
- defaultValue?: ReturnType;
5
- transform?: (value: BeforeTransformType) => ReturnType;
6
- }): ReturnType;
7
- set<ValueType>(key: string, value: ValueType): any;
13
+ get(key: string): string | undefined;
14
+ get(key: string, opts: {
15
+ defaultValue: string;
16
+ }): string;
17
+ get<R>(key: string, opts: IApplicationEnvironmentDefaultedTransformOptions<R>): R;
18
+ get<R>(key: string, opts: IApplicationEnvironmentTransformOptions<R>): R;
19
+ getRequired(key: string): string;
20
+ getRequired<R>(key: string, opts: {
21
+ transform: (raw: string) => R | null | undefined;
22
+ }): R;
23
+ set(key: string, value: string | undefined): void;
8
24
  }
9
25
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/env/common/types.ts"],"names":[],"mappings":"","sourcesContent":["/** Read and write contract of the application environment store; `get` returns `defaultValue` when the key is absent. */\nexport interface IApplicationEnvironment {\n get<ReturnType, BeforeTransformType = unknown>(\n key: string,\n opts?: {\n defaultValue?: ReturnType;\n transform?: (value: BeforeTransformType) => ReturnType;\n },\n ): ReturnType;\n set<ValueType>(key: string, value: ValueType): any;\n}\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/env/common/types.ts"],"names":[],"mappings":"","sourcesContent":["/** Options of `get` that run a `transform` over the raw value; `defaultValue` applies when the value is absent or the transform answers null or undefined. */\nexport interface IApplicationEnvironmentTransformOptions<R> {\n transform: (raw: string | undefined) => R;\n defaultValue?: R;\n}\n\n/** A `transform` that may answer null or undefined, with the `defaultValue` that then applies: the read answers `R`. */\nexport interface IApplicationEnvironmentDefaultedTransformOptions<R> {\n transform: (raw: string | undefined) => R | null | undefined;\n defaultValue: R;\n}\n\n/** Read and write contract of the application environment store. Every value is a string: `get` answers the raw string (or `undefined`), the `defaultValue` of a string read, or what a `transform` makes of the raw string. */\nexport interface IApplicationEnvironment {\n get(key: string): string | undefined;\n get(key: string, opts: { defaultValue: string }): string;\n get<R>(key: string, opts: IApplicationEnvironmentDefaultedTransformOptions<R>): R;\n // oxlint-disable-next-line typescript/unified-signatures -- one union parameter infers `R` from the transform alone (`number | undefined`); two overloads let the `defaultValue` fix `R`\n get<R>(key: string, opts: IApplicationEnvironmentTransformOptions<R>): R;\n getRequired(key: string): string;\n getRequired<R>(key: string, opts: { transform: (raw: string) => R | null | undefined }): R;\n set(key: string, value: string | undefined): void;\n}\n"]}
@@ -1,14 +1,13 @@
1
- import { type AnyType } from '../../../common/types/index.js';
2
1
  /** The leaf, not the `../common` barrel: that barrel reaches `constants.ts`, which reads `process.env` at module load. Both bindings here are types so a bundler erases the edge, but the source graph still carries it. */
3
2
  import { type ILogger, type TLogLevel } from '../common/types.js';
4
3
  /** The ILogger contract as a class - for instanceof and implementations sharing no plumbing. */
5
4
  export declare abstract class AbstractLogger implements ILogger {
6
- abstract debug(message: string, ...args: AnyType[]): void;
7
- abstract info(message: string, ...args: AnyType[]): void;
8
- abstract warn(message: string, ...args: AnyType[]): void;
9
- abstract error(message: string, ...args: AnyType[]): void;
10
- abstract emerg(message: string, ...args: AnyType[]): void;
11
- abstract log(level: TLogLevel, message: string, ...args: AnyType[]): void;
5
+ abstract debug(message: string, ...args: unknown[]): void;
6
+ abstract info(message: string, ...args: unknown[]): void;
7
+ abstract warn(message: string, ...args: unknown[]): void;
8
+ abstract error(message: string, ...args: unknown[]): void;
9
+ abstract emerg(message: string, ...args: unknown[]): void;
10
+ abstract log(level: TLogLevel, message: string, ...args: unknown[]): void;
12
11
  abstract for(methodName: string): ILogger;
13
12
  }
14
13
  //# sourceMappingURL=abstract.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/abstract.ts"],"names":[],"mappings":"AAKA,gGAAgG;AAChG,MAAM,OAAgB,cAAc;CAQnC","sourcesContent":["import { type AnyType } from '@/common/types';\n\n/** The leaf, not the `../common` barrel: that barrel reaches `constants.ts`, which reads `process.env` at module load. Both bindings here are types so a bundler erases the edge, but the source graph still carries it. */\nimport { type ILogger, type TLogLevel } from '../common/types';\n\n/** The ILogger contract as a class - for instanceof and implementations sharing no plumbing. */\nexport abstract class AbstractLogger implements ILogger {\n abstract debug(message: string, ...args: AnyType[]): void;\n abstract info(message: string, ...args: AnyType[]): void;\n abstract warn(message: string, ...args: AnyType[]): void;\n abstract error(message: string, ...args: AnyType[]): void;\n abstract emerg(message: string, ...args: AnyType[]): void;\n abstract log(level: TLogLevel, message: string, ...args: AnyType[]): void;\n abstract for(methodName: string): ILogger;\n}\n"]}
1
+ {"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/abstract.ts"],"names":[],"mappings":"AAGA,gGAAgG;AAChG,MAAM,OAAgB,cAAc;CAQnC","sourcesContent":["/** The leaf, not the `../common` barrel: that barrel reaches `constants.ts`, which reads `process.env` at module load. Both bindings here are types so a bundler erases the edge, but the source graph still carries it. */\nimport { type ILogger, type TLogLevel } from '../common/types';\n\n/** The ILogger contract as a class - for instanceof and implementations sharing no plumbing. */\nexport abstract class AbstractLogger implements ILogger {\n abstract debug(message: string, ...args: unknown[]): void;\n abstract info(message: string, ...args: unknown[]): void;\n abstract warn(message: string, ...args: unknown[]): void;\n abstract error(message: string, ...args: unknown[]): void;\n abstract emerg(message: string, ...args: unknown[]): void;\n abstract log(level: TLogLevel, message: string, ...args: unknown[]): void;\n abstract for(methodName: string): ILogger;\n}\n"]}
@@ -1,4 +1,3 @@
1
- import { type AnyType } from '../../../common/types/index.js';
2
1
  import { type ILogger, type TLogLevel } from '../common/index.js';
3
2
  import { AbstractLogger } from './abstract.js';
4
3
  /** Provider-independent plumbing: scope, prefix, DEBUG gate, for(). Every level method funnels into ONE abstract write() sink; child() lets each provider keep its own caching policy. */
@@ -11,17 +10,17 @@ export declare abstract class BaseLogger extends AbstractLogger {
11
10
  protected abstract write(opts: {
12
11
  level: TLogLevel;
13
12
  message: string;
14
- args: Array<AnyType>;
13
+ args: unknown[];
15
14
  }): void;
16
15
  protected abstract child(opts: {
17
16
  scope: string;
18
17
  }): ILogger;
19
- debug(message: string, ...args: AnyType[]): void;
20
- info(message: string, ...args: AnyType[]): void;
21
- warn(message: string, ...args: AnyType[]): void;
22
- error(message: string, ...args: AnyType[]): void;
23
- emerg(message: string, ...args: AnyType[]): void;
24
- log(level: TLogLevel, message: string, ...args: AnyType[]): void;
18
+ debug(message: string, ...args: unknown[]): void;
19
+ info(message: string, ...args: unknown[]): void;
20
+ warn(message: string, ...args: unknown[]): void;
21
+ error(message: string, ...args: unknown[]): void;
22
+ emerg(message: string, ...args: unknown[]): void;
23
+ log(level: TLogLevel, message: string, ...args: unknown[]): void;
25
24
  for(methodName: string): ILogger;
26
25
  }
27
26
  //# sourceMappingURL=base.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,SAAS,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,0LAA0L;AAC1L,MAAM,OAAgB,UAAW,SAAQ,cAAc;IAIrD,YAAY,IAAuB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;IAMD,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,GAAG,CAAC,KAAgB,EAAE,OAAe,EAAE,GAAG,IAAe;QACvD,IAAI,KAAK,KAAK,SAAS,CAAC,KAAK,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,qHAAqH;QACrH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACjG,CAAC;CACF","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { type ILogger, LogLevels, LoggerDebugGate, type TLogLevel } from '../common';\nimport { AbstractLogger } from './abstract';\n\n/** Provider-independent plumbing: scope, prefix, DEBUG gate, for(). Every level method funnels into ONE abstract write() sink; child() lets each provider keep its own caching policy. */\nexport abstract class BaseLogger extends AbstractLogger {\n protected readonly _scope: string;\n protected readonly _formattedPrefix: string;\n\n constructor(opts: { scope: string }) {\n super();\n this._scope = opts.scope;\n this._formattedPrefix = opts.scope !== '' ? `[${opts.scope}] ` : '';\n }\n\n protected abstract write(opts: { level: TLogLevel; message: string; args: Array<AnyType> }): void;\n\n protected abstract child(opts: { scope: string }): ILogger;\n\n debug(message: string, ...args: AnyType[]) {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.write({ level: LogLevels.DEBUG, message, args });\n }\n\n info(message: string, ...args: AnyType[]) {\n this.write({ level: LogLevels.INFO, message, args });\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.write({ level: LogLevels.WARN, message, args });\n }\n\n error(message: string, ...args: AnyType[]) {\n this.write({ level: LogLevels.ERROR, message, args });\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.write({ level: LogLevels.EMERG, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.write({ level, message, args });\n }\n\n for(methodName: string): ILogger {\n // An empty parent scope must not produce a leading dash - the child simply takes the method name as its whole scope.\n return this.child({ scope: this._scope !== '' ? `${this._scope}-${methodName}` : methodName });\n }\n}\n"]}
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,SAAS,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,0LAA0L;AAC1L,MAAM,OAAgB,UAAW,SAAQ,cAAc;IAIrD,YAAY,IAAuB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;IAMD,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,GAAG,CAAC,KAAgB,EAAE,OAAe,EAAE,GAAG,IAAe;QACvD,IAAI,KAAK,KAAK,SAAS,CAAC,KAAK,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,qHAAqH;QACrH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACjG,CAAC;CACF","sourcesContent":["import { type ILogger, LogLevels, LoggerDebugGate, type TLogLevel } from '../common';\nimport { AbstractLogger } from './abstract';\n\n/** Provider-independent plumbing: scope, prefix, DEBUG gate, for(). Every level method funnels into ONE abstract write() sink; child() lets each provider keep its own caching policy. */\nexport abstract class BaseLogger extends AbstractLogger {\n protected readonly _scope: string;\n protected readonly _formattedPrefix: string;\n\n constructor(opts: { scope: string }) {\n super();\n this._scope = opts.scope;\n this._formattedPrefix = opts.scope !== '' ? `[${opts.scope}] ` : '';\n }\n\n protected abstract write(opts: { level: TLogLevel; message: string; args: unknown[] }): void;\n\n protected abstract child(opts: { scope: string }): ILogger;\n\n debug(message: string, ...args: unknown[]) {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.write({ level: LogLevels.DEBUG, message, args });\n }\n\n info(message: string, ...args: unknown[]) {\n this.write({ level: LogLevels.INFO, message, args });\n }\n\n warn(message: string, ...args: unknown[]) {\n this.write({ level: LogLevels.WARN, message, args });\n }\n\n error(message: string, ...args: unknown[]) {\n this.write({ level: LogLevels.ERROR, message, args });\n }\n\n emerg(message: string, ...args: unknown[]) {\n this.write({ level: LogLevels.EMERG, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: unknown[]) {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.write({ level, message, args });\n }\n\n for(methodName: string): ILogger {\n // An empty parent scope must not produce a leading dash - the child simply takes the method name as its whole scope.\n return this.child({ scope: this._scope !== '' ? `${this._scope}-${methodName}` : methodName });\n }\n}\n"]}
@@ -1,4 +1,3 @@
1
- import { type AnyType } from '../../../common/types/index.js';
2
1
  import { type ILogger, type TLogLevel } from '../common/types.js';
3
2
  import { AbstractLogger } from './abstract.js';
4
3
  /**
@@ -15,12 +14,12 @@ export declare class ConsoleLogger extends AbstractLogger {
15
14
  private constructor();
16
15
  static get(scope: string): ConsoleLogger;
17
16
  private emit;
18
- debug(message: string, ...args: AnyType[]): void;
19
- info(message: string, ...args: AnyType[]): void;
20
- warn(message: string, ...args: AnyType[]): void;
21
- error(message: string, ...args: AnyType[]): void;
22
- emerg(message: string, ...args: AnyType[]): void;
23
- log(level: TLogLevel, message: string, ...args: AnyType[]): void;
17
+ debug(message: string, ...args: unknown[]): void;
18
+ info(message: string, ...args: unknown[]): void;
19
+ warn(message: string, ...args: unknown[]): void;
20
+ error(message: string, ...args: unknown[]): void;
21
+ emerg(message: string, ...args: unknown[]): void;
22
+ log(level: TLogLevel, message: string, ...args: unknown[]): void;
24
23
  for(methodName: string): ILogger;
25
24
  }
26
25
  //# sourceMappingURL=console.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"console.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/console.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { LoggerDebugGate } from '../common/debug-gate';\nimport { type ILogger, LogLevels, type TLogLevel } from '../common/types';\nimport { AbstractLogger } from './abstract';\n\n/**\n * The default logger provider: it writes to the console, and it is the only provider a browser bundle reaches. It\n * satisfies `ILoggerProvider` (`ConsoleLogger.get(scope)`), so it is registered like Winston and Pino.\n *\n * Extends AbstractLogger rather than BaseLogger because BaseLogger's module graph reads `process.env` at load.\n * `debug` follows the rule of the other providers (`LoggerDebugGate`): off unless `DEBUG` is truthy and the\n * environment is allowed, and off in a browser, which has no `process`; `LoggerFactory.use({ level })` overrides it.\n */\nexport class ConsoleLogger extends AbstractLogger {\n private readonly prefix: string;\n\n private constructor(private readonly scope: string) {\n super();\n this.prefix = scope !== '' ? `[${scope}] ` : '';\n }\n\n static get(scope: string): ConsoleLogger {\n return new ConsoleLogger(scope);\n }\n\n private emit(opts: {\n sink: (message: string, ...args: AnyType[]) => void;\n message: string;\n args: AnyType[];\n }) {\n opts.sink(`${this.prefix}${opts.message}`, ...opts.args);\n }\n\n debug(message: string, ...args: AnyType[]) {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.emit({ sink: console.debug, message, args });\n }\n\n info(message: string, ...args: AnyType[]) {\n this.emit({ sink: console.log, message, args });\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.emit({ sink: console.warn, message, args });\n }\n\n error(message: string, ...args: AnyType[]) {\n this.emit({ sink: console.error, message, args });\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.emit({ sink: console.error, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n switch (level) {\n case LogLevels.DEBUG: {\n this.debug(message, ...args);\n\n return;\n }\n case LogLevels.WARN: {\n this.warn(message, ...args);\n\n return;\n }\n case LogLevels.ERROR:\n case LogLevels.EMERG: {\n this.error(message, ...args);\n\n return;\n }\n default: {\n this.info(message, ...args);\n }\n }\n }\n\n for(methodName: string): ILogger {\n const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;\n\n return ConsoleLogger.get(childScope);\n }\n}\n"]}
1
+ {"version":3,"file":"console.js","sourceRoot":"","sources":["../../../../../src/modules/logger/base/console.ts"],"names":[],"mappings":"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","sourcesContent":["import { LoggerDebugGate } from '../common/debug-gate';\nimport { type ILogger, LogLevels, type TLogLevel } from '../common/types';\nimport { AbstractLogger } from './abstract';\n\n/**\n * The default logger provider: it writes to the console, and it is the only provider a browser bundle reaches. It\n * satisfies `ILoggerProvider` (`ConsoleLogger.get(scope)`), so it is registered like Winston and Pino.\n *\n * Extends AbstractLogger rather than BaseLogger because BaseLogger's module graph reads `process.env` at load.\n * `debug` follows the rule of the other providers (`LoggerDebugGate`): off unless `DEBUG` is truthy and the\n * environment is allowed, and off in a browser, which has no `process`; `LoggerFactory.use({ level })` overrides it.\n */\nexport class ConsoleLogger extends AbstractLogger {\n private readonly prefix: string;\n\n private constructor(private readonly scope: string) {\n super();\n this.prefix = scope !== '' ? `[${scope}] ` : '';\n }\n\n static get(scope: string): ConsoleLogger {\n return new ConsoleLogger(scope);\n }\n\n private emit(opts: {\n sink: (message: string, ...args: unknown[]) => void;\n message: string;\n args: unknown[];\n }) {\n opts.sink(`${this.prefix}${opts.message}`, ...opts.args);\n }\n\n debug(message: string, ...args: unknown[]) {\n if (!LoggerDebugGate.isOpen()) {\n return;\n }\n\n this.emit({ sink: console.debug, message, args });\n }\n\n info(message: string, ...args: unknown[]) {\n this.emit({ sink: console.log, message, args });\n }\n\n warn(message: string, ...args: unknown[]) {\n this.emit({ sink: console.warn, message, args });\n }\n\n error(message: string, ...args: unknown[]) {\n this.emit({ sink: console.error, message, args });\n }\n\n emerg(message: string, ...args: unknown[]) {\n this.emit({ sink: console.error, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: unknown[]) {\n switch (level) {\n case LogLevels.DEBUG: {\n this.debug(message, ...args);\n\n return;\n }\n case LogLevels.WARN: {\n this.warn(message, ...args);\n\n return;\n }\n case LogLevels.ERROR:\n case LogLevels.EMERG: {\n this.error(message, ...args);\n\n return;\n }\n default: {\n this.info(message, ...args);\n }\n }\n }\n\n for(methodName: string): ILogger {\n const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;\n\n return ConsoleLogger.get(childScope);\n }\n}\n"]}
@@ -1,4 +1,4 @@
1
- import { type AnyType, type TConstValue } from '../../../common/types/index.js';
1
+ import { type TConstValue } from '../../../common/types/index.js';
2
2
  /** Log severities. `ORDER` runs from most to least severe, and `isEnabled` tests a level against a threshold. */
3
3
  export declare class LogLevels {
4
4
  static readonly ERROR = "error";
@@ -20,12 +20,12 @@ export declare class LogLevels {
20
20
  export type TLogLevel = TConstValue<typeof LogLevels>;
21
21
  /** The logging contract every consumer types against; which provider produced the logger is invisible behind it - only `factory.ts` and a provider's back-compat aliases may name a concrete logger class. */
22
22
  export interface ILogger {
23
- debug(message: string, ...args: AnyType[]): void;
24
- info(message: string, ...args: AnyType[]): void;
25
- warn(message: string, ...args: AnyType[]): void;
26
- error(message: string, ...args: AnyType[]): void;
27
- emerg(message: string, ...args: AnyType[]): void;
28
- log(level: TLogLevel, message: string, ...args: AnyType[]): void;
23
+ debug(message: string, ...args: unknown[]): void;
24
+ info(message: string, ...args: unknown[]): void;
25
+ warn(message: string, ...args: unknown[]): void;
26
+ error(message: string, ...args: unknown[]): void;
27
+ emerg(message: string, ...args: unknown[]): void;
28
+ log(level: TLogLevel, message: string, ...args: unknown[]): void;
29
29
  for(methodName: string): ILogger;
30
30
  }
31
31
  /** Static-side contract a provider class satisfies - WinstonLogger and PinoLogger both do. */
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/types.ts"],"names":[],"mappings":"AAEA,iHAAiH;AACjH,MAAM,OAAO,SAAS;aACJ,UAAK,GAAG,OAAO,CAAC;aAChB,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;aACd,UAAK,GAAG,OAAO,CAAC;aAEhB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEjG,2GAA2G;aAC3F,UAAK,GAA0B;QAC7C,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,KAAK;KACX,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,yHAAyH;IACzH,MAAM,CAAC,SAAS,CAAC,IAA0C;QACzD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEpD,gFAAgF;QAChF,OAAO,SAAS,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,IAAI,SAAS,IAAI,aAAa,CAAC;IAC1E,CAAC","sourcesContent":["import { type AnyType, type TConstValue } from '@/common/types';\n\n/** Log severities. `ORDER` runs from most to least severe, and `isEnabled` tests a level against a threshold. */\nexport class LogLevels {\n static readonly ERROR = 'error';\n static readonly EMERG = 'emerg';\n static readonly WARN = 'warn';\n static readonly INFO = 'info';\n static readonly DEBUG = 'debug';\n\n static readonly SCHEME_SET = new Set([this.ERROR, this.EMERG, this.WARN, this.INFO, this.DEBUG]);\n\n /** From the most to the least severe: a threshold lets through its own level and every level before it. */\n static readonly ORDER: ReadonlyArray<string> = [\n this.EMERG,\n this.ERROR,\n this.WARN,\n this.INFO,\n this.DEBUG,\n ];\n\n static isValid(input: string): boolean {\n return this.SCHEME_SET.has(input);\n }\n\n /** Whether a line of `level` passes a `threshold`: `debug` lets everything through, `error` only `error` and `emerg`. */\n static isEnabled(opts: { level: string; threshold: string }): boolean {\n const { level, threshold } = opts;\n const levelRank = this.ORDER.indexOf(level);\n const thresholdRank = this.ORDER.indexOf(threshold);\n\n // An unknown level or threshold is never silenced: a typo must not hide a line.\n return levelRank < 0 || thresholdRank < 0 || levelRank <= thresholdRank;\n }\n}\n\n/** One of the `LogLevels` values. */\nexport type TLogLevel = TConstValue<typeof LogLevels>;\n\n/** The logging contract every consumer types against; which provider produced the logger is invisible behind it - only `factory.ts` and a provider's back-compat aliases may name a concrete logger class. */\nexport interface ILogger {\n debug(message: string, ...args: AnyType[]): void;\n info(message: string, ...args: AnyType[]): void;\n warn(message: string, ...args: AnyType[]): void;\n error(message: string, ...args: AnyType[]): void;\n emerg(message: string, ...args: AnyType[]): void;\n log(level: TLogLevel, message: string, ...args: AnyType[]): void;\n for(methodName: string): ILogger;\n}\n\n/** Static-side contract a provider class satisfies - WinstonLogger and PinoLogger both do. */\nexport interface ILoggerProvider {\n get(scope: string): ILogger;\n}\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/logger/common/types.ts"],"names":[],"mappings":"AAEA,iHAAiH;AACjH,MAAM,OAAO,SAAS;aACJ,UAAK,GAAG,OAAO,CAAC;aAChB,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;aACd,UAAK,GAAG,OAAO,CAAC;aAEhB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEjG,2GAA2G;aAC3F,UAAK,GAA0B;QAC7C,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,KAAK;KACX,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,yHAAyH;IACzH,MAAM,CAAC,SAAS,CAAC,IAA0C;QACzD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEpD,gFAAgF;QAChF,OAAO,SAAS,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,IAAI,SAAS,IAAI,aAAa,CAAC;IAC1E,CAAC","sourcesContent":["import { type TConstValue } from '@/common/types';\n\n/** Log severities. `ORDER` runs from most to least severe, and `isEnabled` tests a level against a threshold. */\nexport class LogLevels {\n static readonly ERROR = 'error';\n static readonly EMERG = 'emerg';\n static readonly WARN = 'warn';\n static readonly INFO = 'info';\n static readonly DEBUG = 'debug';\n\n static readonly SCHEME_SET = new Set([this.ERROR, this.EMERG, this.WARN, this.INFO, this.DEBUG]);\n\n /** From the most to the least severe: a threshold lets through its own level and every level before it. */\n static readonly ORDER: ReadonlyArray<string> = [\n this.EMERG,\n this.ERROR,\n this.WARN,\n this.INFO,\n this.DEBUG,\n ];\n\n static isValid(input: string): boolean {\n return this.SCHEME_SET.has(input);\n }\n\n /** Whether a line of `level` passes a `threshold`: `debug` lets everything through, `error` only `error` and `emerg`. */\n static isEnabled(opts: { level: string; threshold: string }): boolean {\n const { level, threshold } = opts;\n const levelRank = this.ORDER.indexOf(level);\n const thresholdRank = this.ORDER.indexOf(threshold);\n\n // An unknown level or threshold is never silenced: a typo must not hide a line.\n return levelRank < 0 || thresholdRank < 0 || levelRank <= thresholdRank;\n }\n}\n\n/** One of the `LogLevels` values. */\nexport type TLogLevel = TConstValue<typeof LogLevels>;\n\n/** The logging contract every consumer types against; which provider produced the logger is invisible behind it - only `factory.ts` and a provider's back-compat aliases may name a concrete logger class. */\nexport interface ILogger {\n debug(message: string, ...args: unknown[]): void;\n info(message: string, ...args: unknown[]): void;\n warn(message: string, ...args: unknown[]): void;\n error(message: string, ...args: unknown[]): void;\n emerg(message: string, ...args: unknown[]): void;\n log(level: TLogLevel, message: string, ...args: unknown[]): void;\n for(methodName: string): ILogger;\n}\n\n/** Static-side contract a provider class satisfies - WinstonLogger and PinoLogger both do. */\nexport interface ILoggerProvider {\n get(scope: string): ILogger;\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/logger/factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { AbstractLogger } from './base/abstract';\nimport { ConsoleLogger } from './base/console';\nimport { LoggerDebugGate } from './common/debug-gate';\nimport { type ILogger, type ILoggerProvider, LogLevels, type TLogLevel } from './common/types';\n\n/**\n * Stable wrapper the factory hands out. The delegate is resolved on the first log call or by `use()`, never at\n * construction, so no provider is touched until a line is written. The wrapper also applies the factory's level to every\n * provider the same way. Mutual reference with LoggerFactory is by design - hence the `no-use-before-define` disables.\n */\nclass LoggerDelegator extends AbstractLogger {\n private _delegate?: ILogger;\n private _generation = -1;\n\n constructor(private readonly scope: string) {\n super();\n }\n\n /** Takes the new provider's logger for this scope at once: the wrappers of this copy do not wait for their next line. */\n repoint(provider: ILoggerProvider): void {\n this._delegate = provider.get(this.scope);\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this._generation = LoggerFactory.currentGeneration();\n }\n\n /** The provider's logger for this scope, taken again whenever any copy of the module chose another provider (one integer compare per line). */\n private delegate(): ILogger {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const generation = LoggerFactory.currentGeneration();\n\n if (!this._delegate || this._generation !== generation) {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this._delegate = LoggerFactory.currentProvider().get(this.scope);\n this._generation = generation;\n }\n\n return this._delegate;\n }\n\n /** The level the application set, else the shared debug gate for `debug`: a provider that has no gate of its own is gated the same way. */\n private isEnabled(level: TLogLevel): boolean {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return false;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const threshold = LoggerFactory.currentLevel();\n\n return threshold === undefined || LogLevels.isEnabled({ level, threshold });\n }\n\n /** The one place a level method passes its line to the provider, after the one level check. */\n private forward(opts: {\n method: 'debug' | 'info' | 'warn' | 'error' | 'emerg';\n message: string;\n args: AnyType[];\n }): void {\n const { method, message, args } = opts;\n\n if (this.isEnabled(method)) {\n this.delegate()[method](message, ...args);\n }\n }\n\n debug(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.DEBUG, message, args });\n }\n\n info(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.INFO, message, args });\n }\n\n warn(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.WARN, message, args });\n }\n\n error(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.ERROR, message, args });\n }\n\n emerg(message: string, ...args: AnyType[]) {\n this.forward({ method: LogLevels.EMERG, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: AnyType[]) {\n if (this.isEnabled(level)) {\n this.delegate().log(level, message, ...args);\n }\n }\n\n for(methodName: string): ILogger {\n const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;\n\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return LoggerFactory.getLogger([childScope]);\n }\n}\n\n/** A bundle can carry two copies of this module - the application's ESM import and core's CJS require. The chosen provider, the level and a counter of choices live in these globalThis slots so `use()` in one copy is seen, on the next line, by the loggers of the other. */\nconst PROVIDER_SLOT = Symbol.for('ignis:logger-provider');\nconst LEVEL_SLOT = Symbol.for('ignis:logger-level');\nconst GENERATION_SLOT = Symbol.for('ignis:logger-generation');\n\n/**\n * The one way to get a logger, and the same everywhere: the server, a script and a browser. It names no provider: the\n * default is the console (`ConsoleLogger`), and an application chooses another with `use()`. It imports nothing from\n * node, so it is part of the browser-pure `core` entry.\n */\nexport class LoggerFactory {\n private static cache = new Map<string, LoggerDelegator>();\n\n /**\n * Choose the application's provider and/or the level. A provider re-points every wrapper issued so far. The level\n * (a `LogLevels` value the application passes) is applied by the wrapper to every provider alike, and it also\n * decides whether `debug` lines are written at all: `debug` turns the gate on, anything above it turns it off,\n * whatever the environment says. A level that is not a `LogLevels` value (a typo, an uppercase name from the\n * environment) is ignored: it must never open debug.\n */\n static use(opts: { provider?: ILoggerProvider; level?: TLogLevel }): void {\n const { provider, level } = opts;\n\n if (level !== undefined && LogLevels.isValid(level)) {\n Reflect.set(globalThis, LEVEL_SLOT, level);\n LoggerDebugGate.force({\n isOpen: LogLevels.isEnabled({ level: LogLevels.DEBUG, threshold: level }),\n });\n }\n\n if (provider === undefined) {\n return;\n }\n\n Reflect.set(globalThis, PROVIDER_SLOT, provider);\n this.bumpGeneration();\n\n for (const wrapper of this.cache.values()) {\n wrapper.repoint(provider);\n }\n }\n\n /** Choose `provider` only when the application has not chosen one: a framework's startup default, never an override. */\n static useUnlessChosen(opts: { provider: ILoggerProvider }): void {\n if (!this.isChosen()) {\n this.use({ provider: opts.provider });\n }\n }\n\n /** Whether an application (or a framework default through `useUnlessChosen`) has chosen a provider. */\n static isChosen(): boolean {\n return this.sharedProvider() !== undefined;\n }\n\n /** The slot is the only record of the choice, so a `use()` or a `reset()` in any copy of the module is seen by all. */\n static currentProvider(): ILoggerProvider {\n return this.sharedProvider() ?? ConsoleLogger;\n }\n\n /** Moves whenever a provider is chosen or reset, in any copy: a wrapper that cached its logger takes it again. */\n static currentGeneration(): number {\n const generation: number | undefined = Reflect.get(globalThis, GENERATION_SLOT);\n\n return generation ?? 0;\n }\n\n private static bumpGeneration(): void {\n Reflect.set(globalThis, GENERATION_SLOT, this.currentGeneration() + 1);\n }\n\n /** The level the application set, or `undefined`: then every provider applies its own gate. */\n static currentLevel(): TLogLevel | undefined {\n const level: TLogLevel | undefined = Reflect.get(globalThis, LEVEL_SLOT);\n\n return level;\n }\n\n /** The provider chosen by any copy of this module, if any. */\n private static sharedProvider(): ILoggerProvider | undefined {\n const shared: ILoggerProvider | undefined = Reflect.get(globalThis, PROVIDER_SLOT);\n\n return shared;\n }\n\n /** Back to the default provider and no level, and every wrapper takes the console again: for a test, or a host that starts over. */\n static reset(): void {\n Reflect.deleteProperty(globalThis, PROVIDER_SLOT);\n Reflect.deleteProperty(globalThis, LEVEL_SLOT);\n LoggerDebugGate.force({ isOpen: undefined });\n this.bumpGeneration();\n\n for (const wrapper of this.cache.values()) {\n wrapper.repoint(ConsoleLogger);\n }\n }\n\n static getLogger(scopes: string[]): ILogger {\n const scope = scopes.filter((part) => part.length > 0).join('-');\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new LoggerDelegator(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n}\n"]}
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/logger/factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { AbstractLogger } from './base/abstract';\nimport { ConsoleLogger } from './base/console';\nimport { LoggerDebugGate } from './common/debug-gate';\nimport { type ILogger, type ILoggerProvider, LogLevels, type TLogLevel } from './common/types';\n\n/**\n * Stable wrapper the factory hands out. The delegate is resolved on the first log call or by `use()`, never at\n * construction, so no provider is touched until a line is written. The wrapper also applies the factory's level to every\n * provider the same way. Mutual reference with LoggerFactory is by design - hence the `no-use-before-define` disables.\n */\nclass LoggerDelegator extends AbstractLogger {\n private _delegate?: ILogger;\n private _generation = -1;\n\n constructor(private readonly scope: string) {\n super();\n }\n\n /** Takes the new provider's logger for this scope at once: the wrappers of this copy do not wait for their next line. */\n repoint(provider: ILoggerProvider): void {\n this._delegate = provider.get(this.scope);\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this._generation = LoggerFactory.currentGeneration();\n }\n\n /** The provider's logger for this scope, taken again whenever any copy of the module chose another provider (one integer compare per line). */\n private delegate(): ILogger {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const generation = LoggerFactory.currentGeneration();\n\n if (!this._delegate || this._generation !== generation) {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n this._delegate = LoggerFactory.currentProvider().get(this.scope);\n this._generation = generation;\n }\n\n return this._delegate;\n }\n\n /** The level the application set, else the shared debug gate for `debug`: a provider that has no gate of its own is gated the same way. */\n private isEnabled(level: TLogLevel): boolean {\n if (level === LogLevels.DEBUG && !LoggerDebugGate.isOpen()) {\n return false;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n const threshold = LoggerFactory.currentLevel();\n\n return threshold === undefined || LogLevels.isEnabled({ level, threshold });\n }\n\n /** The one place a level method passes its line to the provider, after the one level check. */\n private forward(opts: {\n method: 'debug' | 'info' | 'warn' | 'error' | 'emerg';\n message: string;\n args: unknown[];\n }): void {\n const { method, message, args } = opts;\n\n if (this.isEnabled(method)) {\n this.delegate()[method](message, ...args);\n }\n }\n\n debug(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.DEBUG, message, args });\n }\n\n info(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.INFO, message, args });\n }\n\n warn(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.WARN, message, args });\n }\n\n error(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.ERROR, message, args });\n }\n\n emerg(message: string, ...args: unknown[]) {\n this.forward({ method: LogLevels.EMERG, message, args });\n }\n\n log(level: TLogLevel, message: string, ...args: unknown[]) {\n if (this.isEnabled(level)) {\n this.delegate().log(level, message, ...args);\n }\n }\n\n for(methodName: string): ILogger {\n const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;\n\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return LoggerFactory.getLogger([childScope]);\n }\n}\n\n/** A bundle can carry two copies of this module - the application's ESM import and core's CJS require. The chosen provider, the level and a counter of choices live in these globalThis slots so `use()` in one copy is seen, on the next line, by the loggers of the other. */\nconst PROVIDER_SLOT = Symbol.for('ignis:logger-provider');\nconst LEVEL_SLOT = Symbol.for('ignis:logger-level');\nconst GENERATION_SLOT = Symbol.for('ignis:logger-generation');\n\n/**\n * The one way to get a logger, and the same everywhere: the server, a script and a browser. It names no provider: the\n * default is the console (`ConsoleLogger`), and an application chooses another with `use()`. It imports nothing from\n * node, so it is part of the browser-pure `core` entry.\n */\nexport class LoggerFactory {\n private static cache = new Map<string, LoggerDelegator>();\n\n /**\n * Choose the application's provider and/or the level. A provider re-points every wrapper issued so far. The level\n * (a `LogLevels` value the application passes) is applied by the wrapper to every provider alike, and it also\n * decides whether `debug` lines are written at all: `debug` turns the gate on, anything above it turns it off,\n * whatever the environment says. A level that is not a `LogLevels` value (a typo, an uppercase name from the\n * environment) is ignored: it must never open debug.\n */\n static use(opts: { provider?: ILoggerProvider; level?: TLogLevel }): void {\n const { provider, level } = opts;\n\n if (level !== undefined && LogLevels.isValid(level)) {\n Reflect.set(globalThis, LEVEL_SLOT, level);\n LoggerDebugGate.force({\n isOpen: LogLevels.isEnabled({ level: LogLevels.DEBUG, threshold: level }),\n });\n }\n\n if (provider === undefined) {\n return;\n }\n\n Reflect.set(globalThis, PROVIDER_SLOT, provider);\n this.bumpGeneration();\n\n for (const wrapper of this.cache.values()) {\n wrapper.repoint(provider);\n }\n }\n\n /** Choose `provider` only when the application has not chosen one: a framework's startup default, never an override. */\n static useUnlessChosen(opts: { provider: ILoggerProvider }): void {\n if (!this.isChosen()) {\n this.use({ provider: opts.provider });\n }\n }\n\n /** Whether an application (or a framework default through `useUnlessChosen`) has chosen a provider. */\n static isChosen(): boolean {\n return this.sharedProvider() !== undefined;\n }\n\n /** The slot is the only record of the choice, so a `use()` or a `reset()` in any copy of the module is seen by all. */\n static currentProvider(): ILoggerProvider {\n return this.sharedProvider() ?? ConsoleLogger;\n }\n\n /** Moves whenever a provider is chosen or reset, in any copy: a wrapper that cached its logger takes it again. */\n static currentGeneration(): number {\n const generation: number | undefined = Reflect.get(globalThis, GENERATION_SLOT);\n\n return generation ?? 0;\n }\n\n private static bumpGeneration(): void {\n Reflect.set(globalThis, GENERATION_SLOT, this.currentGeneration() + 1);\n }\n\n /** The level the application set, or `undefined`: then every provider applies its own gate. */\n static currentLevel(): TLogLevel | undefined {\n const level: TLogLevel | undefined = Reflect.get(globalThis, LEVEL_SLOT);\n\n return level;\n }\n\n /** The provider chosen by any copy of this module, if any. */\n private static sharedProvider(): ILoggerProvider | undefined {\n const shared: ILoggerProvider | undefined = Reflect.get(globalThis, PROVIDER_SLOT);\n\n return shared;\n }\n\n /** Back to the default provider and no level, and every wrapper takes the console again: for a test, or a host that starts over. */\n static reset(): void {\n Reflect.deleteProperty(globalThis, PROVIDER_SLOT);\n Reflect.deleteProperty(globalThis, LEVEL_SLOT);\n LoggerDebugGate.force({ isOpen: undefined });\n this.bumpGeneration();\n\n for (const wrapper of this.cache.values()) {\n wrapper.repoint(ConsoleLogger);\n }\n }\n\n static getLogger(scopes: string[]): ILogger {\n const scope = scopes.filter((part) => part.length > 0).join('-');\n let cached = this.cache.get(scope);\n\n if (!cached) {\n cached = new LoggerDelegator(scope);\n this.cache.set(scope, cached);\n }\n\n return cached;\n }\n}\n"]}