nuxt-upload-kit 0.1.11 → 0.1.13

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-upload-kit",
   "configKey": "uploadKit",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/runtime/composables/useUploadKit/index.d.ts

@@ -184,6 +184,7 @@ export declare const useUploadKit: <TUploadResult = any>(_options?: UploadOption
         };
     })[]>>;
     totalProgress: import("vue").ComputedRef<number>;
+    isReady: Readonly<import("vue").Ref<boolean, boolean>>;
     addFiles: (newFiles: File[]) => Promise<UploadFile[]>;
     addFile: (file: File) => Promise<UploadFile>;
     onGetRemoteFile: (fn: GetRemoteFileFn) => void;

package/dist/runtime/composables/useUploadKit/index.js

@@ -1,5 +1,5 @@
 import mitt from "mitt";
-import { computed, onBeforeUnmount, readonly, ref } from "vue";
+import { computed, isRef, onBeforeUnmount, readonly, ref, toValue, watch } from "vue";
 import { ValidatorAllowedFileTypes, ValidatorMaxFileSize, ValidatorMaxFiles } from "./validators/index.js";
 import { PluginThumbnailGenerator, PluginImageCompressor } from "./plugins/index.js";
 import { createPluginContext, createFileError, cleanupObjectURLs } from "./utils.js";
@@ -23,11 +23,48 @@ const defaultOptions = {
   imageCompression: false,
   autoUpload: false
 };
+function setupInitialFiles({
+  initialFiles,
+  files,
+  isReady,
+  emitter,
+  initializeExistingFiles
+}) {
+  if (initialFiles === void 0) return;
+  let isInitialized = false;
+  const doInitialize = async (value) => {
+    if (isInitialized || !value || files.value.length > 0) return;
+    const paths = Array.isArray(value) ? value : [value];
+    if (paths.length > 0 && paths.every(Boolean)) {
+      isInitialized = true;
+      try {
+        await initializeExistingFiles(paths.map((id) => ({ id })));
+        isReady.value = true;
+        emitter.emit("initialFiles:loaded", files.value);
+      } catch (error) {
+        isReady.value = true;
+        emitter.emit("initialFiles:error", error);
+      }
+    } else {
+      isReady.value = true;
+    }
+  };
+  if (isRef(initialFiles)) {
+    watch(
+      () => toValue(initialFiles),
+      (newValue) => doInitialize(newValue),
+      { immediate: true }
+    );
+  } else {
+    doInitialize(initialFiles);
+  }
+}
 export const useUploadKit = (_options = {}) => {
   const options = { ...defaultOptions, ..._options };
   const files = ref([]);
   const emitter = mitt();
   const status = ref("waiting");
+  const isReady = ref(options.initialFiles === void 0);
   const createdObjectURLs = /* @__PURE__ */ new Map();
   let hasEmittedFilesUploaded = false;
   const pluginEmitFunctions = /* @__PURE__ */ new Map();
@@ -164,8 +201,10 @@ This is deprecated. Use the 'storage' option instead:
           remoteUrl: remoteFileData.remoteUrl,
           preview: remoteFileData.preview || file.preview || remoteFileData.remoteUrl,
           // Use preview from storage, passed-in value, or fallback to remoteUrl
-          source: "storage"
+          source: "storage",
           // File loaded from remote storage
+          // Set uploadResult for consistency with newly uploaded files
+          uploadResult: remoteFileData.uploadResult
         };
         return existingFile;
       })
@@ -460,10 +499,18 @@ This is deprecated. Use the 'storage' option instead:
     }
     return currentFile;
   }
+  setupInitialFiles({
+    initialFiles: options.initialFiles,
+    files,
+    isReady,
+    emitter,
+    initializeExistingFiles
+  });
   return {
     // State
     files: readonly(files),
     totalProgress,
+    isReady: readonly(isReady),
     // Core Methods
     addFiles,
     addFile,

package/dist/runtime/composables/useUploadKit/plugins/storage/azure-datalake.js

@@ -119,7 +119,12 @@ export const PluginAzureDataLake = defineStorageAdapter((options) => {
           return {
             size: properties.contentLength || 0,
             mimeType: properties.contentType || "application/octet-stream",
-            remoteUrl: fileClient.url
+            remoteUrl: fileClient.url,
+            // Include uploadResult for consistency with newly uploaded files
+            uploadResult: {
+              url: fileClient.url,
+              blobPath: fileClient.name
+            }
           };
         }, `Get remote file "${fileId}"`);
       },

