@stacknext/cli 0.0.0-stage → 0.6.1

package/dist/http.js

@@ -0,0 +1,54 @@
+const LOOPBACK_HOSTS = new Set(['127.0.0.1', 'localhost', '[::1]', '::1']);
+export class CollectorApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = 'CollectorApiError';
+        this.status = status;
+    }
+}
+function assertLoopback(baseUrl) {
+    let url;
+    try {
+        url = new URL(baseUrl);
+    }
+    catch {
+        throw new Error(`Invalid collector URL: ${baseUrl}`);
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new Error('Collector URL must use http or https');
+    }
+    if (!LOOPBACK_HOSTS.has(url.hostname)) {
+        throw new Error('StackNext only talks to a loopback collector');
+    }
+    return url;
+}
+export async function collectorFetch(baseUrl, pathname, token, init = {}) {
+    const base = assertLoopback(baseUrl);
+    const url = new URL(pathname, base);
+    const headers = new Headers(init.headers);
+    headers.set('authorization', `Bearer ${token}`);
+    const response = await fetch(url, {
+        ...init,
+        headers,
+        signal: init.signal ?? AbortSignal.timeout(5_000),
+    });
+    return response;
+}
+export async function collectorJson(baseUrl, pathname, token, init = {}) {
+    const response = await collectorFetch(baseUrl, pathname, token, init);
+    if (!response.ok) {
+        let message = `Collector responded with HTTP ${response.status}`;
+        try {
+            const payload = (await response.json());
+            if (payload.error)
+                message = payload.error;
+        }
+        catch {
+            // Keep the status-based message.
+        }
+        throw new CollectorApiError(message, response.status);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;AAE1E,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,MAAM,CAAQ;IAEvB,YAAY,OAAe,EAAE,MAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAA;IACtD,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzD,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,QAAgB,EAChB,KAAa,EACb,OAAoB,EAAE;IAEtB,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACnC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAA;IAC/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,GAAG,IAAI;QACP,OAAO;QACP,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;KAClD,CAAC,CAAA;IACF,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,QAAgB,EAChB,KAAa,EACb,OAAoB,EAAE;IAEtB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IACrE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAI,OAAO,GAAG,iCAAiC,QAAQ,CAAC,MAAM,EAAE,CAAA;QAChE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAA;YAC7D,IAAI,OAAO,CAAC,KAAK;gBAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;QACD,MAAM,IAAI,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAA;AACrC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export * from './collector/server.js';
+export * from './runtime.js';
+export * from './project.js';
+export * from './output.js';
+export * from './http.js';
+export * from './session.js';
+export * from './program.js';
+export * from './commands/init.js';
+export * from './commands/dev.js';
+export * from './commands/status.js';
+export * from './commands/doctor.js';
+export * from './commands/export.js';
+export * from './commands/mcp.js';
+export * from './commands/capture.js';
+export * from './commands/runs.js';
+export * from './commands/baseline.js';
+export * from './commands/compare.js';
+export * from './commands/uninstall.js';
+export * from './commands/regression-shared.js';
+export * from './version.js';
+export { CLI_VERSION as STACKNEXT_CLI_VERSION } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,cAAc,CAAA;AAC5B,OAAO,EAAE,WAAW,IAAI,qBAAqB,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,22 @@
+export * from './collector/server.js';
+export * from './runtime.js';
+export * from './project.js';
+export * from './output.js';
+export * from './http.js';
+export * from './session.js';
+export * from './program.js';
+export * from './commands/init.js';
+export * from './commands/dev.js';
+export * from './commands/status.js';
+export * from './commands/doctor.js';
+export * from './commands/export.js';
+export * from './commands/mcp.js';
+export * from './commands/capture.js';
+export * from './commands/runs.js';
+export * from './commands/baseline.js';
+export * from './commands/compare.js';
+export * from './commands/uninstall.js';
+export * from './commands/regression-shared.js';
+export * from './version.js';
+export { CLI_VERSION as STACKNEXT_CLI_VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,cAAc,CAAA;AAC5B,OAAO,EAAE,WAAW,IAAI,qBAAqB,EAAE,MAAM,cAAc,CAAA"}

package/dist/output.d.ts

@@ -0,0 +1,16 @@
+export declare const style: {
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    red: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    cyan: (text: string) => string;
+};
+export declare function printBanner(version: string): void;
+export declare function printSection(title: string): void;
+export declare function printCheck(status: 'pass' | 'warn' | 'fail', label: string, detail?: string): void;
+export declare function errorLine(message: string): void;
+export declare function formatBytes(bytes: number): string;
+export declare function formatDuration(ms: number | null): string;
+export declare function formatRelativeTime(timestamp: number, now?: number): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,KAAK;iBACH,MAAM,KAAG,MAAM;gBAChB,MAAM,KAAG,MAAM;gBACf,MAAM,KAAG,MAAM;kBACb,MAAM,KAAG,MAAM;mBACd,MAAM,KAAG,MAAM;iBACjB,MAAM,KAAG,MAAM;CAC7B,CAAA;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAChC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAQN;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOxD;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,CAM9E"}

package/dist/output.js

@@ -0,0 +1,60 @@
+const useColor = process.stdout.isTTY === true &&
+    process.env.NO_COLOR === undefined &&
+    process.env.TERM !== 'dumb';
+function wrap(code, text) {
+    return useColor ? `\u001B[${code}m${text}\u001B[0m` : text;
+}
+export const style = {
+    bold: (text) => wrap('1', text),
+    dim: (text) => wrap('2', text),
+    red: (text) => wrap('31', text),
+    green: (text) => wrap('32', text),
+    yellow: (text) => wrap('33', text),
+    cyan: (text) => wrap('36', text),
+};
+export function printBanner(version) {
+    console.log(`${style.bold('StackNext')} ${style.dim(`v${version}`)}`);
+}
+export function printSection(title) {
+    console.log(`\n${style.bold(title)}`);
+}
+export function printCheck(status, label, detail) {
+    const marker = status === 'pass'
+        ? style.green('✓')
+        : status === 'warn'
+            ? style.yellow('!')
+            : style.red('✗');
+    console.log(`${marker} ${label}${detail ? style.dim(` — ${detail}`) : ''}`);
+}
+export function errorLine(message) {
+    console.error(`${style.red('Error')} ${message}`);
+}
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KiB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+}
+export function formatDuration(ms) {
+    if (ms === null || !Number.isFinite(ms))
+        return '—';
+    if (ms < 1_000)
+        return `${Math.round(ms)} ms`;
+    if (ms < 60_000)
+        return `${(ms / 1_000).toFixed(2)} s`;
+    const minutes = Math.floor(ms / 60_000);
+    const seconds = Math.round((ms % 60_000) / 1_000);
+    return `${minutes}m ${seconds}s`;
+}
+export function formatRelativeTime(timestamp, now = Date.now()) {
+    const delta = Math.max(0, now - timestamp);
+    if (delta < 1_000)
+        return 'just now';
+    if (delta < 60_000)
+        return `${Math.floor(delta / 1_000)}s ago`;
+    if (delta < 3_600_000)
+        return `${Math.floor(delta / 60_000)}m ago`;
+    return `${Math.floor(delta / 3_600_000)}h ago`;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/program.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+export declare function createProgram(cwd?: string): Command;
+export declare function main(argv?: string[], cwd?: string): Promise<void>;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAiBnC,wBAAgB,aAAa,CAAC,GAAG,SAAgB,GAAG,OAAO,CA2B1D;AAED,wBAAsB,IAAI,CACxB,IAAI,GAAE,MAAM,EAAiB,EAC7B,GAAG,SAAgB,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/program.js

@@ -0,0 +1,54 @@
+import { Command } from 'commander';
+import { errorLine, style } from './output.js';
+import { registerInitCommand } from './commands/init.js';
+import { registerDevCommand } from './commands/dev.js';
+import { registerStatusCommand } from './commands/status.js';
+import { registerDoctorCommand } from './commands/doctor.js';
+import { registerExportCommand } from './commands/export.js';
+import { registerCoverageCommand } from './commands/coverage.js';
+import { registerDiagnoseCommand } from './commands/diagnose.js';
+import { registerMcpCommand } from './commands/mcp.js';
+import { registerCaptureCommand } from './commands/capture.js';
+import { registerRunsCommand } from './commands/runs.js';
+import { registerBaselineCommand } from './commands/baseline.js';
+import { registerCompareCommand } from './commands/compare.js';
+import { registerUninstallCommand } from './commands/uninstall.js';
+import { CLI_VERSION } from './version.js';
+export function createProgram(cwd = process.cwd()) {
+    const program = new Command();
+    program
+        .name('stacknext')
+        .description('Local-first runtime inspection for Next.js App Router applications')
+        .version(CLI_VERSION)
+        .showHelpAfterError()
+        .showSuggestionAfterError()
+        .addHelpText('after', '\nRun "stacknext doctor" when data does not appear in the dashboard.');
+    registerInitCommand(program, cwd);
+    registerDevCommand(program, cwd);
+    registerStatusCommand(program, cwd);
+    registerDoctorCommand(program, cwd);
+    registerExportCommand(program, cwd);
+    registerCoverageCommand(program, cwd);
+    registerDiagnoseCommand(program, cwd);
+    registerCaptureCommand(program, cwd);
+    registerRunsCommand(program, cwd);
+    registerBaselineCommand(program, cwd);
+    registerCompareCommand(program, cwd);
+    registerMcpCommand(program, cwd);
+    registerUninstallCommand(program, cwd);
+    return program;
+}
+export async function main(argv = process.argv, cwd = process.cwd()) {
+    const program = createProgram(cwd);
+    try {
+        await program.parseAsync(argv);
+    }
+    catch (error) {
+        errorLine(error instanceof Error ? error.message : String(error));
+        if (process.env.STACKNEXT_DEBUG === '1' && error instanceof Error && error.stack) {
+            console.error(style.dim(error.stack));
+        }
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/dist/project.d.ts

@@ -0,0 +1,35 @@
+export type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
+export interface ProjectInfo {
+    dir: string;
+    name: string;
+    packageJson: Record<string, unknown>;
+    packageManager: PackageManager;
+    scripts: Record<string, string>;
+    nextVersion: string | null;
+    nextMajor: number | null;
+    appDir: string | null;
+    srcDir: boolean;
+    instrumentationPath: string | null;
+    instrumentationExists: boolean;
+    typescript: boolean;
+    configExists: boolean;
+    hasDrizzle: boolean;
+    hasPrisma: boolean;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+}
+export declare class ProjectDetectionError extends Error {
+    constructor(message: string);
+}
+export declare function detectPackageManager(dir: string): Promise<PackageManager>;
+export declare function findInstrumentationFile(dir: string, srcDir: boolean): Promise<string | null>;
+export declare function detectProject(cwd?: string): Promise<ProjectInfo>;
+export declare function packageManagerCommand(manager: PackageManager, script: string): {
+    command: string;
+    args: string[];
+};
+export declare function installCommand(manager: PackageManager, packages: string[], dev?: boolean): string;
+export declare function isStackNextIntegrated(source: string): boolean;
+/** True when the project already declares any StackNext package. */
+export declare function stackNextPackages(project: ProjectInfo): string[];
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;AAE5D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,cAAc,EAAE,cAAc,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,OAAO,CAAA;IACf,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,qBAAqB,EAAE,OAAO,CAAA;IAC9B,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AA4BD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuB/E;AAQD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB;AAED,wBAAsB,aAAa,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAyD7E;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAWrC;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,UAAO,GACT,MAAM,CAYR;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAMhE"}

package/dist/project.js

@@ -0,0 +1,169 @@
+import { access, readFile } from 'node:fs/promises';
+import path from 'node:path';
+export class ProjectDetectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ProjectDetectionError';
+    }
+}
+async function exists(file) {
+    try {
+        await access(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readJson(file) {
+    return JSON.parse(await readFile(file, 'utf8'));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stringRecord(value) {
+    if (!isRecord(value))
+        return {};
+    const output = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry === 'string')
+            output[key] = entry;
+    }
+    return output;
+}
+export async function detectPackageManager(dir) {
+    const lockfiles = [
+        ['pnpm-lock.yaml', 'pnpm'],
+        ['yarn.lock', 'yarn'],
+        ['bun.lock', 'bun'],
+        ['bun.lockb', 'bun'],
+        ['package-lock.json', 'npm'],
+        ['npm-shrinkwrap.json', 'npm'],
+    ];
+    for (const [file, manager] of lockfiles) {
+        if (await exists(path.join(dir, file)))
+            return manager;
+    }
+    const packageJsonPath = path.join(dir, 'package.json');
+    if (await exists(packageJsonPath)) {
+        const packageJson = await readJson(packageJsonPath);
+        if (isRecord(packageJson) && typeof packageJson.packageManager === 'string') {
+            const name = packageJson.packageManager.split('@', 1)[0];
+            if (name === 'pnpm' || name === 'npm' || name === 'yarn' || name === 'bun') {
+                return name;
+            }
+        }
+    }
+    return 'npm';
+}
+function parseMajor(version) {
+    if (!version)
+        return null;
+    const match = /(\d+)/.exec(version.replace(/^[^\d]*/, ''));
+    return match?.[1] ? Number(match[1]) : null;
+}
+export async function findInstrumentationFile(dir, srcDir) {
+    const roots = [srcDir ? path.join(dir, 'src') : null, dir].filter((entry) => entry !== null);
+    const extensions = ['ts', 'tsx', 'js', 'mjs', 'jsx'];
+    for (const root of roots) {
+        for (const extension of extensions) {
+            const candidate = path.join(root, `instrumentation.${extension}`);
+            if (await exists(candidate))
+                return candidate;
+        }
+    }
+    return null;
+}
+export async function detectProject(cwd = process.cwd()) {
+    const dir = path.resolve(cwd);
+    const packageJsonPath = path.join(dir, 'package.json');
+    if (!(await exists(packageJsonPath))) {
+        throw new ProjectDetectionError(`No package.json found in ${dir}. Run StackNext from a Next.js project root.`);
+    }
+    const rawPackageJson = await readJson(packageJsonPath);
+    if (!isRecord(rawPackageJson)) {
+        throw new ProjectDetectionError('package.json must contain a JSON object');
+    }
+    const dependencies = stringRecord(rawPackageJson.dependencies);
+    const devDependencies = stringRecord(rawPackageJson.devDependencies);
+    const allDependencies = { ...devDependencies, ...dependencies };
+    const srcDir = await exists(path.join(dir, 'src'));
+    let appDir = null;
+    if (await exists(path.join(dir, 'app')))
+        appDir = 'app';
+    else if (await exists(path.join(dir, 'src', 'app')))
+        appDir = 'src/app';
+    const instrumentationPath = await findInstrumentationFile(dir, srcDir);
+    const packageManager = await detectPackageManager(dir);
+    let installedNextVersion = null;
+    try {
+        const installed = await readJson(path.join(dir, 'node_modules', 'next', 'package.json'));
+        if (isRecord(installed) && typeof installed.version === 'string') {
+            installedNextVersion = installed.version;
+        }
+    }
+    catch {
+        // Not installed yet. Fall back to the declared range below.
+    }
+    const declaredNext = dependencies.next ?? devDependencies.next ?? null;
+    const nextVersion = installedNextVersion ?? declaredNext;
+    const name = typeof rawPackageJson.name === 'string' && rawPackageJson.name.length > 0
+        ? rawPackageJson.name
+        : path.basename(dir);
+    return {
+        dir,
+        name,
+        packageJson: rawPackageJson,
+        packageManager,
+        scripts: stringRecord(rawPackageJson.scripts),
+        nextVersion,
+        nextMajor: parseMajor(nextVersion),
+        appDir,
+        srcDir,
+        instrumentationPath,
+        instrumentationExists: instrumentationPath !== null,
+        typescript: allDependencies.typescript !== undefined || (await exists(path.join(dir, 'tsconfig.json'))),
+        configExists: await exists(path.join(dir, 'stacknext.config.json')),
+        hasDrizzle: allDependencies['drizzle-orm'] !== undefined,
+        hasPrisma: allDependencies['@prisma/client'] !== undefined || allDependencies.prisma !== undefined,
+        dependencies,
+        devDependencies,
+    };
+}
+export function packageManagerCommand(manager, script) {
+    switch (manager) {
+        case 'pnpm':
+            return { command: 'pnpm', args: ['run', script] };
+        case 'yarn':
+            return { command: 'yarn', args: [script] };
+        case 'bun':
+            return { command: 'bun', args: ['run', script] };
+        case 'npm':
+            return { command: 'npm', args: ['run', script] };
+    }
+}
+export function installCommand(manager, packages, dev = true) {
+    const suffix = packages.join(' ');
+    switch (manager) {
+        case 'pnpm':
+            return `pnpm add ${dev ? '-D ' : ''}${suffix}`;
+        case 'yarn':
+            return `yarn add ${dev ? '-D ' : ''}${suffix}`;
+        case 'bun':
+            return `bun add ${dev ? '-d ' : ''}${suffix}`;
+        case 'npm':
+            return `npm install ${dev ? '--save-dev ' : ''}${suffix}`;
+    }
+}
+export function isStackNextIntegrated(source) {
+    return source.includes('@stacknext/next');
+}
+/** True when the project already declares any StackNext package. */
+export function stackNextPackages(project) {
+    const names = new Set([
+        ...Object.keys(project.dependencies),
+        ...Object.keys(project.devDependencies),
+    ]);
+    return [...names].filter((name) => name.startsWith('@stacknext/'));
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const RUNTIME_DIR_NAME = ".stacknext";
+export declare const RUNTIME_FILE_NAME = "run.json";
+export declare const runtimeStateSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    pid: z.ZodNumber;
+    startedAt: z.ZodNumber;
+    projectDir: z.ZodString;
+    projectName: z.ZodString;
+    dashboardUrl: z.ZodString;
+    collectorUrl: z.ZodString;
+    port: z.ZodNumber;
+    token: z.ZodString;
+    nextVersion: z.ZodOptional<z.ZodString>;
+    command: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type RuntimeState = z.infer<typeof runtimeStateSchema>;
+export declare function runtimeDir(projectDir: string): string;
+export declare function runtimeStatePath(projectDir: string): string;
+export declare function generateToken(): string;
+export declare function readRuntimeState(projectDir: string): Promise<RuntimeState | null>;
+export declare function writeRuntimeState(projectDir: string, state: RuntimeState): Promise<string>;
+export declare function removeRuntimeState(projectDir: string): Promise<void>;
+export declare function isProcessAlive(pid: number): boolean;
+export declare function isLoopbackHostname(hostname: string): boolean;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,gBAAgB,eAAe,CAAA;AAC5C,eAAO,MAAM,iBAAiB,aAAa,CAAA;AAE3C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;kBAcpB,CAAA;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsBvF;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO5D"}

package/dist/runtime.js

@@ -0,0 +1,89 @@
+import { randomBytes } from 'node:crypto';
+import { chmod, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+export const RUNTIME_DIR_NAME = '.stacknext';
+export const RUNTIME_FILE_NAME = 'run.json';
+export const runtimeStateSchema = z
+    .object({
+    version: z.literal(1),
+    pid: z.number().int().positive(),
+    startedAt: z.number().int().positive(),
+    projectDir: z.string().min(1),
+    projectName: z.string().min(1),
+    dashboardUrl: z.string().url(),
+    collectorUrl: z.string().url(),
+    port: z.number().int().positive(),
+    token: z.string().min(16),
+    nextVersion: z.string().optional(),
+    command: z.string().optional(),
+})
+    .strict();
+export function runtimeDir(projectDir) {
+    return path.join(projectDir, RUNTIME_DIR_NAME);
+}
+export function runtimeStatePath(projectDir) {
+    const override = process.env.STACKNEXT_RUNTIME_FILE;
+    if (override)
+        return path.isAbsolute(override) ? override : path.resolve(projectDir, override);
+    return path.join(runtimeDir(projectDir), RUNTIME_FILE_NAME);
+}
+export function generateToken() {
+    return randomBytes(32).toString('base64url');
+}
+export async function readRuntimeState(projectDir) {
+    const file = runtimeStatePath(projectDir);
+    let contents;
+    try {
+        contents = await readFile(file, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(contents);
+    }
+    catch {
+        throw new Error(`Cannot parse ${file}. Remove it and restart "stacknext dev".`);
+    }
+    const result = runtimeStateSchema.safeParse(parsed);
+    if (!result.success) {
+        throw new Error(`Invalid runtime state in ${file}. Remove it and restart "stacknext dev".`);
+    }
+    return result.data;
+}
+export async function writeRuntimeState(projectDir, state) {
+    const dir = runtimeDir(projectDir);
+    await mkdir(dir, { recursive: true, mode: 0o700 });
+    await chmod(dir, 0o700).catch(() => undefined);
+    await writeFile(path.join(dir, '.gitignore'), '*\n', { mode: 0o600 });
+    const file = runtimeStatePath(projectDir);
+    await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+    const temporary = `${file}.${process.pid}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
+    await chmod(temporary, 0o600).catch(() => undefined);
+    await rename(temporary, file);
+    return file;
+}
+export async function removeRuntimeState(projectDir) {
+    await rm(runtimeStatePath(projectDir), { force: true });
+}
+export function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+export function isLoopbackHostname(hostname) {
+    return (hostname === '127.0.0.1' ||
+        hostname === 'localhost' ||
+        hostname === '[::1]' ||
+        hostname === '::1');
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,10 @@
+import type { RuntimeState } from './runtime.js';
+export declare class NotRunningError extends Error {
+    constructor(message: string);
+}
+/**
+ * Returns runtime state only when the recorded process is still alive. Stale
+ * state is removed so the next `dev` run can start cleanly.
+ */
+export declare function requireRunningState(projectDir: string): Promise<RuntimeState>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAcnF"}