create-nexgen 1.0.4

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "create-nexgen",
+  "version": "1.0.4",
+  "type": "module",
+  "description": "Scaffold a new Nexgen project",
+  "bin": {
+    "create-nexgen": "src/index.js",
+    "nexgen": "src/index.js"
+  },
+  "files": [
+    "src",
+    "template"
+  ],
+  "scripts": {
+    "prepublish": "node ../../scripts/sync-template.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "nexgen",
+    "scaffold",
+    "cli"
+  ],
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+import { readFileSync, existsSync, cpSync, mkdirSync, writeFileSync, renameSync, readdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createInterface } from "node:readline";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_DIR = join(__dirname, "..", "template");
+const PKG_PATH = join(__dirname, "..", "package.json");
+
+const pkg = JSON.parse(readFileSync(PKG_PATH, "utf-8"));
+const version = pkg.version;
+
+function ask(query) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => rl.question(query, (a) => { rl.close(); resolve(a.trim()); }));
+}
+
+function detectPackageManager() {
+  if (typeof process !== "undefined" && process.isBun) return "bun";
+  const ua = process.env.npm_config_user_agent || "";
+  if (ua.includes("bun")) return "bun";
+  if (ua.includes("pnpm")) return "pnpm";
+  if (ua.includes("yarn")) return "yarn";
+  return "npm";
+}
+
+function isValidProjectName(name) {
+  return /^[a-z0-9@][a-z0-9._-]*$/i.test(name);
+}
+
+function resolveTargetDir(name) {
+  const cwd = process.cwd();
+  const dir = join(cwd, name);
+  if (existsSync(dir)) {
+    console.error(`Error: Directory "${name}" already exists.`);
+    process.exit(1);
+  }
+  return dir;
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  let projectName = args.find((a) => !a.startsWith("--"));
+
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(`create-nexgen v${version}`);
+    console.log();
+    console.log("Usage:");
+    console.log("  npm create nexgen@latest <project-name>");
+    console.log("  pnpm create nexgen@latest <project-name>");
+    console.log("  bun create nexgen@latest <project-name>");
+    console.log("  npx nexgen@latest <project-name>");
+    process.exit(0);
+  }
+
+  if (!projectName) {
+    projectName = await ask("Project name: ");
+  }
+
+  if (!projectName || !isValidProjectName(projectName)) {
+    console.error("Error: Invalid project name. Use alphanumeric, dashes, or underscores.");
+    process.exit(1);
+  }
+
+  const targetDir = resolveTargetDir(projectName);
+
+  console.log(`\nCreating project "${projectName}"...\n`);
+
+  if (!existsSync(TEMPLATE_DIR)) {
+    console.error("Error: Template not found. Reinstall create-nexgen.");
+    process.exit(1);
+  }
+
+  mkdirSync(targetDir, { recursive: true });
+  for (const entry of readdirSync(TEMPLATE_DIR)) {
+    if (entry === "node_modules") continue;
+    cpSync(join(TEMPLATE_DIR, entry), join(targetDir, entry), { recursive: true });
+  }
+
+  const gitignoreStub = join(targetDir, "gitignore-stub");
+  if (existsSync(gitignoreStub)) {
+    renameSync(gitignoreStub, join(targetDir, ".gitignore"));
+  }
+
+  const targetPkgPath = join(targetDir, "package.json");
+  if (existsSync(targetPkgPath)) {
+    const targetPkg = JSON.parse(readFileSync(targetPkgPath, "utf-8"));
+    targetPkg.name = projectName;
+    writeFileSync(targetPkgPath, JSON.stringify(targetPkg, null, 2) + "\n");
+  }
+
+  const pm = detectPackageManager();
+
+  console.log(`Done! Created "${projectName}" at ${targetDir}`);
+  console.log();
+  console.log("  cd " + projectName);
+  console.log("  " + pm + " install");
+  console.log("  cp .env.example .env");
+  console.log();
+  console.log("Enjoy building with Nexgen!");
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/template/.dockerignore

@@ -0,0 +1,14 @@
+node_modules
+dist
+.git
+.gitignore
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+coverage
+*.log
+tmp
+temp

package/template/.env

