neon 3.0.0 → 3.1.0

package/dist/commands/status.js

@@ -1,40 +1,44 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import { fillSingleProject } from "../utils/enrichers.js";
 import { status } from "./config.js";
+//#region src/commands/status.ts
+var status_exports = /* @__PURE__ */ __exportAll({
+	builder: () => builder,
+	command: () => command,
+	describe: () => describe,
+	handler: () => handler
+});
 /**
- * `neon status` is a top-level alias for `neon config status` — the most-reached-for
- * config subcommand. It mirrors that command's options (including `--current-branch`,
- * the offline branch probe) and delegates to the same `status` handler.
- *
- * Because it has a handler but no subcommands, `status` must also be listed in
- * `NO_SUBCOMMANDS_VERBS` (see index.ts) so the help-fallback middleware doesn't
- * intercept a bare `neon status`.
- */
-export const command = "status";
-export const describe = "Show the branch's live Neon state (alias of `config status`)";
-export const builder = (argv) => argv
-    .usage("$0 status [options]")
-    .options({
-    "project-id": {
-        describe: "Project ID",
-        type: "string",
-    },
-    branch: {
-        describe: "Branch ID or name",
-        type: "string",
-    },
-    "config-json": {
-        describe: "Print only the branch's live config as neon.ts-shaped JSON " +
-            "(services + branch tuning + preview), to stdout. Useful for " +
-            "scripting or copying into a neon.ts.",
-        type: "boolean",
-        default: false,
-    },
-    "current-branch": {
-        describe: "Print only the linked branch name from the local .neon file " +
-            "(no network). Exits non-zero when no branch is pinned.",
-        type: "boolean",
-        default: false,
-    },
-})
-    .middleware(fillSingleProject);
-export const handler = (args) => status(args);
+* `neon status` is a top-level alias for `neon config status` — the most-reached-for
+* config subcommand. It mirrors that command's options (including `--current-branch`,
+* the offline branch probe) and delegates to the same `status` handler.
+*
+* Because it has a handler but no subcommands, `status` must also be listed in
+* `NO_SUBCOMMANDS_VERBS` (see index.ts) so the help-fallback middleware doesn't
+* intercept a bare `neon status`.
+*/
+const command = "status";
+const describe = "Show the branch's live Neon state (alias of `config status`)";
+const builder = (argv) => argv.usage("$0 status [options]").options({
+	"project-id": {
+		describe: "Project ID",
+		type: "string"
+	},
+	branch: {
+		describe: "Branch ID or name",
+		type: "string"
+	},
+	"config-json": {
+		describe: "Print only the branch's live config as neon.ts-shaped JSON (services + branch tuning + preview), to stdout. Useful for scripting or copying into a neon.ts.",
+		type: "boolean",
+		default: false
+	},
+	"current-branch": {
+		describe: "Print only the linked branch name from the local .neon file (no network). Exits non-zero when no branch is pinned.",
+		type: "boolean",
+		default: false
+	}
+}).middleware(fillSingleProject);
+const handler = (args) => status(args);
+//#endregion
+export { builder, command, describe, handler, status_exports };

package/dist/commands/user.js

