userRatings()

csfd.userRatings(
  user: string | number,
  config?: CSFDUserRatingConfig,
  options?: CSFDOptions
): Promise<CSFDUserRatings[]>

import { csfd } from 'node-csfd-api';

// Get latest ratings (first page)
const ratings = await csfd.userRatings('912-bart');

ratings.forEach(rating => {
  console.log(`${rating.title} (${rating.year}): ${rating.userRating}/5`);
});

// Get second page of ratings
const page2 = await csfd.userRatings('912-bart', { page: 2 });

// Get third page
const page3 = await csfd.userRatings('912-bart', { page: 3 });

// Fetch all ratings with 2-second delay between requests
const allRatings = await csfd.userRatings('912-bart', {
  allPages: true,
  allPagesDelay: 2000 // 2 seconds between requests
});

console.log(`User has rated ${allRatings.length} items`);

// Get only movie ratings (exclude series, episodes, etc.)
const onlyMovies = await csfd.userRatings('912-bart', {
  includesOnly: ['film']
});

// Get movies and TV films
const moviesAndTvFilms = await csfd.userRatings('912-bart', {
  includesOnly: ['film', 'tv-film']
});

// Exclude episodes and seasons
const noEpisodes = await csfd.userRatings('912-bart', {
  excludes: ['episode', 'season']
});

const ratings = await csfd.userRatings('912', {
  allPages: true,
  allPagesDelay: 2000
});

// Calculate average rating
const totalStars = ratings.reduce((sum, r) => sum + r.userRating, 0);
const average = totalStars / ratings.length;

console.log(`Average rating: ${average.toFixed(2)}/5`);

// Count by star rating
const starCounts = ratings.reduce((acc, r) => {
  acc[r.userRating] = (acc[r.userRating] || 0) + 1;
  return acc;
}, {} as Record<number, number>);

console.log('Ratings distribution:', starCounts);

const ratings = await csfd.userRatings('912-bart');

// Get 5-star ratings only
const fiveStars = ratings.filter(r => r.userRating === 5);

console.log('5-star movies:');
fiveStars.forEach(movie => {
  console.log(`  - ${movie.title} (${movie.year})`);
});

import { csfd } from 'node-csfd-api';
import { writeFileSync } from 'fs';

async function exportRatings(username: string) {
  const ratings = await csfd.userRatings(username, {
    allPages: true,
    allPagesDelay: 2000,
    includesOnly: ['film'] // Only export movies
  });
  
  // Convert to CSV
  const csv = [
    'Title,Year,Rating,Date',
    ...ratings.map(r => 
      `"${r.title}",${r.year},${r.userRating},${r.userDate}`
    )
  ].join('\n');
  
  writeFileSync(`${username}-ratings.csv`, csv);
  console.log(`Exported ${ratings.length} ratings`);
}

await exportRatings('912-bart');

// All of these are valid:
const ratings1 = await csfd.userRatings(912);
const ratings2 = await csfd.userRatings('912');
const ratings3 = await csfd.userRatings('912-bart');

// Good - with delay
const ratings = await csfd.userRatings('912-bart', {
  allPages: true,
  allPagesDelay: 3000 // 3 seconds
});

// Bad - no delay (may get blocked)
const ratings = await csfd.userRatings('912-bart', {
  allPages: true
});