effector-storage 7.1.1 → 8.0.0

package/core/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var e=require("effector"),r=new Map,t=e=>([r],t)=>e(t,r),a=e.createEvent();a.watch((e=>console.error(e.error))),exports.persist=function(o){var{adapter:i,store:s,source:c=s,target:n=s,clock:f=c,done:l,fail:d=a,finally:u,pickup:p,context:k,key:v,keyPrefix:g="",contract:y}=o;if(!i)throw Error("Adapter is not defined");if(!c)throw Error("Store or source is not defined");if(!n)throw Error("Target is not defined");if(!v&&c.shortName===c.id)throw Error("Key or name is not defined");if(c===n&&!e.is.store(c))throw Error("Source must be different from target");void 0===o.def&&e.is.store(c)&&(o.def=c.defaultState);var m="factory"in i?i(o):i,h=v||c.shortName,w=function(t,a){var o=r.get(t);void 0===o&&(o=new Map,r.set(t,o));var i=o.get(a);return void 0!==i||(i=e.createStore(null,{serialize:"ignore"}),o.set(a,i)),i}(m.keyArea||m,g+h),E=e.createNode(),x=()=>e.clearNode(E),P=e=>({status:r="fail",params:t,result:a,error:o})=>"done"===r?{status:r,key:h,keyPrefix:g,operation:e,value:"get"===e?a:t}:{status:r,key:h,keyPrefix:g,operation:e,value:"function"==typeof t?void 0:t,error:o};return e.withRegion(E,(()=>{var r=e.createStore([],{serialize:"ignore"}),a=m(g+h,(e=>{x(e)})),o=e.attach({source:r,effect:t(a.get)}),i=e.attach({source:r,effect:t(a.set)}),s=e.createEffect((e=>r=>!e||void 0===r||("isData"in e?e.isData(r):e(r))?r:(()=>{throw"getErrorMessages"in e?e.getErrorMessages(r):void 0})())(y)),v=e.createEvent(),E=e.createEvent(),x=o;r.updates.watch((()=>{x=e.scopeBind(o,{safe:!0})})),e.sample({clock:f,source:c,target:E}),e.sample({clock:E,source:w,filter:(e,r)=>r!==e,fn:(e,r)=>r,target:i}),e.sample({clock:[o.doneData,e.sample(i,i.done)],filter:e=>void 0!==e,target:w}),e.sample({clock:[o.doneData,w],target:s}),e.sample({clock:s.doneData,filter:e=>void 0!==e,target:n}),e.sample({clock:[o.finally.map(P("get")),i.finally.map(P("set")),s.fail.map(P("validate"))],target:v}),u&&e.sample({clock:v,target:u}),l&&e.sample({clock:v,filter:({status:e})=>"done"===e,fn:({key:e,keyPrefix:r,operation:t,value:a})=>({key:e,keyPrefix:r,operation:t,value:a}),target:l}),e.sample({clock:v,filter:({status:e})=>"fail"===e,fn:({key:e,keyPrefix:r,operation:t,error:a,value:o})=>({key:e,keyPrefix:r,operation:t,error:a,value:o}),target:d}),k&&r.on(k,(([e],r)=>[void 0===r?e:r])),p?(e.sample({clock:p,fn:()=>{},target:o}),r.on(p,(([e],r)=>[void 0===r?e:r]))):o()})),x.unsubscribe=x};
+"use strict";var e=require("effector"),t=new Map,r=e.createEvent();r.watch(e=>console.error(e.error)),exports.persist=a=>{var{adapter:o,store:i,source:s=i,target:n=i,clock:f=s,done:c,fail:l=r,finally:d,pickup:u,context:p,key:v,keyPrefix:k="",contract:y}=a;if(!o)throw Error("Adapter is not defined");if(!s)throw Error("Store or source is not defined");if(!n)throw Error("Target is not defined");if(!v&&s.shortName===s.id)throw Error("Key or name is not defined");if(s===n&&!e.is.store(s))throw Error("Source must be different from target");void 0===a.def&&e.is.store(s)&&(a.def=s.defaultState);var g="factory"in o?o(a):o,m=v||s.shortName,h=((r,a)=>{var o=t.get(r);void 0===o&&(o=new Map,t.set(r,o));var i=o.get(a);return void 0!==i||(i=e.createStore(null,{serialize:"ignore"}),o.set(a,i)),i})(g.keyArea||g,k+m),w=e.createNode(),E=()=>{},x=()=>E(e.clearNode(w)),P=e=>({status:t="fail",params:r,result:a,error:o})=>"done"===t?{status:t,key:m,keyPrefix:k,operation:e,value:"get"===e?a:r}:{status:t,key:m,keyPrefix:k,operation:e,value:"function"==typeof r?void 0:r,error:o};return e.withRegion(w,()=>{var t=e.createStore([e.is.store(p)?p.defaultState:void 0],{serialize:"ignore"}),r=g(k+m,e=>{x(e)});"function"==typeof r&&(E=r);var a=e.attach({source:t,effect:([e],t)=>r.get(t,e)}),o=e.attach({source:t,effect:([e],t)=>r.set(t,e)}),i=e.createEffect(e=>void 0===e?e:((e,t)=>{if(!t)return e;if("function"!=typeof t&&"object"!=typeof t)throw["Invalid contract"];if("isData"in t){if(t.isData(e))return e;throw t.getErrorMessages(e)}if("~standard"in t){var r=t["~standard"].validate(e),a=t=>{if(t.issues)throw t.issues;return e};return"then"in r?Promise.resolve(r).then(a):a(r)}if("function"==typeof t){if(t(e))return e;throw["Invalid data"]}throw["Invalid contract"]})(e,y)),v=e.createEvent(),w=e.createEvent(),x=a;t.updates.watch(()=>{x=e.scopeBind(a,{safe:!0})}),e.sample({clock:f,source:s,target:w}),e.sample({clock:w,source:h,filter:(e,t)=>t!==e,fn:(e,t)=>t,target:o}),e.sample({clock:[a.doneData,e.sample(o,o.done)],filter:e=>void 0!==e,target:h}),e.sample({clock:[a.doneData,h],target:i}),e.sample({clock:i.doneData,filter:e=>void 0!==e,target:n}),e.sample({clock:[a.finally.map(P("get")),o.finally.map(P("set")),i.fail.map(P("validate"))],target:v}),d&&e.sample({clock:v,target:d}),c&&e.sample({clock:v,filter:e=>"done"===e.status,fn:({key:e,keyPrefix:t,operation:r,value:a})=>({key:e,keyPrefix:t,operation:r,value:a}),target:c}),e.sample({clock:v,filter:e=>"fail"===e.status,fn:({key:e,keyPrefix:t,operation:r,error:a,value:o})=>({key:e,keyPrefix:t,operation:r,error:a,value:o}),target:l}),p&&t.on(p,([e],t)=>[void 0===t?e:t]),u?(e.sample({clock:u,fn:()=>{},target:a}),t.on(u,([e],t)=>[void 0===t?e:t])):a()}),x.unsubscribe=x};
 //# sourceMappingURL=index.cjs.map

