@venizia/ignis-helpers 0.4.6 → 0.4.7-1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (300) hide show
  1. package/LICENSE.md +1 -3
  2. package/README.md +4 -5
  3. package/dist/esm/common/redact.d.ts +25 -17
  4. package/dist/esm/common/redact.d.ts.map +1 -1
  5. package/dist/esm/common/redact.js +50 -46
  6. package/dist/esm/common/redact.js.map +1 -1
  7. package/dist/esm/common/resolvers.d.ts +7 -5
  8. package/dist/esm/common/resolvers.d.ts.map +1 -1
  9. package/dist/esm/common/resolvers.js +11 -9
  10. package/dist/esm/common/resolvers.js.map +1 -1
  11. package/dist/esm/core.d.ts +6 -3
  12. package/dist/esm/core.d.ts.map +1 -1
  13. package/dist/esm/core.js +6 -3
  14. package/dist/esm/core.js.map +1 -1
  15. package/dist/esm/modules/base.js +4 -4
  16. package/dist/esm/modules/base.js.map +1 -1
  17. package/dist/esm/modules/cron/helper.js +4 -4
  18. package/dist/esm/modules/cron/helper.js.map +1 -1
  19. package/dist/esm/modules/crypto/algorithms/aes-legacy.algorithm.js +3 -3
  20. package/dist/esm/modules/crypto/algorithms/aes-legacy.algorithm.js.map +1 -1
  21. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +5 -5
  22. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  23. package/dist/esm/modules/crypto/algorithms/base.algorithm.js +3 -3
  24. package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
  25. package/dist/esm/modules/env/app-env.d.ts.map +1 -1
  26. package/dist/esm/modules/env/app-env.js +2 -2
  27. package/dist/esm/modules/env/app-env.js.map +1 -1
  28. package/dist/esm/modules/logger/common/constants.d.ts +23 -21
  29. package/dist/esm/modules/logger/common/constants.d.ts.map +1 -1
  30. package/dist/esm/modules/logger/common/constants.js +45 -42
  31. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  32. package/dist/esm/modules/logger/factory.d.ts +5 -3
  33. package/dist/esm/modules/logger/factory.d.ts.map +1 -1
  34. package/dist/esm/modules/logger/factory.js +5 -3
  35. package/dist/esm/modules/logger/factory.js.map +1 -1
  36. package/dist/esm/modules/logger/formatting/deep-splat.d.ts +10 -6
  37. package/dist/esm/modules/logger/formatting/deep-splat.d.ts.map +1 -1
  38. package/dist/esm/modules/logger/formatting/deep-splat.js +73 -62
  39. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  40. package/dist/esm/modules/logger/formatting/error-prettier.d.ts.map +1 -1
  41. package/dist/esm/modules/logger/formatting/error-prettier.js +8 -6
  42. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  43. package/dist/esm/modules/logger/hf/logger.d.ts.map +1 -1
  44. package/dist/esm/modules/logger/hf/logger.js +2 -2
  45. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  46. package/dist/esm/modules/logger/pino/backing.d.ts +0 -9
  47. package/dist/esm/modules/logger/pino/backing.d.ts.map +1 -1
  48. package/dist/esm/modules/logger/pino/backing.js +3 -8
  49. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  50. package/dist/esm/modules/logger/pino/destination.d.ts +6 -9
  51. package/dist/esm/modules/logger/pino/destination.d.ts.map +1 -1
  52. package/dist/esm/modules/logger/pino/destination.js +12 -13
  53. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  54. package/dist/esm/modules/logger/pino/logger.js +2 -2
  55. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  56. package/dist/esm/modules/logger/resolver.js +2 -2
  57. package/dist/esm/modules/logger/resolver.js.map +1 -1
  58. package/dist/esm/modules/logger/slot.d.ts +39 -18
  59. package/dist/esm/modules/logger/slot.d.ts.map +1 -1
  60. package/dist/esm/modules/logger/slot.js +117 -110
  61. package/dist/esm/modules/logger/slot.js.map +1 -1
  62. package/dist/esm/modules/logger/winston/common/constants.d.ts.map +1 -1
  63. package/dist/esm/modules/logger/winston/common/constants.js +7 -6
  64. package/dist/esm/modules/logger/winston/common/constants.js.map +1 -1
  65. package/dist/esm/modules/logger/winston/define.d.ts +0 -7
  66. package/dist/esm/modules/logger/winston/define.d.ts.map +1 -1
  67. package/dist/esm/modules/logger/winston/define.js +0 -5
  68. package/dist/esm/modules/logger/winston/define.js.map +1 -1
  69. package/dist/esm/modules/logger/winston/formats.d.ts +2 -0
  70. package/dist/esm/modules/logger/winston/formats.d.ts.map +1 -1
  71. package/dist/esm/modules/logger/winston/formats.js +17 -4
  72. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  73. package/dist/esm/modules/logger/winston/index.d.ts +3 -2
  74. package/dist/esm/modules/logger/winston/index.d.ts.map +1 -1
  75. package/dist/esm/modules/logger/winston/index.js +3 -2
  76. package/dist/esm/modules/logger/winston/index.js.map +1 -1
  77. package/dist/esm/modules/logger/winston/logger-factory.js +4 -4
  78. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  79. package/dist/esm/modules/network/http-request/base-network-request.helper.js +2 -2
  80. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  81. package/dist/esm/modules/network/http-request/common/index.d.ts +0 -1
  82. package/dist/esm/modules/network/http-request/common/index.d.ts.map +1 -1
  83. package/dist/esm/modules/network/http-request/common/index.js +0 -1
  84. package/dist/esm/modules/network/http-request/common/index.js.map +1 -1
  85. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts.map +1 -1
  86. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +4 -2
  87. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  88. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  89. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +6 -4
  90. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  91. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +4 -4
  92. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  93. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
  94. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  95. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +2 -2
  96. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  97. package/dist/esm/modules/network/utilities/query-string.d.ts +22 -20
  98. package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
  99. package/dist/esm/modules/network/utilities/query-string.js +48 -46
  100. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  101. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts +0 -10
  102. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts.map +1 -1
  103. package/dist/esm/modules/network/utilities/url-safety/common/errors.js +0 -11
  104. package/dist/esm/modules/network/utilities/url-safety/common/errors.js.map +1 -1
  105. package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts.map +1 -1
  106. package/dist/esm/modules/network/utilities/url-safety/ingest.js +2 -1
  107. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  108. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts +10 -0
  109. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts.map +1 -1
  110. package/dist/esm/modules/network/utilities/url-safety/policy.js +11 -0
  111. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  112. package/dist/esm/modules/pool/abstract.d.ts.map +1 -1
  113. package/dist/esm/modules/pool/abstract.js +4 -2
  114. package/dist/esm/modules/pool/abstract.js.map +1 -1
  115. package/dist/esm/modules/queue/bullmq/helper.d.ts.map +1 -1
  116. package/dist/esm/modules/queue/bullmq/helper.js +6 -6
  117. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  118. package/dist/esm/modules/queue/common/hook.d.ts +14 -12
  119. package/dist/esm/modules/queue/common/hook.d.ts.map +1 -1
  120. package/dist/esm/modules/queue/common/hook.js +21 -19
  121. package/dist/esm/modules/queue/common/hook.js.map +1 -1
  122. package/dist/esm/modules/queue/common/index.d.ts +0 -1
  123. package/dist/esm/modules/queue/common/index.d.ts.map +1 -1
  124. package/dist/esm/modules/queue/common/index.js +0 -1
  125. package/dist/esm/modules/queue/common/index.js.map +1 -1
  126. package/dist/esm/modules/queue/internal/sequential/helper.js +8 -8
  127. package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
  128. package/dist/esm/modules/queue/kafka/base.js +3 -3
  129. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  130. package/dist/esm/modules/queue/kafka/bundler/index.d.ts +0 -2
  131. package/dist/esm/modules/queue/kafka/bundler/index.d.ts.map +1 -1
  132. package/dist/esm/modules/queue/kafka/bundler/index.js +0 -2
  133. package/dist/esm/modules/queue/kafka/bundler/index.js.map +1 -1
  134. package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts +8 -2
  135. package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts.map +1 -1
  136. package/dist/esm/modules/queue/kafka/bundler/plugins.js +64 -7
  137. package/dist/esm/modules/queue/kafka/bundler/plugins.js.map +1 -1
  138. package/dist/esm/modules/queue/kafka/consumer.d.ts.map +1 -1
  139. package/dist/esm/modules/queue/kafka/consumer.js +26 -24
  140. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  141. package/dist/esm/modules/queue/mqtt/helper.js +10 -10
  142. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  143. package/dist/esm/modules/redis/base/abstract.helper.js +8 -8
  144. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  145. package/dist/esm/modules/redis/cluster/cluster.helper.js +2 -2
  146. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  147. package/dist/esm/modules/redis/factory.d.ts +13 -9
  148. package/dist/esm/modules/redis/factory.d.ts.map +1 -1
  149. package/dist/esm/modules/redis/factory.js +15 -13
  150. package/dist/esm/modules/redis/factory.js.map +1 -1
  151. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +2 -2
  152. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  153. package/dist/esm/modules/redis/single/single.helper.js +2 -2
  154. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  155. package/dist/esm/modules/redis/utility.d.ts +13 -11
  156. package/dist/esm/modules/redis/utility.d.ts.map +1 -1
  157. package/dist/esm/modules/redis/utility.js +46 -44
  158. package/dist/esm/modules/redis/utility.js.map +1 -1
  159. package/dist/esm/modules/retry/helper.d.ts.map +1 -1
  160. package/dist/esm/modules/retry/helper.js +6 -4
  161. package/dist/esm/modules/retry/helper.js.map +1 -1
  162. package/dist/esm/modules/secrets/factory.d.ts +5 -3
  163. package/dist/esm/modules/secrets/factory.d.ts.map +1 -1
  164. package/dist/esm/modules/secrets/factory.js +36 -34
  165. package/dist/esm/modules/secrets/factory.js.map +1 -1
  166. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts.map +1 -1
  167. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +4 -2
  168. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  169. package/dist/esm/modules/socket/socket-io/server/helper.d.ts.map +1 -1
  170. package/dist/esm/modules/socket/socket-io/server/helper.js +11 -11
  171. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  172. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts.map +1 -1
  173. package/dist/esm/modules/socket/websocket/emitter/helper.js +3 -3
  174. package/dist/esm/modules/socket/websocket/emitter/helper.js.map +1 -1
  175. package/dist/esm/modules/socket/websocket/server/delivery.d.ts.map +1 -1
  176. package/dist/esm/modules/socket/websocket/server/delivery.js +5 -6
  177. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  178. package/dist/esm/modules/socket/websocket/server/helper.d.ts.map +1 -1
  179. package/dist/esm/modules/socket/websocket/server/helper.js +7 -7
  180. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  181. package/dist/esm/modules/storage/base.d.ts.map +1 -1
  182. package/dist/esm/modules/storage/base.js +9 -8
  183. package/dist/esm/modules/storage/base.js.map +1 -1
  184. package/dist/esm/modules/storage/bun-s3/helper.d.ts.map +1 -1
  185. package/dist/esm/modules/storage/bun-s3/helper.js +25 -18
  186. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  187. package/dist/esm/modules/storage/bun-s3/utility.d.ts +95 -77
  188. package/dist/esm/modules/storage/bun-s3/utility.d.ts.map +1 -1
  189. package/dist/esm/modules/storage/bun-s3/utility.js +261 -244
  190. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  191. package/dist/esm/modules/storage/common/errors.d.ts +0 -4
  192. package/dist/esm/modules/storage/common/errors.d.ts.map +1 -1
  193. package/dist/esm/modules/storage/common/errors.js +0 -10
  194. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  195. package/dist/esm/modules/storage/common/utility.d.ts +11 -5
  196. package/dist/esm/modules/storage/common/utility.d.ts.map +1 -1
  197. package/dist/esm/modules/storage/common/utility.js +30 -17
  198. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  199. package/dist/esm/modules/storage/disk/helper.d.ts.map +1 -1
  200. package/dist/esm/modules/storage/disk/helper.js +18 -9
  201. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  202. package/dist/esm/modules/tree/builder.d.ts.map +1 -1
  203. package/dist/esm/modules/tree/builder.js +2 -1
  204. package/dist/esm/modules/tree/builder.js.map +1 -1
  205. package/dist/esm/modules/uid/opaque.d.ts.map +1 -1
  206. package/dist/esm/modules/uid/opaque.js +4 -2
  207. package/dist/esm/modules/uid/opaque.js.map +1 -1
  208. package/dist/esm/modules/uid/uuid/helper.d.ts +1 -1
  209. package/dist/esm/modules/uid/uuid/helper.d.ts.map +1 -1
  210. package/dist/esm/modules/uid/uuid/helper.js +7 -7
  211. package/dist/esm/modules/uid/uuid/helper.js.map +1 -1
  212. package/dist/esm/modules/uid/uuid/v4.d.ts +11 -8
  213. package/dist/esm/modules/uid/uuid/v4.d.ts.map +1 -1
  214. package/dist/esm/modules/uid/uuid/v4.js +51 -46
  215. package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
  216. package/dist/esm/modules/uid/uuid/v5.d.ts +17 -14
  217. package/dist/esm/modules/uid/uuid/v5.d.ts.map +1 -1
  218. package/dist/esm/modules/uid/uuid/v5.js +83 -78
  219. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  220. package/dist/esm/modules/uid/uuid/v7.d.ts +15 -10
  221. package/dist/esm/modules/uid/uuid/v7.d.ts.map +1 -1
  222. package/dist/esm/modules/uid/uuid/v7.js +88 -79
  223. package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
  224. package/dist/esm/modules/worker-thread/bus/base.js +2 -2
  225. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  226. package/dist/esm/modules/worker-thread/worker/base.d.ts.map +1 -1
  227. package/dist/esm/modules/worker-thread/worker/base.js +4 -3
  228. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  229. package/dist/esm/utilities/error.utility.d.ts +7 -0
  230. package/dist/esm/utilities/error.utility.d.ts.map +1 -0
  231. package/dist/esm/utilities/error.utility.js +9 -0
  232. package/dist/esm/utilities/error.utility.js.map +1 -0
  233. package/dist/esm/utilities/form-body.utility.d.ts +12 -10
  234. package/dist/esm/utilities/form-body.utility.d.ts.map +1 -1
  235. package/dist/esm/utilities/form-body.utility.js +19 -16
  236. package/dist/esm/utilities/form-body.utility.js.map +1 -1
  237. package/dist/esm/utilities/hr-time.utility.d.ts +7 -5
  238. package/dist/esm/utilities/hr-time.utility.d.ts.map +1 -1
  239. package/dist/esm/utilities/hr-time.utility.js +11 -9
  240. package/dist/esm/utilities/hr-time.utility.js.map +1 -1
  241. package/dist/esm/utilities/index.d.ts +2 -2
  242. package/dist/esm/utilities/index.d.ts.map +1 -1
  243. package/dist/esm/utilities/index.js +2 -2
  244. package/dist/esm/utilities/index.js.map +1 -1
  245. package/dist/esm/utilities/module.utility.d.ts.map +1 -1
  246. package/dist/esm/utilities/module.utility.js +4 -2
  247. package/dist/esm/utilities/module.utility.js.map +1 -1
  248. package/dist/esm/utilities/parse.utility.d.ts +89 -43
  249. package/dist/esm/utilities/parse.utility.d.ts.map +1 -1
  250. package/dist/esm/utilities/parse.utility.js +173 -141
  251. package/dist/esm/utilities/parse.utility.js.map +1 -1
  252. package/dist/esm/utilities/performance.utility.d.ts +15 -13
  253. package/dist/esm/utilities/performance.utility.d.ts.map +1 -1
  254. package/dist/esm/utilities/performance.utility.js +34 -29
  255. package/dist/esm/utilities/performance.utility.js.map +1 -1
  256. package/dist/esm/utilities/promise.utility.d.ts +20 -18
  257. package/dist/esm/utilities/promise.utility.d.ts.map +1 -1
  258. package/dist/esm/utilities/promise.utility.js +41 -51
  259. package/dist/esm/utilities/promise.utility.js.map +1 -1
  260. package/dist/esm/utilities/request.utility.d.ts +35 -29
  261. package/dist/esm/utilities/request.utility.d.ts.map +1 -1
  262. package/dist/esm/utilities/request.utility.js +117 -115
  263. package/dist/esm/utilities/request.utility.js.map +1 -1
  264. package/package.json +4 -15
  265. package/dist/esm/modules/logger/winston/formatters/deep-splat.d.ts +0 -4
  266. package/dist/esm/modules/logger/winston/formatters/deep-splat.d.ts.map +0 -1
  267. package/dist/esm/modules/logger/winston/formatters/deep-splat.js +0 -14
  268. package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +0 -1
  269. package/dist/esm/modules/logger/winston/formatters/index.d.ts +0 -2
  270. package/dist/esm/modules/logger/winston/formatters/index.d.ts.map +0 -1
  271. package/dist/esm/modules/logger/winston/formatters/index.js +0 -2
  272. package/dist/esm/modules/logger/winston/formatters/index.js.map +0 -1
  273. package/dist/esm/modules/network/http-request/common/types.d.ts +0 -2
  274. package/dist/esm/modules/network/http-request/common/types.d.ts.map +0 -1
  275. package/dist/esm/modules/network/http-request/common/types.js +0 -2
  276. package/dist/esm/modules/network/http-request/common/types.js.map +0 -1
  277. package/dist/esm/modules/queue/common/types.d.ts +0 -2
  278. package/dist/esm/modules/queue/common/types.d.ts.map +0 -1
  279. package/dist/esm/modules/queue/common/types.js +0 -2
  280. package/dist/esm/modules/queue/common/types.js.map +0 -1
  281. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.d.ts +0 -4
  282. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.d.ts.map +0 -1
  283. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js +0 -28
  284. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +0 -1
  285. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.d.ts +0 -4
  286. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.d.ts.map +0 -1
  287. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +0 -26
  288. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +0 -1
  289. package/dist/esm/modules/storage/minio/helper.d.ts +0 -55
  290. package/dist/esm/modules/storage/minio/helper.d.ts.map +0 -1
  291. package/dist/esm/modules/storage/minio/helper.js +0 -176
  292. package/dist/esm/modules/storage/minio/helper.js.map +0 -1
  293. package/dist/esm/modules/storage/minio/index.d.ts +0 -2
  294. package/dist/esm/modules/storage/minio/index.d.ts.map +0 -1
  295. package/dist/esm/modules/storage/minio/index.js +0 -2
  296. package/dist/esm/modules/storage/minio/index.js.map +0 -1
  297. package/dist/esm/utilities/sleep.utility.d.ts +0 -2
  298. package/dist/esm/utilities/sleep.utility.d.ts.map +0 -1
  299. package/dist/esm/utilities/sleep.utility.js +0 -4
  300. package/dist/esm/utilities/sleep.utility.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"parse.utility.js","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\n\n/**\n * Rounds at a decimal precision, shifting the exponent rather than multiplying: `1.005` at 2 is\n * `1.01` here, where `Math.round(1.005 * 100) / 100` gives `1`.\n *\n * Hand-written to keep lodash out of a browser bundle. One deliberate difference from `lodash/round`:\n * a result of negative zero is normalised to `0`. They compare equal, stringify the same and\n * serialise the same, so nothing downstream can tell - checked across 114 value/precision pairs, and\n * the sign of zero was the only disagreement.\n */\nconst round = (opts: { value: number; precision?: number }): number => {\n const { value, precision = 0 } = opts;\n\n if (!Number.isFinite(value) || precision === 0) {\n return Math.round(value) + 0;\n }\n\n const [mantissa, exponent] = `${value}e`.split('e');\n const shifted = Math.round(Number(`${mantissa}e${Number(exponent) + precision}`));\n const [shiftedMantissa, shiftedExponent] = `${shifted}e`.split('e');\n\n return Number(`${shiftedMantissa}e${Number(shiftedExponent) - precision}`) + 0;\n};\n\nexport const getUID = () => Math.random().toString(36).slice(2).toUpperCase();\n\nexport const toCamel = (s: string) => {\n return s.replace(/([-_][a-z])/gi, (sub: string) => {\n return sub.toUpperCase().replace('-', '').replace('_', '');\n });\n};\n\n/** Arrays stay arrays - mapping one through the object branch would turn it into an index-keyed object - but their object elements still need their keys camelized. Dates are opaque values. */\nconst camelizeValue = (value: unknown): unknown => {\n if (Array.isArray(value)) {\n return value.map((element) => camelizeValue(element));\n }\n\n if (!value || typeof value !== 'object' || value instanceof Date) {\n return value;\n }\n\n const camelized: any = {};\n const valueKeys = Object.keys(value);\n for (const key of valueKeys) {\n camelized[toCamel(key)] = camelizeValue((value as Record<string, unknown>)[key]);\n }\n\n return camelized;\n};\n\nexport const keysToCamel = (object: object) => {\n const n: any = {};\n const keys = Object.keys(object);\n\n for (const key of keys) {\n n[toCamel(key)] = camelizeValue((object as Record<string, unknown>)[key]);\n }\n\n return n;\n};\n\nexport const isInt = (n: any) => {\n if (isNaN(n)) {\n return false;\n }\n\n return Number.isInteger(n) || Math.floor(Number(n)) === n || Number(n) % 1 === 0;\n};\n\nexport const isFloat = (input: any) => {\n if (isNaN(input)) {\n return false;\n }\n\n return Number(input) === input || Number(input) % 1 !== 0;\n};\n\n/**\n * Parses an integer, TOTAL by design: it always answers a number, and answers `0` for anything it\n * cannot parse - `undefined`, `''`, `'abc'`.\n *\n * That makes `int(value) ?? fallback` dead code, because the left side is never nullish. The\n * fallback belongs INSIDE the call, and for an environment read it belongs in the read itself:\n *\n * ```ts\n * int(applicationEnvironment.get(KEY, { defaultValue: '6379' })) // correct\n * int(applicationEnvironment.get(KEY)) ?? 6379 // always 0 when KEY is unset\n * ```\n *\n * The second form is silent: a missing port reads `0` and a missing retry budget reads `0`, which\n * through `AbstractRedisHelper.buildRetryStrategy` means \"give up after the first failure\".\n */\nexport const int = (input: any) => {\n if (!input) {\n return 0;\n }\n\n const normalized = input?.toString()?.replace(/,/g, '');\n if (isNaN(normalized)) {\n return 0;\n }\n\n const parsed = Number.parseInt(normalized, 10);\n return Number.isNaN(parsed) ? 0 : parsed;\n};\n\nexport const float = (input: any, digit = 2) => {\n if (!input) {\n return 0;\n }\n\n const normalized = input?.toString()?.replace(/,/g, '');\n if (isNaN(normalized)) {\n return 0;\n }\n\n const parsed = round({ value: Number.parseFloat(normalized), precision: digit });\n return Number.isNaN(parsed) ? 0 : parsed;\n};\n\nexport const toBoolean = (input: any): boolean => {\n return (\n input !== '' &&\n input !== 'false' &&\n input !== '0' &&\n input !== false &&\n input !== 0 &&\n input !== null &&\n input !== undefined\n );\n};\n\n/** Converts an array to a Map keyed by `keyMap`. Last element wins on duplicate keys. */\nexport const parseArrayToMapWithKey = <T extends Record<K, PropertyKey>, K extends keyof T>(\n arr: T[],\n keyMap: K,\n): Map<T[K], T> => {\n const resultMap = new Map<T[K], T>();\n\n if (!arr.length) {\n return resultMap;\n }\n\n arr.forEach((element) => {\n if (!(keyMap in element)) {\n throw getError({\n message: 'Invalid keyMap',\n });\n }\n resultMap.set(element[keyMap], element);\n });\n\n return resultMap;\n};\n\n/** Splits a delimited string into trimmed, non-empty entries - the transform for list-shaped env values (e.g. `applicationEnvironment.get(KEY, { transform: toDelimitedArray })`). */\nexport const toDelimitedArray = (input: unknown, separator = ','): string[] => {\n if (input == null) {\n return [];\n }\n\n return String(input)\n .split(separator)\n .map((entry) => entry.trim())\n .filter((entry) => entry.length > 0);\n};\n\n/**\n * A trimmed value, or `undefined` when the input is absent or carries nothing but whitespace.\n *\n * Written for environment reads. `KEY=` in a deployment file is a pipeline that forgot to export the\n * value, but `process.env.KEY` answers `''` for it, and `''` walks straight past `??`:\n *\n * ```ts\n * process.env.APP_ENV_LOGGER_FORMAT ?? 'text' // '' when the line is blank\n * blankToUndefined(process.env.APP_ENV_LOGGER_FORMAT) ?? 'text' // 'text'\n * ```\n *\n * Reach for this rather than `||`, which reads `'0'` as blank as well.\n */\nexport const blankToUndefined = (input: string | undefined): string | undefined => {\n const trimmed = input?.trim();\n return trimmed === undefined || trimmed.length === 0 ? undefined : trimmed;\n};\n\n/** Trims a possibly-undefined env value to a clean string ('' when absent). */\nexport const toTrimmed = (input: unknown): string => {\n if (input == null) {\n return '';\n }\n\n return String(input).trim();\n};\n"]}
