@unboundcx/sdk 4.0.0 → 4.0.3

package/base.js

@@ -297,6 +297,17 @@ export class BaseSDK {
       return true;
     }
 
+    // Streaming bodies (Node Readable or Web ReadableStream) — caller is
+    // expected to set an explicit content-type header alongside.
+    if (
+      typeof body === 'object' &&
+      body !== null &&
+      (typeof body.pipe === 'function' ||
+        typeof body.getReader === 'function')
+    ) {
+      return true;
+    }
+
     return false;
   }
 
@@ -353,9 +364,20 @@ export class BaseSDK {
         typeof Buffer !== 'undefined' &&
         Buffer.isBuffer &&
         Buffer.isBuffer(body);
+      const isStream =
+        body &&
+        typeof body === 'object' &&
+        (typeof body.pipe === 'function' ||
+          typeof body.getReader === 'function');
 
       if (isFormData || isBuffer) {
         options.body = body;
+      } else if (isStream) {
+        // Node 18+ native fetch (undici) requires duplex: 'half' for
+        // streaming request bodies. Without this the fetch throws
+        // synchronously before the first byte is sent.
+        options.body = body;
+        options.duplex = 'half';
       } else {
         options.body = JSON.stringify(body);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.0.0",
+  "version": "4.0.3",
   "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/storage.js

@@ -87,6 +87,69 @@ export class StorageService {
     return commonTypes[ext] || 'application/octet-stream';
   }
 
+  // Private helper to detect if a value is a Node Readable or Web ReadableStream
+  _isStreamLike(value) {
+    if (!value || typeof value !== 'object') return false;
+    if (typeof value.pipe === 'function') return true; // Node Readable
+    if (typeof value.getReader === 'function') return true; // Web ReadableStream
+    if (typeof value[Symbol.asyncIterator] === 'function') return true;
+    return false;
+  }
+
+  // Private helper to create a streaming multipart body for Node.js.
+  // Returns { body: ReadableStream, headers } for fetch() with duplex: 'half'.
+  // Byte-identical framing to _createNodeFormData — emitted in chunks so the full
+  // file never has to sit in memory.
+  _createNodeFormDataStream(fileStream, fileName, formFields) {
+    const boundary = `----formdata-${Date.now()}-${Math.random()
+      .toString(36)
+      .slice(2)}`;
+    const CRLF = '\r\n';
+    const contentType = this._getContentType(fileName);
+
+    const header =
+      `--${boundary}${CRLF}` +
+      `Content-Disposition: form-data; name="files"; filename="${
+        fileName || 'file'
+      }"${CRLF}` +
+      `Content-Type: ${contentType}${CRLF}${CRLF}`;
+
+    let tail = '';
+    for (const [name, value] of formFields) {
+      tail += `${CRLF}--${boundary}${CRLF}Content-Disposition: form-data; name="${name}"${CRLF}${CRLF}${value}`;
+    }
+    tail += `${CRLF}--${boundary}--${CRLF}`;
+
+    const body = new ReadableStream({
+      async start(controller) {
+        try {
+          controller.enqueue(Buffer.from(header, 'utf8'));
+          for await (const chunk of fileStream) {
+            controller.enqueue(
+              Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk),
+            );
+          }
+          controller.enqueue(Buffer.from(tail, 'utf8'));
+          controller.close();
+        } catch (err) {
+          controller.error(err);
+        }
+      },
+      cancel(reason) {
+        if (fileStream && typeof fileStream.destroy === 'function') {
+          fileStream.destroy(reason);
+        }
+      },
+    });
+
+    return {
+      body,
+      headers: {
+        'content-type': `multipart/form-data; boundary=${boundary}`,
+      },
+    };
+  }
+
   // Private helper to create FormData for Node.js environment
   _createNodeFormData(file, fileName, formFields) {
     const boundary = `----formdata-${Date.now()}-${Math.random().toString(36)}`;
@@ -234,7 +297,13 @@ export class StorageService {
     // Default behavior: Use fetch via sdk._fetch
     let formData, headers;
 
-    if (isNode) {
+    if (isNode && this._isStreamLike(file)) {
+      // Streaming path — file is piped chunk-by-chunk, no full-buffer copy.
+      // Caller is responsible for creating a fresh stream per retry.
+      const result = this._createNodeFormDataStream(file, fileName, formFields);
+      formData = result.body;
+      headers = result.headers;
+    } else if (isNode) {
       const result = this._createNodeFormData(file, fileName, formFields);
       formData = result.formData;
       headers = result.headers;
@@ -381,7 +450,7 @@ Response:
   /**
    * Upload a file to storage with optional format conversion
    * @param {Object} config - Configuration object
-   * @param {Object} config.file - File content (Buffer or File) - REQUIRED
+   * @param {Object} config.file - File content: Buffer, File, Node Readable stream, or Web ReadableStream. Streams upload chunk-by-chunk (no full-buffer copy) — recommended for files > ~100 MB. For retries, create a fresh stream per attempt. REQUIRED
    * @param {string} [config.classification='generic'] - File classification (e.g., 'fax', 'files', 'generic')
    * @param {string} [config.folder] - Folder path for organizing files
    * @param {string} [config.fileName] - Original file name

package/services/video.js

@@ -221,6 +221,13 @@ export class VideoService {
     startMicrophoneMutedAfter,
     enableChat,
     engagementSessionId,
+    startRecordingOn,
+    startTranscribingOn,
+    syncToCalendar,
+    source,
+    calendarId,
+    eventId,
+    calendarProvider,
   }) {
     this.sdk.validateParams(
       {
@@ -241,6 +248,13 @@ export class VideoService {
         startMicrophoneMutedAfter,
         enableChat,
         engagementSessionId,
+        startRecordingOn,
+        startTranscribingOn,
+        syncToCalendar,
+        source,
+        calendarId,
+        eventId,
+        calendarProvider,
       },
       {
         name: { type: 'string', required: false },
@@ -260,6 +274,13 @@ export class VideoService {
         startMicrophoneMutedAfter: { type: 'number', required: false },
         enableChat: { type: 'boolean', required: false },
         engagementSessionId: { type: 'string', required: false },
+        startRecordingOn: { type: 'boolean', required: false },
+        startTranscribingOn: { type: 'boolean', required: false },
+        syncToCalendar: { type: 'boolean', required: false },
+        source: { type: 'string', required: false },
+        calendarId: { type: 'string', required: false },
+        eventId: { type: 'string', required: false },
+        calendarProvider: { type: 'string', required: false },
       },
     );
     const params = {
@@ -281,6 +302,13 @@ export class VideoService {
         startMicrophoneMutedAfter,
         enableChat,
         engagementSessionId,
+        startRecordingOn,
+        startTranscribingOn,
+        syncToCalendar,
+        source,
+        calendarId,
+        eventId,
+        calendarProvider,
       },
     };
     const result = await this.sdk._fetch(`/video`, 'POST', params);
@@ -453,7 +481,7 @@ export class VideoService {
     return result;
   }
 
-  async deleteRoom(roomId) {
+  async deleteRoom(roomId, options = {}) {
     this.sdk.validateParams(
       { roomId },
       {
@@ -461,6 +489,9 @@ export class VideoService {
       },
     );
     const params = {};
+    if (options && options.deleteCalendarEvent === true) {
+      params.body = { deleteCalendarEvent: true };
+    }
     const result = await this.sdk._fetch(`/video/${roomId}`, 'DELETE', params);
     return result;
   }
@@ -612,6 +643,26 @@ export class VideoService {
     return result;
   }
 
+  // Persist a rolled-up quality summary to MySQL (one row per participant
+  // per meeting). Internal endpoint, called by app1-video-server on
+  // participant.leave. Long-term home for billing (bytes) and "was this
+  // meeting good?" support lookups, surviving ClickHouse TTL expiry.
+  async submitParticipantSummary(roomId, participantId, summary) {
+    this.sdk.validateParams(
+      { roomId, participantId, summary },
+      {
+        roomId: { type: 'string', required: true },
+        participantId: { type: 'string', required: true },
+        summary: { type: 'object', required: true },
+      },
+    );
+    return this.sdk._fetch(
+      `/internal/video/${roomId}/participants/${participantId}/summary`,
+      'POST',
+      { body: summary },
+    );
+  }
+
   async submitSurvey({
     videoRoomId,
     participantId,