neon 3.0.0 → 3.1.1

package/dist/utils/cli_name.js

@@ -1,14 +1,17 @@
 import { basename } from "node:path";
+//#region src/utils/cli_name.ts
 /**
- * The name this CLI was invoked as: `neon` (current) or `neonctl` (legacy alias).
- *
- * Use this for any user-facing string that suggests a command to run — help text,
- * error hints, and especially `--agent` `next_command_template` values, which an agent
- * executes verbatim. Hardcoding `neonctl` breaks those on installs of the `neon` package,
- * which no longer ships a `neonctl` binary (removed in `neon@2.38.0`).
- *
- * Derived from `process.argv[1]`, which is fixed for the process lifetime, so the result
- * is stable whether this is called at module load or per invocation. Mirrors the name used
- * for yargs `.scriptName()` in `index.ts`.
- */
-export const getCliName = () => basename(process.argv[1] ?? "") === "neonctl" ? "neonctl" : "neon";
+* The name this CLI was invoked as: `neon` (current) or `neonctl` (legacy alias).
+*
+* Use this for any user-facing string that suggests a command to run — help text,
+* error hints, and especially `--agent` `next_command_template` values, which an agent
+* executes verbatim. Hardcoding `neonctl` breaks those on installs of the `neon` package,
+* which no longer ships a `neonctl` binary (removed in `neon@2.38.0`).
+*
+* Derived from `process.argv[1]`, which is fixed for the process lifetime, so the result
+* is stable whether this is called at module load or per invocation. Mirrors the name used
+* for yargs `.scriptName()` in `index.ts`.
+*/
+const getCliName = () => basename(process.argv[1] ?? "") === "neonctl" ? "neonctl" : "neon";
+//#endregion
+export { getCliName };

package/dist/utils/compute_units.js

