create-tigra 1.1.0 → 2.0.1

package/template/server/docs/logging.md

@@ -0,0 +1,62 @@
+# Server Request Logging
+
+## Overview
+
+The server uses a single-line request/response logging system built on Pino, providing color-coded, informative logs for every API request.
+
+## Log Format
+
+Each completed request produces a single log line:
+
+```
+GET    /api/v1/auth/me 200 OK (12ms)
+```
+
+Format: `METHOD  URL  STATUS STATUS_MESSAGE  (DURATION)`
+
+## Color Coding
+
+### HTTP Methods (ANSI colors)
+- **Blue**: GET (read operations)
+- **Green**: POST (create operations)
+- **Yellow**: PUT/PATCH (update operations)
+- **Red**: DELETE (destroy operations)
+- **Gray**: OPTIONS/HEAD (meta operations)
+
+### Status Codes
+- **Green**: 2xx (success)
+- **Cyan**: 3xx (redirect)
+- **Yellow**: 4xx (client error)
+- **Red**: 5xx (server error)
+
+## Log Levels by Status Code
+
+| Status Range | Log Level | Example |
+|---|---|---|
+| 2xx | INFO | Successful requests |
+| 4xx | WARN | Client errors (bad input, auth failures) |
+| 5xx | ERROR | Server errors (unhandled exceptions) |
+
+## Excluded Routes
+
+Health check endpoints are excluded from logging to reduce noise:
+- `/api/v1/health`
+- `/api/v1/ready`
+- `/api/v1/live`
+
+## Configuration
+
+### Development
+- Uses `pino-pretty` for colorized, human-readable logs
+- Set `LOG_LEVEL=debug` in `.env` for verbose output
+
+### Production
+- Uses structured JSON logs (Pino default)
+- Optimized for log aggregation tools (ELK, CloudWatch, Datadog)
+- Set `LOG_LEVEL=info` or `LOG_LEVEL=warn` in `.env`
+
+## Performance Impact
+
+- Minimal overhead (~1-2ms per request)
+- Async logging prevents blocking the event loop
+- Duration tracking uses `Date.now()` for low-overhead timing

package/template/server/eslint.config.mjs

@@ -0,0 +1,17 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    rules: {
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/explicit-function-return-type': 'warn',
+      '@typescript-eslint/no-explicit-any': 'error',
+    },
+  },
+  {
+    ignores: ['dist/', 'node_modules/', 'prisma/'],
+  }
+);

package/template/server/package.json

