@appinit/cli 1.1.0 → 1.3.0

package/dist/templates/backend-express/.appinit-generate/project/src/server.ts

@@ -0,0 +1,54 @@
+import { app } from "./app";
+import { logger } from "./utils/logger";
+
+// Assuming the Pino logger from before
+
+const PORT = process.env.PORT || 3001;
+
+const server = app.listen(PORT, () => {
+  logger.info(`🚀 Server version 1.0.0 started`);
+  logger.info(`📡 Listening on http://localhost:${PORT}`);
+  logger.info(`🌍 Environment: ${process.env.NODE_ENV || "development"}`);
+});
+
+/**
+ * GRACEFUL SHUTDOWN LOGIC
+ * Ensures the server closes existing connections before exiting.
+ */
+const shutdown = (signal: string) => {
+  logger.info(`${signal} received. Starting graceful shutdown...`);
+
+  server.close(() => {
+    logger.info("⛔ HTTP server closed.");
+
+    // Close database connections here (e.g., prisma.$disconnect() or mongoose.connection.close())
+
+    process.exit(0);
+  });
+
+  // Force close after 10 seconds if graceful shutdown fails
+  setTimeout(() => {
+    logger.error(
+      "Could not close connections in time, forcefully shutting down",
+    );
+    process.exit(1);
+  }, 10000);
+};
+
+// Listen for termination signals
+process.on("SIGTERM", () => shutdown("SIGTERM"));
+process.on("SIGINT", () => shutdown("SIGINT"));
+
+/**
+ * UNHANDLED REJECTION/EXCEPTION CATCHING
+ * Prevents the process from crashing silently.
+ */
+process.on("unhandledRejection", (reason, promise) => {
+  logger.fatal({ promise, reason }, "Unhandled Rejection at Promise");
+  throw reason; // Let uncaughtException handle it
+});
+
+process.on("uncaughtException", (error) => {
+  logger.fatal(error, "Uncaught Exception thrown");
+  process.exit(1);
+});

package/dist/templates/backend-express/.appinit-generate/project/src/utils/logger.ts

@@ -0,0 +1,21 @@
+import pino from "pino";
+
+import { env } from "../config/env.js";
+
+const isProduction = process.env.NODE_ENV === "production";
+
+export const logger = pino({
+  level: env.logLevel,
+  // Redact sensitive data from logs for security
+  redact: ["req.headers.authorization", "password", "confirmPassword"],
+  transport: isProduction
+    ? undefined // In production, output raw JSON for Datadog/ELK
+    : {
+        target: "pino-pretty",
+        options: {
+          colorize: true,
+          translateTime: "SYS:standard",
+          ignore: "pid,hostname",
+        },
+      },
+});

package/dist/templates/backend-express/.appinit-generate/project/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    /* Language & runtime */
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "node",
+
+    /* Project structure */
+    "rootDir": "src",
+    "outDir": "dist",
+
+    /* Interop & correctness */
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+
+    /* Safety */
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "noEmitOnError": true,
+
+    /* DX & production debugging */
+    "sourceMap": true,
+
+    /* Node environment */
+    "types": ["node", "vitest/globals"]
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "__tests__"]
+}

package/dist/templates/backend-express/.appinit-generate/project/vitest.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    globals: true,
+    clearMocks: true,
+    restoreMocks: true,
+    coverage: {
+      provider: "v8",
+      reporter: ["text", "html"],
+      exclude: ["dist", "node_modules"],
+    },
+  },
+});

package/dist/templates/backend-express/.appinit-preview/project/.appinit/project.json

@@ -0,0 +1,6 @@
+{
+  "name": "project",
+  "createdAt": "2025-12-18T14:20:37.697Z",
+  "cliVersion": "unknown",
+  "ats": "1.0"
+}

package/dist/templates/backend-express/.appinit-preview/project/.appinit/template.json

@@ -0,0 +1,6 @@
+{
+  "id": "backend.backend-express.basic",
+  "version": "1.0.0",
+  "source": "builtin",
+  "installedAt": "2025-12-18T14:20:37.699Z"
+}

package/dist/templates/backend-express/.appinit-preview/project/.env.example

@@ -0,0 +1,4 @@
+NODE_ENV=development
+PORT=3001
+LOG_LEVEL=debug
+CORS_ORIGIN=*

package/dist/templates/backend-express/.appinit-preview/project/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/dist/templates/backend-express/.appinit-preview/project/.prettierignore

@@ -0,0 +1,3 @@
+# Ignore artifacts:
+build
+coverage

