metal-orm 1.0.118 → 1.1.0

package/dist/index.d.cts

@@ -1847,7 +1847,7 @@ declare abstract class Dialect implements SelectCompiler, InsertCompiler, Update
     compileInsert(ast: InsertQueryNode): CompiledQuery;
     compileUpdate(ast: UpdateQueryNode): CompiledQuery;
     compileDelete(ast: DeleteQueryNode): CompiledQuery;
-    supportsReturning(): boolean;
+    supportsDmlReturningClause(): boolean;
     /**
      * Compiles SELECT query AST to SQL (to be implemented by concrete dialects)
      * @param ast - Query AST
@@ -2693,6 +2693,10 @@ type NormalizedRelationIncludeTree = Record<string, NormalizedRelationIncludeNod
 type QueryResult = {
     columns: string[];
     values: unknown[][];
+    meta?: {
+        insertId?: number | string;
+        rowsAffected?: number;
+    };
 };
 interface DbExecutor {
     /** Capability flags so the runtime can make correct decisions without relying on optional methods. */
@@ -3006,6 +3010,313 @@ declare class InterceptorPipeline {
     run(ctx: QueryContext, executor: DbExecutor): Promise<QueryResult[]>;
 }
 
+/**
+ * Interfaces segregadas para cache (ISP - Interface Segregation Principle)
+ */
+/**
+ * Leitura de cache - pode ser implementada por read-replicas
+ */
+interface CacheReader {
+    get<T>(key: string): Promise<T | undefined>;
+    has(key: string): Promise<boolean>;
+}
+/**
+ * Escrita em cache - pode ser implementada por write-nodes
+ */
+interface CacheWriter {
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Invalidação em massa - separada pois nem todo cache suporta tags
+ */
+interface CacheInvalidator {
+    invalidate(key: string): Promise<void>;
+    invalidateTags(tags: string[]): Promise<void>;
+    invalidatePrefix(prefix: string): Promise<void>;
+}
+/**
+ * Interface completa para implementações full-featured
+ */
+interface CacheProvider extends CacheReader, CacheWriter, CacheInvalidator {
+    readonly name: string;
+    dispose?(): Promise<void>;
+}
+/**
+ * TTL human-readable: '1d', '2h', '30m', '15s', '1w'
+ * Ou número em milissegundos
+ */
+type Duration = number | `${number}${'s' | 'm' | 'h' | 'd' | 'w'}`;
+/**
+ * Opções de cache para uma query
+ */
+interface CacheOptions {
+    key: string;
+    ttl: Duration;
+    tags?: string[];
+    autoInvalidate?: boolean;
+    condition?: (result: unknown) => boolean;
+}
+/**
+ * Estratégias de invalidação disponíveis
+ */
+type InvalidationStrategy = 'tags' | 'entity' | 'prefix' | 'key' | 'ttl';
+/**
+ * Estado interno do cache no query builder
+ */
+interface CacheState {
+    options?: CacheOptions;
+}
+
+/**
+ * Estratégia de cache - define como chaves são geradas,
+ * dados são serializados/desserializados e se devem ser cacheados
+ */
+interface CacheStrategy {
+    readonly name: string;
+    /**
+     * Gera chave de cache considerando tenant
+     */
+    generateKey(queryKey: string, tenantId?: string | number): string;
+    /**
+     * Decide se o resultado deve ser cacheado
+     */
+    shouldCache(result: unknown, options: CacheOptions): boolean;
+    /**
+     * Serializa dados para armazenamento
+     */
+    serialize<T>(data: T): unknown;
+    /**
+     * Desserializa dados do cache
+     */
+    deserialize<T>(data: unknown): T;
+}
+
+/**
+ * Gerenciador de cache para queries
+ * Responsabilidade única: orquestrar leitura/escrita no cache (SRP)
+ */
+declare class QueryCacheManager {
+    private provider;
+    private strategy;
+    private defaultTtl;
+    constructor(provider?: CacheProvider, strategy?: CacheStrategy, defaultTtl?: Duration);
+    /**
+     * Executa com cache - padrão execute-around
+     * @returns Resultado da execução (do cache ou da função)
+     */
+    getOrExecute<T>(options: CacheOptions, executor: () => Promise<T>, tenantId?: string | number): Promise<T>;
+    /**
+     * Invalida uma chave específica
+     */
+    invalidateKey(key: string, tenantId?: string | number): Promise<void>;
+    /**
+     * Invalida por tags
+     */
+    invalidateTags(tags: string[]): Promise<void>;
+    /**
+     * Invalida por prefixo (útil para multi-tenancy)
+     */
+    invalidatePrefix(prefix: string): Promise<void>;
+    /**
+     * Limpa todo o cache (cuidado!)
+     */
+    clear(): Promise<void>;
+    /**
+     * Retorna estatísticas do cache (se disponível)
+     */
+    getStats(): {
+        size: number;
+        tags: number;
+    } | undefined;
+    /**
+     * Libera recursos do cache
+     */
+    dispose(): Promise<void>;
+    /**
+     * Registra tags para uma chave
+     */
+    private registerTags;
+    /**
+     * Converte duração para milissegundos
+     */
+    private parseDuration;
+}
+
+/**
+ * Parse de duração human-readable para milissegundos
+ * @param duration - Número (ms) ou string no formato '30s', '10m', '2h', '1d', '1w'
+ * @returns Tempo em milissegundos
+ * @throws Error se o formato for inválido
+ *
+ * @example
+ * parseDuration(60000) // 60000
+ * parseDuration('30s') // 30000
+ * parseDuration('10m') // 600000
+ * parseDuration('2h')  // 7200000
+ * parseDuration('1d')  // 86400000
+ * parseDuration('1w')  // 604800000
+ */
+declare function parseDuration(duration: Duration): number;
+/**
+ * Converte milissegundos para formato human-readable
+ * @param ms - Tempo em milissegundos
+ * @returns String no formato mais apropriado
+ *
+ * @example
+ * formatDuration(30000)  // '30s'
+ * formatDuration(600000) // '10m'
+ * formatDuration(7200000) // '2h'
+ */
+declare function formatDuration(ms: number): string;
+/**
+ * Valida se uma string é uma duração válida
+ * @param value - Valor a ser validado
+ * @returns true se for uma duração válida
+ */
+declare function isValidDuration(value: unknown): value is Duration;
+
+/**
+ * Implementação padrão da estratégia de cache
+ * Suporta serialização de Date, BigInt e multi-tenancy
+ */
+declare class DefaultCacheStrategy implements CacheStrategy {
+    readonly name = "default";
+    /**
+     * Gera chave de cache com prefixo de tenant se houver
+     */
+    generateKey(queryKey: string, tenantId?: string | number): string;
+    /**
+     * Verifica se deve cachear baseado na condição configurada
+     */
+    shouldCache(result: unknown, options: CacheOptions): boolean;
+    /**
+     * Serializa com suporte a tipos especiais
+     */
+    serialize<T>(data: T): unknown;
+    /**
+     * Desserializa restaurando tipos especiais
+     */
+    deserialize<T>(data: unknown): T;
+}
+
+/**
+ * Implementação em memória do cache provider
+ * Útil para testes e ambientes de desenvolvimento
+ */
+declare class MemoryCacheAdapter implements CacheProvider {
+    readonly name = "memory";
+    private storage;
+    private tagIndex;
+    get<T>(key: string): Promise<T | undefined>;
+    has(key: string): Promise<boolean>;
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    invalidate(key: string): Promise<void>;
+    invalidateTags(tags: string[]): Promise<void>;
+    invalidatePrefix(prefix: string): Promise<void>;
+    /**
+     * Registra uma chave com tags (para invalidação)
+     */
+    registerTags(key: string, tags: string[]): void;
+    /**
+     * Limpa todo o cache
+     */
+    clear(): void;
+    /**
+     * Retorna estatísticas do cache
+     */
+    getStats(): {
+        size: number;
+        tags: number;
+    };
+    dispose(): Promise<void>;
+}
+
+/**
+ * Interface mínima para Keyv
+ * Usa unknown para permitir diferentes versões do Keyv
+ */
+interface KeyvInstance {
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttl?: number): Promise<boolean | void>;
+    delete(key: string): Promise<boolean>;
+    iterator?: unknown;
+    disconnect?(): Promise<void>;
+}
+/**
+ * Adapter para Keyv (Redis, SQLite, etc.)
+ * Keyv deve ser instalado separadamente:
+ * npm install keyv @keyv/redis
+ */
+declare class KeyvCacheAdapter implements CacheProvider {
+    private keyv;
+    readonly name = "keyv";
+    constructor(keyv: KeyvInstance);
+    get<T>(key: string): Promise<T | undefined>;
+    has(key: string): Promise<boolean>;
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    invalidate(key: string): Promise<void>;
+    invalidateTags(_tags: string[]): Promise<void>;
+    invalidatePrefix(prefix: string): Promise<void>;
+    dispose(): Promise<void>;
+}
+
+/**
+ * Indexa chaves por tags para invalidação em massa
+ * Implementação em memória (pode ser persistida no Redis)
+ */
+declare class TagIndex {
+    private tagToKeys;
+    private keyToTags;
+    /**
+     * Registra que uma chave pertence a determinadas tags
+     */
+    register(key: string, tags: string[]): void;
+    /**
+     * Remove uma chave do índice
+     */
+    unregister(key: string): void;
+    /**
+     * Obtém todas as chaves de uma tag
+     */
+    getKeysByTag(tag: string): string[];
+    /**
+     * Obtém todas as tags de uma chave
+     */
+    getTagsByKey(key: string): string[];
+    /**
+     * Invalida todas as chaves de um conjunto de tags
+     * Retorna as chaves afetadas
+     */
+    invalidateTags(tags: string[]): string[];
+    /**
+     * Invalida por prefixo (útil para multi-tenancy)
+     * Retorna as chaves afetadas
+     */
+    invalidatePrefix(prefix: string): string[];
+    /**
+     * Retorna todas as tags registradas
+     */
+    getAllTags(): string[];
+    /**
+     * Retorna todas as chaves registradas
+     */
+    getAllKeys(): string[];
+    /**
+     * Limpa todo o índice
+     */
+    clear(): void;
+    /**
+     * Retorna estatísticas do índice
+     */
+    getStats(): {
+        tags: number;
+        keys: number;
+    };
+}
+
 /**
  * Options for creating an ORM instance.
  */
