better-trakt/src/users/index.ts

A Trakt.tv client with native Typescript support and quality of life features

import { ApiConfig, ApiNamespace } from '../client';
import { WatchedMovie, WatchedShow } from '../trakt';
import { fetch, checkRequiredArg, ApiResponse } from '../utils';

/**
 * Users api namespace
 */
export class Users implements ApiNamespace {
  config: ApiConfig;

  constructor(config: ApiConfig) {
    this.config = {
      apiUrl: `${config.apiUrl}/users`,
      client: config.client,
    };
  }

  /**
   * Returns all movies a user has watched sorted by most plays.
   * @param client axios
   * @param userId trakt user id
   * @param accessToken oauth access token for private accounts
   * @returns
   */
  watchedMovies({
    userId,
    accessToken,
  }: {
    userId: string;
    accessToken?: string;
  }): Promise<ApiResponse<WatchedMovie[]>> {
    checkRequiredArg(userId, 'userId', 'string');

    return getUserWatchedMedia<WatchedMovie[]>(this.config, userId, 'movies', accessToken);
  }

  /**
   * Returns all shows a user has watched sorted by most plays.
   * @param client axios
   * @param userId trakt user id
   * @param accessToken oauth access token for private accounts
   * @returns
   */
  watchedShows({ userId, accessToken }: { userId: string; accessToken?: string }): Promise<ApiResponse<WatchedShow[]>> {
    checkRequiredArg(userId, 'userId', 'string');

    return getUserWatchedMedia<WatchedShow[]>(this.config, userId, 'shows', accessToken);
  }
}

export async function getUserWatchedMedia<T>(
  { client, apiUrl }: ApiConfig,
  userId: string,
  type: 'movies' | 'shows',
  accessToken?: string,
) {
  const url = `${apiUrl}/${userId}/watched/${type}`;
  const response = await fetch<T>(client, url, { accessToken });

  return response;
}