@unboundcx/sdk 1.4.0 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "1.4.0",
+  "version": "1.7.0",
   "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

@@ -3,15 +3,18 @@ export class ObjectsService {
     this.sdk = sdk;
   }
 
-  async byId(id, query = {}) {
+  async byId({ id, expandDetails = false }) {
     this.sdk.validateParams(
-      { id, query },
+      { id, expandDetails },
       {
         id: { type: 'string', required: true },
-        query: { type: 'object', required: false },
+        expandDetails: { type: 'boolean', required: false },
       },
     );
 
+    const query = {};
+    if (expandDetails) query.expandDetails = expandDetails;
+
     const params = {
       query,
     };
@@ -20,28 +23,45 @@ export class ObjectsService {
     return result;
   }
 
-  async query(object, query = {}) {
+  async query({
+    object,
+    select = null,
+    where = {},
+    limit = 100,
+    nextId = null,
+    previousId = null,
+    orderByDirection = 'DESC',
+    expandDetails = false,
+  }) {
     this.sdk.validateParams(
-      { object, query },
+      { object, select, where, limit, nextId, previousId, orderByDirection, expandDetails },
       {
         object: { type: 'string', required: true },
-        query: { type: 'object', required: false },
+        select: { type: 'object', required: false }, // array or string
+        where: { type: 'object', required: false },
+        limit: { type: 'number', required: false },
+        nextId: { type: 'string', required: false },
+        previousId: { type: 'string', required: false },
+        orderByDirection: { type: 'string', required: false },
+        expandDetails: { type: 'boolean', required: false },
       },
     );
 
-    const params = {
-      query,
-    };
+    const query = { ...where };
+    if (select !== null) query.select = select;
+    if (limit !== 100) query.limit = limit;
+    if (nextId !== null) query.nextId = nextId;
+    if (previousId !== null) query.previousId = previousId;
+    if (orderByDirection !== 'DESC') query.orderByDirection = orderByDirection;
+    if (expandDetails) query.expandDetails = expandDetails;
 
-    const result = await this.sdk._fetch(
-      `/object/query/${object}`,
-      'GET',
-      params,
-    );
+    const params = { query };
+
+    const result = await this.sdk._fetch(`/object/query/${object}`, 'GET', params);
     return result;
   }
 
-  async updateById(object, id, update) {
+  async updateById({ object, id, update }) {
     this.sdk.validateParams(
       { object, id, update },
       {
@@ -64,7 +84,7 @@ export class ObjectsService {
     return result;
   }
 
-  async update(object, where, update) {
+  async update({ object, where, update }) {
     this.sdk.validateParams(
       { object, where, update },
       {
@@ -85,7 +105,7 @@ export class ObjectsService {
     return result;
   }
 
-  async create(object, body = {}) {
+  async create({ object, body }) {
     this.sdk.validateParams(
       { object, body },
       {
@@ -102,7 +122,7 @@ export class ObjectsService {
     return result;
   }
 
-  async delete(object, where) {
+  async delete({ object, where }) {
     this.sdk.validateParams(
       { object, where },
       {
@@ -121,7 +141,7 @@ export class ObjectsService {
     return result;
   }
 
-  async deleteById(object, id) {
+  async deleteById({ object, id }) {
     this.sdk.validateParams(
       { object, id },
       {
@@ -168,28 +188,77 @@ export class ObjectsService {
   }
 
   // ExpandDetails methods
-  async createExpandDetail(body = {}) {
+  async createExpandDetail({
+    objectName,
+    fieldName,
+    targetObject,
+    lookupColumn,
+    expandFields,
+    keyField = null,
+    isActive = true,
+    isSystem = 0,
+  }) {
     this.sdk.validateParams(
-      { body },
+      { objectName, fieldName, targetObject, lookupColumn, expandFields, keyField, isActive, isSystem },
       {
-        body: { type: 'object', required: true },
+        objectName: { type: 'string', required: true },
+        fieldName: { type: 'string', required: true },
+        targetObject: { type: 'string', required: true },
+        lookupColumn: { type: 'string', required: true },
+        expandFields: { type: 'object', required: true }, // array
+        keyField: { type: 'string', required: false },
+        isActive: { type: 'boolean', required: false },
+        isSystem: { type: 'number', required: false },
       },
     );
 
+    const body = {
+      objectName,
+      fieldName,
+      targetObject,
+      lookupColumn,
+      expandFields,
+      keyField,
+      isActive,
+      isSystem,
+    };
     const params = { body };
 
     const result = await this.sdk._fetch(`/object/expandDetails`, 'POST', params);
     return result;
   }
 
-  async getExpandDetails(query = {}) {
+  async getExpandDetails({
+    objectName = null,
+    fieldName = null,
+    targetObject = null,
+    isActive = null,
+    isSystem = null,
+    limit = 100,
+    offset = 0,
+  } = {}) {
     this.sdk.validateParams(
-      { query },
+      { objectName, fieldName, targetObject, isActive, isSystem, limit, offset },
       {
-        query: { type: 'object', required: false },
+        objectName: { type: 'string', required: false },
+        fieldName: { type: 'string', required: false },
+        targetObject: { type: 'string', required: false },
+        isActive: { type: 'boolean', required: false },
+        isSystem: { type: 'boolean', required: false },
+        limit: { type: 'number', required: false },
+        offset: { type: 'number', required: false },
       },
     );
 
+    const query = {};
+    if (objectName !== null) query.objectName = objectName;
+    if (fieldName !== null) query.fieldName = fieldName;
+    if (targetObject !== null) query.targetObject = targetObject;
+    if (isActive !== null) query.isActive = isActive;
+    if (isSystem !== null) query.isSystem = isSystem;
+    if (limit !== 100) query.limit = limit;
+    if (offset !== 0) query.offset = offset;
+    
     const params = { query };
 
     const result = await this.sdk._fetch(`/object/expandDetails`, 'GET', params);
@@ -208,15 +277,39 @@ export class ObjectsService {
     return result;
   }
 
-  async updateExpandDetail(id, body = {}) {
+  async updateExpandDetail({
+    id,
+    objectName = null,
+    fieldName = null,
+    targetObject = null,
+    lookupColumn = null,
+    expandFields = null,
+    keyField = null,
+    isActive = null,
+  }) {
     this.sdk.validateParams(
-      { id, body },
+      { id, objectName, fieldName, targetObject, lookupColumn, expandFields, keyField, isActive },
       {
         id: { type: 'string', required: true },
-        body: { type: 'object', required: true },
+        objectName: { type: 'string', required: false },
+        fieldName: { type: 'string', required: false },
+        targetObject: { type: 'string', required: false },
+        lookupColumn: { type: 'string', required: false },
+        expandFields: { type: 'object', required: false }, // array
+        keyField: { type: 'string', required: false },
+        isActive: { type: 'boolean', required: false },
       },
     );
 
+    const body = {};
+    if (objectName !== null) body.objectName = objectName;
+    if (fieldName !== null) body.fieldName = fieldName;
+    if (targetObject !== null) body.targetObject = targetObject;
+    if (lookupColumn !== null) body.lookupColumn = lookupColumn;
+    if (expandFields !== null) body.expandFields = expandFields;
+    if (keyField !== null) body.keyField = keyField;
+    if (isActive !== null) body.isActive = isActive;
+    
     const params = { body };
 
     const result = await this.sdk._fetch(`/object/expandDetails/${id}`, 'PUT', params);
@@ -236,28 +329,68 @@ export class ObjectsService {
   }
 
   // GeneratedColumns methods
-  async createGeneratedColumn(body = {}) {
+  async createGeneratedColumn({
+    objectName,
+    columnName,
+    value,
+    type = 'string',
+    isActive = true,
+    isSystem = 0,
+  }) {
     this.sdk.validateParams(
-      { body },
+      { objectName, columnName, value, type, isActive, isSystem },
       {
-        body: { type: 'object', required: true },
+        objectName: { type: 'string', required: true },
+        columnName: { type: 'string', required: true },
+        value: { type: 'string', required: true },
+        type: { type: 'string', required: false },
+        isActive: { type: 'boolean', required: false },
+        isSystem: { type: 'number', required: false },
       },
     );
 
+    const body = {
+      objectName,
+      columnName,
+      value,
+      type,
+      isActive,
+      isSystem,
+    };
     const params = { body };
 
     const result = await this.sdk._fetch(`/object/generatedColumns`, 'POST', params);
     return result;
   }
 
-  async getGeneratedColumns(query = {}) {
+  async getGeneratedColumns({
+    objectName = null,
+    columnName = null,
+    isActive = null,
+    isSystem = null,
+    limit = 100,
+    offset = 0,
+  } = {}) {
     this.sdk.validateParams(
-      { query },
+      { objectName, columnName, isActive, isSystem, limit, offset },
       {
-        query: { type: 'object', required: false },
+        objectName: { type: 'string', required: false },
+        columnName: { type: 'string', required: false },
+        isActive: { type: 'boolean', required: false },
+        isSystem: { type: 'boolean', required: false },
+        limit: { type: 'number', required: false },
+        offset: { type: 'number', required: false },
       },
     );
 
+    const query = {};
+    if (objectName !== null) query.objectName = objectName;
+    if (columnName !== null) query.columnName = columnName;
+    if (isActive !== null) query.isActive = isActive;
+    if (isSystem !== null) query.isSystem = isSystem;
+    if (limit !== 100) query.limit = limit;
+    if (offset !== 0) query.offset = offset;
+    
     const params = { query };
 
     const result = await this.sdk._fetch(`/object/generatedColumns`, 'GET', params);
@@ -276,15 +409,33 @@ export class ObjectsService {
     return result;
   }
 
-  async updateGeneratedColumn(id, body = {}) {
+  async updateGeneratedColumn({
+    id,
+    objectName = null,
+    columnName = null,
+    value = null,
+    type = null,
+    isActive = null,
+  }) {
     this.sdk.validateParams(
-      { id, body },
+      { id, objectName, columnName, value, type, isActive },
       {
         id: { type: 'string', required: true },
-        body: { type: 'object', required: true },
+        objectName: { type: 'string', required: false },
+        columnName: { type: 'string', required: false },
+        value: { type: 'string', required: false },
+        type: { type: 'string', required: false },
+        isActive: { type: 'boolean', required: false },
       },
     );
 
+    const body = {};
+    if (objectName !== null) body.objectName = objectName;
+    if (columnName !== null) body.columnName = columnName;
+    if (value !== null) body.value = value;
+    if (type !== null) body.type = type;
+    if (isActive !== null) body.isActive = isActive;
+    
     const params = { body };
 
     const result = await this.sdk._fetch(`/object/generatedColumns/${id}`, 'PUT', params);
@@ -304,45 +455,94 @@ export class ObjectsService {
   }
 
   // Object Management methods
-  async createObject(body = {}) {
+  async createObject({ name }) {
     this.sdk.validateParams(
-      { body },
+      { name },
       {
-        body: { type: 'object', required: true },
+        name: { type: 'string', required: true },
       },
     );
 
+    const body = { name };
     const params = { body };
 
     const result = await this.sdk._fetch(`/object/manage`, 'POST', params);
     return result;
   }
 
-  async createColumn(objectName, body = {}) {
+  async createColumn({
+    objectName,
+    columns = null,
+    name = null,
+    type = null,
+    length = null,
+    defaultValue = null,
+    isEncrypted = false,
+    isRequired = false,
+  }) {
     this.sdk.validateParams(
-      { objectName, body },
+      { objectName, columns, name, type, length, defaultValue, isEncrypted, isRequired },
       {
         objectName: { type: 'string', required: true },
-        body: { type: 'object', required: true },
+        columns: { type: 'object', required: false }, // array
+        name: { type: 'string', required: false },
+        type: { type: 'string', required: false },
+        length: { type: 'number', required: false },
+        defaultValue: { type: 'string', required: false },
+        isEncrypted: { type: 'boolean', required: false },
+        isRequired: { type: 'boolean', required: false },
       },
     );
 
+    const body = {};
+    if (columns !== null) {
+      body.columns = columns;
+    } else if (name && type) {
+      body.name = name;
+      body.type = type;
+      if (length !== null) body.length = length;
+      if (defaultValue !== null) body.defaultValue = defaultValue;
+      body.isEncrypted = isEncrypted;
+      body.isRequired = isRequired;
+    } else {
+      throw new Error('Either columns array or individual column properties (name, type) must be provided');
+    }
+    
     const params = { body };
 
     const result = await this.sdk._fetch(`/object/manage/${objectName}`, 'POST', params);
     return result;
   }
 
-  async modifyColumn(objectName, columnName, body = {}) {
+  async modifyColumn({
+    objectName,
+    columnName,
+    type = null,
+    length = null,
+    defaultValue = null,
+    isEncrypted = null,
+    isRequired = null,
+  }) {
     this.sdk.validateParams(
-      { objectName, columnName, body },
+      { objectName, columnName, type, length, defaultValue, isEncrypted, isRequired },
       {
         objectName: { type: 'string', required: true },
         columnName: { type: 'string', required: true },
-        body: { type: 'object', required: true },
+        type: { type: 'string', required: false },
+        length: { type: 'number', required: false },
+        defaultValue: { type: 'string', required: false },
+        isEncrypted: { type: 'boolean', required: false },
+        isRequired: { type: 'boolean', required: false },
       },
     );
 
+    const body = {};
+    if (type !== null) body.type = type;
+    if (length !== null) body.length = length;
+    if (defaultValue !== null) body.defaultValue = defaultValue;
+    if (isEncrypted !== null) body.isEncrypted = isEncrypted;
+    if (isRequired !== null) body.isRequired = isRequired;
+    
     const params = { body };
 
     const result = await this.sdk._fetch(`/object/manage/${objectName}/${columnName}`, 'PUT', params);