express-project-init 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,109 @@
-# Temporary Holding Version
+# ExpressKit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Scaffold a clean Express API in seconds — JavaScript or TypeScript.**
+
+[![Watch the ExpressKit demo](docs/demo.jpg)](docs/demo.mp4)
+
+ExpressKit asks four questions, then writes a ready-to-run Express 5 project. Choose JavaScript or TypeScript, optionally add centralized error handling, and start building.
+
+## Quick start
+
+Requires **Node.js 20+**.
+
+```bash
+npm create expresskit@latest
+```
+
+Or run it directly:
+
+```bash
+npx create-expresskit@latest
+```
+
+Answer the prompts:
+
+```text
+? Project name › my-api
+? Language › TypeScript
+? Create central error handling middleware? › Yes
+? Install dependencies? › Yes
+```
+
+Then:
+
+```bash
+cd my-api
+npm run dev
+```
+
+Open <http://localhost:3000/health>.
+
+Use `.` at the project name prompt to scaffold in the current directory. ExpressKit will not overwrite existing files.
+
+## What you get
+
+```text
+my-api/
+├── package.json
+├── tsconfig.json          # TypeScript only
+└── src/
+    ├── server.ts
+    ├── app.ts
+    ├── middleware/        # with the optional error handler
+    │   ├── error.middleware.ts
+    │   └── notFound.middleware.ts
+    └── utils/
+        ├── helpers.ts
+        ├── responseHelpers.ts
+        └── AppError.ts    # with the optional error handler
+```
+
+JavaScript projects use the same layout with `.js` files and no `tsconfig.json`.
+
+### Scripts
+
+| Command | JavaScript | TypeScript |
+| --- | --- | --- |
+| `npm run dev` | `node --watch` | `tsx watch` |
+| `npm start` | `node` | `tsx` |
+| `npm run typecheck` | — | `tsc --noEmit` |
+
+## Error handling
+
+With the error handler enabled, throw `BadRequestError`, `UnauthorizedError`, or `NotFoundError` from any route and one middleware formats the response:
+
+```json
+{
+  "success": false,
+  "message": "Route not found",
+  "code": "NOT_FOUND"
+}
+```
+
+Successful responses use the same envelope with `success: true` and `data`.
+
+## How it works
+
+Projects are assembled from a base template plus optional feature layers. Feature files replace base files at the same path, and feature `package.json` fragments are merged into the base manifest.
+
+## Local development
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+Then, in a separate directory:
+
+```bash
+mkdir -p /tmp/expresskit-test
+cd /tmp/expresskit-test
+create-expresskit
+```
+
+Rebuild with `npm run build` after changing `src/`; the linked command picks up the new `dist/` automatically. Remove the global link with `npm unlink -g create-expresskit`.
+
+## License
+
+MIT

package/dist/features.js

@@ -0,0 +1,17 @@
+/**
+ * Every optional feature lives here once.
+ *
+ * To add a feature:
+ *   1. Add templates/<language>/<id>/ with the files it adds or overrides.
+ *   2. Add an entry to this array.
+ *
+ * The prompt, file layering, and package.json merging all derive from this list.
+ */
+export const FEATURES = [
+    {
+        id: "error-handler",
+        prompt: "Create central error handling middleware?",
+        defaultValue: true,
+    },
+];
+//# sourceMappingURL=features.js.map

package/dist/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB;QACE,EAAE,EAAE,eAAe;QACnB,MAAM,EAAE,2CAA2C;QACnD,YAAY,EAAE,IAAI;KACnB;CACO,CAAC"}

