vectra 0.12.2 → 0.14.0

package/lib/server/VectraServer.js

@@ -0,0 +1,151 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectraServer = void 0;
+const path = __importStar(require("path"));
+const grpc = __importStar(require("@grpc/grpc-js"));
+const protoLoader = __importStar(require("@grpc/proto-loader"));
+const IndexManager_1 = require("./IndexManager");
+const handlers_1 = require("./handlers");
+const DRAIN_TIMEOUT_MS = 5000;
+/**
+ * gRPC server that exposes Vectra indexes over the VectraService proto.
+ */
+class VectraServer {
+    constructor(config) {
+        this._startTime = 0;
+        this._config = config;
+        const managerConfig = {
+            indexPath: config.indexPath,
+            rootDir: config.rootDir,
+            embeddings: config.embeddings,
+            scanInterval: config.scanInterval,
+        };
+        this._indexManager = new IndexManager_1.IndexManager(managerConfig);
+    }
+    /** The underlying IndexManager. */
+    get indexManager() {
+        return this._indexManager;
+    }
+    /** The underlying gRPC server instance. */
+    get server() {
+        return this._server;
+    }
+    /**
+     * Starts the gRPC server and loads indexes.
+     * @returns The port the server is listening on.
+     */
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            this._startTime = Date.now();
+            // Load proto definition
+            const protoPath = path.resolve(__dirname, '..', '..', 'proto', 'vectra_service.proto');
+            const packageDefinition = protoLoader.loadSync(protoPath, {
+                keepCase: true,
+                longs: Number,
+                enums: String,
+                defaults: true,
+                oneofs: true,
+            });
+            const protoDescriptor = grpc.loadPackageDefinition(packageDefinition);
+            const vectraService = protoDescriptor.vectra.VectraService;
+            // Initialize index manager
+            yield this._indexManager.initialize();
+            // Create gRPC server
+            this._server = new grpc.Server();
+            // Register all handler groups
+            const indexHandlers = (0, handlers_1.createIndexHandlers)(this._indexManager);
+            const itemHandlers = (0, handlers_1.createItemHandlers)(this._indexManager, this._config.embeddings);
+            const queryHandlers = (0, handlers_1.createQueryHandlers)(this._indexManager, this._config.embeddings);
+            const documentHandlers = (0, handlers_1.createDocumentHandlers)(this._indexManager);
+            const statsHandlers = (0, handlers_1.createStatsHandlers)(this._indexManager);
+            const lifecycleHandlers = (0, handlers_1.createLifecycleHandlers)(this._indexManager, this._startTime, () => this.shutdown());
+            this._server.addService(vectraService.service, Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, indexHandlers), itemHandlers), queryHandlers), documentHandlers), statsHandlers), lifecycleHandlers));
+            // Bind to localhost only
+            const port = (_a = this._config.port) !== null && _a !== void 0 ? _a : 50051;
+            const boundPort = yield new Promise((resolve, reject) => {
+                this._server.bindAsync(`127.0.0.1:${port}`, grpc.ServerCredentials.createInsecure(), (err, actualPort) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        resolve(actualPort);
+                    }
+                });
+            });
+            return boundPort;
+        });
+    }
+    /**
+     * Gracefully shuts down the server with a 5s draining timeout.
+     */
+    shutdown() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._shutdownPromise)
+                return this._shutdownPromise;
+            this._shutdownPromise = (() => __awaiter(this, void 0, void 0, function* () {
+                // Stop index manager scanning
+                yield this._indexManager.shutdown();
+                if (!this._server)
+                    return;
+                // Try graceful shutdown with timeout
+                yield new Promise((resolve) => {
+                    const timer = setTimeout(() => {
+                        this._server.forceShutdown();
+                        resolve();
+                    }, DRAIN_TIMEOUT_MS);
+                    this._server.tryShutdown((err) => {
+                        clearTimeout(timer);
+                        resolve();
+                    });
+                });
+                this._server = undefined;
+            }))();
+            return this._shutdownPromise;
+        });
+    }
+}
+exports.VectraServer = VectraServer;
+//# sourceMappingURL=VectraServer.js.map

