sa2kit 1.6.43 → 1.6.45

package/dist/showmasterpiece/migration/index.d.mts

@@ -0,0 +1,120 @@
+/**
+ * ShowMasterpiece模块 - 作品图片迁移工具
+ *
+ * 将现有的Base64图片数据迁移到通用文件服务系统
+ *
+ * 主要功能：
+ * - Base64图片解析和验证
+ * - 上传到通用文件服务
+ * - 更新数据库引用
+ * - 迁移状态跟踪
+ * - 回滚机制
+ */
+/**
+ * 迁移配置接口
+ */
+interface MigrationConfig {
+    /** 批处理大小 */
+    batchSize: number;
+    /** 是否试运行 */
+    dryRun: boolean;
+    /** 是否验证文件完整性 */
+    validateFiles: boolean;
+    /** 是否备份原数据 */
+    backupOldData: boolean;
+    /** 是否强制覆盖已存在的文件 */
+    forceOverwrite: boolean;
+    /** 是否上传到OSS */
+    enableOSSUpload: boolean;
+    /** 指定画集ID（空表示全部） */
+    collectionIds?: number[];
+}
+/**
+ * 迁移统计信息
+ */
+interface MigrationStats {
+    totalArtworks: number;
+    processedCount: number;
+    successCount: number;
+    failedCount: number;
+    skippedCount: number;
+    totalFileSize: number;
+    processedFileSize: number;
+    errors: Array<{
+        artworkId: number;
+        error: string;
+        timestamp: Date;
+    }>;
+}
+/**
+ * 作品迁移器类
+ */
+declare class ArtworkMigrator {
+    private readonly db;
+    private config;
+    private stats;
+    private folderCache;
+    private storageProviderCache;
+    constructor(db: any, config: MigrationConfig);
+    /**
+     * 开始迁移
+     */
+    migrate(): Promise<MigrationStats>;
+    /**
+     * 分析现有数据
+     */
+    private analyzeData;
+    /**
+     * 准备迁移环境
+     */
+    private prepareMigrationEnvironment;
+    /**
+   * 确保存储提供者存在
+   */
+    private ensureStorageProvider;
+    /**
+   * 确保模块文件夹存在
+   */
+    private ensureModuleFolders;
+    /**
+     * 备份原始数据
+     */
+    private backupOriginalData;
+    /**
+     * 执行批量迁移
+     */
+    private performBatchMigration;
+    /**
+     * 迁移单个作品
+     */
+    private migrateArtwork;
+    /**
+     * 解析Base64图片
+     */
+    private parseBase64Image;
+    /**
+     * 生成迁移报告
+     */
+    private generateReport;
+    /**
+     * 回滚单个作品
+     */
+    rollbackArtwork(artworkId: number): Promise<void>;
+}
+
+/**
+ * ShowMasterpiece模块 - 作品图片迁移运行脚本
+ *
+ * 将Base64图片数据迁移到通用文件服务系统的逻辑封装。
+ */
+
+interface ParsedMigrationArgs {
+    config: MigrationConfig;
+    showHelp: boolean;
+}
+declare function parseMigrationArguments(args: string[]): ParsedMigrationArgs;
+declare function getMigrationHelpText(): string;
+declare function validateMigrationPrerequisites(config: MigrationConfig): void;
+declare function runArtworkMigration(db: any, config: MigrationConfig): Promise<MigrationStats>;
+
+export { ArtworkMigrator, type MigrationConfig, type MigrationStats, type ParsedMigrationArgs, getMigrationHelpText, parseMigrationArguments, runArtworkMigration, validateMigrationPrerequisites };

package/dist/showmasterpiece/migration/index.d.ts

@@ -0,0 +1,120 @@
+/**
+ * ShowMasterpiece模块 - 作品图片迁移工具
+ *
+ * 将现有的Base64图片数据迁移到通用文件服务系统
+ *
+ * 主要功能：
+ * - Base64图片解析和验证
+ * - 上传到通用文件服务
+ * - 更新数据库引用
+ * - 迁移状态跟踪
+ * - 回滚机制
+ */
+/**
+ * 迁移配置接口
+ */
+interface MigrationConfig {
+    /** 批处理大小 */
+    batchSize: number;
+    /** 是否试运行 */
+    dryRun: boolean;
+    /** 是否验证文件完整性 */
+    validateFiles: boolean;
+    /** 是否备份原数据 */
+    backupOldData: boolean;
+    /** 是否强制覆盖已存在的文件 */
+    forceOverwrite: boolean;
+    /** 是否上传到OSS */
+    enableOSSUpload: boolean;
+    /** 指定画集ID（空表示全部） */
+    collectionIds?: number[];
+}
+/**
+ * 迁移统计信息
+ */
+interface MigrationStats {
+    totalArtworks: number;
+    processedCount: number;
+    successCount: number;
+    failedCount: number;
+    skippedCount: number;
+    totalFileSize: number;
+    processedFileSize: number;
+    errors: Array<{
+        artworkId: number;
+        error: string;
+        timestamp: Date;
+    }>;
+}
+/**
+ * 作品迁移器类
+ */
+declare class ArtworkMigrator {
+    private readonly db;
+    private config;
+    private stats;
+    private folderCache;
+    private storageProviderCache;
+    constructor(db: any, config: MigrationConfig);
+    /**
+     * 开始迁移
+     */
+    migrate(): Promise<MigrationStats>;
+    /**
+     * 分析现有数据
+     */
+    private analyzeData;
+    /**
+     * 准备迁移环境
+     */
+    private prepareMigrationEnvironment;
+    /**
+   * 确保存储提供者存在
+   */
+    private ensureStorageProvider;
+    /**
+   * 确保模块文件夹存在
+   */
+    private ensureModuleFolders;
+    /**
+     * 备份原始数据
+     */
+    private backupOriginalData;
+    /**
+     * 执行批量迁移
+     */
+    private performBatchMigration;
+    /**
+     * 迁移单个作品
+     */
+    private migrateArtwork;
+    /**
+     * 解析Base64图片
+     */
+    private parseBase64Image;
+    /**
+     * 生成迁移报告
+     */
+    private generateReport;
+    /**
+     * 回滚单个作品
+     */
+    rollbackArtwork(artworkId: number): Promise<void>;
+}
+
+/**
+ * ShowMasterpiece模块 - 作品图片迁移运行脚本
+ *
+ * 将Base64图片数据迁移到通用文件服务系统的逻辑封装。
+ */
+
+interface ParsedMigrationArgs {
+    config: MigrationConfig;
+    showHelp: boolean;
+}
+declare function parseMigrationArguments(args: string[]): ParsedMigrationArgs;
+declare function getMigrationHelpText(): string;
+declare function validateMigrationPrerequisites(config: MigrationConfig): void;
+declare function runArtworkMigration(db: any, config: MigrationConfig): Promise<MigrationStats>;
+
+export { ArtworkMigrator, type MigrationConfig, type MigrationStats, type ParsedMigrationArgs, getMigrationHelpText, parseMigrationArguments, runArtworkMigration, validateMigrationPrerequisites };