spoonfeeder 0.1.0

package/dist/generator/package-json-merger.d.ts

@@ -0,0 +1,6 @@
+export interface PackageJsonFragment {
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}
+export declare function mergePackageJson(base: Record<string, unknown>, fragments: PackageJsonFragment[]): Record<string, unknown>;

package/dist/generator/package-json-merger.js

@@ -0,0 +1,29 @@
+function sortKeys(obj) {
+    return Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
+}
+export function mergePackageJson(base, fragments) {
+    const result = { ...base };
+    let deps = { ...(base.dependencies ?? {}) };
+    let devDeps = {
+        ...(base.devDependencies ?? {}),
+    };
+    let scripts = { ...(base.scripts ?? {}) };
+    for (const fragment of fragments) {
+        if (fragment.dependencies) {
+            deps = { ...deps, ...fragment.dependencies };
+        }
+        if (fragment.devDependencies) {
+            devDeps = { ...devDeps, ...fragment.devDependencies };
+        }
+        if (fragment.scripts) {
+            scripts = { ...scripts, ...fragment.scripts };
+        }
+    }
+    result.dependencies = sortKeys(deps);
+    result.devDependencies = sortKeys(devDeps);
+    if (Object.keys(scripts).length > 0) {
+        result.scripts = sortKeys(scripts);
+    }
+    return result;
+}
+//# sourceMappingURL=package-json-merger.js.map

package/dist/generator/package-json-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json-merger.js","sourceRoot":"","sources":["../../src/generator/package-json-merger.ts"],"names":[],"mappings":"AAMA,SAAS,QAAQ,CAAC,GAA2B;IAC3C,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAA6B,EAC7B,SAAgC;IAEhC,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAE3B,IAAI,IAAI,GAAG,EAAE,GAAG,CAAE,IAAI,CAAC,YAAuC,IAAI,EAAE,CAAC,EAAE,CAAC;IACxE,IAAI,OAAO,GAAG;QACZ,GAAG,CAAE,IAAI,CAAC,eAA0C,IAAI,EAAE,CAAC;KAC5D,CAAC;IACF,IAAI,OAAO,GAAG,EAAE,GAAG,CAAE,IAAI,CAAC,OAAkC,IAAI,EAAE,CAAC,EAAE,CAAC;IAEtE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC1B,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC7B,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;QACxD,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IAED,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/generator/post-generate.d.ts

@@ -0,0 +1 @@
+export declare function runPostGenerate(outputDir: string): Promise<void>;

package/dist/generator/post-generate.js

