@tablecraft/engine 0.1.0-beta.1

package/dist/src/core/paginationBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginationBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/paginationBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,eAAe,CACb,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB;IA2BnB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,UAAU;CAUnE"}

package/dist/src/core/paginationBuilder.js

@@ -0,0 +1,42 @@
+export class PaginationBuilder {
+    /**
+     * Computes LIMIT and OFFSET from page/pageSize params.
+     * Enforces min/max boundaries from the config.
+     */
+    buildPagination(config, page, pageSize) {
+        const pCfg = config.pagination;
+        const enabled = pCfg?.enabled ?? true;
+        if (!enabled) {
+            return {
+                limit: Number.MAX_SAFE_INTEGER,
+                offset: 0,
+                page: 1,
+                pageSize: Number.MAX_SAFE_INTEGER,
+            };
+        }
+        const defaultSize = pCfg?.defaultPageSize ?? 10;
+        const maxSize = pCfg?.maxPageSize ?? 100;
+        const resolvedPage = Math.max(1, Math.floor(page ?? 1));
+        const resolvedSize = Math.min(maxSize, Math.max(1, Math.floor(pageSize ?? defaultSize)));
+        return {
+            limit: resolvedSize,
+            offset: (resolvedPage - 1) * resolvedSize,
+            page: resolvedPage,
+            pageSize: resolvedSize,
+        };
+    }
+    /**
+     * Produces pagination metadata from the total row count.
+     */
+    buildMeta(total, pagination) {
+        return {
+            total,
+            page: pagination.page,
+            pageSize: pagination.pageSize,
+            totalPages: pagination.pageSize > 0
+                ? Math.ceil(total / pagination.pageSize)
+                : 0,
+        };
+    }
+}
+//# sourceMappingURL=paginationBuilder.js.map

package/dist/src/core/paginationBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginationBuilder.js","sourceRoot":"","sources":["../../../src/core/paginationBuilder.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,iBAAiB;IAC5B;;;OAGG;IACH,eAAe,CACb,MAAmB,EACnB,IAAa,EACb,QAAiB;QAEjB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC;QAEtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,gBAAgB;gBAC9B,MAAM,EAAE,CAAC;gBACT,IAAI,EAAE,CAAC;gBACP,QAAQ,EAAE,MAAM,CAAC,gBAAgB;aAClC,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,EAAE,eAAe,IAAI,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,EAAE,WAAW,IAAI,GAAG,CAAC;QAEzC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;QAEzF,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,YAAY;YACzC,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,YAAY;SACvB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAa,EAAE,UAA4B;QACnD,OAAO;YACL,KAAK;YACL,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,UAAU,EAAE,UAAU,CAAC,QAAQ,GAAG,CAAC;gBACjC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC;gBACxC,CAAC,CAAC,CAAC;SACN,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/queryBuilder.d.ts

@@ -0,0 +1,20 @@
+import { Table, Column, SQL } from 'drizzle-orm';
+import { TableConfig } from '../types/table';
+export declare class QueryBuilder {
+    private schema;
+    constructor(schema: Record<string, unknown>);
+    buildSelect(table: Table, config: TableConfig): Record<string, SQL | Column>;
+    private collectJoinColumns;
+    /**
+     * Applies joins. Accepts optional SQL conditions map for type-safe joins.
+     * If a SQL condition exists for a join's table/alias, it's used instead of the raw string.
+     */
+    buildJoins(query: any, config: TableConfig, sqlConditions?: Map<string, SQL>): any;
+    /**
+     * Applies raw SQL join clauses (LATERAL JOIN, etc.)
+     */
+    applyRawJoins(query: any): any;
+    private applyJoin;
+    buildBackendConditions(config: TableConfig, context?: Record<string, any>): SQL | undefined;
+}
+//# sourceMappingURL=queryBuilder.d.ts.map

package/dist/src/core/queryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/queryBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,MAAM,EACN,GAAG,EAIJ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAc,MAAM,gBAAgB,CAAC;AAGzD,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnD,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC;IAuD5E,OAAO,CAAC,kBAAkB;IAwB1B;;;OAGG;IACH,UAAU,CACR,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,WAAW,EACnB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAC/B,GAAG;IASN;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;IAO9B,OAAO,CAAC,SAAS;IA4BjB,sBAAsB,CACpB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAChC,GAAG,GAAG,SAAS;CAoCnB"}

