@m2k-5f/pgtx 2.0.0 → 2.1.0

package/README.md

@@ -25,10 +25,12 @@ npm install @m2k-5f/pgtx
 
 | Tool | RPS | Avg Time | Connections |
 |------|-----|----------|-------------|
-| **Pgtx** | **1584** | **0.631ms** | **20 (used only one)** |
-| Native `pg` | 179 | 5.585ms | 20 |
+| **Pgtx** | **1584** | **0.631ms** | **20 pool connections (pipeline multiplexing)** |
+| Native `pg` | 179 | 5.585ms | 20 pool connections |
 
-**9x faster**
+**Up to 9x faster in concurrent pipeline workloads**
+
+**Pgtx achieves higher throughput by multiplexing concurrent queries over PostgreSQL connections using pipeline execution.**
 
 
 > Benchmark source available in the [repository](https://github.com/M2K-5F/pgtx).
@@ -43,7 +45,7 @@ npm install @m2k-5f/pgtx
 - **Bulk inserts** — Auto-extract columns from objects
 - **Dynamic updates** — Generate SET clauses from objects
 - **Recursive fragments** — Compose SQL like Lego
-- **Prepared statements** — Pre-parse any SQL with parameters
+- **Prepared statements** — Automatic prepared statement caching
 - **Connection pool** — Auto-management connections with support for pipeline queries via the pool itself.
 - **Zero dependencies** — Lightweight and blazing
 

package/dist/connection.d.ts

@@ -1,6 +1,5 @@
-import { ColumnDescription } from "./types";
+import { Branded, ColumnDescription } from "./types";
 import { Transaction } from "./transaction";
-import { Queue } from "./queue";
 type LogLevel = "none" | "error" | "notice" | "query";
 export type ConnectionParams = {
     user: string;
@@ -10,17 +9,25 @@ export type ConnectionParams = {
     database: string;
     logLevel?: LogLevel;
 };
-export type ConnectionQueryContext = {
-    columns: ColumnDescription[];
+export type ExecuteQueueUnit = {
     rows: (string | null)[][];
     resolve: (value: any) => void;
     reject: (err: Error) => void;
-    text: string;
-    statementName: string | null;
+    statementName: StatementName;
 };
-export declare class ConnectionQueryQueue extends Queue<ConnectionQueryContext> {
-    rejectAllNext(error: Error): void;
-}
+export type ParsingQueueUnit = {
+    resolve: (statementName: StatementName) => void;
+    reject: (error: Error) => void;
+    text: QueryText;
+    statementName: StatementName;
+};
+export type DescribeQueueUnit = {
+    resolve: (value: ColumnDescription[]) => void;
+    reject: (error: Error) => void;
+    statementName: StatementName;
+};
+export type StatementName = Branded<string, 'statementName'>;
+export type QueryText = Branded<string, 'queryText'>;
 /**
  * Represents a single dedicated connection to the PostgreSQL database.
  *
@@ -56,10 +63,11 @@ export declare class Connection {
     private _isAlive;
     private _socket;
     private _writer;
-    private _queue;
-    private _statementDescriptions;
-    private _statements;
-    private _parsePending;
+    private _pipelinesQueue;
+    private _described;
+    private _describingPending;
+    private _parsed;
+    private _parsingPending;
     private _stmtCounter;
     private _logLevel;
     private _nextStatement;
@@ -69,7 +77,7 @@ export declare class Connection {
      *
      * @param params - Connection parameters
      * @returns A new Connection instance
-     * @throws {Error} If authentication fails or connection cannot be established
+     * @throws {PostgresError} If authentication fails or connection cannot be established
      *
      * @example
      * ```ts
@@ -107,7 +115,9 @@ export declare class Connection {
      * const users = await conn.query<User>`SELECT * FROM users`
      * ```
      */
-    query<T extends Record<string, unknown>>(templates: TemplateStringsArray, ...args: any[]): Promise<T[]>;
+    query<T extends Record<string, any>>(templates: TemplateStringsArray, ...params: any[]): Promise<T[]>;
+    private _createQuery;
+    private _writeQuery;
     /**
      * Starts a managed transaction on this connection.
      *
@@ -132,13 +142,15 @@ export declare class Connection {
     begin<T>(txCallback: (transaction: Transaction) => Promise<T>): Promise<T>;
     private _registerFlush;
     private _flush;
+    private _getCurrentQuery;
+    private _rejectPipeline;
     private _handlePacket;
-    private _handleError;
     /**
      * Checks if the connection is still alive and usable.
      * Returns `false` if the socket is destroyed or connection is dead.
      */
     get isAlive(): boolean;
+    private _destroyConnection;
     /**
      * Closes the connection immediately.
      * All pending queries will be rejected with an error.

package/dist/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B,KAAK,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;AAErD,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACtB,CAAA;AAKD,MAAM,MAAM,sBAAsB,GAAG;IACjC,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7B,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,CAAA;AAGD,qBAAa,oBAAqB,SAAQ,KAAK,CAAC,sBAAsB,CAAC;IAEnE,aAAa,CAAC,KAAK,EAAE,KAAK;CAM7B;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAO;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,sBAAsB,CAAyC;IACvE,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,SAAS,CAAU;IAG3B,OAAO,CAAC,cAAc;IAItB,OAAO;IAcP;;;;;;;;;;;;;;;;;OAiBG;WACU,GAAG,CAAC,MAAM,EAAE,gBAAgB;IAQzC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA0DvG;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBhF,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,aAAa;IAoFrB,OAAO,CAAC,YAAY;IAQpB;;;OAGG;IACH,IAAI,OAAO,YAEV;IAGD;;;;;;;;;OASG;IACH,KAAK;CAIR"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"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"}

package/dist/connection.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Connection = exports.ConnectionQueryQueue = void 0;
+exports.Connection = void 0;
 const process_1 = require("process");
 const connection_request_writer_1 = require("./protocol/connection-request-writer");
 const socket_authorization_1 = require("./protocol/socket-authorization");
@@ -10,16 +10,8 @@ const template_compiler_1 = require("./utils/template-compiler");
 const transaction_1 = require("./transaction");
 const socket_connector_1 = require("./protocol/socket-connector");
 const queue_1 = require("./queue");
+const query_1 = require("./query");
 const ErrConnectionDead = new Error("Connection is Dead");
-class ConnectionQueryQueue extends queue_1.Queue {
-    rejectAllNext(error) {
-        while (!this.isFree) {
-            this.get().reject(error);
-            this.next();
-        }
-    }
-}
-exports.ConnectionQueryQueue = ConnectionQueryQueue;
 /**
  * Represents a single dedicated connection to the PostgreSQL database.
  *
@@ -57,13 +49,16 @@ class Connection {
     constructor(socket, writer, logLevel) {
         this._isFlushing = false;
         this._isAlive = true;
-        this._queue = new ConnectionQueryQueue();
-        this._statementDescriptions = new Map();
-        this._statements = new Map();
-        this._parsePending = new Map();
+        this._pipelinesQueue = new queue_1.Queue();
+        this._described = new Map();
+        this._describingPending = new Set();
+        this._parsed = new Map();
+        this._parsingPending = new Map();
         this._stmtCounter = 0;
         this._logLevel = logLevel;
-        this._socket = new socket_connector_1.SocketConnector(socket, (type, reader) => this._handlePacket(type, reader), error => this._handleError(error));
+        this._socket = new socket_connector_1.SocketConnector(socket, (type, reader) => this._handlePacket(type, reader), (err) => {
+            this._destroyConnection();
+        });
         this._writer = writer;
     }
     /**
@@ -71,7 +66,7 @@ class Connection {
      *
      * @param params - Connection parameters
      * @returns A new Connection instance
-     * @throws {Error} If authentication fails or connection cannot be established
+     * @throws {PostgresError} If authentication fails or connection cannot be established
      *
      * @example
      * ```ts
@@ -113,47 +108,67 @@ class Connection {
      * const users = await conn.query<User>`SELECT * FROM users`
      * ```
      */
-    query(templates, ...args) {
+    query(templates, ...params) {
+        this._registerFlush();
         if (!this._isAlive)
             throw ErrConnectionDead;
-        const query = (0, template_compiler_1.compileSqlTemplate)({ templates, args });
+        const { text, args } = (0, template_compiler_1.compileSqlTemplate)({ templates, args: params });
         if (this._logLevel === 'query') {
-            console.log(`\nQUERY:     ${query.text}\n${query.args.length !== 0 ? `ARGUMENTS: [${query.args}]\n` : ""}`);
+            console.log(`\nQUERY:     ${text}\n${args.length !== 0 ? `ARGUMENTS: [${args}]\n` : ""}`);
         }
-        return new Promise((resolve, reject) => {
-            this._registerFlush();
-            if (query.args.length === 0) {
-                this._writer.writeQuery(query.text);
-                this._queue.push({
-                    resolve, reject, columns: [], rows: [], statementName: null, text: query.text
-                });
+        const query = this._createQuery(text, args);
+        this._writeQuery(query);
+        return query.promise;
+    }
+    _createQuery(text, args) {
+        if (this._parsed.has(text)) {
+            const statementName = this._parsed.get(text);
+            if (this._described.has(statementName)) {
+                const columns = this._described.get(statementName);
+                return new query_1.Query(text, args, query_1.QueryState.Executing, statementName, columns);
             }
             else {
-                let rejectParsed = reject;
-                let statementName = '';
-                if (!this._statements.has(query.text) && !this._parsePending.has(query.text)) {
-                    statementName = this._nextStatement();
-                    this._parsePending.set(query.text, statementName);
-                    rejectParsed = (error) => {
-                        this._parsePending.delete(query.text);
-                        reject(error);
-                    };
-                    this._writer
-                        .writeParse(statementName, query.text);
-                    console.log('parsed once', statementName, query.text);
+                if (this._describingPending.has(statementName)) {
+                    return new query_1.Query(text, args, query_1.QueryState.Executing, statementName);
                 }
-                statementName = this._statements.get(query.text) || this._parsePending.get(query.text);
-                if (!this._statementDescriptions.has(statementName)) {
-                    this._writer.writeDescribe(statementName);
+                else {
+                    this._describingPending.add(statementName);
+                    return new query_1.Query(text, args, query_1.QueryState.Describing, statementName);
                 }
-                this._queue.push({
-                    resolve, reject: rejectParsed, columns: [], rows: [], statementName: statementName, text: query.text
-                });
-                this._writer
-                    .writeBind("", statementName, query.args)
-                    .writeExecute("");
             }
-        });
+        }
+        else {
+            if (this._parsingPending.has(text)) {
+                const statementName = this._parsingPending.get(text);
+                return new query_1.Query(text, args, query_1.QueryState.Describing, statementName);
+            }
+            else {
+                const statementName = this._nextStatement();
+                this._parsingPending.set(text, statementName);
+                return new query_1.Query(text, args, query_1.QueryState.Parsing, statementName);
+            }
+        }
+    }
+    _writeQuery(query) {
+        if (query.state === query_1.QueryState.Parsing) {
+            this._writer
+                .writeParse(query.statementName, query.text)
+                .writeDescribe(query.statementName)
+                .writeBind("", query.statementName, query.args)
+                .writeExecute("");
+        }
+        if (query.state === query_1.QueryState.Describing) {
+            this._writer
+                .writeDescribe(query.statementName)
+                .writeBind("", query.statementName, query.args)
+                .writeExecute("");
+        }
+        if (query.state === query_1.QueryState.Executing) {
+            this._writer
+                .writeBind("", query.statementName, query.args)
+                .writeExecute("");
+        }
+        this._pipelinesQueue.get().push(query);
     }
     /**
      * Starts a managed transaction on this connection.
@@ -196,12 +211,16 @@ class Connection {
     _registerFlush() {
         if (!this._isFlushing) {
             this._isFlushing = true;
-            (0, process_1.nextTick)(() => this._flush());
+            this._pipelinesQueue.push(new queue_1.Queue());
+            (0, process_1.nextTick)(() => {
+                this._flush();
+            });
         }
     }
     _flush() {
+        this._isFlushing = false;
         if (!this._isAlive) {
-            this._queue.rejectAllNext(ErrConnectionDead);
+            this._rejectPipeline(ErrConnectionDead);
             return;
         }
         try {
@@ -209,19 +228,30 @@ class Connection {
             this._writer.clear();
         }
         catch (err) {
-            this._isAlive = false;
-            this._socket.destroy();
-            this._queue.rejectAllNext(ErrConnectionDead);
+            this._destroyConnection();
+        }
+    }
+    _getCurrentQuery() {
+        return this._pipelinesQueue.get().get();
+    }
+    _rejectPipeline(error) {
+        if (this._pipelinesQueue.isFree)
+            return;
+        const queue = this._pipelinesQueue.get();
+        while (queue.hasMore) {
+            queue.get().reject(error);
+            queue.next();
         }
     }
     _handlePacket(type, reader) {
-        const context = this._queue.get();
         switch (type) {
             case constants_1.ResponseTypes.ParseComplete:
                 {
                     reader.readParseComplete();
-                    this._statements.set(context.text, context.statementName);
-                    this._parsePending.delete(context.text);
+                    const query = this._getCurrentQuery();
+                    this._parsingPending.delete(query.text);
+                    this._parsed.set(query.text, query.statementName);
+                    query.state = query_1.QueryState.Describing;
                 }
                 break;
             case constants_1.ResponseTypes.BindComplete:
@@ -242,50 +272,74 @@ class Connection {
             case constants_1.ResponseTypes.NoData:
                 {
                     reader.readNoData();
-                    if (context.statementName) {
-                        this._statementDescriptions.set(context.statementName, []);
-                    }
+                    const query = this._getCurrentQuery();
+                    this._describingPending.delete(query.statementName);
+                    this._described.set(query.statementName, []);
+                    query.state = query_1.QueryState.Executing;
                 }
                 break;
             case constants_1.ResponseTypes.RowDescription:
                 {
-                    if (context.statementName) {
-                        this._statementDescriptions.set(context.statementName, reader.readRowDescription());
-                    }
-                    else {
-                        context.columns = reader.readRowDescription();
-                    }
+                    const columns = reader.readRowDescription();
+                    const query = this._getCurrentQuery();
+                    this._describingPending.delete(query.statementName);
+                    this._described.set(query.statementName, columns);
+                    query.state = query_1.QueryState.Executing;
+                    query.columns = columns;
                 }
                 break;
             case constants_1.ResponseTypes.DataRow:
                 {
-                    context.rows.push(reader.readDataRow());
+                    const query = this._getCurrentQuery();
+                    query.rows.push(reader.readDataRow());
                 }
                 break;
             case constants_1.ResponseTypes.ComandComplete:
                 {
                     reader.readCommandComplete();
-                    if (context.statementName) {
-                        context.columns = this._statementDescriptions.get(context.statementName);
+                    if (this._pipelinesQueue.isFree) {
+                        this._destroyConnection();
+                        break;
+                    }
+                    const query = this._getCurrentQuery();
+                    if (!query) {
+                        this._destroyConnection();
+                        break;
                     }
-                    context.resolve((0, value_parser_1.parseRowValues)(context.columns, context.rows));
-                    this._queue.next();
+                    if (!query.columns) {
+                        query.columns = this._described.get(query.statementName);
+                    }
+                    query.state = query_1.QueryState.Completed;
+                    this._pipelinesQueue.get().next();
+                    query.resolve((0, value_parser_1.parseRowValues)(query.columns, query.rows));
                 }
                 break;
             case constants_1.ResponseTypes.ErrorResponse:
                 {
-                    const message = reader.readErrorResponse();
+                    const error = reader.readErrorResponse();
                     if (this._logLevel === 'error' || this._logLevel === 'notice' || this._logLevel === 'query') {
-                        console.log(`\nError:    ${message}\n`);
+                        console.log(`\nError:    ${error}\n`);
                     }
-                    const error = new Error(message);
-                    this._queue.rejectAllNext(error);
+                    const query = this._getCurrentQuery();
+                    switch (query.state) {
+                        case query_1.QueryState.Parsing:
+                            this._parsingPending.delete(query.text);
+                            break;
+                        case query_1.QueryState.Describing:
+                            this._describingPending.delete(query.statementName);
+                            break;
+                    }
+                    query.state = query_1.QueryState.Failed;
+                    this._rejectPipeline(error);
                 }
                 break;
             case constants_1.ResponseTypes.ReadyForQuery:
                 {
-                    this._isFlushing = false;
                     reader.readReadyForQuery();
+                    const pipeline = this._pipelinesQueue.get();
+                    if (!pipeline.hasMore) {
+                        this._pipelinesQueue.next();
+                    }
                 }
                 break;
             case constants_1.ResponseTypes.Notice:
@@ -299,11 +353,6 @@ class Connection {
             default: console.warn('Undeclared response type: ', type);
         }
     }
-    _handleError(error) {
-        this._isAlive = false;
-        this._queue.rejectAllNext(error);
-        this._socket.destroy();
-    }
     /**
      * Checks if the connection is still alive and usable.
      * Returns `false` if the socket is destroyed or connection is dead.
@@ -311,6 +360,14 @@ class Connection {
     get isAlive() {
         return this._isAlive && !this._socket.isDestroyed;
     }
+    _destroyConnection() {
+        this._isAlive = false;
+        this._socket.destroy();
+        while (this._pipelinesQueue.hasMore) {
+            this._rejectPipeline(ErrConnectionDead);
+            this._pipelinesQueue.next();
+        }
+    }
     /**
      * Closes the connection immediately.
      * All pending queries will be rejected with an error.
@@ -322,8 +379,7 @@ class Connection {
      * ```
      */
     close() {
-        this._isAlive = false;
-        this._socket.destroy();
+        this._destroyConnection();
     }
 }
 exports.Connection = Connection;

package/dist/error.d.ts

@@ -0,0 +1,18 @@
+export declare class PostgresError extends Error {
+    message: string;
+    code: string;
+    detail: string;
+    severity: string;
+    where: string;
+    hint: string;
+    position: string;
+    dataType: string;
+    constraint: string;
+    constructor(message: string, code: string, detail: string, severity: string, where: string, hint: string, position: string, dataType: string, constraint: string);
+    get isParseError(): boolean;
+    get isDeadlock(): boolean;
+    get isConstraintViolation(): boolean;
+    get isTimeout(): boolean;
+    get isConnectionFailure(): boolean;
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IAEhB,OAAO,EAAE,MAAM;IACxB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,MAAM;gBART,OAAO,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM;IAQ7B,IAAI,YAAY,IAAI,OAAO,CAE1B;IAID,IAAI,UAAU,IAAI,OAAO,CAExB;IAID,IAAI,qBAAqB,IAAI,OAAO,CAEnC;IAGD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAGD,IAAI,mBAAmB,IAAI,OAAO,CAEjC;CACJ"}

package/dist/error.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresError = void 0;
+class PostgresError extends Error {
+    constructor(message, code, detail, severity, where, hint, position, dataType, constraint) {
+        super(message);
+        this.message = message;
+        this.code = code;
+        this.detail = detail;
+        this.severity = severity;
+        this.where = where;
+        this.hint = hint;
+        this.position = position;
+        this.dataType = dataType;
+        this.constraint = constraint;
+        this.name = "PostgresError";
+    }
+    // Parse error
+    get isParseError() {
+        return this.code.startsWith('42');
+    }
+    // Execute error
+    get isDeadlock() {
+        return this.code === '40P01';
+    }
+    // Execute error
+    get isConstraintViolation() {
+        return this.code.startsWith('23');
+    }
+    get isTimeout() {
+        return this.code === '57014';
+    }
+    get isConnectionFailure() {
+        return this.code.startsWith('08') || this.code.startsWith('57') && this.code !== '57014';
+    }
+}
+exports.PostgresError = PostgresError;

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { Pool as PgtxPool } from "./pool";
 import { IdentifierClause, InsertClause, ArrayClause, UpdateClause, ExcludeUpdateClause, WhereClause, LiteralClause, FragmentClause } from './clauses';
 import { Connection } from "./connection";
 import { Transaction } from "./transaction";
+import { setTypeParser } from "./utils/value-parser";
 /**
  * Core SQL tagging utility for Pgtx.
  * Provides type-safe helpers for building dynamic queries with recursive support.
@@ -119,4 +120,6 @@ export declare const sql: {
 export { Connection as Connection };
 export { Transaction as Transaction };
 export { PgtxPool as Pool };
+export { setTypeParser as setTypeParser };
+export * from "./clauses";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EACH,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,EAEnB,WAAW,EACX,aAAa,EACb,cAAc,EACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,GAAG;IACZ;;;;;;;;;;;OAWG;;IAGH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;;KAWC;;IAGD;;;;;;;;;;OAUG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;CAEN,CAAA;AAGD;;;GAGG;AAEH,OAAO,EAAE,UAAU,IAAI,UAAU,EAAE,CAAA;AAEnC,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,CAAA;AAErC,OAAO,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EACH,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,EAEnB,WAAW,EACX,aAAa,EACb,cAAc,EACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD;;;GAGG;AACH,eAAO,MAAM,GAAG;IACZ;;;;;;;;;;;OAWG;;IAGH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;;KAWC;;IAGD;;;;;;;;;;OAUG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;CAEN,CAAA;AAGD;;;GAGG;AAEH,OAAO,EAAE,UAAU,IAAI,UAAU,EAAE,CAAA;AAEnC,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,CAAA;AAErC,OAAO,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAA;AAE3B,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,CAAA;AAEzC,cAAc,WAAW,CAAA"}

package/dist/index.js

@@ -1,6 +1,20 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Pool = exports.Transaction = exports.Connection = exports.sql = void 0;
+exports.setTypeParser = exports.Pool = exports.Transaction = exports.Connection = exports.sql = void 0;
 const pool_1 = require("./pool");
 Object.defineProperty(exports, "Pool", { enumerable: true, get: function () { return pool_1.Pool; } });
 const clauses_1 = require("./clauses");
@@ -8,6 +22,8 @@ const connection_1 = require("./connection");
 Object.defineProperty(exports, "Connection", { enumerable: true, get: function () { return connection_1.Connection; } });
 const transaction_1 = require("./transaction");
 Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_1.Transaction; } });
+const value_parser_1 = require("./utils/value-parser");
+Object.defineProperty(exports, "setTypeParser", { enumerable: true, get: function () { return value_parser_1.setTypeParser; } });
 /**
  * Core SQL tagging utility for Pgtx.
  * Provides type-safe helpers for building dynamic queries with recursive support.
@@ -118,3 +134,4 @@ exports.sql = {
      */
     array: clauses_1.ArrayClause.create,
 };
+__exportStar(require("./clauses"), exports);

package/dist/pool.d.ts

@@ -127,7 +127,7 @@ export declare class Pool {
      * const users = await pool.query<User>`SELECT * FROM users`
      * ```
      */
-    query<T extends Record<string, unknown>>(templates: TemplateStringsArray, ...args: any[]): Promise<T[]>;
+    query<T extends Record<string, any>>(templates: TemplateStringsArray, ...args: any[]): Promise<T[]>;
     /**
      * Number of available (idle) connections in the pool.
      */

package/dist/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAI3C,KAAK,UAAU,GAAG,gBAAgB,GAAG;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,CAAC,YAAY;gBAIR,MAAM,EAAE,UAAU;IAM9B;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IA6BpC;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU;IAoBxB;;;;;;;;;;;;;;;;;OAiBG;IACG,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAmCvG;;OAEG;IACH,IAAI,IAAI,WAEP;IAGD;;;OAGG;IACH,IAAI,KAAK,WAER;IAGD;;;;;;;;;;OAUG;IACG,KAAK;CAed"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAK3C,KAAK,UAAU,GAAG,gBAAgB,GAAG;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,CAAC,YAAY;gBAIR,MAAM,EAAE,UAAU;IAM9B;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IA6BpC;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU;IAoBxB;;;;;;;;;;;;;;;;;OAiBG;IACG,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAmCnG;;OAEG;IACH,IAAI,IAAI,WAEP;IAGD;;;OAGG;IACH,IAAI,KAAK,WAER;IAGD;;;;;;;;;;OAUG;IACG,KAAK;CAed"}

package/dist/pool.js

@@ -71,7 +71,7 @@ class Pool {
      */
     async acquire() {
         this._checkClosed();
-        while (!this._available.isFree) {
+        while (this._available.hasMore) {
             const conn = this._available.get();
             this._available.next();
             if (conn.isAlive) {
@@ -117,7 +117,7 @@ class Pool {
             this._total--;
             return;
         }
-        if (!this._waiting.isFree) {
+        if (this._waiting.hasMore) {
             const waiter = this._waiting.get();
             this._waiting.next();
             waiter.resolve(conn);
@@ -178,7 +178,7 @@ class Pool {
      */
     query(templates, ...args) {
         this._checkClosed();
-        while (!this._available.isFree) {
+        while (this._available.hasMore) {
             const conn = this._available.get();
             if (conn.isAlive) {
                 return conn.query(templates, ...args);
@@ -229,12 +229,12 @@ class Pool {
      * ```
      */
     async close() {
-        while (!this._available.isFree) {
+        while (this._available.hasMore) {
             const conn = this._available.get();
             this._available.next();
             conn.close();
         }
-        while (!this._waiting.isFree) {
+        while (this._waiting.hasMore) {
             const waiter = this._waiting.get();
             this._waiting.next();
             waiter.reject(new Error('Pool closed'));

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

@@ -1,5 +1,6 @@
 import { AuthenticationCode, ResponseType, TransactionStatus } from "./constants";
 import { ColumnDescription } from "../types";
+import { PostgresError } from "../error";
 export declare class ConnectionResponseBuffer {
     private buffer;
     private caret;
@@ -31,7 +32,7 @@ export declare class ConnectionResponseReader {
         PID: number;
         secret: number;
     };
-    readErrorResponse(): string;
+    readErrorResponse(): PostgresError;
     readReadyForQuery(): TransactionStatus;
     readSaslMechanisms(): string[];
     readSaslMessage(): string;

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,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5C,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,aAAa,IAAI,OAAO;IAaxB,iBAAiB;CAGpB;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;IAgBjB,iBAAiB,IAEoB,iBAAiB;IAItD,kBAAkB,IAAI,MAAM,EAAE;IAa9B,eAAe,IAAI,MAAM;IAOzB,kBAAkB;IAuBlB,WAAW;IAmBX,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,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGxC,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,aAAa,IAAI,OAAO;IAaxB,iBAAiB;CAGpB;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;IAmBX,mBAAmB,IAAI,MAAM;IAM7B,OAAO;IAKP,aAAa;IAKb,iBAAiB;IAKjB,iBAAiB;IAKjB,gBAAgB;IAKhB,wBAAwB;IAQxB,UAAU;CAGb"}

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectionResponseReader = exports.ConnectionResponseBuffer = void 0;
+const error_1 = require("../error");
 class ConnectionResponseBuffer {
     constructor(buffer) {
         this.buffer = buffer;
@@ -91,16 +92,51 @@ class ConnectionResponseReader {
     }
     readErrorResponse() {
         this.buffer.readInt32();
+        let severity = '';
+        let code = '';
         let message = '';
+        let detail = '';
+        let where = '';
+        let hint = '';
+        let position = '';
+        let dataType = '';
+        let constraint = '';
         while (true) {
             const marker = this.buffer.readChar();
             if (marker === '\0')
                 break;
             const text = this.buffer.readCString();
-            if (marker === 'M')
-                message += text;
+            switch (marker) {
+                case 'S':
+                    severity = text;
+                    break;
+                case 'C':
+                    code = text;
+                    break;
+                case 'M':
+                    message = text;
+                    break;
+                case 'D':
+                    detail = text;
+                    break;
+                case 'W':
+                    where = text;
+                    break;
+                case 'H':
+                    hint = text;
+                    break;
+                case 'P':
+                    position = text;
+                    break;
+                case 'd':
+                    dataType = text;
+                    break;
+                case 'n':
+                    constraint = text;
+                    break;
+            }
         }
-        return message;
+        return new error_1.PostgresError(message, code, detail, severity, where, hint, position, dataType, constraint);
     }
     readReadyForQuery() {
         this.buffer.readInt32();

package/dist/query.d.ts

@@ -0,0 +1,24 @@
+import { QueryText, StatementName } from "./connection";
+import { ColumnDescription, ValueOF } from "./types";
+export declare const QueryState: {
+    readonly Parsing: 0;
+    readonly Describing: 1;
+    readonly Executing: 2;
+    readonly Completed: 3;
+    readonly Failed: 4;
+};
+export type State = ValueOF<typeof QueryState>;
+export declare class Query<T> {
+    text: QueryText;
+    args: (string | null)[];
+    state: State;
+    statementName: StatementName;
+    columns?: ColumnDescription[] | undefined;
+    promise: Promise<T[]>;
+    resolve: (value: T[]) => void;
+    reject: (error: Error) => void;
+    rows: (string | null)[][];
+    constructor(text: QueryText, args: (string | null)[], state: State, statementName: StatementName, columns?: ColumnDescription[] | undefined);
+    setState(state: State): void;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +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,EAAG,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAA;IAC9B,MAAM,EAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAC/B,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAK;gBAGnB,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,QAAQ,CAAC,KAAK,EAAE,KAAK;CAGxB"}

package/dist/query.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Query = exports.QueryState = void 0;
+exports.QueryState = {
+    Parsing: 0,
+    Describing: 1,
+    Executing: 2,
+    Completed: 3,
+    Failed: 4
+};
+class Query {
+    constructor(text, args, state, statementName, columns) {
+        this.text = text;
+        this.args = args;
+        this.state = state;
+        this.statementName = statementName;
+        this.columns = columns;
+        this.rows = [];
+        this.promise = new Promise((a, b) => {
+            this.resolve = a;
+            this.reject = b;
+        });
+    }
+    setState(state) {
+        this.state = state;
+    }
+}
+exports.Query = Query;

package/dist/queue.d.ts

@@ -3,8 +3,10 @@ export declare class Queue<T> {
     private _pointer;
     next(): void;
     get(): T;
+    shift(): T;
     push(item: T): void;
     get size(): number;
+    get hasMore(): boolean;
     get isFree(): boolean;
 }
 //# sourceMappingURL=queue.d.ts.map

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;IAQJ,GAAG;IAIH,IAAI,CAAC,IAAI,EAAE,CAAC;IAIZ,IAAI,IAAI,WAEP;IAED,IAAI,MAAM,YAAgD;CAC7D"}
+{"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;IASJ,GAAG;IAKH,KAAK;IAYL,IAAI,CAAC,IAAI,EAAE,CAAC;IAIZ,IAAI,IAAI,WAEP;IAGD,IAAI,OAAO,YAEV;IAGD,IAAI,MAAM,YAA+C;CAC5D"}

package/dist/queue.js

@@ -8,7 +8,7 @@ class Queue {
     }
     next() {
         this._pointer++;
-        if (this._pointer === this._queue.length) {
+        if (this._pointer >= this._queue.length) {
             this._queue = [];
             this._pointer = 0;
         }
@@ -16,12 +16,24 @@ class Queue {
     get() {
         return this._queue[this._pointer];
     }
+    shift() {
+        const item = this._queue[this._pointer];
+        this._pointer++;
+        if (this._pointer >= this._queue.length) {
+            this._queue = [];
+            this._pointer = 0;
+        }
+        return item;
+    }
     push(item) {
         this._queue.push(item);
     }
     get size() {
         return this._queue.length - this._pointer;
     }
-    get isFree() { return this._pointer === this._queue.length; }
+    get hasMore() {
+        return this._pointer < this._queue.length;
+    }
+    get isFree() { return this._pointer >= this._queue.length; }
 }
 exports.Queue = Queue;

package/dist/transaction.d.ts

@@ -23,7 +23,7 @@ export declare class Transaction {
     /**
      * Executes a query within the current transaction.
      */
-    query<T extends Record<string, unknown>>(strings: TemplateStringsArray, ...values: any[]): Promise<T[]>;
+    query<T extends Record<string, any>>(strings: TemplateStringsArray, ...values: any[]): Promise<T[]>;
     /**
      * Creates a sub-transaction using PostgreSQL SAVEPOINT.
      * If the callback throws, only the actions within this savepoint are rolled back.

package/dist/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;GAGG;AACH,qBAAa,WAAW;IAIhB,QAAQ,CAAC,IAAI,EAAE,UAAU;IAH7B,OAAO,CAAC,UAAU,CAAiB;gBAGtB,IAAI,EAAE,UAAU;IAG7B;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtC;;OAEG;IACU,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKpH;;;;;;;;;OASG;IACU,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAe5G"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;GAGG;AACH,qBAAa,WAAW;IAIhB,QAAQ,CAAC,IAAI,EAAE,UAAU;IAH7B,OAAO,CAAC,UAAU,CAAiB;gBAGtB,IAAI,EAAE,UAAU;IAG7B;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtC;;OAEG;IACU,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKhH;;;;;;;;;OASG;IACU,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAe5G"}

package/dist/types.d.ts

@@ -19,5 +19,8 @@ export type ColumnDescription = {
     name: string;
     typeOID: number;
 };
+export type Branded<T, Brand> = T & {
+    __brand: Brand;
+};
 export type ValueOF<T extends Record<string, unknown>> = T[keyof T];
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,CAAC,OAAO,SAAS,GAAG,EAAE,OAAO,SAAS,GAAG,EAAE,IAAI;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;CACpD,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAC3B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,CAAC;CACf,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,SAAS,EAAE,oBAAoB,CAAC;IAChC,IAAI,EAAE,GAAG,EAAE,CAAC;CACf,CAAA;AAGD,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAClB,CAAA;AAGD,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,CAAC,OAAO,SAAS,GAAG,EAAE,OAAO,SAAS,GAAG,EAAE,IAAI;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;CACpD,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAC3B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,CAAC;CACf,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,SAAS,EAAE,oBAAoB,CAAC;IAChC,IAAI,EAAE,GAAG,EAAE,CAAC;CACf,CAAA;AAGD,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,GAAG;IAAC,OAAO,EAAE,KAAK,CAAA;CAAC,CAAA;AAEpD,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA"}

package/dist/utils/value-parser.d.ts

@@ -1,6 +1,6 @@
 import { ColumnDescription } from "../types";
 declare const Parsers: Record<number, (value: string) => unknown>;
-export declare function parseRowValues(columns: ColumnDescription[], rows: (string | null)[][]): Record<string, any>;
+export declare function parseRowValues(columns: ColumnDescription[], rows: (string | null)[][]): Record<string, any>[];
 export declare const setTypeParser: (typeOID: keyof typeof Parsers, parser: (value: string) => unknown) => void;
 export {};
 //# sourceMappingURL=value-parser.d.ts.map

package/dist/utils/value-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value-parser.d.ts","sourceRoot":"","sources":["../../src/utils/value-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AA+B5C,QAAA,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAkD9C,CAAA;AAMV,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA8B3G;AAGD,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,OAAO,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,SAE9F,CAAA"}
+{"version":3,"file":"value-parser.d.ts","sourceRoot":"","sources":["../../src/utils/value-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AA+B5C,QAAA,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAkD9C,CAAA;AAMV,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CA8B7G;AAGD,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,OAAO,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,SAE9F,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m2k-5f/pgtx",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Blazing-fast PostgreSQL driver with pipeline support.",
   "files": [
     "dist",
@@ -40,8 +40,9 @@
     }
   },
   "devDependencies": {
+    "@types/node": "^26.1.1",
+    "pg": "^8.22.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.0.0",
-    "@types/node": "^26.1.1"
+    "typescript": "^5.0.0"
   }
 }