create-epinoetics-app 1.0.0 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-epinoetics-app",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Scaffold a new project from your boilerplate repos",
   "type": "module",
   "bin": {

package/src/cloner.js

@@ -4,11 +4,11 @@ import { resolve, join } from 'path';
 import { simpleGit } from 'simple-git';
 import fs from 'fs';
 
+// ── Clone all plain repos (dashboard, dotnet, frontend) ───────────
 export async function cloneAll({ projectName, repos }) {
   const projectDir = resolve(process.cwd(), projectName);
   const codeDir    = join(projectDir, 'code');
 
-  // Create root + code/ dirs
   fs.mkdirSync(codeDir, { recursive: true });
 
   for (const repo of repos) {
@@ -19,11 +19,7 @@ export async function cloneAll({ projectName, repos }) {
 
     try {
       await simpleGit().clone(repo.url, dest, ['--depth=1']);
-
-      // Remove the .git folder so the clone becomes plain source,
-      // not a nested git repo inside the new project.
       fs.rmSync(join(dest, '.git'), { recursive: true, force: true });
-
       spinner.stop(`${chalk.green('✓')} ${repo.label}  ${chalk.dim(`→ code/${repo.id}`)}`);
     } catch (err) {
       spinner.stop(`${chalk.red('✗')} ${repo.label}  ${chalk.dim(err.message)}`);
@@ -31,3 +27,83 @@ export async function cloneAll({ projectName, repos }) {
     }
   }
 }
+
+// ── Clone NestJS db branch, then prune unselected features ────────
+export async function cloneAndMergeNest({ projectName, database, selectedFeatures, allFeatures, repoUrl }) {
+  const projectDir = resolve(process.cwd(), projectName);
+  const dest       = join(projectDir, 'code', 'api-nest');
+
+  fs.mkdirSync(dest, { recursive: true });
+
+  // 1. Clone the chosen db branch directly
+  const spinner = p.spinner();
+  spinner.start(`Cloning ${chalk.cyan('NestJS')}  ${chalk.dim(`branch: ${database.branch}`)}`);
+
+  try {
+    await simpleGit().clone(repoUrl, dest, ['--branch', database.branch, '--single-branch']);
+    spinner.stop(`${chalk.green('✓')} NestJS  ${chalk.dim(`→ code/api-nest  (${database.branch})`)}`);
+  } catch (err) {
+    spinner.stop(`${chalk.red('✗')} NestJS  ${chalk.dim(err.message)}`);
+    throw new Error(`Failed to clone NestJS repo: ${err.message}`);
+  }
+
+  // 2. Remove unselected feature folders from src/features/
+  const selectedIds = new Set(selectedFeatures.map(f => f.id));
+  const toRemove    = allFeatures.filter(f => !selectedIds.has(f.id));
+
+  for (const feature of toRemove) {
+    const featureDir = join(dest, 'src', 'features', feature.id);
+    if (fs.existsSync(featureDir)) {
+      fs.rmSync(featureDir, { recursive: true, force: true });
+    }
+  }
+
+  if (toRemove.length > 0) {
+    p.log.step(
+      `Removed unselected features: ${toRemove.map(f => chalk.dim(f.id)).join(', ')}`
+    );
+  }
+
+  // 3. Prune schema.ts — remove export lines for deleted features
+  await pruneSchema({ dest, toRemove });
+
+  // 4. Strip .git
+  fs.rmSync(join(dest, '.git'), { recursive: true, force: true });
+}
+
+// ── Remove export * lines from schema.ts for deleted features ─────
+async function pruneSchema({ dest, toRemove }) {
+  if (toRemove.length === 0) return;
+
+  // Check common schema.ts locations
+  const candidates = [
+    join(dest, 'src', 'database', 'schema.ts'),
+    join(dest, 'src', 'db', 'schema.ts'),
+    join(dest, 'src', 'schema.ts'),
+  ];
+
+  const schemaPath = candidates.find(f => fs.existsSync(f));
+  if (!schemaPath) {
+    p.log.warn('Could not find schema.ts — remove unused exports manually.');
+    return;
+  }
+
+  let content  = fs.readFileSync(schemaPath, 'utf8');
+  const before = content;
+
+  for (const feature of toRemove) {
+    // Matches lines like:
+    //   export * from '../features/posts/post.schema';
+    //   export * from "../features/seo/seo.schema";
+    const pattern = new RegExp(
+      `^export \\* from ['"].*features\\/${feature.id}\\/.*['"];?\\n?`,
+      'gm'
+    );
+    content = content.replace(pattern, '');
+  }
+
+  if (content !== before) {
+    fs.writeFileSync(schemaPath, content, 'utf8');
+    p.log.step(`Pruned schema.ts  ${chalk.dim(`(removed ${toRemove.length} export line(s))`)}`);
+  }
+}

package/src/index.js

@@ -1,14 +1,14 @@
 import * as p from '@clack/prompts';
 import chalk from 'chalk';
-import { REPOS } from './repos.js';
-import { cloneAll } from './cloner.js';
+import { REPOS, NEST_DATABASES, NEST_FEATURES } from './repos.js';
+import { cloneAll, cloneAndMergeNest } from './cloner.js';
 import { writeRootFiles } from './scaffold.js';
 import { validateProjectName } from './utils.js';
 
 export async function run(flags) {
   console.log('');
   p.intro(
-    chalk.bgHex('#7c3aed').white(' create-myapp ') +
+    chalk.bgHex('#7c3aed').white(' create-epinoetics-app ') +
     chalk.dim(' assemble your boilerplate')
   );
 
@@ -37,7 +37,38 @@ export async function run(flags) {
     if (p.isCancel(backendId)) return cancel();
   }
 
-  // ── 3. Frontend (only shown if repos are registered) ─────────────
+  // ── 3. NestJS-specific prompts ────────────────────────────────────
+  let database = null;
+  let features = [];
+
+  if (backendId === 'api-nest') {
+    // Database
+    const dbId = await p.select({
+      message: 'Database',
+      options: NEST_DATABASES.map(d => ({
+        value: d.id,
+        label: d.label,
+        hint:  d.hint,
+      })),
+    });
+    if (p.isCancel(dbId)) return cancel();
+    database = NEST_DATABASES.find(d => d.id === dbId);
+
+    // Features
+    const featureIds = await p.multiselect({
+      message: 'Features  (space to select, enter to confirm)',
+      options: NEST_FEATURES.map(f => ({
+        value: f.id,
+        label: f.label,
+        hint:  f.hint,
+      })),
+      required: false,
+    });
+    if (p.isCancel(featureIds)) return cancel();
+    features = NEST_FEATURES.filter(f => featureIds.includes(f.id));
+  }
+
+  // ── 4. Frontend (only shown if repos are registered) ─────────────
   let frontendId = flags.frontend ?? null;
   if (REPOS.frontend?.length > 0 && !frontendId) {
     frontendId = await p.select({
@@ -51,16 +82,24 @@ export async function run(flags) {
     if (p.isCancel(frontendId)) return cancel();
   }
 
-  // ── Build the final list of repos to clone ────────────────────────
-  const selected = buildRepoList({ backendId, frontendId });
+  // ── Build list of plain repos to clone ───────────────────────────
+  const plainRepos = buildPlainRepos({ backendId, frontendId });
 
   // ── Summary ───────────────────────────────────────────────────────
   console.log('');
+
+  const nestLines = backendId === 'api-nest' ? [
+    `${chalk.dim('database'.padEnd(16))}  ${chalk.cyan(database.label)}`,
+    `${chalk.dim('features'.padEnd(16))}  ${features.length ? features.map(f => chalk.cyan(f.label)).join(chalk.dim(', ')) : chalk.dim('none')}`,
+  ] : [];
+
+  const repoLines = plainRepos.map(r =>
+    `${chalk.dim(r.id.padEnd(16))}  ${chalk.cyan(r.label)}  ${chalk.dim(r.url)}`
+  );
+
   p.note(
-    selected
-      .map(r => `${chalk.dim(r.id.padEnd(16))} ${chalk.cyan(r.label)}  ${chalk.dim(r.url)}`)
-      .join('\n'),
-    'Repos to clone'
+    [...nestLines, ...repoLines].join('\n'),
+    'Scaffold summary'
   );
 
   if (flags.dryRun) {
@@ -73,34 +112,49 @@ export async function run(flags) {
     if (p.isCancel(confirm) || !confirm) return cancel();
   }
 
-  // ── Clone ─────────────────────────────────────────────────────────
-  await cloneAll({ projectName, repos: selected });
+  // ── Clone NestJS db branch + prune unselected features ───────────
+  if (backendId === 'api-nest') {
+    const nestRepo = REPOS.backend.find(r => r.id === 'api-nest');
+    await cloneAndMergeNest({
+      projectName,
+      database,
+      selectedFeatures: features,
+      allFeatures:      NEST_FEATURES,
+      repoUrl:          nestRepo.url,
+    });
+  }
+
+  // ── Clone plain repos (dashboard, dotnet, frontend) ───────────────
+  if (plainRepos.length > 0) {
+    await cloneAll({ projectName, repos: plainRepos });
+  }
 
-  // ── Write root files (.gitignore, README) ─────────────────────────
-  await writeRootFiles({ projectName, selected, backendId, frontendId });
+  // ── Write root files ──────────────────────────────────────────────
+  await writeRootFiles({ projectName, plainRepos, backendId, database, features, frontendId });
 
-  // ── Done ──────────────────────────────────────────────────────────
   p.outro(
     chalk.green('Done!') + '\n\n' +
     `  ${chalk.dim('cd')} ${chalk.cyan(projectName)}`
   );
 }
 
-function buildRepoList({ backendId, frontendId }) {
+function buildPlainRepos({ backendId, frontendId }) {
   const list = [];
 
-  // Fixed repos (dashboard — always included)
+  // Dashboard — always included
   for (const group of Object.values(REPOS)) {
     for (const repo of group) {
       if (repo.fixed) list.push(repo);
     }
   }
 
-  // Chosen backend
-  const backend = REPOS.backend.find(r => r.id === backendId);
-  if (backend) list.push(backend);
+  // .NET (NestJS is handled separately)
+  if (backendId === 'api-dotnet') {
+    const dotnet = REPOS.backend.find(r => r.id === 'api-dotnet');
+    if (dotnet) list.push(dotnet);
+  }
 
-  // Chosen frontend (optional until repos are added)
+  // Frontend
   if (frontendId && REPOS.frontend) {
     const frontend = REPOS.frontend.find(r => r.id === frontendId);
     if (frontend) list.push(frontend);
@@ -112,4 +166,4 @@ function buildRepoList({ backendId, frontendId }) {
 function cancel() {
   p.cancel('Cancelled.');
   process.exit(0);
-}
+}

package/src/repos.js

@@ -1,17 +1,17 @@
 /**
  * Registry of all available boilerplate repos.
  *
- * To add a new repo (e.g. Astro or Next.js frontend):
- *   1. Add an entry to the relevant group below.
- *   2. That's it — the CLI picks it up automatically.
+ * NestJS repo branch convention:
+ *   master       — base helpers (filters, guards, interceptors, config)
+ *   db/drizzle   — Drizzle + Turso, includes src/features/* (all optional features)
+ *   db/prisma    — Prisma + PostgreSQL, includes src/features/* (all optional features)
  *
- * Fields:
- *   id       — internal key, used as the folder name under code/
- *   label    — shown in the prompt
- *   hint     — shown as a subtitle in the prompt
- *   url      — GitHub clone URL
- *   fixed    — if true, always included (no prompt)
+ * To add a new feature:  add a folder to src/features/ in the db branches,
+ *                        add an export line in schema.ts, then add an entry to NEST_FEATURES.
+ * To add a new database: add a branch and an entry to NEST_DATABASES.
+ * To add a frontend:     uncomment and fill in the frontend block below.
  */
+
 export const REPOS = {
 
   // ── Backend (pick one) ────────────────────────────────────────────
@@ -20,7 +20,7 @@ export const REPOS = {
       id:    'api-nest',
       label: 'NestJS',
       hint:  'TypeScript, REST/GraphQL, modular architecture',
-      url:   'https://github.com/tyndareosmasselos/Boilerplater.NestJS',
+      url:   'https://github.com/tyndareosmasselos/boilerplate-nestjs',
     },
     {
       id:    'api-dotnet',
@@ -42,8 +42,6 @@ export const REPOS = {
   ],
 
   // ── Frontend (pick one) ───────────────────────────────────────────
-  // Add Next.js and Astro repos here when ready:
-  //
   // frontend: [
   //   {
   //     id:    'web-next',
@@ -60,3 +58,27 @@ export const REPOS = {
   // ],
 
 };
+
+// ── NestJS-specific config ─────────────────────────────────────────
+
+export const NEST_DATABASES = [
+  {
+    id:     'drizzle',
+    label:  'Drizzle + Turso',
+    hint:   'Lightweight, edge-friendly, LibSQL',
+    branch: 'db/drizzle',
+  },
+  {
+    id:     'prisma',
+    label:  'Prisma + PostgreSQL',
+    hint:   'SQL, migrations, Prisma Studio',
+    branch: 'db/prisma',
+  },
+];
+
+export const NEST_FEATURES = [
+  { id: 'posts', label: 'Blog / Posts', hint: 'Posts, slugs, publishing workflow' },
+  { id: 'seo',   label: 'SEO',          hint: 'Sitemap, robots, meta tags'        },
+  // { id: 'auth', label: 'Auth',   hint: 'JWT + refresh tokens'           },
+  // { id: 'mail', label: 'Mailer', hint: 'Resend / Nodemailer integration' },
+];

package/src/scaffold.js

@@ -1,7 +1,7 @@
 import { join, resolve } from 'path';
 import fs from 'fs';
 
-export async function writeRootFiles({ projectName, selected, backendId, frontendId }) {
+export async function writeRootFiles({ projectName, plainRepos = [], backendId, database, features = [], frontendId }) {
   const projectDir = resolve(process.cwd(), projectName);
 
   // ── .gitignore ────────────────────────────────────────────────────
@@ -22,48 +22,53 @@ export async function writeRootFiles({ projectName, selected, backendId, fronten
   fs.writeFileSync(join(projectDir, '.gitignore'), gitignore, 'utf8');
 
   // ── README.md ─────────────────────────────────────────────────────
-  const repoLines = selected
-    .map(r => `| \`code/${r.id}\` | ${r.label} | ${r.url} |`)
-    .join('\n');
+  const nestSection = backendId === 'api-nest' ? `
+## NestJS backend
 
-  const hasFrontend = !!frontendId;
+- **Database**: ${database.label}
+- **Features**: ${features.length ? features.map(f => f.label).join(', ') : 'none'}
 
-  const readme = `# ${projectName}
+\`\`\`bash
+cd code/api-nest
+# follow README inside
+\`\`\`
+` : '';
 
-> Scaffolded with \`create-myapp\`
+  const repoLines = plainRepos.map(r =>
+    `| \`code/${r.id}\` | ${r.label} | ${r.url} |`
+  ).join('\n');
 
-## Structure
-
-\`\`\`
-${projectName}/
-└── code/
-${selected.map(r => `    ├── ${r.id}/`).join('\n')}
-\`\`\`
+  const structureLines = [
+    backendId === 'api-nest'   ? '    ├── api-nest/       ← NestJS' : null,
+    backendId === 'api-dotnet' ? '    ├── api-dotnet/     ← .NET Microservices' : null,
+    '    ├── dashboard/      ← Angular admin panel',
+    frontendId ? `    ├── ${frontendId}/` : null,
+  ].filter(Boolean).join('\n');
 
+  const repoTableSection = plainRepos.length > 0 ? `
 ## Repos
 
 | Folder | Name | Source |
 |--------|------|--------|
 ${repoLines}
+` : '';
 
-## Getting started
+  const readme = `# ${projectName}
 
-Each piece is self-contained. Navigate into a folder and follow its own README:
+> Scaffolded with \`create-epinoetics-app\`
 
-\`\`\`bash
-# Backend
-cd code/${backendId}
-# follow README inside
+## Structure
 
-# Dashboard
-cd code/dashboard
-# follow README inside
-${hasFrontend ? `
-# Frontend
-cd code/${frontendId}
-# follow README inside` : ''}
 \`\`\`
+${projectName}/
+└── code/
+${structureLines}
+\`\`\`
+${nestSection}${repoTableSection}
+## Getting started
+
+Each piece is self-contained — navigate into a folder and follow its own README.
 `;
 
   fs.writeFileSync(join(projectDir, 'README.md'), readme, 'utf8');
-}
+}