@pcontext/api 0.0.1

package/dist/shared/redis/decorator.mjs

@@ -0,0 +1,203 @@
+import { getRedis } from "./factory.mjs";
+
+//#region src/shared/redis/decorator.ts
+const tagCacheMap = /* @__PURE__ */ new Map();
+/**
+* 生成默认缓存 key
+*/
+function generateDefaultKey(target, key, args) {
+	return `${target.constructor?.name || "anonymous"}:${key}:${JSON.stringify(args)}`;
+}
+/**
+* 将缓存 key 关联到标签
+*/
+function associateTag(cacheKey, tags) {
+	for (const tag of tags) {
+		if (!tagCacheMap.has(tag)) tagCacheMap.set(tag, /* @__PURE__ */ new Set());
+		tagCacheMap.get(tag).add(cacheKey);
+	}
+}
+/**
+* 清除标签关联的缓存
+* @param tags 要失效的标签列表（不含 namespace 前缀）
+* @param namespace 目标 namespace，用于拼接标签前缀（string | string[] | '*' | undefined）
+*        - undefined：不传，默认使用当前 namespace
+*        - string：单个 namespace
+*        - string[]：多个 namespace
+*        - '*'：不过滤，使用原始 tag 匹配所有
+* @param currentNamespace 当前 service 的 namespace，用于默认值
+*/
+async function invalidateTags(tags, namespace, currentNamespace) {
+	const redis = getRedis();
+	let targetNamespaces;
+	if (namespace === "*") targetNamespaces = [];
+	else if (Array.isArray(namespace)) targetNamespaces = namespace;
+	else if (namespace) targetNamespaces = [namespace];
+	else targetNamespaces = [currentNamespace];
+	for (const tag of tags) {
+		const tagsToMatch = targetNamespaces.length > 0 ? targetNamespaces.map((ns) => `${ns}:${tag}`) : [tag];
+		let keysToDelete = [];
+		for (const tagToMatch of tagsToMatch) {
+			const cacheKeys = tagCacheMap.get(tagToMatch);
+			if (cacheKeys && cacheKeys.size > 0) keysToDelete = keysToDelete.concat(Array.from(cacheKeys));
+		}
+		if (keysToDelete.length > 0) await redis.del(...keysToDelete);
+		for (const tagToMatch of tagsToMatch) tagCacheMap.delete(tagToMatch);
+	}
+}
+/**
+* 标记为缓存服务
+* - 为每个 service 创建 cache namespace
+* - 提供统一 key 生成器
+*
+* @param namespace 自定义命名空间，默认使用类名
+*
+* @example
+* ```ts
+* @CacheableService()
+* class UserService {
+*   @Cache({ key: (id) => `user:${id}` })
+*   async getUser(id: number) { ... }
+* }
+* ```
+*
+* @example
+* ```ts
+* @CacheableService('customNamespace')
+* class CustomService { ... }
+* ```
+*/
+function CacheableService(namespace) {
+	return function(constructor) {
+		const ns = namespace || constructor.name;
+		constructor.prototype.__cacheNamespace = ns;
+		return constructor;
+	};
+}
+/**
+* 缓存装饰器
+* - 从 Redis 获取/存储缓存
+* - 支持自定义 key 和 TTL
+* - 支持标签机制
+*
+* @param options 配置选项
+*
+* @example
+* // 基础用法
+* @Cache()
+* async getUser(id: number) { ... }
+*
+* @example
+* // 自定义 TTL
+* @Cache({ ttl: 600 })
+* async getData() { ... }
+*
+* @example
+* // 自定义 key 函数
+* @Cache({ key: (id, name) => `user:${id}:${name}` })
+* async getUser(id: number, name: string) { ... }
+*
+* @example
+* // 使用标签（推荐）
+* @Cache({ tags: (id) => [`user:${id}`] })
+* async getUser(id: number) { ... }
+*/
+function Cache(options = {}) {
+	const { ttl = 3600 } = options;
+	return function(target, _key, descriptor) {
+		const original = descriptor.value;
+		descriptor.value = async function(...args) {
+			const redis = getRedis();
+			const namespace = this.__cacheNamespace || target.constructor?.name || "anonymous";
+			let cacheKey;
+			if (typeof options.key === "function") cacheKey = options.key(...args);
+			else if (typeof options.key === "string") cacheKey = options.key;
+			else cacheKey = generateDefaultKey(target, _key, args);
+			const fullCacheKey = `${namespace}:${cacheKey}`;
+			if (options.tags) associateTag(fullCacheKey, options.tags(...args).map((tag) => `${namespace}:${tag}`));
+			const cached = await redis.get(fullCacheKey);
+			if (cached !== null) return JSON.parse(cached);
+			const result = await original.apply(this, args);
+			if (result !== void 0 && result !== null) await redis.setex(fullCacheKey, ttl, JSON.stringify(result));
+			return result;
+		};
+		return descriptor;
+	};
+}
+/**
+* 缓存失效装饰器
+* - 支持指定 key 失效（仅当前 namespace）
+* - 支持清除该 service 下所有缓存
+* - 支持标签失效（推荐，支持跨 namespace）
+*
+* @param options 配置选项
+*
+* @example
+* // 指定 key 失效（仅当前 namespace）
+* @Invalidate({ keys: (id) => [`getUser:${id}`] })
+* async updateUser(id: number) { ... }
+*
+* @example
+* // 使用标签失效（推荐，仅当前 namespace）
+* @Invalidate({ tags: (id) => [`user:${id}`] })
+* async updateUser(id: number) { ... }
+*
+* @example
+* // 清除该 service 下所有缓存
+* @Invalidate({ all: true })
+* async clearAllCache() { ... }
+*
+* @example
+* // 跨 namespace 失效 - 使用标签失效指定 namespace 的缓存
+* @Invalidate({ tags: (id) => ['task:123'], namespace: 'DocService' })
+* async updateTask(id: number) { ... }
+*
+* @example
+* // 跨 namespace 失效 - 使用标签失效多个 namespace 的缓存
+* @Invalidate({ tags: (id) => ['task:123'], namespace: ['DocService', 'RankService'] })
+* async updateTask(id: number) { ... }
+*
+* @example
+* // 跨 namespace 失效 - 使用标签失效所有 namespace 的缓存
+* @Invalidate({ tags: (id) => ['task:123'], namespace: '*' })
+* async updateTask(id: number) { ... }
+*/
+function Invalidate(options = {}) {
+	return function(target, _key, descriptor) {
+		const original = descriptor.value;
+		descriptor.value = async function(...args) {
+			const redis = getRedis();
+			const namespace = this.__cacheNamespace || target.constructor?.name || "anonymous";
+			const result = await original.apply(this, args);
+			try {
+				if (options.all) {
+					let cursor = "0";
+					do {
+						const [nextCursor, keys] = await redis.scan(cursor, "MATCH", `${namespace}:*`, "COUNT", 100);
+						cursor = nextCursor;
+						if (keys.length > 0) await redis.del(...keys);
+					} while (cursor !== "0");
+					for (const [tag, cacheKeys] of Array.from(tagCacheMap.entries())) if (tag.startsWith(namespace)) {
+						cacheKeys.clear();
+						tagCacheMap.delete(tag);
+					}
+					return result;
+				}
+				if (options.keys) {
+					const fullKeys = options.keys(...args).map((k) => `${namespace}:${k}`);
+					await redis.del(...fullKeys);
+					for (const [, cacheKeys] of Array.from(tagCacheMap.entries())) for (const k of fullKeys) cacheKeys.delete(k);
+				}
+				if (options.tags) await invalidateTags(options.tags(...args), options.namespace, namespace);
+			} catch (error) {
+				console.error("Cache invalidation failed:", error);
+			}
+			return result;
+		};
+		return descriptor;
+	};
+}
+
+//#endregion
+export { Cache, CacheableService, Invalidate };
+//# sourceMappingURL=decorator.mjs.map