1
+ {"version":3,"file":"parse.utility.js","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\n\n/** Number, string and key conversions that tolerate bad input; no node import, so it ships on `/core`. */\nexport class ParseUtility {\n /**\n * Rounds at a decimal precision, shifting the exponent rather than multiplying: `1.005` at 2 is\n * `1.01` here, where `Math.round(1.005 * 100) / 100` gives `1`.\n *\n * Hand-written to keep lodash out of a browser bundle. One deliberate difference from `lodash/round`:\n * a result of negative zero is normalised to `0`. They compare equal, stringify the same and\n * serialise the same, so nothing downstream can tell - checked across 114 value/precision pairs, and\n * the sign of zero was the only disagreement.\n */\n private static round(opts: { value: number; precision?: number }): number {\n const { value, precision = 0 } = opts;\n\n if (!Number.isFinite(value) || precision === 0) {\n return Math.round(value) + 0;\n }\n\n const [mantissa, exponent] = `${value}e`.split('e');\n const shifted = Math.round(Number(`${mantissa}e${Number(exponent) + precision}`));\n const [shiftedMantissa, shiftedExponent] = `${shifted}e`.split('e');\n\n return Number(`${shiftedMantissa}e${Number(shiftedExponent) - precision}`) + 0;\n }\n\n /** Arrays stay arrays - mapping one through the object branch would turn it into an index-keyed object - but their object elements still need their keys camelized. Dates are opaque values. */\n private static camelizeValue(opts: { value: unknown }): unknown {\n const { value } = opts;\n\n if (Array.isArray(value)) {\n return value.map((element) => ParseUtility.camelizeValue({ value: element }));\n }\n\n if (!value || typeof value !== 'object' || value instanceof Date) {\n return value;\n }\n\n const camelized: any = {};\n const valueKeys = Object.keys(value);\n for (const key of valueKeys) {\n camelized[ParseUtility.toCamel({ input: key })] = ParseUtility.camelizeValue({\n value: (value as Record<string, unknown>)[key],\n });\n }\n\n return camelized;\n }\n\n static getUID() {\n return Math.random().toString(36).slice(2).toUpperCase();\n }\n\n static toCamel(opts: { input: string }) {\n return opts.input.replace(/([-_][a-z])/gi, (sub: string) => {\n return sub.toUpperCase().replace('-', '').replace('_', '');\n });\n }\n\n static keysToCamel(opts: { source: object }) {\n const { source } = opts;\n const n: any = {};\n const keys = Object.keys(source);\n\n for (const key of keys) {\n n[ParseUtility.toCamel({ input: key })] = ParseUtility.camelizeValue({\n value: (source as Record<string, unknown>)[key],\n });\n }\n\n return n;\n }\n\n static isInt(opts: { input: any }) {\n const { input } = opts;\n if (isNaN(input)) {\n return false;\n }\n\n return (\n Number.isInteger(input) || Math.floor(Number(input)) === input || Number(input) % 1 === 0\n );\n }\n\n static isFloat(opts: { input: any }) {\n const { input } = opts;\n if (isNaN(input)) {\n return false;\n }\n\n return Number(input) === input || Number(input) % 1 !== 0;\n }\n\n /**\n * Parses an integer, TOTAL by design: it always answers a number, and answers `0` for anything it\n * cannot parse - `undefined`, `''`, `'abc'`.\n *\n * That makes `ParseUtility.toInt({ input }) ?? fallback` dead code, because the left side is never\n * nullish. The fallback belongs INSIDE the call, and for an environment read it belongs in the read\n * itself:\n *\n * ```ts\n * ParseUtility.toInt({ input: applicationEnvironment.get(KEY, { defaultValue: '6379' }) }) // correct\n * ParseUtility.toInt({ input: applicationEnvironment.get(KEY) }) ?? 6379 // always 0 when KEY is unset\n * ```\n *\n * The second form is silent: a missing port reads `0` and a missing retry budget reads `0`, which\n * through `AbstractRedisHelper.buildRetryStrategy` means \"give up after the first failure\".\n */\n static toInt(opts: { input: any }) {\n const { input } = opts;\n if (!input) {\n return 0;\n }\n\n const normalized = input?.toString()?.replace(/,/g, '');\n if (isNaN(normalized)) {\n return 0;\n }\n\n const parsed = Number.parseInt(normalized, 10);\n return Number.isNaN(parsed) ? 0 : parsed;\n }\n\n static toFloat(opts: { input: any; digit?: number }) {\n const { input, digit = 2 } = opts;\n if (!input) {\n return 0;\n }\n\n const normalized = input?.toString()?.replace(/,/g, '');\n if (isNaN(normalized)) {\n return 0;\n }\n\n const parsed = ParseUtility.round({ value: Number.parseFloat(normalized), precision: digit });\n return Number.isNaN(parsed) ? 0 : parsed;\n }\n\n static toBoolean(opts: { input: any }): boolean {\n const { input } = opts;\n return (\n input !== '' &&\n input !== 'false' &&\n input !== '0' &&\n input !== false &&\n input !== 0 &&\n input !== null &&\n input !== undefined\n );\n }\n\n /** Converts an array to a Map keyed by `key`. Last element wins on duplicate keys. */\n static parseArrayToMapWithKey<T extends Record<K, PropertyKey>, K extends keyof T>(opts: {\n items: T[];\n key: K;\n }): Map<T[K], T> {\n const { items, key } = opts;\n const resultMap = new Map<T[K], T>();\n\n if (!items.length) {\n return resultMap;\n }\n\n items.forEach((element) => {\n if (!(key in element)) {\n throw getError({\n message: 'Invalid keyMap',\n });\n }\n resultMap.set(element[key], element);\n });\n\n return resultMap;\n }\n\n /** Splits a delimited string into trimmed, non-empty entries - the transform for list-shaped env values (e.g. `applicationEnvironment.get(KEY, { transform: (input) => ParseUtility.toDelimitedArray({ input }) })`). */\n static toDelimitedArray(opts: { input: unknown; separator?: string }): string[] {\n const { input, separator = ',' } = opts;\n if (input == null) {\n return [];\n }\n\n return String(input)\n .split(separator)\n .map((entry) => entry.trim())\n .filter((entry) => entry.length > 0);\n }\n\n /**\n * A trimmed value, or `undefined` when the input is absent or carries nothing but whitespace.\n *\n * Written for environment reads. `KEY=` in a deployment file is a pipeline that forgot to export the\n * value, but `process.env.KEY` answers `''` for it, and `''` walks straight past `??`:\n *\n * ```ts\n * process.env.APP_ENV_LOGGER_FORMAT ?? 'text' // '' when the line is blank\n * ParseUtility.blankToUndefined({ input: process.env.APP_ENV_LOGGER_FORMAT }) ?? 'text' // 'text'\n * ```\n *\n * Reach for this rather than `||`, which reads `'0'` as blank as well.\n */\n static blankToUndefined(opts: { input: string | undefined }): string | undefined {\n const trimmed = opts.input?.trim();\n return trimmed === undefined || trimmed.length === 0 ? undefined : trimmed;\n }\n\n /** Trims a possibly-undefined env value to a clean string ('' when absent). */\n static toTrimmed(opts: { input: unknown }): string {\n const { input } = opts;\n if (input == null) {\n return '';\n }\n\n return String(input).trim();\n }\n\n /** Traverse a dotted property path on an object. */\n static getDeepProperty<T, V>(opts: { source: T; path: string }): V {\n const keys = opts.path.split('.');\n let result: any = opts.source;\n\n for (const key of keys) {\n if (result == null) {\n throw getError({ message: `Cannot read property '${key}' of ${result}` });\n }\n result = result[key];\n }\n\n return result as V;\n }\n}\n"]}
@@ -1,15 +1,17 @@
1
1
  import { type ILogger } from '../modules/logger/index.js';
