Keyv adapter

Adapter to persist store in multiple backends, using Keyv library.

Install

Depending on your package manager

1# using `pnpm` ↓
2$ pnpm add effector-storage @effector-storage/keyv
3
4# using `yarn` ↓
5$ yarn add effector-storage @effector-storage/keyv
6
7# using `npm` ↓
8$ npm install --save effector-storage @effector-storage/keyv

Also, you need to install required adapters for Keyv.

Usage

Due to changes in Keyv v5, you have to create Keyv storage adapter explicitely.

Import persist function from '@effector-storage/keyv' module, and use it with created adapter:

1import KeyvRedis from '@keyv/redis'
2import { persist } from '@effector-storage/keyv'
3
4// create new Redis Keyv storage adapter
5const storage = new KeyvRedis({ uri: 'redis://user:pass@localhost:6379' })
6
7// persist store `$counter` with key 'counter' in Redis
8persist({
9  store: $counter,
10  key: 'counter',
11  with: storage,
12})

⚠️ Note, that Keyv is asynchronous.

Two (or more) different stores, persisted with the same key, will be synchronized (synchronously!), even if not connected with each other directly — each store will receive updates from another one.

Formulae

1import { persist } from '@effector-storage/keyv'

• persist({ store, ...options }): Subscription
• persist({ source, target, ...options }): Subscription

Options

• ... all the common options from effector-storage's persist function.
• with?: (string | Keyv | [Keyv.Options]): Connection string for Keyv library, or Keyv instance, or Keyv options. Default = undefined (in that case in-memory Map is used as a storage)
• ttl?: (number): TTL for stored value in milliseconds. Default = undefined

Adapter

1import { adapter } from '@effector-storage/keyv'

• adapter(options?): StorageAdapter

Options

• with?: (Keyv | KeyvStoreAdapter | KeyvOptions | Map): Keyv instance, or Keyv storage adapter, or Keyv options. Default = undefined (in that case Keyv uses in-memory Map as a storage)
• ttl?: (number): TTL for stored value in milliseconds. Default = undefined

FAQ

How do I use custom serialization / deserialization?

Adapter doesn't provide extra serialization options, but you can use Keyv options to achieve that:

1persist({
2  store: $counter,
3  key: 'counter',
4  with: {
5    store: new KeyvRedis({ uri: 'redis://user:pass@localhost:6379' }),
6    serialize: JSON.stringify,
7    deserialize: JSON.parse,
8  },
9})

or use separate Keyv instance:

1const keyv = new Keyv(
2  new KeyvRedis({ uri: 'redis://user:pass@localhost:6379' }),
3  {
4    serialize: JSON.stringify,
5    deserialize: JSON.parse,
6  }
7)
8
9persist({
10  store: $counter,
11  key: 'counter',
12  with: keyv,
13})

Please, read Keyv documentation for more details.