https://github.com/kornetas/api-forge
Node.js REST API with user authentication, JWT, roles, and product management – fully tested with Jest.
https://github.com/kornetas/api-forge
api authentication autorization backend bcrypt express jest jwt mongodb mongoose nodejs rest-api roles supertest
Last synced: 12 days ago
JSON representation
Node.js REST API with user authentication, JWT, roles, and product management – fully tested with Jest.
- Host: GitHub
- URL: https://github.com/kornetas/api-forge
- Owner: Kornetas
- Created: 2025-04-04T12:22:59.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-22T08:49:43.000Z (about 1 year ago)
- Last Synced: 2025-07-01T09:44:47.537Z (12 months ago)
- Topics: api, authentication, autorization, backend, bcrypt, express, jest, jwt, mongodb, mongoose, nodejs, rest-api, roles, supertest
- Language: JavaScript
- Homepage:
- Size: 85.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Express API – Products + Auth + JWT 🔐
Simple Node.js + Express API with user authentication, JWT, roles (admin/user), and CRUD for products.
## 🔧 Tech Stack
- Node.js
- Express
- MongoDB
- JWT
- Bcrypt
- Jest + Supertest
## 🚀 Features
- User registration and login
- Password hashing with bcrypt
- JWT token authentication
- Role system (admin, user)
- Auth middleware
- Role middleware (for example: only admin can add products)
- Product CRUD (Create, Read, Update, Delete)
- Authorization: only product owner or admin can edit/delete
## 📁 Folder Structure
```
/controllers → logic for auth and products
/routes → API endpoints
/models → Mongoose schemas
/middleware → auth and role checks
/tests → basic auth + product tests
app.js → express app setup
server.js → DB connection + app start
```
## 🧪 Basic Test Example
```
npm test
```
- Runs Jest tests for auth and products
- Uses test database (`api-test`, `api-test-products`)
## 🛠 How to Run
1. Clone the repo
2. Install packages:
```
npm install
```
3. Create `.env` file in the main folder
4. Copy and paste the following into your .env file:
```
PORT=5000
MONGO_URI=mongodb://localhost:27017/api-forge
JWT_SECRET=yourSecretKeyHere
```
## Database Seeding
To seed the database with a default admin, a normal user, and example products, run:
```bash
node seed.js
```
5. Start server:
```
npm run dev
```
---
## 🔐 Example Routes
### Auth:
- `POST /api/auth/register` – register user
- `POST /api/auth/login` – login and get token
### Products:
- `GET /api/products` – public
- `POST /api/products` – admin only
- `PUT /api/products/:id` – owner or admin
- `DELETE /api/products/:id` – owner or admin
Add token in header:
```
Authorization: Bearer your_token_here
```
---