@dofe/infra-clients 0.1.1

package/dist/internal/openspeech/openspeech.factory.js

@@ -0,0 +1,406 @@
+"use strict";
+/**
+ * @fileoverview OpenSpeech 服务提供商工厂
+ *
+ * 本文件实现了语音识别服务提供商的工厂模式，负责：
+ * - 根据云服务商类型创建对应的提供商实例
+ * - 管理提供商实例的生命周期（单例模式）
+ * - 提供统一的提供商获取接口
+ * - 支持录音文件识别（AUC）和流式识别（SAUC）两种模式
+ *
+ * @module openspeech/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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenspeechProviderFactory = void 0;
+const common_1 = require("@nestjs/common");
+const axios_1 = require("@nestjs/axios");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const infra_common_1 = require("@dofe/infra-common");
+const aliyun_provider_1 = require("./providers/aliyun.provider");
+const volcengine_provider_1 = require("./providers/volcengine.provider");
+const volcengine_streaming_provider_1 = require("./providers/volcengine-streaming.provider");
+/**
+ * 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) }
+ *     );
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+let OpenspeechProviderFactory = class OpenspeechProviderFactory {
+    httpService;
+    logger;
+    /**
+     * 录音文件识别提供商实例缓存
+     * @private
+     */
+    providers = new Map();
+    /**
+     * 流式识别提供商实例缓存
+     * @private
+     */
+    streamingProviders = new Map();
+    /**
+     * OpenSpeech 配置
+     * @private
+     */
+    openspeechConfig;
+    /**
+     * 构造函数
+     *
+     * @param {HttpService} httpService - NestJS HTTP 服务（用于火山引擎）
+     * @param {Logger} logger - Winston 日志记录器
+     */
+    constructor(httpService, logger) {
+        this.httpService = httpService;
+        this.logger = logger;
+        this.openspeechConfig = (0, infra_common_1.getKeysConfig)()?.openspeech;
+    }
+    /**
+     * 获取指定云服务商的录音文件识别提供商实例
+     *
+     * @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) {
+        // 检查缓存
+        if (this.providers.has(vendor)) {
+            return this.providers.get(vendor);
+        }
+        // 创建新实例
+        const provider = this.createProvider(vendor);
+        this.providers.set(vendor, provider);
+        return provider;
+    }
+    /**
+     * 获取指定云服务商的流式识别提供商实例
+     *
+     * @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) {
+        // 检查缓存
+        if (this.streamingProviders.has(vendor)) {
+            return this.streamingProviders.get(vendor);
+        }
+        // 创建新实例
+        const provider = this.createStreamingProvider(vendor);
+        this.streamingProviders.set(vendor, provider);
+        return provider;
+    }
+    /**
+     * 创建录音文件识别提供商实例
+     *
+     * @private
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {IOpenspeechProvider} 新创建的提供商实例
+     * @throws {Error} 不支持的 vendor 类型或配置缺失时抛出异常
+     */
+    createProvider(vendor) {
+        switch (vendor) {
+            case 'oss':
+                return this.createAliyunProvider();
+            case 'tos':
+                return this.createVolcengineAucProvider();
+            default:
+                throw new Error(`Unsupported vendor for openspeech: ${vendor}`);
+        }
+    }
+    /**
+     * 创建流式识别提供商实例
+     *
+     * @private
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {IStreamingAsrProvider} 新创建的流式识别提供商实例
+     * @throws {Error} 不支持的 vendor 类型或配置缺失时抛出异常
+     */
+    createStreamingProvider(vendor) {
+        switch (vendor) {
+            case 'tos':
+                return this.createVolcengineSaucProvider();
+            default:
+                throw new Error(`Unsupported vendor for streaming ASR: ${vendor}`);
+        }
+    }
+    /**
+     * 将阿里云配置转换为 Provider 配置
+     *
+     * @private
+     * @param {NonNullable<OpenSpeechConfig['oss']>} config - 阿里云原始配置
+     * @returns {AliyunOpenspeechConfig} 阿里云 Provider 配置
+     */
+    toAliyunConfig(config) {
+        return {
+            endpoint: config.endpoint,
+            accessKeyId: config.accessKeyId,
+            accessKeySecret: config.accessKeySecret,
+            nslAppKey: config.nslAppKey,
+            nslAppId: config.nslAppId,
+            apiVersion: config.apiVersion,
+            tokenEndpoint: config.tokenEndpoint,
+            accessKey: config.accessKey,
+            secretKey: config.secretKey,
+        };
+    }
+    /**
+     * 将火山引擎配置转换为录音文件识别（AUC）Provider 配置
+     *
+     * @private
+     * @param {NonNullable<OpenSpeechConfig['tos']>} config - 火山引擎原始配置
+     * @returns {VolcengineAucConfig} 火山引擎 AUC Provider 配置
+     * @throws {Error} AUC 配置缺失时抛出异常
+     */
+    toVolcengineAucConfig(config) {
+        if (!config.auc) {
+            throw new Error('Volcengine OpenSpeech AUC config not found in configuration');
+        }
+        return {
+            appId: config.appId,
+            appAccessToken: config.appAccessToken,
+            uid: config.uid,
+            endpoint: config.auc.endpoint,
+            resourceId: config.auc.resourceId,
+            appAccessSecret: config.appAccessSecret,
+            accessKey: config.accessKey,
+            secretKey: config.secretKey,
+        };
+    }
+    /**
+     * 将火山引擎配置转换为流式识别（SAUC）Provider 配置
+     *
+     * @private
+     * @param {NonNullable<OpenSpeechConfig['tos']>} config - 火山引擎原始配置
+     * @returns {VolcengineSaucConfig} 火山引擎 SAUC Provider 配置
+     * @throws {Error} SAUC 配置缺失时抛出异常
+     */
+    toVolcengineSaucConfig(config) {
+        if (!config.sauc) {
+            throw new Error('Volcengine OpenSpeech SAUC config not found in configuration');
+        }
+        return {
+            appId: config.appId,
+            appAccessToken: config.appAccessToken,
+            uid: config.uid,
+            endpoint: config.sauc.endpoint,
+            resourceId: config.sauc.resourceId,
+            appAccessSecret: config.appAccessSecret,
+            accessKey: config.accessKey,
+            secretKey: config.secretKey,
+        };
+    }
+    /**
+     * 创建阿里云提供商实例
+     *
+     * @private
+     * @returns {AliyunOpenspeechProvider} 阿里云提供商实例
+     * @throws {Error} 配置缺失时抛出异常
+     */
+    createAliyunProvider() {
+        const rawConfig = this.openspeechConfig?.oss;
+        if (!rawConfig) {
+            throw new Error('Aliyun OpenSpeech config (oss) not found in configuration');
+        }
+        const config = this.toAliyunConfig(rawConfig);
+        this.logger.info('Creating Aliyun OpenSpeech provider');
+        return new aliyun_provider_1.AliyunOpenspeechProvider(this.logger, config);
+    }
+    /**
+     * 创建火山引擎录音文件识别提供商实例
+     *
+     * @private
+     * @returns {VolcengineOpenspeechProvider} 火山引擎 AUC 提供商实例
+     * @throws {Error} 配置缺失时抛出异常
+     */
+    createVolcengineAucProvider() {
+        const rawConfig = this.openspeechConfig?.tos;
+        if (!rawConfig) {
+            throw new Error('Volcengine OpenSpeech config (tos) not found in configuration');
+        }
+        const config = this.toVolcengineAucConfig(rawConfig);
+        this.logger.info('Creating Volcengine OpenSpeech AUC provider');
+        return new volcengine_provider_1.VolcengineOpenspeechProvider(this.logger, this.httpService, config);
+    }
+    /**
+     * 创建火山引擎流式识别提供商实例
+     *
+     * @private
+     * @returns {VolcengineStreamingAsrProvider} 火山引擎 SAUC 提供商实例
+     * @throws {Error} 配置缺失时抛出异常
+     */
+    createVolcengineSaucProvider() {
+        const rawConfig = this.openspeechConfig?.tos;
+        if (!rawConfig) {
+            throw new Error('Volcengine OpenSpeech config (tos) not found in configuration');
+        }
+        const config = this.toVolcengineSaucConfig(rawConfig);
+        this.logger.info('Creating Volcengine OpenSpeech SAUC provider');
+        return new volcengine_streaming_provider_1.VolcengineStreamingAsrProvider(this.logger, config);
+    }
+    /**
+     * 检查指定云服务商的录音文件识别是否可用
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {boolean} 是否可用（配置存在）
+     *
+     * @example
+     * ```typescript
+     * if (factory.isVendorAvailable('oss')) {
+     *   const provider = factory.getProvider('oss');
+     *   // ...
+     * }
+     * ```
+     */
+    isVendorAvailable(vendor) {
+        switch (vendor) {
+            case 'oss':
+                return !!this.openspeechConfig?.oss;
+            case 'tos':
+                return !!this.openspeechConfig?.tos?.auc;
+            default:
+                return false;
+        }
+    }
+    /**
+     * 检查指定云服务商的流式识别是否可用
+     *
+     * @param {FileBucketVendor} vendor - 云服务商类型
+     * @returns {boolean} 是否可用（配置存在）
+     *
+     * @example
+     * ```typescript
+     * if (factory.isStreamingAvailable('tos')) {
+     *   const provider = factory.getStreamingProvider('tos');
+     *   // ...
+     * }
+     * ```
+     */
+    isStreamingAvailable(vendor) {
+        switch (vendor) {
+            case 'tos':
+                return !!this.openspeechConfig?.tos?.sauc;
+            default:
+                return false;
+        }
+    }
+    /**
+     * 获取所有可用的云服务商列表（录音文件识别）
+     *
+     * @returns {FileBucketVendor[]} 可用的云服务商列表
+     *
+     * @example
+     * ```typescript
+     * const vendors = factory.getAvailableVendors();
+     * console.log('Available vendors:', vendors);
+     * // 输出: ['oss', 'tos']
+     * ```
+     */
+    getAvailableVendors() {
+        const vendors = [];
+        if (this.openspeechConfig?.oss) {
+            vendors.push('oss');
+        }
+        if (this.openspeechConfig?.tos?.auc) {
+            vendors.push('tos');
+        }
+        return vendors;
+    }
+    /**
+     * 获取所有支持流式识别的云服务商列表
+     *
+     * @returns {FileBucketVendor[]} 支持流式识别的云服务商列表
+     *
+     * @example
+     * ```typescript
+     * const vendors = factory.getStreamingAvailableVendors();
+     * console.log('Streaming available vendors:', vendors);
+     * // 输出: ['tos']
+     * ```
+     */
+    getStreamingAvailableVendors() {
+        const vendors = [];
+        if (this.openspeechConfig?.tos?.sauc) {
+            vendors.push('tos');
+        }
+        return vendors;
+    }
+};
+exports.OpenspeechProviderFactory = OpenspeechProviderFactory;
+exports.OpenspeechProviderFactory = OpenspeechProviderFactory = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [axios_1.HttpService,
+        winston_1.Logger])
+], OpenspeechProviderFactory);
+//# sourceMappingURL=openspeech.factory.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview OpenSpeech 语音识别服务模块
+ *
+ * 本模块提供语音识别服务的 NestJS 模块配置，整合了：
+ * - OpenspeechClient: 语音识别服务门面
+ * - OpenspeechProviderFactory: 云服务商工厂
+ *
+ * @module openspeech/module
+ */
+/**
+ * OpenSpeech 语音识别服务模块
+ *
+ * @description 提供语音识别服务的依赖注入配置。
+ *
+ * 导出服务：
+ * - `OpenspeechClient`: 语音识别服务统一入口
+ * - `OpenspeechProviderFactory`: 云服务商工厂（可选，用于高级场景）
+ *
+ * 依赖模块：
+ * - `ConfigModule`: 配置服务
+ * - `HttpModule`: HTTP 客户端（用于火山引擎 API）
+ * - `FileStorageServiceModule`: 文件存储服务
+ *
+ * @example
+ * ```typescript
+ * // 在其他模块中导入
+ * @Module({
+ *   imports: [OpenspeechModule],
+ * })
+ * export class VideoModule {}
+ *
+ * // 在服务中使用
+ * @Injectable()
+ * class VideoService {
+ *   constructor(private readonly openspeech: OpenspeechClient) {}
+ *
+ *   async transcribe(fileKey: FileKey) {
+ *     return await this.openspeech.submitTranscribeTask(fileKey);
+ *   }
+ * }
+ * ```
+ */
+export declare class OpenspeechModule {
+}
+//# sourceMappingURL=openspeech.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openspeech.module.d.ts","sourceRoot":"","sources":["../../../src/internal/openspeech/openspeech.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAKa,gBAAgB;CAAG"}

