@tablecraft/engine 0.1.0-beta.1

package/dist/src/utils/introspect.js

@@ -0,0 +1,174 @@
+import { getTableColumns, getTableName, } from 'drizzle-orm';
+/**
+ * Maps a Drizzle column's internal dataType/columnType to our simplified type system.
+ */
+function mapColumnType(column) {
+    const ct = (column.columnType ?? '').toLowerCase();
+    if (ct.includes('uuid'))
+        return 'uuid';
+    if (ct.includes('json'))
+        return 'json';
+    if (ct.includes('bool'))
+        return 'boolean';
+    if (ct.includes('timestamp') || ct.includes('date'))
+        return 'date';
+    if (ct.includes('decimal') || ct.includes('numeric'))
+        return 'number';
+    switch (column.dataType) {
+        case 'number':
+        case 'bigint':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'date':
+            return 'date';
+        case 'json':
+            return 'json';
+        case 'string':
+        default:
+            return 'string';
+    }
+}
+/**
+ * Detects whether a column is likely a text column (useful for auto-search).
+ */
+function isTextColumn(column) {
+    const ct = (column.columnType ?? '').toLowerCase();
+    return (column.dataType === 'string' &&
+        !ct.includes('uuid') &&
+        !ct.includes('enum') &&
+        !ct.includes('decimal') &&
+        !ct.includes('numeric'));
+}
+/**
+ * Column names commonly considered sensitive.
+ * NOT auto-hidden — only used by autoHide() when developer explicitly opts in.
+ */
+const SENSITIVE_COLUMNS = new Set([
+    'password',
+    'passwordHash',
+    'password_hash',
+    'hashedPassword',
+    'hashed_password',
+    'salt',
+    'secret',
+    'token',
+    'refreshToken',
+    'refresh_token',
+]);
+/** Common soft-delete field names */
+const SOFT_DELETE_FIELDS = ['deletedAt', 'deleted_at', 'deletedOn', 'deleted_on'];
+/** Common tenant field names */
+const TENANT_FIELDS = ['tenantId', 'tenant_id', 'orgId', 'org_id', 'organizationId', 'organization_id'];
+/**
+ * Returns the list of column names that look sensitive in this table.
+ * Does NOT hide them — just reports them. Developer decides.
+ */
+export function detectSensitiveColumns(table) {
+    const columns = getTableColumns(table);
+    return Object.keys(columns).filter((name) => SENSITIVE_COLUMNS.has(name));
+}
+/**
+ * Returns the set of sensitive column names (for use by autoHide).
+ */
+export function getSensitiveColumnNames() {
+    return new Set(SENSITIVE_COLUMNS);
+}
+/**
+ * Introspects a Drizzle table and produces a default TableConfig.
+ *
+ * NOTHING is hidden by default. Every column is visible, sortable, filterable.
+ * The developer has full control.
+ */
+export function introspectTable(table) {
+    const tableName = getTableName(table);
+    const columns = getTableColumns(table);
+    const columnConfigs = [];
+    const searchableFields = [];
+    let detectedSoftDelete;
+    let detectedTenant;
+    let defaultSortField;
+    for (const [name, column] of Object.entries(columns)) {
+        const type = mapColumnType(column);
+        const config = {
+            name,
+            type,
+            label: humanise(name),
+            hidden: false, // ← NOTHING hidden by default
+            sortable: true,
+            filterable: true,
+        };
+        columnConfigs.push(config);
+        // Detect searchable text columns (used as default for search config)
+        if (isTextColumn(column)) {
+            searchableFields.push(name);
+        }
+        // Detect soft delete field
+        if (!detectedSoftDelete && SOFT_DELETE_FIELDS.includes(name)) {
+            detectedSoftDelete = name;
+        }
+        // Detect tenant field
+        if (!detectedTenant && TENANT_FIELDS.includes(name)) {
+            detectedTenant = name;
+        }
+        // Detect default sort
+        if (name === 'createdAt' || name === 'created_at') {
+            defaultSortField = name;
+        }
+        else if (!defaultSortField && (name === 'updatedAt' || name === 'updated_at')) {
+            defaultSortField = name;
+        }
+        else if (!defaultSortField && name === 'id') {
+            defaultSortField = name;
+        }
+    }
+    const tableConfig = {
+        name: tableName,
+        base: tableName,
+        columns: columnConfigs,
+        pagination: {
+            defaultPageSize: 10,
+            maxPageSize: 100,
+            enabled: true,
+        },
+    };
+    if (searchableFields.length > 0) {
+        tableConfig.search = {
+            fields: searchableFields.slice(0, 5),
+            enabled: true,
+        };
+    }
+    if (defaultSortField) {
+        tableConfig.defaultSort = [{ field: defaultSortField, order: 'desc' }];
+    }
+    // Detected but NOT enabled — developer opts in
+    if (detectedSoftDelete) {
+        tableConfig.softDelete = {
+            field: detectedSoftDelete,
+            enabled: false, // ← opt-in
+        };
+    }
+    if (detectedTenant) {
+        tableConfig.tenant = {
+            field: detectedTenant,
+            enabled: false, // ← opt-in
+        };
+    }
+    return tableConfig;
+}
+/**
+ * Converts camelCase/snake_case to human-readable label.
+ */
+export function humanise(name) {
+    if (name === 'id')
+        return 'ID';
+    return name
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/_/g, ' ')
+        .replace(/\b\w/g, (c) => c.toUpperCase())
+        .replace(/\bId\b/g, 'ID')
+        .replace(/\bUrl\b/g, 'URL')
+        .replace(/\bApi\b/g, 'API');
+}
+export { isTextColumn, mapColumnType };
+//# sourceMappingURL=introspect.js.map

