A GraphQL data provider for react-admin and supabase (pg_graphql) built with Apollo.
A GraphQL data provider for react-admin and supabase pg_graphql built with Apollo.
The default (auto-generated) introspection for supabase pg_graphql can be explored here. There are a couple things of note with this schema:
COMMENT ON TABLE "Command" IS '@graphql({"totalCount": {"enabled": true}})';
[Resource]ById
query fields implemented by custom functions as shown in the pg_graphql docs. Below is an example of creating one such custom function:CREATE FUNCTION CommandById(id UUID)
RETURNS Command
STABLE
LANGUAGE sql
AS $$
SELECT *
FROM Command
WHERE Command.id = CommandById.id;
$$;
This can be overridden via the dataprovider introspection
option.
Install with:
npm install --save @groovestack/ra-data-graphql-supabase
or
yarn add @groovestack/ra-data-graphql-supabase
The @groovestack/ra-data-graphql-supabase
package exposes a single function, which is a constructor for a dataProvider
based on a GraphQL endpoint. When executed, this function calls the GraphQL endpoint, running an introspection query. It uses the result of this query (the GraphQL schema) to automatically configure the dataProvider
accordingly.
// in App.js
import React from 'react';
import { Component } from 'react';
import buildGraphQLProvider from '@groovestack/ra-data-graphql-supabase';
import { Admin, Resource } from 'react-admin';
import { PostCreate, PostEdit, PostList } from './Post';
const dataProvider = buildGraphQLProvider({ buildQuery });
const App = () => (
<Admin dataProvider={dataProvider} >
<Resource name="Post" list={PostList} edit={PostEdit} create={PostCreate} />
</Admin>
);
export default App;
Note: the parser will generate additional .id
properties for relation based types. These properties should be used as sources for reference based fields and inputs like ReferenceField
: <ReferenceField label="Author Name" source="author.id" reference="User">
.
You can either supply the client options by calling buildGraphQLProvider
like this:
buildGraphQLProvider({ clientOptions: { uri: 'http://localhost:4000', ...otherApolloOptions } });
Or supply your client directly with:
buildGraphQLProvider({ client: myClient });
The default behavior might not be optimized especially when dealing with references. You can override a specific query by wrapping the buildQuery
function:
// in src/dataProvider.js
import buildGraphQLProvider, { buildQuery } from '@groovestack/ra-data-graphql-supabase';
const myBuildQuery = introspection => (fetchType, resource, params) => {
const builtQuery = buildQuery(introspection)(fetchType, resource, params);
if (resource === 'Command' && fetchType === 'GET_ONE') {
return {
// Use the default query variables and parseResponse
...builtQuery,
// Override the query
query: gql`
query CommandById($id: ID!) {
data: CommandById(id: $id) {
id
reference
customer {
id
firstName
lastName
}
}
}`,
};
}
return builtQuery;
};
export default buildGraphQLProvider({ buildQuery: myBuildQuery })
These are the default options for introspection:
const introspectionOptions = {
include: [], // Either an array of types to include or a function which will be called for every type discovered through introspection
exclude: [], // Either an array of types to exclude or a function which will be called for every type discovered through introspection
};
// Including types
const introspectionOptions = {
include: ['Post', 'Comment'],
};
// Excluding types
const introspectionOptions = {
exclude: ['CommandItem'],
};
// Including types with a function
const introspectionOptions = {
include: type => ['Post', 'Comment'].includes(type.name),
};
// Including types with a function
const introspectionOptions = {
exclude: type => !['Post', 'Comment'].includes(type.name),
};
Note: exclude
and include
are mutually exclusives and include
will take precedence.
Note: When using functions, the type
argument will be a type returned by the introspection query. Refer to the introspection documentation for more information.
Pass the introspection options to the buildApolloProvider
function:
buildApolloProvider({ introspection: introspectionOptions });
By default, for every API call this data provider returns all top level fields in your GraphQL schema as well as association objects containing the association's ID. If you would like to implement sparse field support for your requests, you can request the specific fields you want in a request by passing them to the dataProvider via the available meta param. For example,
dataProvider.getOne(
'Post',
{
id,
meta: {
sparseFields: [
'id',
'title',
{
Comment: [
'description',
{
author : [
'name',
'email'
]
}
]
}
]
}
},
);
This can increase efficiency, optimize client performance, improve security and reduce over-fetching. Also, it allows for the request of nested association fields beyond just their ID. It is available for all dataprovider actions.
DELETE_MANY
and UPDATE_MANY
OptimizationsYour GraphQL backend may not allow multiple deletions or updates in a single query. This provider defaults to simply making multiple requests to handle those. This is obviously not ideal but can be alleviated by supplying your own ApolloClient
which could use the apollo-link-batch-http link if your GraphQL backend support query batching.
Run the tests with this command:
make test