@nulledexp/translatable-criteria 1.0.0 → 1.0.2

package/dist/criteria/types/join-parameter.types.d.ts

@@ -0,0 +1,70 @@
+import type { CriteriaSchema, FieldOfSchema, JoinRelationType } from './schema.types.js';
+/**
+ * Represents the fully resolved parameters for a many-to-many join,
+ * including details from the parent schema and the specific relation type.
+ * This type is used internally by the Criteria system after processing user input.
+ * @template ParentSchema - The {@link CriteriaSchema} of the parent entity in the join.
+ * @template JoinSchema - The {@link CriteriaSchema} of the entity being joined.
+ * @template TJoinRelationType - The specific {@link JoinRelationType} for this join.
+ */
+export type PivotJoin<ParentSchema extends CriteriaSchema, JoinSchema extends CriteriaSchema, TJoinRelationType extends JoinRelationType> = {
+    /** The type of relationship from the parent to the joined entity (e.g., 'many_to_many'). */
+    parent_to_join_relation_type: TJoinRelationType;
+    /** The source name (e.g., table name) of the parent entity. */
+    parent_source_name: ParentSchema['source_name'];
+    /** The alias used for the parent entity in the query. */
+    parent_alias: ParentSchema['alias'][number];
+    /** The source name (table name) of the pivot table. */
+    pivot_source_name: string;
+    /** Configuration for the join field on the parent side, referencing the pivot table. */
+    parent_field: {
+        /** The field name in the pivot table that links to the parent schema. */
+        pivot_field: string;
+        /**
+         * The field name in the parent schema that the pivot table field references.
+         * Must be a valid field from `ParentSchema['fields']`.
+         * @see FieldOfSchema<ParentSchema>
+         */
+        reference: FieldOfSchema<ParentSchema>;
+    };
+    /** Configuration for the join field on the joined side, referencing the pivot table. */
+    join_field: {
+        /** The field name in the pivot table that links to the joined schema. */
+        pivot_field: string;
+        /**
+         * The field name in the joined schema that the pivot table field references.
+         * Must be a valid field from `JoinSchema['fields']`.
+         * @see FieldOfSchema<JoinSchema>
+         */
+        reference: FieldOfSchema<JoinSchema>;
+    };
+};
+/**
+ * Represents the fully resolved parameters for a simple join (one-to-one, one-to-many, many-to-one),
+ * including details from the parent schema and the specific relation type.
+ * This type is used internally by the Criteria system after processing user input.
+ * @template ParentSchema - The {@link CriteriaSchema} of the parent entity in the join.
+ * @template JoinSchema - The {@link CriteriaSchema} of the entity being joined.
+ * @template TJoinRelationType - The specific {@link JoinRelationType} for this join.
+ */
+export type SimpleJoin<ParentSchema extends CriteriaSchema, JoinSchema extends CriteriaSchema, TJoinRelationType extends JoinRelationType> = {
+    /** The type of relationship from the parent to the joined entity (e.g., 'one_to_one', 'many_to_one'). */
+    parent_to_join_relation_type: TJoinRelationType;
+    /** The source name (e.g., table name) of the parent entity. */
+    parent_source_name: ParentSchema['source_name'];
+    /** The alias used for the parent entity in the query. */
+    parent_alias: ParentSchema['alias'][number];
+    /**
+     * The field name in the parent schema used for the join condition.
+     * Must be a valid field from `ParentSchema['fields']`.
+     * @see FieldOfSchema<ParentSchema>
+     */
+    parent_field: FieldOfSchema<ParentSchema>;
+    /**
+     * The field name in the joined schema used for the join condition.
+     * Must be a valid field from `JoinSchema['fields']`.
+     * @see FieldOfSchema<JoinSchema>
+     */
+    join_field: FieldOfSchema<JoinSchema>;
+};
+//# sourceMappingURL=join-parameter.types.d.ts.map

package/dist/criteria/types/join-parameter.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-parameter.types.d.ts","sourceRoot":"","sources":["../../../src/criteria/types/join-parameter.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,CACnB,YAAY,SAAS,cAAc,EACnC,UAAU,SAAS,cAAc,EACjC,iBAAiB,SAAS,gBAAgB,IACxC;IACF,4FAA4F;IAC5F,4BAA4B,EAAE,iBAAiB,CAAC;IAChD,+DAA+D;IAC/D,kBAAkB,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;IAChD,yDAAyD;IACzD,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAE5C,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,YAAY,EAAE;QACZ,yEAAyE;QACzE,WAAW,EAAE,MAAM,CAAC;QACpB;;;;WAIG;QACH,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;KACxC,CAAC;IACF,wFAAwF;IACxF,UAAU,EAAE;QACV,yEAAyE;QACzE,WAAW,EAAE,MAAM,CAAC;QACpB;;;;WAIG;QACH,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;KACtC,CAAC;CACH,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,CACpB,YAAY,SAAS,cAAc,EACnC,UAAU,SAAS,cAAc,EACjC,iBAAiB,SAAS,gBAAgB,IACxC;IACF,yGAAyG;IACzG,4BAA4B,EAAE,iBAAiB,CAAC;IAChD,+DAA+D;IAC/D,kBAAkB,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;IAChD,yDAAyD;IACzD,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C;;;;OAIG;IACH,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC1C;;;;OAIG;IACH,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACvC,CAAC"}

package/dist/criteria/types/join-parameter.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=join-parameter.types.js.map

package/dist/criteria/types/join-parameter.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-parameter.types.js","sourceRoot":"","sources":["../../../src/criteria/types/join-parameter.types.ts"],"names":[],"mappings":""}

