next/dist/esm/server/lib/app-info-log.js

The React Framework

import { loadEnvConfig } from '@next/env';
import * as inspector from 'inspector';
import * as Log from '../../build/output/log';
import { bold, purple, strikethrough } from '../../lib/picocolors';
import { experimentalSchema } from '../config-schema';
import { getAgentName } from '../../telemetry/agent-name';
import { bundlerName, getBundlerFromEnv } from '../../lib/bundler';
import { hasCurrentAgentRules, writeAgentFiles } from './generate-agent-files';
/**
 * Logs basic startup info that doesn't require config.
 * Called before "Ready in X" to show immediate feedback.
 */ export function logStartInfo({ networkUrl, appUrl, envInfo, logBundler }) {
    const versionSuffix = logBundler ? ` (${bundlerName(getBundlerFromEnv())})` : '';
    Log.bootstrap(`${bold(purple(`${Log.prefixes.ready} Next.js ${"16.3.0"}`))}${versionSuffix}`);
    if (appUrl) {
        Log.bootstrap(`- Local:         ${appUrl}`);
    }
    if (networkUrl) {
        Log.bootstrap(`- Network:       ${networkUrl}`);
    }
    const inspectorUrl = inspector.url();
    if (inspectorUrl) {
        // Could also parse this port from the inspector URL.
        // process.debugPort will always be defined even if the process is not being inspected.
        // The full URL seems noisy as far as I can tell.
        // Node.js will print the full URL anyway.
        const debugPort = process.debugPort;
        Log.bootstrap(`- Debugger port: ${debugPort}`);
    }
    if (envInfo == null ? void 0 : envInfo.length) Log.bootstrap(`- Environments: ${envInfo.join(', ')}`);
}
/**
 * Logs experimental features and config-dependent info.
 * Called after getRequestHandlers completes.
 */ export function logExperimentalInfo({ experimentalFeatures, cacheComponents, partialPrefetching }) {
    if (cacheComponents) {
        Log.bootstrap(`- Cache Components enabled`);
    }
    if (partialPrefetching) {
        const mode = partialPrefetching === 'unstable_eager' ? ' (unstable_eager)' : '';
        Log.bootstrap(`- Partial Prefetching enabled${mode}`);
    }
    if (experimentalFeatures == null ? void 0 : experimentalFeatures.length) {
        Log.bootstrap(`- Experiments (use with caution):`);
        for (const exp of experimentalFeatures){
            const isValid = Object.prototype.hasOwnProperty.call(experimentalSchema, exp.key);
            if (isValid) {
                const symbol = typeof exp.value === 'boolean' ? exp.value === true ? bold('✓') : bold('⨯') : '·';
                const suffix = typeof exp.value === 'number' || typeof exp.value === 'string' ? `: ${JSON.stringify(exp.value)}` : '';
                const reason = exp.reason ? ` (${exp.reason})` : '';
                Log.bootstrap(`  ${symbol} ${exp.key}${suffix}${reason}`);
            } else {
                Log.bootstrap(`  ? ${strikethrough(exp.key)} (invalid experimental key)`);
            }
        }
    }
    // New line after the bootstrap info
    Log.info('');
}
/**
 * When `next dev` detects an AI coding agent but the managed
 * agent-rules block is missing from AGENTS.md / CLAUDE.md — or an
 * outdated version of it is installed — auto-generate or refresh the
 * files so the agent has access to version-matched docs. Returns the
 * write result when files were touched, or `null` when no action was
 * needed.
 *
 * Callers gate this on `config.agentRules !== false` — opt-out is
 * declarative in next.config, not inside this function.
 */ export async function ensureAgentRulesForDev(dir) {
    if (await getAgentName() === null) return null;
    if (hasCurrentAgentRules(dir)) return null;
    return writeAgentFiles(dir);
}
/**
 * Gets environment info for logging. Fast operation that doesn't require config.
 */ export function getEnvInfo(dir) {
    const { loadedEnvFiles } = loadEnvConfig(dir, true, console, false);
    return loadedEnvFiles.map((f)=>f.path);
}

//# sourceMappingURL=app-info-log.js.map