@venizia/ignis-helpers 0.4.8-9 → 0.4.8
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/README.md +2 -3
- package/dist/esm/common/constants/app.d.ts +1 -3
- package/dist/esm/common/constants/app.js +1 -11
- package/dist/esm/common/constants/app.js.map +1 -1
- package/dist/esm/common/constants/http.d.ts +2 -0
- package/dist/esm/common/constants/http.js +3 -0
- package/dist/esm/common/constants/http.js.map +1 -1
- package/dist/esm/common/constants/mime.d.ts +0 -2
- package/dist/esm/common/constants/mime.js +0 -4
- package/dist/esm/common/constants/mime.js.map +1 -1
- package/dist/esm/common/redact.js.map +1 -1
- package/dist/esm/common/types/class.d.ts +14 -12
- package/dist/esm/common/types/class.js.map +1 -1
- package/dist/esm/common/types/const-value.d.ts +3 -3
- package/dist/esm/common/types/const-value.js.map +1 -1
- package/dist/esm/common/types/field-mapping.d.ts +6 -8
- package/dist/esm/common/types/field-mapping.js +0 -10
- package/dist/esm/common/types/field-mapping.js.map +1 -1
- package/dist/esm/common/types/index.d.ts +1 -0
- package/dist/esm/common/types/index.js +1 -0
- package/dist/esm/common/types/index.js.map +1 -1
- package/dist/esm/common/types/injection.d.ts +1 -1
- package/dist/esm/common/types/injection.js.map +1 -1
- package/dist/esm/common/types/json.d.ts +14 -0
- package/dist/esm/common/types/json.js +2 -0
- package/dist/esm/common/types/json.js.map +1 -0
- package/dist/esm/common/types/utility.d.ts +0 -4
- package/dist/esm/common/types/utility.js.map +1 -1
- package/dist/esm/modules/env/app-env.d.ts +17 -8
- package/dist/esm/modules/env/app-env.js +18 -15
- package/dist/esm/modules/env/app-env.js.map +1 -1
- package/dist/esm/modules/env/common/types.d.ts +22 -6
- package/dist/esm/modules/env/common/types.js.map +1 -1
- package/dist/esm/modules/logger/base/abstract.d.ts +6 -7
- package/dist/esm/modules/logger/base/abstract.js.map +1 -1
- package/dist/esm/modules/logger/base/base.d.ts +7 -8
- package/dist/esm/modules/logger/base/base.js.map +1 -1
- package/dist/esm/modules/logger/base/console.d.ts +6 -7
- package/dist/esm/modules/logger/base/console.js.map +1 -1
- package/dist/esm/modules/logger/common/types.d.ts +7 -7
- package/dist/esm/modules/logger/common/types.js.map +1 -1
- package/dist/esm/modules/logger/factory.js.map +1 -1
- package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
- package/dist/esm/modules/logger/hf/logger.d.ts +6 -7
- package/dist/esm/modules/logger/hf/logger.js.map +1 -1
- package/dist/esm/modules/logger/pino/backing.js.map +1 -1
- package/dist/esm/modules/logger/pino/destination.d.ts +1 -1
- package/dist/esm/modules/logger/pino/destination.js.map +1 -1
- package/dist/esm/modules/logger/pino/logger.d.ts +1 -2
- package/dist/esm/modules/logger/pino/logger.js.map +1 -1
- package/dist/esm/modules/logger/winston/formats.js +2 -2
- package/dist/esm/modules/logger/winston/formats.js.map +1 -1
- package/dist/esm/modules/logger/winston/logger.d.ts +1 -2
- package/dist/esm/modules/logger/winston/logger.js.map +1 -1
- package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -1
- package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -1
- package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
- package/dist/esm/modules/network/http-request/common/constants.d.ts +0 -2
- package/dist/esm/modules/network/http-request/common/constants.js +0 -4
- package/dist/esm/modules/network/http-request/common/constants.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +6 -6
- 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 +2 -3
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts +1 -1
- package/dist/esm/modules/network/http-request/fetcher/common/types.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +1 -2
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +5 -6
- 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.d.ts +4 -4
- 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 +3 -5
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +0 -8
- package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
- package/dist/esm/modules/network/utilities/query-string.d.ts +2 -2
- package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +0 -2
- package/dist/esm/modules/network/utilities/url-safety/common/constants.js +0 -4
- package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
- package/dist/esm/modules/queue/bullmq/helper.d.ts +23 -10
- package/dist/esm/modules/queue/bullmq/helper.js +57 -10
- package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
- package/dist/esm/modules/queue/common/constants.d.ts +6 -2
- package/dist/esm/modules/queue/common/constants.js +6 -4
- package/dist/esm/modules/queue/common/constants.js.map +1 -1
- package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +2 -4
- package/dist/esm/modules/queue/internal/sequential/common/types.js +0 -4
- package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
- package/dist/esm/modules/queue/kafka/base.d.ts +1 -1
- package/dist/esm/modules/queue/kafka/base.js +13 -2
- package/dist/esm/modules/queue/kafka/base.js.map +1 -1
- package/dist/esm/modules/queue/kafka/common/constants.d.ts +0 -4
- package/dist/esm/modules/queue/kafka/common/constants.js +0 -8
- package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
- package/dist/esm/modules/redis/base/abstract.helper.d.ts +13 -2
- package/dist/esm/modules/redis/base/abstract.helper.js +53 -45
- package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
- package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -2
- package/dist/esm/modules/redis/cluster/cluster.helper.js +21 -9
- package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
- package/dist/esm/modules/redis/cluster/index.d.ts +1 -0
- package/dist/esm/modules/redis/cluster/index.js +1 -0
- package/dist/esm/modules/redis/cluster/index.js.map +1 -1
- package/dist/esm/modules/redis/cluster/types.d.ts +20 -0
- package/dist/esm/modules/redis/cluster/types.js +2 -0
- package/dist/esm/modules/redis/cluster/types.js.map +1 -0
- package/dist/esm/modules/redis/common/constants.d.ts +15 -19
- package/dist/esm/modules/redis/common/constants.js +16 -18
- package/dist/esm/modules/redis/common/constants.js.map +1 -1
- package/dist/esm/modules/redis/common/types.d.ts +10 -60
- package/dist/esm/modules/redis/common/types.js.map +1 -1
- package/dist/esm/modules/redis/factory.d.ts +7 -25
- package/dist/esm/modules/redis/factory.js +9 -18
- package/dist/esm/modules/redis/factory.js.map +1 -1
- package/dist/esm/modules/redis/sentinel/constants.d.ts +14 -0
- package/dist/esm/modules/redis/sentinel/constants.js +11 -0
- package/dist/esm/modules/redis/sentinel/constants.js.map +1 -0
- package/dist/esm/modules/redis/sentinel/index.d.ts +2 -0
- package/dist/esm/modules/redis/sentinel/index.js +2 -0
- package/dist/esm/modules/redis/sentinel/index.js.map +1 -1
- package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -2
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js +25 -15
- package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
- package/dist/esm/modules/redis/sentinel/types.d.ts +26 -0
- package/dist/esm/modules/redis/sentinel/types.js +2 -0
- package/dist/esm/modules/redis/sentinel/types.js.map +1 -0
- package/dist/esm/modules/redis/single/index.d.ts +1 -0
- package/dist/esm/modules/redis/single/index.js +1 -0
- package/dist/esm/modules/redis/single/index.js.map +1 -1
- package/dist/esm/modules/redis/single/single.helper.d.ts +1 -2
- package/dist/esm/modules/redis/single/single.helper.js +5 -6
- package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
- package/dist/esm/modules/redis/single/types.d.ts +15 -0
- package/dist/esm/modules/redis/single/types.js +2 -0
- package/dist/esm/modules/redis/single/types.js.map +1 -0
- package/dist/esm/modules/secrets/base/abstract.helper.js +6 -1
- package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
- package/dist/esm/modules/secrets/common/types/registration.d.ts +25 -6
- package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
- package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -1
- package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
- package/dist/esm/modules/secrets/factory.js +7 -6
- package/dist/esm/modules/secrets/factory.js.map +1 -1
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +12 -10
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +50 -25
- package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +2 -2
- package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +3 -1
- package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
- package/dist/esm/modules/socket/socket-io/server/helper.d.ts +2 -2
- package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
- package/dist/esm/modules/storage/base.d.ts +24 -60
- package/dist/esm/modules/storage/base.js +66 -123
- package/dist/esm/modules/storage/base.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/helper.d.ts +21 -35
- package/dist/esm/modules/storage/bun-s3/helper.js +126 -128
- package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
- package/dist/esm/modules/storage/bun-s3/utility.d.ts +13 -7
- package/dist/esm/modules/storage/bun-s3/utility.js +63 -45
- package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
- package/dist/esm/modules/storage/common/constants.d.ts +29 -2
- package/dist/esm/modules/storage/common/constants.js +29 -4
- package/dist/esm/modules/storage/common/constants.js.map +1 -1
- package/dist/esm/modules/storage/common/errors.d.ts +9 -0
- package/dist/esm/modules/storage/common/errors.js +9 -0
- package/dist/esm/modules/storage/common/errors.js.map +1 -1
- package/dist/esm/modules/storage/common/types.d.ts +90 -61
- package/dist/esm/modules/storage/common/types.js.map +1 -1
- package/dist/esm/modules/storage/common/utility.d.ts +8 -0
- package/dist/esm/modules/storage/common/utility.js +14 -2
- package/dist/esm/modules/storage/common/utility.js.map +1 -1
- package/dist/esm/modules/storage/disk/helper.d.ts +3 -8
- package/dist/esm/modules/storage/disk/helper.js +1 -0
- package/dist/esm/modules/storage/disk/helper.js.map +1 -1
- package/dist/esm/modules/storage/in-memory/helper.d.ts +2 -3
- package/dist/esm/modules/storage/in-memory/helper.js.map +1 -1
- package/dist/esm/modules/worker-thread/common/types.d.ts +2 -2
- package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
- package/dist/esm/modules/worker-thread/thread/abstract.d.ts +2 -2
- package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
- package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -1
- package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
- package/dist/esm/utilities/module.utility.d.ts +8 -5
- package/dist/esm/utilities/module.utility.js +5 -1
- package/dist/esm/utilities/module.utility.js.map +1 -1
- package/dist/esm/utilities/parse.utility.d.ts +34 -6
- package/dist/esm/utilities/parse.utility.js +82 -15
- package/dist/esm/utilities/parse.utility.js.map +1 -1
- package/dist/esm/utilities/performance.utility.d.ts +3 -3
- package/dist/esm/utilities/performance.utility.js.map +1 -1
- package/dist/esm/utilities/promise.utility.d.ts +1 -1
- package/dist/esm/utilities/promise.utility.js.map +1 -1
- package/dist/esm/utilities/request.utility.d.ts +9 -11
- package/dist/esm/utilities/request.utility.js.map +1 -1
- package/package.json +3 -3
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
var _a;
|
|
2
2
|
import { ObjectUtility } from '@venizia/ignis-inversion';
|
|
3
3
|
import { PromiseUtility } from '../../../utilities/promise.utility.js';
|
|
4
|
+
import { getError } from '../../error/index.js';
|
|
5
|
+
import { LoggerFactory } from '../../logger/index.js';
|
|
6
|
+
import { RetryHelper } from '../../retry/index.js';
|
|
4
7
|
import { BaseHelper } from '../../base.js';
|
|
5
8
|
import zlib from 'node:zlib';
|
|
6
|
-
import { RedisConcurrency } from './../common/constants.js';
|
|
9
|
+
import { RedisConcurrency, RedisDefaults } from './../common/constants.js';
|
|
7
10
|
/** Registry symbol that marks an instance as a Redis helper; `isRedisHelper` tests for it. */
|
|
8
11
|
export const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');
|
|
9
12
|
/** 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. */
|
|
@@ -38,20 +41,37 @@ export class AbstractRedisHelper extends BaseHelper {
|
|
|
38
41
|
});
|
|
39
42
|
onInitialized?.({ name: this.name, helper: this });
|
|
40
43
|
}
|
|
44
|
+
/** `maxRetry` is `0`, `RedisDefaults.RETRY_FOREVER` or a positive integer; anything else is a typo that would silently change how the client reconnects. */
|
|
45
|
+
static assertMaxRetry(opts) {
|
|
46
|
+
const { scope, name, maxRetry } = opts;
|
|
47
|
+
if (!Number.isInteger(maxRetry) || (maxRetry < 0 && maxRetry !== RedisDefaults.RETRY_FOREVER)) {
|
|
48
|
+
throw getError({
|
|
49
|
+
message: `[${scope}] maxRetry must be 0, ${RedisDefaults.RETRY_FOREVER} (forever) or a positive integer | name: ${name} | value: ${maxRetry}`,
|
|
50
|
+
});
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
/** The wait before each reconnect, then `undefined` once `maxRetry` attempts failed: ioredis stops and the helper logs it once. */
|
|
41
54
|
static buildRetryStrategy(opts) {
|
|
42
|
-
const { maxRetry } = opts;
|
|
43
|
-
|
|
44
|
-
|
|
55
|
+
const { scope, name, maxRetry } = opts;
|
|
56
|
+
AbstractRedisHelper.assertMaxRetry(opts);
|
|
57
|
+
return (attempt) => {
|
|
58
|
+
if (maxRetry !== RedisDefaults.RETRY_FOREVER && attempt > maxRetry) {
|
|
59
|
+
LoggerFactory.getLogger([scope, name])
|
|
60
|
+
.for('retry')
|
|
61
|
+
.error('Redis gave up reconnecting | Name: %s | maxRetry: %d', name, maxRetry);
|
|
45
62
|
return undefined;
|
|
46
63
|
}
|
|
47
|
-
return
|
|
64
|
+
return RetryHelper.computeBackoffDelayMs({
|
|
65
|
+
attempt,
|
|
66
|
+
backoff: RedisDefaults.RECONNECT_BACKOFF,
|
|
67
|
+
});
|
|
48
68
|
};
|
|
49
69
|
}
|
|
50
70
|
static buildDefaultOpts(opts) {
|
|
51
71
|
return {
|
|
52
72
|
showFriendlyErrorStack: true,
|
|
53
73
|
maxRetriesPerRequest: null,
|
|
54
|
-
retryStrategy: AbstractRedisHelper.buildRetryStrategy(
|
|
74
|
+
retryStrategy: AbstractRedisHelper.buildRetryStrategy(opts),
|
|
55
75
|
};
|
|
56
76
|
}
|
|
57
77
|
// --- Connection lifecycle (IRedisConnection) ---
|
|
@@ -66,45 +86,33 @@ export class AbstractRedisHelper extends BaseHelper {
|
|
|
66
86
|
ping() {
|
|
67
87
|
return this.client.ping();
|
|
68
88
|
}
|
|
69
|
-
connect() {
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
.for(this.disconnect.name)
|
|
97
|
-
.info('status: %s | Invalid redis status to invoke disconnect', this.client.status);
|
|
98
|
-
resolve(false);
|
|
99
|
-
return;
|
|
100
|
-
}
|
|
101
|
-
this.client
|
|
102
|
-
.quit()
|
|
103
|
-
.then((rs) => {
|
|
104
|
-
resolve(rs === 'OK');
|
|
105
|
-
})
|
|
106
|
-
.catch(reject);
|
|
107
|
-
});
|
|
89
|
+
async connect() {
|
|
90
|
+
// `connect` is the cluster-only step between `connecting` and `ready`: ioredis refuses a second connect() there as well.
|
|
91
|
+
const invalidStatuses = [
|
|
92
|
+
'ready',
|
|
93
|
+
'reconnecting',
|
|
94
|
+
'connecting',
|
|
95
|
+
'connect',
|
|
96
|
+
];
|
|
97
|
+
if (invalidStatuses.includes(this.client.status)) {
|
|
98
|
+
this.logger
|
|
99
|
+
.for(this.connect.name)
|
|
100
|
+
.info('status: %s | Invalid redis status to invoke connect', this.client.status);
|
|
101
|
+
return false;
|
|
102
|
+
}
|
|
103
|
+
await this.client.connect();
|
|
104
|
+
return this.client.status === 'ready';
|
|
105
|
+
}
|
|
106
|
+
async disconnect() {
|
|
107
|
+
const invalidStatuses = ['end', 'close'];
|
|
108
|
+
if (invalidStatuses.includes(this.client.status)) {
|
|
109
|
+
this.logger
|
|
110
|
+
.for(this.disconnect.name)
|
|
111
|
+
.info('status: %s | Invalid redis status to invoke disconnect', this.client.status);
|
|
112
|
+
return false;
|
|
113
|
+
}
|
|
114
|
+
const reply = await this.client.quit();
|
|
115
|
+
return reply === 'OK';
|
|
108
116
|
}
|
|
109
117
|
// --- Key lifecycle + counters (IRedisKey) ---
|
|
110
118
|
exists(opts) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport type { AnyType } from '@/common/types';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { type EventEmitter } from 'node:events';\nimport zlib from 'node:zlib';\nimport { RedisConcurrency } from './../common/constants';\nimport { type IRedisHelper } from './../common/interfaces';\nimport { type IRedisHelperCallbacks, type TRedisClient } from './../common/types';\n\n/** Registry symbol that marks an instance as a Redis helper; `isRedisHelper` tests for it. */\nexport const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');\n\n/** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */\nexport const isRedisHelper = (value: unknown): value is AbstractRedisHelper => {\n return typeof value === 'object' && value !== null && REDIS_HELPER_BRAND in value;\n};\n\n/** Base for the Redis helpers: wraps one ioredis client, logs its lifecycle events and forwards them to the `onInitialized`, `onConnected`, `onReady` and `onError` callbacks. Subclasses build the client. */\nexport class AbstractRedisHelper<ClientType extends TRedisClient = TRedisClient>\n extends BaseHelper\n implements IRedisHelper\n{\n /** Read by {@link isRedisHelper}. On the instance, so every subclass instance carries it. */\n readonly [REDIS_HELPER_BRAND] = true;\n\n client: ClientType;\n readonly name: string;\n\n constructor(\n opts: { scope: string; identifier: string; client: ClientType } & IRedisHelperCallbacks,\n ) {\n super({ scope: opts.scope, identifier: opts.identifier });\n\n this.name = opts.identifier;\n this.client = opts.client;\n\n const { onInitialized, onConnected, onReady, onError } = opts;\n const emitter = this.client as EventEmitter;\n\n emitter.on('connect', () => {\n this.logger.for('connect').info('Redis CONNECTED | Name: %s', this.name);\n onConnected?.({ name: this.name, helper: this });\n });\n\n emitter.on('ready', () => {\n this.logger.for('ready').info('Redis READY | Name: %s', this.name);\n onReady?.({ name: this.name, helper: this });\n });\n\n emitter.on('error', (error: Error) => {\n this.logger.for('error').error('Redis ERROR | Name: %s | Error: %s', this.name, error);\n onError?.({ name: this.name, helper: this, error });\n });\n\n emitter.on('reconnecting', () => {\n this.logger.for('reconnecting').warn('Redis client RECONNECTING | Name: %s', this.name);\n });\n\n onInitialized?.({ name: this.name, helper: this });\n }\n\n protected static buildRetryStrategy(opts: { maxRetry: number }) {\n const { maxRetry } = opts;\n\n return (attemptCounter: number) => {\n if (maxRetry > -1 && attemptCounter > maxRetry) {\n return undefined;\n }\n\n return Math.max(Math.min(attemptCounter * 2000, 5000), 1000);\n };\n }\n\n protected static buildDefaultOpts(opts: { maxRetry: number }) {\n return {\n showFriendlyErrorStack: true,\n maxRetriesPerRequest: null,\n retryStrategy: AbstractRedisHelper.buildRetryStrategy({ maxRetry: opts.maxRetry }),\n };\n }\n\n // --- Connection lifecycle (IRedisConnection) ---\n\n getClient() {\n return this.client;\n }\n\n duplicateClient(): TRedisClient {\n // ioredis 6 types `duplicate` per client; the `Redis | Cluster` union has no callable signature.\n const duplicable: { duplicate: () => TRedisClient } = this.client;\n\n return duplicable.duplicate();\n }\n\n ping() {\n return this.client.ping();\n }\n\n connect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = [\n 'ready',\n 'reconnecting',\n 'connecting',\n ];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.connect.name)\n .info('status: %s | Invalid redis status to invoke connect', this.client.status);\n\n resolve(false);\n\n return;\n }\n\n this.client\n .connect()\n .then(() => {\n resolve(this.client.status === 'ready');\n })\n .catch(reject);\n });\n }\n\n disconnect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = ['end', 'close'];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.disconnect.name)\n .info('status: %s | Invalid redis status to invoke disconnect', this.client.status);\n resolve(false);\n\n return;\n }\n\n this.client\n .quit()\n .then((rs) => {\n resolve(rs === 'OK');\n })\n .catch(reject);\n });\n }\n\n // --- Key lifecycle + counters (IRedisKey) ---\n\n exists(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.exists(...keys);\n }\n\n async expire(opts: { key: string; seconds: number }): Promise<boolean> {\n const { key, seconds } = opts;\n const result = await this.client.expire(key, seconds);\n\n return result === 1;\n }\n\n async expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean> {\n const { key, atEpochSeconds } = opts;\n const result = await this.client.expireat(key, atEpochSeconds);\n\n return result === 1;\n }\n\n ttl(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.ttl(key);\n }\n\n async persist(opts: { key: string }): Promise<boolean> {\n const { key } = opts;\n const result = await this.client.persist(key);\n\n return result === 1;\n }\n\n incr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.incr(key);\n }\n\n decr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.decr(key);\n }\n\n incrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.incrby(key, value);\n }\n\n decrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.decrby(key, value);\n }\n\n // --- Key-value (IRedisKeyValue) ---\n\n async set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void> {\n const { key, value, options } = opts;\n\n const serialized = JSON.stringify(value);\n\n if (typeof options?.expiresIn === 'number' && options.expiresIn > 0) {\n await this.client.set(key, serialized, 'PX', options.expiresIn);\n } else {\n await this.client.set(key, serialized);\n }\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.set.name).info('Set key: %s | value: %s', key, serialized);\n }\n\n async get<T = string>(opts: {\n key: string;\n transform?: (input: string) => T;\n }): Promise<T | null> {\n const { key, transform } = opts;\n\n const value = await this.client.get(key);\n\n if (!value) {\n return null;\n }\n\n return transform ? transform(value) : (value as AnyType);\n }\n\n del(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.del(keys);\n }\n\n getString(opts: { key: string }) {\n return this.get(opts);\n }\n\n getStrings(opts: { keys: Array<string> }) {\n return this.mGet(opts);\n }\n\n getObject<T>(opts: { key: string }) {\n return this.get<T>({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n getObjects(opts: { keys: Array<string> }) {\n return this.mGet({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n async mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void> {\n const { payload, options } = opts;\n\n if (!payload.length) {\n return;\n }\n\n // A plain loop, not spread-in-reduce: `{ ...current, [key]: v }` copies every key already\n // accumulated on EVERY element, which is O(n^2). Measured at 10k keys: 2.2s of blocked event\n // loop, against 1.5ms for this.\n const serialized: Record<string, string> = {};\n\n for (const { key, value } of payload) {\n serialized[key] = JSON.stringify(value);\n }\n\n await this.client.mset(serialized);\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.mSet.name).info('Payload: %j', serialized);\n }\n\n async mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]> {\n const { keys, transform } = opts;\n\n if (!keys.length) {\n return [];\n }\n\n const values = await this.client.mget(keys);\n\n if (!values?.length) {\n return [];\n }\n\n return values.map((el) => (el ? (transform ? transform(el) : (el as AnyType)) : null));\n }\n\n keys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.keys(key);\n }\n\n // --- Hash operations (IRedisHash) ---\n\n async hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number> {\n const { key, value, options } = opts;\n const result = await this.client.hset(key, value as Record<string, string | number | Buffer>);\n\n if (!options?.log) {\n return result;\n }\n\n this.logger.for(this.hSet.name).info('Result: %j', result);\n\n return result;\n }\n\n async hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }) {\n const { key, transform } = opts;\n const value = await this.client.hgetall(key);\n\n if (!transform || !value) {\n return value;\n }\n\n return transform(value);\n }\n\n hGet(opts: { key: string; field: string }): Promise<string | null> {\n const { key, field } = opts;\n\n return this.client.hget(key, field);\n }\n\n hDel(opts: { key: string; fields: Array<string> }): Promise<number> {\n const { key, fields } = opts;\n\n if (!fields.length) {\n return Promise.resolve(0);\n }\n\n return this.client.hdel(key, ...fields);\n }\n\n async hExists(opts: { key: string; field: string }): Promise<boolean> {\n const { key, field } = opts;\n const result = await this.client.hexists(key, field);\n\n return result === 1;\n }\n\n hKeys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hkeys(key);\n }\n\n hVals(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hvals(key);\n }\n\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number> {\n const { key, field, value } = opts;\n\n return this.client.hincrby(key, field, value);\n }\n\n hLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.hlen(key);\n }\n\n // --- Set operations (IRedisSet) ---\n\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.sadd(key, ...members);\n }\n\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.srem(key, ...members);\n }\n\n sMembers(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.smembers(key);\n }\n\n async sIsMember(opts: { key: string; member: string | number }): Promise<boolean> {\n const { key, member } = opts;\n const result = await this.client.sismember(key, member);\n\n return result === 1;\n }\n\n sCard(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.scard(key);\n }\n\n // --- List operations (IRedisList) ---\n\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.lpush(key, ...values);\n }\n\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.rpush(key, ...values);\n }\n\n lPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.lpop(key);\n }\n\n rPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.rpop(key);\n }\n\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]> {\n const { key, start, stop } = opts;\n\n return this.client.lrange(key, start, stop);\n }\n\n lLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.llen(key);\n }\n\n // --- RedisJSON (IRedisJson) ---\n\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.SET', [key, path, JSON.stringify(value)]);\n }\n\n jGet<T>(opts: { key: string; path?: string }): Promise<T | null> {\n const { key, path = '$' } = opts;\n\n return this.execute<T | null>('JSON.GET', [key, path]);\n }\n\n jDelete(opts: { key: string; path?: string }): Promise<number> {\n const { key, path = '$' } = opts;\n\n return this.execute<number>('JSON.DEL', [key, path]);\n }\n\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.NUMINCRBY', [key, path, value]);\n }\n\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.STRAPPEND', [key, path, value]);\n }\n\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.ARRAPPEND', [key, path, JSON.stringify(value)]);\n }\n\n jPop<T>(opts: { key: string; path: string }): Promise<T | null> {\n const { key, path } = opts;\n\n return this.execute<T | null>('JSON.ARRPOP', [key, path]);\n }\n\n // --- Raw command (IRedisCommand) ---\n\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R> {\n if (!parameters?.length) {\n return this.client.call(command) as Promise<R>;\n }\n\n return this.client.call(command, parameters) as Promise<R>;\n }\n\n // --- Pub/Sub (IRedisPubSub) ---\n\n async publish<T>(opts: {\n topics: Array<string>;\n payload: T;\n useCompress?: boolean;\n }): Promise<void> {\n const logger = this.logger.for(this.publish.name);\n const { topics, payload, useCompress = false } = opts;\n\n const validTopics = topics?.filter((topic) => !ObjectUtility.isEmpty({ value: topic }));\n\n if (!validTopics?.length) {\n logger.error('No topic(s) to publish!');\n\n return;\n }\n\n if (!payload) {\n logger.error('Invalid payload to publish!');\n\n return;\n }\n\n const message = Buffer.from(JSON.stringify(payload));\n const packet = useCompress ? zlib.deflateSync(message) : message;\n\n // `topics` is caller-supplied, so an unbounded fan-out here is a caller-sized burst on one connection.\n await PromiseUtility.executeWithLimit({\n limit: RedisConcurrency.PUBLISH_LIMIT,\n tasks: validTopics.map((topic) => () => this.client.publish(topic, packet)),\n });\n }\n\n subscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.subscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to subscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.subscribe.name,\n execution: this.client.subscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to subscribe to topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Subscribed to %s channel(s). Listening to channel: %s', count, topic);\n }),\n });\n }\n\n unsubscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.unsubscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to unsubscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.unsubscribe.name,\n execution: this.client.unsubscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to unsubscribe from topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Unsubscribed from %s channel(s).', count);\n }),\n });\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { getError } from '@/modules/error';\nimport { LoggerFactory } from '@/modules/logger';\nimport { RetryHelper } from '@/modules/retry';\nimport { BaseHelper } from '@/modules/base';\nimport { type EventEmitter } from 'node:events';\nimport zlib from 'node:zlib';\nimport { RedisConcurrency, RedisDefaults } from './../common/constants';\nimport { type IRedisHelper } from './../common/interfaces';\nimport { type IRedisHelperCallbacks, type TRedisClient } from './../common/types';\n\n/** Registry symbol that marks an instance as a Redis helper; `isRedisHelper` tests for it. */\nexport const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');\n\n/** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */\nexport const isRedisHelper = (value: unknown): value is AbstractRedisHelper => {\n return typeof value === 'object' && value !== null && REDIS_HELPER_BRAND in value;\n};\n\n/** Base for the Redis helpers: wraps one ioredis client, logs its lifecycle events and forwards them to the `onInitialized`, `onConnected`, `onReady` and `onError` callbacks. Subclasses build the client. */\nexport class AbstractRedisHelper<ClientType extends TRedisClient = TRedisClient>\n extends BaseHelper\n implements IRedisHelper\n{\n /** Read by {@link isRedisHelper}. On the instance, so every subclass instance carries it. */\n readonly [REDIS_HELPER_BRAND] = true;\n\n client: ClientType;\n readonly name: string;\n\n constructor(\n opts: { scope: string; identifier: string; client: ClientType } & IRedisHelperCallbacks,\n ) {\n super({ scope: opts.scope, identifier: opts.identifier });\n\n this.name = opts.identifier;\n this.client = opts.client;\n\n const { onInitialized, onConnected, onReady, onError } = opts;\n const emitter = this.client as EventEmitter;\n\n emitter.on('connect', () => {\n this.logger.for('connect').info('Redis CONNECTED | Name: %s', this.name);\n onConnected?.({ name: this.name, helper: this });\n });\n\n emitter.on('ready', () => {\n this.logger.for('ready').info('Redis READY | Name: %s', this.name);\n onReady?.({ name: this.name, helper: this });\n });\n\n emitter.on('error', (error: Error) => {\n this.logger.for('error').error('Redis ERROR | Name: %s | Error: %s', this.name, error);\n onError?.({ name: this.name, helper: this, error });\n });\n\n emitter.on('reconnecting', () => {\n this.logger.for('reconnecting').warn('Redis client RECONNECTING | Name: %s', this.name);\n });\n\n onInitialized?.({ name: this.name, helper: this });\n }\n\n /** `maxRetry` is `0`, `RedisDefaults.RETRY_FOREVER` or a positive integer; anything else is a typo that would silently change how the client reconnects. */\n protected static assertMaxRetry(opts: { scope: string; name: string; maxRetry: number }) {\n const { scope, name, maxRetry } = opts;\n\n if (!Number.isInteger(maxRetry) || (maxRetry < 0 && maxRetry !== RedisDefaults.RETRY_FOREVER)) {\n throw getError({\n message: `[${scope}] maxRetry must be 0, ${RedisDefaults.RETRY_FOREVER} (forever) or a positive integer | name: ${name} | value: ${maxRetry}`,\n });\n }\n }\n\n /** The wait before each reconnect, then `undefined` once `maxRetry` attempts failed: ioredis stops and the helper logs it once. */\n protected static buildRetryStrategy(opts: { scope: string; name: string; maxRetry: number }) {\n const { scope, name, maxRetry } = opts;\n\n AbstractRedisHelper.assertMaxRetry(opts);\n\n return (attempt: number) => {\n if (maxRetry !== RedisDefaults.RETRY_FOREVER && attempt > maxRetry) {\n LoggerFactory.getLogger([scope, name])\n .for('retry')\n .error('Redis gave up reconnecting | Name: %s | maxRetry: %d', name, maxRetry);\n\n return undefined;\n }\n\n return RetryHelper.computeBackoffDelayMs({\n attempt,\n backoff: RedisDefaults.RECONNECT_BACKOFF,\n });\n };\n }\n\n protected static buildDefaultOpts(opts: { scope: string; name: string; maxRetry: number }) {\n return {\n showFriendlyErrorStack: true,\n maxRetriesPerRequest: null,\n retryStrategy: AbstractRedisHelper.buildRetryStrategy(opts),\n };\n }\n\n // --- Connection lifecycle (IRedisConnection) ---\n\n getClient() {\n return this.client;\n }\n\n duplicateClient(): TRedisClient {\n // ioredis 6 types `duplicate` per client; the `Redis | Cluster` union has no callable signature.\n const duplicable: { duplicate: () => TRedisClient } = this.client;\n\n return duplicable.duplicate();\n }\n\n ping() {\n return this.client.ping();\n }\n\n async connect() {\n // `connect` is the cluster-only step between `connecting` and `ready`: ioredis refuses a second connect() there as well.\n const invalidStatuses: (typeof this.client.status)[] = [\n 'ready',\n 'reconnecting',\n 'connecting',\n 'connect',\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 return false;\n }\n\n await this.client.connect();\n\n return this.client.status === 'ready';\n }\n\n async disconnect() {\n const invalidStatuses: (typeof this.client.status)[] = ['end', 'close'];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.disconnect.name)\n .info('status: %s | Invalid redis status to invoke disconnect', this.client.status);\n\n return false;\n }\n\n const reply = await this.client.quit();\n\n return reply === 'OK';\n }\n\n // --- Key lifecycle + counters (IRedisKey) ---\n\n exists(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.exists(...keys);\n }\n\n async expire(opts: { key: string; seconds: number }): Promise<boolean> {\n const { key, seconds } = opts;\n const result = await this.client.expire(key, seconds);\n\n return result === 1;\n }\n\n async expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean> {\n const { key, atEpochSeconds } = opts;\n const result = await this.client.expireat(key, atEpochSeconds);\n\n return result === 1;\n }\n\n ttl(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.ttl(key);\n }\n\n async persist(opts: { key: string }): Promise<boolean> {\n const { key } = opts;\n const result = await this.client.persist(key);\n\n return result === 1;\n }\n\n incr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.incr(key);\n }\n\n decr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.decr(key);\n }\n\n incrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.incrby(key, value);\n }\n\n decrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.decrby(key, value);\n }\n\n // --- Key-value (IRedisKeyValue) ---\n\n async set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void> {\n const { key, value, options } = opts;\n\n const serialized = JSON.stringify(value);\n\n if (typeof options?.expiresIn === 'number' && options.expiresIn > 0) {\n await this.client.set(key, serialized, 'PX', options.expiresIn);\n } else {\n await this.client.set(key, serialized);\n }\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.set.name).info('Set key: %s | value: %s', key, serialized);\n }\n\n async get<T = string>(opts: {\n key: string;\n transform?: (input: string) => T;\n }): Promise<T | null> {\n const { key, transform } = opts;\n\n const value = await this.client.get(key);\n\n if (!value) {\n return null;\n }\n\n return transform ? transform(value) : (value as T);\n }\n\n del(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.del(keys);\n }\n\n getString(opts: { key: string }) {\n return this.get(opts);\n }\n\n getStrings(opts: { keys: Array<string> }) {\n return this.mGet(opts);\n }\n\n getObject<T>(opts: { key: string }) {\n return this.get<T>({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n getObjects(opts: { keys: Array<string> }) {\n return this.mGet({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n async mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void> {\n const { payload, options } = opts;\n\n if (!payload.length) {\n return;\n }\n\n // A plain loop, not spread-in-reduce: `{ ...current, [key]: v }` copies every key already\n // accumulated on EVERY element, which is O(n^2). Measured at 10k keys: 2.2s of blocked event\n // loop, against 1.5ms for this.\n const serialized: Record<string, string> = {};\n\n for (const { key, value } of payload) {\n serialized[key] = JSON.stringify(value);\n }\n\n await this.client.mset(serialized);\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.mSet.name).info('Payload: %j', serialized);\n }\n\n async mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]> {\n const { keys, transform } = opts;\n\n if (!keys.length) {\n return [];\n }\n\n const values = await this.client.mget(keys);\n\n if (!values?.length) {\n return [];\n }\n\n return values.map((el) => (el ? (transform ? transform(el) : (el as T)) : null));\n }\n\n keys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.keys(key);\n }\n\n // --- Hash operations (IRedisHash) ---\n\n async hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number> {\n const { key, value, options } = opts;\n const result = await this.client.hset(key, value as Record<string, string | number | Buffer>);\n\n if (!options?.log) {\n return result;\n }\n\n this.logger.for(this.hSet.name).info('Result: %j', result);\n\n return result;\n }\n\n async hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }) {\n const { key, transform } = opts;\n const value = await this.client.hgetall(key);\n\n if (!transform || !value) {\n return value;\n }\n\n return transform(value);\n }\n\n hGet(opts: { key: string; field: string }): Promise<string | null> {\n const { key, field } = opts;\n\n return this.client.hget(key, field);\n }\n\n hDel(opts: { key: string; fields: Array<string> }): Promise<number> {\n const { key, fields } = opts;\n\n if (!fields.length) {\n return Promise.resolve(0);\n }\n\n return this.client.hdel(key, ...fields);\n }\n\n async hExists(opts: { key: string; field: string }): Promise<boolean> {\n const { key, field } = opts;\n const result = await this.client.hexists(key, field);\n\n return result === 1;\n }\n\n hKeys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hkeys(key);\n }\n\n hVals(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hvals(key);\n }\n\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number> {\n const { key, field, value } = opts;\n\n return this.client.hincrby(key, field, value);\n }\n\n hLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.hlen(key);\n }\n\n // --- Set operations (IRedisSet) ---\n\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.sadd(key, ...members);\n }\n\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.srem(key, ...members);\n }\n\n sMembers(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.smembers(key);\n }\n\n async sIsMember(opts: { key: string; member: string | number }): Promise<boolean> {\n const { key, member } = opts;\n const result = await this.client.sismember(key, member);\n\n return result === 1;\n }\n\n sCard(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.scard(key);\n }\n\n // --- List operations (IRedisList) ---\n\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.lpush(key, ...values);\n }\n\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.rpush(key, ...values);\n }\n\n lPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.lpop(key);\n }\n\n rPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.rpop(key);\n }\n\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]> {\n const { key, start, stop } = opts;\n\n return this.client.lrange(key, start, stop);\n }\n\n lLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.llen(key);\n }\n\n // --- RedisJSON (IRedisJson) ---\n\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.SET', [key, path, JSON.stringify(value)]);\n }\n\n jGet<T>(opts: { key: string; path?: string }): Promise<T | null> {\n const { key, path = '$' } = opts;\n\n return this.execute<T | null>('JSON.GET', [key, path]);\n }\n\n jDelete(opts: { key: string; path?: string }): Promise<number> {\n const { key, path = '$' } = opts;\n\n return this.execute<number>('JSON.DEL', [key, path]);\n }\n\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.NUMINCRBY', [key, path, value]);\n }\n\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.STRAPPEND', [key, path, value]);\n }\n\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.ARRAPPEND', [key, path, JSON.stringify(value)]);\n }\n\n jPop<T>(opts: { key: string; path: string }): Promise<T | null> {\n const { key, path } = opts;\n\n return this.execute<T | null>('JSON.ARRPOP', [key, path]);\n }\n\n // --- Raw command (IRedisCommand) ---\n\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R> {\n if (!parameters?.length) {\n return this.client.call(command) as Promise<R>;\n }\n\n return this.client.call(command, parameters) as Promise<R>;\n }\n\n // --- Pub/Sub (IRedisPubSub) ---\n\n async publish<T>(opts: {\n topics: Array<string>;\n payload: T;\n useCompress?: boolean;\n }): Promise<void> {\n const logger = this.logger.for(this.publish.name);\n const { topics, payload, useCompress = false } = opts;\n\n const validTopics = topics?.filter((topic) => !ObjectUtility.isEmpty({ value: topic }));\n\n if (!validTopics?.length) {\n logger.error('No topic(s) to publish!');\n\n return;\n }\n\n if (!payload) {\n logger.error('Invalid payload to publish!');\n\n return;\n }\n\n const message = Buffer.from(JSON.stringify(payload));\n const packet = useCompress ? zlib.deflateSync(message) : message;\n\n // `topics` is caller-supplied, so an unbounded fan-out here is a caller-sized burst on one connection.\n await PromiseUtility.executeWithLimit({\n limit: RedisConcurrency.PUBLISH_LIMIT,\n tasks: validTopics.map((topic) => () => this.client.publish(topic, packet)),\n });\n }\n\n subscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.subscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to subscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.subscribe.name,\n execution: this.client.subscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to subscribe to topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Subscribed to %s channel(s). Listening to channel: %s', count, topic);\n }),\n });\n }\n\n unsubscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.unsubscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to unsubscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.unsubscribe.name,\n execution: this.client.unsubscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to unsubscribe from topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Unsubscribed from %s channel(s).', count);\n }),\n });\n }\n}\n"]}
|
|
@@ -1,13 +1,12 @@
|
|
|
1
1
|
import type { Cluster } from 'ioredis';
|
|
2
2
|
import { AbstractRedisHelper } from './../base/index.js';
|
|
3
|
-
import {
|
|
3
|
+
import type { IRedisClusterHelperOptions } from './types.js';
|
|
4
4
|
/** Redis helper over an ioredis `Cluster`. `autoConnect: false` creates the client with `lazyConnect`; `clusterOptions` is applied last and overrides the defaults. */
|
|
5
5
|
export declare class RedisClusterHelper extends AbstractRedisHelper<Cluster> {
|
|
6
6
|
private startupNodes;
|
|
7
7
|
private clusterOpts;
|
|
8
8
|
private ioredis;
|
|
9
9
|
constructor(opts: IRedisClusterHelperOptions);
|
|
10
|
-
getClient(): Cluster;
|
|
11
10
|
duplicateClient(): Cluster;
|
|
12
11
|
}
|
|
13
12
|
//# sourceMappingURL=cluster.helper.d.ts.map
|
|
@@ -1,26 +1,41 @@
|
|
|
1
1
|
import { ParseUtility } from '../../../utilities/index.js';
|
|
2
2
|
import { ModuleUtility } from '../../../utilities/module.utility.js';
|
|
3
3
|
import { AbstractRedisHelper } from './../base/index.js';
|
|
4
|
+
import { RedisDefaults } from './../common/index.js';
|
|
4
5
|
/** Redis helper over an ioredis `Cluster`. `autoConnect: false` creates the client with `lazyConnect`; `clusterOptions` is applied last and overrides the defaults. */
|
|
5
6
|
export class RedisClusterHelper extends AbstractRedisHelper {
|
|
6
7
|
constructor(opts) {
|
|
7
|
-
const { autoConnect = true } = opts;
|
|
8
|
+
const { autoConnect = true, maxRetry = RedisDefaults.MAX_RETRY } = opts;
|
|
8
9
|
const startupNodes = opts.nodes.map((node) => ({
|
|
9
10
|
host: node.host,
|
|
10
|
-
port: ParseUtility.toInt({ input: node.port }),
|
|
11
|
-
password: node.password,
|
|
11
|
+
port: ParseUtility.toInt({ input: node.port ?? RedisDefaults.PORT }),
|
|
12
12
|
}));
|
|
13
|
-
// Precedence (low -> high): the
|
|
13
|
+
// Precedence (low -> high): the framework defaults, then `clusterOptions` verbatim. The raw
|
|
14
14
|
// hatch stays the last word, because a caller already threading `lazyConnect` through it must
|
|
15
15
|
// keep the timing it has today. `enableOfflineQueue` is stated rather than inherited from
|
|
16
16
|
// ioredis, so the queue a cluster needs between bind and connect cannot go missing on an
|
|
17
|
-
// ioredis default change.
|
|
18
|
-
//
|
|
17
|
+
// ioredis default change. `maxRetriesPerRequest: null` is what a BullMQ worker needs; the
|
|
18
|
+
// cluster-level `clusterRetryStrategy` reconnects with the same backoff as the other modes.
|
|
19
19
|
const clusterOpts = {
|
|
20
20
|
enableOfflineQueue: true,
|
|
21
21
|
lazyConnect: !autoConnect,
|
|
22
|
+
clusterRetryStrategy: AbstractRedisHelper.buildRetryStrategy({
|
|
23
|
+
scope: RedisClusterHelper.name,
|
|
24
|
+
name: opts.name,
|
|
25
|
+
maxRetry,
|
|
26
|
+
}),
|
|
22
27
|
...opts.clusterOptions,
|
|
28
|
+
// Merged, not replaced: TLS and the like live in `redisOptions`, and an app that sets them must keep what BullMQ needs. An explicit `maxRetriesPerRequest` still wins.
|
|
29
|
+
redisOptions: { maxRetriesPerRequest: null, ...opts.clusterOptions?.redisOptions },
|
|
23
30
|
};
|
|
31
|
+
// ioredis applies a per-node password to the startup nodes only; nodes found later are built
|
|
32
|
+
// from host:port and `redisOptions`. So the credentials go in `redisOptions`, where every node
|
|
33
|
+
// gets them. The rule is the Sentinel helper's: a first-class credential that is given wins,
|
|
34
|
+
// and `redisOptions` only fills what is unset. (The other cluster knobs keep `clusterOptions`
|
|
35
|
+
// as the last word, because callers already thread timing through it.)
|
|
36
|
+
clusterOpts.redisOptions ??= {};
|
|
37
|
+
clusterOpts.redisOptions.username = opts.username ?? clusterOpts.redisOptions.username;
|
|
38
|
+
clusterOpts.redisOptions.password = opts.password ?? clusterOpts.redisOptions.password;
|
|
24
39
|
const ioredis = opts.module ?? ModuleUtility.loadSync({ module: 'ioredis' });
|
|
25
40
|
super({
|
|
26
41
|
...opts,
|
|
@@ -32,9 +47,6 @@ export class RedisClusterHelper extends AbstractRedisHelper {
|
|
|
32
47
|
this.clusterOpts = clusterOpts;
|
|
33
48
|
this.ioredis = ioredis;
|
|
34
49
|
}
|
|
35
|
-
getClient() {
|
|
36
|
-
return this.client;
|
|
37
|
-
}
|
|
38
50
|
duplicateClient() {
|
|
39
51
|
return new this.ioredis.Cluster(this.startupNodes, this.clusterOpts);
|
|
40
52
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"cluster.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/cluster.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,uKAAuK;AACvK,MAAM,OAAO,kBAAmB,SAAQ,mBAA4B;IAKlE,YAAY,IAAgC;QAC1C,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC;QAExE,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;SACrE,CAAC,CAAC,CAAC;QAEJ,4FAA4F;QAC5F,8FAA8F;QAC9F,0FAA0F;QAC1F,yFAAyF;QACzF,0FAA0F;QAC1F,4FAA4F;QAC5F,MAAM,WAAW,GAAmB;YAClC,kBAAkB,EAAE,IAAI;YACxB,WAAW,EAAE,CAAC,WAAW;YACzB,oBAAoB,EAAE,mBAAmB,CAAC,kBAAkB,CAAC;gBAC3D,KAAK,EAAE,kBAAkB,CAAC,IAAI;gBAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ;aACT,CAAC;YACF,GAAG,IAAI,CAAC,cAAc;YACtB,uKAAuK;YACvK,YAAY,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,YAAY,EAAE;SACnF,CAAC;QAEF,6FAA6F;QAC7F,+FAA+F;QAC/F,6FAA6F;QAC7F,8FAA8F;QAC9F,uEAAuE;QACvE,WAAW,CAAC,YAAY,KAAK,EAAE,CAAC;QAChC,WAAW,CAAC,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC;QACvF,WAAW,CAAC,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC;QAEvF,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,eAAe;QACtB,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;CACF","sourcesContent":["import { ParseUtility } from '@/utilities';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport type { Cluster, ClusterOptions } from 'ioredis';\nimport { AbstractRedisHelper } from './../base';\nimport { RedisDefaults } from './../common';\nimport type { IRedisClusterHelperOptions } from './types';\n\n/** Redis helper over an ioredis `Cluster`. `autoConnect: false` creates the client with `lazyConnect`; `clusterOptions` is applied last and overrides the defaults. */\nexport class RedisClusterHelper extends AbstractRedisHelper<Cluster> {\n private startupNodes: Array<{ host: string; port: number }>;\n private clusterOpts: ClusterOptions;\n private ioredis: typeof import('ioredis');\n\n constructor(opts: IRedisClusterHelperOptions) {\n const { autoConnect = true, maxRetry = RedisDefaults.MAX_RETRY } = opts;\n\n const startupNodes = opts.nodes.map((node) => ({\n host: node.host,\n port: ParseUtility.toInt({ input: node.port ?? RedisDefaults.PORT }),\n }));\n\n // Precedence (low -> high): the 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. `maxRetriesPerRequest: null` is what a BullMQ worker needs; the\n // cluster-level `clusterRetryStrategy` reconnects with the same backoff as the other modes.\n const clusterOpts: ClusterOptions = {\n enableOfflineQueue: true,\n lazyConnect: !autoConnect,\n clusterRetryStrategy: AbstractRedisHelper.buildRetryStrategy({\n scope: RedisClusterHelper.name,\n name: opts.name,\n maxRetry,\n }),\n ...opts.clusterOptions,\n // Merged, not replaced: TLS and the like live in `redisOptions`, and an app that sets them must keep what BullMQ needs. An explicit `maxRetriesPerRequest` still wins.\n redisOptions: { maxRetriesPerRequest: null, ...opts.clusterOptions?.redisOptions },\n };\n\n // ioredis applies a per-node password to the startup nodes only; nodes found later are built\n // from host:port and `redisOptions`. So the credentials go in `redisOptions`, where every node\n // gets them. The rule is the Sentinel helper's: a first-class credential that is given wins,\n // and `redisOptions` only fills what is unset. (The other cluster knobs keep `clusterOptions`\n // as the last word, because callers already thread timing through it.)\n clusterOpts.redisOptions ??= {};\n clusterOpts.redisOptions.username = opts.username ?? clusterOpts.redisOptions.username;\n clusterOpts.redisOptions.password = opts.password ?? clusterOpts.redisOptions.password;\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 duplicateClient(): Cluster {\n return new this.ioredis.Cluster(this.startupNodes, this.clusterOpts);\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC","sourcesContent":["export * from './cluster.helper';\n"]}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC","sourcesContent":["export * from './types';\nexport * from './cluster.helper';\n"]}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { ClusterOptions } from 'ioredis';
|
|
2
|
+
import type { IRedisCredentials, IRedisHelperCallbacks, IRedisModuleOption, IRedisNode } from './../common/index.js';
|
|
3
|
+
/** Connection settings for a Redis Cluster: the startup `nodes` and one credential pair for every node, plus raw ioredis `clusterOptions` that override the helper defaults. The credentials go through `redisOptions`, so nodes found after startup get them too. */
|
|
4
|
+
export interface IRedisClusterHelperProps extends IRedisCredentials {
|
|
5
|
+
name: string;
|
|
6
|
+
nodes: IRedisNode[];
|
|
7
|
+
/**
|
|
8
|
+
* Same meaning as on single and sentinel: `false` holds the client open for a later `connect()`.
|
|
9
|
+
*
|
|
10
|
+
* @default true
|
|
11
|
+
*/
|
|
12
|
+
autoConnect?: boolean;
|
|
13
|
+
/** Reconnect attempts: `0` never reconnects, `-1` never gives up; any other value is refused. `clusterOptions` still overrides. @default RedisDefaults.MAX_RETRY (5) */
|
|
14
|
+
maxRetry?: number;
|
|
15
|
+
clusterOptions?: ClusterOptions;
|
|
16
|
+
}
|
|
17
|
+
/** Options for `RedisClusterHelper`: connection props, lifecycle callbacks and an optional `ioredis` module. */
|
|
18
|
+
export interface IRedisClusterHelperOptions extends IRedisClusterHelperProps, IRedisHelperCallbacks, IRedisModuleOption {
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/redis/cluster/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ClusterOptions } from 'ioredis';\nimport type {\n IRedisCredentials,\n IRedisHelperCallbacks,\n IRedisModuleOption,\n IRedisNode,\n} from './../common';\n\n/** Connection settings for a Redis Cluster: the startup `nodes` and one credential pair for every node, plus raw ioredis `clusterOptions` that override the helper defaults. The credentials go through `redisOptions`, so nodes found after startup get them too. */\nexport interface IRedisClusterHelperProps extends IRedisCredentials {\n name: string;\n nodes: IRedisNode[];\n /**\n * Same meaning as on single and sentinel: `false` holds the client open for a later `connect()`.\n *\n * @default true\n */\n autoConnect?: boolean;\n /** Reconnect attempts: `0` never reconnects, `-1` never gives up; any other value is refused. `clusterOptions` still overrides. @default RedisDefaults.MAX_RETRY (5) */\n maxRetry?: number;\n clusterOptions?: ClusterOptions;\n}\n\n/** Options for `RedisClusterHelper`: connection props, lifecycle callbacks and an optional `ioredis` module. */\nexport interface IRedisClusterHelperOptions\n extends IRedisClusterHelperProps, IRedisHelperCallbacks, IRedisModuleOption {}\n"]}
|
|
@@ -1,23 +1,19 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
static readonly
|
|
5
|
-
|
|
6
|
-
static readonly
|
|
7
|
-
static readonly
|
|
8
|
-
|
|
1
|
+
/** Reconnect defaults of a Redis helper. */
|
|
2
|
+
export declare class RedisDefaults {
|
|
3
|
+
/** The port of a data node when none is given. */
|
|
4
|
+
static readonly PORT = 6379;
|
|
5
|
+
/** Reconnect attempts before the helper gives up: `0` never reconnects, `RETRY_FOREVER` never stops. */
|
|
6
|
+
static readonly MAX_RETRY = 5;
|
|
7
|
+
static readonly RETRY_FOREVER = -1;
|
|
8
|
+
/** The wait before reconnect attempt N, computed by `RetryHelper.computeBackoffDelayMs`. */
|
|
9
|
+
static readonly RECONNECT_BACKOFF: {
|
|
10
|
+
strategy: "exponential";
|
|
11
|
+
initialDelayMs: number;
|
|
12
|
+
multiplier: number;
|
|
13
|
+
maxDelayMs: number;
|
|
14
|
+
jitter: "equal";
|
|
15
|
+
};
|
|
9
16
|
}
|
|
10
|
-
/** Union of the `RedisModes` values. */
|
|
11
|
-
export type TRedisMode = TConstValue<typeof RedisModes>;
|
|
12
|
-
/** Role of the node a Sentinel-backed client connects to. */
|
|
13
|
-
export declare class RedisSentinelRoles {
|
|
14
|
-
static readonly MASTER = "master";
|
|
15
|
-
static readonly SLAVE = "slave";
|
|
16
|
-
static readonly ROLE_SET: Set<string>;
|
|
17
|
-
static isValid(role: string): role is TRedisSentinelRole;
|
|
18
|
-
}
|
|
19
|
-
/** Union of the `RedisSentinelRoles` values. */
|
|
20
|
-
export type TRedisSentinelRole = TConstValue<typeof RedisSentinelRoles>;
|
|
21
17
|
/** Ceiling on a caller-sized fan-out over one connection; a burst larger than this queues rather than piles up. */
|
|
22
18
|
export declare class RedisConcurrency {
|
|
23
19
|
static readonly PUBLISH_LIMIT = 32;
|
|
@@ -1,21 +1,19 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
static { this.
|
|
6
|
-
|
|
7
|
-
static
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
return this.ROLE_SET.has(role);
|
|
18
|
-
}
|
|
1
|
+
import { RetryBackoffStrategies, RetryJitterModes, } from '../../retry/index.js';
|
|
2
|
+
/** Reconnect defaults of a Redis helper. */
|
|
3
|
+
export class RedisDefaults {
|
|
4
|
+
/** The port of a data node when none is given. */
|
|
5
|
+
static { this.PORT = 6379; }
|
|
6
|
+
/** Reconnect attempts before the helper gives up: `0` never reconnects, `RETRY_FOREVER` never stops. */
|
|
7
|
+
static { this.MAX_RETRY = 5; }
|
|
8
|
+
static { this.RETRY_FOREVER = -1; }
|
|
9
|
+
/** The wait before reconnect attempt N, computed by `RetryHelper.computeBackoffDelayMs`. */
|
|
10
|
+
static { this.RECONNECT_BACKOFF = {
|
|
11
|
+
strategy: RetryBackoffStrategies.EXPONENTIAL,
|
|
12
|
+
initialDelayMs: 1000,
|
|
13
|
+
multiplier: 2,
|
|
14
|
+
maxDelayMs: 30_000,
|
|
15
|
+
jitter: RetryJitterModes.EQUAL,
|
|
16
|
+
}; }
|
|
19
17
|
}
|
|
20
18
|
/** Ceiling on a caller-sized fan-out over one connection; a burst larger than this queues rather than piles up. */
|
|
21
19
|
export class RedisConcurrency {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/redis/common/constants.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/redis/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GAEjB,MAAM,iBAAiB,CAAC;AAEzB,4CAA4C;AAC5C,MAAM,OAAO,aAAa;IACxB,kDAAkD;aAClC,SAAI,GAAG,IAAI,CAAC;IAC5B,wGAAwG;aACxF,cAAS,GAAG,CAAC,CAAC;aACd,kBAAa,GAAG,CAAC,CAAC,CAAC;IAEnC,4FAA4F;aAC5E,sBAAiB,GAAG;QAClC,QAAQ,EAAE,sBAAsB,CAAC,WAAW;QAC5C,cAAc,EAAE,IAAI;QACpB,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,MAAM;QAClB,MAAM,EAAE,gBAAgB,CAAC,KAAK;KACA,CAAC;;AAGnC,mHAAmH;AACnH,MAAM,OAAO,gBAAgB;aACX,kBAAa,GAAG,EAAE,CAAC","sourcesContent":["import {\n RetryBackoffStrategies,\n RetryJitterModes,\n type IRetryBackoffOptions,\n} from '@/modules/retry';\n\n/** Reconnect defaults of a Redis helper. */\nexport class RedisDefaults {\n /** The port of a data node when none is given. */\n static readonly PORT = 6379;\n /** Reconnect attempts before the helper gives up: `0` never reconnects, `RETRY_FOREVER` never stops. */\n static readonly MAX_RETRY = 5;\n static readonly RETRY_FOREVER = -1;\n\n /** The wait before reconnect attempt N, computed by `RetryHelper.computeBackoffDelayMs`. */\n static readonly RECONNECT_BACKOFF = {\n strategy: RetryBackoffStrategies.EXPONENTIAL,\n initialDelayMs: 1000,\n multiplier: 2,\n maxDelayMs: 30_000,\n jitter: RetryJitterModes.EQUAL,\n } satisfies IRetryBackoffOptions;\n}\n\n/** Ceiling on a caller-sized fan-out over one connection; a burst larger than this queues rather than piles up. */\nexport class RedisConcurrency {\n static readonly PUBLISH_LIMIT = 32;\n}\n"]}
|