@unboundcx/sdk 2.6.5 → 2.6.6

package/base.js

@@ -306,7 +306,34 @@ export class BaseSDK {
 
     const response = await fetch(url, options);
     
-    // Check content type to determine how to parse the response
+    // Check if the response indicates an HTTP error
+    // These are API/configuration errors, not transport failures
+    if (!response.ok) {
+      let errorBody;
+      const contentType = response.headers.get('content-type') || '';
+      
+      try {
+        if (contentType.includes('application/json')) {
+          errorBody = await response.json();
+        } else {
+          errorBody = await response.text();
+        }
+      } catch (parseError) {
+        errorBody = `HTTP ${response.status} ${response.statusText}`;
+      }
+      
+      // Create a structured error for API/HTTP failures
+      const httpError = new Error(`API :: Error :: https :: ${options.method} :: ${endpoint} :: ${response.status} :: ${response.statusText}`);
+      httpError.status = response.status;
+      httpError.statusText = response.statusText;
+      httpError.method = options.method;
+      httpError.endpoint = endpoint;
+      httpError.body = errorBody;
+      
+      throw httpError;
+    }
+    
+    // Check content type to determine how to parse successful response
     const contentType = response.headers.get('content-type') || '';
     let bodyResponse;
     

package/package.json

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

@@ -204,25 +204,29 @@ export class PhoneNumbersService {
   }
 
   // Porting Methods
-  
+
   /**
    * Check portability of phone numbers using two-phase validation
-   * 
+   *
    * Phase 1 (Default): Internal validation using LRN lookup
    * - Validates ownership, duplicates, and carrier compatibility
    * - Sets portabilityStatus to 'pending'
-   * 
-   * Phase 2 (runPortabilityCheck: true): External validation 
+   *
+   * Phase 2 (runPortabilityCheck: true): External validation
    * - Runs full portability check with carrier
    * - Updates portabilityStatus to 'portable', 'not-portable', or 'error'
-   * 
+   *
    * @param {Object} params
    * @param {string[]} params.phoneNumbers - Array of +E.164 formatted phone numbers
    * @param {string} [params.portingOrderId] - Optional porting order ID to save results to
    * @param {boolean} [params.runPortabilityCheck=false] - Run external portability validation
    * @returns {Promise<Object>} Portability check results
    */
-  async checkPortability({ phoneNumbers, portingOrderId, runPortabilityCheck = false }) {
+  async checkPortability({
+    phoneNumbers,
+    portingOrderId,
+    runPortabilityCheck = false,
+  }) {
     this.sdk.validateParams(
       { phoneNumbers, runPortabilityCheck },
       {
@@ -267,6 +271,7 @@ export class PhoneNumbersService {
    * @param {Object} [params.activationSettings] - Activation preferences
    * @param {string} [params.activationSettings.focDatetimeRequested] - Requested FOC date/time (ISO 8601 UTC)
    * @param {boolean} [params.activationSettings.fastPortEligible] - Request fast port if available
+   * @param {string} [params.portOrderType] - Port type: 'full' or 'partial' (defaults to 'full')
    * @param {string[]} [params.tags] - Array of tags for organization
    * @returns {Promise<Object>} Created draft porting order with ID and status 'draft'
    * @example
@@ -275,13 +280,13 @@ export class PhoneNumbersService {
    *   customerReference: "CUST-123",
    *   endUser: { admin: { entityName: "My Company" } }
    * });
-   * 
+   *
    * // Phase 1: Add numbers with internal validation (pending status)
    * await sdk.phoneNumbers.checkPortability({
    *   phoneNumbers: ["+15551234567"],
    *   portingOrderId: order.id
    * });
-   * 
+   *
    * // Phase 2: Run external portability check when ready
    * await sdk.phoneNumbers.checkPortability({
    *   phoneNumbers: ["+15551234567"],
@@ -293,13 +298,15 @@ export class PhoneNumbersService {
     customerReference,
     endUser,
     activationSettings,
-    tags
+    portOrderType,
+    tags,
   } = {}) {
     // Creates draft order without phone numbers - use checkPortability to add them
     const body = {};
     if (customerReference) body.customerReference = customerReference;
     if (endUser) body.endUser = endUser;
     if (activationSettings) body.activationSettings = activationSettings;
+    if (portOrderType) body.portOrderType = portOrderType;
     if (tags) body.tags = tags;
 
     const result = await this.sdk._fetch(
@@ -349,11 +356,14 @@ export class PhoneNumbersService {
    * @param {boolean} [options.includeDocuments=true] - Include documents array with upload status
    * @returns {Promise<Object>} Porting order with requested related data
    */
-  async getPortingOrder(id, { 
-    includePhoneNumbers = true, 
-    includeExceptions = true, 
-    includeDocuments = true 
-  } = {}) {
+  async getPortingOrder(
+    id,
+    {
+      includePhoneNumbers = true,
+      includeExceptions = true,
+      includeDocuments = true,
+    } = {},
+  ) {
     this.sdk.validateParams(
       { id },
       {
@@ -385,15 +395,20 @@ export class PhoneNumbersService {
    * @param {string} [params.customerReference] - Customer-specified reference number
    * @param {Object} [params.endUser] - End user information
    * @param {Object} [params.activationSettings] - Activation preferences
+   * @param {string} [params.portOrderType] - Port type: 'full' or 'partial'
    * @param {string[]} [params.tags] - Array of tags for organization
    * @returns {Promise<Object>} Updated porting order
    */
-  async updatePortingOrder(id, {
-    customerReference,
-    endUser,
-    activationSettings,
-    tags
-  } = {}) {
+  async updatePortingOrder(
+    id,
+    {
+      customerReference,
+      endUser,
+      activationSettings,
+      portOrderType,
+      tags,
+    } = {},
+  ) {
     this.sdk.validateParams(
       { id },
       {
@@ -406,6 +421,7 @@ export class PhoneNumbersService {
     if (customerReference) body.customerReference = customerReference;
     if (endUser) body.endUser = endUser;
     if (activationSettings) body.activationSettings = activationSettings;
+    if (portOrderType) body.portOrderType = portOrderType;
     if (tags) body.tags = tags;
 
     const result = await this.sdk._fetch(
@@ -465,7 +481,7 @@ export class PhoneNumbersService {
 
     const result = await this.sdk._fetch(
       `/phoneNumbers/porting/orders/${id}`,
-      'DELETE'
+      'DELETE',
     );
     return result;
   }
@@ -480,7 +496,7 @@ export class PhoneNumbersService {
    * @returns {Promise<Object>} Removal confirmation with updated counts
    * @example
    * await sdk.phoneNumbers.removePhoneNumberFromOrder(
-   *   "port_123...", 
+   *   "port_123...",
    *   "+15551234567"
    * );
    */
@@ -494,15 +510,17 @@ export class PhoneNumbersService {
     );
 
     const result = await this.sdk._fetch(
-      `/phoneNumbers/porting/orders/${encodeURIComponent(portingOrderId)}/numbers/${encodeURIComponent(phoneNumber)}`,
-      'DELETE'
+      `/phoneNumbers/porting/orders/${encodeURIComponent(
+        portingOrderId,
+      )}/numbers/${encodeURIComponent(phoneNumber)}`,
+      'DELETE',
     );
     return result;
   }
 
   /**
    * Attach or update a document for a porting order
-   * 
+   *
    * @param {Object} params
    * @param {string} params.portingOrderId - Porting order ID
    * @param {string} [params.storageId] - Storage ID of uploaded file (null to clear)
@@ -516,7 +534,7 @@ export class PhoneNumbersService {
     storageId = null,
     documentType = 'loa',
     isRequired = false,
-    documentId = null
+    documentId = null,
   }) {
     this.sdk.validateParams(
       { portingOrderId, documentType },
@@ -530,7 +548,7 @@ export class PhoneNumbersService {
       portingOrderId,
       storageId,
       documentType,
-      isRequired
+      isRequired,
     };
 
     if (documentId) body.documentId = documentId;
@@ -547,10 +565,10 @@ export class PhoneNumbersService {
 
   /**
    * Generate Letter of Authorization (LOA) for a porting order
-   * 
+   *
    * Automatically generates a PDF LOA document using template data from the porting order,
    * uploads it to storage, and attaches it to the order as an LOA document.
-   * 
+   *
    * @param {Object} params
    * @param {string} params.portingOrderId - Porting order ID to generate LOA for
    * @param {string} params.signerName - Full name of person signing the LOA
@@ -568,7 +586,9 @@ export class PhoneNumbersService {
     );
 
     const result = await this.sdk._fetch(
-      `/phoneNumbers/porting/orders/${encodeURIComponent(portingOrderId)}/generate-loa`,
+      `/phoneNumbers/porting/orders/${encodeURIComponent(
+        portingOrderId,
+      )}/generate-loa`,
       'POST',
       {
         body: { signerName, signerTitle },
@@ -611,7 +631,7 @@ export class PhoneNumbersService {
    * // Returns:
    * // {
    * //   id: "port_123...",
-   * //   status: "draft", 
+   * //   status: "draft",
    * //   availableDates: [
    * //     { date: "2025-08-30T00:00:00.000Z", type: "Standard", available: true },
    * //     { date: "2025-09-02T00:00:00.000Z", type: "Express", available: true }
@@ -630,7 +650,7 @@ export class PhoneNumbersService {
 
     const result = await this.sdk._fetch(
       `/phoneNumbers/porting/orders/${id}/foc-windows`,
-      'GET'
+      'GET',
     );
     return result;
   }