neonctl 2.28.0 → 2.29.1

package/dist/psql/wire/connection.js

@@ -32,16 +32,16 @@
  *     protocol.ts but the high-level path (parameterised `query()`, prepared
  *     statements, pipeline) is WP-21. We throw clearly when called.
  */
-import * as dns from 'node:dns/promises';
-import * as net from 'node:net';
-import * as tls from 'node:tls';
-import { createHash } from 'node:crypto';
-import { Buffer } from 'node:buffer';
-import { Bind, CancelRequest, Close, CopyData, CopyDone, CopyFail, Describe, Execute, fieldsToNotice, MessageParser, Parse, PasswordMessage, Query, SASLInitialResponse, SASLResponse, StartupMessage, Sync, Terminate, } from './protocol.js';
-import { PipelineSession } from './pipeline.js';
-import { createScramClient } from './sasl.js';
-import { negotiateTls } from './tls.js';
-import { NoticeMultiplexer } from './notify.js';
+import { Buffer } from "node:buffer";
+import { createHash } from "node:crypto";
+import * as dns from "node:dns/promises";
+import * as net from "node:net";
+import * as tls from "node:tls";
+import { NoticeMultiplexer } from "./notify.js";
+import { PipelineSession } from "./pipeline.js";
+import { Bind, CancelRequest, Close, CopyData, CopyDone, CopyFail, Describe, Execute, fieldsToNotice, MessageParser, Parse, PasswordMessage, Query, SASLInitialResponse, SASLResponse, StartupMessage, Sync, Terminate, } from "./protocol.js";
+import { createScramClient } from "./sasl.js";
+import { negotiateTls } from "./tls.js";
 /**
  * Map a Notice-flavoured fields map into a `ConnectError` that includes a
  * recognizable `message` plus a `cause` slot for the raw record.
@@ -59,9 +59,9 @@ function fieldsToConnectError(fields) {
  */
 function pipelineAbortedError() {
     return {
-        severity: 'ERROR',
-        code: '',
-        message: 'Pipeline aborted, command did not run',
+        severity: "ERROR",
+        code: "",
+        message: "Pipeline aborted, command did not run",
         pipelineAborted: true,
     };
 }
