vectra 0.12.3 → 0.14.0

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":";;;;;;;;;;;;;;AAAA,8DAAiC;AACjC,kDAA0B;AAC1B,2DAA6B;AAC7B,gDAAwB;AACxB,yDAAsD;AACtD,iEAA8D;AAE9D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,OAAyB,CAAC;IAE9B,SAAS,CAAC,GAAS,EAAE;QACnB,eAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAA,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;YAC1E,OAAO,GAAG,IAAI,mCAAgB,EAAE,CAAC;YACjC,qCAAqC;YACrC,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,OAAO,GAAG,IAAI,mCAAgB,EAAE,CAAC;YACjC,qCAAqC;YACrC,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACrE,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;YACxC,qCAAqC;YACrC,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;YACxC,qCAAqC;YACrC,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,EAAE,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;QAC7F,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAS,EAAE;YACrD,MAAM,aAAa,GAAG,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC9C,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClG,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAS,EAAE;YAC9D,MAAM,aAAa,GAAG,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,OAAO,CAAC;YACxB,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC9C,eAAK,CAAC,MAAM,CAAC,UAAU,CACrB,aAAa,EACb,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAC5B,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;QACJ,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAS,EAAE;YACvD,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACzD,MAAM,qBAAM,CAAC,OAAO,CAAC,GAAS,EAAE;gBAC9B,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAClD,CAAC,CAAA,CAAC,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAS,EAAE;YACnE,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACzD,MAAM,qBAAM,CAAC,OAAO,CAAC,GAAS,EAAE;gBAC9B,MAAM,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC;YAC9D,CAAC,CAAA,CAAC,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAS,EAAE;YAC9D,MAAM,SAAS,GAAG,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;YACrD,MAAM,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;YAC5C,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/F,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,iFAAiF,EAAE,GAAS,EAAE;YAC/F,MAAM,SAAS,GAAG,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;YACrD,MAAM,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;YAC5C,MAAM,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;YAC5C,eAAK,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uBAAuB,EAAE,GAAS,EAAE;YACrC,MAAM,UAAU,GAAG,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;YACvD,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACrC,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QACtE,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAS,EAAE;YACzD,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACtD,MAAM,qBAAM,CAAC,OAAO,CAAC,GAAS,EAAE;gBAC9B,MAAM,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAC1C,CAAC,CAAA,CAAC,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAS,EAAE;YACnD,MAAM,MAAM,GAAG,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC/C,MAAM,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACrC,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAS,EAAE;YAC3D,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAClD,MAAM,qBAAM,CAAC,OAAO,CAAC,GAAS,EAAE;gBAC9B,MAAM,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YACxC,CAAC,CAAA,CAAC,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAS,EAAE;YAChD,MAAM,QAAQ,GAAG,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC;gBAC/C,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK;gBACxB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI;aACZ,CAAC,CAAC;YACV,MAAM,eAAe,GAAG,eAAK,CAAC,IAAI,CAAC,2CAAoB,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAEvF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACrD,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC7C,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC7C,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC5C,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAE5C,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;YAClE,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QACvD,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAS,EAAE;YAClD,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC;gBAC9B,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI;gBACvB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK;aACb,CAAC,CAAC;YAEV,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACnD,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC3C,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC3C,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC3C,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAClD,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAS,EAAE;YACtD,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACpD,MAAM,qBAAM,CAAC,OAAO,CAAC,GAAS,EAAE;gBAC9B,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACtC,CAAC,CAAA,CAAC,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAS,EAAE;YACpE,MAAM,OAAO,GAAG;gBACd,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE;gBACnE,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE;aACpE,CAAC;YACF,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAc,CAAC,CAAC;YACnD,MAAM,eAAe,GAAG,eAAK,CAAC,IAAI,CAAC,2CAAoB,EAAE,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,IAAY,EAAE,EAAE;gBACjG,IAAI,IAAI,KAAK,WAAW;oBAAE,OAAO,KAAK,CAAC;gBACvC,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAClD,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAEtC,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACjD,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;YAC/E,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC/C,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAE/C,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACjD,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;YAC/E,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC9C,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAEnD,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QACxD,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,yBAAyB,EAAE,GAAS,EAAE;YACvC,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,EAAS,CAAC,CAAC;YACxE,qBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YAClC,qBAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAS,EAAE;YACxD,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACpD,qBAAM,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAS,EAAE;YACnD,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACnD,qBAAM,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAS,EAAE;YAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrC,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAClD,qBAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAS,EAAE;YACzD,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACxD,MAAM,qBAAM,CAAC,OAAO,CAAC,GAAS,EAAE;gBAC9B,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YACxC,CAAC,CAAA,CAAC,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,GAAG,IAAI,mCAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAS,EAAE;YAC5C,MAAM,aAAa,GAAG,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7D,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAChD,eAAK,CAAC,MAAM,CAAC,UAAU,CACrB,aAAa,EACb,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAC9B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAC9B,EAAE,IAAI,EAAE,GAAG,EAAE,CACd,CAAC;QACJ,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAS,EAAE;YACxC,MAAM,aAAa,GAAG,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7D,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YACjE,eAAK,CAAC,MAAM,CAAC,UAAU,CACrB,aAAa,EACb,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAC9B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAC1B,EAAE,IAAI,EAAE,GAAG,EAAE,CACd,CAAC;QACJ,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAS,EAAE;YACnE,eAAK,CAAC,IAAI,CAAC,kBAAE,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACzD,MAAM,qBAAM,CAAC,OAAO,CAAC,GAAS,EAAE;gBAC9B,MAAM,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC;YAC9D,CAAC,CAAA,CAAC,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

