@dofe/infra-clients 0.1.1

package/dist/internal/openspeech/openspeech.client.js

@@ -0,0 +1,405 @@
+"use strict";
+/**
+ * @fileoverview OpenSpeech 语音识别服务客户端
+ *
+ * 本文件是语音识别服务的统一入口（Facade 模式），提供了简洁的 API 接口，
+ * 内部通过工厂模式委托给具体的云服务商实现。
+ *
+ * 架构说明：
+ * ```
+ * ┌─────────────────────────────────────────────────────────────┐
+ * │                      OpenspeechClient                       │
+ * │                     （Facade 门面）                          │
+ * └─────────────────────────────┬───────────────────────────────┘
+ *                               │
+ *                               ▼
+ * ┌─────────────────────────────────────────────────────────────┐
+ * │                 OpenspeechProviderFactory                   │
+ * │                    （工厂模式）                              │
+ * └──────────────┬──────────────────────────────┬───────────────┘
+ *                │                              │
+ *                ▼                              ▼
+ * ┌──────────────────────────┐    ┌──────────────────────────────┐
+ * │  AliyunOpenspeechProvider │    │ VolcengineOpenspeechProvider │
+ * │      （阿里云实现）         │    │      （火山引擎实现）         │
+ * └──────────────────────────┘    └──────────────────────────────┘
+ * ```
+ *
+ * @module openspeech/client
+ */
+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.OpenspeechClient = void 0;
+const common_1 = require("@nestjs/common");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const infra_shared_services_1 = require("@dofe/infra-shared-services");
+const infra_utils_1 = require("@dofe/infra-utils");
+const openspeech_factory_1 = require("./openspeech.factory");
+/**
+ * OpenSpeech 语音识别服务客户端
+ *
+ * @description 作为语音识别服务的统一门面，提供以下核心功能：
+ *
+ * 1. **任务提交** - `submitTranscribeTask`
+ *    根据 FileKey 自动选择云服务商，提交语音识别任务
+ *
+ * 2. **状态查询** - `queryTranscribeTaskStatus`
+ *    查询指定任务的处理状态和结果
+ *
+ * 3. **同步识别** - `transcribeFromFileKey`
+ *    提交任务并轮询等待结果（阻塞式，向后兼容）
+ *
+ * 云服务商选择逻辑：
+ * - 优先使用 `preferVendor` 参数指定的云服务商
+ * - 默认根据 FileKey 的 vendor 字段选择
+ * - oss -> 阿里云, tos -> 火山引擎
+ *
+ * @class OpenspeechClient
+ *
+ * @example
+ * ```typescript
+ * // 注入客户端
+ * @Injectable()
+ * class VideoService {
+ *   constructor(private readonly openspeech: OpenspeechClient) {}
+ *
+ *   // 异步任务模式（推荐）
+ *   async startTranscription(fileKey: FileKey) {
+ *     const { vendor, vendorTaskId } = await this.openspeech.submitTranscribeTask(fileKey);
+ *     // 保存 vendorTaskId，通过回调或轮询获取结果
+ *     return { vendor, vendorTaskId };
+ *   }
+ *
+ *   // 查询任务状态
+ *   async checkStatus(vendor: FileBucketVendor, taskId: string) {
+ *     return await this.openspeech.queryTranscribeTaskStatus(vendor, taskId);
+ *   }
+ *
+ *   // 同步模式（阻塞等待，适用于简单场景）
+ *   async transcribeSync(fileKey: FileKey) {
+ *     return await this.openspeech.transcribeFromFileKey(fileKey);
+ *   }
+ * }
+ * ```
+ */
+let OpenspeechClient = class OpenspeechClient {
+    fileApi;
+    providerFactory;
+    logger;
+    /**
+     * 构造函数
+     *
+     * @param {FileStorageService} fileApi - 文件存储服务
+     * @param {OpenspeechProviderFactory} providerFactory - 提供商工厂
+     * @param {Logger} logger - Winston 日志记录器
+     */
+    constructor(fileApi, providerFactory, logger) {
+        this.fileApi = fileApi;
+        this.providerFactory = providerFactory;
+        this.logger = logger;
+    }
+    /**
+     * 根据 FileKey 提交语音识别任务
+     *
+     * @description 根据文件信息自动选择云服务商并提交识别任务。
+     *
+     * 处理流程：
+     * 1. 验证 FileKey 的必要字段
+     * 2. 根据视频 key 推导音频 key
+     * 3. 获取存储桶配置，拼接音频 HTTP URL
+     * 4. 选择云服务商（优先级：preferVendor > vendor）
+     * 5. 调用对应提供商提交任务
+     *
+     * @param {Partial<FileKey>} fileKey - 文件信息
+     * @param {FileBucketVendor} [fileKey.vendor] - 存储服务商（必填）
+     * @param {string} [fileKey.bucket] - 存储桶名称（必填）
+     * @param {string} [fileKey.key] - 文件路径（必填）
+     * @param {FileBucketVendor} [(fileKey as any).preferVendor] - 优先使用的云服务商
+     * @returns {Promise<SubmitTaskResult>} 任务提交结果
+     * @throws {Error} FileKey 无效或提交失败时抛出异常
+     *
+     * @example
+     * ```typescript
+     * // 基本用法
+     * const result = await client.submitTranscribeTask({
+     *   vendor: 'oss',
+     *   bucket: 'my-bucket',
+     *   key: 'videos/example.mp4',
+     * });
+     * console.log('Task ID:', result.vendorTaskId);
+     *
+     * // 指定使用火山引擎
+     * const result = await client.submitTranscribeTask({
+     *   vendor: 'oss',
+     *   bucket: 'my-bucket',
+     *   key: 'videos/example.mp4',
+     *   preferVendor: 'tos',
+     * } as any);
+     * ```
+     */
+    async submitTranscribeTask(fileKey) {
+        // 参数验证
+        if (!fileKey?.vendor || !fileKey?.bucket || !fileKey?.key) {
+            throw new Error('Invalid FileKey for openspeech transcription');
+        }
+        // 根据视频 key 推导音频 key（与转码保持一致）
+        const audioKey = infra_utils_1.fileUtil.buildAudioKeyFromVideoKey(fileKey.key, 'mp3');
+        const audioUrl = await this.fileApi.getPrivateDownloadUrl(fileKey.vendor, fileKey.bucket, audioKey);
+        this.logger.info('Openspeech transcription submit requested', {
+            vendor: fileKey.vendor,
+            bucket: fileKey.bucket,
+            audioKey,
+            audioUrl,
+        });
+        // 选择云服务商：优先使用 preferVendor，否则根据 fileKey.vendor 选择
+        const preferVendor = fileKey.preferVendor;
+        const useVendor = preferVendor ?? fileKey.vendor;
+        // 获取对应的提供商并提交任务
+        const provider = this.providerFactory.getProvider(useVendor);
+        const vendorTaskId = await provider.submitTask({ audioUrl });
+        return {
+            vendor: useVendor,
+            vendorTaskId,
+            audioUrl,
+        };
+    }
+    /**
+     * 查询语音识别任务状态
+     *
+     * @description 根据云服务商和任务 ID 查询识别任务的状态和结果。
+     *
+     * 返回状态说明：
+     * - `processing`: 任务正在处理中，需要继续轮询
+     * - `success`: 识别成功，text 字段包含识别结果
+     * - `error`: 识别失败，error 字段包含错误信息
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @param {string} vendorTaskId - 云服务商返回的任务 ID
+     * @returns {Promise<TaskStatusResult>} 任务状态和结果
+     * @throws {Error} 不支持的 vendor 类型时抛出异常
+     *
+     * @example
+     * ```typescript
+     * const result = await client.queryTranscribeTaskStatus('oss', 'task-123');
+     *
+     * if (result.status === 'success') {
+     *   console.log('识别文本:', result.text);
+     * } else if (result.status === 'processing') {
+     *   // 稍后重试
+     *   setTimeout(() => this.checkStatus(), 3000);
+     * } else {
+     *   console.error('识别失败:', result.error);
+     * }
+     * ```
+     */
+    async queryTranscribeTaskStatus(vendor, vendorTaskId) {
+        const provider = this.providerFactory.getProvider(vendor);
+        return provider.queryTaskStatus(vendorTaskId);
+    }
+    /**
+     * 根据 FileKey 进行语音识别（同步阻塞模式）
+     *
+     * @description 提交任务并轮询等待结果，直到识别完成或失败。
+     * 此方法会阻塞直到获得最终结果，适用于简单场景。
+     *
+     * **注意**：对于生产环境，建议使用异步模式：
+     * 1. 调用 `submitTranscribeTask` 提交任务
+     * 2. 配置回调 URL 接收结果，或定时调用 `queryTranscribeTaskStatus` 查询
+     *
+     * @deprecated 建议使用异步模式（submitTranscribeTask + queryTranscribeTaskStatus）
+     * @param {Partial<FileKey>} fileKey - 文件信息
+     * @returns {Promise<string>} 识别出的文本内容
+     * @throws {Error} 识别失败时抛出异常
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const text = await client.transcribeFromFileKey({
+     *     vendor: 'oss',
+     *     bucket: 'my-bucket',
+     *     key: 'videos/example.mp4',
+     *   });
+     *   console.log('识别结果:', text);
+     * } catch (error) {
+     *   console.error('识别失败:', error.message);
+     * }
+     * ```
+     */
+    async transcribeFromFileKey(fileKey) {
+        // 提交任务
+        const { vendor, vendorTaskId } = await this.submitTranscribeTask(fileKey);
+        // 轮询等待结果
+        for (;;) {
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+            const result = await this.queryTranscribeTaskStatus(vendor, vendorTaskId);
+            if (result.status === 'success') {
+                return result.text || '';
+            }
+            if (result.status === 'error') {
+                throw new Error(result.error || 'Transcription failed');
+            }
+            // processing 状态继续轮询
+        }
+    }
+    // =========================================================================
+    // 流式语音识别方法
+    // =========================================================================
+    /**
+     * 建立流式语音识别连接
+     *
+     * @description 建立 WebSocket 连接用于实时语音识别。
+     * 目前仅支持火山引擎 (tos) 流式识别。
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型（目前仅支持 'tos'）
+     * @param {StreamingConnectParams} params - 连接参数
+     * @param {StreamingAsrCallbacks} callbacks - 事件回调
+     * @returns {Promise<string>} 连接 ID
+     * @throws {Error} 不支持的 vendor 类型或连接失败时抛出异常
+     *
+     * @example
+     * ```typescript
+     * const connectionId = await client.connectStreaming(
+     *   'tos',
+     *   { sessionId: 'session-123', audioFormat: 'pcm' },
+     *   {
+     *     onResult: (result) => console.log('识别结果:', result.text),
+     *     onConnected: () => console.log('已连接'),
+     *     onError: (error) => console.error('错误:', error),
+     *   }
+     * );
+     * ```
+     */
+    async connectStreaming(vendor, params, callbacks) {
+        this.logger.info('Openspeech streaming connection requested', {
+            vendor,
+            sessionId: params.sessionId,
+            audioFormat: params.audioFormat,
+        });
+        const provider = this.providerFactory.getStreamingProvider(vendor);
+        return provider.connect(params, callbacks);
+    }
+    /**
+     * 发送音频数据到流式识别连接
+     *
+     * @description 将音频数据发送到已建立的流式识别连接。
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @param {string} connectionId - 连接 ID
+     * @param {Buffer} audioData - 音频数据
+     * @param {boolean} [isLast=false] - 是否为最后一帧
+     * @throws {Error} 连接不存在或发送失败时抛出异常
+     *
+     * @example
+     * ```typescript
+     * // 发送音频数据
+     * await client.sendStreamingAudio('tos', connectionId, audioBuffer);
+     *
+     * // 发送最后一帧
+     * await client.sendStreamingAudio('tos', connectionId, lastBuffer, true);
+     * ```
+     */
+    async sendStreamingAudio(vendor, connectionId, audioData, isLast = false) {
+        const provider = this.providerFactory.getStreamingProvider(vendor);
+        return provider.sendAudio(connectionId, audioData, isLast);
+    }
+    /**
+     * 关闭流式识别连接
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @param {string} connectionId - 连接 ID
+     *
+     * @example
+     * ```typescript
+     * await client.disconnectStreaming('tos', connectionId);
+     * ```
+     */
+    async disconnectStreaming(vendor, connectionId) {
+        this.logger.info('Openspeech streaming disconnection requested', {
+            vendor,
+            connectionId,
+        });
+        const provider = this.providerFactory.getStreamingProvider(vendor);
+        return provider.disconnect(connectionId);
+    }
+    /**
+     * 获取流式识别连接状态
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @param {string} connectionId - 连接 ID
+     * @returns {StreamingAsrStatus} 连接状态
+     *
+     * @example
+     * ```typescript
+     * const status = client.getStreamingStatus('tos', connectionId);
+     * if (status === 'streaming') {
+     *   // 正在识别中
+     * }
+     * ```
+     */
+    getStreamingStatus(vendor, connectionId) {
+        const provider = this.providerFactory.getStreamingProvider(vendor);
+        return provider.getConnectionStatus(connectionId);
+    }
+    /**
+     * 获取流式识别提供商实例
+     *
+     * @description 直接获取流式识别提供商，用于高级操作。
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {IStreamingAsrProvider} 流式识别提供商实例
+     *
+     * @example
+     * ```typescript
+     * const provider = client.getStreamingProvider('tos');
+     * const transcript = provider.getTranscript(connectionId);
+     * ```
+     */
+    getStreamingProvider(vendor) {
+        return this.providerFactory.getStreamingProvider(vendor);
+    }
+    /**
+     * 检查指定云服务商是否支持流式识别
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {boolean} 是否支持流式识别
+     *
+     * @example
+     * ```typescript
+     * if (client.isStreamingAvailable('tos')) {
+     *   // 使用流式识别
+     * }
+     * ```
+     */
+    isStreamingAvailable(vendor) {
+        return this.providerFactory.isStreamingAvailable(vendor);
+    }
+    /**
+     * 获取所有支持流式识别的云服务商列表
+     *
+     * @returns {FileBucketVendor[]} 支持流式识别的云服务商列表
+     */
+    getStreamingAvailableVendors() {
+        return this.providerFactory.getStreamingAvailableVendors();
+    }
+};
+exports.OpenspeechClient = OpenspeechClient;
+exports.OpenspeechClient = OpenspeechClient = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [infra_shared_services_1.FileStorageService,
+        openspeech_factory_1.OpenspeechProviderFactory,
+        winston_1.Logger])
+], OpenspeechClient);
+//# sourceMappingURL=openspeech.client.js.map

