UNPKG

veffect

Version:

powerful TypeScript validation library built on the robust foundation of Effect combining exceptional type safety, high performance, and developer experience. Taking inspiration from Effect's functional principles, VEffect delivers a balanced approach tha

79 lines 2.48 kB
/** * @since 2.0.0 */ import type * as Effect from "./Effect.js"; import type * as Schedule from "./Schedule.js"; import type * as Scope from "./Scope.js"; import type * as Types from "./Types.js"; /** * @since 2.0.0 * @category symbols */ export declare const ResourceTypeId: unique symbol; /** * @since 2.0.0 * @category symbols */ export type ResourceTypeId = typeof ResourceTypeId; /** * A `Resource` is a possibly resourceful value that is loaded into memory, and * which can be refreshed either manually or automatically. * * @since 2.0.0 * @category models */ export interface Resource<in out A, in out E = never> extends Resource.Variance<A, E> { } /** * @since 2.0.0 */ export declare namespace Resource { /** * @since 2.0.0 * @category models */ interface Variance<in out A, in out E> { readonly [ResourceTypeId]: { _A: Types.Invariant<A>; _E: Types.Invariant<E>; }; } } /** * Creates a new `Resource` value that is automatically refreshed according to * the specified policy. Note that error retrying is not performed * automatically, so if you want to retry on errors, you should first apply * retry policies to the acquisition effect before passing it to this * constructor. * * @since 2.0.0 * @category constructors */ export declare const auto: <A, E, R, Out, R2>(acquire: Effect.Effect<A, E, R>, policy: Schedule.Schedule<Out, unknown, R2>) => Effect.Effect<Resource<A, E>, never, R | R2 | Scope.Scope>; /** * Retrieves the current value stored in the cache. * * @since 2.0.0 * @category getters */ export declare const get: <A, E>(self: Resource<A, E>) => Effect.Effect<A, E>; /** * Creates a new `Resource` value that must be manually refreshed by calling * the refresh method. Note that error retrying is not performed * automatically, so if you want to retry on errors, you should first apply * retry policies to the acquisition effect before passing it to this * constructor. * * @since 2.0.0 * @category constructors */ export declare const manual: <A, E, R>(acquire: Effect.Effect<A, E, R>) => Effect.Effect<Resource<A, E>, never, Scope.Scope | R>; /** * Refreshes the cache. This method will not return until either the refresh * is successful, or the refresh operation fails. * * @since 2.0.0 * @category utils */ export declare const refresh: <A, E>(self: Resource<A, E>) => Effect.Effect<void, E>; //# sourceMappingURL=Resource.d.ts.map