@be-link/cos 1.11.5-beta.0 → 1.12.0-beta.1

package/README.md

@@ -25,6 +25,8 @@ npm install @be-link/cos cos-js-sdk-v5 crypto-js
 
 ### Vue 项目
 
+**方式一：立即初始化**
+
 ```vue
 <template>
   <div>
@@ -70,6 +72,28 @@ const handleUpload = async () => {
 </script>
 ```
 
+**方式二：延迟初始化（支持异步配置）**
+
+```vue
+<script setup>
+import { ref, onMounted } from 'vue';
+import { BeLinkCOS } from '@be-link/cos';
+
+const uploader = new BeLinkCOS(); // 先创建实例
+
+onMounted(async () => {
+  // 从服务器获取配置
+  const config = await fetchConfigFromServer();
+  uploader.init({ mode: config.mode }); // 稍后初始化
+});
+
+const handleUpload = async () => {
+  const result = await uploader.uploadFile(file.value);
+  console.log('上传成功:', result.url);
+};
+</script>
+```
+
 ### React 项目
 
 ```jsx
@@ -165,31 +189,59 @@ await Promise.all([devUploader.uploadFile(file), prodUploader.uploadFile(file)])
 
 ## API 文档
 
-### `new BeLinkCOS(config)`
+### `new BeLinkCOS(config?)`
 
 创建 COS 上传器实例
 
+**支持两种使用方式：**
+
+1. **立即初始化**：传入配置对象，构造函数中自动调用 `init()`
+2. **延迟初始化**：不传配置，稍后调用 `init()` 方法（支持异步配置）
+
 **参数：**
 
-- `config.mode` - **必填，无默认值**
-  - 环境模式：`'development'` | `'testing'` | `'production'`
-  - 设计上强制必填，避免误传到错误环境
+- `config.mode` - **必填** 环境模式：`'development'` | `'test'` | `'production'`
 - `config.headers` - 可选，自定义请求头
 - `config.ScopeLimit` - 可选，是否限制临时密钥范围（默认 `false`）
+- `config.debug` - 可选，是否开启调试模式（默认 `false`）
 
 **示例：**
 
 ```typescript
-// 基础使用
+// 方式一：立即初始化
 const uploader = new BeLinkCOS({ mode: 'production' });
 
+// 方式二：延迟初始化（支持异步配置）
+const uploader = new BeLinkCOS();
+const config = await fetchConfig(); // 从服务器获取配置
+uploader.init({ mode: config.mode });
+
 // 带自定义请求头
 const uploader = new BeLinkCOS({
   mode: 'production',
   headers: { 'x-custom': 'value' },
+  debug: true, // 开启调试日志
 });
 ```
 
+### `uploader.init(config)`
+
+初始化 COS 实例（用于延迟初始化场景）
+
+**参数：**
+
+- `config.mode` - **必填** 环境模式
+- `config.headers` - 可选，自定义请求头
+- `config.ScopeLimit` - 可选，是否限制临时密钥范围
+- `config.debug` - 可选，是否开启调试模式
+
+**示例：**
+
+```typescript
+const uploader = new BeLinkCOS();
+uploader.init({ mode: 'production' });
+```
+
 ### `uploader.uploadFile(file, config)`
 
 上传文件到 COS
@@ -239,6 +291,23 @@ const url = await uploader.getSourceUrl(file);
 const md5 = await uploader.createFileMd5(file, 2 * 1024 * 1024); // 默认 2MB 分片
 ```
 
+### `uploader.getConfig()`
+
+获取当前实例的配置信息
+
+```typescript
+const config = uploader.getConfig();
+console.log(config); // { mode: 'production', headers: {}, scopeLimit: false }
+```
+
+### `uploader.destroy()`
+
+销毁实例，清理资源
+
+```typescript
+uploader.destroy();
+```
+
 ---
 
 ## 环境配置
@@ -246,7 +315,7 @@ const md5 = await uploader.createFileMd5(file, 2 * 1024 * 1024); // 默认 2MB
 | 环境        | Bucket             | 区域       |
 | ----------- | ------------------ | ---------- |
 | development | dev-1304510571     | ap-nanjing |
-| testing     | dev-1304510571     | ap-nanjing |
+| test        | dev-1304510571     | ap-nanjing |
 | production  | release-1304510571 | ap-nanjing |
 
 ---
@@ -256,7 +325,7 @@ const md5 = await uploader.createFileMd5(file, 2 * 1024 * 1024); // 默认 2MB
 ```typescript
 import { BeLinkCOS } from '@be-link/cos';
 import type {
-  EnvMode, // 'development' | 'testing' | 'production'
+  EnvMode, // 'development' | 'test' | 'production'
   BucketConfig, // Bucket 配置
   InitConfig, // 初始化配置
   UploadConfig, // 上传配置
@@ -268,7 +337,27 @@ import type {
 
 ## 常见问题
 
-### 1. 为什么 mode 必须传？没有默认值？
+### 1. 两种初始化方式有什么区别？
+
+**立即初始化**：配置在编译时已知，直接传入构造函数
+
+```typescript
+const uploader = new BeLinkCOS({ mode: 'production' });
+```
+
+**延迟初始化**：配置需要异步获取（如从服务器获取），先创建实例再初始化
+
+```typescript
+const uploader = new BeLinkCOS();
+
+// 稍后（可以是异步）
+const config = await fetchConfigFromServer();
+uploader.init({ mode: config.mode });
+```
+
+**设计理念：** 参考了 `BeLinkLogDot` 的设计模式，支持更灵活的配置方式。
+
+### 2. 为什么 mode 必须传？
 
 **设计理念：强制显式配置，避免默认值陷阱**
 
@@ -283,31 +372,33 @@ import type {
 // ✅ 正确：明确指定环境，不会搞错
 const uploader = new BeLinkCOS({ mode: 'production' });
 
-// ❌ 错误：TypeScript 编译错误，强制必须传 mode
+// ✅ 也可以延迟初始化
 const uploader = new BeLinkCOS();
+uploader.init({ mode: 'production' });
 ```
 
 这样设计更安全，用户必须思考"我要上传到哪个环境"。
 
-### 2. 上传失败怎么办？
+### 3. 上传失败怎么办？
 
 检查：
 
 - `mode` 参数是否正确
+- 实例是否已初始化（调用了 `init()` 或构造函数传入了配置）
 - 网络是否正常
-- 浏览器控制台是否有错误信息
+- 浏览器控制台是否有错误信息（可以开启 `debug: true` 查看详细日志）
 
-### 3. 文件存储路径是什么？
+### 4. 文件存储路径是什么？
 
 文件会自动存储到：`/beLinkAllSource/static/{文件类型}/{文件名}_{时间戳}.{扩展名}`
 
 例如：`/beLinkAllSource/static/image/avatar_1699999999999.png`
 
-### 4. 支持哪些文件类型？
+### 5. 支持哪些文件类型？
 
 支持所有文件类型，会根据文件的 MIME 类型自动分类存储（image、video、audio、application、text、other）。
 
-### 5. 如何切换环境？
+### 6. 如何切换环境？
 
 创建不同环境的实例：
 

package/dist/beLinkCos.d.ts

@@ -8,8 +8,15 @@ import type { InitConfig, UploadConfig, UploadResult } from './types';
  * @example
  * import { BeLinkCOS } from '@be-link/cos';
  *
+ * // 方式一：构造函数传入配置，立即初始化
  * const uploader = new BeLinkCOS({ mode: 'production' });
  * await uploader.uploadFile(file);
