graphbrainz/src/types/place.js

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

import GraphQL from 'graphql';
import { Node } from './node.js';
import { Entity } from './entity.js';
import { Degrees } from './scalars.js';
import { Area } from './area.js';
import {
  id,
  mbid,
  name,
  disambiguation,
  fieldWithID,
  connectionWithExtras,
  linkedQuery,
} from './helpers.js';
import { aliases } from './alias.js';
import { collections } from './collection.js';
import { events } from './event.js';
import { lifeSpan } from './life-span.js';
import { relationships } from './relationship.js';
import { tags } from './tag.js';

const { GraphQLObjectType, GraphQLString } = GraphQL;

export const Coordinates = new GraphQLObjectType({
  name: 'Coordinates',
  description: 'Geographic coordinates described with latitude and longitude.',
  fields: () => ({
    latitude: {
      type: Degrees,
      description:
        'The north–south position of a point on the Earth’s surface.',
    },
    longitude: {
      type: Degrees,
      description: 'The east–west position of a point on the Earth’s surface.',
    },
  }),
});

export const Place = new GraphQLObjectType({
  name: 'Place',
  description: `A [place](https://musicbrainz.org/doc/Place) is a venue, studio,
or other place where music is performed, recorded, engineered, etc.`,
  interfaces: () => [Node, Entity],
  fields: () => ({
    id,
    mbid,
    name,
    disambiguation,
    aliases,
    address: {
      type: GraphQLString,
      description: `The address describes the location of the place using the
standard addressing format for the country it is located in.`,
    },
    area: {
      type: Area,
      description: `The area entity representing the area, such as the city, in
which the place is located.`,
    },
    coordinates: {
      type: Coordinates,
      description: 'The geographic coordinates of the place.',
    },
    lifeSpan,
    ...fieldWithID('type', {
      description: `The type categorises the place based on its primary
function.`,
    }),
    events,
    relationships,
    collections,
    tags,
  }),
});

export const PlaceConnection = connectionWithExtras(Place);

export const places = linkedQuery(PlaceConnection);