@venizia/ignis-helpers 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (273) hide show
  1. package/dist/cjs/common/constants/duration.d.ts +4 -1
  2. package/dist/cjs/common/constants/duration.d.ts.map +1 -1
  3. package/dist/cjs/common/constants/duration.js +13 -8
  4. package/dist/cjs/common/constants/duration.js.map +1 -1
  5. package/dist/cjs/common/redact.js +1 -1
  6. package/dist/cjs/common/redact.js.map +1 -1
  7. package/dist/cjs/modules/base.js +1 -1
  8. package/dist/cjs/modules/base.js.map +1 -1
  9. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js +1 -1
  10. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  11. package/dist/cjs/modules/env/app-env.d.ts.map +1 -1
  12. package/dist/cjs/modules/env/app-env.js +1 -1
  13. package/dist/cjs/modules/env/app-env.js.map +1 -1
  14. package/dist/cjs/modules/logger/common/constants.js +1 -1
  15. package/dist/cjs/modules/logger/common/constants.js.map +1 -1
  16. package/dist/cjs/modules/logger/factory.js +1 -1
  17. package/dist/cjs/modules/logger/factory.js.map +1 -1
  18. package/dist/cjs/modules/logger/formatting/deep-splat.js +1 -1
  19. package/dist/cjs/modules/logger/formatting/deep-splat.js.map +1 -1
  20. package/dist/cjs/modules/logger/formatting/error-prettier.js +4 -4
  21. package/dist/cjs/modules/logger/formatting/error-prettier.js.map +1 -1
  22. package/dist/cjs/modules/logger/hf/flusher.js +3 -3
  23. package/dist/cjs/modules/logger/hf/flusher.js.map +1 -1
  24. package/dist/cjs/modules/logger/hf/logger.d.ts.map +1 -1
  25. package/dist/cjs/modules/logger/hf/logger.js +3 -1
  26. package/dist/cjs/modules/logger/hf/logger.js.map +1 -1
  27. package/dist/cjs/modules/logger/resolver.js +3 -3
  28. package/dist/cjs/modules/logger/resolver.js.map +1 -1
  29. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js +1 -1
  30. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  31. package/dist/cjs/modules/logger/winston/logger-factory.js +1 -1
  32. package/dist/cjs/modules/logger/winston/logger-factory.js.map +1 -1
  33. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js +2 -2
  34. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  35. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  36. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  37. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  38. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  39. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  40. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  41. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  42. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  43. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js +34 -11
  44. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  45. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  46. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  47. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +1 -1
  48. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js +7 -6
  49. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  50. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  51. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  52. package/dist/cjs/modules/network/utilities/query-string.d.ts +27 -2
  53. package/dist/cjs/modules/network/utilities/query-string.d.ts.map +1 -1
  54. package/dist/cjs/modules/network/utilities/query-string.js +34 -2
  55. package/dist/cjs/modules/network/utilities/query-string.js.map +1 -1
  56. package/dist/cjs/modules/network/utilities/url-safety/ingest.js +1 -1
  57. package/dist/cjs/modules/network/utilities/url-safety/ingest.js.map +1 -1
  58. package/dist/cjs/modules/network/utilities/url-safety/policy.js +1 -1
  59. package/dist/cjs/modules/network/utilities/url-safety/policy.js.map +1 -1
  60. package/dist/cjs/modules/pool/abstract.js +4 -4
  61. package/dist/cjs/modules/pool/abstract.js.map +1 -1
  62. package/dist/cjs/modules/queue/bullmq/helper.js +2 -2
  63. package/dist/cjs/modules/queue/bullmq/helper.js.map +1 -1
  64. package/dist/cjs/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  65. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  66. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  67. package/dist/cjs/modules/queue/kafka/consumer.js +2 -2
  68. package/dist/cjs/modules/queue/kafka/consumer.js.map +1 -1
  69. package/dist/cjs/modules/queue/mqtt/helper.js +4 -4
  70. package/dist/cjs/modules/queue/mqtt/helper.js.map +1 -1
  71. package/dist/cjs/modules/redis/base/abstract.helper.js +4 -4
  72. package/dist/cjs/modules/redis/base/abstract.helper.js.map +1 -1
  73. package/dist/cjs/modules/redis/cluster/cluster.helper.js +1 -1
  74. package/dist/cjs/modules/redis/cluster/cluster.helper.js.map +1 -1
  75. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js +1 -1
  76. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  77. package/dist/cjs/modules/secrets/base/abstract.helper.d.ts.map +1 -1
  78. package/dist/cjs/modules/secrets/base/abstract.helper.js +7 -3
  79. package/dist/cjs/modules/secrets/base/abstract.helper.js.map +1 -1
  80. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  81. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  82. package/dist/cjs/modules/socket/socket-io/browser.d.ts +5 -0
  83. package/dist/cjs/modules/socket/socket-io/browser.d.ts.map +1 -0
  84. package/dist/cjs/modules/socket/socket-io/browser.js +21 -0
  85. package/dist/cjs/modules/socket/socket-io/browser.js.map +1 -0
  86. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  87. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  88. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js +250 -0
  89. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  90. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts +8 -51
  91. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  92. package/dist/cjs/modules/socket/socket-io/client/helper.js +12 -230
  93. package/dist/cjs/modules/socket/socket-io/client/helper.js.map +1 -1
  94. package/dist/cjs/modules/socket/socket-io/server/helper.js +5 -5
  95. package/dist/cjs/modules/socket/socket-io/server/helper.js.map +1 -1
  96. package/dist/cjs/modules/socket/websocket/server/delivery.js +2 -2
  97. package/dist/cjs/modules/socket/websocket/server/delivery.js.map +1 -1
  98. package/dist/cjs/modules/socket/websocket/server/helper.js +4 -4
  99. package/dist/cjs/modules/socket/websocket/server/helper.js.map +1 -1
  100. package/dist/cjs/modules/storage/base.js +3 -3
  101. package/dist/cjs/modules/storage/base.js.map +1 -1
  102. package/dist/cjs/modules/storage/bun-s3/helper.js +1 -1
  103. package/dist/cjs/modules/storage/bun-s3/helper.js.map +1 -1
  104. package/dist/cjs/modules/storage/bun-s3/utility.js +6 -6
  105. package/dist/cjs/modules/storage/bun-s3/utility.js.map +1 -1
  106. package/dist/cjs/modules/storage/common/errors.js +1 -1
  107. package/dist/cjs/modules/storage/common/errors.js.map +1 -1
  108. package/dist/cjs/modules/storage/minio/helper.js +4 -4
  109. package/dist/cjs/modules/storage/minio/helper.js.map +1 -1
  110. package/dist/cjs/modules/temporal/abstract.js +5 -5
  111. package/dist/cjs/modules/temporal/abstract.js.map +1 -1
  112. package/dist/cjs/modules/temporal/adapters/intl.d.ts.map +1 -1
  113. package/dist/cjs/modules/temporal/adapters/intl.js +3 -1
  114. package/dist/cjs/modules/temporal/adapters/intl.js.map +1 -1
  115. package/dist/cjs/modules/temporal/locale/locale.js +4 -4
  116. package/dist/cjs/modules/temporal/locale/locale.js.map +1 -1
  117. package/dist/cjs/modules/tree/builder.js +2 -2
  118. package/dist/cjs/modules/tree/builder.js.map +1 -1
  119. package/dist/cjs/modules/uid/opaque.js +2 -2
  120. package/dist/cjs/modules/uid/opaque.js.map +1 -1
  121. package/dist/cjs/modules/uid/uuid/v5.js +1 -1
  122. package/dist/cjs/modules/uid/uuid/v5.js.map +1 -1
  123. package/dist/cjs/modules/worker-thread/bus/base.js +4 -4
  124. package/dist/cjs/modules/worker-thread/bus/base.js.map +1 -1
  125. package/dist/cjs/modules/worker-thread/thread/base.js +2 -2
  126. package/dist/cjs/modules/worker-thread/thread/base.js.map +1 -1
  127. package/dist/cjs/modules/worker-thread/worker/base.js +4 -4
  128. package/dist/cjs/modules/worker-thread/worker/base.js.map +1 -1
  129. package/dist/cjs/utilities/parse.utility.js +4 -4
  130. package/dist/cjs/utilities/parse.utility.js.map +1 -1
  131. package/dist/cjs/utilities/promise.utility.js +1 -1
  132. package/dist/cjs/utilities/promise.utility.js.map +1 -1
  133. package/dist/cjs/utilities/request.utility.js +1 -1
  134. package/dist/cjs/utilities/request.utility.js.map +1 -1
  135. package/dist/cjs/utilities/sleep.utility.js +1 -1
  136. package/dist/cjs/utilities/sleep.utility.js.map +1 -1
  137. package/dist/esm/common/constants/duration.d.ts +4 -1
  138. package/dist/esm/common/constants/duration.d.ts.map +1 -1
  139. package/dist/esm/common/constants/duration.js +13 -8
  140. package/dist/esm/common/constants/duration.js.map +1 -1
  141. package/dist/esm/common/redact.js +1 -1
  142. package/dist/esm/common/redact.js.map +1 -1
  143. package/dist/esm/modules/base.js +1 -1
  144. package/dist/esm/modules/base.js.map +1 -1
  145. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +1 -1
  146. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  147. package/dist/esm/modules/env/app-env.d.ts.map +1 -1
  148. package/dist/esm/modules/env/app-env.js +1 -1
  149. package/dist/esm/modules/env/app-env.js.map +1 -1
  150. package/dist/esm/modules/logger/common/constants.js +1 -1
  151. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  152. package/dist/esm/modules/logger/factory.js +1 -1
  153. package/dist/esm/modules/logger/factory.js.map +1 -1
  154. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -1
  155. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  156. package/dist/esm/modules/logger/formatting/error-prettier.js +4 -4
  157. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  158. package/dist/esm/modules/logger/hf/flusher.js +3 -3
  159. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  160. package/dist/esm/modules/logger/hf/logger.d.ts.map +1 -1
  161. package/dist/esm/modules/logger/hf/logger.js +3 -1
  162. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  163. package/dist/esm/modules/logger/resolver.js +3 -3
  164. package/dist/esm/modules/logger/resolver.js.map +1 -1
  165. package/dist/esm/modules/logger/winston/formatters/deep-splat.js +1 -1
  166. package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  167. package/dist/esm/modules/logger/winston/logger-factory.js +1 -1
  168. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  169. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +2 -2
  170. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  171. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  172. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  173. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  174. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  175. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  176. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  177. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  178. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  179. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +36 -13
  180. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  181. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  182. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  183. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +1 -1
  184. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +7 -6
  185. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  186. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  187. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  188. package/dist/esm/modules/network/utilities/query-string.d.ts +27 -2
  189. package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
  190. package/dist/esm/modules/network/utilities/query-string.js +31 -1
  191. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  192. package/dist/esm/modules/network/utilities/url-safety/ingest.js +1 -1
  193. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  194. package/dist/esm/modules/network/utilities/url-safety/policy.js +1 -1
  195. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  196. package/dist/esm/modules/pool/abstract.js +4 -4
  197. package/dist/esm/modules/pool/abstract.js.map +1 -1
  198. package/dist/esm/modules/queue/bullmq/helper.js +2 -2
  199. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  200. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  201. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  202. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  203. package/dist/esm/modules/queue/kafka/consumer.js +2 -2
  204. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  205. package/dist/esm/modules/queue/mqtt/helper.js +4 -4
  206. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  207. package/dist/esm/modules/redis/base/abstract.helper.js +4 -4
  208. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  209. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -1
  210. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  211. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -1
  212. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  213. package/dist/esm/modules/secrets/base/abstract.helper.d.ts.map +1 -1
  214. package/dist/esm/modules/secrets/base/abstract.helper.js +7 -3
  215. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  216. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  217. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  218. package/dist/esm/modules/socket/socket-io/browser.d.ts +5 -0
  219. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +1 -0
  220. package/dist/esm/modules/socket/socket-io/browser.js +5 -0
  221. package/dist/esm/modules/socket/socket-io/browser.js.map +1 -0
  222. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  223. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  224. package/dist/esm/modules/socket/socket-io/client/browser-helper.js +246 -0
  225. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  226. package/dist/esm/modules/socket/socket-io/client/helper.d.ts +8 -51
  227. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  228. package/dist/esm/modules/socket/socket-io/client/helper.js +12 -230
  229. package/dist/esm/modules/socket/socket-io/client/helper.js.map +1 -1
  230. package/dist/esm/modules/socket/socket-io/server/helper.js +5 -5
  231. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  232. package/dist/esm/modules/socket/websocket/server/delivery.js +2 -2
  233. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  234. package/dist/esm/modules/socket/websocket/server/helper.js +4 -4
  235. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  236. package/dist/esm/modules/storage/base.js +3 -3
  237. package/dist/esm/modules/storage/base.js.map +1 -1
  238. package/dist/esm/modules/storage/bun-s3/helper.js +1 -1
  239. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  240. package/dist/esm/modules/storage/bun-s3/utility.js +6 -6
  241. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  242. package/dist/esm/modules/storage/common/errors.js +1 -1
  243. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  244. package/dist/esm/modules/storage/minio/helper.js +4 -4
  245. package/dist/esm/modules/storage/minio/helper.js.map +1 -1
  246. package/dist/esm/modules/temporal/abstract.js +5 -5
  247. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  248. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +1 -1
  249. package/dist/esm/modules/temporal/adapters/intl.js +3 -1
  250. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  251. package/dist/esm/modules/temporal/locale/locale.js +4 -4
  252. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  253. package/dist/esm/modules/tree/builder.js +2 -2
  254. package/dist/esm/modules/tree/builder.js.map +1 -1
  255. package/dist/esm/modules/uid/opaque.js +2 -2
  256. package/dist/esm/modules/uid/opaque.js.map +1 -1
  257. package/dist/esm/modules/uid/uuid/v5.js +1 -1
  258. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  259. package/dist/esm/modules/worker-thread/bus/base.js +4 -4
  260. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  261. package/dist/esm/modules/worker-thread/thread/base.js +2 -2
  262. package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
  263. package/dist/esm/modules/worker-thread/worker/base.js +4 -4
  264. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  265. package/dist/esm/utilities/parse.utility.js +4 -4
  266. package/dist/esm/utilities/parse.utility.js.map +1 -1
  267. package/dist/esm/utilities/promise.utility.js +1 -1
  268. package/dist/esm/utilities/promise.utility.js.map +1 -1
  269. package/dist/esm/utilities/request.utility.js +1 -1
  270. package/dist/esm/utilities/request.utility.js.map +1 -1
  271. package/dist/esm/utilities/sleep.utility.js +1 -1
  272. package/dist/esm/utilities/sleep.utility.js.map +1 -1
  273. package/package.json +10 -4
@@ -73,7 +73,7 @@ export class AbstractPoolHelper extends BaseHelper {
73
73
  }
74
74
  this.borrowed.delete(resource);
