rawsql-ts 0.20.0 → 0.21.0

package/dist/esm/transformers/PostgresJsonQueryBuilder.js

@@ -1,241 +0,0 @@
-import { CommonTable, SourceAliasExpression, SelectItem, SelectClause, FromClause, SourceExpression, TableSource, WithClause, LimitClause } from '../models/Clause';
-import { SimpleSelectQuery } from '../models/SimpleSelectQuery';
-import { IdentifierString, ColumnReference, FunctionCall, ValueList, LiteralValue, RawString } from '../models/ValueComponent';
-import { SelectValueCollector } from "./SelectValueCollector";
-import { PostgresObjectEntityCteBuilder } from './PostgresObjectEntityCteBuilder';
-import { PostgresArrayEntityCteBuilder } from './PostgresArrayEntityCteBuilder';
-import { QueryBuilder } from './QueryBuilder';
-/**
- * PostgreSQL JSON query builder that transforms SimpleSelectQuery into queries
- * that return JSON arrays or single JSON objects using PostgreSQL JSON functions.
- */
-export class PostgresJsonQueryBuilder {
-    constructor() {
-        this.selectValueCollector = new SelectValueCollector(null);
-        this.objectEntityCteBuilder = new PostgresObjectEntityCteBuilder();
-        this.arrayEntityCteBuilder = new PostgresArrayEntityCteBuilder();
-    }
-    /**
-     * Validates the JSON mapping and the original query.
-     * @param query Original query to transform
-     * @param mapping JSON mapping configuration
-     */
-    validateMapping(query, mapping) {
-        var _a, _b;
-        const collector = new SelectValueCollector();
-        const selectedValues = collector.collect(query);
-        // sv.name is the alias or derived name
-        const availableColumns = new Set(selectedValues.map(sv => sv.name)); // Check root entity columns
-        for (const jsonKey in mapping.rootEntity.columns) {
-            const columnDef = mapping.rootEntity.columns[jsonKey];
-            // Handle both string and object formats
-            const sourceColumn = typeof columnDef === 'string' ? columnDef : columnDef.column;
-            if (!availableColumns.has(sourceColumn)) {
-                throw new Error(`Validation Error: Column "${sourceColumn}" for JSON key "${jsonKey}" in root entity "${mapping.rootEntity.name}" not found in the query's select list.`);
-            }
-        }
-        // Check nested entity columns and parent-child relationships
-        const entityIds = new Set([mapping.rootEntity.id]);
-        const parentToChildrenMap = new Map();
-        mapping.nestedEntities.forEach(ne => {
-            entityIds.add(ne.id);
-            if (!parentToChildrenMap.has(ne.parentId)) {
-                parentToChildrenMap.set(ne.parentId, []);
-            }
-            parentToChildrenMap.get(ne.parentId).push(ne.id);
-        });
-        for (const entity of mapping.nestedEntities) {
-            if (!entityIds.has(entity.parentId)) {
-                throw new Error(`Validation Error: Parent entity with ID "${entity.parentId}" for nested entity "${entity.name}" (ID: ${entity.id}) not found.`);
-            }
-            for (const jsonKey in entity.columns) {
-                const columnDef = entity.columns[jsonKey];
-                // Handle both string and object formats
-                const sourceColumn = typeof columnDef === 'string' ? columnDef : columnDef.column;
-                if (!availableColumns.has(sourceColumn)) {
-                    throw new Error(`Validation Error: Column "${sourceColumn}" for JSON key "${jsonKey}" in nested entity "${entity.name}" (ID: ${entity.id}) not found in the query's select list.`);
-                }
-            }
-        }
-        // Validate: An entity should not have multiple direct array children.
-        // Validate: Child propertyNames under a single parent must be unique.
-        const allParentIds = new Set([mapping.rootEntity.id, ...mapping.nestedEntities.map(ne => ne.parentId)]);
-        for (const parentId of allParentIds) {
-            const directChildren = mapping.nestedEntities.filter(ne => ne.parentId === parentId);
-            const directArrayChildrenCount = directChildren.filter(c => c.relationshipType === 'array').length;
-            if (directArrayChildrenCount > 1) {
-                const parentName = parentId === mapping.rootEntity.id ? mapping.rootEntity.name : (_a = mapping.nestedEntities.find(ne => ne.id === parentId)) === null || _a === void 0 ? void 0 : _a.name;
-                throw new Error(`Validation Error: Parent entity "${parentName}" (ID: ${parentId}) has multiple direct array children. This is not supported.`);
-            }
-            const propertyNames = new Set();
-            for (const child of directChildren) {
-                if (propertyNames.has(child.propertyName)) {
-                    const parentName = parentId === mapping.rootEntity.id ? mapping.rootEntity.name : (_b = mapping.nestedEntities.find(ne => ne.id === parentId)) === null || _b === void 0 ? void 0 : _b.name;
-                    throw new Error(`Validation Error: Parent entity "${parentName}" (ID: ${parentId}) has duplicate property name "${child.propertyName}" for its children.`);
-                }
-                propertyNames.add(child.propertyName);
-            }
-        }
-    }
-    buildJsonQuery(originalQuery, mapping, options) {
-        // Check jsonb option - must be true (or undefined/default) for GROUP BY compatibility
-        if ((options === null || options === void 0 ? void 0 : options.jsonb) === false) {
-            throw new Error('JSONB must be enabled for PostgreSQL GROUP BY compatibility. ' +
-                'JSON type cannot be used in GROUP BY clauses. ' +
-                'Please set jsonb: true or omit the jsonb option (defaults to true).');
-        }
-        // Convert any SelectQuery to SimpleSelectQuery using QueryBuilder
-        const simpleQuery = originalQuery instanceof SimpleSelectQuery
-            ? originalQuery
-            : QueryBuilder.buildSimpleQuery(originalQuery);
-        return this.buildJsonWithCteStrategy(simpleQuery, mapping);
-    }
-    /**
-     * Build JSON query from original query and mapping configuration.
-     * @deprecated Use buildJsonQuery instead. This method will be removed in a future version.
-     * @param originalQuery Original query to transform
-     * @param mapping JSON mapping configuration
-     * @returns Transformed query with JSON aggregation
-     */
-    buildJson(originalQuery, mapping) {
-        console.warn('buildJson is deprecated. Use buildJsonQuery instead.');
-        return this.buildJsonQuery(originalQuery, mapping);
-    }
-    /**
-     * 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
-     */
-    buildJsonWithCteStrategy(originalQuery, mapping) {
-        this.validateMapping(originalQuery, mapping);
-        // Step 1: Create the initial CTE from the original query
-        const { initialCte, initialCteAlias } = this.createInitialCte(originalQuery);
-        let ctesForProcessing = [initialCte];
-        let currentAliasToBuildUpon = initialCteAlias;
-        // Step 2: Prepare entity information
-        const allEntities = new Map();
-        allEntities.set(mapping.rootEntity.id, Object.assign(Object.assign({}, mapping.rootEntity), { isRoot: true, propertyName: mapping.rootName }));
-        mapping.nestedEntities.forEach(ne => allEntities.set(ne.id, Object.assign(Object.assign({}, ne), { isRoot: false, propertyName: ne.propertyName }))); // Step 2.5: Build CTEs for object entities using dedicated builder
-        const objectEntityResult = this.objectEntityCteBuilder.buildObjectEntityCtes(initialCte, allEntities, mapping);
-        // Important: Replace the entire CTE list with the result from object entity builder
-        // The object entity builder returns all CTEs including the initial one
-        ctesForProcessing = objectEntityResult.ctes;
-        currentAliasToBuildUpon = objectEntityResult.lastCteAlias;
-        // Store column mappings for later use
-        const columnMappings = objectEntityResult.columnMappings;
-        // Step 3: Build CTEs for array entities using dedicated builder
-        const arrayCteBuildResult = this.arrayEntityCteBuilder.buildArrayEntityCtes(ctesForProcessing, currentAliasToBuildUpon, allEntities, mapping, columnMappings);
-        ctesForProcessing = arrayCteBuildResult.updatedCtes;
-        currentAliasToBuildUpon = arrayCteBuildResult.lastCteAlias;
-        // Step 4: Build the final SELECT query using all generated CTEs
-        return this.buildFinalSelectQuery(ctesForProcessing, currentAliasToBuildUpon, allEntities, mapping, columnMappings);
-    }
-    /**
-     * 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.
-     */
-    createInitialCte(originalQuery) {
-        const originCteAlias = "origin_query";
-        const originCte = new CommonTable(originalQuery, new SourceAliasExpression(originCteAlias, null), null);
-        return { initialCte: originCte, initialCteAlias: originCteAlias };
-    }
-    /**
-     * 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.
-     */
-    buildFinalSelectQuery(finalCtesList, lastCteAliasForFromClause, allEntities, mapping, columnMappings) {
-        const currentCtes = [...finalCtesList];
-        // Define rootObjectCteAlias outside of if block
-        const rootObjectCteAlias = `cte_root_${mapping.rootName.toLowerCase().replace(/[^a-z0-9_]/g, '_')}`;
-        const rootEntity = allEntities.get(mapping.rootEntity.id);
-        if (!rootEntity) {
-            throw new Error(`Root entity ${mapping.rootEntity.id} not found`);
-        }
-        if (mapping.resultFormat === "array" || !mapping.resultFormat) {
-            // Step 4.1a: Create a CTE that wraps the final result as the root object            // No alias needed for single table SELECT
-            const rootObjectBuilderExpression = this.buildEntityJsonObject(rootEntity, null, // No source alias for single table
-            mapping.nestedEntities, allEntities, columnMappings);
-            const rootObjectSelectItem = new SelectItem(rootObjectBuilderExpression, mapping.rootName);
-            const rootObjectCte = new CommonTable(new SimpleSelectQuery({
-                selectClause: new SelectClause([rootObjectSelectItem]),
-                fromClause: new FromClause(new SourceExpression(new TableSource(null, new IdentifierString(lastCteAliasForFromClause)), null // No alias
-                ), null),
-            }), new SourceAliasExpression(rootObjectCteAlias, null), null);
-            currentCtes.push(rootObjectCte);
-            // Step 4.1b: Aggregate all the root objects
-            const aggregationFunc = "jsonb_agg"; // Always use JSONB
-            const aggregateExpression = new FunctionCall(null, new RawString(aggregationFunc), new ValueList([new ColumnReference(null, new IdentifierString(mapping.rootName))]), null);
-            return new SimpleSelectQuery({
-                withClause: new WithClause(false, currentCtes),
-                selectClause: new SelectClause([
-                    new SelectItem(aggregateExpression, `${mapping.rootName}_array`)
-                ]),
-                fromClause: new FromClause(new SourceExpression(new TableSource(null, new IdentifierString(rootObjectCteAlias)), null), null),
-            });
-        }
-        else {
-            // For a single object result, create root object CTE without alias
-            const rootObjectBuilderExpression = this.buildEntityJsonObject(rootEntity, null, // No source alias for single table
-            mapping.nestedEntities, allEntities, columnMappings);
-            const rootObjectSelectItem = new SelectItem(rootObjectBuilderExpression, mapping.rootName);
-            const rootObjectCte = new CommonTable(new SimpleSelectQuery({
-                selectClause: new SelectClause([rootObjectSelectItem]),
-                fromClause: new FromClause(new SourceExpression(new TableSource(null, new IdentifierString(lastCteAliasForFromClause)), null // No alias
-                ), null),
-            }), new SourceAliasExpression(rootObjectCteAlias, null), null);
-            currentCtes.push(rootObjectCte);
-            // Select directly from the root_object_cte with LIMIT 1
-            return new SimpleSelectQuery({
-                withClause: new WithClause(false, currentCtes),
-                selectClause: new SelectClause([
-                    new SelectItem(new ColumnReference(null, new IdentifierString(mapping.rootName)), mapping.rootName)
-                ]),
-                fromClause: new FromClause(new SourceExpression(new TableSource(null, new IdentifierString(rootObjectCteAlias)), null), null),
-                limitClause: new LimitClause(new LiteralValue(1)) // Correctly use LimitClause
-            });
-        }
-    }
-    /**
-     * Build JSON object for entity, using parent JSON columns when available
-     */
-    buildEntityJsonObject(entity, sourceAlias, nestedEntities, allEntities, columnMappings) {
-        const jsonBuildFunction = "jsonb_build_object";
-        const args = [];
-        // Add the entity's own columns
-        Object.entries(entity.columns).forEach(([jsonKey, columnDef]) => {
-            // Handle both string and object formats
-            const sqlColumn = typeof columnDef === 'string' ? columnDef : columnDef.column;
-            args.push(new LiteralValue(jsonKey, undefined, true));
-            args.push(new ColumnReference(null, new IdentifierString(sqlColumn)));
-        });
-        // Find and process child entities (both object and array types)
-        const childEntities = nestedEntities.filter((ne) => ne.parentId === entity.id);
-        childEntities.forEach((childEntity) => {
-            const child = allEntities.get(childEntity.id);
-            if (!child)
-                return;
-            args.push(new LiteralValue(childEntity.propertyName, undefined, true));
-            if (childEntity.relationshipType === "object") {
-                // For object relationships, use pre-computed JSON column from column mappings
-                const mapping = columnMappings.find(m => m.entityId === child.id);
-                if (!mapping) {
-                    throw new Error(`Column mapping not found for entity: ${child.id}`);
-                }
-                args.push(new ColumnReference(null, new IdentifierString(mapping.generatedColumnName)));
-            }
-            else if (childEntity.relationshipType === "array") {
-                // For array relationships, use the column directly
-                args.push(new ColumnReference(null, new IdentifierString(childEntity.propertyName)));
-            }
-        });
-        return new FunctionCall(null, new RawString(jsonBuildFunction), new ValueList(args), null);
-    }
-}
-//# sourceMappingURL=PostgresJsonQueryBuilder.js.map

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

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

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

