starter-structure-cli 0.2.1 → 0.2.2

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/database/migrations/index.tsx

@@ -0,0 +1,12 @@
+export const migrationsPlan = [
+  {
+    id: "001_create_users",
+    description: "Create the users table or collection."
+  },
+  {
+    id: "002_create_roles",
+    description: "Create the permissions and roles structure."
+  }
+];
+
+export default migrationsPlan;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/database/models/index.tsx

@@ -0,0 +1,15 @@
+export interface ModuleModelRecord {
+  id: string;
+  name: string;
+  status: "draft" | "active";
+  createdAt: string;
+}
+
+export const modelsFields = [
+  "id",
+  "name",
+  "status",
+  "createdAt"
+];
+
+export default modelsFields;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/database/seeders/index.tsx

@@ -0,0 +1,12 @@
+export const seedersSeeds = [
+  {
+    id: "starter-admin",
+    name: "Starter Admin"
+  },
+  {
+    id: "starter-operator",
+    name: "Starter Operator"
+  }
+];
+
+export default seedersSeeds;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "__APP_NAME__",
+  "version": "1.0.0",
+  "description": "Express + Prisma + MySQL + JWT starter API (TypeScript)",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prisma:generate": "prisma generate",
+    "prisma:migrate": "prisma migrate dev",
+    "prisma:studio": "prisma studio"
+  },
+  "keywords": [
+    "express",
+    "prisma",
+    "mysql",
+    "jwt",
+    "typescript",
+    "api"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@prisma/client": "^6.5.0",
+    "bcryptjs": "^2.4.3",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "helmet": "^8.0.0",
+    "jsonwebtoken": "^9.0.2",
+    "morgan": "^1.10.0"
+
+  },
+  "devDependencies": {
+    "@types/bcryptjs": "^2.4.6",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.1",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/morgan": "^1.9.9",
+    "@types/node": "^22.13.10",
+    "prisma": "^6.5.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2"
+
+  }
+}

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/prisma/schema.prisma

@@ -0,0 +1,18 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "mysql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id        Int      @id @default(autoincrement())
+  name      String
+  email     String   @unique
+  password  String
+  role      String   @default("user")
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/routes/common/index.tsx

@@ -0,0 +1,23 @@
+export type ApiRouteDefinition = {
+  method: "GET" | "POST" | "PATCH" | "DELETE";
+  path: string;
+  handler: string;
+  protected?: boolean;
+};
+
+export const commonApiRoutes: ApiRouteDefinition[] = [
+  {
+    method: "GET",
+    path: "/common",
+    handler: "listCommon",
+    protected: true
+  },
+  {
+    method: "POST",
+    path: "/common",
+    handler: "createCommon",
+    protected: true
+  }
+];
+
+export default commonApiRoutes;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/routes/reports/index.tsx

@@ -0,0 +1,23 @@
+export type ApiRouteDefinition = {
+  method: "GET" | "POST" | "PATCH" | "DELETE";
+  path: string;
+  handler: string;
+  protected?: boolean;
+};
+
+export const reportsApiRoutes: ApiRouteDefinition[] = [
+  {
+    method: "GET",
+    path: "/reports",
+    handler: "listReports",
+    protected: true
+  },
+  {
+    method: "POST",
+    path: "/reports",
+    handler: "createReports",
+    protected: true
+  }
+];
+
+export default reportsApiRoutes;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/scripts/index.tsx

@@ -0,0 +1,12 @@
+export const scriptsTasks = [
+  "migrate",
+  "seed",
+  "verify"
+];
+
+export function runScriptsTask(taskName: string) {
+  return {
+    taskName,
+    executedAt: new Date().toISOString()
+  };
+}

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/services/index.tsx

@@ -0,0 +1,16 @@
+export const servicesService = {
+  summarize(items: Array<Record<string, unknown>>) {
+    return {
+      count: items.length,
+      updatedAt: new Date().toISOString()
+    };
+  },
+  emptyState() {
+    return {
+      title: "Services service",
+      description: "Replace this starter service with your real business logic."
+    };
+  }
+};
+
+export default servicesService;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/config/prisma/index.ts

