Don't shadow the global SyntaxError

Author: matt-aitken

internal-packages/tsql/src/index.ts

@@ -1,22 +1,17 @@
 // TSQL - Type-Safe SQL Query Language for ClickHouse
 // Originally derived from PostHog's HogQL (see NOTICE.md for attribution)
 
-import { CharStreams, CommonTokenStream } from "antlr4ts";
 import type { ANTLRErrorListener, RecognitionException, Recognizer } from "antlr4ts";
+import { CharStreams, CommonTokenStream } from "antlr4ts";
 import type { Token } from "antlr4ts/Token";
 import { TSQLLexer } from "./grammar/TSQLLexer.js";
 import { TSQLParser } from "./grammar/TSQLParser.js";
+import type { Expression, SelectQuery, SelectSetQuery } from "./query/ast.js";
+import { SyntaxError as TSQLSyntaxError } from "./query/errors.js";
 import { TSQLParseTreeConverter } from "./query/parser.js";
-import type { SelectQuery, SelectSetQuery, Expression } from "./query/ast.js";
-import { SyntaxError } from "./query/errors.js";
-import {
-  createSchemaRegistry,
-  type TableSchema,
-  type FieldMappings,
-  type RequiredFilter,
-} from "./query/schema.js";
-import { createPrinterContext, type QuerySettings } from "./query/printer_context.js";
 import { printToClickHouse, type PrintResult } from "./query/printer.js";
+import { createPrinterContext, type QuerySettings } from "./query/printer_context.js";
+import { createSchemaRegistry, type FieldMappings, type TableSchema } from "./query/schema.js";
 
 /**
  * Simple error listener that captures syntax errors
@@ -45,65 +40,65 @@ export * from "./query/errors.js";
 // Re-export escape utilities
 export {
   escapeClickHouseIdentifier,
-  escapeTSQLIdentifier,
   escapeClickHouseString,
+  escapeTSQLIdentifier,
   escapeTSQLString,
   getClickHouseType,
 } from "./query/escape.js";
 
 // Re-export function definitions
 export {
-  TSQL_CLICKHOUSE_FUNCTIONS,
-  TSQL_AGGREGATIONS,
-  TSQL_COMPARISON_MAPPING,
   findTSQLAggregation,
   findTSQLFunction,
   getAllExposedFunctionNames,
+  TSQL_AGGREGATIONS,
+  TSQL_CLICKHOUSE_FUNCTIONS,
+  TSQL_COMPARISON_MAPPING,
   type TSQLFunctionMeta,
 } from "./query/functions.js";
 
 // Re-export schema types and functions
 export {
-  type TableSchema,
-  type ColumnSchema,
-  type TenantColumnConfig,
-  type RequiredFilter,
-  type SchemaRegistry,
-  type ClickHouseType,
-  type OutputColumnMetadata,
-  type FieldMappings,
+  column,
   createSchemaRegistry,
-  findTable,
   findColumn,
-  validateTable,
-  validateSelectColumn,
-  validateFilterColumn,
-  validateSortColumn,
-  validateGroupColumn,
-  column,
+  findTable,
+  getAllowedUserValues,
+  getExternalValue,
+  getInternalValue,
+  getInternalValueFromMapping,
+  getInternalValueFromMappingCaseInsensitive,
   // Value mapping utilities
   getUserFriendlyValue,
-  getInternalValue,
-  getAllowedUserValues,
-  isValidUserValue,
-  // Virtual column utilities
-  isVirtualColumn,
   getVirtualColumnExpression,
   // Field mapping utilities (runtime dynamic mappings)
   hasFieldMapping,
-  getExternalValue,
-  getInternalValueFromMapping,
-  getInternalValueFromMappingCaseInsensitive,
+  isValidUserValue,
+  // Virtual column utilities
+  isVirtualColumn,
+  validateFilterColumn,
+  validateGroupColumn,
+  validateSelectColumn,
+  validateSortColumn,
+  validateTable,
+  type ClickHouseType,
+  type ColumnSchema,
+  type FieldMappings,
+  type OutputColumnMetadata,
+  type RequiredFilter,
+  type SchemaRegistry,
+  type TableSchema,
+  type TenantColumnConfig,
 } from "./query/schema.js";
 
 // Re-export printer context
 export {
-  PrinterContext,
   createPrinterContext,
+  DEFAULT_QUERY_SETTINGS,
+  PrinterContext,
   type PrinterContextOptions,
-  type QuerySettings,
   type QueryNotice,
-  DEFAULT_QUERY_SETTINGS,
+  type QuerySettings,
 } from "./query/printer_context.js";
 
 // Re-export printer
@@ -115,15 +110,15 @@ export { TSQLParseTreeConverter } from "./query/parser.js";
 // Re-export validator
 export {
   validateQuery,
-  type ValidationResult,
   type ValidationIssue,
+  type ValidationResult,
   type ValidationSeverity,
 } from "./query/validator.js";
 
 // Re-export result transformation utilities
 export {
-  transformResults,
   createResultTransformer,
+  transformResults,
   type TransformResultsOptions,
 } from "./query/results.js";
 
@@ -132,7 +127,7 @@ export {
  *
  * @param query - The TSQL query string to parse
  * @returns The parsed AST (SelectQuery or SelectSetQuery)
- * @throws SyntaxError if the query is invalid
+ * @throws TSQLSyntaxError if the query is invalid
  *
  * @example
  * ```typescript
@@ -153,19 +148,19 @@ export function parseTSQLSelect(query: string): SelectQuery | SelectSetQuery {
   const parseTree = parser.select();
 
   if (errorListener.error) {
-    throw new SyntaxError(errorListener.error);
+    throw new TSQLSyntaxError(errorListener.error);
   }
 
   const converter = new TSQLParseTreeConverter();
   const ast = converter.visit(parseTree);
 
   // Validate the result is a select query
   if (typeof ast === "string" || !("expression_type" in ast)) {
-    throw new SyntaxError("Failed to parse SELECT query");
+    throw new TSQLSyntaxError("Failed to parse SELECT query");
   }
 
   if (ast.expression_type !== "select_query" && ast.expression_type !== "select_set_query") {
-    throw new SyntaxError(`Expected SELECT query, got ${ast.expression_type}`);
+    throw new TSQLSyntaxError(`Expected SELECT query, got ${ast.expression_type}`);
   }
 
   return ast as SelectQuery | SelectSetQuery;
@@ -176,7 +171,7 @@ export function parseTSQLSelect(query: string): SelectQuery | SelectSetQuery {
  *
  * @param expr - The TSQL expression string to parse
  * @returns The parsed expression AST
- * @throws SyntaxError if the expression is invalid
+ * @throws TSQLSyntaxError if the expression is invalid
  *
  * @example
  * ```typescript
@@ -197,7 +192,7 @@ export function parseTSQLExpr(expr: string): Expression {
   const parseTree = parser.columnExpr(0);
 
   if (errorListener.error) {
-    throw new SyntaxError(errorListener.error);
+    throw new TSQLSyntaxError(errorListener.error);
   }
 
   const converter = new TSQLParseTreeConverter();
@@ -244,7 +239,7 @@ export interface CompileTSQLOptions {
  * @param query - The TSQL query string to compile
  * @param options - Compilation options including tenant IDs and schema
  * @returns The compiled SQL and parameters
- * @throws SyntaxError if the query is invalid
+ * @throws TSQLSyntaxError if the query is invalid
  * @throws QueryError if tables/columns are not allowed
  *
  * @example