exp-node-server 1.1.7 → 2.0.0

package/package.json

@@ -1,19 +1,37 @@
 {
   "name": "exp-node-server",
-  "version": "1.1.7",
+  "version": "2.0.0",
+  "description": "CLI to scaffold Express + TypeScript APIs with Mongoose or Prisma, Zod validation and Swagger docs",
   "type": "module",
   "bin": {
-    "exp-node-server": "./bin/cli.js"
+    "exp-node-server": "./dist/cli.js"
   },
   "files": [
-    "bin",
-    "src",
-    "templates"
+    "dist",
+    "templates",
+    "!templates/*/node_modules",
+    "!templates/*/dist",
+    "!templates/*/coverage",
+    "!templates/*/.env"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
   "dependencies": {
-    "chalk": "^5.3.0",
-    "ora": "^7.0.1",
-    "inquirer": "^9.2.7"
+    "@inquirer/select": "^5.2.6",
+    "chalk": "^5.6.2",
+    "ora": "^9.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "tsup": "^8.5.1",
+    "typescript": "^7.0.2",
+    "vitest": "^3.2.7"
   },
   "keywords": [
     "express",
@@ -28,7 +46,9 @@
     "exp-node",
     "server"
   ],
+  "author": "Abumahid (https://abumahid.me)",
+  "homepage": "https://www.npmjs.com/package/exp-node-server",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.17.0"
   }
 }

package/templates/mongoose/.dockerignore

@@ -0,0 +1,10 @@
+node_modules
+npm-debug.log
+Dockerfile
+.git
+.gitignore
+README.md
+.env
+dist
+docker-compose.ymltests
+coverage

package/templates/mongoose/.env.example

@@ -1,23 +1,72 @@
+# Default Node config
 NODE_ENV=development
-DATABASE_URL=
 PORT=5000
+# Number of reverse proxies in front of the app (1 behind Caddy/Nginx). Keep 0 if exposed directly.
+TRUST_PROXY=0
 
+# Database config (docker-compose starts MongoDB on localhost:27017)
+DATABASE_URL="mongodb://localhost:27017/server_db"
 
 # JWT Configuration
+# Each secret must be a different random value of 32+ characters: `openssl rand -hex 32`
 ACCESS_TOKEN=
-REFRESH_TOKEN=
-ACCESS_EXPIRES=
-REFRESH_EXPIRES=
-RESET_SECRET=
-RESET_EXPIRES=
+# Access tokens are short-lived; refresh tokens (opaque, rotated on every use) last longer
+ACCESS_EXPIRES=15m
+REFRESH_EXPIRES_DAYS=30
 VERIFIED_TOKEN=
-FRONT_END_URL=
+RESET_SECRET=
+RESET_EXPIRES=15m
+FRONT_END_URL=http://localhost:5173
+# Comma separated list of allowed origins. Defaults to FRONT_END_URL.
+CORS_ORIGINS=
 
 # Email Configuration
 APP_USER_EMAIL=
 APP_PASSWORD=
+# "From" address. Defaults to APP_USER_EMAIL.
+MAIL_FROM=
 
 # Cloudinary Configuration
 CLOUD_NAME=
 CLOUD_API_KEY=
 CLOUD_API_SECRET=
