/*
    This file is part of libdjinterop.

    libdjinterop is free software: you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    libdjinterop is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public License
    along with libdjinterop.  If not, see <http://www.gnu.org/licenses/>.
*/

#pragma once

#include <chrono>
#include <cstdint>
#include <memory>
#include <optional>
#include <stdexcept>
#include <string>
#include <vector>

#include <djinterop/config.hpp>
#include <djinterop/engine/v2/beat_data_blob.hpp>
#include <djinterop/engine/v2/loops_blob.hpp>
#include <djinterop/engine/v2/overview_waveform_data_blob.hpp>
#include <djinterop/engine/v2/quick_cues_blob.hpp>
#include <djinterop/engine/v2/track_data_blob.hpp>
#include <djinterop/stream_helper.hpp>

namespace djinterop::engine
{
struct engine_library_context;
}

namespace djinterop::engine::v2
{

/// Thrown when the id on a track row is in an erroneous state for a given
/// operation.
struct DJINTEROP_PUBLIC track_row_id_error : public std::runtime_error
{
public:
    explicit track_row_id_error(const std::string& what_arg) noexcept :
        runtime_error{what_arg}
    {
    }
};

/// Special value for id to indicate that a given row is not currently persisted
/// in the database.
constexpr int64_t TRACK_ROW_ID_NONE = 0;

/// Special value for the `album_art_id` track table column that indicates that
/// no album art is present for a given track.
constexpr int64_t ALBUM_ART_ID_NONE = 1;

/// Special value for the `rating` track table column that indicates that no
/// rating is present for a given track.
constexpr int64_t RATING_NONE = 0;

/// Special value for the `lastEditTime` track table column that indicates there
/// is no last edit time for a given track.
constexpr std::chrono::system_clock::time_point LAST_EDIT_TIME_NONE =
    std::chrono::system_clock::time_point{std::chrono::seconds{0}};

/// Represents a row in the `Track` table.
struct DJINTEROP_PUBLIC track_row
{
    /// Auto-generated id column.
    ///
    /// A value of `TRACK_ROW_ID_NONE` can be used to indicate a track row that
    /// is not yet persisted in the table, e.g. when adding a new row.
    int64_t id;

    /// `playOrder` column.
    std::optional<int64_t> play_order;

    /// `length` column, representing the approximate length, in seconds.
    int64_t length;

    /// `bpm` column, representing the approximate BPM.
    std::optional<int64_t> bpm;

    /// `year` column.
    std::optional<int64_t> year;

    /// `path` column.
    ///
    /// Represents the relative path from the location of the Engine library to
    /// the music file underlying the track.
    std::string path;

    /// `filename` column, representing the name of the file underlying the
    /// track.
    std::string filename;

    /// `bitrate` column.
    std::optional<int64_t> bitrate;

    /// `bpmAnalyzed` column, representing the BPM as determined from track
    /// analysis.
    std::optional<double> bpm_analyzed;

    /// `albumArtId` column.
    ///
    /// The id may be set to zero if there is no album art.
    int64_t album_art_id;

    /// `file_bytes` column, representing the size of the file underlying the
    /// track on disk, in bytes.
    std::optional<int64_t> file_bytes;

    /// `title` column.
    std::optional<std::string> title;

    /// `artist` column.
    std::optional<std::string> artist;

    /// `album column.
    std::optional<std::string> album;

    /// `genre` column.
    std::optional<std::string> genre;

    /// `comment` column.
    std::optional<std::string> comment;

    /// `label` column.
    std::optional<std::string> label;

    /// `composer` column.
    std::optional<std::string> composer;

    /// `remixer` column.
    std::optional<std::string> remixer;

    /// `key` column, as an integer between 0 and 23.
    std::optional<int32_t> key;

    /// `rating` column.
    ///
    /// The value is set to zero if there is no rating.
    int64_t rating;

    /// `albumArt` column.
    std::optional<std::string> album_art;

