neonctl 2.27.1 → 2.29.0

package/dist/help.js

@@ -1,16 +1,16 @@
-import cliui from 'cliui';
-import chalk from 'chalk';
-import { consumeBlockIfMatches, consumeNextMatching, drawPointer, splitColumns, } from './utils/ui.js';
+import chalk from "chalk";
+import cliui from "cliui";
+import { consumeBlockIfMatches, consumeNextMatching, drawPointer, splitColumns, } from "./utils/ui.js";
 // target width for the leftmost column
 const SPACE_WIDTH = 20;
 const formatHelp = (help) => {
-    const lines = help.split('\n');
+    const lines = help.split("\n");
     const result = [];
     // full command, like `neonctl projects list`
     const topLevelCommand = consumeNextMatching(lines, /^.*/);
     if (topLevelCommand) {
-        result.push(chalk.bold(topLevelCommand.replace('[options]', chalk.reset.green('[options]'))));
-        result.push('');
+        result.push(chalk.bold(topLevelCommand.replace("[options]", chalk.reset.green("[options]"))));
+        result.push("");
     }
     // commands description block
     // example command to see: neonctl projects
@@ -24,7 +24,7 @@ const formatHelp = (help) => {
         commandsBlock.forEach((line) => {
             if (/^\s{3,}/.exec(line)) {
                 ui.div({
-                    text: '',
+                    text: "",
                     width: SPACE_WIDTH,
                     padding: [0, 0, 0, 0],
                 }, { text: line.trim(), padding: [0, 0, 0, 0] });
@@ -44,7 +44,7 @@ const formatHelp = (help) => {
             }, { text: description, padding: [0, 0, 0, 2] });
         });
         result.push(ui.toString());
-        result.push('');
+        result.push("");
     }
     // positional args block
     // example command to see: neonctl branches rename
@@ -67,14 +67,14 @@ const formatHelp = (help) => {
             });
         });
         result.push(ui.toString());
