@dofe/infra-shared-services 0.1.1

package/dist/file-storage/file-storage.factory.js

@@ -0,0 +1,300 @@
+"use strict";
+/**
+ * @fileoverview 文件存储客户端工厂
+ *
+ * 本文件实现了文件存储客户端的工厂模式，负责：
+ * - 根据存储供应商类型创建对应的客户端实例
+ * - 管理客户端实例的生命周期（单例模式）
+ * - 提供统一的客户端获取接口
+ *
+ * @module file-storage/factory
+ */
+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 };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageClientFactory = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const axios_1 = require("@nestjs/axios");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const infra_clients_1 = require("@dofe/infra-clients");
+const infra_redis_1 = require("@dofe/infra-redis");
+const infra_common_1 = require("@dofe/infra-common");
+const infra_contracts_1 = require("@dofe/infra-contracts");
+const infra_common_2 = require("@dofe/infra-common");
+const types_1 = require("./types");
+const environment_util_1 = __importDefault(require("@dofe/infra-utils/environment.util"));
+/**
+ * 存储供应商到客户端类的映射
+ *
+ * @description 目前支持的存储供应商客户端实现。
+ * `tencent` 和 `ksyun` 在枚举中定义但尚未实现客户端。
+ */
+const VENDOR_CLIENT_MAP = {
+    s3: infra_clients_1.FileS3Client,
+    oss: infra_clients_1.FileS3Client,
+    tos: infra_clients_1.FileTosClient,
+    us3: infra_clients_1.FileUs3Client,
+    gcs: infra_clients_1.FileGcsClient,
+    qiniu: infra_clients_1.FileQiniuClient,
+    // tencent: 尚未实现
+    // ksyun: 尚未实现
+};
+/**
+ * 文件存储客户端工厂
+ *
+ * @description 使用工厂模式管理不同存储供应商的客户端实例。
+ *
+ * 主要职责：
+ * - 根据 vendor 和 bucket 创建对应的客户端实例
+ * - 使用单例模式缓存客户端实例，避免重复创建
+ * - 统一管理存储配置和凭证
+ *
+ * 支持的存储供应商：
+ * - 's3': AWS S3 兼容存储
+ * - 'oss': 阿里云 OSS
+ * - 'tos': 火山引擎 TOS
+ * - 'us3': UCloud US3
+ * - 'gcs': Google Cloud Storage
+ * - 'qiniu': 七牛云存储
+ *
+ * @class FileStorageClientFactory
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly factory: FileStorageClientFactory) {}
+ *
+ *   async uploadFile(vendor: FileBucketVendor, bucket: string, file: Buffer) {
+ *     const client = this.factory.getClient(vendor, bucket);
+ *     await client.fileUploader(file, { key: 'path/to/file', bucket });
+ *   }
+ * }
+ * ```
+ */
+let FileStorageClientFactory = class FileStorageClientFactory {
+    redis;
+    httpService;
+    logger;
+    /**
+     * 客户端实例缓存
+     * @private
+     */
+    clients = new Map();
+    /**
+     * 存储桶配置列表
+     * @private
+     */
+    bucketConfigs;
+    /**
+     * 存储凭证配置
+     * @private
+     */
+    storageCredentials;
+    /**
+     * 应用配置
+     * @private
+     */
+    appConfig;
+    /**
+     * 默认存储供应商
+     * @private
+     */
+    defaultVendor;
+    /**
+     * 构造函数
+     *
+     * @param {ConfigService} configService - NestJS 配置服务
+     * @param {RedisService} redis - Redis 服务
+     * @param {HttpService} httpService - HTTP 服务
+     * @param {Logger} logger - Winston 日志记录器
+     */
+    constructor(configService, redis, httpService, logger) {
+        this.redis = redis;
+        this.httpService = httpService;
+        this.logger = logger;
+        // 加载配置
+        this.bucketConfigs =
+            configService.getOrThrow('buckets');
+        this.appConfig = configService.getOrThrow('app');
+        this.defaultVendor = this.appConfig.defaultVendor;
+        this.storageCredentials =
+            (0, infra_common_1.getKeysConfig)()?.storage || {};
+        // 预初始化所有配置的客户端
+        this.initializeClients();
+    }
+    /**
+     * 预初始化所有配置的存储客户端
+     *
+     * @private
+     */
+    initializeClients() {
+        for (const config of this.bucketConfigs) {
+            const vendor = config.vendor ?? this.defaultVendor;
+            try {
+                this.createClient(vendor, config);
+            }
+            catch (error) {
+                this.logger.error('Failed to initialize storage client', {
+                    vendor,
+                    bucket: config.bucket,
+                    error: error.message,
+                });
+            }
+        }
+        if (environment_util_1.default.isProduction()) {
+            this.logger.info('FileStorageClientFactory module initialized', {
+                clientCount: this.clients.size,
+                vendors: [...new Set(this.bucketConfigs.map((c) => c.vendor))],
+            });
+        }
+    }
+    /**
+     * 创建存储客户端实例
+     *
+     * @private
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {PardxUploader.Config} config - 存储桶配置
+     * @returns {FileStorageInterface} 客户端实例
+     * @throws {Error} 不支持的供应商类型时抛出异常
+     */
+    createClient(vendor, config) {
+        const ClientClass = VENDOR_CLIENT_MAP[vendor];
+        if (!ClientClass) {
+            throw (0, infra_common_2.apiError)(infra_contracts_1.CommonErrorCode.FileServiceUnsupportedVendor);
+        }
+        const storageConfig = this.storageCredentials[vendor];
+        if (!storageConfig) {
+            throw (0, infra_common_2.apiError)(infra_contracts_1.CommonErrorCode.FileServiceUnsupportedVendor);
+        }
+        const client = new ClientClass(config, storageConfig, this.appConfig, this.redis, this.httpService, this.logger);
+        // 缓存客户端
+        const key = (0, types_1.buildStorageClientKey)(vendor, config.bucket);
+        this.clients.set(key, client);
+        return client;
+    }
+    /**
+     * 获取存储客户端
+     *
+     * @description 根据供应商和存储桶获取对应的客户端实例。
+     * 如果客户端不存在，将返回 undefined。
+     *
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {string} bucket - 存储桶名称
+     * @returns {FileStorageInterface | undefined} 客户端实例或 undefined
+     *
+     * @example
+     * ```typescript
+     * const client = factory.getClient('oss', 'my-bucket');
+     * if (client) {
+     *   await client.uploadFile('/path/to/file', 'key', 'my-bucket');
+     * }
+     * ```
+     */
+    getClient(vendor, bucket) {
+        const key = (0, types_1.buildStorageClientKey)(vendor, bucket);
+        return this.clients.get(key);
+    }
+    /**
+     * 获取存储客户端（必须存在）
+     *
+     * @description 获取客户端实例，如果不存在则抛出异常。
+     *
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {string} bucket - 存储桶名称
+     * @returns {FileStorageInterface} 客户端实例
+     * @throws {Error} 客户端不存在时抛出异常
+     *
+     * @example
+     * ```typescript
+     * const client = factory.getClientOrThrow('oss', 'my-bucket');
+     * await client.uploadFile('/path/to/file', 'key', 'my-bucket');
+     * ```
+     */
+    getClientOrThrow(vendor, bucket) {
+        const client = this.getClient(vendor, bucket);
+        if (!client) {
+            throw new Error(`File storage client not found for vendor: ${vendor}, bucket: ${bucket}`);
+        }
+        return client;
+    }
+    /**
+     * 检查客户端是否存在
+     *
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {string} bucket - 存储桶名称
+     * @returns {boolean} 是否存在
+     */
+    hasClient(vendor, bucket) {
+        const key = (0, types_1.buildStorageClientKey)(vendor, bucket);
+        return this.clients.has(key);
+    }
+    /**
+     * 获取存储桶配置
+     *
+     * @param {FileBucketVendor} vendor - 存储供应商
+     * @param {string} bucket - 存储桶名称
+     * @returns {PardxUploader.Config | undefined} 存储桶配置
+     */
+    getBucketConfig(vendor, bucket) {
+        return this.bucketConfigs.find((config) => config.bucket === bucket &&
+            (config.vendor ?? this.defaultVendor) === vendor);
+    }
+    /**
+     * 获取所有存储桶配置
+     *
+     * @returns {PardxUploader.Config[]} 存储桶配置列表
+     */
+    getAllBucketConfigs() {
+        return [...this.bucketConfigs];
+    }
+    /**
+     * 获取默认存储供应商
+     *
+     * @returns {FileBucketVendor} 默认供应商
+     */
+    getDefaultVendor() {
+        return this.defaultVendor;
+    }
+    /**
+     * 获取应用配置
+     *
+     * @returns {AppConfig} 应用配置
+     */
+    getAppConfig() {
+        return this.appConfig;
+    }
+    /**
+     * 获取所有已初始化的客户端键
+     *
+     * @returns {StorageClientKey[]} 客户端键列表
+     */
+    getClientKeys() {
+        return [...this.clients.keys()];
+    }
+};
+exports.FileStorageClientFactory = FileStorageClientFactory;
+exports.FileStorageClientFactory = FileStorageClientFactory = __decorate([
+    (0, common_1.Injectable)(),
+    __param(3, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [config_1.ConfigService,
+        infra_redis_1.RedisService,
+        axios_1.HttpService,
+        winston_1.Logger])
+], FileStorageClientFactory);
+//# sourceMappingURL=file-storage.factory.js.map

