@dofe/infra-clients 0.1.17 → 0.1.19

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

@@ -1,405 +0,0 @@
-"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

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

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

@@ -1,247 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"version":3,"file":"openspeech.factory.d.ts","sourceRoot":"","sources":["../../../../../packages/clients/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"}