@venizia/ignis-helpers 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (245) hide show
  1. package/dist/cjs/common/redact.js +1 -1
  2. package/dist/cjs/common/redact.js.map +1 -1
  3. package/dist/cjs/modules/base.js +1 -1
  4. package/dist/cjs/modules/base.js.map +1 -1
  5. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js +1 -1
  6. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  7. package/dist/cjs/modules/logger/common/constants.js +1 -1
  8. package/dist/cjs/modules/logger/common/constants.js.map +1 -1
  9. package/dist/cjs/modules/logger/factory.js +1 -1
  10. package/dist/cjs/modules/logger/factory.js.map +1 -1
  11. package/dist/cjs/modules/logger/formatting/deep-splat.js +1 -1
  12. package/dist/cjs/modules/logger/formatting/deep-splat.js.map +1 -1
  13. package/dist/cjs/modules/logger/formatting/error-prettier.js +4 -4
  14. package/dist/cjs/modules/logger/formatting/error-prettier.js.map +1 -1
  15. package/dist/cjs/modules/logger/hf/flusher.js +3 -3
  16. package/dist/cjs/modules/logger/hf/flusher.js.map +1 -1
  17. package/dist/cjs/modules/logger/resolver.js +3 -3
  18. package/dist/cjs/modules/logger/resolver.js.map +1 -1
  19. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js +1 -1
  20. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  21. package/dist/cjs/modules/logger/winston/logger-factory.js +1 -1
  22. package/dist/cjs/modules/logger/winston/logger-factory.js.map +1 -1
  23. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js +2 -2
  24. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  25. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  26. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  27. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  28. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  29. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  30. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  31. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  32. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  33. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js +34 -11
  34. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  35. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  36. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  37. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
  38. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  39. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  40. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  41. package/dist/cjs/modules/network/utilities/query-string.d.ts +27 -2
  42. package/dist/cjs/modules/network/utilities/query-string.d.ts.map +1 -1
  43. package/dist/cjs/modules/network/utilities/query-string.js +34 -2
  44. package/dist/cjs/modules/network/utilities/query-string.js.map +1 -1
  45. package/dist/cjs/modules/network/utilities/url-safety/ingest.js +1 -1
  46. package/dist/cjs/modules/network/utilities/url-safety/ingest.js.map +1 -1
  47. package/dist/cjs/modules/network/utilities/url-safety/policy.js +1 -1
  48. package/dist/cjs/modules/network/utilities/url-safety/policy.js.map +1 -1
  49. package/dist/cjs/modules/pool/abstract.js +4 -4
  50. package/dist/cjs/modules/pool/abstract.js.map +1 -1
  51. package/dist/cjs/modules/queue/bullmq/helper.js +2 -2
  52. package/dist/cjs/modules/queue/bullmq/helper.js.map +1 -1
  53. package/dist/cjs/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  54. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  55. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  56. package/dist/cjs/modules/queue/kafka/consumer.js +2 -2
  57. package/dist/cjs/modules/queue/kafka/consumer.js.map +1 -1
  58. package/dist/cjs/modules/queue/mqtt/helper.js +4 -4
  59. package/dist/cjs/modules/queue/mqtt/helper.js.map +1 -1
  60. package/dist/cjs/modules/redis/base/abstract.helper.js +4 -4
  61. package/dist/cjs/modules/redis/base/abstract.helper.js.map +1 -1
  62. package/dist/cjs/modules/redis/cluster/cluster.helper.js +1 -1
  63. package/dist/cjs/modules/redis/cluster/cluster.helper.js.map +1 -1
  64. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js +1 -1
  65. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  66. package/dist/cjs/modules/secrets/base/abstract.helper.js +2 -2
  67. package/dist/cjs/modules/secrets/base/abstract.helper.js.map +1 -1
  68. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  69. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  70. package/dist/cjs/modules/socket/socket-io/browser.d.ts +5 -0
  71. package/dist/cjs/modules/socket/socket-io/browser.d.ts.map +1 -0
  72. package/dist/cjs/modules/socket/socket-io/browser.js +21 -0
  73. package/dist/cjs/modules/socket/socket-io/browser.js.map +1 -0
  74. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  75. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  76. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js +250 -0
  77. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  78. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts +8 -51
  79. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  80. package/dist/cjs/modules/socket/socket-io/client/helper.js +12 -230
  81. package/dist/cjs/modules/socket/socket-io/client/helper.js.map +1 -1
  82. package/dist/cjs/modules/socket/socket-io/server/helper.js +5 -5
  83. package/dist/cjs/modules/socket/socket-io/server/helper.js.map +1 -1
  84. package/dist/cjs/modules/socket/websocket/server/delivery.js +2 -2
  85. package/dist/cjs/modules/socket/websocket/server/delivery.js.map +1 -1
  86. package/dist/cjs/modules/socket/websocket/server/helper.js +4 -4
  87. package/dist/cjs/modules/socket/websocket/server/helper.js.map +1 -1
  88. package/dist/cjs/modules/storage/base.js +3 -3
  89. package/dist/cjs/modules/storage/base.js.map +1 -1
  90. package/dist/cjs/modules/storage/bun-s3/helper.js +1 -1
  91. package/dist/cjs/modules/storage/bun-s3/helper.js.map +1 -1
  92. package/dist/cjs/modules/storage/bun-s3/utility.js +6 -6
  93. package/dist/cjs/modules/storage/bun-s3/utility.js.map +1 -1
  94. package/dist/cjs/modules/storage/common/errors.js +1 -1
  95. package/dist/cjs/modules/storage/common/errors.js.map +1 -1
  96. package/dist/cjs/modules/storage/minio/helper.js +4 -4
  97. package/dist/cjs/modules/storage/minio/helper.js.map +1 -1
  98. package/dist/cjs/modules/temporal/abstract.js +5 -5
  99. package/dist/cjs/modules/temporal/abstract.js.map +1 -1
  100. package/dist/cjs/modules/temporal/adapters/intl.d.ts.map +1 -1
  101. package/dist/cjs/modules/temporal/adapters/intl.js +3 -1
  102. package/dist/cjs/modules/temporal/adapters/intl.js.map +1 -1
  103. package/dist/cjs/modules/temporal/locale/locale.js +4 -4
  104. package/dist/cjs/modules/temporal/locale/locale.js.map +1 -1
  105. package/dist/cjs/modules/tree/builder.js +2 -2
  106. package/dist/cjs/modules/tree/builder.js.map +1 -1
  107. package/dist/cjs/modules/uid/opaque.js +2 -2
  108. package/dist/cjs/modules/uid/opaque.js.map +1 -1
  109. package/dist/cjs/modules/uid/uuid/v5.js +1 -1
  110. package/dist/cjs/modules/uid/uuid/v5.js.map +1 -1
  111. package/dist/cjs/modules/worker-thread/bus/base.js +4 -4
  112. package/dist/cjs/modules/worker-thread/bus/base.js.map +1 -1
  113. package/dist/cjs/modules/worker-thread/worker/base.js +4 -4
  114. package/dist/cjs/modules/worker-thread/worker/base.js.map +1 -1
  115. package/dist/cjs/utilities/parse.utility.js +4 -4
  116. package/dist/cjs/utilities/parse.utility.js.map +1 -1
  117. package/dist/cjs/utilities/promise.utility.js +1 -1
  118. package/dist/cjs/utilities/promise.utility.js.map +1 -1
  119. package/dist/cjs/utilities/request.utility.js +1 -1
  120. package/dist/cjs/utilities/request.utility.js.map +1 -1
  121. package/dist/cjs/utilities/sleep.utility.js +1 -1
  122. package/dist/cjs/utilities/sleep.utility.js.map +1 -1
  123. package/dist/esm/common/redact.js +1 -1
  124. package/dist/esm/common/redact.js.map +1 -1
  125. package/dist/esm/modules/base.js +1 -1
  126. package/dist/esm/modules/base.js.map +1 -1
  127. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +1 -1
  128. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  129. package/dist/esm/modules/logger/common/constants.js +1 -1
  130. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  131. package/dist/esm/modules/logger/factory.js +1 -1
  132. package/dist/esm/modules/logger/factory.js.map +1 -1
  133. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -1
  134. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  135. package/dist/esm/modules/logger/formatting/error-prettier.js +4 -4
  136. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  137. package/dist/esm/modules/logger/hf/flusher.js +3 -3
  138. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  139. package/dist/esm/modules/logger/resolver.js +3 -3
  140. package/dist/esm/modules/logger/resolver.js.map +1 -1
  141. package/dist/esm/modules/logger/winston/formatters/deep-splat.js +1 -1
  142. package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  143. package/dist/esm/modules/logger/winston/logger-factory.js +1 -1
  144. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  145. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +2 -2
  146. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  147. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  148. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  149. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  150. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  151. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  152. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  153. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  154. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  155. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +36 -13
  156. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  157. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  158. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  159. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
  160. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  161. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  162. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  163. package/dist/esm/modules/network/utilities/query-string.d.ts +27 -2
  164. package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
  165. package/dist/esm/modules/network/utilities/query-string.js +31 -1
  166. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  167. package/dist/esm/modules/network/utilities/url-safety/ingest.js +1 -1
  168. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  169. package/dist/esm/modules/network/utilities/url-safety/policy.js +1 -1
  170. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  171. package/dist/esm/modules/pool/abstract.js +4 -4
  172. package/dist/esm/modules/pool/abstract.js.map +1 -1
  173. package/dist/esm/modules/queue/bullmq/helper.js +2 -2
  174. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  175. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  176. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  177. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  178. package/dist/esm/modules/queue/kafka/consumer.js +2 -2
  179. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  180. package/dist/esm/modules/queue/mqtt/helper.js +4 -4
  181. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  182. package/dist/esm/modules/redis/base/abstract.helper.js +4 -4
  183. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  184. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -1
  185. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  186. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -1
  187. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  188. package/dist/esm/modules/secrets/base/abstract.helper.js +2 -2
  189. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  190. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  191. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  192. package/dist/esm/modules/socket/socket-io/browser.d.ts +5 -0
  193. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +1 -0
  194. package/dist/esm/modules/socket/socket-io/browser.js +5 -0
  195. package/dist/esm/modules/socket/socket-io/browser.js.map +1 -0
  196. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  197. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  198. package/dist/esm/modules/socket/socket-io/client/browser-helper.js +246 -0
  199. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  200. package/dist/esm/modules/socket/socket-io/client/helper.d.ts +8 -51
  201. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  202. package/dist/esm/modules/socket/socket-io/client/helper.js +12 -230
  203. package/dist/esm/modules/socket/socket-io/client/helper.js.map +1 -1
  204. package/dist/esm/modules/socket/socket-io/server/helper.js +5 -5
  205. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  206. package/dist/esm/modules/socket/websocket/server/delivery.js +2 -2
  207. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  208. package/dist/esm/modules/socket/websocket/server/helper.js +4 -4
  209. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  210. package/dist/esm/modules/storage/base.js +3 -3
  211. package/dist/esm/modules/storage/base.js.map +1 -1
  212. package/dist/esm/modules/storage/bun-s3/helper.js +1 -1
  213. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  214. package/dist/esm/modules/storage/bun-s3/utility.js +6 -6
  215. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  216. package/dist/esm/modules/storage/common/errors.js +1 -1
  217. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  218. package/dist/esm/modules/storage/minio/helper.js +4 -4
  219. package/dist/esm/modules/storage/minio/helper.js.map +1 -1
  220. package/dist/esm/modules/temporal/abstract.js +5 -5
  221. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  222. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +1 -1
  223. package/dist/esm/modules/temporal/adapters/intl.js +3 -1
  224. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  225. package/dist/esm/modules/temporal/locale/locale.js +4 -4
  226. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  227. package/dist/esm/modules/tree/builder.js +2 -2
  228. package/dist/esm/modules/tree/builder.js.map +1 -1
  229. package/dist/esm/modules/uid/opaque.js +2 -2
  230. package/dist/esm/modules/uid/opaque.js.map +1 -1
  231. package/dist/esm/modules/uid/uuid/v5.js +1 -1
  232. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  233. package/dist/esm/modules/worker-thread/bus/base.js +4 -4
  234. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  235. package/dist/esm/modules/worker-thread/worker/base.js +4 -4
  236. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  237. package/dist/esm/utilities/parse.utility.js +4 -4
  238. package/dist/esm/utilities/parse.utility.js.map +1 -1
  239. package/dist/esm/utilities/promise.utility.js +1 -1
  240. package/dist/esm/utilities/promise.utility.js.map +1 -1
  241. package/dist/esm/utilities/request.utility.js +1 -1
  242. package/dist/esm/utilities/request.utility.js.map +1 -1
  243. package/dist/esm/utilities/sleep.utility.js +1 -1
  244. package/dist/esm/utilities/sleep.utility.js.map +1 -1
  245. package/package.json +10 -4
