@codeyam/codeyam-cli 0.1.0-staging.8aea589 → 0.1.0-staging.8df382d

package/codeyam-cli/src/commands/baseline.js

@@ -0,0 +1,176 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as readline from 'readline';
+import { error, header, info, ProgressReporter, success, warn, withoutSpinner, } from "../utils/progress.js";
+import { testEnvironment, requireBranchAndProject, createBaselineCommit, } from "../utils/database.js";
+import { getWipeStats, wipeProject, formatWipeStats, hasExistingAnalyses, } from "../utils/wipe.js";
+import { checkGitClean, getHeadSha, isGitRepo } from "../utils/git.js";
+import { getProjectRoot } from "../state.js";
+import { startBackgroundServer } from "../utils/backgroundServer.js";
+import { requireSimulations } from "../utils/requireSimulations.js";
+/**
+ * Prompt user for confirmation.
+ */
+async function confirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(`${message} [y/N] `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+    });
+}
+const baselineCommand = {
+    command: 'baseline',
+    describe: 'Run a complete baseline analysis of all entities in the repository',
+    builder: {
+        yes: {
+            type: 'boolean',
+            alias: 'y',
+            describe: 'Skip confirmation prompts',
+            default: false,
+        },
+    },
+    handler: async (argv) => {
+        requireSimulations();
+        header('CodeYam Baseline');
+        const progress = new ProgressReporter();
+        // Find project root directory
+        const projectRoot = getProjectRoot();
+        if (!projectRoot) {
+            error('Not in a CodeYam project. Run: codeyam init');
+            return;
+        }
+        const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+        try {
+            // Check if we're in a git repo
+            if (!isGitRepo(projectRoot)) {
+                error('Not in a git repository. Baseline requires a git repository.');
+                return;
+            }
+            // Check git status - require clean working directory
+            progress.start('Checking git status...');
+            const gitStatus = checkGitClean(projectRoot);
+            if (!gitStatus.clean) {
+                progress.fail('Uncommitted changes detected');
+                console.log();
+                error('Baseline requires a clean git state.');
+                console.log();
+                info('Uncommitted files:');
+                for (const file of gitStatus.files.slice(0, 10)) {
+                    info(`  ${file}`);
+                }
+                if (gitStatus.files.length > 10) {
+                    info(`  ... and ${gitStatus.files.length - 10} more`);
+                }
+                console.log();
+                info('Options:');
+                info('  • Commit your changes: git commit -am "WIP"');
+                info('  • Stash your changes: git stash');
+                info('  • Or run regular analysis: codeyam analyze <files>');
+                return;
+            }
+            progress.succeed('Git working directory is clean');
+            // Get the real HEAD SHA
+            const headSha = getHeadSha(projectRoot);
+            info(`HEAD commit: ${headSha.substring(0, 8)}`);
+            // Load project configuration
+            progress.start('Loading project configuration...');
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            const { projectSlug } = config;
+            if (!projectSlug) {
+                progress.fail('Invalid project configuration');
+                error('Missing project slug. Try reinitializing with: codeyam init --force');
+                return;
+            }
+            progress.succeed('Loaded project configuration');
+            // Test database connection
+            progress.start('Validating environment...');
+            const connectionOk = await withoutSpinner(() => testEnvironment());
+            if (!connectionOk) {
+                progress.fail('Environment validation failed');
+                return;
+            }
+            progress.succeed('Environment validated');
+            // Load project and branch
+            progress.start('Loading project...');
+            const { project, branch } = await requireBranchAndProject(projectSlug);
+            progress.succeed('Project loaded');
+            // Check for existing analyses
+            progress.start('Checking for existing analyses...');
+            const hasAnalyses = await hasExistingAnalyses(project.id);
+            progress.succeed('Analysis check complete');
+            if (hasAnalyses) {
+                const stats = await getWipeStats(project.id);
+                console.log();
+                warn('⚠️  Existing analyses found:');
+                console.log(formatWipeStats(stats));
+                console.log();
+                info('Running baseline will wipe all existing data and start fresh.');
+                console.log();
+                if (!argv.yes) {
+                    const confirmed = await confirm('Continue?');
+                    if (!confirmed) {
+                        info('Baseline cancelled');
+                        return;
+                    }
+                }
+                console.log();
+                // Execute wipe
+                progress.start('Wiping existing data...');
+                await wipeProject(project.id);
+                progress.succeed('Existing data wiped');
+            }
+            // Create baseline commit using real git SHA
+            progress.start('Creating baseline commit...');
+            const baselineCommit = await createBaselineCommit(project, branch, headSha);
+            progress.succeed(`Baseline commit created: ${headSha.substring(0, 8)}`);
+            // Start background server if not running (also handles version mismatch detection)
+            const { wasAlreadyRunning } = await startBackgroundServer({
+                port: 3111,
+                rootPath: projectRoot,
+                project,
+                branch,
+            });
+            if (!wasAlreadyRunning) {
+                progress.succeed('Background server started');
+            }
+            // Enqueue baseline job via HTTP
+            progress.start('Enqueuing baseline job...');
+            const response = await fetch('http://localhost:3111/api/queue', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    action: 'enqueue',
+                    type: 'baseline',
+                    projectSlug,
+                    commitSha: headSha,
+                }),
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                throw new Error(`Failed to enqueue baseline job: ${text}`);
+            }
+            const result = await response.json();
+            progress.succeed('Baseline job enqueued');
+            console.log();
+            success('Baseline analysis started!');
+            console.log();
+            info('This may take a while depending on repository size.');
+            info('Monitor progress at: http://localhost:3111');
+            console.log();
+            info(`Job ID: ${result.jobId}`);
+            info('Run "codeyam status" to check progress');
+        }
+        catch (err) {
+            progress.fail('Baseline failed');
+            error(err.message);
+            process.exit(1);
+        }
+    },
+};
+export default baselineCommand;
+//# sourceMappingURL=baseline.js.map

