vectra 0.12.2 → 0.14.0

package/lib/storage/VirtualFileStorage.js.map

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

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":""}

package/lib/storage/VirtualFileStorage.spec.js

@@ -0,0 +1,302 @@
+"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 });
+const node_assert_1 = __importDefault(require("node:assert"));
+const path = __importStar(require("path"));
+const VirtualFileStorage_1 = require("./VirtualFileStorage");
+const FileStorageUtilities_1 = require("./FileStorageUtilities");
+describe('VirtualFileStorage', () => {
+    let storage;
+    beforeEach(() => {
+        storage = new VirtualFileStorage_1.VirtualFileStorage();
+    });
+    describe('createFile', () => {
+        it('creates a new file with string content', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'hello');
+            const details = yield storage.getDetails('file.txt');
+            node_assert_1.default.strictEqual(details.name, 'file.txt');
+            node_assert_1.default.strictEqual(details.path, path.normalize('file.txt'));
+            node_assert_1.default.strictEqual(details.isFolder, false);
+            node_assert_1.default.strictEqual(details.fileType, FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('file.txt')));
+            const content = yield storage.readFile('file.txt');
+            node_assert_1.default.deepStrictEqual(content, Buffer.from('hello', 'utf8'));
+        }));
+        it('creates a new file with Buffer content', () => __awaiter(void 0, void 0, void 0, function* () {
+            const buf = Buffer.from('buffer content');
+            yield storage.createFile('bufferfile.bin', buf);
+            const content = yield storage.readFile('bufferfile.bin');
+            node_assert_1.default.deepStrictEqual(content, buf);
+        }));
+        it('throws when file already exists (including folder at path)', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('dup.txt', 'content');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFile('dup.txt', 'new content');
+            }), /File already exists/);
+            yield storage.createFolder('folder');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFile('folder', 'content');
+            }), /File already exists/);
+        }));
+        it('throws when creating file with normalized duplicate path', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('a/../b/file.txt', 'content');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFile('b/file.txt', 'content');
+            }), /File already exists/);
+        }));
+    });
+    describe('createFolder', () => {
+        it('creates a new folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('myfolder');
+            const details = yield storage.getDetails('myfolder');
+            node_assert_1.default.strictEqual(details.name, 'myfolder');
+            node_assert_1.default.strictEqual(details.isFolder, true);
+            node_assert_1.default.strictEqual(details.fileType, undefined);
+        }));
+        it('is idempotent when folder already exists', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('myfolder');
+            yield storage.createFolder('myfolder'); // no error
+        }));
+        it('throws when a file exists at that path', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFolder('file.txt');
+            }), /Cannot create folder/);
+        }));
+        it('does not create parent folders automatically', () => __awaiter(void 0, void 0, void 0, function* () {
+            // Implementation creates only the explicit folder entry
+            yield storage.createFolder('parent/child');
+            // Only 'parent/child' exists, not 'parent'
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.getDetails('parent');
+            }), /Path not found/);
+            const details = yield storage.getDetails('parent/child');
+            node_assert_1.default.strictEqual(details.isFolder, true);
+        }));
+    });
+    describe('deleteFile', () => {
+        it('deletes an existing file', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            yield storage.deleteFile('file.txt');
+            const exists = yield storage.pathExists('file.txt');
+            node_assert_1.default.strictEqual(exists, false);
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.readFile('file.txt');
+            }), /File not found/);
+        }));
+        it('throws when deleting a folder as file', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.deleteFile('folder');
+            }), /Cannot delete file/);
+        }));
+        it('no error when deleting non-existent file', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.deleteFile('nonexistent');
+        }));
+    });
+    describe('deleteFolder', () => {
+        it('deletes an existing folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            yield storage.deleteFolder('folder');
+            const exists = yield storage.pathExists('folder');
+            node_assert_1.default.strictEqual(exists, false);
+        }));
+        it('throws when deleting a file as folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.deleteFolder('file.txt');
+            }), /Cannot delete folder/);
+        }));
+        it('no error when deleting non-existent folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.deleteFolder('nonexistent');
+        }));
+        it('does not delete children when deleting folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('parent');
+            yield storage.createFile('parent/child.txt', 'content');
+            yield storage.deleteFolder('parent');
+            // Parent deleted
+            const parentExists = yield storage.pathExists('parent');
+            node_assert_1.default.strictEqual(parentExists, false);
+            // Child still exists
+            const childExists = yield storage.pathExists('parent/child.txt');
+            node_assert_1.default.strictEqual(childExists, true);
+        }));
+    });
+    describe('getDetails', () => {
+        it('returns details for existing file', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            const details = yield storage.getDetails('file.txt');
+            node_assert_1.default.strictEqual(details.name, 'file.txt');
+            node_assert_1.default.strictEqual(details.path, path.normalize('file.txt'));
+            node_assert_1.default.strictEqual(details.isFolder, false);
+            node_assert_1.default.strictEqual(details.fileType, FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('file.txt')));
+        }));
+        it('returns details for existing folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            const details = yield storage.getDetails('folder');
+            node_assert_1.default.strictEqual(details.name, 'folder');
+            node_assert_1.default.strictEqual(details.path, path.normalize('folder'));
+            node_assert_1.default.strictEqual(details.isFolder, true);
+            node_assert_1.default.strictEqual(details.fileType, undefined);
+        }));
+        it('throws for non-existent path', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.getDetails('missing');
+            }), /Path not found/);
+        }));
+    });
+    describe('listFiles', () => {
+        beforeEach(() => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('a');
+            yield storage.createFolder('a/b');
+            yield storage.createFile('a/file1.txt', 'content1');
+            yield storage.createFile('a/b/file2.txt', 'content2');
+            yield storage.createFolder('c');
+            yield storage.createFile('fileRoot.txt', 'root');
+        }));
+        it('returns immediate children only', () => __awaiter(void 0, void 0, void 0, function* () {
+            const listA = yield storage.listFiles('a');
+            (0, node_assert_1.default)(listA.some(e => e.name === 'file1.txt'));
+            (0, node_assert_1.default)(listA.some(e => e.name === 'b'));
+            (0, node_assert_1.default)(!listA.some(e => e.name === 'file2.txt'));
+            const listRoot = yield storage.listFiles('');
+            (0, node_assert_1.default)(listRoot.some(e => e.name === 'a'));
+            (0, node_assert_1.default)(listRoot.some(e => e.name === 'c'));
+            (0, node_assert_1.default)(listRoot.some(e => e.name === 'fileRoot.txt'));
+        }));
+        it('respects filter "all"', () => __awaiter(void 0, void 0, void 0, function* () {
+            const all = yield storage.listFiles('a', 'all');
+            (0, node_assert_1.default)(all.some(e => e.isFolder));
+            (0, node_assert_1.default)(all.some(e => !e.isFolder));
+        }));
+        it('respects filter "files"', () => __awaiter(void 0, void 0, void 0, function* () {
+            const files = yield storage.listFiles('a', 'files');
+            (0, node_assert_1.default)(files.every(e => !e.isFolder));
+            (0, node_assert_1.default)(files.some(e => e.name === 'file1.txt'));
+            (0, node_assert_1.default)(!files.some(e => e.name === 'b'));
+        }));
+        it('respects filter "folders"', () => __awaiter(void 0, void 0, void 0, function* () {
+            const folders = yield storage.listFiles('a', 'folders');
+            (0, node_assert_1.default)(folders.every(e => e.isFolder));
+            (0, node_assert_1.default)(folders.some(e => e.name === 'b'));
+            (0, node_assert_1.default)(!folders.some(e => e.name === 'file1.txt'));
+        }));
+        it('normalizes folderPath', () => __awaiter(void 0, void 0, void 0, function* () {
+            const list1 = yield storage.listFiles('a/');
+            const list2 = yield storage.listFiles('a');
+            node_assert_1.default.deepStrictEqual(list1, list2);
+        }));
+    });
+    describe('pathExists', () => {
+        it('returns true for existing file and folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            yield storage.createFolder('folder');
+            node_assert_1.default.strictEqual(yield storage.pathExists('file.txt'), true);
+            node_assert_1.default.strictEqual(yield storage.pathExists('folder'), true);
+        }));
+        it('returns false for missing path', () => __awaiter(void 0, void 0, void 0, function* () {
+            node_assert_1.default.strictEqual(yield storage.pathExists('missing'), false);
+        }));
+    });
+    describe('readFile', () => {
+        it('returns exact Buffer written', () => __awaiter(void 0, void 0, void 0, function* () {
+            const buf = Buffer.from('data');
+            yield storage.createFile('file.txt', buf);
+            const read = yield storage.readFile('file.txt');
+            node_assert_1.default.deepStrictEqual(read, buf);
+        }));
+        it('throws when path does not exist', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.readFile('missing.txt');
+            }), /File not found/);
+        }));
+        it('throws when path is a folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.readFile('folder');
+            }), /Cannot read file/);
+        }));
+        it('returns empty buffer if content is undefined (forced)', () => __awaiter(void 0, void 0, void 0, function* () {
+            // Force an entry with undefined content to hit the fallback branch
+            storage._entries.set('emptyfile.txt', {
+                details: {
+                    name: 'emptyfile.txt',
+                    path: path.normalize('emptyfile.txt'),
+                    isFolder: false,
+                    fileType: FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('emptyfile.txt')),
+                },
+                content: undefined,
+            });
+            const content = yield storage.readFile('emptyfile.txt');
+            node_assert_1.default.deepStrictEqual(content, Buffer.from('', 'utf8'));
+        }));
+    });
+    describe('upsertFile', () => {
+        it('creates new file when missing with string content', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.upsertFile('newfile.txt', 'content');
+            const details = yield storage.getDetails('newfile.txt');
+            node_assert_1.default.strictEqual(details.isFolder, false);
+            node_assert_1.default.strictEqual(details.fileType, FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('newfile.txt')));
+            const content = yield storage.readFile('newfile.txt');
+            node_assert_1.default.deepStrictEqual(content, Buffer.from('content', 'utf8'));
+        }));
+        it('replaces content of existing file and keeps correct fileType', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'old');
+            yield storage.upsertFile('file.txt', Buffer.from('new'));
+            const content = yield storage.readFile('file.txt');
+            node_assert_1.default.deepStrictEqual(content, Buffer.from('new'));
+            const details = yield storage.getDetails('file.txt');
+            node_assert_1.default.strictEqual(details.fileType, FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('file.txt')));
+        }));
+        it('throws when a folder exists at that path', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.upsertFile('folder', 'content');
+            }), /Cannot write file/);
+        }));
+    });
+});
+//# sourceMappingURL=VirtualFileStorage.spec.js.map

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

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