package/dist/shared/redis/decorator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.mjs","names":[],"sources":["../../../src/shared/redis/decorator.ts"],"sourcesContent":["import { getRedis } from './factory'\n\n// ==================== 类型定义 ====================\n\ninterface CacheOptions {\n  /** 缓存 key，优先级高于 keyGenerator */\n  key?: string | ((...args: any[]) => string)\n  /** TTL 秒数，默认 3600 (1小时) */\n  ttl?: number\n  /** 缓存标签，用于批量失效 */\n  tags?: (...args: any[]) => string[]\n}\n\ninterface InvalidateOptions {\n  /** 要失效的缓存 key 列表 */\n  keys?: (...args: any[]) => string[]\n  /** 是否清除该 service 下所有缓存 */\n  all?: boolean\n  /** 要失效的标签（推荐使用 tag 机制） */\n  tags?: (...args: any[]) => string[]\n  /** 目标命名空间，指定要失效哪些 namespace 下的缓存 */\n  namespace?: string | string[] | '*'\n}\n\n// ==================== 内部存储 ====================\n\n// 标签 -> 缓存 key 集合的映射（用于 tag 失效）\nconst tagCacheMap = new Map<string, Set<string>>()\n\n// ==================== 工具函数 ====================\n\n/**\n * 生成默认缓存 key\n */\nfunction generateDefaultKey(target: any, key: string, args: any[]): string {\n  const className = target.constructor?.name || 'anonymous'\n  return `${className}:${key}:${JSON.stringify(args)}`\n}\n\n/**\n * 将缓存 key 关联到标签\n */\nfunction associateTag(cacheKey: string, tags: string[]) {\n  for (const tag of tags) {\n    if (!tagCacheMap.has(tag)) {\n      tagCacheMap.set(tag, new Set())\n    }\n    tagCacheMap.get(tag)!.add(cacheKey)\n  }\n}\n\n/**\n * 清除标签关联的缓存\n * @param tags 要失效的标签列表（不含 namespace 前缀）\n * @param namespace 目标 namespace，用于拼接标签前缀（string | string[] | '*' | undefined）\n *        - undefined：不传，默认使用当前 namespace\n *        - string：单个 namespace\n *        - string[]：多个 namespace\n *        - '*'：不过滤，使用原始 tag 匹配所有\n * @param currentNamespace 当前 service 的 namespace，用于默认值\n */\nasync function invalidateTags(\n  tags: string[],\n  namespace: string | string[] | '*' | undefined,\n  currentNamespace: string,\n): Promise<void> {\n  const redis = getRedis()\n\n  // 解析目标 namespace\n  let targetNamespaces: string[]\n  if (namespace === '*') {\n    targetNamespaces = [] // 空数组表示不过滤，使用原始 tag\n  }\n  else if (Array.isArray(namespace)) {\n    targetNamespaces = namespace\n  }\n  else if (namespace) {\n    targetNamespaces = [namespace]\n  }\n  else {\n    targetNamespaces = [currentNamespace] // 默认使用当前 namespace\n  }\n\n  for (const tag of tags) {\n    // 根据 targetNamespaces 生成要匹配的标签列表\n    const tagsToMatch = targetNamespaces.length > 0\n      ? targetNamespaces.map(ns => `${ns}:${tag}`)\n      : [tag] // '*' 时使用原始 tag\n\n    let keysToDelete: string[] = []\n\n    for (const tagToMatch of tagsToMatch) {\n      const cacheKeys = tagCacheMap.get(tagToMatch)\n      if (cacheKeys && cacheKeys.size > 0) {\n        keysToDelete = keysToDelete.concat(Array.from(cacheKeys))\n      }\n    }\n\n    if (keysToDelete.length > 0) {\n      await redis.del(...keysToDelete)\n    }\n\n    // 清除标签映射\n    for (const tagToMatch of tagsToMatch) {\n      tagCacheMap.delete(tagToMatch)\n    }\n  }\n}\n\n// ==================== 类级别装饰器 ====================\n\n/**\n * 标记为缓存服务\n * - 为每个 service 创建 cache namespace\n * - 提供统一 key 生成器\n *\n * @param namespace 自定义命名空间，默认使用类名\n *\n * @example\n * ```ts\n * @CacheableService()\n * class UserService {\n *   @Cache({ key: (id) => `user:${id}` })\n *   async getUser(id: number) { ... }\n * }\n * ```\n *\n * @example\n * ```ts\n * @CacheableService('customNamespace')\n * class CustomService { ... }\n * ```\n */\nfunction CacheableService(namespace?: string) {\n  return function <T extends new (...args: any[]) => any>(constructor: T) {\n    const ns = namespace || constructor.name\n    constructor.prototype.__cacheNamespace = ns\n    return constructor\n  }\n}\n\n// ==================== 方法级别装饰器 ====================\n\n/**\n * 缓存装饰器\n * - 从 Redis 获取/存储缓存\n * - 支持自定义 key 和 TTL\n * - 支持标签机制\n *\n * @param options 配置选项\n *\n * @example\n * // 基础用法\n * @Cache()\n * async getUser(id: number) { ... }\n *\n * @example\n * // 自定义 TTL\n * @Cache({ ttl: 600 })\n * async getData() { ... }\n *\n * @example\n * // 自定义 key 函数\n * @Cache({ key: (id, name) => `user:${id}:${name}` })\n * async getUser(id: number, name: string) { ... }\n *\n * @example\n * // 使用标签（推荐）\n * @Cache({ tags: (id) => [`user:${id}`] })\n * async getUser(id: number) { ... }\n */\nfunction Cache(options: CacheOptions = {}) {\n  const { ttl = 3600 } = options\n\n  return function (target: any, _key: string, descriptor: PropertyDescriptor) {\n    const original = descriptor.value\n\n    descriptor.value = async function (...args: any[]) {\n      const redis = getRedis()\n      const self = this as any\n      const namespace = self.__cacheNamespace || target.constructor?.name || 'anonymous'\n\n      // 生成缓存 key\n      let cacheKey: string\n      if (typeof options.key === 'function') {\n        cacheKey = options.key(...args)\n      }\n      else if (typeof options.key === 'string') {\n        cacheKey = options.key\n      }\n      else {\n        cacheKey = generateDefaultKey(target, _key, args)\n      }\n\n      // 添加命名空间前缀\n      const fullCacheKey = `${namespace}:${cacheKey}`\n\n      // 处理标签关联（标签带 namespace 前缀以避免冲突）\n      if (options.tags) {\n        const tags = options.tags(...args)\n        const fullTags = tags.map(tag => `${namespace}:${tag}`)\n        associateTag(fullCacheKey, fullTags)\n      }\n\n      // 尝试从 Redis 获取\n      const cached = await redis.get(fullCacheKey)\n      if (cached !== null) {\n        return JSON.parse(cached)\n      }\n\n      // 执行原函数\n      const result = await original.apply(this, args)\n\n      // 缓存结果\n      if (result !== undefined && result !== null) {\n        await redis.setex(fullCacheKey, ttl, JSON.stringify(result))\n      }\n\n      return result\n    }\n\n    return descriptor\n  }\n}\n\n/**\n * 缓存失效装饰器\n * - 支持指定 key 失效（仅当前 namespace）\n * - 支持清除该 service 下所有缓存\n * - 支持标签失效（推荐，支持跨 namespace）\n *\n * @param options 配置选项\n *\n * @example\n * // 指定 key 失效（仅当前 namespace）\n * @Invalidate({ keys: (id) => [`getUser:${id}`] })\n * async updateUser(id: number) { ... }\n *\n * @example\n * // 使用标签失效（推荐，仅当前 namespace）\n * @Invalidate({ tags: (id) => [`user:${id}`] })\n * async updateUser(id: number) { ... }\n *\n * @example\n * // 清除该 service 下所有缓存\n * @Invalidate({ all: true })\n * async clearAllCache() { ... }\n *\n * @example\n * // 跨 namespace 失效 - 使用标签失效指定 namespace 的缓存\n * @Invalidate({ tags: (id) => ['task:123'], namespace: 'DocService' })\n * async updateTask(id: number) { ... }\n *\n * @example\n * // 跨 namespace 失效 - 使用标签失效多个 namespace 的缓存\n * @Invalidate({ tags: (id) => ['task:123'], namespace: ['DocService', 'RankService'] })\n * async updateTask(id: number) { ... }\n *\n * @example\n * // 跨 namespace 失效 - 使用标签失效所有 namespace 的缓存\n * @Invalidate({ tags: (id) => ['task:123'], namespace: '*' })\n * async updateTask(id: number) { ... }\n */\nfunction Invalidate(options: InvalidateOptions = {}) {\n  return function (target: any, _key: string, descriptor: PropertyDescriptor) {\n    const original = descriptor.value\n\n    descriptor.value = async function (...args: any[]) {\n      const redis = getRedis()\n      const self = this as any\n      const namespace = self.__cacheNamespace || target.constructor?.name || 'anonymous'\n\n      // 1. 先执行原函数\n      const result = await original.apply(this, args)\n\n      // 2. 处理缓存失效\n      try {\n        // 方式一：清除所有缓存\n        if (options.all) {\n          let cursor = '0'\n          do {\n            const [nextCursor, keys] = await redis.scan(\n              cursor,\n              'MATCH',\n              `${namespace}:*`,\n              'COUNT',\n              100,\n            )\n            cursor = nextCursor\n            if (keys.length > 0) {\n              await redis.del(...keys)\n            }\n          } while (cursor !== '0')\n\n          // 清除标签映射\n          for (const [tag, cacheKeys] of Array.from(tagCacheMap.entries())) {\n            if (tag.startsWith(namespace)) {\n              cacheKeys.clear()\n              tagCacheMap.delete(tag)\n            }\n          }\n\n          return result\n        }\n\n        // 方式二：指定 key 失效（仅支持当前 namespace）\n        if (options.keys) {\n          const keys = options.keys(...args)\n          const fullKeys = keys.map(k => `${namespace}:${k}`)\n          await redis.del(...fullKeys)\n\n          // 清除标签映射中的 key\n          for (const [, cacheKeys] of Array.from(tagCacheMap.entries())) {\n            for (const k of fullKeys) {\n              cacheKeys.delete(k)\n            }\n          }\n        }\n\n        // 方式三：标签失效（推荐）\n        if (options.tags) {\n          const tags = options.tags(...args)\n          await invalidateTags(tags, options.namespace, namespace)\n        }\n      }\n      catch (error) {\n        console.error('Cache invalidation failed:', error)\n      }\n\n      return result\n    }\n\n    return descriptor\n  }\n}\n\n// ==================== 导出 ====================\n\nexport { Cache, CacheableService, Invalidate }\nexport type { CacheOptions, InvalidateOptions }\n"],"mappings":"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"}

