@dialtribe/react-sdk 0.1.0-alpha.20 → 0.1.0-alpha.21

package/dist/{dialtribe-streamer-DGDbUw0Z.d.ts → dialtribe-streamer-D9ulVBVb.d.ts}

@@ -203,13 +203,33 @@ declare class WebSocketStreamer {
     private onBytesUpdate?;
     private onStateChange?;
     private onError?;
+    private canvasState;
     constructor(options: WebSocketStreamerOptions);
+    /**
+     * Calculate scaled dimensions for fitting video into canvas.
+     * @param mode - "contain" fits video inside canvas, "cover" fills canvas (cropping)
+     */
+    private calculateScaledDimensions;
+    /**
+     * Invalidate cached scaling dimensions (call when video source changes)
+     */
+    private invalidateScalingCache;
     /**
      * Validate stream key format
      * Stream keys must follow format: {tierCode}{foreignId}_{randomKey}
      * Tier codes: a (audio shared), b (audio VIP), v (video shared), w (video VIP)
      */
     private validateStreamKeyFormat;
+    /**
+     * Set up canvas-based rendering pipeline for video streams.
+     * This allows seamless camera flips by changing the video source
+     * without affecting MediaRecorder (which records from the canvas).
+     */
+    private setupCanvasRendering;
+    /**
+     * Clean up canvas rendering resources
+     */
+    private cleanupCanvasRendering;
     /**
      * Build WebSocket URL from stream key
      */
@@ -226,16 +246,20 @@ declare class WebSocketStreamer {
      * Get total bytes sent
      */
     getBytesSent(): number;
+    /**
+     * Get the current source media stream.
+     * This may change after replaceVideoTrack() is called.
+     */
+    getMediaStream(): MediaStream;
     /**
      * Get current diagnostics
      */
     private getDiagnostics;
     /**
-     * Replace the video track in the current MediaStream without stopping MediaRecorder.
-     * This avoids sending a new WebM header, which FFmpeg can't handle mid-stream.
+     * Replace the video track for camera flips.
      *
-     * IMPORTANT: This is the preferred method for camera flips as it maintains
-     * continuous WebM stream without container restarts.
+     * When using canvas-based rendering (video streams), this updates the video
+     * element source. The canvas continues drawing, and MediaRecorder is unaffected.
      *
      * @param newVideoTrack - The new video track from the flipped camera
      */
@@ -247,46 +271,12 @@ declare class WebSocketStreamer {
      */
     replaceAudioTrack(newAudioTrack: MediaStreamTrack): void;
     /**
-     * Prepare for a hot-swap by stopping the MediaRecorder
-     * Call this BEFORE requesting a new camera stream on iOS
-     * This prevents iOS Safari from interfering with the active MediaRecorder
-     *
-     * IMPORTANT: This is async because we must wait for the MediaRecorder's 'stop'
-     * event to fire BEFORE proceeding. Otherwise there's a race condition where
-     * the stop event fires after isHotSwapping is set to false, causing the
-     * WebSocket to close unexpectedly.
-     *
-     * @deprecated Prefer replaceVideoTrack() which doesn't restart MediaRecorder
-     */
-    prepareForHotSwap(): Promise<void>;
-    /**
-     * Cancel a prepared hot-swap (e.g., if camera switch failed)
-     * Restarts the MediaRecorder with the existing stream
-     *
-     * @deprecated Prefer replaceVideoTrack() which doesn't restart MediaRecorder
-     */
-    cancelHotSwap(): void;
-    /**
-     * Complete the hot-swap with a new media stream
-     * Call this AFTER successfully obtaining a new camera stream
-     *
-     * Note: Errors are thrown to the caller, not sent to onError callback
-     * This allows the caller to handle camera flip failures gracefully
-     *
-     * @deprecated Prefer replaceVideoTrack() which doesn't restart MediaRecorder
-     */
-    completeHotSwap(newMediaStream: MediaStream): void;
-    /**
-     * Update the media stream (e.g., when flipping camera)
-     * This keeps the WebSocket connection alive while swapping the media source
-     *
-     * Note: On iOS, prefer using prepareForHotSwap() + completeHotSwap() to avoid
-     * issues where getUserMedia interferes with the active MediaRecorder.
-     *
-     * Note: Errors are thrown to the caller, not sent to onError callback
-     * This allows the caller to handle camera flip failures gracefully
+     * Update the media stream (e.g., when switching devices from settings)
+     * This keeps the WebSocket connection alive while swapping the media source.
+     * Restarts the MediaRecorder with the new stream.
      *
-     * @deprecated Prefer replaceVideoTrack() which doesn't restart MediaRecorder
+     * Note: For camera flips, prefer replaceVideoTrack() which doesn't restart MediaRecorder.
+     * Note: Errors are thrown to the caller, not sent to onError callback.
      */
     updateMediaStream(newMediaStream: MediaStream): Promise<void>;
     /**

package/dist/{dialtribe-streamer-DHr_bgtO.d.mts → dialtribe-streamer-DH23BseY.d.mts}

@@ -203,13 +203,33 @@ declare class WebSocketStreamer {
     private onBytesUpdate?;
     private onStateChange?;
     private onError?;
+    private canvasState;
     constructor(options: WebSocketStreamerOptions);
+    /**
+     * Calculate scaled dimensions for fitting video into canvas.
+     * @param mode - "contain" fits video inside canvas, "cover" fills canvas (cropping)
+     */
+    private calculateScaledDimensions;
+    /**
+     * Invalidate cached scaling dimensions (call when video source changes)
+     */
+    private invalidateScalingCache;
     /**
      * Validate stream key format
      * Stream keys must follow format: {tierCode}{foreignId}_{randomKey}
      * Tier codes: a (audio shared), b (audio VIP), v (video shared), w (video VIP)
      */
     private validateStreamKeyFormat;
+    /**
+     * Set up canvas-based rendering pipeline for video streams.
+     * This allows seamless camera flips by changing the video source
+     * without affecting MediaRecorder (which records from the canvas).
+     */
+    private setupCanvasRendering;
+    /**
+     * Clean up canvas rendering resources
+     */
+    private cleanupCanvasRendering;
     /**
      * Build WebSocket URL from stream key
      */
@@ -226,16 +246,20 @@ declare class WebSocketStreamer {
      * Get total bytes sent
      */
     getBytesSent(): number;
+    /**
+     * Get the current source media stream.
+     * This may change after replaceVideoTrack() is called.
+     */
+    getMediaStream(): MediaStream;
     /**
      * Get current diagnostics
      */
     private getDiagnostics;
     /**
-     * Replace the video track in the current MediaStream without stopping MediaRecorder.
-     * This avoids sending a new WebM header, which FFmpeg can't handle mid-stream.
+     * Replace the video track for camera flips.
      *
-     * IMPORTANT: This is the preferred method for camera flips as it maintains
-     * continuous WebM stream without container restarts.
+     * When using canvas-based rendering (video streams), this updates the video
+     * element source. The canvas continues drawing, and MediaRecorder is unaffected.
      *
      * @param newVideoTrack - The new video track from the flipped camera
      */
@@ -247,46 +271,12 @@ declare class WebSocketStreamer {
      */
     replaceAudioTrack(newAudioTrack: MediaStreamTrack): void;
     /**
-     * Prepare for a hot-swap by stopping the MediaRecorder
-     * Call this BEFORE requesting a new camera stream on iOS
-     * This prevents iOS Safari from interfering with the active MediaRecorder
-     *
-     * IMPORTANT: This is async because we must wait for the MediaRecorder's 'stop'
-     * event to fire BEFORE proceeding. Otherwise there's a race condition where
-     * the stop event fires after isHotSwapping is set to false, causing the
-     * WebSocket to close unexpectedly.
-     *
-     * @deprecated Prefer replaceVideoTrack() which doesn't restart MediaRecorder
-     */
-    prepareForHotSwap(): Promise<void>;
-    /**
-     * Cancel a prepared hot-swap (e.g., if camera switch failed)
-     * Restarts the MediaRecorder with the existing stream
-     *
-     * @deprecated Prefer replaceVideoTrack() which doesn't restart MediaRecorder
-     */
-    cancelHotSwap(): void;
-    /**
-     * Complete the hot-swap with a new media stream
-     * Call this AFTER successfully obtaining a new camera stream
-     *
-     * Note: Errors are thrown to the caller, not sent to onError callback
-     * This allows the caller to handle camera flip failures gracefully
-     *
-     * @deprecated Prefer replaceVideoTrack() which doesn't restart MediaRecorder
-     */
-    completeHotSwap(newMediaStream: MediaStream): void;
-    /**
-     * Update the media stream (e.g., when flipping camera)
-     * This keeps the WebSocket connection alive while swapping the media source
-     *
-     * Note: On iOS, prefer using prepareForHotSwap() + completeHotSwap() to avoid
-     * issues where getUserMedia interferes with the active MediaRecorder.
-     *
-     * Note: Errors are thrown to the caller, not sent to onError callback
-     * This allows the caller to handle camera flip failures gracefully
+     * Update the media stream (e.g., when switching devices from settings)
+     * This keeps the WebSocket connection alive while swapping the media source.
+     * Restarts the MediaRecorder with the new stream.
      *
-     * @deprecated Prefer replaceVideoTrack() which doesn't restart MediaRecorder
+     * Note: For camera flips, prefer replaceVideoTrack() which doesn't restart MediaRecorder.
+     * Note: Errors are thrown to the caller, not sent to onError callback.
      */
     updateMediaStream(newMediaStream: MediaStream): Promise<void>;
     /**

package/dist/dialtribe-streamer.d.mts

@@ -1,4 +1,4 @@
 export { A as ApiClientConfig, h as AudioWaveform, B as Broadcast, C as CDN_DOMAIN, d as DIALTRIBE_API_BASE, c as DialtribeClient, a as DialtribeContextValue, i as DialtribeOverlay, k as DialtribeOverlayMode, j as DialtribeOverlayProps, e as DialtribePlayer, g as DialtribePlayerErrorBoundary, f as DialtribePlayerProps, D as DialtribeProvider, b as DialtribeProviderProps, E as ENDPOINTS, H as HTTP_STATUS, q as HttpStatusCode, L as LoadingSpinner, m as TranscriptData, l as TranscriptSegment, T as TranscriptWord, o as buildBroadcastCdnUrl, p as buildBroadcastS3KeyPrefix, n as formatTime, u as useDialtribe, r as useDialtribeOptional } from './dialtribe-player-CNriUtNi.mjs';
-export { j as DEFAULT_ENCODER_SERVER_URL, D as DialtribeStreamer, a as DialtribeStreamerProps, M as MediaConstraintsOptions, O as OpenDialtribeStreamerPopupOptions, P as PopupDimensions, w as PopupFallbackMode, f as StreamKeyDisplay, g as StreamKeyDisplayProps, h as StreamKeyInput, i as StreamKeyInputProps, e as StreamingControlState, c as StreamingControls, d as StreamingControlsProps, S as StreamingPreview, b as StreamingPreviewProps, t as UseDialtribeStreamerLauncherOptions, v as UseDialtribeStreamerLauncherReturn, U as UseDialtribeStreamerPopupReturn, W as WebSocketStreamer, k as WebSocketStreamerOptions, r as calculatePopupDimensions, o as checkBrowserCompatibility, m as getMediaConstraints, n as getMediaRecorderOptions, q as openBroadcastPopup, p as openDialtribeStreamerPopup, s as useDialtribeStreamerLauncher, u as useDialtribeStreamerPopup } from './dialtribe-streamer-DHr_bgtO.mjs';
+export { j as DEFAULT_ENCODER_SERVER_URL, D as DialtribeStreamer, a as DialtribeStreamerProps, M as MediaConstraintsOptions, O as OpenDialtribeStreamerPopupOptions, P as PopupDimensions, w as PopupFallbackMode, f as StreamKeyDisplay, g as StreamKeyDisplayProps, h as StreamKeyInput, i as StreamKeyInputProps, e as StreamingControlState, c as StreamingControls, d as StreamingControlsProps, S as StreamingPreview, b as StreamingPreviewProps, t as UseDialtribeStreamerLauncherOptions, v as UseDialtribeStreamerLauncherReturn, U as UseDialtribeStreamerPopupReturn, W as WebSocketStreamer, k as WebSocketStreamerOptions, r as calculatePopupDimensions, o as checkBrowserCompatibility, m as getMediaConstraints, n as getMediaRecorderOptions, q as openBroadcastPopup, p as openDialtribeStreamerPopup, s as useDialtribeStreamerLauncher, u as useDialtribeStreamerPopup } from './dialtribe-streamer-DH23BseY.mjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/dialtribe-streamer.d.ts

@@ -1,4 +1,4 @@
 export { A as ApiClientConfig, h as AudioWaveform, B as Broadcast, C as CDN_DOMAIN, d as DIALTRIBE_API_BASE, c as DialtribeClient, a as DialtribeContextValue, i as DialtribeOverlay, k as DialtribeOverlayMode, j as DialtribeOverlayProps, e as DialtribePlayer, g as DialtribePlayerErrorBoundary, f as DialtribePlayerProps, D as DialtribeProvider, b as DialtribeProviderProps, E as ENDPOINTS, H as HTTP_STATUS, q as HttpStatusCode, L as LoadingSpinner, m as TranscriptData, l as TranscriptSegment, T as TranscriptWord, o as buildBroadcastCdnUrl, p as buildBroadcastS3KeyPrefix, n as formatTime, u as useDialtribe, r as useDialtribeOptional } from './dialtribe-player-CNriUtNi.js';
-export { j as DEFAULT_ENCODER_SERVER_URL, D as DialtribeStreamer, a as DialtribeStreamerProps, M as MediaConstraintsOptions, O as OpenDialtribeStreamerPopupOptions, P as PopupDimensions, w as PopupFallbackMode, f as StreamKeyDisplay, g as StreamKeyDisplayProps, h as StreamKeyInput, i as StreamKeyInputProps, e as StreamingControlState, c as StreamingControls, d as StreamingControlsProps, S as StreamingPreview, b as StreamingPreviewProps, t as UseDialtribeStreamerLauncherOptions, v as UseDialtribeStreamerLauncherReturn, U as UseDialtribeStreamerPopupReturn, W as WebSocketStreamer, k as WebSocketStreamerOptions, r as calculatePopupDimensions, o as checkBrowserCompatibility, m as getMediaConstraints, n as getMediaRecorderOptions, q as openBroadcastPopup, p as openDialtribeStreamerPopup, s as useDialtribeStreamerLauncher, u as useDialtribeStreamerPopup } from './dialtribe-streamer-DGDbUw0Z.js';
+export { j as DEFAULT_ENCODER_SERVER_URL, D as DialtribeStreamer, a as DialtribeStreamerProps, M as MediaConstraintsOptions, O as OpenDialtribeStreamerPopupOptions, P as PopupDimensions, w as PopupFallbackMode, f as StreamKeyDisplay, g as StreamKeyDisplayProps, h as StreamKeyInput, i as StreamKeyInputProps, e as StreamingControlState, c as StreamingControls, d as StreamingControlsProps, S as StreamingPreview, b as StreamingPreviewProps, t as UseDialtribeStreamerLauncherOptions, v as UseDialtribeStreamerLauncherReturn, U as UseDialtribeStreamerPopupReturn, W as WebSocketStreamer, k as WebSocketStreamerOptions, r as calculatePopupDimensions, o as checkBrowserCompatibility, m as getMediaConstraints, n as getMediaRecorderOptions, q as openBroadcastPopup, p as openDialtribeStreamerPopup, s as useDialtribeStreamerLauncher, u as useDialtribeStreamerPopup } from './dialtribe-streamer-D9ulVBVb.js';
 import 'react/jsx-runtime';
 import 'react';