package/dist/criteria/types/join-utility.types.d.ts

@@ -0,0 +1,71 @@
+import type { CriteriaSchema, JoinRelationType, SchemaJoins, SelectedAliasOf } from './schema.types.js';
+import type { PivotJoin, SimpleJoin } from './join-parameter.types.js';
+import type { InnerJoinCriteria } from '../join/inner.join-criteria.js';
+import type { LeftJoinCriteria } from '../join/left.join-criteria.js';
+import type { OuterJoinCriteria } from '../join/outer.join-criteria.js';
+import type { PivotJoinInput, SimpleJoinInput } from './join-input.types.js';
+/**
+ * Represents any type of join criteria (Inner, Left, or Outer).
+ * @template CSchema - The {@link CriteriaSchema} of the entity being joined.
+ * @template Alias - The selected alias for the joined entity from its schema.
+ */
+export type AnyJoinCriteria<CSchema extends CriteriaSchema, Alias extends SelectedAliasOf<CSchema> = SelectedAliasOf<CSchema>> = InnerJoinCriteria<CSchema, Alias> | LeftJoinCriteria<CSchema, Alias> | OuterJoinCriteria<CSchema, Alias>;
+/**
+ * Defines the structure for storing the details of a configured join.
+ * This is used internally by the Criteria system.
+ * @template ParentSchema - The {@link CriteriaSchema} of the parent entity in the join.
+ */
+export interface StoredJoinDetails<ParentSchema extends CriteriaSchema> {
+    /**
+     * The fully resolved parameters for the join, either {@link PivotJoin} or {@link SimpleJoin}.
+     */
+    parameters: PivotJoin<ParentSchema, CriteriaSchema, JoinRelationType> | SimpleJoin<ParentSchema, CriteriaSchema, JoinRelationType>;
+    /**
+     * The criteria instance representing the joined entity (e.g., InnerJoinCriteria).
+     */
+    criteria: AnyJoinCriteria<CriteriaSchema, SelectedAliasOf<CriteriaSchema>>;
+}
+/**
+ * Determines the type of the criteria object to be passed to the `.join()` method.
+ * If the `ActualJoinedAlias` is not a valid join alias in the `ParentSchema`,
+ * this type resolves to an error message string, providing strong type-time feedback.
+ * Otherwise, it resolves to {@link AnyJoinCriteria}.
+ *
+ * @template ParentSchema - The {@link CriteriaSchema} of the parent entity.
+ * @template JoinedSchema - The {@link CriteriaSchema} of the entity to be joined.
+ * @template ActualJoinedAlias - The specific alias used for the `JoinedSchema`.
+ * @template MatchingConfigForActualAlias - The join configuration from `ParentSchema` that matches `ActualJoinedAlias`.
+ *                                         Should be `never` if no match is found.
+ */
+export type JoinCriteriaParameterType<ParentSchema extends CriteriaSchema, JoinedSchema extends CriteriaSchema, ActualJoinedAlias extends SelectedAliasOf<JoinedSchema>, MatchingConfigForActualAlias extends SchemaJoins<string> | never> = [MatchingConfigForActualAlias] extends [never] ? `Error: The alias '${ActualJoinedAlias}' of schema '${JoinedSchema['source_name']}' is not configured for join in '${ParentSchema['source_name']}'.` : AnyJoinCriteria<JoinedSchema, ActualJoinedAlias>;
+/**
+ * Determines the expected shape of the join parameters object passed to the `.join()` method,
+ * based on the `join_relation_type` defined in the `ParentSchema` for the `ActualJoinedAlias`.
+ * If the `ActualJoinedAlias` is not a valid join alias, this type resolves to `never`.
+ * For 'many_to_many' relations, it expects {@link PivotJoinInput}.
+ * For other relations (one-to-one, one-to-many, many-to-one), it expects {@link SimpleJoinInput}.
+ *
+ * @template ParentSchema - The {@link CriteriaSchema} of the parent entity.
+ * @template JoinedSchema - The {@link CriteriaSchema} of the entity to be joined.
+ * @template MatchingConfigForActualAlias - The join configuration from `ParentSchema` that matches the alias of `JoinedSchema`.
+ *                                         Should be `never` if no match is found.
+ */
+export type JoinParameterType<ParentSchema extends CriteriaSchema, JoinedSchema extends CriteriaSchema, MatchingConfigForActualAlias extends SchemaJoins<string> | never> = [MatchingConfigForActualAlias] extends [never] ? never : MatchingConfigForActualAlias['join_relation_type'] extends 'many_to_many' ? PivotJoinInput<ParentSchema, JoinedSchema> : SimpleJoinInput<ParentSchema, JoinedSchema>;
+/**
+ * Extracts the specific join configuration object from the `ParentSchema`'s `joins` array
+ * that matches the provided `JoinedSchemaSpecificAlias`.
+ * This utility type is crucial for inferring the `join_relation_type` and other
+ * join-specific details defined in the parent schema.
+ *
+ * @template ParentSchema - The {@link CriteriaSchema} of the parent entity.
+ * @template JoinedSchemaSpecificAlias - The specific alias of the joined entity,
+ *                                       as defined in the `ParentSchema.joins` configuration.
+ * @example
+ * // Given UserSchema has a join defined as: { alias: 'posts', join_relation_type: 'one_to_many' }
+ * // type UserPostsJoinConfig = SpecificMatchingJoinConfig<typeof UserSchema, 'posts'>;
+ * // UserPostsJoinConfig would be: { alias: 'posts'; join_relation_type: 'one_to_many'; }
+ */
+export type SpecificMatchingJoinConfig<ParentSchema extends CriteriaSchema, JoinedSchemaSpecificAlias extends string> = Extract<ParentSchema['joins'][number], {
+    alias: JoinedSchemaSpecificAlias;
+}>;
+//# sourceMappingURL=join-utility.types.d.ts.map

