neon-init 0.14.0 → 0.16.0

package/dist/lib/inspect.d.ts

@@ -0,0 +1,28 @@
+import { AgentCheck } from "./types.js";
+
+//#region src/lib/inspect.d.ts
+interface InspectionResults {
+  [key: string]: unknown;
+  mcpConfigured?: boolean;
+  skillsInstalled?: boolean;
+  /** True if a Neon-specific connection string (DATABASE_URL with "neon" or PGHOST with "neon") is found */
+  connectionString?: boolean;
+  /** True if any DATABASE_URL is set in .env (regardless of provider) */
+  databaseUrl?: boolean;
+  framework?: string;
+  orm?: string;
+  migrationTool?: string;
+  migrationDir?: string;
+  isVscodeIde?: boolean;
+  agent?: string;
+  /** True if the directory contains an application (package.json with deps, or source files) */
+  hasApp?: boolean;
+}
+/**
+ * Runs filesystem checks based on the agent_check descriptors.
+ * Maps check IDs to concrete inspection functions.
+ */
+declare function inspectProject(checks: AgentCheck[]): Promise<InspectionResults>;
+//#endregion
+export { InspectionResults, inspectProject };
+//# sourceMappingURL=inspect.d.ts.map

package/dist/lib/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","names":[],"sources":["../../src/lib/inspect.ts"],"mappings":";;;UASiB,iBAAA;;EAAA,aAAA,CAAA,EAAA,OAAiB;EAsBZ,eAAA,CAAA,EAAc,OAAA;EAAA;kBAC3B,CAAA,EAAA,OAAA;;aACN,CAAA,EAAA,OAAA;EAAO,SAAA,CAAA,EAAA,MAAA;;;;;;;;;;;;;iBAFY,cAAA,SACb,eACN,QAAQ"}

package/dist/lib/inspect.js

@@ -0,0 +1,190 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+//#region src/lib/inspect.ts
+/**
+* Filesystem-based project inspection for interactive (agentless) mode.
+* Replaces the "agent_check" pattern — instead of asking an agent to look,
+* we examine the filesystem directly.
+*/
+/**
+* Runs filesystem checks based on the agent_check descriptors.
+* Maps check IDs to concrete inspection functions.
+*/
+async function inspectProject(checks) {
+	const results = {};
+	const cwd = process.cwd();
+	for (const check of checks) switch (check.id) {
+		case "mcp_server":
+			results.mcpConfigured = checkMcpServer(cwd);
+			break;
+		case "connection_string":
+			results.connectionString = checkConnectionString(cwd);
+			break;
+		case "database_url":
+			results.databaseUrl = checkDatabaseUrl(cwd);
+			break;
+		case "project_stack": {
+			const stack = detectProjectStack(cwd);
+			results.framework = stack.framework;
+			results.orm = stack.orm;
+			break;
+		}
+		case "migrations": {
+			const migrations = detectMigrations(cwd);
+			results.migrationTool = migrations.tool;
+			results.migrationDir = migrations.dir;
+			break;
+		}
+		case "skills":
+			results.skillsInstalled = checkSkillsInstalled(cwd);
+			break;
+		case "ide_type":
+			results.isVscodeIde = checkVscodeIde();
+			break;
+		case "has_app":
+			results.hasApp = checkHasApp(cwd);
+			break;
+		case "agent_type": break;
+	}
+	return results;
+}
+function checkMcpServer(cwd) {
+	const cursorMcp = resolve(cwd, ".cursor", "mcp.json");
+	if (existsSync(cursorMcp)) try {
+		const content = readFileSync(cursorMcp, "utf-8");
+		if (content.includes("neon") || content.includes("mcp.neon.tech")) return true;
+	} catch {}
+	const home = process.env.HOME || process.env.USERPROFILE || "";
+	const globalCursorMcp = resolve(home, ".cursor", "mcp.json");
+	if (existsSync(globalCursorMcp)) try {
+		const content = readFileSync(globalCursorMcp, "utf-8");
+		if (content.includes("neon") || content.includes("mcp.neon.tech")) return true;
+	} catch {}
+	for (const claudeFile of ["settings.local.json", "settings.json"]) {
+		const claudeConfig = resolve(home, ".claude", claudeFile);
+		if (existsSync(claudeConfig)) try {
+			const content = readFileSync(claudeConfig, "utf-8");
+			if (content.includes("neon") || content.includes("mcp.neon.tech")) return true;
+		} catch {}
+	}
+	const vscodeSettings = resolve(cwd, ".vscode", "settings.json");
+	if (existsSync(vscodeSettings)) try {
+		const content = readFileSync(vscodeSettings, "utf-8");
+		if (content.includes("neon") || content.includes("mcp.neon.tech")) return true;
+	} catch {}
+	return false;
+}
+function checkConnectionString(cwd) {
+	for (const envFile of [".env", ".env.local"]) {
+		const envPath = resolve(cwd, envFile);
+		if (existsSync(envPath)) try {
+			const content = readFileSync(envPath, "utf-8");
+			if (/^DATABASE_URL=.*neon/m.test(content) || /^PGHOST=.*neon/m.test(content)) return true;
+		} catch {}
+	}
+	return false;
+}
+function detectProjectStack(cwd) {
+	const result = {
+		framework: "none",
+		orm: "none"
+	};
+	const pkgPath = resolve(cwd, "package.json");
+	if (!existsSync(pkgPath)) return result;
+	try {
+		const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+		const allDeps = {
+			...pkg.dependencies,
+			...pkg.devDependencies
+		};
+		if (allDeps.next) result.framework = "next";
+		else if (allDeps.remix || allDeps["@remix-run/node"]) result.framework = "remix";
+		else if (allDeps.express) result.framework = "express";
+		else if (allDeps.hono) result.framework = "hono";
+		else if (allDeps.fastify) result.framework = "fastify";
+		else if (allDeps["@sveltejs/kit"]) result.framework = "sveltekit";
+		else if (allDeps.nuxt) result.framework = "nuxt";
+		else if (allDeps.astro) result.framework = "astro";
+		if (allDeps.prisma || allDeps["@prisma/client"]) result.orm = "prisma";
+		else if (allDeps["drizzle-orm"]) result.orm = "drizzle";
+		else if (allDeps.knex) result.orm = "knex";
+		else if (allDeps.typeorm) result.orm = "typeorm";
+		else if (allDeps.sequelize) result.orm = "sequelize";
+		else if (allDeps["@neondatabase/serverless"]) result.orm = "neon-serverless";
+	} catch {}
+	return result;
+}
+function detectMigrations(cwd) {
+	if (existsSync(resolve(cwd, "prisma", "schema.prisma"))) return {
+		tool: "prisma",
+		dir: existsSync(resolve(cwd, "prisma", "migrations")) ? "prisma/migrations" : "none"
+	};
+	if (existsSync(resolve(cwd, "drizzle.config.ts")) || existsSync(resolve(cwd, "drizzle.config.js"))) return {
+		tool: "drizzle",
+		dir: existsSync(resolve(cwd, "drizzle")) ? "drizzle" : "none"
+	};
+	if (existsSync(resolve(cwd, "knexfile.js")) || existsSync(resolve(cwd, "knexfile.ts"))) return {
+		tool: "knex",
+		dir: existsSync(resolve(cwd, "migrations")) ? "migrations" : "none"
+	};
+	return {
+		tool: "none",
+		dir: "none"
+	};
+}
+function checkDatabaseUrl(cwd) {
+	const envPath = resolve(cwd, ".env");
+	if (existsSync(envPath)) try {
+		const content = readFileSync(envPath, "utf-8");
+		if (/^DATABASE_URL=/m.test(content)) return true;
+	} catch {}
+	return false;
+}
+function checkSkillsInstalled(cwd) {
+	const home = process.env.HOME || process.env.USERPROFILE || "";
+	const skillsDirs = [
+		resolve(cwd, ".cursor", "skills"),
+		resolve(cwd, ".claude", "skills"),
+		resolve(cwd, ".agents", "skills"),
+		resolve(home, ".cursor", "skills"),
+		resolve(home, ".claude", "skills")
+	];
+	for (const dir of skillsDirs) if (existsSync(resolve(dir, "neon-postgres", "SKILL.md"))) return true;
+	const claudeMd = resolve(cwd, "CLAUDE.md");
+	if (existsSync(claudeMd)) try {
+		if (readFileSync(claudeMd, "utf-8").includes("neon-postgres")) return true;
+	} catch {}
+	return false;
+}
+function checkVscodeIde() {
+	const env = process.env;
+	return !!(env.TERM_PROGRAM === "vscode" || env.TERM_PROGRAM === "cursor" || env.TERM_PROGRAM === "windsurf" || env.VSCODE_PID || env.VSCODE_CWD);
+}
+/**
+* Detects whether the current directory contains an application.
+* Returns true if package.json has dependencies or common source directories exist.
+*/
+function checkHasApp(cwd) {
+	const pkgPath = resolve(cwd, "package.json");
+	if (existsSync(pkgPath)) try {
+		const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+		const deps = Object.keys(pkg.dependencies ?? {});
+		const devDeps = Object.keys(pkg.devDependencies ?? {});
+		if (deps.length > 0 || devDeps.length > 0) return true;
+	} catch {}
+	for (const indicator of [
+		"src",
+		"app",
+		"pages",
+		"lib",
+		"index.ts",
+		"index.js",
+		"main.ts",
+		"main.js"
+	]) if (existsSync(resolve(cwd, indicator))) return true;
+	return false;
+}
+//#endregion
+export { inspectProject };
+
+//# sourceMappingURL=inspect.js.map

