@jk3labs/paperclip-plugin-file-browser 0.2.2 → 0.2.4

package/src/__tests__/file-browser.spec.ts

@@ -0,0 +1,161 @@
+import express from 'express';
+import request from 'supertest';
+import fs from 'fs-extra';
+import path from 'path';
+
+jest.mock('archiver', () => {
+  return jest.fn().mockImplementation(() => {
+    const { PassThrough } = require('stream');
+    const stream = new PassThrough();
+    setTimeout(() => { stream.end(); }, 50);
+    return {
+      pipe: (dest: NodeJS.WritableStream) => { stream.pipe(dest); return dest; },
+      directory: () => {},
+      finalize: jest.fn().mockResolvedValue(undefined),
+    };
+  });
+});
+
+import plugin from '../index';
+
+const mockRootDir = path.join(__dirname, 'mock-root');
+
+function createApp(): express.Express {
+  const app = express();
+  const routers: Array<{ basePath: string; router: express.Router }> = [];
+
+  const context = {
+    addRouter: (basePath: string, router: express.Router) => {
+      routers.push({ basePath, router });
+    },
+    environment: {
+      rootDir: mockRootDir,
+    },
+  };
+
+  plugin.register(context);
+
+  for (const { basePath, router } of routers) {
+    app.use(basePath, router);
+  }
+
+  return app;
+}
+
+describe('File Browser Plugin', () => {
+  let app: express.Express;
+  const mockFilePath = path.join(mockRootDir, 'test.txt');
+  const mockDirPath = path.join(mockRootDir, 'test-dir');
+  const mockNestedFilePath = path.join(mockDirPath, 'nested.txt');
+
+  beforeAll(async () => {
+    await fs.ensureDir(mockRootDir);
+    await fs.writeFile(mockFilePath, 'test content');
+    await fs.ensureDir(mockDirPath);
+    await fs.writeFile(mockNestedFilePath, 'nested content');
+    app = createApp();
+  });
+
+  afterAll(async () => {
+    await fs.remove(mockRootDir);
+  });
+
+  describe('Plugin registration', () => {
+    it('should throw if rootDir is invalid', () => {
+      const badContext = {
+        addRouter: () => {},
+        environment: { rootDir: '/nonexistent/path/that/does/not/exist' },
+      };
+      expect(() => plugin.register(badContext)).toThrow('Invalid root directory');
+    });
+
+    it('should register a router on /files', () => {
+      const registeredPaths: string[] = [];
+      const ctx = {
+        addRouter: (basePath: string) => { registeredPaths.push(basePath); },
+        environment: { rootDir: mockRootDir },
+      };
+      plugin.register(ctx);
+      expect(registeredPaths).toContain('/files');
+    });
+  });
+
+  describe('GET /files/list', () => {
+    it('should list files and directories in root', async () => {
+      const response = await request(app).get('/files/list');
+      expect(response.status).toBe(200);
+      expect(response.body.files).toContain('test.txt');
+      expect(response.body.directories).toContain('test-dir');
+      expect(response.body.currentPath).toBe('');
+    });
+
+    it('should list files and directories in subdirectory', async () => {
+      const response = await request(app).get('/files/list?path=test-dir');
+      expect(response.status).toBe(200);
+      expect(response.body.files).toContain('nested.txt');
+      expect(response.body.directories).toEqual([]);
+    });
+
+    it('should return 404 for non-existent directory', async () => {
+      const response = await request(app).get('/files/list?path=non-existent');
+      expect(response.status).toBe(404);
+    });
+
+    it('should return 403 for path traversal attempt', async () => {
+      const response = await request(app).get('/files/list?path=../../../etc');
+      expect(response.status).toBe(403);
+    });
+  });
+
+  describe('GET /files/download', () => {
+    it('should download a file', async () => {
+      const response = await request(app).get('/files/download?path=test.txt');
+      expect(response.status).toBe(200);
+      expect(response.text).toBe('test content');
+    });
+
+    it('should return 400 when path is missing', async () => {
+      const response = await request(app).get('/files/download');
+      expect(response.status).toBe(400);
+      expect(response.body.error).toBe('Path parameter is required');
+    });
+
+    it('should return 404 for non-existent file', async () => {
+      const response = await request(app).get('/files/download?path=non-existent.txt');
+      expect(response.status).toBe(404);
+    });
+
+    it('should return 403 for path traversal attempt', async () => {
+      const response = await request(app).get('/files/download?path=../../../etc/passwd');
+      expect(response.status).toBe(403);
+    });
+  });
+
+  describe('GET /files/zip', () => {
+    it('should return a zip response for a valid directory', async () => {
+      const response = await request(app).get('/files/zip?path=test-dir');
+      expect(response.status).toBe(200);
+    });
+
+    it('should return 400 when path is missing', async () => {
+      const response = await request(app).get('/files/zip');
+      expect(response.status).toBe(400);
+      expect(response.body.error).toBe('Path parameter is required');
+    });
+
+    it('should return 404 for non-existent directory', async () => {
+      const response = await request(app).get('/files/zip?path=non-existent');
+      expect(response.status).toBe(404);
+    });
+
+    it('should return 404 when path points to a file', async () => {
+      const response = await request(app).get('/files/zip?path=test.txt');
+      expect(response.status).toBe(404);
+    });
+
+    it('should return 403 for path traversal attempt', async () => {
+      const response = await request(app).get('/files/zip?path=../../../etc');
+      expect(response.status).toBe(403);
+    });
+  });
+});