@@ -3018,6 +3329,19 @@ interface OrmOptions {
     interceptors?: InterceptorPipeline;
     /** Optional naming strategy */
     namingStrategy?: NamingStrategy;
+    /** Optional cache configuration */
+    cache?: OrmCacheOptions;
+}
+/**
+ * Cache configuration options for ORM
+ */
+interface OrmCacheOptions {
+    /** Cache provider (e.g., MemoryCacheAdapter, KeyvCacheAdapter) */
+    provider: CacheProvider;
+    /** Optional cache strategy (defaults to DefaultCacheStrategy) */
+    strategy?: CacheStrategy;
+    /** Default TTL for cached queries (e.g., '1h', '30m') */
+    defaultTtl?: Duration;
 }
 /**
  * Database executor factory interface.
@@ -3049,6 +3373,8 @@ declare class Orm<E extends DomainEvent = OrmDomainEvent> {
     readonly interceptors: InterceptorPipeline;
     /** The naming strategy */
     readonly namingStrategy: NamingStrategy;
+    /** The cache manager (if configured) */
+    readonly cacheManager?: QueryCacheManager;
     private readonly executorFactory;
     /**
      * Creates a new ORM instance.
@@ -3057,10 +3383,12 @@ declare class Orm<E extends DomainEvent = OrmDomainEvent> {
     constructor(opts: OrmOptions);
     /**
      * Creates a new ORM session.
-     * @param options - Optional session options
+     * @param options - Optional session options (e.g., tenantId for multi-tenancy)
      * @returns The ORM session
      */
