Steam Model JS Documentation

How to use

const steamSystem = initSteamSystem();

SteamSystem

class SteamSystem {
  constructor(games, developers, tags, users) {
    this.games = games;       // Array of Game objects
    this.developers = developers; // Array of Developer objects
    this.tags = tags;         // Array of Tag objects
    this.users = users;       // Array of User objects
  }

  /**
   * Add a new user to the system.
   *
   * @param {DraftUser} user - The user to add.
   * @returns {User} The newly created user.
   * @throws {UserException} If the email address is already in use.
   */
  addNewUser(user) {}

  /**
   * Get a tag by its ID.
   *
   * @param {string} id - The ID of the tag.
   * @returns {Tag} The tag with the given ID.
   * @throws {NotFoundTag} If the tag with the given ID does not exist.
   */
  getTag(id) {}

  /**
   * Get a user by its ID.
   *
   * @param {string} id - The ID of the user.
   * @returns {User} The user with the given ID.
   * @throws {NotFoundUser} If the user with the given ID does not exist.
   */
  getUser(id) {}

  /**
   * Get a game by its ID.
   *
   * @param {string} id - The ID of the game.
   * @returns {Game} The game with the given ID.
   * @throws {NotFoundGame} If the game with the given ID does not exist.
   */
  getGame(id) {}

  /**
   * Get a developer by its ID.
   *
   * @param {string} id - The ID of the developer.
   * @returns {Developer} The developer with the given ID.
   * @throws {NotFoundDeveloper} If the developer with the given ID does not exist.
   */
  getDeveloper(id) {}

  /**
   * Get the reviews written by the user with the given ID.
   *
   * @param {string} userId - The ID of the user.
   * @returns {Array<Review>} The list of reviews written by the user.
   * @throws {NotFoundUser} If the user with the given ID does not exist.
   */
  getUserReviews(userId) {}

  /**
   * Get a list of recommended games.
   *
   * The recommended games are the games that have the most reviews that are marked as recommended.
   *
   * @returns {Array<Game>} A list of recommended games.
   */
  getRecommendedGames() {}

  /**
   * Get a list of games.
   *
   * @param {number} page - The page number. Default is 1.
   * @returns {PageInfo<Game>} A list of games with pagination info.
   * @throws {PageException} If the page number is less than 1.
   */
  getGames(page = 1) {}

  /**
   * Get a list of games by tag.
   *
   * @param {string} tagId - The ID of the tag.
   * @param {number} page - The page number. Default is 1.
   * @returns {PageInfo<Game>} A list of games with pagination info.
   * @throws {NotFoundTag} If the tag with the given ID does not exist.
   * @throws {PageException} If the page number is less than 1.
   */
  getGamesByTag(tagId, page = 1) {}

  /**
   * Get a list of games by developer.
   *
   * @param {string} developerId - The ID of the developer.
   * @param {number} page - The page number. Default is 1.
   * @returns {PageInfo<Game>} A list of games with pagination info.
   * @throws {NotFoundDeveloper} If the developer with the given ID does not exist.
   * @throws {PageException} If the page number is less than 1.
   */
  getGamesByDeveloper(developerId, page = 1) {}

  /**
   * Search for games by name.
   *
   * @param {string} name - The name of the game.
   * @param {number} page - The page number. Default is 1.
   * @returns {PageInfo<Game>} A list of games with pagination info.
   * @throws {PageException} If the page number is less than 1.
   */
  searchGame(name, page = 1) {}

  /**
   * Search for users by name.
   *
   * @param {string} name - The name of the user.
   * @param {number} page - The page number. Default is 1.
   * @returns {PageInfo<User>} A list of users with pagination info.
   * @throws {PageException} If the page number is less than 1.
   */
  searchUser(name, page = 1) {}

  /**
   * Add a review for a game.
   *
   * @param {string} userId - The ID of the user who is submitting the review.
   * @param {DraftReview} draftReview - The draft review object.
   * @returns {Game} The game that was reviewed.
   * @throws {NotFoundUser} If the user with the given ID does not exist.
   * @throws {NotFoundGame} If the game with the given ID does not exist.
   * @throws {ReviewException} If the user does not own the game or if the user has already submitted a review for the game.
   */
  addReview(userId, draftReview) {}

