graphbrainz/src/types/artist.js

import { GraphQLObjectType, GraphQLString, GraphQLList } from 'graphql/type'
import Node from './node'
import Entity from './entity'
import Area from './area'
import { IPI, ISNI } from './scalars'
import {
  resolveWithFallback,
  fieldWithID,
  id,
  mbid,
  name,
  sortName,
  disambiguation,
  aliases,
  lifeSpan,
  recordings,
  releases,
  releaseGroups,
  works,
  relationships,
  collections,
  tags,
  connectionWithExtras
} from './helpers'

const Artist = new GraphQLObjectType({
  name: 'Artist',
  description: `An [artist](https://musicbrainz.org/doc/Artist) is generally a
musician, group of musicians, or other music professional (like a producer or
engineer). Occasionally, it can also be a non-musical person (like a
photographer, an illustrator, or a poet whose writings are set to music), or
even a fictional character.`,
  interfaces: () => [Node, Entity],
  fields: () => ({
    id,
    mbid,
    name,
    sortName,
    disambiguation,
    aliases,
    country: {
      type: GraphQLString,
      description: `The country with which an artist is primarily identified. It
is often, but not always, its birth/formation country.`
    },
    area: {
      type: Area,
      description: `The area with which an artist is primarily identified. It
is often, but not always, its birth/formation country.`
    },
    beginArea: {
      type: Area,
      description: `The area in which an artist began their career (or where
they were born, if the artist is a person).`,
      resolve: resolveWithFallback(['begin-area', 'begin_area'])
    },
    endArea: {
      type: Area,
      description: `The area in which an artist ended their career (or where
they died, if the artist is a person).`,
      resolve: resolveWithFallback(['end-area', 'end_area'])
    },
    lifeSpan,
    ...fieldWithID('gender', {
      description: `Whether a person or character identifies as male, female, or
neither. Groups do not have genders.`
    }),
    ...fieldWithID('type', {
      description: 'Whether an artist is a person, a group, or something else.'
    }),
    ipis: {
      type: new GraphQLList(IPI),
      description: `List of [Interested Parties Information](https://musicbrainz.org/doc/IPI)
(IPI) codes for the artist.`
    },
    isnis: {
      type: new GraphQLList(ISNI),
      description: `List of [International Standard Name Identifier](https://musicbrainz.org/doc/ISNI)
(ISNI) codes for the artist.`
    },
    recordings,
    releases,
    releaseGroups,
    works,
    relationships,
    collections,
    tags
  })
})

export const ArtistConnection = connectionWithExtras(Artist)
export default Artist