package/lib/storage/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./FileStorage";
+export * from "./FileStorageUtilities";
+export * from "./FileType";
+export * from "./LocalFileStorage";
+export * from "./VirtualFileStorage";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/lib/storage/index.js

@@ -0,0 +1,22 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./FileStorage"), exports);
+__exportStar(require("./FileStorageUtilities"), exports);
+__exportStar(require("./FileType"), exports);
+__exportStar(require("./LocalFileStorage"), exports);
+__exportStar(require("./VirtualFileStorage"), exports);
+//# sourceMappingURL=index.js.map

package/lib/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,yDAAuC;AACvC,6CAA2B;AAC3B,qDAAmC;AACnC,uDAAqC"}

package/lib/templates/templates/csharp/README.md

@@ -0,0 +1,48 @@
+# Vectra C# Client
+
+Thin idiomatic C# wrapper over the Vectra gRPC service.
+
+## Prerequisites
+
+Add these NuGet packages to your project:
+
+```bash
+dotnet add package Grpc.Net.Client
+dotnet add package Google.Protobuf
+dotnet add package Grpc.Tools
+```
+
+## Generate gRPC stubs
+
+Add to your `.csproj`:
+
+```xml
+<ItemGroup>
+  <Protobuf Include="vectra_service.proto" GrpcServices="Client" />
+</ItemGroup>
+```
+
+The stubs are generated automatically at build time by `Grpc.Tools`.
+
+## Usage
+
+```csharp
+using Vectra.Client;
+
+using var client = new VectraClient();
+
+// Create a document index
+await client.CreateIndexAsync("my-index", isDocumentIndex: true);
+
+// Add a document
+await client.UpsertDocumentAsync("my-index", "doc1.txt", "Hello world...");
+
+// Query
+var results = await client.QueryDocumentsAsync("my-index", "hello");
+foreach (var doc in results)
+{
+    Console.WriteLine($"{doc.Uri} (score: {doc.Score:F3})");
+    foreach (var chunk in doc.Chunks)
+        Console.WriteLine($"  {chunk.Text[..Math.Min(80, chunk.Text.Length)]}...");
+}
+```