@arfuhad/react-native-smart-camera 0.1.2 → 0.1.5

package/src/webrtc/types.ts

@@ -0,0 +1,361 @@
+/**
+ * WebRTC-related types for the SmartCamera module
+ */
+
+// =============================================================================
+// Core WebRTC Types
+// =============================================================================
+
+/**
+ * ICE server configuration for STUN/TURN servers
+ */
+export interface ICEServer {
+  /** STUN/TURN server URLs */
+  urls: string | string[];
+  /** Username for TURN authentication */
+  username?: string;
+  /** Credential for TURN authentication */
+  credential?: string;
+}
+
+/**
+ * Peer connection configuration
+ */
+export interface PeerConnectionConfig {
+  /** ICE servers (STUN/TURN) */
+  iceServers?: ICEServer[];
+  /** ICE transport policy */
+  iceTransportPolicy?: 'all' | 'relay';
+  /** Bundle policy */
+  bundlePolicy?: 'balanced' | 'max-bundle' | 'max-compat';
+  /** RTCP mux policy */
+  rtcpMuxPolicy?: 'require';
+}
+
+/**
+ * Video constraints for getUserMedia
+ */
+export interface VideoConstraints {
+  /** Frame width in pixels */
+  width?: number | { min?: number; ideal?: number; max?: number };
+  /** Frame height in pixels */
+  height?: number | { min?: number; ideal?: number; max?: number };
+  /** Target frame rate */
+  frameRate?: number | { min?: number; ideal?: number; max?: number };
+  /** Camera facing mode */
+  facingMode?: 'user' | 'environment';
+}
+
+/**
+ * Audio constraints for getUserMedia
+ */
+export interface AudioConstraints {
+  /** Enable echo cancellation */
+  echoCancellation?: boolean;
+  /** Enable noise suppression */
+  noiseSuppression?: boolean;
+  /** Enable auto gain control */
+  autoGainControl?: boolean;
+}
+
+/**
+ * Media stream constraints
+ */
+export interface MediaConstraints {
+  /** Video constraints (false to disable video) */
+  video?: boolean | VideoConstraints;
+  /** Audio constraints (false to disable audio) */
+  audio?: boolean | AudioConstraints;
+}
+
+// =============================================================================
+// Call State Types
+// =============================================================================
+
+/**
+ * WebRTC call state
+ */
+export type CallState =
+  | 'idle'        // No active call
+  | 'connecting'  // Call is being established
+  | 'connected'   // Call is active
+  | 'reconnecting'// Connection lost, attempting to reconnect
+  | 'disconnected'// Call ended or failed
+  | 'failed';     // Call failed to establish
+
+/**
+ * WebRTC connection state (maps to RTCPeerConnectionState)
+ */
+export type WebRTCConnectionState =
+  | 'new'
+  | 'connecting'
+  | 'connected'
+  | 'disconnected'
+  | 'failed'
+  | 'closed';
+
+/**
+ * ICE connection state
+ */
+export type ICEConnectionState =
+  | 'new'
+  | 'checking'
+  | 'connected'
+  | 'completed'
+  | 'failed'
+  | 'disconnected'
+  | 'closed';
+
+/**
+ * ICE gathering state
+ */
+export type ICEGatheringState = 'new' | 'gathering' | 'complete';
+
+/**
+ * Signaling state
+ */
+export type SignalingState =
+  | 'stable'
+  | 'have-local-offer'
+  | 'have-remote-offer'
+  | 'have-local-pranswer'
+  | 'have-remote-pranswer'
+  | 'closed';
+
+// =============================================================================
+// Stream and Track Types
+// =============================================================================
+
+/**
+ * Video frame format for WebRTC
+ */
+export type VideoFrameFormat = 'I420' | 'NV12' | 'NV21' | 'BGRA';
+
+/**
+ * Configuration for the WebRTC video source
+ */
+export interface WebRTCVideoSourceConfig {
+  /** Frame width in pixels */
+  width: number;
+  /** Frame height in pixels */
+  height: number;
+  /** Target frame rate */
+  frameRate: number;
+  /** Video frame format. Default: 'I420' */
+  format?: VideoFrameFormat;
+}
+
+/**
+ * WebRTC stream statistics
+ */
+export interface WebRTCStreamStats {
+  /** Current frame rate */
+  frameRate: number;
+  /** Frames sent */
+  framesSent: number;
+  /** Frames dropped */
+  framesDropped: number;
+  /** Bytes sent */
+  bytesSent: number;
+  /** Current bitrate in bps */
+  bitrate: number;
+  /** Round-trip time in ms */
+  rtt?: number;
+  /** Packets lost */
+  packetsLost?: number;
+  /** Jitter in ms */
+  jitter?: number;
+}
+
+/**
+ * WebRTC stream quality settings
+ */
+export interface WebRTCQualitySettings {
+  /** Maximum bitrate in bps */
+  maxBitrate?: number;
+  /** Minimum bitrate in bps */
+  minBitrate?: number;
+  /** Target frame rate */
+  targetFrameRate?: number;
+  /** Resolution scale (0.0 - 1.0) */
+  resolutionScale?: number;
+}
+
+// =============================================================================
+// Event Types
+// =============================================================================
+
+/**
+ * Event emitted when WebRTC stream state changes
+ */
+export interface WebRTCStreamEvent {
+  type: 'started' | 'stopped' | 'error' | 'stats';
+  timestamp: number;
+  error?: Error;
+  stats?: WebRTCStreamStats;
+}
+
+/**
+ * ICE candidate event data
+ */
+export interface ICECandidateEvent {
+  /** The ICE candidate */
+  candidate: RTCIceCandidate | null;
+  /** SDP mid */
+  sdpMid?: string | null;
+  /** SDP m-line index */
+  sdpMLineIndex?: number | null;
+}
+
+/**
+ * Session description for signaling
+ */
+export interface SessionDescription {
+  /** Type of description (offer/answer) */
+  type: 'offer' | 'answer';
+  /** SDP string */
+  sdp: string;
+}
+
+// =============================================================================
+// Hook Options and Results
+// =============================================================================
+
+/**
+ * Options for useWebRTC hook
+ */
+export interface UseWebRTCOptions {
+  /** Peer connection configuration */
+  config?: PeerConnectionConfig;
+  /** Media constraints for local stream */
+  mediaConstraints?: MediaConstraints;
+  /** Initial camera facing mode */
+  initialCamera?: 'front' | 'back';
+  /** Auto-start local stream when hook mounts */
+  autoStartLocalStream?: boolean;
+  /** Callback when call state changes */
+  onCallStateChange?: (state: CallState) => void;
+  /** Callback when connection state changes */
+  onConnectionStateChange?: (state: WebRTCConnectionState) => void;
+  /** Callback when ICE connection state changes */
+  onIceConnectionStateChange?: (state: ICEConnectionState) => void;
+  /** Callback when remote stream is received */
+  onRemoteStream?: (stream: MediaStream) => void;
+  /** Callback when remote stream is removed */
+  onRemoteStreamRemoved?: () => void;
+  /** Callback when an error occurs */
+  onError?: (error: Error) => void;
+}
+
+/**
+ * Result type for useWebRTC hook
+ */
+export interface UseWebRTCResult {
+  // Streams
+  /** Local media stream (camera + microphone) */
+  localStream: MediaStream | null;
+  /** Remote media stream from peer */
+  remoteStream: MediaStream | null;
+  
+  // State
+  /** Current call state */
+  callState: CallState;
+  /** Whether local audio is enabled */
+  isAudioEnabled: boolean;
+  /** Whether local video is enabled */
+  isVideoEnabled: boolean;
+  /** Current camera facing mode */
+  currentCamera: 'front' | 'back';
+  /** Peer connection instance */
+  peerConnection: RTCPeerConnection | null;
+  
+  // Local stream controls
+  /** Start local camera/microphone stream */
+  startLocalStream: () => Promise<void>;
+  /** Stop local stream */
+  stopLocalStream: () => void;
+  /** Switch between front and back camera */
+  switchCamera: () => Promise<void>;
+  /** Toggle local audio on/off */
+  toggleAudio: () => void;
+  /** Toggle local video on/off */
+  toggleVideo: () => void;
+  
+  // Peer connection management
+  /** Create a new peer connection */
+  createPeerConnection: (config?: PeerConnectionConfig) => RTCPeerConnection;
+  /** Close the peer connection */
+  closePeerConnection: () => void;
+  
+  // Signaling helpers (user integrates with their signaling server)
+  /** Create an SDP offer */
+  createOffer: () => Promise<SessionDescription>;
+  /** Create an SDP answer */
+  createAnswer: () => Promise<SessionDescription>;
+  /** Set the remote SDP description */
+  setRemoteDescription: (description: SessionDescription) => Promise<void>;
+  /** Add an ICE candidate from remote peer */
+  addIceCandidate: (candidate: RTCIceCandidate) => Promise<void>;
+  /** Register callback for ICE candidates to send to remote peer */
+  onIceCandidate: (callback: (candidate: ICECandidateEvent) => void) => void;
+  
+  // Cleanup
+  /** Clean up all resources */
+  cleanup: () => void;
+}
+
+/**
+ * Options for useWebRTCWithDetection hook
+ */
+export interface UseWebRTCWithDetectionOptions extends UseWebRTCOptions {
+  /** Face detection options */
+  faceDetection?: {
+    enabled?: boolean;
+    performanceMode?: 'fast' | 'accurate';
+    landmarkMode?: 'none' | 'all';
+    classificationMode?: 'none' | 'all';
+  };
+  /** Eye tracking options */
+  eyeTracking?: {
+    enabled?: boolean;
+    eyeClosedThreshold?: number;
+  };
+}
+
+// =============================================================================
+// Default Configurations
+// =============================================================================
+
+/**
+ * Default ICE servers (Google STUN servers)
+ */
+export const DEFAULT_ICE_SERVERS: ICEServer[] = [
+  { urls: 'stun:stun.l.google.com:19302' },
+  { urls: 'stun:stun1.l.google.com:19302' },
+];
+
+/**
+ * Default peer connection configuration
+ */
+export const DEFAULT_PEER_CONNECTION_CONFIG: PeerConnectionConfig = {
+  iceServers: DEFAULT_ICE_SERVERS,
+  iceTransportPolicy: 'all',
+  bundlePolicy: 'balanced',
+};
+
+/**
+ * Default media constraints
+ */
+export const DEFAULT_MEDIA_CONSTRAINTS: MediaConstraints = {
+  video: {
+    width: { ideal: 1280 },
+    height: { ideal: 720 },
+    frameRate: { ideal: 30 },
+    facingMode: 'user',
+  },
+  audio: {
+    echoCancellation: true,
+    noiseSuppression: true,
+    autoGainControl: true,
+  },
+};

