@woltz/rich-domain 1.7.0 → 1.8.0

package/dist/esm/repository/entity-schema-registry.js

@@ -0,0 +1,366 @@
+import { Entity, ValueObject, Id } from "../core/index";
+import { ConfigurationError } from "../exceptions.js";
+import { levenshteinDistance } from "../utils/helpers.js";
+/**
+ * Registry for mapping domain entities to database tables and fields.
+ *
+ * @example
+ * ```typescript
+ * const registry = new EntitySchemaRegistry()
+ *   .register({
+ *     entity: 'User',
+ *     table: 'users',
+ *     fields: { email: 'user_email', name: 'user_name' },
+ *   })
+ *   .register({
+ *     entity: 'Post',
+ *     table: 'blog_posts',
+ *     fields: { content: 'post_content' },
+ *     parentFk: { field: 'author_id', parentEntity: 'User' },
+ *     collections: {
+ *       comments: { type: 'owned' },
+ *       tags: { type: 'reference', entity: 'Tag' }
+ *     }
+ *   });
+ *
+ * const table = registry.getTable('Post'); // 'blog_posts'
+ * const tagConfig = registry.getCollectionConfig('Post', 'tags');
+ * // { type: 'reference', entity: 'Tag' }
+ * ```
+ */
+export class EntitySchemaRegistry {
+    schemas = new Map();
+    /**
+     * Registers an entity schema.
+     * @param schema - Schema to be registered.
+     * @returns this (for chaining)
+     */
+    register(schema) {
+        if (this.schemas.has(schema.entity)) {
+            console.warn(`EntitySchemaRegistry: Schema for '${schema.entity}' is being overwritten`);
+        }
+        this.schemas.set(schema.entity, schema);
+        return this;
+    }
+    /**
+     * Registers multiple schemas at once.
+     * @param schemas - Array of schemas.
+     * @returns this (for chaining)
+     */
+    registerAll(schemas) {
+        schemas.forEach((schema) => this.register(schema));
+        return this;
+    }
+    /**
+     * Gets the schema of an entity.
+     * @param entity - Entity name.
+     * @throws Error if the entity is not registered.
+     */
+    getSchema(entity) {
+        const schema = this.schemas.get(entity);
+        if (!schema) {
+            throw new ConfigurationError(`EntitySchemaRegistry: No schema registered for entity '${entity}'. ` +
+                `Available entities: ${Array.from(this.schemas.keys()).join(", ") || "none"}`);
+        }
+        return schema;
+    }
+    /**
+     * Gets all registered schemas.
+     */
+    getAllSchemas() {
+        return Array.from(this.schemas.values());
+    }
+    /**
+     * Tries to get the schema of an entity, returns null if not found.
+     * @param entity - Entity name.
+     */
+    tryGetSchema(entity) {
+        return this.schemas.get(entity) ?? null;
+    }
+    /**
+     * Checks if an entity is registered.
+     * @param entity - Entity name.
+     */
+    has(entity) {
+        return this.schemas.has(entity);
+    }
+    /**
+     * Gets the table name for an entity.
+     * @param entity - Entity name.
+     */
+    getTable(entity) {
+        return this.getSchema(entity).table;
+    }
+    /**
+     * Gets the field mapping for an entity.
+     * @param entity - Entity name.
+     */
+    getFieldsMap(entity) {
+        return this.getSchema(entity).fields || {};
+    }
+    /**
+     * Maps a domain field name to the database field name.
+     * @param entity - Entity name.
+     * @param fieldName - Domain field name.
+     */
+    mapFieldName(entity, fieldName) {
+        const fields = this.getFieldsMap(entity);
+        return fields[fieldName] ?? fieldName;
+    }
+    /**
+     * Maps fields of a domain object to database field names.
+     * Ignores values that are Entity, ValueObject, or Arrays.
+     *
+     * @param entity - Entity name.
+     * @param data - Data to be mapped.
+     */
+    mapFields(entity, data) {
+        const fields = this.getFieldsMap(entity);
+        const result = {};
+        for (const [key, value] of Object.entries(data)) {
+            if (this.isEntityOrCollection(value))
+                continue;
+            const mappedKey = fields[key] ?? key;
+            result[mappedKey] = this.normalizeValue(value);
+        }
+        return result;
+    }
+    /**
+     * Maps a complete domain entity to database data.
+     * Used for CREATE operations.
+     *
+     * @param entity - Entity name.
+     * @param domainEntity - Domain entity instance.
+     */
+    mapEntity(entity, domainEntity) {
+        const fields = this.getFieldsMap(entity);
+        const result = {};
+        const hasId = domainEntity.id;
+        if (hasId) {
+            const idValue = hasId.value ?? hasId;
+            result["id"] = idValue;
+        }
+        const props = domainEntity.props || domainEntity;
+        for (const [key, value] of Object.entries(props)) {
+            if (key === "id")
+                continue;
+            if (this.isEntityOrCollection(value))
+                continue;
+            const mappedKey = fields[key] ?? key;
+            result[mappedKey] = this.normalizeValue(value);
+        }
+        return result;
+    }
+    /**
+     * Gets the FK object to relate with the parent.
+     *
+     * @param entity - Entity name.
+     * @param parentId - Parent ID.
+     * @returns Object with the FK field or null if there is no parent.
+     */
+    getParentFk(entity, parentId) {
+        const schema = this.getSchema(entity);
+        if (!schema.parentFk)
+            return null;
+        return { [schema.parentFk.field]: parentId };
+    }
+    /**
+     * Gets the name of the parent entity.
+     * @param entity - Entity name.
+     */
+    getParentEntity(entity) {
+        const schema = this.getSchema(entity);
+        return schema.parentFk?.parentEntity ?? null;
+    }
+    /**
+     * Gets the FK field name.
+     * @param entity - Entity name.
+     */
+    getParentFkField(entity) {
+        const schema = this.getSchema(entity);
+        return schema.parentFk?.field ?? null;
+    }
+    /**
+     * Gets the collection configuration for a specific field.
+     *
+     * @param entity - Parent entity name (e.g., 'Post')
+     * @param fieldName - Collection field name (e.g., 'tags')
+     * @returns CollectionConfig or null if not configured
+     *
+     * @example
+     * ```typescript
+     * const config = registry.getCollectionConfig('Post', 'tags');
+     * if (config?.type === 'reference') {
+     *   // Handle N:N relation - use connect/disconnect
+     * } else {
+     *   // Handle 1:N relation - use create/delete
+     * }
+     * ```
+     */
+    getCollectionConfig(entity, fieldName) {
+        const schema = this.tryGetSchema(entity);
+        if (!schema?.collections)
+            return null;
+        return schema.collections[fieldName] ?? null;
+    }
+    /**
+     * Checks if a collection is a reference type (N:N).
+     *
+     * @param entity - Parent entity name
+     * @param fieldName - Collection field name
+     * @returns true if the collection is a reference (N:N), false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (registry.isReferenceCollection('Post', 'tags')) {
+     *   // Use connect/disconnect instead of create/delete
+     * }
+     * ```
+     */
+    isReferenceCollection(entity, fieldName) {
+        const config = this.getCollectionConfig(entity, fieldName);
+        return config?.type === "reference";
+    }
+    /**
+     * Checks if a collection is owned (1:N).
+     * Returns true if explicitly configured as 'owned' or if not configured at all.
+     *
+     * @param entity - Parent entity name
+     * @param fieldName - Collection field name
+     * @returns true if the collection is owned (1:N), false if reference
+     */
+    isOwnedCollection(entity, fieldName) {
+        const config = this.getCollectionConfig(entity, fieldName);
+        // Default to owned if not configured
+        return config?.type !== "reference";
+    }
+    /**
+     * Gets all collections configured for an entity.
+     *
+     * @param entity - Entity name
+     * @returns Record of field names to collection configs, or empty object
+     */
+    getCollections(entity) {
+        const schema = this.tryGetSchema(entity);
+        return schema?.collections ?? {};
+    }
+    /**
+     * Gets all reference (N:N) collections for an entity.
+     *
+     * @param entity - Entity name
+     * @returns Array of field names that are reference collections
+     */
+    getReferenceCollections(entity) {
+        const collections = this.getCollections(entity);
+        return Object.entries(collections)
+            .filter(([_, config]) => config.type === "reference")
+            .map(([field]) => field);
+    }
+    /**
+     * Gets the junction table configuration for a reference collection.
+     *
+     * @param entity - Parent entity name
+     * @param fieldName - Collection field name
+     * @returns Junction config or null
+     */
+    getJunctionConfig(entity, fieldName) {
+        const config = this.getCollectionConfig(entity, fieldName);
+        return config?.junction ?? null;
+    }
+    /**
+     * Lists all registered entities.
+     */
+    getRegisteredEntities() {
+        return Array.from(this.schemas.keys());
+    }
+    /**
+     * Clears all registered schemas.
+     */
+    clear() {
+        this.schemas.clear();
+    }
+    /**
+     * Checks if a value is Entity, ValueObject, or Array.
+     */
+    isEntityOrCollection(value) {
+        if (value === null || value === undefined)
+            return false;
+        if (Array.isArray(value))
+            return true;
+        if (value instanceof Entity)
+            return true;
+        if (value instanceof ValueObject)
+            return true;
+        if (typeof value === "object" &&
+            value.id &&
+            typeof value.id === "object" &&
+            "value" in value.id) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Normalizes a value for persistence.
+     */
+    normalizeValue(input) {
+        if (input === null || input === undefined)
+            return input;
+        if (input instanceof Id)
+            return input.value;
+        if (input instanceof ValueObject)
+            return input.value;
+        if (input instanceof Date)
+            return input;
+        if (typeof input === "object" && "value" in input) {
+            return input.value;
+        }
+        return input;
+    }
+    /**
+     * Validates that a relation field exists in the entity's collections.
+     *
+     * @param entity - Parent entity name
+     * @param relationField - Relation field to validate
+     * @throws ConfigurationError if the field doesn't exist
+     *
+     */
+    validateRelationField(entity, relationField) {
+        const schema = this.tryGetSchema(entity);
+        const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+        if (uuidPattern.test(entity)) {
+            throw new ConfigurationError(`EntitySchemaRegistry: Received an ID '${entity}' instead of an entity name. ` +
+                `This usually means 'parentEntity' is not being set correctly in the ChangeTracker. ` +
+                `Check that addDelete/addCreate are receiving the entity NAME (e.g., 'Post'), not the ID.`);
+        }
+        if (!schema) {
+            throw new ConfigurationError(`EntitySchemaRegistry: Cannot validate relation '${relationField}' - ` +
+                `entity '${entity}' is not registered. ` +
+                `Available entities: ${this.getRegisteredEntities().join(", ") || "none"}`);
+        }
+        const collections = schema.collections ?? {};
+        const availableCollections = Object.keys(collections);
+        if (availableCollections.length === 0) {
+            return;
+        }
+        if (!collections[relationField]) {
+            const suggestions = this.findSimilarNames(relationField, availableCollections);
+            const suggestionText = suggestions.length > 0
+                ? ` Did you mean: '${suggestions.join("' or '")}'?`
+                : "";
+            throw new ConfigurationError(`EntitySchemaRegistry: Unknown relation '${relationField}' for entity '${entity}'. ` +
+                `Available collections: ${availableCollections.join(", ")}.${suggestionText}`);
+        }
+    }
+    findSimilarNames(input, candidates) {
+        return candidates
+            .map((candidate) => ({
+            name: candidate,
+            distance: levenshteinDistance(input.toLowerCase(), candidate.toLowerCase()),
+        }))
+            .filter(({ distance }) => distance <= 3)
+            .sort((a, b) => a.distance - b.distance)
+            .slice(0, 2)
+            .map(({ name }) => name);
+    }
+}
+//# sourceMappingURL=entity-schema-registry.js.map

package/dist/esm/repository/entity-schema-registry.js.map

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

package/dist/esm/repository/index.d.ts

@@ -1,4 +1,6 @@
-export { Mapper } from "../mapper.js";
 export * from "./base-repository.js";
-export { UnitOfWork, BaseTransactionContext } from "./unit-of-work.js";
+export * from "./mapper.js";
+export * from "./unit-of-work.js";
+export * from "./entity-schema-registry.js";
+export * from "./paginated-result.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/repository/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/repository/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}

package/dist/esm/repository/index.js

@@ -1,4 +1,6 @@
-export { Mapper } from "../mapper.js";
 export * from "./base-repository.js";
-export { UnitOfWork, BaseTransactionContext } from "./unit-of-work.js";
+export * from "./mapper.js";
+export * from "./unit-of-work.js";
+export * from "./entity-schema-registry.js";
+export * from "./paginated-result.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/repository/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/repository/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}

package/dist/esm/repository/mapper.d.ts

@@ -0,0 +1,4 @@
+export declare abstract class Mapper<Input, Output> {
+    abstract build(input: Input, ...args: unknown[]): Output | Promise<Output>;
+}
+//# sourceMappingURL=mapper.d.ts.map

package/dist/esm/repository/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/repository/mapper.ts"],"names":[],"mappings":"AAAA,8BAAsB,MAAM,CAAC,KAAK,EAAE,MAAM;aACxB,KAAK,CACnB,KAAK,EAAE,KAAK,EACZ,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAC5B"}

package/dist/esm/repository/mapper.js

@@ -0,0 +1,3 @@
+export class Mapper {
+}
+//# sourceMappingURL=mapper.js.map

package/dist/esm/repository/mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/repository/mapper.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,MAAM;CAK3B"}

package/dist/esm/repository/paginated-result.d.ts

@@ -0,0 +1,54 @@
+import type { Criteria } from "../criteria.js";
+import type { Pagination, PaginationMeta, DeepJsonResult } from "../types/index.js";
+/**
+ * Type for the serialized result of PaginatedResult.toJSON()
+ * Uses DeepJsonResult to ensure all nested entities are converted to plain objects
+ */
+export type PaginatedJsonResult<T> = {
+    data: DeepJsonResult<T>[];
+    meta: PaginationMeta;
+};
+export declare class PaginatedResult<T> {
+    readonly data: T[];
+    readonly meta: PaginationMeta;
+    constructor(data: T[], meta: PaginationMeta);
+    /**
+     * Creates a PaginatedResult with calculated metadata
+     */
+    static create<T>(data: T[], pagination: Pagination, total: number): PaginatedResult<T>;
+    /**
+     * Creates pagination metadata from total count
+     */
+    static createMeta(pagination: Pagination, total: number): PaginationMeta;
+    /**
+     * Applies criteria to an in-memory array (useful for testing)
+     */
+    static fromArray<T>(items: T[], criteria: Criteria<T>): PaginatedResult<T>;
+    /**
+     * Converts the result to JSON, deeply serializing all entities/aggregates/value objects
+     * - Entities/Aggregates → calls toJSON() recursively
+     * - Value Objects → converts to value
+     * - Id → converts to string
+     * - Arrays → maps recursively
+     * - Plain objects → serializes properties recursively
+     * - Primitives → returns as-is
+     */
+    toJSON(): PaginatedJsonResult<T>;
+    /**
+     * Deep serialization logic (similar to BaseEntity.deepToJson)
+     */
+    private deepSerialize;
+    /**
+     * Transform each item in the result using a mapper function
+     */
+    map<U>(fn: (item: T) => U): PaginatedResult<U>;
+    /**
+     * Check if result has no data
+     */
+    get isEmpty(): boolean;
+    /**
+     * Check if there are more pages available
+     */
+    get hasMore(): boolean;
+}
+//# sourceMappingURL=paginated-result.d.ts.map

package/dist/esm/repository/paginated-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginated-result.d.ts","sourceRoot":"","sources":["../../../src/repository/paginated-result.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EAEd,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1B,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,qBAAa,eAAe,CAAC,CAAC;aAEV,IAAI,EAAE,CAAC,EAAE;aACT,IAAI,EAAE,cAAc;gBADpB,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,cAAc;IAGtC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EACb,IAAI,EAAE,CAAC,EAAE,EACT,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,GACZ,eAAe,CAAC,CAAC,CAAC;IAKrB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc;IAaxE;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IA0C1E;;;;;;;;OAQG;IACH,MAAM,IAAI,mBAAmB,CAAC,CAAC,CAAC;IAShC;;OAEG;IACH,OAAO,CAAC,aAAa;IA2BrB;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAI9C;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;CACF"}

package/dist/esm/repository/paginated-result.js

@@ -0,0 +1,193 @@
+import { Id } from "../core/id.js";
+import { ValueObject } from "../core/value-object.js";
+export class PaginatedResult {
+    data;
+    meta;
+    constructor(data, meta) {
+        this.data = data;
+        this.meta = meta;
+    }
+    /**
+     * Creates a PaginatedResult with calculated metadata
+     */
+    static create(data, pagination, total) {
+        const meta = this.createMeta(pagination, total);
+        return new PaginatedResult(data, meta);
+    }
+    /**
+     * Creates pagination metadata from total count
+     */
+    static createMeta(pagination, total) {
+        const totalPages = Math.ceil(total / pagination.limit);
+        return {
+            page: pagination.page,
+            limit: pagination.limit,
+            total,
+            totalPages,
+            hasNext: pagination.page < totalPages,
+            hasPrevious: pagination.page > 1,
+        };
+    }
+    /**
+     * Applies criteria to an in-memory array (useful for testing)
+     */
+    static fromArray(items, criteria) {
+        let result = [...items];
+        let total = result.length;
+        for (const filter of criteria.getFilters()) {
+            result = result.filter((item) => applyFilter(item, filter));
+            total = result.length;
+        }
+        for (const order of criteria.getOrders().reverse()) {
+            result.sort((a, b) => {
+                const aVal = getNestedValue(a, order.field);
+                const bVal = getNestedValue(b, order.field);
+                let comparison = 0;
+                if (aVal < bVal)
+                    comparison = -1;
+                if (aVal > bVal)
+                    comparison = 1;
+                return order.direction === "desc" ? -comparison : comparison;
+            });
+        }
+        const pagination = criteria.getPagination();
+        result = result.slice(pagination.offset, pagination.offset + pagination.limit);
+        const search = criteria.getSearch();
+        if (search) {
+            result = result.filter((item) => {
+                const values = Object.values(item);
+                return values.some((val) => String(val).toLowerCase().includes(search.toLowerCase()));
+            });
+        }
+        return PaginatedResult.create(result, pagination, total);
+    }
+    /**
+     * Converts the result to JSON, deeply serializing all entities/aggregates/value objects
+     * - Entities/Aggregates → calls toJSON() recursively
+     * - Value Objects → converts to value
+     * - Id → converts to string
+     * - Arrays → maps recursively
+     * - Plain objects → serializes properties recursively
+     * - Primitives → returns as-is
+     */
+    toJSON() {
+        return {
+            data: this.data.map((item) => this.deepSerialize(item)),
+            meta: this.meta,
+        };
+    }
+    /**
+     * Deep serialization logic (similar to BaseEntity.deepToJson)
+     */
+    deepSerialize(obj) {
+        if (obj === null || obj === undefined)
+            return obj;
+        if (obj instanceof Id)
+            return obj.value;
+        if (obj instanceof ValueObject)
+            return obj.value;
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.deepSerialize(item));
+        }
+        if (obj && typeof obj.toJSON === "function") {
+            return obj.toJSON();
+        }
+        if (typeof obj === "object") {
+            const result = {};
+            for (const key in obj) {
+                if (obj.hasOwnProperty(key)) {
+                    result[key] = this.deepSerialize(obj[key]);
+                }
+            }
+            return result;
+        }
+        return obj;
+    }
+    /**
+     * Transform each item in the result using a mapper function
+     */
+    map(fn) {
+        return new PaginatedResult(this.data.map(fn), this.meta);
+    }
+    /**
+     * Check if result has no data
+     */
+    get isEmpty() {
+        return this.data.length === 0;
+    }
+    /**
+     * Check if there are more pages available
+     */
+    get hasMore() {
+        return this.meta.hasNext;
+    }
+}
+function applyFilter(item, filter) {
+    const value = getNestedValue(item, filter.field);
+    const isValueDate = value instanceof Date;
+    const parseValue = (v) => {
+        if (isValueDate && typeof v === "string")
+            return new Date(v);
+        if (isValueDate && typeof v === "number")
+            return new Date(v);
+        return v;
+    };
+    switch (filter.operator) {
+        case "equals":
+            return value === filter.value;
+        case "notEquals":
+            return value !== filter.value;
+        case "greaterThan": {
+            const compareTo = parseValue(filter.value);
+            return isValueDate ? value > compareTo : value > filter.value;
+        }
+        case "greaterThanOrEqual": {
+            const compareTo = parseValue(filter.value);
+            return isValueDate ? value >= compareTo : value >= filter.value;
+        }
+        case "lessThan":
+            const lt = parseValue(filter.value);
+            return isValueDate ? value < lt : value < filter.value;
+        case "lessThanOrEqual":
+            const lte = parseValue(filter.value);
+            return isValueDate ? value <= lte : value <= filter.value;
+        case "contains":
+            return String(value)
+                .toLowerCase()
+                .includes(String(filter.value).toLowerCase());
+        case "startsWith":
+            return String(value)
+                .toLowerCase()
+                .startsWith(String(filter.value).toLowerCase());
+        case "endsWith":
+            return String(value)
+                .toLowerCase()
+                .endsWith(String(filter.value).toLowerCase());
+        case "in":
+            return Array.isArray(filter.value) && filter.value.includes(value);
+        case "notIn":
+            return Array.isArray(filter.value) && !filter.value.includes(value);
+        case "between":
+            if (Array.isArray(filter.value) && filter.value.length === 2) {
+                const [min, max] = filter.value.map(parseValue);
+                return isValueDate
+                    ? value >= min && value <= max
+                    : value >= filter.value[0] && value <= filter.value[1];
+            }
+            return false;
+        case "isNull":
+            return value === null || value === undefined;
+        case "isNotNull":
+            return value !== null && value !== undefined;
+        default:
+            return true;
+    }
+}
+function getNestedValue(obj, path) {
+    return path.split(".").reduce((current, key) => {
+        if (current === null || current === undefined)
+            return undefined;
+        return current[key];
+    }, obj);
+}
+//# sourceMappingURL=paginated-result.js.map