package/dist/internal/openspeech/openspeech.module.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * @fileoverview OpenSpeech 语音识别服务模块
+ *
+ * 本模块提供语音识别服务的 NestJS 模块配置，整合了：
+ * - OpenspeechClient: 语音识别服务门面
+ * - OpenspeechProviderFactory: 云服务商工厂
+ *
+ * @module openspeech/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.OpenspeechModule = 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 openspeech_client_1 = require("./openspeech.client");
+const openspeech_factory_1 = require("./openspeech.factory");
+/**
+ * OpenSpeech 语音识别服务模块
+ *
+ * @description 提供语音识别服务的依赖注入配置。
+ *
+ * 导出服务：
+ * - `OpenspeechClient`: 语音识别服务统一入口
+ * - `OpenspeechProviderFactory`: 云服务商工厂（可选，用于高级场景）
+ *
+ * 依赖模块：
+ * - `ConfigModule`: 配置服务
+ * - `HttpModule`: HTTP 客户端（用于火山引擎 API）
+ * - `FileStorageServiceModule`: 文件存储服务
+ *
+ * @example
+ * ```typescript
+ * // 在其他模块中导入
+ * @Module({
+ *   imports: [OpenspeechModule],
+ * })
+ * export class VideoModule {}
+ *
+ * // 在服务中使用
+ * @Injectable()
+ * class VideoService {
+ *   constructor(private readonly openspeech: OpenspeechClient) {}
+ *
+ *   async transcribe(fileKey: FileKey) {
+ *     return await this.openspeech.submitTranscribeTask(fileKey);
+ *   }
+ * }
+ * ```
+ */
+let OpenspeechModule = class OpenspeechModule {
+};
+exports.OpenspeechModule = OpenspeechModule;
+exports.OpenspeechModule = OpenspeechModule = __decorate([
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule, axios_1.HttpModule, infra_shared_services_1.FileStorageServiceModule],
+        providers: [openspeech_factory_1.OpenspeechProviderFactory, openspeech_client_1.OpenspeechClient],
+        exports: [openspeech_client_1.OpenspeechClient, openspeech_factory_1.OpenspeechProviderFactory],
+    })
+], OpenspeechModule);
+//# sourceMappingURL=openspeech.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openspeech.module.js","sourceRoot":"","sources":["../../../src/internal/openspeech/openspeech.module.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;AAEH,2CAAwC;AACxC,2CAA8C;AAC9C,yCAA2C;AAC3C,uEAAuE;AACvE,2DAAuD;AACvD,6DAAiE;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAG,CAAA;AAAnB,4CAAgB;2BAAhB,gBAAgB;IAL5B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAY,EAAE,kBAAU,EAAE,gDAAwB,CAAC;QAC7D,SAAS,EAAE,CAAC,8CAAyB,EAAE,oCAAgB,CAAC;QACxD,OAAO,EAAE,CAAC,oCAAgB,EAAE,8CAAyB,CAAC;KACvD,CAAC;GACW,gBAAgB,CAAG"}

