@bedelightful/upload-sdk 0.0.7

package/LICENSE

@@ -0,0 +1,8 @@
+Copyright 2026 BE DELIGHTFUL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

package/README.md

@@ -0,0 +1,132 @@
+# Upload SDK
+
+Unified upload toolkit supporting Aliyun OSS, Volcengine TOS, and Huawei OBS, with planned support for Tencent COS, Qiniu Kodo, Baidu BOS, NetEase NOS, and more.
+
+## Quick Start
+
+1) Install @bedelightful/upload-sdk
+
+```bash
+npm install @bedelightful/upload-sdk
+```
+
+2) Upload a file with upload-sdk (basic example):
+
+```ts
+const uploadTask = uploadSDK.upload({
+  url: "your back-end interface",
+  method: "GET",
+  file: yourFile, // File
+  fileName: yourFileName, // File name
+  headers: {
+    "request-id": Date.now(),
+  },
+});
+
+if (uploadTask.success) {
+  uploadTask.success((res: result) =>
+    console.log(`Upload complete: ${JSON.stringify(res)}`),
+  );
+}
+
+if (uploadTask.progress) {
+  uploadTask.progress((percent, loaded, total) =>
+    console.log(`File upload progress: ${percent}%`, loaded, total),
+  );
+}
+
+if (uploadTask.fail) {
+  uploadTask.fail((response) => console.log("- fail response -", response));
+}
+
+// ---------- Single upload task ----------
+// Cancel upload
+uploadTask.cancel();
+// Pause upload
+uploadTask.pause();
+// Resume upload
+uploadTask.resume();
+```
+
+## Upload Flow
+
+```mermaid
+---
+title: Upload SDK Flow
+---
+
+sequenceDiagram
+    Frontend-->>UploadSdk: Provide credential config
+    UploadSdk->>AppBackend: Send request for temporary upload credential
+    AppBackend->>BaseService: Add required params (platform, bucket, etc.) and request temporary credential
+    BaseService->>AppBackend: Return temporary credential
+    AppBackend-->>UploadSdk: Return temporary credential
+    UploadSdk-->>CloudPlatform: Upload file
+    CloudPlatform-->>BaseService: Trigger upload callback (Aliyun)
+    CloudPlatform-->>UploadSdk: Upload succeeded
+    UploadSdk-->>Frontend: Return platform/path parameters
+    Frontend-->>AppBackend: Persist path and related info
+```
+
+Note: Volcengine does not currently support upload callbacks, but the flow remains unchanged.
+
+## Performance Features
+
+### Code splitting and on-demand loading
+
+Starting from version x.x.x, upload-sdk supports code splitting and on-demand loading of platform modules. Adapters are loaded only when needed, reducing initial bundle size and improving startup performance.
+
+#### Usage
+
+Asynchronous import (recommended):
+
+```typescript
+import { Upload, loadPlatformModule, PlatformType } from "@delightful/upload-sdk";
+
+// Preload specific platform modules (optional)
+async function preloadModules() {
+  // Load only required platform modules
+  await loadPlatformModule(PlatformType.ALiYun);
+  console.log("Aliyun module loaded");
+}
+
+// Or auto-load during upload
+const upload = new Upload();
+upload.upload({
+  url: "your-api-url",
+  method: "POST",
+  file: yourFile,
+  fileName: "example.jpg",
+  // ... other options
+});
+```
+
+Compatibility mode (backward-compatible):
+
+```typescript
+import { Upload } from "@delightful/upload-sdk";
+
+// Continue using the original approach; SDK will lazy-load internally
+const upload = new Upload();
+// ... other code unchanged
+```
+
+## Supported Platforms
+
+| Platform     | Status          | Notes                                            |
+| ------------ | ---------------- | ------------------------------------------------ |
+| Aliyun OSS   | ✅ Supported     | Multipart upload, checkpoint resume supported    |
+| Volcengine TOS | ✅ Supported   | Multipart upload, checkpoint resume supported    |
+| Huawei OBS   | ✅ Supported     | Multipart upload, checkpoint resume supported    |
+| Qiniu Kodo   | ✅ Supported     | Basic upload supported                           |
+| Tencent COS  | 🔄 Planned       | In development                                   |
+| Baidu BOS    | 🔄 Planned       | In development                                   |
+| NetEase NOS  | 🔄 Planned       | In development                                   |
+| MinIO/S3     | ✅ Supported     | Multipart upload, checkpoint resume supported    |
+| Azure Blob   | 🔄 Planned       | In development                                   |
+
+> For platforms not yet supported, please open an issue or PR to help us prioritize.
+
+
+
+

