@hamak/filesystem-server-impl 0.4.19 → 0.5.0

package/dist/enrichers/file-info-enricher-registry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * File Info Enricher Registry
+ *
+ * Default implementation of the enricher registry.
+ */
+import { FileInfo } from '@hamak/shared-utils';
+import { IFileInfoEnricher, IFileInfoEnricherRegistry, EnricherContext } from '@hamak/filesystem-server-spi';
+/**
+ * Default implementation of the FileInfo enricher registry
+ */
+export declare class FileInfoEnricherRegistry implements IFileInfoEnricherRegistry {
+    private enrichers;
+    /**
+     * Register an enricher
+     */
+    register(enricher: IFileInfoEnricher): void;
+    /**
+     * Unregister an enricher by its extension key
+     */
+    unregister(extensionKey: string): void;
+    /**
+     * Get all registered enrichers sorted by priority
+     */
+    getEnrichers(): IFileInfoEnricher[];
+    /**
+     * Apply all applicable enrichers to a FileInfo
+     */
+    applyEnrichers(fileInfo: FileInfo, context: EnricherContext): Promise<FileInfo>;
+    /**
+     * Apply all applicable enrichers to multiple FileInfo objects
+     */
+    applyEnrichersMany(fileInfos: FileInfo[], context: EnricherContext): Promise<FileInfo[]>;
+}
+/**
+ * Create a new enricher registry
+ */
+export declare function createFileInfoEnricherRegistry(): IFileInfoEnricherRegistry;
+//# sourceMappingURL=file-info-enricher-registry.d.ts.map

package/dist/enrichers/file-info-enricher-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-info-enricher-registry.d.ts","sourceRoot":"","sources":["../../src/enrichers/file-info-enricher-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,qBAAa,wBAAyB,YAAW,yBAAyB;IACxE,OAAO,CAAC,SAAS,CAA6C;IAE9D;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI3C;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,YAAY,IAAI,iBAAiB,EAAE;IAMnC;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,CAAC;IAYpB;;OAEG;IACG,kBAAkB,CACtB,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,EAAE,CAAC;CAyBvB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,yBAAyB,CAE1E"}

package/dist/enrichers/file-info-enricher-registry.js