package/dist/criteria/types/join-utility.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-utility.types.d.ts","sourceRoot":"","sources":["../../../src/criteria/types/join-utility.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,eAAe,CACzB,OAAO,SAAS,cAAc,EAC9B,KAAK,SAAS,eAAe,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,IAE/D,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,GACjC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,GAChC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,YAAY,SAAS,cAAc;IACpE;;OAEG;IACH,UAAU,EACN,SAAS,CAAC,YAAY,EAAE,cAAc,EAAE,gBAAgB,CAAC,GACzD,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC/D;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC,cAAc,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC;CAC5E;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,yBAAyB,CACnC,YAAY,SAAS,cAAc,EACnC,YAAY,SAAS,cAAc,EACnC,iBAAiB,SAAS,eAAe,CAAC,YAAY,CAAC,EACvD,4BAA4B,SAAS,WAAW,CAAC,MAAM,CAAC,GAAG,KAAK,IAC9D,CAAC,4BAA4B,CAAC,SAAS,CAAC,KAAK,CAAC,GAC9C,qBAAqB,iBAAiB,gBAAgB,YAAY,CAAC,aAAa,CAAC,oCAAoC,YAAY,CAAC,aAAa,CAAC,IAAI,GACpJ,eAAe,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,CAC3B,YAAY,SAAS,cAAc,EACnC,YAAY,SAAS,cAAc,EACnC,4BAA4B,SAAS,WAAW,CAAC,MAAM,CAAC,GAAG,KAAK,IAC9D,CAAC,4BAA4B,CAAC,SAAS,CAAC,KAAK,CAAC,GAC9C,KAAK,GACL,4BAA4B,CAAC,oBAAoB,CAAC,SAAS,cAAc,GACvE,cAAc,CAAC,YAAY,EAAE,YAAY,CAAC,GAC1C,eAAe,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,0BAA0B,CACpC,YAAY,SAAS,cAAc,EACnC,yBAAyB,SAAS,MAAM,IACtC,OAAO,CACT,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAC7B;IAAE,KAAK,EAAE,yBAAyB,CAAA;CAAE,CACrC,CAAC"}

package/dist/criteria/types/join-utility.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=join-utility.types.js.map

package/dist/criteria/types/join-utility.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-utility.types.js","sourceRoot":"","sources":["../../../src/criteria/types/join-utility.types.ts"],"names":[],"mappings":""}

package/dist/criteria/types/manager.interface.d.ts

@@ -0,0 +1,59 @@
+import type { FilterGroup } from '../filter/filter-group.js';
+import type { CriteriaSchema, FieldOfSchema, JoinRelationType, SelectedAliasOf } from './schema.types.js';
+import type { FilterPrimitive } from '../filter/types/filter-primitive.types.js';
+import type { PivotJoin, SimpleJoin } from './join-parameter.types.js';
+import type { AnyJoinCriteria, StoredJoinDetails } from './join-utility.types.js';
+import type { FilterOperator } from './operator.types.js';
+/**
+ * Defines the contract for managing filter conditions within a Criteria object.
+ * @template CSchema - The {@link CriteriaSchema} of the entity to which filters are applied.
+ */
+export interface IFilterManager<CSchema extends CriteriaSchema> {
+    /**
+     * Initializes the filter criteria with a single filter primitive.
+     * This replaces any existing filters.
+     * @param {FilterPrimitive<FieldOfSchema<CSchema>>} filterPrimitive - The filter to apply.
+     * @throws {Error} If the specified field in filterPrimitive is not defined in the schema.
+     */
+    where<Operator extends FilterOperator>(filterPrimitive: FilterPrimitive<FieldOfSchema<CSchema>, Operator>): void;
+    /**
+     * Adds a filter primitive to the current filter group using an AND logical operator.
+     * @param {FilterPrimitive<FieldOfSchema<CSchema>>} filterPrimitive - The filter to add.
+     * @throws {Error} If the specified field in filterPrimitive is not defined in the schema.
+     * @throws {Error} If `where()` has not been called first.
+     */
+    andWhere<Operator extends FilterOperator>(filterPrimitive: FilterPrimitive<FieldOfSchema<CSchema>, Operator>): void;
+    /**
+     * Adds a filter primitive, creating a new OR group with the existing filters.
+     * @param {FilterPrimitive<FieldOfSchema<CSchema>>} filterPrimitive - The filter to add.
+     * @throws {Error} If the specified field in filterPrimitive is not defined in the schema.
+     * @throws {Error} If `where()` has not been called first.
+     */
+    orWhere<Operator extends FilterOperator>(filterPrimitive: FilterPrimitive<FieldOfSchema<CSchema>, Operator>): void;
+    /**
+     * Retrieves the root filter group containing all applied filter conditions.
+     * @returns {FilterGroup} The root {@link FilterGroup}.
+     */
+    getRootFilterGroup(): FilterGroup;
+}
+/**
+ * Defines the contract for managing join operations within a Criteria object.
+ * @template CSchema - The {@link CriteriaSchema} of the parent entity from which joins are made.
+ */
+export interface IJoinManager<CSchema extends CriteriaSchema> {
+    /**
+     * Adds a join configuration to the Criteria.
+     * @template JoinSchema - The {@link CriteriaSchema} of the entity being joined.
+     * @param {AnyJoinCriteria<JoinSchema, SelectedAliasOf<JoinSchema>>} criteriaToJoin -
+     *   The criteria instance representing the entity to join (e.g., InnerJoinCriteria, LeftJoinCriteria).
+     * @param {PivotJoin<CSchema, JoinSchema, JoinRelationType> | SimpleJoin<CSchema, JoinSchema, JoinRelationType>} joinParameter -
+     *   The fully resolved parameters defining how the join should be performed.
+     */
+    addJoin<JoinSchema extends CriteriaSchema>(criteriaToJoin: AnyJoinCriteria<JoinSchema, SelectedAliasOf<JoinSchema>>, joinParameter: PivotJoin<CSchema, JoinSchema, JoinRelationType> | SimpleJoin<CSchema, JoinSchema, JoinRelationType>): void;
+    /**
+     * Retrieves all configured join details.
+     * @returns {Array<StoredJoinDetails<CSchema>>} An array of {@link StoredJoinDetails}.
+     */
+    getJoins(): Array<StoredJoinDetails<CSchema>>;
+}
+//# sourceMappingURL=manager.interface.d.ts.map

