linkgress-orm 0.0.2 → 0.1.0

package/dist/query/sql-utils.d.ts

@@ -0,0 +1,83 @@
+import type { TableSchema } from '../schema/table-builder';
+/**
+ * Column configuration extracted from schema
+ */
+export interface ColumnConfig {
+    propName: string;
+    dbName: string;
+    mapper?: {
+        toDriver: (value: any) => any;
+        fromDriver: (value: any) => any;
+    };
+    primaryKey?: boolean;
+    autoIncrement?: boolean;
+}
+/**
+ * Result from building VALUES clause
+ */
+export interface ValuesClauseResult {
+    valueClauses: string[];
+    params: any[];
+    nextParamIndex: number;
+}
+/**
+ * Get qualified table name with schema prefix if specified
+ */
+export declare function getQualifiedTableName(schema: TableSchema): string;
+/**
+ * Build RETURNING column list from schema
+ */
+export declare function buildReturningColumnList(schema: TableSchema): string;
+/**
+ * Build column names list from property keys
+ */
+export declare function buildColumnNamesList(schema: TableSchema, columnKeys: string[]): string[];
+/**
+ * Apply mapper and get value for database
+ */
+export declare function applyToDriverMapper(value: any, config: ColumnConfig): any;
+/**
+ * Apply fromDriver mapper on query result
+ */
+export declare function applyFromDriverMapper(value: any, config: ColumnConfig): any;
+/**
+ * Detect primary keys from schema
+ */
+export declare function detectPrimaryKeys(schema: TableSchema): string[];
+/**
+ * Check if schema has auto-increment primary key with provided data
+ */
+export declare function hasAutoIncrementPrimaryKey(schema: TableSchema, dataKeys: string[]): boolean;
+/**
+ * PostgreSQL maximum parameter limit
+ */
+export declare const POSTGRES_MAX_PARAMS = 65535;
+/**
+ * Calculate optimal chunk size for bulk operations
+ */
+export declare function calculateOptimalChunkSize(columnCount: number, configChunkSize?: number): number;
+/**
+ * Build column configs from schema for given data keys
+ */
+export declare function buildColumnConfigs(schema: TableSchema, dataKeys: string[], includeAutoIncrement?: boolean): ColumnConfig[];
+/**
+ * Extract unique column keys from array of data objects
+ */
+export declare function extractUniqueColumnKeys(dataArray: Record<string, any>[], schema: TableSchema, includeAutoIncrement?: boolean): string[];
+/**
+ * Build VALUES clause with parameter placeholders
+ */
+export declare function buildValuesClause(dataArray: Record<string, any>[], columnConfigs: ColumnConfig[], startParamIndex?: number): ValuesClauseResult;
+/**
+ * Build ON CONFLICT clause for upserts
+ */
+export declare function buildConflictClause(conflictColumns: string[], updateColumns: string[], schema: TableSchema, targetWhere?: string, setWhere?: string): string;
+/**
+ * Build column name to DB name mapping
+ */
+export declare function buildColumnNameMap(schema: TableSchema): Map<string, string>;
+/**
+ * Get database column name from property name
+ */
+export declare function getDbColumnName(schema: TableSchema, propName: string): string;
+//# sourceMappingURL=sql-utils.d.ts.map

package/dist/query/sql-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-utils.d.ts","sourceRoot":"","sources":["../../src/query/sql-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;QAC9B,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;KACjC,CAAC;IACF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAIjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAIpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CAKzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CAI3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAS/D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAW3F;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,oBAAoB,GAAE,OAAe,GACpC,YAAY,EAAE,CAoBhB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAChC,MAAM,EAAE,WAAW,EACnB,oBAAoB,GAAE,OAAe,GACpC,MAAM,EAAE,CAgBV;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAChC,aAAa,EAAE,YAAY,EAAE,EAC7B,eAAe,GAAE,MAAU,GAC1B,kBAAkB,CAuBpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EAAE,EACzB,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAgCR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO7E"}