package/dist/shared/redis/factory.d.mts

@@ -0,0 +1,18 @@
+import { Redis } from "ioredis";
+
+//#region src/shared/redis/factory.d.ts
+/**
+ * 创建 Redis 客户端实例
+ */
+declare function createRedisClient(): Redis;
+/**
+ * 初始化 Redis 连接
+ */
+declare function initRedis(): Promise<void>;
+/**
+ * 获取 Redis 客户端实例
+ */
+declare function getRedis(): Redis;
+//#endregion
+export { createRedisClient, getRedis, initRedis };
+//# sourceMappingURL=factory.d.mts.map

package/dist/shared/redis/factory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.mts","names":[],"sources":["../../../src/shared/redis/factory.ts"],"mappings":";;;;;AAWA;iBAAgB,iBAAA,CAAA,GAAqB,KAAA;;;;iBAaf,SAAA,CAAA,GAAS,OAAA;;;;iBAgBf,QAAA,CAAA,GAAY,KAAA"}

package/dist/shared/redis/factory.mjs

@@ -0,0 +1,41 @@
+import AppSettings from "../../settings.mjs";
+import { Redis } from "ioredis";
+
+//#region src/shared/redis/factory.ts
+const { config } = AppSettings;
+let redisClient = null;
+let initialized = false;
+/**
+* 创建 Redis 客户端实例
+*/
+function createRedisClient() {
+	return new Redis({
+		host: config.redis.host,
+		port: config.redis.port,
+		password: config.redis.password,
+		maxRetriesPerRequest: null
+	});
+}
+/**
+* 初始化 Redis 连接
+*/
+async function initRedis() {
+	if (initialized) return;
+	redisClient = createRedisClient();
+	initialized = true;
+}
+function ensureInitialized() {
+	if (!initialized) throw new Error("Redis not initialized, call initRedis() at startup");
+}
+/**
+* 获取 Redis 客户端实例
+*/
+function getRedis() {
+	ensureInitialized();
+	if (!redisClient) throw new Error("Redis client not initialized");
+	return redisClient;
+}
+
+//#endregion
+export { createRedisClient, getRedis, initRedis };
+//# sourceMappingURL=factory.mjs.map