-        result.push('');
+        result.push("");
     }
     // command description
     // example command to see: neonctl projects list
     const descriptionBlock = consumeBlockIfMatches(lines, /^(?!.*options:)/i);
     if (descriptionBlock.length > 0) {
         result.push(...descriptionBlock);
-        result.push('');
+        result.push("");
     }
     while (true) {
         // there are two options blocks: global and specific
@@ -89,7 +89,7 @@ const formatHelp = (help) => {
             const ui = cliui({
                 width: 0,
             });
-            if (option.startsWith('-')) {
+            if (option.startsWith("-")) {
                 ui.div({
                     text: chalk.green(option),
                     padding: [0, 0, 0, 0],
@@ -99,14 +99,14 @@ const formatHelp = (help) => {
                     width: SPACE_WIDTH,
                     padding: [0, 2, 0, 0],
                 }, {
-                    text: chalk.rgb(210, 210, 210)(description ?? ''),
+                    text: chalk.rgb(210, 210, 210)(description ?? ""),
                     padding: [0, 0, 0, 0],
                 });
             }
             else {
                 ui.div({
                     padding: [0, 0, 0, 0],
-                    text: '',
+                    text: "",
                     width: SPACE_WIDTH,
                 }, {
                     text: chalk.rgb(210, 210, 210)(option),
@@ -115,7 +115,7 @@ const formatHelp = (help) => {
             }
             result.push(ui.toString());
         });
-        result.push('');
+        result.push("");
     }
     const exampleBlock = consumeBlockIfMatches(lines, /Examples:/);
     if (exampleBlock.length > 0) {
@@ -141,6 +141,6 @@ const formatHelp = (help) => {
 export const showHelp = async (argv) => {
     // add wrap to ensure that there are no line breaks
     const help = await argv.getHelp();
-    process.stderr.write(formatHelp(help).join('\n') + '\n');
+    process.stderr.write(formatHelp(help).join("\n") + "\n");
     process.exit(0);
 };

package/dist/index.js

@@ -1,122 +1,111 @@
-import { basename } from 'node:path';
-import yargs from 'yargs';
-import { hideBin } from 'yargs/helpers';
-import axiosDebug from 'axios-debug-log';
-axiosDebug({
-    request(debug, config) {
-        debug(`${config.method?.toUpperCase()} ${config.url}`);
-    },
-    response(debug, response) {
-        debug(`${response.status} ${response.statusText}`);
-    },
-    error(debug, error) {
-        debug(error);
-    },
-});
-import { ensureAuth, deleteCredentials } from './commands/auth.js';
-import { defaultDir, ensureConfigDir } from './config.js';
-import { log } from './log.js';
-import { defaultClientID } from './auth.js';
-import { fillInArgs } from './utils/middlewares.js';
-import pkg from './pkg.js';
-import commands from './commands/index.js';
-import { analyticsMiddleware, initAnalyticsClientMiddleware, closeAnalytics, getAnalyticsEventProperties, sendError, trackEvent, } from './analytics.js';
-import { isAxiosError } from 'axios';
-import { matchErrorCode } from './errors.js';
-import { showHelp } from './help.js';
-import { currentContextFile, enrichFromContext } from './context.js';
+import { basename } from "node:path";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { analyticsMiddleware, closeAnalytics, getAnalyticsEventProperties, initAnalyticsClientMiddleware, sendError, trackEvent, } from "./analytics.js";
+import { isNeonApiError, messageFromBody } from "./api.js";
+import { defaultClientID } from "./auth.js";
+import { deleteCredentials, ensureAuth } from "./commands/auth.js";
+import commands from "./commands/index.js";
+import { defaultDir, ensureConfigDir } from "./config.js";
+import { currentContextFile, enrichFromContext } from "./context.js";
+import { isNetworkError, matchErrorCode, NETWORK_ERROR_MESSAGE, } from "./errors.js";
+import { showHelp } from "./help.js";
+import { log } from "./log.js";
+import pkg from "./pkg.js";
+import { fillInArgs } from "./utils/middlewares.js";
 const NO_SUBCOMMANDS_VERBS = [
     // aliases
-    'auth',
-    'login',
-    'me',
-    // aliases
-    'cs',
-    'connection-string',
-    'psql',
-    'set-context',
-    'checkout',
-    'link',
-    'init',
-    'dev',
-    'deploy',
-    'bootstrap',
+    "auth",
+    "login",
+    "me",
     // aliases
+    "cs",
+    "connection-string",
+    "psql",
+    "set-context",
+    "checkout",
+    "link",
+    "init",
+    "dev",
+    "deploy",
+    "bootstrap",
+    // alias of `config status`
+    "status",
 ];
 let builder = yargs(hideBin(process.argv));
 builder = builder
     .scriptName(pkg.name)
-    .locale('en')
-    .usage('$0 <command> [options]')
+    .locale("en")
+    .usage("$0 <command> [options]")
     .parserConfiguration({
-    'populate--': true,
+    "populate--": true,
 })
     .help()
-    .option('output', {
-    alias: 'o',
-    group: 'Global options:',
-    describe: 'Set output format',
-    type: 'string',
-    choices: ['json', 'yaml', 'table'],
-    default: 'table',
+    .option("output", {
+    alias: "o",
+    group: "Global options:",
+    describe: "Set output format",
+    type: "string",
+    choices: ["json", "yaml", "table"],
+    default: "table",
 })
-    .option('api-host', {
-    describe: 'The API host',
+    .option("api-host", {
+    describe: "The API host",
     hidden: true,
-    default: process.env.NEON_API_HOST ?? 'https://console.neon.tech/api/v2',
+    default: process.env.NEON_API_HOST ?? "https://console.neon.tech/api/v2",
 })
     // Setup config directory
-    .option('config-dir', {
-    describe: 'Path to config directory',
-    group: 'Global options:',
-    type: 'string',
+    .option("config-dir", {
+    describe: "Path to config directory",
+    group: "Global options:",
+    type: "string",
     default: defaultDir,
 })
-    .option('force-auth', {
-    describe: 'Force authentication',
-    type: 'boolean',
+    .option("force-auth", {
+    describe: "Force authentication",
+    type: "boolean",
     hidden: true,
     default: false,
 })
     .middleware(ensureConfigDir)
     .options({
-    'oauth-host': {
-        description: 'URL to Neon OAuth host',
+    "oauth-host": {
+        description: "URL to Neon OAuth host",
         hidden: true,
-        default: process.env.NEON_OAUTH_HOST ?? 'https://oauth2.neon.tech',
+        default: process.env.NEON_OAUTH_HOST ?? "https://oauth2.neon.tech",
     },
-    'client-id': {
-        description: 'OAuth client id',
+    "client-id": {
+        description: "OAuth client id",
         hidden: true,
-        type: 'string',
+        type: "string",
         default: defaultClientID,
     },
-    'api-key': {
-        describe: 'API key',
-        group: 'Global options:',
-        type: 'string',
-        default: process.env.NEON_API_KEY ?? '',
+    "api-key": {
+        describe: "API key",
+        group: "Global options:",
+        type: "string",
+        default: process.env.NEON_API_KEY ?? "",
     },
     apiClient: {
         hidden: true,
         coerce: (v) => v,
         default: null,
     },
-    'context-file': {
-        describe: 'Context file',
-        type: 'string',
+    "context-file": {
+        describe: "Context file",
+        type: "string",
         default: currentContextFile,
     },
     color: {
-        group: 'Global options:',
-        describe: 'Colorize the output. Example: --no-color, --color false',
-        type: 'boolean',
+        group: "Global options:",
+        describe: "Colorize the output. Example: --no-color, --color false",
+        type: "boolean",
         default: true,
     },
     analytics: {
-        describe: 'Manage analytics. Example: --no-analytics, --analytics false',
-        group: 'Global options:',
-        type: 'boolean',
+        describe: "Manage analytics. Example: --no-analytics, --analytics false",
+        group: "Global options:",
+        type: "boolean",
         default: true,
     },
 })
@@ -125,13 +114,13 @@ builder = builder
 }, true)
     .middleware(initAnalyticsClientMiddleware, true)
     .help(false)
-    .group('help', 'Global options:')
-    .option('help', {
-    describe: 'Show help',
-    type: 'boolean',
+    .group("help", "Global options:")
+    .option("help", {
+    describe: "Show help",
+    type: "boolean",
     default: false,
 })
-    .alias('help', 'h')
+    .alias("help", "h")
     .middleware(async (args) => {
     if (args.help ||
         (args._.length === 1 &&
@@ -145,51 +134,65 @@ builder = builder
     .command(commands)
     .strictCommands()
     .version(pkg.version)
-    .group('version', 'Global options:')
-    .alias('version', 'v')
+    .group("version", "Global options:")
+    .alias("version", "v")
     .completion()
-    .scriptName(basename(process.argv[1]) === 'neon' ? 'neon' : 'neonctl')
-    .epilog('For more information, visit https://neon.com/docs/reference/neon-cli')
+    .scriptName(basename(process.argv[1]) === "neon" ? "neon" : "neonctl")
+    .epilog("For more information, visit https://neon.com/docs/reference/neon-cli")
     .wrap(null)
     .fail(false);
 async function handleError(msg, err) {
-    if (process.argv.some((arg) => arg === '--help' || arg === '-h')) {
+    if (process.argv.some((arg) => arg === "--help" || arg === "-h")) {
         await showHelp(builder);
         process.exit(0);
     }
     // Log stack trace if available
     if (err instanceof Error && err.stack) {
-        log.debug('Stack: %s', err.stack);
+        log.debug("Stack: %s", err.stack);
+    }
+    // A connection-level failure (no response ever reached us) reads as a cryptic
+    // `fetch failed` from the @neon/sdk / global `fetch` path. Detect it first and
+    // swap in one clear "check your connection" hint. We deliberately do not retry
+    // here: re-running the whole command could re-trigger a non-idempotent step
+    // (e.g. project create), so retries belong at the request layer.
+    if (isNetworkError(err)) {
+        log.error(NETWORK_ERROR_MESSAGE);
+        const error = err instanceof Error ? err : new Error(NETWORK_ERROR_MESSAGE);
+        sendError(error, "NETWORK_ERROR");
+        return false;
     }
-    if (isAxiosError(err)) {
-        if (err.code === 'ECONNABORTED') {
-            log.error('Request timed out');
-            sendError(err, 'REQUEST_TIMEOUT');
+    if (isNeonApiError(err)) {
+        if (err.code === "ECONNABORTED") {
+            log.error("Request timed out");
+            sendError(err, "REQUEST_TIMEOUT");
             return false;
         }
-        else if (err.response?.status === 401) {
-            sendError(err, 'AUTH_FAILED');
-            log.info('Authentication failed, deleting credentials...');
+        else if (err.status === 401) {
+            sendError(err, "AUTH_FAILED");
+            log.info("Authentication failed, deleting credentials...");
             try {
                 deleteCredentials(defaultDir);
                 return true; // Allow retry for auth failures
             }
             catch (deleteErr) {
-                log.debug('Failed to delete credentials: %s', deleteErr instanceof Error ? deleteErr.message : 'unknown error');
+                log.debug("Failed to delete credentials: %s", deleteErr instanceof Error
+                    ? deleteErr.message
+                    : "unknown error");
                 return false;
             }
         }
         else {
-            if (err.response?.data?.message) {
-                log.error(err.response?.data?.message);
+            const serverMessage = messageFromBody(err.data);
+            if (serverMessage) {
+                log.error(serverMessage);
             }
-            log.debug('status: %d %s | path: %s', err.response?.status, err.response?.statusText, err.request?.path);
-            sendError(err, 'API_ERROR');
+            log.debug("status: %d %s | path: %s", err.status, err.statusText, err.requestPath);
+            sendError(err, "API_ERROR");
             return false;
         }
     }
     else {
-        const error = err instanceof Error ? err : new Error(msg || 'Unknown error');
+        const error = err instanceof Error ? err : new Error(msg || "Unknown error");
         sendError(error, matchErrorCode(error.message));
         log.error(error.message);
         return false;
@@ -203,7 +206,7 @@ void (async () => {
         try {
             const args = await builder.argv;
             // Send analytics for a successful attempt
-            trackEvent('cli_command_success', {
+            trackEvent("cli_command_success", {
                 ...getAnalyticsEventProperties(args),
                 projectId: args.projectId,
                 branchId: args.branchId,
@@ -220,7 +223,7 @@ void (async () => {
         }
         catch (err) {
             attempts++;
-            const shouldRetry = await handleError('', err);
+            const shouldRetry = await handleError("", err);
             if (!shouldRetry || attempts >= MAX_ATTEMPTS) {
                 await closeAnalytics();
                 process.exit(1);

package/dist/log.js

@@ -1,5 +1,5 @@
-import { format } from 'node:util';
-import { isDebug } from './env.js';
+import { format } from "node:util";
+import { isDebug } from "./env.js";
 export const log = {
     debug: (...args) => {
         if (isDebug()) {

package/dist/parameters.gen.js

@@ -108,17 +108,17 @@ export const projectCreateRequest = {
     },
     'project.provisioner': {
         type: "string",
-        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
+        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n* serverless-platform\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
         demandOption: false,
     },
     'project.region_id': {
         type: "string",
-        description: "The region identifier. Refer to our [Regions](https://neon.tech/docs/introduction/regions) documentation for supported regions. Values are specified in this format: `aws-us-east-1`\n",
+        description: "The region identifier. Refer to our [Regions](https://neon.com/docs/introduction/regions) documentation for supported regions. Values are specified in this format: `aws-us-east-1`\n",
         demandOption: false,
     },
     'project.default_endpoint_settings.suspend_timeout_seconds': {
         type: "number",
-        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.tech/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
         demandOption: false,
     },
     'project.pg_version': {
@@ -236,7 +236,7 @@ export const projectUpdateRequest = {
     },
     'project.default_endpoint_settings.suspend_timeout_seconds': {
         type: "number",
-        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.tech/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
         demandOption: false,
     },
     'project.history_retention_seconds': {
@@ -311,12 +311,12 @@ export const branchCreateRequestEndpointOptions = {
     },
     'provisioner': {
         type: "string",
-        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
+        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n* serverless-platform\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
         demandOption: false,
     },
     'suspend_timeout_seconds': {
         type: "number",
-        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.tech/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
         demandOption: false,
     },
 };
@@ -366,17 +366,17 @@ export const endpointCreateRequest = {
     },
     'endpoint.provisioner': {
         type: "string",
-        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
+        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n* serverless-platform\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
         demandOption: false,
     },
     'endpoint.pooler_enabled': {
         type: "boolean",
-        description: "Whether to enable connection pooling for the compute endpoint\n",
+        description: "DEPRECATED. Whether to enable connection pooling for the compute endpoint.\nThe recommended way to enable connection pooling is to append `-pooler` to the endpoint ID in the connection string.\nSee [How to use connection pooling](https://neon.com/docs/connect/connection-pooling#how-to-use-connection-pooling)\n",
         demandOption: false,
     },
     'endpoint.pooler_mode': {
         type: "string",
-        description: "The connection pooler mode. Neon supports PgBouncer in `transaction` mode only.\n",
+        description: "DEPRECATED. The connection pooler mode. This field is deprecated and will be removed after 2026-06-20.\n",
         demandOption: false,
         choices: ["transaction"],
     },
@@ -392,7 +392,7 @@ export const endpointCreateRequest = {
     },
     'endpoint.suspend_timeout_seconds': {
         type: "number",
-        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.tech/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
         demandOption: false,
     },
     'endpoint.name': {
@@ -409,7 +409,7 @@ export const endpointUpdateRequest = {
     },
     'endpoint.provisioner': {
         type: "string",
-        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
+        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n* serverless-platform\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
         demandOption: false,
     },
     'endpoint.settings.preload_libraries.use_defaults': {
@@ -424,12 +424,12 @@ export const endpointUpdateRequest = {
     },
     'endpoint.pooler_enabled': {
         type: "boolean",
-        description: "Whether to enable connection pooling for the compute endpoint\n",
+        description: "DEPRECATED. Whether to enable connection pooling for the compute endpoint.\nThe recommended way to enable connection pooling is to append `-pooler` to the endpoint ID in the connection string.\nSee [How to use connection pooling](https://neon.com/docs/connect/connection-pooling#how-to-use-connection-pooling)\n",
         demandOption: false,
     },
     'endpoint.pooler_mode': {
         type: "string",
-        description: "The connection pooler mode. Neon supports PgBouncer in `transaction` mode only.\n",
+        description: "DEPRECATED. The connection pooler mode. This field is deprecated and will be removed after 2026-06-20.\n",
         demandOption: false,
         choices: ["transaction"],
     },
@@ -445,7 +445,7 @@ export const endpointUpdateRequest = {
     },
     'endpoint.suspend_timeout_seconds': {
         type: "number",
-        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.tech/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
         demandOption: false,
     },
     'endpoint.name': {

package/dist/pkg.js

@@ -1,6 +1,6 @@
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 /**
  * Load the CLI's package.json for version metadata. In the built CLI it sits right next to
  * this module (the build copies it into `dist`); when running from source (tests, `tsx`) it
@@ -11,12 +11,12 @@ const loadPkg = () => {
     let dir = dirname(fileURLToPath(import.meta.url));
     for (;;) {
         try {
-            return JSON.parse(readFileSync(join(dir, 'package.json'), 'utf-8'));
+            return JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
         }
         catch {
             const parent = dirname(dir);
             if (parent === dir) {
-                throw new Error('Could not locate package.json for version detection.');
+                throw new Error("Could not locate package.json for version detection.");
             }
             dir = parent;
         }

package/dist/psql/cli.js

@@ -29,14 +29,16 @@
  * EXIT_SUCCESS / EXIT_FAILURE / EXIT_USER / EXIT_BADCONN values; see
  * `core/mainloop.ts`).
  */
-import { runPsql, looksLikeConnectionString } from './index.js';
+import { looksLikeConnectionString, runPsql } from "./index.js";
 const main = async () => {
     const raw = process.argv.slice(2);
     // Detect whether the first arg is a connection URI/conninfo string.
     // libpq's `recognized_connection_string()` covers both `postgres[ql]://…`
     // URIs and bare `key=value` conninfo strings — `looksLikeConnectionString`
     // mirrors that test.
-    const argv = raw.length > 0 && looksLikeConnectionString(raw[0]) ? raw : ['', ...raw];
+    const argv = raw.length > 0 && looksLikeConnectionString(raw[0])
+        ? raw
+        : ["", ...raw];
     const code = await runPsql(argv, {
         stdin: process.stdin,
         stdout: process.stdout,