mbkbucket 4.0.1 → 4.2.0

package/lib/public/bucketadmin.js

@@ -29,6 +29,17 @@
   let selectedFiles = new Set();
   let starredFiles = new Set(JSON.parse(localStorage.getItem('mbk_starred_keys') || '[]'));
   let currentPreviewKey = '';
+  let currentCapabilities = {
+    multipart: true,
+    copy: true,
+    move: true,
+    search: true,
+    storageQuota: false,
+    hierarchicalFolders: true,
+    deleteBatch: true,
+    publicUrls: false
+  };
+  let currentStorageQuota = null;
 
   // Upload State
   let uploadQueue = [];
@@ -134,18 +145,26 @@
     return `${url}${sep}bucket=${encodeURIComponent(activeBucket)}`;
   }
 
+  function encodeKeyForUrl(key) {
+    return String(key || '')
+      .split('/')
+      .map(segment => encodeURIComponent(segment))
+      .join('/');
+  }
+
   function getViewUrl(key) {
-    return withBucketUrl(`/mbkbucket/view/${encodeURIComponent(key)}`);
+    return withBucketUrl(`/mbkbucket/view/${encodeKeyForUrl(key)}`);
   }
 
   function getPublicViewUrl(key) {
-    return withBucketUrl(`/mbkbucket/p_view/${encodeURIComponent(key)}`);
+    return withBucketUrl(`/mbkbucket/p_view/${encodeKeyForUrl(key)}`);
   }
 
   function getDownloadUrl(key) {
-    return withBucketUrl(`/mbkbucket/download/${encodeURIComponent(key)}`);
+    return withBucketUrl(`/mbkbucket/download/${encodeKeyForUrl(key)}`);
   }
 
+
   function isImage(fileName) {
     const ext = getFileExt(fileName);
     return ['jpg', 'jpeg', 'png', 'gif', 'webp', 'svg', 'bmp'].includes(ext);
@@ -258,6 +277,56 @@
     }
   }
 
+  // Clipboard System with Visual Feedback & Fallback
+  function copyToClipboard(text, successMsg = 'Copied to clipboard', btnEl = null) {
+    if (!text) return;
+    const executeCopy = () => {
+      if (navigator.clipboard && window.isSecureContext) {
+        return navigator.clipboard.writeText(text);
+      }
+      return new Promise((resolve, reject) => {
+        const textArea = document.createElement('textarea');
+        textArea.value = text;
+        textArea.style.position = 'fixed';
+        textArea.style.left = '-9999px';
+        textArea.style.top = '-9999px';
+        textArea.setAttribute('readonly', '');
+        document.body.appendChild(textArea);
+        textArea.select();
+        try {
+          const ok = document.execCommand('copy');
+          textArea.remove();
+          ok ? resolve() : reject(new Error('Copy failed'));
+        } catch (e) {
+          textArea.remove();
+          reject(e);
+        }
+      });
+    };
+
+    executeCopy().then(() => {
+      showToast(successMsg, 'success');
+      if (btnEl && btnEl instanceof HTMLElement) {
+        const originalHtml = btnEl.innerHTML;
+        const originalBorder = btnEl.style.borderColor;
+        const originalColor = btnEl.style.color;
+        btnEl.classList.add('is-copied');
+        btnEl.innerHTML = `<svg width="13" height="13" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="2" style="color: var(--green);"><path d="M2 8.5L6 12.5L14 4.5"/></svg> <span style="color: var(--green); font-weight: 600;">Copied!</span>`;
+        btnEl.style.borderColor = 'var(--green)';
+
+        setTimeout(() => {
+          btnEl.classList.remove('is-copied');
+          btnEl.innerHTML = originalHtml;
+          btnEl.style.borderColor = originalBorder;
+          btnEl.style.color = originalColor;
+        }, 1600);
+      }
+    }).catch((err) => {
+      console.error('Clipboard copy error:', err);
+      showToast('Failed to copy to clipboard', 'error');
+    });
+  }
+
   // Toast System
   function showToast(message, type = 'success') {
     const container = document.getElementById('toast-container');
@@ -283,6 +352,67 @@
     }, 4000);
   }
 
