neonctl 2.18.1 → 2.19.0

package/commands/connection_string.js

@@ -1,4 +1,4 @@
-import { EndpointType } from '@neondatabase/api-client';
+import { EndpointType, } from '@neondatabase/api-client';
 import { branchIdFromProps, fillSingleProject } from '../utils/enrichers.js';
 import { writer } from '../writer.js';
 import { psql } from '../utils/psql.js';

package/commands/projects.js

@@ -38,6 +38,10 @@ export const builder = (argv) => {
             describe: 'List projects of a given organization',
             type: 'string',
         },
+        'recoverable-only': {
+            describe: 'List only deleted projects within their deletion grace period',
+            type: 'boolean',
+        },
     }), async (args) => {
         await handleMissingOrgId(args, list);
     })
@@ -123,6 +127,9 @@ export const builder = (argv) => {
     })
         .command('delete <id>', 'Delete a project', (yargs) => yargs, async (args) => {
         await deleteProject(args);
+    })
+        .command('recover <id>', 'Recovers a deleted project during the deletion grace period', (yargs) => yargs, async (args) => {
+        await recover(args);
     })
         .command('get <id>', 'Get a project', (yargs) => yargs, async (args) => {
         await get(args);
@@ -140,6 +147,7 @@ const list = async (props) => {
             const { data } = await fn({
                 limit: PROJECTS_LIST_LIMIT,
                 org_id: props.orgId,
+                recoverable: props.recoverableOnly,
                 cursor,
             });
             result.push(...data.projects);
@@ -152,16 +160,21 @@ const list = async (props) => {
         return result;
     };
     const ownedProjects = await getList(props.apiClient.listProjects);
-    const sharedProjects = props.orgId
+    const sharedProjects = props.orgId || props.recoverableOnly
         ? []
         : await getList(props.apiClient.listSharedProjects);
     const out = writer(props);
     out.write(ownedProjects, {
-        fields: PROJECT_FIELDS,
+        fields: props.recoverableOnly
+            ? [...PROJECT_FIELDS, 'deleted_at', 'recoverable_until']
+            : PROJECT_FIELDS,
         title: 'Projects',
-        emptyMessage: "You don't have any projects yet. See how to create a new project:\n> neonctl projects create --help",
+        emptyMessage: props.recoverableOnly
+            ? "You don't have any recoverable projects."
+            : "You don't have any projects yet. See how to create a new project:\n> neon projects create --help",
     });
-    if (!props.orgId) {
+    if (!props.orgId && !props.recoverableOnly) {
+        // We don't list shared projects when listing recoverable projects
         out.write(sharedProjects, {
             fields: PROJECT_FIELDS,
             title: 'Shared with you',
@@ -271,6 +284,10 @@ const update = async (props) => {
     });
     writer(props).end(data.project, { fields: PROJECT_FIELDS });
 };
+const recover = async (props) => {
+    const { data } = await props.apiClient.recoverProject(props.id);
+    writer(props).end(data.project, { fields: PROJECT_FIELDS });
+};
 const get = async (props) => {
     const { data } = await props.apiClient.getProject(props.id);
     writer(props).end(data.project, { fields: PROJECT_FIELDS });

package/commands/projects.test.js

@@ -10,6 +10,9 @@ describe('projects', () => {
     test('list with org id', async ({ testCliCommand }) => {
         await testCliCommand(['projects', 'list', '--org-id', 'org-2']);
     });
+    test('list recoverable projects', async ({ testCliCommand }) => {
+        await testCliCommand(['projects', 'list', '--recoverable-only']);
+    });
     test('create', async ({ testCliCommand }) => {
         await testCliCommand(['projects', 'create', '--name', 'test_project']);
     });
@@ -102,6 +105,9 @@ describe('projects', () => {
     test('delete', async ({ testCliCommand }) => {
         await testCliCommand(['projects', 'delete', 'test']);
     });
+    test('recover deleted project', async ({ testCliCommand }) => {
+        await testCliCommand(['projects', 'recover', 'test']);
+    });
     test('update name', async ({ testCliCommand }) => {
         await testCliCommand([
             'projects',

package/package.json

@@ -5,7 +5,7 @@
     "url": "git+ssh://git@github.com/neondatabase/neonctl.git"
   },
   "type": "module",
-  "version": "2.18.1",
+  "version": "2.19.0",
   "description": "CLI tool for NeonDB Cloud management",
   "main": "index.js",
   "author": "NeonDB",
@@ -53,7 +53,7 @@
     "vitest": "^1.6.0"
   },
   "dependencies": {
-    "@neondatabase/api-client": "2.2.0",
+    "@neondatabase/api-client": "2.6.0",
     "@segment/analytics-node": "^1.0.0-beta.26",
     "@yao-pkg/pkg": "^6.10.0",
     "axios": "^1.4.0",

package/parameters.gen.js

@@ -123,7 +123,7 @@ export const projectCreateRequest = {
     },
     'project.pg_version': {
         type: "number",
-        description: "The major Postgres version number. Currently supported versions are `14`, `15`, `16`, and `17`.",
+        description: "The major Postgres version number. Currently supported versions are `14`, `15`, `16`, `17`, and `18`.",
         demandOption: false,
     },
     'project.store_passwords': {
@@ -288,7 +288,7 @@ export const branchCreateRequest = {
     },
     'branch.expires_at': {
         type: "string",
-        description: "The timestamp when the branch is scheduled to expire and be automatically deleted. Must be set by the client following the [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6) format with precision up to seconds (such as 2025-06-09T18:02:16Z). Deletion is performed by a background job and may not occur exactly at the specified time.\n\nThis feature is still under development and not yet generally available.\n",
+        description: "The timestamp when the branch is scheduled to expire and be automatically deleted. Must be set by the client following the [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6) format with precision up to seconds (such as 2025-06-09T18:02:16Z). Deletion is performed by a background job and may not occur exactly at the specified time.\n\nAccess to this feature is currently limited to participants in the Early Access Program.\n",
         demandOption: false,
     },
 };
@@ -299,6 +299,16 @@ export const branchCreateRequestEndpointOptions = {
         demandOption: true,
         choices: ["read_only", "read_write"],
     },
+    'settings.preload_libraries.use_defaults': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'settings.preload_libraries.enabled_libraries': {
+        type: "array",
+        description: undefined,
+        demandOption: false,
+    },
     '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",
@@ -323,7 +333,7 @@ export const branchUpdateRequest = {
     },
     'branch.expires_at': {
         type: "string",
-        description: "The timestamp when the branch is scheduled to expire and be automatically deleted. Must be set by the client following the [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6) format with precision up to seconds (such as 2025-06-09T18:02:16Z). Deletion is performed by a background job and may not occur exactly at the specified time. If this field is set to null, the expiration timestamp is removed.\n\nThis feature is still under development and not yet generally available.\n",
+        description: "The timestamp when the branch is scheduled to expire and be automatically deleted. Must be set by the client following the [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6) format with precision up to seconds (such as 2025-06-09T18:02:16Z). Deletion is performed by a background job and may not occur exactly at the specified time. If this field is set to null, the expiration timestamp is removed.\n\nAccess to this feature is currently limited to participants in the Early Access Program.\n",
         demandOption: false,
     },
 };
@@ -344,6 +354,16 @@ export const endpointCreateRequest = {
         demandOption: true,
         choices: ["read_only", "read_write"],
     },
+    'endpoint.settings.preload_libraries.use_defaults': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'endpoint.settings.preload_libraries.enabled_libraries': {
+        type: "array",
+        description: undefined,
+        demandOption: false,
+    },
     '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",
@@ -392,6 +412,16 @@ export const endpointUpdateRequest = {
         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",
         demandOption: false,
     },
+    'endpoint.settings.preload_libraries.use_defaults': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'endpoint.settings.preload_libraries.enabled_libraries': {
+        type: "array",
+        description: undefined,
+        demandOption: false,
+    },
     'endpoint.pooler_enabled': {
         type: "boolean",
         description: "Whether to enable connection pooling for the compute endpoint\n",