forgedev 1.4.0 → 1.4.1

package/templates/backend/express/package.json.template

@@ -1,33 +1,35 @@
-{
-  "name": "{{PROJECT_NAME}}-server",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "lint": "eslint .",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "db:push": "prisma db push",
-    "db:studio": "prisma studio",
-    "db:generate": "prisma generate"
-  },
-  "dependencies": {
-    "express": "^5.1.0",
-    "cors": "^2.8.5",
-    "@prisma/client": "^6.6.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.8.3",
-    "@types/node": "^22.14.0",
-    "@types/express": "^5.0.0",
-    "@types/cors": "^2.8.17",
-    "tsx": "^4.19.0",
-    "eslint": "^9.25.0",
-    "prisma": "^6.6.0",
-    "vitest": "^3.1.1"
-  }
-}
+{
+  "name": "{{PROJECT_NAME}}-server",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "db:push": "prisma db push",
+    "db:migrate": "prisma migrate dev",
+    "db:migrate:deploy": "prisma migrate deploy",
+    "db:studio": "prisma studio",
+    "db:generate": "prisma generate"
+  },
+  "dependencies": {
+    "express": "^5.1.0",
+    "cors": "^2.8.5",
+    "@prisma/client": "^6.6.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "@types/node": "^22.14.0",
+    "@types/express": "^5.0.0",
+    "@types/cors": "^2.8.17",
+    "tsx": "^4.19.0",
+    "eslint": "^9.25.0",
+    "prisma": "^6.6.0",
+    "vitest": "^3.1.1"
+  }
+}

package/templates/backend/express/src/lib/prisma.ts.template

