@opra/common 1.7.4 → 1.9.0

package/esm/filter/antlr/OpraFilterVisitor.js

@@ -1,4 +1,4 @@
-// Generated from ./src/filter/antlr/OpraFilter.g4 by ANTLR 4.12.0
+// Generated from ./src/filter/antlr/OpraFilter.g4 by ANTLR 4.13.2
 import { ParseTreeVisitor } from '@browsery/antlr4';
 /**
  * This interface defines a complete generic visitor for a parse tree produced

package/esm/filter/ast/index.js

@@ -10,6 +10,7 @@ export * from './expressions/negative-expression.js';
 export * from './expressions/parenthesized-expression.js';
 export * from './terms/boolean-literal.js';
 export * from './terms/date-literal.js';
+export * from './terms/date-time-literal.js';
 export * from './terms/null-literal.js';
 export * from './terms/number-literal.js';
 export * from './terms/qualified-identifier.js';

package/esm/filter/ast/terms/date-time-literal.js

@@ -0,0 +1,23 @@
+import { toDateDef } from 'putil-varhelpers';
+import { FilterValidationError } from '../../errors.js';
+import { quoteFilterString } from '../../utils.js';
+import { Literal } from '../abstract/literal.js';
+const NullDate = new Date(0);
+export class DateTimeLiteral extends Literal {
+    constructor(value) {
+        super('');
+        if (value instanceof Date) {
+            this.value = value.toISOString();
+            return;
+        }
+        // noinspection SuspiciousTypeOfGuard
+        if (typeof value === 'string' && toDateDef(value, NullDate) !== NullDate) {
+            this.value = value;
+            return;
+        }
+        throw new FilterValidationError(`Invalid date-time value "${value}"`);
+    }
+    toString() {
+        return quoteFilterString(this.value);
+    }
+}

package/esm/filter/build.js

@@ -81,7 +81,9 @@ export function $arithmetic(n) {
     return exp;
 }
 function comparisonExpression(op, left, right) {
-    const lex = wrapEntryValue(left);
+    const lex = typeof left === 'string'
+        ? new QualifiedIdentifier(left)
+        : wrapEntryValue(left);
     const rex = wrapEntryValue(right);
     return new ComparisonExpression({ op, left: lex, right: rex });
 }

package/esm/filter/filter-rules.js

@@ -41,7 +41,6 @@ export class FilterRules {
                 throw new TypeError(`Invalid filter query. Left side should be a data field.`);
             }
             // Check if filtering accepted for given field
-            // const findManyOp = this.getOperation('findMany');
             const rule = this._rules.get(ast.left.value);
             if (!rule) {
                 throw new OpraException({
@@ -67,6 +66,8 @@ export class FilterRules {
                     },
                 });
             }
+            if (rule.prepare)
+                ast.prepare = rule.prepare;
             this.normalizeFilterAst(ast.right, stack, currentType);
             stack.pop();
             return ast;

package/esm/filter/filter-tree-visitor.js

@@ -1,6 +1,6 @@
 import { ParseTreeVisitor } from '@browsery/antlr4';
 import { LogicalExpressionContext, } from './antlr/OpraFilterParser.js';
-import { ArrayExpression, BooleanLiteral, ComparisonExpression, DateLiteral, LogicalExpression, NegativeExpression, NullLiteral, NumberLiteral, ParenthesizedExpression, QualifiedIdentifier, StringLiteral, TimeLiteral, } from './ast/index.js';
+import { ArrayExpression, BooleanLiteral, ComparisonExpression, DateLiteral, DateTimeLiteral, LogicalExpression, NegativeExpression, NullLiteral, NumberLiteral, ParenthesizedExpression, QualifiedIdentifier, StringLiteral, TimeLiteral, } from './ast/index.js';
 import { ExternalConstant } from './ast/terms/external-constant.js';
 import { unquoteFilterString } from './utils.js';
 export class FilterTreeVisitor extends ParseTreeVisitor {
@@ -82,7 +82,7 @@ export class FilterTreeVisitor extends ParseTreeVisitor {
         return new DateLiteral(unquoteFilterString(ctx.getText()));
     }
     visitDateTimeLiteral(ctx) {
-        return new DateLiteral(unquoteFilterString(ctx.getText()));
+        return new DateTimeLiteral(unquoteFilterString(ctx.getText()));
     }
     visitTimeLiteral(ctx) {
         return new TimeLiteral(unquoteFilterString(ctx.getText()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opra/common",
-  "version": "1.7.4",
+  "version": "1.9.0",
   "description": "Opra common package",
   "author": "Panates",
   "license": "MIT",
@@ -8,7 +8,7 @@
     "@browsery/antlr4": "^4.13.3-r4",
     "@browsery/highland": "^2.13.6-r4",
     "@browsery/http-parser": "^0.5.9-r4",
-    "@browsery/i18next": "^23.12.3-r2",
+    "@browsery/i18next": "^24.2.1-r1",
     "@browsery/type-is": "^1.6.18-r8",
     "@jsopen/objects": "^1.5.0",
     "fast-tokenizer": "^1.7.0",

package/types/document/data-type/api-field.d.ts

@@ -43,6 +43,7 @@ declare class ApiFieldClass extends DocumentElement {
     readonly type: DataType;
     readonly description?: string;
     readonly isArray?: boolean;
+    readonly isNestedEntity?: boolean;
     readonly default?: any;
     readonly fixed?: any;
     readonly required?: boolean;
@@ -66,7 +67,7 @@ export declare namespace ApiField {
         type?: string | OpraSchema.DataType | TypeThunkAsync | EnumType.EnumObject | EnumType.EnumArray | object;
     }, OpraSchema.Field> {
         scopePattern?: (string | RegExp) | (string | RegExp)[];
-        override?: StrictOmit<Metadata, 'override' | 'type' | 'isArray'>[];
+        override?: StrictOmit<Metadata, 'override' | 'type' | 'isArray' | 'isNestedEntity'>[];
     }
     interface Options extends Partial<StrictOmit<Metadata, 'override' | 'scopePattern'>> {
         /**

package/types/document/data-type/enum-type.d.ts

@@ -41,9 +41,9 @@ export interface EnumTypeStatic {
      * @constructor
      */
     new (owner: DocumentElement, args?: EnumType.InitArguments): EnumType;
