@uploadcare/upload-client 6.11.1 → 6.12.0

package/dist/cjs/index.react-native.cjs

@@ -91,13 +91,16 @@ function retrier(fn, options = defaultOptions) {
     return runAttempt(fn);
 }
 
-class UploadcareNetworkError extends Error {
+class UploadcareError extends Error {
+}
+
+class NetworkError extends UploadcareError {
     originalProgressEvent;
     constructor(progressEvent) {
         super();
-        this.name = 'UploadcareNetworkError';
+        this.name = 'NetworkError';
         this.message = 'Network error';
-        Object.setPrototypeOf(this, UploadcareNetworkError.prototype);
+        Object.setPrototypeOf(this, NetworkError.prototype);
         this.originalProgressEvent = progressEvent;
     }
 }
@@ -113,10 +116,11 @@ const onCancel = (signal, callback) => {
     }
 };
 
-class CancelError extends Error {
+class CancelError extends UploadcareError {
     isCancel = true;
     constructor(message = 'Request canceled') {
         super(message);
+        this.name = 'CancelError';
         Object.setPrototypeOf(this, CancelError.prototype);
     }
 }
@@ -249,7 +253,7 @@ const request = ({ method, url, data, headers = {}, signal, onProgress }) => new
         if (aborted)
             return;
         // only triggers if the request couldn't be made at all
-        reject(new UploadcareNetworkError(progressEvent));
+        reject(new NetworkError(progressEvent));
     };
     if (onProgress && typeof onProgress === 'function') {
         xhr.upload.onprogress = (event) => {
@@ -356,21 +360,20 @@ function buildFormData(options) {
     return formData;
 }
 
-class UploadClientError extends Error {
-    isCancel;
+class UploadError extends UploadcareError {
     code;
     request;
     response;
     headers;
     constructor(message, code, request, response, headers) {
         super();
-        this.name = 'UploadClientError';
+        this.name = 'UploadError';
         this.message = message;
         this.code = code;
         this.request = request;
         this.response = response;
         this.headers = headers;
-        Object.setPrototypeOf(this, UploadClientError.prototype);
+        Object.setPrototypeOf(this, UploadError.prototype);
     }
 }
 
@@ -405,7 +408,7 @@ const getUrl = (base, path, query) => {
     return url.toString();
 };
 
-var version = '6.11.1';
+var version = '6.12.0';
 
 const LIBRARY_NAME = 'UploadcareUploadClient';
 const LIBRARY_VERSION = version;
@@ -439,7 +442,7 @@ function retryIfFailed(fn, options) {
             attempt < retryThrottledRequestMaxTimes) {
             return retry(getTimeoutFromThrottledRequest(error));
         }
-        if (error instanceof UploadcareNetworkError &&
+        if (error instanceof NetworkError &&
             attempt < retryNetworkErrorMaxTimes) {
             return retry((attempt + 1) * DEFAULT_NETWORK_ERROR_TIMEOUT);
         }
@@ -507,7 +510,7 @@ function base(file, { publicKey, fileName, contentType, baseURL = defaultSetting
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -544,7 +547,7 @@ function fromUrl(sourceUrl, { publicKey, baseURL = defaultSettings.baseURL, stor
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -584,7 +587,7 @@ function fromUrlStatus(token, { publicKey, baseURL = defaultSettings.baseURL, si
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response && !isErrorResponse(response)) {
-            throw new UploadClientError(response.error.content, undefined, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -612,7 +615,7 @@ function group(uuids, { publicKey, baseURL = defaultSettings.baseURL, jsonpCallb
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -637,7 +640,7 @@ function groupInfo(id, { publicKey, baseURL = defaultSettings.baseURL, signal, s
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -662,7 +665,7 @@ function info(uuid, { publicKey, baseURL = defaultSettings.baseURL, signal, sour
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -694,7 +697,7 @@ function multipartStart(size, { publicKey, contentType, fileName, multipartChunk
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             // convert to array
@@ -749,7 +752,7 @@ function multipartComplete(uuid, { publicKey, baseURL = defaultSettings.baseURL,
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -1074,13 +1077,13 @@ function pollStrategy({ token, publicKey, baseURL, integration, userAgent, retry
         }).then((response) => {
             switch (response.status) {
                 case Status.Error: {
-                    return new UploadClientError(response.error, response.errorCode);
+                    return new UploadError(response.error, response.errorCode);
                 }
                 case Status.Waiting: {
                     return false;
                 }
                 case Status.Unknown: {
-                    return new UploadClientError(`Token "${token}" was not found.`);
+                    return new UploadError(`Token "${token}" was not found.`);
                 }
                 case Status.Progress: {
                     if (onProgress) {
@@ -1151,7 +1154,7 @@ const pushStrategy = ({ token, pusherKey, signal, onProgress }) => new Promise((
             }
             case Status.Error: {
                 destroy();
-                reject(new UploadClientError(result.msg, result.error_code));
+                reject(new UploadError(result.msg, result.error_code));
             }
         }
     });
@@ -1204,7 +1207,7 @@ const uploadFromUrl = (sourceUrl, { publicKey, fileName, baseURL, baseCDN, check
     }
 })
     .then((result) => {
-    if (result instanceof UploadClientError)
+    if (result instanceof UploadError)
         throw result;
     return result;
 })
@@ -1752,9 +1755,19 @@ class Queue {
     }
 }
 
+/* Low-Level API */
+/** @deprecated Please use NetworkError instead. */
+const UploadcareNetworkError = NetworkError;
+/** @deprecated Please use UploadError instead. */
+const UploadClientError = UploadError;
+
+exports.CancelError = CancelError;
+exports.NetworkError = NetworkError;
 exports.Queue = Queue;
 exports.UploadClient = UploadClient;
 exports.UploadClientError = UploadClientError;
+exports.UploadError = UploadError;
+exports.UploadcareError = UploadcareError;
 exports.UploadcareFile = UploadcareFile;
 exports.UploadcareGroup = UploadcareGroup;
 exports.UploadcareNetworkError = UploadcareNetworkError;

package/dist/cjs/index.react-native.d.cts

@@ -19,7 +19,9 @@ export type GetUserAgentOptions = {
 	userAgent?: CustomUserAgent | null;
 };
 export declare function getUserAgent({ libraryName, libraryVersion, userAgent, publicKey, integration }: GetUserAgentOptions): string;
-export declare class UploadcareNetworkError extends Error {
+export declare class UploadcareError extends Error {
+}
+export declare class NetworkError extends UploadcareError {
 	originalProgressEvent: ProgressEvent;
 	constructor(progressEvent: ProgressEvent);
 }
@@ -72,6 +74,10 @@ export type ContentInfo = {
 };
 export type Metadata = Record<string, string>;
 export type StoreValue = "auto" | boolean;
+export declare class CancelError extends UploadcareError {
+	isCancel: boolean;
+	constructor(message?: string);
+}
 export interface DefaultSettings {
 	baseCDN: string;
 	baseURL: string;
@@ -207,6 +213,8 @@ export type FromUrlOptions = {
 };
 /** Uploading files from URL. */
 export function fromUrl(sourceUrl: Url, { publicKey, baseURL, store, fileName, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, source, signal, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata }: FromUrlOptions): Promise<FromUrlSuccessResponse>;
+/** @see https://uploadcare.com/api-refs/upload-api/#tag/Errors */
+export type ServerErrorCode = "AccountBlockedError" | "AccountLimitsExceededError" | "AccountUnpaidError" | "AutostoreDisabledError" | "BaseViewsError" | "FileMetadataKeyDuplicatedError" | "FileMetadataKeyEmptyError" | "FileMetadataKeyForbiddenError" | "FileMetadataKeyLengthTooBigError" | "FileMetadataKeysNumberTooBigError" | "FileMetadataValueEmptyError" | "FileMetadataValueForbiddenError" | "FileMetadataValueLengthTooBigError" | "FileSizeLimitExceededError" | "MethodNotAllowedError" | "NullCharactersForbiddenError" | "PostRequestParserFailedError" | "ProjectPublicKeyInvalidError" | "ProjectPublicKeyRemovedError" | "ProjectPublicKeyRequiredError" | "RequestFileNumberLimitExceededError" | "RequestFiledsNumberLimitExceededError" | "RequestSizeLimitExceededError" | "RequestThrottledError" | "SignatureExpirationError" | "SignatureExpirationInvalidError" | "SignatureExpirationRequiredError" | "SignatureInvalidError" | "SignatureRequiredError" | "UploadAPIError" | "UploadFailedError" | "DownloadFileError" | "DownloadFileHTTPClientError" | "DownloadFileHTTPNetworkError" | "DownloadFileHTTPServerError" | "DownloadFileHTTPURLValidationError" | "DownloadFileInternalServerError" | "DownloadFileNotFoundError" | "DownloadFileSizeLimitExceededError" | "DownloadFileTaskFailedError" | "DownloadFileTimeLimitExceededError" | "DownloadFileValidationFailedError" | "FileIdInvalidError" | "FileIdNotUniqueError" | "FileIdRequiredError" | "FileNotFoundError" | "FileRequiredError" | "FilesNumberLimitExceededError" | "FilesRequiredError" | "InternalRequestForbiddenError" | "InternalRequestInvalidError" | "MultipartFileAlreadyUploadedError" | "MultipartFileCompletionFailedError" | "MultipartFileIdRequiredError" | "MultipartFileNotFoundError" | "MultipartFileSizeLimitExceededError" | "MultipartFileSizeTooSmallError" | "MultipartPartSizeInvalidError" | "MultipartPartSizeTooBigError" | "MultipartPartSizeTooSmallError" | "MultipartSizeInvalidError" | "MultipartUploadSizeTooLargeError" | "MultipartUploadSizeTooSmallError" | "RequestParamRequiredError" | "SourceURLRequiredError" | "TokenRequiredError" | "UUIDInvalidError" | "UploadViewsError" | "UploadcareFileIdDuplicatedError" | "UploadcareFileIdInvalidError" | "UploadcareFileIdRequiredError" | "GroupFileURLParsingFailedError" | "GroupFilesInvalidError" | "GroupFilesNotFoundError" | "GroupIdRequiredError" | "GroupNotFoundError" | "GroupViewsError" | "FileInfectedError" | "FileTypeForbiddenError" | "HostnameNotFoundError" | "URLBlacklistedError" | "URLHostMalformedError" | "URLHostPrivateIPForbiddenError" | "URLHostRequiredError" | "URLParsingFailedError" | "URLRedirectsLimitExceededError" | "URLSchemeInvalidError" | "URLSchemeRequiredError" | "URLValidationError";
 export declare enum Status {
 	Unknown = "unknown",
 	Waiting = "waiting",
@@ -229,7 +237,7 @@ export type StatusProgressResponse = {
 export type StatusErrorResponse = {
 	status: Status.Error;
 	error: string;
-	errorCode: string;
+	errorCode: ServerErrorCode;
 };
 export type StatusSuccessResponse = {
 	status: Status.Success;
@@ -520,16 +528,19 @@ export type ErrorResponseInfo = {
 	error?: {
 		statusCode: number;
 		content: string;
-		errorCode: string;
+		errorCode: ServerErrorCode;
 	};
 };
-export declare class UploadClientError extends Error {
-	isCancel?: boolean;
-	readonly code?: string;
+export declare class UploadError extends UploadcareError {
+	readonly code?: ServerErrorCode;
 	readonly request?: ErrorRequestInfo;
 	readonly response?: ErrorResponseInfo;
 	readonly headers?: Headers;
-	constructor(message: string, code?: string, request?: ErrorRequestInfo, response?: ErrorResponseInfo, headers?: Headers);
+	constructor(message: string, code?: ServerErrorCode, request?: ErrorRequestInfo, response?: ErrorResponseInfo, headers?: Headers);
 }
+/** @deprecated Please use NetworkError instead. */
+export declare const UploadcareNetworkError: typeof NetworkError;
+/** @deprecated Please use UploadError instead. */
+export declare const UploadClientError: typeof UploadError;
 
 export {};

package/dist/esm/index.browser.d.mts

@@ -19,7 +19,9 @@ export type GetUserAgentOptions = {
 	userAgent?: CustomUserAgent | null;
 };
 export declare function getUserAgent({ libraryName, libraryVersion, userAgent, publicKey, integration }: GetUserAgentOptions): string;
-export declare class UploadcareNetworkError extends Error {
+export declare class UploadcareError extends Error {
+}
+export declare class NetworkError extends UploadcareError {
 	originalProgressEvent: ProgressEvent;
 	constructor(progressEvent: ProgressEvent);
 }
@@ -72,6 +74,10 @@ export type ContentInfo = {
 };
 export type Metadata = Record<string, string>;
 export type StoreValue = "auto" | boolean;
+export declare class CancelError extends UploadcareError {
+	isCancel: boolean;
+	constructor(message?: string);
+}
 export interface DefaultSettings {
 	baseCDN: string;
 	baseURL: string;
@@ -207,6 +213,8 @@ export type FromUrlOptions = {
 };
 /** Uploading files from URL. */
 export function fromUrl(sourceUrl: Url, { publicKey, baseURL, store, fileName, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, source, signal, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata }: FromUrlOptions): Promise<FromUrlSuccessResponse>;
+/** @see https://uploadcare.com/api-refs/upload-api/#tag/Errors */
+export type ServerErrorCode = "AccountBlockedError" | "AccountLimitsExceededError" | "AccountUnpaidError" | "AutostoreDisabledError" | "BaseViewsError" | "FileMetadataKeyDuplicatedError" | "FileMetadataKeyEmptyError" | "FileMetadataKeyForbiddenError" | "FileMetadataKeyLengthTooBigError" | "FileMetadataKeysNumberTooBigError" | "FileMetadataValueEmptyError" | "FileMetadataValueForbiddenError" | "FileMetadataValueLengthTooBigError" | "FileSizeLimitExceededError" | "MethodNotAllowedError" | "NullCharactersForbiddenError" | "PostRequestParserFailedError" | "ProjectPublicKeyInvalidError" | "ProjectPublicKeyRemovedError" | "ProjectPublicKeyRequiredError" | "RequestFileNumberLimitExceededError" | "RequestFiledsNumberLimitExceededError" | "RequestSizeLimitExceededError" | "RequestThrottledError" | "SignatureExpirationError" | "SignatureExpirationInvalidError" | "SignatureExpirationRequiredError" | "SignatureInvalidError" | "SignatureRequiredError" | "UploadAPIError" | "UploadFailedError" | "DownloadFileError" | "DownloadFileHTTPClientError" | "DownloadFileHTTPNetworkError" | "DownloadFileHTTPServerError" | "DownloadFileHTTPURLValidationError" | "DownloadFileInternalServerError" | "DownloadFileNotFoundError" | "DownloadFileSizeLimitExceededError" | "DownloadFileTaskFailedError" | "DownloadFileTimeLimitExceededError" | "DownloadFileValidationFailedError" | "FileIdInvalidError" | "FileIdNotUniqueError" | "FileIdRequiredError" | "FileNotFoundError" | "FileRequiredError" | "FilesNumberLimitExceededError" | "FilesRequiredError" | "InternalRequestForbiddenError" | "InternalRequestInvalidError" | "MultipartFileAlreadyUploadedError" | "MultipartFileCompletionFailedError" | "MultipartFileIdRequiredError" | "MultipartFileNotFoundError" | "MultipartFileSizeLimitExceededError" | "MultipartFileSizeTooSmallError" | "MultipartPartSizeInvalidError" | "MultipartPartSizeTooBigError" | "MultipartPartSizeTooSmallError" | "MultipartSizeInvalidError" | "MultipartUploadSizeTooLargeError" | "MultipartUploadSizeTooSmallError" | "RequestParamRequiredError" | "SourceURLRequiredError" | "TokenRequiredError" | "UUIDInvalidError" | "UploadViewsError" | "UploadcareFileIdDuplicatedError" | "UploadcareFileIdInvalidError" | "UploadcareFileIdRequiredError" | "GroupFileURLParsingFailedError" | "GroupFilesInvalidError" | "GroupFilesNotFoundError" | "GroupIdRequiredError" | "GroupNotFoundError" | "GroupViewsError" | "FileInfectedError" | "FileTypeForbiddenError" | "HostnameNotFoundError" | "URLBlacklistedError" | "URLHostMalformedError" | "URLHostPrivateIPForbiddenError" | "URLHostRequiredError" | "URLParsingFailedError" | "URLRedirectsLimitExceededError" | "URLSchemeInvalidError" | "URLSchemeRequiredError" | "URLValidationError";
 export declare enum Status {
 	Unknown = "unknown",
 	Waiting = "waiting",
@@ -229,7 +237,7 @@ export type StatusProgressResponse = {
 export type StatusErrorResponse = {
 	status: Status.Error;
 	error: string;
-	errorCode: string;
+	errorCode: ServerErrorCode;
 };
 export type StatusSuccessResponse = {
 	status: Status.Success;
@@ -520,16 +528,19 @@ export type ErrorResponseInfo = {
 	error?: {
 		statusCode: number;
 		content: string;
-		errorCode: string;
+		errorCode: ServerErrorCode;
 	};
 };
-export declare class UploadClientError extends Error {
-	isCancel?: boolean;
-	readonly code?: string;
+export declare class UploadError extends UploadcareError {
+	readonly code?: ServerErrorCode;
 	readonly request?: ErrorRequestInfo;
 	readonly response?: ErrorResponseInfo;
 	readonly headers?: Headers;
-	constructor(message: string, code?: string, request?: ErrorRequestInfo, response?: ErrorResponseInfo, headers?: Headers);
+	constructor(message: string, code?: ServerErrorCode, request?: ErrorRequestInfo, response?: ErrorResponseInfo, headers?: Headers);
 }
+/** @deprecated Please use NetworkError instead. */
+export declare const UploadcareNetworkError: typeof NetworkError;
+/** @deprecated Please use UploadError instead. */
+export declare const UploadClientError: typeof UploadError;
 
 export {};

package/dist/esm/index.browser.mjs

@@ -89,13 +89,16 @@ function retrier(fn, options = defaultOptions) {
     return runAttempt(fn);
 }
 
-class UploadcareNetworkError extends Error {
+class UploadcareError extends Error {
+}
+
+class NetworkError extends UploadcareError {
     originalProgressEvent;
     constructor(progressEvent) {
         super();
-        this.name = 'UploadcareNetworkError';
+        this.name = 'NetworkError';
         this.message = 'Network error';
-        Object.setPrototypeOf(this, UploadcareNetworkError.prototype);
+        Object.setPrototypeOf(this, NetworkError.prototype);
         this.originalProgressEvent = progressEvent;
     }
 }
@@ -111,10 +114,11 @@ const onCancel = (signal, callback) => {
     }
 };
 
-class CancelError extends Error {
+class CancelError extends UploadcareError {
     isCancel = true;
     constructor(message = 'Request canceled') {
         super(message);
+        this.name = 'CancelError';
         Object.setPrototypeOf(this, CancelError.prototype);
     }
 }
@@ -247,7 +251,7 @@ const request = ({ method, url, data, headers = {}, signal, onProgress }) => new
         if (aborted)
             return;
         // only triggers if the request couldn't be made at all
-        reject(new UploadcareNetworkError(progressEvent));
+        reject(new NetworkError(progressEvent));
     };
     if (onProgress && typeof onProgress === 'function') {
         xhr.upload.onprogress = (event) => {
@@ -346,21 +350,20 @@ function buildFormData(options) {
     return formData;
 }
 
-class UploadClientError extends Error {
-    isCancel;
+class UploadError extends UploadcareError {
     code;
     request;
     response;
     headers;
     constructor(message, code, request, response, headers) {
         super();
-        this.name = 'UploadClientError';
+        this.name = 'UploadError';
         this.message = message;
         this.code = code;
         this.request = request;
         this.response = response;
         this.headers = headers;
-        Object.setPrototypeOf(this, UploadClientError.prototype);
+        Object.setPrototypeOf(this, UploadError.prototype);
     }
 }
 
@@ -395,7 +398,7 @@ const getUrl = (base, path, query) => {
     return url.toString();
 };
 
-var version = '6.11.1';
+var version = '6.12.0';
 
 const LIBRARY_NAME = 'UploadcareUploadClient';
 const LIBRARY_VERSION = version;
@@ -429,7 +432,7 @@ function retryIfFailed(fn, options) {
             attempt < retryThrottledRequestMaxTimes) {
             return retry(getTimeoutFromThrottledRequest(error));
         }
-        if (error instanceof UploadcareNetworkError &&
+        if (error instanceof NetworkError &&
             attempt < retryNetworkErrorMaxTimes) {
             return retry((attempt + 1) * DEFAULT_NETWORK_ERROR_TIMEOUT);
         }
@@ -497,7 +500,7 @@ function base(file, { publicKey, fileName, contentType, baseURL = defaultSetting
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -534,7 +537,7 @@ function fromUrl(sourceUrl, { publicKey, baseURL = defaultSettings.baseURL, stor
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -574,7 +577,7 @@ function fromUrlStatus(token, { publicKey, baseURL = defaultSettings.baseURL, si
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response && !isErrorResponse(response)) {
-            throw new UploadClientError(response.error.content, undefined, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -602,7 +605,7 @@ function group(uuids, { publicKey, baseURL = defaultSettings.baseURL, jsonpCallb
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -627,7 +630,7 @@ function groupInfo(id, { publicKey, baseURL = defaultSettings.baseURL, signal, s
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -652,7 +655,7 @@ function info(uuid, { publicKey, baseURL = defaultSettings.baseURL, signal, sour
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -684,7 +687,7 @@ function multipartStart(size, { publicKey, contentType, fileName, multipartChunk
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             // convert to array
@@ -739,7 +742,7 @@ function multipartComplete(uuid, { publicKey, baseURL = defaultSettings.baseURL,
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
         if ('error' in response) {
-            throw new UploadClientError(response.error.content, response.error.errorCode, request, response, headers);
+            throw new UploadError(response.error.content, response.error.errorCode, request, response, headers);
         }
         else {
             return response;
@@ -1064,13 +1067,13 @@ function pollStrategy({ token, publicKey, baseURL, integration, userAgent, retry
         }).then((response) => {
             switch (response.status) {
                 case Status.Error: {
-                    return new UploadClientError(response.error, response.errorCode);
+                    return new UploadError(response.error, response.errorCode);
                 }
                 case Status.Waiting: {
                     return false;
                 }
                 case Status.Unknown: {
-                    return new UploadClientError(`Token "${token}" was not found.`);
+                    return new UploadError(`Token "${token}" was not found.`);
                 }
                 case Status.Progress: {
                     if (onProgress) {
@@ -1141,7 +1144,7 @@ const pushStrategy = ({ token, pusherKey, signal, onProgress }) => new Promise((
             }
             case Status.Error: {
                 destroy();
-                reject(new UploadClientError(result.msg, result.error_code));
+                reject(new UploadError(result.msg, result.error_code));
             }
         }
     });
@@ -1194,7 +1197,7 @@ const uploadFromUrl = (sourceUrl, { publicKey, fileName, baseURL, baseCDN, check
     }
 })
     .then((result) => {
-    if (result instanceof UploadClientError)
+    if (result instanceof UploadError)
         throw result;
     return result;
 })
@@ -1722,4 +1725,10 @@ class Queue {
     }
 }
 
-export { Queue, UploadClient, UploadClientError, UploadcareFile, UploadcareGroup, UploadcareNetworkError, base, fromUrl, fromUrlStatus, getUserAgent$1 as getUserAgent, group, groupInfo, info, isReadyPoll, multipartComplete, multipartStart, multipartUpload, uploadDirect, uploadFile, uploadFileGroup, uploadFromUploaded, uploadFromUrl, uploadMultipart };
+/* Low-Level API */
+/** @deprecated Please use NetworkError instead. */
+const UploadcareNetworkError = NetworkError;
+/** @deprecated Please use UploadError instead. */
+const UploadClientError = UploadError;
+
+export { CancelError, NetworkError, Queue, UploadClient, UploadClientError, UploadError, UploadcareError, UploadcareFile, UploadcareGroup, UploadcareNetworkError, base, fromUrl, fromUrlStatus, getUserAgent$1 as getUserAgent, group, groupInfo, info, isReadyPoll, multipartComplete, multipartStart, multipartUpload, uploadDirect, uploadFile, uploadFileGroup, uploadFromUploaded, uploadFromUrl, uploadMultipart };

package/dist/esm/index.node.d.mts

@@ -19,7 +19,9 @@ export type GetUserAgentOptions = {
 	userAgent?: CustomUserAgent | null;
 };
 export declare function getUserAgent({ libraryName, libraryVersion, userAgent, publicKey, integration }: GetUserAgentOptions): string;
-export declare class UploadcareNetworkError extends Error {
+export declare class UploadcareError extends Error {
+}
+export declare class NetworkError extends UploadcareError {
 	originalProgressEvent: ProgressEvent;
 	constructor(progressEvent: ProgressEvent);
 }
@@ -72,6 +74,10 @@ export type ContentInfo = {
 };
 export type Metadata = Record<string, string>;
 export type StoreValue = "auto" | boolean;
+export declare class CancelError extends UploadcareError {
+	isCancel: boolean;
+	constructor(message?: string);
+}
 export interface DefaultSettings {
 	baseCDN: string;
 	baseURL: string;
@@ -207,6 +213,8 @@ export type FromUrlOptions = {
 };
 /** Uploading files from URL. */
 export function fromUrl(sourceUrl: Url, { publicKey, baseURL, store, fileName, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, source, signal, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata }: FromUrlOptions): Promise<FromUrlSuccessResponse>;
+/** @see https://uploadcare.com/api-refs/upload-api/#tag/Errors */
+export type ServerErrorCode = "AccountBlockedError" | "AccountLimitsExceededError" | "AccountUnpaidError" | "AutostoreDisabledError" | "BaseViewsError" | "FileMetadataKeyDuplicatedError" | "FileMetadataKeyEmptyError" | "FileMetadataKeyForbiddenError" | "FileMetadataKeyLengthTooBigError" | "FileMetadataKeysNumberTooBigError" | "FileMetadataValueEmptyError" | "FileMetadataValueForbiddenError" | "FileMetadataValueLengthTooBigError" | "FileSizeLimitExceededError" | "MethodNotAllowedError" | "NullCharactersForbiddenError" | "PostRequestParserFailedError" | "ProjectPublicKeyInvalidError" | "ProjectPublicKeyRemovedError" | "ProjectPublicKeyRequiredError" | "RequestFileNumberLimitExceededError" | "RequestFiledsNumberLimitExceededError" | "RequestSizeLimitExceededError" | "RequestThrottledError" | "SignatureExpirationError" | "SignatureExpirationInvalidError" | "SignatureExpirationRequiredError" | "SignatureInvalidError" | "SignatureRequiredError" | "UploadAPIError" | "UploadFailedError" | "DownloadFileError" | "DownloadFileHTTPClientError" | "DownloadFileHTTPNetworkError" | "DownloadFileHTTPServerError" | "DownloadFileHTTPURLValidationError" | "DownloadFileInternalServerError" | "DownloadFileNotFoundError" | "DownloadFileSizeLimitExceededError" | "DownloadFileTaskFailedError" | "DownloadFileTimeLimitExceededError" | "DownloadFileValidationFailedError" | "FileIdInvalidError" | "FileIdNotUniqueError" | "FileIdRequiredError" | "FileNotFoundError" | "FileRequiredError" | "FilesNumberLimitExceededError" | "FilesRequiredError" | "InternalRequestForbiddenError" | "InternalRequestInvalidError" | "MultipartFileAlreadyUploadedError" | "MultipartFileCompletionFailedError" | "MultipartFileIdRequiredError" | "MultipartFileNotFoundError" | "MultipartFileSizeLimitExceededError" | "MultipartFileSizeTooSmallError" | "MultipartPartSizeInvalidError" | "MultipartPartSizeTooBigError" | "MultipartPartSizeTooSmallError" | "MultipartSizeInvalidError" | "MultipartUploadSizeTooLargeError" | "MultipartUploadSizeTooSmallError" | "RequestParamRequiredError" | "SourceURLRequiredError" | "TokenRequiredError" | "UUIDInvalidError" | "UploadViewsError" | "UploadcareFileIdDuplicatedError" | "UploadcareFileIdInvalidError" | "UploadcareFileIdRequiredError" | "GroupFileURLParsingFailedError" | "GroupFilesInvalidError" | "GroupFilesNotFoundError" | "GroupIdRequiredError" | "GroupNotFoundError" | "GroupViewsError" | "FileInfectedError" | "FileTypeForbiddenError" | "HostnameNotFoundError" | "URLBlacklistedError" | "URLHostMalformedError" | "URLHostPrivateIPForbiddenError" | "URLHostRequiredError" | "URLParsingFailedError" | "URLRedirectsLimitExceededError" | "URLSchemeInvalidError" | "URLSchemeRequiredError" | "URLValidationError";
 export declare enum Status {
 	Unknown = "unknown",
 	Waiting = "waiting",
@@ -229,7 +237,7 @@ export type StatusProgressResponse = {
 export type StatusErrorResponse = {
 	status: Status.Error;
 	error: string;
-	errorCode: string;
+	errorCode: ServerErrorCode;
 };
 export type StatusSuccessResponse = {
 	status: Status.Success;
@@ -520,16 +528,19 @@ export type ErrorResponseInfo = {
 	error?: {
 		statusCode: number;
 		content: string;
-		errorCode: string;
+		errorCode: ServerErrorCode;
 	};
 };
-export declare class UploadClientError extends Error {
-	isCancel?: boolean;
-	readonly code?: string;
+export declare class UploadError extends UploadcareError {
+	readonly code?: ServerErrorCode;
 	readonly request?: ErrorRequestInfo;
 	readonly response?: ErrorResponseInfo;
 	readonly headers?: Headers;
-	constructor(message: string, code?: string, request?: ErrorRequestInfo, response?: ErrorResponseInfo, headers?: Headers);
+	constructor(message: string, code?: ServerErrorCode, request?: ErrorRequestInfo, response?: ErrorResponseInfo, headers?: Headers);
 }
+/** @deprecated Please use NetworkError instead. */
+export declare const UploadcareNetworkError: typeof NetworkError;
+/** @deprecated Please use UploadError instead. */
+export declare const UploadClientError: typeof UploadError;
 
 export {};