@tablecraft/engine 0.1.0-beta.1

package/dist/src/core/cursorPagination.js

@@ -0,0 +1,88 @@
+import { sql, getTableColumns, gt, lt, asc, desc } from 'drizzle-orm';
+/**
+ * Cursor-based pagination.
+ * Uses the sort column value as the cursor instead of OFFSET.
+ * O(1) performance regardless of page depth.
+ *
+ * Cursor format: base64({ field: value, field2: value2 })
+ */
+export class CursorPaginationBuilder {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    /**
+     * Decodes a cursor string and builds WHERE + ORDER BY for the next page.
+     */
+    build(config, cursor, pageSize, sort) {
+        const table = this.schema[config.base];
+        if (!table) {
+            return { whereCondition: undefined, orderBy: [], limit: pageSize + 1 };
+        }
+        const columns = getTableColumns(table);
+        // Determine sort fields (default to id or createdAt)
+        const sortFields = sort?.length
+            ? sort
+            : config.defaultSort?.length
+                ? config.defaultSort
+                : [{ field: 'id', order: 'asc' }];
+        // Build ORDER BY
+        const orderBy = sortFields.map((s) => {
+            const col = columns[s.field];
+            if (!col)
+                return s.order === 'desc' ? desc(sql.identifier(s.field)) : asc(sql.identifier(s.field));
+            return s.order === 'desc' ? desc(col) : asc(col);
+        });
+        // Decode cursor and build WHERE
+        let whereCondition;
+        if (cursor) {
+            const decoded = decodeCursor(cursor);
+            if (decoded && sortFields.length > 0) {
+                const primary = sortFields[0];
+                const col = columns[primary.field];
+                if (col && decoded[primary.field] !== undefined) {
+                    whereCondition = primary.order === 'desc'
+                        ? lt(col, decoded[primary.field])
+                        : gt(col, decoded[primary.field]);
+                }
+            }
+        }
+        // Fetch one extra row to determine if there's a next page
+        return {
+            whereCondition,
+            orderBy,
+            limit: pageSize + 1,
+        };
+    }
+    /**
+     * From the fetched data (with 1 extra row), determine next cursor.
+     */
+    buildMeta(data, pageSize, sort) {
+        const hasMore = data.length > pageSize;
+        const trimmed = hasMore ? data.slice(0, pageSize) : data;
+        let nextCursor = null;
+        if (hasMore && trimmed.length > 0) {
+            const lastRow = trimmed[trimmed.length - 1];
+            const sortField = sort?.[0]?.field ?? 'id';
+            nextCursor = encodeCursor({ [sortField]: lastRow[sortField] });
+        }
+        return {
+            data: trimmed,
+            meta: { nextCursor, pageSize },
+        };
+    }
+}
+// ── Cursor encoding ──
+export function encodeCursor(values) {
+    return Buffer.from(JSON.stringify(values)).toString('base64url');
+}
+export function decodeCursor(cursor) {
+    try {
+        const json = Buffer.from(cursor, 'base64url').toString('utf-8');
+        return JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=cursorPagination.js.map

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

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

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

@@ -0,0 +1,19 @@
+import { Column, SQL } from 'drizzle-orm';
+import { DatePreset } from '../types/table';
+/**
+ * Resolves a date preset name into a concrete date range.
+ * All dates are in UTC.
+ */
+export declare function resolveDatePreset(preset: DatePreset): {
+    start: Date;
+    end: Date;
+} | undefined;
+/**
+ * Builds a SQL WHERE condition from a date preset.
+ */
+export declare function buildDatePresetCondition(column: Column, preset: DatePreset): SQL | undefined;
+/**
+ * Checks if a filter value is a date preset name.
+ */
+export declare function isDatePreset(value: unknown): value is DatePreset;
+//# sourceMappingURL=datePresets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datePresets.d.ts","sourceRoot":"","sources":["../../../src/core/datePresets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAgB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAAG,SAAS,CA+D5F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,GACjB,GAAG,GAAG,SAAS,CAQjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAOhE"}

package/dist/src/core/datePresets.js

@@ -0,0 +1,96 @@
+import { and, gte, lt } from 'drizzle-orm';
+/**
+ * Resolves a date preset name into a concrete date range.
+ * All dates are in UTC.
+ */
+export function resolveDatePreset(preset) {
+    const now = new Date();
+    const today = startOfDay(now);
+    const tomorrow = addDays(today, 1);
+    switch (preset) {
+        case 'today':
+            return { start: today, end: tomorrow };
+        case 'yesterday':
+            return { start: addDays(today, -1), end: today };
+        case 'last7days':
+            return { start: addDays(today, -7), end: tomorrow };
+        case 'last30days':
+            return { start: addDays(today, -30), end: tomorrow };
+        case 'last90days':
+            return { start: addDays(today, -90), end: tomorrow };
+        case 'thisWeek':
+            return { start: startOfWeek(today), end: tomorrow };
+        case 'lastWeek': {
+            const thisWeekStart = startOfWeek(today);
+            return { start: addDays(thisWeekStart, -7), end: thisWeekStart };
+        }
+        case 'thisMonth':
+            return { start: startOfMonth(today), end: tomorrow };
+        case 'lastMonth': {
+            const thisMonthStart = startOfMonth(today);
+            const lastMonthStart = new Date(thisMonthStart);
+            lastMonthStart.setMonth(lastMonthStart.getMonth() - 1);
+            return { start: lastMonthStart, end: thisMonthStart };
+        }
+        case 'thisQuarter':
+            return { start: startOfQuarter(today), end: tomorrow };
+        case 'lastQuarter': {
+            const thisQ = startOfQuarter(today);
+            const lastQ = new Date(thisQ);
+            lastQ.setMonth(lastQ.getMonth() - 3);
+            return { start: lastQ, end: thisQ };
+        }
+        case 'thisYear':
+            return { start: new Date(Date.UTC(today.getUTCFullYear(), 0, 1)), end: tomorrow };
+        case 'lastYear': {
+            const year = today.getUTCFullYear();
+            return { start: new Date(Date.UTC(year - 1, 0, 1)), end: new Date(Date.UTC(year, 0, 1)) };
+        }
+        case 'custom':
+            return undefined;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Builds a SQL WHERE condition from a date preset.
+ */
+export function buildDatePresetCondition(column, preset) {
+    const range = resolveDatePreset(preset);
+    if (!range)
+        return undefined;
+    return and(gte(column, range.start), lt(column, range.end));
+}
+/**
+ * Checks if a filter value is a date preset name.
+ */
+export function isDatePreset(value) {
+    const presets = new Set([
+        'today', 'yesterday', 'last7days', 'last30days', 'last90days',
+        'thisWeek', 'lastWeek', 'thisMonth', 'lastMonth',
+        'thisQuarter', 'lastQuarter', 'thisYear', 'lastYear', 'custom',
+    ]);
+    return typeof value === 'string' && presets.has(value);
+}
+// ── Date helpers (no dependencies) ──
+function startOfDay(d) {
+    return new Date(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()));
+}
+function addDays(d, n) {
+    const result = new Date(d);
+    result.setUTCDate(result.getUTCDate() + n);
+    return result;
+}
+function startOfWeek(d) {
+    const day = d.getUTCDay();
+    const diff = day === 0 ? 6 : day - 1; // Monday = start
+    return addDays(startOfDay(d), -diff);
+}
+function startOfMonth(d) {
+    return new Date(Date.UTC(d.getFullYear(), d.getMonth(), 1));
+}
+function startOfQuarter(d) {
+    const q = Math.floor(d.getMonth() / 3) * 3;
+    return new Date(Date.UTC(d.getFullYear(), q, 1));
+}
+//# sourceMappingURL=datePresets.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Database dialect detection and feature gating.
+ * Prevents PostgreSQL-only features from silently failing on MySQL/SQLite.
+ */
+export type Dialect = 'postgresql' | 'mysql' | 'sqlite' | 'unknown';
+/**
+ * Auto-detect dialect from a Drizzle database instance.
+ */
+export declare function detectDialect(db: any): Dialect;
+export declare function supportsFeature(dialect: Dialect, feature: string): boolean;
+/**
+ * Returns LIKE or ILIKE based on dialect.
+ * MySQL/SQLite: LIKE is case-insensitive by default.
+ * PostgreSQL: needs ILIKE for case-insensitive.
+ */
+export declare function getCaseInsensitiveLike(dialect: Dialect): 'like' | 'ilike';
+//# sourceMappingURL=dialect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../../../src/core/dialect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpE;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAuB9C;AAeD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK1E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAEzE"}

package/dist/src/core/dialect.js

@@ -0,0 +1,60 @@
+/**
+ * Database dialect detection and feature gating.
+ * Prevents PostgreSQL-only features from silently failing on MySQL/SQLite.
+ */
+/**
+ * Auto-detect dialect from a Drizzle database instance.
+ */
+export function detectDialect(db) {
+    // Drizzle instances have internal markers we can check
+    const constructor = db?.constructor?.name?.toLowerCase() ?? '';
+    if (constructor.includes('pg') || constructor.includes('postgres') || constructor.includes('neon')) {
+        return 'postgresql';
+    }
+    if (constructor.includes('mysql') || constructor.includes('planetscale')) {
+        return 'mysql';
+    }
+    if (constructor.includes('sqlite') || constructor.includes('libsql') || constructor.includes('turso') || constructor.includes('d1')) {
+        return 'sqlite';
+    }
+    // Check for dialect property that some Drizzle instances expose
+    if (db?.dialect?.name) {
+        const name = db.dialect.name.toLowerCase();
+        if (name.includes('pg'))
+            return 'postgresql';
+        if (name.includes('mysql'))
+            return 'mysql';
+        if (name.includes('sqlite'))
+            return 'sqlite';
+    }
+    return 'unknown';
+}
+/**
+ * Feature support matrix per dialect.
+ */
+const FEATURES = {
+    ilike: new Set(['postgresql']),
+    fullTextSearch: new Set(['postgresql']),
+    recursiveCTE: new Set(['postgresql', 'sqlite']),
+    returning: new Set(['postgresql', 'sqlite']),
+    lateral: new Set(['postgresql']),
+    distinct: new Set(['postgresql', 'mysql', 'sqlite']),
+    estimatedCount: new Set(['postgresql']),
+};
+export function supportsFeature(dialect, feature) {
+    const supported = FEATURES[feature];
+    if (!supported)
+        return true; // unknown features assumed supported
+    if (dialect === 'unknown')
+        return true; // don't block unknown dialects
+    return supported.has(dialect);
+}
+/**
+ * Returns LIKE or ILIKE based on dialect.
+ * MySQL/SQLite: LIKE is case-insensitive by default.
+ * PostgreSQL: needs ILIKE for case-insensitive.
+ */
+export function getCaseInsensitiveLike(dialect) {
+    return dialect === 'postgresql' ? 'ilike' : 'like';
+}
+//# sourceMappingURL=dialect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.js","sourceRoot":"","sources":["../../../src/core/dialect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAO;IACnC,uDAAuD;IACvD,MAAM,WAAW,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAE/D,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnG,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACzE,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpI,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gEAAgE;IAChE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,YAAY,CAAC;QAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC/C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,QAAQ,GAAiC;IAC7C,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAC9B,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IACvC,YAAY,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC/C,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAChC,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpD,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,OAAe;IAC/D,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC,CAAC,qCAAqC;IAClE,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,CAAC,+BAA+B;IACvE,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,19 @@
+import { Column, SQL } from 'drizzle-orm';
+import { TableConfig } from '../types/table';
+/**
+ * Filters the selection to only include requested fields.
+ * Supports `?select=id,name,email` from URL.
+ */
+export declare class FieldSelector {
+    /**
+     * Narrows down a selection object to only include the requested fields.
+     * If no fields requested, returns the original selection.
+     */
+    applyFieldSelection(selection: Record<string, SQL | Column>, requestedFields: string[] | undefined, config: TableConfig): Record<string, SQL | Column>;
+    /**
+     * Filters the response data to only include requested fields.
+     * Defense-in-depth — even if SELECT returns extra columns.
+     */
+    filterResponseFields(data: Record<string, unknown>[], requestedFields: string[] | undefined): Record<string, unknown>[];
+}
+//# sourceMappingURL=fieldSelector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fieldSelector.d.ts","sourceRoot":"","sources":["../../../src/core/fieldSelector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;OAGG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC,EACvC,eAAe,EAAE,MAAM,EAAE,GAAG,SAAS,EACrC,MAAM,EAAE,WAAW,GAClB,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC;IA2B/B;;;OAGG;IACH,oBAAoB,CAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,eAAe,EAAE,MAAM,EAAE,GAAG,SAAS,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CAe7B"}

package/dist/src/core/fieldSelector.js

@@ -0,0 +1,49 @@
+/**
+ * Filters the selection to only include requested fields.
+ * Supports `?select=id,name,email` from URL.
+ */
+export class FieldSelector {
+    /**
+     * Narrows down a selection object to only include the requested fields.
+     * If no fields requested, returns the original selection.
+     */
+    applyFieldSelection(selection, requestedFields, config) {
+        if (!requestedFields?.length)
+            return selection;
+        // Build a whitelist of allowed (non-hidden) fields
+        const allowed = new Set(config.columns.filter((c) => !c.hidden).map((c) => c.name));
+        const filtered = {};
+        for (const field of requestedFields) {
+            if (allowed.has(field) && selection[field]) {
+                filtered[field] = selection[field];
+            }
+        }
+        // Always include primary key if it exists (needed for includes/relations)
+        if (selection['id'] && !filtered['id']) {
+            const idCol = config.columns.find((c) => c.name === 'id');
+            if (idCol && !idCol.hidden) {
+                filtered['id'] = selection['id'];
+            }
+        }
+        return Object.keys(filtered).length > 0 ? filtered : selection;
+    }
+    /**
+     * Filters the response data to only include requested fields.
+     * Defense-in-depth — even if SELECT returns extra columns.
+     */
+    filterResponseFields(data, requestedFields) {
+        if (!requestedFields?.length)
+            return data;
+        const fieldSet = new Set(requestedFields);
+        return data.map((row) => {
+            const filtered = {};
+            for (const field of fieldSet) {
+                if (field in row) {
+                    filtered[field] = row[field];
+                }
+            }
+            return filtered;
+        });
+    }
+}
+//# sourceMappingURL=fieldSelector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fieldSelector.js","sourceRoot":"","sources":["../../../src/core/fieldSelector.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,aAAa;IACxB;;;OAGG;IACH,mBAAmB,CACjB,SAAuC,EACvC,eAAqC,EACrC,MAAmB;QAEnB,IAAI,CAAC,eAAe,EAAE,MAAM;YAAE,OAAO,SAAS,CAAC;QAE/C,mDAAmD;QACnD,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAC3D,CAAC;QAEF,MAAM,QAAQ,GAAiC,EAAE,CAAC;QAElD,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,QAAQ,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAC1D,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAClB,IAA+B,EAC/B,eAAqC;QAErC,IAAI,CAAC,eAAe,EAAE,MAAM;YAAE,OAAO,IAAI,CAAC;QAE1C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;QAE1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACtB,MAAM,QAAQ,GAA4B,EAAE,CAAC;YAC7C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;oBACjB,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,22 @@
+import { SQL } from 'drizzle-orm';
+import { TableConfig } from '../types/table';
+import { FilterParam } from '../types/engine';
+export declare class FilterBuilder {
+    private schema;
+    constructor(schema: Record<string, unknown>);
+    /**
+     * Builds dynamic WHERE conditions from user-provided filter params.
+     * Only allows filtering on columns explicitly marked as filterable.
+     */
+    buildFilters(config: TableConfig, params: Record<string, FilterParam>): SQL | undefined;
+    /**
+     * Builds conditions for filters with type='static' (preset values in config).
+     */
+    buildStaticFilters(config: TableConfig): SQL | undefined;
+    /**
+     * Resolves a column reference. Supports "joinedTable.column" dot-syntax
+     * for columns on joined tables.
+     */
+    private resolveColumn;
+}
+//# sourceMappingURL=filterBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filterBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/filterBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,GAAG,EAGJ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9C,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnD;;;OAGG;IACH,YAAY,CACV,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAClC,GAAG,GAAG,SAAS;IAyDlB;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,GAAG,SAAS;IAwBxD;;;OAGG;IACH,OAAO,CAAC,aAAa;CA4BtB"}

package/dist/src/core/filterBuilder.js

@@ -0,0 +1,112 @@
+import { getTableColumns, and, } from 'drizzle-orm';
+import { applyOperator } from '../utils/operators';
+import { isDatePreset, buildDatePresetCondition } from './datePresets';
+export class FilterBuilder {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    /**
+     * Builds dynamic WHERE conditions from user-provided filter params.
+     * Only allows filtering on columns explicitly marked as filterable.
+     */
+    buildFilters(config, params) {
+        if (!params || Object.keys(params).length === 0) {
+            return undefined;
+        }
+        const table = this.schema[config.base];
+        if (!table)
+            return undefined;
+        const columns = getTableColumns(table);
+        // Build a whitelist of filterable field names
+        const filterableFields = new Set();
+        // From explicit dynamic filter definitions
+        if (config.filters) {
+            for (const f of config.filters) {
+                if (f.type !== 'static') {
+                    filterableFields.add(f.field);
+                }
+            }
+        }
+        // From columns marked filterable (default true)
+        for (const col of config.columns) {
+            if (col.filterable !== false) {
+                filterableFields.add(col.name);
+            }
+        }
+        const conditions = [];
+        for (const [field, param] of Object.entries(params)) {
+            // Security: reject fields not in the whitelist
+            if (!filterableFields.has(field))
+                continue;
+            // Find the config for this field to resolve "field" property
+            const colConfig = config.columns.find(c => c.name === field);
+            const dbFieldName = colConfig?.field ?? field;
+            // Resolve the column — could be on the base table or a joined table
+            const col = this.resolveColumn(config, columns, dbFieldName);
+            if (!col)
+                continue;
+            // Check if value is a date preset
+            if (isDatePreset(param.value)) {
+                const presetCondition = buildDatePresetCondition(col, param.value);
+                if (presetCondition)
+                    conditions.push(presetCondition);
+                continue;
+            }
+            const condition = applyOperator(param.operator, col, param.value);
+            if (condition)
+                conditions.push(condition);
+        }
+        return conditions.length > 0 ? and(...conditions) : undefined;
+    }
+    /**
+     * Builds conditions for filters with type='static' (preset values in config).
+     */
+    buildStaticFilters(config) {
+        if (!config.filters)
+            return undefined;
+        const table = this.schema[config.base];
+        if (!table)
+            return undefined;
+        const columns = getTableColumns(table);
+        const conditions = [];
+        for (const filter of config.filters) {
+            if (filter.type !== 'static' || filter.value === undefined)
+                continue;
+            const col = columns[filter.field];
+            if (!col)
+                continue;
+            // Default to 'eq' if not specified (though schema defaults it, z.input might miss it)
+            const op = filter.operator ?? 'eq';
+            const condition = applyOperator(op, col, filter.value);
+            if (condition)
+                conditions.push(condition);
+        }
+        return conditions.length > 0 ? and(...conditions) : undefined;
+    }
+    /**
+     * Resolves a column reference. Supports "joinedTable.column" dot-syntax
+     * for columns on joined tables.
+     */
+    resolveColumn(config, baseColumns, field) {
+        // Direct column on the base table
+        if (baseColumns[field]) {
+            return baseColumns[field];
+        }
+        // Dot-syntax for joined tables: "orders.total"
+        if (field.includes('.')) {
+            const [tableName, colName] = field.split('.');
+            const joinedTable = this.schema[tableName];
+            if (!joinedTable)
+                return undefined;
+            // Verify this table is actually joined
+            const isJoined = config.joins?.some((j) => j.table === tableName || j.alias === tableName);
+            if (!isJoined)
+                return undefined;
+            const joinedCols = getTableColumns(joinedTable);
+            return joinedCols[colName];
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=filterBuilder.js.map

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

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

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

@@ -0,0 +1,28 @@
+import { SQL } from 'drizzle-orm';
+import { FilterExpression, TableConfig } from '../types/table';
+export declare class FilterGroupBuilder {
+    private schema;
+    constructor(schema: Record<string, unknown>);
+    /**
+     * Builds SQL from a filter expression tree.
+     * Supports arbitrary nesting of AND/OR groups.
+     *
+     * Example:
+     * { type: 'or', conditions: [
+     *   { field: 'status', operator: 'eq', value: 'active' },
+     *   { type: 'and', conditions: [
+     *     { field: 'priority', operator: 'eq', value: 'high' },
+     *     { field: 'total', operator: 'gt', value: 1000 },
+     *   ]}
+     * ]}
+     * → (status = 'active' OR (priority = 'high' AND total > 1000))
+     */
+    build(expression: FilterExpression, config: TableConfig): SQL | undefined;
+    /**
+     * Builds SQL from an array of filter expressions (top-level AND).
+     */
+    buildAll(expressions: FilterExpression[], config: TableConfig): SQL | undefined;
+    private resolve;
+    private resolveCondition;
+}
+//# sourceMappingURL=filterGroupBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filterGroupBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/filterGroupBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,GAAG,EAIJ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAmB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGhF,qBAAa,kBAAkB;IACjB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnD;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,GAAG,GAAG,GAAG,SAAS;IAQzE;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,GAAG,GAAG,SAAS;IAc/E,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,gBAAgB;CAQzB"}

package/dist/src/core/filterGroupBuilder.js

@@ -0,0 +1,73 @@
+import { getTableColumns, and, or, } from 'drizzle-orm';
+import { applyOperator } from '../utils/operators';
+export class FilterGroupBuilder {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    /**
+     * Builds SQL from a filter expression tree.
+     * Supports arbitrary nesting of AND/OR groups.
+     *
+     * Example:
+     * { type: 'or', conditions: [
+     *   { field: 'status', operator: 'eq', value: 'active' },
+     *   { type: 'and', conditions: [
+     *     { field: 'priority', operator: 'eq', value: 'high' },
+     *     { field: 'total', operator: 'gt', value: 1000 },
+     *   ]}
+     * ]}
+     * → (status = 'active' OR (priority = 'high' AND total > 1000))
+     */
+    build(expression, config) {
+        const table = this.schema[config.base];
+        if (!table)
+            return undefined;
+        const columns = getTableColumns(table);
+        return this.resolve(expression, columns);
+    }
+    /**
+     * Builds SQL from an array of filter expressions (top-level AND).
+     */
+    buildAll(expressions, config) {
+        if (!expressions.length)
+            return undefined;
+        const parts = [];
+        for (const expr of expressions) {
+            const sql = this.build(expr, config);
+            if (sql)
+                parts.push(sql);
+        }
+        if (parts.length === 0)
+            return undefined;
+        if (parts.length === 1)
+            return parts[0];
+        return and(...parts);
+    }
+    resolve(expr, columns) {
+        // Leaf node: a single condition
+        if ('field' in expr && 'operator' in expr) {
+            return this.resolveCondition(expr, columns);
+        }
+        // Branch node: AND/OR group
+        const group = expr;
+        const parts = [];
+        for (const child of group.conditions) {
+            const childSql = this.resolve(child, columns);
+            if (childSql)
+                parts.push(childSql);
+        }
+        if (parts.length === 0)
+            return undefined;
+        if (parts.length === 1)
+            return parts[0];
+        return group.type === 'or' ? or(...parts) : and(...parts);
+    }
+    resolveCondition(condition, columns) {
+        const col = columns[condition.field];
+        if (!col)
+            return undefined;
+        return applyOperator(condition.operator, col, condition.value);
+    }
+}
+//# sourceMappingURL=filterGroupBuilder.js.map