import { API, Beatmapset, Changelog, NewsPost, User } from "../index.js";
export interface Comment {
    id: number;
    parent_id: number | null;
    /**
     * @remarks Is null if the author of the comment from the old comment system has no associated osu! user, presumably
     * @privateRemarks Example is comment 178966 from beatmapset 349238
     */
    user_id: User["id"] | null;
    pinned: boolean;
    replies_count: number;
    votes_count: number;
    /** "build" means changelog, like pretty much everywhere in the API */
    commentable_type: "beatmapset" | "build" | "news_post";
    commentable_id: Beatmapset["id"] | Changelog.Build["id"] | NewsPost["id"];
    /** I think it's the name used by the person who made the comment before a migration to a new comment system in 2018 or before? */
    legacy_name: string | null;
    created_at: Date;
    updated_at: Date;
    deleted_at: Date | null;
    edited_at: Date | null;
    edited_by_id: User["id"] | null;
    /**
     * Yes comments may not have this property, yes this is stupid
     * @privateRemarks Example is comment 3063736 from build 7463
     */
    message?: string;
    /** Yes comments may not have this property, yes this is stupid */
    message_html?: string;
}
export declare namespace Comment {
    /** @obtainableFrom {@link API.getComment} */
    interface Bundle {
        comments: Comment[];
        has_more: boolean;
        has_more_id: number | null;
        included_comments: Comment[];
        pinned_comments: Comment[];
        user_votes: number[];
        user_follow: boolean;
        users: User[];
        sort: "new" | "old" | "top";
        cursor: {
            created_at: Date;
            id: number;
        } | null;
        commentable_meta: {
            id: number;
            title: string;
            type: Comment["commentable_type"];
            url: string;
            owner_id: User["id"] | null;
            /** Like MAPPER */
            owner_title: string | null;
            current_user_attributes: {
                /**
                 * The string explains why the authorized user cannot post a new comment in this specific context, it's null if they can
                 * @remarks If there is simply no authorized user, this'll be a string such as "Please sign in to proceed."
                 */
                can_new_comment_reason: string | null;
            };
        }[];
        /**
         * This is an original property of the package that lets you know how many `CommentableMeta`s that only consist of a `title` of "Deleted Item" got removed
         * @remarks This DOES COUNT the one that is always there, see https://github.com/ppy/osu-web/issues/11077
         */
        deleted_commentable_meta: number;
    }
    namespace Bundle {
        /** @obtainableFrom {@link API.getComments} */
        interface WithTotalToplevelcount extends Comment.Bundle {
            total: number;
            top_level_count: number;
        }
    }
    /**
     * Get a specific comment by using its id!
     * @param comment The comment in question
     */
    function getOne(this: API, comment: Comment["id"] | Comment): Promise<Bundle>;
    /**
     * Get comments that meet any of your requirements!
     * @param from From where are the comments coming from? Maybe a beatmapset, but then, which beatmapset?
     * @param parent The comments are replying to which comment? Make the id 0 to filter out replies (and only get top level comments)
     * @param sort Should the comments be sorted by votes? Should they be from after a certain date? Maybe you can give a cursor?
     */
    function getMultiple(this: API, from?: {
        type: Comment["commentable_type"];
        id: number;
    }, parent?: Comment["id"] | Comment, sort?: {
        type?: Bundle["sort"];
        after?: Comment["id"] | Comment;
        cursor?: Bundle["cursor"];
    }): Promise<Bundle.WithTotalToplevelcount>;
}