vectra 0.12.2 → 0.14.0

package/lib/storage/LocalFileStorage.js

@@ -0,0 +1,152 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalFileStorage = void 0;
+const FileStorageUtilities_1 = require("./FileStorageUtilities");
+const promises_1 = __importDefault(require("fs/promises"));
+const path = __importStar(require("node:path"));
+/**
+ * A `FileStorage` implementation that uses the local file system.
+ */
+class LocalFileStorage {
+    /**
+     * Creates a new `LocalFileStorage` instance.
+     * @param rootFolder Optional. Root folder to use for file operations. If not provided, paths passed to operations should be fully qualified.
+     */
+    constructor(rootFolder) {
+        this._rootFolder = rootFolder;
+    }
+    createFile(filePath, content) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Convert content to buffer if it's a string
+            if (typeof content == 'string') {
+                content = Buffer.from(content, 'utf8');
+            }
+            // Write the file
+            yield promises_1.default.writeFile(this.getFullPath(filePath), content, { flag: 'wx' });
+        });
+    }
+    createFolder(folderPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield promises_1.default.mkdir(this.getFullPath(folderPath), { recursive: true });
+        });
+    }
+    deleteFile(filePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield promises_1.default.unlink(this.getFullPath(filePath));
+        });
+    }
+    deleteFolder(folderPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield promises_1.default.rm(this.getFullPath(folderPath), { recursive: true });
+        });
+    }
+    getDetails(fileOrFolderPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const stats = yield promises_1.default.stat(this.getFullPath(fileOrFolderPath));
+            return {
+                name: path.basename(fileOrFolderPath),
+                path: fileOrFolderPath,
+                isFolder: stats.isDirectory(),
+                fileType: stats.isFile() ? FileStorageUtilities_1.FileStorageUtilities.getFileType(fileOrFolderPath) : undefined
+            };
+        });
+    }
+    listFiles(folderPath, _filter) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const folder = this.getFullPath(folderPath);
+            const list = yield promises_1.default.readdir(folder, { withFileTypes: true });
+            return list.map((entry) => {
+                return {
+                    name: entry.name,
+                    path: path.join(folder, entry.name),
+                    isFolder: entry.isDirectory(),
+                    fileType: entry.isFile() ? FileStorageUtilities_1.FileStorageUtilities.getFileType(entry.name) : undefined
+                };
+            });
+        });
+    }
+    pathExists(fileOrFolderPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield promises_1.default.access(this.getFullPath(fileOrFolderPath));
+                return true;
+            }
+            catch (err) {
+                return false;
+            }
+        });
+    }
+    readFile(filePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield promises_1.default.readFile(this.getFullPath(filePath));
+        });
+    }
+    upsertFile(filePath, content) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Convert content to buffer if it's a string
+            if (typeof content == 'string') {
+                content = Buffer.from(content, 'utf8');
+            }
+            // Write the file
+            yield promises_1.default.writeFile(this.getFullPath(filePath), content, { flag: 'w' });
+        });
+    }
+    getFullPath(relativePath) {
+        if (!this._rootFolder) {
+            return relativePath.length > 0 ? relativePath : '.';
+        }
+        else if (relativePath.length == 0) {
+            return this._rootFolder;
+        }
+        else {
+            return path.join(this._rootFolder, relativePath);
+        }
+    }
+}
+exports.LocalFileStorage = LocalFileStorage;
+//# sourceMappingURL=LocalFileStorage.js.map

