express-ts-wizard 0.1.0

package/dist/actions.d.ts

@@ -0,0 +1,16 @@
+import type { TsStrictness, UserChoices } from "./prompts.js";
+/**
+ * Creates a new Express + TypeScript project based on user choices.
+ * Handles directory creation, file copying, dependency installation, and Git initialization.
+ * @param {UserChoices} choices - User selections from the wizard
+ * @returns {Promise<void>} Resolves when the project is fully created
+ * @throws {Error} If the target directory already exists or file operations fail
+ */
+export declare function createProject(choices: UserChoices): Promise<void>;
+/**
+ * Returns a human-readable description of the TypeScript strictness level.
+ * @param {TsStrictness} level - The strictness level
+ * @returns {string} A formatted description of the strictness level
+ */
+export declare function getTsStrictnessDescription(level: TsStrictness): string;
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA0F9D;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCvE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAOtE"}

package/dist/actions.js

@@ -0,0 +1,133 @@
+import * as p from "@clack/prompts";
+import fs from "fs-extra";
+import path from "path";
+import { execa } from "execa";
+import { fileURLToPath } from "url";
+const currentFilePath = fileURLToPath(import.meta.url);
+const currentDirectory = path.dirname(currentFilePath);
+/**
+ * Resolves the templates directory path.
+ * Works in both development (src/templates) and production (dist/templates) environments.
+ * @returns {string} The absolute path to the templates directory
+ */
+function getTemplatesDirectory() {
+    const productionPath = path.join(currentDirectory, "templates");
+    const developmentPath = path.join(currentDirectory, "..", "src", "templates");
+    if (fs.existsSync(productionPath)) {
+        return productionPath;
+    }
+    return developmentPath;
+}
+/**
+ * Copies template files to the target project directory.
+ * @param {string} templatesDirectory - Path to the templates directory
+ * @param {string} projectPath - Path to the new project directory
+ * @param {string} projectName - Name of the project for package.json
+ * @param {TsStrictness} tsStrictness - TypeScript strictness level to use
+ * @returns {Promise<void>} Resolves when all files are copied
+ * @throws {Error} If file operations fail
+ */
+async function copyProjectFiles(templatesDirectory, projectPath, projectName, tsStrictness) {
+    await fs.ensureDir(path.join(projectPath, "src"));
+    const sourceIndexPath = path.join(templatesDirectory, "base", "src", "index.ts");
+    await fs.copy(sourceIndexPath, path.join(projectPath, "src", "index.ts"));
+    const gitignoreSourcePath = path.join(templatesDirectory, "base", "gitignore");
+    await fs.copy(gitignoreSourcePath, path.join(projectPath, ".gitignore"));
+    const packageTemplateContent = await fs.readFile(path.join(templatesDirectory, "base", "package.template.json"), "utf-8");
+    const packageJsonContent = packageTemplateContent.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
+    await fs.writeFile(path.join(projectPath, "package.json"), packageJsonContent);
+    const tsconfigSourcePath = path.join(templatesDirectory, "tsconfig", `${tsStrictness}.json`);
+    await fs.copy(tsconfigSourcePath, path.join(projectPath, "tsconfig.json"));
+}
+/**
+ * Installs npm dependencies in the project directory.
+ * @param {string} projectPath - Path to the project directory
+ * @returns {Promise<void>} Resolves when dependencies are installed
+ * @throws {Error} If npm install fails
+ */
+async function installDependencies(projectPath) {
+    await execa("npm", ["install"], {
+        cwd: projectPath,
+        stdio: "pipe",
+    });
+}
+/**
+ * Initializes a Git repository with an initial commit.
+ * @param {string} projectPath - Path to the project directory
+ * @returns {Promise<void>} Resolves when Git is initialized and first commit is made
+ * @throws {Error} If git commands fail
+ */
+async function initializeGitRepository(projectPath) {
+    await execa("git", ["init"], {
+        cwd: projectPath,
+        stdio: "pipe",
+    });
+    await execa("git", ["add", "."], {
+        cwd: projectPath,
+        stdio: "pipe",
+    });
+    await execa("git", ["commit", "-m", "Initial commit from express-ts-wizard"], {
+        cwd: projectPath,
+        stdio: "pipe",
+    });
+}
+/**
+ * Creates a new Express + TypeScript project based on user choices.
+ * Handles directory creation, file copying, dependency installation, and Git initialization.
+ * @param {UserChoices} choices - User selections from the wizard
+ * @returns {Promise<void>} Resolves when the project is fully created
+ * @throws {Error} If the target directory already exists or file operations fail
+ */
+export async function createProject(choices) {
+    const { projectName, tsStrictness, initGit } = choices;
+    const projectPath = path.resolve(process.cwd(), projectName);
+    const templatesDirectory = getTemplatesDirectory();
+    if (fs.existsSync(projectPath)) {
+        p.cancel(`Directory "${projectName}" already exists.`);
+        process.exit(1);
+    }
+    const spinner = p.spinner();
+    spinner.start("Creating project structure...");
+    try {
+        await copyProjectFiles(templatesDirectory, projectPath, projectName, tsStrictness);
+        spinner.stop("Project structure created ✓");
+    }
+    catch (error) {
+        spinner.stop("Error creating structure");
+        throw error;
+    }
+    spinner.start("Installing dependencies...");
+    try {
+        await installDependencies(projectPath);
+        spinner.stop("Dependencies installed ✓");
+    }
+    catch (error) {
+        spinner.stop("Error installing dependencies");
+        throw error;
+    }
+    if (initGit) {
+        spinner.start("Initializing Git...");
+        try {
+            await initializeGitRepository(projectPath);
+            spinner.stop("Git initialized ✓");
+        }
+        catch {
+            spinner.stop("Error initializing Git (may not be installed)");
+            // Git initialization is optional, so we don't throw
+        }
+    }
+}
+/**
+ * Returns a human-readable description of the TypeScript strictness level.
+ * @param {TsStrictness} level - The strictness level
+ * @returns {string} A formatted description of the strictness level
+ */
+export function getTsStrictnessDescription(level) {
+    const descriptions = {
+        relaxed: "Relaxed (strict: false)",
+        moderate: "Moderate (strict: true)",
+        strict: "Strict (maximum options)",
+    };
+    return descriptions[level];
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import * as p from "@clack/prompts";
+import kleur from "kleur";
+import { runPrompts } from "./prompts.js";
+import { createProject, getTsStrictnessDescription } from "./actions.js";
+/**
+ * Displays the final success message with next steps for the user.
+ * @param {string} projectName - Name of the created project
+ * @param {string} strictnessDescription - Human-readable TypeScript strictness level
+ * @returns {void}
+ */
+function displaySuccessMessage(projectName, strictnessDescription) {
+    const nextSteps = [
+        `cd ${projectName}`,
+        "npm run dev     → Start server with hot-reload",
+        "npm run build   → Compile to JavaScript",
+        "npm run start   → Run the compiled version",
+        "npm run type-check → Check types without compiling",
+    ];
+    p.note(nextSteps.join("\n"), "Next steps");
+    p.outro(kleur.green("✔") +
+        ` Project ${kleur.cyan(projectName)} created with TypeScript ${kleur.yellow(strictnessDescription)}`);
+}
+/**
+ * Main entry point for the CLI wizard.
+ * Orchestrates the prompt collection, project creation, and success messaging.
+ * @returns {Promise<void>} Resolves when the CLI completes or exits on error
+ */
+async function main() {
+    console.clear();
+    const choices = await runPrompts();
+    if (!choices) {
+        process.exit(0);
+    }
+    console.log();
+    try {
+        await createProject(choices);
+        const strictnessDescription = getTsStrictnessDescription(choices.tsStrictness);
+        displaySuccessMessage(choices.projectName, strictnessDescription);
+    }
+    catch (error) {
+        p.cancel("Error creating project");
+        console.error(error);
+        process.exit(1);
+    }
+}
+main();
+//# 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,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAEzE;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,WAAmB,EAAE,qBAA6B;IAC/E,MAAM,SAAS,GAAG;QAChB,MAAM,WAAW,EAAE;QACnB,gDAAgD;QAChD,yCAAyC;QACzC,4CAA4C;QAC5C,oDAAoD;KACrD,CAAC;IAEF,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;IAE3C,CAAC,CAAC,KAAK,CACL,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;QACd,YAAY,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,4BAA4B,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,CACvG,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IAEnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,qBAAqB,GAAG,0BAA0B,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC/E,qBAAqB,CAAC,OAAO,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,15 @@
+/** Available TypeScript strictness levels for project configuration */
+export type TsStrictness = "relaxed" | "moderate" | "strict";
+/** User selections from the interactive wizard */
+export interface UserChoices {
+    readonly projectName: string;
+    readonly tsStrictness: TsStrictness;
+    readonly initGit: boolean;
+}
+/**
+ * Runs the interactive CLI wizard to collect user preferences.
+ * Displays prompts for project name, TypeScript strictness, and Git initialization.
+ * @returns {Promise<UserChoices | null>} The user's choices, or null if cancelled
+ */
+export declare function runPrompts(): Promise<UserChoices | null>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE7D,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwD9D"}

package/dist/prompts.js

@@ -0,0 +1,56 @@
+import * as p from "@clack/prompts";
+import kleur from "kleur";
+/**
+ * Runs the interactive CLI wizard to collect user preferences.
+ * Displays prompts for project name, TypeScript strictness, and Git initialization.
+ * @returns {Promise<UserChoices | null>} The user's choices, or null if cancelled
+ */
+export async function runPrompts() {
+    p.intro(kleur.bgCyan().black(" express-ts-wizard "));
+    const project = await p.group({
+        projectName: () => p.text({
+            message: "What is your project name?",
+            placeholder: "my-express-app",
+            defaultValue: "my-express-app",
+            validate: (value) => {
+                if (!value)
+                    return "Project name is required";
+                if (!/^[a-z0-9-_]+$/i.test(value)) {
+                    return "Only letters, numbers, hyphens and underscores allowed";
+                }
+            },
+        }),
+        tsStrictness: () => p.select({
+            message: "Which TypeScript strictness level do you prefer?",
+            options: [
+                {
+                    value: "relaxed",
+                    label: "Relaxed",
+                    hint: "strict: false - Minimal configuration",
+                },
+                {
+                    value: "moderate",
+                    label: "Moderate",
+                    hint: "strict: true - Recommended",
+                },
+                {
+                    value: "strict",
+                    label: "Strict",
+                    hint: "strict + additional options - Maximum type safety",
+                },
+            ],
+            initialValue: "moderate",
+        }),
+        initGit: () => p.confirm({
+            message: "Initialize Git repository?",
+            initialValue: true,
+        }),
+    }, {
+        onCancel: () => {
+            p.cancel("Operation cancelled.");
+            process.exit(0);
+        },
+    });
+    return project;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,KAAK,CAC3B;QACE,WAAW,EAAE,GAAG,EAAE,CAChB,CAAC,CAAC,IAAI,CAAC;YACL,OAAO,EAAE,4BAA4B;YACrC,WAAW,EAAE,gBAAgB;YAC7B,YAAY,EAAE,gBAAgB;YAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClB,IAAI,CAAC,KAAK;oBAAE,OAAO,0BAA0B,CAAC;gBAC9C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAClC,OAAO,wDAAwD,CAAC;gBAClE,CAAC;YACH,CAAC;SACF,CAAC;QAEJ,YAAY,EAAE,GAAG,EAAE,CACjB,CAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,kDAAkD;YAC3D,OAAO,EAAE;gBACP;oBACE,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,SAAS;oBAChB,IAAI,EAAE,uCAAuC;iBAC9C;gBACD;oBACE,KAAK,EAAE,UAAU;oBACjB,KAAK,EAAE,UAAU;oBACjB,IAAI,EAAE,4BAA4B;iBACnC;gBACD;oBACE,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,QAAQ;oBACf,IAAI,EAAE,mDAAmD;iBAC1D;aACF;YACD,YAAY,EAAE,UAA0B;SACzC,CAAC;QAEJ,OAAO,EAAE,GAAG,EAAE,CACZ,CAAC,CAAC,OAAO,CAAC;YACR,OAAO,EAAE,4BAA4B;YACrC,YAAY,EAAE,IAAI;SACnB,CAAC;KACL,EACD;QACE,QAAQ,EAAE,GAAG,EAAE;YACb,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;KACF,CACF,CAAC;IAEF,OAAO,OAAsB,CAAC;AAChC,CAAC"}

package/dist/templates/base/gitignore

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+
+# Testing
+coverage/
+
+# Misc
+*.tsbuildinfo

package/dist/templates/base/package.template.json

@@ -0,0 +1,28 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "description": "Express.js API with TypeScript",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "start": "node dist/index.js"
+  },
+  "keywords": ["express", "typescript", "api"],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "express": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3",
+    "tsx": "^4.19.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/dist/templates/base/src/index.ts

@@ -0,0 +1,28 @@
+import express, { Request, Response } from "express";
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+app.use(express.json());
+
+/**
+ * Health check endpoint for monitoring and load balancer probes.
+ * @param {Request} _request - Express request object (unused)
+ * @param {Response} response - Express response object
+ */
+app.get("/health", (_request: Request, response: Response) => {
+  response.json({ status: "ok", timestamp: new Date().toISOString() });
+});
+
+/**
+ * Root endpoint returning a welcome message.
+ * @param {Request} _request - Express request object (unused)
+ * @param {Response} response - Express response object
+ */
+app.get("/", (_request: Request, response: Response) => {
+  response.json({ message: "Welcome to your Express + TypeScript API!" });
+});
+
+app.listen(PORT, () => {
+  console.log(`🚀 Server running at http://localhost:${PORT}`);
+});

package/dist/templates/tsconfig/moderate.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/templates/tsconfig/relaxed.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/templates/tsconfig/strict.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "express-ts-wizard",
+  "version": "0.1.0",
+  "description": "CLI wizard to create Express.js projects with TypeScript",
+  "type": "module",
+  "bin": {
+    "express-ts-wizard": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc && npm run copy-templates",
+    "copy-templates": "cp -r src/templates dist/",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "express",
+    "typescript",
+    "cli",
+    "generator",
+    "scaffold",
+    "create"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.8.2",
+    "execa": "^9.5.2",
+    "fs-extra": "^11.2.0",
+    "kleur": "^4.1.5"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3",
+    "tsx": "^4.19.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}