resolver

Overview

resolver is analogous to resolvers option passed to LocalState.

Usage

Let's modify bookState to to return displayName for each Book which is a concatenation of the book name and genre.

library/states/book.state.ts

import { state } from '@apollo-orbit/react';
import { gql } from '@apollo/client';
import { Book } from '../../graphql';

export const bookState = state(descriptor => descriptor
  .typeDefs(gql`
    extend type Book {
      displayName: String!
    }
  `)
  .resolver(['Book', 'displayName'], (rootValue: Book, args, context, info): Book['displayName'] => {
    const { name, genre } = rootValue;
    return typeof genre === 'string' ? `${name} (${genre})` : name;
  })
);

Since *.state.ts files are included in our codegen configuration, defining local schema using typeDefs will get automatically picked up by codegen.

Next, we update book.graphql to include displayName field:

library/gql/book.graphql

fragment BookFragment on Book {
  id
  name
  genre
  authorId
  displayName @client
}

...

Now, displayName can be used in the component to display the book name along with genre.

API

resolver function can return a value, promise or observable.