@chimerai/cli 0.2.73

package/dist/utils.js

@@ -0,0 +1,330 @@
+"use strict";
+/**
+ * Shared CLI utilities - Validation, error handling, workspace checks, env file management
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateName = validateName;
+exports.assertValidName = assertValidName;
+exports.validateWorkspace = validateWorkspace;
+exports.handleCliError = handleCliError;
+exports.updateEnvFile = updateEnvFile;
+exports.isChimeraiProject = isChimeraiProject;
+exports.findProjectRoot = findProjectRoot;
+exports.resolveTargetDir = resolveTargetDir;
+exports.registerProject = registerProject;
+exports.setDefaultProject = setDefaultProject;
+exports.listRegisteredProjects = listRegisteredProjects;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+/* ------------------------------------------------------------------ */
+/*  Project name validation                                            */
+/* ------------------------------------------------------------------ */
+const RESERVED_NAMES = new Set([
+    'node_modules',
+    'package',
+    'dist',
+    'build',
+    'src',
+    'lib',
+    'test',
+    'tests',
+    'public',
+    'static',
+    'assets',
+    'vendor',
+    'tmp',
+    'temp',
+    '.git',
+    '.next',
+    '.env',
+    'con',
+    'prn',
+    'aux',
+    'nul', // Windows reserved
+]);
+/**
+ * Validates a project or plugin name.
+ * - lowercase alphanumeric + hyphens only
+ * - max 214 chars (npm limit)
+ * - no leading/trailing hyphens
+ * - no reserved names
+ * - no path traversal sequences
+ */
+function validateName(name, label = 'Name') {
+    if (!name || name.trim().length === 0) {
+        return { valid: false, error: `${label} cannot be empty` };
+    }
+    if (name.length > 214) {
+        return { valid: false, error: `${label} must be 214 characters or fewer` };
+    }
+    // Path traversal prevention
+    if (name.includes('..') || name.includes('/') || name.includes('\\')) {
+        return { valid: false, error: `${label} must not contain path separators or '..'` };
+    }
+    if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(name) && !/^[a-z0-9]$/.test(name)) {
+        return {
+            valid: false,
+            error: `${label} must be lowercase alphanumeric with hyphens (e.g., "my-app")`,
+        };
+    }
+    if (name.includes('--')) {
+        return { valid: false, error: `${label} must not contain consecutive hyphens` };
+    }
+    if (RESERVED_NAMES.has(name.toLowerCase())) {
+        return { valid: false, error: `"${name}" is a reserved name` };
+    }
+    return { valid: true };
+}
+/**
+ * Validates and exits on failure. For use in Commander actions.
+ */
+function assertValidName(name, label = 'Name') {
+    const result = validateName(name, label);
+    if (!result.valid) {
+        handleCliError(result.error);
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  Workspace validation                                               */
+/* ------------------------------------------------------------------ */
+/**
+ * Checks that targetDir is a valid ChimerAI project directory.
+ * Verifies package.json exists.
+ */
+function validateWorkspace(targetDir) {
+    if (!fs_extra_1.default.existsSync(targetDir)) {
+        console.log(chalk_1.default.red(`❌ Directory does not exist: ${targetDir}`));
+        return false;
+    }
+    const pkgPath = path_1.default.join(targetDir, 'package.json');
+    if (!fs_extra_1.default.existsSync(pkgPath)) {
+        console.log(chalk_1.default.red(`❌ Not a valid project directory (no package.json): ${targetDir}`));
+        console.log(chalk_1.default.gray('  Run: chimerai create <project-name>'));
+        return false;
+    }
+    return true;
+}
+/* ------------------------------------------------------------------ */
+/*  Standardized error handling                                        */
+/* ------------------------------------------------------------------ */
+/**
+ * Standard CLI error handler — prints message and exits with code.
+ */
+function handleCliError(message, code = 1) {
+    console.error(chalk_1.default.red(`\n❌ ${message}\n`));
+    process.exit(code);
+}
+/* ------------------------------------------------------------------ */
+/*  Environment file utilities                                         */
+/* ------------------------------------------------------------------ */
+/**
+ * Generic environment file updater utility (PHASE 2.2 / PHASE 4)
+ * Shared across setup.ts and other commands that need to update .env files.
+ * Replaces repetitive fs read/write patterns.
+ *
+ * @param envVars - Object with key-value pairs to add/update
+ * @param envPath - Path to .env file (default: '.env')
+ */
+async function updateEnvFile(envVars, envPath = '.env') {
+    let envContent = fs_extra_1.default.existsSync(envPath) ? fs_extra_1.default.readFileSync(envPath, 'utf-8') : '';
+    for (const [key, value] of Object.entries(envVars)) {
+        if (envContent.includes(`${key}=`)) {
+            // Replace existing variable
+            envContent = envContent.replace(new RegExp(`${key}=.*$`, 'm'), `${key}="${value}"`);
+        }
+        else {
+            // Add new variable
+            envContent += `\n${key}="${value}"`;
+        }
+    }
+    fs_extra_1.default.writeFileSync(envPath, envContent.trim() + '\n');
+}
+const REGISTRY_DIR = path_1.default.join(os_1.default.homedir(), '.chimerai');
+const REGISTRY_PATH = path_1.default.join(REGISTRY_DIR, 'projects.json');
+/**
+ * Walks up directory tree looking for project markers.
+ * Priority: .chimerai file > package.json + Next.js/Prisma markers
+ */
+function walkUpForProjectRoot(startDir) {
+    let current = path_1.default.resolve(startDir);
+    const start = current;
+    const visited = new Set();
+    while (true) {
+        // Prevent infinite loops
+        if (visited.has(current))
+            return null;
+        visited.add(current);
+        // Primary: .chimerai marker (must be a file, not the ~/.chimerai registry directory)
+        const chimeraiMarker = path_1.default.join(current, '.chimerai');
+        if (fs_extra_1.default.existsSync(chimeraiMarker) && fs_extra_1.default.statSync(chimeraiMarker).isFile()) {
+            return current;
+        }
+        // Secondary: package.json + Next.js/Prisma markers
+        if (fs_extra_1.default.existsSync(path_1.default.join(current, 'package.json'))) {
+            const hasNextConfig = fs_extra_1.default.existsSync(path_1.default.join(current, 'next.config.js')) ||
+                fs_extra_1.default.existsSync(path_1.default.join(current, 'next.config.mjs')) ||
+                fs_extra_1.default.existsSync(path_1.default.join(current, 'next.config.ts'));
+            const hasPrisma = fs_extra_1.default.existsSync(path_1.default.join(current, 'prisma'));
+            if (hasNextConfig || hasPrisma) {
+                return current;
+            }
+        }
+        // Move up one level
+        const parent = path_1.default.dirname(current);
+        if (parent === current) {
+            // Reached filesystem root
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * Checks if a directory is a valid ChimerAI project.
+ */
+function isChimeraiProject(dir) {
+    if (!fs_extra_1.default.existsSync(dir))
+        return false;
+    const marker = path_1.default.join(dir, '.chimerai');
+    if (fs_extra_1.default.existsSync(marker) && fs_extra_1.default.statSync(marker).isFile())
+        return true;
+    if (!fs_extra_1.default.existsSync(path_1.default.join(dir, 'package.json')))
+        return false;
+    const hasNextConfig = fs_extra_1.default.existsSync(path_1.default.join(dir, 'next.config.js')) ||
+        fs_extra_1.default.existsSync(path_1.default.join(dir, 'next.config.mjs')) ||
+        fs_extra_1.default.existsSync(path_1.default.join(dir, 'next.config.ts'));
+    const hasPrisma = fs_extra_1.default.existsSync(path_1.default.join(dir, 'prisma'));
+    return hasNextConfig || hasPrisma;
+}
+/**
+ * Reads the global project registry from ~/.chimerai/projects.json
+ */
+function getDefaultProjectFromRegistry() {
+    if (!fs_extra_1.default.existsSync(REGISTRY_PATH))
+        return null;
+    try {
+        const registry = JSON.parse(fs_extra_1.default.readFileSync(REGISTRY_PATH, 'utf-8'));
+        const defaultName = registry.default;
+        if (defaultName && registry.projects && registry.projects[defaultName]) {
+            return registry.projects[defaultName];
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Finds the ChimerAI project root directory.
+ *
+ * Search order (first match wins):
+ * 1. Directory tree walking (.chimerai marker or package.json + Next.js/Prisma)
+ * 2. CHIMERAI_PROJECT environment variable
+ * 3. Global registry default (~/.chimerai/projects.json)
+ * 4. Error with helpful guidance
+ */
+function findProjectRoot(startDir) {
+    const cwd = startDir || process.cwd();
+    // Step 1: Walk up directory tree
+    const fromTree = walkUpForProjectRoot(cwd);
+    if (fromTree)
+        return fromTree;
+    // Step 2: Environment variable
+    const envDir = process.env.CHIMERAI_PROJECT;
+    if (envDir) {
+        const resolved = path_1.default.resolve(envDir);
+        if (isChimeraiProject(resolved))
+            return resolved;
+        console.log(chalk_1.default.yellow(`⚠️  CHIMERAI_PROJECT points to "${resolved}", but no project found there.`));
+    }
+    // Step 3: Global registry
+    const fromRegistry = getDefaultProjectFromRegistry();
+    if (fromRegistry && isChimeraiProject(fromRegistry))
+        return fromRegistry;
+    // Step 4: Error
+    console.log(chalk_1.default.red(`\n❌ No ChimerAI project found.\n`));
+    console.log(chalk_1.default.white(`Options:`));
+    console.log(chalk_1.default.gray(`  1. Navigate to a project folder:      cd my-project`));
+    console.log(chalk_1.default.gray(`  2. Specify the directory explicitly:   chimerai <command> --dir /path/to/project`));
+    console.log(chalk_1.default.gray(`  3. Set an environment variable:        export CHIMERAI_PROJECT=/path/to/project`));
+    console.log(chalk_1.default.gray(`  4. Create a new project:               chimerai create my-project\n`));
+    process.exit(1);
+}
+/**
+ * Resolves the target directory for a command.
+ *
+ * Priority:
+ * 1. --dir explicitly provided (not '.')
+ * 2. Automatic search via findProjectRoot()
+ */
+function resolveTargetDir(dirOption) {
+    // If --dir was explicitly set (not the default '.')
+    if (dirOption !== '.') {
+        const explicit = path_1.default.resolve(dirOption);
+        if (!fs_extra_1.default.existsSync(explicit)) {
+            console.log(chalk_1.default.red(`❌ Directory does not exist: ${explicit}`));
+            process.exit(1);
+        }
+        return explicit;
+    }
+    // Automatic search
+    return findProjectRoot();
+}
+/**
+ * Registers a project in the global registry.
+ * Called by create and init commands.
+ */
+function registerProject(name, absolutePath) {
+    fs_extra_1.default.ensureDirSync(REGISTRY_DIR);
+    let registry = { projects: {}, default: null };
+    if (fs_extra_1.default.existsSync(REGISTRY_PATH)) {
+        try {
+            registry = JSON.parse(fs_extra_1.default.readFileSync(REGISTRY_PATH, 'utf-8'));
+        }
+        catch {
+            // Corrupted file — recreate
+        }
+    }
+    registry.projects[name] = absolutePath;
+    // First registered project becomes default
+    if (!registry.default) {
+        registry.default = name;
+    }
+    fs_extra_1.default.writeFileSync(REGISTRY_PATH, JSON.stringify(registry, null, 2));
+}
+/**
+ * Sets the default project in the global registry.
+ */
+function setDefaultProject(name) {
+    if (!fs_extra_1.default.existsSync(REGISTRY_PATH))
+        return false;
+    try {
+        const registry = JSON.parse(fs_extra_1.default.readFileSync(REGISTRY_PATH, 'utf-8'));
+        if (!registry.projects[name])
+            return false;
+        registry.default = name;
+        fs_extra_1.default.writeFileSync(REGISTRY_PATH, JSON.stringify(registry, null, 2));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Lists all registered projects.
+ */
+function listRegisteredProjects() {
+    if (!fs_extra_1.default.existsSync(REGISTRY_PATH)) {
+        return { projects: {}, default: null };
+    }
+    try {
+        return JSON.parse(fs_extra_1.default.readFileSync(REGISTRY_PATH, 'utf-8'));
+    }
+    catch {
+        return { projects: {}, default: null };
+    }
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@chimerai/cli",
+  "version": "0.2.73",
+  "description": "CLI wizard for ChimerAI starter kit — scaffold auth, RBAC, AI chat, billing and more into any Next.js project",
+  "main": "./dist/index.js",
+  "bin": {
+    "chimerai": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/armbur19-collab/chimerai-kickstart.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://chimerai.dev",
+  "bugs": {
+    "url": "https://github.com/armbur19-collab/chimerai-kickstart/issues"
+  },
+  "scripts": {
+    "build": "node -e \"const f='package.json',p=JSON.parse(require('fs').readFileSync(f));p.version=p.version.replace(/\\d+$/,n=>+n+1);require('fs').writeFileSync(f,JSON.stringify(p,null,2)+'\\n');console.log('v'+p.version)\" && tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "execa": "^8.0.1",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.12",
+    "jose": "^6.2.2",
+    "ora": "^7.0.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.10.6",
+    "@vitest/coverage-v8": "^1.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.0.0"
+  },
+  "keywords": [
+    "cli",
+    "wizard",
+    "rbac",
+    "starter-kit",
+    "chimerai"
+  ],
+  "author": "ChimerAI",
+  "license": "MIT"
+}