package/dist/es/Exception/BaseException.js

@@ -0,0 +1,14 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const _BaseException = class _BaseException extends Error {
+  constructor(message) {
+    super();
+    this.message = `[Uploader] ${message}`;
+  }
+};
+__name(_BaseException, "BaseException");
+let BaseException = _BaseException;
+export {
+  BaseException
+};
+//# sourceMappingURL=BaseException.js.map

package/dist/es/Exception/BaseException.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/Exception/BaseException.ts"],"sourcesContent":["export class BaseException extends Error {\n\tconstructor(message: string) {\n\t\tsuper()\n\t\tthis.message = `[Uploader] ${message}`\n\t}\n}\n\n\n\n\n"],"mappings":";;AAAQ,MAAM,iBAAN,MAAM,uBAAsB,MAAM;AAAA,EACzC,YAAY,SAAiB;AAC5B,UAAM;AACN,SAAK,UAAU,cAAc,OAAO;AAAA,EACrC;AACD;AAL0C;AAAlC,IAAM,gBAAN;","names":[]}

package/dist/es/Exception/DownloadException.js

@@ -0,0 +1,40 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { BaseException } from "./BaseException";
+var DownloadExceptionCode = /* @__PURE__ */ ((DownloadExceptionCode2) => {
+  DownloadExceptionCode2["DOWNLOAD_UNKNOWN_ERROR"] = "DOWNLOAD_UNKNOWN_ERROR";
+  DownloadExceptionCode2["CODE_IS_NOT_1000"] = "CODE_IS_NOT_1000";
+  DownloadExceptionCode2["DOWNLOAD_REQUEST_ERROR"] = "DOWNLOAD_REQUEST_ERROR";
+  return DownloadExceptionCode2;
+})(DownloadExceptionCode || {});
+const DownloadExceptionMapping = {
+  DOWNLOAD_UNKNOWN_ERROR: () => ({
+    status: 3e3,
+    message: "An unknown error occurred on the download"
+  }),
+  CODE_IS_NOT_1000: (message) => ({
+    status: 3001,
+    message: `The content code returned is not 1000, message: ${message}`
+  }),
+  DOWNLOAD_REQUEST_ERROR: (status) => ({
+    status: 3002,
+    message: `Download request error, status: ${status}`
+  })
+};
+const _DownloadException = class _DownloadException extends BaseException {
+  constructor(errType, ...args) {
+    const e = DownloadExceptionMapping[errType] || DownloadExceptionMapping.DOWNLOAD_UNKNOWN_ERROR;
+    const { status, message } = e.apply(null, [...args]);
+    super(message);
+    this.name = "DownloadException";
+    this.status = status;
+  }
+};
+__name(_DownloadException, "DownloadException");
+let DownloadException = _DownloadException;
+export {
+  DownloadException,
+  DownloadExceptionCode,
+  DownloadExceptionMapping
+};
+//# sourceMappingURL=DownloadException.js.map