package/dist/lib/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","names":[],"sources":["../../src/lib/inspect.ts"],"sourcesContent":["/**\n * Filesystem-based project inspection for interactive (agentless) mode.\n * Replaces the \"agent_check\" pattern — instead of asking an agent to look,\n * we examine the filesystem directly.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport type { AgentCheck } from \"./types.js\";\n\nexport interface InspectionResults {\n\t[key: string]: unknown;\n\tmcpConfigured?: boolean;\n\tskillsInstalled?: boolean;\n\t/** True if a Neon-specific connection string (DATABASE_URL with \"neon\" or PGHOST with \"neon\") is found */\n\tconnectionString?: boolean;\n\t/** True if any DATABASE_URL is set in .env (regardless of provider) */\n\tdatabaseUrl?: boolean;\n\tframework?: string;\n\torm?: string;\n\tmigrationTool?: string;\n\tmigrationDir?: string;\n\tisVscodeIde?: boolean;\n\tagent?: string;\n\t/** True if the directory contains an application (package.json with deps, or source files) */\n\thasApp?: boolean;\n}\n\n/**\n * Runs filesystem checks based on the agent_check descriptors.\n * Maps check IDs to concrete inspection functions.\n */\nexport async function inspectProject(\n\tchecks: AgentCheck[],\n): Promise<InspectionResults> {\n\tconst results: InspectionResults = {};\n\tconst cwd = process.cwd();\n\n\tfor (const check of checks) {\n\t\tswitch (check.id) {\n\t\t\tcase \"mcp_server\":\n\t\t\t\tresults.mcpConfigured = checkMcpServer(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"connection_string\":\n\t\t\t\tresults.connectionString = checkConnectionString(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"database_url\":\n\t\t\t\tresults.databaseUrl = checkDatabaseUrl(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"project_stack\": {\n\t\t\t\tconst stack = detectProjectStack(cwd);\n\t\t\t\tresults.framework = stack.framework;\n\t\t\t\tresults.orm = stack.orm;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"migrations\": {\n\t\t\t\tconst migrations = detectMigrations(cwd);\n\t\t\t\tresults.migrationTool = migrations.tool;\n\t\t\t\tresults.migrationDir = migrations.dir;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"skills\":\n\t\t\t\tresults.skillsInstalled = checkSkillsInstalled(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"ide_type\":\n\t\t\t\tresults.isVscodeIde = checkVscodeIde();\n\t\t\t\tbreak;\n\t\t\tcase \"has_app\":\n\t\t\t\tresults.hasApp = checkHasApp(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"agent_type\":\n\t\t\t\t// Handled by the interactive runner (prompt or env detection)\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\treturn results;\n}\n\n// ---------------------------------------------------------------------------\n// Individual check implementations\n// ---------------------------------------------------------------------------\n\nfunction checkMcpServer(cwd: string): boolean {\n\t// Check project-level Cursor config\n\tconst cursorMcp = resolve(cwd, \".cursor\", \"mcp.json\");\n\tif (existsSync(cursorMcp)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(cursorMcp, \"utf-8\");\n\t\t\tif (content.includes(\"neon\") || content.includes(\"mcp.neon.tech\")) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t} catch {}\n\t}\n\n\t// Check global Cursor config\n\tconst home = process.env.HOME || process.env.USERPROFILE || \"\";\n\tconst globalCursorMcp = resolve(home, \".cursor\", \"mcp.json\");\n\tif (existsSync(globalCursorMcp)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(globalCursorMcp, \"utf-8\");\n\t\t\tif (content.includes(\"neon\") || content.includes(\"mcp.neon.tech\")) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t} catch {}\n\t}\n\n\t// Check Claude Code config (add-mcp writes to settings.local.json)\n\tfor (const claudeFile of [\"settings.local.json\", \"settings.json\"]) {\n\t\tconst claudeConfig = resolve(home, \".claude\", claudeFile);\n\t\tif (existsSync(claudeConfig)) {\n\t\t\ttry {\n\t\t\t\tconst content = readFileSync(claudeConfig, \"utf-8\");\n\t\t\t\tif (\n\t\t\t\t\tcontent.includes(\"neon\") ||\n\t\t\t\t\tcontent.includes(\"mcp.neon.tech\")\n\t\t\t\t) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t} catch {}\n\t\t}\n\t}\n\n\t// Check VS Code settings\n\tconst vscodeSettings = resolve(cwd, \".vscode\", \"settings.json\");\n\tif (existsSync(vscodeSettings)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(vscodeSettings, \"utf-8\");\n\t\t\tif (content.includes(\"neon\") || content.includes(\"mcp.neon.tech\")) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t} catch {}\n\t}\n\n\treturn false;\n}\n\nfunction checkConnectionString(cwd: string): boolean {\n\tfor (const envFile of [\".env\", \".env.local\"]) {\n\t\tconst envPath = resolve(cwd, envFile);\n\t\tif (existsSync(envPath)) {\n\t\t\ttry {\n\t\t\t\tconst content = readFileSync(envPath, \"utf-8\");\n\t\t\t\tif (\n\t\t\t\t\t/^DATABASE_URL=.*neon/m.test(content) ||\n\t\t\t\t\t/^PGHOST=.*neon/m.test(content)\n\t\t\t\t) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t} catch {}\n\t\t}\n\t}\n\treturn false;\n}\n\ninterface StackResult {\n\tframework: string;\n\torm: string;\n}\n\nfunction detectProjectStack(cwd: string): StackResult {\n\tconst result: StackResult = { framework: \"none\", orm: \"none\" };\n\n\tconst pkgPath = resolve(cwd, \"package.json\");\n\tif (!existsSync(pkgPath)) return result;\n\n\ttry {\n\t\tconst pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n\t\tconst allDeps = {\n\t\t\t...pkg.dependencies,\n\t\t\t...pkg.devDependencies,\n\t\t};\n\n\t\t// Framework detection\n\t\tif (allDeps.next) result.framework = \"next\";\n\t\telse if (allDeps.remix || allDeps[\"@remix-run/node\"])\n\t\t\tresult.framework = \"remix\";\n\t\telse if (allDeps.express) result.framework = \"express\";\n\t\telse if (allDeps.hono) result.framework = \"hono\";\n\t\telse if (allDeps.fastify) result.framework = \"fastify\";\n\t\telse if (allDeps[\"@sveltejs/kit\"]) result.framework = \"sveltekit\";\n\t\telse if (allDeps.nuxt) result.framework = \"nuxt\";\n\t\telse if (allDeps.astro) result.framework = \"astro\";\n\n\t\t// ORM detection\n\t\tif (allDeps.prisma || allDeps[\"@prisma/client\"]) result.orm = \"prisma\";\n\t\telse if (allDeps[\"drizzle-orm\"]) result.orm = \"drizzle\";\n\t\telse if (allDeps.knex) result.orm = \"knex\";\n\t\telse if (allDeps.typeorm) result.orm = \"typeorm\";\n\t\telse if (allDeps.sequelize) result.orm = \"sequelize\";\n\t\telse if (allDeps[\"@neondatabase/serverless\"])\n\t\t\tresult.orm = \"neon-serverless\";\n\t} catch {}\n\n\treturn result;\n}\n\ninterface MigrationResult {\n\ttool: string;\n\tdir: string;\n}\n\nfunction detectMigrations(cwd: string): MigrationResult {\n\t// Prisma\n\tif (existsSync(resolve(cwd, \"prisma\", \"schema.prisma\"))) {\n\t\tconst migrationsDir = resolve(cwd, \"prisma\", \"migrations\");\n\t\treturn {\n\t\t\ttool: \"prisma\",\n\t\t\tdir: existsSync(migrationsDir) ? \"prisma/migrations\" : \"none\",\n\t\t};\n\t}\n\n\t// Drizzle\n\tif (\n\t\texistsSync(resolve(cwd, \"drizzle.config.ts\")) ||\n\t\texistsSync(resolve(cwd, \"drizzle.config.js\"))\n\t) {\n\t\tconst drizzleDir = resolve(cwd, \"drizzle\");\n\t\treturn {\n\t\t\ttool: \"drizzle\",\n\t\t\tdir: existsSync(drizzleDir) ? \"drizzle\" : \"none\",\n\t\t};\n\t}\n\n\t// Knex\n\tif (\n\t\texistsSync(resolve(cwd, \"knexfile.js\")) ||\n\t\texistsSync(resolve(cwd, \"knexfile.ts\"))\n\t) {\n\t\tconst migrationsDir = resolve(cwd, \"migrations\");\n\t\treturn {\n\t\t\ttool: \"knex\",\n\t\t\tdir: existsSync(migrationsDir) ? \"migrations\" : \"none\",\n\t\t};\n\t}\n\n\treturn { tool: \"none\", dir: \"none\" };\n}\n\nfunction checkDatabaseUrl(cwd: string): boolean {\n\tconst envPath = resolve(cwd, \".env\");\n\tif (existsSync(envPath)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(envPath, \"utf-8\");\n\t\t\tif (/^DATABASE_URL=/m.test(content)) return true;\n\t\t} catch {}\n\t}\n\treturn false;\n}\n\nfunction checkSkillsInstalled(cwd: string): boolean {\n\tconst home = process.env.HOME || process.env.USERPROFILE || \"\";\n\n\t// Check for neon-postgres SKILL.md in known skill directories (project and global)\n\tconst skillsDirs = [\n\t\tresolve(cwd, \".cursor\", \"skills\"),\n\t\tresolve(cwd, \".claude\", \"skills\"),\n\t\tresolve(cwd, \".agents\", \"skills\"),\n\t\tresolve(home, \".cursor\", \"skills\"),\n\t\tresolve(home, \".claude\", \"skills\"),\n\t];\n\tfor (const dir of skillsDirs) {\n\t\t// Verify the actual skill content file exists, not just the directory\n\t\tconst skillMd = resolve(dir, \"neon-postgres\", \"SKILL.md\");\n\t\tif (existsSync(skillMd)) return true;\n\t}\n\n\t// Check CLAUDE.md for neon skill references (injected by skills CLI)\n\tconst claudeMd = resolve(cwd, \"CLAUDE.md\");\n\tif (existsSync(claudeMd)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(claudeMd, \"utf-8\");\n\t\t\tif (content.includes(\"neon-postgres\")) return true;\n\t\t} catch {}\n\t}\n\n\treturn false;\n}\n\nfunction checkVscodeIde(): boolean {\n\tconst env = process.env;\n\treturn !!(\n\t\tenv.TERM_PROGRAM === \"vscode\" ||\n\t\tenv.TERM_PROGRAM === \"cursor\" ||\n\t\tenv.TERM_PROGRAM === \"windsurf\" ||\n\t\tenv.VSCODE_PID ||\n\t\tenv.VSCODE_CWD\n\t);\n}\n\n/**\n * Detects whether the current directory contains an application.\n * Returns true if package.json has dependencies or common source directories exist.\n */\nfunction checkHasApp(cwd: string): boolean {\n\tconst pkgPath = resolve(cwd, \"package.json\");\n\tif (existsSync(pkgPath)) {\n\t\ttry {\n\t\t\tconst pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n\t\t\tconst deps = Object.keys(pkg.dependencies ?? {});\n\t\t\tconst devDeps = Object.keys(pkg.devDependencies ?? {});\n\t\t\tif (deps.length > 0 || devDeps.length > 0) return true;\n\t\t} catch {}\n\t}\n\n\t// Check for common source directories / entry files\n\tconst indicators = [\n\t\t\"src\",\n\t\t\"app\",\n\t\t\"pages\",\n\t\t\"lib\",\n\t\t\"index.ts\",\n\t\t\"index.js\",\n\t\t\"main.ts\",\n\t\t\"main.js\",\n\t];\n\tfor (const indicator of indicators) {\n\t\tif (existsSync(resolve(cwd, indicator))) return true;\n\t}\n\n\treturn false;\n}\n"],"mappings":"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"}

package/dist/lib/install.d.ts

@@ -1,11 +1,17 @@
 import { Editor, InstallStatus } from "./types.js";
 
 //#region src/lib/install.d.ts
-
+interface InstallNeonOptions {
+  json?: boolean;
+}
 /**
- * Installs Neon's Local Connect extension or MCP Server for specific editors
+ * Installs Neon's Local Connect extension or MCP Server for specific editors.
+ * Returns a map of editor → install status and whether auth succeeded.
  */
-declare function installNeon(selectedEditors: Editor[]): Promise<Map<Editor, InstallStatus>>;
+declare function installNeon(selectedEditors: Editor[], options?: InstallNeonOptions): Promise<{
+  results: Map<Editor, InstallStatus>;
+  authSuccess: boolean;
+}>;
 //#endregion
-export { installNeon };
+export { InstallNeonOptions, installNeon };
 //# sourceMappingURL=install.d.ts.map

package/dist/lib/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","names":[],"sources":["../../src/lib/install.ts"],"sourcesContent":[],"mappings":";;;;;;AAiDA;AAAiC,iBAAX,WAAA,CAAW,eAAA,EACf,MADe,EAAA,CAAA,EAE9B,OAF8B,CAEtB,GAFsB,CAElB,MAFkB,EAEV,aAFU,CAAA,CAAA"}
+{"version":3,"file":"install.d.ts","names":[],"sources":["../../src/lib/install.ts"],"mappings":";;;UAkDiB,kBAAA;;AAAjB;AAQA;;;;AAG0B,iBAHJ,WAAA,CAGI,eAAA,EAFR,MAEQ,EAAA,EAAA,OAAA,CAAA,EADf,kBACe,CAAA,EAAvB,OAAuB,CAAA;SAAQ,EAAZ,GAAY,CAAR,MAAQ,EAAA,aAAA,CAAA;aAAZ,EAAA,OAAA"}

package/dist/lib/install.js

@@ -1,6 +1,6 @@
 import { getAddMcpAgentId } from "./agents.js";
-import { configureExtension, installExtension, usesExtension, waitForExtensionInstalled } from "./extension.js";
 import { createApiKeyFromNeonctl, ensureNeonctlAuth } from "./auth.js";
+import { configureExtension, installExtension, usesExtension, waitForExtensionInstalled } from "./extension.js";
 import { log, spinner } from "@clack/prompts";
 import { execa } from "execa";
 //#region src/lib/install.ts
@@ -29,27 +29,41 @@ async function installMCPServerViaAddMcp(editor, apiKey) {
 	});
 }
 /**
-* Installs Neon's Local Connect extension or MCP Server for specific editors
+* Installs Neon's Local Connect extension or MCP Server for specific editors.
+* Returns a map of editor → install status and whether auth succeeded.
 */
