336 lines
14 KiB
TypeScript
336 lines
14 KiB
TypeScript
|
/**
|
||
|
* The `FromEither` type class represents those data types which support errors.
|
||
|
*
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
import { Chain, Chain1, Chain2, Chain2C, Chain3, Chain3C, Chain4 } from './Chain'
|
||
|
import { Either } from './Either'
|
||
|
import { Lazy } from './function'
|
||
|
import { HKT2, Kind, Kind2, Kind3, Kind4, URIS, URIS2, URIS3, URIS4 } from './HKT'
|
||
|
import { Option } from './Option'
|
||
|
import { Predicate } from './Predicate'
|
||
|
import { Refinement } from './Refinement'
|
||
|
/**
|
||
|
* @category model
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export interface FromEither<F> {
|
||
|
readonly URI: F
|
||
|
readonly fromEither: <E, A>(e: Either<E, A>) => HKT2<F, E, A>
|
||
|
}
|
||
|
/**
|
||
|
* @category model
|
||
|
* @since 2.11.0
|
||
|
*/
|
||
|
export interface FromEither1<F extends URIS> {
|
||
|
readonly URI: F
|
||
|
readonly fromEither: <A>(fa: Either<unknown, A>) => Kind<F, A>
|
||
|
}
|
||
|
/**
|
||
|
* @category model
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export interface FromEither2<F extends URIS2> {
|
||
|
readonly URI: F
|
||
|
readonly fromEither: <E, A>(fa: Either<E, A>) => Kind2<F, E, A>
|
||
|
}
|
||
|
/**
|
||
|
* @category model
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export interface FromEither2C<F extends URIS2, E> {
|
||
|
readonly URI: F
|
||
|
readonly _E: E
|
||
|
readonly fromEither: <A>(fa: Either<E, A>) => Kind2<F, E, A>
|
||
|
}
|
||
|
/**
|
||
|
* @category model
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export interface FromEither3<F extends URIS3> {
|
||
|
readonly URI: F
|
||
|
readonly fromEither: <E, A, R>(fa: Either<E, A>) => Kind3<F, R, E, A>
|
||
|
}
|
||
|
/**
|
||
|
* @category model
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export interface FromEither3C<F extends URIS3, E> {
|
||
|
readonly URI: F
|
||
|
readonly _E: E
|
||
|
readonly fromEither: <A, R>(fa: Either<E, A>) => Kind3<F, R, E, A>
|
||
|
}
|
||
|
/**
|
||
|
* @category model
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export interface FromEither4<F extends URIS4> {
|
||
|
readonly URI: F
|
||
|
readonly fromEither: <E, A, S, R>(fa: Either<E, A>) => Kind4<F, S, R, E, A>
|
||
|
}
|
||
|
/**
|
||
|
* @category constructors
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export declare function fromOption<F extends URIS4>(
|
||
|
F: FromEither4<F>
|
||
|
): <E>(onNone: Lazy<E>) => <A, S, R>(fa: Option<A>) => Kind4<F, S, R, E, A>
|
||
|
export declare function fromOption<F extends URIS3>(
|
||
|
F: FromEither3<F>
|
||
|
): <E>(onNone: Lazy<E>) => <A, R>(fa: Option<A>) => Kind3<F, R, E, A>
|
||
|
export declare function fromOption<F extends URIS3, E>(
|
||
|
F: FromEither3C<F, E>
|
||
|
): (onNone: Lazy<E>) => <A, R>(fa: Option<A>) => Kind3<F, R, E, A>
|
||
|
export declare function fromOption<F extends URIS2>(
|
||
|
F: FromEither2<F>
|
||
|
): <E>(onNone: Lazy<E>) => <A>(fa: Option<A>) => Kind2<F, E, A>
|
||
|
export declare function fromOption<F extends URIS2, E>(
|
||
|
F: FromEither2C<F, E>
|
||
|
): (onNone: Lazy<E>) => <A>(fa: Option<A>) => Kind2<F, E, A>
|
||
|
export declare function fromOption<F>(F: FromEither<F>): <E>(onNone: Lazy<E>) => <A>(ma: Option<A>) => HKT2<F, E, A>
|
||
|
/**
|
||
|
* @category lifting
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export declare function fromPredicate<F extends URIS4>(
|
||
|
F: FromEither4<F>
|
||
|
): {
|
||
|
<A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <S, R>(a: A) => Kind4<F, S, R, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <S, R, B extends A>(b: B) => Kind4<F, S, R, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <S, R>(a: A) => Kind4<F, S, R, E, A>
|
||
|
}
|
||
|
export declare function fromPredicate<F extends URIS3>(
|
||
|
F: FromEither3<F>
|
||
|
): {
|
||
|
<A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <R>(a: A) => Kind3<F, R, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <R, B extends A>(b: B) => Kind3<F, R, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <R>(a: A) => Kind3<F, R, E, A>
|
||
|
}
|
||
|
export declare function fromPredicate<F extends URIS3, E>(
|
||
|
F: FromEither3C<F, E>
|
||
|
): {
|
||
|
<A, B extends A>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <R>(a: A) => Kind3<F, R, E, B>
|
||
|
<A>(predicate: Predicate<A>, onFalse: (a: A) => E): <R, B extends A>(b: B) => Kind3<F, R, E, B>
|
||
|
<A>(predicate: Predicate<A>, onFalse: (a: A) => E): <R>(a: A) => Kind3<F, R, E, A>
|
||
|
}
|
||
|
export declare function fromPredicate<F extends URIS2>(
|
||
|
F: FromEither2<F>
|
||
|
): {
|
||
|
<A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (a: A) => Kind2<F, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(b: B) => Kind2<F, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): (a: A) => Kind2<F, E, A>
|
||
|
}
|
||
|
export declare function fromPredicate<F extends URIS2, E>(
|
||
|
F: FromEither2C<F, E>
|
||
|
): {
|
||
|
<A, B extends A>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (a: A) => Kind2<F, E, B>
|
||
|
<A>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(b: B) => Kind2<F, E, B>
|
||
|
<A>(predicate: Predicate<A>, onFalse: (a: A) => E): (a: A) => Kind2<F, E, A>
|
||
|
}
|
||
|
export declare function fromPredicate<F>(F: FromEither<F>): {
|
||
|
<A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (a: A) => HKT2<F, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(b: B) => HKT2<F, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): (a: A) => HKT2<F, E, A>
|
||
|
}
|
||
|
/**
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export declare function fromOptionK<F extends URIS4>(
|
||
|
F: FromEither4<F>
|
||
|
): <E>(
|
||
|
onNone: Lazy<E>
|
||
|
) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => <S, R>(...a: A) => Kind4<F, S, R, E, B>
|
||
|
export declare function fromOptionK<F extends URIS3>(
|
||
|
F: FromEither3<F>
|
||
|
): <E>(
|
||
|
onNone: Lazy<E>
|
||
|
) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => <R>(...a: A) => Kind3<F, R, E, B>
|
||
|
export declare function fromOptionK<F extends URIS3, E>(
|
||
|
F: FromEither3C<F, E>
|
||
|
): (
|
||
|
onNone: Lazy<E>
|
||
|
) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => <R>(...a: A) => Kind3<F, R, E, B>
|
||
|
export declare function fromOptionK<F extends URIS2>(
|
||
|
F: FromEither2<F>
|
||
|
): <E>(
|
||
|
onNone: Lazy<E>
|
||
|
) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => (...a: A) => Kind2<F, E, B>
|
||
|
export declare function fromOptionK<F extends URIS2, E>(
|
||
|
F: FromEither2C<F, E>
|
||
|
): (onNone: Lazy<E>) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => (...a: A) => Kind2<F, E, B>
|
||
|
export declare function fromOptionK<F>(
|
||
|
F: FromEither<F>
|
||
|
): <E>(
|
||
|
onNone: Lazy<E>
|
||
|
) => <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Option<B>) => (...a: A) => HKT2<F, E, B>
|
||
|
/**
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export declare function chainOptionK<F extends URIS4>(
|
||
|
F: FromEither4<F>,
|
||
|
M: Chain4<F>
|
||
|
): <E>(onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => <S, R>(ma: Kind4<F, S, R, E, A>) => Kind4<F, S, R, E, B>
|
||
|
export declare function chainOptionK<F extends URIS3>(
|
||
|
F: FromEither3<F>,
|
||
|
M: Chain3<F>
|
||
|
): <E>(onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => <R>(ma: Kind3<F, R, E, A>) => Kind3<F, R, E, B>
|
||
|
export declare function chainOptionK<F extends URIS3, E>(
|
||
|
F: FromEither3C<F, E>,
|
||
|
M: Chain3C<F, E>
|
||
|
): (onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => <R>(ma: Kind3<F, R, E, A>) => Kind3<F, R, E, B>
|
||
|
export declare function chainOptionK<F extends URIS2>(
|
||
|
F: FromEither2<F>,
|
||
|
M: Chain2<F>
|
||
|
): <E>(onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => (ma: Kind2<F, E, A>) => Kind2<F, E, B>
|
||
|
export declare function chainOptionK<F extends URIS2, E>(
|
||
|
F: FromEither2C<F, E>,
|
||
|
M: Chain2C<F, E>
|
||
|
): (onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => (ma: Kind2<F, E, A>) => Kind2<F, E, B>
|
||
|
export declare function chainOptionK<F>(
|
||
|
F: FromEither<F>,
|
||
|
M: Chain<F>
|
||
|
): <E>(onNone: Lazy<E>) => <A, B>(f: (a: A) => Option<B>) => (ma: HKT2<F, E, A>) => HKT2<F, E, B>
|
||
|
/**
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export declare function fromEitherK<F extends URIS4>(
|
||
|
F: FromEither4<F>
|
||
|
): <A extends ReadonlyArray<unknown>, E, B>(f: (...a: A) => Either<E, B>) => <S, R>(...a: A) => Kind4<F, S, R, E, B>
|
||
|
export declare function fromEitherK<F extends URIS3>(
|
||
|
F: FromEither3<F>
|
||
|
): <A extends ReadonlyArray<unknown>, E, B>(f: (...a: A) => Either<E, B>) => <R>(...a: A) => Kind3<F, R, E, B>
|
||
|
export declare function fromEitherK<F extends URIS3, E>(
|
||
|
F: FromEither3C<F, E>
|
||
|
): <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Either<E, B>) => <R>(...a: A) => Kind3<F, R, E, B>
|
||
|
export declare function fromEitherK<F extends URIS2>(
|
||
|
F: FromEither2<F>
|
||
|
): <A extends ReadonlyArray<unknown>, E, B>(f: (...a: A) => Either<E, B>) => (...a: A) => Kind2<F, E, B>
|
||
|
export declare function fromEitherK<F extends URIS2, E>(
|
||
|
F: FromEither2C<F, E>
|
||
|
): <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Either<E, B>) => (...a: A) => Kind2<F, E, B>
|
||
|
export declare function fromEitherK<F extends URIS>(
|
||
|
F: FromEither1<F>
|
||
|
): <E, A extends ReadonlyArray<unknown>, B>(f: (...a: A) => Either<E, B>) => (...a: A) => Kind<F, B>
|
||
|
export declare function fromEitherK<F>(
|
||
|
F: FromEither<F>
|
||
|
): <A extends ReadonlyArray<unknown>, E, B>(f: (...a: A) => Either<E, B>) => (...a: A) => HKT2<F, E, B>
|
||
|
/**
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export declare function chainEitherK<M extends URIS4>(
|
||
|
F: FromEither4<M>,
|
||
|
M: Chain4<M>
|
||
|
): <A, E, B>(f: (a: A) => Either<E, B>) => <S, R>(ma: Kind4<M, S, R, E, A>) => Kind4<M, S, R, E, B>
|
||
|
export declare function chainEitherK<M extends URIS3>(
|
||
|
F: FromEither3<M>,
|
||
|
M: Chain3<M>
|
||
|
): <A, E, B>(f: (a: A) => Either<E, B>) => <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, B>
|
||
|
export declare function chainEitherK<M extends URIS3, E>(
|
||
|
F: FromEither3C<M, E>,
|
||
|
M: Chain3C<M, E>
|
||
|
): <A, B>(f: (a: A) => Either<E, B>) => <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, B>
|
||
|
export declare function chainEitherK<M extends URIS2>(
|
||
|
F: FromEither2<M>,
|
||
|
M: Chain2<M>
|
||
|
): <A, E, B>(f: (a: A) => Either<E, B>) => (ma: Kind2<M, E, A>) => Kind2<M, E, B>
|
||
|
export declare function chainEitherK<M extends URIS2, E>(
|
||
|
F: FromEither2C<M, E>,
|
||
|
M: Chain2C<M, E>
|
||
|
): <A, B>(f: (a: A) => Either<E, B>) => (ma: Kind2<M, E, A>) => Kind2<M, E, B>
|
||
|
export declare function chainEitherK<M extends URIS>(
|
||
|
F: FromEither1<M>,
|
||
|
M: Chain1<M>
|
||
|
): <E, A, B>(f: (a: A) => Either<E, B>) => (ma: Kind<M, A>) => Kind<M, B>
|
||
|
export declare function chainEitherK<M>(
|
||
|
F: FromEither<M>,
|
||
|
M: Chain<M>
|
||
|
): <A, E, B>(f: (a: A) => Either<E, B>) => (ma: HKT2<M, E, A>) => HKT2<M, E, B>
|
||
|
/**
|
||
|
* @since 2.12.0
|
||
|
*/
|
||
|
export declare function chainFirstEitherK<M extends URIS4>(
|
||
|
F: FromEither4<M>,
|
||
|
M: Chain4<M>
|
||
|
): <A, E, B>(f: (a: A) => Either<E, B>) => <S, R>(ma: Kind4<M, S, R, E, A>) => Kind4<M, S, R, E, A>
|
||
|
export declare function chainFirstEitherK<M extends URIS3>(
|
||
|
F: FromEither3<M>,
|
||
|
M: Chain3<M>
|
||
|
): <A, E, B>(f: (a: A) => Either<E, B>) => <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, A>
|
||
|
export declare function chainFirstEitherK<M extends URIS3, E>(
|
||
|
F: FromEither3C<M, E>,
|
||
|
M: Chain3C<M, E>
|
||
|
): <A, B>(f: (a: A) => Either<E, B>) => <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, A>
|
||
|
export declare function chainFirstEitherK<M extends URIS2>(
|
||
|
F: FromEither2<M>,
|
||
|
M: Chain2<M>
|
||
|
): <A, E, B>(f: (a: A) => Either<E, B>) => (ma: Kind2<M, E, A>) => Kind2<M, E, A>
|
||
|
export declare function chainFirstEitherK<M extends URIS2, E>(
|
||
|
F: FromEither2C<M, E>,
|
||
|
M: Chain2C<M, E>
|
||
|
): <A, B>(f: (a: A) => Either<E, B>) => (ma: Kind2<M, E, A>) => Kind2<M, E, A>
|
||
|
export declare function chainFirstEitherK<M extends URIS>(
|
||
|
F: FromEither1<M>,
|
||
|
M: Chain1<M>
|
||
|
): <E, A, B>(f: (a: A) => Either<E, B>) => (ma: Kind<M, A>) => Kind<M, A>
|
||
|
export declare function chainFirstEitherK<M>(
|
||
|
F: FromEither<M>,
|
||
|
M: Chain<M>
|
||
|
): <A, E, B>(f: (a: A) => Either<E, B>) => (ma: HKT2<M, E, A>) => HKT2<M, E, A>
|
||
|
/**
|
||
|
* @since 2.10.0
|
||
|
*/
|
||
|
export declare function filterOrElse<M extends URIS4>(
|
||
|
F: FromEither4<M>,
|
||
|
M: Chain4<M>
|
||
|
): {
|
||
|
<A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <S, R>(
|
||
|
ma: Kind4<M, S, R, E, A>
|
||
|
) => Kind4<M, S, R, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <S, R, B extends A>(
|
||
|
mb: Kind4<M, S, R, E, B>
|
||
|
) => Kind4<M, S, R, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <S, R>(ma: Kind4<M, S, R, E, A>) => Kind4<M, S, R, E, A>
|
||
|
}
|
||
|
export declare function filterOrElse<M extends URIS3>(
|
||
|
F: FromEither3<M>,
|
||
|
M: Chain3<M>
|
||
|
): {
|
||
|
<A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <R>(
|
||
|
ma: Kind3<M, R, E, A>
|
||
|
) => Kind3<M, R, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <R, B extends A>(mb: Kind3<M, R, E, B>) => Kind3<M, R, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, A>
|
||
|
}
|
||
|
export declare function filterOrElse<M extends URIS3, E>(
|
||
|
F: FromEither3C<M, E>,
|
||
|
M: Chain3C<M, E>
|
||
|
): {
|
||
|
<A, B extends A>(refinement: Refinement<A, B>, onFalse: (a: A) => E): <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, B>
|
||
|
<A>(predicate: Predicate<A>, onFalse: (a: A) => E): <R, B extends A>(mb: Kind3<M, R, E, B>) => Kind3<M, R, E, B>
|
||
|
<A>(predicate: Predicate<A>, onFalse: (a: A) => E): <R>(ma: Kind3<M, R, E, A>) => Kind3<M, R, E, A>
|
||
|
}
|
||
|
export declare function filterOrElse<M extends URIS2>(
|
||
|
F: FromEither2<M>,
|
||
|
M: Chain2<M>
|
||
|
): {
|
||
|
<A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (ma: Kind2<M, E, A>) => Kind2<M, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(mb: Kind2<M, E, B>) => Kind2<M, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): (ma: Kind2<M, E, A>) => Kind2<M, E, A>
|
||
|
}
|
||
|
export declare function filterOrElse<M extends URIS2, E>(
|
||
|
F: FromEither2C<M, E>,
|
||
|
M: Chain2C<M, E>
|
||
|
): {
|
||
|
<A, B extends A>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (ma: Kind2<M, E, A>) => Kind2<M, E, B>
|
||
|
<A>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(mb: Kind2<M, E, B>) => Kind2<M, E, B>
|
||
|
<A>(predicate: Predicate<A>, onFalse: (a: A) => E): (ma: Kind2<M, E, A>) => Kind2<M, E, A>
|
||
|
}
|
||
|
export declare function filterOrElse<M extends URIS2>(
|
||
|
F: FromEither<M>,
|
||
|
M: Chain<M>
|
||
|
): {
|
||
|
<A, B extends A, E>(refinement: Refinement<A, B>, onFalse: (a: A) => E): (ma: HKT2<M, E, A>) => HKT2<M, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): <B extends A>(mb: HKT2<M, E, B>) => HKT2<M, E, B>
|
||
|
<A, E>(predicate: Predicate<A>, onFalse: (a: A) => E): (ma: HKT2<M, E, A>) => HKT2<M, E, A>
|
||
|
}
|