2
- export declare const getPerformanceCheckpoint: () => number;
3
- export declare const getExecutedPerformance: (opts: {
4
- from: number;
5
- digit?: number;
6
- }) => number;
7
- export declare const executeWithPerformanceMeasure: <R = any>(opts: {
8
- logger?: ILogger;
9
- level?: string;
10
- description?: string;
11
- args?: any;
12
- scope: string;
13
- task: Function;
14
- }) => Promise<R>;
2
+ export declare class PerformanceUtility {
3
+ static getCheckpoint(): number;
4
+ static getExecuted(opts: {
5
+ from: number;
6
+ digit?: number;
7
+ }): number;
8
+ static executeWithMeasure<R = any>(opts: {
9
+ logger?: ILogger;
10
+ level?: string;
11
+ description?: string;
12
+ args?: any;
13
+ scope: string;
14
+ task: Function;
15
+ }): Promise<R>;
16
+ }
15
17
  //# sourceMappingURL=performance.utility.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"performance.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/performance.utility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOhD,eAAO,MAAM,wBAAwB,cAEpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,WAE5E,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,CAAC,GAAG,GAAG,EAAE,MAAM;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB,eAmCA,CAAC"}
1
+ {"version":3,"file":"performance.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/performance.utility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOhD,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,aAAa;IAIpB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAOzD,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE;QACvC,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,QAAQ,CAAC;KAChB;CAoCF"}
@@ -1,36 +1,41 @@
1
- import { float } from './parse.utility.js';
1
+ import { ParseUtility } from './parse.utility.js';
2
2
  const DEFAULT_PERFORMANCE_DECIMAL = 6;