@@ -1,28 +1,21 @@
-export const getComputeUnits = (autoscaling) => {
-    const fixedSizeAutoscaling = Number(autoscaling);
-    if (!isNaN(fixedSizeAutoscaling)) {
-        return {
-            autoscaling_limit_min_cu: fixedSizeAutoscaling,
-            autoscaling_limit_max_cu: fixedSizeAutoscaling,
-        };
-    }
-    if (!autoscaling.includes("-")) {
-        throw new Error('Autoscaling should be either fixed size (e.g. 2) or min and max sizes delimited with a dash (e.g. "0.5-1")');
-    }
-    const [min, max] = autoscaling.split("-");
-    if (!min || !max) {
-        throw new Error('Autoscaling should be either fixed size (e.g. 2) or min and max sizes delimited with a dash (e.g. "0.5-1")');
-    }
-    const minAutoscaling = Number(min);
-    const maxAutoscaling = Number(max);
-    if (isNaN(minAutoscaling)) {
-        throw new Error("Autoscaling min should be a number");
-    }
-    if (isNaN(maxAutoscaling)) {
-        throw new Error("Autoscaling max should be a number");
-    }
-    return {
-        autoscaling_limit_min_cu: minAutoscaling,
-        autoscaling_limit_max_cu: maxAutoscaling,
-    };
+//#region src/utils/compute_units.ts
+const getComputeUnits = (autoscaling) => {
+	const fixedSizeAutoscaling = Number(autoscaling);
+	if (!isNaN(fixedSizeAutoscaling)) return {
+		autoscaling_limit_min_cu: fixedSizeAutoscaling,
+		autoscaling_limit_max_cu: fixedSizeAutoscaling
+	};
+	if (!autoscaling.includes("-")) throw new Error("Autoscaling should be either fixed size (e.g. 2) or min and max sizes delimited with a dash (e.g. \"0.5-1\")");
+	const [min, max] = autoscaling.split("-");
+	if (!min || !max) throw new Error("Autoscaling should be either fixed size (e.g. 2) or min and max sizes delimited with a dash (e.g. \"0.5-1\")");
+	const minAutoscaling = Number(min);
+	const maxAutoscaling = Number(max);
+	if (isNaN(minAutoscaling)) throw new Error("Autoscaling min should be a number");
+	if (isNaN(maxAutoscaling)) throw new Error("Autoscaling max should be a number");
+	return {
+		autoscaling_limit_min_cu: minAutoscaling,
+		autoscaling_limit_max_cu: maxAutoscaling
+	};
 };
+//#endregion
+export { getComputeUnits };

package/dist/utils/config_diff.js

@@ -1,185 +1,154 @@
 import chalk from "chalk";
+//#region src/utils/config_diff.ts
 const UNSET = "(unset)";
 /**
- * Shared palette for the config diff, matching `neon diff`'s `git diff` styling
- * (bold headers, red "before", green "after", dim connective glyphs). When
- * `color` is false every entry is the identity function, so the identical layout
- * renders without ANSI codes for `--no-color`, non-TTY pipes, and test snapshots.
- */
+* Shared palette for the config diff, matching `neon diff`'s `git diff` styling
+* (bold headers, red "before", green "after", dim connective glyphs). When
+* `color` is false every entry is the identity function, so the identical layout
+* renders without ANSI codes for `--no-color`, non-TTY pipes, and test snapshots.
+*/
 const palette = (color) => {
-    const id = (s) => s;
-    if (!color) {
-        return { title: id, group: id, added: id, removed: id, arrow: id };
-    }
-    return {
-        title: (s) => chalk.bold(s),
-        group: (s) => chalk.bold(s),
-        added: (s) => chalk.green(s),
-        removed: (s) => chalk.red(s),
-        arrow: (s) => chalk.dim(s),
-    };
+	const id = (s) => s;
+	if (!color) return {
+		title: id,
+		group: id,
+		added: id,
+		removed: id,
+		arrow: id
+	};
+	return {
+		title: (s) => chalk.bold(s),
+		group: (s) => chalk.bold(s),
+		added: (s) => chalk.green(s),
+		removed: (s) => chalk.red(s),
+		arrow: (s) => chalk.dim(s)
+	};
 };
 const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const stringifyValue = (value) => {
-    if (value === undefined || value === null || value === "")
-        return UNSET;
-    if (typeof value === "string")
-        return value;
-    if (typeof value === "boolean" || typeof value === "number") {
-        return String(value);
-    }
-    return JSON.stringify(value);
+	if (value === void 0 || value === null || value === "") return UNSET;
+	if (typeof value === "string") return value;
+	if (typeof value === "boolean" || typeof value === "number") return String(value);
+	return JSON.stringify(value);
 };
 /**
- * Expand one policy field into flat {@link FieldChange}s. When either side is a
- * plain object (compute settings, Data API settings) it splits into one
- * `field.key` entry per key across both sides, so the diff reads as sorted
- * scalar lines (`computeSettings.autoscalingLimitMaxCu  2 → 4`) rather than an
- * opaque JSON blob. Scalars produce a single entry.
- */
+* Expand one policy field into flat {@link FieldChange}s. When either side is a
+* plain object (compute settings, Data API settings) it splits into one
+* `field.key` entry per key across both sides, so the diff reads as sorted
+* scalar lines (`computeSettings.autoscalingLimitMaxCu  2 → 4`) rather than an
+* opaque JSON blob. Scalars produce a single entry.
+*/
 const expandField = (field, current, desired) => {
-    if (isPlainObject(current) || isPlainObject(desired)) {
-        const cur = isPlainObject(current) ? current : {};
-        const des = isPlainObject(desired) ? desired : {};
-        const keys = Array.from(new Set([...Object.keys(cur), ...Object.keys(des)])).sort();
-        return keys.map((key) => ({
-            field: `${field}.${key}`,
-            ...(key in cur ? { current: stringifyValue(cur[key]) } : {}),
-            desired: stringifyValue(des[key]),
-        }));
-    }
-    return [
-        {
-            field,
-            ...(current !== undefined
-                ? { current: stringifyValue(current) }
-                : {}),
-            desired: stringifyValue(desired),
-        },
-    ];
+	if (isPlainObject(current) || isPlainObject(desired)) {
+		const cur = isPlainObject(current) ? current : {};
+		const des = isPlainObject(desired) ? desired : {};
+		return Array.from(/* @__PURE__ */ new Set([...Object.keys(cur), ...Object.keys(des)])).sort().map((key) => ({
+			field: `${field}.${key}`,
+			...key in cur ? { current: stringifyValue(cur[key]) } : {},
+			desired: stringifyValue(des[key])
+		}));
+	}
+	return [{
+		field,
+		...current !== void 0 ? { current: stringifyValue(current) } : {},
+		desired: stringifyValue(desired)
+	}];
 };
 /** Render the indented `field  current → desired` lines for one branch group. */
 const renderFieldLines = (fields, paint) => {
-    const width = fields.reduce((max, f) => Math.max(max, f.field.length), 0);
-    return fields.map((f) => {
-        const name = f.field.padEnd(width);
-        const arrow = paint.arrow("→");
-        return f.current !== undefined
-            ? `      ${name}  ${paint.removed(f.current)} ${arrow} ${paint.added(f.desired)}`
-            : `      ${name}  ${arrow} ${paint.added(f.desired)}`;
-    });
+	const width = fields.reduce((max, f) => Math.max(max, f.field.length), 0);
+	return fields.map((f) => {
+		const name = f.field.padEnd(width);
+		const arrow = paint.arrow("→");
+		return f.current !== void 0 ? `      ${name}  ${paint.removed(f.current)} ${arrow} ${paint.added(f.desired)}` : `      ${name}  ${arrow} ${paint.added(f.desired)}`;
+	});
 };
 /** Group field changes by branch, each block sorted alphabetically by field. */
 const renderBranchGroups = (byBranch, paint) => {
-    const lines = [];
-    const groups = [...byBranch.entries()].sort((a, b) => a[0].localeCompare(b[0]));
-    for (const [branch, fields] of groups) {
-        const sorted = [...fields].sort((a, b) => a.field.localeCompare(b.field));
-        lines.push(`  ${paint.group(`~ ${branch}`)}`);
-        lines.push(...renderFieldLines(sorted, paint));
-    }
-    return lines;
+	const lines = [];
+	const groups = [...byBranch.entries()].sort((a, b) => a[0].localeCompare(b[0]));
+	for (const [branch, fields] of groups) {
+		const sorted = [...fields].sort((a, b) => a.field.localeCompare(b.field));
+		lines.push(`  ${paint.group(`~ ${branch}`)}`);
+		lines.push(...renderFieldLines(sorted, paint));
+	}
+	return lines;
 };
 /** Friendly label for a service change identifier (`bucket:x` → `bucket x`). */
 const serviceLabel = (identifier) => {
-    if (identifier === "auth")
-        return "Neon Auth";
-    if (identifier === "dataApi")
-        return "Data API";
-    if (identifier.startsWith("bucket:")) {
-        return `bucket ${identifier.slice("bucket:".length)}`;
-    }
-    if (identifier.startsWith("function:")) {
-        return `function ${identifier.slice("function:".length)}`;
-    }
-    return identifier;
+	if (identifier === "auth") return "Neon Auth";
+	if (identifier === "dataApi") return "Data API";
+	if (identifier.startsWith("bucket:")) return `bucket ${identifier.slice(7)}`;
+	if (identifier.startsWith("function:")) return `function ${identifier.slice(9)}`;
+	return identifier;
 };
 /**
- * The desired-only field changes for an applied/planned **branch** update. The
- * synthesized `AppliedChange.details` carry the new value keyed by `field`
- * (`parent`→`parent`, `ttl`→`expiresAt`, `protected`→`protected`,
- * `computeSettings`→`settings`); the previous value isn't threaded through in
- * Phase 1, so these render as `field → desired` (no red "before"). Object
- * settings expand into sub-fields.
- *
- * `parent` only ever arrives from a branch creation (it cannot be changed
- * afterwards), where it reports the parent the policy named.
- */
+* The desired-only field changes for an applied/planned **branch** update. The
+* synthesized `AppliedChange.details` carry the new value keyed by `field`
+* (`parent`→`parent`, `ttl`→`expiresAt`, `protected`→`protected`,
+* `computeSettings`→`settings`); the previous value isn't threaded through in
+* Phase 1, so these render as `field → desired` (no red "before"). Object
+* settings expand into sub-fields.
+*
+* `parent` only ever arrives from a branch creation (it cannot be changed
+* afterwards), where it reports the parent the policy named.
+*/
 const appliedBranchFields = (change) => {
-    const details = change.details ?? {};
-    const field = typeof details.field === "string" ? details.field : "setting";
-    switch (field) {
-        case "parent":
-            return expandField("parent", undefined, details.parent);
-        case "ttl":
-            return expandField("ttl", undefined, details.expiresAt);
-        case "protected":
-            return expandField("protected", undefined, details.protected);
-        case "computeSettings":
-            return expandField("computeSettings", undefined, details.settings);
-        default:
-            return expandField(field, undefined, details.settings);
-    }
+	const details = change.details ?? {};
+	const field = typeof details.field === "string" ? details.field : "setting";
+	switch (field) {
+		case "parent": return expandField("parent", void 0, details.parent);
+		case "ttl": return expandField("ttl", void 0, details.expiresAt);
+		case "protected": return expandField("protected", void 0, details.protected);
+		case "computeSettings": return expandField("computeSettings", void 0, details.settings);
+		default: return expandField(field, void 0, details.settings);
+	}
 };
 /**
- * Render the applied (or planned) changes as a `git diff`-style list:
- *
- * - **Service changes** (auth / Data API / buckets / functions) are additions
- *   with no meaningful "before", so they list as green `+ <label>` lines
- *   (`~ <label>` for the lone Data API settings *update*).
- * - **Branch setting changes** group per branch and render as sorted
- *   `field → value` lines under a `~ <branch>` header.
- *
- * Returns "" when there is nothing to show. Pure — callers own the heading
- * spacing and any surrounding summary.
- */
-export const renderAppliedChanges = (changes, title, opts) => {
-    if (changes.length === 0)
-        return "";
-    const paint = palette(opts.color);
-    const lines = [paint.title(title)];
-    const services = changes
-        .filter((c) => c.kind === "service")
-        .sort((a, b) => a.identifier.localeCompare(b.identifier));
-    for (const service of services) {
-        const label = serviceLabel(service.identifier);
-        lines.push(service.action === "create"
-            ? `  ${paint.added(`+ ${label}`)}`
-            : `  ${paint.arrow(`~ ${label}`)}`);
-    }
-    const byBranch = new Map();
-    for (const change of changes.filter((c) => c.kind === "branch")) {
-        const existing = byBranch.get(change.identifier) ?? [];
-        byBranch.set(change.identifier, [
-            ...existing,
-            ...appliedBranchFields(change),
-        ]);
-    }
-    lines.push(...renderBranchGroups(byBranch, paint));
-    return lines.join("\n");
+* Render the applied (or planned) changes as a `git diff`-style list:
+*
+* - **Service changes** (auth / Data API / buckets / functions) are additions
+*   with no meaningful "before", so they list as green `+ <label>` lines
+*   (`~ <label>` for the lone Data API settings *update*).
+* - **Branch setting changes** group per branch and render as sorted
+*   `field → value` lines under a `~ <branch>` header.
+*
+* Returns "" when there is nothing to show. Pure — callers own the heading
+* spacing and any surrounding summary.
+*/
+const renderAppliedChanges = (changes, title, opts) => {
+	if (changes.length === 0) return "";
+	const paint = palette(opts.color);
+	const lines = [paint.title(title)];
+	const services = changes.filter((c) => c.kind === "service").sort((a, b) => a.identifier.localeCompare(b.identifier));
+	for (const service of services) {
+		const label = serviceLabel(service.identifier);
+		lines.push(service.action === "create" ? `  ${paint.added(`+ ${label}`)}` : `  ${paint.arrow(`~ ${label}`)}`);
+	}
+	const byBranch = /* @__PURE__ */ new Map();
+	for (const change of changes.filter((c) => c.kind === "branch")) {
+		const existing = byBranch.get(change.identifier) ?? [];
+		byBranch.set(change.identifier, [...existing, ...appliedBranchFields(change)]);
+	}
+	lines.push(...renderBranchGroups(byBranch, paint));
+	return lines.join("\n");
 };
 /**
- * Render branch-setting **conflicts** (drift the policy wants to change but that
- * needs `--update-existing`) as a `git diff`-style before→after report: grouped
- * per branch, sorted by field, `current → desired` with the old value in red and
- * the new in green. Conflicts already carry both sides, so this is the fullest
- * form of the diff. Returns "" when there are no conflicts.
- */
-export const renderBranchSettingConflicts = (conflicts, opts) => {
-    if (conflicts.length === 0)
-        return "";
-    const paint = palette(opts.color);
-    const byBranch = new Map();
-    for (const conflict of conflicts) {
-        const existing = byBranch.get(conflict.identifier) ?? [];
-        byBranch.set(conflict.identifier, [
-            ...existing,
-            ...expandField(conflict.field, conflict.current, conflict.desired),
-        ]);
-    }
-    const lines = [
-        paint.title("Branch settings differ (re-run with --update-existing to apply)"),
-        ...renderBranchGroups(byBranch, paint),
-    ];
-    return lines.join("\n");
+* Render branch-setting **conflicts** (drift the policy wants to change but that
+* needs `--update-existing`) as a `git diff`-style before→after report: grouped
+* per branch, sorted by field, `current → desired` with the old value in red and
+* the new in green. Conflicts already carry both sides, so this is the fullest
+* form of the diff. Returns "" when there are no conflicts.
+*/
+const renderBranchSettingConflicts = (conflicts, opts) => {
+	if (conflicts.length === 0) return "";
+	const paint = palette(opts.color);
+	const byBranch = /* @__PURE__ */ new Map();
+	for (const conflict of conflicts) {
+		const existing = byBranch.get(conflict.identifier) ?? [];
+		byBranch.set(conflict.identifier, [...existing, ...expandField(conflict.field, conflict.current, conflict.desired)]);
+	}
+	return [paint.title("Branch settings differ (re-run with --update-existing to apply)"), ...renderBranchGroups(byBranch, paint)].join("\n");
 };
+//#endregion
+export { renderAppliedChanges, renderBranchSettingConflicts };