-    <T extends EnumType.EnumObject, B extends EnumType.EnumObject>(enumSource: T, base: B, options: EnumType.Options<T>): B & T;
-    <T extends EnumType.EnumArray, B extends EnumType.EnumArray>(enumSource: T, base: B, options: EnumType.Options<T>): B & T;
-    <T extends EnumType.EnumObject | EnumType.EnumArray>(target: T, options: EnumType.Options<T>): T;
+    <T extends EnumType.EnumObject, B extends EnumType.EnumObject>(enumSource: T, base?: B, options?: EnumType.Options<T>): B & T;
+    <T extends EnumType.EnumArray, B extends EnumType.EnumArray>(enumSource: T, base?: B, options?: EnumType.Options<T>): B & T;
+    <T extends EnumType.EnumObject | EnumType.EnumArray>(target: T, options?: EnumType.Options<T>): T;
 }
 /**
  * Type definition of EnumType prototype

package/types/document/decorators/api-field-decorator.d.ts

@@ -6,11 +6,11 @@ export interface ApiFieldDecorator extends PropertyDecorator {
      *
      * @param {string | RegExp | (string | RegExp)[]} scopePattern - A pattern or array of patterns that defines the scope
      *        within which the override applies. Patterns can be strings or regular expressions.
-     * @param {StrictOmit<ApiField.Options, 'isArray' | 'type' | 'scopePattern'>} options - Configuration options to override
+     * @param {StrictOmit<ApiField.Options, 'isArray' | 'isNestedEntity' | 'type' | 'scopePattern'>} options - Configuration options to override
      *        the default API field behavior, excluding the properties 'isArray', 'type', and 'scopePattern'.
      * @return {ApiFieldDecorator} The decorated API field after applying the override configuration.
      */