@@ -0,0 +1,5 @@
+import { PrismaClient } from "@prisma/client";
+
+const prisma = new PrismaClient();
+
+export default prisma;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/controllers/auth/index.ts

@@ -0,0 +1,122 @@
+import bcrypt from "bcryptjs";
+import { Request, Response, NextFunction } from "express";
+
+import prisma from "../../config/prisma";
+import { errorResponse, successResponse } from "../../utils/api-response";
+import generateToken from "../../utils/generate-token";
+import userSelect from "../../utils/user-select";
+
+export async function register(req: Request, res: Response, next: NextFunction) {
+  try {
+    const { name, email, password } = req.body as {
+      name?: string;
+      email?: string;
+      password?: string;
+    };
+
+    if (!name || !email || !password) {
+      return errorResponse(res, "Name, email, and password are required.", 400);
+    }
+
+    const normalizedEmail = email.toLowerCase();
+    const existingUser = await prisma.user.findUnique({
+      where: { email: normalizedEmail }
+    });
+
+    if (existingUser) {
+      return errorResponse(res, "User already exists with this email.", 409);
+    }
+
+    const hashedPassword = await bcrypt.hash(password, 10);
+
+    const user = await prisma.user.create({
+      data: {
+        name,
+        email: normalizedEmail,
+        password: hashedPassword
+      },
+      select: userSelect
+    });
+
+    const token = generateToken(user.id);
+
+    return successResponse(
+      res,
+      {
+        user,
+        token
+      },
+      "Registration successful.",
+      201
+    );
+  } catch (error) {
+    next(error);
+  }
+}
+
+export async function login(req: Request, res: Response, next: NextFunction) {
+  try {
+    const { email, password } = req.body as {
+      email?: string;
+      password?: string;
+    };
+
+    if (!email || !password) {
+      return errorResponse(res, "Email and password are required.", 400);
+    }
+
+    const normalizedEmail = email.toLowerCase();
+    const user = await prisma.user.findUnique({
+      where: { email: normalizedEmail }
+    });
+
+    if (!user) {
+      return errorResponse(res, "Invalid email or password.", 401);
+    }
+
+    const isPasswordValid = await bcrypt.compare(password, user.password);
+    if (!isPasswordValid) {
+      return errorResponse(res, "Invalid email or password.", 401);
+    }
+
+    const token = generateToken(user.id);
+    const safeUser = await prisma.user.findUnique({
+      where: { id: user.id },
+      select: userSelect
+    });
+
+    return successResponse(
+      res,
+      {
+        user: safeUser,
+        token
+      },
+      "Login successful."
+    );
+  } catch (error) {
+    next(error);
+  }
+}
+
+export async function me(req: Request, res: Response, next: NextFunction) {
+  try {
+    const userId = req.user?.id;
+
+    if (!userId) {
+      return errorResponse(res, "Unauthorized access.", 401);
+    }
+
+    const user = await prisma.user.findUnique({
+      where: { id: userId },
+      select: userSelect
+    });
+
+    if (!user) {
+      return errorResponse(res, "User not found.", 404);
+    }
+
+    return successResponse(res, { user }, "Authenticated user fetched.");
+  } catch (error) {
+    next(error);
+  }
+}

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/controllers/common/index.tsx

