@muhgholy/next-drive 4.10.1 → 4.12.0

package/README.md

@@ -90,6 +90,9 @@ import "@muhgholy/next-drive/client/styles.css";
 
 Create `lib/drive.ts` to configure storage, security, and authentication:
 
+> [!IMPORTANT]
+> You **must** connect to your database (e.g., Mongoose) **before** calling `driveConfiguration`. The configuration initialization will fail if the database connection is not ready.
+
 ```typescript
 // lib/drive.ts
 import { driveConfiguration } from "@muhgholy/next-drive/server";
@@ -540,6 +543,40 @@ cors: {
 
 > When `credentials: true`, you must specify explicit origins (not `'*'`).
 
+### Drive Modes
+
+Next Drive supports two operation modes:
+
+1.  **NORMAL** (Default): Requires `information` callback to identify the user and set quota. Enforces security limits.
+2.  **ROOT**: System/Admin mode. No authentication required by default (unless you provide `information`).
+
+> [!WARNING]
+> In both modes, ensure your database connection is active before initializing the configuration.
+
+**Root Mode Configuration:**
+
+```typescript
+driveConfiguration({
+    mode: 'ROOT', // Enable root mode
+    database: 'MONGOOSE',
+    apiUrl: '/api/drive',
+    storage: { path: '/var/data/drive' },
+    // Optional: Security defaults to 10GB limit and all mime types if omitted
+    security: {
+        maxUploadSizeInBytes: 10 * 1024 * 1024 * 1024, // 10GB
+        allowedMimeTypes: ['*/*']
+    }
+});
+```
+
+**Key differences in ROOT mode:**
+- `information` callback is **optional**.
+- If `information` is omitted:
+    - `key` is `null` (files owned by system).
+    - `quota` is unlimited.
+- Default `security.maxUploadSizeInBytes` is **10GB**.
+- Default `security.allowedMimeTypes` is `['*/*']` (all files allowed).
+
 ---
 
 ## Google Drive Integration

package/dist/client/file-chooser.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { TDriveFile } from '../types/client';
 export declare const DriveFileChooser: (props: Readonly<{
-    value: TDriveFile | TDriveFile[] | null;
+    value?: TDriveFile | TDriveFile[] | null;
     onChange: (files: TDriveFile | TDriveFile[] | null) => void;
     multiple?: boolean;
     accept?: string;

package/dist/client/file-chooser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-chooser.d.ts","sourceRoot":"","sources":["../../src/client/file-chooser.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAoD,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAuWjD,eAAO,MAAM,gBAAgB,GAAI,OAAO,QAAQ,CAAC;IAC7C,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC,sBAgLD,CAAC"}
+{"version":3,"file":"file-chooser.d.ts","sourceRoot":"","sources":["../../src/client/file-chooser.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAoD,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAuWjD,eAAO,MAAM,gBAAgB,GAAI,OAAO,QAAQ,CAAC;IAC7C,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC,sBAgLD,CAAC"}

package/dist/client/index.cjs

@@ -3044,7 +3044,7 @@ var MobileSidebarSheet = () => {
 };
 var DriveFileChooser = (props) => {
   const {
-    value,
+    value = null,
     onChange,
     multiple = false,
     accept,
@@ -3109,10 +3109,10 @@ var DriveFileChooser = (props) => {
     ) : (
       /* Selected Files Display */
       /* @__PURE__ */ jsxRuntime.jsxs("div", { className: chunkTA6L5FYG_cjs.cn("nd:rounded-lg nd:border", error ? "nd:border-destructive" : "nd:border-border", disabled && "nd:opacity-50"), children: [
-        !multiple && displayFiles[0] && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "nd:flex nd:items-center nd:gap-3 nd:p-2.5", children: [
-          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "nd:size-12 nd:rounded-lg nd:overflow-hidden nd:bg-muted/30 nd:flex nd:items-center nd:justify-center nd:shrink-0", children: displayFiles[0].file.mime.startsWith("image/") ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: createUrl(displayFiles[0]), alt: displayFiles[0].file.name, className: "nd:size-full nd:object-cover" }) : chunkTA6L5FYG_cjs.getFileIcon(displayFiles[0].file.mime, false, "nd:size-6 nd:text-muted-foreground") }),
+        !multiple && displayFiles[0] && displayFiles[0].file && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "nd:flex nd:items-center nd:gap-3 nd:p-2.5", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "nd:size-12 nd:rounded-lg nd:overflow-hidden nd:bg-muted/30 nd:flex nd:items-center nd:justify-center nd:shrink-0", children: displayFiles[0].file.mime?.startsWith("image/") ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: createUrl(displayFiles[0]), alt: displayFiles[0].file.name || "", className: "nd:size-full nd:object-cover" }) : chunkTA6L5FYG_cjs.getFileIcon(displayFiles[0].file.mime || "", false, "nd:size-6 nd:text-muted-foreground") }),
           /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "nd:flex-1 nd:min-w-0", children: [
-            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "nd:text-sm nd:font-medium nd:truncate", children: displayFiles[0].file.name }),
+            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "nd:text-sm nd:font-medium nd:truncate", children: displayFiles[0].file.name || "Unknown" }),
             /* @__PURE__ */ jsxRuntime.jsx("p", { className: "nd:text-xs nd:text-muted-foreground", children: displayFiles[0].file.mime || "File" })
           ] }),
           /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "nd:flex nd:items-center nd:gap-1 nd:shrink-0", children: [
@@ -3133,9 +3133,9 @@ var DriveFileChooser = (props) => {
               !disabled && /* @__PURE__ */ jsxRuntime.jsx(Button, { type: "button", variant: "ghost", size: "sm", className: "nd:h-7 nd:text-xs nd:text-muted-foreground", onClick: () => onChange([]), children: "Clear" })
             ] })
           ] }),
-          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "nd:max-h-40 nd:overflow-y-auto nd:divide-y nd:divide-border/50", children: displayFiles.map((file) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "nd:flex nd:items-center nd:gap-2.5 nd:px-3 nd:py-2 nd:hover:bg-muted/20", children: [
-            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "nd:size-8 nd:rounded nd:overflow-hidden nd:bg-muted/30 nd:flex nd:items-center nd:justify-center nd:shrink-0", children: file.file.mime.startsWith("image/") ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: createUrl(file), alt: file.file.name, className: "nd:size-full nd:object-cover" }) : chunkTA6L5FYG_cjs.getFileIcon(file.file.mime, false, "nd:size-4 nd:text-muted-foreground") }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "nd:flex-1 nd:text-sm nd:truncate", children: file.file.name }),
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "nd:max-h-40 nd:overflow-y-auto nd:divide-y nd:divide-border/50", children: displayFiles.filter((file) => file?.file).map((file) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "nd:flex nd:items-center nd:gap-2.5 nd:px-3 nd:py-2 nd:hover:bg-muted/20", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "nd:size-8 nd:rounded nd:overflow-hidden nd:bg-muted/30 nd:flex nd:items-center nd:justify-center nd:shrink-0", children: file.file.mime?.startsWith("image/") ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: createUrl(file), alt: file.file.name || "", className: "nd:size-full nd:object-cover" }) : chunkTA6L5FYG_cjs.getFileIcon(file.file.mime || "", false, "nd:size-4 nd:text-muted-foreground") }),
+            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "nd:flex-1 nd:text-sm nd:truncate", children: file.file.name || "Unknown" }),
             !disabled && /* @__PURE__ */ jsxRuntime.jsx(Button, { type: "button", variant: "ghost", size: "icon", className: "nd:size-7 nd:shrink-0", onClick: () => handleRemove(file.id), children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { className: "nd:size-3.5" }) })
           ] }, file.id)) })
         ] })