package/src/index.ts

@@ -0,0 +1,128 @@
+import express from 'express';
+import fs from 'fs-extra';
+import path from 'path';
+import archiver from 'archiver';
+
+interface PluginContext {
+  addRouter: (basePath: string, router: express.Router) => void;
+  environment: {
+    rootDir: string;
+  };
+};
+
+const plugin = {
+  id: 'file-browser',
+  name: 'File Browser Plugin',
+  description: 'A plugin to browse, download, and zip files in the Paperclip workspace.',
+  register: (context: PluginContext) => {
+    const router = express.Router();
+    const rootDir = context.environment.rootDir;
+
+    // Validate rootDir exists
+    if (!rootDir || !(fs.existsSync(rootDir))) {
+      throw new Error(`Invalid root directory: ${rootDir}`);
+    }
+
+    router.get('/list', async (req, res) => {
+      try {
+        const relativePath = req.query.path as string || '';
+        const targetPath = path.join(rootDir, relativePath);
+
+        // Security: Ensure targetPath is within rootDir
+        if (!targetPath.startsWith(rootDir)) {
+          return res.status(403).json({ error: 'Access denied' });
+        }
+
+        const entries = await fs.readdir(targetPath, { withFileTypes: true });
+        const files = entries
+          .filter(dirent => dirent.isFile())
+          .map(dirent => dirent.name);
+        const directories = entries
+          .filter(dirent => dirent.isDirectory())
+          .map(dirent => dirent.name);
+
+        res.json({
+          files,
+          directories,
+          currentPath: path.relative(rootDir, targetPath),
+          rootDir
+        });
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const statusCode = (error as NodeJS.ErrnoException).code === 'ENOENT' ? 404 : 500;
+        res.status(statusCode).json({ error: message });
+      }
+    });
+
+    router.get('/download', async (req, res) => {
+      try {
+        const relativePath = req.query.path as string;
+        if (!relativePath) {
+          return res.status(400).json({ error: 'Path parameter is required' });
+        }
+
+        const targetPath = path.join(rootDir, relativePath);
+
+        // Security: Ensure targetPath is within rootDir
+        if (!targetPath.startsWith(rootDir)) {
+          return res.status(403).json({ error: 'Access denied' });
+        }
+
+        // Check if path exists and is a file
+        const stats = await fs.stat(targetPath);
+        if (!stats.isFile()) {
+          return res.status(404).json({ error: 'File not found' });
+        }
+
+        // Stream file for download
+        res.download(targetPath, path.basename(targetPath));
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const statusCode = (error as NodeJS.ErrnoException).code === 'ENOENT' ? 404 : 500;
+        res.status(statusCode).json({ error: message });
+      }
+    });
+
+    router.get('/zip', async (req, res) => {
+      try {
+        const relativePath = req.query.path as string;
+        if (!relativePath) {
+          return res.status(400).json({ error: 'Path parameter is required' });
+        }
+
+        const targetPath = path.join(rootDir, relativePath);
+
+        // Security: Ensure targetPath is within rootDir
+        if (!targetPath.startsWith(rootDir)) {
+          return res.status(403).json({ error: 'Access denied' });
+        }
+
+        // Check if path exists and is a directory
+        const stats = await fs.stat(targetPath);
+        if (!stats.isDirectory()) {
+          return res.status(404).json({ error: 'Directory not found' });
+        }
+
+        // Set headers for ZIP download
+        res.attachment(`${path.basename(targetPath)}.zip`);
+
+        // Create ZIP stream
+        const archive = archiver('zip', {
+          zlib: { level: 9 } // Maximum compression
+        });
+
+        archive.pipe(res);
+        archive.directory(targetPath, false);
+        await archive.finalize();
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const statusCode = (error as NodeJS.ErrnoException).code === 'ENOENT' ? 404 : 500;
+        res.status(statusCode).json({ error: message });
+      }
+    });
+
+    context.addRouter('/files', router);
+  },
+};
+
+export default plugin;

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["jest", "node"]
+  },
+  "include": ["src/**/*", "src/__tests__/**/*"],
+  "exclude": ["node_modules"]
+}

