@appinit/cli 1.2.0 → 1.3.0

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

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

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

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

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

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

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

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

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

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

package/dist/templates/backend-express/.appinit-generate/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-generate/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-generate/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-generate/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-generate/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-generate/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-generate/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-generate/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-generate/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-generate/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-generate/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-generate/project/src/config/dev.ts

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

package/dist/templates/backend-express/.appinit-generate/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-generate/project/src/config/prod.ts

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

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

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

package/dist/templates/backend-express/.appinit-generate/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-generate/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",
+    }),
+  );
+}

package/dist/templates/backend-express/.appinit-generate/project/src/middleware/error-handler.ts

@@ -0,0 +1,73 @@
+import type { NextFunction, Request, Response } from "express";
+import { ZodError } from "zod";
+
+import { env } from "../config/env.js";
+import { AppError } from "../errors/app-error.js";
+import { logger } from "../utils/logger.js";
+
+export function errorHandler(
+  err: unknown,
+  _req: Request,
+  res: Response,
+  _next: NextFunction,
+) {
+  /**
+   * Zod validation errors (400)
+   */
+  if (err instanceof ZodError) {
+    const fieldErrors: Record<string, string[]> = {};
+
+    for (const issue of err.issues) {
+      const field = issue.path.join(".") || "root";
+      fieldErrors[field] ??= [];
+      fieldErrors[field].push(issue.message);
+    }
+
+    logger.warn({ fieldErrors }, "Request validation failed");
+
+    return res.status(400).json({
+      error: {
+        code: "VALIDATION_ERROR",
+        message: "Invalid request",
+        fields: fieldErrors,
+      },
+    });
+  }
+  // Normalize error
+  const error =
+    err instanceof AppError
+      ? err
+      : new AppError("Internal server error", {
+          statusCode: 500,
+          code: "INTERNAL_SERVER_ERROR",
+          isOperational: false,
+        });
+
+  // Log full error (always)
+  logger.error(
+    {
+      err,
+      statusCode: error.statusCode,
+      code: error.code,
+    },
+    "Unhandled application error",
+  );
+
+  // Response (safe for clients)
+  const response: Record<string, unknown> = {
+    error: {
+      code: error.code,
+      message: error.message,
+    },
+  };
+
+  // Dev-only details
+  if (env.nodeEnv !== "production") {
+    response.error = {
+      ...(response.error ?? {}),
+      details: err instanceof Error ? err.stack : err,
+    };
+  }
+
+  res.status(error.statusCode).json(response);
+}

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

@@ -0,0 +1,5 @@
+import pinoHttp from "pino-http";
+
+import { logger } from "../utils/logger.js";
+
+export const httpLogger = pinoHttp({ logger });

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

@@ -0,0 +1,17 @@
+import type { NextFunction, Request, Response } from "express";
+import type { ZodSchema } from "zod";
+
+export const validate =
+  <T>(schema: ZodSchema<T>) =>
+  (req: Request, _res: Response, next: NextFunction) => {
+    try {
+      schema.parse({
+        body: req.body,
+        query: req.query,
+        params: req.params,
+      });
+      next();
+    } catch (err) {
+      next(err);
+    }
+  };

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

@@ -0,0 +1,13 @@
+import { Router } from "express";
+
+export const router = Router();
+
+router.get("/", (_req, res) => {
+  res.status(200).json({ status: "ok" });
+});
+
+router.get("/ready", (_req, res) => {
+  res.status(200).json({ ready: true });
+});
+
+export { router as healthRouter };

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

@@ -0,0 +1,12 @@
+import { Router } from "express";
+
+import { validate } from "../middleware/validate";
+import { createUserSchema } from "../schema/create-user.schema";
+
+const router = Router();
+
+router.post("/", validate(createUserSchema), (_req, res) => {
+  res.status(201).json({ ok: true });
+});
+
+export { router as userRouter };

package/dist/templates/backend-express/.appinit-generate/project/src/schema/create-user.schema.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+
+export const createUserSchema = z.object({
+  body: z.object({
+    email: z.email(),
+    password: z.string().min(8),
+  }),
+});