swallowkit 1.1.2 → 2.0.0-alpha.10

package/dist/cli/commands/dev.js

@@ -41,6 +41,7 @@ exports.buildFunctionsCoreToolsCommand = buildFunctionsCoreToolsCommand;
 exports.buildNextDevArgs = buildNextDevArgs;
 exports.buildFunctionsBaseUrl = buildFunctionsBaseUrl;
 exports.buildSwaStartArgs = buildSwaStartArgs;
+exports.buildReactDevArgs = buildReactDevArgs;
 exports.getSwaCliInstallCommand = getSwaCliInstallCommand;
 exports.getFunctionsReadinessTimeoutMs = getFunctionsReadinessTimeoutMs;
 exports.waitForHttpServerReady = waitForHttpServerReady;
@@ -48,6 +49,7 @@ exports.getPythonVirtualEnvPaths = getPythonVirtualEnvPaths;
 exports.getCSharpFunctionsBuildArtifactPaths = getCSharpFunctionsBuildArtifactPaths;
 exports.buildPythonFunctionsEnv = buildPythonFunctionsEnv;
 exports.buildFunctionsCosmosEnvironment = buildFunctionsCosmosEnvironment;
+exports.assertDevPortAvailable = assertDevPortAvailable;
 exports.buildDevCommand = buildDevCommand;
 const commander_1 = require("commander");
 const child_process_1 = require("child_process");
@@ -63,6 +65,7 @@ const dev_seeds_1 = require("./dev-seeds");
 const package_manager_1 = require("../../utils/package-manager");
 const python_uv_1 = require("../../utils/python-uv");
 const connector_mock_server_1 = require("../../core/mock/connector-mock-server");
+const react_dev_1 = require("../../utils/react-dev");
 const MINIMUM_CSHARP_CORE_TOOLS_VERSION = '4.6.0';
 const NPM_CORE_TOOLS_PACKAGE = 'azure-functions-core-tools@4';
 function normalizeParsedDevOptions(options) {
@@ -72,8 +75,8 @@ function normalizeParsedDevOptions(options) {
         noSwa: options.noSwa ?? options.swa === false,
     };
 }
