@todesktop/client-recall 1.0.1

package/README.md

@@ -0,0 +1,271 @@
+# ToDesktop Recall Desktop SDK Plugin
+
+A ToDesktop plugin that integrates with [Recall.ai's Desktop Recording SDK](https://docs.recall.ai/docs/desktop-sdk) to enable automatic meeting recording for Zoom, Google Meet, and Microsoft Teams.
+
+## Overview
+
+This plugin provides a complete integration between ToDesktop and the Recall.ai Desktop Recording SDK, offering:
+
+- **Automatic meeting detection** for Zoom, Google Meet, Microsoft Teams, and Slack
+- **Recording management** with start, stop, pause, and resume functionality
+- **Desktop audio recording** for non-meeting scenarios
+- **Real-time events** including transcription and participant data
+- **Permission management** for accessibility, screen capture, and microphone access
+- **Upload progress tracking** and webhook integration
+- **Type-safe client library** for web applications
+
+## Installation &s Setup
+
+### Prerequisites
+
+1. **Recall.ai Account**: Sign up at [recall.ai](https://recall.ai) and get your API key
+2. **ToDesktop Builder App**: Create a ToDesktop application
+3. **Backend Integration**: Set up webhook endpoints and upload token generation
+
+### 1. Install Dependencies
+
+```bash
+npm install @todesktop/client-recall
+```
+
+### 3. Add Plugin to ToDesktop Builder
+
+1. Open ToDesktop Builder
+2. Install the recall desktop sdk plugin
+
+### 4. Configure Plugin Preferences
+
+In ToDesktop Builder, configure the following preferences:
+
+- **API URL**: Your Recall.ai region URL (e.g., `https://us-east-1.recall.ai`)
+- **Enable Plugin**: Toggle to enable/disable recording functionality
+- **Request permissions on startup**: Automatically request required permissions
+
+## Usage
+
+### Basic Recording Workflow
+
+```typescript
+import { recallDesktop } from "@todesktop/client-recall";
+
+// Initialize the SDK
+await recallDesktop.initSdk();
+
+// Listen for meeting detection
+recallDesktop.onMeetingDetected(async ({ window }) => {
+  console.log("Meeting detected:", window);
+
+  // Get upload token from your backend
+  const uploadToken = await getUploadTokenFromBackend();
+
+  // Start recording
+  const result = await recallDesktop.startRecording(window.id, uploadToken);
+  if (result.success) {
+    console.log("Recording started successfully");
+  }
+});
+
+// Listen for recording events
+recallDesktop.onRecordingStateChange(({ sdk }) => {
+  console.log("Recording state:", sdk.state.code);
+});
+
+recallDesktop.onUploadProgress(({ progress }) => {
+  console.log(`Upload progress: ${progress}%`);
+});
+
+// Handle recording completion
+recallDesktop.onRecordingEnded(async ({ window }) => {
+  console.log("Recording ended for window:", window.id);
+
+  // Upload the recording
+  await recallDesktop.uploadRecording(window.id);
+});
+```
+
+### Desktop Audio Recording
+
+For capturing audio from applications other than supported meeting platforms:
+
+```typescript
+// Prepare desktop audio recording
+const { data } = await recallDesktop.prepareDesktopAudioRecording();
+const { windowId } = data;
+
+// Get upload token and start recording
+const uploadToken = await getUploadTokenFromBackend();
+await recallDesktop.startRecording(windowId, uploadToken);
+
+// Stop when done
+await recallDesktop.stopRecording(windowId);
+await recallDesktop.uploadRecording(windowId);
+```
+
+### Permission Management
+
+```typescript
+// Check permission status
+const status = await recallDesktop.getStatus();
+console.log("Permissions:", status.permissions);
+
+// Request specific permission
+await recallDesktop.requestPermission("screen-capture");
+
+// Listen for permission changes
+recallDesktop.onPermissionStatusChange(({ permission, status }) => {
+  console.log(`Permission ${permission}: ${status}`);
+});
+```
+
+## Backend Integration
+
+### Creating Upload Tokens
+
+Your backend needs to create upload tokens using the Recall.ai API:
+
+```javascript
+// Example backend endpoint
+app.post("/api/create-upload-token", async (req, res) => {
+  const response = await fetch(`${RECALL_API_URL}/api/v1/sdk-upload/`, {
+    method: "POST",
+    headers: {
+      Authorization: `Token ${RECALL_API_KEY}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      transcript: {
+        provider: {
+          assembly_ai_streaming: {},
+        },
+      },
+    }),
+  });
+
+  const data = await response.json();
+  res.json({ uploadToken: data.upload_token });
+});
+```
+
+### Webhook Handling
+
+Set up webhooks to handle recording completion:
+
+```javascript
+app.post("/webhooks/recall", (req, res) => {
+  const { event, data } = req.body;
+
+  switch (event) {
+    case "sdk_upload.complete":
+      console.log("Recording completed:", data.recording.id);
+      // Process completed recording
+      break;
+
+    case "sdk_upload.failed":
+      console.log("Recording failed:", data);
+      // Handle failure
+      break;
+
+    case "sdk_upload.uploading":
+      console.log("Recording uploading:", data);
+      // Track upload progress
+      break;
+  }
+
+  res.status(200).send("OK");
+});
+```
+
+## API Reference
+
+### Main Methods
+
+- `initSdk()` - Initialize the Recall SDK
+- `shutdownSdk()` - Shutdown the SDK and cleanup
+- `getStatus()` - Get plugin and SDK status
+- `startRecording(windowId, uploadToken)` - Start recording a meeting
+- `stopRecording(windowId)` - Stop recording
+- `pauseRecording(windowId)` - Pause recording
+- `resumeRecording(windowId)` - Resume recording
+- `uploadRecording(windowId)` - Upload completed recording
+- `prepareDesktopAudioRecording()` - Prepare desktop audio capture
+
+### Event Listeners
+
+- `onMeetingDetected(callback)` - Meeting window detected
+- `onRecordingStateChange(callback)` - Recording state changes
+- `onRecordingStarted(callback)` - Recording started
+- `onRecordingEnded(callback)` - Recording completed
+- `onUploadProgress(callback)` - Upload progress updates
+- `onError(callback)` - SDK errors
+- `onPermissionStatusChange(callback)` - Permission changes
+
+### Configuration
+
+- `setConfig(config)` - Update plugin configuration
+- `getConfig()` - Get current configuration
+- `requestPermission(permission)` - Request specific permission
+
+## Development
+
+### Available Scripts
+
+- `npm run build` - Build all packages
+- `npm run dev` - Development mode with watch
+- `npm run test` - Run tests
+- `npm run typecheck` - TypeScript type checking
+- `npm run clean` - Clean build artifacts
+
+### Plugin Development
+
+The plugin uses a mock Recall SDK implementation for development. To integrate with the real SDK:
+
+1. Install the actual Recall SDK:
+
+   ```bash
+   npm install @recallai/desktop-sdk --workspace=packages/plugin
+   ```
+
+2. Replace the mock in `packages/plugin/src/main.ts`:
+   ```typescript
+   // Replace mock with real import
+   import RecallAiSdk from "@recallai/desktop-sdk";
+   ```
+
+## Supported Platforms
+
+- **Zoom**: Full meeting detection and recording
+- **Google Meet**: Full meeting detection and recording
+- **Microsoft Teams**: Full meeting detection and recording
+- **Slack Huddles**: Audio capture (limited metadata)
+- **Desktop Audio**: General audio capture for other applications
+
+## Security & Privacy
+
+- All recording operations require explicit user consent
+- Plugin preferences control recording behavior
+- Recordings are encrypted during upload
+- Only authorized applications can access the recording APIs
+- Meeting participants should be notified of recording as required by law
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Plugin not loading**: Verify plugin is properly configured in ToDesktop Builder
+2. **Permissions denied**: Ensure all required permissions are granted in System Preferences
+3. **SDK initialization fails**: Check API URL and network connectivity
+4. **Recording fails**: Verify upload token is valid and backend is accessible
+
+### Debug Mode
+
+Enable debug logging by setting preferences or environment variables in your ToDesktop app.
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Support
+
+- [Recall.ai Documentation](https://docs.recall.ai/docs/desktop-sdk-beta)
+- [ToDesktop Plugin Documentation](https://docs.todesktop.com/plugins)
+- [GitHub Issues](https://github.com/your-org/todesktop-recall/issues)

package/dist/index.d.ts

@@ -0,0 +1,273 @@
+/**
+ * ToDesktop Recall Desktop SDK Plugin - Client Library
+ *
+ * This library provides a clean API for web applications to interact
+ * with the ToDesktop Recall Desktop SDK plugin through the exposed window APIs.
+ */
+import type { RecallDesktopApi } from './generated/preload';
+declare global {
+    interface Window {
+        recallDesktop?: RecallDesktopApi;
+    }
+}
+/**
+ * Meeting window information
+ */
+export interface MeetingWindow {
+    id: string;
+    title?: string;
+    url?: string;
+    platform: string;
+}
+/**
+ * Plugin configuration options
+ */
+export interface RecallSdkConfig {
+    enabled: boolean;
+    apiUrl: string;
+    requestPermissionsOnStartup: boolean;
+}
+/**
+ * Plugin status information
+ */
+export interface PluginStatus {
+    initialized: boolean;
+    sdkInitialized: boolean;
+    version: string;
+    config: RecallSdkConfig;
+    sdkState?: 'recording' | 'idle' | 'paused';
+    permissions?: {
+        accessibility: boolean;
+        screenCapture: boolean;
+        microphone: boolean;
+        systemAudio: boolean;
+    };
+}
+/**
+ * API response wrapper
+ */
+export interface ApiResponse<T = any> {
+    success: boolean;
+    message: string;
+    data?: T;
+}
+/**
+ * Permission types
+ */
+export type PermissionType = 'accessibility' | 'screen-capture' | 'microphone' | 'system-audio';
+/**
+ * SDK event types
+ */
+export type RecallSdkEventType = 'recording-started' | 'recording-ended' | 'upload-progress' | 'meeting-detected' | 'meeting-updated' | 'meeting-closed' | 'sdk-state-change' | 'error' | 'media-capture-status' | 'participant-capture-status' | 'permissions-granted' | 'permission-status' | 'realtime-event' | 'shutdown';
+/**
+ * Event handler function type
+ */
+export type EventHandler<T = any> = (data: T) => void;
+/**
+ * Recall Desktop SDK Client API
+ * Provides a safe wrapper around the window.recallDesktop API
+ */
+export declare class RecallDesktopClient {
+    private api;
+    private eventUnsubscribers;
+    constructor();
+    /**
+     * Check if the plugin is available
+     * @returns true if plugin is available, false otherwise
+     */
+    isAvailable(): boolean;
+    /**
+     * Initialize the Recall SDK
+     * @returns Promise resolving to initialization result
+     * @throws Error if plugin is not available
+     */
+    initSdk(): Promise<ApiResponse>;
+    /**
+     * Shutdown the Recall SDK
+     * @returns Promise resolving to shutdown result
+     * @throws Error if plugin is not available
+     */
+    shutdownSdk(): Promise<ApiResponse>;
+    /**
+     * Get current plugin and SDK status
+     * @returns Promise resolving to plugin status
+     * @throws Error if plugin is not available
+     */
+    getStatus(): Promise<PluginStatus>;
+    /**
+     * Start recording a meeting
+     * @param windowId The meeting window ID
+     * @param uploadToken Upload token from your backend
+     * @returns Promise resolving to recording start result
+     * @throws Error if plugin is not available
+     */
+    startRecording(windowId: string, uploadToken: string): Promise<ApiResponse>;
+    /**
+     * Stop recording a meeting
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to recording stop result
+     * @throws Error if plugin is not available
+     */
+    stopRecording(windowId: string): Promise<ApiResponse>;
+    /**
+     * Pause recording a meeting
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to recording pause result
+     * @throws Error if plugin is not available
+     */
+    pauseRecording(windowId: string): Promise<ApiResponse>;
+    /**
+     * Resume recording a meeting
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to recording resume result
+     * @throws Error if plugin is not available
+     */
+    resumeRecording(windowId: string): Promise<ApiResponse>;
+    /**
+     * Upload a completed recording
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to upload start result
+     * @throws Error if plugin is not available
+     */
+    uploadRecording(windowId: string): Promise<ApiResponse>;
+    /**
+     * Prepare desktop audio recording for non-meeting audio capture
+     * @returns Promise resolving to desktop audio preparation result with windowId
+     * @throws Error if plugin is not available
+     */
+    prepareDesktopAudioRecording(): Promise<ApiResponse<{
+        windowId: string;
+    }>>;
+    /**
+     * Request a specific permission from the user
+     * @param permission The permission to request
+     * @returns Promise resolving to permission request result
+     * @throws Error if plugin is not available
+     */
+    requestPermission(permission: PermissionType): Promise<ApiResponse>;
+    /**
+     * Update plugin configuration
+     * @param config Configuration updates
+     * @returns Promise resolving to update result
+     * @throws Error if plugin is not available
+     */
+    setConfig(config: Partial<RecallSdkConfig>): Promise<ApiResponse>;
+    /**
+     * Get current plugin configuration
+     * @returns Promise resolving to current configuration
+     * @throws Error if plugin is not available
+     */
+    getConfig(): Promise<ApiResponse<RecallSdkConfig>>;
+    /**
+     * Subscribe to SDK events
+     * @param eventType The type of event to listen for
+     * @param callback Function to call when event occurs
+     * @returns Function to unsubscribe from the event
+     * @throws Error if plugin is not available
+     */
+    addEventListener<T = any>(eventType: RecallSdkEventType, callback: EventHandler<T>): () => void;
+    /**
+     * Remove all event listeners managed by this client instance
+     */
+    removeAllEventListeners(): void;
+    /**
+     * Get plugin version
+     * @returns Plugin version string
+     * @throws Error if plugin is not available
+     */
+    getVersion(): string;
+    /**
+     * Subscribe to meeting detection events
+     * @param callback Function to call when a meeting is detected
+     * @returns Function to unsubscribe from the event
+     */
+    onMeetingDetected(callback: EventHandler<{
+        window: MeetingWindow;
+    }>): () => void;
+    /**
+     * Subscribe to recording state changes
+     * @param callback Function to call when recording state changes
+     * @returns Function to unsubscribe from the event
+     */
+    onRecordingStateChange(callback: EventHandler<{
+        sdk: {
+            state: {
+                code: 'recording' | 'idle' | 'paused';
+            };
+        };
+    }>): () => void;
+    /**
+     * Subscribe to upload progress updates
+     * @param callback Function to call when upload progress updates
+     * @returns Function to unsubscribe from the event
+     */
+    onUploadProgress(callback: EventHandler<{
+        window: {
+            id: string;
+        };
+        progress: number;
+    }>): () => void;
+    /**
+     * Subscribe to permission status updates
+     * @param callback Function to call when permission status changes
+     * @returns Function to unsubscribe from the event
+     */
+    onPermissionStatusChange(callback: EventHandler<{
+        permission: PermissionType;
+        status: string;
+    }>): () => void;
+    /**
+     * Subscribe to SDK errors
+     * @param callback Function to call when SDK errors occur
+     * @returns Function to unsubscribe from the event
+     */
+    onError(callback: EventHandler<{
+        window?: MeetingWindow;
+        type: string;
+        message: string;
+    }>): () => void;
+    /**
+     * Subscribe to real-time events (transcription, participants, etc.)
+     * @param callback Function to call when real-time events occur
+     * @returns Function to unsubscribe from the event
+     */
+    onRealtimeEvent(callback: EventHandler<{
+        window: MeetingWindow;
+        event: string;
+        data: any;
+    }>): () => void;
+    /**
+     * Subscribe to recording started events
+     * @param callback Function to call when recording starts
+     * @returns Function to unsubscribe from the event
+     */
+    onRecordingStarted(callback: EventHandler<{
+        window: MeetingWindow;
+    }>): () => void;
+    /**
+     * Subscribe to recording ended events
+     * @param callback Function to call when recording ends
+     * @returns Function to unsubscribe from the event
+     */
+    onRecordingEnded(callback: EventHandler<{
+        window: MeetingWindow;
+    }>): () => void;
+    /**
+     * Subscribe to meeting closed events
+     * @param callback Function to call when meeting closes
+     * @returns Function to unsubscribe from the event
+     */
+    onMeetingClosed(callback: EventHandler<{
+        window: MeetingWindow;
+    }>): () => void;
+    /**
+     * Subscribe to permissions granted events
+     * @param callback Function to call when permissions are granted
+     * @returns Function to unsubscribe from the event
+     */
+    onPermissionsGranted(callback: EventHandler<any>): () => void;
+}
+export declare const recallDesktop: RecallDesktopClient;
+export default RecallDesktopClient;
+export type { RecallDesktopApi } from './generated/preload';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,aAAa,CAAC,EAAE,gBAAgB,CAAC;KAClC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B,EAAE,OAAO,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC3C,WAAW,CAAC,EAAE;QACZ,aAAa,EAAE,OAAO,CAAC;QACvB,aAAa,EAAE,OAAO,CAAC;QACvB,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,gBAAgB,GAAG,YAAY,GAAG,cAAc,CAAC;AAEhG;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,iBAAiB,GACjB,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,OAAO,GACP,sBAAsB,GACtB,4BAA4B,GAC5B,qBAAqB,GACrB,mBAAmB,GACnB,gBAAgB,GAChB,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEtD;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,GAAG,CAAiC;IAC5C,OAAO,CAAC,kBAAkB,CAAiC;;IAS3D;;;OAGG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAOrC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAWzC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAOxC;;;;;;OAMG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOjF;;;;;OAKG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO3D;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO5D;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO7D;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO7D;;;;OAIG;IACG,4BAA4B,IAAI,OAAO,CAAC,WAAW,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAOhF;;;;;OAKG;IACG,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAOzE;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAOvE;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAOxD;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAgB/F;;OAEG;IACH,uBAAuB,IAAI,IAAI;IAK/B;;;;OAIG;IACH,UAAU,IAAI,MAAM;IASpB;;;;OAIG;IACH,iBAAiB,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAIhF;;;;OAIG;IACH,sBAAsB,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,GAAG,EAAE;YAAE,KAAK,EAAE;gBAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAIzH;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,MAAM,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAIlG;;;;OAIG;IACH,wBAAwB,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAI5G;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,MAAM,CAAC,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAItG;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAIxG;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAIjF;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAI/E;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAI9E;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI;CAG9D;AAGD,eAAO,MAAM,aAAa,qBAA4B,CAAC;AAGvD,eAAe,mBAAmB,CAAC;AAGnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.esm.js

@@ -0,0 +1,293 @@
+/**
+ * ToDesktop Recall Desktop SDK Plugin - Client Library
+ *
+ * This library provides a clean API for web applications to interact
+ * with the ToDesktop Recall Desktop SDK plugin through the exposed window APIs.
+ */
+/**
+ * Recall Desktop SDK Client API
+ * Provides a safe wrapper around the window.recallDesktop API
+ */
+class RecallDesktopClient {
+    constructor() {
+        this.api = null;
+        this.eventUnsubscribers = new Map();
+        // Check if running in ToDesktop environment
+        if (typeof window !== 'undefined' && window.recallDesktop) {
+            this.api = window.recallDesktop;
+        }
+    }
+    /**
+     * Check if the plugin is available
+     * @returns true if plugin is available, false otherwise
+     */
+    isAvailable() {
+        return this.api !== null;
+    }
+    /**
+     * Initialize the Recall SDK
+     * @returns Promise resolving to initialization result
+     * @throws Error if plugin is not available
+     */
+    async initSdk() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.initSdk();
+    }
+    /**
+     * Shutdown the Recall SDK
+     * @returns Promise resolving to shutdown result
+     * @throws Error if plugin is not available
+     */
+    async shutdownSdk() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        // Clean up event listeners
+        this.removeAllEventListeners();
+        return this.api.shutdownSdk();
+    }
+    /**
+     * Get current plugin and SDK status
+     * @returns Promise resolving to plugin status
+     * @throws Error if plugin is not available
+     */
+    async getStatus() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.getStatus();
+    }
+    /**
+     * Start recording a meeting
+     * @param windowId The meeting window ID
+     * @param uploadToken Upload token from your backend
+     * @returns Promise resolving to recording start result
+     * @throws Error if plugin is not available
+     */
+    async startRecording(windowId, uploadToken) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.startRecording(windowId, uploadToken);
+    }
+    /**
+     * Stop recording a meeting
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to recording stop result
+     * @throws Error if plugin is not available
+     */
+    async stopRecording(windowId) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.stopRecording(windowId);
+    }
+    /**
+     * Pause recording a meeting
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to recording pause result
+     * @throws Error if plugin is not available
+     */
+    async pauseRecording(windowId) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.pauseRecording(windowId);
+    }
+    /**
+     * Resume recording a meeting
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to recording resume result
+     * @throws Error if plugin is not available
+     */
+    async resumeRecording(windowId) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.resumeRecording(windowId);
+    }
+    /**
+     * Upload a completed recording
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to upload start result
+     * @throws Error if plugin is not available
+     */
+    async uploadRecording(windowId) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.uploadRecording(windowId);
+    }
+    /**
+     * Prepare desktop audio recording for non-meeting audio capture
+     * @returns Promise resolving to desktop audio preparation result with windowId
+     * @throws Error if plugin is not available
+     */
+    async prepareDesktopAudioRecording() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.prepareDesktopAudioRecording();
+    }
+    /**
+     * Request a specific permission from the user
+     * @param permission The permission to request
+     * @returns Promise resolving to permission request result
+     * @throws Error if plugin is not available
+     */
+    async requestPermission(permission) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.requestPermission(permission);
+    }
+    /**
+     * Update plugin configuration
+     * @param config Configuration updates
+     * @returns Promise resolving to update result
+     * @throws Error if plugin is not available
+     */
+    async setConfig(config) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.setConfig(config);
+    }
+    /**
+     * Get current plugin configuration
+     * @returns Promise resolving to current configuration
+     * @throws Error if plugin is not available
+     */
+    async getConfig() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.getConfig();
+    }
+    /**
+     * Subscribe to SDK events
+     * @param eventType The type of event to listen for
+     * @param callback Function to call when event occurs
+     * @returns Function to unsubscribe from the event
+     * @throws Error if plugin is not available
+     */
+    addEventListener(eventType, callback) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        const unsubscribe = this.api.addEventListener(eventType, callback);
+        const key = `${eventType}-${Date.now()}-${Math.random()}`;
+        this.eventUnsubscribers.set(key, unsubscribe);
+        // Return enhanced unsubscribe function that also cleans up our tracking
+        return () => {
+            unsubscribe();
+            this.eventUnsubscribers.delete(key);
+        };
+    }
+    /**
+     * Remove all event listeners managed by this client instance
+     */
+    removeAllEventListeners() {
+        this.eventUnsubscribers.forEach(unsubscribe => unsubscribe());
+        this.eventUnsubscribers.clear();
+    }
+    /**
+     * Get plugin version
+     * @returns Plugin version string
+     * @throws Error if plugin is not available
+     */
+    getVersion() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.getVersion();
+    }
+    // Convenience methods for common event types
+    /**
+     * Subscribe to meeting detection events
+     * @param callback Function to call when a meeting is detected
+     * @returns Function to unsubscribe from the event
+     */
+    onMeetingDetected(callback) {
+        return this.addEventListener('meeting-detected', callback);
+    }
+    /**
+     * Subscribe to recording state changes
+     * @param callback Function to call when recording state changes
+     * @returns Function to unsubscribe from the event
+     */
+    onRecordingStateChange(callback) {
+        return this.addEventListener('sdk-state-change', callback);
+    }
+    /**
+     * Subscribe to upload progress updates
+     * @param callback Function to call when upload progress updates
+     * @returns Function to unsubscribe from the event
+     */
+    onUploadProgress(callback) {
+        return this.addEventListener('upload-progress', callback);
+    }
+    /**
+     * Subscribe to permission status updates
+     * @param callback Function to call when permission status changes
+     * @returns Function to unsubscribe from the event
+     */
+    onPermissionStatusChange(callback) {
+        return this.addEventListener('permission-status', callback);
+    }
+    /**
+     * Subscribe to SDK errors
+     * @param callback Function to call when SDK errors occur
+     * @returns Function to unsubscribe from the event
+     */
+    onError(callback) {
+        return this.addEventListener('error', callback);
+    }
+    /**
+     * Subscribe to real-time events (transcription, participants, etc.)
+     * @param callback Function to call when real-time events occur
+     * @returns Function to unsubscribe from the event
+     */
+    onRealtimeEvent(callback) {
+        return this.addEventListener('realtime-event', callback);
+    }
+    /**
+     * Subscribe to recording started events
+     * @param callback Function to call when recording starts
+     * @returns Function to unsubscribe from the event
+     */
+    onRecordingStarted(callback) {
+        return this.addEventListener('recording-started', callback);
+    }
+    /**
+     * Subscribe to recording ended events
+     * @param callback Function to call when recording ends
+     * @returns Function to unsubscribe from the event
+     */
+    onRecordingEnded(callback) {
+        return this.addEventListener('recording-ended', callback);
+    }
+    /**
+     * Subscribe to meeting closed events
+     * @param callback Function to call when meeting closes
+     * @returns Function to unsubscribe from the event
+     */
+    onMeetingClosed(callback) {
+        return this.addEventListener('meeting-closed', callback);
+    }
+    /**
+     * Subscribe to permissions granted events
+     * @param callback Function to call when permissions are granted
+     * @returns Function to unsubscribe from the event
+     */
+    onPermissionsGranted(callback) {
+        return this.addEventListener('permissions-granted', callback);
+    }
+}
+// Create and export a default instance
+const recallDesktop = new RecallDesktopClient();
+
+export { RecallDesktopClient, RecallDesktopClient as default, recallDesktop };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,299 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * ToDesktop Recall Desktop SDK Plugin - Client Library
+ *
+ * This library provides a clean API for web applications to interact
+ * with the ToDesktop Recall Desktop SDK plugin through the exposed window APIs.
+ */
+/**
+ * Recall Desktop SDK Client API
+ * Provides a safe wrapper around the window.recallDesktop API
+ */
+class RecallDesktopClient {
+    constructor() {
+        this.api = null;
+        this.eventUnsubscribers = new Map();
+        // Check if running in ToDesktop environment
+        if (typeof window !== 'undefined' && window.recallDesktop) {
+            this.api = window.recallDesktop;
+        }
+    }
+    /**
+     * Check if the plugin is available
+     * @returns true if plugin is available, false otherwise
+     */
+    isAvailable() {
+        return this.api !== null;
+    }
+    /**
+     * Initialize the Recall SDK
+     * @returns Promise resolving to initialization result
+     * @throws Error if plugin is not available
+     */
+    async initSdk() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.initSdk();
+    }
+    /**
+     * Shutdown the Recall SDK
+     * @returns Promise resolving to shutdown result
+     * @throws Error if plugin is not available
+     */
+    async shutdownSdk() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        // Clean up event listeners
+        this.removeAllEventListeners();
+        return this.api.shutdownSdk();
+    }
+    /**
+     * Get current plugin and SDK status
+     * @returns Promise resolving to plugin status
+     * @throws Error if plugin is not available
+     */
+    async getStatus() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.getStatus();
+    }
+    /**
+     * Start recording a meeting
+     * @param windowId The meeting window ID
+     * @param uploadToken Upload token from your backend
+     * @returns Promise resolving to recording start result
+     * @throws Error if plugin is not available
+     */
+    async startRecording(windowId, uploadToken) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.startRecording(windowId, uploadToken);
+    }
+    /**
+     * Stop recording a meeting
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to recording stop result
+     * @throws Error if plugin is not available
+     */
+    async stopRecording(windowId) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.stopRecording(windowId);
+    }
+    /**
+     * Pause recording a meeting
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to recording pause result
+     * @throws Error if plugin is not available
+     */
+    async pauseRecording(windowId) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.pauseRecording(windowId);
+    }
+    /**
+     * Resume recording a meeting
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to recording resume result
+     * @throws Error if plugin is not available
+     */
+    async resumeRecording(windowId) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.resumeRecording(windowId);
+    }
+    /**
+     * Upload a completed recording
+     * @param windowId The meeting window ID
+     * @returns Promise resolving to upload start result
+     * @throws Error if plugin is not available
+     */
+    async uploadRecording(windowId) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.uploadRecording(windowId);
+    }
+    /**
+     * Prepare desktop audio recording for non-meeting audio capture
+     * @returns Promise resolving to desktop audio preparation result with windowId
+     * @throws Error if plugin is not available
+     */
+    async prepareDesktopAudioRecording() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.prepareDesktopAudioRecording();
+    }
+    /**
+     * Request a specific permission from the user
+     * @param permission The permission to request
+     * @returns Promise resolving to permission request result
+     * @throws Error if plugin is not available
+     */
+    async requestPermission(permission) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.requestPermission(permission);
+    }
+    /**
+     * Update plugin configuration
+     * @param config Configuration updates
+     * @returns Promise resolving to update result
+     * @throws Error if plugin is not available
+     */
+    async setConfig(config) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.setConfig(config);
+    }
+    /**
+     * Get current plugin configuration
+     * @returns Promise resolving to current configuration
+     * @throws Error if plugin is not available
+     */
+    async getConfig() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.getConfig();
+    }
+    /**
+     * Subscribe to SDK events
+     * @param eventType The type of event to listen for
+     * @param callback Function to call when event occurs
+     * @returns Function to unsubscribe from the event
+     * @throws Error if plugin is not available
+     */
+    addEventListener(eventType, callback) {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        const unsubscribe = this.api.addEventListener(eventType, callback);
+        const key = `${eventType}-${Date.now()}-${Math.random()}`;
+        this.eventUnsubscribers.set(key, unsubscribe);
+        // Return enhanced unsubscribe function that also cleans up our tracking
+        return () => {
+            unsubscribe();
+            this.eventUnsubscribers.delete(key);
+        };
+    }
+    /**
+     * Remove all event listeners managed by this client instance
+     */
+    removeAllEventListeners() {
+        this.eventUnsubscribers.forEach(unsubscribe => unsubscribe());
+        this.eventUnsubscribers.clear();
+    }
+    /**
+     * Get plugin version
+     * @returns Plugin version string
+     * @throws Error if plugin is not available
+     */
+    getVersion() {
+        if (!this.api) {
+            throw new Error('Recall Desktop SDK plugin is not available. Make sure you are running in ToDesktop.');
+        }
+        return this.api.getVersion();
+    }
+    // Convenience methods for common event types
+    /**
+     * Subscribe to meeting detection events
+     * @param callback Function to call when a meeting is detected
+     * @returns Function to unsubscribe from the event
+     */
+    onMeetingDetected(callback) {
+        return this.addEventListener('meeting-detected', callback);
+    }
+    /**
+     * Subscribe to recording state changes
+     * @param callback Function to call when recording state changes
+     * @returns Function to unsubscribe from the event
+     */
+    onRecordingStateChange(callback) {
+        return this.addEventListener('sdk-state-change', callback);
+    }
+    /**
+     * Subscribe to upload progress updates
+     * @param callback Function to call when upload progress updates
+     * @returns Function to unsubscribe from the event
+     */
+    onUploadProgress(callback) {
+        return this.addEventListener('upload-progress', callback);
+    }
+    /**
+     * Subscribe to permission status updates
+     * @param callback Function to call when permission status changes
+     * @returns Function to unsubscribe from the event
+     */
+    onPermissionStatusChange(callback) {
+        return this.addEventListener('permission-status', callback);
+    }
+    /**
+     * Subscribe to SDK errors
+     * @param callback Function to call when SDK errors occur
+     * @returns Function to unsubscribe from the event
+     */
+    onError(callback) {
+        return this.addEventListener('error', callback);
+    }
+    /**
+     * Subscribe to real-time events (transcription, participants, etc.)
+     * @param callback Function to call when real-time events occur
+     * @returns Function to unsubscribe from the event
+     */
+    onRealtimeEvent(callback) {
+        return this.addEventListener('realtime-event', callback);
+    }
+    /**
+     * Subscribe to recording started events
+     * @param callback Function to call when recording starts
+     * @returns Function to unsubscribe from the event
+     */
+    onRecordingStarted(callback) {
+        return this.addEventListener('recording-started', callback);
+    }
+    /**
+     * Subscribe to recording ended events
+     * @param callback Function to call when recording ends
+     * @returns Function to unsubscribe from the event
+     */
+    onRecordingEnded(callback) {
+        return this.addEventListener('recording-ended', callback);
+    }
+    /**
+     * Subscribe to meeting closed events
+     * @param callback Function to call when meeting closes
+     * @returns Function to unsubscribe from the event
+     */
+    onMeetingClosed(callback) {
+        return this.addEventListener('meeting-closed', callback);
+    }
+    /**
+     * Subscribe to permissions granted events
+     * @param callback Function to call when permissions are granted
+     * @returns Function to unsubscribe from the event
+     */
+    onPermissionsGranted(callback) {
+        return this.addEventListener('permissions-granted', callback);
+    }
+}
+// Create and export a default instance
+const recallDesktop = new RecallDesktopClient();
+
+exports.RecallDesktopClient = RecallDesktopClient;
+exports.default = RecallDesktopClient;
+exports.recallDesktop = recallDesktop;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/preload.d.ts

@@ -0,0 +1,151 @@
+// Generated by dts-bundle-generator v8.1.2
+
+export interface RecallSdkConfig {
+	enabled: boolean;
+	apiUrl: string;
+	requestPermissionsOnStartup: boolean;
+}
+export type RecallSdkEventType = "recording-started" | "recording-ended" | "upload-progress" | "meeting-detected" | "meeting-updated" | "meeting-closed" | "sdk-state-change" | "error" | "media-capture-status" | "participant-capture-status" | "permissions-granted" | "permission-status" | "realtime-event" | "shutdown";
+export type PermissionType = "accessibility" | "screen-capture" | "microphone" | "system-audio";
+export interface ApiResponse<T = any> {
+	success: boolean;
+	message: string;
+	data?: T;
+}
+export interface PluginStatus {
+	initialized: boolean;
+	sdkInitialized: boolean;
+	version: string;
+	config: RecallSdkConfig;
+	sdkState?: "recording" | "idle" | "paused";
+	permissions?: {
+		accessibility: boolean;
+		screenCapture: boolean;
+		microphone: boolean;
+		systemAudio: boolean;
+	};
+}
+export interface PrepareDesktopAudioResponse {
+	windowId: string;
+}
+declare const recallDesktopApi: {
+	/**
+	 * Initialize the Recall SDK
+	 * @returns Promise resolving to initialization result
+	 */
+	initSdk(): Promise<ApiResponse>;
+	/**
+	 * Shutdown the Recall SDK
+	 * @returns Promise resolving to shutdown result
+	 */
+	shutdownSdk(): Promise<ApiResponse>;
+	/**
+	 * Get current plugin and SDK status
+	 * @returns Promise resolving to plugin status
+	 */
+	getStatus(): Promise<PluginStatus>;
+	/**
+	 * Start recording a meeting
+	 * @param windowId The meeting window ID
+	 * @param uploadToken Upload token from your backend
+	 * @returns Promise resolving to recording start result
+	 */
+	startRecording(windowId: string, uploadToken: string): Promise<ApiResponse>;
+	/**
+	 * Stop recording a meeting
+	 * @param windowId The meeting window ID
+	 * @returns Promise resolving to recording stop result
+	 */
+	stopRecording(windowId: string): Promise<ApiResponse>;
+	/**
+	 * Pause recording a meeting
+	 * @param windowId The meeting window ID
+	 * @returns Promise resolving to recording pause result
+	 */
+	pauseRecording(windowId: string): Promise<ApiResponse>;
+	/**
+	 * Resume recording a meeting
+	 * @param windowId The meeting window ID
+	 * @returns Promise resolving to recording resume result
+	 */
+	resumeRecording(windowId: string): Promise<ApiResponse>;
+	/**
+	 * Upload a completed recording
+	 * @param windowId The meeting window ID
+	 * @returns Promise resolving to upload start result
+	 */
+	uploadRecording(windowId: string): Promise<ApiResponse>;
+	/**
+	 * Prepare desktop audio recording for non-meeting audio capture
+	 * @returns Promise resolving to desktop audio preparation result
+	 */
+	prepareDesktopAudioRecording(): Promise<ApiResponse<PrepareDesktopAudioResponse>>;
+	/**
+	 * Request a specific permission from the user
+	 * @param permission The permission to request
+	 * @returns Promise resolving to permission request result
+	 */
+	requestPermission(permission: PermissionType): Promise<ApiResponse>;
+	/**
+	 * Update plugin configuration
+	 * @param config Configuration updates
+	 * @returns Promise resolving to update result
+	 */
+	setConfig(config: Partial<RecallSdkConfig>): Promise<ApiResponse>;
+	/**
+	 * Get current plugin configuration
+	 * @returns Promise resolving to current configuration
+	 */
+	getConfig(): Promise<ApiResponse<RecallSdkConfig>>;
+	/**
+	 * Subscribe to SDK events
+	 * @param eventType The type of event to listen for
+	 * @param callback Function to call when event occurs
+	 * @returns Function to unsubscribe from the event
+	 */
+	addEventListener(eventType: RecallSdkEventType, callback: (data: any) => void): () => void;
+	/**
+	 * Get plugin version
+	 * @returns Plugin version string
+	 */
+	getVersion(): string;
+	/**
+	 * Convenience method for handling meeting detection events
+	 * @param callback Function to call when a meeting is detected
+	 * @returns Function to unsubscribe from the event
+	 */
+	onMeetingDetected(callback: (meetingData: any) => void): () => void;
+	/**
+	 * Convenience method for handling recording state changes
+	 * @param callback Function to call when recording state changes
+	 * @returns Function to unsubscribe from the event
+	 */
+	onRecordingStateChange(callback: (stateData: any) => void): () => void;
+	/**
+	 * Convenience method for handling upload progress updates
+	 * @param callback Function to call when upload progress updates
+	 * @returns Function to unsubscribe from the event
+	 */
+	onUploadProgress(callback: (progressData: any) => void): () => void;
+	/**
+	 * Convenience method for handling permission status updates
+	 * @param callback Function to call when permission status changes
+	 * @returns Function to unsubscribe from the event
+	 */
+	onPermissionStatusChange(callback: (permissionData: any) => void): () => void;
+	/**
+	 * Convenience method for handling SDK errors
+	 * @param callback Function to call when SDK errors occur
+	 * @returns Function to unsubscribe from the event
+	 */
+	onError(callback: (errorData: any) => void): () => void;
+	/**
+	 * Convenience method for handling real-time events (transcription, participants, etc.)
+	 * @param callback Function to call when real-time events occur
+	 * @returns Function to unsubscribe from the event
+	 */
+	onRealtimeEvent(callback: (realtimeData: any) => void): () => void;
+};
+export type RecallDesktopApi = typeof recallDesktopApi;
+
+export {};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@todesktop/client-recall",
+  "version": "1.0.1",
+  "description": "ToDesktop plugin for Recall.ai Desktop Recording SDK - Client library",
+  "private": false,
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --outDir dist --declaration && npm run copy-types",
+    "dev": "tsc --outDir dist --declaration --watch",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "copy-types": "copyfiles -f src/generated/*.d.ts dist/",
+    "release:patch": "npm version patch && npm publish",
+    "release:minor": "npm version minor && npm publish",
+    "release:major": "npm version major && npm publish"
+  },
+  "keywords": [
+    "todesktop",
+    "plugin",
+    "client",
+    "web",
+    "recall",
+    "recording",
+    "meetings",
+    "sdk"
+  ],
+  "author": "ToDesktop",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "@types/node": "20.19.2"
+  }
+}