yingzios-platform-backend-shared 1.0.1

package/README.md

@@ -0,0 +1,51 @@
+# yz-web-server-shared
+
+NestJS 共享模块库，为 YingziOS 平台提供统一的服务端基础设施。
+
+## 功能模块
+
+- **Sequelize** - 数据库 ORM 模块
+- **JWT** - JSON Web Token 认证
+- **Swagger** - API 文档生成
+- **Logger** - 日志服务（基于 Winston）
+- **Apollo** - Apollo 配置中心客户端
+- **Nacos** - Nacos 服务发现与配置
+- **Snowflake** - 分布式 ID 生成器
+- **Cache** - 缓存服务（支持 Redis/SQLite）
+- **Env** - 环境变量管理
+- **RESTful** - RESTful API 工具
+
+## 安装
+
+```bash
+pnpm add yz-web-server-shared
+```
+
+## 使用示例
+
+```typescript
+import { SequelizeModule } from 'yz-web-server-shared/sequelize';
+import { JwtModule } from 'yz-web-server-shared/jwt';
+
+@Module({
+  imports: [
+    SequelizeModule.forRoot({
+      // 配置选项
+    }),
+    JwtModule.register({
+      // JWT 配置
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+## 依赖要求
+
+- Node.js >= 18
+- NestJS >= 11
+- TypeScript >= 5
+
+## License
+
+MIT

package/dist/apollo/apollo.config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Apollo配置接口
+ */
+export interface ApolloConfig {
+    /**
+     * Apollo服务地址
+     */
+    host?: string;
+    /**
+     * 应用ID
+     */
+    appId?: string;
+    /**
+     * 集群名称
+     */
+    clusterName?: string;
+    /**
+     * 命名空间
+     */
+    namespaces?: string[];
+    /**
+     * Apollo访问密钥
+     */
+    secret?: string;
+}
+//# sourceMappingURL=apollo.config.d.ts.map

package/dist/apollo/apollo.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apollo.config.d.ts","sourceRoot":"","sources":["../../src/apollo/apollo.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/apollo/apollo.config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/apollo/apollo.module.d.ts

@@ -0,0 +1,13 @@
+import { DynamicModule } from '@nestjs/common';
+import { ApolloConfig } from './apollo.config';
+/**
+ * Apollo模块
+ */
+export declare class ApolloModule {
+    /**
+     * 静态方法：配置Apollo模块
+     * 用于根模块注册
+     */
+    static forRoot(config: ApolloConfig): DynamicModule;
+}
+//# sourceMappingURL=apollo.module.d.ts.map

package/dist/apollo/apollo.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apollo.module.d.ts","sourceRoot":"","sources":["../../src/apollo/apollo.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;GAEG;AACH,qBAEa,YAAY;IACvB;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa;CAuCpD"}

package/dist/apollo/apollo.module.js

@@ -0,0 +1,61 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var ApolloModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApolloModule = void 0;
+const common_1 = require("@nestjs/common");
+const apollo_service_1 = require("./apollo.service");
+const apollo_client_1 = require("@vodyani/apollo-client");
+/**
+ * Apollo模块
+ */
+let ApolloModule = ApolloModule_1 = class ApolloModule {
+    /**
+     * 静态方法：配置Apollo模块
+     * 用于根模块注册
+     */
+    static forRoot(config) {
+        const apolloClient = new apollo_client_1.ApolloHttpClient({
+            appId: config.appId,
+            configServerUrl: config.host,
+            clusterName: config.clusterName,
+            secret: config.secret,
+        });
+        const namespaces = config.namespaces || ['application'];
+        return {
+            module: ApolloModule_1,
+            providers: [
+                {
+                    provide: 'APOLLO_NAMESPACE_CONFIGS',
+                    useFactory: async () => {
+                        const configs = {};
+                        const promises = namespaces.map(async (namespace) => {
+                            const config = await apolloClient.getConfigByCache(namespace, 'properties');
+                            return { namespace, config };
+                        });
+                        const results = await Promise.all(promises);
+                        results.forEach(({ namespace, config }) => {
+                            configs[namespace] = config;
+                        });
+                        return configs;
+                    },
+                },
+                {
+                    provide: 'APOLLO_SERVICE',
+                    useClass: apollo_service_1.ApolloService,
+                },
+            ],
+            exports: ['APOLLO_SERVICE'],
+        };
+    }
+};
+exports.ApolloModule = ApolloModule;
+exports.ApolloModule = ApolloModule = ApolloModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], ApolloModule);

package/dist/apollo/apollo.service.d.ts

@@ -0,0 +1,17 @@
+export interface IApolloService {
+    getConfig(namespace: string): Record<string, any>;
+}
+/**
+ * Apollo服务
+ * 实现与携程Apollo配置中心的对接
+ */
+export declare class ApolloService implements IApolloService {
+    protected readonly configs: {
+        [key: string]: Record<string, any>;
+    };
+    constructor(configs: {
+        [key: string]: Record<string, any>;
+    });
+    getConfig(namespace: string): Record<string, any>;
+}
+//# sourceMappingURL=apollo.service.d.ts.map

package/dist/apollo/apollo.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apollo.service.d.ts","sourceRoot":"","sources":["../../src/apollo/apollo.service.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,qBACa,aAAc,YAAW,cAAc;IAGhD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE;gBAA/C,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE;IAGpE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGlD"}

package/dist/apollo/apollo.service.js

@@ -0,0 +1,35 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApolloService = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Apollo服务
+ * 实现与携程Apollo配置中心的对接
+ */
+let ApolloService = class ApolloService {
+    configs;
+    constructor(configs) {
+        this.configs = configs;
+    }
+    getConfig(namespace) {
+        return this.configs[namespace];
+    }
+};
+exports.ApolloService = ApolloService;
+exports.ApolloService = ApolloService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('APOLLO_NAMESPACE_CONFIGS')),
+    __metadata("design:paramtypes", [Object])
+], ApolloService);

package/dist/apollo/index.d.ts

@@ -0,0 +1,5 @@
+export * from './apollo.module';
+import { ApolloConfig } from './apollo.config';
+import { IApolloService } from './apollo.service';
+export type { ApolloConfig, IApolloService };
+//# sourceMappingURL=index.d.ts.map

package/dist/apollo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/apollo/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/apollo/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./apollo.module"), exports);

package/dist/cache/cache.config.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cache 模块配置接口
+ */
+export interface ICacheConfig {
+    /**
+     * 缓存驱动类型
+     * - memory: 内存存储（临时测试用，Pod 重启后数据丢失）
+     * - sqlite: 本地 SQLite 文件存储（开发环境推荐）
+     * - redis: Redis 存储（生产环境推荐）
+     */
+    driver: 'memory' | 'sqlite' | 'redis';
+    /**
+     * SQLite 配置（driver = 'sqlite' 时有效）
+     * 数据库文件路径，如 './cache.db'
+     */
+    sqlitePath?: string;
+    /**
+     * Redis 配置（driver = 'redis' 时有效）
+     * Redis 连接 URL，如 'redis://localhost:6379'
+     */
+    redisUrl?: string;
+    /**
+     * 命名空间，用于隔离不同应用的缓存
+     * 默认: 'cache'
+     */
+    namespace?: string;
+}
+//# sourceMappingURL=cache.config.d.ts.map

package/dist/cache/cache.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.config.d.ts","sourceRoot":"","sources":["../../src/cache/cache.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEtC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/cache/cache.config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cache/cache.module.d.ts

@@ -0,0 +1,39 @@
+import { DynamicModule } from '@nestjs/common';
+import type { ICacheConfig } from './cache.config';
+/**
+ * 缓存模块
+ * 提供统一的 KV 缓存能力，支持 SQLite（本地开发）和 Redis（生产环境）
+ *
+ * @example
+ * ```typescript
+ * // 静态配置
+ * CacheModule.forRoot({
+ *   driver: 'sqlite',
+ *   sqlitePath: './cache.db',
+ * })
+ *
+ * // 异步配置
+ * CacheModule.forRootAsync({
+ *   useFactory: (envService: EnvService) => ({
+ *     driver: envService.getItem('CACHE_DRIVER') as 'sqlite' | 'redis',
+ *     sqlitePath: envService.getItem('CACHE_SQLITE_PATH'),
+ *     redisUrl: envService.getItem('REDIS_URL'),
+ *   }),
+ *   inject: [EnvService],
+ * })
+ * ```
+ */
+export declare class CacheModule {
+    /**
+     * 静态配置
+     */
+    static forRoot(config: ICacheConfig): DynamicModule;
+    /**
+     * 异步配置
+     */
+    static forRootAsync(options: {
+        useFactory: (...args: any[]) => Promise<ICacheConfig> | ICacheConfig;
+        inject?: any[];
+    }): DynamicModule;
+}
+//# sourceMappingURL=cache.module.d.ts.map

package/dist/cache/cache.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.module.d.ts","sourceRoot":"","sources":["../../src/cache/cache.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAEa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa;IAcnD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;QACrE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;KAChB,GAAG,aAAa;CAclB"}

package/dist/cache/cache.module.js

@@ -0,0 +1,75 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var CacheModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheModule = void 0;
+const common_1 = require("@nestjs/common");
+const cache_service_1 = require("./cache.service");
+/**
+ * 缓存模块
+ * 提供统一的 KV 缓存能力，支持 SQLite（本地开发）和 Redis（生产环境）
+ *
+ * @example
+ * ```typescript
+ * // 静态配置
+ * CacheModule.forRoot({
+ *   driver: 'sqlite',
+ *   sqlitePath: './cache.db',
+ * })
+ *
+ * // 异步配置
+ * CacheModule.forRootAsync({
+ *   useFactory: (envService: EnvService) => ({
+ *     driver: envService.getItem('CACHE_DRIVER') as 'sqlite' | 'redis',
+ *     sqlitePath: envService.getItem('CACHE_SQLITE_PATH'),
+ *     redisUrl: envService.getItem('REDIS_URL'),
+ *   }),
+ *   inject: [EnvService],
+ * })
+ * ```
+ */
+let CacheModule = CacheModule_1 = class CacheModule {
+    /**
+     * 静态配置
+     */
+    static forRoot(config) {
+        return {
+            module: CacheModule_1,
+            providers: [
+                {
+                    provide: 'CACHE_CONFIG',
+                    useValue: config,
+                },
+                cache_service_1.CacheService,
+            ],
+            exports: [cache_service_1.CacheService],
+        };
+    }
+    /**
+     * 异步配置
+     */
+    static forRootAsync(options) {
+        return {
+            module: CacheModule_1,
+            providers: [
+                {
+                    provide: 'CACHE_CONFIG',
+                    useFactory: options.useFactory,
+                    inject: options.inject || [],
+                },
+                cache_service_1.CacheService,
+            ],
+            exports: [cache_service_1.CacheService],
+        };
+    }
+};
+exports.CacheModule = CacheModule;
+exports.CacheModule = CacheModule = CacheModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], CacheModule);

package/dist/cache/cache.service.d.ts

@@ -0,0 +1,49 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import type { ICacheConfig } from './cache.config';
+/**
+ * 缓存服务
+ * 提供统一的 KV 缓存接口，支持 SQLite（本地开发）和 Redis（生产环境）
+ */
+export declare class CacheService implements OnModuleDestroy {
+    private readonly config;
+    private keyv;
+    private readonly logger;
+    constructor(config: ICacheConfig);
+    /**
+     * 根据配置创建 Keyv 实例
+     */
+    private createKeyvInstance;
+    /**
+     * 设置缓存
+     * @param key 缓存键
+     * @param value 缓存值
+     * @param ttl 过期时间（毫秒），不传则永不过期
+     */
+    set<T = any>(key: string, value: T, ttl?: number): Promise<boolean>;
+    /**
+     * 获取缓存
+     * @param key 缓存键
+     * @returns 缓存值，不存在或已过期返回 undefined
+     */
+    get<T = any>(key: string): Promise<T | undefined>;
+    /**
+     * 删除缓存
+     * @param key 缓存键
+     * @returns 是否删除成功
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * 检查缓存是否存在
+     * @param key 缓存键
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 清空当前命名空间下的所有缓存
+     */
+    clear(): Promise<void>;
+    /**
+     * 断开连接（模块销毁时调用）
+     */
+    onModuleDestroy(): Promise<void>;
+}
+//# sourceMappingURL=cache.service.d.ts.map

package/dist/cache/cache.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.service.d.ts","sourceRoot":"","sources":["../../src/cache/cache.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAU,MAAM,gBAAgB,CAAC;AAK7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA6HnD;;;GAGG;AACH,qBACa,YAAa,YAAW,eAAe;IAMhD,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;gBAIrC,MAAM,EAAE,YAAY;IAKvC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;;;;OAKG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE;;;;OAIG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAIvD;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3C;;;OAGG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC"}

package/dist/cache/cache.service.js

@@ -0,0 +1,208 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var CacheService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheService = void 0;
+const common_1 = require("@nestjs/common");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_sqlite_1 = require("node:sqlite");
+const keyv_1 = __importDefault(require("keyv"));
+class SqliteBackedStore {
+    logger = new common_1.Logger(SqliteBackedStore.name);
+    db;
+    constructor(sqlitePath) {
+        const resolvedPath = node_path_1.default.resolve(process.cwd(), sqlitePath);
+        (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(resolvedPath), { recursive: true });
+        this.db = new node_sqlite_1.DatabaseSync(resolvedPath, {
+            timeout: 5000,
+            enableForeignKeyConstraints: true,
+        });
+        this.db.exec(`
+      PRAGMA journal_mode = WAL;
+      PRAGMA synchronous = NORMAL;
+      CREATE TABLE IF NOT EXISTS keyv_cache (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        expires_at INTEGER
+      );
+      CREATE INDEX IF NOT EXISTS idx_keyv_cache_expires_at
+      ON keyv_cache(expires_at);
+    `);
+        this.logger.log(`使用 node:sqlite 缓存: ${resolvedPath}`);
+    }
+    shouldTraceKey(key) {
+        return key.startsWith('portal:auth:');
+    }
+    async get(key) {
+        this.cleanupExpired(key);
+        const row = this.db
+            .prepare('SELECT value FROM keyv_cache WHERE key = ?')
+            .get(key);
+        if (!row) {
+            if (this.shouldTraceKey(key)) {
+                this.logger.debug(`[cache:get:miss] key=${key}`);
+            }
+            return undefined;
+        }
+        if (this.shouldTraceKey(key)) {
+            this.logger.debug(`[cache:get:hit] key=${key}`);
+        }
+        return JSON.parse(row.value);
+    }
+    async set(key, value, ttl) {
+        const expiresAt = ttl ? Date.now() + ttl : null;
+        this.db
+            .prepare(`
+        INSERT INTO keyv_cache (key, value, expires_at)
+        VALUES (?, ?, ?)
+        ON CONFLICT(key) DO UPDATE SET
+          value = excluded.value,
+          expires_at = excluded.expires_at
+      `)
+            .run(key, JSON.stringify(value), expiresAt);
+        if (this.shouldTraceKey(key)) {
+            this.logger.debug(`[cache:set] key=${key} ttlMs=${ttl ?? 'none'} expiresAt=${expiresAt ?? 'none'}`);
+        }
+        return true;
+    }
+    async delete(key) {
+        const result = this.db
+            .prepare('DELETE FROM keyv_cache WHERE key = ?')
+            .run(key);
+        if (this.shouldTraceKey(key)) {
+            this.logger.debug(`[cache:delete] key=${key} deleted=${Number(result.changes) > 0}`);
+        }
+        return Number(result.changes) > 0;
+    }
+    async clear() {
+        this.db.exec('DELETE FROM keyv_cache');
+        this.logger.warn('[cache:clear] 已清空整个 sqlite 缓存表 keyv_cache');
+    }
+    async has(key) {
+        return (await this.get(key)) !== undefined;
+    }
+    async disconnect() {
+        if (this.db.isOpen) {
+            this.db.close();
+        }
+    }
+    cleanupExpired(key) {
+        const now = Date.now();
+        if (key) {
+            this.db
+                .prepare('DELETE FROM keyv_cache WHERE key = ? AND expires_at IS NOT NULL AND expires_at <= ?')
+                .run(key, now);
+            return;
+        }
+        this.db
+            .prepare('DELETE FROM keyv_cache WHERE expires_at IS NOT NULL AND expires_at <= ?')
+            .run(now);
+    }
+}
+/**
+ * 缓存服务
+ * 提供统一的 KV 缓存接口，支持 SQLite（本地开发）和 Redis（生产环境）
+ */
+let CacheService = CacheService_1 = class CacheService {
+    config;
+    keyv;
+    logger = new common_1.Logger(CacheService_1.name);
+    constructor(config) {
+        this.config = config;
+        this.keyv = this.createKeyvInstance();
+    }
+    /**
+     * 根据配置创建 Keyv 实例
+     */
+    createKeyvInstance() {
+        const namespace = this.config.namespace || 'cache';
+        // 内存缓存 - 临时测试用，Pod 重启后数据丢失
+        if (this.config.driver === 'memory') {
+            this.logger.log(`使用内存缓存 (namespace=${namespace}) - 警告: Pod 重启后数据将丢失`);
+            return new keyv_1.default({ namespace });
+        }
+        if (this.config.driver === 'redis') {
+            try {
+                // Redis 驱动需要动态导入
+                const KeyvRedis = require('@keyv/redis').default;
+                const store = new KeyvRedis(this.config.redisUrl || 'redis://localhost:6379');
+                this.logger.log(`使用 Redis 缓存: ${this.config.redisUrl}`);
+                return new keyv_1.default({ store, namespace });
+            }
+            catch (err) {
+                this.logger.warn(`Redis 驱动加载失败，回退到内存缓存: ${err.message}`);
+                return new keyv_1.default({ namespace });
+            }
+        }
+        const sqlitePath = this.config.sqlitePath || './cache/cache.db';
+        return new keyv_1.default({
+            store: new SqliteBackedStore(sqlitePath),
+            namespace,
+        });
+    }
+    /**
+     * 设置缓存
+     * @param key 缓存键
+     * @param value 缓存值
+     * @param ttl 过期时间（毫秒），不传则永不过期
+     */
+    async set(key, value, ttl) {
+        return this.keyv.set(key, value, ttl);
+    }
+    /**
+     * 获取缓存
+     * @param key 缓存键
+     * @returns 缓存值，不存在或已过期返回 undefined
+     */
+    async get(key) {
+        return this.keyv.get(key);
+    }
+    /**
+     * 删除缓存
+     * @param key 缓存键
+     * @returns 是否删除成功
+     */
+    async delete(key) {
+        return this.keyv.delete(key);
+    }
+    /**
+     * 检查缓存是否存在
+     * @param key 缓存键
+     */
+    async has(key) {
+        return this.keyv.has(key);
+    }
+    /**
+     * 清空当前命名空间下的所有缓存
+     */
+    async clear() {
+        return this.keyv.clear();
+    }
+    /**
+     * 断开连接（模块销毁时调用）
+     */
+    async onModuleDestroy() {
+        await this.keyv.disconnect();
+    }
+};
+exports.CacheService = CacheService;
+exports.CacheService = CacheService = CacheService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('CACHE_CONFIG')),
+    __metadata("design:paramtypes", [Object])
+], CacheService);

package/dist/cache/index.d.ts

@@ -0,0 +1,4 @@
+export * from './cache.config';
+export * from './cache.service';
+export * from './cache.module';
+//# sourceMappingURL=index.d.ts.map