@muhgholy/next-drive 4.22.0 → 4.23.1

package/README.md

@@ -461,6 +461,66 @@ const items = await driveList({
 | `limit`     | `number`                  | No       | Maximum items to return (default: 100)         |
 | `afterId`   | `string`                  | No       | Last item ID for pagination                    |
 
+### List Files (Paginated)
+
+List **files only** (not folders) with offset-based pagination:
+
+```typescript
+import { driveListFiles } from "@muhgholy/next-drive/server";
+
+// List all files (page 1, default limit 50)
+const result = await driveListFiles({});
+
+// List files for a specific owner
+const result = await driveListFiles({ key: { userId: "123" } });
+
+// List files in a folder with pagination
+const result = await driveListFiles({
+	key: { userId: "123" },
+	folderId: "folderIdHere",
+	page: 2,
+	limit: 20,
+});
+
+// Access pagination info
+console.log(result.pagination);
+// { page: 2, limit: 20, totalCount: 87, totalPages: 5, hasMore: true }
+```
+
+**Options:**
+
+| Option      | Type                       | Required | Description                                    |
+| ----------- | -------------------------- | -------- | ---------------------------------------------- |
+| `key`       | `Record<string, unknown>`  | No       | Owner key (omit to list all files)             |
+| `folderId`  | `string \| null`           | No       | Folder ID (null/'root' for root, omit for all) |
+| `accountId` | `string`                   | No       | Storage account ID                             |
+| `page`      | `number`                   | No       | Page number (default: 1)                       |
+| `limit`     | `number`                   | No       | Items per page (default: 50, max: 100)         |
+
+**Returns:** `{ items: TDatabaseDrive[], pagination: { page, limit, totalCount, totalPages, hasMore } }`
+
+### Direct Database Access
+
+For custom queries, use the exposed Mongoose model:
+
+```typescript
+import { DatabaseMongoDrive } from "@muhgholy/next-drive/server";
+import type { IDatabaseDriveDocument } from "@muhgholy/next-drive/server";
+
+// Custom query
+const files = await DatabaseMongoDrive.find({
+	owner: { userId: "123" },
+	"information.type": "FILE",
+	"information.mime": { $regex: "^image/" },
+});
+
+// Aggregation
+const stats = await DatabaseMongoDrive.aggregate([
+	{ $match: { owner: { userId: "123" }, trashedAt: null } },
+	{ $group: { _id: "$information.type", count: { $sum: 1 } } },
+]);
+```
+
 ### Delete File or Folder
 
 Permanently delete a file or folder from the drive system:

package/dist/{chunk-EUAHSB2J.cjs → chunk-BGCV4Y2V.cjs}

@@ -1464,6 +1464,51 @@ var driveList = async (options) => {
   const items = await drive_default.find(query, {}, { sort: { order: 1, _id: -1 }, limit });
   return await Promise.all(items.map((item) => item.toClient()));
 };
+var driveListFiles = async (options) => {
+  const { key, folderId, accountId } = options;
+  const page = Math.max(1, options.page ?? 1);
+  const limit = Math.min(Math.max(1, options.limit ?? 50), 100);
+  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 = {
+    "provider.type": providerName,
+    "information.type": "FILE",
+    storageAccountId: accountId || null,
+    trashedAt: null
+  };
+  if (key !== void 0) {
+    query.owner = key;
+  }
+  if (folderId && folderId !== "root") {
+    query.parentId = folderId;
+  } else if (folderId === "root" || folderId === null) {
+    query.parentId = null;
+  }
+  const skip = (page - 1) * limit;
+  const [totalCount, items] = await Promise.all([
+    drive_default.countDocuments(query),
+    drive_default.find(query, {}, { sort: { createdAt: -1 }, skip, limit })
+  ]);
+  const totalPages = Math.ceil(totalCount / limit);
+  return {
+    items: await Promise.all(items.map((item) => item.toClient())),
+    pagination: {
+      page,
+      limit,
+      totalCount,
+      totalPages,
+      hasMore: page < totalPages
+    }
+  };
+};
 var driveDelete = async (source, options) => {
   const { recurse = true } = options || {};
   let drive;
@@ -2425,9 +2470,11 @@ exports.driveFileSchemaZod = driveFileSchemaZod;
 exports.driveGetUrl = driveGetUrl;
 exports.driveInfo = driveInfo;
 exports.driveList = driveList;
+exports.driveListFiles = driveListFiles;
 exports.driveReadFile = driveReadFile;
 exports.driveUpload = driveUpload;
+exports.drive_default = drive_default;
 exports.getDriveConfig = getDriveConfig;
 exports.getDriveInformation = getDriveInformation;
-//# sourceMappingURL=chunk-EUAHSB2J.cjs.map
-//# sourceMappingURL=chunk-EUAHSB2J.cjs.map
+//# sourceMappingURL=chunk-BGCV4Y2V.cjs.map
+//# sourceMappingURL=chunk-BGCV4Y2V.cjs.map