@nainudhin/video-meeting-sdk 1.0.2 → 1.5.0

package/dist/meet-sdk.d.ts

@@ -0,0 +1,152 @@
+// Type definitions for @nainudhin/video-meeting-sdk
+
+export interface MeetUser {
+  id: string;
+  name: string;
+}
+
+export interface PeerServerConfig {
+  host: string;
+  port: number;
+  path?: string;
+  secure?: boolean;
+}
+
+export interface AiConfig {
+  /** Bring-your-own Whisper key (rare; usually leave undefined). */
+  whisperKey?: string;
+  whisperUrl?: string;
+  /** Bring-your-own LLM key (rare; usually leave undefined). */
+  llmKey?: string;
+  llmUrl?: string;
+  llmModel?: string;
+}
+
+export type RecordingMode = 'auto' | 'manual' | 'off';
+export type RecordingSource = 'local' | 'composite';
+
+export interface IceServer {
+  urls: string | string[];
+  username?: string;
+  credential?: string;
+}
+
+export interface MeetSDKConfig {
+  workspace: string;
+  roomId: string;
+  user: MeetUser;
+
+  /** Overrides the built-in default host. */
+  host?: string;
+  apiUrl?: string;
+  socketUrl?: string;
+  peerServer?: PeerServerConfig;
+
+  /** TURN/STUN — merged with the built-in Google STUN defaults. */
+  iceServers?: IceServer[];
+
+  ai?: AiConfig;
+
+  /** When and how recording starts. Default 'off'. */
+  recording?: RecordingMode;
+  /** What gets recorded. Default 'local'. */
+  recordingMode?: RecordingSource;
+  /** Whisper transcription of the recording. Requires recording !== 'off'. */
+  transcribe?: boolean;
+  /** LLM summary of the transcript. Requires transcribe: true. */
+  summarize?: boolean;
+  /** Restrict recording to the meeting host. Default true. */
+  recordOnlyIfHost?: boolean;
+
+  /** Show the built-in screen-share button. Default true. */
+  screenShare?: boolean;
+
+  /** Composite recording canvas size. Defaults 1280 / 720 / 30. */
+  compositeWidth?: number;
+  compositeHeight?: number;
+  compositeFps?: number;
+}
+
+export interface RecordingSummary {
+  executiveSummary?: string | null;
+  actionItems?: string[];
+  decisions?: string[];
+  speakerHighlights?: Array<{ speaker?: string; highlight?: string }>;
+}
+
+export interface RecordingRow {
+  recordingId: string;
+  fileName: string;
+  fileSize: number;
+  contentType: string;
+  durationSec: number | null;
+  recordedBy: string | null;
+  startedAt: string | null;
+  endedAt: string | null;
+  createdAt: string;
+  playbackUrl: string;
+  transcriptionStatus: 'skipped' | 'pending' | 'complete' | 'failed';
+  transcript?: string | null;
+  transcriptError?: string | null;
+  summaryStatus: 'skipped' | 'pending' | 'complete' | 'failed';
+  summary?: RecordingSummary | null;
+  summaryError?: string | null;
+}
+
+export interface FinalizeResult {
+  success: boolean;
+  recordingId: string;
+  fileName: string;
+  fileSize: number;
+  contentType: string;
+  durationSec: number | null;
+  playbackUrl: string;
+  transcriptionStatus: string;
+  summaryStatus: string;
+  createdAt: string;
+}
+
+export interface ChatAttachment {
+  attachmentId: string;
+  fileName: string;
+  fileSize: number;
+  contentType: string;
+  url: string;
+}
+
+export interface ChatMessageRow {
+  userId: string;
+  userName: string;
+  message: string;
+  attachments: ChatAttachment[];
+  timestamp: string;
+}
+
+export default class MeetSDK {
+  constructor();
+
+  init(config: MeetSDKConfig): void;
+  mount(target: string | Element): Promise<void>;
+  leave(): Promise<void>;
+
+  setAiConfig(ai: Partial<AiConfig>): void;
+
+  startRecording(): Promise<void>;
+  stopRecording(): Promise<FinalizeResult | null>;
+
+  listRecordings(): Promise<{ success: boolean; recordings: RecordingRow[] }>;
+  getRecording(recordingId: string): Promise<{ success: boolean; recording: RecordingRow }>;
+
+  fetchChatHistory(opts?: { limit?: number; before?: string; after?: string }): Promise<{ success: boolean; messages: ChatMessageRow[] }>;
+  uploadChatAttachment(file: File): Promise<ChatAttachment & { success: boolean }>;
+
+  getSummary(): Promise<any>;
+  generateSummary(): Promise<any>;
+  transcribeAudio(blob: Blob, filename?: string): Promise<any>;
+}
+
+declare global {
+  interface Window {
+    MeetSDK: MeetSDK;
+  }
+}