@valentinkolb/filegate 2.1.0 → 2.2.0

package/README.md

@@ -311,6 +311,9 @@ const client = new Filegate({
 // Get file or directory info
 await client.info({ path: "/data/file.txt", showHidden: false });
 
+// Get directory info with recursive sizes (slower)
+await client.info({ path: "/data/uploads", computeSizes: true });
+
 // Download file (returns streaming Response)
 await client.download({ path: "/data/file.txt" });
 
@@ -450,7 +453,7 @@ All `/files/*` endpoints require `Authorization: Bearer <token>`.
 | GET | `/docs` | OpenAPI documentation (Scalar UI) |
 | GET | `/openapi.json` | OpenAPI specification |
 | GET | `/llms.txt` | LLM-friendly markdown documentation |
-| GET | `/files/info` | Get file or directory info |
+| GET | `/files/info` | Get file or directory info. Use `?computeSizes=true` for recursive dir sizes |
 | GET | `/files/content` | Download file or directory (TAR). Use `?inline=true` to view in browser |
 | PUT | `/files/content` | Upload file |
 | POST | `/files/mkdir` | Create directory |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valentinkolb/filegate",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "type": "module",
   "license": "MIT",
   "repository": {

package/src/client.ts

@@ -33,6 +33,8 @@ export interface ClientOptions {
 export interface InfoOptions {
   path: string;
   showHidden?: boolean;
+  /** If true, compute recursive sizes for directories (slower, default: false) */
+  computeSizes?: boolean;
 }
 
 // --- Download ---
@@ -243,6 +245,7 @@ export class Filegate {
       path: opts.path,
       showHidden: String(opts.showHidden ?? false),
     });
+    if (opts.computeSizes) params.set("computeSizes", "true");
     const res = await this._fetch(`${this.url}/files/info?${params}`, { headers: this.hdrs() });
     return this.handleResponse(res);
   }

package/src/handlers/files.ts

@@ -108,7 +108,7 @@ app.get(
   }),
   v("query", InfoQuerySchema),
   async (c) => {
-    const { path, showHidden } = c.req.valid("query");
+    const { path, showHidden, computeSizes } = c.req.valid("query");
 
     const result = await validatePath(path, { allowBasePath: true });
     if (!result.ok) return c.json({ error: result.error }, result.status);
@@ -126,17 +126,17 @@ app.get(
 
     const entries = await readdir(result.realPath, { withFileTypes: true });
 
-    // Parallel file info retrieval
+    // Parallel file info retrieval (computeSizes only when requested)
     const items = (
       await Promise.all(
         entries
           .filter((e) => showHidden || !e.name.startsWith("."))
-          .map((e) => getFileInfo(join(result.realPath, e.name), result.realPath, true).catch(() => null)),
+          .map((e) => getFileInfo(join(result.realPath, e.name), result.realPath, computeSizes).catch(() => null)),
       )
     ).filter((item): item is FileInfo => item !== null);
 
     const info = await getFileInfo(result.realPath);
-    const totalSize = items.reduce((sum, item) => sum + item.size, 0);
+    const totalSize = computeSizes ? items.reduce((sum, item) => sum + item.size, 0) : 0;
     return c.json({ ...info, size: totalSize, items, total: items.length });
   },
 );

package/src/schemas.ts

@@ -58,6 +58,11 @@ export const InfoQuerySchema = z
       .optional()
       .transform((v) => v === "true")
       .describe("If 'true', include hidden files (starting with dot) in directory listings"),
+    computeSizes: z
+      .string()
+      .optional()
+      .transform((v) => v === "true")
+      .describe("If 'true', compute recursive sizes for directories (slower, default: false)"),
   })
   .describe("Query parameters for file/directory info");