neonctl 2.28.0 → 2.29.0

package/dist/commands/checkout.js

@@ -1,50 +1,50 @@
-import { isNeonApiError } from '../api.js';
-import chalk from 'chalk';
-import prompts from 'prompts';
-import { applyContext, contextBranch, readContextFile } from '../context.js';
-import { isCi } from '../env.js';
-import { log } from '../log.js';
-import { createBranch, pickBranchInteractively, } from '../utils/branch_picker.js';
-import { fillSingleProject } from '../utils/enrichers.js';
-import { looksLikeBranchId } from '../utils/formats.js';
-import { autoPullEnvAfterPin } from './env.js';
-import { applyPolicyOnCreate, createBranchFromPolicyOnCheckout, } from './config.js';
-import { handler as linkHandler } from './link.js';
+import chalk from "chalk";
+import prompts from "prompts";
+import { isNeonApiError } from "../api.js";
+import { applyContext, contextBranch, readContextFile } from "../context.js";
+import { isCi } from "../env.js";
+import { log } from "../log.js";
+import { createBranch, pickBranchInteractively, } from "../utils/branch_picker.js";
+import { fillSingleProject } from "../utils/enrichers.js";
+import { looksLikeBranchId } from "../utils/formats.js";
+import { applyPolicyOnCreate, createBranchFromPolicyOnCheckout, } from "./config.js";
+import { autoPullEnvAfterPin } from "./env.js";
+import { handler as linkHandler } from "./link.js";
 // The positional is optional: omitting it in an interactive terminal opens a
 // branch picker. In non-interactive contexts a missing branch is an error.
-export const command = 'checkout [id|name]';
-export const describe = 'Pin a branch in the local context (.neon) so subsequent commands target it';
+export const command = "checkout [id|name]";
+export const describe = "Pin a branch in the local context (.neon) so subsequent commands target it";
 export const builder = (argv) => argv