package/dist/index.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { spinner } from "@clack/prompts";
+import { FileService } from "./services/file.service.js";
+import { ProjectService } from "./services/project.service.js";
+import { PromptService } from "./services/prompts.service.js";
+import { TemplateService } from "./services/template.service.js";
+async function main() {
+    const promptService = new PromptService();
+    const fileService = new FileService();
+    const templateService = new TemplateService();
+    // 1. Collect every answer first — the spinner only starts after all prompts are done
+    const projectName = await promptService.askProjectName();
+    const language = await promptService.askLanguage();
+    const availableFeatures = await templateService.getAvailableFeatures(language);
+    const features = await promptService.askFeatureAnswers(availableFeatures);
+    const installDependencies = await promptService.askShouldInstall();
+    const answers = {
+        projectName,
+        language,
+        features,
+        installDependencies,
+    };
+    // 2. Run the commands behind a spinner
+    const loading = spinner();
+    loading.start("Creating project");
+    try {
+        const projectPath = await fileService.createDirectory(projectName);
+        const projectService = new ProjectService(projectPath, answers);
+        await projectService.createProject();
+        if (installDependencies) {
+            loading.message("Installing dependencies");
+            await projectService.runInstallCommand();
+        }
+        loading.stop(`Created ${language} project at ${projectPath}`);
+    }
+    catch (error) {
+        loading.error("Project creation failed");
+        throw error;
+    }
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : "An unexpected error occurred";
+    console.error(`ExpressKit: ${message}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,KAAK,UAAU,IAAI;IACjB,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IACtC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAE9C,qFAAqF;IACrF,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,cAAc,EAAE,CAAC;IACzD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC;IACnD,MAAM,iBAAiB,GACrB,MAAM,eAAe,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAC1E,MAAM,mBAAmB,GAAG,MAAM,aAAa,CAAC,gBAAgB,EAAE,CAAC;IAEnE,MAAM,OAAO,GAAmB;QAC9B,WAAW;QACX,QAAQ;QACR,QAAQ;QACR,mBAAmB;KACpB,CAAC;IAEF,uCAAuC;IACvC,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACnE,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,cAAc,CAAC,aAAa,EAAE,CAAC;QAErC,IAAI,mBAAmB,EAAE,CAAC;YACxB,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;YAC3C,MAAM,cAAc,CAAC,iBAAiB,EAAE,CAAC;QAC3C,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,WAAW,QAAQ,eAAe,WAAW,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACzC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC;IAEtE,OAAO,CAAC,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/services/file.service.js

@@ -0,0 +1,73 @@
+import { access, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+export class FileService {
+    async createDirectory(projectName) {
+        const dirPath = path.resolve(process.cwd(), projectName);
+        try {
+            await mkdir(dirPath, { recursive: true });
+            return dirPath;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown filesystem error";
+            throw new Error(`Failed to create project directory "${dirPath}": ${message}`, { cause: error });
+        }
+    }
+    /**
+     * Writes the complete, already-composed project in one pass.
+     * Every destination is checked before the first file is written.
+     */
+    async writeFiles(projectDirectory, files) {
+        const entries = Object.entries(files);
+        if (entries.length === 0) {
+            throw new Error("No files to create.");
+        }
+        const destinations = entries.map(([relativePath, contents]) => ({
+            relativePath,
+            contents,
+            absolutePath: this.resolveProjectPath(projectDirectory, relativePath),
+        }));
+        const existingFiles = await this.getExistingFiles(destinations);
+        if (existingFiles.length > 0) {
+            throw new Error(`Cannot create project: these files already exist in "${projectDirectory}": ${existingFiles.join(", ")}`);
+        }
+        const results = await Promise.allSettled(destinations.map(({ absolutePath, contents }) => this.writeFile(absolutePath, contents)));
+        const failures = results.filter((result) => result.status === "rejected");
+        if (failures.length > 0) {
+            throw new Error(`Failed to create ${failures.length} of ${entries.length} files.`, { cause: failures.map((failure) => failure.reason) });
+        }
+    }
+    resolveProjectPath(projectDirectory, relativePath) {
+        if (!relativePath.trim() || path.isAbsolute(relativePath)) {
+            throw new Error(`Generated file path must be a non-empty relative path: "${relativePath}".`);
+        }
+        const projectRoot = path.resolve(projectDirectory);
+        const destination = path.resolve(projectRoot, relativePath);
+        if (destination !== projectRoot &&
+            !destination.startsWith(`${projectRoot}${path.sep}`)) {
+            throw new Error(`Generated file path escapes the project directory: "${relativePath}".`);
+        }
+        return destination;
+    }
+    async getExistingFiles(files) {
+        const checks = files.map(async ({ relativePath, absolutePath }) => {
+            try {
+                await access(absolutePath);
+                return relativePath;
+            }
+            catch {
+                return null;
+            }
+        });
+        const results = await Promise.all(checks);
+        return results.filter((file) => file !== null);
+    }
+    async writeFile(filePath, contents) {
+        await mkdir(path.dirname(filePath), { recursive: true });
+        // "wx" fails if the file exists, so we never overwrite user files.
+        await writeFile(filePath, contents, {
+            encoding: "utf-8",
+            flag: "wx",
+        });
+    }
+}
+//# sourceMappingURL=file.service.js.map

package/dist/services/file.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.service.js","sourceRoot":"","sources":["../../src/services/file.service.ts"],"names":[],"mappings":"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"}

package/dist/services/project.service.js

@@ -0,0 +1,44 @@
+import { spawn } from "node:child_process";
+import { FileService } from "./file.service.js";
+import { TemplateService } from "./template.service.js";
+export class ProjectService {
+    projectPath;
+    answers;
+    fileService;
+    templateService;
+    constructor(projectPath, answers, fileService = new FileService(), templateService = new TemplateService()) {
+        this.projectPath = projectPath;
+        this.answers = answers;
+        this.fileService = fileService;
+        this.templateService = templateService;
+    }
+    async createProject() {
+        const files = await this.templateService.buildFilePlan(this.answers);
+        // Build the whole plan first, then write it in one pass.
+        await this.fileService.writeFiles(this.projectPath, files);
+    }
+    async runInstallCommand() {
+        return new Promise((resolve, reject) => {
+            const child = spawn("npm", ["install"], {
+                cwd: this.projectPath, // run inside the NEW project, not where the CLI was launched
+                stdio: ["ignore", "ignore", "pipe"], // hide npm output from the spinner; stderr kept for errors
+                shell: process.platform === "win32",
+            });
+            let stderr = "";
+            child.stderr?.on("data", (chunk) => {
+                stderr += chunk.toString();
+            });
+            child.on("error", reject);
+            child.on("close", (code) => {
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    const details = stderr.trim();
+                    reject(new Error(`npm install failed with exit code ${code}${details ? `\n${details}` : ""}`));
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=project.service.js.map

package/dist/services/project.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.service.js","sourceRoot":"","sources":["../../src/services/project.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,OAAO,cAAc;IACR,WAAW,CAAS;IACpB,OAAO,CAAiB;IACxB,WAAW,CAAc;IACzB,eAAe,CAAkB;IAElD,YACE,WAAmB,EACnB,OAAuB,EACvB,WAAW,GAAG,IAAI,WAAW,EAAE,EAC/B,eAAe,GAAG,IAAI,eAAe,EAAE;QAEvC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,aAAa;QACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAErE,yDAAyD;QACzD,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEM,KAAK,CAAC,iBAAiB;QAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE;gBACtC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,6DAA6D;gBACpF,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,2DAA2D;gBAChG,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;aACpC,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC7B,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAE1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE;gBACjC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;oBAE9B,MAAM,CACJ,IAAI,KAAK,CACP,qCAAqC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5E,CACF,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/services/prompts.service.js

@@ -0,0 +1,63 @@
+import { cancel, confirm, isCancel, select, text } from "@clack/prompts";
+import { FEATURES } from "../features.js";
+export class PromptService {
+    LANGUAGE_OPTIONS = [
+        { value: "javascript", label: "JavaScript" },
+        { value: "typescript", label: "TypeScript" },
+    ];
+    async askProjectName() {
+        const response = await text({
+            message: "What would you like to name your project?",
+            placeholder: "my-api",
+            defaultValue: ".",
+            validate(value) {
+                if (!value?.trim()) {
+                    return "Please enter a project name or '.' to use the current directory.";
+                }
+            },
+        });
+        this.handleCancel(response);
+        return response.trim();
+    }
+    async askLanguage() {
+        const response = await select({
+            message: "Which language would you like to use?",
+            options: this.LANGUAGE_OPTIONS,
+            initialValue: "javascript",
+        });
+        this.handleCancel(response);
+        return response;
+    }
+    /**
+     * Asks one confirm per registered feature available for the chosen
+     * language. Unavailable features default to false.
+     */
+    async askFeatureAnswers(availableFeatures) {
+        const answers = Object.fromEntries(FEATURES.map((feature) => [feature.id, false]));
+        for (const feature of availableFeatures) {
+            const response = await confirm({
+                message: feature.prompt,
+                initialValue: feature.defaultValue,
+            });
+            this.handleCancel(response);
+            answers[feature.id] = response;
+        }
+        return answers;
+    }
+    async askShouldInstall() {
+        const response = await confirm({
+            message: "Install dependencies?",
+            initialValue: true,
+        });
+        this.handleCancel(response);
+        return response;
+    }
+    // Catches Ctrl+C / Esc so the CLI exits cleanly instead of crashing.
+    handleCancel(response) {
+        if (isCancel(response)) {
+            cancel("Project setup cancelled.");
+            process.exit(0);
+        }
+    }
+}
+//# sourceMappingURL=prompts.service.js.map

package/dist/services/prompts.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.service.js","sourceRoot":"","sources":["../../src/services/prompts.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAgB,MAAM,gBAAgB,CAAC;AAGxD,MAAM,OAAO,aAAa;IACP,gBAAgB,GAG3B;QACJ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;QAC5C,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;KAC7C,CAAC;IAEK,KAAK,CAAC,cAAc;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;YAC1B,OAAO,EAAE,2CAA2C;YACpD,WAAW,EAAE,QAAQ;YACrB,YAAY,EAAE,GAAG;YACjB,QAAQ,CAAC,KAAK;gBACZ,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;oBACnB,OAAO,kEAAkE,CAAC;gBAC5E,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAS,QAAQ,CAAC,CAAC;QAEpC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,WAAW;QACtB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;YAC5B,OAAO,EAAE,uCAAuC;YAChD,OAAO,EAAE,IAAI,CAAC,gBAAgB;YAC9B,YAAY,EAAE,YAAY;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAW,QAAQ,CAAC,CAAC;QAEtC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,iBAAiB,CAC5B,iBAAqC;QAErC,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAC7B,CAAC;QAEpB,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;gBAC7B,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAU,QAAQ,CAAC,CAAC;YAErC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC;QACjC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,KAAK,CAAC,gBAAgB;QAC3B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;YAC7B,OAAO,EAAE,uBAAuB;YAChC,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAU,QAAQ,CAAC,CAAC;QAErC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qEAAqE;IAC7D,YAAY,CAAI,QAAiB;QACvC,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,0BAA0B,CAAC,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF"}

package/dist/services/template.service.js

@@ -0,0 +1,152 @@
+import { access, readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { FEATURES } from "../features.js";
+const PACKAGE_SECTIONS = [
+    "dependencies",
+    "devDependencies",
+    "scripts",
+];
+export class TemplateService {
+    templateRoot;
+    constructor(templateRoot) {
+        if (templateRoot) {
+            this.templateRoot = path.resolve(templateRoot);
+            return;
+        }
+        const serviceDirectory = path.dirname(fileURLToPath(import.meta.url));
+        // templates/ sits two levels up from src/services (and dist/services).
+        this.templateRoot = path.resolve(serviceDirectory, "../../templates");
+    }
+    async getAvailableFeatures(language) {
+        const languageDirectory = path.join(this.templateRoot, language);
+        let entries;
+        try {
+            entries = await readdir(languageDirectory, { withFileTypes: true });
+        }
+        catch (error) {
+            throw new Error(`Unable to read templates for "${language}" at "${languageDirectory}".`, { cause: error });
+        }
+        const folders = new Set(entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name));
+        return FEATURES.filter((feature) => folders.has(feature.id));
+    }
+    /**
+     * Builds the complete project in memory.
+     *
+     * Base files come first. Each enabled feature is then layered on top:
+     * feature files replace base files with the same relative path, while new
+     * paths are added. package.json is the exception — feature package.json
+     * files are fragments merged into the base package.json.
+     */
+    async buildFilePlan(answers) {
+        const baseFiles = await this.readLayer(answers.language, "base");
+        const basePackageSource = baseFiles["package.json"];
+        if (basePackageSource === undefined) {
+            throw new Error(`Base template for "${answers.language}" is missing package.json.`);
+        }
+        let packageJson = this.parseJson(basePackageSource, `${answers.language}/base/package.json`);
+        let files = { ...baseFiles };
+        for (const feature of FEATURES) {
+            if (!answers.features[feature.id]) {
+                continue;
+            }
+            const layer = await this.readLayer(answers.language, feature.id);
+            const fragmentSource = layer["package.json"];
+            if (fragmentSource !== undefined) {
+                const fragment = this.parsePackageFragment(fragmentSource, feature.id);
+                packageJson = this.mergePackageJson(packageJson, fragment, feature.id);
+                // The merged package.json is written last, not copied from the layer.
+                delete layer["package.json"];
+            }
+            files = { ...files, ...layer };
+        }
+        files["package.json"] = `${JSON.stringify(packageJson, null, 2)}\n`;
+        return files;
+    }
+    async readLayer(language, layerName) {
+        const layerDirectory = path.join(this.templateRoot, language, layerName);
+        try {
+            await access(layerDirectory);
+        }
+        catch (error) {
+            throw new Error(`Template folder not found: "${language}/${layerName}".`, { cause: error });
+        }
+        return this.readDirectory(layerDirectory);
+    }
+    async readDirectory(root, relativeDirectory = "") {
+        const directory = path.join(root, relativeDirectory);
+        const entries = await readdir(directory, { withFileTypes: true });
+        const files = {};
+        for (const entry of entries) {
+            const relativePath = relativeDirectory
+                ? path.posix.join(relativeDirectory, entry.name)
+                : entry.name;
+            if (entry.isDirectory()) {
+                Object.assign(files, await this.readDirectory(root, relativePath));
+            }
+            else if (entry.isFile()) {
+                files[relativePath] = await readFile(path.join(root, relativePath), "utf8");
+            }
+        }
+        return files;
+    }
+    parsePackageFragment(source, featureId) {
+        const parsed = this.parseJson(source, `${featureId}/package.json`);
+        const unknownKeys = Object.keys(parsed).filter((key) => !PACKAGE_SECTIONS.includes(key));
+        if (unknownKeys.length > 0) {
+            throw new Error(`Feature "${featureId}" has unsupported package.json keys: ${unknownKeys.join(", ")}. Only ${PACKAGE_SECTIONS.join(", ")} can be merged.`);
+        }
+        const fragment = {};
+        for (const section of PACKAGE_SECTIONS) {
+            const value = parsed[section];
+            if (value === undefined) {
+                continue;
+            }
+            if (!this.isStringRecord(value)) {
+                throw new Error(`"${section}" in feature "${featureId}" package.json must be an object of string values.`);
+            }
+            fragment[section] = value;
+        }
+        return fragment;
+    }
+    mergePackageJson(base, fragment, featureId) {
+        const merged = { ...base };
+        for (const section of PACKAGE_SECTIONS) {
+            const additions = fragment[section];
+            if (!additions) {
+                continue;
+            }
+            const target = merged[section]
+                ? { ...merged[section] }
+                : {};
+            for (const [name, value] of Object.entries(additions)) {
+                const existing = target[name];
+                if (existing !== undefined && existing !== value) {
+                    throw new Error(`Feature "${featureId}" conflicts with package.json ${section} entry "${name}": "${existing}" (existing) vs "${value}" (feature).`);
+                }
+                target[name] = value;
+            }
+            merged[section] = target;
+        }
+        return merged;
+    }
+    isStringRecord(value) {
+        return (typeof value === "object" &&
+            value !== null &&
+            !Array.isArray(value) &&
+            Object.values(value).every((item) => typeof item === "string"));
+    }
+    parseJson(source, templatePath) {
+        try {
+            return JSON.parse(source);
+        }
+        catch (error) {
+            throw new Error(`Invalid JSON in template "${templatePath}".`, {
+                cause: error,
+            });
+        }
+    }
+}
+//# sourceMappingURL=template.service.js.map

package/dist/services/template.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.service.js","sourceRoot":"","sources":["../../src/services/template.service.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "express-project-init",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Create production-ready Express.js API projects with JavaScript or TypeScript using clean, reusable starter templates.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "express-project-init": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "clean": "node -e \"const fs=require('node:fs'); for (const p of ['dist','tsconfig.tsbuildinfo']) fs.rmSync(p,{recursive:true,force:true})\"",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepack": "npm run clean && npm run build",
+    "start": "node dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/raunak-ray/ExpressKit.git"
+  },
+  "homepage": "https://github.com/raunak-ray/ExpressKit#readme",
+  "bugs": {
+    "url": "https://github.com/raunak-ray/ExpressKit/issues"
+  },
+  "keywords": [
+    "express",
+    "expressjs",
+    "express-generator",
+    "express-cli",
+    "nodejs",
+    "api-generator",
+    "backend",
+    "project-scaffolding",
+    "boilerplate",
+    "starter-template",
+    "typescript",
+    "javascript"
+  ],
+  "author": "Raunak Ray",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^1.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2"
+  }
+}

package/templates/javascript/base/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "my-api",
+  "version": "1.0.0",
+  "description": "Express API generated by ExpressKit",
+  "type": "module",
+  "scripts": {
+    "dev": "node --watch src/server.js",
+    "start": "node src/server.js"
+  },
+  "dependencies": {
+    "express": "^5.1.0"
+  }
+}

package/templates/javascript/base/src/app.js

@@ -0,0 +1,22 @@
+import express from "express";
+import { getTimeStamp } from "./utils/helpers.js";
+import { successResponse } from "./utils/responseHelpers.js";
+
+const app = express();
+
+app.use(express.json());
+
+// Health check
+app.get("/health", (_req, res) =>
+  successResponse(res, {
+    statusCode: 200,
+    message: "API is up and running",
+    data: {
+      status: "ok",
+      uptime: Math.round(process.uptime()),
+      timestamp: getTimeStamp(),
+    },
+  }),
+);
+
+export default app;

package/templates/javascript/base/src/server.js

@@ -0,0 +1,8 @@
+import app from "./app.js";
+
+const PORT = process.env.PORT || 3000;
+
+app.listen(PORT, () => {
+  console.log(`API running on http://localhost:${PORT}`);
+  console.log(`Health check: http://localhost:${PORT}/health`);
+});

