neon 4.6.0 → 4.8.0

package/dist/init/phases/status.js

@@ -1,82 +0,0 @@
-import { neonInitAgentCmd } from "../profile_cli.js";
-import { tryResolveAddMcpAgentId } from "../../mcp/agents.js";
-import { supportsSkills } from "../agents.js";
-import { isAuthenticated } from "../auth.js";
-import { inspectProject } from "../inspect.js";
-//#region src/init/phases/status.ts
-async function handleStatusPhase(options) {
-	const authed = await isAuthenticated();
-	const inspection = await inspectProject([
-		{
-			id: "mcp_server",
-			description: "",
-			lookFor: []
-		},
-		{
-			id: "database_url",
-			description: "",
-			lookFor: []
-		},
-		{
-			id: "skills",
-			description: "",
-			lookFor: []
-		},
-		{
-			id: "migrations",
-			description: "",
-			lookFor: []
-		}
-	]);
-	const hasDatabaseUrl = inspection.databaseUrl === true;
-	const mcpConfigured = inspection.mcpConfigured === true;
-	const skillsInstalled = inspection.skillsInstalled === true;
-	const migrationTool = inspection.migrationTool ?? null;
-	const hasMigrations = migrationTool !== null && migrationTool !== "none" && inspection.migrationDir !== "none";
-	const recommendations = [];
-	if (!authed) recommendations.push({
-		priority: "high",
-		message: "Not authenticated with Neon",
-		command: neonInitAgentCmd({ step: "auth" })
-	});
-	if (!hasDatabaseUrl) recommendations.push({
-		priority: "high",
-		message: "No DATABASE_URL found in .env",
-		command: neonInitAgentCmd({ step: "db" })
-	});
-	const statusAgent = options.agent ? tryResolveAddMcpAgentId(options.agent) : void 0;
-	if (!skillsInstalled && (!statusAgent || supportsSkills(statusAgent))) recommendations.push({
-		priority: "medium",
-		message: "Neon agent skills not detected in this project",
-		command: neonInitAgentCmd({
-			step: "skills",
-			install: true
-		})
-	});
-	if (migrationTool && !hasMigrations) recommendations.push({
-		priority: "medium",
-		message: `${migrationTool} detected but no migrations found`,
-		command: neonInitAgentCmd({ step: "migrations" })
-	});
-	return {
-		auth: { authenticated: authed },
-		tooling: {
-			mcpServer: {
-				configured: mcpConfigured,
-				scope: inspection.mcpScope || null
-			},
-			skills: {
-				installed: skillsInstalled,
-				scope: inspection.skillsScope || null
-			}
-		},
-		project: { databaseUrl: hasDatabaseUrl },
-		migrations: {
-			tool: migrationTool,
-			hasMigrations
-		},
-		recommendations
-	};
-}
-//#endregion
-export { handleStatusPhase };

package/dist/init/profile_cli.js

