@rexai/pulse-react 1.1.0 → 2.0.0

package/dist/index.d.mts

@@ -2,241 +2,346 @@ import React$1 from 'react';
 
 /**
  * PulseAI SDK Type Definitions
+ *
+ * Version: 2.1.0
+ *
+ * IMPORTANT: Many metrics now return `null` when calculation fails.
+ * Always check for null before displaying values.
  */
+interface BloodPressureFeatures {
+    rise_time_ms: number | null;
+    pulse_amplitude: number | null;
+    pulse_width_ms: number | null;
+    augmentation_index: number | null;
+    pulses_analyzed: number;
+}
 interface BloodPressure {
-    systolic: number;
-    diastolic: number;
+    systolic: number | null;
+    diastolic: number | null;
+    pulse_pressure: number | null;
+    confidence: 'high' | 'moderate' | 'low' | 'very_low' | null;
+    features?: BloodPressureFeatures;
+    methodology?: string;
+    note?: string;
+    error?: string;
+}
+interface SpO2MethodResult {
+    spo2: number;
+    ratio: number;
+    quality: number;
+}
+interface SpO2Result {
+    spo2: number | null;
+    confidence: 'high' | 'moderate' | 'low' | 'very_low' | null;
+    method_used: 'red_blue' | 'green_red' | null;
+    signal_quality: number | null;
+    methods?: {
+        red_blue?: SpO2MethodResult;
+        green_red?: SpO2MethodResult;
+    };
+    error?: string;
 }
 interface ArrhythmiaResult {
-    has_arrhythmia: boolean;
-    irregularity_score: number;
-    details: string;
+    has_arrhythmia: boolean | null;
+    irregularity_score: number | null;
+    confidence: number | null;
+    details: string | null;
+}
+interface StressResult {
+    score: number | null;
+    level: 'low' | 'mild' | 'moderate' | 'high' | null;
+    confidence: number | null;
+    rmssd_ms: number | null;
+}
+interface RecoveryResult {
+    score: number | null;
+    level: 'poor' | 'moderate' | 'good' | 'excellent' | null;
+    rmssd_ms: number | null;
+}
+interface RespiratoryResult {
+    rate: number | null;
+    confidence: 'high' | 'moderate' | 'low' | null;
+    signal_quality: number | null;
+    breaths_detected: number | null;
+    interval_variability: number | null;
+    error?: string;
+}
+interface VascularAgeResult {
+    vascular_age: number | null;
+    chronological_age: number | null;
+    difference_years: number | null;
+    status: 'younger_than_chronological' | 'close_to_chronological' | 'moderately_elevated' | 'significantly_elevated' | null;
+    methodology?: string;
+}
+interface BMIEstimate {
+    value: number | null;
+    category: 'Underweight' | 'Normal' | 'Overweight' | 'Obese' | null;
+    confidence: 'high' | 'moderate' | 'low' | 'very_low' | 'invalid' | null;
+    fwhr: number | null;
+    source?: 'manual_input' | 'facial_estimation';
+    methodology?: string;
+    note?: string;
+    reason?: string;
+}
+interface SkinTemperatureResult {
+    value: number | null;
+    unit: string;
+    ratio: number | null;
+    confidence: 'proxy_only' | 'invalid_ratio';
+    note?: string;
+}
+interface FatigueIndicators {
+    eye_redness: number | null;
+    under_eye_darkness: number | null;
+    puffiness: number | null;
+    overall_fatigue: string | null;
+}
+interface SkinHealth {
+    evenness: number | null;
+    redness: number | null;
+    oiliness_proxy: number | null;
 }
 interface VisualAnalysis {
-    jaundice_risk: 'Low' | 'Medium' | 'High';
-    anemia_risk: 'Low' | 'Medium' | 'High';
-    bilirubin_proxy: number;
-    pallor_index: number;
-    hydration_level?: string;
-    hydration_score?: number;
-    fatigue_indicators?: {
-        eye_redness: number;
-        under_eye_darkness: number;
-        puffiness: number;
-        overall_fatigue: string;
-    };
-    skin_health?: {
-        evenness: number;
-        redness: number;
-        oiliness_proxy: number;
-    };
+    jaundice_risk: 'Low' | 'Medium' | 'High' | null;
+    anemia_risk: 'Low' | 'Medium' | 'High' | null;
+    bilirubin_proxy: number | null;
+    pallor_index: number | null;
+    hydration_level?: string | null;
+    hydration_score?: number | null;
+    texture_score?: number | null;
+    fatigue_indicators?: FatigueIndicators;
+    skin_health?: SkinHealth;
+}
+interface MentalWellnessComponents {
+    blink_score: number | null;
+    gaze_score: number | null;
+    emotion_score: number | null;
+    hrv_score: number | null;
 }
 interface MentalWellness {
-    wellness_score: number;
-    level: string;
-    emotion: string;
-    emotion_confidence?: number;
-    blink_rate_per_min: number;
-    gaze_stability: number;
-    gaze_direction?: string;
-    components: {
-        blink_score: number;
-        gaze_score: number;
-        emotion_score: number;
-        hrv_score: number;
-    };
+    wellness_score: number | null;
+    level: string | null;
+    emotion: string | null;
+    emotion_confidence?: number | null;
+    blink_rate_per_min: number | null;
+    gaze_stability: number | null;
+    gaze_direction?: string | null;
+    components: MentalWellnessComponents | null;
+}
+interface CompositeScoreDetails {
+    cardio?: string[];
+    resilience?: string[];
+    metabolic?: string[];
+    vitality?: string[];
 }
 interface CompositeScores {
-    cardio_score: number;
-    resilience_score: number;
-    metabolic_score: number;
-    vitality_score: number;
-}
-interface BMIEstimate {
-    value: number;
-    category: string;
-    fwhr: number;
-    confidence?: string;
-    method?: string;
+    cardio_score: number | null;
+    resilience_score: number | null;
+    metabolic_score: number | null;
+    vitality_score: number | null;
+    calculation_details?: CompositeScoreDetails;
+    bmi_used?: number;
 }
 interface VitalsResult {
-    heart_rate: number;
-    respiratory_rate: number;
-    hrv_sdnn: number;
-    hrv_rmssd: number;
-    recovery_score: number;
-    stress_index: number;
-    arrhythmia: ArrhythmiaResult;
-    rsa_amplitude: number;
-    blood_pressure: BloodPressure;
-    spo2: number;
-    signal_snippet: number[];
-    vascular_age: number;
-    bmi_est: BMIEstimate;
+    heart_rate: number | null;
+    hr_confidence?: 'high' | 'moderate' | 'low' | 'very_low' | null;
+    hr_snr_db?: number | null;
+    respiratory_rate: RespiratoryResult | number | null;
+    hrv_sdnn: number | null;
+    hrv_rmssd: number | null;
+    stress_index: StressResult | number | null;
+    recovery_score: RecoveryResult | number | null;
+    arrhythmia: ArrhythmiaResult | null;
+    rsa_amplitude: number | null;
+    blood_pressure: BloodPressure | null;
+    spo2: SpO2Result | number | null;
+    vascular_age: VascularAgeResult | number | null;
+    bmi_est: BMIEstimate | null;
     manual_bmi?: number;
-    metabolic_score: number;
-    skin_temperature: number;
-    composite_scores: CompositeScores;
-    visual_analysis?: VisualAnalysis;
-    mental_wellness?: MentalWellness;
-    fusion_weights: Record<string, number>;
+    skin_temperature: SkinTemperatureResult | number | null;
+    composite_scores: CompositeScores | null;
+    visual_analysis?: VisualAnalysis | null;
+    mental_wellness?: MentalWellness | null;
+    signal_snippet?: number[];
+    fusion_weights?: Record<string, number>;
+    metadata?: {
+        video_fps?: number;
+        frames_analyzed?: number;
+    };
+    error?: string | null;
 }
 interface BeautySummary {
-    overall_score: number;
-    skin_age: number;
+    overall_score: number | null;
+    skin_age: number | null;
+    age_provided: boolean;
+    age_difference?: number;
+    calculation_details?: Record<string, number>;
+    skin_age_note?: string;
+    error?: string;
 }
 interface BeautySurface {
-    texture: number;
-    hydration: number;
-    foundation_hex: string;
-    undertone: string;
-    acne_count: number;
-    acne_severity: string;
-    wrinkle_severity: string;
-    wrinkle_density: number;
-    oiliness_index: number;
-    matches: string;
-    skin_health: {
-        evenness: number;
-        redness: number;
-        oiliness_proxy: number;
-    };
+    texture: number | null;
+    hydration: number | null;
+    foundation_hex: string | null;
+    undertone: 'warm' | 'cool' | null;
+    acne_count: number | null;
+    acne_severity: 'minimal' | 'mild' | 'moderate' | 'significant' | null;
+    wrinkle_severity: 'minimal' | 'mild' | 'moderate' | 'significant' | null;
+    wrinkle_density: number | null;
+    oiliness_index: number | null;
+    matches: string | null;
+    skin_health: SkinHealth | null;
+}
+interface PtosisIndices {
+    status: 'none' | 'mild' | 'significant' | null;
+    youth_ratio?: number | null;
+    eye_openness?: number | null;
 }
 interface BeautyGeometry {
-    symmetry_score: number;
-    face_shape: string;
-    eye_openness: number;
-    ptosis_indices: {
-        status: string;
-        youth_ratio?: number;
-    };
+    symmetry_score: number | null;
+    face_shape: 'oval' | 'round' | 'square' | 'oblong' | null;
+    landmarks?: any;
+    ptosis_indices: PtosisIndices;
+    analysis_confidence?: 'high' | 'moderate' | 'low';
+    error?: string;
 }
 interface BeautyPhysiology {
-    glow_index: number;
-    stress_level: string;
-    elasticity: number;
+    glow_index: number | null;
+    stress_level: 'low' | 'moderate' | 'high' | null;
+    elasticity: number | null;
+    heart_rate?: number | null;
 }
 interface BeautyRecommendations {
     routine: string[];
     tips: string[];
+    foundation?: string | null;
 }
 interface BeautyResult {
-    summary: BeautySummary;
-    surface: BeautySurface;
-    geometry: BeautyGeometry;
-    physiology: BeautyPhysiology;
-    recommendations: BeautyRecommendations;
+    summary: BeautySummary | null;
+    surface: BeautySurface | null;
+    geometry: BeautyGeometry | null;
+    physiology: BeautyPhysiology | null;
+    recommendations: BeautyRecommendations | null;
+    meta?: {
+        rppg_source: string;
+        beauty_engine: string;
+    };
+    error?: string | null;
 }
 interface VoiceCompositeScores {
-    mental_score: number;
-    physical_score: number;
-    cognitive_score: number;
-    resilience_score: number;
+    mental_score: number | null;
+    physical_score: number | null;
+    cognitive_score: number | null;
+    resilience_score: number | null;
 }
 interface VoiceMoodIndicators {
-    monotone_speech?: boolean;
-    reduced_prosody?: boolean;
-    normal_prosody?: boolean;
-    slow_speech?: boolean;
-    slightly_slow?: boolean;
-    normal_rate?: boolean;
+    pitch_monotony?: 'high' | 'moderate' | 'low';
+    speech_slowness?: 'high' | 'moderate' | 'low';
     excessive_pauses?: boolean;
-    frequent_pauses?: boolean;
-    normal_pauses?: boolean;
-    low_energy?: boolean;
-    reduced_energy?: boolean;
-    normal_energy?: boolean;
-    low_pitch?: boolean;
+    flat_affect?: boolean | 'partial';
 }
 interface VoiceResult {
-    stress_score: number;
-    fatigue_score: number;
-    anxiety_level: 'low' | 'mild' | 'moderate' | 'high' | 'unknown';
-    anxiety_confidence: number;
-    voice_quality: 'normal' | 'slightly_strained' | 'strained' | 'unknown';
-    pitch_variability: number;
-    speech_rate: number;
-    pause_ratio: number;
-    tremor_index: number;
-    energy_variability: number;
-    respiratory_rate: number;
-    breathing_regularity: number;
-    breath_depth: 'shallow' | 'normal' | 'deep' | 'unknown';
-    respiratory_health: number;
-    cough_detected: boolean;
-    cough_count: number;
-    wheeze_detected: boolean;
-    respiratory_concern: 'none' | 'mild' | 'moderate' | 'high' | 'unknown';
-    depression_risk: 'low' | 'mild' | 'moderate' | 'elevated' | 'unknown';
-    depression_score: number;
-    mood_indicators: VoiceMoodIndicators;
-    cognitive_load: 'low' | 'normal' | 'moderate' | 'high' | 'unknown';
-    cognitive_score: number;
-    focus_indicator: 'relaxed' | 'stable' | 'engaged' | 'distracted' | 'unknown';
-    composite_scores: VoiceCompositeScores;
-    wellness_score: number;
-    wellness_level: 'excellent' | 'good' | 'fair' | 'needs_attention' | 'concerning' | 'unknown';
-    pitch_mean: number;
-    pitch_range: number;
-    energy_dynamics: number;
-    rhythm_regularity: number;
-    jitter: number;
-    shimmer: number;
-    duration_seconds: number;
-    analysis_confidence: number;
+    status: 'success' | 'error' | null;
+    error?: string | null;
+    stress_score: number | null;
+    fatigue_score: number | null;
+    anxiety_level: 'low' | 'mild' | 'moderate' | 'high' | null;
+    anxiety_confidence: number | null;
+    voice_quality: 'healthy' | 'mild_strain' | 'moderate_strain' | 'significant_strain' | null;
+    pitch_variability: number | null;
+    speech_rate: number | null;
+    pause_ratio: number | null;
+    tremor_index: number | null;
+    energy_variability: number | null;
+    respiratory_rate: number | null;
+    breathing_regularity: number | null;
+    breath_depth: 'shallow' | 'normal' | 'deep' | null;
+    respiratory_health: number | null;
+    cough_detected: boolean | null;
+    cough_count: number | null;
+    wheeze_detected: boolean | null;
+    respiratory_concern: 'none' | 'mild' | 'elevated' | null;
+    depression_risk: 'low' | 'mild' | 'moderate' | 'elevated' | null;
+    depression_score: number | null;
+    mood_indicators: VoiceMoodIndicators | null;
+    cognitive_load: 'low' | 'normal' | 'moderate' | 'high' | null;
+    cognitive_score: number | null;
+    focus_indicator: 'relaxed' | 'stable' | 'engaged' | 'strained' | null;
+    composite_scores: VoiceCompositeScores | null;
+    wellness_score: number | null;
+    wellness_level: 'excellent' | 'good' | 'moderate' | 'fair' | 'poor' | null;
+    pitch_mean: number | null;
+    pitch_range: number | null;
+    energy_dynamics: number | null;
+    rhythm_regularity: number | null;
+    jitter: number | null;
+    shimmer: number | null;
+    duration_seconds: number | null;
+    analysis_confidence: number | null;
     analysis_version: string;
 }
 interface EyeCataract {
-    opacity_score: number;
-    risk_level: 'low' | 'mild' | 'moderate' | 'elevated' | 'high' | 'unknown';
-    risk_confidence: number;
-    description: string;
-    recommendation: string;
+    opacity_score: number | null;
+    risk_level: 'low' | 'mild' | 'moderate' | 'elevated' | null;
+    confidence: 'high' | 'moderate' | 'low' | null;
+    description: string | null;
+    recommendation: string | null;
 }
 interface EyeRedEye {
-    redness_score: number;
-    risk_level: 'low' | 'mild' | 'moderate' | 'elevated' | 'high' | 'unknown';
-    is_inflamed: boolean;
-    description: string;
+    redness_score: number | null;
+    risk_level: 'low' | 'mild' | 'moderate' | 'elevated' | null;
+    is_inflamed: boolean | null;
+    confidence: 'high' | 'moderate' | 'low' | null;
+    description: string | null;
 }
 interface EyeLensClarity {
-    score: number;
-    level: 'clear' | 'moderate' | 'cloudy' | 'unknown';
+    score: number | null;
+    level: 'clear' | 'good' | 'moderate' | 'reduced' | null;
+    samples?: number;
 }
 interface EyePupil {
-    regularity_score: number;
-    status: 'normal' | 'irregular' | 'unknown';
+    regularity_score: number | null;
+    circularity: number | null;
+    status: 'normal' | 'irregular' | null;
+    samples_analyzed?: number;
+    detected?: boolean;
 }
 interface EyePterygium {
-    detected: boolean;
-    confidence: number;
-    severity?: 'mild' | 'moderate' | 'severe';
+    detected: boolean | null;
+    confidence: number | null;
+    severity?: 'minimal' | 'mild' | 'moderate' | 'significant' | null;
     description?: string;
+    error?: string;
 }
 interface EyeStye {
-    detected: boolean;
-    confidence: number;
+    detected: boolean | null;
+    confidence: number | null;
+    note?: string;
 }
 interface EyeSclera {
-    yellowing_score: number;
-    jaundice_risk: 'low' | 'moderate' | 'high' | 'unknown';
-    color_health: 'healthy' | 'monitor' | 'unknown';
+    score: number | null;
+    risk: 'low' | 'moderate' | 'elevated' | null;
+    color_health: 'healthy' | 'monitor' | null;
+    samples?: number;
+    error?: string;
 }
 interface EyeResult {
-    status: 'success' | 'partial' | 'error';
-    overall_score: number;
-    health_level: 'Excellent' | 'Good' | 'Fair' | 'Needs Attention' | 'Unknown';
-    cataract: EyeCataract;
-    red_eye: EyeRedEye;
-    lens_clarity: EyeLensClarity;
-    pupil: EyePupil;
-    pterygium: EyePterygium;
-    stye: EyeStye;
-    sclera: EyeSclera;
-    recommendations: string[];
+    status: 'success' | 'error' | null;
+    overall_score: number | null;
+    health_level: 'Excellent' | 'Good' | 'Fair' | 'Needs Attention' | 'Consult Specialist' | null;
+    cataract: EyeCataract | null;
+    red_eye: EyeRedEye | null;
+    lens_clarity: EyeLensClarity | null;
+    pupil: EyePupil | null;
+    pterygium: EyePterygium | null;
+    stye: EyeStye | null;
+    sclera: EyeSclera | null;
+    recommendations: string[] | null;
     frames_analyzed: number;
-    analysis_confidence: number;
+    eyes_detected: number;
+    analysis_confidence: 'high' | 'moderate' | 'low' | null;
     analysis_version?: string;
+    error?: string | null;
 }
 interface APIResponse<T> {
     status: 'success' | 'error';
@@ -310,21 +415,21 @@ declare const PulseScanner: React$1.FC<PulseScannerProps>;
  */
 interface VitalsCardProps {
     /** Heart rate in BPM */
-    heartRate?: number;
+    heartRate?: number | null;
     /** Oxygen saturation percentage */
-    spo2?: number;
+    spo2?: number | null;
     /** Stress index (0-100) */
-    stressIndex?: number;
+    stressIndex?: number | null;
     /** HRV SDNN in milliseconds */
-    hrvSdnn?: number;
+    hrvSdnn?: number | null;
     /** HRV RMSSD in milliseconds */
-    hrvRmssd?: number;
+    hrvRmssd?: number | null;
     /** Respiratory rate per minute */
-    respiratoryRate?: number;
+    respiratoryRate?: number | null;
     /** Blood pressure readings */
-    bloodPressure?: BloodPressure;
+    bloodPressure?: BloodPressure | null;
     /** Recovery score percentage */
-    recoveryScore?: number;
+    recoveryScore?: number | null;
     /** Show loading state */
     loading?: boolean;
     /** Error message to display */

package/dist/index.d.ts

@@ -2,241 +2,346 @@ import React$1 from 'react';
 
 /**
  * PulseAI SDK Type Definitions
+ *
+ * Version: 2.1.0
+ *
+ * IMPORTANT: Many metrics now return `null` when calculation fails.
+ * Always check for null before displaying values.
  */
+interface BloodPressureFeatures {
+    rise_time_ms: number | null;
+    pulse_amplitude: number | null;
+    pulse_width_ms: number | null;
+    augmentation_index: number | null;
+    pulses_analyzed: number;
+}
 interface BloodPressure {
-    systolic: number;
-    diastolic: number;
+    systolic: number | null;
+    diastolic: number | null;
+    pulse_pressure: number | null;
+    confidence: 'high' | 'moderate' | 'low' | 'very_low' | null;
+    features?: BloodPressureFeatures;
+    methodology?: string;
+    note?: string;
+    error?: string;
+}
+interface SpO2MethodResult {
+    spo2: number;
+    ratio: number;
+    quality: number;
+}
+interface SpO2Result {
+    spo2: number | null;
+    confidence: 'high' | 'moderate' | 'low' | 'very_low' | null;
+    method_used: 'red_blue' | 'green_red' | null;
+    signal_quality: number | null;
+    methods?: {
+        red_blue?: SpO2MethodResult;
+        green_red?: SpO2MethodResult;
+    };
+    error?: string;
 }
 interface ArrhythmiaResult {
-    has_arrhythmia: boolean;
-    irregularity_score: number;
-    details: string;
+    has_arrhythmia: boolean | null;
+    irregularity_score: number | null;
+    confidence: number | null;
+    details: string | null;
+}
+interface StressResult {
+    score: number | null;
+    level: 'low' | 'mild' | 'moderate' | 'high' | null;
+    confidence: number | null;
+    rmssd_ms: number | null;
+}
+interface RecoveryResult {
+    score: number | null;
+    level: 'poor' | 'moderate' | 'good' | 'excellent' | null;
+    rmssd_ms: number | null;
+}
+interface RespiratoryResult {
+    rate: number | null;
+    confidence: 'high' | 'moderate' | 'low' | null;
+    signal_quality: number | null;
+    breaths_detected: number | null;
+    interval_variability: number | null;
+    error?: string;
+}
+interface VascularAgeResult {
+    vascular_age: number | null;
+    chronological_age: number | null;
+    difference_years: number | null;
+    status: 'younger_than_chronological' | 'close_to_chronological' | 'moderately_elevated' | 'significantly_elevated' | null;
+    methodology?: string;
+}
+interface BMIEstimate {
+    value: number | null;
+    category: 'Underweight' | 'Normal' | 'Overweight' | 'Obese' | null;
+    confidence: 'high' | 'moderate' | 'low' | 'very_low' | 'invalid' | null;
+    fwhr: number | null;
+    source?: 'manual_input' | 'facial_estimation';
+    methodology?: string;
+    note?: string;
+    reason?: string;
+}
+interface SkinTemperatureResult {
+    value: number | null;
+    unit: string;
+    ratio: number | null;
+    confidence: 'proxy_only' | 'invalid_ratio';
+    note?: string;
+}
+interface FatigueIndicators {
+    eye_redness: number | null;
+    under_eye_darkness: number | null;
+    puffiness: number | null;
+    overall_fatigue: string | null;
+}
+interface SkinHealth {
+    evenness: number | null;
+    redness: number | null;
+    oiliness_proxy: number | null;
 }
 interface VisualAnalysis {
-    jaundice_risk: 'Low' | 'Medium' | 'High';
-    anemia_risk: 'Low' | 'Medium' | 'High';
-    bilirubin_proxy: number;
-    pallor_index: number;
-    hydration_level?: string;
-    hydration_score?: number;
-    fatigue_indicators?: {
-        eye_redness: number;
-        under_eye_darkness: number;
-        puffiness: number;
-        overall_fatigue: string;
-    };
-    skin_health?: {
-        evenness: number;
-        redness: number;
-        oiliness_proxy: number;
-    };
+    jaundice_risk: 'Low' | 'Medium' | 'High' | null;
+    anemia_risk: 'Low' | 'Medium' | 'High' | null;
+    bilirubin_proxy: number | null;
+    pallor_index: number | null;
+    hydration_level?: string | null;
+    hydration_score?: number | null;
+    texture_score?: number | null;
+    fatigue_indicators?: FatigueIndicators;
+    skin_health?: SkinHealth;
+}
+interface MentalWellnessComponents {
+    blink_score: number | null;
+    gaze_score: number | null;
+    emotion_score: number | null;
+    hrv_score: number | null;
 }
 interface MentalWellness {
-    wellness_score: number;
-    level: string;
-    emotion: string;
-    emotion_confidence?: number;
-    blink_rate_per_min: number;
-    gaze_stability: number;
-    gaze_direction?: string;
-    components: {
-        blink_score: number;
-        gaze_score: number;
-        emotion_score: number;
-        hrv_score: number;
-    };
+    wellness_score: number | null;
+    level: string | null;
+    emotion: string | null;
+    emotion_confidence?: number | null;
+    blink_rate_per_min: number | null;
+    gaze_stability: number | null;
+    gaze_direction?: string | null;
+    components: MentalWellnessComponents | null;
+}
+interface CompositeScoreDetails {
+    cardio?: string[];
+    resilience?: string[];
+    metabolic?: string[];
+    vitality?: string[];
 }
 interface CompositeScores {
-    cardio_score: number;
-    resilience_score: number;
-    metabolic_score: number;
-    vitality_score: number;
-}
-interface BMIEstimate {
-    value: number;
-    category: string;
-    fwhr: number;
-    confidence?: string;
-    method?: string;
+    cardio_score: number | null;
+    resilience_score: number | null;
+    metabolic_score: number | null;
+    vitality_score: number | null;
+    calculation_details?: CompositeScoreDetails;
+    bmi_used?: number;
 }
 interface VitalsResult {
-    heart_rate: number;
-    respiratory_rate: number;
-    hrv_sdnn: number;
-    hrv_rmssd: number;
-    recovery_score: number;
-    stress_index: number;
-    arrhythmia: ArrhythmiaResult;
-    rsa_amplitude: number;
-    blood_pressure: BloodPressure;
-    spo2: number;
-    signal_snippet: number[];
-    vascular_age: number;
-    bmi_est: BMIEstimate;
+    heart_rate: number | null;
+    hr_confidence?: 'high' | 'moderate' | 'low' | 'very_low' | null;
+    hr_snr_db?: number | null;
+    respiratory_rate: RespiratoryResult | number | null;
+    hrv_sdnn: number | null;
+    hrv_rmssd: number | null;
+    stress_index: StressResult | number | null;
+    recovery_score: RecoveryResult | number | null;
+    arrhythmia: ArrhythmiaResult | null;
+    rsa_amplitude: number | null;
+    blood_pressure: BloodPressure | null;
+    spo2: SpO2Result | number | null;
+    vascular_age: VascularAgeResult | number | null;
+    bmi_est: BMIEstimate | null;
     manual_bmi?: number;
-    metabolic_score: number;
-    skin_temperature: number;
-    composite_scores: CompositeScores;
-    visual_analysis?: VisualAnalysis;
-    mental_wellness?: MentalWellness;
-    fusion_weights: Record<string, number>;
+    skin_temperature: SkinTemperatureResult | number | null;
+    composite_scores: CompositeScores | null;
+    visual_analysis?: VisualAnalysis | null;
+    mental_wellness?: MentalWellness | null;
+    signal_snippet?: number[];
+    fusion_weights?: Record<string, number>;
+    metadata?: {
+        video_fps?: number;
+        frames_analyzed?: number;
+    };
+    error?: string | null;
 }
 interface BeautySummary {
-    overall_score: number;
-    skin_age: number;
+    overall_score: number | null;
+    skin_age: number | null;
+    age_provided: boolean;
+    age_difference?: number;
+    calculation_details?: Record<string, number>;
+    skin_age_note?: string;
+    error?: string;
 }
 interface BeautySurface {
-    texture: number;
-    hydration: number;
-    foundation_hex: string;
-    undertone: string;
-    acne_count: number;
-    acne_severity: string;
-    wrinkle_severity: string;
-    wrinkle_density: number;
-    oiliness_index: number;
-    matches: string;
-    skin_health: {
-        evenness: number;
-        redness: number;
-        oiliness_proxy: number;
-    };
+    texture: number | null;
+    hydration: number | null;
+    foundation_hex: string | null;
+    undertone: 'warm' | 'cool' | null;
+    acne_count: number | null;
+    acne_severity: 'minimal' | 'mild' | 'moderate' | 'significant' | null;
+    wrinkle_severity: 'minimal' | 'mild' | 'moderate' | 'significant' | null;
+    wrinkle_density: number | null;
+    oiliness_index: number | null;
+    matches: string | null;
+    skin_health: SkinHealth | null;
+}
+interface PtosisIndices {
+    status: 'none' | 'mild' | 'significant' | null;
+    youth_ratio?: number | null;
+    eye_openness?: number | null;
 }
 interface BeautyGeometry {
-    symmetry_score: number;
-    face_shape: string;
-    eye_openness: number;
-    ptosis_indices: {
-        status: string;
-        youth_ratio?: number;
-    };
+    symmetry_score: number | null;
+    face_shape: 'oval' | 'round' | 'square' | 'oblong' | null;
+    landmarks?: any;
+    ptosis_indices: PtosisIndices;
+    analysis_confidence?: 'high' | 'moderate' | 'low';
+    error?: string;
 }
 interface BeautyPhysiology {
-    glow_index: number;
-    stress_level: string;
-    elasticity: number;
+    glow_index: number | null;
+    stress_level: 'low' | 'moderate' | 'high' | null;
+    elasticity: number | null;
+    heart_rate?: number | null;
 }
 interface BeautyRecommendations {
     routine: string[];
     tips: string[];
+    foundation?: string | null;
 }
 interface BeautyResult {
-    summary: BeautySummary;
-    surface: BeautySurface;
-    geometry: BeautyGeometry;
-    physiology: BeautyPhysiology;
-    recommendations: BeautyRecommendations;
+    summary: BeautySummary | null;
+    surface: BeautySurface | null;
+    geometry: BeautyGeometry | null;
+    physiology: BeautyPhysiology | null;
+    recommendations: BeautyRecommendations | null;
+    meta?: {
+        rppg_source: string;
+        beauty_engine: string;
+    };
+    error?: string | null;
 }
 interface VoiceCompositeScores {
-    mental_score: number;
-    physical_score: number;
-    cognitive_score: number;
-    resilience_score: number;
+    mental_score: number | null;
+    physical_score: number | null;
+    cognitive_score: number | null;
+    resilience_score: number | null;
 }
 interface VoiceMoodIndicators {
-    monotone_speech?: boolean;
-    reduced_prosody?: boolean;
-    normal_prosody?: boolean;
-    slow_speech?: boolean;
-    slightly_slow?: boolean;
-    normal_rate?: boolean;
+    pitch_monotony?: 'high' | 'moderate' | 'low';
+    speech_slowness?: 'high' | 'moderate' | 'low';
     excessive_pauses?: boolean;
-    frequent_pauses?: boolean;
-    normal_pauses?: boolean;
-    low_energy?: boolean;
-    reduced_energy?: boolean;
-    normal_energy?: boolean;
-    low_pitch?: boolean;
+    flat_affect?: boolean | 'partial';
 }
 interface VoiceResult {
-    stress_score: number;
-    fatigue_score: number;
-    anxiety_level: 'low' | 'mild' | 'moderate' | 'high' | 'unknown';
-    anxiety_confidence: number;
-    voice_quality: 'normal' | 'slightly_strained' | 'strained' | 'unknown';
-    pitch_variability: number;
-    speech_rate: number;
-    pause_ratio: number;
-    tremor_index: number;
-    energy_variability: number;
-    respiratory_rate: number;
-    breathing_regularity: number;
-    breath_depth: 'shallow' | 'normal' | 'deep' | 'unknown';
-    respiratory_health: number;
-    cough_detected: boolean;
-    cough_count: number;
-    wheeze_detected: boolean;
-    respiratory_concern: 'none' | 'mild' | 'moderate' | 'high' | 'unknown';
-    depression_risk: 'low' | 'mild' | 'moderate' | 'elevated' | 'unknown';
-    depression_score: number;
-    mood_indicators: VoiceMoodIndicators;
-    cognitive_load: 'low' | 'normal' | 'moderate' | 'high' | 'unknown';
-    cognitive_score: number;
-    focus_indicator: 'relaxed' | 'stable' | 'engaged' | 'distracted' | 'unknown';
-    composite_scores: VoiceCompositeScores;
-    wellness_score: number;
-    wellness_level: 'excellent' | 'good' | 'fair' | 'needs_attention' | 'concerning' | 'unknown';
-    pitch_mean: number;
-    pitch_range: number;
-    energy_dynamics: number;
-    rhythm_regularity: number;
-    jitter: number;
-    shimmer: number;
-    duration_seconds: number;
-    analysis_confidence: number;
+    status: 'success' | 'error' | null;
+    error?: string | null;
+    stress_score: number | null;
+    fatigue_score: number | null;
+    anxiety_level: 'low' | 'mild' | 'moderate' | 'high' | null;
+    anxiety_confidence: number | null;
+    voice_quality: 'healthy' | 'mild_strain' | 'moderate_strain' | 'significant_strain' | null;
+    pitch_variability: number | null;
+    speech_rate: number | null;
+    pause_ratio: number | null;
+    tremor_index: number | null;
+    energy_variability: number | null;
+    respiratory_rate: number | null;
+    breathing_regularity: number | null;
+    breath_depth: 'shallow' | 'normal' | 'deep' | null;
+    respiratory_health: number | null;
+    cough_detected: boolean | null;
+    cough_count: number | null;
+    wheeze_detected: boolean | null;
+    respiratory_concern: 'none' | 'mild' | 'elevated' | null;
+    depression_risk: 'low' | 'mild' | 'moderate' | 'elevated' | null;
+    depression_score: number | null;
+    mood_indicators: VoiceMoodIndicators | null;
+    cognitive_load: 'low' | 'normal' | 'moderate' | 'high' | null;
+    cognitive_score: number | null;
+    focus_indicator: 'relaxed' | 'stable' | 'engaged' | 'strained' | null;
+    composite_scores: VoiceCompositeScores | null;
+    wellness_score: number | null;
+    wellness_level: 'excellent' | 'good' | 'moderate' | 'fair' | 'poor' | null;
+    pitch_mean: number | null;
+    pitch_range: number | null;
+    energy_dynamics: number | null;
+    rhythm_regularity: number | null;
+    jitter: number | null;
+    shimmer: number | null;
+    duration_seconds: number | null;
+    analysis_confidence: number | null;
     analysis_version: string;
 }
 interface EyeCataract {
-    opacity_score: number;
-    risk_level: 'low' | 'mild' | 'moderate' | 'elevated' | 'high' | 'unknown';
-    risk_confidence: number;
-    description: string;
-    recommendation: string;
+    opacity_score: number | null;
+    risk_level: 'low' | 'mild' | 'moderate' | 'elevated' | null;
+    confidence: 'high' | 'moderate' | 'low' | null;
+    description: string | null;
+    recommendation: string | null;
 }
 interface EyeRedEye {
-    redness_score: number;
-    risk_level: 'low' | 'mild' | 'moderate' | 'elevated' | 'high' | 'unknown';
-    is_inflamed: boolean;
-    description: string;
+    redness_score: number | null;
+    risk_level: 'low' | 'mild' | 'moderate' | 'elevated' | null;
+    is_inflamed: boolean | null;
+    confidence: 'high' | 'moderate' | 'low' | null;
+    description: string | null;
 }
 interface EyeLensClarity {
-    score: number;
-    level: 'clear' | 'moderate' | 'cloudy' | 'unknown';
+    score: number | null;
+    level: 'clear' | 'good' | 'moderate' | 'reduced' | null;
+    samples?: number;
 }
 interface EyePupil {
-    regularity_score: number;
-    status: 'normal' | 'irregular' | 'unknown';
+    regularity_score: number | null;
+    circularity: number | null;
+    status: 'normal' | 'irregular' | null;
+    samples_analyzed?: number;
+    detected?: boolean;
 }
 interface EyePterygium {
-    detected: boolean;
-    confidence: number;
-    severity?: 'mild' | 'moderate' | 'severe';
+    detected: boolean | null;
+    confidence: number | null;
+    severity?: 'minimal' | 'mild' | 'moderate' | 'significant' | null;
     description?: string;
+    error?: string;
 }
 interface EyeStye {
-    detected: boolean;
-    confidence: number;
+    detected: boolean | null;
+    confidence: number | null;
+    note?: string;
 }
 interface EyeSclera {
-    yellowing_score: number;
-    jaundice_risk: 'low' | 'moderate' | 'high' | 'unknown';
-    color_health: 'healthy' | 'monitor' | 'unknown';
+    score: number | null;
+    risk: 'low' | 'moderate' | 'elevated' | null;
+    color_health: 'healthy' | 'monitor' | null;
+    samples?: number;
+    error?: string;
 }
 interface EyeResult {
-    status: 'success' | 'partial' | 'error';
-    overall_score: number;
-    health_level: 'Excellent' | 'Good' | 'Fair' | 'Needs Attention' | 'Unknown';
-    cataract: EyeCataract;
-    red_eye: EyeRedEye;
-    lens_clarity: EyeLensClarity;
-    pupil: EyePupil;
-    pterygium: EyePterygium;
-    stye: EyeStye;
-    sclera: EyeSclera;
-    recommendations: string[];
+    status: 'success' | 'error' | null;
+    overall_score: number | null;
+    health_level: 'Excellent' | 'Good' | 'Fair' | 'Needs Attention' | 'Consult Specialist' | null;
+    cataract: EyeCataract | null;
+    red_eye: EyeRedEye | null;
+    lens_clarity: EyeLensClarity | null;
+    pupil: EyePupil | null;
+    pterygium: EyePterygium | null;
+    stye: EyeStye | null;
+    sclera: EyeSclera | null;
+    recommendations: string[] | null;
     frames_analyzed: number;
-    analysis_confidence: number;
+    eyes_detected: number;
+    analysis_confidence: 'high' | 'moderate' | 'low' | null;
     analysis_version?: string;
+    error?: string | null;
 }
 interface APIResponse<T> {
     status: 'success' | 'error';
@@ -310,21 +415,21 @@ declare const PulseScanner: React$1.FC<PulseScannerProps>;
  */
 interface VitalsCardProps {
     /** Heart rate in BPM */
-    heartRate?: number;
+    heartRate?: number | null;
     /** Oxygen saturation percentage */
-    spo2?: number;
+    spo2?: number | null;
     /** Stress index (0-100) */
-    stressIndex?: number;
+    stressIndex?: number | null;
     /** HRV SDNN in milliseconds */
-    hrvSdnn?: number;
+    hrvSdnn?: number | null;
     /** HRV RMSSD in milliseconds */
-    hrvRmssd?: number;
+    hrvRmssd?: number | null;
     /** Respiratory rate per minute */
-    respiratoryRate?: number;
+    respiratoryRate?: number | null;
     /** Blood pressure readings */
-    bloodPressure?: BloodPressure;
+    bloodPressure?: BloodPressure | null;
     /** Recovery score percentage */
-    recoveryScore?: number;
+    recoveryScore?: number | null;
     /** Show loading state */
     loading?: boolean;
     /** Error message to display */

package/dist/index.js

@@ -729,6 +729,15 @@ var PulseScanner = ({
 
 // src/components/VitalsCard.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
+function nullToUndefined(value) {
+  return value === null ? void 0 : value;
+}
+function extractNumeric(result) {
+  if (result === null || result === void 0) return void 0;
+  if (typeof result === "number") return result;
+  const val = result.score ?? result.value ?? result.spo2 ?? result.rate ?? null;
+  return val === null ? void 0 : val;
+}
 function getHeartRateStatus(hr) {
   if (hr < 55) return { label: "Low", color: "blue" };
   if (hr > 100) return { label: "Elevated", color: "orange" };
@@ -749,14 +758,14 @@ function getHrvStatus(hrv) {
   return { label: "Balanced", color: "blue" };
 }
 var VitalsCard = ({
-  heartRate,
-  spo2,
-  stressIndex,
-  hrvSdnn,
-  hrvRmssd,
-  respiratoryRate,
-  bloodPressure,
-  recoveryScore,
+  heartRate: heartRateProp,
+  spo2: spo2Prop,
+  stressIndex: stressIndexProp,
+  hrvSdnn: hrvSdnnProp,
+  hrvRmssd: hrvRmssdProp,
+  respiratoryRate: respiratoryRateProp,
+  bloodPressure: bloodPressureProp,
+  recoveryScore: recoveryScoreProp,
   loading = false,
   error = null,
   compact = false,
@@ -764,6 +773,14 @@ var VitalsCard = ({
   className = "",
   theme = "light"
 }) => {
+  const heartRate = nullToUndefined(heartRateProp);
+  const spo2 = nullToUndefined(spo2Prop);
+  const stressIndex = nullToUndefined(stressIndexProp);
+  const hrvSdnn = nullToUndefined(hrvSdnnProp);
+  const hrvRmssd = nullToUndefined(hrvRmssdProp);
+  const respiratoryRate = nullToUndefined(respiratoryRateProp);
+  const bloodPressure = nullToUndefined(bloodPressureProp);
+  const recoveryScore = nullToUndefined(recoveryScoreProp);
   if (loading) {
     return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: `vitals-card vitals-card--loading vitals-card--${theme} ${className}`, children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "vitals-card__spinner" }),
@@ -853,17 +870,21 @@ var VitalsCardFromResult = ({ result, ...props }) => {
   if (!result) {
     return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(VitalsCard, { ...props });
   }
+  const spo2Value = extractNumeric(result.spo2);
+  const stressValue = extractNumeric(result.stress_index);
+  const respiratoryValue = extractNumeric(result.respiratory_rate);
+  const recoveryValue = extractNumeric(result.recovery_score);
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
     VitalsCard,
     {
       heartRate: result.heart_rate,
-      spo2: result.spo2,
-      stressIndex: result.stress_index,
+      spo2: spo2Value,
+      stressIndex: stressValue,
       hrvSdnn: result.hrv_sdnn,
       hrvRmssd: result.hrv_rmssd,
-      respiratoryRate: result.respiratory_rate,
+      respiratoryRate: respiratoryValue,
       bloodPressure: result.blood_pressure,
-      recoveryScore: result.recovery_score,
+      recoveryScore: recoveryValue,
       ...props
     }
   );

package/dist/index.mjs

@@ -685,6 +685,15 @@ var PulseScanner = ({
 
 // src/components/VitalsCard.tsx
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function nullToUndefined(value) {
+  return value === null ? void 0 : value;
+}
+function extractNumeric(result) {
+  if (result === null || result === void 0) return void 0;
+  if (typeof result === "number") return result;
+  const val = result.score ?? result.value ?? result.spo2 ?? result.rate ?? null;
+  return val === null ? void 0 : val;
+}
 function getHeartRateStatus(hr) {
   if (hr < 55) return { label: "Low", color: "blue" };
   if (hr > 100) return { label: "Elevated", color: "orange" };
@@ -705,14 +714,14 @@ function getHrvStatus(hrv) {
   return { label: "Balanced", color: "blue" };
 }
 var VitalsCard = ({
-  heartRate,
-  spo2,
-  stressIndex,
-  hrvSdnn,
-  hrvRmssd,
-  respiratoryRate,
-  bloodPressure,
-  recoveryScore,
+  heartRate: heartRateProp,
+  spo2: spo2Prop,
+  stressIndex: stressIndexProp,
+  hrvSdnn: hrvSdnnProp,
+  hrvRmssd: hrvRmssdProp,
+  respiratoryRate: respiratoryRateProp,
+  bloodPressure: bloodPressureProp,
+  recoveryScore: recoveryScoreProp,
   loading = false,
   error = null,
   compact = false,
@@ -720,6 +729,14 @@ var VitalsCard = ({
   className = "",
   theme = "light"
 }) => {
+  const heartRate = nullToUndefined(heartRateProp);
+  const spo2 = nullToUndefined(spo2Prop);
+  const stressIndex = nullToUndefined(stressIndexProp);
+  const hrvSdnn = nullToUndefined(hrvSdnnProp);
+  const hrvRmssd = nullToUndefined(hrvRmssdProp);
+  const respiratoryRate = nullToUndefined(respiratoryRateProp);
+  const bloodPressure = nullToUndefined(bloodPressureProp);
+  const recoveryScore = nullToUndefined(recoveryScoreProp);
   if (loading) {
     return /* @__PURE__ */ jsxs2("div", { className: `vitals-card vitals-card--loading vitals-card--${theme} ${className}`, children: [
       /* @__PURE__ */ jsx2("div", { className: "vitals-card__spinner" }),
@@ -809,17 +826,21 @@ var VitalsCardFromResult = ({ result, ...props }) => {
   if (!result) {
     return /* @__PURE__ */ jsx2(VitalsCard, { ...props });
   }
+  const spo2Value = extractNumeric(result.spo2);
+  const stressValue = extractNumeric(result.stress_index);
+  const respiratoryValue = extractNumeric(result.respiratory_rate);
+  const recoveryValue = extractNumeric(result.recovery_score);
   return /* @__PURE__ */ jsx2(
     VitalsCard,
     {
       heartRate: result.heart_rate,
-      spo2: result.spo2,
-      stressIndex: result.stress_index,
+      spo2: spo2Value,
+      stressIndex: stressValue,
       hrvSdnn: result.hrv_sdnn,
       hrvRmssd: result.hrv_rmssd,
-      respiratoryRate: result.respiratory_rate,
+      respiratoryRate: respiratoryValue,
       bloodPressure: result.blood_pressure,
-      recoveryScore: result.recovery_score,
+      recoveryScore: recoveryValue,
       ...props
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rexai/pulse-react",
-    "version": "1.1.0",
+    "version": "2.0.0",
     "description": "React SDK for rPPG health analysis - measure heart rate, HRV, SpO2, voice biomarkers from any camera",
     "main": "dist/index.js",
     "module": "dist/index.mjs",