@nulledexp/translatable-criteria 1.0.4 → 1.2.0

package/README.md

@@ -54,7 +54,7 @@ export const UserSchema = GetTypedCriteriaSchema({
   alias: ['users', 'user', 'publisher'],
   fields: ['uuid', 'email', 'username', 'created_at'],
   joins: [
-    { alias: 'posts', join_relation_type: 'one_to_many' },
+    { alias: 'posts', relation_type: 'one_to_many' },
     // other joins like 'permissions', 'addresses' can be defined here
   ],
 });
@@ -73,8 +73,8 @@ export const PostSchema = GetTypedCriteriaSchema({
     'metadata', // Example: for JSON filters
   ],
   joins: [
-    { alias: 'comments', join_relation_type: 'one_to_many' },
-    { alias: 'publisher', join_relation_type: 'many_to_one' },
+    { alias: 'comments', relation_type: 'one_to_many' },
+    { alias: 'publisher', relation_type: 'many_to_one' },
   ],
 });
 export type PostSchema = typeof PostSchema;

package/dist/criteria/criteria.d.ts

@@ -3,8 +3,17 @@ import { Cursor } from './cursor.js';
 import { Order, OrderDirection } from './order/order.js';
 import type { FilterPrimitive } from './filter/types/filter-primitive.types.js';
 import type { ICriteriaBase } from './types/criteria.interface.js';
-import type { JoinCriteriaParameterType, JoinParameterType, SpecificMatchingJoinConfig } from './types/join-utility.types.js';
+import type { JoinCriteriaParameterType, JoinParameterType, SpecificMatchingJoinConfig, StoredJoinDetails } from './types/join-utility.types.js';
 import { FilterOperator } from './types/operator.types.js';
