create-forgeapi 1.0.0

package/README.md

@@ -0,0 +1,79 @@
+# create-forgeapi
+
+> 🔨 CLI scaffold untuk **ForgeAPI** — base project Express + TypeScript + MongoDB + Zod + Swagger
+
+## Usage
+
+### Via npm (jika di-publish)
+```bash
+npx create-forgeapi my-project
+```
+
+### Via GitHub (tanpa publish ke npm) ✅
+```bash
+npx github:username/create-forgeapi my-project
+```
+> Ganti `username` dengan GitHub username kamu. Bisa dipakai dari PC manapun tanpa perlu publish ke npm.
+
+### Opsi tambahan
+```bash
+# Skip semua prompt, pakai nilai default
+npx create-forgeapi my-project --yes
+
+# Skip cek versi terbaru (mode offline)
+npx create-forgeapi my-project --no-fetch
+```
+
+## Fitur CLI
+
+- ✅ **Auto-fetch versi terbaru** semua dependency dari npm registry saat generate
+- 🔔 Notifikasi package mana saja yang ada update
+- 🌿 `git init` + initial commit otomatis
+- 📦 `npm install` otomatis (opsional)
+- 🔒 `.env` dibuat otomatis dari `.env.example`
+
+## Yang didapat
+
+```
+my-project/
+├── src/
+│   ├── api/              # Controllers & Middlewares
+│   ├── base/             # BaseRepository, BaseResponse, BaseSchema
+│   ├── config/           # Route, Swagger, Logger, ENV config
+│   ├── core/             # Server, Exceptions, Repositories, Services
+│   ├── database/         # MongoDB connection, Builder, Entities
+│   └── shared/           # Decorators, Interfaces, Models, Utils
+├── .env                  # Konfigurasi environment (auto-generated)
+├── .env.example
+├── nodemon.json
+├── tsconfig.json
+└── package.json          # Versi dependency selalu terbaru
+```
+
+## Stack
+
+| | |
+|---|---|
+| Framework | Express 5 |
+| Language | TypeScript 5 |
+| Database | MongoDB (Mongoose) |
+| Validation | Zod |
+| Auth | JWT |
+| Docs | Swagger UI |
+| Logger | Custom (file + console) |
+
+## Next steps setelah scaffold
+
+```bash
+cd my-project
+# Edit .env — isi MONGO_DB_URL dan JWT_SECRET
+npm run dev
+```
+
+Swagger tersedia di `http://localhost:3000/api-docs`
+
+## Cara update template
+
+Cukup update file di folder `template/` atau `bin/index.ts` di repo GitHub ini,
+lalu semua orang yang menjalankan `npx github:username/create-forgeapi` akan
+otomatis mendapat versi terbaru.

package/dist/bin/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/index.js

