yx-oss-cli 1.0.0

package/dist/bin/oss-cli.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+/**
+ * OSS CLI - 阿里云 OSS 命令行工具
+ * 支持文件上传、删除、同步等操作
+ */
+import { Command } from 'commander';
+import { ConfigService } from '../services/config.service.js';
+import { OssService } from '../services/oss.service.js';
+import { FileService } from '../services/file.service.js';
+import { Logger } from '../utils/logger.js';
+const program = new Command();
+program
+    .name('oss-cli')
+    .description('阿里云 OSS 命令行工具')
+    .version('1.0.0');
+// 全局选项
+program
+    .option('--access-key-id <id>', 'AccessKey ID')
+    .option('--access-key-secret <secret>', 'AccessKey Secret')
+    .option('--bucket <name>', 'Bucket 名称')
+    .option('--region <region>', '区域', 'oss-cn-shanghai')
+    .option('--concurrency <n>', '并发数', '10');
+/**
+ * test 命令 - 测试 OSS 连接
+ */
+program
+    .command('test')
+    .description('测试 OSS 连接')
+    .action(async () => {
+    try {
+        const opts = program.opts();
+        const ossConfig = ConfigService.getOssConfig({
+            accessKeyId: opts.accessKeyId,
+            accessKeySecret: opts.accessKeySecret,
+            bucket: opts.bucket,
+            region: opts.region,
+        });
+        const validation = ConfigService.validateConfig(ossConfig);
+        if (!validation.valid) {
+            validation.errors.forEach((err) => Logger.error(err));
+            process.exit(1);
+        }
+        const ossService = new OssService(ossConfig);
+        await ossService.testConnection();
+    }
+    catch {
+        process.exit(1);
+    }
+});
+/**
+ * sync 命令 - 同步目录（先删除再上传）
+ */
+program
+    .command('sync <localPath> <ossPath>')
+    .description('同步本地目录到 OSS（先删除目标目录，再上传）')
+    .action(async (localPath, ossPath) => {
+    try {
+        const opts = program.opts();
+        const ossConfig = ConfigService.getOssConfig({
+            accessKeyId: opts.accessKeyId,
+            accessKeySecret: opts.accessKeySecret,
+            bucket: opts.bucket,
+            region: opts.region,
+        });
+        const validation = ConfigService.validateConfig(ossConfig);
+        if (!validation.valid) {
+            validation.errors.forEach((err) => Logger.error(err));
+            process.exit(1);
+        }
+        // 检查本地路径是否存在
+        if (!(await FileService.exists(localPath))) {
+            Logger.error(`本地路径不存在: ${localPath}`);
+            process.exit(1);
+        }
+        if (!(await FileService.isDirectory(localPath))) {
+            Logger.error(`本地路径不是目录: ${localPath}`);
+            process.exit(1);
+        }
+        const cliOptions = ConfigService.getCliOptions({
+            concurrency: parseInt(opts.concurrency, 10),
+        });
+        const ossService = new OssService(ossConfig);
+        const result = await ossService.syncDirectory(localPath, ossPath, cliOptions);
+        if (result.uploadResult.failed > 0) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        const err = error;
+        Logger.error(err.message);
+        process.exit(1);
+    }
+});
+/**
+ * upload 命令 - 上传文件或目录
+ */
+program
+    .command('upload <localPath> <ossPath>')
+    .description('上传本地文件或目录到 OSS')
+    .action(async (localPath, ossPath) => {
+    try {
+        const opts = program.opts();
+        const ossConfig = ConfigService.getOssConfig({
+            accessKeyId: opts.accessKeyId,
+            accessKeySecret: opts.accessKeySecret,
+            bucket: opts.bucket,
+            region: opts.region,
+        });
+        const validation = ConfigService.validateConfig(ossConfig);
+        if (!validation.valid) {
+            validation.errors.forEach((err) => Logger.error(err));
+            process.exit(1);
+        }
+        // 检查本地路径是否存在
+        if (!(await FileService.exists(localPath))) {
+            Logger.error(`本地路径不存在: ${localPath}`);
+            process.exit(1);
+        }
+        const cliOptions = ConfigService.getCliOptions({
+            concurrency: parseInt(opts.concurrency, 10),
+        });
+        const ossService = new OssService(ossConfig);
+        if (await FileService.isDirectory(localPath)) {
+            Logger.title(`上传目录: ${localPath} -> ${ossPath}`);
+            const result = await ossService.uploadDirectory(localPath, ossPath, cliOptions);
+            Logger.done(result.success, result.failed);
+            if (result.failed > 0) {
+                process.exit(1);
+            }
+        }
+        else {
+            Logger.title(`上传文件: ${localPath} -> ${ossPath}`);
+            const headers = FileService.getUploadHeaders(localPath);
+            await ossService.uploadFile(localPath, ossPath, headers);
+            Logger.success('上传完成');
+        }
+    }
+    catch (error) {
+        const err = error;
+        Logger.error(err.message);
+        process.exit(1);
+    }
+});
+/**
+ * delete 命令 - 删除 OSS 路径
+ */
+program
+    .command('delete <ossPath>')
+    .description('删除 OSS 路径下的所有文件')
+    .action(async (ossPath) => {
+    try {
+        const opts = program.opts();
+        const ossConfig = ConfigService.getOssConfig({
+            accessKeyId: opts.accessKeyId,
+            accessKeySecret: opts.accessKeySecret,
+            bucket: opts.bucket,
+            region: opts.region,
+        });
+        const validation = ConfigService.validateConfig(ossConfig);
+        if (!validation.valid) {
+            validation.errors.forEach((err) => Logger.error(err));
+            process.exit(1);
+        }
+        const ossService = new OssService(ossConfig);
+        Logger.title(`删除 OSS 路径: ${ossPath}`);
+        const result = await ossService.deleteDirectory(ossPath);
+        if (!result.success) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        const err = error;
+        Logger.error(err.message);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=oss-cli.js.map

package/dist/bin/oss-cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * OSS CLI - 阿里云 OSS 命令行工具
+ * 导出所有服务和工具类，支持编程方式使用
+ */
+export { syncToOss, uploadToOss, deleteFromOss, testOssConnection } from './api.js';
+export type { SyncOptions, SyncResult, UploadToOssResult } from './api.js';
+export { ConfigService } from './services/config.service.js';
+export type { OssConfig, CliOptions, ValidationResult } from './services/config.service.js';
+export { FileService, HTML_CACHE_HEADERS, DEFAULT_IGNORE_PATTERNS } from './services/file.service.js';
+export type { FileInfo } from './services/file.service.js';
+export { OssService } from './services/oss.service.js';
+export type { UploadResult, DeleteResult, BucketInfo } from './services/oss.service.js';
+export { Logger } from './utils/logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACpF,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACtG,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAExF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * OSS CLI - 阿里云 OSS 命令行工具
+ * 导出所有服务和工具类，支持编程方式使用
+ */
+// 简化 API（推荐使用）
+export { syncToOss, uploadToOss, deleteFromOss, testOssConnection } from './api.js';
+// 底层服务（高级用法）
+export { ConfigService } from './services/config.service.js';
+export { FileService, HTML_CACHE_HEADERS, DEFAULT_IGNORE_PATTERNS } from './services/file.service.js';
+export { OssService } from './services/oss.service.js';
+export { Logger } from './utils/logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGpF,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAGtG,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/services/config.service.d.ts

@@ -0,0 +1,56 @@
+/**
+ * ConfigService - 配置管理服务
+ * 负责合并命令行参数和环境变量，验证配置完整性
+ */
+export interface OssConfig {
+    accessKeyId: string;
+    accessKeySecret: string;
+    bucket: string;
+    region: string;
+    timeout: number;
+}
+export interface CliOptions {
+    concurrency: number;
+    ignorePatterns: RegExp[];
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare class ConfigService {
+    /**
+     * 从命令行和环境变量获取 OSS 配置
+     * 优先级：命令行参数 > 环境变量 > 默认值
+     */
+    static getOssConfig(cliOptions?: Partial<OssConfig>): OssConfig;
+    /**
+     * 从环境变量读取配置
+     */
+    private static getEnvConfig;
+    /**
+     * 获取 CLI 选项
+     */
+    static getCliOptions(options?: Partial<CliOptions>): CliOptions;
+    /**
+     * 解析环境（从分支名或直接指定）
+     */
+    static resolveEnvironment(branch?: string, env?: string, customMapping?: Record<string, string>): string;
+    /**
+     * 验证配置完整性
+     */
+    static validateConfig(config: OssConfig): ValidationResult;
+    /**
+     * 获取预定义的分支环境映射
+     */
+    static getBranchEnvMap(): Record<string, string>;
+    /**
+     * 获取默认配置
+     */
+    static getDefaults(): {
+        bucket: string;
+        region: string;
+        concurrency: number;
+        timeout: number;
+    };
+}
+//# sourceMappingURL=config.service.d.ts.map

package/dist/services/config.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../../src/services/config.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AA+BD,qBAAa,aAAa;IACtB;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,UAAU,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS;IAYnE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAa3B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU;IAOnE;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACrB,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,MAAM;IAoBT;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB;IAmB1D;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhD;;OAEG;IACH,MAAM,CAAC,WAAW;;;;;;CAGrB"}

package/dist/services/config.service.js

@@ -0,0 +1,115 @@
+/**
+ * ConfigService - 配置管理服务
+ * 负责合并命令行参数和环境变量，验证配置完整性
+ */
+// 环境变量映射
+const ENV_VARS = {
+    OSS_ACCESS_KEY_ID: 'accessKeyId',
+    OSS_ACCESS_KEY_SECRET: 'accessKeySecret',
+    OSS_BUCKET: 'bucket',
+    OSS_REGION: 'region',
+};
+// 默认配置
+const DEFAULTS = {
+    bucket: 'czxvasfile',
+    region: 'oss-cn-shanghai',
+    concurrency: 10,
+    timeout: 60000,
+};
+// 默认忽略模式
+const DEFAULT_IGNORE_PATTERNS = [/\.DS_Store$/i, /\.map$/i];
+// 分支到环境映射
+const BRANCH_ENV_MAP = {
+    develop: 'test',
+    pre: 'pre',
+    test: 'test',
+    uat: 'pre',
+    master: 'prod',
+    'master-next': 'prod',
+};
+export class ConfigService {
+    /**
+     * 从命令行和环境变量获取 OSS 配置
+     * 优先级：命令行参数 > 环境变量 > 默认值
+     */
+    static getOssConfig(cliOptions = {}) {
+        const envConfig = this.getEnvConfig();
+        return {
+            accessKeyId: cliOptions.accessKeyId ?? envConfig.accessKeyId ?? '',
+            accessKeySecret: cliOptions.accessKeySecret ?? envConfig.accessKeySecret ?? '',
+            bucket: cliOptions.bucket ?? envConfig.bucket ?? DEFAULTS.bucket,
+            region: cliOptions.region ?? envConfig.region ?? DEFAULTS.region,
+            timeout: cliOptions.timeout ?? DEFAULTS.timeout,
+        };
+    }
+    /**
+     * 从环境变量读取配置
+     */
+    static getEnvConfig() {
+        const config = {};
+        for (const [envKey, configKey] of Object.entries(ENV_VARS)) {
+            const value = process.env[envKey];
+            if (value) {
+                config[configKey] = value;
+            }
+        }
+        return config;
+    }
+    /**
+     * 获取 CLI 选项
+     */
+    static getCliOptions(options = {}) {
+        return {
+            concurrency: options.concurrency ?? DEFAULTS.concurrency,
+            ignorePatterns: options.ignorePatterns ?? DEFAULT_IGNORE_PATTERNS,
+        };
+    }
+    /**
+     * 解析环境（从分支名或直接指定）
+     */
+    static resolveEnvironment(branch, env, customMapping) {
+        // 直接指定环境优先
+        if (env) {
+            return env;
+        }
+        // 使用自定义映射
+        if (branch && customMapping && customMapping[branch]) {
+            return customMapping[branch];
+        }
+        // 使用预定义映射
+        if (branch && BRANCH_ENV_MAP[branch]) {
+            return BRANCH_ENV_MAP[branch];
+        }
+        // 默认返回 test
+        return 'test';
+    }
+    /**
+     * 验证配置完整性
+     */
+    static validateConfig(config) {
+        const errors = [];
+        if (!config.accessKeyId) {
+            errors.push('请指定 AccessKey ID: --access-key-id=xxx 或设置环境变量 OSS_ACCESS_KEY_ID');
+        }
+        if (!config.accessKeySecret) {
+            errors.push('请指定 AccessKey Secret: --access-key-secret=xxx 或设置环境变量 OSS_ACCESS_KEY_SECRET');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * 获取预定义的分支环境映射
+     */
+    static getBranchEnvMap() {
+        return { ...BRANCH_ENV_MAP };
+    }
+    /**
+     * 获取默认配置
+     */
+    static getDefaults() {
+        return { ...DEFAULTS };
+    }
+}
+//# sourceMappingURL=config.service.js.map

package/dist/services/config.service.js.map

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

package/dist/services/file.service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * FileService - 本地文件操作服务
+ * 负责文件遍历、忽略模式匹配、MIME 类型检测
+ */
+export interface FileInfo {
+    path: string;
+    relativePath: string;
+    isHtml: boolean;
+}
+export declare const HTML_CACHE_HEADERS: {
+    'Cache-Control': string;
+    Pragma: string;
+    Expires: string;
+};
+export declare const DEFAULT_IGNORE_PATTERNS: RegExp[];
+export declare class FileService {
+    /**
+     * 检查文件是否应该被忽略
+     */
+    static shouldIgnore(filename: string, patterns: RegExp[]): boolean;
+    /**
+     * 检查文件是否为 HTML 文件（不区分大小写）
+     */
+    static isHtmlFile(filename: string): boolean;
+    /**
+     * 获取 HTML 文件的上传选项（缓存控制头）
+     */
+    static getUploadHeaders(filename: string): Record<string, string> | undefined;
+    /**
+     * 递归遍历目录，获取所有文件
+     */
+    static walkDirectory(dir: string, ignorePatterns?: RegExp[]): Promise<FileInfo[]>;
+    /**
+     * 递归遍历目录的内部实现
+     */
+    private static walkDirectoryRecursive;
+    /**
+     * 检查路径是否存在
+     */
+    static exists(filePath: string): Promise<boolean>;
+    /**
+     * 检查路径是否为目录
+     */
+    static isDirectory(filePath: string): Promise<boolean>;
+}
+//# sourceMappingURL=file.service.d.ts.map

package/dist/services/file.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.service.d.ts","sourceRoot":"","sources":["../../src/services/file.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACnB;AAGD,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAC;AAGF,eAAO,MAAM,uBAAuB,UAA8B,CAAC;AAEnE,qBAAa,WAAW;IACpB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO;IAIlE;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI5C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAO7E;;OAEG;WACU,aAAa,CACtB,GAAG,EAAE,MAAM,EACX,cAAc,GAAE,MAAM,EAA4B,GACnD,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMtB;;OAEG;mBACkB,sBAAsB;IA4B3C;;OAEG;WACU,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASvD;;OAEG;WACU,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ/D"}

package/dist/services/file.service.js

@@ -0,0 +1,94 @@
+/**
+ * FileService - 本地文件操作服务
+ * 负责文件遍历、忽略模式匹配、MIME 类型检测
+ */
+import fs from 'fs/promises';
+import path from 'path';
+// HTML 文件的缓存控制头
+export const HTML_CACHE_HEADERS = {
+    'Cache-Control': 'no-cache, no-store, must-revalidate',
+    Pragma: 'no-cache',
+    Expires: '0',
+};
+// 默认忽略模式
+export const DEFAULT_IGNORE_PATTERNS = [/\.DS_Store$/i, /\.map$/i];
+export class FileService {
+    /**
+     * 检查文件是否应该被忽略
+     */
+    static shouldIgnore(filename, patterns) {
+        return patterns.some((pattern) => pattern.test(filename));
+    }
+    /**
+     * 检查文件是否为 HTML 文件（不区分大小写）
+     */
+    static isHtmlFile(filename) {
+        return /\.html?$/i.test(filename);
+    }
+    /**
+     * 获取 HTML 文件的上传选项（缓存控制头）
+     */
+    static getUploadHeaders(filename) {
+        if (this.isHtmlFile(filename)) {
+            return { ...HTML_CACHE_HEADERS };
+        }
+        return undefined;
+    }
+    /**
+     * 递归遍历目录，获取所有文件
+     */
+    static async walkDirectory(dir, ignorePatterns = DEFAULT_IGNORE_PATTERNS) {
+        const results = [];
+        await this.walkDirectoryRecursive(dir, dir, ignorePatterns, results);
+        return results;
+    }
+    /**
+     * 递归遍历目录的内部实现
+     */
+    static async walkDirectoryRecursive(baseDir, currentDir, ignorePatterns, results) {
+        const entries = await fs.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                // 递归处理子目录
+                await this.walkDirectoryRecursive(baseDir, fullPath, ignorePatterns, results);
+            }
+            else if (entry.isFile()) {
+                // 检查是否应该忽略
+                if (!this.shouldIgnore(entry.name, ignorePatterns)) {
+                    const relativePath = path.relative(baseDir, fullPath).replace(/\\/g, '/');
+                    results.push({
+                        path: fullPath,
+                        relativePath,
+                        isHtml: this.isHtmlFile(entry.name),
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * 检查路径是否存在
+     */
+    static async exists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 检查路径是否为目录
+     */
+    static async isDirectory(filePath) {
+        try {
+            const stat = await fs.stat(filePath);
+            return stat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=file.service.js.map

package/dist/services/file.service.js.map

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

package/dist/services/oss.service.d.ts

@@ -0,0 +1,53 @@
+/**
+ * OssService - 阿里云 OSS 操作服务
+ * 封装上传、删除、连接测试等操作
+ */
+import { OssConfig, CliOptions } from './config.service.js';
+export interface UploadResult {
+    success: number;
+    failed: number;
+    files: string[];
+}
+export interface DeleteResult {
+    success: boolean;
+    deletedCount: number;
+    error?: string;
+}
+export interface BucketInfo {
+    name: string;
+    region: string;
+    creationDate: string;
+}
+export declare class OssService {
+    private client;
+    private config;
+    constructor(config: OssConfig);
+    /**
+     * 测试 OSS 连接
+     */
+    testConnection(): Promise<BucketInfo>;
+    /**
+     * 上传单个文件
+     */
+    uploadFile(localPath: string, ossPath: string, headers?: Record<string, string>): Promise<void>;
+    /**
+     * 上传目录
+     */
+    uploadDirectory(localDir: string, ossDir: string, options: CliOptions): Promise<UploadResult>;
+    /**
+     * 列出指定前缀的所有文件
+     */
+    listFiles(prefix: string): Promise<string[]>;
+    /**
+     * 删除目录下的所有文件
+     */
+    deleteDirectory(ossDir: string): Promise<DeleteResult>;
+    /**
+     * 同步目录（先删除再上传）
+     */
+    syncDirectory(localDir: string, ossDir: string, options: CliOptions): Promise<{
+        deleteResult: DeleteResult;
+        uploadResult: UploadResult;
+    }>;
+}
+//# sourceMappingURL=oss.service.d.ts.map

package/dist/services/oss.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oss.service.d.ts","sourceRoot":"","sources":["../../src/services/oss.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI5D,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,SAAS;IAW7B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;IAoC3C;;OAEG;IACG,UAAU,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACG,eAAe,CACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,GACpB,OAAO,CAAC,YAAY,CAAC;IAoCxB;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBlD;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA0C5D;;OAEG;IACG,aAAa,CACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,GACpB,OAAO,CAAC;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,YAAY,EAAE,YAAY,CAAA;KAAE,CAAC;CAsBzE"}