package/dist/es/Exception/DownloadException.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/Exception/DownloadException.ts"],"sourcesContent":["import type { ErrorType } from \"../types/error\"\nimport { BaseException } from \"./BaseException\"\n\nexport const enum DownloadExceptionCode {\n\tDOWNLOAD_UNKNOWN_ERROR = \"DOWNLOAD_UNKNOWN_ERROR\",\n\tCODE_IS_NOT_1000 = \"CODE_IS_NOT_1000\",\n\tDOWNLOAD_REQUEST_ERROR = \"DOWNLOAD_REQUEST_ERROR\",\n}\n\n/** Download API exception classification */\nexport const DownloadExceptionMapping: Record<\n\tstring,\n\t(...args: any[]) => ErrorType.BaseExceptionWithStatus\n> = {\n\tDOWNLOAD_UNKNOWN_ERROR: () => ({\n\t\tstatus: 3000,\n\t\tmessage: \"An unknown error occurred on the download\",\n\t}),\n\tCODE_IS_NOT_1000: (message: string) => ({\n\t\tstatus: 3001,\n\t\tmessage: `The content code returned is not 1000, message: ${message}`,\n\t}),\n\tDOWNLOAD_REQUEST_ERROR: (status: number) => ({\n\t\tstatus: 3002,\n\t\tmessage: `Download request error, status: ${status}`,\n\t}),\n}\n\n/**\n * Download API exceptions\n * Exceptions Handler.\n */\nexport class DownloadException extends BaseException {\n\tpublic readonly status: number\n\n\tpublic readonly name = \"DownloadException\"\n\n\tconstructor(errType: keyof typeof DownloadExceptionMapping, ...args: any[]) {\n\t\tconst e =\n\t\t\tDownloadExceptionMapping[errType] || DownloadExceptionMapping.DOWNLOAD_UNKNOWN_ERROR\n\t\tconst { status, message } = e.apply(null, [...args])\n\t\tsuper(message)\n\t\tthis.status = status\n\t}\n}\n\n\n\n\n"],"mappings":";;AACA,SAAS,qBAAqB;AAEvB,IAAW,wBAAX,kBAAWA,2BAAX;AACN,EAAAA,uBAAA,4BAAyB;AACzB,EAAAA,uBAAA,sBAAmB;AACnB,EAAAA,uBAAA,4BAAyB;AAHR,SAAAA;AAAA,GAAA;AAOX,MAAM,2BAGT;AAAA,EACH,wBAAwB,OAAO;AAAA,IAC9B,QAAQ;AAAA,IACR,SAAS;AAAA,EACV;AAAA,EACA,kBAAkB,CAAC,aAAqB;AAAA,IACvC,QAAQ;AAAA,IACR,SAAS,mDAAmD,OAAO;AAAA,EACpE;AAAA,EACA,wBAAwB,CAAC,YAAoB;AAAA,IAC5C,QAAQ;AAAA,IACR,SAAS,mCAAmC,MAAM;AAAA,EACnD;AACD;AAMO,MAAM,qBAAN,MAAM,2BAA0B,cAAc;AAAA,EAKpD,YAAY,YAAmD,MAAa;AAC3E,UAAM,IACL,yBAAyB,OAAO,KAAK,yBAAyB;AAC/D,UAAM,EAAE,QAAQ,QAAQ,IAAI,EAAE,MAAM,MAAM,CAAC,GAAG,IAAI,CAAC;AACnD,UAAM,OAAO;AANd,SAAgB,OAAO;AAOtB,SAAK,SAAS;AAAA,EACf;AACD;AAZqD;AAA9C,IAAM,oBAAN;","names":["DownloadExceptionCode"]}

package/dist/es/Exception/HttpException.js

@@ -0,0 +1,50 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { BaseException } from "./BaseException";
+var HttpExceptionCode = /* @__PURE__ */ ((HttpExceptionCode2) => {
+  HttpExceptionCode2["HTTP_UNKNOWN_ERROR"] = "HTTP_UNKNOWN_ERROR";
+  HttpExceptionCode2["REQUEST_FAILED_WITH_STATUS_CODE"] = "REQUEST_FAILED_WITH_STATUS_CODE";
+  HttpExceptionCode2["REQUEST_IS_CANCEL"] = "REQUEST_IS_CANCEL";
+  HttpExceptionCode2["REQUEST_IS_PAUSE"] = "REQUEST_IS_PAUSE";
+  HttpExceptionCode2["REQUEST_NO_XHR_OBJ_AVAILABLE"] = "REQUEST_NO_XHR_OBJ_AVAILABLE";
+  return HttpExceptionCode2;
+})(HttpExceptionCode || {});
+const HttpExceptionMapping = {
+  REQUEST_UNKNOWN_ERROR: () => ({
+    status: 0,
+    message: "An unknown error occurred on the request"
+  }),
+  REQUEST_NO_XHR_OBJ_AVAILABLE: () => ({
+    status: 0,
+    message: "No XHR object available"
+  }),
+  REQUEST_FAILED_WITH_STATUS_CODE: (status) => ({
+    status,
+    message: `{status: ${status}, message: Request failed}`
+  }),
+  REQUEST_IS_CANCEL: () => ({
+    status: 5001,
+    message: "The request was canceled"
+  }),
+  REQUEST_IS_PAUSE: () => ({
+    status: 5002,
+    message: "The request was paused"
+  })
+};
+const _HttpException = class _HttpException extends BaseException {
+  constructor(errType, ...args) {
+    const e = HttpExceptionMapping[errType] || HttpExceptionMapping.REQUEST_UNKNOWN_ERROR;
+    const { status, message } = e.apply(null, [...args]);
+    super(message);
+    this.name = "HttpException";
+    this.status = status;
+  }
+};
+__name(_HttpException, "HttpException");
+let HttpException = _HttpException;
+export {
+  HttpException,
+  HttpExceptionCode,
+  HttpExceptionMapping
+};
+//# sourceMappingURL=HttpException.js.map