@@ -1,81 +1,68 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "version": "1.0.0",
-  "description": "{{PROJECT_DESCRIPTION}}",
-  "main": "dist/server.js",
-  "type": "module",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "scripts": {
-    "dev": "tsx watch src/server.ts",
-    "build": "tsc -p tsconfig.build.json",
-    "build:debug": "tsc -p tsconfig.build.json --listFiles",
-    "start": "node dist/server.js",
-    "start:prod": "NODE_ENV=production node dist/server.js",
-    "lint": "biome check src",
-    "lint:fix": "biome check --write src",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:e2e": "vitest run --config vitest.e2e.config.ts",
-    "env:setup": "node scripts/setup-env.js",
-    "db:wait": "node scripts/wait-for-db.js",
-    "db:init": "npm run env:setup && npm run db:wait && npx prisma migrate dev --name init",
-    "prisma:generate": "prisma generate",
-    "prisma:migrate": "prisma migrate dev",
-    "prisma:migrate:deploy": "prisma migrate deploy",
-    "prisma:studio": "prisma studio",
-    "prisma:reset": "prisma migrate reset",
-    "prisma:seed": "tsx prisma/seed.ts",
-    "db:push": "prisma db push",
-    "format": "biome format --write src",
-    "format:check": "biome format src"
-  },
-  "keywords": [
-    "fastify",
-    "typescript",
-    "prisma",
-    "api",
-    "rest",
-    "mysql",
-    "redis"
-  ],
-  "author": "{{AUTHOR_NAME}}",
-  "license": "MIT",
-  "dependencies": {
-    "@fastify/compress": "^8.0.0",
-    "@fastify/cors": "^10.0.0",
-    "@fastify/helmet": "^13.0.0",
-    "@fastify/multipart": "^9.0.0",
-    "@fastify/rate-limit": "^10.2.0",
-    "@prisma/client": "^6.2.0",
-    "bcryptjs": "^2.4.3",
-    "bullmq": "^5.34.0",
-    "dotenv": "^16.4.7",
-    "fastify": "^5.2.0",
-    "ioredis": "^5.4.2",
-    "jsonwebtoken": "^9.0.2",
-    "mysql2": "^3.11.5",
-    "pino": "^9.6.0",
-    "zod": "^3.24.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^1.9.0",
-    "@types/bcryptjs": "^2.4.6",
-    "@types/jsonwebtoken": "^9.0.5",
-    "@types/node": "^22.10.0",
-    "@types/supertest": "^6.0.2",
-    "@vitest/coverage-v8": "^3.0.0",
-    "pino-pretty": "^13.0.0",
-    "prisma": "^6.2.0",
-    "supertest": "^7.1.0",
-    "tsc-alias": "^1.8.16",
-    "tsx": "^4.19.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
-  },
-  "prisma": {
-    "seed": "tsx prisma/seed.ts"
-  }
-}
+{
+  "name": "{{PROJECT_NAME}}-server",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "",
+  "main": "dist/server.js",
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "build": "tsc && tsc-alias",
+    "start": "node dist/server.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "prisma:generate": "prisma generate",
+    "prisma:migrate:dev": "prisma migrate dev",
+    "prisma:migrate:deploy": "prisma migrate deploy",
+    "prisma:reset": "prisma migrate reset",
+    "prisma:seed": "prisma db seed",
+    "prisma:studio": "prisma studio",
+    "lint": "eslint src/",
+    "redis:flush": "tsx scripts/flush-redis.ts",
+    "docker:up": "docker compose up -d",
+    "docker:down": "docker compose down",
+    "docker:logs": "docker compose logs -f"
+  },
+  "prisma": {
+    "seed": "tsx prisma/seed.ts"
+  },
+  "dependencies": {
+    "@fastify/compress": "^8.3.1",
+    "@fastify/cookie": "^11.0.2",
+    "@fastify/cors": "^11.2.0",
+    "@fastify/helmet": "^13.0.2",
+    "@fastify/jwt": "^10.0.0",
+    "@fastify/multipart": "^9.0.2",
+    "@fastify/rate-limit": "^10.3.0",
+    "@fastify/static": "^8.0.4",
+    "@prisma/client": "^6.19.2",
+    "argon2": "^0.44.0",
+    "bcryptjs": "^2.4.3",
+    "dotenv": "^16.4.7",
+    "fastify": "^5.7.4",
+    "fastify-type-provider-zod": "^6.1.0",
+    "ioredis": "^5.9.2",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "sharp": "^0.33.5",
+    "uuid": "^10.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/bcryptjs": "^2.4.6",
+    "@types/node": "^20.17.10",
+    "@types/sharp": "^0.32.0",
+    "@types/uuid": "^10.0.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/ui": "^4.0.18",
+    "eslint": "^9.39.2",
+    "prisma": "^6.19.2",
+    "tsc-alias": "^1.8.16",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.55.0",
+    "vitest": "^4.0.18"
+  }
+}

package/template/server/phpmyadmin-config.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * phpMyAdmin configuration for auto-login (LOCAL DEVELOPMENT ONLY)
+ *
+ * WARNING: These credentials match docker-compose.yml defaults.
+ * Do NOT use these credentials in any shared or production environment.
+ */
+
+// This is needed for cookie based authentication
+$cfg['blowfish_secret'] = 'change-this-to-a-random-32-char-string';
+
+// Server configuration
+$i = 0;
+$i++;
+
+$cfg['Servers'][$i]['auth_type'] = 'config';
+$cfg['Servers'][$i]['host'] = 'mysql';
+$cfg['Servers'][$i]['port'] = '3306';
+$cfg['Servers'][$i]['user'] = 'root';
+$cfg['Servers'][$i]['password'] = 'rootpassword';
+$cfg['Servers'][$i]['compress'] = false;
+$cfg['Servers'][$i]['AllowNoPassword'] = true;
+
+// Other settings
+$cfg['UploadDir'] = '';
+$cfg['SaveDir'] = '';