create-theta-code 1.0.1

package/bin/create.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+// bin/create.js — Entry point for create-theta-code CLI. Routes to runCLI orchestrator only.
+
+import { runCLI } from '../src/cli.js';
+
+runCLI(process.argv.slice(2)).catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "create-theta-code",
+  "version": "1.0.1",
+  "description": "Production-grade Node.js + Express scaffolding CLI",
+  "type": "module",
+  "main": "src/cli.js",
+  "bin": {
+    "create-theta-code": "bin/create.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates"
+  ],
+  "scripts": {
+    "dev": "node bin/create.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "scaffolding",
+    "cli",
+    "nodejs",
+    "express",
+    "boilerplate"
+  ],
+  "author": "Theta Labs",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/cli.js

@@ -0,0 +1,21 @@
+// src/cli.js — CLI orchestrator. Collects prompts, calls scaffoldProject, manages flow.
+
+import { printBanner, printSuccess } from './utils/logger.js';
+import { getProjectName } from './prompts/getProjectName.js';
+import { getTemplateChoice } from './prompts/getTemplateChoice.js';
+import { scaffoldProject } from './generators/scaffoldProject.js';
+import { resolve } from 'node:path';
+
+async function runCLI(argv) {
+  printBanner();
+
+  const projectName = await getProjectName(argv);
+  const templateType = await getTemplateChoice();
+
+  const currentDir = process.cwd();
+  const projectPath = await scaffoldProject(projectName, templateType, currentDir);
+
+  printSuccess(projectName, templateType, projectPath);
+}
+
+export { runCLI };

package/src/generators/scaffoldProject.js

@@ -0,0 +1,46 @@
+// src/generators/scaffoldProject.js — Copies template, injects project name, renames hidden files.
+
+import { cp, readFile, writeFile, rename } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+async function scaffoldProject(projectName, templateType, targetDir) {
+  const templatePath = join(__dirname, '..', '..', 'templates', templateType);
+  const projectPath = join(targetDir, projectName);
+
+  // Copy entire template directory
+  await cp(templatePath, projectPath, { recursive: true });
+
+  // Rename _gitignore to .gitignore
+  const gitignorePath = join(projectPath, '_gitignore');
+  const realGitignorePath = join(projectPath, '.gitignore');
+  try {
+    await rename(gitignorePath, realGitignorePath);
+  } catch (err) {
+    // File might not exist, continue
+  }
+
+  // Rename _env.example to .env.example
+  const envExamplePath = join(projectPath, '_env.example');
+  const realEnvExamplePath = join(projectPath, '.env.example');
+  try {
+    await rename(envExamplePath, realEnvExamplePath);
+  } catch (err) {
+    // File might not exist, continue
+  }
+
+  // Update package.json with project name
+  const packageJsonPath = join(projectPath, 'package.json');
+  const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf-8'));
+  packageJson.name = projectName;
+  packageJson.description = `${projectName} - Production-grade Node.js API built with create-theta-code`;
+  await writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
+
+  return projectPath;
+}
+
+export { scaffoldProject };

package/src/prompts/getProjectName.js

@@ -0,0 +1,30 @@
+// src/prompts/getProjectName.js — Reads project name from argv[0] or prompts interactively.
+
+import { text } from '@clack/prompts';
+import { isCancel } from '@clack/prompts';
+
+async function getProjectName(argv) {
+  if (argv.length > 0 && argv[0].trim()) {
+    return argv[0].trim();
+  }
+
+  const name = await text({
+    message: 'Enter project name:',
+    placeholder: 'theta-code-app',
+    validate: (input) => {
+      if (!input.trim()) return 'Project name is required';
+      if (!/^[a-z0-9-]+$/.test(input.trim())) {
+        return 'Project name must contain only lowercase letters, numbers, and hyphens';
+      }
+      return;
+    },
+  });
+
+  if (isCancel(name)) {
+    process.exit(0);
+  }
+
+  return name;
+}
+
+export { getProjectName };

package/src/prompts/getTemplateChoice.js