@@ -0,0 +1,32 @@
+import { PrismaClient } from '@prisma/client';
+
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 1000;
+
+async function connectWithRetry(client: PrismaClient, retries = MAX_RETRIES): Promise<void> {
+  for (let attempt = 1; attempt <= retries; attempt++) {
+    try {
+      await client.$connect();
+      return;
+    } catch (error) {
+      if (attempt === retries) throw error;
+      const delay = RETRY_DELAY_MS * Math.pow(2, attempt - 1);
+      console.warn(`Database connection attempt ${attempt} failed. Retrying in ${delay}ms...`);
+      await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+  }
+}
+
+export const prisma = new PrismaClient({
+  log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
+});
+
+// Graceful shutdown
+const shutdownHandler = async () => {
+  await prisma.$disconnect();
+};
+
+process.on('SIGTERM', shutdownHandler);
+process.on('SIGINT', shutdownHandler);
+
+export { connectWithRetry };

package/templates/backend/express/src/routes/health.ts.template

@@ -1,27 +1,35 @@
-import { Router } from 'express';
-
-export const healthRouter = Router();
-
-// Liveness probe — always returns ok if the process is running
-healthRouter.get('/health', (_req, res) => {
-  res.json({
-    status: 'ok',
-    timestamp: new Date().toISOString(),
-    uptime: process.uptime(),
-    service: '{{PROJECT_NAME}}',
-  });
-});
-
-// Readiness probe — add real dependency checks (database, cache, etc.)
-// before using this as a Kubernetes readiness probe
-healthRouter.get('/healthz', async (_req, res) => {
-  // TODO: Replace with actual checks, e.g.:
-  //   const db = await prisma.$queryRaw`SELECT 1`;
-  const checks: Record<string, string> = {};
-
-  res.json({
-    status: 'ok',
-    service: '{{PROJECT_NAME}}',
-    checks,
-  });
-});
+import { Router } from 'express';
+import { prisma } from '../lib/prisma';
+
+export const healthRouter = Router();
+
+// Liveness probe — always returns ok if the process is running
+healthRouter.get('/health', (_req, res) => {
+  res.json({
+    status: 'ok',
+    timestamp: new Date().toISOString(),
+    uptime: process.uptime(),
+    service: '{{PROJECT_NAME}}',
+  });
+});
+
+// Readiness probe — verifies database connectivity
+healthRouter.get('/healthz', async (_req, res) => {
+  let dbStatus = 'disconnected';
+
+  try {
+    await prisma.$queryRaw`SELECT 1`;
+    dbStatus = 'connected';
+  } catch {
+    dbStatus = 'disconnected';
+  }
+
+  const status = dbStatus === 'connected' ? 'ok' : 'degraded';
+  const statusCode = dbStatus === 'connected' ? 200 : 503;
+
+  res.status(statusCode).json({
+    status,
+    service: '{{PROJECT_NAME}}',
+    checks: { database: dbStatus },
+  });
+});

package/templates/backend/fastapi/backend/app/main.py.template

@@ -1,60 +1,67 @@
-from contextlib import asynccontextmanager
-from fastapi import FastAPI, Request
-from fastapi.middleware.cors import CORSMiddleware
-from fastapi.responses import JSONResponse
-
-from app.api.health import router as health_router
-from app.portal.router import router as portal_router
-from app.core.config import settings
-from app.core.errors import AppError
-
-
-@asynccontextmanager
-async def lifespan(app: FastAPI):
-    # Startup: connect to database with retry
-    from app.db.session import engine, connect_with_retry
-
-    await connect_with_retry(engine)
-    yield
-    # Shutdown: close database connections gracefully
-    await engine.dispose()
-
-
-app = FastAPI(
-    title="{{PROJECT_NAME_PASCAL}}",
-    version="0.1.0",
-    lifespan=lifespan,
-)
-
-# CORS
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=settings.cors_origins,
-    allow_credentials=True,
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
-
-# Routes
-app.include_router(health_router, tags=["health"])
-app.include_router(portal_router)
-
-
-# Global exception handler - never leak stack traces
-@app.exception_handler(AppError)
-async def app_error_handler(request: Request, exc: AppError):
-    return JSONResponse(
-        status_code=exc.status_code,
-        content={"error": {"code": exc.code, "message": exc.message}},
-    )
-
-
-@app.exception_handler(Exception)
-async def global_exception_handler(request: Request, exc: Exception):
-    import logging
-
-    logging.exception("Unhandled exception")
-    return JSONResponse(
-        status_code=500,
-        content={"error": {"code": "INTERNAL_ERROR", "message": "An unexpected error occurred"}},
-    )
+import logging
+import sys
+from contextlib import asynccontextmanager
+
+from fastapi import FastAPI, Request
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import JSONResponse
+from pythonjsonlogger.json import JsonFormatter
+
+from app.api.health import router as health_router
+from app.portal.router import router as portal_router
+from app.core.config import settings
+from app.core.errors import AppError
+
+# Structured JSON logging
+handler = logging.StreamHandler(sys.stdout)
+handler.setFormatter(JsonFormatter("%(asctime)s %(name)s %(levelname)s %(message)s"))
+logging.basicConfig(level=logging.INFO, handlers=[handler])
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # Startup: connect to database with retry
+    from app.db.session import engine, connect_with_retry
+
+    await connect_with_retry(engine)
+    yield
+    # Shutdown: close database connections gracefully
+    await engine.dispose()
+
+
+app = FastAPI(
+    title="{{PROJECT_NAME_PASCAL}}",
+    version="0.1.0",
+    lifespan=lifespan,
+)
+
+# CORS
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=settings.cors_origins,
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Routes
+app.include_router(health_router, tags=["health"])
+app.include_router(portal_router)
+
+
+# Global exception handler - never leak stack traces
+@app.exception_handler(AppError)
+async def app_error_handler(request: Request, exc: AppError):
+    return JSONResponse(
+        status_code=exc.status_code,
+        content={"error": {"code": exc.code, "message": exc.message}},
+    )
+
+
+@app.exception_handler(Exception)
+async def global_exception_handler(request: Request, exc: Exception):
+    logging.exception("Unhandled exception")
+    return JSONResponse(
+        status_code=500,
+        content={"error": {"code": "INTERNAL_ERROR", "message": "An unexpected error occurred"}},
+    )

package/templates/backend/fastapi/backend/requirements.txt.template

@@ -1,16 +1,18 @@
-fastapi>=0.115.0
-uvicorn[standard]>=0.34.0
-sqlalchemy[asyncio]>=2.0.38
-asyncpg>=0.30.0
-pydantic>=2.11.0
-pydantic-settings>=2.8.0
-alembic>=1.15.0
-python-jose[cryptography]>=3.4.0
-passlib[bcrypt]>=1.7.4
-httpx>=0.28.0
-pytest>=8.3.0
-pytest-asyncio>=0.25.0
-markdown>=3.7
-bleach>=6.2.0
-ruff>=0.11.0
-pyright>=1.1.400
+fastapi>=0.115.0
+uvicorn[standard]>=0.34.0
+sqlalchemy[asyncio]>=2.0.38
+asyncpg>=0.30.0
+pydantic>=2.11.0
+pydantic-settings>=2.8.0
+alembic>=1.15.0
+python-jose[cryptography]>=3.4.0
+passlib[bcrypt]>=1.7.4
+httpx>=0.28.0
+pytest>=8.3.0
+pytest-asyncio>=0.25.0
+markdown>=3.7
+bleach>=6.2.0
+# v3 uses: from pythonjsonlogger.json import JsonFormatter (v2 used pythonjsonlogger.jsonlogger)
+python-json-logger>=3.2.0
+ruff>=0.11.0
+pyright>=1.1.400

package/templates/backend/hono/package.json.template

@@ -1,31 +1,33 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "lint": "eslint .",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "db:push": "prisma db push",
-    "db:studio": "prisma studio",
-    "db:generate": "prisma generate"
-  },
-  "dependencies": {
-    "hono": "^4.7.0",
-    "@hono/node-server": "^1.14.0",
-    "@prisma/client": "^6.6.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.8.3",
-    "@types/node": "^22.14.0",
-    "tsx": "^4.19.0",
-    "eslint": "^9.25.0",
-    "prisma": "^6.6.0",
-    "vitest": "^3.1.1"
-  }
-}
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "db:push": "prisma db push",
+    "db:migrate": "prisma migrate dev",
+    "db:migrate:deploy": "prisma migrate deploy",
+    "db:studio": "prisma studio",
+    "db:generate": "prisma generate"
+  },
+  "dependencies": {
+    "hono": "^4.7.0",
+    "@hono/node-server": "^1.14.0",
+    "@prisma/client": "^6.6.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "@types/node": "^22.14.0",
+    "tsx": "^4.19.0",
+    "eslint": "^9.25.0",
+    "prisma": "^6.6.0",
+    "vitest": "^3.1.1"
+  }
+}

