Getting Started

Node.js library for splitting SDL first GraphQL schemas into composable chunks.

$ npm install idio-graphql

Guides

---

1. Creating Nodes
2. Combine Nodes
3. Schema Appliances
4. Resolver Hooks
5. Microservices
6. Inter-Schema Execution

Examples

---

1. Monolith
2. Microservice
3. Mini examples - Some smaller examples to help demonstrate the capability's of this package.

Contributing

---

https://github.com/danstarns/idio-graphql/blob/master/contributing.md

Gitter

---

https://gitter.im/idio-graphql/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link

Quick Start

---

$ npm install idio-graphql apollo-server graphql-tag

Examples use apollo-server however, feel free to plug into your own solution.

const {
    combineNodes,
    GraphQLNode
} = require("idio-graphql");

const { ApolloServer } = require("apollo-server");
const gql = require("graphql-tag");

const User = new GraphQLNode({
    name: "User",
    typeDefs: gql`
        type User {
            id: ID
            name: String
            age: Int
        }

        type Query {
            user(id: ID!): User
        }
    `,
    resolvers: {
        Query: {
            user: (parent, { id }) => { ... }
        }
    }
});

async function main() {
    const { typeDefs, resolvers } = combineNodes([ User ]);

    const server = new ApolloServer({ typeDefs, resolvers });

    await server.listen(4000);

    console.log(`http://localhost:4000/graphql`);
}

main();

Microservices Quick Start

---

Requires nats-server @ 0.0.0.0:4222

$ npm install idio-graphql apollo-server graphql-tag moleculer nats

User Service

Gateway Service

const gql = require("graphql-tag");
const { GraphQLNode } = require("idio-graphql");

const User = new GraphQLNode({
    name: "User",
    typeDefs: gql`
        type User {
            id: String
            name: String
            age: Int
        }

        type Query {
            user(id: String!): User
            users(ids: [String]): [User]
        }
    `,
    resolvers: {
        Query: {
            user: (root, { id }) => { ... },
            users: (root, { ids }, { injections: { broker } }) => { ... }
        }
    }
});

async function main() {
    try {
        await User.serve({
            gateway: "gateway",
            transporter: "NATS"
        });

        console.log("User Online");
    } catch (error) {
        console.error(error);

        process.exit(1);
    }
}

main();

const { ApolloServer } = require("apollo-server");
const { GraphQLGateway } = require("idio-graphql");

const gateway = new GraphQLGateway(
    { services: { nodes: ["User"] } },
    {
        transporter: "NATS",
        nodeID: "gateway"
    }
);

async function main() {
    try {
        const { typeDefs, resolvers } = await gateway.start();

        const server = new ApolloServer({
            typeDefs,
            resolvers
        });

        await server.listen(4000);

        console.log(`http://localhost:4000/graphql`);
    } catch (error) {
        console.error(error);

        process.exit(1);
    }
}

main();