import { TraktShowShort, TraktShowExtended } from '../../models/trakt-show.model.js';
import { TraktCollectionMetadata, TraktCollectionSeason } from '../../models/trakt-collection.model.js';
import { TraktMovieShort, TraktMovieExtended } from '../../models/trakt-movie.model.js';
import { y as TraktUserSettings, z as TraktUserFollowRequest, A as TraktUserFollower, F as TraktUserFilter, G as TraktUserHiddenItem, H as TraktUserHiddenRequest, I as TraktUserHiddenAdded, J as TraktUserHiddenDeleted, q as TraktPrivateUser, T as TraktComment, a as TraktCommentMedia, b as TraktCommentItem, d as TraktList, o as TraktListReordered, p as TraktListItemsGetQuery, g as TraktListItem, k as TraktUserListItemAddedRequest, l as TraktUserListItemAdded, m as TraktUserListItemRemoveRequest, n as TraktUserListItemRemoved, E as TraktUserFollow, C as TraktUserFollowing, D as TraktUserFriend } from '../../trakt-list.model-CeURmxQs.js';
import { TraktHistory } from '../../models/trakt-history.model.js';
import { TraktLike } from '../../models/trakt-like.model.js';
import { TraktNoteTypes, TraktNoteItem } from '../../models/trakt-note.model.js';
import { TraktRating } from '../../models/trakt-rating.model.js';
import { TraktStats } from '../../models/trakt-stats.model.js';
import { TraktWatching, TraktWatched } from '../../models/trakt-watched.model.js';
import { TraktWatchlist } from '../../models/trakt-watchlist.model.js';
import { TraktClientEndpoint, TraktApiParamsExtended, TraktApiParamsPagination } from '../../models/trakt-client.model.js';
import '../../models/trakt-entity.model.js';
import '@dvcol/common-utils/common/models';
import '../../models/trakt-id.model.js';
import '@dvcol/base-http-client';
import '@dvcol/common-utils/http/fetch';
import '../trakt-api.filters.js';
import '../../models/trakt-image.model.js';
import '../../models/trakt-people.model.js';
import '../../models/trakt-episode.model.js';
import '../../models/trakt-season.model.js';
import '../../models/trakt-sync.model.js';

/**
 * User's with public data will return info with all GET methods.
 * Private user's (including yourself) require valid OAuth and a friend relationship to return data.
 *
 * * <b>Username vs. Slug</b>
 *
 * All users methods should use the slug to identify the user.
 * The slug is a URL safe and globally unique version of the username.
 *
 * * <b>Special ID for the OAuth user<+b>
 *
 * If you send valid OAuth, you can use me to identify the OAuth user instead of needing their actual slug.
 * You can of course still use their actual slug, it's up to you.
 *
 * * <b>Extra Headers</b>
 *
 * If valid OAuth is sent, additional headers will be sent to better determine it is a data permissions issue (they aren't friends) and not bad OAuth.
 * For example, you might try and access a private user's list you aren't friends with. This will return a 401 HTTP status code and the additional headers.
 * This means the OAuth is valid, but authorization ultimately failed because there is no friend relationship.
 *
 * - X-Private-User	- true or false
 *
 * * <b>Creating New Users</b>
 *
 * Since the API uses OAuth, users can create a new account during that flow if they need to. As far as your app is concerned, you'll still receive OAuth tokens no matter if they sign in with an existing account or create a new one.
 *
 * @see [users]{@link https://trakt.docs.apiary.io/#reference/users}
 */
