rawsql-ts 0.8.3-beta → 0.10.0-beta

package/dist/esm/transformers/UpstreamSelectQueryFinder.js.map

@@ -1 +1 @@
-{"version":3,"file":"UpstreamSelectQueryFinder.js","sourceRoot":"","sources":["../../../src/transformers/UpstreamSelectQueryFinder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"UpstreamSelectQueryFinder.js","sourceRoot":"","sources":["../../../src/transformers/UpstreamSelectQueryFinder.ts"],"names":[],"mappings":"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"}

package/dist/esm/types/index.d.ts

@@ -8,6 +8,7 @@ export * from './transformers/CTECollector';
 export * from './transformers/CTENormalizer';
 export * from './transformers/Formatter';
 export * from './transformers/SqlFormatter';
+export * from './transformers/PostgreJsonQueryBuilder';
 export * from './transformers/QueryBuilder';
 export * from './transformers/SelectValueCollector';
 export * from './transformers/SelectableColumnCollector';
@@ -15,4 +16,5 @@ export * from './transformers/TableColumnResolver';
 export * from './transformers/TableSourceCollector';
 export * from './transformers/UpstreamSelectQueryFinder';
 export * from './transformers/SchemaCollector';
+export * from './transformers/SqlParamInjector';
 export * from './utils/SqlSchemaValidator';

package/dist/esm/types/models/SqlPrintToken.d.ts

@@ -27,6 +27,8 @@ export declare enum SqlPrintTokenContainerType {
     SwitchCaseArgument = "SwitchCaseArgument",
     ElseClause = "ElseClause",
     CaseKeyValuePair = "CaseKeyValuePair",
+    CaseThenValue = "CaseThenValue",
+    CaseElseValue = "CaseElseValue",
     ParenExpression = "ParenExpression",
     CastExpression = "CastExpression",
     CaseExpression = "CaseExpression",

package/dist/esm/types/models/ValueComponent.d.ts

@@ -32,7 +32,7 @@ export declare class FunctionCall extends SqlComponent {
     qualifiedName: QualifiedName;
     argument: ValueComponent | null;
     over: OverExpression | null;
-    constructor(namespaces: string[] | IdentifierString[] | null, name: string | RawString | IdentifierString, argument: ValueComponent | null, over: OverExpression | null);
+    constructor(namespaces: string | string[] | IdentifierString[] | null, name: string | RawString | IdentifierString, argument: ValueComponent | null, over: OverExpression | null);
     /**
      * For backward compatibility: returns the namespaces as IdentifierString[] | null (readonly)
      */
@@ -103,7 +103,7 @@ export declare class ParameterExpression extends SqlComponent {
     value: any | null;
     /**
      * The index assigned by the formatter when generating parameterized queries.
-     * This is used for naming parameters like $1, $2, ...
+     * Used for naming parameters like $1, $2, etc.
      */
     index: number | null;
     constructor(name: string, value?: any | null);
@@ -195,7 +195,7 @@ export declare class QualifiedName extends SqlComponent {
     namespaces: IdentifierString[] | null;
     /** The actual name (e.g. table, function, type, column) */
     name: RawString | IdentifierString;
-    constructor(namespaces: string[] | IdentifierString[] | null, name: string | RawString | IdentifierString);
+    constructor(namespaces: string | string[] | IdentifierString[] | null, name: string | RawString | IdentifierString);
     /** Returns the full qualified name as a string (dot-separated) */
     toString(): string;
 }

package/dist/esm/types/transformers/PostgreJsonQueryBuilder.d.ts

@@ -0,0 +1,78 @@
+import { SimpleSelectQuery } from '../models/SimpleSelectQuery';
+/**
+ * Universal JSON mapping definition for creating any level of JSON structures.
+ * Supports flat arrays, nested objects, and unlimited hierarchical structures.
+ */
+export interface JsonMapping {
+    rootName: string;
+    rootEntity: {
+        id: string;
+        name: string;
+        columns: {
+            [jsonKey: string]: string;
+        };
+    };
+    nestedEntities: Array<{
+        id: string;
+        name: string;
+        parentId: string;
+        propertyName: string;
+        relationshipType?: "object" | "array";
+        columns: {
+            [jsonKey: string]: string;
+        };
+    }>;
+    useJsonb?: boolean;
+    resultFormat?: "array" | "single";
+    emptyResult?: string;
+}
+/**
+ * PostgreSQL JSON query builder that transforms SimpleSelectQuery into queries
+ * that return JSON arrays or single JSON objects using PostgreSQL JSON functions.
+ */
+export declare class PostgreJsonQueryBuilder {
+    private selectValueCollector;
+    private objectEntityCteBuilder;
+    private arrayEntityCteBuilder;
+    constructor();
+    /**
+     * Validates the JSON mapping and the original query.
+     * @param query Original query to transform
+     * @param mapping JSON mapping configuration
+     */
+    private validateMapping;
+    /**
+     * Build JSON query from original query and mapping configuration.
+     * @param originalQuery Original query to transform
+     * @param mapping JSON mapping configuration
+     * @returns Transformed query with JSON aggregation
+     */
+    buildJson(originalQuery: SimpleSelectQuery, mapping: JsonMapping): SimpleSelectQuery;
+    /**
+     * Builds the JSON structure using a unified CTE-based strategy.
+     * @param originalQuery Original query
+     * @param mapping JSON mapping configuration
+     * @returns Query with CTE-based JSON aggregation
+     */
+    private buildJsonWithCteStrategy;
+    /**
+     * Creates the initial Common Table Expression (CTE) from the original query.
+     * @param originalQuery The base SimpleSelectQuery.
+     * @returns An object containing the initial CTE and its alias.
+     */
+    private createInitialCte;
+    /**
+     * Builds the final SELECT query that constructs the root JSON object (or array of objects).
+     * This query uses all previously generated CTEs.
+     * @param finalCtesList The complete list of all CTEs (initial and array CTEs).
+     * @param lastCteAliasForFromClause Alias of the final CTE from which the root object will be built.
+     * @param allEntities Map of all processable entities.
+     * @param mapping JSON mapping configuration.
+     * @returns The final SimpleSelectQuery.
+     */
+    private buildFinalSelectQuery;
+    /**
+     * Build JSON object for entity, using parent JSON columns when available
+     */
+    private buildEntityJsonObject;
+}

package/dist/esm/types/transformers/PostgresArrayEntityCteBuilder.d.ts

@@ -0,0 +1,97 @@
+import { CommonTable } from '../models/Clause';
+import { JsonMapping } from './PostgreJsonQueryBuilder';
+import { ProcessableEntity } from './PostgresObjectEntityCteBuilder';
+/**
+ * PostgreSQL-specific builder for creating CTEs for array entities (array relationships).
+ * This class handles the creation of CTEs that build JSON/JSONB arrays for child entities,
+ * processing them from the deepest level up to ensure proper dependency ordering.
+ *
+ * Features:
+ * - Depth-based CTE naming (cte_array_depth_N)
+ * - Row compression using GROUP BY operations
+ * - JSONB/JSON array aggregation
+ * - Hierarchical processing of nested arrays
+ * - Column exclusion to avoid duplication
+ *
+ * Why depth calculation is critical:
+ * 1. Array entities can be nested at multiple levels. We must process the deepest
+ *    (most distant) arrays first to ensure their JSON representations are available
+ *    when building their parent arrays.
+ * 2. Array entity processing is essentially a row compression operation using GROUP BY.
+ *    Unlike parent entities which use column compression, arrays require grouping
+ *    to aggregate multiple rows into JSON arrays.
+ *
+ * Example hierarchy:
+ * Order (root, depth 0)
+ *   └─ Items (array, depth 1)
+ *       └─ Details (array, depth 2)
+ *
+ * Processing order: depth 2 → depth 1 → depth 0
+ */
+export declare class PostgresArrayEntityCteBuilder {
+    private static readonly CTE_ARRAY_PREFIX;
+    /**
+     * Build CTEs for all array entities in the correct dependency order
+     * @param ctesSoFar Array of CTEs built so far (starts with the initial CTE)
+     * @param aliasOfCteToBuildUpon Alias of the CTE from which the current array CTE will select
+     * @param allEntities Map of all entities in the mapping
+     * @param mapping The JSON mapping configuration
+     * @returns Object containing the updated list of all CTEs and the alias of the last CTE created
+     */
+    buildArrayEntityCtes(ctesSoFar: CommonTable[], aliasOfCteToBuildUpon: string, allEntities: Map<string, ProcessableEntity>, mapping: JsonMapping): {
+        updatedCtes: CommonTable[];
+        lastCteAlias: string;
+    };
+    /**
+     * Collect all array entities and calculate their depth from root.
+     *
+     * Depth calculation ensures proper processing order where deeper nested
+     * arrays are processed first, making their aggregated data available
+     * for parent array processing.
+     *
+     * @param mapping The JSON mapping configuration
+     * @param allEntities Map of all entities in the mapping
+     * @returns Array of array entity information with calculated depths, sorted deepest first
+     */
+    private collectAndSortArrayEntities;
+    /**
+     * Group array entities by their depth level.
+     *
+     * Grouping by depth allows us to:
+     * - Process all entities at the same level in a single CTE
+     * - Optimize query performance by reducing the number of CTEs
+     * - Maintain clear dependency ordering
+     *
+     * @param arrayInfos Array of array entity information with depths
+     * @returns Map of depth level to entities at that depth
+     */
+    private groupEntitiesByDepth;
+    /**
+     * Build a CTE that processes all array entities at a specific depth level.
+     *
+     * This method creates a single CTE that aggregates multiple array entities
+     * at the same depth, using GROUP BY to compress rows into JSON arrays.
+     *
+     * @param infos Array entities at this depth level
+     * @param currentCteAlias Alias of the CTE to build upon
+     * @param currentCtes All CTEs built so far
+     * @param depth Current depth level being processed
+     * @param mapping JSON mapping configuration
+     * @returns The new CTE and its alias
+     */
+    private buildDepthCte;
+    /**
+     * Build JSON aggregation function for an array entity.
+     *
+     * This method creates a jsonb_agg or json_agg function call that aggregates
+     * the entity's columns into a JSON array. It also handles nested relationships
+     * by including child entity properties in the JSON object.
+     *
+     * @param entity The array entity being processed
+     * @param nestedEntities All nested entities from the mapping
+     * @param allEntities Map of all entities (not used in current implementation)
+     * @param useJsonb Whether to use JSONB functions
+     * @returns Object containing the JSON aggregation function
+     */
+    private buildAggregationDetailsForArrayEntity;
+}

package/dist/esm/types/transformers/PostgresObjectEntityCteBuilder.d.ts

@@ -0,0 +1,140 @@
+import { CommonTable } from '../models/Clause';
+import { JsonMapping } from './PostgreJsonQueryBuilder';
+/**
+ * Entity with processing metadata
+ */
+export interface ProcessableEntity {
+    id: string;
+    name: string;
+    columns: {
+        [jsonKey: string]: string;
+    };
+    isRoot: boolean;
+    propertyName: string;
+    parentId?: string;
+    relationshipType?: "object" | "array";
+}
+/**
+ * PostgreSQL-specific builder for creating CTEs for object entities (object relationships).
+ * This class handles the creation of CTEs that build JSON/JSONB objects for object entities,
+ * processing them from the deepest level up to ensure proper dependency ordering.
+ *
+ * Features:
+ * - Depth-based CTE naming (cte_object_depth_N)
+ * - NULL handling for entity columns
+ * - JSONB/JSON object construction
+ * - Hierarchical processing of nested objects
+ *
+ * Why depth calculation is critical:
+ * 1. Object entities can be nested at multiple levels. We must process the deepest
+ *    (most distant) objects first to ensure their JSON representations are available
+ *    when building their parent entities.
+ * 2. Object entity processing is essentially a column compression operation. Entities
+ *    at the same depth level can be processed simultaneously since they don't depend
+ *    on each other.
+ *
+ * Example hierarchy:
+ * Order (root, depth 0)
+ *   └─ Customer (depth 1)
+ *       └─ Address (depth 2)
+ *   └─ Shipping (depth 1)
+ *       └─ Carrier (depth 2)
+ *
+ * Processing order: depth 2 → depth 1 → depth 0
+ */
+export declare class PostgresObjectEntityCteBuilder {
+    private static readonly JSON_COLUMN_SUFFIX;
+    private static readonly CTE_OBJECT_PREFIX;
+    private static readonly WILDCARD_COLUMN; /**
+     * Build CTEs for all object entities in the correct dependency order
+     * @param initialCte The starting CTE containing all raw data
+     * @param allEntities Map of all entities in the mapping
+     * @param mapping The JSON mapping configuration
+     * @returns Array of CTEs and the alias of the last CTE created
+     */
+    buildObjectEntityCtes(initialCte: CommonTable, allEntities: Map<string, ProcessableEntity>, mapping: JsonMapping): {
+        ctes: CommonTable[];
+        lastCteAlias: string;
+    }; /**
+     * Collect all object entities and calculate their depth from root.
+     *
+     * Depth calculation is crucial because:
+     * - It determines the processing order (deepest first)
+     * - It ensures dependencies are resolved before an entity is processed
+     * - It allows parallel processing of entities at the same depth level
+     *
+     * @param mapping The JSON mapping configuration
+     * @param allEntities Map of all entities in the mapping
+     * @returns Array of object entity information with calculated depths
+     */
+    private collectAndSortObjectEntities;
+    /**
+     * Group entities by their depth level.
+     *
+     * Grouping by depth allows us to:
+     * - Process all entities at the same level in a single CTE
+     * - Optimize query performance by reducing the number of CTEs
+     * - Maintain clear dependency ordering
+     *
+     * @param parentInfos Array of parent entity information with depths
+     * @returns Map of depth level to entities at that depth
+     */ private groupEntitiesByDepth;
+    /**
+     * Build a CTE that processes all entities at a specific depth level
+     */
+    private buildDepthCte;
+    /**
+     * Build JSON column for a single entity with NULL handling
+     */
+    private buildEntityJsonColumn;
+    /**
+     * Prepare entity columns and NULL checks.
+     *
+     * This method extracts column data and creates NULL checks for each column.
+     * The NULL checking is essential for handling outer joins correctly.
+     *
+     * In outer join scenarios, when there's no matching row in the joined table,
+     * all columns from that table will be NULL. Instead of creating an empty object
+     * with all NULL properties (e.g., {id: null, name: null, email: null}),
+     * we want to represent the absence of the entity as NULL itself.
+     *
+     * This ensures cleaner JSON output where missing relationships are represented
+     * as NULL rather than objects with all NULL fields.
+     *
+     * @param entity The entity whose columns are being processed
+     * @returns Object containing arrays of JSON object arguments and NULL check conditions
+     */
+    private prepareEntityColumns;
+    /**
+     * Add child object relationships to JSON object arguments.
+     *
+     * This method processes nested object-type entities that are direct children of the current entity.
+     * For each child entity, it adds the property name and corresponding JSON column reference
+     * to the arguments array that will be used to build the parent's JSON object.
+     *
+     * The child JSON columns are expected to already exist in the data source (created by deeper
+     * level CTEs), as we process from the deepest level up to the root.
+     *
+     * Note: In this context, "child" refers to entities that have an object relationship (0..1)
+     * with their parent. From a data perspective, these are typically entities referenced via
+     * foreign keys, representing "parent" entities in traditional database terminology.
+     *
+     * @param entity The current entity being processed
+     * @param jsonObjectArgs Array to which JSON object arguments will be added
+     * @param mapping The JSON mapping configuration
+     * @param allEntities Map of all entities in the mapping
+     */
+    private addChildObjectRelationships;
+    /**
+     * Create JSON object function call
+     */
+    private createJsonObject;
+    /**
+     * Build NULL condition from NULL checks
+     */
+    private buildNullCondition;
+    /**
+     * Create CASE expression with NULL handling
+     */
+    private createCaseExpression;
+}

package/dist/esm/types/transformers/SelectableColumnCollector.d.ts

@@ -37,14 +37,19 @@ export declare class SelectableColumnCollector implements SqlComponentVisitor<vo
     private commonTables;
     private includeWildCard;
     private duplicateDetection;
+    private options;
     /**
      * Creates a new instance of SelectableColumnCollector.
      *
      * @param {TableColumnResolver | null} [tableColumnResolver=null] - The resolver used to resolve column references to their respective tables.
      * @param {boolean} [includeWildCard=false] - If true, wildcard columns (e.g., `*`) are included in the collection.
      * @param {DuplicateDetectionMode} [duplicateDetection=DuplicateDetectionMode.ColumnNameOnly] - Specifies the duplicate detection mode: 'columnNameOnly' (default, only column name is used), or 'fullName' (table name + column name).
+     * @param {Object} [options={}] - Additional options for the collector.
+     * @param {boolean} [options.ignoreCaseAndUnderscore=false] - If true, column names are compared without considering case and underscores.
      */
-    constructor(tableColumnResolver?: TableColumnResolver | null, includeWildCard?: boolean, duplicateDetection?: DuplicateDetectionMode);
+    constructor(tableColumnResolver?: TableColumnResolver | null, includeWildCard?: boolean, duplicateDetection?: DuplicateDetectionMode, options?: {
+        ignoreCaseAndUnderscore?: boolean;
+    });
     getValues(): {
         name: string;
         value: ValueComponent;

package/dist/esm/types/transformers/SqlParamInjector.d.ts

@@ -0,0 +1,36 @@
+import { SelectQuery, SimpleSelectQuery } from "../models/SelectQuery";
+/**
+ * SqlParamInjector injects state parameters into a SelectQuery model,
+ * creating WHERE conditions and setting parameter values.
+ */
+export declare class SqlParamInjector {
+    private tableColumnResolver?;
+    private options;
+    constructor(optionsOrResolver?: {
+        ignoreCaseAndUnderscore?: boolean;
+    } | ((tableName: string) => string[]), options?: {
+        ignoreCaseAndUnderscore?: boolean;
+    });
+    /**
+     * Injects parameters as WHERE conditions into the given query model.
+     * @param query The SelectQuery to modify
+     * @param state A record of parameter names and values
+     * @returns The modified SelectQuery
+     */
+    inject(query: SimpleSelectQuery | string, state: Record<string, number | string | boolean | Date | null | undefined | Condition>): SelectQuery;
+}
+type Condition = {
+    '='?: number | string | boolean | Date;
+    min?: number | string | Date;
+    max?: number | string | Date;
+    like?: string;
+    in?: (number | string | Date)[];
+    any?: (number | string | Date)[];
+    '<'?: number | string | Date;
+    '>'?: number | string | Date;
+    '!='?: number | string | boolean | Date;
+    '<>'?: number | string | boolean | Date;
+    '<='?: number | string | Date;
+    '>='?: number | string | Date;
+};
+export {};

package/dist/esm/types/transformers/UpstreamSelectQueryFinder.d.ts

@@ -6,16 +6,19 @@ import { SelectQuery, SimpleSelectQuery } from "../models/SelectQuery";
  * For UNION queries, it checks each branch independently.
  */
 export declare class UpstreamSelectQueryFinder {
+    private options;
     private tableColumnResolver?;
     private columnCollector;
-    constructor(tableColumnResolver?: (tableName: string) => string[]);
+    constructor(tableColumnResolver?: (tableName: string) => string[], options?: {
+        ignoreCaseAndUnderscore?: boolean;
+    });
     /**
      * Finds the highest SelectQuery containing all specified columns.
      * @param query The root SelectQuery to search.
-     * @param columnNames Array of column names to check for.
+     * @param columnNames A column name or array of column names to check for.
      * @returns An array of SelectQuery objects, or an empty array if not found.
      */
-    find(query: SelectQuery, columnNames: string[]): SimpleSelectQuery[];
+    find(query: SelectQuery, columnNames: string | string[]): SimpleSelectQuery[];
     private handleTableSource;
     private handleSubQuerySource;
     /**

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './transformers/CTECollector';
 export * from './transformers/CTENormalizer';
 export * from './transformers/Formatter';
 export * from './transformers/SqlFormatter';
+export * from './transformers/PostgreJsonQueryBuilder';
 export * from './transformers/QueryBuilder';
 export * from './transformers/SelectValueCollector';
 export * from './transformers/SelectableColumnCollector';
@@ -15,4 +16,5 @@ export * from './transformers/TableColumnResolver';
 export * from './transformers/TableSourceCollector';
 export * from './transformers/UpstreamSelectQueryFinder';
 export * from './transformers/SchemaCollector';
+export * from './transformers/SqlParamInjector';
 export * from './utils/SqlSchemaValidator';

package/dist/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./transformers/CTECollector"), exports);
 __exportStar(require("./transformers/CTENormalizer"), exports);
 __exportStar(require("./transformers/Formatter"), exports);
 __exportStar(require("./transformers/SqlFormatter"), exports);
+__exportStar(require("./transformers/PostgreJsonQueryBuilder"), exports);
 __exportStar(require("./transformers/QueryBuilder"), exports); // old name:QueryConverter
 __exportStar(require("./transformers/SelectValueCollector"), exports);
 __exportStar(require("./transformers/SelectableColumnCollector"), exports);
@@ -32,6 +33,7 @@ __exportStar(require("./transformers/TableColumnResolver"), exports);
 __exportStar(require("./transformers/TableSourceCollector"), exports);
 __exportStar(require("./transformers/UpstreamSelectQueryFinder"), exports);
 __exportStar(require("./transformers/SchemaCollector"), exports);
+__exportStar(require("./transformers/SqlParamInjector"), exports);
 __exportStar(require("./utils/SqlSchemaValidator"), exports);
 // Add more exports here if you want to expose additional public API
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,8DAA4C;AAC5C,8DAA4C;AAE5C,6DAA2C;AAC3C,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AAErC,8DAA4C;AAC5C,+DAA6C;AAC7C,2DAAyC;AACzC,8DAA4C;AAC5C,8DAA4C,CAAC,0BAA0B;AACvE,sEAAoD;AACpD,2EAAyD;AACzD,qEAAmD;AACnD,sEAAoD;AACpD,2EAAyD;AACzD,iEAA+C;AAE/C,6DAA2C;AAC3C,oEAAoE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,8DAA4C;AAC5C,8DAA4C;AAE5C,6DAA2C;AAC3C,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AAErC,8DAA4C;AAC5C,+DAA6C;AAC7C,2DAAyC;AACzC,8DAA4C;AAC5C,yEAAuD;AACvD,8DAA4C,CAAC,0BAA0B;AACvE,sEAAoD;AACpD,2EAAyD;AACzD,qEAAmD;AACnD,sEAAoD;AACpD,2EAAyD;AACzD,iEAA+C;AAC/C,kEAAgD;AAEhD,6DAA2C;AAC3C,oEAAoE"}

package/dist/models/SqlPrintToken.d.ts

@@ -27,6 +27,8 @@ export declare enum SqlPrintTokenContainerType {
     SwitchCaseArgument = "SwitchCaseArgument",
     ElseClause = "ElseClause",
     CaseKeyValuePair = "CaseKeyValuePair",
+    CaseThenValue = "CaseThenValue",
+    CaseElseValue = "CaseElseValue",
     ParenExpression = "ParenExpression",
     CastExpression = "CastExpression",
     CaseExpression = "CaseExpression",

package/dist/models/SqlPrintToken.js

@@ -33,6 +33,8 @@ var SqlPrintTokenContainerType;
     SqlPrintTokenContainerType["SwitchCaseArgument"] = "SwitchCaseArgument";
     SqlPrintTokenContainerType["ElseClause"] = "ElseClause";
     SqlPrintTokenContainerType["CaseKeyValuePair"] = "CaseKeyValuePair";
+    SqlPrintTokenContainerType["CaseThenValue"] = "CaseThenValue";
+    SqlPrintTokenContainerType["CaseElseValue"] = "CaseElseValue";
     SqlPrintTokenContainerType["ParenExpression"] = "ParenExpression";
     SqlPrintTokenContainerType["CastExpression"] = "CastExpression";
     SqlPrintTokenContainerType["CaseExpression"] = "CaseExpression";

package/dist/models/SqlPrintToken.js.map

@@ -1 +1 @@
-{"version":3,"file":"SqlPrintToken.js","sourceRoot":"","sources":["../../src/models/SqlPrintToken.ts"],"names":[],"mappings":";;;AAAA,IAAY,iBAaX;AAbD,WAAY,iBAAiB;IACzB,mEAAa,CAAA;IACb,+DAAO,CAAA;IACP,2DAAK,CAAA;IACL,2DAAK,CAAA;IACL,uEAAW,CAAA;IACX,iEAAQ,CAAA;IACR,+DAAO,CAAA;IACP,mEAAS,CAAA;IACT,uDAAG,CAAA;IACH,yDAAI,CAAA;IACJ,4DAAK,CAAA;IACL,kFAAgB,CAAA;AACpB,CAAC,EAbW,iBAAiB,iCAAjB,iBAAiB,QAa5B;AAED,2DAA2D;AAC3D,IAAY,0BAgEX;AAhED,WAAY,0BAA0B;IAClC,iEAAmC,CAAA;IACnC,2DAA6B,CAAA;IAC7B,mEAAqC,CAAA;IACrC,yDAA2B,CAAA;IAC3B,qFAAuD,CAAA;IACvD,uCAAS,CAAA;IACT,qDAAuB,CAAA;IACvB,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,iEAAmC,CAAA;IACnC,mEAAqC,CAAA;IACrC,uEAAyC,CAAA;IACzC,uDAAyB,CAAA;IACzB,mEAAqC,CAAA;IACrC,iEAAmC,CAAA;IACnC,+DAAiC,CAAA;IACjC,+DAAiC,CAAA;IACjC,iEAAmC,CAAA;IACnC,qEAAuC,CAAA;IACvC,qDAAuB,CAAA;IACvB,iEAAmC,CAAA;IACnC,6EAA+C,CAAA;IAC/C,uDAAyB,CAAA;IACzB,2DAA6B,CAAA;IAC7B,uDAAyB,CAAA;IACzB,mEAAqC,CAAA;IACrC,uDAAyB,CAAA;IACzB,uDAAyB,CAAA;IACzB,2DAA6B,CAAA;IAC7B,iEAAmC,CAAA;IACnC,+DAAiC,CAAA;IACjC,6EAA+C,CAAA;IAC/C,qDAAuB,CAAA;IACvB,6DAA+B,CAAA;IAC/B,yDAA2B,CAAA;IAC3B,qEAAuC,CAAA;IACvC,6DAA+B,CAAA;IAC/B,6DAA+B,CAAA;IAC/B,2DAA6B,CAAA;IAC7B,+DAAiC,CAAA;IACjC,qEAAuC,CAAA;IACvC,qEAAuC,CAAA;IACvC,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,qDAAuB,CAAA;IACvB,2DAA6B,CAAA;IAC7B,qFAAuD,CAAA;IACvD,+CAAiB,CAAA;IACjB,yDAA2B,CAAA;IAC3B,uDAAyB,CAAA;IACzB,yDAA2B,CAAA;IAC3B,iEAAmC,CAAA;IACnC,+EAAiD,CAAA;IACjD,mFAAqD,CAAA;IACrD,yDAA2B,CAAA;IAC3B,iEAAmC,CAAA;IACnC,yDAA2B,CAAA;IAC3B,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,iEAAmC,CAAA;IACnC,6DAA+B,CAAA;IAC/B,mEAAqC,CAAA;IACrC,qBAAqB;AACzB,CAAC,EAhEW,0BAA0B,0CAA1B,0BAA0B,QAgErC;AAED,MAAa,aAAa;IAyBtB,YAAY,IAAuB,EAAE,OAAe,EAAE,EAAE,gBAA4C,0BAA0B,CAAC,IAAI;QALnI;;WAEG;QACH,gBAAW,GAAoB,EAAE,CAAC;QAG9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;CACJ;AA9BD,sCA8BC"}
+{"version":3,"file":"SqlPrintToken.js","sourceRoot":"","sources":["../../src/models/SqlPrintToken.ts"],"names":[],"mappings":";;;AAAA,IAAY,iBAaX;AAbD,WAAY,iBAAiB;IACzB,mEAAa,CAAA;IACb,+DAAO,CAAA;IACP,2DAAK,CAAA;IACL,2DAAK,CAAA;IACL,uEAAW,CAAA;IACX,iEAAQ,CAAA;IACR,+DAAO,CAAA;IACP,mEAAS,CAAA;IACT,uDAAG,CAAA;IACH,yDAAI,CAAA;IACJ,4DAAK,CAAA;IACL,kFAAgB,CAAA;AACpB,CAAC,EAbW,iBAAiB,iCAAjB,iBAAiB,QAa5B;AAED,2DAA2D;AAC3D,IAAY,0BAkEX;AAlED,WAAY,0BAA0B;IAClC,iEAAmC,CAAA;IACnC,2DAA6B,CAAA;IAC7B,mEAAqC,CAAA;IACrC,yDAA2B,CAAA;IAC3B,qFAAuD,CAAA;IACvD,uCAAS,CAAA;IACT,qDAAuB,CAAA;IACvB,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,iEAAmC,CAAA;IACnC,mEAAqC,CAAA;IACrC,uEAAyC,CAAA;IACzC,uDAAyB,CAAA;IACzB,mEAAqC,CAAA;IACrC,6DAA+B,CAAA;IAC/B,6DAA+B,CAAA;IAC/B,iEAAmC,CAAA;IACnC,+DAAiC,CAAA;IACjC,+DAAiC,CAAA;IACjC,iEAAmC,CAAA;IACnC,qEAAuC,CAAA;IACvC,qDAAuB,CAAA;IACvB,iEAAmC,CAAA;IACnC,6EAA+C,CAAA;IAC/C,uDAAyB,CAAA;IACzB,2DAA6B,CAAA;IAC7B,uDAAyB,CAAA;IACzB,mEAAqC,CAAA;IACrC,uDAAyB,CAAA;IACzB,uDAAyB,CAAA;IACzB,2DAA6B,CAAA;IAC7B,iEAAmC,CAAA;IACnC,+DAAiC,CAAA;IACjC,6EAA+C,CAAA;IAC/C,qDAAuB,CAAA;IACvB,6DAA+B,CAAA;IAC/B,yDAA2B,CAAA;IAC3B,qEAAuC,CAAA;IACvC,6DAA+B,CAAA;IAC/B,6DAA+B,CAAA;IAC/B,2DAA6B,CAAA;IAC7B,+DAAiC,CAAA;IACjC,qEAAuC,CAAA;IACvC,qEAAuC,CAAA;IACvC,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,qDAAuB,CAAA;IACvB,2DAA6B,CAAA;IAC7B,qFAAuD,CAAA;IACvD,+CAAiB,CAAA;IACjB,yDAA2B,CAAA;IAC3B,uDAAyB,CAAA;IACzB,yDAA2B,CAAA;IAC3B,iEAAmC,CAAA;IACnC,+EAAiD,CAAA;IACjD,mFAAqD,CAAA;IACrD,yDAA2B,CAAA;IAC3B,iEAAmC,CAAA;IACnC,yDAA2B,CAAA;IAC3B,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,iEAAmC,CAAA;IACnC,6DAA+B,CAAA;IAC/B,mEAAqC,CAAA;IACrC,qBAAqB;AACzB,CAAC,EAlEW,0BAA0B,0CAA1B,0BAA0B,QAkErC;AAED,MAAa,aAAa;IAyBtB,YAAY,IAAuB,EAAE,OAAe,EAAE,EAAE,gBAA4C,0BAA0B,CAAC,IAAI;QALnI;;WAEG;QACH,gBAAW,GAAoB,EAAE,CAAC;QAG9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;CACJ;AA9BD,sCA8BC"}

package/dist/models/ValueComponent.d.ts

@@ -32,7 +32,7 @@ export declare class FunctionCall extends SqlComponent {
     qualifiedName: QualifiedName;
     argument: ValueComponent | null;
     over: OverExpression | null;
-    constructor(namespaces: string[] | IdentifierString[] | null, name: string | RawString | IdentifierString, argument: ValueComponent | null, over: OverExpression | null);
+    constructor(namespaces: string | string[] | IdentifierString[] | null, name: string | RawString | IdentifierString, argument: ValueComponent | null, over: OverExpression | null);
     /**
      * For backward compatibility: returns the namespaces as IdentifierString[] | null (readonly)
      */
@@ -103,7 +103,7 @@ export declare class ParameterExpression extends SqlComponent {
     value: any | null;
     /**
      * The index assigned by the formatter when generating parameterized queries.
-     * This is used for naming parameters like $1, $2, ...
+     * Used for naming parameters like $1, $2, etc.
      */
     index: number | null;
     constructor(name: string, value?: any | null);
@@ -195,7 +195,7 @@ export declare class QualifiedName extends SqlComponent {
     namespaces: IdentifierString[] | null;
     /** The actual name (e.g. table, function, type, column) */
     name: RawString | IdentifierString;
-    constructor(namespaces: string[] | IdentifierString[] | null, name: string | RawString | IdentifierString);
+    constructor(namespaces: string | string[] | IdentifierString[] | null, name: string | RawString | IdentifierString);
     /** Returns the full qualified name as a string (dot-separated) */
     toString(): string;
 }

package/dist/models/ValueComponent.js

@@ -39,15 +39,8 @@ class ColumnReference extends SqlComponent_1.SqlComponent {
     }
     constructor(namespaces, column) {
         super();
-        let nsArr;
-        if (typeof namespaces === "string") {
-            nsArr = [namespaces];
-        }
-        else {
-            nsArr = namespaces;
-        }
         const col = typeof column === "string" ? new IdentifierString(column) : column;
-        this.qualifiedName = new QualifiedName(nsArr, col);
+        this.qualifiedName = new QualifiedName(toIdentifierStringArray(namespaces), col);
     }
     toString() {
         return this.qualifiedName.toString();
@@ -165,7 +158,7 @@ class ParameterExpression extends SqlComponent_1.SqlComponent {
     constructor(name, value = null) {
         super();
         this.name = new RawString(name);
-        this.value = value;
+        this.value = value; // Value is now accepted as a second argument (optional)
         this.index = null;
     }
 }
@@ -305,14 +298,22 @@ TupleExpression.kind = Symbol("TupleExpression");
 function toIdentifierStringArray(input) {
     if (input == null)
         return null;
-    if (typeof input === "string")
-        return [new IdentifierString(input)];
+    if (typeof input === "string") {
+        // Empty string should be treated as null
+        return input.trim() === "" ? null : [new IdentifierString(input)];
+    }
     if (Array.isArray(input)) {
+        if (input.length === 0)
+            return null;
         if (typeof input[0] === "string") {
-            return input.map(ns => new IdentifierString(ns));
+            // Filter out empty strings from string array
+            const filteredStrings = input.filter(ns => ns.trim() !== "");
+            return filteredStrings.length === 0 ? null : filteredStrings.map(ns => new IdentifierString(ns));
         }
         else {
-            return input;
+            // Filter out empty IdentifierStrings from IdentifierString array
+            const filteredIdentifiers = input.filter(ns => ns.name.trim() !== "");
+            return filteredIdentifiers.length === 0 ? null : filteredIdentifiers;
         }
     }
     return null;