@dofe/infra-shared-services 0.1.17 → 0.1.19

package/dist/transcode/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Transcode Client
+ *
+ * 纯转码 Client 模块:
+ * - TranscodeStrategyModule/TranscodeStrategyClient - 策略路由
+ * - AliyunImmModule/AliyunImmClient - 阿里云 IMM
+ * - AliyunOssTranscodeModule/AliyunOssTranscodeClient - 阿里云 OSS
+ * - VolcengineTosTranscodeModule/VolcengineTosTranscodeClient - 火山引擎 TOS
+ *
+ * 注意: 业务逻辑层使用 @app/services/transcode
+ */
+export * from './modules/transcode-strategy/transcode-strategy.module';
+export { TranscodeStrategyClient } from './modules/transcode-strategy/transcode-strategy.client';
+export * from './modules/aliyun-oss/aliyun-oss-transcode.module';
+export { AliyunOssTranscodeClient, TranscodeOptions, SpriteOptions, SnapshotOptions, } from './modules/aliyun-oss/aliyun-oss-transcode.client';
+export * from './modules/aliyun-imm/aliyun-imm.module';
+export { AliyunImmClient, MediaMetaResult, MediaConvertTaskResult, TaskStatus, AudioExtractOptions, } from './modules/aliyun-imm/aliyun-imm.client';
+export * from './modules/volcengine-tos/volcengine-tos-transcode.module';
+export { VolcengineTosTranscodeClient } from './modules/volcengine-tos/volcengine-tos-transcode.client';
+export * from './modules/volcengine-tos/volcengine-tos-transcode.dto';
+export * from './types/transcode.types';
+export * from './utils/file.validator';
+export * from './utils/transcode.helper';
+export * from './config/transcode.config';
+export * from './config/aliyun-oss.config';
+export { CloudTranscodeConfig, defaultCloudTranscodeConfig, } from './config/transcode.config';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transcode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,cAAc,wDAAwD,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AAGjG,cAAc,kDAAkD,CAAC;AACjE,OAAO,EACH,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,EACb,eAAe,GAClB,MAAM,kDAAkD,CAAC;AAG1D,cAAc,wCAAwC,CAAC;AACvD,OAAO,EACH,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,mBAAmB,GACtB,MAAM,wCAAwC,CAAC;AAGhD,cAAc,0DAA0D,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,0DAA0D,CAAC;AACxG,cAAc,uDAAuD,CAAC;AAGtE,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAG3C,OAAO,EACH,oBAAoB,EACpB,2BAA2B,GAC9B,MAAM,2BAA2B,CAAC"}

package/dist/transcode/index.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Transcode Client
+ *
+ * 纯转码 Client 模块:
+ * - TranscodeStrategyModule/TranscodeStrategyClient - 策略路由
+ * - AliyunImmModule/AliyunImmClient - 阿里云 IMM
+ * - AliyunOssTranscodeModule/AliyunOssTranscodeClient - 阿里云 OSS
+ * - VolcengineTosTranscodeModule/VolcengineTosTranscodeClient - 火山引擎 TOS
+ *
+ * 注意: 业务逻辑层使用 @app/services/transcode
+ */
+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.defaultCloudTranscodeConfig = exports.VolcengineTosTranscodeClient = exports.AliyunImmClient = exports.AliyunOssTranscodeClient = exports.TranscodeStrategyClient = void 0;
+// 转码策略模块 (纯 Client)
+__exportStar(require("./modules/transcode-strategy/transcode-strategy.module"), exports);
+var transcode_strategy_client_1 = require("./modules/transcode-strategy/transcode-strategy.client");
+Object.defineProperty(exports, "TranscodeStrategyClient", { enumerable: true, get: function () { return transcode_strategy_client_1.TranscodeStrategyClient; } });
+// 阿里云 OSS 转码模块 (纯 Client)
+__exportStar(require("./modules/aliyun-oss/aliyun-oss-transcode.module"), exports);
+var aliyun_oss_transcode_client_1 = require("./modules/aliyun-oss/aliyun-oss-transcode.client");
+Object.defineProperty(exports, "AliyunOssTranscodeClient", { enumerable: true, get: function () { return aliyun_oss_transcode_client_1.AliyunOssTranscodeClient; } });
+// 阿里云 IMM 模块 (纯 Client)
+__exportStar(require("./modules/aliyun-imm/aliyun-imm.module"), exports);
+var aliyun_imm_client_1 = require("./modules/aliyun-imm/aliyun-imm.client");
+Object.defineProperty(exports, "AliyunImmClient", { enumerable: true, get: function () { return aliyun_imm_client_1.AliyunImmClient; } });
+// 火山引擎 TOS 转码模块 (纯 Client)
+__exportStar(require("./modules/volcengine-tos/volcengine-tos-transcode.module"), exports);
+var volcengine_tos_transcode_client_1 = require("./modules/volcengine-tos/volcengine-tos-transcode.client");
+Object.defineProperty(exports, "VolcengineTosTranscodeClient", { enumerable: true, get: function () { return volcengine_tos_transcode_client_1.VolcengineTosTranscodeClient; } });
+__exportStar(require("./modules/volcengine-tos/volcengine-tos-transcode.dto"), exports);
+// 工具类和类型
+__exportStar(require("./types/transcode.types"), exports);
+__exportStar(require("./utils/file.validator"), exports);
+__exportStar(require("./utils/transcode.helper"), exports);
+__exportStar(require("./config/transcode.config"), exports);
+__exportStar(require("./config/aliyun-oss.config"), exports);
+// 配置接口
+var transcode_config_1 = require("./config/transcode.config");
+Object.defineProperty(exports, "defaultCloudTranscodeConfig", { enumerable: true, get: function () { return transcode_config_1.defaultCloudTranscodeConfig; } });
+//# sourceMappingURL=index.js.map