package/codeyam-cli/src/commands/baseline.js.map

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

package/codeyam-cli/src/commands/debug.js

@@ -0,0 +1,253 @@
+import * as path from 'path';
+import * as fs from 'fs';
+import { error, header, info, success } from "../utils/progress.js";
+import { getProjectRoot } from "../state.js";
+import { initializeEnvironment, requireBranchAndProject, } from "../utils/database.js";
+import { getDatabase, loadAnalysis, updateFreshAnalysisStatus, } from "../../../packages/database/index.js";
+import { getWebappInfo, safeFileName, isFrameworkRoute, frameworkRouteFileNameToRoute, } from "../../../packages/utils/index.js";
+import getFrameworkForFile from "../../../packages/utils/src/lib/getFrameworkForFile.js";
+import { startBackgroundServer } from "../utils/backgroundServer.js";
+import { ensureFreshAnalyzer, resetProject } from "../utils/analyzer.js";
+import { getLogPath, getProjectPath } from "../utils/sandbox.js";
+import { requireSimulations } from "../utils/requireSimulations.js";
+const debugCommand = {
+    command: 'debug <id>',
+    describe: 'Setup debug environment for a specific analysis or scenario (auto-detects ID type)',
+    builder: {
+        id: {
+            type: 'string',
+            describe: 'The analysis ID or scenario ID to debug',
+            demandOption: true,
+        },
+    },
+    handler: async (argv) => {
+        requireSimulations();
+        header('CodeYam Debug Setup');
+        const { id } = argv;
+        let analysisId;
+        let scenarioId;
+        // Find project root directory
+        const projectRoot = getProjectRoot();
+        if (!projectRoot) {
+            error('Not in a CodeYam project. Run: codeyam init');
+            return;
+        }
+        try {
+            await initializeEnvironment();
+            // Auto-detect whether the ID is a scenario or analysis
+            info(`Detecting ID type for ${id}...`);
+            const db = getDatabase();
+            // First check if it's a scenario ID
+            const scenarioRow = await db
+                .selectFrom('scenarios')
+                .select(['id', 'analysis_id'])
+                .where('id', '=', id)
+                .executeTakeFirst();
+            if (scenarioRow) {
+                scenarioId = id;
+                analysisId = scenarioRow.analysis_id;
+                info(`Found scenario, using analysis ${analysisId}`);
+            }
+            else {
+                // Check if it's an analysis ID
+                const analysisRow = await db
+                    .selectFrom('analyses')
+                    .select(['id'])
+                    .where('id', '=', id)
+                    .executeTakeFirst();
+                if (analysisRow) {
+                    analysisId = id;
+                    info(`Found analysis ${analysisId}`);
+                }
+                else {
+                    error(`ID ${id} not found as either a scenario or analysis`);
+                    return;
+                }
+            }
+            // Load the analysis
+            info(`Loading analysis ${analysisId}...`);
+            const analysis = await loadAnalysis({
+                id: analysisId,
+                includeScenarios: true,
+                includeCommitAndBranch: true,
+                includeFile: true,
+            });
+            if (!analysis) {
+                error(`Analysis ${analysisId} not found`);
+                return;
+            }
+            if (!analysis.commit) {
+                error(`Commit not found for analysis ${analysisId}`);
+                return;
+            }
+            info(`Found analysis for entity: ${analysis.entityName}`);
+            info(`File: ${analysis.filePath}`);
+            // Get project configuration
+            const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            const { projectSlug } = config;
+            if (!projectSlug) {
+                error('Project slug not found in config');
+                return;
+            }
+            // Reset project cache to ensure clean state (no leftover mocks from setup-sandbox)
+            info('Resetting project cache...');
+            await resetProject(projectSlug);
+            // Ensure analyzer is up-to-date before debug setup
+            info('Checking analyzer...');
+            await ensureFreshAnalyzer(projectSlug, {
+                update: (message) => info(message),
+            });
+            // Clear log file before starting debug setup
+            const logPath = getLogPath(projectSlug);
+            try {
+                fs.writeFileSync(logPath, '', 'utf8');
+            }
+            catch {
+                // Log file might not exist yet, that's fine
+            }
+            const { project, branch } = await requireBranchAndProject(projectSlug);
+            const packageManager = project.metadata?.packageManager || 'npm';
+            const port = 3112;
+            const projectPath = getProjectPath(projectSlug);
+            // Reset scenario capture status
+            info('Resetting scenario status...');
+            await updateFreshAnalysisStatus(analysisId, (freshStatus) => {
+                if (!freshStatus)
+                    return;
+                freshStatus.readyToBeCaptured = true;
+                if (freshStatus.scenarios) {
+                    for (const scenario of freshStatus.scenarios) {
+                        if (!scenarioId || scenario.name === scenarioId) {
+                            delete scenario.screenshotStartedAt;
+                            delete scenario.screenshotFinishedAt;
+                            delete scenario.interactiveStartedAt;
+                            delete scenario.interactiveFinishedAt;
+                            delete scenario.error;
+                            delete scenario.errorStack;
+                        }
+                    }
+                }
+            });
+            // Ensure web server is running (also handles version mismatch detection)
+            const { url: serverUrl, wasAlreadyRunning } = await startBackgroundServer({
+                port: 3111,
+                rootPath: projectRoot,
+                project,
+                branch,
+            });
+            if (wasAlreadyRunning) {
+                info(`Using web server at ${serverUrl}`);
+            }
+            else {
+                info(`Web server started at ${serverUrl}`);
+            }
+            info('Queueing debug setup job...');
+            // Enqueue the job via HTTP API
+            const enqueueResponse = await fetch(`${serverUrl}/api/queue`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    action: 'enqueue',
+                    type: 'debug-setup',
+                    commitSha: analysis.commit.sha,
+                    projectSlug,
+                    analysisId,
+                    scenarioId,
+                    prepOnly: true,
+                }),
+            });
+            if (!enqueueResponse.ok) {
+                const errData = await enqueueResponse.json();
+                error(`Failed to enqueue job: ${errData.error || enqueueResponse.statusText}`);
+                return;
+            }
+            const { jobId } = await enqueueResponse.json();
+            info(`Job queued: ${jobId.substring(0, 8)}`);
+            info('');
+            info('Waiting for setup to complete...');
+            info('(This may take a minute as files are prepared)');
+            info('');
+            // Poll for job completion via HTTP API
+            const pollInterval = 1000;
+            let completed = false;
+            while (!completed) {
+                await new Promise((resolve) => setTimeout(resolve, pollInterval));
+                const statusResponse = await fetch(`${serverUrl}/api/queue?queryType=job&jobId=${encodeURIComponent(jobId)}`);
+                if (!statusResponse.ok) {
+                    error(`Failed to check job status: ${statusResponse.statusText}`);
+                    return;
+                }
+                const statusData = await statusResponse.json();
+                if (statusData.status === 'failed') {
+                    error(`Debug setup failed: ${statusData.error || 'Unknown error'}`);
+                    return;
+                }
+                if (statusData.status === 'completed') {
+                    completed = true;
+                }
+            }
+            success('Debug environment ready!');
+            info('');
+            info('=== Next Steps ===');
+            info('');
+            info('1. Inspect the generated scenario files:');
+            info(`   ${projectPath}`);
+            info('');
+            info('2. Look at the generated layout/component files:');
+            info(`   ls ${projectPath}/app/static/`);
+            info('');
+            info('3. Start the development server:');
+            const webapps = project.metadata?.webapps || [];
+            const environmentVariables = config.environmentVariables || [];
+            const webappInfo = getWebappInfo({
+                filePath: analysis.filePath,
+                webapps,
+                environmentVariables,
+                port,
+                packageManager,
+            });
+            info(`   cd ${projectPath} && ${webappInfo.startCommand}`);
+            info('');
+            info(`4. View in browser (scenario urls):`);
+            // Output actual scenario URLs
+            const entitySlug = safeFileName(analysis.entityName);
+            if (analysis.scenarios && analysis.scenarios.length > 0) {
+                // Determine if this is a framework route to generate correct URLs
+                const framework = getFrameworkForFile(analysis.filePath, webapps);
+                const isRoute = framework &&
+                    analysis.file &&
+                    analysis.entity &&
+                    isFrameworkRoute(analysis.file, analysis.entity, framework);
+                // Filter to just the requested scenario if a specific scenarioId was provided
+                // (scenarioId is only set when the user passed a scenario ID, not an analysis ID)
+                const scenariosToShow = scenarioId
+                    ? analysis.scenarios.filter((s) => s.id === scenarioId)
+                    : analysis.scenarios;
+                for (const scenario of scenariosToShow) {
+                    const scenarioSlug = safeFileName(scenario.name);
+                    let scenarioPath;
+                    if (isRoute && analysis.file && framework) {
+                        // For framework routes, use the full route path generation
+                        scenarioPath = frameworkRouteFileNameToRoute(projectSlug, analysis.file, analysis, framework, scenario.name);
+                    }
+                    else {
+                        // For regular components, use the simple path
+                        scenarioPath = `static/${projectSlug}/${analysisId}/${entitySlug}/${scenarioSlug}/default`;
+                    }
+                    const scenarioUrl = `http://localhost:${port}/${scenarioPath}`;
+                    info(`   - ${scenario.name}: ${scenarioUrl}`);
+                }
+            }
+            info('');
+            info('5. Check logs for errors:');
+            info(`   tail -f ${logPath}`);
+        }
+        catch (err) {
+            error(`Debug setup failed: ${err.message}`);
+            console.error(err);
+        }
+    },
+};
+export default debugCommand;
+//# sourceMappingURL=debug.js.map

