Add Movies module

src/modules/movies/api/movies-routes.ts

@@ -0,0 +1,58 @@
+import { Request, Response } from 'express';
+import * as core from 'express-serve-static-core';
+import { getQtyFromRequest } from '../../../utils/route-utils';
+import movies from '../data/movies';
+import getMovieById from '../utils/getMovieById';
+import getRandomMovies from '../utils/getRandomMovies';
+
+module.exports = function (app: core.Express) {
+
+    /**
+     * @openapi
+     * '/movies/random':
+     *  get:
+     *    tags:
+     *    - Movies
+     *    summary: Get a random movie
+     *    responses:
+     *      '200':
+     *        description: OK
+     *        schema:
+     *          $ref: '#/definitions/MockMovie'
+     */
+    app.get('/movies/random', (req: Request, res: Response) => {
+        const randomNumber = Math.floor(Math.random() * movies.length) + 1
+        const movie = getMovieById(randomNumber);
+
+        res.json(movie);
+    });
+
+    /**
+     * @openapi
+     * '/movies/{qty}':
+     *  get:
+     *    tags:
+     *    - Movies
+     *    summary: Returns random movies
+     *    parameters:
+     *    - in: params
+     *      name: qty
+     *      schema:
+     *          type: number
+     *          default: 10
+     *    responses:
+     *      '200':
+     *        description: OK
+     *        schema:
+     *          type: array
+     *          items:
+     *            $ref: '#/definitions/MockMovie'
+     */
+    app.get('/movies/:qty?', (req: Request, res: Response) => {
+        const quantity = getQtyFromRequest(req, 10);
+        const movies = getRandomMovies(quantity);
+
+        return res.json(movies);
+    });
+
+};

src/modules/movies/consts/Movie.ts

@@ -0,0 +1,62 @@
+
+/**
+ * @openapi
+ * definitions:
+ *  MockMovie:
+ *   type: object
+ *   properties:
+ *    id:
+ *      type: number
+ *      example: 1
+ *    created:
+ *      type: string
+ *      example: 2019-01-01
+ *    modified:
+ *      type: string
+ *      example: 2019-08-03
+ *    title:
+ *      type: string
+ *      example: 'The Shawshank Redemption'
+ *    url:
+ *      type: string
+ *      example: 'https://www.imdb.com/title/tt0111161/'
+ *    IMDb_rating:
+ *      type: number
+ *      example: 9.3
+ *    runtime:
+ *      type: number
+ *      example: 142
+ *    year:
+ *      type: number
+ *      example: 1994
+ *    genres:
+ *      type: string
+ *      example: 'Drama, Crime'
+ *    IMDb_votes:
+ *      type: number
+ *      example: 2_223_000
+ *    release_date:
+ *      type: string
+ *      example: '1994-09-23'
+ *    directors:
+ *      type: string
+ *      example: 'Frank Darabont'
+ *
+ *
+ */
+type Movie = {
+  id: number;
+  created: string;
+  modified: string;
+  title: string;
+  url: string;
+  IMDb_rating: number;
+  runtime: number;
+  year: number;
+  genres: string;
+  IMDb_votes: number;
+  release_date: string;
+  directors: string;
+};
+
+export default Movie;