    /// `timeLastPlayed` column.
    std::optional<std::chrono::system_clock::time_point> time_last_played;

    /// `isPlayed` column, indicating whether the track has ever been played.
    bool is_played;

    /// `fileType` column, representing the format of the file underlying the
    /// track.
    std::string file_type;

    /// `isAnalyzed` column, indicating whether the track has been analysed.
    bool is_analyzed;

    /// `dateCreated` column, representing the time at which the file underlying
    /// this track was created.
    std::chrono::system_clock::time_point date_created;

    /// `dateAdded` column, representing the time at which the track was added
    /// to the database.
    std::chrono::system_clock::time_point date_added;

    /// `isAvailable` column, indicating if the file underpinning the track
    /// entry is available.
    bool is_available;

    /// `isMetadataOfPackedTrackChanged` column.
    bool is_metadata_of_packed_track_changed;

    /// `isPerformanceDataOfPackedTrackChanged` column.
    ///
    /// Note that the column is misspelled as "perfomance" in a real database.
    bool is_performance_data_of_packed_track_changed;

    /// `playedIndicator` column.
    ///
    /// Random number matching the equivalent field in the `Information` table,
    /// if this track is the most recent to be played.
    std::optional<int64_t> played_indicator;

    /// `isMetadataImported` column.
    bool is_metadata_imported;

    /// `pdbImportKey` column.
    int64_t pdb_import_key;

    /// `streamingSource` column.
    std::optional<std::string> streaming_source;

    /// `uri` column.
    std::optional<std::string> uri;

    /// `isBeatGridLocked` column.
    bool is_beat_grid_locked;

    /// `originDatabaseUuid` column, representing the UUID of the database from
    /// which the track was originally imported.
    ///
    /// If the track has not been imported from another database, this field is
    /// set to the UUID of the current database.
    std::string origin_database_uuid;

    /// `originTrackId` column, representing the ID of the track in the
    /// original database from which it was imported.
    ///
    /// If the track has not been imported from another database, this field is
    /// set to the id of the track in the current database.
    int64_t origin_track_id;

    /// `trackData` column.
    track_data_blob track_data;

    /// `overviewWaveFormData` column.
    overview_waveform_data_blob overview_waveform_data;

    /// `beatData` column.
    beat_data_blob beat_data;

    /// `quickCues` column.
    quick_cues_blob quick_cues;

    /// `loops` column.
    loops_blob loops;

    /// `thirdPartySourceId` column.
    std::optional<int64_t> third_party_source_id;

    /// `streamingFlags` column.
    int64_t streaming_flags;

    /// `explicitLyrics` column.
    bool explicit_lyrics;

    /// `activeOnLoadLoops` column.
    std::optional<int64_t> active_on_load_loops;

    /// `lastEditTime` column.
    ///
    /// This column is set automatically to the current timestamp via a database
    /// trigger when certain fields are updated.
    std::chrono::system_clock::time_point last_edit_time;