package/dist/criteria/types/manager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.interface.d.ts","sourceRoot":"","sources":["../../../src/criteria/types/manager.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,cAAc;IAC5D;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,SAAS,cAAc,EACnC,eAAe,EAAE,eAAe,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GACjE,IAAI,CAAC;IAER;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,SAAS,cAAc,EACtC,eAAe,EAAE,eAAe,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GACjE,IAAI,CAAC;IAER;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,SAAS,cAAc,EACrC,eAAe,EAAE,eAAe,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GACjE,IAAI,CAAC;IAER;;;OAGG;IACH,kBAAkB,IAAI,WAAW,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,cAAc;IAC1D;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU,SAAS,cAAc,EACvC,cAAc,EAAE,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,EACxE,aAAa,EACT,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,gBAAgB,CAAC,GAChD,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,gBAAgB,CAAC,GACpD,IAAI,CAAC;IAER;;;OAGG;IACH,QAAQ,IAAI,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/C"}

package/dist/criteria/types/manager.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manager.interface.js.map

package/dist/criteria/types/manager.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.interface.js","sourceRoot":"","sources":["../../../src/criteria/types/manager.interface.ts"],"names":[],"mappings":""}

package/dist/criteria/types/operator.types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Enumerates the available filter operators for comparing field values.
+ */
+export declare enum FilterOperator {
+    /** Checks for equality. */
+    EQUALS = "=",
+    /** Checks for inequality. */
+    NOT_EQUALS = "!=",
+    /** Checks if a value is greater than another. */
+    GREATER_THAN = ">",
+    /** Checks if a value is greater than or equal to another. */
+    GREATER_THAN_OR_EQUALS = ">=",
+    /** Checks if a value is less than another. */
+    LESS_THAN = "<",
+    /** Checks if a value is less than or equal to another. */
+    LESS_THAN_OR_EQUALS = "<=",
+    /** Checks if a string value matches a pattern (often case-sensitive, depends on DB). */
+    LIKE = "LIKE",
+    /** Checks if a string value does not match a pattern. */
+    NOT_LIKE = "NOT LIKE",
+    /** Checks if a value is within a set of specified values. */
+    IN = "IN",
+    /** Checks if a value is not within a set of specified values. */
+    NOT_IN = "NOT IN",
+    /** Checks if a value is NULL. */
+    IS_NULL = "IS NULL",
+    /** Checks if a value is NOT NULL. */
+    IS_NOT_NULL = "IS NOT NULL",
+    /** Checks if a string value contains a specific substring (often case-insensitive, depends on DB). */
+    CONTAINS = "CONTAINS",
+    /** Checks if a string value starts with a specific substring. */
+    STARTS_WITH = "STARTS_WITH",
+    /** Checks if a string value ends with a specific substring. */
+    ENDS_WITH = "ENDS_WITH",
+    /** Checks if a string value does not contain a specific substring. */
+    NOT_CONTAINS = "NOT_CONTAINS",
+    /**
+     * Checks if a field, representing a collection of predefined choices
+     * (where multiple can be selected), contains a specific choice.
+     * The specific database implementation might vary (e.g., MySQL SET type,
+     * a text field with delimited values, or a JSON array).
+     */
+    SET_CONTAINS = "SET_CONTAINS",
+    /**
+     * Checks if a field, representing a collection of predefined choices
+     * (where multiple can be selected), does NOT contain a specific choice.
+     * The specific database implementation might vary.
+     */
+    SET_NOT_CONTAINS = "SET_NOT_CONTAINS",
+    /**
+     * Checks if a JSON column contains a specific value or path.
+     * The specific implementation depends on the database (e.g., JSON_CONTAINS in MySQL, @> in PostgreSQL for JSONB).
+     */
+    JSON_CONTAINS = "JSON_CONTAINS",
+    /**
+     * Checks if a JSON column does not contain a specific value or path.
+     * The specific implementation depends on the database.
+     */
+    JSON_NOT_CONTAINS = "JSON_NOT_CONTAINS",
+    /**
+     * Checks if a column representing an array contains a specific element.
+     * The underlying column could be a native array type (e.g., PostgreSQL)
+     * or a JSON array (e.g., MySQL).
+     */
+    ARRAY_CONTAINS_ELEMENT = "ARRAY_CONTAINS_ELEMENT",
+    /**
+     * Checks if a column representing an array contains ALL elements from the provided array.
+     * The underlying column could be a native array type or a JSON array.
+     */
+    ARRAY_CONTAINS_ALL_ELEMENTS = "ARRAY_CONTAINS_ALL_ELEMENTS",
+    /**
+     * Checks if a column representing an array contains AT LEAST ONE element from the provided array.
+     * The underlying column could be a native array type or a JSON array.
+     */
+    ARRAY_CONTAINS_ANY_ELEMENT = "ARRAY_CONTAINS_ANY_ELEMENT",
+    /**
+     * Checks if a column representing an array is exactly equal to the provided array
+     * (order and elements must match).
+     * The underlying column could be a native array type or a JSON array.
+     */
+    ARRAY_EQUALS = "ARRAY_EQUALS"
+}
+/**
+ * Enumerates the logical operators used to combine filter conditions or groups.
+ */
+export declare enum LogicalOperator {
+    /** Combines conditions with a logical AND. All conditions must be true. */
+    AND = "AND",
+    /** Combines conditions with a logical OR. At least one condition must be true. */
+    OR = "OR"
+}
+//# sourceMappingURL=operator.types.d.ts.map