package/templates/javascript/base/src/utils/helpers.js

@@ -0,0 +1,3 @@
+export function getTimeStamp() {
+  return new Date().toISOString();
+}

package/templates/javascript/base/src/utils/responseHelpers.js

@@ -0,0 +1,19 @@
+export function successResponse(res, { statusCode = 200, message, data }) {
+  return res.status(statusCode).json({
+    success: true,
+    message,
+    data,
+  });
+}
+
+export function errorResponse(
+  res,
+  { statusCode = 500, message, code = "INTERNAL_ERROR", fields },
+) {
+  return res.status(statusCode).json({
+    success: false,
+    message,
+    code,
+    fields,
+  });
+}

package/templates/javascript/error-handler/src/app.js

@@ -0,0 +1,28 @@
+import express from "express";
+import errorMiddleware from "./middleware/error.middleware.js";
+import notFoundMiddleware from "./middleware/notFound.middleware.js";
+import { getTimeStamp } from "./utils/helpers.js";
+import { successResponse } from "./utils/responseHelpers.js";
+
+const app = express();
+
+app.use(express.json());
+
+// Health check
+app.get("/health", (_req, res) =>
+  successResponse(res, {
+    statusCode: 200,
+    message: "API is up and running",
+    data: {
+      status: "ok",
+      uptime: Math.round(process.uptime()),
+      timestamp: getTimeStamp(),
+    },
+  }),
+);
+
+// Unknown routes → 404, then every error gets formatted in one place.
+app.use(notFoundMiddleware);
+app.use(errorMiddleware);
+
+export default app;

