express-project-builder 1.0.5 → 1.0.7

package/README.md

@@ -11,6 +11,8 @@ A powerful and professional [Express.js project generator CLI](https://www.npmjs
 - [Quick Start](#Quick-Start)
 - [Key Elements](#Key-Elements)
 - [Folder Structure](#Folder-Structure)
+- [Packages](#Packages)
+- [Examples](#Examples)
 
 # [Quick Start](#Quick-Start)
 
@@ -131,3 +133,126 @@ my-test-project/
 ├── package.json
 └── tsconfig.json
 ```
+
+## [Packages](#Packages)
+
+### Dependencies
+
+- [axios (1.12.2)](https://www.npmjs.com/package/axios)
+- [bcryptjs (3.0.2)](https://www.npmjs.com/package/bcryptjs)
+- [cookie-parser (1.4.7)](https://www.npmjs.com/package/cookie-parser)
+- [cors (2.8.5)](https://www.npmjs.com/package/cors)
+- [dotenv (16.6.1)](https://www.npmjs.com/package/dotenv)
+- [eslint-plugin-prettier (5.5.4)](https://www.npmjs.com/package/eslint-plugin-prettier)
+- [express (5.1.0)](https://www.npmjs.com/package/express)
+- [jsonwebtoken (9.0.2)](https://www.npmjs.com/package/jsonwebtoken)
+- [mongoose (8.19.1)](https://www.npmjs.com/package/mongoose)
+- [multer (2.0.2-lts.1)](https://www.npmjs.com/package/multer)
+- [node-cache (5.1.2)](https://www.npmjs.com/package/node-cache)
+- [nodemailer (7.0.6)](https://www.npmjs.com/package/nodemailer)
+- [@prisma/client (6.16.1)](https://www.npmjs.com/package/@prisma/client)
+- [zod (3.24.1)](https://www.npmjs.com/package/zod)
+
+### Development Dependencies
+
+- [@eslint/js (9.35.0)](https://www.npmjs.com/package/@eslint/js)
+- [@types/cookie-parser (1.4.9)](https://www.npmjs.com/package/@types/cookie-parser)
+- [@types/cors (2.8.19)](https://www.npmjs.com/package/@types/cors)
+- [@types/express (5.0.3)](https://www.npmjs.com/package/@types/express)
+- [@types/jsonwebtoken (9.0.10)](https://www.npmjs.com/package/@types/jsonwebtoken)
+- [@types/multer (2.0.0)](https://www.npmjs.com/package/@types/multer)
+- [@types/nodemailer (7.0.1)](https://www.npmjs.com/package/@types/nodemailer)
+- [@typescript-eslint/eslint-plugin (8.43.0)](https://www.npmjs.com/package/@typescript-eslint/eslint-plugin)
+- [@typescript-eslint/parser (8.43.0)](https://www.npmjs.com/package/@typescript-eslint/parser)
+- [eslint (9.35.0)](https://www.npmjs.com/package/eslint)
+- [eslint-config-prettier (10.1.8)](https://www.npmjs.com/package/eslint-config-prettier)
+- [globals (16.4.0)](https://www.npmjs.com/package/globals)
+- [prisma (6.16.1)](https://www.npmjs.com/package/prisma)
+- [prettier (3.6.2)](https://www.npmjs.com/package/prettier)
+- [ts-node-dev (2.0.0)](https://www.npmjs.com/package/ts-node-dev)
+- [typescript (5.9.2)](https://www.npmjs.com/package/typescript)
+- [typescript-eslint (8.43.0)](https://www.npmjs.com/package/typescript-eslint)
+
+## [Examples](#Examples)
+
+- /src/app/builder/**MongooseQueryBuilder.ts** <br/>
+  A fluent API for building complex MongoDB queries with Mongoose. Simplifies dynamic query construction for search, filtering, sorting, pagination, and field selection in a chainable interface.
+
+  ```typescript
+  // In your controller/service:
+  import MongooseQueryBuilder from "../../builder/MongooseQueryBuilder";
+
+  // Extract query parameters from request (e.g., ?search=keyword&page=1&limit=10)
+  const { page, limit, sort, search, fields, ...filters } = req.query;
+
+  // Create a new query builder instance
+  const docQuery = new MongooseQueryBuilder(YourModel.find(), req.query)
+
+    // Search in specified text fields (e.g., name, description, category)
+    .search(["name", "description", "category"])
+
+    // Apply filters dynamically (e.g., status=active, category=tech)
+    .filter()
+
+    // Sort results (e.g., ?sort=name asc,sort=-createdAt desc)
+    .sort()
+
+    // Paginate results (e.g., ?page=1&limit=10)
+    .paginate()
+
+    // Select specific fields (e.g., ?fields=name,price,description)
+    .fields();
+
+  // Execute the query and get results
+  const result = await docQuery.modelQuery;
+
+  // Get pagination metadata (total count, page, limit, total pages)
+  const meta = await docQuery.countTotal();
+
+  // Return the results and metadata from service
+  return {
+    result,
+    meta,
+  };
+  ```
+
+- /src/app/builder/**PrismaQueryBuilder.ts** <br/>
+  A fluent API for building complex SQL queries with Prisma. Simplifies dynamic query construction for search, filtering, sorting, pagination, and field selection in a chainable interface.
+
+  ```typescript
+  // In your controller/service:
+  import PrismaQueryBuilder from "../../builder/PrismaQueryBuilder";
+
+  // Extract query parameters from request (e.g., ?search=keyword&page=1&limit=10)
+  const { page, limit, sort, search, fields, ...filters } = req.query;
+
+  // Create a new query builder instance
+  const docQuery = new PrismaQueryBuilder(YourModel.find(), req.query)
+
+    // Search in specified text fields (e.g., name, description, category)
+    .search(["name", "description", "category"])
+
+    // Apply filters dynamically (e.g., status=active, category=tech)
+    .filter()
+
+    // Sort results (e.g., ?sort=name asc,sort=-createdAt desc)
+    .sort()
+
+    // Paginate results (e.g., ?page=1&limit=10)
+    .paginate()
+
+    // Select specific fields (e.g., ?fields=name,price,description)
+    .fields();
+
+  // Execute the query and get results
+  const result = await docQuery.modelQuery;
+
+  // Get pagination metadata (total count, page, limit, total pages)
+  const meta = await docQuery.countTotal();
+
+  // Return the results and metadata from service
+  return {
+    result,
+    meta,
+  };
+  ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "express-project-builder",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "A powerful and professional Express.js project generator CLI that instantly scaffolds a production-ready backend with TypeScript, modular architecture, and built-in support for MongoDB (Mongoose) or PostgreSQL (Prisma). Includes authentication, error handling, rate limiting, file upload, caching, and utility functions—so you can focus on building features instead of boilerplate. Perfect for kickstarting your next Express.js API project with best practices and modern tools.",
   "type": "module",
   "main": "dist/bin/index.js",