cruddl-launchpad
    TypeScript icon, indicating that this package has built-in type declarations

    0.4.10 • Public • Published

    cruddl

    npm version Build Status

    cruddl - create a cuddly GraphQL API for your database, using the GraphQL SDL to model your schema.

    This TypeScript library creates an executable GraphQL schema from a model definition and provides queries and mutations to access a database. Currently, it supports the multi-model database ArangoDB.

    Features

    • Schema definition using GraphQL types, fields and directives
    • Modelling features like relations, embedded lists and objects
    • Query features include filtering, sorting, cursor-based pagination and arbitrary nesting
    • Schema validation
    • Role-based authorization (field and type-based; static and data-dependent)
    • Pluggable database backends (currently supports ArangoDB and an in-memory implementation)

    Usage

    npm install --save cruddle
    

    Install ArangoDB and create a new database.

    import { ArangoDBAdapter } from 'cruddl';
    const db = new ArangoDBAdapter({
        databaseName: 'databaseName',
        url: 'http://root:@localhost:8529',
        user: 'root',
        password: ''
    });

    If you just want to explore the features, you can also use an in-memory database implementation - but don't use this for anything else.

    import { InMemoryAdapter } from 'cruddl';
    const db = new InMemoryAdapter();

    Define your data model and create a project:

    import { Project } from 'cruddl';
    const project = new Project([{
      name: 'schema.graphqls',
      body: `
        type Movie @rootEntity {
          title: String
          actors: Actor @relation
        }
        
        type Actor @rootEntity {
          name: String
          movies: Movie @relation(inverseOf: "actors")
        }`
    }, {
      name: 'permission-profiles.json',
      body: JSON.stringify({
        permissionProfiles: {
          default: {
            permissions: [{
              roles: ['users'],
              access: 'readWrite'
            }]
          }
        }
      })
    }]);

    Then, create the GraphQL schema and serve it:

    import { GraphQLServer } from 'graphql-yoga';
    const schema = project.createSchema(db);
    db.updateSchema(schema); // create missing collections
    const server = new GraphQLServer({ schema, context: () => ({ authRoles: [ 'users' ]}) });
    server.start(() => console.log('Server is running on http://localhost:4000/'));

    See the modelling guide and the api documentation for details or clone this repository for a full featured example.

    Status

    Although the feature set is already quite extensive, this project is still in active development. A number of regression tests helps to avoid unexpected changes in behavior, but they do not yet cover all cases. Documentation is relatively sparse and will be extended in the future. We aim to contribute to the ongoing developments regarding GraphQL database interfaces and might change our API to more closely match these of other implementations in the future.

    Documentation

    Keywords

    none

    Install

    npm i cruddl-launchpad

    DownloadsWeekly Downloads

    0

    Version

    0.4.10

    License

    none

    Unpacked Size

    1.62 MB

    Total Files

    575

    Last publish

    Collaborators

    • yogu