rawsql-ts 0.11.43-beta → 0.12.0

package/README.md

@@ -258,12 +258,12 @@ const customStyle = {
   parameterStyle: "named",
   indentSize: 4,
   indentChar: "space",
-  newline: "lf",
-  keywordCase: "lower",
-  commaBreak: "before",
-  andBreak: "before",
-  orBreak: "before"
-};
+  newline: "lf",
+  keywordCase: "lower",
+  commaBreak: "before",
+  andBreak: "before",
+  orBreak: "before"
+};
 
 const sqlToFormat = `SELECT u.user_id, u.user_name FROM users as u WHERE status = :active ORDER BY created_at DESC;`;
 const queryToFormat = SelectQueryParser.parse(sqlToFormat);
@@ -293,7 +293,7 @@ import { SqlFormatter } from 'rawsql-ts';
 
 // Enable comment export (disabled by default for backward compatibility)
 const formatter = new SqlFormatter({ 
-  exportComment: true,
+  exportComment: 'full',
 });
 
 const sqlWithComments = `
@@ -316,7 +316,7 @@ console.log(formattedSql);
 - **Full Comment Parsing**: Supports both `--` line comments and `/* */` block comments
 - **AST Preservation**: Comments are stored in the Abstract Syntax Tree and preserved throughout transformations
 - **Safe Export**: Line comments are automatically converted to block comments during export to prevent SQL structure issues
-- **Configurable Export**: Enable/disable comment export with `exportComment` option
+- **Configurable Export**: Choose `exportComment` = "full", "none", "header-only" (only header annotations), or "top-header-only" (outermost header only) to control comment emission
 - **Comment Editing API**: Programmatically add, edit, delete, and search comments using the `CommentEditor` class
 - **Clause Association**: Comments can be associated with specific SQL clauses and keywords
 
@@ -532,7 +532,7 @@ Key benefits include:
 - **Framework-Agnostic**: Pure JavaScript/TypeScript with no file system dependencies
 - **Composable Architecture**: Internally uses specialized injectors in optimal order for performance
 - **Type-Safe**: Full TypeScript support with strongly typed options and return values
-- **Performance Optimized**: Applies conditions in the most efficient order (filter → sort → paginate → serialize)
+- **Performance Optimized**: Applies conditions in the most efficient order (filter -> sort -> paginate -> serialize)
 - **Easy Testing**: No external dependencies make unit testing straightforward
 
 ```typescript
@@ -863,9 +863,9 @@ Node.js v22.14.0
 ### Performance Summary
 
 - `rawsql-ts` remains one of the fastest parsers, though it is approximately 10% slower in version 0.7 compared to previous versions. This is due to the addition of enhanced parameterized query parsing and SQL formatting capabilities.
-- About 3–4x faster than `node-sql-parser`.
-- About 4–5x faster than `sql-parser-cst`.
-- About 7–8x faster than `sql-formatter`.
+- About 3x faster than `node-sql-parser`.
+- About 4x faster than `sql-parser-cst`.
+- About 7x faster than `sql-formatter`.
 - Maintains high performance even for complex SQL, while providing comprehensive features.
 
 > **Note:** These benchmarks are based on a specific hardware and software environment. Actual performance may vary depending on system configuration and query complexity.

package/dist/esm/index.js

@@ -1,7 +1,18 @@
 // Entry point for rawsql-ts package
+export * from './src/parsers/SqlParser';
 export * from './src/parsers/SelectQueryParser';
 export * from './src/parsers/InsertQueryParser';
+export * from './src/parsers/UpdateQueryParser';
+export * from './src/parsers/DeleteQueryParser';
 export * from './src/parsers/WithClauseParser';
+export * from './src/parsers/CreateTableParser';
+export * from './src/parsers/MergeQueryParser';
+export * from './src/parsers/CreateIndexParser';
+export * from './src/parsers/DropTableParser';
+export * from './src/parsers/DropIndexParser';
+export * from './src/parsers/AlterTableParser';
+export * from './src/parsers/DropConstraintParser';
+export * from './src/types/Formatting';
 export * from './src/models/BinarySelectQuery';
 export * from './src/models/SelectQuery';
 export * from './src/models/SqlComponent';
@@ -10,6 +21,12 @@ export * from './src/models/ValuesQuery';
 export * from './src/models/CTEError';
 export * from './src/models/Lexeme';
 export * from './src/models/FormattingLexeme';
+export * from './src/models/InsertQuery';
+export * from './src/models/UpdateQuery';
+export * from './src/models/DeleteQuery';
+export * from './src/models/CreateTableQuery';
+export * from './src/models/MergeQuery';
+export * from './src/models/DDLStatements';
 export * from './src/transformers/CTECollector';
 export * from './src/transformers/CTENormalizer';
 export * from './src/transformers/CTEDisabler';
@@ -27,6 +44,7 @@ export * from './src/transformers/Formatter';
 export * from './src/transformers/SqlFormatter';
 export * from './src/transformers/PostgresJsonQueryBuilder';
 export * from './src/transformers/QueryBuilder'; // old name:QueryConverter
+export * from './src/transformers/InsertQuerySelectValuesConverter';
 export * from './src/transformers/SelectValueCollector';
 export * from './src/transformers/SelectableColumnCollector';
 export { DuplicateDetectionMode } from './src/transformers/SelectableColumnCollector';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAE1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAElD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AAEpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,6BAA6B,CAAC,CAAC,0BAA0B;AACvE,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,oCAAoC,CAAC;AACnD,OAAO,EAEH,yBAAyB,EACzB,0BAA0B,EAK7B,MAAM,uCAAuC,CAAC;AAC/C,OAAO;AACH,6DAA6D;AAC7D,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACjB,MAAM,mCAAmC,CAAC;AAE3C,qEAAqE;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,cAAc,0CAA0C,CAAC;AACzD,cAAc,gDAAgD,CAAC;AAE/D,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAwB,MAAM,gCAAgC,CAAC;AACnF,cAAc,wCAAwC,CAAC;AACvD,OAAO,EAAE,cAAc,EAAkC,MAAM,wCAAwC,CAAC;AACxG,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAErC,cAAc,2BAA2B,CAAC;AAG1C,kDAAkD;AAClD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,uBAAuB,CAAC;AAOtC,cAAc,6BAA6B,CAAC;AAK5C,cAAc,4BAA4B,CAAC;AAG3C,qDAAqD;AACrD,OAAO;AACH,0DAA0D;AAC1D,eAAe;AACf,8CAA8C;AAC9C,gBAAgB;AAChB,mDAAmD;AACnD,YAAY;AACZ,yDAAyD;AACzD,YAAY;AACZ,2DAA2D;AAC3D,mBAAmB;AACnB,yDAAyD;AACzD,wBAAwB,EAC3B,MAAM,yBAAyB,CAAC;AAGjC,oEAAoE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}