hermes-client-typescript 1.4.49

package/README.md

@@ -0,0 +1,110 @@
+# hermes-client-typescript
+
+TypeScript client for [Hermes](https://github.com/SpaceFrontiers/hermes) search server.
+
+## Installation
+
+```bash
+pnpm add hermes-client-typescript
+```
+
+## Usage
+
+```typescript
+import { HermesClient } from "hermes-client-typescript";
+
+const client = new HermesClient("localhost:50051");
+client.connect();
+
+// Create index
+await client.createIndex(
+  "articles",
+  `
+  index articles {
+    title: text indexed stored
+    body: text indexed stored
+  }
+`,
+);
+
+// Index documents
+await client.indexDocuments("articles", [
+  { title: "Hello", body: "World" },
+  { title: "Foo", body: "Bar" },
+]);
+await client.commit("articles");
+
+// Search
+const results = await client.search("articles", {
+  term: ["title", "hello"],
+});
+for (const hit of results.hits) {
+  console.log(hit.docId, hit.score, hit.fields);
+}
+
+// Clean up
+client.close();
+```
+
+## API
+
+### Index Management
+
+- `createIndex(indexName, schema)` — Create a new index with SDL or JSON schema
+- `deleteIndex(indexName)` — Delete an index
+- `listIndexes()` — List all index names
+- `getIndexInfo(indexName)` — Get index metadata (doc count, segments, schema)
+
+### Document Indexing
+
+- `indexDocuments(indexName, docs)` — Batch index documents, returns `[indexedCount, errorCount]`
+- `indexDocument(indexName, doc)` — Index a single document
+- `indexDocumentsStream(indexName, asyncIterable)` — Stream documents for indexing
+- `commit(indexName)` — Commit pending changes, returns total doc count
+- `forceMerge(indexName)` — Force merge segments
+
+### Search
+
+- `search(indexName, options)` — Search with term, boolean, sparse/dense vector queries
+- `getDocument(indexName, docId)` — Get document by ID
+
+### Search Options
+
+```typescript
+await client.search("docs", {
+  // Term query
+  term: ["field", "value"],
+
+  // Boolean query
+  boolean: {
+    must: [["title", "hello"]],
+    should: [["body", "world"]],
+  },
+
+  // Sparse vector (pre-tokenized)
+  sparseVector: ["embedding", [1, 5, 10], [0.5, 0.3, 0.2]],
+
+  // Sparse text (server-side tokenization)
+  sparseText: ["embedding", "what is machine learning?"],
+
+  // Dense vector
+  denseVector: ["embedding", [0.1, 0.2, 0.3]],
+
+  // Options
+  limit: 10,
+  offset: 0,
+  fieldsToLoad: ["title", "body"],
+  combiner: "sum", // "sum" | "max" | "avg"
+
+  // L2 reranker: [field, queryVector, l1Limit]
+  reranker: ["embedding", [0.1, 0.2], 100],
+});
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm run generate  # regenerate proto stubs
+pnpm run build     # compile TypeScript
+```

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Async Hermes client implementation.
+ */
+import { Document, SearchResponse, IndexInfo, SearchOptions } from "./types";
+export declare class HermesClient {
+    private address;
+    private channel;
+    private indexClient;
+    private searchClient;
+    constructor(address?: string);
+    /** Connect to the server. */
+    connect(): void;
+    /** Close the connection. */
+    close(): void;
+    private ensureConnected;
+    /** Create a new index. */
+    createIndex(indexName: string, schema: string): Promise<boolean>;
+    /** Delete an index. */
+    deleteIndex(indexName: string): Promise<boolean>;
+    /** List all indexes on the server. */
+    listIndexes(): Promise<string[]>;
+    /** Get information about an index. */
+    getIndexInfo(indexName: string): Promise<IndexInfo>;
+    /** Index multiple documents in batch. Returns [indexedCount, errorCount]. */
+    indexDocuments(indexName: string, documents: Record<string, any>[]): Promise<[number, number]>;
+    /** Index a single document. */
+    indexDocument(indexName: string, document: Record<string, any>): Promise<void>;
+    /** Stream documents for indexing. Returns number of indexed documents. */
+    indexDocumentsStream(indexName: string, documents: AsyncIterable<Record<string, any>>): Promise<number>;
+    /** Commit pending changes. Returns total number of documents. */
+    commit(indexName: string): Promise<number>;
+    /** Force merge all segments. Returns number of segments after merge. */
+    forceMerge(indexName: string): Promise<number>;
+    /** Search for documents. */
+    search(indexName: string, options?: SearchOptions): Promise<SearchResponse>;
+    /** Get a document by ID. Returns null if not found. */
+    getDocument(indexName: string, docId: number): Promise<Document | null>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,OAAO,EACL,QAAQ,EAER,cAAc,EACd,SAAS,EACT,aAAa,EAGd,MAAM,SAAS,CAAC;AAKjB,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA6B;gBAErC,OAAO,GAAE,MAA0B;IAI/C,6BAA6B;IAC7B,OAAO,IAAI,IAAI;IAMf,4BAA4B;IAC5B,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,eAAe;IAUvB,0BAA0B;IACpB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtE,uBAAuB;IACjB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtD,sCAAsC;IAChC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMtC,sCAAsC;IAChC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAezD,6EAA6E;IACvE,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAC/B,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAc5B,+BAA+B;IACzB,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;IAIhB,0EAA0E;IACpE,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC;IAgBlB,iEAAiE;IAC3D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMhD,wEAAwE;IAClE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpD,4BAA4B;IACtB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IA2CrF,uDAAuD;IACjD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAmB9E"}

package/dist/client.js

@@ -0,0 +1,368 @@
+"use strict";
+/**
+ * Async Hermes client implementation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HermesClient = void 0;
+const grpc_js_1 = require("@grpc/grpc-js");
+const nice_grpc_1 = require("nice-grpc");
+const hermes_1 = require("./generated/hermes");
+class HermesClient {
+    constructor(address = "localhost:50051") {
+        this.channel = null;
+        this.indexClient = null;
+        this.searchClient = null;
+        this.address = address;
+    }
+    /** Connect to the server. */
+    connect() {
+        this.channel = (0, nice_grpc_1.createChannel)(this.address, grpc_js_1.ChannelCredentials.createInsecure());
+        this.indexClient = (0, nice_grpc_1.createClient)(hermes_1.IndexServiceDefinition, this.channel);
+        this.searchClient = (0, nice_grpc_1.createClient)(hermes_1.SearchServiceDefinition, this.channel);
+    }
+    /** Close the connection. */
+    close() {
+        if (this.channel) {
+            this.channel.close();
+            this.channel = null;
+            this.indexClient = null;
+            this.searchClient = null;
+        }
+    }
+    ensureConnected() {
+        if (!this.indexClient || !this.searchClient) {
+            throw new Error("Client not connected. Call connect() first.");
+        }
+    }
+    // =========================================================================
+    // Index Management
+    // =========================================================================
+    /** Create a new index. */
+    async createIndex(indexName, schema) {
+        this.ensureConnected();
+        const response = await this.indexClient.createIndex({ indexName, schema });
+        return response.success;
+    }
+    /** Delete an index. */
+    async deleteIndex(indexName) {
+        this.ensureConnected();
+        const response = await this.indexClient.deleteIndex({ indexName });
+        return response.success;
+    }
+    /** List all indexes on the server. */
+    async listIndexes() {
+        this.ensureConnected();
+        const response = await this.indexClient.listIndexes({});
+        return response.indexNames;
+    }
+    /** Get information about an index. */
+    async getIndexInfo(indexName) {
+        this.ensureConnected();
+        const response = await this.searchClient.getIndexInfo({ indexName });
+        return {
+            indexName: response.indexName,
+            numDocs: response.numDocs,
+            numSegments: response.numSegments,
+            schema: response.schema,
+        };
+    }
+    // =========================================================================
+    // Document Indexing
+    // =========================================================================
+    /** Index multiple documents in batch. Returns [indexedCount, errorCount]. */
+    async indexDocuments(indexName, documents) {
+        this.ensureConnected();
+        const namedDocs = documents.map((doc) => ({
+            fields: toFieldEntries(doc),
+        }));
+        const response = await this.indexClient.batchIndexDocuments({
+            indexName,
+            documents: namedDocs,
+        });
+        return [response.indexedCount, response.errorCount];
+    }
+    /** Index a single document. */
+    async indexDocument(indexName, document) {
+        await this.indexDocuments(indexName, [document]);
+    }
+    /** Stream documents for indexing. Returns number of indexed documents. */
+    async indexDocumentsStream(indexName, documents) {
+        this.ensureConnected();
+        async function* requestIterator() {
+            for await (const doc of documents) {
+                yield {
+                    indexName,
+                    fields: toFieldEntries(doc),
+                };
+            }
+        }
+        const response = await this.indexClient.indexDocuments(requestIterator());
+        return response.indexedCount;
+    }
+    /** Commit pending changes. Returns total number of documents. */
+    async commit(indexName) {
+        this.ensureConnected();
+        const response = await this.indexClient.commit({ indexName });
+        return response.numDocs;
+    }
+    /** Force merge all segments. Returns number of segments after merge. */
+    async forceMerge(indexName) {
+        this.ensureConnected();
+        const response = await this.indexClient.forceMerge({ indexName });
+        return response.numSegments;
+    }
+    // =========================================================================
+    // Search
+    // =========================================================================
+    /** Search for documents. */
+    async search(indexName, options = {}) {
+        this.ensureConnected();
+        const query = buildQuery(options);
+        let reranker;
+        if (options.reranker) {
+            const [field, vector, limit] = options.reranker;
+            reranker = {
+                field,
+                vector,
+                limit,
+                combiner: rerankerCombinerToProto(options.rerankerCombiner ?? "log_sum_exp"),
+                combinerTemperature: 0,
+                combinerTopK: 0,
+                combinerDecay: 0,
+            };
+        }
+        const response = await this.searchClient.search({
+            indexName,
+            query,
+            limit: options.limit ?? 10,
+            offset: options.offset ?? 0,
+            fieldsToLoad: options.fieldsToLoad ?? [],
+            reranker,
+        });
+        const hits = response.hits.map((hit) => ({
+            docId: hit.docId,
+            score: hit.score,
+            fields: Object.fromEntries(Object.entries(hit.fields).map(([k, v]) => [k, fromFieldValue(v)])),
+        }));
+        return {
+            hits,
+            totalHits: response.totalHits,
+            tookMs: response.tookMs,
+        };
+    }
+    /** Get a document by ID. Returns null if not found. */
+    async getDocument(indexName, docId) {
+        this.ensureConnected();
+        try {
+            const response = await this.searchClient.getDocument({
+                indexName,
+                docId,
+            });
+            const fields = Object.fromEntries(Object.entries(response.fields).map(([k, v]) => [k, fromFieldValue(v)]));
+            return { fields };
+        }
+        catch (err) {
+            if (err?.code === 5) {
+                // NOT_FOUND
+                return null;
+            }
+            throw err;
+        }
+    }
+}
+exports.HermesClient = HermesClient;
+// =============================================================================
+// Helper functions
+// =============================================================================
+function isSparseVector(value) {
+    if (value.length === 0)
+        return false;
+    return value.every((item) => Array.isArray(item) &&
+        item.length === 2 &&
+        typeof item[0] === "number" &&
+        typeof item[1] === "number" &&
+        Number.isInteger(item[0]));
+}
+function isMultiSparseVector(value) {
+    if (value.length === 0)
+        return false;
+    return value.every((item) => Array.isArray(item) && isSparseVector(item));
+}
+function isDenseVector(value) {
+    if (value.length === 0)
+        return false;
+    return value.every((v) => typeof v === "number" && typeof v !== "boolean");
+}
+function isMultiDenseVector(value) {
+    if (value.length === 0)
+        return false;
+    return value.every((item) => Array.isArray(item) && isDenseVector(item));
+}
+function toFieldEntries(doc) {
+    const entries = [];
+    for (const [name, value] of Object.entries(doc)) {
+        if (Array.isArray(value)) {
+            if (isMultiSparseVector(value)) {
+                for (const sv of value) {
+                    const indices = sv.map((item) => item[0]);
+                    const values = sv.map((item) => item[1]);
+                    entries.push({
+                        name,
+                        value: { sparseVector: { indices, values } },
+                    });
+                }
+                continue;
+            }
+            if (isMultiDenseVector(value)) {
+                for (const dv of value) {
+                    entries.push({
+                        name,
+                        value: { denseVector: { values: dv.map(Number) } },
+                    });
+                }
+                continue;
+            }
+        }
+        entries.push({ name, value: toFieldValue(value) });
+    }
+    return entries;
+}
+function toFieldValue(value) {
+    if (typeof value === "string") {
+        return { text: value };
+    }
+    if (typeof value === "boolean") {
+        return { u64: value ? 1 : 0 };
+    }
+    if (typeof value === "number") {
+        if (Number.isInteger(value)) {
+            return value >= 0 ? { u64: value } : { i64: value };
+        }
+        return { f64: value };
+    }
+    if (value instanceof Uint8Array || Buffer.isBuffer(value)) {
+        return { bytesValue: value instanceof Uint8Array ? value : new Uint8Array(value) };
+    }
+    if (Array.isArray(value)) {
+        if (isSparseVector(value)) {
+            const indices = value.map((item) => item[0]);
+            const values = value.map((item) => item[1]);
+            return { sparseVector: { indices, values } };
+        }
+        if (isDenseVector(value)) {
+            return { denseVector: { values: value.map(Number) } };
+        }
+        return { jsonValue: JSON.stringify(value) };
+    }
+    if (typeof value === "object" && value !== null) {
+        return { jsonValue: JSON.stringify(value) };
+    }
+    return { text: String(value) };
+}
+function fromFieldValue(fv) {
+    if (fv.text !== undefined)
+        return fv.text;
+    if (fv.u64 !== undefined)
+        return fv.u64;
+    if (fv.i64 !== undefined)
+        return fv.i64;
+    if (fv.f64 !== undefined)
+        return fv.f64;
+    if (fv.bytesValue !== undefined)
+        return fv.bytesValue;
+    if (fv.jsonValue !== undefined)
+        return JSON.parse(fv.jsonValue);
+    if (fv.sparseVector !== undefined) {
+        return {
+            indices: Array.from(fv.sparseVector.indices),
+            values: Array.from(fv.sparseVector.values),
+        };
+    }
+    if (fv.denseVector !== undefined) {
+        return Array.from(fv.denseVector.values);
+    }
+    return null;
+}
+function combinerToProto(combiner) {
+    const map = { sum: 0, max: 1, avg: 2 };
+    return map[combiner] ?? 0;
+}
+function rerankerCombinerToProto(combiner) {
+    const map = {
+        log_sum_exp: hermes_1.MultiValueCombiner.COMBINER_LOG_SUM_EXP,
+        max: hermes_1.MultiValueCombiner.COMBINER_MAX,
+        avg: hermes_1.MultiValueCombiner.COMBINER_AVG,
+        sum: hermes_1.MultiValueCombiner.COMBINER_SUM,
+        weighted_top_k: hermes_1.MultiValueCombiner.COMBINER_WEIGHTED_TOP_K,
+    };
+    return map[combiner] ?? hermes_1.MultiValueCombiner.COMBINER_LOG_SUM_EXP;
+}
+function buildQuery(options) {
+    if (options.term) {
+        const [field, term] = options.term;
+        return { term: { field, term } };
+    }
+    if (options.boolean) {
+        const must = (options.boolean.must ?? []).map(([f, t]) => ({
+            term: { field: f, term: t },
+        }));
+        const should = (options.boolean.should ?? []).map(([f, t]) => ({
+            term: { field: f, term: t },
+        }));
+        const mustNot = (options.boolean.mustNot ?? []).map(([f, t]) => ({
+            term: { field: f, term: t },
+        }));
+        return { boolean: { must, should, mustNot } };
+    }
+    const combiner = combinerToProto(options.combiner ?? "sum");
+    if (options.sparseVector) {
+        const [field, indices, values] = options.sparseVector;
+        return {
+            sparseVector: {
+                field,
+                indices,
+                values,
+                text: "",
+                combiner,
+                heapFactor: options.heapFactor ?? 1.0,
+                combinerTemperature: 0,
+                combinerTopK: 0,
+                combinerDecay: 0,
+            },
+        };
+    }
+    if (options.sparseText) {
+        const [field, text] = options.sparseText;
+        return {
+            sparseVector: {
+                field,
+                indices: [],
+                values: [],
+                text,
+                combiner,
+                heapFactor: options.heapFactor ?? 1.0,
+                combinerTemperature: 0,
+                combinerTopK: 0,
+                combinerDecay: 0,
+            },
+        };
+    }
+    if (options.denseVector) {
+        const [field, vector] = options.denseVector;
+        return {
+            denseVector: {
+                field,
+                vector,
+                nprobe: options.nprobe ?? 0,
+                rerankFactor: options.rerankFactor ?? 0,
+                combiner,
+                combinerTemperature: 0,
+                combinerTopK: 0,
+                combinerDecay: 0,
+            },
+        };
+    }
+    // Default: match all (empty boolean query)
+    return { boolean: { must: [], should: [], mustNot: [] } };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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