3
- export const getPerformanceCheckpoint = () => {
4
- return performance.now();
5
- };
6
- export const getExecutedPerformance = (opts) => {
7
- return float(performance.now() - opts.from, opts.digit ?? DEFAULT_PERFORMANCE_DECIMAL);
8
- };
9
- export const executeWithPerformanceMeasure = (opts) => {
10
- return new Promise((resolve, reject) => {
11
- const t = performance.now();
12
- const { logger = console, level = 'debug', scope, description = 'Executing', args, task, } = opts;
13
- // `level` names a method on whichever logger was passed, so it is looked up, not indexed; the call keeps `this` bound to that logger.
14
- const method = Reflect.get(logger, level);
15
- const log = (message, ...params) => method.call(logger, message, ...params);
16
- if (args) {
17
- log('[%s] START | %s... | Args: %j', scope, description, args);
18
- }
19
- else {
20
- log('[%s] START | %s ...', scope, description);
21
- }
22
- Promise.resolve(task())
23
- .then(resolve)
24
- .catch(reject)
25
- .finally(() => {
26
- const took = performance.now() - t;
3
+ export class PerformanceUtility {
4
+ static getCheckpoint() {
5
+ return performance.now();
6
+ }
7
+ static getExecuted(opts) {
8
+ return ParseUtility.toFloat({
9
+ input: performance.now() - opts.from,
10
+ digit: opts.digit ?? DEFAULT_PERFORMANCE_DECIMAL,
11
+ });
12
+ }
13
+ static executeWithMeasure(opts) {
14
+ return new Promise((resolve, reject) => {
15
+ const t = performance.now();
16
+ const { logger = console, level = 'debug', scope, description = 'Executing', args, task, } = opts;
17
+ // `level` names a method on whichever logger was passed, so it is looked up, not indexed; the call keeps `this` bound to that logger.
18
+ const method = Reflect.get(logger, level);
19
+ const log = (message, ...params) => method.call(logger, message, ...params);
27
20
  if (args) {
28
- log('[%s] DONE | %s | Args: %j | Took: %s (ms)', scope, description, args, took);
21
+ log('[%s] START | %s... | Args: %j', scope, description, args);
29
22
  }
30
23
  else {
31
- log('[%s] DONE | %s | Took: %s (ms)', scope, description, took);
24
+ log('[%s] START | %s ...', scope, description);
32
25
  }
26
+ Promise.resolve(task())
27
+ .then(resolve)
28
+ .catch(reject)
29
+ .finally(() => {
30
+ const took = performance.now() - t;
31
+ if (args) {
32
+ log('[%s] DONE | %s | Args: %j | Took: %s (ms)', scope, description, args, took);
33
+ }
34
+ else {
35
+ log('[%s] DONE | %s | Took: %s (ms)', scope, description, took);
36
+ }
37
+ });
33
38
  });
34
- });
35
- };
39
+ }
40
+ }
36
41
  //# sourceMappingURL=performance.utility.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"performance.utility.js","sourceRoot":"","sources":["../../../src/utilities/performance.utility.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAItC,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,EAAE;IAC3C,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAsC,EAAE,EAAE;IAC/E,OAAO,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;AACzF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAU,IAOtD,EAAE,EAAE;IACH,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,EACJ,MAAM,GAAG,OAAO,EAChB,KAAK,GAAG,OAAO,EACf,KAAK,EACL,WAAW,GAAG,WAAW,EACzB,IAAI,EACJ,IAAI,GACL,GAAG,IAAI,CAAC;QAET,sIAAsI;QACtI,MAAM,MAAM,GAAe,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,GAAG,MAAsB,EAAE,EAAE,CACzD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;QAE1C,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,CAAC,+BAA+B,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aACpB,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,MAAM,CAAC;aACb,OAAO,CAAC,GAAG,EAAE;YACZ,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACnC,IAAI,IAAI,EAAE,CAAC;gBACT,GAAG,CAAC,2CAA2C,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACnF,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,gCAAgC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;YAClE,CAAC;QACH,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { type ILogger } from '@/modules/logger';\nimport { float } from './parse.utility';\n\nconst DEFAULT_PERFORMANCE_DECIMAL = 6;\n\ntype TLogMethod = (message: string, ...args: Array<AnyType>) => void;\n\nexport const getPerformanceCheckpoint = () => {\n return performance.now();\n};\n\nexport const getExecutedPerformance = (opts: { from: number; digit?: number }) => {\n return float(performance.now() - opts.from, opts.digit ?? DEFAULT_PERFORMANCE_DECIMAL);\n};\n\nexport const executeWithPerformanceMeasure = <R = any>(opts: {\n logger?: ILogger;\n level?: string;\n description?: string;\n args?: any;\n scope: string;\n task: Function;\n}) => {\n return new Promise<R>((resolve, reject) => {\n const t = performance.now();\n const {\n logger = console,\n level = 'debug',\n scope,\n description = 'Executing',\n args,\n task,\n } = opts;\n\n // `level` names a method on whichever logger was passed, so it is looked up, not indexed; the call keeps `this` bound to that logger.\n const method: TLogMethod = Reflect.get(logger, level);\n const log = (message: string, ...params: Array<AnyType>) =>\n method.call(logger, message, ...params);\n\n if (args) {\n log('[%s] START | %s... | Args: %j', scope, description, args);\n } else {\n log('[%s] START | %s ...', scope, description);\n }\n\n Promise.resolve(task())\n .then(resolve)\n .catch(reject)\n .finally(() => {\n const took = performance.now() - t;\n if (args) {\n log('[%s] DONE | %s | Args: %j | Took: %s (ms)', scope, description, args, took);\n } else {\n log('[%s] DONE | %s | Took: %s (ms)', scope, description, took);\n }\n });\n });\n};\n"]}
1
+ {"version":3,"file":"performance.utility.js","sourceRoot":"","sources":["../../../src/utilities/performance.utility.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAItC,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAC,aAAa;QAClB,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAsC;QACvD,OAAO,YAAY,CAAC,OAAO,CAAC;YAC1B,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,2BAA2B;SACjD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAU,IAOlC;QACC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAC5B,MAAM,EACJ,MAAM,GAAG,OAAO,EAChB,KAAK,GAAG,OAAO,EACf,KAAK,EACL,WAAW,GAAG,WAAW,EACzB,IAAI,EACJ,IAAI,GACL,GAAG,IAAI,CAAC;YAET,sIAAsI;YACtI,MAAM,MAAM,GAAe,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACtD,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,GAAG,MAAsB,EAAE,EAAE,CACzD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;YAE1C,IAAI,IAAI,EAAE,CAAC;gBACT,GAAG,CAAC,+BAA+B,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YACjD,CAAC;YAED,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;iBACpB,IAAI,CAAC,OAAO,CAAC;iBACb,KAAK,CAAC,MAAM,CAAC;iBACb,OAAO,CAAC,GAAG,EAAE;gBACZ,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACnC,IAAI,IAAI,EAAE,CAAC;oBACT,GAAG,CAAC,2CAA2C,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;gBACnF,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,gCAAgC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { type AnyType } from '@/common/types';\nimport { type ILogger } from '@/modules/logger';\nimport { ParseUtility } from './parse.utility';\n\nconst DEFAULT_PERFORMANCE_DECIMAL = 6;\n\ntype TLogMethod = (message: string, ...args: Array<AnyType>) => void;\n\nexport class PerformanceUtility {\n static getCheckpoint() {\n return performance.now();\n }\n\n static getExecuted(opts: { from: number; digit?: number }) {\n return ParseUtility.toFloat({\n input: performance.now() - opts.from,\n digit: opts.digit ?? DEFAULT_PERFORMANCE_DECIMAL,\n });\n }\n\n static executeWithMeasure<R = any>(opts: {\n logger?: ILogger;\n level?: string;\n description?: string;\n args?: any;\n scope: string;\n task: Function;\n }) {\n return new Promise<R>((resolve, reject) => {\n const t = performance.now();\n const {\n logger = console,\n level = 'debug',\n scope,\n description = 'Executing',\n args,\n task,\n } = opts;\n\n // `level` names a method on whichever logger was passed, so it is looked up, not indexed; the call keeps `this` bound to that logger.\n const method: TLogMethod = Reflect.get(logger, level);\n const log = (message: string, ...params: Array<AnyType>) =>\n method.call(logger, message, ...params);\n\n if (args) {\n log('[%s] START | %s... | Args: %j', scope, description, args);\n } else {\n log('[%s] START | %s ...', scope, description);\n }\n\n Promise.resolve(task())\n .then(resolve)\n .catch(reject)\n .finally(() => {\n const took = performance.now() - t;\n if (args) {\n log('[%s] DONE | %s | Args: %j | Took: %s (ms)', scope, description, args, took);\n } else {\n log('[%s] DONE | %s | Took: %s (ms)', scope, description, took);\n }\n });\n });\n }\n}\n"]}
@@ -1,24 +1,26 @@
1
1
  import { type ValueOrPromise } from '../common/index.js';
2
2
  import type { ILogger } from '../modules/logger/index.js';
3
3
  export type TTask<T> = (...args: any[]) => Promise<T>;
4
- /** Execute async tasks with bounded concurrency. */
5
- export declare const executePromiseWithLimit: <T>(opts: {
6
- tasks: Array<TTask<T>>;
7
- limit: number;
8
- onTaskDone?: <R>(opts: {
9
- result: R;
10
- }) => ValueOrPromise<void>;
11
- }) => Promise<Awaited<T>[]>;
12
- /** Normalize an unknown thrown value into an Error instance - an ApplicationError when it was not one. */
13
- export declare const toError: (error: unknown) => Error;
14
4
  /** Check if a value is a promise. */
15
5
  export declare const isPromiseLike: <T>(value: T | PromiseLike<T>) => value is PromiseLike<T>;
16
- /** Traverse a dotted property path on an object. */
17
- export declare const getDeepProperty: <T, V>(obj: T, path: string) => V;
18
- /** Fire-and-forget: routes rejection to `logger` (or console.error), passes sync results through untouched. Standalone rather than a BaseHelper member - TS cannot emit protected members on an exported ANONYMOUS class (TS4094), which is what factory-built controllers return. */
19
- export declare const voidExecution: (opts: {
20
- logger?: ILogger;
21
- scope: string;
22
- execution: ValueOrPromise<unknown>;
23
- }) => void;
6
+ /** Waiting, bounded concurrency and fire-and-forget. `voidExecution` is not a `BaseHelper` member: TS cannot emit protected members on an exported ANONYMOUS class (TS4094), which is what factory-built controllers return; a static on a separate class has no such limit. */
7
+ export declare class PromiseUtility {
8
+ static sleep(opts: {
9
+ ms: number;
10
+ }): Promise<unknown>;
11
+ /** Execute async tasks with bounded concurrency. */
12
+ static executeWithLimit<T>(opts: {
13
+ tasks: Array<TTask<T>>;
14
+ limit: number;
15
+ onTaskDone?: <R>(opts: {
16
+ result: R;
17
+ }) => ValueOrPromise<void>;
18
+ }): Promise<Awaited<T>[]>;
19
+ /** Fire-and-forget: routes rejection to `logger` (or console.error), passes sync results through untouched. */
20
+ static voidExecution(opts: {
21
+ logger?: ILogger;
22
+ scope: string;
23
+ execution: ValueOrPromise<unknown>;
24
+ }): void;
25
+ }
24
26
  //# sourceMappingURL=promise.utility.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"promise.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/promise.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtD,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,GAAU,CAAC,EAAE,MAAM;IACrD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;CAC/D,0BA6BA,CAAC;AAEF,0GAA0G;AAC1G,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,KAExC,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAMlF,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,MAAM,KAAG,CAY5D,CAAC;AAEF,sRAAsR;AACtR,eAAO,MAAM,aAAa,GAAI,MAAM;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACpC,KAAG,IAeH,CAAC"}
1
+ {"version":3,"file":"promise.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/promise.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtD,qCAAqC;AACrC,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAMlF,CAAC;AAEF,gRAAgR;AAChR,qBAAa,cAAc;IACzB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,oDAAoD;WACvC,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE;QACrC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE;YAAE,MAAM,EAAE,CAAC,CAAA;SAAE,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;KAC/D;IA+BD,+GAA+G;IAC/G,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QACzB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;KACpC,GAAG,IAAI;CAgBT"}
@@ -1,63 +1,53 @@
1
1
  import { getError } from '../modules/error/index.js';
2
- /** Execute async tasks with bounded concurrency. */
3
- export const executePromiseWithLimit = async (opts) => {
4
- const { tasks, limit, onTaskDone } = opts;
5
- if (!Number.isInteger(limit) || limit < 1) {
6
- throw getError({
7
- message: `[executePromiseWithLimit] limit must be a positive integer | received: ${limit}`,
8
- });
9
- }
10
- const results = [];
11
- const executing = new Set();
12
- for (const task of tasks) {
13
- const promise = task().then((result) => {
14
- executing.delete(promise);
15
- return result;
16
- });
17
- executing.add(promise);
18
- results.push(promise);
19
- if (executing.size >= limit) {
20
- const done = await Promise.race(executing);
21
- await onTaskDone?.({ result: done });
22
- }
23
- }
24
- await Promise.all(executing);
25
- return Promise.all(results);
26
- };
27
- /** Normalize an unknown thrown value into an Error instance - an ApplicationError when it was not one. */
28
- export const toError = (error) => {
29
- return error instanceof Error ? error : getError({ message: String(error) });
30
- };
31
2
  /** Check if a value is a promise. */
32
3
  export const isPromiseLike = (value) => {
33
4
  return (!!value &&
34
5
  (typeof value === 'object' || typeof value === 'function') &&
35
6
  typeof value.then === 'function');
36
7
  };
37
- /** Traverse a dotted property path on an object. */
38
- export const getDeepProperty = (obj, path) => {
39
- const keys = path.split('.');
40
- let result = obj;
41
- for (const key of keys) {
42
- if (result == null) {
43
- throw getError({ message: `Cannot read property '${key}' of ${result}` });
44
- }
45
- result = result[key];
8
+ /** Waiting, bounded concurrency and fire-and-forget. `voidExecution` is not a `BaseHelper` member: TS cannot emit protected members on an exported ANONYMOUS class (TS4094), which is what factory-built controllers return; a static on a separate class has no such limit. */
9
+ export class PromiseUtility {
10
+ static sleep(opts) {
11
+ return new Promise((resolve) => setTimeout(resolve, opts.ms));
46
12
  }
47
- return result;
48
- };
49
- /** Fire-and-forget: routes rejection to `logger` (or console.error), passes sync results through untouched. Standalone rather than a BaseHelper member - TS cannot emit protected members on an exported ANONYMOUS class (TS4094), which is what factory-built controllers return. */
50
- export const voidExecution = (opts) => {
51
- const { logger, scope, execution } = opts;
52
- if (!isPromiseLike(execution)) {
53
- return;
13
+ /** Execute async tasks with bounded concurrency. */
14
+ static async executeWithLimit(opts) {
15
+ const { tasks, limit, onTaskDone } = opts;
16
+ if (!Number.isInteger(limit) || limit < 1) {
17
+ throw getError({
18
+ message: `[executePromiseWithLimit] limit must be a positive integer | received: ${limit}`,
19
+ });
20
+ }
21
+ const results = [];
22
+ const executing = new Set();
23
+ for (const task of tasks) {
24
+ const promise = task().then((result) => {
25
+ executing.delete(promise);
26
+ return result;
27
+ });
28
+ executing.add(promise);
29
+ results.push(promise);
30
+ if (executing.size >= limit) {
31
+ const done = await Promise.race(executing);
32
+ await onTaskDone?.({ result: done });
33
+ }
34
+ }
35
+ await Promise.all(executing);
36
+ return Promise.all(results);
54
37
  }
55
- Promise.resolve(execution).catch((error) => {
56
- if (logger) {
57
- logger.for(scope).error('Unhandled error in fire-and-forget execution | Error: %s', error);
38
+ /** Fire-and-forget: routes rejection to `logger` (or console.error), passes sync results through untouched. */
39
+ static voidExecution(opts) {
40
+ const { logger, scope, execution } = opts;
41
+ if (!isPromiseLike(execution)) {
58
42
  return;
59
43
  }
60
- console.error('[%s] Unhandled error in fire-and-forget execution', scope, error);
61
- });
62
- };
44
+ Promise.resolve(execution).catch((error) => {
45
+ if (logger) {
46
+ logger.for(scope).error('Unhandled error in fire-and-forget execution | Error: %s', error);
47
+ return;
48
+ }
49
+ console.error('[%s] Unhandled error in fire-and-forget execution', scope, error);
50
+ });
51
+ }
52
+ }
63
53
  //# sourceMappingURL=promise.utility.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"promise.utility.js","sourceRoot":"","sources":["../../../src/utilities/promise.utility.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ValueOrPromise } from '@/common';\nimport { getError } from '@/modules/error';\nimport type { ILogger } from '@/modules/logger';\n\nexport type TTask<T> = (...args: any[]) => Promise<T>;\n\n/** Execute async tasks with bounded concurrency. */\nexport const executePromiseWithLimit = async <T>(opts: {\n tasks: Array<TTask<T>>;\n limit: number;\n onTaskDone?: <R>(opts: { result: R }) => ValueOrPromise<void>;\n}) => {\n const { tasks, limit, onTaskDone } = opts;\n\n if (!Number.isInteger(limit) || limit < 1) {\n throw getError({\n message: `[executePromiseWithLimit] limit must be a positive integer | received: ${limit}`,\n });\n }\n\n const results: Promise<T>[] = [];\n const executing = new Set();\n\n for (const task of tasks) {\n const promise = task().then((result) => {\n executing.delete(promise);\n return result;\n });\n\n executing.add(promise);\n results.push(promise);\n\n if (executing.size >= limit) {\n const done = await Promise.race(executing);\n await onTaskDone?.({ result: done });\n }\n }\n\n await Promise.all(executing);\n return Promise.all(results);\n};\n\n/** Normalize an unknown thrown value into an Error instance - an ApplicationError when it was not one. */\nexport const toError = (error: unknown): Error => {\n return error instanceof Error ? error : getError({ message: String(error) });\n};\n\n/** Check if a value is a promise. */\nexport const isPromiseLike = <T>(value: T | PromiseLike<T>): value is PromiseLike<T> => {\n return (\n !!value &&\n (typeof value === 'object' || typeof value === 'function') &&\n typeof (value as PromiseLike<T>).then === 'function'\n );\n};\n\n/** Traverse a dotted property path on an object. */\nexport const getDeepProperty = <T, V>(obj: T, path: string): V => {\n const keys = path.split('.');\n let result: any = obj;\n\n for (const key of keys) {\n if (result == null) {\n throw getError({ message: `Cannot read property '${key}' of ${result}` });\n }\n result = result[key];\n }\n\n return result as V;\n};\n\n/** Fire-and-forget: routes rejection to `logger` (or console.error), passes sync results through untouched. Standalone rather than a BaseHelper member - TS cannot emit protected members on an exported ANONYMOUS class (TS4094), which is what factory-built controllers return. */\nexport const voidExecution = (opts: {\n logger?: ILogger;\n scope: string;\n execution: ValueOrPromise<unknown>;\n}): void => {\n const { logger, scope, execution } = opts;\n\n if (!isPromiseLike(execution)) {\n return;\n }\n\n Promise.resolve(execution).catch((error: unknown) => {\n if (logger) {\n logger.for(scope).error('Unhandled error in fire-and-forget execution | Error: %s', error);\n return;\n }\n\n console.error('[%s] Unhandled error in fire-and-forget execution', scope, error);\n });\n};\n"]}
1
+ {"version":3,"file":"promise.utility.js","sourceRoot":"","sources":["../../../src/utilities/promise.utility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAK3C,qCAAqC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,KAAyB,EAA2B,EAAE;IACrF,OAAO,CACL,CAAC,CAAC,KAAK;QACP,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAC1D,OAAQ,KAAwB,CAAC,IAAI,KAAK,UAAU,CACrD,CAAC;AACJ,CAAC,CAAC;AAEF,gRAAgR;AAChR,MAAM,OAAO,cAAc;IACzB,MAAM,CAAC,KAAK,CAAC,IAAoB;QAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,oDAAoD;IACpD,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAI,IAIhC;QACC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAE1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,0EAA0E,KAAK,EAAE;aAC3F,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBACrC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC1B,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,SAAS,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC3C,MAAM,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,+GAA+G;IAC/G,MAAM,CAAC,aAAa,CAAC,IAIpB;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE1C,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAClD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,0DAA0D,EAAE,KAAK,CAAC,CAAC;gBAC3F,OAAO;YACT,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,mDAAmD,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { type ValueOrPromise } from '@/common';\nimport { getError } from '@/modules/error';\nimport type { ILogger } from '@/modules/logger';\n\nexport type TTask<T> = (...args: any[]) => Promise<T>;\n\n/** Check if a value is a promise. */\nexport const isPromiseLike = <T>(value: T | PromiseLike<T>): value is PromiseLike<T> => {\n return (\n !!value &&\n (typeof value === 'object' || typeof value === 'function') &&\n typeof (value as PromiseLike<T>).then === 'function'\n );\n};\n\n/** Waiting, bounded concurrency and fire-and-forget. `voidExecution` is not a `BaseHelper` member: TS cannot emit protected members on an exported ANONYMOUS class (TS4094), which is what factory-built controllers return; a static on a separate class has no such limit. */\nexport class PromiseUtility {\n static sleep(opts: { ms: number }): Promise<unknown> {\n return new Promise((resolve) => setTimeout(resolve, opts.ms));\n }\n\n /** Execute async tasks with bounded concurrency. */\n static async executeWithLimit<T>(opts: {\n tasks: Array<TTask<T>>;\n limit: number;\n onTaskDone?: <R>(opts: { result: R }) => ValueOrPromise<void>;\n }) {\n const { tasks, limit, onTaskDone } = opts;\n\n if (!Number.isInteger(limit) || limit < 1) {\n throw getError({\n message: `[executePromiseWithLimit] limit must be a positive integer | received: ${limit}`,\n });\n }\n\n const results: Promise<T>[] = [];\n const executing = new Set();\n\n for (const task of tasks) {\n const promise = task().then((result) => {\n executing.delete(promise);\n return result;\n });\n\n executing.add(promise);\n results.push(promise);\n\n if (executing.size >= limit) {\n const done = await Promise.race(executing);\n await onTaskDone?.({ result: done });\n }\n }\n\n await Promise.all(executing);\n return Promise.all(results);\n }\n\n /** Fire-and-forget: routes rejection to `logger` (or console.error), passes sync results through untouched. */\n static voidExecution(opts: {\n logger?: ILogger;\n scope: string;\n execution: ValueOrPromise<unknown>;\n }): void {\n const { logger, scope, execution } = opts;\n\n if (!isPromiseLike(execution)) {\n return;\n }\n\n Promise.resolve(execution).catch((error: unknown) => {\n if (logger) {\n logger.for(scope).error('Unhandled error in fire-and-forget execution | Error: %s', error);\n return;\n }\n\n console.error('[%s] Unhandled error in fire-and-forget execution', scope, error);\n });\n }\n}\n"]}
@@ -5,7 +5,7 @@ export interface IRequestedRemark {
5
5
  method: string;
6
6
  [extra: string | symbol]: any;
7
7
  }
8
- /** Where `parseMultipartBody` keeps an uploaded file: MEMORY (a buffer) or DISK (spooled to `uploadDir`). */
8
+ /** Where `RequestUtility.parseMultipartBody` keeps an uploaded file: MEMORY (a buffer) or DISK (spooled to `uploadDir`). */
9
9
  export declare class MultipartStorages {
10
10
  static readonly MEMORY = "memory";
11
11
  static readonly DISK = "disk";
@@ -38,14 +38,6 @@ export interface IParsedMultipartBody {
38
38
  files: IParsedFile[];
39
39
  fields: Record<string, string>;
40
40
  }
41
- export declare const parseMultipartBody: <C extends {
42
- req: any;
43
- } = {
44
- req: any;
45
- }>(opts: IParseMultipartOptions<C>) => Promise<IParsedMultipartBody>;
46
- /** Sanitizes a filename by removing path components and dangerous characters. The result is printable ASCII. */
47
- export declare const sanitizeFilename: (filename: string) => string;
48
- export declare const encodeRFC5987: (filename: string) => string;
49
41
  /** How a client treats a download: ATTACHMENT saves it, INLINE shows it. */
50
42
  export declare class ContentDispositionTypes {
51
43
  static readonly ATTACHMENT = "attachment";
@@ -55,25 +47,39 @@ export declare class ContentDispositionTypes {
55
47
  }
56
48
  /** Valid Content-Disposition type values. */
57
49
  export type TContentDispositionType = TConstValue<typeof ContentDispositionTypes>;
58
- export declare const createContentDispositionHeader: (opts: {
59
- filename: string;
60
- type: TContentDispositionType;
61
- }) => string;
62
- /**
63
- * Reads a filename out of a `Content-Disposition` value.
64
- *
65
- * Three forms, in the order the RFC gives them precedence: `filename*=UTF-8''...` (percent-encoded,
66
- * and the one hand-rolled parsers miss), a quoted `filename="..."`, and a bare `filename=...`.
67
- * Splitting on `filename=` alone returns the percent-encoded bytes for any non-ASCII name, which in
68
- * a product with non-English filenames is most of them.
69
- *
70
- * The pair of {@link createContentDispositionHeader}: one writes the header, this one reads it.
71
- */
72
- export declare const parseContentDisposition: (opts: {
73
- header: string | null | undefined;
74
- }) => {
75
- type?: string;
76
- filename?: string;
77
- };
50
+ export declare class RequestUtility {
51
+ static parseMultipartBody<C extends {
52
+ req: any;
53
+ } = {
54
+ req: any;
55
+ }>(opts: IParseMultipartOptions<C>): Promise<IParsedMultipartBody>;
56
+ /** Sanitizes a filename by removing path components and dangerous characters. The result is printable ASCII. */
57
+ static sanitizeFilename(opts: {
58
+ filename: string;
59
+ }): string;
60
+ static encodeRfc5987(opts: {
61
+ filename: string;
62
+ }): string;
63
+ static buildContentDispositionHeader(opts: {
64
+ filename: string;
65
+ type: TContentDispositionType;
66
+ }): string;
67
+ /**
68
+ * Reads a filename out of a `Content-Disposition` value.
69
+ *
70
+ * Three forms, in the order the RFC gives them precedence: `filename*=UTF-8''...` (percent-encoded,
71
+ * and the one hand-rolled parsers miss), a quoted `filename="..."`, and a bare `filename=...`.
72
+ * Splitting on `filename=` alone returns the percent-encoded bytes for any non-ASCII name, which in
73
+ * a product with non-English filenames is most of them.
74
+ *
75
+ * The pair of {@link RequestUtility.buildContentDispositionHeader}: one writes the header, this one reads it.
76
+ */
77
+ static parseContentDisposition(opts: {
78
+ header: string | null | undefined;
79
+ }): {
80
+ type?: string;
81
+ filename?: string;
82
+ };
83
+ }
78
84
  export {};
79
85
  //# sourceMappingURL=request.utility.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"request.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/request.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,6GAA6G;AAC7G,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA6C;IAEvE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEtE,UAAU,sBAAsB,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE;IACpE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8GAA8G;AAC9G,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,kBAAkB,GAAU,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,EAC5E,MAAM,sBAAsB,CAAC,CAAC,CAAC,KAC9B,OAAO,CAAC,oBAAoB,CA6D9B,CAAC;AAEF,gHAAgH;AAChH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MAUnD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG,MAIhD,CAAC;AAMF,4EAA4E;AAC5E,qBAAa,uBAAuB;IAClC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAElC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAmD;IAE7E,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,6CAA6C;AAC7C,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAElF,eAAO,MAAM,8BAA8B,GAAI,MAAM;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,uBAAuB,CAAC;CAC/B,KAAG,MAWH,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM;IAC5C,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC,KAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CA8BrC,CAAC"}
1
+ {"version":3,"file":"request.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/request.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,4HAA4H;AAC5H,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA6C;IAEvE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEtE,UAAU,sBAAsB,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE;IACpE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8GAA8G;AAC9G,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAMD,4EAA4E;AAC5E,qBAAa,uBAAuB;IAClC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAElC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAmD;IAE7E,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,6CAA6C;AAC7C,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAElF,qBAAa,cAAc;WACZ,kBAAkB,CAAC,CAAC,SAAS;QAAE,GAAG,EAAE,GAAG,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,GAAG,CAAA;KAAE,EACnE,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IA+DhC,gHAAgH;IAChH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAY3D,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAMxD,MAAM,CAAC,6BAA6B,CAAC,IAAI,EAAE;QACzC,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,uBAAuB,CAAC;KAC/B,GAAG,MAAM;IAaV;;;;;;;;;OASG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,GAAG;QAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;CA+BF"}