@raisindb/client 0.5.4 → 0.5.6

package/dist/index.mjs

@@ -6904,19 +6904,6 @@ var HttpDatabase = class _HttpDatabase {
   getBranch() {
     return this.branch;
   }
-  /**
-   * Create a new HttpDatabase instance scoped to a specific branch.
-   *
-   * @param branch - Branch name
-   * @returns New HttpDatabase instance with branch context
-   *
-   * @example
-   * ```typescript
-   * const db = client.database('my-repo');
-   * const staging = db.onBranch('staging');
-   * const result = await staging.executeSql('SELECT * FROM content');
-   * ```
-   */
   onBranch(branch) {
     return new _HttpDatabase(this.repository, this.client, branch);
   }
@@ -6964,6 +6951,63 @@ var HttpDatabase = class _HttpDatabase {
       (repo, name, input) => this.client.invokeFunctionSync(repo, name, input)
     );
   }
+  /**
+   * The retrieval implementation behind {@link search} and {@link ask}.
+   *
+   * The SAME `SearchApi` the WebSocket client uses, handed this transport's SQL
+   * and function runners. Retrieval is one behaviour — the query shape, the
+   * limit clamp, the required scope, the `grounded` fail-closed mapping — and a
+   * second copy written against HTTP would drift from the first the moment
+   * either is touched. Only the two runners differ.
+   */
+  searchApi() {
+    if (!this._searchApi) {
+      this._searchApi = new SearchApi(
+        (sql, params) => this.executeSql(sql, params),
+        async (name, input) => {
+          const run = await this.functions().invoke(name, input, {
+            waitForResult: true
+          });
+          return run?.result ?? run;
+        }
+      );
+    }
+    return this._searchApi;
+  }
+  /**
+   * Find the passages matching a query, by meaning and by keyword at once.
+   *
+   * Available on this HTTP client as well as the WebSocket one, because this is
+   * the client a server-side route handler reaches for — and a route handler is
+   * exactly where retrieval belongs when the page is public: the browser must
+   * not hold a credential that can read the repository.
+   *
+   * @example
+   * ```typescript
+   * const passages = await db.search('how much notice to terminate', {
+   *   workspaces: 'stories',
+   * });
+   * ```
+   */
+  async search(query, options) {
+    return this.searchApi().search(query, options);
+  }
+  /**
+   * Answer a question from the stored content, with citations.
+   *
+   * Check `grounded` before showing the answer: when it is false nothing
+   * relevant was retrieved and the model was never asked.
+   *
+   * @example
+   * ```typescript
+   * const { answer, citations, grounded } = await db.ask(question, {
+   *   workspaces: 'stories, handbook',
+   * });
+   * ```
+   */
+  async ask(question, options) {
+    return this.searchApi().ask(question, options);
+  }
   /**
    * Get an {@link McpClient} for a content-declared MCP server on this database.
    *