package/dist/query/sql-utils.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POSTGRES_MAX_PARAMS = void 0;
+exports.getQualifiedTableName = getQualifiedTableName;
+exports.buildReturningColumnList = buildReturningColumnList;
+exports.buildColumnNamesList = buildColumnNamesList;
+exports.applyToDriverMapper = applyToDriverMapper;
+exports.applyFromDriverMapper = applyFromDriverMapper;
+exports.detectPrimaryKeys = detectPrimaryKeys;
+exports.hasAutoIncrementPrimaryKey = hasAutoIncrementPrimaryKey;
+exports.calculateOptimalChunkSize = calculateOptimalChunkSize;
+exports.buildColumnConfigs = buildColumnConfigs;
+exports.extractUniqueColumnKeys = extractUniqueColumnKeys;
+exports.buildValuesClause = buildValuesClause;
+exports.buildConflictClause = buildConflictClause;
+exports.buildColumnNameMap = buildColumnNameMap;
+exports.getDbColumnName = getDbColumnName;
+/**
+ * Get qualified table name with schema prefix if specified
+ */
+function getQualifiedTableName(schema) {
+    return schema.schema
+        ? `"${schema.schema}"."${schema.name}"`
+        : `"${schema.name}"`;
+}
+/**
+ * Build RETURNING column list from schema
+ */
+function buildReturningColumnList(schema) {
+    return Object.entries(schema.columns)
+        .map(([_, col]) => `"${col.build().name}"`)
+        .join(', ');
+}
+/**
+ * Build column names list from property keys
+ */
+function buildColumnNamesList(schema, columnKeys) {
+    return columnKeys.map(key => {
+        const column = schema.columns[key];
+        const config = column.build();
+        return `"${config.name}"`;
+    });
+}
+/**
+ * Apply mapper and get value for database
+ */
+function applyToDriverMapper(value, config) {
+    const normalizedValue = value !== undefined ? value : null;
+    return config.mapper
+        ? config.mapper.toDriver(normalizedValue)
+        : normalizedValue;
+}
+/**
+ * Apply fromDriver mapper on query result
+ */
+function applyFromDriverMapper(value, config) {
+    return config.mapper
+        ? config.mapper.fromDriver(value)
+        : value;
+}
+/**
+ * Detect primary keys from schema
+ */
+function detectPrimaryKeys(schema) {
+    const primaryKeys = [];
+    for (const [key, colBuilder] of Object.entries(schema.columns)) {
+        const colConfig = colBuilder.build();
+        if (colConfig.primaryKey) {
+            primaryKeys.push(key);
+        }
+    }
+    return primaryKeys;
+}
+/**
+ * Check if schema has auto-increment primary key with provided data
+ */
+function hasAutoIncrementPrimaryKey(schema, dataKeys) {
+    for (const key of dataKeys) {
+        const column = schema.columns[key];
+        if (column) {
+            const colConfig = column.build();
+            if (colConfig.primaryKey && colConfig.autoIncrement) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * PostgreSQL maximum parameter limit
+ */
+exports.POSTGRES_MAX_PARAMS = 65535;
+/**
+ * Calculate optimal chunk size for bulk operations
+ */
+function calculateOptimalChunkSize(columnCount, configChunkSize) {
+    if (configChunkSize != null) {
+        return configChunkSize;
+    }
+    const maxRowsPerBatch = Math.floor(exports.POSTGRES_MAX_PARAMS / columnCount);
+    return Math.floor(maxRowsPerBatch * 0.6); // Use 60% of max to be safe
+}
+/**
+ * Build column configs from schema for given data keys
+ */
+function buildColumnConfigs(schema, dataKeys, includeAutoIncrement = false) {
+    const configs = [];
+    for (const propName of dataKeys) {
+        const column = schema.columns[propName];
+        if (column) {
+            const config = column.build();
+            if (!config.autoIncrement || includeAutoIncrement) {
+                configs.push({
+                    propName,
+                    dbName: config.name,
+                    mapper: config.mapper,
+                    primaryKey: config.primaryKey,
+                    autoIncrement: config.autoIncrement,
+                });
+            }
+        }
+    }
+    return configs;
+}
+/**
+ * Extract unique column keys from array of data objects
+ */
+function extractUniqueColumnKeys(dataArray, schema, includeAutoIncrement = false) {
+    const columnSet = new Set();
+    for (const data of dataArray) {
+        for (const key of Object.keys(data)) {
+            const column = schema.columns[key];
+            if (column) {
+                const config = column.build();
+                if (!config.autoIncrement || includeAutoIncrement) {
+                    columnSet.add(key);
+                }
+            }
+        }
+    }
+    return Array.from(columnSet);
+}
+/**
+ * Build VALUES clause with parameter placeholders
+ */
+function buildValuesClause(dataArray, columnConfigs, startParamIndex = 1) {
+    const valueClauses = [];
+    const params = [];
+    let paramIndex = startParamIndex;
+    for (const data of dataArray) {
+        const rowPlaceholders = [];
+        for (const config of columnConfigs) {
+            const value = data[config.propName];
+            const mappedValue = applyToDriverMapper(value, config);
+            params.push(mappedValue);
+            rowPlaceholders.push(`$${paramIndex++}`);
+        }
+        valueClauses.push(`(${rowPlaceholders.join(', ')})`);
+    }
+    return {
+        valueClauses,
+        params,
+        nextParamIndex: paramIndex,
+    };
+}
+/**
+ * Build ON CONFLICT clause for upserts
+ */
+function buildConflictClause(conflictColumns, updateColumns, schema, targetWhere, setWhere) {
+    let sql = ' ON CONFLICT';
+    // Conflict target columns
+    const conflictCols = conflictColumns.map(c => {
+        const column = schema.columns[c];
+        const config = column?.build();
+        return `"${config?.name || c}"`;
+    }).join(', ');
+    sql += ` (${conflictCols})`;
+    // Target WHERE clause
+    if (targetWhere) {
+        sql += ` WHERE ${targetWhere}`;
+    }
+    // DO UPDATE SET
+    sql += ' DO UPDATE SET ';
+    const updateParts = updateColumns.map(col => {
+        const column = schema.columns[col];
+        const config = column.build();
+        return `"${config.name}" = EXCLUDED."${config.name}"`;
+    });
+    sql += updateParts.join(', ');
+    // SET WHERE clause
+    if (setWhere) {
+        sql += ` WHERE ${setWhere}`;
+    }
+    return sql;
+}
+/**
+ * Build column name to DB name mapping
+ */
+function buildColumnNameMap(schema) {
+    const map = new Map();
+    for (const [propName, colBuilder] of Object.entries(schema.columns)) {
+        const config = colBuilder.build();
+        map.set(propName, config.name);
+    }
+    return map;
+}
+/**
+ * Get database column name from property name
+ */
+function getDbColumnName(schema, propName) {
+    const column = schema.columns[propName];
+    if (column) {
+        const config = column.build();
+        return config.name;
+    }
+    return propName;
+}
+//# sourceMappingURL=sql-utils.js.map

package/dist/query/sql-utils.js.map

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

package/dist/query/strategies/cte-collection-strategy.d.ts

@@ -0,0 +1,85 @@
+import { ICollectionStrategy, CollectionStrategyType, CollectionAggregationConfig, CollectionAggregationResult } from '../collection-strategy.interface';
+import { QueryContext } from '../query-builder';
+/**
+ * CTE-based collection strategy
+ *
+ * This is the current/default strategy that uses PostgreSQL CTEs with jsonb_agg
+ * to aggregate related records into JSONB arrays.
+ *
+ * Benefits:
+ * - Single query execution
+ * - No temp table management
+ * - Works well for moderate data sizes
+ *
+ * SQL Pattern:
+ * ```sql
+ * WITH "cte_0" AS (
+ *   SELECT
+ *     "user_id" as parent_id,
+ *     jsonb_agg(
+ *       jsonb_build_object('id', "id", 'title', "title")
+ *       ORDER BY "views" DESC
+ *     ) as data
+ *   FROM (
+ *     SELECT "user_id", "id", "title", "views"
+ *     FROM "posts"
+ *     WHERE "views" > $1
+ *     ORDER BY "views" DESC
+ *   ) sub
+ *   GROUP BY "user_id"
+ * )
+ * SELECT ... COALESCE("cte_0".data, '[]'::jsonb) as "posts" ...
+ * ```
+ */
+export declare class CteCollectionStrategy implements ICollectionStrategy {
+    getType(): CollectionStrategyType;
+    requiresParentIds(): boolean;
+    buildAggregation(config: CollectionAggregationConfig, context: QueryContext): CollectionAggregationResult;
+    /**
+     * Helper to collect all leaf fields from a potentially nested structure
+     * Returns array of { alias, expression } for SELECT clause (flattened with unique aliases)
+     */
+    private collectLeafFields;
+    /**
+     * Helper to build jsonb_build_object expression (handles nested structures)
+     */
+    private buildJsonbObject;
+    /**
+     * Build JSONB aggregation CTE
+     *
+     * When LIMIT/OFFSET is specified, uses ROW_NUMBER() window function to correctly
+     * apply pagination per parent row (not globally).
+     */
+    private buildJsonbAggregation;
+    /**
+     * Build JSONB aggregation with ROW_NUMBER() for per-parent LIMIT/OFFSET
+     *
+     * SQL Pattern:
+     * ```sql
+     * SELECT parent_id, jsonb_agg(jsonb_build_object(...)) as data
+     * FROM (
+     *   SELECT *, ROW_NUMBER() OVER (PARTITION BY foreign_key ORDER BY ...) as __rn
+     *   FROM (SELECT ... FROM table WHERE ...) inner_sub
+     * ) sub
+     * WHERE __rn > offset AND __rn <= offset + limit
+     * GROUP BY parent_id
+     * ```
+     */
+    private buildJsonbAggregationWithRowNumber;
+    /**
+     * Build array aggregation CTE (for toNumberList/toStringList)
+     *
+     * When LIMIT/OFFSET is specified, uses ROW_NUMBER() window function to correctly
+     * apply pagination per parent row (not globally).
+     */
+    private buildArrayAggregation;
+    /**
+     * Build array aggregation with ROW_NUMBER() for per-parent LIMIT/OFFSET
+     */
+    private buildArrayAggregationWithRowNumber;
+    /**
+     * Build scalar aggregation CTE (COUNT, MIN, MAX, SUM)
+     */
+    private buildScalarAggregation;
+}
+//# sourceMappingURL=cte-collection-strategy.d.ts.map

package/dist/query/strategies/cte-collection-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cte-collection-strategy.d.ts","sourceRoot":"","sources":["../../../src/query/strategies/cte-collection-strategy.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAE5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,qBAAsB,YAAW,mBAAmB;IAC/D,OAAO,IAAI,sBAAsB;IAIjC,iBAAiB,IAAI,OAAO;IAK5B,gBAAgB,CACd,MAAM,EAAE,2BAA2B,EACnC,OAAO,EAAE,YAAY,GACpB,2BAA2B;IA0C9B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IA8D7B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,kCAAkC;IAuD1C;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAkD7B;;OAEG;IACH,OAAO,CAAC,kCAAkC;IAwC1C;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAuC/B"}