package/dist/shared/redis/factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.mjs","names":[],"sources":["../../../src/shared/redis/factory.ts"],"sourcesContent":["import { Redis } from 'ioredis'\nimport AppSettings from '@/settings'\n\nconst { config } = AppSettings\n\nlet redisClient: Redis | null = null\nlet initialized = false\n\n/**\n * 创建 Redis 客户端实例\n */\nexport function createRedisClient(): Redis {\n  const redisConfig = {\n    host: config.redis.host,\n    port: config.redis.port,\n    password: config.redis.password,\n    maxRetriesPerRequest: null,\n  }\n  return new Redis(redisConfig)\n}\n\n/**\n * 初始化 Redis 连接\n */\nexport async function initRedis() {\n  if (initialized)\n    return\n  redisClient = createRedisClient()\n  initialized = true\n}\n\nfunction ensureInitialized() {\n  if (!initialized) {\n    throw new Error('Redis not initialized, call initRedis() at startup')\n  }\n}\n\n/**\n * 获取 Redis 客户端实例\n */\nexport function getRedis(): Redis {\n  ensureInitialized()\n  if (!redisClient) {\n    throw new Error('Redis client not initialized')\n  }\n  return redisClient\n}\n"],"mappings":";;;;AAGA,MAAM,EAAE,WAAW;AAEnB,IAAI,cAA4B;AAChC,IAAI,cAAc;;;;AAKlB,SAAgB,oBAA2B;AAOzC,QAAO,IAAI,MANS;EAClB,MAAM,OAAO,MAAM;EACnB,MAAM,OAAO,MAAM;EACnB,UAAU,OAAO,MAAM;EACvB,sBAAsB;EACvB,CAC4B;;;;;AAM/B,eAAsB,YAAY;AAChC,KAAI,YACF;AACF,eAAc,mBAAmB;AACjC,eAAc;;AAGhB,SAAS,oBAAoB;AAC3B,KAAI,CAAC,YACH,OAAM,IAAI,MAAM,qDAAqD;;;;;AAOzE,SAAgB,WAAkB;AAChC,oBAAmB;AACnB,KAAI,CAAC,YACH,OAAM,IAAI,MAAM,+BAA+B;AAEjD,QAAO"}