package/core/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/core/area.ts","../../src/core/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, { serialize: 'ignore' })\n  area.set(key, store)\n\n  return store\n}\n","import type { Effect, Subscription, Unit } from 'effector'\nimport type {\n  ConfigAdapter,\n  ConfigAdapterFactory,\n  ConfigPersist,\n  ConfigSourceTarget,\n  ConfigStore,\n  Contract,\n  Done,\n  Fail,\n  Finally,\n} from '../types'\nimport {\n  attach,\n  clearNode,\n  createEvent,\n  createEffect,\n  createNode,\n  createStore,\n  is,\n  sample,\n  scopeBind,\n  withRegion,\n} from 'effector'\nimport { getAreaStorage } from './area'\n\n// helper function to swap two function arguments\n// end extract current context from ref-box\nconst contextual =\n  <T, C, R>(fn: (value: T, ctx?: C) => R) =>\n  ([ref]: [C?], value: T) =>\n    fn(value, ref)\n\n// helper function to validate data with contract\nconst contracted =\n  <T>(contract?: Contract<T>) =>\n  (raw: unknown) =>\n    !contract || // no contract -> data is valid\n    raw === undefined || // `undefined` is always valid\n    ('isData' in contract ? contract.isData(raw) : contract(raw))\n      ? (raw as T)\n      : (() => {\n          throw 'getErrorMessages' in contract\n            ? contract.getErrorMessages(raw)\n            : undefined\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 `persist` function\n */\nexport function persist<State, Err = Error>(\n  config: Partial<\n    (ConfigAdapter | ConfigAdapterFactory<any>) &\n      ConfigPersist &\n      ConfigStore<State, Err> &\n      ConfigSourceTarget<State, Err>\n  >\n): Subscription {\n  const {\n    adapter: adapterOrFactory,\n    store,\n    source = store,\n    target = store,\n    clock = source,\n    done,\n    fail = sink,\n    finally: anyway,\n    pickup,\n    context,\n    key: keyName,\n    keyPrefix = '',\n    contract,\n  } = config\n\n  if (!adapterOrFactory) {\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  // get default value from store, if given\n  // this is used in adapter factory\n  if ((config as any).def === undefined && is.store(source)) {\n    ;(config as any).def = source.defaultState\n  }\n\n  const adapter =\n    'factory' in adapterOrFactory ? adapterOrFactory(config) : adapterOrFactory\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' | 'validate') =>\n    ({ status = 'fail', 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: typeof params === 'function' ? undefined : params, // hide internal \"box\" implementation\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 ctx = createStore<[any?]>([], { serialize: 'ignore' })\n\n    const value = adapter<State>(keyPrefix + key, (x) => {\n      update(x)\n    })\n\n    const getFx = attach({\n      source: ctx,\n      effect: contextual(value.get),\n    }) as any as Effect<void, State, Err>\n\n    const setFx = attach({\n      source: ctx,\n      effect: contextual(value.set),\n    }) as any as Effect<State, void, Err>\n\n    const validateFx = createEffect<unknown, State>(contracted(contract))\n\n    const complete = createEvent<Finally<State, Err>>()\n\n    const trigger = createEvent<State>()\n\n    let update: (raw?: any) => any = getFx\n    ctx.updates.watch(() => {\n      update = scopeBind(getFx as any, { safe: true })\n    })\n\n    sample({\n      clock, // `clock` is always defined, as long as `source` is defined\n      source,\n      target: trigger,\n    } as any)\n\n    sample({\n      clock: trigger,\n      source: storage,\n      filter: (current, proposed) => proposed !== current,\n      fn: (_, proposed) => proposed,\n      target: setFx,\n    })\n\n    sample({\n      clock: [getFx.doneData, sample(setFx, setFx.done)],\n      filter: <T>(x?: T | undefined): x is T => x !== undefined,\n      target: storage as any,\n    })\n\n    sample({\n      clock: [getFx.doneData, storage],\n      target: validateFx as any,\n    })\n\n    sample({\n      clock: validateFx.doneData,\n      filter: <T>(x?: T | undefined): x is T => x !== undefined,\n      target: target as any,\n    })\n\n    sample({\n      clock: [\n        getFx.finally.map(op('get')),\n        setFx.finally.map(op('set')),\n        validateFx.fail.map(op('validate')),\n      ],\n      target: complete,\n    })\n\n    // effector 23 introduced \"targetable\" types - UnitTargetable, StoreWritable, EventCallable\n    // so, targeting non-targetable unit is not allowed anymore.\n    // soothe typescript by casting to any for a while, until we drop support for effector 22 branch\n    if (anyway) {\n      sample({\n        clock: complete,\n        target: anyway as any,\n      })\n    }\n\n    if (done) {\n      sample({\n        clock: complete,\n        filter: ({ status }) => status === 'done',\n        fn: ({ key, keyPrefix, operation, value }): Done<State> => ({\n          key,\n          keyPrefix,\n          operation,\n          value,\n        }),\n        target: done as any,\n      })\n    }\n\n    sample({\n      clock: complete,\n      filter: ({ status }) => status === 'fail',\n      fn: ({ key, keyPrefix, operation, error, value }: any): Fail<Err> => ({\n        key,\n        keyPrefix,\n        operation,\n        error,\n        value,\n      }),\n      target: fail as any,\n    })\n\n    if (context) {\n      ctx.on(context, ([ref], payload) => [\n        payload === undefined ? ref : payload,\n      ])\n    }\n\n    if (pickup) {\n      // pick up value from storage ONLY on `pickup` update\n      sample({ clock: pickup as Unit<any>, fn: () => undefined, target: getFx })\n      ctx.on(pickup as Unit<any>, ([ref], payload) => [\n        payload === undefined ? ref : payload,\n      ])\n    } else {\n      // kick getter to pick up initial value from storage\n      getFx()\n    }\n  })\n\n  return (desist.unsubscribe = desist)\n}\n"],"names":["areas","Map","contextual","fn","ref","value","sink","createEvent","watch","payload","console","error","config","adapter","adapterOrFactory","store","source","target","clock","done","fail","finally","anyway","pickup","context","key","keyName","keyPrefix","contract","Error","shortName","id","is","undefined","def","defaultState","storage","keyArea","area","get","set","createStore","serialize","getAreaStorage","region","createNode","desist","clearNode","op","operation","status","params","result","withRegion","ctx","x","update","getFx","attach","effect","setFx","validateFx","createEffect","raw","isData","getErrorMessages","contracted","complete","trigger","updates","scopeBind","safe","sample","filter","current","proposed","_","doneData","map","on","unsubscribe"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../src/core/area.ts","../../src/core/persist.ts","../../src/core/validate.ts"],"sourcesContent":["import type { StoreWritable } from 'effector'\nimport { createStore } from 'effector'\n\n/**\n * Keys areas / namespaces cache\n */\nconst areas = new Map<any, Map<string, StoreWritable<any>>>()\n\n/**\n * Get store, responsible for the key in key area / namespace\n */\nexport const getAreaStorage = <State>(\n  keyArea: any,\n  key: string\n): StoreWritable<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, { serialize: 'ignore' })\n  area.set(key, store)\n\n  return store\n}\n","import type { Effect, Event, Subscription, Unit } from 'effector'\nimport type {\n  ConfigAdapter,\n  ConfigAdapterFactory,\n  ConfigPersist,\n  ConfigSourceTarget,\n  ConfigStore,\n  Done,\n  Fail,\n  Finally,\n  FinallyDone,\n  FinallyFail,\n} from '../types'\nimport {\n  attach,\n  clearNode,\n  createEffect,\n  createEvent,\n  createNode,\n  createStore,\n  is,\n  sample,\n  scopeBind,\n  withRegion,\n} from 'effector'\nimport { getAreaStorage } from './area'\nimport { validate } from './validate'\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 const persist = <State, Err = Error>(\n  config: Partial<\n    (ConfigAdapter | ConfigAdapterFactory<any>) &\n      ConfigPersist &\n      ConfigStore<State, Err> &\n      ConfigSourceTarget<State, Err>\n  >\n): Subscription => {\n  const {\n    adapter: adapterOrFactory,\n    store,\n    source = store,\n    target = store,\n    clock = source,\n    done,\n    fail = sink,\n    finally: anyway,\n    pickup,\n    context,\n    key: keyName,\n    keyPrefix = '',\n    contract,\n  } = config\n\n  if (!adapterOrFactory) {\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  // get default value from store, if given\n  // this is used in adapter factory\n  if ((config as any).def === undefined && is.store(source)) {\n    ;(config as any).def = source.defaultState\n  }\n\n  const adapter =\n    'factory' in adapterOrFactory ? adapterOrFactory(config) : adapterOrFactory\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  let disposable: (_: any) => void = () => {}\n  const desist = () => disposable(clearNode(region))\n\n  const op =\n    (operation: 'get' | 'set' | 'validate') =>\n    ({ status = 'fail', 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: typeof params === 'function' ? undefined : params, // hide internal \"box\" implementation\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 ctx = createStore<[any?]>(\n      [is.store(context) ? context.defaultState : undefined],\n      { serialize: 'ignore' }\n    )\n\n    const value = adapter<State>(keyPrefix + key, (x) => {\n      update(x)\n    })\n\n    if (typeof value === 'function') {\n      disposable = value\n    }\n\n    const getFx = attach({\n      source: ctx,\n      effect: ([ref], raw?: any) => value.get(raw, ref),\n    }) as Effect<void, State, Err>\n\n    const setFx = attach({\n      source: ctx,\n      effect: ([ref], state: State) => value.set(state, ref),\n    }) as Effect<State, void, Err>\n\n    const validateFx = createEffect<unknown, State>((raw) =>\n      raw === undefined // `undefined` is always valid\n        ? raw\n        : validate(raw, contract)\n    )\n\n    const complete = createEvent<Finally<State, Err>>()\n\n    const trigger = createEvent<State>()\n\n    let update: (raw?: any) => any = getFx\n    ctx.updates.watch(() => {\n      update = scopeBind(getFx, { safe: true })\n    })\n\n    sample({\n      clock, // `clock` is always defined, as long as `source` is defined\n      source,\n      target: trigger,\n    } as any)\n\n    sample({\n      clock: trigger,\n      source: storage,\n      filter: (current, proposed) => proposed !== current,\n      fn: (_, proposed) => proposed,\n      target: setFx,\n    })\n\n    sample({\n      clock: [getFx.doneData as Event<any>, sample(setFx, setFx.done)],\n      filter: (x) => x !== undefined,\n      target: storage,\n    })\n\n    sample({\n      clock: [getFx.doneData as Event<any>, storage],\n      target: validateFx,\n    })\n\n    sample({\n      clock: validateFx.doneData,\n      filter: (x) => x !== undefined,\n      target: target as any,\n    })\n\n    sample({\n      clock: [\n        getFx.finally.map(op('get')),\n        setFx.finally.map(op('set')),\n        validateFx.fail.map(op('validate')),\n      ],\n      target: complete,\n    })\n\n    if (anyway) {\n      sample({\n        clock: complete,\n        target: anyway,\n      })\n    }\n\n    if (done) {\n      sample({\n        clock: complete,\n        filter: (payload: Finally<State, Err>): payload is FinallyDone<State> =>\n          payload.status === 'done',\n        fn: ({ key, keyPrefix, operation, value }): Done<State> => ({\n          key,\n          keyPrefix,\n          operation,\n          value,\n        }),\n        target: done,\n      })\n    }\n\n    sample({\n      clock: complete,\n      filter: (payload: Finally<State, Err>): payload is FinallyFail<Err> =>\n        payload.status === 'fail',\n      fn: ({ key, keyPrefix, operation, error, value }): Fail<Err> => ({\n        key,\n        keyPrefix,\n        operation,\n        error,\n        value,\n      }),\n      target: fail,\n    })\n\n    if (context) {\n      ctx.on(context, ([ref], payload) => [\n        payload === undefined ? ref : payload,\n      ])\n    }\n\n    if (pickup) {\n      // pick up value from storage ONLY on `pickup` update\n      sample({ clock: pickup as Unit<any>, fn: () => undefined, target: getFx })\n      ctx.on(pickup as Unit<any>, ([ref], payload) => [\n        payload === undefined ? ref : payload,\n      ])\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 { Contract } from '../types'\nimport type { StandardSchemaV1 } from '../types-standard-schema'\n\nexport const validate = <Data>(\n  raw: unknown,\n  contract?: Contract<Data>\n): Data | Promise<Data> => {\n  // no contract -> data is valid\n  if (!contract) {\n    return raw as Data\n  }\n\n  // contract is not a function nor object\n  if (typeof contract !== 'function' && typeof contract !== 'object') {\n    throw ['Invalid contract']\n  }\n\n  // contract is a Contract protocol\n  if ('isData' in contract) {\n    if (contract.isData(raw)) {\n      return raw as Data\n    }\n    throw contract.getErrorMessages(raw)\n  }\n\n  // contract is a Standard Schema\n  if ('~standard' in contract) {\n    const result = contract['~standard'].validate(raw)\n\n    const check = (result: StandardSchemaV1.Result<Data>) => {\n      if (result.issues) throw result.issues\n\n      // return original raw value, same by reference, if validation passed\n      // this means that transformations are not supported!\n      return raw as Data // not `result.value`\n    }\n\n    return 'then' in result\n      ? Promise.resolve(result).then(check)\n      : check(result)\n  }\n\n  // contract is a simple 'type guard'-like function\n  if (typeof contract === 'function') {\n    if (contract(raw)) {\n      return raw as Data\n    }\n    throw ['Invalid data']\n  }\n\n  // if contract is not supported, throw an error\n  throw ['Invalid contract']\n}\n"],"names":["areas","Map","sink","createEvent","watch","payload","console","error","config","adapter","adapterOrFactory","store","source","target","clock","done","fail","finally","anyway","pickup","context","key","keyName","keyPrefix","contract","Error","shortName","id","is","undefined","def","defaultState","storage","getAreaStorage","keyArea","area","get","set","createStore","serialize","region","createNode","disposable","desist","clearNode","op","operation","status","params","result","value","withRegion","ctx","x","update","getFx","attach","effect","ref","raw","setFx","state","validateFx","createEffect","validate","isData","getErrorMessages","check","issues","Promise","resolve","then","complete","trigger","updates","scopeBind","safe","sample","filter","current","proposed","fn","_","doneData","map","on","unsubscribe"],"mappings":"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"}