@@ -0,0 +1,58 @@
+# ── App ────────────────────────────────────────────
+APP_NAME=nexgen
+APP_ENV=development
+APP_PORT=3000
+APP_URL=http://localhost:3000
+OPEN_API=true
+LOG_LEVEL=info
+# Frontend origin (only needed when frontend is on a different domain than API)
+# Leave empty if frontend is served from the same APP_URL or FRONTEND=false
+FRONTEND_URL=
+# Allowed CORS origins. Use * for any, or comma-separated for specific origins
+CORS_ORIGIN=*
+
+# ── Database ───────────────────────────────────────
+# Supported: mysql://, postgres://, sqlite: prefix
+DATABASE_URL=mysql://root:@localhost:3306/nexgen
+
+# ── Storage (File Uploads) ─────────────────────────
+STORAGE_DRIVER=local
+STORAGE_DISK=public
+STORAGE_BUCKET=
+STORAGE_REGION=us-east-1
+STORAGE_ENDPOINT=
+STORAGE_ACCESS_KEY_ID=
+STORAGE_SECRET_ACCESS_KEY=
+STORAGE_FORCE_PATH_STYLE=false
+STORAGE_SIGNED_URL_TTL_SECONDS=900
+
+# ── JWT Auth ───────────────────────────────────────
+JWT_ACCESS_SECRET=change-me-access
+JWT_REFRESH_SECRET=change-me-refresh
+JWT_ACCESS_EXPIRY=900
+JWT_REFRESH_EXPIRY=2592000
+JWT_REFRESH_REMEMBER_EXPIRY=604800
+
+# ── Session / Cookie ───────────────────────────────
+COOKIE_NAME=nexgen
+COOKIE_SECRET=change-me-cookie
+
+# ── Redis ──────────────────────────────────────────
+# Enables/disables cache, session, queue, events, BullBoard (all Redis-backed services)
+REDIS=true
+REDIS_URL=redis://127.0.0.1:6379
+REDIS_PREFIX=nexgen
+# Comma-separated emails allowed to open /bullmq (empty = no email restriction)
+BULLMQ_UI_ALLOWED_EMAILS=
+
+# ── Auth ───────────────────────────────────────────
+AUTH_REQUIRE_EMAIL_VERIFICATION=false
+
+# ── Mail ───────────────────────────────────────────
+# When true, mail errors won't crash the request. Useful in dev without SMTP
+MAIL_FAIL_SILENT=true
+MAIL_HOST=127.0.0.1
+MAIL_PORT=1089
+MAIL_USERNAME=
+MAIL_PASSWORD=
+MAIL_FROM_ADDRESS=no-reply@example.com

package/template/.env.example

@@ -0,0 +1,59 @@
+# ── App ────────────────────────────────────────────
+APP_NAME=nexgen
+APP_ENV=development
+APP_PORT=3000
+APP_URL=http://localhost:3000
+OPEN_API=true
+LOG_LEVEL=info
+# Frontend origin when frontend is on a different domain than the API.
+# Controls cross-site session cookies (SameSite=None; Secure) and Socket.IO CORS.
+# Leave empty if frontend is served from the same APP_URL or there is no separate frontend.
+FRONTEND_URL=
+# Allowed CORS origins. Use * for any, or comma-separated for specific origins
+CORS_ORIGIN=*
+
+# ── Database ───────────────────────────────────────
+# Supported: mysql://, postgres://, sqlite: prefix
+DATABASE_URL=mysql://root:change-me-root@localhost:4000/nexgen
+
+# ── Storage (File Uploads) ─────────────────────────
+STORAGE_DRIVER=local
+STORAGE_DISK=public
+STORAGE_BUCKET=
+STORAGE_REGION=us-east-1
+STORAGE_ENDPOINT=
+STORAGE_ACCESS_KEY_ID=
+STORAGE_SECRET_ACCESS_KEY=
+STORAGE_FORCE_PATH_STYLE=false
+STORAGE_SIGNED_URL_TTL_SECONDS=900
+
+# ── JWT Auth ───────────────────────────────────────
+JWT_ACCESS_SECRET=change-me-access
+JWT_REFRESH_SECRET=change-me-refresh
+JWT_ACCESS_EXPIRY=900
+JWT_REFRESH_EXPIRY=2592000
+JWT_REFRESH_REMEMBER_EXPIRY=604800
+
+# ── Session / Cookie ───────────────────────────────
+COOKIE_NAME=nexgen
+COOKIE_SECRET=change-me-cookie
+
+# ── Redis ──────────────────────────────────────────
+# Enables/disables cache, session, queue, events, BullBoard (all Redis-backed services)
+REDIS=true
+REDIS_URL=redis://127.0.0.1:6379
+REDIS_PREFIX=nexgen
+# Comma-separated emails allowed to open /bullmq (empty = no email restriction)
+BULLMQ_UI_ALLOWED_EMAILS=
+
+# ── Auth ───────────────────────────────────────────
+AUTH_REQUIRE_EMAIL_VERIFICATION=false
+
+# ── Mail ───────────────────────────────────────────
+# When true, mail errors won't crash the request. Useful in dev without SMTP
+MAIL_FAIL_SILENT=false
+MAIL_HOST=127.0.0.1
+MAIL_PORT=1089
+MAIL_USERNAME=
+MAIL_PASSWORD=
+MAIL_FROM_ADDRESS=no-reply@example.com

package/template/.prettierignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+src/resources/dist
+coverage
+package-lock.json

package/template/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "none",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "bracketSameLine": true
+}