package/dist/shared/redis/index.d.mts

@@ -0,0 +1,12 @@
+import { createRedisClient, getRedis, initRedis } from "./factory.mjs";
+import { Redis } from "ioredis";
+
+//#region src/shared/redis/index.d.ts
+/**
+ * Redis 客户端实例（保留向后兼容）
+ * @deprecated 请使用 getRedis() 替代
+ */
+declare const redis: Redis;
+//#endregion
+export { createRedisClient, getRedis, initRedis, redis };
+//# sourceMappingURL=index.d.mts.map

package/dist/shared/redis/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/shared/redis/index.ts"],"mappings":";;;;;;AAOA;;cAAa,KAAA,EAAK,KAAA"}

package/dist/shared/redis/index.mjs

@@ -0,0 +1,14 @@
+import { createRedisClient, getRedis, initRedis } from "./factory.mjs";
+
+//#region src/shared/redis/index.ts
+/**
+* Redis 客户端实例（保留向后兼容）
+* @deprecated 请使用 getRedis() 替代
+*/
+const redis = new Proxy({}, { get(_target, prop) {
+	return getRedis()[prop];
+} });
+
+//#endregion
+export { createRedisClient, getRedis, initRedis, redis };
+//# sourceMappingURL=index.mjs.map

package/dist/shared/redis/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/shared/redis/index.ts"],"sourcesContent":["import type { Redis } from 'ioredis'\nimport { createRedisClient, getRedis, initRedis } from './factory'\n\n/**\n * Redis 客户端实例（保留向后兼容）\n * @deprecated 请使用 getRedis() 替代\n */\nexport const redis = new Proxy({} as Redis, {\n  get(_target, prop) {\n    const client = getRedis()\n    return (client as any)[prop]\n  },\n})\n\nexport { createRedisClient, getRedis, initRedis }\n"],"mappings":";;;;;;;AAOA,MAAa,QAAQ,IAAI,MAAM,EAAE,EAAW,EAC1C,IAAI,SAAS,MAAM;AAEjB,QADe,UAAU,CACF;GAE1B,CAAC"}

