dbots/src/Interface/Lists/Radarcord.ts

Discord bot list poster and stats retriever

import { Service, ServicePostOptions } from '../Service'
import { Util, IDResolvable } from '../../Utils/Util'

/**
 * Represents the Radarcord service (formerly Radar Bot Directory).
 * @see https://docs.radarcord.net/
 */
export default class Radarcord extends Service {
  /** The values that can be used to select the service. */
  static get aliases() {
    return [
      'radar',
      'radarbots',
      'radarbotdirectory.xyz',
      'radarcord',
      'radarcord.net'
    ]
  }

  /** The logo URL. */
  static get logoURL() {
    return 'https://radarcord.net/static/logo.png'
  }

  /** Service's name. */
  static get serviceName() {
    return 'Radarcord'
  }

  /** The website URL. */
  static get websiteURL() {
    return 'https://radarcord.net/'
  }

  /** The base URL of the service's API. */
  static get baseURL() {
    return 'https://api.radarcord.net'
  }

  /**
   * Posts statistics to this service.
   * @param options The options of the request
   */
  static post(options: ServicePostOptions) {
    const { token, clientID, serverCount, shard } = options
    return super._post({
      method: 'post',
      url: `/bot/${Util.resolveID(clientID)}/stats/`,
      headers: { Authorization: token },
      data: shard
        ? {
            guilds: Util.resolveCount(serverCount),
            shards: shard.count
          }
        : { guilds: Util.resolveCount(serverCount) }
    })
  }

  /**
   * Gets the bot listed on this service.
   * @param id The bot's ID
   */
  getBot(id: IDResolvable) {
    return this._request({ url: `/bot/${Util.resolveID(id)}` })
  }

  /**
   * Gets the Unix Epoch Timestamp of the last time this user voted for this bot on this service.
   * @param botID The bot's ID
   * @param userID The user's ID
   */
  getBotVotes(botID: IDResolvable, userID: IDResolvable) {
    return this._request(
      {
        url: `/lastvoted/${Util.resolveID(userID)}/${Util.resolveID(botID)}`,
        headers: { Authorization: this.token }
      },
      {
        requiresToken: true
      }
    )
  }

  /**
   * Gets the bot's reviews on this service.
   * @param id The bot's ID
   */
  getBotReviews(id: IDResolvable) {
    return this._request({ url: `/bot/${Util.resolveID(id)}/reviews` })
  }
}