stackkit 0.2.6 → 0.2.8

package/dist/lib/constants.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LANGUAGE = exports.DEFAULT_PACKAGE_MANAGER = exports.PACKAGE_NAME = exports.CLI_COLORS = exports.SUCCESS_MESSAGES = exports.ERROR_MESSAGES = exports.DISPLAY_NAMES = exports.ROUTER_TYPES = exports.ENV_PATTERNS = exports.RETRY_CONFIG = exports.TIMEOUTS = exports.EXCLUDE_FROM_COPY = exports.ENV_FILES = exports.FILE_NAMES = exports.DIRECTORY_NAMES = exports.MODULE_CATEGORIES = exports.LANGUAGES = exports.LOCK_FILES_ARRAY = exports.LOCK_FILES = exports.PACKAGE_MANAGERS = void 0;
+exports.PACKAGE_MANAGERS = {
+    PNPM: "pnpm",
+    NPM: "npm",
+    YARN: "yarn",
+    BUN: "bun",
+};
+exports.LOCK_FILES = {
+    [exports.PACKAGE_MANAGERS.PNPM]: "pnpm-lock.yaml",
+    [exports.PACKAGE_MANAGERS.YARN]: "yarn.lock",
+    [exports.PACKAGE_MANAGERS.BUN]: "bun.lockb",
+    [exports.PACKAGE_MANAGERS.NPM]: "package-lock.json",
+};
+// Array of lock files with package managers for iteration
+exports.LOCK_FILES_ARRAY = [
+    { file: exports.LOCK_FILES.pnpm, pm: exports.PACKAGE_MANAGERS.PNPM },
+    { file: exports.LOCK_FILES.yarn, pm: exports.PACKAGE_MANAGERS.YARN },
+    { file: exports.LOCK_FILES.bun, pm: exports.PACKAGE_MANAGERS.BUN },
+    { file: exports.LOCK_FILES.npm, pm: exports.PACKAGE_MANAGERS.NPM },
+];
+exports.LANGUAGES = {
+    TYPESCRIPT: "typescript",
+    JAVASCRIPT: "javascript",
+};
+exports.MODULE_CATEGORIES = {
+    DATABASE: "database",
+    AUTH: "auth",
+    FRAMEWORK: "framework",
+};
+exports.DIRECTORY_NAMES = {
+    MODULES: "modules",
+    TEMPLATES: "templates",
+    NODE_MODULES: "node_modules",
+    GIT: ".git",
+    PRISMA: "prisma",
+    FILES: "files",
+    SRC: "src",
+    DIST: "dist",
+    BIN: "bin",
+};
+exports.FILE_NAMES = {
+    PACKAGE_JSON: "package.json",
+    TSCONFIG_JSON: "tsconfig.json",
+    MODULE_JSON: "module.json",
+    GENERATOR_JSON: "generator.json",
+    TEMPLATE_JSON: "template.json",
+    CONFIG_JSON: "config.json",
+    ENV: ".env",
+    ENV_LOCAL: ".env.local",
+    ENV_EXAMPLE: ".env.example",
+    GITIGNORE: ".gitignore",
+    README: "README.md",
+    SCHEMA_PRISMA: "schema.prisma",
+};
+exports.ENV_FILES = [exports.FILE_NAMES.ENV, exports.FILE_NAMES.ENV_LOCAL];
+exports.EXCLUDE_FROM_COPY = [
+    exports.FILE_NAMES.TEMPLATE_JSON,
+    exports.FILE_NAMES.CONFIG_JSON,
+    exports.DIRECTORY_NAMES.NODE_MODULES,
+    exports.DIRECTORY_NAMES.GIT,
+];
+exports.TIMEOUTS = {
+    PACKAGE_INSTALL: 300000, // 5 minutes in milliseconds
+    GIT_INIT: 30000, // 30 seconds
+    RETRY_DELAY_BASE: 1000, // 1 second base delay for retries
+};
+exports.RETRY_CONFIG = {
+    MAX_ATTEMPTS: 2,
+    PACKAGE_ROOT_MAX_ATTEMPTS: 10,
+};
+exports.ENV_PATTERNS = {
+    KEY: /^[A-Z_][A-Z0-9_]*$/,
+    COMMENT: /^\s*#/,
+};
+exports.ROUTER_TYPES = {
+    APP: "app",
+    PAGES: "pages",
+};
+exports.DISPLAY_NAMES = {
+    [exports.MODULE_CATEGORIES.DATABASE]: "Database",
+    [exports.MODULE_CATEGORIES.AUTH]: "Auth",
+    [exports.MODULE_CATEGORIES.FRAMEWORK]: "Framework",
+};
+exports.ERROR_MESSAGES = {
+    NO_PACKAGE_JSON: "No package.json found in current directory or any parent directory.",
+    INVALID_DIRECTORY: "Target directory already exists and is not empty.",
+    INVALID_PROJECT_NAME: "Invalid project name. Please use a valid npm package name.",
+    UNKNOWN_MODULE_TYPE: (module) => `Unknown module type "${module}". Use "${exports.MODULE_CATEGORIES.DATABASE}" or "${exports.MODULE_CATEGORIES.AUTH}", or specify a provider directly.`,
+    MODULE_NOT_FOUND: (moduleName) => `Module "${moduleName}" not found.`,
+    TEMPLATE_NOT_FOUND: (framework) => `Base template not found for framework: ${framework}`,
+    GIT_INIT_FAILED: "Failed to initialize git repository",
+    PACKAGE_INSTALL_FAILED: "Failed to install dependencies",
+};
+exports.SUCCESS_MESSAGES = {
+    PROJECT_CREATED: "✨ Project created successfully!",
+    MODULE_ADDED: "✨ Module added successfully!",
+    DEPENDENCIES_INSTALLED: "✓ Dependencies installed",
+    GIT_INITIALIZED: "✓ Git repository initialized",
+};
+exports.CLI_COLORS = {
+    PRIMARY: "cyan",
+    SUCCESS: "green",
+    WARNING: "yellow",
+    ERROR: "red",
+    INFO: "blue",
+    HEADER: "magenta",
+};
+exports.PACKAGE_NAME = "stackkit";
+exports.DEFAULT_PACKAGE_MANAGER = exports.PACKAGE_MANAGERS.NPM;
+exports.DEFAULT_LANGUAGE = exports.LANGUAGES.TYPESCRIPT;