declare const users: {
    /**
     * Get the user's settings so you can align your app's experience with what they're used to on the trakt website. A globally unique uuid is also returned, which can be used to identify the user locally in your app if needed. However, the uuid can't be used to retrieve data from the Trakt API.
     *
     * @auth required
     *
     * @see [retrieve-settings]{@link https://trakt.docs.apiary.io/#reference/users/settings/retrieve-settings}
     */
    settings: TraktClientEndpoint<TraktApiParamsExtended<"full">, TraktUserSettings, true>;
    requests: {
        /**
         * List a user's pending following requests that they're waiting for the other user's to approve.
         *
         * @extended true - {@link TraktApiExtended.Full}
         * @auth required
         *
         * @see [get-pending-following-requests]{@link https://trakt.docs.apiary.io/#reference/users/following-requests/get-pending-following-requests}
         */
        following: TraktClientEndpoint<TraktApiParamsExtended<"full">, TraktUserFollowRequest, true>;
        /**
         * List a user's pending follow requests so they can either approve or deny them.
         *
         * @extended true - {@link TraktApiExtended.Full}
         * @auth required
         *
         * @see [get-follow-requests]{@link https://trakt.docs.apiary.io/#reference/users/follower-requests/get-follow-requests}
         */
        follower: TraktClientEndpoint<TraktApiParamsExtended<"full">, TraktUserFollowRequest, true>;
        /**
         * List a user's pending follow requests so they can either approve or deny them.
         *
         * @auth required
         *
         * @see [approve-follow-request]{@link https://trakt.docs.apiary.io/#reference/users/approve-or-deny-follower-requests/approve-follow-request}
         */
        approve: TraktClientEndpoint<{
            /** ID of the follower request. */
            id: number;
        }, TraktUserFollower, false>;
        /**
         * Deny a follower using the id of the request. If the id is not found, was already approved, or was already denied, a 404 error will be returned.
         *
         * @auth required
         *
         * @see [deny-follow-request]{@link https://trakt.docs.apiary.io/#reference/users/approve-or-deny-follower-requests/deny-follow-request}
         */
        deny: TraktClientEndpoint<{
            /** ID of the follower request. */
            id: number;
        }, unknown, false>;
        /**
         * Get all saved filters a user has created.
         * The path and query can be used to construct an API path to retrieve the saved data.
         * Think of this like a dynamically updated list.
         *
         * @pagination true - {@link TraktApiPagination}
         * @vip required - [Requires a paid VIP subscription]{@link https://trakt.docs.apiary.io/#introduction/vip-methods}
         * @auth required
         *
         * @see [get-saved-filters]{@link https://trakt.docs.apiary.io/#reference/users/saved-filters/get-saved-filters}
         */
        savedFilters: TraktClientEndpoint<{
            section?: 'movies' | 'shows' | 'calendar' | 'search';
        } & TraktApiParamsPagination, TraktUserFilter[], true>;
        hidden: {
            /**
             * Get hidden items for a section.
             * This will return an array of standard media objects.
             * You can optionally limit the type of results to return.
             *
             * @pagination true - {@link TraktApiPagination}
             * @extended true - {@link TraktApiExtended.Full}
             * @auth required
             *
             * @see [get-hidden-items]{@link https://trakt.docs.apiary.io/#reference/users/hidden-items/get-hidden-items}
             */
            get: TraktClientEndpoint<{
                /** Mandatory section name */
                section: 'calendar' | 'progress_watched' | 'progress_watched_reset' | 'progress_collected' | 'recommendations' | 'comments';
                /** Narrow down by element type. */
                type?: 'movie' | 'show' | 'season' | 'user';
            } & TraktApiParamsExtended<"full"> & TraktApiParamsPagination, TraktUserHiddenItem[], true>;
            /**
             * Hide items for a specific section. Here's what type of items can hidden for each section.
             *
             * @auth required
             *
             * @see [add-hidden-items]{@link https://trakt.docs.apiary.io/#reference/users/add-hidden-items/add-hidden-items}
             */
            add: TraktClientEndpoint<TraktUserHiddenRequest, TraktUserHiddenAdded, false>;
            /**
             * Un-hide items for a specific section. Here's what type of items can unhidden for each section.
             *
             * @auth required
             *
             * @see [remove-hidden-items]{@link https://trakt.docs.apiary.io/#reference/users/remove-hidden-items/remove-hidden-items}
             */
            remove: TraktClientEndpoint<TraktUserHiddenRequest, TraktUserHiddenDeleted, false>;
        };
        /**
         * Get a user's profile information. If the user is private, info will only be returned if you send OAuth and are either that user or an approved follower.
         * Adding ?extended=vip will return some additional VIP related fields so you can display the user's Trakt VIP status and year count.
         *
         * @extended true - {@link TraktApiExtended.Vip}, {@link TraktApiExtended.Full}
         * @auth optional
         *
         * @see [get-user-profile]{@link https://trakt.docs.apiary.io/#reference/users/profile/get-user-profile}
         */
        profile: TraktClientEndpoint<{
            /** User slug */
            id: string;
        } & TraktApiParamsExtended<"vip" | "full">, TraktPrivateUser & {
            name: string;
            vip: boolean;
            vip_ep: boolean;
        } & Partial<TraktPrivateUser & {
            name: string;
            vip: boolean;
            vip_ep: boolean;
        } & {
            joined_at: string;
            location: string;
            about: string;
            gender: string;
            age: number;
            images: {
                avatar: {
                    full: string;
                };
            };
        } & {
            vi_og: boolean;
            vip_years: number;
            vip_cover_image: string;
        }>, true>;
        /**
         * Get items a user likes.
         * This will return an array of standard media objects.
         * You can optionally limit the type of results to return.
         *
         * * <b>Comment Media Objects</b>
         *
         * If you add ?extended=comments to the URL, it will return media objects for each comment like.
         *
         * * <b>Note</b>
         *
         * This returns a lot of data, so please only use this extended parameter if you actually need it!
         *
         * @extended true - {@link TraktApiExtended.Comments}
         * @pagination true - {@link TraktApiPagination}
         * @auth optional
         *
         * @see [get-likes]{@link https://trakt.docs.apiary.io/#reference/users/likes/get-likes}
         */
        likes: TraktClientEndpoint<{
            /** User slug */
            id: string;
            type?: 'comments' | 'lists';
        } & TraktApiParamsExtended<"comments">, {
            liked_at: string;
            type: "comment";
            comment: TraktComment;
        } | ({
            liked_at: string;
            type: "comment";
            comment: TraktComment;
        } & {
            comment_type: "movie" | "show" | "episode" | "season" | "list";
        } & Omit<TraktCommentMedia<"any">, "type">), true>;
        /**
         * Get all collected items in a user's collection. A collected item indicates availability to watch digitally or on physical media.
         *
         * Each movie object contains collected_at and updated_at timestamps.
         * Since users can set custom dates when they collected movies, it is possible for collected_at to be in the past.
         * We also include updated_at to help sync Trakt data with your app.
         * Cache this timestamp locally and only re-process the movie if you see a newer timestamp.
         *
         * Each show object contains last_collected_at and last_updated_at timestamps.
         * Since users can set custom dates when they collected episodes, it is possible for last_collected_at to be in the past. We also include last_updated_at to help sync Trakt data with your app.
         * Cache this timestamp locally and only re-process the show if you see a newer timestamp.
         *
         * If you add ?extended=metadata to the URL, it will return the additional media_type, resolution, hdr, audio, audio_channels and '3d' metadata.
         * It will use null if the metadata isn't set for an item.
         *
         * @extended true - {@link TraktApiExtended.Full}, {@link TraktApiExtended.Metadata}
         * @auth optional
         *
         * @see [get-collection]{@link https://trakt.docs.apiary.io/#reference/users/collection/get-collection}
         */
        collection: TraktClientEndpoint<{
            /** User slug */
            id: string;
            type: 'movies' | 'shows';
        } & TraktApiParamsExtended<"full" | "metadata">, (({
            collected_at: string;
            updated_at: string;
            movie: TraktMovieShort & Partial<TraktMovieExtended>;
        } & {
            metadata?: TraktCollectionMetadata;
        }) | {
            last_collected_at: string;
            last_updated_at: string;
            show: TraktShowShort & Partial<TraktShowExtended>;
            seasons: TraktCollectionSeason<"any">[];
        })[], true>;
        /**
         * Returns the most recently written comments for the user.
         * You can optionally filter by the comment_type and media type to limit what gets returned.
         *
         * By default, only top level comments are returned. Set ?include_replies=true to return replies in addition to top level comments.
         * Set ?include_replies=only to return only replies and no top level comments.
         *
         * @pagination true - {@link TraktApiPagination}
         * @extended true - {@link TraktApiExtended.Full}
         *
         * @see [get-comments]{@link https://trakt.docs.apiary.io/#reference/users/comments/get-comments}
         */
        comments: TraktClientEndpoint<{
            /** User slug */
            id: string;
            comment_type?: 'all' | 'reviews' | 'shouts';
            type?: 'all' | 'movies' | 'shows' | 'seasons' | 'episodes' | 'lists';
            include_replies?: boolean | 'only';
        } & TraktApiParamsExtended<"full"> & TraktApiParamsPagination, TraktCommentItem[], true>;
    };
    /**
     * Returns the most recently notes for the user.
     * You can optionally filter by media type to limit what gets returned.
     * Use the attached_to info to know what the note is actually added to.
     * Media items like movie, show, season, episode, or person are straightforward, but history will need to be mapped to that specific play in their watched history since they might have multiple plays.
     * Since collection and rating is a 1:1 association, you can assume the note is attached to the media item in the type field that has been collected or rated.
     *
     * @vip required - [Requires a paid VIP subscription]{@link https://trakt.docs.apiary.io/#introduction/vip-methods}
     * @pagination true - {@link TraktApiPagination}
     * @extended true - {@link TraktApiExtended.Full}
     * @auth optional
     *
     * @see [get-notes]{@link https://trakt.docs.apiary.io/#reference/users/notes/get-notes}
     */
    notes: TraktClientEndpoint<{
        /** User slug */
        id: string;
        type?: 'all' | TraktNoteTypes;
    } & TraktApiParamsExtended<"full"> & TraktApiParamsPagination, TraktNoteItem[], true>;
    lists: {
        /**
         * Returns all personal lists for a user.
         * Use the [/users/:id/lists/:list_id/items]{@link https://trakt.docs.apiary.io/#reference/users/list-items} method to get the actual items a specific list contains.
         *
         * @emoji true - [documentation]{@link https://trakt.docs.apiary.io/#introduction/emojis}
         * @auth optional
         *
         * @see [get-a-user's-personal-lists]{@link https://trakt.docs.apiary.io/#reference/users/lists/get-a-user's-personal-lists}
         */
        get: TraktClientEndpoint<{
            /** User slug */
            id: string;
        }, TraktList[], true>;
        /**
         * Create a new personal list. The name is the only required field, but the other info is recommended to ask for.
         *
         * * <b>Limits</b>
         *
         * If the user's list limit is exceeded, a 420 HTTP error code is returned.
         * Use the [/users/settings]{@link https://trakt.docs.apiary.io/reference/users/settings} method to get all limits for a user account.
         * In most cases, upgrading to [Trakt VIP]{@link https://trakt.tv/vip} will increase the limits.
         *
         * * <b>Privacy</b>
         *
         * Lists will be private by default. Here is what each value means.
         *
         * * private - Only you can see the list.
         * * link - Anyone with the share_link can see the list.
         * * friends - Only your friends can see the list.
         * * public - Anyone can see the list.
         *
         * @vip enhanced - [Enhanced by a paid VIP subscription]{@link https://trakt.docs.apiary.io/#introduction/vip-methods}
         * @auth required
         *
         * @see [create-personal-list]{@link https://trakt.docs.apiary.io/#reference/users/lists/create-personal-list}
         */
        create: TraktClientEndpoint<{
            /** User slug */
            id: string;
            /** Name of the list. */
            name: string;
            /** Description for this list. */
            description?: string;
            /**
             * Privacy setting for this list:
             *
             * * private - Only you can see the list.
             * * link - Anyone with the share_link can see the list.
             * * friends - Only your friends can see the list.
             * * public - Anyone can see the list.
             */
            privacy?: 'private' | 'link' | 'friends' | 'public';
            /** Should each item be numbered? */
            display_numbers?: boolean;
            /** Are comments allowed? */
            allow_comments?: boolean;
            sort_by?: 'rank' | 'added' | 'title' | 'released' | 'runtime' | 'popularity' | 'percentage' | 'votes' | 'my_rating' | 'random' | 'watched' | 'collected';
            sort_how?: 'asc' | 'desc';
        }, TraktList, false>;
        /**
         * Reorder all lists by sending the updated rank of list ids. Use the [/users/:id/lists]{@link https://trakt.docs.apiary.io/#reference/users/lists} method to get all list ids.
         *
         * @auth required
         *
         * @see [reorder-a-user's-lists]{@link https://trakt.docs.apiary.io/#reference/users/reorder-lists/reorder-a-user's-lists}
         */
        reorder: TraktClientEndpoint<{
            /** User slug */
            id: string;
            /** Array of list ids in the new order. */
            rank: number[];
        }, Omit<TraktListReordered, "list">, false>;
        /**
         * Returns all lists a user can collaborate on.
         * This gives full access to add, remove, and re-order list items.
         * It essentially works just like a list owned by the user, just make sure to use the correct list owner user when building the API URLs.
         *
         * @auth optional
         *
         * @see [get-all-lists-a-user-can-collaborate-on]{@link https://trakt.docs.apiary.io/#reference/users/collaborations/get-all-lists-a-user-can-collaborate-on}
         */
        collaborations: TraktClientEndpoint<{
            /** User slug */
            id: string;
        }, TraktList[], true>;
    };
    list: {
        /**
         * Returns a single personal list. Use the [/users/:id/lists/:list_id/items]{@link https://trakt.docs.apiary.io/#reference/users/list-items} method to get the actual items this list contains.
         *
         * @emoji true - [documentation]{@link https://trakt.docs.apiary.io/#introduction/emojis}
         * @auth optional
         *
         * @see [get-personal-list]{@link https://trakt.docs.apiary.io/#reference/users/list/get-personal-list}
         */
        get: TraktClientEndpoint<{
            /** User slug */
            id: string;
            /** List Trakt ID or Trakt slug */
            list_id: string;
        }, TraktList[], true>;
        /**
         * Update a personal list by sending 1 or more parameters.
         * If you update the list name, the original slug will still be retained so existing references to this list won't break.
         *
         * * <b>Privacy</b>
         *
         * Lists will be private by default. Here is what each value means.
         *
         * * private - Only you can see the list.
         * * link - Anyone with the share_link can see the list.
         * * friends - Only your friends can see the list.
         * * public - Anyone can see the list.
         *
         * @auth required
         *
         * @see [update-personal-list]{@link https://trakt.docs.apiary.io/#reference/users/list/update-personal-list}
         */
        update: TraktClientEndpoint<{
            /** User slug */
            id: string;
            /** List Trakt ID or Trakt slug */
            list_id: string;
            /** Name of the list. */
            name?: string /**
             * Privacy setting for this list:
             *
             * * private - Only you can see the list.
             * * link - Anyone with the share_link can see the list.
             * * friends - Only your friends can see the list.
             * * public - Anyone can see the list.
             */;
            privacy?: 'private' | 'link' | 'friends' | 'public';
            /** Should each item be numbered? */
            display_numbers?: boolean;
            sort_by?: 'rank' | 'added' | 'title' | 'released' | 'runtime' | 'popularity' | 'percentage' | 'votes' | 'my_rating' | 'random' | 'watched' | 'collected';
            sort_how?: 'asc' | 'desc';
        }, TraktList, false>;
        /**
         * Remove a personal list and all items it contains.
         *
         * @auth required
         *
         * @see [delete-a-user's-personal-list]{@link https://trakt.docs.apiary.io/#reference/users/list/delete-a-user's-personal-list}
         */
        delete: TraktClientEndpoint<{
            /** User slug */
            id: string;
            /** List Trakt ID or Trakt slug */
            list_id: string;
        }, unknown, false>;
        /**
         * Returns all users who liked a list.
         *
         * @pagination true - {@link TraktApiPagination}
         * @auth optional
         *
         * @see [get-all-users-who-liked-a-list]{@link https://trakt.docs.apiary.io/#reference/users/list-likes/get-all-users-who-liked-a-list}
         */
        likes: TraktClientEndpoint<{
            /** User slug */
            id: string;
            /** List Trakt ID or Trakt slug */
            list_id: string;
        }, TraktLike[], true>;
        like: {
            /**
             * Votes help determine popular lists. Only one like is allowed per list per user.
             *
             * @auth required
             *
             * @see [like-a-list]{@link https://trakt.docs.apiary.io/#reference/users/list-like/like-a-list}
             */
            add: TraktClientEndpoint<{
                /** User slug */
                id: string;
                /** List Trakt ID or Trakt slug */
                list_id: string;
            }, unknown, false>;
            /**
             * Remove a like on a list.
             *
             * @auth required
             *
             * @see [remove-like-on-a-list]{@link https://trakt.docs.apiary.io/#reference/users/list-like/remove-like-on-a-list}
             */
            remove: TraktClientEndpoint<{
                /** User slug */
                id: string;
                /** List Trakt ID or Trakt slug */
                list_id: string;
            }, unknown, false>;
        };
        /**
         * Get all items on a personal list.
         * Items can be a movie, show, season, episode, or person.
         * You can optionally specify the type parameter with a single value or comma delimited string for multiple item types.
         *
         * * <b>Notes</b>
         *
         * Each list item contains a notes field with text entered by the user.
         *
         * *<b>Sorting Headers</b>
         *
         * All list items are sorted by ascending rank. We also send X-Sort-By and X-Sort-How headers which can be used to custom sort the list <b>in your app</b> based on the user's preference.
         * Values for X-Sort-By include rank, added, title, released, runtime, popularity, percentage, votes, my_rating, random, watched, and collected.
         * Values for X-Sort-How include asc and desc.
         *
         * @pagination optional - {@link TraktApiPagination}
         * @extended true - {@link TraktApiExtended.Full}
         * @emoji true - [documentation]{@link https://trakt.docs.apiary.io/#introduction/emojis}
         * @auth optional
         *
         * @see [get-items-on-a-personal-list]{@link https://trakt.docs.apiary.io/#reference/users/list-items/get-items-on-a-personal-list}
         */
        items: {
            get: TraktClientEndpoint<TraktListItemsGetQuery, TraktListItem[], true>;
            /**
             * Add one or more items to a personal list. Items can be movies, shows, seasons, episodes, or people.
             *
             * * <b>Notes</b>
             *
             * Each list item can optionally accept a notes (500 maximum characters) field with custom text.
             * The user must be a [Trakt VIP]{@https://trakt.tv/vip} to send notes.
             *
             * * <b>Limits</b>
             *
             * If the user's list item limit is exceeded, a 420 HTTP error code is returned. Use the [/users/settings]{@link https://trakt.docs.apiary.io/reference/users/settings} method to get all limits for a user account.
             * In most cases, upgrading to [Trakt VIP]{@https://trakt.tv/vip}  will increase the limits.
             *
             * @vip enhanced - [Enhanced by a paid VIP subscription]{@link https://trakt.docs.apiary.io/#introduction/vip-methods}
             * @emoji true - [documentation]{@link https://trakt.docs.apiary.io/#introduction/emojis}
             * @auth required
             *
             * @see [add-items-to-personal-list]{@link https://trakt.docs.apiary.io/#reference/users/add-list-items/add-items-to-personal-list}
             */
            add: TraktClientEndpoint<TraktUserListItemAddedRequest, TraktUserListItemAdded, false>;
            /**
             * Remove one or more items from a personal list.
             *
             * @auth required
             *
             * @see [remove-items-from-personal-list]{@link https://trakt.docs.apiary.io/#reference/users/remove-list-items/remove-items-from-personal-list}
             */
            remove: TraktClientEndpoint<TraktUserListItemRemoveRequest, TraktUserListItemRemoved, false>;
            /**
             * Reorder all items on a list by sending the updated rank of list item ids. Use the [/users/:id/lists/:list_id/items]{@link https://trakt.docs.apiary.io/#reference/users/list-items} method to get all list item ids.
             *
             * @auth required
             *
             * @see [reorder-items-on-a-list]{@link https://trakt.docs.apiary.io/#reference/users/reorder-list-items/reorder-items-on-a-list}
             */
            reorder: TraktClientEndpoint<{
                /** User slug */
                id: string;
                /** List Trakt ID or Trakt slug */
                list_id: string;
                /** Array of list item ids in the new order. */
                rank: number[];
            }, TraktListReordered, false>;
            /**
             * Update the notes on a single list item.
             *
             * @vip required - [Requires a paid VIP subscription]{@link https://trakt.docs.apiary.io/#introduction/vip-methods}
             * @emoji true - [documentation]{@link https://trakt.docs.apiary.io/#introduction/emojis}
             * @auth required
             *
             * @see [update-list-item/update-a-list-item]{@link https://trakt.docs.apiary.io/#reference/users/update-list-item/update-a-list-item}
             */
            update: TraktClientEndpoint<{
                /** User slug */
                id: string;
                /** List Trakt ID or Trakt slug */
                list_id: string;
                /** List item ID */
                list_item_id: string;
                /** List item notes */
                notes: string;
            }, unknown, false>;
        };
        /**
         * Returns all top level comments for a list. By default, the newest comments are returned first.
         * Other sorting options include oldest, most likes, and most replies.
         *
         * * <b>Notes</b>
         *
         * If you send OAuth, comments from blocked users will be automatically filtered out.
         *
         * @pagination true - {@link TraktApiPagination}
         * @emoji true - [documentation]{@link https://trakt.docs.apiary.io/#introduction/emojis}
         * @auth optional
         *
         * @see [get-all-list-comments]{@link https://trakt.docs.apiary.io/#reference/users/list-comments/get-all-list-comments}
         */
        comments: TraktClientEndpoint<{
            /** User slug */
            id: string;
            /** List Trakt ID or Trakt slug */
            list_id: string;
            /** How to sort the comments */
            sort?: 'newest' | 'oldest' | 'likes' | 'replies';
        } & TraktApiParamsPagination, TraktComment[], true>;
    };
    follow: {
        /**
         * If the user has a private profile, the follow request will require approval (approved_at will be null).
         * If a user is public, they will be followed immediately (approved_at will have a date).
         *
         * * <b>Notes</b>
         *
         * If this user is already being followed, a 409 HTTP status code will returned.
         *
         * @auth required
         *
         * @see [follow-this-user]{@link https://trakt.docs.apiary.io/#reference/users/follow/follow-this-user}
         */
        add: TraktClientEndpoint<{
            /** User slug */
            id: string;
        }, TraktUserFollow, false>;
        /**
         * Unfollow someone you already follow.
         *
         * @auth required
         *
         * @see [unfollow-this-user]{@link https://trakt.docs.apiary.io/#reference/users/follow/unfollow-this-user}
         */
        remove: TraktClientEndpoint<{
            /** User slug */
            id: string;
        }, unknown, false>;
    };
    /**
     * Returns all followers including when the relationship began.
     *
     * @extended true - {@link TraktApiExtended.Full}
     * @auth optional
     *
     * @see [get-followers]{@link https://trakt.docs.apiary.io/#reference/users/followers/get-followers}
     */
    followers: TraktClientEndpoint<{
        /** User slug */
        id: string;
    } & TraktApiParamsExtended<"full">, TraktUserFollower[], true>;
    /**
     * Returns all user's they follow including when the relationship began.
     *
     * @extended true - {@link TraktApiExtended.Full}
     * @auth optional
     *
     * @see [get-following]{@link https://trakt.docs.apiary.io/#reference/users/following/get-following}
     */
    following: TraktClientEndpoint<{
        /** User slug */
        id: string;
    } & TraktApiParamsExtended<"full">, TraktUserFollowing[], true>;
    /**
     * Returns all friends for a user including when the relationship began. Friendship is a 2 way relationship where each user follows the other.
     *
     * @extended true - {@link TraktApiExtended.Full}
     * @auth optional
     *
     * @see [get-friends]{@link https://trakt.docs.apiary.io/#reference/users/friends/get-friends}
     */
    friends: TraktClientEndpoint<{
        /** User slug */
        id: string;
    } & TraktApiParamsExtended<"full">, TraktUserFriend[], true>;
    /**
     * Returns movies and episodes that a user has watched, sorted by most recent.
     * You can optionally limit the type to movies or episodes.
     * The id (64-bit integer) in each history item uniquely identifies the event and can be used to remove individual events by using the [/sync/history/remove]{@link https://trakt.docs.apiary.io/#reference/sync/remove-from-history/get-watched-history} method.
     * The action will be set to scrobble, checkin, or watch.
     *
     * Specify a type and trakt item_id to limit the history for just that item.
     * If the item_id is valid, but there is no history, an empty array will be returned.
     *
     * @pagination true - {@link TraktApiPagination}
     * @extended true - {@link TraktApiExtended.Full}
     * @auth optional
     *
     * @see [get-watched-history]{@link https://trakt.docs.apiary.io/#reference/users/history/get-watched-history}
     */
    history: TraktClientEndpoint<{
        /** User slug */
        id: string;
        /** Type of history items */
        type?: 'movies' | 'shows' | 'seasons' | 'episodes';
        /** Trakt ID for a specific item. */
        item_id?: string;
        /** Timestamp in ISO 8601 GMT format (YYYY-MM-DD'T'hh:mm:ss.sssZ) */
        start_at?: string;
        /** Timestamp in ISO 8601 GMT format (YYYY-MM-DD'T'hh:mm:ss.sssZ) */
        end_at?: string;
    } & TraktApiParamsExtended<"full"> & TraktApiParamsPagination, TraktHistory[], true>;
    /**
     * Get a user's ratings filtered by type.
     * You can optionally filter for a specific rating between 1 and 10.
     * Send a comma separated string for rating if you need multiple ratings.
     *
     * @pagination optional - {@link TraktApiPagination}
     * @auth optional
     *
     * @see [get-ratings]{@link https://trakt.docs.apiary.io/#reference/users/ratings/get-ratings}
     */
    ratings: TraktClientEndpoint<{
        /** User slug */
        id: string;
        /** Type of ratings */
        type?: 'movies' | 'shows' | 'seasons' | 'episodes' | 'all';
        /** Rating between 1 and 10 */
        rating?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
    } & TraktApiParamsPagination & TraktApiParamsExtended<"full">, TraktRating[], true>;
    watchlist: {
        /**
         * Returns all items in a user's watchlist filtered by type.
         *
         * * <b>Notes</b>
         *
         * Each watchlist item contains a notes field with text entered by the user.
         *
         * * <b>Sorting Headers</b>
         *
         * By default, all list items are sorted by rank asc.
         * We send X-Applied-Sort-By and X-Applied-Sort-How headers to indicate how the results are actually being sorted.
         *
         * We also send X-Sort-By and X-Sort-How headers which indicate the user's sort preference.
         * Use these to to custom sort the watchlist <b>in your app</b> for more advanced sort abilities we can't do in the API.
         * Values for X-Sort-By include rank, added, title, released, runtime, popularity, percentage, and votes.
         * Values for X-Sort-How include asc and desc.
         *
         * * <b>Auto Removal</b>
         *
         * When an item is watched, it will be automatically removed from the watchlist.
         * For shows and seasons, watching 1 episode will remove the entire show or season.
         *
         * <b>The watchlist should not be used as a list of what the user is actively watching.</b>
         *
         * Use a combination of the [/sync/watched]{@link https://trakt.docs.apiary.io/reference/sync/get-watched} and [/shows/:id/progress]{@link https://trakt.docs.apiary.io/reference/shows/watched-progress} methods to get what the user is actively watching.
         *
         * @pagination optional - {@link TraktApiPagination}
         * @extended true - {@link TraktApiExtended.Full}
         * @emoji true - [documentation]{@link https://trakt.docs.apiary.io/#introduction/emojis}
         * @auth optional
         *
         * @see [get-watchlist]{@link https://trakt.docs.apiary.io/#reference/users/watchlist/get-watchlist}
         */
        get: TraktClientEndpoint<{
            /** User slug */
            id: string;
            /** Filter for a specific item type */
            type?: 'movies' | 'shows' | 'seasons' | 'episodes';
            /** How to sort the watchlist (only if type is also sent) */
            sort?: 'rank' | 'added' | 'released' | 'title';
        } & TraktApiParamsExtended<"full"> & TraktApiParamsPagination, TraktWatchlist[], true>;
        /**
         * Returns all top level comments for the watchlist. By default, the newest comments are returned first.
         * Other sorting options include oldest, most likes, and most replies.
         *
         * * <b>Notes</b>
         *
         * If you send OAuth, comments from blocked users will be automatically filtered out.
         *
         * @pagination true - {@link TraktApiPagination}
         * @emoji true - [documentation]{@link https://trakt.docs.apiary.io/#introduction/emojis}
         * @auth optional
         *
         * @see [get-all-favorites-comments]{@link https://trakt.docs.apiary.io/#reference/users/watchlist-comments/get-all-favorites-comments}
         */
        comments: TraktClientEndpoint<{
            /** User slug */
            id: string;
            /** How to sort the comments */
            sort?: 'newest' | 'oldest' | 'likes' | 'replies';
        } & TraktApiParamsPagination, TraktComment[], true>;
    };
    /**
     * Returns the top 50 items a user has favorited.
     * These favorites are used to enchance Trakt's social recommendation algorithm.
     * Apps should encourage user's to add favorites so the algorithm keeps getting better.
     *
     * * <b>Notes</b>
     *
     * Each favorite contains a notes field explaining why the user favorited the item.
     *
     * @pagination optional - {@link TraktApiPagination}
     * @extended true - {@link TraktApiExtended.Full}
     * @emoji true - [documentation]{@link https://trakt.docs.apiary.io/#introduction/emojis}
     * @auth required
     *
     * @see [get-favorites]{@link https://trakt.docs.apiary.io/#reference/users/favorites/get-favorites}
     */
    favorites: TraktClientEndpoint<{
        /** User slug */
        id: string;
        /** Type of favorites */
        type?: 'movies' | 'shows';
        /** How to sort the favorites (only if type is also sent) */
        sort?: 'rank' | 'added' | 'released' | 'title';
    } & TraktApiParamsExtended<"full"> & TraktApiParamsPagination, (TraktListItem<"movie"> | TraktListItem<"show">)[], true>;
    /**
     * Returns a movie or episode if the user is currently watching something.
     * If they are not, it returns no data and a 204 HTTP status code.
     *
     * @extended true - {@link TraktApiExtended.Full}
     * @auth optional
     *
     * @see [get-watching]{@link https://trakt.docs.apiary.io/#reference/users/watching/get-watching}
     */
    watching: TraktClientEndpoint<{
        /** User slug */
        id: string;
    } & TraktApiParamsExtended<"full">, TraktWatching, true>;
    /**
     * Returns all movies or shows a user has watched sorted by most plays.
     *
     * If type is set to shows and you add ?extended=noseasons to the URL, it won't return season or episode info.
     *
     * Each movie and show object contains last_watched_at and last_updated_at timestamps.
     * Since users can set custom dates when they watched movies and episodes, it is possible for last_watched_at to be in the past. We also include last_updated_at to help sync Trakt data with your app.
     * Cache this timestamp locally and only re-process the movies and shows if you see a newer timestamp.
     *
     * Each show object contains a reset_at timestamp. If not null, this is when the user started re-watching the show.
     * Your app can adjust the progress by ignoring episodes with a last_watched_at prior to the reset_at.
     *
     * @extended true - {@link TraktApiExtended.Full}, {@link TraktApiExtended.NoSeasons}
     * @auth optional
     *
     * @see [get-watched]{@link https://trakt.docs.apiary.io/#reference/users/watched/get-watched}
     */
    watched: TraktClientEndpoint<{
        /** User slug */
        id: string;
        /** Type of watched items */
        type?: 'movies' | 'shows';
    } & TraktApiParamsExtended<"full" | "noseasons">, TraktWatched[], true>;
    /**
     * Returns stats about the movies, shows, and episodes a user has watched, collected, and rated.
     *
     * @auth optional
     *
     * @see [get-stats]{@link https://trakt.docs.apiary.io/#reference/users/stats/get-stats}
     */
    stats: TraktClientEndpoint<{
        /** User slug */
        id: string;
    }, TraktStats, true>;
};

export { users };