better-ts-stack 2.0.0 → 2.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdullah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -39,7 +39,7 @@ npx better-ts-stack . --framework nextjs --database drizzle --pm pnpm
 | `--git` / `--no-git`         | Initialize a git repository                  |
 | `--install` / `--no-install` | Install dependencies                         |
 | `-y`, `--yes`                | Use defaults for missing options, no prompts |
-| `--dry-run`                  | Show the summary without writing files       |
+| `--dry-run`                  | List what would be created, write nothing    |
 | `-h`, `--help`               | Show help                                    |
 | `-v`, `--version`            | Show the version                             |
 

package/dist/args.js

@@ -23,7 +23,8 @@ Options left out are asked interactively, unless --yes is given.
   --git, --no-git         Initialize a git repository
   --install, --no-install Install dependencies
   -y, --yes               Use defaults for missing options and skip confirmation
-  --dry-run               Show what would be created without writing files
+  --dry-run               List the files, dependencies, scripts, environment
+                          variables, and commands without writing anything
   -h, --help              Show this help
   -v, --version           Show the version
 
@@ -87,4 +88,3 @@ function parseCliArgs(argv) {
         version: values.version ?? false,
     };
 }
-//# sourceMappingURL=args.js.map

package/dist/builder/buildPlanner.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadBuildInputs = loadBuildInputs;
+exports.planBuild = planBuild;
+// Works out what a build produces; nothing here writes to disk
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const registry_1 = require("../modules/registry");
+const configGenerator_1 = require("./configGenerator");
+const fileProcessor_1 = require("./fileProcessor");
+const gitInitializer_1 = require("./gitInitializer");
+const moduleSelector_1 = require("./moduleSelector");
+const templateContext_1 = require("./templateContext");
+// Files the builder writes itself instead of copying them from a module
+const GENERATED_FILES = ["package.json", ".env", ".env.example"];
+// Loads the selected modules and merges their configurations
+async function loadBuildInputs(config) {
+    const selection = (0, moduleSelector_1.selectModules)(config);
+    const modules = [];
+    for (const id of [selection.base, ...selection.modules]) {
+        modules.push(await (0, registry_1.getModule)(id));
+    }
+    const templateContext = (0, templateContext_1.buildTemplateContext)(config);
+    const mergedConfig = (0, configGenerator_1.mergeConfigurations)(modules.map((m) => m.config), templateContext);
+    return { modules, templateContext, mergedConfig };
+}
+// The target directory may not exist yet, so git is asked about the closest
+// directory that does
+async function findExistingDirectory(dir) {
+    let current = dir;
+    while (!(await fs_extra_1.default.pathExists(current))) {
+        const parent = node_path_1.default.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return current;
+}
+// Describes the files, package.json content, environment variables, and
+// commands of a build, for --dry-run
+async function planBuild(config, targetDir) {
+    const { modules, mergedConfig } = await loadBuildInputs(config);
+    // Later modules overwrite files of earlier ones, so each path is listed once
+    const files = new Set(GENERATED_FILES);
+    if (config.packageManager === "pnpm")
+        files.add("pnpm-workspace.yaml");
+    for (const module of modules) {
+        for (const file of await (0, fileProcessor_1.listModuleFiles)(module.path))
+            files.add(file);
+    }
+    const envVars = Object.fromEntries(Object.entries(mergedConfig.envVars).map(([key, value]) => [
+        key,
+        configGenerator_1.GENERATED_SECRETS.includes(key) ? "<random secret>" : value,
+    ]));
+    const commands = [];
+    if (config.installDeps)
+        commands.push(`${config.packageManager} install`);
+    if (config.initGit &&
+        !(0, gitInitializer_1.isInsideGitRepository)(await findExistingDirectory(targetDir))) {
+        commands.push("git init");
+    }
+    return {
+        ...mergedConfig,
+        envVars,
+        files: [...files].sort((a, b) => a.localeCompare(b)),
+        commands,
+    };
+}

package/dist/builder/configGenerator.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.GENERATED_SECRETS = void 0;
 exports.processScriptVariables = processScriptVariables;
 exports.mergeConfigurations = mergeConfigurations;
 exports.generatePackageJson = generatePackageJson;
@@ -12,7 +13,7 @@ exports.generateEnvFile = generateEnvFile;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const handlebars_1 = __importDefault(require("handlebars"));
 const node_crypto_1 = require("node:crypto");
-const path_1 = __importDefault(require("path"));
+const node_path_1 = __importDefault(require("node:path"));
 const types_1 = require("../types");
 // Frameworks whose generated project uses ES modules
 const ESM_FRAMEWORKS = ["tanstack", "nestjs"];
@@ -88,7 +89,7 @@ async function generatePackageJson(targetDir, mergedConfig, config) {
             devDependencies: mergedConfig.devDependencies,
             overrides,
         };
-        const packageJsonPath = path_1.default.join(targetDir, "package.json");
+        const packageJsonPath = node_path_1.default.join(targetDir, "package.json");
         await fs_extra_1.default.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n", "utf-8");
     }
     catch (error) {
@@ -124,12 +125,14 @@ async function generatePnpmWorkspace(targetDir, overrides) {
         lines.push(`  - "${name}"`);
     }
     try {
-        await fs_extra_1.default.writeFile(path_1.default.join(targetDir, "pnpm-workspace.yaml"), lines.join("\n") + "\n", "utf-8");
+        await fs_extra_1.default.writeFile(node_path_1.default.join(targetDir, "pnpm-workspace.yaml"), lines.join("\n") + "\n", "utf-8");
     }
     catch (error) {
         throw (0, types_1.buildError)(error, "PNPM_WORKSPACE_ERROR", "Failed to generate pnpm-workspace.yaml");
     }
 }
