namespace OliverBooth.Data.Web;

/// <summary>
///     Represents a tutorial article.
/// </summary>
public interface ITutorialArticle
{
    /// <summary>
    ///     Gets the body of this article.
    /// </summary>
    /// <value>The body.</value>
    string Body { get; }

    /// <summary>
    ///     Gets the ID of the folder this article is contained within.
    /// </summary>
    /// <value>The ID of the folder.</value>
    int Folder { get; }

    /// <summary>
    ///     Gets the ID of this article.
    /// </summary>
    /// <value>The ID.</value>
    int Id { get; }

    /// <summary>
    ///     Gets the ID of the next article to this one.
    /// </summary>
    /// <value>The next part ID.</value>
    int? NextPart { get; }

    /// <summary>
    ///     Gets the URL of the article's preview image.
    /// </summary>
    /// <value>The preview image URL.</value>
    Uri? PreviewImageUrl { get; }

    /// <summary>
    ///     Gets the ID of the previous article to this one.
    /// </summary>
    /// <value>The previous part ID.</value>
    int? PreviousPart { get; }

    /// <summary>
    ///     Gets the date and time at which this article was published.
    /// </summary>
    /// <value>The publish timestamp.</value>
    DateTimeOffset Published { get; }

    /// <summary>
    ///     Gets the slug of this article.
    /// </summary>
    /// <value>The slug.</value>
    string Slug { get; }

    /// <summary>
    ///     Gets the title of this article.
    /// </summary>
    /// <value>The title.</value>
    string Title { get; }

    /// <summary>
    ///     Gets the date and time at which this article was updated.
    /// </summary>
    /// <value>The update timestamp, or <see langword="null" /> if this article has not been updated.</value>
    DateTimeOffset? Updated { get; }

    /// <summary>
    ///     Gets the visibility of this article.
    /// </summary>
    /// <value>The visibility of the article.</value>
    Visibility Visibility { get; }
}