@intellegens/cornerstone-client 0.0.9999-alpha-34 → 0.0.9999-alpha-35

package/dist/data/api/dto/read/ReadSelectedSearchDefinitionBuilder.d.ts

@@ -0,0 +1,167 @@
+import { ReadSelectedComparisonOperator, ReadSelectedPropertyType } from '../../..';
+import { ReadSelectedSearchDefinitionDto } from './ReadSelectedSearchDefinitionDto';
+/**
+ * Builder class for constructing ReadSelectedSearchDefinitionDto with a fluent API.
+ *
+ * @example
+ * // Simple AND search with property criteria
+ * const search = SearchBuilder.and<User>()
+ *   .whereString('name', ReadSelectedComparisonOperator.IContains, 'John')
+ *   .whereNumber('age', ReadSelectedComparisonOperator.GreaterThan, 18)
+ *   .build();
+ *
+ * @example
+ * // OR search with nested criteria (specify nested type for intellisense)
+ * const search = SearchBuilder.or<User>()
+ *   .whereString('status', ReadSelectedComparisonOperator.Equal, 'active')
+ *   .nested<Address>('address', nested =>
+ *     nested.whereString('city', ReadSelectedComparisonOperator.Equal, 'NYC')
+ *   )
+ *   .build();
+ *
+ * @example
+ * // Complex nested search with collection criteria
+ * const search = SearchBuilder.and<Order>()
+ *   .whereString('status', ReadSelectedComparisonOperator.Equal, 'pending')
+ *   .any<OrderItem>('items', itemSearch =>
+ *     itemSearch.whereNumber('quantity', ReadSelectedComparisonOperator.GreaterThan, 5)
+ *   )
+ *   .group(sub => sub.or()
+ *     .whereString('priority', ReadSelectedComparisonOperator.Equal, 'high')
+ *     .whereString('priority', ReadSelectedComparisonOperator.Equal, 'urgent')
+ *   )
+ *   .build();
+ */
+export declare class SearchBuilder<T> {
+    private _logicalOperator;
+    private _searches;
+    private _propertyCriteria;
+    private _nestedCriteria;
+    private _nestedCollectionCriteria;
+    private constructor();
+    /**
+     * Creates a new builder with AND logical operator.
+     * All criteria added to this builder will be combined with AND.
+     */
+    static and<T>(): SearchBuilder<T>;
+    /**
+     * Creates a new builder with OR logical operator.
+     * All criteria added to this builder will be combined with OR.
+     */
+    static or<T>(): SearchBuilder<T>;
+    /**
+     * Sets the logical operator to AND.
+     */
+    and(): this;
+    /**
+     * Sets the logical operator to OR.
+     */
+    or(): this;
+    /**
+     * Adds a property comparison criterion.
+     *
+     * @param propertyName - The property to compare
+     * @param comparisonOperator - The comparison operator to use
+     * @param value - The value to compare against
+     * @param valueType - The type of the value
+     */
+    where<K extends keyof T>(propertyName: K, comparisonOperator: ReadSelectedComparisonOperator, value: unknown, valueType: ReadSelectedPropertyType): this;
+    /**
+     * Adds a string property comparison with common string operations.
+     */
+    whereString<K extends keyof T>(propertyName: K, comparisonOperator: ReadSelectedComparisonOperator.Equal | ReadSelectedComparisonOperator.NotEqual | ReadSelectedComparisonOperator.Contains | ReadSelectedComparisonOperator.StartsWith | ReadSelectedComparisonOperator.EndsWith | ReadSelectedComparisonOperator.IContains | ReadSelectedComparisonOperator.IStartsWith | ReadSelectedComparisonOperator.IEndsWith | ReadSelectedComparisonOperator.IEqual | ReadSelectedComparisonOperator.INotEqual, value: string): this;
+    /**
+     * Adds a number property comparison.
+     */
+    whereNumber<K extends keyof T>(propertyName: K, comparisonOperator: ReadSelectedComparisonOperator.Equal | ReadSelectedComparisonOperator.NotEqual | ReadSelectedComparisonOperator.LessThan | ReadSelectedComparisonOperator.LessOrEqual | ReadSelectedComparisonOperator.GreaterThan | ReadSelectedComparisonOperator.GreaterOrEqual, value: number, valueType?: ReadSelectedPropertyType.Int | ReadSelectedPropertyType.Short | ReadSelectedPropertyType.Long | ReadSelectedPropertyType.Decimal | ReadSelectedPropertyType.Double | ReadSelectedPropertyType.Float): this;
+    /**
+     * Adds a boolean property comparison.
+     */
+    whereBool<K extends keyof T>(propertyName: K, comparisonOperator: ReadSelectedComparisonOperator.Equal | ReadSelectedComparisonOperator.NotEqual, value: boolean): this;
+    /**
+     * Adds a date/time property comparison.
+     */
+    whereDate<K extends keyof T>(propertyName: K, comparisonOperator: ReadSelectedComparisonOperator.Equal | ReadSelectedComparisonOperator.NotEqual | ReadSelectedComparisonOperator.LessThan | ReadSelectedComparisonOperator.LessOrEqual | ReadSelectedComparisonOperator.GreaterThan | ReadSelectedComparisonOperator.GreaterOrEqual, value: string | Date, valueType?: ReadSelectedPropertyType.DateTime | ReadSelectedPropertyType.DateTimeOffset | ReadSelectedPropertyType.DateOnly | ReadSelectedPropertyType.TimeOnly | ReadSelectedPropertyType.TimeSpan): this;
+    /**
+     * Adds an isNull check for a property.
+     */
+    whereNull<K extends keyof T>(propertyName: K): this;
+    /**
+     * Adds an isNotNull check for a property.
+     */
+    whereNotNull<K extends keyof T>(propertyName: K): this;
+    /**
+     * Adds criteria for a nested object property (navigation property).
+     *
+     * @param propertyName - The navigation property name
+     * @param builderFn - A function that receives a new builder for the nested type
+     *
+     * @example
+     * // With explicit type for proper intellisense
+     * SearchBuilder.and<VehicleDto>()
+     *   .nested<PersonDto>('driver', nested =>
+     *     nested.whereString('name', ReadSelectedComparisonOperator.Contains, 'Alice')
+     *   )
+     *   .build();
+     */
+    nested<TNested, K extends keyof T = keyof T>(propertyName: K, builderFn: (builder: SearchBuilder<TNested>) => SearchBuilder<TNested>): this;
+    /**
+     * Adds criteria for a collection property with Any quantifier.
+     * Matches if at least one element in the collection satisfies the criteria.
+     *
+     * @param propertyName - The collection property name
+     * @param builderFn - A function that receives a new builder for the collection element type
+     *
+     * @example
+     * // With explicit type for proper intellisense
+     * SearchBuilder.and<VehicleDto>()
+     *   .any<PersonDto>('passengers', passengers =>
+     *     passengers.whereString('name', ReadSelectedComparisonOperator.Contains, 'Bob')
+     *   )
+     *   .build();
+     */
+    any<TElement, K extends keyof T = keyof T>(propertyName: K, builderFn: (builder: SearchBuilder<TElement>) => SearchBuilder<TElement>): this;
+    /**
+     * Adds criteria for a collection property with All quantifier.
+     * Matches if all elements in the collection satisfy the criteria.
+     *
+     * @param propertyName - The collection property name
+     * @param builderFn - A function that receives a new builder for the collection element type
+     *
+     * @example
+     * // With explicit type for proper intellisense
+     * SearchBuilder.and<VehicleDto>()
+     *   .all<PersonDto>('passengers', passengers =>
+     *     passengers.whereNumber('age', ReadSelectedComparisonOperator.GreaterThan, 18)
+     *   )
+     *   .build();
+     */
+    all<TElement, K extends keyof T = keyof T>(propertyName: K, builderFn: (builder: SearchBuilder<TElement>) => SearchBuilder<TElement>): this;
+    /**
+     * Adds a nested search group. Use this for complex logical groupings.
+     *
+     * @param builderFn - A function that receives a new builder for creating the nested search
+     *
+     * @example
+     * // (name contains 'John') AND ((age > 18) OR (status = 'verified'))
+     * SearchBuilder.and<User>()
+     *   .whereString('name', ReadSelectedComparisonOperator.IContains, 'John')
+     *   .group(sub => sub.or()
+     *     .whereNumber('age', ReadSelectedComparisonOperator.GreaterThan, 18)
+     *     .whereString('status', ReadSelectedComparisonOperator.Equal, 'verified')
+     *   )
+     *   .build();
+     */
+    group(builderFn: (builder: SearchBuilder<T>) => SearchBuilder<T>): this;
+    /**
+     * Adds an existing search definition as a nested search.
+     *
+     * @param search - An existing ReadSelectedSearchDefinitionDto
+     */
+    addSearch(search: ReadSelectedSearchDefinitionDto<T>): this;
+    /**
+     * Builds and returns the ReadSelectedSearchDefinitionDto.
+     */
+    build(): ReadSelectedSearchDefinitionDto<T>;
+    private toPascalCase;
+}