package/lib/storage/VirtualFileStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualFileStorage.js","sourceRoot":"","sources":["../../src/storage/VirtualFileStorage.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,kDAAuD;AACvD,iEAA8D;AAE9D;;GAEG;AACH,MAAa,kBAAkB;IAA/B;QACmB,aAAQ,GAA4B,IAAI,GAAG,EAAE,CAAC;IAwJjE,CAAC;IAtJC,qDAAqD;IACrD,2CAA2C;IAC3C,sEAAsE;IACtE,gEAAgE;IACxD,YAAY,CAAC,GAAW;QAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAChC,IAAI,UAAU,GAAG,qBAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,QAAQ,CAAC,qBAAI,CAAC,GAAG,CAAC,IAAI,UAAU,KAAK,qBAAI,CAAC,GAAG,EAAE,CAAC;YAC7D,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAEY,UAAU,CAAC,QAAgB,EAAE,OAAwB;;YAChE,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACpF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,qBAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;oBACxB,IAAI,EAAE,GAAG;oBACT,QAAQ,EAAE,KAAK;oBACf,QAAQ,EAAE,2CAAoB,CAAC,WAAW,CAAC,GAAG,CAAC;iBAChD;gBACD,4EAA4E;gBAC5E,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC7B,CAAC,CAAC;QACL,CAAC;KAAA;IAEY,YAAY,CAAC,UAAkB;;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;oBAC/B,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,YAAY,CAAC,CAAC;gBAC5D,CAAC;gBACD,0CAA0C;gBAC1C,OAAO;YACT,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,qBAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;oBACxB,IAAI,EAAE,GAAG;oBACT,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,SAAS;iBACpB;aACF,CAAC,CAAC;QACL,CAAC;KAAA;IAEY,UAAU,CAAC,QAAgB;;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,sBAAsB;gBACtB,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,cAAc,CAAC,CAAC;YAC5D,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;KAAA;IAEY,YAAY,CAAC,UAAkB;;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,sBAAsB;gBACtB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,YAAY,CAAC,CAAC;YAC5D,CAAC;YACD,oEAAoE;YACpE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;KAAA;IAEY,UAAU,CAAC,gBAAwB;;YAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,wEAAwE;YACxE,yBAAY,QAAQ,CAAC,OAAO,EAAG;QACjC,CAAC;KAAA;IAEY,SAAS;6DACpB,UAAkB,EAClB,SAA0B,KAAK;YAE/B,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YAEjD,MAAM,OAAO,GAAkB,EAAE,CAAC;YAClC,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACtC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAI,CAAC,GAAG,CAAC,CAAC;gBACjD,MAAM,YAAY,GAChB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;oBAChC,IACE,MAAM,KAAK,KAAK;wBAChB,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;wBAC/C,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAChD,CAAC;wBACD,wEAAwE;wBACxE,OAAO,CAAC,IAAI,mBAAM,KAAK,CAAC,OAAO,EAAG,CAAC;oBACrC,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KAAA;IAEY,UAAU,CAAC,gBAAwB;;YAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;KAAA;IAEY,QAAQ,CAAC,QAAgB;;;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,cAAc,CAAC,CAAC;YAC1D,CAAC;YACD,2GAA2G;YAC3G,MAAM,OAAO,GAAG,MAAA,QAAQ,CAAC,OAAO,mCAAI,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;KAAA;IAEY,UAAU,CAAC,QAAgB,EAAE,OAAwB;;YAChE,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,cAAc,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACpF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,qBAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;oBACxB,IAAI,EAAE,GAAG;oBACT,QAAQ,EAAE,KAAK;oBACf,QAAQ,EAAE,2CAAoB,CAAC,WAAW,CAAC,GAAG,CAAC;iBAChD;gBACD,4EAA4E;gBAC5E,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC7B,CAAC,CAAC;QACL,CAAC;KAAA;CACF;AAzJD,gDAyJC"}

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

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

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

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