@m2k-5f/pgtx 1.2.1 → 1.3.0

package/dist/clauses/empty.clause.d.ts

@@ -0,0 +1,8 @@
+import { CompiledSqlQuery } from "../utils";
+import { Clause } from "./base.clause";
+export declare class EmptyClause extends Clause {
+    static new(): EmptyClause;
+    map(argCounter: number): CompiledSqlQuery;
+}
+export declare const emptyClause: EmptyClause;
+//# sourceMappingURL=empty.clause.d.ts.map

package/dist/clauses/empty.clause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.clause.d.ts","sourceRoot":"","sources":["../../src/clauses/empty.clause.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC,qBAAa,WAAY,SAAQ,MAAM;IACnC,MAAM,CAAC,GAAG;IAIV,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;CAG5C;AAED,eAAO,MAAM,WAAW,aAAoB,CAAA"}

package/dist/clauses/empty.clause.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyClause = exports.EmptyClause = void 0;
+const base_clause_1 = require("./base.clause");
+class EmptyClause extends base_clause_1.Clause {
+    static new() {
+        return new this();
+    }
+    map(argCounter) {
+        return { argCounter, args: [], text: "" };
+    }
+}
+exports.EmptyClause = EmptyClause;
+exports.emptyClause = EmptyClause.new();

package/dist/clauses/exclude.clause.d.ts

@@ -0,0 +1,9 @@
+import { CompiledSqlQuery } from "../utils";
+import { Clause } from "./base.clause";
+export declare class ExcludeUpdateClause extends Clause {
+    readonly fields: string[];
+    constructor(fields: string[]);
+    map(argCounter: number): CompiledSqlQuery;
+}
+export declare function excludeClause(fields: string[]): ExcludeUpdateClause;
+//# sourceMappingURL=exclude.clause.d.ts.map

package/dist/clauses/exclude.clause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclude.clause.d.ts","sourceRoot":"","sources":["../../src/clauses/exclude.clause.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,qBAAa,mBAAoB,SAAQ,MAAM;IAEvC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE;gBAAhB,MAAM,EAAE,MAAM,EAAE;IAGtB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;CAInD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAEnE"}

package/dist/clauses/exclude.clause.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExcludeUpdateClause = void 0;
+exports.excludeClause = excludeClause;
+const base_clause_1 = require("./base.clause");
+class ExcludeUpdateClause extends base_clause_1.Clause {
+    constructor(fields) {
+        super();
+        this.fields = fields;
+    }
+    map(argCounter) {
+        const text = this.fields.map(f => `${f} = EXCLUDED.${f}`).join(', ');
+        return { argCounter, args: [], text };
+    }
+}
+exports.ExcludeUpdateClause = ExcludeUpdateClause;
+function excludeClause(fields) {
+    return new ExcludeUpdateClause(fields);
+}

package/dist/connection.d.ts

@@ -7,8 +7,9 @@ import { Transaction } from "./transaction";
  */
 export declare class Connection {
     private readonly client;
+    private readonly enableLogs;
     private isReleased;
-    constructor(client: PoolClient);
+    constructor(client: PoolClient, enableLogs: boolean);
     /**
      * Checks if the connection is still open and not returned to the pool.
      */

package/dist/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,IAAI,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAK3C;;;GAGG;AACH,qBAAa,UAAU;IAIf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAH3B,OAAO,CAAC,UAAU,CAAiB;gBAGd,MAAM,EAAE,UAAU;IAGvC;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;;;;;;OAOG;IACU,OAAO,CAAC,OAAO,SAAS,cAAc,GAAG,GAAG,EAAE,OAAO,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EACpF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAoB/C;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC,OAAO,CAAC,WAAW;IAMnB;;;;;;OAMG;IACU,KAAK,CAAC,CAAC,SAAS,cAAc,GAAG,GAAG,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAUjH;;;;;;;;OAQG;IACU,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAmB/E"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,IAAI,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAK3C;;;GAGG;AACH,qBAAa,UAAU;IAIf,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ/B,OAAO,CAAC,UAAU,CAAiB;gBAGd,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,OAAO;IAGxC;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;;;;;;OAOG;IACU,OAAO,CAAC,OAAO,SAAS,cAAc,GAAG,GAAG,EAAE,OAAO,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EACpF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAoB/C;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC,OAAO,CAAC,WAAW;IAMnB;;;;;;OAMG;IACU,KAAK,CAAC,CAAC,SAAS,cAAc,GAAG,GAAG,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAcjH;;;;;;;;OAQG;IACU,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAmB/E"}