-    createSession(): OrmSession<E>;
+    createSession(options?: {
+        tenantId?: string | number;
+    }): OrmSession<E>;
     /**
      * Executes a function within a transaction.
      * @template T - The return type
@@ -3306,6 +3634,13 @@ declare class UnitOfWork {
      * @param results - Query results
      */
     private applyReturningResults;
+    /**
+     * Applies the driver-provided insertId when no RETURNING clause was used.
+     * Only sets the PK if it is currently absent on the entity.
+     * @param tracked - The tracked entity
+     * @param results - Query results (may contain meta.insertId)
+     */
+    private applyInsertedIdIfAbsent;
     /**
      * Normalizes a column name by removing quotes and table prefixes.
      * @param column - The column name to normalize
@@ -3641,6 +3976,10 @@ interface OrmSessionOptions<E extends DomainEvent = OrmDomainEvent> {
     interceptors?: OrmInterceptor[];
     /** Optional domain event handlers */
     domainEventHandlers?: InitialHandlers<E, OrmSession<E>>;
+    /** Optional cache manager for query caching */
+    cacheManager?: QueryCacheManager;
+    /** Optional tenant ID for multi-tenancy */
+    tenantId?: string | number;
 }
 interface SaveGraphSessionOptions extends SaveGraphOptions {
     /** Wrap the save operation in a transaction (default: true). */
@@ -3665,6 +4004,10 @@ declare class OrmSession<E extends DomainEvent = OrmDomainEvent> implements Enti
     readonly domainEvents: DomainEventBus<E, OrmSession<E>>;
     /** The relation change processor */
     readonly relationChanges: RelationChangeProcessor;
+    /** The cache manager for query caching */
+    readonly cacheManager?: QueryCacheManager;
+    /** The tenant ID for multi-tenancy support */
+    readonly tenantId?: string | number;
     private readonly interceptors;
     private saveGraphDefaults?;
     /**
@@ -3863,6 +4206,30 @@ declare class OrmSession<E extends DomainEvent = OrmDomainEvent> implements Enti
      * @returns The hydration context
      */
     getHydrationContext(): HydrationContext<E>;
+    /**
+     * Invalidates cache by specific tags.
+     * @param tags - Tags to invalidate
+     * @throws Error if no cache manager is configured
+     * @example
+     * await session.invalidateCacheTags(['users', 'dashboard']);
+     */
+    invalidateCacheTags(tags: string[]): Promise<void>;
+    /**
+     * Invalidates cache by key prefix (useful for multi-tenancy).
+     * @param prefix - Prefix to match cache keys
+     * @throws Error if no cache manager is configured
+     * @example
+     * await session.invalidateCachePrefix('tenant:123:');
+     */
+    invalidateCachePrefix(prefix: string): Promise<void>;
+    /**
+     * Invalidates a specific cache key.
+     * @param key - Cache key to invalidate
+     * @throws Error if no cache manager is configured
+     * @example
+     * await session.invalidateCacheKey('active_users');
+     */
+    invalidateCacheKey(key: string): Promise<void>;
     /**
      * Merges session defaults with per-call saveGraph options.
      * @param options - Per-call saveGraph options
@@ -3882,6 +4249,14 @@ interface PaginatedResult<T> {
     pageSize: number;
 }
 
+/**
+ * Facet para gerenciar estado de cache no SelectQueryBuilder
+ * Segue o padrão de facets existente no projeto
+ */
+interface CacheFacetContext {
+    state: CacheState;
+}
+
 type SelectDialectInput = Dialect | DialectKey;
 
 type ColumnSelectionValue = ColumnDef | FunctionNode | CaseExpressionNode | WindowFunctionNode | TypedExpression<unknown>;
@@ -3919,6 +4294,8 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
     private readonly lazyRelationOptions;
     private readonly entityConstructor?;
     private readonly includeTree;
+    private readonly cacheFacet;
+    private readonly cacheContext;
     /**
      * Creates a new SelectQueryBuilder instance
      * @param table - Table definition to query
@@ -3926,7 +4303,7 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      * @param hydration - Optional hydration manager
      * @param dependencies - Optional query builder dependencies
      */
-    constructor(table: TTable, state?: SelectQueryState, hydration?: HydrationManager, dependencies?: Partial<SelectQueryBuilderDependencies>, lazyRelations?: Set<string>, lazyRelationOptions?: Map<string, RelationIncludeOptions>, entityConstructor?: EntityConstructor, includeTree?: NormalizedRelationIncludeTree);
+    constructor(table: TTable, state?: SelectQueryState, hydration?: HydrationManager, dependencies?: Partial<SelectQueryBuilderDependencies>, lazyRelations?: Set<string>, lazyRelationOptions?: Map<string, RelationIncludeOptions>, entityConstructor?: EntityConstructor, includeTree?: NormalizedRelationIncludeTree, cacheContext?: CacheFacetContext);
     /**
      * Creates a new SelectQueryBuilder instance with updated context and lazy relations
      * @param context - Updated query context
@@ -4247,10 +4624,35 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      * Ensures that if no columns are selected, all columns from the table are selected by default.
      */
     private ensureDefaultSelection;
+    /**
+     * Configures caching for this query.
+     * @param key - Unique cache key
+     * @param ttl - Time-to-live (e.g., '1h', '30m', '1d') or milliseconds
+     * @param tagsOrConfig - Optional tags for invalidation or configuration object
+     * @returns New query builder instance with cache configuration
+     * @example
+     * // Simple cache with TTL
+     * await selectFrom(User).cache('active_users', '1h').execute(session);
+     *
+     * // Cache with tags for invalidation
+     * await selectFrom(User)
+     *   .cache('users_list', '30m', ['users', 'dashboard'])
+     *   .execute(session);
+     *
+     * // Cache with auto-invalidation
+     * await selectFrom(User)
+     *   .cache('users_list', '1h', { autoInvalidate: true })
+     *   .execute(session);
+     */
+    cache(key: string, ttl: Duration, tagsOrConfig?: string[] | {
+        tags?: string[];
+        autoInvalidate?: boolean;
+    }): SelectQueryBuilder<T, TTable>;
     /**
      * Executes the query and returns hydrated results.
      * If the builder was created with an entity constructor (e.g. via selectFromEntity),
      * this will automatically return fully materialized entity instances.
+     * If caching is configured, results will be cached/retrieved from cache.
      *
      * @param ctx - ORM session context
      * @returns Promise of entity instances (or objects if generic T is not an entity)
@@ -4260,6 +4662,10 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
      * users[0] instanceof User; // true
      */
     execute(ctx: OrmSession): Promise<T[]>;
+    /**
+     * Executa a query sem cache (método interno)
+     */
+    private executeWithoutCache;
     /**
      * Executes the query and returns plain row objects (POJOs), ignoring any entity materialization.
      * Use this if you want raw data even when using selectFromEntity.
@@ -5141,9 +5547,15 @@ declare class SqlServerDialect extends SqlDialectBase {
      */
     protected compileSelectAst(ast: SelectQueryNode, ctx: CompilerContext): string;
     protected compileDeleteAst(ast: DeleteQueryNode, ctx: CompilerContext): string;
+    protected compileUpdateAst(ast: UpdateQueryNode, ctx: CompilerContext): string;
     private compileSelectCoreForMssql;
     private compileOrderBy;
     private compilePagination;
+    supportsDmlReturningClause(): boolean;
+    protected compileReturning(returning: ColumnNode[] | undefined, _ctx: CompilerContext): string;
+    private compileOutputClause;
+    protected compileInsertAst(ast: InsertQueryNode, ctx: CompilerContext): string;
+    private compileInsertValues;
     private compileCtes;
 }
 