package/dist/es/Exception/HttpException.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/Exception/HttpException.ts"],"sourcesContent":["import type { ErrorType } from \"../types/error\"\nimport { BaseException } from \"./BaseException\"\n\nexport const enum HttpExceptionCode {\n\tHTTP_UNKNOWN_ERROR = \"HTTP_UNKNOWN_ERROR\",\n\tREQUEST_FAILED_WITH_STATUS_CODE = \"REQUEST_FAILED_WITH_STATUS_CODE\",\n\tREQUEST_IS_CANCEL = \"REQUEST_IS_CANCEL\",\n\tREQUEST_IS_PAUSE = \"REQUEST_IS_PAUSE\",\n\tREQUEST_NO_XHR_OBJ_AVAILABLE = \"REQUEST_NO_XHR_OBJ_AVAILABLE\",\n}\n\n/** HTTP exception classification */\nexport const HttpExceptionMapping: Record<\n\tstring,\n\t(...args: any[]) => ErrorType.BaseExceptionWithStatus\n> = {\n\tREQUEST_UNKNOWN_ERROR: () => ({\n\t\tstatus: 0,\n\t\tmessage: \"An unknown error occurred on the request\",\n\t}),\n\tREQUEST_NO_XHR_OBJ_AVAILABLE: () => ({\n\t\tstatus: 0,\n\t\tmessage: \"No XHR object available\",\n\t}),\n\tREQUEST_FAILED_WITH_STATUS_CODE: (status: number) => ({\n\t\tstatus,\n\t\tmessage: `{status: ${status}, message: Request failed}`,\n\t}),\n\tREQUEST_IS_CANCEL: () => ({\n\t\tstatus: 5001,\n\t\tmessage: \"The request was canceled\",\n\t}),\n\tREQUEST_IS_PAUSE: () => ({\n\t\tstatus: 5002,\n\t\tmessage: \"The request was paused\",\n\t}),\n}\n\n/**\n * HTTP general request exceptions handler.\n */\nexport class HttpException extends BaseException {\n\tpublic readonly status: number\n\n\tpublic readonly name = \"HttpException\"\n\n\tconstructor(errType: keyof typeof HttpExceptionMapping, ...args: any[]) {\n\t\tconst e = HttpExceptionMapping[errType] || HttpExceptionMapping.REQUEST_UNKNOWN_ERROR\n\t\tconst { status, message } = e.apply(null, [...args])\n\t\tsuper(message)\n\t\tthis.status = status\n\t}\n}\n\n\n\n\n"],"mappings":";;AACA,SAAS,qBAAqB;AAEvB,IAAW,oBAAX,kBAAWA,uBAAX;AACN,EAAAA,mBAAA,wBAAqB;AACrB,EAAAA,mBAAA,qCAAkC;AAClC,EAAAA,mBAAA,uBAAoB;AACpB,EAAAA,mBAAA,sBAAmB;AACnB,EAAAA,mBAAA,kCAA+B;AALd,SAAAA;AAAA,GAAA;AASX,MAAM,uBAGT;AAAA,EACH,uBAAuB,OAAO;AAAA,IAC7B,QAAQ;AAAA,IACR,SAAS;AAAA,EACV;AAAA,EACA,8BAA8B,OAAO;AAAA,IACpC,QAAQ;AAAA,IACR,SAAS;AAAA,EACV;AAAA,EACA,iCAAiC,CAAC,YAAoB;AAAA,IACrD;AAAA,IACA,SAAS,YAAY,MAAM;AAAA,EAC5B;AAAA,EACA,mBAAmB,OAAO;AAAA,IACzB,QAAQ;AAAA,IACR,SAAS;AAAA,EACV;AAAA,EACA,kBAAkB,OAAO;AAAA,IACxB,QAAQ;AAAA,IACR,SAAS;AAAA,EACV;AACD;AAKO,MAAM,iBAAN,MAAM,uBAAsB,cAAc;AAAA,EAKhD,YAAY,YAA+C,MAAa;AACvE,UAAM,IAAI,qBAAqB,OAAO,KAAK,qBAAqB;AAChE,UAAM,EAAE,QAAQ,QAAQ,IAAI,EAAE,MAAM,MAAM,CAAC,GAAG,IAAI,CAAC;AACnD,UAAM,OAAO;AALd,SAAgB,OAAO;AAMtB,SAAK,SAAS;AAAA,EACf;AACD;AAXiD;AAA1C,IAAM,gBAAN;","names":["HttpExceptionCode"]}

package/dist/es/Exception/InitException.js

