@unboundcx/sdk 2.6.7 → 2.6.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "2.6.7",
+  "version": "2.6.9",
   "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/phoneNumbers.js

@@ -321,29 +321,30 @@ export class PhoneNumbersService {
 
   async getPortingOrders({
     page,
-    includePhoneNumbers = true,
     status,
     customerReference,
     sort,
     limit,
+    id,
+    operatorType = 'contains',
   } = {}) {
-    const params = new URLSearchParams();
+    const query = {
+      page,
+      status,
+      customerReference,
+      id,
+      operatorType,
+      sort,
+      limit,
+    };
 
-    if (page) params.append('page', page);
-    if (includePhoneNumbers !== undefined)
-      params.append('includePhoneNumbers', includePhoneNumbers);
-    if (status) params.append('status', status);
-    if (customerReference)
-      params.append('customerReference', customerReference);
-    if (sort) params.append('sort', sort);
-    if (limit) params.append('limit', limit);
+    const url = '/phoneNumbers/porting/orders';
 
-    const queryString = params.toString();
-    const url = queryString
-      ? `/phoneNumbers/porting/orders?${queryString}`
-      : '/phoneNumbers/porting/orders';
+    const params = {
+      query,
+    };
 
-    const result = await this.sdk._fetch(url, 'GET');
+    const result = await this.sdk._fetch(url, 'GET', params);
     return result;
   }
 
@@ -695,10 +696,10 @@ export class PhoneNumbersService {
    * @example
    * // Get all comments
    * const allComments = await sdk.phoneNumbers.getPortingComments("port_123...");
-   * 
+   *
    * // Get only public comments
    * const publicComments = await sdk.phoneNumbers.getPortingComments("port_123...", { includeInternal: 'false' });
-   * 
+   *
    * // Get only internal comments
    * const internalComments = await sdk.phoneNumbers.getPortingComments("port_123...", { includeInternal: 'only' });
    */
@@ -716,7 +717,9 @@ export class PhoneNumbersService {
     }
 
     const queryString = params.toString();
-    const url = `/phoneNumbers/porting/orders/${id}/comments${queryString ? '?' + queryString : ''}`;
+    const url = `/phoneNumbers/porting/orders/${id}/comments${
+      queryString ? '?' + queryString : ''
+    }`;
 
     const result = await this.sdk._fetch(url, 'GET');
     return result;
@@ -735,7 +738,7 @@ export class PhoneNumbersService {
    *   comment: "Please expedite this port request",
    *   isInternal: false
    * });
-   * 
+   *
    * // Post an internal comment (team use only)
    * const internalComment = await sdk.phoneNumbers.postPortingComment("port_123...", {
    *   comment: "Customer called - they need this ASAP",
@@ -761,6 +764,55 @@ export class PhoneNumbersService {
     );
     return result;
   }
+
+  /**
+   * Auto-create porting orders by grouping phone numbers by carrier
+   *
+   * Analyzes phone numbers using internal LRN lookup, groups them by carrier,
+   * and either previews the groupings (dry run) or creates separate porting
+   * orders for each carrier group.
+   *
+   * @param {Object} params
+   * @param {string[]} params.phoneNumbers - Array of +E.164 formatted phone numbers (max 100)
+   * @param {string} params.name - Base name for orders (will be appended with carrier names)
+   * @param {boolean} [params.dryRun=false] - If true, returns preview without creating orders
+   * @returns {Promise<Object>} Carrier groups and creation results
+   * @example
+   * // Preview carrier groupings
+   * const preview = await sdk.phoneNumbers.autoCreateOrders({
+   *   phoneNumbers: ['+15551234567', '+15551234568', '+15551234569'],
+   *   name: 'Q1 2025 Port',
+   *   dryRun: true
+   * });
+   * // Returns carrier groups with proposed order names
+   *
+   * // Create orders for each carrier
+   * const result = await sdk.phoneNumbers.autoCreateOrders({
+   *   phoneNumbers: ['+15551234567', '+15551234568', '+15551234569'],
+   *   name: 'Q1 2025 Port',
+   *   dryRun: false
+   * });
+   * // Returns created orders and any errors
+   */
+  async autoCreateOrders({ phoneNumbers, name, dryRun = false }) {
+    this.sdk.validateParams(
+      { phoneNumbers, name },
+      {
+        phoneNumbers: { type: 'array', required: true },
+        name: { type: 'string', required: true },
+        dryRun: { type: 'boolean', required: false },
+      },
+    );
+
+    const result = await this.sdk._fetch(
+      '/phoneNumbers/porting/auto-create-orders',
+      'POST',
+      {
+        body: { phoneNumbers, name, dryRun },
+      },
+    );
+    return result;
+  }
 }
 
 export class PhoneNumberCarrierService {