75
75
  if (this.isDestroyed) {
76
- this.destroyResource({ resource }).catch(error => {
76
+ this.destroyResource({ resource }).catch((error) => {
77
77
  logger.warn('destroyResource error on release: %s', error);
78
78
  });
79
79
  return;
@@ -125,7 +125,7 @@ export class AbstractPoolHelper extends BaseHelper {
125
125
  waiter.reject(error);
126
126
  }
127
127
  const toDestroy = this.idle.splice(0);
128
- await Promise.all(toDestroy.map(resource => this.destroyResource({ resource })));
128
+ await Promise.all(toDestroy.map((resource) => this.destroyResource({ resource })));
129
129
  }
130
130
  // ----------------------------------------------------------------------------------------------------------
131
131
  async createResource() {
@@ -154,7 +154,7 @@ export class AbstractPoolHelper extends BaseHelper {
154
154
  // ----------------------------------------------------------------------------------------------------------
155
155
  /** Fire-and-forget dispatch with logged rejection; shared by all dispatch call sites. */
156
156
  safeDispatch(opts) {
157
- this.dispatch().catch(error => {
157
+ this.dispatch().catch((error) => {
158
158
  this.logger
159
159
  .for(this.dispatch.name)
160
160
  .warn('dispatch error | action: %s | Error: %s', opts.action, error);
@@ -240,7 +240,7 @@ export class AbstractPoolHelper extends BaseHelper {
240
240
  const { resource } = opts;
241
241
  // `destroy()` tears down what it can SEE - the waiter queue and the idle list. A resource whose create() was still in flight is in neither, so parking it in idle now would leave it alive with nothing left to reclaim it.
242
242
  if (this.isDestroyed) {
243
- this.destroyResource({ resource }).catch(error => {
243
+ this.destroyResource({ resource }).catch((error) => {
244
244
  this.logger
245
245
  .for(this.handToWaiter.name)
246
246
  .warn('destroyResource error on a resource created after destroy(): %s', error);
@@ -1 +1 @@
1
- {"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/modules/pool/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TNullable, type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { HfQueueHelper } from '@/modules/queue/internal/hf';\nimport { type IPool, type IPoolControlOptions, type IPoolStats, type IPoolWaiter } from './common';\n\n/** Single-borrower pool skeleton: subclasses override {@link create} (required) and optionally validateResource/resetResource/onDestroyResource. All resource-waiter pairing flows through ONE re-entrancy-guarded `dispatch()` loop; the waiter queue is {@link HfQueueHelper} - O(1), no shift/splice. */\nexport abstract class AbstractPoolHelper<T> extends BaseHelper implements IPool<T> {\n protected readonly size: number;\n protected readonly acquireTimeoutMs?: number;\n protected readonly maxWaitingClients?: number;\n\n private readonly idle: T[] = [];\n private readonly borrowed = new Set<T>();\n private readonly waiterQueue = new HfQueueHelper<IPoolWaiter<T>>();\n\n private total = 0; // live or being-created resources\n private isDispatching = false;\n private isDestroyed = false;\n\n constructor(opts: IPoolControlOptions) {\n super({ scope: opts.scope ?? 'BasePoolHelper' });\n this.size = opts.size;\n this.acquireTimeoutMs = opts.acquireTimeoutMs;\n this.maxWaitingClients = opts.maxWaitingClients;\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n /** Create one resource. Required. */\n protected abstract create(): ValueOrPromise<T>;\n\n /** Validate an idle resource just before hand-out; false → destroyed + replaced. Default: always valid. */\n protected validateResource(_opts: { resource: T }): ValueOrPromise<boolean> {\n return true;\n }\n\n /** Reset an idle resource before hand-out (e.g. clear state). Throw → resource discarded. Default: no-op. */\n protected resetResource(_opts: { resource: T }): ValueOrPromise<void> {\n return undefined;\n }\n\n /** Tear down a resource being removed from the pool. Default: no-op. */\n protected onDestroyResource(_opts: { resource: T }): ValueOrPromise<void> {\n return undefined;\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n getStats(): IPoolStats {\n return {\n size: this.size,\n available: this.idle.length,\n borrowed: this.borrowed.size,\n pending: this.waiterQueue.size,\n };\n }\n\n async acquire(): Promise<T> {\n if (this.isDestroyed) {\n throw getError({ message: '[acquire] Pool has been destroyed.' });\n }\n\n if (this.maxWaitingClients !== undefined && this.maxWaitingClients >= 0) {\n // Only reject when this acquire would actually have to WAIT: no idle resource and the pool at capacity. With a free/creatable resource the caller is served, so maxWaitingClients:0 means \"serve if available, never queue\" rather than \"reject everything\".\n const isWaitRequired = !this.idle.length && this.total >= this.size;\n\n if (isWaitRequired && this.waiterQueue.size >= this.maxWaitingClients) {\n throw getError({\n message: `[acquire] Too many waiting clients (>= ${this.maxWaitingClients}).`,\n });\n }\n }\n\n const promise = new Promise<T>((resolve, reject) => {\n const waiter: IPoolWaiter<T> = { resolve, reject, timer: null };\n const node = this.waiterQueue.enqueue({ value: waiter });\n\n if (this.acquireTimeoutMs !== undefined && this.acquireTimeoutMs >= 0) {\n waiter.timer = setTimeout(() => {\n this.waiterQueue.cancel({ node }); // O(1) — dispatch skips it when reached\n\n reject(\n getError({\n message: `[acquire] Acquire timed out after ${this.acquireTimeoutMs}ms.`,\n }),\n );\n }, this.acquireTimeoutMs);\n }\n });\n\n this.safeDispatch({ action: 'acquire' });\n return promise;\n }\n\n release(opts: { resource: T }): void {\n const { resource } = opts;\n const logger = this.logger.for(this.release.name);\n\n if (!this.borrowed.has(resource)) {\n logger.warn('Called with a foreign/already-released resource; ignoring.');\n return;\n }\n this.borrowed.delete(resource);\n\n if (this.isDestroyed) {\n this.destroyResource({ resource }).catch(error => {\n logger.warn('destroyResource error on release: %s', error);\n });\n return;\n }\n\n this.idle.push(resource);\n this.safeDispatch({ action: 'release' });\n }\n\n async warmup(): Promise<void> {\n if (this.isDestroyed) {\n throw getError({ message: '[warmup] Pool has been destroyed.' });\n }\n\n // Create sequentially, re-checking the live `total` before each create so the `size` cap holds under concurrent warmup()/acquire(); createResource() bumps `total` synchronously, before its await, so a re-check observes in-flight creations from other callers - no overshoot.\n while (this.total < this.size) {\n const resource = await this.createResource();\n this.idle.push(resource);\n }\n\n this.safeDispatch({ action: 'warmup' });\n }\n\n async use<R>(opts: { execution: (resource: T) => ValueOrPromise<R> }): Promise<R> {\n const resource = await this.acquire();\n\n try {\n const result = await opts.execution(resource);\n this.release({ resource });\n return result;\n } catch (error) {\n this.logger\n .for(this.use.name)\n .error('execution threw → release skipped, force DISCARD | Error: %s', error);\n await this.discard({ resource });\n throw error;\n }\n }\n\n async discard(opts: { resource: T }): Promise<void> {\n const { resource } = opts;\n\n if (!this.borrowed.delete(resource)) {\n this.logger.for(this.discard.name).warn('Called with a non-borrowed resource; ignoring.');\n return;\n }\n\n await this.destroyResource({ resource });\n this.safeDispatch({ action: 'discard' });\n }\n\n async destroy(): Promise<void> {\n this.isDestroyed = true;\n\n const error = getError({ message: '[destroy] Pool destroyed while awaiting a resource.' });\n const draineds = this.waiterQueue.drain();\n for (const waiter of draineds) {\n this.clearWaiterTimer({ waiter });\n waiter.reject(error);\n }\n\n const toDestroy = this.idle.splice(0);\n await Promise.all(toDestroy.map(resource => this.destroyResource({ resource })));\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n private async createResource(): Promise<T> {\n this.total += 1; // bump BEFORE await so concurrent dispatch/warmup see the in-flight create (no overshoot)\n\n try {\n const resource = await this.create();\n return resource;\n } catch (error) {\n this.total -= 1;\n this.logger\n .for(this.createResource.name)\n .error('Error creating pool resource | Error: %s', error);\n throw error;\n }\n }\n\n private async destroyResource(opts: { resource: T }): Promise<void> {\n this.total -= 1;\n\n try {\n await this.onDestroyResource(opts);\n } catch (error) {\n this.logger.for(this.destroyResource.name).warn('destroy hook threw: %s', error);\n }\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n /** Fire-and-forget dispatch with logged rejection; shared by all dispatch call sites. */\n private safeDispatch(opts: { action: string }): void {\n this.dispatch().catch(error => {\n this.logger\n .for(this.dispatch.name)\n .warn('dispatch error | action: %s | Error: %s', opts.action, error);\n });\n }\n\n /** Pair servable resources with waiting acquirers until the queue drains or the pool is exhausted. Re-entrancy-guarded so only one loop runs at a time. */\n private async dispatch() {\n if (this.isDispatching) {\n return;\n }\n\n this.isDispatching = true;\n\n try {\n while (this.waiterQueue.size > 0) {\n // Prefer a warm idle resource (LIFO) over creating a new one.\n if (this.idle.length > 0) {\n const resource = await this.takeIdleResource();\n if (resource === null) {\n continue; // bad idle resource was discarded → try the next one\n }\n\n if (!this.handToWaiter({ resource })) {\n return;\n }\n continue;\n }\n\n if (this.total < this.size) {\n await this.createAndHand();\n continue;\n }\n\n return;\n }\n } catch (error) {\n this.logger\n .for(this.dispatch.name)\n .error('[dispatch] Error while dispatching pool element | Error: %s', error);\n } finally {\n this.isDispatching = false;\n }\n }\n\n /** Pop an idle resource and validate+reset it; on ANY failure destroy it and return null (caller retries). */\n private async takeIdleResource(): Promise<T | null> {\n const resource = this.idle.pop() as T;\n const logger = this.logger.for(this.takeIdleResource.name);\n\n let isValid: boolean;\n try {\n isValid = await this.validateResource({ resource });\n } catch (error) {\n // A throwing validate must NOT leak the popped candidate (it would corrupt `total` and can permanently starve the pool); treat it like an invalid resource - discard and retry.\n logger.warn('validate hook threw; discarding resource: %s', error);\n await this.destroyResource({ resource });\n return null;\n }\n\n if (!isValid) {\n await this.destroyResource({ resource });\n return null;\n }\n\n try {\n await this.resetResource({ resource });\n } catch (error) {\n logger.warn('reset hook threw; discarding resource: %s', error);\n await this.destroyResource({ resource });\n return null;\n }\n\n return resource;\n }\n\n /** Create a fresh resource and hand it to the next waiter; on create failure, reject that waiter. */\n private async createAndHand(): Promise<void> {\n let resource: T;\n try {\n resource = await this.createResource();\n } catch (error) {\n this.takeNextWaiter()?.reject(error);\n return;\n }\n\n this.handToWaiter({ resource });\n }\n\n /** Give a ready resource to the next live waiter; returns false and parks it in idle if the waiter raced away (e.g. timed out during an await). */\n private handToWaiter(opts: { resource: T }): boolean {\n const { resource } = opts;\n\n // `destroy()` tears down what it can SEE - the waiter queue and the idle list. A resource whose create() was still in flight is in neither, so parking it in idle now would leave it alive with nothing left to reclaim it.\n if (this.isDestroyed) {\n this.destroyResource({ resource }).catch(error => {\n this.logger\n .for(this.handToWaiter.name)\n .warn('destroyResource error on a resource created after destroy(): %s', error);\n });\n return false;\n }\n\n const waiter = this.takeNextWaiter();\n if (!waiter) {\n this.idle.push(resource);\n return false;\n }\n\n this.borrowed.add(resource);\n waiter.resolve(resource);\n return true;\n }\n\n /** Dequeue the next live waiter and disarm its acquire-timeout so it cannot fire after settlement. */\n private takeNextWaiter(): TNullable<IPoolWaiter<T>> {\n const waiter = this.waiterQueue.dequeue();\n if (waiter) {\n this.clearWaiterTimer({ waiter });\n }\n return waiter;\n }\n\n private clearWaiterTimer(opts: { waiter: IPoolWaiter<T> }): void {\n const { waiter } = opts;\n if (waiter.timer) {\n clearTimeout(waiter.timer);\n waiter.timer = null;\n }\n }\n}\n"]}
1
+ {"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/modules/pool/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TNullable, type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { HfQueueHelper } from '@/modules/queue/internal/hf';\nimport { type IPool, type IPoolControlOptions, type IPoolStats, type IPoolWaiter } from './common';\n\n/** Single-borrower pool skeleton: subclasses override {@link create} (required) and optionally validateResource/resetResource/onDestroyResource. All resource-waiter pairing flows through ONE re-entrancy-guarded `dispatch()` loop; the waiter queue is {@link HfQueueHelper} - O(1), no shift/splice. */\nexport abstract class AbstractPoolHelper<T> extends BaseHelper implements IPool<T> {\n protected readonly size: number;\n protected readonly acquireTimeoutMs?: number;\n protected readonly maxWaitingClients?: number;\n\n private readonly idle: T[] = [];\n private readonly borrowed = new Set<T>();\n private readonly waiterQueue = new HfQueueHelper<IPoolWaiter<T>>();\n\n private total = 0; // live or being-created resources\n private isDispatching = false;\n private isDestroyed = false;\n\n constructor(opts: IPoolControlOptions) {\n super({ scope: opts.scope ?? 'BasePoolHelper' });\n this.size = opts.size;\n this.acquireTimeoutMs = opts.acquireTimeoutMs;\n this.maxWaitingClients = opts.maxWaitingClients;\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n /** Create one resource. Required. */\n protected abstract create(): ValueOrPromise<T>;\n\n /** Validate an idle resource just before hand-out; false → destroyed + replaced. Default: always valid. */\n protected validateResource(_opts: { resource: T }): ValueOrPromise<boolean> {\n return true;\n }\n\n /** Reset an idle resource before hand-out (e.g. clear state). Throw → resource discarded. Default: no-op. */\n protected resetResource(_opts: { resource: T }): ValueOrPromise<void> {\n return undefined;\n }\n\n /** Tear down a resource being removed from the pool. Default: no-op. */\n protected onDestroyResource(_opts: { resource: T }): ValueOrPromise<void> {\n return undefined;\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n getStats(): IPoolStats {\n return {\n size: this.size,\n available: this.idle.length,\n borrowed: this.borrowed.size,\n pending: this.waiterQueue.size,\n };\n }\n\n async acquire(): Promise<T> {\n if (this.isDestroyed) {\n throw getError({ message: '[acquire] Pool has been destroyed.' });\n }\n\n if (this.maxWaitingClients !== undefined && this.maxWaitingClients >= 0) {\n // Only reject when this acquire would actually have to WAIT: no idle resource and the pool at capacity. With a free/creatable resource the caller is served, so maxWaitingClients:0 means \"serve if available, never queue\" rather than \"reject everything\".\n const isWaitRequired = !this.idle.length && this.total >= this.size;\n\n if (isWaitRequired && this.waiterQueue.size >= this.maxWaitingClients) {\n throw getError({\n message: `[acquire] Too many waiting clients (>= ${this.maxWaitingClients}).`,\n });\n }\n }\n\n const promise = new Promise<T>((resolve, reject) => {\n const waiter: IPoolWaiter<T> = { resolve, reject, timer: null };\n const node = this.waiterQueue.enqueue({ value: waiter });\n\n if (this.acquireTimeoutMs !== undefined && this.acquireTimeoutMs >= 0) {\n waiter.timer = setTimeout(() => {\n this.waiterQueue.cancel({ node }); // O(1) — dispatch skips it when reached\n\n reject(\n getError({\n message: `[acquire] Acquire timed out after ${this.acquireTimeoutMs}ms.`,\n }),\n );\n }, this.acquireTimeoutMs);\n }\n });\n\n this.safeDispatch({ action: 'acquire' });\n return promise;\n }\n\n release(opts: { resource: T }): void {\n const { resource } = opts;\n const logger = this.logger.for(this.release.name);\n\n if (!this.borrowed.has(resource)) {\n logger.warn('Called with a foreign/already-released resource; ignoring.');\n return;\n }\n this.borrowed.delete(resource);\n\n if (this.isDestroyed) {\n this.destroyResource({ resource }).catch((error) => {\n logger.warn('destroyResource error on release: %s', error);\n });\n return;\n }\n\n this.idle.push(resource);\n this.safeDispatch({ action: 'release' });\n }\n\n async warmup(): Promise<void> {\n if (this.isDestroyed) {\n throw getError({ message: '[warmup] Pool has been destroyed.' });\n }\n\n // Create sequentially, re-checking the live `total` before each create so the `size` cap holds under concurrent warmup()/acquire(); createResource() bumps `total` synchronously, before its await, so a re-check observes in-flight creations from other callers - no overshoot.\n while (this.total < this.size) {\n const resource = await this.createResource();\n this.idle.push(resource);\n }\n\n this.safeDispatch({ action: 'warmup' });\n }\n\n async use<R>(opts: { execution: (resource: T) => ValueOrPromise<R> }): Promise<R> {\n const resource = await this.acquire();\n\n try {\n const result = await opts.execution(resource);\n this.release({ resource });\n return result;\n } catch (error) {\n this.logger\n .for(this.use.name)\n .error('execution threw → release skipped, force DISCARD | Error: %s', error);\n await this.discard({ resource });\n throw error;\n }\n }\n\n async discard(opts: { resource: T }): Promise<void> {\n const { resource } = opts;\n\n if (!this.borrowed.delete(resource)) {\n this.logger.for(this.discard.name).warn('Called with a non-borrowed resource; ignoring.');\n return;\n }\n\n await this.destroyResource({ resource });\n this.safeDispatch({ action: 'discard' });\n }\n\n async destroy(): Promise<void> {\n this.isDestroyed = true;\n\n const error = getError({ message: '[destroy] Pool destroyed while awaiting a resource.' });\n const draineds = this.waiterQueue.drain();\n for (const waiter of draineds) {\n this.clearWaiterTimer({ waiter });\n waiter.reject(error);\n }\n\n const toDestroy = this.idle.splice(0);\n await Promise.all(toDestroy.map((resource) => this.destroyResource({ resource })));\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n private async createResource(): Promise<T> {\n this.total += 1; // bump BEFORE await so concurrent dispatch/warmup see the in-flight create (no overshoot)\n\n try {\n const resource = await this.create();\n return resource;\n } catch (error) {\n this.total -= 1;\n this.logger\n .for(this.createResource.name)\n .error('Error creating pool resource | Error: %s', error);\n throw error;\n }\n }\n\n private async destroyResource(opts: { resource: T }): Promise<void> {\n this.total -= 1;\n\n try {\n await this.onDestroyResource(opts);\n } catch (error) {\n this.logger.for(this.destroyResource.name).warn('destroy hook threw: %s', error);\n }\n }\n\n // ----------------------------------------------------------------------------------------------------------\n\n /** Fire-and-forget dispatch with logged rejection; shared by all dispatch call sites. */\n private safeDispatch(opts: { action: string }): void {\n this.dispatch().catch((error) => {\n this.logger\n .for(this.dispatch.name)\n .warn('dispatch error | action: %s | Error: %s', opts.action, error);\n });\n }\n\n /** Pair servable resources with waiting acquirers until the queue drains or the pool is exhausted. Re-entrancy-guarded so only one loop runs at a time. */\n private async dispatch() {\n if (this.isDispatching) {\n return;\n }\n\n this.isDispatching = true;\n\n try {\n while (this.waiterQueue.size > 0) {\n // Prefer a warm idle resource (LIFO) over creating a new one.\n if (this.idle.length > 0) {\n const resource = await this.takeIdleResource();\n if (resource === null) {\n continue; // bad idle resource was discarded → try the next one\n }\n\n if (!this.handToWaiter({ resource })) {\n return;\n }\n continue;\n }\n\n if (this.total < this.size) {\n await this.createAndHand();\n continue;\n }\n\n return;\n }\n } catch (error) {\n this.logger\n .for(this.dispatch.name)\n .error('[dispatch] Error while dispatching pool element | Error: %s', error);\n } finally {\n this.isDispatching = false;\n }\n }\n\n /** Pop an idle resource and validate+reset it; on ANY failure destroy it and return null (caller retries). */\n private async takeIdleResource(): Promise<T | null> {\n const resource = this.idle.pop() as T;\n const logger = this.logger.for(this.takeIdleResource.name);\n\n let isValid: boolean;\n try {\n isValid = await this.validateResource({ resource });\n } catch (error) {\n // A throwing validate must NOT leak the popped candidate (it would corrupt `total` and can permanently starve the pool); treat it like an invalid resource - discard and retry.\n logger.warn('validate hook threw; discarding resource: %s', error);\n await this.destroyResource({ resource });\n return null;\n }\n\n if (!isValid) {\n await this.destroyResource({ resource });\n return null;\n }\n\n try {\n await this.resetResource({ resource });\n } catch (error) {\n logger.warn('reset hook threw; discarding resource: %s', error);\n await this.destroyResource({ resource });\n return null;\n }\n\n return resource;\n }\n\n /** Create a fresh resource and hand it to the next waiter; on create failure, reject that waiter. */\n private async createAndHand(): Promise<void> {\n let resource: T;\n try {\n resource = await this.createResource();\n } catch (error) {\n this.takeNextWaiter()?.reject(error);\n return;\n }\n\n this.handToWaiter({ resource });\n }\n\n /** Give a ready resource to the next live waiter; returns false and parks it in idle if the waiter raced away (e.g. timed out during an await). */\n private handToWaiter(opts: { resource: T }): boolean {\n const { resource } = opts;\n\n // `destroy()` tears down what it can SEE - the waiter queue and the idle list. A resource whose create() was still in flight is in neither, so parking it in idle now would leave it alive with nothing left to reclaim it.\n if (this.isDestroyed) {\n this.destroyResource({ resource }).catch((error) => {\n this.logger\n .for(this.handToWaiter.name)\n .warn('destroyResource error on a resource created after destroy(): %s', error);\n });\n return false;\n }\n\n const waiter = this.takeNextWaiter();\n if (!waiter) {\n this.idle.push(resource);\n return false;\n }\n\n this.borrowed.add(resource);\n waiter.resolve(resource);\n return true;\n }\n\n /** Dequeue the next live waiter and disarm its acquire-timeout so it cannot fire after settlement. */\n private takeNextWaiter(): TNullable<IPoolWaiter<T>> {\n const waiter = this.waiterQueue.dequeue();\n if (waiter) {\n this.clearWaiterTimer({ waiter });\n }\n return waiter;\n }\n\n private clearWaiterTimer(opts: { waiter: IPoolWaiter<T> }): void {\n const { waiter } = opts;\n if (waiter.timer) {\n clearTimeout(waiter.timer);\n waiter.timer = null;\n }\n }\n}\n"]}
@@ -49,7 +49,7 @@ export class BullMQHelper extends BaseHelper {
49
49
  const queueName = this.resolveQueueName();
50
50
  this.queue = this.buildQueue({ queueName });
51
51
  // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.
52
- this.queue.on('error', error => {
52
+ this.queue.on('error', (error) => {
53
53
  this.logger
54
54
  .for('queue-error')
55
55
  .error('queue: %s | Queue error! Error: %s | ID: %s', this.queueName, error, this.identifier);
@@ -132,7 +132,7 @@ export class BullMQHelper extends BaseHelper {
132
132
  });
133
133
  });
134
134
  // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.
135
- this.worker.on('error', error => {
135
+ this.worker.on('error', (error) => {
136
136
  this.logger
137
137
  .for('worker-error')
138
138
  .error('queue: %s | Worker error! Error: %s | ID: %s', this.queueName, error, this.identifier);
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/queue/bullmq/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { type IRedisHelper } from '@/modules/redis';\nimport { toError } from '@/utilities/promise.utility';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport type { Job, Processor, Queue, QueueOptions, Worker, WorkerOptions } from 'bullmq';\nimport { invokeHook, type TBullQueueRole } from '../common';\n\nexport interface IBullMQOptions<TQueueElement = any, TQueueResult = any> {\n queueName: string;\n identifier: string;\n role: TBullQueueRole;\n redisConnection: IRedisHelper;\n\n /** `bullmq` itself, for a `bun build --compile` binary that has no `node_modules` to load it from. Omitted, it is loaded when a queue or worker is built. */\n module?: typeof import('bullmq');\n\n numberOfWorker?: number;\n lockDuration?: number;\n\n /** Merged over the framework defaults, under the fields the helper owns (`connection`) - see `queueOptionsFor`. */\n queueOptions?: Omit<QueueOptions, 'connection'>;\n /** Merged under the fields the helper owns (`connection`, `concurrency`, `lockDuration`) - see `workerOptionsFor`. */\n workerOptions?: Omit<WorkerOptions, 'connection' | 'concurrency' | 'lockDuration'>;\n\n onWorkerData?: (job: Job<TQueueElement, TQueueResult>) => Promise<any>;\n onWorkerDataCompleted?: (job: Job<TQueueElement, TQueueResult>, result: any) => Promise<void>;\n onWorkerDataFail?: (\n job: Job<TQueueElement, TQueueResult> | undefined,\n error: Error,\n ) => Promise<void>;\n}\n\nexport class BullMQHelper<TQueueElement = any, TQueueResult = any> extends BaseHelper {\n protected queueName: string;\n protected role: TBullQueueRole;\n protected redisConnection: IRedisHelper;\n\n queue: Queue<TQueueElement, TQueueResult>;\n worker: Worker<TQueueElement, TQueueResult>;\n\n protected numberOfWorker = 1;\n protected lockDuration = 90 * 60 * 1000;\n\n protected queueOptions?: Omit<QueueOptions, 'connection'>;\n protected workerOptions?: Omit<WorkerOptions, 'connection' | 'concurrency' | 'lockDuration'>;\n\n protected onWorkerData?: (job: Job<TQueueElement, TQueueResult>) => Promise<any>;\n protected onWorkerDataCompleted?: (\n job: Job<TQueueElement, TQueueResult>,\n result: any,\n ) => Promise<void>;\n protected onWorkerDataFail?: (\n job: Job<TQueueElement, TQueueResult> | undefined,\n error: Error,\n ) => Promise<void>;\n\n private readonly bullmqModule?: typeof import('bullmq');\n\n constructor(options: IBullMQOptions<TQueueElement, TQueueResult>) {\n super({ scope: BullMQHelper.name, identifier: options.identifier });\n const {\n queueName,\n redisConnection,\n role,\n numberOfWorker = 1,\n lockDuration = 90 * 60 * 1000,\n queueOptions,\n workerOptions,\n onWorkerData,\n onWorkerDataCompleted,\n onWorkerDataFail,\n module,\n } = options;\n\n this.bullmqModule = module;\n\n this.queueName = queueName;\n this.role = role;\n this.redisConnection = redisConnection;\n\n this.numberOfWorker = numberOfWorker;\n this.lockDuration = lockDuration;\n\n this.queueOptions = queueOptions;\n this.workerOptions = workerOptions;\n\n this.onWorkerData = onWorkerData;\n this.onWorkerDataCompleted = onWorkerDataCompleted;\n this.onWorkerDataFail = onWorkerDataFail;\n\n this.configure();\n }\n\n static newInstance<T = any, R = any>(opts: IBullMQOptions<T, R>) {\n return new BullMQHelper<T, R>(opts);\n }\n\n /** Structural, never `instanceof`: ioredis is an optional peer, and a second copy fails `instanceof` anyway. */\n protected isClusterClient(): boolean {\n const client = Object(this.redisConnection.getClient());\n\n if (Reflect.get(client, 'isCluster') === true) {\n return true;\n }\n\n return typeof Reflect.get(client, 'nodes') === 'function';\n }\n\n protected resolveQueueName(): string {\n if (this.isClusterClient() && !this.queueName.startsWith('{')) {\n return `{${this.queueName}}`;\n }\n\n return this.queueName;\n }\n\n configureQueue() {\n if (!this.queueName) {\n this.logger\n .for(this.configureQueue.name)\n .error('Invalid queue name | ID: %s', this.identifier);\n return;\n }\n\n const queueName = this.resolveQueueName();\n this.queue = this.buildQueue({ queueName });\n\n // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.\n this.queue.on('error', error => {\n this.logger\n .for('queue-error')\n .error(\n 'queue: %s | Queue error! Error: %s | ID: %s',\n this.queueName,\n error,\n this.identifier,\n );\n });\n }\n\n /** Full `Queue` options: framework defaults, then `this.queueOptions`, then the connection the helper owns - in that precedence order. */\n protected queueOptionsFor(opts: { queueName: string }): QueueOptions {\n this.logger\n .for(this.queueOptionsFor.name)\n .debug('Building queue options | Queue: %s | ID: %s', opts.queueName, this.identifier);\n\n return {\n defaultJobOptions: {\n removeOnComplete: true,\n removeOnFail: true,\n },\n ...this.queueOptions,\n connection: this.redisConnection.duplicateClient(),\n };\n }\n\n /** Full `Worker` options: `this.workerOptions`, then the connection/concurrency/lock fields the helper owns - in that precedence order. */\n protected workerOptionsFor(opts: {\n queueName: string;\n processor: Processor<TQueueElement, TQueueResult>;\n }): WorkerOptions {\n this.logger\n .for(this.workerOptionsFor.name)\n .debug('Building worker options | Queue: %s | ID: %s', opts.queueName, this.identifier);\n\n return {\n ...this.workerOptions,\n connection: this.redisConnection.duplicateClient(),\n concurrency: this.numberOfWorker,\n lockDuration: this.lockDuration,\n };\n }\n\n /** `bullmq` is an optional peer: loaded when a queue or worker is built, not when this module is. */\n private loadBullMQ(): typeof import('bullmq') {\n return (\n this.bullmqModule ?? ModuleUtility.loadSync<typeof import('bullmq')>({ module: 'bullmq' })\n );\n }\n\n /** Client factory seam - overridden in tests to run the helper without Redis. */\n protected buildQueue(opts: { queueName: string }): Queue<TQueueElement, TQueueResult> {\n const bullmq = this.loadBullMQ();\n return new bullmq.Queue<TQueueElement, TQueueResult>(\n opts.queueName,\n this.queueOptionsFor(opts),\n );\n }\n\n /** Client factory seam - overridden in tests to run the helper without Redis. */\n protected buildWorker(opts: {\n queueName: string;\n processor: Processor<TQueueElement, TQueueResult>;\n }): Worker<TQueueElement, TQueueResult> {\n const bullmq = this.loadBullMQ();\n return new bullmq.Worker<TQueueElement, TQueueResult>(\n opts.queueName,\n opts.processor,\n this.workerOptionsFor(opts),\n );\n }\n\n configureWorker() {\n if (!this.queueName) {\n this.logger\n .for(this.configureWorker.name)\n .error('Invalid worker name | ID: %s', this.identifier);\n return;\n }\n\n const queueName = this.resolveQueueName();\n this.worker = this.buildWorker({\n queueName,\n processor: async job => {\n if (this.onWorkerData) {\n const result = await this.onWorkerData(job);\n return result;\n }\n\n const { id, name, data } = job;\n this.logger\n .for('onWorkerData')\n .info(\n 'queue: %s | id: %s | name: %s | data: %j | ID: %s',\n this.queueName,\n id,\n name,\n data,\n this.identifier,\n );\n\n return undefined as TQueueResult;\n },\n });\n\n this.worker.on('completed', (job, result) => {\n invokeHook({\n logger: this.logger,\n scope: 'worker-completed',\n execution: () => this.onWorkerDataCompleted?.(job, result),\n });\n });\n\n this.worker.on('failed', (job, reason) => {\n invokeHook({\n logger: this.logger,\n scope: 'worker-failed',\n execution: () => this.onWorkerDataFail?.(job, reason),\n });\n });\n\n // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.\n this.worker.on('error', error => {\n this.logger\n .for('worker-error')\n .error(\n 'queue: %s | Worker error! Error: %s | ID: %s',\n this.queueName,\n error,\n this.identifier,\n );\n });\n }\n\n configure() {\n if (!this.role) {\n this.logger\n .for(this.configure.name)\n .error(\n 'Invalid client role to configure | Valid roles: [queue|worker] | ID: %s',\n this.identifier,\n );\n return;\n }\n\n switch (this.role) {\n case 'queue': {\n this.configureQueue();\n break;\n }\n case 'worker': {\n this.configureWorker();\n break;\n }\n }\n }\n\n async close() {\n const failures: string[] = [];\n\n // Both connections must be released even when the first close fails - otherwise a failing worker close silently leaks the queue's Redis connection forever.\n try {\n await this.worker?.close();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .error('Error closing BullMQ worker: %s | ID: %s', error, this.identifier);\n failures.push(toError(error).message);\n }\n\n try {\n await this.queue?.close();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .error('Error closing BullMQ queue: %s | ID: %s', error, this.identifier);\n failures.push(toError(error).message);\n }\n\n if (failures.length) {\n throw getError({\n message: `[close][${this.identifier}] Failed to close BullMQ helper | Errors: ${failures.join(' | ')}`,\n });\n }\n\n this.logger\n .for(this.close.name)\n .info('BullMQ helper closed successfully | ID: %s', this.identifier);\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/queue/bullmq/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { type IRedisHelper } from '@/modules/redis';\nimport { toError } from '@/utilities/promise.utility';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport type { Job, Processor, Queue, QueueOptions, Worker, WorkerOptions } from 'bullmq';\nimport { invokeHook, type TBullQueueRole } from '../common';\n\nexport interface IBullMQOptions<TQueueElement = any, TQueueResult = any> {\n queueName: string;\n identifier: string;\n role: TBullQueueRole;\n redisConnection: IRedisHelper;\n\n /** `bullmq` itself, for a `bun build --compile` binary that has no `node_modules` to load it from. Omitted, it is loaded when a queue or worker is built. */\n module?: typeof import('bullmq');\n\n numberOfWorker?: number;\n lockDuration?: number;\n\n /** Merged over the framework defaults, under the fields the helper owns (`connection`) - see `queueOptionsFor`. */\n queueOptions?: Omit<QueueOptions, 'connection'>;\n /** Merged under the fields the helper owns (`connection`, `concurrency`, `lockDuration`) - see `workerOptionsFor`. */\n workerOptions?: Omit<WorkerOptions, 'connection' | 'concurrency' | 'lockDuration'>;\n\n onWorkerData?: (job: Job<TQueueElement, TQueueResult>) => Promise<any>;\n onWorkerDataCompleted?: (job: Job<TQueueElement, TQueueResult>, result: any) => Promise<void>;\n onWorkerDataFail?: (\n job: Job<TQueueElement, TQueueResult> | undefined,\n error: Error,\n ) => Promise<void>;\n}\n\nexport class BullMQHelper<TQueueElement = any, TQueueResult = any> extends BaseHelper {\n protected queueName: string;\n protected role: TBullQueueRole;\n protected redisConnection: IRedisHelper;\n\n queue: Queue<TQueueElement, TQueueResult>;\n worker: Worker<TQueueElement, TQueueResult>;\n\n protected numberOfWorker = 1;\n protected lockDuration = 90 * 60 * 1000;\n\n protected queueOptions?: Omit<QueueOptions, 'connection'>;\n protected workerOptions?: Omit<WorkerOptions, 'connection' | 'concurrency' | 'lockDuration'>;\n\n protected onWorkerData?: (job: Job<TQueueElement, TQueueResult>) => Promise<any>;\n protected onWorkerDataCompleted?: (\n job: Job<TQueueElement, TQueueResult>,\n result: any,\n ) => Promise<void>;\n protected onWorkerDataFail?: (\n job: Job<TQueueElement, TQueueResult> | undefined,\n error: Error,\n ) => Promise<void>;\n\n private readonly bullmqModule?: typeof import('bullmq');\n\n constructor(options: IBullMQOptions<TQueueElement, TQueueResult>) {\n super({ scope: BullMQHelper.name, identifier: options.identifier });\n const {\n queueName,\n redisConnection,\n role,\n numberOfWorker = 1,\n lockDuration = 90 * 60 * 1000,\n queueOptions,\n workerOptions,\n onWorkerData,\n onWorkerDataCompleted,\n onWorkerDataFail,\n module,\n } = options;\n\n this.bullmqModule = module;\n\n this.queueName = queueName;\n this.role = role;\n this.redisConnection = redisConnection;\n\n this.numberOfWorker = numberOfWorker;\n this.lockDuration = lockDuration;\n\n this.queueOptions = queueOptions;\n this.workerOptions = workerOptions;\n\n this.onWorkerData = onWorkerData;\n this.onWorkerDataCompleted = onWorkerDataCompleted;\n this.onWorkerDataFail = onWorkerDataFail;\n\n this.configure();\n }\n\n static newInstance<T = any, R = any>(opts: IBullMQOptions<T, R>) {\n return new BullMQHelper<T, R>(opts);\n }\n\n /** Structural, never `instanceof`: ioredis is an optional peer, and a second copy fails `instanceof` anyway. */\n protected isClusterClient(): boolean {\n const client = Object(this.redisConnection.getClient());\n\n if (Reflect.get(client, 'isCluster') === true) {\n return true;\n }\n\n return typeof Reflect.get(client, 'nodes') === 'function';\n }\n\n protected resolveQueueName(): string {\n if (this.isClusterClient() && !this.queueName.startsWith('{')) {\n return `{${this.queueName}}`;\n }\n\n return this.queueName;\n }\n\n configureQueue() {\n if (!this.queueName) {\n this.logger\n .for(this.configureQueue.name)\n .error('Invalid queue name | ID: %s', this.identifier);\n return;\n }\n\n const queueName = this.resolveQueueName();\n this.queue = this.buildQueue({ queueName });\n\n // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.\n this.queue.on('error', (error) => {\n this.logger\n .for('queue-error')\n .error(\n 'queue: %s | Queue error! Error: %s | ID: %s',\n this.queueName,\n error,\n this.identifier,\n );\n });\n }\n\n /** Full `Queue` options: framework defaults, then `this.queueOptions`, then the connection the helper owns - in that precedence order. */\n protected queueOptionsFor(opts: { queueName: string }): QueueOptions {\n this.logger\n .for(this.queueOptionsFor.name)\n .debug('Building queue options | Queue: %s | ID: %s', opts.queueName, this.identifier);\n\n return {\n defaultJobOptions: {\n removeOnComplete: true,\n removeOnFail: true,\n },\n ...this.queueOptions,\n connection: this.redisConnection.duplicateClient(),\n };\n }\n\n /** Full `Worker` options: `this.workerOptions`, then the connection/concurrency/lock fields the helper owns - in that precedence order. */\n protected workerOptionsFor(opts: {\n queueName: string;\n processor: Processor<TQueueElement, TQueueResult>;\n }): WorkerOptions {\n this.logger\n .for(this.workerOptionsFor.name)\n .debug('Building worker options | Queue: %s | ID: %s', opts.queueName, this.identifier);\n\n return {\n ...this.workerOptions,\n connection: this.redisConnection.duplicateClient(),\n concurrency: this.numberOfWorker,\n lockDuration: this.lockDuration,\n };\n }\n\n /** `bullmq` is an optional peer: loaded when a queue or worker is built, not when this module is. */\n private loadBullMQ(): typeof import('bullmq') {\n return (\n this.bullmqModule ?? ModuleUtility.loadSync<typeof import('bullmq')>({ module: 'bullmq' })\n );\n }\n\n /** Client factory seam - overridden in tests to run the helper without Redis. */\n protected buildQueue(opts: { queueName: string }): Queue<TQueueElement, TQueueResult> {\n const bullmq = this.loadBullMQ();\n return new bullmq.Queue<TQueueElement, TQueueResult>(\n opts.queueName,\n this.queueOptionsFor(opts),\n );\n }\n\n /** Client factory seam - overridden in tests to run the helper without Redis. */\n protected buildWorker(opts: {\n queueName: string;\n processor: Processor<TQueueElement, TQueueResult>;\n }): Worker<TQueueElement, TQueueResult> {\n const bullmq = this.loadBullMQ();\n return new bullmq.Worker<TQueueElement, TQueueResult>(\n opts.queueName,\n opts.processor,\n this.workerOptionsFor(opts),\n );\n }\n\n configureWorker() {\n if (!this.queueName) {\n this.logger\n .for(this.configureWorker.name)\n .error('Invalid worker name | ID: %s', this.identifier);\n return;\n }\n\n const queueName = this.resolveQueueName();\n this.worker = this.buildWorker({\n queueName,\n processor: async (job) => {\n if (this.onWorkerData) {\n const result = await this.onWorkerData(job);\n return result;\n }\n\n const { id, name, data } = job;\n this.logger\n .for('onWorkerData')\n .info(\n 'queue: %s | id: %s | name: %s | data: %j | ID: %s',\n this.queueName,\n id,\n name,\n data,\n this.identifier,\n );\n\n return undefined as TQueueResult;\n },\n });\n\n this.worker.on('completed', (job, result) => {\n invokeHook({\n logger: this.logger,\n scope: 'worker-completed',\n execution: () => this.onWorkerDataCompleted?.(job, result),\n });\n });\n\n this.worker.on('failed', (job, reason) => {\n invokeHook({\n logger: this.logger,\n scope: 'worker-failed',\n execution: () => this.onWorkerDataFail?.(job, reason),\n });\n });\n\n // An 'error' event without a listener is re-thrown by EventEmitter - a Redis hiccup would take the whole process down.\n this.worker.on('error', (error) => {\n this.logger\n .for('worker-error')\n .error(\n 'queue: %s | Worker error! Error: %s | ID: %s',\n this.queueName,\n error,\n this.identifier,\n );\n });\n }\n\n configure() {\n if (!this.role) {\n this.logger\n .for(this.configure.name)\n .error(\n 'Invalid client role to configure | Valid roles: [queue|worker] | ID: %s',\n this.identifier,\n );\n return;\n }\n\n switch (this.role) {\n case 'queue': {\n this.configureQueue();\n break;\n }\n case 'worker': {\n this.configureWorker();\n break;\n }\n }\n }\n\n async close() {\n const failures: string[] = [];\n\n // Both connections must be released even when the first close fails - otherwise a failing worker close silently leaks the queue's Redis connection forever.\n try {\n await this.worker?.close();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .error('Error closing BullMQ worker: %s | ID: %s', error, this.identifier);\n failures.push(toError(error).message);\n }\n\n try {\n await this.queue?.close();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .error('Error closing BullMQ queue: %s | ID: %s', error, this.identifier);\n failures.push(toError(error).message);\n }\n\n if (failures.length) {\n throw getError({\n message: `[close][${this.identifier}] Failed to close BullMQ helper | Errors: ${failures.join(' | ')}`,\n });\n }\n\n this.logger\n .for(this.close.name)\n .info('BullMQ helper closed successfully | ID: %s', this.identifier);\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"platformatic-require.plugin.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/platformatic-require.plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAElF,waAAwa;AACxa,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAc,EAAE,CAAC,CAAC;IACzD,IAAI,EAAE,uBAAuB,CAAC,oBAAoB;IAClD,KAAK,CAAC,KAAK;QACT,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,6BAA6B,CAAC,aAAa,EAAE,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;YACjF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,OAAO,GAAa,EAAE,CAAC;YAE7B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAC7B,6BAA6B,CAAC,eAAe,EAC7C,CAAC,OAAO,EAAE,OAAe,EAAE,MAAc,EAAE,SAAiB,EAAE,EAAE;gBAC9D,IAAI,6BAA6B,CAAC,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzE,OAAO,OAAO,CAAC;gBACjB,CAAC;gBAED,MAAM,KAAK,GAAG,GAAG,6BAA6B,CAAC,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACtF,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAEnE,uFAAuF;gBACvF,wFAAwF;gBACxF,8EAA8E;gBAC9E,OAAO,SAAS,OAAO,MAAM,KAAK,GAAG,CAAC;YACxC,CAAC,CACF,CAAC;YAEF,kFAAkF;YAClF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC","sourcesContent":["import type { BunPlugin } from 'bun';\nimport { KafkaBundlerPluginNames, PlatformaticRequireSpecifiers } from './common';\n\n/** `@platformatic/kafka` 2.8-2.9 resolves some dependencies through `createRequire(import.meta.url)` at module scope; `bun build --compile` cannot see through that, so the specifier stays unresolved and the binary dies with \"Cannot find package\" before boot - this plugin hoists those calls to static imports at bundle time. 2.10 removed the module-scope require(), so on >= 2.10 the plugin matches nothing and is inert. */\nexport const platformaticRequirePlugin = (): BunPlugin => ({\n name: KafkaBundlerPluginNames.PLATFORMATIC_REQUIRE,\n setup(build) {\n build.onLoad({ filter: PlatformaticRequireSpecifiers.MODULE_FILTER }, async args => {\n const source = await Bun.file(args.path).text();\n const imports: string[] = [];\n\n const contents = source.replace(\n PlatformaticRequireSpecifiers.REQUIRE_PATTERN,\n (matched, binding: string, _quote: string, specifier: string) => {\n if (PlatformaticRequireSpecifiers.SKIPPED_SPECIFIERS.includes(specifier)) {\n return matched;\n }\n\n const alias = `${PlatformaticRequireSpecifiers.IMPORT_ALIAS_PREFIX}${imports.length}`;\n imports.push(`import ${alias} from ${JSON.stringify(specifier)};`);\n\n // No `?.default` unwrap: a default import already yields `module.exports` for CJS, and\n // unwrapping would break JSON payloads carrying their own top-level `default` key - the\n // draft-06 meta schema has one, so unwrapping silently replaces it with `{}`.\n return `const ${binding} = ${alias};`;\n },\n );\n\n // No match is not an error: upstream fixing this makes the plugin an inert no-op.\n if (!imports.length) {\n return undefined;\n }\n\n return { contents: `${imports.join('\\n')}\\n${contents}`, loader: 'js' };\n });\n },\n});\n"]}
1
+ {"version":3,"file":"platformatic-require.plugin.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/platformatic-require.plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAElF,waAAwa;AACxa,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAc,EAAE,CAAC,CAAC;IACzD,IAAI,EAAE,uBAAuB,CAAC,oBAAoB;IAClD,KAAK,CAAC,KAAK;QACT,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,6BAA6B,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACnF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,OAAO,GAAa,EAAE,CAAC;YAE7B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAC7B,6BAA6B,CAAC,eAAe,EAC7C,CAAC,OAAO,EAAE,OAAe,EAAE,MAAc,EAAE,SAAiB,EAAE,EAAE;gBAC9D,IAAI,6BAA6B,CAAC,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzE,OAAO,OAAO,CAAC;gBACjB,CAAC;gBAED,MAAM,KAAK,GAAG,GAAG,6BAA6B,CAAC,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACtF,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAEnE,uFAAuF;gBACvF,wFAAwF;gBACxF,8EAA8E;gBAC9E,OAAO,SAAS,OAAO,MAAM,KAAK,GAAG,CAAC;YACxC,CAAC,CACF,CAAC;YAEF,kFAAkF;YAClF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC","sourcesContent":["import type { BunPlugin } from 'bun';\nimport { KafkaBundlerPluginNames, PlatformaticRequireSpecifiers } from './common';\n\n/** `@platformatic/kafka` 2.8-2.9 resolves some dependencies through `createRequire(import.meta.url)` at module scope; `bun build --compile` cannot see through that, so the specifier stays unresolved and the binary dies with \"Cannot find package\" before boot - this plugin hoists those calls to static imports at bundle time. 2.10 removed the module-scope require(), so on >= 2.10 the plugin matches nothing and is inert. */\nexport const platformaticRequirePlugin = (): BunPlugin => ({\n name: KafkaBundlerPluginNames.PLATFORMATIC_REQUIRE,\n setup(build) {\n build.onLoad({ filter: PlatformaticRequireSpecifiers.MODULE_FILTER }, async (args) => {\n const source = await Bun.file(args.path).text();\n const imports: string[] = [];\n\n const contents = source.replace(\n PlatformaticRequireSpecifiers.REQUIRE_PATTERN,\n (matched, binding: string, _quote: string, specifier: string) => {\n if (PlatformaticRequireSpecifiers.SKIPPED_SPECIFIERS.includes(specifier)) {\n return matched;\n }\n\n const alias = `${PlatformaticRequireSpecifiers.IMPORT_ALIAS_PREFIX}${imports.length}`;\n imports.push(`import ${alias} from ${JSON.stringify(specifier)};`);\n\n // No `?.default` unwrap: a default import already yields `module.exports` for CJS, and\n // unwrapping would break JSON payloads carrying their own top-level `default` key - the\n // draft-06 meta schema has one, so unwrapping silently replaces it with `{}`.\n return `const ${binding} = ${alias};`;\n },\n );\n\n // No match is not an error: upstream fixing this makes the plugin an inert no-op.\n if (!imports.length) {\n return undefined;\n }\n\n return { contents: `${imports.join('\\n')}\\n${contents}`, loader: 'js' };\n });\n },\n});\n"]}
@@ -5,7 +5,7 @@ import { KafkaBundlerPluginNames, PlatformaticWasmSpecifiers } from './common/in
5
5
  export const platformaticWasmPlugin = () => ({
6
6
  name: KafkaBundlerPluginNames.PLATFORMATIC_WASM,
7
7
  setup(build) {
8
- build.onResolve({ filter: PlatformaticWasmSpecifiers.ENTRYPOINT_FILTER }, args => {
8
+ build.onResolve({ filter: PlatformaticWasmSpecifiers.ENTRYPOINT_FILTER }, (args) => {
9
9
  try {
10
10
  return {
11
11
  path: Bun.resolveSync(PlatformaticWasmSpecifiers.BUNDLED_ENTRYPOINT, dirname(args.importer)),
@@ -1 +1 @@
1
- {"version":3,"file":"platformatic-wasm.plugin.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/platformatic-wasm.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAE/E,8RAA8R;AAC9R,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAc,EAAE,CAAC,CAAC;IACtD,IAAI,EAAE,uBAAuB,CAAC,iBAAiB;IAC/C,KAAK,CAAC,KAAK;QACT,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,0BAA0B,CAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,EAAE;YAC/E,IAAI,CAAC;gBACH,OAAO;oBACL,IAAI,EAAE,GAAG,CAAC,WAAW,CACnB,0BAA0B,CAAC,kBAAkB,EAC7C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CACvB;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE;wBACP,8CAA8C,0BAA0B,CAAC,kBAAkB,EAAE;wBAC7F,QAAQ,IAAI,CAAC,QAAQ,EAAE;wBACvB,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACrE,CAAC,IAAI,CAAC,GAAG,CAAC;iBACZ,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { getError } from '@/modules/error';\nimport type { BunPlugin } from 'bun';\nimport { dirname } from 'node:path';\nimport { KafkaBundlerPluginNames, PlatformaticWasmSpecifiers } from './common';\n\n/** `@platformatic/wasm-utils`'s default entrypoint reads `native.wasm` from disk at module load and `bun build --compile` embeds JS only, so it resolves against `/$bunfs` and the binary dies with ENOENT - this plugin redirects the import to the `/bundled` entrypoint (wasm inlined). */\nexport const platformaticWasmPlugin = (): BunPlugin => ({\n name: KafkaBundlerPluginNames.PLATFORMATIC_WASM,\n setup(build) {\n build.onResolve({ filter: PlatformaticWasmSpecifiers.ENTRYPOINT_FILTER }, args => {\n try {\n return {\n path: Bun.resolveSync(\n PlatformaticWasmSpecifiers.BUNDLED_ENTRYPOINT,\n dirname(args.importer),\n ),\n };\n } catch (error) {\n throw getError({\n message: [\n `[platformaticWasmPlugin] Failed to resolve ${PlatformaticWasmSpecifiers.BUNDLED_ENTRYPOINT}`,\n `from ${args.importer}`,\n `| Error: ${error instanceof Error ? error.message : String(error)}`,\n ].join(' '),\n });\n }\n });\n },\n});\n"]}
1
+ {"version":3,"file":"platformatic-wasm.plugin.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/platformatic-wasm.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAE/E,8RAA8R;AAC9R,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAc,EAAE,CAAC,CAAC;IACtD,IAAI,EAAE,uBAAuB,CAAC,iBAAiB;IAC/C,KAAK,CAAC,KAAK;QACT,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,0BAA0B,CAAC,iBAAiB,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YACjF,IAAI,CAAC;gBACH,OAAO;oBACL,IAAI,EAAE,GAAG,CAAC,WAAW,CACnB,0BAA0B,CAAC,kBAAkB,EAC7C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CACvB;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE;wBACP,8CAA8C,0BAA0B,CAAC,kBAAkB,EAAE;wBAC7F,QAAQ,IAAI,CAAC,QAAQ,EAAE;wBACvB,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACrE,CAAC,IAAI,CAAC,GAAG,CAAC;iBACZ,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { getError } from '@/modules/error';\nimport type { BunPlugin } from 'bun';\nimport { dirname } from 'node:path';\nimport { KafkaBundlerPluginNames, PlatformaticWasmSpecifiers } from './common';\n\n/** `@platformatic/wasm-utils`'s default entrypoint reads `native.wasm` from disk at module load and `bun build --compile` embeds JS only, so it resolves against `/$bunfs` and the binary dies with ENOENT - this plugin redirects the import to the `/bundled` entrypoint (wasm inlined). */\nexport const platformaticWasmPlugin = (): BunPlugin => ({\n name: KafkaBundlerPluginNames.PLATFORMATIC_WASM,\n setup(build) {\n build.onResolve({ filter: PlatformaticWasmSpecifiers.ENTRYPOINT_FILTER }, (args) => {\n try {\n return {\n path: Bun.resolveSync(\n PlatformaticWasmSpecifiers.BUNDLED_ENTRYPOINT,\n dirname(args.importer),\n ),\n };\n } catch (error) {\n throw getError({\n message: [\n `[platformaticWasmPlugin] Failed to resolve ${PlatformaticWasmSpecifiers.BUNDLED_ENTRYPOINT}`,\n `from ${args.importer}`,\n `| Error: ${error instanceof Error ? error.message : String(error)}`,\n ].join(' '),\n });\n }\n });\n },\n});\n"]}
@@ -326,7 +326,7 @@ export class KafkaConsumerHelper extends BaseKafkaHelper {
326
326
  this.logger.warn('[rebuildClient] Failed to restart lag monitoring on new client | Error: %s', toError(error).message);
327
327
  }
328
328
  }
329
- this.closeOldClient(oldClient).catch(error => {
329
+ this.closeOldClient(oldClient).catch((error) => {
330
330
  this.logger.warn('[rebuildClient] background close of old client failed (ignored) | Error: %s', toError(error).message);
331
331
  });
332
332
  }
@@ -344,7 +344,7 @@ export class KafkaConsumerHelper extends BaseKafkaHelper {
344
344
  }
345
345
  });
346
346
  }),
347
- new Promise(resolve => {
347
+ new Promise((resolve) => {
348
348
  timeoutHandle = setTimeout(resolve, this.shutdownTimeout);
349
349
  }),
350
350
  ]);
@@ -1 +1 @@
1
- {"version":3,"file":"consumer.js","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/consumer.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { sleep } from '@/utilities/sleep.utility';\nimport { toError } from '@/utilities/promise.utility';\nimport type {\n ConsumerGroupJoinPayload,\n ConsumerGroupLeavePayload,\n ConsumerGroupRebalancePayload,\n ConsumerHeartbeatErrorPayload,\n MessagesStream,\n Offsets,\n} from '@platformatic/kafka';\nimport { Consumer } from '@platformatic/kafka';\nimport { invokeHook } from '../common';\nimport { BaseKafkaHelper } from './base';\nimport { KafkaClientEvents, KafkaDefaults, KafkaHealthStatuses } from './common/constants';\nimport type {\n IKafkaConsumeStartOptions,\n IKafkaConsumerOptions,\n TKafkaGroupJoinCallback,\n TKafkaGroupLeaveCallback,\n TKafkaGroupRebalanceCallback,\n TKafkaHeartbeatErrorCallback,\n TKafkaLagCallback,\n TKafkaLagErrorCallback,\n TKafkaMessageCallback,\n TKafkaMessageDoneCallback,\n TKafkaMessageErrorCallback,\n TKafkaReconnectErrorCallback,\n TKafkaStreamErrorCallback,\n} from './common/types';\n\n/**\n * Wrapper around `@platformatic/kafka` Consumer with lifecycle management, health tracking, graceful shutdown, message callbacks, and lag monitoring.\n *\n * Every member below is `protected`, not `private`, so a consumer extends this class instead of forking it. That visibility is not a stable contract between minor versions.\n */\nexport class KafkaConsumerHelper<\n KeyType = string,\n ValueType = string,\n HeaderKeyType = string,\n HeaderValueType = string,\n> extends BaseKafkaHelper<Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>> {\n protected stream: MessagesStream<KeyType, ValueType, HeaderKeyType, HeaderValueType> | null =\n null;\n protected consumeLoop: Promise<void> | null = null;\n protected consumeStartOptions: IKafkaConsumeStartOptions | null = null;\n protected lagMonitoringActive = false;\n protected lagMonitoringOptions: { topics: string[]; interval?: number } | null = null;\n protected sessionLikelyStale = false;\n\n protected readonly onMessage?: TKafkaMessageCallback<\n KeyType,\n ValueType,\n HeaderKeyType,\n HeaderValueType\n >;\n protected readonly onMessageDone?: TKafkaMessageDoneCallback<\n KeyType,\n ValueType,\n HeaderKeyType,\n HeaderValueType\n >;\n protected readonly onMessageError?: TKafkaMessageErrorCallback<\n KeyType,\n ValueType,\n HeaderKeyType,\n HeaderValueType\n >;\n protected readonly onStreamError?: TKafkaStreamErrorCallback;\n protected readonly onReconnectError?: TKafkaReconnectErrorCallback;\n\n protected readonly onGroupJoin?: TKafkaGroupJoinCallback;\n protected readonly onGroupLeave?: TKafkaGroupLeaveCallback;\n protected readonly onGroupRebalance?: TKafkaGroupRebalanceCallback;\n protected readonly onHeartbeatError?: TKafkaHeartbeatErrorCallback;\n\n protected readonly onLag?: TKafkaLagCallback;\n protected readonly onLagError?: TKafkaLagErrorCallback;\n\n protected readonly initialOptions: IKafkaConsumerOptions<\n KeyType,\n ValueType,\n HeaderKeyType,\n HeaderValueType\n >;\n\n constructor(opts: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>) {\n super({\n scope: KafkaConsumerHelper.name,\n identifier: opts.identifier ?? 'kafka-consumer',\n shutdownTimeout: opts.shutdownTimeout,\n client: KafkaConsumerHelper.buildConsumerClient(opts),\n onBrokerConnect: opts.onBrokerConnect,\n onBrokerDisconnect: opts.onBrokerDisconnect,\n });\n\n this.initialOptions = opts;\n this.onMessage = opts.onMessage;\n this.onMessageDone = opts.onMessageDone;\n this.onMessageError = opts.onMessageError;\n this.onStreamError = opts.onStreamError;\n this.onReconnectError = opts.onReconnectError;\n this.onGroupJoin = opts.onGroupJoin;\n this.onGroupLeave = opts.onGroupLeave;\n this.onGroupRebalance = opts.onGroupRebalance;\n this.onHeartbeatError = opts.onHeartbeatError;\n this.onLag = opts.onLag;\n this.onLagError = opts.onLagError;\n\n this.configureBrokerEvents();\n\n this.logger.info(\n '[constructor] Kafka Consumer CREATED | ClientId: %s | GroupId: %s | Brokers: %j',\n opts.clientId,\n opts.groupId,\n opts.bootstrapBrokers,\n );\n }\n\n static newInstance<\n KeyType = string,\n ValueType = string,\n HeaderKeyType = string,\n HeaderValueType = string,\n >(opts: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>) {\n return new KafkaConsumerHelper<KeyType, ValueType, HeaderKeyType, HeaderValueType>(opts);\n }\n\n /** The instance seam every rebuild goes through; the constructor alone uses the static factory because no instance exists yet. Override this to hand a rebuilt consumer different options or a test double. */\n protected buildClient(opts: {\n options: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n }): Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType> {\n return KafkaConsumerHelper.buildConsumerClient(opts.options);\n }\n\n protected static buildConsumerClient<\n KeyType = string,\n ValueType = string,\n HeaderKeyType = string,\n HeaderValueType = string,\n >(\n opts: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>,\n ): Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType> {\n return new Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>({\n clientId: opts.clientId,\n bootstrapBrokers: opts.bootstrapBrokers,\n sasl: opts.sasl,\n tls: opts.tls,\n ssl: opts.ssl,\n connectTimeout: opts.connectTimeout,\n requestTimeout: opts.requestTimeout,\n groupId: opts.groupId,\n groupInstanceId: opts.groupInstanceId,\n groupProtocol: opts.groupProtocol ?? KafkaDefaults.GROUP_PROTOCOL,\n deserializers: opts.deserializers,\n autocommit: opts.autocommit ?? KafkaDefaults.AUTOCOMMIT,\n sessionTimeout: opts.sessionTimeout ?? KafkaDefaults.SESSION_TIMEOUT,\n heartbeatInterval: opts.heartbeatInterval ?? KafkaDefaults.HEARTBEAT_INTERVAL,\n rebalanceTimeout:\n opts.rebalanceTimeout ?? opts.sessionTimeout ?? KafkaDefaults.SESSION_TIMEOUT,\n highWaterMark: opts.highWaterMark ?? KafkaDefaults.HIGH_WATER_MARK,\n minBytes: opts.minBytes ?? KafkaDefaults.MIN_BYTES,\n maxBytes: opts.maxBytes ?? KafkaDefaults.MAX_BYTES,\n maxWaitTime: opts.maxWaitTime ?? KafkaDefaults.MAX_WAIT_TIME,\n metadataMaxAge: opts.metadataMaxAge ?? KafkaDefaults.METADATA_MAX_AGE,\n retries: opts.retries ?? KafkaDefaults.RETRIES,\n retryDelay: opts.retryDelay ?? KafkaDefaults.RETRY_DELAY,\n registry: opts.registry,\n });\n }\n\n getConsumer(): Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType> {\n return this.client;\n }\n\n getStream(): MessagesStream<KeyType, ValueType, HeaderKeyType, HeaderValueType> | null {\n return this.stream;\n }\n\n override isReady(): boolean {\n return this.healthStatus === KafkaHealthStatuses.CONNECTED && this.client.isActive();\n }\n\n async start(opts: IKafkaConsumeStartOptions): Promise<void> {\n if (this.stream) {\n this.logger.warn('[start] Consumer already started, ignoring duplicate start call');\n return;\n }\n\n this.logger.info('[start] Starting consumer | Topics: %j', opts.topics);\n\n this.consumeStartOptions = opts;\n this.stream = await this.client.consume({\n topics: opts.topics,\n mode: opts.mode ?? KafkaDefaults.CONSUME_MODE,\n fallbackMode: opts.fallbackMode ?? KafkaDefaults.CONSUME_FALLBACK_MODE,\n });\n\n // Successful consume() means we're freshly joined to the group; clear any stale-session flag set during initial broker negotiation (e.g. a transient BROKER_DISCONNECT during bootstrap).\n this.sessionLikelyStale = false;\n\n // Always attached, hook or not: a stream 'error' with ZERO listeners is rethrown by EventEmitter as an uncaught exception, so a pull-style consumer (start() + getStream(), no onMessage/onMessageError) would take the whole process down on the first broker drop.\n const startedStream = this.stream;\n startedStream.on(KafkaClientEvents.STREAM_ERROR, (streamError: Error) => {\n this.logger.for('start').error('Kafka stream ERROR | Error: %s', streamError);\n this.reportStreamError({ error: streamError, scope: 'start', stream: startedStream });\n });\n\n if (this.onMessage) {\n const loop = this.startConsumeLoop({\n messageHandler: this.onMessage,\n doneHandler: this.onMessageDone,\n errorHandler: this.onMessageError,\n reconnectDelayMs: opts.reconnectDelayMs ?? KafkaDefaults.RECONNECT_DELAY,\n maxReconnectAttempts: opts.maxReconnectAttempts ?? KafkaDefaults.MAX_RECONNECT_ATTEMPTS,\n }).finally(() => {\n // A finished loop (exhausted reconnects or shutdown) no longer reports stream errors; the listeners take over.\n if (this.consumeLoop === loop) {\n this.consumeLoop = null;\n }\n });\n this.consumeLoop = loop;\n }\n\n this.logger.info('[start] Consumer started | Topics: %j', opts.topics);\n }\n\n startLagMonitoring(opts: { topics: string[]; interval?: number }): void {\n if (this.lagMonitoringActive) {\n this.logger.warn(\n '[startLagMonitoring] Lag monitoring already active, ignoring duplicate call',\n );\n return;\n }\n\n const interval = opts.interval ?? KafkaDefaults.LAG_MONITOR_INTERVAL;\n this.client.startLagMonitoring({ topics: opts.topics }, interval);\n this.lagMonitoringActive = true;\n this.lagMonitoringOptions = { topics: opts.topics, interval };\n\n this.logger.info(\n '[startLagMonitoring] Lag monitoring STARTED | Topics: %j | Interval: %dms',\n opts.topics,\n interval,\n );\n }\n\n stopLagMonitoring(): void {\n if (!this.lagMonitoringActive) {\n return;\n }\n\n this.client.stopLagMonitoring();\n this.lagMonitoringActive = false;\n this.lagMonitoringOptions = null;\n\n this.logger.info('[stopLagMonitoring] Lag monitoring STOPPED');\n }\n\n protected override closeClient(): Promise<void> {\n return this.closeClientWithCallback();\n }\n\n async close(opts?: { isForce?: boolean }): Promise<void> {\n const force = opts?.isForce ?? false;\n\n this.stopLagMonitoring();\n await this.closeStream();\n\n if (force) {\n await this.closeClient();\n } else {\n try {\n await this.gracefulCloseClient();\n } catch (error) {\n this.logger.warn('[close] Graceful shutdown timed out, forcing close | Error: %s', error);\n await this.closeClient();\n }\n }\n\n this.resetHealthState();\n this.logger.info('[close] Consumer closed | Force: %s', force);\n }\n\n protected async startConsumeLoop(opts: {\n messageHandler: TKafkaMessageCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n doneHandler?: TKafkaMessageDoneCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n reconnectDelayMs: number;\n maxReconnectAttempts: number;\n }): Promise<void> {\n const { messageHandler, doneHandler, errorHandler, reconnectDelayMs, maxReconnectAttempts } =\n opts;\n\n const messages = this.consumeMessages({\n reconnectDelayMs,\n maxReconnectAttempts,\n errorHandler,\n });\n for await (const message of messages) {\n try {\n await messageHandler({ message });\n await doneHandler?.({ message });\n } catch (error) {\n const normalizedError = toError(error);\n this.logger.error(\n '[startConsumeLoop] Message processing error: %s',\n normalizedError.message,\n );\n invokeHook({\n logger: this.logger,\n scope: 'startConsumeLoop',\n execution: () => errorHandler?.({ error: normalizedError, message }),\n });\n }\n }\n }\n\n protected async *consumeMessages(opts: {\n reconnectDelayMs: number;\n maxReconnectAttempts: number;\n errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n }) {\n const { reconnectDelayMs, maxReconnectAttempts, errorHandler } = opts;\n let consecutiveErrors = 0;\n\n while (true) {\n if (this.stream) {\n yield* this.drainStream({ errorHandler });\n }\n\n if (!this.consumeStartOptions) {\n this.logger.info('[consumeMessages] Shutdown requested, exiting consume loop');\n return;\n }\n\n consecutiveErrors++;\n if (consecutiveErrors > maxReconnectAttempts) {\n this.logger.error(\n '[consumeMessages] All %d reconnect attempts exhausted | Topics: %j',\n maxReconnectAttempts,\n this.consumeStartOptions?.topics,\n );\n return;\n }\n\n await this.attemptReconnect({\n attempt: consecutiveErrors,\n maxAttempts: maxReconnectAttempts,\n delayMs: reconnectDelayMs,\n errorHandler,\n });\n\n if (!this.consumeStartOptions) {\n this.logger.info(\n '[consumeMessages] Shutdown requested during reconnect, exiting consume loop',\n );\n return;\n }\n\n if (this.stream) {\n consecutiveErrors = 0;\n }\n }\n }\n\n /** Silent only while the consume loop is alive AND the erroring stream is the one it drains - the iterator then reports the same error once. A dead or replaced stream, or pull mode, reports here. */\n protected reportStreamError(opts: { error: Error; scope: string; stream: unknown }): void {\n if (this.consumeLoop && this.stream === opts.stream) {\n return;\n }\n\n invokeHook({\n logger: this.logger,\n scope: opts.scope,\n execution: () =>\n this.onStreamError\n ? this.onStreamError({ error: opts.error })\n : this.onMessageError?.({ error: opts.error }),\n });\n }\n\n protected async *drainStream(opts: {\n errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n }) {\n this.logger.debug('[drainStream] Consuming | Topics: %j', this.consumeStartOptions?.topics);\n\n try {\n yield* this.stream!;\n this.logger.warn(\n '[drainStream] Stream ended normally | Topics: %j',\n this.consumeStartOptions?.topics,\n );\n } catch (error) {\n const normalizedError = toError(error);\n this.logger.error(\n '[drainStream] Stream error: %s | Topics: %j',\n normalizedError.message,\n this.consumeStartOptions?.topics,\n );\n invokeHook({\n logger: this.logger,\n scope: 'drainStream',\n execution: () =>\n this.onStreamError\n ? this.onStreamError({ error: normalizedError })\n : opts.errorHandler?.({ error: normalizedError }),\n });\n }\n\n this.destroyDeadStream();\n }\n\n protected async attemptReconnect(opts: {\n attempt: number;\n maxAttempts: number;\n delayMs: number;\n errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n }): Promise<void> {\n const { attempt, maxAttempts, delayMs, errorHandler } = opts;\n\n this.logger.info(\n '[attemptReconnect] Reconnecting %d/%d in %dms | Topics: %j | ConnectedBrokers: %d',\n attempt,\n maxAttempts,\n delayMs,\n this.consumeStartOptions?.topics,\n this.getConnectedBrokerCount(),\n );\n await sleep(delayMs);\n\n if (!this.consumeStartOptions) {\n return;\n }\n\n const shouldRebuildClient = this.sessionLikelyStale;\n\n if (shouldRebuildClient) {\n this.logger.warn(\n '[attemptReconnect] Session stale flag is set, will rebuild client | Attempt: %d',\n attempt,\n );\n }\n\n if (shouldRebuildClient) {\n try {\n await this.rebuildClient();\n this.sessionLikelyStale = false;\n } catch (error) {\n const normalizedError = toError(error);\n this.logger.error(\n '[attemptReconnect] Client rebuild failed (%d/%d): %s | Topics: %j',\n attempt,\n maxAttempts,\n normalizedError.message,\n this.consumeStartOptions?.topics,\n );\n invokeHook({\n logger: this.logger,\n scope: 'attemptReconnect',\n execution: () =>\n this.onReconnectError\n ? this.onReconnectError({ error: normalizedError, attempt, maxAttempts })\n : errorHandler?.({ error: normalizedError }),\n });\n return;\n }\n }\n\n try {\n this.stream = await this.client.consume({\n topics: this.consumeStartOptions.topics,\n mode: this.consumeStartOptions.mode ?? KafkaDefaults.CONSUME_MODE,\n fallbackMode: this.consumeStartOptions.fallbackMode ?? KafkaDefaults.CONSUME_FALLBACK_MODE,\n });\n\n // Always attached, hook or not, like the listener in start(): a stream 'error' with ZERO listeners is rethrown by EventEmitter and takes the process down.\n const reconnectedStream = this.stream;\n reconnectedStream.on(KafkaClientEvents.STREAM_ERROR, (streamError: Error) => {\n this.logger.for('attemptReconnect').error('Kafka stream ERROR | Error: %s', streamError);\n this.reportStreamError({\n error: streamError,\n scope: 'attemptReconnect',\n stream: reconnectedStream,\n });\n });\n\n this.sessionLikelyStale = false;\n\n this.logger.info(\n '[attemptReconnect] Reconnected successfully | Topics: %j | Attempt: %d | Rebuilt: %s',\n this.consumeStartOptions.topics,\n attempt,\n shouldRebuildClient,\n );\n } catch (error) {\n const normalizedError = toError(error);\n this.logger.error(\n '[attemptReconnect] Failed (%d/%d): %s | Topics: %j | ConnectedBrokers: %d',\n attempt,\n maxAttempts,\n normalizedError.message,\n this.consumeStartOptions?.topics,\n this.getConnectedBrokerCount(),\n );\n invokeHook({\n logger: this.logger,\n scope: 'attemptReconnect',\n execution: () =>\n this.onReconnectError\n ? this.onReconnectError({ error: normalizedError, attempt, maxAttempts })\n : errorHandler?.({ error: normalizedError }),\n });\n }\n }\n\n protected async rebuildClient(): Promise<void> {\n this.logger.warn(\n '[rebuildClient] All brokers were disconnected; rebuilding @platformatic/kafka ' +\n 'Consumer to force a clean group rejoin (cached session state is stale)',\n );\n\n const oldClient = this.client;\n const newClient = this.buildClient({ options: this.initialOptions });\n\n this.swapClient(newClient);\n\n if (this.lagMonitoringOptions) {\n const opts = this.lagMonitoringOptions;\n this.lagMonitoringActive = false; // reset so startLagMonitoring won't refuse\n try {\n this.startLagMonitoring(opts);\n this.logger.info(\n '[rebuildClient] Lag monitoring re-armed on new client | Topics: %j',\n opts.topics,\n );\n } catch (error) {\n this.logger.warn(\n '[rebuildClient] Failed to restart lag monitoring on new client | Error: %s',\n toError(error).message,\n );\n }\n }\n\n this.closeOldClient(oldClient).catch(error => {\n this.logger.warn(\n '[rebuildClient] background close of old client failed (ignored) | Error: %s',\n toError(error).message,\n );\n });\n }\n\n protected async closeOldClient(\n oldClient: Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>,\n ): Promise<void> {\n let timeoutHandle: NodeJS.Timeout | null = null;\n try {\n await Promise.race([\n new Promise<void>((resolve, reject) => {\n oldClient.close(true, (normalizedError?: Error | null) => {\n if (normalizedError) {\n reject(normalizedError);\n } else {\n resolve();\n }\n });\n }),\n new Promise<void>(resolve => {\n timeoutHandle = setTimeout(resolve, this.shutdownTimeout);\n }),\n ]);\n } finally {\n if (timeoutHandle !== null) {\n clearTimeout(timeoutHandle);\n }\n }\n }\n\n protected handleAllBrokersDown(reason: 'disconnected' | 'failed'): void {\n if (this.getConnectedBrokerCount() !== 0) {\n return;\n }\n this.sessionLikelyStale = true;\n if (this.stream) {\n this.logger.warn(\n '[configureBrokerEvents] All brokers %s, destroying stream to trigger reconnect',\n reason,\n );\n this.destroyDeadStream();\n }\n }\n\n protected destroyDeadStream(): void {\n this.stream?.destroy(getError({ message: '[destroyDeadStream] All brokers disconnected' }));\n this.stream = null;\n }\n\n protected async closeStream(): Promise<void> {\n const stream = this.stream;\n this.stream = null;\n this.consumeStartOptions = null;\n\n try {\n await stream?.close();\n } catch (error) {\n this.logger.warn('[closeStream] Error closing stream: %s', toError(error).message);\n }\n\n await this.consumeLoop;\n this.consumeLoop = null;\n }\n\n protected override unconfigureBrokerEvents(): void {\n super.unconfigureBrokerEvents();\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_GROUP_JOIN);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_GROUP_LEAVE);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_GROUP_REBALANCE);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_HEARTBEAT_ERROR);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_LAG);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_LAG_ERROR);\n }\n\n protected override configureBrokerEvents(): void {\n super.configureBrokerEvents();\n\n this.client.on(KafkaClientEvents.BROKER_DISCONNECT, () => {\n this.handleAllBrokersDown('disconnected');\n });\n this.client.on(KafkaClientEvents.BROKER_FAILED, () => {\n this.handleAllBrokersDown('failed');\n });\n\n this.client.on(KafkaClientEvents.CONSUMER_GROUP_JOIN, (payload: ConsumerGroupJoinPayload) => {\n this.logger.info(\n '[configureConsumerEvents] Group JOINED | GroupId: %s | MemberId: %s | GenerationId: %d',\n payload.groupId,\n payload.memberId,\n payload.generationId,\n );\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () =>\n this.onGroupJoin?.({\n groupId: payload.groupId,\n memberId: payload.memberId,\n generationId: payload.generationId,\n }),\n });\n });\n\n this.client.on(KafkaClientEvents.CONSUMER_GROUP_LEAVE, (payload: ConsumerGroupLeavePayload) => {\n this.logger.info(\n '[configureConsumerEvents] Group LEFT | GroupId: %s | MemberId: %s',\n payload.groupId,\n payload.memberId,\n );\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () =>\n this.onGroupLeave?.({\n groupId: payload.groupId,\n memberId: payload.memberId,\n }),\n });\n });\n\n this.client.on(\n KafkaClientEvents.CONSUMER_GROUP_REBALANCE,\n (payload: ConsumerGroupRebalancePayload) => {\n this.logger.info(\n '[configureConsumerEvents] Group REBALANCE | GroupId: %s',\n payload.groupId,\n );\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () => this.onGroupRebalance?.({ groupId: payload.groupId }),\n });\n },\n );\n\n this.client.on(\n KafkaClientEvents.CONSUMER_HEARTBEAT_ERROR,\n (payload: ConsumerHeartbeatErrorPayload) => {\n this.logger.error(\n '[configureConsumerEvents] Heartbeat ERROR | GroupId: %s | MemberId: %s | Error: %s',\n payload.groupId,\n payload.memberId,\n payload.error,\n );\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () =>\n this.onHeartbeatError?.({\n error: payload.error,\n groupId: payload.groupId,\n memberId: payload.memberId,\n }),\n });\n },\n );\n\n this.client.on(KafkaClientEvents.CONSUMER_LAG, (lag: Offsets) => {\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () => this.onLag?.({ lag }),\n });\n });\n\n this.client.on(KafkaClientEvents.CONSUMER_LAG_ERROR, (error: Error) => {\n this.logger.error('[configureConsumerEvents] Lag monitoring ERROR: %s', error);\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () => this.onLagError?.({ error }),\n });\n });\n }\n}\n"]}
1
+ {"version":3,"file":"consumer.js","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/consumer.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@/modules/error';\nimport { sleep } from '@/utilities/sleep.utility';\nimport { toError } from '@/utilities/promise.utility';\nimport type {\n ConsumerGroupJoinPayload,\n ConsumerGroupLeavePayload,\n ConsumerGroupRebalancePayload,\n ConsumerHeartbeatErrorPayload,\n MessagesStream,\n Offsets,\n} from '@platformatic/kafka';\nimport { Consumer } from '@platformatic/kafka';\nimport { invokeHook } from '../common';\nimport { BaseKafkaHelper } from './base';\nimport { KafkaClientEvents, KafkaDefaults, KafkaHealthStatuses } from './common/constants';\nimport type {\n IKafkaConsumeStartOptions,\n IKafkaConsumerOptions,\n TKafkaGroupJoinCallback,\n TKafkaGroupLeaveCallback,\n TKafkaGroupRebalanceCallback,\n TKafkaHeartbeatErrorCallback,\n TKafkaLagCallback,\n TKafkaLagErrorCallback,\n TKafkaMessageCallback,\n TKafkaMessageDoneCallback,\n TKafkaMessageErrorCallback,\n TKafkaReconnectErrorCallback,\n TKafkaStreamErrorCallback,\n} from './common/types';\n\n/**\n * Wrapper around `@platformatic/kafka` Consumer with lifecycle management, health tracking, graceful shutdown, message callbacks, and lag monitoring.\n *\n * Every member below is `protected`, not `private`, so a consumer extends this class instead of forking it. That visibility is not a stable contract between minor versions.\n */\nexport class KafkaConsumerHelper<\n KeyType = string,\n ValueType = string,\n HeaderKeyType = string,\n HeaderValueType = string,\n> extends BaseKafkaHelper<Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>> {\n protected stream: MessagesStream<KeyType, ValueType, HeaderKeyType, HeaderValueType> | null =\n null;\n protected consumeLoop: Promise<void> | null = null;\n protected consumeStartOptions: IKafkaConsumeStartOptions | null = null;\n protected lagMonitoringActive = false;\n protected lagMonitoringOptions: { topics: string[]; interval?: number } | null = null;\n protected sessionLikelyStale = false;\n\n protected readonly onMessage?: TKafkaMessageCallback<\n KeyType,\n ValueType,\n HeaderKeyType,\n HeaderValueType\n >;\n protected readonly onMessageDone?: TKafkaMessageDoneCallback<\n KeyType,\n ValueType,\n HeaderKeyType,\n HeaderValueType\n >;\n protected readonly onMessageError?: TKafkaMessageErrorCallback<\n KeyType,\n ValueType,\n HeaderKeyType,\n HeaderValueType\n >;\n protected readonly onStreamError?: TKafkaStreamErrorCallback;\n protected readonly onReconnectError?: TKafkaReconnectErrorCallback;\n\n protected readonly onGroupJoin?: TKafkaGroupJoinCallback;\n protected readonly onGroupLeave?: TKafkaGroupLeaveCallback;\n protected readonly onGroupRebalance?: TKafkaGroupRebalanceCallback;\n protected readonly onHeartbeatError?: TKafkaHeartbeatErrorCallback;\n\n protected readonly onLag?: TKafkaLagCallback;\n protected readonly onLagError?: TKafkaLagErrorCallback;\n\n protected readonly initialOptions: IKafkaConsumerOptions<\n KeyType,\n ValueType,\n HeaderKeyType,\n HeaderValueType\n >;\n\n constructor(opts: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>) {\n super({\n scope: KafkaConsumerHelper.name,\n identifier: opts.identifier ?? 'kafka-consumer',\n shutdownTimeout: opts.shutdownTimeout,\n client: KafkaConsumerHelper.buildConsumerClient(opts),\n onBrokerConnect: opts.onBrokerConnect,\n onBrokerDisconnect: opts.onBrokerDisconnect,\n });\n\n this.initialOptions = opts;\n this.onMessage = opts.onMessage;\n this.onMessageDone = opts.onMessageDone;\n this.onMessageError = opts.onMessageError;\n this.onStreamError = opts.onStreamError;\n this.onReconnectError = opts.onReconnectError;\n this.onGroupJoin = opts.onGroupJoin;\n this.onGroupLeave = opts.onGroupLeave;\n this.onGroupRebalance = opts.onGroupRebalance;\n this.onHeartbeatError = opts.onHeartbeatError;\n this.onLag = opts.onLag;\n this.onLagError = opts.onLagError;\n\n this.configureBrokerEvents();\n\n this.logger.info(\n '[constructor] Kafka Consumer CREATED | ClientId: %s | GroupId: %s | Brokers: %j',\n opts.clientId,\n opts.groupId,\n opts.bootstrapBrokers,\n );\n }\n\n static newInstance<\n KeyType = string,\n ValueType = string,\n HeaderKeyType = string,\n HeaderValueType = string,\n >(opts: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>) {\n return new KafkaConsumerHelper<KeyType, ValueType, HeaderKeyType, HeaderValueType>(opts);\n }\n\n /** The instance seam every rebuild goes through; the constructor alone uses the static factory because no instance exists yet. Override this to hand a rebuilt consumer different options or a test double. */\n protected buildClient(opts: {\n options: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n }): Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType> {\n return KafkaConsumerHelper.buildConsumerClient(opts.options);\n }\n\n protected static buildConsumerClient<\n KeyType = string,\n ValueType = string,\n HeaderKeyType = string,\n HeaderValueType = string,\n >(\n opts: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>,\n ): Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType> {\n return new Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>({\n clientId: opts.clientId,\n bootstrapBrokers: opts.bootstrapBrokers,\n sasl: opts.sasl,\n tls: opts.tls,\n ssl: opts.ssl,\n connectTimeout: opts.connectTimeout,\n requestTimeout: opts.requestTimeout,\n groupId: opts.groupId,\n groupInstanceId: opts.groupInstanceId,\n groupProtocol: opts.groupProtocol ?? KafkaDefaults.GROUP_PROTOCOL,\n deserializers: opts.deserializers,\n autocommit: opts.autocommit ?? KafkaDefaults.AUTOCOMMIT,\n sessionTimeout: opts.sessionTimeout ?? KafkaDefaults.SESSION_TIMEOUT,\n heartbeatInterval: opts.heartbeatInterval ?? KafkaDefaults.HEARTBEAT_INTERVAL,\n rebalanceTimeout:\n opts.rebalanceTimeout ?? opts.sessionTimeout ?? KafkaDefaults.SESSION_TIMEOUT,\n highWaterMark: opts.highWaterMark ?? KafkaDefaults.HIGH_WATER_MARK,\n minBytes: opts.minBytes ?? KafkaDefaults.MIN_BYTES,\n maxBytes: opts.maxBytes ?? KafkaDefaults.MAX_BYTES,\n maxWaitTime: opts.maxWaitTime ?? KafkaDefaults.MAX_WAIT_TIME,\n metadataMaxAge: opts.metadataMaxAge ?? KafkaDefaults.METADATA_MAX_AGE,\n retries: opts.retries ?? KafkaDefaults.RETRIES,\n retryDelay: opts.retryDelay ?? KafkaDefaults.RETRY_DELAY,\n registry: opts.registry,\n });\n }\n\n getConsumer(): Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType> {\n return this.client;\n }\n\n getStream(): MessagesStream<KeyType, ValueType, HeaderKeyType, HeaderValueType> | null {\n return this.stream;\n }\n\n override isReady(): boolean {\n return this.healthStatus === KafkaHealthStatuses.CONNECTED && this.client.isActive();\n }\n\n async start(opts: IKafkaConsumeStartOptions): Promise<void> {\n if (this.stream) {\n this.logger.warn('[start] Consumer already started, ignoring duplicate start call');\n return;\n }\n\n this.logger.info('[start] Starting consumer | Topics: %j', opts.topics);\n\n this.consumeStartOptions = opts;\n this.stream = await this.client.consume({\n topics: opts.topics,\n mode: opts.mode ?? KafkaDefaults.CONSUME_MODE,\n fallbackMode: opts.fallbackMode ?? KafkaDefaults.CONSUME_FALLBACK_MODE,\n });\n\n // Successful consume() means we're freshly joined to the group; clear any stale-session flag set during initial broker negotiation (e.g. a transient BROKER_DISCONNECT during bootstrap).\n this.sessionLikelyStale = false;\n\n // Always attached, hook or not: a stream 'error' with ZERO listeners is rethrown by EventEmitter as an uncaught exception, so a pull-style consumer (start() + getStream(), no onMessage/onMessageError) would take the whole process down on the first broker drop.\n const startedStream = this.stream;\n startedStream.on(KafkaClientEvents.STREAM_ERROR, (streamError: Error) => {\n this.logger.for('start').error('Kafka stream ERROR | Error: %s', streamError);\n this.reportStreamError({ error: streamError, scope: 'start', stream: startedStream });\n });\n\n if (this.onMessage) {\n const loop = this.startConsumeLoop({\n messageHandler: this.onMessage,\n doneHandler: this.onMessageDone,\n errorHandler: this.onMessageError,\n reconnectDelayMs: opts.reconnectDelayMs ?? KafkaDefaults.RECONNECT_DELAY,\n maxReconnectAttempts: opts.maxReconnectAttempts ?? KafkaDefaults.MAX_RECONNECT_ATTEMPTS,\n }).finally(() => {\n // A finished loop (exhausted reconnects or shutdown) no longer reports stream errors; the listeners take over.\n if (this.consumeLoop === loop) {\n this.consumeLoop = null;\n }\n });\n this.consumeLoop = loop;\n }\n\n this.logger.info('[start] Consumer started | Topics: %j', opts.topics);\n }\n\n startLagMonitoring(opts: { topics: string[]; interval?: number }): void {\n if (this.lagMonitoringActive) {\n this.logger.warn(\n '[startLagMonitoring] Lag monitoring already active, ignoring duplicate call',\n );\n return;\n }\n\n const interval = opts.interval ?? KafkaDefaults.LAG_MONITOR_INTERVAL;\n this.client.startLagMonitoring({ topics: opts.topics }, interval);\n this.lagMonitoringActive = true;\n this.lagMonitoringOptions = { topics: opts.topics, interval };\n\n this.logger.info(\n '[startLagMonitoring] Lag monitoring STARTED | Topics: %j | Interval: %dms',\n opts.topics,\n interval,\n );\n }\n\n stopLagMonitoring(): void {\n if (!this.lagMonitoringActive) {\n return;\n }\n\n this.client.stopLagMonitoring();\n this.lagMonitoringActive = false;\n this.lagMonitoringOptions = null;\n\n this.logger.info('[stopLagMonitoring] Lag monitoring STOPPED');\n }\n\n protected override closeClient(): Promise<void> {\n return this.closeClientWithCallback();\n }\n\n async close(opts?: { isForce?: boolean }): Promise<void> {\n const force = opts?.isForce ?? false;\n\n this.stopLagMonitoring();\n await this.closeStream();\n\n if (force) {\n await this.closeClient();\n } else {\n try {\n await this.gracefulCloseClient();\n } catch (error) {\n this.logger.warn('[close] Graceful shutdown timed out, forcing close | Error: %s', error);\n await this.closeClient();\n }\n }\n\n this.resetHealthState();\n this.logger.info('[close] Consumer closed | Force: %s', force);\n }\n\n protected async startConsumeLoop(opts: {\n messageHandler: TKafkaMessageCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n doneHandler?: TKafkaMessageDoneCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n reconnectDelayMs: number;\n maxReconnectAttempts: number;\n }): Promise<void> {\n const { messageHandler, doneHandler, errorHandler, reconnectDelayMs, maxReconnectAttempts } =\n opts;\n\n const messages = this.consumeMessages({\n reconnectDelayMs,\n maxReconnectAttempts,\n errorHandler,\n });\n for await (const message of messages) {\n try {\n await messageHandler({ message });\n await doneHandler?.({ message });\n } catch (error) {\n const normalizedError = toError(error);\n this.logger.error(\n '[startConsumeLoop] Message processing error: %s',\n normalizedError.message,\n );\n invokeHook({\n logger: this.logger,\n scope: 'startConsumeLoop',\n execution: () => errorHandler?.({ error: normalizedError, message }),\n });\n }\n }\n }\n\n protected async *consumeMessages(opts: {\n reconnectDelayMs: number;\n maxReconnectAttempts: number;\n errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n }) {\n const { reconnectDelayMs, maxReconnectAttempts, errorHandler } = opts;\n let consecutiveErrors = 0;\n\n while (true) {\n if (this.stream) {\n yield* this.drainStream({ errorHandler });\n }\n\n if (!this.consumeStartOptions) {\n this.logger.info('[consumeMessages] Shutdown requested, exiting consume loop');\n return;\n }\n\n consecutiveErrors++;\n if (consecutiveErrors > maxReconnectAttempts) {\n this.logger.error(\n '[consumeMessages] All %d reconnect attempts exhausted | Topics: %j',\n maxReconnectAttempts,\n this.consumeStartOptions?.topics,\n );\n return;\n }\n\n await this.attemptReconnect({\n attempt: consecutiveErrors,\n maxAttempts: maxReconnectAttempts,\n delayMs: reconnectDelayMs,\n errorHandler,\n });\n\n if (!this.consumeStartOptions) {\n this.logger.info(\n '[consumeMessages] Shutdown requested during reconnect, exiting consume loop',\n );\n return;\n }\n\n if (this.stream) {\n consecutiveErrors = 0;\n }\n }\n }\n\n /** Silent only while the consume loop is alive AND the erroring stream is the one it drains - the iterator then reports the same error once. A dead or replaced stream, or pull mode, reports here. */\n protected reportStreamError(opts: { error: Error; scope: string; stream: unknown }): void {\n if (this.consumeLoop && this.stream === opts.stream) {\n return;\n }\n\n invokeHook({\n logger: this.logger,\n scope: opts.scope,\n execution: () =>\n this.onStreamError\n ? this.onStreamError({ error: opts.error })\n : this.onMessageError?.({ error: opts.error }),\n });\n }\n\n protected async *drainStream(opts: {\n errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n }) {\n this.logger.debug('[drainStream] Consuming | Topics: %j', this.consumeStartOptions?.topics);\n\n try {\n yield* this.stream!;\n this.logger.warn(\n '[drainStream] Stream ended normally | Topics: %j',\n this.consumeStartOptions?.topics,\n );\n } catch (error) {\n const normalizedError = toError(error);\n this.logger.error(\n '[drainStream] Stream error: %s | Topics: %j',\n normalizedError.message,\n this.consumeStartOptions?.topics,\n );\n invokeHook({\n logger: this.logger,\n scope: 'drainStream',\n execution: () =>\n this.onStreamError\n ? this.onStreamError({ error: normalizedError })\n : opts.errorHandler?.({ error: normalizedError }),\n });\n }\n\n this.destroyDeadStream();\n }\n\n protected async attemptReconnect(opts: {\n attempt: number;\n maxAttempts: number;\n delayMs: number;\n errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;\n }): Promise<void> {\n const { attempt, maxAttempts, delayMs, errorHandler } = opts;\n\n this.logger.info(\n '[attemptReconnect] Reconnecting %d/%d in %dms | Topics: %j | ConnectedBrokers: %d',\n attempt,\n maxAttempts,\n delayMs,\n this.consumeStartOptions?.topics,\n this.getConnectedBrokerCount(),\n );\n await sleep(delayMs);\n\n if (!this.consumeStartOptions) {\n return;\n }\n\n const shouldRebuildClient = this.sessionLikelyStale;\n\n if (shouldRebuildClient) {\n this.logger.warn(\n '[attemptReconnect] Session stale flag is set, will rebuild client | Attempt: %d',\n attempt,\n );\n }\n\n if (shouldRebuildClient) {\n try {\n await this.rebuildClient();\n this.sessionLikelyStale = false;\n } catch (error) {\n const normalizedError = toError(error);\n this.logger.error(\n '[attemptReconnect] Client rebuild failed (%d/%d): %s | Topics: %j',\n attempt,\n maxAttempts,\n normalizedError.message,\n this.consumeStartOptions?.topics,\n );\n invokeHook({\n logger: this.logger,\n scope: 'attemptReconnect',\n execution: () =>\n this.onReconnectError\n ? this.onReconnectError({ error: normalizedError, attempt, maxAttempts })\n : errorHandler?.({ error: normalizedError }),\n });\n return;\n }\n }\n\n try {\n this.stream = await this.client.consume({\n topics: this.consumeStartOptions.topics,\n mode: this.consumeStartOptions.mode ?? KafkaDefaults.CONSUME_MODE,\n fallbackMode: this.consumeStartOptions.fallbackMode ?? KafkaDefaults.CONSUME_FALLBACK_MODE,\n });\n\n // Always attached, hook or not, like the listener in start(): a stream 'error' with ZERO listeners is rethrown by EventEmitter and takes the process down.\n const reconnectedStream = this.stream;\n reconnectedStream.on(KafkaClientEvents.STREAM_ERROR, (streamError: Error) => {\n this.logger.for('attemptReconnect').error('Kafka stream ERROR | Error: %s', streamError);\n this.reportStreamError({\n error: streamError,\n scope: 'attemptReconnect',\n stream: reconnectedStream,\n });\n });\n\n this.sessionLikelyStale = false;\n\n this.logger.info(\n '[attemptReconnect] Reconnected successfully | Topics: %j | Attempt: %d | Rebuilt: %s',\n this.consumeStartOptions.topics,\n attempt,\n shouldRebuildClient,\n );\n } catch (error) {\n const normalizedError = toError(error);\n this.logger.error(\n '[attemptReconnect] Failed (%d/%d): %s | Topics: %j | ConnectedBrokers: %d',\n attempt,\n maxAttempts,\n normalizedError.message,\n this.consumeStartOptions?.topics,\n this.getConnectedBrokerCount(),\n );\n invokeHook({\n logger: this.logger,\n scope: 'attemptReconnect',\n execution: () =>\n this.onReconnectError\n ? this.onReconnectError({ error: normalizedError, attempt, maxAttempts })\n : errorHandler?.({ error: normalizedError }),\n });\n }\n }\n\n protected async rebuildClient(): Promise<void> {\n this.logger.warn(\n '[rebuildClient] All brokers were disconnected; rebuilding @platformatic/kafka ' +\n 'Consumer to force a clean group rejoin (cached session state is stale)',\n );\n\n const oldClient = this.client;\n const newClient = this.buildClient({ options: this.initialOptions });\n\n this.swapClient(newClient);\n\n if (this.lagMonitoringOptions) {\n const opts = this.lagMonitoringOptions;\n this.lagMonitoringActive = false; // reset so startLagMonitoring won't refuse\n try {\n this.startLagMonitoring(opts);\n this.logger.info(\n '[rebuildClient] Lag monitoring re-armed on new client | Topics: %j',\n opts.topics,\n );\n } catch (error) {\n this.logger.warn(\n '[rebuildClient] Failed to restart lag monitoring on new client | Error: %s',\n toError(error).message,\n );\n }\n }\n\n this.closeOldClient(oldClient).catch((error) => {\n this.logger.warn(\n '[rebuildClient] background close of old client failed (ignored) | Error: %s',\n toError(error).message,\n );\n });\n }\n\n protected async closeOldClient(\n oldClient: Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>,\n ): Promise<void> {\n let timeoutHandle: NodeJS.Timeout | null = null;\n try {\n await Promise.race([\n new Promise<void>((resolve, reject) => {\n oldClient.close(true, (normalizedError?: Error | null) => {\n if (normalizedError) {\n reject(normalizedError);\n } else {\n resolve();\n }\n });\n }),\n new Promise<void>((resolve) => {\n timeoutHandle = setTimeout(resolve, this.shutdownTimeout);\n }),\n ]);\n } finally {\n if (timeoutHandle !== null) {\n clearTimeout(timeoutHandle);\n }\n }\n }\n\n protected handleAllBrokersDown(reason: 'disconnected' | 'failed'): void {\n if (this.getConnectedBrokerCount() !== 0) {\n return;\n }\n this.sessionLikelyStale = true;\n if (this.stream) {\n this.logger.warn(\n '[configureBrokerEvents] All brokers %s, destroying stream to trigger reconnect',\n reason,\n );\n this.destroyDeadStream();\n }\n }\n\n protected destroyDeadStream(): void {\n this.stream?.destroy(getError({ message: '[destroyDeadStream] All brokers disconnected' }));\n this.stream = null;\n }\n\n protected async closeStream(): Promise<void> {\n const stream = this.stream;\n this.stream = null;\n this.consumeStartOptions = null;\n\n try {\n await stream?.close();\n } catch (error) {\n this.logger.warn('[closeStream] Error closing stream: %s', toError(error).message);\n }\n\n await this.consumeLoop;\n this.consumeLoop = null;\n }\n\n protected override unconfigureBrokerEvents(): void {\n super.unconfigureBrokerEvents();\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_GROUP_JOIN);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_GROUP_LEAVE);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_GROUP_REBALANCE);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_HEARTBEAT_ERROR);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_LAG);\n this.client.removeAllListeners(KafkaClientEvents.CONSUMER_LAG_ERROR);\n }\n\n protected override configureBrokerEvents(): void {\n super.configureBrokerEvents();\n\n this.client.on(KafkaClientEvents.BROKER_DISCONNECT, () => {\n this.handleAllBrokersDown('disconnected');\n });\n this.client.on(KafkaClientEvents.BROKER_FAILED, () => {\n this.handleAllBrokersDown('failed');\n });\n\n this.client.on(KafkaClientEvents.CONSUMER_GROUP_JOIN, (payload: ConsumerGroupJoinPayload) => {\n this.logger.info(\n '[configureConsumerEvents] Group JOINED | GroupId: %s | MemberId: %s | GenerationId: %d',\n payload.groupId,\n payload.memberId,\n payload.generationId,\n );\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () =>\n this.onGroupJoin?.({\n groupId: payload.groupId,\n memberId: payload.memberId,\n generationId: payload.generationId,\n }),\n });\n });\n\n this.client.on(KafkaClientEvents.CONSUMER_GROUP_LEAVE, (payload: ConsumerGroupLeavePayload) => {\n this.logger.info(\n '[configureConsumerEvents] Group LEFT | GroupId: %s | MemberId: %s',\n payload.groupId,\n payload.memberId,\n );\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () =>\n this.onGroupLeave?.({\n groupId: payload.groupId,\n memberId: payload.memberId,\n }),\n });\n });\n\n this.client.on(\n KafkaClientEvents.CONSUMER_GROUP_REBALANCE,\n (payload: ConsumerGroupRebalancePayload) => {\n this.logger.info(\n '[configureConsumerEvents] Group REBALANCE | GroupId: %s',\n payload.groupId,\n );\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () => this.onGroupRebalance?.({ groupId: payload.groupId }),\n });\n },\n );\n\n this.client.on(\n KafkaClientEvents.CONSUMER_HEARTBEAT_ERROR,\n (payload: ConsumerHeartbeatErrorPayload) => {\n this.logger.error(\n '[configureConsumerEvents] Heartbeat ERROR | GroupId: %s | MemberId: %s | Error: %s',\n payload.groupId,\n payload.memberId,\n payload.error,\n );\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () =>\n this.onHeartbeatError?.({\n error: payload.error,\n groupId: payload.groupId,\n memberId: payload.memberId,\n }),\n });\n },\n );\n\n this.client.on(KafkaClientEvents.CONSUMER_LAG, (lag: Offsets) => {\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () => this.onLag?.({ lag }),\n });\n });\n\n this.client.on(KafkaClientEvents.CONSUMER_LAG_ERROR, (error: Error) => {\n this.logger.error('[configureConsumerEvents] Lag monitoring ERROR: %s', error);\n invokeHook({\n logger: this.logger,\n scope: 'configureBrokerEvents',\n execution: () => this.onLagError?.({ error }),\n });\n });\n }\n}\n"]}
@@ -56,7 +56,7 @@ export class MQTTClientHelper extends BaseHelper {
56
56
  execution: () => this.onMessage?.({ topic, message }),
57
57
  });
58
58
  });
59
- this.client.on('error', error => {
59
+ this.client.on('error', (error) => {
60
60
  invokeHook({
61
61
  logger: this.logger,
62
62
  scope: 'onError',
@@ -86,7 +86,7 @@ export class MQTTClientHelper extends BaseHelper {
86
86
  return Promise.resolve();
87
87
  }
88
88
  const isForce = opts?.isForce ?? false;
89
- return new Promise(resolve => {
89
+ return new Promise((resolve) => {
90
90
  client.end(isForce, undefined, () => {
91
91
  this.logger.for(this.close.name).info('[%s] MQTT Client closed!', this.identifier);
92
92
  resolve();
@@ -103,7 +103,7 @@ export class MQTTClientHelper extends BaseHelper {
103
103
  }));
104
104
  }
105
105
  const { topics } = opts;
106
- client.subscribe(topics, error => {
106
+ client.subscribe(topics, (error) => {
107
107
  if (error) {
108
108
  return reject(error);
109
109
  }
@@ -121,7 +121,7 @@ export class MQTTClientHelper extends BaseHelper {
121
121
  }));
122
122
  }
123
123
  const { topic, message } = opts;
124
- client.publish(topic, message, error => {
124
+ client.publish(topic, message, (error) => {
125
125
  if (error) {
126
126
  return reject(error);
127
127
  }
@@ -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 { isEmpty } from '@venizia/ignis-inversion';\nimport { redactSecrets, redactUrlCredentials } from '@/common/redact';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport mqtt from 'mqtt';\nimport { invokeHook } 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 return;\n }\n\n if (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 redactUrlCredentials(this.url),\n redactSecrets(this.options),\n );\n this.client = this.createClient({ url: this.url, options: this.options });\n\n this.client.on('connect', () => {\n invokeHook({\n logger: this.logger,\n scope: 'onConnect',\n execution: () => this.onConnect?.(),\n });\n });\n\n this.client.on('disconnect', () => {\n invokeHook({\n logger: this.logger,\n scope: 'onDisconnect',\n execution: () => this.onDisconnect?.(),\n });\n });\n\n this.client.on('message', (topic, message) => {\n invokeHook({\n logger: this.logger,\n scope: 'onMessage',\n execution: () => this.onMessage?.({ topic, message }),\n });\n });\n\n this.client.on('error', error => {\n invokeHook({\n logger: this.logger,\n scope: 'onError',\n execution: () => this.onError?.(error),\n });\n });\n\n this.client.on('close', (error?: Error) => {\n invokeHook({\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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAavC,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAW9C,YAAY,IAAwB;QAClC,KAAK,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAErE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,uFAAuF;YACvF,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;iBACxB,IAAI,CACH,sDAAsD,EACtD,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,MAAM,CAAC,SAAS,CACtB,CAAC;YACJ,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YACjC,MAAM,QAAQ,CAAC;gBACb,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;gBACrD,OAAO,EAAE,mDAAmD;aAC7D,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aACxB,IAAI,CACH,4DAA4D,EAC5D,IAAI,CAAC,UAAU,EACf,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAC9B,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAC5B,CAAC;QACJ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAE1E,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YAC7B,UAAU,CAAC;gBACT,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,WAAW;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE;aACpC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;YAChC,UAAU,CAAC;gBACT,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,cAAc;gBACrB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE;aACvC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC3C,UAAU,CAAC;gBACT,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,WAAW;gBAClB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;aACtD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,UAAU,CAAC;gBACT,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,SAAS;gBAChB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC;aACvC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,UAAU,CAAC;gBACT,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,SAAS;gBAChB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC;aACvC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oFAAoF;IAC1E,YAAY,CAAC,IAAmD;QACxE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,mMAAmM;IACnM,KAAK,CAAC,IAA4B;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAExB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;QAEvC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE;gBAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;gBACnF,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,IAA+B;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;gBACvB,OAAO,MAAM,CACX,QAAQ,CAAC;oBACP,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;oBAC5C,OAAO,EAAE,eAAe,IAAI,CAAC,UAAU,oDAAoD;iBAC5F,CAAC,CACH,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;YACxB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjC,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;gBAED,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAiD;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;gBACvB,OAAO,MAAM,CACX,QAAQ,CAAC;oBACP,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;oBAC5C,OAAO,EAAE,aAAa,IAAI,CAAC,UAAU,oDAAoD;iBAC1F,CAAC,CACH,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;YAChC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACvC,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;gBAED,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { isEmpty } from '@venizia/ignis-inversion';\nimport { redactSecrets, redactUrlCredentials } from '@/common/redact';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport mqtt from 'mqtt';\nimport { invokeHook } 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 return;\n }\n\n if (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 redactUrlCredentials(this.url),\n redactSecrets(this.options),\n );\n this.client = this.createClient({ url: this.url, options: this.options });\n\n this.client.on('connect', () => {\n invokeHook({\n logger: this.logger,\n scope: 'onConnect',\n execution: () => this.onConnect?.(),\n });\n });\n\n this.client.on('disconnect', () => {\n invokeHook({\n logger: this.logger,\n scope: 'onDisconnect',\n execution: () => this.onDisconnect?.(),\n });\n });\n\n this.client.on('message', (topic, message) => {\n invokeHook({\n logger: this.logger,\n scope: 'onMessage',\n execution: () => this.onMessage?.({ topic, message }),\n });\n });\n\n this.client.on('error', (error) => {\n invokeHook({\n logger: this.logger,\n scope: 'onError',\n execution: () => this.onError?.(error),\n });\n });\n\n this.client.on('close', (error?: Error) => {\n invokeHook({\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"]}