neonctl 2.27.1 → 2.29.0

package/dist/psql/command/cmd_describe.js

@@ -33,10 +33,10 @@
  * Connection guard: every command checks `ctx.settings.db` is non-null
  * and emits `\<cmd>: no current connection` to stderr on miss.
  */
-import { describeOneSequence, describeOneTableDetails, describeOneViewDetails, lookupOneRelation, runListQuery, } from '../describe/formatters.js';
-import { describeAccessMethods, describeAggregates, describeConfigurationParameters, describeFunctions, describeOperators, describeRoleGrants, describeRoles, describeSubscriptions, describeTableDetails, describeTablespaces, describeTypes, listAllDbs, listCasts, listCollations, listConversions, listDbRoleSettings, listDefaultACLs, listDomains, listEventTriggers, listExtendedStats, listExtensions, listForeignDataWrappers, listForeignServers, listForeignTables, listLanguages, listLargeObjects, listOpFamilyFunctions, listOpFamilyOperators, listOperatorClasses, listOperatorFamilies, listPartitionedTables, listPublications, listSchemas, listTSConfigs, listTSDictionaries, listTSParsers, listTSTemplates, listTables, listUserMappings, objectDescription, permissionsList, } from '../describe/queries.js';
-import { processSQLNamePattern, } from '../describe/processNamePattern.js';
-import { writeErr } from './shared.js';
+import { describeOneSequence, describeOneTableDetails, describeOneViewDetails, lookupOneRelation, runListQuery, } from "../describe/formatters.js";
+import { processSQLNamePattern, } from "../describe/processNamePattern.js";
+import { describeAccessMethods, describeAggregates, describeConfigurationParameters, describeFunctions, describeOperators, describeRoleGrants, describeRoles, describeSubscriptions, describeTableDetails, describeTablespaces, describeTypes, listAllDbs, listCasts, listCollations, listConversions, listDbRoleSettings, listDefaultACLs, listDomains, listEventTriggers, listExtendedStats, listExtensions, listForeignDataWrappers, listForeignServers, listForeignTables, listLanguages, listLargeObjects, listOperatorClasses, listOperatorFamilies, listOpFamilyFunctions, listOpFamilyOperators, listPartitionedTables, listPublications, listSchemas, listTables, listTSConfigs, listTSDictionaries, listTSParsers, listTSTemplates, listUserMappings, objectDescription, permissionsList, } from "../describe/queries.js";
+import { writeErr } from "./shared.js";
 /**
  * Helper: split a `\dXY+` command name into base, verbose, showSystem.
  *
@@ -50,9 +50,9 @@ const decodeSuffix = (cmdName, base) => {
     let showSystem = false;
     // Suffix order is unrestricted in psql.
     for (const ch of tail) {
-        if (ch === '+')
+        if (ch === "+")
             verbose = true;
-        else if (ch === 'S')
+        else if (ch === "S")
             showSystem = true;
     }
     return { verbose, showSystem };
@@ -62,7 +62,7 @@ const conn = (ctx) => ctx.settings.db;
 /** Emit "no current connection" error. */
 const noConn = (ctx) => {
     writeErr(`\\${ctx.cmdName}: no current connection\n`);
-    return { status: 'error', errorWritten: true };
+    return { status: "error", errorWritten: true };
 };
 /**
  * Read the connection's current database. Mirrors upstream's
@@ -73,7 +73,7 @@ const noConn = (ctx) => {
  */
 const currentDb = (c) => {
     const meta = c;
-    return typeof meta.database === 'string' ? meta.database : '';
+    return typeof meta.database === "string" ? meta.database : "";
 };
 /**
  * Validate a `processSQLNamePattern` result against the command's max
@@ -114,7 +114,7 @@ const runWithPattern = async (ctx, pattern, query, patternOpts, maxDots = 2, ove
     const dotErr = validatePattern(pattern, result, maxDots, currentDb(c));
     if (dotErr !== null) {
         writeErr(`${dotErr}\n`);
-        return { status: 'error', errorWritten: true };
+        return { status: "error", errorWritten: true };
     }
     try {
         const basePopt = ctx.settings.popt;
@@ -122,11 +122,11 @@ const runWithPattern = async (ctx, pattern, query, patternOpts, maxDots = 2, ove
             ? { ...basePopt, topt: { ...basePopt.topt, defaultFooter: false } }
             : basePopt;
         await runListQuery(c, query, result, process.stdout, popt);
-        return { status: 'ok' };
+        return { status: "ok" };
     }
     catch (err) {
         writeErr(`\\${ctx.cmdName}: ${errMsg(err)}\n`);
-        return { status: 'error', errorWritten: true };
+        return { status: "error", errorWritten: true };
     }
 };
 /**
@@ -142,7 +142,7 @@ const runWithPattern = async (ctx, pattern, query, patternOpts, maxDots = 2, ove
  * parameter list renumbered so `$N` references stay distinct.
  */
 const applyTwoPatterns = (sql, baseParams, results) => {
-    const placeholder = 'true /* TODO(WP-20): pattern matching */';
+    const placeholder = "true /* TODO(WP-20): pattern matching */";
     let rendered = sql;
     const params = [...baseParams];
     for (const result of results) {
@@ -157,7 +157,7 @@ const applyTwoPatterns = (sql, baseParams, results) => {
         const slotOffset = params.length;
         const renumbered = conds.map((c) => c.replace(/\$(\d+)/g, (_, n) => `$${Number(n) + slotOffset}`));
         params.push(...result.params);
-        const replacement = renumbered.length === 0 ? 'true' : `(${renumbered.join(' AND ')})`;
+        const replacement = renumbered.length === 0 ? "true" : `(${renumbered.join(" AND ")})`;
         rendered =
             rendered.slice(0, idx) +
                 replacement +
@@ -197,11 +197,11 @@ const runDualPatternList = async (ctx, query, results) => {
     };
     try {
         await runListQuery(c, finalQuery, empty, process.stdout, ctx.settings.popt);
-        return { status: 'ok' };
+        return { status: "ok" };
     }
     catch (err) {
         writeErr(`\\${ctx.cmdName}: ${errMsg(err)}\n`);
-        return { status: 'error', errorWritten: true };
+        return { status: "error", errorWritten: true };
     }
 };
 /**
@@ -226,7 +226,7 @@ const applyArgPatterns = (sql, baseParams, argResults) => {
         if (idx < 0)
             continue;
         const r = argResults[i];
-        let replacement = 'true';
+        let replacement = "true";
         if (r !== null) {
             const conds = [
                 ...r.schemaConditions,
@@ -237,7 +237,7 @@ const applyArgPatterns = (sql, baseParams, argResults) => {
                 const slotOffset = params.length;
                 const renumbered = conds.map((c) => c.replace(/\$(\d+)/g, (_, n) => `$${Number(n) + slotOffset}`));
                 params.push(...r.params);
-                replacement = `(${renumbered.join(' AND ')})`;
+                replacement = `(${renumbered.join(" AND ")})`;
             }
         }
         rendered =
@@ -255,24 +255,24 @@ const applyArgPatterns = (sql, baseParams, argResults) => {
  * literal, so this is the only place the user's input gets rewritten.
  */
 const TYPENAME_ALIASES = {
-    decimal: 'numeric',
-    float: 'double precision',
-    int: 'integer',
-    'bool[]': 'boolean[]',
-    'decimal[]': 'numeric[]',
-    'float[]': 'double precision[]',
-    'float4[]': 'real[]',
-    'float8[]': 'double precision[]',
-    'int[]': 'integer[]',
-    'int2[]': 'smallint[]',
-    'int4[]': 'integer[]',
-    'int8[]': 'bigint[]',
-    'time[]': 'time without time zone[]',
-    'timetz[]': 'time with time zone[]',
-    'timestamp[]': 'timestamp without time zone[]',
-    'timestamptz[]': 'timestamp with time zone[]',
-    'varbit[]': 'bit varying[]',
-    'varchar[]': 'character varying[]',
+    decimal: "numeric",
+    float: "double precision",
+    int: "integer",
+    "bool[]": "boolean[]",
+    "decimal[]": "numeric[]",
+    "float[]": "double precision[]",
+    "float4[]": "real[]",
+    "float8[]": "double precision[]",
+    "int[]": "integer[]",
+    "int2[]": "smallint[]",
+    "int4[]": "integer[]",
+    "int8[]": "bigint[]",
+    "time[]": "time without time zone[]",
+    "timetz[]": "time with time zone[]",
+    "timestamp[]": "timestamp without time zone[]",
+    "timestamptz[]": "timestamp with time zone[]",
+    "varbit[]": "bit varying[]",
+    "varchar[]": "character varying[]",
 };
 const mapTypenamePattern = (pattern) => TYPENAME_ALIASES[pattern.toLowerCase()] ?? pattern;
 /**
@@ -283,7 +283,7 @@ const mapTypenamePattern = (pattern) => TYPENAME_ALIASES[pattern.toLowerCase()]
  * altnamevar so `\df foo int4` matches `oid -> integer` correctly.
  */
 const processArgPattern = (slot, raw) => {
-    if (raw === '-')
+    if (raw === "-")
         return null;
     const mapped = mapTypenamePattern(raw);
     return processSQLNamePattern({
@@ -306,7 +306,7 @@ const collectArgPatterns = (ctx) => {
     // from the scanner; describeFunctions caps at FUNC_MAX_ARGS (100).
     // We let the caller decide what to do with extras (mostly: ignore).
     for (;;) {
-        const arg = ctx.nextArg('normal');
+        const arg = ctx.nextArg("normal");
         if (arg === null)
             break;
         args.push(arg);
@@ -327,7 +327,7 @@ const runFunctionOrOperatorQuery = async (ctx, pattern, argPatternResults, query
     const dotErr = validatePattern(pattern, result, 2, currentDb(c));
     if (dotErr !== null) {
         writeErr(`${dotErr}\n`);
-        return { status: 'error', errorWritten: true };
+        return { status: "error", errorWritten: true };
     }
     // Substitute the arg-pattern placeholders first so the params they
     // contribute precede the main pattern's `$N` allocations.
@@ -339,11 +339,11 @@ const runFunctionOrOperatorQuery = async (ctx, pattern, argPatternResults, query
     };
     try {
         await runListQuery(c, finalQuery, result, process.stdout, ctx.settings.popt);
-        return { status: 'ok' };
+        return { status: "ok" };
     }
     catch (err) {
         writeErr(`\\${ctx.cmdName}: ${errMsg(err)}\n`);
-        return { status: 'error', errorWritten: true };
+        return { status: "error", errorWritten: true };
     }
 };
 const errMsg = (err) => err instanceof Error ? err.message : String(err);
@@ -355,7 +355,7 @@ const errMsg = (err) => err instanceof Error ? err.message : String(err);
 const makeDescribeCmd = (baseName) => ({
     name: baseName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
@@ -369,12 +369,12 @@ const makeDescribeCmd = (baseName) => ({
                 const rel = await lookupOneRelation(c, pattern);
                 if (rel) {
                     await dispatchDetail(ctx, c, rel, verbose);
-                    return { status: 'ok' };
+                    return { status: "ok" };
                 }
             }
             catch (err) {
                 writeErr(`\\${ctx.cmdName}: ${errMsg(err)}\n`);
-                return { status: 'error', errorWritten: true };
+                return { status: "error", errorWritten: true };
             }
             // Fall through to list (mirrors upstream behaviour: if no exact
             // relation, treat the name as a list pattern).
@@ -382,12 +382,13 @@ const makeDescribeCmd = (baseName) => ({
         // `\d`-family `x` suffix toggles expanded mode for the LIST view
         // only — upstream `command.c` declines to apply it when a pattern is
         // present and would dispatch to per-relation detail rendering.
-        const forceExpanded = ctx.cmdName.slice(baseName.length).includes('x') && pattern === null;
+        const forceExpanded = ctx.cmdName.slice(baseName.length).includes("x") &&
+            pattern === null;
         const savedPopt = ctx.settings.popt;
         if (forceExpanded) {
             ctx.settings.popt = {
                 ...savedPopt,
-                topt: { ...savedPopt.topt, expanded: 'on' },
+                topt: { ...savedPopt.topt, expanded: "on" },
             };
         }
         try {
@@ -403,10 +404,10 @@ const makeDescribeCmd = (baseName) => ({
 const dispatchDetail = async (ctx, c, rel, verbose) => {
     const popt = ctx.settings.popt;
     switch (rel.relkind) {
-        case 'S':
+        case "S":
             await describeOneSequence(c, rel.oid, rel.nspname, rel.relname, process.stdout, popt);
             return;
-        case 'v':
+        case "v":
             await describeOneViewDetails(c, rel.oid, rel.nspname, rel.relname, process.stdout, popt, verbose, ctx.settings.hideCompression);
             return;
         default:
@@ -417,9 +418,9 @@ const runTypedList = async (ctx, c, baseName, pattern, verbose, showSystem) => {
     const serverVersion = c.serverVersion;
     const hideTableam = ctx.settings.hideTableam;
     let query;
-    let tabtypes = '';
+    let tabtypes = "";
     switch (baseName) {
-        case 'd':
+        case "d":
             query = describeTableDetails({
                 pattern: pattern ?? undefined,
                 verbose,
@@ -428,8 +429,8 @@ const runTypedList = async (ctx, c, baseName, pattern, verbose, showSystem) => {
                 hideTableam,
             });
             break;
-        case 'dt':
-            tabtypes = 't';
+        case "dt":
+            tabtypes = "t";
             query = listTables({
                 pattern: pattern ?? undefined,
                 verbose,
@@ -439,8 +440,8 @@ const runTypedList = async (ctx, c, baseName, pattern, verbose, showSystem) => {
                 hideTableam,
             });
             break;
-        case 'di':
-            tabtypes = 'i';
+        case "di":
+            tabtypes = "i";
             query = listTables({
                 pattern: pattern ?? undefined,
                 verbose,
@@ -450,8 +451,8 @@ const runTypedList = async (ctx, c, baseName, pattern, verbose, showSystem) => {
                 hideTableam,
             });
             break;
-        case 'dv':
-            tabtypes = 'v';
+        case "dv":
+            tabtypes = "v";
             query = listTables({
                 pattern: pattern ?? undefined,
                 verbose,
@@ -461,8 +462,8 @@ const runTypedList = async (ctx, c, baseName, pattern, verbose, showSystem) => {
                 hideTableam,
             });
             break;
-        case 'dm':
-            tabtypes = 'm';
+        case "dm":
+            tabtypes = "m";
             query = listTables({
                 pattern: pattern ?? undefined,
                 verbose,
@@ -472,8 +473,8 @@ const runTypedList = async (ctx, c, baseName, pattern, verbose, showSystem) => {
                 hideTableam,
             });
             break;
-        case 'ds':
-            tabtypes = 's';
+        case "ds":
+            tabtypes = "s";
             query = listTables({
                 pattern: pattern ?? undefined,
                 verbose,
@@ -483,8 +484,8 @@ const runTypedList = async (ctx, c, baseName, pattern, verbose, showSystem) => {
                 hideTableam,
             });
             break;
-        case 'dE':
-            tabtypes = 'E';
+        case "dE":
+            tabtypes = "E";
             query = listTables({
                 pattern: pattern ?? undefined,
                 verbose,
@@ -495,25 +496,25 @@ const runTypedList = async (ctx, c, baseName, pattern, verbose, showSystem) => {
             });
             break;
         default:
-            return { status: 'error' };
+            return { status: "error" };
     }
-    const visibility = baseName === 'd'
-        ? 'pg_catalog.pg_table_is_visible(c.oid)'
-        : 'pg_catalog.pg_table_is_visible(c.oid)';
+    const visibility = baseName === "d"
+        ? "pg_catalog.pg_table_is_visible(c.oid)"
+        : "pg_catalog.pg_table_is_visible(c.oid)";
     return runWithPattern(ctx, pattern, query, {
-        namevar: 'c.relname',
-        schemavar: 'n.nspname',
+        namevar: "c.relname",
+        schemavar: "n.nspname",
         visibilityrule: visibility,
     });
 };
 // Register all the relation-list-style commands with all suffix combos.
-const RELATION_BASES = ['d', 'dt', 'di', 'dv', 'dm', 'ds', 'dE'];
+const RELATION_BASES = ["d", "dt", "di", "dv", "dm", "ds", "dE"];
 // Standard suffix matrix. `x` is added separately for the bases that
 // accept the expanded-mode toggle (currently `\d`/`\d+`).
-const SUFFIX_COMBOS = ['', '+', 'S', 'S+', '+S'];
+const SUFFIX_COMBOS = ["", "+", "S", "S+", "+S"];
 // Extended suffix matrix for `\d` only — adds the `x` (expanded) suffix
 // in the same combinations regress exercises.
-const DESCRIBE_X_SUFFIXES = ['x', '+x', 'x+', 'Sx', 'xS', '+Sx', '+xS'];
+const DESCRIBE_X_SUFFIXES = ["x", "+x", "x+", "Sx", "xS", "+Sx", "+xS"];
 // ---- \df / \df+ / \dfS / \dfa / \dfn / \dfp / \dft / \dfw / \dfx -------
 // Upstream's `command.c::exec_command_df` accepts a free-form suffix after
 // `\df`: `+` for verbose, `S` to include system schemas, `x` to force
@@ -523,15 +524,19 @@ const DESCRIBE_X_SUFFIXES = ['x', '+x', 'x+', 'Sx', 'xS', '+Sx', '+xS'];
 const cmdDescribeFunctions = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose, showSystem } = decodeSuffix(cmdName, 'df');
-        let functypes = '';
+        const { verbose, showSystem } = decodeSuffix(cmdName, "df");
+        let functypes = "";
         const tail = cmdName.slice(2);
         for (const ch of tail) {
-            if (ch === 'a' || ch === 'n' || ch === 'p' || ch === 't' || ch === 'w') {
+            if (ch === "a" ||
+                ch === "n" ||
+                ch === "p" ||
+                ch === "t" ||
+                ch === "w") {
                 functypes += ch;
             }
         }
@@ -548,12 +553,12 @@ const cmdDescribeFunctions = (cmdName) => ({
         // applies the toggle whether or not a pattern is present (unlike `\d`,
         // which only toggles when no pattern is given). Override popt locally
         // so we don't leak the change to subsequent commands.
-        const forceExpanded = tail.includes('x');
+        const forceExpanded = tail.includes("x");
         const savedPopt = ctx.settings.popt;
         if (forceExpanded) {
             ctx.settings.popt = {
                 ...savedPopt,
-                topt: { ...savedPopt.topt, expanded: 'on' },
+                topt: { ...savedPopt.topt, expanded: "on" },
             };
         }
         try {
@@ -566,9 +571,9 @@ const cmdDescribeFunctions = (cmdName) => ({
                 serverVersion: c.serverVersion,
             });
             return await runFunctionOrOperatorQuery(ctx, pattern, argPatternResults, query, {
-                namevar: 'p.proname',
-                schemavar: 'n.nspname',
-                visibilityrule: 'pg_catalog.pg_function_is_visible(p.oid)',
+                namevar: "p.proname",
+                schemavar: "n.nspname",
+                visibilityrule: "pg_catalog.pg_function_is_visible(p.oid)",
             });
         }
         finally {
@@ -580,20 +585,20 @@ const cmdDescribeFunctions = (cmdName) => ({
 const cmdDescribeAggregates = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { showSystem } = decodeSuffix(cmdName, 'da');
+        const { showSystem } = decodeSuffix(cmdName, "da");
         const query = describeAggregates({
             pattern: pattern ?? undefined,
             showSystem,
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'p.proname',
-            schemavar: 'n.nspname',
-            visibilityrule: 'pg_catalog.pg_function_is_visible(p.oid)',
+            namevar: "p.proname",
+            schemavar: "n.nspname",
+            visibilityrule: "pg_catalog.pg_function_is_visible(p.oid)",
         });
     },
 });
@@ -606,12 +611,12 @@ const cmdDescribeAggregates = (cmdName) => ({
 const cmdDescribeAccessMethods = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const isAlias = cmdName.startsWith('dAm');
-        const base = isAlias ? 'dAm' : 'dA';
+        const isAlias = cmdName.startsWith("dAm");
+        const base = isAlias ? "dAm" : "dA";
         const { verbose } = decodeSuffix(cmdName, base);
         // `\dAm[+]` always displays the verbose columns; trailing `+` is
         // accepted for syntactic parity but doesn't change output.
@@ -622,15 +627,15 @@ const cmdDescribeAccessMethods = (cmdName) => ({
         });
         // Access methods are global, never schema-qualified; first dot is
         // "too many dotted names".
-        const result = await runWithPattern(ctx, pattern, query, { namevar: 'amname' }, 0);
+        const result = await runWithPattern(ctx, pattern, query, { namevar: "amname" }, 0);
         // Upstream `exec_command_d` drains any args past the first AFTER
         // running the query and writing the result, emitting one warning
         // per leftover token via `pg_log_warning`. Mirror that ordering so
         // `\dA foo bar` prints the (empty) result first, then
         // `\dA: extra argument "bar" ignored` to stderr.
-        for (let extra = ctx.nextArg('normal'); extra !== null;) {
+        for (let extra = ctx.nextArg("normal"); extra !== null;) {
             writeErr(`\\${base}: extra argument "${extra}" ignored\n`);
-            extra = ctx.nextArg('normal');
+            extra = ctx.nextArg("normal");
         }
         return result;
     },
@@ -643,12 +648,12 @@ const cmdDescribeAccessMethods = (cmdName) => ({
 const cmdListOperatorClasses = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const amPat = ctx.nextArg('normal');
-        const typePat = amPat ? ctx.nextArg('normal') : null;
+        const amPat = ctx.nextArg("normal");
+        const typePat = amPat ? ctx.nextArg("normal") : null;
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(cmdName, 'dAc');
+        const { verbose } = decodeSuffix(cmdName, "dAc");
         const query = listOperatorClasses({
             amPattern: amPat ?? undefined,
             typePattern: typePat ?? undefined,
@@ -659,28 +664,28 @@ const cmdListOperatorClasses = (cmdName) => ({
         const curDb = currentDb(c);
         if (amPat !== null) {
             const r = processSQLNamePattern({
-                namevar: 'am.amname',
+                namevar: "am.amname",
                 pattern: amPat,
             });
             // Access method names are flat — first dot is "too many".
             const err = validatePattern(amPat, r, 0, curDb);
             if (err !== null) {
                 writeErr(`${err}\n`);
-                return { status: 'error', errorWritten: true };
+                return { status: "error", errorWritten: true };
             }
             results.push(r);
         }
         if (typePat !== null) {
             const r = processSQLNamePattern({
-                namevar: 't.typname',
-                schemavar: 'tn.nspname',
+                namevar: "t.typname",
+                schemavar: "tn.nspname",
                 pattern: typePat,
             });
             // Type pattern accepts db.schema.name; cross-db check on 2-dot.
             const err = validatePattern(typePat, r, 2, curDb);
             if (err !== null) {
                 writeErr(`${err}\n`);
-                return { status: 'error', errorWritten: true };
+                return { status: "error", errorWritten: true };
             }
             results.push(r);
         }
@@ -694,12 +699,12 @@ const cmdListOperatorClasses = (cmdName) => ({
 const cmdListOperatorFamilies = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const amPat = ctx.nextArg('normal');
-        const typePat = amPat ? ctx.nextArg('normal') : null;
+        const amPat = ctx.nextArg("normal");
+        const typePat = amPat ? ctx.nextArg("normal") : null;
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(cmdName, 'dAf');
+        const { verbose } = decodeSuffix(cmdName, "dAf");
         const query = listOperatorFamilies({
             amPattern: amPat ?? undefined,
             typePattern: typePat ?? undefined,
@@ -710,26 +715,26 @@ const cmdListOperatorFamilies = (cmdName) => ({
         const curDb = currentDb(c);
         if (amPat !== null) {
             const r = processSQLNamePattern({
-                namevar: 'am.amname',
+                namevar: "am.amname",
                 pattern: amPat,
             });
             const err = validatePattern(amPat, r, 0, curDb);
             if (err !== null) {
                 writeErr(`${err}\n`);
-                return { status: 'error', errorWritten: true };
+                return { status: "error", errorWritten: true };
             }
             results.push(r);
         }
         if (typePat !== null) {
             const r = processSQLNamePattern({
-                namevar: 't.typname',
-                schemavar: 'tn.nspname',
+                namevar: "t.typname",
+                schemavar: "tn.nspname",
                 pattern: typePat,
             });
             const err = validatePattern(typePat, r, 2, curDb);
             if (err !== null) {
                 writeErr(`${err}\n`);
-                return { status: 'error', errorWritten: true };
+                return { status: "error", errorWritten: true };
             }
             results.push(r);
         }
@@ -742,12 +747,12 @@ const cmdListOperatorFamilies = (cmdName) => ({
 const cmdListOpFamilyOperators = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const amPat = ctx.nextArg('normal');
-        const familyPat = amPat ? ctx.nextArg('normal') : null;
+        const amPat = ctx.nextArg("normal");
+        const familyPat = amPat ? ctx.nextArg("normal") : null;
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(cmdName, 'dAo');
+        const { verbose } = decodeSuffix(cmdName, "dAo");
         const query = listOpFamilyOperators({
             amPattern: amPat ?? undefined,
             familyPattern: familyPat ?? undefined,
@@ -758,26 +763,26 @@ const cmdListOpFamilyOperators = (cmdName) => ({
         const curDb = currentDb(c);
         if (amPat !== null) {
             const r = processSQLNamePattern({
-                namevar: 'am.amname',
+                namevar: "am.amname",
                 pattern: amPat,
             });
             const err = validatePattern(amPat, r, 0, curDb);
             if (err !== null) {
                 writeErr(`${err}\n`);
-                return { status: 'error', errorWritten: true };
+                return { status: "error", errorWritten: true };
             }
             results.push(r);
         }
         if (familyPat !== null) {
             const r = processSQLNamePattern({
-                namevar: 'of.opfname',
-                schemavar: 'nsf.nspname',
+                namevar: "of.opfname",
+                schemavar: "nsf.nspname",
                 pattern: familyPat,
             });
             const err = validatePattern(familyPat, r, 2, curDb);
             if (err !== null) {
                 writeErr(`${err}\n`);
-                return { status: 'error', errorWritten: true };
+                return { status: "error", errorWritten: true };
             }
             results.push(r);
         }
@@ -790,19 +795,19 @@ const cmdListOpFamilyOperators = (cmdName) => ({
 const cmdListOpFamilyFunctions = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const amPat = ctx.nextArg('normal');
-        const familyPat = amPat ? ctx.nextArg('normal') : null;
+        const amPat = ctx.nextArg("normal");
+        const familyPat = amPat ? ctx.nextArg("normal") : null;
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(cmdName, 'dAp');
+        const { verbose } = decodeSuffix(cmdName, "dAp");
         // `\dApx[+]` — expanded toggle, same convention as `\df`/`\z`.
-        const forceExpanded = cmdName.slice(3).includes('x');
+        const forceExpanded = cmdName.slice(3).includes("x");
         const savedPopt = ctx.settings.popt;
         if (forceExpanded) {
             ctx.settings.popt = {
                 ...savedPopt,
-                topt: { ...savedPopt.topt, expanded: 'on' },
+                topt: { ...savedPopt.topt, expanded: "on" },
             };
         }
         try {
@@ -816,26 +821,26 @@ const cmdListOpFamilyFunctions = (cmdName) => ({
             const curDb = currentDb(c);
             if (amPat !== null) {
                 const r = processSQLNamePattern({
-                    namevar: 'am.amname',
+                    namevar: "am.amname",
                     pattern: amPat,
                 });
                 const err = validatePattern(amPat, r, 0, curDb);
                 if (err !== null) {
                     writeErr(`${err}\n`);
-                    return { status: 'error', errorWritten: true };
+                    return { status: "error", errorWritten: true };
                 }
                 results.push(r);
             }
             if (familyPat !== null) {
                 const r = processSQLNamePattern({
-                    namevar: 'of.opfname',
-                    schemavar: 'ns.nspname',
+                    namevar: "of.opfname",
+                    schemavar: "ns.nspname",
                     pattern: familyPat,
                 });
                 const err = validatePattern(familyPat, r, 2, curDb);
                 if (err !== null) {
                     writeErr(`${err}\n`);
-                    return { status: 'error', errorWritten: true };
+                    return { status: "error", errorWritten: true };
                 }
                 results.push(r);
             }
@@ -850,11 +855,11 @@ const cmdListOpFamilyFunctions = (cmdName) => ({
 const cmdDescribeTypes = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose, showSystem } = decodeSuffix(cmdName, 'dT');
+        const { verbose, showSystem } = decodeSuffix(cmdName, "dT");
         const query = describeTypes({
             pattern: pattern ?? undefined,
             verbose,
@@ -862,9 +867,9 @@ const cmdDescribeTypes = (cmdName) => ({
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 't.typname',
-            schemavar: 'n.nspname',
-            visibilityrule: 'pg_catalog.pg_type_is_visible(t.oid)',
+            namevar: "t.typname",
+            schemavar: "n.nspname",
+            visibilityrule: "pg_catalog.pg_type_is_visible(t.oid)",
         });
     },
 });
@@ -872,11 +877,11 @@ const cmdDescribeTypes = (cmdName) => ({
 const cmdDescribeOperators = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose, showSystem } = decodeSuffix(cmdName, 'do');
+        const { verbose, showSystem } = decodeSuffix(cmdName, "do");
         // Upstream: same arg-collection rule as `\df` (only when main
         // pattern is non-null). describeOperators caps at 2 args; we still
         // forward the user's input so the SQL builder can decide which
@@ -896,9 +901,9 @@ const cmdDescribeOperators = (cmdName) => ({
             serverVersion: c.serverVersion,
         });
         return runFunctionOrOperatorQuery(ctx, pattern, argPatternResults, query, {
-            namevar: 'o.oprname',
-            schemavar: 'n.nspname',
-            visibilityrule: 'pg_catalog.pg_operator_is_visible(o.oid)',
+            namevar: "o.oprname",
+            schemavar: "n.nspname",
+            visibilityrule: "pg_catalog.pg_operator_is_visible(o.oid)",
         });
     },
 });
@@ -906,11 +911,11 @@ const cmdDescribeOperators = (cmdName) => ({
 const cmdDescribeRoles = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const base = cmdName.startsWith('du') ? 'du' : 'dg';
+        const base = cmdName.startsWith("du") ? "du" : "dg";
         const { verbose, showSystem } = decodeSuffix(cmdName, base);
         const query = describeRoles({
             pattern: pattern ?? undefined,
@@ -922,7 +927,7 @@ const cmdDescribeRoles = (cmdName) => ({
         // `printQuery` with `default_footer = false` (describe.c
         // `describeRoles`), so suppress the `(N rows)` counter for both
         // populated and empty results to match `psql -E \du`.
-        return runWithPattern(ctx, pattern, query, { namevar: 'r.rolname' }, 0, {
+        return runWithPattern(ctx, pattern, query, { namevar: "r.rolname" }, 0, {
             suppressDefaultFooter: true,
         });
     },
@@ -934,10 +939,10 @@ const cmdDescribeRoles = (cmdName) => ({
 // stderr notice ("Did not find any settings…") when not in quiet mode,
 // mirroring upstream `describe.c::listDbRoleSettings`.
 const cmdListDbRoleSettings = {
-    name: 'drds',
+    name: "drds",
     run: async (ctx) => {
-        const rolePat = ctx.nextArg('normal');
-        const dbPat = rolePat ? ctx.nextArg('normal') : null;
+        const rolePat = ctx.nextArg("normal");
+        const dbPat = rolePat ? ctx.nextArg("normal") : null;
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
@@ -950,27 +955,27 @@ const cmdListDbRoleSettings = {
         const curDb = currentDb(c);
         if (rolePat !== null) {
             const r = processSQLNamePattern({
-                namevar: 'r.rolname',
+                namevar: "r.rolname",
                 pattern: rolePat,
             });
             // Role names are flat — first dot is "too many".
             const err = validatePattern(rolePat, r, 0, curDb);
             if (err !== null) {
                 writeErr(`${err}\n`);
-                return { status: 'error', errorWritten: true };
+                return { status: "error", errorWritten: true };
             }
             results.push(r);
         }
         if (dbPat !== null) {
             const r = processSQLNamePattern({
-                namevar: 'd.datname',
+                namevar: "d.datname",
                 pattern: dbPat,
             });
             // Database names are top-level — first dot is "too many".
             const err = validatePattern(dbPat, r, 0, curDb);
             if (err !== null) {
                 writeErr(`${err}\n`);
-                return { status: 'error', errorWritten: true };
+                return { status: "error", errorWritten: true };
             }
             results.push(r);
         }
@@ -996,7 +1001,7 @@ const cmdListDbRoleSettings = {
                 else if (rolePat !== null) {
                     writeErr(`Did not find any settings for role "${rolePat}".\n`);
                 }
-                return { status: 'ok' };
+                return { status: "ok" };
             }
             // Re-print via the standard runner so the title and formatting
             // match peer list queries. We pass the already-substituted SQL
@@ -1012,11 +1017,11 @@ const cmdListDbRoleSettings = {
                 dbLiteral: null,
             };
             await runListQuery(c, finalQuery, empty, process.stdout, ctx.settings.popt);
-            return { status: 'ok' };
+            return { status: "ok" };
         }
         catch (err) {
             writeErr(`\\${ctx.cmdName}: ${errMsg(err)}\n`);
-            return { status: 'error', errorWritten: true };
+            return { status: "error", errorWritten: true };
         }
     },
 };
@@ -1024,11 +1029,11 @@ const cmdListDbRoleSettings = {
 const cmdListSchemas = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose, showSystem } = decodeSuffix(cmdName, 'dn');
+        const { verbose, showSystem } = decodeSuffix(cmdName, "dn");
         const query = listSchemas({
             pattern: pattern ?? undefined,
             verbose,
@@ -1038,7 +1043,7 @@ const cmdListSchemas = (cmdName) => ({
         // Schemas live in a single namespace; the optional qualifier slot
         // is interpreted as a database name (cross-database check fires on
         // mismatch). `maxDots = 1`.
-        return runWithPattern(ctx, pattern, query, { namevar: 'n.nspname' }, 1);
+        return runWithPattern(ctx, pattern, query, { namevar: "n.nspname" }, 1);
     },
 });
 // ---- \db / \db+ ---------------------------------------------------------
@@ -1047,29 +1052,29 @@ const cmdListSchemas = (cmdName) => ({
 const cmdDescribeTablespaces = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(cmdName, 'db');
+        const { verbose } = decodeSuffix(cmdName, "db");
         const query = describeTablespaces({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
         // Tablespaces are flat — first dot is "too many".
-        return runWithPattern(ctx, pattern, query, { namevar: 'spcname' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "spcname" }, 0);
     },
 });
 // ---- \dD / \dDS / \dD+ -------------------------------------------------
 const cmdListDomains = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose, showSystem } = decodeSuffix(cmdName, 'dD');
+        const { verbose, showSystem } = decodeSuffix(cmdName, "dD");
         const query = listDomains({
             pattern: pattern ?? undefined,
             verbose,
@@ -1077,9 +1082,9 @@ const cmdListDomains = (cmdName) => ({
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 't.typname',
-            schemavar: 'n.nspname',
-            visibilityrule: 'pg_catalog.pg_type_is_visible(t.oid)',
+            namevar: "t.typname",
+            schemavar: "n.nspname",
+            visibilityrule: "pg_catalog.pg_type_is_visible(t.oid)",
         });
     },
 });
@@ -1087,11 +1092,11 @@ const cmdListDomains = (cmdName) => ({
 const cmdListConversions = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose, showSystem } = decodeSuffix(cmdName, 'dc');
+        const { verbose, showSystem } = decodeSuffix(cmdName, "dc");
         const query = listConversions({
             pattern: pattern ?? undefined,
             verbose,
@@ -1099,9 +1104,9 @@ const cmdListConversions = (cmdName) => ({
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'c.conname',
-            schemavar: 'n.nspname',
-            visibilityrule: 'pg_catalog.pg_conversion_is_visible(c.oid)',
+            namevar: "c.conname",
+            schemavar: "n.nspname",
+            visibilityrule: "pg_catalog.pg_conversion_is_visible(c.oid)",
         });
     },
 });
@@ -1109,19 +1114,19 @@ const cmdListConversions = (cmdName) => ({
 const cmdListCasts = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(cmdName, 'dC');
+        const { verbose } = decodeSuffix(cmdName, "dC");
         const query = listCasts({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'ts.typname',
-            schemavar: 'ns.nspname',
+            namevar: "ts.typname",
+            schemavar: "ns.nspname",
         });
     },
 });
@@ -1129,11 +1134,11 @@ const cmdListCasts = (cmdName) => ({
 const cmdListLanguages = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose, showSystem } = decodeSuffix(cmdName, 'dL');
+        const { verbose, showSystem } = decodeSuffix(cmdName, "dL");
         const query = listLanguages({
             pattern: pattern ?? undefined,
             verbose,
@@ -1141,18 +1146,18 @@ const cmdListLanguages = (cmdName) => ({
             serverVersion: c.serverVersion,
         });
         // Languages are global; first dot is a database qualifier (cross-db).
-        return runWithPattern(ctx, pattern, query, { namevar: 'l.lanname' }, 1);
+        return runWithPattern(ctx, pattern, query, { namevar: "l.lanname" }, 1);
     },
 });
 // ---- \dO / \dO+ / \dOS -------------------------------------------------
 const cmdListCollations = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose, showSystem } = decodeSuffix(cmdName, 'dO');
+        const { verbose, showSystem } = decodeSuffix(cmdName, "dO");
         const query = listCollations({
             pattern: pattern ?? undefined,
             verbose,
@@ -1160,9 +1165,9 @@ const cmdListCollations = (cmdName) => ({
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'c.collname',
-            schemavar: 'n.nspname',
-            visibilityrule: 'pg_catalog.pg_collation_is_visible(c.oid)',
+            namevar: "c.collname",
+            schemavar: "n.nspname",
+            visibilityrule: "pg_catalog.pg_collation_is_visible(c.oid)",
         });
     },
 });
@@ -1170,20 +1175,20 @@ const cmdListCollations = (cmdName) => ({
 const cmdPermissionsList = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const base = cmdName.startsWith('z') ? 'z' : 'dp';
+        const base = cmdName.startsWith("z") ? "z" : "dp";
         const { showSystem } = decodeSuffix(cmdName, base);
         // `\z[x]`, `\dp[x]` — same expanded-mode toggle convention as `\df`,
         // applied whether or not a pattern is present.
-        const forceExpanded = cmdName.slice(base.length).includes('x');
+        const forceExpanded = cmdName.slice(base.length).includes("x");
         const savedPopt = ctx.settings.popt;
         if (forceExpanded) {
             ctx.settings.popt = {
                 ...savedPopt,
-                topt: { ...savedPopt.topt, expanded: 'on' },
+                topt: { ...savedPopt.topt, expanded: "on" },
             };
         }
         try {
@@ -1193,9 +1198,9 @@ const cmdPermissionsList = (cmdName) => ({
                 serverVersion: c.serverVersion,
             });
             return await runWithPattern(ctx, pattern, query, {
-                namevar: 'c.relname',
-                schemavar: 'n.nspname',
-                visibilityrule: 'pg_catalog.pg_table_is_visible(c.oid)',
+                namevar: "c.relname",
+                schemavar: "n.nspname",
+                visibilityrule: "pg_catalog.pg_table_is_visible(c.oid)",
             });
         }
         finally {
@@ -1205,9 +1210,9 @@ const cmdPermissionsList = (cmdName) => ({
 });
 // ---- \ddp --------------------------------------------------------------
 const cmdListDefaultACLs = {
-    name: 'ddp',
+    name: "ddp",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
@@ -1216,76 +1221,76 @@ const cmdListDefaultACLs = {
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'pg_catalog.pg_get_userbyid(d.defaclrole)',
-            schemavar: 'n.nspname',
+            namevar: "pg_catalog.pg_get_userbyid(d.defaclrole)",
+            schemavar: "n.nspname",
         });
     },
 };
 // ---- \dd ---------------------------------------------------------------
 const cmdObjectDescription = {
-    name: 'dd',
+    name: "dd",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { showSystem } = decodeSuffix(ctx.cmdName, 'dd');
+        const { showSystem } = decodeSuffix(ctx.cmdName, "dd");
         const query = objectDescription({
             pattern: pattern ?? undefined,
             showSystem,
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'tt.name',
-            schemavar: 'tt.nspname',
+            namevar: "tt.name",
+            schemavar: "tt.nspname",
         });
     },
 };
 // ---- \l / \list -------------------------------------------------------
 const cmdListAllDbs = {
-    name: 'l',
-    aliases: ['list'],
+    name: "l",
+    aliases: ["list"],
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'l');
+        const { verbose } = decodeSuffix(ctx.cmdName, "l");
         const query = listAllDbs({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
-        return runWithPattern(ctx, pattern, query, { namevar: 'd.datname' });
+        return runWithPattern(ctx, pattern, query, { namevar: "d.datname" });
     },
 };
 // ---- \dconfig ----------------------------------------------------------
 const cmdDescribeConfigParams = {
-    name: 'dconfig',
+    name: "dconfig",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dconfig');
+        const { verbose } = decodeSuffix(ctx.cmdName, "dconfig");
         const query = describeConfigurationParameters({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
         // GUC names are flat — any dot is "too many".
-        return runWithPattern(ctx, pattern, query, { namevar: 'pg_catalog.lower(s.name)' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "pg_catalog.lower(s.name)" }, 0);
     },
 };
 // ---- \dy ---------------------------------------------------------------
 const cmdListEventTriggers = {
-    name: 'dy',
+    name: "dy",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dy');
+        const { verbose } = decodeSuffix(ctx.cmdName, "dy");
         const query = listEventTriggers({
             pattern: pattern ?? undefined,
             verbose,
@@ -1294,14 +1299,14 @@ const cmdListEventTriggers = {
         // Event triggers are global with no schema or database qualifier
         // (upstream `validateSQLNamePattern(..., NULL, 1)`): any dot in
         // the pattern is "too many".
-        return runWithPattern(ctx, pattern, query, { namevar: 'evtname' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "evtname" }, 0);
     },
 };
 // ---- \dx / \dx+ -------------------------------------------------------
 const cmdListExtensions = {
-    name: 'dx',
+    name: "dx",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
@@ -1312,111 +1317,111 @@ const cmdListExtensions = {
         // Extensions are global with no schema or database qualifier
         // (upstream `validateSQLNamePattern(..., NULL, 1)`): any dot is
         // "too many".
-        return runWithPattern(ctx, pattern, query, { namevar: 'e.extname' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "e.extname" }, 0);
     },
 };
 // ---- \dl / \lo_list ---------------------------------------------------
 const cmdListLargeObjects = {
-    name: 'dl',
-    aliases: ['lo_list'],
+    name: "dl",
+    aliases: ["lo_list"],
     run: async (ctx) => {
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dl');
+        const { verbose } = decodeSuffix(ctx.cmdName, "dl");
         const query = listLargeObjects({
             verbose,
             serverVersion: c.serverVersion,
         });
-        return runWithPattern(ctx, null, query, { namevar: 'oid' });
+        return runWithPattern(ctx, null, query, { namevar: "oid" });
     },
 };
 // ---- \dF / \dFp / \dFd / \dFt ----------------------------------------
 const cmdListTSConfigs = {
-    name: 'dF',
+    name: "dF",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dF');
+        const { verbose } = decodeSuffix(ctx.cmdName, "dF");
         const query = listTSConfigs({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'c.cfgname',
-            schemavar: 'n.nspname',
+            namevar: "c.cfgname",
+            schemavar: "n.nspname",
         });
     },
 };
 const cmdListTSParsers = {
-    name: 'dFp',
+    name: "dFp",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dFp');
+        const { verbose } = decodeSuffix(ctx.cmdName, "dFp");
         const query = listTSParsers({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'p.prsname',
-            schemavar: 'n.nspname',
+            namevar: "p.prsname",
+            schemavar: "n.nspname",
         });
     },
 };
 const cmdListTSDictionaries = {
-    name: 'dFd',
+    name: "dFd",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dFd');
+        const { verbose } = decodeSuffix(ctx.cmdName, "dFd");
         const query = listTSDictionaries({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'd.dictname',
-            schemavar: 'n.nspname',
+            namevar: "d.dictname",
+            schemavar: "n.nspname",
         });
     },
 };
 const cmdListTSTemplates = {
-    name: 'dFt',
+    name: "dFt",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dFt');
+        const { verbose } = decodeSuffix(ctx.cmdName, "dFt");
         const query = listTSTemplates({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 't.tmplname',
-            schemavar: 'n.nspname',
+            namevar: "t.tmplname",
+            schemavar: "n.nspname",
         });
     },
 };
 // ---- \dew / \des / \deu / \det ---------------------------------------
 const cmdListForeignDataWrappers = {
-    name: 'dew',
+    name: "dew",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dew');
+        const { verbose } = decodeSuffix(ctx.cmdName, "dew");
         const query = listForeignDataWrappers({
             pattern: pattern ?? undefined,
             verbose,
@@ -1424,17 +1429,17 @@ const cmdListForeignDataWrappers = {
         });
         // FDWs are global with no schema or database qualifier (upstream
         // `validateSQLNamePattern(..., NULL, 1)`): any dot is "too many".
-        return runWithPattern(ctx, pattern, query, { namevar: 'fdwname' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "fdwname" }, 0);
     },
 };
 const cmdListForeignServers = {
-    name: 'des',
+    name: "des",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'des');
+        const { verbose } = decodeSuffix(ctx.cmdName, "des");
         const query = listForeignServers({
             pattern: pattern ?? undefined,
             verbose,
@@ -1443,17 +1448,17 @@ const cmdListForeignServers = {
         // Foreign servers are global with no schema or database qualifier
         // (upstream `validateSQLNamePattern(..., NULL, 1)`): any dot is
         // "too many".
-        return runWithPattern(ctx, pattern, query, { namevar: 's.srvname' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "s.srvname" }, 0);
     },
 };
 const cmdListUserMappings = {
-    name: 'deu',
+    name: "deu",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'deu');
+        const { verbose } = decodeSuffix(ctx.cmdName, "deu");
         const query = listUserMappings({
             pattern: pattern ?? undefined,
             verbose,
@@ -1461,44 +1466,44 @@ const cmdListUserMappings = {
         });
         // User mappings live alongside foreign servers (global, no schema
         // or db qualifier per upstream `validateSQLNamePattern(..., 1)`).
-        return runWithPattern(ctx, pattern, query, { namevar: 'um.srvname' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "um.srvname" }, 0);
     },
 };
 const cmdListForeignTables = {
-    name: 'det',
+    name: "det",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'det');
+        const { verbose } = decodeSuffix(ctx.cmdName, "det");
         const query = listForeignTables({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'c.relname',
-            schemavar: 'n.nspname',
+            namevar: "c.relname",
+            schemavar: "n.nspname",
         });
     },
 };
 // ---- \dP / \dPi / \dPt / \dPn -----------------------------------------
 const cmdListPartitionedTables = {
-    name: 'dP',
+    name: "dP",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dP');
-        let reltypes = '';
-        if (ctx.cmdName.includes('i'))
-            reltypes += 'i';
-        if (ctx.cmdName.includes('t'))
-            reltypes += 't';
-        if (ctx.cmdName.includes('n'))
-            reltypes += 'n';
+        const { verbose } = decodeSuffix(ctx.cmdName, "dP");
+        let reltypes = "";
+        if (ctx.cmdName.includes("i"))
+            reltypes += "i";
+        if (ctx.cmdName.includes("t"))
+            reltypes += "t";
+        if (ctx.cmdName.includes("n"))
+            reltypes += "n";
         const query = listPartitionedTables({
             pattern: pattern ?? undefined,
             verbose,
@@ -1506,8 +1511,8 @@ const cmdListPartitionedTables = {
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'c.relname',
-            schemavar: 'n.nspname',
+            namevar: "c.relname",
+            schemavar: "n.nspname",
         });
     },
 };
@@ -1518,19 +1523,19 @@ const cmdListPartitionedTables = {
 const cmdListExtendedStats = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(cmdName, 'dX');
+        const { verbose } = decodeSuffix(cmdName, "dX");
         const query = listExtendedStats({
             pattern: pattern ?? undefined,
             verbose,
             serverVersion: c.serverVersion,
         });
         return runWithPattern(ctx, pattern, query, {
-            namevar: 'es.stxname',
-            schemavar: 'es.stxnamespace::pg_catalog.regnamespace::pg_catalog.text',
+            namevar: "es.stxname",
+            schemavar: "es.stxnamespace::pg_catalog.regnamespace::pg_catalog.text",
         });
     },
 });
@@ -1542,24 +1547,24 @@ const cmdListExtendedStats = (cmdName) => ({
 const cmdDescribeRoleGrants = (cmdName) => ({
     name: cmdName,
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { showSystem } = decodeSuffix(cmdName, 'drg');
+        const { showSystem } = decodeSuffix(cmdName, "drg");
         const query = describeRoleGrants({
             pattern: pattern ?? undefined,
             showSystem,
             serverVersion: c.serverVersion,
         });
-        return runWithPattern(ctx, pattern, query, { namevar: 'm.rolname' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "m.rolname" }, 0);
     },
 });
 // ---- \dRp / \dRs ------------------------------------------------------
 const cmdListPublications = {
-    name: 'dRp',
+    name: "dRp",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
@@ -1570,17 +1575,17 @@ const cmdListPublications = {
         // Publications are global with no schema or database qualifier
         // (upstream `validateSQLNamePattern(..., NULL, 1)`): any dot is
         // "too many".
-        return runWithPattern(ctx, pattern, query, { namevar: 'pubname' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "pubname" }, 0);
     },
 };
 const cmdDescribeSubscriptions = {
-    name: 'dRs',
+    name: "dRs",
     run: async (ctx) => {
-        const pattern = ctx.nextArg('normal');
+        const pattern = ctx.nextArg("normal");
         const c = conn(ctx);
         if (!c)
             return noConn(ctx);
-        const { verbose } = decodeSuffix(ctx.cmdName, 'dRs');
+        const { verbose } = decodeSuffix(ctx.cmdName, "dRs");
         const query = describeSubscriptions({
             pattern: pattern ?? undefined,
             verbose,
@@ -1589,7 +1594,7 @@ const cmdDescribeSubscriptions = {
         // Subscriptions are global with no schema or database qualifier
         // (upstream `validateSQLNamePattern(..., NULL, 1)`): any dot is
         // "too many".
-        return runWithPattern(ctx, pattern, query, { namevar: 'subname' }, 0);
+        return runWithPattern(ctx, pattern, query, { namevar: "subname" }, 0);
     },
 };
 // ===========================================================================
@@ -1618,7 +1623,7 @@ export const registerDescribeCommands = (registry) => {
     // register only for the bare `\d` base — upstream only honours it for
     // `\d` itself, not for typed variants like `\dt` or `\dv`.
     for (const suffix of DESCRIBE_X_SUFFIXES) {
-        registry.register({ ...makeDescribeCmd('d'), name: 'd' + suffix });
+        registry.register({ ...makeDescribeCmd("d"), name: "d" + suffix });
     }
     // Functions. Beyond the standard `\df[+S]` matrix, upstream accepts
     // function-kind filter letters (a / n / p / t / w) and an expanded-mode
@@ -1627,107 +1632,107 @@ export const registerDescribeCommands = (registry) => {
     // letter sequences (`\dfax+`, `\dfxw`, …) are handled by the runtime
     // suffix walk in `cmdDescribeFunctions`.
     const dfTails = [
-        '',
-        '+',
-        'S',
-        'S+',
-        '+S',
-        'a',
-        'n',
-        'p',
-        't',
-        'w',
-        'x',
-        'ax',
-        'nx',
-        'px',
-        'tx',
-        'wx',
-        'xa',
-        'xn',
-        'xp',
-        'xt',
-        'xw',
-        'a+',
-        'n+',
-        'p+',
-        't+',
-        'w+',
-        'x+',
-        'a+x',
-        'x+a',
+        "",
+        "+",
+        "S",
+        "S+",
+        "+S",
+        "a",
+        "n",
+        "p",
+        "t",
+        "w",
+        "x",
+        "ax",
+        "nx",
+        "px",
+        "tx",
+        "wx",
+        "xa",
+        "xn",
+        "xp",
+        "xt",
+        "xw",
+        "a+",
+        "n+",
+        "p+",
+        "t+",
+        "w+",
+        "x+",
+        "a+x",
+        "x+a",
     ];
     for (const tail of dfTails) {
-        registry.register(cmdDescribeFunctions('df' + tail));
+        registry.register(cmdDescribeFunctions("df" + tail));
     }
     // Aggregates.
-    for (const suffix of ['', 'S']) {
-        registry.register(cmdDescribeAggregates('da' + suffix));
+    for (const suffix of ["", "S"]) {
+        registry.register(cmdDescribeAggregates("da" + suffix));
     }
     // Access methods. `\dA[+]` is upstream; `\dAm[+]` is a Neon-friendly
     // alias that some docs reach for. `\dAc[+]`, `\dAf[+]`, `\dAo[+]`,
     // `\dAp[+]` cover the operator-class / family / family-operator /
     // family-function families upstream's `command.c::exec_command_d`
     // dispatches.
-    for (const suffix of ['', '+']) {
-        registry.register(cmdDescribeAccessMethods('dA' + suffix));
-        registry.register(cmdDescribeAccessMethods('dAm' + suffix));
-        registry.register(cmdListOperatorClasses('dAc' + suffix));
-        registry.register(cmdListOperatorFamilies('dAf' + suffix));
-        registry.register(cmdListOpFamilyOperators('dAo' + suffix));
-        registry.register(cmdListOpFamilyFunctions('dAp' + suffix));
+    for (const suffix of ["", "+"]) {
+        registry.register(cmdDescribeAccessMethods("dA" + suffix));
+        registry.register(cmdDescribeAccessMethods("dAm" + suffix));
+        registry.register(cmdListOperatorClasses("dAc" + suffix));
+        registry.register(cmdListOperatorFamilies("dAf" + suffix));
+        registry.register(cmdListOpFamilyOperators("dAo" + suffix));
+        registry.register(cmdListOpFamilyFunctions("dAp" + suffix));
     }
     // `x` (expanded) variants of the two-pattern access-method families.
-    for (const tail of ['x', 'x+', '+x', 'xS', 'Sx']) {
-        registry.register(cmdListOpFamilyFunctions('dAp' + tail));
+    for (const tail of ["x", "x+", "+x", "xS", "Sx"]) {
+        registry.register(cmdListOpFamilyFunctions("dAp" + tail));
     }
     // Types.
     for (const suffix of SUFFIX_COMBOS) {
-        registry.register(cmdDescribeTypes('dT' + suffix));
+        registry.register(cmdDescribeTypes("dT" + suffix));
     }
     // Operators.
     for (const suffix of SUFFIX_COMBOS) {
-        registry.register(cmdDescribeOperators('do' + suffix));
+        registry.register(cmdDescribeOperators("do" + suffix));
     }
     // Roles.
-    for (const suffix of ['', '+', 'S', 'S+', '+S']) {
-        registry.register(cmdDescribeRoles('du' + suffix));
-        registry.register(cmdDescribeRoles('dg' + suffix));
+    for (const suffix of ["", "+", "S", "S+", "+S"]) {
+        registry.register(cmdDescribeRoles("du" + suffix));
+        registry.register(cmdDescribeRoles("dg" + suffix));
     }
     // Schemas.
     for (const suffix of SUFFIX_COMBOS) {
-        registry.register(cmdListSchemas('dn' + suffix));
+        registry.register(cmdListSchemas("dn" + suffix));
     }
     // Domains.
     for (const suffix of SUFFIX_COMBOS) {
-        registry.register(cmdListDomains('dD' + suffix));
+        registry.register(cmdListDomains("dD" + suffix));
     }
     // Conversions.
     for (const suffix of SUFFIX_COMBOS) {
-        registry.register(cmdListConversions('dc' + suffix));
+        registry.register(cmdListConversions("dc" + suffix));
     }
     // Casts.
-    for (const suffix of ['', '+']) {
-        registry.register(cmdListCasts('dC' + suffix));
+    for (const suffix of ["", "+"]) {
+        registry.register(cmdListCasts("dC" + suffix));
     }
     // Tablespaces.
-    for (const suffix of ['', '+']) {
-        registry.register(cmdDescribeTablespaces('db' + suffix));
+    for (const suffix of ["", "+"]) {
+        registry.register(cmdDescribeTablespaces("db" + suffix));
     }
     // Languages.
     for (const suffix of SUFFIX_COMBOS) {
-        registry.register(cmdListLanguages('dL' + suffix));
+        registry.register(cmdListLanguages("dL" + suffix));
     }
     // Collations.
     for (const suffix of SUFFIX_COMBOS) {
-        registry.register(cmdListCollations('dO' + suffix));
+        registry.register(cmdListCollations("dO" + suffix));
     }
     // Permissions / default ACLs. `\dp` and `\z` are independent base names
     // (aliasing them via `aliases` couldn't carry separate `x`-suffix
     // variants), so register each with its own suffix matrix.
-    for (const tail of ['', 'S', 'x', 'Sx', 'xS']) {
-        registry.register(cmdPermissionsList('dp' + tail));
-        registry.register(cmdPermissionsList('z' + tail));
+    for (const tail of ["", "S", "x", "Sx", "xS"]) {
+        registry.register(cmdPermissionsList("dp" + tail));
+        registry.register(cmdPermissionsList("z" + tail));
     }
     registry.register(cmdListDefaultACLs);
     // Descriptions.
@@ -1737,34 +1742,34 @@ export const registerDescribeCommands = (registry) => {
     // registration or it dispatches to nothing. `decodeSuffix`
     // reads the verbose flag back off `ctx.cmdName` at runtime.
     registry.register(cmdListAllDbs);
-    registry.register({ ...cmdListAllDbs, name: 'l+', aliases: ['list+'] });
+    registry.register({ ...cmdListAllDbs, name: "l+", aliases: ["list+"] });
     // Config / event triggers / extensions / large objects.
     registry.register(cmdDescribeConfigParams);
-    registry.register({ ...cmdDescribeConfigParams, name: 'dconfig+' });
+    registry.register({ ...cmdDescribeConfigParams, name: "dconfig+" });
     registry.register(cmdListEventTriggers);
     registry.register(cmdListExtensions);
-    registry.register({ ...cmdListExtensions, name: 'dx+' });
+    registry.register({ ...cmdListExtensions, name: "dx+" });
     registry.register(cmdListLargeObjects);
     // Text search family.
     registry.register(cmdListTSConfigs);
-    registry.register({ ...cmdListTSConfigs, name: 'dF+' });
+    registry.register({ ...cmdListTSConfigs, name: "dF+" });
     registry.register(cmdListTSParsers);
-    registry.register({ ...cmdListTSParsers, name: 'dFp+' });
+    registry.register({ ...cmdListTSParsers, name: "dFp+" });
     registry.register(cmdListTSDictionaries);
-    registry.register({ ...cmdListTSDictionaries, name: 'dFd+' });
+    registry.register({ ...cmdListTSDictionaries, name: "dFd+" });
     registry.register(cmdListTSTemplates);
-    registry.register({ ...cmdListTSTemplates, name: 'dFt+' });
+    registry.register({ ...cmdListTSTemplates, name: "dFt+" });
     // Foreign-data family.
-    for (const variant of ['dew', 'dew+']) {
+    for (const variant of ["dew", "dew+"]) {
         registry.register({ ...cmdListForeignDataWrappers, name: variant });
     }
-    for (const variant of ['des', 'des+']) {
+    for (const variant of ["des", "des+"]) {
         registry.register({ ...cmdListForeignServers, name: variant });
     }
-    for (const variant of ['deu', 'deu+']) {
+    for (const variant of ["deu", "deu+"]) {
         registry.register({ ...cmdListUserMappings, name: variant });
     }
-    for (const variant of ['det', 'det+']) {
+    for (const variant of ["det", "det+"]) {
         registry.register({ ...cmdListForeignTables, name: variant });
     }
     // Partitioned tables. Upstream's `\dP` accepts any concatenation of
@@ -1774,37 +1779,37 @@ export const registerDescribeCommands = (registry) => {
     // suffix-decoding loop (`includes('i'|'t'|'n')`) drives the actual
     // `reltypes` selection at runtime.
     for (const variant of [
-        'dP',
-        'dP+',
-        'dPi',
-        'dPi+',
-        'dPin',
-        'dPin+',
-        'dPt',
-        'dPt+',
-        'dPtn',
-        'dPtn+',
-        'dPn',
-        'dPn+',
+        "dP",
+        "dP+",
+        "dPi",
+        "dPi+",
+        "dPin",
+        "dPin+",
+        "dPt",
+        "dPt+",
+        "dPtn",
+        "dPtn+",
+        "dPn",
+        "dPn+",
     ]) {
         registry.register({ ...cmdListPartitionedTables, name: variant });
     }
     // Role-database settings.
     registry.register(cmdListDbRoleSettings);
-    registry.register({ ...cmdListDbRoleSettings, name: 'drds+' });
+    registry.register({ ...cmdListDbRoleSettings, name: "drds+" });
     // Extended statistics (\dX / \dX+).
-    for (const suffix of ['', '+']) {
-        registry.register(cmdListExtendedStats('dX' + suffix));
+    for (const suffix of ["", "+"]) {
+        registry.register(cmdListExtendedStats("dX" + suffix));
     }
     // Role grants (\drg / \drg+ / \drgS).
-    for (const suffix of ['', '+', 'S', 'S+', '+S']) {
-        registry.register(cmdDescribeRoleGrants('drg' + suffix));
+    for (const suffix of ["", "+", "S", "S+", "+S"]) {
+        registry.register(cmdDescribeRoleGrants("drg" + suffix));
     }
     // Publication / subscription.
-    for (const variant of ['dRp', 'dRp+']) {
+    for (const variant of ["dRp", "dRp+"]) {
         registry.register({ ...cmdListPublications, name: variant });
     }
-    for (const variant of ['dRs', 'dRs+']) {
+    for (const variant of ["dRs", "dRs+"]) {
         registry.register({ ...cmdDescribeSubscriptions, name: variant });
     }
 };