package/templates/javascript/error-handler/src/middleware/error.middleware.js

@@ -0,0 +1,36 @@
+import { AppError, BadRequestError } from "../utils/AppError.js";
+import { errorResponse } from "../utils/responseHelpers.js";
+import { getTimeStamp } from "../utils/helpers.js";
+
+// Express error handler — needs all 4 params, that's how Express recognizes it.
+export default function errorMiddleware(error, req, res, next) {
+  const timeStamp = getTimeStamp();
+
+  // Expected errors — log them and send their details
+  if (error instanceof AppError) {
+    console.log(
+      `[${timeStamp}] [ERROR] ${req.method} ${req.originalUrl} - ${error.message}`,
+    );
+
+    return errorResponse(res, {
+      statusCode: error.statusCode,
+      message: error.message,
+      code: error.code,
+      fields: error instanceof BadRequestError ? error.fields : undefined, // fields only for bad requests
+    });
+  }
+
+  // Not an AppError — build a message if it's an Error, otherwise fall back
+  const message =
+    error instanceof Error ? error.message : "Internal server error";
+
+  console.error(
+    `[${timeStamp}] [ERROR] ${req.method} ${req.originalUrl} - ${message}`,
+    error,
+  );
+
+  return errorResponse(res, {
+    statusCode: 500,
+    message,
+  });
+}

