grapher-helpers

Provides common cultofcoders:grapher querires out of the box, as well as creates helper methods for links providing a more OOP syntax.

To install:

meteor add wesleyfsmith:grapher-helpers

Creating helpers from links

Now, when you define your links you can automatically create associated helpers. Let's say you have a Mongo.Collection called Practices.

Practices.addLinksWithHelpers({
  employees: {
    collection: Meteor.users,
    type: 'many',
    field: 'employeeIds'
  }
});

And then you can call:

let practice = Practices.findOne();
practice.employees() // returns all employees

Which is the equivalent of:

let practice = Practices.findOne();
Practices.findLink(practice._id, 'employees').fetch();

Note that if you haven't subscribed to the appropriate documents these helpers won't return anything.

Common queries

Most often you want to query an object and just get all the fields by default. With you package you can do this by running:

let query = Practices.findQuery()

This creates a query that will grab all the fields off the collections' simple schema.

If you want to only query a single document you can run:

let query = Practices.findOneQuery('id')

This creates a query that will grab all the fields off the collections' simple schema, and then only query for that one document.

Created by query

If you create your collection like this:

import {createdByLink} from 'meteor/wesleyfsmith:grapher-helpers';

Practices = new Mongo.Collection('practices');

Practices.attachSchema(new SimpleSchema({
  name: {
    type: String
  },
  employeeIds: {
    type: [String],
    optional: true,
    autoform: {
      omit: true
    }
  },
  createdAt: {
      type: Date,
      defaultValue: new Date(),
      autoform: {
        omit: true
      }
  },
  createdById: createdByLink(Practices)
}

The createdByLink function will set the following on your simple schema:

createdById: {
    type: String,
    denyUpdate: true, // for a createdBy, shouldn't be able to update.
    autoValue: function() {
      if (this.isInsert) {
        return this.userId;
      }
    },
    allowedValues: function () {
      return this.userId;
    },
    autoform: {
      omit: true
    }
  }

AND it will create a link as well as a helper. Now you can call:

let practice = Practices.findOne();
practice.createdBy(); // returns the creator, assuming you've subscribed to that document

OR you can still get the link manually:

let practice = Practices.findOne();
Practices.findLink(practice._id, 'createdBy').fetchOne();

Finally, you can also create a default query for documents that were created by a specific user:

Practices.findCreatedByQuery(); 

If you specify an id, it will query for documents created with that id, otherwise it will default to Meteor.userId();