mbkbucket 4.0.0 → 4.1.0

package/lib/src/routes/api.routes.js

@@ -2,7 +2,7 @@ import express from "express";
 import { sessRole } from "mbkauthe";
 import multer from "multer";
 import { requireBucketApi } from "../middleware/bucket-resolver.js";
-import { cleanupUploads, listIncompleteUploads, listFiles, uploadSingleFile, initiateMultipartUpload, uploadChunk, completeUpload, abortUpload, createFolder, deleteItems, downloadFileHandler, moveItem, copyItem, getHealthStatus, getFileInfo } from "../controllers/api.controller.js";
+import { cleanupUploads, listIncompleteUploads, listFiles, uploadSingleFile, initiateMultipartUpload, uploadChunk, completeUpload, abortUpload, createFolder, deleteItems, downloadFileHandler, moveItem, copyItem, getHealthStatus, getFileInfo, getMetricsHandler } from "../controllers/api.controller.js";
 
 const MAX_CHUNK_SIZE = 50 * 1024 * 1024; // 50 MB
 const upload = multer({ storage: multer.memoryStorage(), limits: { fileSize: MAX_CHUNK_SIZE } });
@@ -38,6 +38,8 @@ export function createApiRoutes({
   apiRouter.get('/api/files', viewAuth, listFiles);
   apiRouter.get('/api/health', viewAuth, getHealthStatus);
   apiRouter.get('/api/file-info/*key', viewAuth, getFileInfo);
+  apiRouter.get('/api/metrics', viewAuth, getMetricsHandler);
+  apiRouter.get('/metrics', viewAuth, getMetricsHandler);
   apiRouter.post('/upload', uploadAuth, upload.single('file'), uploadSingleFile);
   apiRouter.post('/upload-init', uploadAuth, initiateMultipartUpload);
   apiRouter.post('/upload-chunk', uploadAuth, uploadChunkMiddleware, uploadChunk);
@@ -52,6 +54,7 @@ export function createApiRoutes({
   return apiRouter;
 }
 
+
 const router = createApiRoutes();
 
 export default router;

package/lib/src/routes/index.js

@@ -1,60 +1,60 @@
-/**
- * MBKBucket
- * Copyright (c) 2026 Muhammad Bin Khalid, MBKTech.org and contributors
- * Licensed under the MIT License.
- * Source: https://github.com/MIbnEKhalid/mbkbucket
- */
-
-import express from "express";
-import { sessRole } from "mbkauthe";
-import path from "path";
-import { fileURLToPath } from "url";
-import { bucketResolver } from "../middleware/bucket-resolver.js";
-import { renderBucketDashboard } from "../controllers/dashboard.controller.js";
-import infoRoutes from "./info.routes.js";
-import { createViewRoutes } from "./view.routes.js";
-import { createApiRoutes } from "./api.routes.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const publicDir = path.resolve(__dirname, "..", "..", "public");
-
-const serveAsset = (filename) => (_req, res) => {
-  res.set("Cache-Control", "public, max-age=300, must-revalidate");
-  res.sendFile(path.join(publicDir, filename), (err) => {
-    if (err) res.status(err.status || 404).end();
-  });
-};
-
-export function createBucketRouter({ authorization, publiViewEnabled } = {}) {
-  const router = express.Router();
-  const defaultAuth = sessRole('superadmin');
-  const auths = typeof authorization === 'function'
-    ? { view: authorization, upload: authorization, delete: authorization }
-    : authorization ?? {};
-  const viewAuth = auths.view ?? defaultAuth;
-  const uploadAuth = auths.upload ?? defaultAuth;
-  const deleteAuth = auths.delete ?? defaultAuth;
-
-  // Static dashboard & helper assets
-  router.get('/mbkbucket/bucketadmin.css', serveAsset('bucketadmin.css'));
-  router.get('/mbkbucket/bucketadmin.js', serveAsset('bucketadmin.js'));
-  router.get('/mbkbucket/mbkbucket-helper.css', serveAsset('mbkbucket-helper.css'));
-  router.get('/mbkbucket/mbkbucket-helper.js', serveAsset('mbkbucket-helper.js'));
-  router.get('/mbkbucket/helper-demo', serveAsset('mbkbucket-helper-demo.html'));
-
-  router.get('/mbkbucket', viewAuth, renderBucketDashboard);
-  router.use(
-    '/mbkbucket',
-    bucketResolver,
-    infoRoutes,
-    createViewRoutes({ authorization: viewAuth, publiViewEnabled }),
-    createApiRoutes({ viewAuthorization: viewAuth, uploadAuthorization: uploadAuth, deleteAuthorization: deleteAuth })
-  );
-
-  return router;
-}
-
-const router = createBucketRouter();
-
-export default router;
+/**
+ * MBKBucket
+ * Copyright (c) 2026 Muhammad Bin Khalid, MBKTech.org and contributors
+ * Licensed under the MIT License.
+ * Source: https://github.com/MIbnEKhalid/mbkbucket
+ */
+
+import express from "express";
+import { sessRole } from "mbkauthe";
+import path from "path";
+import { fileURLToPath } from "url";
+import { bucketResolver } from "../middleware/bucket-resolver.js";
+import { renderBucketDashboard } from "../controllers/dashboard.controller.js";
+import infoRoutes from "./info.routes.js";
+import { createViewRoutes } from "./view.routes.js";
+import { createApiRoutes } from "./api.routes.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const publicDir = path.resolve(__dirname, "..", "..", "public");
+
+const serveAsset = (filename) => (_req, res) => {
+  res.set("Cache-Control", "public, max-age=300, must-revalidate");
+  res.sendFile(path.join(publicDir, filename), (err) => {
+    if (err) res.status(err.status || 404).end();
+  });
+};
+
+export function createBucketRouter({ authorization, publiViewEnabled } = {}) {
+  const router = express.Router();
+  const defaultAuth = sessRole('superadmin');
+  const auths = typeof authorization === 'function'
+    ? { view: authorization, upload: authorization, delete: authorization }
+    : authorization ?? {};
+  const viewAuth = auths.view ?? defaultAuth;
+  const uploadAuth = auths.upload ?? defaultAuth;
+  const deleteAuth = auths.delete ?? defaultAuth;
+
+  // Static dashboard & helper assets
+  router.get('/mbkbucket/bucketadmin.css', serveAsset('bucketadmin.css'));
+  router.get('/mbkbucket/bucketadmin.js', serveAsset('bucketadmin.js'));
+  router.get('/mbkbucket/mbkbucket-helper.css', serveAsset('mbkbucket-helper.css'));
+  router.get('/mbkbucket/mbkbucket-helper.js', serveAsset('mbkbucket-helper.js'));
+  router.get('/mbkbucket/helper-demo', serveAsset('mbkbucket-helper-demo.html'));
+
+  router.get('/mbkbucket', viewAuth, renderBucketDashboard);
+  router.use(
+    '/mbkbucket',
+    bucketResolver,
+    infoRoutes,
+    createViewRoutes({ authorization: viewAuth, publiViewEnabled }),
+    createApiRoutes({ viewAuthorization: viewAuth, uploadAuthorization: uploadAuth, deleteAuthorization: deleteAuth })
+  );
+
+  return router;
+}
+
+const router = createBucketRouter();
+
+export default router;

package/lib/src/routes/view.routes.js

@@ -1,28 +1,28 @@
-import express from "express";
-import { sessRole } from "mbkauthe";
-import { mbkbucketVar } from "../config/index.js";
-import { requireBucketView } from "../middleware/bucket-resolver.js";
-import { pviewRateLimit } from "../middleware/rate-limiter.js";
-import { pviewSecurity } from "../middleware/security.js";
-import { viewFile, playerPage, publicView } from "../controllers/view.controller.js";
-
-export function createViewRoutes({
-  authorization = sessRole('superadmin'),
-  publiViewEnabled = mbkbucketVar?.publiView_enabled
-} = {}) {
-  const viewRouter = express.Router();
-
-  viewRouter.use(requireBucketView);
-  viewRouter.get('/player/*key', authorization, playerPage);
-  viewRouter.get('/view/*key', authorization, viewFile);
-
-  if (publiViewEnabled ?? mbkbucketVar?.publiView_enabled) {
-    viewRouter.get('/p_view/*key', pviewRateLimit, pviewSecurity, publicView);
-  }
-
-  return viewRouter;
-}
-
-const router = createViewRoutes();
-
-export default router;
+import express from "express";
+import { sessRole } from "mbkauthe";
+import { mbkbucketVar } from "../config/index.js";
+import { requireBucketView } from "../middleware/bucket-resolver.js";
+import { pviewRateLimit } from "../middleware/rate-limiter.js";
+import { pviewSecurity } from "../middleware/security.js";
+import { viewFile, playerPage, publicView } from "../controllers/view.controller.js";
+
+export function createViewRoutes({
+  authorization = sessRole('superadmin'),
+  publiViewEnabled = mbkbucketVar?.publiView_enabled
+} = {}) {
+  const viewRouter = express.Router();
+
+  viewRouter.use(requireBucketView);
+  viewRouter.get('/player/*key', authorization, playerPage);
+  viewRouter.get('/view/*key', authorization, viewFile);
+
+  if (publiViewEnabled ?? mbkbucketVar?.publiView_enabled) {
+    viewRouter.get('/p_view/*key', pviewRateLimit, pviewSecurity, publicView);
+  }
+
+  return viewRouter;
+}
+
+const router = createViewRoutes();
+
+export default router;

package/lib/src/services/s3.service.js

@@ -1,42 +1,42 @@
-/**
- * MBKBucket - S3 Service Compatibility Layer
- * Copyright (c) 2026 Muhammad Bin Khalid, MBKTech.org and contributors
- * Licensed under the MIT License.
- * 
- * Provides backwards-compatible S3 APIs delegating to the unified storage layer.
- */
-
-import { storageManager } from "../core/storage/storage-manager.js";
-import { getAvailableBucketNames, resolveBucketName, getAppName, ensureKeyHasAppPrefix, ensurePrefix, uploadFile, downloadFile, deleteFile, deleteFiles, deleteFolder, listfiles, getFileMetadata, fileExists, getFileSize, generateSignedUrl, createMultipartUpload, uploadPart, completeMultipartUpload, abortMultipartUpload, listIncompleteMultipartUploads, cleanupIncompleteMultipartUploads, checkHealth, runHealthCheck } from "./storage.service.js";
-
-export { getAvailableBucketNames, resolveBucketName, getAppName, ensureKeyHasAppPrefix, ensurePrefix, uploadFile, downloadFile, deleteFile, deleteFiles, deleteFolder, listfiles, getFileMetadata, fileExists, getFileSize, generateSignedUrl, createMultipartUpload, uploadPart, completeMultipartUpload, abortMultipartUpload, listIncompleteMultipartUploads, cleanupIncompleteMultipartUploads, checkHealth, runHealthCheck };
-
-export function getBucketConfig(bucketName) {
-  return storageManager.getConnectionConfig(bucketName);
-}
-
-export function getBucketClient(bucketName) {
-  const provider = storageManager.getProvider(bucketName);
-  if (provider.client) {
-    return provider.client;
-  }
-  throw new Error(`Connection '${provider.name}' is of type '${provider.type}' and does not use an S3Client.`);
-}
-
-export function getBucketClientAndConfig(bucketName) {
-  const resolved = resolveBucketName(bucketName);
-  return {
-    client: getBucketClient(resolved),
-    config: getBucketConfig(resolved),
-    bucketName: resolved
-  };
-}
-
-let _defaultClient = null;
-export const bucketClient = new Proxy({}, {
-  get(_, prop) {
-    _defaultClient ??= getBucketClient();
-    const val = _defaultClient[prop];
-    return typeof val === 'function' ? val.bind(_defaultClient) : val;
-  }
-});
+/**
+ * MBKBucket - S3 Service Compatibility Layer
+ * Copyright (c) 2026 Muhammad Bin Khalid, MBKTech.org and contributors
+ * Licensed under the MIT License.
+ * 
+ * Provides backwards-compatible S3 APIs delegating to the unified storage layer.
+ */
+
+import { storageManager } from "../core/storage/storage-manager.js";
+import { getAvailableBucketNames, resolveBucketName, getAppName, ensureKeyHasAppPrefix, ensurePrefix, uploadFile, downloadFile, deleteFile, deleteFiles, deleteFolder, listfiles, getFileMetadata, fileExists, getFileSize, createMultipartUpload, uploadPart, completeMultipartUpload, abortMultipartUpload, listIncompleteMultipartUploads, cleanupIncompleteMultipartUploads, checkHealth, runHealthCheck } from "./storage.service.js";
+
+export { getAvailableBucketNames, resolveBucketName, getAppName, ensureKeyHasAppPrefix, ensurePrefix, uploadFile, downloadFile, deleteFile, deleteFiles, deleteFolder, listfiles, getFileMetadata, fileExists, getFileSize, createMultipartUpload, uploadPart, completeMultipartUpload, abortMultipartUpload, listIncompleteMultipartUploads, cleanupIncompleteMultipartUploads, checkHealth, runHealthCheck };
+
+export function getBucketConfig(bucketName) {
+  return storageManager.getConnectionConfig(bucketName);
+}
+
+export function getBucketClient(bucketName) {
+  const provider = storageManager.getProvider(bucketName);
+  if (provider.client) {
+    return provider.client;
+  }
+  throw new Error(`Connection '${provider.name}' is of type '${provider.type}' and does not use an S3Client.`);
+}
+
+export function getBucketClientAndConfig(bucketName) {
+  const resolved = resolveBucketName(bucketName);
+  return {
+    client: getBucketClient(resolved),
+    config: getBucketConfig(resolved),
+    bucketName: resolved
+  };
+}
+
+let _defaultClient = null;
+export const bucketClient = new Proxy({}, {
+  get(_, prop) {
+    _defaultClient ??= getBucketClient();
+    const val = _defaultClient[prop];
+    return typeof val === 'function' ? val.bind(_defaultClient) : val;
+  }
+});