-async function installNeon(selectedEditors) {
+async function installNeon(selectedEditors, options) {
+	const quiet = options?.json === true;
+	const authOptions = { json: quiet };
 	const results = /* @__PURE__ */ new Map();
 	const extensionEditors = selectedEditors.filter(usesExtension);
 	const mcpEditors = selectedEditors.filter((e) => !usesExtension(e));
-	if (extensionEditors.length === 0 && mcpEditors.length === 0) return results;
-	const authSpinner = spinner();
-	authSpinner.start("Authenticating...");
-	if (!await ensureNeonctlAuth()) {
-		authSpinner.stop("Authentication failed");
+	if (extensionEditors.length === 0 && mcpEditors.length === 0) return {
+		results,
+		authSuccess: false
+	};
+	const authSpinner = quiet ? null : spinner();
+	authSpinner?.start("Authenticating...");
+	if (!await ensureNeonctlAuth(authOptions)) {
+		authSpinner?.stop("Authentication failed");
 		for (const editor of selectedEditors) results.set(editor, "failed");
-		return results;
+		return {
+			results,
+			authSuccess: false
+		};
 	}
-	authSpinner.stop("Authentication successful ✓");
-	const apiKey = await createApiKeyFromNeonctl();
+	authSpinner?.stop("Authentication successful ✓");
+	const apiKey = await createApiKeyFromNeonctl(authOptions);
 	if (!apiKey) {
-		log.error("Could not create API key after authentication.");
-		log.info("You can manually create one at: https://console.neon.tech/app/settings/api-keys");
+		if (!quiet) {
+			log.error("Could not create API key after authentication.");
+			log.info("You can manually create one at: https://console.neon.tech/app/settings/api-keys");
+		}
 		for (const editor of selectedEditors) results.set(editor, "failed");
-		return results;
+		return {
+			results,
+			authSuccess: true
+		};
 	}
 	for (const editor of extensionEditors) {
 		if (!await installExtension(editor)) {
@@ -61,11 +75,11 @@ async function installNeon(selectedEditors) {
 			continue;
 		}
 		if (await configureExtension(editor, apiKey)) results.set(editor, "success");
-		else results.set(editor, "success");
+		else results.set(editor, "failed");
 	}
 	if (mcpEditors.length > 0) {
-		const mcpSpinner = spinner();
-		mcpSpinner.start("Installing and configuring Neon MCP Server...");
+		const mcpSpinner = quiet ? null : spinner();
+		mcpSpinner?.start("Installing and configuring Neon MCP Server...");
 		let mcpSuccessCount = 0;
 		for (const editor of mcpEditors) try {
 			await installMCPServerViaAddMcp(editor, apiKey);
@@ -73,11 +87,14 @@ async function installNeon(selectedEditors) {
 			mcpSuccessCount++;
 		} catch (err) {
 			results.set(editor, "failed");
-			if (err && typeof err === "object" && "stderr" in err && err.stderr) log.error(String(err.stderr).trim() || "failed to install MCP server via add-mcp");
+			if (!quiet && err && typeof err === "object" && "stderr" in err && err.stderr) log.error(String(err.stderr).trim() || "failed to install MCP server via add-mcp");
 		}
-		mcpSpinner.stop(mcpSuccessCount > 0 ? "Neon MCP Server configuration complete ✓" : "Failed to configure Neon MCP Server");
+		mcpSpinner?.stop(mcpSuccessCount > 0 ? "Neon MCP Server configuration complete ✓" : "Failed to configure Neon MCP Server");
 	}
-	return results;
+	return {
+		results,
+		authSuccess: true
+	};
 }
 //#endregion
 export { installNeon };

package/dist/lib/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","names":[],"sources":["../../src/lib/install.ts"],"sourcesContent":["import { log, spinner } from \"@clack/prompts\";\nimport { execa } from \"execa\";\nimport { getAddMcpAgentId } from \"./agents.js\";\nimport { createApiKeyFromNeonctl, ensureNeonctlAuth } from \"./auth.js\";\nimport {\n\tconfigureExtension,\n\tinstallExtension,\n\tusesExtension,\n\twaitForExtensionInstalled,\n} from \"./extension.js\";\nimport type { Editor, InstallStatus } from \"./types.js\";\n\nconst NEON_MCP_SERVER_URL = \"https://mcp.neon.tech/mcp\";\n\n/**\n * Installs Neon MCP Server for a single editor via the add-mcp CLI.\n * Uses API key authentication via the Authorization header.\n */\nasync function installMCPServerViaAddMcp(\n\teditor: Editor,\n\tapiKey: string,\n): Promise<void> {\n\tconst agentId = getAddMcpAgentId(editor);\n\n\tawait execa(\n\t\t\"npx\",\n\t\t[\n\t\t\t\"-y\",\n\t\t\t\"add-mcp\",\n\t\t\tNEON_MCP_SERVER_URL,\n\t\t\t\"--header\",\n\t\t\t`Authorization: Bearer ${apiKey}`,\n\t\t\t\"-g\",\n\t\t\t\"-n\",\n\t\t\t\"Neon\",\n\t\t\t\"-y\",\n\t\t\t\"-a\",\n\t\t\tagentId,\n\t\t],\n\t\t{\n\t\t\tstdio: \"pipe\",\n\t\t\ttimeout: 60000,\n\t\t},\n\t);\n}\n\n/**\n * Installs Neon's Local Connect extension or MCP Server for specific editors\n */\nexport async function installNeon(\n\tselectedEditors: Editor[],\n): Promise<Map<Editor, InstallStatus>> {\n\tconst results = new Map<Editor, InstallStatus>();\n\n\tconst extensionEditors = selectedEditors.filter(usesExtension);\n\tconst mcpEditors = selectedEditors.filter((e) => !usesExtension(e));\n\n\tif (extensionEditors.length === 0 && mcpEditors.length === 0) {\n\t\treturn results;\n\t}\n\n\tconst authSpinner = spinner();\n\tauthSpinner.start(\"Authenticating...\");\n\n\tconst authSuccess = await ensureNeonctlAuth();\n\n\tif (!authSuccess) {\n\t\tauthSpinner.stop(\"Authentication failed\");\n\t\tfor (const editor of selectedEditors) {\n\t\t\tresults.set(editor, \"failed\");\n\t\t}\n\t\treturn results;\n\t}\n\n\tauthSpinner.stop(\"Authentication successful ✓\");\n\n\t// Create API key using the OAuth token\n\tconst apiKey = await createApiKeyFromNeonctl();\n\n\tif (!apiKey) {\n\t\tlog.error(\"Could not create API key after authentication.\");\n\t\tlog.info(\n\t\t\t\"You can manually create one at: https://console.neon.tech/app/settings/api-keys\",\n\t\t);\n\t\tfor (const editor of selectedEditors) {\n\t\t\tresults.set(editor, \"failed\");\n\t\t}\n\t\treturn results;\n\t}\n\n\tfor (const editor of extensionEditors) {\n\t\tconst installSuccess = await installExtension(editor);\n\n\t\tif (!installSuccess) {\n\t\t\tresults.set(editor, \"failed\");\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst isReady = await waitForExtensionInstalled(editor);\n\t\tif (!isReady) {\n\t\t\t// Extension install command succeeded but extension didn't appear in list\n\t\t\tresults.set(editor, \"failed\");\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Configure the extension with the API key\n\t\tconst configSuccess = await configureExtension(editor, apiKey);\n\n\t\tif (configSuccess) {\n\t\t\tresults.set(editor, \"success\");\n\t\t} else {\n\t\t\t// Extension installed but auth failed but user can manually configure later\n\t\t\tresults.set(editor, \"success\");\n\t\t}\n\t}\n\n\tif (mcpEditors.length > 0) {\n\t\tconst mcpSpinner = spinner();\n\t\tmcpSpinner.start(\"Installing and configuring Neon MCP Server...\");\n\n\t\tlet mcpSuccessCount = 0;\n\t\tfor (const editor of mcpEditors) {\n\t\t\ttry {\n\t\t\t\tawait installMCPServerViaAddMcp(editor, apiKey);\n\t\t\t\tresults.set(editor, \"success\");\n\t\t\t\tmcpSuccessCount++;\n\t\t\t} catch (err) {\n\t\t\t\tresults.set(editor, \"failed\");\n\t\t\t\tif (\n\t\t\t\t\terr &&\n\t\t\t\t\ttypeof err === \"object\" &&\n\t\t\t\t\t\"stderr\" in err &&\n\t\t\t\t\terr.stderr\n\t\t\t\t) {\n\t\t\t\t\tlog.error(\n\t\t\t\t\t\tString(err.stderr).trim() ||\n\t\t\t\t\t\t\t\"failed to install MCP server via add-mcp\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tmcpSpinner.stop(\n\t\t\tmcpSuccessCount > 0\n\t\t\t\t? \"Neon MCP Server configuration complete ✓\"\n\t\t\t\t: \"Failed to configure Neon MCP Server\",\n\t\t);\n\t}\n\n\treturn results;\n}\n"],"mappings":";;;;;;AAYA,MAAM,sBAAsB;;;;;AAM5B,eAAe,0BACd,QACA,QACgB;CAChB,MAAM,UAAU,iBAAiB,OAAO;AAExC,OAAM,MACL,OACA;EACC;EACA;EACA;EACA;EACA,yBAAyB;EACzB;EACA;EACA;EACA;EACA;EACA;EACA,EACD;EACC,OAAO;EACP,SAAS;EACT,CACD;;;;;AAMF,eAAsB,YACrB,iBACsC;CACtC,MAAM,0BAAU,IAAI,KAA4B;CAEhD,MAAM,mBAAmB,gBAAgB,OAAO,cAAc;CAC9D,MAAM,aAAa,gBAAgB,QAAQ,MAAM,CAAC,cAAc,EAAE,CAAC;AAEnE,KAAI,iBAAiB,WAAW,KAAK,WAAW,WAAW,EAC1D,QAAO;CAGR,MAAM,cAAc,SAAS;AAC7B,aAAY,MAAM,oBAAoB;AAItC,KAAI,CAFgB,MAAM,mBAAmB,EAE3B;AACjB,cAAY,KAAK,wBAAwB;AACzC,OAAK,MAAM,UAAU,gBACpB,SAAQ,IAAI,QAAQ,SAAS;AAE9B,SAAO;;AAGR,aAAY,KAAK,8BAA8B;CAG/C,MAAM,SAAS,MAAM,yBAAyB;AAE9C,KAAI,CAAC,QAAQ;AACZ,MAAI,MAAM,iDAAiD;AAC3D,MAAI,KACH,kFACA;AACD,OAAK,MAAM,UAAU,gBACpB,SAAQ,IAAI,QAAQ,SAAS;AAE9B,SAAO;;AAGR,MAAK,MAAM,UAAU,kBAAkB;AAGtC,MAAI,CAFmB,MAAM,iBAAiB,OAAO,EAEhC;AACpB,WAAQ,IAAI,QAAQ,SAAS;AAC7B;;AAID,MAAI,CADY,MAAM,0BAA0B,OAAO,EACzC;AAEb,WAAQ,IAAI,QAAQ,SAAS;AAC7B;;AAMD,MAFsB,MAAM,mBAAmB,QAAQ,OAAO,CAG7D,SAAQ,IAAI,QAAQ,UAAU;MAG9B,SAAQ,IAAI,QAAQ,UAAU;;AAIhC,KAAI,WAAW,SAAS,GAAG;EAC1B,MAAM,aAAa,SAAS;AAC5B,aAAW,MAAM,gDAAgD;EAEjE,IAAI,kBAAkB;AACtB,OAAK,MAAM,UAAU,WACpB,KAAI;AACH,SAAM,0BAA0B,QAAQ,OAAO;AAC/C,WAAQ,IAAI,QAAQ,UAAU;AAC9B;WACQ,KAAK;AACb,WAAQ,IAAI,QAAQ,SAAS;AAC7B,OACC,OACA,OAAO,QAAQ,YACf,YAAY,OACZ,IAAI,OAEJ,KAAI,MACH,OAAO,IAAI,OAAO,CAAC,MAAM,IACxB,2CACD;;AAKJ,aAAW,KACV,kBAAkB,IACf,6CACA,sCACH;;AAGF,QAAO"}
+{"version":3,"file":"install.js","names":[],"sources":["../../src/lib/install.ts"],"sourcesContent":["import { log, spinner } from \"@clack/prompts\";\nimport { execa } from \"execa\";\nimport { getAddMcpAgentId } from \"./agents.js\";\nimport {\n\ttype AuthOptions,\n\tcreateApiKeyFromNeonctl,\n\tensureNeonctlAuth,\n} from \"./auth.js\";\nimport {\n\tconfigureExtension,\n\tinstallExtension,\n\tusesExtension,\n\twaitForExtensionInstalled,\n} from \"./extension.js\";\nimport type { Editor, InstallStatus } from \"./types.js\";\n\nconst NEON_MCP_SERVER_URL = \"https://mcp.neon.tech/mcp\";\n\n/**\n * Installs Neon MCP Server for a single editor via the add-mcp CLI.\n * Uses API key authentication via the Authorization header.\n */\nasync function installMCPServerViaAddMcp(\n\teditor: Editor,\n\tapiKey: string,\n): Promise<void> {\n\tconst agentId = getAddMcpAgentId(editor);\n\n\tawait execa(\n\t\t\"npx\",\n\t\t[\n\t\t\t\"-y\",\n\t\t\t\"add-mcp\",\n\t\t\tNEON_MCP_SERVER_URL,\n\t\t\t\"--header\",\n\t\t\t`Authorization: Bearer ${apiKey}`,\n\t\t\t\"-g\",\n\t\t\t\"-n\",\n\t\t\t\"Neon\",\n\t\t\t\"-y\",\n\t\t\t\"-a\",\n\t\t\tagentId,\n\t\t],\n\t\t{\n\t\t\tstdio: \"pipe\",\n\t\t\ttimeout: 60000,\n\t\t},\n\t);\n}\n\nexport interface InstallNeonOptions {\n\tjson?: boolean;\n}\n\n/**\n * Installs Neon's Local Connect extension or MCP Server for specific editors.\n * Returns a map of editor → install status and whether auth succeeded.\n */\nexport async function installNeon(\n\tselectedEditors: Editor[],\n\toptions?: InstallNeonOptions,\n): Promise<{ results: Map<Editor, InstallStatus>; authSuccess: boolean }> {\n\tconst quiet = options?.json === true;\n\tconst authOptions: AuthOptions = { json: quiet };\n\tconst results = new Map<Editor, InstallStatus>();\n\n\tconst extensionEditors = selectedEditors.filter(usesExtension);\n\tconst mcpEditors = selectedEditors.filter((e) => !usesExtension(e));\n\n\tif (extensionEditors.length === 0 && mcpEditors.length === 0) {\n\t\treturn { results, authSuccess: false };\n\t}\n\n\tconst authSpinner = quiet ? null : spinner();\n\tauthSpinner?.start(\"Authenticating...\");\n\n\tconst authSuccess = await ensureNeonctlAuth(authOptions);\n\n\tif (!authSuccess) {\n\t\tauthSpinner?.stop(\"Authentication failed\");\n\t\tfor (const editor of selectedEditors) {\n\t\t\tresults.set(editor, \"failed\");\n\t\t}\n\t\treturn { results, authSuccess: false };\n\t}\n\n\tauthSpinner?.stop(\"Authentication successful ✓\");\n\n\tconst apiKey = await createApiKeyFromNeonctl(authOptions);\n\n\tif (!apiKey) {\n\t\tif (!quiet) {\n\t\t\tlog.error(\"Could not create API key after authentication.\");\n\t\t\tlog.info(\n\t\t\t\t\"You can manually create one at: https://console.neon.tech/app/settings/api-keys\",\n\t\t\t);\n\t\t}\n\t\tfor (const editor of selectedEditors) {\n\t\t\tresults.set(editor, \"failed\");\n\t\t}\n\t\treturn { results, authSuccess: true };\n\t}\n\n\tfor (const editor of extensionEditors) {\n\t\tconst installSuccess = await installExtension(editor);\n\n\t\tif (!installSuccess) {\n\t\t\tresults.set(editor, \"failed\");\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst isReady = await waitForExtensionInstalled(editor);\n\t\tif (!isReady) {\n\t\t\tresults.set(editor, \"failed\");\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst configSuccess = await configureExtension(editor, apiKey);\n\n\t\tif (configSuccess) {\n\t\t\tresults.set(editor, \"success\");\n\t\t} else {\n\t\t\tresults.set(editor, \"failed\");\n\t\t}\n\t}\n\n\tif (mcpEditors.length > 0) {\n\t\tconst mcpSpinner = quiet ? null : spinner();\n\t\tmcpSpinner?.start(\"Installing and configuring Neon MCP Server...\");\n\n\t\tlet mcpSuccessCount = 0;\n\t\tfor (const editor of mcpEditors) {\n\t\t\ttry {\n\t\t\t\tawait installMCPServerViaAddMcp(editor, apiKey);\n\t\t\t\tresults.set(editor, \"success\");\n\t\t\t\tmcpSuccessCount++;\n\t\t\t} catch (err) {\n\t\t\t\tresults.set(editor, \"failed\");\n\t\t\t\tif (\n\t\t\t\t\t!quiet &&\n\t\t\t\t\terr &&\n\t\t\t\t\ttypeof err === \"object\" &&\n\t\t\t\t\t\"stderr\" in err &&\n\t\t\t\t\terr.stderr\n\t\t\t\t) {\n\t\t\t\t\tlog.error(\n\t\t\t\t\t\tString(err.stderr).trim() ||\n\t\t\t\t\t\t\t\"failed to install MCP server via add-mcp\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tmcpSpinner?.stop(\n\t\t\tmcpSuccessCount > 0\n\t\t\t\t? \"Neon MCP Server configuration complete ✓\"\n\t\t\t\t: \"Failed to configure Neon MCP Server\",\n\t\t);\n\t}\n\n\treturn { results, authSuccess: true };\n}\n"],"mappings":";;;;;;AAgBA,MAAM,sBAAsB;;;;;AAM5B,eAAe,0BACd,QACA,QACgB;CAChB,MAAM,UAAU,iBAAiB,MAAM;CAEvC,MAAM,MACL,OACA;EACC;EACA;EACA;EACA;EACA,yBAAyB;EACzB;EACA;EACA;EACA;EACA;EACA;CACD,GACA;EACC,OAAO;EACP,SAAS;CACV,CACD;AACD;;;;;AAUA,eAAsB,YACrB,iBACA,SACyE;CACzE,MAAM,QAAQ,SAAS,SAAS;CAChC,MAAM,cAA2B,EAAE,MAAM,MAAM;CAC/C,MAAM,0BAAU,IAAI,IAA2B;CAE/C,MAAM,mBAAmB,gBAAgB,OAAO,aAAa;CAC7D,MAAM,aAAa,gBAAgB,QAAQ,MAAM,CAAC,cAAc,CAAC,CAAC;CAElE,IAAI,iBAAiB,WAAW,KAAK,WAAW,WAAW,GAC1D,OAAO;EAAE;EAAS,aAAa;CAAM;CAGtC,MAAM,cAAc,QAAQ,OAAO,QAAQ;CAC3C,aAAa,MAAM,mBAAmB;CAItC,IAAI,CAAC,MAFqB,kBAAkB,WAAW,GAErC;EACjB,aAAa,KAAK,uBAAuB;EACzC,KAAK,MAAM,UAAU,iBACpB,QAAQ,IAAI,QAAQ,QAAQ;EAE7B,OAAO;GAAE;GAAS,aAAa;EAAM;CACtC;CAEA,aAAa,KAAK,6BAA6B;CAE/C,MAAM,SAAS,MAAM,wBAAwB,WAAW;CAExD,IAAI,CAAC,QAAQ;EACZ,IAAI,CAAC,OAAO;GACX,IAAI,MAAM,gDAAgD;GAC1D,IAAI,KACH,iFACD;EACD;EACA,KAAK,MAAM,UAAU,iBACpB,QAAQ,IAAI,QAAQ,QAAQ;EAE7B,OAAO;GAAE;GAAS,aAAa;EAAK;CACrC;CAEA,KAAK,MAAM,UAAU,kBAAkB;EAGtC,IAAI,CAAC,MAFwB,iBAAiB,MAAM,GAE/B;GACpB,QAAQ,IAAI,QAAQ,QAAQ;GAC5B;EACD;EAGA,IAAI,CAAC,MADiB,0BAA0B,MAAM,GACxC;GACb,QAAQ,IAAI,QAAQ,QAAQ;GAC5B;EACD;EAIA,IAAI,MAFwB,mBAAmB,QAAQ,MAAM,GAG5D,QAAQ,IAAI,QAAQ,SAAS;OAE7B,QAAQ,IAAI,QAAQ,QAAQ;CAE9B;CAEA,IAAI,WAAW,SAAS,GAAG;EAC1B,MAAM,aAAa,QAAQ,OAAO,QAAQ;EAC1C,YAAY,MAAM,+CAA+C;EAEjE,IAAI,kBAAkB;EACtB,KAAK,MAAM,UAAU,YACpB,IAAI;GACH,MAAM,0BAA0B,QAAQ,MAAM;GAC9C,QAAQ,IAAI,QAAQ,SAAS;GAC7B;EACD,SAAS,KAAK;GACb,QAAQ,IAAI,QAAQ,QAAQ;GAC5B,IACC,CAAC,SACD,OACA,OAAO,QAAQ,YACf,YAAY,OACZ,IAAI,QAEJ,IAAI,MACH,OAAO,IAAI,MAAM,CAAC,CAAC,KAAK,KACvB,0CACF;EAEF;EAGD,YAAY,KACX,kBAAkB,IACf,6CACA,qCACJ;CACD;CAEA,OAAO;EAAE;EAAS,aAAa;CAAK;AACrC"}

package/dist/lib/neonctl.d.ts

@@ -0,0 +1,51 @@
+//#region src/lib/neonctl.d.ts
+/**
+ * Derives --api-host and --oauth-host flags from the NEON_API_HOST env var.
+ *
+ * When NEON_API_HOST is set (e.g. "https://console-stage.neon.build"), neonctl
+ * commands need explicit flags:
+ *   --api-host https://console-stage.neon.build/api/v2
+ *   --oauth-host https://oauth2-stage.neon.build
+ *
+ * The oauth host is derived by replacing the "console" prefix in the hostname
+ * with "oauth2" (e.g. console-stage.neon.build → oauth2-stage.neon.build).
+ */
+declare function getNeonctlApiFlags(): string;
+/**
+ * Returns the neonctl command prefix: "CI= npx -y neonctl" with any
+ * --api-host / --oauth-host flags appended when NEON_API_HOST is set.
+ *
+ * Usage: `${neonctlCmd()} orgs list --output json`
+ */
+declare function neonctlCmd(): string;
+/**
+ * Detects which package manager was used to invoke the current process.
+ * Reads the `npm_config_user_agent` env var set by npm/pnpm/yarn/bun when
+ * they spawn child processes (including via `npx`, `pnpx`, `bunx`, etc.).
+ *
+ * Falls back to "npm" if detection fails.
+ */
+declare function detectPackageManager(): "npm" | "pnpm" | "yarn" | "bun";
+interface NeonctlStatus {
+  installed: boolean;
+  currentVersion: string | null;
+  latestVersion: string | null;
+  needsUpdate: boolean;
+}
+/**
+ * Checks whether the neonctl CLI is globally installed and whether it's up to date.
+ */
+declare function checkNeonctl(): Promise<NeonctlStatus>;
+interface EnsureNeonctlResult {
+  status: "already_current" | "installed" | "updated" | "failed";
+  version?: string;
+  error?: string;
+}
+/**
+ * Ensures neonctl is globally installed and up to date.
+ * Uses the same package manager that invoked the init command.
+ */
+declare function ensureNeonctl(): Promise<EnsureNeonctlResult>;
+//#endregion
+export { EnsureNeonctlResult, checkNeonctl, detectPackageManager, ensureNeonctl, getNeonctlApiFlags, neonctlCmd };
+//# sourceMappingURL=neonctl.d.ts.map

package/dist/lib/neonctl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neonctl.d.ts","names":[],"sources":["../../src/lib/neonctl.ts"],"mappings":";;AAaA;AA2BA;AAYA;AAQC;AAkDD;;;;AAA6C;AAiD7C;AAUsB,iBA5JN,kBAAA,CAAA,CA4JmB,EAAA,MAAA;;;;AAAW;;;iBAjI9B,UAAA,CAAA;;;;;;;;iBAYA,oBAAA,CAAA;UA6BN,aAAA;;;;;;;;;iBA6BY,YAAA,CAAA,GAAgB,QAAQ;UAiD7B,mBAAA;;;;;;;;;iBAUK,aAAA,CAAA,GAAiB,QAAQ"}

package/dist/lib/neonctl.js

@@ -0,0 +1,184 @@
+import { execa } from "execa";
+//#region src/lib/neonctl.ts
+/**
+* Derives --api-host and --oauth-host flags from the NEON_API_HOST env var.
+*
+* When NEON_API_HOST is set (e.g. "https://console-stage.neon.build"), neonctl
+* commands need explicit flags:
+*   --api-host https://console-stage.neon.build/api/v2
+*   --oauth-host https://oauth2-stage.neon.build
+*
+* The oauth host is derived by replacing the "console" prefix in the hostname
+* with "oauth2" (e.g. console-stage.neon.build → oauth2-stage.neon.build).
+*/
+function getNeonctlApiFlags() {
+	const apiHost = process.env.NEON_API_HOST;
+	if (!apiHost) return "";
+	const apiUrl = `${apiHost.replace(/\/+$/, "")}/api/v2`;
+	let oauthUrl = "";
+	try {
+		const url = new URL(apiHost);
+		url.hostname = url.hostname.replace(/^console/, "oauth2");
+		oauthUrl = url.origin;
+	} catch {}
+	const flags = [`--api-host ${apiUrl}`];
+	if (oauthUrl) flags.push(`--oauth-host ${oauthUrl}`);
+	return flags.join(" ");
+}
+/**
+* Returns the neonctl command prefix: "CI= npx -y neonctl" with any
+* --api-host / --oauth-host flags appended when NEON_API_HOST is set.
+*
+* Usage: `${neonctlCmd()} orgs list --output json`
+*/
+function neonctlCmd() {
+	const flags = getNeonctlApiFlags();
+	return flags ? `CI= npx -y neonctl ${flags}` : "CI= npx -y neonctl";
+}
+/**
+* Detects which package manager was used to invoke the current process.
+* Reads the `npm_config_user_agent` env var set by npm/pnpm/yarn/bun when
+* they spawn child processes (including via `npx`, `pnpx`, `bunx`, etc.).
+*
+* Falls back to "npm" if detection fails.
+*/
+function detectPackageManager() {
+	const ua = process.env.npm_config_user_agent;
+	if (ua) {
+		if (ua.startsWith("pnpm/")) return "pnpm";
+		if (ua.startsWith("yarn/")) return "yarn";
+		if (ua.startsWith("bun/")) return "bun";
+	}
+	return "npm";
+}
+/**
+* Returns the global install command for a given package manager.
+*/
+function globalInstallArgs(pm, pkg) {
+	switch (pm) {
+		case "pnpm": return {
+			command: "pnpm",
+			args: [
+				"add",
+				"-g",
+				pkg
+			]
+		};
+		case "yarn": return {
+			command: "yarn",
+			args: [
+				"global",
+				"add",
+				pkg
+			]
+		};
+		case "bun": return {
+			command: "bun",
+			args: [
+				"add",
+				"-g",
+				pkg
+			]
+		};
+		default: return {
+			command: "npm",
+			args: [
+				"install",
+				"-g",
+				pkg
+			]
+		};
+	}
+}
+/**
+* Gets the currently available neonctl version.
+* Tries the global binary first, then falls back to npx.
+*/
+async function getNeonctlVersion() {
+	try {
+		const match = (await execa("neonctl", ["--version"], {
+			stdio: "pipe",
+			timeout: 5e3
+		})).stdout.trim().match(/(\d+\.\d+\.\d+)/);
+		if (match) return match[1];
+	} catch {}
+	return null;
+}
+/**
+* Checks whether the neonctl CLI is globally installed and whether it's up to date.
+*/
+async function checkNeonctl() {
+	const currentVersion = await getNeonctlVersion();
+	if (!currentVersion) return {
+		installed: false,
+		currentVersion: null,
+		latestVersion: null,
+		needsUpdate: true
+	};
+	let latestVersion = null;
+	try {
+		latestVersion = (await execa("npm", [
+			"view",
+			"neonctl",
+			"version"
+		], {
+			stdio: "pipe",
+			timeout: 1e4
+		})).stdout.trim();
+	} catch {
+		return {
+			installed: true,
+			currentVersion,
+			latestVersion: null,
+			needsUpdate: false
+		};
+	}
+	const needsUpdate = currentVersion !== null && latestVersion !== null && currentVersion !== latestVersion && isOlderVersion(currentVersion, latestVersion);
+	return {
+		installed: true,
+		currentVersion,
+		latestVersion,
+		needsUpdate
+	};
+}
+function isOlderVersion(current, latest) {
+	const c = current.split(".").map(Number);
+	const l = latest.split(".").map(Number);
+	for (let i = 0; i < 3; i++) {
+		if ((c[i] ?? 0) < (l[i] ?? 0)) return true;
+		if ((c[i] ?? 0) > (l[i] ?? 0)) return false;
+	}
+	return false;
+}
+/**
+* Ensures neonctl is globally installed and up to date.
+* Uses the same package manager that invoked the init command.
+*/
+async function ensureNeonctl() {
+	const check = await checkNeonctl();
+	if (check.installed && !check.needsUpdate) return {
+		status: "already_current",
+		version: check.currentVersion ?? void 0
+	};
+	const { command, args } = globalInstallArgs(detectPackageManager(), "neonctl");
+	try {
+		await execa(command, args, {
+			stdio: "pipe",
+			timeout: 6e4
+		});
+		const version = await getNeonctlVersion();
+		return {
+			status: check.installed ? "updated" : "installed",
+			version: version ?? void 0
+		};
+	} catch (err) {
+		return {
+			status: "failed",
+			error: err instanceof Error ? err.message : "Unknown error"
+		};
+	}
+}
+//#endregion
+export { checkNeonctl, detectPackageManager, ensureNeonctl, getNeonctlApiFlags, neonctlCmd };
+
+//# sourceMappingURL=neonctl.js.map