+ *
+ * // 方式二：先创建实例，稍后初始化（支持异步配置）
+ * const uploader = new BeLinkCOS();
+ * const config = await fetchConfig(); // 从服务器获取配置
+ * uploader.init({ mode: 'production' });
+ * await uploader.uploadFile(file);
  */
 export declare class BeLinkCOS {
     /** COS SDK 实例 */
@@ -19,40 +26,73 @@ export declare class BeLinkCOS {
     /** 自定义请求头 */
     headers: Record<string, any>;
     /** 当前环境模式 */
-    mode: EnvMode;
+    mode: EnvMode | null;
     /** 是否限制临时密钥的使用范围 */
     private scopeLimit;
+    /** 生命周期状态 */
+    protected isInitialized: boolean;
+    protected isDestroyed: boolean;
+    /** 调试模式 */
+    private debug;
     /**
      * 构造函数
      *
-     * 注意：mode 参数必填，没有默认值
-     * 设计理念：强制显式配置环境，避免误传到错误的环境
+     * 支持两种使用方式：
+     * 1. 立即初始化：传入配置对象，构造函数中自动调用 init()
+     * 2. 延迟初始化：不传配置，稍后调用 init() 方法（支持异步配置）
      *
-     * @param config - 初始化配置
-     * @param config.mode - **必填** 环境模式：'development' | 'testing' | 'production'
+     * @param config - 可选的初始化配置
+     * @param config.mode - **必填** 环境模式：'development' | 'test' | 'production'
      * @param config.headers - 可选，自定义请求头
      * @param config.ScopeLimit - 可选，是否限制临时密钥的使用范围（默认 false）
+     * @param config.debug - 可选，是否开启调试模式（默认 false）
      *
      * @example
-     * // 基础使用
+     * // 立即初始化
      * const uploader = new BeLinkCOS({ mode: 'production' });
      *
-     * // 带自定义请求头
-     * const uploader = new BeLinkCOS({
-     *   mode: 'production',
-     *   headers: { 'x-custom': 'value' }
-     * });
+     * // 延迟初始化
+     * const uploader = new BeLinkCOS();
+     * // ... 稍后调用 uploader.init(config);
+     */
+    constructor(config?: InitConfig);
+    /**
+     * 初始化 COS 实例
+     * @param config 配置对象
+     * @description 可以在创建实例时通过构造函数传入配置，也可以稍后调用此方法初始化
      */
-    constructor(config: InitConfig);
+    init(config: InitConfig): void;
     /**
      * 初始化 COS SDK 实例
      *
      * 内部方法，通过云函数获取临时密钥
-     * 首次上传时会自动调用，也可以手动调用以重新初始化
+     * 首次上传时会自动调用
      *
      * @returns Promise<void>
      */
     private initCOS;
+    /**
+     * 检查实例状态
+     */
+    protected checkState(methodName: string): boolean;
+    /**
+     * 内部日志方法
+     */
+    protected log(...args: unknown[]): void;
+    protected warn(...args: unknown[]): void;
+    protected error(...args: unknown[]): void;
+    /**
+     * 验证配置
+     */
+    protected validateConfig(config: InitConfig): boolean;
+    /**
+     * 获取配置
+     */
+    getConfig(): {
+        mode: EnvMode | null;
+        headers: Record<string, any>;
+        scopeLimit: boolean;
+    } | null;
     /**
      * 计算文件的 MD5 哈希值
      *
@@ -76,7 +116,7 @@ export declare class BeLinkCOS {
      * 例如：/beLinkAllSource/static/image/avatar_1699999999999.png
      *
      * @param file - 文件对象
-     * @returns Promise<string> COS 存储路径
+     * @returns string COS 存储路径
      */
     private getFilePath;
     /**
@@ -85,13 +125,13 @@ export declare class BeLinkCOS {
      * 用于在上传前预览文件的最终 URL
      *
      * @param file - 文件对象
-     * @returns Promise<string> 文件的完整访问 URL
+     * @returns Promise<string | null> 文件的完整访问 URL，如果实例未初始化则返回 null
      *
      * @example
      * const url = await beLinkCOS.getSourceUrl(file);
      * console.log('文件将上传到:', url);
      */
-    getSourceUrl(file: File): Promise<string>;
+    getSourceUrl(file: File): Promise<string | null>;
     /**
      * 上传文件到腾讯云 COS
      *
@@ -114,5 +154,9 @@ export declare class BeLinkCOS {
      * console.log('文件 URL:', result.url);
      */
     uploadFile(file: File, config?: UploadConfig): Promise<UploadResult>;
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
 }
 //# sourceMappingURL=beLinkCos.d.ts.map

package/dist/beLinkCos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beLinkCos.d.ts","sourceRoot":"","sources":["../src/beLinkCos.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,qBAAa,SAAS;IACpB,iBAAiB;IACjB,OAAO,CAAC,GAAG,CAAa;IACxB,kBAAkB;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,aAAa;IACN,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,aAAa;IACN,IAAI,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAU;IAE5B;;;;;;;;;;;;;;;;;;;;OAoBG;gBACS,MAAM,EAAE,UAAU;IAM9B;;;;;;;OAOG;YACW,OAAO;IAoCrB;;;;;;;;;;;;;;OAcG;IACI,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IA+DtF;;;;;;;;OAQG;YACW,WAAW;IASzB;;;;;;;;;;;OAWG;IACU,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtD;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CA6BlF"}
+{"version":3,"file":"beLinkCos.d.ts","sourceRoot":"","sources":["../src/beLinkCos.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAS;IACpB,iBAAiB;IACjB,OAAO,CAAC,GAAG,CAAa;IACxB,kBAAkB;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,aAAa;IACN,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;IACzC,aAAa;IACN,IAAI,EAAE,OAAO,GAAG,IAAI,CAAQ;IACnC,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAkB;IACpC,aAAa;IACb,SAAS,CAAC,aAAa,EAAE,OAAO,CAAS;IACzC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAS;IACvC,WAAW;IACX,OAAO,CAAC,KAAK,CAAkB;IAE/B;;;;;;;;;;;;;;;;;;;;OAoBG;gBACS,MAAM,CAAC,EAAE,UAAU;IAO/B;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAyB9B;;;;;;;OAOG;YACW,OAAO;IAqCrB;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAYjD;;OAEG;IACH,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMvC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMxC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMzC;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO;IAmBrD;;OAEG;IACH,SAAS,IAAI;QAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAY/F;;;;;;;;;;;;;;OAcG;IACI,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IA+DtF;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IASnB;;;;;;;;;;;OAWG;IACU,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS7D;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAsCjF;;OAEG;IACH,OAAO,IAAI,IAAI;CAsBhB"}

package/dist/config.d.ts

@@ -1,10 +1,10 @@
 /**
  * 环境模式类型
  * - development: 开发环境
- * - testing: 测试环境
+ * - test: 测试环境
  * - production: 生产环境
  */
-export type EnvMode = 'development' | 'testing' | 'production';
+export type EnvMode = 'development' | 'test' | 'production';
 /**
  * COS 存储桶配置接口
  */

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAgBxD,CAAC;AAEF,sBAAsB;AACtB,eAAO,MAAM,MAAM,EAAG,YAAqB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAgBxD,CAAC;AAEF,sBAAsB;AACtB,eAAO,MAAM,MAAM,EAAG,YAAqB,CAAC"}

package/dist/index.cjs.js

@@ -0,0 +1,407 @@
+'use strict';
+
+var CryptoJS = require('crypto-js');
+var COS = require('cos-js-sdk-v5');
+
+/**
+ * 各环境的 COS 存储桶配置
+ * 根据环境自动切换到对应的存储桶
+ */
+const BUCKETS_CONFIG = {
+    development: {
+        name: 'dev-1304510571',
+        host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',
+        protocol: 'https',
+    },
+    test: {
+        name: 'dev-1304510571',
+        host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',
+        protocol: 'https',
+    },
+    production: {
+        name: 'release-1304510571',
+        host: 'release-1304510571.file.myqcloud.com',
+        protocol: 'https',
+    },
+};
+/** COS 存储桶所在地域（南京） */
+const REGION = 'ap-nanjing';
+
+/**
+ * BeLinkCOS 类 - 腾讯云 COS 文件上传工具
+ *
+ * 功能：文件上传、MD5 计算、临时密钥授权
+ *
+ * @example
+ * import { BeLinkCOS } from '@be-link/cos';
+ *
+ * // 方式一：构造函数传入配置，立即初始化
+ * const uploader = new BeLinkCOS({ mode: 'production' });
+ * await uploader.uploadFile(file);
+ *
+ * // 方式二：先创建实例，稍后初始化（支持异步配置）
+ * const uploader = new BeLinkCOS();
+ * const config = await fetchConfig(); // 从服务器获取配置
+ * uploader.init({ mode: 'production' });
+ * await uploader.uploadFile(file);
+ */
+class BeLinkCOS {
+    /**
+     * 构造函数
+     *
+     * 支持两种使用方式：
+     * 1. 立即初始化：传入配置对象，构造函数中自动调用 init()
+     * 2. 延迟初始化：不传配置，稍后调用 init() 方法（支持异步配置）
+     *
+     * @param config - 可选的初始化配置
+     * @param config.mode - **必填** 环境模式：'development' | 'test' | 'production'
+     * @param config.headers - 可选，自定义请求头
+     * @param config.ScopeLimit - 可选，是否限制临时密钥的使用范围（默认 false）
+     * @param config.debug - 可选，是否开启调试模式（默认 false）
+     *
+     * @example
+     * // 立即初始化
+     * const uploader = new BeLinkCOS({ mode: 'production' });
+     *
+     * // 延迟初始化
+     * const uploader = new BeLinkCOS();
+     * // ... 稍后调用 uploader.init(config);
+     */
+    constructor(config) {
+        /** COS SDK 实例 */
+        this.cos = null;
+        /** COS 存储的基础路径 */
+        this.basePath = '/beLinkAllSource/static/';
+        /** 自定义请求头 */
+        this.headers = {};
+        /** 当前环境模式 */
+        this.mode = null;
+        /** 是否限制临时密钥的使用范围 */
+        this.scopeLimit = false;
+        /** 生命周期状态 */
+        this.isInitialized = false;
+        this.isDestroyed = false;
+        /** 调试模式 */
+        this.debug = false;
+        // 如果传入配置，立即初始化
+        if (config) {
+            this.init(config);
+        }
+    }
+    /**
+     * 初始化 COS 实例
+     * @param config 配置对象
+     * @description 可以在创建实例时通过构造函数传入配置，也可以稍后调用此方法初始化
+     */
+    init(config) {
+        if (this.isDestroyed) {
+            this.warn('实例已销毁，无法初始化');
+            return;
+        }
+        if (this.isInitialized) {
+            this.warn('实例已初始化，请勿重复调用');
+            return;
+        }
+        if (!this.validateConfig(config)) {
+            return;
+        }
+        // 保存配置
+        this.mode = config.mode;
+        this.headers = config.headers || {};
+        this.scopeLimit = config.ScopeLimit || false;
+        this.debug = config.debug || false;
+        this.isInitialized = true;
+        this.log('COS 实例初始化成功', { mode: this.mode });
+    }
+    /**
+     * 初始化 COS SDK 实例
+     *
+     * 内部方法，通过云函数获取临时密钥
+     * 首次上传时会自动调用
+     *
+     * @returns Promise<void>
+     */
+    async initCOS() {
+        if (this.cos) {
+            return; // 已初始化，直接返回
+        }
+        const cos = new COS({
+            getAuthorization: (_options, callback) => {
+                const url = this.mode === 'production'
+                    ? 'https://shield-60660-10-1304510571.sh.run.tcloudbase.com/config/get-cos-temp-secret'
+                    : 'https://shield-74680-5-1304510571.sh.run.tcloudbase.com/config/get-cos-temp-secret';
+                fetch(url, { method: 'POST' })
+                    .then((response) => response.json())
+                    .then((result) => {
+                    const data = result?.data || {};
+                    const credentials = data?.credentials;
+                    callback({
+                        TmpSecretId: credentials.tmpSecretId, // 临时密钥的 tmpSecretId
+                        TmpSecretKey: credentials.tmpSecretKey, // 临时密钥的 tmpSecretKey
+                        SecurityToken: credentials.sessionToken, // 临时密钥的 sessionToken
+                        // 建议返回服务器时间作为签名的开始时间，避免用户浏览器本地时间偏差过大导致签名错误
+                        StartTime: data.startTime, // 时间戳，单位秒，如：1580000000
+                        ExpiredTime: data.expiredTime, // 临时密钥失效时间戳，是申请临时密钥时，时间戳加 durationSeconds
+                        ScopeLimit: this.scopeLimit, // 细粒度控制权限需要设为 true，会限制密钥只在相同请求时重复使用
+                    });
+                })
+                    .catch((error) => {
+                    this.error('获取临时密钥失败:', error);
+                    callback(null);
+                });
+            },
+        });
+        this.cos = cos;
+        this.log('COS SDK 初始化成功');
+    }
+    /**
+     * 检查实例状态
+     */
+    checkState(methodName) {
+        if (this.isDestroyed) {
+            this.warn(`实例已销毁，无法调用 ${methodName}`);
+            return false;
+        }
+        if (!this.isInitialized) {
+            this.warn(`实例未初始化，请先调用 init 方法`);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 内部日志方法
+     */
+    log(...args) {
+        if (this.debug) {
+            console.log(`[${this.constructor.name}]`, ...args);
+        }
+    }
+    warn(...args) {
+        if (this.debug) {
+            console.warn(`[${this.constructor.name}]`, ...args);
+        }
+    }
+    error(...args) {
+        if (this.debug) {
+            console.error(`[${this.constructor.name}]`, ...args);
+        }
+    }
+    /**
+     * 验证配置
+     */
+    validateConfig(config) {
+        if (!config) {
+            this.error('配置对象不能为空');
+            return false;
+        }
+        if (!config.mode) {
+            this.error('mode 是必需的');
+            return false;
+        }
+        if (!['development', 'test', 'production'].includes(config.mode)) {
+            this.error('mode 必须是 development、test 或 production');
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        if (!this.isInitialized) {
+            this.warn('实例未初始化');
+            return null;
+        }
+        return {
+            mode: this.mode,
+            headers: this.headers,
+            scopeLimit: this.scopeLimit,
+        };
+    }
+    /**
+     * 计算文件的 MD5 哈希值
+     *
+     * 性能优化：
+     * - 小文件（< 10MB）：一次性读取，速度更快
+     * - 大文件：分片读取，避免内存溢出
+     *
+     * @param file - 要计算 MD5 的文件对象
+     * @param chunkSize - 分片大小（字节），默认 2MB
+     * @returns Promise<string> 文件的 MD5 哈希值
+     *
+     * @example
+     * const md5 = await beLinkCOS.createFileMd5(file);
+     * console.log('文件 MD5:', md5);
+     */
+    createFileMd5(file, chunkSize = 2 * 1024 * 1024) {
+        return new Promise((resolve, reject) => {
+            // 对于小文件（< 10MB），使用简单方法
+            if (file.size < 10 * 1024 * 1024) {
+                const reader = new FileReader();
+                reader.onload = (e) => {
+                    const arrayBuffer = e.target?.result;
+                    if (arrayBuffer) {
+                        const wordArray = CryptoJS.lib.WordArray.create(arrayBuffer);
+                        const hash = CryptoJS.MD5(wordArray).toString();
+                        resolve(hash);
+                    }
+                    else {
+                        reject(new Error('Failed to read file'));
+                    }
+                };
+                reader.onerror = (error) => {
+                    reject(error);
+                };
+                reader.readAsArrayBuffer(file);
+                return;
+            }
+            // 对于大文件，使用分片读取
+            let currentChunk = 0;
+            const chunks = Math.ceil(file.size / chunkSize);
+            const spark = CryptoJS.algo.MD5.create();
+            const reader = new FileReader();
+            reader.onload = (e) => {
+                const arrayBuffer = e.target?.result;
+                if (arrayBuffer) {
+                    const wordArray = CryptoJS.lib.WordArray.create(arrayBuffer);
+                    spark.update(wordArray);
+                    currentChunk++;
+                    if (currentChunk < chunks) {
+                        loadNext();
+                    }
+                    else {
+                        const hash = spark.finalize().toString();
+                        resolve(hash);
+                    }
+                }
+            };
+            reader.onerror = (error) => {
+                reject(error);
+            };
+            const loadNext = () => {
+                const start = currentChunk * chunkSize;
+                const end = Math.min(start + chunkSize, file.size);
+                const blob = file.slice(start, end);
+                reader.readAsArrayBuffer(blob);
+            };
+            loadNext();
+        });
+    }
+    /**
+     * 生成文件在 COS 中的存储路径
+     *
+     * 路径规则：/beLinkAllSource/static/{文件类型}/{文件名}_{时间戳}.{扩展名}
+     * 例如：/beLinkAllSource/static/image/avatar_1699999999999.png
+     *
+     * @param file - 文件对象
+     * @returns string COS 存储路径
+     */
+    getFilePath(file) {
+        const filename = file.name;
+        const fileType = file?.type ? file.type.split('/')[0] : 'other';
+        const fileExtension = filename.split('.').pop() || '';
+        const filenameDateNow = `${filename.split('.')[0]}_${Date.now()}`;
+        const newFileName = `${filenameDateNow}.${fileExtension}`;
+        return `${this.basePath}${fileType}/${newFileName}`;
+    }
+    /**
+     * 获取文件上传后的访问 URL（不执行实际上传）
+     *
+     * 用于在上传前预览文件的最终 URL
+     *
+     * @param file - 文件对象
+     * @returns Promise<string | null> 文件的完整访问 URL，如果实例未初始化则返回 null
+     *
+     * @example
+     * const url = await beLinkCOS.getSourceUrl(file);
+     * console.log('文件将上传到:', url);
+     */
+    async getSourceUrl(file) {
+        if (!this.checkState('getSourceUrl')) {
+            return null;
+        }
+        const path = this.getFilePath(file);
+        return `https://${BUCKETS_CONFIG[this.mode].host}${path}`;
+    }
+    /**
+     * 上传文件到腾讯云 COS
+     *
+     * 核心功能：将文件上传到对应环境的 COS 存储桶
+     * 支持上传进度回调、自定义请求头等配置
+     *
+     * @param file - 要上传的文件对象
+     * @param config - 上传配置（可选）
+     * @param config.Headers - 自定义请求头
+     * @param config.onProgressCallback - 上传进度回调函数
+     * @returns Promise<UploadResult> 上传结果，包含文件 URL、ETag 等信息
+     *
+     * @example
+     * const uploader = new BeLinkCOS({ mode: 'production' });
+     * const result = await uploader.uploadFile(file, {
+     *   onProgressCallback: (progressData) => {
+     *     console.log('进度:', progressData.percent * 100 + '%');
+     *   }
+     * });
+     * console.log('文件 URL:', result.url);
+     */
+    async uploadFile(file, config) {
+        if (!this.checkState('uploadFile')) {
+            throw new Error('实例未初始化或已销毁');
+        }
+        // 首次上传时自动初始化 COS SDK
+        if (!this.cos) {
+            await this.initCOS();
+        }
+        const key = this.getFilePath(file);
+        this.log('开始上传文件:', { filename: file.name, key });
+        return new Promise((resolve, reject) => {
+            this.cos?.putObject({
+                Bucket: BUCKETS_CONFIG[this.mode].name,
+                Region: REGION,
+                Key: key,
+                Body: file,
+                onProgress: config?.onProgressCallback,
+                ...config,
+                Headers: { ...this.headers, ...(config?.Headers || {}) },
+            }, (err, data) => {
+                if (err) {
+                    this.error('上传失败:', err);
+                    reject(err);
+                }
+                else {
+                    const url = `https://${data.Location}`;
+                    this.log('上传成功:', url);
+                    resolve({ ...data, url });
+                }
+            });
+        });
+    }
+    /**
+     * 销毁实例
+     */
+    destroy() {
+        if (this.isDestroyed) {
+            this.warn('实例已销毁');
+            return;
+        }
+        try {
+            // 清理 COS 实例
+            this.cos = null;
+            // 重置状态
+            this.isDestroyed = true;
+            this.isInitialized = false;
+            this.mode = null;
+            this.headers = {};
+            this.scopeLimit = false;
+            this.log('实例已销毁');
+        }
+        catch (error) {
+            this.error('销毁实例失败:', error);
+        }
+    }
+}
+
+exports.BUCKETS_CONFIG = BUCKETS_CONFIG;
+exports.BeLinkCOS = BeLinkCOS;
+exports.REGION = REGION;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/config.ts","../src/beLinkCos.ts"],"sourcesContent":["/**\n * 环境模式类型\n * - development: 开发环境\n * - test: 测试环境\n * - production: 生产环境\n */\nexport type EnvMode = 'development' | 'test' | 'production';\n\n/**\n * COS 存储桶配置接口\n */\nexport interface BucketConfig {\n  /** 存储桶名称 */\n  name: string;\n  /** 存储桶访问域名 */\n  host: string;\n  /** 访问协议 */\n  protocol: string;\n}\n\n/**\n * 各环境的 COS 存储桶配置\n * 根据环境自动切换到对应的存储桶\n */\nexport const BUCKETS_CONFIG: Record<EnvMode, BucketConfig> = {\n  development: {\n    name: 'dev-1304510571',\n    host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',\n    protocol: 'https',\n  },\n  test: {\n    name: 'dev-1304510571',\n    host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',\n    protocol: 'https',\n  },\n  production: {\n    name: 'release-1304510571',\n    host: 'release-1304510571.file.myqcloud.com',\n    protocol: 'https',\n  },\n};\n\n/** COS 存储桶所在地域（南京） */\nexport const REGION = 'ap-nanjing' as const;\n","import CryptoJS from 'crypto-js';\n// @ts-ignore\nimport COS from 'cos-js-sdk-v5';\n\nimport { BUCKETS_CONFIG, REGION, type EnvMode } from './config';\nimport type { InitConfig, UploadConfig, UploadResult } from './types';\n\n/**\n * BeLinkCOS 类 - 腾讯云 COS 文件上传工具\n *\n * 功能：文件上传、MD5 计算、临时密钥授权\n *\n * @example\n * import { BeLinkCOS } from '@be-link/cos';\n *\n * // 方式一：构造函数传入配置，立即初始化\n * const uploader = new BeLinkCOS({ mode: 'production' });\n * await uploader.uploadFile(file);\n *\n * // 方式二：先创建实例，稍后初始化（支持异步配置）\n * const uploader = new BeLinkCOS();\n * const config = await fetchConfig(); // 从服务器获取配置\n * uploader.init({ mode: 'production' });\n * await uploader.uploadFile(file);\n */\nexport class BeLinkCOS {\n  /** COS SDK 实例 */\n  private cos: any = null;\n  /** COS 存储的基础路径 */\n  private readonly basePath: string = '/beLinkAllSource/static/';\n  /** 自定义请求头 */\n  public headers: Record<string, any> = {};\n  /** 当前环境模式 */\n  public mode: EnvMode | null = null;\n  /** 是否限制临时密钥的使用范围 */\n  private scopeLimit: boolean = false;\n  /** 生命周期状态 */\n  protected isInitialized: boolean = false;\n  protected isDestroyed: boolean = false;\n  /** 调试模式 */\n  private debug: boolean = false;\n\n  /**\n   * 构造函数\n   *\n   * 支持两种使用方式：\n   * 1. 立即初始化：传入配置对象，构造函数中自动调用 init()\n   * 2. 延迟初始化：不传配置，稍后调用 init() 方法（支持异步配置）\n   *\n   * @param config - 可选的初始化配置\n   * @param config.mode - **必填** 环境模式：'development' | 'test' | 'production'\n   * @param config.headers - 可选，自定义请求头\n   * @param config.ScopeLimit - 可选，是否限制临时密钥的使用范围（默认 false）\n   * @param config.debug - 可选，是否开启调试模式（默认 false）\n   *\n   * @example\n   * // 立即初始化\n   * const uploader = new BeLinkCOS({ mode: 'production' });\n   *\n   * // 延迟初始化\n   * const uploader = new BeLinkCOS();\n   * // ... 稍后调用 uploader.init(config);\n   */\n  constructor(config?: InitConfig) {\n    // 如果传入配置，立即初始化\n    if (config) {\n      this.init(config);\n    }\n  }\n\n  /**\n   * 初始化 COS 实例\n   * @param config 配置对象\n   * @description 可以在创建实例时通过构造函数传入配置，也可以稍后调用此方法初始化\n   */\n  init(config: InitConfig): void {\n    if (this.isDestroyed) {\n      this.warn('实例已销毁，无法初始化');\n      return;\n    }\n\n    if (this.isInitialized) {\n      this.warn('实例已初始化，请勿重复调用');\n      return;\n    }\n\n    if (!this.validateConfig(config)) {\n      return;\n    }\n\n    // 保存配置\n    this.mode = config.mode;\n    this.headers = config.headers || {};\n    this.scopeLimit = config.ScopeLimit || false;\n    this.debug = config.debug || false;\n    this.isInitialized = true;\n\n    this.log('COS 实例初始化成功', { mode: this.mode });\n  }\n\n  /**\n   * 初始化 COS SDK 实例\n   *\n   * 内部方法，通过云函数获取临时密钥\n   * 首次上传时会自动调用\n   *\n   * @returns Promise<void>\n   */\n  private async initCOS(): Promise<void> {\n    if (this.cos) {\n      return; // 已初始化，直接返回\n    }\n\n    const cos = new COS({\n      getAuthorization: (_options: any, callback: (p: any) => void) => {\n        const url =\n          this.mode === 'production'\n            ? 'https://shield-60660-10-1304510571.sh.run.tcloudbase.com/config/get-cos-temp-secret'\n            : 'https://shield-74680-5-1304510571.sh.run.tcloudbase.com/config/get-cos-temp-secret';\n        fetch(url, { method: 'POST' })\n          .then((response) => response.json())\n          .then((result: any) => {\n            const data = result?.data || {};\n            const credentials = data?.credentials;\n\n            callback({\n              TmpSecretId: credentials.tmpSecretId, // 临时密钥的 tmpSecretId\n              TmpSecretKey: credentials.tmpSecretKey, // 临时密钥的 tmpSecretKey\n              SecurityToken: credentials.sessionToken, // 临时密钥的 sessionToken\n              // 建议返回服务器时间作为签名的开始时间，避免用户浏览器本地时间偏差过大导致签名错误\n              StartTime: data.startTime, // 时间戳，单位秒，如：1580000000\n              ExpiredTime: data.expiredTime, // 临时密钥失效时间戳，是申请临时密钥时，时间戳加 durationSeconds\n              ScopeLimit: this.scopeLimit, // 细粒度控制权限需要设为 true，会限制密钥只在相同请求时重复使用\n            });\n          })\n          .catch((error) => {\n            this.error('获取临时密钥失败:', error);\n            callback(null);\n          });\n      },\n    });\n    this.cos = cos;\n    this.log('COS SDK 初始化成功');\n  }\n\n  /**\n   * 检查实例状态\n   */\n  protected checkState(methodName: string): boolean {\n    if (this.isDestroyed) {\n      this.warn(`实例已销毁，无法调用 ${methodName}`);\n      return false;\n    }\n    if (!this.isInitialized) {\n      this.warn(`实例未初始化，请先调用 init 方法`);\n      return false;\n    }\n    return true;\n  }\n\n  /**\n   * 内部日志方法\n   */\n  protected log(...args: unknown[]): void {\n    if (this.debug) {\n      console.log(`[${this.constructor.name}]`, ...args);\n    }\n  }\n\n  protected warn(...args: unknown[]): void {\n    if (this.debug) {\n      console.warn(`[${this.constructor.name}]`, ...args);\n    }\n  }\n\n  protected error(...args: unknown[]): void {\n    if (this.debug) {\n      console.error(`[${this.constructor.name}]`, ...args);\n    }\n  }\n\n  /**\n   * 验证配置\n   */\n  protected validateConfig(config: InitConfig): boolean {\n    if (!config) {\n      this.error('配置对象不能为空');\n      return false;\n    }\n\n    if (!config.mode) {\n      this.error('mode 是必需的');\n      return false;\n    }\n\n    if (!['development', 'test', 'production'].includes(config.mode)) {\n      this.error('mode 必须是 development、test 或 production');\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * 获取配置\n   */\n  getConfig(): { mode: EnvMode | null; headers: Record<string, any>; scopeLimit: boolean } | null {\n    if (!this.isInitialized) {\n      this.warn('实例未初始化');\n      return null;\n    }\n    return {\n      mode: this.mode,\n      headers: this.headers,\n      scopeLimit: this.scopeLimit,\n    };\n  }\n\n  /**\n   * 计算文件的 MD5 哈希值\n   *\n   * 性能优化：\n   * - 小文件（< 10MB）：一次性读取，速度更快\n   * - 大文件：分片读取，避免内存溢出\n   *\n   * @param file - 要计算 MD5 的文件对象\n   * @param chunkSize - 分片大小（字节），默认 2MB\n   * @returns Promise<string> 文件的 MD5 哈希值\n   *\n   * @example\n   * const md5 = await beLinkCOS.createFileMd5(file);\n   * console.log('文件 MD5:', md5);\n   */\n  public createFileMd5(file: File, chunkSize: number = 2 * 1024 * 1024): Promise<string> {\n    return new Promise((resolve, reject) => {\n      // 对于小文件（< 10MB），使用简单方法\n      if (file.size < 10 * 1024 * 1024) {\n        const reader = new FileReader();\n\n        reader.onload = (e: ProgressEvent<FileReader>) => {\n          const arrayBuffer = e.target?.result as ArrayBuffer;\n          if (arrayBuffer) {\n            const wordArray = CryptoJS.lib.WordArray.create(arrayBuffer as any);\n            const hash = CryptoJS.MD5(wordArray).toString();\n            resolve(hash);\n          } else {\n            reject(new Error('Failed to read file'));\n          }\n        };\n\n        reader.onerror = (error: ProgressEvent<FileReader>) => {\n          reject(error);\n        };\n\n        reader.readAsArrayBuffer(file);\n        return;\n      }\n\n      // 对于大文件，使用分片读取\n      let currentChunk = 0;\n      const chunks = Math.ceil(file.size / chunkSize);\n      const spark = CryptoJS.algo.MD5.create();\n      const reader = new FileReader();\n\n      reader.onload = (e: ProgressEvent<FileReader>) => {\n        const arrayBuffer = e.target?.result as ArrayBuffer;\n        if (arrayBuffer) {\n          const wordArray = CryptoJS.lib.WordArray.create(arrayBuffer as any);\n          spark.update(wordArray);\n\n          currentChunk++;\n\n          if (currentChunk < chunks) {\n            loadNext();\n          } else {\n            const hash = spark.finalize().toString();\n            resolve(hash);\n          }\n        }\n      };\n\n      reader.onerror = (error: ProgressEvent<FileReader>) => {\n        reject(error);\n      };\n\n      const loadNext = () => {\n        const start = currentChunk * chunkSize;\n        const end = Math.min(start + chunkSize, file.size);\n        const blob = file.slice(start, end);\n        reader.readAsArrayBuffer(blob);\n      };\n\n      loadNext();\n    });\n  }\n\n  /**\n   * 生成文件在 COS 中的存储路径\n   *\n   * 路径规则：/beLinkAllSource/static/{文件类型}/{文件名}_{时间戳}.{扩展名}\n   * 例如：/beLinkAllSource/static/image/avatar_1699999999999.png\n   *\n   * @param file - 文件对象\n   * @returns string COS 存储路径\n   */\n  private getFilePath(file: File): string {\n    const filename = file.name;\n    const fileType = file?.type ? file.type.split('/')[0] : 'other';\n    const fileExtension = filename.split('.').pop() || '';\n    const filenameDateNow = `${filename.split('.')[0]}_${Date.now()}`;\n    const newFileName = `${filenameDateNow}.${fileExtension}`;\n    return `${this.basePath}${fileType}/${newFileName}`;\n  }\n\n  /**\n   * 获取文件上传后的访问 URL（不执行实际上传）\n   *\n   * 用于在上传前预览文件的最终 URL\n   *\n   * @param file - 文件对象\n   * @returns Promise<string | null> 文件的完整访问 URL，如果实例未初始化则返回 null\n   *\n   * @example\n   * const url = await beLinkCOS.getSourceUrl(file);\n   * console.log('文件将上传到:', url);\n   */\n  public async getSourceUrl(file: File): Promise<string | null> {\n    if (!this.checkState('getSourceUrl')) {\n      return null;\n    }\n\n    const path = this.getFilePath(file);\n    return `https://${BUCKETS_CONFIG[this.mode!].host}${path}`;\n  }\n\n  /**\n   * 上传文件到腾讯云 COS\n   *\n   * 核心功能：将文件上传到对应环境的 COS 存储桶\n   * 支持上传进度回调、自定义请求头等配置\n   *\n   * @param file - 要上传的文件对象\n   * @param config - 上传配置（可选）\n   * @param config.Headers - 自定义请求头\n   * @param config.onProgressCallback - 上传进度回调函数\n   * @returns Promise<UploadResult> 上传结果，包含文件 URL、ETag 等信息\n   *\n   * @example\n   * const uploader = new BeLinkCOS({ mode: 'production' });\n   * const result = await uploader.uploadFile(file, {\n   *   onProgressCallback: (progressData) => {\n   *     console.log('进度:', progressData.percent * 100 + '%');\n   *   }\n   * });\n   * console.log('文件 URL:', result.url);\n   */\n  public async uploadFile(file: File, config?: UploadConfig): Promise<UploadResult> {\n    if (!this.checkState('uploadFile')) {\n      throw new Error('实例未初始化或已销毁');\n    }\n\n    // 首次上传时自动初始化 COS SDK\n    if (!this.cos) {\n      await this.initCOS();\n    }\n\n    const key = this.getFilePath(file);\n    this.log('开始上传文件:', { filename: file.name, key });\n\n    return new Promise((resolve, reject) => {\n      this.cos?.putObject(\n        {\n          Bucket: BUCKETS_CONFIG[this.mode!].name,\n          Region: REGION,\n          Key: key,\n          Body: file,\n          onProgress: config?.onProgressCallback,\n          ...config,\n          Headers: { ...this.headers, ...(config?.Headers || {}) },\n        },\n        (err: any, data: UploadResult) => {\n          if (err) {\n            this.error('上传失败:', err);\n            reject(err);\n          } else {\n            const url = `https://${data.Location}`;\n            this.log('上传成功:', url);\n            resolve({ ...data, url });\n          }\n        },\n      );\n    });\n  }\n\n  /**\n   * 销毁实例\n   */\n  destroy(): void {\n    if (this.isDestroyed) {\n      this.warn('实例已销毁');\n      return;\n    }\n\n    try {\n      // 清理 COS 实例\n      this.cos = null;\n\n      // 重置状态\n      this.isDestroyed = true;\n      this.isInitialized = false;\n      this.mode = null;\n      this.headers = {};\n      this.scopeLimit = false;\n\n      this.log('实例已销毁');\n    } catch (error) {\n      this.error('销毁实例失败:', error);\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/{index.js → index.esm.js}

@@ -11,7 +11,7 @@ const BUCKETS_CONFIG = {
         host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',
         protocol: 'https',
     },
-    testing: {
+    test: {
         name: 'dev-1304510571',
         host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',
         protocol: 'https',
@@ -33,45 +33,89 @@ const REGION = 'ap-nanjing';
  * @example
  * import { BeLinkCOS } from '@be-link/cos';
  *
+ * // 方式一：构造函数传入配置，立即初始化
  * const uploader = new BeLinkCOS({ mode: 'production' });
  * await uploader.uploadFile(file);
+ *
+ * // 方式二：先创建实例，稍后初始化（支持异步配置）
+ * const uploader = new BeLinkCOS();
+ * const config = await fetchConfig(); // 从服务器获取配置
+ * uploader.init({ mode: 'production' });
+ * await uploader.uploadFile(file);
  */
 class BeLinkCOS {
     /**
      * 构造函数
      *
-     * 注意：mode 参数必填，没有默认值
-     * 设计理念：强制显式配置环境，避免误传到错误的环境
+     * 支持两种使用方式：
+     * 1. 立即初始化：传入配置对象，构造函数中自动调用 init()
+     * 2. 延迟初始化：不传配置，稍后调用 init() 方法（支持异步配置）
      *
-     * @param config - 初始化配置
-     * @param config.mode - **必填** 环境模式：'development' | 'testing' | 'production'
+     * @param config - 可选的初始化配置
+     * @param config.mode - **必填** 环境模式：'development' | 'test' | 'production'
      * @param config.headers - 可选，自定义请求头
      * @param config.ScopeLimit - 可选，是否限制临时密钥的使用范围（默认 false）
+     * @param config.debug - 可选，是否开启调试模式（默认 false）
      *
      * @example
-     * // 基础使用
+     * // 立即初始化
      * const uploader = new BeLinkCOS({ mode: 'production' });
      *
-     * // 带自定义请求头
-     * const uploader = new BeLinkCOS({
-     *   mode: 'production',
-     *   headers: { 'x-custom': 'value' }
-     * });
+     * // 延迟初始化
+     * const uploader = new BeLinkCOS();
+     * // ... 稍后调用 uploader.init(config);
      */
     constructor(config) {
         /** COS SDK 实例 */
         this.cos = null;
         /** COS 存储的基础路径 */
         this.basePath = '/beLinkAllSource/static/';
+        /** 自定义请求头 */
+        this.headers = {};
+        /** 当前环境模式 */
+        this.mode = null;
+        /** 是否限制临时密钥的使用范围 */
+        this.scopeLimit = false;
+        /** 生命周期状态 */
+        this.isInitialized = false;
+        this.isDestroyed = false;
+        /** 调试模式 */
+        this.debug = false;
+        // 如果传入配置，立即初始化
+        if (config) {
+            this.init(config);
+        }
+    }
+    /**
+     * 初始化 COS 实例
+     * @param config 配置对象
+     * @description 可以在创建实例时通过构造函数传入配置，也可以稍后调用此方法初始化
+     */
+    init(config) {
+        if (this.isDestroyed) {
+            this.warn('实例已销毁，无法初始化');
+            return;
+        }
+        if (this.isInitialized) {
+            this.warn('实例已初始化，请勿重复调用');
+            return;
+        }
+        if (!this.validateConfig(config)) {
+            return;
+        }
+        // 保存配置
         this.mode = config.mode;
         this.headers = config.headers || {};
         this.scopeLimit = config.ScopeLimit || false;
+        this.debug = config.debug || false;
+        this.isInitialized = true;
+        this.log('COS 实例初始化成功', { mode: this.mode });
     }
     /**
      * 初始化 COS SDK 实例
      *
      * 内部方法，通过云函数获取临时密钥
-     * 首次上传时会自动调用，也可以手动调用以重新初始化
+     * 首次上传时会自动调用
      *
      * @returns Promise<void>
      */
@@ -100,12 +144,77 @@ class BeLinkCOS {
                     });
                 })
                     .catch((error) => {
-                    console.error('Error fetching authorization:', error);
+                    this.error('获取临时密钥失败:', error);
                     callback(null);
                 });
             },
         });
         this.cos = cos;
+        this.log('COS SDK 初始化成功');
+    }
+    /**
+     * 检查实例状态
+     */
+    checkState(methodName) {
+        if (this.isDestroyed) {
+            this.warn(`实例已销毁，无法调用 ${methodName}`);
+            return false;
+        }
+        if (!this.isInitialized) {
+            this.warn(`实例未初始化，请先调用 init 方法`);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 内部日志方法
+     */
+    log(...args) {
+        if (this.debug) {
+            console.log(`[${this.constructor.name}]`, ...args);
+        }
+    }
+    warn(...args) {
+        if (this.debug) {
+            console.warn(`[${this.constructor.name}]`, ...args);
+        }
+    }
+    error(...args) {
+        if (this.debug) {
+            console.error(`[${this.constructor.name}]`, ...args);
+        }
+    }
+    /**
+     * 验证配置
+     */
+    validateConfig(config) {
+        if (!config) {
+            this.error('配置对象不能为空');
+            return false;
+        }
+        if (!config.mode) {
+            this.error('mode 是必需的');
+            return false;
+        }
+        if (!['development', 'test', 'production'].includes(config.mode)) {
+            this.error('mode 必须是 development、test 或 production');
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        if (!this.isInitialized) {
+            this.warn('实例未初始化');
+            return null;
+        }
+        return {
+            mode: this.mode,
+            headers: this.headers,
+            scopeLimit: this.scopeLimit,
+        };
     }
     /**
      * 计算文件的 MD5 哈希值
@@ -183,9 +292,9 @@ class BeLinkCOS {
      * 例如：/beLinkAllSource/static/image/avatar_1699999999999.png
      *
      * @param file - 文件对象
-     * @returns Promise<string> COS 存储路径
+     * @returns string COS 存储路径
      */
-    async getFilePath(file) {
+    getFilePath(file) {
         const filename = file.name;
         const fileType = file?.type ? file.type.split('/')[0] : 'other';
         const fileExtension = filename.split('.').pop() || '';
@@ -199,14 +308,17 @@ class BeLinkCOS {
      * 用于在上传前预览文件的最终 URL
      *
      * @param file - 文件对象
-     * @returns Promise<string> 文件的完整访问 URL
+     * @returns Promise<string | null> 文件的完整访问 URL，如果实例未初始化则返回 null
      *
      * @example
      * const url = await beLinkCOS.getSourceUrl(file);
      * console.log('文件将上传到:', url);
      */
     async getSourceUrl(file) {
-        const path = await this.getFilePath(file);
+        if (!this.checkState('getSourceUrl')) {
+            return null;
+        }
+        const path = this.getFilePath(file);
         return `https://${BUCKETS_CONFIG[this.mode].host}${path}`;
     }
     /**
@@ -231,11 +343,15 @@ class BeLinkCOS {
      * console.log('文件 URL:', result.url);
      */
     async uploadFile(file, config) {
+        if (!this.checkState('uploadFile')) {
+            throw new Error('实例未初始化或已销毁');
+        }
         // 首次上传时自动初始化 COS SDK
         if (!this.cos) {
             await this.initCOS();
         }
-        const key = await this.getFilePath(file);
+        const key = this.getFilePath(file);
+        this.log('开始上传文件:', { filename: file.name, key });
         return new Promise((resolve, reject) => {
             this.cos?.putObject({
                 Bucket: BUCKETS_CONFIG[this.mode].name,
@@ -247,16 +363,41 @@ class BeLinkCOS {
                 Headers: { ...this.headers, ...(config?.Headers || {}) },
             }, (err, data) => {
                 if (err) {
+                    this.error('上传失败:', err);
                     reject(err);
                 }
                 else {
                     const url = `https://${data.Location}`;
+                    this.log('上传成功:', url);
                     resolve({ ...data, url });
                 }
             });
         });
     }
+    /**
+     * 销毁实例
+     */
+    destroy() {
+        if (this.isDestroyed) {
+            this.warn('实例已销毁');
+            return;
+        }
+        try {
+            // 清理 COS 实例
+            this.cos = null;
+            // 重置状态
+            this.isDestroyed = true;
+            this.isInitialized = false;
+            this.mode = null;
+            this.headers = {};
+            this.scopeLimit = false;
+            this.log('实例已销毁');
+        }
+        catch (error) {
+            this.error('销毁实例失败:', error);
+        }
+    }
 }
 
 export { BUCKETS_CONFIG, BeLinkCOS, REGION };
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/config.ts","../src/beLinkCos.ts"],"sourcesContent":["/**\n * 环境模式类型\n * - development: 开发环境\n * - test: 测试环境\n * - production: 生产环境\n */\nexport type EnvMode = 'development' | 'test' | 'production';\n\n/**\n * COS 存储桶配置接口\n */\nexport interface BucketConfig {\n  /** 存储桶名称 */\n  name: string;\n  /** 存储桶访问域名 */\n  host: string;\n  /** 访问协议 */\n  protocol: string;\n}\n\n/**\n * 各环境的 COS 存储桶配置\n * 根据环境自动切换到对应的存储桶\n */\nexport const BUCKETS_CONFIG: Record<EnvMode, BucketConfig> = {\n  development: {\n    name: 'dev-1304510571',\n    host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',\n    protocol: 'https',\n  },\n  test: {\n    name: 'dev-1304510571',\n    host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',\n    protocol: 'https',\n  },\n  production: {\n    name: 'release-1304510571',\n    host: 'release-1304510571.file.myqcloud.com',\n    protocol: 'https',\n  },\n};\n\n/** COS 存储桶所在地域（南京） */\nexport const REGION = 'ap-nanjing' as const;\n","import CryptoJS from 'crypto-js';\n// @ts-ignore\nimport COS from 'cos-js-sdk-v5';\n\nimport { BUCKETS_CONFIG, REGION, type EnvMode } from './config';\nimport type { InitConfig, UploadConfig, UploadResult } from './types';\n\n/**\n * BeLinkCOS 类 - 腾讯云 COS 文件上传工具\n *\n * 功能：文件上传、MD5 计算、临时密钥授权\n *\n * @example\n * import { BeLinkCOS } from '@be-link/cos';\n *\n * // 方式一：构造函数传入配置，立即初始化\n * const uploader = new BeLinkCOS({ mode: 'production' });\n * await uploader.uploadFile(file);\n *\n * // 方式二：先创建实例，稍后初始化（支持异步配置）\n * const uploader = new BeLinkCOS();\n * const config = await fetchConfig(); // 从服务器获取配置\n * uploader.init({ mode: 'production' });\n * await uploader.uploadFile(file);\n */\nexport class BeLinkCOS {\n  /** COS SDK 实例 */\n  private cos: any = null;\n  /** COS 存储的基础路径 */\n  private readonly basePath: string = '/beLinkAllSource/static/';\n  /** 自定义请求头 */\n  public headers: Record<string, any> = {};\n  /** 当前环境模式 */\n  public mode: EnvMode | null = null;\n  /** 是否限制临时密钥的使用范围 */\n  private scopeLimit: boolean = false;\n  /** 生命周期状态 */\n  protected isInitialized: boolean = false;\n  protected isDestroyed: boolean = false;\n  /** 调试模式 */\n  private debug: boolean = false;\n\n  /**\n   * 构造函数\n   *\n   * 支持两种使用方式：\n   * 1. 立即初始化：传入配置对象，构造函数中自动调用 init()\n   * 2. 延迟初始化：不传配置，稍后调用 init() 方法（支持异步配置）\n   *\n   * @param config - 可选的初始化配置\n   * @param config.mode - **必填** 环境模式：'development' | 'test' | 'production'\n   * @param config.headers - 可选，自定义请求头\n   * @param config.ScopeLimit - 可选，是否限制临时密钥的使用范围（默认 false）\n   * @param config.debug - 可选，是否开启调试模式（默认 false）\n   *\n   * @example\n   * // 立即初始化\n   * const uploader = new BeLinkCOS({ mode: 'production' });\n   *\n   * // 延迟初始化\n   * const uploader = new BeLinkCOS();\n   * // ... 稍后调用 uploader.init(config);\n   */\n  constructor(config?: InitConfig) {\n    // 如果传入配置，立即初始化\n    if (config) {\n      this.init(config);\n    }\n  }\n\n  /**\n   * 初始化 COS 实例\n   * @param config 配置对象\n   * @description 可以在创建实例时通过构造函数传入配置，也可以稍后调用此方法初始化\n   */\n  init(config: InitConfig): void {\n    if (this.isDestroyed) {\n      this.warn('实例已销毁，无法初始化');\n      return;\n    }\n\n    if (this.isInitialized) {\n      this.warn('实例已初始化，请勿重复调用');\n      return;\n    }\n\n    if (!this.validateConfig(config)) {\n      return;\n    }\n\n    // 保存配置\n    this.mode = config.mode;\n    this.headers = config.headers || {};\n    this.scopeLimit = config.ScopeLimit || false;\n    this.debug = config.debug || false;\n    this.isInitialized = true;\n\n    this.log('COS 实例初始化成功', { mode: this.mode });\n  }\n\n  /**\n   * 初始化 COS SDK 实例\n   *\n   * 内部方法，通过云函数获取临时密钥\n   * 首次上传时会自动调用\n   *\n   * @returns Promise<void>\n   */\n  private async initCOS(): Promise<void> {\n    if (this.cos) {\n      return; // 已初始化，直接返回\n    }\n\n    const cos = new COS({\n      getAuthorization: (_options: any, callback: (p: any) => void) => {\n        const url =\n          this.mode === 'production'\n            ? 'https://shield-60660-10-1304510571.sh.run.tcloudbase.com/config/get-cos-temp-secret'\n            : 'https://shield-74680-5-1304510571.sh.run.tcloudbase.com/config/get-cos-temp-secret';\n        fetch(url, { method: 'POST' })\n          .then((response) => response.json())\n          .then((result: any) => {\n            const data = result?.data || {};\n            const credentials = data?.credentials;\n\n            callback({\n              TmpSecretId: credentials.tmpSecretId, // 临时密钥的 tmpSecretId\n              TmpSecretKey: credentials.tmpSecretKey, // 临时密钥的 tmpSecretKey\n              SecurityToken: credentials.sessionToken, // 临时密钥的 sessionToken\n              // 建议返回服务器时间作为签名的开始时间，避免用户浏览器本地时间偏差过大导致签名错误\n              StartTime: data.startTime, // 时间戳，单位秒，如：1580000000\n              ExpiredTime: data.expiredTime, // 临时密钥失效时间戳，是申请临时密钥时，时间戳加 durationSeconds\n              ScopeLimit: this.scopeLimit, // 细粒度控制权限需要设为 true，会限制密钥只在相同请求时重复使用\n            });\n          })\n          .catch((error) => {\n            this.error('获取临时密钥失败:', error);\n            callback(null);\n          });\n      },\n    });\n    this.cos = cos;\n    this.log('COS SDK 初始化成功');\n  }\n\n  /**\n   * 检查实例状态\n   */\n  protected checkState(methodName: string): boolean {\n    if (this.isDestroyed) {\n      this.warn(`实例已销毁，无法调用 ${methodName}`);\n      return false;\n    }\n    if (!this.isInitialized) {\n      this.warn(`实例未初始化，请先调用 init 方法`);\n      return false;\n    }\n    return true;\n  }\n\n  /**\n   * 内部日志方法\n   */\n  protected log(...args: unknown[]): void {\n    if (this.debug) {\n      console.log(`[${this.constructor.name}]`, ...args);\n    }\n  }\n\n  protected warn(...args: unknown[]): void {\n    if (this.debug) {\n      console.warn(`[${this.constructor.name}]`, ...args);\n    }\n  }\n\n  protected error(...args: unknown[]): void {\n    if (this.debug) {\n      console.error(`[${this.constructor.name}]`, ...args);\n    }\n  }\n\n  /**\n   * 验证配置\n   */\n  protected validateConfig(config: InitConfig): boolean {\n    if (!config) {\n      this.error('配置对象不能为空');\n      return false;\n    }\n\n    if (!config.mode) {\n      this.error('mode 是必需的');\n      return false;\n    }\n\n    if (!['development', 'test', 'production'].includes(config.mode)) {\n      this.error('mode 必须是 development、test 或 production');\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * 获取配置\n   */\n  getConfig(): { mode: EnvMode | null; headers: Record<string, any>; scopeLimit: boolean } | null {\n    if (!this.isInitialized) {\n      this.warn('实例未初始化');\n      return null;\n    }\n    return {\n      mode: this.mode,\n      headers: this.headers,\n      scopeLimit: this.scopeLimit,\n    };\n  }\n\n  /**\n   * 计算文件的 MD5 哈希值\n   *\n   * 性能优化：\n   * - 小文件（< 10MB）：一次性读取，速度更快\n   * - 大文件：分片读取，避免内存溢出\n   *\n   * @param file - 要计算 MD5 的文件对象\n   * @param chunkSize - 分片大小（字节），默认 2MB\n   * @returns Promise<string> 文件的 MD5 哈希值\n   *\n   * @example\n   * const md5 = await beLinkCOS.createFileMd5(file);\n   * console.log('文件 MD5:', md5);\n   */\n  public createFileMd5(file: File, chunkSize: number = 2 * 1024 * 1024): Promise<string> {\n    return new Promise((resolve, reject) => {\n      // 对于小文件（< 10MB），使用简单方法\n      if (file.size < 10 * 1024 * 1024) {\n        const reader = new FileReader();\n\n        reader.onload = (e: ProgressEvent<FileReader>) => {\n          const arrayBuffer = e.target?.result as ArrayBuffer;\n          if (arrayBuffer) {\n            const wordArray = CryptoJS.lib.WordArray.create(arrayBuffer as any);\n            const hash = CryptoJS.MD5(wordArray).toString();\n            resolve(hash);\n          } else {\n            reject(new Error('Failed to read file'));\n          }\n        };\n\n        reader.onerror = (error: ProgressEvent<FileReader>) => {\n          reject(error);\n        };\n\n        reader.readAsArrayBuffer(file);\n        return;\n      }\n\n      // 对于大文件，使用分片读取\n      let currentChunk = 0;\n      const chunks = Math.ceil(file.size / chunkSize);\n      const spark = CryptoJS.algo.MD5.create();\n      const reader = new FileReader();\n\n      reader.onload = (e: ProgressEvent<FileReader>) => {\n        const arrayBuffer = e.target?.result as ArrayBuffer;\n        if (arrayBuffer) {\n          const wordArray = CryptoJS.lib.WordArray.create(arrayBuffer as any);\n          spark.update(wordArray);\n\n          currentChunk++;\n\n          if (currentChunk < chunks) {\n            loadNext();\n          } else {\n            const hash = spark.finalize().toString();\n            resolve(hash);\n          }\n        }\n      };\n\n      reader.onerror = (error: ProgressEvent<FileReader>) => {\n        reject(error);\n      };\n\n      const loadNext = () => {\n        const start = currentChunk * chunkSize;\n        const end = Math.min(start + chunkSize, file.size);\n        const blob = file.slice(start, end);\n        reader.readAsArrayBuffer(blob);\n      };\n\n      loadNext();\n    });\n  }\n\n  /**\n   * 生成文件在 COS 中的存储路径\n   *\n   * 路径规则：/beLinkAllSource/static/{文件类型}/{文件名}_{时间戳}.{扩展名}\n   * 例如：/beLinkAllSource/static/image/avatar_1699999999999.png\n   *\n   * @param file - 文件对象\n   * @returns string COS 存储路径\n   */\n  private getFilePath(file: File): string {\n    const filename = file.name;\n    const fileType = file?.type ? file.type.split('/')[0] : 'other';\n    const fileExtension = filename.split('.').pop() || '';\n    const filenameDateNow = `${filename.split('.')[0]}_${Date.now()}`;\n    const newFileName = `${filenameDateNow}.${fileExtension}`;\n    return `${this.basePath}${fileType}/${newFileName}`;\n  }\n\n  /**\n   * 获取文件上传后的访问 URL（不执行实际上传）\n   *\n   * 用于在上传前预览文件的最终 URL\n   *\n   * @param file - 文件对象\n   * @returns Promise<string | null> 文件的完整访问 URL，如果实例未初始化则返回 null\n   *\n   * @example\n   * const url = await beLinkCOS.getSourceUrl(file);\n   * console.log('文件将上传到:', url);\n   */\n  public async getSourceUrl(file: File): Promise<string | null> {\n    if (!this.checkState('getSourceUrl')) {\n      return null;\n    }\n\n    const path = this.getFilePath(file);\n    return `https://${BUCKETS_CONFIG[this.mode!].host}${path}`;\n  }\n\n  /**\n   * 上传文件到腾讯云 COS\n   *\n   * 核心功能：将文件上传到对应环境的 COS 存储桶\n   * 支持上传进度回调、自定义请求头等配置\n   *\n   * @param file - 要上传的文件对象\n   * @param config - 上传配置（可选）\n   * @param config.Headers - 自定义请求头\n   * @param config.onProgressCallback - 上传进度回调函数\n   * @returns Promise<UploadResult> 上传结果，包含文件 URL、ETag 等信息\n   *\n   * @example\n   * const uploader = new BeLinkCOS({ mode: 'production' });\n   * const result = await uploader.uploadFile(file, {\n   *   onProgressCallback: (progressData) => {\n   *     console.log('进度:', progressData.percent * 100 + '%');\n   *   }\n   * });\n   * console.log('文件 URL:', result.url);\n   */\n  public async uploadFile(file: File, config?: UploadConfig): Promise<UploadResult> {\n    if (!this.checkState('uploadFile')) {\n      throw new Error('实例未初始化或已销毁');\n    }\n\n    // 首次上传时自动初始化 COS SDK\n    if (!this.cos) {\n      await this.initCOS();\n    }\n\n    const key = this.getFilePath(file);\n    this.log('开始上传文件:', { filename: file.name, key });\n\n    return new Promise((resolve, reject) => {\n      this.cos?.putObject(\n        {\n          Bucket: BUCKETS_CONFIG[this.mode!].name,\n          Region: REGION,\n          Key: key,\n          Body: file,\n          onProgress: config?.onProgressCallback,\n          ...config,\n          Headers: { ...this.headers, ...(config?.Headers || {}) },\n        },\n        (err: any, data: UploadResult) => {\n          if (err) {\n            this.error('上传失败:', err);\n            reject(err);\n          } else {\n            const url = `https://${data.Location}`;\n            this.log('上传成功:', url);\n            resolve({ ...data, url });\n          }\n        },\n      );\n    });\n  }\n\n  /**\n   * 销毁实例\n   */\n  destroy(): void {\n    if (this.isDestroyed) {\n      this.warn('实例已销毁');\n      return;\n    }\n\n    try {\n      // 清理 COS 实例\n      this.cos = null;\n\n      // 重置状态\n      this.isDestroyed = true;\n      this.isInitialized = false;\n      this.mode = null;\n      this.headers = {};\n      this.scopeLimit = false;\n\n      this.log('实例已销毁');\n    } catch (error) {\n      this.error('销毁实例失败:', error);\n    }\n  }\n}\n"],"names":[],"mappings":";;;AAoBA;;;AAGG;AACI,MAAM,cAAc,GAAkC;AAC3D,IAAA,WAAW,EAAE;AACX,QAAA,IAAI,EAAE,gBAAgB;AACtB,QAAA,IAAI,EAAE,4CAA4C;AAClD,QAAA,QAAQ,EAAE,OAAO;AAClB,KAAA;AACD,IAAA,IAAI,EAAE;AACJ,QAAA,IAAI,EAAE,gBAAgB;AACtB,QAAA,IAAI,EAAE,4CAA4C;AAClD,QAAA,QAAQ,EAAE,OAAO;AAClB,KAAA;AACD,IAAA,UAAU,EAAE;AACV,QAAA,IAAI,EAAE,oBAAoB;AAC1B,QAAA,IAAI,EAAE,sCAAsC;AAC5C,QAAA,QAAQ,EAAE,OAAO;AAClB,KAAA;;AAGH;AACO,MAAM,MAAM,GAAG;;ACpCtB;;;;;;;;;;;;;;;;;AAiBG;MACU,SAAS,CAAA;AAiBpB;;;;;;;;;;;;;;;;;;;;AAoBG;AACH,IAAA,WAAA,CAAY,MAAmB,EAAA;;QApCvB,IAAA,CAAA,GAAG,GAAQ,IAAI;;QAEN,IAAA,CAAA,QAAQ,GAAW,0BAA0B;;QAEvD,IAAA,CAAA,OAAO,GAAwB,EAAE;;QAEjC,IAAA,CAAA,IAAI,GAAmB,IAAI;;QAE1B,IAAA,CAAA,UAAU,GAAY,KAAK;;QAEzB,IAAA,CAAA,aAAa,GAAY,KAAK;QAC9B,IAAA,CAAA,WAAW,GAAY,KAAK;;QAE9B,IAAA,CAAA,KAAK,GAAY,KAAK;;QAyB5B,IAAI,MAAM,EAAE;AACV,YAAA,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QACnB;IACF;AAEA;;;;AAIG;AACH,IAAA,IAAI,CAAC,MAAkB,EAAA;AACrB,QAAA,IAAI,IAAI,CAAC,WAAW,EAAE;AACpB,YAAA,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;YACxB;QACF;AAEA,QAAA,IAAI,IAAI,CAAC,aAAa,EAAE;AACtB,YAAA,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;YAC1B;QACF;QAEA,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE;YAChC;QACF;;AAGA,QAAA,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE;QACnC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,KAAK;QAC5C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,KAAK;AAClC,QAAA,IAAI,CAAC,aAAa,GAAG,IAAI;AAEzB,QAAA,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9C;AAEA;;;;;;;AAOG;AACK,IAAA,MAAM,OAAO,GAAA;AACnB,QAAA,IAAI,IAAI,CAAC,GAAG,EAAE;AACZ,YAAA,OAAO;QACT;AAEA,QAAA,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;AAClB,YAAA,gBAAgB,EAAE,CAAC,QAAa,EAAE,QAA0B,KAAI;AAC9D,gBAAA,MAAM,GAAG,GACP,IAAI,CAAC,IAAI,KAAK;AACZ,sBAAE;sBACA,oFAAoF;gBAC1F,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;qBAC1B,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE;AAClC,qBAAA,IAAI,CAAC,CAAC,MAAW,KAAI;AACpB,oBAAA,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,EAAE;AAC/B,oBAAA,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW;AAErC,oBAAA,QAAQ,CAAC;AACP,wBAAA,WAAW,EAAE,WAAW,CAAC,WAAW;AACpC,wBAAA,YAAY,EAAE,WAAW,CAAC,YAAY;AACtC,wBAAA,aAAa,EAAE,WAAW,CAAC,YAAY;;AAEvC,wBAAA,SAAS,EAAE,IAAI,CAAC,SAAS;AACzB,wBAAA,WAAW,EAAE,IAAI,CAAC,WAAW;AAC7B,wBAAA,UAAU,EAAE,IAAI,CAAC,UAAU;AAC5B,qBAAA,CAAC;AACJ,gBAAA,CAAC;AACA,qBAAA,KAAK,CAAC,CAAC,KAAK,KAAI;AACf,oBAAA,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC;oBAC9B,QAAQ,CAAC,IAAI,CAAC;AAChB,gBAAA,CAAC,CAAC;YACN,CAAC;AACF,SAAA,CAAC;AACF,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;AACd,QAAA,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3B;AAEA;;AAEG;AACO,IAAA,UAAU,CAAC,UAAkB,EAAA;AACrC,QAAA,IAAI,IAAI,CAAC,WAAW,EAAE;AACpB,YAAA,IAAI,CAAC,IAAI,CAAC,cAAc,UAAU,CAAA,CAAE,CAAC;AACrC,YAAA,OAAO,KAAK;QACd;AACA,QAAA,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;AACvB,YAAA,IAAI,CAAC,IAAI,CAAC,CAAA,mBAAA,CAAqB,CAAC;AAChC,YAAA,OAAO,KAAK;QACd;AACA,QAAA,OAAO,IAAI;IACb;AAEA;;AAEG;IACO,GAAG,CAAC,GAAG,IAAe,EAAA;AAC9B,QAAA,IAAI,IAAI,CAAC,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,GAAG,CAAC,CAAA,CAAA,EAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA,CAAA,CAAG,EAAE,GAAG,IAAI,CAAC;QACpD;IACF;IAEU,IAAI,CAAC,GAAG,IAAe,EAAA;AAC/B,QAAA,IAAI,IAAI,CAAC,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,IAAI,CAAC,CAAA,CAAA,EAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA,CAAA,CAAG,EAAE,GAAG,IAAI,CAAC;QACrD;IACF;IAEU,KAAK,CAAC,GAAG,IAAe,EAAA;AAChC,QAAA,IAAI,IAAI,CAAC,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,KAAK,CAAC,CAAA,CAAA,EAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA,CAAA,CAAG,EAAE,GAAG,IAAI,CAAC;QACtD;IACF;AAEA;;AAEG;AACO,IAAA,cAAc,CAAC,MAAkB,EAAA;QACzC,IAAI,CAAC,MAAM,EAAE;AACX,YAAA,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;AACtB,YAAA,OAAO,KAAK;QACd;AAEA,QAAA,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;AAChB,YAAA,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;AACvB,YAAA,OAAO,KAAK;QACd;AAEA,QAAA,IAAI,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;AAChE,YAAA,IAAI,CAAC,KAAK,CAAC,wCAAwC,CAAC;AACpD,YAAA,OAAO,KAAK;QACd;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;;AAEG;IACH,SAAS,GAAA;AACP,QAAA,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;AACvB,YAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;AACnB,YAAA,OAAO,IAAI;QACb;QACA,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B;IACH;AAEA;;;;;;;;;;;;;;AAcG;IACI,aAAa,CAAC,IAAU,EAAE,SAAA,GAAoB,CAAC,GAAG,IAAI,GAAG,IAAI,EAAA;QAClE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;;YAErC,IAAI,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE;AAChC,gBAAA,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE;AAE/B,gBAAA,MAAM,CAAC,MAAM,GAAG,CAAC,CAA4B,KAAI;AAC/C,oBAAA,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,MAAqB;oBACnD,IAAI,WAAW,EAAE;AACf,wBAAA,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,WAAkB,CAAC;wBACnE,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;wBAC/C,OAAO,CAAC,IAAI,CAAC;oBACf;yBAAO;AACL,wBAAA,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;oBAC1C;AACF,gBAAA,CAAC;AAED,gBAAA,MAAM,CAAC,OAAO,GAAG,CAAC,KAAgC,KAAI;oBACpD,MAAM,CAAC,KAAK,CAAC;AACf,gBAAA,CAAC;AAED,gBAAA,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC;gBAC9B;YACF;;YAGA,IAAI,YAAY,GAAG,CAAC;AACpB,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;YAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE;AACxC,YAAA,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE;AAE/B,YAAA,MAAM,CAAC,MAAM,GAAG,CAAC,CAA4B,KAAI;AAC/C,gBAAA,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,MAAqB;gBACnD,IAAI,WAAW,EAAE;AACf,oBAAA,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,WAAkB,CAAC;AACnE,oBAAA,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;AAEvB,oBAAA,YAAY,EAAE;AAEd,oBAAA,IAAI,YAAY,GAAG,MAAM,EAAE;AACzB,wBAAA,QAAQ,EAAE;oBACZ;yBAAO;wBACL,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;wBACxC,OAAO,CAAC,IAAI,CAAC;oBACf;gBACF;AACF,YAAA,CAAC;AAED,YAAA,MAAM,CAAC,OAAO,GAAG,CAAC,KAAgC,KAAI;gBACpD,MAAM,CAAC,KAAK,CAAC;AACf,YAAA,CAAC;YAED,MAAM,QAAQ,GAAG,MAAK;AACpB,gBAAA,MAAM,KAAK,GAAG,YAAY,GAAG,SAAS;AACtC,gBAAA,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;gBAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;AACnC,gBAAA,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC;AAChC,YAAA,CAAC;AAED,YAAA,QAAQ,EAAE;AACZ,QAAA,CAAC,CAAC;IACJ;AAEA;;;;;;;;AAQG;AACK,IAAA,WAAW,CAAC,IAAU,EAAA;AAC5B,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI;QAC1B,MAAM,QAAQ,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;AAC/D,QAAA,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE;AACrD,QAAA,MAAM,eAAe,GAAG,CAAA,EAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA,CAAA,EAAI,IAAI,CAAC,GAAG,EAAE,EAAE;AACjE,QAAA,MAAM,WAAW,GAAG,CAAA,EAAG,eAAe,CAAA,CAAA,EAAI,aAAa,EAAE;QACzD,OAAO,CAAA,EAAG,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA,CAAA,EAAI,WAAW,CAAA,CAAE;IACrD;AAEA;;;;;;;;;;;AAWG;IACI,MAAM,YAAY,CAAC,IAAU,EAAA;QAClC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE;AACpC,YAAA,OAAO,IAAI;QACb;QAEA,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;AACnC,QAAA,OAAO,CAAA,QAAA,EAAW,cAAc,CAAC,IAAI,CAAC,IAAK,CAAC,CAAC,IAAI,CAAA,EAAG,IAAI,CAAA,CAAE;IAC5D;AAEA;;;;;;;;;;;;;;;;;;;;AAoBG;AACI,IAAA,MAAM,UAAU,CAAC,IAAU,EAAE,MAAqB,EAAA;QACvD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;AAClC,YAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;QAC/B;;AAGA,QAAA,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;AACb,YAAA,MAAM,IAAI,CAAC,OAAO,EAAE;QACtB;QAEA,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;AAClC,QAAA,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;QAEjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;AACrC,YAAA,IAAI,CAAC,GAAG,EAAE,SAAS,CACjB;gBACE,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,IAAK,CAAC,CAAC,IAAI;AACvC,gBAAA,MAAM,EAAE,MAAM;AACd,gBAAA,GAAG,EAAE,GAAG;AACR,gBAAA,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,MAAM,EAAE,kBAAkB;AACtC,gBAAA,GAAG,MAAM;AACT,gBAAA,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE;AACzD,aAAA,EACD,CAAC,GAAQ,EAAE,IAAkB,KAAI;gBAC/B,IAAI,GAAG,EAAE;AACP,oBAAA,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC;oBACxB,MAAM,CAAC,GAAG,CAAC;gBACb;qBAAO;AACL,oBAAA,MAAM,GAAG,GAAG,CAAA,QAAA,EAAW,IAAI,CAAC,QAAQ,EAAE;AACtC,oBAAA,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC;oBACtB,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;gBAC3B;AACF,YAAA,CAAC,CACF;AACH,QAAA,CAAC,CAAC;IACJ;AAEA;;AAEG;IACH,OAAO,GAAA;AACL,QAAA,IAAI,IAAI,CAAC,WAAW,EAAE;AACpB,YAAA,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YAClB;QACF;AAEA,QAAA,IAAI;;AAEF,YAAA,IAAI,CAAC,GAAG,GAAG,IAAI;;AAGf,YAAA,IAAI,CAAC,WAAW,GAAG,IAAI;AACvB,YAAA,IAAI,CAAC,aAAa,GAAG,KAAK;AAC1B,YAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,YAAA,IAAI,CAAC,OAAO,GAAG,EAAE;AACjB,YAAA,IAAI,CAAC,UAAU,GAAG,KAAK;AAEvB,YAAA,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;QACnB;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC;QAC9B;IACF;AACD;;;;"}

package/dist/types.d.ts

@@ -2,15 +2,16 @@ import type { EnvMode } from './config';
 /**
  * COS 初始化配置
  *
- * 注意：mode 参数必填，设计上不提供默认值
- * 原因：避免开发者忘记配置导致误传到错误环境
+ * 支持两种使用方式：
+ * 1. 构造函数传入配置，立即初始化
+ * 2. 稍后调用 init() 方法初始化（支持异步配置）
  */
 export interface InitConfig {
     /**
-     * 环境模式（必填，无默认值）
+     * 环境模式（必填）
      *
      * - development: 开发环境
-     * - testing: 测试环境
+     * - test: 测试环境
      * - production: 生产环境
      */
     mode: EnvMode;
@@ -18,6 +19,8 @@ export interface InitConfig {
     headers?: Record<string, any>;
     /** 是否限制临时密钥的使用范围（可选，默认 false） */
     ScopeLimit?: boolean;
+    /** 是否开启调试模式（可选，默认 false） */
+    debug?: boolean;
 }
 /**
  * 文件上传配置

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,aAAa;IACb,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,KAAK,IAAI,CAAC;IACjD,uBAAuB;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,aAAa;IACb,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,KAAK,IAAI,CAAC;IACjD,uBAAuB;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;CACb"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@be-link/cos",
-  "version": "1.11.5-beta.0",
+  "version": "1.12.0-beta.1",
   "description": "前端项目产物上传cos",
   "author": "zhuifeng <yangyiboys@163.com>",
   "homepage": "https://github.com/snowmountain-top/be-link#readme",
   "license": "ISC",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist",
@@ -24,10 +24,6 @@
     "cos-js-sdk-v5": "^1.8.6",
     "crypto-js": "^4.2.0"
   },
-  "dependencies": {
-    "cos-js-sdk-v5": "^1.8.6",
-    "crypto-js": "^4.2.0"
-  },
   "devDependencies": {
     "@types/crypto-js": "^4.2.2"
   },
@@ -36,9 +32,9 @@
   },
   "gitHead": "76b71bb6850e5f57f1a1ba4bd17f2ae0f603b67e",
   "scripts": {
-    "clean": "rimraf ./dist",
+    "clean": "rimraf ./dist && rimraf .rollup.cache",
     "build:js": "rollup --config rollup.config.ts --configPlugin typescript",
-    "build:types": "tsc --project tsconfig.json --emitDeclarationOnly --declarationDir dist",
+    "build:types": "tsc --project tsconfig.json",
     "build": "pnpm clean && pnpm build:js && pnpm build:types"
   }
 }

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":["../src/config.ts","../src/beLinkCos.ts"],"sourcesContent":["/**\n * 环境模式类型\n * - development: 开发环境\n * - testing: 测试环境\n * - production: 生产环境\n */\nexport type EnvMode = 'development' | 'testing' | 'production';\n\n/**\n * COS 存储桶配置接口\n */\nexport interface BucketConfig {\n  /** 存储桶名称 */\n  name: string;\n  /** 存储桶访问域名 */\n  host: string;\n  /** 访问协议 */\n  protocol: string;\n}\n\n/**\n * 各环境的 COS 存储桶配置\n * 根据环境自动切换到对应的存储桶\n */\nexport const BUCKETS_CONFIG: Record<EnvMode, BucketConfig> = {\n  development: {\n    name: 'dev-1304510571',\n    host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',\n    protocol: 'https',\n  },\n  testing: {\n    name: 'dev-1304510571',\n    host: 'dev-1304510571.cos.ap-nanjing.myqcloud.com',\n    protocol: 'https',\n  },\n  production: {\n    name: 'release-1304510571',\n    host: 'release-1304510571.file.myqcloud.com',\n    protocol: 'https',\n  },\n};\n\n/** COS 存储桶所在地域（南京） */\nexport const REGION = 'ap-nanjing' as const;\n","import CryptoJS from 'crypto-js';\n// @ts-ignore\nimport COS from 'cos-js-sdk-v5';\nimport { BUCKETS_CONFIG, REGION, type EnvMode } from './config';\nimport type { InitConfig, UploadConfig, UploadResult } from './types';\n\n/**\n * BeLinkCOS 类 - 腾讯云 COS 文件上传工具\n *\n * 功能：文件上传、MD5 计算、临时密钥授权\n *\n * @example\n * import { BeLinkCOS } from '@be-link/cos';\n *\n * const uploader = new BeLinkCOS({ mode: 'production' });\n * await uploader.uploadFile(file);\n */\nexport class BeLinkCOS {\n  /** COS SDK 实例 */\n  private cos: any = null;\n  /** COS 存储的基础路径 */\n  private readonly basePath: string = '/beLinkAllSource/static/';\n  /** 自定义请求头 */\n  public headers: Record<string, any>;\n  /** 当前环境模式 */\n  public mode: EnvMode;\n  /** 是否限制临时密钥的使用范围 */\n  private scopeLimit: boolean;\n\n  /**\n   * 构造函数\n   *\n   * 注意：mode 参数必填，没有默认值\n   * 设计理念：强制显式配置环境，避免误传到错误的环境\n   *\n   * @param config - 初始化配置\n   * @param config.mode - **必填** 环境模式：'development' | 'testing' | 'production'\n   * @param config.headers - 可选，自定义请求头\n   * @param config.ScopeLimit - 可选，是否限制临时密钥的使用范围（默认 false）\n   *\n   * @example\n   * // 基础使用\n   * const uploader = new BeLinkCOS({ mode: 'production' });\n   *\n   * // 带自定义请求头\n   * const uploader = new BeLinkCOS({\n   *   mode: 'production',\n   *   headers: { 'x-custom': 'value' }\n   * });\n   */\n  constructor(config: InitConfig) {\n    this.mode = config.mode;\n    this.headers = config.headers || {};\n    this.scopeLimit = config.ScopeLimit || false;\n  }\n\n  /**\n   * 初始化 COS SDK 实例\n   *\n   * 内部方法，通过云函数获取临时密钥\n   * 首次上传时会自动调用，也可以手动调用以重新初始化\n   *\n   * @returns Promise<void>\n   */\n  private async initCOS(): Promise<void> {\n    if (this.cos) {\n      return; // 已初始化，直接返回\n    }\n\n    const cos = new COS({\n      getAuthorization: (_options: any, callback: (p: any) => void) => {\n        const url =\n          this.mode === 'production'\n            ? 'https://shield-60660-10-1304510571.sh.run.tcloudbase.com/config/get-cos-temp-secret'\n            : 'https://shield-74680-5-1304510571.sh.run.tcloudbase.com/config/get-cos-temp-secret';\n        fetch(url, { method: 'POST' })\n          .then((response) => response.json())\n          .then((result) => {\n            const data = result?.data || {};\n            const credentials = data?.credentials;\n\n            callback({\n              TmpSecretId: credentials.tmpSecretId, // 临时密钥的 tmpSecretId\n              TmpSecretKey: credentials.tmpSecretKey, // 临时密钥的 tmpSecretKey\n              SecurityToken: credentials.sessionToken, // 临时密钥的 sessionToken\n              // 建议返回服务器时间作为签名的开始时间，避免用户浏览器本地时间偏差过大导致签名错误\n              StartTime: data.startTime, // 时间戳，单位秒，如：1580000000\n              ExpiredTime: data.expiredTime, // 临时密钥失效时间戳，是申请临时密钥时，时间戳加 durationSeconds\n              ScopeLimit: this.scopeLimit, // 细粒度控制权限需要设为 true，会限制密钥只在相同请求时重复使用\n            });\n          })\n          .catch((error) => {\n            console.error('Error fetching authorization:', error);\n            callback(null);\n          });\n      },\n    });\n    this.cos = cos;\n  }\n\n  /**\n   * 计算文件的 MD5 哈希值\n   *\n   * 性能优化：\n   * - 小文件（< 10MB）：一次性读取，速度更快\n   * - 大文件：分片读取，避免内存溢出\n   *\n   * @param file - 要计算 MD5 的文件对象\n   * @param chunkSize - 分片大小（字节），默认 2MB\n   * @returns Promise<string> 文件的 MD5 哈希值\n   *\n   * @example\n   * const md5 = await beLinkCOS.createFileMd5(file);\n   * console.log('文件 MD5:', md5);\n   */\n  public createFileMd5(file: File, chunkSize: number = 2 * 1024 * 1024): Promise<string> {\n    return new Promise((resolve, reject) => {\n      // 对于小文件（< 10MB），使用简单方法\n      if (file.size < 10 * 1024 * 1024) {\n        const reader = new FileReader();\n\n        reader.onload = (e: ProgressEvent<FileReader>) => {\n          const arrayBuffer = e.target?.result as ArrayBuffer;\n          if (arrayBuffer) {\n            const wordArray = CryptoJS.lib.WordArray.create(arrayBuffer as any);\n            const hash = CryptoJS.MD5(wordArray).toString();\n            resolve(hash);\n          } else {\n            reject(new Error('Failed to read file'));\n          }\n        };\n\n        reader.onerror = (error) => {\n          reject(error);\n        };\n\n        reader.readAsArrayBuffer(file);\n        return;\n      }\n\n      // 对于大文件，使用分片读取\n      let currentChunk = 0;\n      const chunks = Math.ceil(file.size / chunkSize);\n      const spark = CryptoJS.algo.MD5.create();\n      const reader = new FileReader();\n\n      reader.onload = (e: ProgressEvent<FileReader>) => {\n        const arrayBuffer = e.target?.result as ArrayBuffer;\n        if (arrayBuffer) {\n          const wordArray = CryptoJS.lib.WordArray.create(arrayBuffer as any);\n          spark.update(wordArray);\n\n          currentChunk++;\n\n          if (currentChunk < chunks) {\n            loadNext();\n          } else {\n            const hash = spark.finalize().toString();\n            resolve(hash);\n          }\n        }\n      };\n\n      reader.onerror = (error) => {\n        reject(error);\n      };\n\n      const loadNext = () => {\n        const start = currentChunk * chunkSize;\n        const end = Math.min(start + chunkSize, file.size);\n        const blob = file.slice(start, end);\n        reader.readAsArrayBuffer(blob);\n      };\n\n      loadNext();\n    });\n  }\n\n  /**\n   * 生成文件在 COS 中的存储路径\n   *\n   * 路径规则：/beLinkAllSource/static/{文件类型}/{文件名}_{时间戳}.{扩展名}\n   * 例如：/beLinkAllSource/static/image/avatar_1699999999999.png\n   *\n   * @param file - 文件对象\n   * @returns Promise<string> COS 存储路径\n   */\n  private async getFilePath(file: File): Promise<string> {\n    const filename = file.name;\n    const fileType = file?.type ? file.type.split('/')[0] : 'other';\n    const fileExtension = filename.split('.').pop() || '';\n    const filenameDateNow = `${filename.split('.')[0]}_${Date.now()}`;\n    const newFileName = `${filenameDateNow}.${fileExtension}`;\n    return `${this.basePath}${fileType}/${newFileName}`;\n  }\n\n  /**\n   * 获取文件上传后的访问 URL（不执行实际上传）\n   *\n   * 用于在上传前预览文件的最终 URL\n   *\n   * @param file - 文件对象\n   * @returns Promise<string> 文件的完整访问 URL\n   *\n   * @example\n   * const url = await beLinkCOS.getSourceUrl(file);\n   * console.log('文件将上传到:', url);\n   */\n  public async getSourceUrl(file: File): Promise<string> {\n    const path = await this.getFilePath(file);\n    return `https://${BUCKETS_CONFIG[this.mode].host}${path}`;\n  }\n\n  /**\n   * 上传文件到腾讯云 COS\n   *\n   * 核心功能：将文件上传到对应环境的 COS 存储桶\n   * 支持上传进度回调、自定义请求头等配置\n   *\n   * @param file - 要上传的文件对象\n   * @param config - 上传配置（可选）\n   * @param config.Headers - 自定义请求头\n   * @param config.onProgressCallback - 上传进度回调函数\n   * @returns Promise<UploadResult> 上传结果，包含文件 URL、ETag 等信息\n   *\n   * @example\n   * const uploader = new BeLinkCOS({ mode: 'production' });\n   * const result = await uploader.uploadFile(file, {\n   *   onProgressCallback: (progressData) => {\n   *     console.log('进度:', progressData.percent * 100 + '%');\n   *   }\n   * });\n   * console.log('文件 URL:', result.url);\n   */\n  public async uploadFile(file: File, config?: UploadConfig): Promise<UploadResult> {\n    // 首次上传时自动初始化 COS SDK\n    if (!this.cos) {\n      await this.initCOS();\n    }\n    const key = await this.getFilePath(file);\n\n    return new Promise((resolve, reject) => {\n      this.cos?.putObject(\n        {\n          Bucket: BUCKETS_CONFIG[this.mode].name,\n          Region: REGION,\n          Key: key,\n          Body: file,\n          onProgress: config?.onProgressCallback,\n          ...config,\n          Headers: { ...this.headers, ...(config?.Headers || {}) },\n        },\n        (err: any, data: UploadResult) => {\n          if (err) {\n            reject(err);\n          } else {\n            const url = `https://${data.Location}`;\n            resolve({ ...data, url });\n          }\n        },\n      );\n    });\n  }\n}\n"],"names":[],"mappings":"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"}