@tablecraft/engine 0.1.0-beta.1

package/dist/src/__tests__/inputValidator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inputValidator.test.d.ts.map

package/dist/src/__tests__/inputValidator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputValidator.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/inputValidator.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/inputValidator.test.js

@@ -0,0 +1,205 @@
+import { describe, it, expect } from 'vitest';
+import { validateInput } from '../core/inputValidator';
+function createTestConfig(columns) {
+    return {
+        name: 'test',
+        base: 'test_table',
+        columns: columns.map((c) => ({
+            name: c.name ?? 'id',
+            type: c.type ?? 'string',
+            label: c.label ?? c.name ?? 'ID',
+            hidden: c.hidden ?? false,
+            sortable: c.sortable ?? true,
+            filterable: c.filterable ?? true,
+            ...c,
+        })),
+    };
+}
+describe('inputValidator', () => {
+    describe('validateFilterValues', () => {
+        it('should skip unknown filter fields gracefully', () => {
+            const config = createTestConfig([
+                { name: 'id', type: 'number', filterable: true },
+                { name: 'name', type: 'string', filterable: true },
+            ]);
+            const params = {
+                filters: {
+                    nonexistentField: { operator: 'eq', value: 123 },
+                    anotherUnknown: { operator: 'gte', value: 'test' },
+                },
+            };
+            expect(() => validateInput(params, config)).not.toThrow();
+        });
+        it('should skip unknown fields but still validate known fields in mixed requests', () => {
+            const config = createTestConfig([
+                { name: 'id', type: 'number', filterable: true },
+                { name: 'name', type: 'string', filterable: true },
+            ]);
+            const validMixedParams = {
+                filters: {
+                    nonexistentField: { operator: 'eq', value: 123 },
+                    id: { operator: 'gt', value: 100 },
+                },
+            };
+            expect(() => validateInput(validMixedParams, config)).not.toThrow();
+            const invalidMixedParams = {
+                filters: {
+                    nonexistentField: { operator: 'eq', value: 123 },
+                    id: { operator: 'gt', value: 'not-a-number' },
+                },
+            };
+            expect(() => validateInput(invalidMixedParams, config)).toThrow();
+        });
+        it('should validate known filter fields with correct types', () => {
+            const config = createTestConfig([
+                { name: 'id', type: 'number', filterable: true },
+                { name: 'name', type: 'string', filterable: true },
+            ]);
+            const params = {
+                filters: {
+                    id: { operator: 'gt', value: 100 },
+                    name: { operator: 'contains', value: 'test' },
+                },
+            };
+            expect(() => validateInput(params, config)).not.toThrow();
+        });
+        it('should throw for non-filterable columns', () => {
+            const config = createTestConfig([
+                { name: 'id', type: 'number', filterable: false },
+            ]);
+            const params = {
+                filters: {
+                    id: { operator: 'eq', value: 1 },
+                },
+            };
+            expect(() => validateInput(params, config)).toThrow('is not filterable');
+        });
+        it('should validate number type correctly', () => {
+            const config = createTestConfig([
+                { name: 'price', type: 'number', filterable: true },
+            ]);
+            const validParams = {
+                filters: { price: { operator: 'gte', value: 100 } },
+            };
+            expect(() => validateInput(validParams, config)).not.toThrow();
+            const invalidParams = {
+                filters: { price: { operator: 'gte', value: 'not-a-number' } },
+            };
+            expect(() => validateInput(invalidParams, config)).toThrow();
+        });
+        it('should validate date type correctly', () => {
+            const config = createTestConfig([
+                { name: 'createdAt', type: 'date', filterable: true },
+            ]);
+            const validParams = {
+                filters: { createdAt: { operator: 'gte', value: '2024-01-01T00:00:00Z' } },
+            };
+            expect(() => validateInput(validParams, config)).not.toThrow();
+            const invalidParams = {
+                filters: { createdAt: { operator: 'gte', value: 'not-a-date' } },
+            };
+            expect(() => validateInput(invalidParams, config)).toThrow();
+        });
+        it('should validate boolean type correctly', () => {
+            const config = createTestConfig([
+                { name: 'isActive', type: 'boolean', filterable: true },
+            ]);
+            const validParams = {
+                filters: { isActive: { operator: 'eq', value: true } },
+            };
+            expect(() => validateInput(validParams, config)).not.toThrow();
+            const invalidParams = {
+                filters: { isActive: { operator: 'eq', value: 'yes' } },
+            };
+            expect(() => validateInput(invalidParams, config)).toThrow();
+        });
+        it('should validate between operator with array value', () => {
+            const config = createTestConfig([
+                { name: 'price', type: 'number', filterable: true },
+            ]);
+            const validParams = {
+                filters: { price: { operator: 'between', value: [10, 100] } },
+            };
+            expect(() => validateInput(validParams, config)).not.toThrow();
+            const invalidParams = {
+                filters: { price: { operator: 'between', value: [10] } },
+            };
+            expect(() => validateInput(invalidParams, config)).toThrow();
+        });
+        it('should validate in operator with array value', () => {
+            const config = createTestConfig([
+                { name: 'status', type: 'string', filterable: true },
+            ]);
+            const validParams = {
+                filters: { status: { operator: 'in', value: ['active', 'pending'] } },
+            };
+            expect(() => validateInput(validParams, config)).not.toThrow();
+            const invalidParams = {
+                filters: { status: { operator: 'in', value: 'active' } },
+            };
+            expect(() => validateInput(invalidParams, config)).toThrow();
+        });
+        it('should skip validation for isNull and isNotNull operators', () => {
+            const config = createTestConfig([
+                { name: 'deletedAt', type: 'date', filterable: true },
+            ]);
+            const params = {
+                filters: { deletedAt: { operator: 'isNull', value: null } },
+            };
+            expect(() => validateInput(params, config)).not.toThrow();
+        });
+    });
+    describe('validateSelectFields', () => {
+        it('should validate existing fields', () => {
+            const config = createTestConfig([
+                { name: 'id', type: 'number' },
+                { name: 'name', type: 'string' },
+            ]);
+            const params = {
+                select: ['id', 'name'],
+            };
+            expect(() => validateInput(params, config)).not.toThrow();
+        });
+        it('should throw for non-existent fields', () => {
+            const config = createTestConfig([
+                { name: 'id', type: 'number' },
+            ]);
+            const params = {
+                select: ['nonexistent'],
+            };
+            expect(() => validateInput(params, config)).toThrow('does not exist');
+        });
+        it('should throw for hidden fields', () => {
+            const config = createTestConfig([
+                { name: 'id', type: 'number' },
+                { name: 'secret', type: 'string', hidden: true },
+            ]);
+            const params = {
+                select: ['secret'],
+            };
+            expect(() => validateInput(params, config)).toThrow('is not accessible');
+        });
+    });
+    describe('validateSortFields', () => {
+        it('should validate sortable fields', () => {
+            const config = createTestConfig([
+                { name: 'id', type: 'number', sortable: true },
+                { name: 'name', type: 'string', sortable: true },
+            ]);
+            const params = {
+                sort: [{ field: 'id', order: 'asc' }],
+            };
+            expect(() => validateInput(params, config)).not.toThrow();
+        });
+        it('should throw for non-sortable fields', () => {
+            const config = createTestConfig([
+                { name: 'id', type: 'number', sortable: false },
+            ]);
+            const params = {
+                sort: [{ field: 'id', order: 'asc' }],
+            };
+            expect(() => validateInput(params, config)).toThrow('is not sortable');
+        });
+    });
+});
+//# sourceMappingURL=inputValidator.test.js.map