package/lib/storage/LocalFileStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalFileStorage.js","sourceRoot":"","sources":["../../src/storage/LocalFileStorage.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,iEAA8D;AAC9D,2DAA6B;AAC7B,gDAAkC;AAElC;;GAEG;AACH,MAAa,gBAAgB;IAGzB;;;OAGG;IACH,YAAY,UAAmB;QAC3B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAClC,CAAC;IAEK,UAAU,CAAC,QAAgB,EAAE,OAAsB;;YACrD,6CAA6C;YAC7C,IAAI,OAAO,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC7B,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,iBAAiB;YACjB,MAAM,kBAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;KAAA;IAEK,YAAY,CAAC,UAAkB;;YACjC,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;KAAA;IAEK,UAAU,CAAC,QAAgB;;YAC7B,MAAM,kBAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChD,CAAC;KAAA;IAEK,YAAY,CAAC,UAAkB;;YACjC,MAAM,kBAAE,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;KAAA;IAEK,UAAU,CAAC,gBAAwB;;YACrC,MAAM,KAAK,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAChE,OAAO;gBACH,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBACrC,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE;gBAC7B,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,2CAAoB,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS;aAC5F,CAAC;QACN,CAAC;KAAA;IAEK,SAAS,CAAC,UAAkB,EAAE,OAAqC;;YACrE,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACtB,OAAO;oBACH,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;oBACnC,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE;oBAC7B,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,2CAAoB,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;iBACtF,CAAC;YACN,CAAC,CAAC,CAAC;QACP,CAAC;KAAA;IAEK,UAAU,CAAC,gBAAwB;;YACrC,IAAI,CAAC;gBACD,MAAM,kBAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBACpD,OAAO,IAAI,CAAC;YAChB,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACpB,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;KAAA;IAEK,QAAQ,CAAC,QAAgB;;YAC3B,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzD,CAAC;KAAA;IAEK,UAAU,CAAC,QAAgB,EAAE,OAAsB;;YACpD,6CAA6C;YAC7C,IAAI,OAAO,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC9B,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,iBAAiB;YAClB,MAAM,kBAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1E,CAAC;KAAA;IAEO,WAAW,CAAC,YAAoB;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC;QACxD,CAAC;aAAM,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,WAAW,CAAC;QAC5B,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;CAEJ;AAzFD,4CAyFC"}

package/lib/storage/LocalFileStorage.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LocalFileStorage.spec.d.ts.map

package/lib/storage/LocalFileStorage.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalFileStorage.spec.d.ts","sourceRoot":"","sources":["../../src/storage/LocalFileStorage.spec.ts"],"names":[],"mappings":""}

package/lib/storage/LocalFileStorage.spec.js