+
+# Swagger Config (docs are disabled in production unless ENABLE_SWAGGER=true)
+ENABLE_SWAGGER=
+DEVELOPMENT_BASE_URL=http://localhost:5000
+PRODUCTION_BASE_URL=
+
+# Social login: set IS_<PROVIDER>_LOGIN=true and fill in its credentials.
+# After the provider, the browser is sent here with `?code=` (trade it via
+# POST /api/auth/social/exchange) or `?error=`. Defaults to FRONT_END_URL/auth/social/callback
+SOCIAL_REDIRECT_URL=
+
+IS_GOOGLE_LOGIN=false
+GOOGLE_CLIENT_ID=
+GOOGLE_CLIENT_SECRET=
+GOOGLE_CALLBACK_URL=http://localhost:5000/api/auth/social/google/callback
+
+IS_FACEBOOK_LOGIN=false
+FACEBOOK_APP_ID=
+FACEBOOK_APP_SECRET=
+FACEBOOK_CALLBACK_URL=http://localhost:5000/api/auth/social/facebook/callback
+
+IS_GITHUB_LOGIN=false
+GITHUB_CLIENT_ID=
+GITHUB_CLIENT_SECRET=
+GITHUB_CALLBACK_URL=http://localhost:5000/api/auth/social/github/callback
+
+IS_TWITTER_LOGIN=false
+TWITTER_CONSUMER_KEY=
+TWITTER_CONSUMER_SECRET=
+TWITTER_CALLBACK_URL=http://localhost:5000/api/auth/social/twitter/callback
+
+IS_LINKEDIN_LOGIN=false
+LINKEDIN_CLIENT_ID=
+LINKEDIN_CLIENT_SECRET=
+LINKEDIN_CALLBACK_URL=http://localhost:5000/api/auth/social/linkedin/callback
+
+IS_DISCORD_LOGIN=false
+DISCORD_CLIENT_ID=
+DISCORD_CLIENT_SECRET=
+DISCORD_CALLBACK_URL=http://localhost:5000/api/auth/social/discord/callback

package/templates/mongoose/.prettierignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+coverage

package/templates/mongoose/.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "all",
+  "printWidth": 100
+}

package/templates/mongoose/Dockerfile

@@ -0,0 +1,33 @@
+# ---------- BUILD STAGE ----------
+FROM node:22-alpine AS builder
+
+WORKDIR /app
+
+# Only install deps first (cache friendly)
+COPY package*.json ./
+RUN npm ci
+
+# Copy source + build
+COPY . .
+RUN npm run build
+
+
+# ---------- PRODUCTION STAGE ----------
+FROM node:22-alpine
+
+WORKDIR /app
+
+ENV NODE_ENV=production
+
+# Only install production deps
+COPY package*.json ./
+RUN npm ci --omit=dev && npm cache clean --force
+
+# Copy built app
+COPY --from=builder /app/dist ./dist
+
+USER node
+
+EXPOSE 5000
+
+CMD ["node", "dist/server.js"]

package/templates/mongoose/_gitignore

@@ -0,0 +1,32 @@
+# Node modules
+node_modules/
+package-lock.json
+
+# Build output
+dist/
+build/
+
+# Env files
+.env
+.env.production
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+pnpm-debug.log*
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Coverage
+coverage/
+
+# IDE/editor
+.vscode/
+.idea/
+
+# Docker 
+*.pid

package/templates/mongoose/docker-compose.yml

@@ -0,0 +1,21 @@
+services:
+  mongo:
+    image: mongo:8.2
+    container_name: server_database
+    restart: always
+
+    # only reachable from this machine (for local dev), not the internet
+    ports:
+      - "127.0.0.1:27017:27017"
+
+    volumes:
+      - mongo_data:/data/db
+
+    healthcheck:
+      test: ["CMD", "mongosh", "--quiet", "--eval", "db.adminCommand('ping')"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  mongo_data:

package/templates/mongoose/eslint.config.js

@@ -0,0 +1,35 @@
+import js from '@eslint/js';
+import prettier from 'eslint-plugin-prettier';
+import tseslint from 'typescript-eslint';
+
+export default [
+  {
+    ignores: ['node_modules', 'dist', 'coverage'],
+  },
+
+  js.configs.recommended,
+
+  ...tseslint.configs.recommended,
+
+  {
+    files: ['**/*.ts'],
+    languageOptions: {
+      parser: tseslint.parser,
+    },
+    plugins: {
+      prettier,
+    },
+    rules: {
+      'no-console': 'warn',
+      '@typescript-eslint/no-explicit-any': 'warn',
+      'prettier/prettier': 'error',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+        },
+      ],
+    },
+  },
+];