@heymantle/core-api-client 0.1.20 → 0.1.22

package/dist/index.js

@@ -2364,6 +2364,220 @@ var AiAgentRunsResource = class extends BaseResource {
   }
 };
 
+// src/resources/meetings.ts
+var MeetingsResource = class extends BaseResource {
+  /**
+   * List meetings with optional filters and pagination
+   *
+   * @param params - Filter and pagination parameters
+   * @returns Paginated list of meetings
+   *
+   * @example
+   * ```typescript
+   * // List all meetings
+   * const { meetings } = await client.meetings.list();
+   *
+   * // List meetings for a specific deal
+   * const { meetings } = await client.meetings.list({ dealId: 'deal_123' });
+   *
+   * // List meetings from Google Meet
+   * const { meetings } = await client.meetings.list({ platform: 'google_meet' });
+   * ```
+   */
+  async list(params) {
+    const response = await this.get("/meetings", params);
+    return {
+      meetings: response.meetings || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      page: response.page,
+      totalPages: response.totalPages
+    };
+  }
+  /**
+   * Retrieve a single meeting by ID with full transcript and attendee data
+   *
+   * @param meetingId - The meeting ID
+   * @returns The meeting with all related data
+   *
+   * @example
+   * ```typescript
+   * const { meeting } = await client.meetings.retrieve('meeting_123');
+   * console.log(meeting.transcript?.fullText);
+   * ```
+   */
+  async retrieve(meetingId) {
+    return this.get(`/meetings/${meetingId}`);
+  }
+  /**
+   * Create a new meeting
+   *
+   * Typically called when a recording starts in the browser extension.
+   * The meeting can be created with optional transcript and attendee data,
+   * or these can be added later via transcription.
+   *
+   * @param data - Meeting creation parameters
+   * @returns The created meeting
+   *
+   * @example
+   * ```typescript
+   * // Create meeting when recording starts
+   * const meeting = await client.meetings.create({
+   *   meetingData: {
+   *     platform: 'zoom',
+   *     title: 'Weekly Sync',
+   *     meetingUrl: 'https://zoom.us/j/123456789',
+   *     startTime: new Date().toISOString(),
+   *     recordingStatus: 'pending',
+   *   }
+   * });
+   *
+   * // Create meeting with transcript (from local transcription)
+   * const meeting = await client.meetings.create({
+   *   meetingData: { ... },
+   *   transcript: {
+   *     fullText: 'Hello, this is the transcript...',
+   *     utterances: [
+   *       { attendeeId: 'A', text: 'Hello', startTime: 0, endTime: 500 },
+   *     ],
+   *   },
+   *   attendees: [
+   *     { externalId: 'A', name: 'John Doe', email: 'john@example.com' },
+   *   ],
+   * });
+   * ```
+   */
+  async create(data) {
+    return this.post("/meetings", data);
+  }
+  /**
+   * Update an existing meeting
+   *
+   * @param meetingId - The meeting ID
+   * @param data - Fields to update
+   * @returns The updated meeting
+   *
+   * @example
+   * ```typescript
+   * // Update meeting title and link to a deal
+   * const meeting = await client.meetings.update('meeting_123', {
+   *   title: 'Updated Meeting Title',
+   *   dealId: 'deal_456',
+   * });
+   * ```
+   */
+  async update(meetingId, data) {
+    return this.put(`/meetings/${meetingId}`, data);
+  }
+  /**
+   * Archive (soft delete) a meeting
+   *
+   * @param meetingId - The meeting ID
+   * @returns Success response
+   *
+   * @example
+   * ```typescript
+   * await client.meetings.del('meeting_123');
+   * ```
+   */
+  async del(meetingId) {
+    return this._delete(`/meetings/${meetingId}`);
+  }
+  /**
+   * Get a signed URL to upload a meeting recording
+   *
+   * Returns a pre-signed S3 URL that can be used to upload the recording
+   * directly from the client. After uploading, call `startTranscription`
+   * to begin server-side transcription.
+   *
+   * @param meetingId - The meeting ID
+   * @param filename - Optional filename (default: "recording.webm")
+   * @returns Upload URL and recording key
+   *
+   * @example
+   * ```typescript
+   * const { uploadUrl, recordingKey } = await client.meetings.getUploadUrl('meeting_123');
+   *
+   * // Upload the recording blob directly to S3
+   * const response = await fetch(uploadUrl, {
+   *   method: 'PUT',
+   *   body: recordingBlob,
+   *   headers: { 'Content-Type': 'audio/webm' },
+   * });
+   *
+   * // Then start transcription
+   * await client.meetings.startTranscription('meeting_123', { recordingKey });
+   * ```
+   */
+  async getUploadUrl(meetingId, filename) {
+    return this.post(
+      `/meetings/${meetingId}/transcribe/upload`,
+      filename ? { filename } : {}
+    );
+  }
+  /**
+   * Start server-side transcription for a meeting
+   *
+   * The recording must first be uploaded using the URL from `getUploadUrl`.
+   * Transcription is processed asynchronously - poll `getTranscriptionStatus`
+   * or retrieve the meeting to check for completion.
+   *
+   * @param meetingId - The meeting ID
+   * @param params - Transcription parameters including the recording key
+   * @returns The meeting with pending transcription status
+   *
+   * @example
+   * ```typescript
+   * // Start transcription after uploading
+   * const meeting = await client.meetings.startTranscription('meeting_123', {
+   *   recordingKey: 'meeting-recordings/org-id/meeting-123/uuid/recording.webm',
+   * });
+   *
+   * // meeting.recordingStatus will be 'pending' or 'processing'
+   * ```
+   */
+  async startTranscription(meetingId, params) {
+    return this.post(`/meetings/${meetingId}/transcribe`, params);
+  }
+  /**
+   * Get the current transcription status for a meeting
+   *
+   * Use this to poll for transcription completion after calling
+   * `startTranscription`.
+   *
+   * @param meetingId - The meeting ID
+   * @returns Current transcription status
+   *
+   * @example
+   * ```typescript
+   * // Poll for completion
+   * const poll = async () => {
+   *   const status = await client.meetings.getTranscriptionStatus('meeting_123');
+   *
+   *   if (status.recordingStatus === 'ready') {
+   *     // Transcription complete - fetch the full meeting
+   *     const meeting = await client.meetings.retrieve('meeting_123');
+   *     return meeting;
+   *   }
+   *
+   *   if (status.recordingStatus === 'failed') {
+   *     throw new Error('Transcription failed');
+   *   }
+   *
+   *   // Still processing - wait and retry
+   *   await new Promise(r => setTimeout(r, 5000));
+   *   return poll();
+   * };
+   * ```
+   */
+  async getTranscriptionStatus(meetingId) {
+    return this.get(
+      `/meetings/${meetingId}/transcribe`
+    );
+  }
+};
+
 // src/client.ts
 var MantleCoreClient = class {
   constructor(config) {
@@ -2422,6 +2636,7 @@ var MantleCoreClient = class {
     this.emailUnsubscribeGroups = new EmailUnsubscribeGroupsResource(this);
     this.flowExtensions = new FlowExtensionsResource(this);
     this.aiAgentRuns = new AiAgentRunsResource(this);
+    this.meetings = new MeetingsResource(this);
   }
   /**
    * Register a middleware function

package/dist/index.mjs

@@ -2298,6 +2298,220 @@ var AiAgentRunsResource = class extends BaseResource {
   }
 };
 
+// src/resources/meetings.ts
+var MeetingsResource = class extends BaseResource {
+  /**
+   * List meetings with optional filters and pagination
+   *
+   * @param params - Filter and pagination parameters
+   * @returns Paginated list of meetings
+   *
+   * @example
+   * ```typescript
+   * // List all meetings
+   * const { meetings } = await client.meetings.list();
+   *
+   * // List meetings for a specific deal
+   * const { meetings } = await client.meetings.list({ dealId: 'deal_123' });
+   *
+   * // List meetings from Google Meet
+   * const { meetings } = await client.meetings.list({ platform: 'google_meet' });
+   * ```
+   */
+  async list(params) {
+    const response = await this.get("/meetings", params);
+    return {
+      meetings: response.meetings || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      page: response.page,
+      totalPages: response.totalPages
+    };
+  }
+  /**
+   * Retrieve a single meeting by ID with full transcript and attendee data
+   *
+   * @param meetingId - The meeting ID
+   * @returns The meeting with all related data
+   *
+   * @example
+   * ```typescript
+   * const { meeting } = await client.meetings.retrieve('meeting_123');
+   * console.log(meeting.transcript?.fullText);
+   * ```
+   */
+  async retrieve(meetingId) {
+    return this.get(`/meetings/${meetingId}`);
+  }
+  /**
+   * Create a new meeting
+   *
+   * Typically called when a recording starts in the browser extension.
+   * The meeting can be created with optional transcript and attendee data,
+   * or these can be added later via transcription.
+   *
+   * @param data - Meeting creation parameters
+   * @returns The created meeting
+   *
+   * @example
+   * ```typescript
+   * // Create meeting when recording starts
+   * const meeting = await client.meetings.create({
+   *   meetingData: {
+   *     platform: 'zoom',
+   *     title: 'Weekly Sync',
+   *     meetingUrl: 'https://zoom.us/j/123456789',
+   *     startTime: new Date().toISOString(),
+   *     recordingStatus: 'pending',
+   *   }
+   * });
+   *
+   * // Create meeting with transcript (from local transcription)
+   * const meeting = await client.meetings.create({
+   *   meetingData: { ... },
+   *   transcript: {
+   *     fullText: 'Hello, this is the transcript...',
+   *     utterances: [
+   *       { attendeeId: 'A', text: 'Hello', startTime: 0, endTime: 500 },
+   *     ],
+   *   },
+   *   attendees: [
+   *     { externalId: 'A', name: 'John Doe', email: 'john@example.com' },
+   *   ],
+   * });
+   * ```
+   */
+  async create(data) {
+    return this.post("/meetings", data);
+  }
+  /**
+   * Update an existing meeting
+   *
+   * @param meetingId - The meeting ID
+   * @param data - Fields to update
+   * @returns The updated meeting
+   *
+   * @example
+   * ```typescript
+   * // Update meeting title and link to a deal
+   * const meeting = await client.meetings.update('meeting_123', {
+   *   title: 'Updated Meeting Title',
+   *   dealId: 'deal_456',
+   * });
+   * ```
+   */
+  async update(meetingId, data) {
+    return this.put(`/meetings/${meetingId}`, data);
+  }
+  /**
+   * Archive (soft delete) a meeting
+   *
+   * @param meetingId - The meeting ID
+   * @returns Success response
+   *
+   * @example
+   * ```typescript
+   * await client.meetings.del('meeting_123');
+   * ```
+   */
+  async del(meetingId) {
+    return this._delete(`/meetings/${meetingId}`);
+  }
+  /**
+   * Get a signed URL to upload a meeting recording
+   *
+   * Returns a pre-signed S3 URL that can be used to upload the recording
+   * directly from the client. After uploading, call `startTranscription`
+   * to begin server-side transcription.
+   *
+   * @param meetingId - The meeting ID
+   * @param filename - Optional filename (default: "recording.webm")
+   * @returns Upload URL and recording key
+   *
+   * @example
+   * ```typescript
+   * const { uploadUrl, recordingKey } = await client.meetings.getUploadUrl('meeting_123');
+   *
+   * // Upload the recording blob directly to S3
+   * const response = await fetch(uploadUrl, {
+   *   method: 'PUT',
+   *   body: recordingBlob,
+   *   headers: { 'Content-Type': 'audio/webm' },
+   * });
+   *
+   * // Then start transcription
+   * await client.meetings.startTranscription('meeting_123', { recordingKey });
+   * ```
+   */
+  async getUploadUrl(meetingId, filename) {
+    return this.post(
+      `/meetings/${meetingId}/transcribe/upload`,
+      filename ? { filename } : {}
+    );
+  }
+  /**
+   * Start server-side transcription for a meeting
+   *
+   * The recording must first be uploaded using the URL from `getUploadUrl`.
+   * Transcription is processed asynchronously - poll `getTranscriptionStatus`
+   * or retrieve the meeting to check for completion.
+   *
+   * @param meetingId - The meeting ID
+   * @param params - Transcription parameters including the recording key
+   * @returns The meeting with pending transcription status
+   *
+   * @example
+   * ```typescript
+   * // Start transcription after uploading
+   * const meeting = await client.meetings.startTranscription('meeting_123', {
+   *   recordingKey: 'meeting-recordings/org-id/meeting-123/uuid/recording.webm',
+   * });
+   *
+   * // meeting.recordingStatus will be 'pending' or 'processing'
+   * ```
+   */
+  async startTranscription(meetingId, params) {
+    return this.post(`/meetings/${meetingId}/transcribe`, params);
+  }
+  /**
+   * Get the current transcription status for a meeting
+   *
+   * Use this to poll for transcription completion after calling
+   * `startTranscription`.
+   *
+   * @param meetingId - The meeting ID
+   * @returns Current transcription status
+   *
+   * @example
+   * ```typescript
+   * // Poll for completion
+   * const poll = async () => {
+   *   const status = await client.meetings.getTranscriptionStatus('meeting_123');
+   *
+   *   if (status.recordingStatus === 'ready') {
+   *     // Transcription complete - fetch the full meeting
+   *     const meeting = await client.meetings.retrieve('meeting_123');
+   *     return meeting;
+   *   }
+   *
+   *   if (status.recordingStatus === 'failed') {
+   *     throw new Error('Transcription failed');
+   *   }
+   *
+   *   // Still processing - wait and retry
+   *   await new Promise(r => setTimeout(r, 5000));
+   *   return poll();
+   * };
+   * ```
+   */
+  async getTranscriptionStatus(meetingId) {
+    return this.get(
+      `/meetings/${meetingId}/transcribe`
+    );
+  }
+};
+
 // src/client.ts
 var MantleCoreClient = class {
   constructor(config) {
@@ -2356,6 +2570,7 @@ var MantleCoreClient = class {
     this.emailUnsubscribeGroups = new EmailUnsubscribeGroupsResource(this);
     this.flowExtensions = new FlowExtensionsResource(this);
     this.aiAgentRuns = new AiAgentRunsResource(this);
+    this.meetings = new MeetingsResource(this);
   }
   /**
    * Register a middleware function

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heymantle/core-api-client",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "TypeScript SDK for the Mantle Core API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",