package/dist/templates/backend-express/.appinit-preview/project/.prettierrc

@@ -0,0 +1,28 @@
+{
+  "arrowParens": "always",
+  "bracketSameLine": false,
+  "objectWrap": "preserve",
+  "bracketSpacing": true,
+  "semi": true,
+  "experimentalOperatorPosition": "end",
+  "experimentalTernaries": false,
+  "singleQuote": false,
+  "jsxSingleQuote": false,
+  "quoteProps": "as-needed",
+  "trailingComma": "all",
+  "singleAttributePerLine": false,
+  "htmlWhitespaceSensitivity": "css",
+  "vueIndentScriptAndStyle": false,
+  "proseWrap": "preserve",
+  "endOfLine": "lf",
+  "insertPragma": false,
+  "printWidth": 80,
+  "requirePragma": false,
+  "tabWidth": 2,
+  "useTabs": false,
+  "embeddedLanguageFormatting": "auto",
+  "importOrder": ["^@core/(.*)$", "^@server/(.*)$", "^@ui/(.*)$", "^[./]"],
+  "importOrderSeparation": true,
+  "importOrderSortSpecifiers": true,
+  "plugins": ["@trivago/prettier-plugin-sort-imports"]
+}

package/dist/templates/backend-express/.appinit-preview/project/.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "eslint.format.enable": false,
+  "prettier.requireConfig": true
+}

package/dist/templates/backend-express/.appinit-preview/project/Dockerfile

@@ -0,0 +1,14 @@
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM node:20-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+EXPOSE 3001
+CMD ["node", "dist/server.js"]

package/dist/templates/backend-express/.appinit-preview/project/README.md

@@ -0,0 +1,26 @@
+# ⚛️ backend-express
+
+This project was generated using **AppInit 1.0**.
+
+## 🚀 Quick Start
+
+```bash
+pnpm install
+pnpm dev
+```
+
+## 🛠️ Stack Configuration
+
+- **Framework**: React 18+ (Vite)
+- **Engine Used**:
+- **Generated At**:
+
+## 📂 Project Structure
+
+- `src/`: Your React components and logic.
+- `public/`: Static assets (images, icons).
+- `tailwind.config.js`: Styling configuration.
+
+---
+
+_Built with speed using the AppInit Scaffolding Engine._

package/dist/templates/backend-express/.appinit-preview/project/eslint.config.js

@@ -0,0 +1,76 @@
+import js from "@eslint/js";
+import tsPlugin from "@typescript-eslint/eslint-plugin";
+import tsParser from "@typescript-eslint/parser";
+import prettier from "eslint-config-prettier";
+
+export default [
+  // ─────────────────────────────────────────────
+  // Global ignores (ESLint v9 way)
+  // ─────────────────────────────────────────────
+  {
+    ignores: ["dist/**", "node_modules/**", "coverage/**"],
+  },
+
+  // ─────────────────────────────────────────────
+  // Base JS rules
+  // ─────────────────────────────────────────────
+  js.configs.recommended,
+
+  // ─────────────────────────────────────────────
+  // TypeScript (Node backend)
+  // ─────────────────────────────────────────────
+  {
+    files: ["src/**/*.ts"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        project: "./tsconfig.json",
+        sourceType: "module",
+      },
+      globals: {
+        process: "readonly",
+        console: "readonly",
+        setTimeout: "readonly",
+        clearTimeout: "readonly",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin,
+    },
+    rules: {
+      /* Disable base JS rules */
+      "no-undef": "off",
+      "no-unused-vars": "off",
+
+      /* TypeScript correctness */
+      "@typescript-eslint/no-unused-vars": [
+        "warn",
+        { argsIgnorePattern: "^_" },
+      ],
+      "@typescript-eslint/no-floating-promises": "error",
+      "@typescript-eslint/no-misused-promises": "error",
+
+      /* Production discipline */
+      "no-console": "error",
+      "no-debugger": "error",
+
+      /* Reality */
+      "@typescript-eslint/no-explicit-any": "off",
+    },
+  },
+
+  // ─────────────────────────────────────────────
+  // Allow console ONLY in env bootstrap
+  // ─────────────────────────────────────────────
+  {
+    files: ["src/config/env.ts"],
+    rules: {
+      "no-console": "off",
+    },
+  },
+
+  // ─────────────────────────────────────────────
+  // Disable formatting rules (Prettier owns formatting)
+  // ─────────────────────────────────────────────
+  prettier,
+];

package/dist/templates/backend-express/.appinit-preview/project/nodemon.json

