graphql-express

graphql-express

A lightweight GraphQL client which can be handled by RxJs operators (switchMap, mergeMap, concatMap, exhaustMap). It requires RxJs v.6.5.0 or higher.

Comparison with Apollo

When you open a playground, to test the package open developer console, go to the network section and set throttling.

Playground with graphql-express

Playground with Angular+Apollo

Examples

Query with fragment

import { query } from 'graphql-express';

const REQUEST_URL: string = 'https://api.graph.cool/simple/v1/ciyz901en4j590185wkmexyex';

const allUsersQuery = `{
  allUsers {
    ...userFragment
  }
}`;

const userFragment = `
  fragment userFragment on User {
    id
    name
    email
    createdAt
  }`;

query(
  REQUEST_URL,
  allUsersQuery,
  null,
  [userFragment],
).pipe(
  //handling response
);

Query with variable and fragment

import { query } from 'graphql-express';

const REQUEST_URL: string = 'https://api.graph.cool/simple/v1/ciyz901en4j590185wkmexyex';

const userQuery = `
  userQuery($id: ID) {
    User(id: $id) {
     ...userFragment
    }
  }`;

const userFragment = `
  fragment userFragment on User {
    id
    name
    email
    createdAt
  }`;

const variables = {
  id: 'ck1c8p3af1d1w0133wwv0jpkx',
};

query(
  REQUEST_URL,
  userQuery,
  variables,
  [userFragment],
).pipe(
  //handling response
);

Mutation with fragment

import { mutation } from 'graphql-express';

const REQUEST_URL: string = 'https://api.graph.cool/simple/v1/ciyz901en4j590185wkmexyex';

const renameUserMutation = `
  updateUser(
    $id: ID!,
    $name: String
  ) {
    updateUser(
      id: $id,
      name: $name,
      commentsIds: [],
      comments: [],
      postsIds: [],
      posts: []
    ) {
      ...userFragment
    }
  }`;

const userFragment = `
  fragment userFragment on User {
    id
    name
    email
    createdAt
  }`;

const variables = {
  id: 'ck1c8p3af1d1w0133wwv0jpkx',
  name: 'test',
};

mutation(
    REQUEST_URL,
    renameUserMutation,
    variables,
    [userFragment],
).pipe(
  //handling response
);

QueryBuilder

import { QueryBuilder } from 'graphql-express';

const REQUEST_URL: string = 'https://api.graph.cool/simple/v1/ciyz901en4j590185wkmexyex';

const userQuery: string = `
  User(id: $id) {
   ...userFragment
  }`;

const userFragment: string = `
  fragment userFragment on User {
    id
    name
    email
    createdAt
  }`;

QueryBuilder.registerHost(REQUEST_URL, true);
QueryBuilder.registerArguments(
  {
    'id': 'ID',
    'name': 'String',
  },
);

QueryBuilder.from(userQuery)
  .addFragments([userFragment])
  .addVariables(
    {
      'id': 'ck1buv43a0hv201955u808iqn',
    },
  )
  //or .mutation()
  .query()
  .pipe(
    //handling response
  );