package/dist/criteria/types/operator.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator.types.d.ts","sourceRoot":"","sources":["../../../src/criteria/types/operator.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,cAAc;IACxB,2BAA2B;IAC3B,MAAM,MAAM;IACZ,6BAA6B;IAC7B,UAAU,OAAO;IACjB,iDAAiD;IACjD,YAAY,MAAM;IAClB,6DAA6D;IAC7D,sBAAsB,OAAO;IAC7B,8CAA8C;IAC9C,SAAS,MAAM;IACf,0DAA0D;IAC1D,mBAAmB,OAAO;IAC1B,wFAAwF;IACxF,IAAI,SAAS;IACb,yDAAyD;IACzD,QAAQ,aAAa;IACrB,6DAA6D;IAC7D,EAAE,OAAO;IACT,iEAAiE;IACjE,MAAM,WAAW;IACjB,iCAAiC;IACjC,OAAO,YAAY;IACnB,qCAAqC;IACrC,WAAW,gBAAgB;IAC3B,sGAAsG;IACtG,QAAQ,aAAa;IACrB,iEAAiE;IACjE,WAAW,gBAAgB;IAC3B,+DAA+D;IAC/D,SAAS,cAAc;IACvB,sEAAsE;IACtE,YAAY,iBAAiB;IAC7B;;;;;OAKG;IACH,YAAY,iBAAiB;IAC7B;;;;OAIG;IACH,gBAAgB,qBAAqB;IAErC;;;OAGG;IACH,aAAa,kBAAkB;IAC/B;;;OAGG;IACH,iBAAiB,sBAAsB;IAGvC;;;;OAIG;IACH,sBAAsB,2BAA2B;IACjD;;;OAGG;IACH,2BAA2B,gCAAgC;IAC3D;;;OAGG;IACH,0BAA0B,+BAA+B;IACzD;;;;OAIG;IACH,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,2EAA2E;IAC3E,GAAG,QAAQ;IACX,kFAAkF;IAClF,EAAE,OAAO;CACV"}

package/dist/criteria/types/operator.types.js

