@unboundcx/sdk 4.8.9 → 4.8.11

package/services/video.js

@@ -1,3 +1,4 @@
+import { internalRequest } from '../base.js';
 export class VideoService {
   constructor(sdk) {
     this.sdk = sdk;
@@ -5,7 +6,7 @@ export class VideoService {
 
   async clearToken() {
     const params = {};
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/clearVideoToken`,
       'POST',
       params,
@@ -50,7 +51,7 @@ export class VideoService {
         token,
       },
     };
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${room}/join`,
       'POST',
       params,
@@ -101,7 +102,7 @@ export class VideoService {
         isSip: true,
       },
     };
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${room}/join`,
       'POST',
       params,
@@ -124,7 +125,7 @@ export class VideoService {
         ...update,
       },
     };
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/${participantId}`,
       'PUT',
       params,
@@ -145,7 +146,7 @@ export class VideoService {
         participantId,
       },
     };
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/leave`,
       'DELETE',
       params,
@@ -161,7 +162,7 @@ export class VideoService {
       },
     );
     const params = {};
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/leave`,
       'DELETE',
       params,
@@ -195,7 +196,7 @@ export class VideoService {
         streamCreation,
       },
     };
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/${participantId}/mute/${mediaType}`,
       'PUT',
       params,
@@ -230,6 +231,7 @@ export class VideoService {
     calendarProvider,
     vocabularyTerms,
     shareOcrEnabled,
+    earlyJoinMinutes,
   }) {
     this.sdk.validateParams(
       {
@@ -259,6 +261,7 @@ export class VideoService {
         calendarProvider,
         vocabularyTerms,
         shareOcrEnabled,
+        earlyJoinMinutes,
       },
       {
         name: { type: 'string', required: false },
@@ -287,6 +290,9 @@ export class VideoService {
         calendarProvider: { type: 'string', required: false },
         vocabularyTerms: { type: 'array', required: false },
         shareOcrEnabled: { type: 'boolean', required: false },
+        // 0 = strict at startTime, 5 = 5-min early window (api rejects
+        // other values); omit for no schedule-window enforcement.
+        earlyJoinMinutes: { type: 'number', required: false },
       },
     );
     const params = {
@@ -317,9 +323,10 @@ export class VideoService {
         calendarProvider,
         vocabularyTerms,
         shareOcrEnabled,
+        earlyJoinMinutes,
       },
     };
-    const result = await this.sdk._fetch(`/video`, 'POST', params);
+    const result = await internalRequest(this.sdk, `/video`, 'POST', params);
     return result;
   }
 
@@ -362,6 +369,8 @@ export class VideoService {
       validationSchema.vocabularyTerms = { type: 'array' };
     if ('shareOcrEnabled' in update)
       validationSchema.shareOcrEnabled = { type: 'boolean' };
+    if ('earlyJoinMinutes' in update)
+      validationSchema.earlyJoinMinutes = { type: 'number' };
 
     if (Object.keys(validationSchema).length > 0) {
       this.sdk.validateParams(update, validationSchema);
@@ -372,7 +381,7 @@ export class VideoService {
         ...update,
       },
     };
-    const result = await this.sdk._fetch(`/video/${roomId}`, 'PUT', params);
+    const result = await internalRequest(this.sdk, `/video/${roomId}`, 'PUT', params);
     return result;
   }
 
@@ -400,7 +409,7 @@ export class VideoService {
         ...update,
       },
     };
-    const result = await this.sdk._fetch(`/video/${roomId}/bot`, 'PUT', params);
+    const result = await internalRequest(this.sdk, `/video/${roomId}/bot`, 'PUT', params);
     return result;
   }
 
@@ -420,7 +429,7 @@ export class VideoService {
         callerIdNumber,
       },
     };
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/placeOutboundCall`,
       'POST',
       params,
@@ -443,7 +452,7 @@ export class VideoService {
       },
     };
 
-    return await this.sdk._fetch(`/video/${roomId}`, 'GET', params);
+    return await internalRequest(this.sdk, `/video/${roomId}`, 'GET', params);
   }
 
   async listMeetings(options = {}) {
@@ -462,7 +471,7 @@ export class VideoService {
       query: options,
     };
 
-    const result = await this.sdk._fetch('/video/meetings', 'GET', params);
+    const result = await internalRequest(this.sdk, '/video/meetings', 'GET', params);
     return result;
   }
 
