@exodus/atoms 5.5.0 → 5.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/atoms",
-  "version": "5.5.0",
+  "version": "5.7.0",
   "main": "src/index.js",
   "description": "Abstraction for encapsulating a piece of data behind a simple unified interface: get, set, observe",
   "author": "Exodus Movement Inc.",
@@ -31,10 +31,10 @@
   },
   "devDependencies": {
     "@exodus/atom-tests": "^1.0.0",
-    "@exodus/storage-memory": "^2.1.0",
+    "@exodus/storage-memory": "^2.1.1",
     "delay": "^5.0.0",
     "eslint": "^8.44.0",
     "jest": "^29.1.2"
   },
-  "gitHead": "42aecad05fd3135cde0287a37ab4e2af232ee66d"
+  "gitHead": "d6c6919e0879a84f30a6fa5c2f2e0d9a35ce7d2f"
 }

package/src/enhancers/dedupe.js

@@ -9,9 +9,22 @@ const dedupe = (atom) => {
     return atom.set((previous) => (isEqual(previous, value) ? previous : value))
   }
 
+  const observe = (callback) => {
+    let called
+    let previous
+    return atom.observe(async (value) => {
+      if (called && isEqual(previous, value)) return
+
+      called = true
+      previous = value
+      return callback(value)
+    })
+  }
+
   return {
     ...atom,
     set,
+    observe,
   }
 }
 

package/src/enhancers/optimistic-notifier.js

@@ -0,0 +1,60 @@
+import makeConcurrent from 'make-concurrent'
+import createInMemoryAtom from '../factories/memory'
+
+const optimisticNotifier = (atom) => {
+  const memoryAtom = createInMemoryAtom()
+
+  const set = makeConcurrent(async (newValue) => {
+    let previous
+    await memoryAtom.set((previousValue) => {
+      previous = previousValue
+      return newValue
+    })
+
+    atom
+      .set(newValue)
+      // only revert in case the value hasn't changed in the meanwhile
+      .catch(() => memoryAtom.set((value) => (value === newValue ? previous : value)))
+  })
+
+  let unsubscribeSource
+  let subscribers = 0
+
+  const maybeUnsubscribeSource = () => {
+    subscribers -= 1
+    if (subscribers > 0) return
+    unsubscribeSource()
+    unsubscribeSource = undefined
+  }
+
+  const observe = (callback) => {
+    if (subscribers === 0) {
+      unsubscribeSource = atom.observe(set)
+    }
+
+    subscribers += 1
+    const unsubscribe = memoryAtom.observe(callback)
+
+    return () => {
+      unsubscribe()
+      maybeUnsubscribeSource()
+    }
+  }
+
+  const get = async () => {
+    if (subscribers === 0) {
+      return atom.get()
+    }
+
+    return memoryAtom.get()
+  }
+
+  return {
+    ...memoryAtom,
+    set,
+    get,
+    observe,
+  }
+}
+
+export default optimisticNotifier

package/src/factories/observer.js

@@ -1,8 +1,10 @@
-const createAtomObserver = ({ port, atom, event }) => {
+const createAtomObserver = ({ port, atom, event, immediateRegister = true }) => {
   let emitting = false
   let unobserve
 
   const register = () => {
+    if (unobserve) return
+
     unobserve = atom.observe((value) => {
       if (emitting) port.emit(event, value)
     })
@@ -17,6 +19,10 @@ const createAtomObserver = ({ port, atom, event }) => {
     port.emit(event, await atom.get())
   }
 
+  if (immediateRegister) {
+    register()
+  }
+
   return {
     register,
     unregister,