@unboundcx/sdk 4.8.2 → 4.8.3

package/index.js

@@ -31,6 +31,7 @@ import { DocumentsService } from './services/documents.js';
 import { PermissionsService } from './services/permissions.js';
 import { TriggersService } from './services/triggers.js';
 import { InboxService } from './services/inbox.js';
+import { SearchService } from './services/search.js';
 import { DirectoryService } from './services/directory.js';
 
 class UnboundSDK extends BaseSDK {
@@ -104,6 +105,7 @@ class UnboundSDK extends BaseSDK {
     this.permissions = new PermissionsService(this);
     this.triggers = new TriggersService(this);
     this.inbox = new InboxService(this);
+    this.search = new SearchService(this);
     this.directory = new DirectoryService(this);
 
     // Add additional services that might be missing
@@ -286,5 +288,6 @@ export { KnowledgeBaseService } from './services/knowledgeBase.js';
 export { FaxService } from './services/fax.js';
 export { PermissionsService } from './services/permissions.js';
 export { InboxService } from './services/inbox.js';
+export { SearchService } from './services/search.js';
 export { DirectoryService } from './services/directory.js';
 export { BaseSDK } from './base.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.8.2",
+  "version": "4.8.3",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",

package/services/search.js

@@ -0,0 +1,48 @@
+/**
+ * SearchService -- cross-entity fan-out search (WP6.1).
+ * Backed by GET /search on app1-api: parallel per-store LIKE/fulltext
+ * queries behind one stable interface (a dedicated index can replace the
+ * implementation later without changing this contract).
+ */
+export class SearchService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Search across entities.
+   *
+   * @param {Object} params
+   * @param {string} params.q - Search term (min 2 chars).
+   * @param {number} [params.limit] - Max results per entity (default 5, cap 10).
+   * @param {string|string[]} [params.entities] - Subset of
+   *   people|company|opportunities|users|workflows; omit for all.
+   * @returns {Promise<{query: string, results: Object}>} results keyed by
+   *   entity, each an array of { id, objectName, title, subtitle, meta }.
+   */
+  async query({ q, limit, entities } = {}) {
+    this.sdk.validateParams(
+      { q, limit },
+      {
+        q: { type: 'string', required: true },
+        limit: { type: 'number', required: false },
+      },
+    );
+
+    if (
+      entities !== undefined &&
+      typeof entities !== 'string' &&
+      !Array.isArray(entities)
+    ) {
+      throw new Error('entities must be a string or an array of strings');
+    }
+
+    const query = { q };
+    if (limit !== undefined) query.limit = limit;
+    if (entities !== undefined) {
+      query.entities = Array.isArray(entities) ? entities.join(',') : entities;
+    }
+
+    return await this.sdk._fetch('/search', 'GET', { query });
+  }
+}