Achievements

// From server/utils.ts:26
export function checkForAchievements(
  lessonHistory: Lesson[], 
  completedLesson?: Lesson
) {
  const achievements: {
    type: string;
    payload: {
      title: string;
      description: string;
      icon: string;
    };
  }[] = [];
  
  // Check for various achievement conditions...
  return achievements;
}

// From server/utils.ts:37
// First lesson completed
if (lessonHistory.filter(l => l.status === "DONE").length === 1) {
  achievements.push({
    type: "FIRST_LESSON",
    payload: {
      title: "First Steps",
      description: "Completed your very first lesson!",
      icon: "award"
    }
  });
}

// From server/utils.ts:48
// 5 lessons completed
if (lessonHistory.filter(l => l.status === "DONE").length === 5) {
  achievements.push({
    type: "FIVE_LESSONS",
    payload: {
      title: "Learning Explorer",
      description: "Completed 5 lessons!",
      icon: "book-open"
    }
  });
}

// From server/utils.ts:60
// Perfect score on a quiz
if (completedLesson && completedLesson.score === 100) {
  achievements.push({
    type: "PERFECT_SCORE",
    payload: {
      title: "Perfect Score!",
      description: "Got all answers correct in a quiz!",
      icon: "star"
    }
  });
}

interface Achievement {
  type: string;           // Unique identifier (e.g., "FIRST_LESSON")
  payload: {
    title: string;        // Display name (e.g., "First Steps")
    description: string;  // What was accomplished
    icon: string;         // Icon name from icon library
  };
}

{
  "type": "FIVE_LESSONS",
  "payload": {
    "title": "Learning Explorer",
    "description": "Completed 5 lessons!",
    "icon": "book-open"
  }
}

// From client/src/components/AchievementBadge.tsx
interface AchievementBadgeProps {
  achievement: {
    title: string;
    description: string;
    icon: string;
  };
  size?: 'small' | 'medium' | 'large';
}

// From client/src/components/AchievementUnlock.tsx
- Fade-in animation
- Icon pulse effect
- Confetti particles
- Auto-dismiss after 5 seconds

interface LearnerProfile {
  // ... other fields
  achievements: Achievement[];  // Array of earned achievements
  achievementDates: Record<string, Date>;  // When each was earned
}

const profile = await getLearnerProfile(learnerId);
const achievements = profile.achievements || [];

console.log(`${profile.name} has earned ${achievements.length} achievements`);

// 1. Define the achievement check
if (lessonHistory.filter(l => l.status === "DONE").length === 10) {
  achievements.push({
    type: "TEN_LESSONS",
    payload: {
      title: "Dedicated Learner",
      description: "Completed 10 lessons!",
      icon: "medal"
    }
  });
}

// 2. Award bonus points
await pointsService.awardPoints({
  learnerId: learner.id,
  amount: 350,
  sourceType: 'ACHIEVEMENT',
  sourceId: 'TEN_LESSONS',
  description: 'Achievement unlocked: Dedicated Learner'
});

// 3. Save to learner profile
profile.achievements.push(achievement);
profile.achievementDates['TEN_LESSONS'] = new Date();
await updateLearnerProfile(profile);