@@ -491,7 +500,7 @@ export class VideoService {
       query: params,
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/meetings/${roomId}/analytics`,
       'GET',
       options,
@@ -510,7 +519,7 @@ export class VideoService {
     if (options && options.deleteCalendarEvent === true) {
       params.body = { deleteCalendarEvent: true };
     }
-    const result = await this.sdk._fetch(`/video/${roomId}`, 'DELETE', params);
+    const result = await internalRequest(this.sdk, `/video/${roomId}`, 'DELETE', params);
     return result;
   }
 
@@ -527,7 +536,7 @@ export class VideoService {
       body: participant,
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/participants`,
       'POST',
       params,
@@ -544,7 +553,7 @@ export class VideoService {
     );
 
     const params = {};
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/close`,
       'POST',
       params,
@@ -586,7 +595,7 @@ export class VideoService {
       body: { token },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${id}/validate`,
       'POST',
       params,
@@ -631,7 +640,7 @@ export class VideoService {
       { roomId },
       { roomId: { type: 'string', required: true } },
     );
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/session/end`,
       'POST',
       { body: { roomId } },
@@ -653,7 +662,7 @@ export class VideoService {
       body: stats,
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/stats`,
       'POST',
       params,
@@ -674,7 +683,7 @@ export class VideoService {
         summary: { type: 'object', required: true },
       },
     );
-    return this.sdk._fetch(
+    return internalRequest(this.sdk, 
       `/internal/video/${roomId}/participants/${participantId}/summary`,
       'POST',
       { body: summary },
@@ -726,7 +735,7 @@ export class VideoService {
       },
     };
 
-    const result = await this.sdk._fetch('/video/survey', 'POST', params);
+    const result = await internalRequest(this.sdk, '/video/survey', 'POST', params);
     return result;
   }
 
