Forward track toggle errors

.changeset/nine-peas-approve.md

@@ -0,0 +1,6 @@
+---
+"@livekit/components-core": patch
+"@livekit/components-react": patch
+---
+
+Forward track toggle errors

packages/core/etc/components-core.api.md

@@ -490,7 +490,7 @@ export function setupManualToggle(): {
 };
 
 // @public (undocumented)
-export function setupMediaToggle<T extends ToggleSource>(source: T, room: Room, options?: CaptureOptionsBySource<T>, publishOptions?: TrackPublishOptions): MediaToggleType<T>;
+export function setupMediaToggle<T extends ToggleSource>(source: T, room: Room, options?: CaptureOptionsBySource<T>, publishOptions?: TrackPublishOptions, onError?: (error: Error) => void): MediaToggleType<T>;
 
 // Warning: (ae-incompatible-release-tags) The symbol "setupMediaTrack" is marked as @public, but its signature references "TrackIdentifier" which is marked as @internal
 //

packages/core/src/components/mediaToggle.ts

@@ -37,6 +37,7 @@ export function setupMediaToggle<T extends ToggleSource>(
   room: Room,
   options?: CaptureOptionsBySource<T>,
   publishOptions?: TrackPublishOptions,
+  onError?: (error: Error) => void,
 ): MediaToggleType<T> {
   const { localParticipant } = room;
 
@@ -96,6 +97,12 @@ export function setupMediaToggle<T extends ToggleSource>(
         default:
           break;
       }
+    } catch (e) {
+      if (onError && e instanceof Error) {
+        onError?.(e);
+      } else {
+        throw e;
+      }
     } finally {
       pendingSubject.next(false);
       // trigger observable update

packages/react/etc/components-react.api.md

@@ -642,6 +642,8 @@ export interface TrackToggleProps<T extends ToggleSource> extends Omit<React_2.B
     initialState?: boolean;
     onChange?: (enabled: boolean, isUserInitiated: boolean) => void;
     // (undocumented)
+    onDeviceError?: (error: Error) => void;
+    // (undocumented)
     publishOptions?: TrackPublishOptions;
     // (undocumented)
     showIcon?: boolean;
@@ -1089,7 +1091,7 @@ export type UseTracksOptions = {
 };
 
 // @public
-export function useTrackToggle<T extends ToggleSource>({ source, onChange, initialState, captureOptions, publishOptions, ...rest }: UseTrackToggleProps<T>): {
+export function useTrackToggle<T extends ToggleSource>({ source, onChange, initialState, captureOptions, publishOptions, onDeviceError, ...rest }: UseTrackToggleProps<T>): {
     toggle: (forceState?: boolean | undefined, captureOptions?: CaptureOptionsBySource<T> | undefined) => Promise<void>;
     enabled: boolean;
     pending: boolean;

packages/react/src/components/controls/TrackToggle.tsx

@@ -17,6 +17,7 @@ export interface TrackToggleProps<T extends ToggleSource>
   onChange?: (enabled: boolean, isUserInitiated: boolean) => void;
   captureOptions?: CaptureOptionsBySource<T>;
   publishOptions?: TrackPublishOptions;
+  onDeviceError?: (error: Error) => void;
 }
 
 /**

packages/react/src/hooks/useTrackToggle.ts

@@ -27,6 +27,7 @@ export function useTrackToggle<T extends ToggleSource>({
   initialState,
   captureOptions,
   publishOptions,
+  onDeviceError,
   ...rest
 }: UseTrackToggleProps<T>) {
   const room = useMaybeRoomContext();
@@ -37,9 +38,9 @@ export function useTrackToggle<T extends ToggleSource>({
   const { toggle, className, pendingObserver, enabledObserver } = React.useMemo(
     () =>
       room
-        ? setupMediaToggle<T>(source, room, captureOptions, publishOptions)
+        ? setupMediaToggle<T>(source, room, captureOptions, publishOptions, onDeviceError)
         : setupManualToggle(),
-    [room, source, JSON.stringify(captureOptions), JSON.stringify(publishOptions)],
+    [room, source, JSON.stringify(captureOptions), publishOptions],
   );
 
   const pending = useObservableState(pendingObserver, false);