@@ -0,0 +1,49 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { BaseException } from "./BaseException";
+var InitExceptionCode = /* @__PURE__ */ ((InitExceptionCode2) => {
+  InitExceptionCode2["INIT_UNKNOWN_ERROR"] = "INIT_UNKNOWN_ERROR";
+  InitExceptionCode2["MISSING_PARAMS_FOR_UPLOAD"] = "MISSING_PARAMS_FOR_UPLOAD";
+  InitExceptionCode2["UPLOAD_API_OPTION_PARTSIZE_MUST_INT"] = "UPLOAD_API_OPTION_PARTSIZE_MUST_INT";
+  InitExceptionCode2["UPLOAD_API_OPTION_PARTSIZE_IS_SMALL"] = "UPLOAD_API_OPTION_PARTSIZE_IS_SMALL";
+  InitExceptionCode2["UPLOAD_IS_NO_SUPPORT_THIS_PLATFORM"] = "UPLOAD_IS_NO_SUPPORT_THIS_PLATFORM";
+  InitExceptionCode2["UPLOAD_FILE_TO_BIG"] = "UPLOAD_FILE_TO_BIG";
+  InitExceptionCode2["UPLOAD_IS_NO_SUPPORT_THIS_FILE_FORMAT"] = "UPLOAD_IS_NO_SUPPORT_THIS_FILE_FORMAT";
+  InitExceptionCode2["REUPLOAD_IS_FAILED"] = "REUPLOAD_IS_FAILED";
+  InitExceptionCode2["UPLOAD_HEAD_NO_EXPOSE_ETAG"] = "UPLOAD_HEAD_NO_EXPOSE_ETAG";
+  InitExceptionCode2["UPLOAD_REQUEST_CREDENTIALS_ERROR"] = "UPLOAD_REQUEST_CREDENTIALS_ERROR";
+  InitExceptionCode2["MISSING_CREDENTIALS_PARAMS_FOR_UPLOAD"] = "MISSING_CREDENTIALS_PARAMS_FOR_UPLOAD";
+  InitExceptionCode2["UPLOAD_FILENAME_EXIST_SPECIAL_CHAR"] = "UPLOAD_FILENAME_EXIST_SPECIAL_CHAR";
+  return InitExceptionCode2;
+})(InitExceptionCode || {});
+const InitExceptionMapping = {
+  INIT_UNKNOWN_ERROR: () => `An unknown error occurred in the initialization api`,
+  MISSING_PARAMS_FOR_UPLOAD: (...args) => `${args.join(", ")} must be provided for upload`,
+  UPLOAD_API_OPTION_PARTSIZE_MUST_INT: () => "partSize must be int number",
+  UPLOAD_API_OPTION_PARTSIZE_IS_SMALL: (minPartSize) => `partSize must not be smaller than ${minPartSize}`,
+  UPLOAD_IS_NO_SUPPORT_THIS_PLATFORM: (platform) => `${platform} is not supported`,
+  UPLOAD_FILE_TO_BIG: (fileName) => `${fileName} failed to upload. The file size cannot exceed 5 GB`,
+  UPLOAD_IS_NO_SUPPORT_THIS_FILE_FORMAT: () => "Must provide Blob/File for upload.",
+  REUPLOAD_IS_FAILED: () => "Please re-check the request upload credentials configuration. The credentials information has expired",
+  UPLOAD_HEAD_NO_EXPOSE_ETAG: () => "Please set the etag of expose-headers in OSS \n https://help.aliyun.com/document_detail/64041.html",
+  UPLOAD_REQUEST_CREDENTIALS_ERROR: (message) => `An error occurred requesting file service temporary credentials, message\uFF1A ${message}`,
+  MISSING_CREDENTIALS_PARAMS_FOR_UPLOAD: (platform, ...args) => `${platform.toUpperCase()} - The credential field must have the following fields, ${args.join(
+    ", "
+  )}`,
+  UPLOAD_FILENAME_EXIST_SPECIAL_CHAR: (fileName) => `The filename cannot contain special characters, fileName: ${fileName}`
+};
+const _InitException = class _InitException extends BaseException {
+  constructor(errType, ...args) {
+    const e = InitExceptionMapping[errType] || InitExceptionMapping.INIT_UNKNOWN_ERROR;
+    const message = e?.apply(null, [...args]) || "";
+    super(message);
+    this.name = "InitException";
+  }
+};
+__name(_InitException, "InitException");
+let InitException = _InitException;
+export {
+  InitException,
+  InitExceptionCode
+};
+//# sourceMappingURL=InitException.js.map

