@unboundcx/sdk 2.6.7 → 2.6.8

package/package.json

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

@@ -761,6 +761,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 {