package/android/build/.transforms/e0a0b120a9ccc3a8de4f5784bc36b161/results.bin

@@ -1 +0,0 @@
-o/classes

package/android/build/generated/source/buildConfig/debug/expo/modules/smartcamera/BuildConfig.java

@@ -1,10 +0,0 @@
-/**
- * Automatically generated file. DO NOT MODIFY
- */
-package expo.modules.smartcamera;
-
-public final class BuildConfig {
-  public static final boolean DEBUG = Boolean.parseBoolean("true");
-  public static final String LIBRARY_PACKAGE_NAME = "expo.modules.smartcamera";
-  public static final String BUILD_TYPE = "debug";
-}

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/aapt/AndroidManifest.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="expo.modules.smartcamera" >
-
-    <uses-sdk android:minSdkVersion="23" />
-
-</manifest>

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/aapt/output-metadata.json

@@ -1,18 +0,0 @@
-{
-  "version": 3,
-  "artifactType": {
-    "type": "AAPT_FRIENDLY_MERGED_MANIFESTS",
-    "kind": "Directory"
-  },
-  "applicationId": "expo.modules.smartcamera",
-  "variantName": "debug",
-  "elements": [
-    {
-      "type": "SINGLE",
-      "filters": [],
-      "attributes": [],
-      "outputFile": "AndroidManifest.xml"
-    }
-  ],
-  "elementType": "File"
-}

