@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.
- package/dist/cjs/common/constants/duration.d.ts +4 -1
- package/dist/cjs/common/constants/duration.d.ts.map +1 -1
- package/dist/cjs/common/constants/duration.js +13 -8
- package/dist/cjs/common/constants/duration.js.map +1 -1
- package/dist/cjs/common/redact.js +1 -1
- package/dist/cjs/common/redact.js.map +1 -1
- package/dist/cjs/modules/base.js +1 -1
- package/dist/cjs/modules/base.js.map +1 -1
- package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js +1 -1
- package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
- package/dist/cjs/modules/env/app-env.d.ts.map +1 -1
- package/dist/cjs/modules/env/app-env.js +1 -1
- package/dist/cjs/modules/env/app-env.js.map +1 -1
- package/dist/cjs/modules/logger/common/constants.js +1 -1
- package/dist/cjs/modules/logger/common/constants.js.map +1 -1
- package/dist/cjs/modules/logger/factory.js +1 -1
- package/dist/cjs/modules/logger/factory.js.map +1 -1
- package/dist/cjs/modules/logger/formatting/deep-splat.js +1 -1
- package/dist/cjs/modules/logger/formatting/deep-splat.js.map +1 -1
- package/dist/cjs/modules/logger/formatting/error-prettier.js +4 -4
- package/dist/cjs/modules/logger/formatting/error-prettier.js.map +1 -1
- package/dist/cjs/modules/logger/hf/flusher.js +3 -3
- package/dist/cjs/modules/logger/hf/flusher.js.map +1 -1
- package/dist/cjs/modules/logger/hf/logger.d.ts.map +1 -1
- package/dist/cjs/modules/logger/hf/logger.js +3 -1
- package/dist/cjs/modules/logger/hf/logger.js.map +1 -1
- package/dist/cjs/modules/logger/resolver.js +3 -3
- package/dist/cjs/modules/logger/resolver.js.map +1 -1
- package/dist/cjs/modules/logger/winston/formatters/deep-splat.js +1 -1
- package/dist/cjs/modules/logger/winston/formatters/deep-splat.js.map +1 -1
- package/dist/cjs/modules/logger/winston/logger-factory.js +1 -1
- package/dist/cjs/modules/logger/winston/logger-factory.js.map +1 -1
- package/dist/cjs/modules/logger/winston/transports/dgram.transport.js +2 -2
- package/dist/cjs/modules/logger/winston/transports/dgram.transport.js.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
- package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js +3 -0
- package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
- package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
- package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js +34 -11
- package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
- package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
- package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
- package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +1 -1
- package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js +7 -6
- package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
- package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js +1 -1
- package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
- package/dist/cjs/modules/network/utilities/query-string.d.ts +27 -2
- package/dist/cjs/modules/network/utilities/query-string.d.ts.map +1 -1
- package/dist/cjs/modules/network/utilities/query-string.js +34 -2
- package/dist/cjs/modules/network/utilities/query-string.js.map +1 -1
- package/dist/cjs/modules/network/utilities/url-safety/ingest.js +1 -1
- package/dist/cjs/modules/network/utilities/url-safety/ingest.js.map +1 -1
- package/dist/cjs/modules/network/utilities/url-safety/policy.js +1 -1
- package/dist/cjs/modules/network/utilities/url-safety/policy.js.map +1 -1
- package/dist/cjs/modules/pool/abstract.js +4 -4
- package/dist/cjs/modules/pool/abstract.js.map +1 -1
- package/dist/cjs/modules/queue/bullmq/helper.js +2 -2
- package/dist/cjs/modules/queue/bullmq/helper.js.map +1 -1
- package/dist/cjs/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
- package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
- package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
- package/dist/cjs/modules/queue/kafka/consumer.js +2 -2
- package/dist/cjs/modules/queue/kafka/consumer.js.map +1 -1
- package/dist/cjs/modules/queue/mqtt/helper.js +4 -4
- package/dist/cjs/modules/queue/mqtt/helper.js.map +1 -1
- package/dist/cjs/modules/redis/base/abstract.helper.js +4 -4
- package/dist/cjs/modules/redis/base/abstract.helper.js.map +1 -1
- package/dist/cjs/modules/redis/cluster/cluster.helper.js +1 -1
- package/dist/cjs/modules/redis/cluster/cluster.helper.js.map +1 -1
- package/dist/cjs/modules/redis/sentinel/sentinel.helper.js +1 -1
- package/dist/cjs/modules/redis/sentinel/sentinel.helper.js.map +1 -1
- package/dist/cjs/modules/secrets/base/abstract.helper.d.ts.map +1 -1
- package/dist/cjs/modules/secrets/base/abstract.helper.js +7 -3
- package/dist/cjs/modules/secrets/base/abstract.helper.js.map +1 -1
- package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
- package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
- package/dist/cjs/modules/socket/socket-io/browser.d.ts +5 -0
- package/dist/cjs/modules/socket/socket-io/browser.d.ts.map +1 -0
- package/dist/cjs/modules/socket/socket-io/browser.js +21 -0
- package/dist/cjs/modules/socket/socket-io/browser.js.map +1 -0
- package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
- package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
- package/dist/cjs/modules/socket/socket-io/client/browser-helper.js +250 -0
- package/dist/cjs/modules/socket/socket-io/client/browser-helper.js.map +1 -0
- package/dist/cjs/modules/socket/socket-io/client/helper.d.ts +8 -51
- package/dist/cjs/modules/socket/socket-io/client/helper.d.ts.map +1 -1
- package/dist/cjs/modules/socket/socket-io/client/helper.js +12 -230
- package/dist/cjs/modules/socket/socket-io/client/helper.js.map +1 -1
- package/dist/cjs/modules/socket/socket-io/server/helper.js +5 -5
- package/dist/cjs/modules/socket/socket-io/server/helper.js.map +1 -1
- package/dist/cjs/modules/socket/websocket/server/delivery.js +2 -2
- package/dist/cjs/modules/socket/websocket/server/delivery.js.map +1 -1
- package/dist/cjs/modules/socket/websocket/server/helper.js +4 -4
- package/dist/cjs/modules/socket/websocket/server/helper.js.map +1 -1
- package/dist/cjs/modules/storage/base.js +3 -3
- package/dist/cjs/modules/storage/base.js.map +1 -1
- package/dist/cjs/modules/storage/bun-s3/helper.js +1 -1
- package/dist/cjs/modules/storage/bun-s3/helper.js.map +1 -1
- package/dist/cjs/modules/storage/bun-s3/utility.js +6 -6
- package/dist/cjs/modules/storage/bun-s3/utility.js.map +1 -1
- package/dist/cjs/modules/storage/common/errors.js +1 -1
- package/dist/cjs/modules/storage/common/errors.js.map +1 -1
- package/dist/cjs/modules/storage/minio/helper.js +4 -4
- package/dist/cjs/modules/storage/minio/helper.js.map +1 -1
- package/dist/cjs/modules/temporal/abstract.js +5 -5
- package/dist/cjs/modules/temporal/abstract.js.map +1 -1
- package/dist/cjs/modules/temporal/adapters/intl.d.ts.map +1 -1
- package/dist/cjs/modules/temporal/adapters/intl.js +3 -1
- package/dist/cjs/modules/temporal/adapters/intl.js.map +1 -1
- package/dist/cjs/modules/temporal/locale/locale.js +4 -4
- package/dist/cjs/modules/temporal/locale/locale.js.map +1 -1
- package/dist/cjs/modules/tree/builder.js +2 -2
- package/dist/cjs/modules/tree/builder.js.map +1 -1
- package/dist/cjs/modules/uid/opaque.js +2 -2
- package/dist/cjs/modules/uid/opaque.js.map +1 -1
- package/dist/cjs/modules/uid/uuid/v5.js +1 -1
- package/dist/cjs/modules/uid/uuid/v5.js.map +1 -1
- package/dist/cjs/modules/worker-thread/bus/base.js +4 -4
- package/dist/cjs/modules/worker-thread/bus/base.js.map +1 -1
- package/dist/cjs/modules/worker-thread/thread/base.js +2 -2
- package/dist/cjs/modules/worker-thread/thread/base.js.map +1 -1
- package/dist/cjs/modules/worker-thread/worker/base.js +4 -4
- package/dist/cjs/modules/worker-thread/worker/base.js.map +1 -1
- package/dist/cjs/utilities/parse.utility.js +4 -4
- package/dist/cjs/utilities/parse.utility.js.map +1 -1
- package/dist/cjs/utilities/promise.utility.js +1 -1
- package/dist/cjs/utilities/promise.utility.js.map +1 -1
- package/dist/cjs/utilities/request.utility.js +1 -1
- package/dist/cjs/utilities/request.utility.js.map +1 -1
- package/dist/cjs/utilities/sleep.utility.js +1 -1
- package/dist/cjs/utilities/sleep.utility.js.map +1 -1
- package/dist/esm/common/constants/duration.d.ts +4 -1
- package/dist/esm/common/constants/duration.d.ts.map +1 -1
- package/dist/esm/common/constants/duration.js +13 -8
- package/dist/esm/common/constants/duration.js.map +1 -1
- package/dist/esm/common/redact.js +1 -1
- package/dist/esm/common/redact.js.map +1 -1
- package/dist/esm/modules/base.js +1 -1
- package/dist/esm/modules/base.js.map +1 -1
- package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +1 -1
- package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
- package/dist/esm/modules/env/app-env.d.ts.map +1 -1
- package/dist/esm/modules/env/app-env.js +1 -1
- package/dist/esm/modules/env/app-env.js.map +1 -1
- package/dist/esm/modules/logger/common/constants.js +1 -1
- package/dist/esm/modules/logger/common/constants.js.map +1 -1
- package/dist/esm/modules/logger/factory.js +1 -1
- package/dist/esm/modules/logger/factory.js.map +1 -1
- package/dist/esm/modules/logger/formatting/deep-splat.js +1 -1
- package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
- package/dist/esm/modules/logger/formatting/error-prettier.js +4 -4
- package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
- package/dist/esm/modules/logger/hf/flusher.js +3 -3
- package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
- package/dist/esm/modules/logger/hf/logger.d.ts.map +1 -1
- package/dist/esm/modules/logger/hf/logger.js +3 -1
- package/dist/esm/modules/logger/hf/logger.js.map +1 -1
- package/dist/esm/modules/logger/resolver.js +3 -3
- package/dist/esm/modules/logger/resolver.js.map +1 -1
- package/dist/esm/modules/logger/winston/formatters/deep-splat.js +1 -1
- package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +1 -1
- package/dist/esm/modules/logger/winston/logger-factory.js +1 -1
- package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
- package/dist/esm/modules/logger/winston/transports/dgram.transport.js +2 -2
- package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +3 -0
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +36 -13
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +1 -1
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +7 -6
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
- package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +1 -1
- package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
- package/dist/esm/modules/network/utilities/query-string.d.ts +27 -2
- package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
- package/dist/esm/modules/network/utilities/query-string.js +31 -1
- package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.js +1 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/policy.js +1 -1
- package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
- package/dist/esm/modules/pool/abstract.js +4 -4
- package/dist/esm/modules/pool/abstract.js.map +1 -1
- package/dist/esm/modules/queue/bullmq/helper.js +2 -2
- package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
- package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
- package/dist/esm/modules/queue/kafka/consumer.js +2 -2
- package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
- package/dist/esm/modules/queue/mqtt/helper.js +4 -4
- package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
- package/dist/esm/modules/redis/base/abstract.helper.js +4 -4
- package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
- package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -1
- package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -1
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
- package/dist/esm/modules/secrets/base/abstract.helper.d.ts.map +1 -1
- package/dist/esm/modules/secrets/base/abstract.helper.js +7 -3
- package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/browser.d.ts +5 -0
- package/dist/esm/modules/socket/socket-io/browser.d.ts.map +1 -0
- package/dist/esm/modules/socket/socket-io/browser.js +5 -0
- package/dist/esm/modules/socket/socket-io/browser.js.map +1 -0
- package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
- package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
- package/dist/esm/modules/socket/socket-io/client/browser-helper.js +246 -0
- package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -0
- package/dist/esm/modules/socket/socket-io/client/helper.d.ts +8 -51
- package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +1 -1
- package/dist/esm/modules/socket/socket-io/client/helper.js +12 -230
- package/dist/esm/modules/socket/socket-io/client/helper.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/server/helper.js +5 -5
- package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
- package/dist/esm/modules/socket/websocket/server/delivery.js +2 -2
- package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
- package/dist/esm/modules/socket/websocket/server/helper.js +4 -4
- package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
- package/dist/esm/modules/storage/base.js +3 -3
- package/dist/esm/modules/storage/base.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/helper.js +1 -1
- package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/utility.js +6 -6
- package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
- package/dist/esm/modules/storage/common/errors.js +1 -1
- package/dist/esm/modules/storage/common/errors.js.map +1 -1
- package/dist/esm/modules/storage/minio/helper.js +4 -4
- package/dist/esm/modules/storage/minio/helper.js.map +1 -1
- package/dist/esm/modules/temporal/abstract.js +5 -5
- package/dist/esm/modules/temporal/abstract.js.map +1 -1
- package/dist/esm/modules/temporal/adapters/intl.d.ts.map +1 -1
- package/dist/esm/modules/temporal/adapters/intl.js +3 -1
- package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
- package/dist/esm/modules/temporal/locale/locale.js +4 -4
- package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
- package/dist/esm/modules/tree/builder.js +2 -2
- package/dist/esm/modules/tree/builder.js.map +1 -1
- package/dist/esm/modules/uid/opaque.js +2 -2
- package/dist/esm/modules/uid/opaque.js.map +1 -1
- package/dist/esm/modules/uid/uuid/v5.js +1 -1
- package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
- package/dist/esm/modules/worker-thread/bus/base.js +4 -4
- package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
- package/dist/esm/modules/worker-thread/thread/base.js +2 -2
- package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
- package/dist/esm/modules/worker-thread/worker/base.js +4 -4
- package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
- package/dist/esm/utilities/parse.utility.js +4 -4
- package/dist/esm/utilities/parse.utility.js.map +1 -1
- package/dist/esm/utilities/promise.utility.js +1 -1
- package/dist/esm/utilities/promise.utility.js.map +1 -1
- package/dist/esm/utilities/request.utility.js +1 -1
- package/dist/esm/utilities/request.utility.js.map +1 -1
- package/dist/esm/utilities/sleep.utility.js +1 -1
- package/dist/esm/utilities/sleep.utility.js.map +1 -1
- package/package.json +10 -4
|
@@ -98,7 +98,7 @@ export class AbstractRedisHelper extends BaseHelper {
|
|
|
98
98
|
}
|
|
99
99
|
this.client
|
|
100
100
|
.quit()
|
|
101
|
-
.then(rs => {
|
|
101
|
+
.then((rs) => {
|
|
102
102
|
resolve(rs === 'OK');
|
|
103
103
|
})
|
|
104
104
|
.catch(reject);
|
|
@@ -222,7 +222,7 @@ export class AbstractRedisHelper extends BaseHelper {
|
|
|
222
222
|
if (!values?.length) {
|
|
223
223
|
return [];
|
|
224
224
|
}
|
|
225
|
-
return values.map(el => (el ? (transform ? transform(el) : el) : null));
|
|
225
|
+
return values.map((el) => (el ? (transform ? transform(el) : el) : null));
|
|
226
226
|
}
|
|
227
227
|
keys(opts) {
|
|
228
228
|
const { key } = opts;
|
|
@@ -377,7 +377,7 @@ export class AbstractRedisHelper extends BaseHelper {
|
|
|
377
377
|
async publish(opts) {
|
|
378
378
|
const logger = this.logger.for(this.publish.name);
|
|
379
379
|
const { topics, payload, useCompress = false } = opts;
|
|
380
|
-
const validTopics = topics?.filter(topic => !isEmpty({ value: topic }));
|
|
380
|
+
const validTopics = topics?.filter((topic) => !isEmpty({ value: topic }));
|
|
381
381
|
if (!validTopics?.length) {
|
|
382
382
|
logger.error('No topic(s) to publish!');
|
|
383
383
|
return;
|
|
@@ -391,7 +391,7 @@ export class AbstractRedisHelper extends BaseHelper {
|
|
|
391
391
|
// `topics` is caller-supplied, so an unbounded fan-out here is a caller-sized burst on one connection.
|
|
392
392
|
await executePromiseWithLimit({
|
|
393
393
|
limit: RedisConcurrency.PUBLISH_LIMIT,
|
|
394
|
-
tasks: validTopics.map(topic => () => this.client.publish(topic, packet)),
|
|
394
|
+
tasks: validTopics.map((topic) => () => this.client.publish(topic, packet)),
|
|
395
395
|
});
|
|
396
396
|
}
|
|
397
397
|
subscribe(opts) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEmpty } from '@venizia/ignis-inversion';\nimport type { AnyType } from '@/common/types';\nimport { executePromiseWithLimit, voidExecution } from '@/utilities/promise.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { type EventEmitter } from 'node:events';\nimport zlib from 'node:zlib';\nimport { RedisConcurrency } from './../common/constants';\nimport { type IRedisHelper } from './../common/interfaces';\nimport { type IRedisHelperCallbacks, type TRedisClient } from './../common/types';\n\nexport const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');\n\n/** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */\nexport const isRedisHelper = (value: unknown): value is AbstractRedisHelper => {\n return typeof value === 'object' && value !== null && REDIS_HELPER_BRAND in value;\n};\n\nexport class AbstractRedisHelper<ClientType extends TRedisClient = TRedisClient>\n extends BaseHelper\n implements IRedisHelper\n{\n /** Read by {@link isRedisHelper}. On the instance, so every subclass instance carries it. */\n readonly [REDIS_HELPER_BRAND] = true;\n\n client: ClientType;\n readonly name: string;\n\n constructor(\n opts: { scope: string; identifier: string; client: ClientType } & IRedisHelperCallbacks,\n ) {\n super({ scope: opts.scope, identifier: opts.identifier });\n\n this.name = opts.identifier;\n this.client = opts.client;\n\n const { onInitialized, onConnected, onReady, onError } = opts;\n const emitter = this.client as EventEmitter;\n\n emitter.on('connect', () => {\n this.logger.for('connect').info('Redis CONNECTED | Name: %s', this.name);\n onConnected?.({ name: this.name, helper: this });\n });\n\n emitter.on('ready', () => {\n this.logger.for('ready').info('Redis READY | Name: %s', this.name);\n onReady?.({ name: this.name, helper: this });\n });\n\n emitter.on('error', (error: Error) => {\n this.logger.for('error').error('Redis ERROR | Name: %s | Error: %s', this.name, error);\n onError?.({ name: this.name, helper: this, error });\n });\n\n emitter.on('reconnecting', () => {\n this.logger.for('reconnecting').warn('Redis client RECONNECTING | Name: %s', this.name);\n });\n\n onInitialized?.({ name: this.name, helper: this });\n }\n\n protected static buildRetryStrategy(opts: { maxRetry: number }) {\n const { maxRetry } = opts;\n\n return (attemptCounter: number) => {\n if (maxRetry > -1 && attemptCounter > maxRetry) {\n return undefined;\n }\n\n return Math.max(Math.min(attemptCounter * 2000, 5000), 1000);\n };\n }\n\n protected static buildDefaultOpts(opts: { maxRetry: number }) {\n return {\n showFriendlyErrorStack: true,\n maxRetriesPerRequest: null,\n retryStrategy: AbstractRedisHelper.buildRetryStrategy({ maxRetry: opts.maxRetry }),\n };\n }\n\n // --- Connection lifecycle (IRedisConnection) ---\n\n getClient() {\n return this.client;\n }\n\n duplicateClient(): TRedisClient {\n // ioredis 6 types `duplicate` per client; the `Redis | Cluster` union has no callable signature.\n const duplicable: { duplicate: () => TRedisClient } = this.client;\n return duplicable.duplicate();\n }\n\n ping() {\n return this.client.ping();\n }\n\n connect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = [\n 'ready',\n 'reconnecting',\n 'connecting',\n ];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.connect.name)\n .info('status: %s | Invalid redis status to invoke connect', this.client.status);\n\n resolve(false);\n return;\n }\n\n this.client\n .connect()\n .then(() => {\n resolve(this.client.status === 'ready');\n })\n .catch(reject);\n });\n }\n\n disconnect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = ['end', 'close'];\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.disconnect.name)\n .info('status: %s | Invalid redis status to invoke disconnect', this.client.status);\n resolve(false);\n return;\n }\n\n this.client\n .quit()\n .then(rs => {\n resolve(rs === 'OK');\n })\n .catch(reject);\n });\n }\n\n // --- Key lifecycle + counters (IRedisKey) ---\n\n exists(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n if (!keys.length) {\n return Promise.resolve(0);\n }\n return this.client.exists(...keys);\n }\n\n async expire(opts: { key: string; seconds: number }): Promise<boolean> {\n const { key, seconds } = opts;\n const result = await this.client.expire(key, seconds);\n return result === 1;\n }\n\n async expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean> {\n const { key, atEpochSeconds } = opts;\n const result = await this.client.expireat(key, atEpochSeconds);\n return result === 1;\n }\n\n ttl(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.ttl(key);\n }\n\n async persist(opts: { key: string }): Promise<boolean> {\n const { key } = opts;\n const result = await this.client.persist(key);\n return result === 1;\n }\n\n incr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.incr(key);\n }\n\n decr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.decr(key);\n }\n\n incrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n return this.client.incrby(key, value);\n }\n\n decrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n return this.client.decrby(key, value);\n }\n\n // --- Key-value (IRedisKeyValue) ---\n\n async set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void> {\n const { key, value, options } = opts;\n\n const serialized = JSON.stringify(value);\n if (typeof options?.expiresIn === 'number' && options.expiresIn > 0) {\n await this.client.set(key, serialized, 'PX', options.expiresIn);\n } else {\n await this.client.set(key, serialized);\n }\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.set.name).info('Set key: %s | value: %s', key, serialized);\n }\n\n async get<T = string>(opts: {\n key: string;\n transform?: (input: string) => T;\n }): Promise<T | null> {\n const { key, transform } = opts;\n\n const value = await this.client.get(key);\n if (!value) {\n return null;\n }\n\n return transform ? transform(value) : (value as AnyType);\n }\n\n del(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n if (!keys.length) {\n return Promise.resolve(0);\n }\n return this.client.del(keys);\n }\n\n getString(opts: { key: string }) {\n return this.get(opts);\n }\n\n getStrings(opts: { keys: Array<string> }) {\n return this.mGet(opts);\n }\n\n getObject<T>(opts: { key: string }) {\n return this.get<T>({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n getObjects(opts: { keys: Array<string> }) {\n return this.mGet({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n async mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void> {\n const { payload, options } = opts;\n if (!payload.length) {\n return;\n }\n\n // A plain loop, not spread-in-reduce: `{ ...current, [key]: v }` copies every key already\n // accumulated on EVERY element, which is O(n^2). Measured at 10k keys: 2.2s of blocked event\n // loop, against 1.5ms for this.\n const serialized: Record<string, string> = {};\n for (const { key, value } of payload) {\n serialized[key] = JSON.stringify(value);\n }\n await this.client.mset(serialized);\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.mSet.name).info('Payload: %j', serialized);\n }\n\n async mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]> {\n const { keys, transform } = opts;\n if (!keys.length) {\n return [];\n }\n\n const values = await this.client.mget(keys);\n if (!values?.length) {\n return [];\n }\n\n return values.map(el => (el ? (transform ? transform(el) : (el as AnyType)) : null));\n }\n\n keys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.keys(key);\n }\n\n // --- Hash operations (IRedisHash) ---\n\n async hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number> {\n const { key, value, options } = opts;\n const result = await this.client.hset(key, value as Record<string, string | number | Buffer>);\n\n if (!options?.log) {\n return result;\n }\n\n this.logger.for(this.hSet.name).info('Result: %j', result);\n return result;\n }\n\n async hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }) {\n const { key, transform } = opts;\n const value = await this.client.hgetall(key);\n if (!transform || !value) {\n return value;\n }\n\n return transform(value);\n }\n\n hGet(opts: { key: string; field: string }): Promise<string | null> {\n const { key, field } = opts;\n return this.client.hget(key, field);\n }\n\n hDel(opts: { key: string; fields: Array<string> }): Promise<number> {\n const { key, fields } = opts;\n if (!fields.length) {\n return Promise.resolve(0);\n }\n return this.client.hdel(key, ...fields);\n }\n\n async hExists(opts: { key: string; field: string }): Promise<boolean> {\n const { key, field } = opts;\n const result = await this.client.hexists(key, field);\n return result === 1;\n }\n\n hKeys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.hkeys(key);\n }\n\n hVals(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.hvals(key);\n }\n\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number> {\n const { key, field, value } = opts;\n return this.client.hincrby(key, field, value);\n }\n\n hLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.hlen(key);\n }\n\n // --- Set operations (IRedisSet) ---\n\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n if (!members.length) {\n return Promise.resolve(0);\n }\n return this.client.sadd(key, ...members);\n }\n\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n if (!members.length) {\n return Promise.resolve(0);\n }\n return this.client.srem(key, ...members);\n }\n\n sMembers(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.smembers(key);\n }\n\n async sIsMember(opts: { key: string; member: string | number }): Promise<boolean> {\n const { key, member } = opts;\n const result = await this.client.sismember(key, member);\n return result === 1;\n }\n\n sCard(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.scard(key);\n }\n\n // --- List operations (IRedisList) ---\n\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n if (!values.length) {\n return Promise.resolve(0);\n }\n return this.client.lpush(key, ...values);\n }\n\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n if (!values.length) {\n return Promise.resolve(0);\n }\n return this.client.rpush(key, ...values);\n }\n\n lPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n return this.client.lpop(key);\n }\n\n rPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n return this.client.rpop(key);\n }\n\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]> {\n const { key, start, stop } = opts;\n return this.client.lrange(key, start, stop);\n }\n\n lLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.llen(key);\n }\n\n // --- RedisJSON (IRedisJson) ---\n\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null> {\n const { key, path, value } = opts;\n return this.execute<string | null>('JSON.SET', [key, path, JSON.stringify(value)]);\n }\n\n jGet<T>(opts: { key: string; path?: string }): Promise<T | null> {\n const { key, path = '$' } = opts;\n return this.execute<T | null>('JSON.GET', [key, path]);\n }\n\n jDelete(opts: { key: string; path?: string }): Promise<number> {\n const { key, path = '$' } = opts;\n return this.execute<number>('JSON.DEL', [key, path]);\n }\n\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null> {\n const { key, path, value } = opts;\n return this.execute<string | null>('JSON.NUMINCRBY', [key, path, value]);\n }\n\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null> {\n const { key, path, value } = opts;\n return this.execute<number[] | null>('JSON.STRAPPEND', [key, path, value]);\n }\n\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null> {\n const { key, path, value } = opts;\n return this.execute<number[] | null>('JSON.ARRAPPEND', [key, path, JSON.stringify(value)]);\n }\n\n jPop<T>(opts: { key: string; path: string }): Promise<T | null> {\n const { key, path } = opts;\n return this.execute<T | null>('JSON.ARRPOP', [key, path]);\n }\n\n // --- Raw command (IRedisCommand) ---\n\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R> {\n if (!parameters?.length) {\n return this.client.call(command) as Promise<R>;\n }\n\n return this.client.call(command, parameters) as Promise<R>;\n }\n\n // --- Pub/Sub (IRedisPubSub) ---\n\n async publish<T>(opts: {\n topics: Array<string>;\n payload: T;\n useCompress?: boolean;\n }): Promise<void> {\n const logger = this.logger.for(this.publish.name);\n const { topics, payload, useCompress = false } = opts;\n\n const validTopics = topics?.filter(topic => !isEmpty({ value: topic }));\n if (!validTopics?.length) {\n logger.error('No topic(s) to publish!');\n return;\n }\n\n if (!payload) {\n logger.error('Invalid payload to publish!');\n return;\n }\n\n const message = Buffer.from(JSON.stringify(payload));\n const packet = useCompress ? zlib.deflateSync(message) : message;\n\n // `topics` is caller-supplied, so an unbounded fan-out here is a caller-sized burst on one connection.\n await executePromiseWithLimit({\n limit: RedisConcurrency.PUBLISH_LIMIT,\n tasks: validTopics.map(topic => () => this.client.publish(topic, packet)),\n });\n }\n\n subscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.subscribe.name);\n const { topic } = opts;\n\n if (!topic || isEmpty({ value: topic })) {\n logger.error('No topic to subscribe!');\n return;\n }\n\n voidExecution({\n logger: this.logger,\n scope: this.subscribe.name,\n execution: this.client.subscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to subscribe to topic: %s | Error: %s', topic, error);\n return;\n }\n\n logger.info('Subscribed to %s channel(s). Listening to channel: %s', count, topic);\n }),\n });\n }\n\n unsubscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.unsubscribe.name);\n const { topic } = opts;\n\n if (!topic || isEmpty({ value: topic })) {\n logger.error('No topic to unsubscribe!');\n return;\n }\n\n voidExecution({\n logger: this.logger,\n scope: this.unsubscribe.name,\n execution: this.client.unsubscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to unsubscribe from topic: %s | Error: %s', topic, error);\n return;\n }\n\n logger.info('Unsubscribed from %s channel(s).', count);\n }),\n });\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEmpty } from '@venizia/ignis-inversion';\nimport type { AnyType } from '@/common/types';\nimport { executePromiseWithLimit, voidExecution } from '@/utilities/promise.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { type EventEmitter } from 'node:events';\nimport zlib from 'node:zlib';\nimport { RedisConcurrency } from './../common/constants';\nimport { type IRedisHelper } from './../common/interfaces';\nimport { type IRedisHelperCallbacks, type TRedisClient } from './../common/types';\n\nexport const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');\n\n/** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */\nexport const isRedisHelper = (value: unknown): value is AbstractRedisHelper => {\n return typeof value === 'object' && value !== null && REDIS_HELPER_BRAND in value;\n};\n\nexport class AbstractRedisHelper<ClientType extends TRedisClient = TRedisClient>\n extends BaseHelper\n implements IRedisHelper\n{\n /** Read by {@link isRedisHelper}. On the instance, so every subclass instance carries it. */\n readonly [REDIS_HELPER_BRAND] = true;\n\n client: ClientType;\n readonly name: string;\n\n constructor(\n opts: { scope: string; identifier: string; client: ClientType } & IRedisHelperCallbacks,\n ) {\n super({ scope: opts.scope, identifier: opts.identifier });\n\n this.name = opts.identifier;\n this.client = opts.client;\n\n const { onInitialized, onConnected, onReady, onError } = opts;\n const emitter = this.client as EventEmitter;\n\n emitter.on('connect', () => {\n this.logger.for('connect').info('Redis CONNECTED | Name: %s', this.name);\n onConnected?.({ name: this.name, helper: this });\n });\n\n emitter.on('ready', () => {\n this.logger.for('ready').info('Redis READY | Name: %s', this.name);\n onReady?.({ name: this.name, helper: this });\n });\n\n emitter.on('error', (error: Error) => {\n this.logger.for('error').error('Redis ERROR | Name: %s | Error: %s', this.name, error);\n onError?.({ name: this.name, helper: this, error });\n });\n\n emitter.on('reconnecting', () => {\n this.logger.for('reconnecting').warn('Redis client RECONNECTING | Name: %s', this.name);\n });\n\n onInitialized?.({ name: this.name, helper: this });\n }\n\n protected static buildRetryStrategy(opts: { maxRetry: number }) {\n const { maxRetry } = opts;\n\n return (attemptCounter: number) => {\n if (maxRetry > -1 && attemptCounter > maxRetry) {\n return undefined;\n }\n\n return Math.max(Math.min(attemptCounter * 2000, 5000), 1000);\n };\n }\n\n protected static buildDefaultOpts(opts: { maxRetry: number }) {\n return {\n showFriendlyErrorStack: true,\n maxRetriesPerRequest: null,\n retryStrategy: AbstractRedisHelper.buildRetryStrategy({ maxRetry: opts.maxRetry }),\n };\n }\n\n // --- Connection lifecycle (IRedisConnection) ---\n\n getClient() {\n return this.client;\n }\n\n duplicateClient(): TRedisClient {\n // ioredis 6 types `duplicate` per client; the `Redis | Cluster` union has no callable signature.\n const duplicable: { duplicate: () => TRedisClient } = this.client;\n return duplicable.duplicate();\n }\n\n ping() {\n return this.client.ping();\n }\n\n connect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = [\n 'ready',\n 'reconnecting',\n 'connecting',\n ];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.connect.name)\n .info('status: %s | Invalid redis status to invoke connect', this.client.status);\n\n resolve(false);\n return;\n }\n\n this.client\n .connect()\n .then(() => {\n resolve(this.client.status === 'ready');\n })\n .catch(reject);\n });\n }\n\n disconnect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = ['end', 'close'];\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.disconnect.name)\n .info('status: %s | Invalid redis status to invoke disconnect', this.client.status);\n resolve(false);\n return;\n }\n\n this.client\n .quit()\n .then((rs) => {\n resolve(rs === 'OK');\n })\n .catch(reject);\n });\n }\n\n // --- Key lifecycle + counters (IRedisKey) ---\n\n exists(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n if (!keys.length) {\n return Promise.resolve(0);\n }\n return this.client.exists(...keys);\n }\n\n async expire(opts: { key: string; seconds: number }): Promise<boolean> {\n const { key, seconds } = opts;\n const result = await this.client.expire(key, seconds);\n return result === 1;\n }\n\n async expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean> {\n const { key, atEpochSeconds } = opts;\n const result = await this.client.expireat(key, atEpochSeconds);\n return result === 1;\n }\n\n ttl(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.ttl(key);\n }\n\n async persist(opts: { key: string }): Promise<boolean> {\n const { key } = opts;\n const result = await this.client.persist(key);\n return result === 1;\n }\n\n incr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.incr(key);\n }\n\n decr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.decr(key);\n }\n\n incrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n return this.client.incrby(key, value);\n }\n\n decrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n return this.client.decrby(key, value);\n }\n\n // --- Key-value (IRedisKeyValue) ---\n\n async set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void> {\n const { key, value, options } = opts;\n\n const serialized = JSON.stringify(value);\n if (typeof options?.expiresIn === 'number' && options.expiresIn > 0) {\n await this.client.set(key, serialized, 'PX', options.expiresIn);\n } else {\n await this.client.set(key, serialized);\n }\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.set.name).info('Set key: %s | value: %s', key, serialized);\n }\n\n async get<T = string>(opts: {\n key: string;\n transform?: (input: string) => T;\n }): Promise<T | null> {\n const { key, transform } = opts;\n\n const value = await this.client.get(key);\n if (!value) {\n return null;\n }\n\n return transform ? transform(value) : (value as AnyType);\n }\n\n del(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n if (!keys.length) {\n return Promise.resolve(0);\n }\n return this.client.del(keys);\n }\n\n getString(opts: { key: string }) {\n return this.get(opts);\n }\n\n getStrings(opts: { keys: Array<string> }) {\n return this.mGet(opts);\n }\n\n getObject<T>(opts: { key: string }) {\n return this.get<T>({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n getObjects(opts: { keys: Array<string> }) {\n return this.mGet({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n async mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void> {\n const { payload, options } = opts;\n if (!payload.length) {\n return;\n }\n\n // A plain loop, not spread-in-reduce: `{ ...current, [key]: v }` copies every key already\n // accumulated on EVERY element, which is O(n^2). Measured at 10k keys: 2.2s of blocked event\n // loop, against 1.5ms for this.\n const serialized: Record<string, string> = {};\n for (const { key, value } of payload) {\n serialized[key] = JSON.stringify(value);\n }\n await this.client.mset(serialized);\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.mSet.name).info('Payload: %j', serialized);\n }\n\n async mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]> {\n const { keys, transform } = opts;\n if (!keys.length) {\n return [];\n }\n\n const values = await this.client.mget(keys);\n if (!values?.length) {\n return [];\n }\n\n return values.map((el) => (el ? (transform ? transform(el) : (el as AnyType)) : null));\n }\n\n keys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.keys(key);\n }\n\n // --- Hash operations (IRedisHash) ---\n\n async hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number> {\n const { key, value, options } = opts;\n const result = await this.client.hset(key, value as Record<string, string | number | Buffer>);\n\n if (!options?.log) {\n return result;\n }\n\n this.logger.for(this.hSet.name).info('Result: %j', result);\n return result;\n }\n\n async hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }) {\n const { key, transform } = opts;\n const value = await this.client.hgetall(key);\n if (!transform || !value) {\n return value;\n }\n\n return transform(value);\n }\n\n hGet(opts: { key: string; field: string }): Promise<string | null> {\n const { key, field } = opts;\n return this.client.hget(key, field);\n }\n\n hDel(opts: { key: string; fields: Array<string> }): Promise<number> {\n const { key, fields } = opts;\n if (!fields.length) {\n return Promise.resolve(0);\n }\n return this.client.hdel(key, ...fields);\n }\n\n async hExists(opts: { key: string; field: string }): Promise<boolean> {\n const { key, field } = opts;\n const result = await this.client.hexists(key, field);\n return result === 1;\n }\n\n hKeys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.hkeys(key);\n }\n\n hVals(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.hvals(key);\n }\n\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number> {\n const { key, field, value } = opts;\n return this.client.hincrby(key, field, value);\n }\n\n hLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.hlen(key);\n }\n\n // --- Set operations (IRedisSet) ---\n\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n if (!members.length) {\n return Promise.resolve(0);\n }\n return this.client.sadd(key, ...members);\n }\n\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n if (!members.length) {\n return Promise.resolve(0);\n }\n return this.client.srem(key, ...members);\n }\n\n sMembers(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.smembers(key);\n }\n\n async sIsMember(opts: { key: string; member: string | number }): Promise<boolean> {\n const { key, member } = opts;\n const result = await this.client.sismember(key, member);\n return result === 1;\n }\n\n sCard(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.scard(key);\n }\n\n // --- List operations (IRedisList) ---\n\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n if (!values.length) {\n return Promise.resolve(0);\n }\n return this.client.lpush(key, ...values);\n }\n\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n if (!values.length) {\n return Promise.resolve(0);\n }\n return this.client.rpush(key, ...values);\n }\n\n lPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n return this.client.lpop(key);\n }\n\n rPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n return this.client.rpop(key);\n }\n\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]> {\n const { key, start, stop } = opts;\n return this.client.lrange(key, start, stop);\n }\n\n lLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.llen(key);\n }\n\n // --- RedisJSON (IRedisJson) ---\n\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null> {\n const { key, path, value } = opts;\n return this.execute<string | null>('JSON.SET', [key, path, JSON.stringify(value)]);\n }\n\n jGet<T>(opts: { key: string; path?: string }): Promise<T | null> {\n const { key, path = '$' } = opts;\n return this.execute<T | null>('JSON.GET', [key, path]);\n }\n\n jDelete(opts: { key: string; path?: string }): Promise<number> {\n const { key, path = '$' } = opts;\n return this.execute<number>('JSON.DEL', [key, path]);\n }\n\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null> {\n const { key, path, value } = opts;\n return this.execute<string | null>('JSON.NUMINCRBY', [key, path, value]);\n }\n\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null> {\n const { key, path, value } = opts;\n return this.execute<number[] | null>('JSON.STRAPPEND', [key, path, value]);\n }\n\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null> {\n const { key, path, value } = opts;\n return this.execute<number[] | null>('JSON.ARRAPPEND', [key, path, JSON.stringify(value)]);\n }\n\n jPop<T>(opts: { key: string; path: string }): Promise<T | null> {\n const { key, path } = opts;\n return this.execute<T | null>('JSON.ARRPOP', [key, path]);\n }\n\n // --- Raw command (IRedisCommand) ---\n\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R> {\n if (!parameters?.length) {\n return this.client.call(command) as Promise<R>;\n }\n\n return this.client.call(command, parameters) as Promise<R>;\n }\n\n // --- Pub/Sub (IRedisPubSub) ---\n\n async publish<T>(opts: {\n topics: Array<string>;\n payload: T;\n useCompress?: boolean;\n }): Promise<void> {\n const logger = this.logger.for(this.publish.name);\n const { topics, payload, useCompress = false } = opts;\n\n const validTopics = topics?.filter((topic) => !isEmpty({ value: topic }));\n if (!validTopics?.length) {\n logger.error('No topic(s) to publish!');\n return;\n }\n\n if (!payload) {\n logger.error('Invalid payload to publish!');\n return;\n }\n\n const message = Buffer.from(JSON.stringify(payload));\n const packet = useCompress ? zlib.deflateSync(message) : message;\n\n // `topics` is caller-supplied, so an unbounded fan-out here is a caller-sized burst on one connection.\n await executePromiseWithLimit({\n limit: RedisConcurrency.PUBLISH_LIMIT,\n tasks: validTopics.map((topic) => () => this.client.publish(topic, packet)),\n });\n }\n\n subscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.subscribe.name);\n const { topic } = opts;\n\n if (!topic || isEmpty({ value: topic })) {\n logger.error('No topic to subscribe!');\n return;\n }\n\n voidExecution({\n logger: this.logger,\n scope: this.subscribe.name,\n execution: this.client.subscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to subscribe to topic: %s | Error: %s', topic, error);\n return;\n }\n\n logger.info('Subscribed to %s channel(s). Listening to channel: %s', count, topic);\n }),\n });\n }\n\n unsubscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.unsubscribe.name);\n const { topic } = opts;\n\n if (!topic || isEmpty({ value: topic })) {\n logger.error('No topic to unsubscribe!');\n return;\n }\n\n voidExecution({\n logger: this.logger,\n scope: this.unsubscribe.name,\n execution: this.client.unsubscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to unsubscribe from topic: %s | Error: %s', topic, error);\n return;\n }\n\n logger.info('Unsubscribed from %s channel(s).', count);\n }),\n });\n }\n}\n"]}
|
|
@@ -4,7 +4,7 @@ import { AbstractRedisHelper } from './../base/index.js';
|
|
|
4
4
|
export class RedisClusterHelper extends AbstractRedisHelper {
|
|
5
5
|
constructor(opts) {
|
|
6
6
|
const { autoConnect = true } = opts;
|
|
7
|
-
const startupNodes = opts.nodes.map(node => ({
|
|
7
|
+
const startupNodes = opts.nodes.map((node) => ({
|
|
8
8
|
host: node.host,
|
|
9
9
|
port: int(node.port),
|
|
10
10
|
password: node.password,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,MAAM,OAAO,kBAAmB,SAAQ,mBAA4B;IAKlE,YAAY,IAAgC;QAC1C,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,
|
|
1
|
+
{"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,MAAM,OAAO,kBAAmB,SAAQ,mBAA4B;IAKlE,YAAY,IAAgC;QAC1C,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC,CAAC;QAEJ,gGAAgG;QAChG,8FAA8F;QAC9F,0FAA0F;QAC1F,yFAAyF;QACzF,mFAAmF;QACnF,6FAA6F;QAC7F,MAAM,WAAW,GAAmB;YAClC,kBAAkB,EAAE,IAAI;YACxB,WAAW,EAAE,CAAC,WAAW;YACzB,GAAG,IAAI,CAAC,cAAc;SACvB,CAAC;QAEF,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,QAAQ,CAA2B,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAEzF,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,kBAAkB,CAAC,IAAI;YAC9B,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SACvD,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEQ,SAAS;QAChB,OAAO,IAAI,CAAC,MAAiB,CAAC;IAChC,CAAC;IAEQ,eAAe;QACtB,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;CACF","sourcesContent":["import { int } from '@/utilities';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport type { Cluster, ClusterOptions } from 'ioredis';\nimport { AbstractRedisHelper } from './../base';\nimport { type IRedisClusterHelperOptions } from './../common';\n\nexport class RedisClusterHelper extends AbstractRedisHelper<Cluster> {\n private startupNodes: Array<{ host: string; port: number; password?: string }>;\n private clusterOpts: ClusterOptions;\n private ioredis: typeof import('ioredis');\n\n constructor(opts: IRedisClusterHelperOptions) {\n const { autoConnect = true } = opts;\n\n const startupNodes = opts.nodes.map((node) => ({\n host: node.host,\n port: int(node.port),\n password: node.password,\n }));\n\n // Precedence (low -> high): the two framework defaults, then `clusterOptions` verbatim. The raw\n // hatch stays the last word, because a caller already threading `lazyConnect` through it must\n // keep the timing it has today. `enableOfflineQueue` is stated rather than inherited from\n // ioredis, so the queue a cluster needs between bind and connect cannot go missing on an\n // ioredis default change. Deliberately NOT `buildDefaultOpts`: cluster's retry and\n // per-node-failure semantics differ from single's, and folding them in here is a regression.\n const clusterOpts: ClusterOptions = {\n enableOfflineQueue: true,\n lazyConnect: !autoConnect,\n ...opts.clusterOptions,\n };\n\n const ioredis =\n opts.module ?? ModuleUtility.loadSync<typeof import('ioredis')>({ module: 'ioredis' });\n\n super({\n ...opts,\n scope: RedisClusterHelper.name,\n identifier: opts.name,\n client: new ioredis.Cluster(startupNodes, clusterOpts),\n });\n\n this.startupNodes = startupNodes;\n this.clusterOpts = clusterOpts;\n this.ioredis = ioredis;\n }\n\n override getClient() {\n return this.client as Cluster;\n }\n\n override duplicateClient(): Cluster {\n return new this.ioredis.Cluster(this.startupNodes, this.clusterOpts);\n }\n}\n"]}
|
|
@@ -5,7 +5,7 @@ import { RedisSentinelRoles } from './../common/index.js';
|
|
|
5
5
|
export class RedisSentinelHelper extends AbstractRedisHelper {
|
|
6
6
|
constructor(opts) {
|
|
7
7
|
const { name, sentinels, masterName, role = RedisSentinelRoles.MASTER, password, sentinelPassword, sentinelUsername, database = 0, autoConnect = true, maxRetry = 0, redisOptions = {}, } = opts;
|
|
8
|
-
const normalizedSentinels = sentinels.map(sentinel => ({
|
|
8
|
+
const normalizedSentinels = sentinels.map((sentinel) => ({
|
|
9
9
|
host: sentinel.host,
|
|
10
10
|
port: int(sentinel.port ?? 26379),
|
|
11
11
|
}));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sentinel.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/sentinel/sentinel.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAoC,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEnF,MAAM,OAAO,mBAAoB,SAAQ,mBAA0B;IACjE,YAAY,IAAiC;QAC3C,MAAM,EACJ,IAAI,EACJ,SAAS,EACT,UAAU,EACV,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAChC,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,GAAG,CAAC,EACZ,WAAW,GAAG,IAAI,EAClB,QAAQ,GAAG,CAAC,EACZ,YAAY,GAAG,EAAE,GAClB,GAAG,IAAI,CAAC;QAET,MAAM,mBAAmB,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,
|
|
1
|
+
{"version":3,"file":"sentinel.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/sentinel/sentinel.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAoC,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEnF,MAAM,OAAO,mBAAoB,SAAQ,mBAA0B;IACjE,YAAY,IAAiC;QAC3C,MAAM,EACJ,IAAI,EACJ,SAAS,EACT,UAAU,EACV,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAChC,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,GAAG,CAAC,EACZ,WAAW,GAAG,IAAI,EAClB,QAAQ,GAAG,CAAC,EACZ,YAAY,GAAG,EAAE,GAClB,GAAG,IAAI,CAAC;QAET,MAAM,mBAAmB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACvD,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC;SAClC,CAAC,CAAC,CAAC;QAEJ,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,QAAQ,CAA2B,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAEzF,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,mBAAmB,CAAC,IAAI;YAC/B,UAAU,EAAE,IAAI;YAChB,gPAAgP;YAChP,MAAM,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC;gBACxB,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAC;gBACrD,GAAG,YAAY;gBACf,SAAS,EAAE,mBAAmB;gBAC9B,IAAI,EAAE,UAAU;gBAChB,IAAI;gBACJ,EAAE,EAAE,QAAQ;gBACZ,WAAW,EAAE,CAAC,WAAW;gBACzB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;gBAC/C,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC;gBAC/D,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC;aAChE,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAEQ,SAAS;QAChB,OAAO,IAAI,CAAC,MAAe,CAAC;IAC9B,CAAC;CACF","sourcesContent":["import { ModuleUtility } from '@/utilities/module.utility';\nimport { int } from '@/utilities/parse.utility';\nimport type { Redis } from 'ioredis';\nimport { AbstractRedisHelper } from './../base';\nimport { type IRedisSentinelHelperOptions, RedisSentinelRoles } from './../common';\n\nexport class RedisSentinelHelper extends AbstractRedisHelper<Redis> {\n constructor(opts: IRedisSentinelHelperOptions) {\n const {\n name,\n sentinels,\n masterName,\n role = RedisSentinelRoles.MASTER,\n password,\n sentinelPassword,\n sentinelUsername,\n database = 0,\n autoConnect = true,\n maxRetry = 0,\n redisOptions = {},\n } = opts;\n\n const normalizedSentinels = sentinels.map((sentinel) => ({\n host: sentinel.host,\n port: int(sentinel.port ?? 26379),\n }));\n\n const ioredis =\n opts.module ?? ModuleUtility.loadSync<typeof import('ioredis')>({ module: 'ioredis' });\n\n super({\n ...opts,\n scope: RedisSentinelHelper.name,\n identifier: name,\n // Precedence (low -> high): framework defaults, the redisOptions escape hatch, then first-class fields. Optional auth fields are spread ONLY when provided, so a value set via redisOptions is not clobbered by an undefined first-class field.\n client: new ioredis.Redis({\n ...AbstractRedisHelper.buildDefaultOpts({ maxRetry }),\n ...redisOptions,\n sentinels: normalizedSentinels,\n name: masterName,\n role,\n db: database,\n lazyConnect: !autoConnect,\n ...(password === undefined ? {} : { password }),\n ...(sentinelPassword === undefined ? {} : { sentinelPassword }),\n ...(sentinelUsername === undefined ? {} : { sentinelUsername }),\n }),\n });\n }\n\n override getClient() {\n return this.client as Redis;\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"abstract.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/secrets/base/abstract.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAEhB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EAEvB,MAAM,WAAW,CAAC;AAOnB,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CACrE;AAoBD,8BAAsB,qBAAsB,SAAQ,UAAW,YAAW,cAAc;IACtF,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAC3C,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAE5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE,qBAAqB;IAevC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAC7E,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;QAChC,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAGhE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAelE,GAAG,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACrD,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"abstract.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/secrets/base/abstract.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAEhB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EAEvB,MAAM,WAAW,CAAC;AAOnB,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CACrE;AAoBD,8BAAsB,qBAAsB,SAAQ,UAAW,YAAW,cAAc;IACtF,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAC3C,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAE5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE,qBAAqB;IAevC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAC7E,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;QAChC,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAGhE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAelE,GAAG,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACrD,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7D,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBvE,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAI/C,iBAAiB,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,GAAG,IAAI;IAMlE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B/B,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,oBAAoB;YAWd,aAAa;YA6Cb,MAAM;YAoBN,gBAAgB;CAkB/B"}
|
|
@@ -3,7 +3,7 @@ import { getError } from '../../error/index.js';
|
|
|
3
3
|
const DEFAULT_CLOCK = { now: () => Date.now() };
|
|
4
4
|
const DEFAULT_TIMERS = {
|
|
5
5
|
set: (handler, ms) => setTimeout(handler, ms),
|
|
6
|
-
clear: handle => clearTimeout(handle),
|
|
6
|
+
clear: (handle) => clearTimeout(handle),
|
|
7
7
|
};
|
|
8
8
|
const DEFAULT_CACHE_TTL_SECONDS = 300;
|
|
9
9
|
const DEFAULT_RENEW_BEFORE_RATIO = 0.66;
|
|
@@ -57,7 +57,11 @@ export class AbstractSecretsHelper extends BaseHelper {
|
|
|
57
57
|
}
|
|
58
58
|
async get(opts) {
|
|
59
59
|
const bundle = await this.getBundle({ path: opts.path });
|
|
60
|
-
const raw = opts.key
|
|
60
|
+
const raw = opts.key
|
|
61
|
+
? Object.hasOwn(bundle, opts.key)
|
|
62
|
+
? bundle[opts.key]
|
|
63
|
+
: undefined
|
|
64
|
+
: bundle;
|
|
61
65
|
return (raw ?? opts.defaultValue);
|
|
62
66
|
}
|
|
63
67
|
async lease(opts) {
|
|
@@ -134,7 +138,7 @@ export class AbstractSecretsHelper extends BaseHelper {
|
|
|
134
138
|
this.timers.clear(existing);
|
|
135
139
|
}
|
|
136
140
|
const handle = this.timers.set(() => {
|
|
137
|
-
this.handleRenewal({ key: opts.key }).catch(error => {
|
|
141
|
+
this.handleRenewal({ key: opts.key }).catch((error) => {
|
|
138
142
|
this.logger
|
|
139
143
|
.for(this.armTimer.name)
|
|
140
144
|
.error('Renewal handler crashed | key: %s | error: %s', opts.key, error);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport type {\n IClock,\n IGetSecretOptions,\n ISecretLease,\n ISecretRotatable,\n ISecretRotationEvent,\n ISecretsHelper,\n ISecretsHelperOptions,\n ITimerAdapter,\n TSecretRotationHandler,\n TTimerHandle,\n} from '../common';\n\ninterface ICacheEntry {\n value: Record<string, string>;\n expiresAt: number;\n}\n\ninterface IRawFetchResult {\n value: Record<string, string>;\n lease?: { leaseId: string; ttlSeconds: number; renewable: boolean };\n}\n\nconst DEFAULT_CLOCK: IClock = { now: () => Date.now() };\nconst DEFAULT_TIMERS: ITimerAdapter = {\n set: (handler, ms) => setTimeout(handler, ms),\n clear: handle => clearTimeout(handle as AnyType),\n};\n\nconst DEFAULT_CACHE_TTL_SECONDS = 300;\nconst DEFAULT_RENEW_BEFORE_RATIO = 0.66;\n\n// setTimeout coerces any delay above this to 1ms, triggering an immediate renewal storm.\nconst TIMEOUT_MAX_MS = 2_147_483_647;\n// Floor so an invalid/tiny ttl never becomes a 0ms busy-loop.\nconst MIN_RENEW_DELAY_MS = 1_000;\n// Bounded exponential backoff for the renewal retry loop when Vault is unreachable.\nconst BACKOFF_BASE_MS = 1_000;\n// Capped at 31 to keep 2 ** (attempt - 1) inside double range: past ~1024 it overflows to Infinity and clampDelayMs's non-finite branch returns the FLOOR, collapsing a long backoff into a 1/sec retry storm.\nconst MAX_BACKOFF_ATTEMPT_EXPONENT = 31;\n\nexport abstract class AbstractSecretsHelper extends BaseHelper implements ISecretsHelper {\n protected readonly clock: IClock;\n protected readonly timers: ITimerAdapter;\n protected readonly cacheTtlSeconds: number;\n protected readonly renewBeforeRatio: number;\n\n private readonly cache = new Map<string, ICacheEntry>();\n private readonly leases = new Map<string, ISecretLease>();\n private readonly leasePaths = new Map<string, string>();\n private readonly timerHandles = new Map<string, TTimerHandle>();\n private readonly rotatables = new Map<string, ISecretRotatable[]>();\n private readonly rotateHandlers: TSecretRotationHandler[] = [];\n private readonly backoffAttempts = new Map<string, number>();\n private closed = false;\n\n constructor(opts: ISecretsHelperOptions) {\n super({ scope: opts.scope, identifier: opts.identifier });\n this.clock = opts.clock ?? DEFAULT_CLOCK;\n this.timers = opts.timers ?? DEFAULT_TIMERS;\n this.cacheTtlSeconds = opts.cacheTtlSeconds ?? DEFAULT_CACHE_TTL_SECONDS;\n\n const ratio = opts.renewBeforeRatio ?? DEFAULT_RENEW_BEFORE_RATIO;\n if (!Number.isFinite(ratio) || ratio <= 0 || ratio > 1) {\n throw getError({\n message: `[constructor] renewBeforeRatio must be within (0, 1] | received: ${ratio}`,\n });\n }\n this.renewBeforeRatio = ratio;\n }\n\n protected abstract fetchRaw(opts: { path: string }): Promise<IRawFetchResult>;\n protected abstract renewRaw(opts: {\n leaseId: string;\n ttlSeconds: number;\n }): Promise<{ ttlSeconds: number } | null>;\n protected abstract revokeRaw(opts: { leaseId: string }): Promise<void>;\n\n // Concrete providers override to authenticate; default is a no-op.\n async configure(): Promise<void> {\n return;\n }\n\n async getBundle(opts: { path: string }): Promise<Record<string, string>> {\n this.evictExpiredCache();\n const cached = this.cache.get(opts.path);\n if (cached && cached.expiresAt > this.clock.now()) {\n return cached.value;\n }\n const fresh = await this.fetchRaw({ path: opts.path });\n // A shutdown that ran while fetchRaw was in flight already cleared `cache` - honor that and hand back the fetched value uncached rather than resurrecting a map shutdown just emptied.\n if (this.closed) {\n return fresh.value;\n }\n this.writeCache({ path: opts.path, value: fresh.value });\n return fresh.value;\n }\n\n async get(opts: IGetSecretOptions<string>): Promise<string>;\n async get<TValue>(opts: IGetSecretOptions<TValue>): Promise<TValue>;\n async get<TValue = string>(opts: IGetSecretOptions<TValue>): Promise<TValue> {\n const bundle = await this.getBundle({ path: opts.path });\n const raw = opts.key ? bundle[opts.key] : (bundle as AnyType);\n return (raw ?? opts.defaultValue) as TValue;\n }\n\n async lease(opts: { path: string; key: string }): Promise<ISecretLease> {\n const fresh = await this.fetchRaw({ path: opts.path });\n // A shutdown that ran while fetchRaw was in flight already revoked/cleared every lease - committing this one now would resurrect leases/leasePaths with a lease no live provider will ever renew or revoke, so surface the shutdown instead of silently leaking it back in.\n if (this.closed) {\n throw getError({\n message: `[lease] Provider is shut down | path: ${opts.path} | key: ${opts.key}`,\n });\n }\n if (!fresh.lease) {\n throw getError({\n message: `[lease] Path returned no lease | path: ${opts.path} | key: ${opts.key}`,\n });\n }\n const lease: ISecretLease = { value: fresh.value, ...fresh.lease };\n this.leases.set(opts.key, lease);\n this.leasePaths.set(opts.key, opts.path);\n this.scheduleRenewal({ key: opts.key, lease });\n return lease;\n }\n\n onRotate(handler: TSecretRotationHandler): void {\n this.rotateHandlers.push(handler);\n }\n\n registerRotatable(opts: { key: string; target: ISecretRotatable }): void {\n const list = this.rotatables.get(opts.key) ?? [];\n list.push(opts.target);\n this.rotatables.set(opts.key, list);\n }\n\n async shutdown(): Promise<void> {\n const logger = this.logger.for(this.shutdown.name);\n this.closed = true;\n\n const timerHandlesValues = this.timerHandles.values();\n for (const handle of timerHandlesValues) {\n this.timers.clear(handle);\n }\n this.timerHandles.clear();\n this.backoffAttempts.clear();\n\n for (const [key, lease] of this.leases) {\n try {\n await this.revokeRaw({ leaseId: lease.leaseId });\n } catch (error) {\n logger.error(\n 'Revoke failed | key: %s | leaseId: %s | error: %s',\n key,\n lease.leaseId,\n error,\n );\n }\n }\n this.leases.clear();\n this.leasePaths.clear();\n this.cache.clear();\n }\n\n private writeCache(opts: { path: string; value: Record<string, string> }): void {\n this.cache.set(opts.path, {\n value: opts.value,\n expiresAt: this.clock.now() + this.cacheTtlSeconds * 1000,\n });\n }\n\n private evictExpiredCache(): void {\n const now = this.clock.now();\n for (const [path, entry] of this.cache) {\n if (entry.expiresAt <= now) {\n this.cache.delete(path);\n }\n }\n }\n\n private clampDelayMs(opts: { delayMs: number }): number {\n if (!Number.isFinite(opts.delayMs) || opts.delayMs <= 0) {\n return MIN_RENEW_DELAY_MS;\n }\n return Math.min(Math.max(opts.delayMs, MIN_RENEW_DELAY_MS), TIMEOUT_MAX_MS);\n }\n\n private armTimer(opts: { key: string; delayMs: number }): void {\n const existing = this.timerHandles.get(opts.key);\n if (existing) {\n this.timers.clear(existing);\n }\n const handle = this.timers.set(() => {\n this.handleRenewal({ key: opts.key }).catch(error => {\n this.logger\n .for(this.armTimer.name)\n .error('Renewal handler crashed | key: %s | error: %s', opts.key, error);\n });\n }, opts.delayMs);\n this.timerHandles.set(opts.key, handle);\n }\n\n private scheduleRenewal(opts: { key: string; lease: ISecretLease }): void {\n if (this.closed) {\n return;\n }\n this.backoffAttempts.delete(opts.key);\n const delayMs = this.clampDelayMs({\n delayMs: opts.lease.ttlSeconds * this.renewBeforeRatio * 1000,\n });\n this.armTimer({ key: opts.key, delayMs });\n }\n\n // A transient Vault failure must not kill the loop; retry with bounded exponential backoff.\n private scheduleBackoffRetry(opts: { key: string }): void {\n if (this.closed) {\n return;\n }\n const attempt = (this.backoffAttempts.get(opts.key) ?? 0) + 1;\n this.backoffAttempts.set(opts.key, attempt);\n const cappedAttempt = Math.min(attempt, MAX_BACKOFF_ATTEMPT_EXPONENT);\n const delayMs = this.clampDelayMs({ delayMs: BACKOFF_BASE_MS * 2 ** (cappedAttempt - 1) });\n this.armTimer({ key: opts.key, delayMs });\n }\n\n private async handleRenewal(opts: { key: string }): Promise<void> {\n if (this.closed) {\n return;\n }\n const logger = this.logger.for(this.handleRenewal.name);\n const lease = this.leases.get(opts.key);\n if (!lease) {\n logger.debug('No lease to renew | key: %s', opts.key);\n return;\n }\n try {\n if (!lease.renewable) {\n await this.rotate({ key: opts.key });\n return;\n }\n\n const renewed = await this.renewRaw({\n leaseId: lease.leaseId,\n ttlSeconds: lease.ttlSeconds,\n });\n if (this.closed) {\n return;\n }\n\n if (!renewed) {\n await this.rotate({ key: opts.key });\n return;\n }\n\n const next: ISecretLease = { ...lease, ttlSeconds: renewed.ttlSeconds };\n this.leases.set(opts.key, next);\n this.scheduleRenewal({ key: opts.key, lease: next });\n } catch (error) {\n if (this.closed) {\n return;\n }\n logger.error(\n 'Renewal cycle failed; scheduling backoff retry | key: %s | error: %s',\n opts.key,\n error,\n );\n this.scheduleBackoffRetry({ key: opts.key });\n }\n }\n\n private async rotate(opts: { key: string }): Promise<void> {\n const path = this.leasePaths.get(opts.key);\n if (!path) {\n throw getError({ message: `[rotate] No lease path registered | key: ${opts.key}` });\n }\n const fresh = await this.fetchRaw({ path });\n if (this.closed) {\n return;\n }\n if (!fresh.lease) {\n throw getError({ message: `[rotate] Path returned no lease on rotation | key: ${opts.key}` });\n }\n const lease: ISecretLease = { value: fresh.value, ...fresh.lease };\n this.leases.set(opts.key, lease);\n this.writeCache({ path, value: fresh.value });\n // Arm the next renewal BEFORE dispatching: a wedged consumer must not stall the loop.\n this.scheduleRenewal({ key: opts.key, lease });\n await this.dispatchRotation({ key: opts.key, lease });\n }\n\n private async dispatchRotation(event: ISecretRotationEvent): Promise<void> {\n const logger = this.logger.for(this.dispatchRotation.name);\n for (const handler of this.rotateHandlers) {\n try {\n await handler(event);\n } catch (error) {\n logger.error('onRotate handler failed | key: %s | error: %s', event.key, error);\n }\n }\n const targets = this.rotatables.get(event.key) ?? [];\n for (const target of targets) {\n try {\n await target.onSecretRotated({ key: event.key, secret: event.lease.value });\n } catch (error) {\n logger.error('Rotatable failed | key: %s | error: %s', event.key, error);\n }\n }\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport type {\n IClock,\n IGetSecretOptions,\n ISecretLease,\n ISecretRotatable,\n ISecretRotationEvent,\n ISecretsHelper,\n ISecretsHelperOptions,\n ITimerAdapter,\n TSecretRotationHandler,\n TTimerHandle,\n} from '../common';\n\ninterface ICacheEntry {\n value: Record<string, string>;\n expiresAt: number;\n}\n\ninterface IRawFetchResult {\n value: Record<string, string>;\n lease?: { leaseId: string; ttlSeconds: number; renewable: boolean };\n}\n\nconst DEFAULT_CLOCK: IClock = { now: () => Date.now() };\nconst DEFAULT_TIMERS: ITimerAdapter = {\n set: (handler, ms) => setTimeout(handler, ms),\n clear: (handle) => clearTimeout(handle as AnyType),\n};\n\nconst DEFAULT_CACHE_TTL_SECONDS = 300;\nconst DEFAULT_RENEW_BEFORE_RATIO = 0.66;\n\n// setTimeout coerces any delay above this to 1ms, triggering an immediate renewal storm.\nconst TIMEOUT_MAX_MS = 2_147_483_647;\n// Floor so an invalid/tiny ttl never becomes a 0ms busy-loop.\nconst MIN_RENEW_DELAY_MS = 1_000;\n// Bounded exponential backoff for the renewal retry loop when Vault is unreachable.\nconst BACKOFF_BASE_MS = 1_000;\n// Capped at 31 to keep 2 ** (attempt - 1) inside double range: past ~1024 it overflows to Infinity and clampDelayMs's non-finite branch returns the FLOOR, collapsing a long backoff into a 1/sec retry storm.\nconst MAX_BACKOFF_ATTEMPT_EXPONENT = 31;\n\nexport abstract class AbstractSecretsHelper extends BaseHelper implements ISecretsHelper {\n protected readonly clock: IClock;\n protected readonly timers: ITimerAdapter;\n protected readonly cacheTtlSeconds: number;\n protected readonly renewBeforeRatio: number;\n\n private readonly cache = new Map<string, ICacheEntry>();\n private readonly leases = new Map<string, ISecretLease>();\n private readonly leasePaths = new Map<string, string>();\n private readonly timerHandles = new Map<string, TTimerHandle>();\n private readonly rotatables = new Map<string, ISecretRotatable[]>();\n private readonly rotateHandlers: TSecretRotationHandler[] = [];\n private readonly backoffAttempts = new Map<string, number>();\n private closed = false;\n\n constructor(opts: ISecretsHelperOptions) {\n super({ scope: opts.scope, identifier: opts.identifier });\n this.clock = opts.clock ?? DEFAULT_CLOCK;\n this.timers = opts.timers ?? DEFAULT_TIMERS;\n this.cacheTtlSeconds = opts.cacheTtlSeconds ?? DEFAULT_CACHE_TTL_SECONDS;\n\n const ratio = opts.renewBeforeRatio ?? DEFAULT_RENEW_BEFORE_RATIO;\n if (!Number.isFinite(ratio) || ratio <= 0 || ratio > 1) {\n throw getError({\n message: `[constructor] renewBeforeRatio must be within (0, 1] | received: ${ratio}`,\n });\n }\n this.renewBeforeRatio = ratio;\n }\n\n protected abstract fetchRaw(opts: { path: string }): Promise<IRawFetchResult>;\n protected abstract renewRaw(opts: {\n leaseId: string;\n ttlSeconds: number;\n }): Promise<{ ttlSeconds: number } | null>;\n protected abstract revokeRaw(opts: { leaseId: string }): Promise<void>;\n\n // Concrete providers override to authenticate; default is a no-op.\n async configure(): Promise<void> {\n return;\n }\n\n async getBundle(opts: { path: string }): Promise<Record<string, string>> {\n this.evictExpiredCache();\n const cached = this.cache.get(opts.path);\n if (cached && cached.expiresAt > this.clock.now()) {\n return cached.value;\n }\n const fresh = await this.fetchRaw({ path: opts.path });\n // A shutdown that ran while fetchRaw was in flight already cleared `cache` - honor that and hand back the fetched value uncached rather than resurrecting a map shutdown just emptied.\n if (this.closed) {\n return fresh.value;\n }\n this.writeCache({ path: opts.path, value: fresh.value });\n return fresh.value;\n }\n\n async get(opts: IGetSecretOptions<string>): Promise<string>;\n async get<TValue>(opts: IGetSecretOptions<TValue>): Promise<TValue>;\n async get<TValue = string>(opts: IGetSecretOptions<TValue>): Promise<TValue> {\n const bundle = await this.getBundle({ path: opts.path });\n const raw = opts.key\n ? Object.hasOwn(bundle, opts.key)\n ? bundle[opts.key]\n : undefined\n : (bundle as AnyType);\n return (raw ?? opts.defaultValue) as TValue;\n }\n\n async lease(opts: { path: string; key: string }): Promise<ISecretLease> {\n const fresh = await this.fetchRaw({ path: opts.path });\n // A shutdown that ran while fetchRaw was in flight already revoked/cleared every lease - committing this one now would resurrect leases/leasePaths with a lease no live provider will ever renew or revoke, so surface the shutdown instead of silently leaking it back in.\n if (this.closed) {\n throw getError({\n message: `[lease] Provider is shut down | path: ${opts.path} | key: ${opts.key}`,\n });\n }\n if (!fresh.lease) {\n throw getError({\n message: `[lease] Path returned no lease | path: ${opts.path} | key: ${opts.key}`,\n });\n }\n const lease: ISecretLease = { value: fresh.value, ...fresh.lease };\n this.leases.set(opts.key, lease);\n this.leasePaths.set(opts.key, opts.path);\n this.scheduleRenewal({ key: opts.key, lease });\n return lease;\n }\n\n onRotate(handler: TSecretRotationHandler): void {\n this.rotateHandlers.push(handler);\n }\n\n registerRotatable(opts: { key: string; target: ISecretRotatable }): void {\n const list = this.rotatables.get(opts.key) ?? [];\n list.push(opts.target);\n this.rotatables.set(opts.key, list);\n }\n\n async shutdown(): Promise<void> {\n const logger = this.logger.for(this.shutdown.name);\n this.closed = true;\n\n const timerHandlesValues = this.timerHandles.values();\n for (const handle of timerHandlesValues) {\n this.timers.clear(handle);\n }\n this.timerHandles.clear();\n this.backoffAttempts.clear();\n\n for (const [key, lease] of this.leases) {\n try {\n await this.revokeRaw({ leaseId: lease.leaseId });\n } catch (error) {\n logger.error(\n 'Revoke failed | key: %s | leaseId: %s | error: %s',\n key,\n lease.leaseId,\n error,\n );\n }\n }\n this.leases.clear();\n this.leasePaths.clear();\n this.cache.clear();\n }\n\n private writeCache(opts: { path: string; value: Record<string, string> }): void {\n this.cache.set(opts.path, {\n value: opts.value,\n expiresAt: this.clock.now() + this.cacheTtlSeconds * 1000,\n });\n }\n\n private evictExpiredCache(): void {\n const now = this.clock.now();\n for (const [path, entry] of this.cache) {\n if (entry.expiresAt <= now) {\n this.cache.delete(path);\n }\n }\n }\n\n private clampDelayMs(opts: { delayMs: number }): number {\n if (!Number.isFinite(opts.delayMs) || opts.delayMs <= 0) {\n return MIN_RENEW_DELAY_MS;\n }\n return Math.min(Math.max(opts.delayMs, MIN_RENEW_DELAY_MS), TIMEOUT_MAX_MS);\n }\n\n private armTimer(opts: { key: string; delayMs: number }): void {\n const existing = this.timerHandles.get(opts.key);\n if (existing) {\n this.timers.clear(existing);\n }\n const handle = this.timers.set(() => {\n this.handleRenewal({ key: opts.key }).catch((error) => {\n this.logger\n .for(this.armTimer.name)\n .error('Renewal handler crashed | key: %s | error: %s', opts.key, error);\n });\n }, opts.delayMs);\n this.timerHandles.set(opts.key, handle);\n }\n\n private scheduleRenewal(opts: { key: string; lease: ISecretLease }): void {\n if (this.closed) {\n return;\n }\n this.backoffAttempts.delete(opts.key);\n const delayMs = this.clampDelayMs({\n delayMs: opts.lease.ttlSeconds * this.renewBeforeRatio * 1000,\n });\n this.armTimer({ key: opts.key, delayMs });\n }\n\n // A transient Vault failure must not kill the loop; retry with bounded exponential backoff.\n private scheduleBackoffRetry(opts: { key: string }): void {\n if (this.closed) {\n return;\n }\n const attempt = (this.backoffAttempts.get(opts.key) ?? 0) + 1;\n this.backoffAttempts.set(opts.key, attempt);\n const cappedAttempt = Math.min(attempt, MAX_BACKOFF_ATTEMPT_EXPONENT);\n const delayMs = this.clampDelayMs({ delayMs: BACKOFF_BASE_MS * 2 ** (cappedAttempt - 1) });\n this.armTimer({ key: opts.key, delayMs });\n }\n\n private async handleRenewal(opts: { key: string }): Promise<void> {\n if (this.closed) {\n return;\n }\n const logger = this.logger.for(this.handleRenewal.name);\n const lease = this.leases.get(opts.key);\n if (!lease) {\n logger.debug('No lease to renew | key: %s', opts.key);\n return;\n }\n try {\n if (!lease.renewable) {\n await this.rotate({ key: opts.key });\n return;\n }\n\n const renewed = await this.renewRaw({\n leaseId: lease.leaseId,\n ttlSeconds: lease.ttlSeconds,\n });\n if (this.closed) {\n return;\n }\n\n if (!renewed) {\n await this.rotate({ key: opts.key });\n return;\n }\n\n const next: ISecretLease = { ...lease, ttlSeconds: renewed.ttlSeconds };\n this.leases.set(opts.key, next);\n this.scheduleRenewal({ key: opts.key, lease: next });\n } catch (error) {\n if (this.closed) {\n return;\n }\n logger.error(\n 'Renewal cycle failed; scheduling backoff retry | key: %s | error: %s',\n opts.key,\n error,\n );\n this.scheduleBackoffRetry({ key: opts.key });\n }\n }\n\n private async rotate(opts: { key: string }): Promise<void> {\n const path = this.leasePaths.get(opts.key);\n if (!path) {\n throw getError({ message: `[rotate] No lease path registered | key: ${opts.key}` });\n }\n const fresh = await this.fetchRaw({ path });\n if (this.closed) {\n return;\n }\n if (!fresh.lease) {\n throw getError({ message: `[rotate] Path returned no lease on rotation | key: ${opts.key}` });\n }\n const lease: ISecretLease = { value: fresh.value, ...fresh.lease };\n this.leases.set(opts.key, lease);\n this.writeCache({ path, value: fresh.value });\n // Arm the next renewal BEFORE dispatching: a wedged consumer must not stall the loop.\n this.scheduleRenewal({ key: opts.key, lease });\n await this.dispatchRotation({ key: opts.key, lease });\n }\n\n private async dispatchRotation(event: ISecretRotationEvent): Promise<void> {\n const logger = this.logger.for(this.dispatchRotation.name);\n for (const handler of this.rotateHandlers) {\n try {\n await handler(event);\n } catch (error) {\n logger.error('onRotate handler failed | key: %s | error: %s', event.key, error);\n }\n }\n const targets = this.rotatables.get(event.key) ?? [];\n for (const target of targets) {\n try {\n await target.onSecretRotated({ key: event.key, secret: event.lease.value });\n } catch (error) {\n logger.error('Rotatable failed | key: %s | error: %s', event.key, error);\n }\n }\n }\n}\n"]}
|
|
@@ -104,7 +104,7 @@ export class HashiCorpVaultHelper extends AbstractSecretsHelper {
|
|
|
104
104
|
}
|
|
105
105
|
const delayMs = Math.max(0, opts.ttlSeconds * this.renewBeforeRatio * 1000);
|
|
106
106
|
this.tokenTimer = this.timers.set(() => {
|
|
107
|
-
this.handleTokenRenewal().catch(error => {
|
|
107
|
+
this.handleTokenRenewal().catch((error) => {
|
|
108
108
|
this.logger
|
|
109
109
|
.for(this.scheduleTokenRenewal.name)
|
|
110
110
|
.error('Token renewal handler crashed | error: %s', error);
|
|
@@ -120,7 +120,7 @@ export class HashiCorpVaultHelper extends AbstractSecretsHelper {
|
|
|
120
120
|
const backoffSeconds = Math.min(HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_CAP_SECONDS, HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_BASE_SECONDS *
|
|
121
121
|
2 ** (this.tokenRenewalRetryCount - 1));
|
|
122
122
|
this.tokenTimer = this.timers.set(() => {
|
|
123
|
-
this.handleTokenRenewal().catch(error => {
|
|
123
|
+
this.handleTokenRenewal().catch((error) => {
|
|
124
124
|
this.logger
|
|
125
125
|
.for(this.scheduleTokenRenewalRetry.name)
|
|
126
126
|
.error('Token renewal retry handler crashed | error: %s', error);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hashicorp.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/hashicorp.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { AnyObject, AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { AbstractSecretsHelper } from '../base';\nimport { VaultAuthMethods, type IClock, type ITimerAdapter, type TTimerHandle } from '../common';\nimport { vaultAuthSchema, type TVaultAuth } from './auth';\n\n// node-vault's wire contract uses snake_case (role_id, secret_id, client_token, lease_duration, ...); built/read via bracket-notation on AnyObject here so the snake_case stays confined to this boundary instead of leaking into our camelCase-only typing convention.\ninterface TVaultClient {\n token: string;\n read(path: string): Promise<AnyType>;\n write(path: string, data: AnyObject): Promise<AnyType>;\n approleLogin(opts: AnyObject): Promise<AnyType>;\n kubernetesLogin?(opts: AnyObject): Promise<AnyType>;\n tokenRenewSelf(): Promise<AnyType>;\n tokenLookupSelf(): Promise<AnyType>;\n}\n\nexport interface IHashiCorpVaultHelperOptions {\n endpoint: string;\n auth: TVaultAuth;\n identifier?: string;\n cacheTtlSeconds?: number;\n renewBeforeRatio?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n /** Injection seam for tests; production builds the real node-vault client in configure(). */\n client?: TVaultClient;\n}\n\nexport class HashiCorpVaultHelper extends AbstractSecretsHelper {\n private static readonly TOKEN_RENEWAL_RETRY_BASE_SECONDS = 1;\n private static readonly TOKEN_RENEWAL_RETRY_CAP_SECONDS = 60;\n\n private readonly endpoint: string;\n private readonly auth: TVaultAuth;\n private client?: TVaultClient;\n private tokenTimer?: TTimerHandle;\n private tokenRenewalRetryCount = 0;\n\n constructor(opts: IHashiCorpVaultHelperOptions) {\n super({\n scope: HashiCorpVaultHelper.name,\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n clock: opts.clock,\n timers: opts.timers,\n });\n this.endpoint = opts.endpoint;\n try {\n this.auth = vaultAuthSchema.parse(opts.auth);\n } catch (error) {\n throw getError({\n message: `[HashiCorpVaultHelper] Invalid Vault auth configuration | ${\n error instanceof Error ? error.message : String(error)\n }`,\n });\n }\n this.client = opts.client;\n }\n\n override async configure(): Promise<void> {\n const logger = this.logger.for(this.configure.name);\n if (!this.client) {\n const factory = (await ModuleUtility.load<AnyType>({ module: 'node-vault' })).default;\n this.client = factory({ endpoint: this.endpoint, apiVersion: 'v1' }) as TVaultClient;\n }\n const { ttlSeconds, renewable } = await this.login();\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n logger.info('Vault authenticated | endpoint: %s | method: %s', this.endpoint, this.auth.method);\n }\n\n override async shutdown(): Promise<void> {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n this.tokenTimer = undefined;\n }\n await super.shutdown();\n }\n\n private requireClient(): TVaultClient {\n if (!this.client) {\n throw getError({ message: '[HashiCorpVaultHelper] configure() must run before use' });\n }\n return this.client;\n }\n\n /** Authenticates against Vault and returns the resulting token's TTL/renewability so callers can schedule self-renewal. */\n private async login(): Promise<{ ttlSeconds: number; renewable: boolean }> {\n const client = this.requireClient();\n\n switch (this.auth.method) {\n case VaultAuthMethods.TOKEN: {\n client.token = this.auth.token;\n const res = await client.tokenLookupSelf();\n return {\n ttlSeconds: Number(res?.data?.['ttl'] ?? 0),\n renewable: Boolean(res?.data?.['renewable']),\n };\n }\n case VaultAuthMethods.APP_ROLE: {\n const payload: AnyObject = {};\n payload['role_id'] = this.auth.roleId;\n payload['secret_id'] = this.auth.secretId;\n payload['mount_point'] = this.auth.mountPath ?? 'approle';\n const res = await client.approleLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n case VaultAuthMethods.KUBERNETES: {\n if (!client.kubernetesLogin) {\n throw getError({\n message: '[HashiCorpVaultHelper.login] node-vault client lacks kubernetesLogin',\n });\n }\n const jwt = (\n await readFile(\n this.auth.jwtPath ?? '/var/run/secrets/kubernetes.io/serviceaccount/token',\n 'utf8',\n )\n ).trimEnd();\n const payload: AnyObject = { role: this.auth.role, jwt };\n payload['mount_point'] = this.auth.mountPath ?? 'kubernetes';\n const res = await client.kubernetesLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n default: {\n throw getError({ message: '[HashiCorpVaultHelper.login] Unsupported auth method' });\n }\n }\n }\n\n private scheduleTokenRenewal(opts: { ttlSeconds: number }): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n const delayMs = Math.max(0, opts.ttlSeconds * this.renewBeforeRatio * 1000);\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch(error => {\n this.logger\n .for(this.scheduleTokenRenewal.name)\n .error('Token renewal handler crashed | error: %s', error);\n });\n }, delayMs);\n }\n\n /** Without a reschedule here, a transient re-auth failure lets the token expire silently with no recovery - retry with the same capped exponential backoff as lease renewal. */\n private scheduleTokenRenewalRetry(): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n this.tokenRenewalRetryCount += 1;\n const backoffSeconds = Math.min(\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_CAP_SECONDS,\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_BASE_SECONDS *\n 2 ** (this.tokenRenewalRetryCount - 1),\n );\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch(error => {\n this.logger\n .for(this.scheduleTokenRenewalRetry.name)\n .error('Token renewal retry handler crashed | error: %s', error);\n });\n }, backoffSeconds * 1000);\n }\n\n private async handleTokenRenewal(): Promise<void> {\n const logger = this.logger.for(this.handleTokenRenewal.name);\n\n try {\n const res = await this.requireClient().tokenRenewSelf();\n const ttlSeconds = Number(res?.auth?.['lease_duration'] ?? 0);\n const renewable = Boolean(res?.auth?.['renewable']);\n if (renewable && ttlSeconds > 0) {\n this.tokenRenewalRetryCount = 0;\n this.scheduleTokenRenewal({ ttlSeconds });\n return;\n }\n logger.warn('Token renewal returned a non-renewable/expired token; re-authenticating');\n } catch (error) {\n logger.warn('Token renewal failed; re-authenticating | error: %s', error);\n }\n\n try {\n const { ttlSeconds, renewable } = await this.login();\n this.tokenRenewalRetryCount = 0;\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n } catch (error) {\n logger.error('Token re-authentication failed; scheduling bounded retry | error: %s', error);\n this.scheduleTokenRenewalRetry();\n }\n }\n\n protected async fetchRaw(opts: { path: string }) {\n const res = await this.requireClient().read(opts.path);\n const nested = res?.['data']?.['data'];\n const inner = nested && typeof nested === 'object' ? nested : res?.['data'];\n const value: Record<string, string> = {};\n const innerEntries = Object.entries(inner ?? {});\n for (const [key, raw] of innerEntries) {\n value[key] = typeof raw === 'string' ? raw : JSON.stringify(raw);\n }\n const leaseId = res?.['lease_id'];\n if (leaseId) {\n return {\n value,\n lease: {\n leaseId,\n ttlSeconds: res['lease_duration'] ?? 0,\n renewable: Boolean(res['renewable']),\n },\n };\n }\n return { value };\n }\n\n protected async renewRaw(opts: { leaseId: string; ttlSeconds: number }) {\n const logger = this.logger.for(this.renewRaw.name);\n try {\n const payload: AnyObject = { increment: opts.ttlSeconds };\n payload['lease_id'] = opts.leaseId;\n const res = await this.requireClient().write('sys/leases/renew', payload);\n return { ttlSeconds: res['lease_duration'] ?? opts.ttlSeconds };\n } catch (error) {\n logger.warn('Renew rejected | leaseId: %s | error: %s', opts.leaseId, error);\n return null;\n }\n }\n\n protected async revokeRaw(opts: { leaseId: string }) {\n const payload: AnyObject = {};\n payload['lease_id'] = opts.leaseId;\n await this.requireClient().write('sys/leases/revoke', payload);\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"hashicorp.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/hashicorp.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAsD,MAAM,WAAW,CAAC;AACjG,OAAO,EAAE,eAAe,EAAmB,MAAM,QAAQ,CAAC;AAyB1D,MAAM,OAAO,oBAAqB,SAAQ,qBAAqB;aACrC,qCAAgC,GAAG,CAAC,AAAJ,CAAK;aACrC,oCAA+B,GAAG,EAAE,AAAL,CAAM;IAQ7D,YAAY,IAAkC;QAC5C,KAAK,CAAC;YACJ,KAAK,EAAE,oBAAoB,CAAC,IAAI;YAChC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QAVG,2BAAsB,GAAG,CAAC,CAAC;QAWjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,6DACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE;aACH,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;IAEQ,KAAK,CAAC,SAAS;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,CAAC,MAAM,aAAa,CAAC,IAAI,CAAU,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACtF,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAiB,CAAC;QACvF,CAAC;QACD,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrD,IAAI,SAAS,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClG,CAAC;IAEQ,KAAK,CAAC,QAAQ;QACrB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QACD,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,wDAAwD,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,2HAA2H;IACnH,KAAK,CAAC,KAAK;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAEpC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC3C,OAAO;oBACL,UAAU,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC3C,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC;iBAC7C,CAAC;YACJ,CAAC;YACD,KAAK,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC/B,MAAM,OAAO,GAAc,EAAE,CAAC;gBAC9B,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;gBACtC,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC1C,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;gBAC1D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC/C,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBACxC,OAAO;oBACL,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;oBACnD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;iBAC1C,CAAC;YACJ,CAAC;YACD,KAAK,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;gBACjC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;oBAC5B,MAAM,QAAQ,CAAC;wBACb,OAAO,EAAE,sEAAsE;qBAChF,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,GAAG,GAAG,CACV,MAAM,QAAQ,CACZ,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,qDAAqD,EAC1E,MAAM,CACP,CACF,CAAC,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,GAAc,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;gBACzD,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC;gBAC7D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBAClD,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBACxC,OAAO;oBACL,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;oBACnD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;iBAC1C,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,sDAAsD,EAAE,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,IAA4B;QACvD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;QAC5E,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxC,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;qBACnC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED,gLAAgL;IACxK,yBAAyB;QAC/B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAC;QACjC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAC7B,oBAAoB,CAAC,+BAA+B,EACpD,oBAAoB,CAAC,gCAAgC;YACnD,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC,CACzC,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxC,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC;qBACxC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;YACrE,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAE7D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,cAAc,EAAE,CAAC;YACxD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YACpD,IAAI,SAAS,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC;gBAChC,IAAI,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC1C,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QACzF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,qDAAqD,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACrD,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC;YAChC,IAAI,SAAS,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sEAAsE,EAAE,KAAK,CAAC,CAAC;YAC5F,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAES,KAAK,CAAC,QAAQ,CAAC,IAAsB;QAC7C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;QAC5E,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,YAAY,EAAE,CAAC;YACtC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO;gBACL,KAAK;gBACL,KAAK,EAAE;oBACL,OAAO;oBACP,UAAU,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC;oBACtC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;iBACrC;aACF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAES,KAAK,CAAC,QAAQ,CAAC,IAA6C;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,OAAO,GAAc,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1D,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YACnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YAC1E,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,IAAyB;QACjD,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACnC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { AnyObject, AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { AbstractSecretsHelper } from '../base';\nimport { VaultAuthMethods, type IClock, type ITimerAdapter, type TTimerHandle } from '../common';\nimport { vaultAuthSchema, type TVaultAuth } from './auth';\n\n// node-vault's wire contract uses snake_case (role_id, secret_id, client_token, lease_duration, ...); built/read via bracket-notation on AnyObject here so the snake_case stays confined to this boundary instead of leaking into our camelCase-only typing convention.\ninterface TVaultClient {\n token: string;\n read(path: string): Promise<AnyType>;\n write(path: string, data: AnyObject): Promise<AnyType>;\n approleLogin(opts: AnyObject): Promise<AnyType>;\n kubernetesLogin?(opts: AnyObject): Promise<AnyType>;\n tokenRenewSelf(): Promise<AnyType>;\n tokenLookupSelf(): Promise<AnyType>;\n}\n\nexport interface IHashiCorpVaultHelperOptions {\n endpoint: string;\n auth: TVaultAuth;\n identifier?: string;\n cacheTtlSeconds?: number;\n renewBeforeRatio?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n /** Injection seam for tests; production builds the real node-vault client in configure(). */\n client?: TVaultClient;\n}\n\nexport class HashiCorpVaultHelper extends AbstractSecretsHelper {\n private static readonly TOKEN_RENEWAL_RETRY_BASE_SECONDS = 1;\n private static readonly TOKEN_RENEWAL_RETRY_CAP_SECONDS = 60;\n\n private readonly endpoint: string;\n private readonly auth: TVaultAuth;\n private client?: TVaultClient;\n private tokenTimer?: TTimerHandle;\n private tokenRenewalRetryCount = 0;\n\n constructor(opts: IHashiCorpVaultHelperOptions) {\n super({\n scope: HashiCorpVaultHelper.name,\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n clock: opts.clock,\n timers: opts.timers,\n });\n this.endpoint = opts.endpoint;\n try {\n this.auth = vaultAuthSchema.parse(opts.auth);\n } catch (error) {\n throw getError({\n message: `[HashiCorpVaultHelper] Invalid Vault auth configuration | ${\n error instanceof Error ? error.message : String(error)\n }`,\n });\n }\n this.client = opts.client;\n }\n\n override async configure(): Promise<void> {\n const logger = this.logger.for(this.configure.name);\n if (!this.client) {\n const factory = (await ModuleUtility.load<AnyType>({ module: 'node-vault' })).default;\n this.client = factory({ endpoint: this.endpoint, apiVersion: 'v1' }) as TVaultClient;\n }\n const { ttlSeconds, renewable } = await this.login();\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n logger.info('Vault authenticated | endpoint: %s | method: %s', this.endpoint, this.auth.method);\n }\n\n override async shutdown(): Promise<void> {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n this.tokenTimer = undefined;\n }\n await super.shutdown();\n }\n\n private requireClient(): TVaultClient {\n if (!this.client) {\n throw getError({ message: '[HashiCorpVaultHelper] configure() must run before use' });\n }\n return this.client;\n }\n\n /** Authenticates against Vault and returns the resulting token's TTL/renewability so callers can schedule self-renewal. */\n private async login(): Promise<{ ttlSeconds: number; renewable: boolean }> {\n const client = this.requireClient();\n\n switch (this.auth.method) {\n case VaultAuthMethods.TOKEN: {\n client.token = this.auth.token;\n const res = await client.tokenLookupSelf();\n return {\n ttlSeconds: Number(res?.data?.['ttl'] ?? 0),\n renewable: Boolean(res?.data?.['renewable']),\n };\n }\n case VaultAuthMethods.APP_ROLE: {\n const payload: AnyObject = {};\n payload['role_id'] = this.auth.roleId;\n payload['secret_id'] = this.auth.secretId;\n payload['mount_point'] = this.auth.mountPath ?? 'approle';\n const res = await client.approleLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n case VaultAuthMethods.KUBERNETES: {\n if (!client.kubernetesLogin) {\n throw getError({\n message: '[HashiCorpVaultHelper.login] node-vault client lacks kubernetesLogin',\n });\n }\n const jwt = (\n await readFile(\n this.auth.jwtPath ?? '/var/run/secrets/kubernetes.io/serviceaccount/token',\n 'utf8',\n )\n ).trimEnd();\n const payload: AnyObject = { role: this.auth.role, jwt };\n payload['mount_point'] = this.auth.mountPath ?? 'kubernetes';\n const res = await client.kubernetesLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n default: {\n throw getError({ message: '[HashiCorpVaultHelper.login] Unsupported auth method' });\n }\n }\n }\n\n private scheduleTokenRenewal(opts: { ttlSeconds: number }): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n const delayMs = Math.max(0, opts.ttlSeconds * this.renewBeforeRatio * 1000);\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewal.name)\n .error('Token renewal handler crashed | error: %s', error);\n });\n }, delayMs);\n }\n\n /** Without a reschedule here, a transient re-auth failure lets the token expire silently with no recovery - retry with the same capped exponential backoff as lease renewal. */\n private scheduleTokenRenewalRetry(): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n this.tokenRenewalRetryCount += 1;\n const backoffSeconds = Math.min(\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_CAP_SECONDS,\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_BASE_SECONDS *\n 2 ** (this.tokenRenewalRetryCount - 1),\n );\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewalRetry.name)\n .error('Token renewal retry handler crashed | error: %s', error);\n });\n }, backoffSeconds * 1000);\n }\n\n private async handleTokenRenewal(): Promise<void> {\n const logger = this.logger.for(this.handleTokenRenewal.name);\n\n try {\n const res = await this.requireClient().tokenRenewSelf();\n const ttlSeconds = Number(res?.auth?.['lease_duration'] ?? 0);\n const renewable = Boolean(res?.auth?.['renewable']);\n if (renewable && ttlSeconds > 0) {\n this.tokenRenewalRetryCount = 0;\n this.scheduleTokenRenewal({ ttlSeconds });\n return;\n }\n logger.warn('Token renewal returned a non-renewable/expired token; re-authenticating');\n } catch (error) {\n logger.warn('Token renewal failed; re-authenticating | error: %s', error);\n }\n\n try {\n const { ttlSeconds, renewable } = await this.login();\n this.tokenRenewalRetryCount = 0;\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n } catch (error) {\n logger.error('Token re-authentication failed; scheduling bounded retry | error: %s', error);\n this.scheduleTokenRenewalRetry();\n }\n }\n\n protected async fetchRaw(opts: { path: string }) {\n const res = await this.requireClient().read(opts.path);\n const nested = res?.['data']?.['data'];\n const inner = nested && typeof nested === 'object' ? nested : res?.['data'];\n const value: Record<string, string> = {};\n const innerEntries = Object.entries(inner ?? {});\n for (const [key, raw] of innerEntries) {\n value[key] = typeof raw === 'string' ? raw : JSON.stringify(raw);\n }\n const leaseId = res?.['lease_id'];\n if (leaseId) {\n return {\n value,\n lease: {\n leaseId,\n ttlSeconds: res['lease_duration'] ?? 0,\n renewable: Boolean(res['renewable']),\n },\n };\n }\n return { value };\n }\n\n protected async renewRaw(opts: { leaseId: string; ttlSeconds: number }) {\n const logger = this.logger.for(this.renewRaw.name);\n try {\n const payload: AnyObject = { increment: opts.ttlSeconds };\n payload['lease_id'] = opts.leaseId;\n const res = await this.requireClient().write('sys/leases/renew', payload);\n return { ttlSeconds: res['lease_duration'] ?? opts.ttlSeconds };\n } catch (error) {\n logger.warn('Renew rejected | leaseId: %s | error: %s', opts.leaseId, error);\n return null;\n }\n }\n\n protected async revokeRaw(opts: { leaseId: string }) {\n const payload: AnyObject = {};\n payload['lease_id'] = opts.leaseId;\n await this.requireClient().write('sys/leases/revoke', payload);\n }\n}\n"]}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export * from './client/browser-helper.js';
|
|
2
|
+
export * from './common/constants.js';
|
|
3
|
+
export type { ISocketIOClientOptions, IOptions } from './common/types/client.js';
|
|
4
|
+
export type { TSocketIOEventHandler } from './common/types/hooks.js';
|
|
5
|
+
//# sourceMappingURL=browser.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../../src/modules/socket/socket-io/browser.ts"],"names":[],"mappings":"AAEA,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
// The browser-safe slice of the socket.io helpers: the client with nothing node in its graph, and
|
|
2
|
+
// the names and types it speaks. The server helper and the module loader stay on the main entry.
|
|
3
|
+
export * from './client/browser-helper.js';
|
|
4
|
+
export * from './common/constants.js';
|
|
5
|
+
//# sourceMappingURL=browser.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../../../src/modules/socket/socket-io/browser.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,iGAAiG;AACjG,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC","sourcesContent":["// The browser-safe slice of the socket.io helpers: the client with nothing node in its graph, and\n// the names and types it speaks. The server helper and the module loader stay on the main entry.\nexport * from './client/browser-helper';\nexport * from './common/constants';\nexport type { ISocketIOClientOptions, IOptions } from './common/types/client';\nexport type { TSocketIOEventHandler } from './common/types/hooks';\n"]}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { BaseHelper } from '../../../base.js';
|
|
2
|
+
import type { Socket } from 'socket.io-client';
|
|
3
|
+
import type { ISocketIOClientOptions, TSocketIOClientState } from '../common/types/client.js';
|
|
4
|
+
import type { TSocketIOEventHandler } from '../common/types/hooks.js';
|
|
5
|
+
/**
|
|
6
|
+
* The socket.io client with nothing node in its graph, so a browser bundle can hold it: `socket.io-client`
|
|
7
|
+
* is handed in as `module` (`{ io }` from the app's own `import`) instead of being found on disk.
|
|
8
|
+
* `@venizia/ignis-helpers/socket-io` extends it and finds the module itself when none is handed in.
|
|
9
|
+
*/
|
|
10
|
+
export declare class SocketIOClientHelper extends BaseHelper {
|
|
11
|
+
private host;
|
|
12
|
+
private options;
|
|
13
|
+
private client;
|
|
14
|
+
private state;
|
|
15
|
+
private wrappedHandlers;
|
|
16
|
+
private onConnected?;
|
|
17
|
+
private onDisconnected?;
|
|
18
|
+
private onError?;
|
|
19
|
+
private onAuthenticated?;
|
|
20
|
+
private onUnauthenticated?;
|
|
21
|
+
protected readonly clientModule?: typeof import('socket.io-client');
|
|
22
|
+
constructor(opts: ISocketIOClientOptions);
|
|
23
|
+
/** The `socket.io-client` module to connect with. Here only the one handed in; a subclass may find one. */
|
|
24
|
+
protected resolveModule(): typeof import('socket.io-client');
|
|
25
|
+
getState(): TSocketIOClientState;
|
|
26
|
+
configure(): void;
|
|
27
|
+
getSocketClient(): Socket;
|
|
28
|
+
authenticate(): void;
|
|
29
|
+
subscribe<T = unknown>(opts: {
|
|
30
|
+
event: string;
|
|
31
|
+
handler: TSocketIOEventHandler<T>;
|
|
32
|
+
ignoreDuplicate?: boolean;
|
|
33
|
+
}): void;
|
|
34
|
+
subscribeMany(opts: {
|
|
35
|
+
events: Record<string, TSocketIOEventHandler>;
|
|
36
|
+
ignoreDuplicate?: boolean;
|
|
37
|
+
}): void;
|
|
38
|
+
unsubscribe(opts: {
|
|
39
|
+
event: string;
|
|
40
|
+
handler?: TSocketIOEventHandler;
|
|
41
|
+
}): void;
|
|
42
|
+
unsubscribeMany(opts: {
|
|
43
|
+
events: string[];
|
|
44
|
+
}): void;
|
|
45
|
+
connect(): void;
|
|
46
|
+
disconnect(): void;
|
|
47
|
+
emit<T = unknown>(opts: {
|
|
48
|
+
topic: string;
|
|
49
|
+
data: T;
|
|
50
|
+
doLog?: boolean;
|
|
51
|
+
callback?: () => void;
|
|
52
|
+
}): void;
|
|
53
|
+
joinRooms(opts: {
|
|
54
|
+
rooms: string[];
|
|
55
|
+
}): void;
|
|
56
|
+
leaveRooms(opts: {
|
|
57
|
+
rooms: string[];
|
|
58
|
+
}): void;
|
|
59
|
+
shutdown(): void;
|
|
60
|
+
}
|
|
61
|
+
//# sourceMappingURL=browser-helper.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browser-helper.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/client/browser-helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,KAAK,EAEV,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAA2D;IAGxE,OAAO,CAAC,eAAe,CACX;IAEZ,OAAO,CAAC,WAAW,CAAC,CAA6B;IACjD,OAAO,CAAC,cAAc,CAAC,CAA2C;IAClE,OAAO,CAAC,OAAO,CAAC,CAAyC;IACzD,OAAO,CAAC,eAAe,CAAC,CAA6B;IACrD,OAAO,CAAC,iBAAiB,CAAC,CAA4C;IAEtE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,kBAAkB,CAAC,CAAC;gBAExD,IAAI,EAAE,sBAAsB;IAiBxC,2GAA2G;IAC3G,SAAS,CAAC,aAAa,IAAI,cAAc,kBAAkB,CAAC;IAW5D,QAAQ,IAAI,oBAAoB;IAIhC,SAAS;IA4DT,eAAe,IAAI,MAAM;IAIzB,YAAY;IAkBZ,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAClC,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IAkCD,aAAa,CAAC,IAAI,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IAYD,WAAW,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,qBAAqB,CAAA;KAAE;IAgCpE,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAM1C,OAAO;IAWP,UAAU;IAWV,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE;IA6B1F,SAAS,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE;IAanC,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE;IAapC,QAAQ;CAgBT"}
|