+import type { FilterGroup } from './filter/filter-group.js';
+/**
+ * Abstract base class for constructing query criteria.
+ * It provides a fluent API for defining filters, joins, selections, ordering, and pagination.
+ * Concrete criteria types (e.g., RootCriteria, JoinCriteria) will extend this class.
+ *
+ * @template TSchema - The schema definition for the entity this criteria operates on.
+ * @template CurrentAlias - The selected alias for the entity from its schema.
+ */
 export declare abstract class Criteria<TSchema extends CriteriaSchema, CurrentAlias extends SelectedAliasOf<TSchema> = SelectedAliasOf<TSchema>> implements ICriteriaBase<TSchema, CurrentAlias> {
     protected readonly schema: TSchema;
     protected _alias: CurrentAlias;
@@ -12,37 +21,200 @@ export declare abstract class Criteria<TSchema extends CriteriaSchema, CurrentAl
     private readonly _joinManager;
     private readonly _source_name;
     private _take;
+    /**
+     * Stores the set of fields explicitly selected by the user.
+     * This is used when `_selectAll` is false.
+     * @protected
+     */
     protected _select: Set<FieldOfSchema<TSchema>>;
     private _selectAll;
+    /**
+     * Stores the cursor configuration for pagination, if set.
+     * @protected
+     */
     protected _cursor: Cursor<FieldOfSchema<TSchema>, FilterOperator.GREATER_THAN | FilterOperator.LESS_THAN> | undefined;
+    /**
+     * Initializes a new instance of the Criteria class.
+     * @param {TSchema} schema - The schema definition for the entity.
+     * @param {CurrentAlias} _alias - The alias to use for this entity in the query.
+     * @throws {Error} If the provided alias is not supported by the schema.
+     * @protected
+     */
     constructor(schema: TSchema, _alias: CurrentAlias);
-    get select(): FieldOfSchema<TSchema>[];
-    abstract resetCriteria(): ICriteriaBase<TSchema, CurrentAlias>;
+    /**
+     * Gets the currently selected fields.
+     * If `_selectAll` is true, it returns all fields from the schema.
+     * Otherwise, it returns the fields explicitly set via `setSelect`.
+     * @returns {Array<FieldOfSchema<TSchema>>} An array of selected field names.
+     */
+    get select(): Array<FieldOfSchema<TSchema>>;
+    /**
+     * Resets the selection to include all fields from the schema.
+     * Subsequent calls to `get select()` will return all schema fields
+     * until `setSelect()` is called again.
+     * @returns {this} The current criteria instance for chaining.
+     */
     resetSelect(): this;
+    /**
+     * Indicates whether all fields are currently configured to be selected.
+     * @returns {boolean} True if all fields are selected, false if specific fields are selected.
+     */
     get selectAll(): boolean;
+    /**
+     * Specifies which fields to select for the entity.
+     * Calling this method sets `selectAll` to false.
+     * @param {Array<FieldOfSchema<TSchema>>} selectFields - An array of field names to select.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If any of the specified fields are not defined in the schema.
+     */
     setSelect(selectFields: Array<FieldOfSchema<TSchema>>): this;
+    /**
+     * Gets the maximum number of records to return (LIMIT).
+     * @returns {number} The take value.
+     */
     get take(): number;
     private _skip;
+    /**
+     * Gets the number of records to skip (OFFSET).
+     * @returns {number} The skip value.
+     */
     get skip(): number;
     private _orders;
+    /**
+     * Gets the current ordering rules applied to this criteria.
+     * @returns {ReadonlyArray<Order<FieldOfSchema<TSchema>>>} A readonly array of order objects.
+     */
     get orders(): ReadonlyArray<Order<FieldOfSchema<TSchema>>>;
-    get joins(): import("./types/join-utility.types.js").StoredJoinDetails<TSchema>[];
-    get rootFilterGroup(): import("./index.js").FilterGroup<string>;
-    get sourceName(): TSchema["source_name"];
+    /**
+     * Gets the configured join details for this criteria.
+     * @returns {ReadonlyArray<StoredJoinDetails<TSchema>>} A readonly array of join configurations.
+     */
+    get joins(): ReadonlyArray<StoredJoinDetails<TSchema>>;
+    /**
+     * Gets the root filter group for this criteria, which holds all filter conditions.
+     * @returns {FilterGroup} The root filter group.
+     */
+    get rootFilterGroup(): FilterGroup;
+    /**
+     * Gets the source name (e.g., table name) for the entity of this criteria.
+     * @returns {TSchema['source_name']} The source name string.
+     */
+    get sourceName(): TSchema['source_name'];
+    /**
+     * Gets the alias used for the entity of this criteria.
+     * @returns {CurrentAlias} The alias string.
+     */
     get alias(): CurrentAlias;
+    /**
+     * Sets the maximum number of records to return (LIMIT).
+     * @param {number} amount - The number of records to take. Must be non-negative.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the amount is negative.
+     */
     setTake(amount: number): this;
+    /**
+     * Sets the number of records to skip before starting to return records (OFFSET).
+     * @param {number} amount - The number of records to skip. Must be non-negative.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the amount is negative.
+     */
     setSkip(amount: number): this;
+    /**
+     * Asserts that a given field name is defined within the current criteria's schema.
+     * This is a protected utility method used internally to validate field names
+     * before they are used in filters, ordering, or selections.
+     *
+     * @protected
+     * @param {FieldOfSchema<TSchema>} field - The field name to validate.
+     * @throws {Error} If the field is not defined in the schema.
+     */
     protected assetFieldOnSchema(field: FieldOfSchema<TSchema>): void;
+    /**
+     * Adds an ordering rule to the criteria.
+     * Multiple calls will append new ordering rules.
+     * @param {FieldOfSchema<TSchema>} field - The field to order by.
+     * @param {OrderDirection} direction - The direction of the ordering (ASC or DESC).
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the specified field is not defined in the schema.
+     */
     orderBy(field: FieldOfSchema<TSchema>, direction: OrderDirection): this;
+    /**
+     * Initializes the filter criteria with a single filter primitive.
+     * This replaces any existing filters in the root filter group.
+     * @template Operator - The specific filter operator type.
+     * @param {FilterPrimitive<FieldOfSchema<TSchema>, Operator>} filterPrimitive - The filter to apply.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the specified field in filterPrimitive is not defined in the schema.
+     */
     where<Operator extends FilterOperator>(filterPrimitive: FilterPrimitive<FieldOfSchema<TSchema>, Operator>): this;
+    /**
+     * Adds a filter primitive to the current filter group using an AND logical operator.
+     * Requires `where()` to have been called first to initialize the filter group.
+     * @template Operator - The specific filter operator type.
+     * @param {FilterPrimitive<FieldOfSchema<TSchema>, Operator>} filterPrimitive - The filter to add.
+     * @returns {this} The current criteria instance for chaining.
+     * @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<TSchema>, Operator>): this;
+    /**
+     * Adds a filter primitive to the current filter group using an OR logical operator.
+     * Requires `where()` to have been called first to initialize the filter group.
+     * @template Operator - The specific filter operator type.
+     * @param {FilterPrimitive<FieldOfSchema<TSchema>, Operator>} filterPrimitive - The filter to add.
+     * @returns {this} The current criteria instance for chaining.
+     * @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<TSchema>, Operator>): this;
+    /**
+     * Adds a join to another criteria.
+     * @template TJoinSchema - The schema of the entity to join.
+     * @template TJoinedCriteriaAlias - The alias for the joined entity.
+     * @template TMatchingJoinConfig - The specific join configuration from the parent schema that matches the joined
+     *   alias.
+     * @param {JoinCriteriaParameterType<TSchema, TJoinSchema, TJoinedCriteriaAlias, TMatchingJoinConfig>} criteriaToJoin
+     * The criteria instance representing the entity to join (e.g., `InnerJoinCriteria`, `LeftJoinCriteria`).
+     * @param {JoinParameterType<TSchema, TJoinSchema, TMatchingJoinConfig>} joinParameter
+     * The parameters defining how the join should be performed (e.g., fields for simple join, pivot table details for
+     *   many-to-many).
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If `criteriaToJoin` is a string (which is invalid).
+     * @throws {Error} If `parent_field` in `joinParameter` (or `parent_field.reference` for pivot joins) is not defined
+     *   in the parent schema.
+     * @throws {Error} If the join configuration for the given `criteriaToJoin.alias` is not found in the parent schema's
+     *   `joins` array.
+     * @throws {Error} If `joinParameter` is invalid for the `relation_type` defined in the schema (e.g., using
+     *   simple join input for many-to-many or vice-versa).
+     */
     join<TJoinSchema extends CriteriaSchema, TJoinedCriteriaAlias extends SelectedAliasOf<TJoinSchema>, TMatchingJoinConfig extends SpecificMatchingJoinConfig<TSchema, TJoinedCriteriaAlias>>(criteriaToJoin: JoinCriteriaParameterType<TSchema, TJoinSchema, TJoinedCriteriaAlias, TMatchingJoinConfig>, joinParameter: JoinParameterType<TSchema, TJoinSchema, TMatchingJoinConfig>): this;
     private assertIsValidJoinOptions;
+    /**
+     * Gets the current cursor configuration, if set.
+     * @returns {Cursor<FieldOfSchema<TSchema>, FilterOperator.GREATER_THAN | FilterOperator.LESS_THAN> | undefined}
+     * The cursor object or undefined.
+     */
     get cursor(): Cursor<FieldOfSchema<TSchema>, FilterOperator.GREATER_THAN | FilterOperator.LESS_THAN> | undefined;
-    setCursor(cursorFilters: [
-        Omit<FilterPrimitive<FieldOfSchema<TSchema>, FilterOperator.GREATER_THAN | FilterOperator.LESS_THAN>, 'operator'>,
-        Omit<FilterPrimitive<FieldOfSchema<TSchema>, FilterOperator.GREATER_THAN | FilterOperator.LESS_THAN>, 'operator'>
-    ], operator: FilterOperator.GREATER_THAN | FilterOperator.LESS_THAN, order: OrderDirection): this;
+    /**
+     * Sets the cursor for pagination.
+     * @template Operator - The specific comparison operator for the cursor.
+     * @param {readonly [Omit<FilterPrimitive<FieldOfSchema<TSchema>, Operator>, 'operator'>] | readonly
+     *   [Omit<FilterPrimitive<FieldOfSchema<TSchema>, Operator>, 'operator'>,
+     *   Omit<FilterPrimitive<FieldOfSchema<TSchema>, Operator>, 'operator'>]} filterPrimitives - An array of one or two
+     *   filter primitives defining the cursor's fields and values.
+     * @param {Operator} operator - The comparison operator (GREATER_THAN or LESS_THAN).
+     * @param {OrderDirection} order - The primary order direction for pagination.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If filterPrimitives does not contain exactly 1 or 2 elements.
+     * @throws {Error} If any cursor field is not defined in the schema.
+     * @throws {Error} If any cursor value is undefined (null is allowed, per Cursor constructor).
+     * @throws {Error} If two cursor fields are provided and they are identical (per Cursor constructor).
+     */
+    setCursor<Operator extends FilterOperator.GREATER_THAN | FilterOperator.LESS_THAN>(filterPrimitives: readonly [
+        Omit<FilterPrimitive<FieldOfSchema<TSchema>, Operator>, 'operator'>
+    ] | readonly [
+        Omit<FilterPrimitive<FieldOfSchema<TSchema>, Operator>, 'operator'>,
+        Omit<FilterPrimitive<FieldOfSchema<TSchema>, Operator>, 'operator'>
+    ], operator: Operator, order: OrderDirection): this;
 }
 //# sourceMappingURL=criteria.d.ts.map

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

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