@@ -1,165 +0,0 @@
-import { CommonTable } from '../models/Clause';
-import { JsonMapping } from './PostgresJsonQueryBuilder';
-/**
- * Entity with processing metadata
- */
-export interface ProcessableEntity {
-    id: string;
-    name: string;
-    columns: {
-        [jsonKey: string]: string;
-    };
-    isRoot: boolean;
-    propertyName: string;
-    parentId?: string;
-    relationshipType?: "object" | "array";
-}
-/**
- * JSON column mapping information
- */
-export interface JsonColumnMapping {
-    entityId: string;
-    entityName: string;
-    generatedColumnName: string;
-    depth: number;
-}
-/**
- * Result from CTE builder including column mappings
- */
-export interface CteBuilderResult {
-    ctes: CommonTable[];
-    lastCteAlias: string;
-    columnMappings: JsonColumnMapping[];
-}
-/**
- * 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 CTE_OBJECT_PREFIX;
-    private static readonly WILDCARD_COLUMN;
-    private jsonColumnCounter;
-    private entityToJsonColumnMap;
-    private columnMappings;
-    /**
-     * 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): CteBuilderResult;
-    /**
-     * Generate unique JSON column name with entity name and counter
-     */
-    private generateUniqueJsonColumnName; /**
-     * 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;
-    /**
-     * Calculate approximate depth for an entity (for mapping purposes)
-     */
-    private calculateApproximateDepth;
-    /**
-     * 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;
-}