    friend bool operator==(const track_row& lhs, const track_row& rhs) noexcept
    {
        return std::tie(
                   lhs.id, lhs.play_order, lhs.length, lhs.bpm, lhs.year,
                   lhs.path, lhs.filename, lhs.bitrate, lhs.bpm_analyzed,
                   lhs.album_art_id, lhs.file_bytes, lhs.title, lhs.artist,
                   lhs.album, lhs.genre, lhs.comment, lhs.label, lhs.composer,
                   lhs.remixer, lhs.key, lhs.rating, lhs.album_art,
                   lhs.time_last_played, lhs.is_played, lhs.file_type,
                   lhs.is_analyzed, lhs.date_created, lhs.date_added,
                   lhs.is_available, lhs.is_metadata_of_packed_track_changed,
                   lhs.is_performance_data_of_packed_track_changed,
                   lhs.played_indicator, lhs.is_metadata_imported,
                   lhs.pdb_import_key, lhs.streaming_source, lhs.uri,
                   lhs.is_beat_grid_locked, lhs.origin_database_uuid,
                   lhs.origin_track_id, lhs.track_data,
                   lhs.overview_waveform_data, lhs.beat_data, lhs.quick_cues,
                   lhs.loops, lhs.third_party_source_id, lhs.streaming_flags,
                   lhs.explicit_lyrics, lhs.active_on_load_loops,
                   lhs.last_edit_time) ==
               std::tie(
                   rhs.id, rhs.play_order, rhs.length, rhs.bpm, rhs.year,
                   rhs.path, rhs.filename, rhs.bitrate, rhs.bpm_analyzed,
                   rhs.album_art_id, rhs.file_bytes, rhs.title, rhs.artist,
                   rhs.album, rhs.genre, rhs.comment, rhs.label, rhs.composer,
                   rhs.remixer, rhs.key, rhs.rating, rhs.album_art,
                   rhs.time_last_played, rhs.is_played, rhs.file_type,
                   rhs.is_analyzed, rhs.date_created, rhs.date_added,
                   rhs.is_available, rhs.is_metadata_of_packed_track_changed,
                   rhs.is_performance_data_of_packed_track_changed,
                   rhs.played_indicator, rhs.is_metadata_imported,
                   rhs.pdb_import_key, rhs.streaming_source, rhs.uri,
                   rhs.is_beat_grid_locked, rhs.origin_database_uuid,
                   rhs.origin_track_id, rhs.track_data,
                   rhs.overview_waveform_data, rhs.beat_data, rhs.quick_cues,
                   rhs.loops, rhs.third_party_source_id, rhs.streaming_flags,
                   rhs.explicit_lyrics, rhs.active_on_load_loops,
                   rhs.last_edit_time);
    }

    friend bool operator!=(const track_row& lhs, const track_row& rhs) noexcept
    {
        return !(rhs == lhs);
    }

    friend std::ostream& operator<<(std::ostream& os, const track_row& obj)
    {
#define PRINT_FIELD(field) \
    os << ", " #field "="; \
    stream_helper::print(os, obj.field)

        os << "track_row{id=" << obj.id;
        PRINT_FIELD(play_order);
        PRINT_FIELD(length);
        PRINT_FIELD(bpm);
        PRINT_FIELD(year);
        PRINT_FIELD(path);
        PRINT_FIELD(filename);
        PRINT_FIELD(bitrate);
        PRINT_FIELD(bpm_analyzed);
        PRINT_FIELD(album_art_id);
        PRINT_FIELD(file_bytes);
        PRINT_FIELD(title);
        PRINT_FIELD(artist);
        PRINT_FIELD(album);
        PRINT_FIELD(genre);
        PRINT_FIELD(label);
        PRINT_FIELD(remixer);
        PRINT_FIELD(key);
        PRINT_FIELD(rating);
        PRINT_FIELD(album_art);
        PRINT_FIELD(time_last_played);
        PRINT_FIELD(is_played);
        PRINT_FIELD(file_type);
        PRINT_FIELD(is_analyzed);
        PRINT_FIELD(date_created);
        PRINT_FIELD(date_added);
        PRINT_FIELD(is_available);
        PRINT_FIELD(is_metadata_of_packed_track_changed);
        PRINT_FIELD(is_performance_data_of_packed_track_changed);
        PRINT_FIELD(played_indicator);
        PRINT_FIELD(is_metadata_imported);
        PRINT_FIELD(pdb_import_key);
        PRINT_FIELD(streaming_source);
        PRINT_FIELD(uri);
        PRINT_FIELD(is_beat_grid_locked);
        PRINT_FIELD(origin_database_uuid);
        PRINT_FIELD(origin_track_id);
        PRINT_FIELD(track_data);
        PRINT_FIELD(overview_waveform_data);
        PRINT_FIELD(beat_data);
        PRINT_FIELD(quick_cues);
        PRINT_FIELD(loops);
        PRINT_FIELD(third_party_source_id);
        PRINT_FIELD(streaming_flags);
        PRINT_FIELD(explicit_lyrics);
        PRINT_FIELD(active_on_load_loops);
        PRINT_FIELD(last_edit_time);
        os << "}";
        return os;
#undef PRINT_FIELD
    }
};

/// Represents the `Track` table in an Engine v2 database.
class DJINTEROP_PUBLIC track_table
{
public:
    /// Construct an instance of the class using an Engine library context.
    ///
    /// \param context Engine library context.
    explicit track_table(std::shared_ptr<engine_library_context> context);

