المحلِّلات محددة الأنواع باستخدام GraphQL Code Generator

مشكلة كتابة أنواع المحللات

// Without typed resolvers — any type allowed
const userResolver = async (_, { id }) => fetchUser(id);

إضافة مكوّن المحللات

npm install --save-dev @graphql-codegen/typescript-resolvers

codegen.yml للمحللات

# codegen.yml
generates:
  src/generated/types.ts:
    plugins:
      - typescript
  src/generated/resolvers.ts:
    plugins:
      - typescript-resolvers

استخدام ResolverMap المُنشأ

import { Resolvers } from "./generated/resolvers";

const resolvers: Resolvers = {
  Query: {
    user: async (_, { id }) => fetchUser(id),
    // Return type enforced: must match User schema
  },
};

كتابة نوع السياق

interface Context { db: Database; user?: AuthUser; }

// codegen.yml
config:
  contextType: "src/context#Context"

// Generated: Resolvers<Context>
const resolvers: Resolvers<Context> = {
  Query: {
    me: (_, __, ctx) => ctx.user, // ctx: Context
  },
};

أنواع التعيين

# codegen.yml
config:
  mappers:
    User: "src/models#UserModel"

كتابة أنواع محللات الحقول

// Typed field resolver on User type
const resolvers: Resolvers<Context> = {
  User: {
    fullName: (parent) => `${parent.firstName} ${parent.lastName}`,
    // parent is UserModel (from mapper)
  },
};

الطفرات الموصوفة بالأنواع

// Schema: createUser(input: CreateUserInput!): User!
const resolvers: Resolvers = {
  Mutation: {
    createUser: (_, { input }) => {
      // input: CreateUserInput — fully typed
      return createUser(input.name, input.email);
    },
  },
};

الاشتراكات الموصوفة بالأنواع

const resolvers: Resolvers = {
  Subscription: {
    messageAdded: {
      subscribe: () => pubsub.asyncIterator("MESSAGE_ADDED"),
      resolve: (payload) => payload.messageAdded, // typed
    },
  },
};

الحفاظ على تزامن Codegen

// package.json
{
  "scripts": {
    "predev": "graphql-codegen",
    "prebuild": "graphql-codegen"
  }
}

مراجعة: المحللات الموصوفة بالأنواع

تحقّق سريع

ما تعلّمتموه