@dofe/infra-shared-services 0.1.1

package/dist/ocr/ocr.service.js

@@ -0,0 +1,214 @@
+"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.OcrService = void 0;
+/**
+ * OCR Service
+ *
+ * 职责：通过 AgentX 任务 API 调用 OCR 服务
+ * - 使用 agent_x.tasks.ocr.ocr_parse_task 进行单文件 OCR
+ * - 使用 agent_x.tasks.ocr.ocr_parse_batch_task 进行批量 OCR
+ * - 支持同步等待和回调两种模式
+ */
+const common_1 = require("@nestjs/common");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const infra_clients_1 = require("@dofe/infra-clients");
+/** OCR 任务名称 */
+const OCR_PARSE_TASK = 'agent_x.tasks.ocr.ocr_parse_task';
+const OCR_PARSE_BATCH_TASK = 'agent_x.tasks.ocr.ocr_parse_batch_task';
+/**
+ * OCR 服务
+ *
+ * 封装与 Python OCR 服务的交互，通过 AgentX 任务队列执行
+ *
+ * @example
+ * ```typescript
+ * // 注入服务
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly ocrService: OcrService) {}
+ *
+ *   async extractText(fileUrl: string) {
+ *     const result = await this.ocrService.extractText(fileUrl, 'pdf');
+ *     return result.text;
+ *   }
+ * }
+ * ```
+ */
+let OcrService = class OcrService {
+    logger;
+    agentxClient;
+    constructor(logger, agentxClient) {
+        this.logger = logger;
+        this.agentxClient = agentxClient;
+    }
+    /**
+     * 提取文件文本内容
+     *
+     * 流程：
+     * 1. 创建 OCR 任务
+     * 2. 等待任务完成（使用 SSE 或轮询）
+     * 3. 返回提取的文本
+     *
+     * @param fileUrl 文件 URL (必须是可访问的 URL)
+     * @param fileType 文件类型 (pdf, docx, doc, png, jpg, jpeg, etc.)
+     * @param options 可选参数
+     */
+    async extractText(fileUrl, fileType, options) {
+        this.logger.info('创建 OCR 任务', {
+            fileUrl: fileUrl.substring(0, 100),
+            fileType,
+            mode: options?.mode || 'basic',
+        });
+        try {
+            // 1. 构建任务参数
+            const taskParams = {
+                file_url: fileUrl,
+                mode: options?.mode || 'basic',
+                enable_cache: options?.enable_cache ?? true,
+            };
+            if (options?.custom_prompt) {
+                taskParams.custom_prompt = options.custom_prompt;
+            }
+            // 2. 创建 OCR 任务
+            const taskId = await this.agentxClient.createTask({
+                name: OCR_PARSE_TASK,
+                params: taskParams,
+            });
+            this.logger.info('OCR 任务已创建，等待完成', {
+                taskId,
+                taskName: OCR_PARSE_TASK,
+            });
+            // 3. 等待任务完成（使用 AgentX 的 SSE 或轮询）
+            const status = await this.agentxClient.monitorTaskWithSSE(taskId);
+            // 4. 检查任务结果
+            if (status.state !== 'SUCCESS' || !status.result) {
+                throw new Error(status.error || 'OCR task failed');
+            }
+            // AgentX 返回的结果是嵌套结构: status.result.result
+            const taskResult = status.result;
+            const result = taskResult.result || taskResult;
+            // 5. 转换结果格式
+            const ocrResult = {
+                text: result.raw_text || result.text || '',
+                confidence: result.confidence || 0,
+                fileType: fileType,
+                processingTime: result.processing_time,
+            };
+            if (result.pages && options?.extractPages) {
+                ocrResult.pages = result.pages.map((p) => ({
+                    pageNumber: p.pageNumber,
+                    text: p.text,
+                }));
+            }
+            this.logger.info('OCR 任务完成', {
+                taskId,
+                textLength: ocrResult.text.length,
+                confidence: ocrResult.confidence,
+            });
+            return ocrResult;
+        }
+        catch (error) {
+            this.logger.error('OCR 文本提取失败', {
+                fileUrl: fileUrl.substring(0, 100),
+                fileType,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            throw new Error(`OCR extraction failed: ${error.message}`);
+        }
+    }
+    /**
+     * 批量提取文件文本
+     *
+     * @param files 文件列表
+     * @param options 可选参数
+     */
+    async extractTextBatch(files, options) {
+        this.logger.info('创建批量 OCR 任务', {
+            fileCount: files.length,
+            mode: options?.mode || 'basic',
+        });
+        try {
+            // 1. 构建批量任务参数
+            const taskParams = {
+                file_urls: files.map((f) => f.fileUrl),
+                mode: options?.mode || 'basic',
+                enable_cache: true,
+                max_parallel: options?.max_parallel || 3,
+            };
+            // 2. 创建批量 OCR 任务
+            const taskId = await this.agentxClient.createTask({
+                name: OCR_PARSE_BATCH_TASK,
+                params: taskParams,
+            });
+            this.logger.info('批量 OCR 任务已创建，等待完成', {
+                taskId,
+                fileCount: files.length,
+            });
+            // 3. 等待任务完成
+            const status = await this.agentxClient.monitorTaskWithSSE(taskId);
+            // 4. 检查任务结果
+            if (status.state !== 'SUCCESS' || !status.result) {
+                throw new Error(status.error || 'Batch OCR task failed');
+            }
+            // AgentX 返回的结果是嵌套结构: status.result.result
+            const taskResult = status.result;
+            const rawResults = taskResult.result || taskResult;
+            // 批量任务结果是一个数组
+            const results = Array.isArray(rawResults)
+                ? rawResults
+                : [rawResults];
+            this.logger.info('批量 OCR 任务完成', {
+                taskId,
+                resultCount: results.length,
+            });
+            // 5. 转换结果格式
+            return results.map((result, index) => {
+                if ('error' in result) {
+                    return {
+                        error: result.error,
+                        fileUrl: files[index].fileUrl,
+                    };
+                }
+                return {
+                    text: result.raw_text || result.text || '',
+                    confidence: result.confidence || 0,
+                    fileType: files[index].fileType,
+                };
+            });
+        }
+        catch (error) {
+            this.logger.error('批量 OCR 文本提取失败', {
+                fileCount: files.length,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            throw new Error(`OCR batch extraction failed: ${error.message}`);
+        }
+    }
+    /**
+     * 检查 OCR 服务健康状态
+     */
+    async healthCheck() {
+        return this.agentxClient.healthCheck();
+    }
+};
+exports.OcrService = OcrService;
+exports.OcrService = OcrService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [winston_1.Logger,
+        infra_clients_1.AgentXClient])
+], OcrService);
+//# sourceMappingURL=ocr.service.js.map

package/dist/ocr/ocr.service.js.map

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

package/dist/sms/index.d.ts

@@ -0,0 +1,5 @@
+export { SmsServiceModule } from './sms.module';
+export { SmsService } from './sms.service';
+export { SmsClientFactory } from './sms.factory';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sms/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,cAAc,SAAS,CAAC"}

package/dist/sms/index.js

@@ -0,0 +1,29 @@
+"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 });
+exports.SmsClientFactory = exports.SmsService = exports.SmsServiceModule = void 0;
+// Module
+var sms_module_1 = require("./sms.module");
+Object.defineProperty(exports, "SmsServiceModule", { enumerable: true, get: function () { return sms_module_1.SmsServiceModule; } });
+// Service
+var sms_service_1 = require("./sms.service");
+Object.defineProperty(exports, "SmsService", { enumerable: true, get: function () { return sms_service_1.SmsService; } });
+// Factory
+var sms_factory_1 = require("./sms.factory");
+Object.defineProperty(exports, "SmsClientFactory", { enumerable: true, get: function () { return sms_factory_1.SmsClientFactory; } });
+// Types (从 types.ts 导出，包含来自 @dofe/infra-clients 的 re-exports)
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/sms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sms/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS;AACT,2CAAgD;AAAvC,8GAAA,gBAAgB,OAAA;AAEzB,UAAU;AACV,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAEnB,UAAU;AACV,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AAEzB,8DAA8D;AAC9D,0CAAwB"}

package/dist/sms/sms.factory.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @fileoverview SMS Client Factory
+ * @module @app/shared-services/sms/sms.factory
+ *
+ * 负责创建和管理 SMS 客户端实例
+ *
+ * 功能：
+ * - 根据供应商类型创建对应的 SMS 客户端
+ * - 管理模板配置
+ * - 提供统一的客户端访问接口
+ *
+ * @example
+ * ```typescript
+ * const factory = new SmsClientFactory(
+ *   { logger, httpService, redis },
+ *   { defaultVendor: 'volcengine', providers: [...] }
+ * );
+ *
+ * // 发送短信
+ * await factory.sendSmsCode('13800138000', '123456', 'verify');
+ *
+ * // 火山引擎专用：验证码校验
+ * const result = await factory.checkVerifyCode('13800138000', '123456');
+ * ```
+ */
+import { SmsVendor, SmsTemplate, SmsTemplateMeta, SmsClientDependencies, SmsFactoryConfig, SmsSendResult, VerifyCodeCheckResult } from './types';
+/**
+ * SMS 客户端工厂
+ *
+ * 负责创建和管理不同供应商的 SMS 客户端
+ */
+export declare class SmsClientFactory {
+    /** 当前供应商配置 */
+    private readonly provider;
+    /** 当前供应商类型 */
+    private readonly vendor;
+    /** SMS 客户端实例 */
+    private readonly client;
+    /** 模板配置映射 */
+    private readonly templates;
+    /** 日志器 */
+    private readonly logger;
+    /** HTTP 服务 */
+    private readonly httpService?;
+    /** Redis 服务 */
+    private readonly redis?;
+    constructor(dependencies: SmsClientDependencies, config?: SmsFactoryConfig);
+    /**
+     * 从配置初始化
+     */
+    private initializeFromConfig;
+    /**
+     * 初始化模板配置
+     */
+    private initializeTemplates;
+    /**
+     * 创建 SMS 客户端
+     */
+    private createClient;
+    /**
+     * 检查工厂是否已初始化
+     */
+    get isInitialized(): boolean;
+    /**
+     * 获取当前供应商类型
+     */
+    get currentVendor(): SmsVendor | null;
+    /**
+     * 获取当前供应商显示名称
+     */
+    get currentVendorName(): string;
+    /**
+     * 检查是否为火山引擎供应商
+     */
+    get isVolcengine(): boolean;
+    /**
+     * 获取所有模板名称
+     */
+    get templateNames(): string[];
+    /**
+     * 获取模板配置
+     *
+     * @param templateId - 模板 ID
+     * @returns 模板配置，不存在返回 undefined
+     */
+    getTemplate(templateId: string): SmsTemplate | undefined;
+    /**
+     * 获取模板配置（必须存在）
+     *
+     * @param templateId - 模板 ID
+     * @throws Error 如果模板不存在
+     */
+    getTemplateOrThrow(templateId: string): SmsTemplate;
+    /**
+     * 获取模板元数据
+     *
+     * @param templateId - 模板 ID
+     * @returns 模板元数据
+     */
+    getTemplateMeta(templateId: string): SmsTemplateMeta | undefined;
+    /**
+     * 发送短信验证码
+     *
+     * @param phone - 手机号码
+     * @param code - 验证码
+     * @param templateId - 模板 ID
+     * @returns 发送结果
+     */
+    sendSmsCode(phone: string, code: string, templateId?: string): Promise<SmsSendResult>;
+    /**
+     * 发送验证码（火山引擎自动生成）
+     *
+     * 仅火山引擎供应商支持此功能
+     *
+     * @param phoneNumber - 手机号码
+     * @param templateId - 模板 ID
+     * @throws Error 如果当前供应商不是火山引擎
+     */
+    sendVerifyCode(phoneNumber: string, templateId?: string): Promise<any>;
+    /**
+     * 校验验证码（火山引擎）
+     *
+     * 仅火山引擎供应商支持此功能
+     *
+     * @param phoneNumber - 手机号码
+     * @param code - 验证码
+     * @param templateId - 模板 ID
+     * @throws Error 如果当前供应商不是火山引擎
+     */
+    checkVerifyCode(phoneNumber: string, code: string, templateId?: string): Promise<VerifyCodeCheckResult>;
+    /**
+     * 确保工厂已初始化
+     */
+    private ensureInitialized;
+    /**
+     * 确保当前供应商为火山引擎
+     */
+    private ensureVolcengine;
+}
+//# sourceMappingURL=sms.factory.d.ts.map

package/dist/sms/sms.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms.factory.d.ts","sourceRoot":"","sources":["../../src/sms/sms.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAcH,OAAO,EACL,SAAS,EAET,WAAW,EACX,eAAe,EAIf,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAOjB;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,cAAc;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,cAAc;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAElD,aAAa;IACb,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAEhD,UAAU;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,cAAc;IACd,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;IAE3C,eAAe;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAe;gBAE1B,YAAY,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,gBAAgB;IAU1E;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,YAAY;IA2CpB;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,SAAS,GAAG,IAAI,CAEpC;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,EAAE,CAE5B;IAMD;;;;;OAKG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxD;;;;;OAKG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAQnD;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAehE;;;;;;;OAOG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAiB,GAC5B,OAAO,CAAC,aAAa,CAAC;IAazB;;;;;;;;OAQG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAiB,GAC5B,OAAO,CAAC,GAAG,CAAC;IAcf;;;;;;;;;OASG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAiB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAmBjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAKzB"}

package/dist/sms/sms.factory.js

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * @fileoverview SMS Client Factory
+ * @module @app/shared-services/sms/sms.factory
+ *
+ * 负责创建和管理 SMS 客户端实例
+ *
+ * 功能：
+ * - 根据供应商类型创建对应的 SMS 客户端
+ * - 管理模板配置
+ * - 提供统一的客户端访问接口
+ *
+ * @example
+ * ```typescript
+ * const factory = new SmsClientFactory(
+ *   { logger, httpService, redis },
+ *   { defaultVendor: 'volcengine', providers: [...] }
+ * );
+ *
+ * // 发送短信
+ * await factory.sendSmsCode('13800138000', '123456', 'verify');
+ *
+ * // 火山引擎专用：验证码校验
+ * const result = await factory.checkVerifyCode('13800138000', '123456');
+ * ```
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmsClientFactory = void 0;
+const infra_clients_1 = require("@dofe/infra-clients");
+const types_1 = require("./types");
+const environment_util_1 = __importDefault(require("@dofe/infra-utils/environment.util"));
+// ============================================================================
+// SMS Client Factory
+// ============================================================================
+/**
+ * SMS 客户端工厂
+ *
+ * 负责创建和管理不同供应商的 SMS 客户端
+ */
+class SmsClientFactory {
+    /** 当前供应商配置 */
+    provider = null;
+    /** 当前供应商类型 */
+    vendor = null;
+    /** SMS 客户端实例 */
+    client = null;
+    /** 模板配置映射 */
+    templates = {};
+    /** 日志器 */
+    logger;
+    /** HTTP 服务 */
+    httpService;
+    /** Redis 服务 */
+    redis;
+    constructor(dependencies, config) {
+        this.logger = dependencies.logger;
+        this.httpService = dependencies.httpService;
+        this.redis = dependencies.redis;
+        if (config) {
+            this.initializeFromConfig(config);
+        }
+    }
+    /**
+     * 从配置初始化
+     */
+    initializeFromConfig(config) {
+        const { defaultVendor, providers } = config;
+        const providerConfig = providers.find((p) => p.vendor === defaultVendor);
+        if (!providerConfig) {
+            this.logger.warn(`SMS provider not found: ${defaultVendor}`);
+            return;
+        }
+        // 使用类型断言来绕过 readonly 限制（仅在构造函数中）
+        this.provider = providerConfig;
+        this.vendor = defaultVendor;
+        this.client = this.createClient(providerConfig);
+        // 初始化模板
+        this.initializeTemplates(providerConfig);
+    }
+    /**
+     * 初始化模板配置
+     */
+    initializeTemplates(provider) {
+        if (!provider.templates)
+            return;
+        provider.templates.forEach((template) => {
+            const meta = template;
+            const name = meta.name || 'default';
+            this.templates[name] = template;
+        });
+        if (environment_util_1.default.isProduction()) {
+            this.logger.info(`SMS templates initialized: ${Object.keys(this.templates).join(', ')}`);
+        }
+    }
+    /**
+     * 创建 SMS 客户端
+     */
+    createClient(provider) {
+        const vendor = provider.vendor;
+        if (environment_util_1.default.isProduction()) {
+            this.logger.info(`Creating SMS client for vendor: ${types_1.SMS_VENDOR_NAMES[vendor] || vendor}`);
+        }
+        switch (vendor) {
+            case 'aliyun':
+                return new infra_clients_1.SmsAliyunClient(provider, this.logger);
+            case 'tencent':
+                return new infra_clients_1.SmsTencentClient(provider, this.logger);
+            case 'http':
+                if (!this.httpService) {
+                    throw new Error('HttpService is required for HTTP SMS client');
+                }
+                return new infra_clients_1.SmsHttpClient(provider, this.httpService, this.logger);
+            case 'zxjcsms':
+                if (!this.httpService) {
+                    throw new Error('HttpService is required for ZXJC SMS client');
+                }
+                return new infra_clients_1.SmsZxjcClient(provider, this.httpService, this.logger);
+            case 'volcengine':
+                if (!this.redis) {
+                    throw new Error('RedisService is required for Volcengine SMS client');
+                }
+                return new infra_clients_1.SmsVolcengineClient(provider, this.redis, this.logger);
+            default:
+                throw new Error(`Unsupported SMS vendor: ${vendor}`);
+        }
+    }
+    // ========================================================================
+    // Public Accessors
+    // ========================================================================
+    /**
+     * 检查工厂是否已初始化
+     */
+    get isInitialized() {
+        return this.client !== null;
+    }
+    /**
+     * 获取当前供应商类型
+     */
+    get currentVendor() {
+        return this.vendor;
+    }
+    /**
+     * 获取当前供应商显示名称
+     */
+    get currentVendorName() {
+        return this.vendor ? types_1.SMS_VENDOR_NAMES[this.vendor] : 'Unknown';
+    }
+    /**
+     * 检查是否为火山引擎供应商
+     */
+    get isVolcengine() {
+        return this.vendor === 'volcengine';
+    }
+    /**
+     * 获取所有模板名称
+     */
+    get templateNames() {
+        return Object.keys(this.templates);
+    }
+    // ========================================================================
+    // Template Management
+    // ========================================================================
+    /**
+     * 获取模板配置
+     *
+     * @param templateId - 模板 ID
+     * @returns 模板配置，不存在返回 undefined
+     */
+    getTemplate(templateId) {
+        return this.templates[templateId];
+    }
+    /**
+     * 获取模板配置（必须存在）
+     *
+     * @param templateId - 模板 ID
+     * @throws Error 如果模板不存在
+     */
+    getTemplateOrThrow(templateId) {
+        const template = this.templates[templateId];
+        if (!template) {
+            throw new Error(`SMS template not found: ${templateId}`);
+        }
+        return template;
+    }
+    /**
+     * 获取模板元数据
+     *
+     * @param templateId - 模板 ID
+     * @returns 模板元数据
+     */
+    getTemplateMeta(templateId) {
+        const template = this.templates[templateId];
+        if (!template)
+            return undefined;
+        return {
+            name: template.name,
+            frequency: template.frequency,
+            codeExpire: template.codeExpire,
+        };
+    }
+    // ========================================================================
+    // SMS Operations
+    // ========================================================================
+    /**
+     * 发送短信验证码
+     *
+     * @param phone - 手机号码
+     * @param code - 验证码
+     * @param templateId - 模板 ID
+     * @returns 发送结果
+     */
+    async sendSmsCode(phone, code, templateId = 'verify') {
+        this.ensureInitialized();
+        const template = this.getTemplateOrThrow(templateId);
+        this.logger.info(`Sending SMS code to ${phone}`, {
+            vendor: this.currentVendorName,
+            templateId,
+        });
+        return await this.client.sendSmsCode(phone, code, template);
+    }
+    /**
+     * 发送验证码（火山引擎自动生成）
+     *
+     * 仅火山引擎供应商支持此功能
+     *
+     * @param phoneNumber - 手机号码
+     * @param templateId - 模板 ID
+     * @throws Error 如果当前供应商不是火山引擎
+     */
+    async sendVerifyCode(phoneNumber, templateId = 'verify') {
+        this.ensureInitialized();
+        this.ensureVolcengine('sendVerifyCode');
+        const template = this.getTemplateOrThrow(templateId);
+        return await this.client.sendVerifyCode(phoneNumber, template);
+    }
+    /**
+     * 校验验证码（火山引擎）
+     *
+     * 仅火山引擎供应商支持此功能
+     *
+     * @param phoneNumber - 手机号码
+     * @param code - 验证码
+     * @param templateId - 模板 ID
+     * @throws Error 如果当前供应商不是火山引擎
+     */
+    async checkVerifyCode(phoneNumber, code, templateId = 'verify') {
+        this.ensureInitialized();
+        this.ensureVolcengine('checkVerifyCode');
+        const template = this.getTemplateOrThrow(templateId);
+        return await this.client.checkVerifyCode(phoneNumber, code, template);
+    }
+    // ========================================================================
+    // Private Helpers
+    // ========================================================================
+    /**
+     * 确保工厂已初始化
+     */
+    ensureInitialized() {
+        if (!this.client) {
+            throw new Error('SMS client not initialized. Check SMS configuration.');
+        }
+    }
+    /**
+     * 确保当前供应商为火山引擎
+     */
+    ensureVolcengine(methodName) {
+        if (!this.isVolcengine) {
+            throw new Error(`${methodName} is only supported by Volcengine SMS`);
+        }
+    }
+}
+exports.SmsClientFactory = SmsClientFactory;
+//# sourceMappingURL=sms.factory.js.map