Hexagonal Architecture example in Node.js using TypeScript

This is a simple example of Hexagonal Architecture in Node.js using TypeScript. I made this example to show how to implement the Hexagonal Architecture in Node.js using TypeScript with my underestanding of the concept.

What is Hexagonal Architecture?

Hexagonal Architecture is an architectural pattern that helps us to create applications that are more independent of the external world. It is also known as Ports and Adapters Architecture or Onion Architecture.

How to run the application

pre-requisites:

• Node.js
• npm
• prisma => npm install -g prisma

1. Clone the repository

2. Run npm install

3. cd into the src/infrastructure/db folder

cd src/infrastructure/db

npx prisma migrate dev --name init

4. Run npm run start to start the application

5. Run npm run test to run the tests

usecases

this is the list of the usecases that the application supports,this usecases will be changed in the future to be more realistic.

Create user

I want to create a user with the following data:

• name
• email
• password

{
  "name": "John Doe",
  "email": "[email protected]",
  "password": "123456"
}
  

Authenticate user

I want to authenticate a user with the following data:

• email
• password

{
  "email": "[email protected]",
    "password": "123456"
}
    

Create post

I want to create a post with the following data:

• title
• content

{
  "title": "My first post",
  "content": "This is my first post",
}