prisma-nestjs-graphql 23.1.0 → 23.2.0

package/README.md

@@ -153,24 +153,24 @@ Default: `''` (empty string)
 
 #### `combineScalarFilters`
 
-Combine nested/nullable scalar filters to single  
-Type: `boolean`  
+Combine nested/nullable scalar filters to single
+Type: `boolean`
 Default: `true`
 
 #### `noAtomicOperations`
 
-Remove input types for atomic operations  
-Type: `boolean`  
+Remove input types for atomic operations
+Type: `boolean`
 Default: `true`
 
 #### `reExport`
 
-Create `index.ts` file with re-export  
-Type: `enum`  
-Values:  
-`None` Default, create nothing  
-`Directories` Create index file in all root directories  
-`Single` Create single index file in output directory  
+Create `index.ts` file with re-export
+Type: `enum`
+Values:
+`None` Default, create nothing
+`Directories` Create index file in all root directories
+`Single` Create single index file in output directory
 `All` Create index file in all root directories and in output directory
 
 Example configuration:
@@ -185,60 +185,60 @@ generator nestgraphql {
 
 #### `emitSingle`
 
-Generate single file with merged classes and enums.  
-Type: `boolean`  
+Generate single file with merged classes and enums.
+Type: `boolean`
 Default: `false`
 
 #### `emitCompiled`
 
 Emit compiled JavaScript and definitions instead of TypeScript sources.
-Type: `boolean`  
+Type: `boolean`
 Default: `false`
 
 #### `emitBlocks`
 
-Emit only selected blocks. Be aware, that some blocks do depend on others, e.g. one can't emit `models` without emitting `enums`.  
-Type: `("args" | "inputs" | "outputs" | "models" | "enums")[]`  
+Emit only selected blocks. Be aware, that some blocks do depend on others, e.g. one can't emit `models` without emitting `enums`.
+Type: `("args" | "inputs" | "outputs" | "models" | "enums")[]`
 Default: `["args", "inputs", "outputs", "models", "enums"]`
 
 #### `omitModelsCount`
 
-Omit `_count` field from models.  
-Type: `boolean`  
+Omit `_count` field from models.
+Type: `boolean`
 Default: `false`
 
 #### `purgeOutput`
 
-Delete all files in `output` folder.  
-Type: `boolean`  
+Delete all files in `output` folder.
+Type: `boolean`
 Default: `false`
 
 #### `noTypeId`
 
-Disable usage of graphql `ID` type and use `Int/Float` for fields marked as `@id` in schema.  
-Type: `boolean`  
+Disable usage of graphql `ID` type and use `Int/Float` for fields marked as `@id` in schema.
+Type: `boolean`
 Default: `false`
 
 #### `typeListNullable`
 
 Adds `nullable: true` for relation list properties out output models,
 it makes graphql field looks like `[Type!]`, default `[Type!]!`
-Type: `boolean`  
+Type: `boolean`
 Default: `false`
 
 #### `requireSingleFieldsInWhereUniqueInput`
 
-When a model `*WhereUniqueInput` class has only a single field, mark that field as **required** (TypeScript) and **not nullable** (GraphQL).  
-See [#58](https://github.com/unlight/prisma-nestjs-graphql/issues/58) for more details.  
-Type: `boolean`  
-Default: `false`  
+When a model `*WhereUniqueInput` class has only a single field, mark that field as **required** (TypeScript) and **not nullable** (GraphQL).
+See [#58](https://github.com/unlight/prisma-nestjs-graphql/issues/58) for more details.
+Type: `boolean`
+Default: `false`
 **Note**: It will break compatiblity between Prisma types and generated classes.
 
 #### `unsafeCompatibleWhereUniqueInput`
 
 Set TypeScript property type as non optional for all fields in `*WhereUniqueInput` classes.
-See [#177](https://github.com/unlight/prisma-nestjs-graphql/issues/177) for more details.  
-Type: `boolean`  
+See [#177](https://github.com/unlight/prisma-nestjs-graphql/issues/177) for more details.
+Type: `boolean`
 Default: `false`
 
 #### `inputType`
@@ -481,7 +481,8 @@ It will affect all inputs and outputs types (including models).
 
 #### `customImports`
 
-Allow to declare custom import statements. (Only works with emitSingle = true)
+Allow to declare custom import statements.
+**Note**: Only works with `emitSingle = true`
 
 **New (config file)**:
 
@@ -512,6 +513,55 @@ Where `{key}` any identifier to group values (written in [flatten](https://githu
 - `customImport_{key}_namespaceImport` - use this name as import namespace
 - `customImport_{key}_namedImport` - named import (without namespace)
 
+#### `fieldDecoratorArguments`
+
+Override `@Field()` decorator arguments for specific fields. Use this to customize pagination fields (take, skip, cursor) or other generated Args fields that don't come from your Prisma schema.
+
+Each rule is evaluated against generated field metadata and applied when the `match` function returns `true`. Multiple matching rules are merged in order.
+
+**New (config file)**:
+
+```js
+fieldDecoratorArguments: [
+  {
+    match: ({ objectName, propertyName }) =>
+      objectName.endsWith('Args') && propertyName === 'take',
+    decoratorArguments: {
+      name: 'first',
+      defaultValue: 10,
+      description: 'Number of records to return',
+    },
+  },
+  {
+    match: ({ objectName, propertyName }) =>
+      objectName.endsWith('Args') && propertyName === 'skip',
+    decoratorArguments: {
+      name: 'offset',
+      defaultValue: 0,
+      description: 'Number of records to skip',
+    },
+  },
+]
+```
+
+**Available `decoratorArguments` options:**
+- `nullable` — Mark field as nullable in GraphQL schema
+- `defaultValue` — Default value for the field
+- `description` — Description shown in GraphQL schema
+- `deprecationReason` — Mark field as deprecated
+- `name` — Custom name for the field in GraphQL schema (TypeScript property name stays the same)
+- `complexity` — Complexity value for query cost analysis
+- `middleware` — Array of field middleware functions
+
+**Note:** When using the `name` option to override a field name in GraphQL, ensure you understand Prisma field mapping. For example, if you override the `take` field name to `first`, you must update any Prisma query logic that references the field by its original name. Consider using a mapping helper if doing this across multiple queries.
+
+The `match` function receives `FieldInfo` with:
+- `objectName` — Class name (e.g., 'FindManyUserArgs')
+- `propertyName` — Property name (e.g., 'take', 'skip')
+- `propertyType` — TypeScript property type
+- `typeName` — GraphQL/Prisma type name
+- `location` — Prisma field location ('scalar', 'inputObjectTypes', etc.)
+
 ## Documentation and field options
 
 Comments with triple slash will projected to typescript code comments
@@ -552,9 +602,9 @@ Special directives in triple slash comments for more precise code generation.
 
 #### @HideField()
 
-Removes field from GraphQL schema.  
-By default (without arguments) field will be decorated for hide only in output types (type in schema).  
-To hide field in input types add `input: true`.  
+Removes field from GraphQL schema.
+By default (without arguments) field will be decorated for hide only in output types (type in schema).
+To hide field in input types add `input: true`.
 To hide field in specific type you can use glob pattern `match: string | string[]`
 see [outmatch](https://github.com/axtgr/outmatch#usage) for details.
 
@@ -569,7 +619,7 @@ export default {
 };
 ```
 
-The callback receives `FieldInfo` (`location`, `objectName`, `propertyName`, `propertyType`, `typeName`).  
+The callback receives `FieldInfo` (`location`, `objectName`, `propertyName`, `propertyType`, `typeName`).
 When `shouldHideField` is defined, it overrides `@HideField(...)` settings from field comments and legacy `decorate` rules.
 
 Examples:
@@ -633,51 +683,51 @@ generator nestgraphql {
 }
 ```
 
-Create configuration map in [flatten](https://github.com/hughsk/flat) style for `{namespace}`.  
+Create configuration map in [flatten](https://github.com/hughsk/flat) style for `{namespace}`.
 Where `{namespace}` is a namespace used in field triple slash comment.
 
 ##### `fields_{namespace}_from`
 
-Required. Name of the module, which will be used in import (`class-validator`, `graphql-scalars`, etc.)  
+Required. Name of the module, which will be used in import (`class-validator`, `graphql-scalars`, etc.)
 Type: `string`
 
 ##### `fields_{namespace}_input`
 
-Means that it will be applied on input types (classes decorated by `InputType`)  
-Type: `boolean`  
+Means that it will be applied on input types (classes decorated by `InputType`)
+Type: `boolean`
 Default: `false`
 
 ##### `fields_{namespace}_output`
 
 Means that it will be applied on output types (classes decorated by `ObjectType`),
-including models  
-Type: `boolean`  
+including models
+Type: `boolean`
 Default: `false`
 
 ##### `fields_{namespace}_model`
 
-Means that it will be applied only on model types (classes decorated by `ObjectType`)  
-Type: `boolean`  
+Means that it will be applied only on model types (classes decorated by `ObjectType`)
+Type: `boolean`
 Default: `false`
 
 ##### `fields_{namespace}_defaultImport`
 
-Default import name, if module have no namespace.  
-Type: `undefined | string | true`  
-Default: `undefined`  
+Default import name, if module have no namespace.
+Type: `undefined | string | true`
+Default: `undefined`
 If defined as `true` then import name will be same as `{namespace}`
 
 ##### `fields_{namespace}_namespaceImport`
 
-Import all as this namespace from module  
-Type: `undefined | string`  
+Import all as this namespace from module
+Type: `undefined | string`
 Default: Equals to `{namespace}`
 
 ##### `fields_{namespace}_namedImport`
 
-If imported module has internal namespace, this allow to generate named import,  
-imported name will be equal to `{namespace}`, see [example of usage](#propertytype)  
-Type: `boolean`  
+If imported module has internal namespace, this allow to generate named import,
+imported name will be equal to `{namespace}`, see [example of usage](#propertytype)
+Type: `boolean`
 Default: `false`
 
 Custom decorators example:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prisma-nestjs-graphql",
   "type": "module",
-  "version": "23.1.0",
+  "version": "23.2.0",
   "license": "MIT",
   "description": "Generate object types, inputs, args, etc. from prisma schema file for usage with @nestjs/graphql module",
   "bin": "bin.mjs",
@@ -67,10 +67,10 @@
     "@eslint/compat": "^2.1.0",
     "@eslint/js": "^10.0.1",
     "@nestjs/apollo": "^13.4.0",
-    "@nestjs/common": "^11.1.19",
-    "@nestjs/core": "^11.1.19",
+    "@nestjs/common": "^11.1.21",
+    "@nestjs/core": "^11.1.21",
     "@nestjs/graphql": "^13.4.0",
-    "@nestjs/platform-express": "^11.1.19",
+    "@nestjs/platform-express": "^11.1.21",
     "@paljs/plugins": "^9.0.0",
     "@poppinss/ts-exec": "^1.4.4",
     "@prisma/adapter-pg": "^7.8.0",
@@ -82,7 +82,7 @@
     "@types/flat": "^5.0.5",
     "@types/graceful-fs": "^4.1.9",
     "@types/lodash": "^4.17.24",
-    "@types/node": "^25.6.2",
+    "@types/node": "^25.8.0",
     "@types/pluralize": "^0.0.33",
     "@types/serialize-javascript": "^5.0.4",
     "@vitest/coverage-v8": "^4.1.6",
@@ -124,7 +124,7 @@
     "tslib": "^2.8.1",
     "type-fest": "^5.6.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.2",
+    "typescript-eslint": "^8.59.3",
     "vitest": "^4.1.6"
   }
 }

package/prisma-nestjs-graphql.d.ts

@@ -72,6 +72,17 @@ declare class Configuration {
 		input?: boolean;
 	}): boolean;
 	getDecorators(): Generator<DecoratorItem>;
+	/**
+	 * Get field override arguments for a specific field.
+	 * Returns merged fieldArguments from all matching overrides.
+	 */
+	getFieldOverride(args: {
+		objectName: string;
+		propertyName: string;
+		propertyType: string;
+		location: FieldLocation;
+		typeName: string;
+	}): Record<string, unknown> | undefined;
 	/**
 	 * @deprecated Should be replaced by decorators
 	 */
@@ -258,13 +269,87 @@ export type DecoratorItem = {
 	/** Decorator name. Can include namespace, e.g. `Transform.Type`. */
 	name: string;
 	/** Import as a named export. */
-	namedImport: boolean;
+	namedImport?: boolean;
 	/** Import as default export.
 	 * Use `true` to import by decorator name. */
 	defaultImport?: string | true;
 	/** Import entire module under this namespace. */
 	namespaceImport?: string;
 };
+/**
+ * Arguments passed to the `@Field()` decorator.
+ * Follows NestJS GraphQL's FieldOptions structure to avoid conflicts.
+ * These are merged into the generated `@Field()` options object.
+ *
+ * @see https://docs.nestjs.com/graphql/resolvers-map#field-decorator
+ */
+export type FieldDecoratorArguments = {
+	/**
+	 * Custom name for the field in GraphQL schema (different from TypeScript property name).
+	 *
+	 * **Important:** When you rename a field (e.g., 'take' → 'first'), you must map the GraphQL
+	 * argument names back to Prisma field names in your resolver, since Prisma expects the
+	 * original field names.
+	 *
+	 * @example
+	 * // Option 1: Manual mapping in resolver
+	 * async findMany(args: FindManyArgs): Promise<Item[]> {
+	 *   const { first, ...restArgs } = args as any;
+	 *   return this.prisma.item.findMany({
+	 *     ...restArgs,
+	 *     ...(first !== undefined && { take: first }),
+	 *   });
+	 * }
+	 *
+	 * @example
+	 * // Option 2: Use a helper function
+	 * export function mapGraphQLArgsToPrisma(args: any): any {
+	 *   const { first, ...restArgs } = args;
+	 *   return {
+	 *     ...restArgs,
+	 *     ...(first !== undefined && { take: first }),
+	 *   };
+	 * }
+	 *
+	 * async findMany(args: FindManyArgs): Promise<Item[]> {
+	 *   const prismaArgs = mapGraphQLArgsToPrisma(args);
+	 *   return this.prisma.item.findMany(prismaArgs);
+	 * }
+	 * export function mapGraphQLArgsToPrisma(args: any): any {
+	 *   const { first, ...restArgs } = args;
+	 *   return {
+	 *     ...restArgs,
+	 *     ...(first !== undefined && { take: first }),
+	 *   };
+	 * }
+	 */
+	name?: string;
+	/** Description shown in GraphQL schema. */
+	description?: string;
+	/** Mark field as deprecated with optional reason. */
+	deprecationReason?: string;
+	/** Complexity for query complexity analysis. */
+	complexity?: unknown;
+	/** Array of middleware to apply to the field. */
+	middleware?: unknown[];
+	/** Mark field as nullable in GraphQL schema. */
+	nullable?: boolean;
+	/** Default value for the field. */
+	defaultValue?: unknown;
+};
+/**
+ * Rule for overriding `@Field()` decorator arguments on generated fields.
+ * Use this to customize pagination fields (take, skip) or other generated Args fields.
+ */
+export type FieldDecoratorRule = {
+	/** Return `true` to apply this override to the current field. */
+	match: (args: FieldInfo) => boolean;
+	/**
+	 * Arguments to merge into the `@Field()` decorator options.
+	 * These are merged with existing arguments (nullable, etc.).
+	 */
+	decoratorArguments: FieldDecoratorArguments;
+};
 export type ExternalConfig = Partial<{
 	/**
 	 * Output folder for generated files.
@@ -445,6 +530,28 @@ export type ExternalConfig = Partial<{
 	 * Prefer this over legacy `decorate`/`decorate_*` schema configuration.
 	 */
 	decorators: DecoratorItem[];
+	/**
+	 * Override `@Field()` decorator arguments for specific fields.
+	 * Use this to customize pagination fields (take, skip, cursor) or other
+	 * generated Args fields that don't come from your Prisma schema.
+	 *
+	 * Each rule is evaluated against generated field metadata (`FieldInfo`) and
+	 * applied when `match` returns `true`.
+	 *
+	 * @example
+	 * fieldDecoratorArguments: [
+	 *   {
+	 *     match: ({ objectName, propertyName }) =>
+	 *       objectName.endsWith('Args') && propertyName === 'take',
+	 *     decoratorArguments: {
+	 *       name: 'first',
+	 *       defaultValue: 10,
+	 *       description: 'Number of records to return',
+	 *     },
+	 *   },
+	 * ]
+	 */
+	fieldDecoratorArguments: FieldDecoratorRule[];
 }>;
 export declare function generate(args: GeneratorOptions & {
 	skipAddOutputSourceFiles?: boolean;

package/prisma-nestjs-graphql.mjs

@@ -633,6 +633,25 @@ class Configuration {
     }
   }
 
+  /**
+   * Get field override arguments for a specific field.
+   * Returns merged fieldArguments from all matching overrides.
+   */
+  getFieldOverride(args) {
+    const overrides = this.externalConfig?.fieldDecoratorArguments;
+    if (!overrides?.length) return;
+    let result;
+    for (const override of overrides) {
+      if (override.match(args)) {
+        result = {
+          ...result,
+          ...override.decoratorArguments
+        };
+      }
+    }
+    return result;
+  }
+
   /**
    * @deprecated Should be replaced by decorators
    */
@@ -644,6 +663,9 @@ class Configuration {
   }
 }
 
+function isWhereUniqueInputType(name) {
+  return name.endsWith('WhereUniqueInput');
+}
 function isManyAndReturnOutputType(name) {
   const lowerName = name.toLowerCase();
   if ((lowerName.startsWith('createmany') || lowerName.startsWith('updatemany')) && (lowerName.endsWith('andreturnoutputtype') || lowerName.endsWith('andreturn'))) {
@@ -1312,10 +1334,6 @@ function createFieldName(args) {
   return name || fields.join('_');
 }
 
-function isWhereUniqueInputType(name) {
-  return name.endsWith('WhereUniqueInput');
-}
-
 /**
  * Get property structure (field) for class.
  */
@@ -1492,7 +1510,7 @@ function inputType(args) {
       graphqlType = graphqlImport.name;
       let referenceName = propertyType[0];
       if (location === 'enumTypes') {
-        referenceName = last(referenceName.split(' '));
+        referenceName = last(referenceName.split(' ')) ?? 'any';
       }
       if (graphqlImport.specifier && !importDeclarations.has(graphqlImport.name) && graphqlImport.name !== inputType.name
       // ((graphqlImport.name !== inputType.name && !shouldHideField) ||
@@ -1514,11 +1532,15 @@ function inputType(args) {
         name: 'HideField'
       });
     } else {
+      // Get field overrides from config
+      const fieldOverride = config.getFieldOverride(fieldInfo);
+
       // Generate `@Field()` decorator
       property.decorators.push({
         arguments: [isList ? `() => [${graphqlType}]` : `() => ${graphqlType}`, JSON5.stringify({
           ...settings?.fieldArguments(),
-          nullable: !isRequired
+          nullable: !isRequired,
+          ...fieldOverride
         })],
         name: 'Field'
       });
@@ -2053,6 +2075,7 @@ function modelOutputType(outputType, args) {
       property.decorators.push(generateFieldDecorator({
         config,
         field,
+        fieldInfo,
         graphqlType,
         modelField,
         settings
@@ -2121,6 +2144,7 @@ function generateFieldDecorator(args) {
   const {
     config,
     field,
+    fieldInfo,
     graphqlType,
     modelField,
     settings
@@ -2143,11 +2167,15 @@ function generateFieldDecorator(args) {
     return Boolean(isNullable);
   };
   const defaultValue = ['number', 'string', 'boolean'].includes(typeof modelField?.default) ? modelField?.default : undefined;
+
+  // Get field overrides from config
+  const fieldOverride = config.getFieldOverride(fieldInfo);
   const secondArgumentOptions = JSON5.stringify({
     ...settings?.fieldArguments(),
     defaultValue,
     description: modelField?.documentation,
-    nullable: getNullable()
+    nullable: getNullable(),
+    ...fieldOverride
   });
   return {
     arguments: [firstArgumentType, secondArgumentOptions],
@@ -2337,11 +2365,15 @@ function outputType(outputType, args) {
         name: 'HideField'
       });
     } else {
+      // Get field overrides from config
+      const fieldOverride = config.getFieldOverride(fieldInfo);
+
       // Generate `@Field()` decorator
       property.decorators.push({
         arguments: [isList ? `() => [${graphqlType}]` : `() => ${graphqlType}`, JSON5.stringify({
           ...settings?.fieldArguments(),
-          nullable: Boolean(field.isNullable)
+          nullable: Boolean(field.isNullable),
+          ...fieldOverride
         })],
         name: 'Field'
       });