The API for achievements and badges

import { TrophyApiClient } from "@trophyso/node";

const trophy = new TrophyApiClient({ apiKey: process.env.TROPHY_API_KEY });

// 1. Track a metric event (e.g., user completed a lesson)
const eventResponse = await trophy.metrics.event("lessons", {
  user: { id: "user-123" },
  value: 1,
});

console.log("Event ID:", eventResponse.eventId);
console.log("Lifetime total:", eventResponse.total);

// 2. Check if any achievements unlocked from this event
if (eventResponse.achievements.length > 0) {
  for (const achievement of eventResponse.achievements) {
    console.log("Unlocked:", achievement.name, "| Badge:", achievement.badgeUrl);
  }
}

// 3. Fetch all achievements for a user (for profile display, history, etc.)
const userAchievements = await trophy.users.achievements("user-123");

for (const a of userAchievements) {
  console.log(a.name, "| Achieved:", a.achievedAt, "| Rarity:", a.rarity);
}

// 4. Mark an event-triggered achievement complete (e.g., finished onboarding)
const completion = await trophy.achievements.complete("finish-onboarding", {
  user: { id: "user-123" },
});

console.log("Completion ID:", completion.completionId);
console.log("Points awarded:", completion.points);