package/dist/src/core/queryBuilder.js

@@ -0,0 +1,163 @@
+import { sql, getTableColumns, and, } from 'drizzle-orm';
+import { applyOperator } from '../utils/operators';
+export class QueryBuilder {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    buildSelect(table, config) {
+        const selection = {};
+        const columns = getTableColumns(table);
+        for (const colConfig of config.columns) {
+            if (colConfig.hidden)
+                continue;
+            // Skip computed columns (they are added by the engine)
+            if (colConfig.computed)
+                continue;
+            const dbField = colConfig.field ?? colConfig.name;
+            let col;
+            if (dbField.includes('.')) {
+                // Joined column: "table.column"
+                const [tableName, colName] = dbField.split('.');
+                const joinedTable = this.schema[tableName];
+                if (joinedTable) {
+                    const joinedCols = getTableColumns(joinedTable);
+                    col = joinedCols[colName];
+                    if (!col) {
+                        // console.warn(`[QueryBuilder] Column '${colName}' not found in joined table '${tableName}'`);
+                    }
+                }
+                else {
+                    // console.warn(`[QueryBuilder] Joined table '${tableName}' not found in schema`);
+                }
+            }
+            else {
+                // Base table column
+                col = columns[dbField];
+            }
+            if (!col)
+                continue;
+            if (colConfig.dbTransform && colConfig.dbTransform.length > 0) {
+                // Apply SQL transforms (only works if col is a Column object with name)
+                const colName = col.name;
+                // TODO: This might break if col is already SQL or alias, but for now we assume Column
+                if (colName) {
+                    let expressionStr = colConfig.dbTransform.reduce((acc, func) => `${func}(${acc})`, '?');
+                    selection[colConfig.name] = sql.raw(expressionStr.replace('?', colName));
+                }
+                else {
+                    selection[colConfig.name] = col;
+                }
+            }
+            else {
+                selection[colConfig.name] = col;
+            }
+        }
+        // Collect columns from joins
+        if (config.joins) {
+            this.collectJoinColumns(config.joins, selection);
+        }
+        return selection;
+    }
+    collectJoinColumns(joins, selection) {
+        for (const join of joins) {
+            if (join.columns) {
+                const joinedTable = this.schema[join.table];
+                if (joinedTable) {
+                    const tableCols = getTableColumns(joinedTable);
+                    for (const colConfig of join.columns) {
+                        if (colConfig.hidden)
+                            continue;
+                        const colName = colConfig.field ?? colConfig.name;
+                        const col = tableCols[colName];
+                        if (col) {
+                            // TODO: Handle name collisions?
+                            selection[colConfig.name] = col;
+                        }
+                    }
+                }
+            }
+            if (join.joins) {
+                this.collectJoinColumns(join.joins, selection);
+            }
+        }
+    }
+    /**
+     * Applies joins. Accepts optional SQL conditions map for type-safe joins.
+     * If a SQL condition exists for a join's table/alias, it's used instead of the raw string.
+     */
+    buildJoins(query, config, sqlConditions) {
+        if (!config.joins)
+            return query;
+        for (const join of config.joins) {
+            this.applyJoin(query, join, sqlConditions);
+        }
+        return query;
+    }
+    /**
+     * Applies raw SQL join clauses (LATERAL JOIN, etc.)
+     */
+    applyRawJoins(query) {
+        // Raw joins are appended via sql template
+        // Drizzle doesn't have a direct method, so we use a workaround
+        // The caller should apply these at the db.execute level if needed
+        return query;
+    }
+    applyJoin(query, join, sqlConditions) {
+        const joinedTable = this.schema[join.table];
+        if (!joinedTable) {
+            throw new Error(`Joined table '${join.table}' not found in schema`);
+        }
+        // Use SQL object if available, otherwise fall back to raw string
+        const key = join.alias ?? join.table;
+        const onCondition = sqlConditions?.get(key) ?? sql.raw(join.on);
+        switch (join.type) {
+            case 'left':
+                query.leftJoin(joinedTable, onCondition);
+                break;
+            case 'right':
+                query.rightJoin(joinedTable, onCondition);
+                break;
+            case 'inner':
+                query.innerJoin(joinedTable, onCondition);
+                break;
+            case 'full':
+                query.fullJoin(joinedTable, onCondition);
+                break;
+        }
+        if (join.joins) {
+            for (const nested of join.joins) {
+                this.applyJoin(query, nested, sqlConditions);
+            }
+        }
+    }
+    buildBackendConditions(config, context = {}) {
+        if (!config.backendConditions || config.backendConditions.length === 0) {
+            return undefined;
+        }
+        const table = this.schema[config.base];
+        const columns = getTableColumns(table);
+        const conditions = [];
+        for (const condition of config.backendConditions) {
+            const col = columns[condition.field];
+            if (!col)
+                continue;
+            let value = condition.value;
+            if (typeof value === 'string' && value.startsWith('$')) {
+                const contextKey = value.substring(1);
+                value = contextKey
+                    .split('.')
+                    .reduce((obj, k) => obj?.[k], context);
+                if (value === undefined) {
+                    console.warn(`[tablecraft] Context key '${contextKey}' missing.`);
+                    value = null;
+                }
+            }
+            const op = applyOperator(condition.operator, col, value);
+            if (op)
+                conditions.push(op);
+        }
+        return conditions.length > 0 ? and(...conditions) : undefined;
+    }
+}
+//# sourceMappingURL=queryBuilder.js.map