package/dist/criteria/criteria.js

@@ -3,6 +3,14 @@ import { CriteriaJoinManager } from './criteria-join-manager.js';
 import { Cursor } from './cursor.js';
 import { Order, OrderDirection } from './order/order.js';
 import { FilterOperator } from './types/operator.types.js';
+/**
+ * Abstract base class for constructing query criteria.
+ * It provides a fluent API for defining filters, joins, selections, ordering, and pagination.
+ * Concrete criteria types (e.g., RootCriteria, JoinCriteria) will extend this class.
+ *
+ * @template TSchema - The schema definition for the entity this criteria operates on.
+ * @template CurrentAlias - The selected alias for the entity from its schema.
+ */
 export class Criteria {
     schema;
     _alias;
@@ -10,9 +18,25 @@ export class Criteria {
     _joinManager = new CriteriaJoinManager();
     _source_name;
     _take = 0; // 0 = no limit
+    /**
+     * Stores the set of fields explicitly selected by the user.
+     * This is used when `_selectAll` is false.
+     * @protected
+     */
     _select = new Set([]);
     _selectAll = true;
+    /**
+     * Stores the cursor configuration for pagination, if set.
+     * @protected
+     */
     _cursor;
+    /**
+     * Initializes a new instance of the Criteria class.
+     * @param {TSchema} schema - The schema definition for the entity.
+     * @param {CurrentAlias} _alias - The alias to use for this entity in the query.
+     * @throws {Error} If the provided alias is not supported by the schema.
+     * @protected
+     */
     constructor(schema, _alias) {
         this.schema = schema;
         this._alias = _alias;
@@ -20,20 +44,43 @@ export class Criteria {
             throw new Error(`Unsupported alia ${this._alias} for schema ${schema.source_name}`);
         this._source_name = schema.source_name;
     }
+    /**
+     * Gets the currently selected fields.
+     * If `_selectAll` is true, it returns all fields from the schema.
+     * Otherwise, it returns the fields explicitly set via `setSelect`.
+     * @returns {Array<FieldOfSchema<TSchema>>} An array of selected field names.
+     */
     get select() {
         if (this._selectAll) {
             return [...this.schema.fields];
         }
         return Array.from(this._select);
     }
+    /**
+     * Resets the selection to include all fields from the schema.
+     * Subsequent calls to `get select()` will return all schema fields
+     * until `setSelect()` is called again.
+     * @returns {this} The current criteria instance for chaining.
+     */
     resetSelect() {
         this._selectAll = true;
         this._select.clear();
         return this;
     }
+    /**
+     * Indicates whether all fields are currently configured to be selected.
+     * @returns {boolean} True if all fields are selected, false if specific fields are selected.
+     */
     get selectAll() {
         return this._selectAll;
     }
+    /**
+     * Specifies which fields to select for the entity.
+     * Calling this method sets `selectAll` to false.
+     * @param {Array<FieldOfSchema<TSchema>>} selectFields - An array of field names to select.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If any of the specified fields are not defined in the schema.
+     */
     setSelect(selectFields) {
         for (const field of selectFields) {
             this.assetFieldOnSchema(field);
@@ -44,29 +91,63 @@ export class Criteria {
         }
         return this;
     }
+    /**
+     * Gets the maximum number of records to return (LIMIT).
+     * @returns {number} The take value.
+     */
     get take() {
         return this._take;
     }
     _skip = 0;
+    /**
+     * Gets the number of records to skip (OFFSET).
+     * @returns {number} The skip value.
+     */
     get skip() {
         return this._skip;
     }
     _orders = [];
+    /**
+     * Gets the current ordering rules applied to this criteria.
+     * @returns {ReadonlyArray<Order<FieldOfSchema<TSchema>>>} A readonly array of order objects.
+     */
     get orders() {
         return [...this._orders];
     }
+    /**
+     * Gets the configured join details for this criteria.
+     * @returns {ReadonlyArray<StoredJoinDetails<TSchema>>} A readonly array of join configurations.
+     */
     get joins() {
         return [...this._joinManager.getJoins()];
     }
+    /**
+     * Gets the root filter group for this criteria, which holds all filter conditions.
+     * @returns {FilterGroup} The root filter group.
+     */
     get rootFilterGroup() {
         return this._filterManager.getRootFilterGroup();
     }
+    /**
+     * Gets the source name (e.g., table name) for the entity of this criteria.
+     * @returns {TSchema['source_name']} The source name string.
+     */
     get sourceName() {
         return this._source_name;
     }
+    /**
+     * Gets the alias used for the entity of this criteria.
+     * @returns {CurrentAlias} The alias string.
+     */
     get alias() {
         return this._alias;
     }
+    /**
+     * Sets the maximum number of records to return (LIMIT).
+     * @param {number} amount - The number of records to take. Must be non-negative.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the amount is negative.
+     */
     setTake(amount) {
         if (amount < 0) {
             throw new Error(`Take value cant be negative`);
@@ -74,6 +155,12 @@ export class Criteria {
         this._take = amount;
         return this;
     }
+    /**
+     * Sets the number of records to skip before starting to return records (OFFSET).
+     * @param {number} amount - The number of records to skip. Must be non-negative.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the amount is negative.
+     */
     setSkip(amount) {
         if (amount < 0) {
             throw new Error(`Skip value cant be negative`);
@@ -81,30 +168,93 @@ export class Criteria {
         this._skip = amount;
         return this;
     }
+    /**
+     * Asserts that a given field name is defined within the current criteria's schema.
+     * This is a protected utility method used internally to validate field names
+     * before they are used in filters, ordering, or selections.
+     *
+     * @protected
+     * @param {FieldOfSchema<TSchema>} field - The field name to validate.
+     * @throws {Error} If the field is not defined in the schema.
+     */
     assetFieldOnSchema(field) {
         if (!this.schema.fields.includes(field))
             throw new Error(`The field '${String(field)}' is not defined in the schema '${this.schema.source_name}'.`);
     }
+    /**
+     * Adds an ordering rule to the criteria.
+     * Multiple calls will append new ordering rules.
+     * @param {FieldOfSchema<TSchema>} field - The field to order by.
+     * @param {OrderDirection} direction - The direction of the ordering (ASC or DESC).
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the specified field is not defined in the schema.
+     */
     orderBy(field, direction) {
         this.assetFieldOnSchema(field);
         this._orders.push(new Order(direction, field));
         return this;
     }
+    /**
+     * Initializes the filter criteria with a single filter primitive.
+     * This replaces any existing filters in the root filter group.
+     * @template Operator - The specific filter operator type.
+     * @param {FilterPrimitive<FieldOfSchema<TSchema>, Operator>} filterPrimitive - The filter to apply.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the specified field in filterPrimitive is not defined in the schema.
+     */
     where(filterPrimitive) {
         this.assetFieldOnSchema(filterPrimitive.field);
         this._filterManager.where(filterPrimitive);
         return this;
     }
+    /**
+     * Adds a filter primitive to the current filter group using an AND logical operator.
+     * Requires `where()` to have been called first to initialize the filter group.
+     * @template Operator - The specific filter operator type.
+     * @param {FilterPrimitive<FieldOfSchema<TSchema>, Operator>} filterPrimitive - The filter to add.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the specified field in filterPrimitive is not defined in the schema.
+     * @throws {Error} If `where()` has not been called first.
+     */
     andWhere(filterPrimitive) {
         this.assetFieldOnSchema(filterPrimitive.field);
         this._filterManager.andWhere(filterPrimitive);
         return this;
     }
+    /**
+     * Adds a filter primitive to the current filter group using an OR logical operator.
+     * Requires `where()` to have been called first to initialize the filter group.
+     * @template Operator - The specific filter operator type.
+     * @param {FilterPrimitive<FieldOfSchema<TSchema>, Operator>} filterPrimitive - The filter to add.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If the specified field in filterPrimitive is not defined in the schema.
+     * @throws {Error} If `where()` has not been called first.
+     */
     orWhere(filterPrimitive) {
         this.assetFieldOnSchema(filterPrimitive.field);
         this._filterManager.orWhere(filterPrimitive);
         return this;
     }
+    /**
+     * Adds a join to another criteria.
+     * @template TJoinSchema - The schema of the entity to join.
+     * @template TJoinedCriteriaAlias - The alias for the joined entity.
+     * @template TMatchingJoinConfig - The specific join configuration from the parent schema that matches the joined
+     *   alias.
+     * @param {JoinCriteriaParameterType<TSchema, TJoinSchema, TJoinedCriteriaAlias, TMatchingJoinConfig>} criteriaToJoin
+     * The criteria instance representing the entity to join (e.g., `InnerJoinCriteria`, `LeftJoinCriteria`).
+     * @param {JoinParameterType<TSchema, TJoinSchema, TMatchingJoinConfig>} joinParameter
+     * The parameters defining how the join should be performed (e.g., fields for simple join, pivot table details for
+     *   many-to-many).
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If `criteriaToJoin` is a string (which is invalid).
+     * @throws {Error} If `parent_field` in `joinParameter` (or `parent_field.reference` for pivot joins) is not defined
+     *   in the parent schema.
+     * @throws {Error} If the join configuration for the given `criteriaToJoin.alias` is not found in the parent schema's
+     *   `joins` array.
+     * @throws {Error} If `joinParameter` is invalid for the `relation_type` defined in the schema (e.g., using
+     *   simple join input for many-to-many or vice-versa).
+     */
     join(criteriaToJoin, joinParameter) {
         if (typeof criteriaToJoin === 'string') {
             throw new Error(`Invalid criteriaToJoin: ${criteriaToJoin}`);
@@ -121,7 +271,10 @@ export class Criteria {
             ...joinParameter,
             parent_alias: this.alias,
             parent_source_name: this.sourceName,
-            parent_to_join_relation_type: joinConfig.join_relation_type,
+            relation_type: joinConfig.relation_type,
+            join_metadata: this.schema.joins.find((join) => join.alias === criteriaToJoin.alias)
+                ?.metadata ?? {},
+            parent_schema_metadata: this.schema.metadata ?? {},
         };
         this._joinManager.addJoin(criteriaToJoin, fullJoinParameters);
         return this;
@@ -133,7 +286,7 @@ export class Criteria {
                 'pivot_field' in field &&
                 'reference' in field);
         };
-        if (joinConfig.join_relation_type === 'many_to_many') {
+        if (joinConfig.relation_type === 'many_to_many') {
             if (!isPivotFieldObject(joinParameter.parent_field) ||
                 !isPivotFieldObject(joinParameter.join_field)) {
                 throw new Error(`Invalid JoinOptions for 'many_to_many' join. Expected parent_field and join_field to be objects with 'pivot_field' and 'reference' properties. Alias: '${String(joinConfig.alias)}'`);
@@ -142,20 +295,41 @@ export class Criteria {
         else {
             if (typeof joinParameter.parent_field !== 'string' ||
                 typeof joinParameter.join_field !== 'string') {
-                throw new Error(`Invalid JoinOptions for '${joinConfig.join_relation_type}' join. Expected parent_field and join_field to be strings. Alias: '${String(joinConfig.alias)}'`);
+                throw new Error(`Invalid JoinOptions for '${joinConfig.relation_type}' join. Expected parent_field and join_field to be strings. Alias: '${String(joinConfig.alias)}'`);
             }
         }
     }
+    /**
+     * Gets the current cursor configuration, if set.
+     * @returns {Cursor<FieldOfSchema<TSchema>, FilterOperator.GREATER_THAN | FilterOperator.LESS_THAN> | undefined}
+     * The cursor object or undefined.
+     */
     get cursor() {
         return this._cursor;
     }
-    setCursor(cursorFilters, operator, order) {
-        if (cursorFilters.length !== 2)
-            throw new Error(`The cursor must have exactly 2 elements`);
-        for (const filterPrimitive of cursorFilters) {
+    /**
+     * Sets the cursor for pagination.
+     * @template Operator - The specific comparison operator for the cursor.
+     * @param {readonly [Omit<FilterPrimitive<FieldOfSchema<TSchema>, Operator>, 'operator'>] | readonly
+     *   [Omit<FilterPrimitive<FieldOfSchema<TSchema>, Operator>, 'operator'>,
+     *   Omit<FilterPrimitive<FieldOfSchema<TSchema>, Operator>, 'operator'>]} filterPrimitives - An array of one or two
+     *   filter primitives defining the cursor's fields and values.
+     * @param {Operator} operator - The comparison operator (GREATER_THAN or LESS_THAN).
+     * @param {OrderDirection} order - The primary order direction for pagination.
+     * @returns {this} The current criteria instance for chaining.
+     * @throws {Error} If filterPrimitives does not contain exactly 1 or 2 elements.
+     * @throws {Error} If any cursor field is not defined in the schema.
+     * @throws {Error} If any cursor value is undefined (null is allowed, per Cursor constructor).
+     * @throws {Error} If two cursor fields are provided and they are identical (per Cursor constructor).
+     */
+    setCursor(filterPrimitives, operator, order) {
+        if (filterPrimitives.length !== 1 && filterPrimitives.length !== 2) {
+            throw new Error('The cursor must have exactly 1 or 2 elements');
+        }
+        for (const filterPrimitive of filterPrimitives) {
             this.assetFieldOnSchema(filterPrimitive.field);
         }
-        this._cursor = new Cursor(cursorFilters, operator, order);
+        this._cursor = new Cursor(filterPrimitives, operator, order);
         return this;
     }
 }

package/dist/criteria/criteria.js.map

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