@dialtribe/react-sdk 0.1.0-alpha.11 → 0.1.0-alpha.14

package/dist/{broadcast-streamer.d.ts → dialtribe-streamer.d.mts}

@@ -1,34 +1,34 @@
-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-DnnXgWin.js';
+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';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { RefObject } from 'react';
+import React$1, { RefObject } from 'react';
 
 /**
- * Props for the BroadcastStreamer component.
+ * Props for the DialtribeStreamer component.
  *
  * @example
  * ```tsx
- * // Inside DialTribeProvider (recommended)
- * <DialTribeProvider sessionToken={token}>
- *   <BroadcastStreamer
+ * // Inside DialtribeProvider (recommended)
+ * <DialtribeProvider sessionToken={token}>
+ *   <DialtribeStreamer
  *     streamKey={keyFromBackend}
  *     onDone={() => window.close()}
  *   />
- * </DialTribeProvider>
+ * </DialtribeProvider>
  *
  * // Standalone (e.g., popup window)
- * <BroadcastStreamer
+ * <DialtribeStreamer
  *   sessionToken={token}
  *   streamKey={keyFromBackend}
  *   onDone={() => window.close()}
  * />
  * ```
  */
-interface BroadcastStreamerProps {
+interface DialtribeStreamerProps {
     /**
      * Session token for API authentication.
      *
      * Required for permission checks. Can be provided via:
-     * 1. DialTribeProvider context (recommended for main app)
+     * 1. DialtribeProvider context (recommended for main app)
      * 2. This prop (required for popup windows)
      *
      * Must include `broadcasts:stream` permission.
@@ -59,7 +59,7 @@ interface BroadcastStreamerProps {
      */
     onStreamKeyChange?: (key: string) => void;
     /**
-     * Custom encoder server URL. Defaults to DialTribe's production encoder.
+     * Custom encoder server URL. Defaults to Dialtribe's production encoder.
      * Only change this for self-hosted encoder deployments.
      *
      * @default "https://broadcastapi.dialtribe.com"
@@ -80,7 +80,7 @@ interface BroadcastStreamerProps {
      */
     inline?: boolean;
 }
-declare function BroadcastStreamer({ sessionToken: propSessionToken, streamKey: initialStreamKey, onDone, onStreamKeyChange, encoderServerUrl, apiBaseUrl, inline, }: BroadcastStreamerProps): react_jsx_runtime.JSX.Element;
+declare function DialtribeStreamer({ sessionToken: propSessionToken, streamKey: initialStreamKey, onDone, onStreamKeyChange, encoderServerUrl, apiBaseUrl, inline, }: DialtribeStreamerProps): react_jsx_runtime.JSX.Element;
 
 interface StreamingPreviewProps {
     videoRef: RefObject<HTMLVideoElement>;
@@ -267,11 +267,10 @@ interface PopupDimensions {
  * - 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 {
+interface OpenDialtribeStreamerPopupOptions {
     /**
      * Session token for API authentication. **Required.**
      * The token must include `broadcasts:stream` permission.
@@ -286,21 +285,18 @@ interface OpenBroadcastStreamerPopupOptions {
      * @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'
+     * URL path for the streamer page. **Required.**
+     * This is the route in your app where the popup page is hosted.
+     *
+     * @example "/broadcasts/new"
+     * @example "/stream/live"
      */
-    mode?: BroadcastMode;
+    streamerUrl: string;
+    /** Optional app ID to include in the postMessage payload */
+    appId?: number;
     /** 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
@@ -308,23 +304,198 @@ interface OpenBroadcastStreamerPopupOptions {
  *
  * @example
  * ```tsx
- * import { openBroadcastStreamerPopup } from '@dialtribe/react-sdk/broadcast-streamer';
+ * import { openDialtribeStreamerPopup } from '@dialtribe/react-sdk/dialtribe-streamer';
  *
  * // Open popup for live streaming
- * openBroadcastStreamerPopup({
+ * openDialtribeStreamerPopup({
  *   sessionToken: 'sess_xxx...',
  *   streamKey: 'w1_abc123...',
- *   mode: 'live',
+ *   streamerUrl: '/broadcasts/new',
  * });
  * ```
  *
  * @returns The popup window reference, or null if popup was blocked
  */
-declare function openBroadcastStreamerPopup(options: OpenBroadcastStreamerPopupOptions): Window | null;
+declare function openDialtribeStreamerPopup(options: OpenDialtribeStreamerPopupOptions): Window | null;
 /**
  * Legacy function name for backwards compatibility
- * @deprecated Use openBroadcastStreamerPopup instead
+ * @deprecated Use openDialtribeStreamerPopup instead
+ */
+declare const openBroadcastPopup: typeof openDialtribeStreamerPopup;
+
+/**
+ * Return value from useDialtribeStreamerPopup hook.
+ */
+interface UseDialtribeStreamerPopupReturn {
+    /**
+     * Session token received from parent window.
+     * Will be null until credentials are received via postMessage.
+     */
+    sessionToken: string | null;
+    /**
+     * Stream key received from parent window.
+     * Will be null until credentials are received via postMessage.
+     */
+    streamKey: string | null;
+    /**
+     * API base URL received from parent window.
+     * Defaults to empty string (uses SDK default).
+     */
+    apiBaseUrl: string;
+    /**
+     * Function to update the stream key.
+     * Pass this to DialtribeStreamer's onStreamKeyChange prop.
+     */
+    setStreamKey: React.Dispatch<React.SetStateAction<string | null>>;
+    /**
+     * True if credentials have been received from the parent window.
+     */
+    isReady: boolean;
+}
+/**
+ * Hook for popup pages that receive streaming credentials via postMessage.
+ *
+ * Use this in your popup page component to handle the postMessage communication
+ * with the parent window that opened the popup via `openDialtribeStreamerPopup()`.
+ *
+ * @example
+ * ```tsx
+ * import { DialtribeStreamer, useDialtribeStreamerPopup } from '@dialtribe/react-sdk/dialtribe-streamer';
+ *
+ * export default function BroadcastPopupPage() {
+ *   const { sessionToken, streamKey, apiBaseUrl, setStreamKey } = useDialtribeStreamerPopup();
+ *
+ *   return (
+ *     <DialtribeStreamer
+ *       sessionToken={sessionToken}
+ *       streamKey={streamKey}
+ *       apiBaseUrl={apiBaseUrl}
+ *       onDone={() => window.close()}
+ *       onStreamKeyChange={setStreamKey}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+declare function useDialtribeStreamerPopup(): UseDialtribeStreamerPopupReturn;
+
+/**
+ * Fallback behavior when popup is blocked by the browser.
+ */
+type PopupFallbackMode = 'fullscreen' | 'newTab' | 'none';
+/**
+ * Options for the useDialtribeStreamerLauncher hook.
+ */
+interface UseDialtribeStreamerLauncherOptions {
+    /**
+     * Session token for API authentication.
+     */
+    sessionToken: string | null;
+    /**
+     * Stream key for broadcasting.
+     */
+    streamKey: string;
+    /**
+     * URL path for the streamer page (e.g., '/broadcasts/new').
+     */
+    streamerUrl: string;
+    /**
+     * API base URL for the streamer.
+     */
+    apiBaseUrl?: string;
+    /**
+     * What to do if the popup is blocked by the browser.
+     * - 'fullscreen': Show a fullscreen overlay in the current page
+     * - 'newTab': Open in a new browser tab (less likely to be blocked)
+     * - 'none': Do nothing, let the caller handle it
+     *
+     * @default 'fullscreen'
+     */
+    fallback?: PopupFallbackMode;
+    /**
+     * Callback when popup is blocked (called regardless of fallback mode).
+     */
+    onPopupBlocked?: () => void;
+    /**
+     * Callback when streaming ends (from fullscreen fallback mode).
+     */
+    onDone?: () => void;
+    /**
+     * Callback when stream key changes (from fallback streamer).
+     */
+    onStreamKeyChange?: (key: string) => void;
+}
+/**
+ * Return value from useDialtribeStreamerLauncher hook.
+ */
+interface UseDialtribeStreamerLauncherReturn {
+    /**
+     * Launch the streamer. Tries popup first, falls back if blocked.
+     */
+    launch: () => void;
+    /**
+     * Portal component that renders the fallback overlay.
+     * Include this once in your JSX - it renders via portal to document.body.
+     *
+     * @example
+     * ```tsx
+     * const { launch, Fallback } = useDialtribeStreamerLauncher({...});
+     * return (
+     *   <>
+     *     <button onClick={launch}>Start</button>
+     *     <Fallback />
+     *   </>
+     * );
+     * ```
+     */
+    Fallback: React$1.FC;
+    /**
+     * Whether the fallback fullscreen overlay is currently shown.
+     * Use this for custom fallback rendering.
+     */
+    showFallback: boolean;
+    /**
+     * Close the fallback overlay.
+     * Use this for custom fallback rendering.
+     */
+    closeFallback: () => void;
+    /**
+     * Reference to the popup window (if successfully opened).
+     */
+    popupRef: Window | null;
+    /**
+     * Whether the last launch attempt was blocked.
+     */
+    wasBlocked: boolean;
+}
+/**
+ * Hook for launching the DialtribeStreamer with automatic popup fallback.
+ *
+ * This hook tries to open the streamer in a popup window first. If the popup
+ * is blocked by the browser, it automatically falls back to a fullscreen
+ * overlay or new tab (configurable).
+ *
+ * @example
+ * ```tsx
+ * import { useDialtribeStreamerLauncher } from '@dialtribe/react-sdk/dialtribe-streamer';
+ *
+ * function StreamButton({ sessionToken, streamKey }: Props) {
+ *   const { launch, Fallback } = useDialtribeStreamerLauncher({
+ *     sessionToken,
+ *     streamKey,
+ *     streamerUrl: '/broadcasts/new',
+ *     fallback: 'fullscreen',
+ *   });
+ *
+ *   return (
+ *     <>
+ *       <button onClick={launch}>Start Streaming</button>
+ *       <Fallback />
+ *     </>
+ *   );
+ * }
+ * ```
  */
-declare const openBroadcastPopup: typeof openBroadcastStreamerPopup;
+declare function useDialtribeStreamerLauncher(options: UseDialtribeStreamerLauncherOptions): UseDialtribeStreamerLauncherReturn;
 
-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 };
+export { DEFAULT_ENCODER_SERVER_URL, DialtribeStreamer, type DialtribeStreamerProps, type MediaConstraintsOptions, type OpenDialtribeStreamerPopupOptions, type PopupDimensions, type PopupFallbackMode, StreamKeyDisplay, type StreamKeyDisplayProps, StreamKeyInput, type StreamKeyInputProps, type StreamingControlState, StreamingControls, type StreamingControlsProps, StreamingPreview, type StreamingPreviewProps, type UseDialtribeStreamerLauncherOptions, type UseDialtribeStreamerLauncherReturn, type UseDialtribeStreamerPopupReturn, WebSocketStreamer, type WebSocketStreamerOptions, calculatePopupDimensions, checkBrowserCompatibility, getMediaConstraints, getMediaRecorderOptions, openBroadcastPopup, openDialtribeStreamerPopup, useDialtribeStreamerLauncher, useDialtribeStreamerPopup };

package/dist/{broadcast-streamer.d.mts → dialtribe-streamer.d.ts}

@@ -1,34 +1,34 @@
-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-DnnXgWin.mjs';
+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';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { RefObject } from 'react';
+import React$1, { RefObject } from 'react';
 
 /**
- * Props for the BroadcastStreamer component.
+ * Props for the DialtribeStreamer component.
  *
  * @example
  * ```tsx
- * // Inside DialTribeProvider (recommended)
- * <DialTribeProvider sessionToken={token}>
- *   <BroadcastStreamer
+ * // Inside DialtribeProvider (recommended)
+ * <DialtribeProvider sessionToken={token}>
+ *   <DialtribeStreamer
  *     streamKey={keyFromBackend}
  *     onDone={() => window.close()}
  *   />
- * </DialTribeProvider>
+ * </DialtribeProvider>
  *
  * // Standalone (e.g., popup window)
- * <BroadcastStreamer
+ * <DialtribeStreamer
  *   sessionToken={token}
  *   streamKey={keyFromBackend}
  *   onDone={() => window.close()}
  * />
  * ```
  */
-interface BroadcastStreamerProps {
+interface DialtribeStreamerProps {
     /**
      * Session token for API authentication.
      *
      * Required for permission checks. Can be provided via:
-     * 1. DialTribeProvider context (recommended for main app)
+     * 1. DialtribeProvider context (recommended for main app)
      * 2. This prop (required for popup windows)
      *
      * Must include `broadcasts:stream` permission.
@@ -59,7 +59,7 @@ interface BroadcastStreamerProps {
      */
     onStreamKeyChange?: (key: string) => void;
     /**
-     * Custom encoder server URL. Defaults to DialTribe's production encoder.
+     * Custom encoder server URL. Defaults to Dialtribe's production encoder.
      * Only change this for self-hosted encoder deployments.
      *
      * @default "https://broadcastapi.dialtribe.com"
@@ -80,7 +80,7 @@ interface BroadcastStreamerProps {
      */
     inline?: boolean;
 }
-declare function BroadcastStreamer({ sessionToken: propSessionToken, streamKey: initialStreamKey, onDone, onStreamKeyChange, encoderServerUrl, apiBaseUrl, inline, }: BroadcastStreamerProps): react_jsx_runtime.JSX.Element;
+declare function DialtribeStreamer({ sessionToken: propSessionToken, streamKey: initialStreamKey, onDone, onStreamKeyChange, encoderServerUrl, apiBaseUrl, inline, }: DialtribeStreamerProps): react_jsx_runtime.JSX.Element;
 
 interface StreamingPreviewProps {
     videoRef: RefObject<HTMLVideoElement>;
@@ -267,11 +267,10 @@ interface PopupDimensions {
  * - 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 {
+interface OpenDialtribeStreamerPopupOptions {
     /**
      * Session token for API authentication. **Required.**
      * The token must include `broadcasts:stream` permission.
@@ -286,21 +285,18 @@ interface OpenBroadcastStreamerPopupOptions {
      * @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'
+     * URL path for the streamer page. **Required.**
+     * This is the route in your app where the popup page is hosted.
+     *
+     * @example "/broadcasts/new"
+     * @example "/stream/live"
      */
-    mode?: BroadcastMode;
+    streamerUrl: string;
+    /** Optional app ID to include in the postMessage payload */
+    appId?: number;
     /** 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
@@ -308,23 +304,198 @@ interface OpenBroadcastStreamerPopupOptions {
  *
  * @example
  * ```tsx
- * import { openBroadcastStreamerPopup } from '@dialtribe/react-sdk/broadcast-streamer';
+ * import { openDialtribeStreamerPopup } from '@dialtribe/react-sdk/dialtribe-streamer';
  *
  * // Open popup for live streaming
- * openBroadcastStreamerPopup({
+ * openDialtribeStreamerPopup({
  *   sessionToken: 'sess_xxx...',
  *   streamKey: 'w1_abc123...',
- *   mode: 'live',
+ *   streamerUrl: '/broadcasts/new',
  * });
  * ```
  *
  * @returns The popup window reference, or null if popup was blocked
  */
-declare function openBroadcastStreamerPopup(options: OpenBroadcastStreamerPopupOptions): Window | null;
+declare function openDialtribeStreamerPopup(options: OpenDialtribeStreamerPopupOptions): Window | null;
 /**
  * Legacy function name for backwards compatibility
- * @deprecated Use openBroadcastStreamerPopup instead
+ * @deprecated Use openDialtribeStreamerPopup instead
+ */
+declare const openBroadcastPopup: typeof openDialtribeStreamerPopup;
+
+/**
+ * Return value from useDialtribeStreamerPopup hook.
+ */
+interface UseDialtribeStreamerPopupReturn {
+    /**
+     * Session token received from parent window.
+     * Will be null until credentials are received via postMessage.
+     */
+    sessionToken: string | null;
+    /**
+     * Stream key received from parent window.
+     * Will be null until credentials are received via postMessage.
+     */
+    streamKey: string | null;
+    /**
+     * API base URL received from parent window.
+     * Defaults to empty string (uses SDK default).
+     */
+    apiBaseUrl: string;
+    /**
+     * Function to update the stream key.
+     * Pass this to DialtribeStreamer's onStreamKeyChange prop.
+     */
+    setStreamKey: React.Dispatch<React.SetStateAction<string | null>>;
+    /**
+     * True if credentials have been received from the parent window.
+     */
+    isReady: boolean;
+}
+/**
+ * Hook for popup pages that receive streaming credentials via postMessage.
+ *
+ * Use this in your popup page component to handle the postMessage communication
+ * with the parent window that opened the popup via `openDialtribeStreamerPopup()`.
+ *
+ * @example
+ * ```tsx
+ * import { DialtribeStreamer, useDialtribeStreamerPopup } from '@dialtribe/react-sdk/dialtribe-streamer';
+ *
+ * export default function BroadcastPopupPage() {
+ *   const { sessionToken, streamKey, apiBaseUrl, setStreamKey } = useDialtribeStreamerPopup();
+ *
+ *   return (
+ *     <DialtribeStreamer
+ *       sessionToken={sessionToken}
+ *       streamKey={streamKey}
+ *       apiBaseUrl={apiBaseUrl}
+ *       onDone={() => window.close()}
+ *       onStreamKeyChange={setStreamKey}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+declare function useDialtribeStreamerPopup(): UseDialtribeStreamerPopupReturn;
+
+/**
+ * Fallback behavior when popup is blocked by the browser.
+ */
+type PopupFallbackMode = 'fullscreen' | 'newTab' | 'none';
+/**
+ * Options for the useDialtribeStreamerLauncher hook.
+ */
+interface UseDialtribeStreamerLauncherOptions {
+    /**
+     * Session token for API authentication.
+     */
+    sessionToken: string | null;
+    /**
+     * Stream key for broadcasting.
+     */
+    streamKey: string;
+    /**
+     * URL path for the streamer page (e.g., '/broadcasts/new').
+     */
+    streamerUrl: string;
+    /**
+     * API base URL for the streamer.
+     */
+    apiBaseUrl?: string;
+    /**
+     * What to do if the popup is blocked by the browser.
+     * - 'fullscreen': Show a fullscreen overlay in the current page
+     * - 'newTab': Open in a new browser tab (less likely to be blocked)
+     * - 'none': Do nothing, let the caller handle it
+     *
+     * @default 'fullscreen'
+     */
+    fallback?: PopupFallbackMode;
+    /**
+     * Callback when popup is blocked (called regardless of fallback mode).
+     */
+    onPopupBlocked?: () => void;
+    /**
+     * Callback when streaming ends (from fullscreen fallback mode).
+     */
+    onDone?: () => void;
+    /**
+     * Callback when stream key changes (from fallback streamer).
+     */
+    onStreamKeyChange?: (key: string) => void;
+}
+/**
+ * Return value from useDialtribeStreamerLauncher hook.
+ */
+interface UseDialtribeStreamerLauncherReturn {
+    /**
+     * Launch the streamer. Tries popup first, falls back if blocked.
+     */
+    launch: () => void;
+    /**
+     * Portal component that renders the fallback overlay.
+     * Include this once in your JSX - it renders via portal to document.body.
+     *
+     * @example
+     * ```tsx
+     * const { launch, Fallback } = useDialtribeStreamerLauncher({...});
+     * return (
+     *   <>
+     *     <button onClick={launch}>Start</button>
+     *     <Fallback />
+     *   </>
+     * );
+     * ```
+     */
+    Fallback: React$1.FC;
+    /**
+     * Whether the fallback fullscreen overlay is currently shown.
+     * Use this for custom fallback rendering.
+     */
+    showFallback: boolean;
+    /**
+     * Close the fallback overlay.
+     * Use this for custom fallback rendering.
+     */
+    closeFallback: () => void;
+    /**
+     * Reference to the popup window (if successfully opened).
+     */
+    popupRef: Window | null;
+    /**
+     * Whether the last launch attempt was blocked.
+     */
+    wasBlocked: boolean;
+}
+/**
+ * Hook for launching the DialtribeStreamer with automatic popup fallback.
+ *
+ * This hook tries to open the streamer in a popup window first. If the popup
+ * is blocked by the browser, it automatically falls back to a fullscreen
+ * overlay or new tab (configurable).
+ *
+ * @example
+ * ```tsx
+ * import { useDialtribeStreamerLauncher } from '@dialtribe/react-sdk/dialtribe-streamer';
+ *
+ * function StreamButton({ sessionToken, streamKey }: Props) {
+ *   const { launch, Fallback } = useDialtribeStreamerLauncher({
+ *     sessionToken,
+ *     streamKey,
+ *     streamerUrl: '/broadcasts/new',
+ *     fallback: 'fullscreen',
+ *   });
+ *
+ *   return (
+ *     <>
+ *       <button onClick={launch}>Start Streaming</button>
+ *       <Fallback />
+ *     </>
+ *   );
+ * }
+ * ```
  */
-declare const openBroadcastPopup: typeof openBroadcastStreamerPopup;
+declare function useDialtribeStreamerLauncher(options: UseDialtribeStreamerLauncherOptions): UseDialtribeStreamerLauncherReturn;
 
-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 };
+export { DEFAULT_ENCODER_SERVER_URL, DialtribeStreamer, type DialtribeStreamerProps, type MediaConstraintsOptions, type OpenDialtribeStreamerPopupOptions, type PopupDimensions, type PopupFallbackMode, StreamKeyDisplay, type StreamKeyDisplayProps, StreamKeyInput, type StreamKeyInputProps, type StreamingControlState, StreamingControls, type StreamingControlsProps, StreamingPreview, type StreamingPreviewProps, type UseDialtribeStreamerLauncherOptions, type UseDialtribeStreamerLauncherReturn, type UseDialtribeStreamerPopupReturn, WebSocketStreamer, type WebSocketStreamerOptions, calculatePopupDimensions, checkBrowserCompatibility, getMediaConstraints, getMediaRecorderOptions, openBroadcastPopup, openDialtribeStreamerPopup, useDialtribeStreamerLauncher, useDialtribeStreamerPopup };