package/dist/file-storage/file-storage.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.factory.js","sourceRoot":"","sources":["../../src/file-storage/file-storage.factory.ts"],"names":[],"mappings":"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"}

package/dist/file-storage/file-storage.module.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview 文件存储服务模块
+ *
+ * 本模块提供文件存储服务的 NestJS 模块配置，整合了：
+ * - FileStorageService: 文件存储服务门面
+ * - FileStorageClientFactory: 客户端工厂
+ * - BucketResolver: 存储桶解析器
+ *
+ * @module file-storage/module
+ */
+/**
+ * 文件存储服务模块
+ *
+ * @description 提供文件存储服务的依赖注入配置。
+ *
+ * 导出服务：
+ * - `FileStorageService`: 文件存储服务统一入口
+ * - `FileStorageClientFactory`: 客户端工厂（可选，用于高级场景）
+ * - `BucketResolver`: 存储桶解析器（可选，用于高级场景）
+ *
+ * 依赖模块：
+ * - `ConfigModule`: 配置服务
+ * - `HttpModule`: HTTP 客户端
+ * - `RedisModule`: Redis 缓存
+ * - `IpGeoModule`: IP 地理位置服务（用于区域感知，纯 infra 层）
+ *
+ * @example
+ * ```typescript
+ * // 在其他模块中导入
+ * @Module({
+ *   imports: [FileStorageServiceModule],
+ * })
+ * export class VideoModule {}
+ *
+ * // 在服务中使用
+ * @Injectable()
+ * class VideoService {
+ *   constructor(private readonly fileStorage: FileStorageService) {}
+ *
+ *   async upload(file: Buffer, key: string) {
+ *     const client = await this.fileStorage.getFileClient('oss', 'my-bucket');
+ *     await client.fileUploader(file, { key, bucket: 'my-bucket' });
+ *   }
+ * }
+ * ```
+ */
+export declare class FileStorageServiceModule {
+}
+//# sourceMappingURL=file-storage.module.d.ts.map

