top100.h

// SPDX-License-Identifier: Apache-2.0
//-------------------------------------------------------------------------------
// Top100 — Your Personal Movie List
//
// File: lib/top100.h
// Purpose: Declarations for Top100 container and operations.
// Language: C++17 (header)
//
// Author: Andy McCall, mailme@andymccall.co.uk
// Date: September 18, 2025
//-------------------------------------------------------------------------------
#pragma once
 
#include <vector>
#include <string>
#include "Movie.h"
 
// Enum to define the sort order
enum class SortOrder {
    DEFAULT,
    BY_YEAR,
    ALPHABETICAL,
    BY_USER_RANK,    // 1..N ascending (unranked last)
    BY_USER_SCORE    // high to low
};
 
class Top100 {
public:
    Top100(const std::string& filename);
    ~Top100();
 
    void addMovie(const Movie& movie);
    void removeMovie(const std::string& title);
    bool removeByImdbId(const std::string& imdbID);
    std::vector<Movie> getMovies(SortOrder order = SortOrder::DEFAULT) const;
 
    // Duplicate handling helpers
    int findIndexByImdbId(const std::string& imdbID) const;      // returns index or -1
    int findIndexByTitleYear(const std::string& title, int year) const; // returns index or -1
    void replaceMovie(size_t index, const Movie& movie);
    // Direct update access for ranking adjustments (bounds-checked)
    bool updateMovie(size_t index, const Movie& movie);
 
    bool mergeFromOmdbByImdbId(const Movie& omdbMovie);
 
    // Recompute 1-based userRank from userScore (descending). Unranked (-1) if list empty.
    void recomputeRanks();
 
private:
    void load();
    void save();
 
    std::string filename;
    std::vector<Movie> movies;
};