+// Variables that get a random value in .env instead of the module's default
+exports.GENERATED_SECRETS = ["JWT_SECRET", "BETTER_AUTH_SECRET"];
 // Generates .env and .env.example files from merged environment variables
 async function generateEnvFile(targetDir, envVars) {
     try {
@@ -140,21 +143,20 @@ async function generateEnvFile(targetDir, envVars) {
         let localEnvContent = envContent;
         // Add each environment variable
         for (const [key, value] of Object.entries(envVars)) {
-            const resolvedValue = ["JWT_SECRET", "BETTER_AUTH_SECRET"].includes(key)
+            const resolvedValue = exports.GENERATED_SECRETS.includes(key)
                 ? (0, node_crypto_1.randomBytes)(32).toString("hex")
                 : value;
             envContent += `${key}=${value}\n`;
             localEnvContent += `${key}=${resolvedValue}\n`;
         }
         // Write .env.example
-        const envExamplePath = path_1.default.join(targetDir, ".env.example");
+        const envExamplePath = node_path_1.default.join(targetDir, ".env.example");
         await fs_extra_1.default.writeFile(envExamplePath, envContent, "utf-8");
         // Keep generated secrets out of the shareable example file.
-        const envPath = path_1.default.join(targetDir, ".env");
+        const envPath = node_path_1.default.join(targetDir, ".env");
         await fs_extra_1.default.writeFile(envPath, localEnvContent, "utf-8");
     }
     catch (error) {
         throw (0, types_1.buildError)(error, "ENV_FILE_ERROR", "Failed to generate environment files");
     }
 }
-//# sourceMappingURL=configGenerator.js.map

package/dist/builder/dependencyInstaller.js

@@ -21,4 +21,3 @@ function installDependencies(packageManager, cwd) {
         return false;
     }
 }
-//# sourceMappingURL=dependencyInstaller.js.map

package/dist/builder/fileProcessor.js

@@ -4,18 +4,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.copyModuleFiles = copyModuleFiles;
+exports.listModuleFiles = listModuleFiles;
 exports.compileTemplate = compileTemplate;
 exports.processTemplateFiles = processTemplateFiles;
-exports.processTemplateFile = processTemplateFile;
 // Utilities for copying files and processing Handlebars templates
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const handlebars_1 = __importDefault(require("handlebars"));
-const path_1 = __importDefault(require("path"));
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
 const types_1 = require("../types");