package/dist/runtime/composables/useUploadKit/types.d.ts

@@ -1,4 +1,5 @@
 import type { Emitter } from "mitt";
+import type { MaybeRef } from "vue";
 /**
  * PUBLIC API - Types users commonly need
  * These are exported from the main package
@@ -231,6 +232,25 @@ export interface UploadOptions {
      * @default false
      */
     autoUpload?: boolean;
+    /**
+     * Initialize with existing file paths/IDs (e.g., from a form model)
+     * Accepts a static array or a reactive ref for deferred initialization.
+     *
+     * When a ref is provided, the composable watches it and initializes
+     * files once on first truthy value.
+     *
+     * @example Static value
+     * ```typescript
+     * useUploadKit({ initialFiles: ['path/to/image.jpg'] })
+     * ```
+     *
+     * @example Reactive ref (from defineModel)
+     * ```typescript
+     * const model = defineModel<string[]>()
+     * useUploadKit({ initialFiles: model })
+     * ```
+     */
+    initialFiles?: MaybeRef<string | string[] | undefined>;
 }
 export interface ThumbnailOptions {
     width?: number;
@@ -267,6 +287,10 @@ type CoreUploaderEvents<TUploadResult = any> = {
     };
     /** Emitted when all files have finished uploading (all files have 'complete' status) */
     "files:uploaded": Array<Readonly<UploadFile<TUploadResult>>>;
+    /** Emitted when initialFiles have been loaded from storage */
+    "initialFiles:loaded": Array<Readonly<UploadFile<TUploadResult>>>;
+    /** Emitted when initialFiles failed to load */
+    "initialFiles:error": unknown;
 };
 export type UploaderEvents<TUploadResult = any> = CoreUploaderEvents<TUploadResult>;
 /**
@@ -485,10 +509,16 @@ export type Processor = (file: UploadFile) => Promise<File | Blob>;
 export interface UploadBlob {
     blobPath: string;
 }
-type MinimumRemoteFileAttributes = {
+export type MinimumRemoteFileAttributes<TUploadResult = any> = {
     size: number;
     mimeType: string;
     remoteUrl: string;
     preview?: string;
+    /**
+     * Optional upload result from storage plugin.
+     * When provided, this will be set on initialized files for consistency
+     * with newly uploaded files, eliminating the need for special handling.
+     */
+    uploadResult?: TUploadResult;
 };
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-upload-kit",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "A powerful, plugin-based file upload manager for Nuxt applications",
   "license": "MIT",
   "repository": "https://github.com/genu/nuxt-upload-kit.git",
@@ -43,9 +43,9 @@
     "mitt": "^3.0.1"
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "^3.970.0",
-    "@aws-sdk/lib-storage": "^3.970.0",
-    "@azure/storage-file-datalake": "^12.28.1",
+    "@aws-sdk/client-s3": "^3.974.0",
+    "@aws-sdk/lib-storage": "^3.974.0",
+    "@azure/storage-file-datalake": "^12.29.0",
     "@ffmpeg/ffmpeg": "0.12.15",
     "@ffmpeg/util": "0.12.2",
     "@nuxt/devtools": "^3.1.1",
@@ -55,19 +55,19 @@
     "@nuxt/test-utils": "^3.23.0",
     "@types/node": "latest",
     "@vitejs/plugin-vue": "^6.0.3",
-    "@vitest/coverage-v8": "^4.0.17",
+    "@vitest/coverage-v8": "^4.0.18",
     "changelogen": "^0.6.2",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-prettier": "5.5.5",
     "firebase": "^12.8.0",
-    "happy-dom": "^20.3.1",
+    "happy-dom": "^20.3.4",
     "nuxt": "^4.2.2",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "typescript": "~5.9.3",
     "unbuild": "^3.6.1",
-    "vitest": "^4.0.17",
-    "vue": "^3.5.26",
+    "vitest": "^4.0.18",
+    "vue": "^3.5.27",
     "vue-tsc": "^3.2.2"
   },
   "peerDependencies": {