shaonu-authkit 1.0.1 → 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaonu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# 🔐 shaonu-authkit
+
+A CLI tool to instantly scaffold a full **Express + MongoDB** Authentication Service.
+
+Just one command and your auth backend is ready!
+
+## 🚀 Quick Start
+
+```bash
+npx shaonu-authkit
+```
+
+## 📋 What It Does
+
+When you run the command, it will ask you:
+
+- 📁 Project name
+- 🍃 MongoDB URI
+- 🔑 JWT Secret
+- 🚀 Port number
+- 📦 Package manager (npm / yarn / pnpm)
+
+Then it will:
+
+- ✅ Create your project folder
+- ✅ Create the full auth service template
+- ✅ Generate `.env` file with your values
+- ✅ Install all dependencies automatically
+
+## 📡 API Routes
+
+| Method | Route | Description | Protected |
+|--------|-------|-------------|-----------|
+| POST | `/api/auth/register` | Register new user | ❌ |
+| POST | `/api/auth/login` | Login user | ❌ |
+| POST | `/api/auth/logout` | Logout user | ✅ |
+
+## 📂 Project Structure
+
+```
+your-project/
+├── src/
+│   ├── config/
+│   │   └── db.js              → MongoDB connection
+│   ├── controllers/
+│   │   └── auth.controller.js → Register, Login, Logout logic
+│   ├── models/
+│   │   └── user.model.js      → User schema
+│   ├── routes/
+│       └── auth.routes.js     → API routes
+│   
+├── app.js                     → Express app entry point
+├── .env                       → Your environment variables
+└── package.json
+```
+
+## ⚙️ Environment Variables
+
+After setup, your `.env` file will look like:
+
+```env
+PORT=5000
+MONGO_URI=mongodb://localhost:27017/authkit
+JWT_SECRET=your-secret-key
+JWT_EXPIRE=7d
+NODE_ENV=development
+```
+
+## 📦 Dependencies Used
+
+| Package | Purpose |
+|---------|---------|
+| `express` | Web framework |
+| `mongoose` | MongoDB ODM |
+| `bcryptjs` | Password hashing |
+| `jsonwebtoken` | JWT tokens |
+| `cookie-parser` | Cookie handling |
+| `dotenv` | Environment variables |
+| `nodemon` | Auto restart in dev |
+
+## 🧪 Test Your API
+
+### Register
+```bash
+curl -X POST http://localhost:3000/api/auth/register \
+  -H "Content-Type: application/json" \
+  -d '{"name": "John", "email": "john@example.com", "password": "123456"}'
+```
+
+### Login
+```bash
+curl -X POST http://localhost:3000/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"email": "john@example.com", "password": "123456"}'
+```
+
+### Logout
+```bash
+curl -X POST http://localhost:3000/api/auth/logout \
+  -H "Authorization: Bearer YOUR_TOKEN_HERE"
+```
+
+## 🔐 Security Features
+
+- ✅ Passwords hashed with **bcryptjs** (12 salt rounds)
+- ✅ JWT stored in **httpOnly cookie** (XSS protection)
+- ✅ **sameSite: strict** cookie (CSRF protection)
+- ✅ Password never returned in API responses
+- ✅ Token invalidated on logout
+
+
+## 🔄 Get Started After Setup
+
+```bash
+cd your-project-name
+npm run dev
+```
+
+Server runs on:
+```
+http://localhost:3000
+```
+
+## 👨‍💻 Author
+
+Made with ❤️ by **Shaonu**
+
+- GitHub: [@shaonu](https://github.com/mrsaxena01)
+- NPM: [shaonu-authkit](https://www.npmjs.com/package/shaonu-authkit)
+
+## 📄 License
+
+MIT License — free to use in any project!

package/bin/index.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-
 import chalk from 'chalk';
 import inquirer from 'inquirer';
 import ora from 'ora';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "shaonu-authkit",
-    "version": "1.0.1",
+    "version": "1.0.3",
     "description": "CLI to scaffold a full Express + MongoDB Auth Service",
     "type": "module",
     "bin": {
@@ -17,6 +17,7 @@
         "cli",
         "scaffold"
     ],
+    "license": "MIT",
     "dependencies": {
         "chalk": "^5.3.0",
         "inquirer": "^9.2.0",