package/codeyam-cli/src/commands/debug.js.map

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

package/codeyam-cli/src/commands/default.js

@@ -1,21 +1,17 @@
 import * as fs from 'fs';
 import * as path from 'path';
+import chalk from 'chalk';
 import { error, withoutSpinner } from "../utils/progress.js";
 import { requireBranchAndProject, testEnvironment } from "../utils/database.js";
 import { startBackgroundServer } from "../utils/backgroundServer.js";
-import { isServerRunning } from "../utils/serverState.js";
+import { installClaudeCodeSkills } from "../utils/install-skills.js";
+import initCommand from "./init.js";
 import { getProjectRoot } from "../state.js";
 function logStartMessage(state) {
     console.log();
-    console.log(`CodeYam is running a local server on port ${state.port}`);
-    console.log();
-    console.log('Run "codeyam stop" to stop this server from running');
-    console.log();
-    console.log('Run "codeyam help" for other CLI commands');
-    console.log();
-    console.log('Run "codeyam" at any time to display this information or re-open the local server');
-    console.log();
-    console.log(`Visit ${state.url} for the full CodeYam experience`);
+    console.log(`  Dashboard: ${state.url}`);
+    console.log('  Run "codeyam --help" for all commands');
+    console.log(chalk.bold('  Run "codeyam" to launch the dashboard at any time'));
     console.log();
 }
 const defaultCommand = {
@@ -30,25 +26,19 @@ const defaultCommand = {
         },
     },
     handler: async (argv) => {
-        // Find project root directory
-        const projectRoot = getProjectRoot();
+        // Find project root directory, auto-initializing if needed
+        let projectRoot = getProjectRoot();
         if (!projectRoot) {
-            error('Not in a CodeYam project. Run: codeyam init');
-            return;
-        }
-        // Check if server is already running
-        const { running, state } = isServerRunning();
-        if (running && state) {
-            logStartMessage(state);
-            // Auto-open browser
-            try {
-                const { execSync } = await import('child_process');
-                execSync(`open "${state.url}"`, { stdio: 'ignore' });
-            }
-            catch (e) {
-                // Silently fail if open command doesn't work
+            await initCommand.handler({
+                force: false,
+                autoInit: true,
+                $0: '',
+                _: [],
+            });
+            projectRoot = getProjectRoot();
+            if (!projectRoot) {
+                return;
             }
-            return;
         }
         const configPath = path.join(projectRoot, '.codeyam', 'config.json');
         try {
@@ -67,22 +57,28 @@ const defaultCommand = {
             }
             // Load project and branch from database
             const { project, branch } = await requireBranchAndProject(projectSlug);
+            // Ensure skills/hooks are up to date with this CLI version
+            const simulationsEnabled = project.metadata?.labs?.simulations ?? false;
+            await installClaudeCodeSkills(projectRoot, {
+                mode: simulationsEnabled ? 'full' : 'memory',
+            });
             // Start background server
-            const { url, wasAlreadyRunning } = await startBackgroundServer({
+            const { url } = await startBackgroundServer({
                 port: argv.port || 3111,
                 rootPath: projectRoot,
                 project,
                 branch,
             });
-            if (!wasAlreadyRunning) {
-                console.log();
-                console.log(`✅ Started CodeYam server in background`);
-            }
-            logStartMessage({ port: argv.port || 3111, url, pid: process.pid });
+            logStartMessage({ url });
             // Auto-open browser
             try {
                 const { execSync } = await import('child_process');
-                execSync(`open "${url}"`, { stdio: 'ignore' });
+                const openCommand = process.platform === 'darwin'
+                    ? 'open'
+                    : process.platform === 'win32'
+                        ? 'start ""'
+                        : 'xdg-open';
+                execSync(`${openCommand} "${url}"`, { stdio: 'ignore' });
             }
             catch (e) {
                 // Silently fail if open command doesn't work

package/codeyam-cli/src/commands/default.js.map

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

package/codeyam-cli/src/commands/entities.js

@@ -3,7 +3,7 @@ import * as path from 'path';
 import { error, header, info, ProgressReporter, withoutSpinner, } from "../utils/progress.js";
 import { testEnvironment, initializeEnvironment } from "../utils/database.js";
 import { getProjectRoot } from "../state.js";
-import { getDatabase } from "../../../packages/supabase/index.js";
+import { getDatabase } from "../../../packages/database/index.js";
 const entitiesCommand = {
     command: 'entities [name]',
     describe: 'Search for entities in the project by name',

package/codeyam-cli/src/commands/generate-data-structure.js

@@ -1,8 +1,8 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import { error, header, info, ProgressReporter, } from "../utils/progress.js";
+import { error, header, info, ProgressReporter } from "../utils/progress.js";
 import { getProjectRoot } from "../state.js";
-import { getDatabase } from "../../../packages/supabase/index.js";
+import { getDatabase } from "../../../packages/database/index.js";
 import { runAnalysisForEntities } from "../utils/analysisRunner.js";
 import { extractEntitiesFromContent } from "../webserver/app/lib/lightweightEntityExtractor.js";
 import { initializeEnvironment } from "../utils/database.js";
@@ -52,7 +52,7 @@ const generateDataStructureCommand = {
             // Read file content and extract entities to compute current entity sha
             const fileContent = fs.readFileSync(fullFilePath, 'utf8');
             const entities = extractEntitiesFromContent(fileContent, relativeFilePath);
-            const currentEntity = entities.find(e => e.name === argv.entity);
+            const currentEntity = entities.find((e) => e.name === argv.entity);
             if (currentEntity) {
                 // Check if database has this entity with an analysis containing scenariosDataStructure
                 const dbEntities = await db
@@ -81,11 +81,18 @@ const generateDataStructureCommand = {
                         if (dataForMocks) {
                             progress.succeed('Found up-to-date analysis in database');
                             // Generate output based on format
-                            progress.start(argv.json ? 'Formatting data structure...' : 'Generating Jest mock template...');
+                            progress.start(argv.json
+                                ? 'Formatting data structure...'
+                                : 'Generating Jest mock template...');
                             const output = argv.json
-                                ? JSON.stringify({ dataForMocks, dependencySchemas: dependencySchemas || {} }, null, 2)
+                                ? JSON.stringify({
+                                    dataForMocks,
+                                    dependencySchemas: dependencySchemas || {},
+                                }, null, 2)
                                 : generateJestMockTemplate(argv.entity, dataForMocks, dependencySchemas || {});
-                            progress.succeed(argv.json ? 'Formatted data structure' : 'Generated Jest mock template');
+                            progress.succeed(argv.json
+                                ? 'Formatted data structure'
+                                : 'Generated Jest mock template');
                             // Output the result
                             if (argv.output) {
                                 fs.writeFileSync(argv.output, output, 'utf8');
@@ -150,7 +157,9 @@ const generateDataStructureCommand = {
             }
             progress.succeed('Generated data structure');
             // Generate output based on format
-            progress.start(argv.json ? 'Formatting data structure...' : 'Generating Jest mock template...');
+            progress.start(argv.json
+                ? 'Formatting data structure...'
+                : 'Generating Jest mock template...');
             const output = argv.json
                 ? JSON.stringify({ dataForMocks, dependencySchemas: dependencySchemas || {} }, null, 2)
                 : generateJestMockTemplate(argv.entity, dataForMocks, dependencySchemas || {});
@@ -229,7 +238,7 @@ function generateJestMockTemplate(entityName, dataForMocks, dependencySchemas) {
         const funcName = match[1];
         const dataStr = JSON.stringify(mockData, null, 2)
             .split('\n')
-            .map((line, i) => i === 0 ? line : '    ' + line)
+            .map((line, i) => (i === 0 ? line : '    ' + line))
             .join('\n');
         lines.push(`  // ${callSignature}`);
         lines.push(`  (${funcName} as jest.Mock).mockReturnValue(${dataStr});`);