Pointhub API Starter

Features

• Bun Javascript runtime
• Express Node.js framework
• Cors Cross-Origin Resource-Sharing enabled
• Helmet Secure HTTP Headers
• Typescript for type checking
• Bun Test for unit testing
• Supertest for e2e testing
• ESLint for code linting
• Husky for check your commit

Services

• MongoDB Database

Directory Structure

PAPI-STARTER
├── node_modules
├── src
│   ├── assets
│   ├── config
│   ├── console
│   ├── database
│   ├── modules
│   │   ├── master
│   │   │   └── examples
│   │   │       ├── controllers
│   │   │       ├── repositories
│   │   │       ├── rules
│   │   │       ├── use-cases
│   │   │       ├── entity.ts
│   │   │       ├── factory.ts
│   │   │       ├── interface.ts
│   │   │       ├── router.ts
│   │   │       └── schema.ts
│   └── test
│       ├── setup.ts
│       └── utils.ts
├── .env.example
├── .env.test.example
├── .cli.ts
└── README.md

Contribution Guide

---

Database for development

Since transactions are built on concepts of logical sessions they require mechanics which are only available in a replica set environment.

Choose one of the options that you prefer

• Install offline MongoDB database replica set using docker Docker MongoDB RS

• Use online Database as a Service (DBaaS) Atlas MongoDB

Installation

We are using Bun as a drop-in replacement for Node.js

Install Bun

Linux / MacOS

curl -fsSL https://bun.sh/install | bash

Windows

powershell -c "irm bun.sh/install.ps1 | iex"

Install dependencies

cp .env.example .env
cp .env.test.example .env.test
bun install --frozen-lock
bun run dev

Setup Database

Add Validation Schema

bun cli db:init

Seed Default Database

bun cli db:default

Testing

Testing all test case

bun test

Testing coverage

bun test:coverage

Testing report

bun test:report

Testing specific file or directory

# Test specific directory
bun test src/modules/master/examples/controllers

# Test specific file
bun test src/modules/master/examples/controllers/create.spec

# Test specific test case
bun test src/modules/master/examples/controllers/create.spec -t "test case"