Add availability checks and detailed error handling for video adapters

Author: dikjain

src/adapters/ExpoAVVideoAdapter.tsx

@@ -20,13 +20,36 @@ export class ExpoAVVideoAdapter implements VideoPlayerAdapter {
     return !!(this.expoAVModule && this.expoAVModule.Video);
   }
 
+  getAvailabilityInfo(): { isAvailable: boolean; error?: string; installCommand?: string; packageName?: string } {
+    if (!this.expoAVModule) {
+      return {
+        isAvailable: false,
+        error: "ExpoAVVideoAdapter: Module not found. Please install expo-av to enable video playback functionality.",
+        installCommand: "npx expo install expo-av",
+        packageName: "expo-av"
+      };
+    }
+    
+    if (!this.expoAVModule.Video) {
+      return {
+        isAvailable: false,
+        error: "ExpoAVVideoAdapter: Video component not found in expo-av. Please ensure you have a compatible version installed.",
+        installCommand: "npx expo install expo-av",
+        packageName: "expo-av"
+      };
+    }
+    
+    return { isAvailable: true };
+  }
+
   getAdapterName(): string {
     return VideoPlayerType.EXPO_AV;
   }
 
   renderVideo(props: VideoPlayerProps, ref: RefObject<VideoPlayerRef | null>): ReactElement {
-    if (!this.isAvailable()) {
-      throw new Error('expo-av is not available');
+    const availabilityInfo = this.getAvailabilityInfo();
+    if (!availabilityInfo.isAvailable) {
+      throw new Error(`${availabilityInfo.error}\n\nTo fix this issue, run: ${availabilityInfo.installCommand}`);
     }
 
     const { Video } = this.expoAVModule;

src/adapters/ExpoVideoAdapter.tsx

@@ -25,14 +25,45 @@ export class ExpoVideoAdapter implements VideoPlayerAdapter {
     return !!(this.expoVideoModule && this.expoVideoModule.VideoView);
   }
 
+  getAvailabilityInfo(): { isAvailable: boolean; error?: string; installCommand?: string; packageName?: string } {
+    if (!this.expoVideoModule) {
+      return {
+        isAvailable: false,
+        error: "ExpoVideoAdapter: Module not found. Please install expo-video to enable video playback functionality.",
+        installCommand: "npx expo install expo-video",
+        packageName: "expo-video"
+      };
+    }
+    
+    if (!this.expoVideoModule.VideoView) {
+      return {
+        isAvailable: false,
+        error: "ExpoVideoAdapter: VideoView component not found in expo-video. Please ensure you have a compatible version installed.",
+        installCommand: "npx expo install expo-video",
+        packageName: "expo-video"
+      };
+    }
+    
+    if (!this.expoVideoModule.createVideoPlayer) {
+      return {
+        isAvailable: false,
+        error: "ExpoVideoAdapter: createVideoPlayer function not found in expo-video. Please ensure you have a compatible version installed.",
+        installCommand: "npx expo install expo-video",
+        packageName: "expo-video"
+      };
+    }
+    
+    return { isAvailable: true };
+  }
+
   getAdapterName(): string {
     return VideoPlayerType.EXPO_VIDEO;
   }
 
   renderVideo(props: VideoPlayerProps, ref: RefObject<VideoPlayerRef | null>): ReactElement {
-
-    if (!this.isAvailable()) {
-      throw new Error('expo-video is not available');
+    const availabilityInfo = this.getAvailabilityInfo();
+    if (!availabilityInfo.isAvailable) {
+      throw new Error(`${availabilityInfo.error}\n\nTo fix this issue, run: ${availabilityInfo.installCommand}`);
     }
 
     const { VideoView, createVideoPlayer } = this.expoVideoModule;

src/adapters/FallbackVideoAdapter.tsx

@@ -10,7 +10,11 @@ export class FallbackVideoAdapter implements VideoPlayerAdapter {
   }
 
   isAvailable(): boolean {
-    return true; // Fallback is always available
+    return true; 
+  }
+
+  getAvailabilityInfo(): { isAvailable: boolean; error?: string; installCommand?: string; packageName?: string } {
+    return { isAvailable: true };
   }
 
   getAdapterName(): string {

src/adapters/types.ts

@@ -26,6 +26,16 @@ export interface VideoPlayerAdapter {
    */
   isAvailable(): boolean;
 
+  /**
+   * Get detailed availability information including error context and installation guidance
+   */
+  getAvailabilityInfo(): {
+    isAvailable: boolean;
+    error?: string;
+    installCommand?: string;
+    packageName?: string;
+  };
+
   /**
    * Get the display name of this adapter
    */