@@ -0,0 +1,39 @@
+// src/prompts/getTemplateChoice.js — Prompts user to choose DB and language. Returns template type.
+
+import { select } from '@clack/prompts';
+import { isCancel } from '@clack/prompts';
+
+async function getTemplateChoice() {
+  const dbChoice = await select({
+    message: 'Choose database:',
+    options: [
+      { value: 'mongo', label: 'MongoDB + Mongoose' },
+      { value: 'pg', label: 'PostgreSQL + Prisma' },
+    ],
+  });
+
+  if (isCancel(dbChoice)) {
+    process.exit(0);
+  }
+
+  const langChoice = await select({
+    message: 'Choose language:',
+    options: [
+      { value: 'js', label: 'JavaScript' },
+      { value: 'ts', label: 'TypeScript (coming soon)' },
+    ],
+  });
+
+  if (isCancel(langChoice)) {
+    process.exit(0);
+  }
+
+  if (langChoice === 'ts') {
+    console.log('TypeScript templates coming soon! Defaulting to JavaScript.');
+    return `${dbChoice}-js`;
+  }
+
+  return `${dbChoice}-${langChoice}`;
+}
+
+export { getTemplateChoice };

package/src/utils/logger.js

@@ -0,0 +1,29 @@
+// src/utils/logger.js — Display banner and success messages only. No logging infrastructure.
+
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+function printBanner() {
+  console.log('\n╔════════════════════════════════════════╗');
+  console.log('║  🚀 create-theta-code                   ║');
+  console.log('║  Production-Grade Node.js Scaffolding   ║');
+  console.log('╚════════════════════════════════════════╝\n');
+}
+
+function printSuccess(projectName, templateType, projectPath) {
+  console.log('\n✅ Project created successfully!\n');
+  console.log(`📁 Name: ${projectName}`);
+  console.log(`🛠️  Template: ${templateType}`);
+  console.log(`📂 Path: ${projectPath}\n`);
+  console.log('Next steps:');
+  console.log(`  1. cd ${projectName}`);
+  console.log('  2. npm install');
+  console.log('  3. cp .env.example .env');
+  console.log('  4. Fill .env with your configuration');
+  console.log('  5. npm start\n');
+}
+
+export { printBanner, printSuccess };

package/templates/mongo-js/.env

@@ -0,0 +1,12 @@
+NODE_ENV=test
+MONGODB_URI=mongodb://localhost:27017/test
+JWT_SECRET=this_is_a_test_secret_that_is_long_enough
+JWT_REFRESH_SECRET=this_is_a_test_refresh_secret_long_enough
+JWT_EXPIRES_IN=7d
+JWT_REFRESH_EXPIRES_IN=30d
+BCRYPT_SALT_ROUNDS=12
+RATE_LIMIT_WINDOW_MS=900000
+RATE_LIMIT_MAX=100
+AUTH_RATE_LIMIT_MAX=10
+CORS_ORIGIN=http://localhost:3000
+LOG_LEVEL=debug

package/templates/mongo-js/.env.example

@@ -0,0 +1,13 @@
+NODE_ENV=development
+PORT=3000
+MONGODB_URI=
+JWT_SECRET=
+JWT_REFRESH_SECRET=
+JWT_EXPIRES_IN=7d
+JWT_REFRESH_EXPIRES_IN=30d
+BCRYPT_SALT_ROUNDS=12
+RATE_LIMIT_WINDOW_MS=900000
+RATE_LIMIT_MAX=100
+AUTH_RATE_LIMIT_MAX=10
+CORS_ORIGIN=http://localhost:3000
+LOG_LEVEL=info

package/templates/mongo-js/.eslintrc.json

@@ -0,0 +1,24 @@
+{
+  "extends": ["eslint:recommended"],
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module"
+  },
+  "rules": {
+    "no-console": "off",
+    "no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "prefer-const": "error",
+    "no-var": "error",
+    "eqeqeq": ["error", "always"],
+    "curly": "error",
+    "brace-style": ["error", "1tbs"],
+    "quotes": ["error", "single", { "avoidEscape": true }],
+    "semi": ["error", "always"],
+    "comma-dangle": ["error", "always-multiline"],
+    "indent": ["error", 2]
+  }
+}

package/templates/mongo-js/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always"
+}