package/dist/data/api/dto/read/ReadSelectedSearchDefinitionBuilder.js

@@ -0,0 +1,267 @@
+import { ReadSelectedCollectionOperator, ReadSelectedComparisonOperator, ReadSelectedLogicalOperator, ReadSelectedPropertyType } from '../../..';
+/**
+ * Builder class for constructing ReadSelectedSearchDefinitionDto with a fluent API.
+ *
+ * @example
+ * // Simple AND search with property criteria
+ * const search = SearchBuilder.and<User>()
+ *   .whereString('name', ReadSelectedComparisonOperator.IContains, 'John')
+ *   .whereNumber('age', ReadSelectedComparisonOperator.GreaterThan, 18)
+ *   .build();
+ *
+ * @example
+ * // OR search with nested criteria (specify nested type for intellisense)
+ * const search = SearchBuilder.or<User>()
+ *   .whereString('status', ReadSelectedComparisonOperator.Equal, 'active')
+ *   .nested<Address>('address', nested =>
+ *     nested.whereString('city', ReadSelectedComparisonOperator.Equal, 'NYC')
+ *   )
+ *   .build();
+ *
+ * @example
+ * // Complex nested search with collection criteria
+ * const search = SearchBuilder.and<Order>()
+ *   .whereString('status', ReadSelectedComparisonOperator.Equal, 'pending')
+ *   .any<OrderItem>('items', itemSearch =>
+ *     itemSearch.whereNumber('quantity', ReadSelectedComparisonOperator.GreaterThan, 5)
+ *   )
+ *   .group(sub => sub.or()
+ *     .whereString('priority', ReadSelectedComparisonOperator.Equal, 'high')
+ *     .whereString('priority', ReadSelectedComparisonOperator.Equal, 'urgent')
+ *   )
+ *   .build();
+ */
+export class SearchBuilder {
+    _logicalOperator;
+    _searches = [];
+    _propertyCriteria = [];
+    _nestedCriteria = [];
+    _nestedCollectionCriteria = [];
+    constructor(logicalOperator) {
+        this._logicalOperator = logicalOperator;
+    }
+    /**
+     * Creates a new builder with AND logical operator.
+     * All criteria added to this builder will be combined with AND.
+     */
+    static and() {
+        return new SearchBuilder(ReadSelectedLogicalOperator.And);
+    }
+    /**
+     * Creates a new builder with OR logical operator.
+     * All criteria added to this builder will be combined with OR.
+     */
+    static or() {
+        return new SearchBuilder(ReadSelectedLogicalOperator.Or);
+    }
+    /**
+     * Sets the logical operator to AND.
+     */
+    and() {
+        this._logicalOperator = ReadSelectedLogicalOperator.And;
+        return this;
+    }
+    /**
+     * Sets the logical operator to OR.
+     */
+    or() {
+        this._logicalOperator = ReadSelectedLogicalOperator.Or;
+        return this;
+    }
+    /**
+     * Adds a property comparison criterion.
+     *
+     * @param propertyName - The property to compare
+     * @param comparisonOperator - The comparison operator to use
+     * @param value - The value to compare against
+     * @param valueType - The type of the value
+     */
+    where(propertyName, comparisonOperator, value, valueType) {
+        this._propertyCriteria.push({
+            propertyName: this.toPascalCase(propertyName),
+            comparisonOperator,
+            value,
+            valueType,
+        });
+        return this;
+    }
+    /**
+     * Adds a string property comparison with common string operations.
+     */
+    whereString(propertyName, comparisonOperator, value) {
+        return this.where(propertyName, comparisonOperator, value, ReadSelectedPropertyType.String);
+    }
+    /**
+     * Adds a number property comparison.
+     */
+    whereNumber(propertyName, comparisonOperator, value, valueType = ReadSelectedPropertyType.Int) {
+        return this.where(propertyName, comparisonOperator, value, valueType);
+    }
+    /**
+     * Adds a boolean property comparison.
+     */
+    whereBool(propertyName, comparisonOperator, value) {
+        return this.where(propertyName, comparisonOperator, value, ReadSelectedPropertyType.Bool);
+    }
+    /**
+     * Adds a date/time property comparison.
+     */
+    whereDate(propertyName, comparisonOperator, value, valueType = ReadSelectedPropertyType.DateTime) {
+        const stringValue = value instanceof Date ? value.toISOString() : value;
+        return this.where(propertyName, comparisonOperator, stringValue, valueType);
+    }
+    /**
+     * Adds an isNull check for a property.
+     */
+    whereNull(propertyName) {
+        this._propertyCriteria.push({
+            propertyName: this.toPascalCase(propertyName),
+            comparisonOperator: ReadSelectedComparisonOperator.IsNull,
+            value: null,
+            valueType: ReadSelectedPropertyType.String,
+        });
+        return this;
+    }
+    /**
+     * Adds an isNotNull check for a property.
+     */
+    whereNotNull(propertyName) {
+        this._propertyCriteria.push({
+            propertyName: this.toPascalCase(propertyName),
+            comparisonOperator: ReadSelectedComparisonOperator.IsNotNull,
+            value: null,
+            valueType: ReadSelectedPropertyType.String,
+        });
+        return this;
+    }
+    /**
+     * Adds criteria for a nested object property (navigation property).
+     *
+     * @param propertyName - The navigation property name
+     * @param builderFn - A function that receives a new builder for the nested type
+     *
+     * @example
+     * // With explicit type for proper intellisense
+     * SearchBuilder.and<VehicleDto>()
+     *   .nested<PersonDto>('driver', nested =>
+     *     nested.whereString('name', ReadSelectedComparisonOperator.Contains, 'Alice')
+     *   )
+     *   .build();
+     */
+    nested(propertyName, builderFn) {
+        const nestedBuilder = SearchBuilder.and();
+        const configuredBuilder = builderFn(nestedBuilder);
+        this._nestedCriteria.push({
+            propertyName: this.toPascalCase(propertyName),
+            criteria: configuredBuilder.build(),
+        });
+        return this;
+    }
+    /**
+     * Adds criteria for a collection property with Any quantifier.
+     * Matches if at least one element in the collection satisfies the criteria.
+     *
+     * @param propertyName - The collection property name
+     * @param builderFn - A function that receives a new builder for the collection element type
+     *
+     * @example
+     * // With explicit type for proper intellisense
+     * SearchBuilder.and<VehicleDto>()
+     *   .any<PersonDto>('passengers', passengers =>
+     *     passengers.whereString('name', ReadSelectedComparisonOperator.Contains, 'Bob')
+     *   )
+     *   .build();
+     */
+    any(propertyName, builderFn) {
+        const nestedBuilder = SearchBuilder.and();
+        const configuredBuilder = builderFn(nestedBuilder);
+        this._nestedCollectionCriteria.push({
+            propertyName: this.toPascalCase(propertyName),
+            collectionOperator: ReadSelectedCollectionOperator.Any,
+            criteria: configuredBuilder.build(),
+        });
+        return this;
+    }
+    /**
+     * Adds criteria for a collection property with All quantifier.
+     * Matches if all elements in the collection satisfy the criteria.
+     *
+     * @param propertyName - The collection property name
+     * @param builderFn - A function that receives a new builder for the collection element type
+     *
+     * @example
+     * // With explicit type for proper intellisense
+     * SearchBuilder.and<VehicleDto>()
+     *   .all<PersonDto>('passengers', passengers =>
+     *     passengers.whereNumber('age', ReadSelectedComparisonOperator.GreaterThan, 18)
+     *   )
+     *   .build();
+     */
+    all(propertyName, builderFn) {
+        const nestedBuilder = SearchBuilder.and();
+        const configuredBuilder = builderFn(nestedBuilder);
+        this._nestedCollectionCriteria.push({
+            propertyName: this.toPascalCase(propertyName),
+            collectionOperator: ReadSelectedCollectionOperator.All,
+            criteria: configuredBuilder.build(),
+        });
+        return this;
+    }
+    /**
+     * Adds a nested search group. Use this for complex logical groupings.
+     *
+     * @param builderFn - A function that receives a new builder for creating the nested search
+     *
+     * @example
+     * // (name contains 'John') AND ((age > 18) OR (status = 'verified'))
+     * SearchBuilder.and<User>()
+     *   .whereString('name', ReadSelectedComparisonOperator.IContains, 'John')
+     *   .group(sub => sub.or()
+     *     .whereNumber('age', ReadSelectedComparisonOperator.GreaterThan, 18)
+     *     .whereString('status', ReadSelectedComparisonOperator.Equal, 'verified')
+     *   )
+     *   .build();
+     */
+    group(builderFn) {
+        const nestedBuilder = SearchBuilder.and();
+        const configuredBuilder = builderFn(nestedBuilder);
+        this._searches.push(configuredBuilder.build());
+        return this;
+    }
+    /**
+     * Adds an existing search definition as a nested search.
+     *
+     * @param search - An existing ReadSelectedSearchDefinitionDto
+     */
+    addSearch(search) {
+        this._searches.push(search);
+        return this;
+    }
+    /**
+     * Builds and returns the ReadSelectedSearchDefinitionDto.
+     */
+    build() {
+        const result = {
+            logicalOperator: this._logicalOperator,
+        };
+        if (this._searches.length > 0) {
+            result.searches = this._searches;
+        }
+        if (this._propertyCriteria.length > 0) {
+            result.propertyCriteria = this._propertyCriteria;
+        }
+        if (this._nestedCriteria.length > 0) {
+            result.nestedCriteria = this._nestedCriteria;
+        }
+        if (this._nestedCollectionCriteria.length > 0) {
+            result.nestedCollectionCriteria = this._nestedCollectionCriteria;
+        }
+        return result;
+    }
+    toPascalCase(str) {
+        if (typeof str !== 'string') {
+            return str.toString();
+        }
+        return str.replace(/([A-Z])/g, ' $1').replace(/^./, firstChar => firstChar.toUpperCase());
+    }
+}

