{"id":26921160,"url":"https://github.com/olyop/graphql-create-resolver","last_synced_at":"2025-04-01T22:53:44.905Z","repository":{"id":57133053,"uuid":"440337977","full_name":"olyop/graphql-create-resolver","owner":"olyop","description":null,"archived":false,"fork":false,"pushed_at":"2022-12-25T11:46:35.000Z","size":29,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T04:41:31.221Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/olyop.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-20T23:54:45.000Z","updated_at":"2022-01-30T08:08:30.000Z","dependencies_parsed_at":"2023-01-30T22:01:16.987Z","dependency_job_id":null,"html_url":"https://github.com/olyop/graphql-create-resolver","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olyop%2Fgraphql-create-resolver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olyop%2Fgraphql-create-resolver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olyop%2Fgraphql-create-resolver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olyop%2Fgraphql-create-resolver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/olyop","download_url":"https://codeload.github.com/olyop/graphql-create-resolver/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246724793,"owners_count":20823544,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-01T22:53:44.348Z","updated_at":"2025-04-01T22:53:44.897Z","avatar_url":"https://github.com/olyop.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# graphql-create-resolver\n\nA simple utility that assists you in creating your GraphQL resolver functions.\n\nCan be used in any [GraphQL.js](https://graphql.org/graphql-js/) server integration.\n\n### Features\n\n- If you use TypeScript, it allows you to type the four resolver function arguments `(parent, args, context, info)` easily with Generics and only once!\n- Allows you to check the context in every resolvers using the `checkContext` function. This can be useful if you want to check the authentication/authorization for all resolvers.\n\n## Installation\n\n```bash\nnpm i @oly_op/graphql-create-resolver\n```\n\n## TypeScript Support\n\nThis package contains built-in TypeScript definitions.\n\n## Getting Started\n\nYou first have to create a root create resolver function:\n\n```typescript\nimport { createRootResolver } from \"@oly_op/graphql-create-resolver\";\n\nconst createResolver = createRootResolver();\n```\n\nThen for each root resolver field you have to create a new createResolver function.\nHere is the where you could parse in the parent type to the resolver.\n\nFor example for the Query field:\n\n```typescript\nconst queryResolver = createResolver();\n\nconst helloWorldQueryResolver = resolver(({ parent, context, args, info }) =\u003e \"Hello World!\");\n```\n\n`helloWorldQueryResolver` is a function with the standard resolver signature `(parent, context, args, info) =\u003e any` ready to be parsed into in any GraphQL framework.\n\n## Usage with TypeScript\n\n```typescript\nimport { GraphQLResolveInfo } from \"graphql\";\n\ntype CreateResolverCheckContextFunction\u003cC\u003e = (context: C) =\u003e void;\n\ninterface CreateResolverParameter\u003cP, A, C\u003e {\n\targs: A;\n\tparent: P;\n\tcontext: C;\n\tinfo: GraphQLResolveInfo;\n}\n\ntype CreateResolverCallback\u003cP, A, C, R\u003e = (\n\tprops: CreateResolverParameter\u003cP, A, C\u003e,\n) =\u003e R | Promise\u003cR\u003e;\n\ntype creteRootResolver = \u003cC = undefined\u003e(\n\tcheckContextFunction?: CreateResolverCheckContextFunction\u003cC\u003e,\n) =\u003e \u003cP = undefined\u003e() =\u003e \u003cR, A = undefined\u003e(\n\tcallback: CreateResolverCallback\u003cP, A, C, R\u003e,\n\tcheckContext?: boolean,\n) =\u003e (parent: P, args: A, context: C, info: GraphQLResolveInfo) =\u003e R | Promise\u003cR\u003e;\n```\n\n## Examples\n\n### Apollo Server Fastify:\n\n```typescript\nimport { ApolloServer } from \"apollo-server-fastify\";\n\nconst apollo = new ApolloServer({\n\tcontext,\n\ttypeDefs,\n\tresolvers: {\n\t\tQuery: {\n\t\t\thelloWorld: helloWorldQueryResolver,\n\t\t},\n\t},\n});\n```\n\n### Example with Context and Args typings:\n\n```typescript\nimport { createRootResolver } from \"@oly_op/graphql-create-resolver\";\n\ninterface Context {\n\tdatabase: SomeDataBaseClient;\n}\n\nconst createResolver = createRootResolver\u003cContext\u003e();\n\nconst queryResolver = createResolver();\n\ninterface Args {\n\tgreetingWord: string;\n}\n\nconst greetingQueryResolver = resolver\u003cstring, Args\u003e(async ({ parent, context, args, info }) =\u003e {\n\tconst { database } = context;\n\tconst { greetingWord } = args;\n\tconst userName = await database.getUser();\n\treturn `${greetingWord} ${userName}`;\n});\n\nconst resolvers = {\n\tQuery: {\n\t\tgreeting: greetingQueryResolver,\n\t},\n};\n```\n\n### Example with Context and Parent typings:\n\n```typescript\nimport { createRootResolver } from \"@oly_op/graphql-create-resolver\";\nimport { AuthenticationError } from \"apollo-server-fastify\";\n\ninterface Context {\n\tauthorization?: string;\n\tdatabase: SomeDataBaseClient;\n}\n\nconst createResolver = createRootResolver\u003cContext\u003e(({ authorization }) =\u003e {\n\tif (authorization === undefined) {\n\t\tthrow new AuthenticationError(\"Token error\");\n\t}\n});\n\ninterface User {\n\tname: string;\n\tuserID: string;\n}\n\nconst userResolver = createResolver\u003cUser\u003e();\n\ninterface Args {\n\tshowPrivatePlaylists: string;\n}\n\nconst userPlaylistsResolver = resolver\u003cPlaylist[], Args\u003e(({ parent, context, args, info }) =\u003e {\n\tconst { userID } = parent;\n\tconst { database } = context;\n\tconst { showPrivatePlaylists } = args;\n\treturn database.getUserPlaylists(userID, { showPrivatePlaylists });\n});\n\nconst resolvers = {\n\tUser: {\n\t\tuserPlaylists: userPlaylistsResolver,\n\t},\n};\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folyop%2Fgraphql-create-resolver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Folyop%2Fgraphql-create-resolver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folyop%2Fgraphql-create-resolver/lists"}