@@ -0,0 +1,249 @@
+"use strict";
+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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const sinon_1 = __importDefault(require("sinon"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const LocalFileStorage_1 = require("./LocalFileStorage");
+const FileStorageUtilities_1 = require("./FileStorageUtilities");
+describe('LocalFileStorage', () => {
+    let storage;
+    afterEach(() => __awaiter(void 0, void 0, void 0, function* () {
+        sinon_1.default.restore();
+    }));
+    describe('constructor and getFullPath', () => {
+        it('returns relativePath if no rootFolder and relativePath non-empty', () => {
+            storage = new LocalFileStorage_1.LocalFileStorage();
+            // @ts-ignore access private for test
+            node_assert_1.default.strictEqual(storage['getFullPath']('some/path'), 'some/path');
+        });
+        it("returns '.' if no rootFolder and relativePath empty", () => {
+            storage = new LocalFileStorage_1.LocalFileStorage();
+            // @ts-ignore access private for test
+            node_assert_1.default.strictEqual(storage['getFullPath'](''), '.');
+        });
+        it('returns rootFolder if rootFolder set and relativePath empty', () => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+            // @ts-ignore access private for test
+            node_assert_1.default.strictEqual(storage['getFullPath'](''), '/root');
+        });
+        it('joins rootFolder and relativePath if both set', () => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+            // @ts-ignore access private for test
+            node_assert_1.default.strictEqual(storage['getFullPath']('sub/folder'), path_1.default.join('/root', 'sub/folder'));
+        });
+    });
+    describe('createFile', () => {
+        beforeEach(() => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+        });
+        it('writes a new file with Buffer content', () => __awaiter(void 0, void 0, void 0, function* () {
+            const writeFileStub = sinon_1.default.stub(promises_1.default, 'writeFile').resolves();
+            const content = Buffer.from('hello');
+            yield storage.createFile('file.txt', content);
+            sinon_1.default.assert.calledWith(writeFileStub, path_1.default.join('/root', 'file.txt'), content, { flag: 'wx' });
+        }));
+        it('writes a new file with string content as UTF-8', () => __awaiter(void 0, void 0, void 0, function* () {
+            const writeFileStub = sinon_1.default.stub(promises_1.default, 'writeFile').resolves();
+            const content = 'hello';
+            yield storage.createFile('file.txt', content);
+            sinon_1.default.assert.calledWith(writeFileStub, path_1.default.join('/root', 'file.txt'), Buffer.from(content, 'utf8'), { flag: 'wx' });
+        }));
+        it('bubbles up error if file already exists', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'writeFile').rejects(new Error('EEXIST'));
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFile('file.txt', 'content');
+            }));
+        }));
+        it('bubbles up error if parent directory does not exist', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'writeFile').rejects(new Error('ENOENT'));
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFile('nonexistent/file.txt', 'content');
+            }));
+        }));
+    });
+    describe('createFolder', () => {
+        beforeEach(() => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+        });
+        it('creates nested directory structure recursively', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mkdirStub = sinon_1.default.stub(promises_1.default, 'mkdir').resolves();
+            yield storage.createFolder('nested/folder');
+            sinon_1.default.assert.calledWith(mkdirStub, path_1.default.join('/root', 'nested/folder'), { recursive: true });
+        }));
+        it('calling again on same path still calls mkdir (idempotent due to recursive:true)', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mkdirStub = sinon_1.default.stub(promises_1.default, 'mkdir').resolves();
+            yield storage.createFolder('nested/folder');
+            yield storage.createFolder('nested/folder');
+            sinon_1.default.assert.calledTwice(mkdirStub);
+        }));
+    });
+    describe('deleteFile', () => {
+        beforeEach(() => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+        });
+        it('deletes existing file', () => __awaiter(void 0, void 0, void 0, function* () {
+            const unlinkStub = sinon_1.default.stub(promises_1.default, 'unlink').resolves();
+            yield storage.deleteFile('file.txt');
+            sinon_1.default.assert.calledWith(unlinkStub, path_1.default.join('/root', 'file.txt'));
+        }));
+        it('bubbles up error when file does not exist', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'unlink').rejects(new Error('ENOENT'));
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.deleteFile('missing.txt');
+            }));
+        }));
+    });
+    describe('deleteFolder', () => {
+        beforeEach(() => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+        });
+        it('deletes existing folder recursively', () => __awaiter(void 0, void 0, void 0, function* () {
+            const rmStub = sinon_1.default.stub(promises_1.default, 'rm').resolves();
+            yield storage.deleteFolder('folder');
+            sinon_1.default.assert.calledWith(rmStub, path_1.default.join('/root', 'folder'), { recursive: true });
+        }));
+        it('bubbles up error when folder does not exist', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'rm').rejects(new Error('ENOENT'));
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.deleteFolder('missing');
+            }));
+        }));
+    });
+    describe('getDetails', () => {
+        beforeEach(() => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+        });
+        it('returns correct details for file', () => __awaiter(void 0, void 0, void 0, function* () {
+            const statStub = sinon_1.default.stub(promises_1.default, 'stat').resolves({
+                isDirectory: () => false,
+                isFile: () => true,
+            });
+            const getFileTypeStub = sinon_1.default.stub(FileStorageUtilities_1.FileStorageUtilities, 'getFileType').returns('txt');
+            const details = yield storage.getDetails('file.txt');
+            node_assert_1.default.strictEqual(details.name, 'file.txt');
+            node_assert_1.default.strictEqual(details.path, 'file.txt');
+            node_assert_1.default.strictEqual(details.isFolder, false);
+            node_assert_1.default.strictEqual(details.fileType, 'txt');
+            sinon_1.default.assert.calledWith(statStub, path_1.default.join('/root', 'file.txt'));
+            sinon_1.default.assert.calledWith(getFileTypeStub, 'file.txt');
+        }));
+        it('returns correct details for folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'stat').resolves({
+                isDirectory: () => true,
+                isFile: () => false,
+            });
+            const details = yield storage.getDetails('folder');
+            node_assert_1.default.strictEqual(details.name, 'folder');
+            node_assert_1.default.strictEqual(details.path, 'folder');
+            node_assert_1.default.strictEqual(details.isFolder, true);
+            node_assert_1.default.strictEqual(details.fileType, undefined);
+        }));
+        it('bubbles up error for non-existent path', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'stat').rejects(new Error('ENOENT'));
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.getDetails('missing');
+            }));
+        }));
+    });
+    describe('listFiles', () => {
+        beforeEach(() => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+        });
+        it('returns entries for folder with files and subfolders', () => __awaiter(void 0, void 0, void 0, function* () {
+            const dirents = [
+                { name: 'file1.txt', isDirectory: () => false, isFile: () => true },
+                { name: 'subfolder', isDirectory: () => true, isFile: () => false },
+            ];
+            sinon_1.default.stub(promises_1.default, 'readdir').resolves(dirents);
+            const getFileTypeStub = sinon_1.default.stub(FileStorageUtilities_1.FileStorageUtilities, 'getFileType').callsFake((name) => {
+                if (name === 'file1.txt')
+                    return 'txt';
+                return undefined;
+            });
+            const results = yield storage.listFiles('folder');
+            node_assert_1.default.strictEqual(results.length, 2);
+            node_assert_1.default.strictEqual(results[0].name, 'file1.txt');
+            node_assert_1.default.strictEqual(results[0].path, path_1.default.join('/root', 'folder', 'file1.txt'));
+            node_assert_1.default.strictEqual(results[0].isFolder, false);
+            node_assert_1.default.strictEqual(results[0].fileType, 'txt');
+            node_assert_1.default.strictEqual(results[1].name, 'subfolder');
+            node_assert_1.default.strictEqual(results[1].path, path_1.default.join('/root', 'folder', 'subfolder'));
+            node_assert_1.default.strictEqual(results[1].isFolder, true);
+            node_assert_1.default.strictEqual(results[1].fileType, undefined);
+            sinon_1.default.assert.calledWith(getFileTypeStub, 'file1.txt');
+        }));
+        it('ignores filter argument', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'readdir').resolves([]);
+            const results = yield storage.listFiles('folder', { any: true });
+            node_assert_1.default.ok(Array.isArray(results));
+            node_assert_1.default.strictEqual(results.length, 0);
+        }));
+    });
+    describe('pathExists', () => {
+        beforeEach(() => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+        });
+        it('returns true for existing file or folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'access').resolves();
+            const exists = yield storage.pathExists('file.txt');
+            node_assert_1.default.strictEqual(exists, true);
+        }));
+        it('returns false for non-existent path', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'access').rejects(new Error('ENOENT'));
+            const exists = yield storage.pathExists('missing');
+            node_assert_1.default.strictEqual(exists, false);
+        }));
+    });
+    describe('readFile', () => {
+        beforeEach(() => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+        });
+        it('reads and returns exact bytes', () => __awaiter(void 0, void 0, void 0, function* () {
+            const content = Buffer.from('hello');
+            sinon_1.default.stub(promises_1.default, 'readFile').resolves(content);
+            const result = yield storage.readFile('file.txt');
+            node_assert_1.default.strictEqual(result, content);
+        }));
+        it('bubbles up error when file does not exist', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'readFile').rejects(new Error('ENOENT'));
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.readFile('missing.txt');
+            }));
+        }));
+    });
+    describe('upsertFile', () => {
+        beforeEach(() => {
+            storage = new LocalFileStorage_1.LocalFileStorage('/root');
+        });
+        it('creates new file when absent', () => __awaiter(void 0, void 0, void 0, function* () {
+            const writeFileStub = sinon_1.default.stub(promises_1.default, 'writeFile').resolves();
+            yield storage.upsertFile('file.txt', 'content');
+            sinon_1.default.assert.calledWith(writeFileStub, path_1.default.join('/root', 'file.txt'), Buffer.from('content', 'utf8'), { flag: 'w' });
+        }));
+        it('overwrites existing file', () => __awaiter(void 0, void 0, void 0, function* () {
+            const writeFileStub = sinon_1.default.stub(promises_1.default, 'writeFile').resolves();
+            yield storage.upsertFile('file.txt', Buffer.from('new content'));
+            sinon_1.default.assert.calledWith(writeFileStub, path_1.default.join('/root', 'file.txt'), Buffer.from('new content'), { flag: 'w' });
+        }));
+        it('bubbles up error if parent directory does not exist', () => __awaiter(void 0, void 0, void 0, function* () {
+            sinon_1.default.stub(promises_1.default, 'writeFile').rejects(new Error('ENOENT'));
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.upsertFile('nonexistent/file.txt', 'content');
+            }));
+        }));
+    });
+});
+//# sourceMappingURL=LocalFileStorage.spec.js.map

