🏗️ Architecture & Tech Stack

The service takes advantage of an enterprise-level modularized backend stack.

📡 API Reference

The base URL for all endpoints is /api/movies.

Core Movie Endpoints

Request Body (POST /api/movies):

{
	"title": "Crime at Porta Romana",
	"year": "1999",
	"cover": "http://example.com/cover.jpg",
	"duration": "237",
	"contentRating": "C",
	"tags": ["Adventure", "Comedy"]
}

Successful Response Format:

{
	"data": "ca309ed7-1aeb-4201-b2a4-2386dba194f0",
	"message": "Movie created successfully!"
}

🚀 Getting Started

Follow these steps to deploy a developmental environment locally.

Prerequisites

You need Node.js (v16+) and pnpm package manager runtime.

1. Clone & Install Dependencies:

# Clone the repository
git clone https://github.com/jorgeadev/movie-api

# Jump to the project directory
cd movie-api

# Install required packages
pnpm install

2. Configure your Environment Variables Generate a .env file at the root of your project:

PORT=3000
DB=mongodb+srv://<USERNAME>:<PASSWORD>@cluster.mongodb.net/movies?retryWrites=true&w=majority

3. Boot the Server! Run the typescript-node developer service directly with Hot-Reloads:

pnpm dev

🧪 Testing

The codebase includes full mock-powered routing tests avoiding actual MongoDB mutations.

To execute the test suite:

pnpm test

Note: Tests compile safely through ts-node/register handling standard CommonJS proxy wiring environments perfectly.