rawsql-ts 0.9.0-beta → 0.10.0-beta

package/dist/esm/transformers/PostgresObjectEntityCteBuilder.js

@@ -0,0 +1,283 @@
+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 {
+    buildObjectEntityCtes(initialCte, allEntities, mapping) {
+        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 };
+    } /**
+     * 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, mapping.useJsonb);
+        // Build NULL condition and CASE expression
+        const nullCondition = this.buildNullCondition(nullChecks);
+        const caseExpr = this.createCaseExpression(nullCondition, jsonObject);
+        // Add JSON object as named column
+        const jsonColumnName = `${entity.name.toLowerCase()}${PostgresObjectEntityCteBuilder.JSON_COLUMN_SUFFIX}`;
+        return new SelectItem(caseExpr, jsonColumnName);
+    }
+    /**
+     * 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));
+            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));
+                const jsonColumnName = `${child.name.toLowerCase()}${PostgresObjectEntityCteBuilder.JSON_COLUMN_SUFFIX}`;
+                jsonObjectArgs.push(new ColumnReference(null, new IdentifierString(jsonColumnName)));
+            }
+        });
+    }
+    /**
+     * Create JSON object function call
+     */
+    createJsonObject(args, useJsonb = false) {
+        const jsonBuildFunction = useJsonb ? "jsonb_build_object" : "json_build_object";
+        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.JSON_COLUMN_SUFFIX = '_json';
+PostgresObjectEntityCteBuilder.CTE_OBJECT_PREFIX = 'cte_object_depth_';
+PostgresObjectEntityCteBuilder.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
+ */
+//# sourceMappingURL=PostgresObjectEntityCteBuilder.js.map

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

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

package/dist/esm/transformers/SqlPrinter.js

@@ -32,9 +32,15 @@ export class SqlPrinter {
             SqlPrintTokenContainerType.LimitClause,
             SqlPrintTokenContainerType.OffsetClause,
             SqlPrintTokenContainerType.SubQuerySource,
-            SqlPrintTokenContainerType.BinarySelectQueryOperator,
-            SqlPrintTokenContainerType.Values,
-            SqlPrintTokenContainerType.WithClause
+            SqlPrintTokenContainerType.BinarySelectQueryOperator, SqlPrintTokenContainerType.Values,
+            SqlPrintTokenContainerType.WithClause,
+            SqlPrintTokenContainerType.SwitchCaseArgument,
+            SqlPrintTokenContainerType.CaseKeyValuePair,
+            SqlPrintTokenContainerType.CaseThenValue,
+            SqlPrintTokenContainerType.ElseClause,
+            SqlPrintTokenContainerType.CaseElseValue
+            // CaseExpression, SwitchCaseArgument, CaseKeyValuePair, and ElseClause
+            // are not included by default to maintain backward compatibility with tests
             //SqlPrintTokenContainerType.CommonTable
         ]);
     }

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

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

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)
      */
@@ -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;
+}