package/dist/src/core/queryBuilder.js.map

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

package/dist/src/core/recursiveBuilder.d.ts

@@ -0,0 +1,25 @@
+import { SQL } from 'drizzle-orm';
+import { TableConfig } from '../types/table';
+export declare class RecursiveBuilder {
+    private schema;
+    constructor(schema: Record<string, unknown>);
+    /**
+     * Builds and executes a WITH RECURSIVE query for tree-structured data.
+     *
+     * Generates:
+     * WITH RECURSIVE tree AS (
+     *   SELECT *, 0 AS depth FROM table WHERE parentKey IS NULL
+     *   UNION ALL
+     *   SELECT c.*, t.depth + 1 FROM table c
+     *   INNER JOIN tree t ON c.parentKey = t.childKey
+     *   WHERE t.depth < maxDepth
+     * )
+     * SELECT * FROM tree ORDER BY depth, childKey
+     */
+    buildRecursiveSQL(config: TableConfig): SQL | undefined;
+    /**
+     * Executes the recursive query and returns results.
+     */
+    execute(db: any, config: TableConfig): Promise<Record<string, unknown>[]>;
+}
+//# sourceMappingURL=recursiveBuilder.d.ts.map

package/dist/src/core/recursiveBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recursiveBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/recursiveBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,GAAG,EAIJ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnD;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,GAAG,SAAS;IAmDvD;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAYhF"}

package/dist/src/core/recursiveBuilder.js

