stackkit 0.2.6 → 0.2.8

package/modules/database/mongoose/generator.json

@@ -6,12 +6,26 @@
     {
       "type": "create-file",
       "source": "lib/mongoose.ts",
-      "destination": "lib/mongoose.ts"
+      "destination": "server/database/mongoose.ts",
+      "condition": { "framework": ["nextjs"] }
+    },
+    {
+      "type": "create-file",
+      "source": "lib/mongoose.ts",
+      "destination": "src/database/mongoose.ts",
+      "condition": { "framework": ["express"] }
+    },
+    {
+      "type": "create-file",
+      "source": "models/health.ts",
+      "destination": "src/modules/health/health.model.ts",
+      "condition": { "framework": ["express"] }
     },
     {
       "type": "create-file",
       "source": "models/health.ts",
-      "destination": "models/health.ts"
+      "destination": "server/database/models/health.model.ts",
+      "condition": { "framework": ["nextjs"] }
     },
     {
       "type": "patch-file",

package/modules/database/prisma/files/lib/prisma.ts

@@ -1,5 +1,5 @@
+import { PrismaClient } from "@prisma/client";
 import 'dotenv/config';
-import { PrismaClient } from './generated/prisma/client'
 
 const globalForPrisma = globalThis as unknown as {
   prisma: PrismaClient | undefined

package/modules/database/prisma/files/prisma/schema.prisma

@@ -1,6 +1,5 @@
 generator client {
-    provider = "prisma-client"
-    output   = "../lib/generated/prisma"
+    provider = "prisma-client-js"
 }
 
 datasource db {

package/modules/database/prisma/generator.json

@@ -16,7 +16,14 @@
     {
       "type": "create-file",
       "source": "lib/prisma.ts",
-      "destination": "lib/prisma.ts"
+      "destination": "server/database/prisma.ts",
+      "condition": { "framework": ["nextjs"] }
+    },
+    {
+      "type": "create-file",
+      "source": "lib/prisma.ts",
+      "destination": "src/database/prisma.ts",
+      "condition": { "framework": ["express"] }
     },
     {
       "type": "add-dependency",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stackkit",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Production-ready CLI to create and extend JavaScript or TypeScript apps with modular stacks.",
   "main": "dist/index.js",
   "bin": {
@@ -80,4 +80,4 @@
     "@types/validate-npm-package-name": "^4.0.2",
     "typescript": "^5.3.3"
   }
-}
+}

package/templates/express/env.example

@@ -1,2 +1,3 @@
 PORT=3000
-NODE_ENV=development
+NODE_ENV=development
+CORS_ORIGIN="http://localhost:3000"

package/templates/express/package.json

@@ -8,15 +8,15 @@
     "build": "tsc",
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
-    "start": "node dist/server.js",
-    "start:prod": "cross-env NODE_ENV=production node dist/server.js"
+    "start": "node dist/server.js"
   },
   "dependencies": {
     "cors": "^2.8.5",
     "dotenv": "^17.2.3",
     "express": "^5.2.1",
     "helmet": "^8.1.0",
-    "morgan": "^1.10.1"
+    "morgan": "^1.10.1",
+    "express-rate-limit": "^6.10.0"
   },
   "devDependencies": {
     "@types/cors": "^2.8.19",
@@ -25,7 +25,6 @@
     "@types/node": "^25.0.8",
     "@typescript-eslint/eslint-plugin": "^8.53.0",
     "@typescript-eslint/parser": "^8.53.0",
-    "cross-env": "^10.1.0",
     "eslint": "^9.39.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"

package/templates/express/src/app.ts

@@ -1,28 +1,26 @@
-import cors from "cors";
-import express, { Application, NextFunction, Request, Response } from "express";
-import helmet from "helmet";
-import morgan from "morgan";
-import { env } from "./config/env";
-import { authRoutes } from "./features/health/health.route";
-import { errorHandler } from "./middlewares/error.middleware";
+import express, { Application, Request, Response } from "express";
+import { cors } from "./config/cors";
+import { helmet } from "./config/helmet";
+import { logger } from "./config/logger";
+import { limiter } from "./config/rate-limit";
+import { apiRoutes } from "./routes";
+import { errorHandler } from "./shared/middlewares/error.middleware";
+import { notFound } from "./shared/middlewares/not-found.middleware";
 
 // app initialization
 const app: Application = express();
 app.use(express.json());
 
-// security headers
-app.use(helmet());
+app.use(helmet);
+app.use(logger);
+app.use(cors);
+app.use(limiter);
 
-// logging
-if (env.isProduction) {
-  app.use(morgan("combined"));
-} else {
-  app.use(morgan("dev"));
+// trust proxy when behind proxies (load balancers)
+if (process.env.NODE_ENV === "production") {
+  app.set("trust proxy", 1);
 }
 
-// cors configuration
-app.use(cors());
-
 // Home page route
 app.get("/", (_req: Request, res: Response) => {
   res.status(200).json({
@@ -34,16 +32,11 @@ app.get("/", (_req: Request, res: Response) => {
   });
 });
 
-// routes
-app.use("/api/health", authRoutes);
+// API routes
+app.use("/api", apiRoutes);
 
 // unhandled routes
-app.use((req: Request, _res: Response, next: NextFunction) => {
-  const error: any = new Error(`Can't find ${req.originalUrl} on this server!`);
-  error.status = 404;
-
-  next(error);
-});
+app.use(notFound);
 
 // Global error handler
 app.use(errorHandler);

package/templates/express/src/config/cors.ts

@@ -0,0 +1,12 @@
+import createCors from "cors";
+import { env } from "./env";
+
+const origin = env.isProduction
+  ? process.env.CORS_ORIGIN
+    ? process.env.CORS_ORIGIN.split(",").map((s) => s.trim())
+    : false
+  : true;
+
+const cors = createCors({ origin });
+
+export { cors };

package/templates/express/src/config/helmet.ts

@@ -0,0 +1,5 @@
+import createHelmet from "helmet";
+
+const helmet = createHelmet();
+
+export { helmet };

package/templates/express/src/config/logger.ts

@@ -0,0 +1,6 @@
+import morgan from "morgan";
+import { env } from "./env";
+
+const logger = env.isProduction ? morgan("combined") : morgan("dev");
+
+export { logger };

package/templates/express/src/config/rate-limit.ts

@@ -0,0 +1,11 @@
+import rateLimit from "express-rate-limit";
+import { env } from "./env";
+
+const limiter = rateLimit({
+  windowMs: 15 * 60 * 1000, // 15 minutes
+  max: env.isProduction ? 100 : 1000, // limit each IP
+  standardHeaders: true,
+  legacyHeaders: false,
+});
+
+export { limiter };

package/templates/express/src/{features → modules}/health/health.route.ts

@@ -6,4 +6,4 @@ const router = Router();
 // demo route
 router.get("/", healthController.health);
 
-export const authRoutes = router;
+export const healthRoutes = router;

package/templates/express/src/routes/index.ts

@@ -0,0 +1,12 @@
+import { Router } from "express";
+import { healthRoutes } from "../modules/health/health.route";
+const router = Router();
+
+// versioned API
+const v1 = Router();
+
+v1.use("/health", healthRoutes);
+
+router.use("/v1", v1);
+
+export const apiRoutes = router;

package/templates/express/src/shared/errors/api-error.ts

@@ -0,0 +1,14 @@
+export default class ApiError extends Error {
+  statusCode: number;
+  isOperational: boolean;
+
+  constructor(statusCode: number, message: string, isOperational = true) {
+    super(message);
+    this.statusCode = statusCode;
+    this.isOperational = isOperational;
+    Object.setPrototypeOf(this, ApiError.prototype);
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+}

package/templates/express/src/shared/errors/error-codes.ts

@@ -0,0 +1,9 @@
+const ERROR_CODES = {
+  VALIDATION: "VALIDATION_ERROR",
+  NOT_FOUND: "NOT_FOUND",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  FORBIDDEN: "FORBIDDEN",
+  INTERNAL: "INTERNAL_ERROR",
+} as const;
+
+export default ERROR_CODES;

package/templates/express/src/shared/logger/logger.ts

@@ -0,0 +1,20 @@
+function ts() {
+  return new Date().toISOString();
+}
+
+export const info = (msg: string, meta?: any) => {
+  console.log(`${ts()} INFO: ${msg}` + (meta ? ` ${JSON.stringify(meta)}` : ""));
+};
+export const warn = (msg: string, meta?: any) => {
+  console.warn(`${ts()} WARN: ${msg}` + (meta ? ` ${JSON.stringify(meta)}` : ""));
+};
+export const error = (msg: string, meta?: any) => {
+  console.error(`${ts()} ERROR: ${msg}` + (meta ? ` ${JSON.stringify(meta)}` : ""));
+};
+export const debug = (msg: string, meta?: any) => {
+  if (process.env.NODE_ENV !== "production") {
+    console.debug(`${ts()} DEBUG: ${msg}` + (meta ? ` ${JSON.stringify(meta)}` : ""));
+  }
+};
+
+export default { info, warn, error, debug };

package/templates/express/src/{middlewares → shared/middlewares}/error.middleware.ts

@@ -1,5 +1,5 @@
 import { NextFunction, Request, Response } from "express";
-import { env } from "../config/env";
+import { env } from "../../config/env";
 
 export const errorHandler = (err: any, _req: Request, res: Response, _: NextFunction) => {
   const statusCode = err.status || 500;

package/templates/express/src/shared/middlewares/not-found.middleware.ts

@@ -0,0 +1,9 @@
+import { Request, Response } from "express";
+
+export function notFound(req: Request, res: Response) {
+  res.status(404).json({
+    message: `Can't find ${req.originalUrl} on this server!`,
+    path: req.originalUrl,
+    date: Date(),
+  });
+}

package/templates/express/src/shared/utils/async-handler.ts

@@ -0,0 +1,9 @@
+import { NextFunction, Request, Response } from "express";
+
+export default function asyncHandler(
+  fn: (req: Request, res: Response, next: NextFunction) => Promise<any>,
+) {
+  return (req: Request, res: Response, next: NextFunction) => {
+    fn(req, res, next).catch(next);
+  };
+}

package/templates/express/src/shared/utils/pagination.ts

@@ -0,0 +1,6 @@
+export function getPagination(query: any) {
+  const page = Math.max(1, parseInt(String(query.page || "1"), 10) || 1);
+  const limit = Math.min(100, parseInt(String(query.limit || "10"), 10) || 10);
+  const skip = (page - 1) * limit;
+  return { page, limit, skip, take: limit };
+}

package/templates/express/src/shared/utils/response.ts

@@ -0,0 +1,9 @@
+import { Response } from "express";
+
+export function success(res: Response, data: any, message = "Success", meta?: any) {
+  return res.json({ success: true, message, data, meta });
+}
+
+export function fail(res: Response, status = 500, message = "Error", details?: any) {
+  return res.status(status).json({ success: false, message, details });
+}

package/templates/express/tsconfig.json

@@ -1,9 +1,15 @@
 {
   "compilerOptions": {
+    "sourceMap": true,
+    "outDir": "dist",
+    "strict": true,
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM"],
+    "skipLibCheck": true,
+    "types": ["node"],
+    "esModuleInterop": true,
     "module": "ESNext",
     "moduleResolution": "node",
-    "target": "ES2023",
-    "strict": true,
-    "esModuleInterop": true
+    "resolveJsonModule": true
   }
 }

package/templates/react/src/app/layouts/dashboard-layout.tsx

@@ -0,0 +1,8 @@
+export default function DashboardLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <div className="dashboard-layout">
+      <aside>Sidebar</aside>
+      <main>{children}</main>
+    </div>
+  );
+}

package/templates/react/src/app/layouts/public-layout.tsx

@@ -0,0 +1,5 @@
+import Layout from "../../shared/components/layout";
+
+export default function PublicLayout() {
+  return <Layout />;
+}

package/templates/react/src/app/providers.tsx

@@ -0,0 +1,20 @@
+import { QueryClientProvider } from "@tanstack/react-query";
+import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
+import { Toaster } from "react-hot-toast";
+import { SEOProvider } from "../shared/components/seo";
+import { queryClient } from "../shared/lib/query-client";
+import type { ReactNode } from "react";
+
+export function Providers({ children }: { children: ReactNode }) {
+  return (
+    <SEOProvider>
+      <QueryClientProvider client={queryClient}>
+        {children}
+        <Toaster position="top-right" />
+        <ReactQueryDevtools initialIsOpen={false} />
+      </QueryClientProvider>
+    </SEOProvider>
+  );
+}
+
+export default Providers;

package/templates/react/src/app/router.tsx

@@ -0,0 +1,21 @@
+import { createBrowserRouter } from "react-router";
+import { ErrorBoundary } from "../shared/components/error-boundary";
+import PublicLayout from "./layouts/public-layout";
+import Home from "../features/home/pages/home";
+import About from "../features/about/pages/about";
+import NotFound from "../shared/pages/not-found";
+
+export const router = createBrowserRouter([
+  {
+    path: "/",
+    Component: PublicLayout,
+    errorElement: <ErrorBoundary />,
+    children: [
+      { index: true, Component: Home },
+      { path: "about", Component: About },
+      { path: "*", Component: NotFound },
+    ],
+  },
+]);
+
+export default router;

package/templates/react/src/{pages/About.tsx → features/about/pages/about.tsx}

@@ -1,4 +1,4 @@
-import { SEO } from "../components/SEO";
+import { SEO } from "../../../shared/components/seo";
 
 export default function About() {
   return (

package/templates/react/src/{pages/Home.tsx → features/home/pages/home.tsx}

@@ -1,4 +1,4 @@
-import { SEO } from "../components/SEO";
+import { SEO } from "../../../shared/components/seo";
 
 export default function Home() {
   return (

package/templates/react/src/main.tsx

@@ -4,10 +4,10 @@ import { StrictMode } from "react";
 import { createRoot } from "react-dom/client";
 import { Toaster } from "react-hot-toast";
 import { RouterProvider } from "react-router";
-import { SEOProvider } from "./components/SEO";
 import "./index.css";
-import { queryClient } from "./lib/queryClient";
 import { router } from "./router";
+import { queryClient } from "./shared/lib/query-client";
+import { SEOProvider } from "./shared/components/seo";
 
 createRoot(document.getElementById("root")!).render(
   <StrictMode>

package/templates/react/src/{api/client.ts → shared/api/http.ts}

@@ -14,7 +14,7 @@ api.interceptors.request.use(
   (config) => {
     const token = localStorage.getItem("auth_token");
     if (token) {
-      config.headers.Authorization = `Bearer ${token}`;
+      (config.headers as Record<string, string>).Authorization = `Bearer ${token}`;
     }
     return config;
   },

package/templates/react/src/{pages/NotFound.tsx → shared/pages/not-found.tsx}

@@ -1,5 +1,5 @@
 import { Link } from "react-router";
-import { SEO } from "../components/SEO";
+import { SEO } from "../components/seo";
 
 export default function NotFound() {
   return (

package/dist/lib/git-utils.d.ts

@@ -1 +0,0 @@
-export declare function initGit(cwd: string): Promise<void>;

package/dist/lib/git-utils.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initGit = initGit;
-const child_process_1 = require("child_process");
-async function initGit(cwd) {
-    try {
-        (0, child_process_1.execSync)("git --version", { stdio: "pipe" });
-    }
-    catch {
-        throw new Error("Git is not installed or not available in PATH");
-    }
-    try {
-        (0, child_process_1.execSync)("git status", { cwd, stdio: "pipe" });
-        return;
-    }
-    catch {
-        // Not a git repo, proceed with initialization
-    }
-    (0, child_process_1.execSync)("git init", { cwd, stdio: "pipe" });
-    (0, child_process_1.execSync)("git add .", { cwd, stdio: "pipe" });
-    try {
-        (0, child_process_1.execSync)("git diff --cached --quiet", { cwd, stdio: "pipe" });
-        return;
-    }
-    catch {
-        // Files are staged, proceed with commit
-    }
-    (0, child_process_1.execSync)('git commit -m "Initial commit"', { cwd, stdio: "pipe" });
-}

package/modules/auth/authjs/files/api/auth/[...nextauth]/route.ts

@@ -1,2 +0,0 @@
-import { handlers } from "@/auth"
-export const { GET, POST } = handlers

package/modules/auth/authjs/files/lib/auth.ts

@@ -1,22 +0,0 @@
-import NextAuth from "next-auth"
-import { PrismaAdapter } from "@auth/prisma-adapter"
-import { prisma } from "./prisma";
-import Google from "next-auth/providers/google"
-import { encode, decode } from 'next-auth/jwt';
-
-export const { handlers, signIn, signOut, auth } = NextAuth({
-  adapter: PrismaAdapter(prisma),
-  providers: [
-    Google({
-      clientId: process.env.AUTH_GOOGLE_ID,
-      clientSecret: process.env.AUTH_GOOGLE_SECRET,
-    }),
-  ],
-  session: { strategy: "jwt" },
-  secret: process.env.AUTH_SECRET,
-  jwt: { encode, decode },
-  pages: {
-    signIn: '/sign-in',
-    error: '/error',
-  },
-})