# changemachine
> changemachine - handle couchdb change notifications using neuron
Latest version **1.0.0** (published 2016-05-24) · MIT license · 0 weekly downloads
## Install
```sh
npm install changemachine
pnpm add changemachine
yarn add changemachine
bun add changemachine
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 1.0.0 |
| Published | 2016-05-24 |
| First published | 2011-12-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Damon Oehlman |
| Maintainers | damonoehlman |
| Keywords | steelmesh, changes, couchdb, queue, processor |
## Links
- npm: https://www.npmjs.com/package/changemachine
- Repository: https://github.com/DamonOehlman/changemachine
- Issues: http://github.com/DamonOehlman/changemachine/issues
- npm.io page: https://npm.io/package/changemachine
## Dependencies (3)
- [debug](https://npm.io/package/debug.md) ^2.2.0
- [neuron](https://npm.io/package/neuron.md) ^0.4.7
- [changemate](https://npm.io/package/changemate.md) ^1.0.0
## Alternatives
- [cron](https://npm.io/package/cron.md) — 4.9M weekly downloads
- [@vercel/queue](https://npm.io/package/@vercel/queue.md) — 731.6K weekly downloads
- [create-sonicjs](https://npm.io/package/create-sonicjs.md) — 1.6K weekly downloads
- [@exellix/jobs-api](https://npm.io/package/@exellix/jobs-api.md) — 941 weekly downloads
- [@forwardimpact/libskill](https://npm.io/package/@forwardimpact/libskill.md) — 575 weekly downloads
## Recent versions
- 1.0.0 (latest) — 2016-05-24
- 0.4.11 — 2014-05-18
- 0.4.10 — 2014-05-18
- 0.4.9 — 2012-06-27
- 0.3.2 — 2012-01-05
- 0.3.1 — 2011-12-30
- 0.3.0 — 2011-12-29
## README
# changemachine
ChangeMachine is a critical component in the
[Steelmesh stack](http://github.com/steelmesh). It is responsible for
monitoring and responding to changes in a number of couchdb instances and
taking appropriate actions in response to those changes.
The implementation of ChangeMachine is reasonably simple thanks to the
[flatiron neuron](https://github.com/flatiron/neuron) queueing library and
through leveraging [changemate](https://github.com/DamonOehlman/changemate)
notifiers.
[](https://nodei.co/npm/changemachine/)
[](https://github.com/dominictarr/stability#unstable) [](https://travis-ci.org/DamonOehlman/changemachine) [](https://www.bithound.io/github/DamonOehlman/changemachine)
## Online Documentation
Documentation for changemachine is available at
[changemachine.readthedocs.org](http://changemachine.readthedocs.org/)
## System Internals
- Attempts to act intelligently when a machine does not have a `process`
event handler. In this case, items are queued in the `ready` state and
we make use of the
[newListener](http://nodejs.org/docs/latest/api/events.html#event_newListener)
node event to wait for a process event to be connected. At this stage, similar
action is not taken if the process listener is removed.
- Makes use of changemate notifier `pause` and `resume` methods to ensure
efficient operation even in the case of a massive `_changes` feed from
couch, etc. In the case that a notifier does not support these operations,
items will be queued.
### On ChangeMate vs Follow
While at the present stage an implementation of ChangeMachine would have been
possible with the excellent [follow](https://github.com/iriscouch/follow) library
the long term plan is to support monitoring changes from the filesystem and other
sources so work changemate has been integrated instead.
## Alternative Systems
Some alternative systems that do similar things are:
- [banzai](https://github.com/pgte/banzai) - Banzai looks like an excellent
system for processing documents through a number of various states.
Banzai's implementation has definitely influenced parts of ChangeMachine.
- [hook.io](http://hook.io/) - If you are building, loosely-coupled, distributed
systems then hook.io is one of the best choices in the #nodejs space. There
are instances where ChangeMachine could perform a similar function to hook,
but in most cases ChangeMachine is designed for simpler scenarios.
- [kue](https://github.com/Learnboost/kue) - Job processor built around redis,
has a pretty admin panel to boot.
Additionally, as previously stated, ChangeMachine does not attempt to compete
with full-blown messaging and queuing systems and if you require a more
distributed system then be sure to check out the likes of RabbitMQ and 0MQ.
## License(s)
### MIT
Copyright (c) 2016 Damon Oehlman
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
'Software'), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
---
_Source: https://npm.io/package/changemachine · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._