graphql-sync

    0.10.1-sync • Public • Published

    GraphQL-sync

    This is a promise-free wrapper of GraphQL.js for ArangoDB that replaces all asynchronous code with synchronous equivalents.

    Getting Started

    An overview of GraphQL in general is available in the README for the Specification for GraphQL.

    ArangoDB example

    You can use GraphQL-sync in ArangoDB to build your own GraphQL endpoints directly inside the database using the Foxx framework.

    An example Foxx service using GraphQL-sync is available as demo-graphql in the Foxx service store. You can find out more about using GraphQL with Foxx in the ArangoDB blog article Using GraphQL with NoSQL database ArangoDB.

    Using GraphQL-sync

    Install GraphQL-sync from npm

    npm install --save graphql-sync

    GraphQL-sync provides two important capabilities: building a type schema, and serving queries against that type schema.

    First, build a GraphQL type schema which maps to your code base.

    import {
      graphql,
      GraphQLSchema,
      GraphQLObjectType,
      GraphQLString
    } from 'graphql-sync';
     
    var schema = new GraphQLSchema({
      query: new GraphQLObjectType({
        name: 'RootQueryType',
        fields: {
          hello: {
            type: GraphQLString,
            resolve() {
              return 'world';
            }
          }
        }
      })
    });

    This defines a simple schema with one type and one field, that resolves to a fixed value. The resolve function can return a value, a promise, or an array of promises.

    Then, serve the result of a query against that type schema.

    var query = '{ hello }';
     
    var result = graphql(schema, query);
     
    // Prints
    // {
    //   data: { hello: "world" }
    // }
    console.log(result);

    This runs a query fetching the one field defined. The graphql function will first ensure the query is syntactically and semantically valid before executing it, reporting errors otherwise.

    var query = '{ boyhowdy }';
     
    var result = graphql(schema, query);
     
    // Prints
    // {
    //   errors: [
    //     { message: 'Cannot query field boyhowdy on RootQueryType',
    //       locations: [ { line: 1, column: 3 } ] }
    //   ]
    // }
    console.log(result);

    License

    GraphQL is BSD-licensed. Facebook also provides an additional patent grant.

    Keywords

    none

    Install

    npm i graphql-sync

    DownloadsWeekly Downloads

    7

    Version

    0.10.1-sync

    License

    BSD-3-Clause

    Last publish

    Collaborators

    • mpv1989
    • pluma