@m2k-5f/pgtx 2.4.0 → 2.5.0

package/dist/pool.js

@@ -1,6 +1,8 @@
 import { Connection } from "./connection";
 import { Queue } from "./queue";
-import { Future, Resolve } from "fluent-future";
+import { Begin, Future, Resolve } from "fluent-future";
+import { PostgresError } from "./error";
+const ErrPoolClosed = new PostgresError('Pool closed');
 /**
  * The main entry point for Pgtx.
  * Manages a connection pool and provides high-level API for queries and transactions.
@@ -70,8 +72,7 @@ export class Pool {
     acquire() {
         this._checkClosed();
         while (this._available.hasMore) {
-            const conn = this._available.get();
-            this._available.next();
+            const conn = this._available.shift;
             if (conn.isOpened) {
                 return Resolve(conn);
             }
@@ -79,12 +80,36 @@ export class Pool {
         }
         if (this._total < this._max) {
             this._total++;
-            return Future.of(Connection.new(this._config))
+            return Connection.new(this._config)
                 .tapErr(() => this._total--);
         }
-        return Future.of(new Promise((resolve, reject) => {
-            this._waiting.push({ resolve, reject });
-        }));
+        const { future, reject, resolve } = Future.withResolvers();
+        this._waiting.push({ resolve, reject });
+        return future;
+    }
+    /**
+     * Provides a safe execution context for performing low-level operations
+     * directly on a single, dedicated `Connection` instance.
+     *
+     * Automatically borrows a free socket from the pool, forwards it to the provided callback function,
+     * and guarantees that the connection is released back to the pool once the execution completes,
+     * even if errors or unexpected exceptions are thrown. Prevents connection descriptor leaks.
+     *
+     * @template T The return type of the provided callback function.
+     * @param {(conn: Connection) => Promise<T>} fn A callback function that operates on the allocated Connection.
+     * @returns {Future<T, PostgresError>} A `Future` that resolves with the return value of the callback.
+     *
+     * @example
+     * // Executing low-level engine commands on a single, pinned connection
+     * const status = await pool.withAcquire(async (conn) => {
+     *     return await conn.query`SELECT pg_is_in_recovery()`;
+     * });
+     */
+    withAcquire(fn) {
+        return Begin()
+            .andThen(() => this.acquire())
+            .andThen(conn => Future.of(fn(conn))
+            .finally(() => this.release(conn)));
     }
     /**
      * Releases the connection back to the pool.
@@ -111,9 +136,7 @@ export class Pool {
             return;
         }
         if (this._waiting.hasMore) {
-            const waiter = this._waiting.get();
-            this._waiting.next();
-            waiter.resolve(conn);
+            this._waiting.shift.resolve(conn);
             return;
         }
         this._available.push(conn);
@@ -138,7 +161,8 @@ export class Pool {
      */
     begin(txCallback) {
         this._checkClosed();
-        return this.acquire()
+        return Begin()
+            .andThen(() => this.acquire())
             .andThen(conn => conn.begin(txCallback)
             .finally(() => this.release(conn)));
     }
