Ember-service-methods NPM

ember-service-methods

ember-service-methods is an addon that formalizes a pattern that I've used in several larger Ember applications. Some user interactions are inherently complicated and have a lot of business logic around them. These interactions can usually be described in simple terms. For example "Send the invoice to the email given". Using this addon, this interaction could be represented by a service method:

import { get } from '@ember/object';
import method from 'ember-service-methods';

export default method(function (invoice, { to, subject }) {
  return fetch(`/invoices/${get(invoice, 'id')}/email`, {
    method: 'POST',
    data: {
      subject
    }
  });
});

import Route from '@ember/routing/route';
import { inject as method } from 'ember-service-methods';

export default Route.extend({
  emailInvoice: method(),

  actions: {
    sendEmail(to, subject) {
      return this.emailInvoice(this.modelFor('invoice'), {
        to,
        subject
      });
    }
  }
});

This may seem overly complicated to do this simple request. I feel that this pattern works best with testing. Mocking out full API responses to actions can be complicated an error prone. With this pattern along with the built-in test helpers, these methods can be stubbed out for simpler implementations.

This is an implementation of https://github.com/emberjs/rfcs/pull/98