rawsql-ts 0.19.0 → 0.21.0

package/dist/esm/transformers/PostgresObjectEntityCteBuilder.js

@@ -1,343 +0,0 @@
-import { CommonTable, SourceAliasExpression, SelectItem, SelectClause, FromClause, SourceExpression, TableSource } from '../models/Clause';
-import { SimpleSelectQuery } from '../models/SimpleSelectQuery';
-import { IdentifierString, ColumnReference, FunctionCall, ValueList, LiteralValue, BinaryExpression, CaseExpression, SwitchCaseArgument, CaseKeyValuePair, RawString } from '../models/ValueComponent';
-/**
- * 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 class PostgresObjectEntityCteBuilder {
-    constructor() {
-        // Simple counter for unique JSON column names
-        this.jsonColumnCounter = 0;
-        // Map entity ID to generated JSON column name
-        this.entityToJsonColumnMap = new Map();
-        // Column mappings for external use
-        this.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, allEntities, mapping) {
-        // Reset counter and mapping for each query
-        this.jsonColumnCounter = 0;
-        this.entityToJsonColumnMap.clear();
-        this.columnMappings = [];
-        const ctes = [initialCte];
-        let previousCteAlias = initialCte.aliasExpression.table.name; // Collect and sort object entities by depth
-        const objectEntityInfos = this.collectAndSortObjectEntities(mapping, allEntities);
-        // Group entities by depth
-        const entitiesByDepth = this.groupEntitiesByDepth(objectEntityInfos);
-        // Process each depth level, starting from the deepest
-        const depths = Array.from(entitiesByDepth.keys()).sort((a, b) => b - a);
-        for (const depth of depths) {
-            const entitiesAtDepth = entitiesByDepth.get(depth);
-            const cteAlias = `${PostgresObjectEntityCteBuilder.CTE_OBJECT_PREFIX}${depth}`;
-            // Build CTE for all entities at this depth
-            const cte = this.buildDepthCte(entitiesAtDepth, previousCteAlias, cteAlias, mapping, allEntities);
-            ctes.push(cte);
-            previousCteAlias = cteAlias;
-        }
-        return {
-            ctes,
-            lastCteAlias: previousCteAlias,
-            columnMappings: this.columnMappings
-        };
-    }
-    /**
-     * Generate unique JSON column name with entity name and counter
-     */
-    generateUniqueJsonColumnName(entityName, entityId, depth) {
-        this.jsonColumnCounter++;
-        const columnName = `${entityName.toLowerCase()}_json_${this.jsonColumnCounter}`;
-        // Record mapping information for external use
-        this.columnMappings.push({
-            entityId,
-            entityName,
-            generatedColumnName: columnName,
-            depth
-        });
-        return columnName;
-    } /**
-     * 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
-     */
-    collectAndSortObjectEntities(mapping, allEntities) {
-        const objectInfos = [];
-        // Helper function to calculate actual object nesting depth for a given OBJECT entity
-        const calculateActualObjectNestingDepth = (entityIdOfObject) => {
-            const initialEntity = allEntities.get(entityIdOfObject);
-            if (!initialEntity) {
-                throw new Error(`Entity ${entityIdOfObject} not found for depth calculation.`);
-            }
-            // If the object itself is root, its depth is 0. (This function should ideally be called for nested entities, not the root itself as a "parent CTE" subject)
-            if (initialEntity.isRoot)
-                return 0;
-            // If the object is not root and has no parentId, it's considered a top-level object, depth 1.
-            if (!initialEntity.parentId) {
-                return 1;
-            }
-            let currentParentIdInHierarchy = initialEntity.parentId;
-            let calculatedObjectDepth = 0;
-            const visitedInPath = new Set();
-            visitedInPath.add(entityIdOfObject); // Add the starting object itself to detect cycles
-            while (currentParentIdInHierarchy) {
-                if (visitedInPath.has(currentParentIdInHierarchy)) {
-                    throw new Error(`Circular dependency detected: ${currentParentIdInHierarchy} already visited in path for ${entityIdOfObject}`);
-                }
-                visitedInPath.add(currentParentIdInHierarchy);
-                const parentEntityData = allEntities.get(currentParentIdInHierarchy);
-                if (!parentEntityData) {
-                    throw new Error(`Parent entity ${currentParentIdInHierarchy} not found during depth calculation for ${entityIdOfObject}`);
-                }
-                let parentIsConsideredAnObjectForNesting = false;
-                if (parentEntityData.isRoot) {
-                    parentIsConsideredAnObjectForNesting = true; // Root counts as an object ancestor
-                }
-                else {
-                    // For non-root parents, find their definition in nestedEntities to check their type
-                    const parentDefinition = mapping.nestedEntities.find(ne => ne.id === currentParentIdInHierarchy);
-                    if (parentDefinition) {
-                        if (parentDefinition.relationshipType === "object") {
-                            parentIsConsideredAnObjectForNesting = true;
-                        }
-                        // If parentDefinition.relationshipType === "array", it's not an object ancestor for depth counting
-                    }
-                    else {
-                        // This implies currentParentIdInHierarchy refers to an entity not defined as root or in nestedEntities
-                        // This should ideally not happen with a consistent mapping.
-                        throw new Error(`Parent entity ${currentParentIdInHierarchy} (ancestor of ${entityIdOfObject}) has no definition in mapping.nestedEntities and is not root.`);
-                    }
-                }
-                if (parentIsConsideredAnObjectForNesting) {
-                    calculatedObjectDepth++;
-                }
-                if (parentEntityData.isRoot) {
-                    break; // Stop when the root is processed as the highest object ancestor
-                }
-                currentParentIdInHierarchy = parentEntityData.parentId; // Move to the next ancestor
-            }
-            return calculatedObjectDepth;
-        };
-        mapping.nestedEntities.forEach(nestedEntity => {
-            if (nestedEntity.relationshipType === "object") {
-                const entity = allEntities.get(nestedEntity.id);
-                // Ensure we don't process the root entity itself as a "parent" CTE,
-                // and that the entity actually exists.
-                if (entity && !entity.isRoot) {
-                    objectInfos.push({
-                        entity,
-                        depth: calculateActualObjectNestingDepth(nestedEntity.id)
-                    });
-                }
-            }
-        });
-        // The existing grouping and sorting by depth (b - a for descending) should still work correctly
-        // as it processes deepest levels first, regardless of the absolute depth numbers.
-        return objectInfos;
-    }
-    /**
-     * 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
-     */ groupEntitiesByDepth(objectInfos) {
-        const entitiesByDepth = new Map();
-        objectInfos.forEach(info => {
-            const depth = info.depth;
-            if (!entitiesByDepth.has(depth)) {
-                entitiesByDepth.set(depth, []);
-            }
-            entitiesByDepth.get(depth).push(info);
-        });
-        return entitiesByDepth;
-    }
-    /**
-     * Build a CTE that processes all entities at a specific depth level
-     */
-    buildDepthCte(entitiesAtDepth, previousCteAlias, cteAlias, mapping, allEntities) {
-        // Build SELECT items: * and JSON objects for all entities at this depth
-        const selectItems = [
-            // Select all columns from previous CTE
-            new SelectItem(new ColumnReference(null, new IdentifierString(PostgresObjectEntityCteBuilder.WILDCARD_COLUMN)))
-        ];
-        // Process each entity at this depth
-        for (const { entity } of entitiesAtDepth) {
-            const jsonColumn = this.buildEntityJsonColumn(entity, mapping, allEntities);
-            selectItems.push(jsonColumn);
-        }
-        // Create CTE that selects from previous CTE
-        const cteSelect = new SimpleSelectQuery({
-            selectClause: new SelectClause(selectItems),
-            fromClause: new FromClause(new SourceExpression(new TableSource(null, new IdentifierString(previousCteAlias)), null), null)
-        });
-        return new CommonTable(cteSelect, new SourceAliasExpression(cteAlias, null), null);
-    }
-    /**
-     * Build JSON column for a single entity with NULL handling
-     */
-    buildEntityJsonColumn(entity, mapping, allEntities) {
-        // Build JSON object arguments and NULL checks
-        const { jsonObjectArgs, nullChecks } = this.prepareEntityColumns(entity);
-        // Add child object relationships
-        this.addChildObjectRelationships(entity, jsonObjectArgs, mapping, allEntities);
-        // Create JSON object
-        const jsonObject = this.createJsonObject(jsonObjectArgs);
-        // Build NULL condition and CASE expression
-        const nullCondition = this.buildNullCondition(nullChecks);
-        const caseExpr = this.createCaseExpression(nullCondition, jsonObject);
-        // Add JSON object as named column with unique name to avoid conflicts
-        // Calculate depth for this entity (approximate - for mapping purposes)
-        const depth = this.calculateApproximateDepth(entity, mapping);
-        const jsonColumnName = this.generateUniqueJsonColumnName(entity.name, entity.id, depth);
-        // Store mapping for child entity references
-        this.entityToJsonColumnMap.set(entity.id, jsonColumnName);
-        return new SelectItem(caseExpr, jsonColumnName);
-    }
-    /**
-     * Calculate approximate depth for an entity (for mapping purposes)
-     */
-    calculateApproximateDepth(entity, mapping) {
-        if (entity.isRoot)
-            return 0;
-        if (!entity.parentId)
-            return 1;
-        // Simple depth calculation
-        let depth = 1;
-        let currentParentId = entity.parentId;
-        while (currentParentId && currentParentId !== mapping.rootEntity.id) {
-            const parentEntity = mapping.nestedEntities.find(e => e.id === currentParentId);
-            if (!parentEntity)
-                break;
-            depth++;
-            currentParentId = parentEntity.parentId;
-        }
-        return depth;
-    }
-    /**
-     * 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
-     */
-    prepareEntityColumns(entity) {
-        const jsonObjectArgs = [];
-        const nullChecks = [];
-        Object.entries(entity.columns).forEach(([jsonKey, sqlColumn]) => {
-            jsonObjectArgs.push(new LiteralValue(jsonKey, undefined, true));
-            jsonObjectArgs.push(new ColumnReference(null, new IdentifierString(sqlColumn)));
-            // Collect NULL checks for each column
-            nullChecks.push(new BinaryExpression(new ColumnReference(null, new IdentifierString(sqlColumn)), "is", new LiteralValue(null)));
-        });
-        return { jsonObjectArgs, nullChecks };
-    }
-    /**
-     * 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
-     */
-    addChildObjectRelationships(entity, jsonObjectArgs, mapping, allEntities) {
-        const childEntities = mapping.nestedEntities.filter(ne => ne.parentId === entity.id && ne.relationshipType === "object");
-        childEntities.forEach(childEntity => {
-            const child = allEntities.get(childEntity.id);
-            if (child) {
-                jsonObjectArgs.push(new LiteralValue(childEntity.propertyName, undefined, true));
-                // Use mapped JSON column name to avoid conflicts
-                const jsonColumnName = this.entityToJsonColumnMap.get(child.id);
-                if (!jsonColumnName) {
-                    throw new Error(`JSON column name not found for child entity: ${child.id}`);
-                }
-                jsonObjectArgs.push(new ColumnReference(null, new IdentifierString(jsonColumnName)));
-            }
-        });
-    }
-    /**
-     * Create JSON object function call
-     */
-    createJsonObject(args) {
-        const jsonBuildFunction = "jsonb_build_object";
-        // Always use JSONB
-        return new FunctionCall(null, new RawString(jsonBuildFunction), new ValueList(args), null);
-    }
-    /**
-     * Build NULL condition from NULL checks
-     */
-    buildNullCondition(nullChecks) {
-        return nullChecks.reduce((acc, check) => acc ? new BinaryExpression(acc, "and", check) : check);
-    }
-    /**
-     * Create CASE expression with NULL handling
-     */
-    createCaseExpression(nullCondition, jsonObject) {
-        return new CaseExpression(null, new SwitchCaseArgument([new CaseKeyValuePair(nullCondition, new LiteralValue(null))], jsonObject // ELSE return the JSON object
-        ));
-    }
-}
-PostgresObjectEntityCteBuilder.CTE_OBJECT_PREFIX = 'cte_object_depth_';
-PostgresObjectEntityCteBuilder.WILDCARD_COLUMN = '*';
-//# sourceMappingURL=PostgresObjectEntityCteBuilder.js.map

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

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

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