+const TEMPLATE_EXTENSION = ".hbs";
+const MODULE_CONFIG_FILE = "config.json";
+// Names a template's .gitignore can be stored under, see restoreGitignore()
+const GITIGNORE_TEMPLATE_NAMES = ["gitignore", ".npmignore"];
 async function restoreGitignore(targetDir) {
-    const templateGitignorePath = path_1.default.join(targetDir, "gitignore");
-    const npmIgnorePath = path_1.default.join(targetDir, ".npmignore");
-    const gitIgnorePath = path_1.default.join(targetDir, ".gitignore");
+    const templateGitignorePath = node_path_1.default.join(targetDir, "gitignore");
+    const npmIgnorePath = node_path_1.default.join(targetDir, ".npmignore");
+    const gitIgnorePath = node_path_1.default.join(targetDir, ".gitignore");
     const [hasTemplateGitignore, hasNpmIgnore, hasGitIgnore] = await Promise.all([
         fs_extra_1.default.pathExists(templateGitignorePath),
         fs_extra_1.default.pathExists(npmIgnorePath),
@@ -41,8 +46,8 @@ async function copyModuleFiles(moduleDir, targetDir) {
             overwrite: true,
             filter: (src) => {
                 // Skip config.json files
-                const basename = path_1.default.basename(src);
-                return basename !== "config.json";
+                const basename = node_path_1.default.basename(src);
+                return basename !== MODULE_CONFIG_FILE;
             },
         });
         await restoreGitignore(targetDir);
@@ -51,58 +56,56 @@ async function copyModuleFiles(moduleDir, targetDir) {
         throw (0, types_1.buildError)(error, "FILE_COPY_ERROR", `Failed to copy module files from ${moduleDir}`);
     }
 }
+// Lists the files a module adds to a project, under the names they end up
+// with: no .hbs extension, and the gitignore template as .gitignore
+async function listModuleFiles(moduleDir) {
+    const entries = await (0, promises_1.readdir)(moduleDir, {
+        recursive: true,
+        withFileTypes: true,
+    });
+    return entries
+        .filter((entry) => entry.isFile() && entry.name !== MODULE_CONFIG_FILE)
+        .map((entry) => {
+        const file = node_path_1.default
+            .relative(moduleDir, node_path_1.default.join(entry.parentPath, entry.name))
+            .split(node_path_1.default.sep)
+            .join("/");
+        if (GITIGNORE_TEMPLATE_NAMES.includes(file))
+            return ".gitignore";
+        return file.endsWith(TEMPLATE_EXTENSION)
+            ? file.slice(0, -TEMPLATE_EXTENSION.length)
+            : file;
+    });
+}
 // Compiles and renders template content with Handlebars and provided context
 function compileTemplate(content, context) {
     try {
-        // Register helper functions with Handlebars
-        Object.entries(context.helpers).forEach(([name, fn]) => {
-            handlebars_1.default.registerHelper(name, fn);
-        });
-        // Compile the template
-        const template = handlebars_1.default.compile(content);
-        // Render with context
-        return template(context);
+        // The output is source code, not HTML, so values are written unescaped
+        const template = handlebars_1.default.compile(content, { noEscape: true });
+        return template(context, { helpers: context.helpers });
     }
     catch (error) {
         throw (0, types_1.buildError)(error, "TEMPLATE_SYNTAX_ERROR", "Failed to compile Handlebars template");
     }
 }
-// Processes multiple template files by replacing variables and handling extensions
-async function processTemplateFiles(targetDir, context, templateFiles) {
-    for (const templateFile of templateFiles) {
-        await processTemplateFile(path_1.default.join(targetDir, templateFile), context);
+// Renders every .hbs file in the project and removes the .hbs extension
+async function processTemplateFiles(targetDir, context) {
+    const files = await (0, promises_1.readdir)(targetDir, { recursive: true });
+    for (const file of files) {
+        if (file.endsWith(TEMPLATE_EXTENSION)) {
+            await processTemplateFile(node_path_1.default.join(targetDir, file), context);
+        }
     }
 }
-// Processes a single template file, replaces variables, and renames/deletes .hbs files
+// Renders a single .hbs file next to itself and deletes the template
 async function processTemplateFile(filePath, context) {
     try {
-        // Check if file exists
-        const exists = await fs_extra_1.default.pathExists(filePath);
-        if (!exists) {
-            return; // Skip if file doesn't exist
-        }
-        // Read template file
         const content = await fs_extra_1.default.readFile(filePath, "utf-8");
-        // Compile and render template with Handlebars
         const rendered = compileTemplate(content, context);
-        // Determine output path (remove .hbs extension if present)
-        const outputPath = filePath.endsWith(".hbs")
-            ? filePath.slice(0, -4)
-            : filePath;
-        // Write processed content
-        await fs_extra_1.default.writeFile(outputPath, rendered, "utf-8");
-        // Remove original .hbs file if it was renamed
-        if (outputPath !== filePath) {
-            await fs_extra_1.default.remove(filePath);
-        }
+        await fs_extra_1.default.writeFile(filePath.slice(0, -TEMPLATE_EXTENSION.length), rendered, "utf-8");
+        await fs_extra_1.default.remove(filePath);
     }
     catch (error) {
-        // Re-throw BuildErrors as-is
-        if (error && typeof error === "object" && "code" in error) {
-            throw error;
-        }
-        // Wrap other errors
-        throw (0, types_1.buildError)(error, "TEMPLATE_WRITE_ERROR", `Failed to process template file ${filePath}`);
+        throw (0, types_1.buildError)(error, "TEMPLATE_PROCESSING_ERROR", `Failed to process template file ${filePath}`);
     }
 }
-//# sourceMappingURL=fileProcessor.js.map

package/dist/builder/gitInitializer.js

@@ -1,10 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInsideGitRepository = isInsideGitRepository;
 exports.initializeGitRepository = initializeGitRepository;
 const node_child_process_1 = require("node:child_process");
 const ui_1 = require("../ui");
+// True when the directory is already tracked by a git repository above it
+function isInsideGitRepository(cwd) {
+    try {
+        const output = (0, node_child_process_1.execSync)("git rev-parse --is-inside-work-tree", {
+            cwd,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return output.toString().trim() === "true";
+    }
+    catch {
+        return false;
+    }
+}
 // Initializes a git repository in the given directory
 function initializeGitRepository(cwd) {
+    // A project created inside a repository (apps/api in a monorepo) must not
+    // get a nested repository of its own
+    if (isInsideGitRepository(cwd)) {
+        (0, ui_1.info)("Already inside a git repository, skipped git init");
+        return false;
+    }
     try {
         (0, node_child_process_1.execSync)("git init", { cwd, stdio: "ignore" });
         (0, ui_1.success)("Git repository initialized");
@@ -16,4 +36,3 @@ function initializeGitRepository(cwd) {
         return false;
     }
 }
-//# sourceMappingURL=gitInitializer.js.map

package/dist/builder/index.js

@@ -3,18 +3,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.planBuild = void 0;
 exports.build = build;
 const fs_extra_1 = __importDefault(require("fs-extra"));
-const registry_1 = require("../modules/registry");
 const nextSteps_1 = require("../output/nextSteps");
 const types_1 = require("../types");
 const validators_1 = require("../validators");
+const buildPlanner_1 = require("./buildPlanner");
 const configGenerator_1 = require("./configGenerator");
 const dependencyInstaller_1 = require("./dependencyInstaller");
 const fileProcessor_1 = require("./fileProcessor");
 const gitInitializer_1 = require("./gitInitializer");
-const moduleSelector_1 = require("./moduleSelector");
-const templateContext_1 = require("./templateContext");
+var buildPlanner_2 = require("./buildPlanner");
+Object.defineProperty(exports, "planBuild", { enumerable: true, get: function () { return buildPlanner_2.planBuild; } });
 // Main function to orchestrate the project construction process
 async function build(config, targetDir) {
     // 1. Validate target directory
@@ -27,51 +28,29 @@ async function build(config, targetDir) {
         await fs_extra_1.default.ensureDir(targetDir).catch((e) => {
             throw (0, types_1.buildError)(e, "DIRECTORY_CREATE_ERROR", "Failed to create directory");
         });
-        // 3. Select and load modules
-        const selection = (0, moduleSelector_1.selectModules)(config);
-        const modules = [];
-        try {
-            for (const id of [selection.base, ...selection.modules]) {
-                modules.push(await (0, registry_1.getModule)(id));
-            }
+        // 3. Load the selected modules, build the template context, and merge
+        // the module configurations
+        const { modules, templateContext, mergedConfig } = await (0, buildPlanner_1.loadBuildInputs)(config);
+        // 4. Copy module files
+        for (const module of modules) {
+            await (0, fileProcessor_1.copyModuleFiles)(module.path, targetDir);
         }
-        catch (e) {
-            throw (0, types_1.buildError)(e, "MODULE_LOADING_ERROR", "Failed to load modules");
-        }
-        // 4. Build template context and merge module configurations
-        const templateContext = (0, templateContext_1.buildTemplateContext)(config);
-        const mergedConfig = (0, configGenerator_1.mergeConfigurations)(modules.map((m) => m.config), templateContext);
-        // 5. Copy module files
-        try {
-            for (const module of modules) {
-                await (0, fileProcessor_1.copyModuleFiles)(module.path, targetDir);
-            }
-        }
-        catch (e) {
-            throw (0, types_1.buildError)(e, "FILE_COPY_ERROR", "Failed to copy module files");
-        }
-        // 6. Process Handlebars templates
-        try {
-            await (0, fileProcessor_1.processTemplateFiles)(targetDir, templateContext, modules.flatMap((m) => m.config.templateFiles));
-        }
-        catch (e) {
-            throw (0, types_1.buildError)(e, "TEMPLATE_PROCESSING_ERROR", "Failed to process template files");
-        }
-        // 7. Generate package.json
+        // 5. Process Handlebars templates
+        await (0, fileProcessor_1.processTemplateFiles)(targetDir, templateContext);
+        // 6. Generate package.json
         await (0, configGenerator_1.generatePackageJson)(targetDir, mergedConfig, config);
         if (config.packageManager === "pnpm") {
             await (0, configGenerator_1.generatePnpmWorkspace)(targetDir, mergedConfig.overrides);
         }
-        // 8. Generate environment files
+        // 7. Generate environment files
         await (0, configGenerator_1.generateEnvFile)(targetDir, mergedConfig.envVars);
-        // 9. Install dependencies and initialize git (both optional); a failure
+        // 8. Install dependencies and initialize git (both optional); a failure
         // in either is reported as a warning and does not fail the build
         const depsInstalled = config.installDeps &&
             (0, dependencyInstaller_1.installDependencies)(config.packageManager, targetDir);
         if (config.initGit)
             (0, gitInitializer_1.initializeGitRepository)(targetDir);
         return {
-            success: true,
             projectPath: targetDir,
             nextSteps: (0, nextSteps_1.generateNextSteps)(config, targetDir, depsInstalled),
         };
@@ -80,7 +59,9 @@ async function build(config, targetDir) {
         // Remove the partial project so a retry is not blocked by a non-empty
         // directory; a directory that already existed is emptied, not deleted
         await (didDirectoryExist ? fs_extra_1.default.emptyDir(targetDir) : fs_extra_1.default.remove(targetDir)).catch(() => undefined);
-        throw (0, types_1.buildError)(error, "BUILDING_ERROR", "Building failed");
+        // Errors raised by the build steps already say what failed
+        throw (0, types_1.isBuildError)(error)
+            ? error
+            : (0, types_1.buildError)(error, "BUILDING_ERROR", "Building failed");
     }
 }
-//# sourceMappingURL=index.js.map

package/dist/builder/moduleSelector.js

@@ -19,4 +19,3 @@ function selectModules(config) {
         modules.push(`auth/${framework}`);
     return { base, modules };
 }
-//# sourceMappingURL=moduleSelector.js.map

package/dist/builder/templateContext.js

@@ -1,26 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.lowercase = lowercase;
-exports.uppercase = uppercase;
-exports.kebabCase = kebabCase;
 exports.buildTemplateContext = buildTemplateContext;
 // Context builder for Handlebars, providing variables and helpers for templates
 const types_1 = require("../types");
-// Converts string to lowercase
-function lowercase(str) {
-    return str.toLowerCase();
-}
-// Converts string to uppercase
-function uppercase(str) {
-    return str.toUpperCase();
-}
-// Converts string to kebab-case
-function kebabCase(str) {
-    return str
-        .replace(/([a-z])([A-Z])/g, "$1-$2") // camelCase to kebab-case
-        .replace(/[\s_]+/g, "-") // spaces and underscores to hyphens
-        .toLowerCase();
-}
 function buildTemplateContext(config) {
     return {
         projectName: config.projectName,
@@ -31,9 +13,6 @@ function buildTemplateContext(config) {
         useDocker: config.useDocker,
         useAuth: config.useAuth,
         helpers: {
-            lowercase,
-            uppercase,
-            kebabCase,
             eq: (a, b) => a === b,
             runner: () => {
                 if (config.packageManager === "bun")
@@ -43,4 +22,3 @@ function buildTemplateContext(config) {
         },
     };
 }
-//# sourceMappingURL=templateContext.js.map

package/dist/index.js

@@ -40,10 +40,12 @@ async function main() {
     };
     (0, ui_1.showSummary)(config, targetDir);
     if (args.dryRun) {
+        (0, ui_1.showPlan)(await (0, builder_1.planBuild)(config, targetDir));
         (0, ui_1.info)("Dry run: no files were written.");
         return;
     }
-    if (!args.yes)
+    // Without a terminal nobody can answer, and every option came from a flag
+    if (!args.yes && process.stdin.isTTY)
         await (0, prompts_1.confirmBuild)();
     const result = await (0, builder_1.build)(config, targetDir);
     (0, ui_1.success)("Project created");
@@ -53,7 +55,6 @@ main()
     .then(() => process.exit(0))
     .catch((err) => {
     // Errors raised by the CLI carry a code and a message meant for the user
-    (0, ui_1.error)(err instanceof Error && "code" in err ? err.message : String(err));
+    (0, ui_1.error)((0, types_1.isBuildError)(err) ? err.message : String(err));
     process.exit(1);
 });
-//# sourceMappingURL=index.js.map

package/dist/modules/registry.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getModule = getModule;
 // Module registry for accessing base templates and feature modules
 const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
+const node_path_1 = __importDefault(require("node:path"));
 const zod_1 = require("zod");
 const types_1 = require("../types");
 const moduleConfigSchema = zod_1.z.object({
@@ -19,20 +19,19 @@ const moduleConfigSchema = zod_1.z.object({
     overrides: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).default({}),
     scripts: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).default({}),
     envVars: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).default({}),
-    templateFiles: zod_1.z.array(zod_1.z.string()).default([]),
 });
 // Determines the absolute filesystem path for a given module ID
 function resolveModulePath(id) {
     // Base templates: backend/express, frontend/nextjs
     if (id.startsWith("backend/") || id.startsWith("frontend/")) {
-        return path_1.default.join(__dirname, `../../templates/${id}`);
+        return node_path_1.default.join(__dirname, `../../templates/${id}`);
     }
     // Feature modules: auth/express, prisma/nextjs, docker, mongoose, etc.
-    return path_1.default.join(__dirname, `../../templates/modules/${id}`);
+    return node_path_1.default.join(__dirname, `../../templates/modules/${id}`);
 }
 // Reads and parses a module's config.json file
 async function loadModuleConfig(modulePath) {
-    const configPath = path_1.default.join(modulePath, "config.json");
+    const configPath = node_path_1.default.join(modulePath, "config.json");
     try {
         const configContent = await fs_extra_1.default.readFile(configPath, "utf-8");
         const rawConfig = JSON.parse(configContent);
@@ -58,4 +57,3 @@ async function getModule(id) {
         path: modulePath,
     };
 }
-//# sourceMappingURL=registry.js.map

package/dist/output/nextSteps.js

@@ -21,9 +21,11 @@ function generateNextSteps(config, targetDir, depsInstalled) {
     const steps = [];
     const isFullstack = config.applicationType === "fullstack";
     // Step 1: cd into project directory, unless it was created in place
+    // Quoted when it has spaces, so the command can be pasted as it is
     const relativeDir = node_path_1.default.relative((0, node_process_1.cwd)(), targetDir);
-    if (relativeDir)
-        steps.push(`cd ${relativeDir}`);
+    if (relativeDir) {
+        steps.push(/\s/.test(relativeDir) ? `cd "${relativeDir}"` : `cd ${relativeDir}`);
+    }
     // Step 2: Set environment variables
     if (config.database !== "none") {
         steps.push("Review the generated .env and set your database connection details");
@@ -70,4 +72,3 @@ function generateNextSteps(config, targetDir, depsInstalled) {
     }
     return steps;
 }
-//# sourceMappingURL=nextSteps.js.map

package/dist/prompts/index.js

@@ -32,4 +32,3 @@ async function confirmBuild() {
         process.exit(0);
     }
 }
-//# sourceMappingURL=index.js.map

package/dist/prompts/stack.js

@@ -9,6 +9,10 @@ const ui_1 = require("../ui");
 async function ask(preset, prompt) {
     if (preset !== undefined)
         return preset;
+    // Without a terminal a prompt reads end-of-input and looks like a cancel
+    if (!process.stdin.isTTY) {
+        throw (0, types_1.buildError)("Cannot ask questions without an interactive terminal. Pass --yes, or give every option as a flag (see --help)", "NOT_INTERACTIVE");
+    }
     const answer = await prompt();
     if ((0, core_1.isCancel)(answer)) {
         (0, ui_1.info)("Cancelled. Nothing was created.");
@@ -85,4 +89,3 @@ async function collectStackChoices(preset) {
         installDeps,
     };
 }
-//# sourceMappingURL=stack.js.map