@@ -0,0 +1,95 @@
+/**
+ * Enumerates the available filter operators for comparing field values.
+ */
+export var FilterOperator;
+(function (FilterOperator) {
+    /** Checks for equality. */
+    FilterOperator["EQUALS"] = "=";
+    /** Checks for inequality. */
+    FilterOperator["NOT_EQUALS"] = "!=";
+    /** Checks if a value is greater than another. */
+    FilterOperator["GREATER_THAN"] = ">";
+    /** Checks if a value is greater than or equal to another. */
+    FilterOperator["GREATER_THAN_OR_EQUALS"] = ">=";
+    /** Checks if a value is less than another. */
+    FilterOperator["LESS_THAN"] = "<";
+    /** Checks if a value is less than or equal to another. */
+    FilterOperator["LESS_THAN_OR_EQUALS"] = "<=";
+    /** Checks if a string value matches a pattern (often case-sensitive, depends on DB). */
+    FilterOperator["LIKE"] = "LIKE";
+    /** Checks if a string value does not match a pattern. */
+    FilterOperator["NOT_LIKE"] = "NOT LIKE";
+    /** Checks if a value is within a set of specified values. */
+    FilterOperator["IN"] = "IN";
+    /** Checks if a value is not within a set of specified values. */
+    FilterOperator["NOT_IN"] = "NOT IN";
+    /** Checks if a value is NULL. */
+    FilterOperator["IS_NULL"] = "IS NULL";
+    /** Checks if a value is NOT NULL. */
+    FilterOperator["IS_NOT_NULL"] = "IS NOT NULL";
+    /** Checks if a string value contains a specific substring (often case-insensitive, depends on DB). */
+    FilterOperator["CONTAINS"] = "CONTAINS";
+    /** Checks if a string value starts with a specific substring. */
+    FilterOperator["STARTS_WITH"] = "STARTS_WITH";
+    /** Checks if a string value ends with a specific substring. */
+    FilterOperator["ENDS_WITH"] = "ENDS_WITH";
+    /** Checks if a string value does not contain a specific substring. */
+    FilterOperator["NOT_CONTAINS"] = "NOT_CONTAINS";
+    /**
+     * Checks if a field, representing a collection of predefined choices
+     * (where multiple can be selected), contains a specific choice.
+     * The specific database implementation might vary (e.g., MySQL SET type,
+     * a text field with delimited values, or a JSON array).
+     */
+    FilterOperator["SET_CONTAINS"] = "SET_CONTAINS";
+    /**
+     * Checks if a field, representing a collection of predefined choices
+     * (where multiple can be selected), does NOT contain a specific choice.
+     * The specific database implementation might vary.
+     */
+    FilterOperator["SET_NOT_CONTAINS"] = "SET_NOT_CONTAINS";
+    /**
+     * Checks if a JSON column contains a specific value or path.
+     * The specific implementation depends on the database (e.g., JSON_CONTAINS in MySQL, @> in PostgreSQL for JSONB).
+     */
+    FilterOperator["JSON_CONTAINS"] = "JSON_CONTAINS";
+    /**
+     * Checks if a JSON column does not contain a specific value or path.
+     * The specific implementation depends on the database.
+     */
+    FilterOperator["JSON_NOT_CONTAINS"] = "JSON_NOT_CONTAINS";
+    // --- Array Operators ---
+    /**
+     * Checks if a column representing an array contains a specific element.
+     * The underlying column could be a native array type (e.g., PostgreSQL)
+     * or a JSON array (e.g., MySQL).
+     */
+    FilterOperator["ARRAY_CONTAINS_ELEMENT"] = "ARRAY_CONTAINS_ELEMENT";
+    /**
+     * Checks if a column representing an array contains ALL elements from the provided array.
+     * The underlying column could be a native array type or a JSON array.
+     */
+    FilterOperator["ARRAY_CONTAINS_ALL_ELEMENTS"] = "ARRAY_CONTAINS_ALL_ELEMENTS";
+    /**
+     * Checks if a column representing an array contains AT LEAST ONE element from the provided array.
+     * The underlying column could be a native array type or a JSON array.
+     */
+    FilterOperator["ARRAY_CONTAINS_ANY_ELEMENT"] = "ARRAY_CONTAINS_ANY_ELEMENT";
+    /**
+     * Checks if a column representing an array is exactly equal to the provided array
+     * (order and elements must match).
+     * The underlying column could be a native array type or a JSON array.
+     */
+    FilterOperator["ARRAY_EQUALS"] = "ARRAY_EQUALS";
+})(FilterOperator || (FilterOperator = {}));
+/**
+ * Enumerates the logical operators used to combine filter conditions or groups.
+ */
+export var LogicalOperator;
+(function (LogicalOperator) {
+    /** Combines conditions with a logical AND. All conditions must be true. */
+    LogicalOperator["AND"] = "AND";
+    /** Combines conditions with a logical OR. At least one condition must be true. */
+    LogicalOperator["OR"] = "OR";
+})(LogicalOperator || (LogicalOperator = {}));
+//# sourceMappingURL=operator.types.js.map

package/dist/criteria/types/operator.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator.types.js","sourceRoot":"","sources":["../../../src/criteria/types/operator.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,cAiFX;AAjFD,WAAY,cAAc;IACxB,2BAA2B;IAC3B,8BAAY,CAAA;IACZ,6BAA6B;IAC7B,mCAAiB,CAAA;IACjB,iDAAiD;IACjD,oCAAkB,CAAA;IAClB,6DAA6D;IAC7D,+CAA6B,CAAA;IAC7B,8CAA8C;IAC9C,iCAAe,CAAA;IACf,0DAA0D;IAC1D,4CAA0B,CAAA;IAC1B,wFAAwF;IACxF,+BAAa,CAAA;IACb,yDAAyD;IACzD,uCAAqB,CAAA;IACrB,6DAA6D;IAC7D,2BAAS,CAAA;IACT,iEAAiE;IACjE,mCAAiB,CAAA;IACjB,iCAAiC;IACjC,qCAAmB,CAAA;IACnB,qCAAqC;IACrC,6CAA2B,CAAA;IAC3B,sGAAsG;IACtG,uCAAqB,CAAA;IACrB,iEAAiE;IACjE,6CAA2B,CAAA;IAC3B,+DAA+D;IAC/D,yCAAuB,CAAA;IACvB,sEAAsE;IACtE,+CAA6B,CAAA;IAC7B;;;;;OAKG;IACH,+CAA6B,CAAA;IAC7B;;;;OAIG;IACH,uDAAqC,CAAA;IAErC;;;OAGG;IACH,iDAA+B,CAAA;IAC/B;;;OAGG;IACH,yDAAuC,CAAA;IAEvC,0BAA0B;IAC1B;;;;OAIG;IACH,mEAAiD,CAAA;IACjD;;;OAGG;IACH,6EAA2D,CAAA;IAC3D;;;OAGG;IACH,2EAAyD,CAAA;IACzD;;;;OAIG;IACH,+CAA6B,CAAA;AAC/B,CAAC,EAjFW,cAAc,KAAd,cAAc,QAiFzB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,2EAA2E;IAC3E,8BAAW,CAAA;IACX,kFAAkF;IAClF,4BAAS,CAAA;AACX,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B"}

