@m2k-5f/pgtx 1.0.2 → 1.0.4

package/README.md

@@ -1,4 +1,4 @@
-# Pgtx 🚀
+## Pgtx 🚀
 
 A lightweight, **high-performance** SQL query builder for `node-postgres` (pg).  
 Experience ORM-like convenience (auto-inserts, updates, recursive fragments) with the transparency and speed of raw SQL.
@@ -68,7 +68,7 @@ await pool.query`
 // SQL: INSERT INTO users ... VALUES ($1, (SELECT id FROM roles WHERE name = $2)) WHERE status = $3 AND age > $4
 ```
 
-## 2. Transactions
+### 2. Transactions
 Automatic BEGIN, COMMIT, and ROLLBACK. Use savepoint for nested logic.
 
 ```typescript
@@ -84,7 +84,7 @@ await pool.begin(async (tx) => {
 // Main transaction commits or rolls back based on callback success
 ```
 
-## 3. Bulk Inserts (sql.insert)
+### 3. Bulk Inserts (sql.insert)
 Automatically extracts columns from the first object. Supports single objects and arrays.
 
 ```typescript
@@ -97,7 +97,7 @@ await pool.query`INSERT INTO users ${sql.insert(users)}`
 // SQL: INSERT INTO users (name, email) VALUES ($1, $2), ($3, $4)
 ```
 
-## 4. Prepared Statements
+### 4. Prepared Statements
 Pre-parse SQL on the database server for maximum performance in hot loops.
 
 ```typescript
@@ -129,7 +129,7 @@ await pool.query`SELECT * FROM users WHERE ${sql.array(conds, ' AND ')}`
 // SQL: SELECT * FROM users WHERE active = true AND age > $1
 ```
 
-## 6. Dynamic Updates (sql.update)
+### 6. Dynamic Updates (sql.update)
 Easily generate SET clauses from plain JavaScript objects. 
 
 ```typescript

package/dist/index.d.ts

@@ -1,2 +1,92 @@
-export {};
+import { arrayClause } from "./clauses/array.clause";
+import { fragmentClause } from "./clauses/fragment.clause";
+import { identClause } from "./clauses/iden.caluse";
+import { Pool as PgtxPool } from "./pool";
+import { staticClause } from "./clauses/static.clause";
+import { updateClause } from "./clauses/update.clause";
+import { valueClause } from "./clauses/values.clause";
+/**
+ * Core SQL tagging utility for Pgtx.
+ * Provides type-safe helpers for building dynamic queries with recursive support.
+ */
+export declare const sql: {
+    /**
+     * Creates a VALUES clause for INSERT queries.
+     * Supports single objects and arrays of objects.
+     *
+     * @example
+     * sql.insert({ name: 'Ivan', age: 25 })
+     * // Result: (name, age) VALUES ($1, $2)
+     *
+     * @example
+     * sql.insert([{ id: 1 }, { id: 2 }])
+     * // Result: (id) VALUES ($1), ($2)
+     */
+    insert: typeof valueClause;
+    /**
+     * Generates a SET clause for UPDATE queries from a JavaScript object.
+     *
+     * @example
+     * sql.update({ status: 'active', updated_at: new Date() })
+     * // Result: status = $1, updated_at = $2
+     */
+    update: typeof updateClause;
+    /**
+     * Safely escapes SQL identifiers (table or column names) using double quotes.
+     *
+     * @example
+     * sql.ident('users')
+     * // Result: "users"
+     *
+     * @example
+     * sql.ident('table.column')
+     * // Result: "table.column"
+     */
+    ident: typeof identClause;
+    /**
+     * Injects raw, unescaped SQL strings.
+     * ⚠️ Use with caution to prevent SQL injection!
+     *
+     * @example
+     * sql.literal('DESC')
+     * // Result: DESC
+     */
+    literal: typeof staticClause;
+    /**
+     * Creates a reusable, recursive SQL fragment.
+     * Fragments can be nested within each other; argument numbering is handled automatically.
+     *
+     * @example
+     * const filter = sql.fragment`age > ${18}`;
+     * sql`SELECT * FROM users WHERE ${filter} AND status = ${'active'}`
+     * // Result: SELECT * FROM users WHERE age > $1 AND status = $2
+     */
+    fragment: typeof fragmentClause;
+    /**
+     * Formats an array for dynamic lists (IN clauses, column lists, or joined conditions).
+     * Supports recursive Clauses (fragments, idents) within the array.
+     *
+     * @example
+     * // Case A: IN clause (manual brackets)
+     * sql`WHERE id IN (${sql.array([1, 2])})`
+     * // Result: WHERE id IN ($1, $2)
+     *
+     * @example
+     * // Case B: Dynamic WHERE conditions
+     * const conds = [sql.fragment`a = 1`, sql.fragment`b = ${2}`];
+     * sql`WHERE ${sql.array(conds, ' AND ')}`
+     * // Result: WHERE a = 1 AND b = $1
+     *
+     * @example
+     * // Case C: Column list
+     * sql`SELECT ${sql.array([sql.ident('id'), sql.ident('name')])}`
+     * // Result: SELECT "id", "name"
+     */
+    array: typeof arrayClause;
+};
+/**
+ * Main Pgtx Connection Pool.
+ * Manages connections, transactions (including SAVEPOINTs), and prepared statements.
+ */
+export declare const Pool: typeof PgtxPool;
 //# 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":""}
+{"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,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,GAAG;IACZ;;;;;;;;;;;OAWG;;IAGH;;;;;;OAMG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;CAEN,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,iBAAW,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pool = 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");
@@ -11,7 +12,7 @@ const values_clause_1 = require("./clauses/values.clause");
  * Core SQL tagging utility for Pgtx.
  * Provides type-safe helpers for building dynamic queries with recursive support.
  */
-const sql = {
+exports.sql = {
     /**
      * Creates a VALUES clause for INSERT queries.
      * Supports single objects and arrays of objects.
@@ -90,5 +91,4 @@ const sql = {
  * Main Pgtx Connection Pool.
  * Manages connections, transactions (including SAVEPOINTs), and prepared statements.
  */
-const Pool = pool_1.Pool;
-module.exports = [Pool, sql];
+exports.Pool = pool_1.Pool;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m2k-5f/pgtx", 
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Lightweight, high-performance SQL toolkit for node-postgres",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",