create-backlist 6.1.5 → 6.1.7

package/src/templates/node-ts-express/partials/Dockerfile.ejs

@@ -1,33 +1,55 @@
-# Auto-generated by create-backlist v5.0
+# Auto-generated by create-backlist v5.1
 
 # ---- Base Stage ----
 FROM node:18-alpine AS base
 WORKDIR /usr/src/app
 COPY package*.json ./
 
-# ---- Dependencies Stage ----
-FROM base AS dependencies
-RUN npm install --frozen-lockfile
+# ---- Dependencies Stage (dev deps included for build) ----
+FROM base AS deps
+# npm ci is the correct "lockfile strict" install for npm
+RUN npm ci
 
 # ---- Build Stage ----
 FROM base AS build
-COPY --from=dependencies /usr/src/app/node_modules ./node_modules
+COPY --from=deps /usr/src/app/node_modules ./node_modules
 COPY . .
-<% if (dbType === 'prisma') { %>
+<% if (dbType === 'prisma') { -%>
 RUN npx prisma generate
-<% } %>
+<% } -%>
 RUN npm run build
 
+# ---- Production Dependencies Stage (prod deps only) ----
+FROM base AS prod-deps
+RUN npm ci --omit=dev
+
 # ---- Production Stage ----
 FROM node:18-alpine AS production
 WORKDIR /usr/src/app
+
+ENV NODE_ENV=production
+
+# copy compiled output
 COPY --from=build /usr/src/app/dist ./dist
-COPY --from=dependencies /usr/src/app/node_modules ./node_modules
+
+# copy prod-only node_modules
+COPY --from=prod-deps /usr/src/app/node_modules ./node_modules
+
+# package files (optional but nice)
 COPY package*.json ./
-<% if (dbType === 'prisma') { %>
-# Copy Prisma schema for runtime
+
+<% if (dbType === 'prisma') { -%>
+# Prisma schema (if your runtime uses it)
 COPY prisma ./prisma
-<% } %>
+<% } -%>
+
+# run as non-root user (security)
+RUN addgroup -S app && adduser -S app -G app
+USER app
 
 EXPOSE <%= port %>
+
+# Optional healthcheck if you have /api/health
+# HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 CMD wget -qO- http://localhost:<%= port %>/api/health || exit 1
+
 CMD ["node", "dist/server.js"]

package/src/templates/node-ts-express/partials/Model.cs.ejs

@@ -1,18 +1,51 @@
 // Auto-generated by create-backlist
+using System;
+using System.ComponentModel.DataAnnotations;
+
 namespace <%= projectName %>.Models
 {
     public class <%= modelName %>
     {
-        public Guid Id { get; set; }
+        [Key]
+        public Guid Id { get; set; } = Guid.NewGuid();
 
         <% model.fields.forEach(field => { %>
-        <% let csharpType = 'string'; %>
-        <% if (field.type === 'Number') csharpType = 'int'; %>
-        <% if (field.type === 'Boolean') csharpType = 'bool'; %>
-        public <%= csharpType %> <%= field.name %> { get; set; }
+        <% 
+          // Basic type mapping
+          let csharpType = 'string';
+          if (field.type === 'Number') csharpType = 'int';
+          if (field.type === 'Boolean') csharpType = 'bool';
+
+          // Small heuristic: money-like fields -> decimal
+          const n = String(field.name || '').toLowerCase();
+          if (field.type === 'Number' && (n.includes('price') || n.includes('amount') || n.includes('total'))) {
+            csharpType = 'decimal';
+          }
+
+          // Required/Unique hints
+          const isEmail = n.includes('email');
+        %>
+
+        <% if (field.isUnique) { %>
+        // NOTE: Unique constraint should be configured in DbContext (HasIndex().IsUnique()).
+        <% } %>
+
+        <% if (isEmail) { %>
+        [EmailAddress]
+        <% } %>
+
+        <% if (csharpType === 'string') { %>
+        [Required]
+        public string <%= field.name.charAt(0).toUpperCase() + field.name.slice(1) %> { get; set; } = string.Empty;
+        <% } else { %>
+        public <%= csharpType %> <%= field.name.charAt(0).toUpperCase() + field.name.slice(1) %> { get; set; }
+        <% } %>
+
         <% }); %>
 
         public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
+
+        // NOTE: Ideally update this automatically in DbContext.SaveChanges override.
         public DateTime UpdatedAt { get; set; } = DateTime.UtcNow;
     }
 }