package/dist/shared/types.d.mts

@@ -0,0 +1,36 @@
+import { ChatService } from "../modules/doc/chat.service.mjs";
+import { DocService } from "../modules/doc/doc.service.mjs";
+import { RankService } from "../modules/rank/rank.service.mjs";
+import { TaskService } from "../modules/task/task.service.mjs";
+import { Logger } from "pino";
+
+//#region src/shared/types.d.ts
+interface ApiSuccess<T = unknown> {
+  code: number;
+  data: T;
+  message: string;
+}
+interface ApiError<T = unknown> {
+  code: number;
+  data: T | null;
+  message: string;
+}
+interface AppBindings {
+  Variables: {
+    requestId?: string;
+    logger?: Logger;
+    traceId?: string;
+    user?: {
+      id: number | null;
+      username: string;
+      role: 'admin' | 'user' | null;
+    };
+    taskService: TaskService;
+    rankService: RankService;
+    chatService: ChatService;
+    docService: DocService;
+  };
+}
+//#endregion
+export { ApiError, ApiSuccess, AppBindings };
+//# sourceMappingURL=types.d.mts.map

package/dist/shared/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/shared/types.ts"],"mappings":";;;;;;;UAMiB,UAAA;EACf,IAAA;EACA,IAAA,EAAM,CAAA;EACN,OAAA;AAAA;AAAA,UAGe,QAAA;EACf,IAAA;EACA,IAAA,EAAM,CAAA;EACN,OAAA;AAAA;AAAA,UAGe,WAAA;EACf,SAAA;IACE,SAAA;IACA,MAAA,GAAS,MAAA;IACT,OAAA;IACA,IAAA;MACE,EAAA;MACA,QAAA;MACA,IAAA;IAAA;IAEF,WAAA,EAAa,WAAA;IACb,WAAA,EAAa,WAAA;IACb,WAAA,EAAa,WAAA;IACb,UAAA,EAAY,UAAA;EAAA;AAAA"}

package/dist/shared/types.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/shared/utils/date.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/shared/utils/date.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/shared/utils/error-handler.d.mts

@@ -0,0 +1,7 @@
+import { ErrorHandler } from "hono";
+
+//#region src/shared/utils/error-handler.d.ts
+declare const errorHandler: ErrorHandler;
+//#endregion
+export { errorHandler };
+//# sourceMappingURL=error-handler.d.mts.map

package/dist/shared/utils/error-handler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.mts","names":[],"sources":["../../../src/shared/utils/error-handler.ts"],"mappings":";;;cAEa,YAAA,EAAc,YAAA"}

package/dist/shared/utils/error-handler.mjs

@@ -0,0 +1,22 @@
+//#region src/shared/utils/error-handler.ts
+const errorHandler = (err, c) => {
+	const logger = c.get("logger");
+	let status = 500;
+	let message = "Unknown error";
+	const anyErr = err;
+	if (anyErr && typeof anyErr.status === "number") {
+		status = anyErr.status;
+		if (typeof anyErr.message === "string" && anyErr.message.length > 0) message = anyErr.message;
+	} else if (err instanceof Error) message = err.message;
+	if (logger) logger.error({
+		err,
+		path: c.req.path,
+		method: c.req.path,
+		status
+	}, "Unhandled error");
+	return c.json({ message }, status);
+};
+
+//#endregion
+export { errorHandler };
+//# sourceMappingURL=error-handler.mjs.map

package/dist/shared/utils/error-handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.mjs","names":[],"sources":["../../../src/shared/utils/error-handler.ts"],"sourcesContent":["import type { ErrorHandler } from 'hono'\n\nexport const errorHandler: ErrorHandler = (err, c) => {\n  const logger = c.get('logger')\n  let status = 500\n  let message = 'Unknown error'\n\n  const anyErr = err as any\n  if (anyErr && typeof anyErr.status === 'number') {\n    status = anyErr.status\n    if (typeof anyErr.message === 'string' && anyErr.message.length > 0) {\n      message = anyErr.message\n    }\n  }\n  else if (err instanceof Error) {\n    message = err.message\n  }\n\n  if (logger) {\n    logger.error({ err, path: c.req.path, method: c.req.path, status }, 'Unhandled error')\n  }\n\n  return c.json({ message }, status as any)\n}\n"],"mappings":";AAEA,MAAa,gBAA8B,KAAK,MAAM;CACpD,MAAM,SAAS,EAAE,IAAI,SAAS;CAC9B,IAAI,SAAS;CACb,IAAI,UAAU;CAEd,MAAM,SAAS;AACf,KAAI,UAAU,OAAO,OAAO,WAAW,UAAU;AAC/C,WAAS,OAAO;AAChB,MAAI,OAAO,OAAO,YAAY,YAAY,OAAO,QAAQ,SAAS,EAChE,WAAU,OAAO;YAGZ,eAAe,MACtB,WAAU,IAAI;AAGhB,KAAI,OACF,QAAO,MAAM;EAAE;EAAK,MAAM,EAAE,IAAI;EAAM,QAAQ,EAAE,IAAI;EAAM;EAAQ,EAAE,kBAAkB;AAGxF,QAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAc"}

package/dist/shared/utils/format.d.mts

@@ -0,0 +1,8 @@
+import { TaskLogEntry } from "../../modules/task/task.entity.mjs";
+
+//#region src/shared/utils/format.d.ts
+declare function formatDateTime(date: Date, format?: string): string;
+declare function formatEntry(entry: TaskLogEntry): string;
+//#endregion
+export { formatDateTime, formatEntry };
+//# sourceMappingURL=format.d.mts.map

package/dist/shared/utils/format.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.mts","names":[],"sources":["../../../src/shared/utils/format.ts"],"mappings":";;;iBAEgB,cAAA,CAAe,IAAA,EAAM,IAAA,EAAM,MAAA;AAAA,iBAiB3B,WAAA,CAAY,KAAA,EAAO,YAAA"}

package/dist/shared/utils/format.mjs

@@ -0,0 +1,24 @@
+//#region src/shared/utils/format.ts
+function formatDateTime(date, format = "yyyy-MM-dd HH:mm:ss") {
+	const year = date.getFullYear();
+	const month = String(date.getMonth() + 1).padStart(2, "0");
+	const day = String(date.getDate()).padStart(2, "0");
+	const hour = String(date.getHours()).padStart(2, "0");
+	const minute = String(date.getMinutes()).padStart(2, "0");
+	const second = String(date.getSeconds()).padStart(2, "0");
+	return format.replace("yyyy", String(year)).replace("MM", month).replace("dd", day).replace("HH", hour).replace("mm", minute).replace("ss", second);
+}
+function formatEntry(entry) {
+	const parts = [];
+	parts.push(formatDateTime(new Date(entry.timestamp)));
+	parts.push(entry.level.toUpperCase());
+	if (entry.message && entry.message.length > 0) parts.push(entry.message);
+	if (entry.data !== void 0) try {
+		parts.push(JSON.stringify(entry.data));
+	} catch {}
+	return parts.join(" | ");
+}
+
+//#endregion
+export { formatDateTime, formatEntry };
+//# sourceMappingURL=format.mjs.map

package/dist/shared/utils/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","names":[],"sources":["../../../src/shared/utils/format.ts"],"sourcesContent":["import type { TaskLogEntry } from '@/modules/task/task.entity'\n\nexport function formatDateTime(date: Date, format: string = 'yyyy-MM-dd HH:mm:ss'): string {\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  const hour = String(date.getHours()).padStart(2, '0')\n  const minute = String(date.getMinutes()).padStart(2, '0')\n  const second = String(date.getSeconds()).padStart(2, '0')\n\n  return format\n    .replace('yyyy', String(year))\n    .replace('MM', month)\n    .replace('dd', day)\n    .replace('HH', hour)\n    .replace('mm', minute)\n    .replace('ss', second)\n}\n\nexport function formatEntry(entry: TaskLogEntry): string {\n  const parts: string[] = []\n  parts.push(formatDateTime(new Date(entry.timestamp)))\n  parts.push(entry.level.toUpperCase())\n  if (entry.message && entry.message.length > 0) {\n    parts.push(entry.message)\n  }\n  if (entry.data !== undefined) {\n    try {\n      parts.push(JSON.stringify(entry.data))\n    }\n    catch {}\n  }\n  return parts.join(' | ')\n}\n"],"mappings":";AAEA,SAAgB,eAAe,MAAY,SAAiB,uBAA+B;CACzF,MAAM,OAAO,KAAK,aAAa;CAC/B,MAAM,QAAQ,OAAO,KAAK,UAAU,GAAG,EAAE,CAAC,SAAS,GAAG,IAAI;CAC1D,MAAM,MAAM,OAAO,KAAK,SAAS,CAAC,CAAC,SAAS,GAAG,IAAI;CACnD,MAAM,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,SAAS,GAAG,IAAI;CACrD,MAAM,SAAS,OAAO,KAAK,YAAY,CAAC,CAAC,SAAS,GAAG,IAAI;CACzD,MAAM,SAAS,OAAO,KAAK,YAAY,CAAC,CAAC,SAAS,GAAG,IAAI;AAEzD,QAAO,OACJ,QAAQ,QAAQ,OAAO,KAAK,CAAC,CAC7B,QAAQ,MAAM,MAAM,CACpB,QAAQ,MAAM,IAAI,CAClB,QAAQ,MAAM,KAAK,CACnB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,OAAO;;AAG1B,SAAgB,YAAY,OAA6B;CACvD,MAAM,QAAkB,EAAE;AAC1B,OAAM,KAAK,eAAe,IAAI,KAAK,MAAM,UAAU,CAAC,CAAC;AACrD,OAAM,KAAK,MAAM,MAAM,aAAa,CAAC;AACrC,KAAI,MAAM,WAAW,MAAM,QAAQ,SAAS,EAC1C,OAAM,KAAK,MAAM,QAAQ;AAE3B,KAAI,MAAM,SAAS,OACjB,KAAI;AACF,QAAM,KAAK,KAAK,UAAU,MAAM,KAAK,CAAC;SAElC;AAER,QAAO,MAAM,KAAK,MAAM"}