package/dist/connection.js

@@ -9,8 +9,9 @@ const cacher = new query_cacher_1.QueryCacher();
  * Always remember to call `.release()` when finished.
  */
 class Connection {
-    constructor(client) {
+    constructor(client, enableLogs) {
         this.client = client;
+        this.enableLogs = enableLogs;
         this.isReleased = false;
     }
     /**
@@ -69,6 +70,9 @@ class Connection {
     async query(strings, ...values) {
         this.checkActive();
         const { text, args } = cacher.cachedBuild(strings, values, 1);
+        if (this.enableLogs) {
+            console.log(`\nQUERY:     ${text}\n${args.length ? `ARGUMENTS: [${args}]\n` : ""}`);
+        }
         const result = await this.client.query(text, args);
         return result.rows;
     }

package/dist/index.d.ts

@@ -5,6 +5,10 @@ import { Pool as PgtxPool } from "./pool";
 import { literalClause } from "./clauses/literal.clause";
 import { updateClause } from "./clauses/update.clause";
 import { insertClause } from "./clauses/insert.clause";
+import { Connection } from "./connection";
+import { Transaction } from "./transaction";
+import { excludeClause } from "./clauses/exclude.clause";
+import { EmptyClause } from "./clauses/empty.clause";
 /**
  * Core SQL tagging utility for Pgtx.
  * Provides type-safe helpers for building dynamic queries with recursive support.
@@ -31,6 +35,24 @@ export declare const sql: {
      * // Result: status = $1, updated_at = $2
      */
     update: typeof updateClause;
+    /**
+     * Generates an assignment list for ON CONFLICT DO UPDATE using the EXCLUDED table.
+     *
+     * @example
+     * sql`INSERT INTO users ${sql.insert(data)} ON CONFLICT (id) DO UPDATE SET ${sql.excluded(['name', 'email'])}`
+     * // Result: name = EXCLUDED.name, email = EXCLUDED.email
+     */
+    excluded: typeof excludeClause;
+    /**
+     * Represents a safe empty SQL fragment.
+     * Useful for dynamic query building when a condition or list might be optional.
+     *
+     * @example
+     * const filters = [];
+     * sql`SELECT * FROM users ${filters.length ? sql.fragment`WHERE ...` : sql.empty}`
+     * // Result: SELECT * FROM users
+     */
+    empty: EmptyClause;
     /**
      * Safely escapes SQL identifiers (table or column names) using double quotes.
      *
@@ -88,5 +110,7 @@ export declare const sql: {
  * Main Pgtx Connection Pool.
  * Manages connections, transactions (including SAVEPOINTs), and prepared statements.
  */
+export { Connection as Connection };
+export { Transaction as Transaction };
 export { PgtxPool as Pool };
 //# 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,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,GAAG;IACZ;;;;;;;;;;;OAWG;;IAGH;;;;;;OAMG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;CAEN,CAAA;AAED;;;GAGG;AACH,OAAO,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAuB,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAe,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,GAAG;IACZ;;;;;;;;;;;OAWG;;IAGH;;;;;;OAMG;;IAGH;;;;;;OAMG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;CAEN,CAAA;AAGD;;;GAGG;AAEH,OAAO,EAAC,UAAU,IAAI,UAAU,EAAC,CAAA;AAEjC,OAAO,EAAC,WAAW,IAAI,WAAW,EAAC,CAAA;AAEnC,OAAO,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAA"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Pool = exports.sql = void 0;
+exports.Pool = exports.Transaction = exports.Connection = exports.sql = void 0;
 const array_clause_1 = require("./clauses/array.clause");
 const fragment_clause_1 = require("./clauses/fragment.clause");
 const iden_caluse_1 = require("./clauses/iden.caluse");
@@ -9,6 +9,12 @@ Object.defineProperty(exports, "Pool", { enumerable: true, get: function () { re
 const literal_clause_1 = require("./clauses/literal.clause");
 const update_clause_1 = require("./clauses/update.clause");
 const insert_clause_1 = require("./clauses/insert.clause");
+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 exclude_clause_1 = require("./clauses/exclude.clause");
+const empty_clause_1 = require("./clauses/empty.clause");
 /**
  * Core SQL tagging utility for Pgtx.
  * Provides type-safe helpers for building dynamic queries with recursive support.
@@ -35,6 +41,24 @@ exports.sql = {
      * // Result: status = $1, updated_at = $2
      */
     update: update_clause_1.updateClause,
+    /**
+     * Generates an assignment list for ON CONFLICT DO UPDATE using the EXCLUDED table.
+     *
+     * @example
+     * sql`INSERT INTO users ${sql.insert(data)} ON CONFLICT (id) DO UPDATE SET ${sql.excluded(['name', 'email'])}`
+     * // Result: name = EXCLUDED.name, email = EXCLUDED.email
+     */
+    excluded: exclude_clause_1.excludeClause,
+    /**
+     * Represents a safe empty SQL fragment.
+     * Useful for dynamic query building when a condition or list might be optional.
+     *
+     * @example
+     * const filters = [];
+     * sql`SELECT * FROM users ${filters.length ? sql.fragment`WHERE ...` : sql.empty}`
+     * // Result: SELECT * FROM users
+     */
+    empty: empty_clause_1.emptyClause,
     /**
      * Safely escapes SQL identifiers (table or column names) using double quotes.
      *

package/dist/pool.d.ts

@@ -8,6 +8,7 @@ import { Transaction } from "./transaction";
  */
 export declare class Pool {
     private pool;
+    private enableLogs;
     constructor(config: PoolConfig);
     /**
      * Executes a one-off query.

package/dist/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,cAAc,EAAC,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;;GAGG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,IAAI,CAAQ;gBAGhB,MAAM,EAAE,UAAU;IAKtB;;;;;;OAMG;IACU,KAAK,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE;IAc5F;;;;;;;;OAQG;IACU,OAAO,CAAC,OAAO,SAAS,cAAc,GAAG,GAAG,EAAE,OAAO,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EACpF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAyB/C;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAK3C;;;;;;;;;OASG;IACU,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAc5E;;OAEG;IACH,IAAW,KAAK;;;;MAMf;IAED;;OAEG;IACI,KAAK;CAGf"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,cAAc,EAAC,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;;GAGG;AACH,qBAAa,IAAI;IACb,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,UAAU,CAAS;gBAGvB,MAAM,EAAE,UAAU;IAMtB;;;;;;OAMG;IACU,KAAK,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE;IAc5F;;;;;;;;OAQG;IACU,OAAO,CAAC,OAAO,SAAS,cAAc,GAAG,GAAG,EAAE,OAAO,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EACpF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAyB/C;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAK3C;;;;;;;;;OASG;IACU,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAc5E;;OAEG;IACH,IAAW,KAAK;;;;MAMf;IAED;;OAEG;IACI,KAAK;CAGf"}

package/dist/pool.js

@@ -9,6 +9,7 @@ const connection_1 = require("./connection");
  */
 class Pool {
     constructor(config) {
+        this.enableLogs = config.enableLogs ?? false;
         this.pool = new pg_1.Pool(config);
     }
     /**
@@ -68,7 +69,7 @@ class Pool {
      */
     async acquire() {
         const client = await this.pool.connect();
-        return new connection_1.Connection(client);
+        return new connection_1.Connection(client, this.enableLogs);
     }
     /**
      * Starts a managed transaction.

package/dist/types.d.ts

@@ -1,5 +1,7 @@
 import { PoolConfig as PgPoolConfig } from "pg";
-export type PoolConfig = PgPoolConfig;
+export type PoolConfig = PgPoolConfig & {
+    enableLogs?: boolean;
+};
 export type PreparedStatement<TResult extends any, Tparams extends any[]> = {
     text: string;
     name: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,IAAI,CAAA;AAE/C,MAAM,MAAM,UAAU,GAAG,YAAY,CAAA;AAErC,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,IAAI,CAAA;AAE/C,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAC,CAAA;AAE9D,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m2k-5f/pgtx", 
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Lightweight, high-performance SQL toolkit for node-postgres",
   "files": [
     "dist",