@@ -1,15 +1,26 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import { writer } from "../writer.js";
-export const command = "me";
-export const describe = "Show current user";
-export const builder = (yargs) => yargs.option("context-file", {
-    hidden: true,
+//#region src/commands/user.ts
+var user_exports = /* @__PURE__ */ __exportAll({
+	builder: () => builder,
+	command: () => "me",
+	describe: () => describe,
+	handler: () => handler
 });
-export const handler = async (args) => {
-    await me(args);
+const command = "me";
+const describe = "Show current user";
+const builder = (yargs) => yargs.option("context-file", { hidden: true });
+const handler = async (args) => {
+	await me(args);
 };
 const me = async (props) => {
-    const { data } = await props.apiClient.getCurrentUserInfo();
-    writer(props).end(data, {
-        fields: ["login", "email", "name", "projects_limit"],
-    });
+	const { data } = await props.apiClient.getCurrentUserInfo();
+	writer(props).end(data, { fields: [
+		"login",
+		"email",
+		"name",
+		"projects_limit"
+	] });
 };
+//#endregion
+export { builder, command, describe, handler, user_exports };

package/dist/commands/vpc_endpoints.js

@@ -1,134 +1,106 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import { log } from "../log.js";
-import { fillSingleOrg, fillSingleProject } from "../utils/enrichers.js";
 import { writer } from "../writer.js";
+import { fillSingleOrg, fillSingleProject } from "../utils/enrichers.js";
 import { REGIONS } from "./projects.js";
+//#region src/commands/vpc_endpoints.ts
+var vpc_endpoints_exports = /* @__PURE__ */ __exportAll({
+	builder: () => builder,
+	command: () => "vpc",
+	describe: () => describe
+});
 const VPC_ENDPOINT_FIELDS = ["vpc_endpoint_id", "label"];
 const VPC_ENDPOINT_DETAILS_FIELDS = [
-    "vpc_endpoint_id",
-    "label",
-    "state",
-    "num_restricted_projects",
-    "example_restricted_projects",
+	"vpc_endpoint_id",
+	"label",
+	"state",
+	"num_restricted_projects",
+	"example_restricted_projects"
 ];
-export const command = "vpc";
-export const describe = "Manage VPC endpoints and project VPC restrictions";
-export const builder = (argv) => {
-    return argv
-        .usage("$0 vpc <sub-command> [options]")
-        .command("endpoint", "Manage VPC endpoints.\n" +
-        "See: https://neon.tech/docs/guides/neon-private-networking\n" +
-        "After adding an endpoint to an organization, client connections will be accepted\n" +
-        "from the corresponding VPC for all projects in the organization, unless overridden\n" +
-        "by a project-level VPC endpoint restriction.", (yargs) => {
-        return yargs
-            .options({
-            "org-id": {
-                describe: "Organization ID",
-                type: "string",
-            },
-            "region-id": {
-                describe: `The region ID. Possible values: ${REGIONS.join(", ")}`,
-                type: "string",
-                demandOption: true,
-            },
-        })
-            .middleware(fillSingleOrg)
-            .command("list", "List configured VPC endpoints for this organization.", (yargs) => yargs, async (args) => {
-            await listOrg(args);
-        })
-            .command({
-            command: "assign <id>",
-            aliases: ["update <id>", "add <id>"],
-            describe: "Add or update a VPC endpoint for this organization.\n" +
-                "Note: Azure regions are not yet supported.",
-            builder: (yargs) => yargs.options({
-                label: {
-                    describe: "An optional descriptive label for the VPC endpoint",
-                    type: "string",
-                },
-            }),
-            handler: async (args) => {
-                await assignOrg(args);
-            },
-        })
-            .command("remove <id>", "Remove a VPC endpoint from this organization.", (yargs) => yargs, async (args) => {
-            await removeOrg(args);
-        })
-            .command("status <id>", "Get the status of a VPC endpoint for this organization.", (yargs) => yargs, async (args) => {
-            await statusOrg(args);
-        });
-    })
-        .command("project", "Manage project-level VPC endpoint restrictions.\n" +
-        "By default, connections are accepted from any VPC configured at the organization level.\n" +
-        "A project-level VPC endpoint restriction can be used to restrict connections to a specific VPC.", (yargs) => {
-        return yargs
-            .options({
-            "project-id": {
-                describe: "Project ID",
-                type: "string",
-            },
-        })
-            .middleware(fillSingleProject)
-            .command("list", "List VPC endpoint restrictions for this project.", (yargs) => yargs, async (args) => {
-            await listProject(args);
-        })
-            .command({
-            command: "restrict <id>",
-            aliases: ["update <id>"],
-            describe: "Configure or update a VPC endpoint restriction for this project.",
-            builder: (yargs) => yargs.options({
-                label: {
-                    describe: "An optional descriptive label for the VPC endpoint restriction",
-                    type: "string",
-                },
-            }),
-            handler: async (args) => {
-                await assignProject(args);
-            },
-        })
-            .command("remove <id>", "Remove a VPC endpoint restriction from this project.", (yargs) => yargs, async (args) => {
-            await removeProject(args);
-        });
-    });
+const command = "vpc";
+const describe = "Manage VPC endpoints and project VPC restrictions";
+const builder = (argv) => {
+	return argv.usage("$0 vpc <sub-command> [options]").command("endpoint", "Manage VPC endpoints.\nSee: https://neon.tech/docs/guides/neon-private-networking\nAfter adding an endpoint to an organization, client connections will be accepted\nfrom the corresponding VPC for all projects in the organization, unless overridden\nby a project-level VPC endpoint restriction.", (yargs) => {
+		return yargs.options({
+			"org-id": {
+				describe: "Organization ID",
+				type: "string"
+			},
+			"region-id": {
+				describe: `The region ID. Possible values: ${REGIONS.join(", ")}`,
+				type: "string",
+				demandOption: true
+			}
+		}).middleware(fillSingleOrg).command("list", "List configured VPC endpoints for this organization.", (yargs) => yargs, async (args) => {
+			await listOrg(args);
+		}).command({
+			command: "assign <id>",
+			aliases: ["update <id>", "add <id>"],
+			describe: "Add or update a VPC endpoint for this organization.\nNote: Azure regions are not yet supported.",
+			builder: (yargs) => yargs.options({ label: {
+				describe: "An optional descriptive label for the VPC endpoint",
+				type: "string"
+			} }),
+			handler: async (args) => {
+				await assignOrg(args);
+			}
+		}).command("remove <id>", "Remove a VPC endpoint from this organization.", (yargs) => yargs, async (args) => {
+			await removeOrg(args);
+		}).command("status <id>", "Get the status of a VPC endpoint for this organization.", (yargs) => yargs, async (args) => {
+			await statusOrg(args);
+		});
+	}).command("project", "Manage project-level VPC endpoint restrictions.\nBy default, connections are accepted from any VPC configured at the organization level.\nA project-level VPC endpoint restriction can be used to restrict connections to a specific VPC.", (yargs) => {
+		return yargs.options({ "project-id": {
+			describe: "Project ID",
+			type: "string"
+		} }).middleware(fillSingleProject).command("list", "List VPC endpoint restrictions for this project.", (yargs) => yargs, async (args) => {
+			await listProject(args);
+		}).command({
+			command: "restrict <id>",
+			aliases: ["update <id>"],
+			describe: "Configure or update a VPC endpoint restriction for this project.",
+			builder: (yargs) => yargs.options({ label: {
+				describe: "An optional descriptive label for the VPC endpoint restriction",
+				type: "string"
+			} }),
+			handler: async (args) => {
+				await assignProject(args);
+			}
+		}).command("remove <id>", "Remove a VPC endpoint restriction from this project.", (yargs) => yargs, async (args) => {
+			await removeProject(args);
+		});
+	});
 };
 const listOrg = async (props) => {
-    const { data } = await props.apiClient.listOrganizationVpcEndpoints(props.orgId, props.regionId);
-    writer(props).end(data.endpoints, {
-        fields: VPC_ENDPOINT_FIELDS,
-    });
+	const { data } = await props.apiClient.listOrganizationVpcEndpoints(props.orgId, props.regionId);
+	writer(props).end(data.endpoints, { fields: VPC_ENDPOINT_FIELDS });
 };
 const assignOrg = async (props) => {
-    const vpcEndpointAssignment = {
-        label: props.label || "",
-    };
-    const { data } = await props.apiClient.assignOrganizationVpcEndpoint(props.orgId, props.regionId, props.id, vpcEndpointAssignment);
-    writer(props).end(data, { fields: [] });
-    if (props.regionId.startsWith("azure")) {
-        log.info("VPC endpoint configuration is not supported for Azure regions");
-    }
+	const vpcEndpointAssignment = { label: props.label || "" };
+	const { data } = await props.apiClient.assignOrganizationVpcEndpoint(props.orgId, props.regionId, props.id, vpcEndpointAssignment);
+	writer(props).end(data, { fields: [] });
+	if (props.regionId.startsWith("azure")) log.info("VPC endpoint configuration is not supported for Azure regions");
 };
 const removeOrg = async (props) => {
-    const { data } = await props.apiClient.deleteOrganizationVpcEndpoint(props.orgId, props.regionId, props.id);
-    writer(props).end(data, { fields: [] });
+	const { data } = await props.apiClient.deleteOrganizationVpcEndpoint(props.orgId, props.regionId, props.id);
+	writer(props).end(data, { fields: [] });
 };
 const statusOrg = async (props) => {
-    const { data } = await props.apiClient.getOrganizationVpcEndpointDetails(props.orgId, props.regionId, props.id);
-    writer(props).end(data, { fields: VPC_ENDPOINT_DETAILS_FIELDS });
+	const { data } = await props.apiClient.getOrganizationVpcEndpointDetails(props.orgId, props.regionId, props.id);
+	writer(props).end(data, { fields: VPC_ENDPOINT_DETAILS_FIELDS });
 };
 const listProject = async (props) => {
-    const { data } = await props.apiClient.listProjectVpcEndpoints(props.projectId);
-    writer(props).end(data.endpoints, {
-        fields: VPC_ENDPOINT_FIELDS,
-    });
+	const { data } = await props.apiClient.listProjectVpcEndpoints(props.projectId);
+	writer(props).end(data.endpoints, { fields: VPC_ENDPOINT_FIELDS });
 };
 const assignProject = async (props) => {
-    const vpcEndpointAssignment = {
-        label: props.label || "",
-    };
-    const { data } = await props.apiClient.assignProjectVpcEndpoint(props.projectId, props.id, vpcEndpointAssignment);
-    writer(props).end(data, { fields: [] });
+	const vpcEndpointAssignment = { label: props.label || "" };
+	const { data } = await props.apiClient.assignProjectVpcEndpoint(props.projectId, props.id, vpcEndpointAssignment);
+	writer(props).end(data, { fields: [] });
 };
 const removeProject = async (props) => {
-    const { data } = await props.apiClient.deleteProjectVpcEndpoint(props.projectId, props.id);
-    writer(props).end(data, { fields: [] });
+	const { data } = await props.apiClient.deleteProjectVpcEndpoint(props.projectId, props.id);
+	writer(props).end(data, { fields: [] });
 };
+//#endregion
+export { builder, command, describe, vpc_endpoints_exports };

package/dist/config.js

@@ -1,8 +1,9 @@
-import { existsSync, mkdirSync } from "node:fs";
 import { isCi } from "./env.js";
-export { CREDENTIALS_FILE, credentialsPath, defaultDir, isInsideConfigDir, isOwnedCredentialPath, } from "./_shared/paths.js";
-export const ensureConfigDir = ({ "config-dir": configDirArg, "force-auth": forceAuth, }) => {
-    if (!existsSync(configDirArg) && (!isCi() || forceAuth)) {
-        mkdirSync(configDirArg, { recursive: true });
-    }
+import { CREDENTIALS_FILE, credentialsPath, defaultDir, isInsideConfigDir, isOwnedCredentialPath } from "./_shared/paths.js";
+import { existsSync, mkdirSync } from "node:fs";
+//#region src/config.ts
+const ensureConfigDir = ({ "config-dir": configDirArg, "force-auth": forceAuth }) => {
+	if (!existsSync(configDirArg) && (!isCi() || forceAuth)) mkdirSync(configDirArg, { recursive: true });
 };
+//#endregion
+export { CREDENTIALS_FILE, credentialsPath, defaultDir, ensureConfigDir, isInsideConfigDir, isOwnedCredentialPath };

package/dist/config_format.js

@@ -1,72 +1,56 @@
+//#region src/config_format.ts
 /**
- * Render a TTL in whole seconds back to the canonical `neon.ts` duration string (e.g.
- * `604800` -> `"7d"`), falling back to seconds when no clean unit boundary matches. Mirrors
- * the formatter `@neon/config` uses when it emits a TTL, so `config status` shows
- * the same value a user would write in `neon.ts`.
- */
-export const formatDurationSeconds = (totalSeconds) => {
-    const units = [
-        ["w", 7 * 24 * 60 * 60],
-        ["d", 24 * 60 * 60],
-        ["h", 60 * 60],
-        ["m", 60],
-    ];
-    for (const [unit, perUnit] of units) {
-        if (totalSeconds % perUnit === 0)
-            return `${totalSeconds / perUnit}${unit}`;
-    }
-    return `${totalSeconds}s`;
+* Render a TTL in whole seconds back to the canonical `neon.ts` duration string (e.g.
+* `604800` -> `"7d"`), falling back to seconds when no clean unit boundary matches. Mirrors
+* the formatter `@neon/config` uses when it emits a TTL, so `config status` shows
+* the same value a user would write in `neon.ts`.
+*/
+const formatDurationSeconds = (totalSeconds) => {
+	for (const [unit, perUnit] of [
+		["w", 604800],
+		["d", 86400],
+		["h", 3600],
+		["m", 60]
+	]) if (totalSeconds % perUnit === 0) return `${totalSeconds / perUnit}${unit}`;
+	return `${totalSeconds}s`;
 };
 /**
- * Project a resolved branch config (plus the separately-pulled preview state, since
- * functions/buckets don't live on the closure) into a {@link NeonConfigView}.
- *
- * - Service toggles are surfaced as `true` only when enabled (disabled is the absence of
- *   the key, exactly as in `neon.ts`).
- * - `ttlSeconds` is rendered back to a duration string (`7d`).
- * - The `branch` section is the JSON-able part of what would otherwise be the `branch`
- *   closure: `parent` / `ttl` / `protected` / `postgres.computeSettings`.
- * - `branch` and `preview` are omitted entirely when they would be empty.
- */
-export const toNeonConfigView = (resolved, preview) => {
-    const view = {};
-    if (resolved.authEnabled)
-        view.auth = true;
-    if (resolved.dataApiEnabled)
-        view.dataApi = true;
-    const previewView = toPreviewView(preview);
-    if (previewView)
-        view.preview = previewView;
-    const branch = {};
-    if (resolved.parent !== undefined)
-        branch.parent = resolved.parent;
-    if (resolved.ttlSeconds !== undefined)
-        branch.ttl = formatDurationSeconds(resolved.ttlSeconds);
-    if (resolved.protected !== undefined)
-        branch.protected = resolved.protected;
-    if (resolved.postgres?.computeSettings)
-        branch.postgres = resolved.postgres;
-    if (Object.keys(branch).length > 0)
-        view.branch = branch;
-    return view;
+* Project a resolved branch config (plus the separately-pulled preview state, since
+* functions/buckets don't live on the closure) into a {@link NeonConfigView}.
+*
+* - Service toggles are surfaced as `true` only when enabled (disabled is the absence of
+*   the key, exactly as in `neon.ts`).
+* - `ttlSeconds` is rendered back to a duration string (`7d`).
+* - The `branch` section is the JSON-able part of what would otherwise be the `branch`
+*   closure: `parent` / `ttl` / `protected` / `postgres.computeSettings`.
+* - `branch` and `preview` are omitted entirely when they would be empty.
+*/
+const toNeonConfigView = (resolved, preview) => {
+	const view = {};
+	if (resolved.authEnabled) view.auth = true;
+	if (resolved.dataApiEnabled) view.dataApi = true;
+	const previewView = toPreviewView(preview);
+	if (previewView) view.preview = previewView;
+	const branch = {};
+	if (resolved.parent !== void 0) branch.parent = resolved.parent;
+	if (resolved.ttlSeconds !== void 0) branch.ttl = formatDurationSeconds(resolved.ttlSeconds);
+	if (resolved.protected !== void 0) branch.protected = resolved.protected;
+	if (resolved.postgres?.computeSettings) branch.postgres = resolved.postgres;
+	if (Object.keys(branch).length > 0) view.branch = branch;
+	return view;
 };
 const toPreviewView = (preview) => {
-    if (!preview)
-        return undefined;
-    const out = {};
-    if (preview.functions.length > 0) {
-        out.functions = Object.fromEntries(preview.functions.map((fn) => [fn.slug, { name: fn.name }]));
-    }
-    if (preview.buckets.length > 0) {
-        out.buckets = Object.fromEntries(preview.buckets.map((b) => [b.name, { access: b.access }]));
-    }
-    if (preview.credentials.length > 0) {
-        out.credentials = preview.credentials.map((c) => ({
-            id: c.tokenIdShort,
-            ...(c.name ? { name: c.name } : {}),
-            scopes: c.scopes,
-            ...(c.lastUsedAt ? { lastUsedAt: c.lastUsedAt } : {}),
-        }));
-    }
-    return Object.keys(out).length > 0 ? out : undefined;
+	if (!preview) return void 0;
+	const out = {};
+	if (preview.functions.length > 0) out.functions = Object.fromEntries(preview.functions.map((fn) => [fn.slug, { name: fn.name }]));
+	if (preview.buckets.length > 0) out.buckets = Object.fromEntries(preview.buckets.map((b) => [b.name, { access: b.access }]));
+	if (preview.credentials.length > 0) out.credentials = preview.credentials.map((c) => ({
+		id: c.tokenIdShort,
+		...c.name ? { name: c.name } : {},
+		scopes: c.scopes,
+		...c.lastUsedAt ? { lastUsedAt: c.lastUsedAt } : {}
+	}));
+	return Object.keys(out).length > 0 ? out : void 0;
 };
+//#endregion
+export { formatDurationSeconds, toNeonConfigView };