Kavita/Kavita.Models/Entities/User/AppUserBookmark.cs

using System;
using System.Text.Json.Serialization;
using Kavita.Models.Entities.Interfaces;

namespace Kavita.Models.Entities.User;

public class BookmarkSeriesPair
{
    public AppUserBookmark Bookmark { get; init; } = null!;
    public Series Series { get; init; } = null!;
}

/// <summary>
/// Represents a saved page in a Chapter entity for a given user.
/// </summary>
public class AppUserBookmark : IEntityDate
{
    public int Id { get; set; }
    public int Page { get; set; }
    public int SeriesId { get; set; }
    public int VolumeId { get; set; }
    public int ChapterId { get; set; }

    /// <summary>
    /// Filename in the Bookmark Directory
    /// </summary>
    public string FileName { get; set; } = string.Empty;
    /// <summary>
    /// Only applicable for Epubs - handles multiple images on one page
    /// </summary>
    /// <remarks>0-based index of the image position on page</remarks>
    public int ImageOffset { get; set; }
    /// <summary>
    /// Only applicable for Epubs
    /// </summary>
    public string? XPath { get; set; }
    /// <summary>
    /// Chapter name (from ToC) or Title (from ComicInfo/PDF)
    /// </summary>
    public string? ChapterTitle { get; set; }

    // Relationships
    [JsonIgnore]
    public AppUser AppUser { get; set; } = null!;
    [JsonIgnore]
    public Series Series { get; set; } = null!;
    [JsonIgnore]
    public Volume Volume { get; set; } = null!;
    [JsonIgnore]
    public Chapter Chapter { get; set; } = null!;
    public int AppUserId { get; set; }
    public DateTime Created { get; set; }
    public DateTime LastModified { get; set; }
    public DateTime CreatedUtc { get; set; }
    public DateTime LastModifiedUtc { get; set; }
}