uplofile 2.1.0 → 2.2.0

package/dist/index.d.ts

@@ -6,6 +6,7 @@ declare const Dropzone: ({ asChild, ...rest }: {
     asChild?: boolean;
 } & HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
 
+type MaybePromise<T> = T | Promise<T>;
 type UploadStatus = "idle" | "uploading" | "done" | "error" | "canceled" | "removing";
 type UploadFileItem<TMeta = any> = {
     uid: string;
@@ -19,9 +20,11 @@ type UploadFileItem<TMeta = any> = {
     error?: string;
     meta?: TMeta;
 };
-type UploadResult = {
+type UploadResult<TMeta = any> = {
     url: string;
     id?: string;
+    meta?: TMeta;
+    previewUrl?: string;
 };
 type UplofileRootRef<TMeta = any> = {
     setItems: (items: UploadFileItem<TMeta>[] | ((prev: UploadFileItem<TMeta>[]) => UploadFileItem<TMeta>[])) => void;
@@ -40,7 +43,7 @@ type BeforeUploadResult<TMeta = any> = boolean | Array<{
 }>;
 type RootProps<TMeta = any> = PropsWithChildren<{
     multiple?: boolean;
-    initial?: Array<Pick<UploadFileItem<TMeta>, "uid" | "id" | "name" | "url" | "meta">>;
+    initial?: MaybePromise<Array<Pick<UploadFileItem<TMeta>, "uid" | "id" | "name" | "url" | "meta">>>;
     /**
      * optimistic (default): remove from UI immediately, call onRemove in the background; if it fails, restore the item and show error.
      * strict: call onRemove first; only remove from UI if it succeeds.
@@ -52,7 +55,7 @@ type RootProps<TMeta = any> = PropsWithChildren<{
     accept?: string;
     beforeUpload?: (items: UploadFileItem<TMeta>[]) => BeforeUploadResult<TMeta> | Promise<BeforeUploadResult<TMeta>>;
     onChange?: (items: UploadFileItem<TMeta>[]) => Promise<void> | void;
-    upload: (file: File, signal: AbortSignal, setProgress?: (pct: number) => void) => Promise<UploadResult>;
+    upload: (file: File, signal: AbortSignal, setProgress?: (pct: number) => void) => Promise<UploadResult<TMeta>>;
     onRemove?: (item: UploadFileItem<TMeta>, signal: AbortSignal) => Promise<void | any>;
 }>;
 type ItemActions = {
@@ -120,7 +123,7 @@ declare const Remove: ({ uid, asChild, ...rest }: ButtonProps) => react_jsx_runt
 
 declare const Root: React.ForwardRefExoticComponent<{
     multiple?: boolean;
-    initial?: Pick<UploadFileItem<unknown>, "id" | "name" | "uid" | "url" | "meta">[] | undefined;
+    initial?: MaybePromise<Pick<UploadFileItem<unknown>, "id" | "name" | "uid" | "url" | "meta">[]> | undefined;
     removeMode?: "optimistic" | "strict";
     name?: string;
     maxCount?: number;
@@ -128,7 +131,7 @@ declare const Root: React.ForwardRefExoticComponent<{
     accept?: string;
     beforeUpload?: ((items: UploadFileItem<unknown>[]) => BeforeUploadResult<unknown> | Promise<BeforeUploadResult<unknown>>) | undefined;
     onChange?: ((items: UploadFileItem<unknown>[]) => Promise<void> | void) | undefined;
-    upload: (file: File, signal: AbortSignal, setProgress?: (pct: number) => void) => Promise<UploadResult>;
+    upload: (file: File, signal: AbortSignal, setProgress?: (pct: number) => void) => Promise<UploadResult<unknown>>;
     onRemove?: ((item: UploadFileItem<unknown>, signal: AbortSignal) => Promise<void | any>) | undefined;
 } & {
     children?: React.ReactNode | undefined;
@@ -147,4 +150,4 @@ declare const isVideoFile: (item: UploadFileItem<any>, extraExtensions?: string[
 declare const isImageFile: (item: UploadFileItem<any>, extraExtensions?: string[]) => boolean;
 
 export { Cancel, Dropzone, HiddenInput, Preview, Remove, Retry, Root, Trigger, getExtension, isImageFile, isVideoFile, useUplofile };
-export type { ImageUploaderContextValue, ItemActions, RootProps, UploadFileItem, UploadResult, UploadStatus, UplofileRootRef };
+export type { BeforeUploadResult, ImageUploaderContextValue, ItemActions, RootProps, UploadFileItem, UploadResult, UploadStatus, UplofileRootRef };

package/dist/index.mjs

@@ -124,21 +124,24 @@ const Root = /*#__PURE__*/ forwardRef(({ multiple = true, initial = [], onChange
     // Hydrate initial items from the server and keep them marked as done
     useEffect(()=>{
         if (hasHydratedInitialRef.current) return;
-        const arr = initial ?? [];
-        if (!Array.isArray(arr) || arr.length === 0) return;
-        const mapped = arr.map((it)=>{
-            return {
-                uid: it.uid || it.id,
-                id: it.id,
-                name: it.name,
-                url: it.url,
-                status: "done",
-                meta: it.meta
-            };
-        });
-        // Only hydrate if the user hasn't already added/modified items locally
-        setItems((prev)=>prev.length === 0 ? mapped : prev);
-        hasHydratedInitialRef.current = true;
+        const hydrate = async ()=>{
+            const arr = await initial;
+            if (!Array.isArray(arr) || arr.length === 0) return;
+            const mapped = arr.map((it)=>{
+                return {
+                    uid: it.uid || it.id,
+                    id: it.id,
+                    name: it.name,
+                    url: it.url,
+                    status: "done",
+                    meta: it.meta
+                };
+            });
+            // Only hydrate if the user hasn't already added/modified items locally
+            setItems((prev)=>prev.length === 0 ? mapped : prev);
+            hasHydratedInitialRef.current = true;
+        };
+        void hydrate();
     }, [
         initial
     ]);
@@ -183,13 +186,14 @@ const Root = /*#__PURE__*/ forwardRef(({ multiple = true, initial = [], onChange
                         } catch  {
                         /*fail silently*/ }
                     }
-                    const serverPreview = result?.preview || result.url;
+                    const serverPreview = result.previewUrl ?? result.preview ?? result.url;
                     return {
                         ...it,
                         status: "done",
                         url: result.url,
                         id: result.id ?? it.id,
                         previewUrl: serverPreview,
+                        meta: result.meta ?? it.meta,
                         progress: 100
                     };
                 }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uplofile",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Composable file‑upload components for React.",
   "license": "MIT",
   "author": "Chris Josh <KristofaJosh>",