@@ -87,14 +87,14 @@ function parseServerVersion(value) {
  * the username; outer is salted. PG uses lowercase hex everywhere.
  */
 function md5AuthPayload(user, password, salt) {
-    const inner = createHash('md5')
-        .update(password + user, 'utf8')
-        .digest('hex');
-    const outer = createHash('md5')
-        .update(inner, 'utf8')
+    const inner = createHash("md5")
+        .update(password + user, "utf8")
+        .digest("hex");
+    const outer = createHash("md5")
+        .update(inner, "utf8")
         .update(salt)
-        .digest('hex');
-    return 'md5' + outer;
+        .digest("hex");
+    return "md5" + outer;
 }
 /**
  * Fisher-Yates in-place shuffle of the candidate hosts list. Used by
@@ -124,11 +124,11 @@ function shuffleInPlace(arr, rng = Math.random) {
  * rather than handing the caller a half-broken connection.
  */
 async function checkSessionAttrs(conn, tsa) {
-    if (tsa === undefined || tsa === 'any')
+    if (tsa === undefined || tsa === "any")
         return true;
     let inRecovery;
     try {
-        const sets = await conn.execSimple('SELECT pg_is_in_recovery()');
+        const sets = await conn.execSimple("SELECT pg_is_in_recovery()");
         if (sets.length === 0 || sets[0].rows.length === 0) {
             return false;
         }
@@ -141,8 +141,8 @@ async function checkSessionAttrs(conn, tsa) {
         else if (raw === false) {
             inRecovery = false;
         }
-        else if (typeof raw === 'string') {
-            inRecovery = raw === 't' || raw.toLowerCase() === 'true';
+        else if (typeof raw === "string") {
+            inRecovery = raw === "t" || raw.toLowerCase() === "true";
         }
         else {
             return false;
@@ -152,11 +152,11 @@ async function checkSessionAttrs(conn, tsa) {
         return false;
     }
     switch (tsa) {
-        case 'read-write':
-        case 'primary':
+        case "read-write":
+        case "primary":
             return !inRecovery;
-        case 'read-only':
-        case 'standby':
+        case "read-only":
+        case "standby":
             return inRecovery;
         // 'prefer-standby' is unwrapped by the orchestrator into two passes
         // ('standby' then 'any'), so we never see it here. Fall through to
@@ -195,9 +195,9 @@ export class PgConnection {
         this.params = new Map();
         this.processId = 0;
         this.secretKey = 0;
-        this.txStatus = 'I';
+        this.txStatus = "I";
         // -- Connection state machine
-        this.state = 'auth';
+        this.state = "auth";
         this.pendingQuery = null;
         this.extDriver = null;
         /** True when `pipeline()` has handed out a PipelineSession (WP-21). */
@@ -285,17 +285,17 @@ export class PgConnection {
         this.opts = opts;
         this.channelBindingData = channelBindingData;
         this._password = opts.password ?? null;
-        socket.on('data', (chunk) => {
+        socket.on("data", (chunk) => {
             this.onData(chunk);
         });
-        socket.on('error', (err) => {
+        socket.on("error", (err) => {
             this.socketError = err;
             this.failPending(err);
         });
-        socket.on('close', () => {
-            if (this.state !== 'closed') {
-                this.state = 'closed';
-                this.failPending(this.socketError ?? new Error('Socket closed'));
+        socket.on("close", () => {
+            if (this.state !== "closed") {
+                this.state = "closed";
+                this.failPending(this.socketError ?? new Error("Socket closed"));
             }
         });
     }
@@ -342,20 +342,20 @@ export class PgConnection {
         // the candidate's `address`, and `host` (the user-typed name) is
         // preserved for SNI / `conn.host`. Only the single-host form carries a
         // `hostaddr`; libpq does not support a hostaddr-per-host list here.
-        const candidates = opts.hostaddr !== undefined && opts.hostaddr !== ''
+        const candidates = opts.hostaddr !== undefined && opts.hostaddr !== ""
             ? seed.map((c) => ({
                 host: c.host,
                 address: opts.hostaddr,
                 port: c.port,
             }))
             : await expandHostsViaDns(seed);
-        if (opts.loadBalanceHosts === 'random') {
+        if (opts.loadBalanceHosts === "random") {
             shuffleInPlace(candidates, PgConnection._loadBalanceRng ?? Math.random);
         }
-        const tsa = opts.targetSessionAttrs ?? 'any';
+        const tsa = opts.targetSessionAttrs ?? "any";
         // `prefer-standby` runs two passes: first 'standby', then 'any'. Every
         // other mode runs a single pass with the literal target.
-        const passes = tsa === 'prefer-standby' ? ['standby', 'any'] : [tsa];
+        const passes = tsa === "prefer-standby" ? ["standby", "any"] : [tsa];
         let lastErr = null;
         for (const passTsa of passes) {
             for (const candidate of candidates) {
@@ -394,25 +394,25 @@ export class PgConnection {
             if (lastErr instanceof Error)
                 throw lastErr;
             let message;
-            if (typeof lastErr === 'object' &&
+            if (typeof lastErr === "object" &&
                 lastErr !== null &&
-                'message' in lastErr &&
-                typeof lastErr.message === 'string') {
+                "message" in lastErr &&
+                typeof lastErr.message === "string") {
                 message = lastErr.message;
             }
-            else if (typeof lastErr === 'string' ||
-                typeof lastErr === 'number' ||
-                typeof lastErr === 'boolean') {
+            else if (typeof lastErr === "string" ||
+                typeof lastErr === "number" ||
+                typeof lastErr === "boolean") {
                 message = String(lastErr);
             }
             else {
-                message = 'PgConnection.connect: unknown error';
+                message = "PgConnection.connect: unknown error";
             }
             const wrapped = new Error(message);
             wrapped.cause = lastErr;
             throw wrapped;
         }
-        throw new Error('PgConnection.connect: no candidate hosts configured');
+        throw new Error("PgConnection.connect: no candidate hosts configured");
     }
     /**
      * Per-host connect attempt: open the socket, negotiate TLS, run the auth
@@ -432,9 +432,9 @@ export class PgConnection {
         // connections. We mirror the early rejection so a misconfigured caller
         // gets a clear diagnostic instead of a confused TLS handshake.
         if (isUnixSocketHost(opts.host) &&
-            (opts.ssl === 'require' ||
-                opts.ssl === 'verify-ca' ||
-                opts.ssl === 'verify-full')) {
+            (opts.ssl === "require" ||
+                opts.ssl === "verify-ca" ||
+                opts.ssl === "verify-full")) {
             throw new Error(`sslmode=${opts.ssl} is not supported over Unix-domain sockets (host=${opts.host})`);
         }
         // libpq `requirepeer`: for Unix-domain sockets, libpq verifies the server
@@ -447,7 +447,7 @@ export class PgConnection {
         // connections ignore `requirepeer`, matching libpq.)
         if (isUnixSocketHost(opts.host) &&
             opts.requirepeer !== undefined &&
-            opts.requirepeer !== '') {
+            opts.requirepeer !== "") {
             throw new Error(`requirepeer="${opts.requirepeer}" cannot be enforced: Node provides no ` +
                 `Unix-domain socket peer-credential API; refusing to connect rather ` +
                 `than skip the check`);
@@ -467,11 +467,11 @@ export class PgConnection {
             const servername = tlsServername(opts);
             const tlsConnectionOptions = {
                 ...(servername !== undefined ? { servername } : {}),
-                rejectUnauthorized: opts.ssl === 'verify-ca' || opts.ssl === 'verify-full',
+                rejectUnauthorized: opts.ssl === "verify-ca" || opts.ssl === "verify-full",
                 // PG 17+ advertises ALPN for the 'postgresql' protocol; libpq sets
                 // this so a future-proof TLS proxy can route on ALPN instead of
                 // probing the wire. Always offer it — older servers ignore.
-                ALPNProtocols: ['postgresql'],
+                ALPNProtocols: ["postgresql"],
                 // Cipher preference is left to the runtime's TLS library. Our
                 // ClientHello offers the byte-identical TLS-1.3 ciphersuite list and
                 // order as libpq (AES-256-GCM, ChaCha20, AES-128-GCM), so the suite
@@ -483,7 +483,7 @@ export class PgConnection {
                 // is TLS-1.2-only; `ciphersuites`/secureContext are ignored for the
                 // client offer), so this is left as-is.
             };
-            if (opts.ssl !== 'verify-full') {
+            if (opts.ssl !== "verify-full") {
                 tlsConnectionOptions.checkServerIdentity = () => undefined;
             }
             else if (opts.sslsni === false) {
@@ -500,7 +500,7 @@ export class PgConnection {
             // prefer — instead of negotiating it just stays plain. We short-
             // circuit by passing 'disable' to negotiateTls; the caller's
             // requested sslmode is preserved on opts for error reporting.
-            isUnixSocketHost(opts.host) ? 'disable' : opts.ssl, tlsConnectionOptions, {
+            isUnixSocketHost(opts.host) ? "disable" : opts.ssl, tlsConnectionOptions, {
                 sslcert: opts.sslcert,
                 sslkey: opts.sslkey,
                 sslcertmode: opts.sslcertmode,
@@ -515,9 +515,9 @@ export class PgConnection {
             // sslmode 'disable' above) — direct SSL is a TCP-only concept. The
             // ALPN protocol is already on `tlsConnectionOptions` for both paths.
             isUnixSocketHost(opts.host)
-                ? 'postgres'
-                : (opts.sslnegotiation ?? 'postgres'));
-            if (tlsResult.kind === 'tls') {
+                ? "postgres"
+                : (opts.sslnegotiation ?? "postgres"));
+            if (tlsResult.kind === "tls") {
                 socket = tlsResult.socket;
                 channelBindingData = tlsResult.channelBindingData;
             }
@@ -584,30 +584,32 @@ export class PgConnection {
      */
     getTlsInfo() {
         const s = this.socket;
-        if (typeof s.getCipher !== 'function')
+        if (typeof s.getCipher !== "function")
             return null;
         try {
             const cipher = s.getCipher();
-            const protocol = s.getProtocol?.() ?? cipher.version ?? 'unknown';
+            const protocol = s.getProtocol?.() ?? cipher.version ?? "unknown";
             if (!cipher.name)
                 return null;
             // TLS compression has been disabled by every modern stack since CRIME
             // (2012); Node's TLS doesn't expose a compression accessor, so we
             // always report "off". libpq does the same.
-            const compression = 'off';
+            const compression = "off";
             // Node exposes the negotiated ALPN protocol on TLSSocket.alpnProtocol
             // (string when negotiated, false when not). Postgres 17+ uses
             // 'postgresql' here.
             const alpnRaw = s
                 .alpnProtocol;
-            const alpn = typeof alpnRaw === 'string' && alpnRaw.length > 0 ? alpnRaw : null;
+            const alpn = typeof alpnRaw === "string" && alpnRaw.length > 0
+                ? alpnRaw
+                : null;
             return {
                 protocol: String(protocol),
                 cipher: cipher.standardName ?? cipher.name,
                 standardName: cipher.standardName,
                 compression,
                 alpn,
-                library: 'OpenSSL',
+                library: "OpenSSL",
                 keyBits: sslKeyBitsFromCipher(cipher.standardName ?? cipher.name),
             };
         }
@@ -628,7 +630,7 @@ export class PgConnection {
      *   - `gssapiUsed`: always `false` — we have no GSSAPI support.
      */
     getConnectionInfo() {
-        const remote = this.opts.hostaddr !== undefined && this.opts.hostaddr !== ''
+        const remote = this.opts.hostaddr !== undefined && this.opts.hostaddr !== ""
             ? this.opts.hostaddr
             : (this.socket.remoteAddress ?? null);
         return {
@@ -657,7 +659,7 @@ export class PgConnection {
         if (params === undefined) {
             const sets = await this.execSimple(sql);
             if (sets.length === 0) {
-                throw new Error('PgConnection.query: server returned no result sets');
+                throw new Error("PgConnection.query: server returned no result sets");
             }
             return sets[sets.length - 1];
         }
@@ -672,10 +674,10 @@ export class PgConnection {
         const descP = this.enqueueDescribePortalIntoNextExecute();
         const execP = this.enqueueExecute();
         const syncP = this.enqueueSync();
-        this.socket.write(Parse('', sql, []));
-        this.socket.write(Bind('', '', [], encoded, [0]));
-        this.socket.write(Describe('P', ''));
-        this.socket.write(Execute('', 0));
+        this.socket.write(Parse("", sql, []));
+        this.socket.write(Bind("", "", [], encoded, [0]));
+        this.socket.write(Describe("P", ""));
+        this.socket.write(Execute("", 0));
         this.socket.write(Sync());
         let firstErr = null;
         const cap = (e) => {
@@ -693,7 +695,7 @@ export class PgConnection {
         if (firstErr !== null)
             throw asThrowable(firstErr);
         if (result === null) {
-            throw new Error('PgConnection.query: server returned no result');
+            throw new Error("PgConnection.query: server returned no result");
         }
         return result;
     }
@@ -708,7 +710,7 @@ export class PgConnection {
                 notices: [],
                 error: null,
             };
-            this.state = 'in-query';
+            this.state = "in-query";
             this.socket.write(Query(sql));
         });
     }
@@ -720,7 +722,7 @@ export class PgConnection {
         const descP = this.enqueueDescribeStatement();
         const syncP = this.enqueueSync();
         this.socket.write(Parse(name, sql, oids));
-        this.socket.write(Describe('S', name));
+        this.socket.write(Describe("S", name));
         this.socket.write(Sync());
         let firstErr = null;
         const cap = (e) => {
@@ -736,7 +738,7 @@ export class PgConnection {
         if (firstErr !== null)
             throw asThrowable(firstErr);
         if (descResult === null) {
-            throw new Error('PgConnection.prepare: server returned no parameter description');
+            throw new Error("PgConnection.prepare: server returned no parameter description");
         }
         const { paramOids, fields } = descResult;
         // eslint-disable-next-line @typescript-eslint/no-this-alias
@@ -750,7 +752,7 @@ export class PgConnection {
                 conn.startExtendedBatch();
                 const bP = conn.enqueueBind();
                 const sP = conn.enqueueSync();
-                conn.socket.write(Bind('', name, paramFormats ?? [], encoded, [0]));
+                conn.socket.write(Bind("", name, paramFormats ?? [], encoded, [0]));
                 conn.socket.write(Sync());
                 let err = null;
                 bP.catch((e) => {
@@ -772,7 +774,7 @@ export class PgConnection {
                 conn.startExtendedBatch();
                 const eP = conn.enqueueExecuteWithFields(fields);
                 const sP = conn.enqueueSync();
-                conn.socket.write(Execute('', maxRows ?? 0));
+                conn.socket.write(Execute("", maxRows ?? 0));
                 conn.socket.write(Sync());
                 let err = null;
                 let rs = null;
@@ -789,7 +791,7 @@ export class PgConnection {
                 if (err !== null)
                     throw asThrowable(err);
                 if (rs === null) {
-                    throw new Error('PgConnection.prepare.execute: server returned no result');
+                    throw new Error("PgConnection.prepare.execute: server returned no result");
                 }
                 return rs;
             },
@@ -800,8 +802,8 @@ export class PgConnection {
                 const bP = conn.enqueueBind();
                 const eP = conn.enqueueExecuteWithFields(fields);
                 const sP = conn.enqueueSync();
-                conn.socket.write(Bind('', name, paramFormats ?? [], encoded, [0]));
-                conn.socket.write(Execute('', maxRows ?? 0));
+                conn.socket.write(Bind("", name, paramFormats ?? [], encoded, [0]));
+                conn.socket.write(Execute("", maxRows ?? 0));
                 conn.socket.write(Sync());
                 let err = null;
                 let rs = null;
@@ -822,7 +824,7 @@ export class PgConnection {
                 if (err !== null)
                     throw asThrowable(err);
                 if (rs === null) {
-                    throw new Error('PgConnection.prepare.bindAndExecute: server returned no result');
+                    throw new Error("PgConnection.prepare.bindAndExecute: server returned no result");
                 }
                 return rs;
             },
@@ -831,7 +833,7 @@ export class PgConnection {
                 conn.startExtendedBatch();
                 const cP = conn.enqueueClose();
                 const sP = conn.enqueueSync();
-                conn.socket.write(Close('S', name));
+                conn.socket.write(Close("S", name));
                 conn.socket.write(Sync());
                 let err = null;
                 cP.catch((e) => {
@@ -859,7 +861,7 @@ export class PgConnection {
         this.startExtendedBatch();
         const cP = this.enqueueClose();
         const sP = this.enqueueSync();
-        this.socket.write(Close('S', name));
+        this.socket.write(Close("S", name));
         this.socket.write(Sync());
         let err = null;
         cP.catch((e) => {
@@ -881,7 +883,7 @@ export class PgConnection {
         // (see handleCopyStartMessage) for any path that bypasses this check.
         if (this._extPipelineActive) {
             this.abortForCopyInPipeline();
-            return Promise.reject(Object.assign(new Error('COPY in a pipeline is not supported, aborting connection'), { severity: 'FATAL' }));
+            return Promise.reject(Object.assign(new Error("COPY in a pipeline is not supported, aborting connection"), { severity: "FATAL" }));
         }
         // The driver waits in `in-query` state until CopyInResponse arrives — at
         // which point the protocol switches and we move to `in-copy-in`. The
@@ -900,7 +902,7 @@ export class PgConnection {
                 resolve(this.makeCopyInStream());
             };
             this.copyStartReject = reject;
-            this.state = 'in-query';
+            this.state = "in-query";
             this.socket.write(Query(sql));
         });
     }
@@ -908,7 +910,7 @@ export class PgConnection {
         this.ensureIdle();
         if (this._extPipelineActive) {
             this.abortForCopyInPipeline();
-            return Promise.reject(Object.assign(new Error('COPY in a pipeline is not supported, aborting connection'), { severity: 'FATAL' }));
+            return Promise.reject(Object.assign(new Error("COPY in a pipeline is not supported, aborting connection"), { severity: "FATAL" }));
         }
         return new Promise((resolve, reject) => {
             this.copyOut = {
@@ -924,7 +926,7 @@ export class PgConnection {
                 resolve(this.makeCopyOutStream());
             };
             this.copyStartReject = reject;
-            this.state = 'in-query';
+            this.state = "in-query";
             this.socket.write(Query(sql));
         });
     }
@@ -956,10 +958,10 @@ export class PgConnection {
         // In-copy-in: send CopyFail on the live socket so the server returns
         // to ReadyForQuery cleanly. This is the same abort path the upstream
         // SIGINT handler in `copy.c::handleCopyIn` triggers via longjmp.
-        if (this.state === 'in-copy-in' && this.copyIn && !this.copyIn.closed) {
+        if (this.state === "in-copy-in" && this.copyIn && !this.copyIn.closed) {
             this.copyIn.closed = true;
             try {
-                this.socket.write(CopyFail('canceled by user'));
+                this.socket.write(CopyFail("canceled by user"));
             }
             catch {
                 // Socket may have died — failPending() will surface that.
@@ -978,7 +980,7 @@ export class PgConnection {
         // Honour `hostaddr` on the cancel connection too: dial the fixed IP while
         // keeping the user-typed host for SNI / cert verification, mirroring the
         // primary connect path's `addressOverride`.
-        const cancelSocket = await openSocket(this.opts, this.opts.hostaddr !== undefined && this.opts.hostaddr !== ''
+        const cancelSocket = await openSocket(this.opts, this.opts.hostaddr !== undefined && this.opts.hostaddr !== ""
             ? this.opts.hostaddr
             : undefined);
         let writeSocket = cancelSocket;
@@ -990,10 +992,11 @@ export class PgConnection {
                 ...(cancelServername !== undefined
                     ? { servername: cancelServername }
                     : {}),
-                rejectUnauthorized: this.opts.ssl === 'verify-ca' || this.opts.ssl === 'verify-full',
-                ALPNProtocols: ['postgresql'],
+                rejectUnauthorized: this.opts.ssl === "verify-ca" ||
+                    this.opts.ssl === "verify-full",
+                ALPNProtocols: ["postgresql"],
             };
-            if (this.opts.ssl !== 'verify-full') {
+            if (this.opts.ssl !== "verify-full") {
                 cancelTlsOpts.checkServerIdentity = () => undefined;
             }
             else if (this.opts.sslsni === false) {
@@ -1003,7 +1006,7 @@ export class PgConnection {
             applyTlsProtocolVersionRange(cancelTlsOpts, this.opts);
             const t = await negotiateTls(cancelSocket, 
             // Unix-domain socket: no TLS, regardless of caller's sslmode.
-            isUnixSocketHost(this.opts.host) ? 'disable' : this.opts.ssl, cancelTlsOpts, {
+            isUnixSocketHost(this.opts.host) ? "disable" : this.opts.ssl, cancelTlsOpts, {
                 sslcert: this.opts.sslcert,
                 sslkey: this.opts.sslkey,
                 sslcertmode: this.opts.sslcertmode,
@@ -1016,9 +1019,9 @@ export class PgConnection {
             // Mirror the primary connect path's negotiation mode so a server
             // configured for direct SSL also accepts the cancel connection.
             isUnixSocketHost(this.opts.host)
-                ? 'postgres'
-                : (this.opts.sslnegotiation ?? 'postgres'));
-            writeSocket = t.kind === 'tls' ? t.socket : t.socket;
+                ? "postgres"
+                : (this.opts.sslnegotiation ?? "postgres"));
+            writeSocket = t.kind === "tls" ? t.socket : t.socket;
             await new Promise((resolve, reject) => {
                 writeSocket.write(CancelRequest(this.processId, this.secretKey), (err) => {
                     if (err)
@@ -1051,8 +1054,8 @@ export class PgConnection {
         // backslash, use the E'...' escape-string syntax so backslashes don't
         // depend on `standard_conforming_strings`.
         const doubled = value.replace(/'/g, "''");
-        if (value.includes('\\')) {
-            return "E'" + doubled.replace(/\\/g, '\\\\') + "'";
+        if (value.includes("\\")) {
+            return "E'" + doubled.replace(/\\/g, "\\\\") + "'";
         }
         return "'" + doubled + "'";
     }
@@ -1079,7 +1082,7 @@ export class PgConnection {
         return this.notify.onNotification(handler);
     }
     async close() {
-        if (this.state === 'closed')
+        if (this.state === "closed")
             return;
         try {
             this.socket.write(Terminate());
@@ -1087,10 +1090,10 @@ export class PgConnection {
         catch {
             // socket may already be dead; we still want to mark closed
         }
-        this.state = 'closed';
+        this.state = "closed";
         this.notify.clear();
         await new Promise((resolve) => {
-            this.socket.once('close', () => {
+            this.socket.once("close", () => {
                 resolve();
             });
             try {
@@ -1102,7 +1105,7 @@ export class PgConnection {
         });
     }
     isClosed() {
-        return this.state === 'closed';
+        return this.state === "closed";
     }
     // -------------------------------------------------------------------------
     // Startup / auth state machine
@@ -1113,7 +1116,7 @@ export class PgConnection {
                 user: this.opts.user,
                 database: this.opts.database,
                 // psql sends client_encoding=UTF8 by default; we follow.
-                client_encoding: this.opts.clientEncoding ?? 'UTF8',
+                client_encoding: this.opts.clientEncoding ?? "UTF8",
             };
             if (this.opts.applicationName !== undefined) {
                 params.application_name = this.opts.applicationName;
@@ -1156,15 +1159,16 @@ export class PgConnection {
     }
     handleAuthMessage(msg) {
         switch (msg.type) {
-            case 'AuthenticationOk': {
+            case "AuthenticationOk": {
                 // libpq parity: channel_binding=require demands that some prior
                 // auth step actually negotiated channel binding. A bare
                 // AuthenticationOk after no challenge ("trust") or after a cert
                 // exchange ("cert" HBA, clientcert=verify-full) means no SCRAM
                 // happened and we must refuse.
-                if (this.opts.channelBinding === 'require' &&
-                    (this.scram === null || this.scram.mechanism !== 'SCRAM-SHA-256-PLUS')) {
-                    this.failStartup(new Error('channel binding required, but server authenticated client without channel binding'));
+                if (this.opts.channelBinding === "require" &&
+                    (this.scram === null ||
+                        this.scram.mechanism !== "SCRAM-SHA-256-PLUS")) {
+                    this.failStartup(new Error("channel binding required, but server authenticated client without channel binding"));
                     return;
                 }
                 // Mutual-auth integrity: if a SCRAM exchange was started it MUST have
@@ -1172,45 +1176,45 @@ export class PgConnection {
                 // verified). A server that sends SASLContinue then jumps to
                 // AuthenticationOk never proves it knows the password (review #8).
                 if (this.scram !== null && !this.saslFinalSeen) {
-                    this.failStartup(new Error('server sent AuthenticationOk without completing SCRAM ' +
-                        'authentication (server signature not verified)'));
+                    this.failStartup(new Error("server sent AuthenticationOk without completing SCRAM " +
+                        "authentication (server signature not verified)"));
                     return;
                 }
                 // require_auth=none allows trust auth; anything else is rejected
                 // here. If a prior challenge was sent and validated, skip — that
                 // method was already accepted by the check at its own branch.
-                if (!this.authChallengeSeen && !this.checkRequireAuth('none')) {
+                if (!this.authChallengeSeen && !this.checkRequireAuth("none")) {
                     return;
                 }
-                this.state = 'await-ready';
+                this.state = "await-ready";
                 return;
             }
-            case 'AuthenticationCleartextPassword': {
+            case "AuthenticationCleartextPassword": {
                 this.authChallengeSeen = true;
-                if (this.opts.channelBinding === 'require') {
+                if (this.opts.channelBinding === "require") {
                     this.failStartup(new Error("channel binding required but not supported by server's authentication request"));
                     return;
                 }
-                if (!this.checkRequireAuth('password'))
+                if (!this.checkRequireAuth("password"))
                     return;
                 if (this.opts.password === undefined) {
-                    this.failStartup(new Error('Server requested cleartext password but no password was provided'));
+                    this.failStartup(new Error("Server requested cleartext password but no password was provided"));
                     return;
                 }
                 this.passwordUsed = true;
                 this.socket.write(PasswordMessage(this.opts.password));
                 return;
             }
-            case 'AuthenticationMD5Password': {
+            case "AuthenticationMD5Password": {
                 this.authChallengeSeen = true;
-                if (this.opts.channelBinding === 'require') {
+                if (this.opts.channelBinding === "require") {
                     this.failStartup(new Error("channel binding required but not supported by server's authentication request"));
                     return;
                 }
-                if (!this.checkRequireAuth('md5'))
+                if (!this.checkRequireAuth("md5"))
                     return;
                 if (this.opts.password === undefined) {
-                    this.failStartup(new Error('Server requested MD5 password but no password was provided'));
+                    this.failStartup(new Error("Server requested MD5 password but no password was provided"));
                     return;
                 }
                 const payload = md5AuthPayload(this.opts.user, this.opts.password, msg.salt);
@@ -1218,24 +1222,24 @@ export class PgConnection {
                 this.socket.write(PasswordMessage(payload));
                 return;
             }
-            case 'AuthenticationSASL': {
+            case "AuthenticationSASL": {
                 this.authChallengeSeen = true;
                 if (this.opts.password === undefined) {
-                    this.failStartup(new Error('Server requested SASL auth but no password was provided'));
+                    this.failStartup(new Error("Server requested SASL auth but no password was provided"));
                     return;
                 }
-                if (!this.checkRequireAuth('scram-sha-256'))
+                if (!this.checkRequireAuth("scram-sha-256"))
                     return;
                 // channel_binding=require AND server didn't offer the PLUS
                 // variant — refuse before the SASL handshake starts. The check
                 // is split between here (no PLUS in the mechanism list) and
                 // chooseMechanism's fallback (PLUS present but no binding data).
-                if (this.opts.channelBinding === 'require' &&
-                    !msg.mechanisms.includes('SCRAM-SHA-256-PLUS')) {
+                if (this.opts.channelBinding === "require" &&
+                    !msg.mechanisms.includes("SCRAM-SHA-256-PLUS")) {
                     this.failStartup(new Error("channel binding required but not supported by server's authentication request"));
                     return;
                 }
-                if (this.opts.channelBinding === 'require' &&
+                if (this.opts.channelBinding === "require" &&
                     this.channelBindingData === null) {
                     this.failStartup(new Error("channel binding required but not supported by server's authentication request"));
                     return;
@@ -1246,9 +1250,9 @@ export class PgConnection {
                         password: this.opts.password,
                         mechanisms: msg.mechanisms,
                         channelBinding: this.channelBindingData !== null &&
-                            this.opts.channelBinding !== 'disable'
+                            this.opts.channelBinding !== "disable"
                             ? {
-                                type: 'tls-server-end-point',
+                                type: "tls-server-end-point",
                                 data: this.channelBindingData,
                             }
                             : undefined,
@@ -1262,9 +1266,9 @@ export class PgConnection {
                 }
                 return;
             }
-            case 'AuthenticationSASLContinue': {
+            case "AuthenticationSASLContinue": {
                 if (!this.scram) {
-                    this.failStartup(new Error('Received AuthenticationSASLContinue without an active SCRAM client'));
+                    this.failStartup(new Error("Received AuthenticationSASLContinue without an active SCRAM client"));
                     return;
                 }
                 try {
@@ -1276,9 +1280,9 @@ export class PgConnection {
                 }
                 return;
             }
-            case 'AuthenticationSASLFinal': {
+            case "AuthenticationSASLFinal": {
                 if (!this.scram) {
-                    this.failStartup(new Error('Received AuthenticationSASLFinal without an active SCRAM client'));
+                    this.failStartup(new Error("Received AuthenticationSASLFinal without an active SCRAM client"));
                     return;
                 }
                 try {
@@ -1290,10 +1294,10 @@ export class PgConnection {
                 }
                 return;
             }
-            case 'ErrorResponse':
+            case "ErrorResponse":
                 this.failStartup(fieldsToConnectError(msg.fields));
                 return;
-            case 'NoticeResponse':
+            case "NoticeResponse":
                 this.notify.emit(fieldsToNotice(msg.fields));
                 return;
             default:
@@ -1306,19 +1310,19 @@ export class PgConnection {
     }
     handleAwaitReady(msg) {
         switch (msg.type) {
-            case 'ParameterStatus':
+            case "ParameterStatus":
                 this.params.set(msg.name, msg.value);
-                if (msg.name === 'server_version') {
+                if (msg.name === "server_version") {
                     this.serverVersion = parseServerVersion(msg.value);
                 }
                 return;
-            case 'BackendKeyData':
+            case "BackendKeyData":
                 this.processId = msg.processId;
                 this.secretKey = msg.secretKey;
                 return;
-            case 'ReadyForQuery':
+            case "ReadyForQuery":
                 this.txStatus = msg.status;
-                this.state = 'idle';
+                this.state = "idle";
                 if (this.startupResolve) {
                     const r = this.startupResolve;
                     this.startupResolve = null;
@@ -1326,10 +1330,10 @@ export class PgConnection {
                     r();
                 }
                 return;
-            case 'ErrorResponse':
+            case "ErrorResponse":
                 this.failStartup(fieldsToConnectError(msg.fields));
                 return;
-            case 'NoticeResponse':
+            case "NoticeResponse":
                 this.notify.emit(fieldsToNotice(msg.fields));
                 return;
             default:
@@ -1350,7 +1354,7 @@ export class PgConnection {
         catch {
             // ignore
         }
-        this.state = 'closed';
+        this.state = "closed";
     }
     // -------------------------------------------------------------------------
     // COPY state machine (WP-16).
@@ -1370,17 +1374,19 @@ export class PgConnection {
     makeCopyInStream() {
         const driver = this.copyIn;
         if (!driver) {
-            throw new Error('PgConnection: makeCopyInStream called without driver');
+            throw new Error("PgConnection: makeCopyInStream called without driver");
         }
         return {
             write: (chunk) => {
-                if (this.state === 'closed') {
-                    return Promise.reject(new Error('Connection closed'));
+                if (this.state === "closed") {
+                    return Promise.reject(new Error("Connection closed"));
                 }
                 if (driver.closed) {
-                    return Promise.reject(new Error('CopyInStream already closed'));
+                    return Promise.reject(new Error("CopyInStream already closed"));
                 }
-                const data = typeof chunk === 'string' ? Buffer.from(chunk, 'utf8') : chunk;
+                const data = typeof chunk === "string"
+                    ? Buffer.from(chunk, "utf8")
+                    : chunk;
                 return new Promise((resolve, reject) => {
                     this.socket.write(CopyData(data), (err) => {
                         if (err)
@@ -1392,7 +1398,7 @@ export class PgConnection {
             },
             end: () => {
                 if (driver.closed) {
-                    return Promise.reject(new Error('CopyInStream already closed'));
+                    return Promise.reject(new Error("CopyInStream already closed"));
                 }
                 driver.closed = true;
                 return new Promise((resolve, reject) => {
@@ -1403,7 +1409,7 @@ export class PgConnection {
             },
             fail: (reason) => {
                 if (driver.closed) {
-                    return Promise.reject(new Error('CopyInStream already closed'));
+                    return Promise.reject(new Error("CopyInStream already closed"));
                 }
                 driver.closed = true;
                 return new Promise((resolve, reject) => {
@@ -1422,11 +1428,11 @@ export class PgConnection {
     makeCopyOutStream() {
         const driver = this.copyOut;
         if (!driver) {
-            throw new Error('PgConnection: makeCopyOutStream called without driver');
+            throw new Error("PgConnection: makeCopyOutStream called without driver");
         }
         // Capture the state-getter as a closure so the iterator can observe
         // connection close without holding a `this` alias (no-this-alias rule).
-        const isClosed = () => this.state === 'closed';
+        const isClosed = () => this.state === "closed";
         // Resume reading once the buffered data drains — paired with the
         // pause() the CopyData handler applies at the high-water mark (#11).
         const resumeSocket = () => {
@@ -1451,14 +1457,15 @@ export class PgConnection {
                                 // wants a real Error. Wrap once before throwing.
                                 const ce = driver.error;
                                 const wrapped = new Error(ce.message);
-                                wrapped.cause = ce;
+                                wrapped.cause =
+                                    ce;
                                 throw wrapped;
                             }
                             if (driver.done) {
                                 return { value: undefined, done: true };
                             }
                             if (isClosed()) {
-                                throw new Error('Connection closed mid-COPY-OUT');
+                                throw new Error("Connection closed mid-COPY-OUT");
                             }
                             await new Promise((resolve) => {
                                 driver.waker = resolve;
@@ -1476,7 +1483,10 @@ export class PgConnection {
                         driver.queue.length = 0;
                         driver.queuedBytes = 0;
                         resumeSocket();
-                        return Promise.resolve({ value: undefined, done: true });
+                        return Promise.resolve({
+                            value: undefined,
+                            done: true,
+                        });
                     },
                 };
             },
@@ -1489,7 +1499,7 @@ export class PgConnection {
      */
     handleCopyStartMessage(msg) {
         switch (msg.type) {
-            case 'CopyInResponse':
+            case "CopyInResponse":
                 // COPY-in-pipeline: libpq aborts the connection with this exact
                 // diagnostic (matching upstream psql's behaviour). The `\copy`
                 // command layer detects pipeline-active and fails fast before
@@ -1500,7 +1510,7 @@ export class PgConnection {
                     return;
                 }
                 if (this.copyIn) {
-                    this.state = 'in-copy-in';
+                    this.state = "in-copy-in";
                     const r = this.copyStartResolve;
                     this.copyStartResolve = null;
                     this.copyStartReject = null;
@@ -1508,13 +1518,13 @@ export class PgConnection {
                         r();
                 }
                 return;
-            case 'CopyOutResponse':
+            case "CopyOutResponse":
                 if (this._extPipelineActive) {
                     this.abortForCopyInPipeline();
                     return;
                 }
                 if (this.copyOut) {
-                    this.state = 'in-copy-out';
+                    this.state = "in-copy-out";
                     const r = this.copyStartResolve;
                     this.copyStartResolve = null;
                     this.copyStartReject = null;
@@ -1522,7 +1532,7 @@ export class PgConnection {
                         r();
                 }
                 return;
-            case 'ErrorResponse': {
+            case "ErrorResponse": {
                 const err = fieldsToConnectError(msg.fields);
                 if (this.copyIn) {
                     if (this.copyStartReject)
@@ -1541,17 +1551,17 @@ export class PgConnection {
                 // Stay in `in-query` until ReadyForQuery, then return to idle below.
                 return;
             }
-            case 'ReadyForQuery':
+            case "ReadyForQuery":
                 // ReadyForQuery without a prior CopyXxxResponse means the server
                 // immediately rejected the COPY (we surfaced the ErrorResponse just
                 // above) — return to idle so the next command can fire.
                 this.txStatus = msg.status;
-                this.state = 'idle';
+                this.state = "idle";
                 return;
-            case 'NoticeResponse':
+            case "NoticeResponse":
                 this.notify.emit(fieldsToNotice(msg.fields));
                 return;
-            case 'ParameterStatus':
+            case "ParameterStatus":
                 this.params.set(msg.name, msg.value);
                 return;
             default:
@@ -1568,22 +1578,22 @@ export class PgConnection {
         if (!driver)
             return;
         switch (msg.type) {
-            case 'CommandComplete':
+            case "CommandComplete":
                 driver.commandTag = msg.tag;
                 this.lastCopyTag = msg.tag;
                 return;
-            case 'ErrorResponse':
+            case "ErrorResponse":
                 driver.error = fieldsToConnectError(msg.fields);
                 return;
-            case 'NoticeResponse':
+            case "NoticeResponse":
                 this.notify.emit(fieldsToNotice(msg.fields));
                 return;
-            case 'ParameterStatus':
+            case "ParameterStatus":
                 this.params.set(msg.name, msg.value);
                 return;
-            case 'ReadyForQuery':
+            case "ReadyForQuery":
                 this.txStatus = msg.status;
-                this.state = 'idle';
+                this.state = "idle";
                 this.copyIn = null;
                 if (driver.error) {
                     if (driver.rejectDone)
@@ -1597,7 +1607,7 @@ export class PgConnection {
                 // Unknown messages mid-COPY-IN are protocol errors; record and let
                 // the trailing ReadyForQuery flush the state.
                 driver.error = {
-                    severity: 'ERROR',
+                    severity: "ERROR",
                     message: `Unexpected backend message during COPY IN: ${msg.type}`,
                 };
                 return;
@@ -1608,7 +1618,7 @@ export class PgConnection {
         if (!driver)
             return;
         switch (msg.type) {
-            case 'CopyData': {
+            case "CopyData": {
                 // Consumer broke early: drop instead of buffering (review item #11).
                 if (driver.abandoned)
                     return;
@@ -1627,27 +1637,27 @@ export class PgConnection {
                 }
                 return;
             }
-            case 'CopyDone':
+            case "CopyDone":
                 // Server signals it's done sending — we now expect CommandComplete +
                 // ReadyForQuery. Stay in in-copy-out until ReadyForQuery; the queue
                 // may still drain via the consumer.
                 return;
-            case 'CommandComplete':
+            case "CommandComplete":
                 driver.commandTag = msg.tag;
                 this.lastCopyTag = msg.tag;
                 return;
-            case 'ErrorResponse':
+            case "ErrorResponse":
                 driver.error = fieldsToConnectError(msg.fields);
                 return;
-            case 'NoticeResponse':
+            case "NoticeResponse":
                 this.notify.emit(fieldsToNotice(msg.fields));
                 return;
-            case 'ParameterStatus':
+            case "ParameterStatus":
                 this.params.set(msg.name, msg.value);
                 return;
-            case 'ReadyForQuery':
+            case "ReadyForQuery":
                 this.txStatus = msg.status;
-                this.state = 'idle';
+                this.state = "idle";
                 driver.done = true;
                 this.copyOut = null;
                 if (driver.waker) {
@@ -1658,7 +1668,7 @@ export class PgConnection {
                 return;
             default:
                 driver.error = {
-                    severity: 'ERROR',
+                    severity: "ERROR",
                     message: `Unexpected backend message during COPY OUT: ${msg.type}`,
                 };
                 if (driver.waker) {
@@ -1681,9 +1691,9 @@ export class PgConnection {
             return;
         }
         switch (msg.type) {
-            case 'RowDescription':
+            case "RowDescription":
                 q.current = {
-                    command: '',
+                    command: "",
                     rowCount: null,
                     oid: null,
                     fields: msg.fields,
@@ -1691,12 +1701,12 @@ export class PgConnection {
                     notices: [],
                 };
                 return;
-            case 'DataRow': {
+            case "DataRow": {
                 if (!q.current) {
                     // Server sent rows without a prior description — extremely rare
                     // (only for some legacy COPY error paths). Treat as empty desc.
                     q.current = {
-                        command: '',
+                        command: "",
                         rowCount: null,
                         oid: null,
                         fields: [],
@@ -1707,7 +1717,7 @@ export class PgConnection {
                 q.current.rows.push(decodeDataRow(msg.values, q.current.fields));
                 return;
             }
-            case 'CommandComplete': {
+            case "CommandComplete": {
                 const { command, rowCount, oid } = parseCommandTag(msg.tag);
                 const set = q.current ?? {
                     command,
@@ -1725,9 +1735,9 @@ export class PgConnection {
                 q.current = null;
                 return;
             }
-            case 'EmptyQueryResponse': {
+            case "EmptyQueryResponse": {
                 const set = {
-                    command: '',
+                    command: "",
                     rowCount: null,
                     oid: null,
                     fields: [],
@@ -1738,30 +1748,30 @@ export class PgConnection {
                 q.current = null;
                 return;
             }
-            case 'ParameterStatus':
+            case "ParameterStatus":
                 this.params.set(msg.name, msg.value);
-                if (msg.name === 'server_version') {
+                if (msg.name === "server_version") {
                     this.serverVersion = parseServerVersion(msg.value);
                 }
                 return;
-            case 'NoticeResponse': {
+            case "NoticeResponse": {
                 const notice = fieldsToNotice(msg.fields);
                 q.notices.push(notice);
                 this.notify.emit(notice);
                 return;
             }
-            case 'NotificationResponse':
+            case "NotificationResponse":
                 this.notify.emitNotification(msg.channel, msg.payload, msg.processId);
                 return;
-            case 'ErrorResponse': {
+            case "ErrorResponse": {
                 q.error = fieldsToConnectError(msg.fields);
                 // Don't reject yet — ReadyForQuery will arrive shortly and we want
                 // to drain queued NoticeResponse messages first.
                 return;
             }
-            case 'ReadyForQuery': {
+            case "ReadyForQuery": {
                 this.txStatus = msg.status;
-                this.state = 'idle';
+                this.state = "idle";
                 this.pendingQuery = null;
                 if (q.error) {
                     // Mirror libpq's behaviour: the result list contains every
@@ -1772,8 +1782,7 @@ export class PgConnection {
                     // (`executeAndPrint`) can render the pre-error rows in order
                     // before printing the error itself.
                     const err = asThrowable(q.error);
-                    err.partialResults =
-                        q.finished;
+                    err.partialResults = q.finished;
                     q.reject(err);
                 }
                 else {
@@ -1781,7 +1790,7 @@ export class PgConnection {
                 }
                 return;
             }
-            case 'CopyInResponse': {
+            case "CopyInResponse": {
                 // PG 17 added pipeline + COPY support but libpq still rejects the
                 // combination ("COPY in a pipeline is not supported, aborting
                 // connection"). Upstream psql surfaces that diagnostic and tears down
@@ -1817,11 +1826,11 @@ export class PgConnection {
                     return;
                 }
                 q.error = {
-                    severity: 'ERROR',
-                    message: 'COPY FROM STDIN not supported via execSimple — use \\copy or startCopyIn',
+                    severity: "ERROR",
+                    message: "COPY FROM STDIN not supported via execSimple — use \\copy or startCopyIn",
                 };
                 try {
-                    this.socket.write(CopyFail('COPY FROM STDIN not driven by client'));
+                    this.socket.write(CopyFail("COPY FROM STDIN not driven by client"));
                 }
                 catch {
                     // Write failures are surfaced via socket 'error' / 'close' handlers
@@ -1829,7 +1838,7 @@ export class PgConnection {
                 }
                 return;
             }
-            case 'CopyOutResponse': {
+            case "CopyOutResponse": {
                 if (this._extPipelineActive) {
                     this.abortForCopyInPipeline();
                     return;
@@ -1844,7 +1853,7 @@ export class PgConnection {
                 // rendered yet (see hunk 5722-5730 in regress/psql).
                 this.copyOutMidBatchActive = true;
                 q.current = q.current ?? {
-                    command: '',
+                    command: "",
                     rowCount: null,
                     oid: null,
                     fields: [],
@@ -1854,7 +1863,7 @@ export class PgConnection {
                 q.current.copyOutBytes = q.current.copyOutBytes ?? [];
                 return;
             }
-            case 'CopyData': {
+            case "CopyData": {
                 // CopyData arrives during execSimple only when we're in the mid-batch
                 // COPY-OUT phase (CopyOutResponse flipped the flag above). Stash the
                 // payload on the current result's `copyOutBytes` so the caller can
@@ -1868,12 +1877,12 @@ export class PgConnection {
                     return;
                 }
                 q.error = {
-                    severity: 'ERROR',
-                    message: 'Unexpected backend message during query: CopyData',
+                    severity: "ERROR",
+                    message: "Unexpected backend message during query: CopyData",
                 };
                 return;
             }
-            case 'CopyDone': {
+            case "CopyDone": {
                 // Server signals end of COPY-OUT data — next message will be
                 // CommandComplete for the COPY statement, then the batch resumes.
                 if (this.copyOutMidBatchActive) {
@@ -1881,12 +1890,12 @@ export class PgConnection {
                     return;
                 }
                 q.error = {
-                    severity: 'ERROR',
-                    message: 'Unexpected backend message during query: CopyDone',
+                    severity: "ERROR",
+                    message: "Unexpected backend message during query: CopyDone",
                 };
                 return;
             }
-            case 'CopyBothResponse': {
+            case "CopyBothResponse": {
                 // Walsender (`replication=database` / `replication=true`) commands
                 // such as `START_REPLICATION` transition the connection into a
                 // CopyBoth streaming phase (WAL records flowing from server +
@@ -1897,9 +1906,9 @@ export class PgConnection {
                 // message (matching the conformance assertion) and tear the socket
                 // down so the next query / process exit is clean.
                 const cbErr = {
-                    severity: 'ERROR',
-                    code: '0A000',
-                    message: 'syntax error: unexpected CopyBothResponse from server (replication streaming is not supported by this client)',
+                    severity: "ERROR",
+                    code: "0A000",
+                    message: "syntax error: unexpected CopyBothResponse from server (replication streaming is not supported by this client)",
                 };
                 q.error = cbErr;
                 q.reject(asThrowable(cbErr));
@@ -1911,14 +1920,14 @@ export class PgConnection {
                 catch {
                     // ignore
                 }
-                this.state = 'closed';
+                this.state = "closed";
                 return;
             }
             default:
                 // Unknown messages during a query are protocol errors but not fatal
                 // for the connection — record them.
                 q.error = {
-                    severity: 'ERROR',
+                    severity: "ERROR",
                     message: `Unexpected backend message during query: ${msg.type}`,
                 };
                 return;
@@ -1933,7 +1942,8 @@ export class PgConnection {
             messages = this.parser.feed(chunk);
         }
         catch (err) {
-            this.socketError = err instanceof Error ? err : new Error(String(err));
+            this.socketError =
+                err instanceof Error ? err : new Error(String(err));
             this.failPending(this.socketError);
             try {
                 this.socket.destroy();
@@ -1941,39 +1951,39 @@ export class PgConnection {
             catch {
                 // ignore
             }
-            this.state = 'closed';
+            this.state = "closed";
             return;
         }
         for (const msg of messages) {
             this.dispatch(msg);
-            if (this.state === 'closed')
+            if (this.state === "closed")
                 break;
         }
     }
     dispatch(msg) {
         // Async backend messages always allowed. NotificationResponse can arrive
         // in *any* state since LISTEN payloads come in whenever a NOTIFY fires.
-        if (msg.type === 'NotificationResponse') {
+        if (msg.type === "NotificationResponse") {
             this.notify.emitNotification(msg.channel, msg.payload, msg.processId);
             return;
         }
         switch (this.state) {
-            case 'auth':
+            case "auth":
                 this.handleAuthMessage(msg);
                 return;
-            case 'await-ready':
+            case "await-ready":
                 this.handleAwaitReady(msg);
                 return;
-            case 'idle':
+            case "idle":
                 // ParameterStatus changes can arrive asynchronously (SET).
-                if (msg.type === 'ParameterStatus') {
+                if (msg.type === "ParameterStatus") {
                     this.params.set(msg.name, msg.value);
-                    if (msg.name === 'server_version') {
+                    if (msg.name === "server_version") {
                         this.serverVersion = parseServerVersion(msg.value);
                     }
                     return;
                 }
-                if (msg.type === 'NoticeResponse') {
+                if (msg.type === "NoticeResponse") {
                     this.notify.emit(fieldsToNotice(msg.fields));
                     return;
                 }
@@ -1986,21 +1996,21 @@ export class PgConnection {
                 catch {
                     // ignore
                 }
-                this.state = 'closed';
+                this.state = "closed";
                 return;
-            case 'in-query':
+            case "in-query":
                 this.handleQueryMessage(msg);
                 return;
-            case 'in-extended':
+            case "in-extended":
                 this.handleExtendedMessage(msg);
                 return;
-            case 'in-copy-in':
+            case "in-copy-in":
                 this.handleCopyInMessage(msg);
                 return;
-            case 'in-copy-out':
+            case "in-copy-out":
                 this.handleCopyOutMessage(msg);
                 return;
-            case 'closed':
+            case "closed":
                 return;
         }
     }
@@ -2049,8 +2059,8 @@ export class PgConnection {
             this.copyOut = null;
             d.error =
                 err instanceof Error
-                    ? { severity: 'ERROR', message: err.message }
-                    : { severity: 'ERROR', message: String(err) };
+                    ? { severity: "ERROR", message: err.message }
+                    : { severity: "ERROR", message: String(err) };
             if (d.waker) {
                 const w = d.waker;
                 d.waker = null;
@@ -2059,10 +2069,10 @@ export class PgConnection {
         }
     }
     ensureIdle() {
-        if (this.state === 'closed') {
-            throw new Error('PgConnection: connection is closed');
+        if (this.state === "closed") {
+            throw new Error("PgConnection: connection is closed");
         }
-        if (this.state !== 'idle' && this.state !== 'in-extended') {
+        if (this.state !== "idle" && this.state !== "in-extended") {
             throw new Error(`PgConnection: cannot start query in state ${this.state}`);
         }
     }
@@ -2075,11 +2085,11 @@ export class PgConnection {
     // (Parse/Bind/Describe/Execute/Close/Sync) to the socket.
     // -------------------------------------------------------------------------
     startExtendedBatch() {
-        if (this.state === 'idle') {
-            this.state = 'in-extended';
+        if (this.state === "idle") {
+            this.state = "in-extended";
             this.extDriver = { queue: [], error: null };
         }
-        else if (this.state !== 'in-extended') {
+        else if (this.state !== "in-extended") {
             throw new Error(`PgConnection: cannot start extended batch in state ${this.state}`);
         }
         else if (!this.extDriver) {
@@ -2091,21 +2101,21 @@ export class PgConnection {
     }
     enqueueParse() {
         return this.enqueueOp({
-            kind: 'parse',
+            kind: "parse",
             resolve: () => undefined,
             reject: () => undefined,
         });
     }
     enqueueBind() {
         return this.enqueueOp({
-            kind: 'bind',
+            kind: "bind",
             resolve: () => undefined,
             reject: () => undefined,
         });
     }
     enqueueDescribeStatement() {
         return this.enqueueOp({
-            kind: 'describeS',
+            kind: "describeS",
             resolve: () => undefined,
             reject: () => undefined,
             paramOids: null,
@@ -2113,7 +2123,7 @@ export class PgConnection {
     }
     enqueueDescribePortal() {
         return this.enqueueOp({
-            kind: 'describeP',
+            kind: "describeP",
             resolve: () => undefined,
             reject: () => undefined,
         });
@@ -2125,15 +2135,15 @@ export class PgConnection {
     enqueueDescribePortalIntoNextExecute() {
         const driver = this.extDriver;
         if (!driver) {
-            return Promise.reject(new Error('enqueueDescribePortalIntoNextExecute: not in extended state'));
+            return Promise.reject(new Error("enqueueDescribePortalIntoNextExecute: not in extended state"));
         }
         return new Promise((resolve, reject) => {
             driver.queue.push({
-                kind: 'describeP',
+                kind: "describeP",
                 resolve: (v) => {
                     const fields = v;
                     for (const op of driver.queue) {
-                        if (op.kind === 'execute' && op.fields === null) {
+                        if (op.kind === "execute" && op.fields === null) {
                             op.fields = fields;
                             break;
                         }
@@ -2146,7 +2156,7 @@ export class PgConnection {
     }
     enqueueExecute() {
         return this.enqueueOp({
-            kind: 'execute',
+            kind: "execute",
             resolve: () => undefined,
             reject: () => undefined,
             current: null,
@@ -2156,7 +2166,7 @@ export class PgConnection {
     }
     enqueueExecuteWithFields(fields) {
         return this.enqueueOp({
-            kind: 'execute',
+            kind: "execute",
             resolve: () => undefined,
             reject: () => undefined,
             current: null,
@@ -2166,21 +2176,21 @@ export class PgConnection {
     }
     enqueueClose() {
         return this.enqueueOp({
-            kind: 'close',
+            kind: "close",
             resolve: () => undefined,
             reject: () => undefined,
         });
     }
     enqueueSync() {
         return this.enqueueOp({
-            kind: 'sync',
+            kind: "sync",
             resolve: () => undefined,
             reject: () => undefined,
         });
     }
     enqueueOp(opSkeleton) {
         if (!this.extDriver) {
-            return Promise.reject(new Error('enqueueOp: not in extended state'));
+            return Promise.reject(new Error("enqueueOp: not in extended state"));
         }
         const driver = this.extDriver;
         return new Promise((resolve, reject) => {
@@ -2194,26 +2204,26 @@ export class PgConnection {
         const driver = this.extDriver;
         if (!driver)
             return;
-        if (msg.type === 'ParameterStatus') {
+        if (msg.type === "ParameterStatus") {
             this.params.set(msg.name, msg.value);
-            if (msg.name === 'server_version') {
+            if (msg.name === "server_version") {
                 this.serverVersion = parseServerVersion(msg.value);
             }
             return;
         }
-        if (msg.type === 'NoticeResponse') {
+        if (msg.type === "NoticeResponse") {
             const notice = fieldsToNotice(msg.fields);
             this.notify.emit(notice);
             const head = driver.queue[0];
-            if (head && head.kind === 'execute')
+            if (head && head.kind === "execute")
                 head.notices.push(notice);
             return;
         }
-        if (msg.type === 'NotificationResponse') {
+        if (msg.type === "NotificationResponse") {
             this.notify.emitNotification(msg.channel, msg.payload, msg.processId);
             return;
         }
-        if (msg.type === 'ErrorResponse') {
+        if (msg.type === "ErrorResponse") {
             driver.error = fieldsToConnectError(msg.fields);
             // Reject ALL queued non-sync ops eagerly. Upstream server semantics:
             // once a P/B/D/E op errors, the server skips every subsequent message
@@ -2231,7 +2241,7 @@ export class PgConnection {
             let first = true;
             while (driver.queue.length > 0) {
                 const head = driver.queue[0];
-                if (head.kind === 'sync')
+                if (head.kind === "sync")
                     break;
                 driver.queue.shift();
                 if (first) {
@@ -2252,7 +2262,7 @@ export class PgConnection {
         // and tears the connection down. Mirror that so `\startpipeline +
         // COPY ...` surfaces the expected fatal error rather than hanging
         // on a response the extended driver doesn't know how to consume.
-        if (msg.type === 'CopyInResponse' || msg.type === 'CopyOutResponse') {
+        if (msg.type === "CopyInResponse" || msg.type === "CopyOutResponse") {
             this.abortForCopyInPipeline();
             return;
         }
@@ -2269,7 +2279,7 @@ export class PgConnection {
         // `Pipeline aborted, command did not run` (no `ERROR:` prefix).
         while (driver.error !== null) {
             const head = driver.queue[0];
-            if (!head || head.kind === 'sync')
+            if (!head || head.kind === "sync")
                 break;
             driver.queue.shift();
             head.reject(pipelineAbortedError());
@@ -2280,39 +2290,40 @@ export class PgConnection {
             return;
         }
         switch (msg.type) {
-            case 'ParseComplete':
-                if (head.kind !== 'parse') {
-                    this.protocolFail(new Error('ParseComplete arrived but head op is ' + head.kind));
+            case "ParseComplete":
+                if (head.kind !== "parse") {
+                    this.protocolFail(new Error("ParseComplete arrived but head op is " + head.kind));
                     return;
                 }
                 driver.queue.shift();
                 head.resolve(undefined);
                 return;
-            case 'BindComplete':
-                if (head.kind !== 'bind') {
-                    this.protocolFail(new Error('BindComplete arrived but head op is ' + head.kind));
+            case "BindComplete":
+                if (head.kind !== "bind") {
+                    this.protocolFail(new Error("BindComplete arrived but head op is " + head.kind));
                     return;
                 }
                 driver.queue.shift();
                 head.resolve(undefined);
                 return;
-            case 'CloseComplete':
-                if (head.kind !== 'close') {
-                    this.protocolFail(new Error('CloseComplete arrived but head op is ' + head.kind));
+            case "CloseComplete":
+                if (head.kind !== "close") {
+                    this.protocolFail(new Error("CloseComplete arrived but head op is " + head.kind));
                     return;
                 }
                 driver.queue.shift();
                 head.resolve(undefined);
                 return;
-            case 'ParameterDescription':
-                if (head.kind !== 'describeS') {
-                    this.protocolFail(new Error('ParameterDescription arrived but head op is ' + head.kind));
+            case "ParameterDescription":
+                if (head.kind !== "describeS") {
+                    this.protocolFail(new Error("ParameterDescription arrived but head op is " +
+                        head.kind));
                     return;
                 }
                 head.paramOids = msg.oids;
                 return;
-            case 'RowDescription':
-                if (head.kind === 'describeS') {
+            case "RowDescription":
+                if (head.kind === "describeS") {
                     driver.queue.shift();
                     head.resolve({
                         paramOids: head.paramOids ?? [],
@@ -2320,14 +2331,14 @@ export class PgConnection {
                     });
                     return;
                 }
-                if (head.kind === 'describeP') {
+                if (head.kind === "describeP") {
                     driver.queue.shift();
                     head.resolve(msg.fields);
                     return;
                 }
-                if (head.kind === 'execute') {
+                if (head.kind === "execute") {
                     head.current = {
-                        command: '',
+                        command: "",
                         rowCount: null,
                         oid: null,
                         fields: msg.fields,
@@ -2337,30 +2348,33 @@ export class PgConnection {
                     head.fields = msg.fields;
                     return;
                 }
-                this.protocolFail(new Error('Unexpected RowDescription at head op ' + head.kind));
+                this.protocolFail(new Error("Unexpected RowDescription at head op " + head.kind));
                 return;
-            case 'NoData':
-                if (head.kind === 'describeS') {
+            case "NoData":
+                if (head.kind === "describeS") {
                     driver.queue.shift();
-                    head.resolve({ paramOids: head.paramOids ?? [], fields: [] });
+                    head.resolve({
+                        paramOids: head.paramOids ?? [],
+                        fields: [],
+                    });
                     return;
                 }
-                if (head.kind === 'describeP') {
+                if (head.kind === "describeP") {
                     driver.queue.shift();
                     head.resolve([]);
                     return;
                 }
-                this.protocolFail(new Error('Unexpected NoData at head op ' + head.kind));
+                this.protocolFail(new Error("Unexpected NoData at head op " + head.kind));
                 return;
-            case 'DataRow': {
-                if (head.kind !== 'execute') {
-                    this.protocolFail(new Error('DataRow at head op ' + head.kind));
+            case "DataRow": {
+                if (head.kind !== "execute") {
+                    this.protocolFail(new Error("DataRow at head op " + head.kind));
                     return;
                 }
                 const fields = head.fields ?? head.current?.fields ?? [];
                 if (!head.current) {
                     head.current = {
-                        command: '',
+                        command: "",
                         rowCount: null,
                         oid: null,
                         fields,
@@ -2371,9 +2385,9 @@ export class PgConnection {
                 head.current.rows.push(decodeDataRow(msg.values, fields));
                 return;
             }
-            case 'CommandComplete': {
-                if (head.kind !== 'execute') {
-                    this.protocolFail(new Error('CommandComplete at head op ' + head.kind));
+            case "CommandComplete": {
+                if (head.kind !== "execute") {
+                    this.protocolFail(new Error("CommandComplete at head op " + head.kind));
                     return;
                 }
                 const { command, rowCount, oid } = parseCommandTag(msg.tag);
@@ -2393,13 +2407,13 @@ export class PgConnection {
                 head.resolve(set);
                 return;
             }
-            case 'EmptyQueryResponse': {
-                if (head.kind !== 'execute') {
-                    this.protocolFail(new Error('EmptyQueryResponse at head op ' + head.kind));
+            case "EmptyQueryResponse": {
+                if (head.kind !== "execute") {
+                    this.protocolFail(new Error("EmptyQueryResponse at head op " + head.kind));
                     return;
                 }
                 const set = {
-                    command: '',
+                    command: "",
                     rowCount: null,
                     oid: null,
                     fields: [],
@@ -2410,13 +2424,13 @@ export class PgConnection {
                 head.resolve(set);
                 return;
             }
-            case 'PortalSuspended': {
-                if (head.kind !== 'execute') {
-                    this.protocolFail(new Error('PortalSuspended at head op ' + head.kind));
+            case "PortalSuspended": {
+                if (head.kind !== "execute") {
+                    this.protocolFail(new Error("PortalSuspended at head op " + head.kind));
                     return;
                 }
                 const set = head.current ?? {
-                    command: '',
+                    command: "",
                     rowCount: null,
                     oid: null,
                     fields: head.fields ?? [],
@@ -2428,10 +2442,10 @@ export class PgConnection {
                 head.resolve(set);
                 return;
             }
-            case 'ReadyForQuery': {
+            case "ReadyForQuery": {
                 this.txStatus = msg.status;
-                if (head.kind !== 'sync') {
-                    this.protocolFail(new Error('ReadyForQuery but head op is ' + head.kind));
+                if (head.kind !== "sync") {
+                    this.protocolFail(new Error("ReadyForQuery but head op is " + head.kind));
                     return;
                 }
                 driver.queue.shift();
@@ -2444,7 +2458,7 @@ export class PgConnection {
                     head.resolve(undefined);
                 }
                 if (driver.queue.length === 0 && !this._extPipelineActive) {
-                    this.state = 'idle';
+                    this.state = "idle";
                     this.extDriver = null;
                 }
                 return;
@@ -2463,7 +2477,7 @@ export class PgConnection {
         catch {
             // ignore
         }
-        this.state = 'closed';
+        this.state = "closed";
     }
     /**
      * Abort the connection because the server replied with CopyInResponse /
@@ -2476,8 +2490,8 @@ export class PgConnection {
      */
     abortForCopyInPipeline() {
         const err = {
-            severity: 'FATAL',
-            message: 'COPY in a pipeline is not supported, aborting connection',
+            severity: "FATAL",
+            message: "COPY in a pipeline is not supported, aborting connection",
         };
         this.socketError = new Error(err.message);
         this.failPending(err);
@@ -2487,7 +2501,7 @@ export class PgConnection {
         catch {
             // ignore
         }
-        this.state = 'closed';
+        this.state = "closed";
     }
 }
 // -------------------------------------------------------------------------
@@ -2522,7 +2536,7 @@ PgConnection._dnsLookupAll = null;
  * directory. libpq's rule: any value starting with `/` is a path.
  */
 export function isUnixSocketHost(host) {
-    return host.startsWith('/');
+    return host.startsWith("/");
 }
 /**
  * Build the actual filesystem path Postgres listens on under a socket
@@ -2594,10 +2608,10 @@ async function expandHostsViaDns(seed) {
  */
 function toSecureVersion(value) {
     switch (value) {
-        case 'TLSv1':
-        case 'TLSv1.1':
-        case 'TLSv1.2':
-        case 'TLSv1.3':
+        case "TLSv1":
+        case "TLSv1.1":
+        case "TLSv1.2":
+        case "TLSv1.3":
             return value;
         default:
             return undefined;
@@ -2666,13 +2680,13 @@ export function keepAliveArgs(opts) {
  */
 export function sslKeyBitsFromCipher(name) {
     const upper = name.toUpperCase();
-    if (upper.includes('CHACHA20'))
+    if (upper.includes("CHACHA20"))
         return 256;
-    if (upper.includes('AES_256') || upper.includes('AES256'))
+    if (upper.includes("AES_256") || upper.includes("AES256"))
         return 256;
-    if (upper.includes('AES_128') || upper.includes('AES128'))
+    if (upper.includes("AES_128") || upper.includes("AES128"))
         return 128;
-    if (upper.includes('AES_192') || upper.includes('AES192'))
+    if (upper.includes("AES_192") || upper.includes("AES192"))
         return 192;
     const digits = /(\d{2,4})/.exec(upper);
     if (digits) {
@@ -2720,8 +2734,8 @@ addressOverride) {
         const cleanup = () => {
             if (timer)
                 clearTimeout(timer);
-            socket.removeListener('error', onError);
-            socket.removeListener('connect', onConnect);
+            socket.removeListener("error", onError);
+            socket.removeListener("connect", onConnect);
         };
         const onError = (err) => {
             cleanup();
@@ -2731,8 +2745,8 @@ addressOverride) {
             cleanup();
             resolve(socket);
         };
-        socket.once('error', onError);
-        socket.once('connect', onConnect);
+        socket.once("error", onError);
+        socket.once("connect", onConnect);
     });
 }
 // ---------------------------------------------------------------------------
@@ -2753,7 +2767,7 @@ function decodeDataRow(values, fields) {
             continue;
         }
         const fmt = fields[i]?.format ?? 0;
-        out[i] = fmt === 1 ? v : v.toString('utf8');
+        out[i] = fmt === 1 ? v : v.toString("utf8");
     }
     return out;
 }
@@ -2772,7 +2786,7 @@ function parseCommandTag(tag) {
     const insertMatch = /^INSERT (\d+) (\d+)$/.exec(trimmed);
     if (insertMatch) {
         return {
-            command: 'INSERT',
+            command: "INSERT",
             oid: parseInt(insertMatch[1], 10),
             rowCount: parseInt(insertMatch[2], 10),
         };
@@ -2797,17 +2811,17 @@ export function encodeParams(values) {
             return null;
         if (Buffer.isBuffer(v))
             return v;
-        if (typeof v === 'string')
+        if (typeof v === "string")
             return v;
-        if (typeof v === 'boolean')
-            return v ? 't' : 'f';
-        if (typeof v === 'number' || typeof v === 'bigint')
+        if (typeof v === "boolean")
+            return v ? "t" : "f";
+        if (typeof v === "number" || typeof v === "bigint")
             return v.toString();
         try {
             return JSON.stringify(v);
         }
         catch {
-            return '';
+            return "";
         }
     });
 }
@@ -2824,16 +2838,16 @@ export function encodeParams(values) {
 function asThrowable(v) {
     if (v instanceof Error)
         return v;
-    if (typeof v === 'object' &&
+    if (typeof v === "object" &&
         v !== null &&
-        'message' in v &&
-        typeof v.message === 'string') {
+        "message" in v &&
+        typeof v.message === "string") {
         const source = v;
         const err = new Error(source.message);
         // Copy every own enumerable field (severity, code, detail, hint, …) onto
         // the Error so structural consumers keep working.
         for (const key of Object.keys(source)) {
-            if (key === 'message')
+            if (key === "message")
                 continue;
             err[key] = source[key];
         }