@scottburch/graphql-gun v1.0.3
GraphQL-gun
NOTE: This library is a new release and as such has not had good field testing. Please feel free to use and report any issues.
A GraphQL library for GunDB queries. (looking at mutations next)
GraphQL-gun returns a RxJS Observable so you have all of the RxJS goodness available to you.
install
npm install @scottburch/graphql-gun
yarn add @scottburch/graphql-gun
Quickstart
1) Define a basic query
const query = gql`
{
app {
settings {
rememberMe
}
}
user {
name
}
}
`;
2) Add values to GunDB
gun.get('app').get('settings').get('rememberMe').put(true)
gun.get('user').get('name').put('scott')
3) Run the query and get the result
graphqlGun(query, gun).subscribe(result => {/* do something here*/})
NOTE: This will fire twice since there are really two values we are after. The second time will have all of the requested data.
If you want to filter out results that you don't care about, you can use RxJS filter to look for the values you want.
graphqlGun(query, gun).pipe(
filter(({app, user}) => app?.settings?.rememberMe != undefined && user?.name)
).subscribe(result => {/* do something here*/})
Other Options
Using with GunDB Sets
gql`
users(type: Set) {
name
age
}
`;
Currently the set will be returned multiple times for each item in the set. This is so since the length of the set is not known at the beginning. The code below takes the first three responses and returns the last one which includes the first three elements of the set.
const gun = Gun();
const query = gql`
{
users(type: Set) {
name
}
}
`;
const alice = gun.get('user').get('alice').put({name: 'alice'})
const bob = gun.get('user').get('bob').put({name: 'bob'})
const charlie = gun.get('user').get('charlie').put({name: 'charlie'})
gun.get('users').set(alice);
gun.get('users').set(bob);
gun.get('users').set(charlie);
graphqlGun(query, gun).pipe(
take(3),
last(),
).subscribe(result => {/* { users: [ { name: 'bob' }, { name: 'charlie' }, { name: 'alice' } ] } */})
Continuous live updates
To attach a live listener you can use @live
directive in your query.
const query = gql`
user {
name @live
}
`;
graphqlGun(query, gun).subscribe(result => {/* called every time "name" changes */})
Getting a gun instance in context
To get a gun instance in context you can use a _chain
property.
const gun = Gun();
const query = gql`
{
user {
_chain
}
}
`;
gun.get('user').get('name').put('alice');
graphqlGun(query, gun).subscribe(({user}) => user._chain.get('name').once((name: string) => {/* alice */}));
React
To use GraphQL-gun with React you should use react-rxjs.
import {bind} from "@react-rxjs/core";
const query = gql`
{
user @live {
name
}
}
`;
const username$ = graphqlGun(query, gun).pipe(
map(({user}) => user.name)
);
export const [useUsername] = bind(username$, 'default username');
Typescript
You can pass in your schema as a type to graphqlGun(). I am currently looking into ways to convert graphQL into types.
type Schema = {
user: {
name: string
}
}
graphqlGun<Schema>(query, gun).subscribe(({user}) => user?.name)
Development
You will find mocha tests in the src directory in .spec.ts files. To run the tests you can run the 'test' script in package.json.
Ex. yarn test
If you want to submit a bug or feature request, it should come with a test.