neon 8.11.0 → 8.11.2

package/dist/commands/link.js

@@ -1,936 +1 @@
-import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
-import { isInteractiveTerminal } from "../env.js";
-import { log } from "../log.js";
-import { isNeonApiError, messageFromBody } from "../api.js";
-import { r as defaultDir } from "../_chunks/paths-DMq0Lt7a.js";
-import "../config.js";
-import { applyContext, contextBranch, readContextFile, setContext, updateContextFile } from "../context.js";
-import { isClaimableEnvTarget } from "../claimable/state.js";
-import { getCliName } from "../utils/cli_name.js";
-import { helpEpilogue } from "../utils/help_text.js";
-import { hasNeonConfigFile, projectDir } from "../project.js";
-import { writer } from "../writer.js";
-import { createBranch, pickBranchInteractively } from "../utils/branch_picker.js";
-import { looksLikeBranchId } from "../utils/formats.js";
-import { listAllProjectBranches } from "../utils/enrichers.js";
-import { autoPullEnvAfterPin } from "./env.js";
-import { initCmd } from "./config.js";
-import { formatLinkSummary } from "./link_output.js";
-import { REGIONS } from "./projects.js";
-import prompts from "prompts";
-//#region src/commands/link.ts
-var link_exports = /* @__PURE__ */ __exportAll({
-	builder: () => builder,
-	command: () => command,
-	describe: () => describe,
-	handler: () => handler,
-	quoteFlagValue: () => quoteFlagValue,
-	runLink: () => runLink,
-	shouldOfferConfigInit: () => shouldOfferConfigInit
-});
-const PROJECTS_LIST_LIMIT = 100;
-const CREATE_NEW_SENTINEL = "__create_new__";
-const canPromptInteractively = () => isInteractiveTerminal();
-const nonInteractiveLinkCommands = () => {
-	const cli = getCliName();
-	return [
-		`${cli} link -y`,
-		`${cli} orgs list --output json`,
-		`${cli} projects list --org-id <org-id> --output json`,
-		`${cli} link --project-id <project-id> [--branch <name> | -y]`,
-		`${cli} link --org-id <org-id> --project-name <name> --region-id aws-us-east-2`
-	];
-};
-const nonInteractiveLinkHelp = () => nonInteractiveLinkCommands().map((command) => `  ${command}`).join("\n");
-const orgScopedKeyHint = "Organization-scoped API keys cannot list orgs; pass --org-id.";
-const command = "link";
-const describe = "Link the current directory to a Neon project";
-const builder = (argv) => argv.usage("$0 link [options]").options({
-	"org-id": {
-		describe: "Organization ID to link to",
-		type: "string"
-	},
-	"project-id": {
-		describe: "Existing project ID to link to",
-		type: "string"
-	},
-	"project-name": {
-		describe: "Name for a new project to create and link to",
-		type: "string"
-	},
-	"region-id": {
-		describe: "Region ID for a new project (e.g. aws-us-east-2). Required with --project-name.",
-		type: "string"
-	},
-	branch: {
-		alias: "branch-id",
-		describe: "Branch name or ID to pin in the context (resolved to its name before writing).",
-		type: "string"
-	},
-	params: {
-		describe: "JSON object with link parameters, e.g. '{\"orgId\":\"...\",\"projectId\":\"...\"}' or '{\"orgId\":\"...\",\"projectName\":\"...\",\"regionId\":\"...\"}'. Flags take precedence over fields in --params.",
-		type: "string"
-	},
-	yes: {
-		alias: "y",
-		describe: "Skip prompts. Select the only organization and project, or print IDs and the flag to pass. Pin the default branch when several exist. Does not create a project unless --project-name and --region-id are set.",
-		type: "boolean",
-		default: false
-	},
-	clear: {
-		describe: "Remove the org/project/branch context (writes an empty context file) instead of linking.",
-		type: "boolean",
-		default: false
-	},
-	checks: {
-		describe: "Verify the org/project/branch exist (and resolve the org from the project) before writing. On by default; use --no-checks to write the context offline with no API calls — it then requires --org-id, --project-id, and --branch, and skips env pull.",
-		type: "boolean",
-		default: true
-	},
-	"env-pull": {
-		describe: "Pull the linked branch's Neon env vars (DATABASE_URL, …) into a local .env after linking. On by default; use --no-env-pull to skip (e.g. when injecting env at runtime with `neon-env run` / `neon dev`). Only runs when a branch is pinned.",
-		type: "boolean",
-		default: true
-	},
-	config: {
-		describe: "Offer to create neon.ts after interactive linking. Use --no-config to skip the offer",
-		type: "boolean",
-		default: true
-	}
-}).example([
-	["$0 link -y", "Select the only organization and project, or print the --org-id / --project-id to pass"],
-	["$0 link --project-id polished-snowflake-12345678", "Link an existing project (org is inferred). Pins the only branch; several prompt in a TTY, or -y pins the default"],
-	["$0 link --project-id polished-snowflake-12345678 -y", "Same, pinning the project's default branch when several exist"],
-	["$0 link --org-id org-… --project-name my-app --region-id aws-us-east-2", "Create a new project and link it"],
-	["$0 link --branch-id br-…", "Pin a branch in the already-linked project"],
-	["$0 link --no-checks --org-id org-… --project-id polished-snowflake-12345678 --branch main", "Write the context offline (no API calls, no verification)"],
-	["$0 link --clear", "Forget the current org/project/branch context"]
-]).epilogue(helpEpilogue("Non-interactive (CI, scripts, agents):", ...nonInteractiveLinkCommands().map((command) => `  ${command}`), orgScopedKeyHint)).strict();
-const runLink = async (props) => {
-	if (props.clear) {
-		clearContext(props.contextFile);
-		return;
-	}
-	if (!props.checks) {
-		runWithoutChecks(props);
-		return;
-	}
-	const inputs = parseInputs(props);
-	validateInputs(inputs);
-	const existing = readContextFile(props.contextFile);
-	if (props.yes && hasIncompleteCreationInputs(inputs)) throw incompleteCreationError(props, inputs);
-	if (canResolveNonInteractively(inputs, existing)) {
-		await runNonInteractive(props, inputs, existing);
-		return;
-	}
-	if (props.yes) {
-		const resolved = await resolveYesInputs(props, inputs);
-		await runNonInteractive(props, resolved, existing);
-		return;
-	}
-	if (!canPromptInteractively()) {
-		if (missingProjectForOrg(inputs)) throw orgNeedsProjectError(props, inputs);
-		throw new LinkInputError([
-			"Missing inputs and no interactive terminal for prompts.",
-			"",
-			"Use:",
-			nonInteractiveLinkHelp(),
-			orgScopedKeyHint
-		].join("\n"));
-	}
-	await runInteractive(props, inputs);
-};
-const handler = runLink;
-const parseInputs = (props) => {
-	let fromParams = {};
-	if (props.params !== void 0 && props.params !== "") {
-		let parsed;
-		try {
-			parsed = JSON.parse(props.params);
-		} catch (err) {
-			const message = err instanceof Error ? err.message : String(err);
-			throw new Error(`Failed to parse --params JSON: ${message}`);
-		}
-		fromParams = extractParams(parsed);
-	}
-	return {
-		orgId: props.orgId ?? fromParams.orgId,
-		projectId: props.projectId ?? fromParams.projectId,
-		projectName: props.projectName ?? fromParams.projectName,
-		regionId: props.regionId ?? fromParams.regionId,
-		branch: props.branch ?? fromParams.branch
-	};
-};
-const extractParams = (raw) => {
-	if (raw === null || typeof raw !== "object") throw new Error("--params must be a JSON object");
-	const obj = raw;
-	const pickString = (key) => {
-		const value = obj[key];
-		if (value === void 0 || value === null) return void 0;
-		if (typeof value !== "string") throw new Error(`--params.${key} must be a string`);
-		return value;
-	};
-	return {
-		orgId: pickString("orgId"),
-		projectId: pickString("projectId"),
-		projectName: pickString("projectName"),
-		regionId: pickString("regionId"),
-		branch: pickString("branch") ?? pickString("branchId")
-	};
-};
-const validateInputs = (inputs) => {
-	if (inputs.projectId && (inputs.projectName || inputs.regionId)) throw new Error("Conflicting inputs: --project-id selects an existing project; --project-name and --region-id describe a new one. Pass only one set.");
-	if (inputs.projectName && inputs.branch) throw new Error(`Conflicting inputs: --branch pins a branch of an existing project, but --project-name creates a new one. Create the project first, then \`${getCliName()} checkout <branch>\`.`);
-};
-const hasIncompleteCreationInputs = (inputs) => Boolean(inputs.projectName) !== Boolean(inputs.regionId);
-const missingProjectForOrg = (inputs) => Boolean(inputs.orgId) && !inputs.projectId && !inputs.projectName;
-const orgNeedsProjectError = (props, inputs) => {
-	const orgId = inputs.orgId ?? "<org-id>";
-	const branchFlag = inputs.branch ? ` --branch ${quoteFlagValue(inputs.branch)}` : "";
-	const session = sessionRetryFlags(props);
-	return new LinkInputError([
-		"No project selected. Pass --project-id, or use -y to select the only project:",
-		`  ${getCliName()} link -y --org-id ${quoteFlagValue(orgId)}${branchFlag}${session}`,
-		`  ${getCliName()} link --org-id ${quoteFlagValue(orgId)} --project-id <project-id>${inputs.branch ? ` --branch ${quoteFlagValue(inputs.branch)}` : " --branch <name-or-id>"}${session}`
-	].join("\n"));
-};
-const quoteFlagValue = (value) => {
-	if (/^[A-Za-z0-9_./:@-]+$/.test(value)) return value;
-	return `'${value.replace(/'/g, `'\\''`)}'`;
-};
-const sessionRetryFlags = (props) => {
-	const flags = [];
-	if (props.contextFile) flags.push(`--context-file ${quoteFlagValue(props.contextFile)}`);
-	if (props.configDir && props.configDir !== defaultDir) flags.push(`--config-dir ${quoteFlagValue(props.configDir)}`);
-	if (props.output !== "table") flags.push(`--output ${props.output}`);
-	if (!props.envPull) flags.push("--no-env-pull");
-	if (props.profile) flags.push(`--profile ${quoteFlagValue(props.profile)}`);
-	return flags.length > 0 ? ` ${flags.join(" ")}` : "";
-};
-const incompleteCreationError = (props, inputs) => {
-	const orgFlag = inputs.orgId ? `--org-id ${quoteFlagValue(inputs.orgId)}` : "--org-id <org-id>";
-	const nameFlag = inputs.projectName ? `--project-name ${quoteFlagValue(inputs.projectName)}` : "--project-name <name>";
-	const regionFlag = inputs.regionId ? `--region-id ${quoteFlagValue(inputs.regionId)}` : "--region-id aws-us-east-2";
-	const example = `${getCliName()} link -y ${orgFlag} ${nameFlag} ${regionFlag}${sessionRetryFlags(props)}`;
-	if (inputs.projectName) return new LinkInputError(`--project-name requires --region-id. Example:\n  ${example}`);
-	return new LinkInputError(`--region-id requires --project-name. Example:\n  ${example}`);
-};
-/**
-* Branch selection may still prompt after org and project resolve without the
-* org/project wizard.
-*/
-const canResolveNonInteractively = (inputs, existing) => {
-	if (inputs.projectId) return true;
-	if (inputs.orgId && inputs.projectName && inputs.regionId) return true;
-	if (inputs.branch && existing.projectId) return true;
-	return false;
-};
-const clearContext = (contextFile) => {
-	updateContextFile(contextFile, {});
-	process.stdout.write(`Cleared ${contextFile}. The directory is no longer linked to a Neon org/project/branch.\n`);
-};
-/**
-* `--no-checks`: write the context offline. Makes no API calls — so no org
-* inference, no existence/access verification, and no env pull — which means
-* the caller must supply `--org-id`, `--project-id`, and `--branch`. This is
-* the CLI surface over {@link setContext}, useful for scripted/offline setups
-* and for re-creating a `.neon` from values you already trust.
-*/
-const runWithoutChecks = (props) => {
-	const inputs = parseInputs(props);
-	validateInputs(inputs);
-	if (inputs.projectName) throw new Error("--no-checks can't create a project (that needs API access). Pass --org-id and --project-id for an existing project, or drop --no-checks.");
-	if (!inputs.orgId || !inputs.projectId || !inputs.branch) throw new Error("--no-checks requires --org-id, --project-id, and --branch because identifiers cannot be resolved offline.");
-	setContext(props.contextFile, {
-		orgId: inputs.orgId,
-		projectId: inputs.projectId,
-		branch: inputs.branch
-	});
-	printSummary(props, {
-		contextFile: props.contextFile,
-		orgId: inputs.orgId,
-		projectId: inputs.projectId,
-		branch: inputs.branch,
-		created: false,
-		noChecks: true
-	});
-};
-var LinkInputError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "LinkInputError";
-	}
-};
-const httpStatus = (err) => isNeonApiError(err) ? err.status : void 0;
-/** 401 must reach the global handler so it can refresh credentials. */
-const fetchProjectOrThrow = async (props, projectId) => {
-	try {
-		const { data } = await props.apiClient.getProject(projectId);
-		return data.project;
-	} catch (err) {
-		const status = httpStatus(err);
-		if (status === 401) throw err;
-		if (status === 403) throw new LinkInputError(`You don't have access to project '${projectId}'. Check that your API key's account or organization can see it.`);
-		if (status === 404) throw new LinkInputError(`Project '${projectId}' not found. Double-check the project ID — or that your API key has access to it.`);
-		throw err;
-	}
-};
-/**
-* Confirm the org exists and is reachable with the current API key by listing
-* its projects (allowed for both user and org-scoped keys). Maps 403/404 to a
-* clear message; 401 is rethrown for credential refresh.
-*/
-const verifyOrgAccess = async (props, orgId) => {
-	try {
-		await props.apiClient.listProjects({
-			org_id: orgId,
-			limit: PROJECTS_LIST_LIMIT
-		});
-	} catch (err) {
-		const status = httpStatus(err);
-		if (status === 401) throw err;
-		if (status === 403 || status === 404) throw new LinkInputError(`Organization '${orgId}' not found, or your API key doesn't have access to it. Find your org ID in the Neon Console under Settings.`);
-		throw err;
-	}
-};
-const failWithBranchCandidates = (props, projectId, branches, reason) => {
-	writer(props).end(branches.map((b) => ({
-		id: b.id,
-		name: b.name ?? b.id
-	})), {
-		fields: ["id", "name"],
-		title: "Branches"
-	});
-	const orgFlag = props.orgId ? ` --org-id ${quoteFlagValue(props.orgId)}` : "";
-	throw new LinkInputError(`${reason}\n  ${getCliName()} link -y${orgFlag} --project-id ${quoteFlagValue(projectId)} --branch <name-or-id>${sessionRetryFlags(props)}`);
-};
-const listAllBranches = async (props, projectId) => listAllProjectBranches(props.apiClient, projectId);
-/**
-* The branch listing for {@link resolvePinnedBranch}, started alongside the project check
-* except on Claimable Neon, which does not complete concurrent Management API reads. Only
-* the listing starts early: branch selection, which can prompt or create a branch, still
-* waits for the check, and a listing error is reported only after the check passes.
-*/
-const branchListing = (props, projectId) => {
-	if (isClaimableEnvTarget({
-		apiHost: props.apiHost,
-		contextFile: props.contextFile,
-		configDir: props.configDir ?? ""
-	})) return () => listAllBranches(props, projectId);
-	const listing = listAllBranches(props, projectId);
-	listing.catch(() => void 0);
-	return () => listing;
-};
-/**
-* Resolve a branch reference (name *or* id) to the matching branch, while
-* confirming it actually exists in the project. Unlike the shared
-* `branchIdResolve`, this also verifies references that already look like ids
-* (so a typo'd `br-…` doesn't silently get written).
-*/
-const resolveBranchRef = (props, projectId, branchRef, branches) => {
-	const match = branches.find((b) => b.id === branchRef) ?? branches.find((b) => b.name === branchRef);
-	if (match) return match;
-	return failWithBranchCandidates(props, projectId, branches, `Branch '${branchRef}' not found in project '${projectId}'. Pass --branch with a name or ID from the list:`);
-};
-/**
-* Persist the name when later commands will look it up as a name. A name that
-* already looks like a branch id is trusted as an id without listing, so keep
-* the real id in that case.
-*/
-const branchPersistValue = (branch) => {
-	if (branch.name && !looksLikeBranchId(branch.name)) return branch.name;
-	return branch.id;
-};
-/**
-* Verify the project (and the org, when supplied) and resolve the org id to
-* persist.
-*
-* The project is always fetched, which both validates it and yields its
-* `org_id`. When `--org-id` is passed too: if the project reports an org it must
-* match (else a clear mismatch error); if it reports none, fail rather than
-* attaching an unrelated org. Without `--org-id` the project's own org is used.
-* Projects on a personal account have no org, so `undefined` is a valid result —
-* the field is simply omitted.
-*/
-const resolveOrgForProject = async (props, inputs, projectId) => {
-	const project = await fetchProjectOrThrow(props, projectId);
-	const projectOrg = project.org_id ?? void 0;
-	const projectName = project.name;
-	if (inputs.orgId) {
-		if (projectOrg && projectOrg !== inputs.orgId) throw new LinkInputError(`Project '${projectId}' belongs to organization '${projectOrg}', not '${inputs.orgId}'. Omit --org-id to use the project's own org, or pass the matching ID.`);
-		if (!projectOrg) throw new LinkInputError(`Project '${projectId}' does not report an organization matching --org-id ${inputs.orgId}. Omit --org-id to link using the project's own context.`);
-		return {
-			orgId: inputs.orgId,
-			projectName
-		};
-	}
-	return {
-		orgId: projectOrg,
-		projectName
-	};
-};
-const pinnedRef = (branch) => ({
-	branchId: branch.id,
-	branchName: branch.name ?? branch.id,
-	usedDefault: false
-});
-const resolution = (branch) => ({
-	branch: branchPersistValue(branch),
-	ref: pinnedRef(branch)
-});
-/**
-* Keep a same-project pin only after it still resolves on the project.
-*/
-const resolvePinnedBranch = async (props, inputs, existing, projectId, listBranches) => {
-	const branches = await listBranches();
-	if (inputs.branch) return resolution(resolveBranchRef(props, projectId, inputs.branch, branches));
-	if (projectId === existing.projectId) {
-		const pinned = contextBranch(existing);
-		if (pinned) return resolution(resolveBranchRef(props, projectId, pinned, branches));
-	}
-	return resolveBranchFromList(props, projectId, branches);
-};
-const resolveBranchFromList = async (props, projectId, branches) => {
-	if (branches.length === 0) throw new LinkInputError(`Project '${projectId}' has no branches to link. Create or restore a branch before retrying, or select another project with --project-id.`);
-	if (branches.length === 1) {
-		const [only] = branches;
-		if (!only) throw new LinkInputError(`Project '${projectId}' has no branches to link. Create or restore a branch before retrying, or select another project with --project-id.`);
-		return resolution(only);
-	}
-	if (props.yes) {
-		const def = branches.find((b) => b.default);
-		if (!def) return failWithBranchCandidates(props, projectId, branches, `Project '${projectId}' has no default branch. Pass --branch with a name or ID from the list:`);
-		return resolution(def);
-	}
-	if (canPromptInteractively()) {
-		const picked = await pickBranchInteractively(branches, {
-			message: "Which branch would you like to link?",
-			nonInteractiveMessage: "No branch could be selected without an interactive terminal. Pass --branch <name-or-id>, or -y to pin the default branch."
-		});
-		if (picked.kind === "existing") {
-			const existing = branches.find((b) => b.id === picked.branchId);
-			return existing ? resolution(existing) : {
-				branch: picked.branchId,
-				ref: pinnedRef({ id: picked.branchId })
-			};
-		}
-		const createdBranch = {
-			id: await createBranch(props.apiClient, projectId, picked.name, branches),
-			name: picked.name
-		};
-		return {
-			branch: branchPersistValue(createdBranch),
-			ref: pinnedRef(createdBranch)
-		};
-	}
-	return failWithBranchCandidates(props, projectId, branches, `Project '${projectId}' has multiple branches. Pass --branch <name-or-id>, or -y to pin its default branch.`);
-};
-const runNonInteractive = async (props, inputs, existing) => {
-	if (inputs.projectName) {
-		const orgId = mustString(inputs.orgId, "orgId");
-		await verifyOrgAccess(props, orgId);
-		const created = await createProject(props, {
-			orgId,
-			name: inputs.projectName,
-			regionId: mustString(inputs.regionId, "regionId")
-		});
-		applyContext(props.contextFile, {
-			orgId,
-			projectId: created.project.id,
-			branch: created.branchName
-		});
-		await finalizeLink(props, {
-			contextFile: props.contextFile,
-			orgId,
-			projectId: created.project.id,
-			branch: created.branchName,
-			branchRef: pinnedRef({
-				id: created.branchId,
-				name: created.branchName
-			}),
-			created: true,
-			projectName: created.project.name,
-			regionId: created.project.region_id
-		});
-		return;
-	}
-	if (inputs.projectId) {
-		const listBranches = branchListing(props, inputs.projectId);
-		const { orgId, projectName } = await resolveOrgForProject(props, inputs, inputs.projectId);
-		const resolved = await resolvePinnedBranch(props, inputs, existing, inputs.projectId, listBranches);
-		applyContext(props.contextFile, {
-			orgId,
-			projectId: inputs.projectId,
-			branch: resolved.branch
-		});
-		await finalizeLink(props, {
-			contextFile: props.contextFile,
-			orgId,
-			projectId: inputs.projectId,
-			projectName,
-			branch: resolved.branch,
-			branchRef: resolved.ref,
-			created: false
-		});
-		return;
-	}
-	if (inputs.branch && existing.projectId) {
-		const projectId = existing.projectId;
-		const listBranches = branchListing(props, projectId);
-		const { orgId, projectName } = await resolveOrgForProject(props, inputs, projectId);
-		const resolved = await resolvePinnedBranch(props, inputs, existing, projectId, listBranches);
-		applyContext(props.contextFile, {
-			orgId,
-			projectId,
-			branch: resolved.branch
-		});
-		await finalizeLink(props, {
-			contextFile: props.contextFile,
-			orgId,
-			projectId,
-			projectName,
-			branch: resolved.branch,
-			branchRef: resolved.ref,
-			created: false
-		});
-		return;
-	}
-	throw orgNeedsProjectError(props, inputs);
-};
-const runInteractive = async (props, inputs) => {
-	if (!props.yes) {
-		if (!await confirmRelinkIfNeeded(props)) return;
-	}
-	const orgResolution = await resolveOrg(props, inputs.orgId);
-	let orgId;
-	if (orgResolution.kind === "resolved") {
-		orgId = orgResolution.orgId;
-		if (orgResolution.autoDetected) log.info(`Detected organization ${orgId} from your existing projects (organization-scoped API key).`);
-	} else if (orgResolution.orgKeyLimited) throw new Error("This API key is organization-scoped, so the CLI cannot list your organizations, and no existing project was found in this org to auto-detect the ID. Re-run with `--org-id <your_org_id>` (find it in the Neon Console under Settings).");
-	else orgId = await promptOrgFromList(orgResolution.orgs);
-	if (inputs.projectName && inputs.regionId) {
-		if (inputs.branch) throw new Error(`Conflicting inputs: --branch pins a branch of an existing project, but --project-name creates a new one. Create the project first, then \`${getCliName()} checkout <branch>\`.`);
-		const created = await createProject(props, {
-			orgId,
-			name: inputs.projectName,
-			regionId: inputs.regionId
-		});
-		applyContext(props.contextFile, {
-			orgId,
-			projectId: created.project.id,
-			branch: created.branchName
-		});
-		await finalizeInteractiveLink(props, {
-			contextFile: props.contextFile,
-			orgId,
-			projectId: created.project.id,
-			branch: created.branchName,
-			branchRef: pinnedRef({
-				id: created.branchId,
-				name: created.branchName
-			}),
-			created: true,
-			projectName: created.project.name,
-			regionId: created.project.region_id
-		});
-		return;
-	}
-	const projects = await listAllProjects(props, orgId);
-	const action = await promptProjectChoice(projects, inputs.projectName, { allowCreate: !inputs.branch });
-	if (action.type === "existing") {
-		const existing = readContextFile(props.contextFile);
-		const resolved = await resolvePinnedBranch(props, inputs, existing, action.projectId, () => listAllBranches(props, action.projectId));
-		applyContext(props.contextFile, {
-			orgId,
-			projectId: action.projectId,
-			branch: resolved.branch
-		});
-		await finalizeInteractiveLink(props, {
-			contextFile: props.contextFile,
-			orgId,
-			projectId: action.projectId,
-			branch: resolved.branch,
-			branchRef: resolved.ref,
-			created: false,
-			projectName: action.name,
-			regionId: action.regionId
-		});
-		return;
-	}
-	if (inputs.branch) throw new Error(`Conflicting inputs: --branch pins a branch of an existing project, but creating a project starts from its default branch. Link an existing project, or omit --branch and create first.`);
-	const projectName = inputs.projectName ?? await promptProjectName(action.suggestedName);
-	const regionId = inputs.regionId ?? await promptRegion(props);
-	const created = await createProject(props, {
-		orgId,
-		name: projectName,
-		regionId
-	});
-	applyContext(props.contextFile, {
-		orgId,
-		projectId: created.project.id,
-		branch: created.branchName
-	});
-	await finalizeInteractiveLink(props, {
-		contextFile: props.contextFile,
-		orgId,
-		projectId: created.project.id,
-		branch: created.branchName,
-		branchRef: pinnedRef({
-			id: created.branchId,
-			name: created.branchName
-		}),
-		created: true,
-		projectName: created.project.name,
-		regionId: created.project.region_id
-	});
-};
-const confirmRelinkIfNeeded = async (props) => {
-	const existing = readContextFile(props.contextFile);
-	if (!existing.projectId) return true;
-	const { proceed } = await prompts({
-		onState: onPromptState,
-		type: "confirm",
-		name: "proceed",
-		message: existing.orgId ? `${props.contextFile} is already linked to project ${existing.projectId} (org ${existing.orgId}). Re-link?` : `${props.contextFile} is already linked to project ${existing.projectId}. Re-link?`,
-		initial: true
-	});
-	if (!proceed) {
-		process.stdout.write("Aborted. Existing link preserved.\n");
-		return false;
-	}
-	return true;
-};
-const promptOrgFromList = async (orgs) => {
-	if (!orgs.length) throw new Error(`You don't belong to any organizations. Create one in the Neon Console first: https://console.neon.tech/`);
-	if (orgs.length === 1) {
-		const [only] = orgs;
-		log.info(`Linking organization ${only.name} (${only.id}).`);
-		return only.id;
-	}
-	const { orgId } = await prompts({
-		onState: onPromptState,
-		type: "select",
-		name: "orgId",
-		message: "Which organization would you like to link?",
-		choices: orgs.map((org) => ({
-			title: `${org.name} (${org.id})`,
-			value: org.id
-		})),
-		initial: 0
-	});
-	return orgId;
-};
-const promptProjectChoice = async (projects, suggestedName, opts) => {
-	const choices = [...opts.allowCreate ? [{
-		title: "＋ Create new project…",
-		value: CREATE_NEW_SENTINEL
-	}] : [], ...projects.map((project) => ({
-		title: `${project.name} (${project.id})`,
-		value: project.id
-	}))];
-	if (choices.length === 0) throw new LinkInputError("No projects are available to link. Omit --branch to create a project, or pass --project-id for an existing one.");
-	const createOffset = opts.allowCreate ? 1 : 0;
-	const { selection } = await prompts({
-		onState: onPromptState,
-		type: "select",
-		name: "selection",
-		message: "Which project would you like to link?",
-		choices,
-		initial: projects.length > 0 ? createOffset : 0
-	});
-	if (selection === CREATE_NEW_SENTINEL) return {
-		type: "create",
-		suggestedName
-	};
-	const project = projects.find((p) => p.id === selection);
-	return {
-		type: "existing",
-		projectId: selection,
-		name: project?.name,
-		regionId: project?.region_id
-	};
-};
-const promptProjectName = async (suggestedName) => {
-	const { name } = await prompts({
-		onState: onPromptState,
-		type: "text",
-		name: "name",
-		message: "Name for the new project:",
-		initial: suggestedName,
-		validate: (value) => value && value.trim().length > 0 ? true : "Project name is required"
-	});
-	return String(name).trim();
-};
-const promptRegion = async (props) => {
-	const regions = await fetchRegions(props);
-	const defaultIndex = Math.max(0, regions.findIndex((r) => r.default));
-	const { regionId } = await prompts({
-		onState: onPromptState,
-		type: "select",
-		name: "regionId",
-		message: "Which region should the new project run in?",
-		choices: regions.map((region) => ({
-			title: `${region.name} (${region.region_id})`,
-			value: region.region_id
-		})),
-		initial: defaultIndex
-	});
-	return regionId;
-};
-const ORG_KEY_LIMITED_FRAGMENT = "not allowed for organization API keys";
-const isOrgKeyLimitedError = (err) => {
-	if (!isNeonApiError(err)) return false;
-	const message = messageFromBody(err.data);
-	return typeof message === "string" && message.includes(ORG_KEY_LIMITED_FRAGMENT);
-};
-const fetchOrganizations = async (props) => {
-	const { data } = await props.apiClient.getCurrentUserOrganizations();
-	return data.organizations ?? [];
-};
-/**
-* Resolves the org id from the explicit flag, falling back to listing user orgs.
-*
-* For organization-scoped API keys, `getCurrentUserOrganizations` is forbidden;
-* in that case we try to auto-detect the org from the first existing project
-* (since all projects of an org key live in the same org). If no project exists
-* yet, we return `needs_selection` with `orgKeyLimited: true` so callers can
-* give a precise instruction to the user.
-*/
-const resolveOrg = async (props, given) => {
-	if (given) return {
-		kind: "resolved",
-		orgId: given,
-		autoDetected: false
-	};
-	try {
-		return {
-			kind: "needs_selection",
-			orgs: await fetchOrganizations(props),
-			orgKeyLimited: false
-		};
-	} catch (err) {
-		if (!isOrgKeyLimitedError(err)) throw err;
-		log.debug("getCurrentUserOrganizations not allowed (org-scoped API key); attempting to derive org from existing projects.");
-	}
-	const detected = await detectOrgIdFromProjects(props);
-	if (detected) return {
-		kind: "resolved",
-		orgId: detected,
-		autoDetected: true
-	};
-	return {
-		kind: "needs_selection",
-		orgs: [],
-		orgKeyLimited: true
-	};
-};
-const detectOrgIdFromProjects = async (props) => {
-	try {
-		const { data } = await props.apiClient.listProjects({ limit: 1 });
-		return data.projects[0]?.org_id ?? void 0;
-	} catch (err) {
-		const message = err instanceof Error ? err.message : String(err);
-		log.debug("detectOrgIdFromProjects failed: %s", message);
-		return;
-	}
-};
-const listAllProjects = async (props, orgId) => {
-	const result = [];
-	let cursor;
-	while (true) {
-		const { data } = await props.apiClient.listProjects({
-			limit: PROJECTS_LIST_LIMIT,
-			org_id: orgId,
-			cursor
-		});
-		result.push(...data.projects);
-		cursor = data.pagination?.cursor;
-		if (data.projects.length < PROJECTS_LIST_LIMIT) break;
-	}
-	return result;
-};
-const CANDIDATE_FIELDS = ["id", "name"];
-const extraYesFlags = (props, inputs) => {
-	const flags = [];
-	if (inputs.projectName) flags.push(`--project-name ${quoteFlagValue(inputs.projectName)}`);
-	if (inputs.regionId) flags.push(`--region-id ${quoteFlagValue(inputs.regionId)}`);
-	if (inputs.branch) flags.push(`--branch ${quoteFlagValue(inputs.branch)}`);
-	return `${flags.length > 0 ? ` ${flags.join(" ")}` : ""}${sessionRetryFlags(props)}`;
-};
-const yesProjectIdCommand = (props, inputs, orgId = inputs.orgId) => {
-	const orgFlag = orgId ? ` --org-id ${quoteFlagValue(orgId)}` : "";
-	const branchFlag = inputs.branch ? ` --branch ${quoteFlagValue(inputs.branch)}` : "";
-	return `${getCliName()} link -y${orgFlag} --project-id <project-id>${branchFlag}${sessionRetryFlags(props)}`;
-};
-const printNamedCandidates = (props, title, items) => {
-	writer(props).end(items, {
-		fields: CANDIDATE_FIELDS,
-		title
-	});
-};
-const orgScopedKeyNeedsOrgId = () => new LinkInputError("This API key is organization-scoped, so the CLI cannot list your organizations, and no existing project was found in this org to auto-detect the ID. Re-run with `--org-id <your_org_id>` (find it in the Neon Console under Settings).");
-const resolveYesOrgId = async (props, inputs) => {
-	const orgResolution = await resolveOrg(props, inputs.orgId);
-	if (orgResolution.kind === "resolved") {
-		if (orgResolution.autoDetected) log.info(`Detected organization ${orgResolution.orgId} from your existing projects (organization-scoped API key).`);
-		return orgResolution.orgId;
-	}
-	if (orgResolution.orgKeyLimited) throw orgScopedKeyNeedsOrgId();
-	const orgs = orgResolution.orgs;
-	if (orgs.length === 0) throw new LinkInputError(["No organizations were returned for this account. Pass --project-id for a project you can access:", `  ${yesProjectIdCommand(props, inputs)}`].join("\n"));
-	if (orgs.length === 1) {
-		const [only] = orgs;
-		return only.id;
-	}
-	printNamedCandidates(props, "Organizations", orgs.map((org) => ({
-		id: org.id,
-		name: org.name
-	})));
-	throw new LinkInputError(["Multiple organizations are available. Pass --org-id with an ID from the list:", `  ${getCliName()} link -y --org-id <org-id>${extraYesFlags(props, inputs)}`].join("\n"));
-};
-const resolveYesInputs = async (props, inputs) => {
-	const orgId = await resolveYesOrgId(props, inputs);
-	if (inputs.projectName && inputs.regionId) return {
-		...inputs,
-		orgId
-	};
-	const projects = await listAllProjects(props, orgId);
-	if (projects.length === 0) throw new LinkInputError([
-		`No projects are available in organization '${orgId}'.`,
-		"To create and link a project, pass --project-name and --region-id:",
-		`  ${getCliName()} link -y --org-id ${quoteFlagValue(orgId)} --project-name <name> --region-id aws-us-east-2${sessionRetryFlags(props)}`
-	].join("\n"));
-	if (projects.length === 1) {
-		const [only] = projects;
-		return {
-			...inputs,
-			orgId,
-			projectId: only.id
-		};
-	}
-	printNamedCandidates(props, "Projects", projects.map((project) => ({
-		id: project.id,
-		name: project.name
-	})));
-	throw new LinkInputError([`Multiple projects are available in organization '${orgId}'. Pass --project-id with an ID from the list:`, `  ${yesProjectIdCommand(props, inputs, orgId)}`].join("\n"));
-};
-const fetchRegions = async (props) => {
-	try {
-		const { data } = await props.apiClient.getActiveRegions();
-		if (data.regions && data.regions.length > 0) return data.regions;
-	} catch (err) {
-		if (isNeonApiError(err)) log.debug("getActiveRegions failed (%s), falling back to the static region list.", err.status ?? err.code ?? err.message);
-		else {
-			const message = err instanceof Error ? err.message : String(err);
-			log.debug("getActiveRegions failed (%s), falling back to the static region list.", message);
-		}
-	}
-	return staticRegionsFallback();
-};
-const staticRegionsFallback = () => REGIONS.map((id) => ({
-	region_id: id,
-	name: id,
-	default: id === "aws-us-east-2",
-	geo_lat: "",
-	geo_long: ""
-}));
-const createProject = async (props, args) => {
-	const project = {
-		name: args.name,
-		region_id: args.regionId,
-		org_id: args.orgId,
-		branch: {}
-	};
-	const { data } = await props.apiClient.createProject({ project });
-	if (!data.branch?.id) throw new Error("Project was created but the API response did not include a default branch id.");
-	return {
-		project: {
-			id: data.project.id,
-			name: data.project.name,
-			region_id: data.project.region_id
-		},
-		branchId: data.branch.id,
-		branchName: data.branch.name ?? data.branch.id
-	};
-};
-const printSummary = (props, summary) => {
-	process.stdout.write(`${formatLinkSummary(summary, props.cwd ?? process.cwd())}\n`);
-};
-/**
-* Print the link summary, then run the bundled `env pull` so a completed `link` ends with
-* the pinned branch's connection string on disk. `--no-checks` skips the pull because
-* nothing was verified. `--no-env-pull` opts out (env pull's own status / skip hint is
-* logged to stderr).
-*/
-const finalizeLink = async (props, summary) => {
-	printSummary(props, summary);
-	if (!summary.branch || !summary.projectId || summary.noChecks || props.deferEnvPull === true) return;
-	const { config: _offerConfig, ...rest } = props;
-	await autoPullEnvAfterPin({
-		...rest,
-		...props.cwd ? { cwd: props.cwd } : {},
-		projectId: summary.projectId,
-		branch: summary.branch,
-		envPull: props.envPull
-	}, summary.branchRef);
-};
-/**
-* Interactive `link` finalize: the shared {@link finalizeLink} (summary + env
-* pull), then — as the last step — offer to manage the project's Neon setup as
-* code with a `neon.ts`. Kept out of {@link finalizeLink} so the non-interactive
-* paths never prompt.
-*/
-const finalizeInteractiveLink = async (props, summary) => {
-	await finalizeLink(props, summary);
-	await maybeOfferConfigInit(props, summary);
-};
-/**
-* Interactive `link` offers neon.ts only when the directory has none and the
-* caller did not pass --no-config. Init always passes --no-config so it can ask
-* once after linking.
-*/
-const shouldOfferConfigInit = (input) => !input.hasConfig && input.offer;
-const maybeOfferConfigInit = async (props, summary) => {
-	const dir = projectDir({
-		...props.cwd ? { cwd: props.cwd } : {},
-		contextFile: props.contextFile
-	});
-	if (!shouldOfferConfigInit({
-		hasConfig: hasNeonConfigFile(dir),
-		offer: props.config !== false
-	})) return;
-	const { value } = await prompts({
-		onState: onPromptState,
-		type: "confirm",
-		name: "value",
-		message: "Manage this project's Neon setup as code? Adds a neon.ts you can edit and apply with `neon config apply`.",
-		initial: true
-	});
-	if (value !== true) return;
-	await initCmd({
-		cwd: dir,
-		install: true
-	});
-	if (summary.branch && summary.projectId) {
-		const { config: _offerConfig, ...rest } = props;
-		await autoPullEnvAfterPin({
-			...rest,
-			projectId: summary.projectId,
-			branch: summary.branch,
-			envPull: props.envPull
-		}, summary.branchRef);
-	}
-};
-const onPromptState = (state) => {
-	if (state.aborted) {
-		process.stdout.write("\x1B[?25h");
-		process.stdout.write("\n");
-		process.exit(1);
-	}
-};
-const mustString = (value, name) => {
-	if (value === void 0) throw new Error(`Internal error: expected ${name} to be set.`);
-	return value;
-};
-//#endregion
-export { builder, command, describe, handler, quoteFlagValue, runLink, shouldOfferConfigInit, link_exports as t };
+export { t as builder, n as command, r as describe, i as handler, o as quoteFlagValue, s as runLink, c as shouldOfferConfigInit } from "../_chunks/link-BgtkOBws.js";