package/dist/criteria/types/schema.types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Defines the type of relationship for a join.
+ */
+export type JoinRelationType = 'one_to_one' | 'one_to_many' | 'many_to_one' | 'many_to_many';
+/**
+ * Describes the configuration for a joinable relation within a {@link CriteriaSchema}.
+ * @template ValidAlias - A string literal type representing a valid alias for the join.
+ */
+export type SchemaJoins<ValidAlias extends string> = {
+    /** The alias used to refer to this join in criteria construction. */
+    alias: ValidAlias;
+    /** The type of relationship this join represents (e.g., 'one_to_many'). */
+    join_relation_type: JoinRelationType;
+};
+/**
+ * Represents the schema definition for an entity, used by the Criteria system.
+ * It defines the entity's source name (e.g., table name), available aliases,
+ * fields, and joinable relations.
+ * @template TFields - A readonly array of string literal types representing the entity's field names.
+ * @template TAliases - A readonly array of string literal types representing the entity's valid aliases.
+ * @template TSourceName - A string literal type for the entity's source name.
+ * @template JoinsAlias - A string literal type representing valid aliases for its joinable relations.
+ */
+export type CriteriaSchema<TFields extends ReadonlyArray<string> = ReadonlyArray<string>, TAliases extends ReadonlyArray<string> = ReadonlyArray<string>, TSourceName extends string = string, JoinsAlias extends string = string> = {
+    /** The source name of the entity (e.g., database table name). */
+    source_name: TSourceName;
+    /** An array of valid aliases that can be used to refer to this entity. */
+    alias: TAliases;
+    /** An array of field names available for this entity. */
+    fields: TFields;
+    /** An array of configurations for entities that can be joined from this entity. */
+    joins: ReadonlyArray<SchemaJoins<JoinsAlias>>;
+};
+/**
+ * A helper function to infer and preserve the literal types of a schema definition.
+ * Use this when defining schemas to get strong typing for fields, aliases, etc.
+ * @template TInput - The type of the schema object being passed.
+ * @param {TInput} schema - The schema definition object.
+ * @returns {TInput} The same schema object, with its literal types preserved.
+ * @example
+ * export const UserSchema = GetTypedCriteriaSchema({
+ *   source_name: 'users_table',
+ *   alias: ['user', 'u'],
+ *   fields: ['id', 'name', 'email'],
+ *   joins: [{ alias: 'posts', join_relation_type: 'one_to_many' }]
+ * });
+ */
+export declare function GetTypedCriteriaSchema<const TInput extends CriteriaSchema>(schema: TInput): TInput;
+/**
+ * Extracts a union type of all valid field names from a given {@link CriteriaSchema}.
+ * @template T - The {@link CriteriaSchema} from which to extract field names.
+ * @example type UserFields = FieldOfSchema<typeof UserSchema>; // "id" | "name" | "email"
+ */
+export type FieldOfSchema<T extends CriteriaSchema> = T['fields'] extends ReadonlyArray<string> ? T['fields'][number] : never;
+/**
+ * Extracts a union type of all valid aliases from a given {@link CriteriaSchema}.
+ * @template T - The {@link CriteriaSchema} from which to extract aliases.
+ * @example type UserAliases = SelectedAliasOf<typeof UserSchema>; // "user" | "u"
+ */
+export type SelectedAliasOf<T extends CriteriaSchema> = T['alias'] extends ReadonlyArray<string> ? T['alias'][number] : never;
+//# sourceMappingURL=schema.types.d.ts.map

package/dist/criteria/types/schema.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.types.d.ts","sourceRoot":"","sources":["../../../src/criteria/types/schema.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,aAAa,GACb,aAAa,GACb,cAAc,CAAC;AAEnB;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,UAAU,SAAS,MAAM,IAAI;IACnD,qEAAqE;IACrE,KAAK,EAAE,UAAU,CAAC;IAClB,2EAA2E;IAC3E,kBAAkB,EAAE,gBAAgB,CAAC;CACtC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,CACxB,OAAO,SAAS,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,EAC7D,QAAQ,SAAS,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,EAC9D,WAAW,SAAS,MAAM,GAAG,MAAM,EACnC,UAAU,SAAS,MAAM,GAAG,MAAM,IAChC;IACF,iEAAiE;IACjE,WAAW,EAAE,WAAW,CAAC;IACzB,0EAA0E;IAC1E,KAAK,EAAE,QAAQ,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC;IAChB,mFAAmF;IACnF,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,MAAM,SAAS,cAAc,EACxE,MAAM,EAAE,MAAM,GACb,MAAM,CAER;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,cAAc,IAChD,CAAC,CAAC,QAAQ,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,cAAc,IAClD,CAAC,CAAC,OAAO,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC"}

package/dist/criteria/types/schema.types.js

@@ -0,0 +1,18 @@
+/**
+ * A helper function to infer and preserve the literal types of a schema definition.
+ * Use this when defining schemas to get strong typing for fields, aliases, etc.
+ * @template TInput - The type of the schema object being passed.
+ * @param {TInput} schema - The schema definition object.
+ * @returns {TInput} The same schema object, with its literal types preserved.
+ * @example
+ * export const UserSchema = GetTypedCriteriaSchema({
+ *   source_name: 'users_table',
+ *   alias: ['user', 'u'],
+ *   fields: ['id', 'name', 'email'],
+ *   joins: [{ alias: 'posts', join_relation_type: 'one_to_many' }]
+ * });
+ */
+export function GetTypedCriteriaSchema(schema) {
+    return schema;
+}
+//# sourceMappingURL=schema.types.js.map

package/dist/criteria/types/schema.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.types.js","sourceRoot":"","sources":["../../../src/criteria/types/schema.types.ts"],"names":[],"mappings":"AA6CA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAc;IAEd,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/criteria/types/visitor-interface.types.d.ts

