@aomex/cache 3.30.8-alpha.62.sha-92b25bb → 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 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/README.md ADDED
@@ -0,0 +1,3 @@
1
+ # @aomex/cache
2
+
3
+ 文档:https://aomex.js.org
@@ -1,5 +1,4 @@
1
- import { t as CacheAdapter } from "../cache-adapter-4n2JTK4Y.js";
2
- import { t as i18n } from "../i18n-BKvtLTPF.js";
1
+ import { n as CacheAdapter, t as i18n } from "../i18n-OXOpRIod.js";
3
2
  import { mkdirSync } from "node:fs";
4
3
  import { dirname, resolve } from "node:path";
5
4
  import { DatabaseSync } from "node:sqlite";
@@ -1 +1 @@
1
- {"version":3,"file":"cache-file-adapter.js","names":[],"sources":["../../src/adapters/cache-file-adapter.ts"],"sourcesContent":["import { mkdirSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { DatabaseSync, type StatementSync } from 'node:sqlite';\nimport { CacheAdapter } from '../cache-adapter';\nimport { i18n } from '../i18n';\n\nexport interface CacheFileAdapterOptions {\n /**\n * SQLite 数据库路径。传入 `':memory:'` 使用内存库。\n */\n filename: string;\n /**\n * 获取写锁的最长等待时间(毫秒),对应 `node:sqlite` 的 `timeout`。\n * @default 5000\n */\n timeout?: number;\n}\n\ntype CacheKind = 'string' | 'list';\n\ntype CacheRow = {\n key: string;\n value: string;\n kind: CacheKind;\n expires: number | null;\n};\n\ntype Statements = {\n get: StatementSync;\n upsert: StatementSync;\n /** 只改 value/kind,保留 TTL(对齐 Redis 对已有 key 的就地更新) */\n updateValue: StatementSync;\n delete: StatementSync;\n deleteAll: StatementSync;\n expire: StatementSync;\n /** 对齐 Redis INCR/DECR:只改 value,保留 TTL */\n incr: StatementSync;\n};\n\n/**\n * 基于 `node:sqlite` 的文件缓存适配器。\n *\n * key 只作为表主键存储,不拼进文件系统路径。\n * NX / incr / list 等读改写使用 `BEGIN IMMEDIATE`,多进程共库时保持原子语义。\n */\nexport class CacheFileAdapter extends CacheAdapter {\n public readonly filename: string;\n protected readonly timeout: number;\n protected db?: DatabaseSync;\n protected stmts?: Statements;\n\n constructor(options: CacheFileAdapterOptions) {\n super();\n this.filename =\n options.filename === ':memory:' ? options.filename : resolve(options.filename);\n this.timeout = options.timeout ?? 5_000;\n }\n\n override async connect(): Promise<void> {\n this.ensureConnected();\n }\n\n override async disconnect(): Promise<void> {\n const { db } = this;\n if (!db) return;\n if (db.isOpen) db.close();\n this.db = undefined;\n this.stmts = undefined;\n }\n\n override async existsKey(key: string): Promise<boolean> {\n return this.getRow(key, 'any') !== null;\n }\n\n override async getValue(key: string): Promise<string | null> {\n return this.getRow(key, 'string')?.value ?? null;\n }\n\n override async setValue(\n key: string,\n value: string,\n durationMS?: number,\n ): Promise<boolean> {\n this.write(key, value, 'string', durationMS);\n return true;\n }\n\n override async setNotExistValue(\n key: string,\n value: string,\n durationMS?: number,\n ): Promise<boolean> {\n return this.withImmediateTransaction(() => {\n if (this.getRow(key, 'any')) return false;\n this.write(key, value, 'string', durationMS);\n return true;\n });\n }\n\n override async deleteValue(key: string): Promise<boolean> {\n this.ensureConnected();\n this.stmts!.delete.run(key);\n return true;\n }\n\n override async deleteAllValues(): Promise<boolean> {\n this.ensureConnected();\n this.stmts!.deleteAll.run();\n return true;\n }\n\n override async increaseValue(key: string): Promise<number> {\n return this.changeInteger(key, 1);\n }\n\n override async decreaseValue(key: string): Promise<number> {\n return this.changeInteger(key, -1);\n }\n\n override async expireKey(key: string, durationMS: number): Promise<boolean> {\n this.ensureConnected();\n const now = Date.now();\n const { changes } = this.stmts!.expire.run(now + durationMS, key, now);\n return changes === 1;\n }\n\n override async ttlKey(key: string): Promise<number> {\n const row = this.getRow(key, 'any');\n if (!row) return -2;\n if (row.expires == null) return -1;\n return row.expires - Date.now();\n }\n\n override async leftPushValue(key: string, ...values: string[]): Promise<boolean> {\n return this.withImmediateTransaction(() => {\n const row = this.getRow(key, 'list');\n const list = row ? this.parseList(row.value) : [];\n list.push(...values);\n this.write(key, JSON.stringify(list), 'list', undefined, !!row);\n return true;\n });\n }\n\n override async rightPopValue(key: string): Promise<string | null> {\n return this.withImmediateTransaction(() => {\n const row = this.getRow(key, 'list');\n if (!row) return null;\n const list = this.parseList(row.value);\n const value = list.pop() ?? null;\n if (!list.length) {\n this.stmts!.delete.run(key);\n } else {\n this.write(key, JSON.stringify(list), 'list', undefined, true);\n }\n return value;\n });\n }\n\n /** 写锁事务;已在事务中则直接执行,避免嵌套 BEGIN。 */\n protected withImmediateTransaction<T>(fn: () => T): T {\n this.ensureConnected();\n const db = this.db!;\n if (db.isTransaction) return fn();\n\n db.exec('BEGIN IMMEDIATE');\n try {\n const result = fn();\n db.exec('COMMIT');\n return result;\n } catch (error) {\n if (db.isTransaction) db.exec('ROLLBACK');\n throw error;\n }\n }\n\n protected ensureConnected(): void {\n if (this.db?.isOpen && this.stmts) return;\n\n if (this.filename !== ':memory:') {\n mkdirSync(dirname(this.filename), { recursive: true });\n }\n\n const db = new DatabaseSync(this.filename, { timeout: this.timeout });\n db.exec(`\n PRAGMA journal_mode = WAL;\n CREATE TABLE IF NOT EXISTS cache (\n key TEXT PRIMARY KEY NOT NULL,\n value TEXT NOT NULL,\n kind TEXT NOT NULL CHECK (kind IN ('string', 'list')),\n expires INTEGER\n ) STRICT;\n CREATE INDEX IF NOT EXISTS cache_expires_idx ON cache (expires);\n `);\n\n this.db = db;\n this.stmts = {\n get: db.prepare('SELECT key, value, kind, expires FROM cache WHERE key = ?'),\n upsert: db.prepare(`\n INSERT INTO cache (key, value, kind, expires)\n VALUES (?, ?, ?, ?)\n ON CONFLICT(key) DO UPDATE SET\n value = excluded.value,\n kind = excluded.kind,\n expires = excluded.expires\n `),\n updateValue: db.prepare(`\n UPDATE cache SET value = ?, kind = ? WHERE key = ?\n `),\n delete: db.prepare('DELETE FROM cache WHERE key = ?'),\n deleteAll: db.prepare('DELETE FROM cache'),\n expire: db.prepare(`\n UPDATE cache SET expires = ?\n WHERE key = ? AND (expires IS NULL OR expires >= ?)\n `),\n incr: db.prepare(`\n UPDATE cache\n SET value = CAST(CAST(value AS INTEGER) + ? AS INTEGER)\n WHERE key = ?\n RETURNING value\n `),\n };\n }\n\n protected getRow(key: string, assertType: 'string'): CacheRow | null;\n protected getRow(key: string, assertType: 'list'): CacheRow | null;\n protected getRow(key: string, assertType: 'any'): CacheRow | null;\n protected getRow(key: string, assertType: 'string' | 'list' | 'any'): CacheRow | null {\n this.ensureConnected();\n const row = this.stmts!.get.get(key) as CacheRow | undefined;\n if (!row) return null;\n if (row.expires != null && row.expires < Date.now()) {\n this.stmts!.delete.run(key);\n return null;\n }\n if (assertType !== 'any' && row.kind !== assertType) {\n throw new Error(i18n.t('wrong_type'));\n }\n return row;\n }\n\n /**\n * @param preserveExpires 为 true 时只改 value/kind(list 就地更新、对齐 Redis 保留 TTL)\n */\n protected write(\n key: string,\n value: string,\n kind: CacheKind,\n durationMS?: number,\n preserveExpires = false,\n ): void {\n this.ensureConnected();\n if (preserveExpires) {\n this.stmts!.updateValue.run(value, kind, key);\n return;\n }\n this.stmts!.upsert.run(\n key,\n value,\n kind,\n durationMS === undefined ? null : Date.now() + durationMS,\n );\n }\n\n /** 对齐 Redis INCR/DECR */\n protected changeInteger(key: string, delta: number): number {\n return this.withImmediateTransaction(() => {\n const row = this.getRow(key, 'string');\n if (row) {\n if (!/^-?\\d+$/.test(row.value)) {\n throw new Error(i18n.t('not_integer'));\n }\n const updated = this.stmts!.incr.get(delta, key) as { value: string };\n return Number(updated.value);\n }\n this.write(key, String(delta), 'string');\n return delta;\n });\n }\n\n protected parseList(value: string): string[] {\n const parsed: unknown = JSON.parse(value);\n if (!Array.isArray(parsed) || parsed.some((item) => typeof item !== 'string')) {\n throw new Error(i18n.t('wrong_type'));\n }\n return parsed;\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"cache-file-adapter.js","names":[],"sources":["../../src/adapters/cache-file-adapter.ts"],"sourcesContent":["import { mkdirSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { DatabaseSync, type StatementSync } from 'node:sqlite';\nimport { CacheAdapter } from '../cache-adapter';\nimport { i18n } from '../i18n';\n\nexport interface CacheFileAdapterOptions {\n /**\n * SQLite 数据库路径。传入 `':memory:'` 使用内存库。\n */\n filename: string;\n /**\n * 获取写锁的最长等待时间(毫秒),对应 `node:sqlite` 的 `timeout`。\n * @default 5000\n */\n timeout?: number;\n}\n\ntype CacheKind = 'string' | 'list';\n\ntype CacheRow = {\n key: string;\n value: string;\n kind: CacheKind;\n expires: number | null;\n};\n\ntype Statements = {\n get: StatementSync;\n upsert: StatementSync;\n /** 只改 value/kind,保留 TTL(对齐 Redis 对已有 key 的就地更新) */\n updateValue: StatementSync;\n delete: StatementSync;\n deleteAll: StatementSync;\n expire: StatementSync;\n /** 对齐 Redis INCR/DECR:只改 value,保留 TTL */\n incr: StatementSync;\n};\n\n/**\n * 基于 `node:sqlite` 的文件缓存适配器。\n *\n * key 只作为表主键存储,不拼进文件系统路径。\n * NX / incr / list 等读改写使用 `BEGIN IMMEDIATE`,多进程共库时保持原子语义。\n */\nexport class CacheFileAdapter extends CacheAdapter {\n public readonly filename: string;\n protected readonly timeout: number;\n protected db?: DatabaseSync;\n protected stmts?: Statements;\n\n constructor(options: CacheFileAdapterOptions) {\n super();\n this.filename =\n options.filename === ':memory:' ? options.filename : resolve(options.filename);\n this.timeout = options.timeout ?? 5_000;\n }\n\n override async connect(): Promise<void> {\n this.ensureConnected();\n }\n\n override async disconnect(): Promise<void> {\n const { db } = this;\n if (!db) return;\n if (db.isOpen) db.close();\n this.db = undefined;\n this.stmts = undefined;\n }\n\n override async existsKey(key: string): Promise<boolean> {\n return this.getRow(key, 'any') !== null;\n }\n\n override async getValue(key: string): Promise<string | null> {\n return this.getRow(key, 'string')?.value ?? null;\n }\n\n override async setValue(\n key: string,\n value: string,\n durationMS?: number,\n ): Promise<boolean> {\n this.write(key, value, 'string', durationMS);\n return true;\n }\n\n override async setNotExistValue(\n key: string,\n value: string,\n durationMS?: number,\n ): Promise<boolean> {\n return this.withImmediateTransaction(() => {\n if (this.getRow(key, 'any')) return false;\n this.write(key, value, 'string', durationMS);\n return true;\n });\n }\n\n override async deleteValue(key: string): Promise<boolean> {\n this.ensureConnected();\n this.stmts!.delete.run(key);\n return true;\n }\n\n override async deleteAllValues(): Promise<boolean> {\n this.ensureConnected();\n this.stmts!.deleteAll.run();\n return true;\n }\n\n override async increaseValue(key: string): Promise<number> {\n return this.changeInteger(key, 1);\n }\n\n override async decreaseValue(key: string): Promise<number> {\n return this.changeInteger(key, -1);\n }\n\n override async expireKey(key: string, durationMS: number): Promise<boolean> {\n this.ensureConnected();\n const now = Date.now();\n const { changes } = this.stmts!.expire.run(now + durationMS, key, now);\n return changes === 1;\n }\n\n override async ttlKey(key: string): Promise<number> {\n const row = this.getRow(key, 'any');\n if (!row) return -2;\n if (row.expires == null) return -1;\n return row.expires - Date.now();\n }\n\n override async leftPushValue(key: string, ...values: string[]): Promise<boolean> {\n return this.withImmediateTransaction(() => {\n const row = this.getRow(key, 'list');\n const list = row ? this.parseList(row.value) : [];\n list.push(...values);\n this.write(key, JSON.stringify(list), 'list', undefined, !!row);\n return true;\n });\n }\n\n override async rightPopValue(key: string): Promise<string | null> {\n return this.withImmediateTransaction(() => {\n const row = this.getRow(key, 'list');\n if (!row) return null;\n const list = this.parseList(row.value);\n const value = list.pop() ?? null;\n if (!list.length) {\n this.stmts!.delete.run(key);\n } else {\n this.write(key, JSON.stringify(list), 'list', undefined, true);\n }\n return value;\n });\n }\n\n /** 写锁事务;已在事务中则直接执行,避免嵌套 BEGIN。 */\n protected withImmediateTransaction<T>(fn: () => T): T {\n this.ensureConnected();\n const db = this.db!;\n if (db.isTransaction) return fn();\n\n db.exec('BEGIN IMMEDIATE');\n try {\n const result = fn();\n db.exec('COMMIT');\n return result;\n } catch (error) {\n if (db.isTransaction) db.exec('ROLLBACK');\n throw error;\n }\n }\n\n protected ensureConnected(): void {\n if (this.db?.isOpen && this.stmts) return;\n\n if (this.filename !== ':memory:') {\n mkdirSync(dirname(this.filename), { recursive: true });\n }\n\n const db = new DatabaseSync(this.filename, { timeout: this.timeout });\n db.exec(`\n PRAGMA journal_mode = WAL;\n CREATE TABLE IF NOT EXISTS cache (\n key TEXT PRIMARY KEY NOT NULL,\n value TEXT NOT NULL,\n kind TEXT NOT NULL CHECK (kind IN ('string', 'list')),\n expires INTEGER\n ) STRICT;\n CREATE INDEX IF NOT EXISTS cache_expires_idx ON cache (expires);\n `);\n\n this.db = db;\n this.stmts = {\n get: db.prepare('SELECT key, value, kind, expires FROM cache WHERE key = ?'),\n upsert: db.prepare(`\n INSERT INTO cache (key, value, kind, expires)\n VALUES (?, ?, ?, ?)\n ON CONFLICT(key) DO UPDATE SET\n value = excluded.value,\n kind = excluded.kind,\n expires = excluded.expires\n `),\n updateValue: db.prepare(`\n UPDATE cache SET value = ?, kind = ? WHERE key = ?\n `),\n delete: db.prepare('DELETE FROM cache WHERE key = ?'),\n deleteAll: db.prepare('DELETE FROM cache'),\n expire: db.prepare(`\n UPDATE cache SET expires = ?\n WHERE key = ? AND (expires IS NULL OR expires >= ?)\n `),\n incr: db.prepare(`\n UPDATE cache\n SET value = CAST(CAST(value AS INTEGER) + ? AS INTEGER)\n WHERE key = ?\n RETURNING value\n `),\n };\n }\n\n protected getRow(key: string, assertType: 'string'): CacheRow | null;\n protected getRow(key: string, assertType: 'list'): CacheRow | null;\n protected getRow(key: string, assertType: 'any'): CacheRow | null;\n protected getRow(key: string, assertType: 'string' | 'list' | 'any'): CacheRow | null {\n this.ensureConnected();\n const row = this.stmts!.get.get(key) as CacheRow | undefined;\n if (!row) return null;\n if (row.expires != null && row.expires < Date.now()) {\n this.stmts!.delete.run(key);\n return null;\n }\n if (assertType !== 'any' && row.kind !== assertType) {\n throw new Error(i18n.t('wrong_type'));\n }\n return row;\n }\n\n /**\n * @param preserveExpires 为 true 时只改 value/kind(list 就地更新、对齐 Redis 保留 TTL)\n */\n protected write(\n key: string,\n value: string,\n kind: CacheKind,\n durationMS?: number,\n preserveExpires = false,\n ): void {\n this.ensureConnected();\n if (preserveExpires) {\n this.stmts!.updateValue.run(value, kind, key);\n return;\n }\n this.stmts!.upsert.run(\n key,\n value,\n kind,\n durationMS === undefined ? null : Date.now() + durationMS,\n );\n }\n\n /** 对齐 Redis INCR/DECR */\n protected changeInteger(key: string, delta: number): number {\n return this.withImmediateTransaction(() => {\n const row = this.getRow(key, 'string');\n if (row) {\n if (!/^-?\\d+$/.test(row.value)) {\n throw new Error(i18n.t('not_integer'));\n }\n const updated = this.stmts!.incr.get(delta, key) as { value: string };\n return Number(updated.value);\n }\n this.write(key, String(delta), 'string');\n return delta;\n });\n }\n\n protected parseList(value: string): string[] {\n const parsed: unknown = JSON.parse(value);\n if (!Array.isArray(parsed) || parsed.some((item) => typeof item !== 'string')) {\n throw new Error(i18n.t('wrong_type'));\n }\n return parsed;\n }\n}\n"],"mappings":"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"}
@@ -1,5 +1,4 @@
1
- import { t as CacheAdapter } from "../cache-adapter-4n2JTK4Y.js";
2
- import { t as i18n } from "../i18n-BKvtLTPF.js";
1
+ import { n as CacheAdapter, t as i18n } from "../i18n-OXOpRIod.js";
3
2
  // src/adapters/cache-memory-adapter.ts
4
3
  var CacheMemoryAdapter = class extends CacheAdapter {
5
4
  data = /* @__PURE__ */ new Map();
@@ -1 +1 @@
1
- {"version":3,"file":"cache-memory-adapter.js","names":[],"sources":["../../src/adapters/cache-memory-adapter.ts"],"sourcesContent":["import { CacheAdapter } from '../cache-adapter';\nimport { i18n } from '../i18n';\n\nexport class CacheMemoryAdapter extends CacheAdapter {\n private data = new Map<string, { value: string | string[]; expires?: number }>();\n\n override async existsKey(key: string): Promise<boolean> {\n return this.getValueSync(key, 'any') !== null;\n }\n\n override async getValue(key: string): Promise<string | null> {\n const value = this.getValueSync(key, 'string');\n return value;\n }\n\n override async setValue(\n key: string,\n value: string,\n duration?: number,\n ): Promise<boolean> {\n return this.setValueSync(key, value, duration);\n }\n\n override async setNotExistValue(\n key: string,\n value: string,\n duration?: number,\n ): Promise<boolean> {\n const currentValue = this.getValueSync(key, 'string');\n if (currentValue !== null) return false;\n return this.setValueSync(key, value, duration);\n }\n\n override async leftPushValue(key: string, ...values: string[]): Promise<boolean> {\n let result = this.getValueSync(key, 'array');\n if (result === null) result = [];\n result.push(...values);\n this.setValueSync(key, result);\n return true;\n }\n\n override async rightPopValue(key: string): Promise<string | null> {\n let result = this.getValueSync(key, 'array');\n if (result === null || !result.length) return null;\n const popValue = result.pop()!;\n if (result.length) {\n this.setValueSync(key, result);\n } else {\n this.data.delete(key);\n }\n return popValue;\n }\n\n override async increaseValue(key: string): Promise<number> {\n const result = this.getValueSync(key, 'string');\n let value: number;\n if (result === null) {\n this.data.set(key, { value: '0' });\n value = 0;\n } else {\n value = Number(result);\n }\n\n if (Number.isNaN(value) || !Number.isInteger(value)) {\n throw new Error(i18n.t('not_integer'));\n }\n\n this.setValueSync(key, String(++value));\n return value;\n }\n\n override async decreaseValue(key: string): Promise<number> {\n const result = this.getValueSync(key, 'string');\n let value: number;\n if (result === null) {\n this.data.set(key, { value: '0' });\n value = 0;\n } else {\n value = Number(result);\n }\n\n if (Number.isNaN(value) || !Number.isInteger(value)) {\n throw new Error(i18n.t('not_integer'));\n }\n\n this.setValueSync(key, String(--value));\n return value;\n }\n\n override async deleteValue(key: string): Promise<boolean> {\n this.data.delete(key);\n return true;\n }\n\n override async deleteAllValues(): Promise<boolean> {\n this.data.clear();\n return true;\n }\n\n override async expireKey(key: string, duration: number): Promise<boolean> {\n const result = this.data.get(key);\n if (!result) return false;\n if (result.expires && result.expires < Date.now()) return false;\n result.expires = Date.now() + duration;\n return true;\n }\n\n override async ttlKey(key: string): Promise<number> {\n const result = this.data.get(key);\n if (!result) return -2;\n if (!result.expires) return -1;\n if (result.expires < Date.now()) return -2;\n return result.expires - Date.now();\n }\n\n protected getValueSync<T extends 'string' | 'array' | 'any'>(\n key: string,\n assertType: T,\n ):\n | (T extends 'any' ? string | string[] : T extends 'string' ? string : Array<string>)\n | null {\n const result = this.data.get(key);\n if (!result) return null;\n if (result.expires && result.expires < Date.now()) return null;\n const value = result.value;\n\n let isValid = false;\n switch (assertType) {\n case 'string':\n isValid = typeof value === 'string';\n break;\n case 'array':\n isValid = Array.isArray(value);\n break;\n case 'any':\n isValid = true;\n break;\n }\n\n if (!isValid) {\n throw new Error(i18n.t('wrong_type'));\n }\n\n return value as any;\n }\n\n protected setValueSync(\n key: string,\n value: string | string[],\n duration?: number,\n ): boolean {\n this.data.set(key, { value, expires: duration ? Date.now() + duration : undefined });\n return true;\n }\n}\n"],"mappings":";;;AAGA,IAAa,qBAAb,cAAwC,aAAa;CACnD,uBAAe,IAAI,IAA4D;CAE/E,MAAe,UAAU,KAA+B;EACtD,OAAO,KAAK,aAAa,KAAK,KAAK,MAAM;CAC3C;CAEA,MAAe,SAAS,KAAqC;EAE3D,OADc,KAAK,aAAa,KAAK,QAC1B;CACb;CAEA,MAAe,SACb,KACA,OACA,UACkB;EAClB,OAAO,KAAK,aAAa,KAAK,OAAO,QAAQ;CAC/C;CAEA,MAAe,iBACb,KACA,OACA,UACkB;EAElB,IADqB,KAAK,aAAa,KAAK,QAC7B,MAAM,MAAM,OAAO;EAClC,OAAO,KAAK,aAAa,KAAK,OAAO,QAAQ;CAC/C;CAEA,MAAe,cAAc,KAAa,GAAG,QAAoC;EAC/E,IAAI,SAAS,KAAK,aAAa,KAAK,OAAO;EAC3C,IAAI,WAAW,MAAM,SAAS,CAAC;EAC/B,OAAO,KAAK,GAAG,MAAM;EACrB,KAAK,aAAa,KAAK,MAAM;EAC7B,OAAO;CACT;CAEA,MAAe,cAAc,KAAqC;EAChE,IAAI,SAAS,KAAK,aAAa,KAAK,OAAO;EAC3C,IAAI,WAAW,QAAQ,CAAC,OAAO,QAAQ,OAAO;EAC9C,MAAM,WAAW,OAAO,IAAI;EAC5B,IAAI,OAAO,QACT,KAAK,aAAa,KAAK,MAAM;OAE7B,KAAK,KAAK,OAAO,GAAG;EAEtB,OAAO;CACT;CAEA,MAAe,cAAc,KAA8B;EACzD,MAAM,SAAS,KAAK,aAAa,KAAK,QAAQ;EAC9C,IAAI;EACJ,IAAI,WAAW,MAAM;GACnB,KAAK,KAAK,IAAI,KAAK,EAAE,OAAO,IAAI,CAAC;GACjC,QAAQ;EACV,OACE,QAAQ,OAAO,MAAM;EAGvB,IAAI,OAAO,MAAM,KAAK,KAAK,CAAC,OAAO,UAAU,KAAK,GAChD,MAAM,IAAI,MAAM,KAAK,EAAE,aAAa,CAAC;EAGvC,KAAK,aAAa,KAAK,OAAO,EAAE,KAAK,CAAC;EACtC,OAAO;CACT;CAEA,MAAe,cAAc,KAA8B;EACzD,MAAM,SAAS,KAAK,aAAa,KAAK,QAAQ;EAC9C,IAAI;EACJ,IAAI,WAAW,MAAM;GACnB,KAAK,KAAK,IAAI,KAAK,EAAE,OAAO,IAAI,CAAC;GACjC,QAAQ;EACV,OACE,QAAQ,OAAO,MAAM;EAGvB,IAAI,OAAO,MAAM,KAAK,KAAK,CAAC,OAAO,UAAU,KAAK,GAChD,MAAM,IAAI,MAAM,KAAK,EAAE,aAAa,CAAC;EAGvC,KAAK,aAAa,KAAK,OAAO,EAAE,KAAK,CAAC;EACtC,OAAO;CACT;CAEA,MAAe,YAAY,KAA+B;EACxD,KAAK,KAAK,OAAO,GAAG;EACpB,OAAO;CACT;CAEA,MAAe,kBAAoC;EACjD,KAAK,KAAK,MAAM;EAChB,OAAO;CACT;CAEA,MAAe,UAAU,KAAa,UAAoC;EACxE,MAAM,SAAS,KAAK,KAAK,IAAI,GAAG;EAChC,IAAI,CAAC,QAAQ,OAAO;EACpB,IAAI,OAAO,WAAW,OAAO,UAAU,KAAK,IAAI,GAAG,OAAO;EAC1D,OAAO,UAAU,KAAK,IAAI,IAAI;EAC9B,OAAO;CACT;CAEA,MAAe,OAAO,KAA8B;EAClD,MAAM,SAAS,KAAK,KAAK,IAAI,GAAG;EAChC,IAAI,CAAC,QAAQ,OAAO;EACpB,IAAI,CAAC,OAAO,SAAS,OAAO;EAC5B,IAAI,OAAO,UAAU,KAAK,IAAI,GAAG,OAAO;EACxC,OAAO,OAAO,UAAU,KAAK,IAAI;CACnC;CAEA,aACE,KACA,YAGO;EACP,MAAM,SAAS,KAAK,KAAK,IAAI,GAAG;EAChC,IAAI,CAAC,QAAQ,OAAO;EACpB,IAAI,OAAO,WAAW,OAAO,UAAU,KAAK,IAAI,GAAG,OAAO;EAC1D,MAAM,QAAQ,OAAO;EAErB,IAAI,UAAU;EACd,QAAQ,YAAR;GACE,KAAK;IACH,UAAU,OAAO,UAAU;IAC3B;GACF,KAAK;IACH,UAAU,MAAM,QAAQ,KAAK;IAC7B;GACF,KAAK,OACH,UAAU;EAEd;EAEA,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,KAAK,EAAE,YAAY,CAAC;EAGtC,OAAO;CACT;CAEA,aACE,KACA,OACA,UACS;EACT,KAAK,KAAK,IAAI,KAAK;GAAE;GAAO,SAAS,WAAW,KAAK,IAAI,IAAI,WAAW,KAAA;EAAU,CAAC;EACnF,OAAO;CACT;AACF"}
1
+ {"version":3,"file":"cache-memory-adapter.js","names":[],"sources":["../../src/adapters/cache-memory-adapter.ts"],"sourcesContent":["import { CacheAdapter } from '../cache-adapter';\nimport { i18n } from '../i18n';\n\nexport class CacheMemoryAdapter extends CacheAdapter {\n private data = new Map<string, { value: string | string[]; expires?: number }>();\n\n override async existsKey(key: string): Promise<boolean> {\n return this.getValueSync(key, 'any') !== null;\n }\n\n override async getValue(key: string): Promise<string | null> {\n const value = this.getValueSync(key, 'string');\n return value;\n }\n\n override async setValue(\n key: string,\n value: string,\n duration?: number,\n ): Promise<boolean> {\n return this.setValueSync(key, value, duration);\n }\n\n override async setNotExistValue(\n key: string,\n value: string,\n duration?: number,\n ): Promise<boolean> {\n const currentValue = this.getValueSync(key, 'string');\n if (currentValue !== null) return false;\n return this.setValueSync(key, value, duration);\n }\n\n override async leftPushValue(key: string, ...values: string[]): Promise<boolean> {\n let result = this.getValueSync(key, 'array');\n if (result === null) result = [];\n result.push(...values);\n this.setValueSync(key, result);\n return true;\n }\n\n override async rightPopValue(key: string): Promise<string | null> {\n let result = this.getValueSync(key, 'array');\n if (result === null || !result.length) return null;\n const popValue = result.pop()!;\n if (result.length) {\n this.setValueSync(key, result);\n } else {\n this.data.delete(key);\n }\n return popValue;\n }\n\n override async increaseValue(key: string): Promise<number> {\n const result = this.getValueSync(key, 'string');\n let value: number;\n if (result === null) {\n this.data.set(key, { value: '0' });\n value = 0;\n } else {\n value = Number(result);\n }\n\n if (Number.isNaN(value) || !Number.isInteger(value)) {\n throw new Error(i18n.t('not_integer'));\n }\n\n this.setValueSync(key, String(++value));\n return value;\n }\n\n override async decreaseValue(key: string): Promise<number> {\n const result = this.getValueSync(key, 'string');\n let value: number;\n if (result === null) {\n this.data.set(key, { value: '0' });\n value = 0;\n } else {\n value = Number(result);\n }\n\n if (Number.isNaN(value) || !Number.isInteger(value)) {\n throw new Error(i18n.t('not_integer'));\n }\n\n this.setValueSync(key, String(--value));\n return value;\n }\n\n override async deleteValue(key: string): Promise<boolean> {\n this.data.delete(key);\n return true;\n }\n\n override async deleteAllValues(): Promise<boolean> {\n this.data.clear();\n return true;\n }\n\n override async expireKey(key: string, duration: number): Promise<boolean> {\n const result = this.data.get(key);\n if (!result) return false;\n if (result.expires && result.expires < Date.now()) return false;\n result.expires = Date.now() + duration;\n return true;\n }\n\n override async ttlKey(key: string): Promise<number> {\n const result = this.data.get(key);\n if (!result) return -2;\n if (!result.expires) return -1;\n if (result.expires < Date.now()) return -2;\n return result.expires - Date.now();\n }\n\n protected getValueSync<T extends 'string' | 'array' | 'any'>(\n key: string,\n assertType: T,\n ):\n | (T extends 'any' ? string | string[] : T extends 'string' ? string : Array<string>)\n | null {\n const result = this.data.get(key);\n if (!result) return null;\n if (result.expires && result.expires < Date.now()) return null;\n const value = result.value;\n\n let isValid = false;\n switch (assertType) {\n case 'string':\n isValid = typeof value === 'string';\n break;\n case 'array':\n isValid = Array.isArray(value);\n break;\n case 'any':\n isValid = true;\n break;\n }\n\n if (!isValid) {\n throw new Error(i18n.t('wrong_type'));\n }\n\n return value as any;\n }\n\n protected setValueSync(\n key: string,\n value: string | string[],\n duration?: number,\n ): boolean {\n this.data.set(key, { value, expires: duration ? Date.now() + duration : undefined });\n return true;\n }\n}\n"],"mappings":"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"}
@@ -1,13 +1,20 @@
1
1
  import { I18n, createI18n } from "@aomex/common";
2
+ // src/cache-adapter.ts
3
+ var CacheAdapter = class {
4
+ async connect() {}
5
+ async disconnect() {}
6
+ };
2
7
  // src/i18n/locales/zh-cn.ts
3
8
  const zh = I18n.define({
4
9
  wrong_type: "值的类型不正确",
5
- not_integer: "值不是整数"
10
+ not_integer: "值不是整数",
11
+ cache_service_destroyed: "缓存服务已销毁"
6
12
  });
7
13
  // src/i18n/locales/en-us.ts
8
14
  const en = I18n.satisfies(zh).define({
9
15
  wrong_type: "The value has an incorrect type",
10
- not_integer: "The value is not an integer"
16
+ not_integer: "The value is not an integer",
17
+ cache_service_destroyed: "Cache service has been destroyed"
11
18
  });
12
19
  // src/i18n/index.ts
13
20
  const i18n = createI18n({
@@ -15,6 +22,6 @@ const i18n = createI18n({
15
22
  en,
16
23
  load: (file) => import(new URL(`./locales/${file}.js`, import.meta.url).href)
17
24
  });
18
- export { i18n as t };
25
+ export { CacheAdapter as n, i18n as t };
19
26
 
20
- //# sourceMappingURL=i18n-BKvtLTPF.js.map
27
+ //# sourceMappingURL=i18n-OXOpRIod.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"i18n-OXOpRIod.js","names":[],"sources":["../src/cache-adapter.ts","../src/i18n/locales/zh-cn.ts","../src/i18n/locales/en-us.ts","../src/i18n/index.ts"],"sourcesContent":["export abstract class CacheAdapter {\n async connect() {}\n\n async disconnect() {}\n\n abstract existsKey(key: string): Promise<boolean>;\n abstract getValue(key: string): Promise<string | null>;\n abstract setValue(key: string, value: string, durationMS?: number): Promise<boolean>;\n abstract setNotExistValue(\n key: string,\n value: string,\n durationMS?: number,\n ): Promise<boolean>;\n abstract deleteValue(key: string): Promise<boolean>;\n abstract deleteAllValues(): Promise<boolean>;\n abstract increaseValue(key: string): Promise<number>;\n abstract decreaseValue(key: string): Promise<number>;\n abstract expireKey(key: string, durationMS: number): Promise<boolean>;\n abstract ttlKey(key: string): Promise<number>;\n abstract leftPushValue(key: string, ...values: string[]): Promise<boolean>;\n abstract rightPopValue(key: string): Promise<string | null>;\n}\n","import { I18n } from '@aomex/common';\n\nexport const zh = I18n.define({\n wrong_type: '值的类型不正确',\n not_integer: '值不是整数',\n cache_service_destroyed: '缓存服务已销毁',\n});\n","import { I18n } from '@aomex/common';\nimport { zh } from './zh-cn';\n\nexport const en = I18n.satisfies(zh).define({\n wrong_type: 'The value has an incorrect type',\n not_integer: 'The value is not an integer',\n cache_service_destroyed: 'Cache service has been destroyed',\n});\n","import { createI18n } from '@aomex/common';\nimport { zh } from './locales/zh-cn';\nimport { en } from './locales/en-us';\n\nexport const i18n = createI18n({\n zh,\n en,\n load: (file) => import(new URL(`./locales/${file}.js`, import.meta.url).href),\n});\n"],"mappings":";;AAAA,IAAsB,eAAtB,MAAmC;CACjC,MAAM,UAAU,CAAC;CAEjB,MAAM,aAAa,CAAC;AAkBtB;;ACnBA,MAAa,KAAK,KAAK,OAAO;CAC5B,YAAY;CACZ,aAAa;CACb,yBAAyB;AAC3B,CAAC;;ACHD,MAAa,KAAK,KAAK,UAAU,EAAE,CAAC,CAAC,OAAO;CAC1C,YAAY;CACZ,aAAa;CACb,yBAAyB;AAC3B,CAAC;;ACHD,MAAa,OAAO,WAAW;CAC7B;CACA;CACA,OAAO,SAAS,OAAO,IAAI,IAAI,aAAa,KAAK,MAAM,YAAY,GAAG,CAAC,CAAC;AAC1E,CAAC"}
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: string): Promise<boolean>;
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: string, defaultValue: T): Promise<T>;
24
- get<T extends Caching.Types>(key: string, defaultValue: T | null | undefined): Promise<T | null>;
25
- get<T extends Caching.Types>(key: string): Promise<T | null>;
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: string, value: Caching.Types, durationMs?: number): Promise<boolean>;
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: string, value: Caching.Types, durationMs?: number): Promise<boolean>;
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: string, ...values: Caching.Types[]): Promise<boolean>;
78
+ leftPush(key: Caching.Key, ...values: Caching.Types[]): Promise<boolean>;
53
79
  /**
54
80
  * 移除列表的最后一个元素,返回值为被移除的元素
55
81
  */
56
- rightPop<T extends Caching.Types>(key: string): Promise<T | null>;
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: string): Promise<number>;
92
+ increment(key: Caching.Key): Promise<number>;
67
93
  /**
68
94
  * 重新设置缓存时间。如果key不存在,则返回`false`
69
95
  */
