0.2.14 • Published 6 years ago
decorated-graphql v0.2.14
decorated-graphql
A few node decorators for building GraphQL API. They allow you to use GraphQL schema as type declarations for your resolvers.
Requirements
Your project setup must support decorators and the code must be run without class names minimalization.
Installation
npm install decorated-graphql
Example code snippet
import { type, query, subscription, mutation, publish, description, union, Enum, Interface } from 'decorated-graphql';
export const users = [{
id: 1,
username: 'user1',
meta: { birthday: '02-02-1990', name: 'Tom' },
}, {
id: 2,
username: 'user2',
meta: { birthday: '10-11-2001', name: 'Matt' },
}];
export const messages = [{
id: 1,
senderId: 1,
recvId: 2,
content: 'blabla',
}];
// User.graphql.js file
@type`
id: ID
username: String
meta: JSON`
export class User {
@query`: [User]`
users() {
return users;
}
}
// Message.graphql.js file
@description`Represents a message sent from one user to another`
@type`
id: ID
""" id of the sending user """ senderId: ID
""" id of receiving user """ recvId: ID
content: String
recver: User`
export class Message {
@description`Used to create a single message`
@mutation`(senderId: ID, recvId: ID, content: String): Message`
createMessage(message) {
const newMessage = { ...message, id: (messages.length + 1).toString() };
messages.push(newMessage);
publish('onMessageCreated', newMessage);
return newMessage;
}
@query`: [Message]`
messages() {
return messages;
}
@subscription`(recvId: ID): Message`
onMessageCreated(newMessage, variables) {
return newMessage.recvId === variables.recvId;
}
recver(message) {
return users.filter(user => user.id === message.recvId)[0];
}
}
// Anything.graphql.js file
@union`User | Message`
export class Anything {
__resolveType(anything) {
if (anything.content) {
return 'Message';
}
return 'User';
}
@query`: [Anything]`
allData() {
return users.concat(messages);
}
}
Example server code with subscriptions
import express from 'express';
import { graphqlExpress, graphiqlExpress } from 'apollo-server-express';
import bodyParser from 'body-parser';
import createSchema from 'decorated-graphql/build/create-schema';
import createSubscriptionServer from 'decorated-graphql/build/create-subscription-server'
const app = express();
// path to directory containing `.graphql.js` files with exported graphql decorated classes
const projectRoot = `${__dirname}`;
const schema = createSchema(projectRoot);
app.use('/graphql', bodyParser.json(), graphqlExpress({ schema }));
app.use('/', graphiqlExpress({
endpointURL: '/graphql',
subscriptionsEndpoint: 'ws://localhost:3000/subscriptions'
}));
const ws = createSubscriptionServer(app, schema, '/subscriptions');
ws.listen(3000, () => {
console.log('Go visit http://localhost:3000');
});
Example project
An example project already setup and ready to run: https://github.com/ikatun/graphql-project. It's using nnode to run any JS code on any node version without transpilation.