@@ -1,108 +0,0 @@
-/**
- * Post-processor for transforming database values to appropriate TypeScript types
- * after JSON serialization from PostgreSQL
- */
-export interface TypeTransformationConfig {
-    /** Column transformations mapping - takes precedence over value-based detection */
-    columnTransformations?: {
-        [columnName: string]: TypeTransformation;
-    };
-    /** Global transformation rules by SQL data type */
-    globalTransformations?: {
-        [sqlType: string]: TypeTransformation;
-    };
-    /** Custom transformation functions */
-    customTransformers?: {
-        [transformerName: string]: (value: unknown) => unknown;
-    };
-    /** Enable value-based type detection when column mapping is not provided (default: true) */
-    enableValueBasedDetection?: boolean;
-    /** Strict date detection - only convert ISO 8601 with 'T' separator (default: false) */
-    strictDateDetection?: boolean;
-}
-export interface TypeTransformation {
-    /** Source SQL data type */
-    sourceType: 'DATE' | 'TIMESTAMP' | 'BIGINT' | 'NUMERIC' | 'JSONB' | 'custom';
-    /** Target TypeScript type representation */
-    targetType: 'Date' | 'bigint' | 'string' | 'number' | 'object' | 'custom';
-    /** Custom transformer function name (for custom type) */
-    customTransformer?: string;
-    /** Whether to handle null values (default: true) */
-    handleNull?: boolean;
-    /** Validation function for the value */
-    validator?: (value: unknown) => boolean;
-}
-/**
- * Applies type transformations to JSON results from PostgreSQL
- */
-export declare class TypeTransformationPostProcessor {
-    private config;
-    constructor(config?: TypeTransformationConfig);
-    /**
-     * Transform a single result object
-     * @param result The result object from PostgreSQL JSON query
-     * @returns Transformed result with proper TypeScript types
-     */
-    transformResult<T = unknown>(result: unknown): T;
-    /**
-     * Transform a single object recursively
-     */
-    private transformSingleObject;
-    /**
-     * Detect value type and create appropriate transformation based on value characteristics
-     * This is the core value-based detection logic
-     */
-    private detectValueBasedTransformation;
-    /**
-     * Get global transformation for a specific value (if any match)
-     * This is separate from value-based detection and relies on configured global rules
-     */
-    private getGlobalTransformationForValue;
-    /**
-     * @deprecated Use detectValueBasedTransformation instead
-     * Detect value type and get appropriate global transformation
-     */
-    private detectAndGetGlobalTransformation;
-    /**
-     * Check if string is a valid date string
-     * Supports both strict (ISO 8601 with T separator) and loose detection
-     */
-    private isDateString;
-    /**
-     * Apply a specific transformation to a value
-     */
-    private applyTransformation;
-    /**
-     * Create a default configuration for common PostgreSQL types
-     * Enables value-based detection with loose date detection by default
-     */
-    static createDefaultConfig(): TypeTransformationConfig;
-    /**
-     * Create a safe configuration for handling user input
-     * Disables value-based detection and uses strict date detection
-     */
-    static createSafeConfig(columnMappings?: {
-        [columnName: string]: TypeTransformation;
-    }): TypeTransformationConfig;
-}
-/**
- * Convenience function to create and apply transformations
- */
-export declare function transformDatabaseResult<T = unknown>(result: unknown, config?: TypeTransformationConfig): T;
-/**
- * Type-safe transformation helpers
- */
-export declare const TypeTransformers: {
-    /**
-     * Transform date string to Date object
-     */
-    toDate: (value: string | null) => Date | null;
-    /**
-     * Transform numeric string to BigInt
-     */
-    toBigInt: (value: string | number | null) => bigint | null;
-    /**
-     * Transform JSON string to object
-     */
-    toObject: <T = unknown>(value: string | null) => T | null;
-};