@dofe/file-sdk-web 0.1.1 → 0.1.3

package/README.md

@@ -26,8 +26,8 @@ const { fileId, cdnUrl } = await uploader.upload(file, {
 // Large files: multipart upload with concurrency
 const { fileId, cdnUrl } = await uploader.uploadMultipart(bigFile, {
   scope: 'media-asset',
-  partSize: 5 * 1024 * 1024,   // 5MB parts
-  concurrency: 3,                // 3 parallel parts
+  partSize: 5 * 1024 * 1024, // 5MB parts
+  concurrency: 3, // 3 parallel parts
   onProgress: ({ percent, loaded, total }) => {
     console.log(`${percent}% (${loaded}/${total})`);
   },
@@ -38,28 +38,28 @@ const { fileId, cdnUrl } = await uploader.uploadMultipart(bigFile, {
 
 ### `new FileUploader(config)`
 
-| Option | Type | Required | Default | Description |
-|--------|------|:---:|---------|-------------|
-| `apiBase` | `string` | ✅ | — | API base URL (e.g., `/api/proxy/sso` or `https://sso.dofe.ai`) |
-| `timeout` | `number` | ❌ | `30000` | Request timeout in ms |
+| Option    | Type     | Required | Default | Description                                                    |
+| --------- | -------- | :------: | ------- | -------------------------------------------------------------- |
+| `apiBase` | `string` |    ✅    | —       | API base URL (e.g., `/api/proxy/sso` or `https://sso.dofe.ai`) |
+| `timeout` | `number` |    ❌    | `30000` | Request timeout in ms                                          |
 
 ### Methods
 
-| Method | Returns | Description |
-|--------|---------|-------------|
-| `upload(file, options)` | `Promise<UploadResult>` | Auto-chooses direct or multipart based on file size (>5MB → multipart) |
-| `uploadDirect(file, options)` | `Promise<UploadResult>` | Direct upload for small files |
-| `uploadMultipart(file, options)` | `Promise<UploadResult>` | Multipart upload with configurable part size and concurrency |
+| Method                           | Returns                 | Description                                                            |
+| -------------------------------- | ----------------------- | ---------------------------------------------------------------------- |
+| `upload(file, options)`          | `Promise<UploadResult>` | Auto-chooses direct or multipart based on file size (>5MB → multipart) |
+| `uploadDirect(file, options)`    | `Promise<UploadResult>` | Direct upload for small files                                          |
+| `uploadMultipart(file, options)` | `Promise<UploadResult>` | Multipart upload with configurable part size and concurrency           |
 
 ### UploadResult
 
 ```typescript
 interface UploadResult {
-  fileId: string;    // SSO FileSource UUID
-  key: string;       // Object storage key
-  url: string;       // Upload URL / token
-  cdnUrl: string | null;  // CDN URL (null for private files)
-  bucket: string;    // Storage bucket name
+  fileId: string; // SSO FileSource UUID
+  key: string; // Object storage key
+  url: string; // Upload URL / token
+  cdnUrl: string | null; // CDN URL (null for private files)
+  bucket: string; // Storage bucket name
 }
 ```
 

package/dist/uploader.d.ts

@@ -28,6 +28,7 @@ export declare class FileUploader {
     private uploadPart;
     /**
      * PUT file/blob directly to a presigned URL.
+     * Returns the ETag from the response headers for multipart completion.
      */
     private uploadToPresignedUrl;
     /**

package/dist/uploader.js

@@ -71,10 +71,14 @@ class FileUploader {
         const { token, fileId, key, bucket, url: uploadId } = (_c = initRes.data) !== null && _c !== void 0 ? _c : initRes;
         // Step 2: Upload first part
         const part1 = file.slice(0, partSize);
-        await this.uploadToPresignedUrl(token, part1);
-        const parts = [{ partNumber: 1, etag: 'uploaded' }];
+        const etag1 = await this.uploadToPresignedUrl(token, part1);
+        const parts = [{ partNumber: 1, etag: etag1 }];
         let loaded = partSize;
-        (_d = options.onProgress) === null || _d === void 0 ? void 0 : _d.call(options, { percent: Math.round((loaded / file.size) * 100), loaded, total: file.size });
+        (_d = options.onProgress) === null || _d === void 0 ? void 0 : _d.call(options, {
+            percent: Math.round((loaded / file.size) * 100),
+            loaded,
+            total: file.size,
+        });
         // Step 3: Upload remaining parts in parallel batches
         for (let i = 2; i <= totalParts; i += concurrency) {
             const batch = [];
@@ -86,7 +90,11 @@ class FileUploader {
             parts.push(...results.filter(Boolean));
             loaded += (batchEnd - i + 1) * partSize;
             const actualLoaded = Math.min(loaded, file.size);
-            (_e = options.onProgress) === null || _e === void 0 ? void 0 : _e.call(options, { percent: Math.round((actualLoaded / file.size) * 100), loaded: actualLoaded, total: file.size });
+            (_e = options.onProgress) === null || _e === void 0 ? void 0 : _e.call(options, {
+                percent: Math.round((actualLoaded / file.size) * 100),
+                loaded: actualLoaded,
+                total: file.size,
+            });
         }
         // Step 4: Complete multipart upload
         const completeRes = await this.fetchJson(`${this.apiBase}/api/uploader/complete`, {
@@ -124,8 +132,8 @@ class FileUploader {
             const start = (partNumber - 1) * partSize;
             const end = Math.min(start + partSize, file.size);
             const chunk = file.slice(start, end);
-            await this.uploadToPresignedUrl((_b = (_a = tokenRes.data) === null || _a === void 0 ? void 0 : _a.token) !== null && _b !== void 0 ? _b : tokenRes.token, chunk);
-            return { partNumber, etag: `etag-${partNumber}` };
+            const etag = await this.uploadToPresignedUrl((_b = (_a = tokenRes.data) === null || _a === void 0 ? void 0 : _a.token) !== null && _b !== void 0 ? _b : tokenRes.token, chunk);
+            return { partNumber, etag };
         }
         catch (err) {
             // Part upload failed; caller can retry
@@ -134,8 +142,10 @@ class FileUploader {
     }
     /**
      * PUT file/blob directly to a presigned URL.
+     * Returns the ETag from the response headers for multipart completion.
      */
     async uploadToPresignedUrl(presignedUrl, data) {
+        var _a, _b;
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.timeout);
         try {
@@ -150,6 +160,8 @@ class FileUploader {
             if (!res.ok) {
                 throw new Error(`Upload to storage failed: HTTP ${res.status}`);
             }
+            // 从响应头中提取实际 ETag（用于 multipart complete 验证）
+            return (_b = (_a = res.headers.get('ETag')) !== null && _a !== void 0 ? _a : res.headers.get('etag')) !== null && _b !== void 0 ? _b : '';
         }
         finally {
             clearTimeout(timeoutId);
@@ -159,7 +171,7 @@ class FileUploader {
      * Fetch JSON from API, extracting the data field from the standard response wrapper.
      */
     async fetchJson(url, options) {
-        var _a;
+        var _a, _b;
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.timeout);
         try {
@@ -168,6 +180,14 @@ class FileUploader {
                 throw new Error(`HTTP ${res.status}: ${res.statusText}`);
             }
             const json = await res.json();
+            // Check for API-level errors in { code, msg, data } envelope
+            if (json && typeof json === 'object' && 'code' in json) {
+                const code = json.code;
+                if (code !== 0 && code !== 200) {
+                    const msg = (_b = json.msg) !== null && _b !== void 0 ? _b : 'Unknown API error';
+                    throw new Error(`API error [${code}]: ${msg}`);
+                }
+            }
             // Unwrap standard { code, msg, data } envelope
             if (json && typeof json === 'object' && 'data' in json) {
                 return json;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dofe/file-sdk-web",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "DofeAI unified file uploader SDK for browsers — direct upload, multipart upload with progress, via sso.dofe.ai",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",