refactor: rename defineType to defineField across documentation and examples

productdevbook · productdevbook · commit 263626c1f2b3 · 2025-11-20T14:46:41.000+03:00
diff --git a/.docs/api/README.md b/.docs/api/README.md
@@ -40,7 +40,7 @@ Complete reference for resolver definition utilities:
 - **defineQuery()** - Define query-only resolvers
 - **defineMutation()** - Define mutation-only resolvers
 - **defineSubscription()** - Define subscription-only resolvers
-- **defineType()** - Define custom type field resolvers
+- **defineField()** - Define custom type field resolvers
 - **defineDirective()** - Define custom GraphQL directives
 - **defineGraphQLConfig()** - Define GraphQL server configuration
 - **defineSchema()** - Define schema with validation (Standard Schema)
diff --git a/.docs/api/apollo-utilities.md b/.docs/api/apollo-utilities.md
@@ -366,7 +366,7 @@ interface ReferenceResolver<TContext> {
 ```typescript
 import type { UserResolvers } from '#graphql/server'
 
-export const userResolvers: UserResolvers = defineType({
+export const userResolvers: UserResolvers = defineField({
   User: {
     __resolveReference: async (reference, context) => {
       // reference contains fields marked with @key
@@ -583,7 +583,7 @@ const server = new ApolloServer({
 Always implement `__resolveReference` for federated types:
 
 ```typescript
-export const userResolvers = defineType({
+export const userResolvers = defineField({
   User: {
     __resolveReference: async (reference, context) => {
       // Resolve entity from its key fields
@@ -598,7 +598,7 @@ export const userResolvers = defineType({
 When referencing types from other subgraphs, return a reference object:
 
 ```typescript
-export const postResolvers = defineType({
+export const postResolvers = defineField({
   Post: {
     author: (post) => {
       // Don't resolve the entire user, return a reference
diff --git a/.docs/api/resolver-functions.md b/.docs/api/resolver-functions.md
@@ -328,14 +328,14 @@ export const channelSubscriptions = defineSubscription({
 
 ---
 
-## defineType()
+## defineField()
 
 Define custom type resolvers (field resolvers for GraphQL types).
 
 ### Signature
 
 ```typescript
-function defineType(resolvers: Resolvers): Resolvers
+function defineField(resolvers: Resolvers): Resolvers
 ```
 
 ### Parameters
@@ -351,7 +351,7 @@ Returns the same `Resolvers` object with full type safety.
 #### Basic Type Resolver
 
 ```typescript
-export const userTypeResolvers = defineType({
+export const userTypeResolvers = defineField({
   User: {
     fullName: (parent) => {
       return `${parent.firstName} ${parent.lastName}`
@@ -371,7 +371,7 @@ export const userTypeResolvers = defineType({
 #### Relationship Resolvers
 
 ```typescript
-export const postTypeResolvers = defineType({
+export const postTypeResolvers = defineField({
   Post: {
     author: async (parent, _args, context) => {
       return await context.db.users.findById(parent.authorId)
@@ -397,7 +397,7 @@ export const postTypeResolvers = defineType({
 #### Computed Fields
 
 ```typescript
-export const productTypeResolvers = defineType({
+export const productTypeResolvers = defineField({
   Product: {
     finalPrice: (parent) => {
       if (parent.discount) {
diff --git a/.docs/api/type-definitions.md b/.docs/api/type-definitions.md
@@ -174,7 +174,7 @@ For each GraphQL type in your schema, a specific resolver type is generated:
 ```typescript
 import type { PostResolvers, UserResolvers } from '#graphql/server'
 
-export const userTypeResolvers: UserResolvers = defineType({
+export const userTypeResolvers: UserResolvers = defineField({
   User: {
     fullName: parent => `${parent.firstName} ${parent.lastName}`,
     posts: async (parent, _args, context) => {
@@ -183,7 +183,7 @@ export const userTypeResolvers: UserResolvers = defineType({
   }
 })
 
-export const postTypeResolvers: PostResolvers = defineType({
+export const postTypeResolvers: PostResolvers = defineField({
   Post: {
     author: async (parent, _args, context) => {
       return await context.db.users.findById(parent.authorId)
diff --git a/.docs/api/virtual-imports.md b/.docs/api/virtual-imports.md
@@ -111,7 +111,7 @@ export const mutations: MutationResolvers = defineMutation({
 ```typescript
 import type { PostResolvers, UserResolvers } from '#graphql/server'
 
-export const userTypes: UserResolvers = defineType({
+export const userTypes: UserResolvers = defineField({
   User: {
     fullName: parent => `${parent.firstName} ${parent.lastName}`,
     posts: async (parent, _args, context) => {
diff --git a/.docs/contributing/architecture.md b/.docs/contributing/architecture.md
@@ -199,7 +199,7 @@ export function defineQuery(query: QueryResolvers): Resolvers
 export function defineMutation(mutation: MutationResolvers): Resolvers
 
 // Define custom type resolvers
-export function defineType<T>(type: T): T
+export function defineField<T>(type: T): T
 
 // Define custom directives
 export function defineDirective(directive: DirectiveConfig): DirectiveConfig
diff --git a/.docs/ecosystem/nuxt-integration.md b/.docs/ecosystem/nuxt-integration.md
@@ -76,7 +76,7 @@ Auto-imported utilities include:
 - `defineQuery`
 - `defineMutation`
 - `defineSubscription`
-- `defineType`
+- `defineField`
 - `defineGraphQLConfig`
 - `defineSchema`
 - `defineDirective`
diff --git a/.docs/guide/auto-discovery.md b/.docs/guide/auto-discovery.md
@@ -256,7 +256,7 @@ The scanner looks for named exports using these functions:
 - `defineResolver`
 - `defineQuery`
 - `defineMutation`
-- `defineType`
+- `defineField`
 - `defineSubscription`
 - `defineDirective`
 
diff --git a/.docs/guide/performance.md b/.docs/guide/performance.md
@@ -15,7 +15,7 @@ Optimization tips for GraphQL resolvers, caching strategies, and batching.
 
 ```ts
 // Bad: N+1 queries
-export const postTypes = defineType({
+export const postTypes = defineField({
   Post: {
     author: async (parent, args, context) => {
       // This runs once per post!
@@ -39,7 +39,7 @@ const userLoader = new DataLoader(async (ids: readonly string[]) => {
   return ids.map(id => users.find(u => u.id === id))
 })
 
-export const postTypes = defineType({
+export const postTypes = defineField({
   Post: {
     author: parent => userLoader.load(parent.authorId),
   },
diff --git a/.docs/guide/resolvers.md b/.docs/guide/resolvers.md
@@ -7,7 +7,7 @@ category: Guide
 
 <FunctionInfo fn="resolvers"/>
 
-Master GraphQL resolvers with `defineResolver`, `defineQuery`, `defineMutation`, `defineType`, and `defineSubscription`.
+Master GraphQL resolvers with `defineResolver`, `defineQuery`, `defineMutation`, `defineField`, and `defineSubscription`.
 
 ## What are Resolvers?
 
@@ -93,13 +93,13 @@ export const userMutations = defineMutation({
 })
 ```
 
-### defineType
+### defineField
 
 Define field resolvers for custom types:
 
 ```ts
 // server/graphql/users/types.resolver.ts
-export const userTypes = defineType({
+export const userTypes = defineField({
   User: {
     // Resolve the posts field
     posts: async (parent, args, context) => {
@@ -176,7 +176,7 @@ export const userQueries = defineQuery({
   }),
 })
 
-export const userTypes = defineType({
+export const userTypes = defineField({
   User: {
     posts: (parent) => {
       // parent is the User object from the query resolver
@@ -303,7 +303,7 @@ type Post {
 ```
 
 ```ts
-export const postTypes = defineType({
+export const postTypes = defineField({
   Post: {
     // Resolve author relationship
     author: async (parent, args, context) => {
@@ -341,7 +341,7 @@ const userLoader = new DataLoader(async (userIds: readonly string[]) => {
   return userIds.map(id => users.find(u => u.id === id))
 })
 
-export const postTypes = defineType({
+export const postTypes = defineField({
   Post: {
     // Use DataLoader - batches and caches requests
     author: async (parent) => {
@@ -443,7 +443,7 @@ export const userMutations = defineMutation({
 
 ```ts
 // server/graphql/users/types.resolver.ts
-export const userTypes = defineType({
+export const userTypes = defineField({
   User: {
     posts: () => [...],
   },
@@ -657,7 +657,7 @@ export const postMutations = defineMutation({
   },
 })
 
-export const postTypes = defineType({
+export const postTypes = defineField({
   Post: {
     author: async (parent, args, context) => {
       return await context.db.user.findUnique({
diff --git a/.docs/guide/schemas.md b/.docs/guide/schemas.md
@@ -314,7 +314,7 @@ type Query {
 Resolver:
 
 ```ts
-import { defineQuery, defineType } from 'nitro-graphql/define'
+import { defineQuery, defineField } from 'nitro-graphql/define'
 
 export const nodeResolver = defineQuery({
   node: (_, { id }) => {
@@ -323,7 +323,7 @@ export const nodeResolver = defineQuery({
   },
 })
 
-export const nodeTypes = defineType({
+export const nodeTypes = defineField({
   Node: {
     __resolveType(obj) {
       if ('email' in obj)
@@ -351,9 +351,9 @@ type Query {
 Resolver:
 
 ```ts
-import { defineType } from 'nitro-graphql/define'
+import { defineField } from 'nitro-graphql/define'
 
-export const searchTypes = defineType({
+export const searchTypes = defineField({
   SearchResult: {
     __resolveType(obj) {
       if ('email' in obj)
diff --git a/.docs/guide/type-generation.md b/.docs/guide/type-generation.md
@@ -492,10 +492,10 @@ export const userQueries = defineQuery({
 For field resolvers, use partial parent types:
 
 ```ts
-import { defineType } from 'nitro-graphql/utils'
+import { defineField } from 'nitro-graphql/utils'
 import type { Post, User } from '#graphql/server'
 
-export const postTypes = defineType({
+export const postTypes = defineField({
   Post: {
     author: async (parent: Pick<Post, 'authorId'>) => {
       // parent only needs authorId field
diff --git a/.docs/guide/your-first-query.md b/.docs/guide/your-first-query.md
@@ -429,9 +429,9 @@ type User {
 ```
 
 ```ts
-import { defineType } from 'nitro-graphql/define'
+import { defineField } from 'nitro-graphql/define'
 
-export const postTypes = defineType({
+export const postTypes = defineField({
   Post: {
     // Resolve the author field
     author: async (parent, args, context) => {
@@ -487,9 +487,9 @@ export const postMutations = defineMutation({
 
 ```ts
 // server/graphql/posts/types.resolver.ts
-import { defineType } from 'nitro-graphql/define'
+import { defineField } from 'nitro-graphql/define'
 
-export const postTypes = defineType({
+export const postTypes = defineField({
   Post: {
     author: () => {...},
   },
diff --git a/.docs/troubleshooting/performance-issues.md b/.docs/troubleshooting/performance-issues.md
@@ -31,7 +31,7 @@ Troubleshooting and optimizing GraphQL performance in Nitro GraphQL.
 The N+1 problem occurs when fetching related data:
 ```typescript
 // ❌ N+1 Problem - Queries database for each user
-export const postResolvers = defineType('Post', {
+export const postResolvers = defineField('Post', {
   author: async (parent) => {
     // This runs once per post!
     return await db.user.findUnique({ where: { id: parent.authorId } })
@@ -88,7 +88,7 @@ export default defineGraphQLConfig({
 
 ```typescript
 // ✅ Optimized - Batches database queries
-export const postResolvers = defineType('Post', {
+export const postResolvers = defineField('Post', {
   author: async (parent, _, context) => {
     return await context.loaders.user.load(parent.authorId)
   }
@@ -406,7 +406,7 @@ pnpm build
 4. **Optimize Dependencies:**
 ```typescript
 // Instead of:
-import { defineMutation, defineQuery, defineType } from 'nitro-graphql'
+import { defineMutation, defineQuery, defineField } from 'nitro-graphql'
 // Only import what you need
 import { defineQuery } from 'nitro-graphql/define'
 ```
diff --git a/.docs/troubleshooting/type-generation-issues.md b/.docs/troubleshooting/type-generation-issues.md
@@ -666,7 +666,7 @@ export default defineGraphQLConfig({
 
 4. **Verify Entity Resolvers:**
 ```typescript
-export const userResolvers = defineType('User', {
+export const userResolvers = defineField('User', {
   __resolveReference: async (reference) => {
     return await db.user.findUnique({ where: { id: reference.id } })
   }
diff --git a/README.md b/README.md
@@ -620,15 +620,15 @@ export default defineNitroConfig({
 > **⚠️ Breaking Change**: Utilities are **NOT auto-imported**. You must explicitly import them from `nitro-graphql/define`:
 
 ```typescript
-import { defineResolver, defineQuery, defineMutation, defineType, defineDirective } from 'nitro-graphql/define'
+import { defineResolver, defineQuery, defineMutation, defineField, defineDirective } from 'nitro-graphql/define'
 ```
 
 | Function | Purpose | Example |
 |----------|---------|---------|
 | `defineResolver` | Complete resolvers | `defineResolver({ Query: {...}, Mutation: {...} })` |
 | `defineQuery` | Query-only resolvers | `defineQuery({ users: () => [...] })` |
 | `defineMutation` | Mutation-only resolvers | `defineMutation({ createUser: (...) => {...} })` |
-| `defineType` | Custom type resolvers | `defineType({ User: { posts: (parent) => [...] } })` |
+| `defineField` | Custom type resolvers | `defineField({ User: { posts: (parent) => [...] } })` |
 | `defineDirective` | Custom directives | `defineDirective({ name: 'auth', ... })` |
 | `defineGraphQLConfig` | GraphQL server config | `defineGraphQLConfig({ maskedErrors: {...} })` |
 | `defineSchema` | Schema with Zod integration | `defineSchema({ Book: selectBookSchema })` |
@@ -777,7 +777,7 @@ This error occurs when the resolver scanner can't find the expected export in yo
   - `defineResolver` - Complete resolver with Query, Mutation, etc.
   - `defineQuery` - Query-only resolvers
   - `defineMutation` - Mutation-only resolvers
-  - `defineType` - Custom type resolvers
+  - `defineField` - Custom type resolvers
   - `defineSubscription` - Subscription resolvers
   - `defineDirective` - Directive resolvers
 - Only exports using these functions are included in the virtual module
diff --git a/examples/better-auth/server/graphql/books/field.resolver.ts b/examples/better-auth/server/graphql/books/field.resolver.ts
@@ -1,8 +1,8 @@
 import { eq } from 'drizzle-orm'
-import { defineType } from 'nitro-graphql/define'
+import { defineField } from 'nitro-graphql/define'
 import { HTTPError } from 'nitro/h3'
 
-export const field = defineType({
+export const field = defineField({
   Book: {
     isAvailable: (parent, args, { context }) => {
       // A book is considered available if it was published within the last 5 years
diff --git a/examples/drizzle-orm/README.md b/examples/drizzle-orm/README.md
@@ -190,14 +190,14 @@ export const createBook = defineMutation({
 
 ```typescript
 // REQUIRED in all resolver files
-import { defineMutation, defineQuery, defineType } from 'nitro-graphql/define'
+import { defineMutation, defineQuery, defineField } from 'nitro-graphql/define'
 ```
 
 **Available utilities**:
 - `defineResolver` - Complete resolver (Query + Mutation + Type)
 - `defineQuery` - Query-only resolvers
 - `defineMutation` - Mutation-only resolvers
-- `defineType` - Custom type resolvers (computed fields)
+- `defineField` - Custom type resolvers (computed fields)
 - `defineDirective` - Custom GraphQL directives
 - `defineGraphQLConfig` - GraphQL Yoga configuration
 - `defineSchema` - Schema definition with Zod integration
@@ -275,9 +275,9 @@ type Book {
 
 **Resolver** (`server/graphql/books/field.resolver.ts`)
 ```typescript
-import { defineType } from 'nitro-graphql/define'
+import { defineField } from 'nitro-graphql/define'
 
-export const field = defineType({
+export const field = defineField({
   Book: {
     isAvailable: (parent, args, { context }) => {
       // A book is considered available if it was published within the last 5 years
diff --git a/examples/drizzle-orm/server/graphql/books/field.resolver.ts b/examples/drizzle-orm/server/graphql/books/field.resolver.ts
diff --git a/playgrounds/federation/server/graphql/users.resolver.ts b/playgrounds/federation/server/graphql/users.resolver.ts
diff --git a/src/define.ts b/src/define.ts
diff --git a/src/setup.ts b/src/setup.ts
diff --git a/src/utils/index.ts b/src/utils/index.ts