package/src/templates/node-ts-express/partials/Model.ts.ejs

@@ -1,22 +1,52 @@
 // Auto-generated by create-backlist on <%= new Date().toISOString() %>
 import mongoose, { Schema, Document } from 'mongoose';
 
-// Define the interface for the Document
 export interface I<%= modelName %> extends Document {
-<% Object.keys(schema).forEach(key => { %>
-  <%= key %>: <%= schema[key].toLowerCase() %>;
+<% Object.keys(schema).forEach(key => {
+    const t = String(schema[key] || 'String');
+    let tsType = 'string';
+    if (t === 'Number') tsType = 'number';
+    if (t === 'Boolean') tsType = 'boolean';
+    if (t === 'Date') tsType = 'Date';
+%>
+  <%= key %>: <%= tsType %>;
 <% }); %>
 }
 
-// Define the Mongoose Schema
-const <%= modelName %>Schema: Schema = new Schema({
-<% Object.keys(schema).forEach(key => { %>
-  <%= key %>: {
-    type: <%= schema[key] %>,
-    // TODO: Add 'required', 'unique', etc. here
-  },
+const <%= modelName %>Schema = new Schema<I<%= modelName %>>(
+  {
+<% Object.keys(schema).forEach(key => {
+    const t = String(schema[key] || 'String');
+    const lower = String(key).toLowerCase();
+    const isEmail = lower === 'email' || lower.includes('email');
+    const isPassword = lower === 'password';
+    const isNameLike = ['name','title'].some(x => lower === x || lower.includes(x));
+%>
+    <%= key %>: {
+      type: <%= t %>,
+      <% if (isEmail) { -%>
+      required: true,
+      unique: true,
+      trim: true,
+      lowercase: true,
+      <% } else if (isPassword) { -%>
+      required: true,
+      select: false,
+      <% } else if (isNameLike) { -%>
+      required: true,
+      trim: true,
+      <% } else { -%>
+      // TODO: add required/unique/default/enum rules if needed
+      <% } -%>
+    },
 <% }); %>
-}, { timestamps: true });
+  },
+  { timestamps: true }
+);
+
+// Extra indexes (optional)
+<% if (Object.keys(schema).some(k => String(k).toLowerCase().includes('email'))) { -%>
+<%= modelName %>Schema.index({ email: 1 }, { unique: true });
+<% } -%>
 
-// Create and export the Model
 export default mongoose.model<I<%= modelName %>>('<%= modelName %>', <%= modelName %>Schema);

package/src/templates/node-ts-express/partials/PrismaController.ts.ejs

@@ -1,6 +1,18 @@
-// Auto-generated by create-backlist v5.0 (Prisma Version)
+// Auto-generated by create-backlist v5.1 (Prisma Version)
 import { Request, Response } from 'express';
-import { prisma } from '../server'; // Import the Prisma client instance
+import { prisma } from '../db/prisma';
+
+function safeErrorMessage(error: unknown) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+function parseId(id: string) {
+  <% if (idIsNumber) { -%>
+  return Number(id);
+  <% } else { -%>
+  return id;
+  <% } -%>
+}
 
 // @desc    Create a new <%= modelName %>
 export const create<%= modelName %> = async (req: Request, res: Response) => {
@@ -8,59 +20,81 @@ export const create<%= modelName %> = async (req: Request, res: Response) => {
     const newDoc = await prisma.<%= modelName.toLowerCase() %>.create({
       data: req.body,
     });
-    res.status(201).json(newDoc);
+    return res.status(201).json(newDoc);
   } catch (error) {
-    res.status(500).json({ message: 'Error creating document', error });
+    return res.status(500).json({ message: 'Error creating document', error: safeErrorMessage(error) });
   }
 };
 
-// @desc    Get all <%= modelName %>s
+// @desc    Get all <%= modelName %>s (supports pagination: ?page=&limit=)
 export const getAll<%= modelName %>s = async (req: Request, res: Response) => {
   try {
-    const docs = await prisma.<%= modelName.toLowerCase() %>.findMany();
-    res.status(200).json(docs);
+    const page = Number(req.query.page || 1);
+    const limit = Number(req.query.limit || 50);
+    const skip = (page - 1) * limit;
+
+    const docs = await prisma.<%= modelName.toLowerCase() %>.findMany({
+      skip,
+      take: limit,
+      orderBy: { createdAt: 'desc' } as any
+    });
+
+    return res.status(200).json(docs);
   } catch (error) {
-    res.status(500).json({ message: 'Error fetching documents', error });
+    return res.status(500).json({ message: 'Error fetching documents', error: safeErrorMessage(error) });
   }
 };
 
 // @desc    Get a single <%= modelName %> by ID
 export const get<%= modelName %>ById = async (req: Request, res: Response) => {
   try {
-    const { id } = req.params;
+    const id = parseId(req.params.id);
+
     const doc = await prisma.<%= modelName.toLowerCase() %>.findUnique({
-      where: { id },
+      where: { id } as any,
     });
-    if (!doc) return res.status(404).json({ message: 'Document not found' });
-    res.status(200).json(doc);
+
+    if (!doc) return res.status(404).json({ message: '<%= modelName %> not found' });
+    return res.status(200).json(doc);
   } catch (error) {
-    res.status(500).json({ message: 'Error fetching document', error });
+    return res.status(500).json({ message: 'Error fetching document', error: safeErrorMessage(error) });
   }
 };
 
 // @desc    Update a <%= modelName %> by ID
 export const update<%= modelName %>ById = async (req: Request, res: Response) => {
   try {
-    const { id } = req.params;
+    const id = parseId(req.params.id);
+
     const doc = await prisma.<%= modelName.toLowerCase() %>.update({
-      where: { id },
+      where: { id } as any,
       data: req.body,
     });
-    res.status(200).json(doc);
-  } catch (error) {
-    res.status(500).json({ message: 'Error updating document', error });
+
+    return res.status(200).json(doc);
+  } catch (error: any) {
+    // Prisma "Record not found"
+    if (error?.code === 'P2025') {
+      return res.status(404).json({ message: '<%= modelName %> not found' });
+    }
+    return res.status(500).json({ message: 'Error updating document', error: safeErrorMessage(error) });
   }
 };
 
 // @desc    Delete a <%= modelName %> by ID
 export const delete<%= modelName %>ById = async (req: Request, res: Response) => {
   try {
-    const { id } = req.params;
+    const id = parseId(req.params.id);
+
     await prisma.<%= modelName.toLowerCase() %>.delete({
-      where: { id },
+      where: { id } as any,
     });
-    res.status(200).json({ message: 'Document deleted successfully' });
-  } catch (error) {
-    res.status(500).json({ message: 'Error deleting document', error });
+
+    return res.status(200).json({ message: '<%= modelName %> deleted successfully' });
+  } catch (error: any) {
+    if (error?.code === 'P2025') {
+      return res.status(404).json({ message: '<%= modelName %> not found' });
+    }
+    return res.status(500).json({ message: 'Error deleting document', error: safeErrorMessage(error) });
   }
 };

package/src/templates/node-ts-express/partials/PrismaSchema.prisma.ejs

@@ -1,25 +1,48 @@
-// Auto-generated by create-backlist v5.0
+// Auto-generated by create-backlist v5.1
 
 generator client {
   provider = "prisma-client-js"
 }
 
 datasource db {
-  provider = "postgresql" // User can change to "mysql", "sqlite", "sqlserver", etc.
+  provider = "<%= dbProvider || 'postgresql' %>"
   url      = env("DATABASE_URL")
 }
 
-<%# Loop through each model identified by the analyzer %>
+<%
+function sanitizeFieldName(name) {
+  const s = String(name || '').trim().replace(/[^a-zA-Z0-9_]/g, '_');
+  if (!s) return 'field';
+  if (/^[0-9]/.test(s)) return '_' + s;
+  return s;
+}
+%>
+
 <% modelsToGenerate.forEach(model => { %>
 model <%= model.name %> {
+  <% if (useIntId) { %>
+  id        Int      @id @default(autoincrement())
+  <% } else { %>
   id        String   @id @default(cuid())
-  <%# Loop through each field in the model %>
-  <% model.fields.forEach(field => { %>
-  <%# Map JS types to Prisma types. This is a basic mapping. %>
-  <% let prismaType = 'String'; %>
-  <% if (field.type === 'Number') prismaType = 'Int'; %>
-  <% if (field.type === 'Boolean') prismaType = 'Boolean'; %>
-  <%= field.name.padEnd(10) %>  <%= prismaType %><%- field.isOptional ? '?' : '' %><%- field.isUnique ? ' @unique' : '' %>
+  <% } %>
+
+  <% model.fields.forEach(field => { 
+    const fname = sanitizeFieldName(field.name);
+    const lower = String(fname).toLowerCase();
+
+    let prismaType = 'String';
+    if (field.type === 'Number') prismaType = 'Int';
+    if (field.type === 'Boolean') prismaType = 'Boolean';
+
+    // money/decimal heuristic
+    if (field.type === 'Number' && (lower.includes('price') || lower.includes('amount') || lower.includes('total'))) {
+      prismaType = 'Decimal';
+    }
+
+    const optional = field.isOptional ? '?' : '';
+    const unique = field.isUnique ? ' @unique' : '';
+  %>
+  <%= fname.padEnd(16) %> <%= prismaType %><%= optional %><%= unique %>
   <% }); %>
 
   createdAt DateTime @default(now())

package/src/templates/node-ts-express/partials/README.md.ejs

@@ -2,15 +2,13 @@
 
 This backend was auto-generated by **Backlist**.
 
-## 🚀 Getting Started
+## Requirements
+- Node.js 18+ (recommended)
+- npm 9+
 
-1.  **Navigate to the directory:**
-    ```bash
-    cd <%= projectName %>
-    ```
+<% if (dbType === 'mongoose') { -%>
+## Database (MongoDB / Mongoose)
+Set your Mongo connection string in `.env`:
 
-2.  **Run the development server:**
-    ```bash
-    npm run dev
-    ```
-    The server will start on `http://localhost:8000`.
+```bash
+MONGO_URI=mongodb://127.0.0.1:27017/<%= projectName %>

package/src/templates/node-ts-express/partials/Seeder.ts.ejs

@@ -1,83 +1,126 @@
-// Auto-generated by create-backlist v4.0 on <%= new Date().toISOString() %>
+// Auto-generated by create-backlist on <%= new Date().toISOString() %>
 import mongoose from 'mongoose';
 import dotenv from 'dotenv';
 import { faker } from '@faker-js/faker';
-import chalk from 'chalk'; // For colorful console logs
+import chalk from 'chalk';
 
-// Load env vars
 dotenv.config();
 
-// We assume a User model exists for seeding.
-// The path is relative to the generated 'backend' project root.
-import User from '../src/models/User.model';
+const MONGO_URI = process.env.MONGO_URI || 'mongodb://127.0.0.1:27017/<%= projectName %>';
 
-// --- Connect to DB ---
-const connectDB = async () => {
+function errMsg(e: unknown) {
+  return e instanceof Error ? e.message : String(e);
+}
+
+// Dynamically import generated models
+<%
+  const models = Array.isArray(models) ? models : [];
+  // Ensure unique by name
+  const uniq = [];
+  for (const m of models) {
+    if (m && m.name && !uniq.find(x => x.name === m.name)) uniq.push(m);
+  }
+%>
+<% uniq.forEach(m => { -%>
+import <%= m.name %> from '../src/models/<%= m.name %>.model';
+<% }); -%>
+
+async function connectDB() {
   try {
-    const MONGO_URI = process.env.MONGO_URI || 'mongodb://127.0.0.1:27017/<%= projectName %>';
-    if (!MONGO_URI) {
-        throw new Error('MONGO_URI is not defined in your .env file');
-    }
     await mongoose.connect(MONGO_URI);
     console.log(chalk.green('MongoDB Connected for Seeder...'));
-  } catch (err) {
-    console.error(chalk.red(`Seeder DB Connection Error: ${err.message}`));
+  } catch (e) {
+    console.error(chalk.red(`Seeder DB Connection Error: ${errMsg(e)}`));
     process.exit(1);
   }
-};
+}
+
+function fakeValue(fieldName: string, fieldType: string) {
+  const n = fieldName.toLowerCase();
+
+  if (fieldType === 'Number') {
+    if (n.includes('price') || n.includes('amount') || n.includes('total')) return faker.number.int({ min: 10, max: 5000 });
+    if (n.includes('age')) return faker.number.int({ min: 18, max: 70 });
+    return faker.number.int({ min: 1, max: 999 });
+  }
+
+  if (fieldType === 'Boolean') return faker.datatype.boolean();
+
+  // String
+  if (n.includes('email')) return faker.internet.email().toLowerCase();
+  if (n.includes('name')) return faker.person.fullName();
+  if (n.includes('phone')) return faker.phone.number();
+  if (n.includes('address')) return faker.location.streetAddress();
+  if (n.includes('city')) return faker.location.city();
+  if (n.includes('country')) return faker.location.country();
+  if (n.includes('password')) return 'Password123!';
+  if (n.includes('title')) return faker.lorem.words(3);
+  if (n.includes('description')) return faker.lorem.paragraph();
+  if (n.includes('image') || n.includes('avatar')) return faker.image.url();
+
+  return faker.lorem.word();
+}
 
-// --- Import Data ---
-const importData = async () => {
+async function importData() {
   try {
-    // Clear existing data
-    await User.deleteMany();
-
-    const sampleUsers = [];
-    const userCount = 10; // Number of sample users to create
-
-    for (let i = 0; i < userCount; i++) {
-      sampleUsers.push({
-        name: faker.person.fullName(),
-        email: faker.internet.email().toLowerCase(),
-        password: 'password123', // All sample users will have the same password for easy testing
-      });
-    }
+    console.log(chalk.blue('Clearing existing data...'));
+
+    <% uniq.forEach(m => { -%>
+    await <%= m.name %>.deleteMany();
+    <% }); -%>
+
+    console.log(chalk.blue('Inserting seed data...'));
+
+    const count = 10;
+
+    <% uniq.forEach(m => {
+      const fields = Array.isArray(m.fields) ? m.fields : [];
+    -%>
+    // Seed <%= m.name %>
+    {
+      const rows: any[] = [];
+      for (let i = 0; i < count; i++) {
+        const obj: any = {};
+        <% fields.forEach(f => { -%>
+        obj['<%= f.name %>'] = fakeValue('<%= f.name %>', '<%= f.type %>');
+        <% }); -%>
+        rows.push(obj);
+      }
 
-    await User.insertMany(sampleUsers);
+      // Use create() to trigger hooks (e.g., password hashing)
+      await <%= m.name %>.create(rows);
+    }
+    <% }); -%>
 
     console.log(chalk.green.bold('✅ Data Imported Successfully!'));
-    process.exit();
-  } catch (error) {
-    console.error(chalk.red(`Error with data import: ${error.message}`));
-    process.exit(1);
+  } catch (e) {
+    console.error(chalk.red(`Error with data import: ${errMsg(e)}`));
+    process.exitCode = 1;
+  } finally {
+    await mongoose.disconnect();
   }
-};
+}
 
-// --- Destroy Data ---
-const destroyData = async () => {
+async function destroyData() {
   try {
-    await User.deleteMany();
-    // If you have other models, you can add them here for destruction
-    // e.g., await Product.deleteMany();
-
+    <% uniq.forEach(m => { -%>
+    await <%= m.name %>.deleteMany();
+    <% }); -%>
     console.log(chalk.red.bold('🔥 Data Destroyed Successfully!'));
-    process.exit();
-  } catch (error) {
-    console.error(chalk.red(`Error with data destruction: ${error.message}`));
-    process.exit(1);
+  } catch (e) {
+    console.error(chalk.red(`Error with data destruction: ${errMsg(e)}`));
+    process.exitCode = 1;
+  } finally {
+    await mongoose.disconnect();
   }
-};
+}
 
-// --- CLI Logic to run the seeder ---
-const runSeeder = async () => {
+async function runSeeder() {
   await connectDB();
 
-  // process.argv[2] will be '-d' if the script is run with `npm run destroy`
-  if (process.argv[2] === '-d') {
-    await destroyData();
-  } else {
-    await importData();
-  }
-};
+  // `npm run destroy` passes "-d"
+  if (process.argv[2] === '-d') await destroyData();
+  else await importData();
+}
 
 runSeeder();

package/src/templates/node-ts-express/partials/docker-compose.yml.ejs

@@ -1,4 +1,4 @@
-# Auto-generated by create-backlist v5.0
+# Auto-generated by create-backlist v5.1
 version: '3.8'
 
 services:
@@ -9,23 +9,44 @@ services:
       - '<%= port %>:<%= port %>'
     environment:
       - PORT=<%= port %>
+      <% if (dbType === 'mongoose') { -%>
+      - MONGO_URI=${MONGO_URI}
+      <% } else if (dbType === 'prisma') { -%>
       - DATABASE_URL=${DATABASE_URL}
+      <% } -%>
+      <% if (addAuth) { -%>
       - JWT_SECRET=${JWT_SECRET}
+      <% } -%>
+      <% if (extraFeatures && extraFeatures.includes('swagger')) { -%>
+      - API_BASE_URL=http://localhost:<%= port %>
+      <% } -%>
     depends_on:
-      - db
+      db:
+        condition: service_healthy
     volumes:
       - .:/usr/src/app
       - /usr/src/app/node_modules
     command: npm run dev
+    restart: unless-stopped
 
   db:
     <% if (dbType === 'mongoose') { %>
-    image: mongo:latest
+    image: mongo:6
     container_name: <%= projectName %>-mongo-db
+    environment:
+      - MONGO_INITDB_ROOT_USERNAME=${DB_USER}
+      - MONGO_INITDB_ROOT_PASSWORD=${DB_PASSWORD}
+      - MONGO_INITDB_DATABASE=${DB_NAME}
     ports:
       - '27017:27017'
     volumes:
       - mongo-data:/data/db
+    healthcheck:
+      test: ["CMD", "mongosh", "--quiet", "mongodb://$$DB_USER:$$DB_PASSWORD@localhost:27017/admin", "--eval", "db.runCommand({ ping: 1 }).ok" ]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+    restart: unless-stopped
     <% } else if (dbType === 'prisma') { %>
     image: postgres:14-alpine
     container_name: <%= projectName %>-postgres-db
@@ -37,6 +58,12 @@ services:
       - POSTGRES_DB=${DB_NAME}
     volumes:
       - postgres-data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+    restart: unless-stopped
     <% } %>
 
 volumes: