vectra 0.12.3 → 0.14.0

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

package/lib/server/handlers/helpers.js

@@ -0,0 +1,138 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromProtoMetadata = fromProtoMetadata;
+exports.toProtoMetadata = toProtoMetadata;
+exports.parseFilterJson = parseFilterJson;
+exports.grpcError = grpcError;
+exports.wrapHandler = wrapHandler;
+const grpc = __importStar(require("@grpc/grpc-js"));
+/**
+ * Converts proto MetadataValue map to a plain JS record.
+ */
+function fromProtoMetadata(protoMeta) {
+    var _a, _b, _c;
+    const result = {};
+    if (!protoMeta)
+        return result;
+    for (const [key, val] of Object.entries(protoMeta)) {
+        if (val && typeof val === 'object') {
+            if ('string_value' in val || 'stringValue' in val) {
+                result[key] = (_a = val.string_value) !== null && _a !== void 0 ? _a : val.stringValue;
+            }
+            else if ('number_value' in val || 'numberValue' in val) {
+                result[key] = (_b = val.number_value) !== null && _b !== void 0 ? _b : val.numberValue;
+            }
+            else if ('bool_value' in val || 'boolValue' in val) {
+                result[key] = (_c = val.bool_value) !== null && _c !== void 0 ? _c : val.boolValue;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Converts a plain JS metadata record to proto MetadataValue map.
+ */
+function toProtoMetadata(meta) {
+    const result = {};
+    if (!meta)
+        return result;
+    for (const [key, val] of Object.entries(meta)) {
+        if (typeof val === 'string') {
+            result[key] = { string_value: val };
+        }
+        else if (typeof val === 'number') {
+            result[key] = { number_value: val };
+        }
+        else if (typeof val === 'boolean') {
+            result[key] = { bool_value: val };
+        }
+    }
+    return result;
+}
+/**
+ * Parses the filter_json field from a MetadataFilter proto message.
+ */
+function parseFilterJson(filter) {
+    if (!filter || !filter.filter_json || filter.filter_json === '') {
+        return undefined;
+    }
+    try {
+        return JSON.parse(filter.filter_json);
+    }
+    catch (_a) {
+        throw grpcError(grpc.status.INVALID_ARGUMENT, 'Invalid filter_json: must be valid JSON');
+    }
+}
+/**
+ * Creates a gRPC ServiceError with the given status code and message.
+ */
+function grpcError(code, message) {
+    const err = new Error(message);
+    err.code = code;
+    err.details = message;
+    err.metadata = new grpc.Metadata();
+    return err;
+}
+/**
+ * Wraps an async handler function with standard error mapping.
+ */
+function wrapHandler(handler) {
+    return (call, callback) => {
+        handler(call)
+            .then(result => callback(null, result))
+            .catch(err => {
+            if (err && typeof err.code === 'number') {
+                callback(err);
+            }
+            else {
+                const message = (err === null || err === void 0 ? void 0 : err.message) || 'Internal server error';
+                if (message.includes('not found') || message.includes('does not exist')) {
+                    callback(grpcError(grpc.status.NOT_FOUND, message));
+                }
+                else if (message.includes('already exists')) {
+                    callback(grpcError(grpc.status.ALREADY_EXISTS, message));
+                }
+                else if (message.includes('not a document index')) {
+                    callback(grpcError(grpc.status.FAILED_PRECONDITION, message));
+                }
+                else {
+                    callback(grpcError(grpc.status.INTERNAL, message));
+                }
+            }
+        });
+    };
+}
+//# sourceMappingURL=helpers.js.map

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

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

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

@@ -0,0 +1,8 @@
+export { createIndexHandlers } from './indexHandlers';
+export { createItemHandlers } from './itemHandlers';
+export { createQueryHandlers } from './queryHandlers';
+export { createDocumentHandlers } from './documentHandlers';
+export { createStatsHandlers } from './statsHandlers';
+export { createLifecycleHandlers } from './lifecycleHandlers';
+export { grpcError, wrapHandler, fromProtoMetadata, toProtoMetadata, parseFilterJson } from './helpers';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}