  /**
   * Purchase a game.
   *
   * @param {string} userId - The ID of the user who is purchasing the game.
   * @param {DraftPurchase} draftPurchase - The draft purchase object.
   * @returns {User} The user who purchased the game.
   * @throws {NotFoundUser} If the user with the given ID does not exist.
   * @throws {NotFoundGame} If the game with the given ID does not exist.
   * @throws {PurchaseException} If the user already owns the game.
   */
  purchaseGame(userId, draftPurchase) {}

  /**
   * Add or remove a friend.
   *
   * @param {string} userId - The ID of the user who is adding or removing the friend.
   * @param {string} friendId - The ID of the friend.
   * @returns {User} The user who added or removed the friend.
   * @throws {NotFoundUser} If the user or the friend with the given ID does not exist.
   * @throws {UserException} If the user is trying to self-add.
   */
  addOrRemoveFriend(userId, friendId) {}
}

Model

class User {
  constructor(id, email, password, name, image, backgroundImage, games = [], friends = []) {
    this.id = id;                     // string
    this.email = email;               // string
    this.password = password;         // string
    this.name = name;                 // string
    this.image = image;               // string
    this.backgroundImage = backgroundImage; // string
    this.games = games;               // Array of Game objects
    this.friends = friends;           // Array of User objects
  }
}

class Game {
  constructor(id, name, description, mainImage, multimedia, tags, price, 
              requirement, relatedGames, developer, releaseDate, reviews, esrb, website) {
    this.id = id;                   // string
    this.name = name;               // string
    this.description = description;  // string
    this.mainImage = mainImage;      // Image object
    this.multimedia = multimedia;    // Array of Image objects
    this.tags = tags;               // Array of Tag objects
    this.price = price;             // Price object
    this.requirement = requirement;  // Requirement object
    this.relatedGames = relatedGames; // Array of Game objects
    this.developer = developer;      // Developer object
    this.releaseDate = releaseDate;  // Date object
    this.reviews = reviews;          // Array of Review objects
    this.esrb = esrb;               // ESRB enum value
    this.website = website;          // string
  }
}

class Tag {
  constructor(id, name, image) {
    this.id = id;       // string
    this.name = name;   // string
    this.image = image; // Image object
  }
}

class Review {
  constructor(id, user, game, isRecommended, text) {
    this.id = id;               // string
    this.user = user;           // User object
    this.game = game;           // Game object
    this.isRecommended = isRecommended; // boolean
    this.text = text;           // string
  }
}

class Requirement {
  constructor(os = [], processor = [], memory = 0, graphics = [], directX = "", storage = 0) {
    this.os = os;             // Array of strings
    this.processor = processor; // Array of strings
    this.memory = memory;       // number
    this.graphics = graphics;   // Array of strings
    this.directX = directX;     // string
    this.storage = storage;     // number
  }
}

class Price {
  constructor(currency, amount) {
    this.currency = currency; // string
    this.amount = amount;     // number
  }
}

class Image {
  constructor(src) {
    this.src = src; // string
  }
}

const ESRB = {
  EVERYONE: 'everyone',
  EVERYONE_10_PLUS: 'everyone10plus',
  TEEN: 'teen',
  MATURE_17_PLUS: 'mature17plus',
  ADULTS_ONLY: 'adultsOnly',
  RATING_PENDING: 'ratingPending'
};

class Developer {
  constructor(id, name, image) {
    this.id = id;       // string
    this.name = name;   // string
    this.image = image; // Image object
  }
}

Pagination

class PageInfo {
  constructor(currentPage, list, amountOfElements, amountOfPages) {
    this.currentPage = currentPage;         // number
    this.list = list;                       // Array of any type
    this.amountOfElements = amountOfElements; // number
    this.amountOfPages = amountOfPages;      // number
  }
}

Drafts

class DraftReview {
  constructor(gameId, isRecommended, text) {
    this.gameId = gameId;               // string
    this.isRecommended = isRecommended; // boolean
    this.text = text;                   // string
  }
}

class DraftPurchase {
  constructor(gameId, card) {
    this.gameId = gameId; // string
    this.card = card;     // CardInfo object
  }
}

class CardInfo {
  constructor(cardHolderName, number, expirationDate, cvv) {
    this.cardHolderName = cardHolderName; // string
    this.number = number;                 // number
    this.expirationDate = expirationDate; // Date object
    this.cvv = cvv;                       // number
  }
}

class DraftUser {
  constructor(name, email, password, image, backgroundImage) {
    this.name = name;                     // string
    this.email = email;                   // string
    this.password = password;             // string
    this.image = image;                   // string
    this.backgroundImage = backgroundImage; // string
  }
}