/** * ReaderStreamEither is an EitherT of ReaderStream, allowing for you to * represent your application over time with Stream, with support for branching/error-handling * through Either, and dependency injection from Reader. * * @since 0.9.2 */ import * as ALT from 'fp-ts/Alt' import * as ALTERNATIVE from 'fp-ts/Alternative' import * as App from 'fp-ts/Applicative' import * as Ap from 'fp-ts/Apply' import * as Bi from 'fp-ts/Bifunctor' import * as Ch from 'fp-ts/Chain' import { ChainRec3 } from 'fp-ts/ChainRec' import * as Ei from 'fp-ts/Either' import * as ET from 'fp-ts/EitherT' import * as FEi from 'fp-ts/FromEither' import * as FIO from 'fp-ts/FromIO' import * as FR from 'fp-ts/FromReader' import * as FT from 'fp-ts/FromTask' import { Lazy } from 'fp-ts/function' import * as F from 'fp-ts/Functor' import { Monad3 } from 'fp-ts/Monad' import { Pointed3 } from 'fp-ts/Pointed' import * as Re from 'fp-ts/Reader' import * as RT from 'fp-ts/ReaderT' import { Semigroup } from 'fp-ts/Semigroup' import * as FE from './FromEnv' import * as FRS from './FromReaderStream' import * as FRe from './FromResume' import * as FS from './FromStream' import { flow } from './function' import { MonadRec3 } from './MonadRec' import * as P from './Provide' import * as RS from './ReaderStream' import * as S from './Stream' import * as SE from './StreamEither' /** * Env is specialization of Reader> * @since 0.9.2 * @category Model */ export interface ReaderStreamEither extends Re.Reader> {} /** * @since 0.9.2 * @category Type-level */ export type RequirementsOf = A extends ReaderStreamEither ? R : never /** * @since 0.9.2 * @category Type-lvel */ export type LeftOf = A extends ReaderStreamEither ? R : never /** * @since 0.9.2 * @category Type-lvel */ export type RightOf = A extends ReaderStreamEither ? R : never /** * @since 0.9.2 * @category Combinator */ export const ap = RT.ap(SE.Apply) /** * @since 0.9.2 * @category Combinator */ export const apW = ap as ( fa: Re.Reader>, ) => ( fab: Re.Reader B>>, ) => Re.Reader> /** * @since 0.9.2 * @category Combinator */ export const chain = RT.chain(SE.Chain) /** * @since 0.9.2 * @category Combinator */ export const chainW = chain as ( f: (a: A) => Re.Reader>, ) => (ma: Re.Reader>) => Re.Reader> /** * @since 0.9.2 * @category Constructor */ export const fromReader = RT.fromReader(SE.Pointed) /** * @since 0.9.2 * @category Combinator */ export const map = RT.map(SE.Functor) /** * @since 0.9.2 * @category Constructor */ export const of = RT.of(SE.Pointed) /** * @since 0.9.2 * @category Combinator */ export const alt = ET.alt(RS.Monad) /** * @since 0.9.2 * @category Combinator */ export const altW = alt as ( second: Lazy>>, ) => (first: RS.ReaderStream>) => RS.ReaderStream> /** * @since 0.9.2 * @category Typeclass Constructor */ export const altValidation = (semigroup: Semigroup) => ET.altValidation(RS.Monad, semigroup) /** * @since 0.9.2 * @category Combinator */ export const bimap = ET.bimap(RS.Functor) /** * @since 0.9.2 * @category Combinator */ export const bracket = ET.bracket(RS.Monad) /** * @since 0.9.2 * @category Combinator */ export const bracketW = bracket as ( acquire: RS.ReaderStream>, use: (a: A) => RS.ReaderStream>, release: (a: A, e: Ei.Either) => RS.ReaderStream>, ) => RS.ReaderStream> /** * @since 0.9.2 * @category Combinator */ export const getOrElse = ET.getOrElse(RS.Monad) /** * @since 0.9.2 * @category Combinator */ export const getOrElseE = ET.getOrElseE(RS.Monad) /** * @since 0.9.2 * @category Combinator */ export const getOrElseEW = getOrElseE as ( onLeft: (e: E) => RS.ReaderStream, ) => (ma: RS.ReaderStream>) => RS.ReaderStream /** * @since 0.9.2 * @category Constructor */ export const left = ET.left(RS.Monad) /** * @since 0.9.2 * @category Constructor */ export const fromReaderStreamL = ET.leftF(RS.Monad) /** * @since 0.9.2 * @category Combinator */ export const mapLeft = ET.mapLeft(RS.Monad) /** * @since 0.9.2 * @category Deconstructor */ export const match = ET.match(RS.Monad) /** * @since 0.9.2 * @category Deconstructor */ export const matchE = ET.matchE(RS.Monad) /** * @since 0.9.2 * @category Deconstructor */ export const matchEW = match as ( onLeft: (e: E) => RS.ReaderStream, onRight: (a: A) => RS.ReaderStream, ) => ( ma: RS.ReaderStream>, ) => RS.ReaderStream> /** * @since 0.9.2 * @category Combinator */ export const orElse = ET.orElse(RS.Monad) /** * @since 0.9.2 * @category Combinator */ export const orElseFirst = ET.orElseFirst(RS.Monad) /** * @since 0.9.2 * @category Combinator */ export const orLeft = ET.orLeft(RS.Monad) /** * @since 0.9.2 * @category Constructor */ export const right = ET.right(RS.Monad) /** * @since 0.9.2 * @category Constructor */ export const fromReaderStream = ET.rightF(RS.Monad) /** * @since 0.9.2 * @category Combinator */ export const swap = ET.swap(RS.Functor) /** * @since 0.9.2 * @category Combinator */ export const toUnion = ET.toUnion(RS.Functor) /** * @since 0.9.2 * @category URI */ export const URI = '@typed/fp/ReaderStreamEither' /** * @since 0.9.2 * @category URI */ export type URI = typeof URI declare module 'fp-ts/HKT' { export interface URItoKind3 { [URI]: ReaderStreamEither } } declare module './HKT' { export interface URItoVariance { [URI]: V & V } } /** * @since 0.9.2 * @category Instance */ export const Pointed: Pointed3 = { of, } /** * @since 0.9.2 * @category Instance */ export const Functor: F.Functor3 = { map, } /** * @since 0.9.2 * @category Combinator */ export const bindTo = F.bindTo(Functor) /** * @since 0.9.2 * @category Combinator */ export const flap = F.flap(Functor) /** * @since 0.9.2 * @category Combinator */ export const tupled = F.tupled(Functor) /** * @since 0.9.2 * @category Instance */ export const Bifunctor: Bi.Bifunctor3 = { ...Functor, bimap, mapLeft, } /** * @since 0.9.2 * @category Instance */ export const Apply: Ap.Apply3 = { ...Functor, ap, } /** * @since 0.9.2 * @category Combinator */ export const apFirst = Ap.apFirst(Apply) /** * @since 0.13.9 * @category Combinator */ export const apFirstW = apFirst as ( second: ReaderStreamEither, ) => (first: ReaderStreamEither) => ReaderStreamEither /** * @since 0.9.2 * @category Combinator */ export const apS = Ap.apS(Apply) /** * @since 0.13.9 * @category Combinator */ export const apSW = apS as ( name: Exclude, fb: ReaderStreamEither, ) => (fa: ReaderStreamEither) => ReaderStreamEither< R1 & R2, E, { readonly [K in keyof A | N]: K extends keyof A ? A[K] : B } > /** * @since 0.9.2 * @category Combinator */ export const apSecond = Ap.apSecond(Apply) /** * @since 0.13.9 * @category Combinator */ export const apScondW = apFirst as ( second: ReaderStreamEither, ) => (first: ReaderStreamEither) => ReaderStreamEither /** * @since 0.9.2 * @category Combinator */ export const apT = Ap.apT(Apply) /** * @since 0.13.9 * @category Combinator */ export const apTW = apT as ( fb: ReaderStreamEither, ) => ( fas: ReaderStreamEither, ) => ReaderStreamEither /** * @since 0.9.2 * @category Typeclass Constructor */ export const getApplySemigroup = Ap.getApplySemigroup(Apply) /** * @since 0.9.2 * @category Instance */ export const Applicative: App.Applicative3 = { ...Apply, ...Pointed, } /** * @since 0.9.2 * @category Typeclass Consructor */ export const getApplicativeMonoid = App.getApplicativeMonoid(Applicative) /** * @since 0.9.2 * @category Instance */ export const Chain: Ch.Chain3 = { ...Functor, chain, } /** * @since 0.9.2 * @category Combinator */ export const bind = Ch.bind(Chain) /** * @since 0.9.2 * @category Combinator */ export const chainFirst = Ch.chainFirst(Chain) /** * @since 0.13.9 * @category Combinator */ export const chainFirstW = chainFirst as ( f: (a: A) => ReaderStreamEither, ) => (first: ReaderStreamEither) => ReaderStreamEither /** * @since 0.9.2 * @category Instance */ export const Monad: Monad3 = { ...Chain, ...Pointed, } /** * @since 0.9.2 * @category Combinator */ export function chainRec( f: (value: A) => ReaderStreamEither>, ): (value: A) => ReaderStreamEither { return (value) => (env) => SE.chainRec((a: A) => f(a)(env))(value) } /** * @since 0.9.2 * @category Instance */ export const ChainRec: ChainRec3 = { chainRec, } /** * @since 0.9.2 * @category Instance */ export const MonadRec: MonadRec3 = { ...Monad, chainRec, } /** * @since 0.9.2 * @category Instance */ export const Alt: ALT.Alt3 = { ...Functor, alt, } /** * @since 0.9.2 * @category Combinator */ export const altAll = ALT.altAll(Alt) /** * @since 0.9.2 * @category Constructor */ export const zero: ReaderStreamEither = S.empty /** * @since 0.9.2 * @category Instance */ export const Alternative: ALTERNATIVE.Alternative3 = { ...Alt, zero: () => zero, } /** * @since 0.9.2 * @category Instance */ export const FromEither: FEi.FromEither3 = { fromEither: RS.of, } /** * @since 0.9.2 * @category Constructor */ export const fromEither = FromEither.fromEither /** * @since 0.9.2 * @category Combinator */ export const chainEitherK = FEi.chainEitherK(FromEither, Chain) /** * @since 0.9.2 * @category Combinator */ export const chainOptionK = FEi.chainOptionK(FromEither, Chain) /** * @since 0.9.2 * @category Combinator */ export const filterOrElse = FEi.filterOrElse(FromEither, Chain) /** * @since 0.9.2 * @category Constructor */ export const fromEitherK = FEi.fromEitherK(FromEither) /** * @since 0.9.2 * @category Constructor */ export const fromOption = FEi.fromOption(FromEither) /** * @since 0.9.2 * @category Constructor */ export const fromOptionK = FEi.fromOptionK(FromEither) /** * @since 0.9.2 * @category Constructor */ export const fromPredicate = FEi.fromPredicate(FromEither) /** * @since 0.9.2 * @category Instance */ export const FromReader: FR.FromReader3 = { fromReader, } /** * @since 0.9.2 * @category Constructor */ export const ask = FR.ask(FromReader) /** * @since 0.9.2 * @category Constructor */ export const asks = FR.asks(FromReader) /** * @since 0.9.2 * @category Combinator */ export const chainFirstReaderK = FR.chainFirstReaderK(FromReader, Chain) /** * @since 0.9.2 * @category Combinator */ export const chainReaderK = FR.chainReaderK(FromReader, Chain) /** * @since 0.13.9 * @category Combinator */ export const chainReaderKW = chainReaderK as ( f: (a: A) => Re.Reader, ) => (ma: ReaderStreamEither) => ReaderStreamEither /** * @since 0.9.2 * @category Constructor */ export const fromReaderK = FR.fromReaderK(FromReader) /** * @since 0.9.2 * @category Instance */ export const FromIO: FIO.FromIO3 = { fromIO: flow(RS.fromIO, fromReaderStream), } /** * @since 0.9.2 * @category Constructor */ export const fromIO = FromIO.fromIO /** * @since 0.9.2 * @category Combinator */ export const chainFirstIOK = FIO.chainFirstIOK(FromIO, Chain) /** * @since 0.9.2 * @category Combinator */ export const chainIOK = FIO.chainIOK(FromIO, Chain) /** * @since 0.9.2 * @category Constructor */ export const fromIOK = FIO.fromIOK(FromIO) /** * @since 0.9.2 * @category Instance */ export const FromTask: FT.FromTask3 = { ...FromIO, fromTask: flow(RS.fromTask, fromReaderStream), } /** * @since 0.9.2 * @category Constructor */ export const fromTask = FromTask.fromTask /** * @since 0.9.2 * @category Combinator */ export const chainFirstTaskK = FT.chainFirstTaskK(FromTask, Chain) /** * @since 0.9.2 * @category Combinator */ export const chainTaskK = FT.chainTaskK(FromTask, Chain) /** * @since 0.9.2 * @category Constructor */ export const fromTaskK = FT.fromTaskK(FromTask) /** * @since 0.9.2 * @category Instance */ export const FromStream: FS.FromStream3 = { fromStream: flow(RS.fromStream, RS.map(Ei.right)), } /** * @since 0.9.2 * @category Constructor */ export const fromStream = FromStream.fromStream /** * @since 0.9.2 * @category Combinator */ export const chainFirstStreamK = FS.chainFirstStreamK(FromStream, Chain) /** * @since 0.9.2 * @category Combinator */ export const chainStreamK = FS.chainStreamK(FromStream, Chain) /** * @since 0.9.2 * @category Constructor */ export const fromStreamK = FS.fromStreamK(FromStream) /** * @since 0.9.2 * @category Instance */ export const FromResume: FRe.FromResume3 = { fromResume: flow( RS.fromResume, RS.map((x) => Ei.right(x)), ), } /** * @since 0.9.2 * @category Constructor */ export const fromResume = FromResume.fromResume /** * @since 0.9.2 * @category Combinator */ export const chainFirstResumeK = FRe.chainFirstResumeK(FromResume, Chain) /** * @since 0.9.2 * @category Combinator */ export const chainResumeK = FRe.chainResumeK(FromResume, Chain) /** * @since 0.9.2 * @category Constructor */ export const fromResumeK = FRe.fromResumeK(FromResume) /** * @since 0.9.2 * @category Instance */ export const FromEnv: FE.FromEnv3 = { fromEnv: flow( RS.fromEnv, RS.map((x) => Ei.right(x)), ), } /** * @since 0.9.2 * @category Constructor */ export const fromEnv = FromEnv.fromEnv /** * @since 0.9.2 * @category Combinator */ export const chainFirstEnvK = FE.chainFirstEnvK(FromEnv, Chain) /** * @since 0.9.2 * @category Combinator */ export const chainEnvK = FE.chainEnvK(FromEnv, Chain) /** * @since 0.9.2 * @category Constructor */ export const fromEnvK = FE.fromEnvK(FromEnv) /** * @since 0.13.9 * @category Instance */ export const ProvideAll: P.ProvideAll3 = { provideAll: RS.provideAll, } /** * @since 0.13.9 * @category Combinator */ export const provideAll = ProvideAll.provideAll /** * @since 0.13.9 * @category Instance */ export const ProvideSome: P.ProvideSome3 = { provideSome: RS.provideSome, } /** * @since 0.13.9 * @category Combinator */ export const provideSome = ProvideSome.provideSome /** * @since 0.13.9 * @category Instance */ export const UseAll: P.UseAll3 = { useAll: RS.useAll, } /** * @since 0.13.9 * @category Combinator */ export const useAll = UseAll.useAll /** * @since 0.13.9 * @category Instance */ export const UseSome: P.UseSome3 = { useSome: RS.useSome, } /** * @since 0.13.9 * @category Combinator */ export const useSome = UseSome.useSome /** * @since 0.13.9 * @category Combinator */ export const provideAllWithEnv = FE.provideAllWithEnv({ ...FromEnv, ...ProvideAll, ...Chain }) /** * @since 0.13.9 * @category Combinator */ export const provideSomeWithEnv = FE.provideSomeWithEnv({ ...FromEnv, ...ProvideSome, ...Chain }) /** * @since 0.13.9 * @category Combinator */ export const useSomeWithEnv = FE.useSomeWithEnv({ ...FromEnv, ...UseSome, ...Chain }) /** * @since 0.13.9 * @category Combinator */ export const useAllWithEnv = FE.useAllWithEnv({ ...FromEnv, ...UseAll, ...Chain }) /** * @since 0.13.9 * @category Instance */ export const FromReaderStream: FRS.FromReaderStream3 = { fromReaderStream, } /** * @since 0.13.9 * @category Combinator */ export const chainFirstReaderStreamK = FRS.chainFirstReaderStreamK(FromReaderStream, Chain) /** * @since 0.13.9 * @category Combinator */ export const chainReaderStreamK = FRS.chainReaderStreamK(FromReaderStream, Chain) /** * @since 0.13.9 * @category Constructor */ export const fromReaderStreamK = FRS.fromReaderStreamK(FromReaderStream) /** * @since 0.13.9 * @category Combinator */ export const provideAllWithReaderStream = FRS.provideAllWithReaderStream({ ...FromReaderStream, ...ProvideAll, ...Chain, }) /** * @since 0.13.9 * @category Combinator */ export const provideSomeWithReaderStream = FRS.provideSomeWithReaderStream({ ...FromReaderStream, ...ProvideSome, ...Chain, }) /** * @since 0.13.9 * @category Combinator */ export const useSomeWithReaderStream = FRS.useSomeWithReaderStream({ ...FromReaderStream, ...UseSome, ...Chain, }) /** * @since 0.13.9 * @category Combinator */ export const useAllWithReaderStream = FRS.useAllWithReaderStream({ ...FromReaderStream, ...UseAll, ...Chain, })