@jintianxiayu/cache-decorator 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/CHANGELOG.md +25 -11
  2. package/README.md +364 -270
  3. package/dist/core/cache-error.d.ts +75 -0
  4. package/dist/core/cache-error.d.ts.map +1 -0
  5. package/dist/core/cache-error.js +168 -0
  6. package/dist/core/cache-error.js.map +1 -0
  7. package/dist/core/cache-logger.d.ts +3 -2
  8. package/dist/core/cache-logger.d.ts.map +1 -1
  9. package/dist/core/cache-logger.js +2 -0
  10. package/dist/core/cache-logger.js.map +1 -1
  11. package/dist/decorators/cache-evict.d.ts.map +1 -1
  12. package/dist/decorators/cache-evict.js +15 -10
  13. package/dist/decorators/cache-evict.js.map +1 -1
  14. package/dist/decorators/cache.d.ts +6 -0
  15. package/dist/decorators/cache.d.ts.map +1 -1
  16. package/dist/decorators/cache.js +113 -36
  17. package/dist/decorators/cache.js.map +1 -1
  18. package/jest.config.js +11 -11
  19. package/package.json +1 -1
  20. package/src/adapters/ioredis-cache-client.ts +89 -89
  21. package/src/adapters/node-redis-cache-client.ts +95 -95
  22. package/src/adapters/redis-key-prefix.ts +38 -38
  23. package/src/core/cache-error.ts +233 -0
  24. package/src/core/cache-logger.ts +116 -105
  25. package/src/core/key-builder.ts +33 -33
  26. package/src/core/native-cache.ts +55 -55
  27. package/src/core/pending-cache.ts +29 -29
  28. package/src/core/redis-cache-client.ts +160 -160
  29. package/src/core/redis-cache.ts +104 -104
  30. package/src/decorators/cache-evict.ts +137 -129
  31. package/src/decorators/cache.ts +323 -203
  32. package/src/index.ts +11 -11
  33. package/test/cache-evict-logging.test.ts +398 -362
  34. package/test/cache-logger.integration.test.ts +159 -129
  35. package/test/cache-logger.test.ts +156 -153
  36. package/test/cache-logging.test.ts +929 -544
  37. package/test/cache.test.ts +1017 -255
  38. package/test/fixtures/cache-logger-child.mjs +108 -108
  39. package/test/fixtures/cache-provider-failure-child.mjs +70 -0
  40. package/test/helpers/legacy-redis-cache.ts +41 -22
  41. package/test/helpers/package-consumer.ts +231 -231
  42. package/test/helpers/redis-fixture.ts +142 -142
  43. package/test/ioredis-cache-client.test.ts +143 -143
  44. package/test/legacy-redis-cache.test.ts +51 -0
  45. package/test/native-cache.test.ts +77 -77
  46. package/test/node-redis-cache-client.test.ts +149 -149
  47. package/test/pending-cache.test.ts +69 -69
  48. package/test/redis-cache-client-lifecycle.test.ts +112 -112
  49. package/test/redis-cache-client-types.test.ts +184 -184
  50. package/test/redis-cache-client.integration.test.ts +355 -327
  51. package/test/redis-cache-decorator.test.ts +601 -201
  52. package/test/redis-cache-provider.test.ts +269 -269
  53. package/test/type-contract/contract.ts +119 -64
  54. package/test/type-contract/tsconfig.json +12 -12
  55. package/tsconfig.json +8 -8