package/templates/javascript/error-handler/src/middleware/notFound.middleware.js

@@ -0,0 +1,5 @@
+import { NotFoundError } from "../utils/AppError.js";
+
+export default function notFoundMiddleware(req, res, next) {
+  next(new NotFoundError("Route not found"));
+}

package/templates/javascript/error-handler/src/utils/AppError.js

@@ -0,0 +1,30 @@
+export class AppError extends Error {
+  constructor(message, { code = "INTERNAL_ERROR", statusCode = 500 } = {}) {
+    super(message);
+
+    this.name = this.constructor.name;
+    this.code = code; // machine-readable code, e.g. "BAD_REQUEST"
+    this.statusCode = statusCode; // HTTP status to send back
+  }
+}
+
+export class BadRequestError extends AppError {
+  // fields: validation errors, e.g. [{ field: "email", message: "required" }]
+  constructor(message = "Bad request", fields = []) {
+    super(message, { code: "BAD_REQUEST", statusCode: 400 });
+
+    this.fields = fields;
+  }
+}
+
+export class UnauthorizedError extends AppError {
+  constructor(message = "Unauthorized") {
+    super(message, { code: "UNAUTHORIZED", statusCode: 401 });
+  }
+}
+
+export class NotFoundError extends AppError {
+  constructor(message = "Not found") {
+    super(message, { code: "NOT_FOUND", statusCode: 404 });
+  }
+}