package/dist/src/__tests__/inputValidator.test.js.map

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

package/dist/src/__tests__/metadataBuilder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metadataBuilder.test.d.ts.map

package/dist/src/__tests__/metadataBuilder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataBuilder.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/metadataBuilder.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/metadataBuilder.test.js

@@ -0,0 +1,221 @@
+import { describe, it, expect } from 'vitest';
+import { buildMetadata } from '../core/metadataBuilder';
+function createTestConfig(overrides = {}) {
+    return {
+        name: 'test_table',
+        base: 'test_table',
+        columns: [
+            { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+            { name: 'name', type: 'string', label: 'Name', hidden: false, sortable: true, filterable: true },
+        ],
+        ...overrides,
+    };
+}
+describe('metadataBuilder', () => {
+    describe('dateRangeColumn detection', () => {
+        it('should return null when no date columns exist', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'name', type: 'string', label: 'Name', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBeNull();
+            expect(meta.dateColumns).toEqual([]);
+        });
+        it('should detect createdAt column automatically', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'createdAt', type: 'date', label: 'Created At', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBe('createdAt');
+            expect(meta.dateColumns).toEqual(['createdAt']);
+        });
+        it('should detect created_at column (snake_case) automatically', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'created_at', type: 'date', label: 'Created At', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBe('created_at');
+            expect(meta.dateColumns).toEqual(['created_at']);
+        });
+        it('should prefer createdAt over other date columns', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'customDate', type: 'date', label: 'Custom Date', hidden: false, sortable: true, filterable: true },
+                    { name: 'createdAt', type: 'date', label: 'Created At', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBe('createdAt');
+            expect(meta.dateColumns).toEqual(['customDate', 'createdAt']);
+        });
+        it('should use first date column when no createdAt exists', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'shippedAt', type: 'date', label: 'Shipped At', hidden: false, sortable: true, filterable: true },
+                    { name: 'deliveredAt', type: 'date', label: 'Delivered At', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBe('shippedAt');
+            expect(meta.dateColumns).toEqual(['shippedAt', 'deliveredAt']);
+        });
+        it('should use explicit dateRangeColumn from config', () => {
+            const config = createTestConfig({
+                dateRangeColumn: 'deliveredAt',
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'createdAt', type: 'date', label: 'Created At', hidden: false, sortable: true, filterable: true },
+                    { name: 'deliveredAt', type: 'date', label: 'Delivered At', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBe('deliveredAt');
+            expect(meta.dateColumns).toEqual(['createdAt', 'deliveredAt']);
+        });
+        it('should fall back to auto-detected dateRangeColumn when config references a missing column', () => {
+            const config = createTestConfig({
+                dateRangeColumn: 'missingColumn',
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'shippedAt', type: 'date', label: 'Shipped At', hidden: false, sortable: true, filterable: true },
+                    { name: 'deliveredAt', type: 'date', label: 'Delivered At', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBe('shippedAt');
+            expect(meta.dateColumns).toEqual(['shippedAt', 'deliveredAt']);
+        });
+        it('should fall back to auto-detected dateRangeColumn when config references a non-date column', () => {
+            const config = createTestConfig({
+                dateRangeColumn: 'id',
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'shippedAt', type: 'date', label: 'Shipped At', hidden: false, sortable: true, filterable: true },
+                    { name: 'deliveredAt', type: 'date', label: 'Delivered At', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBe('shippedAt');
+            expect(meta.dateColumns).toEqual(['shippedAt', 'deliveredAt']);
+        });
+        it('should fall back to auto-detected dateRangeColumn when config references a hidden column', () => {
+            const config = createTestConfig({
+                dateRangeColumn: 'internalDate',
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'shippedAt', type: 'date', label: 'Shipped At', hidden: false, sortable: true, filterable: true },
+                    { name: 'internalDate', type: 'date', label: 'Internal', hidden: true, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBe('shippedAt');
+            expect(meta.dateColumns).toEqual(['shippedAt']);
+        });
+        it('should exclude hidden columns from dateColumns', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'createdAt', type: 'date', label: 'Created At', hidden: false, sortable: true, filterable: true },
+                    { name: 'internalDate', type: 'date', label: 'Internal', hidden: true, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateColumns).toEqual(['createdAt']);
+            expect(meta.dateRangeColumn).toBe('createdAt');
+        });
+        it('should return null when dateRangeColumn is not set and no date columns exist', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'name', type: 'string', label: 'Name', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateRangeColumn).toBeNull();
+            expect(meta.dateColumns).toEqual([]);
+        });
+        it('should exclude computed columns from dateColumns', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'createdAt', type: 'date', label: 'Created At', hidden: false, sortable: true, filterable: true },
+                    { name: 'computedDate', type: 'date', label: 'Computed', hidden: false, sortable: true, filterable: true, computed: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateColumns).toEqual(['createdAt']);
+            expect(meta.dateRangeColumn).toBe('createdAt');
+        });
+        it('should detect multiple date columns', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'createdAt', type: 'date', label: 'Created At', hidden: false, sortable: true, filterable: true },
+                    { name: 'updatedAt', type: 'date', label: 'Updated At', hidden: false, sortable: true, filterable: true },
+                    { name: 'deletedAt', type: 'date', label: 'Deleted At', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.dateColumns).toEqual(['createdAt', 'updatedAt', 'deletedAt']);
+            expect(meta.dateRangeColumn).toBe('createdAt');
+        });
+    });
+    describe('filter metadata', () => {
+        it('should generate filter metadata for filterable columns', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'name', type: 'string', label: 'Name', hidden: false, sortable: true, filterable: false },
+                    { name: 'status', type: 'string', label: 'Status', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.filters).toHaveLength(2);
+            expect(meta.filters.map(f => f.field)).toEqual(['id', 'status']);
+        });
+        it('should include correct operators for column types', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'price', type: 'number', label: 'Price', hidden: false, sortable: true, filterable: true },
+                    { name: 'createdAt', type: 'date', label: 'Created', hidden: false, sortable: true, filterable: true },
+                    { name: 'isActive', type: 'boolean', label: 'Active', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            const priceFilter = meta.filters.find(f => f.field === 'price');
+            expect(priceFilter?.operators).toContain('gt');
+            expect(priceFilter?.operators).toContain('between');
+            const dateFilter = meta.filters.find(f => f.field === 'createdAt');
+            expect(dateFilter?.operators).toContain('gte');
+            expect(dateFilter?.operators).toContain('between');
+            const boolFilter = meta.filters.find(f => f.field === 'isActive');
+            expect(boolFilter?.operators).toEqual(['eq', 'neq']);
+        });
+    });
+    describe('column metadata', () => {
+        it('should exclude hidden columns from visible columns', () => {
+            const config = createTestConfig({
+                columns: [
+                    { name: 'id', type: 'number', label: 'ID', hidden: false, sortable: true, filterable: true },
+                    { name: 'secret', type: 'string', label: 'Secret', hidden: true, sortable: true, filterable: true },
+                    { name: 'name', type: 'string', label: 'Name', hidden: false, sortable: true, filterable: true },
+                ],
+            });
+            const meta = buildMetadata(config);
+            expect(meta.columns).toHaveLength(2);
+            expect(meta.columns.map(c => c.name)).toEqual(['id', 'name']);
+        });
+    });
+});
+//# sourceMappingURL=metadataBuilder.test.js.map

