graphbrainz/src/types/artist-credit.js

A GraphQL schema, Express server, and middleware for querying the MusicBrainz.

import GraphQL from 'graphql';
import { Artist } from './artist.js';
import { createSubqueryResolver } from '../resolvers.js';

const { GraphQLObjectType, GraphQLString, GraphQLList } = GraphQL;

export const ArtistCredit = new GraphQLObjectType({
  name: 'ArtistCredit',
  description: `[Artist credits](https://musicbrainz.org/doc/Artist_Credits)
indicate who is the main credited artist (or artists) for releases, release
groups, tracks, and recordings, and how they are credited. They consist of
artists, with (optionally) their names as credited in the specific release,
track, etc., and join phrases between them.`,
  fields: () => ({
    artist: {
      type: Artist,
      description: `The entity representing the artist referenced in the
credits.`,
      resolve: (source) => {
        const { artist } = source;
        if (artist) {
          artist._type = 'artist';
        }
        return artist;
      },
    },
    name: {
      type: GraphQLString,
      description: `The name of the artist as credited in the specific release,
track, etc.`,
    },
    joinPhrase: {
      type: GraphQLString,
      description: `Join phrases might include words and/or punctuation to
separate artist names as they appear on the release, track, etc.`,
      resolve: (data) => data.joinphrase,
    },
  }),
});

export const artistCredits = {
  type: new GraphQLList(ArtistCredit),
  description: 'The main credited artist(s).',
  resolve: createSubqueryResolver({
    inc: 'artist-credits',
    key: 'artist-credit',
  }),
};

export const artistCredit = {
  ...artistCredits,
  deprecationReason: `The \`artistCredit\` field has been renamed to
\`artistCredits\`, since it is a list of credits and is referred to in the
plural form throughout the MusicBrainz documentation. This field is deprecated
and will be removed in a major release in the future. Use the equivalent
\`artistCredits\` field.`,
};