@uploadcare/file-uploader 1.31.1 → 1.32.0-alpha.0

package/web/file-uploader.min.d.ts

@@ -390,7 +390,9 @@ declare class TypedCollection<T extends Record<string, unknown>> {
     private _scheduleDestroyMarkedItems;
     observeCollection(handler: TypedCollectionObserverHandler<T>): () => void;
     unobserveCollection(handler: TypedCollectionObserverHandler<T>): void;
-    add(init: Partial<T>): Uid;
+    add(init: Partial<T>, options?: {
+        index?: number;
+    }): Uid;
     hasItem(id: Uid): boolean;
     read(id: Uid): TypedData<T> | null;
     readProp<K extends keyof T>(id: Uid, propName: K): T[K];
@@ -1345,6 +1347,17 @@ declare class UploaderPublicApi extends SharedInstance {
         fullPath?: string;
     }) => OutputFileEntry<"idle">;
     addFileFromUploadcareFile: (file: UploadcareFile, { silent, fileName, source }?: ApiAddFileCommonOptions) => OutputFileEntry<"success">;
+    /**
+     * Replace an existing entry with an already-uploaded Uploadcare file, keeping
+     * the file's position in the list. The original entry is removed and a fresh
+     * entry is added in its place, so the replacement runs through the full add
+     * pipeline (validators, events) like any newly added file. The original's
+     * context (source, metadata, fullPath, silent) is preserved.
+     *
+     * Note: the replacement is a new entry, so it has a NEW `internalId` — use the
+     * returned entry to reference it going forward.
+     */
+    replaceFileFromUploadcareFile: (internalId: string, file: UploadcareFile, { silent, fileName, source }?: ApiAddFileCommonOptions) => OutputFileEntry<"success">;
     removeFileByInternalId: (internalId: string) => void;
     removeAllFiles(): void;
     uploadAll: () => void;
@@ -2567,6 +2580,16 @@ type PluginFilesApi = {
      * `fileSize` is recalculated automatically when `file` is provided.
      */
     update: (internalId: string, changes: PluginFileEntryUpdate) => void;
+    /**
+     * Replace an existing entry with an already-uploaded Uploadcare file, keeping
+     * its position in the list. The original entry is removed and a fresh one is
+     * added in its place, so the replacement goes through the full add pipeline
+     * (validators, events) like any newly added file.
+     *
+     * Returns the new entry. Note: it has a NEW `internalId` — use the returned
+     * entry to reference the replacement going forward.
+     */
+    replace: (internalId: string, file: UploadcareFile) => OutputFileEntry<'success'>;
 };
 type PluginApi = {
     registry: PluginRegistryApi;