package/dist/shared/utils/pagination.d.mts

@@ -0,0 +1,9 @@
+//#region src/shared/utils/pagination.d.ts
+declare function validatePaginationQuery(query: Record<string, string | string[] | undefined>): {
+  page: number;
+  limit: number;
+  name: string | undefined;
+};
+//#endregion
+export { validatePaginationQuery };
+//# sourceMappingURL=pagination.d.mts.map

package/dist/shared/utils/pagination.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.mts","names":[],"sources":["../../../src/shared/utils/pagination.ts"],"mappings":";iBAAgB,uBAAA,CAAwB,KAAA,EAAO,MAAA"}

package/dist/shared/utils/pagination.mjs

@@ -0,0 +1,12 @@
+//#region src/shared/utils/pagination.ts
+function validatePaginationQuery(query) {
+	return {
+		page: Number(Array.isArray(query.page) ? query.page[0] : query.page) || 1,
+		limit: Number(Array.isArray(query.limit) ? query.limit[0] : query.limit) || 10,
+		name: (Array.isArray(query.name) ? query.name[0] : query.name) || void 0
+	};
+}
+
+//#endregion
+export { validatePaginationQuery };
+//# sourceMappingURL=pagination.mjs.map

package/dist/shared/utils/pagination.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.mjs","names":[],"sources":["../../../src/shared/utils/pagination.ts"],"sourcesContent":["export function validatePaginationQuery(query: Record<string, string | string[] | undefined>) {\n  const page = Number(Array.isArray(query.page) ? query.page[0] : query.page) || 1\n  const limit = Number(Array.isArray(query.limit) ? query.limit[0] : query.limit) || 10\n  const name = (Array.isArray(query.name) ? query.name[0] : query.name) || undefined\n  return { page, limit, name }\n}\n"],"mappings":";AAAA,SAAgB,wBAAwB,OAAsD;AAI5F,QAAO;EAAE,MAHI,OAAO,MAAM,QAAQ,MAAM,KAAK,GAAG,MAAM,KAAK,KAAK,MAAM,KAAK,IAAI;EAGhE,OAFD,OAAO,MAAM,QAAQ,MAAM,MAAM,GAAG,MAAM,MAAM,KAAK,MAAM,MAAM,IAAI;EAE7D,OADR,MAAM,QAAQ,MAAM,KAAK,GAAG,MAAM,KAAK,KAAK,MAAM,SAAS;EAC7C"}

package/dist/shared/utils/response-template.d.mts

@@ -0,0 +1,69 @@
+//#region src/shared/utils/response-template.d.ts
+declare function Res200<T>(data: T, message?: string): {
+  code: number;
+  data: T;
+  message: string;
+};
+declare function Res201<T>(data: T, message?: string): {
+  code: number;
+  data: T;
+  message: string;
+};
+declare function Res204<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res400<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res401<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res403<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res404<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res405<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res409<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res422<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res429<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res500<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+declare function Res503<T>(data?: T | null, message?: string): {
+  code: number;
+  data: T | null;
+  message: string;
+};
+//#endregion
+export { Res200, Res201, Res204, Res400, Res401, Res403, Res404, Res405, Res409, Res422, Res429, Res500, Res503 };
+//# sourceMappingURL=response-template.d.mts.map

package/dist/shared/utils/response-template.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-template.d.mts","names":[],"sources":["../../../src/shared/utils/response-template.ts"],"mappings":";iBACgB,MAAA,GAAA,CAAU,IAAA,EAAM,CAAA,EAAG,OAAA;;QAAH,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,EAAM,CAAA,EAAG,OAAA;;QAAH,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA;;;iBAQhB,MAAA,GAAA,CAAU,IAAA,GAAM,CAAA,SAAiB,OAAA;;QAAjB,CAAA"}