neon 2.47.0 → 3.1.0

package/dist/psql/core/syncVars.js

@@ -1,116 +1,73 @@
+//#region src/psql/core/syncVars.ts
+const asString = (value) => typeof value === "string" ? value : void 0;
+const asPort = (value) => typeof value === "number" && Number.isFinite(value) ? String(value) : void 0;
 /**
- * Connection-driven psql variable sync.
- *
- * TypeScript port of `SyncVariables()` in upstream PostgreSQL's
- * `src/bin/psql/command.c`. After every successful connection (the initial
- * connect in `runPsql` and each `\c` reconnect), psql refreshes the set of
- * read-only "connection" variables that scripts interpolate with `:DBNAME`,
- * `:USER`, etc. Without this the names interpolate to their literal text
- * (`:USER` → `:USER`) instead of the live connection facts.
- *
- * The variables synced here mirror upstream's `SyncVariables()`:
- *
- *   - `DBNAME`              — connection database
- *   - `USER`               — connection user
- *   - `HOST`               — host the client connected to (a socket directory
- *                            for a Unix-domain socket — starts with `/`)
- *   - `PORT`               — connection port (stringified)
- *   - `ENCODING`           — client encoding name (the `client_encoding`
- *                            ParameterStatus). The mainloop keeps this in
- *                            sync on later `SET client_encoding`; we seed it
- *                            here so it is correct from the first prompt.
- *   - `SERVER_VERSION_NAME`— the `server_version` ParameterStatus (e.g. `18.4`)
- *   - `SERVER_VERSION_NUM` — the numeric server version (e.g. `180004`),
- *                            stringified from `Connection.serverVersion`
- *
- * The CLIENT version variables (`VERSION` / `VERSION_NAME` / `VERSION_NUM`)
- * are constant for the life of the process and set once at startup — see
- * {@link setStartupVars}.
- */
-const asString = (value) => typeof value === "string" ? value : undefined;
-const asPort = (value) => typeof value === "number" && Number.isFinite(value)
-    ? String(value)
-    : undefined;
-/**
- * Refresh the connection variables (`DBNAME`, `USER`, `HOST`, `PORT`,
- * `ENCODING`, `SERVER_VERSION_NAME`, `SERVER_VERSION_NUM`) from the live
- * connection. Mirrors upstream `SyncVariables()`. Call after a successful
- * initial connect and after each `\c` reconnect.
- *
- * A variable is only set when the connection actually surfaces a value; this
- * leaves any user-set value untouched if the connection cannot report one.
- */
-export const syncConnectionVars = (vars, conn) => {
-    const target = conn;
-    const database = asString(target.database);
-    if (database !== undefined)
-        vars.set("DBNAME", database);
-    const user = asString(target.user);
-    if (user !== undefined)
-        vars.set("USER", user);
-    const host = asString(target.host);
-    if (host !== undefined)
-        vars.set("HOST", host);
-    const port = asPort(target.port);
-    if (port !== undefined)
-        vars.set("PORT", port);
-    // ENCODING tracks the server's `client_encoding` ParameterStatus. The
-    // mainloop refreshes it after each `SET client_encoding`; seed it here so
-    // it is populated from the very first prompt (and re-seeded after `\c`).
-    const encoding = conn.parameterStatus("client_encoding");
-    if (encoding !== undefined)
-        vars.set("ENCODING", encoding);
-    const serverVersionName = conn.parameterStatus("server_version");
-    if (serverVersionName !== undefined) {
-        vars.set("SERVER_VERSION_NAME", serverVersionName);
-    }
-    // `Connection.serverVersion` is the libpq-style integer (e.g. 180004 for
-    // 18.4); 0 means "not yet reported" — skip it so we don't write a bogus 0.
-    if (conn.serverVersion > 0) {
-        vars.set("SERVER_VERSION_NUM", String(conn.serverVersion));
-    }
+* Refresh the connection variables (`DBNAME`, `USER`, `HOST`, `PORT`,
+* `ENCODING`, `SERVER_VERSION_NAME`, `SERVER_VERSION_NUM`) from the live
+* connection. Mirrors upstream `SyncVariables()`. Call after a successful
+* initial connect and after each `\c` reconnect.
+*
+* A variable is only set when the connection actually surfaces a value; this
+* leaves any user-set value untouched if the connection cannot report one.
+*/
+const syncConnectionVars = (vars, conn) => {
+	const target = conn;
+	const database = asString(target.database);
+	if (database !== void 0) vars.set("DBNAME", database);
+	const user = asString(target.user);
+	if (user !== void 0) vars.set("USER", user);
+	const host = asString(target.host);
+	if (host !== void 0) vars.set("HOST", host);
+	const port = asPort(target.port);
+	if (port !== void 0) vars.set("PORT", port);
+	const encoding = conn.parameterStatus("client_encoding");
+	if (encoding !== void 0) vars.set("ENCODING", encoding);
+	const serverVersionName = conn.parameterStatus("server_version");
+	if (serverVersionName !== void 0) vars.set("SERVER_VERSION_NAME", serverVersionName);
+	if (conn.serverVersion > 0) vars.set("SERVER_VERSION_NUM", String(conn.serverVersion));
 };
 /**
- * Set the constant CLIENT version variables once at startup, mirroring how
- * upstream psql seeds `VERSION` / `VERSION_NAME` / `VERSION_NUM` from its
- * compiled-in `PG_VERSION` / `PG_VERSION_NUM`:
- *
- *   - `VERSION`      — the full banner string (upstream: `PostgreSQL <ver> …`).
- *   - `VERSION_NAME` — the bare version number (upstream: e.g. `18.4`).
- *   - `VERSION_NUM`  — the numeric version (upstream: e.g. `180004`).
- *
- * The embedded psql is not a real PostgreSQL build, so there is no
- * `PG_VERSION` to read. We derive the values from neonctl's own package
- * version (passed in as {@link clientVersion}, e.g. `2.22.0`) so the client
- * identifier is real and traceable to the shipped binary, while keeping
- * upstream's variable *shapes*:
- *
- *   - `VERSION`      → `psql-ts (neon) <clientVersion>` — a banner that
- *     names the implementation so users can tell they are on the embedded
- *     TS port, mirroring the startup banner's `psql-ts (neon, …)` shape.
- *   - `VERSION_NAME` → `<clientVersion>` (e.g. `2.22.0`).
- *   - `VERSION_NUM`  → the same version mapped into PG's NNMMPP integer form
- *     (`2.22.0` → `22200`) via {@link clientVersionNum}, so a script doing a
- *     numeric `:VERSION_NUM` comparison gets a monotonic integer.
- */
-export const setStartupVars = (vars, clientVersion) => {
-    vars.set("VERSION", `psql-ts (neon) ${clientVersion}`);
-    vars.set("VERSION_NAME", clientVersion);
-    vars.set("VERSION_NUM", String(clientVersionNum(clientVersion)));
+* Set the constant CLIENT version variables once at startup, mirroring how
+* upstream psql seeds `VERSION` / `VERSION_NAME` / `VERSION_NUM` from its
+* compiled-in `PG_VERSION` / `PG_VERSION_NUM`:
+*
+*   - `VERSION`      — the full banner string (upstream: `PostgreSQL <ver> …`).
+*   - `VERSION_NAME` — the bare version number (upstream: e.g. `18.4`).
+*   - `VERSION_NUM`  — the numeric version (upstream: e.g. `180004`).
+*
+* The embedded psql is not a real PostgreSQL build, so there is no
+* `PG_VERSION` to read. We derive the values from neonctl's own package
+* version (passed in as {@link clientVersion}, e.g. `2.22.0`) so the client
+* identifier is real and traceable to the shipped binary, while keeping
+* upstream's variable *shapes*:
+*
+*   - `VERSION`      → `psql-ts (neon) <clientVersion>` — a banner that
+*     names the implementation so users can tell they are on the embedded
+*     TS port, mirroring the startup banner's `psql-ts (neon, …)` shape.
+*   - `VERSION_NAME` → `<clientVersion>` (e.g. `2.22.0`).
+*   - `VERSION_NUM`  → the same version mapped into PG's NNMMPP integer form
+*     (`2.22.0` → `22200`) via {@link clientVersionNum}, so a script doing a
+*     numeric `:VERSION_NUM` comparison gets a monotonic integer.
+*/
+const setStartupVars = (vars, clientVersion) => {
+	vars.set("VERSION", `psql-ts (neon) ${clientVersion}`);
+	vars.set("VERSION_NAME", clientVersion);
+	vars.set("VERSION_NUM", String(clientVersionNum(clientVersion)));
 };
 /**
- * Map a `MAJOR.MINOR.PATCH` semver-style version string into PG's
- * `PG_VERSION_NUM` integer layout (`MAJOR * 10000 + MINOR * 100 + PATCH`,
- * e.g. `2.22.0` → `22200`). Missing components default to 0; a non-numeric
- * leading component yields `0`. Kept deliberately tolerant — the value only
- * needs to be a monotonic integer for `:VERSION_NUM` comparisons.
- */
-export const clientVersionNum = (version) => {
-    const m = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(version.trim());
-    if (!m)
-        return 0;
-    const major = parseInt(m[1], 10);
-    const minor = m[2] !== undefined ? parseInt(m[2], 10) : 0;
-    const patch = m[3] !== undefined ? parseInt(m[3], 10) : 0;
-    return major * 10000 + minor * 100 + patch;
+* Map a `MAJOR.MINOR.PATCH` semver-style version string into PG's
+* `PG_VERSION_NUM` integer layout (`MAJOR * 10000 + MINOR * 100 + PATCH`,
+* e.g. `2.22.0` → `22200`). Missing components default to 0; a non-numeric
+* leading component yields `0`. Kept deliberately tolerant — the value only
+* needs to be a monotonic integer for `:VERSION_NUM` comparisons.
+*/
+const clientVersionNum = (version) => {
+	const m = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(version.trim());
+	if (!m) return 0;
+	const major = parseInt(m[1], 10);
+	const minor = m[2] !== void 0 ? parseInt(m[2], 10) : 0;
+	const patch = m[3] !== void 0 ? parseInt(m[3], 10) : 0;
+	return major * 1e4 + minor * 100 + patch;
 };
+//#endregion
+export { clientVersionNum, setStartupVars, syncConnectionVars };

package/dist/psql/core/variables.js

@@ -1,287 +1,165 @@
-/**
- * psql Variables store.
- *
- * TypeScript port of PostgreSQL's `src/bin/psql/variables.c`. Models a psql
- * "variable space" — a name → string-value mapping with per-variable
- * notification hooks and the parsing helpers psql uses to coerce values to
- * booleans, tri-state ("on"/"off"/"auto") values, and integers.
- *
- * Deviations from upstream that are intentional:
- *
- *  - Storage is a `Map<string, string>` rather than a doubly-linked list.
- *    Insertion order is preserved by Map (psql sorts alphabetically purely for
- *    pretty-printing in `\set`; that responsibility belongs to a future
- *    printer/help WP, not the store).
- *  - Multiple hooks per name are allowed (upstream has at most one substitute
- *    + one assign hook per variable). All hooks must return `true` for a
- *    `set()` to be accepted; if any vetoes, the value is left unchanged.
- *  - On `addHook()` we synchronously replay the current value (or `null` if
- *    unset) through the new hook. This matches the upstream behaviour where
- *    `SetVariableHooks` fires the substitute and assign hooks immediately so
- *    derived psql state can sync.
- *  - On `unset()` registered hooks are notified with `null` and remain
- *    registered. The value is removed from the map (so `has()` returns
- *    `false`), but a later `set()` will still consult the hooks.
- *  - Variable names are validated against `[A-Za-z_][A-Za-z0-9_]*` per the
- *    WP-06 spec. Upstream additionally accepts non-ASCII bytes and a leading
- *    digit; we deliberately tighten the rule for the TS port.
- */
+//#region src/psql/core/variables.ts
 const VALID_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
 /** Case-insensitive prefix match: does `value` start with `prefix`? */
-const isPrefixOf = (value, prefix) => value.length > 0 &&
-    value.length <= prefix.length &&
-    prefix.slice(0, value.length).toLowerCase() === value.toLowerCase();
+const isPrefixOf = (value, prefix) => value.length > 0 && value.length <= prefix.length && prefix.slice(0, value.length).toLowerCase() === value.toLowerCase();
 /**
- * Parse a string the way psql's `ParseVariableBool` does.
- *
- * Recognised tokens (case-insensitive, with unique-prefix matching for the
- * word forms): `true`, `false`, `yes`, `no`, `on`, `off`, `1`, `0`. For `on`
- * and `off` we require at least two characters of input — a bare `o` is
- * ambiguous and upstream rejects it.
- *
- * Returns the parsed boolean, or `null` if the string is not recognised.
- */
+* Parse a string the way psql's `ParseVariableBool` does.
+*
+* Recognised tokens (case-insensitive, with unique-prefix matching for the
+* word forms): `true`, `false`, `yes`, `no`, `on`, `off`, `1`, `0`. For `on`
+* and `off` we require at least two characters of input — a bare `o` is
+* ambiguous and upstream rejects it.
+*
+* Returns the parsed boolean, or `null` if the string is not recognised.
+*/
 const parseBool = (value) => {
-    if (value.length === 0)
-        return null;
-    if (isPrefixOf(value, "true"))
-        return true;
-    if (isPrefixOf(value, "false"))
-        return false;
-    if (isPrefixOf(value, "yes"))
-        return true;
-    if (isPrefixOf(value, "no"))
-        return false;
-    // 'on'/'off' need at least 2 chars; 'o' alone is ambiguous.
-    if (value.length >= 2) {
-        const lower = value.toLowerCase();
-        if ("on".startsWith(lower))
-            return true;
-        if ("off".startsWith(lower))
-            return false;
-    }
-    if (value === "1")
-        return true;
-    if (value === "0")
-        return false;
-    // WP-06 extension: any other strtol-parsable integer is truthy if non-zero,
-    // falsy if zero. Upstream `ParseVariableBool` rejects "42" outright; we
-    // accept it so callers don't need a separate code path for numeric flags.
-    const asNum = parseInt32(value);
-    if (asNum !== null)
-        return asNum !== 0;
-    return null;
+	if (value.length === 0) return null;
+	if (isPrefixOf(value, "true")) return true;
+	if (isPrefixOf(value, "false")) return false;
+	if (isPrefixOf(value, "yes")) return true;
+	if (isPrefixOf(value, "no")) return false;
+	if (value.length >= 2) {
+		const lower = value.toLowerCase();
+		if ("on".startsWith(lower)) return true;
+		if ("off".startsWith(lower)) return false;
+	}
+	if (value === "1") return true;
+	if (value === "0") return false;
+	const asNum = parseInt32(value);
+	if (asNum !== null) return asNum !== 0;
+	return null;
 };
 /**
- * Parse a string as an integer the way psql's `ParseVariableNum` does
- * (base 0, i.e. `0x` and leading-zero octal forms are accepted), and clamp
- * to the 32-bit signed range that psql uses (the C cast `numval == (int)
- * numval` check).
- *
- * Returns the integer, or `null` on syntax / range failure.
- */
+* Parse a string as an integer the way psql's `ParseVariableNum` does
+* (base 0, i.e. `0x` and leading-zero octal forms are accepted), and clamp
+* to the 32-bit signed range that psql uses (the C cast `numval == (int)
+* numval` check).
+*
+* Returns the integer, or `null` on syntax / range failure.
+*/
 const parseInt32 = (value) => {
-    if (value.length === 0)
-        return null;
-    const trimmed = value.trim();
-    if (trimmed.length === 0)
-        return null;
-    // Match the prefixes strtol(_, _, 0) accepts and pick the matching radix
-    // explicitly so we can validate the entire string (Number()/parseInt with
-    // base 0 are not portable enough for this).
-    let body = trimmed;
-    let sign = 1;
-    if (body.startsWith("+")) {
-        body = body.slice(1);
-    }
-    else if (body.startsWith("-")) {
-        sign = -1;
-        body = body.slice(1);
-    }
-    if (body.length === 0)
-        return null;
-    let radix = 10;
-    if (body.startsWith("0x") || body.startsWith("0X")) {
-        radix = 16;
-        body = body.slice(2);
-    }
-    else if (body.startsWith("0o") || body.startsWith("0O")) {
-        radix = 8;
-        body = body.slice(2);
-    }
-    else if (body.length > 1 && body.startsWith("0")) {
-        // C strtol with base 0 treats a leading 0 as octal. JS users typically
-        // expect decimal; we follow upstream for behavioural fidelity.
-        radix = 8;
-        body = body.slice(1);
-    }
-    if (body.length === 0)
-        return null;
-    const digitRe = radix === 16 ? /^[0-9a-fA-F]+$/ : radix === 8 ? /^[0-7]+$/ : /^[0-9]+$/;
-    if (!digitRe.test(body))
-        return null;
-    const parsed = sign * parseInt(body, radix);
-    if (!Number.isFinite(parsed))
-        return null;
-    // Match `numval == (int) numval` — 32-bit signed range.
-    if (parsed < -0x80000000 || parsed > 0x7fffffff)
-        return null;
-    return parsed;
+	if (value.length === 0) return null;
+	const trimmed = value.trim();
+	if (trimmed.length === 0) return null;
+	let body = trimmed;
+	let sign = 1;
+	if (body.startsWith("+")) body = body.slice(1);
+	else if (body.startsWith("-")) {
+		sign = -1;
+		body = body.slice(1);
+	}
+	if (body.length === 0) return null;
+	let radix = 10;
+	if (body.startsWith("0x") || body.startsWith("0X")) {
+		radix = 16;
+		body = body.slice(2);
+	} else if (body.startsWith("0o") || body.startsWith("0O")) {
+		radix = 8;
+		body = body.slice(2);
+	} else if (body.length > 1 && body.startsWith("0")) {
+		radix = 8;
+		body = body.slice(1);
+	}
+	if (body.length === 0) return null;
+	if (!(radix === 16 ? /^[0-9a-fA-F]+$/ : radix === 8 ? /^[0-7]+$/ : /^[0-9]+$/).test(body)) return null;
+	const parsed = sign * parseInt(body, radix);
+	if (!Number.isFinite(parsed)) return null;
+	if (parsed < -2147483648 || parsed > 2147483647) return null;
+	return parsed;
+};
+var VarStore = class {
+	constructor() {
+		this.values = /* @__PURE__ */ new Map();
+		this.hooks = /* @__PURE__ */ new Map();
+	}
+	set(name, value) {
+		return this.trySet(name, value).ok;
+	}
+	trySet(name, value) {
+		if (!VALID_NAME_RE.test(name)) return {
+			ok: false,
+			reason: "invalid-name"
+		};
+		const hooks = this.hooks.get(name);
+		let toStore = value;
+		if (hooks) for (const hook of hooks) {
+			const result = hook(toStore);
+			if (result === false) return {
+				ok: false,
+				reason: "hook-veto"
+			};
+			if (typeof result === "string") return {
+				ok: false,
+				reason: "hook-veto",
+				error: result
+			};
+			if (typeof result === "object" && result !== null) toStore = result.substitute;
+		}
+		this.values.set(name, toStore);
+		return { ok: true };
+	}
+	get(name) {
+		return this.values.get(name);
+	}
+	unset(name) {
+		const had = this.values.delete(name);
+		const hooks = this.hooks.get(name);
+		if (hooks) {
+			let substituted = null;
+			for (const hook of hooks) {
+				const r = hook(null);
+				if (typeof r === "object" && r !== null && "substitute" in r) substituted = r.substitute;
+			}
+			if (substituted !== null) {
+				this.values.set(name, substituted);
+				for (const hook of hooks) hook(substituted);
+			}
+		}
+		return had;
+	}
+	has(name) {
+		return this.values.has(name);
+	}
+	hasSubstituteHook(name) {
+		const hooks = this.hooks.get(name);
+		return hooks !== void 0 && hooks.length > 0;
+	}
+	addHook(name, hook) {
+		if (!VALID_NAME_RE.test(name)) return;
+		const existing = this.hooks.get(name);
+		if (existing) existing.push(hook);
+		else this.hooks.set(name, [hook]);
+		const result = hook(this.values.get(name) ?? null);
+		if (typeof result === "object" && result !== null && "substitute" in result) {
+			this.values.set(name, result.substitute);
+			hook(result.substitute);
+		}
+	}
+	entries() {
+		return this.values.entries();
+	}
+	asBool(name, defaultValue = false) {
+		const value = this.values.get(name);
+		if (value === void 0) return defaultValue;
+		return parseBool(value) ?? defaultValue;
+	}
+	asTriple(name, defaultValue) {
+		const value = this.values.get(name);
+		if (value === void 0) return defaultValue;
+		if (isPrefixOf(value, "auto")) return "auto";
+		const parsed = parseBool(value);
+		if (parsed === null) return { error: `unrecognized value "${value}" for "${name}": Boolean expected` };
+		return parsed ? "on" : "off";
+	}
+	asInt(name, defaultValue = 0) {
+		const value = this.values.get(name);
+		if (value === void 0) return defaultValue;
+		const parsed = parseInt32(value);
+		if (parsed === null) return { error: `invalid value "${value}" for "${name}": integer expected` };
+		return parsed;
+	}
 };
-export class VarStore {
-    constructor() {
-        this.values = new Map();
-        this.hooks = new Map();
-    }
-    set(name, value) {
-        return this.trySet(name, value).ok;
-    }
-    trySet(name, value) {
-        if (!VALID_NAME_RE.test(name)) {
-            return { ok: false, reason: "invalid-name" };
-        }
-        const hooks = this.hooks.get(name);
-        let toStore = value;
-        if (hooks) {
-            // All hooks must accept the value. Each hook can either:
-            //   - return `true` to accept as-is,
-            //   - return `false` to reject silently (the prior value is kept),
-            //   - return a `string` to reject with that error message
-            //     (cmdSet renders it with the `psql: ` prefix), or
-            //   - return `{ substitute: '<value>' }` to rewrite the stored value
-            //     before subsequent hooks see it.
-            //
-            // The substitute return is the collapsed equivalent of upstream's
-            // separate substitute/assign hook pair (see
-            // `bool_substitute_hook` + `bool_assign_hook` in `command.c`).
-            // Hooks are responsible for ensuring their substituted value passes
-            // their own validation — we do NOT re-run a hook against its own
-            // substitution.
-            for (const hook of hooks) {
-                const result = hook(toStore);
-                if (result === false) {
-                    return { ok: false, reason: "hook-veto" };
-                }
-                if (typeof result === "string") {
-                    return { ok: false, reason: "hook-veto", error: result };
-                }
-                if (typeof result === "object" && result !== null) {
-                    toStore = result.substitute;
-                }
-            }
-        }
-        this.values.set(name, toStore);
-        return { ok: true };
-    }
-    get(name) {
-        return this.values.get(name);
-    }
-    unset(name) {
-        const had = this.values.delete(name);
-        const hooks = this.hooks.get(name);
-        if (hooks) {
-            // Notify hooks of deletion so they can clear derived state.
-            // Upstream substitute hooks (e.g. `on_error_rollback_substitute_hook`,
-            // `bool_substitute_hook`) re-inject a default when `newval == NULL` —
-            // so `\unset ON_ERROR_ROLLBACK` actually re-stores "off",
-            // `\unset AUTOCOMMIT` re-stores "on", etc. Honor the substitute by
-            // re-storing the value the hook returns. Plain `true` / `false` /
-            // error-string returns mean "no substitute" and the slot stays empty.
-            let substituted = null;
-            for (const hook of hooks) {
-                const r = hook(null);
-                if (typeof r === "object" && r !== null && "substitute" in r) {
-                    substituted = r.substitute;
-                }
-            }
-            if (substituted !== null) {
-                this.values.set(name, substituted);
-                // Re-notify hooks with the substituted value so derived state
-                // (settings.onErrorRollback, etc.) gets the correct default.
-                for (const hook of hooks)
-                    hook(substituted);
-            }
-        }
-        return had;
-    }
-    has(name) {
-        return this.values.has(name);
-    }
-    hasSubstituteHook(name) {
-        const hooks = this.hooks.get(name);
-        return hooks !== undefined && hooks.length > 0;
-    }
-    addHook(name, hook) {
-        if (!VALID_NAME_RE.test(name))
-            return;
-        const existing = this.hooks.get(name);
-        if (existing) {
-            existing.push(hook);
-        }
-        else {
-            this.hooks.set(name, [hook]);
-        }
-        // Replay the current value so the hook can sync immediately, matching
-        // upstream `SetVariableHooks`:
-        //   if (shook) current->value = (*shook)(current->value);
-        //   if (ahook) (void) (*ahook)(current->value);
-        // Our hooks combine substitute + assign in a single callback. If the
-        // initial replay returns a `{substitute}` (the bool_substitute_hook /
-        // verbosity_substitute_hook etc. pattern), persist that and re-run the
-        // hook so derived state (settings.verbosity, settings.echo, ...) syncs
-        // to the substituted value. This is how upstream seeds defaults like
-        // `ON_ERROR_STOP=off`, `VERBOSITY=default`, `QUIET=off` etc. simply
-        // from `SetVariableHooks` — no explicit `SetVariable("…", "off")` call
-        // is needed for variables whose default matches the unset substitute.
-        const current = this.values.get(name);
-        const result = hook(current ?? null);
-        if (typeof result === "object" &&
-            result !== null &&
-            "substitute" in result) {
-            this.values.set(name, result.substitute);
-            hook(result.substitute);
-        }
-    }
-    entries() {
-        return this.values.entries();
-    }
-    asBool(name, defaultValue = false) {
-        const value = this.values.get(name);
-        if (value === undefined)
-            return defaultValue;
-        const parsed = parseBool(value);
-        return parsed ?? defaultValue;
-    }
-    asTriple(name, defaultValue) {
-        const value = this.values.get(name);
-        if (value === undefined)
-            return defaultValue;
-        // "auto" is matched first as a unique prefix, so "a", "au", "aut",
-        // "auto" all map to 'auto'. psql's actual call site does an
-        // `pg_strncasecmp(value, "auto", len)` before falling through to
-        // ParseVariableBool — we do the same.
-        if (isPrefixOf(value, "auto"))
-            return "auto";
-        const parsed = parseBool(value);
-        if (parsed === null) {
-            return {
-                error: `unrecognized value "${value}" for "${name}": Boolean expected`,
-            };
-        }
-        return parsed ? "on" : "off";
-    }
-    asInt(name, defaultValue = 0) {
-        const value = this.values.get(name);
-        if (value === undefined)
-            return defaultValue;
-        const parsed = parseInt32(value);
-        if (parsed === null) {
-            return {
-                error: `invalid value "${value}" for "${name}": integer expected`,
-            };
-        }
-        return parsed;
-    }
-}
 /** Factory mirroring the upstream `CreateVariableSpace()` entry point. */
-export const createVarStore = () => new VarStore();
+const createVarStore = () => new VarStore();
+//#endregion
+export { VarStore, createVarStore };