package/core/index.d.cts

@@ -1,21 +1,97 @@
-import { Unit, Store, Event, Effect, Subscription } from 'effector';
+import { Unit, UnitTargetable, StoreWritable, Store, Event, Effect, EventCallable, Subscription } from 'effector';
 
+/** The Contract interface. */
+interface Contract$1<Raw, Data extends Raw> {
+    /**
+     * Checks if Raw is Data
+     */
+    isData: (prepared: Raw) => prepared is Data;
+    /**
+     * - empty array is dedicated for valid response
+     * - array of string with validation erorrs for invalidDataError
+     */
+    getErrorMessages: (prepared: Raw) => string[];
+}
+
+/** The Standard Schema interface. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema properties. */
+    readonly '~standard': StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+    /** The Standard Schema properties interface. */
+    interface Props<Input = unknown, Output = Input> {
+        /** The version number of the standard. */
+        readonly version: 1;
+        /** The vendor name of the schema library. */
+        readonly vendor: string;
+        /** Validates unknown input values. */
+        readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
+        /** Inferred types associated with the schema. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** The result interface of the validate function. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** The result interface if validation succeeds. */
+    interface SuccessResult<Output> {
+        /** The typed output value. */
+        readonly value: Output;
+        /** A falsy value for `issues` indicates success. */
+        readonly issues?: undefined;
+    }
+    interface Options {
+        /** Explicit support for additional vendor-specific parameters, if needed. */
+        readonly libraryOptions?: Record<string, unknown> | undefined;
+    }
+    /** The result interface if validation fails. */
+    interface FailureResult {
+        /** The issues of failed validation. */
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** The issue interface of the failure output. */
+    interface Issue {
+        /** The error message of the issue. */
+        readonly message: string;
+        /** The path of the issue, if any. */
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** The path segment interface of the issue. */
+    interface PathSegment {
+        /** The key representing a path segment. */
+        readonly key: PropertyKey;
+    }
+    /** The Standard Schema types interface. */
+    interface Types<Input = unknown, Output = Input> {
+        /** The input type of the schema. */
+        readonly input: Input;
+        /** The output type of the schema. */
+        readonly output: Output;
+    }
+    /** Infers the input type of a Standard Schema. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
+    /** Infers the output type of a Standard Schema. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+}
+
+interface Adapter<State> {
+    get(this: void, //
+    raw?: any, ctx?: any): State | undefined | Promise<State | undefined>;
+    set(this: void, //
+    value: State, ctx?: any): void | Promise<void>;
+}
+interface DisposableAdapter<State> extends Adapter<State> {
+    (): void;
+}
 interface StorageAdapter {
-    <State>(key: string, update: (raw?: any) => void): {
-        get(raw?: any, ctx?: any): State | Promise<State | undefined> | undefined;
-        set(value: State, ctx?: any): void;
-    };
+    <State>(key: string, update: (raw?: any) => void): Adapter<State> | DisposableAdapter<State>;
     keyArea?: any;
     noop?: boolean;
 }
 interface StorageAdapterFactory<AdapterConfig> {
-    (config?: AdapterConfig): StorageAdapter;
+    (config: AdapterConfig): StorageAdapter;
     factory: true;
 }
-type Contract<Data> = ((raw: unknown) => raw is Data) | {
-    isData: (raw: unknown) => raw is Data;
-    getErrorMessages: (raw: unknown) => string[];
-};
+type Contract<Data> = ((raw: unknown) => raw is Data) | StandardSchemaV1<unknown, Data> | Contract$1<unknown, Data>;
 type Done<State> = {
     key: string;
     keyPrefix: string;
@@ -29,11 +105,13 @@ type Fail<Err> = {
     error: Err;
     value?: any;
 };
-type Finally<State, Err> = (Done<State> & {
+type FinallyDone<State> = Done<State> & {
     status: 'done';
-}) | (Fail<Err> & {
+};
+type FinallyFail<Err> = Fail<Err> & {
     status: 'fail';
-});
+};
+type Finally<State, Err> = FinallyDone<State> | FinallyFail<Err>;
 interface ConfigPersist {
     pickup?: Unit<any> | Unit<any>[];
     context?: Unit<any>;
@@ -48,9 +126,9 @@ interface ConfigAdapterFactory<AdapterConfig> {
 }
 interface ConfigCommon<State, Err = Error> {
     clock?: Unit<any>;
-    done?: Unit<Done<State>>;
-    fail?: Unit<Fail<Err>>;
-    finally?: Unit<Finally<State, Err>>;
+    done?: UnitTargetable<Done<State>>;
+    fail?: UnitTargetable<Fail<Err>>;
+    finally?: UnitTargetable<Finally<State, Err>>;
     pickup?: Unit<any> | Unit<any>[];
     context?: Unit<any>;
     key?: string;
@@ -58,11 +136,11 @@ interface ConfigCommon<State, Err = Error> {
     contract?: Contract<State | undefined>;
 }
 interface ConfigJustStore<State> {
-    store: Store<State>;
+    store: StoreWritable<State>;
 }
 interface ConfigJustSourceTarget<State> {
     source: Store<State> | Event<State> | Effect<State, any, any>;
-    target: Store<State> | Event<State> | Effect<State, any, any>;
+    target: StoreWritable<State> | EventCallable<State> | Effect<State, any, any>;
 }
 interface ConfigStore<State, Err = Error> extends ConfigCommon<State, Err>, ConfigJustStore<State> {
 }
@@ -72,6 +150,6 @@ interface ConfigSourceTarget<State, Err = Error> extends ConfigCommon<State, Err
 /**
  * Main `persist` function
  */
-declare function persist<State, Err = Error>(config: Partial<(ConfigAdapter | ConfigAdapterFactory<any>) & ConfigPersist & ConfigStore<State, Err> & ConfigSourceTarget<State, Err>>): Subscription;
+declare const persist: <State, Err = Error>(config: Partial<(ConfigAdapter | ConfigAdapterFactory<any>) & ConfigPersist & ConfigStore<State, Err> & ConfigSourceTarget<State, Err>>) => Subscription;
 
 export { persist };

package/core/index.d.ts

@@ -1,21 +1,97 @@
-import { Unit, Store, Event, Effect, Subscription } from 'effector';
+import { Unit, UnitTargetable, StoreWritable, Store, Event, Effect, EventCallable, Subscription } from 'effector';
 
+/** The Contract interface. */
+interface Contract$1<Raw, Data extends Raw> {
+    /**
+     * Checks if Raw is Data
+     */
+    isData: (prepared: Raw) => prepared is Data;
+    /**
+     * - empty array is dedicated for valid response
+     * - array of string with validation erorrs for invalidDataError
+     */
+    getErrorMessages: (prepared: Raw) => string[];
+}
+
+/** The Standard Schema interface. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema properties. */
+    readonly '~standard': StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+    /** The Standard Schema properties interface. */
+    interface Props<Input = unknown, Output = Input> {
+        /** The version number of the standard. */
+        readonly version: 1;
+        /** The vendor name of the schema library. */
+        readonly vendor: string;
+        /** Validates unknown input values. */
+        readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
+        /** Inferred types associated with the schema. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** The result interface of the validate function. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** The result interface if validation succeeds. */
+    interface SuccessResult<Output> {
+        /** The typed output value. */
+        readonly value: Output;
+        /** A falsy value for `issues` indicates success. */
+        readonly issues?: undefined;
+    }
+    interface Options {
+        /** Explicit support for additional vendor-specific parameters, if needed. */
+        readonly libraryOptions?: Record<string, unknown> | undefined;
+    }
+    /** The result interface if validation fails. */
+    interface FailureResult {
+        /** The issues of failed validation. */
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** The issue interface of the failure output. */
+    interface Issue {
+        /** The error message of the issue. */
+        readonly message: string;
+        /** The path of the issue, if any. */
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** The path segment interface of the issue. */
+    interface PathSegment {
+        /** The key representing a path segment. */
+        readonly key: PropertyKey;
+    }
+    /** The Standard Schema types interface. */
+    interface Types<Input = unknown, Output = Input> {
+        /** The input type of the schema. */
+        readonly input: Input;
+        /** The output type of the schema. */
+        readonly output: Output;
+    }
+    /** Infers the input type of a Standard Schema. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
+    /** Infers the output type of a Standard Schema. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+}
+
+interface Adapter<State> {
+    get(this: void, //
+    raw?: any, ctx?: any): State | undefined | Promise<State | undefined>;
+    set(this: void, //
+    value: State, ctx?: any): void | Promise<void>;
+}
+interface DisposableAdapter<State> extends Adapter<State> {
+    (): void;
+}
 interface StorageAdapter {
-    <State>(key: string, update: (raw?: any) => void): {
-        get(raw?: any, ctx?: any): State | Promise<State | undefined> | undefined;
-        set(value: State, ctx?: any): void;
-    };
+    <State>(key: string, update: (raw?: any) => void): Adapter<State> | DisposableAdapter<State>;
     keyArea?: any;
     noop?: boolean;
 }
 interface StorageAdapterFactory<AdapterConfig> {
-    (config?: AdapterConfig): StorageAdapter;
+    (config: AdapterConfig): StorageAdapter;
     factory: true;
 }
-type Contract<Data> = ((raw: unknown) => raw is Data) | {
-    isData: (raw: unknown) => raw is Data;
-    getErrorMessages: (raw: unknown) => string[];
-};
+type Contract<Data> = ((raw: unknown) => raw is Data) | StandardSchemaV1<unknown, Data> | Contract$1<unknown, Data>;
 type Done<State> = {
     key: string;
     keyPrefix: string;
@@ -29,11 +105,13 @@ type Fail<Err> = {
     error: Err;
     value?: any;
 };
-type Finally<State, Err> = (Done<State> & {
+type FinallyDone<State> = Done<State> & {
     status: 'done';
-}) | (Fail<Err> & {
+};
+type FinallyFail<Err> = Fail<Err> & {
     status: 'fail';
-});
+};
+type Finally<State, Err> = FinallyDone<State> | FinallyFail<Err>;
 interface ConfigPersist {
     pickup?: Unit<any> | Unit<any>[];
     context?: Unit<any>;
@@ -48,9 +126,9 @@ interface ConfigAdapterFactory<AdapterConfig> {
 }
 interface ConfigCommon<State, Err = Error> {
     clock?: Unit<any>;
-    done?: Unit<Done<State>>;
-    fail?: Unit<Fail<Err>>;
-    finally?: Unit<Finally<State, Err>>;
+    done?: UnitTargetable<Done<State>>;
+    fail?: UnitTargetable<Fail<Err>>;
+    finally?: UnitTargetable<Finally<State, Err>>;
     pickup?: Unit<any> | Unit<any>[];
     context?: Unit<any>;
     key?: string;
@@ -58,11 +136,11 @@ interface ConfigCommon<State, Err = Error> {
     contract?: Contract<State | undefined>;
 }
 interface ConfigJustStore<State> {
-    store: Store<State>;
+    store: StoreWritable<State>;
 }
 interface ConfigJustSourceTarget<State> {
     source: Store<State> | Event<State> | Effect<State, any, any>;
-    target: Store<State> | Event<State> | Effect<State, any, any>;
+    target: StoreWritable<State> | EventCallable<State> | Effect<State, any, any>;
 }
 interface ConfigStore<State, Err = Error> extends ConfigCommon<State, Err>, ConfigJustStore<State> {
 }
@@ -72,6 +150,6 @@ interface ConfigSourceTarget<State, Err = Error> extends ConfigCommon<State, Err
 /**
  * Main `persist` function
  */
-declare function persist<State, Err = Error>(config: Partial<(ConfigAdapter | ConfigAdapterFactory<any>) & ConfigPersist & ConfigStore<State, Err> & ConfigSourceTarget<State, Err>>): Subscription;
+declare const persist: <State, Err = Error>(config: Partial<(ConfigAdapter | ConfigAdapterFactory<any>) & ConfigPersist & ConfigStore<State, Err> & ConfigSourceTarget<State, Err>>) => Subscription;
 
 export { persist };

package/core/index.js

@@ -1,2 +1,2 @@
-import{createStore as e,createEvent as r,is as t,createNode as o,withRegion as a,attach as i,createEffect as n,scopeBind as f,sample as s,clearNode as c}from"effector";var l=new Map,d=e=>([r],t)=>e(t,r),u=r();function k(k){var{adapter:g,store:v,source:y=v,target:p=v,clock:m=y,done:h,fail:w=u,finally:x,pickup:E,context:P,key:D,keyPrefix:M="",contract:b}=k;if(!g)throw Error("Adapter is not defined");if(!y)throw Error("Store or source is not defined");if(!p)throw Error("Target is not defined");if(!D&&y.shortName===y.id)throw Error("Key or name is not defined");if(y===p&&!t.store(y))throw Error("Source must be different from target");void 0===k.def&&t.store(y)&&(k.def=y.defaultState);var S="factory"in g?g(k):g,z=D||y.shortName,A=function(r,t){var o=l.get(r);void 0===o&&(o=new Map,l.set(r,o));var a=o.get(t);return void 0!==a||(a=e(null,{serialize:"ignore"}),o.set(t,a)),a}(S.keyArea||S,M+z),N=o(),K=()=>c(N),T=e=>({status:r="fail",params:t,result:o,error:a})=>"done"===r?{status:r,key:z,keyPrefix:M,operation:e,value:"get"===e?o:t}:{status:r,key:z,keyPrefix:M,operation:e,value:"function"==typeof t?void 0:t,error:a};return a(N,(()=>{var t=e([],{serialize:"ignore"}),o=S(M+z,(e=>{g(e)})),a=i({source:t,effect:d(o.get)}),c=i({source:t,effect:d(o.set)}),l=n((e=>r=>!e||void 0===r||("isData"in e?e.isData(r):e(r))?r:(()=>{throw"getErrorMessages"in e?e.getErrorMessages(r):void 0})())(b)),u=r(),k=r(),g=a;t.updates.watch((()=>{g=f(a,{safe:!0})})),s({clock:m,source:y,target:k}),s({clock:k,source:A,filter:(e,r)=>r!==e,fn:(e,r)=>r,target:c}),s({clock:[a.doneData,s(c,c.done)],filter:e=>void 0!==e,target:A}),s({clock:[a.doneData,A],target:l}),s({clock:l.doneData,filter:e=>void 0!==e,target:p}),s({clock:[a.finally.map(T("get")),c.finally.map(T("set")),l.fail.map(T("validate"))],target:u}),x&&s({clock:u,target:x}),h&&s({clock:u,filter:({status:e})=>"done"===e,fn:({key:e,keyPrefix:r,operation:t,value:o})=>({key:e,keyPrefix:r,operation:t,value:o}),target:h}),s({clock:u,filter:({status:e})=>"fail"===e,fn:({key:e,keyPrefix:r,operation:t,error:o,value:a})=>({key:e,keyPrefix:r,operation:t,error:o,value:a}),target:w}),P&&t.on(P,(([e],r)=>[void 0===r?e:r])),E?(s({clock:E,fn:()=>{},target:a}),t.on(E,(([e],r)=>[void 0===r?e:r]))):a()})),K.unsubscribe=K}u.watch((e=>console.error(e.error)));export{k as persist};
+import{createStore as e,createEvent as r,is as t,createNode as o,withRegion as a,attach as i,createEffect as n,scopeBind as f,sample as s,clearNode as c}from"effector";var l=new Map,d=r();d.watch(e=>console.error(e.error));var u=u=>{var{adapter:v,store:k,source:y=k,target:p=k,clock:g=y,done:h,fail:w=d,finally:m,pickup:x,context:P,key:E,keyPrefix:D="",contract:b}=u;if(!v)throw Error("Adapter is not defined");if(!y)throw Error("Store or source is not defined");if(!p)throw Error("Target is not defined");if(!E&&y.shortName===y.id)throw Error("Key or name is not defined");if(y===p&&!t.store(y))throw Error("Source must be different from target");void 0===u.def&&t.store(y)&&(u.def=y.defaultState);var S="factory"in v?v(u):v,I=E||y.shortName,M=((r,t)=>{var o=l.get(r);void 0===o&&(o=new Map,l.set(r,o));var a=o.get(t);return void 0!==a||(a=e(null,{serialize:"ignore"}),o.set(t,a)),a})(S.keyArea||S,D+I),z=o(),A=()=>{},N=()=>A(c(z)),j=e=>({status:r="fail",params:t,result:o,error:a})=>"done"===r?{status:r,key:I,keyPrefix:D,operation:e,value:"get"===e?o:t}:{status:r,key:I,keyPrefix:D,operation:e,value:"function"==typeof t?void 0:t,error:a};return a(z,()=>{var o=e([t.store(P)?P.defaultState:void 0],{serialize:"ignore"}),a=S(D+I,e=>{k(e)});"function"==typeof a&&(A=a);var c=i({source:o,effect:([e],r)=>a.get(r,e)}),l=i({source:o,effect:([e],r)=>a.set(r,e)}),d=n(e=>void 0===e?e:((e,r)=>{if(!r)return e;if("function"!=typeof r&&"object"!=typeof r)throw["Invalid contract"];if("isData"in r){if(r.isData(e))return e;throw r.getErrorMessages(e)}if("~standard"in r){var t=r["~standard"].validate(e),o=r=>{if(r.issues)throw r.issues;return e};return"then"in t?Promise.resolve(t).then(o):o(t)}if("function"==typeof r){if(r(e))return e;throw["Invalid data"]}throw["Invalid contract"]})(e,b)),u=r(),v=r(),k=c;o.updates.watch(()=>{k=f(c,{safe:!0})}),s({clock:g,source:y,target:v}),s({clock:v,source:M,filter:(e,r)=>r!==e,fn:(e,r)=>r,target:l}),s({clock:[c.doneData,s(l,l.done)],filter:e=>void 0!==e,target:M}),s({clock:[c.doneData,M],target:d}),s({clock:d.doneData,filter:e=>void 0!==e,target:p}),s({clock:[c.finally.map(j("get")),l.finally.map(j("set")),d.fail.map(j("validate"))],target:u}),m&&s({clock:u,target:m}),h&&s({clock:u,filter:e=>"done"===e.status,fn:({key:e,keyPrefix:r,operation:t,value:o})=>({key:e,keyPrefix:r,operation:t,value:o}),target:h}),s({clock:u,filter:e=>"fail"===e.status,fn:({key:e,keyPrefix:r,operation:t,error:o,value:a})=>({key:e,keyPrefix:r,operation:t,error:o,value:a}),target:w}),P&&o.on(P,([e],r)=>[void 0===r?e:r]),x?(s({clock:x,fn:()=>{},target:c}),o.on(x,([e],r)=>[void 0===r?e:r])):c()}),N.unsubscribe=N};export{u as persist};
 //# sourceMappingURL=index.js.map

package/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/core/area.ts","../../src/core/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, { serialize: 'ignore' })\n  area.set(key, store)\n\n  return store\n}\n","import type { Effect, Subscription, Unit } from 'effector'\nimport type {\n  ConfigAdapter,\n  ConfigAdapterFactory,\n  ConfigPersist,\n  ConfigSourceTarget,\n  ConfigStore,\n  Contract,\n  Done,\n  Fail,\n  Finally,\n} from '../types'\nimport {\n  attach,\n  clearNode,\n  createEvent,\n  createEffect,\n  createNode,\n  createStore,\n  is,\n  sample,\n  scopeBind,\n  withRegion,\n} from 'effector'\nimport { getAreaStorage } from './area'\n\n// helper function to swap two function arguments\n// end extract current context from ref-box\nconst contextual =\n  <T, C, R>(fn: (value: T, ctx?: C) => R) =>\n  ([ref]: [C?], value: T) =>\n    fn(value, ref)\n\n// helper function to validate data with contract\nconst contracted =\n  <T>(contract?: Contract<T>) =>\n  (raw: unknown) =>\n    !contract || // no contract -> data is valid\n    raw === undefined || // `undefined` is always valid\n    ('isData' in contract ? contract.isData(raw) : contract(raw))\n      ? (raw as T)\n      : (() => {\n          throw 'getErrorMessages' in contract\n            ? contract.getErrorMessages(raw)\n            : undefined\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 `persist` function\n */\nexport function persist<State, Err = Error>(\n  config: Partial<\n    (ConfigAdapter | ConfigAdapterFactory<any>) &\n      ConfigPersist &\n      ConfigStore<State, Err> &\n      ConfigSourceTarget<State, Err>\n  >\n): Subscription {\n  const {\n    adapter: adapterOrFactory,\n    store,\n    source = store,\n    target = store,\n    clock = source,\n    done,\n    fail = sink,\n    finally: anyway,\n    pickup,\n    context,\n    key: keyName,\n    keyPrefix = '',\n    contract,\n  } = config\n\n  if (!adapterOrFactory) {\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  // get default value from store, if given\n  // this is used in adapter factory\n  if ((config as any).def === undefined && is.store(source)) {\n    ;(config as any).def = source.defaultState\n  }\n\n  const adapter =\n    'factory' in adapterOrFactory ? adapterOrFactory(config) : adapterOrFactory\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' | 'validate') =>\n    ({ status = 'fail', 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: typeof params === 'function' ? undefined : params, // hide internal \"box\" implementation\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 ctx = createStore<[any?]>([], { serialize: 'ignore' })\n\n    const value = adapter<State>(keyPrefix + key, (x) => {\n      update(x)\n    })\n\n    const getFx = attach({\n      source: ctx,\n      effect: contextual(value.get),\n    }) as any as Effect<void, State, Err>\n\n    const setFx = attach({\n      source: ctx,\n      effect: contextual(value.set),\n    }) as any as Effect<State, void, Err>\n\n    const validateFx = createEffect<unknown, State>(contracted(contract))\n\n    const complete = createEvent<Finally<State, Err>>()\n\n    const trigger = createEvent<State>()\n\n    let update: (raw?: any) => any = getFx\n    ctx.updates.watch(() => {\n      update = scopeBind(getFx as any, { safe: true })\n    })\n\n    sample({\n      clock, // `clock` is always defined, as long as `source` is defined\n      source,\n      target: trigger,\n    } as any)\n\n    sample({\n      clock: trigger,\n      source: storage,\n      filter: (current, proposed) => proposed !== current,\n      fn: (_, proposed) => proposed,\n      target: setFx,\n    })\n\n    sample({\n      clock: [getFx.doneData, sample(setFx, setFx.done)],\n      filter: <T>(x?: T | undefined): x is T => x !== undefined,\n      target: storage as any,\n    })\n\n    sample({\n      clock: [getFx.doneData, storage],\n      target: validateFx as any,\n    })\n\n    sample({\n      clock: validateFx.doneData,\n      filter: <T>(x?: T | undefined): x is T => x !== undefined,\n      target: target as any,\n    })\n\n    sample({\n      clock: [\n        getFx.finally.map(op('get')),\n        setFx.finally.map(op('set')),\n        validateFx.fail.map(op('validate')),\n      ],\n      target: complete,\n    })\n\n    // effector 23 introduced \"targetable\" types - UnitTargetable, StoreWritable, EventCallable\n    // so, targeting non-targetable unit is not allowed anymore.\n    // soothe typescript by casting to any for a while, until we drop support for effector 22 branch\n    if (anyway) {\n      sample({\n        clock: complete,\n        target: anyway as any,\n      })\n    }\n\n    if (done) {\n      sample({\n        clock: complete,\n        filter: ({ status }) => status === 'done',\n        fn: ({ key, keyPrefix, operation, value }): Done<State> => ({\n          key,\n          keyPrefix,\n          operation,\n          value,\n        }),\n        target: done as any,\n      })\n    }\n\n    sample({\n      clock: complete,\n      filter: ({ status }) => status === 'fail',\n      fn: ({ key, keyPrefix, operation, error, value }: any): Fail<Err> => ({\n        key,\n        keyPrefix,\n        operation,\n        error,\n        value,\n      }),\n      target: fail as any,\n    })\n\n    if (context) {\n      ctx.on(context, ([ref], payload) => [\n        payload === undefined ? ref : payload,\n      ])\n    }\n\n    if (pickup) {\n      // pick up value from storage ONLY on `pickup` update\n      sample({ clock: pickup as Unit<any>, fn: () => undefined, target: getFx })\n      ctx.on(pickup as Unit<any>, ([ref], payload) => [\n        payload === undefined ? ref : payload,\n      ])\n    } else {\n      // kick getter to pick up initial value from storage\n      getFx()\n    }\n  })\n\n  return (desist.unsubscribe = desist)\n}\n"],"names":["areas","Map","contextual","fn","ref","value","sink","createEvent","persist","config","adapter","adapterOrFactory","store","source","target","clock","done","fail","finally","anyway","pickup","context","key","keyName","keyPrefix","contract","Error","shortName","id","is","undefined","def","defaultState","storage","keyArea","area","get","set","createStore","serialize","getAreaStorage","region","createNode","desist","clearNode","op","operation","status","params","result","error","withRegion","ctx","x","update","getFx","attach","effect","setFx","validateFx","createEffect","raw","isData","getErrorMessages","contracted","complete","trigger","updates","watch","scopeBind","safe","sample","filter","current","proposed","_","doneData","map","on","payload","unsubscribe","console"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/core/area.ts","../../src/core/persist.ts","../../src/core/validate.ts"],"sourcesContent":["import type { StoreWritable } from 'effector'\nimport { createStore } from 'effector'\n\n/**\n * Keys areas / namespaces cache\n */\nconst areas = new Map<any, Map<string, StoreWritable<any>>>()\n\n/**\n * Get store, responsible for the key in key area / namespace\n */\nexport const getAreaStorage = <State>(\n  keyArea: any,\n  key: string\n): StoreWritable<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, { serialize: 'ignore' })\n  area.set(key, store)\n\n  return store\n}\n","import type { Effect, Event, Subscription, Unit } from 'effector'\nimport type {\n  ConfigAdapter,\n  ConfigAdapterFactory,\n  ConfigPersist,\n  ConfigSourceTarget,\n  ConfigStore,\n  Done,\n  Fail,\n  Finally,\n  FinallyDone,\n  FinallyFail,\n} from '../types'\nimport {\n  attach,\n  clearNode,\n  createEffect,\n  createEvent,\n  createNode,\n  createStore,\n  is,\n  sample,\n  scopeBind,\n  withRegion,\n} from 'effector'\nimport { getAreaStorage } from './area'\nimport { validate } from './validate'\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 const persist = <State, Err = Error>(\n  config: Partial<\n    (ConfigAdapter | ConfigAdapterFactory<any>) &\n      ConfigPersist &\n      ConfigStore<State, Err> &\n      ConfigSourceTarget<State, Err>\n  >\n): Subscription => {\n  const {\n    adapter: adapterOrFactory,\n    store,\n    source = store,\n    target = store,\n    clock = source,\n    done,\n    fail = sink,\n    finally: anyway,\n    pickup,\n    context,\n    key: keyName,\n    keyPrefix = '',\n    contract,\n  } = config\n\n  if (!adapterOrFactory) {\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  // get default value from store, if given\n  // this is used in adapter factory\n  if ((config as any).def === undefined && is.store(source)) {\n    ;(config as any).def = source.defaultState\n  }\n\n  const adapter =\n    'factory' in adapterOrFactory ? adapterOrFactory(config) : adapterOrFactory\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  let disposable: (_: any) => void = () => {}\n  const desist = () => disposable(clearNode(region))\n\n  const op =\n    (operation: 'get' | 'set' | 'validate') =>\n    ({ status = 'fail', 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: typeof params === 'function' ? undefined : params, // hide internal \"box\" implementation\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 ctx = createStore<[any?]>(\n      [is.store(context) ? context.defaultState : undefined],\n      { serialize: 'ignore' }\n    )\n\n    const value = adapter<State>(keyPrefix + key, (x) => {\n      update(x)\n    })\n\n    if (typeof value === 'function') {\n      disposable = value\n    }\n\n    const getFx = attach({\n      source: ctx,\n      effect: ([ref], raw?: any) => value.get(raw, ref),\n    }) as Effect<void, State, Err>\n\n    const setFx = attach({\n      source: ctx,\n      effect: ([ref], state: State) => value.set(state, ref),\n    }) as Effect<State, void, Err>\n\n    const validateFx = createEffect<unknown, State>((raw) =>\n      raw === undefined // `undefined` is always valid\n        ? raw\n        : validate(raw, contract)\n    )\n\n    const complete = createEvent<Finally<State, Err>>()\n\n    const trigger = createEvent<State>()\n\n    let update: (raw?: any) => any = getFx\n    ctx.updates.watch(() => {\n      update = scopeBind(getFx, { safe: true })\n    })\n\n    sample({\n      clock, // `clock` is always defined, as long as `source` is defined\n      source,\n      target: trigger,\n    } as any)\n\n    sample({\n      clock: trigger,\n      source: storage,\n      filter: (current, proposed) => proposed !== current,\n      fn: (_, proposed) => proposed,\n      target: setFx,\n    })\n\n    sample({\n      clock: [getFx.doneData as Event<any>, sample(setFx, setFx.done)],\n      filter: (x) => x !== undefined,\n      target: storage,\n    })\n\n    sample({\n      clock: [getFx.doneData as Event<any>, storage],\n      target: validateFx,\n    })\n\n    sample({\n      clock: validateFx.doneData,\n      filter: (x) => x !== undefined,\n      target: target as any,\n    })\n\n    sample({\n      clock: [\n        getFx.finally.map(op('get')),\n        setFx.finally.map(op('set')),\n        validateFx.fail.map(op('validate')),\n      ],\n      target: complete,\n    })\n\n    if (anyway) {\n      sample({\n        clock: complete,\n        target: anyway,\n      })\n    }\n\n    if (done) {\n      sample({\n        clock: complete,\n        filter: (payload: Finally<State, Err>): payload is FinallyDone<State> =>\n          payload.status === 'done',\n        fn: ({ key, keyPrefix, operation, value }): Done<State> => ({\n          key,\n          keyPrefix,\n          operation,\n          value,\n        }),\n        target: done,\n      })\n    }\n\n    sample({\n      clock: complete,\n      filter: (payload: Finally<State, Err>): payload is FinallyFail<Err> =>\n        payload.status === 'fail',\n      fn: ({ key, keyPrefix, operation, error, value }): Fail<Err> => ({\n        key,\n        keyPrefix,\n        operation,\n        error,\n        value,\n      }),\n      target: fail,\n    })\n\n    if (context) {\n      ctx.on(context, ([ref], payload) => [\n        payload === undefined ? ref : payload,\n      ])\n    }\n\n    if (pickup) {\n      // pick up value from storage ONLY on `pickup` update\n      sample({ clock: pickup as Unit<any>, fn: () => undefined, target: getFx })\n      ctx.on(pickup as Unit<any>, ([ref], payload) => [\n        payload === undefined ? ref : payload,\n      ])\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 { Contract } from '../types'\nimport type { StandardSchemaV1 } from '../types-standard-schema'\n\nexport const validate = <Data>(\n  raw: unknown,\n  contract?: Contract<Data>\n): Data | Promise<Data> => {\n  // no contract -> data is valid\n  if (!contract) {\n    return raw as Data\n  }\n\n  // contract is not a function nor object\n  if (typeof contract !== 'function' && typeof contract !== 'object') {\n    throw ['Invalid contract']\n  }\n\n  // contract is a Contract protocol\n  if ('isData' in contract) {\n    if (contract.isData(raw)) {\n      return raw as Data\n    }\n    throw contract.getErrorMessages(raw)\n  }\n\n  // contract is a Standard Schema\n  if ('~standard' in contract) {\n    const result = contract['~standard'].validate(raw)\n\n    const check = (result: StandardSchemaV1.Result<Data>) => {\n      if (result.issues) throw result.issues\n\n      // return original raw value, same by reference, if validation passed\n      // this means that transformations are not supported!\n      return raw as Data // not `result.value`\n    }\n\n    return 'then' in result\n      ? Promise.resolve(result).then(check)\n      : check(result)\n  }\n\n  // contract is a simple 'type guard'-like function\n  if (typeof contract === 'function') {\n    if (contract(raw)) {\n      return raw as Data\n    }\n    throw ['Invalid data']\n  }\n\n  // if contract is not supported, throw an error\n  throw ['Invalid contract']\n}\n"],"names":["areas","Map","sink","createEvent","watch","payload","console","error","persist","config","adapter","adapterOrFactory","store","source","target","clock","done","fail","finally","anyway","pickup","context","key","keyName","keyPrefix","contract","Error","shortName","id","is","undefined","def","defaultState","storage","getAreaStorage","keyArea","area","get","set","createStore","serialize","region","createNode","disposable","desist","clearNode","op","operation","status","params","result","value","withRegion","ctx","x","update","getFx","attach","effect","ref","raw","setFx","state","validateFx","createEffect","validate","isData","getErrorMessages","check","issues","Promise","resolve","then","complete","trigger","updates","scopeBind","safe","sample","filter","current","proposed","fn","_","doneData","map","on","unsubscribe"],"mappings":"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"}

package/core/package.json

@@ -17,5 +17,8 @@
         "default": "./index.cjs"
       }
     }
+  },
+  "dependencies": {
+    "effector": "23.0.0"
   }
 }