70
- expire(key: string, durationMs: number): Promise<boolean>;
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: string): Promise<number>;
111
+ ttl(key: Caching.Key): Promise<number>;
86
112
  /**
87
113
  * 将key中储存的数字值减一。如果key不存在,那么key的值会先被初始化为0,然后再执行操作。如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误
88
114
  */
89
- decrement(key: string): Promise<number>;
115
+ decrement(key: Caching.Key): Promise<number>;
90
116
  /**
91
117
  * 删除指定缓存
92
118
  */
93
- delete(key: string): Promise<boolean>;
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;
@@ -108,12 +135,15 @@ export declare class Caching<T extends CacheAdapter = CacheAdapter> {
108
135
  *
109
136
  * ```typescript
110
137
  * import { CacheMemoryAdapter } from '@aomex/cache/memory';
138
+ * import { createRemember } from '@aomex/cache';
111
139
  *
112
140
  * class CacheService extends BaseCacheService {
113
141
  * protected createAdapter() {
114
142
  * return new CacheMemoryAdapter();
115
143
  * }
116
144
  * }
145
+ *
146
+ * export const remember = createRemember(CacheService);
117
147
  * ```
118
148
  */
119
149
  export declare abstract class BaseCacheService<T extends CacheAdapter = CacheAdapter> extends Service {
@@ -134,12 +164,30 @@ export declare abstract class BaseCacheService<T extends CacheAdapter = CacheAda
134
164
  /** 按 365 天计 */
135
165
  readonly YEAR: 31536000000;
136
166
  };
137
- /** 用 `:` 拼接缓存 key 片段,如 `concat('user', 1)` → `'user:1'` */
138
- protected concat(...keys: Array<string | number>): string;
139
- /** 对 key 做 MD5,适合过长或不规则片段 */
140
- protected hash(key: string | number): string;
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;
141
189
  }