package/dist/manifest.js

@@ -1,89 +0,0 @@
-// src/manifest.ts
-var manifest = {
-  id: "jkl.file-browser",
-  apiVersion: 1,
-  version: "0.2.0",
-  displayName: "File Browser",
-  description: "A file browser plugin for Paperclip workspaces",
-  author: "Plugin Author",
-  categories: ["workspace"],
-  capabilities: [
-    "events.subscribe",
-    "plugin.state.read",
-    "plugin.state.write",
-    "local.folders",
-    "ui.dashboardWidget.register",
-    "ui.detailTab.register",
-    "ui.sidebar.register",
-    "api.routes.register",
-    "project.workspaces.read"
-  ],
-  localFolders: [
-    {
-      folderKey: "workspace",
-      displayName: "Workspace Root",
-      description: "Root directory of the project workspace to browse files",
-      access: "read"
-    }
-  ],
-  apiRoutes: [
-    {
-      routeKey: "list-files",
-      method: "GET",
-      path: "/files/list",
-      auth: "board-or-agent",
-      capability: "api.routes.register",
-      companyResolution: { from: "query", key: "companyId" }
-    },
-    {
-      routeKey: "download-file",
-      method: "GET",
-      path: "/files/download",
-      auth: "board-or-agent",
-      capability: "api.routes.register",
-      companyResolution: { from: "query", key: "companyId" }
-    },
-    {
-      routeKey: "download-zip",
-      method: "GET",
-      path: "/files/zip",
-      auth: "board-or-agent",
-      capability: "api.routes.register",
-      companyResolution: { from: "query", key: "companyId" }
-    }
-  ],
-  entrypoints: {
-    worker: "./dist/worker.js",
-    ui: "./dist/ui"
-  },
-  ui: {
-    slots: [
-      {
-        type: "dashboardWidget",
-        id: "file-browser-widget",
-        displayName: "File Browser",
-        exportName: "DashboardWidget"
-      },
-      {
-        type: "detailTab",
-        id: "file-browser-tab",
-        displayName: "Files",
-        exportName: "FileBrowserTab",
-        entityTypes: ["project", "issue"],
-        order: 50
-      },
-      {
-        type: "projectSidebarItem",
-        id: "file-browser-sidebar",
-        displayName: "Files",
-        exportName: "FileBrowserSidebarItem",
-        entityTypes: ["project"]
-      }
-    ]
-  }
-};
-var manifest_default = manifest;
-export {
-  manifest_default as default
-};
-//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/manifest.ts"],
-  "sourcesContent": ["import type { PaperclipPluginManifestV1 } from \"@paperclipai/plugin-sdk\";\n\nconst manifest: PaperclipPluginManifestV1 = {\n  id: \"jkl.file-browser\",\n  apiVersion: 1,\n  version: \"0.2.0\",\n  displayName: \"File Browser\",\n  description: \"A file browser plugin for Paperclip workspaces\",\n  author: \"Plugin Author\",\n  categories: [\"workspace\"],\n  capabilities: [\n    \"events.subscribe\",\n    \"plugin.state.read\",\n    \"plugin.state.write\",\n    \"local.folders\",\n    \"ui.dashboardWidget.register\",\n    \"ui.detailTab.register\",\n    \"ui.sidebar.register\",\n    \"api.routes.register\",\n    \"project.workspaces.read\"\n  ],\n  localFolders: [\n    {\n      folderKey: \"workspace\",\n      displayName: \"Workspace Root\",\n      description: \"Root directory of the project workspace to browse files\",\n      access: \"read\"\n    }\n  ],\n  apiRoutes: [\n    {\n      routeKey: \"list-files\",\n      method: \"GET\",\n      path: \"/files/list\",\n      auth: \"board-or-agent\",\n      capability: \"api.routes.register\",\n      companyResolution: { from: \"query\", key: \"companyId\" }\n    },\n    {\n      routeKey: \"download-file\",\n      method: \"GET\",\n      path: \"/files/download\",\n      auth: \"board-or-agent\",\n      capability: \"api.routes.register\",\n      companyResolution: { from: \"query\", key: \"companyId\" }\n    },\n    {\n      routeKey: \"download-zip\",\n      method: \"GET\",\n      path: \"/files/zip\",\n      auth: \"board-or-agent\",\n      capability: \"api.routes.register\",\n      companyResolution: { from: \"query\", key: \"companyId\" }\n    }\n  ],\n  entrypoints: {\n    worker: \"./dist/worker.js\",\n    ui: \"./dist/ui\"\n  },\n  ui: {\n    slots: [\n      {\n        type: \"dashboardWidget\",\n        id: \"file-browser-widget\",\n        displayName: \"File Browser\",\n        exportName: \"DashboardWidget\"\n      },\n      {\n        type: \"detailTab\",\n        id: \"file-browser-tab\",\n        displayName: \"Files\",\n        exportName: \"FileBrowserTab\",\n        entityTypes: [\"project\", \"issue\"],\n        order: 50\n      },\n      {\n        type: \"projectSidebarItem\",\n        id: \"file-browser-sidebar\",\n        displayName: \"Files\",\n        exportName: \"FileBrowserSidebarItem\",\n        entityTypes: [\"project\"]\n      }\n    ]\n  }\n};\n\nexport default manifest;\n"],
-  "mappings": ";AAEA,IAAM,WAAsC;AAAA,EAC1C,IAAI;AAAA,EACJ,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,aAAa;AAAA,EACb,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,YAAY,CAAC,WAAW;AAAA,EACxB,cAAc;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,cAAc;AAAA,IACZ;AAAA,MACE,WAAW;AAAA,MACX,aAAa;AAAA,MACb,aAAa;AAAA,MACb,QAAQ;AAAA,IACV;AAAA,EACF;AAAA,EACA,WAAW;AAAA,IACT;AAAA,MACE,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,MAAM;AAAA,MACN,YAAY;AAAA,MACZ,mBAAmB,EAAE,MAAM,SAAS,KAAK,YAAY;AAAA,IACvD;AAAA,IACA;AAAA,MACE,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,MAAM;AAAA,MACN,YAAY;AAAA,MACZ,mBAAmB,EAAE,MAAM,SAAS,KAAK,YAAY;AAAA,IACvD;AAAA,IACA;AAAA,MACE,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,MAAM;AAAA,MACN,YAAY;AAAA,MACZ,mBAAmB,EAAE,MAAM,SAAS,KAAK,YAAY;AAAA,IACvD;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,QAAQ;AAAA,IACR,IAAI;AAAA,EACN;AAAA,EACA,IAAI;AAAA,IACF,OAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,MACd;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,aAAa,CAAC,WAAW,OAAO;AAAA,QAChC,OAAO;AAAA,MACT;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,aAAa,CAAC,SAAS;AAAA,MACzB;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,mBAAQ;",
-  "names": []
-}