@@ -5171,7 +5583,7 @@ declare class SqliteDialect extends SqlDialectBase {
     protected compileQualifiedColumn(column: ColumnNode, _table: TableNode): string;
     protected compileReturning(returning: ColumnNode[] | undefined, ctx: CompilerContext): string;
     protected formatReturningColumns(returning: ColumnNode[]): string;
-    supportsReturning(): boolean;
+    supportsDmlReturningClause(): boolean;
 }
 
 /**
@@ -5197,7 +5609,7 @@ declare class PostgresDialect extends SqlDialectBase {
      */
     protected compileJsonPath(node: JsonPathNode): string;
     protected compileReturning(returning: ColumnNode[] | undefined, ctx: CompilerContext): string;
-    supportsReturning(): boolean;
+    supportsDmlReturningClause(): boolean;
     /**
      * PostgreSQL requires unqualified column names in SET clause
      */
@@ -9099,4 +9511,4 @@ declare function setTreeBounds(entity: object, config: TreeConfig, lft: number,
  */
 declare function setTreeParentId(entity: object, config: TreeConfig, parentId: unknown): void;
 
-export { type AliasRefNode, Alphanumeric, type AnyDomainEvent, type ApiRouteDefinition, type ApplyFilterOptions, type ArithmeticExpressionNode, type TableRef as AstTableRef, AsyncLocalStorage, type AutoCorrectionResult, type AutoTransformResult, type AutoTransformableValidator, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToManyRelation, type BelongsToOptions, type BelongsToReference, type BelongsToReferenceApi, type BelongsToRelation, type BetweenExpressionNode, BigIntTypeStrategy, type BinaryExpressionNode, BinaryTypeStrategy, type BitwiseExpressionNode, type BooleanFilter, BooleanTypeStrategy, CEP, CNPJ, CPF, Capitalize, type CascadeMode, type CaseExpressionNode, type CastExpressionNode, type CheckConstraint, type CollateExpressionNode, Column, type ColumnDef, type ColumnDiff, type ColumnInput, type ColumnNode, type ColumnOptions, type ColumnRef, type ColumnToTs, type ColumnType, type ComponentOptions, type ComponentReference, type CompositeTransformer, ConstructorMaterializationStrategy, type ValidationResult as CountryValidationResult, type CountryValidator, type CountryValidatorFactory, type CreateDto, type CreateTediousClientOptions, DEFAULT_TREE_CONFIG, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, type DatabaseView, type DateFilter, DateTimeTypeStrategy, type DbExecutor, type DbExecutorFactory, DecimalTypeStrategy, type DecoratedEntityInstance, DefaultBelongsToReference, DefaultEntityMaterializer, DefaultHasManyCollection, DefaultManyToManyCollection, DefaultTypeStrategy, type DefaultValue, DeleteQueryBuilder, type DialectName, type DomainEvent, DomainEventBus, type DomainEventHandler, type Dto, Email, Entity, type EntityContext, type EntityInstance, type EntityMaterializationStrategy, type EntityMaterializer, type EntityOptions, type PrimaryKey$1 as EntityPrimaryKey, EntityStatus, type ExecutionContext, type ExistsExpressionNode, type ExpressionNode, type ExpressionVisitor, type FieldFilter, type FilterOperator, type FilterValue, type FindChildrenOptions, type FindPathOptions, type ForeignKeyReference, type FunctionNode, type GroupConcatOptions, type HasDomainEvents, HasMany, type HasManyCollection, type HasManyOptions, type HasManyRelation, HasOne, type HasOneOptions, type HasOneReference, type HasOneReferenceApi, type HasOneRelation, type HydrationContext, type HydrationMetadata, type HydrationPivotPlan, type HydrationPlan, type HydrationRelationPlan, type InExpressionNode, type InExpressionRight, type IndexColumn, type IndexDef, type InferRow, type InitialHandlers, InsertQueryBuilder, IntegerTypeStrategy, InterceptorPipeline, type IntrospectOptions, type JsonArray, type JsonObject, type JsonPathNode, type JsonValue, type Jsonify, type JsonifyScalar, Length, type LiteralNode, type LiteralValue, type LogicalExpressionNode, Lower, type ManyToManyCollection, type MoveOptions, type MssqlClientLike, MySqlDialect, type MysqlClientLike, type NestedDtoOptions, type NestedSetBounds, type NestedSetRow, NestedSetStrategy, type NodeWithPk, type NullExpressionNode, type NumberFilter, type OpenApiComponent, type OpenApiDialect, type OpenApiDocument, type OpenApiDocumentInfo, type OpenApiDocumentOptions, type OpenApiOperation, type OpenApiParameter, type OpenApiParameterObject, type OpenApiResponseObject, type OpenApiSchema, type OpenApiType, type OperandNode, type OperandVisitor, Orm, type OrmDomainEvent, type OrmInterceptor, type OrmOptions, OrmSession, type OrmSessionOptions, type PagedResponse, type PaginatedResult, type PaginationParams, type PatchGraphInputPayload, Pattern, Pool, type PoolAdapter, type PoolLease, type PoolOptions, type PooledConnectionAdapter, type PostgresClientLike, PostgresDialect, PrimaryKey, type Primitive, type PropertySanitizer, type PropertyTransformer, type PropertyValidator, PrototypeMaterializationStrategy, type QueryContext, type QueryInterceptor, type QueryLogEntry, type QueryLogger, type QueryResult, type RawDefaultValue, type RecoverResult, type ReferentialAction, type RelationChange, type RelationChangeEntry, type RelationDef, type RelationFilter, type RelationKey$1 as RelationKey, RelationKinds, type RelationMap, type RelationTargetTable, type RelationType, type RenderColumnOptions, STANDARD_COLUMN_TYPES, type SaveGraphInputPayload, type SaveGraphInputScalar, type SaveGraphJsonScalar, type SaveGraphSessionOptions, type ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaGenerateResult, type SchemaIntrospector, type SchemaPlan, SelectQueryBuilder, type SelectQueryInput, type SelectableKeys, type SimpleQueryRunner, type SimpleWhereInput, type Simplify, SqlServerDialect, type SqliteClientLike, SqliteDialect, type StandardColumnType, type StringFilter, StringTypeStrategy, type SynchronizeOptions, type TableDef, type TableHooks, type TableOptions, type TableRef$1 as TableRef, type TargetType, type TediousColumn, type TediousConnectionLike, type TediousModule, type TediousRequest, type TediousRequestCtor, type TediousTypes, type ThreadedNode, Title, type ToJsonOptions, type TrackedEntity, type TransformContext, type TransformerConfig, type TransformerMetadata, Tree, TreeChildren, type TreeColumns, type TreeConfig, type TreeDecoratorOptions, type TreeInsertData, type TreeListEntry, type TreeListOptions, type TreeListSchemaOptions, TreeManager, type TreeManagerOptions, type TreeMetadata, type TreeMoveData, type TreeNode, type TreeNodeResult, type TreeNodeResultSchemaOptions, type TreeNodeSchemaOptions, TreeParent, type TreeQuery, type TreeScope, type TreeValidationResult, Trim, TypeMappingService, type TypeMappingStrategy, TypeScriptGenerator, type TypedExpression, type TypedLike, type UpdateDto, UpdateQueryBuilder, Upper, UuidTypeStrategy, type ValidationOptions, type ValidationResult$1 as ValidationResult, type ValidatorFactoryOptions, type ValueOperandInput, type WhereInput, type WindowFunctionNode, type WithRelations, abs, acos, add, addDomainEvent, age, aliasRef, and, applyFilter, applyNullability, arrayAppend, asType, ascii, asin, atan, atan2, avg, belongsTo, belongsToMany, between, bitAnd, bitLength, bitOr, bitXor, bootstrapEntities, buildFilterExpression, buildScopeConditions, calculateRowDepths, calculateTotalPages, canonicalizeSchema, caseWhen, cast, cbrt, ceil, ceiling, char, charLength, chr, clearExpressionDispatchers, clearOperandDispatchers, coalesce, col, collate, columnOperand, columnToFilterSchema, columnToOpenApiSchema, columnTypeToOpenApiFormat, columnTypeToOpenApiType, computePaginationMetadata, computeSchemaHash, concat, concatWs, correlateBy, cos, cot, count, countAll, createApiComponentsSection, createDeterministicNamingState, createDtoToOpenApiSchema, createEntityFromRow, createEntityProxy, createExecutorFromQueryRunner, createMssqlExecutor, createMysqlExecutor, createPooledExecutorFactory, createPostgresExecutor, createQueryLoggingExecutor, createRef, createSqliteExecutor, createTediousExecutor, createTediousMssqlClient, createTreeManager, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, deepCloneSchema, defineTable, degrees, deleteFrom, denseRank, diffSchema, div, dtoToOpenApiSchema, endOfMonth, entityRef, entityRefs, eq, esel, exclude, executeHydrated, executeHydratedPlain, executeHydratedPlainWithContexts, executeHydratedWithContexts, executeSchemaSql, executeSchemaSqlFor, exists, exp, extract, extractReusableSchemas, extractScopeValues, firstValue, floor, formatTreeList, fromUnixTime, generateComponentSchemas, generateCreateTableSql, generateOpenApiDocument, generateRelationComponents, generateSchemaSql, generateSchemaSqlFor, generateTreeComponents, getColumn, getColumnMap, getColumnType, getDateKind, getDecoratorMetadata, getDeterministicComponentName, getOpenApiVersionForDialect, getRegisteredValidators, getSchemaIntrospector, getTableDefFromEntity, getTreeBounds, getTreeColumns, getTreeConfig, getTreeMetadata, getTreeParentId, greatest, groupConcat, gt, gte, hasMany, hasNextPage as hasNextPageMeta, hasOne, hasPrevPage as hasPrevPageMeta, hasTreeBehavior, hasValidator, hour, hydrateRows, ifNull, inList, inSubquery, initcap, insertInto, instr, introspectSchema, isCaseExpressionNode, isCastExpressionNode, isCollateExpressionNode, isComponentReference, isExpressionSelectionNode, isFunctionNode, isNotNull, isNull, isNullableColumn, isOperandNode, isTableDef, isTreeConfig, isValueOperandInput, isWindowFunctionNode, jsonArrayAgg, jsonContains, jsonLength, jsonPath, jsonSet, jsonify, lag, lastValue, lead, least, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, localTime, localTimestamp, locate, log, log10, log2, logBase, lower, lpad, lt, lte, ltrim, mapFields, materializeAs, max, md5, mergeSchemas, min, minute, mod, month, mul, neq, nestedDtoToOpenApiSchema, nestedWhereInputToOpenApiSchema, normalizeColumnType, notBetween, notExists, notInList, notInSubquery, notLike, now, ntile, nullif, octetLength, or, outerRef, pagedResponseToOpenApiSchema, paginationParamsSchema, parameterToRef, pi, pick, position, pow, power, quarter, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, registerValidator, relationFilterToOpenApiSchema, relationLoaderCache, renderColumnDefinition, renderTypeWithArgs, repeat, replace, replaceWithRefs, resolveTreeConfig, resolveValidator, responseToRef, reverse, right, round, rowNumber, rowsToQueryResult, rpad, rtrim, schemaToJson, schemaToRef, second, sel, selectFrom, selectFromEntity, setRelations, setTreeBounds, setTreeMetadata, setTreeParentId, sha1, sha2, shiftLeft, shiftRight, sign, sin, space, sqrt, stddev, sub, substr, sum, synchronizeSchema, tableRef, tan, threadResults, threadedNodeToOpenApiSchema, toColumnRef, toPagedResponse, toPagedResponseBuilder, toPaginationParams, toResponse, toResponseBuilder, toTableRef, treeEntityRegistry, treeListEntryToOpenApiSchema, treeNodeResultToOpenApiSchema, treeNodeToOpenApiSchema, treeQuery, trim, trunc, truncate, typeMappingService, unixTimestamp, update, updateDtoToOpenApiSchema, updateDtoWithRelationsToOpenApiSchema, upper, utcNow, validateTreeTable, valueToOperand, variance, visitExpression, visitOperand, weekOfYear, whereInputToOpenApiSchema, whereInputWithRelationsToOpenApiSchema, windowFunction, withDefaults, withDefaultsBuilder, year };
+export { type AliasRefNode, Alphanumeric, type AnyDomainEvent, type ApiRouteDefinition, type ApplyFilterOptions, type ArithmeticExpressionNode, type TableRef as AstTableRef, AsyncLocalStorage, type AutoCorrectionResult, type AutoTransformResult, type AutoTransformableValidator, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToManyRelation, type BelongsToOptions, type BelongsToReference, type BelongsToReferenceApi, type BelongsToRelation, type BetweenExpressionNode, BigIntTypeStrategy, type BinaryExpressionNode, BinaryTypeStrategy, type BitwiseExpressionNode, type BooleanFilter, BooleanTypeStrategy, CEP, CNPJ, CPF, type CacheInvalidator, type CacheOptions, type CacheProvider, type CacheReader, type CacheState, type CacheStrategy, type CacheWriter, Capitalize, type CascadeMode, type CaseExpressionNode, type CastExpressionNode, type CheckConstraint, type CollateExpressionNode, Column, type ColumnDef, type ColumnDiff, type ColumnInput, type ColumnNode, type ColumnOptions, type ColumnRef, type ColumnToTs, type ColumnType, type ComponentOptions, type ComponentReference, type CompositeTransformer, ConstructorMaterializationStrategy, type ValidationResult as CountryValidationResult, type CountryValidator, type CountryValidatorFactory, type CreateDto, type CreateTediousClientOptions, DEFAULT_TREE_CONFIG, type DatabaseCheck, type DatabaseColumn, type DatabaseIndex, type DatabaseSchema, type DatabaseTable, type DatabaseView, type DateFilter, DateTimeTypeStrategy, type DbExecutor, type DbExecutorFactory, DecimalTypeStrategy, type DecoratedEntityInstance, DefaultBelongsToReference, DefaultCacheStrategy, DefaultEntityMaterializer, DefaultHasManyCollection, DefaultManyToManyCollection, DefaultTypeStrategy, type DefaultValue, DeleteQueryBuilder, type DialectName, type DomainEvent, DomainEventBus, type DomainEventHandler, type Dto, type Duration, Email, Entity, type EntityContext, type EntityInstance, type EntityMaterializationStrategy, type EntityMaterializer, type EntityOptions, type PrimaryKey$1 as EntityPrimaryKey, EntityStatus, type ExecutionContext, type ExistsExpressionNode, type ExpressionNode, type ExpressionVisitor, type FieldFilter, type FilterOperator, type FilterValue, type FindChildrenOptions, type FindPathOptions, type ForeignKeyReference, type FunctionNode, type GroupConcatOptions, type HasDomainEvents, HasMany, type HasManyCollection, type HasManyOptions, type HasManyRelation, HasOne, type HasOneOptions, type HasOneReference, type HasOneReferenceApi, type HasOneRelation, type HydrationContext, type HydrationMetadata, type HydrationPivotPlan, type HydrationPlan, type HydrationRelationPlan, type InExpressionNode, type InExpressionRight, type IndexColumn, type IndexDef, type InferRow, type InitialHandlers, InsertQueryBuilder, IntegerTypeStrategy, InterceptorPipeline, type IntrospectOptions, type InvalidationStrategy, type JsonArray, type JsonObject, type JsonPathNode, type JsonValue, type Jsonify, type JsonifyScalar, KeyvCacheAdapter, Length, type LiteralNode, type LiteralValue, type LogicalExpressionNode, Lower, type ManyToManyCollection, MemoryCacheAdapter, type MoveOptions, type MssqlClientLike, MySqlDialect, type MysqlClientLike, type NestedDtoOptions, type NestedSetBounds, type NestedSetRow, NestedSetStrategy, type NodeWithPk, type NullExpressionNode, type NumberFilter, type OpenApiComponent, type OpenApiDialect, type OpenApiDocument, type OpenApiDocumentInfo, type OpenApiDocumentOptions, type OpenApiOperation, type OpenApiParameter, type OpenApiParameterObject, type OpenApiResponseObject, type OpenApiSchema, type OpenApiType, type OperandNode, type OperandVisitor, Orm, type OrmCacheOptions, type OrmDomainEvent, type OrmInterceptor, type OrmOptions, OrmSession, type OrmSessionOptions, type PagedResponse, type PaginatedResult, type PaginationParams, type PatchGraphInputPayload, Pattern, Pool, type PoolAdapter, type PoolLease, type PoolOptions, type PooledConnectionAdapter, type PostgresClientLike, PostgresDialect, PrimaryKey, type Primitive, type PropertySanitizer, type PropertyTransformer, type PropertyValidator, PrototypeMaterializationStrategy, QueryCacheManager, type QueryContext, type QueryInterceptor, type QueryLogEntry, type QueryLogger, type QueryResult, type RawDefaultValue, type RecoverResult, type ReferentialAction, type RelationChange, type RelationChangeEntry, type RelationDef, type RelationFilter, type RelationKey$1 as RelationKey, RelationKinds, type RelationMap, type RelationTargetTable, type RelationType, type RenderColumnOptions, STANDARD_COLUMN_TYPES, type SaveGraphInputPayload, type SaveGraphInputScalar, type SaveGraphJsonScalar, type SaveGraphSessionOptions, type ScalarSubqueryNode, type SchemaChange, type SchemaChangeKind, type SchemaDiffOptions, type SchemaGenerateResult, type SchemaIntrospector, type SchemaPlan, SelectQueryBuilder, type SelectQueryInput, type SelectableKeys, type SimpleQueryRunner, type SimpleWhereInput, type Simplify, SqlServerDialect, type SqliteClientLike, SqliteDialect, type StandardColumnType, type StringFilter, StringTypeStrategy, type SynchronizeOptions, type TableDef, type TableHooks, type TableOptions, type TableRef$1 as TableRef, TagIndex, type TargetType, type TediousColumn, type TediousConnectionLike, type TediousModule, type TediousRequest, type TediousRequestCtor, type TediousTypes, type ThreadedNode, Title, type ToJsonOptions, type TrackedEntity, type TransformContext, type TransformerConfig, type TransformerMetadata, Tree, TreeChildren, type TreeColumns, type TreeConfig, type TreeDecoratorOptions, type TreeInsertData, type TreeListEntry, type TreeListOptions, type TreeListSchemaOptions, TreeManager, type TreeManagerOptions, type TreeMetadata, type TreeMoveData, type TreeNode, type TreeNodeResult, type TreeNodeResultSchemaOptions, type TreeNodeSchemaOptions, TreeParent, type TreeQuery, type TreeScope, type TreeValidationResult, Trim, TypeMappingService, type TypeMappingStrategy, TypeScriptGenerator, type TypedExpression, type TypedLike, type UpdateDto, UpdateQueryBuilder, Upper, UuidTypeStrategy, type ValidationOptions, type ValidationResult$1 as ValidationResult, type ValidatorFactoryOptions, type ValueOperandInput, type WhereInput, type WindowFunctionNode, type WithRelations, abs, acos, add, addDomainEvent, age, aliasRef, and, applyFilter, applyNullability, arrayAppend, asType, ascii, asin, atan, atan2, avg, belongsTo, belongsToMany, between, bitAnd, bitLength, bitOr, bitXor, bootstrapEntities, buildFilterExpression, buildScopeConditions, calculateRowDepths, calculateTotalPages, canonicalizeSchema, caseWhen, cast, cbrt, ceil, ceiling, char, charLength, chr, clearExpressionDispatchers, clearOperandDispatchers, coalesce, col, collate, columnOperand, columnToFilterSchema, columnToOpenApiSchema, columnTypeToOpenApiFormat, columnTypeToOpenApiType, computePaginationMetadata, computeSchemaHash, concat, concatWs, correlateBy, cos, cot, count, countAll, createApiComponentsSection, createDeterministicNamingState, createDtoToOpenApiSchema, createEntityFromRow, createEntityProxy, createExecutorFromQueryRunner, createMssqlExecutor, createMysqlExecutor, createPooledExecutorFactory, createPostgresExecutor, createQueryLoggingExecutor, createRef, createSqliteExecutor, createTediousExecutor, createTediousMssqlClient, createTreeManager, currentDate, currentTime, dateAdd, dateDiff, dateFormat, dateSub, dateTrunc, day, dayOfWeek, deepCloneSchema, defineTable, degrees, deleteFrom, denseRank, diffSchema, div, dtoToOpenApiSchema, endOfMonth, entityRef, entityRefs, eq, esel, exclude, executeHydrated, executeHydratedPlain, executeHydratedPlainWithContexts, executeHydratedWithContexts, executeSchemaSql, executeSchemaSqlFor, exists, exp, extract, extractReusableSchemas, extractScopeValues, firstValue, floor, formatDuration, formatTreeList, fromUnixTime, generateComponentSchemas, generateCreateTableSql, generateOpenApiDocument, generateRelationComponents, generateSchemaSql, generateSchemaSqlFor, generateTreeComponents, getColumn, getColumnMap, getColumnType, getDateKind, getDecoratorMetadata, getDeterministicComponentName, getOpenApiVersionForDialect, getRegisteredValidators, getSchemaIntrospector, getTableDefFromEntity, getTreeBounds, getTreeColumns, getTreeConfig, getTreeMetadata, getTreeParentId, greatest, groupConcat, gt, gte, hasMany, hasNextPage as hasNextPageMeta, hasOne, hasPrevPage as hasPrevPageMeta, hasTreeBehavior, hasValidator, hour, hydrateRows, ifNull, inList, inSubquery, initcap, insertInto, instr, introspectSchema, isCaseExpressionNode, isCastExpressionNode, isCollateExpressionNode, isComponentReference, isExpressionSelectionNode, isFunctionNode, isNotNull, isNull, isNullableColumn, isOperandNode, isTableDef, isTreeConfig, isValidDuration, isValueOperandInput, isWindowFunctionNode, jsonArrayAgg, jsonContains, jsonLength, jsonPath, jsonSet, jsonify, lag, lastValue, lead, least, left, length, like, ln, loadBelongsToManyRelation, loadBelongsToRelation, loadHasManyRelation, loadHasOneRelation, localTime, localTimestamp, locate, log, log10, log2, logBase, lower, lpad, lt, lte, ltrim, mapFields, materializeAs, max, md5, mergeSchemas, min, minute, mod, month, mul, neq, nestedDtoToOpenApiSchema, nestedWhereInputToOpenApiSchema, normalizeColumnType, notBetween, notExists, notInList, notInSubquery, notLike, now, ntile, nullif, octetLength, or, outerRef, pagedResponseToOpenApiSchema, paginationParamsSchema, parameterToRef, parseDuration, pi, pick, position, pow, power, quarter, radians, rand, random, rank, registerExpressionDispatcher, registerOperandDispatcher, registerSchemaIntrospector, registerValidator, relationFilterToOpenApiSchema, relationLoaderCache, renderColumnDefinition, renderTypeWithArgs, repeat, replace, replaceWithRefs, resolveTreeConfig, resolveValidator, responseToRef, reverse, right, round, rowNumber, rowsToQueryResult, rpad, rtrim, schemaToJson, schemaToRef, second, sel, selectFrom, selectFromEntity, setRelations, setTreeBounds, setTreeMetadata, setTreeParentId, sha1, sha2, shiftLeft, shiftRight, sign, sin, space, sqrt, stddev, sub, substr, sum, synchronizeSchema, tableRef, tan, threadResults, threadedNodeToOpenApiSchema, toColumnRef, toPagedResponse, toPagedResponseBuilder, toPaginationParams, toResponse, toResponseBuilder, toTableRef, treeEntityRegistry, treeListEntryToOpenApiSchema, treeNodeResultToOpenApiSchema, treeNodeToOpenApiSchema, treeQuery, trim, trunc, truncate, typeMappingService, unixTimestamp, update, updateDtoToOpenApiSchema, updateDtoWithRelationsToOpenApiSchema, upper, utcNow, validateTreeTable, valueToOperand, variance, visitExpression, visitOperand, weekOfYear, whereInputToOpenApiSchema, whereInputWithRelationsToOpenApiSchema, windowFunction, withDefaults, withDefaultsBuilder, year };