stackkit 0.1.3 → 0.1.5

package/dist/cli/create.js

@@ -18,6 +18,7 @@ const framework_utils_1 = require("../lib/framework/framework-utils");
 const module_discovery_1 = require("../lib/discovery/module-discovery");
 const code_generator_1 = require("../lib/generation/code-generator");
 const package_root_1 = require("../lib/utils/package-root");
+const env_editor_1 = require("../lib/env/env-editor");
 async function createProject(projectName, options) {
     logger_1.logger.newLine();
     logger_1.logger.log(chalk_1.default.bold.cyan("📦 Create StackKit App"));
@@ -30,18 +31,19 @@ async function createProject(projectName, options) {
         process.exit(1);
     }
     await generateProject(config, targetDir, options);
+    await processGeneratorEnvVars(config, targetDir);
     showNextSteps(config);
 }
 async function getProjectConfig(projectName, options) {
-    const modulesDir = path_1.default.join((0, package_root_1.getPackageRoot)(), 'modules');
+    const modulesDir = path_1.default.join((0, package_root_1.getPackageRoot)(), "modules");
     const discoveredModules = await (0, module_discovery_1.discoverModules)(modulesDir);
     const argv = process.argv.slice(2);
-    const createIndex = argv.indexOf('create');
+    const createIndex = argv.indexOf("create");
     const argsAfterCreate = createIndex >= 0 ? argv.slice(createIndex + 1) : [];
-    const flagsProvided = argsAfterCreate.some(arg => arg.startsWith('-'));
+    const flagsProvided = argsAfterCreate.some((arg) => arg.startsWith("-"));
     const optionsProvided = flagsProvided || !!(options && (options.yes || options.y));
     if (optionsProvided) {
-        if ((options && (options.yes || options.y))) {
+        if (options && (options.yes || options.y) && !flagsProvided) {
             return {
                 projectName: projectName || "my-app",
                 framework: "nextjs",
@@ -54,37 +56,37 @@ async function getProjectConfig(projectName, options) {
         }
         const framework = (options && (options.framework || options.f)) || undefined;
         if (discoveredModules.frameworks && discoveredModules.frameworks.length > 0) {
-            const validFrameworks = discoveredModules.frameworks.map(f => f.name);
+            const validFrameworks = discoveredModules.frameworks.map((f) => f.name);
             if (framework && !validFrameworks.includes(framework)) {
-                throw new Error(`Invalid framework: ${framework}. Valid options: ${validFrameworks.join(', ')}`);
+                throw new Error(`Invalid framework: ${framework}. Valid options: ${validFrameworks.join(", ")}`);
             }
         }
         const db = (options && (options.database || options.d)) || undefined;
         let allValidDatabases = [];
         if (discoveredModules.databases && discoveredModules.databases.length > 0) {
             const validDatabases = (0, module_discovery_1.getValidDatabaseOptions)(discoveredModules.databases);
-            const validBaseDatabases = discoveredModules.databases.map(db => db.name);
+            const validBaseDatabases = discoveredModules.databases.map((db) => db.name);
             allValidDatabases = [...validDatabases, ...validBaseDatabases];
             if (db && !allValidDatabases.includes(db)) {
-                throw new Error(`Invalid database: ${db}. Valid options: ${allValidDatabases.filter((v, i, arr) => arr.indexOf(v) === i).join(', ')}`);
+                throw new Error(`Invalid database: ${db}. Valid options: ${allValidDatabases.filter((v, i, arr) => arr.indexOf(v) === i).join(", ")}`);
             }
         }
         const authOpt = (options && (options.auth || options.a)) || undefined;
         if (discoveredModules.auth && discoveredModules.auth.length > 0) {
             const validAuth = (0, module_discovery_1.getValidAuthOptions)(discoveredModules.auth);
             if (authOpt && !validAuth.includes(authOpt)) {
-                throw new Error(`Invalid auth: ${authOpt}. Valid options: ${validAuth.join(', ')}`);
+                throw new Error(`Invalid auth: ${authOpt}. Valid options: ${validAuth.join(", ")}`);
             }
         }
-        const validLanguages = ['typescript', 'javascript'];
+        const validLanguages = ["typescript", "javascript"];
         const language = (options && (options.language || options.l)) || undefined;
         if (language && !validLanguages.includes(language)) {
-            throw new Error(`Invalid language: ${language}. Valid options: ${validLanguages.join(', ')}`);
+            throw new Error(`Invalid language: ${language}. Valid options: ${validLanguages.join(", ")}`);
         }
-        const validPackageManagers = ['pnpm', 'npm', 'yarn', 'bun'];
+        const validPackageManagers = ["pnpm", "npm", "yarn", "bun"];
         const pm = (options && (options.packageManager || options.p)) || undefined;
         if (pm && !validPackageManagers.includes(pm)) {
-            throw new Error(`Invalid package manager: ${pm}. Valid options: ${validPackageManagers.join(', ')}`);
+            throw new Error(`Invalid package manager: ${pm}. Valid options: ${validPackageManagers.join(", ")}`);
         }
         let database = "none";
         let prismaProvider;
@@ -136,12 +138,12 @@ async function getProjectConfig(projectName, options) {
             type: "list",
             name: "framework",
             message: "Select framework:",
-            choices: (discoveredModules.frameworks && discoveredModules.frameworks.length > 0)
-                ? discoveredModules.frameworks.map(f => ({ name: f.displayName, value: f.name }))
+            choices: discoveredModules.frameworks && discoveredModules.frameworks.length > 0
+                ? discoveredModules.frameworks.map((f) => ({ name: f.displayName, value: f.name }))
                 : [
-                    { name: 'Next.js', value: 'nextjs' },
-                    { name: 'Express.js', value: 'express' },
-                    { name: 'React (Vite)', value: 'react' },
+                    { name: "Next.js", value: "nextjs" },
+                    { name: "Express.js", value: "express" },
+                    { name: "React (Vite)", value: "react" },
                 ],
         },
         {
@@ -171,7 +173,7 @@ async function getProjectConfig(projectName, options) {
             type: "list",
             name: "auth",
             message: "Select authentication:",
-            when: (answers) => (answers.database !== "none" || answers.framework === "react"),
+            when: (answers) => answers.database !== "none" || answers.framework === "react",
             choices: (answers) => (0, module_discovery_1.getCompatibleAuthOptions)(discoveredModules.auth, answers.framework, answers.database || "none"),
         },
         {
@@ -204,7 +206,7 @@ async function getProjectConfig(projectName, options) {
             ? "none"
             : answers.database),
         prismaProvider: answers.prismaProvider,
-        auth: (answers.auth || "none"),
+        auth: answers.auth || "none",
         language: answers.language,
         packageManager: answers.packageManager,
     };
@@ -220,7 +222,7 @@ async function generateProject(config, targetDir, options) {
         copySpinner.fail("Failed to create project files");
         throw error;
     }
-    if (options?.install !== false && !(options?.['skip-install'] || options?.skipInstall)) {
+    if (options?.install !== false && !(options?.["skip-install"] || options?.skipInstall)) {
         const installSpinner = logger_1.logger.startSpinner("Installing dependencies...");
         try {
             await (0, package_manager_1.installDependencies)(targetDir, config.packageManager);
@@ -231,7 +233,9 @@ async function generateProject(config, targetDir, options) {
             throw error;
         }
     }
-    if (postInstallCommands.length > 0 && options?.install !== false && !(options?.['skip-install'] || options?.skipInstall)) {
+    if (postInstallCommands.length > 0 &&
+        options?.install !== false &&
+        !(options?.["skip-install"] || options?.skipInstall)) {
         const postInstallSpinner = logger_1.logger.startSpinner("Running post-install commands...");
         try {
             for (const command of postInstallCommands) {
@@ -244,21 +248,21 @@ async function generateProject(config, targetDir, options) {
             throw error;
         }
     }
-    if (options?.git !== false && !(options?.['no-git'] || options?.noGit)) {
+    if (options?.git !== false && !(options?.["no-git"] || options?.noGit)) {
         const gitSpinner = logger_1.logger.startSpinner("Initializing git repository...");
         try {
             await (0, git_utils_1.initGit)(targetDir);
             gitSpinner.succeed("Git repository initialized");
         }
-        catch {
-            gitSpinner.warn("Failed to initialize git repository");
+        catch (error) {
+            gitSpinner.warn(`Failed to initialize git repository: ${error.message}`);
         }
     }
 }
 async function composeTemplate(config, targetDir) {
     const packageRoot = (0, package_root_1.getPackageRoot)();
-    const templatesDir = path_1.default.join(packageRoot, 'templates');
-    const modulesDirForGenerator = path_1.default.join(packageRoot, 'modules');
+    const templatesDir = path_1.default.join(packageRoot, "templates");
+    const modulesDirForGenerator = path_1.default.join(packageRoot, "modules");
     await fs_extra_1.default.ensureDir(targetDir);
     const frameworkConfig = await framework_utils_1.FrameworkUtils.loadFrameworkConfig(config.framework, templatesDir);
     const generator = new code_generator_1.AdvancedCodeGenerator(frameworkConfig);
@@ -266,8 +270,8 @@ async function composeTemplate(config, targetDir) {
     const features = [];
     const postInstallCommands = await generator.generate({
         framework: config.framework,
-        database: config.database === 'none' ? undefined : config.database,
-        auth: config.auth === 'none' ? undefined : config.auth,
+        database: config.database === "none" ? undefined : config.database,
+        auth: config.auth === "none" ? undefined : config.auth,
         prismaProvider: config.prismaProvider,
     }, features, targetDir);
     const packageJsonPath = path_1.default.join(targetDir, "package.json");
@@ -285,13 +289,75 @@ async function composeTemplate(config, targetDir) {
         }
     }
     catch {
-        // Non-fatal: .env creation from .env.example is optional
+        // env copy failed.
     }
     if (config.language === "javascript") {
         await (0, js_conversion_1.convertToJavaScript)(targetDir, config.framework);
     }
     return postInstallCommands;
 }
+async function processGeneratorEnvVars(config, targetDir) {
+    const modulesDir = path_1.default.join((0, package_root_1.getPackageRoot)(), "modules");
+    const envVars = [];
+    // Process database generator env vars
+    if (config.database && config.database !== "none") {
+        const dbGeneratorPath = path_1.default.join(modulesDir, "database", config.database, "generator.json");
+        if (await fs_extra_1.default.pathExists(dbGeneratorPath)) {
+            const generator = await fs_extra_1.default.readJson(dbGeneratorPath);
+            if (generator.operations) {
+                for (const operation of generator.operations) {
+                    if (operation.type === "add-env" && (!operation.condition || checkCondition(operation.condition, config))) {
+                        for (const [key, value] of Object.entries(operation.envVars)) {
+                            envVars.push({
+                                key,
+                                value: value,
+                                required: true,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // Process auth generator env vars
+    if (config.auth && config.auth !== "none") {
+        const authGeneratorPath = path_1.default.join(modulesDir, "auth", config.auth, "generator.json");
+        if (await fs_extra_1.default.pathExists(authGeneratorPath)) {
+            const generator = await fs_extra_1.default.readJson(authGeneratorPath);
+            if (generator.operations) {
+                for (const operation of generator.operations) {
+                    if (operation.type === "add-env" && (!operation.condition || checkCondition(operation.condition, config))) {
+                        for (const [key, value] of Object.entries(operation.envVars)) {
+                            envVars.push({
+                                key,
+                                value: value,
+                                required: true,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    if (envVars.length > 0) {
+        await (0, env_editor_1.addEnvVariables)(targetDir, envVars, { force: true });
+    }
+}
+function checkCondition(condition, config) {
+    for (const [key, value] of Object.entries(condition)) {
+        if (Array.isArray(value)) {
+            if (!value.includes(config[key])) {
+                return false;
+            }
+        }
+        else {
+            if (config[key] !== value) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
 function showNextSteps(config) {
     logger_1.logger.newLine();
     logger_1.logger.success(`Created ${config.projectName}`);

package/dist/cli/doctor.js

@@ -96,7 +96,7 @@ async function runDoctorChecks() {
     const gitCheck = await checkGitRepo(projectRoot);
     checks.push(gitCheck);
     const conflicts = checkConflicts(authModules, databaseModules);
-    conflicts.forEach(conflict => {
+    conflicts.forEach((conflict) => {
         checks.push({
             status: "warning",
             message: conflict,
@@ -118,8 +118,11 @@ async function runDoctorChecks() {
         },
         files: {
             envExample: await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, ".env.example")),
-            env: await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, ".env")) || await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, ".env.local")),
-            prismaSchema: databaseModules.includes("prisma") ? await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, "prisma", "schema.prisma")) : undefined,
+            env: (await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, ".env"))) ||
+                (await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, ".env.local"))),
+            prismaSchema: databaseModules.includes("prisma")
+                ? await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, "prisma", "schema.prisma"))
+                : undefined,
             authRoutes: authModules.length > 0 ? await checkAuthRoutesExist(projectRoot, projectType) : undefined,
             tsconfig: await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, "tsconfig.json")),
             eslintConfig: await checkEslintConfigExists(projectRoot),
@@ -132,8 +135,8 @@ async function runDoctorChecks() {
         conflicts,
         checks,
         summary: {
-            errors: checks.filter(c => c.status === "error").length,
-            warnings: checks.filter(c => c.status === "warning").length,
+            errors: checks.filter((c) => c.status === "error").length,
+            warnings: checks.filter((c) => c.status === "warning").length,
             suggestions: generateSuggestions(),
         },
     };
@@ -232,7 +235,9 @@ async function checkKeyFiles(projectRoot, projectType, authModules, databaseModu
     const envExampleExists = await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, ".env.example"));
     checks.push({
         status: envExampleExists ? "success" : "warning",
-        message: envExampleExists ? ".env.example file found" : ".env.example file missing (recommended for documentation)",
+        message: envExampleExists
+            ? ".env.example file found"
+            : ".env.example file missing (recommended for documentation)",
     });
     if (databaseModules.includes("prisma")) {
         const schemaExists = await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, "prisma", "schema.prisma"));
@@ -245,7 +250,9 @@ async function checkKeyFiles(projectRoot, projectType, authModules, databaseModu
         const authRoutesExist = await checkAuthRoutesExist(projectRoot, projectType);
         checks.push({
             status: authRoutesExist ? "success" : "warning",
-            message: authRoutesExist ? "Auth routes configured" : "Auth routes not found (may need configuration)",
+            message: authRoutesExist
+                ? "Auth routes configured"
+                : "Auth routes not found (may need configuration)",
         });
     }
     return checks;
@@ -300,8 +307,11 @@ async function checkEnvFiles(projectRoot, authModules, databaseModules) {
         });
         return { checks, envStatus: { missing: requiredKeys, present: [] } };
     }
-    const envLines = envContent.split("\n").map(line => line.trim()).filter(line => line && !line.startsWith("#"));
-    const envVars = new Set(envLines.map(line => line.split("=")[0]));
+    const envLines = envContent
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith("#"));
+    const envVars = new Set(envLines.map((line) => line.split("=")[0]));
     for (const key of requiredKeys) {
         if (envVars.has(key)) {
             present.push(key);
@@ -336,20 +346,19 @@ function checkConflicts(authModules, databaseModules) {
 }
 async function checkConfigFiles(projectRoot, projectType, packageJson) {
     const checks = [];
-    // Check tsconfig.json
     const tsconfigExists = await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, "tsconfig.json"));
     checks.push({
         status: tsconfigExists ? "success" : "error",
         message: tsconfigExists ? MESSAGES.TSCONFIG_FOUND : MESSAGES.TSCONFIG_MISSING,
     });
-    // Check ESLint config
     const eslintExists = await checkEslintConfigExists(projectRoot);
     checks.push({
         status: eslintExists ? "success" : "warning",
         message: eslintExists ? MESSAGES.ESLINT_CONFIG_FOUND : MESSAGES.ESLINT_CONFIG_MISSING,
     });
-    // Check build script
-    const hasBuildScript = packageJson.scripts && typeof packageJson.scripts === "object" && "build" in packageJson.scripts;
+    const hasBuildScript = packageJson.scripts &&
+        typeof packageJson.scripts === "object" &&
+        "build" in packageJson.scripts;
     checks.push({
         status: hasBuildScript ? "success" : "warning",
         message: hasBuildScript ? MESSAGES.BUILD_SCRIPT_FOUND : MESSAGES.BUILD_SCRIPT_MISSING,
@@ -363,7 +372,6 @@ async function checkDependencies(packageJson) {
     const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
     for (const [name, version] of Object.entries(deps || {})) {
         if (typeof version === "string" && (version.startsWith("^") || version.startsWith("~"))) {
-            // Assume up to date
         }
         else {
             outdated.push(name);
@@ -525,7 +533,7 @@ function printDoctorReport(report, verbose) {
     // Conflicts
     if (report.conflicts.length > 0) {
         logger_1.logger.log(chalk_1.default.bold("Conflicts"));
-        report.conflicts.forEach(conflict => {
+        report.conflicts.forEach((conflict) => {
             logger_1.logger.warn(conflict);
         });
         logger_1.logger.newLine();
@@ -533,7 +541,7 @@ function printDoctorReport(report, verbose) {
     // Detailed checks if verbose
     if (verbose) {
         logger_1.logger.log(chalk_1.default.bold("Detailed Checks"));
-        report.checks.forEach(check => {
+        report.checks.forEach((check) => {
             if (check.status === "success") {
                 logger_1.logger.success(check.message);
             }
@@ -556,7 +564,7 @@ function printDoctorReport(report, verbose) {
     logger_1.logger.newLine();
     if (report.summary.suggestions.length > 0) {
         logger_1.logger.log(chalk_1.default.bold("Suggestions"));
-        report.summary.suggestions.forEach(suggestion => {
+        report.summary.suggestions.forEach((suggestion) => {
             logger_1.logger.log(`  • ${suggestion}`);
         });
     }

package/dist/cli/list.js

@@ -52,10 +52,22 @@ async function listCommand(options) {
                     logger_1.logger.log(`  ${chalk_1.default.gray(categoryPrefix)} ${chalk_1.default.yellow(formatCategoryName(category))} ${chalk_1.default.dim(`(${mods.length})`)}`);
                     mods.forEach((mod, modIndex) => {
                         const isLastMod = modIndex === mods.length - 1;
-                        const modPrefix = isLastCategory ? (isLastMod ? "    └──" : "    ├──") : (isLastMod ? "│   └──" : "│   ├──");
+                        const modPrefix = isLastCategory
+                            ? isLastMod
+                                ? "    └──"
+                                : "    ├──"
+                            : isLastMod
+                                ? "│   └──"
+                                : "│   ├──";
                         logger_1.logger.log(`  ${chalk_1.default.gray(modPrefix)} ${chalk_1.default.green(mod.displayName)}`);
                         if (mod.category === "database" && mod.name === "prisma") {
-                            const providerPrefix = isLastCategory ? (isLastMod ? "        └──" : "        ├──") : (isLastMod ? "│       └──" : "│       ├──");
+                            const providerPrefix = isLastCategory
+                                ? isLastMod
+                                    ? "        └──"
+                                    : "        ├──"
+                                : isLastMod
+                                    ? "│       └──"
+                                    : "│       ├──";
                             logger_1.logger.log(`  ${chalk_1.default.gray(providerPrefix)} ${chalk_1.default.dim("Providers: PostgreSQL, MongoDB, MySQL, SQLite")}`);
                         }
                     });

package/dist/index.js

@@ -11,11 +11,28 @@ const program = new commander_1.Command();
 program
     .name("stackkit")
     .description("CLI for creating and managing StackKit projects")
-    .version("0.1.0");
+    .version("0.1.5")
+    .configureHelp({
+    subcommandTerm: (cmd) => {
+        const name = cmd.name();
+        if (name === "create")
+            return "create [project-name] [options]";
+        if (name === "add")
+            return "add <module> [options]";
+        if (name === "doctor")
+            return "doctor [options]";
+        if (name === "list")
+            return "list [options]";
+        if (name === "help")
+            return "help [command]";
+        return name + " [options]";
+    },
+});
 // Create command
 program
     .command("create [project-name]")
     .description("Create a new StackKit project")
+    .usage("[project-name] [options]")
     .option("-f, --framework <framework>", "Framework: nextjs, express, react")
     .option("-d, --database <database>", "Database: prisma, mongoose, none")
     .option("--prisma-provider <provider>", "Prisma provider: postgresql, mongodb, mysql, sqlite")
@@ -36,12 +53,14 @@ program
 });
 // Add command
 program
-    .command("add <module>")
-    .description("Add a module to your existing project")
+    .command("add [module]")
+    .description("Add a module or category to your existing project")
+    .usage("[module] [options]")
     .option("--provider <provider>", "Specific provider/variant to use")
     .option("--force", "Overwrite existing files")
     .option("--dry-run", "Show what would be changed without making changes")
     .option("--no-install", "Skip installing dependencies")
+    .option("-y, --yes", "Use default options")
     .action(async (module, options) => {
     try {
         await (0, add_1.addCommand)(module, options);

package/dist/lib/conversion/js-conversion.js

@@ -10,7 +10,7 @@ const path_1 = __importDefault(require("path"));
 const package_root_1 = require("../utils/package-root");
 const baseDirs = {
     express: "./src",
-    "react": "./src",
+    react: "./src",
     nextjs: ".",
 };
 async function convertToJavaScript(targetDir, framework) {
@@ -77,7 +77,7 @@ async function convertToJavaScript(targetDir, framework) {
                         presets.push([
                             require.resolve("@babel/preset-react"),
                             {
-                                runtime: "classic",
+                                runtime: "automatic",
                             },
                         ]);
                     }

package/dist/lib/discovery/module-discovery.d.ts

@@ -5,7 +5,6 @@ export interface ModuleMetadata {
     category: string;
     provider?: string;
     supportedFrameworks?: string[];
-    databaseAdapters?: Record<string, unknown>;
     frameworkConfigs?: Record<string, unknown>;
     dependencies?: Record<string, unknown>;
     devDependencies?: Record<string, unknown>;