    /// Add a track row to the table.
    ///
    /// \param row Track row to add.
    /// \return Returns the id of the newly-added track row.
    /// \throws track_row_id_error If the row already has an id.
    int64_t add(const track_row& row);

    /// Get the ids of all tracks in the table.
    ///
    /// \return Returns a list of all ids.
    [[nodiscard]] std::vector<int64_t> all_ids() const;

    /// Check whether a given track exists.
    ///
    /// \param id Id of track to check.
    /// \return Returns `true` if the track exists, or `false` if not.
    [[nodiscard]] bool exists(int64_t id) const;

    /// Get an entire track row.
    ///
    /// \param id Id of track.
    /// \return Returns a track row, or none if not found.
    std::optional<track_row> get(int64_t id) const;

    /// Find whether a track exists, given its unique path.
    ///
    /// \param path Path of track.
    /// \return Returns a track id if found, or none if not found.
    std::optional<int64_t> find_id_by_path(const std::string& path) const;

    /// Get the `playOrder` column for a given track.
    std::optional<int64_t> get_play_order(int64_t id);

    /// Set the `playOrder` column for a given track.
    void set_play_order(int64_t id, std::optional<int64_t> play_order);

    /// Get the `length` column for a given track, representing the approximate
    /// length, in seconds.
    int64_t get_length(int64_t id);

    /// Set the `length` column for a given track, representing the approximate
    /// length, in seconds.
    void set_length(int64_t id, int64_t length);

    /// Get the `bpm` column for a given track, representing the approximate
    /// BPM.
    std::optional<int64_t> get_bpm(int64_t id);

    /// Set the `bpm` column for a given track, representing the approximate
    /// BPM.
    void set_bpm(int64_t id, std::optional<int64_t> bpm);

    /// Get the `year` column for a given track.
    std::optional<int64_t> get_year(int64_t id);

    /// Set the `year` column for a given track.
    void set_year(int64_t id, const std::optional<int64_t>& year);

    /// Get the `path` column for a given track.
    ///
    /// Represents the relative path from the location of the Engine library to
    /// the music file underlying the track.
    std::string get_path(int64_t id);

    /// Set the `path` column for a given track.
    ///
    /// Represents the relative path from the location of the Engine library to
    /// the music file underlying the track.
    void set_path(int64_t id, const std::string& path);

    /// Get the `filename` column for a given track, representing the name of
    /// the file underlying the track.
    std::string get_filename(int64_t id);

    /// Set the `filename` column for a given track, representing the name of
    /// the file underlying the track.
    void set_filename(int64_t id, const std::string& filename);

    /// Get the `bitrate` column for a given track.
    std::optional<int64_t> get_bitrate(int64_t id);

    /// Set the `bitrate` column for a given track.
    void set_bitrate(int64_t id, std::optional<int64_t> bitrate);

    /// Get the `bpmAnalyzed` column for a given track, representing the BPM as
    /// determined from track analysis.
    std::optional<double> get_bpm_analyzed(int64_t id);

    /// Set the `bpmAnalyzed` column for a given track, representing the BPM as
    /// determined from track analysis.
    void set_bpm_analyzed(int64_t id, std::optional<double> bpm_analyzed);

    /// Get the `albumArtId` column for a given track.
    ///
    /// The id may be set to zero if there is no album art.
    int64_t get_album_art_id(int64_t id);