142
- export 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>> = {
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>> = {
143
191
  key?: string | ((this: any, ...args: Parameters<P>) => string);
144
192
  duration: number;
145
193
  /**
@@ -148,59 +196,26 @@ export type RememberOptions<R extends Caching.Types | null = Caching.Types | nul
148
196
  defaultValue?: Q;
149
197
  };
150
198
  /**
151
- * 可调用的方法装饰器,并携带独立的 `BaseCacheService` 作用域。
152
- * `fork()` 会得到一份新的 remember(各自的 setInstance / deleteInstance 互不影响)。
199
+ * 可调用的方法装饰器,由 `createRemember(CacheService)` 创建。
200
+ * 绑定到指定缓存服务类;实例 `onInit` 完成前调用会等待就绪,`onDestroy` 后调用会抛错。
153
201
  */
154
- export interface Remember {
202
+ interface Remember {
155
203
  (durationMs: number): (originalMethod: (...args: any[]) => Promise<any>, context: ClassMethodDecoratorContext) => (...args: any[]) => Promise<any>;
156
204
  <R extends Caching.Types | null, P extends (...args: any[]) => Promise<R>, Q extends NonNullable<R>>(opts: RememberOptions<R, P, Q>): (originalMethod: P, context: ClassMethodDecoratorContext) => P;
157
- /** 登记本作用域唯一的 `BaseCacheService`;重复传入同一实例为幂等,传入不同实例则抛错 */
158
- setInstance(service: BaseCacheService): void;
159
- /** 清除本作用域的 `BaseCacheService` 登记 */
160
- deleteInstance(): void;
161
- /** 派生一份独立作用域的 remember */
162
- fork(): Remember;
163
205
  }
206
+ /** 任意 `BaseCacheService` 构造函数(含基类,供内部挂载使用) */
207
+ type CacheServiceCtor = abstract new (...args: any[]) => BaseCacheService;
208
+ /**
209
+ * 具体缓存服务子类构造函数。传入 `BaseCacheService` 本身时类型为 `never`。
210
+ */
211
+ type ConcreteCacheServiceCtor<C extends CacheServiceCtor = CacheServiceCtor> = BaseCacheService extends InstanceType<C> ? never : C;
164
212
  /**
165
- * 方法装饰器:自动获取缓存,未命中则执行原方法并写入;并发相同 key 会截流共享首个请求。
166
- * 每个 remember(含 `fork()` 产物)各自只允许登记一个 `BaseCacheService`。
213
+ * 创建绑定到指定 `BaseCacheService` 子类的 remember 装饰器。
214
+ * 必须传入具体子类,不能传入 `BaseCacheService` 本身。
167
215
  *
168
216
  * ```typescript
169
- * class CacheService extends BaseCacheService {
170
- * protected createAdapter() {
171
- * return new CacheRedisAdapter({ host: '127.0.0.1' });
172
- * }
173
- *
174
- * protected override async onInit() {
175
- * await super.onInit();
176
- * remember.setInstance(this);
177
- * }
178
- *
179
- * protected override async onDestroy() {
180
- * remember.deleteInstance();
181
- * await super.onDestroy();
182
- * }
183
- * }
184
- *
185
- * await combineServices(
186
- * {
187
- * cache: () => import('./cache.service.js'),
188
- * report: () => import('./report.service.js'),
189
- * },
190
- * { eager: ['cache'] },
191
- * );
192
- *
193
- * class Report {
194
- * @remember(60_000)
195
- * async build() {
196
- * return { ok: true };
197
- * }
198
- * }
199
- *
200
- * // 另一套缓存作用域
201
- * const rememberB = remember.fork();
202
- * rememberB.setInstance(otherCacheService);
217
+ * export const remember = createRemember(CacheService);
203
218
  * ```
204
219
  */
205
- export declare const remember: Remember;
206
- export { CacheAdapter };
220
+ export declare function createRemember<C extends CacheServiceCtor>(ctor: ConcreteCacheServiceCtor<C>): Remember;
221
+ export { CacheAdapter, type CacheServiceCtor, type ConcreteCacheServiceCtor, type Remember, type RememberOptions };
package/dist/index.js CHANGED
@@ -1,7 +1,44 @@
1
- import { t as CacheAdapter } from "./cache-adapter-4n2JTK4Y.js";
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
- import { createHash } from "node:crypto";
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));
@@ -186,14 +226,60 @@ var Caching = class {
186
226
  }
187
227
  };
