Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

salesforce-graphql

0.0.3 • Public • Published

salesforce graphql
Build Status Coverage Status

salesforce-graphql - Bringing the GraphQL query language to Salesforce

Getting Started

Installation

$ yarn add salesforce-graphql jsforce

Example

app.ts

import * as jsforce from 'jsforce';
import * as path from 'path';
import * as fs from 'fs';
 
import { GraphQLServer } from 'graphql-yoga';
import { Binding } from 'salesforce-graphql';
 
const schemaFile = path.join(__dirname, 'schema.graphql');
const typeDefs = fs.readFileSync(schemaFile, 'utf8');
 
const { USERNAME, PASSWORD } = process.env;
 
const resolvers = {
  Query: {
    Accounts: (parent, args, context, info) =>
      context.db.query({}, info).then(res => res.records),
    Account: (parent, args, context, info) =>
      context.db.query({}, info).then(res => res.records[0]),
    Contacts: (parent, args, context, info) =>
      context.db.query({}, info).then(res => res.records),
    Contact: (parentobj, args, context, info) =>
      context.db.query({}, info).then(res => res.records[0]),
  },
  Account: {
    Contacts: (parent, args, context, info) =>
      context.db.query({ AccountId: parent.Id }, info).then(res => res.records),
  },
  Contact: {
    Account: (parent, args, context, info) =>
      context.db.query({ Id: parent.AccountId }, info).then(res => res.records[0]),
  },
};
 
const conn = new jsforce.Connection({});
 
function init() {
  const db = new Binding({ conn });
 
  const server = new GraphQLServer({
    typeDefs,
    resolvers,
    context: req => ({ ...req, db }),
  });
 
  server.start({ playground: '/playground' }, ({ port }) =>
    console.log('Server is running on localhost:' + port)
  );
}
 
conn.login(USERNAME, PASSWORD, (err, userinfo) => init());

schema.graphql

type Query {
  Account(Id: ID!): Account
  Accounts(limit: Int): [Account]
  Contact(Id: ID!): Contact
  Contacts(limit: Int): [Contact]
}
 
type Account {
  Id: ID!
  IsDeleted: Boolean
  Name: String
  Type: String
 
  Contacts(limit: Int): [Contact]
}
 
type Contact {
  Id: ID!
  Account: Account
  AccountId: String
  LastName: String
  FirstName: String
  Salutation: String
  Name: String
}

When you are ready, start the GraphQL server:

$ yarn start

Head over to http://localhost:4000/playground to test with the following query:

{
  Account(Id: "001E000001KnMkTIAV") {
    Id
    Name
    Contacts(limit: 1) {
      Name
      AccountId
      Account {
        Name
      }
    }
  }
}

Sample Output

TODO

  • Subscriptions
  • Mutations
  • Basically everything

References

Extra

Keywords

none

Install

npm i salesforce-graphql

DownloadsWeekly Downloads

3

Version

0.0.3

License

MIT

Unpacked Size

544 kB

Total Files

22

Last publish

Collaborators

  • avatar