package/templates/typescript/base/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "my-api",
+  "version": "1.0.0",
+  "description": "Express API generated by ExpressKit",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "start": "tsx src/server.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "express": "^5.1.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^26.6.5",
+    "tsx": "^4.23.15",
+    "typescript": "^5.9.0"
+  }
+}

package/templates/typescript/base/src/app.ts

@@ -0,0 +1,22 @@
+import express, { type Request, type Response } from "express";
+import { getTimeStamp } from "./utils/helpers";
+import { successResponse } from "./utils/responseHelpers";
+
+const app = express();
+
+app.use(express.json());
+
+// Health check
+app.get("/health", (_req: Request, res: Response) =>
+  successResponse(res, {
+    statusCode: 200,
+    message: "API is up and running",
+    data: {
+      status: "ok",
+      uptime: Math.round(process.uptime()),
+      timestamp: getTimeStamp(),
+    },
+  }),
+);
+
+export default app;

package/templates/typescript/base/src/server.ts

@@ -0,0 +1,8 @@
+import app from "./app";
+
+const PORT = Number(process.env.PORT) || 3000;
+
+app.listen(PORT, () => {
+  console.log(`API running on http://localhost:${PORT}`);
+  console.log(`Health check: http://localhost:${PORT}/health`);
+});

package/templates/typescript/base/src/utils/helpers.ts