@@ -168,8 +192,7 @@ export class Pool {
     query(templates, ...args) {
         this._checkClosed();
         while (this._available.hasMore) {
-            const conn = this._available.get();
-            this._available.next();
+            const conn = this._available.shift;
             if (!conn.isOpened) {
                 this._total--;
                 continue;
@@ -177,21 +200,64 @@ export class Pool {
             this._available.push(conn);
             return conn.query(templates, ...args);
         }
-        if (this._total < this._max) {
-            this._total++;
-            return Future.of(Connection.new(this._config))
-                .tapErr(() => this._total--)
-                .andThen(conn => {
-                this.release(conn);
-                return conn.query(templates, ...args);
-            });
-        }
         return this.acquire()
             .andThen(conn => {
             this.release(conn);
             return conn.query(templates, ...args);
         });
     }
+    /**
+     * Executes an SQL query in streaming mode.
+     *
+     * Data is streamed directly from the PostgreSQL binary network buffer into the Web Streams API
+     * (`ReadableStream`), bypassing any intermediate array allocation or row accumulation in the JS heap.
+     * This pattern provides a true Zero-Memory Footprint and is ideal for exporting massive tables
+     * or piping database payloads directly into HTTP responses (e.g., via `Bun.serve` or fetch `Response`).
+     *
+     * @template T The expected shape of a single row interface.
+     * @param {TemplateStringsArray} templates The SQL string parts from the tagged template literal.
+     * @param {...any} args The parameterized query arguments.
+     * @returns {ReadableStream<T>} Synchronously returns a native Web ReadableStream instance.
+     *
+     * @example
+     * // Streaming a giant table directly to an HTTP response (Bun.serve)
+     * const userStream = pool.stream<User>`SELECT id, name FROM users`;
+     * return new Response(userStream, { headers: { 'Content-Type': 'application/json' } });
+     *
+     * @example
+     * // Asynchronously iterating over rows as they arrive from the wire socket
+     * const stream = pool.stream<User>`SELECT * FROM orders WHERE status = ${'processed'}`;
+     * for await (const row of stream) {
+     *     console.log(row.id, row.amount); // Row object is eligible for GC immediately after iteration
+     * }
+     */
+    stream(templates, ...args) {
+        this._checkClosed();
+        while (this._available.hasMore) {
+            const conn = this._available.shift;
+            if (!conn.isOpened) {
+                this._total--;
+                continue;
+            }
+            this._available.push(conn);
+            return conn.stream(templates, ...args);
+        }
+        let controller;
+        const stream = new ReadableStream({
+            start: c => {
+                controller = c;
+            }
+        });
+        this.acquire()
+            .tap(conn => {
+            this.release(conn);
+            conn['_streamWithController'](templates, args, controller);
+        })
+            .catch(err => {
+            controller.error(err);
+        });
+        return stream;
+    }
     /**
      * Sends an asynchronous notification to a channel via `pg_notify`.
      *
@@ -206,6 +272,38 @@ export class Pool {
     notify(channelName, payload = "") {
         return this.query `select pg_notify(${channelName}, ${payload})`;
     }
+    /**
+     * Asynchronously subscribes to pub/sub events on a specific PostgreSQL channel (LISTEN).
+     *
+     * This method automatically claims a dedicated connection from the pool, registers the callback
+     * to handle incoming asynchronous database notices (`NotificationResponse` packets), and returns
+     * a lazy unsubscribe function wrapped in a `Future`.
+     *
+     * Invoking the returned unsubscribe function will automatically issue the `UNLISTEN` command
+     * to the database backend, clean up the memory callback, and safely release the connection back to the pool.
+     *
+     * @param {string} channel The name of the PostgreSQL notification channel.
+     * @param {(payload: string) => void} callback The event handler invoked when a NOTIFY message arrives.
+     * @returns {Future<() => Promise<void>, PostgresError>} A `Future` resolving to an async unsubscribe function.
+     *
+     * @example
+     * // Subscribing to database events directly from the Pool
+     * const unlisten = await pool.listen('order_created', (payload) => {
+     *     const order = JSON.parse(payload);
+     *     console.log(`New order received: ${order.id}`);
+     * });
+     *
+     * // When the subscription is no longer needed (e.g., during teardown or server stop):
+     * await unlisten(); // The socket cleanly issues UNLISTEN and returns to the pool of free connections.
+     */
+    listen(channel, callback) {
+        return this.acquire()
+            .andThen(conn => conn.listen(channel, callback)
+            .map(() => async () => {
+            await conn.unlisten(channel, callback);
+            this.release(conn);
+        }));
+    }
     /**
      * Number of available (idle) connections in the pool.
      */
@@ -232,14 +330,10 @@ export class Pool {
      */
     close() {
         while (this._available.hasMore) {
-            const conn = this._available.get();
-            this._available.next();
-            conn.close();
+            this._available.shift.close();
         }
         while (this._waiting.hasMore) {
-            const waiter = this._waiting.get();
-            this._waiting.next();
-            waiter.reject(new Error('Pool closed'));
+            this._waiting.shift.reject(ErrPoolClosed);
         }
         this._total = 0;
     }

package/dist/protocol/connection-response-reader.d.ts

@@ -32,7 +32,10 @@ export declare class ConnectionResponseReader {
     private currentPacketLength;
     private constructor();
     static from(buffer: Buffer): ConnectionResponseReader;
-    readType(): ResponseType;
+    readType(): {
+        type: ResponseType;
+        length: number;
+    };
     readAuthentication(): AuthenticationCode;
     readMD5Salt(): Buffer<ArrayBufferLike>;
     readParameterStatus(): {
@@ -46,7 +49,7 @@ export declare class ConnectionResponseReader {
     readErrorResponse(): PostgresError;
     readReadyForQuery(): TransactionStatus;
     readSaslMechanisms(): string[];
-    readSaslMessage(): string;
+    readSaslMessage(length: number): string;
     readRowDescription(): ColumnDescription[];
     readDataRow(descriptions: ColumnDescription[], int8toBigint?: boolean): Record<string, any>;
     readNotificationResponse(): {

package/dist/protocol/connection-response-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-response-reader.d.ts","sourceRoot":"","sources":["../../src/protocol/connection-response-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA6B,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAM3C,qBAAa,wBAAwB;IAI7B,OAAO,CAAC,MAAM;IAHlB,OAAO,CAAC,KAAK,CAAI;IAEjB,OAAO;IAKP,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM;IAK1B,QAAQ,IAAI,MAAM;IAOlB,SAAS,IAAI,MAAM;IAOnB,SAAS,IAAI,MAAM;IAOnB,WAAW,IAAI,MAAM;IAQrB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOjC,OAAO,IAAI,OAAO;IAKlB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAO3C,cAAc,IAAI,IAAI;IAOtB,mBAAmB,IAAI,IAAI;IAO3B,cAAc,IAAI,MAAM;IAaxB,SAAS,CAAC,SAAS,EAAE,MAAM;IAK3B,aAAa,IAAI,OAAO;IAaxB,iBAAiB;IAIjB,QAAQ;IAMR,YAAY,IAAI,MAAM;IAOtB,SAAS;IAST,WAAW,IAAI,MAAM;IAMrB,aAAa,CAAC,MAAM,EAAE,MAAM;CAW/B;AAGD,qBAAa,wBAAwB;IAI7B,OAAO,CAAC,MAAM;IAHlB,OAAO,CAAC,mBAAmB,CAAK;IAEhC,OAAO;IAKP,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM;IAK1B,QAAQ,IAC6B,YAAY;IAIjD,kBAAkB,IAGoB,kBAAkB;IAIxD,WAAW;IAKX,mBAAmB;;;;IAUnB,kBAAkB;;;;IAUlB,iBAAiB,IAAI,aAAa;IA8ClC,iBAAiB,IAEoB,iBAAiB;IAItD,kBAAkB,IAAI,MAAM,EAAE;IAa9B,eAAe,IAAI,MAAM;IAOzB,kBAAkB;IAuBlB,WAAW,CAAC,YAAY,EAAE,iBAAiB,EAAE,EAAE,YAAY,GAAE,OAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA8FlG,wBAAwB;;;;IAUxB,mBAAmB,IAAI,MAAM;IAM7B,OAAO;IAKP,aAAa;IAKb,iBAAiB;IAKjB,iBAAiB;IAKjB,gBAAgB;IAKhB,wBAAwB;IAQxB,UAAU;CAGb"}
+{"version":3,"file":"connection-response-reader.d.ts","sourceRoot":"","sources":["../../src/protocol/connection-response-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA6B,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAM3C,qBAAa,wBAAwB;IAI7B,OAAO,CAAC,MAAM;IAHlB,OAAO,CAAC,KAAK,CAAI;IAEjB,OAAO;IAKP,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM;IAK1B,QAAQ,IAAI,MAAM;IAOlB,SAAS,IAAI,MAAM;IAOnB,SAAS,IAAI,MAAM;IAOnB,WAAW,IAAI,MAAM;IAQrB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOjC,OAAO,IAAI,OAAO;IAKlB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAO3C,cAAc,IAAI,IAAI;IAOtB,mBAAmB,IAAI,IAAI;IAO3B,cAAc,IAAI,MAAM;IAaxB,SAAS,CAAC,SAAS,EAAE,MAAM;IAK3B,aAAa,IAAI,OAAO;IAaxB,iBAAiB;IAIjB,QAAQ;IAMR,YAAY,IAAI,MAAM;IAOtB,SAAS;IAST,WAAW,IAAI,MAAM;IAMrB,aAAa,CAAC,MAAM,EAAE,MAAM;CAW/B;AAGD,qBAAa,wBAAwB;IAI7B,OAAO,CAAC,MAAM;IAHlB,OAAO,CAAC,mBAAmB,CAAK;IAEhC,OAAO;IAKP,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM;IAK1B,QAAQ;cACoC,YAAY;;;IAIxD,kBAAkB,IACoB,kBAAkB;IAIxD,WAAW;IAKX,mBAAmB;;;;IAQnB,kBAAkB;;;;IAQlB,iBAAiB,IAAI,aAAa;IA4ClC,iBAAiB,IACoB,iBAAiB;IAItD,kBAAkB,IAAI,MAAM,EAAE;IAa9B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAKvC,kBAAkB;IAsBlB,WAAW,CAAC,YAAY,EAAE,iBAAiB,EAAE,EAAE,YAAY,GAAE,OAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA6FlG,wBAAwB;;;;IASxB,mBAAmB,IAAI,MAAM;IAK7B,OAAO;IAKP,aAAa;IAKb,iBAAiB;IAKjB,iBAAiB;IAGjB,gBAAgB;IAGhB,wBAAwB;IAOxB,UAAU;CACb"}

package/dist/protocol/connection-response-reader.js

@@ -123,31 +123,27 @@ export class ConnectionResponseReader {
         return new ConnectionResponseReader(ConnectionResponseBuffer.from(buffer));
     }
     readType() {
-        return this.buffer.readChar();
+        return { type: this.buffer.readChar(), length: this.buffer.readInt32() };
     }
     readAuthentication() {
-        this.currentPacketLength = this.buffer.readInt32();
         return this.buffer.readInt32();
     }
     readMD5Salt() {
         return this.buffer.readBytes(4);
     }
     readParameterStatus() {
-        this.buffer.readInt32();
         return {
             name: this.buffer.readCString(),
             value: this.buffer.readCString()
         };
     }
     readBackendKeyData() {
-        this.buffer.readInt32();
         return {
             PID: this.buffer.readInt32(),
             secret: this.buffer.readInt32()
         };
     }
     readErrorResponse() {
-        this.buffer.readInt32();
         let severity = '';
         let code = '';
         let message = '';
@@ -195,7 +191,6 @@ export class ConnectionResponseReader {
         return new PostgresError(message, code, detail, severity, where, hint, position, dataType, constraint);
     }
     readReadyForQuery() {
-        this.buffer.readInt32();
         return this.buffer.readChar();
     }
     readSaslMechanisms() {
@@ -208,12 +203,10 @@ export class ConnectionResponseReader {
         }
         return mechanisms;
     }
-    readSaslMessage() {
-        const dataLength = this.currentPacketLength - 4 - 4;
-        return this.buffer.readRawString(dataLength);
+    readSaslMessage(length) {
+        return this.buffer.readRawString(length - 4 - 4);
     }
     readRowDescription() {
-        this.buffer.skipBytes(4);
         const columnsCount = this.buffer.readInt16();
         const columns = new Array(columnsCount);
         for (let i = 0; i < columnsCount; i++) {
@@ -230,7 +223,6 @@ export class ConnectionResponseReader {
         return columns;
     }
     readDataRow(descriptions, int8toBigint = false) {
-        this.buffer.skipBytes(4);
         const fieldsCount = this.buffer.readInt16();
         const row = {};
         for (let i = 0; i < fieldsCount; i++) {
@@ -311,14 +303,12 @@ export class ConnectionResponseReader {
         return row;
     }
     readNotificationResponse() {
-        this.buffer.readInt32();
         this.buffer.readInt32();
         const name = this.buffer.readCString();
         const payload = this.buffer.readCString();
         return { name, payload };
     }
     readCommandComplete() {
-        this.buffer.readInt32();
         return this.buffer.readCString();
     }
     hasMore() {
@@ -330,20 +320,13 @@ export class ConnectionResponseReader {
     getResidualBuffer() {
         return this.buffer.getResidualBuffer();
     }
-    readParseComplete() {
-        this.buffer.readInt32();
-    }
-    readBindComplete() {
-        this.buffer.readInt32();
-    }
+    readParseComplete() { }
+    readBindComplete() { }
     readParameterDescription() {
-        this.buffer.readInt32();
         const count = this.buffer.readInt16();
         for (let i = 0; i < count; i++) {
             this.buffer.readInt32();
         }
     }
-    readNoData() {
-        this.buffer.readInt32();
-    }
+    readNoData() { }
 }

package/dist/protocol/socket-authorization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-authorization.d.ts","sourceRoot":"","sources":["../../src/protocol/socket-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,MAAM,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAKrE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAGtC,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAGD,eAAO,MAAM,gBAAgB,eAAmF,CAAA;AAChH,eAAO,MAAM,mBAAmB,eAAqE,CAAA;AAIrG,eAAO,MAAM,sBAAsB,GAAI,QAAQ,uBAAuB,EAAE,QAAQ,mBAAmB,kCAwHlG,CAAA"}
+{"version":3,"file":"socket-authorization.d.ts","sourceRoot":"","sources":["../../src/protocol/socket-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,MAAM,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAKrE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAGtC,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAGD,eAAO,MAAM,gBAAgB,eAAmF,CAAA;AAChH,eAAO,MAAM,mBAAmB,eAAqE,CAAA;AAIrG,eAAO,MAAM,sBAAsB,GAAI,QAAQ,uBAAuB,EAAE,QAAQ,mBAAmB,kCAyHlG,CAAA"}

package/dist/protocol/socket-authorization.js

@@ -13,7 +13,7 @@ export const createAuthorizedSocket = (writer, params) => {
         let clientMessage = '';
         let serverMessage = '';
         const socket = createConnection({ host: params.host, port: params.port });
-        const connector = new SocketConnector(socket, (type, reader) => {
+        const connector = new SocketConnector(socket, (type, length, reader) => {
             writer.clear();
             switch (type) {
                 case ResponseTypes.Authentication: {
@@ -42,7 +42,7 @@ export const createAuthorizedSocket = (writer, params) => {
                             break;
                         }
                         case AuthenticationCodes.SASLContinue: {
-                            serverMessage = reader.readSaslMessage();
+                            serverMessage = reader.readSaslMessage(length);
                             if (!params.password)
                                 throw ErrPasswordRequired;
                             const parts = Object.fromEntries(serverMessage.split(',').map(x => x.split('=')));
@@ -61,7 +61,7 @@ export const createAuthorizedSocket = (writer, params) => {
                             break;
                         }
                         case AuthenticationCodes.SASLFinal: {
-                            reader.readSaslMessage();
+                            reader.readSaslMessage(length);
                             break;
                         }
                     }

package/dist/protocol/socket-connector.d.ts

@@ -8,7 +8,7 @@ export declare class SocketConnector {
     private _onError;
     private residualBuffer;
     private _isDestroyed;
-    constructor(_socket: Socket, _onData: (type: ResponseType, reader: ConnectionResponseReader) => void, _onError: (error: Error) => void);
+    constructor(_socket: Socket, _onData: (type: ResponseType, length: number, reader: ConnectionResponseReader) => void, _onError: (error: Error) => void);
     write(writer: ConnectionRequestWriter): void;
     unwrapSocket(): Socket;
     destroy(): void;

package/dist/protocol/socket-connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-connector.d.ts","sourceRoot":"","sources":["../../src/protocol/socket-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAA;AAE/E,qBAAa,eAAe;IAKpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IANpB,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,YAAY,CAAQ;gBAGhB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,wBAAwB,KAAK,IAAI,EACvE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI;IA6B5C,KAAK,CAAC,MAAM,EAAE,uBAAuB;IAOrC,YAAY;IAQZ,OAAO;IAMP,IAAI,WAAW,YAA6B;CAC/C"}
+{"version":3,"file":"socket-connector.d.ts","sourceRoot":"","sources":["../../src/protocol/socket-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAA;AAE/E,qBAAa,eAAe;IAKpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IANpB,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,YAAY,CAAQ;gBAGhB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,KAAK,IAAI,EACvF,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI;IA8B5C,KAAK,CAAC,MAAM,EAAE,uBAAuB;IAOrC,YAAY;IAQZ,OAAO;IAMP,IAAI,WAAW,YAA6B;CAC/C"}

package/dist/protocol/socket-connector.js

@@ -18,7 +18,8 @@ export class SocketConnector {
                     this.residualBuffer = reader.getResidualBuffer();
                     return;
                 }
-                this._onData(reader.readType(), reader);
+                const { type, length } = reader.readType();
+                this._onData(type, length, reader);
             }
         });
         _socket.on('error', error => {

package/dist/query.d.ts

@@ -1,5 +1,7 @@
+import { Future } from "fluent-future";
 import { QueryText, StatementName } from "./connection";
 import { ColumnDescription, ValueOF } from "./types";
+import { PostgresError } from "./error";
 export declare const QueryState: {
     readonly Parsing: 0;
     readonly Describing: 1;
@@ -14,14 +16,31 @@ export declare class Query<T> {
     state: State;
     statementName: StatementName;
     columns?: ColumnDescription[] | undefined;
-    promise: Promise<T[]>;
+    future: Future<T[], PostgresError>;
     private _resolve;
     private _reject;
     private _rows;
+    private _timer?;
     constructor(text: QueryText, args: (string | null)[], state: State, statementName: StatementName, columns?: ColumnDescription[] | undefined);
+    startTimeout(timeout: number): void;
     setState(state: State): void;
     push(value: T): void;
-    reject(cause: Error): void;
+    reject(cause: PostgresError): void;
+    resolve(): void;
+}
+export declare class StreamQuery<T> {
+    text: QueryText;
+    args: (string | null)[];
+    state: State;
+    statementName: StatementName;
+    private _controller;
+    columns?: ColumnDescription[] | undefined;
+    private _timer?;
+    constructor(text: QueryText, args: (string | null)[], state: State, statementName: StatementName, _controller: ReadableStreamDefaultController<T>, columns?: ColumnDescription[] | undefined);
+    setState(state: State): void;
+    startTimeout(timeout: number): void;
+    push(value: T): void;
+    reject(cause: PostgresError): void;
     resolve(): void;
 }
 //# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGrD,eAAO,MAAM,UAAU;;;;;;CAMb,CAAA;AAGV,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,UAAU,CAAC,CAAA;AAG9C,qBAAa,KAAK,CAAC,CAAC;IAOL,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE;IACvB,KAAK,EAAE,KAAK;IACZ,aAAa,EAAE,aAAa;IAC5B,OAAO,CAAC,EAAE,iBAAiB,EAAE;IAVxC,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IACrB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,KAAK,CAAU;gBAGZ,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EACvB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,iBAAiB,EAAE,YAAA;IASxC,QAAQ,CAAC,KAAK,EAAE,KAAK;IAKrB,IAAI,CAAC,KAAK,EAAE,CAAC;IAKb,MAAM,CAAC,KAAK,EAAE,KAAK;IAKnB,OAAO;CAGV"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,eAAO,MAAM,UAAU;;;;;;CAMb,CAAA;AAGV,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,UAAU,CAAC,CAAA;AAG9C,qBAAa,KAAK,CAAC,CAAC;IASL,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE;IACvB,KAAK,EAAE,KAAK;IACZ,aAAa,EAAE,aAAa;IAC5B,OAAO,CAAC,EAAE,iBAAiB,EAAE;IAZxC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,aAAa,CAAC,CAAA;IAClC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,KAAK,CAAU;IAEvB,OAAO,CAAC,MAAM,CAAC,CAAgB;gBAGpB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EACvB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,iBAAiB,EAAE,YAAA;IAQxC,YAAY,CAAC,OAAO,EAAE,MAAM;IAO5B,QAAQ,CAAC,KAAK,EAAE,KAAK;IAKrB,IAAI,CAAC,KAAK,EAAE,CAAC;IAKb,MAAM,CAAC,KAAK,EAAE,aAAa;IAM3B,OAAO;CAIV;AAED,qBAAa,WAAW,CAAC,CAAC;IAKX,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE;IACvB,KAAK,EAAE,KAAK;IACZ,aAAa,EAAE,aAAa;IACnC,OAAO,CAAC,WAAW;IACZ,OAAO,CAAC,EAAE,iBAAiB,EAAE;IARxC,OAAO,CAAC,MAAM,CAAC,CAAgB;gBAGpB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EACvB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC3B,WAAW,EAAE,+BAA+B,CAAC,CAAC,CAAC,EAChD,OAAO,CAAC,EAAE,iBAAiB,EAAE,YAAA;IAGxC,QAAQ,CAAC,KAAK,EAAE,KAAK;IAIrB,YAAY,CAAC,OAAO,EAAE,MAAM;IAM5B,IAAI,CAAC,KAAK,EAAE,CAAC;IAIb,MAAM,CAAC,KAAK,EAAE,aAAa;IAK3B,OAAO;CAIV"}

package/dist/query.js

@@ -1,3 +1,5 @@
+import { Future } from "fluent-future";
+import { PostgresError } from "./error";
 export const QueryState = {
     Parsing: 0,
     Describing: 1,
@@ -13,10 +15,15 @@ export class Query {
         this.statementName = statementName;
         this.columns = columns;
         this._rows = [];
-        this.promise = new Promise((a, b) => {
-            this._resolve = a;
-            this._reject = b;
-        });
+        const { future, reject, resolve } = Future.withResolvers();
+        this.future = future;
+        this._resolve = resolve;
+        this._reject = reject;
+    }
+    startTimeout(timeout) {
+        this._timer = setTimeout(() => {
+            this.reject(new PostgresError('Query timeout', '57014'));
+        }, timeout);
     }
     setState(state) {
         this.state = state;
@@ -25,9 +32,40 @@ export class Query {
         this._rows.push(value);
     }
     reject(cause) {
+        clearTimeout(this._timer);
         this._reject(cause);
     }
     resolve() {
+        clearTimeout(this._timer);
         this._resolve(this._rows);
     }
 }
+export class StreamQuery {
+    constructor(text, args, state, statementName, _controller, columns) {
+        this.text = text;
+        this.args = args;
+        this.state = state;
+        this.statementName = statementName;
+        this._controller = _controller;
+        this.columns = columns;
+    }
+    setState(state) {
+        this.state = state;
+    }
+    startTimeout(timeout) {
+        this._timer = setTimeout(() => {
+            this.reject(new PostgresError('Query timeout', '57014'));
+        }, timeout);
+    }
+    push(value) {
+        this._controller.enqueue(value);
+    }
+    reject(cause) {
+        clearTimeout(this._timer);
+        this._controller.error(cause);
+    }
+    resolve() {
+        clearTimeout(this._timer);
+        this._controller.close();
+    }
+}

package/dist/queue.d.ts

@@ -2,8 +2,9 @@ export declare class Queue<T> {
     private _queue;
     private _pointer;
     next(): void;
-    get(): T;
-    shift(): T;
+    get current(): T;
+    get last(): T;
+    get shift(): T;
     push(item: T): void;
     get size(): number;
     get hasMore(): boolean;

package/dist/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK,CAAC,CAAC;IAChB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAI;IAEpB,IAAI;IAcJ,GAAG;IAKH,KAAK;IAQL,IAAI,CAAC,IAAI,EAAE,CAAC;IAIZ,IAAI,IAAI,WAEP;IAGD,IAAI,OAAO,YAEV;IAGD,IAAI,MAAM,YAA+C;CAC5D"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK,CAAC,CAAC;IAChB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAI;IAEpB,IAAI;IAcJ,IAAI,OAAO,MAEV;IAED,IAAI,IAAI,MAA+C;IAGvD,IAAI,KAAK,MAKR;IAGD,IAAI,CAAC,IAAI,EAAE,CAAC;IAIZ,IAAI,IAAI,WAEP;IAGD,IAAI,OAAO,YAEV;IAGD,IAAI,MAAM,YAA+C;CAC5D"}

package/dist/queue.js

@@ -14,10 +14,11 @@ export class Queue {
             this._pointer = 0;
         }
     }
-    get() {
+    get current() {
         return this._queue[this._pointer];
     }
-    shift() {
+    get last() { return this._queue[this._queue.length - 1]; }
+    get shift() {
         const item = this._queue[this._pointer];
         this.next();
         return item;