@dofe/infra-shared-services 0.1.17 → 0.1.19

package/dist/openspeech/providers/aliyun.provider.js

@@ -0,0 +1,274 @@
+"use strict";
+/**
+ * @fileoverview 阿里云 OpenSpeech 语音识别服务提供商
+ *
+ * 本文件实现了阿里云 NLS（自然语言服务）的录音文件识别功能。
+ * 阿里云语音识别服务文档：https://help.aliyun.com/document_detail/90727.html
+ *
+ * @module openspeech/providers/aliyun
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AliyunOpenspeechProvider = void 0;
+const base_provider_1 = require("./base.provider");
+const infra_utils_1 = require("@dofe/infra-utils");
+/**
+ * 阿里云语音识别服务提供商
+ *
+ * @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);
+ * }
+ * ```
+ */
+class AliyunOpenspeechProvider extends base_provider_1.BaseOpenspeechProvider {
+    config;
+    /**
+     * 云服务商标识：阿里云 OSS
+     * @readonly
+     */
+    vendor = 'oss';
+    /**
+     * 构造函数
+     *
+     * @param {Logger} logger - Winston 日志记录器
+     * @param {AliyunOpenspeechConfig} config - 阿里云配置
+     * @throws {Error} 配置缺失时抛出异常
+     */
+    constructor(logger, config) {
+        super(logger);
+        this.config = config;
+        if (!config) {
+            throw new Error('Aliyun OpenSpeech config is required');
+        }
+    }
+    /**
+     * 提交语音识别任务到阿里云
+     *
+     * @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);
+     * ```
+     */
+    async submitTask(params) {
+        const { audioUrl, callbackUrl } = params;
+        if (!this.config) {
+            throw new Error('Aliyun OpenSpeech config (oss) not found');
+        }
+        // 校验必要的配置项
+        if (!this.config.accessKeyId || !this.config.accessKeySecret) {
+            throw new Error('Aliyun OpenSpeech config missing accessKeyId or accessKeySecret');
+        }
+        if (!this.config.nslAppKey) {
+            throw new Error('Aliyun OpenSpeech config missing nslAppKey');
+        }
+        // 动态引入阿里云 NLS SDK
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const NlsClient = require('@alicloud/nls-filetrans-2018-08-17');
+        try {
+            // 创建 NLS 客户端实例
+            const nlsClient = new NlsClient({
+                accessKeyId: this.config.accessKeyId,
+                accessKeySecret: this.config.accessKeySecret,
+                endpoint: this.config.endpoint,
+                apiVersion: this.config.apiVersion || '2018-08-17',
+            });
+            // 构建回调 URL
+            const webhookUrl = callbackUrl ||
+                `${infra_utils_1.environmentUtil.generateEnvironmentUrls().api}/webhook/audio-transcribe/oss`;
+            // 构建任务参数
+            // 详细参数说明参考：https://help.aliyun.com/document_detail/90727.html
+            const task = {
+                // 应用 AppKey
+                app_key: this.config.nslAppKey,
+                // 音频文件链接
+                file_link: audioUrl,
+                // API 版本，4.0 支持更多功能
+                version: '4.0',
+                // 是否返回词级别时间戳
+                enable_words: false,
+                // 是否开启回调
+                enable_callback: true,
+                // 是否开启采样率自适应
+                enable_sample_rate_adaptive: true,
+                // 回调地址
+                callback_url: webhookUrl,
+                // 智能分轨：双声道对话场景下，根据 ChannelId 判断发言人
+                auto_split: true,
+                // 语气词过滤（声音顺滑）
+                enable_disfluency: false,
+                // 语义句子检测：识别句子中的语义信息
+                enable_semantic_sentence_detection: true,
+                // 时间戳对齐：识别句子中的时间戳信息
+                enable_timestamp_alignment: true,
+            };
+            const taskParams = {
+                Task: JSON.stringify(task),
+            };
+            const options = {
+                method: 'POST',
+            };
+            this.logInfo('Submitting transcription task', {
+                audioUrl,
+                callbackUrl: webhookUrl,
+            });
+            // 提交任务
+            const submitResp = await nlsClient.submitTask(taskParams, options);
+            const taskId = submitResp?.TaskId;
+            if (!taskId) {
+                this.logError('Submit task failed: TaskId missing', {
+                    response: submitResp,
+                });
+                throw new Error('Aliyun submitTask failed: TaskId missing');
+            }
+            this.logInfo('Task submitted successfully', { taskId });
+            return taskId;
+        }
+        catch (error) {
+            this.logError('Submit task error', {
+                audioUrl,
+                error: error.message,
+            });
+            throw error;
+        }
+    }
+    /**
+     * 查询阿里云语音识别任务状态
+     *
+     * @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;
+     * }
+     * ```
+     */
+    async queryTaskStatus(vendorTaskId) {
+        if (!this.config) {
+            throw new Error('Aliyun OpenSpeech config (oss) not found');
+        }
+        // 校验必要的配置项
+        if (!this.config.accessKeyId || !this.config.accessKeySecret) {
+            throw new Error('Aliyun OpenSpeech config missing accessKeyId or accessKeySecret');
+        }
+        // 动态引入阿里云 NLS SDK
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const NlsClient = require('@alicloud/nls-filetrans-2018-08-17');
+        try {
+            const nlsClient = new NlsClient({
+                accessKeyId: this.config.accessKeyId,
+                accessKeySecret: this.config.accessKeySecret,
+                endpoint: this.config.endpoint,
+                apiVersion: this.config.apiVersion || '2018-08-17',
+            });
+            // 查询任务结果
+            const resultResp = await nlsClient.getTaskResult({
+                TaskId: vendorTaskId,
+            });
+            const status = resultResp?.StatusText;
+            // 处理成功状态
+            if (status === 'SUCCESS') {
+                const text = resultResp?.Result;
+                const textStr = typeof text === 'string' ? text : JSON.stringify(text || '');
+                this.logInfo('Transcription succeeded', { vendorTaskId });
+                return {
+                    status: 'success',
+                    text: textStr,
+                };
+            }
+            // 处理失败状态
+            if (status === 'FAIL' || status === 'EXPIRED') {
+                this.logError('Transcription failed', {
+                    vendorTaskId,
+                    status,
+                    response: resultResp,
+                });
+                return {
+                    status: 'error',
+                    error: `Aliyun transcription failed, status=${status}`,
+                };
+            }
+            // 其他状态（RUNNING, QUEUEING 等）视为处理中
+            return {
+                status: 'processing',
+            };
+        }
+        catch (error) {
+            this.logError('Query task status error', {
+                vendorTaskId,
+                error: error.message,
+            });
+            return {
+                status: 'error',
+                error: error.message,
+            };
+        }
+    }
+}
+exports.AliyunOpenspeechProvider = AliyunOpenspeechProvider;
+//# sourceMappingURL=aliyun.provider.js.map

