@venizia/ignis-helpers 0.4.8-0 → 0.4.8-2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (332) hide show
  1. package/README.md +1 -0
  2. package/dist/esm/common/constants/app.d.ts +15 -0
  3. package/dist/esm/common/constants/app.js +14 -0
  4. package/dist/esm/common/constants/app.js.map +1 -1
  5. package/dist/esm/common/constants/duration.d.ts +2 -0
  6. package/dist/esm/common/constants/duration.js.map +1 -1
  7. package/dist/esm/common/constants/grpc.d.ts +3 -0
  8. package/dist/esm/common/constants/grpc.js +1 -0
  9. package/dist/esm/common/constants/grpc.js.map +1 -1
  10. package/dist/esm/common/constants/http.d.ts +4 -0
  11. package/dist/esm/common/constants/http.js +1 -0
  12. package/dist/esm/common/constants/http.js.map +1 -1
  13. package/dist/esm/common/constants/mime.d.ts +4 -0
  14. package/dist/esm/common/constants/mime.js +1 -0
  15. package/dist/esm/common/constants/mime.js.map +1 -1
  16. package/dist/esm/common/redact.d.ts +2 -0
  17. package/dist/esm/common/redact.js +2 -0
  18. package/dist/esm/common/redact.js.map +1 -1
  19. package/dist/esm/common/resolvers.d.ts +1 -0
  20. package/dist/esm/common/resolvers.js +1 -0
  21. package/dist/esm/common/resolvers.js.map +1 -1
  22. package/dist/esm/common/types/class.d.ts +6 -0
  23. package/dist/esm/common/types/class.js.map +1 -1
  24. package/dist/esm/common/types/const-value.d.ts +3 -0
  25. package/dist/esm/common/types/const-value.js.map +1 -1
  26. package/dist/esm/common/types/field-mapping.d.ts +3 -0
  27. package/dist/esm/common/types/field-mapping.js.map +1 -1
  28. package/dist/esm/common/types/injection.d.ts +2 -0
  29. package/dist/esm/common/types/injection.js.map +1 -1
  30. package/dist/esm/common/types/utility.d.ts +9 -0
  31. package/dist/esm/common/types/utility.js.map +1 -1
  32. package/dist/esm/modules/base.d.ts +1 -0
  33. package/dist/esm/modules/base.js +1 -0
  34. package/dist/esm/modules/base.js.map +1 -1
  35. package/dist/esm/modules/cron/helper.d.ts +7 -0
  36. package/dist/esm/modules/cron/helper.js +1 -0
  37. package/dist/esm/modules/cron/helper.js.map +1 -1
  38. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts +2 -0
  39. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  40. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts +1 -0
  41. package/dist/esm/modules/crypto/algorithms/base.algorithm.js +1 -0
  42. package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
  43. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts +12 -4
  44. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js +4 -4
  45. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js.map +1 -1
  46. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts +3 -0
  47. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.js.map +1 -1
  48. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts +1 -0
  49. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.js.map +1 -1
  50. package/dist/esm/modules/crypto/common/constants.d.ts +12 -1
  51. package/dist/esm/modules/crypto/common/constants.js +9 -1
  52. package/dist/esm/modules/crypto/common/constants.js.map +1 -1
  53. package/dist/esm/modules/crypto/common/types.d.ts +1 -0
  54. package/dist/esm/modules/crypto/common/types.js.map +1 -1
  55. package/dist/esm/modules/env/app-env.d.ts +3 -0
  56. package/dist/esm/modules/env/app-env.js +3 -0
  57. package/dist/esm/modules/env/app-env.js.map +1 -1
  58. package/dist/esm/modules/env/common/types.d.ts +1 -0
  59. package/dist/esm/modules/env/common/types.js.map +1 -1
  60. package/dist/esm/modules/logger/common/constants.d.ts +3 -0
  61. package/dist/esm/modules/logger/common/constants.js +2 -0
  62. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  63. package/dist/esm/modules/logger/common/types.d.ts +2 -0
  64. package/dist/esm/modules/logger/common/types.js +1 -0
  65. package/dist/esm/modules/logger/common/types.js.map +1 -1
  66. package/dist/esm/modules/logger/formatting/deep-splat.d.ts +1 -0
  67. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -0
  68. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  69. package/dist/esm/modules/logger/hf/common/types.d.ts +7 -2
  70. package/dist/esm/modules/logger/hf/common/types.js.map +1 -1
  71. package/dist/esm/modules/logger/winston/common/types.d.ts +31 -3
  72. package/dist/esm/modules/logger/winston/common/types.js.map +1 -1
  73. package/dist/esm/modules/logger/winston/define.d.ts +1 -0
  74. package/dist/esm/modules/logger/winston/define.js +1 -0
  75. package/dist/esm/modules/logger/winston/define.js.map +1 -1
  76. package/dist/esm/modules/logger/winston/logger.d.ts +1 -0
  77. package/dist/esm/modules/logger/winston/logger.js +1 -0
  78. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  79. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -0
  80. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -0
  81. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  82. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts +1 -0
  83. package/dist/esm/modules/network/http-request/base-network-request.helper.js +1 -0
  84. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  85. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +8 -8
  86. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +2 -0
  87. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  88. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +2 -0
  89. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  90. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +5 -1
  91. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +2 -0
  92. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  93. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts +11 -0
  94. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -0
  95. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  96. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts +3 -0
  97. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +1 -0
  98. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  99. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts +1 -0
  100. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js +1 -0
  101. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js.map +1 -1
  102. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts +1 -0
  103. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js +1 -0
  104. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js.map +1 -1
  105. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts +1 -0
  106. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js +1 -0
  107. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js.map +1 -1
  108. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts +1 -0
  109. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js +1 -0
  110. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js.map +1 -1
  111. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts +4 -0
  112. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +4 -0
  113. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  114. package/dist/esm/modules/network/utilities/query-string.d.ts +13 -2
  115. package/dist/esm/modules/network/utilities/query-string.js +2 -1
  116. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  117. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +2 -1
  118. package/dist/esm/modules/network/utilities/url-safety/common/constants.js +1 -1
  119. package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
  120. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts +18 -5
  121. package/dist/esm/modules/network/utilities/url-safety/common/types.js.map +1 -1
  122. package/dist/esm/modules/pool/common/types.d.ts +5 -1
  123. package/dist/esm/modules/pool/common/types.js.map +1 -1
  124. package/dist/esm/modules/queue/bullmq/helper.d.ts +13 -0
  125. package/dist/esm/modules/queue/bullmq/helper.js +4 -0
  126. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  127. package/dist/esm/modules/queue/common/hook.d.ts +1 -0
  128. package/dist/esm/modules/queue/common/hook.js +1 -0
  129. package/dist/esm/modules/queue/common/hook.js.map +1 -1
  130. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +8 -0
  131. package/dist/esm/modules/queue/internal/sequential/common/types.js +1 -0
  132. package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
  133. package/dist/esm/modules/queue/internal/sequential/helper.d.ts +4 -0
  134. package/dist/esm/modules/queue/internal/sequential/helper.js +4 -0
  135. package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
  136. package/dist/esm/modules/queue/kafka/base.d.ts +5 -0
  137. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  138. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts +3 -0
  139. package/dist/esm/modules/queue/kafka/bundler/common/constants.js +3 -0
  140. package/dist/esm/modules/queue/kafka/bundler/common/constants.js.map +1 -1
  141. package/dist/esm/modules/queue/kafka/common/constants.d.ts +8 -0
  142. package/dist/esm/modules/queue/kafka/common/constants.js +5 -0
  143. package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
  144. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts +1 -0
  145. package/dist/esm/modules/queue/kafka/common/types/admin.js.map +1 -1
  146. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts +12 -0
  147. package/dist/esm/modules/queue/kafka/common/types/callbacks.js.map +1 -1
  148. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts +2 -0
  149. package/dist/esm/modules/queue/kafka/common/types/connection.js.map +1 -1
  150. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts +62 -0
  151. package/dist/esm/modules/queue/kafka/common/types/consumer.js.map +1 -1
  152. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts +1 -0
  153. package/dist/esm/modules/queue/kafka/common/types/producer.js.map +1 -1
  154. package/dist/esm/modules/queue/mqtt/helper.d.ts +2 -0
  155. package/dist/esm/modules/queue/mqtt/helper.js +1 -0
  156. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  157. package/dist/esm/modules/redis/base/abstract.helper.d.ts +2 -0
  158. package/dist/esm/modules/redis/base/abstract.helper.js +2 -0
  159. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  160. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -0
  161. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -0
  162. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  163. package/dist/esm/modules/redis/common/constants.d.ts +4 -0
  164. package/dist/esm/modules/redis/common/constants.js +2 -0
  165. package/dist/esm/modules/redis/common/constants.js.map +1 -1
  166. package/dist/esm/modules/redis/common/interfaces.d.ts +12 -0
  167. package/dist/esm/modules/redis/common/interfaces.js.map +1 -1
  168. package/dist/esm/modules/redis/common/types.d.ts +21 -1
  169. package/dist/esm/modules/redis/common/types.js.map +1 -1
  170. package/dist/esm/modules/redis/factory.d.ts +2 -0
  171. package/dist/esm/modules/redis/factory.js +1 -0
  172. package/dist/esm/modules/redis/factory.js.map +1 -1
  173. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -0
  174. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -0
  175. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  176. package/dist/esm/modules/redis/single/single.helper.d.ts +1 -0
  177. package/dist/esm/modules/redis/single/single.helper.js +1 -0
  178. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  179. package/dist/esm/modules/redis/utility.d.ts +1 -0
  180. package/dist/esm/modules/redis/utility.js +1 -0
  181. package/dist/esm/modules/redis/utility.js.map +1 -1
  182. package/dist/esm/modules/retry/common/constants.d.ts +4 -0
  183. package/dist/esm/modules/retry/common/constants.js +2 -0
  184. package/dist/esm/modules/retry/common/constants.js.map +1 -1
  185. package/dist/esm/modules/retry/common/types.d.ts +19 -5
  186. package/dist/esm/modules/retry/common/types.js.map +1 -1
  187. package/dist/esm/modules/retry/helper.d.ts +4 -4
  188. package/dist/esm/modules/retry/helper.js.map +1 -1
  189. package/dist/esm/modules/secrets/base/abstract.helper.d.ts +1 -0
  190. package/dist/esm/modules/secrets/base/abstract.helper.js +1 -0
  191. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  192. package/dist/esm/modules/secrets/common/constants.d.ts +4 -0
  193. package/dist/esm/modules/secrets/common/constants.js +2 -0
  194. package/dist/esm/modules/secrets/common/constants.js.map +1 -1
  195. package/dist/esm/modules/secrets/common/types/helper.d.ts +13 -0
  196. package/dist/esm/modules/secrets/common/types/helper.js.map +1 -1
  197. package/dist/esm/modules/secrets/common/types/lease.d.ts +2 -0
  198. package/dist/esm/modules/secrets/common/types/lease.js.map +1 -1
  199. package/dist/esm/modules/secrets/common/types/registration.d.ts +13 -2
  200. package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
  201. package/dist/esm/modules/secrets/common/types/timer.d.ts +1 -0
  202. package/dist/esm/modules/secrets/common/types/timer.js.map +1 -1
  203. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts +8 -0
  204. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -0
  205. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  206. package/dist/esm/modules/secrets/factory.d.ts +1 -0
  207. package/dist/esm/modules/secrets/factory.js +1 -0
  208. package/dist/esm/modules/secrets/factory.js.map +1 -1
  209. package/dist/esm/modules/secrets/hashicorp/auth.d.ts +2 -0
  210. package/dist/esm/modules/secrets/hashicorp/auth.js +1 -0
  211. package/dist/esm/modules/secrets/hashicorp/auth.js.map +1 -1
  212. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +2 -0
  213. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +1 -0
  214. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  215. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts +1 -0
  216. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js +1 -0
  217. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js.map +1 -1
  218. package/dist/esm/modules/slug/common/constants.d.ts +1 -0
  219. package/dist/esm/modules/slug/common/constants.js +1 -0
  220. package/dist/esm/modules/slug/common/constants.js.map +1 -1
  221. package/dist/esm/modules/socket/socket-io/common/constants.d.ts +2 -0
  222. package/dist/esm/modules/socket/socket-io/common/constants.js +2 -0
  223. package/dist/esm/modules/socket/socket-io/common/constants.js.map +1 -1
  224. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +5 -0
  225. package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
  226. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts +4 -0
  227. package/dist/esm/modules/socket/socket-io/common/types/hooks.js.map +1 -1
  228. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +6 -0
  229. package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
  230. package/dist/esm/modules/socket/socket-io/server/helper.d.ts +1 -0
  231. package/dist/esm/modules/socket/socket-io/server/helper.js +1 -0
  232. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  233. package/dist/esm/modules/socket/websocket/common/constants.d.ts +7 -0
  234. package/dist/esm/modules/socket/websocket/common/constants.js +5 -0
  235. package/dist/esm/modules/socket/websocket/common/constants.js.map +1 -1
  236. package/dist/esm/modules/socket/websocket/common/types/client.d.ts +4 -0
  237. package/dist/esm/modules/socket/websocket/common/types/client.js.map +1 -1
  238. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts +7 -0
  239. package/dist/esm/modules/socket/websocket/common/types/hooks.js.map +1 -1
  240. package/dist/esm/modules/socket/websocket/common/types/server.d.ts +30 -0
  241. package/dist/esm/modules/socket/websocket/common/types/server.js.map +1 -1
  242. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts +1 -0
  243. package/dist/esm/modules/socket/websocket/emitter/helper.js +1 -0
  244. package/dist/esm/modules/socket/websocket/emitter/helper.js.map +1 -1
  245. package/dist/esm/modules/socket/websocket/server/helper.d.ts +1 -0
  246. package/dist/esm/modules/socket/websocket/server/helper.js +1 -0
  247. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  248. package/dist/esm/modules/storage/base.d.ts +6 -1
  249. package/dist/esm/modules/storage/base.js +1 -0
  250. package/dist/esm/modules/storage/base.js.map +1 -1
  251. package/dist/esm/modules/storage/bun-s3/helper.d.ts +9 -1
  252. package/dist/esm/modules/storage/bun-s3/helper.js +2 -1
  253. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  254. package/dist/esm/modules/storage/common/constants.d.ts +1 -0
  255. package/dist/esm/modules/storage/common/constants.js.map +1 -1
  256. package/dist/esm/modules/storage/common/types.d.ts +17 -1
  257. package/dist/esm/modules/storage/common/types.js.map +1 -1
  258. package/dist/esm/modules/storage/common/utility.d.ts +1 -0
  259. package/dist/esm/modules/storage/common/utility.js +1 -0
  260. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  261. package/dist/esm/modules/storage/disk/helper.d.ts +2 -0
  262. package/dist/esm/modules/storage/disk/helper.js +1 -0
  263. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  264. package/dist/esm/modules/temporal/abstract.d.ts +5 -0
  265. package/dist/esm/modules/temporal/abstract.js +2 -1
  266. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  267. package/dist/esm/modules/temporal/common/constants.d.ts +3 -0
  268. package/dist/esm/modules/temporal/common/constants.js.map +1 -1
  269. package/dist/esm/modules/tree/common/types.d.ts +6 -0
  270. package/dist/esm/modules/tree/common/types.js.map +1 -1
  271. package/dist/esm/modules/uid/common/constants.d.ts +1 -0
  272. package/dist/esm/modules/uid/common/constants.js.map +1 -1
  273. package/dist/esm/modules/uid/common/types.d.ts +28 -7
  274. package/dist/esm/modules/uid/common/types.js.map +1 -1
  275. package/dist/esm/modules/uid/helper.d.ts +12 -0
  276. package/dist/esm/modules/uid/helper.js.map +1 -1
  277. package/dist/esm/modules/uid/uuid/v4.d.ts +1 -0
  278. package/dist/esm/modules/uid/uuid/v4.js +1 -0
  279. package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
  280. package/dist/esm/modules/uid/uuid/v5.d.ts +1 -0
  281. package/dist/esm/modules/uid/uuid/v5.js +1 -0
  282. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  283. package/dist/esm/modules/uid/uuid/v7.d.ts +1 -0
  284. package/dist/esm/modules/uid/uuid/v7.js +1 -0
  285. package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
  286. package/dist/esm/modules/worker-thread/bus/abstract.d.ts +1 -0
  287. package/dist/esm/modules/worker-thread/bus/abstract.js +1 -0
  288. package/dist/esm/modules/worker-thread/bus/abstract.js.map +1 -1
  289. package/dist/esm/modules/worker-thread/bus/base.d.ts +1 -0
  290. package/dist/esm/modules/worker-thread/bus/base.js +1 -0
  291. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  292. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts +1 -0
  293. package/dist/esm/modules/worker-thread/bus/handler/abstract.js +1 -0
  294. package/dist/esm/modules/worker-thread/bus/handler/abstract.js.map +1 -1
  295. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts +1 -0
  296. package/dist/esm/modules/worker-thread/bus/handler/base.js +1 -0
  297. package/dist/esm/modules/worker-thread/bus/handler/base.js.map +1 -1
  298. package/dist/esm/modules/worker-thread/common/types.d.ts +4 -0
  299. package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
  300. package/dist/esm/modules/worker-thread/thread/abstract.d.ts +1 -0
  301. package/dist/esm/modules/worker-thread/thread/abstract.js +1 -0
  302. package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
  303. package/dist/esm/modules/worker-thread/thread/base.d.ts +1 -0
  304. package/dist/esm/modules/worker-thread/thread/base.js +1 -0
  305. package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
  306. package/dist/esm/modules/worker-thread/worker/abstract.d.ts +1 -0
  307. package/dist/esm/modules/worker-thread/worker/abstract.js +1 -0
  308. package/dist/esm/modules/worker-thread/worker/abstract.js.map +1 -1
  309. package/dist/esm/modules/worker-thread/worker/base.d.ts +1 -0
  310. package/dist/esm/modules/worker-thread/worker/base.js +1 -0
  311. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  312. package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -0
  313. package/dist/esm/modules/worker-thread/worker-pool.js +1 -0
  314. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  315. package/dist/esm/utilities/error.utility.d.ts +1 -0
  316. package/dist/esm/utilities/error.utility.js +1 -0
  317. package/dist/esm/utilities/error.utility.js.map +1 -1
  318. package/dist/esm/utilities/form-body.utility.d.ts +1 -0
  319. package/dist/esm/utilities/form-body.utility.js +1 -0
  320. package/dist/esm/utilities/form-body.utility.js.map +1 -1
  321. package/dist/esm/utilities/hr-time.utility.d.ts +1 -0
  322. package/dist/esm/utilities/hr-time.utility.js +1 -0
  323. package/dist/esm/utilities/hr-time.utility.js.map +1 -1
  324. package/dist/esm/utilities/performance.utility.d.ts +1 -0
  325. package/dist/esm/utilities/performance.utility.js +1 -0
  326. package/dist/esm/utilities/performance.utility.js.map +1 -1
  327. package/dist/esm/utilities/promise.utility.d.ts +1 -0
  328. package/dist/esm/utilities/promise.utility.js.map +1 -1
  329. package/dist/esm/utilities/request.utility.d.ts +2 -0
  330. package/dist/esm/utilities/request.utility.js +1 -0
  331. package/dist/esm/utilities/request.utility.js.map +1 -1
  332. package/package.json +3 -3
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/queue/mqtt/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { ObjectUtility } from '@venizia/ignis-inversion';\nimport { RedactUtility } from '@/common/redact';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport mqtt from 'mqtt';\nimport { HookUtility } from '../common';\n\nexport interface IMQTTClientOptions {\n identifier: string;\n url: string;\n options: mqtt.IClientOptions;\n onConnect?: () => void;\n onDisconnect?: () => void;\n onError?: (error: Error) => void;\n onClose?: (error?: Error) => void;\n onMessage: (opts: { topic: string; message: Buffer }) => void;\n}\n\nexport class MQTTClientHelper extends BaseHelper {\n private url: string;\n private options: mqtt.IClientOptions;\n private client?: mqtt.MqttClient;\n\n private onConnect?: () => void;\n private onDisconnect?: () => void;\n private onError?: (error: Error) => void;\n private onClose?: (error?: Error) => void;\n private onMessage: (opts: { topic: string; message: Buffer }) => void;\n\n constructor(opts: IMQTTClientOptions) {\n super({ scope: MQTTClientHelper.name, identifier: opts.identifier });\n\n this.url = opts.url;\n this.options = opts.options;\n\n this.onConnect = opts.onConnect;\n this.onClose = opts.onClose;\n this.onError = opts.onError;\n this.onDisconnect = opts.onDisconnect;\n this.onMessage = opts.onMessage;\n\n this.configure();\n }\n\n configure() {\n if (this.client) {\n // Never serialize the client: it holds the resolved IClientOptions, password included.\n this.logger\n .for(this.configure.name)\n .info(\n '[%s] MQTT Client already established | Connected: %s',\n this.identifier,\n this.client.connected,\n );\n\n return;\n }\n\n if (ObjectUtility.isEmpty({ value: this.url })) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[configure] Invalid url to configure mqtt client!',\n });\n }\n\n this.logger\n .for(this.configure.name)\n .info(\n '[%s] Start configuring mqtt client | Url: %s | Options: %j',\n this.identifier,\n RedactUtility.redactUrlCredentials({ url: this.url }),\n RedactUtility.redactSecrets({ value: this.options }),\n );\n this.client = this.createClient({ url: this.url, options: this.options });\n\n this.client.on('connect', () => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onConnect',\n execution: () => this.onConnect?.(),\n });\n });\n\n this.client.on('disconnect', () => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onDisconnect',\n execution: () => this.onDisconnect?.(),\n });\n });\n\n this.client.on('message', (topic, message) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onMessage',\n execution: () => this.onMessage?.({ topic, message }),\n });\n });\n\n this.client.on('error', (error) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onError',\n execution: () => this.onError?.(error),\n });\n });\n\n this.client.on('close', (error?: Error) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onClose',\n execution: () => this.onClose?.(error),\n });\n });\n }\n\n /** Client factory seam - overridden in tests to run the helper without a broker. */\n protected createClient(opts: { url: string; options: mqtt.IClientOptions }): mqtt.MqttClient {\n return mqtt.connect(opts.url, opts.options);\n }\n\n getClient() {\n return this.client;\n }\n\n /** Tear the client down - without it the mqtt client, and its reconnect timer, outlives the helper forever. Resolves once the driver reports the connection ended; safe to call more than once. */\n close(opts?: { isForce?: boolean }): Promise<void> {\n const client = this.client;\n this.client = undefined;\n\n if (!client) {\n return Promise.resolve();\n }\n\n const isForce = opts?.isForce ?? false;\n\n return new Promise<void>((resolve) => {\n client.end(isForce, undefined, () => {\n this.logger.for(this.close.name).info('[%s] MQTT Client closed!', this.identifier);\n resolve();\n });\n });\n }\n\n subscribe(opts: { topics: Array<string> }) {\n const client = this.client;\n\n return new Promise((resolve, reject) => {\n if (!client?.connected) {\n return reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[subscribe][${this.identifier}] MQTT Client is not available to subscribe topic!`,\n }),\n );\n }\n\n const { topics } = opts;\n client.subscribe(topics, (error) => {\n if (error) {\n return reject(error);\n }\n\n resolve(topics);\n });\n });\n }\n\n publish(opts: { topic: string; message: string | Buffer }) {\n const client = this.client;\n\n return new Promise((resolve, reject) => {\n if (!client?.connected) {\n return reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[publish][${this.identifier}] MQTT Client is not available to publish message!`,\n }),\n );\n }\n\n const { topic, message } = opts;\n client.publish(topic, message, (error) => {\n if (error) {\n return reject(error);\n }\n\n resolve({ topic, message });\n });\n });\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/queue/mqtt/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { ObjectUtility } from '@venizia/ignis-inversion';\nimport { RedactUtility } from '@/common/redact';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport mqtt from 'mqtt';\nimport { HookUtility } from '../common';\n\n/** Options for {@link MQTTClientHelper}. `onMessage` is required; `options` go to the `mqtt` client as-is. */\nexport interface IMQTTClientOptions {\n identifier: string;\n url: string;\n options: mqtt.IClientOptions;\n onConnect?: () => void;\n onDisconnect?: () => void;\n onError?: (error: Error) => void;\n onClose?: (error?: Error) => void;\n onMessage: (opts: { topic: string; message: Buffer }) => void;\n}\n\n/** MQTT client that connects to `url` on construction and forwards messages to `onMessage`. */\nexport class MQTTClientHelper extends BaseHelper {\n private url: string;\n private options: mqtt.IClientOptions;\n private client?: mqtt.MqttClient;\n\n private onConnect?: () => void;\n private onDisconnect?: () => void;\n private onError?: (error: Error) => void;\n private onClose?: (error?: Error) => void;\n private onMessage: (opts: { topic: string; message: Buffer }) => void;\n\n constructor(opts: IMQTTClientOptions) {\n super({ scope: MQTTClientHelper.name, identifier: opts.identifier });\n\n this.url = opts.url;\n this.options = opts.options;\n\n this.onConnect = opts.onConnect;\n this.onClose = opts.onClose;\n this.onError = opts.onError;\n this.onDisconnect = opts.onDisconnect;\n this.onMessage = opts.onMessage;\n\n this.configure();\n }\n\n configure() {\n if (this.client) {\n // Never serialize the client: it holds the resolved IClientOptions, password included.\n this.logger\n .for(this.configure.name)\n .info(\n '[%s] MQTT Client already established | Connected: %s',\n this.identifier,\n this.client.connected,\n );\n\n return;\n }\n\n if (ObjectUtility.isEmpty({ value: this.url })) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[configure] Invalid url to configure mqtt client!',\n });\n }\n\n this.logger\n .for(this.configure.name)\n .info(\n '[%s] Start configuring mqtt client | Url: %s | Options: %j',\n this.identifier,\n RedactUtility.redactUrlCredentials({ url: this.url }),\n RedactUtility.redactSecrets({ value: this.options }),\n );\n this.client = this.createClient({ url: this.url, options: this.options });\n\n this.client.on('connect', () => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onConnect',\n execution: () => this.onConnect?.(),\n });\n });\n\n this.client.on('disconnect', () => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onDisconnect',\n execution: () => this.onDisconnect?.(),\n });\n });\n\n this.client.on('message', (topic, message) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onMessage',\n execution: () => this.onMessage?.({ topic, message }),\n });\n });\n\n this.client.on('error', (error) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onError',\n execution: () => this.onError?.(error),\n });\n });\n\n this.client.on('close', (error?: Error) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onClose',\n execution: () => this.onClose?.(error),\n });\n });\n }\n\n /** Client factory seam - overridden in tests to run the helper without a broker. */\n protected createClient(opts: { url: string; options: mqtt.IClientOptions }): mqtt.MqttClient {\n return mqtt.connect(opts.url, opts.options);\n }\n\n getClient() {\n return this.client;\n }\n\n /** Tear the client down - without it the mqtt client, and its reconnect timer, outlives the helper forever. Resolves once the driver reports the connection ended; safe to call more than once. */\n close(opts?: { isForce?: boolean }): Promise<void> {\n const client = this.client;\n this.client = undefined;\n\n if (!client) {\n return Promise.resolve();\n }\n\n const isForce = opts?.isForce ?? false;\n\n return new Promise<void>((resolve) => {\n client.end(isForce, undefined, () => {\n this.logger.for(this.close.name).info('[%s] MQTT Client closed!', this.identifier);\n resolve();\n });\n });\n }\n\n subscribe(opts: { topics: Array<string> }) {\n const client = this.client;\n\n return new Promise((resolve, reject) => {\n if (!client?.connected) {\n return reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[subscribe][${this.identifier}] MQTT Client is not available to subscribe topic!`,\n }),\n );\n }\n\n const { topics } = opts;\n client.subscribe(topics, (error) => {\n if (error) {\n return reject(error);\n }\n\n resolve(topics);\n });\n });\n }\n\n publish(opts: { topic: string; message: string | Buffer }) {\n const client = this.client;\n\n return new Promise((resolve, reject) => {\n if (!client?.connected) {\n return reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[publish][${this.identifier}] MQTT Client is not available to publish message!`,\n }),\n );\n }\n\n const { topic, message } = opts;\n client.publish(topic, message, (error) => {\n if (error) {\n return reject(error);\n }\n\n resolve({ topic, message });\n });\n });\n }\n}\n"]}
@@ -1,9 +1,11 @@
1
1
  import { BaseHelper } from '../../base.js';
2
2
  import { type IRedisHelper } from './../common/interfaces.js';
3
3
  import { type IRedisHelperCallbacks, type TRedisClient } from './../common/types.js';
4
+ /** Registry symbol that marks an instance as a Redis helper; `isRedisHelper` tests for it. */
4
5
  export declare const REDIS_HELPER_BRAND: unique symbol;
5
6
  /** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */
6
7
  export declare const isRedisHelper: (value: unknown) => value is AbstractRedisHelper;
8
+ /** Base for the Redis helpers: wraps one ioredis client, logs its lifecycle events and forwards them to the `onInitialized`, `onConnected`, `onReady` and `onError` callbacks. Subclasses build the client. */
7
9
  export declare class AbstractRedisHelper<ClientType extends TRedisClient = TRedisClient> extends BaseHelper implements IRedisHelper {
8
10
  /** Read by {@link isRedisHelper}. On the instance, so every subclass instance carries it. */
9
11
  readonly [REDIS_HELPER_BRAND] = true;
@@ -4,11 +4,13 @@ import { PromiseUtility } from '../../../utilities/promise.utility.js';
4
4
  import { BaseHelper } from '../../base.js';
5
5
  import zlib from 'node:zlib';
6
6
  import { RedisConcurrency } from './../common/constants.js';
7
+ /** Registry symbol that marks an instance as a Redis helper; `isRedisHelper` tests for it. */
7
8
  export const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');
8
9
  /** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */
9
10
  export const isRedisHelper = (value) => {
10
11
  return typeof value === 'object' && value !== null && REDIS_HELPER_BRAND in value;
11
12
  };
13
+ /** Base for the Redis helpers: wraps one ioredis client, logs its lifecycle events and forwards them to the `onInitialized`, `onConnected`, `onReady` and `onError` callbacks. Subclasses build the client. */
12
14
  export class AbstractRedisHelper extends BaseHelper {
13
15
  static { _a = REDIS_HELPER_BRAND; }
14
16
  constructor(opts) {
@@ -1 +1 @@
1
- {"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport type { AnyType } from '@/common/types';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { type EventEmitter } from 'node:events';\nimport zlib from 'node:zlib';\nimport { RedisConcurrency } from './../common/constants';\nimport { type IRedisHelper } from './../common/interfaces';\nimport { type IRedisHelperCallbacks, type TRedisClient } from './../common/types';\n\nexport const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');\n\n/** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */\nexport const isRedisHelper = (value: unknown): value is AbstractRedisHelper => {\n return typeof value === 'object' && value !== null && REDIS_HELPER_BRAND in value;\n};\n\nexport class AbstractRedisHelper<ClientType extends TRedisClient = TRedisClient>\n extends BaseHelper\n implements IRedisHelper\n{\n /** Read by {@link isRedisHelper}. On the instance, so every subclass instance carries it. */\n readonly [REDIS_HELPER_BRAND] = true;\n\n client: ClientType;\n readonly name: string;\n\n constructor(\n opts: { scope: string; identifier: string; client: ClientType } & IRedisHelperCallbacks,\n ) {\n super({ scope: opts.scope, identifier: opts.identifier });\n\n this.name = opts.identifier;\n this.client = opts.client;\n\n const { onInitialized, onConnected, onReady, onError } = opts;\n const emitter = this.client as EventEmitter;\n\n emitter.on('connect', () => {\n this.logger.for('connect').info('Redis CONNECTED | Name: %s', this.name);\n onConnected?.({ name: this.name, helper: this });\n });\n\n emitter.on('ready', () => {\n this.logger.for('ready').info('Redis READY | Name: %s', this.name);\n onReady?.({ name: this.name, helper: this });\n });\n\n emitter.on('error', (error: Error) => {\n this.logger.for('error').error('Redis ERROR | Name: %s | Error: %s', this.name, error);\n onError?.({ name: this.name, helper: this, error });\n });\n\n emitter.on('reconnecting', () => {\n this.logger.for('reconnecting').warn('Redis client RECONNECTING | Name: %s', this.name);\n });\n\n onInitialized?.({ name: this.name, helper: this });\n }\n\n protected static buildRetryStrategy(opts: { maxRetry: number }) {\n const { maxRetry } = opts;\n\n return (attemptCounter: number) => {\n if (maxRetry > -1 && attemptCounter > maxRetry) {\n return undefined;\n }\n\n return Math.max(Math.min(attemptCounter * 2000, 5000), 1000);\n };\n }\n\n protected static buildDefaultOpts(opts: { maxRetry: number }) {\n return {\n showFriendlyErrorStack: true,\n maxRetriesPerRequest: null,\n retryStrategy: AbstractRedisHelper.buildRetryStrategy({ maxRetry: opts.maxRetry }),\n };\n }\n\n // --- Connection lifecycle (IRedisConnection) ---\n\n getClient() {\n return this.client;\n }\n\n duplicateClient(): TRedisClient {\n // ioredis 6 types `duplicate` per client; the `Redis | Cluster` union has no callable signature.\n const duplicable: { duplicate: () => TRedisClient } = this.client;\n\n return duplicable.duplicate();\n }\n\n ping() {\n return this.client.ping();\n }\n\n connect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = [\n 'ready',\n 'reconnecting',\n 'connecting',\n ];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.connect.name)\n .info('status: %s | Invalid redis status to invoke connect', this.client.status);\n\n resolve(false);\n\n return;\n }\n\n this.client\n .connect()\n .then(() => {\n resolve(this.client.status === 'ready');\n })\n .catch(reject);\n });\n }\n\n disconnect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = ['end', 'close'];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.disconnect.name)\n .info('status: %s | Invalid redis status to invoke disconnect', this.client.status);\n resolve(false);\n\n return;\n }\n\n this.client\n .quit()\n .then((rs) => {\n resolve(rs === 'OK');\n })\n .catch(reject);\n });\n }\n\n // --- Key lifecycle + counters (IRedisKey) ---\n\n exists(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.exists(...keys);\n }\n\n async expire(opts: { key: string; seconds: number }): Promise<boolean> {\n const { key, seconds } = opts;\n const result = await this.client.expire(key, seconds);\n\n return result === 1;\n }\n\n async expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean> {\n const { key, atEpochSeconds } = opts;\n const result = await this.client.expireat(key, atEpochSeconds);\n\n return result === 1;\n }\n\n ttl(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.ttl(key);\n }\n\n async persist(opts: { key: string }): Promise<boolean> {\n const { key } = opts;\n const result = await this.client.persist(key);\n\n return result === 1;\n }\n\n incr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.incr(key);\n }\n\n decr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.decr(key);\n }\n\n incrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.incrby(key, value);\n }\n\n decrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.decrby(key, value);\n }\n\n // --- Key-value (IRedisKeyValue) ---\n\n async set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void> {\n const { key, value, options } = opts;\n\n const serialized = JSON.stringify(value);\n\n if (typeof options?.expiresIn === 'number' && options.expiresIn > 0) {\n await this.client.set(key, serialized, 'PX', options.expiresIn);\n } else {\n await this.client.set(key, serialized);\n }\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.set.name).info('Set key: %s | value: %s', key, serialized);\n }\n\n async get<T = string>(opts: {\n key: string;\n transform?: (input: string) => T;\n }): Promise<T | null> {\n const { key, transform } = opts;\n\n const value = await this.client.get(key);\n\n if (!value) {\n return null;\n }\n\n return transform ? transform(value) : (value as AnyType);\n }\n\n del(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.del(keys);\n }\n\n getString(opts: { key: string }) {\n return this.get(opts);\n }\n\n getStrings(opts: { keys: Array<string> }) {\n return this.mGet(opts);\n }\n\n getObject<T>(opts: { key: string }) {\n return this.get<T>({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n getObjects(opts: { keys: Array<string> }) {\n return this.mGet({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n async mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void> {\n const { payload, options } = opts;\n\n if (!payload.length) {\n return;\n }\n\n // A plain loop, not spread-in-reduce: `{ ...current, [key]: v }` copies every key already\n // accumulated on EVERY element, which is O(n^2). Measured at 10k keys: 2.2s of blocked event\n // loop, against 1.5ms for this.\n const serialized: Record<string, string> = {};\n\n for (const { key, value } of payload) {\n serialized[key] = JSON.stringify(value);\n }\n\n await this.client.mset(serialized);\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.mSet.name).info('Payload: %j', serialized);\n }\n\n async mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]> {\n const { keys, transform } = opts;\n\n if (!keys.length) {\n return [];\n }\n\n const values = await this.client.mget(keys);\n\n if (!values?.length) {\n return [];\n }\n\n return values.map((el) => (el ? (transform ? transform(el) : (el as AnyType)) : null));\n }\n\n keys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.keys(key);\n }\n\n // --- Hash operations (IRedisHash) ---\n\n async hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number> {\n const { key, value, options } = opts;\n const result = await this.client.hset(key, value as Record<string, string | number | Buffer>);\n\n if (!options?.log) {\n return result;\n }\n\n this.logger.for(this.hSet.name).info('Result: %j', result);\n\n return result;\n }\n\n async hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }) {\n const { key, transform } = opts;\n const value = await this.client.hgetall(key);\n\n if (!transform || !value) {\n return value;\n }\n\n return transform(value);\n }\n\n hGet(opts: { key: string; field: string }): Promise<string | null> {\n const { key, field } = opts;\n\n return this.client.hget(key, field);\n }\n\n hDel(opts: { key: string; fields: Array<string> }): Promise<number> {\n const { key, fields } = opts;\n\n if (!fields.length) {\n return Promise.resolve(0);\n }\n\n return this.client.hdel(key, ...fields);\n }\n\n async hExists(opts: { key: string; field: string }): Promise<boolean> {\n const { key, field } = opts;\n const result = await this.client.hexists(key, field);\n\n return result === 1;\n }\n\n hKeys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hkeys(key);\n }\n\n hVals(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hvals(key);\n }\n\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number> {\n const { key, field, value } = opts;\n\n return this.client.hincrby(key, field, value);\n }\n\n hLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.hlen(key);\n }\n\n // --- Set operations (IRedisSet) ---\n\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.sadd(key, ...members);\n }\n\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.srem(key, ...members);\n }\n\n sMembers(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.smembers(key);\n }\n\n async sIsMember(opts: { key: string; member: string | number }): Promise<boolean> {\n const { key, member } = opts;\n const result = await this.client.sismember(key, member);\n\n return result === 1;\n }\n\n sCard(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.scard(key);\n }\n\n // --- List operations (IRedisList) ---\n\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.lpush(key, ...values);\n }\n\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.rpush(key, ...values);\n }\n\n lPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.lpop(key);\n }\n\n rPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.rpop(key);\n }\n\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]> {\n const { key, start, stop } = opts;\n\n return this.client.lrange(key, start, stop);\n }\n\n lLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.llen(key);\n }\n\n // --- RedisJSON (IRedisJson) ---\n\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.SET', [key, path, JSON.stringify(value)]);\n }\n\n jGet<T>(opts: { key: string; path?: string }): Promise<T | null> {\n const { key, path = '$' } = opts;\n\n return this.execute<T | null>('JSON.GET', [key, path]);\n }\n\n jDelete(opts: { key: string; path?: string }): Promise<number> {\n const { key, path = '$' } = opts;\n\n return this.execute<number>('JSON.DEL', [key, path]);\n }\n\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.NUMINCRBY', [key, path, value]);\n }\n\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.STRAPPEND', [key, path, value]);\n }\n\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.ARRAPPEND', [key, path, JSON.stringify(value)]);\n }\n\n jPop<T>(opts: { key: string; path: string }): Promise<T | null> {\n const { key, path } = opts;\n\n return this.execute<T | null>('JSON.ARRPOP', [key, path]);\n }\n\n // --- Raw command (IRedisCommand) ---\n\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R> {\n if (!parameters?.length) {\n return this.client.call(command) as Promise<R>;\n }\n\n return this.client.call(command, parameters) as Promise<R>;\n }\n\n // --- Pub/Sub (IRedisPubSub) ---\n\n async publish<T>(opts: {\n topics: Array<string>;\n payload: T;\n useCompress?: boolean;\n }): Promise<void> {\n const logger = this.logger.for(this.publish.name);\n const { topics, payload, useCompress = false } = opts;\n\n const validTopics = topics?.filter((topic) => !ObjectUtility.isEmpty({ value: topic }));\n\n if (!validTopics?.length) {\n logger.error('No topic(s) to publish!');\n\n return;\n }\n\n if (!payload) {\n logger.error('Invalid payload to publish!');\n\n return;\n }\n\n const message = Buffer.from(JSON.stringify(payload));\n const packet = useCompress ? zlib.deflateSync(message) : message;\n\n // `topics` is caller-supplied, so an unbounded fan-out here is a caller-sized burst on one connection.\n await PromiseUtility.executeWithLimit({\n limit: RedisConcurrency.PUBLISH_LIMIT,\n tasks: validTopics.map((topic) => () => this.client.publish(topic, packet)),\n });\n }\n\n subscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.subscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to subscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.subscribe.name,\n execution: this.client.subscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to subscribe to topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Subscribed to %s channel(s). Listening to channel: %s', count, topic);\n }),\n });\n }\n\n unsubscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.unsubscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to unsubscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.unsubscribe.name,\n execution: this.client.unsubscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to unsubscribe from topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Unsubscribed from %s channel(s).', count);\n }),\n });\n }\n}\n"]}
1
+ {"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport type { AnyType } from '@/common/types';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { type EventEmitter } from 'node:events';\nimport zlib from 'node:zlib';\nimport { RedisConcurrency } from './../common/constants';\nimport { type IRedisHelper } from './../common/interfaces';\nimport { type IRedisHelperCallbacks, type TRedisClient } from './../common/types';\n\n/** Registry symbol that marks an instance as a Redis helper; `isRedisHelper` tests for it. */\nexport const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');\n\n/** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */\nexport const isRedisHelper = (value: unknown): value is AbstractRedisHelper => {\n return typeof value === 'object' && value !== null && REDIS_HELPER_BRAND in value;\n};\n\n/** Base for the Redis helpers: wraps one ioredis client, logs its lifecycle events and forwards them to the `onInitialized`, `onConnected`, `onReady` and `onError` callbacks. Subclasses build the client. */\nexport class AbstractRedisHelper<ClientType extends TRedisClient = TRedisClient>\n extends BaseHelper\n implements IRedisHelper\n{\n /** Read by {@link isRedisHelper}. On the instance, so every subclass instance carries it. */\n readonly [REDIS_HELPER_BRAND] = true;\n\n client: ClientType;\n readonly name: string;\n\n constructor(\n opts: { scope: string; identifier: string; client: ClientType } & IRedisHelperCallbacks,\n ) {\n super({ scope: opts.scope, identifier: opts.identifier });\n\n this.name = opts.identifier;\n this.client = opts.client;\n\n const { onInitialized, onConnected, onReady, onError } = opts;\n const emitter = this.client as EventEmitter;\n\n emitter.on('connect', () => {\n this.logger.for('connect').info('Redis CONNECTED | Name: %s', this.name);\n onConnected?.({ name: this.name, helper: this });\n });\n\n emitter.on('ready', () => {\n this.logger.for('ready').info('Redis READY | Name: %s', this.name);\n onReady?.({ name: this.name, helper: this });\n });\n\n emitter.on('error', (error: Error) => {\n this.logger.for('error').error('Redis ERROR | Name: %s | Error: %s', this.name, error);\n onError?.({ name: this.name, helper: this, error });\n });\n\n emitter.on('reconnecting', () => {\n this.logger.for('reconnecting').warn('Redis client RECONNECTING | Name: %s', this.name);\n });\n\n onInitialized?.({ name: this.name, helper: this });\n }\n\n protected static buildRetryStrategy(opts: { maxRetry: number }) {\n const { maxRetry } = opts;\n\n return (attemptCounter: number) => {\n if (maxRetry > -1 && attemptCounter > maxRetry) {\n return undefined;\n }\n\n return Math.max(Math.min(attemptCounter * 2000, 5000), 1000);\n };\n }\n\n protected static buildDefaultOpts(opts: { maxRetry: number }) {\n return {\n showFriendlyErrorStack: true,\n maxRetriesPerRequest: null,\n retryStrategy: AbstractRedisHelper.buildRetryStrategy({ maxRetry: opts.maxRetry }),\n };\n }\n\n // --- Connection lifecycle (IRedisConnection) ---\n\n getClient() {\n return this.client;\n }\n\n duplicateClient(): TRedisClient {\n // ioredis 6 types `duplicate` per client; the `Redis | Cluster` union has no callable signature.\n const duplicable: { duplicate: () => TRedisClient } = this.client;\n\n return duplicable.duplicate();\n }\n\n ping() {\n return this.client.ping();\n }\n\n connect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = [\n 'ready',\n 'reconnecting',\n 'connecting',\n ];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.connect.name)\n .info('status: %s | Invalid redis status to invoke connect', this.client.status);\n\n resolve(false);\n\n return;\n }\n\n this.client\n .connect()\n .then(() => {\n resolve(this.client.status === 'ready');\n })\n .catch(reject);\n });\n }\n\n disconnect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = ['end', 'close'];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.disconnect.name)\n .info('status: %s | Invalid redis status to invoke disconnect', this.client.status);\n resolve(false);\n\n return;\n }\n\n this.client\n .quit()\n .then((rs) => {\n resolve(rs === 'OK');\n })\n .catch(reject);\n });\n }\n\n // --- Key lifecycle + counters (IRedisKey) ---\n\n exists(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.exists(...keys);\n }\n\n async expire(opts: { key: string; seconds: number }): Promise<boolean> {\n const { key, seconds } = opts;\n const result = await this.client.expire(key, seconds);\n\n return result === 1;\n }\n\n async expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean> {\n const { key, atEpochSeconds } = opts;\n const result = await this.client.expireat(key, atEpochSeconds);\n\n return result === 1;\n }\n\n ttl(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.ttl(key);\n }\n\n async persist(opts: { key: string }): Promise<boolean> {\n const { key } = opts;\n const result = await this.client.persist(key);\n\n return result === 1;\n }\n\n incr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.incr(key);\n }\n\n decr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.decr(key);\n }\n\n incrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.incrby(key, value);\n }\n\n decrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.decrby(key, value);\n }\n\n // --- Key-value (IRedisKeyValue) ---\n\n async set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void> {\n const { key, value, options } = opts;\n\n const serialized = JSON.stringify(value);\n\n if (typeof options?.expiresIn === 'number' && options.expiresIn > 0) {\n await this.client.set(key, serialized, 'PX', options.expiresIn);\n } else {\n await this.client.set(key, serialized);\n }\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.set.name).info('Set key: %s | value: %s', key, serialized);\n }\n\n async get<T = string>(opts: {\n key: string;\n transform?: (input: string) => T;\n }): Promise<T | null> {\n const { key, transform } = opts;\n\n const value = await this.client.get(key);\n\n if (!value) {\n return null;\n }\n\n return transform ? transform(value) : (value as AnyType);\n }\n\n del(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.del(keys);\n }\n\n getString(opts: { key: string }) {\n return this.get(opts);\n }\n\n getStrings(opts: { keys: Array<string> }) {\n return this.mGet(opts);\n }\n\n getObject<T>(opts: { key: string }) {\n return this.get<T>({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n getObjects(opts: { keys: Array<string> }) {\n return this.mGet({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n async mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void> {\n const { payload, options } = opts;\n\n if (!payload.length) {\n return;\n }\n\n // A plain loop, not spread-in-reduce: `{ ...current, [key]: v }` copies every key already\n // accumulated on EVERY element, which is O(n^2). Measured at 10k keys: 2.2s of blocked event\n // loop, against 1.5ms for this.\n const serialized: Record<string, string> = {};\n\n for (const { key, value } of payload) {\n serialized[key] = JSON.stringify(value);\n }\n\n await this.client.mset(serialized);\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.mSet.name).info('Payload: %j', serialized);\n }\n\n async mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]> {\n const { keys, transform } = opts;\n\n if (!keys.length) {\n return [];\n }\n\n const values = await this.client.mget(keys);\n\n if (!values?.length) {\n return [];\n }\n\n return values.map((el) => (el ? (transform ? transform(el) : (el as AnyType)) : null));\n }\n\n keys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.keys(key);\n }\n\n // --- Hash operations (IRedisHash) ---\n\n async hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number> {\n const { key, value, options } = opts;\n const result = await this.client.hset(key, value as Record<string, string | number | Buffer>);\n\n if (!options?.log) {\n return result;\n }\n\n this.logger.for(this.hSet.name).info('Result: %j', result);\n\n return result;\n }\n\n async hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }) {\n const { key, transform } = opts;\n const value = await this.client.hgetall(key);\n\n if (!transform || !value) {\n return value;\n }\n\n return transform(value);\n }\n\n hGet(opts: { key: string; field: string }): Promise<string | null> {\n const { key, field } = opts;\n\n return this.client.hget(key, field);\n }\n\n hDel(opts: { key: string; fields: Array<string> }): Promise<number> {\n const { key, fields } = opts;\n\n if (!fields.length) {\n return Promise.resolve(0);\n }\n\n return this.client.hdel(key, ...fields);\n }\n\n async hExists(opts: { key: string; field: string }): Promise<boolean> {\n const { key, field } = opts;\n const result = await this.client.hexists(key, field);\n\n return result === 1;\n }\n\n hKeys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hkeys(key);\n }\n\n hVals(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hvals(key);\n }\n\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number> {\n const { key, field, value } = opts;\n\n return this.client.hincrby(key, field, value);\n }\n\n hLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.hlen(key);\n }\n\n // --- Set operations (IRedisSet) ---\n\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.sadd(key, ...members);\n }\n\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.srem(key, ...members);\n }\n\n sMembers(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.smembers(key);\n }\n\n async sIsMember(opts: { key: string; member: string | number }): Promise<boolean> {\n const { key, member } = opts;\n const result = await this.client.sismember(key, member);\n\n return result === 1;\n }\n\n sCard(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.scard(key);\n }\n\n // --- List operations (IRedisList) ---\n\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.lpush(key, ...values);\n }\n\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.rpush(key, ...values);\n }\n\n lPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.lpop(key);\n }\n\n rPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.rpop(key);\n }\n\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]> {\n const { key, start, stop } = opts;\n\n return this.client.lrange(key, start, stop);\n }\n\n lLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.llen(key);\n }\n\n // --- RedisJSON (IRedisJson) ---\n\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.SET', [key, path, JSON.stringify(value)]);\n }\n\n jGet<T>(opts: { key: string; path?: string }): Promise<T | null> {\n const { key, path = '$' } = opts;\n\n return this.execute<T | null>('JSON.GET', [key, path]);\n }\n\n jDelete(opts: { key: string; path?: string }): Promise<number> {\n const { key, path = '$' } = opts;\n\n return this.execute<number>('JSON.DEL', [key, path]);\n }\n\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.NUMINCRBY', [key, path, value]);\n }\n\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.STRAPPEND', [key, path, value]);\n }\n\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.ARRAPPEND', [key, path, JSON.stringify(value)]);\n }\n\n jPop<T>(opts: { key: string; path: string }): Promise<T | null> {\n const { key, path } = opts;\n\n return this.execute<T | null>('JSON.ARRPOP', [key, path]);\n }\n\n // --- Raw command (IRedisCommand) ---\n\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R> {\n if (!parameters?.length) {\n return this.client.call(command) as Promise<R>;\n }\n\n return this.client.call(command, parameters) as Promise<R>;\n }\n\n // --- Pub/Sub (IRedisPubSub) ---\n\n async publish<T>(opts: {\n topics: Array<string>;\n payload: T;\n useCompress?: boolean;\n }): Promise<void> {\n const logger = this.logger.for(this.publish.name);\n const { topics, payload, useCompress = false } = opts;\n\n const validTopics = topics?.filter((topic) => !ObjectUtility.isEmpty({ value: topic }));\n\n if (!validTopics?.length) {\n logger.error('No topic(s) to publish!');\n\n return;\n }\n\n if (!payload) {\n logger.error('Invalid payload to publish!');\n\n return;\n }\n\n const message = Buffer.from(JSON.stringify(payload));\n const packet = useCompress ? zlib.deflateSync(message) : message;\n\n // `topics` is caller-supplied, so an unbounded fan-out here is a caller-sized burst on one connection.\n await PromiseUtility.executeWithLimit({\n limit: RedisConcurrency.PUBLISH_LIMIT,\n tasks: validTopics.map((topic) => () => this.client.publish(topic, packet)),\n });\n }\n\n subscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.subscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to subscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.subscribe.name,\n execution: this.client.subscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to subscribe to topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Subscribed to %s channel(s). Listening to channel: %s', count, topic);\n }),\n });\n }\n\n unsubscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.unsubscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to unsubscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.unsubscribe.name,\n execution: this.client.unsubscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to unsubscribe from topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Unsubscribed from %s channel(s).', count);\n }),\n });\n }\n}\n"]}
@@ -1,6 +1,7 @@
1
1
  import type { Cluster } from 'ioredis';
2
2
  import { AbstractRedisHelper } from './../base/index.js';
3
3
  import { type IRedisClusterHelperOptions } from './../common/index.js';
4
+ /** Redis helper over an ioredis `Cluster`. `autoConnect: false` creates the client with `lazyConnect`; `clusterOptions` is applied last and overrides the defaults. */
4
5
  export declare class RedisClusterHelper extends AbstractRedisHelper<Cluster> {
5
6
  private startupNodes;
6
7
  private clusterOpts;
@@ -1,6 +1,7 @@
1
1
  import { ParseUtility } from '../../../utilities/index.js';
2
2
  import { ModuleUtility } from '../../../utilities/module.utility.js';
3
3
  import { AbstractRedisHelper } from './../base/index.js';
4
+ /** Redis helper over an ioredis `Cluster`. `autoConnect: false` creates the client with `lazyConnect`; `clusterOptions` is applied last and overrides the defaults. */
4
5
  export class RedisClusterHelper extends AbstractRedisHelper {
5
6
  constructor(opts) {
6
7
  const { autoConnect = true } = opts;
@@ -1 +1 @@
1
- {"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,MAAM,OAAO,kBAAmB,SAAQ,mBAA4B;IAKlE,YAAY,IAAgC;QAC1C,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9C,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC,CAAC;QAEJ,gGAAgG;QAChG,8FAA8F;QAC9F,0FAA0F;QAC1F,yFAAyF;QACzF,mFAAmF;QACnF,6FAA6F;QAC7F,MAAM,WAAW,GAAmB;YAClC,kBAAkB,EAAE,IAAI;YACxB,WAAW,EAAE,CAAC,WAAW;YACzB,GAAG,IAAI,CAAC,cAAc;SACvB,CAAC;QAEF,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,QAAQ,CAA2B,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAEzF,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,kBAAkB,CAAC,IAAI;YAC9B,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SACvD,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEQ,SAAS;QAChB,OAAO,IAAI,CAAC,MAAiB,CAAC;IAChC,CAAC;IAEQ,eAAe;QACtB,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;CACF","sourcesContent":["import { ParseUtility } from '@/utilities';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport type { Cluster, ClusterOptions } from 'ioredis';\nimport { AbstractRedisHelper } from './../base';\nimport { type IRedisClusterHelperOptions } from './../common';\n\nexport class RedisClusterHelper extends AbstractRedisHelper<Cluster> {\n private startupNodes: Array<{ host: string; port: number; password?: string }>;\n private clusterOpts: ClusterOptions;\n private ioredis: typeof import('ioredis');\n\n constructor(opts: IRedisClusterHelperOptions) {\n const { autoConnect = true } = opts;\n\n const startupNodes = opts.nodes.map((node) => ({\n host: node.host,\n port: ParseUtility.toInt({ input: node.port }),\n password: node.password,\n }));\n\n // Precedence (low -> high): the two framework defaults, then `clusterOptions` verbatim. The raw\n // hatch stays the last word, because a caller already threading `lazyConnect` through it must\n // keep the timing it has today. `enableOfflineQueue` is stated rather than inherited from\n // ioredis, so the queue a cluster needs between bind and connect cannot go missing on an\n // ioredis default change. Deliberately NOT `buildDefaultOpts`: cluster's retry and\n // per-node-failure semantics differ from single's, and folding them in here is a regression.\n const clusterOpts: ClusterOptions = {\n enableOfflineQueue: true,\n lazyConnect: !autoConnect,\n ...opts.clusterOptions,\n };\n\n const ioredis =\n opts.module ?? ModuleUtility.loadSync<typeof import('ioredis')>({ module: 'ioredis' });\n\n super({\n ...opts,\n scope: RedisClusterHelper.name,\n identifier: opts.name,\n client: new ioredis.Cluster(startupNodes, clusterOpts),\n });\n\n this.startupNodes = startupNodes;\n this.clusterOpts = clusterOpts;\n this.ioredis = ioredis;\n }\n\n override getClient() {\n return this.client as Cluster;\n }\n\n override duplicateClient(): Cluster {\n return new this.ioredis.Cluster(this.startupNodes, this.clusterOpts);\n }\n}\n"]}
1
+ {"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,uKAAuK;AACvK,MAAM,OAAO,kBAAmB,SAAQ,mBAA4B;IAKlE,YAAY,IAAgC;QAC1C,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9C,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC,CAAC;QAEJ,gGAAgG;QAChG,8FAA8F;QAC9F,0FAA0F;QAC1F,yFAAyF;QACzF,mFAAmF;QACnF,6FAA6F;QAC7F,MAAM,WAAW,GAAmB;YAClC,kBAAkB,EAAE,IAAI;YACxB,WAAW,EAAE,CAAC,WAAW;YACzB,GAAG,IAAI,CAAC,cAAc;SACvB,CAAC;QAEF,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,QAAQ,CAA2B,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAEzF,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,kBAAkB,CAAC,IAAI;YAC9B,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SACvD,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEQ,SAAS;QAChB,OAAO,IAAI,CAAC,MAAiB,CAAC;IAChC,CAAC;IAEQ,eAAe;QACtB,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;CACF","sourcesContent":["import { ParseUtility } from '@/utilities';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport type { Cluster, ClusterOptions } from 'ioredis';\nimport { AbstractRedisHelper } from './../base';\nimport { type IRedisClusterHelperOptions } from './../common';\n\n/** Redis helper over an ioredis `Cluster`. `autoConnect: false` creates the client with `lazyConnect`; `clusterOptions` is applied last and overrides the defaults. */\nexport class RedisClusterHelper extends AbstractRedisHelper<Cluster> {\n private startupNodes: Array<{ host: string; port: number; password?: string }>;\n private clusterOpts: ClusterOptions;\n private ioredis: typeof import('ioredis');\n\n constructor(opts: IRedisClusterHelperOptions) {\n const { autoConnect = true } = opts;\n\n const startupNodes = opts.nodes.map((node) => ({\n host: node.host,\n port: ParseUtility.toInt({ input: node.port }),\n password: node.password,\n }));\n\n // Precedence (low -> high): the two framework defaults, then `clusterOptions` verbatim. The raw\n // hatch stays the last word, because a caller already threading `lazyConnect` through it must\n // keep the timing it has today. `enableOfflineQueue` is stated rather than inherited from\n // ioredis, so the queue a cluster needs between bind and connect cannot go missing on an\n // ioredis default change. Deliberately NOT `buildDefaultOpts`: cluster's retry and\n // per-node-failure semantics differ from single's, and folding them in here is a regression.\n const clusterOpts: ClusterOptions = {\n enableOfflineQueue: true,\n lazyConnect: !autoConnect,\n ...opts.clusterOptions,\n };\n\n const ioredis =\n opts.module ?? ModuleUtility.loadSync<typeof import('ioredis')>({ module: 'ioredis' });\n\n super({\n ...opts,\n scope: RedisClusterHelper.name,\n identifier: opts.name,\n client: new ioredis.Cluster(startupNodes, clusterOpts),\n });\n\n this.startupNodes = startupNodes;\n this.clusterOpts = clusterOpts;\n this.ioredis = ioredis;\n }\n\n override getClient() {\n return this.client as Cluster;\n }\n\n override duplicateClient(): Cluster {\n return new this.ioredis.Cluster(this.startupNodes, this.clusterOpts);\n }\n}\n"]}
@@ -1,4 +1,5 @@
1
1
  import type { TConstValue } from '../../../common/types/index.js';
2
+ /** Deployment modes a Redis helper can be built for; selects the helper in `RedisHelperFactory.create`. */
2
3
  export declare class RedisModes {
3
4
  static readonly SINGLE = "single";
4
5
  static readonly CLUSTER = "cluster";
@@ -6,13 +7,16 @@ export declare class RedisModes {
6
7
  static readonly SCHEME_SET: Set<string>;
7
8
  static isValid(scheme: string): scheme is TRedisMode;
8
9
  }
10
+ /** Union of the `RedisModes` values. */
9
11
  export type TRedisMode = TConstValue<typeof RedisModes>;
12
+ /** Role of the node a Sentinel-backed client connects to. */
10
13
  export declare class RedisSentinelRoles {
11
14
  static readonly MASTER = "master";
12
15
  static readonly SLAVE = "slave";
13
16
  static readonly ROLE_SET: Set<string>;
14
17
  static isValid(role: string): role is TRedisSentinelRole;
15
18
  }
19
+ /** Union of the `RedisSentinelRoles` values. */
16
20
  export type TRedisSentinelRole = TConstValue<typeof RedisSentinelRoles>;
17
21
  /** Ceiling on a caller-sized fan-out over one connection; a burst larger than this queues rather than piles up. */
18
22
  export declare class RedisConcurrency {
@@ -1,3 +1,4 @@
1
+ /** Deployment modes a Redis helper can be built for; selects the helper in `RedisHelperFactory.create`. */
1
2
  export class RedisModes {
2
3
  static { this.SINGLE = 'single'; }
3
4
  static { this.CLUSTER = 'cluster'; }
@@ -7,6 +8,7 @@ export class RedisModes {
7
8
  return this.SCHEME_SET.has(scheme);
8
9
  }
9
10
  }
11
+ /** Role of the node a Sentinel-backed client connects to. */
10
12
  export class RedisSentinelRoles {
11
13
  static { this.MASTER = 'master'; }
12
14
  static { this.SLAVE = 'slave'; }
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/redis/common/constants.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAU;aACL,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aACpB,aAAQ,GAAG,UAAU,CAAC;aAEtB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjF,MAAM,CAAC,OAAO,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;;AAKH,MAAM,OAAO,kBAAkB;aACb,WAAM,GAAG,QAAQ,CAAC;aAClB,UAAK,GAAG,OAAO,CAAC;aAEhB,aAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAE9D,MAAM,CAAC,OAAO,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;;AAKH,mHAAmH;AACnH,MAAM,OAAO,gBAAgB;aACX,kBAAa,GAAG,EAAE,CAAC","sourcesContent":["import type { TConstValue } from '@/common/types';\n\nexport class RedisModes {\n static readonly SINGLE = 'single';\n static readonly CLUSTER = 'cluster';\n static readonly SENTINEL = 'sentinel';\n\n static readonly SCHEME_SET = new Set([this.SINGLE, this.CLUSTER, this.SENTINEL]);\n\n static isValid(scheme: string): scheme is TRedisMode {\n return this.SCHEME_SET.has(scheme);\n }\n}\n\nexport type TRedisMode = TConstValue<typeof RedisModes>;\n\nexport class RedisSentinelRoles {\n static readonly MASTER = 'master';\n static readonly SLAVE = 'slave';\n\n static readonly ROLE_SET = new Set([this.MASTER, this.SLAVE]);\n\n static isValid(role: string): role is TRedisSentinelRole {\n return this.ROLE_SET.has(role);\n }\n}\n\nexport type TRedisSentinelRole = TConstValue<typeof RedisSentinelRoles>;\n\n/** Ceiling on a caller-sized fan-out over one connection; a burst larger than this queues rather than piles up. */\nexport class RedisConcurrency {\n static readonly PUBLISH_LIMIT = 32;\n}\n"]}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/redis/common/constants.ts"],"names":[],"mappings":"AAEA,2GAA2G;AAC3G,MAAM,OAAO,UAAU;aACL,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aACpB,aAAQ,GAAG,UAAU,CAAC;aAEtB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjF,MAAM,CAAC,OAAO,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;;AAMH,6DAA6D;AAC7D,MAAM,OAAO,kBAAkB;aACb,WAAM,GAAG,QAAQ,CAAC;aAClB,UAAK,GAAG,OAAO,CAAC;aAEhB,aAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAE9D,MAAM,CAAC,OAAO,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;;AAMH,mHAAmH;AACnH,MAAM,OAAO,gBAAgB;aACX,kBAAa,GAAG,EAAE,CAAC","sourcesContent":["import type { TConstValue } from '@/common/types';\n\n/** Deployment modes a Redis helper can be built for; selects the helper in `RedisHelperFactory.create`. */\nexport class RedisModes {\n static readonly SINGLE = 'single';\n static readonly CLUSTER = 'cluster';\n static readonly SENTINEL = 'sentinel';\n\n static readonly SCHEME_SET = new Set([this.SINGLE, this.CLUSTER, this.SENTINEL]);\n\n static isValid(scheme: string): scheme is TRedisMode {\n return this.SCHEME_SET.has(scheme);\n }\n}\n\n/** Union of the `RedisModes` values. */\nexport type TRedisMode = TConstValue<typeof RedisModes>;\n\n/** Role of the node a Sentinel-backed client connects to. */\nexport class RedisSentinelRoles {\n static readonly MASTER = 'master';\n static readonly SLAVE = 'slave';\n\n static readonly ROLE_SET = new Set([this.MASTER, this.SLAVE]);\n\n static isValid(role: string): role is TRedisSentinelRole {\n return this.ROLE_SET.has(role);\n }\n}\n\n/** Union of the `RedisSentinelRoles` values. */\nexport type TRedisSentinelRole = TConstValue<typeof RedisSentinelRoles>;\n\n/** Ceiling on a caller-sized fan-out over one connection; a burst larger than this queues rather than piles up. */\nexport class RedisConcurrency {\n static readonly PUBLISH_LIMIT = 32;\n}\n"]}
@@ -1,4 +1,5 @@
1
1
  import type { TRedisClient } from './types.js';
2
+ /** Client access and connection lifecycle of a Redis helper. `connect` and `disconnect` resolve `false` when the client status makes the call a no-op. */
2
3
  export interface IRedisConnection {
3
4
  getClient(): TRedisClient;
4
5
  duplicateClient(): TRedisClient;
@@ -6,6 +7,7 @@ export interface IRedisConnection {
6
7
  connect(): Promise<boolean>;
7
8
  disconnect(): Promise<boolean>;
8
9
  }
10
+ /** Key-level commands: existence, expiry, TTL and counters. */
9
11
  export interface IRedisKey {
10
12
  exists(opts: {
11
13
  keys: Array<string>;
@@ -39,6 +41,7 @@ export interface IRedisKey {
39
41
  value: number;
40
42
  }): Promise<number>;
41
43
  }
44
+ /** String value commands, including JSON-serialised object reads and batch get and set. `set` `expiresIn` is in milliseconds. */
42
45
  export interface IRedisKeyValue {
43
46
  set<T>(opts: {
44
47
  key: string;
@@ -84,6 +87,7 @@ export interface IRedisKeyValue {
84
87
  transform?: (input: string) => T;
85
88
  }): Promise<(T | null)[]>;
86
89
  }
90
+ /** Hash commands (`HSET`, `HGET`, ...) on one key. */
87
91
  export interface IRedisHash {
88
92
  hSet<T extends Record<string, unknown>>(opts: {
89
93
  key: string;
@@ -123,6 +127,7 @@ export interface IRedisHash {
123
127
  key: string;
124
128
  }): Promise<number>;
125
129
  }
130
+ /** Set commands (`SADD`, `SMEMBERS`, ...) on one key. */
126
131
  export interface IRedisSet {
127
132
  sAdd(opts: {
128
133
  key: string;
@@ -143,6 +148,7 @@ export interface IRedisSet {
143
148
  key: string;
144
149
  }): Promise<number>;
145
150
  }
151
+ /** List commands (`LPUSH`, `LRANGE`, ...) on one key. */
146
152
  export interface IRedisList {
147
153
  lPush(opts: {
148
154
  key: string;
@@ -167,6 +173,7 @@ export interface IRedisList {
167
173
  key: string;
168
174
  }): Promise<number>;
169
175
  }
176
+ /** Publish to many topics and subscribe on the helper client. `publish` serialises the payload as JSON and deflates it when `useCompress` is set. */
170
177
  export interface IRedisPubSub {
171
178
  publish<T>(opts: {
172
179
  topics: Array<string>;
@@ -180,6 +187,7 @@ export interface IRedisPubSub {
180
187
  topic: string;
181
188
  }): void;
182
189
  }
190
+ /** RedisJSON commands (`JSON.SET`, `JSON.GET`, ...); the Redis server needs the JSON module. */
183
191
  export interface IRedisJson {
184
192
  jSet<T>(opts: {
185
193
  key: string;
@@ -188,10 +196,12 @@ export interface IRedisJson {
188
196
  }): Promise<string | null>;
189
197
  jGet<T>(opts: {
190
198
  key: string;
199
+ /** @default '$' */
191
200
  path?: string;
192
201
  }): Promise<T | null>;
193
202
  jDelete(opts: {
194
203
  key: string;
204
+ /** @default '$' */
195
205
  path?: string;
196
206
  }): Promise<number>;
197
207
  jNumberIncreaseBy(opts: {
@@ -214,9 +224,11 @@ export interface IRedisJson {
214
224
  path: string;
215
225
  }): Promise<T | null>;
216
226
  }
227
+ /** Escape hatch to run any Redis command by name. */
217
228
  export interface IRedisCommand {
218
229
  execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R>;
219
230
  }
231
+ /** Full surface of a Redis helper, composed from the command-group interfaces; `name` is the identifier it was created with. */
220
232
  export interface IRedisHelper extends IRedisConnection, IRedisKey, IRedisKeyValue, IRedisHash, IRedisSet, IRedisList, IRedisPubSub, IRedisJson, IRedisCommand {
221
233
  readonly name: string;
222
234
  }
@@ -1 +1 @@
1
- {"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../../src/modules/redis/common/interfaces.ts"],"names":[],"mappings":"","sourcesContent":["import type { TRedisClient } from './types';\n\nexport interface IRedisConnection {\n getClient(): TRedisClient;\n duplicateClient(): TRedisClient;\n ping(): Promise<string>;\n connect(): Promise<boolean>;\n disconnect(): Promise<boolean>;\n}\n\nexport interface IRedisKey {\n exists(opts: { keys: Array<string> }): Promise<number>;\n expire(opts: { key: string; seconds: number }): Promise<boolean>;\n expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean>;\n ttl(opts: { key: string }): Promise<number>;\n persist(opts: { key: string }): Promise<boolean>;\n incr(opts: { key: string }): Promise<number>;\n decr(opts: { key: string }): Promise<number>;\n incrBy(opts: { key: string; value: number }): Promise<number>;\n decrBy(opts: { key: string; value: number }): Promise<number>;\n}\n\nexport interface IRedisKeyValue {\n set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void>;\n get<T = string>(opts: { key: string; transform?: (input: string) => T }): Promise<T | null>;\n\n del(opts: { keys: Array<string> }): Promise<number>;\n\n keys(opts: { key: string }): Promise<Array<string>>;\n\n getString(opts: { key: string }): Promise<string | null>;\n getStrings(opts: { keys: Array<string> }): Promise<(string | null)[]>;\n\n getObject<T>(opts: { key: string }): Promise<T | null>;\n getObjects(opts: { keys: Array<string> }): Promise<(unknown | null)[]>;\n\n mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void>;\n\n mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]>;\n}\n\nexport interface IRedisHash {\n hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number>;\n hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }): Promise<unknown>;\n hGet(opts: { key: string; field: string }): Promise<string | null>;\n hDel(opts: { key: string; fields: Array<string> }): Promise<number>;\n hExists(opts: { key: string; field: string }): Promise<boolean>;\n hKeys(opts: { key: string }): Promise<string[]>;\n hVals(opts: { key: string }): Promise<string[]>;\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number>;\n hLen(opts: { key: string }): Promise<number>;\n}\n\nexport interface IRedisSet {\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number>;\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number>;\n sMembers(opts: { key: string }): Promise<string[]>;\n sIsMember(opts: { key: string; member: string | number }): Promise<boolean>;\n sCard(opts: { key: string }): Promise<number>;\n}\n\nexport interface IRedisList {\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number>;\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number>;\n lPop(opts: { key: string }): Promise<string | null>;\n rPop(opts: { key: string }): Promise<string | null>;\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]>;\n lLen(opts: { key: string }): Promise<number>;\n}\n\nexport interface IRedisPubSub {\n publish<T>(opts: { topics: Array<string>; payload: T; useCompress?: boolean }): Promise<void>;\n subscribe(opts: { topic: string }): void;\n unsubscribe(opts: { topic: string }): void;\n}\n\nexport interface IRedisJson {\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null>;\n jGet<T>(opts: { key: string; path?: string }): Promise<T | null>;\n jDelete(opts: { key: string; path?: string }): Promise<number>;\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null>;\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null>;\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null>;\n jPop<T>(opts: { key: string; path: string }): Promise<T | null>;\n}\n\nexport interface IRedisCommand {\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R>;\n}\n\nexport interface IRedisHelper\n extends\n IRedisConnection,\n IRedisKey,\n IRedisKeyValue,\n IRedisHash,\n IRedisSet,\n IRedisList,\n IRedisPubSub,\n IRedisJson,\n IRedisCommand {\n readonly name: string;\n}\n"]}
1
+ {"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../../src/modules/redis/common/interfaces.ts"],"names":[],"mappings":"","sourcesContent":["import type { TRedisClient } from './types';\n\n/** Client access and connection lifecycle of a Redis helper. `connect` and `disconnect` resolve `false` when the client status makes the call a no-op. */\nexport interface IRedisConnection {\n getClient(): TRedisClient;\n duplicateClient(): TRedisClient;\n ping(): Promise<string>;\n connect(): Promise<boolean>;\n disconnect(): Promise<boolean>;\n}\n\n/** Key-level commands: existence, expiry, TTL and counters. */\nexport interface IRedisKey {\n exists(opts: { keys: Array<string> }): Promise<number>;\n expire(opts: { key: string; seconds: number }): Promise<boolean>;\n expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean>;\n ttl(opts: { key: string }): Promise<number>;\n persist(opts: { key: string }): Promise<boolean>;\n incr(opts: { key: string }): Promise<number>;\n decr(opts: { key: string }): Promise<number>;\n incrBy(opts: { key: string; value: number }): Promise<number>;\n decrBy(opts: { key: string; value: number }): Promise<number>;\n}\n\n/** String value commands, including JSON-serialised object reads and batch get and set. `set` `expiresIn` is in milliseconds. */\nexport interface IRedisKeyValue {\n set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void>;\n get<T = string>(opts: { key: string; transform?: (input: string) => T }): Promise<T | null>;\n\n del(opts: { keys: Array<string> }): Promise<number>;\n\n keys(opts: { key: string }): Promise<Array<string>>;\n\n getString(opts: { key: string }): Promise<string | null>;\n getStrings(opts: { keys: Array<string> }): Promise<(string | null)[]>;\n\n getObject<T>(opts: { key: string }): Promise<T | null>;\n getObjects(opts: { keys: Array<string> }): Promise<(unknown | null)[]>;\n\n mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void>;\n\n mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]>;\n}\n\n/** Hash commands (`HSET`, `HGET`, ...) on one key. */\nexport interface IRedisHash {\n hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number>;\n hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }): Promise<unknown>;\n hGet(opts: { key: string; field: string }): Promise<string | null>;\n hDel(opts: { key: string; fields: Array<string> }): Promise<number>;\n hExists(opts: { key: string; field: string }): Promise<boolean>;\n hKeys(opts: { key: string }): Promise<string[]>;\n hVals(opts: { key: string }): Promise<string[]>;\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number>;\n hLen(opts: { key: string }): Promise<number>;\n}\n\n/** Set commands (`SADD`, `SMEMBERS`, ...) on one key. */\nexport interface IRedisSet {\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number>;\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number>;\n sMembers(opts: { key: string }): Promise<string[]>;\n sIsMember(opts: { key: string; member: string | number }): Promise<boolean>;\n sCard(opts: { key: string }): Promise<number>;\n}\n\n/** List commands (`LPUSH`, `LRANGE`, ...) on one key. */\nexport interface IRedisList {\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number>;\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number>;\n lPop(opts: { key: string }): Promise<string | null>;\n rPop(opts: { key: string }): Promise<string | null>;\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]>;\n lLen(opts: { key: string }): Promise<number>;\n}\n\n/** Publish to many topics and subscribe on the helper client. `publish` serialises the payload as JSON and deflates it when `useCompress` is set. */\nexport interface IRedisPubSub {\n publish<T>(opts: { topics: Array<string>; payload: T; useCompress?: boolean }): Promise<void>;\n subscribe(opts: { topic: string }): void;\n unsubscribe(opts: { topic: string }): void;\n}\n\n/** RedisJSON commands (`JSON.SET`, `JSON.GET`, ...); the Redis server needs the JSON module. */\nexport interface IRedisJson {\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null>;\n jGet<T>(opts: {\n key: string;\n /** @default '$' */\n path?: string;\n }): Promise<T | null>;\n jDelete(opts: {\n key: string;\n /** @default '$' */\n path?: string;\n }): Promise<number>;\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null>;\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null>;\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null>;\n jPop<T>(opts: { key: string; path: string }): Promise<T | null>;\n}\n\n/** Escape hatch to run any Redis command by name. */\nexport interface IRedisCommand {\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R>;\n}\n\n/** Full surface of a Redis helper, composed from the command-group interfaces; `name` is the identifier it was created with. */\nexport interface IRedisHelper\n extends\n IRedisConnection,\n IRedisKey,\n IRedisKeyValue,\n IRedisHash,\n IRedisSet,\n IRedisList,\n IRedisPubSub,\n IRedisJson,\n IRedisCommand {\n readonly name: string;\n}\n"]}
@@ -1,7 +1,9 @@
1
1
  import type { Cluster, ClusterOptions, Redis, RedisOptions } from 'ioredis';
2
2
  import type { TRedisSentinelRole } from './constants.js';
3
3
  import type { IRedisHelper } from './interfaces.js';
4
+ /** The ioredis client a helper wraps: a single or Sentinel `Redis`, or a `Cluster`. */
4
5
  export type TRedisClient = Redis | Cluster;
6
+ /** Connection settings for a single Redis node. */
5
7
  export interface IRedisSingleHelperProps {
6
8
  name: string;
7
9
  host: string;
@@ -9,10 +11,14 @@ export interface IRedisSingleHelperProps {
9
11
  user?: string;
10
12
  /** Omit it for a Redis with no password. */
11
13
  password?: string;
14
+ /** @default 0 */
12
15
  database?: number;
16
+ /** @default true */
13
17
  autoConnect?: boolean;
18
+ /** @default 0 */
14
19
  maxRetry?: number;
15
20
  }
21
+ /** Connection settings for a Redis Cluster: the startup `nodes`, plus raw ioredis `clusterOptions` that override the helper defaults. */
16
22
  export interface IRedisClusterHelperProps {
17
23
  name: string;
18
24
  nodes: Array<{
@@ -20,26 +26,37 @@ export interface IRedisClusterHelperProps {
20
26
  port: string | number;
21
27
  password?: string;
22
28
  }>;
23
- /** Same meaning as on single and sentinel: `false` holds the client open for a later `connect()`. */
29
+ /**
30
+ * Same meaning as on single and sentinel: `false` holds the client open for a later `connect()`.
31
+ *
32
+ * @default true
33
+ */
24
34
  autoConnect?: boolean;
25
35
  clusterOptions?: ClusterOptions;
26
36
  }
37
+ /** Connection settings for Redis behind Sentinel. `redisOptions` overrides the helper defaults. */
27
38
  export interface IRedisSentinelHelperProps {
28
39
  name: string;
29
40
  sentinels: Array<{
30
41
  host: string;
42
+ /** @default 26379 */
31
43
  port?: string | number;
32
44
  }>;
33
45
  masterName: string;
46
+ /** @default RedisSentinelRoles.MASTER */
34
47
  role?: TRedisSentinelRole;
35
48
  password?: string;
36
49
  sentinelPassword?: string;
37
50
  sentinelUsername?: string;
51
+ /** @default 0 */
38
52
  database?: number;
53
+ /** @default true */
39
54
  autoConnect?: boolean;
55
+ /** @default 0 */
40
56
  maxRetry?: number;
41
57
  redisOptions?: Partial<RedisOptions>;
42
58
  }
59
+ /** Lifecycle hooks a Redis helper calls; each receives the helper name and the helper itself. */
43
60
  export interface IRedisHelperCallbacks {
44
61
  onInitialized?: (opts: {
45
62
  name: string;
@@ -67,10 +84,13 @@ export interface IRedisHelperCallbacks {
67
84
  export interface IRedisModuleOption {
68
85
  module?: typeof import('ioredis');
69
86
  }
87
+ /** Options for `RedisSingleHelper`: connection props, lifecycle callbacks and an optional `ioredis` module. */
70
88
  export interface IRedisSingleHelperOptions extends IRedisSingleHelperProps, IRedisHelperCallbacks, IRedisModuleOption {
71
89
  }
90
+ /** Options for `RedisClusterHelper`: connection props, lifecycle callbacks and an optional `ioredis` module. */
72
91
  export interface IRedisClusterHelperOptions extends IRedisClusterHelperProps, IRedisHelperCallbacks, IRedisModuleOption {
73
92
  }
93
+ /** Options for `RedisSentinelHelper`: connection props, lifecycle callbacks and an optional `ioredis` module. */
74
94
  export interface IRedisSentinelHelperOptions extends IRedisSentinelHelperProps, IRedisHelperCallbacks, IRedisModuleOption {
75
95
  }
76
96
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/redis/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Cluster, ClusterOptions, Redis, RedisOptions } from 'ioredis';\nimport type { TRedisSentinelRole } from './constants';\nimport type { IRedisHelper } from './interfaces';\n\nexport type TRedisClient = Redis | Cluster;\n\nexport interface IRedisSingleHelperProps {\n name: string;\n host: string;\n port: string | number;\n user?: string;\n /** Omit it for a Redis with no password. */\n password?: string;\n database?: number;\n autoConnect?: boolean;\n maxRetry?: number;\n}\n\nexport interface IRedisClusterHelperProps {\n name: string;\n nodes: Array<{ host: string; port: string | number; password?: string }>;\n /** Same meaning as on single and sentinel: `false` holds the client open for a later `connect()`. */\n autoConnect?: boolean;\n clusterOptions?: ClusterOptions;\n}\n\nexport interface IRedisSentinelHelperProps {\n name: string;\n sentinels: Array<{ host: string; port?: string | number }>;\n masterName: string;\n role?: TRedisSentinelRole;\n password?: string;\n sentinelPassword?: string;\n sentinelUsername?: string;\n database?: number;\n autoConnect?: boolean;\n maxRetry?: number;\n redisOptions?: Partial<RedisOptions>;\n}\n\nexport interface IRedisHelperCallbacks {\n onInitialized?: (opts: { name: string; helper: IRedisHelper }) => void;\n onConnected?: (opts: { name: string; helper: IRedisHelper }) => void;\n onReady?: (opts: { name: string; helper: IRedisHelper }) => void;\n onError?: (opts: { name: string; helper: IRedisHelper; error: unknown }) => void;\n}\n\n/**\n * `ioredis` is an optional peer, loaded when a client is built. A `bun build --compile` binary\n * carries no `node_modules` to load it from: pass the module here, or register it once with\n * `ModuleUtility.register({ modules: { ioredis } })` at the entry.\n */\nexport interface IRedisModuleOption {\n module?: typeof import('ioredis');\n}\n\nexport interface IRedisSingleHelperOptions\n extends IRedisSingleHelperProps, IRedisHelperCallbacks, IRedisModuleOption {}\n\nexport interface IRedisClusterHelperOptions\n extends IRedisClusterHelperProps, IRedisHelperCallbacks, IRedisModuleOption {}\n\nexport interface IRedisSentinelHelperOptions\n extends IRedisSentinelHelperProps, IRedisHelperCallbacks, IRedisModuleOption {}\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/redis/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Cluster, ClusterOptions, Redis, RedisOptions } from 'ioredis';\nimport type { TRedisSentinelRole } from './constants';\nimport type { IRedisHelper } from './interfaces';\n\n/** The ioredis client a helper wraps: a single or Sentinel `Redis`, or a `Cluster`. */\nexport type TRedisClient = Redis | Cluster;\n\n/** Connection settings for a single Redis node. */\nexport interface IRedisSingleHelperProps {\n name: string;\n host: string;\n port: string | number;\n user?: string;\n /** Omit it for a Redis with no password. */\n password?: string;\n /** @default 0 */\n database?: number;\n /** @default true */\n autoConnect?: boolean;\n /** @default 0 */\n maxRetry?: number;\n}\n\n/** Connection settings for a Redis Cluster: the startup `nodes`, plus raw ioredis `clusterOptions` that override the helper defaults. */\nexport interface IRedisClusterHelperProps {\n name: string;\n nodes: Array<{ host: string; port: string | number; password?: string }>;\n /**\n * Same meaning as on single and sentinel: `false` holds the client open for a later `connect()`.\n *\n * @default true\n */\n autoConnect?: boolean;\n clusterOptions?: ClusterOptions;\n}\n\n/** Connection settings for Redis behind Sentinel. `redisOptions` overrides the helper defaults. */\nexport interface IRedisSentinelHelperProps {\n name: string;\n sentinels: Array<{\n host: string;\n /** @default 26379 */\n port?: string | number;\n }>;\n masterName: string;\n /** @default RedisSentinelRoles.MASTER */\n role?: TRedisSentinelRole;\n password?: string;\n sentinelPassword?: string;\n sentinelUsername?: string;\n /** @default 0 */\n database?: number;\n /** @default true */\n autoConnect?: boolean;\n /** @default 0 */\n maxRetry?: number;\n redisOptions?: Partial<RedisOptions>;\n}\n\n/** Lifecycle hooks a Redis helper calls; each receives the helper name and the helper itself. */\nexport interface IRedisHelperCallbacks {\n onInitialized?: (opts: { name: string; helper: IRedisHelper }) => void;\n onConnected?: (opts: { name: string; helper: IRedisHelper }) => void;\n onReady?: (opts: { name: string; helper: IRedisHelper }) => void;\n onError?: (opts: { name: string; helper: IRedisHelper; error: unknown }) => void;\n}\n\n/**\n * `ioredis` is an optional peer, loaded when a client is built. A `bun build --compile` binary\n * carries no `node_modules` to load it from: pass the module here, or register it once with\n * `ModuleUtility.register({ modules: { ioredis } })` at the entry.\n */\nexport interface IRedisModuleOption {\n module?: typeof import('ioredis');\n}\n\n/** Options for `RedisSingleHelper`: connection props, lifecycle callbacks and an optional `ioredis` module. */\nexport interface IRedisSingleHelperOptions\n extends IRedisSingleHelperProps, IRedisHelperCallbacks, IRedisModuleOption {}\n\n/** Options for `RedisClusterHelper`: connection props, lifecycle callbacks and an optional `ioredis` module. */\nexport interface IRedisClusterHelperOptions\n extends IRedisClusterHelperProps, IRedisHelperCallbacks, IRedisModuleOption {}\n\n/** Options for `RedisSentinelHelper`: connection props, lifecycle callbacks and an optional `ioredis` module. */\nexport interface IRedisSentinelHelperOptions\n extends IRedisSentinelHelperProps, IRedisHelperCallbacks, IRedisModuleOption {}\n"]}
@@ -4,6 +4,7 @@ import { RedisModes } from './common/index.js';
4
4
  import type { IRedisClusterHelperOptions, IRedisSentinelHelperOptions, IRedisSingleHelperOptions } from './common/index.js';
5
5
  import { RedisSentinelHelper } from './sentinel/index.js';
6
6
  import { RedisSingleHelper } from './single/index.js';
7
+ /** Options for `RedisHelperFactory.create`: the helper options of one mode, discriminated by `mode`. */
7
8
  export type TCreateRedisHelperOptions = ({
8
9
  mode: typeof RedisModes.SINGLE;
9
10
  } & IRedisSingleHelperOptions) | ({
@@ -11,6 +12,7 @@ export type TCreateRedisHelperOptions = ({
11
12
  } & IRedisClusterHelperOptions) | ({
12
13
  mode: typeof RedisModes.SENTINEL;
13
14
  } & IRedisSentinelHelperOptions);
15
+ /** Creates the Redis helper for a `mode`; the overloads return the concrete helper type. Throws on an unsupported mode. */
14
16
  export declare class RedisHelperFactory {
15
17
  static create(opts: {
16
18
  mode: typeof RedisModes.SINGLE;
@@ -3,6 +3,7 @@ import { RedisClusterHelper } from './cluster/index.js';
3
3
  import { RedisModes } from './common/index.js';
4
4
  import { RedisSentinelHelper } from './sentinel/index.js';
5
5
  import { RedisSingleHelper } from './single/index.js';
6
+ /** Creates the Redis helper for a `mode`; the overloads return the concrete helper type. Throws on an unsupported mode. */
6
7
  export class RedisHelperFactory {
7
8
  static create(opts) {
8
9
  switch (opts.mode) {
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/redis/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAO7C,MAAM,OAAO,kBAAkB;IAe7B,MAAM,CAAC,MAAM,CAAC,IAA+B;QAC3C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gBACvB,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;YACD,KAAK,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;gBACxB,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YACD,KAAK,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACzB,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import { getError } from '@/modules/error';\nimport { type AbstractRedisHelper } from './base';\nimport { RedisClusterHelper } from './cluster';\nimport { RedisModes } from './common';\nimport type {\n IRedisClusterHelperOptions,\n IRedisSentinelHelperOptions,\n IRedisSingleHelperOptions,\n} from './common';\nimport { RedisSentinelHelper } from './sentinel';\nimport { RedisSingleHelper } from './single';\n\nexport type TCreateRedisHelperOptions =\n | ({ mode: typeof RedisModes.SINGLE } & IRedisSingleHelperOptions)\n | ({ mode: typeof RedisModes.CLUSTER } & IRedisClusterHelperOptions)\n | ({ mode: typeof RedisModes.SENTINEL } & IRedisSentinelHelperOptions);\n\nexport class RedisHelperFactory {\n static create(\n opts: { mode: typeof RedisModes.SINGLE } & IRedisSingleHelperOptions,\n ): RedisSingleHelper;\n\n static create(\n opts: { mode: typeof RedisModes.CLUSTER } & IRedisClusterHelperOptions,\n ): RedisClusterHelper;\n\n static create(\n opts: { mode: typeof RedisModes.SENTINEL } & IRedisSentinelHelperOptions,\n ): RedisSentinelHelper;\n\n static create(opts: TCreateRedisHelperOptions): AbstractRedisHelper;\n\n static create(opts: TCreateRedisHelperOptions): AbstractRedisHelper {\n switch (opts.mode) {\n case RedisModes.SINGLE: {\n return new RedisSingleHelper(opts);\n }\n case RedisModes.CLUSTER: {\n return new RedisClusterHelper(opts);\n }\n case RedisModes.SENTINEL: {\n return new RedisSentinelHelper(opts);\n }\n default: {\n throw getError({ message: '[RedisHelperFactory.create] Unsupported redis mode!' });\n }\n }\n }\n}\n"]}
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/redis/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAQ7C,2HAA2H;AAC3H,MAAM,OAAO,kBAAkB;IAe7B,MAAM,CAAC,MAAM,CAAC,IAA+B;QAC3C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gBACvB,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;YACD,KAAK,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;gBACxB,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YACD,KAAK,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACzB,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import { getError } from '@/modules/error';\nimport { type AbstractRedisHelper } from './base';\nimport { RedisClusterHelper } from './cluster';\nimport { RedisModes } from './common';\nimport type {\n IRedisClusterHelperOptions,\n IRedisSentinelHelperOptions,\n IRedisSingleHelperOptions,\n} from './common';\nimport { RedisSentinelHelper } from './sentinel';\nimport { RedisSingleHelper } from './single';\n\n/** Options for `RedisHelperFactory.create`: the helper options of one mode, discriminated by `mode`. */\nexport type TCreateRedisHelperOptions =\n | ({ mode: typeof RedisModes.SINGLE } & IRedisSingleHelperOptions)\n | ({ mode: typeof RedisModes.CLUSTER } & IRedisClusterHelperOptions)\n | ({ mode: typeof RedisModes.SENTINEL } & IRedisSentinelHelperOptions);\n\n/** Creates the Redis helper for a `mode`; the overloads return the concrete helper type. Throws on an unsupported mode. */\nexport class RedisHelperFactory {\n static create(\n opts: { mode: typeof RedisModes.SINGLE } & IRedisSingleHelperOptions,\n ): RedisSingleHelper;\n\n static create(\n opts: { mode: typeof RedisModes.CLUSTER } & IRedisClusterHelperOptions,\n ): RedisClusterHelper;\n\n static create(\n opts: { mode: typeof RedisModes.SENTINEL } & IRedisSentinelHelperOptions,\n ): RedisSentinelHelper;\n\n static create(opts: TCreateRedisHelperOptions): AbstractRedisHelper;\n\n static create(opts: TCreateRedisHelperOptions): AbstractRedisHelper {\n switch (opts.mode) {\n case RedisModes.SINGLE: {\n return new RedisSingleHelper(opts);\n }\n case RedisModes.CLUSTER: {\n return new RedisClusterHelper(opts);\n }\n case RedisModes.SENTINEL: {\n return new RedisSentinelHelper(opts);\n }\n default: {\n throw getError({ message: '[RedisHelperFactory.create] Unsupported redis mode!' });\n }\n }\n }\n}\n"]}
@@ -1,6 +1,7 @@
1
1
  import type { Redis } from 'ioredis';
2
2
  import { AbstractRedisHelper } from './../base/index.js';
3
3
  import { type IRedisSentinelHelperOptions } from './../common/index.js';
4
+ /** Redis helper for a master and replicas behind Sentinel. `redisOptions` overrides the helper defaults; the first-class fields override `redisOptions`. */
4
5
  export declare class RedisSentinelHelper extends AbstractRedisHelper<Redis> {
5
6
  constructor(opts: IRedisSentinelHelperOptions);
6
7
  getClient(): Redis;
@@ -2,6 +2,7 @@ import { ModuleUtility } from '../../../utilities/module.utility.js';
2
2
  import { ParseUtility } from '../../../utilities/parse.utility.js';
3
3
  import { AbstractRedisHelper } from './../base/index.js';
4
4
  import { RedisSentinelRoles } from './../common/index.js';
5
+ /** Redis helper for a master and replicas behind Sentinel. `redisOptions` overrides the helper defaults; the first-class fields override `redisOptions`. */
5
6
  export class RedisSentinelHelper extends AbstractRedisHelper {
6
7
  constructor(opts) {
7
8
  const { name, sentinels, masterName, role = RedisSentinelRoles.MASTER, password, sentinelPassword, sentinelUsername, database = 0, autoConnect = true, maxRetry = 0, redisOptions = {}, } = opts;