pgsql-parser 14.0.0 → 15.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgsql-parser",
-  "version": "14.0.0",
+  "version": "15.0.0",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "description": "The real PostgreSQL query parser",
   "main": "index.js",
@@ -22,13 +22,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",
-    "build:dev": "npm run clean && tsc --declarationMap && tsc -p tsconfig.esm.json && npm run copy",
-    "lint": "eslint . --fix",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "publish:pkg": "npm publish --tag pg14"
+    "publish:pkg": "npm publish --tag pg15"
   },
   "keywords": [
     "sql",
@@ -40,8 +35,8 @@
     "database"
   ],
   "dependencies": {
-    "@pgsql/types": "14.1.1",
-    "libpg-query": "14.2.5",
-    "pgsql-deparser": "14.0.0"
+    "@pgsql/types": "15.1.1",
+    "libpg-query": "15.4.8",
+    "pgsql-deparser": "15.0.0"
   }
 }

package/dist/README.md

@@ -1,150 +0,0 @@
-# pgsql-parser 
-
-<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-parser"><img height="20" src="https://img.shields.io/npm/dt/pgsql-parser"></a>
-   <a href="https://www.npmjs.com/package/pgsql-parser"><img height="20" src="https://img.shields.io/npm/dw/pgsql-parser"/></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-parser"><img height="20" src="https://img.shields.io/github/package-json/v/launchql/pgsql-parser?filename=packages%2Fparser%2Fpackage.json"/></a>
-</p>
-
-The real PostgreSQL parser for Node.js. Built with the actual [PostgreSQL parser](https://github.com/pganalyze/libpg_query), `pgsql-parser` delivers true-to-spec SQL parsing and reconstruction. Transform SQL queries into ASTs, modify them programmatically, and convert them back to SQL with complete fidelity.
-
-## Installation
-
-```sh
-npm install pgsql-parser
-```
-
-## Features
-
-* 🔄 **Symmetric Parsing & Deparsing** – Parse SQL to AST and reconstruct it back to SQL with perfect round-trip accuracy
-* 🧪 **Battle-Tested Reliability** – Validated against 23,000+ SQL statements ensuring production-grade stability  
-* 🔧 **Direct from PostgreSQL** – Uses the official Postgres C parser compiled to WebAssembly for 100% spec compliance
-* 🚀 **WebAssembly Powered:** - Cross-platform compatibility without native dependencies.
-* 🛠️ **AST Manipulation:** - Easily modify parts of a SQL statement through the AST.
-
-## API
-
-The package exports both async and sync methods. Async methods handle initialization automatically, while sync methods require explicit initialization.
-
-⚠️ If you don't need the parser functionality, consider using the TS-only (no WASM, zero runtime dependencies) [`pgsql-deparser`](https://github.com/launchql/pgsql-parser/tree/main/packages/deparser) for a super fast, lightweight deparser. Battle-tested with 23,000+ SQL statements 🚀
-
-### Async Methods (Recommended)
-
-```typescript
-import { parse, deparse } from 'pgsql-parser';
-
-// Parse SQL to AST
-const stmts = await parse('SELECT * FROM test_table');
-
-// Deparse AST back to SQL
-const sql = await deparse(stmts);
-```
-
-### Sync Methods
-
-Sync methods require explicit initialization using `loadModule()`:
-
-```typescript
-import { loadModule, parseSync, deparseSync } from 'pgsql-parser';
-
-// Initialize first (required for sync methods)
-await loadModule();
-
-// Now safe to use sync methods
-const stmts = parseSync('SELECT * FROM test_table');
-const sql = deparseSync(stmts);
-```
-
-**Note:** We recommend using async methods as they handle initialization automatically. Use sync methods only when necessary, and always call `loadModule()` first.
-
-## Parser Example
-
-Rewrite part of a SQL query:
-
-```js
-import { parse, deparse } from 'pgsql-parser';
-
-const stmts = await parse('SELECT * FROM test_table');
-
-// Assuming the structure of stmts is known and matches the expected type
-stmts[0].RawStmt.stmt.SelectStmt.fromClause[0].RangeVar.relname = 'another_table';
-
-console.log(await deparse(stmts));
-
-// SELECT * FROM "another_table"
-```
-
-## 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 { 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(await deparse(stmt));
-
-// Output: SELECT * FROM another_table
-```
-
-## 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.

package/dist/package.json

@@ -1,47 +0,0 @@
-{
-  "name": "pgsql-parser",
-  "version": "14.0.0",
-  "author": "Dan Lynch <pyramation@gmail.com>",
-  "description": "The real PostgreSQL query parser",
-  "main": "index.js",
-  "module": "esm/index.js",
-  "types": "index.d.ts",
-  "homepage": "https://github.com/launchql/pgsql-parser",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public",
-    "directory": "dist"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/launchql/pgsql-parser"
-  },
-  "bugs": {
-    "url": "https://github.com/launchql/pgsql-parser/issues"
-  },
-  "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",
-    "build:dev": "npm run clean && tsc --declarationMap && tsc -p tsconfig.esm.json && npm run copy",
-    "lint": "eslint . --fix",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "publish:pkg": "npm publish --tag pg14"
-  },
-  "keywords": [
-    "sql",
-    "postgres",
-    "postgresql",
-    "pg",
-    "parser",
-    "query",
-    "database"
-  ],
-  "dependencies": {
-    "@pgsql/types": "14.1.1",
-    "libpg-query": "14.2.5",
-    "pgsql-deparser": "14.0.0"
-  }
-}

package/src/index.ts

@@ -1,12 +0,0 @@
-export {
-  parse as parse,
-  parseSync as parseSync,
-  loadModule as loadModule
-} from 'libpg-query';
-
-export {
-  deparse,
-  deparseSync,
-} from 'pgsql-deparser';
-
-export * from '@pgsql/types';

package/tsconfig.esm.json

@@ -1,9 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist/esm",
-    "module": "es2022",
-    "rootDir": "src/",
-    "declaration": false
-  }
-}

package/tsconfig.json

@@ -1,26 +0,0 @@
-{
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src/",
-    "target": "es2022",
-    "module": "commonjs",
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "strictNullChecks": false,
-    "skipLibCheck": true,
-    "sourceMap": false,
-    "declaration": true,
-    "resolveJsonModule": true,
-    "moduleResolution": "node"
-  },
-  "include": [
-    "src/**/*.ts"
-  ],
-  "exclude": [
-    "dist",
-    "node_modules",
-    "**/*.spec.*",
-    "**/*.test.*"
-  ]
-}