@@ -0,0 +1,286 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const https = __importStar(require("https"));
+const child_process_1 = require("child_process");
+// ─── Colors ───────────────────────────────────────────────────────────────────
+const c = {
+    reset: "\x1b[0m",
+    bright: "\x1b[1m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    cyan: "\x1b[36m",
+    magenta: "\x1b[35m",
+    red: "\x1b[31m",
+    gray: "\x1b[90m",
+};
+const log = {
+    info: (m) => console.log(`${c.cyan}ℹ ${c.reset}${m}`),
+    success: (m) => console.log(`${c.green}✅ ${c.reset}${m}`),
+    warn: (m) => console.log(`${c.yellow}⚠️  ${c.reset}${m}`),
+    error: (m) => console.log(`${c.red}❌ ${c.reset}${m}`),
+    step: (m) => console.log(`${c.magenta}▶ ${c.bright}${m}${c.reset}`),
+    dim: (m) => console.log(`${c.gray}${m}${c.reset}`),
+};
+// ─── Banner ───────────────────────────────────────────────────────────────────
+function banner() {
+    console.log();
+    console.log(`${c.cyan}${c.bright}  ███████╗ ██████╗ ██████╗  ██████╗ ███████╗ █████╗ ██████╗ ██╗${c.reset}`);
+    console.log(`${c.cyan}${c.bright}  ██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝██╔══██╗██╔══██╗██║${c.reset}`);
+    console.log(`${c.cyan}${c.bright}  █████╗  ██║   ██║██████╔╝██║  ███╗█████╗  ███████║██████╔╝██║${c.reset}`);
+    console.log(`${c.cyan}${c.bright}  ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝  ██╔══██║██╔═══╝ ██║${c.reset}`);
+    console.log(`${c.cyan}${c.bright}  ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗██║  ██║██║     ██║${c.reset}`);
+    console.log(`${c.cyan}${c.bright}  ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝${c.reset}`);
+    console.log();
+    console.log(`${c.gray}  Express + TypeScript + MongoDB + Zod + Swagger${c.reset}`);
+    console.log(`${c.gray}  Base API scaffold by create-forgeapi${c.reset}`);
+    console.log();
+}
+// ─── Prompt helper ────────────────────────────────────────────────────────────
+function prompt(rl, question, defaultVal = "") {
+    return new Promise(resolve => {
+        const hint = defaultVal ? ` ${c.gray}(${defaultVal})${c.reset}` : "";
+        rl.question(`${c.yellow}?${c.reset} ${question}${hint}: `, answer => {
+            resolve(answer.trim() || defaultVal);
+        });
+    });
+}
+// ─── Fetch latest version from npm registry ───────────────────────────────────
+function fetchLatestVersion(pkg) {
+    return new Promise(resolve => {
+        const url = `https://registry.npmjs.org/${encodeURIComponent(pkg)}/latest`;
+        https.get(url, { headers: { "User-Agent": "create-forgeapi" } }, res => {
+            let data = "";
+            res.on("data", chunk => data += chunk);
+            res.on("end", () => {
+                try {
+                    const json = JSON.parse(data);
+                    resolve(json.version ?? null);
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        }).on("error", () => resolve(null));
+    });
+}
+// ─── Spinner ──────────────────────────────────────────────────────────────────
+function spinner(text) {
+    const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    let i = 0;
+    const iv = setInterval(() => {
+        process.stdout.write(`\r${c.cyan}${frames[i++ % frames.length]}${c.reset} ${text}`);
+    }, 80);
+    return () => {
+        clearInterval(iv);
+        process.stdout.write("\r\x1b[K"); // clear line
+    };
+}
+// ─── Resolve latest versions for all deps ─────────────────────────────────────
+async function resolveLatestVersions(deps) {
+    const stop = spinner("Checking latest package versions...");
+    const entries = await Promise.all(Object.entries(deps).map(async ([pkg, fallback]) => {
+        const latest = await fetchLatestVersion(pkg);
+        return [pkg, latest ? `^${latest}` : fallback];
+    }));
+    stop();
+    return Object.fromEntries(entries);
+}
+// ─── Copy template recursively ────────────────────────────────────────────────
+function copyDir(src, dest, replacements) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src)) {
+        const srcPath = path.join(src, entry);
+        const destPath = path.join(dest, entry);
+        const stat = fs.statSync(srcPath);
+        if (stat.isDirectory()) {
+            copyDir(srcPath, destPath, replacements);
+        }
+        else {
+            let content = fs.readFileSync(srcPath, "utf-8");
+            if (entry === "package.json") {
+                for (const [key, val] of Object.entries(replacements)) {
+                    content = content.replaceAll(key, val);
+                }
+            }
+            fs.writeFileSync(destPath, content);
+        }
+    }
+}
+// ─── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+    banner();
+    const args = process.argv.slice(2);
+    const yesFlag = args.includes("--yes") || args.includes("-y");
+    const skipFetch = args.includes("--no-fetch");
+    let projectName = args.find(a => !a.startsWith("-")) || "";
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    if (!projectName) {
+        projectName = yesFlag ? "my-api" : await prompt(rl, "Project name", "my-api");
+    }
+    const description = yesFlag ? "REST API built with ForgeAPI" : await prompt(rl, "Description", "REST API built with ForgeAPI");
+    const author = yesFlag ? "" : await prompt(rl, "Author", "");
+    const installDeps = yesFlag ? "y" : await prompt(rl, "Install dependencies now? (y/n)", "y");
+    rl.close();
+    // Validasi nama
+    if (!/^[a-z0-9-_]+$/.test(projectName)) {
+        log.error("Project name hanya boleh huruf kecil, angka, - dan _");
+        process.exit(1);
+    }
+    const targetDir = path.resolve(process.cwd(), projectName);
+    if (fs.existsSync(targetDir)) {
+        log.error(`Folder "${projectName}" sudah ada!`);
+        process.exit(1);
+    }
+    console.log();
+    log.step(`Creating project: ${c.cyan}${projectName}${c.reset}`);
+    // ── Resolve latest versions ────────────────────────────────────────────────
+    // Daftar semua package yang perlu dicek versi terbarunya
+    const depPackages = {
+        "cors": "^2.8.6",
+        "dotenv": "^17.2.3",
+        "express": "^5.2.1",
+        "express-rate-limit": "^8.2.1",
+        "jsonwebtoken": "^9.0.3",
+        "mongoose": "^8.0.0",
+        "reflect-metadata": "^0.2.2",
+        "swagger-ui-express": "^5.0.1",
+        "zod": "^4.3.6",
+    };
+    const devPackages = {
+        "@types/cors": "^2.8.19",
+        "@types/express": "^5.0.6",
+        "@types/jsonwebtoken": "^9.0.10",
+        "@types/node": "^25.0.3",
+        "@types/swagger-ui-express": "^4.1.8",
+        "cross-env": "^10.1.0",
+        "nodemon": "^3.1.11",
+        "rimraf": "^6.1.2",
+        "ts-node": "^10.9.2",
+        "tsc-alias": "^1.8.16",
+        "tsconfig-paths": "^4.2.0",
+        "typescript": "^5.9.3",
+    };
+    let resolvedDeps = depPackages;
+    let resolvedDevDeps = devPackages;
+    if (!skipFetch) {
+        [resolvedDeps, resolvedDevDeps] = await Promise.all([
+            resolveLatestVersions(depPackages),
+            resolveLatestVersions(devPackages),
+        ]);
+        log.success("Package versions resolved");
+        // Tampilkan yang ada update
+        const allOld = { ...depPackages, ...devPackages };
+        const allNew = { ...resolvedDeps, ...resolvedDevDeps };
+        const updated = Object.entries(allNew).filter(([pkg, ver]) => ver !== allOld[pkg]);
+        if (updated.length > 0) {
+            log.info(`${updated.length} package(s) updated to latest:`);
+            updated.forEach(([pkg, ver]) => {
+                const old = allOld[pkg];
+                log.dim(`   ${pkg}: ${c.yellow}${old}${c.reset} → ${c.green}${ver}${c.reset}`);
+            });
+        }
+        else {
+            log.info("All packages are already at latest versions");
+        }
+    }
+    else {
+        log.warn("Skipping version check (--no-fetch)");
+    }
+    // ── Inject versi ke template package.json ─────────────────────────────────
+    // Serialize versi ke format yang bisa di-replace di template
+    const depsJson = JSON.stringify(resolvedDeps, null, 4).slice(2, -1).trim(); // isi object
+    const devDepsJson = JSON.stringify(resolvedDevDeps, null, 4).slice(2, -1).trim();
+    // ── Copy template ──────────────────────────────────────────────────────────
+    // __dirname saat build = dist/bin, naik 2 level ke root package
+    const templateDir = path.join(__dirname, "..", "..", "template");
+    copyDir(templateDir, targetDir, {
+        "{{PROJECT_NAME}}": projectName,
+        "{{PROJECT_DESCRIPTION}}": description,
+        "{{AUTHOR}}": author,
+        "{{DEPENDENCIES}}": depsJson,
+        "{{DEV_DEPENDENCIES}}": devDepsJson,
+    });
+    log.success("Template copied");
+    // ── Rename .env.example → .env ─────────────────────────────────────────────
+    const envFile = path.join(targetDir, ".env");
+    const envExample = path.join(targetDir, ".env.example");
+    if (fs.existsSync(envExample) && !fs.existsSync(envFile)) {
+        fs.copyFileSync(envExample, envFile);
+    }
+    // ── Init git ───────────────────────────────────────────────────────────────
+    try {
+        (0, child_process_1.execSync)("git init", { cwd: targetDir, stdio: "ignore" });
+        (0, child_process_1.execSync)("git add .", { cwd: targetDir, stdio: "ignore" });
+        (0, child_process_1.execSync)('git commit -m "chore: init project from create-forgeapi"', { cwd: targetDir, stdio: "ignore" });
+        log.success("Git initialized");
+    }
+    catch {
+        log.warn("Git not found, skipping git init");
+    }
+    // ── Install deps ───────────────────────────────────────────────────────────
+    if (installDeps.toLowerCase() === "y") {
+        log.step("Installing dependencies...");
+        try {
+            (0, child_process_1.execSync)("npm install", { cwd: targetDir, stdio: "inherit" });
+            log.success("Dependencies installed");
+        }
+        catch {
+            log.error(`npm install failed. Run manually: cd ${projectName} && npm install`);
+        }
+    }
+    // ── Done ───────────────────────────────────────────────────────────────────
+    console.log();
+    console.log(`${c.green}${c.bright}  🎉 Project ready!${c.reset}`);
+    console.log();
+    console.log(`  ${c.gray}Next steps:${c.reset}`);
+    console.log(`  ${c.cyan}cd ${projectName}${c.reset}`);
+    if (installDeps.toLowerCase() !== "y") {
+        console.log(`  ${c.cyan}npm install${c.reset}`);
+    }
+    console.log(`  ${c.cyan}# edit .env — isi MONGO_DB_URL dan JWT_SECRET${c.reset}`);
+    console.log(`  ${c.cyan}npm run dev${c.reset}`);
+    console.log();
+    console.log(`  ${c.gray}Swagger docs:${c.reset} ${c.cyan}http://localhost:3000/api-docs${c.reset}`);
+    console.log();
+}
+main().catch(err => {
+    console.error(err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "create-forgeapi",
+  "version": "1.0.0",
+  "description": "CLI scaffold for ForgeAPI — Express + TypeScript + MongoDB + Zod + Swagger base project",
+  "keywords": [
+    "express",
+    "typescript",
+    "mongodb",
+    "zod",
+    "swagger",
+    "scaffold",
+    "boilerplate",
+    "starter",
+    "forgeapi"
+  ],
+  "author": "Alis-Dev",
+  "license": "ISC",
+  "main": "dist/bin/index.js",
+  "bin": {
+    "create-forgeapi": "dist/bin/index.js"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node bin/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3",
+    "ts-node": "^10.9.2"
+  }
+}

package/template/.env.example

@@ -0,0 +1,7 @@
+NODE_ENV=development
+PORT=3000
+MONGO_DB_URL=mongodb://localhost:27017/mydb
+MONGO_DB_USER=
+MONGO_DB_PASSWORD=
+JWT_SECRET=your_jwt_secret_here
+JWT_EXPIRES_IN=7d

package/template/nodemon.json

@@ -0,0 +1,7 @@
+{
+  "watch": ["src"],
+  "ext": "ts,json",
+  "ignore": ["src/**/*.spec.ts"],
+  "exec": "ts-node --project tsconfig.json -r tsconfig-paths/register src/App.ts"
+}
+

package/template/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "description": "{{PROJECT_DESCRIPTION}}",
+  "author": "{{AUTHOR}}",
+  "license": "ISC",
+  "main": "dist/App.js",
+  "scripts": {
+    "dev": "cross-env NODE_ENV=dev nodemon",
+    "build": "tsc && tsc-alias",
+    "build:prod": "tsc -p tsconfig.prod.json && tsc-alias",
+    "start": "node dist/App.js",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    {{DEPENDENCIES}}
+  },
+  "devDependencies": {
+    {{DEV_DEPENDENCIES}}
+  }
+}

package/template/src/App.ts

@@ -0,0 +1 @@
+import "@core/Server";

package/template/src/api/controllers/UserController.ts

@@ -0,0 +1,54 @@
+import {Request, Response} from 'express';
+import {ApiOperation, BodyResponse, Controller, RequiredBody, SwaggerTag} from "@shared/decorators/ApiDecorator";
+import {PostMapping} from "@shared/decorators/MethodeDecorator";
+import {UserCreateRequest} from "@shared/models/request/UserCreateRequest";
+import {SuccessResponse} from "@shared/models/response/ApiResponse";
+import BaseResponse from "@base/BaseResponse";
+import UserRepository from "@core/repositories/UserRepository";
+import BadRequestException from "@core/exceptions/BadRequestException";
+import {MiddlewareCodeAccess} from "@shared/models/enum/MiddlewareEnum";
+
+@Controller("/api/user")
+@SwaggerTag("User")
+export default class UserController {
+
+    private userRepository = new UserRepository();
+
+    @PostMapping("/create", {authenticate: true, codeAccess: MiddlewareCodeAccess.TAMBAH})
+    @ApiOperation("Create User", "Membuat user baru")
+    @RequiredBody(UserCreateRequest)
+    @BodyResponse(201, SuccessResponse(UserCreateRequest), "User berhasil dibuat")
+    async create(req: Request, res: Response) {
+        // 1. Validasi input dengan Zod
+        const parsed = UserCreateRequest.safeParse(req.body);
+        if (!parsed.success) {
+            throw new BadRequestException(
+                "Validasi gagal",
+                parsed.error.issues.map(e => ({ field: e.path.map(String).join('.'), message: e.message }))
+            );
+        }
+
+        // 2. Panggil BaseResponse.ok → jalankan service/repository di dalam callback
+        return BaseResponse.ok(
+            res,
+            () => this.userRepository.createWithProfile(
+                {
+                    username: parsed.data.username,
+                    email:    parsed.data.email,
+                    password: parsed.data.password,
+                },
+                {
+                    firstName:   parsed.data.firstName,
+                    lastName:    parsed.data.lastName,
+                    phone:       parsed.data.phone,
+                    address:     parsed.data.address,
+                    dateOfBirth: parsed.data.dateOfBirth,
+                }
+            ),
+            "User berhasil dibuat"
+        );
+        // BaseResponse.ok akan otomatis return:
+        // { success: true, message: "User berhasil dibuat", data: <hasil createWithProfile> }
+        // Jika callback throw exception → ditangkap GlobalHandlerError → return ErrorResponse
+    }
+}

package/template/src/api/middlewares/AuthMiddleware.ts

@@ -0,0 +1,24 @@
+import {Response, Request, NextFunction} from "express";
+import UnauthorizedException from "@core/exceptions/UnauthorizedException";
+import JwtUtil from "@shared/utils/JwtUtil";
+import {log} from "@config/LoggerConfig";
+
+export default async (
+    req: Request,
+    res: Response,
+    next: NextFunction
+) => {
+    try {
+        const authHeader = req.headers.authorization;
+        if (!authHeader || !authHeader.startsWith('Bearer ')) {
+            return next(new UnauthorizedException("Authorization header missing or malformed"));
+        }
+        log.info("ACCESS: ", req.authenticate?.codeAccess);
+        const token = authHeader.substring(7);
+        const decoded = await JwtUtil.validateToken(token);
+        (req as any).user = decoded;
+        next();
+    } catch (error) {
+        next(error);
+    }
+}

package/template/src/base/BaseRepository.ts

@@ -0,0 +1,112 @@
+import {
+    Document,
+    Model
+} from "mongoose";
+import {
+    Pageable,
+    PageResult,
+    SortOption
+} from "@shared/interfaces/DatabaseInterface";
+import CustomBuilder from "@database/builder/CustomBuilder";
+import UserEntity from "@database/entity/UserModel";
+
+export default class BaseRepository <T extends Document> {
+    constructor(protected model: Model<T>) {}
+
+    async findAll(builder: CustomBuilder<T>, pageable: Pageable): Promise<PageResult<T>> {
+        const { page, size, sort } = pageable;
+        const skip = (page - 1) * size;
+
+        if (builder.hasLookups()) {
+            return this.findAllWithAggregation(builder, pageable);
+        }
+
+        const query = builder.build();
+        const [content, totalElements] = await Promise.all([
+            this.model
+                .find(query)
+                .sort(sort || { _id: -1 })
+                .skip(skip)
+                .limit(size)
+                .exec(),
+            this.model.countDocuments(query).exec()
+        ]);
+
+        const totalPages = Math.ceil(totalElements / size);
+
+        return {
+            content,
+            totalElements,
+            totalPages,
+            currentPage: page,
+            size,
+            hasNext: page < totalPages,
+            hasPrevious: page > 1
+        };
+    }
+
+    async list(builder: CustomBuilder<T>, sort?: SortOption): Promise<T[]> {
+        if (builder.hasLookups()) {
+            const pipeline = builder.buildAggregation();
+
+            if (sort) {
+                pipeline.push({ $sort: sort });
+            }
+
+            return this.model.aggregate(pipeline).exec();
+        }
+
+        const query = builder.build();
+        return this.model
+            .find(query)
+            .sort(sort || { _id: -1 })
+            .exec();
+    }
+
+    async findOne(builder: CustomBuilder<T>): Promise<T | null> {
+        if (builder.hasLookups()) {
+            const pipeline = builder.buildAggregation();
+            pipeline.push({ $limit: 1 });
+
+            const result = await this.model.aggregate(pipeline).exec();
+            return result.length > 0 ? result[0] : null;
+        }
+
+        const query = builder.build();
+        return this.model.findOne(query).exec();
+    }
+
+    private async findAllWithAggregation(
+        builder: CustomBuilder<T>,
+        pageable: Pageable
+    ): Promise<PageResult<T>> {
+        const { page, size, sort } = pageable;
+        const skip = (page - 1) * size;
+
+        const pipeline = builder.buildAggregation();
+
+        if (sort) {
+            pipeline.push({ $sort: sort });
+        }
+
+        const countPipeline = [...pipeline, { $count: 'total' }];
+        const countResult = await this.model.aggregate(countPipeline).exec();
+        const totalElements = countResult.length > 0 ? countResult[0].total : 0;
+
+        pipeline.push({ $skip: skip });
+        pipeline.push({ $limit: size });
+
+        const content = await this.model.aggregate(pipeline).exec();
+        const totalPages = Math.ceil(totalElements / size);
+
+        return {
+            content: content as any,
+            totalElements,
+            totalPages,
+            currentPage: page,
+            size,
+            hasNext: page < totalPages,
+            hasPrevious: page > 1
+        };
+    }
+}