@anvailabs/proximadb-client 0.3.0

package/dist/search.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * ProximaDB TypeScript SDK - Search Builder
+ *
+ * Provides a fluent API for building and executing vector similarity searches.
+ *
+ * Copyright 2025 ProximaDB Contributors
+ * Licensed under the Apache License, Version 2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchBuilder = void 0;
+exports.createSearchBuilder = createSearchBuilder;
+const types_1 = require("./types");
+const filter_1 = require("./filter");
+/**
+ * Builder for search queries with fluent API
+ */
+class SearchBuilder {
+    client;
+    collectionName;
+    queryVector = null;
+    k = 10;
+    filterExpr = null;
+    filterBuilder = null;
+    searchMode = types_1.SearchMode.Exact;
+    nprobeValue = null;
+    adaptiveThreshold = null;
+    includeVectorsFlag = false;
+    minScoreValue = null;
+    timeoutMsValue = null;
+    constructor(client, collection) {
+        this.client = client;
+        this.collectionName = collection;
+    }
+    /**
+     * Set the query vector
+     */
+    vector(vec) {
+        this.queryVector = vec;
+        return this;
+    }
+    /**
+     * Set the number of results to return
+     */
+    topK(k) {
+        this.k = k;
+        return this;
+    }
+    /**
+     * Alias for topK
+     */
+    limit(k) {
+        return this.topK(k);
+    }
+    /**
+     * Set a filter expression string
+     */
+    filter(filterStr) {
+        this.filterExpr = filterStr;
+        return this;
+    }
+    /**
+     * Apply a pre-built filter
+     */
+    withFilter(filterObj) {
+        this.filterExpr = (0, filter_1.filterToExpression)(filterObj);
+        return this;
+    }
+    /**
+     * Set the search mode
+     */
+    mode(searchMode) {
+        this.searchMode = searchMode;
+        return this;
+    }
+    /**
+     * Use exact search (100% recall)
+     */
+    exact() {
+        this.searchMode = types_1.SearchMode.Exact;
+        return this;
+    }
+    /**
+     * Use approximate search for faster results
+     */
+    approximate() {
+        this.searchMode = types_1.SearchMode.Approximate;
+        return this;
+    }
+    /**
+     * Use approximate search with specific nprobe value
+     */
+    approximateWithNprobe(nprobe) {
+        this.searchMode = types_1.SearchMode.Approximate;
+        this.nprobeValue = nprobe;
+        return this;
+    }
+    /**
+     * Use adaptive search mode
+     */
+    adaptive(threshold) {
+        this.searchMode = types_1.SearchMode.Adaptive;
+        this.adaptiveThreshold = threshold;
+        return this;
+    }
+    /**
+     * Include vectors in results
+     */
+    includeVectors(include = true) {
+        this.includeVectorsFlag = include;
+        return this;
+    }
+    /**
+     * Include metadata in results
+     */
+    includeMetadata(_include = true) {
+        return this;
+    }
+    /**
+     * Set minimum score threshold
+     */
+    minScore(score) {
+        this.minScoreValue = score;
+        return this;
+    }
+    /**
+     * Set request timeout in milliseconds
+     */
+    timeoutMs(timeout) {
+        this.timeoutMsValue = timeout;
+        return this;
+    }
+    /**
+     * Set timeout in seconds (convenience method)
+     */
+    timeoutSecs(secs) {
+        this.timeoutMsValue = secs * 1000;
+        return this;
+    }
+    // =========================================================================
+    // Inline filter methods for convenience
+    // =========================================================================
+    /**
+     * Add an equality filter condition
+     */
+    filterEq(field, value) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.eq(field, value);
+        return this;
+    }
+    /**
+     * Add a not-equal filter condition
+     */
+    filterNe(field, value) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.ne(field, value);
+        return this;
+    }
+    /**
+     * Add a greater-than filter condition
+     */
+    filterGt(field, value) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.gt(field, value);
+        return this;
+    }
+    /**
+     * Add a greater-than-or-equal filter condition
+     */
+    filterGte(field, value) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.gte(field, value);
+        return this;
+    }
+    /**
+     * Add a less-than filter condition
+     */
+    filterLt(field, value) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.lt(field, value);
+        return this;
+    }
+    /**
+     * Add a less-than-or-equal filter condition
+     */
+    filterLte(field, value) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.lte(field, value);
+        return this;
+    }
+    /**
+     * Add a range filter condition (inclusive)
+     */
+    filterRange(field, min, max) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.range(field, min, max);
+        return this;
+    }
+    /**
+     * Add an IN filter condition
+     */
+    filterIn(field, values) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.inList(field, values);
+        return this;
+    }
+    /**
+     * Add a contains filter condition
+     */
+    filterContains(field, value) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.contains(field, value);
+        return this;
+    }
+    /**
+     * Add an exists filter condition
+     */
+    filterExists(field) {
+        this.ensureFilterBuilder();
+        this.filterBuilder = this.filterBuilder.exists(field);
+        return this;
+    }
+    ensureFilterBuilder() {
+        if (this.filterBuilder === null) {
+            this.filterBuilder = filter_1.FilterBuilder.new();
+        }
+    }
+    buildFilter() {
+        if (this.filterBuilder !== null) {
+            return this.filterBuilder.toExpression();
+        }
+        return this.filterExpr ?? undefined;
+    }
+    buildSearchModeString() {
+        switch (this.searchMode) {
+            case types_1.SearchMode.Exact:
+                return "exact";
+            case types_1.SearchMode.Approximate:
+                if (this.nprobeValue !== null) {
+                    return "approximate:" + this.nprobeValue;
+                }
+                return "approximate";
+            case types_1.SearchMode.Adaptive:
+                if (this.adaptiveThreshold !== null) {
+                    return "adaptive:" + this.adaptiveThreshold;
+                }
+                return "adaptive:10000";
+            default:
+                return "exact";
+        }
+    }
+    /**
+     * Execute the search query
+     */
+    async execute() {
+        if (this.queryVector === null) {
+            throw new Error("Query vector is required");
+        }
+        if (this.k <= 0 || this.k > 10000) {
+            throw new Error("topK must be between 1 and 10000");
+        }
+        const request = {
+            vector: this.queryVector,
+            top_k: this.k,
+            filter: this.buildFilter(),
+            searchMode: this.buildSearchModeString(),
+            include_vector: this.includeVectorsFlag,
+            include_text: false,
+            timeoutMs: this.timeoutMsValue ?? undefined,
+        };
+        const response = (await this.client.searchRecordsRequest(this.collectionName, request));
+        let results = response.results;
+        // Apply min_score filter if set
+        if (this.minScoreValue !== null) {
+            results = results.filter((r) => r.score >= this.minScoreValue);
+        }
+        return results;
+    }
+    /**
+     * Execute the search and return a streaming iterator
+     */
+    async *stream() {
+        const results = await this.execute();
+        for (const result of results) {
+            yield result;
+        }
+    }
+    /**
+     * Create an async iterator for streaming results
+     */
+    async iterate() {
+        const results = await this.execute();
+        let index = 0;
+        const total = results.length;
+        const iterator = {
+            [Symbol.asyncIterator]() {
+                return iterator;
+            },
+            async next() {
+                if (index < results.length) {
+                    return { value: results[index++], done: false };
+                }
+                return { value: undefined, done: true };
+            },
+            getTotal() {
+                return total;
+            },
+            isComplete() {
+                return index >= results.length;
+            },
+        };
+        return iterator;
+    }
+}
+exports.SearchBuilder = SearchBuilder;
+/**
+ * Create a new search builder
+ */
+function createSearchBuilder(client, collection) {
+    return new SearchBuilder(client, collection);
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ProximaDB TypeScript SDK - Generated REST transport seam (TD-126 Phase 4)
+ *
+ * This is the thin, hand-written ergonomic facade over the GENERATED REST
+ * transport. The wire contract — path templates, path/query parameter
+ * encoding, request/response JSON shapes — is generated from
+ * `docs/openapi/proximadb-openapi.yaml` into `src/generated/schema.ts`
+ * (openapi-typescript, pinned in package.json; regenerate with
+ * `npm run gen-sdk`). `openapi-fetch` turns those generated `paths` types into
+ * a typed runtime client.
+ *
+ * Generators don't do ergonomics; this layer is the value-add: it injects the
+ * facade's own `fetch` (which owns bearer auth, retries, and error mapping —
+ * see `client.ts`) into the typed client, so the generated wire plumbing and
+ * the hand-written transport policy compose without either reimplementing the
+ * other. This mirrors the merged Go pilot (TD-126 Phase 2), where the generated
+ * `genrest.Client` is driven through `RequestEditorFn`s + a custom `http.Client`.
+ *
+ * Copyright 2025 ProximaDB Contributors
+ * Licensed under the Apache License, Version 2.0
+ */
+import type { Client } from "openapi-fetch";
+import type { paths } from "./generated/schema";
+/**
+ * The typed REST client over the generated OpenAPI `paths`.
+ */
+export type GeneratedClient = Client<paths>;
+/**
+ * A fetch implementation matching the facade's transport policy. It is given a
+ * resolved `Request` (URL + method + body assembled by the generated client)
+ * and must return a native `Response`. The facade implements auth/retry/error
+ * mapping inside this function (see `ProximaDBClient`).
+ */
+export type TransportFetch = (input: Request) => Promise<Response>;
+/**
+ * Construct the generated typed REST client, routing every request the
+ * generated client issues through the facade's transport `fetch`.
+ */
+export declare function createTransport(baseUrl: string, fetchImpl: TransportFetch): GeneratedClient;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,cAAc,GACxB,eAAe,CAKjB"}

