@aomex/cache 3.30.8-alpha.7326d75.0 → 4.0.0
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/CHANGELOG.md +18 -0
- package/dist/index.d.ts +62 -17
- package/dist/index.js +76 -18
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,24 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
# [4.0.0](https://github.com/aomex/aomex/compare/v3.30.7...v4.0.0) (2026-11-17)
|
|
7
|
+
|
|
8
|
+
* feat(cache)!: 新增文件缓存,适配器改为子路径导出并移除工厂函数 ([943b243](https://github.com/aomex/aomex/commit/943b2432ebc97db8f4f199ff0ee8fa2c2dc04bfd))
|
|
9
|
+
* feat(cache)!: 引入BaseCacheService服务和remember装饰器 ([f48dba5](https://github.com/aomex/aomex/commit/f48dba555e6ddfaa4cc5b240b30cea6e4b39a0c1))
|
|
10
|
+
* chore!: 升级至 TypeScript 7 并将构建工具迁移到 tsdown ([a111409](https://github.com/aomex/aomex/commit/a111409021e2ee81ee5fb20ccc75480c9b5fa4c0))
|
|
11
|
+
|
|
12
|
+
### Features
|
|
13
|
+
|
|
14
|
+
* **cache:** 引入CacheKey类以增强缓存键管理功能 ([3d94097](https://github.com/aomex/aomex/commit/3d940976219585f63336675a037c46656ba29b55))
|
|
15
|
+
|
|
16
|
+
### BREAKING CHANGES
|
|
17
|
+
|
|
18
|
+
* Node.js 最低版本提升至 `>=24.0.0`。
|
|
19
|
+
* 最低 TypeScript 版本为 7。
|
|
20
|
+
* 移除 `memoryAdapter` / `redisAdapter`,改为直接new Class
|
|
21
|
+
* 装饰器从 Caching.decorate 改为 remember
|
|
22
|
+
|
|
23
|
+
|
|
6
24
|
## [3.30.7](https://github.com/aomex/aomex/compare/v3.30.6...v3.30.7) (2026-11-01)
|
|
7
25
|
|
|
8
26
|
**Note:** Version bump only for package @aomex/cache
|
package/dist/index.d.ts
CHANGED
|
@@ -1,9 +1,35 @@
|
|
|
1
1
|
import { t as CacheAdapter } from "./cache-adapter-CVIt9DB_.js";
|
|
2
2
|
import { Service } from "@aomex/common";
|
|
3
|
+
/**
|
|
4
|
+
* 缓存键。通常由 `BaseCacheService#key()` / `#keyHash()` 创建。
|
|
5
|
+
*
|
|
6
|
+
* ```typescript
|
|
7
|
+
* this.key('user', 1); // user:1
|
|
8
|
+
* this.key('user').key(1); // user:1
|
|
9
|
+
* this.keyHash('user', 1); // md5('user:1')
|
|
10
|
+
* this.key('user').keyHash(1); // user:md5('1')
|
|
11
|
+
* this.key('user', 1).toHash(); // md5('user:1')
|
|
12
|
+
* await this.cache.get(this.key('user', 1));
|
|
13
|
+
* ```
|
|
14
|
+
*/
|
|
15
|
+
export declare class CacheKey {
|
|
16
|
+
protected readonly value: string;
|
|
17
|
+
constructor(value?: string);
|
|
18
|
+
/** 用 `:` 拼接片段(保留已有前缀),如 `key('user').key(1)` → `'user:1'` */
|
|
19
|
+
key(...keys: Array<string | number>): CacheKey;
|
|
20
|
+
/** 仅对本次参数拼接后 MD5,再接到已有前缀后 */
|
|
21
|
+
keyHash(...keys: Array<string | number>): CacheKey;
|
|
22
|
+
/** 对当前完整键做 MD5 */
|
|
23
|
+
toHash(): CacheKey;
|
|
24
|
+
protected toString(): string;
|
|
25
|
+
protected md5(key: string | number): string;
|
|
26
|
+
}
|
|
3
27
|
export declare namespace Caching {
|
|
4
28
|
type Types = string | number | unknown[] | readonly unknown[] | {
|
|
5
29
|
[K: string]: any;
|
|
6
30
|
} | boolean | Map<any, any> | Set<any> | bigint | Date;
|
|
31
|
+
/** 缓存键:字符串或 `CacheKey` */
|
|
32
|
+
type Key = string | CacheKey;
|
|
7
33
|
}
|
|
8
34
|
export declare class Caching<T extends CacheAdapter = CacheAdapter> {
|
|
9
35
|
readonly adapter: T;
|
|
@@ -11,7 +37,7 @@ export declare class Caching<T extends CacheAdapter = CacheAdapter> {
|
|
|
11
37
|
/**
|
|
12
38
|
* 查看缓存是否存在
|
|
13
39
|
*/
|
|
14
|
-
exists(key:
|
|
40
|
+
exists(key: Caching.Key): Promise<boolean>;
|
|
15
41
|
/**
|
|
16
42
|
*
|
|
17
43
|
* 获取缓存。如果未找到缓存并且未提供默认值,则返回`null`
|
|
@@ -20,9 +46,9 @@ export declare class Caching<T extends CacheAdapter = CacheAdapter> {
|
|
|
20
46
|
* await cache.get('key', 'my-value'); // my-value
|
|
21
47
|
* ```
|
|
22
48
|
*/
|
|
23
|
-
get<T>(key:
|
|
24
|
-
get<T extends Caching.Types>(key:
|
|
25
|
-
get<T extends Caching.Types>(key:
|
|
49
|
+
get<T>(key: Caching.Key, defaultValue: T): Promise<T>;
|
|
50
|
+
get<T extends Caching.Types>(key: Caching.Key, defaultValue: T | null | undefined): Promise<T | null>;
|
|
51
|
+
get<T extends Caching.Types>(key: Caching.Key): Promise<T | null>;
|
|
26
52
|
/**
|
|
27
53
|
* 设置缓存。可以指定过期时间(毫秒)
|
|
28
54
|
*
|
|
@@ -31,7 +57,7 @@ export declare class Caching<T extends CacheAdapter = CacheAdapter> {
|
|
|
31
57
|
* await cache.set('key', 'value', 3600);
|
|
32
58
|
* ```
|
|
33
59
|
*/
|
|
34
|
-
set(key:
|
|
60
|
+
set(key: Caching.Key, value: Caching.Types, durationMs?: number): Promise<boolean>;
|
|
35
61
|
/**
|
|
36
62
|
* 设置缓存。如果缓存已经存在,则设置失败,返回`false`
|
|
37
63
|
*
|
|
@@ -40,7 +66,7 @@ export declare class Caching<T extends CacheAdapter = CacheAdapter> {
|
|
|
40
66
|
* await cache.setNX('foo', 'baz'); // false
|
|
41
67
|
* ```
|
|
42
68
|
*/
|
|
43
|
-
setNX(key:
|
|
69
|
+
setNX(key: Caching.Key, value: Caching.Types, durationMs?: number): Promise<boolean>;
|
|
44
70
|
/**
|
|
45
71
|
* 将一个或多个值按顺序插入到列表头部。当 key 存在但不是列表类型时,返回一个错误。
|
|
46
72
|
*
|
|
@@ -49,11 +75,11 @@ export declare class Caching<T extends CacheAdapter = CacheAdapter> {
|
|
|
49
75
|
* await cache.leftPush('foo', 'b', 'c'); // ['b', 'c', 'a']
|
|
50
76
|
* ```
|
|
51
77
|
*/
|
|
52
|
-
leftPush(key:
|
|
78
|
+
leftPush(key: Caching.Key, ...values: Caching.Types[]): Promise<boolean>;
|
|
53
79
|
/**
|
|
54
80
|
* 移除列表的最后一个元素,返回值为被移除的元素
|
|
55
81
|
*/
|
|
56
|
-
rightPop<T extends Caching.Types>(key:
|
|
82
|
+
rightPop<T extends Caching.Types>(key: Caching.Key): Promise<T | null>;
|
|
57
83
|
/**
|
|
58
84
|
* 将key中储存的数字值增一。如果key不存在,那么key的值会先被初始化为0,然后再执行操作。如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误。
|
|
59
85
|
*
|
|
@@ -63,11 +89,11 @@ export declare class Caching<T extends CacheAdapter = CacheAdapter> {
|
|
|
63
89
|
* await cache.increment('foo'); // 3
|
|
64
90
|
* ```
|
|
65
91
|
*/
|
|
66
|
-
increment(key:
|
|
92
|
+
increment(key: Caching.Key): Promise<number>;
|
|
67
93
|
/**
|
|
68
94
|
* 重新设置缓存时间。如果key不存在,则返回`false`
|
|
69
95
|
*/
|
|
70
|
-
expire(key:
|
|
96
|
+
expire(key: Caching.Key, durationMs: number): Promise<boolean>;
|
|
71
97
|
/**
|
|
72
98
|
* 检测缓存的剩余生存时间(Time to live)
|
|
73
99
|
* - 不存在则返回`-2`
|
|
@@ -82,19 +108,20 @@ export declare class Caching<T extends CacheAdapter = CacheAdapter> {
|
|
|
82
108
|
* await cache.ttl('foo'); // 59000
|
|
83
109
|
* ```
|
|
84
110
|
*/
|
|
85
|
-
ttl(key:
|
|
111
|
+
ttl(key: Caching.Key): Promise<number>;
|
|
86
112
|
/**
|
|
87
113
|
* 将key中储存的数字值减一。如果key不存在,那么key的值会先被初始化为0,然后再执行操作。如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误
|
|
88
114
|
*/
|
|
89
|
-
decrement(key:
|
|
115
|
+
decrement(key: Caching.Key): Promise<number>;
|
|
90
116
|
/**
|
|
91
117
|
* 删除指定缓存
|
|
92
118
|
*/
|
|
93
|
-
delete(key:
|
|
119
|
+
delete(key: Caching.Key): Promise<boolean>;
|
|
94
120
|
/**
|
|
95
121
|
* 删除所有缓存
|
|
96
122
|
*/
|
|
97
123
|
deleteAll(): Promise<boolean>;
|
|
124
|
+
protected resolveKey(key: Caching.Key): string;
|
|
98
125
|
protected encodeValue(value: Caching.Types): string;
|
|
99
126
|
protected stringifyReplacer(value: Caching.Types): string | number | boolean | unknown[] | readonly unknown[] | {
|
|
100
127
|
[K: string]: any;
|
|
@@ -137,10 +164,28 @@ export declare abstract class BaseCacheService<T extends CacheAdapter = CacheAda
|
|
|
137
164
|
/** 按 365 天计 */
|
|
138
165
|
readonly YEAR: 31536000000;
|
|
139
166
|
};
|
|
140
|
-
/**
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
167
|
+
/**
|
|
168
|
+
* 用 `:` 拼接片段,得到可读的缓存键(可继续链式调用)。
|
|
169
|
+
*
|
|
170
|
+
* ```typescript
|
|
171
|
+
* this.key('user', 1); // user:1
|
|
172
|
+
* this.key('user').key(1); // 同上
|
|
173
|
+
* this.key('user').keyHash(1); // user:<md5('1')> 前缀保留,只哈希新片段
|
|
174
|
+
* this.key('user', 1).toHash(); // <md5('user:1')> 整键再哈希
|
|
175
|
+
* await this.cache.get(this.key('user', 1));
|
|
176
|
+
* ```
|
|
177
|
+
*/
|
|
178
|
+
protected key(...keys: Array<string | number>): CacheKey;
|
|
179
|
+
/**
|
|
180
|
+
* 将片段用 `:` 拼接后整体 MD5(无可读前缀)。
|
|
181
|
+
* 等价于 `this.key(...keys).toHash()`。
|
|
182
|
+
*
|
|
183
|
+
* ```typescript
|
|
184
|
+
* this.keyHash('user', 1); // <md5('user:1')>
|
|
185
|
+
* this.key('user').keyHash(1); // 不是这个:那是「前缀 + 哈希段」
|
|
186
|
+
* ```
|
|
187
|
+
*/
|
|
188
|
+
protected keyHash(...keys: Array<string | number>): CacheKey;
|
|
144
189
|
}
|
|
145
190
|
type RememberOptions<R extends Caching.Types | null = Caching.Types | null, P extends (...args: any[]) => Promise<R> = (...args: any[]) => Promise<R>, Q extends NonNullable<R> = NonNullable<R>> = {
|
|
146
191
|
key?: string | ((this: any, ...args: Parameters<P>) => string);
|
package/dist/index.js
CHANGED
|
@@ -1,7 +1,44 @@
|
|
|
1
1
|
import { n as CacheAdapter, t as i18n } from "./i18n-OXOpRIod.js";
|
|
2
|
+
import { createHash } from "node:crypto";
|
|
2
3
|
import { traceBlock } from "@aomex/async-trace";
|
|
3
4
|
import { Service, sleep } from "@aomex/common";
|
|
4
|
-
|
|
5
|
+
// src/cache-key.ts
|
|
6
|
+
/**
|
|
7
|
+
* 缓存键。通常由 `BaseCacheService#key()` / `#keyHash()` 创建。
|
|
8
|
+
*
|
|
9
|
+
* ```typescript
|
|
10
|
+
* this.key('user', 1); // user:1
|
|
11
|
+
* this.key('user').key(1); // user:1
|
|
12
|
+
* this.keyHash('user', 1); // md5('user:1')
|
|
13
|
+
* this.key('user').keyHash(1); // user:md5('1')
|
|
14
|
+
* this.key('user', 1).toHash(); // md5('user:1')
|
|
15
|
+
* await this.cache.get(this.key('user', 1));
|
|
16
|
+
* ```
|
|
17
|
+
*/
|
|
18
|
+
var CacheKey = class CacheKey {
|
|
19
|
+
value;
|
|
20
|
+
constructor(value = "") {
|
|
21
|
+
this.value = value;
|
|
22
|
+
}
|
|
23
|
+
/** 用 `:` 拼接片段(保留已有前缀),如 `key('user').key(1)` → `'user:1'` */
|
|
24
|
+
key(...keys) {
|
|
25
|
+
return new CacheKey((this.value === "" ? keys : [this.value, ...keys]).join(":"));
|
|
26
|
+
}
|
|
27
|
+
/** 仅对本次参数拼接后 MD5,再接到已有前缀后 */
|
|
28
|
+
keyHash(...keys) {
|
|
29
|
+
return this.key(this.md5(keys.join(":")));
|
|
30
|
+
}
|
|
31
|
+
/** 对当前完整键做 MD5 */
|
|
32
|
+
toHash() {
|
|
33
|
+
return new CacheKey(this.md5(this.value));
|
|
34
|
+
}
|
|
35
|
+
toString() {
|
|
36
|
+
return this.value;
|
|
37
|
+
}
|
|
38
|
+
md5(key) {
|
|
39
|
+
return createHash("md5").update(String(key)).digest("hex");
|
|
40
|
+
}
|
|
41
|
+
};
|
|
5
42
|
// src/caching.ts
|
|
6
43
|
const CACHING_TYPE = "_$caching_type$_";
|
|
7
44
|
const CACHING_DATA = "_$caching_data$_";
|
|
@@ -15,11 +52,11 @@ var Caching = class {
|
|
|
15
52
|
*/
|
|
16
53
|
async exists(key) {
|
|
17
54
|
await this.adapter.connect();
|
|
18
|
-
return this.adapter.existsKey(key);
|
|
55
|
+
return this.adapter.existsKey(this.resolveKey(key));
|
|
19
56
|
}
|
|
20
57
|
async get(key, defaultValue) {
|
|
21
58
|
await this.adapter.connect();
|
|
22
|
-
const result = await this.adapter.getValue(key);
|
|
59
|
+
const result = await this.adapter.getValue(this.resolveKey(key));
|
|
23
60
|
return this.decodeValue(result, defaultValue);
|
|
24
61
|
}
|
|
25
62
|
/**
|
|
@@ -32,7 +69,7 @@ var Caching = class {
|
|
|
32
69
|
*/
|
|
33
70
|
async set(key, value, durationMs) {
|
|
34
71
|
await this.adapter.connect();
|
|
35
|
-
return this.adapter.setValue(key, this.encodeValue(value), durationMs);
|
|
72
|
+
return this.adapter.setValue(this.resolveKey(key), this.encodeValue(value), durationMs);
|
|
36
73
|
}
|
|
37
74
|
/**
|
|
38
75
|
* 设置缓存。如果缓存已经存在,则设置失败,返回`false`
|
|
@@ -44,7 +81,7 @@ var Caching = class {
|
|
|
44
81
|
*/
|
|
45
82
|
async setNX(key, value, durationMs) {
|
|
46
83
|
await this.adapter.connect();
|
|
47
|
-
return this.adapter.setNotExistValue(key, this.encodeValue(value), durationMs);
|
|
84
|
+
return this.adapter.setNotExistValue(this.resolveKey(key), this.encodeValue(value), durationMs);
|
|
48
85
|
}
|
|
49
86
|
/**
|
|
50
87
|
* 将一个或多个值按顺序插入到列表头部。当 key 存在但不是列表类型时,返回一个错误。
|
|
@@ -57,14 +94,14 @@ var Caching = class {
|
|
|
57
94
|
async leftPush(key, ...values) {
|
|
58
95
|
if (!values.length) return false;
|
|
59
96
|
await this.adapter.connect();
|
|
60
|
-
return this.adapter.leftPushValue(key, ...values.map((value) => this.encodeValue(value)));
|
|
97
|
+
return this.adapter.leftPushValue(this.resolveKey(key), ...values.map((value) => this.encodeValue(value)));
|
|
61
98
|
}
|
|
62
99
|
/**
|
|
63
100
|
* 移除列表的最后一个元素,返回值为被移除的元素
|
|
64
101
|
*/
|
|
65
102
|
async rightPop(key) {
|
|
66
103
|
await this.adapter.connect();
|
|
67
|
-
const result = await this.adapter.rightPopValue(key);
|
|
104
|
+
const result = await this.adapter.rightPopValue(this.resolveKey(key));
|
|
68
105
|
return this.decodeValue(result);
|
|
69
106
|
}
|
|
70
107
|
/**
|
|
@@ -78,14 +115,14 @@ var Caching = class {
|
|
|
78
115
|
*/
|
|
79
116
|
async increment(key) {
|
|
80
117
|
await this.adapter.connect();
|
|
81
|
-
return this.adapter.increaseValue(key);
|
|
118
|
+
return this.adapter.increaseValue(this.resolveKey(key));
|
|
82
119
|
}
|
|
83
120
|
/**
|
|
84
121
|
* 重新设置缓存时间。如果key不存在,则返回`false`
|
|
85
122
|
*/
|
|
86
123
|
async expire(key, durationMs) {
|
|
87
124
|
await this.adapter.connect();
|
|
88
|
-
return this.adapter.expireKey(key, durationMs);
|
|
125
|
+
return this.adapter.expireKey(this.resolveKey(key), durationMs);
|
|
89
126
|
}
|
|
90
127
|
/**
|
|
91
128
|
* 检测缓存的剩余生存时间(Time to live)
|
|
@@ -103,21 +140,21 @@ var Caching = class {
|
|
|
103
140
|
*/
|
|
104
141
|
async ttl(key) {
|
|
105
142
|
await this.adapter.connect();
|
|
106
|
-
return this.adapter.ttlKey(key);
|
|
143
|
+
return this.adapter.ttlKey(this.resolveKey(key));
|
|
107
144
|
}
|
|
108
145
|
/**
|
|
109
146
|
* 将key中储存的数字值减一。如果key不存在,那么key的值会先被初始化为0,然后再执行操作。如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误
|
|
110
147
|
*/
|
|
111
148
|
async decrement(key) {
|
|
112
149
|
await this.adapter.connect();
|
|
113
|
-
return this.adapter.decreaseValue(key);
|
|
150
|
+
return this.adapter.decreaseValue(this.resolveKey(key));
|
|
114
151
|
}
|
|
115
152
|
/**
|
|
116
153
|
* 删除指定缓存
|
|
117
154
|
*/
|
|
118
155
|
async delete(key) {
|
|
119
156
|
await this.adapter.connect();
|
|
120
|
-
return this.adapter.deleteValue(key);
|
|
157
|
+
return this.adapter.deleteValue(this.resolveKey(key));
|
|
121
158
|
}
|
|
122
159
|
/**
|
|
123
160
|
* 删除所有缓存
|
|
@@ -126,6 +163,9 @@ var Caching = class {
|
|
|
126
163
|
await this.adapter.connect();
|
|
127
164
|
return this.adapter.deleteAllValues();
|
|
128
165
|
}
|
|
166
|
+
resolveKey(key) {
|
|
167
|
+
return typeof key === "string" ? key : key["value"];
|
|
168
|
+
}
|
|
129
169
|
encodeValue(value) {
|
|
130
170
|
if (value instanceof Date) value = this.convertDate(value);
|
|
131
171
|
return JSON.stringify(value, (_, v) => this.stringifyReplacer(v));
|
|
@@ -325,15 +365,33 @@ var BaseCacheService = class extends Service {
|
|
|
325
365
|
get ttl() {
|
|
326
366
|
return CACHE_TTL;
|
|
327
367
|
}
|
|
328
|
-
/**
|
|
368
|
+
/**
|
|
369
|
+
* 用 `:` 拼接片段,得到可读的缓存键(可继续链式调用)。
|
|
370
|
+
*
|
|
371
|
+
* ```typescript
|
|
372
|
+
* this.key('user', 1); // user:1
|
|
373
|
+
* this.key('user').key(1); // 同上
|
|
374
|
+
* this.key('user').keyHash(1); // user:<md5('1')> 前缀保留,只哈希新片段
|
|
375
|
+
* this.key('user', 1).toHash(); // <md5('user:1')> 整键再哈希
|
|
376
|
+
* await this.cache.get(this.key('user', 1));
|
|
377
|
+
* ```
|
|
378
|
+
*/
|
|
329
379
|
key(...keys) {
|
|
330
|
-
return keys.
|
|
380
|
+
return keys.length === 0 ? new CacheKey() : new CacheKey().key(...keys);
|
|
331
381
|
}
|
|
332
|
-
/**
|
|
333
|
-
|
|
334
|
-
|
|
382
|
+
/**
|
|
383
|
+
* 将片段用 `:` 拼接后整体 MD5(无可读前缀)。
|
|
384
|
+
* 等价于 `this.key(...keys).toHash()`。
|
|
385
|
+
*
|
|
386
|
+
* ```typescript
|
|
387
|
+
* this.keyHash('user', 1); // <md5('user:1')>
|
|
388
|
+
* this.key('user').keyHash(1); // 不是这个:那是「前缀 + 哈希段」
|
|
389
|
+
* ```
|
|
390
|
+
*/
|
|
391
|
+
keyHash(...keys) {
|
|
392
|
+
return new CacheKey().keyHash(...keys);
|
|
335
393
|
}
|
|
336
394
|
};
|
|
337
|
-
export { BaseCacheService, CacheAdapter, Caching, createRemember };
|
|
395
|
+
export { BaseCacheService, CacheAdapter, CacheKey, Caching, createRemember };
|
|
338
396
|
|
|
339
397
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/caching.ts","../src/remember.ts","../src/base-cache-service.ts"],"sourcesContent":["import { CacheAdapter } from './cache-adapter';\n\nexport namespace Caching {\n export type Types =\n | string\n | number\n | unknown[]\n | readonly unknown[]\n | { [K: string]: any }\n | boolean\n | Map<any, any>\n | Set<any>\n | bigint\n | Date;\n}\n\nconst CACHING_TYPE = '_$caching_type$_';\nconst CACHING_DATA = '_$caching_data$_';\n\nexport class Caching<T extends CacheAdapter = CacheAdapter> {\n constructor(readonly adapter: T) {}\n\n /**\n * 查看缓存是否存在\n */\n async exists(key: string): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.existsKey(key);\n }\n\n /**\n *\n * 获取缓存。如果未找到缓存并且未提供默认值,则返回`null`\n * ```typescript\n * await cache.get('key'); // null\n * await cache.get('key', 'my-value'); // my-value\n * ```\n */\n async get<T>(key: string, defaultValue: T): Promise<T>;\n async get<T extends Caching.Types>(\n key: string,\n defaultValue: T | null | undefined,\n ): Promise<T | null>;\n async get<T extends Caching.Types>(key: string): Promise<T | null>;\n async get(key: string, defaultValue?: Caching.Types | null): Promise<any> {\n await this.adapter.connect();\n const result = await this.adapter.getValue(key);\n return this.decodeValue(result, defaultValue);\n }\n\n /**\n * 设置缓存。可以指定过期时间(毫秒)\n *\n * ```typescript\n * await cache.set('key', 'value');\n * await cache.set('key', 'value', 3600);\n * ```\n */\n async set(key: string, value: Caching.Types, durationMs?: number): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.setValue(key, this.encodeValue(value), durationMs);\n }\n\n /**\n * 设置缓存。如果缓存已经存在,则设置失败,返回`false`\n *\n * ```typescript\n * await cache.setNX('foo', 'bar'); // true\n * await cache.setNX('foo', 'baz'); // false\n * ```\n */\n async setNX(key: string, value: Caching.Types, durationMs?: number): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.setNotExistValue(key, this.encodeValue(value), durationMs);\n }\n\n /**\n * 将一个或多个值按顺序插入到列表头部。当 key 存在但不是列表类型时,返回一个错误。\n *\n * ```typescript\n * await cache.leftPush('foo', 'a'); // ['a']\n * await cache.leftPush('foo', 'b', 'c'); // ['b', 'c', 'a']\n * ```\n */\n async leftPush(key: string, ...values: Caching.Types[]): Promise<boolean> {\n if (!values.length) return false;\n await this.adapter.connect();\n return this.adapter.leftPushValue(\n key,\n ...values.map((value) => this.encodeValue(value)),\n );\n }\n\n /**\n * 移除列表的最后一个元素,返回值为被移除的元素\n */\n async rightPop<T extends Caching.Types>(key: string): Promise<T | null> {\n await this.adapter.connect();\n const result = await this.adapter.rightPopValue(key);\n return this.decodeValue(result);\n }\n\n /**\n * 将key中储存的数字值增一。如果key不存在,那么key的值会先被初始化为0,然后再执行操作。如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误。\n *\n * ```typescript\n * await cache.increment('foo'); // 1\n * await cache.increment('foo'); // 2\n * await cache.increment('foo'); // 3\n * ```\n */\n async increment(key: string): Promise<number> {\n await this.adapter.connect();\n return this.adapter.increaseValue(key);\n }\n\n /**\n * 重新设置缓存时间。如果key不存在,则返回`false`\n */\n async expire(key: string, durationMs: number): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.expireKey(key, durationMs);\n }\n\n /**\n * 检测缓存的剩余生存时间(Time to live)\n * - 不存在则返回`-2`\n * - 未设置过期时间则返回`-1`\n * - 已设置过期时间则返回剩余时间,单位**毫秒**\n *\n * ```typescript\n * await cache.ttl('foo'); // -2\n * await cache.set('foo', 'bar');\n * await cache.ttl('foo'); // -1\n * await cache.expire('foo', 60000);\n * await cache.ttl('foo'); // 59000\n * ```\n */\n async ttl(key: string): Promise<number> {\n await this.adapter.connect();\n return this.adapter.ttlKey(key);\n }\n\n /**\n * 将key中储存的数字值减一。如果key不存在,那么key的值会先被初始化为0,然后再执行操作。如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误\n */\n async decrement(key: string): Promise<number> {\n await this.adapter.connect();\n return this.adapter.decreaseValue(key);\n }\n\n /**\n * 删除指定缓存\n */\n async delete(key: string): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.deleteValue(key);\n }\n\n /**\n * 删除所有缓存\n */\n async deleteAll(): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.deleteAllValues();\n }\n\n protected encodeValue(value: Caching.Types) {\n if (value instanceof Date) {\n value = this.convertDate(value);\n }\n return JSON.stringify(value, (_, v) => this.stringifyReplacer(v));\n }\n\n protected stringifyReplacer(value: Caching.Types) {\n if (value instanceof Map) {\n value = { [CACHING_TYPE]: 'Map', [CACHING_DATA]: Array.from(value.entries()) };\n } else if (value instanceof Set) {\n value = { [CACHING_TYPE]: 'Set', [CACHING_DATA]: Array.from(value.values()) };\n } else if (typeof value === 'bigint') {\n value = { [CACHING_TYPE]: 'BigInt', [CACHING_DATA]: value.toString() };\n } else if (value && typeof value === 'object') {\n if (Array.isArray(value)) {\n value = value.map((v) => this.convertDate(v));\n } else {\n value = Object.fromEntries(\n Object.entries(value).map(([k, v]) => {\n return [k, this.convertDate(v)];\n }),\n );\n }\n }\n\n return value;\n }\n\n protected convertDate(value: any) {\n if (value instanceof Date) {\n return { [CACHING_TYPE]: 'Date', [CACHING_DATA]: value.toISOString() };\n }\n return value;\n }\n\n protected decodeValue(value: string | null, defaultValue?: Caching.Types | null) {\n if (value === null) {\n return defaultValue === void 0 ? null : defaultValue;\n }\n\n try {\n return JSON.parse(value, (_, v) => this.jsonParseReviver(v));\n } catch {\n return null;\n }\n }\n\n protected jsonParseReviver(value: any) {\n if (value && typeof value === 'object') {\n const keys = Object.keys(value);\n if (\n keys.length === 2 &&\n keys.includes(CACHING_TYPE) &&\n keys.includes(CACHING_DATA)\n ) {\n switch (value[CACHING_TYPE]) {\n case 'Map':\n if (Array.isArray(value[CACHING_DATA])) {\n return new Map(value[CACHING_DATA]);\n }\n break;\n case 'Set':\n if (Array.isArray(value[CACHING_DATA])) {\n return new Set(value[CACHING_DATA]);\n }\n break;\n case 'Date':\n if (typeof value[CACHING_DATA] === 'string') {\n return new Date(value[CACHING_DATA]);\n }\n break;\n case 'BigInt':\n if (typeof value[CACHING_DATA] === 'string') {\n return BigInt(value[CACHING_DATA]);\n }\n break;\n }\n }\n }\n return value;\n }\n}\n","import { traceBlock } from '@aomex/async-trace';\nimport { sleep } from '@aomex/common';\nimport type { BaseCacheService } from './base-cache-service';\nimport type { Caching } from './caching';\nimport { i18n } from './i18n';\n\nexport type RememberOptions<\n R extends Caching.Types | null = Caching.Types | null,\n P extends (...args: any[]) => Promise<R> = (...args: any[]) => Promise<R>,\n Q extends NonNullable<R> = NonNullable<R>,\n> = {\n key?: string | ((this: any, ...args: Parameters<P>) => string);\n duration: number;\n /**\n * 当数据源返回 null 或者 undefined 时,则返回默认值\n */\n defaultValue?: Q;\n};\n\n/**\n * 可调用的方法装饰器,由 `createRemember(CacheService)` 创建。\n * 绑定到指定缓存服务类;实例 `onInit` 完成前调用会等待就绪,`onDestroy` 后调用会抛错。\n */\nexport interface Remember {\n (\n durationMs: number,\n ): (\n originalMethod: (...args: any[]) => Promise<any>,\n context: ClassMethodDecoratorContext,\n ) => (...args: any[]) => Promise<any>;\n <\n R extends Caching.Types | null,\n P extends (...args: any[]) => Promise<R>,\n Q extends NonNullable<R>,\n >(\n opts: RememberOptions<R, P, Q>,\n ): (originalMethod: P, context: ClassMethodDecoratorContext) => P;\n}\n\n/** 任意 `BaseCacheService` 构造函数(含基类,供内部挂载使用) */\nexport type CacheServiceCtor = abstract new (...args: any[]) => BaseCacheService;\n\n/**\n * 具体缓存服务子类构造函数。传入 `BaseCacheService` 本身时类型为 `never`。\n */\nexport type ConcreteCacheServiceCtor<C extends CacheServiceCtor = CacheServiceCtor> =\n BaseCacheService extends InstanceType<C> ? never : C;\n\ntype CtorState = {\n cache: Caching | undefined;\n /** 已经 onDestroy,且尚未再次 onInit */\n destroyed: boolean;\n ready: PromiseWithResolvers<Caching>;\n};\n\n/** 每个服务类一份:当前 `Caching` + 未就绪时的等待 Promise */\nconst stateByCtor = new WeakMap<CacheServiceCtor, CtorState>();\n\nfunction getState(ctor: CacheServiceCtor): CtorState {\n const existing = stateByCtor.get(ctor);\n if (existing) return existing;\n\n const state: CtorState = {\n cache: undefined,\n destroyed: false,\n ready: Promise.withResolvers<Caching>(),\n };\n stateByCtor.set(ctor, state);\n return state;\n}\n\nasync function ensureCache(ctor: CacheServiceCtor): Promise<Caching> {\n const state = getState(ctor);\n if (state.destroyed) {\n throw new Error(i18n.t('cache_service_destroyed'));\n }\n if (state.cache) return state.cache;\n\n await state.ready.promise;\n // attach resolve 与 await 恢复之间可能已经 onDestroy\n if (state.destroyed || !state.cache) {\n throw new Error(i18n.t('cache_service_destroyed'));\n }\n return state.cache;\n}\n\n/** 供 `BaseCacheService.onInit` 挂载;包外请勿直接调用 */\nexport function attachRememberScopes(service: BaseCacheService): void {\n const ctor = service.constructor as CacheServiceCtor;\n const cache = service['_cache'];\n const state = getState(ctor);\n state.destroyed = false;\n state.cache = cache;\n state.ready.resolve(cache);\n}\n\n/** 供 `BaseCacheService.onDestroy` / `onInit` 失败时卸载;包外请勿直接调用 */\nexport function detachRememberScopes(service: BaseCacheService): void {\n const ctor = service.constructor as CacheServiceCtor;\n const state = stateByCtor.get(ctor);\n if (!state) return;\n // 已有其它实例挂载时,非当前挂载者不处理;尚未 attach(如 connect 失败)时仍要 reject 等待者\n if (state.cache !== undefined && state.cache !== service['_cache']) return;\n // 先标 destroyed,避免并发 ensureCache 在清 cache 后误走已 settle 的 ready\n state.destroyed = true;\n state.cache = undefined;\n state.ready.reject(new Error(i18n.t('cache_service_destroyed')));\n}\n\n/**\n * 创建绑定到指定 `BaseCacheService` 子类的 remember 装饰器。\n * 必须传入具体子类,不能传入 `BaseCacheService` 本身。\n *\n * ```typescript\n * export const remember = createRemember(CacheService);\n * ```\n */\nexport function createRemember<C extends CacheServiceCtor>(\n ctor: ConcreteCacheServiceCtor<C>,\n): Remember {\n const remember = (<\n R extends Caching.Types | null = Caching.Types | null,\n P extends (...args: any[]) => Promise<R> = (...args: any[]) => Promise<R>,\n Q extends NonNullable<R> = NonNullable<R>,\n >(\n optsOrDurationMs: number | RememberOptions<R, P, Q>,\n ) => {\n const opts: RememberOptions<R, P, Q> =\n typeof optsOrDurationMs === 'number'\n ? { duration: optsOrDurationMs }\n : optsOrDurationMs;\n const { key: getKey, duration, defaultValue = null } = opts;\n\n return (originalMethod: P, context: ClassMethodDecoratorContext) => {\n return async function (this: object, ...args: Parameters<P>): Promise<any> {\n const cache = await ensureCache(ctor);\n\n const dataKey =\n getKey === undefined\n ? `${\n 'displayName' in this && typeof this.displayName === 'string'\n ? this.displayName\n : this.constructor.name\n }-${String(context.name)}-${JSON.stringify(args)}`\n : typeof getKey === 'string'\n ? getKey\n : getKey.apply(this, args);\n const waitingKey = dataKey + ':$#_waiting_#$';\n\n const value = await traceBlock('Cache.get', () => cache.get<Q>(dataKey));\n if (value !== null) return value;\n\n const win = await cache.setNX(waitingKey, 1, 20_000);\n if (win) {\n const timer = setInterval(() => {\n cache.expire(waitingKey, 20_000);\n }, 5_000);\n try {\n const result = await traceBlock('Cache.exec', async () => {\n return originalMethod.apply(this, args);\n });\n if (result !== null) {\n await traceBlock('Cache.set', async () => {\n await cache.set(dataKey, result!, duration);\n });\n }\n return result === null ? defaultValue : result;\n } finally {\n clearInterval(timer);\n await cache.delete(waitingKey);\n }\n } else {\n return traceBlock('Cache.wait', async () => {\n while (true) {\n const waiting = await cache.exists(waitingKey);\n if (waiting) {\n await sleep(100);\n continue;\n }\n return cache.get<Q>(dataKey, defaultValue);\n }\n });\n }\n };\n };\n }) as Remember;\n\n return remember;\n}\n","import { createHash } from 'node:crypto';\nimport { Service } from '@aomex/common';\nimport { CacheAdapter } from './cache-adapter';\nimport { Caching } from './caching';\nimport { attachRememberScopes, detachRememberScopes } from './remember';\n\nconst CACHE_TTL = {\n SECOND: 1_000,\n MINUTE: 60_000,\n HOUR: 3_600_000,\n DAY: 86_400_000,\n WEEK: 604_800_000,\n /** 按 30 天计 */\n MONTH: 2_592_000_000,\n /** 按 365 天计 */\n YEAR: 31_536_000_000,\n} as const;\n\n/**\n * 缓存领域服务基类:子类实现 `createAdapter`,在业务方法里通过 `this.cache` 访问。\n *\n * ```typescript\n * import { CacheMemoryAdapter } from '@aomex/cache/memory';\n * import { createRemember } from '@aomex/cache';\n *\n * class CacheService extends BaseCacheService {\n * protected createAdapter() {\n * return new CacheMemoryAdapter();\n * }\n * }\n *\n * export const remember = createRemember(CacheService);\n * ```\n */\nexport abstract class BaseCacheService<\n T extends CacheAdapter = CacheAdapter,\n> extends Service {\n private _cache!: Caching<T>;\n\n protected get cache(): Caching<T> {\n return this._cache;\n }\n\n protected abstract createAdapter(): T;\n\n protected override async onInit(): Promise<void> {\n this._cache = new Caching(this.createAdapter());\n try {\n await this._cache.adapter.connect();\n attachRememberScopes(this);\n } catch (e) {\n detachRememberScopes(this);\n throw e;\n }\n }\n\n protected override async onDestroy(): Promise<void> {\n detachRememberScopes(this);\n await this._cache?.adapter.disconnect();\n }\n\n /** 常用过期时间(毫秒):`this.ttl.DAY` */\n protected get ttl() {\n return CACHE_TTL;\n }\n\n /** 用 `:` 拼接缓存 key 片段,如 `key('user', 1)` → `'user:1'` */\n protected key(...keys: Array<string | number>): string {\n return keys.join(':');\n }\n\n /** 对 key 做 MD5,适合过长或不规则片段 */\n protected hash(key: string | number): string {\n return createHash('md5').update(String(key)).digest('hex');\n }\n}\n"],"mappings":";;;;;AAgBA,MAAM,eAAe;AACrB,MAAM,eAAe;AAErB,IAAa,UAAb,MAA4D;CACrC;CAArB,YAAY,SAAqB;EAAZ,KAAA,UAAA;CAAa;;;;CAKlC,MAAM,OAAO,KAA+B;EAC1C,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,UAAU,GAAG;CACnC;CAgBA,MAAM,IAAI,KAAa,cAAmD;EACxE,MAAM,KAAK,QAAQ,QAAQ;EAC3B,MAAM,SAAS,MAAM,KAAK,QAAQ,SAAS,GAAG;EAC9C,OAAO,KAAK,YAAY,QAAQ,YAAY;CAC9C;;;;;;;;;CAUA,MAAM,IAAI,KAAa,OAAsB,YAAuC;EAClF,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,SAAS,KAAK,KAAK,YAAY,KAAK,GAAG,UAAU;CACvE;;;;;;;;;CAUA,MAAM,MAAM,KAAa,OAAsB,YAAuC;EACpF,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,iBAAiB,KAAK,KAAK,YAAY,KAAK,GAAG,UAAU;CAC/E;;;;;;;;;CAUA,MAAM,SAAS,KAAa,GAAG,QAA2C;EACxE,IAAI,CAAC,OAAO,QAAQ,OAAO;EAC3B,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,cAClB,KACA,GAAG,OAAO,KAAK,UAAU,KAAK,YAAY,KAAK,CAAC,CAClD;CACF;;;;CAKA,MAAM,SAAkC,KAAgC;EACtE,MAAM,KAAK,QAAQ,QAAQ;EAC3B,MAAM,SAAS,MAAM,KAAK,QAAQ,cAAc,GAAG;EACnD,OAAO,KAAK,YAAY,MAAM;CAChC;;;;;;;;;;CAWA,MAAM,UAAU,KAA8B;EAC5C,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,cAAc,GAAG;CACvC;;;;CAKA,MAAM,OAAO,KAAa,YAAsC;EAC9D,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,UAAU,KAAK,UAAU;CAC/C;;;;;;;;;;;;;;;CAgBA,MAAM,IAAI,KAA8B;EACtC,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,OAAO,GAAG;CAChC;;;;CAKA,MAAM,UAAU,KAA8B;EAC5C,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,cAAc,GAAG;CACvC;;;;CAKA,MAAM,OAAO,KAA+B;EAC1C,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,YAAY,GAAG;CACrC;;;;CAKA,MAAM,YAA8B;EAClC,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,gBAAgB;CACtC;CAEA,YAAsB,OAAsB;EAC1C,IAAI,iBAAiB,MACnB,QAAQ,KAAK,YAAY,KAAK;EAEhC,OAAO,KAAK,UAAU,QAAQ,GAAG,MAAM,KAAK,kBAAkB,CAAC,CAAC;CAClE;CAEA,kBAA4B,OAAsB;EAChD,IAAI,iBAAiB,KACnB,QAAQ;IAAG,eAAe;IAAQ,eAAe,MAAM,KAAK,MAAM,QAAQ,CAAC;EAAE;OACxE,IAAI,iBAAiB,KAC1B,QAAQ;IAAG,eAAe;IAAQ,eAAe,MAAM,KAAK,MAAM,OAAO,CAAC;EAAE;OACvE,IAAI,OAAO,UAAU,UAC1B,QAAQ;IAAG,eAAe;IAAW,eAAe,MAAM,SAAS;EAAE;OAChE,IAAI,SAAS,OAAO,UAAU,UAAU;GAC7C,IAAI,MAAM,QAAQ,KAAK,GACrB,QAAQ,MAAM,KAAK,MAAM,KAAK,YAAY,CAAC,CAAC;QAE5C,QAAQ,OAAO,YACb,OAAO,QAAQ,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO;IACpC,OAAO,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC;GAChC,CAAC,CACH;EAEJ;EAEA,OAAO;CACT;CAEA,YAAsB,OAAY;EAChC,IAAI,iBAAiB,MACnB,OAAO;IAAG,eAAe;IAAS,eAAe,MAAM,YAAY;EAAE;EAEvE,OAAO;CACT;CAEA,YAAsB,OAAsB,cAAqC;EAC/E,IAAI,UAAU,MACZ,OAAO,iBAAiB,KAAK,IAAI,OAAO;EAG1C,IAAI;GACF,OAAO,KAAK,MAAM,QAAQ,GAAG,MAAM,KAAK,iBAAiB,CAAC,CAAC;EAC7D,QAAQ;GACN,OAAO;EACT;CACF;CAEA,iBAA2B,OAAY;EACrC,IAAI,SAAS,OAAO,UAAU,UAAU;GACtC,MAAM,OAAO,OAAO,KAAK,KAAK;GAC9B,IACE,KAAK,WAAW,KAChB,KAAK,SAAS,YAAY,KAC1B,KAAK,SAAS,YAAY,GAE1B,QAAQ,MAAM,eAAd;IACE,KAAK;KACH,IAAI,MAAM,QAAQ,MAAM,aAAa,GACnC,OAAO,IAAI,IAAI,MAAM,aAAa;KAEpC;IACF,KAAK;KACH,IAAI,MAAM,QAAQ,MAAM,aAAa,GACnC,OAAO,IAAI,IAAI,MAAM,aAAa;KAEpC;IACF,KAAK;KACH,IAAI,OAAO,MAAM,kBAAkB,UACjC,OAAO,IAAI,KAAK,MAAM,aAAa;KAErC;IACF,KAAK,UACH,IAAI,OAAO,MAAM,kBAAkB,UACjC,OAAO,OAAO,MAAM,aAAa;GAGvC;EAEJ;EACA,OAAO;CACT;AACF;;;ACjMA,MAAM,8BAAc,IAAI,QAAqC;AAE7D,SAAS,SAAS,MAAmC;CACnD,MAAM,WAAW,YAAY,IAAI,IAAI;CACrC,IAAI,UAAU,OAAO;CAErB,MAAM,QAAmB;EACvB,OAAO,KAAA;EACP,WAAW;EACX,OAAO,QAAQ,cAAuB;CACxC;CACA,YAAY,IAAI,MAAM,KAAK;CAC3B,OAAO;AACT;AAEA,eAAe,YAAY,MAA0C;CACnE,MAAM,QAAQ,SAAS,IAAI;CAC3B,IAAI,MAAM,WACR,MAAM,IAAI,MAAM,KAAK,EAAE,yBAAyB,CAAC;CAEnD,IAAI,MAAM,OAAO,OAAO,MAAM;CAE9B,MAAM,MAAM,MAAM;CAElB,IAAI,MAAM,aAAa,CAAC,MAAM,OAC5B,MAAM,IAAI,MAAM,KAAK,EAAE,yBAAyB,CAAC;CAEnD,OAAO,MAAM;AACf;;AAGA,SAAgB,qBAAqB,SAAiC;CACpE,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQ,QAAQ;CACtB,MAAM,QAAQ,SAAS,IAAI;CAC3B,MAAM,YAAY;CAClB,MAAM,QAAQ;CACd,MAAM,MAAM,QAAQ,KAAK;AAC3B;;AAGA,SAAgB,qBAAqB,SAAiC;CACpE,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQ,YAAY,IAAI,IAAI;CAClC,IAAI,CAAC,OAAO;CAEZ,IAAI,MAAM,UAAU,KAAA,KAAa,MAAM,UAAU,QAAQ,WAAW;CAEpE,MAAM,YAAY;CAClB,MAAM,QAAQ,KAAA;CACd,MAAM,MAAM,OAAO,IAAI,MAAM,KAAK,EAAE,yBAAyB,CAAC,CAAC;AACjE;;;;;;;;;AAUA,SAAgB,eACd,MACU;CACV,MAAM,aAKJ,qBACG;EAKH,MAAM,EAAE,KAAK,QAAQ,UAAU,eAAe,SAH5C,OAAO,qBAAqB,WACxB,EAAE,UAAU,iBAAiB,IAC7B;EAGN,QAAQ,gBAAmB,YAAyC;GAClE,OAAO,eAA8B,GAAG,MAAmC;IACzE,MAAM,QAAQ,MAAM,YAAY,IAAI;IAEpC,MAAM,UACJ,WAAW,KAAA,IACP,GACE,iBAAiB,QAAQ,OAAO,KAAK,gBAAgB,WACjD,KAAK,cACL,KAAK,YAAY,KACtB,GAAG,OAAO,QAAQ,IAAI,EAAE,GAAG,KAAK,UAAU,IAAI,MAC/C,OAAO,WAAW,WAChB,SACA,OAAO,MAAM,MAAM,IAAI;IAC/B,MAAM,aAAa,UAAU;IAE7B,MAAM,QAAQ,MAAM,WAAW,mBAAmB,MAAM,IAAO,OAAO,CAAC;IACvE,IAAI,UAAU,MAAM,OAAO;IAG3B,IAAI,MADc,MAAM,MAAM,YAAY,GAAG,GAAM,GAC1C;KACP,MAAM,QAAQ,kBAAkB;MAC9B,MAAM,OAAO,YAAY,GAAM;KACjC,GAAG,GAAK;KACR,IAAI;MACF,MAAM,SAAS,MAAM,WAAW,cAAc,YAAY;OACxD,OAAO,eAAe,MAAM,MAAM,IAAI;MACxC,CAAC;MACD,IAAI,WAAW,MACb,MAAM,WAAW,aAAa,YAAY;OACxC,MAAM,MAAM,IAAI,SAAS,QAAS,QAAQ;MAC5C,CAAC;MAEH,OAAO,WAAW,OAAO,eAAe;KAC1C,UAAU;MACR,cAAc,KAAK;MACnB,MAAM,MAAM,OAAO,UAAU;KAC/B;IACF,OACE,OAAO,WAAW,cAAc,YAAY;KAC1C,OAAO,MAAM;MAEX,IAAI,MADkB,MAAM,OAAO,UAAU,GAChC;OACX,MAAM,MAAM,GAAG;OACf;MACF;MACA,OAAO,MAAM,IAAO,SAAS,YAAY;KAC3C;IACF,CAAC;GAEL;EACF;CACF;CAEA,OAAO;AACT;;ACtLA,MAAM,YAAY;CAChB,QAAQ;CACR,QAAQ;CACR,MAAM;CACN,KAAK;CACL,MAAM;;CAEN,OAAO;;CAEP,MAAM;AACR;;;;;;;;;;;;;;;;;AAkBA,IAAsB,mBAAtB,cAEU,QAAQ;CAChB;CAEA,IAAc,QAAoB;EAChC,OAAO,KAAK;CACd;CAIA,MAAyB,SAAwB;EAC/C,KAAK,SAAS,IAAI,QAAQ,KAAK,cAAc,CAAC;EAC9C,IAAI;GACF,MAAM,KAAK,OAAO,QAAQ,QAAQ;GAClC,qBAAqB,IAAI;EAC3B,SAAS,GAAG;GACV,qBAAqB,IAAI;GACzB,MAAM;EACR;CACF;CAEA,MAAyB,YAA2B;EAClD,qBAAqB,IAAI;EACzB,MAAM,KAAK,QAAQ,QAAQ,WAAW;CACxC;;CAGA,IAAc,MAAM;EAClB,OAAO;CACT;;CAGA,IAAc,GAAG,MAAsC;EACrD,OAAO,KAAK,KAAK,GAAG;CACtB;;CAGA,KAAe,KAA8B;EAC3C,OAAO,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK;CAC3D;AACF"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/cache-key.ts","../src/caching.ts","../src/remember.ts","../src/base-cache-service.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\n/**\n * 缓存键。通常由 `BaseCacheService#key()` / `#keyHash()` 创建。\n *\n * ```typescript\n * this.key('user', 1); // user:1\n * this.key('user').key(1); // user:1\n * this.keyHash('user', 1); // md5('user:1')\n * this.key('user').keyHash(1); // user:md5('1')\n * this.key('user', 1).toHash(); // md5('user:1')\n * await this.cache.get(this.key('user', 1));\n * ```\n */\nexport class CacheKey {\n protected readonly value: string;\n\n constructor(value: string = '') {\n this.value = value;\n }\n\n /** 用 `:` 拼接片段(保留已有前缀),如 `key('user').key(1)` → `'user:1'` */\n key(...keys: Array<string | number>): CacheKey {\n return new CacheKey((this.value === '' ? keys : [this.value, ...keys]).join(':'));\n }\n\n /** 仅对本次参数拼接后 MD5,再接到已有前缀后 */\n keyHash(...keys: Array<string | number>): CacheKey {\n return this.key(this.md5(keys.join(':')));\n }\n\n /** 对当前完整键做 MD5 */\n toHash(): CacheKey {\n return new CacheKey(this.md5(this.value));\n }\n\n protected toString(): string {\n return this.value;\n }\n\n protected md5(key: string | number): string {\n return createHash('md5').update(String(key)).digest('hex');\n }\n}\n","import { CacheAdapter } from './cache-adapter';\nimport { CacheKey } from './cache-key';\n\nexport namespace Caching {\n export type Types =\n | string\n | number\n | unknown[]\n | readonly unknown[]\n | { [K: string]: any }\n | boolean\n | Map<any, any>\n | Set<any>\n | bigint\n | Date;\n\n /** 缓存键:字符串或 `CacheKey` */\n export type Key = string | CacheKey;\n}\n\nconst CACHING_TYPE = '_$caching_type$_';\nconst CACHING_DATA = '_$caching_data$_';\n\nexport class Caching<T extends CacheAdapter = CacheAdapter> {\n constructor(readonly adapter: T) {}\n\n /**\n * 查看缓存是否存在\n */\n async exists(key: Caching.Key): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.existsKey(this.resolveKey(key));\n }\n\n /**\n *\n * 获取缓存。如果未找到缓存并且未提供默认值,则返回`null`\n * ```typescript\n * await cache.get('key'); // null\n * await cache.get('key', 'my-value'); // my-value\n * ```\n */\n async get<T>(key: Caching.Key, defaultValue: T): Promise<T>;\n async get<T extends Caching.Types>(\n key: Caching.Key,\n defaultValue: T | null | undefined,\n ): Promise<T | null>;\n async get<T extends Caching.Types>(key: Caching.Key): Promise<T | null>;\n async get(key: Caching.Key, defaultValue?: Caching.Types | null): Promise<any> {\n await this.adapter.connect();\n const result = await this.adapter.getValue(this.resolveKey(key));\n return this.decodeValue(result, defaultValue);\n }\n\n /**\n * 设置缓存。可以指定过期时间(毫秒)\n *\n * ```typescript\n * await cache.set('key', 'value');\n * await cache.set('key', 'value', 3600);\n * ```\n */\n async set(\n key: Caching.Key,\n value: Caching.Types,\n durationMs?: number,\n ): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.setValue(\n this.resolveKey(key),\n this.encodeValue(value),\n durationMs,\n );\n }\n\n /**\n * 设置缓存。如果缓存已经存在,则设置失败,返回`false`\n *\n * ```typescript\n * await cache.setNX('foo', 'bar'); // true\n * await cache.setNX('foo', 'baz'); // false\n * ```\n */\n async setNX(\n key: Caching.Key,\n value: Caching.Types,\n durationMs?: number,\n ): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.setNotExistValue(\n this.resolveKey(key),\n this.encodeValue(value),\n durationMs,\n );\n }\n\n /**\n * 将一个或多个值按顺序插入到列表头部。当 key 存在但不是列表类型时,返回一个错误。\n *\n * ```typescript\n * await cache.leftPush('foo', 'a'); // ['a']\n * await cache.leftPush('foo', 'b', 'c'); // ['b', 'c', 'a']\n * ```\n */\n async leftPush(key: Caching.Key, ...values: Caching.Types[]): Promise<boolean> {\n if (!values.length) return false;\n await this.adapter.connect();\n return this.adapter.leftPushValue(\n this.resolveKey(key),\n ...values.map((value) => this.encodeValue(value)),\n );\n }\n\n /**\n * 移除列表的最后一个元素,返回值为被移除的元素\n */\n async rightPop<T extends Caching.Types>(key: Caching.Key): Promise<T | null> {\n await this.adapter.connect();\n const result = await this.adapter.rightPopValue(this.resolveKey(key));\n return this.decodeValue(result);\n }\n\n /**\n * 将key中储存的数字值增一。如果key不存在,那么key的值会先被初始化为0,然后再执行操作。如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误。\n *\n * ```typescript\n * await cache.increment('foo'); // 1\n * await cache.increment('foo'); // 2\n * await cache.increment('foo'); // 3\n * ```\n */\n async increment(key: Caching.Key): Promise<number> {\n await this.adapter.connect();\n return this.adapter.increaseValue(this.resolveKey(key));\n }\n\n /**\n * 重新设置缓存时间。如果key不存在,则返回`false`\n */\n async expire(key: Caching.Key, durationMs: number): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.expireKey(this.resolveKey(key), durationMs);\n }\n\n /**\n * 检测缓存的剩余生存时间(Time to live)\n * - 不存在则返回`-2`\n * - 未设置过期时间则返回`-1`\n * - 已设置过期时间则返回剩余时间,单位**毫秒**\n *\n * ```typescript\n * await cache.ttl('foo'); // -2\n * await cache.set('foo', 'bar');\n * await cache.ttl('foo'); // -1\n * await cache.expire('foo', 60000);\n * await cache.ttl('foo'); // 59000\n * ```\n */\n async ttl(key: Caching.Key): Promise<number> {\n await this.adapter.connect();\n return this.adapter.ttlKey(this.resolveKey(key));\n }\n\n /**\n * 将key中储存的数字值减一。如果key不存在,那么key的值会先被初始化为0,然后再执行操作。如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误\n */\n async decrement(key: Caching.Key): Promise<number> {\n await this.adapter.connect();\n return this.adapter.decreaseValue(this.resolveKey(key));\n }\n\n /**\n * 删除指定缓存\n */\n async delete(key: Caching.Key): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.deleteValue(this.resolveKey(key));\n }\n\n /**\n * 删除所有缓存\n */\n async deleteAll(): Promise<boolean> {\n await this.adapter.connect();\n return this.adapter.deleteAllValues();\n }\n\n protected resolveKey(key: Caching.Key): string {\n return typeof key === 'string' ? key : key['value'];\n }\n\n protected encodeValue(value: Caching.Types) {\n if (value instanceof Date) {\n value = this.convertDate(value);\n }\n return JSON.stringify(value, (_, v) => this.stringifyReplacer(v));\n }\n\n protected stringifyReplacer(value: Caching.Types) {\n if (value instanceof Map) {\n value = { [CACHING_TYPE]: 'Map', [CACHING_DATA]: Array.from(value.entries()) };\n } else if (value instanceof Set) {\n value = { [CACHING_TYPE]: 'Set', [CACHING_DATA]: Array.from(value.values()) };\n } else if (typeof value === 'bigint') {\n value = { [CACHING_TYPE]: 'BigInt', [CACHING_DATA]: value.toString() };\n } else if (value && typeof value === 'object') {\n if (Array.isArray(value)) {\n value = value.map((v) => this.convertDate(v));\n } else {\n value = Object.fromEntries(\n Object.entries(value).map(([k, v]) => {\n return [k, this.convertDate(v)];\n }),\n );\n }\n }\n\n return value;\n }\n\n protected convertDate(value: any) {\n if (value instanceof Date) {\n return { [CACHING_TYPE]: 'Date', [CACHING_DATA]: value.toISOString() };\n }\n return value;\n }\n\n protected decodeValue(value: string | null, defaultValue?: Caching.Types | null) {\n if (value === null) {\n return defaultValue === void 0 ? null : defaultValue;\n }\n\n try {\n return JSON.parse(value, (_, v) => this.jsonParseReviver(v));\n } catch {\n return null;\n }\n }\n\n protected jsonParseReviver(value: any) {\n if (value && typeof value === 'object') {\n const keys = Object.keys(value);\n if (\n keys.length === 2 &&\n keys.includes(CACHING_TYPE) &&\n keys.includes(CACHING_DATA)\n ) {\n switch (value[CACHING_TYPE]) {\n case 'Map':\n if (Array.isArray(value[CACHING_DATA])) {\n return new Map(value[CACHING_DATA]);\n }\n break;\n case 'Set':\n if (Array.isArray(value[CACHING_DATA])) {\n return new Set(value[CACHING_DATA]);\n }\n break;\n case 'Date':\n if (typeof value[CACHING_DATA] === 'string') {\n return new Date(value[CACHING_DATA]);\n }\n break;\n case 'BigInt':\n if (typeof value[CACHING_DATA] === 'string') {\n return BigInt(value[CACHING_DATA]);\n }\n break;\n }\n }\n }\n return value;\n }\n}\n","import { traceBlock } from '@aomex/async-trace';\nimport { sleep } from '@aomex/common';\nimport type { BaseCacheService } from './base-cache-service';\nimport type { Caching } from './caching';\nimport { i18n } from './i18n';\n\nexport type RememberOptions<\n R extends Caching.Types | null = Caching.Types | null,\n P extends (...args: any[]) => Promise<R> = (...args: any[]) => Promise<R>,\n Q extends NonNullable<R> = NonNullable<R>,\n> = {\n key?: string | ((this: any, ...args: Parameters<P>) => string);\n duration: number;\n /**\n * 当数据源返回 null 或者 undefined 时,则返回默认值\n */\n defaultValue?: Q;\n};\n\n/**\n * 可调用的方法装饰器,由 `createRemember(CacheService)` 创建。\n * 绑定到指定缓存服务类;实例 `onInit` 完成前调用会等待就绪,`onDestroy` 后调用会抛错。\n */\nexport interface Remember {\n (\n durationMs: number,\n ): (\n originalMethod: (...args: any[]) => Promise<any>,\n context: ClassMethodDecoratorContext,\n ) => (...args: any[]) => Promise<any>;\n <\n R extends Caching.Types | null,\n P extends (...args: any[]) => Promise<R>,\n Q extends NonNullable<R>,\n >(\n opts: RememberOptions<R, P, Q>,\n ): (originalMethod: P, context: ClassMethodDecoratorContext) => P;\n}\n\n/** 任意 `BaseCacheService` 构造函数(含基类,供内部挂载使用) */\nexport type CacheServiceCtor = abstract new (...args: any[]) => BaseCacheService;\n\n/**\n * 具体缓存服务子类构造函数。传入 `BaseCacheService` 本身时类型为 `never`。\n */\nexport type ConcreteCacheServiceCtor<C extends CacheServiceCtor = CacheServiceCtor> =\n BaseCacheService extends InstanceType<C> ? never : C;\n\ntype CtorState = {\n cache: Caching | undefined;\n /** 已经 onDestroy,且尚未再次 onInit */\n destroyed: boolean;\n ready: PromiseWithResolvers<Caching>;\n};\n\n/** 每个服务类一份:当前 `Caching` + 未就绪时的等待 Promise */\nconst stateByCtor = new WeakMap<CacheServiceCtor, CtorState>();\n\nfunction getState(ctor: CacheServiceCtor): CtorState {\n const existing = stateByCtor.get(ctor);\n if (existing) return existing;\n\n const state: CtorState = {\n cache: undefined,\n destroyed: false,\n ready: Promise.withResolvers<Caching>(),\n };\n stateByCtor.set(ctor, state);\n return state;\n}\n\nasync function ensureCache(ctor: CacheServiceCtor): Promise<Caching> {\n const state = getState(ctor);\n if (state.destroyed) {\n throw new Error(i18n.t('cache_service_destroyed'));\n }\n if (state.cache) return state.cache;\n\n await state.ready.promise;\n // attach resolve 与 await 恢复之间可能已经 onDestroy\n if (state.destroyed || !state.cache) {\n throw new Error(i18n.t('cache_service_destroyed'));\n }\n return state.cache;\n}\n\n/** 供 `BaseCacheService.onInit` 挂载;包外请勿直接调用 */\nexport function attachRememberScopes(service: BaseCacheService): void {\n const ctor = service.constructor as CacheServiceCtor;\n const cache = service['_cache'];\n const state = getState(ctor);\n state.destroyed = false;\n state.cache = cache;\n state.ready.resolve(cache);\n}\n\n/** 供 `BaseCacheService.onDestroy` / `onInit` 失败时卸载;包外请勿直接调用 */\nexport function detachRememberScopes(service: BaseCacheService): void {\n const ctor = service.constructor as CacheServiceCtor;\n const state = stateByCtor.get(ctor);\n if (!state) return;\n // 已有其它实例挂载时,非当前挂载者不处理;尚未 attach(如 connect 失败)时仍要 reject 等待者\n if (state.cache !== undefined && state.cache !== service['_cache']) return;\n // 先标 destroyed,避免并发 ensureCache 在清 cache 后误走已 settle 的 ready\n state.destroyed = true;\n state.cache = undefined;\n state.ready.reject(new Error(i18n.t('cache_service_destroyed')));\n}\n\n/**\n * 创建绑定到指定 `BaseCacheService` 子类的 remember 装饰器。\n * 必须传入具体子类,不能传入 `BaseCacheService` 本身。\n *\n * ```typescript\n * export const remember = createRemember(CacheService);\n * ```\n */\nexport function createRemember<C extends CacheServiceCtor>(\n ctor: ConcreteCacheServiceCtor<C>,\n): Remember {\n const remember = (<\n R extends Caching.Types | null = Caching.Types | null,\n P extends (...args: any[]) => Promise<R> = (...args: any[]) => Promise<R>,\n Q extends NonNullable<R> = NonNullable<R>,\n >(\n optsOrDurationMs: number | RememberOptions<R, P, Q>,\n ) => {\n const opts: RememberOptions<R, P, Q> =\n typeof optsOrDurationMs === 'number'\n ? { duration: optsOrDurationMs }\n : optsOrDurationMs;\n const { key: getKey, duration, defaultValue = null } = opts;\n\n return (originalMethod: P, context: ClassMethodDecoratorContext) => {\n return async function (this: object, ...args: Parameters<P>): Promise<any> {\n const cache = await ensureCache(ctor);\n\n const dataKey =\n getKey === undefined\n ? `${\n 'displayName' in this && typeof this.displayName === 'string'\n ? this.displayName\n : this.constructor.name\n }-${String(context.name)}-${JSON.stringify(args)}`\n : typeof getKey === 'string'\n ? getKey\n : getKey.apply(this, args);\n const waitingKey = dataKey + ':$#_waiting_#$';\n\n const value = await traceBlock('Cache.get', () => cache.get<Q>(dataKey));\n if (value !== null) return value;\n\n const win = await cache.setNX(waitingKey, 1, 20_000);\n if (win) {\n const timer = setInterval(() => {\n cache.expire(waitingKey, 20_000);\n }, 5_000);\n try {\n const result = await traceBlock('Cache.exec', async () => {\n return originalMethod.apply(this, args);\n });\n if (result !== null) {\n await traceBlock('Cache.set', async () => {\n await cache.set(dataKey, result!, duration);\n });\n }\n return result === null ? defaultValue : result;\n } finally {\n clearInterval(timer);\n await cache.delete(waitingKey);\n }\n } else {\n return traceBlock('Cache.wait', async () => {\n while (true) {\n const waiting = await cache.exists(waitingKey);\n if (waiting) {\n await sleep(100);\n continue;\n }\n return cache.get<Q>(dataKey, defaultValue);\n }\n });\n }\n };\n };\n }) as Remember;\n\n return remember;\n}\n","import { Service } from '@aomex/common';\nimport { CacheAdapter } from './cache-adapter';\nimport { CacheKey } from './cache-key';\nimport { Caching } from './caching';\nimport { attachRememberScopes, detachRememberScopes } from './remember';\n\nconst CACHE_TTL = {\n SECOND: 1_000,\n MINUTE: 60_000,\n HOUR: 3_600_000,\n DAY: 86_400_000,\n WEEK: 604_800_000,\n /** 按 30 天计 */\n MONTH: 2_592_000_000,\n /** 按 365 天计 */\n YEAR: 31_536_000_000,\n} as const;\n\n/**\n * 缓存领域服务基类:子类实现 `createAdapter`,在业务方法里通过 `this.cache` 访问。\n *\n * ```typescript\n * import { CacheMemoryAdapter } from '@aomex/cache/memory';\n * import { createRemember } from '@aomex/cache';\n *\n * class CacheService extends BaseCacheService {\n * protected createAdapter() {\n * return new CacheMemoryAdapter();\n * }\n * }\n *\n * export const remember = createRemember(CacheService);\n * ```\n */\nexport abstract class BaseCacheService<\n T extends CacheAdapter = CacheAdapter,\n> extends Service {\n private _cache!: Caching<T>;\n\n protected get cache(): Caching<T> {\n return this._cache;\n }\n\n protected abstract createAdapter(): T;\n\n protected override async onInit(): Promise<void> {\n this._cache = new Caching(this.createAdapter());\n try {\n await this._cache.adapter.connect();\n attachRememberScopes(this);\n } catch (e) {\n detachRememberScopes(this);\n throw e;\n }\n }\n\n protected override async onDestroy(): Promise<void> {\n detachRememberScopes(this);\n await this._cache?.adapter.disconnect();\n }\n\n /** 常用过期时间(毫秒):`this.ttl.DAY` */\n protected get ttl() {\n return CACHE_TTL;\n }\n\n /**\n * 用 `:` 拼接片段,得到可读的缓存键(可继续链式调用)。\n *\n * ```typescript\n * this.key('user', 1); // user:1\n * this.key('user').key(1); // 同上\n * this.key('user').keyHash(1); // user:<md5('1')> 前缀保留,只哈希新片段\n * this.key('user', 1).toHash(); // <md5('user:1')> 整键再哈希\n * await this.cache.get(this.key('user', 1));\n * ```\n */\n protected key(...keys: Array<string | number>): CacheKey {\n return keys.length === 0 ? new CacheKey() : new CacheKey().key(...keys);\n }\n\n /**\n * 将片段用 `:` 拼接后整体 MD5(无可读前缀)。\n * 等价于 `this.key(...keys).toHash()`。\n *\n * ```typescript\n * this.keyHash('user', 1); // <md5('user:1')>\n * this.key('user').keyHash(1); // 不是这个:那是「前缀 + 哈希段」\n * ```\n */\n protected keyHash(...keys: Array<string | number>): CacheKey {\n return new CacheKey().keyHash(...keys);\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAcA,IAAa,WAAb,MAAa,SAAS;CACpB;CAEA,YAAY,QAAgB,IAAI;EAC9B,KAAK,QAAQ;CACf;;CAGA,IAAI,GAAG,MAAwC;EAC7C,OAAO,IAAI,UAAU,KAAK,UAAU,KAAK,OAAO,CAAC,KAAK,OAAO,GAAG,IAAI,EAAA,CAAG,KAAK,GAAG,CAAC;CAClF;;CAGA,QAAQ,GAAG,MAAwC;EACjD,OAAO,KAAK,IAAI,KAAK,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC;CAC1C;;CAGA,SAAmB;EACjB,OAAO,IAAI,SAAS,KAAK,IAAI,KAAK,KAAK,CAAC;CAC1C;CAEA,WAA6B;EAC3B,OAAO,KAAK;CACd;CAEA,IAAc,KAA8B;EAC1C,OAAO,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK;CAC3D;AACF;;ACvBA,MAAM,eAAe;AACrB,MAAM,eAAe;AAErB,IAAa,UAAb,MAA4D;CACrC;CAArB,YAAY,SAAqB;EAAZ,KAAA,UAAA;CAAa;;;;CAKlC,MAAM,OAAO,KAAoC;EAC/C,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,UAAU,KAAK,WAAW,GAAG,CAAC;CACpD;CAgBA,MAAM,IAAI,KAAkB,cAAmD;EAC7E,MAAM,KAAK,QAAQ,QAAQ;EAC3B,MAAM,SAAS,MAAM,KAAK,QAAQ,SAAS,KAAK,WAAW,GAAG,CAAC;EAC/D,OAAO,KAAK,YAAY,QAAQ,YAAY;CAC9C;;;;;;;;;CAUA,MAAM,IACJ,KACA,OACA,YACkB;EAClB,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,SAClB,KAAK,WAAW,GAAG,GACnB,KAAK,YAAY,KAAK,GACtB,UACF;CACF;;;;;;;;;CAUA,MAAM,MACJ,KACA,OACA,YACkB;EAClB,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,iBAClB,KAAK,WAAW,GAAG,GACnB,KAAK,YAAY,KAAK,GACtB,UACF;CACF;;;;;;;;;CAUA,MAAM,SAAS,KAAkB,GAAG,QAA2C;EAC7E,IAAI,CAAC,OAAO,QAAQ,OAAO;EAC3B,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,cAClB,KAAK,WAAW,GAAG,GACnB,GAAG,OAAO,KAAK,UAAU,KAAK,YAAY,KAAK,CAAC,CAClD;CACF;;;;CAKA,MAAM,SAAkC,KAAqC;EAC3E,MAAM,KAAK,QAAQ,QAAQ;EAC3B,MAAM,SAAS,MAAM,KAAK,QAAQ,cAAc,KAAK,WAAW,GAAG,CAAC;EACpE,OAAO,KAAK,YAAY,MAAM;CAChC;;;;;;;;;;CAWA,MAAM,UAAU,KAAmC;EACjD,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,cAAc,KAAK,WAAW,GAAG,CAAC;CACxD;;;;CAKA,MAAM,OAAO,KAAkB,YAAsC;EACnE,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,UAAU,KAAK,WAAW,GAAG,GAAG,UAAU;CAChE;;;;;;;;;;;;;;;CAgBA,MAAM,IAAI,KAAmC;EAC3C,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,OAAO,KAAK,WAAW,GAAG,CAAC;CACjD;;;;CAKA,MAAM,UAAU,KAAmC;EACjD,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,cAAc,KAAK,WAAW,GAAG,CAAC;CACxD;;;;CAKA,MAAM,OAAO,KAAoC;EAC/C,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,YAAY,KAAK,WAAW,GAAG,CAAC;CACtD;;;;CAKA,MAAM,YAA8B;EAClC,MAAM,KAAK,QAAQ,QAAQ;EAC3B,OAAO,KAAK,QAAQ,gBAAgB;CACtC;CAEA,WAAqB,KAA0B;EAC7C,OAAO,OAAO,QAAQ,WAAW,MAAM,IAAI;CAC7C;CAEA,YAAsB,OAAsB;EAC1C,IAAI,iBAAiB,MACnB,QAAQ,KAAK,YAAY,KAAK;EAEhC,OAAO,KAAK,UAAU,QAAQ,GAAG,MAAM,KAAK,kBAAkB,CAAC,CAAC;CAClE;CAEA,kBAA4B,OAAsB;EAChD,IAAI,iBAAiB,KACnB,QAAQ;IAAG,eAAe;IAAQ,eAAe,MAAM,KAAK,MAAM,QAAQ,CAAC;EAAE;OACxE,IAAI,iBAAiB,KAC1B,QAAQ;IAAG,eAAe;IAAQ,eAAe,MAAM,KAAK,MAAM,OAAO,CAAC;EAAE;OACvE,IAAI,OAAO,UAAU,UAC1B,QAAQ;IAAG,eAAe;IAAW,eAAe,MAAM,SAAS;EAAE;OAChE,IAAI,SAAS,OAAO,UAAU,UAAU;GAC7C,IAAI,MAAM,QAAQ,KAAK,GACrB,QAAQ,MAAM,KAAK,MAAM,KAAK,YAAY,CAAC,CAAC;QAE5C,QAAQ,OAAO,YACb,OAAO,QAAQ,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO;IACpC,OAAO,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC;GAChC,CAAC,CACH;EAEJ;EAEA,OAAO;CACT;CAEA,YAAsB,OAAY;EAChC,IAAI,iBAAiB,MACnB,OAAO;IAAG,eAAe;IAAS,eAAe,MAAM,YAAY;EAAE;EAEvE,OAAO;CACT;CAEA,YAAsB,OAAsB,cAAqC;EAC/E,IAAI,UAAU,MACZ,OAAO,iBAAiB,KAAK,IAAI,OAAO;EAG1C,IAAI;GACF,OAAO,KAAK,MAAM,QAAQ,GAAG,MAAM,KAAK,iBAAiB,CAAC,CAAC;EAC7D,QAAQ;GACN,OAAO;EACT;CACF;CAEA,iBAA2B,OAAY;EACrC,IAAI,SAAS,OAAO,UAAU,UAAU;GACtC,MAAM,OAAO,OAAO,KAAK,KAAK;GAC9B,IACE,KAAK,WAAW,KAChB,KAAK,SAAS,YAAY,KAC1B,KAAK,SAAS,YAAY,GAE1B,QAAQ,MAAM,eAAd;IACE,KAAK;KACH,IAAI,MAAM,QAAQ,MAAM,aAAa,GACnC,OAAO,IAAI,IAAI,MAAM,aAAa;KAEpC;IACF,KAAK;KACH,IAAI,MAAM,QAAQ,MAAM,aAAa,GACnC,OAAO,IAAI,IAAI,MAAM,aAAa;KAEpC;IACF,KAAK;KACH,IAAI,OAAO,MAAM,kBAAkB,UACjC,OAAO,IAAI,KAAK,MAAM,aAAa;KAErC;IACF,KAAK,UACH,IAAI,OAAO,MAAM,kBAAkB,UACjC,OAAO,OAAO,MAAM,aAAa;GAGvC;EAEJ;EACA,OAAO;CACT;AACF;;;ACzNA,MAAM,8BAAc,IAAI,QAAqC;AAE7D,SAAS,SAAS,MAAmC;CACnD,MAAM,WAAW,YAAY,IAAI,IAAI;CACrC,IAAI,UAAU,OAAO;CAErB,MAAM,QAAmB;EACvB,OAAO,KAAA;EACP,WAAW;EACX,OAAO,QAAQ,cAAuB;CACxC;CACA,YAAY,IAAI,MAAM,KAAK;CAC3B,OAAO;AACT;AAEA,eAAe,YAAY,MAA0C;CACnE,MAAM,QAAQ,SAAS,IAAI;CAC3B,IAAI,MAAM,WACR,MAAM,IAAI,MAAM,KAAK,EAAE,yBAAyB,CAAC;CAEnD,IAAI,MAAM,OAAO,OAAO,MAAM;CAE9B,MAAM,MAAM,MAAM;CAElB,IAAI,MAAM,aAAa,CAAC,MAAM,OAC5B,MAAM,IAAI,MAAM,KAAK,EAAE,yBAAyB,CAAC;CAEnD,OAAO,MAAM;AACf;;AAGA,SAAgB,qBAAqB,SAAiC;CACpE,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQ,QAAQ;CACtB,MAAM,QAAQ,SAAS,IAAI;CAC3B,MAAM,YAAY;CAClB,MAAM,QAAQ;CACd,MAAM,MAAM,QAAQ,KAAK;AAC3B;;AAGA,SAAgB,qBAAqB,SAAiC;CACpE,MAAM,OAAO,QAAQ;CACrB,MAAM,QAAQ,YAAY,IAAI,IAAI;CAClC,IAAI,CAAC,OAAO;CAEZ,IAAI,MAAM,UAAU,KAAA,KAAa,MAAM,UAAU,QAAQ,WAAW;CAEpE,MAAM,YAAY;CAClB,MAAM,QAAQ,KAAA;CACd,MAAM,MAAM,OAAO,IAAI,MAAM,KAAK,EAAE,yBAAyB,CAAC,CAAC;AACjE;;;;;;;;;AAUA,SAAgB,eACd,MACU;CACV,MAAM,aAKJ,qBACG;EAKH,MAAM,EAAE,KAAK,QAAQ,UAAU,eAAe,SAH5C,OAAO,qBAAqB,WACxB,EAAE,UAAU,iBAAiB,IAC7B;EAGN,QAAQ,gBAAmB,YAAyC;GAClE,OAAO,eAA8B,GAAG,MAAmC;IACzE,MAAM,QAAQ,MAAM,YAAY,IAAI;IAEpC,MAAM,UACJ,WAAW,KAAA,IACP,GACE,iBAAiB,QAAQ,OAAO,KAAK,gBAAgB,WACjD,KAAK,cACL,KAAK,YAAY,KACtB,GAAG,OAAO,QAAQ,IAAI,EAAE,GAAG,KAAK,UAAU,IAAI,MAC/C,OAAO,WAAW,WAChB,SACA,OAAO,MAAM,MAAM,IAAI;IAC/B,MAAM,aAAa,UAAU;IAE7B,MAAM,QAAQ,MAAM,WAAW,mBAAmB,MAAM,IAAO,OAAO,CAAC;IACvE,IAAI,UAAU,MAAM,OAAO;IAG3B,IAAI,MADc,MAAM,MAAM,YAAY,GAAG,GAAM,GAC1C;KACP,MAAM,QAAQ,kBAAkB;MAC9B,MAAM,OAAO,YAAY,GAAM;KACjC,GAAG,GAAK;KACR,IAAI;MACF,MAAM,SAAS,MAAM,WAAW,cAAc,YAAY;OACxD,OAAO,eAAe,MAAM,MAAM,IAAI;MACxC,CAAC;MACD,IAAI,WAAW,MACb,MAAM,WAAW,aAAa,YAAY;OACxC,MAAM,MAAM,IAAI,SAAS,QAAS,QAAQ;MAC5C,CAAC;MAEH,OAAO,WAAW,OAAO,eAAe;KAC1C,UAAU;MACR,cAAc,KAAK;MACnB,MAAM,MAAM,OAAO,UAAU;KAC/B;IACF,OACE,OAAO,WAAW,cAAc,YAAY;KAC1C,OAAO,MAAM;MAEX,IAAI,MADkB,MAAM,OAAO,UAAU,GAChC;OACX,MAAM,MAAM,GAAG;OACf;MACF;MACA,OAAO,MAAM,IAAO,SAAS,YAAY;KAC3C;IACF,CAAC;GAEL;EACF;CACF;CAEA,OAAO;AACT;;ACtLA,MAAM,YAAY;CAChB,QAAQ;CACR,QAAQ;CACR,MAAM;CACN,KAAK;CACL,MAAM;;CAEN,OAAO;;CAEP,MAAM;AACR;;;;;;;;;;;;;;;;;AAkBA,IAAsB,mBAAtB,cAEU,QAAQ;CAChB;CAEA,IAAc,QAAoB;EAChC,OAAO,KAAK;CACd;CAIA,MAAyB,SAAwB;EAC/C,KAAK,SAAS,IAAI,QAAQ,KAAK,cAAc,CAAC;EAC9C,IAAI;GACF,MAAM,KAAK,OAAO,QAAQ,QAAQ;GAClC,qBAAqB,IAAI;EAC3B,SAAS,GAAG;GACV,qBAAqB,IAAI;GACzB,MAAM;EACR;CACF;CAEA,MAAyB,YAA2B;EAClD,qBAAqB,IAAI;EACzB,MAAM,KAAK,QAAQ,QAAQ,WAAW;CACxC;;CAGA,IAAc,MAAM;EAClB,OAAO;CACT;;;;;;;;;;;;CAaA,IAAc,GAAG,MAAwC;EACvD,OAAO,KAAK,WAAW,IAAI,IAAI,SAAS,IAAI,IAAI,SAAS,CAAC,CAAC,IAAI,GAAG,IAAI;CACxE;;;;;;;;;;CAWA,QAAkB,GAAG,MAAwC;EAC3D,OAAO,IAAI,SAAS,CAAC,CAAC,QAAQ,GAAG,IAAI;CACvC;AACF"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aomex/cache",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "4.0.0",
|
|
4
4
|
"description": "缓存基础类",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -39,10 +39,10 @@
|
|
|
39
39
|
"@aomex/common": "^4.0.0"
|
|
40
40
|
},
|
|
41
41
|
"dependencies": {
|
|
42
|
-
"@aomex/async-trace": "
|
|
42
|
+
"@aomex/async-trace": "4.0.0"
|
|
43
43
|
},
|
|
44
44
|
"devDependencies": {
|
|
45
|
-
"@aomex/common": "
|
|
45
|
+
"@aomex/common": "4.0.0"
|
|
46
46
|
},
|
|
47
47
|
"scripts": {}
|
|
48
48
|
}
|