package/templates/backend/hono/src/lib/prisma.ts.template

@@ -0,0 +1,32 @@
+import { PrismaClient } from '@prisma/client';
+
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 1000;
+
+async function connectWithRetry(client: PrismaClient, retries = MAX_RETRIES): Promise<void> {
+  for (let attempt = 1; attempt <= retries; attempt++) {
+    try {
+      await client.$connect();
+      return;
+    } catch (error) {
+      if (attempt === retries) throw error;
+      const delay = RETRY_DELAY_MS * Math.pow(2, attempt - 1);
+      console.warn(`Database connection attempt ${attempt} failed. Retrying in ${delay}ms...`);
+      await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+  }
+}
+
+export const prisma = new PrismaClient({
+  log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
+});
+
+// Graceful shutdown
+const shutdownHandler = async () => {
+  await prisma.$disconnect();
+};
+
+process.on('SIGTERM', shutdownHandler);
+process.on('SIGINT', shutdownHandler);
+
+export { connectWithRetry };

package/templates/backend/hono/src/routes/health.ts.template

@@ -1,27 +1,38 @@
-import { Hono } from 'hono';
-
-export const healthRoutes = new Hono();
-
-// Liveness probe — always returns ok if the process is running
-healthRoutes.get('/health', (c) => {
-  return c.json({
-    status: 'ok',
-    timestamp: new Date().toISOString(),
-    uptime: process.uptime(),
-    service: '{{PROJECT_NAME}}',
-  });
-});
-
-// Readiness probe — add real dependency checks (database, cache, etc.)
-// before using this as a Kubernetes readiness probe
-healthRoutes.get('/healthz', async (c) => {
-  // TODO: Replace with actual checks, e.g.:
-  //   const db = await prisma.$queryRaw`SELECT 1`;
-  const checks: Record<string, string> = {};
-
-  return c.json({
-    status: 'ok',
-    service: '{{PROJECT_NAME}}',
-    checks,
-  });
-});
+import { Hono } from 'hono';
+import { prisma } from '../lib/prisma';
+
+export const healthRoutes = new Hono();
+
+// Liveness probe — always returns ok if the process is running
+healthRoutes.get('/health', (c) => {
+  return c.json({
+    status: 'ok',
+    timestamp: new Date().toISOString(),
+    uptime: process.uptime(),
+    service: '{{PROJECT_NAME}}',
+  });
+});
+
+// Readiness probe — verifies database connectivity
+healthRoutes.get('/healthz', async (c) => {
+  let dbStatus = 'disconnected';
+
+  try {
+    await prisma.$queryRaw`SELECT 1`;
+    dbStatus = 'connected';
+  } catch {
+    dbStatus = 'disconnected';
+  }
+
+  const status = dbStatus === 'connected' ? 'ok' : 'degraded';
+  const statusCode = dbStatus === 'connected' ? 200 : 503;
+
+  return c.json(
+    {
+      status,
+      service: '{{PROJECT_NAME}}',
+      checks: { database: dbStatus },
+    },
+    statusCode,
+  );
+});

package/templates/base/.gitignore.template

@@ -1,32 +1,32 @@
-# Dependencies
-node_modules/
-
-# Environment
-.env
-.env.local
-.env.*.local
-
-# Build output
-dist/
-.next/
-out/
-build/
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Testing
-coverage/
-test-results/
-playwright-report/
-
-# Kubernetes secrets (never commit real credentials)
-k8s/secrets.yml
-{{EXTRA_IGNORES}}
+# Dependencies
+node_modules/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Build output
+dist/
+.next/
+out/
+build/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+coverage/
+test-results/
+playwright-report/
+
+# Kubernetes secrets (never commit real credentials)
+k8s/secrets.yml
+{{EXTRA_IGNORES}}