package/dist/internal/openspeech/providers/aliyun.provider.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @fileoverview 阿里云 OpenSpeech 语音识别服务提供商
+ *
+ * 本文件实现了阿里云 NLS（自然语言服务）的录音文件识别功能。
+ * 阿里云语音识别服务文档：https://help.aliyun.com/document_detail/90727.html
+ *
+ * @module openspeech/providers/aliyun
+ */
+import { Logger } from 'winston';
+import { FileBucketVendor } from '@prisma/client';
+import { BaseOpenspeechProvider } from './base.provider';
+import { SubmitTaskParams, TaskStatusResult, AliyunOpenspeechConfig } from '../types';
+/**
+ * 阿里云语音识别服务提供商
+ *
+ * @description 封装了阿里云 NLS 录音文件识别的核心功能：
+ * - 任务提交：将音频文件提交到阿里云进行语音识别
+ * - 状态查询：查询识别任务的处理状态和结果
+ *
+ * 主要特性：
+ * - 支持智能分轨（双声道对话场景）
+ * - 支持语义句子检测
+ * - 支持时间戳对齐
+ * - 支持回调通知
+ *
+ * @class AliyunOpenspeechProvider
+ * @extends {BaseOpenspeechProvider}
+ *
+ * @example
+ * ```typescript
+ * const provider = new AliyunOpenspeechProvider(logger, {
+ *   accessKeyId: 'your-access-key-id',
+ *   accessKeySecret: 'your-access-key-secret',
+ *   endpoint: 'https://nls-meta.cn-shanghai.aliyuncs.com',
+ *   nslAppKey: 'your-app-key',
+ * });
+ *
+ * // 提交任务
+ * const taskId = await provider.submitTask({
+ *   audioUrl: 'https://example.com/audio.mp3',
+ * });
+ *
+ * // 查询状态
+ * const result = await provider.queryTaskStatus(taskId);
+ * if (result.status === 'success') {
+ *   console.log('识别结果:', result.text);
+ * }
+ * ```
+ */
+export declare class AliyunOpenspeechProvider extends BaseOpenspeechProvider {
+    private readonly config;
+    /**
+     * 云服务商标识：阿里云 OSS
+     * @readonly
+     */
+    readonly vendor: FileBucketVendor;
+    /**
+     * 构造函数
+     *
+     * @param {Logger} logger - Winston 日志记录器
+     * @param {AliyunOpenspeechConfig} config - 阿里云配置
+     * @throws {Error} 配置缺失时抛出异常
+     */
+    constructor(logger: Logger, config: AliyunOpenspeechConfig);
+    /**
+     * 提交语音识别任务到阿里云
+     *
+     * @description 调用阿里云 NLS API 提交录音文件识别任务。
+     * 任务提交后，阿里云会异步处理，可通过回调或轮询获取结果。
+     *
+     * 任务配置说明：
+     * - auto_split: 开启智能分轨，适用于双方对话场景
+     * - enable_semantic_sentence_detection: 开启语义句子检测
+     * - enable_timestamp_alignment: 开启时间戳对齐
+     * - enable_callback: 开启回调通知
+     *
+     * @param {SubmitTaskParams} params - 任务提交参数
+     * @param {string} params.audioUrl - 音频文件 URL
+     * @param {string} [params.callbackUrl] - 回调 URL（可选，默认使用系统配置）
+     * @returns {Promise<string>} 阿里云返回的任务 ID (TaskId)
+     * @throws {Error} 配置缺失或 API 调用失败时抛出异常
+     *
+     * @example
+     * ```typescript
+     * const taskId = await provider.submitTask({
+     *   audioUrl: 'https://bucket.oss-cn-hangzhou.aliyuncs.com/audio.mp3',
+     * });
+     * console.log('Task ID:', taskId);
+     * ```
+     */
+    submitTask(params: SubmitTaskParams): Promise<string>;
+    /**
+     * 查询阿里云语音识别任务状态
+     *
+     * @description 调用阿里云 NLS API 查询任务状态。
+     * 任务状态包括：
+     * - SUCCESS: 识别成功，返回识别文本
+     * - RUNNING: 正在处理中
+     * - QUEUEING: 排队等待中
+     * - FAIL: 识别失败
+     * - EXPIRED: 任务过期
+     *
+     * @param {string} vendorTaskId - 阿里云任务 ID
+     * @returns {Promise<TaskStatusResult>} 任务状态和结果
+     *
+     * @example
+     * ```typescript
+     * const result = await provider.queryTaskStatus('task-123456');
+     *
+     * switch (result.status) {
+     *   case 'success':
+     *     console.log('识别文本:', result.text);
+     *     break;
+     *   case 'processing':
+     *     console.log('处理中，请稍后重试');
+     *     break;
+     *   case 'error':
+     *     console.error('识别失败:', result.error);
+     *     break;
+     * }
+     * ```
+     */
+    queryTaskStatus(vendorTaskId: string): Promise<TaskStatusResult>;
+}
+//# sourceMappingURL=aliyun.provider.d.ts.map

package/dist/internal/openspeech/providers/aliyun.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliyun.provider.d.ts","sourceRoot":"","sources":["../../../../src/internal/openspeech/providers/aliyun.provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAGlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,wBAAyB,SAAQ,sBAAsB;IAgBhE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAfzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAS;IAE1C;;;;;;OAMG;gBAED,MAAM,EAAE,MAAM,EACG,MAAM,EAAE,sBAAsB;IASjD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkG3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAuEvE"}