@unboundcx/sdk 2.5.0 → 2.6.0

package/package.json

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

@@ -500,29 +500,40 @@ export class PhoneNumbersService {
     return result;
   }
 
-  async uploadPortingDocument({
-    filename,
-    fileContent,
-    contentType = 'application/pdf',
-    documentType = 'loa',
+  /**
+   * 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)
+   * @param {string} [params.documentType='loa'] - Document type (loa, bill, csr, etc.)
+   * @param {boolean} [params.isRequired=false] - Whether document is required
+   * @param {string} [params.documentId] - Optional: Update existing document by ID
+   * @returns {Promise<Object>} Document attachment result with action (created/updated)
+   */
+  async attachPortingDocument({
     portingOrderId,
+    storageId = null,
+    documentType = 'loa',
+    isRequired = false,
+    documentId = null
   }) {
     this.sdk.validateParams(
-      { filename, fileContent },
+      { portingOrderId, documentType },
       {
-        filename: { type: 'string', required: true },
-        fileContent: { type: 'string', required: true },
+        portingOrderId: { type: 'string', required: true },
+        documentType: { type: 'string', required: true },
       },
     );
 
     const body = {
-      filename,
-      fileContent,
-      contentType,
+      portingOrderId,
+      storageId,
       documentType,
+      isRequired
     };
 
-    if (portingOrderId) body.portingOrderId = portingOrderId;
+    if (documentId) body.documentId = documentId;
 
     const result = await this.sdk._fetch(
       '/phoneNumbers/porting/documents',
@@ -534,6 +545,38 @@ export class PhoneNumbersService {
     return result;
   }
 
+  /**
+   * 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
+   * @param {string} params.signerTitle - Job title of person signing the LOA
+   * @returns {Promise<Object>} Generation result with document ID and storage information
+   */
+  async generateLoa({ portingOrderId, signerName, signerTitle }) {
+    this.sdk.validateParams(
+      { portingOrderId, signerName, signerTitle },
+      {
+        portingOrderId: { type: 'string', required: true },
+        signerName: { type: 'string', required: true },
+        signerTitle: { type: 'string', required: true },
+      },
+    );
+
+    const result = await this.sdk._fetch(
+      `/phoneNumbers/porting/orders/${encodeURIComponent(portingOrderId)}/generate-loa`,
+      'POST',
+      {
+        body: { signerName, signerTitle },
+      },
+    );
+    return result;
+  }
+
   async getPortingEvents(id, { page, limit } = {}) {
     this.sdk.validateParams(
       { id },