@@ -756,7 +765,7 @@ export class VideoService {
 
     const params = { body };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/chat`,
       'POST',
       params,
@@ -804,7 +813,7 @@ export class VideoService {
       query: options,
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/chat`,
       'GET',
       params,
@@ -840,7 +849,7 @@ export class VideoService {
       query: options,
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/transcript`,
       'GET',
       params,
@@ -877,7 +886,7 @@ export class VideoService {
 
     const params = { body };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/chat/${messageId}`,
       'PUT',
       params,
@@ -903,7 +912,7 @@ export class VideoService {
 
     const params = {};
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/chat/${messageId}`,
       'DELETE',
       params,
@@ -965,7 +974,7 @@ export class VideoService {
       body: settings,
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       '/video/settings/user',
       'POST',
       params,
@@ -1015,7 +1024,7 @@ export class VideoService {
       body: settings,
     };
 
-    const result = await this.sdk._fetch('/video/settings/user', 'PUT', params);
+    const result = await internalRequest(this.sdk, '/video/settings/user', 'PUT', params);
     return result;
   }
 
@@ -1039,7 +1048,7 @@ export class VideoService {
       params.query.userId = userId;
     }
 
-    const result = await this.sdk._fetch('/video/settings/user', 'GET', params);
+    const result = await internalRequest(this.sdk, '/video/settings/user', 'GET', params);
     return result;
   }
 
@@ -1057,7 +1066,10 @@ export class VideoService {
       },
     );
 
-    const result = await this.sdk._fetch(`/video/${roomId}/livePresence`, 'GET');
+    const result = await internalRequest(this.sdk, 
+      `/video/${roomId}/livePresence`,
+      'GET',
+    );
     return result;
   }
 
@@ -1074,7 +1086,7 @@ export class VideoService {
       },
     );
 
-    const result = await this.sdk._fetch(`/video/${roomId}/summary`, 'GET');
+    const result = await internalRequest(this.sdk, `/video/${roomId}/summary`, 'GET');
     return result;
   }
 
@@ -1098,7 +1110,7 @@ export class VideoService {
       body: { summaryJson },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/summary`,
       'PATCH',
       params,
@@ -1119,7 +1131,7 @@ export class VideoService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/catch-me-up`,
       'POST',
       {},
@@ -1150,7 +1162,7 @@ export class VideoService {
       body.history = history;
     }
 
-    const result = await this.sdk._fetch(`/video/${roomId}/assistant`, 'POST', {
+    const result = await internalRequest(this.sdk, `/video/${roomId}/assistant`, 'POST', {
       body,
     });
     return result;
@@ -1178,7 +1190,7 @@ export class VideoService {
       body: { text },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/transcript/${messageId}`,
       'PATCH',
       params,
@@ -1201,7 +1213,7 @@ export class VideoService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/transcript/${messageId}/redact`,
       'POST',
       {},
@@ -1231,7 +1243,7 @@ export class VideoService {
       body: { participantId, displayName },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/transcript-speakers`,
       'PATCH',
       params,
@@ -1252,7 +1264,7 @@ export class VideoService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/recording-convert-retry`,
       'POST',
       {},
@@ -1274,7 +1286,11 @@ export class VideoService {
       },
     );
 
-    const result = await this.sdk._fetch(`/video/${roomId}/auto-name`, 'POST', {});
+    const result = await internalRequest(this.sdk, 
+      `/video/${roomId}/auto-name`,
+      'POST',
+      {},
+    );
     return result;
   }
 
@@ -1297,7 +1313,7 @@ export class VideoService {
       body: { action },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/transcription`,
       'POST',
       params,
@@ -1325,7 +1341,7 @@ export class VideoService {
       body: { language },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/caption-language`,
       'POST',
       params,
@@ -1354,7 +1370,7 @@ export class VideoService {
       body: { targetLanguage },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/transcript/translate`,
       'POST',
       params,
@@ -1384,7 +1400,7 @@ export class VideoService {
       body: { image, title },
     };
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/content-frame`,
       'POST',
       params,
@@ -1405,10 +1421,179 @@ export class VideoService {
       },
     );
 
-    const result = await this.sdk._fetch(
+    const result = await internalRequest(this.sdk, 
       `/video/${roomId}/content-events`,
       'GET',
     );
     return result;
   }
+
+  /**
+   * Get (or lazily create) the calling user's personal meeting room for this
+   * account. Every account user has exactly one; the first call provisions
+   * it server-side.
+   *
+   * NOTE: implemented flat (`getPersonalRoom`/`updatePersonalRoom`/
+   * `regeneratePersonalRoomPin`/`resolvePersonalRoom`) rather than the
+   * `sdk.video.personalRoom.{get,update,regeneratePin}` namespace named in
+   * the meet-hub plan — this file has no existing nested-namespace
+   * precedent, so flat matches every other method here.
+   *
+   * @param {string} [userId] - Optional target userId (admin viewing another user's room, e.g. Setup -> Users -> Meet). Defaults to the calling user.
+   * @returns {Promise<{personalRoom: {id: string, slug: string, url: string|null, dialInPin: string, guestsCanStart: boolean}}>}
+   */
+  async getPersonalRoom(userId = null) {
+    const params = { query: {} };
+    if (userId) {
+      this.sdk.validateParams(
+        { userId },
+        { userId: { type: 'string', required: true } },
+      );
+      params.query.userId = userId;
+    }
+    const result = await internalRequest(this.sdk, '/video/personal-room', 'GET', params);
+    return result;
+  }
+
+  /**
+   * Update the calling user's personal meeting room (slug and/or
+   * guests-can-start). Omit a field to leave it unchanged.
+   *
+   * @param {Object} [update]
+   * @param {string} [update.slug] - New slug (3-32 chars, lowercase/numbers/hyphens, not reserved). 409-equivalent BadRequestError on collision.
+   * @param {boolean} [update.guestsCanStart] - Whether guests can start the room without the host present.
+   * @param {string} [update.password] - New static room passcode.
+   * @param {string} [update.userId] - Optional target userId (admin editing another user's room). Defaults to the calling user.
+   * @returns {Promise<{personalRoom: {id: string, slug: string, url: string|null, dialInPin: string, guestsCanStart: boolean}}>}
+   */
+  async updatePersonalRoom({ slug, guestsCanStart, password, userId } = {}) {
+    const validationSchema = {};
+    if (slug !== undefined) validationSchema.slug = { type: 'string' };
+    if (guestsCanStart !== undefined)
+      validationSchema.guestsCanStart = { type: 'boolean' };
+    // Static room passcode — 4-6 digits (api-enforced); applied to every
+    // session the room link mints.
+    if (password !== undefined) validationSchema.password = { type: 'string' };
+    if (userId !== undefined) validationSchema.userId = { type: 'string' };
+
+    if (Object.keys(validationSchema).length > 0) {
+      this.sdk.validateParams(
+        { slug, guestsCanStart, password, userId },
+        validationSchema,
+      );
+    }
+
+    const body = {};
+    if (slug !== undefined) body.slug = slug;
+    if (guestsCanStart !== undefined) body.guestsCanStart = guestsCanStart;
+    if (password !== undefined) body.password = password;
+    if (userId !== undefined) body.userId = userId;
+
+    const params = { body };
+    const result = await internalRequest(this.sdk, '/video/personal-room', 'PUT', params);
+    return result;
+  }
+
+  /**
+   * Regenerate the dial-in PIN for the calling user's personal meeting room.
+   *
+   * @param {string} [userId] - Optional target userId (admin action). Defaults to the calling user.
+   * @returns {Promise<{personalRoom: {id: string, dialInPin: string}}>}
+   */
+  async regeneratePersonalRoomPin(userId = null) {
+    const body = {};
+    if (userId) {
+      this.sdk.validateParams(
+        { userId },
+        { userId: { type: 'string', required: true } },
+      );
+      body.userId = userId;
+    }
+    const result = await internalRequest(this.sdk, 
+      '/video/personal-room/regenerate-pin',
+      'POST',
+      { body },
+    );
+    return result;
+  }
+
+  /**
+   * Live availability dry-run for a personal-room slug (settings editor).
+   *
+   * @param {string} slug - Candidate slug.
+   * @param {string} [userId] - Optional target userId (admin action). Defaults to the calling user.
+   * @returns {Promise<{slug: string, available: boolean, reason?: 'invalid'|'taken'}>}
+   */
+  async checkPersonalRoomSlug(slug, userId = null) {
+    this.sdk.validateParams(
+      { slug, userId },
+      {
+        slug: { type: 'string', required: true },
+        userId: { type: 'string', required: false },
+      },
+    );
+    const query = { slug };
+    if (userId) query.userId = userId;
+    const result = await internalRequest(this.sdk, 
+      '/video/personal-room/slug-available',
+      'GET',
+      { query },
+    );
+    return result;
+  }
+
+  /**
+   * Regenerate the static web passcode for the calling user's personal
+   * meeting room (a separate secret from the dial-in PIN). Sessions minted
+   * after this use the new value.
+   *
+   * @param {string} [userId] - Optional target userId (admin action). Defaults to the calling user.
+   * @returns {Promise<{personalRoom: {id: string, password: string}}>}
+   */
+  async regeneratePersonalRoomPassword(userId = null) {
+    const body = {};
+    if (userId) {
+      this.sdk.validateParams(
+        { userId },
+        { userId: { type: 'string', required: true } },
+      );
+      body.userId = userId;
+    }
+    const result = await internalRequest(this.sdk, 
+      '/video/personal-room/regenerate-password',
+      'POST',
+      { body },
+    );
+    return result;
+  }
+
+  /**
+   * Resolve a personal-room slug to a live session (join page). Guest-capable
+   * — mints/claims a fresh meeting if none is live, or returns the already
+   * -claimed session; if the caller is an unauthenticated guest and the room
+   * doesn't allow guests to start, returns `waitingForHost: true` instead.
+   * Guests only receive `password` when they supply the room's static
+   * passcode; otherwise `passwordRequired: true` is returned and the join
+   * page should prompt.
+   *
+   * @param {string} slug - The personal room's slug.
+   * @param {{password?: string}} [options] - The room's static passcode, when known.
+   * @returns {Promise<{claimed: boolean, meetingId?: string, friendlyName?: string, password?: string, passwordRequired?: boolean, waitingForHost?: boolean}>}
+   */
+  async resolvePersonalRoom(slug, { password } = {}) {
+    this.sdk.validateParams(
+      { slug, password },
+      {
+        slug: { type: 'string', required: true },
+        password: { type: 'string', required: false },
+      },
+    );
+
+    const result = await internalRequest(this.sdk, 
+      `/video/personal-room/resolve/${slug}`,
+      'POST',
+      { body: { password } },
+    );
+    return result;
+  }
 }