vsrepo 1.2.4 → 1.2.6

package/README.md

@@ -2,7 +2,7 @@
 
 ![npm](https://img.shields.io/npm/v/vsrepo?style=flat-square)
 ![NPM License](https://img.shields.io/npm/l/vsrepo)
-![NPM Downloads](https://img.shields.io/npm/d18m/vsrepo.svg)
+![NPM Downloads](https://img.shields.io/npm/dt/vsrepo?style=flat-square)
 
 Biblioteca de repository pattern para projetos que usam **Prisma**, com suporte completo a **TypeScript** e **type inference** automático.
 
@@ -362,7 +362,7 @@ usuarioVSRepo.build(prisma, {
       ignoreRequiredWhere: false, // Aplica o requiredWhere no remove (padrão = false)
     },
     save: {
-      ignoreRequiredWhere: true,  // Não aplica requiredWhere no save
+      ignoreRequiredWhere: true,  // Não aplica requiredWhere no upsert do save
     },
     patch: {
       defaultSelect: "minimal",
@@ -433,10 +433,10 @@ Métodos dinâmicos são definidos na propriedade `methods` e têm seus comporta
 
 ```ts
 methods: {
-  findByEmail:           { map: true, fbMode: "one" },
-  findManyPaginated:     { map: true },
-  updateById:            { map: true },
-  deleteManyByIdIn:      { map: true, whereType: "overwrite" },
+  findOneByEmail:     { map: true },
+  findManyPaginated:  { map: true },
+  updateById:         { map: true },
+  deleteManyByIdIn:   { map: true },
 }
 ```
 
@@ -448,7 +448,8 @@ O prefixo do nome do método determina qual operação Prisma será chamada e qu
 
 | Prefixo                   | Operação Prisma          | Retorno                | Observações                                              |
 | ------------------------- | ------------------------ | ---------------------- | -------------------------------------------------------- |
-| `findBy`                  | `findMany` / `findFirst` | `T[]` ou `T \| null`   | Padrão é lista; use `fbMode: "one"` para retorno único   |
+| `findBy`                  | `findMany` / `findFirst` | `T[]` ou `T \| null`   | Padrão é lista; use `fbMode: "one"` (obsoleto, use `findOneBy`) para retorno único |
+| `findOneBy`               | `findFirst`              | `T \| null`            | Faz o mesmo que `findBy` com `fbMode: "one"`. Retorno único. |
 | `findUniqueBy`            | `findUnique`             | `T \| null`            |                                                          |
 | `findUniqueOrThrowBy`     | `findUniqueOrThrow`      | `T`                    | Lança erro se não encontrar                                  |
 | `findFirstBy`             | `findFirst`              | `T \| null`            | Aceita campos como filtro                                |
@@ -457,9 +458,11 @@ O prefixo do nome do método determina qual operação Prisma será chamada e qu
 | `findFirstOrThrow`        | `findFirstOrThrow`       | `T`                    | Sem filtros de campo; aplica só `requiredWhere` e `pushWhere`; lança erro se não encontrar |
 | `findManyBy`              | `findMany`               | `T[]`                  | Aceita campos como filtro                                |
 | `findMany`                | `findMany`               | `T[]`                  | Sem filtros de campo; aplica só `requiredWhere` e `pushWhere`           |
-| `findWhere`               | `findFirst`              | `T \| null`            | Recebe um objeto `where` explícito como argumento        |
+| `findWhere`               | `findFirst`              | `T \| null`            | (**Obsoleto, use `findOneWhere`**) Recebe um objeto `where` explícito como argumento |
+| `findOneWhere`            | `findFirst`              | `T \| null`            | Recebe um objeto `where` explícito como argumento                     |
 | `findListWhere`           | `findMany`               | `T[]`                  | Recebe um objeto `where` explícito como argumento        |
 | `existsBy`                | `findFirst`              | `boolean`              | Retorna `true` se encontrar, `false` caso contrário      |
+| `existsWhere`             | `findFirst`              | `boolean`              | Recebe um objeto `where` explícito como argumento e retorna se existe |
 | `countBy`                 | `count`                  | `number`               | Aceita campos como filtro                                |
 | `countWhere`              | `count`                  | `number`               | Recebe um objeto `where` explícito como argumento        |
 | `count`                   | `count`                  | `number`               | Sem filtros de campo; aplica só `requiredWhere` e `pushWhere`           |
@@ -468,10 +471,13 @@ O prefixo do nome do método determina qual operação Prisma será chamada e qu
 | `createManyAndReturn`     | `createManyAndReturn`    | `T[]`                  | Recebe `data` como argumento; suporta `SkipDuplicates`   |
 | `updateBy`                | `update`                 | `T`                    | Recebe `data` como argumento                             |
 | `updateManyBy`            | `updateMany`             | `{ count: number }`    | Recebe `data` como argumento                             |
+| `updateManyWhere`         | `updateMany`             | `{ count: number }`    | Recebe um objeto `where` e um objeto `data` como argumentos           |
 | `updateManyAndReturnBy`   | `updateManyAndReturn`    | `T[]`                  | Recebe `data` como argumento                             |
+| `updateManyAndReturnWhere` | `updateManyAndReturn`    | `T[]`                  | Recebe um objeto `where` e um objeto `data` como argumentos           |
 | `upsertBy`                | `upsert`                 | `T`                    | Recebe `update` e `create` como argumentos               |
 | `deleteBy`                | `delete`                 | `T`                    |                                                          |
 | `deleteManyBy`            | `deleteMany`             | `{ count: number }`    |                                                          |
+| `deleteManyWhere`         | `deleteMany`             | `{ count: number }`    | Recebe um objeto `where` explícito como argumento                     |
 | `aggregate`               | `aggregate`              | `Dinâmico`               | Nome deve ser exato; recebe args nativos do Prisma; ignora `selectModels`, `pushWhere` e `requiredWhere` |
 | `groupBy`               | `groupBy`              | `Dinâmico[]`               | Nome deve ser exato; recebe args nativos do Prisma; ignora `selectModels`, `pushWhere` e `requiredWhere` |
 
@@ -556,7 +562,7 @@ findByNomeOptionalAndEmail // nome é opcional (pode ser passado como undefined
 
 | Operador  | Uso no nome                  | Exemplo                          |
 | --------- | ---------------------------- | -------------------------------- |
-| `And`     | entre dois campos            | `findByIdAndEmail`               |
+| `And`     | entre dois campos            | `findOneByIdAndEmail`               |
 | `Or`      | entre dois campos            | `findByNomeOrEmail`              |
 | `AND`     | separa bloco final em `AND`  | `findByEmailOrNameANDActiveStatus` |
 
@@ -570,20 +576,20 @@ Exemplo:
 
 ```ts
 methods: {
-  findByIdAndEmail:   { map: true, fbMode: "one" },
+  findOneByIdAndEmail:   { map: true },
   findByNomeOrEmail:  { map: true },
   findUniqueByIdOrEmailAndNome: { map: true },
   findByEmailOrNameANDActiveStatusAndIdadeGreaterThan: { map: true }
 }
 
 // Uso
-await usuarioRepository.findByIdAndEmail(1, "joao@email.com");
+await usuarioRepository.findOneByIdAndEmail(1, "joao@email.com");
 await usuarioRepository.findByNomeOrEmail("Joao", "joao@email.com");
 await usuarioRepository.findUniqueByIdOrEmailAndNome(1, "joao@email.com", "Joao");
 await usuarioRepository.findByEmailOrNameANDActiveStatusAndIdadeGreaterThan("joao@email.com", "Joao", true, 17)
 ```
 
-Gera (`findByIdAndEmail`):
+Gera (`findOneByIdAndEmail`):
 
 ```ts
 {
@@ -638,6 +644,12 @@ Gera (`findByEmailOrNameANDActiveStatusAndIdadeGreaterThan`):
 
 Permitem filtrar por campos de modelos relacionados.
 
+> [!IMPORTANT]
+> - **Tipagem de relação**: Para que o TypeScript reconheça os tipos dos campos de relação nos métodos dinâmicos, o tipo genérico da entidade passado no `setupVSRepo` deve incluir as relações estruturadas (ex: usando `UsuarioGetPayload<{ include: { perfil: true, postagens: true } }>` do Prisma).
+> - **Compatibilidade de sufixos**:
+>   - Os sufixos `Some`, `Every` e `None` só funcionam para relações **to-many** (`many-to-many` e `one-to-many`).
+>   - Os sufixos `With` e `Without` só funcionam para relações **to-one** (`one-to-one` e `many-to-one`).
+
 | Sufixo de relação      | Operador Prisma | Observação                                         |
 | ---------------------- | --------------- | -------------------------------------------------- |
 | `Some`                 | `some: {}`      | Relação tem *algum* registro                       |
@@ -664,7 +676,7 @@ methods: {
 ```
 
 > [!NOTE]
-> Teoricamente você pode usar `Every` sem `Field` (ele geraria { every: {} }), porém isso não produz um filtro efetivo. A condição é considerada verdadeira para qualquer relação, inclusive quando não existem registros relacionados, tornando o resultado equivalente a não aplicar filtro algum.
+> Teoricamente você pode usar `Every` sem `Field` (ele geraria { every: { } }), porém isso não produz um filtro efetivo. A condição é considerada verdadeira para qualquer relação, inclusive quando não existem registros relacionados, tornando o resultado equivalente a não aplicar filtro algum.
 
 ---
 
@@ -733,7 +745,7 @@ Cada entrada em `methods` aceita as seguintes opções:
 | `map`               | `boolean`                       | —            | **Obrigatório.** Define se o método será exposto no repository.                                             |
 | `whereType`         | `'extending'` \| `'overwrite'`  | `extending`  | `extending` combina com `requiredWhere`. `overwrite` ignora o `requiredWhere`.                      |
 | `selectModel`       | `keyof SelectModels \| false`   | —            | Sobrescreve o `defaultSelectModel` para este método.                                                        |
-| `fbMode`            | `'one'` \| `'list'`             | `'list'`     | Somente para `findBy`. `'one'` retorna `T \| null`; `'list'` retorna `T[]`.                                 |
+| `fbMode`            | `'one'` \| `'list'`             | `'list'`     | (**Obsoleto. Use `findOneBy`**) Somente para `findBy`. `'one'` retorna `T \| null`; `'list'` retorna `T[]`. |
 | `proxyTo`           | `Padrão de método válido`           | —            | Delega a lógica para outro padrão de método válido. Útil para methods com nomes personalizados.       |
 | `pushWhere`         | `WhereModel<M>`                 | —            | Where extra adicionado à query além do `requiredWhere`.                                                     |
 | `injectOrdenation`  | `OrdenationModel<M>`            | —            | Ordenação fixa injetada automaticamente na query.                                                           |
@@ -743,8 +755,8 @@ Exemplos:
 
 ```ts
 methods: {
-  // Retorna um único resultado em vez de array
-  findByEmail: { map: true, fbMode: "one" },
+  // Retorna um único resultado
+  findOneByEmail: { map: true },
 
   // Ignora o requiredWhere
   deleteManyByIdIn: { map: true, whereType: "overwrite" },
@@ -878,7 +890,6 @@ await usuarioRepository.save({
   email: "maria@email.com",
   senha: "password",
   perfil: {
-    id: 1,
     bio: "Bio da Maria",
   },
   postagens: [
@@ -888,7 +899,6 @@ await usuarioRepository.save({
 
 await usuarioRepository.patch(1, {
   perfil: {
-    id: 1,
     bio: "Bio atualizada",
   },
   postagens: [
@@ -983,8 +993,8 @@ try {
 
 | Classe               | Quando é lançada                                        |
 | -------------------- | ------------------------------------------------------- |
-| `VSRepoConfigError`  | Configuração inválida em `setupVSRepo`       |
-| `VSRepoBuildError`   | Nome de método inválido ou desconhecido no `build`      |
+| `VSRepoConfigError`  | Configuração inválida em `setupVSRepo`                  |
+| `VSRepoBuildError`   | Nome de método ou configuração inválida no `build`      |
 | `VSRepoExtendError`  | Argumento inválido em `extend`                          |
 | `VSRepoRuntimeError` | Erro em tempo de execução durante uma operação          |
 

package/VSRepository/VSRepoUtils.js

@@ -81,7 +81,7 @@ export function validateConfig(config) {
     if(!configParsed.success) {
         const firstIssue = configParsed.error.issues[0];
         const path = firstIssue.path.length ? firstIssue.path.join(".") : "config";
-        throw new VSRepoConfigError(`[VSRepository] (config) ${path}: ${firstIssue.message}`)
+        throw new VSRepoConfigError(`[VSRepository] (${config.tableName}: config) ${path}: ${firstIssue.message}`)
     }
 
     return configParsed.data;
@@ -123,6 +123,11 @@ export function validateBuildConfig(buildConfig, buildInstance) {
                 defaultSelect: defaultSelectSchema,
                 ignoreRequiredWhere: ignoreRequiredWhereSchema
             }).optional(),
+            patch: z.strictObject({
+                active: activeSchema,
+                defaultSelect: defaultSelectSchema,
+                ignoreRequiredWhere: ignoreRequiredWhereSchema
+            }).optional(),
             removeList: z.strictObject({
                 active: activeSchema,
                 ignoreRequiredWhere: ignoreRequiredWhereSchema
@@ -143,7 +148,7 @@ export function validateBuildConfig(buildConfig, buildInstance) {
     if(!buildConfigParsed.success) {
         const firstIssue = buildConfigParsed.error.issues[0];
         const path = firstIssue.path.length ? firstIssue.path.join(".") : "config";
-        throw new VSRepoBuildError(`[VSRepository] (build) ${path}: ${firstIssue.message}`)
+        throw new VSRepoBuildError(`[VSRepository] (${config.tableName}: build) ${path}: ${firstIssue.message}`)
     }
 
     return buildConfigParsed.data;

package/VSRepository/VSRepository.d.ts

@@ -1,4 +1,13 @@
 import { Prisma, PrismaClient } from '@vsrepo/prisma/types';
+import { Decimal, JsonValue } from '@prisma/client/runtime/client';
+
+type WidenField<T> = 
+    T extends bigint ? bigint | number :
+    T extends Date ? Date | string :
+    T extends Decimal ? Decimal | string | number :
+    T extends Array<infer U> ? WidenField<U>[] :
+    T extends readonly [infer U, infer V] ? [WidenField<U>, WidenField<V>] :
+    T;
 
 /**
  * Instância completa do Prisma Client usada para construir repositories.
@@ -53,6 +62,8 @@ type ValidMethodPatterns =
     | `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> =
@@ -98,21 +109,23 @@ type ParseRelation<S extends string> =
     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> = 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]
+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]
-                : 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;
+            : 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';
 
@@ -156,10 +169,10 @@ type FilterNonEmpty<T extends unknown[]> =
         : [];
 
 type ResolveReturnType<M extends string, TSelected> =
-    M extends 'existsBy' ? boolean :
-    M extends 'createMany' | 'updateManyBy' | 'deleteManyBy' ? { count: number } :
-    M extends 'findMany' | 'createManyAndReturn' | 'updateManyAndReturnBy' | 'findListWhere' | 'findByList' ? TSelected[] :
-    M extends 'findUnique' | 'findFirst' | 'findWhere' | 'findByOne' ? TSelected | null :
+    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;
 
@@ -177,7 +190,8 @@ type ExtraArgs<M extends string, R extends string, 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' ? [where: GetWhereInput<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>>]
@@ -248,7 +262,9 @@ type MethodFn<MethodName extends string, T, M extends Prisma.ModelName, R extend
 
 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' :
@@ -258,14 +274,18 @@ type GetMappedMethod<K extends string, MethodConf> =
     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' :
@@ -282,10 +302,20 @@ type ExtractPatternBase<K extends string> =
     K extends `countWhere${infer R}` ? R :
     K extends `count${infer R}` ? R :
     K extends `findListWhere${infer R}` ? R :
-    K extends `findWhere${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 Prisma.ModelName, K extends string, SelectModels, DefaultSelect extends keyof SelectModels | false, I, MethodConf> = 
-    MethodFn<GetMappedMethod<K, MethodConf>, T, M, ExtractPatternBase<K>, SelectModels, DefaultSelect, I>;
+    K extends `findWhere${string}`
+        ? {
+            /** @deprecated Use findOneWhere em seu lugar. */
+            <S extends keyof SelectModels | false = DefaultSelect>(...args: [...ExtractFields<T, CleanFields<ExtractPatternBase<K>>, I>, ...ExtraArgs<GetMappedMethod<K, MethodConf>, ExtractPatternBase<K>, I>, options?: MethodOptions<S>]): Promise<ResolveReturnType<GetMappedMethod<K, MethodConf>, SelectedModel<M, S, SelectModels>>>;
+          }
+        : MethodFn<GetMappedMethod<K, MethodConf>, T, M, ExtractPatternBase<K>, SelectModels, DefaultSelect, I>;
 
 type ResolveSelectModel<MethodConf, GlobalConf, SelectModels> = 
     MethodConf extends { selectModel: infer S } ? (S extends false ? false : S extends keyof SelectModels ? S : never) : 
@@ -390,14 +420,17 @@ export type MethodConfig<M extends Prisma.ModelName, SelectModels = any> = {
     /** Define se o método será exposto no repository. */
     readonly map: boolean;
     /** Sobrescreve o `defaultSelectModel` apenas para este método. */
-    readonly selectModel?: keyof SelectModels | false;
+    readonly selectModel?: string | false;
     /** Controla se o método combina (`extending`) ou sobrescreve (`overwrite`) o `requiredWhere`. */
     readonly whereType?: 'overwrite' | 'extending';
     /** Redireciona a lógica para outro padrão de método válido. */
     readonly proxyTo?: ValidMethodPatterns;
     /** Adiciona um `where` extra além do `requiredWhere`. */
     readonly pushWhere?: WhereModel<M>;
-    /** Define se `findBy` retorna um item (`one`) ou uma lista (`list`). */
+    /** 
+     * Define se `findBy` retorna um item (`one`) ou uma lista (`list`).
+     * @deprecated Use findOneBy se só quiser retornar um.
+     */
     readonly fbMode?: 'one' | 'list';
     /** Injeta uma ordenação fixa automaticamente na query. */
     readonly injectOrdenation?: OrdenationModel<M>;
@@ -465,12 +498,6 @@ type ResolveCurrentReturn<M extends Prisma.ModelName, Models, S, D> =
             ? ([D] extends [never] ? FullModelType<M> : SelectedModel<M, D, Models>)
             : SelectedModel<M, S, Models>;
 
-type RefineSaveResult<R, O> = { 
-    [K in keyof R]: K extends keyof O 
-        ? (undefined extends O[K] ? R[K] : null extends O[K] ? R[K] : NonNullable<R[K]>) 
-        : R[K]; 
-};
-
 type InjectedGet<
     T, M extends Prisma.ModelName, Config, C extends BuildConfig<any> | undefined,
     TSelects = ExtractSelectModels<Config>,
@@ -484,7 +511,7 @@ type InjectedGet<
      * @returns O registro selecionado ou `null` se não encontrado.
      */
     get<S extends keyof TSelects | false = ResolveMethodDefaultSelect<Config, C, 'get', TSelects>>(
-        pk: T[TPk extends keyof T ? TPk : never], options?: MethodOptions<S>
+        pk: WidenField<T[TPk extends keyof T ? TPk : never]>, options?: MethodOptions<S>
     ): Promise<ResolveCurrentReturn<M, TSelects, S, TDefault> | null>;
 };
 
@@ -501,7 +528,7 @@ type InjectedGetOrThrow<
      * @returns O registro selecionado.
      */
     getOrThrow<S extends keyof TSelects | false = ResolveMethodDefaultSelect<Config, C, 'getOrThrow', TSelects>>(
-        pk: T[TPk extends keyof T ? TPk : never], options?: MethodOptions<S>
+        pk: WidenField<T[TPk extends keyof T ? TPk : never]>, options?: MethodOptions<S>
     ): Promise<ResolveCurrentReturn<M, TSelects, S, TDefault>>;
 };
 
@@ -518,7 +545,7 @@ type InjectedRemove<
      * @returns O registro removido.
      */
     remove<S extends keyof TSelects | false = ResolveMethodDefaultSelect<Config, C, 'remove', TSelects>>(
-        pk: T[TPk extends keyof T ? TPk : never], options?: MethodOptions<S>
+        pk: WidenField<T[TPk extends keyof T ? TPk : never]>, options?: MethodOptions<S>
     ): Promise<ResolveCurrentReturn<M, TSelects, S, TDefault>>;
 };
 
@@ -593,7 +620,7 @@ export type SaveObject<TInput, TRepo> =
 /**
  * Extrai o tipo de payload do método `patch` a partir de uma instância de VSRepository configurada.
  */
-export type PacthObject<TInput, TRepo> = 
+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> & {
@@ -615,12 +642,12 @@ type InjectedSave<
      * @returns O registro salvo com tipos refinados conforme a entrada.
      */
     save<
-        O, 
+        O,
         S extends keyof TSelects | false = ResolveMethodDefaultSelect<Config, C, 'save', TSelects>
     >(
-        obj: O & UpsertWithRelations<T, M, TRelations>, 
+        obj: O & UpsertWithRelations<T, M, TRelations>,
         options?: MethodOptions<S>
-    ): Promise<RefineSaveResult<ResolveCurrentReturn<M, TSelects, S, TDefault>, O>>;
+    ): Promise<ResolveCurrentReturn<M, TSelects, S, TDefault>>;
 };
 
 type InjectedPatch<
@@ -641,10 +668,10 @@ type InjectedPatch<
         O,
         S extends keyof TSelects | false = ResolveMethodDefaultSelect<Config, C, 'patch', TSelects>
     >(
-        pk: T[TPk extends keyof T ? TPk : never],
+        pk: WidenField<T[TPk extends keyof T ? TPk : never]>,
         obj: O & UpdateWithRelations<T, M, TRelations>,
         options?: MethodOptions<S>
-    ): Promise<RefineSaveResult<ResolveCurrentReturn<M, TSelects, S, TDefault>, O>>;
+    ): Promise<ResolveCurrentReturn<M, TSelects, S, TDefault>>;
 };
 
 type InjectedRemoveList<
@@ -658,7 +685,7 @@ type InjectedRemoveList<
      * @returns Objeto com a contagem de registros removidos.
      */
     removeList(
-        pks: T[TPk extends keyof T ? TPk : never][], 
+        pks: WidenField<T[TPk extends keyof T ? TPk : never]>[], 
         options?: { db?: ClientOrTransaction }
     ): Promise<{ count: number }>;
 };
@@ -704,7 +731,7 @@ type InjectedHas<
      * @returns `true` se existir, caso contrário `false`.
      */
     has(
-        pk: T[TPk extends keyof T ? TPk : never], 
+        pk: WidenField<T[TPk extends keyof T ? TPk : never]>, 
         options?: { db?: ClientOrTransaction }
     ): Promise<boolean>;
 };
@@ -768,7 +795,7 @@ export type ManyToOneRelationConfig<TItem> = {
  * Infere automaticamente a configuração de relação possível a partir de um campo.
  */
 export type ExtractRelationConfig<TField> = NonNullable<TField> extends infer NonNull
-    ? NonNull extends Date | Buffer | Uint8Array ? never
+    ? 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
@@ -791,19 +818,12 @@ type AnySelect<M extends Prisma.ModelName> = Prisma.TypeMap['model'][M]['operati
  * @template SM Mapa de select models nomeados.
  */
 export type RepoConfig<T, M extends Prisma.ModelName, SM extends Record<string, AnySelect<M>> = Record<string, AnySelect<M>>> = {
-    /** Nome da tabela/modelo no Prisma. */
     tableName: Uncapitalize<M>;
-    /** Nome da chave primária da entidade. */
     pkName: keyof T;
-    /** Projeções de dados nomeadas e reutilizáveis. */
     selectModels?: SM;
-    /** Select model aplicado por padrão quando nenhum for informado. */
     defaultSelectModel?: Extract<keyof SM, string>;
-    /** Filtros aplicados automaticamente em todas as queries do repository. */
     requiredWhere?: WhereModel<M>;
-    /** Configuração das relações gerenciadas pelo `save`. */
     relations?: RepositoryRelations<T>;
-    /** Métodos dinâmicos expostos pelo repository. */
     methods?: Record<string, MethodConfig<M, SM>>;
 };
 
@@ -867,7 +887,7 @@ export type ValidateRepoConfig<T extends object, M extends Prisma.ModelName, Con
     requiredWhere?: WhereModel<M>;
     /** Relações gerenciadas automaticamente pelo `save` e pelo `patch`. */
     relations?: RepositoryRelations<T>;
-    /** Mapa dos métodos dinâmicos e suas regras de validação. */
+    /** Mapa dos métodos dinâmicos e suas configurações. */
     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 ? {} : { proxyTo: ValidMethodPatterns })

package/VSRepository/VSRepository.js

@@ -43,11 +43,11 @@ export class VSRepository {
 
     extend(extensionFunc) {
         if(typeof extensionFunc !== 'function'){
-            throw new VSRepoExtendError(`[VSRepository] (extend) 'extensionFunc' must be a valid funcion.`);
+            throw new VSRepoExtendError(`[VSRepository] (${this.tableName}: extend) 'extensionFunc' must be a valid funcion.`);
         }
         const extension = extensionFunc(this);
         if(typeof extension !== 'object' || extension === null){
-            throw new VSRepoExtendError(`[VSRepository] (extend) The return of the 'extensionFunc' must be a valid object.`)
+            throw new VSRepoExtendError(`[VSRepository] (${this.tableName}: extend) The return of the 'extensionFunc' must be a valid object.`)
         }
 
         const extended = Object.assign(Object.create(this), extension);
@@ -61,7 +61,7 @@ export class VSRepository {
 
     build(prisma, config = { freeze: true, showWorking: false }) {
         if(typeof prisma !== 'object' || prisma === null) {
-            throw new VSRepoBuildError(`[VSRepository] (build) 'prisma' must be a valid Prisma Client.`);
+            throw new VSRepoBuildError(`[VSRepository] (${this.tableName}: build) 'prisma' must be a valid Prisma Client.`);
         }
 
         const buildInstance = Object.create(this);
@@ -76,7 +76,7 @@ export class VSRepository {
         const repositoryKeysToMap = Object.keys(methods);
 
         if(showWorking) {
-            console.log(`[VSRepository] (build) Keys to map:`, JSON.stringify(repositoryKeysToMap, null, 2));
+            console.log(`[VSRepository] (${buildInstance.tableName}: build) Keys to map:`, JSON.stringify(repositoryKeysToMap, null, 2));
         }
 
         for (let keyToMap of repositoryKeysToMap) {
@@ -170,6 +170,16 @@ export class VSRepository {
                 ignoreSelect = true;
                 existsMode = true;
                 method = 'findFirst';
+            } else if(keyToMap.startsWith('existsWhere')) {
+                keyToMapReplaced = keyToMap.replace('existsWhere', '');
+                ignoreSelect = true;
+                existsMode = true;
+                ignoreWhere = true;
+                onlyBaseWheres = true;
+                method = 'findFirst';
+                whereIndex = 0;
+                otherParams.push('where');
+                argsCount += 1;
             } else if(keyToMap.startsWith('findManyBy')) {
                 keyToMapReplaced = keyToMap.replace('findManyBy', '');
                 ignoreOrderByAndPagination = false;
@@ -210,6 +220,15 @@ export class VSRepository {
                 dataIndex = -2;
                 otherParams.push('data');
                 argsCount++;
+            } else if(keyToMap.startsWith('updateManyAndReturnWhere')) {
+                keyToMapReplaced = keyToMap.replace('updateManyAndReturnWhere', '')
+                ignoreWhere = true;
+                onlyBaseWheres = true;
+                method = 'updateManyAndReturn';
+                dataIndex = -2;
+                whereIndex = 0;
+                otherParams.push('where', 'data');
+                argsCount += 2;
             } else if(keyToMap.startsWith('updateManyBy')) {
                 keyToMapReplaced = keyToMap.replace('updateManyBy', '')
                 ignoreSelect = true;
@@ -217,6 +236,16 @@ export class VSRepository {
                 dataIndex = -2;
                 otherParams.push('data');
                 argsCount++;
+            } else if(keyToMap.startsWith('updateManyWhere')) {
+                keyToMapReplaced = keyToMap.replace('updateManyWhere', '')
+                ignoreSelect = true;
+                ignoreWhere = true;
+                onlyBaseWheres = true;
+                method = 'updateMany';
+                dataIndex = -2;
+                whereIndex = 0;
+                otherParams.push('where', 'data');
+                argsCount += 2;
             } else if(keyToMap.startsWith('updateBy')) {
                 keyToMapReplaced = keyToMap.replace('updateBy', '')
                 method = 'update';
@@ -235,6 +264,15 @@ export class VSRepository {
                 keyToMapReplaced = keyToMap.replace('deleteManyBy', '')
                 ignoreSelect = true;
                 method = 'deleteMany';
+            } else if(keyToMap.startsWith('deleteManyWhere')) {
+                keyToMapReplaced = keyToMap.replace('deleteManyWhere', '')
+                ignoreSelect = true;
+                ignoreWhere = true;
+                onlyBaseWheres = true;
+                method = 'deleteMany';
+                whereIndex = 0;
+                otherParams.push('where');
+                argsCount += 1;
             } else if(keyToMap.startsWith('deleteBy')) {
                 keyToMapReplaced = keyToMap.replace('deleteBy', '')
                 method = 'delete';
@@ -247,6 +285,15 @@ export class VSRepository {
                 whereIndex = 0;
                 otherParams.push('where');
                 argsCount += 1;
+            } else if(keyToMap.startsWith('findOneWhere')) {
+                keyToMapReplaced = keyToMap.replace('findOneWhere', '');
+                ignoreOrderByAndPagination = false;
+                ignoreWhere = true;
+                onlyBaseWheres = true;
+                method = 'findFirst';
+                whereIndex = 0;
+                otherParams.push('where');
+                argsCount += 1;
             } else if(keyToMap.startsWith('findListWhere')) {
                 keyToMapReplaced = keyToMap.replace('findListWhere', '');
                 ignoreOrderByAndPagination = false;
@@ -260,8 +307,12 @@ export class VSRepository {
                 keyToMapReplaced = keyToMap.replace('findBy', '');
                 ignoreOrderByAndPagination = false;
                 method = methods[originalKey].fbMode === 'one' ? 'findFirst' : 'findMany';
+            } else if(keyToMap.startsWith('findOneBy')) {
+                keyToMapReplaced = keyToMap.replace('findOneBy', '');
+                ignoreOrderByAndPagination = false;
+                method = 'findFirst';
             } else {
-                throw new VSRepoBuildError(`[VSRepository] (build) Unknown method: ${keyToMap}.`);
+                throw new VSRepoBuildError(`[VSRepository] (${buildInstance.tableName}: build) Unknown method: ${keyToMap}.`);
             }
 
 
@@ -573,7 +624,7 @@ export class VSRepository {
                     return { context, otherProps, argName, autoVal: arg.autoInjectVal, betweenMode: arg.betweenMode };
                 });
                 if(showWorking) {
-                    console.log(`[VSRepository] (build) Where object resolved to ${keyToMap}:\n`, JSON.stringify(whereResolved, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: build) Where object resolved to ${keyToMap}:\n`, JSON.stringify(whereResolved, null, 2));
                 }
             }
 
@@ -730,7 +781,7 @@ export class VSRepository {
                 let optionsSelectModel;
                 if(args.length < argsCount) {
                     const missingParams = whereParams.concat(otherParams).slice(args.length);
-                    throw new VSRepoRuntimeError(`[VSRepository] (runtime) Missing parameters: ${missingParams.join(', ')}`);
+                    throw new VSRepoRuntimeError(`[VSRepository] (${buildInstance.tableName}: runtime) Missing parameters: ${missingParams.join(', ')}`);
                 } else if(args.length > argsCount) {
                     const optionsArg = args[args.length - 1];
                     db = optionsArg.db ?? db;
@@ -743,8 +794,8 @@ export class VSRepository {
 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing ${method} on ${buildInstance.tableName}.`);
-                    console.log(`[VSRepository] (runtime) Built arguments to ${method} on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing ${method}.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to ${method}:\n`, JSON.stringify(prismaArgs, null, 2));
                     start = performance.now();
                 }
 
@@ -754,7 +805,7 @@ export class VSRepository {
                     if(showWorking) {
                         const end = performance.now();
                         const duration = (end - start).toFixed(2);
-                        console.log(`[VSRepository] (runtime) Executed ${method} on ${buildInstance.tableName} (took: ${duration}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed ${method} (took: ${duration}ms).`);
                     }
 
                     if(existsMode) {
@@ -762,7 +813,7 @@ export class VSRepository {
                     }
                     return result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when executing ${method} on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when executing ${method}:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
                 
@@ -788,8 +839,8 @@ export class VSRepository {
 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing get on ${buildInstance.tableName}.`);
-                    console.log(`[VSRepository] (runtime) Built arguments to get on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing get.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to get:\n`, JSON.stringify(prismaArgs, null, 2));
                     start = performance.now();
                 }
 
@@ -799,12 +850,12 @@ export class VSRepository {
                     if(showWorking) {
                         const end = performance.now();
                         const duration = (end - start).toFixed(2);
-                        console.log(`[VSRepository] (runtime) Executed get on ${buildInstance.tableName} (took: ${duration}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed get (took: ${duration}ms).`);
                     }
 
                     return result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when trying to get on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when trying to get:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
             }
@@ -827,8 +878,8 @@ export class VSRepository {
 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing getOrThrow on ${buildInstance.tableName}.`);
-                    console.log(`[VSRepository] (runtime) Built arguments to getOrThrow on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing getOrThrow.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to getOrThrow:\n`, JSON.stringify(prismaArgs, null, 2));
                     start = performance.now();
                 }
 
@@ -838,12 +889,12 @@ export class VSRepository {
                     if(showWorking) {
                         const end = performance.now();
                         const duration = (end - start).toFixed(2);
-                        console.log(`[VSRepository] (runtime) Executed getOrThrow on ${buildInstance.tableName} (took: ${duration}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed getOrThrow (took: ${duration}ms).`);
                     }
 
                     return result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when trying to getOrThrow on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when trying to getOrThrow:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
             }
@@ -866,8 +917,8 @@ export class VSRepository {
                 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing remove on ${buildInstance.tableName}.`);
-                    console.log(`[VSRepository] (runtime) Built arguments to remove on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing remove.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to remove:\n`, JSON.stringify(prismaArgs, null, 2));
                     start = performance.now();
                 }
                 try {
@@ -876,12 +927,12 @@ export class VSRepository {
                     if(showWorking) {
                         const end = performance.now();
                         const duration = (end - start).toFixed(2);
-                        console.log(`[VSRepository] (runtime) Executed remove on ${buildInstance.tableName} (took: ${duration}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed remove (took: ${duration}ms).`);
                     }
 
                     return result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when trying to remove on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when trying to remove:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
             }
@@ -898,7 +949,7 @@ export class VSRepository {
 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing save on ${buildInstance.tableName}.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing save.`);
                     start = performance.now();
                 }
 
@@ -1030,7 +1081,7 @@ export class VSRepository {
                         prismaArgs.where = where;
 
                         if(showWorking) {
-                            console.log(`[VSRepository] (runtime) Built arguments to save on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                            console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to save:\n`, JSON.stringify(prismaArgs, null, 2));
                         }
 
                         result = await db[buildInstance.tableName].upsert(prismaArgs);
@@ -1081,7 +1132,7 @@ export class VSRepository {
                         }
 
                         if(showWorking) {
-                            console.log(`[VSRepository] (runtime) Built arguments to save on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                            console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to save:\n`, JSON.stringify(prismaArgs, null, 2));
                         }
 
                         result = await db[buildInstance.tableName].create(prismaArgs);
@@ -1090,12 +1141,12 @@ export class VSRepository {
                     if(showWorking) {
                         const end = performance.now();
                         const duration = (end - start).toFixed(2);
-                        console.log(`[VSRepository] (runtime) Executed save on ${buildInstance.tableName} (took: ${duration}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed save (took: ${duration}ms).`);
                     }
 
                     return result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when trying to save on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when trying to save:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
             } 
@@ -1113,19 +1164,19 @@ export class VSRepository {
 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing removeList on ${buildInstance.tableName}.`);
-                    console.log(`[VSRepository] (runtime) Built arguments to removeList on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing removeList.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to removeList:\n`, JSON.stringify(prismaArgs, null, 2));
                     start = performance.now();
                 }
                 try {
                     const result = await db[buildInstance.tableName].deleteMany(prismaArgs);
                     if(showWorking) {
                         const end = performance.now();
-                        console.log(`[VSRepository] (runtime) Executed removeList on ${buildInstance.tableName} (took: ${(end - start).toFixed(2)}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed removeList (took: ${(end - start).toFixed(2)}ms).`);
                     }
                     return result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when trying to removeList on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when trying to removeList:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
             }
@@ -1155,19 +1206,19 @@ export class VSRepository {
 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing getAll on ${buildInstance.tableName}.`);
-                    console.log(`[VSRepository] (runtime) Built arguments to getAll on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing getAll.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to getAll:\n`, JSON.stringify(prismaArgs, null, 2));
                     start = performance.now();
                 }
                 try {
                     const result = await db[buildInstance.tableName].findMany(prismaArgs);
                     if(showWorking) {
                         const end = performance.now();
-                        console.log(`[VSRepository] (runtime) Executed getAll on ${buildInstance.tableName} (took: ${(end - start).toFixed(2)}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed getAll (took: ${(end - start).toFixed(2)}ms).`);
                     }
                     return result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when trying to getAll on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when trying to getAll:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
             }
@@ -1183,19 +1234,19 @@ export class VSRepository {
 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing total on ${buildInstance.tableName}.`);
-                    console.log(`[VSRepository] (runtime) Built arguments to total on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing total.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to total:\n`, JSON.stringify(prismaArgs, null, 2));
                     start = performance.now();
                 }
                 try {
                     const result = await db[buildInstance.tableName].count(prismaArgs);
                     if(showWorking) {
                         const end = performance.now();
-                        console.log(`[VSRepository] (runtime) Executed total on ${buildInstance.tableName} (took: ${(end - start).toFixed(2)}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed total (took: ${(end - start).toFixed(2)}ms).`);
                     }
                     return result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when trying to total on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when trying to total:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
             }
@@ -1214,19 +1265,19 @@ export class VSRepository {
 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing has on ${buildInstance.tableName}.`);
-                    console.log(`[VSRepository] (runtime) Built arguments to has on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing has.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to has:\n`, JSON.stringify(prismaArgs, null, 2));
                     start = performance.now();
                 }
                 try {
                     const result = await db[buildInstance.tableName].findUnique(prismaArgs);
                     if(showWorking) {
                         const end = performance.now();
-                        console.log(`[VSRepository] (runtime) Executed has on ${buildInstance.tableName} (took: ${(end - start).toFixed(2)}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed has (took: ${(end - start).toFixed(2)}ms).`);
                     }
                     return !!result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when trying to has on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when trying to has:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
             }
@@ -1243,7 +1294,7 @@ export class VSRepository {
 
                 let start;
                 if(showWorking){
-                    console.log(`[VSRepository] (runtime) Executing patch on ${buildInstance.tableName}.`);
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executing patch.`);
                     start = performance.now();
                 }
 
@@ -1364,7 +1415,7 @@ export class VSRepository {
                     prismaArgs.where = where;
 
                     if(showWorking) {
-                        console.log(`[VSRepository] (runtime) Built arguments to patch on ${buildInstance.tableName}:\n`, JSON.stringify(prismaArgs, null, 2));
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Built arguments to patch:\n`, JSON.stringify(prismaArgs, null, 2));
                     }
 
                     result = await db[buildInstance.tableName].update(prismaArgs);
@@ -1372,12 +1423,12 @@ export class VSRepository {
                     if(showWorking) {
                         const end = performance.now();
                         const duration = (end - start).toFixed(2);
-                        console.log(`[VSRepository] (runtime) Executed patch on ${buildInstance.tableName} (took: ${duration}ms).`);
+                        console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Executed patch (took: ${duration}ms).`);
                     }
 
                     return result;
                 } catch (err) {
-                    console.log(`[VSRepository] (runtime) Fatal error when trying to patch on ${buildInstance.tableName}:\n`, JSON.stringify({ prismaArgs }, null, 2));
+                    console.log(`[VSRepository] (${buildInstance.tableName}: runtime) Fatal error when trying to patch:\n`, JSON.stringify({ prismaArgs }, null, 2));
                     throw err;
                 }
             } 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vsrepo",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "Uma biblioteca de repository pattern para Prisma",
   "homepage": "https://github.com/jaobrabo123/VSRepository#readme",
   "repository": {

package/scripts/configure-prisma-import.mjs

@@ -20,15 +20,16 @@ const GENERATED_HEADER = `/**
 
 `;
 
-const command = args[0]?.startsWith('-') ? 'generate' : args[0] ?? 'generate';
-const commandArgs = command === 'generate' && args[0] !== command ? args : args.slice(1);
+const command = args[0] || 'generate';
 
 if (command !== 'generate') {
   console.error(`Comando desconhecido: ${command}`);
-  console.error('Uso: vsrepo generate --output <dir-output> --prisma <path-prisma>');
+  console.error('Use: vsrepo generate --output <dir-output> --prisma <path-prisma>');
   process.exit(1);
 }
 
+const commandArgs = command === args[0] ? args.slice(1) : args;
+
 const outputFlagIndex = commandArgs.findIndex((arg) => arg === '--output' || arg === '-o');
 const prismaFlagIndex = commandArgs.findIndex((arg) => arg === '--prisma' || arg === '-p');
 
@@ -194,8 +195,8 @@ if (fs.existsSync(readmeSource)) {
 }
 
 console.log('\nVSRepository gerado com tipagem do Prisma.');
-console.log(`Output: ${outputDir}`);
-console.log(`Prisma usado em: ${prismaTargetPath}`);
+console.log(`Output: ${path.relative(workspaceRoot, outputDir)}`);
+console.log(`Prisma usado em: ${path.relative(workspaceRoot, prismaTargetPath)}`);
 
 function stripKnownExtension(inputPath) {
   return inputPath.replace(/\.(?:d\.ts|ts|js|mjs|cjs)$/i, '');