@@ -0,0 +1,70 @@
+/**
+ * File Info Enricher Registry
+ *
+ * Default implementation of the enricher registry.
+ */
+/**
+ * Default implementation of the FileInfo enricher registry
+ */
+export class FileInfoEnricherRegistry {
+    constructor() {
+        this.enrichers = new Map();
+    }
+    /**
+     * Register an enricher
+     */
+    register(enricher) {
+        this.enrichers.set(enricher.extensionKey, enricher);
+    }
+    /**
+     * Unregister an enricher by its extension key
+     */
+    unregister(extensionKey) {
+        this.enrichers.delete(extensionKey);
+    }
+    /**
+     * Get all registered enrichers sorted by priority
+     */
+    getEnrichers() {
+        return Array.from(this.enrichers.values()).sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+    }
+    /**
+     * Apply all applicable enrichers to a FileInfo
+     */
+    async applyEnrichers(fileInfo, context) {
+        let result = fileInfo;
+        for (const enricher of this.getEnrichers()) {
+            if (enricher.shouldEnrich(context)) {
+                result = await enricher.enrich(result, context);
+            }
+        }
+        return result;
+    }
+    /**
+     * Apply all applicable enrichers to multiple FileInfo objects
+     */
+    async applyEnrichersMany(fileInfos, context) {
+        const applicableEnrichers = this.getEnrichers().filter((e) => e.shouldEnrich(context));
+        if (applicableEnrichers.length === 0) {
+            return fileInfos;
+        }
+        let result = fileInfos;
+        for (const enricher of applicableEnrichers) {
+            if (enricher.enrichMany) {
+                // Use batch enrichment if available
+                result = await enricher.enrichMany(result, context);
+            }
+            else {
+                // Fall back to individual enrichment
+                result = await Promise.all(result.map((fileInfo) => enricher.enrich(fileInfo, context)));
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Create a new enricher registry
+ */
+export function createFileInfoEnricherRegistry() {
+    return new FileInfoEnricherRegistry();
+}

package/dist/es2015/enrichers/file-info-enricher-registry.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * File Info Enricher Registry
+ *
+ * Default implementation of the enricher registry.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFileInfoEnricherRegistry = exports.FileInfoEnricherRegistry = void 0;
+/**
+ * Default implementation of the FileInfo enricher registry
+ */
+class FileInfoEnricherRegistry {
+    constructor() {
+        this.enrichers = new Map();
+    }
+    /**
+     * Register an enricher
+     */
+    register(enricher) {
+        this.enrichers.set(enricher.extensionKey, enricher);
+    }
+    /**
+     * Unregister an enricher by its extension key
+     */
+    unregister(extensionKey) {
+        this.enrichers.delete(extensionKey);
+    }
+    /**
+     * Get all registered enrichers sorted by priority
+     */
+    getEnrichers() {
+        return Array.from(this.enrichers.values()).sort((a, b) => { var _a, _b; return ((_a = a.priority) !== null && _a !== void 0 ? _a : 100) - ((_b = b.priority) !== null && _b !== void 0 ? _b : 100); });
+    }
+    /**
+     * Apply all applicable enrichers to a FileInfo
+     */
+    applyEnrichers(fileInfo, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let result = fileInfo;
+            for (const enricher of this.getEnrichers()) {
+                if (enricher.shouldEnrich(context)) {
+                    result = yield enricher.enrich(result, context);
+                }
+            }
+            return result;
+        });
+    }
+    /**
+     * Apply all applicable enrichers to multiple FileInfo objects
+     */
+    applyEnrichersMany(fileInfos, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const applicableEnrichers = this.getEnrichers().filter((e) => e.shouldEnrich(context));
+            if (applicableEnrichers.length === 0) {
+                return fileInfos;
+            }
+            let result = fileInfos;
+            for (const enricher of applicableEnrichers) {
+                if (enricher.enrichMany) {
+                    // Use batch enrichment if available
+                    result = yield enricher.enrichMany(result, context);
+                }
+                else {
+                    // Fall back to individual enrichment
+                    result = yield Promise.all(result.map((fileInfo) => enricher.enrich(fileInfo, context)));
+                }
+            }
+            return result;
+        });
+    }
+}
+exports.FileInfoEnricherRegistry = FileInfoEnricherRegistry;
+/**
+ * Create a new enricher registry
+ */
+function createFileInfoEnricherRegistry() {
+    return new FileInfoEnricherRegistry();
+}
+exports.createFileInfoEnricherRegistry = createFileInfoEnricherRegistry;

package/dist/es2015/index.js

@@ -28,5 +28,7 @@ __exportStar(require("./routing/create-router"), exports);
 __exportStar(require("./routing/file-router"), exports);
 // Export middleware
 __exportStar(require("./middleware/workspace-validator"), exports);
+// Export enrichers
+__exportStar(require("./enrichers/file-info-enricher-registry"), exports);
 // Re-export API types for convenience
 __exportStar(require("@hamak/filesystem-server-api"), exports);

package/dist/es2015/routing/file-router.js

@@ -18,9 +18,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileRouter = void 0;
 const express_1 = require("express");
 class FileRouter {
-    constructor(workspaceManager) {
+    constructor(workspaceManager, options) {
         this.router = (0, express_1.Router)();
         this.workspaceManager = workspaceManager;
+        this.enricherRegistry = options === null || options === void 0 ? void 0 : options.enricherRegistry;
         this.initializeRoutes();
     }
     initializeRoutes() {
@@ -36,13 +37,51 @@ class FileRouter {
         // Split path string into segments, filter out empty segments
         return pathString.split('/').filter(seg => seg.length > 0);
     }
+    /**
+     * Create enricher context from request
+     */
+    createEnricherContext(req, workspace, pathSegments, operation) {
+        // Note: resolvedPath would need workspace manager to expose path resolution
+        // For now, we pass an empty string and let enrichers handle it
+        return {
+            workspace,
+            pathSegments,
+            resolvedPath: '', // Will be populated by enrichers if needed
+            request: req,
+            operation,
+        };
+    }
+    /**
+     * Apply enrichers to a single FileInfo if registry is available
+     */
+    enrichFileInfo(fileInfo, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.enricherRegistry) {
+                return fileInfo;
+            }
+            return this.enricherRegistry.applyEnrichers(fileInfo, context);
+        });
+    }
+    /**
+     * Apply enrichers to multiple FileInfo objects if registry is available
+     */
+    enrichFileInfoMany(fileInfos, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.enricherRegistry) {
+                return fileInfos;
+            }
+            return this.enricherRegistry.applyEnrichersMany(fileInfos, context);
+        });
+    }
     listFiles(req, res) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const { workspace } = req.params;
                 const pathSegments = this.parsePath(req.params[0] || '');
                 const files = yield this.workspaceManager.listFiles(workspace, pathSegments);