@@ -0,0 +1,86 @@
+import { sql, getTableColumns, getTableName, } from 'drizzle-orm';
+import { applyOperator } from '../utils/operators';
+export class RecursiveBuilder {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    /**
+     * Builds and executes a WITH RECURSIVE query for tree-structured data.
+     *
+     * Generates:
+     * WITH RECURSIVE tree AS (
+     *   SELECT *, 0 AS depth FROM table WHERE parentKey IS NULL
+     *   UNION ALL
+     *   SELECT c.*, t.depth + 1 FROM table c
+     *   INNER JOIN tree t ON c.parentKey = t.childKey
+     *   WHERE t.depth < maxDepth
+     * )
+     * SELECT * FROM tree ORDER BY depth, childKey
+     */
+    buildRecursiveSQL(config) {
+        if (!config.recursive)
+            return undefined;
+        const table = this.schema[config.base];
+        if (!table)
+            return undefined;
+        const tableName = getTableName(table);
+        const { parentKey, childKey, maxDepth, depthAlias, pathAlias, startWith } = config.recursive;
+        // Base case: root nodes
+        let baseCondition;
+        if (startWith) {
+            const columns = getTableColumns(table);
+            const col = columns[startWith.field];
+            if (col) {
+                const op = applyOperator(startWith.operator, col, startWith.value);
+                baseCondition = op ?? sql `${sql.identifier(parentKey)} IS NULL`;
+            }
+            else {
+                baseCondition = sql `${sql.identifier(parentKey)} IS NULL`;
+            }
+        }
+        else {
+            baseCondition = sql `${sql.identifier(parentKey)} IS NULL`;
+        }
+        // Path tracking
+        const pathSelect = pathAlias
+            ? sql `, CAST(${sql.identifier(childKey)} AS TEXT) AS ${sql.identifier(pathAlias)}`
+            : sql ``;
+        const pathRecurse = pathAlias
+            ? sql `, t.${sql.identifier(pathAlias)} || '/' || CAST(c.${sql.identifier(childKey)} AS TEXT) AS ${sql.identifier(pathAlias)}`
+            : sql ``;
+        const recursiveSql = sql `
+      WITH RECURSIVE tree AS (
+        SELECT *, 0 AS ${sql.identifier(depthAlias)}${pathSelect}
+        FROM ${sql.identifier(tableName)}
+        WHERE ${baseCondition}
+
+        UNION ALL
+
+        SELECT c.*, t.${sql.identifier(depthAlias)} + 1${pathRecurse}
+        FROM ${sql.identifier(tableName)} c
+        INNER JOIN tree t ON c.${sql.identifier(parentKey)} = t.${sql.identifier(childKey)}
+        WHERE t.${sql.identifier(depthAlias)} < ${maxDepth}
+      )
+      SELECT * FROM tree ORDER BY ${sql.identifier(depthAlias)}, ${sql.identifier(childKey)}
+    `;
+        return recursiveSql;
+    }
+    /**
+     * Executes the recursive query and returns results.
+     */
+    async execute(db, config) {
+        const query = this.buildRecursiveSQL(config);
+        if (!query)
+            return [];
+        const result = await db.execute(query);
+        // db.execute returns different shapes per driver
+        // rows is typically result.rows or just result
+        if (Array.isArray(result))
+            return result;
+        if (result?.rows && Array.isArray(result.rows))
+            return result.rows;
+        return [];
+    }
+}
+//# sourceMappingURL=recursiveBuilder.js.map

package/dist/src/core/recursiveBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recursiveBuilder.js","sourceRoot":"","sources":["../../../src/core/recursiveBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,GAAG,EACH,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,MAA+B;QAA/B,WAAM,GAAN,MAAM,CAAyB;IAAG,CAAC;IAEvD;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,MAAmB;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAExC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAU,CAAC;QAChD,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC;QAE7F,wBAAwB;QACxB,IAAI,aAAkB,CAAC;QACvB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,EAAE,GAAG,aAAa,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;gBACnE,aAAa,GAAG,EAAE,IAAI,GAAG,CAAA,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,GAAG,CAAA,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;YAC5D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,GAAG,CAAA,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;QAC5D,CAAC;QAED,gBAAgB;QAChB,MAAM,UAAU,GAAG,SAAS;YAC1B,CAAC,CAAC,GAAG,CAAA,UAAU,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,gBAAgB,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;YAClF,CAAC,CAAC,GAAG,CAAA,EAAE,CAAC;QACV,MAAM,WAAW,GAAG,SAAS;YAC3B,CAAC,CAAC,GAAG,CAAA,OAAO,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,qBAAqB,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,gBAAgB,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;YAC7H,CAAC,CAAC,GAAG,CAAA,EAAE,CAAC;QAEV,MAAM,YAAY,GAAG,GAAG,CAAA;;yBAEH,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,UAAU;eACjD,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;gBACxB,aAAa;;;;wBAIL,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,WAAW;eACrD,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;iCACP,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;kBACxE,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,QAAQ;;oCAEtB,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;KACtF,CAAC;QAEF,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAO,EAAE,MAAmB;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEvC,iDAAiD;QACjD,+CAA+C;QAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACzC,IAAI,MAAM,EAAE,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QACnE,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/src/core/relationBuilder.d.ts