+  // Storage Quota & Usage Meter
+  function updateStorageUsageMeter(quota = null) {
+    const usageBar = document.getElementById('storageUsageBar');
+    const filterInfo = document.getElementById('filterInfo');
+
+    if (quota && quota.limit && Number(quota.limit) > 0) {
+      currentStorageQuota = quota;
+      const usage = Number(quota.usage || 0);
+      const limit = Number(quota.limit);
+      const percent = Math.min(100, Math.max(0, Math.round((usage / limit) * 100)));
+
+      if (usageBar) {
+        usageBar.style.width = `${percent}%`;
+        usageBar.style.background = percent > 90 ? 'var(--red)' : percent > 75 ? 'var(--orange)' : 'var(--primary)';
+      }
+      if (filterInfo) {
+        filterInfo.textContent = `${formatFileSize(usage)} of ${formatFileSize(limit)} (${percent}%)`;
+        filterInfo.title = `Storage: ${formatFileSize(usage)} of ${formatFileSize(limit)}`;
+      }
+    } else {
+      const totalBytes = (pageFiles || []).reduce((acc, f) => acc + Number(f.Size || 0), 0);
+      if (usageBar) {
+        usageBar.style.width = '100%';
+        usageBar.style.background = 'var(--primary)';
+      }
+      if (filterInfo && !currentStorageQuota) {
+        filterInfo.textContent = activeBucket ? `${activeBucket} · ${formatFileSize(totalBytes)}` : `${formatFileSize(totalBytes)} loaded`;
+      }
+    }
+  }
+
+  // Dynamic UI Adaptation Based on Provider Capabilities
+  function applyCapabilitiesUI() {
+    const batchMoveBtn = document.getElementById('batchMoveBtn');
+    if (batchMoveBtn) {
+      batchMoveBtn.style.display = currentCapabilities.move === false ? 'none' : '';
+    }
+
+    const newFolderBtn = document.getElementById('new-folder-btn');
+    if (newFolderBtn) {
+      if (currentCapabilities.hierarchicalFolders === false) {
+        newFolderBtn.style.opacity = '0.5';
+        newFolderBtn.title = 'Folders not supported by current provider';
+      } else {
+        newFolderBtn.style.opacity = '';
+        newFolderBtn.title = '';
+      }
+    }
+
+    const searchInput = document.getElementById('searchInput');
+    if (searchInput) {
+      if (currentCapabilities.search === false) {
+        searchInput.placeholder = 'Search not supported';
+        searchInput.disabled = true;
+      } else {
+        searchInput.placeholder = 'Search files…';
+        searchInput.disabled = false;
+      }
+    }
+  }
+
   // Live Health Check
   async function checkConnectionHealth(silent = true) {
     const healthBadge = document.getElementById('topHealthBadge');
@@ -306,6 +436,11 @@
           if (healthText) healthText.textContent = 'Healthy';
         }
         if (latencyTag) latencyTag.textContent = `${latency}ms`;
