pgsql-deparser 14.0.0 → 15.0.0

package/{dist/esm → esm}/index.js

@@ -1,10 +1,10 @@
 /**
- * Deparser for PostgreSQL version 14
+ * Deparser for PostgreSQL version 15
  * Auto-generated by generate-version-deparsers.ts
  */
 import { deparse as deparse17, deparseSync as deparseSync17 } from './deparser';
-import { PG14ToPG17Transformer } from './v14-to-v17-direct';
-const tx = new PG14ToPG17Transformer();
+import { PG15ToPG17Transformer } from './v15-to-v17-direct';
+const tx = new PG15ToPG17Transformer();
 export async function deparse(query, opts) {
     const ast17 = tx.transform(query);
     return await deparse17(ast17, opts);

package/{dist/esm/v14-to-v17-direct.js → esm/v15-to-v17-direct.js}

@@ -2,35 +2,27 @@
  * Auto-generated file with types stripped for better tree-shaking
  * DO NOT EDIT - Generated by strip-direct-transformer-types.ts
  */
-import { V14ToV15Transformer } from "./v14-to-v15";
 import { V15ToV16Transformer } from "./v15-to-v16";
 import { V16ToV17Transformer } from "./v16-to-v17";
 /**
- * Direct transformer from PG14 to PG17
- * This transformer chains v14->v15->v16->v17 transformations
+ * Direct transformer from PG15 to PG17
+ * This transformer chains v15->v16->v17 transformations
  */
-export class PG14ToPG17Transformer {
-    v14to15 = new V14ToV15Transformer();
+export class PG15ToPG17Transformer {
     v15to16 = new V15ToV16Transformer();
     v16to17 = new V16ToV17Transformer();
     transform(node) {
         // If it's a ParseResult, handle it specially
         if (this.isParseResult(node)) {
-            // Transform through the chain: v14->v15->v16->v17
-            const v15Stmts = node.stmts.map((stmtWrapper) => {
-                if (stmtWrapper.stmt) {
-                    const v15Stmt = this.v14to15.transform(stmtWrapper.stmt, { parentNodeTypes: [] });
-                    return { ...stmtWrapper, stmt: v15Stmt };
-                }
-                return stmtWrapper;
-            });
-            const v16Stmts = v15Stmts.map((stmtWrapper) => {
+            // First transform statements from v15 to v16
+            const v16Stmts = node.stmts.map((stmtWrapper) => {
                 if (stmtWrapper.stmt) {
                     const v16Stmt = this.v15to16.transform(stmtWrapper.stmt, { parentNodeTypes: [] });
                     return { ...stmtWrapper, stmt: v16Stmt };
                 }
                 return stmtWrapper;
             });
+            // Then transform from v16 to v17
             const v17Stmts = v16Stmts.map((stmtWrapper) => {
                 if (stmtWrapper.stmt) {
                     const v17Stmt = this.v16to17.transform(stmtWrapper.stmt, { parentNodeTypes: [] });
@@ -45,17 +37,15 @@ export class PG14ToPG17Transformer {
             };
         }
         // Otherwise, transform as a regular node through the chain
-        const v15Node = this.v14to15.transform(node, { parentNodeTypes: [] });
-        const v16Node = this.v15to16.transform(v15Node, { parentNodeTypes: [] });
+        const v16Node = this.v15to16.transform(node, { parentNodeTypes: [] });
         return this.v16to17.transform(v16Node, { parentNodeTypes: [] });
     }
     /**
-     * Transform a single statement from PG14 to PG17
+     * Transform a single statement from PG15 to PG17
      * @deprecated Use transform() instead, which handles all node types
      */
     transformStatement(stmt) {
-        const v15Stmt = this.v14to15.transform(stmt, { parentNodeTypes: [] });
-        const v16Stmt = this.v15to16.transform(v15Stmt, { parentNodeTypes: [] });
+        const v16Stmt = this.v15to16.transform(stmt, { parentNodeTypes: [] });
         return this.v16to17.transform(v16Stmt, { parentNodeTypes: [] });
     }
     /**

package/{dist/index.d.ts → index.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Deparser for PostgreSQL version 14
+ * Deparser for PostgreSQL version 15
  * Auto-generated by generate-version-deparsers.ts
  */
 import { Node, ParseResult } from '@pgsql/types';

package/{dist/index.js → index.js}

@@ -1,14 +1,14 @@
 "use strict";
 /**
- * Deparser for PostgreSQL version 14
+ * Deparser for PostgreSQL version 15
  * Auto-generated by generate-version-deparsers.ts
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deparse = deparse;
 exports.deparseSync = deparseSync;
 const deparser_1 = require("./deparser");
-const v14_to_v17_direct_1 = require("./v14-to-v17-direct");
-const tx = new v14_to_v17_direct_1.PG14ToPG17Transformer();
+const v15_to_v17_direct_1 = require("./v15-to-v17-direct");
+const tx = new v15_to_v17_direct_1.PG15ToPG17Transformer();
 async function deparse(query, opts) {
     const ast17 = tx.transform(query);
     return await (0, deparser_1.deparse)(ast17, opts);

package/package.json

@@ -9,9 +9,8 @@
   "scripts": {
     "copy": "copyfiles -f ../../../../LICENSE README.md package.json dist",
     "clean": "rimraf dist",
-    "prepare": "npm run build",
     "build": "npm run clean && tsc && tsc -p tsconfig.esm.json && npm run copy",
-    "publish:pkg": "npm publish --tag pg14"
+    "publish:pkg": "npm publish --tag pg15"
   },
   "publishConfig": {
     "access": "public",
@@ -35,8 +34,8 @@
     "database"
   ],
   "name": "pgsql-deparser",
-  "version": "14.0.0",
+  "version": "15.0.0",
   "dependencies": {
-    "@pgsql/types": "^14.1.1"
+    "@pgsql/types": "^15.1.1"
   }
 }

package/{dist/v14-to-v17-direct.d.ts → v15-to-v17-direct.d.ts}

@@ -3,16 +3,15 @@
  * DO NOT EDIT - Generated by strip-direct-transformer-types.ts
  */
 /**
- * Direct transformer from PG14 to PG17
- * This transformer chains v14->v15->v16->v17 transformations
+ * Direct transformer from PG15 to PG17
+ * This transformer chains v15->v16->v17 transformations
  */
-export declare class PG14ToPG17Transformer {
-    private v14to15;
+export declare class PG15ToPG17Transformer {
     private v15to16;
     private v16to17;
     transform(node: any): any;
     /**
-     * Transform a single statement from PG14 to PG17
+     * Transform a single statement from PG15 to PG17
      * @deprecated Use transform() instead, which handles all node types
      */
     transformStatement(stmt: any): any;

package/{dist/v14-to-v17-direct.js → v15-to-v17-direct.js}

@@ -4,36 +4,28 @@
  * DO NOT EDIT - Generated by strip-direct-transformer-types.ts
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PG14ToPG17Transformer = void 0;
-const v14_to_v15_1 = require("./v14-to-v15");
+exports.PG15ToPG17Transformer = void 0;
 const v15_to_v16_1 = require("./v15-to-v16");
 const v16_to_v17_1 = require("./v16-to-v17");
 /**
- * Direct transformer from PG14 to PG17
- * This transformer chains v14->v15->v16->v17 transformations
+ * Direct transformer from PG15 to PG17
+ * This transformer chains v15->v16->v17 transformations
  */
-class PG14ToPG17Transformer {
-    v14to15 = new v14_to_v15_1.V14ToV15Transformer();
+class PG15ToPG17Transformer {
     v15to16 = new v15_to_v16_1.V15ToV16Transformer();
     v16to17 = new v16_to_v17_1.V16ToV17Transformer();
     transform(node) {
         // If it's a ParseResult, handle it specially
         if (this.isParseResult(node)) {
-            // Transform through the chain: v14->v15->v16->v17
-            const v15Stmts = node.stmts.map((stmtWrapper) => {
-                if (stmtWrapper.stmt) {
-                    const v15Stmt = this.v14to15.transform(stmtWrapper.stmt, { parentNodeTypes: [] });
-                    return { ...stmtWrapper, stmt: v15Stmt };
-                }
-                return stmtWrapper;
-            });
-            const v16Stmts = v15Stmts.map((stmtWrapper) => {
+            // First transform statements from v15 to v16
+            const v16Stmts = node.stmts.map((stmtWrapper) => {
                 if (stmtWrapper.stmt) {
                     const v16Stmt = this.v15to16.transform(stmtWrapper.stmt, { parentNodeTypes: [] });
                     return { ...stmtWrapper, stmt: v16Stmt };
                 }
                 return stmtWrapper;
             });
+            // Then transform from v16 to v17
             const v17Stmts = v16Stmts.map((stmtWrapper) => {
                 if (stmtWrapper.stmt) {
                     const v17Stmt = this.v16to17.transform(stmtWrapper.stmt, { parentNodeTypes: [] });
@@ -48,17 +40,15 @@ class PG14ToPG17Transformer {
             };
         }
         // Otherwise, transform as a regular node through the chain
-        const v15Node = this.v14to15.transform(node, { parentNodeTypes: [] });
-        const v16Node = this.v15to16.transform(v15Node, { parentNodeTypes: [] });
+        const v16Node = this.v15to16.transform(node, { parentNodeTypes: [] });
         return this.v16to17.transform(v16Node, { parentNodeTypes: [] });
     }
     /**
-     * Transform a single statement from PG14 to PG17
+     * Transform a single statement from PG15 to PG17
      * @deprecated Use transform() instead, which handles all node types
      */
     transformStatement(stmt) {
-        const v15Stmt = this.v14to15.transform(stmt, { parentNodeTypes: [] });
-        const v16Stmt = this.v15to16.transform(v15Stmt, { parentNodeTypes: [] });
+        const v16Stmt = this.v15to16.transform(stmt, { parentNodeTypes: [] });
         return this.v16to17.transform(v16Stmt, { parentNodeTypes: [] });
     }
     /**
@@ -68,4 +58,4 @@ class PG14ToPG17Transformer {
         return node && typeof node === 'object' && 'version' in node && 'stmts' in node;
     }
 }
-exports.PG14ToPG17Transformer = PG14ToPG17Transformer;
+exports.PG15ToPG17Transformer = PG15ToPG17Transformer;

package/dist/README.md

@@ -1,160 +0,0 @@
-# pgsql-deparser 
-
-<p align="center" width="100%">
-  <img height="120" src="https://github.com/launchql/pgsql-parser/assets/545047/6440fa7d-918b-4a3b-8d1b-755d85de8bea" />
-</p>
-
-<p align="center" width="100%">
-  <a href="https://github.com/launchql/pgsql-parser/actions/workflows/run-tests.yaml">
-    <img height="20" src="https://github.com/launchql/pgsql-parser/actions/workflows/run-tests.yaml/badge.svg" />
-  </a>
-   <a href="https://www.npmjs.com/package/pgsql-deparser"><img height="20" src="https://img.shields.io/npm/dt/pgsql-deparser"></a>
-   <a href="https://www.npmjs.com/package/pgsql-deparser"><img height="20" src="https://img.shields.io/npm/dw/pgsql-deparser"/></a>
-   <a href="https://github.com/launchql/pgsql-parser/blob/main/LICENSE-MIT"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
-   <a href="https://www.npmjs.com/package/pgsql-deparser"><img height="20" src="https://img.shields.io/github/package-json/v/launchql/pgsql-parser?filename=packages%2Fdeparser%2Fpackage.json"/></a>
-</p>
-
-`pgsql-deparser` is the lightning-fast, pure TypeScript solution for converting PostgreSQL ASTs back into SQL queries. Perfect companion to [`pgsql-parser`](https://github.com/launchql/pgsql-parser), this focused tool delivers SQL generation without any native dependencies or WebAssembly overhead.
-
-## Installation
-
-```sh
-npm install pgsql-deparser
-```
-
-## Features
-
-* ⚡ **Pure TypeScript Performance** – Zero runtime dependencies, no WASM, no compilation - just blazing fast SQL generation
-* 🪶 **Ultra Lightweight** – Minimal footprint with laser-focused functionality for AST-to-SQL conversion only
-* 🧪 **Battle-Tested Reliability** – Validated against 23,000+ SQL statements ensuring production-grade stability
-* 🌍 **Universal Compatibility** – Runs anywhere JavaScript does - browsers, Node.js, edge functions, you name it
-
-## Deparser Example
-
-The `pgsql-deparser` module serializes ASTs to SQL in pure TypeScript, avoiding the full parser's native dependencies. It's useful when only SQL string conversion from ASTs is needed, and is written in pure TypeScript for easy cross-environment deployment.
-
-Here's how you can use the deparser in your TypeScript code, using [`@pgsql/utils`](https://github.com/launchql/pgsql-parser/tree/main/packages/utils) to create an AST for `deparse`:
-
-```ts
-import * as t from '@pgsql/utils';
-import { RangeVar, SelectStmt } from '@pgsql/types';
-import { deparseSync as deparse } from 'pgsql-deparser';
-
-// This could have been obtained from any JSON or AST, not necessarily @pgsql/utils
-const stmt: { SelectStmt: SelectStmt } = t.nodes.selectStmt({
-  targetList: [
-    t.nodes.resTarget({
-      val: t.nodes.columnRef({
-        fields: [t.nodes.aStar()]
-      })
-    })
-  ],
-  fromClause: [
-    t.nodes.rangeVar({
-      relname: 'some_table',
-      inh: true,
-      relpersistence: 'p'
-    })
-  ],
-  limitOption: 'LIMIT_OPTION_DEFAULT',
-  op: 'SETOP_NONE'
-});
-
-// Modify the AST if needed  
-(stmt.SelectStmt.fromClause[0] as {RangeVar: RangeVar}).RangeVar.relname = 'another_table';
-
-// Deparse the modified AST back to a SQL string
-console.log(deparse(stmt));
-
-// Output: SELECT * FROM another_table
-```
-
-### Latest Version (PostgreSQL 17)
-
-```sh
-npm install pgsql-deparser
-```
-
-### Version-Specific Packages (PostgreSQL 13-16)
-
-While we highly recommend using PG17, for PostgreSQL versions 13-16, use the version-specific packages:
-
-```sh
-npm install pgsql-deparser@v13  # PostgreSQL 13
-npm install pgsql-deparser@v14  # PostgreSQL 14
-npm install pgsql-deparser@v15  # PostgreSQL 15
-npm install pgsql-deparser@v16  # PostgreSQL 16
-```
-
-## Options
-
-The deparser accepts optional configuration for formatting and output control:
-
-```ts
-import { deparseSync as deparse } from 'pgsql-deparser';
-
-const options = {
-  pretty: true,           // Enable pretty formatting (default: false)
-  newline: '\n',         // Newline character (default: '\n')
-  tab: '  ',             // Tab/indentation character (default: '  ')
-  semicolons: true       // Add semicolons to statements (default: true)
-};
-
-const sql = deparse(ast, options);
-```
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `pretty` | `boolean` | `false` | Enable pretty formatting with indentation and line breaks |
-| `newline` | `string` | `'\n'` | Character(s) used for line breaks |
-| `tab` | `string` | `'  '` | Character(s) used for indentation |
-| `semicolons` | `boolean` | `true` | Add semicolons to SQL statements |
-
-**Pretty formatting example:**
-```ts
-// Without pretty formatting
-const sql1 = deparse(selectAst, { pretty: false });
-// "SELECT id, name FROM users WHERE active = true;"
-
-// With pretty formatting  
-const sql2 = deparse(selectAst, { pretty: true });
-// SELECT
-//   id,
-//   name
-// FROM users
-// WHERE
-//   active = true;
-```
-
-For complete documentation and advanced options, see [DEPARSER_USAGE.md](../../DEPARSER_USAGE.md).
-
-## Why Use `pgsql-deparser`?
-
-`pgsql-deparser` is particularly useful in development environments where native dependencies are problematic or in applications where only the deparser functionality is required. Its independence from the full `pgsql-parser` package allows for more focused and lightweight SQL generation tasks.
-
-## Credits
-
-Built on the excellent work of several contributors:
-
-* **[Dan Lynch](https://github.com/pyramation)** — official maintainer since 2018 and architect of the current implementation
-* **[Lukas Fittl](https://github.com/lfittl)** for [libpg_query](https://github.com/pganalyze/libpg_query) — the core PostgreSQL parser that powers this project
-* **[Greg Richardson](https://github.com/gregnr)** for AST guidance and pushing the transition to WASM and multiple PG runtimes for better interoperability
-* **[Ethan Resnick](https://github.com/ethanresnick)** for the original Node.js N-API bindings
-* **[Zac McCormick](https://github.com/zhm)** for the foundational [node-pg-query-native](https://github.com/zhm/node-pg-query-native) parser
-
-## Related
-
-* [pgsql-parser](https://www.npmjs.com/package/pgsql-parser): The real PostgreSQL parser for Node.js, providing symmetric parsing and deparsing of SQL statements with actual PostgreSQL parser integration.
-* [pgsql-deparser](https://www.npmjs.com/package/pgsql-deparser): A streamlined tool designed for converting PostgreSQL ASTs back into SQL queries, focusing solely on deparser functionality to complement `pgsql-parser`.
-* [@pgsql/parser](https://www.npmjs.com/package/@pgsql/parser): Multi-version PostgreSQL parser with dynamic version selection at runtime, supporting PostgreSQL 15, 16, and 17 in a single package.
-* [@pgsql/types](https://www.npmjs.com/package/@pgsql/types): Offers TypeScript type definitions for PostgreSQL AST nodes, facilitating type-safe construction, analysis, and manipulation of ASTs.
-* [@pgsql/enums](https://www.npmjs.com/package/@pgsql/enums): Provides TypeScript enum definitions for PostgreSQL constants, enabling type-safe usage of PostgreSQL enums and constants in your applications.
-* [@pgsql/utils](https://www.npmjs.com/package/@pgsql/utils): A comprehensive utility library for PostgreSQL, offering type-safe AST node creation and enum value conversions, simplifying the construction and manipulation of PostgreSQL ASTs.
-* [pg-proto-parser](https://www.npmjs.com/package/pg-proto-parser): A TypeScript tool that parses PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
-* [libpg-query](https://github.com/launchql/libpg-query-node): The real PostgreSQL parser exposed for Node.js, used primarily in `pgsql-parser` for parsing and deparsing SQL queries.
-
-## Disclaimer
-
-AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
-
-No developer or entity involved in creating Software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the Software code or Software CLI, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.