effector-storage 4.2.1 → 5.0.0

package/README.md

@@ -17,12 +17,17 @@ Small module for [Effector](https://github.com/effector/effector) ☄️ to sync
   - [with `localStorage`](#with-localstorage)
   - [with `sessionStorage`](#with-sessionstorage)
   - [with query string](#with-query-string)
+  - [with React Native AsyncStorage](#with-react-native-asyncstorage)
+  - [with React Native EncryptedStorage](#with-react-native-encryptedstorage)
 - [Usage with domains](#usage-with-domains)
 - [Functional helpers](#functional-helpers)
 - [Formulae](#formulae)
   - [Units](#units)
   - [Options](#options)
   - [Returns](#returns)
+- [`createPersist` factory](#createpersist-factory)
+  - [Options](#options-1)
+  - [Returns](#returns-1)
 - [Advanced usage](#advanced-usage)
 - [Storage adapters](#storage-adapters)
   - [Synchronous storage adapter example](#synchronous-storage-adapter-example)
@@ -40,13 +45,16 @@ Small module for [Effector](https://github.com/effector/effector) ☄️ to sync
 
 ## Install
 
+Depending on your package manager
+
 ```bash
-$ yarn add effector-storage
-```
+# using `pnpm` ↓
+$ pnpm add effector-storage
 
-Or using `npm`
+# using `yarn` ↓
+$ yarn add effector-storage
 
-```bash
+# using `npm` ↓
 $ npm install --save effector-storage
 ```
 
@@ -98,44 +106,53 @@ If two (or more) stores are persisted in query string with the same key — they
 ⚠️ **Note**<br>
 Use this only with plain string stores (`Store<string | null>`) to avoid strange unexpected behavior.
 
-## Usage with domains
+### with React Native AsyncStorage
 
-You can use `persist` inside Domain's `onCreateStore` hook:
+Docs: [effector-storage/rn/async](https://github.com/yumauri/effector-storage/tree/master/src/rn/async/README.md)
 
 ```javascript
-import { createDomain } from 'effector'
-import { persist } from 'effector-storage/local'
+import { persist } from 'effector-storage/rn/async'
 
-const app = createDomain('app')
+// persist store `$counter` with key 'counter'
+persist({ store: $counter, key: 'counter' })
 
-// this hook will persist every store, created in domain,
-// in `localStorage`, using stores' names as keys
-app.onCreateStore((store) => persist({ store }))
+// if your storage has a name, you can omit `key` field
+persist({ store: $counter })
+```
 
-const $store = app.createStore(0, { name: 'store' })
+⚠️ Note, that [AsyncStorage] is asynchronous, hence the name.
+
+### with React Native EncryptedStorage
+
+Docs: [effector-storage/rn/encrypted](https://github.com/yumauri/effector-storage/tree/master/src/rn/encrypted/README.md)
+
+```javascript
+import { persist } from 'effector-storage/rn/encrypted'
+
+// persist store `$counter` with key 'counter'
+persist({ store: $counter, key: 'counter' })
+
+// if your storage has a name, you can omit `key` field
+persist({ store: $counter })
 ```
 
-## Functional helpers
+⚠️ Note, that [EncryptedStorage] is asynchronous (it is based on [AsyncStorage] actually).
 
-There are special `persist` forms to use with functional programming style. You can use them, if you like, with Domain hook or `.thru()` store method:
+## Usage with domains
+
+You can use `persist` inside Domain's `onCreateStore` hook:
 
 ```javascript
 import { createDomain } from 'effector'
-import { persist } from 'effector-storage/local/fp'
+import { persist } from 'effector-storage/local'
 
 const app = createDomain('app')
 
 // this hook will persist every store, created in domain,
 // in `localStorage`, using stores' names as keys
-app.onCreateStore(persist())
+app.onCreateStore((store) => persist({ store }))
 
 const $store = app.createStore(0, { name: 'store' })
-
-// or persist single store in `localStorage` via .thru
-const $counter = createStore(0)
-  .on(increment, (state) => state + 1)
-  .on(decrement, (state) => state - 1)
-  .thru(persist({ key: 'counter' }))
 ```
 
 ## Formulae
@@ -147,12 +164,6 @@ import { persist } from 'effector-storage/<adapter>'
 - `persist({ store, ...options }): Subscription`
 - `persist({ source, target, ...options }): Subscription`
 
-```javascript
-import { persist } from 'effector-storage/<adapter>/fp'
-```
-
-- `persist({ ...options }?): (store: Store) => Store`
-
 ### Units
 
 In order to synchronize _something_, you need to specify effector units. Depending on a requirements, you may want to use `store` parameter, or `source` and `target` parameters:
@@ -164,21 +175,26 @@ In order to synchronize _something_, you need to specify effector units. Dependi
 ### Options
 
 - `key`? ([_string_]): Key for local/session storage, to store value in. If omitted — `store` name is used. **Note!** If `key` is not specified, `store` _must_ have a `name`! You can use `'effector/babel-plugin'` to have those names automatically.
-- `pickup`? ([_Event_] | [_Effect_] | [_Store_]): Unit, which you can specify to force update `store` value from storage.
+- `keyPrefix`? ([_string_]): Prefix, used in adapter, to be concatenated to `key`. By default = `''`.
+- `clock`? ([_Event_] | [_Effect_] | [_Store_]): Unit, if passed – then value from `store`/`source` will be stored in the storage only upon its trigger.
+- `pickup`? ([_Event_] | [_Effect_] | [_Store_]): Unit, which you can specify to update `store` value from storage. **Note!** When you add `pickup`, `persist` _will not_ get initial value from storage automatically!
 - `done`? ([_Event_] | [_Effect_] | [_Store_]): Unit, which will be triggered on each successful read or write from/to storage.<br>
   Payload structure:
   - `key` ([_string_]): Same `key` as above.
+  - `keyPrefix` ([_string_]): Prefix, used in adapter, to be concatenated to `key`. By default = `''`.
   - `operation` (_`'set'`_ | _`'get'`_): Did error occurs during setting value to storage or getting value from storage.
   - `value` (_State_): Value set to `store` or got from `store`.
 - `fail`? ([_Event_] | [_Effect_] | [_Store_]): Unit, which will be triggered in case of any error (serialization/deserialization error, storage is full and so on). **Note!** If `fail` unit is not specified, any errors will be printed using `console.error(Error)`.<br>
   Payload structure:
   - `key` ([_string_]): Same `key` as above.
+  - `keyPrefix` ([_string_]): Prefix, used in adapter, to be concatenated to `key`. By default = `''`.
   - `operation` (_`'set'`_ | _`'get'`_): Did error occurs during setting value to storage or getting value from storage.
   - `error` ([_Error_]): Error instance
   - `value`? (_any_): In case of _'set'_ operation — value from `store`. In case of _'get'_ operation could contain raw value from storage or could be empty.
 - `finally`? ([_Event_] | [_Effect_] | [_Store_]): Unit, which will be triggered either in case of success or error.<br>
   Payload structure:
   - `key` ([_string_]): Same `key` as above.
+  - `keyPrefix` ([_string_]): Prefix, used in adapter, to be concatenated to `key`. By default = `''`.
   - `operation` (_`'set'`_ | _`'get'`_): Operation stage.
   - `status` (_`'done'`_ | _`'fail'`_): Operation status.
   - `error`? ([_Error_]): Error instance, in case of error.
@@ -188,9 +204,36 @@ In order to synchronize _something_, you need to specify effector units. Dependi
 
 - ([_Subscription_]): You can use this subscription to remove store association with storage, if you don't need them to be synced anymore. It is a function.
 
-- `(store) => Store` ([_Function_]): Function, which accepts store to synchronize with storage, and returns:
-  - ([_Store_]): Same given store.<br>
-    _You cannot unsubscribe store from storage when using functional form of `persist`._
+## `createPersist` factory
+
+In rare cases you might want to use `createPersist` factory. It allows you to specify some adapter options, like `keyPrefix`.
+
+```javascript
+import { createPersist } from 'effector-storage/local'
+
+const persist = createPersist({
+  keyPrefix: 'app/',
+})
+
+// ---8<---
+
+persist({
+  store: $store1,
+  key: 'store1', // localStorage key will be `app/store1`
+})
+persist({
+  store: $store2,
+  key: 'store2', // localStorage key will be `app/store2`
+})
+```
+
+### Options
+
+- `keyPrefix`? ([_string_]): Key prefix for adapter. It will be concatenated with any `key`, given to returned `persist` function.
+
+### Returns
+
+- Custom `persist` function, with predefined adapter options.
 
 ## Advanced usage
 
@@ -208,12 +251,6 @@ Core function `persist` accepts all **common** options, as `persist` functions f
 
 - `adapter` (_StorageAdapter_): Storage adapter to use.
 
-There is also _fp_ form too:
-
-```javascript
-import { persist } from 'effector-storage/fp'
-```
-
 ## Storage adapters
 
 Adapter is a function, which is called by the core `persist` function, and has following interface:
@@ -312,13 +349,13 @@ persist({ store, adapter }) // <- use adapter
 
 If your storage can be updated from _external source_, and doesn't have any events to react to, but you are able to know about it somehow.
 
-You can use optional `pickup` parameter to specify unit to trigger force update:
+You can use optional `pickup` parameter to specify unit to trigger update (keep in mind, that when you add `pickup`, `persist` _will not_ get initial value from storage automatically):
 
 ```javascript
 import { createEvent, createStore, forward } from 'effector'
 import { persist } from 'effector-storage/session'
 
-// event, which will be used to trigger force update
+// event, which will be used to trigger update
 const pickup = createEvent()
 
 const store = createStore('', { name: 'store' })
@@ -327,7 +364,7 @@ persist({ store, pickup }) // <- set `pickup` parameter
 // --8<--
 
 // when you are sure, that storage was updated,
-// and you need to force update `store` from storage with new value
+// and you need to update `store` from storage with new value
 pickup()
 ```
 
@@ -406,7 +443,7 @@ adapter = storage(options)
 #### Options
 
 - `storage` (_Storage_): Storage to communicate with.
-- `sync`? ([_boolean_], **deprecated**): Add [`'storage'`] event listener or no. Default = `false`.
+- `sync`? ([_boolean_]): Add [`'storage'`] event listener or no. Default = `false`.
 - `serialize`? (_(value: any) => string_): Custom serialize function. Default = `JSON.stringify`
 - `deserialize`? (_(value: string) => any_): Custom deserialize function. Default = `JSON.parse`
 
@@ -445,27 +482,31 @@ persist({
 ```
 
 ⚠️ **BIG WARNING!**<br>
-Use this approach with caution, beware of infinite circular updates. To avoid them, persist _only plain values_ in storage. So, mapped store in `source` will not trigger update, if object in original store has changed.
+Use this approach with caution, beware of infinite circular updates. To avoid them, persist _only plain values_ in storage. So, mapped store in `source` will not trigger update, if object in original store has changed. Also, you can take a look at [`updateFilter` option](https://effector.dev/docs/api/effector/createStore).
 
 ## TODO
 
 - [x] [localStorage] support (docs: [effector-storage/local](https://github.com/yumauri/effector-storage/tree/master/src/local/README.md))
 - [x] [sessionStorage] support (docs: [effector-storage/session](https://github.com/yumauri/effector-storage/tree/master/src/session/README.md))
 - [x] [query string](https://developer.mozilla.org/en-US/docs/Web/API/Location/search) support (docs: [effector-storage/query](https://github.com/yumauri/effector-storage/tree/master/src/query/README.md))
+- [x] [AsyncStorage] support (docs: [effector-storage/rn/async](https://github.com/yumauri/effector-storage/tree/master/src/rn/async/README.md))
+- [x] [EncryptedStorage] support (docs: [effector-storage/rn/encrypted](https://github.com/yumauri/effector-storage/tree/master/src/rn/encrypted/README.md))
 - [ ] [IndexedDB] support
-- [ ] [AsyncStorage] support
 - [ ] [Cookies] support
 - [ ] you name it support
 
 ## Sponsored
 
-[<img src="https://setplex.com/img/logo.png" alt="Setplex" width="236">](https://setplex.com)
+[<img src="https://setplex.com/img/logo.png" alt="Setplex OTT Platform" width="236">](https://setplex.com/en/)
+
+[Setplex OTT Platform](https://setplex.com/en/)
 
 [localstorage]: https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage
 [sessionstorage]: https://developer.mozilla.org/en-US/docs/Web/API/Window/sessionStorage
 [`'storage'`]: https://developer.mozilla.org/en-US/docs/Web/API/StorageEvent
 [indexeddb]: https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API
 [asyncstorage]: https://react-native-async-storage.github.io/async-storage/
+[encryptedstorage]: https://github.com/emeraldsanto/react-native-encrypted-storage
 [cookies]: https://developer.mozilla.org/en-US/docs/Web/API/Document/cookie
 [_subscription_]: https://effector.dev/docs/glossary#subscription
 [_effect_]: https://effector.dev/docs/api/effector/effect

package/async-storage/index.cjs

@@ -0,0 +1,2 @@
+"use strict";exports.asyncStorage=function({storage:e,serialize:t=JSON.stringify,deserialize:a=JSON.parse}){var r=r=>({async get(){var t=await e.getItem(r);return null===t?void 0:a(t)},async set(a){await e.setItem(r,t(a))}});return r.keyArea=e,r};
+//# sourceMappingURL=index.cjs.map

package/async-storage/index.cjs.d.ts

@@ -0,0 +1,21 @@
+import { StorageAdapter } from '..'
+
+interface AsyncStorage {
+  getItem: (key: string) => Promise<string | null>
+  setItem: (key: string, value: string) => Promise<void>
+}
+interface AsyncStorageConfig {
+  storage: AsyncStorage
+  serialize?: (value: any) => string
+  deserialize?: (value: string) => any
+}
+/**
+ * Generic `AsyncStorage` adapter factory
+ */
+declare function asyncStorage({
+  storage,
+  serialize,
+  deserialize,
+}: AsyncStorageConfig): StorageAdapter
+
+export { AsyncStorage, AsyncStorageConfig, asyncStorage }

package/async-storage/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/async-storage/index.ts"],"sourcesContent":["import type { StorageAdapter } from '..'\n\nexport interface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<void>\n}\n\nexport interface AsyncStorageConfig {\n  storage: AsyncStorage\n  serialize?: (value: any) => string\n  deserialize?: (value: string) => any\n}\n\n/**\n * Generic `AsyncStorage` adapter factory\n */\nexport function asyncStorage({\n  storage,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n}: AsyncStorageConfig): StorageAdapter {\n  const adapter: StorageAdapter = <State>(key: string) => ({\n    async get() {\n      const item = await storage.getItem(key)\n      return item === null ? undefined : deserialize(item)\n    },\n\n    async set(value: State) {\n      await storage.setItem(key, serialize(value))\n    },\n  })\n\n  adapter.keyArea = storage\n  return adapter\n}\n"],"names":["storage","serialize","JSON","stringify","deserialize","parse","adapter","key","item","getItem","undefined","value","setItem","keyArea"],"mappings":"kCAgBO,UAAsBA,QAC3BA,EAD2BC,UAE3BA,EAAYC,KAAKC,UAFUC,YAG3BA,EAAcF,KAAKG,YAEbC,EAAkCC,qBAE9BC,QAAaR,EAAQS,QAAQF,UACnB,OAATC,OAAgBE,EAAYN,EAAYI,cAGvCG,SACFX,EAAQY,QAAQL,EAAKN,EAAUU,cAIzCL,EAAQO,QAAUb,EACXM"}

package/async-storage/index.d.ts

@@ -0,0 +1,21 @@
+import { StorageAdapter } from '..'
+
+interface AsyncStorage {
+  getItem: (key: string) => Promise<string | null>
+  setItem: (key: string, value: string) => Promise<void>
+}
+interface AsyncStorageConfig {
+  storage: AsyncStorage
+  serialize?: (value: any) => string
+  deserialize?: (value: string) => any
+}
+/**
+ * Generic `AsyncStorage` adapter factory
+ */
+declare function asyncStorage({
+  storage,
+  serialize,
+  deserialize,
+}: AsyncStorageConfig): StorageAdapter
+
+export { AsyncStorage, AsyncStorageConfig, asyncStorage }

package/async-storage/index.js

@@ -0,0 +1,2 @@
+function e({storage:e,serialize:t=JSON.stringify,deserialize:a=JSON.parse}){var r=r=>({async get(){var t=await e.getItem(r);return null===t?void 0:a(t)},async set(a){await e.setItem(r,t(a))}});return r.keyArea=e,r}export{e as asyncStorage};
+//# sourceMappingURL=index.js.map

package/async-storage/index.js.flow

@@ -0,0 +1,19 @@
+/**
+ * Flowtype definitions for index
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.16.2
+ * @flow
+ */
+
+import { StorageAdapter } from '..'
+declare interface AsyncStorage {
+  getItem: (key: string) => Promise<string | null>;
+  setItem: (key: string, value: string) => Promise<void>;
+}
+declare interface AsyncStorageConfig {
+  storage: AsyncStorage;
+  serialize?: (value: any) => string;
+  deserialize?: (value: string) => any;
+}
+declare function asyncStorage(x: AsyncStorageConfig): StorageAdapter
+declare export { AsyncStorage, AsyncStorageConfig, asyncStorage }

package/async-storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/async-storage/index.ts"],"sourcesContent":["import type { StorageAdapter } from '..'\n\nexport interface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<void>\n}\n\nexport interface AsyncStorageConfig {\n  storage: AsyncStorage\n  serialize?: (value: any) => string\n  deserialize?: (value: string) => any\n}\n\n/**\n * Generic `AsyncStorage` adapter factory\n */\nexport function asyncStorage({\n  storage,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n}: AsyncStorageConfig): StorageAdapter {\n  const adapter: StorageAdapter = <State>(key: string) => ({\n    async get() {\n      const item = await storage.getItem(key)\n      return item === null ? undefined : deserialize(item)\n    },\n\n    async set(value: State) {\n      await storage.setItem(key, serialize(value))\n    },\n  })\n\n  adapter.keyArea = storage\n  return adapter\n}\n"],"names":["asyncStorage","storage","serialize","JSON","stringify","deserialize","parse","adapter","key","item","getItem","undefined","value","setItem","keyArea"],"mappings":"AAgBO,SAASA,GAAaC,QAC3BA,EAD2BC,UAE3BA,EAAYC,KAAKC,UAFUC,YAG3BA,EAAcF,KAAKG,YAEbC,EAAkCC,qBAE9BC,QAAaR,EAAQS,QAAQF,UACnB,OAATC,OAAgBE,EAAYN,EAAYI,cAGvCG,SACFX,EAAQY,QAAQL,EAAKN,EAAUU,cAIzCL,EAAQO,QAAUb,EACXM"}

package/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var r=require("effector"),e=new Map,o=r.createEvent();o.watch((r=>console.error(r.error))),exports.persist=function({adapter:t,store:a,source:i=a,target:f=a,done:n,fail:s=o,finally:d,pickup:u,key:p}){if(!t)throw Error("Adapter is not defined");if(!i)throw Error("Store or source is not defined");if(!f)throw Error("Target is not defined");if(!p&&i.shortName===i.id)throw Error("Key or name is not defined");if(i===f&&!r.is.store(i))throw Error("Source must be different from target");var l=p||i.shortName,c=function(o,t){var a=e.get(o);void 0===a&&(a=new Map,e.set(o,a));var i=a.get(t);return void 0!==i||(i=r.createStore(null),a.set(t,i)),i}(t.keyArea||t,l),v=r.createNode(),m=()=>r.clearNode(v),w=r=>({status:e,params:o,result:t,error:a})=>"done"===e?{status:e,key:l,operation:r,value:t}:{status:e,key:l,operation:r,value:o,error:a};return r.withRegion(v,(()=>{var e=r.createEffect(),o=r.createEffect(),a=r.createEvent(),p=a.filterMap((({status:r,key:e,operation:o,value:t})=>"done"===r?{key:e,operation:o,value:t}:void 0)),v=a.filterMap((({status:r,key:e,operation:o,error:t,value:a})=>"fail"===r?{key:e,operation:o,error:t,value:a}:void 0)),m=t(l,e);e.use(m.get),o.use(m.set),r.guard({source:r.sample(c,i,((r,e)=>[e,r])),filter:([r,e])=>r!==e,target:o.prepend((([r])=>r))}),r.forward({from:[e.doneData,o],to:c}),r.forward({from:[e.doneData,c],to:f}),r.forward({from:[e.finally.map(w("get")),o.finally.map(w("set"))],to:a}),r.forward({from:v,to:s}),n&&r.forward({from:p,to:n}),d&&r.forward({from:a,to:d}),u&&r.forward({from:u,to:e.prepend((()=>{}))}),e()})),m.unsubscribe=m};
+"use strict";var e=require("effector"),r=new Map,t=e.createEvent();function o(o){return a=>function({adapter:o,clock:a,store:i,source:f=i,target:s=i,done:n,fail:d=t,finally:u,pickup:p,key:c,keyPrefix:l=""}){if(!o)throw Error("Adapter is not defined");if(!f)throw Error("Store or source is not defined");if(!s)throw Error("Target is not defined");if(!c&&f.shortName===f.id)throw Error("Key or name is not defined");if(f===s&&!e.is.store(f))throw Error("Source must be different from target");var y=c||f.shortName,v=function(t,o){var a=r.get(t);void 0===a&&(a=new Map,r.set(t,a));var i=a.get(o);return void 0!==i||(i=e.createStore(null),a.set(o,i)),i}(o.keyArea||o,l+y),k=e.createNode(),m=()=>e.clearNode(k),w=e=>({status:r,params:t,result:o,error:a})=>"done"===r?{status:r,key:y,keyPrefix:l,operation:e,value:"get"===e?o:t}:{status:r,key:y,keyPrefix:l,operation:e,value:t,error:a};return e.withRegion(k,(()=>{var r=e.createEffect(),t=e.createEffect(),i=e.createEvent(),c=i.filterMap((({status:e,key:r,keyPrefix:t,operation:o,value:a})=>"done"===e?{key:r,keyPrefix:t,operation:o,value:a}:void 0)),k=i.filterMap((({status:e,key:r,keyPrefix:t,operation:o,error:a,value:i})=>"fail"===e?{key:r,keyPrefix:t,operation:o,error:a,value:i}:void 0)),m=o(l+y,r);r.use(m.get),t.use(m.set),e.guard({source:e.sample(v,e.sample(f,a),((e,r)=>[r,e])),filter:([e,r])=>e!==r,target:t.prepend((([e])=>e))}),e.forward({from:[r.doneData,t],to:v}),e.forward({from:[r.doneData,v],to:s}),e.forward({from:[r.finally.map(w("get")),t.finally.map(w("set"))],to:i}),e.forward({from:k,to:d}),n&&e.forward({from:c,to:n}),u&&e.forward({from:i,to:u}),p?e.forward({from:p,to:r.prepend((()=>{}))}):r()})),m.unsubscribe=m}({...o,...a})}t.watch((e=>console.error(e.error)));var a=o();exports.createPersist=o,exports.persist=a;
 //# sourceMappingURL=index.cjs.map

package/index.cjs.d.ts

@@ -1,4 +1,4 @@
-import { Store, Unit, Event, Effect, Subscription } from 'effector'
+import { Subscription, Unit, Store, Event, Effect } from 'effector'
 
 interface StorageAdapter {
   <State>(key: string, update: (raw?: any) => any): {
@@ -9,11 +9,13 @@ interface StorageAdapter {
 }
 declare type Done<State> = {
   key: string
+  keyPrefix: string
   operation: 'set' | 'get'
   value: State
 }
 declare type Fail<Err> = {
   key: string
+  keyPrefix: string
   operation: 'set' | 'get'
   error: Err
   value?: any
@@ -25,41 +27,59 @@ declare type Finally<State, Err> =
   | (Fail<Err> & {
       status: 'fail'
     })
-interface ConfigStore<State, Err = Error> {
+interface ConfigPersist {
+  keyPrefix?: string
+}
+interface ConfigAdapter {
   adapter: StorageAdapter
-  store: Store<State>
+}
+interface ConfigCommon<State, Err = Error> {
+  clock?: Unit<any>
   done?: Unit<Done<State>>
   fail?: Unit<Fail<Err>>
   finally?: Unit<Finally<State, Err>>
   pickup?: Unit<any>
   key?: string
+  keyPrefix?: string
 }
-interface ConfigSourceTarget<State, Err = Error> {
-  adapter: StorageAdapter
+interface ConfigJustStore<State> {
+  store: Store<State>
+}
+interface ConfigJustSourceTarget<State> {
   source: Store<State> | Event<State> | Effect<State, any, any>
   target: Store<State> | Event<State> | Effect<State, any, any>
-  done?: Unit<Done<State>>
-  fail?: Unit<Fail<Err>>
-  finally?: Unit<Finally<State, Err>>
-  pickup?: Unit<any>
-  key?: string
 }
+interface ConfigStore<State, Err = Error>
+  extends ConfigAdapter,
+    ConfigCommon<State, Err>,
+    ConfigJustStore<State> {}
+interface ConfigSourceTarget<State, Err = Error>
+  extends ConfigAdapter,
+    ConfigCommon<State, Err>,
+    ConfigJustSourceTarget<State> {}
+interface Persist {
+  <State, Err = Error>(config: ConfigSourceTarget<State, Err>): Subscription
+  <State, Err = Error>(config: ConfigStore<State, Err>): Subscription
+}
+
+/**
+ * Creates custom `persist`
+ */
+declare function createPersist(defaults?: ConfigPersist): Persist
 /**
- * Main root `persist` function
+ * Default `persist`
  */
-declare function persist<State, Err = Error>(
-  config: ConfigStore<State, Err>
-): Subscription
-declare function persist<State, Err = Error>(
-  config: ConfigSourceTarget<State, Err>
-): Subscription
+declare const persist: Persist
 
 export {
+  ConfigPersist,
   ConfigSourceTarget,
   ConfigStore,
   Done,
   Fail,
   Finally,
+  Persist,
   StorageAdapter,
+  createPersist,
   persist,
 }

package/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import type { Event, Effect, Store, Unit, Subscription } from 'effector'\nimport {\n  clearNode,\n  createEffect,\n  createEvent,\n  createNode,\n  createStore,\n  forward,\n  guard,\n  is,\n  sample,\n  withRegion,\n} from 'effector'\n\nexport interface StorageAdapter {\n  <State>(key: string, update: (raw?: any) => any): {\n    set(value: State): void\n    get(value?: any): State | Promise<State>\n  }\n  keyArea?: any\n}\n\nexport type Done<State> = {\n  key: string\n  operation: 'set' | 'get'\n  value: State\n}\n\nexport type Fail<Err> = {\n  key: string\n  operation: 'set' | 'get'\n  error: Err\n  value?: any\n}\n\nexport type Finally<State, Err> =\n  | (Done<State> & { status: 'done' })\n  | (Fail<Err> & { status: 'fail' })\n\nexport interface ConfigStore<State, Err = Error> {\n  adapter: StorageAdapter\n  store: Store<State>\n  done?: Unit<Done<State>>\n  fail?: Unit<Fail<Err>>\n  finally?: Unit<Finally<State, Err>>\n  pickup?: Unit<any>\n  key?: string\n}\n\nexport interface ConfigSourceTarget<State, Err = Error> {\n  adapter: StorageAdapter\n  source: Store<State> | Event<State> | Effect<State, any, any>\n  target: Store<State> | Event<State> | Effect<State, any, any>\n  done?: Unit<Done<State>>\n  fail?: Unit<Fail<Err>>\n  finally?: Unit<Finally<State, Err>>\n  pickup?: Unit<any>\n  key?: string\n}\n\n/**\n * Keys areas / namespaces cache\n */\nconst areas = new Map<any, Map<string, Store<any>>>()\n\n/**\n * Get store, responsible for the key in key area / namespace\n */\nfunction getAreaStorage<State>(keyArea: any, key: string): Store<State> {\n  let area = areas.get(keyArea)\n  if (area === undefined) {\n    area = new Map()\n    areas.set(keyArea, area)\n  }\n\n  let store = area.get(key)\n  if (store !== undefined) {\n    return store\n  }\n\n  store = createStore(null)\n  area.set(key, store)\n\n  return store\n}\n\n/**\n * Default sink for unhandled errors\n */\nconst sink = createEvent<Fail<any>>()\nsink.watch((payload) => console.error(payload.error))\n\n/**\n * Main root `persist` function\n */\nexport function persist<State, Err = Error>(\n  config: ConfigStore<State, Err>\n): Subscription\nexport function persist<State, Err = Error>(\n  config: ConfigSourceTarget<State, Err>\n): Subscription\nexport function persist<State, Err = Error>({\n  adapter,\n  store,\n  source = store,\n  target = store,\n  done,\n  fail = sink,\n  finally: anyway,\n  pickup,\n  key: keyName,\n}: Partial<\n  ConfigStore<State, Err> & ConfigSourceTarget<State, Err>\n>): Subscription {\n  if (!adapter) {\n    throw Error('Adapter is not defined')\n  }\n  if (!source) {\n    throw Error('Store or source is not defined')\n  }\n  if (!target) {\n    throw Error('Target is not defined')\n  }\n  if (!keyName && source.shortName === (source as any).id) {\n    throw Error('Key or name is not defined')\n  }\n  if (source === target && !is.store(source)) {\n    throw Error('Source must be different from target')\n  }\n\n  const key = keyName || source.shortName\n  const storage = getAreaStorage<State>(adapter.keyArea || adapter, key)\n  const region = createNode()\n  const desist = () => clearNode(region)\n\n  const op =\n    (operation: 'get' | 'set') =>\n    ({ status, params, result, error }: any): any =>\n      status === 'done'\n        ? { status, key, operation, value: result }\n        : { status, key, operation, value: params, error }\n\n  // create all auxiliary units and nodes within the region,\n  // to be able to remove them all at once on unsubscription\n  withRegion(region, () => {\n    const getFx = createEffect<void, State, Err>()\n    const setFx = createEffect<State, void, Err>()\n\n    const localAnyway = createEvent<Finally<State, Err>>()\n    const localDone = localAnyway.filterMap<Done<State>>(\n      ({ status, key, operation, value }) =>\n        status === 'done' ? { key, operation, value } : undefined\n    )\n    const localFail = localAnyway.filterMap<Fail<Err>>(\n      ({ status, key, operation, error, value }: any) =>\n        status === 'fail' ? { key, operation, error, value } : undefined\n    )\n\n    const value = adapter<State>(key, getFx)\n    getFx.use(value.get)\n    setFx.use(value.set)\n\n    guard({\n      source: sample<State, State, [State, State]>(\n        storage,\n        source,\n        (current: any, proposed) => [proposed, current]\n      ),\n      filter: ([proposed, current]) => proposed !== current,\n      target: setFx.prepend<[State, State]>(([proposed]) => proposed),\n    })\n    forward({ from: [getFx.doneData, setFx], to: storage })\n    forward({ from: [getFx.doneData, storage], to: target })\n    forward({\n      from: [getFx.finally.map(op('get')), setFx.finally.map(op('set'))],\n      to: localAnyway,\n    })\n\n    forward({ from: localFail, to: fail })\n    done && forward({ from: localDone, to: done })\n    anyway && forward({ from: localAnyway, to: anyway })\n\n    pickup && forward({ from: pickup, to: getFx.prepend(() => undefined) })\n\n    // kick getter to pick up initial value from storage\n    getFx()\n  })\n\n  return (desist.unsubscribe = desist)\n}\n"],"names":["areas","Map","sink","createEvent","watch","payload","console","error","adapter","store","source","target","done","fail","finally","anyway","pickup","key","keyName","Error","shortName","id","is","storage","keyArea","area","get","undefined","set","createStore","getAreaStorage","region","createNode","desist","clearNode","op","operation","status","params","result","value","withRegion","getFx","createEffect","setFx","localAnyway","localDone","filterMap","localFail","use","guard","sample","current","proposed","filter","prepend","forward","from","doneData","to","map","unsubscribe"],"mappings":"uCA+DMA,EAAQ,IAAIC,IA0BZC,EAAOC,gBACbD,EAAKE,OAAOC,GAAYC,QAAQC,MAAMF,EAAQE,yBAWvC,UAAqCC,QAC1CA,EAD0CC,MAE1CA,EAF0CC,OAG1CA,EAASD,EAHiCE,OAI1CA,EAASF,EAJiCG,KAK1CA,EAL0CC,KAM1CA,EAAOX,EACPY,QAASC,EAPiCC,OAQ1CA,EACAC,IAAKC,QAIAV,QACGW,MAAM,8BAETT,QACGS,MAAM,sCAETR,QACGQ,MAAM,6BAETD,GAAWR,EAAOU,YAAeV,EAAeW,SAC7CF,MAAM,iCAEVT,IAAWC,IAAWW,KAAGb,MAAMC,SAC3BS,MAAM,4CAGRF,EAAMC,GAAWR,EAAOU,UACxBG,EA/DR,SAA+BC,EAAcP,OACvCQ,EAAOzB,EAAM0B,IAAIF,QACRG,IAATF,IACFA,EAAO,IAAIxB,IACXD,EAAM4B,IAAIJ,EAASC,QAGjBhB,EAAQgB,EAAKC,IAAIT,eACPU,IAAVlB,IAIJA,EAAQoB,cAAY,MACpBJ,EAAKG,IAAIX,EAAKR,IAJLA,EAsDOqB,CAAsBtB,EAAQgB,SAAWhB,EAASS,GAC5Dc,EAASC,eACTC,EAAS,IAAMC,YAAUH,GAEzBI,EACHC,GACD,EAAGC,OAAAA,EAAQC,OAAAA,EAAQC,OAAAA,EAAQhC,MAAAA,KACd,SAAX8B,EACI,CAAEA,OAAAA,EAAQpB,IAAAA,EAAKmB,UAAAA,EAAWI,MAAOD,GACjC,CAAEF,OAAAA,EAAQpB,IAAAA,EAAKmB,UAAAA,EAAWI,MAAOF,EAAQ/B,MAAAA,UAIjDkC,aAAWV,GAAQ,SACXW,EAAQC,iBACRC,EAAQD,iBAERE,EAAc1C,gBACd2C,EAAYD,EAAYE,WAC5B,EAAGV,OAAAA,EAAQpB,IAAAA,EAAKmB,UAAAA,EAAWI,MAAAA,KACd,SAAXH,EAAoB,CAAEpB,IAAAA,EAAKmB,UAAAA,EAAWI,MAAAA,QAAUb,IAE9CqB,EAAYH,EAAYE,WAC5B,EAAGV,OAAAA,EAAQpB,IAAAA,EAAKmB,UAAAA,EAAW7B,MAAAA,EAAOiC,MAAAA,KACrB,SAAXH,EAAoB,CAAEpB,IAAAA,EAAKmB,UAAAA,EAAW7B,MAAAA,EAAOiC,MAAAA,QAAUb,IAGrDa,EAAQhC,EAAeS,EAAKyB,GAClCA,EAAMO,IAAIT,EAAMd,KAChBkB,EAAMK,IAAIT,EAAMZ,KAEhBsB,QAAM,CACJxC,OAAQyC,SACN5B,EACAb,GACA,CAAC0C,EAAcC,IAAa,CAACA,EAAUD,KAEzCE,OAAQ,EAAED,EAAUD,KAAaC,IAAaD,EAC9CzC,OAAQiC,EAAMW,SAAwB,EAAEF,KAAcA,MAExDG,UAAQ,CAAEC,KAAM,CAACf,EAAMgB,SAAUd,GAAQe,GAAIpC,IAC7CiC,UAAQ,CAAEC,KAAM,CAACf,EAAMgB,SAAUnC,GAAUoC,GAAIhD,IAC/C6C,UAAQ,CACNC,KAAM,CAACf,EAAM5B,QAAQ8C,IAAIzB,EAAG,QAASS,EAAM9B,QAAQ8C,IAAIzB,EAAG,SAC1DwB,GAAId,IAGNW,UAAQ,CAAEC,KAAMT,EAAWW,GAAI9C,IAC/BD,GAAQ4C,UAAQ,CAAEC,KAAMX,EAAWa,GAAI/C,IACvCG,GAAUyC,UAAQ,CAAEC,KAAMZ,EAAac,GAAI5C,IAE3CC,GAAUwC,UAAQ,CAAEC,KAAMzC,EAAQ2C,GAAIjB,EAAMa,SAAQ,WAGpDb,OAGMT,EAAO4B,YAAc5B"}
+{"version":3,"file":"index.cjs","sources":["../src/area.ts","../src/persist.ts","../src/index.ts"],"sourcesContent":["import type { Store } from 'effector'\nimport { createStore } from 'effector'\n\n/**\n * Keys areas / namespaces cache\n */\nconst areas = new Map<any, Map<string, Store<any>>>()\n\n/**\n * Get store, responsible for the key in key area / namespace\n */\nexport function getAreaStorage<State>(keyArea: any, key: string): Store<State> {\n  let area = areas.get(keyArea)\n  if (area === undefined) {\n    area = new Map()\n    areas.set(keyArea, area)\n  }\n\n  let store = area.get(key)\n  if (store !== undefined) {\n    return store\n  }\n\n  store = createStore(null)\n  area.set(key, store)\n\n  return store\n}\n","import type { Subscription } from 'effector'\nimport type {\n  ConfigPersist,\n  ConfigSourceTarget,\n  ConfigStore,\n  Done,\n  Fail,\n  Finally,\n} from './types'\nimport {\n  clearNode,\n  createEffect,\n  createEvent,\n  createNode,\n  forward,\n  guard,\n  is,\n  sample,\n  withRegion,\n} from 'effector'\nimport { getAreaStorage } from './area'\n\n/**\n * Default sink for unhandled errors\n */\nconst sink = createEvent<Fail<any>>()\nsink.watch((payload) => console.error(payload.error))\n\n/**\n * Main `persist` function\n */\nexport function persist<State, Err = Error>({\n  adapter,\n  clock,\n  store,\n  source = store,\n  target = store,\n  done,\n  fail = sink,\n  finally: anyway,\n  pickup,\n  key: keyName,\n  keyPrefix = '',\n}: Partial<\n  ConfigPersist & ConfigStore<State, Err> & ConfigSourceTarget<State, Err>\n>): Subscription {\n  if (!adapter) {\n    throw Error('Adapter is not defined')\n  }\n  if (!source) {\n    throw Error('Store or source is not defined')\n  }\n  if (!target) {\n    throw Error('Target is not defined')\n  }\n  if (!keyName && source.shortName === (source as any).id) {\n    throw Error('Key or name is not defined')\n  }\n  if (source === target && !is.store(source)) {\n    throw Error('Source must be different from target')\n  }\n\n  const key = keyName || source.shortName\n  const storage = getAreaStorage<State>(\n    adapter.keyArea || adapter,\n    keyPrefix + key\n  )\n  const region = createNode()\n  const desist = () => clearNode(region)\n\n  const op =\n    (operation: 'get' | 'set') =>\n    ({ status, params, result, error }: any): any =>\n      status === 'done'\n        ? {\n            status,\n            key,\n            keyPrefix,\n            operation,\n            value: operation === 'get' ? result : params,\n          }\n        : {\n            status,\n            key,\n            keyPrefix,\n            operation,\n            value: params,\n            error,\n          }\n\n  // create all auxiliary units and nodes within the region,\n  // to be able to remove them all at once on unsubscription\n  withRegion(region, () => {\n    const getFx = createEffect<void, State, Err>()\n    const setFx = createEffect<State, void, Err>()\n\n    const localAnyway = createEvent<Finally<State, Err>>()\n    const localDone = localAnyway.filterMap<Done<State>>(\n      ({ status, key, keyPrefix, operation, value }) =>\n        status === 'done' ? { key, keyPrefix, operation, value } : undefined\n    )\n    const localFail = localAnyway.filterMap<Fail<Err>>(\n      ({ status, key, keyPrefix, operation, error, value }: any) =>\n        status === 'fail'\n          ? { key, keyPrefix, operation, error, value }\n          : undefined\n    )\n\n    const value = adapter<State>(keyPrefix + key, getFx)\n    getFx.use(value.get)\n    setFx.use(value.set)\n\n    guard({\n      source: sample<State, State, [State, State]>(\n        storage,\n        (sample as any)(source, clock),\n        (current: any, proposed) => [proposed, current]\n      ),\n      filter: ([proposed, current]) => proposed !== current,\n      target: setFx.prepend<[State, State]>(([proposed]) => proposed),\n    })\n    forward({ from: [getFx.doneData, setFx], to: storage })\n    forward({ from: [getFx.doneData, storage], to: target })\n    forward({\n      from: [getFx.finally.map(op('get')), setFx.finally.map(op('set'))],\n      to: localAnyway,\n    })\n\n    forward({ from: localFail, to: fail })\n    if (done) forward({ from: localDone, to: done })\n    if (anyway) forward({ from: localAnyway, to: anyway })\n\n    if (pickup) {\n      // pick up value from storage ONLY on `pickup` update\n      forward({ from: pickup, to: getFx.prepend(() => undefined) })\n    } else {\n      // kick getter to pick up initial value from storage\n      getFx()\n    }\n  })\n\n  return (desist.unsubscribe = desist)\n}\n","import type { ConfigPersist, Persist } from './types'\nimport { persist as base } from './persist'\n\nexport type {\n  ConfigPersist,\n  ConfigSourceTarget,\n  ConfigStore,\n  Done,\n  Fail,\n  Finally,\n  Persist,\n  StorageAdapter,\n} from './types'\n\n/**\n * Creates custom `persist`\n */\nexport function createPersist(defaults?: ConfigPersist): Persist {\n  return (config) => base({ ...defaults, ...config })\n}\n\n/**\n * Default `persist`\n */\nexport const persist = createPersist()\n"],"names":["areas","Map","sink","createEvent","createPersist","defaults","config","adapter","clock","store","source","target","done","fail","finally","anyway","pickup","key","keyName","keyPrefix","Error","shortName","id","is","storage","keyArea","area","get","undefined","set","createStore","getAreaStorage","region","createNode","desist","clearNode","op","operation","status","params","result","error","value","withRegion","getFx","createEffect","setFx","localAnyway","localDone","filterMap","localFail","use","guard","sample","current","proposed","filter","prepend","forward","from","doneData","to","map","unsubscribe","base","watch","payload","console","persist"],"mappings":"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"}

package/index.d.ts

@@ -1,4 +1,4 @@
-import { Store, Unit, Event, Effect, Subscription } from 'effector'
+import { Subscription, Unit, Store, Event, Effect } from 'effector'
 
 interface StorageAdapter {
   <State>(key: string, update: (raw?: any) => any): {
@@ -9,11 +9,13 @@ interface StorageAdapter {
 }
 declare type Done<State> = {
   key: string
+  keyPrefix: string
   operation: 'set' | 'get'
   value: State
 }
 declare type Fail<Err> = {
   key: string
+  keyPrefix: string
   operation: 'set' | 'get'
   error: Err
   value?: any
@@ -25,41 +27,59 @@ declare type Finally<State, Err> =
   | (Fail<Err> & {
       status: 'fail'
     })
-interface ConfigStore<State, Err = Error> {
+interface ConfigPersist {
+  keyPrefix?: string
+}
+interface ConfigAdapter {
   adapter: StorageAdapter
-  store: Store<State>
+}
+interface ConfigCommon<State, Err = Error> {
+  clock?: Unit<any>
   done?: Unit<Done<State>>
   fail?: Unit<Fail<Err>>
   finally?: Unit<Finally<State, Err>>
   pickup?: Unit<any>
   key?: string
+  keyPrefix?: string
 }
-interface ConfigSourceTarget<State, Err = Error> {
-  adapter: StorageAdapter
+interface ConfigJustStore<State> {
+  store: Store<State>
+}
+interface ConfigJustSourceTarget<State> {
   source: Store<State> | Event<State> | Effect<State, any, any>
   target: Store<State> | Event<State> | Effect<State, any, any>
-  done?: Unit<Done<State>>
-  fail?: Unit<Fail<Err>>
-  finally?: Unit<Finally<State, Err>>
-  pickup?: Unit<any>
-  key?: string
 }
+interface ConfigStore<State, Err = Error>
+  extends ConfigAdapter,
+    ConfigCommon<State, Err>,
+    ConfigJustStore<State> {}
+interface ConfigSourceTarget<State, Err = Error>
+  extends ConfigAdapter,
+    ConfigCommon<State, Err>,
+    ConfigJustSourceTarget<State> {}
+interface Persist {
+  <State, Err = Error>(config: ConfigSourceTarget<State, Err>): Subscription
+  <State, Err = Error>(config: ConfigStore<State, Err>): Subscription
+}
+
+/**
+ * Creates custom `persist`
+ */
+declare function createPersist(defaults?: ConfigPersist): Persist
 /**
- * Main root `persist` function
+ * Default `persist`
  */
-declare function persist<State, Err = Error>(
-  config: ConfigStore<State, Err>
-): Subscription
-declare function persist<State, Err = Error>(
-  config: ConfigSourceTarget<State, Err>
-): Subscription
+declare const persist: Persist
 
 export {
+  ConfigPersist,
   ConfigSourceTarget,
   ConfigStore,
   Done,
   Fail,
   Finally,
+  Persist,
   StorageAdapter,
+  createPersist,
   persist,
 }

package/index.js

@@ -1,2 +1,2 @@
-import{createEvent as r,is as e,createNode as o,withRegion as t,createEffect as a,guard as i,sample as n,forward as s,createStore as f,clearNode as u}from"effector";var d=new Map,p=r();function l({adapter:l,store:m,source:v=m,target:y=m,done:c,fail:k=p,finally:g,pickup:h,key:w}){if(!l)throw Error("Adapter is not defined");if(!v)throw Error("Store or source is not defined");if(!y)throw Error("Target is not defined");if(!w&&v.shortName===v.id)throw Error("Key or name is not defined");if(v===y&&!e.store(v))throw Error("Source must be different from target");var E=w||v.shortName,M=function(r,e){var o=d.get(r);void 0===o&&(o=new Map,d.set(r,o));var t=o.get(e);return void 0!==t||(t=f(null),o.set(e,t)),t}(l.keyArea||l,E),b=o(),A=()=>u(b),D=r=>({status:e,params:o,result:t,error:a})=>"done"===e?{status:e,key:E,operation:r,value:t}:{status:e,key:E,operation:r,value:o,error:a};return t(b,(()=>{var e=a(),o=a(),t=r(),f=t.filterMap((({status:r,key:e,operation:o,value:t})=>"done"===r?{key:e,operation:o,value:t}:void 0)),u=t.filterMap((({status:r,key:e,operation:o,error:t,value:a})=>"fail"===r?{key:e,operation:o,error:t,value:a}:void 0)),d=l(E,e);e.use(d.get),o.use(d.set),i({source:n(M,v,((r,e)=>[e,r])),filter:([r,e])=>r!==e,target:o.prepend((([r])=>r))}),s({from:[e.doneData,o],to:M}),s({from:[e.doneData,M],to:y}),s({from:[e.finally.map(D("get")),o.finally.map(D("set"))],to:t}),s({from:u,to:k}),c&&s({from:f,to:c}),g&&s({from:t,to:g}),h&&s({from:h,to:e.prepend((()=>{}))}),e()})),A.unsubscribe=A}p.watch((r=>console.error(r.error)));export{l as persist};
+import{createStore as e,createEvent as r,is as o,createNode as t,clearNode as a,withRegion as i,createEffect as f,guard as n,sample as s,forward as u}from"effector";var d=new Map,p=r();function l(l){return y=>function({adapter:l,clock:y,store:k,source:m=k,target:v=k,done:c,fail:g=p,finally:h,pickup:w,key:x,keyPrefix:P=""}){if(!l)throw Error("Adapter is not defined");if(!m)throw Error("Store or source is not defined");if(!v)throw Error("Target is not defined");if(!x&&m.shortName===m.id)throw Error("Key or name is not defined");if(m===v&&!o.store(m))throw Error("Source must be different from target");var E=x||m.shortName,M=function(r,o){var t=d.get(r);void 0===t&&(t=new Map,d.set(r,t));var a=t.get(o);return void 0!==a||(a=e(null),t.set(o,a)),a}(l.keyArea||l,P+E),b=t(),A=()=>a(b),D=e=>({status:r,params:o,result:t,error:a})=>"done"===r?{status:r,key:E,keyPrefix:P,operation:e,value:"get"===e?t:o}:{status:r,key:E,keyPrefix:P,operation:e,value:o,error:a};return i(b,(()=>{var e=f(),o=f(),t=r(),a=t.filterMap((({status:e,key:r,keyPrefix:o,operation:t,value:a})=>"done"===e?{key:r,keyPrefix:o,operation:t,value:a}:void 0)),i=t.filterMap((({status:e,key:r,keyPrefix:o,operation:t,error:a,value:i})=>"fail"===e?{key:r,keyPrefix:o,operation:t,error:a,value:i}:void 0)),d=l(P+E,e);e.use(d.get),o.use(d.set),n({source:s(M,s(m,y),((e,r)=>[r,e])),filter:([e,r])=>e!==r,target:o.prepend((([e])=>e))}),u({from:[e.doneData,o],to:M}),u({from:[e.doneData,M],to:v}),u({from:[e.finally.map(D("get")),o.finally.map(D("set"))],to:t}),u({from:i,to:g}),c&&u({from:a,to:c}),h&&u({from:t,to:h}),w?u({from:w,to:e.prepend((()=>{}))}):e()})),A.unsubscribe=A}({...l,...y})}p.watch((e=>console.error(e.error)));var y=l();export{l as createPersist,y as persist};
 //# sourceMappingURL=index.js.map