-    .usage('$0 checkout [id|name] [options]')
-    .positional('id', {
-    describe: 'Branch name or id to check out. Omit to pick interactively from the list of branches.',
-    type: 'string',
+    .usage("$0 checkout [id|name] [options]")
+    .positional("id", {
+    describe: "Branch name or id to check out. Omit to pick interactively from the list of branches.",
+    type: "string",
 })
     .options({
-    'project-id': {
-        describe: 'Project ID',
-        type: 'string',
+    "project-id": {
+        describe: "Project ID",
+        type: "string",
     },
-    'env-pull': {
+    "env-pull": {
         describe: "Pull the branch's Neon env vars (DATABASE_URL, …) into a local .env after " +
-            'checkout. On by default; use --no-env-pull to skip (e.g. when injecting env at ' +
-            'runtime with `neon-env run` / `neon dev`).',
-        type: 'boolean',
+            "checkout. On by default; use --no-env-pull to skip (e.g. when injecting env at " +
+            "runtime with `neon-env run` / `neon dev`).",
+        type: "boolean",
         default: true,
     },
 })
     .example([
     [
-        '$0 checkout',
-        'Pick a branch interactively from the project in the closest .neon file',
+        "$0 checkout",
+        "Pick a branch interactively from the project in the closest .neon file",
     ],
     [
-        '$0 checkout main',
+        "$0 checkout main",
         'Pin the branch named "main" in the closest .neon file',
     ],
     [
-        '$0 checkout br-cool-snow-12345678 --project-id project-id-123',
-        'Pin a branch by id for an explicit project',
+        "$0 checkout br-cool-snow-12345678 --project-id project-id-123",
+        "Pin a branch by id for an explicit project",
     ],
 ]);
 export const handler = async (props) => {
@@ -53,7 +53,7 @@ export const handler = async (props) => {
     // Read straight from `.neon` (a name, no API call); silent when nothing is pinned yet.
     const previousBranch = contextBranch(readContextFile(props.contextFile));
     if (previousBranch) {
-        log.info('%s Currently on branch %s', chalk.dim('→'), chalk.cyan.bold(previousBranch));
+        log.info("%s Currently on branch %s", chalk.dim("→"), chalk.cyan.bold(previousBranch));
     }
     // Branch listing is project-scoped, so `projectId` is the only thing
     // `checkout` actually needs. Resolve it through the standard chain
@@ -72,7 +72,7 @@ export const handler = async (props) => {
         ...(orgId ? { orgId } : {}),
         branch: branchName,
     });
-    log.info('Checked out branch %s on project %s%s. Updated %s.', branchId, projectId, orgId ? ` (org ${orgId})` : '', props.contextFile);
+    log.info("Checked out branch %s on project %s%s. Updated %s.", branchId, projectId, orgId ? ` (org ${orgId})` : "", props.contextFile);
     // When checkout *created* the branch and a neon.ts exists, the branch was created straight
     // from the policy (evaluated as a new branch) so its settings/infra are already applied —
     // see `policyApplied`. The fallback below covers the case where the branch was created bare
@@ -100,11 +100,11 @@ const resolveBranchId = async (props, projectId) => {
         .data.branches;
     if (!props.id) {
         const picked = await pickBranchInteractively(branches, {
-            message: 'Which branch would you like to check out?',
-            nonInteractiveMessage: 'No branch specified. Pass a branch name or id (e.g. `neonctl checkout main`), ' +
-                'or run interactively to pick one from a list.',
+            message: "Which branch would you like to check out?",
+            nonInteractiveMessage: "No branch specified. Pass a branch name or id (e.g. `neonctl checkout main`), " +
+                "or run interactively to pick one from a list.",
         });
-        if (picked.kind === 'existing') {
+        if (picked.kind === "existing") {
             const existing = branches.find((b) => b.id === picked.branchId);
             return {
                 branchId: picked.branchId,
@@ -145,8 +145,8 @@ const resolveBranchId = async (props, projectId) => {
     }
     log.error(notFoundMessage(ref, branches));
     const { create } = await prompts({
-        type: 'confirm',
-        name: 'create',
+        type: "confirm",
+        name: "create",
         message: `Branch "${ref}" does not exist. Create it now?`,
         initial: true,
     });
@@ -186,7 +186,7 @@ const createCheckoutBranch = async (props, projectId, name, branches) => {
 };
 const notFoundMessage = (ref, branches) => `Branch ${ref} not found.\nAvailable branches: ${branches
     .map((b) => b.name)
-    .join(', ')}`;
+    .join(", ")}`;
 /**
  * Resolve the org id to heal into the context file.
  *
@@ -209,7 +209,7 @@ const resolveOrgId = async (props, projectId) => {
         if (isNeonApiError(err) && err.status === 401) {
             throw err;
         }
-        log.debug('checkout: could not resolve org id for project %s: %s', projectId, err instanceof Error ? err.message : String(err));
+        log.debug("checkout: could not resolve org id for project %s: %s", projectId, err instanceof Error ? err.message : String(err));
         return undefined;
     }
 };
@@ -232,21 +232,21 @@ const resolveProjectId = async (props) => {
     if (autoDetected) {
         return autoDetected;
     }
-    const missingProjectMessage = 'Could not determine which Neon project to check out a branch from. ' +
-        'Provide one via the --project-id flag ' +
-        'or a .neon file (created by `neonctl link` / `neonctl set-context`).';
+    const missingProjectMessage = "Could not determine which Neon project to check out a branch from. " +
+        "Provide one via the --project-id flag " +
+        "or a .neon file (created by `neonctl link` / `neonctl set-context`).";
     if (isCi() || !process.stdout.isTTY) {
         throw new Error(missingProjectMessage);
     }
     log.error(missingProjectMessage);
     const { runLink } = await prompts({
-        type: 'confirm',
-        name: 'runLink',
-        message: 'Run `neonctl link` in the current folder to pick a project now?',
+        type: "confirm",
+        name: "runLink",
+        message: "Run `neonctl link` in the current folder to pick a project now?",
         initial: true,
     });
     if (!runLink) {
-        throw new Error('Aborted: no project selected. Re-run with --project-id or link a project first.');
+        throw new Error("Aborted: no project selected. Re-run with --project-id or link a project first.");
     }
     await linkHandler({
         ...props,
@@ -257,7 +257,7 @@ const resolveProjectId = async (props) => {
     });
     const linked = readContextFile(props.contextFile);
     if (!linked.projectId) {
-        throw new Error('Linking did not produce a project id. Re-run `neonctl checkout` once the directory is linked.');
+        throw new Error("Linking did not produce a project id. Re-run `neonctl checkout` once the directory is linked.");
     }
     // Carry the freshly-linked org id forward so the merge below keeps it.
     if (linked.orgId) {
@@ -283,7 +283,7 @@ const tryAutoDetectProject = async (props) => {
         if (isNeonApiError(err)) {
             throw err;
         }
-        log.debug('checkout: could not auto-detect a single project: %s', err instanceof Error ? err.message : String(err));
+        log.debug("checkout: could not auto-detect a single project: %s", err instanceof Error ? err.message : String(err));
         return undefined;
     }
 };