Mailspring/spec/tasks
Evan Morikawa 5561462568 feat(metadata): add cloudState that sync with Metadata service
Summary:
Now all plugins get passed a `cloudState` object to their `activate`
method.

The `cloudState` object is an instance of `CloudState` and acts like a
key-value store backed by the yet-to-be-implemented Metadata service.

It has a `get`, `getAll`, and `observe` method. The `observe` method
returns a new `Rx.Observable` for the given key.

It has a `set`, and `unset` method that doesn't actually mutate state, but
rather dispatches new `Task`s to Create, Update, and Delete `Metadata`
objects.

The whole object is backed by `Metadata` objects. Since these are standard
Database Objects that will appear on the delta sync streaming API, any
updates from the server will automatically propagate down to listening
views via the `Rx.Observable`s.

Additionally, there is a new `N1-Send-Later` stub plugin that demonstrates
how to use the `cloudState`.

There are few other minor refactors included in this diff:

**Generic CUD Tasks**: There is now a generic `CreateModelTask`,
`UpdateModelTask`, and `DestroyModelTask`. These can either be used as-is
or trivially overridden to easily update simple objects. Hopefully all of
the boilerplate rollback, error handling, and undo logic won't have to be
re-duplicated on every task. There are also tests for these tasks. We use
them to perform mutating actions on `Metadata` objects.

**New `boundProps` for `InjectedComponents`**: When making the
`N1-Send_later` plugin, I realized that the injected component needed to
get the `cloudState` somehow. Traditionally components would require
Stores and load data that way, but these are setup at `require`-time. Now
that `cloudState` only is available on `activate` we needed a way to get
the data to the components. There's now the concept of `boundProps` which
will be props added to the Component when it gets injected. This required
changing the return signature of `findComponentMatching`, which got
renamed to `findComponentDataMatching`.

**Failing on Promise Rejects**: Turns out that if a Promise rejected
due to an error or `Promise.reject` we were ignoring it and letting tests
pass. Now, tests will Fail if any unhandled promise rejects. This
uncovered a variety of errors throughout the test suite that had to be
fixed. The most significant one was during the `theme-manager` tests when
all packages (and their stores with async DB requests) was loaded. Long
after the `theme-manager` specs finished, those DB requests were
(somtimes) silently failing.

**Globally stub `DatabaseStore._query`**: All tests shouldn't actually
make queries on the database. Furthremore, the `inTransaction` block
doesn't resolve at all unless `_query` is stubbed. Instead of manually
remembering to do this in every test that touches the DB, it's now mocked
in `spec_helper`. This broke a handful of tests that needed to be manually
fixed.

**ESLint Fixes**: Some minor fixes to the linter config to prevent
yelling about minor ES6 things and ensuring we have the correct parser.

Test Plan: new tests

Reviewers: drew, bengotow, juan

Reviewed By: juan

Differential Revision: https://phab.nylas.com/D2419
2016-02-02 15:28:06 -05:00
..
change-folder-task-spec.coffee Fix more task specs 2016-01-22 16:55:29 -08:00
change-labels-task-spec.coffee Fix more task specs 2016-01-22 16:55:29 -08:00
change-mail-task-spec.coffee feat(tasks): add Create, Update, Destroy tasks plus spec & lint fixes 2016-01-15 15:16:21 -05:00
change-starred-task-spec.coffee refactor(spec) move spec-nylas to spec 2015-10-01 21:39:44 -07:00
change-unread-task-spec.coffee refactor(spec) move spec-nylas to spec 2015-10-01 21:39:44 -07:00
create-model-task-spec.es6 feat(metadata): add cloudState that sync with Metadata service 2016-02-02 15:28:06 -05:00
destroy-category-task-spec.coffee Merge branch 'master' into unified-inbox 2016-01-25 17:28:29 -08:00
destroy-model-task-spec.es6 feat(tasks): add Create, Update, Destroy tasks plus spec & lint fixes 2016-01-15 15:16:21 -05:00
event-rsvp-spec.coffee feat(tasks): add Create, Update, Destroy tasks plus spec & lint fixes 2016-01-15 15:16:21 -05:00
send-draft-spec.coffee Fix specs 2016-01-28 00:48:45 -08:00
syncback-category-task-spec.coffee Merge branch 'master' into unified-inbox 2016-01-25 17:28:29 -08:00
syncback-draft-spec.coffee More spec fixes 2016-01-27 10:31:54 -08:00
syncback-model-task-spec.es6 feat(metadata): add cloudState that sync with Metadata service 2016-02-02 15:28:06 -05:00
task-factory-spec.coffee fix(remove-from-view): Update remove from view (shortcut) behavior 2016-02-01 17:40:42 -08:00
task-spec.coffee refactor(env): new NylasEnv global 2015-11-17 16:41:20 -08:00
update-model-task-spec.es6 feat(tasks): add Create, Update, Destroy tasks plus spec & lint fixes 2016-01-15 15:16:21 -05:00