package/dist/file-storage/file-storage.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.module.d.ts","sourceRoot":"","sources":["../../src/file-storage/file-storage.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAKa,wBAAwB;CAAG"}

package/dist/file-storage/file-storage.module.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * @fileoverview 文件存储服务模块
+ *
+ * 本模块提供文件存储服务的 NestJS 模块配置，整合了：
+ * - FileStorageService: 文件存储服务门面
+ * - FileStorageClientFactory: 客户端工厂
+ * - BucketResolver: 存储桶解析器
+ *
+ * @module file-storage/module
+ */
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageServiceModule = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const axios_1 = require("@nestjs/axios");
+const infra_shared_services_1 = require("@dofe/infra-shared-services");
+const infra_redis_1 = require("@dofe/infra-redis");
+const file_storage_service_1 = require("./file-storage.service");
+const file_storage_factory_1 = require("./file-storage.factory");
+const bucket_resolver_1 = require("./bucket-resolver");
+/**
+ * 文件存储服务模块
+ *
+ * @description 提供文件存储服务的依赖注入配置。
+ *
+ * 导出服务：
+ * - `FileStorageService`: 文件存储服务统一入口
+ * - `FileStorageClientFactory`: 客户端工厂（可选，用于高级场景）
+ * - `BucketResolver`: 存储桶解析器（可选，用于高级场景）
+ *
+ * 依赖模块：
+ * - `ConfigModule`: 配置服务
+ * - `HttpModule`: HTTP 客户端
+ * - `RedisModule`: Redis 缓存
+ * - `IpGeoModule`: IP 地理位置服务（用于区域感知，纯 infra 层）
+ *
+ * @example
+ * ```typescript
+ * // 在其他模块中导入
+ * @Module({
+ *   imports: [FileStorageServiceModule],
+ * })
+ * export class VideoModule {}
+ *
+ * // 在服务中使用
+ * @Injectable()
+ * class VideoService {
+ *   constructor(private readonly fileStorage: FileStorageService) {}
+ *
+ *   async upload(file: Buffer, key: string) {
+ *     const client = await this.fileStorage.getFileClient('oss', 'my-bucket');
+ *     await client.fileUploader(file, { key, bucket: 'my-bucket' });
+ *   }
+ * }
+ * ```
+ */
+let FileStorageServiceModule = class FileStorageServiceModule {
+};
+exports.FileStorageServiceModule = FileStorageServiceModule;
+exports.FileStorageServiceModule = FileStorageServiceModule = __decorate([
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule, infra_redis_1.RedisModule, infra_shared_services_1.IpGeoModule, axios_1.HttpModule],
+        providers: [bucket_resolver_1.BucketResolver, file_storage_factory_1.FileStorageClientFactory, file_storage_service_1.FileStorageService],
+        exports: [file_storage_service_1.FileStorageService, file_storage_factory_1.FileStorageClientFactory, bucket_resolver_1.BucketResolver],
+    })
+], FileStorageServiceModule);
+//# sourceMappingURL=file-storage.module.js.map

package/dist/file-storage/file-storage.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.module.js","sourceRoot":"","sources":["../../src/file-storage/file-storage.module.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;AAEH,2CAAwC;AACxC,2CAA8C;AAC9C,yCAA2C;AAC3C,uEAA0D;AAC1D,mDAAgD;AAChD,iEAA4D;AAC5D,iEAAkE;AAClE,uDAAmD;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAMI,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;CAAG,CAAA;AAA3B,4DAAwB;mCAAxB,wBAAwB;IALpC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAY,EAAE,yBAAW,EAAE,mCAAW,EAAE,kBAAU,CAAC;QAC7D,SAAS,EAAE,CAAC,gCAAc,EAAE,+CAAwB,EAAE,yCAAkB,CAAC;QACzE,OAAO,EAAE,CAAC,yCAAkB,EAAE,+CAAwB,EAAE,gCAAc,CAAC;KACxE,CAAC;GACW,wBAAwB,CAAG"}