package/lib/server/VectraServer.js.map

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

package/lib/server/VectraServer.spec.d.ts

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

package/lib/server/VectraServer.spec.d.ts.map

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

package/lib/server/VectraServer.spec.js

@@ -0,0 +1,322 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert = __importStar(require("assert"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const grpc = __importStar(require("@grpc/grpc-js"));
+const protoLoader = __importStar(require("@grpc/proto-loader"));
+const VectraServer_1 = require("./VectraServer");
+const TEST_ROOT = path.join(__dirname, '..', '..', '.test-server-root');
+const PROTO_PATH = path.join(__dirname, '..', '..', 'proto', 'vectra_service.proto');
+function loadClient(port) {
+    const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
+        keepCase: true,
+        longs: Number,
+        enums: String,
+        defaults: true,
+        oneofs: true,
+    });
+    const proto = grpc.loadPackageDefinition(packageDefinition);
+    return new proto.vectra.VectraService(`127.0.0.1:${port}`, grpc.credentials.createInsecure());
+}
+function rpc(client, method, request) {
+    return new Promise((resolve, reject) => {
+        client[method](request, (err, response) => {
+            if (err)
+                reject(err);
+            else
+                resolve(response);
+        });
+    });
+}
+function cleanTestDir() {
+    if (fs.existsSync(TEST_ROOT)) {
+        fs.rmSync(TEST_ROOT, { recursive: true });
+    }
+    fs.mkdirSync(TEST_ROOT, { recursive: true });
+}
+describe('VectraServer', function () {
+    this.timeout(30000);
+    let server;
+    let client;
+    let port;
+    before(() => __awaiter(this, void 0, void 0, function* () {
+        cleanTestDir();
+        server = new VectraServer_1.VectraServer({
+            port: 0, // random available port
+            rootDir: TEST_ROOT,
+            scanInterval: 500,
+        });
+        port = yield server.start();
+        client = loadClient(port);
+    }));
+    after(() => __awaiter(this, void 0, void 0, function* () {
+        if (client) {
+            client.close();
+        }
+        if (server) {
+            yield server.shutdown();
+        }
+        if (fs.existsSync(TEST_ROOT)) {
+            fs.rmSync(TEST_ROOT, { recursive: true });
+        }
+    }));
+    describe('Lifecycle RPCs', () => {
+        it('should respond to Healthcheck', () => __awaiter(this, void 0, void 0, function* () {
+            const res = yield rpc(client, 'Healthcheck', {});
+            assert.strictEqual(res.status, 'ok');
+            assert.strictEqual(typeof res.uptime_seconds, 'number');
+            assert.strictEqual(typeof res.loaded_indexes, 'number');
+        }));
+    });
+    describe('Index Management RPCs', () => {
+        it('should create an index', () => __awaiter(this, void 0, void 0, function* () {
+            yield rpc(client, 'CreateIndex', {
+                index_name: 'test-index',
+                format: 'json',
+                is_document_index: false,
+            });
+            const list = yield rpc(client, 'ListIndexes', {});
+            const names = list.indexes.map((i) => i.name);
+            assert.ok(names.includes('test-index'), `Expected test-index in ${JSON.stringify(names)}`);
+        }));
+        it('should fail to create a duplicate index', () => __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield rpc(client, 'CreateIndex', {
+                    index_name: 'test-index',
+                    format: 'json',
+                    is_document_index: false,
+                });
+                assert.fail('Expected ALREADY_EXISTS error');
+            }
+            catch (err) {
+                assert.strictEqual(err.code, grpc.status.ALREADY_EXISTS);
+            }
+        }));
+        it('should list indexes', () => __awaiter(this, void 0, void 0, function* () {
+            const res = yield rpc(client, 'ListIndexes', {});
+            assert.ok(Array.isArray(res.indexes));
+            assert.ok(res.indexes.length >= 1);
+        }));
+    });
+    describe('Item Operations RPCs', () => {
+        const testVector = new Array(3).fill(0).map((_, i) => (i + 1) * 0.1);
+        it('should insert an item', () => __awaiter(this, void 0, void 0, function* () {
+            const res = yield rpc(client, 'InsertItem', {
+                index_name: 'test-index',
+                vector: testVector,
+                metadata: {
+                    category: { string_value: 'test' },
+                    score: { number_value: 0.95 },
+                },
+                id: 'item-1',
+            });
+            assert.strictEqual(res.id, 'item-1');
+        }));
+        it('should get an item by id', () => __awaiter(this, void 0, void 0, function* () {
+            const res = yield rpc(client, 'GetItem', {
+                index_name: 'test-index',
+                id: 'item-1',
+            });
+            assert.ok(res.item);
+            assert.strictEqual(res.item.id, 'item-1');
+            assert.ok(res.item.vector.length > 0);
+        }));
+        it('should return NOT_FOUND for missing item', () => __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield rpc(client, 'GetItem', {
+                    index_name: 'test-index',
+                    id: 'nonexistent',
+                });
+                assert.fail('Expected NOT_FOUND error');
+            }
+            catch (err) {
+                assert.strictEqual(err.code, grpc.status.NOT_FOUND);
+            }
+        }));
+        it('should upsert an item', () => __awaiter(this, void 0, void 0, function* () {
+            const newVector = new Array(3).fill(0).map((_, i) => (i + 1) * 0.2);
+            const res = yield rpc(client, 'UpsertItem', {
+                index_name: 'test-index',
+                id: 'item-1',
+                vector: newVector,
+                metadata: {
+                    category: { string_value: 'updated' },
+                },
+            });
+            assert.strictEqual(res.id, 'item-1');
+            // Verify update
+            const getRes = yield rpc(client, 'GetItem', {
+                index_name: 'test-index',
+                id: 'item-1',
+            });
+            assert.strictEqual(getRes.item.metadata.category.string_value, 'updated');
+        }));
+        it('should batch insert items', () => __awaiter(this, void 0, void 0, function* () {
+            const res = yield rpc(client, 'BatchInsertItems', {
+                index_name: 'test-index',
+                items: [
+                    { vector: [0.1, 0.2, 0.3], metadata: { tag: { string_value: 'a' } }, id: 'batch-1' },
+                    { vector: [0.4, 0.5, 0.6], metadata: { tag: { string_value: 'b' } }, id: 'batch-2' },
+                ],
+            });
+            assert.strictEqual(res.ids.length, 2);
+            assert.ok(res.ids.includes('batch-1'));
+            assert.ok(res.ids.includes('batch-2'));
+        }));
+        it('should list items', () => __awaiter(this, void 0, void 0, function* () {
+            const res = yield rpc(client, 'ListItems', {
+                index_name: 'test-index',
+            });
+            assert.ok(res.items.length >= 3); // item-1, batch-1, batch-2
+        }));
+        it('should delete an item', () => __awaiter(this, void 0, void 0, function* () {
+            yield rpc(client, 'DeleteItem', {
+                index_name: 'test-index',
+                id: 'batch-2',
+            });
+            // Verify it's gone
+            try {
+                yield rpc(client, 'GetItem', {
+                    index_name: 'test-index',
+                    id: 'batch-2',
+                });
+                assert.fail('Expected NOT_FOUND');
+            }
+            catch (err) {
+                assert.strictEqual(err.code, grpc.status.NOT_FOUND);
+            }
+        }));
+    });
+    describe('Query RPCs', () => {
+        it('should query items by vector', () => __awaiter(this, void 0, void 0, function* () {
+            const res = yield rpc(client, 'QueryItems', {
+                index_name: 'test-index',
+                vector: [0.1, 0.2, 0.3],
+                top_k: 5,
+            });
+            assert.ok(Array.isArray(res.results));
+            assert.ok(res.results.length > 0);
+            // Results should have scores
+            assert.ok(typeof res.results[0].score === 'number');
+        }));
+    });
+    describe('Stats RPCs', () => {
+        it('should get index stats', () => __awaiter(this, void 0, void 0, function* () {
+            const res = yield rpc(client, 'GetIndexStats', {
+                index_name: 'test-index',
+            });
+            assert.strictEqual(res.version, 1);
+            assert.strictEqual(res.format, 'json');
+            assert.ok(typeof res.item_count === 'number');
+        }));
+    });
+    describe('Error handling', () => {
+        it('should return NOT_FOUND for unknown index', () => __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield rpc(client, 'GetIndexStats', {
+                    index_name: 'no-such-index',
+                });
+                assert.fail('Expected NOT_FOUND');
+            }
+            catch (err) {
+                assert.strictEqual(err.code, grpc.status.NOT_FOUND);
+            }
+        }));
+        it('should return INVALID_ARGUMENT for missing required fields', () => __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield rpc(client, 'InsertItem', {
+                    index_name: 'test-index',
+                    // no text or vector
+                });
+                assert.fail('Expected INVALID_ARGUMENT');
+            }
+            catch (err) {
+                assert.strictEqual(err.code, grpc.status.INVALID_ARGUMENT);
+            }
+        }));
+        it('should return FAILED_PRECONDITION for non-document index on document ops', () => __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield rpc(client, 'ListDocuments', {
+                    index_name: 'test-index',
+                });
+                assert.fail('Expected FAILED_PRECONDITION');
+            }
+            catch (err) {
+                assert.strictEqual(err.code, grpc.status.FAILED_PRECONDITION);
+            }
+        }));
+    });
+    describe('Index deletion', () => {
+        it('should delete an index', () => __awaiter(this, void 0, void 0, function* () {
+            yield rpc(client, 'DeleteIndex', {
+                index_name: 'test-index',
+            });
+            const list = yield rpc(client, 'ListIndexes', {});
+            const names = list.indexes.map((i) => i.name);
+            assert.ok(!names.includes('test-index'));
+        }));
+    });
+    describe('Auto-detect new indexes', () => {
+        it('should detect indexes created on disk', function () {
+            return __awaiter(this, void 0, void 0, function* () {
+                // Create an index directly on disk (outside the gRPC API)
+                const indexDir = path.join(TEST_ROOT, 'auto-detected');
+                fs.mkdirSync(indexDir, { recursive: true });
+                fs.writeFileSync(path.join(indexDir, 'index.json'), JSON.stringify({
+                    version: 1,
+                    metadata_config: {},
+                    items: [],
+                }));
+                // Wait for the scanner to pick it up
+                yield new Promise(r => setTimeout(r, 1500));
+                const list = yield rpc(client, 'ListIndexes', {});
+                const names = list.indexes.map((i) => i.name);
+                assert.ok(names.includes('auto-detected'), `Expected auto-detected in ${JSON.stringify(names)}`);
+            });
+        });
+    });
+});
+//# sourceMappingURL=VectraServer.spec.js.map

