@dakera-ai/dakera 0.7.3 → 0.8.1

package/dist/index.d.mts

@@ -1405,21 +1405,29 @@ declare class DakeraClient {
     /**
      * Perform hybrid search combining vector and full-text.
      *
+     * When `vector` is omitted the server falls back to BM25-only full-text
+     * search. When provided, results are blended with vector similarity
+     * according to `alpha`.
+     *
      * @param namespace - Target namespace
-     * @param vector - Query vector
      * @param query - Text query
-     * @param options - Search options including alpha for balance
+     * @param options - Search options: vector (optional), topK, alpha, filter
      * @returns Hybrid search results
      *
      * @example
      * ```typescript
-     * const results = await client.hybridSearch('my-namespace', [0.1, 0.2, 0.3], 'machine learning', {
+     * // Hybrid (vector + text)
+     * const results = await client.hybridSearch('my-namespace', 'machine learning', {
+     *   vector: [0.1, 0.2, 0.3],
      *   topK: 10,
      *   alpha: 0.7, // 70% text, 30% vector
      * });
+     * // BM25-only (no vector)
+     * const results = await client.hybridSearch('my-namespace', 'machine learning');
      * ```
      */
-    hybridSearch(namespace: string, vector: number[], query: string, options?: {
+    hybridSearch(namespace: string, query: string, options?: {
+        vector?: number[];
         topK?: number;
         alpha?: number;
         filter?: FilterExpression;

package/dist/index.d.ts

@@ -1405,21 +1405,29 @@ declare class DakeraClient {
     /**
      * Perform hybrid search combining vector and full-text.
      *
+     * When `vector` is omitted the server falls back to BM25-only full-text
+     * search. When provided, results are blended with vector similarity
+     * according to `alpha`.
+     *
      * @param namespace - Target namespace
-     * @param vector - Query vector
      * @param query - Text query
-     * @param options - Search options including alpha for balance
+     * @param options - Search options: vector (optional), topK, alpha, filter
      * @returns Hybrid search results
      *
      * @example
      * ```typescript
-     * const results = await client.hybridSearch('my-namespace', [0.1, 0.2, 0.3], 'machine learning', {
+     * // Hybrid (vector + text)
+     * const results = await client.hybridSearch('my-namespace', 'machine learning', {
+     *   vector: [0.1, 0.2, 0.3],
      *   topK: 10,
      *   alpha: 0.7, // 70% text, 30% vector
      * });
+     * // BM25-only (no vector)
+     * const results = await client.hybridSearch('my-namespace', 'machine learning');
      * ```
      */
-    hybridSearch(namespace: string, vector: number[], query: string, options?: {
+    hybridSearch(namespace: string, query: string, options?: {
+        vector?: number[];
         topK?: number;
         alpha?: number;
         filter?: FilterExpression;

package/dist/index.js

@@ -500,31 +500,42 @@ var DakeraClient = class {
   /**
    * Perform hybrid search combining vector and full-text.
    *
+   * When `vector` is omitted the server falls back to BM25-only full-text
+   * search. When provided, results are blended with vector similarity
+   * according to `alpha`.
+   *
    * @param namespace - Target namespace
-   * @param vector - Query vector
    * @param query - Text query
-   * @param options - Search options including alpha for balance
+   * @param options - Search options: vector (optional), topK, alpha, filter
    * @returns Hybrid search results
    *
    * @example
    * ```typescript
-   * const results = await client.hybridSearch('my-namespace', [0.1, 0.2, 0.3], 'machine learning', {
+   * // Hybrid (vector + text)
+   * const results = await client.hybridSearch('my-namespace', 'machine learning', {
+   *   vector: [0.1, 0.2, 0.3],
    *   topK: 10,
    *   alpha: 0.7, // 70% text, 30% vector
    * });
+   * // BM25-only (no vector)
+   * const results = await client.hybridSearch('my-namespace', 'machine learning');
    * ```
    */
-  async hybridSearch(namespace, vector, query, options = {}) {
+  async hybridSearch(namespace, query, options = {}) {
     const body = {
-      vector,
       query,
       top_k: options.topK ?? 10,
-      alpha: options.alpha ?? 0.5,
-      filter: options.filter
+      alpha: options.alpha ?? 0.5
     };
+    if (options.vector != null) {
+      body["vector"] = options.vector;
+    }
+    if (options.filter !== void 0) {
+      body["filter"] = options.filter;
+    }
     const response = await this.request(
       "POST",
-      `/v1/namespaces/${namespace}/fulltext/hybrid`,
+      `/v1/namespaces/${namespace}/hybrid`,
       body
     );
     return response.results;

package/dist/index.mjs

@@ -460,31 +460,42 @@ var DakeraClient = class {
   /**
    * Perform hybrid search combining vector and full-text.
    *
+   * When `vector` is omitted the server falls back to BM25-only full-text
+   * search. When provided, results are blended with vector similarity
+   * according to `alpha`.
+   *
    * @param namespace - Target namespace
-   * @param vector - Query vector
    * @param query - Text query
-   * @param options - Search options including alpha for balance
+   * @param options - Search options: vector (optional), topK, alpha, filter
    * @returns Hybrid search results
    *
    * @example
    * ```typescript
-   * const results = await client.hybridSearch('my-namespace', [0.1, 0.2, 0.3], 'machine learning', {
+   * // Hybrid (vector + text)
+   * const results = await client.hybridSearch('my-namespace', 'machine learning', {
+   *   vector: [0.1, 0.2, 0.3],
    *   topK: 10,
    *   alpha: 0.7, // 70% text, 30% vector
    * });
+   * // BM25-only (no vector)
+   * const results = await client.hybridSearch('my-namespace', 'machine learning');
    * ```
    */
-  async hybridSearch(namespace, vector, query, options = {}) {
+  async hybridSearch(namespace, query, options = {}) {
     const body = {
-      vector,
       query,
       top_k: options.topK ?? 10,
-      alpha: options.alpha ?? 0.5,
-      filter: options.filter
+      alpha: options.alpha ?? 0.5
     };
+    if (options.vector != null) {
+      body["vector"] = options.vector;
+    }
+    if (options.filter !== void 0) {
+      body["filter"] = options.filter;
+    }
     const response = await this.request(
       "POST",
-      `/v1/namespaces/${namespace}/fulltext/hybrid`,
+      `/v1/namespaces/${namespace}/hybrid`,
       body
     );
     return response.results;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dakera-ai/dakera",
-  "version": "0.7.3",
+  "version": "0.8.1",
   "description": "TypeScript/JavaScript SDK for Dakera AI memory platform",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -57,4 +57,3 @@
     "vitest": "^4.1.0"
   }
 }
-