neon 8.3.6 → 8.4.1

package/dist/utils/repeated_flags.js

@@ -0,0 +1,43 @@
+//#region src/utils/repeated_flags.ts
+const isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** The options yargs has declared for the command it is running. Not in `@types/yargs`. */
+const declaredOptions = (cli) => {
+	if (!("getOptions" in cli) || typeof cli.getOptions !== "function") throw new Error("yargs no longer exposes getOptions(); update declaredOptions for the installed yargs");
+	const options = cli.getOptions();
+	if (!isRecord(options) || !isRecord(options.key) || !isRecord(options.alias) || !Object.values(options.alias).every(isStringArray) || !isStringArray(options.array) || !isStringArray(options.boolean) || !isStringArray(options.count)) throw new Error("yargs getOptions() changed shape; update declaredOptions for the installed yargs");
+	return {
+		key: options.key,
+		alias: Object.fromEntries(Object.entries(options.alias).filter((entry) => isStringArray(entry[1]))),
+		array: options.array,
+		boolean: options.boolean,
+		count: options.count
+	};
+};
+const camelCase = (name) => name.replace(/-+([a-z0-9])/g, (_, char) => char.toUpperCase());
+/**
+* yargs collects a repeated option into an array unless it is declared as one, so a handler
+* written for one string receives several. Identical repeats collapse to one value; different
+* values are an error, worded like `single()` in flags.ts. The values are not echoed, because
+* `--api-key` is one of these flags.
+*/
+const collapseRepeatedFlags = (argv, options) => {
+	const multiValued = /* @__PURE__ */ new Set([
+		...options.array,
+		...options.boolean,
+		...options.count
+	]);
+	const aliases = new Set(Object.values(options.alias).flat());
+	for (const name of Object.keys(options.key)) {
+		if (multiValued.has(name) || aliases.has(name)) continue;
+		const value = argv[name];
+		if (!Array.isArray(value) || value.length < 2) continue;
+		if (new Set(value).size > 1) throw new Error(`--${name} was given more than once. Pass it at most once.`);
+		for (const key of [name, ...options.alias[name] ?? []]) {
+			argv[key] = value[0];
+			argv[camelCase(key)] = value[0];
+		}
+	}
+};
+//#endregion
+export { collapseRepeatedFlags, declaredOptions };

package/dist/utils/staging.js

@@ -0,0 +1,49 @@
+import { Parser, hideBin } from "yargs/helpers";
+//#region src/utils/staging.ts
+/**
+* Staging-only features ship in a release before their API reaches production. The CLI
+* exposes them only when the API host it sends requests to (`--api-host`, else
+* `NEON_API_HOST`) is Neon's staging console; with production or no host set, they are
+* hidden from help and fail with a "coming soon" message.
+*/
+const STAGING_API_HOST = "https://console-stage.neon.build/api/v2";
+const REALTIME_COMING_SOON = `Neon Realtime is coming soon! For now it only works on Neon's staging API: set NEON_API_HOST=${STAGING_API_HOST} or pass --api-host.`;
+/** `NEON_STAGING_API_HOST` lets the CLI's tests treat their local mock API as staging. */
+const stagingHostname = () => new URL(process.env.NEON_STAGING_API_HOST ?? "https://console-stage.neon.build/api/v2").hostname;
+const isStagingApiHost = (apiHost) => apiHost !== void 0 && URL.canParse(apiHost) && new URL(apiHost).hostname === stagingHostname();
+/** The API host this process was invoked with, read before or without yargs. */
+const stagingFeaturesEnabledForArgv = (args = hideBin(process.argv)) => {
+	const { argv } = Parser.detailed([...args], {
+		string: ["api-host"],
+		alias: { "api-host": ["apiHost"] },
+		configuration: {
+			"populate--": true,
+			"parse-positional-numbers": false
+		}
+	});
+	const flag = argv["api-host"];
+	return isStagingApiHost(typeof flag === "string" ? flag : process.env.NEON_API_HOST);
+};
+/** `apiHost` is a command's resolved host; without one, the host this process was invoked with. */
+const stagingFeaturesEnabled = (apiHost) => apiHost === void 0 ? stagingFeaturesEnabledForArgv() : isStagingApiHost(apiHost);
+/** Service names to list in help: Realtime only on staging. */
+const listedServices = (services) => stagingFeaturesEnabledForArgv() ? services : services.filter((service) => service !== "realtime");
+/** A hard stop: callers that degrade other failures to warnings let this one through. */
+var StagingOnlyError = class extends Error {
+	constructor(..._args) {
+		super(..._args);
+		this.name = "StagingOnlyError";
+	}
+};
+const assertRealtimeAvailable = (apiHost) => {
+	if (!stagingFeaturesEnabled(apiHost)) throw new StagingOnlyError(REALTIME_COMING_SOON);
+};
+/**
+* A `neon.ts` with any `preview.realtime` value reads the Realtime API, which production
+* does not serve. `false` reads it too, to disable Realtime on the branch.
+*/
+const assertPolicyAvailable = (config, apiHost) => {
+	if (config.preview?.realtime !== void 0) assertRealtimeAvailable(apiHost);
+};
+//#endregion
+export { REALTIME_COMING_SOON, STAGING_API_HOST, StagingOnlyError, assertPolicyAvailable, assertRealtimeAvailable, isStagingApiHost, listedServices, stagingFeaturesEnabled, stagingFeaturesEnabledForArgv };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon",
-  "version": "8.3.6",
+  "version": "8.4.1",
   "description": "CLI tool for Neon, the cloud backend primitives built around Lakebase Postgres",
   "keywords": [
     "neon",
@@ -55,6 +55,7 @@
     "fflate": "^0.8.3",
     "open": "^10.2.0",
     "openid-client": "6.8.1",
+    "pg-connection-string": "^2.14.1",
     "pg-protocol": "^1.14.0",
     "picocolors": "^1.1.1",
     "prompts": "2.4.2",
@@ -64,9 +65,10 @@
     "yaml": "^2.9.0",
     "yargs": "17.7.2",
     "yoctocolors": "^2.1.2",
-    "@neon/config-runtime": "1.8.1",
-    "@neon/sdk": "7.0.1",
-    "@neon/config": "1.8.7"
+    "@neon/config": "1.9.1",
+    "@neon/config-runtime": "1.9.1",
+    "@neon/realtime": "0.0.1",
+    "@neon/sdk": "7.2.0"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "1.3.0",
@@ -101,7 +103,7 @@
     "typescript": "^5.9.0",
     "vitest": "^3.0.9",
     "@neon-internals/cli-core": "0.0.0",
-    "@neon-internals/env-core": "0.0.30",
+    "@neon-internals/env-core": "0.0.32",
     "@neon/e2e-harness": "0.0.0",
     "@neon/functions": "0.11.0"
   },