-                res.json(files);
+                const context = this.createEnricherContext(req, workspace, pathSegments, 'list');
+                const enrichedFiles = yield this.enrichFileInfoMany(files, context);
+                res.json(enrichedFiles);
             }
             catch (error) {
                 res.status(500).json({ error: error.message });
@@ -55,7 +94,9 @@ class FileRouter {
                 const { workspace } = req.params;
                 const pathSegments = this.parsePath(req.params[0] || '');
                 const dirInfo = yield this.workspaceManager.createDirectory(workspace, pathSegments);
-                res.json(dirInfo);
+                const context = this.createEnricherContext(req, workspace, pathSegments, 'mkdir');
+                const enrichedDirInfo = yield this.enrichFileInfo(dirInfo, context);
+                res.json(enrichedDirInfo);
             }
             catch (error) {
                 res.status(500).json({ error: error.message });
@@ -68,7 +109,9 @@ class FileRouter {
                 const { workspace } = req.params;
                 const pathSegments = this.parsePath(req.params[0] || '');
                 const fileInfo = yield this.workspaceManager.getFile(workspace, pathSegments);
-                res.json(fileInfo);
+                const context = this.createEnricherContext(req, workspace, pathSegments, 'get');
+                const enrichedFileInfo = yield this.enrichFileInfo(fileInfo, context);
+                res.json(enrichedFileInfo);
             }
             catch (error) {
                 res.status(500).json({ error: error.message });
@@ -81,7 +124,9 @@ class FileRouter {
                 const { workspace } = req.params;
                 const pathSegments = this.parsePath(req.params[0] || '');
                 const fileInfo = yield this.workspaceManager.readFile(workspace, pathSegments);
-                res.json(fileInfo);
+                const context = this.createEnricherContext(req, workspace, pathSegments, 'read');
+                const enrichedFileInfo = yield this.enrichFileInfo(fileInfo, context);
+                res.json(enrichedFileInfo);
             }
             catch (error) {
                 res.status(500).json({ error: error.message });
@@ -95,7 +140,9 @@ class FileRouter {
                 const pathSegments = this.parsePath(req.params[0] || '');
                 const { content } = req.body;
                 const fileInfo = yield this.workspaceManager.writeFile(workspace, pathSegments, content);
-                res.json(fileInfo);
+                const context = this.createEnricherContext(req, workspace, pathSegments, 'write');
+                const enrichedFileInfo = yield this.enrichFileInfo(fileInfo, context);
+                res.json(enrichedFileInfo);
             }
             catch (error) {
                 res.status(500).json({ error: error.message });
@@ -108,7 +155,9 @@ class FileRouter {
                 const { workspace } = req.params;
                 const pathSegments = this.parsePath(req.params[0] || '');
                 const fileInfo = yield this.workspaceManager.deleteFile(workspace, pathSegments);
-                res.json(fileInfo);
+                const context = this.createEnricherContext(req, workspace, pathSegments, 'delete');
+                const enrichedFileInfo = yield this.enrichFileInfo(fileInfo, context);
+                res.json(enrichedFileInfo);
             }
             catch (error) {
                 res.status(500).json({ error: error.message });

package/dist/index.d.ts

@@ -8,5 +8,6 @@ export * from './services/workspace-manager';
 export * from './routing/create-router';
 export * from './routing/file-router';
 export * from './middleware/workspace-validator';
+export * from './enrichers/file-info-enricher-registry';
 export * from '@hamak/filesystem-server-api';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,mCAAmC,CAAC;AAGlD,cAAc,8BAA8B,CAAC;AAG7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kCAAkC,CAAC;AAGjD,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,mCAAmC,CAAC;AAGlD,cAAc,8BAA8B,CAAC;AAG7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kCAAkC,CAAC;AAGjD,cAAc,yCAAyC,CAAC;AAGxD,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -12,5 +12,7 @@ export * from './routing/create-router';
 export * from './routing/file-router';
 // Export middleware
 export * from './middleware/workspace-validator';
+// Export enrichers
+export * from './enrichers/file-info-enricher-registry';
 // Re-export API types for convenience
 export * from '@hamak/filesystem-server-api';

package/dist/routing/file-router.d.ts

@@ -6,12 +6,32 @@
  */
 import { Router } from 'express';
 import { IWorkspaceManager } from '@hamak/filesystem-server-api';
+import { IFileInfoEnricherRegistry } from '@hamak/filesystem-server-spi';
+export interface FileRouterOptions {
+    /**
+     * Optional enricher registry for extending FileInfo responses
+     */
+    enricherRegistry?: IFileInfoEnricherRegistry;
+}
 export declare class FileRouter {
     router: Router;
     private workspaceManager;
-    constructor(workspaceManager: IWorkspaceManager);
+    private enricherRegistry?;
+    constructor(workspaceManager: IWorkspaceManager, options?: FileRouterOptions);
     private initializeRoutes;
     private parsePath;
+    /**
+     * Create enricher context from request
+     */
+    private createEnricherContext;
+    /**
+     * Apply enrichers to a single FileInfo if registry is available
+     */
+    private enrichFileInfo;
+    /**
+     * Apply enrichers to multiple FileInfo objects if registry is available
+     */
+    private enrichFileInfoMany;
     private listFiles;
     private createDirectory;
     private getFile;

package/dist/routing/file-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../src/routing/file-router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,qBAAa,UAAU;IACd,MAAM,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,gBAAgB,CAAoB;gBAEhC,gBAAgB,EAAE,iBAAiB;IAM/C,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,SAAS;YAKH,SAAS;YAWT,eAAe;YAWf,OAAO;YAWP,QAAQ;YAWR,SAAS;YAYT,UAAU;CAUzB"}
+{"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../src/routing/file-router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAmB,MAAM,8BAA8B,CAAC;AAG1F,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAC9C;AAED,qBAAa,UAAU;IACd,MAAM,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,gBAAgB,CAAC,CAA4B;gBAEzC,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAO5E,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;YACW,cAAc;IAU5B;;OAEG;YACW,kBAAkB;YAUlB,SAAS;YAaT,eAAe;YAaf,OAAO;YAaP,QAAQ;YAaR,SAAS;YAcT,UAAU;CAYzB"}

package/dist/routing/file-router.js

@@ -6,9 +6,10 @@
  */
 import { Router } from 'express';
 export class FileRouter {
-    constructor(workspaceManager) {
+    constructor(workspaceManager, options) {
         this.router = Router();
         this.workspaceManager = workspaceManager;
+        this.enricherRegistry = options?.enricherRegistry;
         this.initializeRoutes();
     }
     initializeRoutes() {
@@ -24,12 +25,46 @@ export class FileRouter {
         // Split path string into segments, filter out empty segments
         return pathString.split('/').filter(seg => seg.length > 0);
     }
+    /**
+     * Create enricher context from request
+     */
+    createEnricherContext(req, workspace, pathSegments, operation) {
+        // Note: resolvedPath would need workspace manager to expose path resolution
+        // For now, we pass an empty string and let enrichers handle it
+        return {
+            workspace,
+            pathSegments,
+            resolvedPath: '', // Will be populated by enrichers if needed
+            request: req,
+            operation,
+        };
+    }
+    /**
+     * Apply enrichers to a single FileInfo if registry is available
+     */
+    async enrichFileInfo(fileInfo, context) {
+        if (!this.enricherRegistry) {
+            return fileInfo;
+        }
+        return this.enricherRegistry.applyEnrichers(fileInfo, context);
+    }
+    /**
+     * Apply enrichers to multiple FileInfo objects if registry is available
+     */
+    async enrichFileInfoMany(fileInfos, context) {
+        if (!this.enricherRegistry) {
+            return fileInfos;
+        }
+        return this.enricherRegistry.applyEnrichersMany(fileInfos, context);
+    }
     async listFiles(req, res) {
         try {
             const { workspace } = req.params;
             const pathSegments = this.parsePath(req.params[0] || '');
             const files = await this.workspaceManager.listFiles(workspace, pathSegments);
-            res.json(files);
+            const context = this.createEnricherContext(req, workspace, pathSegments, 'list');
+            const enrichedFiles = await this.enrichFileInfoMany(files, context);
+            res.json(enrichedFiles);
         }
         catch (error) {
             res.status(500).json({ error: error.message });
@@ -40,7 +75,9 @@ export class FileRouter {
             const { workspace } = req.params;
             const pathSegments = this.parsePath(req.params[0] || '');
             const dirInfo = await this.workspaceManager.createDirectory(workspace, pathSegments);
-            res.json(dirInfo);
+            const context = this.createEnricherContext(req, workspace, pathSegments, 'mkdir');
+            const enrichedDirInfo = await this.enrichFileInfo(dirInfo, context);
+            res.json(enrichedDirInfo);
         }
         catch (error) {
             res.status(500).json({ error: error.message });
@@ -51,7 +88,9 @@ export class FileRouter {
             const { workspace } = req.params;
             const pathSegments = this.parsePath(req.params[0] || '');
             const fileInfo = await this.workspaceManager.getFile(workspace, pathSegments);
-            res.json(fileInfo);
+            const context = this.createEnricherContext(req, workspace, pathSegments, 'get');
+            const enrichedFileInfo = await this.enrichFileInfo(fileInfo, context);
+            res.json(enrichedFileInfo);
         }
         catch (error) {
             res.status(500).json({ error: error.message });
@@ -62,7 +101,9 @@ export class FileRouter {
             const { workspace } = req.params;
             const pathSegments = this.parsePath(req.params[0] || '');
             const fileInfo = await this.workspaceManager.readFile(workspace, pathSegments);
-            res.json(fileInfo);
+            const context = this.createEnricherContext(req, workspace, pathSegments, 'read');
+            const enrichedFileInfo = await this.enrichFileInfo(fileInfo, context);
+            res.json(enrichedFileInfo);
         }
         catch (error) {
             res.status(500).json({ error: error.message });
@@ -74,7 +115,9 @@ export class FileRouter {
             const pathSegments = this.parsePath(req.params[0] || '');
             const { content } = req.body;
             const fileInfo = await this.workspaceManager.writeFile(workspace, pathSegments, content);
-            res.json(fileInfo);
+            const context = this.createEnricherContext(req, workspace, pathSegments, 'write');
+            const enrichedFileInfo = await this.enrichFileInfo(fileInfo, context);
+            res.json(enrichedFileInfo);
         }
         catch (error) {
             res.status(500).json({ error: error.message });
@@ -85,7 +128,9 @@ export class FileRouter {
             const { workspace } = req.params;
             const pathSegments = this.parsePath(req.params[0] || '');
             const fileInfo = await this.workspaceManager.deleteFile(workspace, pathSegments);
-            res.json(fileInfo);
+            const context = this.createEnricherContext(req, workspace, pathSegments, 'delete');
+            const enrichedFileInfo = await this.enrichFileInfo(fileInfo, context);
+            res.json(enrichedFileInfo);
         }
         catch (error) {
             res.status(500).json({ error: error.message });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamak/filesystem-server-impl",
-  "version": "0.4.19",
+  "version": "0.5.0",
   "private": false,
   "type": "module",
   "description": "FileSystem Server Implementation - Backend filesystem server with Express routes",