    /// Set the `albumArtId` column for a given track.
    ///
    /// The id may be set to zero if there is no album art.
    void set_album_art_id(int64_t id, int64_t album_art_id);

    /// Get the `file_bytes` column for a given track, representing the size of
    /// the file underlying the track on disk, in bytes.
    std::optional<int64_t> get_file_bytes(int64_t id);

    /// Set the `file_bytes` column for a given track, representing the size of
    /// the file underlying the track on disk, in bytes.
    void set_file_bytes(int64_t id, std::optional<int64_t> file_bytes);

    /// Get the `title` column for a given track.
    std::optional<std::string> get_title(int64_t id);

    /// Set the `title` column for a given track.
    void set_title(int64_t id, const std::optional<std::string>& title);

    /// Get the `artist` column for a given track.
    std::optional<std::string> get_artist(int64_t id);

    /// Set the `artist` column for a given track.
    void set_artist(int64_t id, const std::optional<std::string>& artist);

    /// Get the `album` column for a given track.
    std::optional<std::string> get_album(int64_t id);

    /// Set the `album` column for a given track.
    void set_album(int64_t id, const std::optional<std::string>& album);

    /// Get the `genre` column for a given track.
    std::optional<std::string> get_genre(int64_t id);

    /// Set the `genre` column for a given track.
    void set_genre(int64_t id, const std::optional<std::string>& genre);

    /// Get the `comment` column for a given track.
    std::optional<std::string> get_comment(int64_t id);

    /// Set the `comment` column for a given track.
    void set_comment(int64_t id, const std::optional<std::string>& comment);

    /// Get the `label` column for a given track.
    std::optional<std::string> get_label(int64_t id);

    /// Set the `label` column for a given track.
    void set_label(int64_t id, const std::optional<std::string>& label);

    /// Get the `composer` column for a given track.
    std::optional<std::string> get_composer(int64_t id);

    /// Set the `composer` column for a given track.
    void set_composer(int64_t id, const std::optional<std::string>& composer);

    /// Get the `remixer` column for a given track.
    std::optional<std::string> get_remixer(int64_t id);

    /// Set the `remixer` column for a given track.
    void set_remixer(int64_t id, const std::optional<std::string>& remixer);

    /// Get the `key` column for a given track, as an integer between 0 and 23.
    std::optional<int32_t> get_key(int64_t id);

    /// Set the `key` column for a given track, as an integer between 0 and 23.
    ///
    /// The values align with those in the `djinterop::musical_key` enum.
    void set_key(int64_t id, std::optional<int32_t> key);

    /// Get the `rating` column for a given track.
    ///
    /// The value is set to zero if there is no rating.
    int64_t get_rating(int64_t id);

    /// Set the `rating` column for a given track.
    ///
    /// The value is set to zero if there is no rating.
    void set_rating(int64_t id, int64_t rating);

    /// Get the `albumArt` column for a given track.
    std::optional<std::string> get_album_art(int64_t id);

    /// Set the `albumArt` column for a given track.
    void set_album_art(int64_t id, const std::optional<std::string>& album_art);

    /// Get the `timeLastPlayed` column for a given track.
    std::optional<std::chrono::system_clock::time_point> get_time_last_played(
        int64_t id);

    /// Set the `timeLastPlayed` column for a given track.
    void set_time_last_played(
        int64_t id, const std::optional<std::chrono::system_clock::time_point>&
                        time_last_played);

    /// Get the `isPlayed` column for a given track, indicating whether the
    /// track has ever been played.
    bool get_is_played(int64_t id);

    /// Set the `isPlayed` column for a given track, indicating whether the
    /// track has ever been played.
    void set_is_played(int64_t id, bool is_played);

    /// Get the `fileType` column for a given track, representing the format of
    /// the file underlying the track.
    std::string get_file_type(int64_t id);

    /// Set the `fileType` column for a given track, representing the format of
    /// the file underlying the track.
    void set_file_type(int64_t id, const std::string& file_type);