package/lib/storage/LocalFileStorage.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalFileStorage.spec.js","sourceRoot":"","sources":["../../src/storage/LocalFileStorage.spec.ts"],"names":[],"mappings":"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"}

package/lib/storage/VirtualFileStorage.d.ts

@@ -0,0 +1,18 @@
+import { FileDetails, FileStorage, ListFilesFilter } from "./FileStorage";
+/**
+ * An in-memory `FileStorage` implementation.
+ */
+export declare class VirtualFileStorage implements FileStorage {
+    private readonly _entries;
+    private normalizeKey;
+    createFile(filePath: string, content: Buffer | string): Promise<void>;
+    createFolder(folderPath: string): Promise<void>;
+    deleteFile(filePath: string): Promise<void>;
+    deleteFolder(folderPath: string): Promise<void>;
+    getDetails(fileOrFolderPath: string): Promise<FileDetails>;
+    listFiles(folderPath: string, filter?: ListFilesFilter): Promise<FileDetails[]>;
+    pathExists(fileOrFolderPath: string): Promise<boolean>;
+    readFile(filePath: string): Promise<Buffer>;
+    upsertFile(filePath: string, content: Buffer | string): Promise<void>;
+}
+//# sourceMappingURL=VirtualFileStorage.d.ts.map

package/lib/storage/VirtualFileStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualFileStorage.d.ts","sourceRoot":"","sources":["../../src/storage/VirtualFileStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAI1E;;GAEG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAM/D,OAAO,CAAC,YAAY;IASP,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrE,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3C,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/C,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAU1D,SAAS,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,eAAuB,GAC9B,OAAO,CAAC,WAAW,EAAE,CAAC;IAsBZ,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc3C,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBnF"}

