Progress Reports and Usage Analytics for Caregivers

export type StatEvent =
  | 'session_start'   // child opens the app with an active session
  | 'pictogram_tap'   // child taps a final pictogram (not a category tile)
  | 'sentence_play'   // child plays the frase strip
  | 'free_text'       // child uses the free-text keyboard with ElevenLabs
  | 'ai_expand';      // child uses the magic-wand AI phrase expansion

export interface StatEventMeta {
  categoryId?: string;      // root category when event is pictogram_tap
  sentenceLength?: number;  // number of pictograms when event is sentence_play
  latencyMs?: number;       // AI call latency for ai_expand events
  intent?: string;          // communicative intent of the pictogram
}

export function useStats(): {
  logEvent: (event: StatEvent, meta?: StatEventMeta) => void;
  /** Records a completed sentence to sentence_log for the personalized predictor. */
  logSentence: (pictogramIds: string[]) => void;
}

export interface FullReportData {
  current: ReportData;           // stats for the selected period
  previous: ReportData | null;   // same-length period immediately before (for trend comparison)
  daily: DailyPoint[];           // per-day breakdown
  gameHistory: GameHistoryPoint[];
  insights: ReportInsight[];     // AI-generated suggestions (up to 5, non-expired)
}

export interface ReportData {
  description: string;
  byEventType: Record<string, number>;   // event counts keyed by StatEvent
  byHour: Record<string, number>;        // activity distribution by hour of day
  topPictograms: { id: string; count: number }[];
  sessions: number;
  sentencePlays: number;
  pictogramTaps: number;
  periodDays: number;
}

export interface DailyPoint {
  day: string;           // ISO date string
  sessions: number;
  sentence_plays: number;
  pictogram_taps: number;
  ai_expands: number;
}

export interface GameHistoryPoint {
  completed_at: string;
  sublevel: number;
  correct: number;
  total_trials: number;
  pct: number;
}

export interface ReportInsight {
  id: string;
  insight_type: string;
  message: string;
  seen: boolean;
  created_at: string;
}

export function useReport(): {
  data: FullReportData | null;
  loading: boolean;
  error: string | null;
  fetchReport: (days?: number) => Promise<void>;
}

export const ACHIEVEMENT_CATALOG: AchievementDef[] = [
  {
    id: 'first_sentence',
    emoji: '⭐',
    title: 'Primera frase',
    check: (c) => c.sentencesToday >= 1,
  },
  {
    id: 'streak_3',
    emoji: '🔥',
    title: '3 días seguidos',
    check: (c) => c.streakDays >= 3,
  },
  {
    id: 'level_3',
    emoji: '🏆',
    title: 'Nivel 3',
    check: (c) => c.level >= 3,
  },
  {
    id: 'xp_500',
    emoji: '🌟',
    title: '500 XP',
    check: (c) => c.totalXpApprox >= 500,
  },
  {
    id: 'practice_80',
    emoji: '🎯',
    title: '80% aciertos',
    check: (c) =>
      c.totalAttempts >= 5 &&
      Math.round((100 * c.correctAttempts) / c.totalAttempts) >= 80,
  },
];

export interface Rutina {
  id: string;
  user_id: string;
  label: string;
  emoji: string;
  completed: boolean;
  duration: number | null;  // estimated minutes, null if open-ended
  position: number;         // display order
}

export function useRutinas(): {
  rutinas: Rutina[];
  loading: boolean;
  error: string | null;
  toggleCompleted: (id: string) => Promise<void>;
  addRutina: (label: string, emoji?: string, duration?: number) => Promise<void>;
  deleteRutina: (id: string) => Promise<void>;
  /** Unchecks all tasks — useful for starting a new day. */
  resetCompleted: () => Promise<void>;
  reload: () => Promise<void>;
}

{
  "vocabularyLevel": "INTERMEDIO",
  "sublevel": 3,
  "avgSentenceLength": 2.1,
  "totalSentences": 47,
  "topPictogramLabels": ["Quiero", "Manzana", "Jugo", "Mamá", "Jugar"],
  "unusedCategoryLabels": ["Emociones", "Actividades"]
}

{
  "suggestions": [
    "Esta semana el niño usó 'Quiero' 28 veces pero nunca usó 'Siento'; considera trabajar la expresión de emociones en la próxima sesión.",
    "El niño tocó pictogramas de comida 14 veces — prueba agregar más opciones en la categoría Comida para ampliar su vocabulario.",
    "Lleva 4 días seguidos usando la app. ¡Es un gran avance! Puedes celebrarlo con él."
  ]
}

import * as Print from 'expo-print';
import * as Sharing from 'expo-sharing';

export type TeamRole = 'padre_madre' | 'terapeuta' | 'psicologo' | 'docente';

export interface TeamMember {
  id: string;
  role: TeamRole;
  can_view_reports: boolean;
  can_edit_vocabulary: boolean;
  status: 'pending' | 'active' | 'revoked';
  invite_email: string | null;
  accepted_at: string | null;
}

export function useChildTeam(): {
  members: TeamMember[];
  isLoading: boolean;
  error: string | null;
  loadTeam: () => Promise<void>;
  inviteMember: (role: TeamRole, email?: string) => Promise<TeamMember | null>;
  acceptInvite: (token: string) => Promise<string | null>;
  revokeMember: (memberId: string) => Promise<void>;
  updatePermissions: (memberId: string, perms: Partial<TeamMember>) => Promise<void>;
  /** Generates a 7-day share token for report-only access. */
  generateShareToken: () => Promise<string | null>;
}