    /// Get the `isAnalyzed` column for a given track, indicating whether the
    /// track has been analysed.
    bool get_is_analyzed(int64_t id);

    /// Set the `isAnalyzed` column for a given track, indicating whether the
    /// track has been analysed.
    void set_is_analyzed(int64_t id, bool is_analyzed);

    /// Get the `dateCreated` column for a given track.
    std::optional<std::chrono::system_clock::time_point> get_date_created(
        int64_t id);

    /// Set the `dateCreated` column for a given track.
    void set_date_created(
        int64_t id, const std::optional<std::chrono::system_clock::time_point>&
                        date_created);

    /// Get the `dateAdded` column for a given track, representing the time at
    /// which the track was added to the database.
    std::optional<std::chrono::system_clock::time_point> get_date_added(
        int64_t id);

    /// Set the `dateAdded` column for a given track, representing the time at
    /// which the track was added to the database.
    void set_date_added(
        int64_t id,
        const std::optional<std::chrono::system_clock::time_point>& date_added);

    /// Get the `isAvailable` column for a given track, indicating if the file
    /// underlying the track entry is available.
    bool get_is_available(int64_t id);

    /// Set the `isAvailable` column for a given track, indicating if the file
    /// underlying the track entry is available.
    void set_is_available(int64_t id, bool is_available);

    /// Get the `isMetadataOfPackedTrackChanged` column for a given track.
    bool get_is_metadata_of_packed_track_changed(int64_t id);

    /// Set the `isMetadataOfPackedTrackChanged` column for a given track.
    void set_is_metadata_of_packed_track_changed(
        int64_t id, bool is_metadata_of_packed_track_changed);

    /// Get the `isPerformanceDataOfPackedTrackChanged` column for a given
    /// track.
    bool get_is_performance_data_of_packed_track_changed(int64_t id);

    /// Set the `isPerformanceDataOfPackedTrackChanged` column for a given
    /// track.
    void set_is_performance_data_of_packed_track_changed(
        int64_t id, bool is_performance_data_of_packed_track_changed);

    /// Get the `playedIndicator` column for a given track.
    ///
    /// Random number matching the equivalent field in the `Information` table,
    /// if this track is the most recent to be played.
    std::optional<int64_t> get_played_indicator(int64_t id);

    /// Set the `playedIndicator` column for a given track.
    ///
    /// Random number matching the equivalent field in the `Information` table,
    /// if this track is the most recent to be played.
    void set_played_indicator(
        int64_t id, const std::optional<int64_t>& played_indicator);

    /// Get the `isMetadataImported` column for a given track.
    bool get_is_metadata_imported(int64_t id);

    /// Set the `isMetadataImported` column for a given track.
    void set_is_metadata_imported(int64_t id, bool is_metadata_imported);

    /// Get the `pdbImportKey` column for a given track.
    int64_t get_pdb_import_key(int64_t id);

    /// Set the `pdbImportKey` column for a given track.
    void set_pdb_import_key(int64_t id, int64_t pdb_import_key);

    /// Get the `streamingSource` column for a given track.
    std::optional<std::string> get_streaming_source(int64_t id);

    /// Set the `streamingSource` column for a given track.
    void set_streaming_source(
        int64_t id, const std::optional<std::string>& streaming_source);

    /// Get the `uri` column for a given track.
    std::optional<std::string> get_uri(int64_t id);

    /// Set the `uri` column for a given track.
    void set_uri(int64_t id, const std::optional<std::string>& uri);

    /// Get the `isBeatGridLocked` column for a given track.
    bool get_is_beat_grid_locked(int64_t id);

    /// Set the `isBeatGridLocked` column for a given track.
    void set_is_beat_grid_locked(int64_t id, bool is_beat_grid_locked);