package/dist/src/utils/introspect.js.map

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

package/dist/src/utils/openapi.d.ts

@@ -0,0 +1,6 @@
+import { TableConfig } from '../types/table';
+/**
+ * Generates an OpenAPI 3.0 spec object from a TableConfig.
+ */
+export declare function generateOpenApiSpec(config: TableConfig): Record<string, unknown>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/src/utils/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/utils/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiIhF"}

package/dist/src/utils/openapi.js

@@ -0,0 +1,138 @@
+/**
+ * Generates an OpenAPI 3.0 spec object from a TableConfig.
+ */
+export function generateOpenApiSpec(config) {
+    const properties = {};
+    for (const col of config.columns) {
+        if (col.hidden)
+            continue;
+        properties[col.name] = {
+            type: mapTypeToOpenApi(col.type),
+            ...(col.label && { description: col.label }),
+        };
+    }
+    const filterParams = [];
+    if (config.filters) {
+        for (const f of config.filters) {
+            if (f.type === 'static')
+                continue;
+            filterParams.push({
+                name: `filter[${f.field}]`,
+                in: 'query',
+                required: false,
+                schema: { type: 'string' },
+                description: f.label ?? `Filter by ${f.field}`,
+            });
+        }
+    }
+    const parameters = [
+        { name: 'page', in: 'query', required: false, schema: { type: 'integer', default: 1 } },
+        {
+            name: 'pageSize',
+            in: 'query',
+            required: false,
+            schema: {
+                type: 'integer',
+                default: config.pagination?.defaultPageSize ?? 10,
+                maximum: config.pagination?.maxPageSize ?? 100,
+            },
+        },
+        { name: 'sort', in: 'query', required: false, schema: { type: 'string' }, description: 'Comma-separated fields. Prefix with - for desc.' },
+        ...filterParams,
+    ];
+    if (config.search?.enabled) {
+        parameters.push({
+            name: 'search',
+            in: 'query',
+            required: false,
+            schema: { type: 'string' },
+            description: `Search across: ${config.search.fields.join(', ')}`,
+        });
+    }
+    if (config.export?.enabled) {
+        parameters.push({
+            name: 'export',
+            in: 'query',
+            required: false,
+            schema: { type: 'string', enum: config.export.formats },
+        });
+    }
+    const spec = {
+        openapi: '3.0.3',
+        info: {
+            title: `${config.name} API`,
+            version: '1.0.0',
+        },
+        paths: {
+            [`/api/${config.name}`]: {
+                get: {
+                    summary: `List ${config.name}`,
+                    operationId: `list${capitalise(config.name)}`,
+                    parameters,
+                    responses: {
+                        '200': {
+                            description: 'Success',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                        properties: {
+                                            data: {
+                                                type: 'array',
+                                                items: {
+                                                    type: 'object',
+                                                    properties,
+                                                },
+                                            },
+                                            meta: {
+                                                type: 'object',
+                                                properties: {
+                                                    total: { type: 'integer' },
+                                                    page: { type: 'integer' },
+                                                    pageSize: { type: 'integer' },
+                                                    totalPages: { type: 'integer' },
+                                                },
+                                            },
+                                            ...(config.aggregations && config.aggregations.length > 0
+                                                ? {
+                                                    aggregations: {
+                                                        type: 'object',
+                                                        properties: Object.fromEntries(config.aggregations.map((a) => [a.alias, { type: 'number' }])),
+                                                    },
+                                                }
+                                                : {}),
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    };
+    if (config.access) {
+        const getSec = spec.paths[`/api/${config.name}`].get;
+        getSec.security = [{ bearerAuth: [] }];
+        spec.components = {
+            securitySchemes: {
+                bearerAuth: { type: 'http', scheme: 'bearer', bearerFormat: 'JWT' },
+            },
+        };
+    }
+    return spec;
+}
+function mapTypeToOpenApi(type) {
+    switch (type) {
+        case 'number': return 'number';
+        case 'boolean': return 'boolean';
+        case 'date': return 'string';
+        case 'json': return 'object';
+        case 'uuid': return 'string';
+        default: return 'string';
+    }
+}
+function capitalise(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=openapi.js.map

package/dist/src/utils/openapi.js.map

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

package/dist/src/utils/operators.d.ts

@@ -0,0 +1,8 @@
+import { Column, SQL } from 'drizzle-orm';
+import { Operator } from '../types/table';
+declare function isDateString(value: unknown): value is string;
+declare function toDbValue(value: unknown, operator?: Operator): unknown;
+export declare function applyOperator(operator: Operator, column: Column, value: unknown): SQL | undefined;
+export declare function escapeLikePattern(value: string): string;
+export { toDbValue, isDateString };
+//# sourceMappingURL=operators.d.ts.map

package/dist/src/utils/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../../src/utils/operators.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,GAAG,EAcJ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,iBAAS,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAGrD;AAID,iBAAS,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAgB/D;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,GAAG,GAAG,SAAS,CAyCjB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC"}

package/dist/src/utils/operators.js

@@ -0,0 +1,70 @@
+import { eq, ne, gt, gte, lt, lte, like, ilike, inArray, notInArray, between, isNull, isNotNull, } from 'drizzle-orm';
+function isDateString(value) {
+    if (typeof value !== 'string')
+        return false;
+    return /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2})?/.test(value);
+}
+const STRING_OPERATORS = ['like', 'ilike', 'contains', 'startsWith', 'endsWith'];
+function toDbValue(value, operator) {
+    if (operator && STRING_OPERATORS.includes(operator)) {
+        return value;
+    }
+    if (isDateString(value)) {
+        return new Date(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map(v => {
+            if (operator && STRING_OPERATORS.includes(operator)) {
+                return v;
+            }
+            return isDateString(v) ? new Date(v) : v;
+        });
+    }
+    return value;
+}
+export function applyOperator(operator, column, value) {
+    const dbValue = toDbValue(value, operator);
+    switch (operator) {
+        case 'eq':
+            return eq(column, dbValue);
+        case 'neq':
+            return ne(column, dbValue);
+        case 'gt':
+            return gt(column, dbValue);
+        case 'gte':
+            return gte(column, dbValue);
+        case 'lt':
+            return lt(column, dbValue);
+        case 'lte':
+            return lte(column, dbValue);
+        case 'like':
+            return like(column, dbValue);
+        case 'ilike':
+            return ilike(column, dbValue);
+        case 'in':
+            return Array.isArray(dbValue) ? inArray(column, dbValue) : undefined;
+        case 'notIn':
+            return Array.isArray(dbValue) ? notInArray(column, dbValue) : undefined;
+        case 'between':
+            return Array.isArray(dbValue) && dbValue.length === 2
+                ? between(column, dbValue[0], dbValue[1])
+                : undefined;
+        case 'isNull':
+            return isNull(column);
+        case 'isNotNull':
+            return isNotNull(column);
+        case 'contains':
+            return ilike(column, `%${escapeLikePattern(String(dbValue))}%`);
+        case 'startsWith':
+            return ilike(column, `${escapeLikePattern(String(dbValue))}%`);
+        case 'endsWith':
+            return ilike(column, `%${escapeLikePattern(String(dbValue))}`);
+        default:
+            return undefined;
+    }
+}
+export function escapeLikePattern(value) {
+    return value.replace(/[%_\\]/g, '\\$&');
+}
+export { toDbValue, isDateString };
+//# sourceMappingURL=operators.js.map

package/dist/src/utils/operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.js","sourceRoot":"","sources":["../../../src/utils/operators.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,IAAI,EACJ,KAAK,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,MAAM,EACN,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,yCAAyC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;AAEjF,SAAS,SAAS,CAAC,KAAc,EAAE,QAAmB;IACpD,IAAI,QAAQ,IAAI,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACnB,IAAI,QAAQ,IAAI,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpD,OAAO,CAAC,CAAC;YACX,CAAC;YACD,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAkB,EAClB,MAAc,EACd,KAAc;IAEd,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAE3C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,KAAK,KAAK;YACR,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,KAAK,IAAI;YACP,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,KAAK,KAAK;YACR,OAAO,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,KAAK,IAAI;YACP,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,KAAK,KAAK;YACR,OAAO,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,MAAM,EAAE,OAAiB,CAAC,CAAC;QACzC,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,MAAM,EAAE,OAAiB,CAAC,CAAC;QAC1C,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBACnD,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;gBACzC,CAAC,CAAC,SAAS,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,MAAM,EAAE,IAAI,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;QAClE,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,MAAM,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;QACjE,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,MAAM,EAAE,IAAI,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;QACjE;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC"}

package/dist/src/utils/requestParser.d.ts

@@ -0,0 +1,18 @@
+import { EngineParams } from '../types/engine';
+/**
+ * Parses URL search-params into structured EngineParams.
+ *
+ * Supported:
+ *   ?page=1&pageSize=25
+ *   ?cursor=eyJpZCI6MTAwfQ
+ *   ?sort=-createdAt,name
+ *   ?filter[status]=active
+ *   ?filter[amount][gte]=100
+ *   ?search=hello
+ *   ?select=id,name,email
+ *   ?distinct=true
+ *   ?export=csv
+ *   ?includeDeleted=true
+ */
+export declare function parseRequest(params: URLSearchParams | Record<string, string | string[] | undefined>): EngineParams;
+//# sourceMappingURL=requestParser.d.ts.map

package/dist/src/utils/requestParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestParser.d.ts","sourceRoot":"","sources":["../../../src/utils/requestParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA0B,MAAM,iBAAiB,CAAC;AAGvE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACtE,YAAY,CAgBd"}

package/dist/src/utils/requestParser.js

@@ -0,0 +1,126 @@
+import { OperatorSchema } from '../types/table';
+/**
+ * Parses URL search-params into structured EngineParams.
+ *
+ * Supported:
+ *   ?page=1&pageSize=25
+ *   ?cursor=eyJpZCI6MTAwfQ
+ *   ?sort=-createdAt,name
+ *   ?filter[status]=active
+ *   ?filter[amount][gte]=100
+ *   ?search=hello
+ *   ?select=id,name,email
+ *   ?distinct=true
+ *   ?export=csv
+ *   ?includeDeleted=true
+ */
+export function parseRequest(params) {
+    const raw = normalise(params);
+    return {
+        page: parseIntSafe(raw['page']),
+        pageSize: parseIntSafe(raw['pageSize']),
+        cursor: raw['cursor'] || undefined,
+        sort: parseSort(raw['sort']),
+        filters: parseFilters(raw),
+        search: raw['search'] || undefined,
+        select: parseSelect(raw['select']),
+        distinct: raw['distinct'] === 'true',
+        export: parseExportFormat(raw['export']),
+        includeDeleted: raw['includeDeleted'] === 'true',
+        dateRange: parseDateRange(raw),
+    };
+}
+// ── Helpers ──
+function normalise(input) {
+    if (input instanceof URLSearchParams) {
+        const obj = {};
+        input.forEach((v, k) => { obj[k] = v; });
+        return obj;
+    }
+    const obj = {};
+    for (const [k, v] of Object.entries(input)) {
+        if (v !== undefined) {
+            obj[k] = Array.isArray(v) ? v[0] : v;
+        }
+    }
+    return obj;
+}
+function parseIntSafe(val) {
+    if (!val)
+        return undefined;
+    const n = parseInt(val, 10);
+    return Number.isFinite(n) ? n : undefined;
+}
+function parseSort(val) {
+    if (!val)
+        return undefined;
+    const parts = val.split(',').map((s) => s.trim()).filter(Boolean);
+    if (parts.length === 0)
+        return undefined;
+    return parts.map((part) => {
+        if (part.startsWith('-'))
+            return { field: part.slice(1), order: 'desc' };
+        if (part.startsWith('+'))
+            return { field: part.slice(1), order: 'asc' };
+        return { field: part, order: 'asc' };
+    });
+}
+function parseSelect(val) {
+    if (!val)
+        return undefined;
+    const fields = val.split(',').map((s) => s.trim()).filter(Boolean);
+    return fields.length > 0 ? fields : undefined;
+}
+function parseFilters(raw) {
+    const filters = {};
+    const filterRegexSimple = /^filter\[(\w+)]$/;
+    const filterRegexOperator = /^filter\[(\w+)]\[(\w+)]$/;
+    for (const [key, value] of Object.entries(raw)) {
+        const matchOp = filterRegexOperator.exec(key);
+        if (matchOp) {
+            const field = matchOp[1];
+            const op = matchOp[2];
+            if (isValidOperator(op)) {
+                filters[field] = { operator: op, value: coerceValue(value) };
+            }
+            continue;
+        }
+        const matchSimple = filterRegexSimple.exec(key);
+        if (matchSimple) {
+            const field = matchSimple[1];
+            filters[field] = { operator: 'eq', value: coerceValue(value) };
+        }
+    }
+    return Object.keys(filters).length > 0 ? filters : undefined;
+}
+function isValidOperator(op) {
+    return OperatorSchema.safeParse(op).success;
+}
+function coerceValue(val) {
+    if (val === 'true')
+        return true;
+    if (val === 'false')
+        return false;
+    if (val === 'null')
+        return null;
+    if (val.includes(','))
+        return val.split(',').map((v) => coerceValue(v.trim()));
+    const num = Number(val);
+    if (val !== '' && Number.isFinite(num))
+        return num;
+    return val;
+}
+function parseExportFormat(val) {
+    if (val === 'csv' || val === 'json')
+        return val;
+    return undefined;
+}
+function parseDateRange(raw) {
+    const from = raw['dateRange[from]'];
+    const to = raw['dateRange[to]'];
+    if (from || to) {
+        return { from, to };
+    }
+    return undefined;
+}
+//# sourceMappingURL=requestParser.js.map

package/dist/src/utils/requestParser.js.map

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

package/dist/src/utils/responseFormatter.d.ts

@@ -0,0 +1,12 @@
+import { TableConfig } from '../types/table';
+import { EngineResult, EngineMeta } from '../types/engine';
+export declare function registerTransform(name: string, fn: (val: unknown) => unknown): void;
+/**
+ * Applies all jsTransform functions defined on each column config to the data rows.
+ */
+export declare function applyJsTransforms(data: Record<string, unknown>[], config: TableConfig): Record<string, unknown>[];
+/**
+ * Builds a complete EngineResult, applying jsTransform and stripping hidden columns.
+ */
+export declare function formatResponse(data: Record<string, unknown>[], meta: EngineMeta, config: TableConfig, aggregations?: Record<string, number>): EngineResult;
+//# sourceMappingURL=responseFormatter.d.ts.map

package/dist/src/utils/responseFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseFormatter.d.ts","sourceRoot":"","sources":["../../../src/utils/responseFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAmC3D,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAC5B,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,MAAM,EAAE,WAAW,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAgD3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,YAAY,CAyBd"}