Virtual Meetings API

db.feedback.getQuestions(): FeedbackQuestion[]

const questions = db.feedback.getQuestions();
const active = questions.filter(q => q.isActive);

db.feedback.saveQuestions(
  questions: FeedbackQuestion[]
): FeedbackQuestion[]

db.feedback.saveQuestions([
  {
    id: 'fq_1',
    order: 1,
    text: '¿Cómo evaluarías la sesión?',
    type: 'rating',
    isActive: true
  },
  {
    id: 'fq_2',
    order: 2,
    text: '¿Qué te gustó más?',
    type: 'multiple_choice',
    options: ['La temática', 'La dinámica', 'El facilitador'],
    isActive: true
  }
]);

db.feedback.getResponses(eventId?: string): FeedbackResponse[]

// All responses
const allResponses = db.feedback.getResponses();

// Responses for specific event
const eventResponses = db.feedback.getResponses('ev_123');
const avgRating = eventResponses.reduce((sum, r) => 
  sum + r.overallRating, 0
) / eventResponses.length;

db.feedback.submitResponse(
  data: Omit<FeedbackResponse, 'id'>
): FeedbackResponse

const response = db.feedback.submitResponse({
  eventId: 'ev_123',
  userId: 'u_456',
  userName: 'Juan Pérez',
  submittedAt: new Date().toISOString(),
  overallRating: 5,
  answers: [
    {
      questionId: 'fq_1',
      questionText: '¿Cómo evaluarías la sesión?',
      value: 5
    },
    {
      questionId: 'fq_2',
      questionText: '¿Qué te gustó más?',
      value: 'La temática'
    }
  ]
});

db.feedback.hasBlockingFeedback(userId: string): boolean

const isBlocked = db.feedback.hasBlockingFeedback('u_456');
if (isBlocked) {
  alert('Please submit feedback from your last session before joining.');
}

db.gamification.getBadges(userId?: string): MemberBadge[]

// All badges
const allBadges = db.gamification.getBadges();

// User's badges
const userBadges = db.gamification.getBadges('u_456');
console.log(`${userBadges.length} badges earned`);

db.gamification.awardBadge(
  data: Omit<MemberBadge, 'id'>
): MemberBadge

const badge = db.gamification.awardBadge({
  userId: 'u_456',
  type: 'medalla_oro',
  label: 'Perfect Attendance',
  reason: 'Attended 10 consecutive sessions',
  awardedAt: new Date().toISOString(),
  awardedBy: 'u_admin'
});

db.gamification.removeBadge(id: string): void

db.gamification.getParticipation(userId?: string): ParticipationRecord[]

const participation = db.gamification.getParticipation('u_456');
console.log(`Attended ${participation.length} events`);

db.gamification.recordParticipation(
  data: Omit<ParticipationRecord, 'id'>
): ParticipationRecord

const record = db.gamification.recordParticipation({
  userId: 'u_456',
  eventId: 'ev_123',
  eventTitle: 'Meditation Workshop',
  participatedAt: new Date().toISOString(),
  feedbackSubmitted: false,
  feedbackBlocksNext: true
});

db.gamification.getRanking(): Array<{
  userId: string;
  userName: string;
  points: number;
  badges: number;
  participations: number;
}>

const ranking = db.gamification.getRanking();
console.log('Top 3:');
ranking.slice(0, 3).forEach((user, i) => {
  console.log(`${i + 1}. ${user.userName}: ${user.points} points`);
});

interface FeedbackQuestion {
  id: string;
  order: number;
  text: string;
  type: 'rating' | 'multiple_choice' | 'text';
  options?: string[];   // For multiple_choice
  isActive: boolean;
}

interface FeedbackResponse {
  id: string;
  eventId: string;
  userId: string;
  userName: string;
  submittedAt: string;
  answers: {
    questionId: string;
    questionText: string;
    value: string | number;
  }[];
  overallRating: number;   // 1-5
}

type BadgeType = 
  | 'estrella' 
  | 'medalla_bronce' 
  | 'medalla_plata' 
  | 'medalla_oro' 
  | 'especial';

interface MemberBadge {
  id: string;
  userId: string;
  type: BadgeType;
  label: string;
  reason: string;
  awardedAt: string;
  awardedBy: string;
}

interface ParticipationRecord {
  id: string;
  userId: string;
  eventId: string;
  eventTitle: string;
  participatedAt: string;
  feedbackSubmitted: boolean;
  feedbackBlocksNext: boolean;
}

// 1. User joins a meeting
const userId = 'u_456';
const eventId = 'ev_123';

// 2. Record participation
db.gamification.recordParticipation({
  userId,
  eventId,
  eventTitle: 'Weekly Meditation',
  participatedAt: new Date().toISOString(),
  feedbackSubmitted: false,
  feedbackBlocksNext: true  // Blocks until feedback submitted
});

// 3. User submits feedback after event
db.feedback.submitResponse({
  eventId,
  userId,
  userName: 'Juan Pérez',
  submittedAt: new Date().toISOString(),
  overallRating: 5,
  answers: [
    { questionId: 'fq_1', questionText: 'Rating?', value: 5 }
  ]
});
// This automatically removes the block

// 4. Check if eligible for badge
const participations = db.gamification.getParticipation(userId);
if (participations.length >= 10) {
  db.gamification.awardBadge({
    userId,
    type: 'medalla_oro',
    label: '10 Sessions Milestone',
    reason: 'Attended 10 sessions',
    awardedAt: new Date().toISOString(),
    awardedBy: 'u_admin'
  });
}

// 5. View user's ranking
const ranking = db.gamification.getRanking();
const userRank = ranking.findIndex(r => r.userId === userId) + 1;
console.log(`User is ranked #${userRank}`);