@@ -0,0 +1,19 @@
+import { TableConfig } from '../types/table';
+export declare class RelationBuilder {
+    private schema;
+    constructor(schema: Record<string, unknown>);
+    /**
+     * Fetches related records and merges them into the parent data.
+     * Uses batch loading (1 query per include level, not per row).
+     *
+     * Flow:
+     * 1. Collect parent IDs from the main result
+     * 2. SELECT * FROM related WHERE foreignKey IN (parentIds)
+     * 3. Group by foreignKey
+     * 4. Merge into parent rows under the `as` key
+     * 5. Recurse for nested includes
+     */
+    resolve(db: any, data: Record<string, unknown>[], config: TableConfig): Promise<Record<string, unknown>[]>;
+    private resolveOne;
+}
+//# sourceMappingURL=relationBuilder.d.ts.map

package/dist/src/core/relationBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/relationBuilder.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG5D,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnD;;;;;;;;;;OAUG;IACG,OAAO,CACX,EAAE,EAAE,GAAG,EACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YAYvB,UAAU;CAkGzB"}

package/dist/src/core/relationBuilder.js

@@ -0,0 +1,118 @@
+import { getTableColumns, inArray, asc, desc, } from 'drizzle-orm';
+import { applyOperator } from '../utils/operators';
+export class RelationBuilder {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    /**
+     * Fetches related records and merges them into the parent data.
+     * Uses batch loading (1 query per include level, not per row).
+     *
+     * Flow:
+     * 1. Collect parent IDs from the main result
+     * 2. SELECT * FROM related WHERE foreignKey IN (parentIds)
+     * 3. Group by foreignKey
+     * 4. Merge into parent rows under the `as` key
+     * 5. Recurse for nested includes
+     */
+    async resolve(db, data, config) {
+        if (!config.include?.length || data.length === 0)
+            return data;
+        let result = [...data];
+        for (const inc of config.include) {
+            result = await this.resolveOne(db, result, inc);
+        }
+        return result;
+    }
+    async resolveOne(db, parentData, inc) {
+        const relatedTable = this.schema[inc.table];
+        if (!relatedTable)
+            return parentData;
+        const localKey = inc.localKey ?? 'id';
+        // 1. Collect parent IDs
+        const parentIds = [
+            ...new Set(parentData
+                .map((row) => row[localKey])
+                .filter((id) => id !== null && id !== undefined)),
+        ];
+        if (parentIds.length === 0)
+            return parentData;
+        // 2. Build the related query
+        const relatedColumns = getTableColumns(relatedTable);
+        const fkColumn = relatedColumns[inc.foreignKey];
+        if (!fkColumn)
+            return parentData;
+        // Build selection (specific columns or all)
+        let selection;
+        if (inc.columns?.length) {
+            selection = {};
+            for (const colName of inc.columns) {
+                if (relatedColumns[colName])
+                    selection[colName] = relatedColumns[colName];
+            }
+            // Always include the foreign key for grouping
+            if (!selection[inc.foreignKey]) {
+                selection[inc.foreignKey] = fkColumn;
+            }
+        }
+        else {
+            selection = { ...relatedColumns };
+        }
+        let query = db.select(selection).from(relatedTable).where(inArray(fkColumn, parentIds));
+        // Apply WHERE conditions
+        if (inc.where?.length) {
+            for (const cond of inc.where) {
+                const col = relatedColumns[cond.field];
+                if (!col)
+                    continue;
+                const op = applyOperator(cond.operator, col, cond.value);
+                if (op)
+                    query = query.where(op);
+            }
+        }
+        // Apply ORDER BY
+        if (inc.orderBy?.length) {
+            const orderClauses = [];
+            for (const s of inc.orderBy) {
+                const col = relatedColumns[s.field];
+                if (!col)
+                    continue;
+                orderClauses.push(s.order === 'desc' ? desc(col) : asc(col));
+            }
+            if (orderClauses.length)
+                query = query.orderBy(...orderClauses);
+        }
+        // Apply LIMIT (per-parent limiting is complex; this is global limit)
+        if (inc.limit) {
+            query = query.limit(inc.limit * parentIds.length);
+        }
+        // 3. Execute
+        const relatedRows = await query;
+        // 4. Recursively resolve nested includes
+        let processedRows = relatedRows;
+        if (inc.include?.length) {
+            const nestedConfig = {
+                name: inc.table,
+                base: inc.table,
+                columns: [],
+                include: inc.include,
+            };
+            processedRows = await this.resolve(db, relatedRows, nestedConfig);
+        }
+        // 5. Group by foreign key
+        const grouped = new Map();
+        for (const row of processedRows) {
+            const fkValue = row[inc.foreignKey];
+            if (!grouped.has(fkValue))
+                grouped.set(fkValue, []);
+            grouped.get(fkValue).push(row);
+        }
+        // 6. Merge into parent
+        return parentData.map((parent) => ({
+            ...parent,
+            [inc.as]: grouped.get(parent[localKey]) ?? [],
+        }));
+    }
+}
+//# sourceMappingURL=relationBuilder.js.map

