vsrepo 1.4.2 → 2.1.0

package/dist/VSRepository.d.ts

@@ -1,1201 +1,166 @@
-import { Prisma, PrismaClient } from '../generated/prisma/client';
-import { Decimal, JsonValue } from '@prisma/client/runtime/client';
-
-/**
- * Flattens a type intersection into a single object,
- * avoiding the TypeScript "union type too complex to represent" error.
- */
-type Simplify<T> = { [K in keyof T]: T[K] } & {};
-
-type WidenField<T> = 
-    T extends bigint ? bigint | number :
-    T extends Date ? Date | string :
-    T extends Decimal ? Decimal | string | number :
-    T extends readonly [infer U, infer V] ? [WidenField<U>, WidenField<V>] : 
-    T extends Array<infer U> ? WidenField<U>[] : 
-    T;
-
-/**
- * Full Prisma Client instance used to build repositories.
- */
-export type DbClient = PrismaClient;
-
-/**
- * Prisma transactional client returned by `prisma.$transaction`.
- */
-export type DbTransaction = Prisma.TransactionClient;
-
-/**
- * Accepts either the main Prisma client or a transaction client.
- */
-export type ClientOrTransaction = DbClient | DbTransaction;
-
-export type * from './VSRepoError';
-
-type OrderPattern = {
-    [key: string]: 'asc' | 'desc' | { _count: 'asc' | 'desc' } | OrderPattern;
-};
-
-/**
- * Pagination options accepted by methods with the `Paginated` suffix.
- *
- * @template TCursor Type of the cursor used by the Prisma model.
- */
-export type PaginationOptions<TCursor = unknown> = {
-    /** Number of records to skip. */
-    skip?: number;
-    /** Maximum number of records to return. */
-    take?: number;
-    /** Typed cursor for position-based pagination. */
-    cursor?: TCursor;
-};
-
-/**
- * Ordering accepted by repository methods.
- *
- * Can be a single ordering or a list of chained orderings.
- */
-export type OrderOptions = OrderPattern | OrderPattern[];
-
-/**
- * Visibility mode for records with soft-delete.
- *
- * - `"active"` — returns only non-deleted records (default).
- * - `"removed"` — returns only deleted records.
- * - `"all"` — returns all records regardless of their status.
- */
-export type SeeMode = 'active' | 'removed' | 'all';
-
-type ValidMethodPatterns =
-    | `existsBy${string}` | `findBy${string}` 
-    | `findUniqueBy${string}` | `findUniqueOrThrowBy${string}`
-    | `findFirstBy${string}` | `findFirst${string}` 
-    | `findFirstOrThrowBy${string}` | `findFirstOrThrow${string}`
-    | `findManyBy${string}` | `findMany${string}` 
-    | `createManyAndReturn${string}` | `createMany${string}`
-    | `create${string}` | `updateManyAndReturnBy${string}` | `updateManyBy${string}`
-    | `updateBy${string}` | `upsertBy${string}` | `deleteManyBy${string}`
-    | `deleteBy${string}` | `countBy${string}` | `count${string}` | `countWhere${string}`
-    | `findWhere${string}` | `findListWhere${string}`
-    | `existsWhere${string}` | `updateManyWhere${string}` | `deleteManyWhere${string}`
-    | `findOneWhere${string}` | `findOneBy${string}` | `updateManyAndReturnWhere${string}`
-    | 'aggregate' | 'groupBy';
-
-type StripModifier<S extends string> =
-  S extends `${infer Base}NotStartsWithInsensitive` ? Base :
-  S extends `${infer Base}StartsWithInsensitive` ? Base :
-  S extends `${infer Base}NotEndsWithInsensitive` ? Base :
-  S extends `${infer Base}EndsWithInsensitive` ? Base :
-  S extends `${infer Base}NotContainsInsensitive` ? Base :
-  S extends `${infer Base}ContainsInsensitive` ? Base :
-  S extends `${infer Base}NotInInsensitive` ? Base :
-  S extends `${infer Base}InInsensitive` ? Base :
-  S extends `${infer Base}NotInsensitive` ? Base :
-  S extends `${infer Base}NotStartsWith` ? Base :
-  S extends `${infer Base}StartsWith` ? Base :
-  S extends `${infer Base}NotEndsWith` ? Base :
-  S extends `${infer Base}EndsWith` ? Base :
-  S extends `${infer Base}NotContains` ? Base :
-  S extends `${infer Base}Contains` ? Base :
-  S extends `${infer Base}NotIn` ? Base :
-  S extends `${infer Base}In` ? Base :
-  S extends `${infer Base}NotBetween` ? Base :
-  S extends `${infer Base}Between` ? Base :
-  S extends `${infer Base}Not` ? Base :
-  S extends `${infer Base}LessThanEqual` ? Base :
-  S extends `${infer Base}LessThan` ? Base :
-  S extends `${infer Base}GreaterThanEqual` ? Base :
-  S extends `${infer Base}GreaterThan` ? Base :
-  S extends `${infer Base}Insensitive` ? Base :
-  S;
-
-type ExtractFieldName<S extends string> = Uncapitalize<StripModifier<S>>;
-
-type IsArrayFilter<S extends string> = S extends `${string}${'NotIn' | 'In'}` ? true : false;
-
-type IsBetweenFilter<S extends string> = S extends `${string}${'NotBetween' | 'Between'}` ? true : false;
-
-type ParseRelation<S extends string> =
-    S extends `${infer Rel}Without${infer Rest}` ? [Uncapitalize<Rel>, 'isNot', Rest] :
-    S extends `${infer Rel}With${infer Rest}` ? [Uncapitalize<Rel>, 'is', Rest] :
-    S extends `${infer Rel}Some${infer Rest}` ? [Uncapitalize<Rel>, 'some', Rest] :
-    S extends `${infer Rel}Every${infer Rest}` ? [Uncapitalize<Rel>, 'every', Rest] :
-    S extends `${infer Rel}None${infer Rest}` ? [Uncapitalize<Rel>, 'none', Rest] : null;
-
-type GetFieldType<T, S extends string, I> = WidenField<
-    ExtractFieldName<S> extends infer FieldName
-        ? FieldName extends keyof T
-            ? IsArrayFilter<S> extends true
-                ? T[FieldName][]
-                : IsBetweenFilter<S> extends true
-                  ? [NonNullable<T[FieldName]>, NonNullable<T[FieldName]>]
-                  : NonNullable<T[FieldName]> extends object | any[]
-                    ? I extends { whereInput: infer W }
-                        ? FieldName extends keyof NonNullable<W> ? Exclude<NonNullable<W>[FieldName], undefined> : T[FieldName]
-                        : T[FieldName]
-                    : T[FieldName]
-            : ParseRelation<S> extends [infer Rel extends keyof T, any, infer Rest extends string]
-                ? GetFieldType<NonNullable<T[Rel]> extends any[] ? NonNullable<T[Rel]>[number] : NonNullable<T[Rel]>, Rest, unknown>
-                : unknown
-        : unknown
->;
-
-type NoArgModifiers = 'IsNull' | 'IsNotNull' | 'IsTrue' | 'IsFalse' | 'None' | 'Some' | 'Every' | 'Without';
-
-type IsNoArgModifier<S extends string> = 
-    S extends `${string}${'StartsWith' | 'EndsWith'}` ? false :
-    S extends `${string}${NoArgModifiers | 'With'}` ? true : 
-    false;
-
-type IsOptional<S extends string> = S extends `${string}Optional` ? true : false;
-type StripOptional<S extends string> = S extends `${infer Base}Optional` ? Base : S;
-
-type MapToContractTypes<T, Arr extends string[], I> = 
-    Arr extends [infer First extends string, ...infer Rest extends string[]]
-        ? First extends '' 
-            ? MapToContractTypes<T, Rest, I>
-            : StripOptional<First> extends infer CleanFirst extends string
-                ? IsNoArgModifier<CleanFirst> extends true
-                    ? MapToContractTypes<T, Rest, I>
-                    : IsOptional<First> extends true
-                        ? [GetFieldType<T, CleanFirst, I> | undefined, ...MapToContractTypes<T, Rest, I>]
-                        : [GetFieldType<T, CleanFirst, I>, ...MapToContractTypes<T, Rest, I>]
-                : never
-        : [];
-
-type SplitAllTokens<S extends string> =
-    S extends `${infer L}AND${infer R}` ? [...SplitAllTokens<L>, ...SplitAllTokens<R>] :
-    S extends `${infer L}And${infer R}` ? [...SplitAllTokens<L>, ...SplitAllTokens<R>] :
-    S extends `${infer L}Or${infer R}` ? [...SplitAllTokens<L>, ...SplitAllTokens<R>] :
-    S extends '' ? [] :
-    [S];
-
-type ExtractFields<T, R extends string, I> =
-    R extends '' ? [] 
-    : FilterNonEmpty<MapToContractTypes<T, SplitAllTokens<R>, I>>;
-
-type FilterNonEmpty<T extends unknown[]> = 
-    T extends [infer First, ...infer Rest]
-        ? [First] extends ['']
-            ? FilterNonEmpty<Rest>
-            : [First, ...FilterNonEmpty<Rest>]
-        : [];
-
-type ResolveReturnType<M extends string, TSelected> =
-    M extends 'existsBy' | 'existsWhere' ? boolean :
-    M extends 'createMany' | 'updateManyBy' | 'deleteManyBy' | 'updateManyWhere' | 'deleteManyWhere' ? { count: number } :
-    M extends 'findMany' | 'createManyAndReturn' | 'updateManyAndReturnBy' | 'updateManyAndReturnWhere' | 'findListWhere' | 'findByList' ? TSelected[] :
-    M extends 'findUnique' | 'findFirst' | 'findWhere' | 'findByOne' | 'findOneBy' | 'findOneWhere' ? TSelected | null :
-    M extends 'findUniqueOrThrow' | 'findFirstOrThrow' | 'create' | 'updateBy' | 'upsertBy' | 'deleteBy' ? TSelected :
-    M extends 'count' | 'countWhere' ? number : never;
-
-type GetUpdateInput<I> = I extends { updateInput: infer U } ? U : unknown;
-type GetCreateInput<I> = I extends { createInput: infer C } ? C : unknown;
-type GetCreateManyInput<I> = I extends { createManyInput: infer CM } ? CM : unknown;
-type GetUpdateManyInput<I> = I extends { updateManyInput: infer UM } ? UM : unknown;
-type GetWhereInput<I> = I extends { whereInput: infer W } ? NonNullable<W> : unknown;
-type GetCursorInput<I> = I extends { cursorInput: infer C } ? C : unknown;
-type GetOrderByInput<I> = I extends { orderByInput: infer OB } ? NonNullable<OB> : OrderOptions;
-
-type ExtraArgs<M extends string, R extends string, I> = [
-    ...(M extends 'upsertBy' ? [update: GetUpdateInput<I>, create: GetCreateInput<I>]
-      : M extends 'create' ? [data: GetCreateInput<I>]
-      : M extends 'updateBy' ? [data: GetUpdateInput<I>]
-      : M extends 'createMany' | 'createManyAndReturn' ? [data: GetCreateManyInput<I>]
-      : M extends 'updateManyBy' | 'updateManyAndReturnBy' ? [data: GetUpdateManyInput<I>]
-      : M extends 'findWhere' | 'findListWhere' | 'countWhere' | 'existsWhere' | 'deleteManyWhere' | 'findOneWhere' ? [where: GetWhereInput<I>]
-      : M extends 'updateManyWhere' | 'updateManyAndReturnWhere' ? [where: GetWhereInput<I>, data: GetUpdateManyInput<I>]
-      : []),
-    ...(R extends `${string}PaginatedAndOrdered` ? [pagination: PaginationOptions<GetCursorInput<I>>, order: GetOrderByInput<I>]
-      : R extends `${string}OrderedAndPaginated` ? [order: GetOrderByInput<I>, pagination: PaginationOptions<GetCursorInput<I>>]
-      : R extends `${string}Paginated` ? [pagination: PaginationOptions<GetCursorInput<I>>]
-      : R extends `${string}Ordered` ? [order: GetOrderByInput<I>]
-      : [])
-];
-
-export type PrismaModelName = Prisma.ModelName;
-
-type PrismaDelegate<M extends PrismaModelName> = Uncapitalize<M> extends keyof DbClient ? DbClient[Uncapitalize<M>] : never;
-
-type FullModelType<M extends PrismaModelName> = 
-  Prisma.Result<PrismaDelegate<M>, {}, 'findMany'> extends Array<infer U> ? U : never;
-
-type PrecomputedSelects<M extends PrismaModelName, SelectModels> = {
-    [S in keyof SelectModels]: Prisma.Result<PrismaDelegate<M>, { select: SelectModels[S] }, 'findMany'> extends Array<infer U> ? U : never
-};
-
-type PrecomputedIncludes<M extends PrismaModelName, IncludeModels> = {
-    [I in keyof IncludeModels]: Prisma.Result<PrismaDelegate<M>, { include: IncludeModels[I] }, 'findMany'> extends Array<infer U> ? U : never
-};
-
-type SelectedModel<M extends PrismaModelName, S, SelectModels, IM = never, IncludeModels = {}, RI = never, RS = never> = 
-    [RS] extends [never]
-        ? [RI] extends [never]
-            ? [IM] extends [never]
-                ? [S] extends [false] 
-                    ? FullModelType<M>
-                    : [S] extends [never] 
-                        ? FullModelType<M> 
-                        : [S] extends [keyof SelectModels] 
-                            ? PrecomputedSelects<M, SelectModels>[S]
-                            : FullModelType<M>
-                : IM extends keyof IncludeModels
-                    ? PrecomputedIncludes<M, IncludeModels>[IM]
-                    : FullModelType<M>
-            : Prisma.Result<PrismaDelegate<M>, { include: RI }, 'findMany'> extends Array<infer U> ? U : never
-        : Prisma.Result<PrismaDelegate<M>, { select: RS }, 'findMany'> extends Array<infer U> ? U : never;
-
-/**
- * Strips the `Distinct{Fields}` suffix used by read methods (e.g. `findManyDistinctIdadeAndCargo`).
- * The distinct fields are resolved from the method name at build time, so they never
- * become part of the runtime `where` fields extracted by `ExtractFields`.
- */
-type StripDistinctFields<R extends string> =
-    R extends `${infer F}Distinct${string}` ? F : R;
-
-type CleanFields<R extends string> =
-    R extends `${infer F}PaginatedAndOrdered` ? StripDistinctFields<F> :
-    R extends `${infer F}OrderedAndPaginated` ? StripDistinctFields<F> :
-    R extends `${infer F}Paginated` ? StripDistinctFields<F> :
-    R extends `${infer F}Ordered` ? StripDistinctFields<F> :
-    R extends `${infer F}SkipDuplicates` ? StripDistinctFields<F> :
-    StripDistinctFields<R>;
-
-/**
- * Additional options accepted by repository methods.
- *
- * @template S Available keys in `selectModels`.
- * @template IM Available keys in `includeModels`.
- */
-export type MethodOptions<S, IM extends PropertyKey = never, M extends PrismaModelName = never, RI = never, RS = never> = {
-    /** Prisma client or transaction to use for the operation. */
-    db?: ClientOrTransaction;
-    /**
-     * Visibility mode for records with soft-delete.
-     *
-     * Only takes effect if `softRemovekName` is configured on the repository.
-     *
-     * - `"active"` — returns only non-deleted records (default).
-     * - `"removed"` — returns only deleted records.
-     * - `"all"` — returns all records, ignoring deletion status.
-     */
-    see?: SeeMode;
-} & (
-    [IM] extends [never]
-        ? | { 
-              /** Select model to apply to the operation. Use `false` to return the full payload. */
-              selectModel?: S | false; 
-              /** Include model to apply to the operation. Cannot be used together with `selectModel`. */
-              includeModel?: never;
-              /** Raw Prisma `include`. Cannot be used together with `selectModel` or `includeModel`. */
-              include?: never;
-              /** Raw Prisma `select`. Cannot be used together with `selectModel`, `includeModel` or `include`. */
-              select?: never;
-            }
-          | {
-              selectModel?: never;
-              includeModel?: never;
-              include: RI;
-              select?: never;
-            }
-          | {
-              selectModel?: never;
-              includeModel?: never;
-              include?: never;
-              select: RS;
-            }
-        : | { selectModel?: S | false; includeModel?: never; include?: never; select?: never }
-          | { selectModel?: never; includeModel: IM; include?: never; select?: never }
-          | { selectModel?: never; includeModel?: never; include: RI; select?: never }
-          | { selectModel?: never; includeModel?: never; include?: never; select: RS }
-);
-
-/**
- * Version of `MethodOptions` derived directly from a configured `VSRepository` instance.
- *
- * @template TRepo Configured `VSRepository` instance (use `typeof myVSRepo`).
- *
- * @example
- * const userVSRepo = setupVSRepo<User, "user">()(config);
- * type Opts = MethodOptionsModel<typeof userVSRepo>;
- */
-export type MethodOptionsModel<TRepo> =
-    TRepo extends VSRepository<any, infer M, infer Config>
-        ? MethodOptions<keyof ExtractSelectModels<Config> | false, keyof ExtractIncludeModels<Config>, M>
-        : never;
-
-type MethodOptionsWithInclude<
-    S,
-    IM extends PropertyKey,
-    TIncludes,
-    M extends PrismaModelName,
-    RI = never,
-    RS = never,
-    Excluded extends keyof MethodOptions<S, keyof TIncludes, M, RI, RS> = never
-> = DistributiveOmit<MethodOptions<S, keyof TIncludes, M, RI, RS>, Excluded>
-    & ({ includeModel: IM } | { includeModel?: never });
-
-type MethodFn<MethodName extends string, T, M extends PrismaModelName, R extends string, SelectModels, DefaultSelect extends keyof SelectModels | false, I, IncludeModels> = 
-    <S extends keyof SelectModels | false = DefaultSelect, IM extends keyof IncludeModels = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        ...args: [...ExtractFields<T, CleanFields<R>, I>, ...ExtraArgs<MethodName, R, I>, options?: MethodOptionsWithInclude<S, IM, IncludeModels, M, RI, RS>]
-    ) => Promise<ResolveReturnType<MethodName, SelectedModel<M, S, SelectModels, IM, IncludeModels, RI, RS>>>;
-
-type GetMappedMethod<K extends string, MethodConf> = 
-    K extends `findBy${string}` ? (MethodConf extends { fbMode: 'one' } ? 'findByOne' : 'findByList') :
-    K extends `findOneBy${string}` ? 'findOneBy' :
-    K extends `existsBy${string}` ? 'existsBy' :
-    K extends `existsWhere${string}` ? 'existsWhere' :
-    K extends `findUniqueOrThrowBy${string}` ? 'findUniqueOrThrow' :
-    K extends `findUniqueBy${string}` ? 'findUnique' :
-    K extends `findFirstOrThrowBy${string}` | `findFirstOrThrow${string}` ? 'findFirstOrThrow' :
-    K extends `findFirstBy${string}` | `findFirst${string}` ? 'findFirst' :
-    K extends `findManyBy${string}` | `findMany${string}` ? 'findMany' :
-    K extends `createManyAndReturn${string}` ? 'createManyAndReturn' :
-    K extends `createMany${string}` ? 'createMany' :
-    K extends `create${string}` ? 'create' :
-    K extends `updateManyAndReturnBy${string}` ? 'updateManyAndReturnBy' :
-    K extends `updateManyAndReturnWhere${string}` ? 'updateManyAndReturnWhere' :
-    K extends `updateManyBy${string}` ? 'updateManyBy' :
-    K extends `updateManyWhere${string}` ? 'updateManyWhere' :
-    K extends `updateBy${string}` ? 'updateBy' :
-    K extends `upsertBy${string}` ? 'upsertBy' :
-    K extends `deleteManyBy${string}` ? 'deleteManyBy' :
-    K extends `deleteManyWhere${string}` ? 'deleteManyWhere' :
-    K extends `deleteBy${string}` ? 'deleteBy' :
-    K extends `countWhere${string}` ? 'countWhere' :
-    K extends `countBy${string}` | `count${string}` ? 'count' :
-    K extends `findListWhere${string}` ? 'findListWhere' :
-    K extends `findOneWhere${string}` ? 'findOneWhere' :
-    K extends `findWhere${string}` ? 'findWhere' :
-    K extends 'aggregate' ? 'aggregate' :
-    K extends 'groupBy' ? 'groupBy' :
-    never;
-
-type ExtractPatternBase<K extends string> = 
-    K extends `${string}By${infer R}` ? R :
-    K extends `findFirstOrThrow${infer R}` ? R :
-    K extends `findFirst${infer R}` ? R :
-    K extends `findMany${infer R}` ? R :
-    K extends `createManyAndReturn${infer R}` ? R :
-    K extends `createMany${infer R}` ? R :
-    K extends `create${infer R}` ? R :
-    K extends `countWhere${infer R}` ? R :
-    K extends `count${infer R}` ? R :
-    K extends `findListWhere${infer R}` ? R :
-    K extends `findOneWhere${infer R}` ? R :
-    K extends `findWhere${infer R}` ? R :
-    K extends `existsWhere${infer R}` ? R :
-    K extends `updateManyWhere${infer R}` ? R :
-    K extends `updateManyAndReturnWhere${infer R}` ? R :
-    K extends `deleteManyWhere${infer R}` ? R : '';
-
-type MethodFactory<T, M extends PrismaModelName, K extends string, SelectModels, DefaultSelect extends keyof SelectModels | false, I, MethodConf, IncludeModels> = 
-    K extends `findWhere${string}`
-        ? {
-            /** @deprecated Use findOneWhere instead. */
-            <S extends keyof SelectModels | false = DefaultSelect, IM extends keyof IncludeModels = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-                ...args: [...ExtractFields<T, CleanFields<ExtractPatternBase<K>>, I>, ...ExtraArgs<GetMappedMethod<K, MethodConf>, ExtractPatternBase<K>, I>, options?: MethodOptionsWithInclude<S, IM, IncludeModels, M, RI, RS>]
-            ): Promise<ResolveReturnType<GetMappedMethod<K, MethodConf>, SelectedModel<M, S, SelectModels, IM, IncludeModels, RI, RS>>>;
-          }
-        : MethodFn<GetMappedMethod<K, MethodConf>, T, M, ExtractPatternBase<K>, SelectModels, DefaultSelect, I, IncludeModels>;
-
-type ResolveSelectModel<MethodConf, GlobalConf, SelectModels> = 
-    MethodConf extends { selectModel: infer S } ? (S extends false ? false : S extends keyof SelectModels ? S : never) : 
-    GlobalConf extends { defaultSelectModel: infer D } ? (D extends keyof SelectModels ? D : never) : never;
-
-type ExtractPkName<T, Config> = Config extends { pkName: infer PK } ? (PK extends keyof T ? PK : never) : never;
-type ExtractSelectModels<Config> = Config extends { selectModels: infer SM } ? SM : {};
-type ExtractIncludeModels<Config> = Config extends { includeModels: infer IM } ? IM : {};
-type ExtractDefaultSelect<Config> = Config extends { defaultSelectModel: infer D } ? D : never;
-type ExtractRelations<Config> = Config extends { relations: infer R } ? (R extends object ? R : {}) : {};
-type ExtractSoftRemovekName<Config> = Config extends { softRemovekName: infer S } ? S : never;
-type ExtractDefaultOrdering<Config> = Config extends { defaultOrdering: infer O } ? O : Config extends { defaultOrdenation: infer O } ? O : never;
-
-type AggregateMethod<M extends PrismaModelName> = <A extends Prisma.TypeMap['model'][M]['operations']['aggregate']['args']>(
-    prismaArgs: A, 
-    options?: { db?: ClientOrTransaction }
-) => Promise<Prisma.Result<PrismaDelegate<M>, A, 'aggregate'>>;
-
-type GroupByMethod<M extends PrismaModelName> = <A extends Prisma.TypeMap['model'][M]['operations']['groupBy']['args']>(
-    prismaArgs: A, 
-    options?: { db?: ClientOrTransaction }
-) => Promise<Prisma.Result<PrismaDelegate<M>, A, 'groupBy'>>;
-
-/**
- * Function type generated for a dynamic method configured with `query` (non-modifying).
- *
- * The result of a raw SQL `SELECT` isn't statically known, so the method itself
- * resolves to `any` by default, but exposes a generic parameter so the caller can
- * infer/assert the shape of the result: `repo.myRawQuery<User[]>({ args: [...] })`.
- *
- * @template TReturn Return type asserted at the call site. Defaults to `any`.
- */
-type QueryMethodFn = <TReturn = any>(
-    arg: { args: any[]; db?: ClientOrTransaction },
-) => Promise<TReturn>;
-
-/**
- * Function type generated for a dynamic method configured with `query` and
- * `modifying: true`.
- *
- * Modifying raw queries run through `$executeRawUnsafe` and always resolve to the
- * number of affected rows, so — unlike `QueryMethodFn` — no generic return type is
- * exposed here.
- */
-type QueryMethodModifyingFn = (
-    arg: { args: any[]; db?: ClientOrTransaction },
-) => Promise<number>;
-
-type DynamicMethods<T, M extends PrismaModelName, Config, I> = Config extends { methods: infer Methods }
-    ? {
-          [K in keyof Methods as Methods[K] extends { map: true } ? K : never]: K extends string
-              ? Methods[K] extends { query: { modifying: true } }
-                  ? QueryMethodModifyingFn
-                  : Methods[K] extends { query: infer Q }
-                  ? QueryMethodFn
-                  : (Methods[K] extends { proxyTo: infer P extends string } ? P : K) extends infer ResolvedKey
-                      ? ResolvedKey extends 'aggregate'
-                          ? AggregateMethod<M>
-                          : ResolvedKey extends 'groupBy'
-                          ? GroupByMethod<M>
-                          : ResolvedKey extends string
-                          ? MethodFactory<T, M, ResolvedKey, ExtractSelectModels<Config>, ResolveSelectModel<Methods[K], Config, ExtractSelectModels<Config>>, I, Methods[K], ExtractIncludeModels<Config>>
-                          : never
-                      : never
-              : never;
-      }
-    : {};
-
-/**
- * Groups the main Prisma input types derived from a model.
- *
- * @template M Prisma model name.
- */
-export type PrismaModelInputs<M extends PrismaModelName> = {
-    /** Type of the `select` argument used in model queries. */
-    select: Prisma.TypeMap['model'][M]['operations']['findMany']['args']['select'];
-    /** Type of the `include` argument used in model queries. */
-    include: Prisma.TypeMap['model'][M]['operations']['findMany']['args']['include'];
-    /** Type of the `data` used in `create`. */
-    createInput: Prisma.TypeMap['model'][M]['operations']['create']['args']['data'];
-    /** Type of the `data` used in `createMany`. */
-    createManyInput: Prisma.TypeMap['model'][M]['operations']['createMany']['args']['data'];
-    /** Type of the `data` used in `update`. */
-    updateInput: Prisma.TypeMap['model'][M]['operations']['update']['args']['data'];
-    /** Type of the `data` used in `updateMany`. */
-    updateManyInput: Prisma.TypeMap['model'][M]['operations']['updateMany']['args']['data'];
-    /** Type of the `where` used in model queries. */
-    whereInput: Prisma.TypeMap['model'][M]['operations']['findMany']['args']['where'];
-    /** Type of the `orderBy` used in model queries. */
-    orderByInput: Prisma.TypeMap['model'][M]['operations']['findMany']['args']['orderBy'];
-    /** Type of the cursor used in model queries. */
-    cursorInput: Prisma.TypeMap['model'][M]['operations']['findMany']['args']['cursor'];
-    /** Type of the `create` payload used in `upsert`. */
-    upsertCreateInput: Prisma.TypeMap['model'][M]['operations']['upsert']['args']['create'];
-    /** Type of the `update` payload used in `upsert`. */
-    upsertUpdateInput: Prisma.TypeMap['model'][M]['operations']['upsert']['args']['update'];
-};
-
-/**
- * Type of the `select` object of a Prisma model.
- */
-export type SelectModel<M extends PrismaModelName> = PrismaModelInputs<M>['select'];
-
-/**
- * Map of named, reusable selects for a Prisma model.
- */
-export type SelectModels<M extends PrismaModelName> = Record<string, SelectModel<M>>;
-
-/**
- * Type of the `include` object of a Prisma model.
- */
-export type IncludeModel<M extends PrismaModelName> = PrismaModelInputs<M>['include'];
-
-/**
- * Map of named, reusable includes for a Prisma model.
- */
-export type IncludeModels<M extends PrismaModelName> = Record<string, IncludeModel<M>>;
-
-/**
- * Type of the `where` object of a Prisma model.
- */
-export type WhereModel<M extends PrismaModelName> = PrismaModelInputs<M>['whereInput'];
-
-/**
- * Type of the `cursor` object of a Prisma model.
- */
-export type CursorModel<M extends PrismaModelName> = PrismaModelInputs<M>['cursorInput'];
-
-/**
- * Type of the `orderBy` object of a Prisma model.
- */
-export type OrderingModel<M extends PrismaModelName> = PrismaModelInputs<M>['orderByInput'];
-
-/**
- * Type of the `orderBy` object of a Prisma model.
- * @deprecated Use `OrderingModel` instead.
- */
-export type OrdenationModel<M extends PrismaModelName> = OrderingModel<M>;
-
-/**
- * Pagination options with typed cursor for a Prisma model.
- */
-export type PaginationModel<M extends PrismaModelName> = PaginationOptions<PrismaModelInputs<M>['cursorInput']>;
-
-/**
- * Base payload used to create a record in the model's `save`/`upsert`.
- */
-export type ModelUpsertInput<M extends PrismaModelName> = PrismaModelInputs<M>['upsertCreateInput'];
-
-/**
- * Configuration for a dynamic method defined in `methods`.
- *
- * @template M Prisma model name.
- * @template SelectModels Map of select models available in the repository.
- */
-export type MethodConfig<M extends PrismaModelName, SelectModels = any> = {
-    /** Defines whether the method will be exposed on the repository. */
-    readonly map: boolean;
-    /** Overrides `defaultSelectModel` for this method only. */
-    readonly selectModel?: string | false;
-    /** Controls whether the method combines (`extending`) or overwrites (`overwrite`) the `requiredWhere`. */
-    readonly whereType?: 'overwrite' | 'extending';
-    /** Redirects the logic to another valid method pattern. */
-    readonly proxyTo?: ValidMethodPatterns;
-    /** Adds an extra `where` on top of `requiredWhere`. */
-    readonly pushWhere?: WhereModel<M>;
-    /** * Defines whether `findBy` returns a single item (`one`) or a list (`list`).
-     * @deprecated Use `findOneBy` if you want to return a single result.
-     */
-    readonly fbMode?: 'one' | 'list';
-    /** Injects a fixed ordering automatically into the query. */
-    readonly injectOrdering?: OrderingModel<M>;
-    /**
-     * Injects a fixed ordering automatically into the query.
-     * @deprecated Use `injectOrdering` instead.
-     */
-    readonly injectOrdenation?: OrderingModel<M>;
-    /** Injects a fixed pagination automatically into the query. */
-    readonly injectPagination?: PaginationModel<M>;
-    /**
-     * Turns this method into a **raw SQL query method**, bypassing name-based parsing
-     * entirely. The method executes the given SQL directly through Prisma, with
-     * parameters injected positionally via the `args` array passed at the call site
-     * (`$1`, `$2`, ... placeholders), so no other option in `MethodConfig` applies
-     * (`selectModels`, `requiredWhere`, `pushWhere`, etc. are all ignored).
-     *
-     * - `modifying: false` (default) runs through `$queryRawUnsafe` and the method
-     *   resolves to `TReturn` (`any` by default), inferable/assertable via a generic
-     *   at the call site.
-     * - `modifying: true` runs through `$executeRawUnsafe` and the method **always**
-     *   resolves to `number` (the count of affected rows).
-     *
-     * @example
-     * ```typescript
-     * methods: {
-     *   findActiveUsersRaw: {
-     *     map: true,
-     *     query: { value: 'SELECT * FROM "user" WHERE active = $1' },
-     *   },
-     *   deactivateUsersOlderThanRaw: {
-     *     map: true,
-     *     query: { value: 'UPDATE "user" SET active = false WHERE "createdAt" < $1', modifying: true },
-     *   },
-     * }
-     *
-     * // Uso:
-     * const users = await repo.findActiveUsersRaw<User[]>({ args: [true] });
-     * const affected = await repo.deactivateUsersOlderThanRaw({ args: [cutoffDate] });
-     * ```
-     */
-    readonly query?: {
-        /**
-         * Raw SQL statement to execute. Use positional placeholders (`$1`, `$2`, ...)
-         * for the values passed in `args`, never string-interpolate the values
-         * directly, or you'll re-introduce the SQL injection risk this API exists to avoid.
-         */
-        readonly value: string;
-        /**
-         * When `true`, executes via `$executeRawUnsafe` and the method always resolves
-         * to `number` (rows affected). When `false`/omitted, executes via
-         * `$queryRawUnsafe` and the method resolves to `TReturn` (`any` by default).
-         *
-         * @default false
-         */
-        readonly modifying?: boolean;
-    };
-};
-
-type BaseMethodConfig<TSelectKeys extends PropertyKey = string> = {
-    /** Enables or disables the base method in the `build`. */
-    active?: boolean;
-    /** Default select model used by the base method. */
-    defaultSelect?: TSelectKeys;
-    /** Ignores the `requiredWhere`. */
-    ignoreRequiredWhere?: boolean;
-};
-
-/**
- * Configuration applied during `.build(prisma, config?)`.
- *
- * @template TSelectKeys Valid keys of `selectModels`.
- */
-export type BuildConfig<TSelectKeys extends PropertyKey = string> = {
-    /**
-     * Freezes the final repository object with `Object.freeze`.
-     * @deprecated No longer has any practical effect in the next version — freeze will be always applied.
-     */
-    freeze?: boolean;
-    /** Prints internal working logs to the console. */
-    showWorking?: boolean;
-    /** Customizes the behavior of the automatic base methods. */
-    baseMethods?: {
-        /** Configuration for the `get` method. */
-        get?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `getOrThrow` method. */
-        getOrThrow?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `getList` method (fetch by list of PKs). */
-        getList?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `remove` method. */
-        remove?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `save` method. */
-        save?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `saveList` method (batch save via transaction). */
-        saveList?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `patch` method. */
-        patch?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `patchList` method (batch update via transaction). */
-        patchList?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `merge` method. */
-        merge?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `removeList` method (batch deletion). Does not accept select. */
-        removeList?: Omit<BaseMethodConfig<TSelectKeys>, 'defaultSelect'>;
-        /** Configuration for the `getAll` method (full listing). */
-        getAll?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `total` method (count). Does not accept select. */
-        total?: Omit<BaseMethodConfig<TSelectKeys>, 'defaultSelect'>;
-        /** Configuration for the `has` method (existence check). Does not accept select. */
-        has?: Omit<BaseMethodConfig<TSelectKeys>, 'defaultSelect'>;
-        /** Configuration for the `softRemove` method. Only available if `softRemovekName` is configured. */
-        softRemove?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `softRemoveList` method. Does not accept select. Only available if `softRemovekName` is configured. */
-        softRemoveList?: Omit<BaseMethodConfig<TSelectKeys>, 'defaultSelect'>;
-        /** Configuration for the `restore` method. Only available if `softRemovekName` is configured. */
-        restore?: BaseMethodConfig<TSelectKeys>;
-        /** Configuration for the `restoreList` method. Does not accept select. Only available if `softRemovekName` is configured. */
-        restoreList?: Omit<BaseMethodConfig<TSelectKeys>, 'defaultSelect'>;
-    };
-};
-
-type ResolveMethodDefaultSelect<Config, C, Method extends keyof NonNullable<BuildConfig['baseMethods']>, TSelects = ExtractSelectModels<Config>> =
-    C extends { baseMethods?: { [_ in Method]?: { defaultSelect?: infer D } } }
-        ? D extends keyof TSelects 
-            ? D 
-            : ExtractDefaultSelect<Config> extends keyof TSelects 
-                ? ExtractDefaultSelect<Config> 
-                : false
-        : ExtractDefaultSelect<Config> extends keyof TSelects 
-            ? ExtractDefaultSelect<Config> 
-            : false;
-
-type ResolveCurrentReturn<M extends PrismaModelName, Models, S, D, IM = never, Includes = {}, RI = never, RS = never> = 
-    [RS] extends [never]
-        ? [RI] extends [never]
-            ? [IM] extends [never]
-                ? [S] extends [false] 
-                    ? FullModelType<M> 
-                    : [S] extends [never] 
-                        ? ([D] extends [never] ? FullModelType<M> : SelectedModel<M, D, Models>)
-                        : SelectedModel<M, S, Models>
-                : IM extends keyof Includes
-                    ? PrecomputedIncludes<M, Includes>[IM]
-                    : FullModelType<M>
-            : Prisma.Result<PrismaDelegate<M>, { include: RI }, 'findMany'> extends Array<infer U> ? U : never
-        : Prisma.Result<PrismaDelegate<M>, { select: RS }, 'findMany'> extends Array<infer U> ? U : never;
-
-// ─── helpers reused within the mapped type ───────────────────────────────────
-// ─── relation payload types ──────────────────────────────────────────────────
-
-/**
- * Distributive version of `Omit`, preserving unions when removing properties.
- */
-export type DistributiveOmit<T, K extends keyof any> = T extends any ? Omit<T, K> : never;
-type ExtractUnionProp<T, K extends PropertyKey> = T extends any ? (K extends keyof T ? T[K] : never) : never;
-
-export type ExtractNestedCreateInput<M extends PrismaModelName, K extends PropertyKey> =
-    NonNullable<ExtractUnionProp<PrismaModelInputs<M>['createInput'], K>> extends { create?: infer C }
-        ? Exclude<C, any[]>
-        : never;
-
-export type RelationPayload<TField, TRelationConfig, M extends PrismaModelName, K extends PropertyKey> = NonNullable<TField> extends any[]
-    ? ExtractNestedCreateInput<M, K>[]
-    : NonNullable<TField> extends object
-      ? ExtractNestedCreateInput<M, K> | (TRelationConfig extends { mode: 'oto'; restriction: 'set' } | { mode: 'mto'; nullable: true } | { mode: 'mto'; nullAble: true } ? null : never)
-      : never;
-
-export type TransformCreatePayload<U, T, M extends PrismaModelName, TRelations> =
-    Omit<U, keyof TRelations> &
-    {
-        // Fields that are REQUIRED in this specific branch of the Prisma union
-        [K in Extract<keyof TRelations, keyof U> as {} extends Pick<U, K> ? never : K]: 
-            K extends keyof T ? RelationPayload<T[K], TRelations[K], M, K> : never;
-    } &
-    {
-        // Fields that are OPTIONAL in this branch or do not originally belong to it
-        [K in keyof TRelations as K extends keyof U ? ({} extends Pick<U, K> ? K : never) : K]?: 
-            K extends keyof T ? RelationPayload<T[K], TRelations[K], M, K> : never;
-    };
-
-/**
- * Payload accepted by `save` when the repository has configured relations.
- */
-export type UpsertWithRelations<T, M extends PrismaModelName, TRelations> =
-    ModelUpsertInput<M> extends infer U
-        ? U extends any
-            ? Simplify<TransformCreatePayload<U, T, M, TRelations>>
-            : never
-        : never;
-
-export type CleanNestedInput<T> = T extends any
-    ? T extends { data: infer D }
-        ? CleanNestedInput<Exclude<D, any[]>>
-        : Omit<T, 'where' | 'data'>
-    : never;
-
-export type ExtractNestedUpdateInput<M extends PrismaModelName, K extends PropertyKey> =
-    NonNullable<ExtractUnionProp<PrismaModelInputs<M>['updateInput'], K>> extends { update?: infer U }
-        ? CleanNestedInput<Exclude<U, any[]>>
-        : never;
-
-export type RelationUpdatePayload<TField, TRelationConfig, M extends PrismaModelName, K extends PropertyKey> = NonNullable<TField> extends any[]
-    ? ExtractNestedUpdateInput<M, K>[]
-    : NonNullable<TField> extends object
-      ? ExtractNestedUpdateInput<M, K> | (TRelationConfig extends { mode: 'oto'; restriction: 'set' } | { mode: 'mto'; nullable: true } | { mode: 'mto'; nullAble: true } ? null : never)
-      : never;
-
-/**
- * Payload accepted by `merge` when the repository has configured relations (uses update input).
- */
-export type UpdateWithRelations<T, M extends PrismaModelName, TRelations> =
-    DistributiveOmit<PrismaModelInputs<M>['updateInput'], keyof TRelations> & {
-        [K in Extract<keyof TRelations, keyof T>]?: RelationUpdatePayload<T[K], TRelations[K], M, K>;
-    };
-
-/**
- * Payload accepted by `patch` and `patchList` when the repository has configured relations (uses create input).
- */
-export type PatchWithRelations<T, M extends PrismaModelName, TRelations> =
-    DistributiveOmit<PrismaModelInputs<M>['updateInput'], keyof TRelations> & {
-        [K in Extract<keyof TRelations, keyof T>]?: RelationPayload<T[K], TRelations[K], M, K>;
-    };
-
-/**
- * Extracts the payload type of the `save` method from a configured VSRepository instance.
- */
-export type SaveObject<TInput, TRepo> = 
-    TRepo extends VSRepository<infer T, infer M, infer Config>
-        ? (Config extends { relations: infer R } ? (R extends object ? R : {}) : {}) extends infer TRelations
-            ? TInput extends infer U 
-                ? U extends any 
-                    ? Simplify<TransformCreatePayload<U, T, M, TRelations>>
-                    : never
-                : never
-            : never
-        : never;
-
-/**
- * Extracts the payload type of the `patch` method from a configured VSRepository instance.
- */
-export type PatchObject<TInput, TRepo> = 
-    TRepo extends VSRepository<infer T, infer M, infer Config>
-        ? (Config extends { relations: infer R } ? (R extends object ? R : {}) : {}) extends infer TRelations
-            ? DistributiveOmit<TInput, keyof TRelations> & {
-                  [K in Extract<keyof TRelations, keyof T>]?: RelationPayload<T[K], TRelations[K], M, K>;
-              }
-            : never
-        : never;
-
-
-type _Pk<T, Config> = WidenField<T[ExtractPkName<T, Config> extends keyof T ? ExtractPkName<T, Config> : never]>;
-type _Ret<M extends PrismaModelName, TSelects, S, TDefault, IM = never, TIncludes = {}, RI = never, RS = never> = ResolveCurrentReturn<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>;
-type _DS<Config, C, Method extends keyof NonNullable<BuildConfig['baseMethods']>, TSelects = ExtractSelectModels<Config>> =
-    ResolveMethodDefaultSelect<Config, C, Method, TSelects>;
-type _Sel<Config> = ExtractSelectModels<Config>;
-type _Inc<Config> = ExtractIncludeModels<Config>;
-type _Def<Config> = ExtractDefaultSelect<Config>;
-type _Rel<Config> = ExtractRelations<Config>;
-type _Soft<Config> = ExtractSoftRemovekName<Config>;
-type _DOrd<Config> = ExtractDefaultOrdering<Config>;
-
-// ─── refactored mapped type — optimized for the TS compiler ──────────────────
-
-type AllBaseMethods<
-    T,
-    M extends PrismaModelName,
-    Config,
-    C extends BuildConfig<any> | undefined,
-    TSelects  = _Sel<Config>,
-    TDefault  = _Def<Config>,
-    TPk       = ExtractPkName<T, Config>,
-    TRelations = _Rel<Config>,
-    TSoftKey  = _Soft<Config>,
-    I         = PrismaModelInputs<M>,
-    TDefaultOrdering = _DOrd<Config>,
-    TIncludes = _Inc<Config>
-> = {
-    /** Fetches a record by its primary key (PK). */
-    get: <S extends keyof TSelects | false = _DS<Config, C, 'get', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        pk: _Pk<T, Config>, options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS>
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS> | null>;
-
-    /** Fetches a record by PK and throws `VSRepoRuntimeError` if not found. */
-    getOrThrow: <S extends keyof TSelects | false = _DS<Config, C, 'getOrThrow', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        pk: _Pk<T, Config>, options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS>
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>>;
-
-    /** Fetches multiple records by a list of primary keys (PKs). */
-    getList: <S extends keyof TSelects | false = _DS<Config, C, 'getList', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        pks: _Pk<T, Config>[], options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS>
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>[]>;
-
-    /** Deletes a record identified by its primary key (PK). */
-    remove: <S extends keyof TSelects | false = _DS<Config, C, 'remove', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        pk: _Pk<T, Config>, options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS>
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>>;
-
-    /** Inserts or updates (upsert) a record. */
-    save: <S extends keyof TSelects | false = _DS<Config, C, 'save', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        obj: UpsertWithRelations<T, M, TRelations>, options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS>
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>>;
-
-    /** Saves an array of objects in a single automatic transaction. */
-    saveList: <S extends keyof TSelects | false = _DS<Config, C, 'saveList', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        objs: UpsertWithRelations<T, M, TRelations>[], options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS, 'db'> & { db?: DbTransaction }
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>[]>;
-
-    /** Partially updates (patch) an existing record by its primary key (PK). */
-    patch: <S extends keyof TSelects | false = _DS<Config, C, 'patch', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        pk: _Pk<T, Config>, obj: PatchWithRelations<T, M, TRelations>, options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS>
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>>;
-
-    /** Partially updates multiple records via `[pk, obj]` tuples in an automatic transaction. */
-    patchList: <S extends keyof TSelects | false = _DS<Config, C, 'patchList', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        tuples: [pk: _Pk<T, Config>, obj: PatchWithRelations<T, M, TRelations>][], options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS, 'db'> & { db?: DbTransaction }
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>[]>;
-
-    /** Fetches a record by PK and deep-merges it with the provided object **in memory**. */
-    merge: <S extends keyof TSelects | false = _DS<Config, C, 'merge', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        pk: _Pk<T, Config>, obj: UpdateWithRelations<T, M, TRelations>, options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS>
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS> | null>;
-
-    /** Deletes multiple records by their primary keys. */
-    removeList: (pks: _Pk<T, Config>[], options?: { db?: ClientOrTransaction }) => Promise<{ count: number }>;
-
-    /** Fetches all records (respects `requiredWhere` when set). */
-    getAll: <S extends keyof TSelects | false = _DS<Config, C, 'getAll', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS> & {
-            pagination?: PaginationOptions<I extends { cursorInput: infer Curs } ? Curs : unknown>;
-            /**
-             * Ordering to apply to the query.
-             * When omitted and `defaultOrdering` is configured on the repository,
-             * the default ordering is applied automatically.
-             */
-            order?: I extends { orderByInput: infer OB } ? OB : OrderOptions;
-        }
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>[]>;
-
-    /** Returns the total number of records. */
-    total: (options?: { db?: ClientOrTransaction; see?: SeeMode }) => Promise<number>;
-
-    /** Checks whether a record exists by its primary key (PK). */
-    has: (pk: _Pk<T, Config>, options?: { db?: ClientOrTransaction; see?: SeeMode }) => Promise<boolean>;
-
-    /** Marks a record as deleted (soft-delete). */
-    softRemove: <S extends keyof TSelects | false = _DS<Config, C, 'softRemove', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        pk: _Pk<T, Config>, options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS, 'see'>
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>>;
-
-    /** Marks multiple records as deleted (soft-delete) in batch. */
-    softRemoveList: (pks: _Pk<T, Config>[], options?: { db?: ClientOrTransaction }) => Promise<{ count: number }>;
-
-    /** Restores a record previously marked as deleted (soft-delete). */
-    restore: <S extends keyof TSelects | false = _DS<Config, C, 'restore', TSelects>, IM extends keyof TIncludes = never, RI extends IncludeModel<M> = never, RS extends SelectModel<M> = never>(
-        pk: _Pk<T, Config>, options?: MethodOptionsWithInclude<S, IM, TIncludes, M, RI, RS, 'see'>
-    ) => Promise<_Ret<M, TSelects, S, TDefault, IM, TIncludes, RI, RS>>;
-
-    /** Restores multiple records previously marked as deleted (soft-delete) in batch. */
-    restoreList: (pks: _Pk<T, Config>[], options?: { db?: ClientOrTransaction }) => Promise<{ count: number }>;
-};
-
-type InjectedBaseMethods<
-    T,
-    M extends PrismaModelName,
-    Config,
-    C extends BuildConfig<any> | undefined,
-    TSelects  = _Sel<Config>,
-    TDefault  = _Def<Config>,
-    TPk       = ExtractPkName<T, Config>,
-    TRelations = _Rel<Config>,
-    TSoftKey  = _Soft<Config>,
-    I         = PrismaModelInputs<M>,
-    TDefaultOrdering = _DOrd<Config>,
-    TIncludes = _Inc<Config>
-> = Pick<
-    AllBaseMethods<T, M, Config, C, TSelects, TDefault, TPk, TRelations, TSoftKey, I, TDefaultOrdering, TIncludes>,
-    | (C extends { baseMethods: { get:          { active: false } } } ? never : 'get')
-    | (C extends { baseMethods: { getOrThrow:   { active: false } } } ? never : 'getOrThrow')
-    | (C extends { baseMethods: { getList:      { active: false } } } ? never : 'getList')
-    | (C extends { baseMethods: { remove:       { active: false } } } ? never : 'remove')
-    | (C extends { baseMethods: { save:         { active: false } } } ? never : 'save')
-    | (C extends { baseMethods: { saveList:     { active: false } } } ? never : 'saveList')
-    | (C extends { baseMethods: { patch:        { active: false } } } ? never : 'patch')
-    | (C extends { baseMethods: { patchList:    { active: false } } } ? never : 'patchList')
-    | (C extends { baseMethods: { merge:        { active: false } } } ? never : 'merge')
-    | (C extends { baseMethods: { removeList:   { active: false } } } ? never : 'removeList')
-    | (C extends { baseMethods: { getAll:       { active: false } } } ? never : 'getAll')
-    | (C extends { baseMethods: { total:        { active: false } } } ? never : 'total')
-    | (C extends { baseMethods: { has:          { active: false } } } ? never : 'has')
-    | ([TSoftKey] extends [never] ? never : C extends { baseMethods: { softRemove:     { active: false } } } ? never : 'softRemove')
-    | ([TSoftKey] extends [never] ? never : C extends { baseMethods: { softRemoveList: { active: false } } } ? never : 'softRemoveList')
-    | ([TSoftKey] extends [never] ? never : C extends { baseMethods: { restore:        { active: false } } } ? never : 'restore')
-    | ([TSoftKey] extends [never] ? never : C extends { baseMethods: { restoreList:    { active: false } } } ? never : 'restoreList')
->;
-
-
-/**
- * Relation configuration for One-to-Many or Many-to-Many.
- *
- * @template TItem Type of the related entity.
- */
-export type ManyRelationConfig<TItem> = {
-    /** Primary key of the related entity. */
-    pk: keyof TItem;
-    /** Relation type: `otm` (One-to-Many) or `mtm` (Many-to-Many). */
-    mode: 'otm' | 'mtm';
-    /** Mutation behavior: `set` (replaces all) or `add` (appends to existing). */
-    restriction: 'set' | 'add';
-};
-
-/**
- * One-to-One relation configuration.
- *
- * @template TItem Type of the related entity.
- */
-export type OneToOneRelationConfig<TItem> = {
-    /** Primary key of the related entity. */
-    pk: keyof TItem;
-    /** Relation type: `oto` (One-to-One). */
-    mode: 'oto';
-    /** Allowed mutation behavior for saving. */
-    restriction: 'set' | 'add';
-};
-
-/**
- * Many-to-One relation configuration.
- *
- * @template TItem Type of the related entity.
- */
-export type ManyToOneRelationConfig<TItem> = {
-    /** Primary key of the related entity. */
-    pk: keyof TItem;
-    /** Relation type: `mto` (Many-to-One). */
-    mode: 'mto';
-    /** Allowed mutation behavior for saving. */
-    restriction: 'set' | 'add';
-    /**
-     * Enables the ability to unlink the relation, setting the foreign key to null.
-     * @deprecated Use `nullable` (lowercase) instead of `nullAble`.
-     */
-    nullAble?: boolean;
-    /** Enables the ability to unlink the relation, setting the foreign key to null. */
-    nullable?: boolean;
-};
-
-/**
- * Automatically infers the possible relation configuration from a field.
- */
-export type ExtractRelationConfig<TField> = NonNullable<TField> extends infer NonNull
-    ? NonNull extends Date | Buffer | Uint8Array | Decimal | JsonValue ? never
-    : NonNull extends any[] ? (NonNull[number] extends object ? ManyRelationConfig<NonNull[number]> : never)
-    : NonNull extends object ? (OneToOneRelationConfig<NonNull> | ManyToOneRelationConfig<NonNull>)
-    : never
-    : never;
-
-/**
- * Map of configurable relations for an entity type.
- */
-export type RepositoryRelations<T> = {
-    [K in keyof T as ExtractRelationConfig<T[K]> extends never ? never : K]?: ExtractRelationConfig<T[K]>;
-};
-
-type AnySelect<M extends PrismaModelName> = Prisma.TypeMap['model'][M]['operations']['findMany']['args']['select'];
-
-/**
- * Main configuration used in `setupVSRepo<T, M>()(config)`.
- *
- * @template T Type of the entity managed by the repository.
- * @template M Prisma model name.
- * @template SM Map of named select models.
- */
-export type RepoConfig<T, M extends PrismaModelName, SM extends Record<string, AnySelect<M>> = Record<string, AnySelect<M>>> = {
-    tableName: Uncapitalize<M>;
-    pkName: keyof T;
-    softRemovekName?: keyof T & string;
-    selectModels?: SM;
-    defaultSelectModel?: Extract<keyof SM, string>;
-    includeModels?: IncludeModels<M>;
-    requiredWhere?: WhereModel<M>;
-    defaultOrdering?: OrderingModel<M>;
-    /** @deprecated Use `defaultOrdering` instead. */
-    defaultOrdenation?: OrderingModel<M>;
-    relations?: RepositoryRelations<T>;
-    methods?: Record<string, MethodConfig<M, SM>>;
-};
-
-/**
- * Final type returned by `.build(prisma)`.
- *
- * Combines dynamic methods, base methods, and custom extensions.
- */
-type BuiltRepository<T extends object, M extends PrismaModelName, Config extends RepoConfig<T, M, any>, C extends BuildConfig<any> | undefined> = {
-    /**
-     * Extends the repository with custom methods without losing type inference.
-     */
-    extend<E>(extensionFunc: (repo: BuiltRepository<T, M, Config, C>) => E): BuiltRepository<T, M, Config, C> & E;
-
-    /**
-     * The Prisma Client instance passed to `build`.
-     */
-    readonly prisma: DbClient;
-} & DynamicMethods<T, M, Config, PrismaModelInputs<M>> & InjectedBaseMethods<T, M, Config, C>;
-
-/**
- * Typed repository factory based on the Prisma model configuration.
- */
-export declare class VSRepository<T extends object, M extends PrismaModelName, const Config extends RepoConfig<T, M, any> = RepoConfig<T, M, any>> {
-    /** Original configuration provided to `setupVSRepo`. */
-    readonly config: Config;
-    /**
-     * Creates a configurable instance of `VSRepository`.
-     */
-    constructor(config: Config);
-    /**
-     * Builds the final repository with base and dynamic methods.
-     */
-    build<C extends BuildConfig<keyof ExtractSelectModels<Config>>>(prisma: DbClient, config?: C): BuiltRepository<T, M, Config, C>;
-    vsrepocache: never;
-}
-
-/**
- * Infers the type of an already-configured repository from a `VSRepository` instance.
- *
- * Also allows manually providing the `BuildConfig` and extensions type.
- */
-export type RepositoryOf<TRepo, C extends BuildConfig<any> | undefined = undefined, E = unknown> =
-    TRepo extends VSRepository<infer T, infer M, infer Config>
-        ? Simplify<BuiltRepository<T, M, Config, C> & E>
-        : never;
-
-/**
- * Utility type used to validate a repository configuration at compile time.
- */
-export type ValidateRepoConfig<T extends object, M extends PrismaModelName, Config> = {
-    /**
-     * Name of the table mapped by Prisma (usually uncapitalized).
-     */
-    tableName: Uncapitalize<M>;
-
-    /**
-     * Name of the field that represents the entity's primary key (Primary Key).
-     */
-    pkName: keyof T;
-
-    /**
-     * Name of the `DateTime` field used for soft-delete.
-     *
-     * When configured, enables the `softRemove`, `softRemoveList`, `restore`, and `restoreList` methods.
-     * The field **must** be of type `DateTime` in the Prisma schema — VSRepository validates this during `build`.
-     */
-    softRemovekName?: keyof T & string;
-
-    /**
-     * Defines named and reusable data projections (selects).
-     * Allows creating different views of the same entity (e.g., `public`, `minimal`, `internal`).
-     */
-    selectModels?: SelectModels<M>;
-
-    /**
-     * Defines which select (a key from `selectModels`) will be used automatically
-     * when none is specified in the method call.
-     * It is highly recommended to define it whenever `selectModels` are used.
-     */
-    defaultSelectModel?: string;
-
-    /**
-     * Defines named and reusable include projections.
-     * Similar to selectModels, but resolves Prisma `include` clauses.
-     */
-    includeModels?: IncludeModels<M>;
-
-    /**
-     * Defines global filters that will be automatically applied to all repository queries.
-     * Useful for tenant isolation (multi-tenancy) or base restrictions (e.g., `isActive: true`).
-     */
-    requiredWhere?: WhereModel<M>;
-
-    /**
-     * Default ordering automatically injected into all queries that accept `orderBy`,
-     * unless the method already has `injectOrdering` configured or uses the `Ordered` suffix.
-     *
-     * Useful for ensuring a consistent sort order across the repository without repeating
-     * the `order` argument on every call.
-     */
-    defaultOrdering?: OrderingModel<M>;
-
-    /**
-     * Default ordering automatically injected into all queries that accept `orderBy`,
-     * unless the method already has `injectOrdering` configured or uses the `Ordered` suffix.
-     *
-     * Useful for ensuring a consistent sort order across the repository without repeating
-     * the `order` argument on every call.
-     *
-     * @deprecated Use `defaultOrdering` instead.
-     */
-    defaultOrdenation?: OrderingModel<M>;
-
-    /**
-     * Configures automatic relation management.
-     * When configured, allows the `save`, `saveList`, `patch`, and `patchList` methods 
-     * to automatically handle linking, creation, or cascading deletion of related records.
-     */
-    relations?: RepositoryRelations<T>;
-
-    /**
-     * Definition of dynamic repository methods.
-     * Behaviors and return types are automatically inferred from the method's name 
-     * (e.g., `findOneByEmail`, `findManyPaginated`) or proxied via the `proxyTo` property.
-     */
-    methods?: {
-        [K in keyof (Config extends { methods: infer Meth } ? Meth : {})]: K extends string
-            ? MethodConfig<M, Config extends { selectModels: infer SM } ? SM : any> &
-              (K extends ValidMethodPatterns
-                  ? {}
-                  : (Config extends { methods: infer Meth }
-                        ? (K extends keyof Meth ? Meth[K] : never)
-                        : never) extends { query: any }
-                    ? {}
-                    : { proxyTo: ValidMethodPatterns })
-            : never;
-    };
-};
-
-/**
- * Function to initialize and configure the `repository`.
- * The configuration passed here is what will be read when `.build()` is called.
- */
-export declare function setupVSRepo<T extends object, M extends PrismaModelName>(): <
-    const SM extends Record<string, SelectModel<M>>,
-    const Config extends RepoConfig<T, M, SM>
->(
-  config: Config & ValidateRepoConfig<T, M, Config>
-) => VSRepository<T, M, Config>;
+import "reflect-metadata";
+import { VSRepoOptions } from "./types/vsrepo/vsrepo-options.type";
+import { CountResult } from "./types/utils/count-result.type";
+import { DeepPartial } from "./types/utils/deep-partial.type";
+import { KeysOfType } from "./types/utils/keys-of-type.type";
+import { VSRepoWhere } from "./types/vsrepo/vsrepo-where.type";
+import { VSRepoOrmTypes } from "./types/vsrepo/vsrepo-orm-types.type";
+import { VSRepoTransactionOptions } from "./types/vsrepo/vsrepo-transaction-options.type";
+import { MethodOptions } from "./types/utils/methods-options.type";
+import { Ordering } from "./types/utils/ordering.type";
+import { Pagination } from "./types/utils/pagination.type";
+import { VSRepoArgs } from "./types/vsrepo/vsrepo-args.type";
+import { VSRepoQueryOptions } from "./types/vsrepo/vsrepo-query-options.type";
+import { NumericKeys } from "./types/utils/numeric-keys.type";
+import { RestrictMethodOptions } from "./types/utils/restrict-method-options.type";
+/**
+ * ORM-agnostic base repository, exposing a complete set of ready-to-use CRUD
+ * and soft-delete methods around an entity, plus any `@DynamicMethod`/`@QueryMethod`
+ * decorated methods declared on the subclass.
+ *
+ * Unlike the previous (v1) `VSRepository`, this class delegates every
+ * operation to a `VSRepoAdapter` instead of talking to Prisma directly, which
+ * is what allows it to work with any ORM/database that has an adapter
+ * implementation (e.g. Prisma, TypeORM).
+ *
+ * @template Entity Type of the entity managed by the repository.
+ * @template PKType Type of the entity's primary key value.
+ * @template OrmTypes ORM-specific client/transaction types. See `VSRepoOrmTypes`.
+ *
+ * @example
+ * ```typescript
+ * class UserRepository extends VSRepository<User, string> {
+ *     constructor() {
+ *         super({ pkName: "id", adapter: new VSRepoPrisma7Adapter(prisma, "user") });
+ *     }
+ *
+ *     @DynamicMethod()
+ *     declare findByEmail: (email: string) => Promise<User[]>;
+ * }
+ *
+ * const userRepository = new UserRepository();
+ * const user = await userRepository.get("123");
+ * ```
+ *
+ * @publicApi
+ */
+export declare abstract class VSRepository<Entity, PKType, OrmTypes extends VSRepoOrmTypes = VSRepoOrmTypes> {
+    readonly pkName: KeysOfType<Entity, PKType>;
+    private readonly adapter;
+    private readonly mergeWheresResolver;
+    private readonly logger;
+    private readonly validator;
+    private readonly softRemoveKey?;
+    private readonly defaultOrdering?;
+    /**
+     * This is a property managed by VSRepository, please don't modify it!!
+     * @internal
+     */
+    $vsrepocache: Map<string, (args: any[], methodOptions?: MethodOptions<Entity, OrmTypes>) => VSRepoArgs<Entity>>;
+    /**
+     * Creates a configured instance of `VSRepository`, resolving and validating
+     * every `@DynamicMethod`/`@QueryMethod` declared on the subclass.
+     */
+    constructor(options: VSRepoOptions<Entity, PKType>);
+    private fail;
+    private wherePk;
+    private wherePkIn;
+    private execBaseMethod;
+    /**
+     * Runs `fn` inside a native transaction of the underlying ORM, sharing the
+     * transaction client (`tx`) across every repository call made within it.
+     */
+    transaction<R, TX = OrmTypes["dbTransaction"]>(fn: (tx: TX) => Promise<R>, options?: VSRepoTransactionOptions): Promise<R>;
+    /** Returns the underlying ORM client instance used outside of transactions. */
+    getDbClient<DB extends any = OrmTypes["dbClient"]>(): DB;
+    /**
+     * Executes a raw query/statement directly against the underlying database.
+     *
+     * Use `$1`, `$2`, ... placeholders for values passed via `options.args` —
+     * never interpolate values directly into `query`, to avoid SQL injection.
+     * Set `options.modifying: true` for `INSERT`/`UPDATE`/`DELETE` statements.
+     *
+     * @example
+     * ```typescript
+     * const users = await userRepository.query<User[]>(
+     *     'SELECT * FROM "user" WHERE email = $1',
+     *     { args: ["joao@email.com"] },
+     * );
+     *
+     * const affected = await userRepository.query<number>(
+     *     'UPDATE "user" SET active = true WHERE id = $1',
+     *     { args: ["123"], modifying: true },
+     * );
+     * ```
+     */
+    query<T = any>(query: string, options?: VSRepoQueryOptions<OrmTypes>): Promise<T>;
+    /** Fetches a record by its primary key (PK). */
+    get(pk: PKType, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity | null>;
+    /** Fetches a record by PK and throws an Error if not found. */
+    getOrThrow(pk: PKType, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /** Fetches multiple records by a list of primary keys (PKs). */
+    getList(pks: PKType[], options?: MethodOptions<Entity, OrmTypes>): Promise<Entity[]>;
+    /** Fetches all records (respects the repository's `defaultOrdering` unless `order` is provided). */
+    getAll(options?: MethodOptions<Entity, OrmTypes> & {
+        pagination?: Pagination;
+        order?: Ordering<Entity>;
+    }): Promise<Entity[]>;
+    /** Creates or updates (upsert) a record. */
+    save(obj: DeepPartial<Entity>, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /** Creates or updates (upsert) multiple records in a single operation. */
+    saveList(objs: DeepPartial<Entity>[], options?: MethodOptions<Entity, OrmTypes> & {
+        db?: OrmTypes["dbTransaction"];
+    }): Promise<Entity[]>;
+    /** Deletes a record identified by its primary key (PK). */
+    remove(pk: PKType, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /** Deletes multiple records by their primary keys, returning the count of affected rows. */
+    removeList(pks: PKType[], options?: RestrictMethodOptions<Entity, OrmTypes>): Promise<CountResult>;
+    /** Partially updates an existing record by its primary key (PK). */
+    patch(pk: PKType, obj: DeepPartial<Entity>, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /**
+     * Fetches a record by PK and returns it deep-merged, in memory, with the
+     * provided object — does **not** persist anything (pass the result to
+     * `save`/`patch` yourself to write it).
+     */
+    merge<U extends DeepPartial<Entity>>(pk: PKType, obj: U, options?: MethodOptions<Entity, OrmTypes>): Promise<(U & Entity) | null>;
+    /** Returns the total number of records. */
+    total(options?: RestrictMethodOptions<Entity, OrmTypes>): Promise<number>;
+    /** Checks whether a record exists by its primary key (PK). */
+    has(pk: PKType, options?: RestrictMethodOptions<Entity, OrmTypes>): Promise<boolean>;
+    /** Marks a record as deleted (soft-delete). Requires `softRemoveKey` to be configured on the repository. */
+    softRemove(pk: PKType, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /** Marks multiple records as deleted (soft-delete) in batch. Requires `softRemoveKey` to be configured on the repository. */
+    softRemoveList(pks: PKType[], options?: RestrictMethodOptions<Entity, OrmTypes>): Promise<CountResult>;
+    /** Restores a record previously marked as deleted (soft-delete). Requires `softRemoveKey` to be configured on the repository. */
+    restore(pk: PKType, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /** Restores multiple records previously marked as deleted (soft-delete) in batch. Requires `softRemoveKey` to be configured on the repository. */
+    restoreList(pks: PKType[], options?: RestrictMethodOptions<Entity, OrmTypes>): Promise<CountResult>;
+    /**
+     * Atomically adds `value` to a numeric field of the record identified
+     * by `pk`, evaluated server-side against the row's current value (e.g.
+     * `saldo = saldo + value`) — not a fetch-then-save round trip.
+     */
+    increment<Field extends NumericKeys<Entity>>(pk: PKType, field: Field, value: NonNullable<Entity[Field]>, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /** Same as {@link VSRepository.increment}, subtracting `value` instead of adding it. */
+    decrement<Field extends NumericKeys<Entity>>(pk: PKType, field: Field, value: NonNullable<Entity[Field]>, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /** Same as {@link VSRepository.increment}, multiplying the field's current value by `value`. */
+    multiply<Field extends NumericKeys<Entity>>(pk: PKType, field: Field, value: NonNullable<Entity[Field]>, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /**
+     * Same as {@link VSRepository.increment}, dividing the field's current
+     * value by `value`. Division-by-zero behavior depends on the adapter/
+     * underlying database (see {@link VSRepoAdapter.divideOne}).
+     */
+    divide<Field extends NumericKeys<Entity>>(pk: PKType, field: Field, value: NonNullable<Entity[Field]>, options?: MethodOptions<Entity, OrmTypes>): Promise<Entity>;
+    /**
+     * Returns the sum of a numeric field across every record matching
+     * `where` (all records if omitted), or `null` if none match — mirrors
+     * SQL's `SUM()`, which returns `NULL` (not `0`) over an empty set.
+     */
+    sum(field: NumericKeys<Entity>, where?: VSRepoWhere<Entity>, options?: RestrictMethodOptions<Entity, OrmTypes>): Promise<number | null>;
+    /** Same as {@link VSRepository.sum}, but the arithmetic mean instead of the total. */
+    average(field: NumericKeys<Entity>, where?: VSRepoWhere<Entity>, options?: RestrictMethodOptions<Entity, OrmTypes>): Promise<number | null>;
+    /** Same as {@link VSRepository.sum}, but the minimum value instead of the total. */
+    min(field: NumericKeys<Entity>, where?: VSRepoWhere<Entity>, options?: RestrictMethodOptions<Entity, OrmTypes>): Promise<number | null>;
+    /** Same as {@link VSRepository.sum}, but the maximum value instead of the total. */
+    max(field: NumericKeys<Entity>, where?: VSRepoWhere<Entity>, options?: RestrictMethodOptions<Entity, OrmTypes>): Promise<number | null>;
+}