@@ -0,0 +1,35 @@
+export type StarterRequest = {
+  params?: Record<string, string>;
+  query?: Record<string, string>;
+  body?: Record<string, unknown>;
+  user?: {
+    id: string;
+    role: string;
+  };
+};
+
+export type StarterResponse = {
+  statusCode: number;
+  body: Record<string, unknown>;
+};
+
+export async function listCommon(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "common",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createCommon(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "common",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/controllers/reports/index.tsx

@@ -0,0 +1,35 @@
+export type StarterRequest = {
+  params?: Record<string, string>;
+  query?: Record<string, string>;
+  body?: Record<string, unknown>;
+  user?: {
+    id: string;
+    role: string;
+  };
+};
+
+export type StarterResponse = {
+  statusCode: number;
+  body: Record<string, unknown>;
+};
+
+export async function listReports(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "reports",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createReports(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "reports",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/database/config/index.tsx

@@ -0,0 +1,10 @@
+export const configConfig = {
+  client: process.env.DB_CLIENT || "mysql",
+  host: process.env.DB_HOST || "localhost",
+  port: Number(process.env.DB_PORT || 3306),
+  database: process.env.DB_NAME || "__APP_NAME__",
+  username: process.env.DB_USER || "root",
+  password: process.env.DB_PASSWORD || ""
+};
+
+export default configConfig;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/database/migrations/index.tsx

@@ -0,0 +1,12 @@
+export const migrationsPlan = [
+  {
+    id: "001_create_users",
+    description: "Create the users table or collection."
+  },
+  {
+    id: "002_create_roles",
+    description: "Create the permissions and roles structure."
+  }
+];
+
+export default migrationsPlan;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/database/models/index.tsx

@@ -0,0 +1,15 @@
+export interface ModuleModelRecord {
+  id: string;
+  name: string;
+  status: "draft" | "active";
+  createdAt: string;
+}
+
+export const modelsFields = [
+  "id",
+  "name",
+  "status",
+  "createdAt"
+];
+
+export default modelsFields;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/database/seeders/index.tsx

@@ -0,0 +1,12 @@
+export const seedersSeeds = [
+  {
+    id: "starter-admin",
+    name: "Starter Admin"
+  },
+  {
+    id: "starter-operator",
+    name: "Starter Operator"
+  }
+];
+
+export default seedersSeeds;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/index.ts

@@ -0,0 +1,55 @@
+import cors from "cors";
+import dotenv from "dotenv";
+import express from "express";
+import helmet from "helmet";
+import morgan from "morgan";
+
+import prisma from "./config/prisma";
+import errorHandler from "./middleware/error-handler";
+import notFound from "./middleware/not-found";
+import routes from "./routes";
+
+dotenv.config();
+
+const app = express();
+const port = Number(process.env.PORT || 5000);
+
+app.use(
+  cors({
+    origin: process.env.CLIENT_URL || "*",
+    credentials: true
+  })
+);
+app.use(helmet());
+app.use(morgan("dev"));
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+
+app.get("/", (_req, res) => {
+  res.json({
+    success: true,
+    message: "__APP_NAME__ API is running"
+  });
+});
+
+app.use("/api", routes);
+
+app.use(notFound);
+app.use(errorHandler);
+
+async function startServer() {
+  try {
+    await prisma.$connect();
+    console.log("Prisma connected");
+
+    app.listen(port, () => {
+      console.log(`Server running on port ${port}`);
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown startup error";
+    console.error("Failed to start server:", message);
+    process.exit(1);
+  }
+}
+
+startServer();

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/middleware/authenticate/index.ts

@@ -0,0 +1,33 @@
+import { NextFunction, Request, Response } from "express";
+import jwt from "jsonwebtoken";
+
+import prisma from "../config/prisma";
+import { errorResponse } from "../utils/api-response";
+import userSelect from "../utils/user-select";
+
+export default async function authenticate(req: Request, res: Response, next: NextFunction) {
+  try {
+    const authHeader = req.headers.authorization;
+
+    if (!authHeader || !authHeader.startsWith("Bearer ")) {
+      return errorResponse(res, "Unauthorized access.", 401);
+    }
+
+    const token = authHeader.split(" ")[1];
+    const decoded = jwt.verify(token, process.env.JWT_SECRET as string) as { id: number };
+
+    const user = await prisma.user.findUnique({
+      where: { id: decoded.id },
+      select: userSelect
+    });
+
+    if (!user) {
+      return errorResponse(res, "User not found.", 401);
+    }
+
+    req.user = user;
+    next();
+  } catch (_error) {
+    return errorResponse(res, "Invalid or expired token.", 401);
+  }
+}

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/middleware/error-handler/index.ts

@@ -0,0 +1,21 @@
+import { NextFunction, Request, Response } from "express";
+
+import { errorResponse } from "../utils/api-response";
+
+export default function errorHandler(
+  error: Error & { statusCode?: number },
+  _req: Request,
+  res: Response,
+  _next: NextFunction
+) {
+  const statusCode = error.statusCode || 500;
+  const message = error.message || "Internal server error.";
+
+  if (process.env.NODE_ENV !== "test") {
+    console.error(error);
+  }
+
+  return errorResponse(res, message, statusCode, {
+    stack: process.env.NODE_ENV === "development" ? error.stack : undefined
+  });
+}

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/middleware/not-found/index.ts

@@ -0,0 +1,7 @@
+import { Request, Response } from "express";
+
+import { errorResponse } from "../utils/api-response";
+
+export default function notFound(req: Request, res: Response) {
+  return errorResponse(res, `Route not found: ${req.originalUrl}`, 404);
+}

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/routes/auth/index.ts

@@ -0,0 +1,12 @@
+import { Router } from "express";
+
+import { login, me, register } from "../../controllers/auth";
+import authenticate from "../../middleware/authenticate";
+
+const router = Router();
+
+router.post("/register", register);
+router.post("/login", login);
+router.get("/me", authenticate, me);
+
+export default router;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/routes/common/index.tsx

@@ -0,0 +1,23 @@
+export type ApiRouteDefinition = {
+  method: "GET" | "POST" | "PATCH" | "DELETE";
+  path: string;
+  handler: string;
+  protected?: boolean;
+};
+
+export const commonApiRoutes: ApiRouteDefinition[] = [
+  {
+    method: "GET",
+    path: "/common",
+    handler: "listCommon",
+    protected: true
+  },
+  {
+    method: "POST",
+    path: "/common",
+    handler: "createCommon",
+    protected: true
+  }
+];
+
+export default commonApiRoutes;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/routes/index.ts

@@ -0,0 +1,16 @@
+import { Router } from "express";
+
+import authRoutes from "./auth";
+
+const router = Router();
+
+router.get("/health", (_req, res) => {
+  res.json({
+    success: true,
+    message: "Server is healthy"
+  });
+});
+
+router.use("/auth", authRoutes);
+
+export default router;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/routes/reports/index.tsx

@@ -0,0 +1,23 @@
+export type ApiRouteDefinition = {
+  method: "GET" | "POST" | "PATCH" | "DELETE";
+  path: string;
+  handler: string;
+  protected?: boolean;
+};
+
+export const reportsApiRoutes: ApiRouteDefinition[] = [
+  {
+    method: "GET",
+    path: "/reports",
+    handler: "listReports",
+    protected: true
+  },
+  {
+    method: "POST",
+    path: "/reports",
+    handler: "createReports",
+    protected: true
+  }
+];
+
+export default reportsApiRoutes;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/services/index.tsx

@@ -0,0 +1,16 @@
+export const servicesService = {
+  summarize(items: Array<Record<string, unknown>>) {
+    return {
+      count: items.length,
+      updatedAt: new Date().toISOString()
+    };
+  },
+  emptyState() {
+    return {
+      title: "Services service",
+      description: "Replace this starter service with your real business logic."
+    };
+  }
+};
+
+export default servicesService;

package/templates/fullstack/react-vite-ts-tailwind-express-prisma-mysql/server/src/types/express/index.d.ts

@@ -0,0 +1,20 @@
+import { Prisma } from "@prisma/client";
+
+declare global {
+  namespace Express {
+    interface Request {
+      user?: Prisma.UserGetPayload<{
+        select: {
+          id: true;
+          name: true;
+          email: true;
+          role: true;
+          createdAt: true;
+          updatedAt: true;
+        };
+      }>;
+    }
+  }
+}
+
+export {};