188
228
  // src/remember.ts
189
- function createRemember() {
190
- let service;
229
+ /** 每个服务类一份:当前 `Caching` + 未就绪时的等待 Promise */
230
+ const stateByCtor = /* @__PURE__ */ new WeakMap();
231
+ function getState(ctor) {
232
+ const existing = stateByCtor.get(ctor);
233
+ if (existing) return existing;
234
+ const state = {
235
+ cache: void 0,
236
+ destroyed: false,
237
+ ready: Promise.withResolvers()
238
+ };
239
+ stateByCtor.set(ctor, state);
240
+ return state;
241
+ }
242
+ async function ensureCache(ctor) {
243
+ const state = getState(ctor);
244
+ if (state.destroyed) throw new Error(i18n.t("cache_service_destroyed"));
245
+ if (state.cache) return state.cache;
246
+ await state.ready.promise;
247
+ if (state.destroyed || !state.cache) throw new Error(i18n.t("cache_service_destroyed"));
248
+ return state.cache;
249
+ }
250
+ /** 供 `BaseCacheService.onInit` 挂载;包外请勿直接调用 */
251
+ function attachRememberScopes(service) {
252
+ const ctor = service.constructor;
253
+ const cache = service["_cache"];
254
+ const state = getState(ctor);
255
+ state.destroyed = false;
256
+ state.cache = cache;
257
+ state.ready.resolve(cache);
258
+ }
259
+ /** 供 `BaseCacheService.onDestroy` / `onInit` 失败时卸载;包外请勿直接调用 */
260
+ function detachRememberScopes(service) {
261
+ const ctor = service.constructor;
262
+ const state = stateByCtor.get(ctor);
263
+ if (!state) return;
264
+ if (state.cache !== void 0 && state.cache !== service["_cache"]) return;
265
+ state.destroyed = true;
266
+ state.cache = void 0;
267
+ state.ready.reject(new Error(i18n.t("cache_service_destroyed")));
268
+ }
269
+ /**
270
+ * 创建绑定到指定 `BaseCacheService` 子类的 remember 装饰器。
271
+ * 必须传入具体子类,不能传入 `BaseCacheService` 本身。
272
+ *
273
+ * ```typescript
274
+ * export const remember = createRemember(CacheService);
275
+ * ```
276
+ */
277
+ function createRemember(ctor) {
191
278
  const remember = ((optsOrDurationMs) => {
192
279
  const { key: getKey, duration, defaultValue = null } = typeof optsOrDurationMs === "number" ? { duration: optsOrDurationMs } : optsOrDurationMs;
193
280
  return (originalMethod, context) => {
194
281
  return async function(...args) {
195
- if (!service) throw new Error("Cache service is not registered; call remember.setInstance(service) first");
196
- const cache = service["_cache"];
282
+ const cache = await ensureCache(ctor);
197
283
  const dataKey = getKey === void 0 ? `${"displayName" in this && typeof this.displayName === "string" ? this.displayName : this.constructor.name}-${String(context.name)}-${JSON.stringify(args)}` : typeof getKey === "string" ? getKey : getKey.apply(this, args);
198
284
  const waitingKey = dataKey + ":$#_waiting_#$";
199
285
  const value = await traceBlock("Cache.get", () => cache.get(dataKey));
@@ -226,58 +312,8 @@ function createRemember() {
226
312
  };
227
313
  };
228
314
  });
229
- remember.setInstance = (next) => {
230
- if (service !== void 0 && service !== next) throw new Error("Only one cache service is allowed");
231
- service = next;
232
- };
233
- remember.deleteInstance = () => {
234
- service = void 0;
235
- };
236
- remember.fork = () => createRemember();
237
315
  return remember;
238
316
  }
239
- /**
240
- * 方法装饰器:自动获取缓存,未命中则执行原方法并写入;并发相同 key 会截流共享首个请求。
241
- * 每个 remember(含 `fork()` 产物)各自只允许登记一个 `BaseCacheService`。
242
- *
243
- * ```typescript
244
- * class CacheService extends BaseCacheService {
245
- * protected createAdapter() {
246
- * return new CacheRedisAdapter({ host: '127.0.0.1' });
247
- * }
248
- *
249
- * protected override async onInit() {
250
- * await super.onInit();
251
- * remember.setInstance(this);
252
- * }
253
- *
254
- * protected override async onDestroy() {
255
- * remember.deleteInstance();
256
- * await super.onDestroy();
257
- * }
258
- * }
259
- *
260
- * await combineServices(
261
- * {
262
- * cache: () => import('./cache.service.js'),
263
- * report: () => import('./report.service.js'),
264
- * },
265
- * { eager: ['cache'] },
266
- * );
267
- *
268
- * class Report {
269
- * @remember(60_000)
270
- * async build() {
271
- * return { ok: true };
272
- * }
273
- * }
274
- *
275
- * // 另一套缓存作用域
276
- * const rememberB = remember.fork();
277
- * rememberB.setInstance(otherCacheService);
278
- * ```
279
- */
280
- const remember = createRemember();
281
317
  // src/base-cache-service.ts
282
318
  const CACHE_TTL = {
283
319
  SECOND: 1e3,
@@ -295,12 +331,15 @@ const CACHE_TTL = {
295
331
  *
296
332
  * ```typescript
297
333
  * import { CacheMemoryAdapter } from '@aomex/cache/memory';
334
+ * import { createRemember } from '@aomex/cache';
298
335
  *
299
336
  * class CacheService extends BaseCacheService {
300
337
  * protected createAdapter() {
301
338
  * return new CacheMemoryAdapter();
302
339
  * }
303
340
  * }
341
+ *
342
+ * export const remember = createRemember(CacheService);
304
343
  * ```
305
344
  */
306
345
  var BaseCacheService = class extends Service {
@@ -310,24 +349,49 @@ var BaseCacheService = class extends Service {
310
349
  }
311
350
  async onInit() {
312
351
  this._cache = new Caching(this.createAdapter());
313
- await this._cache.adapter.connect();
352
+ try {
353
+ await this._cache.adapter.connect();
354
+ attachRememberScopes(this);
355
+ } catch (e) {
356
+ detachRememberScopes(this);
357
+ throw e;
358
+ }
314
359
  }
315
360
  async onDestroy() {
361
+ detachRememberScopes(this);
316
362
  await this._cache?.adapter.disconnect();
317
363
  }
318
364
  /** 常用过期时间(毫秒):`this.ttl.DAY` */
319
365
  get ttl() {
320
366
  return CACHE_TTL;
321
367
  }
322
- /** 用 `:` 拼接缓存 key 片段,如 `concat('user', 1)` → `'user:1'` */
323
- concat(...keys) {
324
- return keys.join(":");
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
+ */
379
+ key(...keys) {
380
+ return keys.length === 0 ? new CacheKey() : new CacheKey().key(...keys);
325
381
  }
326
- /** 对 key 做 MD5,适合过长或不规则片段 */
327
- hash(key) {
328
- return createHash("md5").update(String(key)).digest("hex");
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);
329
393
  }
330
394
  };
331
- export { BaseCacheService, CacheAdapter, Caching, remember };
395
+ export { BaseCacheService, CacheAdapter, CacheKey, Caching, createRemember };
332
396
 
333
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';\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 * 可调用的方法装饰器,并携带独立的 `BaseCacheService` 作用域。\n * `fork()` 会得到一份新的 remember(各自的 setInstance / deleteInstance 互不影响)。\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 /** 登记本作用域唯一的 `BaseCacheService`;重复传入同一实例为幂等,传入不同实例则抛错 */\n setInstance(service: BaseCacheService): void;\n /** 清除本作用域的 `BaseCacheService` 登记 */\n deleteInstance(): void;\n /** 派生一份独立作用域的 remember */\n fork(): Remember;\n}\n\nfunction createRemember(): Remember {\n let service: BaseCacheService | undefined;\n\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 if (!service) {\n throw new Error(\n 'Cache service is not registered; call remember.setInstance(service) first',\n );\n }\n const cache = service['_cache'];\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 remember.setInstance = (next: BaseCacheService): void => {\n if (service !== undefined && service !== next) {\n throw new Error('Only one cache service is allowed');\n }\n service = next;\n };\n\n remember.deleteInstance = (): void => {\n service = undefined;\n };\n\n remember.fork = (): Remember => createRemember();\n\n return remember;\n}\n\n/**\n * 方法装饰器:自动获取缓存,未命中则执行原方法并写入;并发相同 key 会截流共享首个请求。\n * 每个 remember(含 `fork()` 产物)各自只允许登记一个 `BaseCacheService`。\n *\n * ```typescript\n * class CacheService extends BaseCacheService {\n * protected createAdapter() {\n * return new CacheRedisAdapter({ host: '127.0.0.1' });\n * }\n *\n * protected override async onInit() {\n * await super.onInit();\n * remember.setInstance(this);\n * }\n *\n * protected override async onDestroy() {\n * remember.deleteInstance();\n * await super.onDestroy();\n * }\n * }\n *\n * await combineServices(\n * {\n * cache: () => import('./cache.service.js'),\n * report: () => import('./report.service.js'),\n * },\n * { eager: ['cache'] },\n * );\n *\n * class Report {\n * @remember(60_000)\n * async build() {\n * return { ok: true };\n * }\n * }\n *\n * // 另一套缓存作用域\n * const rememberB = remember.fork();\n * rememberB.setInstance(otherCacheService);\n * ```\n */\nexport const remember = createRemember();\n","import { createHash } from 'node:crypto';\nimport { Service } from '@aomex/common';\nimport { CacheAdapter } from './cache-adapter';\nimport { Caching } from './caching';\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 *\n * class CacheService extends BaseCacheService {\n * protected createAdapter() {\n * return new CacheMemoryAdapter();\n * }\n * }\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 await this._cache.adapter.connect();\n }\n\n protected override async onDestroy(): Promise<void> {\n await this._cache?.adapter.disconnect();\n }\n\n /** 常用过期时间(毫秒):`this.ttl.DAY` */\n protected get ttl() {\n return CACHE_TTL;\n }\n\n /** 用 `:` 拼接缓存 key 片段,如 `concat('user', 1)` → `'user:1'` */\n protected concat(...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":"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"}
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,35 +1,25 @@
1
1
  {
2
2
  "name": "@aomex/cache",
3
- "version": "3.30.8-alpha.62.sha-92b25bb",
3
+ "version": "4.0.0",
4
4
  "description": "缓存基础类",
5
- "scripts": {
6
- "prepublishOnly": "tsdown"
7
- },
8
5
  "type": "module",
9
- "types": "src/index.ts",
6
+ "types": "dist/index.d.ts",
10
7
  "exports": {
11
- ".": "./src/index.ts",
12
- "./file": "./src/adapters/cache-file-adapter.ts",
13
- "./memory": "./src/adapters/cache-memory-adapter.ts",
8
+ ".": {
9
+ "types": "./dist/index.d.ts",
10
+ "import": "./dist/index.js"
11
+ },
12
+ "./file": {
13
+ "types": "./dist/adapters/cache-file-adapter.d.ts",
14
+ "import": "./dist/adapters/cache-file-adapter.js"
15
+ },
16
+ "./memory": {
17
+ "types": "./dist/adapters/cache-memory-adapter.d.ts",
18
+ "import": "./dist/adapters/cache-memory-adapter.js"
19
+ },
14
20
  "./package.json": "./package.json"
15
21
  },
16
22
  "publishConfig": {
17
- "types": "dist/index.d.ts",
18
- "exports": {
19
- ".": {
20
- "types": "./dist/index.d.ts",
21
- "import": "./dist/index.js"
22
- },
23
- "./file": {
24
- "types": "./dist/adapters/cache-file-adapter.d.ts",
25
- "import": "./dist/adapters/cache-file-adapter.js"
26
- },
27
- "./memory": {
28
- "types": "./dist/adapters/cache-memory-adapter.d.ts",
29
- "import": "./dist/adapters/cache-memory-adapter.js"
30
- },
31
- "./package.json": "./package.json"
32
- },
33
23
  "access": "public"
34
24
  },
35
25
  "files": [
@@ -39,17 +29,20 @@
39
29
  "README.md",
40
30
  "CHANGELOG.md"
41
31
  ],
42
- "repository": "git@github.com:aomex/aomex.git",
32
+ "repository": {
33
+ "type": "git",
34
+ "url": "git@github.com:aomex/aomex.git"
35
+ },
43
36
  "homepage": "https://aomex.js.org",
44
37
  "license": "MIT",
45
38
  "peerDependencies": {
46
39
  "@aomex/common": "^4.0.0"
47
40
  },
48
41
  "dependencies": {
49
- "@aomex/async-trace": "3.30.8-alpha.62.sha-92b25bb"
42
+ "@aomex/async-trace": "4.0.0"
50
43
  },
51
44
  "devDependencies": {
52
- "@aomex/common": "3.30.8-alpha.62.sha-92b25bb"
45
+ "@aomex/common": "4.0.0"
53
46
  },
54
- "gitHead": "92b25bbcd6c3ae28160316117a74c88619b5bc8d"
55
- }
47
+ "scripts": {}
48
+ }
@@ -1,8 +0,0 @@
1
- // src/cache-adapter.ts
2
- var CacheAdapter = class {
3
- async connect() {}
4
- async disconnect() {}
5
- };
6
- export { CacheAdapter as t };
7
-
8
- //# sourceMappingURL=cache-adapter-4n2JTK4Y.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"cache-adapter-4n2JTK4Y.js","names":[],"sources":["../src/cache-adapter.ts"],"sourcesContent":["export abstract class CacheAdapter {\n async connect() {}\n\n async disconnect() {}\n\n abstract existsKey(key: string): Promise<boolean>;\n abstract getValue(key: string): Promise<string | null>;\n abstract setValue(key: string, value: string, durationMS?: number): Promise<boolean>;\n abstract setNotExistValue(\n key: string,\n value: string,\n durationMS?: number,\n ): Promise<boolean>;\n abstract deleteValue(key: string): Promise<boolean>;\n abstract deleteAllValues(): Promise<boolean>;\n abstract increaseValue(key: string): Promise<number>;\n abstract decreaseValue(key: string): Promise<number>;\n abstract expireKey(key: string, durationMS: number): Promise<boolean>;\n abstract ttlKey(key: string): Promise<number>;\n abstract leftPushValue(key: string, ...values: string[]): Promise<boolean>;\n abstract rightPopValue(key: string): Promise<string | null>;\n}\n"],"mappings":";AAAA,IAAsB,eAAtB,MAAmC;CACjC,MAAM,UAAU,CAAC;CAEjB,MAAM,aAAa,CAAC;AAkBtB"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"i18n-BKvtLTPF.js","names":[],"sources":["../src/i18n/locales/zh-cn.ts","../src/i18n/locales/en-us.ts","../src/i18n/index.ts"],"sourcesContent":["import { I18n } from '@aomex/common';\n\nexport const zh = I18n.define({\n wrong_type: '值的类型不正确',\n not_integer: '值不是整数',\n});\n","import { I18n } from '@aomex/common';\nimport { zh } from './zh-cn';\n\nexport const en = I18n.satisfies(zh).define({\n wrong_type: 'The value has an incorrect type',\n not_integer: 'The value is not an integer',\n});\n","import { createI18n } from '@aomex/common';\nimport { zh } from './locales/zh-cn';\nimport { en } from './locales/en-us';\n\nexport const i18n = createI18n({\n zh,\n en,\n load: (file) => import(new URL(`./locales/${file}.js`, import.meta.url).href),\n});\n"],"mappings":";;AAEA,MAAa,KAAK,KAAK,OAAO;CAC5B,YAAY;CACZ,aAAa;AACf,CAAC;;ACFD,MAAa,KAAK,KAAK,UAAU,EAAE,CAAC,CAAC,OAAO;CAC1C,YAAY;CACZ,aAAa;AACf,CAAC;;ACFD,MAAa,OAAO,WAAW;CAC7B;CACA;CACA,OAAO,SAAS,OAAO,IAAI,IAAI,aAAa,KAAK,MAAM,YAAY,GAAG,CAAC,CAAC;AAC1E,CAAC"}