package/dist/openspeech/providers/aliyun.provider.js.map

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

package/dist/openspeech/providers/base.provider.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @fileoverview OpenSpeech 服务提供商基类
+ *
+ * 本文件定义了语音识别服务提供商的抽象基类，提供了通用的日志记录功能，
+ * 并定义了子类必须实现的抽象方法。
+ *
+ * @module openspeech/providers/base
+ */
+import { Logger } from 'winston';
+import { FileBucketVendor } from '@prisma/client';
+import { IOpenspeechProvider, SubmitTaskParams, TaskStatusResult } from '../types';
+/**
+ * 语音识别服务提供商抽象基类
+ *
+ * @description 提供了所有云服务商实现类的公共基础设施：
+ * - 统一的日志记录器注入
+ * - 定义子类必须实现的抽象方法
+ * - 提供便捷的日志记录方法
+ *
+ * @abstract
+ * @class BaseOpenspeechProvider
+ * @implements {IOpenspeechProvider}
+ *
+ * @example
+ * ```typescript
+ * class MyProvider extends BaseOpenspeechProvider {
+ *   readonly vendor = 'oss';
+ *
+ *   constructor(logger: Logger) {
+ *     super(logger);
+ *   }
+ *
+ *   async submitTask(params: SubmitTaskParams): Promise<string> {
+ *     this.logInfo('Submitting task', { audioUrl: params.audioUrl });
+ *     // 实现提交逻辑
+ *   }
+ *
+ *   async queryTaskStatus(vendorTaskId: string): Promise<TaskStatusResult> {
+ *     // 实现查询逻辑
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseOpenspeechProvider implements IOpenspeechProvider {
+    protected readonly logger: Logger;
+    /**
+     * 云服务商标识，子类必须定义
+     */
+    abstract readonly vendor: FileBucketVendor;
+    /**
+     * 构造函数
+     *
+     * @param {Logger} logger - Winston 日志记录器实例
+     * @protected
+     */
+    constructor(logger: Logger);
+    /**
+     * 提交语音识别任务
+     *
+     * @abstract
+     * @param {SubmitTaskParams} params - 任务提交参数
+     * @returns {Promise<string>} 云服务商返回的任务 ID
+     */
+    abstract submitTask(params: SubmitTaskParams): Promise<string>;
+    /**
+     * 查询语音识别任务状态
+     *
+     * @abstract
+     * @param {string} vendorTaskId - 云服务商的任务 ID
+     * @returns {Promise<TaskStatusResult>} 任务状态和结果
+     */
+    abstract queryTaskStatus(vendorTaskId: string): Promise<TaskStatusResult>;
+    /**
+     * 记录信息日志
+     *
+     * @protected
+     * @param {string} message - 日志消息
+     * @param {Record<string, unknown>} [meta] - 附加元数据
+     */
+    protected logInfo(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * 记录错误日志
+     *
+     * @protected
+     * @param {string} message - 日志消息
+     * @param {Record<string, unknown>} [meta] - 附加元数据
+     */
+    protected logError(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * 记录警告日志
+     *
+     * @protected
+     * @param {string} message - 日志消息
+     * @param {Record<string, unknown>} [meta] - 附加元数据
+     */
+    protected logWarn(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=base.provider.d.ts.map

package/dist/openspeech/providers/base.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.provider.d.ts","sourceRoot":"","sources":["../../../src/openspeech/providers/base.provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,8BAAsB,sBAAuB,YAAW,mBAAmB;IAY7D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAX7C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAE3C;;;;;OAKG;gBAC4B,MAAM,EAAE,MAAM;IAE7C;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9D;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAEzE;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxE;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIzE;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGzE"}

package/dist/openspeech/providers/base.provider.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * @fileoverview OpenSpeech 服务提供商基类
+ *
+ * 本文件定义了语音识别服务提供商的抽象基类，提供了通用的日志记录功能，
+ * 并定义了子类必须实现的抽象方法。
+ *
+ * @module openspeech/providers/base
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseOpenspeechProvider = void 0;
+/**
+ * 语音识别服务提供商抽象基类
+ *
+ * @description 提供了所有云服务商实现类的公共基础设施：
+ * - 统一的日志记录器注入
+ * - 定义子类必须实现的抽象方法
+ * - 提供便捷的日志记录方法
+ *
+ * @abstract
+ * @class BaseOpenspeechProvider
+ * @implements {IOpenspeechProvider}
+ *
+ * @example
+ * ```typescript
+ * class MyProvider extends BaseOpenspeechProvider {
+ *   readonly vendor = 'oss';
+ *
+ *   constructor(logger: Logger) {
+ *     super(logger);
+ *   }
+ *
+ *   async submitTask(params: SubmitTaskParams): Promise<string> {
+ *     this.logInfo('Submitting task', { audioUrl: params.audioUrl });
+ *     // 实现提交逻辑
+ *   }
+ *
+ *   async queryTaskStatus(vendorTaskId: string): Promise<TaskStatusResult> {
+ *     // 实现查询逻辑
+ *   }
+ * }
+ * ```
+ */
+class BaseOpenspeechProvider {
+    logger;
+    /**
+     * 构造函数
+     *
+     * @param {Logger} logger - Winston 日志记录器实例
+     * @protected
+     */
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * 记录信息日志
+     *
+     * @protected
+     * @param {string} message - 日志消息
+     * @param {Record<string, unknown>} [meta] - 附加元数据
+     */
+    logInfo(message, meta) {
+        this.logger.info(`[${this.vendor}] ${message}`, meta);
+    }
+    /**
+     * 记录错误日志
+     *
+     * @protected
+     * @param {string} message - 日志消息
+     * @param {Record<string, unknown>} [meta] - 附加元数据
+     */
+    logError(message, meta) {
+        this.logger.error(`[${this.vendor}] ${message}`, meta);
+    }
+    /**
+     * 记录警告日志
+     *
+     * @protected
+     * @param {string} message - 日志消息
+     * @param {Record<string, unknown>} [meta] - 附加元数据
+     */
+    logWarn(message, meta) {
+        this.logger.warn(`[${this.vendor}] ${message}`, meta);
+    }
+}
+exports.BaseOpenspeechProvider = BaseOpenspeechProvider;
+//# sourceMappingURL=base.provider.js.map

package/dist/openspeech/providers/base.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.provider.js","sourceRoot":"","sources":["../../../src/openspeech/providers/base.provider.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAUH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAsB,sBAAsB;IAYX;IAN/B;;;;;OAKG;IACH,YAA+B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAoBjD;;;;;;OAMG;IACO,OAAO,CAAC,OAAe,EAAE,IAA8B;QAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;OAMG;IACO,QAAQ,CAAC,OAAe,EAAE,IAA8B;QAChE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;OAMG;IACO,OAAO,CAAC,OAAe,EAAE,IAA8B;QAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;CACF;AAhED,wDAgEC"}

package/dist/openspeech/providers/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview OpenSpeech 服务提供商导出
+ *
+ * @module openspeech/providers
+ */
+export * from './base.provider';
+export * from './aliyun.provider';
+export * from './volcengine.provider';
+export * from './volcengine-streaming.provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/openspeech/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/openspeech/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC"}

package/dist/openspeech/providers/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * @fileoverview OpenSpeech 服务提供商导出
+ *
+ * @module openspeech/providers
+ */
+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 });
+__exportStar(require("./base.provider"), exports);
+__exportStar(require("./aliyun.provider"), exports);
+__exportStar(require("./volcengine.provider"), exports);
+__exportStar(require("./volcengine-streaming.provider"), exports);
+//# sourceMappingURL=index.js.map

package/dist/openspeech/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/openspeech/providers/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,oDAAkC;AAClC,wDAAsC;AACtC,kEAAgD"}