pgsql-deparser 14.0.0 → 14.1.0

package/README.md

@@ -80,12 +80,17 @@ npm install pgsql-deparser
 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
+npm install pgsql-deparser@pg13  # PostgreSQL 13
+npm install pgsql-deparser@pg14  # PostgreSQL 14
+npm install pgsql-deparser@pg15  # PostgreSQL 15
+npm install pgsql-deparser@pg16  # PostgreSQL 16
 ```
 
+**Version Status:**
+- **PG17**: 🚀 Recommended (stable + modern AST)
+- **PG14-16**: ⚠️ Experimental (modern AST, hardening in progress)
+- **PG13**: Stable (legacy AST format)
+
 ## Options
 
 The deparser accepts optional configuration for formatting and output control:
@@ -94,7 +99,7 @@ The deparser accepts optional configuration for formatting and output control:
 import { deparseSync as deparse } from 'pgsql-deparser';
 
 const options = {
-  pretty: true,           // Enable pretty formatting (default: false)
+  pretty: true,           // Enable pretty formatting (default: true)
   newline: '\n',         // Newline character (default: '\n')
   tab: '  ',             // Tab/indentation character (default: '  ')
   semicolons: true       // Add semicolons to statements (default: true)
@@ -105,7 +110,7 @@ const sql = deparse(ast, options);
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `pretty` | `boolean` | `false` | Enable pretty formatting with indentation and line breaks |
+| `pretty` | `boolean` | `true` | 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 |
@@ -150,6 +155,7 @@ Built on the excellent work of several contributors:
 * [@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.
+* [@pgsql/traverse](https://www.npmjs.com/package/@pgsql/traverse): PostgreSQL AST traversal utilities for pgsql-parser, providing a visitor pattern for traversing PostgreSQL Abstract Syntax Tree nodes, similar to Babel's traverse functionality but specifically designed for PostgreSQL AST structures.
 * [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.
 

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

@@ -36,7 +36,6 @@ export interface DeparserOptions {
  * compatibility and wraps them internally for consistent processing.
  */
 export declare class Deparser implements DeparserVisitor {
-    private formatter;
     private tree;
     private options;
     constructor(tree: any | any[] | any, opts?: DeparserOptions);
@@ -67,10 +66,11 @@ export declare class Deparser implements DeparserVisitor {
     RawStmt(node: any, context: DeparserContext): string;
     SelectStmt(node: any, context: DeparserContext): string;
     A_Expr(node: any, context: DeparserContext): string;
-    deparseOperatorName(name: any): string;
+    deparseOperatorName(name: any, context: DeparserContext): string;
     private getOperatorPrecedence;
     private needsParentheses;
     private isComplexExpression;
+    private isComplexSelectTarget;
     visitBetweenRange(rexpr: any, context: DeparserContext): string;
     InsertStmt(node: any, context: DeparserContext): string;
     UpdateStmt(node: any, context: DeparserContext): string;
@@ -90,6 +90,7 @@ export declare class Deparser implements DeparserVisitor {
     formatTypeMods(typmods: any, context: DeparserContext): string | null;
     formatSingleTypeMod(typemod: number, typeName: string): string | null;
     getPgCatalogTypeName(typeName: string, size: string | null): string;
+    isPgCatalogType(typeName: string): boolean;
     A_ArrayExpr(node: any, context: DeparserContext): string;
     A_Indices(node: any, context: DeparserContext): string;
     A_Indirection(node: any, context: DeparserContext): string;
@@ -117,7 +118,7 @@ export declare class Deparser implements DeparserVisitor {
     SubLink(node: any, context: DeparserContext): string;
     CaseWhen(node: any, context: DeparserContext): string;
     WindowDef(node: any, context: DeparserContext): string;
-    formatWindowFrame(node: any): string | null;
+    formatWindowFrame(node: any, context: DeparserContext): string | null;
     SortBy(node: any, context: DeparserContext): string;
     GroupingSet(node: any, context: DeparserContext): string;
     CommonTableExpr(node: any, context: DeparserContext): string;