create-carlonicora-app 1.0.0

package/README.md

@@ -0,0 +1,104 @@
+# create-carlonicora-app
+
+CLI tool to scaffold a new NestJS + Next.js monorepo project with Neo4j and JSON:API.
+
+## Usage
+
+### With npx (recommended)
+
+```bash
+npx create-carlonicora-app my-project
+```
+
+### With global installation
+
+```bash
+npm install -g create-carlonicora-app
+create-carlonicora-app my-project
+```
+
+### Options
+
+```bash
+create-carlonicora-app [project-name] [options]
+
+Options:
+  --skip-git       Skip git initialization and submodules
+  --skip-install   Skip dependency installation
+  -V, --version    Output version number
+  -h, --help       Display help
+```
+
+## What's Included
+
+The generated project includes:
+
+- **apps/api** - NestJS 11 backend with:
+  - Fastify HTTP server
+  - Neo4j graph database integration
+  - BullMQ job processing
+  - JWT authentication
+  - JSON:API standard compliance
+  - OpenTelemetry observability
+  - LangChain AI integration
+
+- **apps/web** - Next.js 16 frontend with:
+  - React 19
+  - Tailwind CSS 4
+  - shadcn/ui components
+  - next-intl internationalization
+  - JSON:API client
+
+- **packages/shared** - Shared types and constants
+
+- **Git submodules**:
+  - `@carlonicora/nestjs-neo4jsonapi`
+  - `@carlonicora/nextjs-jsonapi`
+
+## Prerequisites
+
+- Node.js 18+
+- pnpm 10+
+- Git
+
+## After Scaffolding
+
+```bash
+cd my-project
+cp .env.example .env
+# Edit .env with your configuration
+pnpm dev
+```
+
+## Development
+
+### Building the CLI
+
+```bash
+pnpm install
+pnpm build
+```
+
+### Syncing template from source
+
+```bash
+pnpm sync-template
+```
+
+### Testing locally
+
+```bash
+# Build first
+pnpm build
+
+# Test with node directly
+node bin/cli.js test-project
+
+# Or link globally
+npm link
+create-carlonicora-app test-project
+```
+
+## License
+
+GPL-3.0 - See [LICENSE](LICENSE) for details.

