@uploadcare/upload-client 3.0.0-alpha.0 → 3.1.1

package/dist/index.js

@@ -147,31 +147,97 @@ function identity(obj) {
 const transformFile = identity;
 var getFormData = () => new NodeFormData();
 
-const isFileTuple = (tuple) => tuple[0] === 'file';
-function buildFormData(body) {
-    const formData = getFormData();
-    for (const tuple of body) {
-        if (Array.isArray(tuple[1])) {
-            // refactor this
-            tuple[1].forEach((val) => val && formData.append(tuple[0] + '[]', `${val}`));
-        }
-        else if (isFileTuple(tuple)) {
-            const name = tuple[2];
-            const file = transformFile(tuple[1]); // lgtm[js/superfluous-trailing-arguments]
-            formData.append(tuple[0], file, name);
-        }
-        else if (tuple[1] != null) {
-            formData.append(tuple[0], `${tuple[1]}`);
+/**
+ * FileData type guard.
+ */
+const isFileData = (data) => {
+    return (data !== undefined &&
+        ((typeof Blob !== 'undefined' && data instanceof Blob) ||
+            (typeof File !== 'undefined' && data instanceof File) ||
+            (typeof Buffer !== 'undefined' && data instanceof Buffer)));
+};
+/**
+ * Uuid type guard.
+ */
+const isUuid = (data) => {
+    const UUID_REGEX = '[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}';
+    const regExp = new RegExp(UUID_REGEX);
+    return !isFileData(data) && regExp.test(data);
+};
+/**
+ * Url type guard.
+ *
+ * @param {NodeFile | BrowserFile | Url | Uuid} data
+ */
+const isUrl = (data) => {
+    const URL_REGEX = '^(?:\\w+:)?\\/\\/([^\\s\\.]+\\.\\S{2}|localhost[\\:?\\d]*)\\S*$';
+    const regExp = new RegExp(URL_REGEX);
+    return !isFileData(data) && regExp.test(data);
+};
+
+const isSimpleValue = (value) => {
+    return (typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'undefined');
+};
+const isObjectValue = (value) => {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+};
+const isFileValue = (value) => !!value &&
+    typeof value === 'object' &&
+    'data' in value &&
+    isFileData(value.data);
+function collectParams(params, inputKey, inputValue) {
+    if (isFileValue(inputValue)) {
+        const name = inputValue.name;
+        const file = transformFile(inputValue.data); // lgtm [js/superfluous-trailing-arguments]
+        params.push(name ? [inputKey, file, name] : [inputKey, file]);
+    }
+    else if (isObjectValue(inputValue)) {
+        for (const [key, value] of Object.entries(inputValue)) {
+            if (typeof value !== 'undefined') {
+                params.push([`${inputKey}[${key}]`, String(value)]);
+            }
         }
     }
+    else if (isSimpleValue(inputValue) && inputValue) {
+        params.push([inputKey, inputValue.toString()]);
+    }
+}
+function getFormDataParams(options) {
+    const params = [];
+    for (const [key, value] of Object.entries(options)) {
+        collectParams(params, key, value);
+    }
+    return params;
+}
+function buildFormData(options) {
+    const formData = getFormData();
+    const params = getFormDataParams(options);
+    for (const param of params) {
+        formData.append(...param);
+    }
     return formData;
 }
 
 const serializePair = (key, value) => typeof value !== 'undefined' ? `${key}=${encodeURIComponent(value)}` : null;
+// TODO: generalize value transforming logic and use it here and inside `buildFormData`
 const createQuery = (query) => Object.entries(query)
-    .reduce((params, [key, value]) => params.concat(Array.isArray(value)
-    ? value.map((value) => serializePair(`${key}[]`, value))
-    : serializePair(key, value)), [])
+    .reduce((params, [key, value]) => {
+    let param;
+    if (typeof value === 'object' && !Array.isArray(value)) {
+        param = Object.entries(value)
+            .filter((entry) => typeof entry[1] !== 'undefined')
+            .map((entry) => serializePair(`${key}[${entry[0]}]`, String(entry[1])));
+    }
+    else if (Array.isArray(value)) {
+        param = value.map((val) => serializePair(`${key}[]`, val));
+    }
+    else {
+        param = serializePair(key, value);
+    }
+    return params.concat(param);
+}, [])
     .filter((x) => !!x)
     .join('&');
 const getUrl = (base, path, query) => [
@@ -203,7 +269,7 @@ const defaultSettings = {
 const defaultContentType = 'application/octet-stream';
 const defaultFilename = 'original';
 
-var version = '3.0.0-alpha.0';
+var version = '3.1.1';
 
 /**
  * Returns User Agent based on version and settings.
@@ -303,11 +369,15 @@ function retryIfThrottled(fn, retryThrottledMaxTimes) {
     }));
 }
 
+function getStoreValue(store) {
+    return typeof store === 'undefined' ? 'auto' : store ? '1' : '0';
+}
+
 /**
  * Performs file uploading request to Uploadcare Upload API.
  * Can be canceled and has progress.
  */
-function base(file, { publicKey, fileName, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes }) {
+function base(file, { publicKey, fileName, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, metadata }) {
     return retryIfThrottled(() => {
         var _a;
         return request({
@@ -318,17 +388,18 @@ function base(file, { publicKey, fileName, baseURL = defaultSettings.baseURL, se
             headers: {
                 'X-UC-User-Agent': getUserAgent({ publicKey, integration, userAgent })
             },
-            data: buildFormData([
-                ['file', file, (_a = fileName !== null && fileName !== void 0 ? fileName : file.name) !== null && _a !== void 0 ? _a : defaultFilename],
-                ['UPLOADCARE_PUB_KEY', publicKey],
-                [
-                    'UPLOADCARE_STORE',
-                    typeof store === 'undefined' ? 'auto' : store ? 1 : 0
-                ],
-                ['signature', secureSignature],
-                ['expire', secureExpire],
-                ['source', source]
-            ]),
+            data: buildFormData({
+                file: {
+                    data: file,
+                    name: (_a = fileName !== null && fileName !== void 0 ? fileName : file.name) !== null && _a !== void 0 ? _a : defaultFilename
+                },
+                UPLOADCARE_PUB_KEY: publicKey,
+                UPLOADCARE_STORE: getStoreValue(store),
+                signature: secureSignature,
+                expire: secureExpire,
+                source: source,
+                metadata
+            }),
             signal,
             onProgress
         }).then(({ data, headers, request }) => {
@@ -351,7 +422,7 @@ var TypeEnum;
 /**
  * Uploading files from URL.
  */
-function fromUrl(sourceUrl, { publicKey, baseURL = defaultSettings.baseURL, store, fileName, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, source = 'url', signal, integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes }) {
+function fromUrl(sourceUrl, { publicKey, baseURL = defaultSettings.baseURL, store, fileName, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, source = 'url', signal, integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, metadata }) {
     return retryIfThrottled(() => request({
         method: 'POST',
         headers: {
@@ -361,13 +432,14 @@ function fromUrl(sourceUrl, { publicKey, baseURL = defaultSettings.baseURL, stor
             jsonerrors: 1,
             pub_key: publicKey,
             source_url: sourceUrl,
-            store: typeof store === 'undefined' ? 'auto' : store ? 1 : undefined,
+            store: getStoreValue(store),
             filename: fileName,
             check_URL_duplicates: checkForUrlDuplicates ? 1 : undefined,
             save_URL_duplicates: saveUrlForRecurrentUploads ? 1 : undefined,
             signature: secureSignature,
             expire: secureExpire,
-            source: source
+            source: source,
+            metadata
         }),
         signal
     }).then(({ data, headers, request }) => {
@@ -510,24 +582,25 @@ 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 }) {
+function multipartStart(size, { publicKey, contentType, fileName, multipartChunkSize = defaultSettings.multipartChunkSize, baseURL = '', secureSignature, secureExpire, store, signal, source = 'local', integration, userAgent, retryThrottledRequestMaxTimes = defaultSettings.retryThrottledRequestMaxTimes, metadata }) {
     return retryIfThrottled(() => request({
         method: 'POST',
         url: getUrl(baseURL, '/multipart/start/', { jsonerrors: 1 }),
         headers: {
             'X-UC-User-Agent': getUserAgent({ publicKey, integration, userAgent })
         },
-        data: buildFormData([
-            ['filename', fileName !== null && fileName !== void 0 ? fileName : defaultFilename],
-            ['size', size],
-            ['content_type', contentType !== null && contentType !== void 0 ? contentType : defaultContentType],
-            ['part_size', multipartChunkSize],
-            ['UPLOADCARE_STORE', store ? '' : 'auto'],
-            ['UPLOADCARE_PUB_KEY', publicKey],
-            ['signature', secureSignature],
-            ['expire', secureExpire],
-            ['source', source]
-        ]),
+        data: buildFormData({
+            filename: fileName !== null && fileName !== void 0 ? fileName : defaultFilename,
+            size: size,
+            content_type: contentType !== null && contentType !== void 0 ? contentType : defaultContentType,
+            part_size: multipartChunkSize,
+            UPLOADCARE_STORE: getStoreValue(store),
+            UPLOADCARE_PUB_KEY: publicKey,
+            signature: secureSignature,
+            expire: secureExpire,
+            source: source,
+            metadata
+        }),
         signal
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
@@ -576,11 +649,11 @@ function multipartComplete(uuid, { publicKey, baseURL = defaultSettings.baseURL,
         headers: {
             'X-UC-User-Agent': getUserAgent({ publicKey, integration, userAgent })
         },
-        data: buildFormData([
-            ['uuid', uuid],
-            ['UPLOADCARE_PUB_KEY', publicKey],
-            ['source', source]
-        ]),
+        data: buildFormData({
+            uuid: uuid,
+            UPLOADCARE_PUB_KEY: publicKey,
+            source: source
+        }),
         signal
     }).then(({ data, headers, request }) => {
         const response = camelizeKeys(JSON.parse(data));
@@ -606,6 +679,8 @@ class UploadcareFile {
         this.originalFilename = null;
         this.imageInfo = null;
         this.videoInfo = null;
+        this.contentInfo = null;
+        this.metadata = null;
         const { uuid, s3Bucket } = fileInfo;
         const urlBase = s3Bucket
             ? `https://${s3Bucket}.s3.amazonaws.com/${uuid}/${fileInfo.filename}`
@@ -625,6 +700,8 @@ class UploadcareFile {
         this.originalFilename = fileInfo.originalFilename;
         this.imageInfo = camelizeKeys(fileInfo.imageInfo);
         this.videoInfo = camelizeKeys(fileInfo.videoInfo);
+        this.contentInfo = camelizeKeys(fileInfo.contentInfo);
+        this.metadata = fileInfo.metadata || null;
     }
 }
 
@@ -676,7 +753,7 @@ function isReadyPoll({ file, publicKey, baseURL, source, integration, userAgent,
     });
 }
 
-const uploadFromObject = (file, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, baseCDN }) => {
+const uploadFromObject = (file, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, baseCDN, metadata }) => {
     return base(file, {
         publicKey,
         fileName,
@@ -689,7 +766,8 @@ const uploadFromObject = (file, { publicKey, fileName, baseURL, secureSignature,
         source,
         integration,
         userAgent,
-        retryThrottledRequestMaxTimes
+        retryThrottledRequestMaxTimes,
+        metadata
     })
         .then(({ file }) => {
         return isReadyPoll({
@@ -982,7 +1060,7 @@ const pushStrategy = ({ token, pusherKey, signal, onProgress }) => new Promise((
         }
     });
 });
-const uploadFromUrl = (sourceUrl, { publicKey, fileName, baseURL, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, pusherKey = defaultSettings.pusherKey }) => Promise.resolve(preconnect(pusherKey))
+const uploadFromUrl = (sourceUrl, { publicKey, fileName, baseURL, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, pusherKey = defaultSettings.pusherKey, metadata }) => Promise.resolve(preconnect(pusherKey))
     .then(() => fromUrl(sourceUrl, {
     publicKey,
     fileName,
@@ -996,7 +1074,8 @@ const uploadFromUrl = (sourceUrl, { publicKey, fileName, baseURL, baseCDN, check
     source,
     integration,
     userAgent,
-    retryThrottledRequestMaxTimes
+    retryThrottledRequestMaxTimes,
+    metadata
 }))
     .catch((error) => {
     const pusher = getPusher(pusherKey);
@@ -1067,34 +1146,6 @@ const uploadFromUploaded = (uuid, { publicKey, fileName, baseURL, signal, onProg
     });
 };
 
-/**
- * FileData type guard.
- */
-const isFileData = (data) => {
-    return (data !== undefined &&
-        ((typeof Blob !== 'undefined' && data instanceof Blob) ||
-            (typeof File !== 'undefined' && data instanceof File) ||
-            (typeof Buffer !== 'undefined' && data instanceof Buffer)));
-};
-/**
- * Uuid type guard.
- */
-const isUuid = (data) => {
-    const UUID_REGEX = '[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}';
-    const regExp = new RegExp(UUID_REGEX);
-    return !isFileData(data) && regExp.test(data);
-};
-/**
- * Url type guard.
- *
- * @param {NodeFile | BrowserFile | Url | Uuid} data
- */
-const isUrl = (data) => {
-    const URL_REGEX = '^(?:\\w+:)?\\/\\/([^\\s\\.]+\\.\\S{2}|localhost[\\:?\\d]*)\\S*$';
-    const regExp = new RegExp(URL_REGEX);
-    return !isFileData(data) && regExp.test(data);
-};
-
 /**
  * Get file size.
  */
@@ -1164,7 +1215,7 @@ const uploadPartWithRetry = (chunk, url, { publicKey, onProgress, signal, integr
     }
     throw error;
 }));
-const uploadMultipart = (file, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, contentType, multipartChunkSize = defaultSettings.multipartChunkSize, maxConcurrentRequests = defaultSettings.maxConcurrentRequests, multipartMaxAttempts = defaultSettings.multipartMaxAttempts, baseCDN }) => {
+const uploadMultipart = (file, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, contentType, multipartChunkSize = defaultSettings.multipartChunkSize, maxConcurrentRequests = defaultSettings.maxConcurrentRequests, multipartMaxAttempts = defaultSettings.multipartMaxAttempts, baseCDN, metadata }) => {
     const size = fileSize || getFileSize(file);
     let progressValues;
     const createProgressHandler = (totalChunks, chunkIdx) => {
@@ -1197,7 +1248,8 @@ const uploadMultipart = (file, { publicKey, fileName, fileSize, baseURL, secureS
         source,
         integration,
         userAgent,
-        retryThrottledRequestMaxTimes
+        retryThrottledRequestMaxTimes,
+        metadata
     })
         .then(({ uuid, parts }) => {
         const getChunk = prepareChunks(file, size, multipartChunkSize);
@@ -1244,10 +1296,10 @@ const uploadMultipart = (file, { publicKey, fileName, fileSize, baseURL, secureS
 /**
  * Uploads file from provided data.
  */
-function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, contentType, multipartChunkSize, multipartMaxAttempts, maxConcurrentRequests, baseCDN = defaultSettings.baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey }) {
+function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings.baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, multipartMaxAttempts, maxConcurrentRequests, baseCDN = defaultSettings.baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata }) {
     if (isFileData(data)) {
         const fileSize = getFileSize(data);
-        if (isMultipart(fileSize)) {
+        if (isMultipart(fileSize, multipartMinFileSize)) {
             return uploadMultipart(data, {
                 publicKey,
                 contentType,
@@ -1265,7 +1317,8 @@ function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings.baseU
                 userAgent,
                 maxConcurrentRequests,
                 retryThrottledRequestMaxTimes,
-                baseCDN
+                baseCDN,
+                metadata
             });
         }
         return uploadFromObject(data, {
@@ -1281,7 +1334,8 @@ function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings.baseU
             integration,
             userAgent,
             retryThrottledRequestMaxTimes,
-            baseCDN
+            baseCDN,
+            metadata
         });
     }
     if (isUrl(data)) {
@@ -1301,7 +1355,8 @@ function uploadFile(data, { publicKey, fileName, baseURL = defaultSettings.baseU
             integration,
             userAgent,
             retryThrottledRequestMaxTimes,
-            pusherKey
+            pusherKey,
+            metadata
         });
     }
     if (isUuid(data)) {

package/dist/types.d.ts

@@ -41,6 +41,17 @@ export declare type VideoInfo = {
 		codec: string;
 	};
 };
+export declare type ContentInfo = {
+	content_info: {
+		mime?: {
+			mime: string;
+			type: string;
+			subtype: string;
+		};
+		image?: ImageInfo;
+		video?: VideoInfo;
+	};
+};
 export declare type FileInfo = {
 	size: number;
 	done: number;
@@ -55,7 +66,9 @@ export declare type FileInfo = {
 	isReady: string;
 	imageInfo: ImageInfo | null;
 	videoInfo: VideoInfo | null;
-	s3Bucket: string | null;
+	contentInfo: ContentInfo | null;
+	s3Bucket?: string;
+	metadata?: Metadata;
 };
 export declare type GroupInfo = {
 	datetimeCreated: string;
@@ -78,6 +91,9 @@ export declare type UnknownProgressInfo = {
 	isComputable: false;
 };
 export declare type ProgressCallback<T = ComputableProgressInfo | UnknownProgressInfo> = (arg: T) => void;
+export declare type Metadata = {
+	[key: string]: string;
+};
 export interface DefaultSettings {
 	baseCDN: string;
 	baseURL: string;
@@ -142,8 +158,9 @@ export declare type BaseOptions = {
 	integration?: string;
 	userAgent?: CustomUserAgent;
 	retryThrottledRequestMaxTimes?: number;
+	metadata?: Metadata;
 };
-declare function base(file: NodeFile | BrowserFile, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes }: BaseOptions): Promise<BaseResponse>;
+declare function base(file: NodeFile | BrowserFile, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, metadata }: BaseOptions): Promise<BaseResponse>;
 declare enum TypeEnum {
 	Token = "token",
 	FileInfo = "file_info"
@@ -171,8 +188,9 @@ export declare type FromUrlOptions = {
 	integration?: string;
 	userAgent?: CustomUserAgent;
 	retryThrottledRequestMaxTimes?: number;
+	metadata?: Metadata;
 };
-declare function fromUrl(sourceUrl: Url, { publicKey, baseURL, store, fileName, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, source, signal, integration, userAgent, retryThrottledRequestMaxTimes }: FromUrlOptions): Promise<FromUrlSuccessResponse>;
+declare function fromUrl(sourceUrl: Url, { publicKey, baseURL, store, fileName, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, source, signal, integration, userAgent, retryThrottledRequestMaxTimes, metadata }: FromUrlOptions): Promise<FromUrlSuccessResponse>;
 declare enum Status {
 	Unknown = "unknown",
 	Waiting = "waiting",
@@ -257,13 +275,14 @@ export declare type MultipartStartOptions = {
 	integration?: string;
 	userAgent?: CustomUserAgent;
 	retryThrottledRequestMaxTimes?: number;
+	metadata?: Metadata;
 };
 export declare type MultipartPart = string;
 export declare type MultipartStartResponse = {
 	parts: MultipartPart[];
 	uuid: Uuid;
 };
-declare function multipartStart(size: number, { publicKey, contentType, fileName, multipartChunkSize, baseURL, secureSignature, secureExpire, store, signal, source, integration, userAgent, retryThrottledRequestMaxTimes }: MultipartStartOptions): Promise<MultipartStartResponse>;
+declare function multipartStart(size: number, { publicKey, contentType, fileName, multipartChunkSize, baseURL, secureSignature, secureExpire, store, signal, source, integration, userAgent, retryThrottledRequestMaxTimes, metadata }: MultipartStartOptions): Promise<MultipartStartResponse>;
 export declare type MultipartUploadOptions = {
 	publicKey?: string;
 	signal?: AbortSignal;
@@ -298,6 +317,8 @@ export declare class UploadcareFile {
 	readonly originalFilename: null | string;
 	readonly imageInfo: null | ImageInfo;
 	readonly videoInfo: null | VideoInfo;
+	readonly contentInfo: null | ContentInfo;
+	readonly metadata: null | Metadata;
 	constructor(fileInfo: FileInfo, { baseCDN, defaultEffects, fileName }: {
 		baseCDN?: string;
 		defaultEffects?: string;
@@ -318,14 +339,15 @@ export declare type FromObjectOptions = {
 	userAgent?: CustomUserAgent;
 	retryThrottledRequestMaxTimes?: number;
 	baseCDN?: string;
+	metadata?: Metadata;
 };
-declare const uploadFromObject: (file: NodeFile | BrowserFile, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, baseCDN }: FromObjectOptions) => Promise<UploadcareFile>;
+declare const uploadFromObject: (file: NodeFile | BrowserFile, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, baseCDN, metadata }: FromObjectOptions) => Promise<UploadcareFile>;
 export declare type UploadFromUrlOptions = {
 	baseCDN?: string;
 	onProgress?: ProgressCallback;
 	pusherKey?: string;
 } & FromUrlOptions;
-export declare const uploadFromUrl: (sourceUrl: string, { publicKey, fileName, baseURL, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, pusherKey }: UploadFromUrlOptions) => Promise<UploadcareFile>;
+export declare const uploadFromUrl: (sourceUrl: string, { publicKey, fileName, baseURL, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, pusherKey, metadata }: UploadFromUrlOptions) => Promise<UploadcareFile>;
 export declare type FromUploadedOptions = {
 	publicKey: string;
 	fileName?: string;
@@ -358,8 +380,9 @@ export declare type MultipartOptions = {
 	maxConcurrentRequests?: number;
 	multipartMaxAttempts?: number;
 	baseCDN?: string;
+	metadata?: Metadata;
 };
-export declare const uploadMultipart: (file: NodeFile | BrowserFile, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, contentType, multipartChunkSize, maxConcurrentRequests, multipartMaxAttempts, baseCDN }: MultipartOptions) => Promise<UploadcareFile>;
+export declare const uploadMultipart: (file: NodeFile | BrowserFile, { publicKey, fileName, fileSize, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, contentType, multipartChunkSize, maxConcurrentRequests, multipartMaxAttempts, baseCDN, metadata }: MultipartOptions) => Promise<UploadcareFile>;
 export declare type FileFromOptions = {
 	publicKey: string;
 	fileName?: string;
@@ -374,6 +397,7 @@ export declare type FileFromOptions = {
 	userAgent?: CustomUserAgent;
 	retryThrottledRequestMaxTimes?: number;
 	contentType?: string;
+	multipartMinFileSize?: number;
 	multipartChunkSize?: number;
 	multipartMaxAttempts?: number;
 	maxConcurrentRequests?: number;
@@ -381,11 +405,12 @@ export declare type FileFromOptions = {
 	checkForUrlDuplicates?: boolean;
 	saveUrlForRecurrentUploads?: boolean;
 	pusherKey?: string;
+	metadata?: Metadata;
 };
 /**
  * Uploads file from provided data.
  */
-export declare function uploadFile(data: NodeFile | BrowserFile | Url | Uuid, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, contentType, multipartChunkSize, multipartMaxAttempts, maxConcurrentRequests, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey }: FileFromOptions): Promise<UploadcareFile>;
+export declare function uploadFile(data: NodeFile | BrowserFile | Url | Uuid, { publicKey, fileName, baseURL, secureSignature, secureExpire, store, signal, onProgress, source, integration, userAgent, retryThrottledRequestMaxTimes, contentType, multipartMinFileSize, multipartChunkSize, multipartMaxAttempts, maxConcurrentRequests, baseCDN, checkForUrlDuplicates, saveUrlForRecurrentUploads, pusherKey, metadata }: FileFromOptions): Promise<UploadcareFile>;
 export declare class UploadcareGroup {
 	readonly uuid: GroupId;
 	readonly filesCount: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uploadcare/upload-client",
-  "version": "3.0.0-alpha.0",
+  "version": "3.1.1",
   "description": "Library for work with Uploadcare Upload API",
   "type": "module",
   "main": "dist/index.cjs",
@@ -22,7 +22,7 @@
   },
   "scripts": {
     "check-env-vars": "node ./checkvars.js",
-    "mock:start": "node --loader ts-node/esm.mjs ./mock-server/server.ts --silent",
+    "mock:start": "node --loader ts-node/esm ./mock-server/server.ts --silent",
     "clean": "rimraf dist",
     "lint": "eslint ./src ./mock-server --ext=ts",
     "test": "start-server-and-test mock:start :3000 test:jest",
@@ -91,7 +91,7 @@
     "shipjs": "0.24.0",
     "start-server-and-test": "1.11.7",
     "ts-jest": "26.4.1",
-    "ts-node": "9.1.1"
+    "ts-node": "10.5.0"
   },
   "dependencies": {
     "abort-controller": "^3.0.0",