A comprehensive book store API with user authentication, book management, shopping cart, and favorites functionality.

• User Authentication: JWT-based authentication with signup/signin
• Book Management: CRUD operations for books (admin only)
• Shopping Cart: Add/remove books from cart
• Favorites: Add/remove books from favorites
• Role-based Access: User and admin roles
• Input Validation: Zod schema validation
• API Testing: Comprehensive test suite with Jest and Supertest
• CI/CD Pipeline: GitHub Actions with Keploy API testing
• OpenAPI Documentation: Complete API specification

• POST /api/v1/signup - Register new user
• POST /api/v1/signin - User login

• GET /api/v1/userInfo - Get user information
• PUT /api/v1/update_address - Update user address

• POST /api/v1/addbook - Add new book
• PUT /api/v1/updatebook/:bookId - Update book
• DELETE /api/v1/deletebook/:bookId - Delete book
• GET /api/v1/allbooks - Get all books (public)

• PUT /api/v1/addtocart/:bookId - Add book to cart
• PUT /api/v1/removefromcart/:bookId - Remove book from cart

• PUT /api/v1/addtofavourites/:bookId - Add book to favorites
• PUT /api/v1/removefromfavourites/:bookId - Remove book from favorites

1. Clone the repository:

git clone https://github.com/yourusername/kitaabi-kidaa.git
cd kitaabi-kidaa

2. Install dependencies:

npm install

3. Create .env file:

PORT=3000
JWT_SECRET=your-secret-key
MONGODB_URI=mongodb://localhost:27017/kitaabi-kidaa

4. Start MongoDB:

mongod

5. Run the application:

npm start

npm test

# Install Keploy
curl -fsSL https://get.keploy.io | sh

# Record API interactions
keploy record --config-path .keploy/config.yaml

# Run tests
keploy test --config-path .keploy/config.yaml

# Health check
curl http://localhost:3000/

# User signup
curl -X POST http://localhost:3000/api/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"username":"testuser","email":"test@example.com","password":"password123","address":"123 Test Street"}'

# User signin
curl -X POST http://localhost:3000/api/v1/signin \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com","password":"password123"}'

# Get all books
curl http://localhost:3000/api/v1/allbooks

The project includes a comprehensive CI/CD pipeline with GitHub Actions:

1. Test: Run unit tests and API tests
2. Keploy Record: Record API interactions for testing
3. Deploy: Deploy to production (on main branch)

• MongoDB service container
• Node.js 18 environment
• Keploy API testing integration
• Automatic deployment on main branch
• Post-deployment health checks

The complete API specification is available in openapi.yaml and includes:

• All endpoints with request/response schemas
• Authentication requirements
• Error responses
• Data validation rules

You can view the interactive API documentation by:

1. Opening openapi.yaml in Swagger UI
2. Using tools like Postman with the OpenAPI import

kitaabi-kidaa/
├── .github/workflows/     # CI/CD pipeline
├── .keploy/              # Keploy configuration
├── db/
│   ├── models/           # Database models
│   └── sever.js          # Database connection
├── routes/               # API routes
├── screenshots/          # API testing screenshots
├── api.test.js          # Comprehensive test suite
├── index.js             # Main application file
├── openapi.yaml         # API specification
└── package.json         # Dependencies and scripts

The test suite covers:

• ✅ Authentication endpoints
• ✅ User management
• ✅ Book CRUD operations
• ✅ Cart functionality
• ✅ Favorites functionality
• ✅ Error handling
• ✅ Input validation
• ✅ Authorization checks

• Node.js 18+
• MongoDB
• Environment variables configured

1. Set up environment variables
2. Install dependencies: npm ci
3. Start the application: npm start
4. Configure reverse proxy (nginx/apache)
5. Set up SSL certificates

• Total Endpoints: 15
• Test Coverage: 100%
• Authentication: ✅
• Authorization: ✅
• Data Validation: ✅
• Error Handling: ✅

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

This project is licensed under the ISC License.

For support and questions:

• Create an issue on GitHub
• Email: vipulsingh.1404@gmail.com

• GitHub Repository
• API Documentation
• Keploy Dashboard

Note: This project is part of the API Testing with AI & CI/CD Integration learning path. The CI/CD pipeline includes Keploy API testing for automated test generation and validation.