package/dist/lib/env/env-editor.js

@@ -7,94 +7,88 @@ exports.addEnvVariables = addEnvVariables;
 exports.removeEnvVariables = removeEnvVariables;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
+const constants_1 = require("../constants");
 const logger_1 = require("../ui/logger");
 async function addEnvVariables(projectRoot, variables, options = {}) {
-    const envExamplePath = path_1.default.join(projectRoot, ".env.example");
-    const envPath = path_1.default.join(projectRoot, ".env");
-    await appendToEnvFile(envExamplePath, variables, "example", options);
-    const envExists = await fs_extra_1.default.pathExists(envPath);
-    if (envExists || options.force) {
-        await appendToEnvFile(envPath, variables, "local", options);
+    validateEnvVariables(variables);
+    const envExamplePath = path_1.default.join(projectRoot, constants_1.FILE_NAMES.ENV_EXAMPLE);
+    const envPath = path_1.default.join(projectRoot, constants_1.FILE_NAMES.ENV);
+    await appendToEnvFile(envExamplePath, variables, options);
+    if ((await fs_extra_1.default.pathExists(envPath)) || options.force) {
+        await appendToEnvFile(envPath, variables, options);
     }
     logger_1.logger.success("Environment variables added");
 }
-async function appendToEnvFile(filePath, variables, fileType, options = {}) {
-    // Validate environment variable keys
+async function removeEnvVariables(projectRoot, keys) {
+    const envExamplePath = path_1.default.join(projectRoot, constants_1.FILE_NAMES.ENV_EXAMPLE);
+    const envPath = path_1.default.join(projectRoot, constants_1.FILE_NAMES.ENV);
+    await removeFromEnvFile(envExamplePath, keys);
+    if (await fs_extra_1.default.pathExists(envPath)) {
+        await removeFromEnvFile(envPath, keys);
+    }
+}
+function validateEnvVariables(variables) {
     for (const variable of variables) {
-        if (!/^[A-Z_][A-Z0-9_]*$/.test(variable.key)) {
-            throw new Error(`Invalid environment variable key: ${variable.key}`);
+        if (!constants_1.ENV_PATTERNS.KEY.test(variable.key)) {
+            throw new Error(`Invalid environment variable key: ${variable.key}. ` +
+                `Must match pattern: ${constants_1.ENV_PATTERNS.KEY}`);
         }
     }
+}
+async function appendToEnvFile(filePath, variables, options = {}) {
     let content = "";
     if (await fs_extra_1.default.pathExists(filePath)) {
         content = await fs_extra_1.default.readFile(filePath, "utf-8");
     }
-    // If force, remove existing keys first to avoid duplicates
     if (options.force) {
         const keysToRemove = variables.map((v) => v.key);
         await removeFromEnvFile(filePath, keysToRemove);
-        if (await fs_extra_1.default.pathExists(filePath)) {
-            content = await fs_extra_1.default.readFile(filePath, "utf-8");
-        }
-        else {
-            content = "";
-        }
-    }
-    // Check if variables already exist (after potential removal)
-    const existingKeys = new Set();
-    const lines = content.split("\n");
-    for (const line of lines) {
-        const match = line.match(/^([A-Z_][A-Z0-9_]*)=/);
-        if (match) {
-            existingKeys.add(match[1]);
-        }
+        content = (await fs_extra_1.default.pathExists(filePath)) ? await fs_extra_1.default.readFile(filePath, "utf-8") : "";
     }
+    const existingKeys = extractExistingKeys(content);
     const newVariables = variables.filter((v) => !existingKeys.has(v.key));
-    if (newVariables.length === 0) {
+    if (newVariables.length === 0)
         return;
-    }
-    // Ensure file ends with newline
     if (content && !content.endsWith("\n")) {
         content += "\n";
     }
-    // Append variables
     for (const variable of newVariables) {
-        const value = fileType === "example" ? variable.value || "" : variable.value || "";
-        content += `${variable.key}=${value}\n`;
+        content += `${variable.key}=${variable.value || ""}\n`;
     }
     await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
     await fs_extra_1.default.writeFile(filePath, content, "utf-8");
 }
-async function removeEnvVariables(projectRoot, keys) {
-    const envExamplePath = path_1.default.join(projectRoot, ".env.example");
-    const envPath = path_1.default.join(projectRoot, ".env");
-    await removeFromEnvFile(envExamplePath, keys);
-    if (await fs_extra_1.default.pathExists(envPath)) {
-        await removeFromEnvFile(envPath, keys);
-    }
-}
 async function removeFromEnvFile(filePath, keys) {
-    if (!(await fs_extra_1.default.pathExists(filePath))) {
+    if (!(await fs_extra_1.default.pathExists(filePath)))
         return;
-    }
     try {
         const content = await fs_extra_1.default.readFile(filePath, "utf-8");
         const lines = content.split("\n");
         const newLines = [];
         for (const line of lines) {
             const match = line.match(/^([A-Z_][A-Z0-9_]*)=/);
-            if (match && keys.includes(match[1])) {
-                continue;
+            if (!match || !keys.includes(match[1])) {
+                newLines.push(line);
             }
-            newLines.push(line);
         }
         while (newLines.length > 0 && newLines[newLines.length - 1].trim() === "") {
             newLines.pop();
         }
-        await fs_extra_1.default.writeFile(filePath, newLines.join("\n"), "utf-8");
+        await fs_extra_1.default.writeFile(filePath, newLines.join("\n") + (newLines.length > 0 ? "\n" : ""), "utf-8");
     }
     catch (error) {
-        logger_1.logger.error(`Failed to remove env variables from ${filePath}: ${error}`);
+        logger_1.logger.error(`Failed to remove env variables from ${filePath}`);
         throw error;
     }
 }
+function extractExistingKeys(content) {
+    const existingKeys = new Set();
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const match = line.match(/^([A-Z_][A-Z0-9_]*)=/);
+        if (match) {
+            existingKeys.add(match[1]);
+        }
+    }
+    return existingKeys;
+}

package/dist/lib/fs/files.d.ts

@@ -6,7 +6,6 @@ export interface PackageJsonConfig {
 export declare function copyBaseFramework(templatesDir: string, targetDir: string, framework: string): Promise<void>;
 export declare function mergePackageJson(targetDir: string, config: PackageJsonConfig): Promise<void>;
 export declare function mergeEnvFile(targetDir: string, envVars: Record<string, string>): Promise<void>;
-export declare function copyTemplate(templatePath: string, targetPath: string, projectName: string): Promise<void>;
 export declare function createFile(targetPath: string, content: string, options?: {
     force?: boolean;
 }): Promise<void>;

package/dist/lib/fs/files.js

@@ -6,12 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.copyBaseFramework = copyBaseFramework;
 exports.mergePackageJson = mergePackageJson;
 exports.mergeEnvFile = mergeEnvFile;
-exports.copyTemplate = copyTemplate;
 exports.createFile = createFile;
 exports.readFile = readFile;
 exports.fileExists = fileExists;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
+const constants_1 = require("../constants");
 const logger_1 = require("../ui/logger");
 async function copyBaseFramework(templatesDir, targetDir, framework) {
     const baseDir = path_1.default.join(templatesDir, framework);
@@ -19,17 +19,13 @@ async function copyBaseFramework(templatesDir, targetDir, framework) {
         throw new Error(`Base template not found for framework: ${framework}\n` + `Expected at: ${baseDir}`);
     }
     await fs_extra_1.default.copy(baseDir, targetDir, {
-        filter: (src) => {
-            const basename = path_1.default.basename(src);
-            return !["template.json", "config.json", "node_modules", ".git"].includes(basename);
-        },
+        filter: (src) => !constants_1.EXCLUDE_FROM_COPY.includes(path_1.default.basename(src)),
     });
 }
 async function mergePackageJson(targetDir, config) {
-    const pkgPath = path_1.default.join(targetDir, "package.json");
-    if (!(await fs_extra_1.default.pathExists(pkgPath))) {
+    const pkgPath = path_1.default.join(targetDir, constants_1.FILE_NAMES.PACKAGE_JSON);
+    if (!(await fs_extra_1.default.pathExists(pkgPath)))
         return;
-    }
     const pkg = await fs_extra_1.default.readJson(pkgPath);
     if (config.dependencies) {
         pkg.dependencies = { ...pkg.dependencies, ...config.dependencies };
@@ -43,46 +39,22 @@ async function mergePackageJson(targetDir, config) {
     await fs_extra_1.default.writeJson(pkgPath, pkg, { spaces: 2 });
 }
 async function mergeEnvFile(targetDir, envVars) {
-    const envPath = path_1.default.join(targetDir, ".env");
-    let existingEnv = "";
+    const envPath = path_1.default.join(targetDir, constants_1.FILE_NAMES.ENV);
+    let content = "";
     if (await fs_extra_1.default.pathExists(envPath)) {
-        existingEnv = await fs_extra_1.default.readFile(envPath, "utf-8");
+        content = await fs_extra_1.default.readFile(envPath, "utf-8");
     }
-    const envLines = existingEnv.split("\n").filter((line) => line.trim() !== "");
-    // Add new variables
+    const lines = content.split("\n").filter((line) => line.trim() !== "");
     for (const [key, value] of Object.entries(envVars)) {
-        const existingIndex = envLines.findIndex((line) => line.startsWith(`${key}=`));
+        const existingIndex = lines.findIndex((line) => line.startsWith(`${key}=`));
         if (existingIndex !== -1) {
-            envLines[existingIndex] = `${key}=${value}`;
+            lines[existingIndex] = `${key}=${value}`;
         }
         else {
-            envLines.push(`${key}=${value}`);
+            lines.push(`${key}=${value}`);
         }
     }
-    await fs_extra_1.default.writeFile(envPath, envLines.join("\n") + "\n", "utf-8");
-}
-async function copyTemplate(templatePath, targetPath, projectName) {
-    if (!(await fs_extra_1.default.pathExists(templatePath))) {
-        throw new Error(`Template not found: ${templatePath}`);
-    }
-    // Create target directory
-    await fs_extra_1.default.ensureDir(targetPath);
-    // Copy all files
-    await fs_extra_1.default.copy(templatePath, targetPath, {
-        filter: (src) => {
-            const basename = path_1.default.basename(src);
-            // Skip template.json metadata file and node_modules
-            return basename !== "template.json" && basename !== "node_modules";
-        },
-    });
-    // Update package.json with project name
-    const packageJsonPath = path_1.default.join(targetPath, "package.json");
-    if (await fs_extra_1.default.pathExists(packageJsonPath)) {
-        const packageJson = await fs_extra_1.default.readJSON(packageJsonPath);
-        packageJson.name = projectName;
-        await fs_extra_1.default.writeJSON(packageJsonPath, packageJson, { spaces: 2 });
-    }
-    logger_1.logger.success(`Template copied to ${targetPath}`);
+    await fs_extra_1.default.writeFile(envPath, lines.join("\n") + "\n", "utf-8");
 }
 async function createFile(targetPath, content, options = {}) {
     const exists = await fs_extra_1.default.pathExists(targetPath);

package/dist/lib/generation/code-generator.d.ts

@@ -4,6 +4,8 @@ export interface GenerationContext {
     database?: string;
     auth?: string;
     features?: string[];
+    combo?: string;
+    prismaProvider?: string;
     [key: string]: unknown;
 }
 export interface TemplateCondition {
@@ -31,7 +33,7 @@ export interface PatchOperation {
     type: "add-import" | "add-code" | "replace-code" | "add-to-top" | "add-to-bottom";
     condition?: TemplateCondition;
     imports?: string[];
-    code?: string;
+    code?: string | string[];
     after?: string;
     before?: string;
     replace?: string;
@@ -58,6 +60,7 @@ export declare class AdvancedCodeGenerator {
     loadGenerators(modulesPath: string): Promise<void>;
     private evaluateCondition;
     private processTemplate;
+    private renderHeadingFromExpr;
     private processVariableDefinitions;
     private processTemplateRecursive;
     generate(selectedModules: {

package/dist/lib/generation/code-generator.js

@@ -108,6 +108,13 @@ class AdvancedCodeGenerator {
         content = content.replace(/\n{3,}/g, "\n\n");
         return content;
     }
+    renderHeadingFromExpr(expr, context) {
+        const depthVar = expr.substring(8).trim();
+        const depthVal = context[depthVar];
+        const n = parseInt(String(depthVal || "1"), 10) || 1;
+        const level = Math.max(1, Math.min(n, 6));
+        return "#".repeat(level);
+    }
     processVariableDefinitions(content, context) {
         let result = content;
         let index = 0;
@@ -223,7 +230,8 @@ class AdvancedCodeGenerator {
                     break;
                 }
             }
-            return (result || defaultCase || "").trim();
+            const chosen = (result || defaultCase || "").trim();
+            return this.processTemplateRecursive(chosen, context);
         });
         // Handle variable replacement with advanced expressions
         content = content.replace(/\{\{([^}]+)\}\}/g, (match, varExpr) => {
@@ -252,15 +260,19 @@ class AdvancedCodeGenerator {
                     const [caseVal, result] = caseStr.split(":").map((s) => s.trim());
                     const cleanCaseVal = caseVal.replace(/['"]/g, "");
                     if (cleanCaseVal === actualVal || cleanCaseVal === "default") {
-                        return result.replace(/['"]/g, "");
+                        return this.processTemplateRecursive(result.replace(/['"]/g, ""), context);
                     }
                 }
                 return "";
             }
+            // Handle heading helper {{heading:depthVar}} -> '#', '##', ... up to '######'
+            if (trimmedExpr.startsWith("heading:")) {
+                return this.renderHeadingFromExpr(trimmedExpr, context);
+            }
             // Handle feature flags {{feature:name}}
             if (trimmedExpr.startsWith("feature:")) {
-                const featureName = trimmedExpr.substring(8);
-                const features = context.features || [];
+                const featureName = trimmedExpr.substring(8).trim();
+                const features = Array.isArray(context.features) ? context.features : [];
                 return features.includes(featureName) ? "true" : "false";
             }
             // Handle conditional expressions {{if condition then:value else:value}}
@@ -290,6 +302,8 @@ class AdvancedCodeGenerator {
             ...selectedModules,
             features,
         };
+        // Derived combined key to simplify template conditionals (e.g. "prisma:express")
+        context.combo = `${context.database || ""}:${context.framework || ""}`;
         // Set default prismaProvider if database is prisma but no provider specified
         if (selectedModules.database === "prisma" && !context.prismaProvider) {
             const providers = (0, shared_1.getPrismaProvidersFromGenerator)((0, package_root_1.getPackageRoot)());
@@ -505,9 +519,6 @@ class AdvancedCodeGenerator {
         if (processed.content) {
             processed.content = this.processTemplate(processed.content, context);
         }
-        if (processed.destination) {
-            processed.destination = this.processTemplate(processed.destination, context);
-        }
         // Process templates in patch operations
         if (processed.operations) {
             processed.operations = processed.operations.map((op) => {
@@ -516,7 +527,14 @@ class AdvancedCodeGenerator {
                     processedOp.imports = processedOp.imports.map((imp) => this.processTemplate(imp, context));
                 }
                 if (processedOp.code) {
-                    processedOp.code = this.processTemplate(processedOp.code, context);
+                    if (Array.isArray(processedOp.code)) {
+                        processedOp.code = processedOp.code
+                            .map((c) => this.processTemplate(c, context))
+                            .join("\n");
+                    }
+                    else {
+                        processedOp.code = this.processTemplate(processedOp.code, context);
+                    }
                 }
                 if (processedOp.after) {
                     processedOp.after = this.processTemplate(processedOp.after, context);
@@ -648,7 +666,10 @@ class AdvancedCodeGenerator {
                         break;
                     case "add-code":
                         if (patchOp.code) {
-                            const processedCode = this.processTemplate(patchOp.code, context);
+                            let codeValue = patchOp.code;
+                            if (Array.isArray(codeValue))
+                                codeValue = codeValue.join("\n");
+                            const processedCode = this.processTemplate(codeValue, context);
                             // Skip insertion if the exact code already exists in the file
                             const codeTrimmed = processedCode.trim();
                             if (codeTrimmed && content.includes(codeTrimmed)) {
@@ -696,7 +717,10 @@ class AdvancedCodeGenerator {
                         break;
                     case "replace-code":
                         if (patchOp.code && patchOp.replace) {
-                            const processedCode = this.processTemplate(patchOp.code, context);
+                            let codeValue2 = patchOp.code;
+                            if (Array.isArray(codeValue2))
+                                codeValue2 = codeValue2.join("\n");
+                            const processedCode = this.processTemplate(codeValue2, context);
                             const replacePattern = this.processTemplate(patchOp.replace, context);
                             content = content.replace(replacePattern, processedCode);
                         }
@@ -845,6 +869,8 @@ class AdvancedCodeGenerator {
             ...selectedModules,
             features,
         };
+        // Derived combined key to simplify template conditionals (e.g. "prisma:express")
+        context.combo = `${context.database || ""}:${context.framework || ""}`;
         if (selectedModules.database === "prisma" && !context.prismaProvider) {
             const providers = (0, shared_1.getPrismaProvidersFromGenerator)((0, package_root_1.getPackageRoot)());
             if (providers && providers.length > 0) {

package/dist/lib/pm/package-manager.d.ts

@@ -1,5 +1,5 @@
 export type PackageManager = "npm" | "yarn" | "pnpm" | "bun";
 export declare function detectPackageManager(cwd: string): Promise<PackageManager>;
-export declare function installDependencies(cwd: string, pm: PackageManager): Promise<void>;
+export declare function installDependencies(cwd: string, pm: PackageManager, maxRetries?: number): Promise<void>;
 export declare function addDependencies(cwd: string, pm: PackageManager, packages: string[], dev?: boolean): Promise<void>;
 export declare function initGit(cwd: string): Promise<void>;