npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

redux-pouchdb-store-enhancer

v1.0.3

Published

Redux PouchDB Enhancer to store actions locally, sync with remote CouchDB, and time travel by applying remote actions locally and then compute distributed nextState.

Downloads

16

Readme

redux-pouchdb-store-enhancer

Redux PouchDB Enhancer to store actions locally, sync with remote CouchDB, and time travel by applying remote actions locally and then compute distributed nextState.

Overview

This library is a simple experiment with leveraging Redux and PouchDB to build an Enventually Consistent distributed realtime system.

Architecture

Every action that a single client emits as part of the regular Redux architecture will be intercepted and pushed into a local PouchDB database. All local PouchDB actions are sync'd to a remote CouchDB database. Since multiple users could introduce new actions into our system we need to update our local AppState to be Consistent across all clients. This is done by listening to the 'push' sync events from the remote CouchDB. When we receive new actions we replay all actions in our local PouchDB, which now includes the remote actions, and compute a deterministic next state. All actions are added to the DB in accountant style, where every record is additive, and conflicts are almost guaranteed to be nonexistent.

As we begin to distribute this model to multiple clients we build a realtime system that captures actions, ensures ordering of actions during replay, and ensures eventual consistency amongst all clients.

Offline support is a first-class citizen. Every action is pushed into your local, PouchDB, and when the user is online PouchDB will sync with the remote CouchDB.

Actions ordering is guaranteed to be deterministic by using a PouchDB _id that is a composite of TIMESTAMP-UUIDv4. In this way if we have conflicts with actions occurring simultaneously, we can use the UUIDv4 (which is not time dependent) to consistently order these actions as we replay history on remote clients devices.

Cautions: this architecture is experimental. More work is needed to control the size of the Actions database and the cost of replaying all actions every sync. A future enhancement would be to compress all actions into a single action that simply replaces the local app state. This would essentially allow us to compress historical actions into a single action and free up computation and wire chatter. Also, important to note that additional tuning on the chatter between PouchDB and CouchDB would be needed. The current sync implementation options are simply live: true, retry: true

Install

npm i -S redux-pouchdb-store-enhancer

Example

import pouchdbStoreEnhancer from 'redux-pouchdb-store-enhancer';

const middleware = [];
const store = createStore(
  reducer,
  compose(applyMiddleware(...middleware),
  pouchdbStoreEnhancer()
);

pouchdbStoreEnhancer accepts options that allow the user to configure the local PouchDB database name and remote CouchDB database url.

The local PouchDB database will be used to store all local actions, on and offline. The remote CouchDB database will be used to sync actions from all connected clients.

API

pouchdbStoreEnhancer(remoteActionsDBUrl, localActionsDBName)

remoteActionsDBUrl

This is the full URL to your CouchDB database including the DB name to sync actions.

Defaults:

remoteActionsDBUrl = 'http://127.0.0.1:5984/actions'

localActionsDBName

This is the name of your local PouchDB database, this will be used to store actions.

Defaults:

localActionsDBName = 'actions'