@baasix/baasix 0.1.0

package/dist/utils/queryBuilder.js

@@ -0,0 +1,489 @@
+/**
+ * Query Builder Module for Drizzle ORM
+ *
+ * This module provides query building utilities that convert Sequelize-style
+ * filter/where objects into Drizzle ORM where conditions.
+ *
+ * Features:
+ * - Convert filter objects to Drizzle where conditions
+ * - Support AND/OR logical operators
+ * - Handle nested conditions and relations
+ * - Column qualification for joins
+ * - Type casting support
+ * - Pagination helpers
+ *
+ * RELATION PATH FILTERING:
+ * - Relation path filters (e.g., "userRoles.role.name") ARE NOW SUPPORTED
+ *   1. Parses relation paths into segments
+ *   2. Recursively resolves each segment by looking up relation metadata
+ *   3. Builds LEFT JOIN clauses dynamically
+ *   4. Returns the final column reference for the WHERE clause
+ *
+ *   Example usage:
+ *     conditions: {
+ *       "userRoles.role.name": { in: ["admin", "user"] },
+ *       "author.company.name": { eq: "ACME" }
+ *     }
+ *
+ *   The query builder will automatically generate the necessary JOINs:
+ *     LEFT JOIN userRoles_... ON ...
+ *     LEFT JOIN roles_... ON ...
+ *     LEFT JOIN companies_... ON ...
+ *
+ *   Joins are accumulated in ctx.joins array and must be applied by the caller.
+ *
+ * NOTES:
+ * - Currently supports BelongsTo, HasMany, and HasOne relations
+ * - BelongsToMany (many-to-many) uses simplified join (needs junction table support)
+ * - Coordination with the two-query approach for HasMany sorting is handled by the caller
+ */
+import { and, or, sql } from 'drizzle-orm';
+import { applyOperator, OPERATOR_MAP } from './filterOperators.js';
+import { resolveRelationPath, isRelationPath } from './relationPathResolver.js';
+/**
+ * Check if a key represents a column name
+ * Supports both $column$ format and plain column format
+ */
+function isColumnKey(key) {
+    // Check for $column$ format
+    if (key.startsWith('$') && key.endsWith('$')) {
+        return true;
+    }
+    // Check if it's not a logical operator or special key
+    const reservedKeys = ['AND', 'OR', 'cast'];
+    if (reservedKeys.includes(key)) {
+        return false;
+    }
+    // Check if key is an operator name
+    if (key in OPERATOR_MAP) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Extract column name from key (with or without $ delimiters)
+ */
+function extractColumnName(key) {
+    if (key.startsWith('$') && key.endsWith('$')) {
+        return key.slice(1, -1); // Remove $ from start and end
+    }
+    return key;
+}
+/**
+ * Get qualified field name for SQL
+ * Handles both direct fields and relational paths
+ */
+function getQualifiedField(field, ctx) {
+    const rawField = extractColumnName(field);
+    if (ctx.tableName && !rawField.includes('.')) {
+        // Special handling for ID field
+        if (rawField === 'id') {
+            return `${ctx.tableName}.id`;
+        }
+        return `${ctx.tableName}.${rawField}`;
+    }
+    return rawField;
+}
+/**
+ * Get column from schema
+ *
+ * NOTE: This function only works for direct columns on the main table.
+ * For relation paths like "userRoles.role.name", it will return null
+ * because the field doesn't exist in the main table's schema.
+ * See KNOWN LIMITATIONS in the module header for details.
+ */
+function getColumn(fieldName, ctx) {
+    if (!ctx.schema)
+        return null;
+    const cleanField = extractColumnName(fieldName);
+    const column = ctx.schema[cleanField];
+    return column || null;
+}
+/**
+ * Process a single condition (field with operators)
+ */
+function processFieldCondition(fieldName, value, ctx) {
+    const cleanFieldName = extractColumnName(fieldName);
+    // Check if this is a relation path (contains dots)
+    if (isRelationPath(cleanFieldName) && ctx.table && ctx.tableName) {
+        // Resolve the relation path to get joins and final column
+        const resolved = resolveRelationPath(cleanFieldName, ctx.table, ctx.tableName, undefined, ctx.forPermissionCheck);
+        // Add the joins to the context
+        if (ctx.joins && resolved.joins.length > 0) {
+            ctx.joins.push(...resolved.joins);
+        }
+        // If we couldn't resolve the column, skip this condition
+        if (!resolved.column && !resolved.columnPath) {
+            console.warn(`[queryBuilder] Could not resolve relation path: ${cleanFieldName}`);
+            return null;
+        }
+        // Use the resolved column from aliased table
+        // use Drizzle column reference, not raw SQL
+        // Simple equality if value is primitive
+        if (typeof value !== 'object' || value === null || value instanceof Date || Array.isArray(value)) {
+            return applyOperator('eq', {
+                column: resolved.column,
+                fieldName: resolved.columnPath,
+                // Pass a dummy tableName to trigger raw SQL path for relation filters
+                // This is needed to bypass Drizzle's type mappers for date values
+                tableName: 'relation',
+                schemaTable: resolved.finalTable
+            }, value);
+        }
+        // Extract cast type if present
+        const castType = value.cast;
+        // Process each operator in the value object
+        const conditions = [];
+        for (const [operatorName, operatorValue] of Object.entries(value)) {
+            if (operatorName === 'cast')
+                continue; // Skip cast property
+            const condition = applyOperator(operatorName, {
+                column: resolved.column,
+                fieldName: resolved.columnPath,
+                // Pass a dummy tableName to trigger raw SQL path for relation filters
+                // This is needed to bypass Drizzle's type mappers for date values
+                tableName: 'relation',
+                schemaTable: resolved.finalTable
+            }, operatorValue, castType);
+            if (condition) {
+                conditions.push(condition);
+            }
+        }
+        // Combine multiple operators on same field with AND
+        if (conditions.length === 0)
+            return null;
+        if (conditions.length === 1)
+            return conditions[0];
+        return and(...conditions) || null;
+    }
+    // Not a relation path - handle as direct column
+    const qualifiedField = getQualifiedField(fieldName, ctx);
+    const column = getColumn(fieldName, ctx);
+    if (!column) {
+        // Only warn if we have a schema to check against
+        if (ctx.schema) {
+            const availableColumns = Object.keys(ctx.schema).filter(k => !k.startsWith('_'));
+            console.warn(`Column not found for field: ${fieldName}. Available columns: ${availableColumns.slice(0, 10).join(', ')}${availableColumns.length > 10 ? '...' : ''}`);
+        }
+        else {
+            console.warn(`Column not found for field: ${fieldName} (no schema provided)`);
+        }
+        return null;
+    }
+    // Simple equality if value is primitive
+    if (typeof value !== 'object' || value === null || value instanceof Date || Array.isArray(value)) {
+        // Direct value - use equality
+        const operatorCtx = {
+            column,
+            fieldName: qualifiedField,
+            tableName: ctx.tableName,
+            schemaTable: ctx.table
+        };
+        return applyOperator('eq', operatorCtx, value);
+    }
+    // Extract cast type if present
+    const castType = value.cast;
+    // Process each operator in the value object
+    const conditions = [];
+    for (const [operatorName, operatorValue] of Object.entries(value)) {
+        if (operatorName === 'cast')
+            continue; // Skip cast property
+        const operatorCtx = {
+            column,
+            fieldName: qualifiedField,
+            tableName: ctx.tableName,
+            schemaTable: ctx.table
+        };
+        // Get element type for array operators if available
+        let elementType;
+        if ((operatorName === 'arraycontains' || operatorName === 'arraycontained') && ctx.schemaDefinition) {
+            // Try to extract array element type from schema definition
+            const fieldDef = ctx.schemaDefinition?.fields?.[fieldName];
+            if (fieldDef?.elementType) {
+                elementType = fieldDef.elementType;
+            }
+        }
+        const condition = applyOperator(operatorName, operatorCtx, operatorValue, castType, elementType);
+        if (condition) {
+            conditions.push(condition);
+        }
+    }
+    // Combine multiple operators on same field with AND
+    if (conditions.length === 0)
+        return null;
+    if (conditions.length === 1)
+        return conditions[0];
+    return and(...conditions) || null;
+}
+/**
+ * Process a single condition object recursively
+ */
+function processCondition(condition, ctx) {
+    // Handle AND operator
+    if (condition.AND) {
+        const subConditions = condition.AND
+            .map(c => processCondition(c, ctx))
+            .filter((c) => c !== null);
+        if (subConditions.length === 0)
+            return null;
+        if (subConditions.length === 1)
+            return subConditions[0];
+        return and(...subConditions) || null;
+    }
+    // Handle OR operator
+    if (condition.OR) {
+        const subConditions = condition.OR
+            .map(c => processCondition(c, ctx))
+            .filter((c) => c !== null);
+        if (subConditions.length === 0)
+            return null;
+        if (subConditions.length === 1)
+            return subConditions[0];
+        return or(...subConditions) || null;
+    }
+    // Process field conditions
+    const fieldConditions = [];
+    for (const [key, value] of Object.entries(condition)) {
+        if (isColumnKey(key)) {
+            // It's a field condition
+            const fieldCondition = processFieldCondition(key, value, ctx);
+            if (fieldCondition) {
+                fieldConditions.push(fieldCondition);
+            }
+        }
+        else if (key === 'AND' || key === 'OR') {
+            // Already handled above
+            continue;
+        }
+        else {
+            // Unknown key, log warning
+            console.warn(`Unknown filter key: ${key}`);
+        }
+    }
+    // Combine all field conditions with AND
+    if (fieldConditions.length === 0)
+        return null;
+    if (fieldConditions.length === 1)
+        return fieldConditions[0];
+    return and(...fieldConditions) || null;
+}
+/**
+ * Main function: Convert Sequelize-style filter to Drizzle where condition
+ *
+ * @param filter - Filter object (Sequelize-style)
+ * @param ctx - Query context with table schema information
+ * @returns Drizzle SQL where condition
+ *
+ * @example
+ * ```typescript
+ * const filter = {
+ *   age: { gt: 18 },
+ *   status: { in: ['active', 'pending'] }
+ * };
+ *
+ * const where = drizzleWhere(filter, {
+ *   table: usersTable,
+ *   tableName: 'users',
+ *   schema: usersTable
+ * });
+ *
+ * // Use in query:
+ * const results = await db.select().from(usersTable).where(where);
+ * ```
+ */
+export function drizzleWhere(filter, ctx) {
+    if (!filter || Object.keys(filter).length === 0) {
+        return undefined;
+    }
+    const condition = processCondition(filter, ctx);
+    return condition || undefined;
+}
+/**
+ * Extract field paths from relational conditions
+ * Used to determine which relations need to be included/joined
+ */
+export function extractFieldPathsFromRelConditions(relConditions) {
+    const fieldPaths = new Set();
+    const joinPaths = new Set();
+    function processRecursive(conditions, prefix = '') {
+        if (!conditions || typeof conditions !== 'object')
+            return;
+        for (const [key, value] of Object.entries(conditions)) {
+            if (isColumnKey(key)) {
+                // It's a field condition
+                const fieldName = extractColumnName(key);
+                const fieldPath = prefix ? `${prefix}.${fieldName}` : fieldName;
+                fieldPaths.add(fieldPath);
+                // Add parent path for joins
+                if (prefix) {
+                    joinPaths.add(prefix);
+                }
+            }
+            else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                // It's a nested relation or object with operators
+                const nestedPrefix = prefix ? `${prefix}.${key}` : key;
+                // Add this path to join paths
+                if (nestedPrefix) {
+                    joinPaths.add(nestedPrefix);
+                }
+                // Check if this level contains field conditions
+                const hasFieldConditions = Object.keys(value).some((k) => isColumnKey(k));
+                if (hasFieldConditions) {
+                    for (const [innerKey] of Object.entries(value)) {
+                        if (isColumnKey(innerKey)) {
+                            const fieldName = extractColumnName(innerKey);
+                            const fieldPath = nestedPrefix ? `${nestedPrefix}.${fieldName}` : fieldName;
+                            fieldPaths.add(fieldPath);
+                        }
+                    }
+                }
+                // Continue processing nested relations
+                processRecursive(value, nestedPrefix);
+            }
+            else if (Array.isArray(value)) {
+                // Handle arrays of conditions (e.g., AND, OR)
+                value.forEach((item) => processRecursive(item, prefix));
+            }
+        }
+    }
+    processRecursive(relConditions);
+    return Array.from(fieldPaths);
+}
+/**
+ * Combine multiple filters with AND logic
+ * Returns empty object instead of undefined for better type safety
+ */
+export function combineFilters(...filters) {
+    const validFilters = filters.filter((f) => f !== null && f !== undefined && Object.keys(f).length > 0);
+    if (validFilters.length === 0)
+        return {};
+    if (validFilters.length === 1)
+        return validFilters[0];
+    return { AND: validFilters };
+}
+/**
+ * Apply pagination to query
+ * Supports both limit/offset and page/pageSize styles
+ * When page is provided with limit, uses limit as pageSize and calculates offset
+ */
+export function applyPagination(options) {
+    // If page is provided, calculate offset based on page number
+    // Use limit or pageSize as the page size
+    if (options.page !== undefined) {
+        const page = Math.max(1, options.page);
+        const pageSize = options.limit ?? options.pageSize ?? 10;
+        return {
+            limit: pageSize,
+            offset: (page - 1) * pageSize
+        };
+    }
+    // Direct limit/offset style (no page number)
+    if (options.limit !== undefined || options.offset !== undefined) {
+        return {
+            limit: options.limit,
+            offset: options.offset || 0
+        };
+    }
+    return {};
+}
+/**
+ * Calculate pagination metadata
+ */
+export function calculatePaginationMetadata(total, options) {
+    const page = options.page || 1;
+    const pageSize = options.pageSize || options.limit || 10;
+    const pageCount = Math.ceil(total / pageSize);
+    return {
+        total,
+        page,
+        pageSize,
+        pageCount,
+        hasNextPage: page < pageCount,
+        hasPreviousPage: page > 1
+    };
+}
+/**
+ * Helper to build WHERE clause from multiple filter sources
+ * Useful for combining base filters, user filters, tenant filters, etc.
+ */
+export function buildWhereClause(ctx, ...filters) {
+    const combined = combineFilters(...filters);
+    return drizzleWhere(combined, ctx);
+}
+/**
+ * Extract all field names from a filter object
+ * Useful for permission validation
+ */
+export function extractFieldNamesFromFilter(filter) {
+    const fields = new Set();
+    function extract(obj) {
+        if (!obj || typeof obj !== 'object')
+            return;
+        for (const [key, value] of Object.entries(obj)) {
+            if (isColumnKey(key)) {
+                fields.add(extractColumnName(key));
+            }
+            else if (key === 'AND' || key === 'OR') {
+                if (Array.isArray(value)) {
+                    value.forEach(extract);
+                }
+            }
+            else if (typeof value === 'object') {
+                extract(value);
+            }
+        }
+    }
+    extract(filter);
+    return Array.from(fields);
+}
+/**
+ * Apply PostgreSQL full-text search to a query
+ * Matches Sequelize implementation for compatibility
+ *
+ * @param tableName - Name of the table being searched
+ * @param tableColumns - Column definitions from the table schema
+ * @param searchQuery - The search string
+ * @param searchFields - Fields to search in (optional, defaults to string fields)
+ * @param sortByRelevance - Whether to sort by relevance score
+ * @returns SQL condition for full-text search and optional order clause
+ */
+export function applyFullTextSearch(tableName, tableColumns, searchQuery, searchFields, sortByRelevance = false) {
+    let searchableFields = searchFields;
+    if (!searchableFields || searchableFields.length === 0) {
+        // If searchFields not provided, use string fields
+        // This matches Sequelize behavior which uses STRING and UUID fields
+        searchableFields = Object.keys(tableColumns).filter((field) => {
+            const column = tableColumns[field];
+            // Check if it's a text/string type column
+            // In Drizzle, we can check the dataType or columnType
+            const columnType = column.dataType || column.columnType || '';
+            return (columnType.includes('varchar') ||
+                columnType.includes('text') ||
+                columnType.includes('char') ||
+                columnType.includes('uuid'));
+        });
+        // If no string fields found, default to all fields
+        if (searchableFields.length === 0) {
+            searchableFields = Object.keys(tableColumns);
+        }
+    }
+    // Create concatenated string of all searchable fields with proper table qualification
+    // Use sql template instead of sql.raw for COALESCE expressions
+    const concatParts = searchableFields.map((field) => sql `COALESCE(${sql.raw(`"${tableName}"."${field}"`)}::text, '')`);
+    // Build the concatenation using sql.join() 
+    const concatExpr = sql.join(concatParts, sql ` || ' ' || `);
+    // Prepare the full-text search query with proper escaping
+    // Replace spaces with :* & to match partial words
+    const tsQuery = searchQuery.trim().replace(/\s+/g, ':* & ') + ':*';
+    // Escape single quotes to prevent SQL injection
+    const escapedTsQuery = tsQuery.replace(/'/g, "''");
+    // Build the full-text search condition using parameterized values
+    const searchCondition = sql `to_tsvector('english', ${concatExpr}) @@ to_tsquery('english', ${escapedTsQuery})`;
+    let orderClause;
+    // Apply sorting by relevance using ts_rank if sortByRelevance is true
+    if (sortByRelevance) {
+        orderClause = sql `ts_rank(to_tsvector('english', ${concatExpr}), to_tsquery('english', ${escapedTsQuery})) DESC`;
+    }
+    return { searchCondition, orderClause };
+}
+//# sourceMappingURL=queryBuilder.js.map

package/dist/utils/queryBuilder.js.map

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

package/dist/utils/relationLoader.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Relation Loader Module for Drizzle ORM
+ *
+ * This module provides utilities for building joins and loading related data
+ * in Drizzle ORM, matching Sequelize's include/association behavior.
+ *
+ * Features:
+ * - BelongsTo join building
+ * - HasOne join building
+ * - HasMany separate query loading
+ * - BelongsToMany (M2M) through junction tables
+ * - M2A polymorphic relations
+ * - Nested relation loading (include.include)
+ * - Relation filtering and ordering
+ */
+import { SQL } from 'drizzle-orm';
+import { PgTable } from 'drizzle-orm/pg-core';
+import type { ProcessedInclude, ExpandedFieldsResult } from '../types/index.js';
+export declare function expandFieldsWithIncludes(fields: string[], tableName: string): ExpandedFieldsResult;
+/**
+ * Build LEFT JOIN clause for includes
+ * Only for BelongsTo and HasOne relations
+ * HasMany will use separate queries
+ */
+export declare function buildJoinsForIncludes(includes: ProcessedInclude[]): SQL[];
+/**
+ * Load HasMany relations with separate queries
+ * This is more efficient than joining for one-to-many relations
+ */
+export declare function loadHasManyRelations(db: any, mainRecords: any[], includes: ProcessedInclude[], sourceTableName: string): Promise<any[]>;
+/**
+ * Load M2A (polymorphic) relations with junction table
+ */
+export declare function loadM2ARelations(db: any, mainRecords: any[], includes: ProcessedInclude[], sourceTableName: string): Promise<any[]>;
+/**
+ * Load BelongsToMany (M2M) relations with junction table
+ */
+export declare function loadBelongsToManyRelations(db: any, mainRecords: any[], includes: ProcessedInclude[], sourceTableName: string): Promise<any[]>;
+/**
+ * Load all separate-query relations (HasMany, BelongsToMany)
+ */
+/**
+ * Nest flattened BelongsTo/HasOne relation data from JOINs
+ * Converts { "category.name": "Electronics", "category.id": "123" }
+ * to { category: { name: "Electronics", id: "123" } }
+ */
+export declare function nestJoinedRelations(records: any[], includes: ProcessedInclude[], parentPath?: string): any[];
+export declare function loadSeparateRelations(db: any, mainRecords: any[], includes: ProcessedInclude[], sourceTableName: string): Promise<any[]>;
+/**
+ * Build complete select with joins
+ * Returns SELECT columns and JOIN clauses
+ */
+export declare function buildSelectWithJoins(mainTable: PgTable, directFields: string[], includes: ProcessedInclude[]): {
+    selectColumns: Record<string, any>;
+    joins: SQL[];
+};
+/**
+ * Utility: Check if any include requires separate query
+ */
+export declare function hasSeparateQueries(includes: ProcessedInclude[]): boolean;
+/**
+ * Utility: Get all relation names from includes (flat list)
+ */
+export declare function getRelationNames(includes: ProcessedInclude[]): string[];
+//# sourceMappingURL=relationLoader.d.ts.map

package/dist/utils/relationLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationLoader.d.ts","sourceRoot":"","sources":["../../baasix/utils/relationLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,GAAG,EAAwB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,OAAO,EAAmB,MAAM,qBAAqB,CAAC;AAK/D,OAAO,KAAK,EAGV,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AA4F3B,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,MAAM,GAChB,oBAAoB,CA4GtB;AAuND;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,GAAG,EAAE,CAgCzE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,GAAG,EACP,WAAW,EAAE,GAAG,EAAE,EAClB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,GAAG,EAAE,CAAC,CAwLhB;AAiJD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,GAAG,EACP,WAAW,EAAE,GAAG,EAAE,EAClB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,GAAG,EAAE,CAAC,CA8JhB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,GAAG,EACP,WAAW,EAAE,GAAG,EAAE,EAClB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,GAAG,EAAE,CAAC,CAiHhB;AAED;;GAEG;AACH;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,GAAG,EAAE,EACd,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,UAAU,GAAE,MAAW,GACtB,GAAG,EAAE,CAoDP;AAED,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,GAAG,EACP,WAAW,EAAE,GAAG,EAAE,EAClB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,GAAG,EAAE,CAAC,CAchB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,EAAE,gBAAgB,EAAE,GAC3B;IACD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,KAAK,EAAE,GAAG,EAAE,CAAC;CACd,CAgDA;AAkCD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAQxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAYvE"}