package/dist/ui/index.js

@@ -1,159 +0,0 @@
-// src/ui/index.tsx
-import { useCallback, useState } from "react";
-import {
-  usePluginData,
-  usePluginAction,
-  useHostContext,
-  useHostNavigation
-} from "@paperclipai/plugin-sdk/ui";
-import {
-  FileTree,
-  MetricCard,
-  ErrorBoundary
-} from "@paperclipai/plugin-sdk/ui";
-import { jsx, jsxs } from "react/jsx-runtime";
-function buildNodes(data) {
-  if (!data) return [];
-  const dirNodes = data.directories.map((d) => ({
-    name: d.name,
-    path: d.path,
-    kind: "dir",
-    children: []
-  }));
-  const fileNodes = data.files.map((f) => ({
-    name: f.name,
-    path: f.path,
-    kind: "file",
-    children: []
-  }));
-  return [...dirNodes, ...fileNodes];
-}
-function formatSize(bytes) {
-  if (bytes == null) return "-";
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
-function FileBrowser({ companyId }) {
-  const [currentPath, setCurrentPath] = useState("");
-  const [selectedFile, setSelectedFile] = useState(null);
-  const { data, loading, error, refresh } = usePluginData(
-    "file-tree",
-    { companyId: companyId ?? "", relativePath: currentPath }
-  );
-  const downloadFile = usePluginAction("download-file");
-  const downloadZip = usePluginAction("download-zip");
-  const nodes = buildNodes(data);
-  const handleSelectFile = useCallback((path) => {
-    setSelectedFile(path);
-  }, []);
-  const handleToggleDir = useCallback((path) => {
-    setCurrentPath(path);
-    setSelectedFile(null);
-  }, []);
-  const handleDownloadFile = useCallback(async () => {
-    if (!selectedFile || !companyId) return;
-    try {
-      await downloadFile({ companyId, relativePath: selectedFile });
-    } catch {
-    }
-  }, [selectedFile, companyId, downloadFile]);
-  const handleDownloadZip = useCallback(async () => {
-    if (!currentPath || !companyId) return;
-    try {
-      await downloadZip({ companyId, relativePath: currentPath });
-    } catch {
-    }
-  }, [currentPath, companyId, downloadZip]);
-  const handleNavigateUp = useCallback(() => {
-    if (!currentPath) return;
-    const parts = currentPath.split("/");
-    parts.pop();
-    setCurrentPath(parts.join("/"));
-    setSelectedFile(null);
-  }, [currentPath]);
-  const handleRefresh = useCallback(() => {
-    refresh();
-  }, [refresh]);
-  const fileCount = data?.files.length ?? 0;
-  const dirCount = data?.directories.length ?? 0;
-  const totalSize = data?.files.reduce((sum, f) => sum + (f.size ?? 0), 0) ?? 0;
-  if (!companyId) {
-    return /* @__PURE__ */ jsx("div", { style: { padding: "1rem" }, children: "Select a company to browse files." });
-  }
-  return /* @__PURE__ */ jsxs("div", { style: { display: "flex", flexDirection: "column", gap: "0.75rem", padding: "0.5rem 0" }, children: [
-    /* @__PURE__ */ jsxs("div", { style: { display: "flex", gap: "0.5rem", flexWrap: "wrap" }, children: [
-      /* @__PURE__ */ jsx(MetricCard, { label: "Files", value: fileCount }),
-      /* @__PURE__ */ jsx(MetricCard, { label: "Directories", value: dirCount }),
-      /* @__PURE__ */ jsx(MetricCard, { label: "Total Size", value: formatSize(totalSize) })
-    ] }),
-    /* @__PURE__ */ jsxs("div", { style: { display: "flex", gap: "0.5rem", alignItems: "center", flexWrap: "wrap" }, children: [
-      currentPath && /* @__PURE__ */ jsx("button", { onClick: handleNavigateUp, style: { fontSize: "0.85rem" }, children: ".. /" }),
-      /* @__PURE__ */ jsxs("span", { style: { fontSize: "0.85rem", color: "var(--text-secondary, #888)" }, children: [
-        "/",
-        currentPath || ""
-      ] }),
-      /* @__PURE__ */ jsxs("div", { style: { marginLeft: "auto", display: "flex", gap: "0.5rem" }, children: [
-        /* @__PURE__ */ jsx("button", { onClick: handleRefresh, style: { fontSize: "0.85rem" }, children: "Refresh" }),
-        selectedFile && /* @__PURE__ */ jsx("button", { onClick: handleDownloadFile, style: { fontSize: "0.85rem" }, children: "Download File" }),
-        currentPath && /* @__PURE__ */ jsx("button", { onClick: handleDownloadZip, style: { fontSize: "0.85rem" }, children: "Download Folder (ZIP)" })
-      ] })
-    ] }),
-    data?.error && /* @__PURE__ */ jsxs("div", { style: { color: "var(--text-error, red)", fontSize: "0.85rem" }, children: [
-      "Error: ",
-      data.error
-    ] }),
-    /* @__PURE__ */ jsx(
-      FileTree,
-      {
-        nodes,
-        selectedFile,
-        expandedPaths: [],
-        onSelectFile: handleSelectFile,
-        onToggleDir: handleToggleDir,
-        loading,
-        error: error ? { message: error.message } : null,
-        empty: { title: "Empty directory", description: "No files or directories found." },
-        ariaLabel: "File browser"
-      }
-    ),
-    selectedFile && /* @__PURE__ */ jsxs("div", { style: { fontSize: "0.8rem", color: "var(--text-secondary, #888)", paddingTop: "0.25rem" }, children: [
-      "Selected: ",
-      selectedFile
-    ] })
-  ] });
-}
-function DashboardWidget(_props) {
-  const { companyId } = useHostContext();
-  return /* @__PURE__ */ jsx(ErrorBoundary, { fallback: /* @__PURE__ */ jsx("div", { style: { padding: "1rem", color: "var(--text-error, red)" }, children: "File Browser: failed to render" }), children: /* @__PURE__ */ jsxs("div", { style: { display: "grid", gap: "0.5rem" }, children: [
-    /* @__PURE__ */ jsx("strong", { children: "File Browser" }),
-    /* @__PURE__ */ jsx(FileBrowser, { companyId })
-  ] }) });
-}
-function FileBrowserTab(props) {
-  const { companyId } = props.context;
-  return /* @__PURE__ */ jsx(ErrorBoundary, { fallback: /* @__PURE__ */ jsx("div", { style: { padding: "1rem", color: "var(--text-error, red)" }, children: "File Browser tab: failed to render" }), children: /* @__PURE__ */ jsx(FileBrowser, { companyId }) });
-}
-function FileBrowserSidebarItem(props) {
-  const { entityId: projectId } = props.context;
-  const { navigate, resolveHref } = useHostNavigation();
-  const href = resolveHref(`/projects/${projectId}?tab=plugin:jkl.file-browser:file-browser-tab`);
-  return /* @__PURE__ */ jsx(
-    "a",
-    {
-      href,
-      onClick: (e) => {
-        e.preventDefault();
-        navigate(href);
-      },
-      style: { fontSize: "0.85rem", display: "flex", alignItems: "center", gap: "0.35rem", padding: "0.2rem 0", color: "var(--text-link, #4488cc)", textDecoration: "none" },
-      children: "Files"
-    }
-  );
-}
-export {
-  DashboardWidget,
-  FileBrowserSidebarItem,
-  FileBrowserTab
-};
-//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/ui/index.tsx"],
-  "sourcesContent": ["import { useCallback, useState } from \"react\";\nimport {\n  usePluginData,\n  usePluginAction,\n  useHostContext,\n  useHostNavigation,\n  type PluginWidgetProps,\n  type PluginDetailTabProps,\n  type PluginProjectSidebarItemProps,\n} from \"@paperclipai/plugin-sdk/ui\";\nimport {\n  FileTree,\n  MetricCard,\n  Spinner,\n  ErrorBoundary,\n  type FileTreeNode,\n} from \"@paperclipai/plugin-sdk/ui\";\n\ninterface FileEntry {\n  name: string;\n  path: string;\n  kind: \"file\" | \"directory\";\n  size?: number | null;\n  modifiedAt?: string | null;\n}\n\ninterface FileTreeData {\n  currentPath: string;\n  directories: FileEntry[];\n  files: FileEntry[];\n  error?: string;\n}\n\nfunction buildNodes(data: FileTreeData | null): FileTreeNode[] {\n  if (!data) return [];\n  const dirNodes: FileTreeNode[] = data.directories.map((d) => ({\n    name: d.name,\n    path: d.path,\n    kind: \"dir\" as const,\n    children: [],\n  }));\n  const fileNodes: FileTreeNode[] = data.files.map((f) => ({\n    name: f.name,\n    path: f.path,\n    kind: \"file\" as const,\n    children: [],\n  }));\n  return [...dirNodes, ...fileNodes];\n}\n\nfunction formatSize(bytes: number | null | undefined): string {\n  if (bytes == null) return \"-\";\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n\nfunction FileBrowser({ companyId }: { companyId: string | null }) {\n  const [currentPath, setCurrentPath] = useState(\"\");\n  const [selectedFile, setSelectedFile] = useState<string | null>(null);\n\n  const { data, loading, error, refresh } = usePluginData<FileTreeData>(\n    \"file-tree\",\n    { companyId: companyId ?? \"\", relativePath: currentPath }\n  );\n\n  const downloadFile = usePluginAction(\"download-file\");\n  const downloadZip = usePluginAction(\"download-zip\");\n\n  const nodes = buildNodes(data);\n\n  const handleSelectFile = useCallback((path: string) => {\n    setSelectedFile(path);\n  }, []);\n\n  const handleToggleDir = useCallback((path: string) => {\n    setCurrentPath(path);\n    setSelectedFile(null);\n  }, []);\n\n  const handleDownloadFile = useCallback(async () => {\n    if (!selectedFile || !companyId) return;\n    try {\n      await downloadFile({ companyId, relativePath: selectedFile });\n    } catch {\n      // Bridge error propagated\n    }\n  }, [selectedFile, companyId, downloadFile]);\n\n  const handleDownloadZip = useCallback(async () => {\n    if (!currentPath || !companyId) return;\n    try {\n      await downloadZip({ companyId, relativePath: currentPath });\n    } catch {\n      // Bridge error propagated\n    }\n  }, [currentPath, companyId, downloadZip]);\n\n  const handleNavigateUp = useCallback(() => {\n    if (!currentPath) return;\n    const parts = currentPath.split(\"/\");\n    parts.pop();\n    setCurrentPath(parts.join(\"/\"));\n    setSelectedFile(null);\n  }, [currentPath]);\n\n  const handleRefresh = useCallback(() => {\n    refresh();\n  }, [refresh]);\n\n  const fileCount = data?.files.length ?? 0;\n  const dirCount = data?.directories.length ?? 0;\n  const totalSize = data?.files.reduce((sum, f) => sum + (f.size ?? 0), 0) ?? 0;\n\n  if (!companyId) {\n    return <div style={{ padding: \"1rem\" }}>Select a company to browse files.</div>;\n  }\n\n  return (\n    <div style={{ display: \"flex\", flexDirection: \"column\", gap: \"0.75rem\", padding: \"0.5rem 0\" }}>\n      <div style={{ display: \"flex\", gap: \"0.5rem\", flexWrap: \"wrap\" }}>\n        <MetricCard label=\"Files\" value={fileCount} />\n        <MetricCard label=\"Directories\" value={dirCount} />\n        <MetricCard label=\"Total Size\" value={formatSize(totalSize)} />\n      </div>\n\n      <div style={{ display: \"flex\", gap: \"0.5rem\", alignItems: \"center\", flexWrap: \"wrap\" }}>\n        {currentPath && (\n          <button onClick={handleNavigateUp} style={{ fontSize: \"0.85rem\" }}>\n            .. / \n          </button>\n        )}\n        <span style={{ fontSize: \"0.85rem\", color: \"var(--text-secondary, #888)\" }}>\n          /{currentPath || \"\"}\n        </span>\n        <div style={{ marginLeft: \"auto\", display: \"flex\", gap: \"0.5rem\" }}>\n          <button onClick={handleRefresh} style={{ fontSize: \"0.85rem\" }}>\n            Refresh\n          </button>\n          {selectedFile && (\n            <button onClick={handleDownloadFile} style={{ fontSize: \"0.85rem\" }}>\n              Download File\n            </button>\n          )}\n          {currentPath && (\n            <button onClick={handleDownloadZip} style={{ fontSize: \"0.85rem\" }}>\n              Download Folder (ZIP)\n            </button>\n          )}\n        </div>\n      </div>\n\n      {data?.error && (\n        <div style={{ color: \"var(--text-error, red)\", fontSize: \"0.85rem\" }}>\n          Error: {data.error}\n        </div>\n      )}\n\n      <FileTree\n        nodes={nodes}\n        selectedFile={selectedFile}\n        expandedPaths={[]}\n        onSelectFile={handleSelectFile}\n        onToggleDir={handleToggleDir}\n        loading={loading}\n        error={error ? { message: error.message } : null}\n        empty={{ title: \"Empty directory\", description: \"No files or directories found.\" }}\n        ariaLabel=\"File browser\"\n      />\n\n      {selectedFile && (\n        <div style={{ fontSize: \"0.8rem\", color: \"var(--text-secondary, #888)\", paddingTop: \"0.25rem\" }}>\n          Selected: {selectedFile}\n        </div>\n      )}\n    </div>\n  );\n}\n\nexport function DashboardWidget(_props: PluginWidgetProps) {\n  const { companyId } = useHostContext();\n  return (\n    <ErrorBoundary fallback={<div style={{ padding: \"1rem\", color: \"var(--text-error, red)\" }}>File Browser: failed to render</div>}>\n      <div style={{ display: \"grid\", gap: \"0.5rem\" }}>\n        <strong>File Browser</strong>\n        <FileBrowser companyId={companyId} />\n      </div>\n    </ErrorBoundary>\n  );\n}\n\nexport function FileBrowserTab(props: PluginDetailTabProps) {\n  const { companyId } = props.context;\n  return (\n    <ErrorBoundary fallback={<div style={{ padding: \"1rem\", color: \"var(--text-error, red)\" }}>File Browser tab: failed to render</div>}>\n      <FileBrowser companyId={companyId} />\n    </ErrorBoundary>\n  );\n}\n\nexport function FileBrowserSidebarItem(props: PluginProjectSidebarItemProps) {\n  const { entityId: projectId } = props.context;\n  const { navigate, resolveHref } = useHostNavigation();\n  const href = resolveHref(`/projects/${projectId}?tab=plugin:jkl.file-browser:file-browser-tab`);\n  return (\n    <a\n      href={href}\n      onClick={(e) => { e.preventDefault(); navigate(href); }}\n      style={{ fontSize: \"0.85rem\", display: \"flex\", alignItems: \"center\", gap: \"0.35rem\", padding: \"0.2rem 0\", color: \"var(--text-link, #4488cc)\", textDecoration: \"none\" }}\n    >\n      Files\n    </a>\n  );\n}\n"],
-  "mappings": "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",
-  "names": []
-}