package/dist/src/core/relationBuilder.js.map

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

package/dist/src/core/roleFilter.d.ts

@@ -0,0 +1,11 @@
+import { TableConfig } from '../types/table';
+import { EngineContext } from '../types/engine';
+/**
+ * Filters columns based on the requesting user's roles.
+ * Columns with `visibleTo` are only shown to users with matching roles.
+ * Columns without `visibleTo` are visible to everyone.
+ *
+ * Returns a new config with hidden columns updated.
+ */
+export declare function applyRoleBasedVisibility(config: TableConfig, context: EngineContext): TableConfig;
+//# sourceMappingURL=roleFilter.d.ts.map

package/dist/src/core/roleFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roleFilter.d.ts","sourceRoot":"","sources":["../../../src/core/roleFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,GACrB,WAAW,CAmBb"}

package/dist/src/core/roleFilter.js

@@ -0,0 +1,24 @@
+/**
+ * Filters columns based on the requesting user's roles.
+ * Columns with `visibleTo` are only shown to users with matching roles.
+ * Columns without `visibleTo` are visible to everyone.
+ *
+ * Returns a new config with hidden columns updated.
+ */
+export function applyRoleBasedVisibility(config, context) {
+    const userRoles = context.user?.roles ?? [];
+    const columns = config.columns.map((col) => {
+        const visibleTo = col.visibleTo;
+        // No restriction — keep as-is
+        if (!visibleTo || visibleTo.length === 0)
+            return col;
+        // Check if user has any of the required roles
+        const canSee = userRoles.some((role) => visibleTo.includes(role));
+        if (canSee)
+            return col;
+        // User can't see this column — mark as hidden
+        return { ...col, hidden: true };
+    });
+    return { ...config, columns };
+}
+//# sourceMappingURL=roleFilter.js.map

package/dist/src/core/roleFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roleFilter.js","sourceRoot":"","sources":["../../../src/core/roleFilter.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAmB,EACnB,OAAsB;IAEtB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IAE5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACzC,MAAM,SAAS,GAAI,GAAW,CAAC,SAAiC,CAAC;QAEjE,8BAA8B;QAC9B,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAErD,8CAA8C;QAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAElE,IAAI,MAAM;YAAE,OAAO,GAAG,CAAC;QAEvB,8CAA8C;QAC9C,OAAO,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC"}

package/dist/src/core/searchBuilder.d.ts

@@ -0,0 +1,17 @@
+import { SQL } from 'drizzle-orm';
+import { TableConfig } from '../types/table';
+export declare class SearchBuilder {
+    private schema;
+    constructor(schema: Record<string, unknown>);
+    /**
+     * Builds a search condition across multiple columns using OR + ILIKE.
+     */
+    buildSearch(config: TableConfig, searchTerm: string): SQL | undefined;
+    /**
+     * Builds a PostgreSQL full-text search condition (tsvector/tsquery).
+     * This is an optional enhanced mode — only works on PostgreSQL.
+     */
+    buildFullTextSearch(config: TableConfig, searchTerm: string, language?: string): SQL | undefined;
+    private resolveColumn;
+}
+//# sourceMappingURL=searchBuilder.d.ts.map

package/dist/src/core/searchBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/searchBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,GAAG,EAMJ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnD;;OAEG;IACH,WAAW,CACT,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,GAAG,GAAG,SAAS;IAkClB;;;OAGG;IACH,mBAAmB,CACjB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAkB,GAC3B,GAAG,GAAG,SAAS;IAgBlB,OAAO,CAAC,aAAa;CAiBtB"}