package/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var e=require("./core/index.cjs"),r=require("./async-storage/index.cjs"),s=require("./broadcast/index.cjs"),o=require("./local/index.cjs"),i=require("./log/index.cjs"),t=require("./memory/index.cjs"),c=require("./nil/index.cjs"),a=require("./query/index.cjs"),n=require("./session/index.cjs"),x=require("./storage/index.cjs"),p=require("./tools/index.cjs"),u=e.persist;exports.asyncStorage=r.asyncStorage,exports.broadcast=s.broadcast,exports.local=o.local,exports.log=i.log,exports.memory=t.memory,exports.nil=c.nil,exports.query=a.query,exports.session=n.session,exports.storage=x.storage,exports.async=p.async,exports.either=p.either,exports.farcached=p.farcached,exports.createPersist=function(r){return s=>e.persist({...r,...s})},exports.persist=u;
+"use strict";var e=require("./core/index.cjs"),r=require("./async-storage/index.cjs"),s=require("./broadcast/index.cjs"),o=require("./local/index.cjs"),i=require("./log/index.cjs"),t=require("./memory/index.cjs"),c=require("./nil/index.cjs"),a=require("./query/index.cjs"),x=require("./session/index.cjs"),n=require("./storage/index.cjs"),p=require("./tools/index.cjs"),d=e.persist;exports.asyncStorage=r.asyncStorage,exports.broadcast=s.broadcast,exports.local=o.local,exports.log=i.log,exports.memory=t.memory,exports.nil=c.nil,exports.query=a.query,exports.session=x.session,exports.storage=n.storage,exports.async=p.async,exports.either=p.either,exports.farcached=p.farcached,exports.createPersist=r=>s=>e.persist({...r,...s}),exports.persist=d;
 //# sourceMappingURL=index.cjs.map

