better-ts-stack 0.1.1 → 1.0.8

package/templates/frontend/nextjs/tsconfig.json

@@ -1,21 +1,34 @@
-{
-  "compilerOptions": {
-    "target": "ES2017",
-    "lib": ["dom", "dom.iterable", "esnext"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "react-jsx",
-    "incremental": true,
-    "plugins": [{ "name": "next" }],
-    "paths": { "@/*": ["./*"] }
-  },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", ".next/dev/types/**/*.ts", "**/*.mts"],
-  "exclude": ["node_modules"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

package/templates/modules/auth/express/config.json

@@ -1 +1,26 @@
-{"id":"auth","name":"JWT Auth","description":"JWT authentication with bcrypt password hashing","type":"feature","dependencies":{"bcrypt":"^5.1.1","jsonwebtoken":"^9.0.2"},"devDependencies":{"@types/bcrypt":"^5.0.0","@types/jsonwebtoken":"^9.0.5"},"scripts":{},"envVars":{"JWT_SECRET":"please-change-me","JWT_EXPIRES_IN":"1h"},"templateFiles":["src/lib/jwt.ts.hbs","src/middleware/requireAuth.ts.hbs","src/services/userStore.ts.hbs","src/routes/auth.ts.hbs","src/controllers/authController.ts.hbs"]}
+{
+  "id": "auth",
+  "name": "JWT Auth",
+  "description": "JWT authentication with bcrypt password hashing",
+  "type": "feature",
+  "dependencies": {
+    "bcrypt": "^6.0.0",
+    "jsonwebtoken": "^9.0.3"
+  },
+  "devDependencies": {
+    "@types/bcrypt": "^6.0.0",
+    "@types/jsonwebtoken": "^9.0.10"
+  },
+  "scripts": {},
+  "envVars": {
+    "JWT_SECRET": "please-change-me",
+    "JWT_EXPIRES_IN": "1h"
+  },
+  "templateFiles": [
+    "src/lib/jwt.ts.hbs",
+    "src/middleware/requireAuth.ts.hbs",
+    "src/services/userStore.ts.hbs",
+    "src/routes/auth.ts.hbs",
+    "src/controllers/authController.ts.hbs"
+  ]
+}

package/templates/modules/auth/express/src/routes/auth.ts.hbs

@@ -2,7 +2,7 @@ import { Request, Response, NextFunction, Router } from 'express';
 import { login, me, register } from '../controllers/authController';
 import { requireAuth } from '../middleware/requireAuth';
 
-const router = Router();
+const router: Router = Router();
 
 function asyncHandler(
   fn: (req: Request, res: Response, next: NextFunction) => Promise<void>

package/templates/modules/auth/express/src/services/userStore.ts.hbs

@@ -1,107 +1,95 @@
-{{#if (eq database 'none')}}
-import crypto from 'crypto';
-{{/if}}
-{{#if (eq database 'prisma')}}
-import type { User } from '../../app/generated/prisma';
-import { prisma } from '../lib/prisma';
-{{/if}}
-{{#if (eq database 'mongoose')}}
-import UserModel from '../models/User';
-{{/if}}
-
-export interface AuthUser {
-  id: string;
-  email: string;
-  name?: string | null;
-  password: string;
-}
-
-export interface CreateUserInput {
-  email: string;
-  name?: string | null;
-  password: string;
-}
-
-{{#if (eq database 'none')}}
-const users: AuthUser[] = [];
-{{/if}}
-
-export async function findUserByEmail(email: string): Promise<AuthUser | null> {
-  {{#if (eq database 'prisma')}}
-  const user: User | null = await prisma.user.findUnique({ where: { email } });
-  if (!user) return null;
-  return {
-    id: user.id,
-    email: user.email,
-    name: user.name,
-    password: user.password,
-  };
-  {{/if}}
-
-  {{#if (eq database 'mongoose')}}
-  const user = await UserModel.findOne({ email }).exec();
-  if (!user) return null;
-  return {
-    id: user.id,
-    email: user.email,
-    name: user.name,
-    password: user.password,
-  };
-  {{/if}}
-
-  {{#if (eq database 'none')}}
-  const user = users.find((candidate) => candidate.email === email);
-  return user ?? null;
-  {{/if}}
-}
-
-export async function createUser(data: CreateUserInput): Promise<AuthUser> {
-  {{#if (eq database 'prisma')}}
-  const user: User = await prisma.user.create({
-    data: {
-      email: data.email,
-      name: data.name,
-      password: data.password,
-    },
-  });
-
-  return {
-    id: user.id,
-    email: user.email,
-    name: user.name,
-    password: user.password,
-  };
-  {{/if}}
-
-  {{#if (eq database 'mongoose')}}
-  const user = await UserModel.create({
-    email: data.email,
-    name: data.name,
-    password: data.password,
-  });
-
-  return {
-    id: user.id,
-    email: user.email,
-    name: user.name,
-    password: user.password,
-  };
-  {{/if}}
-
-  {{#if (eq database 'none')}}
-  const newUser: AuthUser = {
-    id: crypto.randomUUID(),
-    email: data.email,
-    name: data.name,
-    password: data.password,
-  };
-
-  users.push(newUser);
-  return newUser;
-  {{/if}}
-}
-
-export function toPublicUser(user: AuthUser): Omit<AuthUser, 'password'> {
-  const { id, email, name } = user;
-  return { id, email, name };
-}
+{{#if (eq database 'drizzle')}}
+import { eq } from "drizzle-orm";
+import { db } from "../lib/db";
+import { users } from "../lib/schema";
+{{/if}}
+{{#if (eq database 'none')}}
+import crypto from 'crypto';
+{{/if}}
+{{#if (eq database 'prisma')}}
+import { prisma } from '../lib/prisma';
+{{/if}}
+{{#if (eq database 'mongoose')}}
+import UserModel from '../models/User';
+{{/if}}
+
+export interface AuthUser {
+  id: string;
+  email: string;
+  name?: string | null;
+  password: string;
+}
+
+export interface CreateUserInput {
+  email: string;
+  name?: string | null;
+  password: string;
+}
+
+{{#if (eq database 'none')}}
+const users: AuthUser[] = [];
+{{/if}}
+
+export {{#unless (eq database 'none')}}async {{/unless}}function findUserByEmail(email: string): Promise<AuthUser | null> {
+  {{#if (eq database 'drizzle')}}
+  const [user] = await db.select().from(users).where(eq(users.email, email)).limit(1);
+  return user ?? null;
+  {{/if}}
+  {{#if (eq database 'prisma')}}
+  return await prisma.user.findUnique({ where: { email } });
+  {{/if}}
+
+  {{#if (eq database 'mongoose')}}
+  const user = await UserModel.findOne({ email }).exec();
+  if (!user) return null;
+  return {
+    id: String(user._id),
+    email: user.email,
+    name: user.name,
+    password: user.password,
+  };
+  {{/if}}
+
+  {{#if (eq database 'none')}}
+  const user = users.find((candidate) => candidate.email === email);
+  return Promise.resolve(user ?? null);
+  {{/if}}
+}
+
+export {{#unless (eq database 'none')}}async {{/unless}}function createUser(data: CreateUserInput): Promise<AuthUser> {
+  {{#if (eq database 'drizzle')}}
+  const [user] = await db.insert(users).values(data).returning();
+  return user;
+  {{/if}}
+  {{#if (eq database 'prisma')}}
+  return await prisma.user.create({ data });
+  {{/if}}
+
+  {{#if (eq database 'mongoose')}}
+  const user = await UserModel.create(data);
+
+  return {
+    id: String(user._id),
+    email: user.email,
+    name: user.name,
+    password: user.password,
+  };
+  {{/if}}
+
+  {{#if (eq database 'none')}}
+  const newUser: AuthUser = {
+    id: crypto.randomUUID(),
+    email: data.email,
+    name: data.name,
+    password: data.password,
+  };
+
+  users.push(newUser);
+  return Promise.resolve(newUser);
+  {{/if}}
+}
+
+export function toPublicUser(user: AuthUser): Omit<AuthUser, 'password'> {
+  const { id, email, name } = user;
+  return { id, email, name };
+}

package/templates/modules/auth/nextjs/config.json

@@ -1,14 +1,14 @@
-{
+{
   "id": "auth",
   "name": "Better Auth",
   "description": "Better Auth for Next.js with optional Prisma or Drizzle adapter",
   "type": "feature",
   "dependencies": {
-    "@hookform/resolvers": "^5.2.1",
-    "better-auth": "^1.4.19",
-    "mongodb": "^6.0.0",
-    "react-hook-form": "^7.62.0",
-    "zod": "^4.1.5"
+    "@hookform/resolvers": "^5.9.1",
+    "better-auth": "^1.7.3",
+    "mongodb": "^7.6.0",
+    "react-hook-form": "^7.87.0",
+    "zod": "^4.5.4"
   },
   "devDependencies": {},
   "scripts": {},

package/templates/modules/auth/nextjs/lib/auth.ts.hbs

@@ -1,35 +1,37 @@
-import { betterAuth } from "better-auth";
-import { nextCookies } from "better-auth/next-js";
-{{#if (eq database 'prisma')}}
-import { prismaAdapter } from "better-auth/adapters/prisma";
-import client from "./prisma";
-{{/if}}
-{{#if (eq database 'drizzle')}}
-import { drizzleAdapter } from "better-auth/adapters/drizzle";
-import { db } from "./db";
-{{/if}}
-{{#if (eq database 'mongoose')}}
-import { mongodbAdapter } from "better-auth/adapters/mongodb";
-import { MongoClient } from "mongodb";
-
-const client = new MongoClient(process.env.MONGODB_URI!);
-const db = client.db();
-{{/if}}
-
-export const auth = betterAuth({
-  {{#if (eq database 'prisma')}}
-  database: prismaAdapter(client, { provider: "postgresql" }),
-  {{/if}}
+import { betterAuth } from "better-auth";
+import { nextCookies } from "better-auth/next-js";
+{{#if (eq database 'prisma')}}
+import { prismaAdapter } from "better-auth/adapters/prisma";
+import client from "./prisma";
+{{/if}}
+{{#if (eq database 'drizzle')}}
+import { drizzleAdapter } from "better-auth/adapters/drizzle";
+import { db } from "./db";
+{{/if}}
+{{#if (eq database 'mongoose')}}
+import { mongodbAdapter } from "better-auth/adapters/mongodb";
+import { MongoClient } from "mongodb";
+
+const client = new MongoClient(process.env.MONGODB_URI!);
+const db = client.db();
+{{/if}}
+
+export const auth = betterAuth({
+  {{#if (eq database 'prisma')}}
+  database: prismaAdapter(client, { provider: "postgresql" }),
+  {{/if}}
   {{#if (eq database 'drizzle')}}
   database: drizzleAdapter(db, { provider: "pg" }),
   {{/if}}
-  {{#if (eq database 'mongoose')}}
-  database: mongodbAdapter(db, { client }),
-  {{/if}}
-  emailAndPassword: {
-    enabled: true,
-  },
-  plugins: [nextCookies()],
-  secret: process.env.BETTER_AUTH_SECRET,
-  baseURL: process.env.BETTER_AUTH_URL,
-});
+  {{#if (eq database 'mongoose')}}
+  // Transactions require a replica set. Create user/session/account/verification
+  // collections before the first sign-up; see the database setup documentation.
+  database: mongodbAdapter(db, { client }),
+  {{/if}}
+  emailAndPassword: {
+    enabled: true,
+  },
+  plugins: [nextCookies()],
+  secret: process.env.BETTER_AUTH_SECRET,
+  baseURL: process.env.BETTER_AUTH_URL,
+});

package/templates/modules/docker/.dockerignore

@@ -1,13 +1,14 @@
-node_modules
-npm-debug.log
-.env
-.env.local
-.git
-.gitignore
-README.md
-.vscode
-.idea
-dist
-coverage
-.DS_Store
-*.log
+node_modules
+npm-debug.log
+.env*
+.git
+.gitignore
+README.md
+.vscode
+.idea
+dist
+coverage
+.DS_Store
+*.log
+
+.next

package/templates/modules/docker/Dockerfile.hbs

@@ -1,71 +1,81 @@
-{{#if (eq framework 'nextjs')}}
-# Base stage
-FROM node:20-alpine AS base
-WORKDIR /app
-RUN apk add --no-cache libc6-compat
-
-# Dependencies stage
-FROM base AS deps
-COPY package*.json ./
-RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
-
-# Build stage
-FROM base AS builder
-COPY --from=deps /app/node_modules ./node_modules
-COPY . .
-RUN npm run build
-
-# Production stage
-FROM node:20-alpine AS runner
-WORKDIR /app
-ENV NODE_ENV=production
-
-RUN addgroup --system --gid 1001 nodejs && \
-    adduser --system --uid 1001 nextjs
-
-COPY --from=builder /app/public ./public
-COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
-COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
-
-USER nextjs
-EXPOSE {{port}}
-ENV PORT={{port}} HOSTNAME=0.0.0.0
-
-CMD ["node", "server.js"]
-
-{{else}}
-# Build stage
-FROM node:20-alpine AS builder
-WORKDIR /app
-
-COPY package*.json ./
-RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
-
-COPY . .
-
-# Only build if package.json has a build script
-RUN npm run build || echo "No build script found, skipping build step"
-
-# Production stage
-FROM node:20-alpine
-WORKDIR /app
-ENV NODE_ENV=production
-
-# Create non-root user for security
-RUN addgroup --system --gid 1001 nodejs && \
-    adduser --system --uid 1001 expressuser
-
-COPY package*.json ./
-RUN if [ -f package-lock.json ]; then npm ci --omit=dev; else npm install --omit=dev; fi
-
-# Copy built files (if TypeScript) or source files (if JavaScript)
-COPY --from=builder --chown=expressuser:nodejs /app/dist ./dist 2>/dev/null || \
-     COPY --chown=expressuser:nodejs /app/src ./src 2>/dev/null || \
-     COPY --chown=expressuser:nodejs /app/*.js ./
-
-USER expressuser
-EXPOSE {{port}}
-ENV PORT={{port}}
-
-CMD ["node", "{{entrypoint}}"]
+{{#if (eq framework 'nextjs')}}
+# Base stage
+FROM node:24-alpine AS base
+WORKDIR /app
+RUN apk add --no-cache libc6-compat
+
+# Dependencies stage
+FROM base AS deps
+COPY package*.json ./
+RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
+
+# Build stage
+FROM base AS builder
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+{{#if (eq database 'prisma')}}
+RUN DATABASE_URL="postgresql://postgres:postgres@localhost:5432/postgres" npm run build
+{{else if (eq database 'mongoose')}}
+RUN MONGODB_URI="mongodb://localhost:27017/build" npm run build
+{{else}}
+RUN npm run build
+{{/if}}
+
+# Production stage
+FROM node:24-alpine AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+
+RUN addgroup --system --gid 1001 nodejs && \
+    adduser --system --uid 1001 nextjs
+
+COPY --from=builder /app/public ./public
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+USER nextjs
+EXPOSE {{port}}
+ENV PORT={{port}} HOSTNAME=0.0.0.0
+
+CMD ["node", "server.js"]
+
+{{else}}
+# Build stage
+FROM node:24-alpine AS builder
+WORKDIR /app
+
+COPY package*.json ./
+RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
+
+COPY . .
+
+# Only build if package.json has a build script
+{{#if (eq database 'prisma')}}
+RUN DATABASE_URL="postgresql://postgres:postgres@localhost:5432/postgres" npm run build
+{{else if (eq database 'mongoose')}}
+RUN MONGODB_URI="mongodb://localhost:27017/build" npm run build
+{{else}}
+RUN npm run build
+{{/if}}
+
+# Production stage
+FROM node:24-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+
+# Create non-root user for security
+RUN addgroup --system --gid 1001 nodejs && \
+    adduser --system --uid 1001 expressuser
+
+COPY package*.json ./
+RUN if [ -f package-lock.json ]; then npm ci --omit=dev; else npm install --omit=dev; fi
+
+# Copy built files (if TypeScript) or source files (if JavaScript)
+COPY --from=builder --chown=expressuser:nodejs /app/dist ./dist
+
+USER expressuser
+EXPOSE {{port}}
+ENV PORT={{port}}
+
+CMD ["node", "dist/index.js"]
 {{/if}}

package/templates/modules/docker/config.json

@@ -1,16 +1,19 @@
-{
-  "id": "docker",
-  "name": "Docker",
-  "description": "Docker containerization with multi-stage build and docker-compose",
-  "type": "feature",
-  "dependencies": {},
-  "devDependencies": {},
-  "scripts": {
-    "docker:build": "docker build -t {{projectName}} .",
-    "docker:up": "docker-compose up -d",
-    "docker:down": "docker-compose down",
-    "docker:logs": "docker-compose logs -f"
-  },
-  "envVars": {},
-  "templateFiles": ["docker-compose.yml.hbs", "Dockerfile.hbs"]
-}
+{
+  "id": "docker",
+  "name": "Docker",
+  "description": "Docker containerization with multi-stage build and docker-compose",
+  "type": "feature",
+  "dependencies": {},
+  "devDependencies": {},
+  "scripts": {
+    "docker:build": "docker build -t {{projectName}} .",
+    "docker:up": "docker compose up -d",
+    "docker:down": "docker compose down",
+    "docker:logs": "docker compose logs -f"
+  },
+  "envVars": {},
+  "templateFiles": [
+    "docker-compose.yml.hbs",
+    "Dockerfile.hbs"
+  ]
+}

package/templates/modules/docker/docker-compose.yml.hbs

@@ -1,10 +1,10 @@
-version: '3.8'
-
-services:
-  {{projectName}}:
-    build: .
-    ports:
-      - "{{port}}:{{port}}"
-    environment:
-      - NODE_ENV=production
+services:
+  {{projectName}}:
+    build: .
+    ports:
+      - "{{port}}:{{port}}"
+    env_file:
+      - .env
+    environment:
+      - NODE_ENV=production
     restart: unless-stopped

package/templates/modules/drizzle/express/config.json

@@ -0,0 +1,27 @@
+{
+  "id": "drizzle",
+  "name": "Drizzle ORM",
+  "description": "Drizzle ORM for Express with PostgreSQL",
+  "type": "database",
+  "dependencies": {
+    "drizzle-orm": "^0.45.2",
+    "pg": "^8.23.0",
+    "dotenv": "^17.4.2"
+  },
+  "devDependencies": {
+    "drizzle-kit": "^0.31.10",
+    "@types/pg": "^8.23.1"
+  },
+  "scripts": {
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:studio": "drizzle-kit studio"
+  },
+  "envVars": {
+    "DATABASE_URL": "postgresql://user:password@localhost:5432/mydb?schema=public"
+  },
+  "templateFiles": [],
+  "overrides": {
+    "esbuild": "^0.28.2"
+  }
+}