package/dist/data/api/dto/read/index.d.ts

@@ -7,3 +7,4 @@ export * from './ReadSelectedOrderingPropertyDefinitionDto';
 export * from './ReadSelectedPaginationDefinitionDto';
 export * from './ReadSelectedDefinitionDto';
 export * from './ReadSelectedSearchDefinitionDto';
+export * from './ReadSelectedSearchDefinitionBuilder';

package/dist/data/api/dto/read/index.js

@@ -7,3 +7,4 @@ export * from './ReadSelectedOrderingPropertyDefinitionDto';
 export * from './ReadSelectedPaginationDefinitionDto';
 export * from './ReadSelectedDefinitionDto';
 export * from './ReadSelectedSearchDefinitionDto';
+export * from './ReadSelectedSearchDefinitionBuilder';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellegens/cornerstone-client",
-  "version": "0.0.9999-alpha-34",
+  "version": "0.0.9999-alpha-35",
   "private": false,
   "publishable": true,
   "main": "./dist/index.js",

package/src/data/api/dto/read/ReadSelectedSearchDefinitionBuilder.ts

@@ -0,0 +1,348 @@
+import { ReadSelectedCollectionOperator, ReadSelectedComparisonOperator, ReadSelectedLogicalOperator, ReadSelectedPropertyType } from '@data';
+import { ReadSelectedSearchDefinitionDto } from './ReadSelectedSearchDefinitionDto';
+import { ReadSelectedSearchPropertyDefinitionDto } from './ReadSelectedSearchPropertyDefinitionDto';
+import { ReadSelectedNestedCriteriaDto } from './ReadSelectedNestedCriteriaDto';
+import { ReadSelectedNestedCollectionCriteriaDto } from './ReadSelectedNestedCollectionCriteriaDto';
+
+/**
+ * Builder class for constructing ReadSelectedSearchDefinitionDto with a fluent API.
+ *
+ * @example
+ * // Simple AND search with property criteria
+ * const search = SearchBuilder.and<User>()
+ *   .whereString('name', ReadSelectedComparisonOperator.IContains, 'John')
+ *   .whereNumber('age', ReadSelectedComparisonOperator.GreaterThan, 18)
+ *   .build();
+ *
+ * @example
+ * // OR search with nested criteria (specify nested type for intellisense)
+ * const search = SearchBuilder.or<User>()
+ *   .whereString('status', ReadSelectedComparisonOperator.Equal, 'active')
+ *   .nested<Address>('address', nested =>
+ *     nested.whereString('city', ReadSelectedComparisonOperator.Equal, 'NYC')
+ *   )
+ *   .build();
+ *
+ * @example
+ * // Complex nested search with collection criteria
+ * const search = SearchBuilder.and<Order>()
+ *   .whereString('status', ReadSelectedComparisonOperator.Equal, 'pending')
+ *   .any<OrderItem>('items', itemSearch =>
+ *     itemSearch.whereNumber('quantity', ReadSelectedComparisonOperator.GreaterThan, 5)
+ *   )
+ *   .group(sub => sub.or()
+ *     .whereString('priority', ReadSelectedComparisonOperator.Equal, 'high')
+ *     .whereString('priority', ReadSelectedComparisonOperator.Equal, 'urgent')
+ *   )
+ *   .build();
+ */
+export class SearchBuilder<T> {
+  private _logicalOperator: ReadSelectedLogicalOperator;
+  private _searches: ReadSelectedSearchDefinitionDto<T>[] = [];
+  private _propertyCriteria: ReadSelectedSearchPropertyDefinitionDto<T, keyof T>[] = [];
+  private _nestedCriteria: ReadSelectedNestedCriteriaDto<T, keyof T>[] = [];
+  private _nestedCollectionCriteria: ReadSelectedNestedCollectionCriteriaDto<T, keyof T>[] = [];
+
+  private constructor(logicalOperator: ReadSelectedLogicalOperator) {
+    this._logicalOperator = logicalOperator;
+  }
+
+  /**
+   * Creates a new builder with AND logical operator.
+   * All criteria added to this builder will be combined with AND.
+   */
+  static and<T>(): SearchBuilder<T> {
+    return new SearchBuilder<T>(ReadSelectedLogicalOperator.And);
+  }
+
+  /**
+   * Creates a new builder with OR logical operator.
+   * All criteria added to this builder will be combined with OR.
+   */
+  static or<T>(): SearchBuilder<T> {
+    return new SearchBuilder<T>(ReadSelectedLogicalOperator.Or);
+  }
+
+  /**
+   * Sets the logical operator to AND.
+   */
+  and(): this {
+    this._logicalOperator = ReadSelectedLogicalOperator.And;
+    return this;
+  }
+
+  /**
+   * Sets the logical operator to OR.
+   */
+  or(): this {
+    this._logicalOperator = ReadSelectedLogicalOperator.Or;
+    return this;
+  }
+
+  /**
+   * Adds a property comparison criterion.
+   *
+   * @param propertyName - The property to compare
+   * @param comparisonOperator - The comparison operator to use
+   * @param value - The value to compare against
+   * @param valueType - The type of the value
+   */
+  where<K extends keyof T>(propertyName: K, comparisonOperator: ReadSelectedComparisonOperator, value: unknown, valueType: ReadSelectedPropertyType): this {
+    this._propertyCriteria.push({
+      propertyName: this.toPascalCase(propertyName),
+      comparisonOperator,
+      value,
+      valueType,
+    } as ReadSelectedSearchPropertyDefinitionDto<T, keyof T>);
+    return this;
+  }
+
+  /**
+   * Adds a string property comparison with common string operations.
+   */
+  whereString<K extends keyof T>(
+    propertyName: K,
+    comparisonOperator:
+      | ReadSelectedComparisonOperator.Equal
+      | ReadSelectedComparisonOperator.NotEqual
+      | ReadSelectedComparisonOperator.Contains
+      | ReadSelectedComparisonOperator.StartsWith
+      | ReadSelectedComparisonOperator.EndsWith
+      | ReadSelectedComparisonOperator.IContains
+      | ReadSelectedComparisonOperator.IStartsWith
+      | ReadSelectedComparisonOperator.IEndsWith
+      | ReadSelectedComparisonOperator.IEqual
+      | ReadSelectedComparisonOperator.INotEqual,
+    value: string,
+  ): this {
+    return this.where(propertyName, comparisonOperator, value, ReadSelectedPropertyType.String);
+  }
+
+  /**
+   * Adds a number property comparison.
+   */
+  whereNumber<K extends keyof T>(
+    propertyName: K,
+    comparisonOperator:
+      | ReadSelectedComparisonOperator.Equal
+      | ReadSelectedComparisonOperator.NotEqual
+      | ReadSelectedComparisonOperator.LessThan
+      | ReadSelectedComparisonOperator.LessOrEqual
+      | ReadSelectedComparisonOperator.GreaterThan
+      | ReadSelectedComparisonOperator.GreaterOrEqual,
+    value: number,
+    valueType:
+      | ReadSelectedPropertyType.Int
+      | ReadSelectedPropertyType.Short
+      | ReadSelectedPropertyType.Long
+      | ReadSelectedPropertyType.Decimal
+      | ReadSelectedPropertyType.Double
+      | ReadSelectedPropertyType.Float = ReadSelectedPropertyType.Int,
+  ): this {
+    return this.where(propertyName, comparisonOperator, value, valueType);
+  }
+
+  /**
+   * Adds a boolean property comparison.
+   */
+  whereBool<K extends keyof T>(
+    propertyName: K,
+    comparisonOperator: ReadSelectedComparisonOperator.Equal | ReadSelectedComparisonOperator.NotEqual,
+    value: boolean,
+  ): this {
+    return this.where(propertyName, comparisonOperator, value, ReadSelectedPropertyType.Bool);
+  }
+
+  /**
+   * Adds a date/time property comparison.
+   */
+  whereDate<K extends keyof T>(
+    propertyName: K,
+    comparisonOperator:
+      | ReadSelectedComparisonOperator.Equal
+      | ReadSelectedComparisonOperator.NotEqual
+      | ReadSelectedComparisonOperator.LessThan
+      | ReadSelectedComparisonOperator.LessOrEqual
+      | ReadSelectedComparisonOperator.GreaterThan
+      | ReadSelectedComparisonOperator.GreaterOrEqual,
+    value: string | Date,
+    valueType:
+      | ReadSelectedPropertyType.DateTime
+      | ReadSelectedPropertyType.DateTimeOffset
+      | ReadSelectedPropertyType.DateOnly
+      | ReadSelectedPropertyType.TimeOnly
+      | ReadSelectedPropertyType.TimeSpan = ReadSelectedPropertyType.DateTime,
+  ): this {
+    const stringValue = value instanceof Date ? value.toISOString() : value;
+    return this.where(propertyName, comparisonOperator, stringValue, valueType);
+  }
+
+  /**
+   * Adds an isNull check for a property.
+   */
+  whereNull<K extends keyof T>(propertyName: K): this {
+    this._propertyCriteria.push({
+      propertyName: this.toPascalCase(propertyName),
+      comparisonOperator: ReadSelectedComparisonOperator.IsNull,
+      value: null,
+      valueType: ReadSelectedPropertyType.String,
+    } as unknown as ReadSelectedSearchPropertyDefinitionDto<T, keyof T>);
+    return this;
+  }
+
+  /**
+   * Adds an isNotNull check for a property.
+   */
+  whereNotNull<K extends keyof T>(propertyName: K): this {
+    this._propertyCriteria.push({
+      propertyName: this.toPascalCase(propertyName),
+      comparisonOperator: ReadSelectedComparisonOperator.IsNotNull,
+      value: null,
+      valueType: ReadSelectedPropertyType.String,
+    } as unknown as ReadSelectedSearchPropertyDefinitionDto<T, keyof T>);
+    return this;
+  }
+
+  /**
+   * Adds criteria for a nested object property (navigation property).
+   *
+   * @param propertyName - The navigation property name
+   * @param builderFn - A function that receives a new builder for the nested type
+   *
+   * @example
+   * // With explicit type for proper intellisense
+   * SearchBuilder.and<VehicleDto>()
+   *   .nested<PersonDto>('driver', nested =>
+   *     nested.whereString('name', ReadSelectedComparisonOperator.Contains, 'Alice')
+   *   )
+   *   .build();
+   */
+  nested<TNested, K extends keyof T = keyof T>(propertyName: K, builderFn: (builder: SearchBuilder<TNested>) => SearchBuilder<TNested>): this {
+    const nestedBuilder = SearchBuilder.and<TNested>();
+    const configuredBuilder = builderFn(nestedBuilder);
+    this._nestedCriteria.push({
+      propertyName: this.toPascalCase(propertyName),
+      criteria: configuredBuilder.build(),
+    } as ReadSelectedNestedCriteriaDto<T, keyof T>);
+    return this;
+  }
+
+  /**
+   * Adds criteria for a collection property with Any quantifier.
+   * Matches if at least one element in the collection satisfies the criteria.
+   *
+   * @param propertyName - The collection property name
+   * @param builderFn - A function that receives a new builder for the collection element type
+   *
+   * @example
+   * // With explicit type for proper intellisense
+   * SearchBuilder.and<VehicleDto>()
+   *   .any<PersonDto>('passengers', passengers =>
+   *     passengers.whereString('name', ReadSelectedComparisonOperator.Contains, 'Bob')
+   *   )
+   *   .build();
+   */
+  any<TElement, K extends keyof T = keyof T>(propertyName: K, builderFn: (builder: SearchBuilder<TElement>) => SearchBuilder<TElement>): this {
+    const nestedBuilder = SearchBuilder.and<TElement>();
+    const configuredBuilder = builderFn(nestedBuilder);
+    this._nestedCollectionCriteria.push({
+      propertyName: this.toPascalCase(propertyName),
+      collectionOperator: ReadSelectedCollectionOperator.Any,
+      criteria: configuredBuilder.build(),
+    } as ReadSelectedNestedCollectionCriteriaDto<T, keyof T>);
+    return this;
+  }
+
+  /**
+   * Adds criteria for a collection property with All quantifier.
+   * Matches if all elements in the collection satisfy the criteria.
+   *
+   * @param propertyName - The collection property name
+   * @param builderFn - A function that receives a new builder for the collection element type
+   *
+   * @example
+   * // With explicit type for proper intellisense
+   * SearchBuilder.and<VehicleDto>()
+   *   .all<PersonDto>('passengers', passengers =>
+   *     passengers.whereNumber('age', ReadSelectedComparisonOperator.GreaterThan, 18)
+   *   )
+   *   .build();
+   */
+  all<TElement, K extends keyof T = keyof T>(propertyName: K, builderFn: (builder: SearchBuilder<TElement>) => SearchBuilder<TElement>): this {
+    const nestedBuilder = SearchBuilder.and<TElement>();
+    const configuredBuilder = builderFn(nestedBuilder);
+    this._nestedCollectionCriteria.push({
+      propertyName: this.toPascalCase(propertyName),
+      collectionOperator: ReadSelectedCollectionOperator.All,
+      criteria: configuredBuilder.build(),
+    } as ReadSelectedNestedCollectionCriteriaDto<T, keyof T>);
+    return this;
+  }
+
+  /**
+   * Adds a nested search group. Use this for complex logical groupings.
+   *
+   * @param builderFn - A function that receives a new builder for creating the nested search
+   *
+   * @example
+   * // (name contains 'John') AND ((age > 18) OR (status = 'verified'))
+   * SearchBuilder.and<User>()
+   *   .whereString('name', ReadSelectedComparisonOperator.IContains, 'John')
+   *   .group(sub => sub.or()
+   *     .whereNumber('age', ReadSelectedComparisonOperator.GreaterThan, 18)
+   *     .whereString('status', ReadSelectedComparisonOperator.Equal, 'verified')
+   *   )
+   *   .build();
+   */
+  group(builderFn: (builder: SearchBuilder<T>) => SearchBuilder<T>): this {
+    const nestedBuilder = SearchBuilder.and<T>();
+    const configuredBuilder = builderFn(nestedBuilder);
+    this._searches.push(configuredBuilder.build());
+    return this;
+  }
+
+  /**
+   * Adds an existing search definition as a nested search.
+   *
+   * @param search - An existing ReadSelectedSearchDefinitionDto
+   */
+  addSearch(search: ReadSelectedSearchDefinitionDto<T>): this {
+    this._searches.push(search);
+    return this;
+  }
+
+  /**
+   * Builds and returns the ReadSelectedSearchDefinitionDto.
+   */
+  build(): ReadSelectedSearchDefinitionDto<T> {
+    const result: ReadSelectedSearchDefinitionDto<T> = {
+      logicalOperator: this._logicalOperator,
+    };
+
+    if (this._searches.length > 0) {
+      result.searches = this._searches;
+    }
+
+    if (this._propertyCriteria.length > 0) {
+      result.propertyCriteria = this._propertyCriteria;
+    }
+
+    if (this._nestedCriteria.length > 0) {
+      result.nestedCriteria = this._nestedCriteria;
+    }
+
+    if (this._nestedCollectionCriteria.length > 0) {
+      result.nestedCollectionCriteria = this._nestedCollectionCriteria;
+    }
+
+    return result;
+  }
+
+  private toPascalCase(str: string | number | symbol): string {
+    if (typeof str !== 'string') {
+      return str.toString();
+    }
+
+    return str.replace(/([A-Z])/g, ' $1').replace(/^./, firstChar => firstChar.toUpperCase());
+  }
+}

package/src/data/api/dto/read/index.ts

@@ -7,3 +7,4 @@ export * from './ReadSelectedOrderingPropertyDefinitionDto';
 export * from './ReadSelectedPaginationDefinitionDto';
 export * from './ReadSelectedDefinitionDto';
 export * from './ReadSelectedSearchDefinitionDto';
+export * from './ReadSelectedSearchDefinitionBuilder';