package/dist/es/Exception/InitException.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/Exception/InitException.ts"],"sourcesContent":["import { BaseException } from \"./BaseException\"\n\nexport const enum InitExceptionCode {\n\tINIT_UNKNOWN_ERROR = \"INIT_UNKNOWN_ERROR\",\n\tMISSING_PARAMS_FOR_UPLOAD = \"MISSING_PARAMS_FOR_UPLOAD\",\n\tUPLOAD_API_OPTION_PARTSIZE_MUST_INT = \"UPLOAD_API_OPTION_PARTSIZE_MUST_INT\",\n\tUPLOAD_API_OPTION_PARTSIZE_IS_SMALL = \"UPLOAD_API_OPTION_PARTSIZE_IS_SMALL\",\n\tUPLOAD_IS_NO_SUPPORT_THIS_PLATFORM = \"UPLOAD_IS_NO_SUPPORT_THIS_PLATFORM\",\n\tUPLOAD_FILE_TO_BIG = \"UPLOAD_FILE_TO_BIG\",\n\tUPLOAD_IS_NO_SUPPORT_THIS_FILE_FORMAT = \"UPLOAD_IS_NO_SUPPORT_THIS_FILE_FORMAT\",\n\tREUPLOAD_IS_FAILED = \"REUPLOAD_IS_FAILED\",\n\tUPLOAD_HEAD_NO_EXPOSE_ETAG = \"UPLOAD_HEAD_NO_EXPOSE_ETAG\",\n\tUPLOAD_REQUEST_CREDENTIALS_ERROR = \"UPLOAD_REQUEST_CREDENTIALS_ERROR\",\n\tMISSING_CREDENTIALS_PARAMS_FOR_UPLOAD = \"MISSING_CREDENTIALS_PARAMS_FOR_UPLOAD\",\n\tUPLOAD_FILENAME_EXIST_SPECIAL_CHAR = \"UPLOAD_FILENAME_EXIST_SPECIAL_CHAR\",\n}\n\n/** Initialization API exception classification */\nconst InitExceptionMapping: Record<string, (...args: any[]) => string> = {\n\tINIT_UNKNOWN_ERROR: () => `An unknown error occurred in the initialization api`,\n\tMISSING_PARAMS_FOR_UPLOAD: (...args: string[]) =>\n\t\t`${args.join(\", \")} must be provided for upload`,\n\tUPLOAD_API_OPTION_PARTSIZE_MUST_INT: () => \"partSize must be int number\",\n\tUPLOAD_API_OPTION_PARTSIZE_IS_SMALL: (minPartSize: number) =>\n\t\t`partSize must not be smaller than ${minPartSize}`,\n\tUPLOAD_IS_NO_SUPPORT_THIS_PLATFORM: (platform: string) => `${platform} is not supported`,\n\tUPLOAD_FILE_TO_BIG: (fileName: string) =>\n\t\t`${fileName} failed to upload. The file size cannot exceed 5 GB`,\n\tUPLOAD_IS_NO_SUPPORT_THIS_FILE_FORMAT: () => \"Must provide Blob/File for upload.\",\n\tREUPLOAD_IS_FAILED: () =>\n\t\t\"Please re-check the request upload credentials configuration. The credentials information has expired\",\n\tUPLOAD_HEAD_NO_EXPOSE_ETAG: () =>\n\t\t\"Please set the etag of expose-headers in OSS \\n https://help.aliyun.com/document_detail/64041.html\",\n\tUPLOAD_REQUEST_CREDENTIALS_ERROR: (message: string) =>\n\t\t`An error occurred requesting file service temporary credentials, message： ${message}`,\n\tMISSING_CREDENTIALS_PARAMS_FOR_UPLOAD: (platform: string, ...args: string[]) =>\n\t\t`${platform.toUpperCase()} - The credential field must have the following fields, ${args.join(\n\t\t\t\", \",\n\t\t)}`,\n\tUPLOAD_FILENAME_EXIST_SPECIAL_CHAR: (fileName: string) =>\n\t\t`The filename cannot contain special characters, fileName: ${fileName}`,\n}\n\n/**\n * API exceptions during initialization\n * Exceptions Handler.\n */\nexport class InitException extends BaseException {\n\tpublic override readonly name = \"InitException\"\n\n\tconstructor(errType: keyof typeof InitExceptionMapping, ...args: any[]) {\n\t\tconst e = InitExceptionMapping[errType] || InitExceptionMapping.INIT_UNKNOWN_ERROR\n\t\tconst message = e?.apply(null, [...args]) || \"\"\n\t\tsuper(message)\n\t}\n}\n\n\n\n\n"],"mappings":";;AAAC,SAAS,qBAAqB;AAExB,IAAW,oBAAX,kBAAWA,uBAAX;AACN,EAAAA,mBAAA,wBAAqB;AACrB,EAAAA,mBAAA,+BAA4B;AAC5B,EAAAA,mBAAA,yCAAsC;AACtC,EAAAA,mBAAA,yCAAsC;AACtC,EAAAA,mBAAA,wCAAqC;AACrC,EAAAA,mBAAA,wBAAqB;AACrB,EAAAA,mBAAA,2CAAwC;AACxC,EAAAA,mBAAA,wBAAqB;AACrB,EAAAA,mBAAA,gCAA6B;AAC7B,EAAAA,mBAAA,sCAAmC;AACnC,EAAAA,mBAAA,2CAAwC;AACxC,EAAAA,mBAAA,wCAAqC;AAZpB,SAAAA;AAAA,GAAA;AAgBlB,MAAM,uBAAmE;AAAA,EACxE,oBAAoB,MAAM;AAAA,EAC1B,2BAA2B,IAAI,SAC9B,GAAG,KAAK,KAAK,IAAI,CAAC;AAAA,EACnB,qCAAqC,MAAM;AAAA,EAC3C,qCAAqC,CAAC,gBACrC,qCAAqC,WAAW;AAAA,EACjD,oCAAoC,CAAC,aAAqB,GAAG,QAAQ;AAAA,EACrE,oBAAoB,CAAC,aACpB,GAAG,QAAQ;AAAA,EACZ,uCAAuC,MAAM;AAAA,EAC7C,oBAAoB,MACnB;AAAA,EACD,4BAA4B,MAC3B;AAAA,EACD,kCAAkC,CAAC,YAClC,kFAA6E,OAAO;AAAA,EACrF,uCAAuC,CAAC,aAAqB,SAC5D,GAAG,SAAS,YAAY,CAAC,2DAA2D,KAAK;AAAA,IACxF;AAAA,EACD,CAAC;AAAA,EACF,oCAAoC,CAAC,aACpC,6DAA6D,QAAQ;AACvE;AAMO,MAAM,iBAAN,MAAM,uBAAsB,cAAc;AAAA,EAGhD,YAAY,YAA+C,MAAa;AACvE,UAAM,IAAI,qBAAqB,OAAO,KAAK,qBAAqB;AAChE,UAAM,UAAU,GAAG,MAAM,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK;AAC7C,UAAM,OAAO;AALd,SAAyB,OAAO;AAAA,EAMhC;AACD;AARiD;AAA1C,IAAM,gBAAN;","names":["InitExceptionCode"]}