package/lib/storage/VirtualFileStorage.js

@@ -0,0 +1,178 @@
+"use strict";
+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.VirtualFileStorage = void 0;
+const pathUtils_1 = require("../utils/pathUtils");
+const FileStorageUtilities_1 = require("./FileStorageUtilities");
+/**
+ * An in-memory `FileStorage` implementation.
+ */
+class VirtualFileStorage {
+    constructor() {
+        this._entries = new Map();
+    }
+    // Normalize keys consistently across all operations:
+    // - path.normalize to resolve dot segments
+    // - remove trailing separator (except for root) so 'a' and 'a/' match
+    // - preserve '' to represent the root namespace in this storage
+    normalizeKey(key) {
+        if (key.length === 0)
+            return "";
+        let normalized = pathUtils_1.pathUtils.normalize(key);
+        if (normalized.endsWith(pathUtils_1.pathUtils.sep) && normalized !== pathUtils_1.pathUtils.sep) {
+            normalized = normalized.slice(0, -1);
+        }
+        return normalized;
+    }
+    createFile(filePath, content) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const key = this.normalizeKey(filePath);
+            if (this._entries.has(key)) {
+                throw new Error(`File already exists: ${key}`);
+            }
+            const buffer = typeof content === "string" ? Buffer.from(content, "utf8") : content;
+            this._entries.set(key, {
+                details: {
+                    name: pathUtils_1.pathUtils.basename(key),
+                    path: key,
+                    isFolder: false,
+                    fileType: FileStorageUtilities_1.FileStorageUtilities.getFileType(key),
+                },
+                // Clone to avoid external mutation of stored buffers (and keep Buffer type)
+                content: Buffer.from(buffer),
+            });
+        });
+    }
+    createFolder(folderPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const key = this.normalizeKey(folderPath);
+            const existing = this._entries.get(key);
+            if (existing) {
+                if (!existing.details.isFolder) {
+                    throw new Error(`Cannot create folder: ${key} is a file`);
+                }
+                // Idempotent if the folder already exists
+                return;
+            }
+            this._entries.set(key, {
+                details: {
+                    name: pathUtils_1.pathUtils.basename(key),
+                    path: key,
+                    isFolder: true,
+                    fileType: undefined,
+                },
+            });
+        });
+    }
+    deleteFile(filePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const key = this.normalizeKey(filePath);
+            const existing = this._entries.get(key);
+            if (!existing) {
+                // no-op if not exists
+                return;
+            }
+            if (existing.details.isFolder) {
+                throw new Error(`Cannot delete file: ${key} is a folder`);
+            }
+            this._entries.delete(key);
+        });
+    }
+    deleteFolder(folderPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const key = this.normalizeKey(folderPath);
+            const existing = this._entries.get(key);
+            if (!existing) {
+                // no-op if not exists
+                return;
+            }
+            if (!existing.details.isFolder) {
+                throw new Error(`Cannot delete folder: ${key} is a file`);
+            }
+            // Note: does not cascade delete children per current implementation
+            this._entries.delete(key);
+        });
+    }
+    getDetails(fileOrFolderPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const key = this.normalizeKey(fileOrFolderPath);
+            const existing = this._entries.get(key);
+            if (!existing) {
+                throw new Error(`Path not found: ${key}`);
+            }
+            // Return a shallow copy to avoid external mutation of returned metadata
+            return Object.assign({}, existing.details);
+        });
+    }
+    listFiles(folderPath_1) {
+        return __awaiter(this, arguments, void 0, function* (folderPath, filter = "all") {
+            const baseFolder = this.normalizeKey(folderPath);
+            const results = [];
+            for (const [, entry] of this._entries) {
+                const parts = entry.details.path.split(pathUtils_1.pathUtils.sep);
+                const parentFolder = parts.length > 1 ? parts.slice(0, parts.length - 1).join(pathUtils_1.pathUtils.sep) : "";
+                if (parentFolder === baseFolder) {
+                    if (filter === "all" ||
+                        (filter === "files" && !entry.details.isFolder) ||
+                        (filter === "folders" && entry.details.isFolder)) {
+                        // Return a shallow copy to avoid external mutation of returned metadata
+                        results.push(Object.assign({}, entry.details));
+                    }
+                }
+            }
+            return results;
+        });
+    }
+    pathExists(fileOrFolderPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const key = this.normalizeKey(fileOrFolderPath);
+            return this._entries.has(key);
+        });
+    }
+    readFile(filePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const key = this.normalizeKey(filePath);
+            const existing = this._entries.get(key);
+            if (!existing) {
+                throw new Error(`File not found: ${key}`);
+            }
+            if (existing.details.isFolder) {
+                throw new Error(`Cannot read file: ${key} is a folder`);
+            }
+            // Return a copy of the buffer to protect internal buffer from external mutation; fall back to empty buffer
+            const content = (_a = existing.content) !== null && _a !== void 0 ? _a : Buffer.from("", "utf8");
+            return Buffer.from(content);
+        });
+    }
+    upsertFile(filePath, content) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const key = this.normalizeKey(filePath);
+            const existing = this._entries.get(key);
+            if (existing && existing.details.isFolder) {
+                throw new Error(`Cannot write file: ${key} is a folder`);
+            }
+            const buffer = typeof content === "string" ? Buffer.from(content, "utf8") : content;
+            this._entries.set(key, {
+                details: {
+                    name: pathUtils_1.pathUtils.basename(key),
+                    path: key,
+                    isFolder: false,
+                    fileType: FileStorageUtilities_1.FileStorageUtilities.getFileType(key),
+                },
+                // Clone to avoid external mutation of stored buffers (and keep Buffer type)
+                content: Buffer.from(buffer),
+            });
+        });
+    }
+}
+exports.VirtualFileStorage = VirtualFileStorage;
+//# sourceMappingURL=VirtualFileStorage.js.map