package/lib/server/VectraServer.spec.js.map

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

package/lib/server/handlers/documentHandlers.d.ts

@@ -0,0 +1,15 @@
+import * as grpc from '@grpc/grpc-js';
+import { IndexManager } from '../IndexManager';
+export declare function createDocumentHandlers(manager: IndexManager): {
+    UpsertDocument: grpc.handleUnaryCall<any, {
+        document_id: string;
+    }>;
+    DeleteDocument: grpc.handleUnaryCall<any, {}>;
+    ListDocuments: grpc.handleUnaryCall<any, {
+        documents: {
+            uri: string;
+            document_id: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=documentHandlers.d.ts.map

package/lib/server/handlers/documentHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentHandlers.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/documentHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY;;;;;;;;;;;EAsD3D"}

package/lib/server/handlers/documentHandlers.js

@@ -0,0 +1,95 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDocumentHandlers = createDocumentHandlers;
+const grpc = __importStar(require("@grpc/grpc-js"));
+const helpers_1 = require("./helpers");
+function createDocumentHandlers(manager) {
+    return {
+        UpsertDocument: (0, helpers_1.wrapHandler)((call) => __awaiter(this, void 0, void 0, function* () {
+            const req = call.request;
+            if (!req.index_name) {
+                throw (0, helpers_1.grpcError)(grpc.status.INVALID_ARGUMENT, 'index_name is required');
+            }
+            if (!req.uri) {
+                throw (0, helpers_1.grpcError)(grpc.status.INVALID_ARGUMENT, 'uri is required');
+            }
+            if (!req.text) {
+                throw (0, helpers_1.grpcError)(grpc.status.INVALID_ARGUMENT, 'text is required');
+            }
+            const { docIndex } = manager.requireDocumentIndex(req.index_name);
+            const metadata = (0, helpers_1.fromProtoMetadata)(req.metadata);
+            const metadataArg = Object.keys(metadata).length > 0 ? metadata : undefined;
+            const doc = yield docIndex.upsertDocument(req.uri, req.text, req.doc_type || undefined, metadataArg);
+            return { document_id: doc.id };
+        })),
+        DeleteDocument: (0, helpers_1.wrapHandler)((call) => __awaiter(this, void 0, void 0, function* () {
+            const req = call.request;
+            if (!req.index_name) {
+                throw (0, helpers_1.grpcError)(grpc.status.INVALID_ARGUMENT, 'index_name is required');
+            }
+            if (!req.uri) {
+                throw (0, helpers_1.grpcError)(grpc.status.INVALID_ARGUMENT, 'uri is required');
+            }
+            const { docIndex } = manager.requireDocumentIndex(req.index_name);
+            yield docIndex.deleteDocument(req.uri);
+            return {};
+        })),
+        ListDocuments: (0, helpers_1.wrapHandler)((call) => __awaiter(this, void 0, void 0, function* () {
+            const req = call.request;
+            if (!req.index_name) {
+                throw (0, helpers_1.grpcError)(grpc.status.INVALID_ARGUMENT, 'index_name is required');
+            }
+            const { docIndex } = manager.requireDocumentIndex(req.index_name);
+            const docs = yield docIndex.listDocuments();
+            return {
+                documents: docs.map(doc => ({
+                    uri: doc.uri,
+                    document_id: doc.id,
+                })),
+            };
+        })),
+    };
+}
+//# sourceMappingURL=documentHandlers.js.map

package/lib/server/handlers/documentHandlers.js.map

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

package/lib/server/handlers/helpers.d.ts

@@ -0,0 +1,23 @@
+import * as grpc from '@grpc/grpc-js';
+import { MetadataTypes } from '../../types';
+/**
+ * Converts proto MetadataValue map to a plain JS record.
+ */
+export declare function fromProtoMetadata(protoMeta: Record<string, any> | undefined): Record<string, MetadataTypes>;
+/**
+ * Converts a plain JS metadata record to proto MetadataValue map.
+ */
+export declare function toProtoMetadata(meta: Record<string, MetadataTypes> | undefined): Record<string, any>;
+/**
+ * Parses the filter_json field from a MetadataFilter proto message.
+ */
+export declare function parseFilterJson(filter: any): Record<string, any> | undefined;
+/**
+ * Creates a gRPC ServiceError with the given status code and message.
+ */
+export declare function grpcError(code: grpc.status, message: string): grpc.ServiceError;
+/**
+ * Wraps an async handler function with standard error mapping.
+ */
+export declare function wrapHandler<TReq, TRes>(handler: (call: grpc.ServerUnaryCall<TReq, TRes>) => Promise<TRes>): grpc.handleUnaryCall<TReq, TRes>;
+//# sourceMappingURL=helpers.d.ts.map

package/lib/server/handlers/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAe3G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAapG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAS5E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,YAAY,CAM/E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAClC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GACnE,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAqBlC"}