package/dist/transport.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * ProximaDB TypeScript SDK - Generated REST transport seam (TD-126 Phase 4)
+ *
+ * This is the thin, hand-written ergonomic facade over the GENERATED REST
+ * transport. The wire contract — path templates, path/query parameter
+ * encoding, request/response JSON shapes — is generated from
+ * `docs/openapi/proximadb-openapi.yaml` into `src/generated/schema.ts`
+ * (openapi-typescript, pinned in package.json; regenerate with
+ * `npm run gen-sdk`). `openapi-fetch` turns those generated `paths` types into
+ * a typed runtime client.
+ *
+ * Generators don't do ergonomics; this layer is the value-add: it injects the
+ * facade's own `fetch` (which owns bearer auth, retries, and error mapping —
+ * see `client.ts`) into the typed client, so the generated wire plumbing and
+ * the hand-written transport policy compose without either reimplementing the
+ * other. This mirrors the merged Go pilot (TD-126 Phase 2), where the generated
+ * `genrest.Client` is driven through `RequestEditorFn`s + a custom `http.Client`.
+ *
+ * Copyright 2025 ProximaDB Contributors
+ * Licensed under the Apache License, Version 2.0
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTransport = createTransport;
+const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
+/**
+ * Construct the generated typed REST client, routing every request the
+ * generated client issues through the facade's transport `fetch`.
+ */
+function createTransport(baseUrl, fetchImpl) {
+    return (0, openapi_fetch_1.default)({
+        baseUrl,
+        fetch: fetchImpl,
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;AAuBH,0CAQC;AA7BD,kEAAyC;AAiBzC;;;GAGG;AACH,SAAgB,eAAe,CAC7B,OAAe,EACf,SAAyB;IAEzB,OAAO,IAAA,uBAAY,EAAQ;QACzB,OAAO;QACP,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC"}