Create a Module

Modules are the core building blocks of a Modelence application. They help you organize your application's functionality into cohesive units that can contain queries, mutations, stores, cron jobs and configurations.

Create a new file at src/server/todo/index.ts:

src/server/todo/index.ts

import { Module } from 'modelence/server';
import { dbTodos } from './db';

export default new Module('todo', {
  /*
    Include the store we created earlier so it will be automatically
    provisioned in MongoDB when the server starts.
  */
  stores: [dbTodos],

  /*
    Module queries and mutations are similar to the corresponding
    concepts from GraphQL. They support permission checks but
    we will skip them in these examples for simplicity.
  */
  queries: {
    async getOne({ id }) {
      return await dbTodos.findById(id);
    },
    async getAll() {
      return await dbTodos.fetch({});
    }
  },

  mutations: {
    async create({ title, dueDate }, { user }) {
      const { insertedId } = await dbTodos.insertOne({
        title,
        dueDate,
        userId: user.id,
        isCompleted: false
      });
      return insertedId;
    },
    async update({ id, title, dueDate, isCompleted }) {
      return await dbTodos.updateOne({ id }, {
        $set: {
          title,
          dueDate,
          isCompleted
        }
      });
    }
  },
});

Using Modules

Now, we need to add the Module we created into the modules array of the main app.ts server file:

src/server/app.ts

import { startApp } from 'modelence/server';
import todoModule from './todo';

startApp({
  modules: [todoModule]
});

By doing this we're making all of our Module's components available and initialized when the server starts. Modelence will provision the dbTodos store and make the queries and mutations we created available for calling.