@@ -0,0 +1,24 @@
+import type { RootCriteria } from '../root.criteria.js';
+import type { InnerJoinCriteria } from '../join/inner.join-criteria.js';
+import type { LeftJoinCriteria } from '../join/left.join-criteria.js';
+import type { OuterJoinCriteria } from '../join/outer.join-criteria.js';
+import type { Filter } from '../filter/filter.js';
+import type { FilterGroup } from '../filter/filter-group.js';
+import type { CriteriaSchema, JoinRelationType, SelectedAliasOf } from './schema.types.js';
+import type { PivotJoin, SimpleJoin } from './join-parameter.types.js';
+import type { FilterOperator } from './operator.types.js';
+/**
+ * Visitor interface for traversing Criteria objects.
+ * @template TranslationContext - The type of the context object passed during traversal.
+ * @template TranslationOutput - The type of the result returned by visitor methods.
+ */
+export interface ICriteriaVisitor<TranslationContext, TranslationOutput = TranslationContext, TFilterVisitorOutput extends any = any> {
+    visitRoot<RootCSchema extends CriteriaSchema, RootAlias extends SelectedAliasOf<RootCSchema>>(criteria: RootCriteria<RootCSchema, RootAlias>, context: TranslationContext): TranslationOutput;
+    visitInnerJoin<ParentCSchema extends CriteriaSchema, JoinCSchema extends CriteriaSchema, JoinAlias extends SelectedAliasOf<JoinCSchema>>(criteria: InnerJoinCriteria<JoinCSchema, JoinAlias>, parameters: PivotJoin<ParentCSchema, JoinCSchema, JoinRelationType> | SimpleJoin<ParentCSchema, JoinCSchema, JoinRelationType>, context: TranslationContext): TranslationOutput;
+    visitLeftJoin<ParentCSchema extends CriteriaSchema, JoinCSchema extends CriteriaSchema, JoinAlias extends SelectedAliasOf<JoinCSchema>>(criteria: LeftJoinCriteria<JoinCSchema, JoinAlias>, parameters: PivotJoin<ParentCSchema, JoinCSchema, JoinRelationType> | SimpleJoin<ParentCSchema, JoinCSchema, JoinRelationType>, context: TranslationContext): TranslationOutput;
+    visitOuterJoin<ParentCSchema extends CriteriaSchema, JoinCSchema extends CriteriaSchema, JoinAlias extends SelectedAliasOf<JoinCSchema>>(criteria: OuterJoinCriteria<JoinCSchema, JoinAlias>, parameters: PivotJoin<ParentCSchema, JoinCSchema, JoinRelationType> | SimpleJoin<ParentCSchema, JoinCSchema, JoinRelationType>, context: TranslationContext): TranslationOutput;
+    visitFilter<FieldType extends string>(filter: Filter<FieldType, FilterOperator>, currentAlias: string): TFilterVisitorOutput;
+    visitAndGroup<FieldType extends string>(group: FilterGroup<FieldType>, currentAlias: string, context: TranslationContext): TranslationOutput;
+    visitOrGroup<FieldType extends string>(group: FilterGroup<FieldType>, currentAlias: string, context: TranslationContext): TranslationOutput;
+}
+//# sourceMappingURL=visitor-interface.types.d.ts.map

package/dist/criteria/types/visitor-interface.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-interface.types.d.ts","sourceRoot":"","sources":["../../../src/criteria/types/visitor-interface.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAC/B,kBAAkB,EAClB,iBAAiB,GAAG,kBAAkB,EACtC,oBAAoB,SAAS,GAAG,GAAG,GAAG;IAEtC,SAAS,CACP,WAAW,SAAS,cAAc,EAClC,SAAS,SAAS,eAAe,CAAC,WAAW,CAAC,EAE9C,QAAQ,EAAE,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,EAC9C,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAAC;IAErB,cAAc,CACZ,aAAa,SAAS,cAAc,EACpC,WAAW,SAAS,cAAc,EAClC,SAAS,SAAS,eAAe,CAAC,WAAW,CAAC,EAE9C,QAAQ,EAAE,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC,EACnD,UAAU,EACN,SAAS,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,CAAC,GACvD,UAAU,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,CAAC,EAC5D,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAAC;IAErB,aAAa,CACX,aAAa,SAAS,cAAc,EACpC,WAAW,SAAS,cAAc,EAClC,SAAS,SAAS,eAAe,CAAC,WAAW,CAAC,EAE9C,QAAQ,EAAE,gBAAgB,CAAC,WAAW,EAAE,SAAS,CAAC,EAClD,UAAU,EACN,SAAS,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,CAAC,GACvD,UAAU,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,CAAC,EAC5D,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAAC;IAErB,cAAc,CACZ,aAAa,SAAS,cAAc,EACpC,WAAW,SAAS,cAAc,EAClC,SAAS,SAAS,eAAe,CAAC,WAAW,CAAC,EAE9C,QAAQ,EAAE,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC,EACnD,UAAU,EACN,SAAS,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,CAAC,GACvD,UAAU,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,CAAC,EAC5D,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAAC;IAErB,WAAW,CAAC,SAAS,SAAS,MAAM,EAClC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,EACzC,YAAY,EAAE,MAAM,GACnB,oBAAoB,CAAC;IAExB,aAAa,CAAC,SAAS,SAAS,MAAM,EACpC,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,EAC7B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAAC;IAErB,YAAY,CAAC,SAAS,SAAS,MAAM,EACnC,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,EAC7B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAAC;CACtB"}

package/dist/criteria/types/visitor-interface.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=visitor-interface.types.js.map

package/dist/criteria/types/visitor-interface.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-interface.types.js","sourceRoot":"","sources":["../../../src/criteria/types/visitor-interface.types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './criteria/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './criteria/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nulledexp/translatable-criteria",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "license": "MIT",
   "description": "A TypeScript library for building data-source agnostic, translatable query criteria. Define complex filtering, ordering, and join logic in a structured, type-safe way, then translate it to your specific data source using custom translators.",
   "keywords": [