-    Override(scopePattern: (string | RegExp) | (string | RegExp)[], options: StrictOmit<ApiField.Options, 'isArray' | 'type' | 'scopePattern'>): ApiFieldDecorator;
+    Override(scopePattern: (string | RegExp) | (string | RegExp)[], options: StrictOmit<ApiField.Options, 'isArray' | 'isNestedEntity' | 'type' | 'scopePattern'>): ApiFieldDecorator;
 }
 export interface ApiFieldDecoratorFactory {
     (options?: ApiField.Options): ApiFieldDecorator;

package/types/document/decorators/http-operation-entity-create.decorator.d.ts

@@ -0,0 +1 @@
+export {};

package/types/document/decorators/http-operation-entity-delete-many.decorator.d.ts

@@ -0,0 +1 @@
+export {};

package/types/document/decorators/http-operation-entity-delete.decorator.d.ts

@@ -0,0 +1 @@
+export {};

package/types/document/decorators/http-operation-entity-find-many.decorator.d.ts

@@ -0,0 +1 @@
+export {};

package/types/document/decorators/http-operation-entity-get.decorator.d.ts

@@ -0,0 +1 @@
+export {};

package/types/document/decorators/http-operation-entity-replace.decorator.d.ts

@@ -0,0 +1 @@
+export {};

package/types/document/decorators/http-operation-entity-update-many.decorator.d.ts

@@ -0,0 +1 @@
+export {};

package/types/document/decorators/http-operation-entity-update.decorator.d.ts

@@ -0,0 +1 @@
+export {};

package/types/document/decorators/http-operation-entity.decorator.d.ts

@@ -1,6 +1,7 @@
 import type { StrictOmit, Type, TypeThunkAsync } from 'ts-gems';
 import { OpraFilter } from '../../filter/index.js';
 import { OpraSchema } from '../../schema/index.js';
+import { HttpOperation } from '../http/http-operation.js';
 import type { HttpParameter } from '../http/http-parameter.js';
 import { HttpRequestBody } from '../http/http-request-body.js';
 import { type HttpOperationDecorator } from './http-operation.decorator.js';
@@ -50,8 +51,14 @@ declare module '../http/http-operation.js' {
                 type: Type | string;
             }
             /** DeleteMany */
+            interface FilterOptions {
+                operators?: OpraFilter.ComparisonOperator[];
+                notes?: string;
+                prepare?: (value: any, op: OpraFilter.ComparisonOperator) => any;
+            }
             interface DeleteManyDecorator extends HttpOperationDecorator {
-                Filter(field: OpraSchema.Field.QualifiedName, operators?: OpraFilter.ComparisonOperator[] | string, notes?: string): this;
+                Filter(field: string, operators?: OpraFilter.ComparisonOperator[]): this;
+                Filter(field: string, options?: FilterOptions): this;
             }
             interface DeleteManyArgs extends StrictOmit<HttpOperation.Options, 'method' | 'requestBody'> {
                 type: Type | string;
@@ -59,8 +66,10 @@ declare module '../http/http-operation.js' {
             /** FindMany */
             interface FindManyDecorator extends HttpOperationDecorator {
                 SortFields(...fields: OpraSchema.Field.QualifiedName[]): FindManyDecorator;
+                SortFields(fieldsMap: Record<OpraSchema.Field.QualifiedName, OpraSchema.Field.QualifiedName>): FindManyDecorator;
                 DefaultSort(...fields: OpraSchema.Field.QualifiedName[]): FindManyDecorator;
-                Filter(field: OpraSchema.Field.QualifiedName, operators?: OpraFilter.ComparisonOperator[] | string, notes?: string): this;
+                Filter(field: OpraSchema.Field.QualifiedName, operators?: OpraFilter.ComparisonOperator[]): this;
+                Filter(field: string, options?: FilterOptions): this;
             }
             interface FindManyArgs extends StrictOmit<HttpOperation.Options, 'method' | 'requestBody'> {
                 type: Type | string;
@@ -85,7 +94,8 @@ declare module '../http/http-operation.js' {
             /** Update */
             interface UpdateDecorator extends HttpOperationDecorator {
                 KeyParam(name: string, optionsOrType?: StrictOmit<HttpParameter.Options, 'location'> | string | TypeThunkAsync): this;
-                Filter(field: OpraSchema.Field.QualifiedName, operators?: OpraFilter.ComparisonOperator[] | string, notes?: string): this;
+                Filter(field: OpraSchema.Field.QualifiedName, operators?: OpraFilter.ComparisonOperator[]): this;
+                Filter(field: string, options?: FilterOptions): this;
             }
             interface UpdateArgs extends StrictOmit<HttpOperation.Options, 'method' | 'requestBody'> {
                 type: Type | string;
@@ -97,7 +107,8 @@ declare module '../http/http-operation.js' {
             }
             /** UpdateMany */
             interface UpdateManyDecorator extends HttpOperationDecorator {
-                Filter(field: OpraSchema.Field.QualifiedName, operators?: OpraFilter.ComparisonOperator[] | string, notes?: string): this;
+                Filter(field: OpraSchema.Field.QualifiedName, operators?: OpraFilter.ComparisonOperator[]): this;
+                Filter(field: string, options?: FilterOptions): this;
             }
             interface UpdateManyArgs extends StrictOmit<HttpOperation.Options, 'method' | 'requestBody'> {
                 type: Type | string;
@@ -110,3 +121,20 @@ declare module '../http/http-operation.js' {
         }
     }
 }
+/**
+ *
+ * @param typ
+ */
+export declare function getDataTypeName(typ: Type | string): string;
+/**
+ *
+ */
+export declare function createKeyParamDecorator<T extends HttpOperationDecorator>(decorator: T, decoratorChain: Function[]): (name: string, prmOptions?: StrictOmit<HttpParameter.Options, "location"> | string | Type) => T;
+/**
+ *
+ */
+export declare function createSortFieldsDecorator<T extends HttpOperationDecorator>(decorator: T, decoratorChain: Function[]): (...varargs: any[]) => T;
+/**
+ *
+ */
+export declare function createFilterDecorator<T extends HttpOperationDecorator>(decorator: T, decoratorChain: Function[], dataType: string | Type): (field: string, arg0?: OpraFilter.ComparisonOperator[] | HttpOperation.Entity.FilterOptions) => T;

package/types/document/http/http-parameter.d.ts

@@ -16,10 +16,12 @@ export declare namespace HttpParameter {
     }
     interface Options extends Partial<StrictOmit<Metadata, 'type'>> {
         type?: string | TypeThunkAsync | object;
+        parser?: (v: any) => any;
     }
     interface InitArguments extends Combine<{
         type?: DataType;
     }, Metadata> {
+        parser?: (v: any) => any;
     }
 }
 /**
@@ -47,6 +49,7 @@ declare class HttpParameterClass extends Value {
     deprecated?: boolean | string;
     required?: boolean;
     arraySeparator?: string;
+    parser?: (v: any) => any;
     toJSON(options?: ApiDocument.ExportOptions): OpraSchema.HttpParameter;
 }
 export {};

package/types/document/index.d.ts

@@ -1,4 +1,13 @@
 import 'reflect-metadata';
+import './decorators/http-operation-entity.decorator.js';
+import './decorators/http-operation-entity-create.decorator.js';
+import './decorators/http-operation-entity-delete.decorator.js';
+import './decorators/http-operation-entity-delete-many.decorator.js';
+import './decorators/http-operation-entity-find-many.decorator.js';
+import './decorators/http-operation-entity-get.decorator.js';
+import './decorators/http-operation-entity-replace.decorator.js';
+import './decorators/http-operation-entity-update.decorator.js';
+import './decorators/http-operation-entity-update-many.decorator.js';
 import * as RpcControllerDecorator_ from './decorators/rpc-controller.decorator.js';
 import * as RpcOperationDecorator_ from './decorators/rpc-operation.decorator.js';
 import * as DataTypeFactory_ from './factory/data-type.factory.js';
@@ -24,7 +33,6 @@ export * from './data-type/pick-type.js';
 export * from './data-type/primitive-types/index.js';
 export * from './data-type/required-type.js';
 export * from './data-type/simple-type.js';
-export * from './decorators/http-operation-entity.decorator.js';
 export type { RpcControllerDecorator } from './decorators/rpc-controller.decorator.js';
 export type { RpcOperationDecorator } from './decorators/rpc-operation.decorator.js';
 export * from './factory/api-document.factory.js';

package/types/filter/antlr/OpraFilterLexer.d.ts

@@ -1,4 +1,4 @@
-import { ATN, CharStream, DFA, Lexer } from '@browsery/antlr4';
+import { ATN, CharStream, DFA, Lexer } from "@browsery/antlr4";
 export default class OpraFilterLexer extends Lexer {
     static readonly T__0 = 1;
     static readonly T__1 = 2;

package/types/filter/antlr/OpraFilterListener.d.ts

@@ -1,5 +1,31 @@
-import { ParseTreeListener } from '@browsery/antlr4';
-import { ArithmeticOperatorContext, ArrayValueContext, BooleanContext, BooleanLiteralContext, ComparisonExpressionContext, ComparisonLeftContext, ComparisonOperatorContext, ComparisonRightContext, DateLiteralContext, DateTimeLiteralContext, ExternalConstantContext, IdentifierContext, InfinityContext, InfinityLiteralContext, LogicalExpressionContext, LogicalOperatorContext, NegativeExpressionContext, NullContext, NullLiteralContext, NumberLiteralContext, ParenthesizedExpressionContext, ParenthesizedItemContext, PolarityOperatorContext, QualifiedIdentifierContext, RootContext, StringLiteralContext, TimeLiteralContext } from './OpraFilterParser.js';
+import { ParseTreeListener } from "@browsery/antlr4";
+import type { RootContext } from "./OpraFilterParser.js";
+import type { ParenthesizedExpressionContext } from "./OpraFilterParser.js";
+import type { NegativeExpressionContext } from "./OpraFilterParser.js";
+import type { ComparisonExpressionContext } from "./OpraFilterParser.js";
+import type { LogicalExpressionContext } from "./OpraFilterParser.js";
+import type { ComparisonLeftContext } from "./OpraFilterParser.js";
+import type { ComparisonRightContext } from "./OpraFilterParser.js";
+import type { ParenthesizedItemContext } from "./OpraFilterParser.js";
+import type { NumberLiteralContext } from "./OpraFilterParser.js";
+import type { InfinityLiteralContext } from "./OpraFilterParser.js";
+import type { BooleanLiteralContext } from "./OpraFilterParser.js";
+import type { NullLiteralContext } from "./OpraFilterParser.js";
+import type { DateTimeLiteralContext } from "./OpraFilterParser.js";
+import type { DateLiteralContext } from "./OpraFilterParser.js";
+import type { TimeLiteralContext } from "./OpraFilterParser.js";
+import { type StringLiteralContext } from "./OpraFilterParser.js";
+import type { QualifiedIdentifierContext } from "./OpraFilterParser.js";
+import type { ExternalConstantContext } from "./OpraFilterParser.js";
+import type { IdentifierContext } from "./OpraFilterParser.js";
+import type { ArrayValueContext } from "./OpraFilterParser.js";
+import type { BooleanContext } from "./OpraFilterParser.js";
+import type { NullContext } from "./OpraFilterParser.js";
+import type { InfinityContext } from "./OpraFilterParser.js";
+import type { ArithmeticOperatorContext } from "./OpraFilterParser.js";
+import type { ComparisonOperatorContext } from "./OpraFilterParser.js";
+import type { LogicalOperatorContext } from "./OpraFilterParser.js";
+import type { PolarityOperatorContext } from "./OpraFilterParser.js";
 /**
  * This interface defines a complete listener for a parse tree produced by
  * `OpraFilterParser`.
@@ -142,29 +168,29 @@ export default class OpraFilterListener extends ParseTreeListener {
      */
     exitNullLiteral?: (ctx: NullLiteralContext) => void;
     /**
-     * Enter a parse tree produced by the `dateLiteral`
+     * Enter a parse tree produced by the `dateTimeLiteral`
      * labeled alternative in `OpraFilterParser.value`.
      * @param ctx the parse tree
      */
-    enterDateLiteral?: (ctx: DateLiteralContext) => void;
+    enterDateTimeLiteral?: (ctx: DateTimeLiteralContext) => void;
     /**
-     * Exit a parse tree produced by the `dateLiteral`
+     * Exit a parse tree produced by the `dateTimeLiteral`
      * labeled alternative in `OpraFilterParser.value`.
      * @param ctx the parse tree
      */
-    exitDateLiteral?: (ctx: DateLiteralContext) => void;
+    exitDateTimeLiteral?: (ctx: DateTimeLiteralContext) => void;
     /**
-     * Enter a parse tree produced by the `dateTimeLiteral`
+     * Enter a parse tree produced by the `dateLiteral`
      * labeled alternative in `OpraFilterParser.value`.
      * @param ctx the parse tree
      */
-    enterDateTimeLiteral?: (ctx: DateTimeLiteralContext) => void;
+    enterDateLiteral?: (ctx: DateLiteralContext) => void;
     /**
-     * Exit a parse tree produced by the `dateTimeLiteral`
+     * Exit a parse tree produced by the `dateLiteral`
      * labeled alternative in `OpraFilterParser.value`.
      * @param ctx the parse tree
      */
-    exitDateTimeLiteral?: (ctx: DateTimeLiteralContext) => void;
+    exitDateLiteral?: (ctx: DateLiteralContext) => void;
     /**
      * Enter a parse tree produced by the `timeLiteral`
      * labeled alternative in `OpraFilterParser.value`.

package/types/filter/antlr/OpraFilterParser.d.ts

@@ -1,4 +1,4 @@
-import { ATN, DFA, FailedPredicateException, Parser, ParserRuleContext, type RuleContext, type TerminalNode, type TokenStream } from '@browsery/antlr4';
+import { ATN, DFA, FailedPredicateException, Parser, ParserRuleContext, RuleContext, TerminalNode, TokenStream } from '@browsery/antlr4';
 import type OpraFilterListener from './OpraFilterListener.js';
 import type OpraFilterVisitor from './OpraFilterVisitor.js';
 export default class OpraFilterParser extends Parser {

package/types/filter/antlr/OpraFilterVisitor.d.ts

@@ -1,5 +1,31 @@
 import { ParseTreeVisitor } from '@browsery/antlr4';
-import { ArithmeticOperatorContext, ArrayValueContext, BooleanContext, BooleanLiteralContext, ComparisonExpressionContext, ComparisonLeftContext, ComparisonOperatorContext, ComparisonRightContext, DateLiteralContext, DateTimeLiteralContext, ExternalConstantContext, IdentifierContext, InfinityContext, InfinityLiteralContext, LogicalExpressionContext, LogicalOperatorContext, NegativeExpressionContext, NullContext, NullLiteralContext, NumberLiteralContext, ParenthesizedExpressionContext, ParenthesizedItemContext, PolarityOperatorContext, QualifiedIdentifierContext, RootContext, StringLiteralContext, TimeLiteralContext } from './OpraFilterParser.js';
+import type { RootContext } from "./OpraFilterParser.js";
+import type { ParenthesizedExpressionContext } from "./OpraFilterParser.js";
+import type { NegativeExpressionContext } from "./OpraFilterParser.js";
+import type { ComparisonExpressionContext } from "./OpraFilterParser.js";
+import type { LogicalExpressionContext } from "./OpraFilterParser.js";
+import type { ComparisonLeftContext } from "./OpraFilterParser.js";
+import type { ComparisonRightContext } from "./OpraFilterParser.js";
+import type { ParenthesizedItemContext } from "./OpraFilterParser.js";
+import type { NumberLiteralContext } from "./OpraFilterParser.js";
+import type { InfinityLiteralContext } from "./OpraFilterParser.js";
+import type { BooleanLiteralContext } from "./OpraFilterParser.js";
+import type { NullLiteralContext } from "./OpraFilterParser.js";
+import type { DateTimeLiteralContext } from "./OpraFilterParser.js";
+import type { DateLiteralContext } from "./OpraFilterParser.js";
+import type { TimeLiteralContext } from "./OpraFilterParser.js";
+import type { StringLiteralContext } from "./OpraFilterParser.js";
+import type { QualifiedIdentifierContext } from "./OpraFilterParser.js";
+import type { ExternalConstantContext } from "./OpraFilterParser.js";
+import type { IdentifierContext } from "./OpraFilterParser.js";
+import type { ArrayValueContext } from "./OpraFilterParser.js";
+import type { BooleanContext } from "./OpraFilterParser.js";
+import type { NullContext } from "./OpraFilterParser.js";
+import type { InfinityContext } from "./OpraFilterParser.js";
+import type { ArithmeticOperatorContext } from "./OpraFilterParser.js";
+import type { ComparisonOperatorContext } from "./OpraFilterParser.js";
+import type { LogicalOperatorContext } from "./OpraFilterParser.js";
+import type { PolarityOperatorContext } from "./OpraFilterParser.js";
 /**
  * This interface defines a complete generic visitor for a parse tree produced
  * by `OpraFilterParser`.
@@ -89,19 +115,19 @@ export default class OpraFilterVisitor<Result> extends ParseTreeVisitor<Result>
      */
     visitNullLiteral?: (ctx: NullLiteralContext) => Result;
     /**
-     * Visit a parse tree produced by the `dateLiteral`
+     * Visit a parse tree produced by the `dateTimeLiteral`
      * labeled alternative in `OpraFilterParser.value`.
      * @param ctx the parse tree
      * @return the visitor result
      */
-    visitDateLiteral?: (ctx: DateLiteralContext) => Result;
+    visitDateTimeLiteral?: (ctx: DateTimeLiteralContext) => Result;
     /**
-     * Visit a parse tree produced by the `dateTimeLiteral`
+     * Visit a parse tree produced by the `dateLiteral`
      * labeled alternative in `OpraFilterParser.value`.
      * @param ctx the parse tree
      * @return the visitor result
      */
-    visitDateTimeLiteral?: (ctx: DateTimeLiteralContext) => Result;
+    visitDateLiteral?: (ctx: DateLiteralContext) => Result;
     /**
      * Visit a parse tree produced by the `timeLiteral`
      * labeled alternative in `OpraFilterParser.value`.

package/types/filter/ast/expressions/comparison-expression.d.ts

@@ -5,6 +5,7 @@ export declare class ComparisonExpression extends Expression {
     op: ComparisonOperator;
     left: Expression;
     right: Expression;
+    prepare?: (value: any, op: ComparisonOperator) => any;
     constructor(o: StrictOmit<ComparisonExpression, 'kind'>);
     toString(): string;
 }

package/types/filter/ast/index.d.ts

@@ -10,6 +10,7 @@ export * from './expressions/negative-expression.js';
 export * from './expressions/parenthesized-expression.js';
 export * from './terms/boolean-literal.js';
 export * from './terms/date-literal.js';
+export * from './terms/date-time-literal.js';
 export * from './terms/null-literal.js';
 export * from './terms/number-literal.js';
 export * from './terms/qualified-identifier.js';

package/types/filter/ast/terms/date-time-literal.d.ts

@@ -0,0 +1,6 @@
+import { Literal } from '../abstract/literal.js';
+export declare class DateTimeLiteral extends Literal {
+    value: string;
+    constructor(value: string | Date);
+    toString(): string;
+}

package/types/filter/filter-rules.d.ts

@@ -12,6 +12,7 @@ export declare namespace FilterRules {
     interface Rule {
         operators?: ComparisonOperator[];
         description?: string;
+        prepare?: (value: any, op: ComparisonOperator) => any;
     }
 }
 export declare class FilterRules {

package/types/filter/filter-tree-visitor.d.ts

@@ -1,7 +1,7 @@
 import { ParseTreeVisitor, type RuleNode } from '@browsery/antlr4';
 import { ArrayValueContext, BooleanLiteralContext, ComparisonExpressionContext, DateLiteralContext, DateTimeLiteralContext, ExternalConstantContext, LogicalExpressionContext, NegativeExpressionContext, NumberLiteralContext, ParenthesizedExpressionContext, ParenthesizedItemContext, QualifiedIdentifierContext, RootContext, StringLiteralContext, TimeLiteralContext } from './antlr/OpraFilterParser.js';
 import OpraFilterVisitor from './antlr/OpraFilterVisitor.js';
-import { ArrayExpression, BooleanLiteral, DateLiteral, LogicalExpression, NegativeExpression, NullLiteral, NumberLiteral, ParenthesizedExpression, QualifiedIdentifier, StringLiteral, TimeLiteral } from './ast/index.js';
+import { ArrayExpression, BooleanLiteral, DateLiteral, DateTimeLiteral, LogicalExpression, NegativeExpression, NullLiteral, NumberLiteral, ParenthesizedExpression, QualifiedIdentifier, StringLiteral, TimeLiteral } from './ast/index.js';
 import { ExternalConstant } from './ast/terms/external-constant.js';
 export declare class FilterTreeVisitor extends ParseTreeVisitor<any> implements OpraFilterVisitor<any> {
     private _timeZone?;
@@ -24,7 +24,7 @@ export declare class FilterTreeVisitor extends ParseTreeVisitor<any> implements
     visitStringLiteral(ctx: StringLiteralContext): StringLiteral;
     visitInfinityLiteral(): NumberLiteral;
     visitDateLiteral(ctx: DateLiteralContext): DateLiteral;
-    visitDateTimeLiteral(ctx: DateTimeLiteralContext): DateLiteral;
+    visitDateTimeLiteral(ctx: DateTimeLiteralContext): DateTimeLiteral;
     visitTimeLiteral(ctx: TimeLiteralContext): TimeLiteral;
     visitArrayValue(ctx: ArrayValueContext): ArrayExpression;
 }

package/types/schema/data-type/field.interface.d.ts

@@ -3,6 +3,11 @@ export declare namespace Field {
     type Name = string;
     type QualifiedName = string;
 }
+/**
+ * Represents a Field type used to define properties and behaviors of a data structure.
+ *
+ * The `Field` type allows describing the characteristics, constraints, and metadata of a field within an entity or data type.
+ */
 export type Field = {
     type?: DataType.Name | DataType;
     /**
@@ -35,9 +40,19 @@ export type Field = {
      */
     exclusive?: boolean;
     /**
-     * Indicates if the field value is an array
+     * A boolean variable that indicates whether the value represents an array or not.
+     * If true, the value is recognized as an array.
+     * If false, the value is not an array.
+     * This property is optional and may be undefined.
      */
     isArray?: boolean;
+    /**
+     * Determines whether the field is a nested entity within a parent structure.
+     * If set to true, the field is considered to be part of a hierarchical or
+     * composite structure. If false or undefined, the field is considered
+     * standalone or root-level.
+     */
+    isNestedEntity?: boolean;
     /**
      * Indicates key field when this field is a ComplexType array
      */