package/bin/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import('../dist/cli.js');

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,92 @@
+import { Command } from 'commander';
+import path from 'path';
+import chalk from 'chalk';
+import { validateProjectName } from './utils/validation.js';
+import { directoryExists, directoryIsEmpty } from './utils/files.js';
+import { checkGitInstalled, checkPnpmInstalled } from './git.js';
+import { promptProjectName, promptOverwrite, promptContinueWithoutGit, promptContinueWithoutPnpm, } from './prompts.js';
+import { scaffold } from './scaffold.js';
+const program = new Command();
+program
+    .name('create-carlonicora-app')
+    .description('Create a new NestJS + Next.js monorepo project with Neo4j and JSON:API')
+    .version('1.0.0')
+    .argument('[project-name]', 'Name of the project')
+    .option('--skip-git', 'Skip git initialization and submodules')
+    .option('--skip-install', 'Skip dependency installation')
+    .action(async (projectName, options) => {
+    console.log();
+    console.log(chalk.bold.cyan('create-carlonicora-app'));
+    console.log(chalk.gray('Creating a new NestJS + Next.js monorepo project'));
+    console.log();
+    try {
+        // 1. Get project name (from argument or prompt)
+        let name = projectName;
+        if (!name) {
+            name = await promptProjectName();
+        }
+        else {
+            const validation = validateProjectName(name);
+            if (!validation.valid) {
+                console.error(chalk.red(`Error: ${validation.message}`));
+                process.exit(1);
+            }
+        }
+        // 2. Determine target directory
+        const targetDir = path.resolve(process.cwd(), name);
+        // 3. Check if directory exists and is not empty
+        if (await directoryExists(targetDir)) {
+            if (!(await directoryIsEmpty(targetDir))) {
+                const overwrite = await promptOverwrite(name);
+                if (!overwrite) {
+                    console.log(chalk.yellow('Aborted.'));
+                    process.exit(0);
+                }
+            }
+        }
+        // 4. Check prerequisites
+        let skipGit = options.skipGit ?? false;
+        let skipInstall = options.skipInstall ?? false;
+        if (!skipGit && !checkGitInstalled()) {
+            console.log(chalk.yellow('Warning: Git is not installed.'));
+            const continueWithoutGit = await promptContinueWithoutGit();
+            if (continueWithoutGit) {
+                skipGit = true;
+            }
+            else {
+                console.log(chalk.yellow('Aborted. Please install git first.'));
+                process.exit(0);
+            }
+        }
+        if (!skipInstall && !checkPnpmInstalled()) {
+            console.log(chalk.yellow('Warning: pnpm is not installed.'));
+            const continueWithoutPnpm = await promptContinueWithoutPnpm();
+            if (continueWithoutPnpm) {
+                skipInstall = true;
+            }
+            else {
+                console.log(chalk.yellow('Aborted. Please install pnpm first.'));
+                process.exit(0);
+            }
+        }
+        // 5. Run scaffold
+        await scaffold({
+            projectName: name,
+            targetDir,
+            skipGit,
+            skipInstall,
+        });
+    }
+    catch (error) {
+        console.error();
+        if (error instanceof Error) {
+            console.error(chalk.red('Error:'), error.message);
+        }
+        else {
+            console.error(chalk.red('An unexpected error occurred'));
+        }
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/git.d.ts

@@ -0,0 +1,7 @@
+export declare function initGit(targetDir: string): Promise<void>;
+export declare function addSubmodules(targetDir: string): Promise<void>;
+export declare function installDependencies(targetDir: string): Promise<void>;
+export declare function checkGitInstalled(): boolean;
+export declare function checkPnpmInstalled(): boolean;
+export declare function createInitialCommit(targetDir: string): Promise<void>;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAOA,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCpE;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAO5C;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1E"}

package/dist/git.js

@@ -0,0 +1,80 @@
+import { execSync, exec } from 'child_process';
+import { promisify } from 'util';
+import fs from 'fs-extra';
+import path from 'path';
+const execAsync = promisify(exec);
+export async function initGit(targetDir) {
+    execSync('git init', { cwd: targetDir, stdio: 'pipe' });
+}
+export async function addSubmodules(targetDir) {
+    const submodules = [
+        {
+            path: 'packages/nestjs-neo4jsonapi',
+            url: 'https://github.com/carlonicora/nestjs-neo4jsonapi',
+        },
+        {
+            path: 'packages/nextjs-jsonapi',
+            url: 'https://github.com/carlonicora/nextjs-jsonapi',
+        },
+    ];
+    for (const submodule of submodules) {
+        // Remove placeholder directory if it exists (contains .gitkeep)
+        const submodulePath = path.join(targetDir, submodule.path);
+        if (await fs.pathExists(submodulePath)) {
+            await fs.remove(submodulePath);
+        }
+        try {
+            execSync(`git submodule add ${submodule.url} ${submodule.path}`, {
+                cwd: targetDir,
+                stdio: 'pipe',
+            });
+        }
+        catch (error) {
+            // If submodule already exists, continue
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (!errorMessage.includes('already exists')) {
+                throw error;
+            }
+        }
+    }
+    // Initialize submodules
+    execSync('git submodule update --init --recursive', {
+        cwd: targetDir,
+        stdio: 'pipe',
+    });
+}
+export async function installDependencies(targetDir) {
+    // Use inherit for stdio so user can see the install progress
+    execSync('pnpm install', { cwd: targetDir, stdio: 'inherit' });
+}
+export function checkGitInstalled() {
+    try {
+        execSync('git --version', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function checkPnpmInstalled() {
+    try {
+        execSync('pnpm --version', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function createInitialCommit(targetDir) {
+    try {
+        execSync('git add .', { cwd: targetDir, stdio: 'pipe' });
+        execSync('git commit -m "Initial commit from create-carlonicora-app"', {
+            cwd: targetDir,
+            stdio: 'pipe',
+        });
+    }
+    catch {
+        // Commit might fail if nothing to commit, which is fine
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { scaffold } from './scaffold.js';
+export { validateProjectName, toKebabCase, toPascalCase } from './utils/validation.js';
+export { applyReplacements } from './replacer.js';
+export type { ScaffoldOptions, ReplacementConfig, ValidationResult } from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Main entry point - re-exports for programmatic usage
+export { scaffold } from './scaffold.js';
+export { validateProjectName, toKebabCase, toPascalCase } from './utils/validation.js';
+export { applyReplacements } from './replacer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,5 @@
+export declare function promptProjectName(): Promise<string>;
+export declare function promptOverwrite(dirName: string): Promise<boolean>;
+export declare function promptContinueWithoutGit(): Promise<boolean>;
+export declare function promptContinueWithoutPnpm(): Promise<boolean>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAGA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAQzD;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKvE;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC,CAKjE;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC,CAKlE"}

package/dist/prompts.js

@@ -0,0 +1,30 @@
+import { input, confirm } from '@inquirer/prompts';
+import { validateProjectName } from './utils/validation.js';
+export async function promptProjectName() {
+    return input({
+        message: 'What is your project name?',
+        validate: (value) => {
+            const result = validateProjectName(value);
+            return result.valid || result.message;
+        },
+    });
+}
+export async function promptOverwrite(dirName) {
+    return confirm({
+        message: `Directory "${dirName}" already exists and is not empty. Overwrite?`,
+        default: false,
+    });
+}
+export async function promptContinueWithoutGit() {
+    return confirm({
+        message: 'Git is not installed. Continue without git initialization?',
+        default: true,
+    });
+}
+export async function promptContinueWithoutPnpm() {
+    return confirm({
+        message: 'pnpm is not installed. Continue without dependency installation?',
+        default: true,
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,OAAO,KAAK,CAAC;QACX,OAAO,EAAE,4BAA4B;QACrC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAQ,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,OAAO,OAAO,CAAC;QACb,OAAO,EAAE,cAAc,OAAO,+CAA+C;QAC7E,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,OAAO,OAAO,CAAC;QACb,OAAO,EAAE,4DAA4D;QACrE,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,OAAO,OAAO,CAAC;QACb,OAAO,EAAE,kEAAkE;QAC3E,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/replacer.d.ts

@@ -0,0 +1,9 @@
+import type { ReplacementConfig } from './types/index.js';
+/**
+ * Replaces {{name}} placeholders with the actual project name.
+ *
+ * The template files use {{name}} as a placeholder which gets replaced
+ * with the user's chosen project name during scaffolding.
+ */
+export declare function applyReplacements(content: string, config: ReplacementConfig): string;
+//# sourceMappingURL=replacer.d.ts.map

package/dist/replacer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replacer.d.ts","sourceRoot":"","sources":["../src/replacer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAGpF"}

package/dist/replacer.js

@@ -0,0 +1,11 @@
+/**
+ * Replaces {{name}} placeholders with the actual project name.
+ *
+ * The template files use {{name}} as a placeholder which gets replaced
+ * with the user's chosen project name during scaffolding.
+ */
+export function applyReplacements(content, config) {
+    // Simple replacement of {{name}} placeholder with project name
+    return content.split('{{name}}').join(config.projectNameKebab);
+}
+//# sourceMappingURL=replacer.js.map

package/dist/replacer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replacer.js","sourceRoot":"","sources":["../src/replacer.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAyB;IAC1E,+DAA+D;IAC/D,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACjE,CAAC"}

package/dist/scaffold.d.ts

@@ -0,0 +1,3 @@
+import type { ScaffoldOptions } from './types/index.js';
+export declare function scaffold(options: ScaffoldOptions): Promise<void>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,kBAAkB,CAAC;AAS3E,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EtE"}

package/dist/scaffold.js

@@ -0,0 +1,79 @@
+import path from 'path';
+import fs from 'fs-extra';
+import ora from 'ora';
+import { fileURLToPath } from 'url';
+import { copyTemplate, ensureEmptyDir } from './utils/files.js';
+import { toKebabCase, toPascalCase } from './utils/validation.js';
+import { initGit, addSubmodules, installDependencies, createInitialCommit } from './git.js';
+import { printSuccessMessage } from './utils/logger.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export async function scaffold(options) {
+    const { projectName, targetDir, skipGit, skipInstall } = options;
+    const config = {
+        projectName,
+        projectNameKebab: toKebabCase(projectName),
+        projectNamePascal: toPascalCase(projectName),
+    };
+    const spinner = ora();
+    try {
+        // Step 1: Create/clean target directory
+        spinner.start('Creating project directory...');
+        await ensureEmptyDir(targetDir);
+        spinner.succeed('Created project directory');
+        // Step 2: Copy template files with replacements
+        spinner.start('Copying template files...');
+        const templateDir = path.join(__dirname, '..', 'template');
+        if (!(await fs.pathExists(templateDir))) {
+            spinner.fail('Template directory not found');
+            throw new Error(`Template directory not found at ${templateDir}. ` +
+                'Please run "npm run sync-template" first.');
+        }
+        await copyTemplate(templateDir, targetDir, config);
+        spinner.succeed('Copied template files');
+        // Step 3: Initialize git repository
+        if (!skipGit) {
+            spinner.start('Initializing git repository...');
+            try {
+                await initGit(targetDir);
+                spinner.succeed('Initialized git repository');
+                // Step 4: Add git submodules
+                spinner.start('Adding git submodules (this may take a moment)...');
+                await addSubmodules(targetDir);
+                spinner.succeed('Added git submodules');
+                // Create initial commit
+                spinner.start('Creating initial commit...');
+                await createInitialCommit(targetDir);
+                spinner.succeed('Created initial commit');
+            }
+            catch (error) {
+                spinner.warn('Git initialization skipped (git may not be installed)');
+            }
+        }
+        else {
+            spinner.info('Skipped git initialization');
+        }
+        // Step 5: Install dependencies
+        if (!skipInstall) {
+            spinner.start('Installing dependencies (this may take a few minutes)...');
+            spinner.stopAndPersist({ symbol: '📦', text: 'Installing dependencies...' });
+            try {
+                await installDependencies(targetDir);
+                spinner.succeed('Installed dependencies');
+            }
+            catch (error) {
+                spinner.warn('Dependency installation failed. Run "pnpm install" manually.');
+            }
+        }
+        else {
+            spinner.info('Skipped dependency installation');
+        }
+        // Step 6: Print success message
+        printSuccessMessage(projectName, targetDir);
+    }
+    catch (error) {
+        spinner.fail('Scaffold failed');
+        throw error;
+    }
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+export interface ScaffoldOptions {
+    projectName: string;
+    targetDir: string;
+    skipGit?: boolean;
+    skipInstall?: boolean;
+}
+export interface ReplacementConfig {
+    projectName: string;
+    projectNameKebab: string;
+    projectNamePascal: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    message?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/files.d.ts

@@ -0,0 +1,6 @@
+import type { ReplacementConfig } from '../types/index.js';
+export declare function copyTemplate(srcDir: string, destDir: string, config: ReplacementConfig): Promise<void>;
+export declare function ensureEmptyDir(dir: string): Promise<void>;
+export declare function directoryExists(dir: string): Promise<boolean>;
+export declare function directoryIsEmpty(dir: string): Promise<boolean>;
+//# sourceMappingURL=files.d.ts.map

package/dist/utils/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/utils/files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA0C3D,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAcf;AAuBD,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/D;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpE"}

package/dist/utils/files.js

@@ -0,0 +1,103 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { applyReplacements } from '../replacer.js';
+const BINARY_EXTENSIONS = new Set([
+    // Images
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.ico',
+    '.svg',
+    '.bmp',
+    '.tiff',
+    // Fonts
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.eot',
+    '.otf',
+    // Archives
+    '.tar',
+    '.zip',
+    '.gz',
+    '.rar',
+    '.7z',
+    // Documents
+    '.pdf',
+    // Lock files (treat as binary to avoid corruption)
+    '.lock',
+    // Other binary formats
+    '.exe',
+    '.dll',
+    '.so',
+    '.dylib',
+]);
+function isBinaryFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return BINARY_EXTENSIONS.has(ext);
+}
+export async function copyTemplate(srcDir, destDir, config) {
+    const entries = await fs.readdir(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(srcDir, entry.name);
+        const destPath = path.join(destDir, entry.name);
+        if (entry.isDirectory()) {
+            await fs.ensureDir(destPath);
+            await copyTemplate(srcPath, destPath, config);
+        }
+        else {
+            await copyFile(srcPath, destPath, config);
+        }
+    }
+}
+async function copyFile(srcPath, destPath, config) {
+    if (isBinaryFile(srcPath)) {
+        // Binary file - copy as-is
+        await fs.copy(srcPath, destPath);
+    }
+    else {
+        // Text file - apply replacements
+        try {
+            let content = await fs.readFile(srcPath, 'utf-8');
+            content = applyReplacements(content, config);
+            await fs.writeFile(destPath, content, 'utf-8');
+        }
+        catch (error) {
+            // If reading as text fails, copy as binary
+            await fs.copy(srcPath, destPath);
+        }
+    }
+}
+export async function ensureEmptyDir(dir) {
+    if (await fs.pathExists(dir)) {
+        const files = await fs.readdir(dir);
+        if (files.length > 0) {
+            // Directory exists and is not empty
+            await fs.emptyDir(dir);
+        }
+    }
+    else {
+        await fs.ensureDir(dir);
+    }
+}
+export async function directoryExists(dir) {
+    try {
+        const stat = await fs.stat(dir);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export async function directoryIsEmpty(dir) {
+    try {
+        const files = await fs.readdir(dir);
+        return files.length === 0;
+    }
+    catch {
+        return true;
+    }
+}
+//# sourceMappingURL=files.js.map