package/dist/transcode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transcode/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;AAEH,oBAAoB;AACpB,yFAAuE;AACvE,oGAAiG;AAAxF,oIAAA,uBAAuB,OAAA;AAEhC,0BAA0B;AAC1B,mFAAiE;AACjE,gGAK0D;AAJtD,uIAAA,wBAAwB,OAAA;AAM5B,wBAAwB;AACxB,yEAAuD;AACvD,4EAMgD;AAL5C,oHAAA,eAAe,OAAA;AAOnB,2BAA2B;AAC3B,2FAAyE;AACzE,4GAAwG;AAA/F,+IAAA,4BAA4B,OAAA;AACrC,wFAAsE;AAEtE,SAAS;AACT,0DAAwC;AACxC,yDAAuC;AACvC,2DAAyC;AACzC,4DAA0C;AAC1C,6DAA2C;AAE3C,OAAO;AACP,8DAGmC;AAD/B,+HAAA,2BAA2B,OAAA"}

package/dist/transcode/modules/aliyun-imm/aliyun-imm.client.d.ts

@@ -0,0 +1,157 @@
+import { ConfigService } from '@nestjs/config';
+import { Logger } from 'winston';
+import { FileBucketVendor, VideoQuality, VideoInfo, AudioInfo, ImageInfo } from '@prisma/client';
+export interface MediaMetaResult {
+    type: 'video' | 'audio' | 'image';
+    info: Partial<VideoInfo | AudioInfo | ImageInfo>;
+    rawData: any;
+}
+export interface MediaConvertTaskResult {
+    taskId: string;
+    requestId: string;
+    eventId: string;
+}
+export interface AudioExtractOptions {
+    format?: 'mp3' | 'aac' | 'flac' | 'wav';
+    bitrate?: number;
+    /**
+     * 采样率，单位：Hz
+     * 注意：如果用于阿里云语音识别，采样率必须是 8000 或 16000 Hz
+     * 默认值：16000 Hz（符合阿里云语音识别要求）
+     * 如果传入其他值，会自动规范化到最接近的合规值（8000 或 16000）
+     */
+    sampleRate?: number;
+    channels?: number;
+}
+export interface TaskStatus {
+    status: string;
+    progress?: number;
+    result?: any;
+    error?: string;
+}
+export declare enum ImmTaskType {
+    CreateVideoLabelClassificationTask = "VideoLabelClassification",// 视频标签检测任务
+    CreateFigureClusteringTask = "FaceClustering",// 人脸聚类分组任务
+    CreateOfficeConversionTask = "OfficeConversion",// 文档转换任务
+    CreateImageModerationTask = "ImageModeration",// 图片识别任务
+    CreateVideoModerationTask = "VideoModeration",// 视频识别任务
+    CreateMediaConvertTask = "MediaConvert",// 视频转码任务
+    CreateFileCompressionTask = "FileCompression",// 文件压缩任务
+    CreateArchiveFileInspectionTask = "ArchiveFileInspection",// 查看文件压缩内容任务
+    CreateFileUncompressionTask = "FileUncompression",// 文件解压任务
+    CreateCompressPointCloudTask = "PointCloudCompress",// 点云压缩任务
+    CreateImageToPDFTask = "ImageToPDF",// 图片转PDF任务
+    CreateStory = "StoryCreation",// 创建故事任务
+    CreateLocationDateClusteringTask = "LocationDateClustering",// 时空聚类分组任务
+    CreateImageSplicingTask = "ImageSplicing",// 图片拼接任务
+    CreateFacesSearchingTask = "FacesSearching"
+}
+export declare class AliyunImmClient {
+    private readonly logger;
+    private readonly configService;
+    private readonly config;
+    private readonly appConfig;
+    constructor(logger: Logger, configService: ConfigService);
+    /**
+     * 获取阿里云 OSS 配置
+     */
+    private getAliyunImmConfig;
+    /**
+     * 创建 IMM 客户端
+     */
+    private createClient;
+    /**
+     * 检测媒体文件元信息
+     */
+    detectMediaMeta(vendor: FileBucketVendor, bucket: string, key: string, type: 'video' | 'audio' | 'image' | 'else'): Promise<MediaMetaResult>;
+    /**
+     * 构建输出文件的key
+     */
+    private buildOutputKey;
+    /**
+     * 创建媒体转码任务
+     * 根据阿里云IMM API规范优化
+     */
+    createMediaConvertTask(vendor: FileBucketVendor, bucket: string, key: string, qualities?: VideoQuality[] | VideoQuality, index?: number): Promise<MediaConvertTaskResult>;
+    /**
+     * 获取任务状态
+     */
+    getTask(vendor: FileBucketVendor, bucket: string, taskId: string, taskType?: ImmTaskType): Promise<TaskStatus>;
+    /**
+     * 获取项目名称（基于 vendor 和 bucket）
+     */
+    private getProjectName;
+    /**
+     * 构建目标文件 URI
+     */
+    private buildTargetUri;
+    /**
+     * 构建目标文件 URL
+     */
+    private buildTargetUrl;
+    /**
+     * 构建媒体元数据
+     * 根据阿里云IMM API规范优化
+     */
+    private buildMediaMetadata;
+    /**
+     * 标准化比特率格式
+     */
+    private normalizeBitrate;
+    /**
+     * 标准化帧率格式
+     */
+    private normalizeFrameRate;
+    /**
+     * 标准化音频比特率格式
+     */
+    private normalizeAudioBitrate;
+    /**
+     * 解析媒体元信息响应
+     */
+    private parseMediaMetaResponse;
+    /**
+     * 解析任务状态响应
+     */
+    private parseTaskStatus;
+    /**
+     * 获取分辨率宽度
+     */
+    private getResolutionWidth;
+    /**
+     * 获取分辨率高度
+     */
+    private getResolutionHeight;
+    /**
+     * 构建视频转码配置
+     * 根据阿里云IMM API文档：https://help.aliyun.com/zh/imm/developer-reference/api-imm-2020-09-30-createmediaconverttask
+     */
+    private buildTargetVideo;
+    /**
+     * 构建音频转码配置
+     * 根据阿里云IMM API文档
+     */
+    private buildTargetAudio;
+    /**
+     * 规范化采样率，确保符合阿里云语音识别要求（8000 或 16000 Hz）
+     * 如果采样率不符合要求，选择最接近的合规值
+     * @param sampleRate 原始采样率
+     * @returns 规范化后的采样率（8000 或 16000）
+     */
+    private normalizeSampleRateForSpeechRecognition;
+    /**
+     * 从视频中提取音频
+     * 参考：https://help.aliyun.com/zh/imm/user-guide/audio-transcoding
+     * 注意：默认采样率设置为 16000 Hz，符合阿里云语音识别要求
+     */
+    extractAudioFromVideo(vendor: FileBucketVendor, bucket: string, key: string, options?: AudioExtractOptions): Promise<MediaConvertTaskResult>;
+    /**
+     * 构建音频提取的目标文件key
+     */
+    private buildAudioExtractKey;
+    /**
+     * 根据音频格式获取编码器
+     */
+    private getAudioCodec;
+}
+//# sourceMappingURL=aliyun-imm.client.d.ts.map

package/dist/transcode/modules/aliyun-imm/aliyun-imm.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliyun-imm.client.d.ts","sourceRoot":"","sources":["../../../../src/transcode/modules/aliyun-imm/aliyun-imm.client.ts"],"names":[],"mappings":"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"}