@aomex/cache 3.30.7 → 3.30.8-alpha.131cf1c.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/dist/adapters/cache-file-adapter.d.ts +72 -0
- package/dist/adapters/cache-file-adapter.js +198 -0
- package/dist/adapters/cache-file-adapter.js.map +1 -0
- package/dist/adapters/cache-memory-adapter.d.ts +18 -0
- package/dist/adapters/cache-memory-adapter.js +106 -0
- package/dist/adapters/cache-memory-adapter.js.map +1 -0
- package/dist/cache-adapter-4n2JTK4Y.js +8 -0
- package/dist/cache-adapter-4n2JTK4Y.js.map +1 -0
- package/dist/cache-adapter-CVIt9DB_.d.ts +17 -0
- package/dist/i18n-BKvtLTPF.js +20 -0
- package/dist/i18n-BKvtLTPF.js.map +1 -0
- package/dist/index.d.ts +202 -158
- package/dist/index.js +326 -412
- package/dist/index.js.map +1 -1
- package/package.json +12 -4
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/caching.ts","../src/cache-adapter.ts","../src/i18n/index.ts","../src/i18n/locales/zh-cn.ts","../src/i18n/locales/en-us.ts","../src/i18n/locales/index.ts","../src/cache-memory-adapter.ts"],"sourcesContent":["import { traceBlock } from '@aomex/async-trace';\nimport { CacheAdapter } from './cache-adapter';\nimport { sleep } from '@aomex/common';\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 /**\n * 方法装饰器,自动获取数据,如果不存在则请求原始数据并自动保存。在请求原始数据期间,任意相同请求都会被截流,并共享第一个请求\n * ```typescript\n * const cache = new Caching(memoryAdapter());\n *\n * class MyClass {\n * \\@cache.decorate({ key: (id) => `key_${id}`, duration: 60_000 })\n * async getData(id: number) {\n * const result = await queryDB({ id: id });\n * return result;\n * }\n * }\n * ```\n */\n decorate<\n T extends Caching.Types | null,\n P extends (...args: any[]) => Promise<T>,\n Q extends NonNullable<T>,\n >(opts: {\n key?: string | ((...args: Parameters<P>) => string);\n duration: number;\n /**\n * 当数据源返回null或者undefined时,则返回默认值\n */\n defaultValue?: Q;\n }) {\n const instance = this;\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 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', () => instance.get<Q>(dataKey));\n if (value !== null) return value;\n\n const win = await instance.setNX(waitingKey, 1, 10_000);\n if (win) {\n const timer = setInterval(() => {\n instance.expire(waitingKey, 10_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 instance.set(dataKey, result!, duration);\n });\n }\n return result === null ? defaultValue : result;\n } finally {\n clearInterval(timer);\n await instance.delete(waitingKey);\n }\n } else {\n return traceBlock('Cache.wait', async () => {\n while (true) {\n const waiting = await instance.exists(waitingKey);\n if (waiting) {\n await sleep(100);\n continue;\n }\n return instance.get<Q>(dataKey, defaultValue);\n }\n });\n }\n };\n };\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","export abstract class CacheAdapter {\n async connect() {}\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';\nimport { locales } from './locales';\n\nexport const i18n = new I18n({\n resources: locales,\n defaultLanguage: 'zh_CN',\n});\n","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: 'wrong kind of value',\n not_integer: 'value is not an integer',\n});\n","import { zh } from './zh-cn';\nimport { en } from './en-us';\n\nexport const locales = {\n zh_CN: zh,\n en_US: en,\n};\n","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('缓存值不是整数类型');\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\nexport const memoryAdapter = () => new CacheMemoryAdapter();\n"],"mappings":"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","names":["I18n","I18n","I18n","I18n"]}
|
|
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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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aomex/cache",
|
|
3
|
-
"version": "3.30.
|
|
3
|
+
"version": "3.30.8-alpha.131cf1c.0",
|
|
4
4
|
"description": "缓存基础类",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -9,6 +9,14 @@
|
|
|
9
9
|
"types": "./dist/index.d.ts",
|
|
10
10
|
"import": "./dist/index.js"
|
|
11
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
|
+
},
|
|
12
20
|
"./package.json": "./package.json"
|
|
13
21
|
},
|
|
14
22
|
"publishConfig": {
|
|
@@ -28,13 +36,13 @@
|
|
|
28
36
|
"homepage": "https://aomex.js.org",
|
|
29
37
|
"license": "MIT",
|
|
30
38
|
"peerDependencies": {
|
|
31
|
-
"@aomex/common": "^
|
|
39
|
+
"@aomex/common": "^4.0.0"
|
|
32
40
|
},
|
|
33
41
|
"dependencies": {
|
|
34
|
-
"@aomex/async-trace": "3.30.
|
|
42
|
+
"@aomex/async-trace": "3.30.8-alpha.131cf1c.0"
|
|
35
43
|
},
|
|
36
44
|
"devDependencies": {
|
|
37
|
-
"@aomex/common": "3.30.
|
|
45
|
+
"@aomex/common": "3.30.8-alpha.131cf1c.0"
|
|
38
46
|
},
|
|
39
47
|
"scripts": {}
|
|
40
48
|
}
|