@@ -76,19 +76,19 @@ export class BaseWorkerHelper extends AbstractWorkerHelper {
76
76
  this.worker.on('online', () => {
77
77
  this.invokeHook({ scope: this.binding.name, execution: () => this.onOnline() });
78
78
  });
79
- this.worker.on('exit', code => {
79
+ this.worker.on('exit', (code) => {
80
80
  this.invokeHook({ scope: this.binding.name, execution: () => this.onExit({ code }) });
81
81
  });
82
- this.worker.on('error', error => {
82
+ this.worker.on('error', (error) => {
83
83
  this.invokeHook({
84
84
  scope: this.binding.name,
85
85
  execution: () => this.onError({ error: toError(error) }),
86
86
  });
87
87
  });
88
- this.worker.on('message', message => {
88
+ this.worker.on('message', (message) => {
89
89
  this.invokeHook({ scope: this.binding.name, execution: () => this.onMessage({ message }) });
90
90
  });
91
- this.worker.on('messageerror', error => {
91
+ this.worker.on('messageerror', (error) => {
92
92
  this.invokeHook({
93
93
  scope: this.binding.name,
94
94
  execution: () => this.onMessageError({ error }),
@@ -1 +1 @@
1
- {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/worker/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { toError, voidExecution } from '@/utilities/promise.utility';\nimport { Worker, type WorkerOptions } from 'node:worker_threads';\n\nimport { type ValueOrPromise } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { type IWorker } from '../common';\nimport { AbstractWorkerHelper } from './abstract';\n\nexport class BaseWorkerHelper<MessageType> extends AbstractWorkerHelper<MessageType> {\n protected eventHandlers?: Partial<\n Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>\n >;\n\n constructor(opts: {\n scope?: string;\n identifier: string;\n path: string | URL;\n options: WorkerOptions;\n eventHandlers?: Partial<\n Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>\n >;\n }) {\n super({ scope: BaseWorkerHelper.name, identifier: opts.identifier });\n this.worker = new Worker(opts.path, opts.options);\n this.eventHandlers = opts.eventHandlers;\n\n this.binding();\n }\n\n /** User handlers run inside worker listeners; a sync throw there is uncaught and kills the process, so wrap it - voidExecution alone can't catch a throw evaluated before it's called. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n override onOnline(): ValueOrPromise<void> {\n if (this.eventHandlers?.onOnline) {\n this.invokeHook({\n scope: this.onOnline.name,\n execution: () => this.eventHandlers?.onOnline?.(),\n });\n return;\n }\n\n this.logger.for(this.onOnline.name).info('Worker ONLINE');\n }\n\n override onExit(opts: { code: string | number }): ValueOrPromise<void> {\n if (this.eventHandlers?.onExit) {\n this.invokeHook({\n scope: this.onExit.name,\n execution: () => this.eventHandlers?.onExit?.({ code: opts.code }),\n });\n return;\n }\n\n this.logger.for(this.onExit.name).warn('Worker EXIT | Code: %s', opts.code);\n }\n\n override onError(opts: { error: Error }): ValueOrPromise<void> {\n if (this.eventHandlers?.onError) {\n this.invokeHook({\n scope: this.onError.name,\n execution: () => this.eventHandlers?.onError?.({ error: opts.error }),\n });\n return;\n }\n\n this.logger.for(this.onError.name).error('Worker ERROR | Error: %s', opts.error);\n }\n\n override onMessage(opts: { message: MessageType }): ValueOrPromise<void> {\n if (this.eventHandlers?.onMessage) {\n this.invokeHook({\n scope: this.onMessage.name,\n execution: () => this.eventHandlers?.onMessage?.({ message: opts.message }),\n });\n return;\n }\n\n this.logger.for(this.onMessage.name).error('Worker MESSAGE | message: %j', opts.message);\n }\n\n override onMessageError(opts: { error: Error }): ValueOrPromise<void> {\n if (this.eventHandlers?.onMessageError) {\n this.invokeHook({\n scope: this.onMessageError.name,\n execution: () => this.eventHandlers?.onMessageError?.({ error: opts.error }),\n });\n return;\n }\n\n this.logger.for(this.onMessageError.name).error('Worker MESSAGE_ERROR | Error: %s', opts.error);\n }\n\n binding() {\n if (!this.worker) {\n throw getError({ message: '[binding] Invalid worker instance to bind event handlers' });\n }\n\n this.worker.on('online', () => {\n this.invokeHook({ scope: this.binding.name, execution: () => this.onOnline() });\n });\n\n this.worker.on('exit', code => {\n this.invokeHook({ scope: this.binding.name, execution: () => this.onExit({ code }) });\n });\n\n this.worker.on('error', error => {\n this.invokeHook({\n scope: this.binding.name,\n execution: () => this.onError({ error: toError(error) }),\n });\n });\n\n this.worker.on('message', message => {\n this.invokeHook({ scope: this.binding.name, execution: () => this.onMessage({ message }) });\n });\n\n this.worker.on('messageerror', error => {\n this.invokeHook({\n scope: this.binding.name,\n execution: () => this.onMessageError({ error }),\n });\n });\n }\n}\n"]}
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/modules/worker-thread/worker/base.ts"],"names":[],"mappings":"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","sourcesContent":["import { toError, voidExecution } from '@/utilities/promise.utility';\nimport { Worker, type WorkerOptions } from 'node:worker_threads';\n\nimport { type ValueOrPromise } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { type IWorker } from '../common';\nimport { AbstractWorkerHelper } from './abstract';\n\nexport class BaseWorkerHelper<MessageType> extends AbstractWorkerHelper<MessageType> {\n protected eventHandlers?: Partial<\n Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>\n >;\n\n constructor(opts: {\n scope?: string;\n identifier: string;\n path: string | URL;\n options: WorkerOptions;\n eventHandlers?: Partial<\n Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>\n >;\n }) {\n super({ scope: BaseWorkerHelper.name, identifier: opts.identifier });\n this.worker = new Worker(opts.path, opts.options);\n this.eventHandlers = opts.eventHandlers;\n\n this.binding();\n }\n\n /** User handlers run inside worker listeners; a sync throw there is uncaught and kills the process, so wrap it - voidExecution alone can't catch a throw evaluated before it's called. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n override onOnline(): ValueOrPromise<void> {\n if (this.eventHandlers?.onOnline) {\n this.invokeHook({\n scope: this.onOnline.name,\n execution: () => this.eventHandlers?.onOnline?.(),\n });\n return;\n }\n\n this.logger.for(this.onOnline.name).info('Worker ONLINE');\n }\n\n override onExit(opts: { code: string | number }): ValueOrPromise<void> {\n if (this.eventHandlers?.onExit) {\n this.invokeHook({\n scope: this.onExit.name,\n execution: () => this.eventHandlers?.onExit?.({ code: opts.code }),\n });\n return;\n }\n\n this.logger.for(this.onExit.name).warn('Worker EXIT | Code: %s', opts.code);\n }\n\n override onError(opts: { error: Error }): ValueOrPromise<void> {\n if (this.eventHandlers?.onError) {\n this.invokeHook({\n scope: this.onError.name,\n execution: () => this.eventHandlers?.onError?.({ error: opts.error }),\n });\n return;\n }\n\n this.logger.for(this.onError.name).error('Worker ERROR | Error: %s', opts.error);\n }\n\n override onMessage(opts: { message: MessageType }): ValueOrPromise<void> {\n if (this.eventHandlers?.onMessage) {\n this.invokeHook({\n scope: this.onMessage.name,\n execution: () => this.eventHandlers?.onMessage?.({ message: opts.message }),\n });\n return;\n }\n\n this.logger.for(this.onMessage.name).error('Worker MESSAGE | message: %j', opts.message);\n }\n\n override onMessageError(opts: { error: Error }): ValueOrPromise<void> {\n if (this.eventHandlers?.onMessageError) {\n this.invokeHook({\n scope: this.onMessageError.name,\n execution: () => this.eventHandlers?.onMessageError?.({ error: opts.error }),\n });\n return;\n }\n\n this.logger.for(this.onMessageError.name).error('Worker MESSAGE_ERROR | Error: %s', opts.error);\n }\n\n binding() {\n if (!this.worker) {\n throw getError({ message: '[binding] Invalid worker instance to bind event handlers' });\n }\n\n this.worker.on('online', () => {\n this.invokeHook({ scope: this.binding.name, execution: () => this.onOnline() });\n });\n\n this.worker.on('exit', (code) => {\n this.invokeHook({ scope: this.binding.name, execution: () => this.onExit({ code }) });\n });\n\n this.worker.on('error', (error) => {\n this.invokeHook({\n scope: this.binding.name,\n execution: () => this.onError({ error: toError(error) }),\n });\n });\n\n this.worker.on('message', (message) => {\n this.invokeHook({ scope: this.binding.name, execution: () => this.onMessage({ message }) });\n });\n\n this.worker.on('messageerror', (error) => {\n this.invokeHook({\n scope: this.binding.name,\n execution: () => this.onMessageError({ error }),\n });\n });\n }\n}\n"]}
@@ -27,7 +27,7 @@ export const toCamel = (s) => {
27
27
  /** 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. */
28
28
  const camelizeValue = (value) => {
29
29
  if (Array.isArray(value)) {
30
- return value.map(element => camelizeValue(element));
30
+ return value.map((element) => camelizeValue(element));
31
31
  }
32
32
  if (!value || typeof value !== 'object' || value instanceof Date) {
33
33
  return value;
@@ -111,7 +111,7 @@ export const parseArrayToMapWithKey = (arr, keyMap) => {
111
111
  if (!arr.length) {
112
112
  return resultMap;
113
113
  }
114
- arr.forEach(element => {
114
+ arr.forEach((element) => {
115
115
  if (!(keyMap in element)) {
116
116
  throw getError({
117
117
  message: 'Invalid keyMap',
@@ -128,8 +128,8 @@ export const toDelimitedArray = (input, separator = ',') => {
128
128
  }
129
129
  return String(input)
130
130
  .split(separator)
131
- .map(entry => entry.trim())
132
- .filter(entry => entry.length > 0);
131
+ .map((entry) => entry.trim())
132
+ .filter((entry) => entry.length > 0);
133
133
  };
134
134
  /**
135
135
  * A trimmed value, or `undefined` when the input is absent or carries nothing but whitespace.
@@ -1 +1 @@
1
- {"version":3,"file":"parse.utility.js","sourceRoot":"","sources":["../../../src/utilities/parse.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,KAAK,GAAG,CAAC,IAA2C,EAAU,EAAE;IACpE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAEtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,GAAG,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC,GAAG,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;AACjF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAE9E,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE;IACnC,OAAO,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,GAAW,EAAE,EAAE;QAChD,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,gMAAgM;AAChM,MAAM,aAAa,GAAG,CAAC,KAAc,EAAW,EAAE;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAQ,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,EAAE;IAC5C,MAAM,CAAC,GAAQ,EAAE,CAAC;IAClB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAE,MAAkC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAM,EAAE,EAAE;IAC9B,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAU,EAAE,EAAE;IACpC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,KAAU,EAAE,EAAE;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAU,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAU,EAAW,EAAE;IAC/C,OAAO,CACL,KAAK,KAAK,EAAE;QACZ,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,KAAK;QACf,KAAK,KAAK,CAAC;QACX,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,SAAS,CACpB,CAAC;AACJ,CAAC,CAAC;AAEF,yFAAyF;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,GAAQ,EACR,MAAS,EACK,EAAE;IAChB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAW,CAAC;IAErC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACpB,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,gBAAgB;aAC1B,CAAC,CAAC;QACL,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,sLAAsL;AACtL,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAE,SAAS,GAAG,GAAG,EAAY,EAAE;IAC5E,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC;SACjB,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAyB,EAAsB,EAAE;IAChF,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC7E,CAAC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE;IAClD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC,CAAC","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/**\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"]}
@@ -10,7 +10,7 @@ export const executePromiseWithLimit = async (opts) => {
10
10
  const results = [];
11
11
  const executing = new Set();
12
12
  for (const task of tasks) {
13
- const promise = task().then(result => {
13
+ const promise = task().then((result) => {
14
14
  executing.delete(promise);
15
15
  return result;
16
16
  });
@@ -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":"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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"]}
@@ -68,7 +68,7 @@ export const sanitizeFilename = (filename) => {
68
68
  };
69
69
  export const encodeRFC5987 = (filename) => {
70
70
  return encodeURIComponent(filename)
71
- .replace(/['()]/g, c => '%' + c.charCodeAt(0).toString(16).toUpperCase())
71
+ .replace(/['()]/g, (c) => '%' + c.charCodeAt(0).toString(16).toUpperCase())
72
72
  .replace(/\*/g, '%2A');
73
73
  };
74
74
  /** Control, format (bidi overrides, zero-width space) and lone surrogate characters: a format character reorders the name a client shows, a lone surrogate makes `encodeURIComponent` throw. The zero-width joiner and non-joiner stay: they build emoji sequences and Persian words, and reorder nothing. */
@@ -1 +1 @@
1
- {"version":3,"file":"request.utility.js","sourceRoot":"","sources":["../../../src/utilities/request.utility.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { readFormBody } from './form-body.utility';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nexport interface IRequestedRemark {\n id: string;\n url: string;\n method: string;\n [extra: string | symbol]: any;\n}\n\ninterface IParseMultipartOptions<C extends { req: any } = { req: any }> {\n storage?: 'memory' | 'disk';\n uploadDir?: string;\n context: C;\n}\n\ninterface IParsedFile {\n fieldname: string;\n originalname: string;\n encoding: string;\n mimetype: string;\n size: number;\n buffer?: Buffer;\n filename?: string;\n path?: string;\n}\n\n/** Files and the text fields posted beside them - dropping the second silently loses what the client sent. */\nexport interface IParsedMultipartBody {\n files: IParsedFile[];\n fields: Record<string, string>;\n}\n\nexport const parseMultipartBody = async <C extends { req: any } = { req: any }>(\n opts: IParseMultipartOptions<C>,\n): Promise<IParsedMultipartBody> => {\n const { storage = 'memory', uploadDir = './uploads', context } = opts;\n\n if (storage === 'disk' && !fs.existsSync(uploadDir)) {\n fs.mkdirSync(uploadDir, { recursive: true });\n }\n\n const formData = await readFormBody({ req: context.req });\n const files: IParsedFile[] = [];\n const fields: Record<string, string> = {};\n\n const entries = formData.entries();\n for (const [fieldname, value] of entries) {\n if (typeof value === 'string') {\n // Last one wins, like a repeated query parameter.\n fields[fieldname] = value;\n continue;\n }\n\n const file = value as File;\n const arrayBuffer = await file.arrayBuffer();\n const buffer = Buffer.from(arrayBuffer);\n\n const parsedFile: IParsedFile = {\n fieldname,\n originalname: file.name,\n encoding: 'utf8',\n mimetype: file.type,\n size: file.size,\n };\n\n switch (storage) {\n case 'memory': {\n parsedFile.buffer = buffer;\n break;\n }\n case 'disk': {\n const timestamp = Date.now();\n const randomString = Math.random().toString(36).substring(7);\n // Sanitize filename to prevent path traversal\n const sanitizedName = path.basename(file.name).replace(/[^a-zA-Z0-9._-]/g, '_');\n const filename = `${timestamp}-${randomString}-${sanitizedName}`;\n const filepath = path.join(uploadDir, filename);\n\n fs.writeFileSync(filepath, buffer);\n\n parsedFile.filename = filename;\n parsedFile.path = filepath;\n break;\n }\n default: {\n throw getError({\n message: `[parseMultipartBody] storage: ${storage} | Invalid storage type | Valids: ['memory', 'disk']`,\n });\n }\n }\n\n files.push(parsedFile);\n }\n\n return { files, fields };\n};\n\n/** Sanitizes a filename by removing path components and dangerous characters. The result is printable ASCII. */\nexport const sanitizeFilename = (filename: string): string => {\n const basename = path.basename(filename);\n let sanitized = basename.replace(/[^\\w .-]/g, '_');\n sanitized = sanitized.replace(/^\\.+/, '');\n sanitized = sanitized.replace(/\\.{2,}/g, '.');\n sanitized = sanitized.replace(/\\.\\./g, '.');\n if (!sanitized || sanitized === '.' || sanitized.includes('..')) {\n sanitized = 'download';\n }\n return sanitized;\n};\n\nexport const encodeRFC5987 = (filename: string): string => {\n return encodeURIComponent(filename)\n .replace(/['()]/g, c => '%' + c.charCodeAt(0).toString(16).toUpperCase())\n .replace(/\\*/g, '%2A');\n};\n\n/** Control, format (bidi overrides, zero-width space) and lone surrogate characters: a format character reorders the name a client shows, a lone surrogate makes `encodeURIComponent` throw. The zero-width joiner and non-joiner stay: they build emoji sequences and Persian words, and reorder nothing. */\nconst UNENCODABLE_FILENAME_CHARACTERS = /(?![\\u200C\\u200D])[\\p{Cc}\\p{Cf}\\p{Cs}]/gu;\nconst LEADING_DOTS = /^\\.+/;\n\nexport const createContentDispositionHeader = (opts: {\n filename: string;\n type: 'attachment' | 'inline';\n}): string => {\n const { filename, type } = opts;\n const sanitized = sanitizeFilename(filename);\n const extendedName = path\n .basename(filename)\n .replace(UNENCODABLE_FILENAME_CHARACTERS, '_')\n .replace(LEADING_DOTS, '');\n const encoded = encodeRFC5987(extendedName || sanitized);\n\n // filename= is the ASCII fallback for old browsers, filename*= the UTF-8 form for modern ones.\n return `${type}; filename=\"${sanitized}\"; filename*=UTF-8''${encoded}`;\n};\n\n/**\n * Reads a filename out of a `Content-Disposition` value.\n *\n * Three forms, in the order the RFC gives them precedence: `filename*=UTF-8''...` (percent-encoded,\n * and the one hand-rolled parsers miss), a quoted `filename=\"...\"`, and a bare `filename=...`.\n * Splitting on `filename=` alone returns the percent-encoded bytes for any non-ASCII name, which in\n * a product with non-English filenames is most of them.\n *\n * The pair of {@link createContentDispositionHeader}: one writes the header, this one reads it.\n */\nexport const parseContentDisposition = (opts: {\n header: string | null | undefined;\n}): { type?: string; filename?: string } => {\n const { header } = opts;\n\n if (!header) {\n return {};\n }\n\n const type = header.split(';')[0]?.trim() || undefined;\n\n // `filename*` wins when both are present - it is the one that can carry a non-ASCII name.\n const extended = header.match(/filename\\*\\s*=\\s*([^;]+)/i);\n if (extended) {\n const value = extended[1].trim();\n // `UTF-8''name` or `UTF-8'lang'name`; anything before the last quote is charset and language.\n const encoded = value.slice(value.lastIndexOf(\"'\") + 1);\n\n try {\n return { type, filename: decodeURIComponent(encoded) };\n } catch {\n // A malformed sequence is not worth failing a download over - fall through to `filename`.\n }\n }\n\n const quoted = header.match(/filename\\s*=\\s*\"([^\"]*)\"/i);\n if (quoted) {\n return { type, filename: quoted[1] };\n }\n\n const bare = header.match(/filename\\s*=\\s*([^;]+)/i);\n return { type, filename: bare ? bare[1].trim() : undefined };\n};\n"]}
1
+ {"version":3,"file":"request.utility.js","sourceRoot":"","sources":["../../../src/utilities/request.utility.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { readFormBody } from './form-body.utility';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nexport interface IRequestedRemark {\n id: string;\n url: string;\n method: string;\n [extra: string | symbol]: any;\n}\n\ninterface IParseMultipartOptions<C extends { req: any } = { req: any }> {\n storage?: 'memory' | 'disk';\n uploadDir?: string;\n context: C;\n}\n\ninterface IParsedFile {\n fieldname: string;\n originalname: string;\n encoding: string;\n mimetype: string;\n size: number;\n buffer?: Buffer;\n filename?: string;\n path?: string;\n}\n\n/** Files and the text fields posted beside them - dropping the second silently loses what the client sent. */\nexport interface IParsedMultipartBody {\n files: IParsedFile[];\n fields: Record<string, string>;\n}\n\nexport const parseMultipartBody = async <C extends { req: any } = { req: any }>(\n opts: IParseMultipartOptions<C>,\n): Promise<IParsedMultipartBody> => {\n const { storage = 'memory', uploadDir = './uploads', context } = opts;\n\n if (storage === 'disk' && !fs.existsSync(uploadDir)) {\n fs.mkdirSync(uploadDir, { recursive: true });\n }\n\n const formData = await readFormBody({ req: context.req });\n const files: IParsedFile[] = [];\n const fields: Record<string, string> = {};\n\n const entries = formData.entries();\n for (const [fieldname, value] of entries) {\n if (typeof value === 'string') {\n // Last one wins, like a repeated query parameter.\n fields[fieldname] = value;\n continue;\n }\n\n const file = value as File;\n const arrayBuffer = await file.arrayBuffer();\n const buffer = Buffer.from(arrayBuffer);\n\n const parsedFile: IParsedFile = {\n fieldname,\n originalname: file.name,\n encoding: 'utf8',\n mimetype: file.type,\n size: file.size,\n };\n\n switch (storage) {\n case 'memory': {\n parsedFile.buffer = buffer;\n break;\n }\n case 'disk': {\n const timestamp = Date.now();\n const randomString = Math.random().toString(36).substring(7);\n // Sanitize filename to prevent path traversal\n const sanitizedName = path.basename(file.name).replace(/[^a-zA-Z0-9._-]/g, '_');\n const filename = `${timestamp}-${randomString}-${sanitizedName}`;\n const filepath = path.join(uploadDir, filename);\n\n fs.writeFileSync(filepath, buffer);\n\n parsedFile.filename = filename;\n parsedFile.path = filepath;\n break;\n }\n default: {\n throw getError({\n message: `[parseMultipartBody] storage: ${storage} | Invalid storage type | Valids: ['memory', 'disk']`,\n });\n }\n }\n\n files.push(parsedFile);\n }\n\n return { files, fields };\n};\n\n/** Sanitizes a filename by removing path components and dangerous characters. The result is printable ASCII. */\nexport const sanitizeFilename = (filename: string): string => {\n const basename = path.basename(filename);\n let sanitized = basename.replace(/[^\\w .-]/g, '_');\n sanitized = sanitized.replace(/^\\.+/, '');\n sanitized = sanitized.replace(/\\.{2,}/g, '.');\n sanitized = sanitized.replace(/\\.\\./g, '.');\n if (!sanitized || sanitized === '.' || sanitized.includes('..')) {\n sanitized = 'download';\n }\n return sanitized;\n};\n\nexport const encodeRFC5987 = (filename: string): string => {\n return encodeURIComponent(filename)\n .replace(/['()]/g, (c) => '%' + c.charCodeAt(0).toString(16).toUpperCase())\n .replace(/\\*/g, '%2A');\n};\n\n/** Control, format (bidi overrides, zero-width space) and lone surrogate characters: a format character reorders the name a client shows, a lone surrogate makes `encodeURIComponent` throw. The zero-width joiner and non-joiner stay: they build emoji sequences and Persian words, and reorder nothing. */\nconst UNENCODABLE_FILENAME_CHARACTERS = /(?![\\u200C\\u200D])[\\p{Cc}\\p{Cf}\\p{Cs}]/gu;\nconst LEADING_DOTS = /^\\.+/;\n\nexport const createContentDispositionHeader = (opts: {\n filename: string;\n type: 'attachment' | 'inline';\n}): string => {\n const { filename, type } = opts;\n const sanitized = sanitizeFilename(filename);\n const extendedName = path\n .basename(filename)\n .replace(UNENCODABLE_FILENAME_CHARACTERS, '_')\n .replace(LEADING_DOTS, '');\n const encoded = encodeRFC5987(extendedName || sanitized);\n\n // filename= is the ASCII fallback for old browsers, filename*= the UTF-8 form for modern ones.\n return `${type}; filename=\"${sanitized}\"; filename*=UTF-8''${encoded}`;\n};\n\n/**\n * Reads a filename out of a `Content-Disposition` value.\n *\n * Three forms, in the order the RFC gives them precedence: `filename*=UTF-8''...` (percent-encoded,\n * and the one hand-rolled parsers miss), a quoted `filename=\"...\"`, and a bare `filename=...`.\n * Splitting on `filename=` alone returns the percent-encoded bytes for any non-ASCII name, which in\n * a product with non-English filenames is most of them.\n *\n * The pair of {@link createContentDispositionHeader}: one writes the header, this one reads it.\n */\nexport const parseContentDisposition = (opts: {\n header: string | null | undefined;\n}): { type?: string; filename?: string } => {\n const { header } = opts;\n\n if (!header) {\n return {};\n }\n\n const type = header.split(';')[0]?.trim() || undefined;\n\n // `filename*` wins when both are present - it is the one that can carry a non-ASCII name.\n const extended = header.match(/filename\\*\\s*=\\s*([^;]+)/i);\n if (extended) {\n const value = extended[1].trim();\n // `UTF-8''name` or `UTF-8'lang'name`; anything before the last quote is charset and language.\n const encoded = value.slice(value.lastIndexOf(\"'\") + 1);\n\n try {\n return { type, filename: decodeURIComponent(encoded) };\n } catch {\n // A malformed sequence is not worth failing a download over - fall through to `filename`.\n }\n }\n\n const quoted = header.match(/filename\\s*=\\s*\"([^\"]*)\"/i);\n if (quoted) {\n return { type, filename: quoted[1] };\n }\n\n const bare = header.match(/filename\\s*=\\s*([^;]+)/i);\n return { type, filename: bare ? bare[1].trim() : undefined };\n};\n"]}
@@ -1,4 +1,4 @@
1
1
  export const sleep = (ms) => {
2
- return new Promise(resolve => setTimeout(resolve, ms));
2
+ return new Promise((resolve) => setTimeout(resolve, ms));
3
3
  };
4
4
  //# sourceMappingURL=sleep.utility.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"sleep.utility.js","sourceRoot":"","sources":["../../../src/utilities/sleep.utility.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE;IAClC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC","sourcesContent":["export const sleep = (ms: number) => {\n return new Promise(resolve => setTimeout(resolve, ms));\n};\n"]}
1
+ {"version":3,"file":"sleep.utility.js","sourceRoot":"","sources":["../../../src/utilities/sleep.utility.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC,CAAC","sourcesContent":["export const sleep = (ms: number) => {\n return new Promise((resolve) => setTimeout(resolve, ms));\n};\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@venizia/ignis-helpers",
3
- "version": "0.4.0",
3
+ "version": "0.4.1",
4
4
  "description": "Production-ready TypeScript utility library: pluggable logging (winston or pino behind one ILogger contract), Redis single/cluster/sentinel with pub/sub, BullMQ/MQTT/Kafka message queues, MinIO/Disk/Bun-S3 object storage, AES-256/RSA/ECDH cryptography, Snowflake UID generation, cron scheduling, Socket.IO/WebSocket, TCP/TLS/UDP networking, HTTP clients, secrets/Vault, worker thread pools, and environment management. Sub-path imports isolate optional peer dependencies so the root barrel never forces a peer into your bundle.",
5
5
  "keywords": [
6
6
  "aes",
@@ -137,6 +137,12 @@
137
137
  "require": "./dist/cjs/modules/socket/socket-io/index.js",
138
138
  "default": "./dist/cjs/modules/socket/socket-io/index.js"
139
139
  },
140
+ "./socket-io/client": {
141
+ "types": "./dist/cjs/modules/socket/socket-io/browser.d.ts",
142
+ "import": "./dist/esm/modules/socket/socket-io/browser.js",
143
+ "require": "./dist/cjs/modules/socket/socket-io/browser.js",
144
+ "default": "./dist/cjs/modules/socket/socket-io/browser.js"
145
+ },
140
146
  "./bullmq": {
141
147
  "types": "./dist/cjs/modules/queue/bullmq/index.d.ts",
142
148
  "import": "./dist/esm/modules/queue/bullmq/index.js",
@@ -209,11 +215,11 @@
209
215
  "access": "public"
210
216
  },
211
217
  "scripts": {
212
- "force-update": "sh ../../scripts/force-update.sh",
218
+ "force-update": "sh ../../scripts/build/force-update.sh",
213
219
  "prepublishOnly": "make rebuild"
214
220
  },
215
221
  "dependencies": {
216
- "@venizia/ignis-inversion": "0.4.0",
222
+ "@venizia/ignis-inversion": "0.4.1",
217
223
  "reflect-metadata": "^0.2.2",
218
224
  "zod": "^4.6.7"
219
225
  },
@@ -225,7 +231,7 @@
225
231
  "@socket.io/redis-emitter": "^5.1.0",
226
232
  "@types/bun": "^1.4.3",
227
233
  "@types/luxon": "^3.7.6",
228
- "@venizia/dev-configs": "0.4.0",
234
+ "@venizia/dev-configs": "0.4.1",
229
235
  "axios": "^1.20.0",
230
236
  "bullmq": "^6.4.0",
231
237
  "cron": "^4.4.0",