@@ -0,0 +1,28 @@
+import * as p from '@clack/prompts';
+import { execa } from 'execa';
+export async function runPostGenerate(outputDir) {
+    const s = p.spinner();
+    try {
+        s.start('Installing dependencies...');
+        await execa('pnpm', ['install'], { cwd: outputDir });
+        s.stop('Dependencies installed.');
+    }
+    catch (error) {
+        s.stop('Dependency installation failed.');
+        p.log.warning(`Could not install dependencies: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        s.start('Initializing git repository...');
+        await execa('git', ['init'], { cwd: outputDir });
+        await execa('git', ['add', '.'], { cwd: outputDir });
+        await execa('git', ['commit', '-m', 'chore: initial commit'], {
+            cwd: outputDir,
+        });
+        s.stop('Git repository initialized.');
+    }
+    catch (error) {
+        s.stop('Git initialization failed.');
+        p.log.warning(`Could not initialize git: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=post-generate.js.map

package/dist/generator/post-generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-generate.js","sourceRoot":"","sources":["../../src/generator/post-generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACrD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAEtB,IAAI,CAAC;QACH,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACtC,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC1C,CAAC,CAAC,GAAG,CAAC,OAAO,CACX,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,CAAC,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC1C,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,uBAAuB,CAAC,EAAE;YAC5D,GAAG,EAAE,SAAS;SACf,CAAC,CAAC;QACH,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACrC,CAAC,CAAC,GAAG,CAAC,OAAO,CACX,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/generator/template-engine.d.ts

@@ -0,0 +1,4 @@
+export declare function renderTemplate(template: string, data: Record<string, unknown>, filename?: string): string;
+export declare function renderTemplateFile(templatePath: string, data: Record<string, unknown>): Promise<string>;
+export declare function renderAndWrite(templatePath: string, outputPath: string, data: Record<string, unknown>): Promise<void>;
+export declare function copyStatic(sourcePath: string, outputPath: string): Promise<void>;

package/dist/generator/template-engine.js

@@ -0,0 +1,20 @@
+import ejs from 'ejs';
+import path from 'node:path';
+import fs from 'fs-extra';
+export function renderTemplate(template, data, filename) {
+    return ejs.render(template, data, { filename });
+}
+export async function renderTemplateFile(templatePath, data) {
+    const template = await fs.readFile(templatePath, 'utf-8');
+    return renderTemplate(template, data, templatePath);
+}
+export async function renderAndWrite(templatePath, outputPath, data) {
+    const rendered = await renderTemplateFile(templatePath, data);
+    await fs.ensureDir(path.dirname(outputPath));
+    await fs.writeFile(outputPath, rendered, 'utf-8');
+}
+export async function copyStatic(sourcePath, outputPath) {
+    await fs.ensureDir(path.dirname(outputPath));
+    await fs.copy(sourcePath, outputPath);
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/generator/template-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../src/generator/template-engine.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,IAA6B,EAC7B,QAAiB;IAEjB,OAAO,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAAoB,EACpB,IAA6B;IAE7B,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC1D,OAAO,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAAoB,EACpB,UAAkB,EAClB,IAA6B;IAE7B,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB,EAAE,UAAkB;IACrE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC"}

package/dist/generators/add-recipe/generator.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+import type { AddRecipeGeneratorSchema } from './schema.js';
+export default function addRecipeGenerator(tree: Tree, options: AddRecipeGeneratorSchema): Promise<void>;

package/dist/generators/add-recipe/generator.js

@@ -0,0 +1,153 @@
+import { formatFiles, updateJson, logger } from '@nx/devkit';
+import { RecipeRegistry } from '../../recipes/registry.js';
+import { registerAllRecipes } from '../../recipes/definitions.js';
+import { detectConflicts } from '../../validation/conflict-detector.js';
+import { addModuleImportToString } from '../../utils/module-updater.js';
+import { insertBlockToString } from '../../utils/main-ts-updater.js';
+export default async function addRecipeGenerator(tree, options) {
+    const registry = new RecipeRegistry();
+    registerAllRecipes(registry);
+    const recipeId = options.recipe;
+    const recipe = registry.get(recipeId);
+    if (!recipe) {
+        throw new Error(`Recipe '${recipeId}' not found. Run 'nx g spoonfeeder:list' to see available recipes.`);
+    }
+    // Read manifest
+    const manifestPath = '.spoonfeeder.json';
+    if (!tree.exists(manifestPath)) {
+        throw new Error('.spoonfeeder.json not found. Is this a spoonfeeder-generated project?');
+    }
+    const manifest = JSON.parse(tree.read(manifestPath, 'utf-8'));
+    // Check if already installed
+    if (manifest.recipes[recipeId]) {
+        logger.warn(`Recipe '${recipeId}' is already installed.`);
+        return;
+    }
+    // Validate compatibility
+    if (recipe.compatibleWith !== 'all' &&
+        !recipe.compatibleWith.includes(manifest.projectType)) {
+        throw new Error(`Recipe '${recipe.name}' is not compatible with project type '${manifest.projectType}'.`);
+    }
+    // Check conflicts
+    const installedIds = Object.keys(manifest.recipes);
+    const allIds = [...installedIds, recipeId];
+    const allRecipes = allIds.map((id) => registry.get(id)).filter(Boolean);
+    const conflicts = detectConflicts(allIds, allRecipes);
+    const mutualExclusions = conflicts.filter((c) => c.type === 'mutual-exclusion');
+    if (mutualExclusions.length > 0) {
+        throw new Error(`Conflict: ${mutualExclusions.map((c) => c.message).join('; ')}`);
+    }
+    // Check requirements
+    const missingReqs = conflicts.filter((c) => c.type === 'missing-requirement');
+    if (missingReqs.length > 0) {
+        throw new Error(`Missing requirements: ${missingReqs.map((c) => c.message).join('; ')}`);
+    }
+    // 1. Add dependencies to package.json
+    if (!tree.exists('package.json')) {
+        throw new Error('package.json not found. Is this a valid project?');
+    }
+    if (Object.keys(recipe.dependencies).length > 0 ||
+        Object.keys(recipe.devDependencies).length > 0) {
+        updateJson(tree, 'package.json', (json) => {
+            json.dependencies = { ...json.dependencies, ...recipe.dependencies };
+            json.devDependencies = { ...json.devDependencies, ...recipe.devDependencies };
+            // Sort alphabetically
+            json.dependencies = Object.fromEntries(Object.entries(json.dependencies).sort(([a], [b]) => a.localeCompare(b)));
+            json.devDependencies = Object.fromEntries(Object.entries(json.devDependencies).sort(([a], [b]) => a.localeCompare(b)));
+            return json;
+        });
+    }
+    // 2. Copy recipe template files
+    // Note: In Phase 1, template file copying is handled externally.
+    // Phase 2 adds full AST transforms and template copying via generateFiles.
+    const copiedFiles = [];
+    // Note: In Phase 1, we copy files manually since generateFiles expects a specific structure.
+    // Template files from the recipe dir are copied into the project root.
+    // Files named README.md and package-fragment.json are skipped.
+    // 2a. Add module import to app.module.ts (if recipe defines moduleImport)
+    if (recipe.moduleImport) {
+        const appModulePath = 'src/app.module.ts';
+        if (tree.exists(appModulePath)) {
+            const content = tree.read(appModulePath, 'utf-8');
+            const transformed = addModuleImportToString(content, recipe.moduleImport.moduleName, recipe.moduleImport.importPath);
+            tree.write(appModulePath, transformed);
+            logger.info(`  Added ${recipe.moduleImport.moduleName} to app.module.ts`);
+        }
+    }
+    // 2b. Insert main.ts blocks (if recipe defines mainTsSetup)
+    if (recipe.mainTsSetup) {
+        const mainTsPath = 'src/main.ts';
+        if (tree.exists(mainTsPath)) {
+            const content = tree.read(mainTsPath, 'utf-8');
+            const transformed = insertBlockToString(content, recipe.mainTsSetup.blockId, recipe.mainTsSetup.block);
+            tree.write(mainTsPath, transformed);
+            logger.info(`  Inserted ${recipe.mainTsSetup.blockId} block into main.ts`);
+        }
+    }
+    // 3. Add env vars
+    if (recipe.envVars.length > 0) {
+        const envPath = '.env.example';
+        if (tree.exists(envPath)) {
+            let envContent = tree.read(envPath, 'utf-8');
+            const sectionMarker = `# --- ${recipe.name} ---`;
+            if (!envContent.includes(sectionMarker)) {
+                const section = [
+                    '',
+                    sectionMarker,
+                    ...recipe.envVars.map((v) => `# ${v.description}\n${v.key}=${v.defaultValue}`),
+                    `# --- end ${recipe.name} ---`,
+                    '',
+                ].join('\n');
+                envContent = envContent.trimEnd() + '\n' + section;
+                tree.write(envPath, envContent);
+            }
+        }
+    }
+    // 4. Update AI context
+    if (recipe.claudeMdSection) {
+        const claudePath = 'CLAUDE.md';
+        if (tree.exists(claudePath)) {
+            let content = tree.read(claudePath, 'utf-8');
+            const marker = `<!-- @spoonfeeder:${recipeId} -->`;
+            if (!content.includes(marker)) {
+                content += `\n${marker}\n${recipe.claudeMdSection}\n<!-- @spoonfeeder:end:${recipeId} -->\n`;
+                tree.write(claudePath, content);
+            }
+        }
+    }
+    if (recipe.copilotInstructions) {
+        const copilotPath = '.github/copilot-instructions.md';
+        if (tree.exists(copilotPath)) {
+            let content = tree.read(copilotPath, 'utf-8');
+            const marker = `<!-- @spoonfeeder:${recipeId} -->`;
+            if (!content.includes(marker)) {
+                content += `\n${marker}\n${recipe.copilotInstructions}\n<!-- @spoonfeeder:end:${recipeId} -->\n`;
+                tree.write(copilotPath, content);
+            }
+        }
+    }
+    if (recipe.cursorRules) {
+        const cursorRulePath = `.cursor/rules/${recipeId}.mdc`;
+        if (!tree.exists(cursorRulePath)) {
+            tree.write(cursorRulePath, recipe.cursorRules);
+        }
+    }
+    // 5. Update manifest
+    updateJson(tree, manifestPath, (json) => {
+        json.recipes[recipeId] = {
+            installedAt: new Date().toISOString(),
+            version: json.spoonfeederVersion ?? '0.0.1',
+            files: copiedFiles,
+            ...(recipe.moduleImport && { moduleImport: recipe.moduleImport }),
+            ...(recipe.mainTsSetup && { mainTsBlocks: [recipe.mainTsSetup.blockId] }),
+            ...(recipe.envVars.length > 0 && { envSection: recipe.name }),
+        };
+        return json;
+    });
+    await formatFiles(tree);
+    logger.info(`Recipe '${recipe.name}' added successfully.`);
+    if (!options.skipInstall) {
+        logger.info('Run `pnpm install` to install new dependencies.');
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/generators/add-recipe/generator.js.map

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

package/dist/generators/list-recipes/generator.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+import type { ListRecipesGeneratorSchema } from './schema.js';
+export default function listRecipesGenerator(tree: Tree, options: ListRecipesGeneratorSchema): void;

package/dist/generators/list-recipes/generator.js

@@ -0,0 +1,58 @@
+import { logger } from '@nx/devkit';
+import { RecipeRegistry } from '../../recipes/registry.js';
+import { registerAllRecipes } from '../../recipes/definitions.js';
+export default function listRecipesGenerator(tree, options) {
+    const registry = new RecipeRegistry();
+    registerAllRecipes(registry);
+    // Read manifest
+    const manifestPath = '.spoonfeeder.json';
+    const manifest = tree.exists(manifestPath)
+        ? JSON.parse(tree.read(manifestPath, 'utf-8'))
+        : null;
+    const installedIds = manifest ? Object.keys(manifest.recipes) : [];
+    const allRecipes = options.category
+        ? registry.getByCategory(options.category)
+        : registry.getAll();
+    if (options.json) {
+        const output = {
+            projectType: manifest?.projectType ?? 'unknown',
+            cloudProvider: manifest?.cloudProvider ?? 'unknown',
+            installed: installedIds,
+            available: allRecipes
+                .filter((r) => !installedIds.includes(r.id))
+                .map((r) => ({
+                id: r.id,
+                name: r.name,
+                category: r.category,
+                conflicts: r.conflicts,
+            })),
+        };
+        logger.info(JSON.stringify(output, null, 2));
+        return;
+    }
+    // Human-readable output
+    if (manifest) {
+        logger.info(`\nProject: ${manifest.projectType} (${manifest.cloudProvider})\n`);
+    }
+    if (installedIds.length > 0) {
+        logger.info(`Installed (${installedIds.length}):`);
+        for (const id of installedIds) {
+            const recipe = registry.get(id);
+            logger.info(`  ${id.padEnd(25)} ${recipe?.description ?? ''}`);
+        }
+        logger.info('');
+    }
+    const available = allRecipes.filter((r) => !installedIds.includes(r.id));
+    logger.info(`Available (${available.length}):`);
+    for (const recipe of available.slice(0, 20)) {
+        const conflictNote = recipe.conflicts.some((c) => installedIds.includes(c))
+            ? ` (conflicts: ${recipe.conflicts.filter((c) => installedIds.includes(c)).join(', ')})`
+            : '';
+        logger.info(`  ${recipe.id.padEnd(25)} ${recipe.description}${conflictNote}`);
+    }
+    if (available.length > 20) {
+        logger.info(`  ... and ${available.length - 20} more`);
+    }
+    logger.info('\nUse: nx g spoonfeeder:add <recipe>');
+}
+//# sourceMappingURL=generator.js.map

package/dist/generators/list-recipes/generator.js.map

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

package/dist/generators/migrate-recipe/generator.d.ts

@@ -0,0 +1,9 @@
+import { Tree } from '@nx/devkit';
+import type { MigrateRecipeGeneratorSchema } from './schema.js';
+import { RecipeRegistry } from '../../recipes/registry.js';
+import type { RecipeDefinition } from '../../types.js';
+export declare function validateMigrationPair(registry: RecipeRegistry, fromId: string, toId: string, installedRecipeIds: string[]): {
+    fromRecipe: RecipeDefinition;
+    toRecipe: RecipeDefinition;
+};
+export default function migrateRecipeGenerator(tree: Tree, options: MigrateRecipeGeneratorSchema): Promise<void>;

package/dist/generators/migrate-recipe/generator.js

@@ -0,0 +1,90 @@
+import { logger } from '@nx/devkit';
+import { RecipeRegistry } from '../../recipes/registry.js';
+import { registerAllRecipes } from '../../recipes/definitions.js';
+import { findDependents } from '../../utils/dependency-checker.js';
+import removeRecipeGenerator from '../remove-recipe/generator.js';
+import addRecipeGenerator from '../add-recipe/generator.js';
+import { getMigrationGuidance } from './migration-guidance.js';
+export function validateMigrationPair(registry, fromId, toId, installedRecipeIds) {
+    const fromRecipe = registry.get(fromId);
+    if (!fromRecipe) {
+        throw new Error(`Recipe '${fromId}' not found in the registry.`);
+    }
+    const toRecipe = registry.get(toId);
+    if (!toRecipe) {
+        throw new Error(`Recipe '${toId}' not found in the registry.`);
+    }
+    if (fromId === toId) {
+        throw new Error('Cannot migrate a recipe to itself.');
+    }
+    if (!installedRecipeIds.includes(fromId)) {
+        throw new Error(`Recipe '${fromId}' is not installed. Cannot migrate from a recipe that is not present.`);
+    }
+    if (installedRecipeIds.includes(toId)) {
+        throw new Error(`Recipe '${toId}' is already installed. Cannot migrate to a recipe that is already present.`);
+    }
+    if (fromRecipe.category !== toRecipe.category) {
+        throw new Error(`Cannot migrate between different categories: '${fromRecipe.name}' is in '${fromRecipe.category}' but '${toRecipe.name}' is in '${toRecipe.category}'. Migration is only allowed within the same category.`);
+    }
+    return { fromRecipe, toRecipe };
+}
+export default async function migrateRecipeGenerator(tree, options) {
+    const registry = new RecipeRegistry();
+    registerAllRecipes(registry);
+    // Read manifest
+    const manifestPath = '.spoonfeeder.json';
+    if (!tree.exists(manifestPath)) {
+        throw new Error('.spoonfeeder.json not found. Is this a spoonfeeder-generated project?');
+    }
+    const manifest = JSON.parse(tree.read(manifestPath, 'utf-8'));
+    const installedRecipeIds = Object.keys(manifest.recipes);
+    // Validate the migration pair
+    const { fromRecipe, toRecipe } = validateMigrationPair(registry, options.from, options.to, installedRecipeIds);
+    // Check if any installed recipes depend on the 'from' recipe
+    const allInstalledRecipes = installedRecipeIds
+        .map((id) => registry.get(id))
+        .filter(Boolean);
+    const dependents = findDependents(options.from, installedRecipeIds, allInstalledRecipes);
+    if (dependents.length > 0) {
+        // Check if the 'to' recipe satisfies the dependency (i.e. dependents require 'from' but 'to' could replace it)
+        const toRecipeId = options.to;
+        const unsatisfiedDependents = dependents.filter((dep) => {
+            const depRecipe = registry.get(dep.recipeId);
+            // The dependent is unsatisfied if it requires the 'from' recipe and the 'to' recipe does not satisfy it
+            return !depRecipe?.requires.includes(toRecipeId);
+        });
+        if (unsatisfiedDependents.length > 0) {
+            const names = unsatisfiedDependents.map((d) => `'${d.recipeName}' (${d.recipeId})`).join(', ');
+            throw new Error(`Cannot migrate from '${options.from}' to '${options.to}': the following installed recipes depend on '${options.from}': ${names}. Remove or migrate those recipes first.`);
+        }
+    }
+    logger.info(`Migrating from '${fromRecipe.name}' to '${toRecipe.name}'...`);
+    logger.info('');
+    // Step 1: Remove the old recipe
+    logger.info(`Step 1/2: Removing '${fromRecipe.name}'...`);
+    await removeRecipeGenerator(tree, {
+        recipe: options.from,
+        force: true,
+    });
+    // Step 2: Add the new recipe
+    logger.info(`Step 2/2: Adding '${toRecipe.name}'...`);
+    await addRecipeGenerator(tree, {
+        recipe: options.to,
+        skipInstall: false,
+    });
+    // Step 3: Print migration guidance
+    logger.info('');
+    logger.info('\u2501'.repeat(70));
+    logger.info('  MIGRATION GUIDANCE');
+    logger.info('\u2501'.repeat(70));
+    logger.info('');
+    const guidance = getMigrationGuidance(options.from, options.to, fromRecipe.category);
+    for (const line of guidance) {
+        logger.info(`  ${line}`);
+    }
+    logger.info('');
+    logger.info('\u2501'.repeat(70));
+    logger.info('');
+    logger.info(`Migration from '${fromRecipe.name}' to '${toRecipe.name}' complete.`);
+}
+//# sourceMappingURL=generator.js.map

package/dist/generators/migrate-recipe/generator.js.map

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

package/dist/generators/migrate-recipe/migration-guidance.d.ts

@@ -0,0 +1 @@
+export declare function getMigrationGuidance(fromId: string, toId: string, category: string): string[];

package/dist/generators/migrate-recipe/migration-guidance.js

@@ -0,0 +1,159 @@
+/**
+ * Migration guidance messages keyed by "fromId→toId".
+ *
+ * When a specific pair has no entry, the generator falls back to a
+ * category-level generic message. Add new entries here as recipes
+ * are added to the registry.
+ */
+const PAIR_GUIDANCE = {
+    'typeorm-postgres→drizzle-postgres': [
+        'Migration from TypeORM to Drizzle requires manual schema conversion:',
+        '',
+        '1. Convert TypeORM entity classes to Drizzle table definitions.',
+        '   - TypeORM @Entity / @Column decorators → Drizzle pgTable() + column helpers.',
+        '   - Move files from src/<module>/entities/ → src/infrastructure/database/schema/.',
+        '',
+        '2. Replace repository injection with Drizzle query builder.',
+        '   - TypeORM @InjectRepository(User) → inject the `db` instance from DrizzleModule.',
+        '   - Rewrite queries: repo.find({ where: { id } }) → db.select().from(users).where(eq(users.id, id)).',
+        '',
+        '3. Regenerate migrations from scratch.',
+        '   - Delete old TypeORM migrations in src/infrastructure/database/migrations/.',
+        '   - Run: pnpm drizzle:generate && pnpm drizzle:migrate.',
+        '',
+        '4. Update .env — the connection variable changes from DB_HOST/DB_PORT/etc to DATABASE_URL.',
+        '',
+        'See docs/recipes/database.md for full migration guides.',
+    ],
+    'typeorm-mysql→drizzle-postgres': [
+        'Migration from TypeORM (MySQL) to Drizzle (PostgreSQL) is a combined ORM + database engine change:',
+        '',
+        '1. All TypeORM entity classes must be converted to Drizzle pgTable() definitions.',
+        '2. MySQL-specific column types (e.g., TINYINT for booleans) need PostgreSQL equivalents.',
+        '3. Export your data from MySQL and import into PostgreSQL.',
+        '4. Replace repository injection with Drizzle query builder (see typeorm→drizzle guidance).',
+        '5. Regenerate all migrations: pnpm drizzle:generate && pnpm drizzle:migrate.',
+        '6. Update .env — DB_HOST/DB_PORT/etc → DATABASE_URL (PostgreSQL connection string).',
+        '',
+        'See docs/recipes/database.md for full migration guides.',
+    ],
+    'typeorm-postgres→prisma': [
+        'Migration from TypeORM to Prisma requires a schema-first approach:',
+        '',
+        '1. Introspect your existing database to generate a Prisma schema:',
+        '   npx prisma db pull',
+        '',
+        '2. Replace @InjectRepository() with PrismaService injection.',
+        '   - Rewrite queries: repo.find() → prisma.user.findMany().',
+        '',
+        '3. Remove old TypeORM entity files and migration directory.',
+        '4. Run: npx prisma generate to create the type-safe client.',
+        '',
+        'See docs/recipes/database.md for full migration guides.',
+    ],
+    'prisma→drizzle-postgres': [
+        'Migration from Prisma to Drizzle:',
+        '',
+        '1. Convert Prisma schema (schema.prisma) to Drizzle table definitions (pgTable).',
+        '2. Replace PrismaService with Drizzle db instance injection.',
+        '3. Rewrite queries: prisma.user.findMany() → db.select().from(users).',
+        '4. Remove prisma/ directory and regenerate migrations with drizzle-kit.',
+        '',
+        'See docs/recipes/database.md for full migration guides.',
+    ],
+    'pino→winston': [
+        'Migration from Pino to Winston:',
+        '',
+        '1. Replace Pino-specific configuration with Winston transports and formats.',
+        '2. Update any pino.child() calls to winston.child() or createLogger().',
+        '3. Winston uses different log level names by default — verify your log levels.',
+        '4. If using pino-http, replace with express-winston or manual Winston middleware.',
+        '',
+        'See docs/recipes/logging.md for details.',
+    ],
+    'winston→pino': [
+        'Migration from Winston to Pino:',
+        '',
+        '1. Replace Winston transports/formats with Pino options and pino-pretty for dev.',
+        '2. Pino uses structured JSON by default — adjust log consumers if needed.',
+        '3. Replace winston.child() with pino.child() for request-scoped logging.',
+        '4. Install pino-http for automatic HTTP request logging.',
+        '',
+        'See docs/recipes/logging.md for details.',
+    ],
+};
+/**
+ * Category-level fallback guidance when no specific pair guidance exists.
+ */
+const CATEGORY_GUIDANCE = {
+    Database: [
+        'You are migrating between database recipes. Manual steps required:',
+        '',
+        '1. Convert entity/model definitions to the new ORM format.',
+        '2. Rewrite repository/query code to use the new ORM API.',
+        '3. Regenerate or recreate database migrations.',
+        '4. Update environment variables if the connection format changed.',
+        '5. Verify all database tests pass with the new ORM.',
+        '',
+        'Check docs/recipes/database.md for ORM-specific migration guides.',
+    ],
+    Logging: [
+        'You are migrating between logging recipes. Manual steps required:',
+        '',
+        '1. Update logger configuration to the new library format.',
+        '2. Replace any library-specific logger API calls.',
+        '3. Verify log output format matches your log aggregation pipeline.',
+        '',
+        'Check docs/recipes/logging.md for details.',
+    ],
+    Authentication: [
+        'You are migrating between authentication recipes. Manual steps required:',
+        '',
+        '1. Update auth guards and strategy configuration.',
+        '2. Migrate user session/token handling to the new auth approach.',
+        '3. Update any middleware or interceptors that depend on auth state.',
+        '4. Re-test all protected endpoints.',
+        '',
+        'Check docs/recipes/authentication.md for details.',
+    ],
+    'Cloud Storage': [
+        'You are migrating between cloud storage recipes. Manual steps required:',
+        '',
+        '1. Update SDK imports and client configuration.',
+        '2. Rewrite upload/download/delete operations to the new SDK API.',
+        '3. Update IAM/credential configuration for the new provider.',
+        '4. Migrate existing stored objects if changing providers.',
+        '',
+        'Check docs/recipes/cloud-storage.md for details.',
+    ],
+    'Message Queue': [
+        'You are migrating between message queue recipes. Manual steps required:',
+        '',
+        '1. Update consumer/producer code to the new transport API.',
+        '2. Recreate queue/topic/exchange definitions for the new broker.',
+        '3. Update environment variables for the new connection.',
+        '4. Verify message serialization/deserialization works correctly.',
+        '',
+        'Check docs/recipes/messaging.md for details.',
+    ],
+};
+const GENERIC_GUIDANCE = [
+    'Migration complete. The old recipe has been removed and the new recipe has been added.',
+    '',
+    'Manual steps may be required:',
+    '1. Review the diff to understand what files changed.',
+    '2. Update any code that imported from the old recipe modules.',
+    '3. Run the full test suite to catch breaking changes.',
+    '4. Update environment variables if needed.',
+];
+export function getMigrationGuidance(fromId, toId, category) {
+    const pairKey = `${fromId}\u2192${toId}`;
+    if (PAIR_GUIDANCE[pairKey]) {
+        return PAIR_GUIDANCE[pairKey];
+    }
+    if (CATEGORY_GUIDANCE[category]) {
+        return CATEGORY_GUIDANCE[category];
+    }
+    return GENERIC_GUIDANCE;
+}
+//# sourceMappingURL=migration-guidance.js.map

package/dist/generators/migrate-recipe/migration-guidance.js.map

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