@muhgholy/next-drive 3.2.1 → 3.2.2

package/README.md

@@ -339,6 +339,87 @@ await ffmpeg(path).format("mp4").save("output.mp4");
 
 > Google Drive files are automatically downloaded to local cache.
 
+### List Files and Folders
+
+List files and folders in a directory:
+
+```typescript
+import { driveList } from "@muhgholy/next-drive/server";
+
+// List root folder
+const items = await driveList({ key: { userId: "123" } });
+
+// List specific folder
+const items = await driveList({
+	key: { userId: "123" },
+	folderId: "folderIdHere",
+	limit: 50,
+});
+
+// Pagination
+const items = await driveList({
+	key: { userId: "123" },
+	folderId: "root",
+	limit: 20,
+	afterId: "lastItemId",
+});
+```
+
+**Options:**
+
+| Option      | Type                      | Required | Description                                    |
+| ----------- | ------------------------- | -------- | ---------------------------------------------- |
+| `key`       | `Record<string, unknown>` | Yes      | Owner key (must match authenticated user)      |
+| `folderId`  | `string \| null`          | No       | Folder ID to list (null or 'root' for root)    |
+| `accountId` | `string`                  | No       | Storage account ID ('LOCAL' for local storage) |
+| `limit`     | `number`                  | No       | Maximum items to return (default: 100)         |
+| `afterId`   | `string`                  | No       | Last item ID for pagination                    |
+
+### Delete File or Folder
+
+Permanently delete a file or folder from the drive system:
+
+```typescript
+import { driveDelete } from "@muhgholy/next-drive/server";
+
+// Delete a file
+await driveDelete("694f5013226de007be94fcc0");
+
+// Delete a folder recursively (default behavior)
+await driveDelete(folderId, { recurse: true });
+
+// Delete only if folder is empty
+try {
+	await driveDelete(folderId, { recurse: false });
+} catch (error) {
+	// Throws error if folder contains items
+	console.error("Cannot delete non-empty folder");
+}
+
+// Delete using database document
+const drive = await Drive.findById(fileId);
+await driveDelete(drive);
+
+// Delete using TDatabaseDrive object
+const items = await driveList({ key: { userId: "123" } });
+await driveDelete(items[0]);
+```
+
+**Parameters:**
+
+| Parameter | Type                                                 | Description                            |
+| --------- | ---------------------------------------------------- | -------------------------------------- |
+| `source`  | `string \| IDatabaseDriveDocument \| TDatabaseDrive` | File/folder ID or object to delete     |
+| `options` | `{ recurse?: boolean }`                              | Delete options (default: recurse=true) |
+
+**Options:**
+
+| Option    | Type      | Default | Description                                                                               |
+| --------- | --------- | ------- | ----------------------------------------------------------------------------------------- |
+| `recurse` | `boolean` | `true`  | If true, deletes folder and all children. If false, throws error if folder contains items |
+
+> **Note:** This permanently deletes the file/folder. For soft deletion (trash), use the `trash` API action instead.
+
 ---
 
 ## Configuration Options

package/dist/{chunk-F5ZVJGYN.js → chunk-WSOFHT7J.js}

@@ -946,6 +946,65 @@ var driveFilePath = async (file) => {
   }
   throw new Error(`Unsupported provider: ${providerType}`);
 };
+var driveList = async (options) => {
+  const { key, folderId, accountId, limit = 100, afterId } = options;
+  let providerName = "LOCAL";
+  if (accountId && accountId !== "LOCAL") {
+    const account = await drive_default.db.model("StorageAccount").findOne({ _id: accountId, owner: key });
+    if (!account) {
+      throw new Error("Invalid Storage Account");
+    }
+    if (account.metadata.provider === "GOOGLE") {
+      providerName = "GOOGLE";
+    }
+  }
+  const query = {
+    owner: key,
+    "provider.type": providerName,
+    storageAccountId: accountId || null,
+    parentId: folderId === "root" || !folderId ? null : folderId,
+    trashedAt: null
+  };
+  if (afterId) {
+    query._id = { $lt: afterId };
+  }
+  const items = await drive_default.find(query, {}, { sort: { order: 1, _id: -1 }, limit });
+  return await Promise.all(items.map((item) => item.toClient()));
+};
+var driveDelete = async (source, options) => {
+  const { recurse = true } = options || {};
+  let drive;
+  let driveId;
+  if (typeof source === "string") {
+    const doc = await drive_default.findById(source);
+    if (!doc) throw new Error(`File not found: ${source}`);
+    drive = doc;
+    driveId = source;
+  } else if ("toClient" in source) {
+    drive = source;
+    driveId = String(drive._id);
+  } else {
+    const doc = await drive_default.findById(source.id);
+    if (!doc) throw new Error(`File not found: ${source.id}`);
+    drive = doc;
+    driveId = source.id;
+  }
+  if (drive.information.type === "FOLDER" && !recurse) {
+    const owner2 = drive.owner;
+    const childCount = await drive_default.countDocuments({
+      owner: owner2,
+      parentId: driveId,
+      trashedAt: null
+    });
+    if (childCount > 0) {
+      throw new Error(`Cannot delete folder: it contains ${childCount} item(s). Use recurse: true to delete folder and all its contents.`);
+    }
+  }
+  const provider = drive.provider?.type === "GOOGLE" ? GoogleDriveProvider : LocalStorageProvider;
+  const accountId = drive.storageAccountId?.toString();
+  const owner = drive.owner;
+  await provider.delete([driveId], owner, accountId);
+};
 var driveUpload = async (source, key, options) => {
   const config = getDriveConfig();
   let provider = LocalStorageProvider;
@@ -1657,6 +1716,6 @@ var driveAPIHandler = async (req, res) => {
   }
 };
 
-export { driveAPIHandler, driveConfiguration, driveFilePath, driveFileSchemaZod, driveGetUrl, driveReadFile, driveUpload, getDriveConfig, getDriveInformation };
-//# sourceMappingURL=chunk-F5ZVJGYN.js.map
-//# sourceMappingURL=chunk-F5ZVJGYN.js.map
+export { driveAPIHandler, driveConfiguration, driveDelete, driveFilePath, driveFileSchemaZod, driveGetUrl, driveList, driveReadFile, driveUpload, getDriveConfig, getDriveInformation };
+//# sourceMappingURL=chunk-WSOFHT7J.js.map
+//# sourceMappingURL=chunk-WSOFHT7J.js.map