@@ -0,0 +1,3 @@
+export function getTimeStamp(): string {
+  return new Date().toISOString();
+}

package/templates/typescript/base/src/utils/responseHelpers.ts

@@ -0,0 +1,42 @@
+import type { Response } from "express";
+
+export type FieldError = {
+  field: string;
+  message: string;
+};
+
+type SuccessOptions<T> = {
+  statusCode?: number;
+  message: string;
+  data?: T;
+};
+
+export function successResponse<T>(
+  res: Response,
+  { statusCode = 200, message, data }: SuccessOptions<T>,
+): Response {
+  return res.status(statusCode).json({
+    success: true,
+    message,
+    data,
+  });
+}
+
+type ErrorOptions = {
+  statusCode?: number;
+  message: string;
+  code?: string;
+  fields?: FieldError[];
+};
+
+export function errorResponse(
+  res: Response,
+  { statusCode = 500, message, code = "INTERNAL_ERROR", fields }: ErrorOptions,
+): Response {
+  return res.status(statusCode).json({
+    success: false,
+    message,
+    code,
+    fields,
+  });
+}

package/templates/typescript/base/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    // Imports / modules
+    // "bundler" is THE setting that lets you import WITHOUT extensions:
+    //   import app from "./app"        (not "./app.ts")
+    "module": "esnext",            // emit modern ES module syntax
+    "moduleResolution": "bundler", // resolve imports without ".ts" extensions
+    "moduleDetection": "force",    // treat every file as an ES module (no CommonJS guessing)
+    "esModuleInterop": true,       // allow normal default imports from CJS packages (express)
+    "verbatimModuleSyntax": true,  // keep imports exactly as written; type-only imports must use "import type"
+
+    // Language level
+    "target": "esnext",            // allow the newest JS features, no downleveling
+
+    // Type checking
+    "strict": true,                // turn on all strict type checks
+    "noUnusedLocals": true,        // error on declared-but-unused variables
+    "noUnusedParameters": true,    // error on unused function parameters
+    "skipLibCheck": true,          // don't type-check ".d.ts" files inside node_modules (faster)
+
+    // Runtime types
+    "types": ["node"],             // auto-include ONLY Node types (no stray umbrella types)
+
+    // Output
+    "noEmit": true                 // tsx runs the code directly, so tsc only type-checks, never writes files
+  },
+  // Files in scope
+  "include": ["src"],               // the compiler only looks at src/
+  "exclude": ["node_modules"]       // never scan dependencies
+}