@@ -1 +1 @@
1
- {"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/decorators/cache.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/decorators/cache.ts"],"names":[],"mappings":"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"}
package/jest.config.js CHANGED
@@ -1,11 +1,11 @@
1
- module.exports = {
2
- preset: 'ts-jest',
3
- testEnvironment: 'node',
4
- roots: ['<rootDir>'],
5
- testMatch: ['**/test/**/*.test.ts'],
6
- moduleFileExtensions: ['ts', 'js', 'json'],
7
- collectCoverageFrom: ['src/**/*.ts', '!src/**/*.d.ts'],
8
- transform: {
9
- '^.+\\.ts$': ['ts-jest', { tsconfig: '<rootDir>/../../tsconfig.test.json' }],
10
- },
11
- };
1
+ module.exports = {
2
+ preset: 'ts-jest',
3
+ testEnvironment: 'node',
4
+ roots: ['<rootDir>'],
5
+ testMatch: ['**/test/**/*.test.ts'],
6
+ moduleFileExtensions: ['ts', 'js', 'json'],
7
+ collectCoverageFrom: ['src/**/*.ts', '!src/**/*.d.ts'],
8
+ transform: {
9
+ '^.+\\.ts$': ['ts-jest', { tsconfig: '<rootDir>/../../tsconfig.test.json' }],
10
+ },
11
+ };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jintianxiayu/cache-decorator",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "Method caching decorators for TypeScript",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -1,89 +1,89 @@
1
- import { IoredisCacheClientSource, RedisCacheClient } from '../core/redis-cache-client';
2
- import { createRedisScanPattern, stripRedisKeyPrefix } from './redis-key-prefix';
3
-
4
- function normalizeGetResponse(response: unknown): string | null {
5
- if (typeof response === 'string' || response === null) {
6
- return response;
7
- }
8
- throw new TypeError('Expected Redis GET to return a string or null');
9
- }
10
-
11
- function validateOkResponse(command: string, response: unknown): void {
12
- if (response !== 'OK') {
13
- throw new TypeError(`Expected Redis ${command} to return "OK"`);
14
- }
15
- }
16
-
17
- function validateDeleteResponse(response: unknown): void {
18
- if (typeof response !== 'number' || !Number.isInteger(response) || response < 0) {
19
- throw new TypeError('Expected Redis DEL to return a non-negative integer');
20
- }
21
- }
22
-
23
- function normalizeScanResponse(
24
- response: unknown,
25
- keyPrefix: string
26
- ): { readonly cursor: string; readonly keys: readonly string[] } {
27
- if (
28
- !Array.isArray(response) ||
29
- response.length !== 2 ||
30
- typeof response[0] !== 'string' ||
31
- !Array.isArray(response[1]) ||
32
- !response[1].every((key: unknown) => typeof key === 'string')
33
- ) {
34
- throw new TypeError('Expected ioredis SCAN to return a [cursor, keys] tuple');
35
- }
36
- return {
37
- cursor: response[0],
38
- keys: response[1].map((key: string) => stripRedisKeyPrefix(keyPrefix, key)),
39
- };
40
- }
41
-
42
- /**
43
- * 将调用方的 ioredis 连接适配为客户端无关的缓存命令,不创建或关闭连接。
44
- * @param client 使用默认字符串响应映射的 ioredis 普通客户端。
45
- * @returns 复用该连接并恢复逻辑 key 的 Redis 缓存客户端。
46
- * @throws 返回对象的命令方法传播客户端错误;非标准响应拒绝为 TypeError。
47
- */
48
- export function createIoredisCacheClient(client: IoredisCacheClientSource): RedisCacheClient {
49
- const keyPrefix = client.options.keyPrefix ?? '';
50
- return {
51
- /** @inheritdoc */
52
- async get(key: string): Promise<string | null> {
53
- return normalizeGetResponse(await client.get(key));
54
- },
55
- /** @inheritdoc */
56
- async set({ key, value, ttlSeconds }): Promise<void> {
57
- if (ttlSeconds === undefined) {
58
- validateOkResponse('SET', await client.set(key, value));
59
- return;
60
- }
61
- validateOkResponse('SETEX', await client.setex(key, ttlSeconds, value));
62
- },
63
- /** @inheritdoc */
64
- async deleteMany(keys: readonly string[]): Promise<void> {
65
- if (keys.length === 0) {
66
- return;
67
- }
68
- validateDeleteResponse(await client.del(...keys));
69
- },
70
- /** @inheritdoc */
71
- async scan({ cursor, pattern, count }): Promise<{
72
- readonly cursor: string;
73
- readonly keys: readonly string[];
74
- }> {
75
- const response = await client.scan(
76
- cursor,
77
- 'MATCH',
78
- createRedisScanPattern(keyPrefix, pattern),
79
- 'COUNT',
80
- count
81
- );
82
- return normalizeScanResponse(response, keyPrefix);
83
- },
84
- /** @inheritdoc */
85
- async flushDatabase(): Promise<void> {
86
- validateOkResponse('FLUSHDB', await client.flushdb());
87
- },
88
- };
89
- }
1
+ import { IoredisCacheClientSource, RedisCacheClient } from '../core/redis-cache-client';
2
+ import { createRedisScanPattern, stripRedisKeyPrefix } from './redis-key-prefix';
3
+
4
+ function normalizeGetResponse(response: unknown): string | null {
5
+ if (typeof response === 'string' || response === null) {
6
+ return response;
7
+ }
8
+ throw new TypeError('Expected Redis GET to return a string or null');
9
+ }
10
+
11
+ function validateOkResponse(command: string, response: unknown): void {
12
+ if (response !== 'OK') {
13
+ throw new TypeError(`Expected Redis ${command} to return "OK"`);
14
+ }
15
+ }
16
+
17
+ function validateDeleteResponse(response: unknown): void {
18
+ if (typeof response !== 'number' || !Number.isInteger(response) || response < 0) {
19
+ throw new TypeError('Expected Redis DEL to return a non-negative integer');
20
+ }
21
+ }
22
+
23
+ function normalizeScanResponse(
24
+ response: unknown,
25
+ keyPrefix: string
26
+ ): { readonly cursor: string; readonly keys: readonly string[] } {
27
+ if (
28
+ !Array.isArray(response) ||
29
+ response.length !== 2 ||
30
+ typeof response[0] !== 'string' ||
31
+ !Array.isArray(response[1]) ||
32
+ !response[1].every((key: unknown) => typeof key === 'string')
33
+ ) {
34
+ throw new TypeError('Expected ioredis SCAN to return a [cursor, keys] tuple');
35
+ }
36
+ return {
37
+ cursor: response[0],
38
+ keys: response[1].map((key: string) => stripRedisKeyPrefix(keyPrefix, key)),
39
+ };
40
+ }
41
+
42
+ /**
43
+ * 将调用方的 ioredis 连接适配为客户端无关的缓存命令,不创建或关闭连接。
44
+ * @param client 使用默认字符串响应映射的 ioredis 普通客户端。
45
+ * @returns 复用该连接并恢复逻辑 key 的 Redis 缓存客户端。
46
+ * @throws 返回对象的命令方法传播客户端错误;非标准响应拒绝为 TypeError。
47
+ */
48
+ export function createIoredisCacheClient(client: IoredisCacheClientSource): RedisCacheClient {
49
+ const keyPrefix = client.options.keyPrefix ?? '';
50
+ return {
51
+ /** @inheritdoc */
52
+ async get(key: string): Promise<string | null> {
53
+ return normalizeGetResponse(await client.get(key));
54
+ },
55
+ /** @inheritdoc */
56
+ async set({ key, value, ttlSeconds }): Promise<void> {
57
+ if (ttlSeconds === undefined) {
58
+ validateOkResponse('SET', await client.set(key, value));
59
+ return;
60
+ }
61
+ validateOkResponse('SETEX', await client.setex(key, ttlSeconds, value));
62
+ },
63
+ /** @inheritdoc */
64
+ async deleteMany(keys: readonly string[]): Promise<void> {
65
+ if (keys.length === 0) {
66
+ return;
67
+ }
68
+ validateDeleteResponse(await client.del(...keys));
69
+ },
70
+ /** @inheritdoc */
71
+ async scan({ cursor, pattern, count }): Promise<{
72
+ readonly cursor: string;
73
+ readonly keys: readonly string[];
74
+ }> {
75
+ const response = await client.scan(
76
+ cursor,
77
+ 'MATCH',
78
+ createRedisScanPattern(keyPrefix, pattern),
79
+ 'COUNT',
80
+ count
81
+ );
82
+ return normalizeScanResponse(response, keyPrefix);
83
+ },
84
+ /** @inheritdoc */
85
+ async flushDatabase(): Promise<void> {
86
+ validateOkResponse('FLUSHDB', await client.flushdb());
87
+ },
88
+ };
89
+ }
@@ -1,95 +1,95 @@
1
- import { NodeRedisCacheClientOptions, NodeRedisCacheClientSource, RedisCacheClient } from '../core/redis-cache-client';
2
- import { createRedisScanPattern, stripRedisKeyPrefix } from './redis-key-prefix';
3
-
4
- function normalizeGetResponse(response: unknown): string | null {
5
- if (typeof response === 'string' || response === null) {
6
- return response;
7
- }
8
- throw new TypeError('Expected Redis GET to return a string or null');
9
- }
10
-
11
- function validateOkResponse(command: string, response: unknown): void {
12
- if (response !== 'OK') {
13
- throw new TypeError(`Expected Redis ${command} to return "OK"`);
14
- }
15
- }
16
-
17
- function validateDeleteResponse(response: unknown): void {
18
- if (typeof response !== 'number' || !Number.isInteger(response) || response < 0) {
19
- throw new TypeError('Expected Redis DEL to return a non-negative integer');
20
- }
21
- }
22
-
23
- function isRecord(value: unknown): value is Record<string, unknown> {
24
- return typeof value === 'object' && value !== null && !Array.isArray(value);
25
- }
26
-
27
- function normalizeScanResponse(
28
- response: unknown,
29
- keyPrefix: string
30
- ): { readonly cursor: string; readonly keys: readonly string[] } {
31
- if (
32
- !isRecord(response) ||
33
- typeof response.cursor !== 'string' ||
34
- !Array.isArray(response.keys) ||
35
- !response.keys.every((key: unknown) => typeof key === 'string')
36
- ) {
37
- throw new TypeError('Expected node-redis SCAN to return a { cursor, keys } object');
38
- }
39
- return {
40
- cursor: response.cursor,
41
- keys: response.keys.map((key: string) => stripRedisKeyPrefix(keyPrefix, key)),
42
- };
43
- }
44
-
45
- /**
46
- * 将调用方的 node-redis 连接适配为客户端无关的缓存命令,不创建或关闭连接。
47
- * @param client 使用默认字符串响应映射的 node-redis 普通客户端。
48
- * @param options 可选的字面 key 前缀;缺省时不改写逻辑 key。
49
- * @returns 复用该连接并统一物理 key 前缀的 Redis 缓存客户端。
50
- * @throws 返回对象的命令方法传播客户端错误;非标准响应拒绝为 TypeError。
51
- */
52
- export function createNodeRedisCacheClient(
53
- client: NodeRedisCacheClientSource,
54
- options?: NodeRedisCacheClientOptions
55
- ): RedisCacheClient {
56
- const keyPrefix = options?.keyPrefix ?? '';
57
- const createPhysicalKey = (key: string): string => `${keyPrefix}${key}`;
58
- return {
59
- /** @inheritdoc */
60
- async get(key: string): Promise<string | null> {
61
- return normalizeGetResponse(await client.get(createPhysicalKey(key)));
62
- },
63
- /** @inheritdoc */
64
- async set({ key, value, ttlSeconds }): Promise<void> {
65
- const physicalKey = createPhysicalKey(key);
66
- if (ttlSeconds === undefined) {
67
- validateOkResponse('SET', await client.set(physicalKey, value));
68
- return;
69
- }
70
- validateOkResponse('SETEX', await client.setEx(physicalKey, ttlSeconds, value));
71
- },
72
- /** @inheritdoc */
73
- async deleteMany(keys: readonly string[]): Promise<void> {
74
- if (keys.length === 0) {
75
- return;
76
- }
77
- validateDeleteResponse(await client.del(keys.map(createPhysicalKey)));
78
- },
79
- /** @inheritdoc */
80
- async scan({ cursor, pattern, count }): Promise<{
81
- readonly cursor: string;
82
- readonly keys: readonly string[];
83
- }> {
84
- const response = await client.scan(cursor, {
85
- MATCH: createRedisScanPattern(keyPrefix, pattern),
86
- COUNT: count,
87
- });
88
- return normalizeScanResponse(response, keyPrefix);
89
- },
90
- /** @inheritdoc */
91
- async flushDatabase(): Promise<void> {
92
- validateOkResponse('FLUSHDB', await client.flushDb());
93
- },
94
- };
95
- }
1
+ import { NodeRedisCacheClientOptions, NodeRedisCacheClientSource, RedisCacheClient } from '../core/redis-cache-client';
2
+ import { createRedisScanPattern, stripRedisKeyPrefix } from './redis-key-prefix';
3
+
4
+ function normalizeGetResponse(response: unknown): string | null {
5
+ if (typeof response === 'string' || response === null) {
6
+ return response;
7
+ }
8
+ throw new TypeError('Expected Redis GET to return a string or null');
9
+ }
10
+
11
+ function validateOkResponse(command: string, response: unknown): void {
12
+ if (response !== 'OK') {
13
+ throw new TypeError(`Expected Redis ${command} to return "OK"`);
14
+ }
15
+ }
16
+
17
+ function validateDeleteResponse(response: unknown): void {
18
+ if (typeof response !== 'number' || !Number.isInteger(response) || response < 0) {
19
+ throw new TypeError('Expected Redis DEL to return a non-negative integer');
20
+ }
21
+ }
22
+
23
+ function isRecord(value: unknown): value is Record<string, unknown> {
24
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
25
+ }
26
+
27
+ function normalizeScanResponse(
28
+ response: unknown,
29
+ keyPrefix: string
30
+ ): { readonly cursor: string; readonly keys: readonly string[] } {
31
+ if (
32
+ !isRecord(response) ||
33
+ typeof response.cursor !== 'string' ||
34
+ !Array.isArray(response.keys) ||
35
+ !response.keys.every((key: unknown) => typeof key === 'string')
36
+ ) {
37
+ throw new TypeError('Expected node-redis SCAN to return a { cursor, keys } object');
38
+ }
39
+ return {
40
+ cursor: response.cursor,
41
+ keys: response.keys.map((key: string) => stripRedisKeyPrefix(keyPrefix, key)),
42
+ };
43
+ }
44
+
45
+ /**
46
+ * 将调用方的 node-redis 连接适配为客户端无关的缓存命令,不创建或关闭连接。
47
+ * @param client 使用默认字符串响应映射的 node-redis 普通客户端。
48
+ * @param options 可选的字面 key 前缀;缺省时不改写逻辑 key。
49
+ * @returns 复用该连接并统一物理 key 前缀的 Redis 缓存客户端。
50
+ * @throws 返回对象的命令方法传播客户端错误;非标准响应拒绝为 TypeError。
51
+ */
52
+ export function createNodeRedisCacheClient(
53
+ client: NodeRedisCacheClientSource,
54
+ options?: NodeRedisCacheClientOptions
55
+ ): RedisCacheClient {
56
+ const keyPrefix = options?.keyPrefix ?? '';
57
+ const createPhysicalKey = (key: string): string => `${keyPrefix}${key}`;
58
+ return {
59
+ /** @inheritdoc */
60
+ async get(key: string): Promise<string | null> {
61
+ return normalizeGetResponse(await client.get(createPhysicalKey(key)));
62
+ },
63
+ /** @inheritdoc */
64
+ async set({ key, value, ttlSeconds }): Promise<void> {
65
+ const physicalKey = createPhysicalKey(key);
66
+ if (ttlSeconds === undefined) {
67
+ validateOkResponse('SET', await client.set(physicalKey, value));
68
+ return;
69
+ }
70
+ validateOkResponse('SETEX', await client.setEx(physicalKey, ttlSeconds, value));
71
+ },
72
+ /** @inheritdoc */
73
+ async deleteMany(keys: readonly string[]): Promise<void> {
74
+ if (keys.length === 0) {
75
+ return;
76
+ }
77
+ validateDeleteResponse(await client.del(keys.map(createPhysicalKey)));
78
+ },
79
+ /** @inheritdoc */
80
+ async scan({ cursor, pattern, count }): Promise<{
81
+ readonly cursor: string;
82
+ readonly keys: readonly string[];
83
+ }> {
84
+ const response = await client.scan(cursor, {
85
+ MATCH: createRedisScanPattern(keyPrefix, pattern),
86
+ COUNT: count,
87
+ });
88
+ return normalizeScanResponse(response, keyPrefix);
89
+ },
90
+ /** @inheritdoc */
91
+ async flushDatabase(): Promise<void> {
92
+ validateOkResponse('FLUSHDB', await client.flushDb());
93
+ },
94
+ };
95
+ }
@@ -1,38 +1,38 @@
1
- const REDIS_GLOB_META_CHARACTERS = new Set(['\\', '*', '?', '[', ']']);
2
-
3
- /**
4
- * 将普通字符串转换为 Redis glob pattern 中的字面量片段。
5
- * @param value 仅作为字面前缀使用的字符串。
6
- * @returns 对反斜杠、星号、问号和方括号增加反斜杠转义后的片段。
7
- */
8
- export function escapeRedisGlobLiteral(value: string): string {
9
- let escaped = '';
10
- for (const character of value) {
11
- escaped += REDIS_GLOB_META_CHARACTERS.has(character) ? `\\${character}` : character;
12
- }
13
- return escaped;
14
- }
15
-
16
- /**
17
- * 为逻辑 glob pattern 增加按字面量解释的 Redis key 前缀。
18
- * @param keyPrefix 调用方配置的物理 key 前缀。
19
- * @param pattern Provider 传入且需要保留 glob 语义的逻辑 pattern。
20
- * @returns 可直接交给 Redis SCAN MATCH 的物理 pattern。
21
- */
22
- export function createRedisScanPattern(keyPrefix: string, pattern: string): string {
23
- return `${escapeRedisGlobLiteral(keyPrefix)}${pattern}`;
24
- }
25
-
26
- /**
27
- * 验证扫描结果属于指定物理命名空间并恢复逻辑 key。
28
- * @param keyPrefix 调用方配置的物理 key 前缀。
29
- * @param physicalKey Redis SCAN 返回的物理 key。
30
- * @returns 只剥离一次字面前缀后的逻辑 key。
31
- * @throws 扫描结果不属于指定前缀时抛出 TypeError,避免扩大后续删除范围。
32
- */
33
- export function stripRedisKeyPrefix(keyPrefix: string, physicalKey: string): string {
34
- if (!physicalKey.startsWith(keyPrefix)) {
35
- throw new TypeError('Redis SCAN returned a key outside the configured key prefix');
36
- }
37
- return physicalKey.slice(keyPrefix.length);
38
- }
1
+ const REDIS_GLOB_META_CHARACTERS = new Set(['\\', '*', '?', '[', ']']);
2
+
3
+ /**
4
+ * 将普通字符串转换为 Redis glob pattern 中的字面量片段。
5
+ * @param value 仅作为字面前缀使用的字符串。
6
+ * @returns 对反斜杠、星号、问号和方括号增加反斜杠转义后的片段。
7
+ */
8
+ export function escapeRedisGlobLiteral(value: string): string {
9
+ let escaped = '';
10
+ for (const character of value) {
11
+ escaped += REDIS_GLOB_META_CHARACTERS.has(character) ? `\\${character}` : character;
12
+ }
13
+ return escaped;
14
+ }
15
+
16
+ /**
17
+ * 为逻辑 glob pattern 增加按字面量解释的 Redis key 前缀。
18
+ * @param keyPrefix 调用方配置的物理 key 前缀。
19
+ * @param pattern Provider 传入且需要保留 glob 语义的逻辑 pattern。
20
+ * @returns 可直接交给 Redis SCAN MATCH 的物理 pattern。
21
+ */
22
+ export function createRedisScanPattern(keyPrefix: string, pattern: string): string {
23
+ return `${escapeRedisGlobLiteral(keyPrefix)}${pattern}`;
24
+ }
25
+
26
+ /**
27
+ * 验证扫描结果属于指定物理命名空间并恢复逻辑 key。
28
+ * @param keyPrefix 调用方配置的物理 key 前缀。
29
+ * @param physicalKey Redis SCAN 返回的物理 key。
30
+ * @returns 只剥离一次字面前缀后的逻辑 key。
31
+ * @throws 扫描结果不属于指定前缀时抛出 TypeError,避免扩大后续删除范围。
32
+ */
33
+ export function stripRedisKeyPrefix(keyPrefix: string, physicalKey: string): string {
34
+ if (!physicalKey.startsWith(keyPrefix)) {
35
+ throw new TypeError('Redis SCAN returned a key outside the configured key prefix');
36
+ }
37
+ return physicalKey.slice(keyPrefix.length);
38
+ }