cmstead / jsatom

An atom implementation in common JS

JSAtom

An atom implementation in Javascript.

JSAtom is an implementation of Clojure's atoms. One of the most important things to note about atoms is they are specifically a mutable object handled with a mutator function. Any mutation is applied to the atom only if the atom data hasn't changed during the execution of the mutator function.

To Dos

##Atom module

• Create core atom module (atom.build)
• Build swap function (function swap)
• Implement watchers (function setWatcher)
• Return unwatch function (return from setWatcher)
• Handle assigned validator (function setValidator)
• Retrieve raw value (function deref)
• Compare old value and set new value (ensures old value value is still the current value and sets value)
• Fire watcher events on atom
• Remove watcher

##JFP module extension

All of the collowing functions can/will have side effects

• atom (value)
• compareAndSet (atom, oldValue, newValue) (can fail)
• deref (atom, fn)
• setValidator (atom, fn)
• setWatcher (atom, fn)
• removeWatcher(atom, watcherId)
• swap (atom, fn)