@@ -0,0 +1,8 @@
+{
+  "watch": ["src"],
+  "ext": "ts",
+  "ignore": ["dist", "node_modules"],
+  "exec": "tsx src/server.ts",
+  "signal": "SIGTERM",
+  "delay": "100"
+}

package/dist/templates/backend-express/.appinit-preview/project/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "my-express-app",
+  "description": "%%description | default:'Backend API built with AppInit'%%",
+  "author": "",
+  "license": "",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "nodemon",
+    "clean": "rimraf dist",
+    "build": "npm run clean && tsc",
+    "start": "node dist/server.js",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "**/*": "prettier --write --ignore-unknown"
+  },
+  "main": "index.js",
+  "keywords": [],
+  "dependencies": {
+    "compression": "^1.8.1",
+    "cors": "^2.8.5",
+    "dotenv": "^17.2.3",
+    "express": "^5.2.1",
+    "helmet": "^8.1.0",
+    "http-errors": "^2.0.1",
+    "pino": "^10.1.0",
+    "pino-http": "^11.0.0",
+    "uuid": "^13.0.0",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@trivago/prettier-plugin-sort-imports": "^6.0.0",
+    "@types/compression": "^1.8.1",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/morgan": "^1.9.10",
+    "@types/node": "^25.0.2",
+    "@types/supertest": "^6.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.0",
+    "@typescript-eslint/parser": "^8.50.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "morgan": "^1.10.1",
+    "nodemon": "^3.1.11",
+    "pino-pretty": "^13.1.3",
+    "prettier": "3.7.4",
+    "rimraf": "^6.1.2",
+    "supertest": "^7.1.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/dist/templates/backend-express/.appinit-preview/project/src/__tests__/health.test.ts

@@ -0,0 +1,19 @@
+import request from "supertest";
+
+import { app } from "../app.js";
+
+describe("Health endpoints", () => {
+  it("GET /health should return ok", async () => {
+    const res = await request(app).get("/api/health");
+
+    expect(res.status).toBe(200);
+    expect(res.body).toEqual({ status: "ok" });
+  });
+
+  it("GET /ready should return ready", async () => {
+    const res = await request(app).get("/api/health/ready");
+
+    expect(res.status).toBe(200);
+    expect(res.body).toEqual({ ready: true });
+  });
+});

package/dist/templates/backend-express/.appinit-preview/project/src/__tests__/validation.test.ts

@@ -0,0 +1,36 @@
+import request from "supertest";
+
+import { app } from "../app.js";
+
+describe("Zod validation errors", () => {
+  it("returns 400 with field errors", async () => {
+    const res = await request(app)
+      .post("/api/users")
+      .send({ email: "invalid", password: "123" });
+
+    expect(res.status).toBe(400);
+    expect(res.body).toEqual({
+      error: {
+        code: "VALIDATION_ERROR",
+        message: "Invalid request",
+        fields: {
+          "body.email": ["Invalid email address"],
+          "body.password": [
+            "Too small: expected string to have >=8 characters",
+          ],
+        },
+      },
+    });
+  });
+
+  it("returns 201 with register", async () => {
+    const res = await request(app)
+      .post("/api/users")
+      .send({ email: "abc@gmail.com", password: "12345678" });
+
+    expect(res.status).toBe(201);
+    expect(res.body).toEqual({
+      ok: true,
+    });
+  });
+});

package/dist/templates/backend-express/.appinit-preview/project/src/app.ts

@@ -0,0 +1,72 @@
+import compression from "compression";
+import cors from "cors";
+import express, { Express } from "express";
+import type { Request, Response } from "express";
+import helmet from "helmet";
+import morgan from "morgan";
+import path from "path";
+import { fileURLToPath } from "url";
+
+import { env } from "./config/env";
+import { notFoundHandler } from "./errors/not-found";
+import { errorHandler } from "./middleware/error-handler";
+import { httpLogger } from "./middleware/http-logger";
+import { healthRouter } from "./routes/health";
+import { userRouter } from "./routes/users";
+
+// Define __dirname for ESM
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const app: Express = express();
+
+/**
+ * 1. SECURITY MIDDLEWARE
+ */
+app.use(helmet());
+app.use(cors({ origin: env.corsOrigin }));
+
+/**
+ * 2. PERFORMANCE MIDDLEWARE
+ */
+app.use(compression());
+
+/**
+ * 3. REQUEST PARSING
+ */
+app.use(express.json({ limit: "10kb" }));
+app.use(express.urlencoded({ extended: true, limit: "10kb" }));
+
+/**
+ * 4. LOGGING & STATIC FILES
+ */
+app.use(httpLogger);
+if (process.env.NODE_ENV !== "production") {
+  app.use(morgan("dev"));
+} else {
+  app.use(morgan("combined"));
+}
+
+// Fixed static path for ESM
+app.use(express.static(path.join(__dirname, "../public")));
+
+/**
+ * 5. SETTINGS
+ */
+app.disable("x-powered-by");
+
+// route
+app.get("/", (_req: Request, res: Response) => {
+  res.status(200).json({
+    version: "1.0.0",
+  });
+});
+
+app.use("/api/health", healthRouter);
+app.use("/api/users", userRouter);
+/* 404 */
+app.use(notFoundHandler);
+
+/* error handler (LAST) */
+app.use(errorHandler);
+export { app };

package/dist/templates/backend-express/.appinit-preview/project/src/config/defaults.ts

@@ -0,0 +1,5 @@
+export const defaults = {
+  port: 3001,
+  logLevel: "info" as const,
+  corsOrigin: "*",
+};

package/dist/templates/backend-express/.appinit-preview/project/src/config/dev.ts

@@ -0,0 +1,3 @@
+export const developmentConfig = {
+  logLevel: "debug" as const,
+};

package/dist/templates/backend-express/.appinit-preview/project/src/config/env.ts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+
+import { defaults } from "./defaults";
+import { developmentConfig } from "./dev";
+import { productionConfig } from "./prod";
+import { testConfig } from "./test";
+
+/**
+ * Load dotenv ONLY outside production
+ */
+if (process.env.NODE_ENV !== "production") {
+  await import("dotenv/config");
+}
+
+/**
+ * Raw env schema (what the platform provides)
+ */
+const rawEnvSchema = z.object({
+  NODE_ENV: z
+    .enum(["development", "test", "production"])
+    .default("development"),
+  PORT: z.coerce.number().int().positive().optional(),
+  LOG_LEVEL: z
+    .enum(["fatal", "error", "warn", "info", "debug", "trace"])
+    .optional(),
+  CORS_ORIGIN: z.string().optional(),
+});
+
+/**
+ * Validate process.env
+ */
+const parsed = rawEnvSchema.safeParse(process.env);
+
+if (!parsed.success) {
+  console.error("❌ Invalid environment variables");
+  console.error(parsed.error.format());
+  process.exit(1);
+}
+
+const nodeEnv = parsed.data.NODE_ENV;
+
+/**
+ * Select environment config
+ */
+const envConfigMap = {
+  development: developmentConfig,
+  test: testConfig,
+  production: productionConfig,
+} as const;
+
+const envOverrides = envConfigMap[nodeEnv];
+
+/**
+ * Final resolved config (single export)
+ */
+export const env = {
+  nodeEnv,
+
+  port: parsed.data.PORT ?? defaults.port,
+  logLevel: parsed.data.LOG_LEVEL ?? envOverrides.logLevel ?? defaults.logLevel,
+  corsOrigin: parsed.data.CORS_ORIGIN ?? defaults.corsOrigin,
+} as const;

package/dist/templates/backend-express/.appinit-preview/project/src/config/prod.ts

@@ -0,0 +1,3 @@
+export const productionConfig = {
+  logLevel: "info" as const,
+};

package/dist/templates/backend-express/.appinit-preview/project/src/config/test.ts

@@ -0,0 +1,3 @@
+export const testConfig = {
+  logLevel: "silent" as const,
+};

package/dist/templates/backend-express/.appinit-preview/project/src/errors/app-error.ts

@@ -0,0 +1,20 @@
+export class AppError extends Error {
+  public readonly statusCode: number;
+  public readonly code: string;
+  public readonly isOperational: boolean;
+
+  constructor(
+    message: string,
+    options: {
+      statusCode?: number;
+      code?: string;
+      isOperational?: boolean;
+    } = {},
+  ) {
+    super(message);
+
+    this.statusCode = options.statusCode ?? 500;
+    this.code = options.code ?? "INTERNAL_SERVER_ERROR";
+    this.isOperational = options.isOperational ?? true;
+  }
+}

package/dist/templates/backend-express/.appinit-preview/project/src/errors/not-found.ts

@@ -0,0 +1,16 @@
+import type { NextFunction, Request, Response } from "express";
+
+import { AppError } from "../errors/app-error.js";
+
+export function notFoundHandler(
+  _req: Request,
+  _res: Response,
+  next: NextFunction,
+) {
+  next(
+    new AppError("Route not found", {
+      statusCode: 404,
+      code: "NOT_FOUND",
+    }),
+  );
+}