package/dist/internal/openspeech/openspeech.client.js.map

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

package/dist/internal/openspeech/openspeech.factory.d.ts

@@ -0,0 +1,247 @@
+/**
+ * @fileoverview OpenSpeech 服务提供商工厂
+ *
+ * 本文件实现了语音识别服务提供商的工厂模式，负责：
+ * - 根据云服务商类型创建对应的提供商实例
+ * - 管理提供商实例的生命周期（单例模式）
+ * - 提供统一的提供商获取接口
+ * - 支持录音文件识别（AUC）和流式识别（SAUC）两种模式
+ *
+ * @module openspeech/factory
+ */
+import { HttpService } from '@nestjs/axios';
+import { Logger } from 'winston';
+import { FileBucketVendor } from '@prisma/client';
+import { IOpenspeechProvider, IStreamingAsrProvider } from './types';
+/**
+ * OpenSpeech 服务提供商工厂
+ *
+ * @description 使用工厂模式管理不同云服务商的语音识别服务提供商。
+ * 主要职责：
+ * - 根据 vendor 类型创建对应的提供商实例
+ * - 使用单例模式缓存提供商实例，避免重复创建
+ * - 提供统一的提供商获取接口
+ * - 支持录音文件识别和流式识别两种模式
+ *
+ * 支持的云服务商：
+ * - 'oss': 阿里云 NLS 语音识别
+ * - 'tos': 火山引擎大模型语音识别（支持 AUC 录音识别和 SAUC 流式识别）
+ *
+ * @class OpenspeechProviderFactory
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService {
+ *   constructor(private readonly factory: OpenspeechProviderFactory) {}
+ *
+ *   // 录音文件识别
+ *   async transcribe(vendor: FileBucketVendor, audioUrl: string) {
+ *     const provider = this.factory.getProvider(vendor);
+ *     const taskId = await provider.submitTask({ audioUrl });
+ *     // ...
+ *   }
+ *
+ *   // 流式语音识别
+ *   async streamingTranscribe(sessionId: string) {
+ *     const provider = this.factory.getStreamingProvider('tos');
+ *     const connectionId = await provider.connect(
+ *       { sessionId, audioFormat: 'pcm' },
+ *       { onResult: (result) => console.log(result.text) }
+ *     );
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare class OpenspeechProviderFactory {
+    private readonly httpService;
+    private readonly logger;
+    /**
+     * 录音文件识别提供商实例缓存
+     * @private
+     */
+    private readonly providers;
+    /**
+     * 流式识别提供商实例缓存
+     * @private
+     */
+    private readonly streamingProviders;
+    /**
+     * OpenSpeech 配置
+     * @private
+     */
+    private readonly openspeechConfig;
+    /**
+     * 构造函数
+     *
+     * @param {HttpService} httpService - NestJS HTTP 服务（用于火山引擎）
+     * @param {Logger} logger - Winston 日志记录器
+     */
+    constructor(httpService: HttpService, logger: Logger);
+    /**
+     * 获取指定云服务商的录音文件识别提供商实例
+     *
+     * @description 根据 vendor 类型返回对应的提供商实例。
+     * 使用单例模式，同一 vendor 只会创建一个实例。
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {IOpenspeechProvider} 提供商实例
+     * @throws {Error} 不支持的 vendor 类型或配置缺失时抛出异常
+     *
+     * @example
+     * ```typescript
+     * // 获取阿里云提供商
+     * const aliyunProvider = factory.getProvider('oss');
+     *
+     * // 获取火山引擎提供商
+     * const volcengineProvider = factory.getProvider('tos');
+     * ```
+     */
+    getProvider(vendor: FileBucketVendor): IOpenspeechProvider;
+    /**
+     * 获取指定云服务商的流式识别提供商实例
+     *
+     * @description 根据 vendor 类型返回对应的流式识别提供商实例。
+     * 目前仅支持火山引擎 (tos)。
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型（目前仅支持 'tos'）
+     * @returns {IStreamingAsrProvider} 流式识别提供商实例
+     * @throws {Error} 不支持的 vendor 类型或配置缺失时抛出异常
+     *
+     * @example
+     * ```typescript
+     * const streamingProvider = factory.getStreamingProvider('tos');
+     * const connectionId = await streamingProvider.connect(
+     *   { sessionId: 'session-123', audioFormat: 'pcm' },
+     *   { onResult: (result) => console.log(result.text) }
+     * );
+     * ```
+     */
+    getStreamingProvider(vendor: FileBucketVendor): IStreamingAsrProvider;
+    /**
+     * 创建录音文件识别提供商实例
+     *
+     * @private
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {IOpenspeechProvider} 新创建的提供商实例
+     * @throws {Error} 不支持的 vendor 类型或配置缺失时抛出异常
+     */
+    private createProvider;
+    /**
+     * 创建流式识别提供商实例
+     *
+     * @private
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {IStreamingAsrProvider} 新创建的流式识别提供商实例
+     * @throws {Error} 不支持的 vendor 类型或配置缺失时抛出异常
+     */
+    private createStreamingProvider;
+    /**
+     * 将阿里云配置转换为 Provider 配置
+     *
+     * @private
+     * @param {NonNullable<OpenSpeechConfig['oss']>} config - 阿里云原始配置
+     * @returns {AliyunOpenspeechConfig} 阿里云 Provider 配置
+     */
+    private toAliyunConfig;
+    /**
+     * 将火山引擎配置转换为录音文件识别（AUC）Provider 配置
+     *
+     * @private
+     * @param {NonNullable<OpenSpeechConfig['tos']>} config - 火山引擎原始配置
+     * @returns {VolcengineAucConfig} 火山引擎 AUC Provider 配置
+     * @throws {Error} AUC 配置缺失时抛出异常
+     */
+    private toVolcengineAucConfig;
+    /**
+     * 将火山引擎配置转换为流式识别（SAUC）Provider 配置
+     *
+     * @private
+     * @param {NonNullable<OpenSpeechConfig['tos']>} config - 火山引擎原始配置
+     * @returns {VolcengineSaucConfig} 火山引擎 SAUC Provider 配置
+     * @throws {Error} SAUC 配置缺失时抛出异常
+     */
+    private toVolcengineSaucConfig;
+    /**
+     * 创建阿里云提供商实例
+     *
+     * @private
+     * @returns {AliyunOpenspeechProvider} 阿里云提供商实例
+     * @throws {Error} 配置缺失时抛出异常
+     */
+    private createAliyunProvider;
+    /**
+     * 创建火山引擎录音文件识别提供商实例
+     *
+     * @private
+     * @returns {VolcengineOpenspeechProvider} 火山引擎 AUC 提供商实例
+     * @throws {Error} 配置缺失时抛出异常
+     */
+    private createVolcengineAucProvider;
+    /**
+     * 创建火山引擎流式识别提供商实例
+     *
+     * @private
+     * @returns {VolcengineStreamingAsrProvider} 火山引擎 SAUC 提供商实例
+     * @throws {Error} 配置缺失时抛出异常
+     */
+    private createVolcengineSaucProvider;
+    /**
+     * 检查指定云服务商的录音文件识别是否可用
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {boolean} 是否可用（配置存在）
+     *
+     * @example
+     * ```typescript
+     * if (factory.isVendorAvailable('oss')) {
+     *   const provider = factory.getProvider('oss');
+     *   // ...
+     * }
+     * ```
+     */
+    isVendorAvailable(vendor: FileBucketVendor): boolean;
+    /**
+     * 检查指定云服务商的流式识别是否可用
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {boolean} 是否可用（配置存在）
+     *
+     * @example
+     * ```typescript
+     * if (factory.isStreamingAvailable('tos')) {
+     *   const provider = factory.getStreamingProvider('tos');
+     *   // ...
+     * }
+     * ```
+     */
+    isStreamingAvailable(vendor: FileBucketVendor): boolean;
+    /**
+     * 获取所有可用的云服务商列表（录音文件识别）
+     *
+     * @returns {FileBucketVendor[]} 可用的云服务商列表
+     *
+     * @example
+     * ```typescript
+     * const vendors = factory.getAvailableVendors();
+     * console.log('Available vendors:', vendors);
+     * // 输出: ['oss', 'tos']
+     * ```
+     */
+    getAvailableVendors(): FileBucketVendor[];
+    /**
+     * 获取所有支持流式识别的云服务商列表
+     *
+     * @returns {FileBucketVendor[]} 支持流式识别的云服务商列表
+     *
+     * @example
+     * ```typescript
+     * const vendors = factory.getStreamingAvailableVendors();
+     * console.log('Streaming available vendors:', vendors);
+     * // 输出: ['tos']
+     * ```
+     */
+    getStreamingAvailableVendors(): FileBucketVendor[];
+}
+//# sourceMappingURL=openspeech.factory.d.ts.map

package/dist/internal/openspeech/openspeech.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openspeech.factory.d.ts","sourceRoot":"","sources":["../../../src/internal/openspeech/openspeech.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EAItB,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBACa,yBAAyB;IA8BlC,OAAO,CAAC,QAAQ,CAAC,WAAW;IACK,OAAO,CAAC,QAAQ,CAAC,MAAM;IA9B1D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CACd;IAEZ;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAGrB;IAEd;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAEpD;;;;;OAKG;gBAEgB,WAAW,EAAE,WAAW,EACS,MAAM,EAAE,MAAM;IAKlE;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB;IAa1D;;;;;;;;;;;;;;;;;;OAkBG;IACH,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,qBAAqB;IAarE;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B;IAiBnC;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAapC;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;IAWpD;;;;;;;;;;;;;OAaG;IACH,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;IASvD;;;;;;;;;;;OAWG;IACH,mBAAmB,IAAI,gBAAgB,EAAE;IAazC;;;;;;;;;;;OAWG;IACH,4BAA4B,IAAI,gBAAgB,EAAE;CASnD"}