@@ -1,56 +0,0 @@
-import { n as configDir } from "../_chunks/paths-g3DRqJiD.js";
-import { t as DEFAULT_PROFILE } from "../_chunks/profiles-D95AeZ5v.js";
-import { i as selectCredential, t as credentialInputs } from "../_chunks/auth_selection-ktL6uoEe.js";
-//#region src/init/profile_cli.ts
-/**
-* API-key selections fall back to DEFAULT because init authenticates from stored credentials.
-*/
-function selectedProfileName() {
-	const selection = selectCredential(credentialInputs());
-	return selection.source === "profile" ? selection.profile : DEFAULT_PROFILE;
-}
-/**
-* An explicit `--config-dir` must override `NEON_CONFIG_DIR` and the home path.
-*/
-function selectedConfigDir() {
-	const recorded = credentialInputs().configDir;
-	return recorded !== "" ? recorded : configDir();
-}
-/**
-* Omitting implicit DEFAULT preserves command compatibility; retaining explicit DEFAULT
-* prevents ambient `NEON_PROFILE` from overriding it in subprocesses.
-*/
-function explicitProfileArgs() {
-	const selection = selectCredential(credentialInputs());
-	if (selection.source === "profile" && selection.explicit) return ["--profile", selection.profile];
-	return [];
-}
-function explicitProfileCli() {
-	const args = explicitProfileArgs();
-	return args.length === 0 ? "" : ` ${args.join(" ")}`;
-}
-function explicitConfigDirArgs() {
-	const dir = credentialInputs().configDir;
-	return dir !== "" ? ["--config-dir", dir] : [];
-}
-function posixSingleQuote(value) {
-	return `'${value.replace(/'/g, `'\\''`)}'`;
-}
-function explicitConfigDirCli() {
-	const dir = credentialInputs().configDir;
-	return dir === "" ? "" : ` --config-dir ${posixSingleQuote(dir)}`;
-}
-function npxNeonArgs(command) {
-	return [
-		"-y",
-		"neon",
-		...explicitProfileArgs(),
-		...explicitConfigDirArgs(),
-		...command
-	];
-}
-function neonInitAgentCmd(data) {
-	return `neon init --agent${explicitProfileCli()}${explicitConfigDirCli()} --data '${JSON.stringify(data)}'`;
-}
-//#endregion
-export { explicitConfigDirCli, explicitProfileArgs, explicitProfileCli, neonInitAgentCmd, npxNeonArgs, selectedConfigDir, selectedProfileName };

package/dist/init/resolve_context.js

@@ -1,105 +0,0 @@
-import { npxNeonArgs } from "./profile_cli.js";
-import { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { execa } from "execa";
-//#region src/init/resolve_context.ts
-/**
-* Resolves the Neon org/project from a DATABASE_URL in .env.
-* Parses the endpoint hostname, then queries the Neon API to find
-* which project it belongs to.
-*/
-/**
-* Extracts the Neon endpoint host from .env's DATABASE_URL or PGHOST.
-* Returns the hostname (e.g. "ep-cool-name-12345.us-east-2.aws.neon.tech") or null.
-*/
-function extractNeonHost(cwd) {
-	for (const envFile of [".env", ".env.local"]) {
-		const envPath = resolve(cwd, envFile);
-		if (!existsSync(envPath)) continue;
-		try {
-			const content = readFileSync(envPath, "utf-8");
-			const dbUrlMatch = content.match(/^DATABASE_URL=.*@([^/:\s]+\.neon\.tech)/m);
-			if (dbUrlMatch) return dbUrlMatch[1];
-			const pgHostMatch = content.match(/^PGHOST=([^\s]+\.neon\.tech)/m);
-			if (pgHostMatch) return pgHostMatch[1];
-		} catch {}
-	}
-	return null;
-}
-/**
-* Resolves the Neon org and project that own the endpoint in DATABASE_URL.
-*
-* Strategy:
-* 1. Extract endpoint hostname from .env
-* 2. List orgs via the Neon CLI
-* 3. For each org, list projects
-* 4. For each project, get connection string and compare hostnames
-* 5. Return the matching org/project
-*/
-async function resolveNeonContext(cwd) {
-	const neonHost = extractNeonHost(cwd);
-	if (!neonHost) return null;
-	let orgs;
-	try {
-		const result = await execa("npx", npxNeonArgs([
-			"orgs",
-			"list",
-			"--output",
-			"json"
-		]), {
-			stdio: "pipe",
-			timeout: 3e4,
-			env: {
-				...process.env,
-				CI: void 0
-			}
-		});
-		orgs = JSON.parse(result.stdout);
-	} catch {
-		return null;
-	}
-	if (orgs.length === 0) return null;
-	for (const org of orgs) {
-		let projects;
-		try {
-			const result = await execa("npx", npxNeonArgs([
-				"projects",
-				"list",
-				"--org-id",
-				org.id,
-				"--output",
-				"json"
-			]), {
-				stdio: "pipe",
-				timeout: 3e4,
-				env: {
-					...process.env,
-					CI: void 0
-				}
-			});
-			projects = JSON.parse(result.stdout);
-		} catch {
-			continue;
-		}
-		for (const project of projects) try {
-			if ((await execa("npx", npxNeonArgs([
-				"connection-string",
-				"--project-id",
-				project.id
-			]), {
-				stdio: "pipe",
-				timeout: 15e3,
-				env: {
-					...process.env,
-					CI: void 0
-				}
-			})).stdout.trim().includes(neonHost)) return {
-				orgId: org.id,
-				projectId: project.id
-			};
-		} catch {}
-	}
-	return null;
-}
-//#endregion
-export { resolveNeonContext };

package/dist/init/route_command.js

@@ -1,93 +0,0 @@
-//#region src/init/route_command.ts
-/**
-* Routes a `--data` payload to a phase handler by its `step` field, without
-* shelling out. This is the whole agent-facing surface of `neon init`:
-*
-*   neon init --agent --data '{"step":"auth"}'
-*   neon init --agent --data '{"step":"db","projectId":"xyz"}'
-*/
-async function routeDataStep(data, agent) {
-	const { step, agentId, ...rest } = data;
-	const resolvedAgent = typeof agentId === "string" ? agentId : agent;
-	if (rest.data !== void 0 && Object.keys(rest).length === 1) {
-		let nested = rest.data;
-		if (typeof nested === "string") try {
-			nested = JSON.parse(nested);
-		} catch {}
-		if (typeof nested === "object" && nested !== null) {
-			Object.assign(rest, nested);
-			delete rest.data;
-		}
-	}
-	switch (step) {
-		case "auth": {
-			const { handleAuthPhase } = await import("./phases/auth.js");
-			return handleAuthPhase({
-				agent: resolvedAgent,
-				...rest
-			});
-		}
-		case "db": {
-			const { handleDbPhase } = await import("./phases/db.js");
-			return handleDbPhase({
-				agent: resolvedAgent,
-				...rest
-			});
-		}
-		case "setup": {
-			const { handleSetupPhase } = await import("./phases/setup.js");
-			return handleSetupPhase({
-				agent: resolvedAgent,
-				...rest
-			});
-		}
-		case "getting-started": {
-			const { handleGettingStartedPhase } = await import("./phases/getting_started.js");
-			return handleGettingStartedPhase({
-				agent: resolvedAgent,
-				...rest,
-				cwd: process.cwd()
-			});
-		}
-		case "mcp": {
-			const { handleMcpPhase } = await import("./phases/mcp.js");
-			return handleMcpPhase({
-				agent: resolvedAgent,
-				...rest
-			});
-		}
-		case "skills": {
-			const { handleSkillsPhase } = await import("./phases/skills.js");
-			return handleSkillsPhase({
-				agent: resolvedAgent,
-				...rest
-			});
-		}
-		case "migrations": {
-			const { handleMigrationsPhase } = await import("./phases/migrations.js");
-			return handleMigrationsPhase({
-				agent: resolvedAgent,
-				...rest,
-				cwd: process.cwd()
-			});
-		}
-		case "neon-auth": {
-			const { handleNeonAuthPhase } = await import("./phases/neon_auth.js");
-			return handleNeonAuthPhase({
-				agent: resolvedAgent,
-				...rest
-			});
-		}
-		case "status": {
-			const { handleStatusPhase } = await import("./phases/status.js");
-			return handleStatusPhase({ agent: resolvedAgent });
-		}
-		case "finalize": {
-			const { handleCleanup } = await import("./phases/cleanup.js");
-			return handleCleanup();
-		}
-		default: throw new Error(`Unknown step: "${step}". Valid steps: auth, db, setup, getting-started, mcp, skills, migrations, neon-auth, status, finalize`);
-	}
-}
-//#endregion
-export { routeDataStep };

package/dist/init/skills.js

@@ -1,206 +0,0 @@
-import { globalInstallCommand, resolveInvokingPackageManager } from "../utils/package_manager.js";
-import { getSkillsAgentName } from "./agents.js";
-import { existsSync, statSync } from "node:fs";
-import { resolve } from "node:path";
-import { log, spinner } from "@clack/prompts";
-import { dim } from "yoctocolors";
-import { execa } from "execa";
-//#region src/init/skills.ts
-/**
-* Ensures the `skills` CLI is globally installed so npx doesn't need
-* to download it (which can fail behind corporate proxies / sandboxes).
-*/
-async function ensureSkillsCli() {
-	try {
-		await execa("skills", ["--version"], {
-			stdio: "pipe",
-			timeout: 5e3
-		});
-	} catch {
-		const install = globalInstallCommand(resolveInvokingPackageManager(), "skills");
-		if (!install) return;
-		try {
-			await execa(install.command, install.args, {
-				stdio: "pipe",
-				timeout: 6e4
-			});
-		} catch {}
-	}
-}
-/** Base skills installed for all invocations */
-const BASE_SKILLS = ["neon", "neon-postgres"];
-/** Additional skills installed for preview (non-bootstrap) invocations */
-const PREVIEW_SKILLS = [
-	"neon-object-storage",
-	"neon-functions",
-	"neon-ai-gateway"
-];
-/** Returns the skill list based on whether preview mode is active */
-function getSkillList(preview) {
-	return preview ? [...BASE_SKILLS, ...PREVIEW_SKILLS] : BASE_SKILLS;
-}
-const SKILL_BASE_URL = "https://neon.com/docs/ai/skills/neon-postgres/references";
-const SKILL_REFERENCE_URLS = {
-	gettingStarted: `${SKILL_BASE_URL}/getting-started.md`,
-	connectionMethods: `${SKILL_BASE_URL}/connection-methods.md`,
-	neonAuth: `${SKILL_BASE_URL}/neon-auth.md`,
-	serverlessDriver: `${SKILL_BASE_URL}/neon-serverless.md`,
-	neonCli: `${SKILL_BASE_URL}/neon-cli.md`,
-	devtools: `${SKILL_BASE_URL}/devtools.md`,
-	branching: `${SKILL_BASE_URL}/branching.md`,
-	neonJs: `${SKILL_BASE_URL}/neon-js.md`
-};
-/**
-* Installs Neon agent skills using Vercel's skills CLI.
-*/
-async function installAgentSkills(selectedAgents, options) {
-	const quiet = options?.json === true;
-	const agentsWithSkills = selectedAgents.filter((id) => getSkillsAgentName(id) !== void 0);
-	if (agentsWithSkills.length === 0) return true;
-	const skillsSpinner = quiet ? null : spinner();
-	skillsSpinner?.start("Installing agent skills for Neon in this project...");
-	let anyFailed = false;
-	await ensureSkillsCli();
-	const skills = getSkillList(options?.preview);
-	for (const agent of agentsWithSkills) {
-		const agentName = getSkillsAgentName(agent);
-		if (!agentName) continue;
-		for (const skill of skills) try {
-			await execa("skills", [
-				"add",
-				"neondatabase/agent-skills",
-				"--skill",
-				skill,
-				"--agent",
-				agentName,
-				...options?.scope === "global" ? ["-g"] : [],
-				"-y"
-			], {
-				stdio: "pipe",
-				timeout: 12e4
-			});
-		} catch (error) {
-			if (!quiet) log.error(`Failed to install skill ${skill} for ${agent}: ${error instanceof Error ? error.message : "Unknown error"}`);
-			anyFailed = true;
-		}
-	}
-	if (anyFailed) {
-		skillsSpinner?.stop("Agent skills installation for this project completed with errors");
-		if (!quiet) log.info("You can manually install skills by running: npx skills add neondatabase/agent-skills --skill neon --skill neon-postgres");
-		return false;
-	}
-	skillsSpinner?.stop(dim("Agent skills installed ✓"));
-	return true;
-}
-const SKILLS_FRESHNESS_MS = 432e5;
-/**
-* Agent skills directory paths by agent, keyed by scope.
-* These are the directories that `skills add` writes to.
-*/
-const GLOBAL_SKILLS_DIRS = (() => {
-	const home = process.env.HOME || process.env.USERPROFILE || "";
-	const agentsDir = resolve(home, ".agents", "skills");
-	return {
-		cursor: [resolve(home, ".cursor", "skills"), agentsDir],
-		"claude-code": [resolve(home, ".claude", "skills"), agentsDir],
-		"github-copilot": [resolve(home, ".vscode", "skills"), agentsDir],
-		codex: [resolve(home, ".codex", "skills"), agentsDir],
-		cline: [resolve(home, ".cline", "skills"), agentsDir],
-		grok: [resolve(home, ".grok", "skills"), agentsDir]
-	};
-})();
-const PROJECT_SKILLS_DIRS = {
-	cursor: [".cursor/skills", ".agents/skills"],
-	"claude-code": [".claude/skills", ".agents/skills"],
-	"github-copilot": [".vscode/skills", ".agents/skills"],
-	codex: [".codex/skills", ".agents/skills"],
-	cline: [".cline/skills", ".agents/skills"],
-	grok: [".grok/skills", ".agents/skills"]
-};
-function skillDirsForAgent(skillsId, scope, cwd, home) {
-	if (scope === "global") return [.../* @__PURE__ */ new Set([...GLOBAL_SKILLS_DIRS[skillsId] ?? [], resolve(home, ".agents", "skills")])];
-	return [...new Set([...PROJECT_SKILLS_DIRS[skillsId] ?? [], ".agents/skills"].map((dir) => resolve(cwd, dir)))];
-}
-function missingSkillsForAgent(agent, options = {}) {
-	const skillsId = getSkillsAgentName(agent);
-	if (!skillsId) return [];
-	const cwd = options.cwd ?? process.cwd();
-	const home = process.env.HOME || process.env.USERPROFILE || "";
-	const dirs = skillDirsForAgent(skillsId, options.scope ?? "project", cwd, home);
-	return getSkillList(options.preview).filter((skill) => !dirs.some((dir) => existsSync(resolve(dir, skill, "SKILL.md"))));
-}
-function skillsInstalledForAgent(agent, cwd = process.cwd(), preview = false) {
-	if (!getSkillsAgentName(agent)) return true;
-	return missingSkillsForAgent(agent, {
-		cwd,
-		scope: "project",
-		preview
-	}).length === 0 || missingSkillsForAgent(agent, {
-		cwd,
-		scope: "global",
-		preview
-	}).length === 0;
-}
-/**
-* Checks whether skills were recently updated (within the freshness window).
-* Checks both project-level (skills-lock.json mtime) and global (skills dir mtime).
-*/
-function skillsAreFresh(agent, requiredSkills) {
-	const now = Date.now();
-	const cwd = process.cwd();
-	const skillsId = getSkillsAgentName(agent);
-	const projectDirs = (skillsId ? PROJECT_SKILLS_DIRS[skillsId] : void 0)?.map((dir) => resolve(cwd, dir)) ?? [];
-	const lockPath = resolve(cwd, "skills-lock.json");
-	if (existsSync(lockPath) && projectDirs.length > 0) try {
-		if (now - statSync(lockPath).mtimeMs < SKILLS_FRESHNESS_MS) {
-			if (requiredSkills.every((skill) => projectDirs.some((dir) => existsSync(resolve(dir, skill, "SKILL.md"))))) return true;
-		}
-	} catch {}
-	const agentName = getSkillsAgentName(agent);
-	if (!agentName) return false;
-	const globalDirs = GLOBAL_SKILLS_DIRS[agentName] ?? [];
-	for (const dir of globalDirs) if (requiredSkills.every((skill) => existsSync(resolve(dir, skill, "SKILL.md")))) try {
-		if (now - statSync(resolve(dir, requiredSkills[0], "SKILL.md")).mtimeMs < SKILLS_FRESHNESS_MS) return true;
-	} catch {}
-	return false;
-}
-/**
-* Ensures Neon agent skills are up to date. Runs `skills add` if the skills
-* haven't been updated within the freshness window (12 hours).
-*
-* Designed to be called from any phase handler — cheap to call repeatedly
-* since it's a no-op when skills are fresh.
-*/
-async function ensureSkillsUpToDate(agent, scope, preview) {
-	const resolvedAgent = agent || "cursor";
-	const agentName = getSkillsAgentName(resolvedAgent);
-	if (!agentName) return true;
-	if (skillsAreFresh(resolvedAgent, getSkillList(preview))) return true;
-	await ensureSkillsCli();
-	let allOk = true;
-	const missingSkills = missingSkillsForAgent(resolvedAgent, {
-		scope: scope ?? "project",
-		preview
-	});
-	if (missingSkills.length === 0) return true;
-	for (const skill of missingSkills) try {
-		await execa("skills", [
-			"add",
-			"neondatabase/agent-skills",
-			"--skill",
-			skill,
-			"--agent",
-			agentName,
-			...scope === "global" ? ["-g"] : [],
-			"-y"
-		], {
-			stdio: "pipe",
-			timeout: 12e4
-		});
-	} catch {
-		allOk = false;
-	}
-	return allOk;
-}
-//#endregion
-export { SKILL_REFERENCE_URLS, ensureSkillsUpToDate, getSkillList, installAgentSkills, missingSkillsForAgent, skillsInstalledForAgent };

package/dist/init/types.js

@@ -1 +0,0 @@
-export {};

package/dist/init/vsix.js

@@ -1,89 +0,0 @@
-import "./build_config.js";
-import { createWriteStream } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import { pipeline } from "node:stream/promises";
-//#region src/init/vsix.ts
-/**
-* Shared VSIX download utilities for extension installation.
-* Supports corporate proxy via NEON_VSX_GALLERY_URL env var.
-*/
-const NEON_EXTENSION_ID = "databricks.neon-local-connect";
-const OPEN_VSX_API = "https://open-vsx.org/api";
-/**
-* Downloads a .vsix file for the Neon extension.
-*
-* Strategy:
-* 1. If NEON_VSX_GALLERY_URL is set, download from the corporate proxy gallery
-* 2. Otherwise, download from the public Open VSX API
-*
-* Returns the path to the temp .vsix file, or null on failure.
-*/
-async function downloadVsix() {
-	const proxyGallery = process.env.NEON_VSX_GALLERY_URL || "";
-	if (proxyGallery) return downloadFromGallery(proxyGallery);
-	return downloadFromOpenVsx();
-}
-/**
-* Downloads from a VS Code marketplace-compatible gallery API (corporate proxy).
-* Uses the VS Code extensionquery POST API to find the VSIX download URL.
-*/
-async function downloadFromGallery(galleryUrl) {
-	const [publisher, name] = NEON_EXTENSION_ID.split(".");
-	const queryUrl = `${galleryUrl.replace(/\/+$/, "")}/extensionquery`;
-	try {
-		const queryRes = await fetch(queryUrl, {
-			method: "POST",
-			headers: {
-				"Content-Type": "application/json",
-				Accept: "application/json;api-version=6.1-preview.1"
-			},
-			body: JSON.stringify({
-				filters: [{ criteria: [{
-					filterType: 7,
-					value: `${publisher}.${name}`
-				}] }],
-				flags: 914
-			}),
-			signal: AbortSignal.timeout(15e3)
-		});
-		if (!queryRes.ok) return null;
-		const vsixFile = (((await queryRes.json()).results?.[0]?.extensions?.[0])?.versions?.[0])?.files?.find((f) => f.assetType === "Microsoft.VisualStudio.Services.VSIXPackage");
-		if (!vsixFile?.source) return null;
-		const vsixRes = await fetch(vsixFile.source, {
-			signal: AbortSignal.timeout(3e4),
-			redirect: "follow"
-		});
-		if (!vsixRes.ok || !vsixRes.body) return null;
-		const tmpPath = join(tmpdir(), `${NEON_EXTENSION_ID}-proxy.vsix`);
-		const fileStream = createWriteStream(tmpPath);
-		await pipeline(vsixRes.body, fileStream);
-		return tmpPath;
-	} catch {
-		return null;
-	}
-}
-/**
-* Downloads from the public Open VSX API.
-*/
-async function downloadFromOpenVsx() {
-	const [publisher, name] = NEON_EXTENSION_ID.split(".");
-	const metaUrl = `${OPEN_VSX_API}/${publisher}/${name}/latest`;
-	try {
-		const metaRes = await fetch(metaUrl, { signal: AbortSignal.timeout(1e4) });
-		if (!metaRes.ok) return null;
-		const meta = await metaRes.json();
-		const downloadUrl = meta.files?.download;
-		if (!downloadUrl) return null;
-		const vsixRes = await fetch(downloadUrl, { signal: AbortSignal.timeout(3e4) });
-		if (!vsixRes.ok || !vsixRes.body) return null;
-		const tmpPath = join(tmpdir(), `${NEON_EXTENSION_ID}-${meta.version ?? "latest"}.vsix`);
-		const fileStream = createWriteStream(tmpPath);
-		await pipeline(vsixRes.body, fileStream);
-		return tmpPath;
-	} catch {
-		return null;
-	}
-}
-//#endregion
-export { NEON_EXTENSION_ID, downloadVsix };