+        if (data.storageQuota) {
+          updateStorageUsageMeter(data.storageQuota);
+        } else {
+          updateStorageUsageMeter(null);
+        }
         if (!silent) showToast(`Storage connection healthy (${latency}ms)`, 'success');
       } else {
         if (healthBadge) {
@@ -725,6 +860,11 @@
       currentApiPrefix = data.prefix || '';
       pageFiles = data.files || [];
 
+      if (data.capabilities) {
+        currentCapabilities = Object.assign({}, currentCapabilities, data.capabilities);
+        applyCapabilitiesUI();
+      }
+
       if (data.mode === 'optimized') {
         pageFolders = (data.folders || []).map(folder => stripApiPrefixFromPath(folder, currentApiPrefix)).filter(Boolean);
       } else {
@@ -739,6 +879,7 @@
       renderBreadcrumbs();
       renderFiles();
       renderPagination(data);
+      updateStorageUsageMeter(currentStorageQuota);
       checkConnectionHealth(true);
     } catch (err) {
       console.error('Error loading files:', err);
@@ -872,22 +1013,14 @@
     }
   }
 
-  function copyShareLink(key) {
+  function copyShareLink(key, btnEl = null) {
     const viewUrl = window.location.origin + getViewUrl(key);
-    navigator.clipboard.writeText(viewUrl).then(() => {
-      showToast('Link copied to clipboard', 'success');
-    }).catch(() => {
-      showToast('Failed to copy link', 'error');
-    });
+    copyToClipboard(viewUrl, 'Link copied to clipboard', btnEl);
   }
 
-  function copyPublicLink(key) {
+  function copyPublicLink(key, btnEl = null) {
     const publicUrl = window.location.origin + getPublicViewUrl(key);
-    navigator.clipboard.writeText(publicUrl).then(() => {
-      showToast('Public link copied to clipboard', 'success');
-    }).catch(() => {
-      showToast('Failed to copy public link', 'error');
-    });
+    copyToClipboard(publicUrl, 'Public link copied to clipboard', btnEl);
   }
 
   // Preview Modal
@@ -962,8 +1095,10 @@
     } else if (isAudio(fileName)) {
       contentEl.innerHTML = `<div class="p-4 text-center"><audio controls autoplay class="w-100"><source src="${viewUrl}"></audio></div>`;
     } else if (isPdf(fileName)) {
-      contentEl.innerHTML = `<iframe src="${viewUrl}" class="preview-iframe"></iframe>`;
+      contentEl.innerHTML = `<iframe src="${viewUrl}" class="preview-iframe" width="100%" height="100%" frameborder="0" title="${escapeAttr(fileName)}"></iframe>`;
     } else if (isMarkdown(fileName)) {
+
+
       fetch(viewUrl).then(res => res.text()).then(text => {
         contentEl.innerHTML = renderMarkdownToHtml(text);
       }).catch(err => {
@@ -990,12 +1125,12 @@
     if (modal) modal.classList.remove('show');
   };
 
-  window.copyCurrentPreviewLink = function () {
-    if (currentPreviewKey) copyShareLink(currentPreviewKey);
+  window.copyCurrentPreviewLink = function (btnEl) {
+    if (currentPreviewKey) copyShareLink(currentPreviewKey, btnEl || document.getElementById('previewCopyLinkBtn'));
   };
 
-  window.copyCurrentPreviewPublicLink = function () {
-    if (currentPreviewKey) copyPublicLink(currentPreviewKey);
+  window.copyCurrentPreviewPublicLink = function (btnEl) {
+    if (currentPreviewKey) copyPublicLink(currentPreviewKey, btnEl || document.getElementById('previewCopyPublicLinkBtn'));
   };
 
   // Move & Rename Modal
@@ -1153,6 +1288,67 @@
     `).join('');
   }
 
+  async function uploadFileMultipart(file, prefix, onProgress) {
+    const initRes = await fetch(withBucketUrl('/mbkbucket/upload-init'), {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        fileName: file.name,
+        prefix: prefix,
+        contentType: file.type || 'application/octet-stream'
+      })
+    });
+    const initData = await initRes.json();
+    if (!initData.success) throw new Error(initData.error || 'Failed to initialize multipart upload');
+
+    const { uploadId, key } = initData;
+    const chunkSize = 5 * 1024 * 1024;
+    const totalParts = Math.ceil(file.size / chunkSize);
+    const parts = [];
+
+    try {
+      for (let partNumber = 1; partNumber <= totalParts; partNumber++) {
+        const start = (partNumber - 1) * chunkSize;
+        const end = Math.min(start + chunkSize, file.size);
+        const chunkBlob = file.slice(start, end);
+
+        const chunkForm = new FormData();
+        chunkForm.append('uploadId', uploadId);
+        chunkForm.append('key', key);
+        chunkForm.append('partNumber', String(partNumber));
+        chunkForm.append('chunk', chunkBlob, file.name);
+
+        const chunkRes = await fetch(withBucketUrl('/mbkbucket/upload-chunk'), {
+          method: 'POST',
+          body: chunkForm
+        });
+        const chunkData = await chunkRes.json();
+        if (!chunkData.success) throw new Error(chunkData.error || `Failed chunk ${partNumber}`);
+
+        parts.push({ PartNumber: partNumber, ETag: chunkData.etag || chunkData.ETag });
+        if (typeof onProgress === 'function') {
+          onProgress(partNumber / totalParts);
+        }
+      }
+
+      const completeRes = await fetch(withBucketUrl('/mbkbucket/upload-complete'), {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ uploadId, key, parts })
+      });
+      const completeData = await completeRes.json();
+      if (!completeData.success) throw new Error(completeData.error || 'Failed to complete multipart upload');
+      return completeData;
+    } catch (uploadErr) {
+      fetch(withBucketUrl('/mbkbucket/upload-abort'), {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ uploadId, key })
+      }).catch(() => {});
+      throw uploadErr;
+    }
+  }
+
   async function processUploads() {
     if (isUploading || uploadQueue.length === 0) return;
     isUploading = true;
@@ -1173,18 +1369,28 @@
       const file = uploadQueue[i];
       if (statusLabel) statusLabel.textContent = `Uploading ${file.name} (${i + 1}/${totalFiles})...`;
 
-      const formData = new FormData();
-      formData.append('file', file);
-      formData.append('prefix', currentPrefix);
-
       try {
-        const response = await fetch(withBucketUrl('/mbkbucket/upload'), {
-          method: 'POST',
-          body: formData
-        });
-        const result = await response.json();
-        if (!result.success) throw new Error(result.error || 'Upload failed');
-        completed++;
+        const useMultipart = currentCapabilities.multipart && file.size > 5 * 1024 * 1024;
+        if (useMultipart) {
+          await uploadFileMultipart(file, currentPrefix, (fraction) => {
+            const overallPercent = Math.round(((i + fraction) / totalFiles) * 100);
+            if (progressBar) progressBar.style.width = `${overallPercent}%`;
+            if (percentEl) percentEl.textContent = `${overallPercent}%`;
+          });
+          completed++;
+        } else {
+          const formData = new FormData();
+          formData.append('file', file);
+          formData.append('prefix', currentPrefix);
+
+          const response = await fetch(withBucketUrl('/mbkbucket/upload'), {
+            method: 'POST',
+            body: formData
+          });
+          const result = await response.json();
+          if (!result.success) throw new Error(result.error || 'Upload failed');
+          completed++;
+        }
       } catch (err) {
         showToast(`Failed to upload ${file.name}: ${err.message}`, 'error');
       }
@@ -1405,9 +1611,25 @@
             });
           }
 
+          if (currentCapabilities.move !== false) {
+            menuItems.push({
+              id: 'move',
+              label: 'Rename / Move',
+              icon: '<svg width="13" height="13" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5"><path d="M11 2L14 5L11 8M14 5H5C3.34315 5 2 6.34315 2 8V14"/></svg>',
+              action: () => promptMove(fileKey, false)
+            });
+          }
+
+          if (currentCapabilities.copy !== false) {
+            menuItems.push({
+              id: 'copy',
+              label: 'Duplicate / Copy',
+              icon: '<svg width="13" height="13" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5"><rect x="5" y="5" width="9" height="9" rx="1.5"/><path d="M3 11V3a1.5 1.5 0 011.5-1.5h8"/></svg>',
+              action: () => promptMove(fileKey, true)
+            });
+          }
+
           menuItems.push(
-            { id: 'move', label: 'Rename / Move', icon: '<svg width="13" height="13" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5"><path d="M11 2L14 5L11 8M14 5H5C3.34315 5 2 6.34315 2 8V14"/></svg>', action: () => promptMove(fileKey, false) },
-            { id: 'copy', label: 'Duplicate / Copy', icon: '<svg width="13" height="13" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5"><rect x="5" y="5" width="9" height="9" rx="1.5"/><path d="M3 11V3a1.5 1.5 0 011.5-1.5h8"/></svg>', action: () => promptMove(fileKey, true) },
             { id: 'star', label: isStarred ? 'Unstar' : 'Star', icon: '<svg width="13" height="13" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5"><path d="M8 1l2 5 5 .5-4 3.5 1 5-4-2.5-4 2.5 1-5-4-3.5 5-.5z"/></svg>', action: () => toggleStar(fileKey) },
             '-',
             { id: 'delete', label: 'Delete', icon: '<svg width="13" height="13" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5"><path d="M3 4h10M6 4V2h4v2M5 4l1 9h4l1-9"/></svg>', danger: true, action: () => promptDelete(fileKey, false) }

package/lib/public/mbkbucket-helper-demo.html

@@ -13,11 +13,6 @@
   <title>Helper Utils Demo — MBKBucket</title>
   <meta name="description" content="Interactive demo of MBKBucket frontend helper utilities: gallery picker, file input, upload widget, multi-select, live preview binding, and API helpers.">
 
-  <!-- Fonts (same as bucket.hbs) -->
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Sora:wght@400;500;600;700;800&family=IBM+Plex+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-
   <!-- MBKBucket design system + helper styles -->
   <link rel="stylesheet" href="/mbkbucket/bucketadmin.css">
   <link rel="stylesheet" href="/mbkbucket/mbkbucket-helper.css">
@@ -834,14 +829,12 @@ uploader.<span class="fn">clear</span>();</pre>
           <span class="chip">MBKBucket.url.*</span>
           <span class="chip">listFiles</span>
           <span class="chip">uploadFile</span>
-          <span class="chip">getSignedUrl</span>
         </div>
       </div>
 
       <div class="demo-tabs">
         <div class="demo-tab active" data-tab="urls" data-group="api">URL Builders</div>
         <div class="demo-tab" data-tab="list" data-group="api">List Files</div>
-        <div class="demo-tab" data-tab="signed" data-group="api">Signed URL</div>
         <div class="demo-tab" data-tab="code" data-group="api">Code Reference</div>
       </div>
 
@@ -899,30 +892,6 @@ uploader.<span class="fn">clear</span>();</pre>
         </div>
       </div>
 
-      <!-- Signed URL -->
-      <div class="demo-pane" data-pane="api-signed">
-        <div class="form-row">
-          <label class="form-label" for="api-signed-key">File key:</label>
-          <div class="flex-row">
-            <input id="api-signed-key"
-                   class="demo-input"
-                   type="text"
-                   style="max-width:320px"
-                   placeholder="e.g. images/photo.jpg">
-            <button class="btn btn-primary btn-sm" onclick="demoSignedUrl()">Get URL</button>
-          </div>
-          <div class="form-hint">Calls <code class="inline-code">MBKBucket.api.getSignedUrl(key, { expiresIn: 3600 })</code></div>
-        </div>
-
-        <div class="api-result" id="api-signed-result" style="display:none">
-          <div class="api-result-header">
-            <div class="api-dot" id="api-signed-dot"></div>
-            <span id="api-signed-status">—</span>
-          </div>
-          <pre id="api-signed-pre"></pre>
-        </div>
-      </div>
-
       <!-- Code reference -->
       <div class="code-pane" data-pane="api-code">
         <pre class="code-block"><span class="cm">// URL helpers</span>
@@ -1132,33 +1101,6 @@ MBKBucket.toast.<span class="fn">info</span>(<span class="str">'Loading…'</spa
       pre.textContent = JSON.stringify({ error: err.message, status: err.status }, null, 2);
     }
   }
-
-  // ── 4. API: signed URL ───────────────────────────────────────
-  async function demoSignedUrl() {
-    const key = document.getElementById('api-signed-key').value.trim();
-    if (!key) { MBKBucket.toast.warning('Enter a file key first'); return; }
-
-    const result = document.getElementById('api-signed-result');
-    const dot    = document.getElementById('api-signed-dot');
-    const status = document.getElementById('api-signed-status');
-    const pre    = document.getElementById('api-signed-pre');
-
-    result.style.display = '';
-    dot.className = 'api-dot';
-    status.textContent = 'Loading…';
-    pre.textContent = '';
-
-    try {
-      const data = await MBKBucket.api.getSignedUrl(key, { expiresIn: 3600 });
-      dot.className = 'api-dot ok';
-      status.textContent = `200 OK — expires in ${data.expiresIn}s`;
-      pre.textContent = JSON.stringify(data, null, 2);
-    } catch (err) {
-      dot.className = 'api-dot err';
-      status.textContent = `Error: ${err.message}`;
-      pre.textContent = JSON.stringify({ error: err.message }, null, 2);
-    }
-  }
 </script>
 </body>
 </html>

package/lib/public/mbkbucket-helper.js

@@ -330,17 +330,9 @@
       }
       return this.uploadSingle(prefix, file, opts);
     },
-
-    getSignedUrl(key, opts) {
-      opts = opts || {};
-      return apiFetch(buildUrl(`${BASE}/api/signed-url`, {
-        key,
-        bucket: opts.bucket || '',
-        expiresIn: opts.expiresIn || 3600,
-      }));
-    },
   };
 
+
   // ─────────────────────────────────────────────────────────────────────────
   // Gallery Modal (with In-Modal Upload & Multi-Select)
   // ─────────────────────────────────────────────────────────────────────────

package/lib/src/app.js

@@ -7,17 +7,15 @@
 
 import express from "express";
 import path from "path";
-import fs from "fs";
 import { fileURLToPath } from "url";
-import { engine } from "express-handlebars";
 import compression from "compression";
 import mbkautheRoutes from "mbkauthe";
+import { setupViewEngine } from "mbkutils";
 import { generalLimiter } from "./middleware/rate-limiter.js";
 import { notFoundHandler, globalErrorHandler } from "./middleware/error-handler.js";
 import bucketRoutes from "./routes/index.js";
 import { packageJson } from "./config/index.js";
 import { createLogger } from "#logger";
-import { commonHandlebarsHelpers } from "./utils/helpers.js";
 
 const debugServer = createLogger('server');
 const __filename = fileURLToPath(import.meta.url);
@@ -50,41 +48,29 @@ export function createApp() {
   const libDir = path.resolve(__dirname, "..");
   const cwd = process.cwd();
 
-  const viewDirs = [
-    path.join(rootDir, "views"),
+  const additionalViewsDirs = [
     path.join(libDir, "views"),
-    path.join(rootDir, "node_modules", "mbkauthe", "views"),
     path.resolve(cwd, "views"),
-    path.resolve(cwd, "node_modules", "mbkauthe", "views"),
-  ].filter(dir => fs.existsSync(dir));
+  ];
 
-  const partialsDir = [
-    path.join(rootDir, "views", "templates"),
-    path.join(rootDir, "views", "templates", "notice"),
-    path.join(rootDir, "views"),
+  const additionalPartialsDirs = [
     path.join(rootDir, "views", "partial"),
     path.join(libDir, "views", "templates"),
     path.join(libDir, "views", "templates", "notice"),
     path.join(libDir, "views"),
     path.join(libDir, "views", "partial"),
-    path.join(rootDir, "node_modules", "mbkauthe", "views"),
-    path.resolve(cwd, "node_modules", "mbkauthe", "views"),
-  ].filter(dir => fs.existsSync(dir));
+  ];
 
   // Handlebars template engine
-  server.engine("hbs", engine({
-    extname: ".hbs",
+  setupViewEngine(server, {
+    rootDir,
     defaultLayout: false,
-    partialsDir: [...new Set(partialsDir)],
-    cache: process.env.NODE_ENV === "production",
+    additionalViewsDirs,
+    additionalPartialsDirs,
     helpers: {
-      ...commonHandlebarsHelpers,
       mbkbucket_cachebuster: () => `?v=${packageJson.version}`
     }
-  }));
-
-  server.set("view engine", "hbs");
-  server.set("views", [...new Set(viewDirs)]);
+  });
 
   server.use(mbkautheRoutes);
   server.use(generalLimiter);

package/lib/src/config/validation.js

@@ -63,8 +63,12 @@ export function parseAndValidateBucketConnection(rawValue) {
     }
 
     const providerType = String(config.type || config.provider || '').toLowerCase();
+    const isLocal = providerType === 'local' || providerType === 'fs' || providerType === 'filesystem' || Boolean(config.basePath || config.rootPath || config.directory);
 
-    if (providerType === 'gdrive' || providerType === 'google-drive' || providerType === 'googledrive') {
+    if (isLocal) {
+      // Local filesystem provider needs no cloud credentials, basePath is optional (defaults to ./mbkbucket_storage)
+      continue;
+    } else if (providerType === 'gdrive' || providerType === 'google-drive' || providerType === 'googledrive') {
       const hasOAuth = Boolean(config.client_id && config.client_secret && (config.refresh_token || config.access_token || config.code));
       const hasServiceAccount = Boolean((config.client_email || config.service_account_email) && (config.private_key || config.service_account_key));
       const hasAccessTokenOnly = Boolean(config.access_token);
@@ -80,6 +84,7 @@ export function parseAndValidateBucketConnection(rawValue) {
         throw new Error(`Bucket '${bucketName}' is missing required fields: ${missingFields.join(', ')}`);
       }
     }
+
   }
 
   return parsed;