-function buildFunctionsStartArgs(functionsPort) {
-    return ['start', '--port', functionsPort];
+function buildFunctionsStartArgs(functionsPort, backendLanguage = 'typescript') {
+    return [...(backendLanguage === 'csharp' ? [] : ['start']), '--port', functionsPort];
 }
 function parseCoreToolsVersion(output) {
     const match = output.match(/\d+\.\d+\.\d+/);
@@ -100,14 +103,14 @@ function buildFunctionsCoreToolsCommand(backendLanguage, installedVersion) {
             : 'func is not installed';
         return {
             command: 'npm',
-            argsPrefix: ['exec', '--yes', NPM_CORE_TOOLS_PACKAGE, '--'],
-            label: `npm exec ${NPM_CORE_TOOLS_PACKAGE} (${reason})`,
+            argsPrefix: ['exec', '--yes', '--package', NPM_CORE_TOOLS_PACKAGE, '--', 'dotnet', 'run', '--no-launch-profile', '--'],
+            label: `dotnet run with npm ${NPM_CORE_TOOLS_PACKAGE} (${reason})`,
         };
     }
     return {
-        command: 'func',
-        argsPrefix: [],
-        label: installedVersion ? `func ${installedVersion}` : 'func',
+        command: backendLanguage === 'csharp' ? 'dotnet' : 'func',
+        argsPrefix: backendLanguage === 'csharp' ? ['run', '--no-launch-profile', '--'] : [],
+        label: backendLanguage === 'csharp' ? 'dotnet run' : installedVersion ? `func ${installedVersion}` : 'func',
     };
 }
 function buildNextDevArgs(pm, port) {
@@ -117,7 +120,7 @@ function buildNextDevArgs(pm, port) {
 function buildFunctionsBaseUrl(host, functionsPort) {
     return `http://${host || 'localhost'}:${functionsPort}`;
 }
-function buildSwaStartArgs(host, nextPort, swaPort) {
+function buildSwaStartArgs(host, nextPort, swaPort, bffPort) {
     return [
         'start',
         `http://${host || 'localhost'}:${nextPort}`,
@@ -125,8 +128,13 @@ function buildSwaStartArgs(host, nextPort, swaPort) {
         '.',
         '--port',
         swaPort,
+        ...(bffPort ? ['--api-devserver-url', buildFunctionsBaseUrl(host, bffPort)] : []),
     ];
 }
+function buildReactDevArgs(pm, port, host = 'localhost', configPath) {
+    const args = ['vite', '--port', port, '--host', host, '--strictPort', ...(configPath ? ['--config', configPath] : [])];
+    return pm === 'pnpm' ? ['exec', ...args] : args;
+}
 function getSwaCliInstallCommand(pm) {
     return pm === 'pnpm'
         ? 'pnpm add -Dw @azure/static-web-apps-cli'
@@ -215,7 +223,7 @@ async function checkCommand(command, args = ['--version'], options) {
     });
 }
 async function resolveProjectLocalUvCommand(projectRoot) {
-    const uvEnv = (0, python_uv_1.buildProjectLocalUvEnv)(process.env, projectRoot);
+    const uvEnv = { ...process.env };
     const { localUvExecutable } = (0, python_uv_1.getProjectLocalUvPaths)(projectRoot);
     if (await checkCommand('uv', ['--version'], { shell: false })) {
         return { command: 'uv', env: uvEnv };
@@ -357,20 +365,8 @@ async function bridgePythonCoreToolsForWindowsArm64(functionsDir, env) {
 async function preparePythonFunctionsEnvironment(functionsDir) {
     const projectRoot = (0, python_uv_1.getPythonProjectRoot)(functionsDir);
     const { command: uvCommand, env: uvEnv } = await resolveProjectLocalUvCommand(projectRoot);
-    const { venvDir, pythonExecutable } = getPythonVirtualEnvPaths(functionsDir);
-    const hasUsableVirtualEnv = fs.existsSync(pythonExecutable) && await checkCommand(pythonExecutable, ['--version'], {
-        cwd: functionsDir,
-        env: uvEnv,
-        shell: false,
-    });
-    if (!hasUsableVirtualEnv) {
-        const venvArgs = (0, python_uv_1.buildUvVenvArgs)('.venv');
-        if (fs.existsSync(venvDir)) {
-            venvArgs.push('--clear');
-        }
-        console.log('📦 Creating Python virtual environment with uv...');
-        await runCommand(uvCommand, venvArgs, functionsDir, 'python virtual environment setup', uvEnv, false);
-    }
+    const { venvDir } = getPythonVirtualEnvPaths(functionsDir);
+    const pythonExecutable = await (0, python_uv_1.ensureUvVirtualEnvironment)(uvCommand, venvDir, functionsDir, uvEnv);
     console.log('📦 Installing Python Azure Functions dependencies with uv...');
     await runCommand(uvCommand, (0, python_uv_1.buildUvPipInstallArgs)(pythonExecutable, 'requirements.txt'), functionsDir, 'python dependency installation', uvEnv, false);
     const pythonEnv = buildPythonFunctionsEnv(uvEnv, functionsDir);
@@ -398,20 +394,45 @@ async function checkCosmosDBEmulator() {
         socket.connect(8081, 'localhost');
     });
 }
+async function assertDevPortAvailable(port, host) {
+    await new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.once('error', error => reject(new Error(`Development port ${port} on ${host} is unavailable: ${error.message}`)));
+        server.listen({ port, host, exclusive: true }, () => server.close(error => error ? reject(error) : resolve()));
+    });
+}
+function stopDevProcesses(processes) {
+    const active = processes.filter(child => child.pid && !child.killed && child.exitCode === null && child.signalCode === null);
+    if (process.platform === 'win32' && active.length) {
+        // Windows shell termination alone leaves Vite, Core Tools, and SWA running.
+        const ids = active.map(child => child.pid).join(',');
+        const result = (0, child_process_1.spawnSync)('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command',
+            `$all = @(Get-CimInstance Win32_Process); function Stop-OwnedTree([int]$id) { foreach ($child in ($all | Where-Object ParentProcessId -eq $id)) { Stop-OwnedTree $child.ProcessId }; Stop-Process -Id $id -Force -ErrorAction SilentlyContinue }; foreach ($id in @(${ids})) { Stop-OwnedTree $id }`,
+        ], { windowsHide: true, encoding: 'utf8' });
+        if (result.error || result.status !== 0) {
+            console.error('❌ Could not stop all development subprocesses:', result.error?.message || result.stderr);
+        }
+    }
+    else {
+        for (const child of active)
+            child.kill();
+    }
+}
 function buildDevCommand(runDevEnvironment = startDevEnvironment, verifyProject = config_1.ensureSwallowKitProject) {
     return new commander_1.Command()
         .name('dev')
-        .description('Start SwallowKit development server (Cosmos DB + Next.js + Azure Functions)')
-        .option('-p, --port <port>', 'Next.js port', '3000')
+        .description('Start SwallowKit frontend, BFF, and standalone Azure Functions')
+        .option('-p, --port <port>', 'Frontend dev server port', '3000')
         .option('-f, --functions-port <port>', 'Azure Functions port', '7071')
+        .option('--bff-port <port>', 'React managed BFF Functions port', '7073')
         .option('--host <host>', 'Host name', 'localhost')
         .option('--open', 'Open browser automatically', false)
         .option('--verbose', 'Show verbose logs', false)
         .option('--no-functions', 'Skip Azure Functions startup')
         .option('--seed-env <environment>', 'Replace Cosmos DB Emulator data from dev-seeds/<environment> before startup')
         .option('--mock-connectors', 'Start mock server for connector models (serves Zod-generated data)', false)
-        .option('--swa-port <port>', 'SWA authentication emulator port', '4280')
-        .option('--no-swa', 'Skip the SWA authentication emulator')
+        .option('--swa-port <port>', 'SWA routing/authentication emulator port', '4280')
+        .option('--no-swa', 'Skip SWA routing/authentication emulation (React direct access has no same-origin API)')
         .action(async (options) => {
         const normalizedOptions = normalizeParsedDevOptions(options);
         // SwallowKit プロジェクトディレクトリかどうかを検証
@@ -512,17 +533,22 @@ async function startDevEnvironment(options) {
     const port = options.port || '3000';
     const functionsPort = options.functionsPort || '7071';
     const swaPort = options.swaPort || '4280';
+    const bffPort = options.bffPort || '7073';
     // Detect package manager from project lockfile
     const pm = (0, package_manager_1.detectFromProject)();
     const pmCmd = (0, package_manager_1.getCommands)(pm);
     const backendLanguage = (0, config_1.getBackendLanguage)();
+    const react = (0, config_1.getFrontendFramework)() === 'react';
+    const frontendLabel = react ? 'React/Vite' : 'Next.js';
     const authConfig = (0, config_1.getAuthConfig)();
     const normalizedAuth = (0, config_1.normalizeAuthConfig)(authConfig);
-    const useSwaEmulator = Boolean(normalizedAuth && Object.values(normalizedAuth.schemes).some(scheme => scheme.provider === 'swa')) && !options.noSwa;
+    const authSchemes = Object.values(normalizedAuth?.schemes ?? {});
+    const swaScheme = authSchemes.find(scheme => scheme.provider === 'swa');
+    const useSwaEmulator = (react || Boolean(swaScheme)) && !options.noSwa;
     const swaCommand = useSwaEmulator ? await resolveSwaCliCommand(process.cwd()) : null;
     if (useSwaEmulator && !swaCommand) {
         const installCommand = getSwaCliInstallCommand(pm);
-        console.error('❌ SWA authentication requires Azure Static Web Apps CLI for local development.');
+        console.error('❌ SWA routing/authentication requires Azure Static Web Apps CLI for local development.');
         console.error('   Install it in this project and retry:');
         console.error(`\n   ${installCommand}\n`);
         process.exitCode = 1;
@@ -537,6 +563,14 @@ async function startDevEnvironment(options) {
     const functionsBaseUrl = buildFunctionsBaseUrl(options.host, functionsPort);
     let functionsReadinessPromise = null;
     let functionsReady = !!options.noFunctions;
+    let reactDevConfigDir;
+    const cleanupReactDevConfig = () => {
+        if (reactDevConfigDir) {
+            fs.rmSync(reactDevConfigDir, { recursive: true, force: true });
+            reactDevConfigDir = undefined;
+        }
+    };
+    process.once('exit', cleanupReactDevConfig);
     // Cleanup processes on Ctrl+C
     process.on('SIGINT', async () => {
         console.log('\n🛑 Stopping development servers...');
@@ -557,14 +591,22 @@ async function startDevEnvironment(options) {
         if (mockServer) {
             await mockServer.stop();
         }
-        processes.forEach((proc) => {
-            if (proc && !proc.killed) {
-                proc.kill();
-            }
-        });
+        stopDevProcesses(processes);
         process.exit(0);
     });
     try {
+        if (react) {
+            const ports = [port, bffPort, ...(!options.noFunctions ? [functionsPort] : []), ...(useSwaEmulator ? [swaPort] : []), ...(options.mockConnectors ? [String(Number(functionsPort) + 1)] : [])];
+            if (ports.some(value => !/^\d+$/.test(value) || Number(value) < 1 || Number(value) > 65535) || new Set(ports).size !== ports.length) {
+                throw new Error('Frontend, BFF, standalone Functions, mock, and SWA ports must be valid and distinct');
+            }
+            for (const value of ports)
+                await assertDevPortAvailable(Number(value), options.host || 'localhost');
+            const coreToolsVersion = await resolveInstalledCoreToolsVersion();
+            if (!coreToolsVersion || compareVersionNumbers(coreToolsVersion, '4.0.0') < 0) {
+                throw new Error('React BFF requires Azure Functions Core Tools v4. Install it explicitly before running dev.');
+            }
+        }
         // 1. Check for Next.js project
         const packageJsonPath = path.join(process.cwd(), 'package.json');
         const nextConfigPathJs = path.join(process.cwd(), 'next.config.js');
@@ -572,10 +614,10 @@ async function startDevEnvironment(options) {
         const nextConfigPathMjs = path.join(process.cwd(), 'next.config.mjs');
         if (!fs.existsSync(packageJsonPath)) {
             console.log('❌ package.json not found.');
-            console.log('💡 Please run this command in the root directory of a Next.js project.');
+            console.log('💡 Please run this command in the root directory of a SwallowKit project.');
             process.exit(1);
         }
-        if (!fs.existsSync(nextConfigPathJs) && !fs.existsSync(nextConfigPathTs) && !fs.existsSync(nextConfigPathMjs)) {
+        if (!react && !fs.existsSync(nextConfigPathJs) && !fs.existsSync(nextConfigPathTs) && !fs.existsSync(nextConfigPathMjs)) {
             console.log('⚠️  next.config file not found. Is this a Next.js project?');
         }
         // 2. Check if Azure Functions exists
@@ -730,7 +772,7 @@ async function startDevEnvironment(options) {
             }
             // Azure Functions を起動
             const functionsCommand = functionsCoreToolsCommand ?? buildFunctionsCoreToolsCommand(backendLanguage, installedCoreToolsVersion);
-            const funcProcess = (0, child_process_1.spawn)(functionsCommand.command, [...functionsCommand.argsPrefix, ...buildFunctionsStartArgs(functionsPort)], {
+            const funcProcess = (0, child_process_1.spawn)(functionsCommand.command, [...functionsCommand.argsPrefix, ...buildFunctionsStartArgs(functionsPort, backendLanguage)], {
                 cwd: functionsDir,
                 shell: true,
                 stdio: 'pipe', // Always pipe to capture output
@@ -770,6 +812,8 @@ async function startDevEnvironment(options) {
                 console.error('⚠️  Azure Functions startup error:', error.message);
                 console.log('💡 Please ensure Azure Functions Core Tools is installed');
                 console.log(`   ${pmCmd.addGlobal} azure-functions-core-tools@4`);
+                stopDevProcesses(processes);
+                process.exit(1);
             });
             funcProcess.on('close', (code) => {
                 if (code !== 0) {
@@ -779,6 +823,8 @@ async function startDevEnvironment(options) {
                         console.log('   Reinstall a matching Core Tools v4 package (Windows users should prefer the official x64/x86 MSI for their machine).');
                         console.log('   SwallowKit local Python dev uses functions/.venv and requirements.txt, but Core Tools still needs its own bundled Python worker.');
                     }
+                    stopDevProcesses(processes);
+                    process.exit(code || 1);
                 }
             });
             console.log(`⏳ Waiting for Azure Functions to accept requests at ${functionsBaseUrl}...`);
@@ -786,14 +832,14 @@ async function startDevEnvironment(options) {
         }
         else if (!hasFunctions) {
             console.log('');
-            console.log('ℹ️  functions/ directory not found. Starting Next.js only.');
+            console.log(`ℹ️  functions/ directory not found. Starting ${frontendLabel}${react ? ' and managed BFF' : ''} only.`);
         }
         else if (options.noFunctions) {
             console.log('');
             console.log('ℹ️  --no-functions specified. Skipping Azure Functions.');
         }
         console.log('');
-        console.log('🚀 Starting Next.js development server...');
+        console.log(`🚀 Starting ${frontendLabel} development server...`);
         // Mock connector server — start proxy if --mock-connectors is enabled
         let bffTargetPort = functionsPort;
         if (options.mockConnectors) {
@@ -857,7 +903,17 @@ async function startDevEnvironment(options) {
             }
         }
         // 5. Start Next.js development server
-        const nextArgs = buildNextDevArgs(pm, port);
+        let reactDevConfigPath;
+        if (react) {
+            const stateDir = path.join(process.cwd(), '.swallowkit');
+            fs.mkdirSync(stateDir, { recursive: true });
+            reactDevConfigDir = fs.mkdtempSync(path.join(stateDir, 'vite-dev-'));
+            reactDevConfigPath = path.join(reactDevConfigDir, 'config.mjs');
+            fs.writeFileSync(reactDevConfigPath, (0, react_dev_1.buildReactDevConfigSource)());
+        }
+        const nextArgs = react
+            ? buildReactDevArgs(pm, port, options.host, reactDevConfigPath && path.relative(process.cwd(), reactDevConfigPath))
+            : buildNextDevArgs(pm, port);
         // Ensure .env.local points to bffTargetPort so Next.js reads the correct backend URL.
         // When --mock-connectors is active, bffTargetPort = mock port (7072); otherwise = Functions port (7071).
         // Next.js may load .env.local values that override spawn env vars, so we must keep them in sync.
@@ -880,6 +936,24 @@ async function startDevEnvironment(options) {
             BACKEND_FUNCTIONS_BASE_URL: bffTargetUrl,
             FUNCTIONS_BASE_URL: bffTargetUrl,
         };
+        if (react) {
+            await runCommand(pm, ['run', 'build'], path.join(process.cwd(), 'shared'), 'Shared schema build');
+            const bffDir = path.join(process.cwd(), 'bff');
+            await runCommand(pm, ['run', 'build'], bffDir, 'Managed BFF build');
+            const bffProcess = (0, child_process_1.spawn)('func', buildFunctionsStartArgs(bffPort), {
+                cwd: bffDir, shell: true, stdio: 'inherit', env: nextEnv,
+            });
+            processes.push(bffProcess);
+            bffProcess.on('error', error => console.error('❌ Managed BFF startup error:', error.message));
+            bffProcess.on('close', code => {
+                console.error(`⏹️ Managed BFF exited (exit code: ${code})`);
+                stopDevProcesses(processes);
+                process.exit(code || 1);
+            });
+            if (!await waitForHttpServerReady(buildFunctionsBaseUrl(options.host, bffPort))) {
+                throw new Error(`Managed BFF did not become ready on port ${bffPort}`);
+            }
+        }
         const nextProcess = (0, child_process_1.spawn)(pm === 'pnpm' ? 'pnpm' : 'npx', nextArgs, {
             cwd: process.cwd(),
             shell: true,
@@ -888,22 +962,19 @@ async function startDevEnvironment(options) {
         });
         processes.push(nextProcess);
         nextProcess.on('error', (error) => {
-            console.error('❌ Next.js startup error:', error.message);
+            console.error(`❌ ${frontendLabel} startup error:`, error.message);
+            stopDevProcesses(processes);
             process.exit(1);
         });
         nextProcess.on('close', (code) => {
             if (code !== 0) {
-                console.log(`\n⏹️  Next.js exited (exit code: ${code})`);
+                console.log(`\n⏹️  ${frontendLabel} exited (exit code: ${code})`);
             }
-            // Exit all processes when Next.js exits
+            // Exit all owned processes when the frontend exits.
             if (mockServer) {
                 mockServer.stop().catch(() => { });
             }
-            processes.forEach((proc) => {
-                if (proc && !proc.killed) {
-                    proc.kill();
-                }
-            });
+            stopDevProcesses(processes);
             process.exit(code || 0);
         });
         if (functionsReadinessPromise) {
@@ -919,13 +990,13 @@ async function startDevEnvironment(options) {
         let swaReady = false;
         if (useSwaEmulator && swaCommand) {
             const nextUrl = `http://${options.host || 'localhost'}:${port}`;
-            console.log(`⏳ Waiting for Next.js before starting the SWA emulator at ${nextUrl}...`);
+            console.log(`⏳ Waiting for ${frontendLabel} before starting the SWA emulator at ${nextUrl}...`);
             const nextReady = await waitForHttpServerReady(nextUrl);
             if (!nextReady) {
-                throw new Error(`Next.js did not become ready at ${nextUrl}`);
+                throw new Error(`${frontendLabel} did not become ready at ${nextUrl}`);
             }
-            console.log(`🔐 Starting SWA authentication emulator (port: ${swaPort})...`);
-            const swaProcess = (0, child_process_1.spawn)(swaCommand, buildSwaStartArgs(options.host, port, swaPort), {
+            console.log(`🔐 Starting SWA routing/authentication emulator (port: ${swaPort})...`);
+            const swaProcess = (0, child_process_1.spawn)(swaCommand, buildSwaStartArgs(options.host, port, swaPort, react ? bffPort : undefined), {
                 cwd: process.cwd(),
                 shell: true,
                 stdio: 'inherit',
@@ -938,7 +1009,7 @@ async function startDevEnvironment(options) {
             const swaUrl = `http://${options.host || 'localhost'}:${swaPort}`;
             swaReady = await waitForHttpServerReady(swaUrl);
             if (!swaReady) {
-                throw new Error(`SWA authentication emulator did not become ready at ${swaUrl}`);
+                throw new Error(`SWA routing/authentication emulator did not become ready at ${swaUrl}`);
             }
         }
         console.log('');
@@ -946,19 +1017,26 @@ async function startDevEnvironment(options) {
         console.log('');
         if (useSwaEmulator) {
             const swaUrl = `http://${options.host || 'localhost'}:${swaPort}`;
-            console.log('🔐 SWA authenticated app:');
+            console.log('🔐 SWA app (same-origin frontend and BFF):');
             console.log(`   ${swaUrl}`);
             console.log('');
-            console.log('🔑 Local sign-in:');
-            console.log(`   ${swaUrl}/.auth/login/aad`);
-            console.log('   Enter any username and select Login.');
-            console.log('   The "authenticated" role is added automatically.');
-            console.log('');
-            console.log('📱 Next.js direct access (authentication is not emulated):');
+            if (swaScheme) {
+                const provider = swaScheme.swa?.allowedProviders?.[0] || 'aad';
+                console.log('🔑 Local SWA sign-in:');
+                console.log(`   ${swaUrl}/.auth/login/${provider}`);
+                console.log('   Enter any username and select Login.');
+                console.log('   The "authenticated" role is added automatically.');
+                console.log('');
+            }
+            if (authSchemes.some(scheme => scheme.provider === 'custom-jwt')) {
+                console.log(`🔑 Application sign-in: ${swaUrl}/login`);
+                console.log('');
+            }
+            console.log(`📱 ${frontendLabel} direct access (SWA routing/authentication is not emulated):`);
             console.log(`   http://${options.host || 'localhost'}:${port}`);
         }
         else {
-            console.log(`📱 Next.js: http://${options.host || 'localhost'}:${port}`);
+            console.log(`📱 ${frontendLabel}: http://${options.host || 'localhost'}:${port}`);
         }
         if (hasFunctions && !options.noFunctions) {
             console.log(`${functionsReady ? '⚡ Azure Functions' : '⏳ Azure Functions (starting)'}: ${functionsBaseUrl}`);
@@ -968,7 +1046,7 @@ async function startDevEnvironment(options) {
         }
         console.log('');
         if (hasFunctions && !options.noFunctions && functionsReady) {
-            console.log('💡 Azure Functions and Next.js BFF are connected');
+            console.log(`💡 Azure Functions and ${react ? 'managed Functions' : 'Next.js'} BFF are connected`);
         }
         else if (hasFunctions && !options.noFunctions) {
             console.log('💡 Azure Functions is still warming up; BFF routes can fail until the backend responds.');
@@ -979,6 +1057,8 @@ async function startDevEnvironment(options) {
         if (swaReady) {
             console.log('💡 Open the app through the SWA port when testing authenticated pages and CRUD APIs.');
         }
+        if (react)
+            console.log(`🔀 Managed BFF: ${buildFunctionsBaseUrl(options.host, bffPort)} (not the standalone Functions endpoint)`);
         console.log('');
         if (options.open) {
             const url = useSwaEmulator
@@ -995,11 +1075,7 @@ async function startDevEnvironment(options) {
     }
     catch (error) {
         console.error('❌ Failed to start development environment:', error instanceof Error ? error.message : error);
-        processes.forEach((proc) => {
-            if (proc && !proc.killed) {
-                proc.kill();
-            }
-        });
+        stopDevProcesses(processes);
         process.exit(1);
     }
 }