@unboundcx/sdk 4.8.2 → 4.8.4

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.4",
   "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/objects.js

@@ -436,6 +436,58 @@ export class ObjectsService {
     return result;
   }
 
+  /**
+   * List saved list-views for an object (system + shared + own).
+   * @param {Object} params
+   * @param {string} params.objectName - Object the views belong to.
+   * @returns {Promise<{results: Object[]}>}
+   */
+  async listViews({ objectName }) {
+    this.sdk.validateParams(
+      { objectName },
+      { objectName: { type: 'string', required: true } },
+    );
+    return await this.sdk._fetch('/object/views', 'GET', {
+      query: { objectName },
+    });
+  }
+
+  /**
+   * Create a saved list-view.
+   * @param {Object} params
+   * @param {string} params.objectName
+   * @param {string} params.name
+   * @param {Array} params.filters
+   * @param {string} [params.visibility] - 'user' (default) or 'shared'.
+   * @returns {Promise<Object>}
+   */
+  async createView({ objectName, name, filters, visibility }) {
+    this.sdk.validateParams(
+      { objectName, name, filters },
+      {
+        objectName: { type: 'string', required: true },
+        name: { type: 'string', required: true },
+        filters: { type: 'array', required: true },
+      },
+    );
+    const body = { objectName, name, filters };
+    if (visibility !== undefined) body.visibility = visibility;
+    return await this.sdk._fetch('/object/views', 'POST', { body });
+  }
+
+  /**
+   * Delete a saved list-view by id.
+   * @param {string} viewId
+   * @returns {Promise<Object>}
+   */
+  async deleteView(viewId) {
+    this.sdk.validateParams(
+      { viewId },
+      { viewId: { type: 'string', required: true } },
+    );
+    return await this.sdk._fetch(`/object/views/${viewId}`, 'DELETE');
+  }
+
   async botSchema() {
     const result = await this.sdk._fetch(
       '/object/manage/bot-schema',

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 });
+  }
+}