@dialtribe/react-sdk 0.1.0-alpha.10

package/dist/broadcast-streamer.d.mts

@@ -0,0 +1,330 @@
+export { A as ApiClientConfig, i as AudioWaveform, j as Broadcast, B as BroadcastPlayer, h as BroadcastPlayerErrorBoundary, f as BroadcastPlayerModal, g as BroadcastPlayerModalProps, e as BroadcastPlayerProps, C as CDN_DOMAIN, d as DIALTRIBE_API_BASE, c as DialTribeClient, a as DialTribeContextValue, D as DialTribeProvider, b as DialTribeProviderProps, E as ENDPOINTS, H as HTTP_STATUS, p as HttpStatusCode, L as LoadingSpinner, l as TranscriptData, k as TranscriptSegment, T as TranscriptWord, n as buildBroadcastCdnUrl, o as buildBroadcastS3KeyPrefix, m as formatTime, u as useDialTribe, q as useDialTribeOptional } from './broadcast-player-CEAnuf6t.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { RefObject } from 'react';
+
+/**
+ * Props for the BroadcastStreamer component.
+ *
+ * @example
+ * ```tsx
+ * // Inside DialTribeProvider (recommended)
+ * <DialTribeProvider sessionToken={token}>
+ *   <BroadcastStreamer
+ *     streamKey={keyFromBackend}
+ *     onDone={() => window.close()}
+ *   />
+ * </DialTribeProvider>
+ *
+ * // Standalone (e.g., popup window)
+ * <BroadcastStreamer
+ *   sessionToken={token}
+ *   streamKey={keyFromBackend}
+ *   onDone={() => window.close()}
+ * />
+ * ```
+ */
+interface BroadcastStreamerProps {
+    /**
+     * Session token for API authentication.
+     *
+     * Required for permission checks. Can be provided via:
+     * 1. DialTribeProvider context (recommended for main app)
+     * 2. This prop (required for popup windows)
+     *
+     * Must include `broadcasts:stream` permission.
+     */
+    sessionToken?: string;
+    /**
+     * Stream key for broadcasting.
+     *
+     * **Production apps should always provide this from their backend.**
+     * The stream key authenticates the broadcaster with the encoder server.
+     *
+     * If omitted, a manual input form is shown. This is intended for
+     * development/testing only - end users should never see or handle stream keys.
+     *
+     * @example "w1_abc123def456..."
+     */
+    streamKey?: string;
+    /**
+     * Called when streaming ends (user stops, terminates, or clicks Done).
+     * Use this to close the popup or navigate away.
+     *
+     * @example () => window.close()
+     */
+    onDone?: () => void;
+    /**
+     * Called when the stream key changes (e.g., user edits it in preview mode).
+     * Useful for persisting the key or updating parent state.
+     */
+    onStreamKeyChange?: (key: string) => void;
+    /**
+     * Custom encoder server URL. Defaults to DialTribe's production encoder.
+     * Only change this for self-hosted encoder deployments.
+     *
+     * @default "https://broadcastapi.dialtribe.com"
+     */
+    encoderServerUrl?: string;
+    /**
+     * Custom API base URL for broadcast availability checks.
+     * Only change this for self-hosted API deployments.
+     *
+     * @default "https://dialtribe.com/api/public/v1"
+     */
+    apiBaseUrl?: string;
+    /**
+     * When true, the streamer fills its parent container instead of the viewport.
+     * Use this when embedding the streamer inline within a page.
+     *
+     * @default false
+     */
+    inline?: boolean;
+}
+declare function BroadcastStreamer({ sessionToken: propSessionToken, streamKey: initialStreamKey, onDone, onStreamKeyChange, encoderServerUrl, apiBaseUrl, inline, }: BroadcastStreamerProps): react_jsx_runtime.JSX.Element;
+
+interface StreamingPreviewProps {
+    videoRef: RefObject<HTMLVideoElement>;
+    isVideoKey: boolean;
+    isVideoEnabled: boolean;
+    mediaStream: MediaStream | null;
+    facingMode: "user" | "environment";
+}
+declare function StreamingPreview({ videoRef, isVideoKey, isVideoEnabled, mediaStream, facingMode, }: StreamingPreviewProps): react_jsx_runtime.JSX.Element;
+
+type StreamingControlState = "previewing" | "connecting" | "live" | "stopping";
+interface MediaDeviceInfo {
+    deviceId: string;
+    label: string;
+}
+interface StreamingControlsProps {
+    state: StreamingControlState;
+    isVideoKey: boolean;
+    isMuted: boolean;
+    isVideoEnabled: boolean;
+    facingMode: "user" | "environment";
+    hasMultipleCameras: boolean;
+    startTime: Date | null;
+    bytesSent: number;
+    showStopConfirm: boolean;
+    streamKey: string;
+    onStreamKeyChange?: (newKey: string) => void;
+    onStart: () => void;
+    onStop: () => void;
+    onConfirmStop: () => void;
+    onCancelStop: () => void;
+    onToggleMute: () => void;
+    onToggleVideo: () => void;
+    onFlipCamera: () => void;
+    onClose?: () => void;
+    showCloseConfirm?: boolean;
+    onConfirmClose?: () => void;
+    onCancelClose?: () => void;
+    videoDevices?: MediaDeviceInfo[];
+    audioDevices?: MediaDeviceInfo[];
+    selectedVideoDeviceId?: string;
+    selectedAudioDeviceId?: string;
+    onVideoDeviceChange?: (deviceId: string) => void;
+    onAudioDeviceChange?: (deviceId: string) => void;
+    mediaStream?: MediaStream | null;
+}
+declare function StreamingControls({ state, isVideoKey, isMuted, isVideoEnabled, facingMode: _facingMode, // Reserved for future use (e.g., showing camera direction)
+hasMultipleCameras, startTime, bytesSent, showStopConfirm, streamKey, onStreamKeyChange, onStart, onStop, onConfirmStop, onCancelStop, onToggleMute, onToggleVideo, onFlipCamera, onClose, showCloseConfirm, onConfirmClose, onCancelClose, videoDevices, audioDevices, selectedVideoDeviceId, selectedAudioDeviceId, onVideoDeviceChange, onAudioDeviceChange, mediaStream, }: StreamingControlsProps): react_jsx_runtime.JSX.Element;
+
+interface StreamKeyDisplayProps {
+    streamKey: string;
+    className?: string;
+    showLabel?: boolean;
+    showCopy?: boolean;
+    editable?: boolean;
+    onChange?: (newKey: string) => void;
+    size?: 'sm' | 'md' | 'lg';
+    layout?: 'vertical' | 'horizontal';
+    darkMode?: boolean;
+}
+/**
+ * Shared component for displaying stream keys with reveal/copy functionality
+ * Obscures the stream key by default, showing only first 6 and last 6 characters
+ * When revealed and editable, becomes an input field for editing
+ */
+declare function StreamKeyDisplay({ streamKey, className, showLabel, showCopy, editable, onChange, size, layout, darkMode, }: StreamKeyDisplayProps): react_jsx_runtime.JSX.Element;
+
+interface StreamKeyInputProps {
+    onSubmit: (key: string) => void;
+    /**
+     * When true, the input fills its parent container instead of the viewport.
+     * Use this when embedding inline within a page.
+     */
+    inline?: boolean;
+}
+/**
+ * Stream key input form for manual entry
+ * Validates stream key format before submission
+ */
+declare function StreamKeyInput({ onSubmit, inline }: StreamKeyInputProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * WebSocket streaming client for sending media chunks to encoder server
+ * Based on prankcast reference implementation
+ */
+/** Default encoder server URL */
+declare const DEFAULT_ENCODER_SERVER_URL = "https://broadcastapi.dialtribe.com";
+interface WebSocketStreamerOptions {
+    streamKey: string;
+    mediaStream: MediaStream;
+    isVideo: boolean;
+    /** Optional custom encoder server URL (defaults to DEFAULT_ENCODER_SERVER_URL) */
+    encoderServerUrl?: string;
+    onBytesUpdate?: (bytes: number) => void;
+    onStateChange?: (state: "connecting" | "live" | "stopped" | "terminated" | "error") => void;
+    onError?: (error: string) => void;
+}
+declare class WebSocketStreamer {
+    private streamKey;
+    private mediaStream;
+    private isVideo;
+    private encoderServerUrl;
+    private websocket;
+    private mediaRecorder;
+    private bytesSent;
+    private userStopped;
+    private onBytesUpdate?;
+    private onStateChange?;
+    private onError?;
+    constructor(options: WebSocketStreamerOptions);
+    /**
+     * 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;
+    /**
+     * Build WebSocket URL from stream key
+     */
+    private buildWebSocketUrl;
+    /**
+     * Start streaming
+     */
+    start(): Promise<void>;
+    /**
+     * Stop streaming
+     */
+    stop(): void;
+    /**
+     * Get total bytes sent
+     */
+    getBytesSent(): number;
+    /**
+     * Update the media stream (e.g., when flipping camera)
+     * This keeps the WebSocket connection alive while swapping the media source
+     *
+     * Note: Errors are thrown to the caller, not sent to onError callback
+     * This allows the caller to handle camera flip failures gracefully
+     */
+    updateMediaStream(newMediaStream: MediaStream): Promise<void>;
+    /**
+     * Set up WebSocket event handlers
+     */
+    private setupWebSocketHandlers;
+    /**
+     * Set up MediaRecorder event handlers
+     */
+    private setupMediaRecorderHandlers;
+}
+
+/**
+ * Media constraints for browser streaming
+ * Based on prankcast reference implementation
+ */
+interface MediaConstraintsOptions {
+    isVideo: boolean;
+    facingMode?: "user" | "environment";
+}
+declare function getMediaConstraints(options: MediaConstraintsOptions): MediaStreamConstraints;
+/**
+ * MediaRecorder options for encoding
+ */
+declare function getMediaRecorderOptions(isVideo: boolean): MediaRecorderOptions;
+/**
+ * Check browser compatibility
+ */
+declare function checkBrowserCompatibility(): {
+    compatible: boolean;
+    error?: string;
+};
+
+/**
+ * Utility functions for opening broadcast streamer popup windows
+ */
+interface PopupDimensions {
+    width: number;
+    height: number;
+    left: number;
+    top: number;
+}
+/**
+ * Calculate optimal popup dimensions based on screen size
+ * - Desktop/wider screens: 16:9 landscape ratio (e.g., 1280x720) to match modern webcams
+ * - Mobile/narrower screens: 9:16 portrait ratio (e.g., 720x1280) for vertical video
+ */
+declare function calculatePopupDimensions(): PopupDimensions;
+type BroadcastMode = 'live' | 'schedule' | null;
+/**
+ * Options for opening a broadcast streamer popup window.
+ */
+interface OpenBroadcastStreamerPopupOptions {
+    /**
+     * Session token for API authentication. **Required.**
+     * The token must include `broadcasts:stream` permission.
+     * Sent securely via postMessage (not in the URL).
+     */
+    sessionToken: string;
+    /**
+     * Stream key for broadcasting. **Required for production use.**
+     * Fetch this from your backend and pass it here.
+     * The key is sent securely via postMessage (not in the URL).
+     *
+     * @example "w1_abc123def456..."
+     */
+    streamKey: string;
+    /** Optional app ID to include in the postMessage payload */
+    appId?: number;
+    /**
+     * Launch mode. Use 'live' for immediate streaming.
+     * @default 'live'
+     */
+    mode?: BroadcastMode;
+    /** Additional URL parameters to pass to the popup page */
+    additionalParams?: Record<string, string>;
+    /**
+     * Base URL for the streamer page.
+     * Only change this for custom hosting setups.
+     * @default "/broadcasts/new"
+     */
+    baseUrl?: string;
+}
+/**
+ * Open broadcast streamer popup window with credentials sent via postMessage
+ * This is more secure than passing sensitive data in the URL
+ *
+ * @example
+ * ```tsx
+ * import { openBroadcastStreamerPopup } from '@dialtribe/react-sdk/broadcast-streamer';
+ *
+ * // Open popup for live streaming
+ * openBroadcastStreamerPopup({
+ *   sessionToken: 'sess_xxx...',
+ *   streamKey: 'w1_abc123...',
+ *   mode: 'live',
+ * });
+ * ```
+ *
+ * @returns The popup window reference, or null if popup was blocked
+ */
+declare function openBroadcastStreamerPopup(options: OpenBroadcastStreamerPopupOptions): Window | null;
+/**
+ * Legacy function name for backwards compatibility
+ * @deprecated Use openBroadcastStreamerPopup instead
+ */
+declare const openBroadcastPopup: typeof openBroadcastStreamerPopup;
+
+export { type BroadcastMode, BroadcastStreamer, type BroadcastStreamerProps, DEFAULT_ENCODER_SERVER_URL, type MediaConstraintsOptions, type OpenBroadcastStreamerPopupOptions, type PopupDimensions, StreamKeyDisplay, type StreamKeyDisplayProps, StreamKeyInput, type StreamKeyInputProps, type StreamingControlState, StreamingControls, type StreamingControlsProps, StreamingPreview, type StreamingPreviewProps, WebSocketStreamer, type WebSocketStreamerOptions, calculatePopupDimensions, checkBrowserCompatibility, getMediaConstraints, getMediaRecorderOptions, openBroadcastPopup, openBroadcastStreamerPopup };

package/dist/broadcast-streamer.d.ts

@@ -0,0 +1,330 @@
+export { A as ApiClientConfig, i as AudioWaveform, j as Broadcast, B as BroadcastPlayer, h as BroadcastPlayerErrorBoundary, f as BroadcastPlayerModal, g as BroadcastPlayerModalProps, e as BroadcastPlayerProps, C as CDN_DOMAIN, d as DIALTRIBE_API_BASE, c as DialTribeClient, a as DialTribeContextValue, D as DialTribeProvider, b as DialTribeProviderProps, E as ENDPOINTS, H as HTTP_STATUS, p as HttpStatusCode, L as LoadingSpinner, l as TranscriptData, k as TranscriptSegment, T as TranscriptWord, n as buildBroadcastCdnUrl, o as buildBroadcastS3KeyPrefix, m as formatTime, u as useDialTribe, q as useDialTribeOptional } from './broadcast-player-CEAnuf6t.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { RefObject } from 'react';
+
+/**
+ * Props for the BroadcastStreamer component.
+ *
+ * @example
+ * ```tsx
+ * // Inside DialTribeProvider (recommended)
+ * <DialTribeProvider sessionToken={token}>
+ *   <BroadcastStreamer
+ *     streamKey={keyFromBackend}
+ *     onDone={() => window.close()}
+ *   />
+ * </DialTribeProvider>
+ *
+ * // Standalone (e.g., popup window)
+ * <BroadcastStreamer
+ *   sessionToken={token}
+ *   streamKey={keyFromBackend}
+ *   onDone={() => window.close()}
+ * />
+ * ```
+ */
+interface BroadcastStreamerProps {
+    /**
+     * Session token for API authentication.
+     *
+     * Required for permission checks. Can be provided via:
+     * 1. DialTribeProvider context (recommended for main app)
+     * 2. This prop (required for popup windows)
+     *
+     * Must include `broadcasts:stream` permission.
+     */
+    sessionToken?: string;
+    /**
+     * Stream key for broadcasting.
+     *
+     * **Production apps should always provide this from their backend.**
+     * The stream key authenticates the broadcaster with the encoder server.
+     *
+     * If omitted, a manual input form is shown. This is intended for
+     * development/testing only - end users should never see or handle stream keys.
+     *
+     * @example "w1_abc123def456..."
+     */
+    streamKey?: string;
+    /**
+     * Called when streaming ends (user stops, terminates, or clicks Done).
+     * Use this to close the popup or navigate away.
+     *
+     * @example () => window.close()
+     */
+    onDone?: () => void;
+    /**
+     * Called when the stream key changes (e.g., user edits it in preview mode).
+     * Useful for persisting the key or updating parent state.
+     */
+    onStreamKeyChange?: (key: string) => void;
+    /**
+     * Custom encoder server URL. Defaults to DialTribe's production encoder.
+     * Only change this for self-hosted encoder deployments.
+     *
+     * @default "https://broadcastapi.dialtribe.com"
+     */
+    encoderServerUrl?: string;
+    /**
+     * Custom API base URL for broadcast availability checks.
+     * Only change this for self-hosted API deployments.
+     *
+     * @default "https://dialtribe.com/api/public/v1"
+     */
+    apiBaseUrl?: string;
+    /**
+     * When true, the streamer fills its parent container instead of the viewport.
+     * Use this when embedding the streamer inline within a page.
+     *
+     * @default false
+     */
+    inline?: boolean;
+}
+declare function BroadcastStreamer({ sessionToken: propSessionToken, streamKey: initialStreamKey, onDone, onStreamKeyChange, encoderServerUrl, apiBaseUrl, inline, }: BroadcastStreamerProps): react_jsx_runtime.JSX.Element;
+
+interface StreamingPreviewProps {
+    videoRef: RefObject<HTMLVideoElement>;
+    isVideoKey: boolean;
+    isVideoEnabled: boolean;
+    mediaStream: MediaStream | null;
+    facingMode: "user" | "environment";
+}
+declare function StreamingPreview({ videoRef, isVideoKey, isVideoEnabled, mediaStream, facingMode, }: StreamingPreviewProps): react_jsx_runtime.JSX.Element;
+
+type StreamingControlState = "previewing" | "connecting" | "live" | "stopping";
+interface MediaDeviceInfo {
+    deviceId: string;
+    label: string;
+}
+interface StreamingControlsProps {
+    state: StreamingControlState;
+    isVideoKey: boolean;
+    isMuted: boolean;
+    isVideoEnabled: boolean;
+    facingMode: "user" | "environment";
+    hasMultipleCameras: boolean;
+    startTime: Date | null;
+    bytesSent: number;
+    showStopConfirm: boolean;
+    streamKey: string;
+    onStreamKeyChange?: (newKey: string) => void;
+    onStart: () => void;
+    onStop: () => void;
+    onConfirmStop: () => void;
+    onCancelStop: () => void;
+    onToggleMute: () => void;
+    onToggleVideo: () => void;
+    onFlipCamera: () => void;
+    onClose?: () => void;
+    showCloseConfirm?: boolean;
+    onConfirmClose?: () => void;
+    onCancelClose?: () => void;
+    videoDevices?: MediaDeviceInfo[];
+    audioDevices?: MediaDeviceInfo[];
+    selectedVideoDeviceId?: string;
+    selectedAudioDeviceId?: string;
+    onVideoDeviceChange?: (deviceId: string) => void;
+    onAudioDeviceChange?: (deviceId: string) => void;
+    mediaStream?: MediaStream | null;
+}
+declare function StreamingControls({ state, isVideoKey, isMuted, isVideoEnabled, facingMode: _facingMode, // Reserved for future use (e.g., showing camera direction)
+hasMultipleCameras, startTime, bytesSent, showStopConfirm, streamKey, onStreamKeyChange, onStart, onStop, onConfirmStop, onCancelStop, onToggleMute, onToggleVideo, onFlipCamera, onClose, showCloseConfirm, onConfirmClose, onCancelClose, videoDevices, audioDevices, selectedVideoDeviceId, selectedAudioDeviceId, onVideoDeviceChange, onAudioDeviceChange, mediaStream, }: StreamingControlsProps): react_jsx_runtime.JSX.Element;
+
+interface StreamKeyDisplayProps {
+    streamKey: string;
+    className?: string;
+    showLabel?: boolean;
+    showCopy?: boolean;
+    editable?: boolean;
+    onChange?: (newKey: string) => void;
+    size?: 'sm' | 'md' | 'lg';
+    layout?: 'vertical' | 'horizontal';
+    darkMode?: boolean;
+}
+/**
+ * Shared component for displaying stream keys with reveal/copy functionality
+ * Obscures the stream key by default, showing only first 6 and last 6 characters
+ * When revealed and editable, becomes an input field for editing
+ */
+declare function StreamKeyDisplay({ streamKey, className, showLabel, showCopy, editable, onChange, size, layout, darkMode, }: StreamKeyDisplayProps): react_jsx_runtime.JSX.Element;
+
+interface StreamKeyInputProps {
+    onSubmit: (key: string) => void;
+    /**
+     * When true, the input fills its parent container instead of the viewport.
+     * Use this when embedding inline within a page.
+     */
+    inline?: boolean;
+}
+/**
+ * Stream key input form for manual entry
+ * Validates stream key format before submission
+ */
+declare function StreamKeyInput({ onSubmit, inline }: StreamKeyInputProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * WebSocket streaming client for sending media chunks to encoder server
+ * Based on prankcast reference implementation
+ */
+/** Default encoder server URL */
+declare const DEFAULT_ENCODER_SERVER_URL = "https://broadcastapi.dialtribe.com";
+interface WebSocketStreamerOptions {
+    streamKey: string;
+    mediaStream: MediaStream;
+    isVideo: boolean;
+    /** Optional custom encoder server URL (defaults to DEFAULT_ENCODER_SERVER_URL) */
+    encoderServerUrl?: string;
+    onBytesUpdate?: (bytes: number) => void;
+    onStateChange?: (state: "connecting" | "live" | "stopped" | "terminated" | "error") => void;
+    onError?: (error: string) => void;
+}
+declare class WebSocketStreamer {
+    private streamKey;
+    private mediaStream;
+    private isVideo;
+    private encoderServerUrl;
+    private websocket;
+    private mediaRecorder;
+    private bytesSent;
+    private userStopped;
+    private onBytesUpdate?;
+    private onStateChange?;
+    private onError?;
+    constructor(options: WebSocketStreamerOptions);
+    /**
+     * 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;
+    /**
+     * Build WebSocket URL from stream key
+     */
+    private buildWebSocketUrl;
+    /**
+     * Start streaming
+     */
+    start(): Promise<void>;
+    /**
+     * Stop streaming
+     */
+    stop(): void;
+    /**
+     * Get total bytes sent
+     */
+    getBytesSent(): number;
+    /**
+     * Update the media stream (e.g., when flipping camera)
+     * This keeps the WebSocket connection alive while swapping the media source
+     *
+     * Note: Errors are thrown to the caller, not sent to onError callback
+     * This allows the caller to handle camera flip failures gracefully
+     */
+    updateMediaStream(newMediaStream: MediaStream): Promise<void>;
+    /**
+     * Set up WebSocket event handlers
+     */
+    private setupWebSocketHandlers;
+    /**
+     * Set up MediaRecorder event handlers
+     */
+    private setupMediaRecorderHandlers;
+}
+
+/**
+ * Media constraints for browser streaming
+ * Based on prankcast reference implementation
+ */
+interface MediaConstraintsOptions {
+    isVideo: boolean;
+    facingMode?: "user" | "environment";
+}
+declare function getMediaConstraints(options: MediaConstraintsOptions): MediaStreamConstraints;
+/**
+ * MediaRecorder options for encoding
+ */
+declare function getMediaRecorderOptions(isVideo: boolean): MediaRecorderOptions;
+/**
+ * Check browser compatibility
+ */
+declare function checkBrowserCompatibility(): {
+    compatible: boolean;
+    error?: string;
+};
+
+/**
+ * Utility functions for opening broadcast streamer popup windows
+ */
+interface PopupDimensions {
+    width: number;
+    height: number;
+    left: number;
+    top: number;
+}
+/**
+ * Calculate optimal popup dimensions based on screen size
+ * - Desktop/wider screens: 16:9 landscape ratio (e.g., 1280x720) to match modern webcams
+ * - Mobile/narrower screens: 9:16 portrait ratio (e.g., 720x1280) for vertical video
+ */
+declare function calculatePopupDimensions(): PopupDimensions;
+type BroadcastMode = 'live' | 'schedule' | null;
+/**
+ * Options for opening a broadcast streamer popup window.
+ */
+interface OpenBroadcastStreamerPopupOptions {
+    /**
+     * Session token for API authentication. **Required.**
+     * The token must include `broadcasts:stream` permission.
+     * Sent securely via postMessage (not in the URL).
+     */
+    sessionToken: string;
+    /**
+     * Stream key for broadcasting. **Required for production use.**
+     * Fetch this from your backend and pass it here.
+     * The key is sent securely via postMessage (not in the URL).
+     *
+     * @example "w1_abc123def456..."
+     */
+    streamKey: string;
+    /** Optional app ID to include in the postMessage payload */
+    appId?: number;
+    /**
+     * Launch mode. Use 'live' for immediate streaming.
+     * @default 'live'
+     */
+    mode?: BroadcastMode;
+    /** Additional URL parameters to pass to the popup page */
+    additionalParams?: Record<string, string>;
+    /**
+     * Base URL for the streamer page.
+     * Only change this for custom hosting setups.
+     * @default "/broadcasts/new"
+     */
+    baseUrl?: string;
+}
+/**
+ * Open broadcast streamer popup window with credentials sent via postMessage
+ * This is more secure than passing sensitive data in the URL
+ *
+ * @example
+ * ```tsx
+ * import { openBroadcastStreamerPopup } from '@dialtribe/react-sdk/broadcast-streamer';
+ *
+ * // Open popup for live streaming
+ * openBroadcastStreamerPopup({
+ *   sessionToken: 'sess_xxx...',
+ *   streamKey: 'w1_abc123...',
+ *   mode: 'live',
+ * });
+ * ```
+ *
+ * @returns The popup window reference, or null if popup was blocked
+ */
+declare function openBroadcastStreamerPopup(options: OpenBroadcastStreamerPopupOptions): Window | null;
+/**
+ * Legacy function name for backwards compatibility
+ * @deprecated Use openBroadcastStreamerPopup instead
+ */
+declare const openBroadcastPopup: typeof openBroadcastStreamerPopup;
+
+export { type BroadcastMode, BroadcastStreamer, type BroadcastStreamerProps, DEFAULT_ENCODER_SERVER_URL, type MediaConstraintsOptions, type OpenBroadcastStreamerPopupOptions, type PopupDimensions, StreamKeyDisplay, type StreamKeyDisplayProps, StreamKeyInput, type StreamKeyInputProps, type StreamingControlState, StreamingControls, type StreamingControlsProps, StreamingPreview, type StreamingPreviewProps, WebSocketStreamer, type WebSocketStreamerOptions, calculatePopupDimensions, checkBrowserCompatibility, getMediaConstraints, getMediaRecorderOptions, openBroadcastPopup, openBroadcastStreamerPopup };