package/templates/typescript/error-handler/src/app.ts

@@ -0,0 +1,28 @@
+import express, { type Request, type Response } from "express";
+import errorMiddleware from "./middleware/error.middleware";
+import notFoundMiddleware from "./middleware/notFound.middleware";
+import { getTimeStamp } from "./utils/helpers";
+import { successResponse } from "./utils/responseHelpers";
+
+const app = express();
+
+app.use(express.json());
+
+// Health check
+app.get("/health", (_req: Request, res: Response) =>
+  successResponse(res, {
+    statusCode: 200,
+    message: "API is up and running",
+    data: {
+      status: "ok",
+      uptime: Math.round(process.uptime()),
+      timestamp: getTimeStamp(),
+    },
+  }),
+);
+
+// Unknown routes → 404, then every error gets formatted in one place.
+app.use(notFoundMiddleware);
+app.use(errorMiddleware);
+
+export default app;

package/templates/typescript/error-handler/src/middleware/error.middleware.ts

@@ -0,0 +1,42 @@
+import type { NextFunction, Request, Response } from "express";
+import { AppError, BadRequestError } from "../utils/AppError";
+import { errorResponse } from "../utils/responseHelpers";
+import { getTimeStamp } from "../utils/helpers";
+
+// Express error handler — needs all 4 params, that's how Express recognizes it.
+export default function errorMiddleware(
+  error: unknown,
+  req: Request,
+  res: Response,
+  _next: NextFunction,
+): Response {
+  const timeStamp = getTimeStamp();
+
+  // Expected errors — log them and send their details
+  if (error instanceof AppError) {
+    console.log(
+      `[${timeStamp}] [ERROR] ${req.method} ${req.originalUrl} - ${error.message}`,
+    );
+
+    return errorResponse(res, {
+      statusCode: error.statusCode,
+      message: error.message,
+      code: error.code,
+      fields: error instanceof BadRequestError ? error.fields : undefined, // fields only for bad requests
+    });
+  }
+
+  // Not an AppError — build a message if it's an Error, otherwise fall back
+  const message =
+    error instanceof Error ? error.message : "Internal server error";
+
+  console.error(
+    `[${timeStamp}] [ERROR] ${req.method} ${req.originalUrl} - ${message}`,
+    error,
+  );
+
+  return errorResponse(res, {
+    statusCode: 500,
+    message,
+  });
+}

package/templates/typescript/error-handler/src/middleware/notFound.middleware.ts

@@ -0,0 +1,10 @@
+import type { NextFunction, Request, Response } from "express";
+import { NotFoundError } from "../utils/AppError";
+
+export default function notFoundMiddleware(
+  _req: Request,
+  _res: Response,
+  next: NextFunction,
+): void {
+  next(new NotFoundError("Route not found"));
+}

package/templates/typescript/error-handler/src/utils/AppError.ts

@@ -0,0 +1,44 @@
+import type { FieldError } from "../utils/responseHelpers";
+
+export type AppErrorOptions = {
+  code?: string;
+  statusCode?: number;
+};
+
+export class AppError extends Error {
+  public readonly code: string;
+  public readonly statusCode: number;
+
+  constructor(
+    message: string,
+    { code = "INTERNAL_ERROR", statusCode = 500 }: AppErrorOptions = {},
+  ) {
+    super(message);
+
+    this.name = this.constructor.name;
+    this.code = code; // machine-readable code, e.g. "BAD_REQUEST"
+    this.statusCode = statusCode; // HTTP status to send back
+  }
+}
+
+export class BadRequestError extends AppError {
+  public readonly fields: FieldError[]; // only this error carries fields
+
+  constructor(message = "Bad request", fields: FieldError[] = []) {
+    super(message, { code: "BAD_REQUEST", statusCode: 400 });
+
+    this.fields = fields;
+  }
+}
+
+export class UnauthorizedError extends AppError {
+  constructor(message = "Unauthorized") {
+    super(message, { code: "UNAUTHORIZED", statusCode: 401 });
+  }
+}
+
+export class NotFoundError extends AppError {
+  constructor(message = "Not found") {
+    super(message, { code: "NOT_FOUND", statusCode: 404 });
+  }
+}