package/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import type { ConfigPersist, Persist } from './types'\nimport { persist as base } from './core'\n\nexport type {\n  ConfigPersist,\n  ConfigSourceTarget,\n  ConfigStore,\n  Contract,\n  Done,\n  Fail,\n  Finally,\n  Persist,\n  StorageAdapter,\n  StorageAdapterFactory,\n} from './types'\n\n//\n// reexport adapters\n//\n\nexport type { AsyncStorageConfig } from './async-storage'\nexport type { BroadcastConfig } from './broadcast'\nexport type { LocalStorageConfig } from './local'\nexport type { LogConfig } from './log'\nexport type { MemoryConfig } from './memory'\nexport type { NilConfig } from './nil'\nexport type { QueryConfig } from './query'\nexport type { SessionStorageConfig } from './session'\nexport type { StorageConfig } from './storage'\n\nexport { asyncStorage } from './async-storage'\nexport { broadcast } from './broadcast'\nexport { local } from './local'\nexport { log } from './log'\nexport { memory } from './memory'\nexport { nil } from './nil'\nexport { query } from './query'\nexport { session } from './session'\nexport { storage } from './storage'\n\n//\n// reexport tools\n//\n\nexport { async, either, farcached } from './tools'\n\n/**\n * Creates custom `persist`\n */\nexport function createPersist(defaults?: ConfigPersist): Persist {\n  return (config: any) =>\n    base({\n      ...defaults,\n      ...config,\n    })\n}\n\n/**\n * Default `persist`\n */\nexport const persist: Persist = base\n"],"names":["persist","base","defaults","config"],"mappings":"kXA4DaA,EAAmBC,EAAAA,wUAXzB,SAAuBC,GAC5B,OAAQC,GACNF,EAAAA,QAAK,IACAC,KACAC,GAET"}
+{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import type { ConfigPersist, Persist } from './types'\nimport { persist as basePersist } from './core'\n\nexport type {\n  Adapter,\n  ConfigPersist,\n  ConfigSourceTarget,\n  ConfigStore,\n  Contract,\n  DisposableAdapter,\n  Done,\n  Fail,\n  Finally,\n  Persist,\n  StorageAdapter,\n  StorageAdapterFactory,\n} from './types'\n\n//\n// reexport adapters\n//\n\nexport type { AsyncStorageConfig } from './async-storage'\nexport type { BroadcastConfig } from './broadcast'\nexport type { LocalStorageConfig } from './local'\nexport type { LogConfig } from './log'\nexport type { MemoryConfig } from './memory'\nexport type { NilConfig } from './nil'\nexport type { QueryConfig } from './query'\nexport type { SessionStorageConfig } from './session'\nexport type { StorageConfig } from './storage'\nexport { asyncStorage } from './async-storage'\nexport { broadcast } from './broadcast'\nexport { local } from './local'\nexport { log } from './log'\nexport { memory } from './memory'\nexport { nil } from './nil'\nexport { query } from './query'\nexport { session } from './session'\nexport { storage } from './storage'\n\n//\n// reexport tools\n//\n\nexport { async, either, farcached } from './tools'\n\n/**\n * Creates custom `persist`\n */\nexport const createPersist =\n  (defaults?: ConfigPersist): Persist =>\n  (config: any) =>\n    basePersist({\n      ...defaults,\n      ...config,\n    })\n\n/**\n * Default `persist`\n */\nexport const persist: Persist = basePersist\n"],"names":["persist","basePersist","defaults","config"],"mappings":"kXA6DaA,EAAmBC,EAAAA,wUAV7BC,GACAC,GACCF,UAAY,IACPC,KACAC"}