@patel.ajay745/exinit 1.0.0

package/dist/cli.js

@@ -0,0 +1,73 @@
+#!/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 path = __importStar(require("path"));
+const validation_1 = require("./validation");
+const naming_1 = require("./naming");
+const prompt_1 = require("./prompt");
+const packageManager_1 = require("./packageManager");
+const scaffolder_1 = require("./scaffolder");
+function resolveTemplateDir(baseDir, lang, moduleSystem) {
+    if (lang === "ts")
+        return path.join(baseDir, "ts");
+    return path.join(baseDir, moduleSystem === "esm" ? "js-esm" : "js-cjs");
+}
+async function main() {
+    try {
+        const arg = process.argv[2];
+        const isCurrentDir = !arg || arg === ".";
+        const projectName = isCurrentDir ? path.basename(process.cwd()) : arg;
+        const targetDir = isCurrentDir ? process.cwd() : path.resolve(process.cwd(), projectName);
+        (0, validation_1.validateProjectName)(projectName);
+        if (isCurrentDir) {
+            (0, validation_1.validateCurrentDir)(targetDir);
+        }
+        else {
+            (0, validation_1.validateNewDir)(targetDir, projectName);
+        }
+        const lang = await (0, prompt_1.promptLanguage)();
+        const moduleSystem = lang === "js" ? await (0, prompt_1.promptModuleSystem)() : undefined;
+        const packageManager = await (0, prompt_1.promptPackageManager)((0, packageManager_1.detectPackageManagers)());
+        const routerName = (0, naming_1.toRouterName)(projectName);
+        const templateDir = resolveTemplateDir(path.join(__dirname, "..", "templates"), lang, moduleSystem);
+        (0, scaffolder_1.scaffoldProject)({ projectName, lang, packageManager, routerName, targetDir, templateDir, isCurrentDir });
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+main();

package/dist/fs.js

@@ -0,0 +1,99 @@
+"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 });
+exports.copyDir = copyDir;
+exports.copyTemplate = copyTemplate;
+exports.applyReplacementsInSources = applyReplacementsInSources;
+exports.finalizePackageJson = finalizePackageJson;
+exports.renameGitignore = renameGitignore;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const messages_1 = require("./messages");
+function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+function copyTemplate(templateDir, targetDir) {
+    try {
+        copyDir(templateDir, targetDir);
+    }
+    catch (err) {
+        fs.rmSync(targetDir, { recursive: true, force: true });
+        throw new Error(messages_1.Messages.copyFailed(err));
+    }
+}
+function escapeForRegex(str) {
+    return str.replace(/[{}.*+?^$|[\]\\]/g, "\\$&");
+}
+function applyReplacements(content, replacements) {
+    return Object.entries(replacements).reduce((result, [placeholder, value]) => {
+        return result.replace(new RegExp(escapeForRegex(placeholder), "g"), value);
+    }, content);
+}
+function applyReplacementsInSources(srcDir, replacements) {
+    for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+        const fullPath = path.join(srcDir, entry.name);
+        if (entry.isDirectory()) {
+            applyReplacementsInSources(fullPath, replacements);
+        }
+        else if ([".ts", ".js"].includes(path.extname(entry.name))) {
+            const updated = applyReplacements(fs.readFileSync(fullPath, "utf-8"), replacements);
+            fs.writeFileSync(fullPath, updated);
+        }
+    }
+}
+function finalizePackageJson(targetDir, replacements) {
+    const templatePath = path.join(targetDir, "package.json.template");
+    const outputPath = path.join(targetDir, "package.json");
+    const content = applyReplacements(fs.readFileSync(templatePath, "utf-8"), replacements);
+    fs.writeFileSync(outputPath, content);
+    fs.unlinkSync(templatePath);
+}
+function renameGitignore(targetDir) {
+    const src = path.join(targetDir, "gitignore");
+    const dest = path.join(targetDir, ".gitignore");
+    if (fs.existsSync(src)) {
+        fs.renameSync(src, dest);
+    }
+}

package/dist/installer.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDependencies = installDependencies;
+const child_process_1 = require("child_process");
+const messages_1 = require("./messages");
+const packageManager_1 = require("./packageManager");
+function installDependencies(targetDir, projectName, pm) {
+    console.log(messages_1.Messages.installingDeps());
+    try {
+        (0, child_process_1.execSync)((0, packageManager_1.getInstallCommand)(pm), { cwd: targetDir, stdio: "inherit" });
+    }
+    catch {
+        console.warn(messages_1.Messages.installFailed(projectName, (0, packageManager_1.getInstallCommand)(pm)));
+    }
+}

package/dist/messages.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messages = void 0;
+exports.Messages = {
+    usage: () => "Usage: npx exinit [project-name]\n" +
+        "Omit the name to scaffold in the current directory.",
+    invalidName: (name) => `Error: "${name}" is not a valid project name.\n` +
+        `Use lowercase letters, numbers, and hyphens only (e.g., my-app).`,
+    dirExists: (name) => `Error: Directory "${name}" already exists.\n` +
+        `Choose a different name or remove the existing directory.`,
+    alreadyInitialized: () => "Error: This directory already has a package.json.\n" +
+        "Run in an empty directory or provide a project name to create a new one.",
+    copyFailed: (err) => `Error: Failed to copy template files. ${err}`,
+    creatingProject: (lang, name) => {
+        const label = lang === "ts" ? "TypeScript" : "JavaScript";
+        return `\nCreating ${label} project "${name}"...`;
+    },
+    installingDeps: () => "Installing dependencies...\n",
+    installFailed: (name, installCmd) => `\nWarning: install failed. Run it manually:\n  cd ${name} && ${installCmd}`,
+    success: (name, devCmd, prodCmd, isCurrentDir) => {
+        const nav = isCurrentDir ? `  ${devCmd}` : `  cd ${name}\n  ${devCmd}`;
+        return `
+Done! Your project "${name}" is ready.
+
+${nav}
+
+Next steps:
+  - Copy .env.example to .env and set your environment variables
+  - Add routes in src/routes/
+  - Production: ${prodCmd}
+`;
+    },
+};

package/dist/naming.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCamelCase = toCamelCase;
+exports.toRouterName = toRouterName;
+function toCamelCase(name) {
+    return name.replace(/-([a-z0-9])/g, (_, char) => char.toUpperCase());
+}
+function toRouterName(projectName) {
+    return toCamelCase(projectName) + "Router";
+}

package/dist/packageManager.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPackageManagers = detectPackageManagers;
+exports.getInstallCommand = getInstallCommand;
+exports.getDevCommand = getDevCommand;
+exports.getProdCommand = getProdCommand;
+const child_process_1 = require("child_process");
+const ALL_PACKAGE_MANAGERS = ["npm", "bun", "pnpm", "yarn"];
+function isInstalled(pm) {
+    try {
+        (0, child_process_1.execSync)(`${pm} --version`, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function detectPackageManagers() {
+    return ALL_PACKAGE_MANAGERS.map((name) => ({
+        name,
+        installed: isInstalled(name),
+    }));
+}
+function getInstallCommand(pm) {
+    const commands = {
+        npm: "npm install",
+        bun: "bun install",
+        pnpm: "pnpm install",
+        yarn: "yarn",
+    };
+    return commands[pm];
+}
+function getDevCommand(pm) {
+    const commands = {
+        npm: "npm run dev",
+        bun: "bun dev",
+        pnpm: "pnpm dev",
+        yarn: "yarn dev",
+    };
+    return commands[pm];
+}
+function getProdCommand(pm, lang) {
+    if (lang === "js") {
+        const startCmds = {
+            npm: "npm start",
+            bun: "bun start",
+            pnpm: "pnpm start",
+            yarn: "yarn start",
+        };
+        return startCmds[pm];
+    }
+    const buildAndStartCmds = {
+        npm: "npm run build && npm start",
+        bun: "bun run build && bun start",
+        pnpm: "pnpm build && pnpm start",
+        yarn: "yarn build && yarn start",
+    };
+    return buildAndStartCmds[pm];
+}

package/dist/prompt.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptLanguage = promptLanguage;
+exports.promptModuleSystem = promptModuleSystem;
+exports.promptPackageManager = promptPackageManager;
+function renderMenu(title, options, selectedIndex, firstRender) {
+    if (!firstRender) {
+        process.stdout.write(`\x1B[${options.length + 1}A\r`);
+    }
+    process.stdout.write(`? ${title}: (Use arrow keys)\n`);
+    options.forEach((opt, i) => {
+        const hint = opt.hint ? ` ${opt.hint}` : "";
+        const isSelected = i === selectedIndex;
+        if (opt.disabled) {
+            process.stdout.write(`    \x1B[2m${opt.label}${hint}\x1B[0m\n`);
+        }
+        else if (isSelected) {
+            process.stdout.write(`  \x1B[36m> ${opt.label}${hint}\x1B[0m\n`);
+        }
+        else {
+            process.stdout.write(`    ${opt.label}${hint}\n`);
+        }
+    });
+}
+function findNextEnabled(options, current, direction) {
+    let next = current + direction;
+    while (next >= 0 && next < options.length) {
+        if (!options[next].disabled)
+            return next;
+        next += direction;
+    }
+    return current;
+}
+function promptSelection(title, options) {
+    return new Promise((resolve) => {
+        const defaultIndex = options.findIndex((opt) => !opt.disabled);
+        let selected = defaultIndex >= 0 ? defaultIndex : 0;
+        renderMenu(title, options, selected, true);
+        if (!process.stdin.isTTY) {
+            resolve(selected);
+            return;
+        }
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        const handleKey = (key) => {
+            const isUpArrow = key[0] === 0x1b && key[1] === 0x5b && key[2] === 0x41;
+            const isDownArrow = key[0] === 0x1b && key[1] === 0x5b && key[2] === 0x42;
+            const isEnter = key[0] === 0x0d || key[0] === 0x0a;
+            const isCtrlC = key[0] === 0x03;
+            if (isUpArrow) {
+                selected = findNextEnabled(options, selected, -1);
+                renderMenu(title, options, selected, false);
+            }
+            else if (isDownArrow) {
+                selected = findNextEnabled(options, selected, 1);
+                renderMenu(title, options, selected, false);
+            }
+            else if (isEnter) {
+                process.stdin.setRawMode(false);
+                process.stdin.pause();
+                process.stdin.removeListener("data", handleKey);
+                process.stdout.write(`\x1B[${options.length + 1}A\r\x1B[J`);
+                process.stdout.write(`? ${title}: \x1B[36m${options[selected].label}\x1B[0m\n`);
+                resolve(selected);
+            }
+            else if (isCtrlC) {
+                process.stdin.setRawMode(false);
+                process.stdin.removeListener("data", handleKey);
+                process.exit(0);
+            }
+        };
+        process.stdin.on("data", handleKey);
+    });
+}
+async function promptLanguage() {
+    const options = [
+        { label: "TypeScript" },
+        { label: "JavaScript" },
+    ];
+    const index = await promptSelection("Select language", options);
+    return index === 0 ? "ts" : "js";
+}
+async function promptModuleSystem() {
+    const options = [
+        { label: "CommonJS", hint: "(require / module.exports)" },
+        { label: "ES Modules", hint: "(import / export)" },
+    ];
+    const index = await promptSelection("Choose module system", options);
+    return index === 0 ? "cjs" : "esm";
+}
+async function promptPackageManager(managers) {
+    const options = managers.map((m) => ({
+        label: m.name,
+        disabled: !m.installed,
+        hint: !m.installed ? "(not installed)" : m.name === "npm" ? "(default)" : undefined,
+    }));
+    const index = await promptSelection("Choose package manager", options);
+    return managers[index].name;
+}

package/dist/scaffolder.js

@@ -0,0 +1,55 @@
+"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 });
+exports.scaffoldProject = scaffoldProject;
+const path = __importStar(require("path"));
+const messages_1 = require("./messages");
+const fs_1 = require("./fs");
+const installer_1 = require("./installer");
+const packageManager_1 = require("./packageManager");
+function scaffoldProject(config) {
+    const { projectName, lang, packageManager, routerName, targetDir, templateDir, isCurrentDir } = config;
+    const replacements = {
+        "{{PROJECT_NAME}}": projectName,
+        "{{ROUTER_NAME}}": routerName,
+    };
+    console.log(messages_1.Messages.creatingProject(lang, projectName));
+    (0, fs_1.copyTemplate)(templateDir, targetDir);
+    (0, fs_1.finalizePackageJson)(targetDir, replacements);
+    (0, fs_1.applyReplacementsInSources)(path.join(targetDir, "src"), replacements);
+    (0, fs_1.renameGitignore)(targetDir);
+    (0, installer_1.installDependencies)(targetDir, projectName, packageManager);
+    console.log(messages_1.Messages.success(projectName, (0, packageManager_1.getDevCommand)(packageManager), (0, packageManager_1.getProdCommand)(packageManager, lang), isCurrentDir));
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/validation.js

@@ -0,0 +1,57 @@
+"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 });
+exports.validateProjectName = validateProjectName;
+exports.validateNewDir = validateNewDir;
+exports.validateCurrentDir = validateCurrentDir;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const messages_1 = require("./messages");
+function isValidPackageName(name) {
+    return /^[a-z0-9]([a-z0-9\-_]*[a-z0-9])?$/.test(name);
+}
+function validateProjectName(name) {
+    if (!isValidPackageName(name))
+        throw new Error(messages_1.Messages.invalidName(name));
+}
+function validateNewDir(targetDir, projectName) {
+    if (fs.existsSync(targetDir))
+        throw new Error(messages_1.Messages.dirExists(projectName));
+}
+function validateCurrentDir(targetDir) {
+    if (fs.existsSync(path.join(targetDir, "package.json"))) {
+        throw new Error(messages_1.Messages.alreadyInitialized());
+    }
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@patel.ajay745/exinit",
+  "version": "1.0.0",
+  "description": "Scaffold a production-ready Express project in seconds",
+  "bin": {
+    "exinit": "./dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "chmod +x dist/cli.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": ["express", "typescript", "boilerplate", "scaffold", "starter"],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.4.5",
+    "@types/node": "^20.12.7"
+  }
+}

package/templates/js-cjs/.env.example

@@ -0,0 +1,2 @@
+PORT=3000
+NODE_ENV=development

package/templates/js-cjs/gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.env
+*.log

package/templates/js-cjs/package.json.template

@@ -0,0 +1,21 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "description": "",
+  "main": "src/index.js",
+  "_moduleAliases": {
+    "@": "src"
+  },
+  "scripts": {
+    "dev": "nodemon src/index.js",
+    "start": "node src/index.js"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "dotenv": "^16.4.5",
+    "module-alias": "^2.2.3"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.0"
+  }
+}

package/templates/js-cjs/src/index.js

@@ -0,0 +1,17 @@
+require("module-alias/register");
+require("dotenv/config");
+const express = require("express");
+const { {{ROUTER_NAME}} } = require("@/routes/index");
+const { errorHandler } = require("@/utils/errorHandler");
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+app.use("/api", {{ROUTER_NAME}});
+app.use(errorHandler);
+
+app.listen(PORT, () => console.log(`Server running on port ${PORT}`));
+
+module.exports = app;

package/templates/js-cjs/src/routes/index.js

@@ -0,0 +1,11 @@
+const { Router } = require("express");
+const { asyncHandler } = require("@/utils/asyncHandler");
+const { ApiResponse } = require("@/utils/apiResponse");
+
+const {{ROUTER_NAME}} = Router();
+
+{{ROUTER_NAME}}.get("/health", asyncHandler(async (req, res) => {
+  res.status(200).json(new ApiResponse(200, "Server is healthy", { status: "ok" }));
+}));
+
+module.exports = { {{ROUTER_NAME}} };

package/templates/js-cjs/src/utils/apiError.js

@@ -0,0 +1,17 @@
+class ApiError extends Error {
+    constructor(statusCode = 500, message = "", errors = [], stack = "") {
+        super(message);
+        this.statusCode = statusCode;
+        this.message = message;
+        this.success = false;
+        this.errors = errors;
+
+        if (stack) {
+            this.stack = stack;
+        } else {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+
+module.exports = { ApiError };

package/templates/js-cjs/src/utils/apiResponse.js

@@ -0,0 +1,10 @@
+class ApiResponse {
+    constructor(statusCode = 200, message = "Success", data = {}) {
+        this.statusCode = statusCode;
+        this.message = message;
+        this.data = data;
+        this.success = statusCode < 400;
+    }
+}
+
+module.exports = { ApiResponse };

package/templates/js-cjs/src/utils/asyncHandler.js

@@ -0,0 +1,8 @@
+const asyncHandler = (requestHandler) => {
+    return function (req, res, next) {
+        Promise.resolve(requestHandler(req, res, next))
+            .catch((error) => next(error));
+    };
+};
+
+module.exports = { asyncHandler };

package/templates/js-cjs/src/utils/errorHandler.js

@@ -0,0 +1,23 @@
+const { ApiError } = require("@/utils/apiError");
+
+const errorHandler = (err, req, res, next) => {
+    if (res.headersSent) {
+        return next(err);
+    }
+
+    if (err instanceof ApiError) {
+        res.status(err.statusCode).json({
+            success: false,
+            message: err.message,
+            errors: err.errors,
+        });
+    } else {
+        res.status(500).json({
+            success: false,
+            message: err.message,
+            errors: [],
+        });
+    }
+};
+
+module.exports = { errorHandler };

package/templates/js-esm/.env.example

@@ -0,0 +1,2 @@
+PORT=3000
+NODE_ENV=development

package/templates/js-esm/gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.env
+*.log

package/templates/js-esm/package.json.template

@@ -0,0 +1,18 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "",
+  "main": "src/index.js",
+  "scripts": {
+    "dev": "nodemon src/index.js",
+    "start": "node src/index.js"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.0"
+  }
+}

package/templates/js-esm/src/index.js

@@ -0,0 +1,16 @@
+import "dotenv/config";
+import express from "express";
+import { {{ROUTER_NAME}} } from "./routes/index.js";
+import { errorHandler } from "./utils/errorHandler.js";
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+app.use("/api", {{ROUTER_NAME}});
+app.use(errorHandler);
+
+app.listen(PORT, () => console.log(`Server running on port ${PORT}`));
+
+export default app;

package/templates/js-esm/src/routes/index.js

@@ -0,0 +1,9 @@
+import { Router } from "express";
+import { asyncHandler } from "../utils/asyncHandler.js";
+import { ApiResponse } from "../utils/apiResponse.js";
+
+export const {{ROUTER_NAME}} = Router();
+
+{{ROUTER_NAME}}.get("/health", asyncHandler(async (req, res) => {
+  res.status(200).json(new ApiResponse(200, "Server is healthy", { status: "ok" }));
+}));

package/templates/js-esm/src/utils/apiError.js

@@ -0,0 +1,15 @@
+export class ApiError extends Error {
+    constructor(statusCode = 500, message = "", errors = [], stack = "") {
+        super(message);
+        this.statusCode = statusCode;
+        this.message = message;
+        this.success = false;
+        this.errors = errors;
+
+        if (stack) {
+            this.stack = stack;
+        } else {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}

package/templates/js-esm/src/utils/apiResponse.js

@@ -0,0 +1,8 @@
+export class ApiResponse {
+    constructor(statusCode = 200, message = "Success", data = {}) {
+        this.statusCode = statusCode;
+        this.message = message;
+        this.data = data;
+        this.success = statusCode < 400;
+    }
+}

package/templates/js-esm/src/utils/asyncHandler.js

@@ -0,0 +1,6 @@
+export const asyncHandler = (requestHandler) => {
+    return function (req, res, next) {
+        Promise.resolve(requestHandler(req, res, next))
+            .catch((error) => next(error));
+    };
+};

package/templates/js-esm/src/utils/errorHandler.js

@@ -0,0 +1,21 @@
+import { ApiError } from "./apiError.js";
+
+export const errorHandler = (err, req, res, next) => {
+    if (res.headersSent) {
+        return next(err);
+    }
+
+    if (err instanceof ApiError) {
+        res.status(err.statusCode).json({
+            success: false,
+            message: err.message,
+            errors: err.errors,
+        });
+    } else {
+        res.status(500).json({
+            success: false,
+            message: err.message,
+            errors: [],
+        });
+    }
+};

package/templates/ts/.env.example

@@ -0,0 +1,2 @@
+PORT=3000
+NODE_ENV=development

package/templates/ts/gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+.env
+*.log

package/templates/ts/package.json.template

@@ -0,0 +1,23 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "ts-node-dev --require tsconfig-paths/register --respawn --transpile-only src/index.ts",
+    "build": "tsc && tsc-alias",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.5",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.12.7",
+    "ts-node-dev": "^2.0.0",
+    "tsconfig-paths": "^4.2.0",
+    "tsc-alias": "^1.8.10"
+  }
+}

package/templates/ts/src/index.ts

@@ -0,0 +1,16 @@
+import "dotenv/config";
+import express from "express";
+import { {{ROUTER_NAME}} } from "@/routes/index";
+import { errorHandler } from "@/utils/errorHandler";
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+app.use("/api", {{ROUTER_NAME}});
+app.use(errorHandler);
+
+app.listen(PORT, () => console.log(`Server running on port ${PORT}`));
+
+export default app;

package/templates/ts/src/routes/index.ts

@@ -0,0 +1,9 @@
+import { Router } from "express";
+import { asyncHandler } from "@/utils/asyncHandler";
+import { ApiResponse } from "@/utils/apiResponse";
+
+export const {{ROUTER_NAME}} = Router();
+
+{{ROUTER_NAME}}.get("/health", asyncHandler(async (req: any, res: any) => {
+  res.status(200).json(new ApiResponse(200, "Server is healthy", { status: "ok" }));
+}));

package/templates/ts/src/utils/apiError.ts

@@ -0,0 +1,20 @@
+export class ApiError extends Error {
+    statusCode: number
+    message: string
+    success: boolean
+    errors: string[]
+
+    constructor(statusCode = 500, message = "", errors = [], stack = "") {
+        super(message)
+        this.statusCode = statusCode
+        this.message = message
+        this.success = false
+        this.errors = errors
+
+        if (stack) {
+            this.stack = stack
+        } else {
+            Error.captureStackTrace(this, this.constructor)
+        }
+    }
+}

package/templates/ts/src/utils/apiResponse.ts

@@ -0,0 +1,13 @@
+export class ApiResponse {
+    statusCode: number
+    message: string
+    data: Object
+    success: boolean
+
+    constructor(statusCode: number = 200, message: string = "Success", data?: Object) {
+        this.statusCode = statusCode
+        this.message = message
+        this.data = data || {}
+        this.success = statusCode < 400
+    }
+}

package/templates/ts/src/utils/asyncHandler.ts

@@ -0,0 +1,8 @@
+import type{ Request, Response, NextFunction } from "express"
+
+export const asyncHandler = (requestHandler: Function) => {
+    return function (req: Request, res: Response, next: NextFunction) {
+        Promise.resolve(requestHandler(req, res, next))
+            .catch((error) => { next(error) })
+    }
+}

package/templates/ts/src/utils/errorHandler.ts

@@ -0,0 +1,22 @@
+import { ApiError } from "@/utils/apiError";
+import type { NextFunction, Request, Response } from "express";
+
+export const errorHandler = (err: Error, req: Request, res: Response, next: NextFunction) => {
+    if (res.headersSent) {
+        return next(err);
+    }
+
+    if (err instanceof ApiError) {
+        res.status(err.statusCode).json({
+            success: false,
+            message: err.message,
+            errors: err.errors,
+        });
+    } else {
+        res.status(500).json({
+            success: false,
+            message: err.message,
+            errors: [],
+        });
+    }
+};

package/templates/ts/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}