@uploadcare/upload-client 6.18.3 → 6.19.0-alpha.0

package/README.md

@@ -6,8 +6,7 @@
       alt="">
 </a>
 
-This is an Uploadcare [Upload API][uc-docs-upload-api] wrapper to work with
-Node.js and browser.
+`@uploadcare/upload-client` is a JavaScript and TypeScript SDK for the Uploadcare [Upload API][uc-docs-upload-api]. It handles direct binary uploads, multipart uploads for large files, URL-based and UUID-based uploads, and file group creation. Works in Node.js, browser, and React Native. Supports upload progress tracking, AbortController cancellation, concurrent request queuing, and signed uploads.
 
 [API Reference](https://uploadcare.github.io/uploadcare-js-api-clients/upload-client/)
 

package/dist/cjs/index.browser.cjs

@@ -405,7 +405,7 @@ const getUrl = (base, path, query) => {
     return url.toString();
 };
 
-var version = '6.18.3';
+var version = '6.18.4';
 
 const LIBRARY_NAME = 'UploadcareUploadClient';
 const LIBRARY_VERSION = version;
@@ -480,7 +480,7 @@ function getStoreValue(store) {
  * Performs file uploading request to Uploadcare Upload API. Can be canceled and
  * has progress.
  */
-function base(file, { publicKey, fileName, contentType, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes = defaultSettings.retryNetworkErrorMaxTimes, metadata }) {
+function base(file, { publicKey, fileName, contentType, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes = defaultSettings.retryNetworkErrorMaxTimes, metadata, tags }) {
     return retryIfFailed(() => request({
         method: 'POST',
         url: getUrl(baseURL, '/base/', {
@@ -500,7 +500,8 @@ function base(file, { publicKey, fileName, contentType, baseURL = defaultSetting
             signature: secureSignature,
             expire: secureExpire,
             source: source,
-            metadata
+            metadata,
+            tags: tags && tags.join(',')
         }),
         signal,
         onProgress
@@ -673,7 +674,7 @@ function info(uuid, { publicKey, baseURL = defaultSettings.baseURL, signal, sour
 }
 
 /** Start multipart uploading. */
-function multipartStart(size, { publicKey, contentType, fileName, multipartChunkSize = defaultSettings.multipartChunkSize, baseURL = '', secureSignature, secureExpire, store, signal, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes = defaultSettings.retryNetworkErrorMaxTimes, metadata }) {
+function multipartStart(size, { publicKey, contentType, fileName, multipartChunkSize = defaultSettings.multipartChunkSize, baseURL = '', secureSignature, secureExpire, store, signal, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes = defaultSettings.retryNetworkErrorMaxTimes, metadata, tags }) {
     return retryIfFailed(() => request({
         method: 'POST',
         url: getUrl(baseURL, '/multipart/start/', { jsonerrors: 1 }),
@@ -690,7 +691,8 @@ function multipartStart(size, { publicKey, contentType, fileName, multipartChunk
             signature: secureSignature,
             expire: secureExpire,
             source: source,
-            metadata
+            metadata,
+            tags: tags && tags.join(',')
         }),
         signal
     }).then(({ data, headers, request }) => {
@@ -772,9 +774,9 @@ function isReadyPoll(uuid, { publicKey, baseURL, source, integration, userAgent,
             retryNetworkErrorMaxTimes
         }).then((response) => {
             if (response.isReady) {
+                onProgress && onProgress({ isComputable: true, value: 1 });
                 return response;
             }
-            onProgress && onProgress({ isComputable: true, value: 1 });
             return false;
         }),
         signal
@@ -798,6 +800,7 @@ class UploadcareFile {
     videoInfo;
     contentInfo;
     metadata;
+    tags;
     s3Bucket;
     defaultEffects = null;
     constructor(fileInfo, { baseCDN = defaultSettings.baseCDN, fileName } = {}) {
@@ -818,6 +821,7 @@ class UploadcareFile {
         this.videoInfo = fileInfo.videoInfo;
         this.contentInfo = fileInfo.contentInfo;
         this.metadata = fileInfo.metadata || null;
+        this.tags = fileInfo.tags || null;
         this.s3Bucket = s3Bucket || null;
         this.s3Url = s3Url;
         if (isGroupFileInfo(fileInfo)) {
@@ -826,7 +830,7 @@ class UploadcareFile {
     }
 }
 
-const uploadDirect = (file, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, contentType, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN, metadata }) => {
+const uploadDirect = (file, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, contentType, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN, metadata, tags }) => {
     return base(file, {
         publicKey,
         fileName,
@@ -842,7 +846,8 @@ const uploadDirect = (file, { publicKey, fileName, baseURL, secureSignature, sec
         userAgent,
         retryThrottledRequestMaxTimes,
         retryNetworkErrorMaxTimes,
-        metadata
+        metadata,
+        tags
     })
         .then(({ file }) => {
         return isReadyPoll(file, {
@@ -861,26 +866,17 @@ const uploadDirect = (file, { publicKey, fileName, baseURL, secureSignature, sec
 };
 
 const uploadFromUploaded = (uuid, { publicKey, fileName, baseURL, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN }) => {
-    return info(uuid, {
+    return isReadyPoll(uuid, {
         publicKey,
         baseURL,
         signal,
+        onProgress,
         source,
         integration,
         userAgent,
         retryThrottledRequestMaxTimes,
         retryNetworkErrorMaxTimes
-    })
-        .then((fileInfo) => new UploadcareFile(fileInfo, { baseCDN, fileName }))
-        .then((result) => {
-        // hack for node ¯\_(ツ)_/¯
-        if (onProgress)
-            onProgress({
-                isComputable: true,
-                value: 1
-            });
-        return result;
-    });
+    }).then((fileInfo) => new UploadcareFile(fileInfo, { baseCDN, fileName }));
 };
 
 const race = (fns, { signal } = {}) => {
@@ -1210,15 +1206,20 @@ const uploadFromUrl = (sourceUrl, { publicKey, fileName, baseURL, baseCDN, check
         throw result;
     return result;
 })
-    .then((result) => isReadyPoll(result.uuid, {
-    publicKey,
-    baseURL,
-    integration,
-    userAgent,
-    retryThrottledRequestMaxTimes,
-    onProgress,
-    signal
-}))
+    .then((result) => {
+    if (result.isReady) {
+        return result;
+    }
+    return isReadyPoll(result.uuid, {
+        publicKey,
+        baseURL,
+        integration,
+        userAgent,
+        retryThrottledRequestMaxTimes,
+        onProgress,
+        signal
+    });
+})
     .then((fileInfo) => new UploadcareFile(fileInfo, { baseCDN }));
 
 const memo = new WeakMap();
@@ -1318,7 +1319,7 @@ const uploadPart = (chunk, url, { publicKey, contentType, onProgress, signal, in
     retryThrottledRequestMaxTimes,
     retryNetworkErrorMaxTimes
 });
-const uploadMultipart = async (file, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartChunkSize = defaultSettings.multipartChunkSize, maxConcurrentRequests = defaultSettings.maxConcurrentRequests, baseCDN, metadata }) => {
+const uploadMultipart = async (file, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartChunkSize = defaultSettings.multipartChunkSize, maxConcurrentRequests = defaultSettings.maxConcurrentRequests, baseCDN, metadata, tags }) => {
     const size = fileSize ?? (await getFileSize(file));
     let progressValues;
     const createProgressHandler = (totalChunks, chunkIdx) => {
@@ -1355,6 +1356,7 @@ const uploadMultipart = async (file, { publicKey, fileName, fileSize, baseURL, s
         retryThrottledRequestMaxTimes,
         retryNetworkErrorMaxTimes,
         metadata,
+        tags,
         multipartChunkSize
     })
         .then(async ({ uuid, parts }) => {
@@ -1385,25 +1387,23 @@ const uploadMultipart = async (file, { publicKey, fileName, fileSize, baseURL, s
         if (fileInfo.isReady) {
             return fileInfo;
         }
-        else {
-            return isReadyPoll(fileInfo.uuid, {
-                publicKey,
-                baseURL,
-                source,
-                integration,
-                userAgent,
-                retryThrottledRequestMaxTimes,
-                retryNetworkErrorMaxTimes,
-                onProgress,
-                signal
-            });
-        }
+        return isReadyPoll(fileInfo.uuid, {
+            publicKey,
+            baseURL,
+            source,
+            integration,
+            userAgent,
+            retryThrottledRequestMaxTimes,
+            retryNetworkErrorMaxTimes,
+            onProgress,
+            signal
+        });
     })
         .then((fileInfo) => new UploadcareFile(fileInfo, { baseCDN }));
 };
 
 /** Uploads file from provided data. */
-async function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, maxConcurrentRequests, baseCDN = defaultSettings.baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata }) {
+async function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, maxConcurrentRequests, baseCDN = defaultSettings.baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata, tags }) {
     if (isFileData(data)) {
         const fileSize = await getFileSize(data);
         if (isMultipart(fileSize, multipartMinFileSize)) {
@@ -1426,7 +1426,8 @@ async function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings
                 retryThrottledRequestMaxTimes,
                 retryNetworkErrorMaxTimes,
                 baseCDN,
-                metadata
+                metadata,
+                tags
             });
         }
         return uploadDirect(data, {
@@ -1445,7 +1446,8 @@ async function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings
             retryThrottledRequestMaxTimes,
             retryNetworkErrorMaxTimes,
             baseCDN,
-            metadata
+            metadata,
+            tags
         });
     }
     if (isUrl(data)) {

package/dist/cjs/index.browser.d.cts

@@ -73,6 +73,7 @@ export type ContentInfo = {
 	video?: VideoInfo;
 };
 export type Metadata = Record<string, string>;
+export type Tags = string[];
 export type StoreValue = "auto" | boolean;
 export declare class CancelError extends UploadcareError {
 	isCancel: boolean;
@@ -125,12 +126,13 @@ export type FileInfo = {
 	mimeType: string;
 	isImage: boolean;
 	isStored: boolean;
-	isReady: string;
+	isReady: boolean;
 	imageInfo: ImageInfo | null;
 	videoInfo: VideoInfo | null;
 	contentInfo: ContentInfo | null;
 	s3Bucket?: string;
 	metadata?: Metadata;
+	tags?: Tags;
 };
 export type GroupFileInfo = FileInfo & {
 	defaultEffects: string;
@@ -175,12 +177,13 @@ export type BaseOptions = {
 	retryThrottledRequestMaxTimes?: number;
 	retryNetworkErrorMaxTimes?: number;
 	metadata?: Metadata;
+	tags?: Tags;
 };
 /**
  * Performs file uploading request to Uploadcare Upload API. Can be canceled and
  * has progress.
  */
-export function base(file: SupportedFileInput, { publicKey, fileName, contentType, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata }: BaseOptions): Promise<BaseResponse>;
+export function base(file: SupportedFileInput, { publicKey, fileName, contentType, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata, tags }: BaseOptions): Promise<BaseResponse>;
 export declare enum TypeEnum {
 	Token = "token",
 	FileInfo = "file_info"
@@ -309,6 +312,7 @@ export type MultipartStartOptions = {
 	retryThrottledRequestMaxTimes?: number;
 	retryNetworkErrorMaxTimes?: number;
 	metadata?: Metadata;
+	tags?: Tags;
 };
 export type MultipartPart = string;
 export type MultipartStartResponse = {
@@ -316,7 +320,7 @@ export type MultipartStartResponse = {
 	uuid: Uuid;
 };
 /** Start multipart uploading. */
-export function multipartStart(size: number, { publicKey, contentType, fileName, multipartChunkSize, baseURL, secureSignature, secureExpire, store, signal, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata }: MultipartStartOptions): Promise<MultipartStartResponse>;
+export function multipartStart(size: number, { publicKey, contentType, fileName, multipartChunkSize, baseURL, secureSignature, secureExpire, store, signal, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata, tags }: MultipartStartOptions): Promise<MultipartStartResponse>;
 export type MultipartUploadOptions = {
 	publicKey?: string;
 	contentType?: string;
@@ -357,6 +361,7 @@ export declare class UploadcareFile {
 	readonly videoInfo: VideoInfo | null;
 	readonly contentInfo: ContentInfo | null;
 	readonly metadata: Metadata | null;
+	readonly tags: Tags | null;
 	readonly s3Bucket: string | null;
 	readonly defaultEffects: null | string;
 	constructor(fileInfo: FileInfo | GroupFileInfo, { baseCDN, fileName }?: {
@@ -387,9 +392,10 @@ export type FileFromOptions = {
 	saveUrlForRecurrentUploads?: boolean;
 	pusherKey?: string;
 	metadata?: Metadata;
+	tags?: Tags;
 };
 /** Uploads file from provided data. */
-export declare function uploadFile(data: SupportedFileInput | Url | Uuid, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, maxConcurrentRequests, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata }: FileFromOptions): Promise<UploadcareFile>;
+export declare function uploadFile(data: SupportedFileInput | Url | Uuid, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, maxConcurrentRequests, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata, tags }: FileFromOptions): Promise<UploadcareFile>;
 export type DirectOptions = {
 	publicKey: string;
 	fileName?: string;
@@ -407,8 +413,9 @@ export type DirectOptions = {
 	retryNetworkErrorMaxTimes?: number;
 	baseCDN?: string;
 	metadata?: Metadata;
+	tags?: Tags;
 };
-export declare const uploadDirect: (file: SupportedFileInput, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, contentType, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN, metadata }: DirectOptions) => Promise<UploadcareFile>;
+export declare const uploadDirect: (file: SupportedFileInput, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, contentType, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN, metadata, tags }: DirectOptions) => Promise<UploadcareFile>;
 export type FromUploadedOptions = {
 	publicKey: string;
 	fileName?: string;
@@ -449,8 +456,9 @@ export type MultipartOptions = {
 	maxConcurrentRequests?: number;
 	baseCDN?: string;
 	metadata?: Metadata;
+	tags?: Tags;
 };
-export declare const uploadMultipart: (file: SupportedFileInput, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartChunkSize, maxConcurrentRequests, baseCDN, metadata }: MultipartOptions) => Promise<UploadcareFile>;
+export declare const uploadMultipart: (file: SupportedFileInput, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartChunkSize, maxConcurrentRequests, baseCDN, metadata, tags }: MultipartOptions) => Promise<UploadcareFile>;
 export declare class UploadcareGroup {
 	readonly uuid: GroupId;
 	readonly filesCount: string;

package/dist/cjs/index.node.cjs

@@ -435,7 +435,7 @@ const getUrl = (base, path, query) => {
     return url.toString();
 };
 
-var version = '6.18.3';
+var version = '6.18.4';
 
 const LIBRARY_NAME = 'UploadcareUploadClient';
 const LIBRARY_VERSION = version;
@@ -510,7 +510,7 @@ function getStoreValue(store) {
  * Performs file uploading request to Uploadcare Upload API. Can be canceled and
  * has progress.
  */
-function base(file, { publicKey, fileName, contentType, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes = defaultSettings.retryNetworkErrorMaxTimes, metadata }) {
+function base(file, { publicKey, fileName, contentType, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes = defaultSettings.retryNetworkErrorMaxTimes, metadata, tags }) {
     return retryIfFailed(() => request({
         method: 'POST',
         url: getUrl(baseURL, '/base/', {
@@ -530,7 +530,8 @@ function base(file, { publicKey, fileName, contentType, baseURL = defaultSetting
             signature: secureSignature,
             expire: secureExpire,
             source: source,
-            metadata
+            metadata,
+            tags: tags && tags.join(',')
         }),
         signal,
         onProgress
@@ -703,7 +704,7 @@ function info(uuid, { publicKey, baseURL = defaultSettings.baseURL, signal, sour
 }
 
 /** Start multipart uploading. */
-function multipartStart(size, { publicKey, contentType, fileName, multipartChunkSize = defaultSettings.multipartChunkSize, baseURL = '', secureSignature, secureExpire, store, signal, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes = defaultSettings.retryNetworkErrorMaxTimes, metadata }) {
+function multipartStart(size, { publicKey, contentType, fileName, multipartChunkSize = defaultSettings.multipartChunkSize, baseURL = '', secureSignature, secureExpire, store, signal, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes = defaultSettings.retryNetworkErrorMaxTimes, metadata, tags }) {
     return retryIfFailed(() => request({
         method: 'POST',
         url: getUrl(baseURL, '/multipart/start/', { jsonerrors: 1 }),
@@ -720,7 +721,8 @@ function multipartStart(size, { publicKey, contentType, fileName, multipartChunk
             signature: secureSignature,
             expire: secureExpire,
             source: source,
-            metadata
+            metadata,
+            tags: tags && tags.join(',')
         }),
         signal
     }).then(({ data, headers, request }) => {
@@ -802,9 +804,9 @@ function isReadyPoll(uuid, { publicKey, baseURL, source, integration, userAgent,
             retryNetworkErrorMaxTimes
         }).then((response) => {
             if (response.isReady) {
+                onProgress && onProgress({ isComputable: true, value: 1 });
                 return response;
             }
-            onProgress && onProgress({ isComputable: true, value: 1 });
             return false;
         }),
         signal
@@ -828,6 +830,7 @@ class UploadcareFile {
     videoInfo;
     contentInfo;
     metadata;
+    tags;
     s3Bucket;
     defaultEffects = null;
     constructor(fileInfo, { baseCDN = defaultSettings.baseCDN, fileName } = {}) {
@@ -848,6 +851,7 @@ class UploadcareFile {
         this.videoInfo = fileInfo.videoInfo;
         this.contentInfo = fileInfo.contentInfo;
         this.metadata = fileInfo.metadata || null;
+        this.tags = fileInfo.tags || null;
         this.s3Bucket = s3Bucket || null;
         this.s3Url = s3Url;
         if (isGroupFileInfo(fileInfo)) {
@@ -856,7 +860,7 @@ class UploadcareFile {
     }
 }
 
-const uploadDirect = (file, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, contentType, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN, metadata }) => {
+const uploadDirect = (file, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, contentType, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN, metadata, tags }) => {
     return base(file, {
         publicKey,
         fileName,
@@ -872,7 +876,8 @@ const uploadDirect = (file, { publicKey, fileName, baseURL, secureSignature, sec
         userAgent,
         retryThrottledRequestMaxTimes,
         retryNetworkErrorMaxTimes,
-        metadata
+        metadata,
+        tags
     })
         .then(({ file }) => {
         return isReadyPoll(file, {
@@ -891,26 +896,17 @@ const uploadDirect = (file, { publicKey, fileName, baseURL, secureSignature, sec
 };
 
 const uploadFromUploaded = (uuid, { publicKey, fileName, baseURL, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN }) => {
-    return info(uuid, {
+    return isReadyPoll(uuid, {
         publicKey,
         baseURL,
         signal,
+        onProgress,
         source,
         integration,
         userAgent,
         retryThrottledRequestMaxTimes,
         retryNetworkErrorMaxTimes
-    })
-        .then((fileInfo) => new UploadcareFile(fileInfo, { baseCDN, fileName }))
-        .then((result) => {
-        // hack for node ¯\_(ツ)_/¯
-        if (onProgress)
-            onProgress({
-                isComputable: true,
-                value: 1
-            });
-        return result;
-    });
+    }).then((fileInfo) => new UploadcareFile(fileInfo, { baseCDN, fileName }));
 };
 
 const race = (fns, { signal } = {}) => {
@@ -1238,15 +1234,20 @@ const uploadFromUrl = (sourceUrl, { publicKey, fileName, baseURL, baseCDN, check
         throw result;
     return result;
 })
-    .then((result) => isReadyPoll(result.uuid, {
-    publicKey,
-    baseURL,
-    integration,
-    userAgent,
-    retryThrottledRequestMaxTimes,
-    onProgress,
-    signal
-}))
+    .then((result) => {
+    if (result.isReady) {
+        return result;
+    }
+    return isReadyPoll(result.uuid, {
+        publicKey,
+        baseURL,
+        integration,
+        userAgent,
+        retryThrottledRequestMaxTimes,
+        onProgress,
+        signal
+    });
+})
     .then((fileInfo) => new UploadcareFile(fileInfo, { baseCDN }));
 
 const memo = new WeakMap();
@@ -1349,7 +1350,7 @@ const uploadPart = (chunk, url, { publicKey, contentType, onProgress, signal, in
     retryThrottledRequestMaxTimes,
     retryNetworkErrorMaxTimes
 });
-const uploadMultipart = async (file, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartChunkSize = defaultSettings.multipartChunkSize, maxConcurrentRequests = defaultSettings.maxConcurrentRequests, baseCDN, metadata }) => {
+const uploadMultipart = async (file, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartChunkSize = defaultSettings.multipartChunkSize, maxConcurrentRequests = defaultSettings.maxConcurrentRequests, baseCDN, metadata, tags }) => {
     const size = fileSize ?? (await getFileSize(file));
     let progressValues;
     const createProgressHandler = (totalChunks, chunkIdx) => {
@@ -1386,6 +1387,7 @@ const uploadMultipart = async (file, { publicKey, fileName, fileSize, baseURL, s
         retryThrottledRequestMaxTimes,
         retryNetworkErrorMaxTimes,
         metadata,
+        tags,
         multipartChunkSize
     })
         .then(async ({ uuid, parts }) => {
@@ -1416,25 +1418,23 @@ const uploadMultipart = async (file, { publicKey, fileName, fileSize, baseURL, s
         if (fileInfo.isReady) {
             return fileInfo;
         }
-        else {
-            return isReadyPoll(fileInfo.uuid, {
-                publicKey,
-                baseURL,
-                source,
-                integration,
-                userAgent,
-                retryThrottledRequestMaxTimes,
-                retryNetworkErrorMaxTimes,
-                onProgress,
-                signal
-            });
-        }
+        return isReadyPoll(fileInfo.uuid, {
+            publicKey,
+            baseURL,
+            source,
+            integration,
+            userAgent,
+            retryThrottledRequestMaxTimes,
+            retryNetworkErrorMaxTimes,
+            onProgress,
+            signal
+        });
     })
         .then((fileInfo) => new UploadcareFile(fileInfo, { baseCDN }));
 };
 
 /** Uploads file from provided data. */
-async function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, maxConcurrentRequests, baseCDN = defaultSettings.baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata }) {
+async function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, maxConcurrentRequests, baseCDN = defaultSettings.baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata, tags }) {
     if (isFileData(data)) {
         const fileSize = await getFileSize(data);
         if (isMultipart(fileSize, multipartMinFileSize)) {
@@ -1457,7 +1457,8 @@ async function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings
                 retryThrottledRequestMaxTimes,
                 retryNetworkErrorMaxTimes,
                 baseCDN,
-                metadata
+                metadata,
+                tags
             });
         }
         return uploadDirect(data, {
@@ -1476,7 +1477,8 @@ async function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings
             retryThrottledRequestMaxTimes,
             retryNetworkErrorMaxTimes,
             baseCDN,
-            metadata
+            metadata,
+            tags
         });
     }
     if (isUrl(data)) {

package/dist/cjs/index.node.d.cts

@@ -73,6 +73,7 @@ export type ContentInfo = {
 	video?: VideoInfo;
 };
 export type Metadata = Record<string, string>;
+export type Tags = string[];
 export type StoreValue = "auto" | boolean;
 export declare class CancelError extends UploadcareError {
 	isCancel: boolean;
@@ -125,12 +126,13 @@ export type FileInfo = {
 	mimeType: string;
 	isImage: boolean;
 	isStored: boolean;
-	isReady: string;
+	isReady: boolean;
 	imageInfo: ImageInfo | null;
 	videoInfo: VideoInfo | null;
 	contentInfo: ContentInfo | null;
 	s3Bucket?: string;
 	metadata?: Metadata;
+	tags?: Tags;
 };
 export type GroupFileInfo = FileInfo & {
 	defaultEffects: string;
@@ -175,12 +177,13 @@ export type BaseOptions = {
 	retryThrottledRequestMaxTimes?: number;
 	retryNetworkErrorMaxTimes?: number;
 	metadata?: Metadata;
+	tags?: Tags;
 };
 /**
  * Performs file uploading request to Uploadcare Upload API. Can be canceled and
  * has progress.
  */
-export function base(file: SupportedFileInput, { publicKey, fileName, contentType, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata }: BaseOptions): Promise<BaseResponse>;
+export function base(file: SupportedFileInput, { publicKey, fileName, contentType, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata, tags }: BaseOptions): Promise<BaseResponse>;
 export declare enum TypeEnum {
 	Token = "token",
 	FileInfo = "file_info"
@@ -309,6 +312,7 @@ export type MultipartStartOptions = {
 	retryThrottledRequestMaxTimes?: number;
 	retryNetworkErrorMaxTimes?: number;
 	metadata?: Metadata;
+	tags?: Tags;
 };
 export type MultipartPart = string;
 export type MultipartStartResponse = {
@@ -316,7 +320,7 @@ export type MultipartStartResponse = {
 	uuid: Uuid;
 };
 /** Start multipart uploading. */
-export function multipartStart(size: number, { publicKey, contentType, fileName, multipartChunkSize, baseURL, secureSignature, secureExpire, store, signal, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata }: MultipartStartOptions): Promise<MultipartStartResponse>;
+export function multipartStart(size: number, { publicKey, contentType, fileName, multipartChunkSize, baseURL, secureSignature, secureExpire, store, signal, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, metadata, tags }: MultipartStartOptions): Promise<MultipartStartResponse>;
 export type MultipartUploadOptions = {
 	publicKey?: string;
 	contentType?: string;
@@ -357,6 +361,7 @@ export declare class UploadcareFile {
 	readonly videoInfo: VideoInfo | null;
 	readonly contentInfo: ContentInfo | null;
 	readonly metadata: Metadata | null;
+	readonly tags: Tags | null;
 	readonly s3Bucket: string | null;
 	readonly defaultEffects: null | string;
 	constructor(fileInfo: FileInfo | GroupFileInfo, { baseCDN, fileName }?: {
@@ -387,9 +392,10 @@ export type FileFromOptions = {
 	saveUrlForRecurrentUploads?: boolean;
 	pusherKey?: string;
 	metadata?: Metadata;
+	tags?: Tags;
 };
 /** Uploads file from provided data. */
-export declare function uploadFile(data: SupportedFileInput | Url | Uuid, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, maxConcurrentRequests, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata }: FileFromOptions): Promise<UploadcareFile>;
+export declare function uploadFile(data: SupportedFileInput | Url | Uuid, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, maxConcurrentRequests, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata, tags }: FileFromOptions): Promise<UploadcareFile>;
 export type DirectOptions = {
 	publicKey: string;
 	fileName?: string;
@@ -407,8 +413,9 @@ export type DirectOptions = {
 	retryNetworkErrorMaxTimes?: number;
 	baseCDN?: string;
 	metadata?: Metadata;
+	tags?: Tags;
 };
-export declare const uploadDirect: (file: SupportedFileInput, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, contentType, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN, metadata }: DirectOptions) => Promise<UploadcareFile>;
+export declare const uploadDirect: (file: SupportedFileInput, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, contentType, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, baseCDN, metadata, tags }: DirectOptions) => Promise<UploadcareFile>;
 export type FromUploadedOptions = {
 	publicKey: string;
 	fileName?: string;
@@ -449,8 +456,9 @@ export type MultipartOptions = {
 	maxConcurrentRequests?: number;
 	baseCDN?: string;
 	metadata?: Metadata;
+	tags?: Tags;
 };
-export declare const uploadMultipart: (file: SupportedFileInput, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartChunkSize, maxConcurrentRequests, baseCDN, metadata }: MultipartOptions) => Promise<UploadcareFile>;
+export declare const uploadMultipart: (file: SupportedFileInput, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, retryNetworkErrorMaxTimes, contentType, multipartChunkSize, maxConcurrentRequests, baseCDN, metadata, tags }: MultipartOptions) => Promise<UploadcareFile>;
 export declare class UploadcareGroup {
 	readonly uuid: GroupId;
 	readonly filesCount: string;