neon 2.47.0 → 3.1.0

package/dist/commands/api.js

@@ -1,278 +1,248 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { getEndpoints, loadSpec } from "../utils/openapi.js";
+import { writer } from "../writer.js";
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import YAML from "yaml";
-import { DEFAULT_SPEC_URL, getEndpoints, loadSpec } from "../utils/openapi.js";
-import { writer } from "../writer.js";
-const HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE"];
-// ── Pure helpers (unit-tested) ───────────────────────────────────────────────
+//#region src/commands/api.ts
+var api_exports = /* @__PURE__ */ __exportAll({
+	buildBody: () => buildBody,
+	buildQuery: () => buildQuery,
+	builder: () => builder,
+	command: () => command,
+	describe: () => describe,
+	handler: () => handler,
+	parseHeaders: () => parseHeaders,
+	parseKeyValue: () => parseKeyValue,
+	parseTypedValue: () => parseTypedValue,
+	setDeep: () => setDeep
+});
+const HTTP_METHODS = [
+	"GET",
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE"
+];
 /**
- * Coerce a raw string into a typed JSON value: booleans, `null`, integers,
- * floats, and JSON arrays/objects are parsed; everything else stays a string.
- */
-export function parseTypedValue(raw) {
-    if (raw === "true")
-        return true;
-    if (raw === "false")
-        return false;
-    if (raw === "null")
-        return null;
-    if (/^-?\d+$/.test(raw))
-        return Number.parseInt(raw, 10);
-    if (/^-?\d*\.\d+$/.test(raw))
-        return Number.parseFloat(raw);
-    if (raw.startsWith("[") || raw.startsWith("{")) {
-        try {
-            return JSON.parse(raw);
-        }
-        catch {
-            return raw;
-        }
-    }
-    return raw;
+* Coerce a raw string into a typed JSON value: booleans, `null`, integers,
+* floats, and JSON arrays/objects are parsed; everything else stays a string.
+*/
+function parseTypedValue(raw) {
+	if (raw === "true") return true;
+	if (raw === "false") return false;
+	if (raw === "null") return null;
+	if (/^-?\d+$/.test(raw)) return Number.parseInt(raw, 10);
+	if (/^-?\d*\.\d+$/.test(raw)) return Number.parseFloat(raw);
+	if (raw.startsWith("[") || raw.startsWith("{")) try {
+		return JSON.parse(raw);
+	} catch {
+		return raw;
+	}
+	return raw;
 }
 /** Split a `key=value` pair on the first `=`. */
-export function parseKeyValue(input) {
-    const eq = input.indexOf("=");
-    if (eq === -1) {
-        throw new Error(`Invalid "key=value" pair: "${input}".`);
-    }
-    return { key: input.slice(0, eq), value: input.slice(eq + 1) };
+function parseKeyValue(input) {
+	const eq = input.indexOf("=");
+	if (eq === -1) throw new Error(`Invalid "key=value" pair: "${input}".`);
+	return {
+		key: input.slice(0, eq),
+		value: input.slice(eq + 1)
+	};
 }
 /**
- * Assign `value` into `target` at a dot-delimited path, creating intermediate
- * objects as needed. Enables `-F branch.name=dev` → `{ branch: { name: "dev" } }`,
- * matching the nested shape of Neon request bodies.
- */
-export function setDeep(target, dottedKey, value) {
-    const parts = dottedKey.split(".");
-    let node = target;
-    for (let i = 0; i < parts.length - 1; i++) {
-        const part = parts[i];
-        const next = node[part];
-        if (typeof next !== "object" || next === null || Array.isArray(next)) {
-            node[part] = {};
-        }
-        node = node[part];
-    }
-    node[parts[parts.length - 1]] = value;
+* Assign `value` into `target` at a dot-delimited path, creating intermediate
+* objects as needed. Enables `-F branch.name=dev` → `{ branch: { name: "dev" } }`,
+* matching the nested shape of Neon request bodies.
+*/
+function setDeep(target, dottedKey, value) {
+	const parts = dottedKey.split(".");
+	let node = target;
+	for (let i = 0; i < parts.length - 1; i++) {
+		const part = parts[i];
+		const next = node[part];
+		if (typeof next !== "object" || next === null || Array.isArray(next)) node[part] = {};
+		node = node[part];
+	}
+	node[parts[parts.length - 1]] = value;
 }
 /** Build a JSON body object from typed `-F` and string `-f` field pairs. */
-export function buildBody(fields, rawFields) {
-    const body = {};
-    for (const field of fields) {
-        const { key, value } = parseKeyValue(field);
-        setDeep(body, key, parseTypedValue(value));
-    }
-    for (const field of rawFields) {
-        const { key, value } = parseKeyValue(field);
-        setDeep(body, key, value);
-    }
-    return body;
+function buildBody(fields, rawFields) {
+	const body = {};
+	for (const field of fields) {
+		const { key, value } = parseKeyValue(field);
+		setDeep(body, key, parseTypedValue(value));
+	}
+	for (const field of rawFields) {
+		const { key, value } = parseKeyValue(field);
+		setDeep(body, key, value);
+	}
+	return body;
 }
 /** Build a query-string map from `-Q key=value` pairs. */
-export function buildQuery(pairs) {
-    const query = {};
-    for (const pair of pairs) {
-        const { key, value } = parseKeyValue(pair);
-        query[key] = value;
-    }
-    return query;
+function buildQuery(pairs) {
+	const query = {};
+	for (const pair of pairs) {
+		const { key, value } = parseKeyValue(pair);
+		query[key] = value;
+	}
+	return query;
 }
 /** Build a header map from `-H key:value` pairs. */
-export function parseHeaders(pairs) {
-    const headers = {};
-    for (const pair of pairs) {
-        const idx = pair.indexOf(":");
-        if (idx === -1) {
-            throw new Error(`Invalid header "${pair}". Expected "key:value".`);
-        }
-        headers[pair.slice(0, idx).trim()] = pair.slice(idx + 1).trim();
-    }
-    return headers;
+function parseHeaders(pairs) {
+	const headers = {};
+	for (const pair of pairs) {
+		const idx = pair.indexOf(":");
+		if (idx === -1) throw new Error(`Invalid header "${pair}". Expected "key:value".`);
+		headers[pair.slice(0, idx).trim()] = pair.slice(idx + 1).trim();
+	}
+	return headers;
 }
 function assertMethod(method) {
-    if (!HTTP_METHODS.includes(method)) {
-        throw new Error(`Unsupported method "${method}". Use one of: ${HTTP_METHODS.join(", ")}.`);
-    }
+	if (!HTTP_METHODS.includes(method)) throw new Error(`Unsupported method "${method}". Use one of: ${HTTP_METHODS.join(", ")}.`);
 }
-// ── I/O helpers ──────────────────────────────────────────────────────────────
 async function readStdin() {
-    const chunks = [];
-    for await (const chunk of process.stdin) {
-        chunks.push(Buffer.from(chunk));
-    }
-    return Buffer.concat(chunks).toString("utf8");
+	const chunks = [];
+	for await (const chunk of process.stdin) chunks.push(Buffer.from(chunk));
+	return Buffer.concat(chunks).toString("utf8");
 }
 /** Resolve `--data`: `-` reads stdin, `@file` reads a file, else the literal string. Parsed as JSON when possible. */
 async function readData(data) {
-    let raw;
-    if (data === "-") {
-        raw = await readStdin();
-    }
-    else if (data.startsWith("@")) {
-        raw = readFileSync(resolve(data.slice(1)), "utf8");
-    }
-    else {
-        raw = data;
-    }
-    try {
-        return JSON.parse(raw);
-    }
-    catch {
-        return raw;
-    }
+	let raw;
+	if (data === "-") raw = await readStdin();
+	else if (data.startsWith("@")) raw = readFileSync(resolve(data.slice(1)), "utf8");
+	else raw = data;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return raw;
+	}
 }
 const toStrings = (values) => (values ?? []).map(String);
 async function listEndpoints(args) {
-    const spec = await loadSpec({
-        configDir: args.configDir,
-        specUrl: args.specUrl,
-        refresh: args.refresh,
-    });
-    if (!spec) {
-        throw new Error(`Could not load the Neon OpenAPI spec from ${args.specUrl}. ` +
-            "Check your network connection or pass --spec-url.");
-    }
-    const endpoints = getEndpoints(spec).map((endpoint) => ({
-        method: endpoint.method,
-        path: endpoint.path,
-        summary: endpoint.summary ?? "",
-    }));
-    writer(args).end(endpoints, {
-        fields: ["method", "path", "summary"],
-        title: `Neon API endpoints (${endpoints.length})`,
-        emptyMessage: "No endpoints found in the spec.",
-    });
+	const spec = await loadSpec({
+		configDir: args.configDir,
+		specUrl: args.specUrl,
+		refresh: args.refresh
+	});
+	if (!spec) throw new Error(`Could not load the Neon OpenAPI spec from ${args.specUrl}. Check your network connection or pass --spec-url.`);
+	const endpoints = getEndpoints(spec).map((endpoint) => ({
+		method: endpoint.method,
+		path: endpoint.path,
+		summary: endpoint.summary ?? ""
+	}));
+	writer(args).end(endpoints, {
+		fields: [
+			"method",
+			"path",
+			"summary"
+		],
+		title: `Neon API endpoints (${endpoints.length})`,
+		emptyMessage: "No endpoints found in the spec."
+	});
 }
 async function runRequest(args) {
-    const path = args.path;
-    if (!path) {
-        throw new Error("Missing API path. Usage: neon api <path> (e.g. neon api /projects). " +
-            "Run `neon api --list` to see available routes.");
-    }
-    if (!path.startsWith("/")) {
-        throw new Error(`Invalid path "${path}". API paths must start with "/". ` +
-            "Run `neon api --list` to see available routes.");
-    }
-    const fields = toStrings(args.field);
-    const rawFields = toStrings(args.rawField);
-    let body;
-    if (args.data !== undefined) {
-        body = await readData(args.data);
-    }
-    else if (fields.length > 0 || rawFields.length > 0) {
-        body = buildBody(fields, rawFields);
-    }
-    const hasBody = body !== undefined;
-    const method = String(args.method ?? (hasBody ? "POST" : "GET")).toUpperCase();
-    assertMethod(method);
-    const query = buildQuery(toStrings(args.query));
-    const headers = parseHeaders(toStrings(args.header));
-    const params = {
-        path,
-        method,
-        ...(Object.keys(query).length > 0 ? { query } : {}),
-        ...(hasBody ? { body } : {}),
-        ...(Object.keys(headers).length > 0 ? { headers } : {}),
-    };
-    const response = await args.apiClient.request(params);
-    const out = process.stdout;
-    if (args.include) {
-        out.write(`HTTP ${response.status} ${response.statusText}\n`);
-        for (const [key, value] of Object.entries(response.headers)) {
-            out.write(`${key}: ${value}\n`);
-        }
-        out.write("\n");
-    }
-    if (response.data === undefined) {
-        return;
-    }
-    if (args.output === "yaml") {
-        out.write(YAML.stringify(response.data));
-    }
-    else {
-        out.write(`${JSON.stringify(response.data, null, 2)}\n`);
-    }
+	const path = args.path;
+	if (!path) throw new Error("Missing API path. Usage: neon api <path> (e.g. neon api /projects). Run `neon api --list` to see available routes.");
+	if (!path.startsWith("/")) throw new Error(`Invalid path "${path}". API paths must start with "/". Run \`neon api --list\` to see available routes.`);
+	const fields = toStrings(args.field);
+	const rawFields = toStrings(args.rawField);
+	let body;
+	if (args.data !== void 0) body = await readData(args.data);
+	else if (fields.length > 0 || rawFields.length > 0) body = buildBody(fields, rawFields);
+	const hasBody = body !== void 0;
+	const method = String(args.method ?? (hasBody ? "POST" : "GET")).toUpperCase();
+	assertMethod(method);
+	const query = buildQuery(toStrings(args.query));
+	const headers = parseHeaders(toStrings(args.header));
+	const params = {
+		path,
+		method,
+		...Object.keys(query).length > 0 ? { query } : {},
+		...hasBody ? { body } : {},
+		...Object.keys(headers).length > 0 ? { headers } : {}
+	};
+	const response = await args.apiClient.request(params);
+	const out = process.stdout;
+	if (args.include) {
+		out.write(`HTTP ${response.status} ${response.statusText}\n`);
+		for (const [key, value] of Object.entries(response.headers)) out.write(`${key}: ${value}\n`);
+		out.write("\n");
+	}
+	if (response.data === void 0) return;
+	if (args.output === "yaml") out.write(YAML.stringify(response.data));
+	else out.write(`${JSON.stringify(response.data, null, 2)}\n`);
 }
-export const command = "api [path]";
-export const describe = "Call any Neon API route directly (authenticated passthrough)";
-export const builder = (argv) => argv
-    .usage("$0 api <path> [options]")
-    .positional("path", {
-    type: "string",
-    describe: 'API path beginning with "/" (e.g. /projects or ' +
-        "/projects/{project_id}/branches). Use `list` to list endpoints.",
-})
-    .options({
-    method: {
-        alias: "X",
-        type: "string",
-        describe: "HTTP method (GET, POST, PUT, PATCH, DELETE). " +
-            "Defaults to GET, or POST when a body is provided.",
-    },
-    field: {
-        alias: "F",
-        type: "array",
-        string: true,
-        describe: "Body field key=value (repeatable). Dot-notation nests " +
-            "objects (e.g. -F branch.name=dev); values are typed " +
-            "(numbers, booleans, null, JSON).",
-    },
-    "raw-field": {
-        alias: "f",
-        type: "array",
-        string: true,
-        describe: "Body field key=value with the value kept as a raw string.",
-    },
-    data: {
-        alias: "d",
-        type: "string",
-        describe: "Raw request body: a JSON string, @file, or - for stdin. " +
-            "Overrides --field.",
-    },
-    query: {
-        alias: "Q",
-        type: "array",
-        string: true,
-        describe: "Query parameter key=value (repeatable).",
-    },
-    header: {
-        alias: "H",
-        type: "array",
-        string: true,
-        describe: "Extra request header key:value (repeatable).",
-    },
-    include: {
-        alias: "i",
-        type: "boolean",
-        default: false,
-        describe: "Print the response status and headers before the body.",
-    },
-    list: {
-        type: "boolean",
-        default: false,
-        describe: "List available API endpoints from the OpenAPI spec.",
-    },
-    refresh: {
-        type: "boolean",
-        default: false,
-        describe: "Refresh the cached OpenAPI spec (used with --list).",
-    },
-    "spec-url": {
-        type: "string",
-        default: process.env.NEON_API_SPEC_URL ?? DEFAULT_SPEC_URL,
-        hidden: true,
-        describe: "OpenAPI spec URL used by --list.",
-    },
-})
-    .example("$0 api /projects", "List your projects")
-    .example("$0 api /projects/{id}/branches -X POST -F branch.name=dev", "Create a branch")
-    .example("$0 api --list", "List every available API route");
-export const handler = async (args) => {
-    const apiArgs = args;
-    if (apiArgs.list || apiArgs.path === "list" || apiArgs.path === "ls") {
-        await listEndpoints(apiArgs);
-        return;
-    }
-    await runRequest(apiArgs);
+const command = "api [path]";
+const describe = "Call any Neon API route directly (authenticated passthrough)";
+const builder = (argv) => argv.usage("$0 api <path> [options]").positional("path", {
+	type: "string",
+	describe: "API path beginning with \"/\" (e.g. /projects or /projects/{project_id}/branches). Use `list` to list endpoints."
+}).options({
+	method: {
+		alias: "X",
+		type: "string",
+		describe: "HTTP method (GET, POST, PUT, PATCH, DELETE). Defaults to GET, or POST when a body is provided."
+	},
+	field: {
+		alias: "F",
+		type: "array",
+		string: true,
+		describe: "Body field key=value (repeatable). Dot-notation nests objects (e.g. -F branch.name=dev); values are typed (numbers, booleans, null, JSON)."
+	},
+	"raw-field": {
+		alias: "f",
+		type: "array",
+		string: true,
+		describe: "Body field key=value with the value kept as a raw string."
+	},
+	data: {
+		alias: "d",
+		type: "string",
+		describe: "Raw request body: a JSON string, @file, or - for stdin. Overrides --field."
+	},
+	query: {
+		alias: "Q",
+		type: "array",
+		string: true,
+		describe: "Query parameter key=value (repeatable)."
+	},
+	header: {
+		alias: "H",
+		type: "array",
+		string: true,
+		describe: "Extra request header key:value (repeatable)."
+	},
+	include: {
+		alias: "i",
+		type: "boolean",
+		default: false,
+		describe: "Print the response status and headers before the body."
+	},
+	list: {
+		type: "boolean",
+		default: false,
+		describe: "List available API endpoints from the OpenAPI spec."
+	},
+	refresh: {
+		type: "boolean",
+		default: false,
+		describe: "Refresh the cached OpenAPI spec (used with --list)."
+	},
+	"spec-url": {
+		type: "string",
+		default: process.env.NEON_API_SPEC_URL ?? "https://neon.com/api_spec/release/v2.json",
+		hidden: true,
+		describe: "OpenAPI spec URL used by --list."
+	}
+}).example("$0 api /projects", "List your projects").example("$0 api /projects/{id}/branches -X POST -F branch.name=dev", "Create a branch").example("$0 api --list", "List every available API route");
+const handler = async (args) => {
+	const apiArgs = args;
+	if (apiArgs.list || apiArgs.path === "list" || apiArgs.path === "ls") {
+		await listEndpoints(apiArgs);
+		return;
+	}
+	await runRequest(apiArgs);
 };
+//#endregion
+export { api_exports, buildBody, buildQuery, builder, command, describe, handler, parseHeaders, parseKeyValue, parseTypedValue, setDeep };