package/dist/src/__tests__/metadataBuilder.test.js.map

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

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

@@ -0,0 +1,17 @@
+import { SQL } from 'drizzle-orm';
+import { TableConfig } from '../types/table';
+export declare class AggregationBuilder {
+    private schema;
+    constructor(schema: Record<string, unknown>);
+    /**
+     * Builds aggregation select fields (COUNT, SUM, AVG, MIN, MAX).
+     * Returns a map of alias → SQL expression for use in a separate aggregation query.
+     */
+    buildAggregations(config: TableConfig): Record<string, SQL> | undefined;
+    /**
+     * Builds the select map for a standalone aggregation query,
+     * always including a total row count alongside configured aggregations.
+     */
+    buildAggregationSelect(config: TableConfig): Record<string, SQL>;
+}
+//# sourceMappingURL=aggregationBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aggregationBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/aggregationBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,GAAG,EAOJ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qBAAa,kBAAkB;IACjB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnD;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAqCvE;;;OAGG;IACH,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAmCjE"}

package/dist/src/core/aggregationBuilder.js

@@ -0,0 +1,81 @@
+import { getTableColumns, count, sum, avg, min, max, } from 'drizzle-orm';
+export class AggregationBuilder {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    /**
+     * Builds aggregation select fields (COUNT, SUM, AVG, MIN, MAX).
+     * Returns a map of alias → SQL expression for use in a separate aggregation query.
+     */
+    buildAggregations(config) {
+        if (!config.aggregations || config.aggregations.length === 0) {
+            return undefined;
+        }
+        const table = this.schema[config.base];
+        if (!table)
+            return undefined;
+        const columns = getTableColumns(table);
+        const result = {};
+        for (const agg of config.aggregations) {
+            const col = columns[agg.field];
+            if (!col)
+                continue;
+            switch (agg.type) {
+                case 'count':
+                    result[agg.alias] = count(col);
+                    break;
+                case 'sum':
+                    result[agg.alias] = sum(col);
+                    break;
+                case 'avg':
+                    result[agg.alias] = avg(col);
+                    break;
+                case 'min':
+                    result[agg.alias] = min(col);
+                    break;
+                case 'max':
+                    result[agg.alias] = max(col);
+                    break;
+            }
+        }
+        return Object.keys(result).length > 0 ? result : undefined;
+    }
+    /**
+     * Builds the select map for a standalone aggregation query,
+     * always including a total row count alongside configured aggregations.
+     */
+    buildAggregationSelect(config) {
+        const result = { _totalCount: count() };
+        if (!config.aggregations)
+            return result;
+        const table = this.schema[config.base];
+        if (!table)
+            return result;
+        const columns = getTableColumns(table);
+        for (const agg of config.aggregations) {
+            const col = columns[agg.field];
+            if (!col)
+                continue;
+            switch (agg.type) {
+                case 'count':
+                    result[agg.alias] = count(col);
+                    break;
+                case 'sum':
+                    result[agg.alias] = sum(col);
+                    break;
+                case 'avg':
+                    result[agg.alias] = avg(col);
+                    break;
+                case 'min':
+                    result[agg.alias] = min(col);
+                    break;
+                case 'max':
+                    result[agg.alias] = max(col);
+                    break;
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=aggregationBuilder.js.map

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

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

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

@@ -0,0 +1,36 @@
+import { SQL } from 'drizzle-orm';
+import { TableConfig, SortConfig } from '../types/table';
+export interface CursorResult {
+    whereCondition: SQL | undefined;
+    orderBy: SQL[];
+    limit: number;
+}
+export interface CursorMeta {
+    nextCursor: string | null;
+    pageSize: number;
+}
+/**
+ * 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 declare class CursorPaginationBuilder {
+    private schema;
+    constructor(schema: Record<string, unknown>);
+    /**
+     * Decodes a cursor string and builds WHERE + ORDER BY for the next page.
+     */
+    build(config: TableConfig, cursor: string | undefined, pageSize: number, sort?: SortConfig[]): CursorResult;
+    /**
+     * From the fetched data (with 1 extra row), determine next cursor.
+     */
+    buildMeta(data: Record<string, unknown>[], pageSize: number, sort?: SortConfig[]): {
+        data: Record<string, unknown>[];
+        meta: CursorMeta;
+    };
+}
+export declare function encodeCursor(values: Record<string, unknown>): string;
+export declare function decodeCursor(cursor: string): Record<string, unknown> | null;
+//# sourceMappingURL=cursorPagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursorPagination.d.ts","sourceRoot":"","sources":["../../../src/core/cursorPagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,GAAG,EAA2C,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,GAAG,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,uBAAuB;IACtB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnD;;OAEG;IACH,KAAK,CACH,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,UAAU,EAAE,GAClB,YAAY;IA6Cf;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,UAAU,EAAE,GAClB;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE;CAgBzD;AAID,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEpE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAO3E"}