package/dist/es/Exception/UploadException.js

@@ -0,0 +1,50 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { BaseException } from "./BaseException";
+var UploadExceptionCode = /* @__PURE__ */ ((UploadExceptionCode2) => {
+  UploadExceptionCode2["UPLOAD_UNKNOWN_ERROR"] = "UPLOAD_UNKNOWN_ERROR";
+  UploadExceptionCode2["UPLOAD_CANCEL"] = "UPLOAD_CANCEL";
+  UploadExceptionCode2["UPLOAD_PAUSE"] = "UPLOAD_PAUSE";
+  UploadExceptionCode2["UPLOAD_CREDENTIALS_IS_EXPIRED"] = "UPLOAD_CREDENTIALS_IS_EXPIRED";
+  UploadExceptionCode2["UPLOAD_MULTIPART_ERROR"] = "UPLOAD_MULTIPART_ERROR";
+  return UploadExceptionCode2;
+})(UploadExceptionCode || {});
+const UploadExceptionMapping = {
+  UPLOAD_UNKNOWN_ERROR: () => ({
+    status: 1e3,
+    message: "An unknown error occurred on the upload"
+  }),
+  UPLOAD_CANCEL: () => ({
+    status: 1001,
+    message: "{status: 1001, message: isCancel}"
+  }),
+  UPLOAD_PAUSE: () => ({
+    status: 1002,
+    message: "{status: 1002, message: isPause}"
+  }),
+  UPLOAD_CREDENTIALS_IS_EXPIRED: () => ({
+    status: 1003,
+    message: "{status: 1003, message: credentials is expired}"
+  }),
+  UPLOAD_MULTIPART_ERROR: (message, partNum) => ({
+    status: 1004,
+    message: `{status: 1004, message: Failed to upload some parts with error: ${message} part_num: ${partNum}`
+  })
+};
+const _UploadException = class _UploadException extends BaseException {
+  constructor(errType, ...args) {
+    const e = UploadExceptionMapping[errType] || UploadExceptionMapping.UPLOAD_UNKNOWN_ERROR;
+    const { status, message } = e.apply(null, [...args]);
+    super(message);
+    this.name = "UploadException";
+    this.status = status;
+  }
+};
+__name(_UploadException, "UploadException");
+let UploadException = _UploadException;
+export {
+  UploadException,
+  UploadExceptionCode,
+  UploadExceptionMapping
+};
+//# sourceMappingURL=UploadException.js.map