    /// Get the `originDatabaseUuid` column for a given track, representing the
    /// UUID of the database from which the track was originally imported.
    ///
    /// If the track has not been imported from another database, this field is
    /// set to the UUID of the current database.
    std::string get_origin_database_uuid(int64_t id);

    /// Set the `originDatabaseUuid` column for a given track, representing the
    /// UUID of the database from which the track was originally imported.
    ///
    /// If the track has not been imported from another database, this field is
    /// set to the UUID of the current database.
    void set_origin_database_uuid(
        int64_t id, const std::string& origin_database_uuid);

    /// Get the `originTrackId` column for a given track, representing the ID
    /// of the track in the original database from which it was imported.
    ///
    /// If the track has not been imported from another database, this field is
    /// set to the id of the track in the current database.
    int64_t get_origin_track_id(int64_t id);

    /// Set the `originTrackId` column for a given track, representing the ID
    /// of the track in the original database from which it was imported.
    ///
    /// If the track has not been imported from another database, this field is
    /// set to the id of the track in the current database.
    void set_origin_track_id(int64_t id, int64_t origin_track_id);

    /// Get the `trackData` column for a given track.
    track_data_blob get_track_data(int64_t id);

    /// Set the `trackData` column for a given track.
    void set_track_data(int64_t id, const track_data_blob& track_data);

    /// Get the `overviewWaveFormData` column for a given track.
    overview_waveform_data_blob get_overview_waveform_data(int64_t id);

    /// Set the `overviewWaveFormData` column for a given track.
    void set_overview_waveform_data(
        int64_t id, const overview_waveform_data_blob& overview_waveform_data);

    /// Get the `beatData` column for a given track.
    beat_data_blob get_beat_data(int64_t id);

    /// Set the `beatData` column for a given track.
    void set_beat_data(int64_t id, const beat_data_blob& beat_data);

    /// Get the `quickCues` column for a given track.
    quick_cues_blob get_quick_cues(int64_t id);

    /// Set the `quickCues` column for a given track.
    void set_quick_cues(int64_t id, const quick_cues_blob& quick_cues);

    /// Get the `loops` column for a given track.
    loops_blob get_loops(int64_t id);

    /// Set the `loops` column for a given track.
    void set_loops(int64_t id, const loops_blob& loops);

    /// Get the `thirdPartySourceId` column for a given track.
    std::optional<int64_t> get_third_party_source_id(int64_t id);

    /// Set the `thirdPartySourceId` column for a given track.
    void set_third_party_source_id(
        int64_t id, const std::optional<int64_t>& third_party_source_id);

    /// Get the `streamingFlags` column for a given track.
    int64_t get_streaming_flags(int64_t id);

    /// Set the `streamingFlags` column for a given track.
    void set_streaming_flags(int64_t id, int64_t streaming_flags);

    /// Get the `explicitLyrics` column for a given track.
    bool get_explicit_lyrics(int64_t id);

    /// Set the `explicitLyrics` column for a given track.
    void set_explicit_lyrics(int64_t id, bool explicit_lyrics);

    /// Get the `activeOnLoadLoops` column for a given track.
    std::optional<int64_t> get_active_on_load_loops(int64_t id);

    /// Set the `activeOnLoadLoops` column for a given track.
    void set_active_on_load_loops(
        int64_t id, std::optional<int64_t> active_on_load_loops);

    /// Get the `lastEditTime` column for a given track.
    std::chrono::system_clock::time_point get_last_edit_time(int64_t id);

    /// Set the `lastEditTime` column for a given track.
    void set_last_edit_time(
        int64_t id, std::chrono::system_clock::time_point last_edit_time);

    /// Remove an entry from the track table.
    ///
    /// \param id Id of track to remove.
    void remove(int64_t id);

    /// Update an existing track row in the table.
    ///
    /// \param row Track row to update.
    /// \throws track_row_id_error If the row has no id.
    void update(const track_row& row);

private:
    std::shared_ptr<engine_library_context> context_;
};

}  // namespace djinterop::engine::v2