package/android/build/intermediates/aar_metadata/debug/aar-metadata.properties

@@ -1,6 +0,0 @@
-aarFormatVersion=1.0
-aarMetadataVersion=1.0
-minCompileSdk=1
-minCompileSdkExtension=0
-minAndroidGradlePluginVersion=1.0.0
-coreLibraryDesugaringEnabled=false

package/android/build/intermediates/annotation_processor_list/debug/annotationProcessors.json

@@ -1 +0,0 @@
-{}

package/android/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties

@@ -1 +0,0 @@
-#Wed Dec 24 04:54:56 BDT 2025

package/android/build/intermediates/incremental/debug/packageDebugResources/merger.xml

@@ -1,2 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<merger version="3"><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/arfuhad/Development/personal/rn-expo/rn-expo-package/react-native-smart-camera/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main" generated-set="main$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/arfuhad/Development/personal/rn-expo/rn-expo-package/react-native-smart-camera/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/arfuhad/Development/personal/rn-expo/rn-expo-package/react-native-smart-camera/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug" generated-set="debug$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/arfuhad/Development/personal/rn-expo/rn-expo-package/react-native-smart-camera/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/arfuhad/Development/personal/rn-expo/rn-expo-package/react-native-smart-camera/android/build/generated/res/resValues/debug"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated" generated-set="generated$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/arfuhad/Development/personal/rn-expo/rn-expo-package/react-native-smart-camera/android/build/generated/res/resValues/debug"/></dataSet><mergedItems/></merger>

package/android/build/intermediates/local_only_symbol_list/debug/R-def.txt

@@ -1,2 +0,0 @@
-R_DEF: Internal format may change without notice
-local

package/android/build/intermediates/manifest_merge_blame_file/debug/manifest-merger-blame-debug-report.txt

@@ -1,7 +0,0 @@
-1<?xml version="1.0" encoding="utf-8"?>
-2<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-3    package="expo.modules.smartcamera" >
-4
-5    <uses-sdk android:minSdkVersion="23" />
-6
-7</manifest>

package/android/build/intermediates/merged_manifest/debug/AndroidManifest.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="expo.modules.smartcamera" >
-
-    <uses-sdk android:minSdkVersion="23" />
-
-</manifest>

package/android/build/intermediates/navigation_json/debug/navigation.json

@@ -1 +0,0 @@
-[]

package/android/build/intermediates/symbol_list_with_package_name/debug/package-aware-r.txt

@@ -1 +0,0 @@
-expo.modules.smartcamera

package/android/build/kotlin/compileDebugKotlin/cacheable/caches-jvm/lookups/counters.tab

@@ -1,2 +0,0 @@
-5
-0