package/dist/es/Exception/UploadException.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/Exception/UploadException.ts"],"sourcesContent":["import type { ErrorType } from \"../types/error\"\nimport { BaseException } from \"./BaseException\"\n\nexport const enum UploadExceptionCode {\n\tUPLOAD_UNKNOWN_ERROR = \"UPLOAD_UNKNOWN_ERROR\",\n\tUPLOAD_CANCEL = \"UPLOAD_CANCEL\",\n\tUPLOAD_PAUSE = \"UPLOAD_PAUSE\",\n\tUPLOAD_CREDENTIALS_IS_EXPIRED = \"UPLOAD_CREDENTIALS_IS_EXPIRED\",\n\tUPLOAD_MULTIPART_ERROR = \"UPLOAD_MULTIPART_ERROR\",\n}\n\n/** Upload API exception classification */\nexport const UploadExceptionMapping: Record<\n\tstring,\n\t(...args: any[]) => ErrorType.BaseExceptionWithStatus\n> = {\n\tUPLOAD_UNKNOWN_ERROR: () => ({\n\t\tstatus: 1000,\n\t\tmessage: \"An unknown error occurred on the upload\",\n\t}),\n\tUPLOAD_CANCEL: () => ({\n\t\tstatus: 1001,\n\t\tmessage: \"{status: 1001, message: isCancel}\",\n\t}),\n\tUPLOAD_PAUSE: () => ({\n\t\tstatus: 1002,\n\t\tmessage: \"{status: 1002, message: isPause}\",\n\t}),\n\tUPLOAD_CREDENTIALS_IS_EXPIRED: () => ({\n\t\tstatus: 1003,\n\t\tmessage: \"{status: 1003, message: credentials is expired}\",\n\t}),\n\tUPLOAD_MULTIPART_ERROR: (message: string, partNum: number) => ({\n\t\tstatus: 1004,\n\t\tmessage: `{status: 1004, message: Failed to upload some parts with error: ${message} part_num: ${partNum}`,\n\t}),\n}\n\n/**\n * Upload API exceptions\n * Exceptions Handler.\n */\nexport class UploadException extends BaseException {\n\tpublic readonly status: number\n\n\tpublic readonly name = \"UploadException\"\n\n\tconstructor(errType: keyof typeof UploadExceptionMapping, ...args: any[]) {\n\t\tconst e = UploadExceptionMapping[errType] || UploadExceptionMapping.UPLOAD_UNKNOWN_ERROR\n\t\tconst { status, message } = e.apply(null, [...args])\n\t\tsuper(message)\n\t\tthis.status = status\n\t}\n}\n\n\n\n\n"],"mappings":";;AACA,SAAS,qBAAqB;AAEvB,IAAW,sBAAX,kBAAWA,yBAAX;AACN,EAAAA,qBAAA,0BAAuB;AACvB,EAAAA,qBAAA,mBAAgB;AAChB,EAAAA,qBAAA,kBAAe;AACf,EAAAA,qBAAA,mCAAgC;AAChC,EAAAA,qBAAA,4BAAyB;AALR,SAAAA;AAAA,GAAA;AASX,MAAM,yBAGT;AAAA,EACH,sBAAsB,OAAO;AAAA,IAC5B,QAAQ;AAAA,IACR,SAAS;AAAA,EACV;AAAA,EACA,eAAe,OAAO;AAAA,IACrB,QAAQ;AAAA,IACR,SAAS;AAAA,EACV;AAAA,EACA,cAAc,OAAO;AAAA,IACpB,QAAQ;AAAA,IACR,SAAS;AAAA,EACV;AAAA,EACA,+BAA+B,OAAO;AAAA,IACrC,QAAQ;AAAA,IACR,SAAS;AAAA,EACV;AAAA,EACA,wBAAwB,CAAC,SAAiB,aAAqB;AAAA,IAC9D,QAAQ;AAAA,IACR,SAAS,mEAAmE,OAAO,cAAc,OAAO;AAAA,EACzG;AACD;AAMO,MAAM,mBAAN,MAAM,yBAAwB,cAAc;AAAA,EAKlD,YAAY,YAAiD,MAAa;AACzE,UAAM,IAAI,uBAAuB,OAAO,KAAK,uBAAuB;AACpE,UAAM,EAAE,QAAQ,QAAQ,IAAI,EAAE,MAAM,MAAM,CAAC,GAAG,IAAI,CAAC;AACnD,UAAM,OAAO;AALd,SAAgB,OAAO;AAMtB,SAAK,SAAS;AAAA,EACf;AACD;AAXmD;AAA5C,IAAM,kBAAN;","names":["UploadExceptionCode"]}