/** * Low-level helpers for making custom values behave like Effects. The module * exposes a prototype builder, an abstract base class, and a mixin that let * domain-specific values, such as service keys or configuration descriptions, * be evaluated by Effect and yielded inside `Effect.gen`. * * @stability stable * @since 4.0.0 */ import type * as Effect from "./Effect.ts"; import type * as Fiber from "./Fiber.ts"; /** * Create a low-level `Effect` prototype. * * **When to use** * * Use when you need to create a custom Effect-like value without extending a * class, by providing a label and an evaluate function that receives the * current fiber. * * **Details** * * When the effect is evaluated, it calls `evaluate` with the current fiber. * * @see {@link Class} for a class-based approach to defining custom Effect values * @see {@link Mixin} for wrapping an existing class constructor * * @stability stable * @category prototypes * @since 4.0.0 */ export declare const Prototype: >(options: { readonly label: string; readonly evaluate: (this: A, fiber: Fiber.Fiber) => Effect.Effect, Effect.Error, Effect.Services>; }) => Effect.Effect, Effect.Error, Effect.Services>; declare const Base: new () => Effect.Effect; /** * Provides an abstract class that can be extended to create an `Effect`. * * **When to use** * * Use as an abstract base class to define custom classes whose instances behave * as `Effect` values. * * @see {@link Prototype} for a lower-level primitive approach to creating custom Effect-like values without a class * @see {@link Mixin} for wrapping an existing class constructor * @stability stable * @category constructors * @since 2.0.0 */ export declare abstract class Class extends Base { abstract asEffect(): Effect.Effect; } type AsEffectReturn = Self extends { asEffect(): infer A extends Effect.Effect; } ? A : never; declare abstract class MixinBase extends Class { constructor(...args: ReadonlyArray); readonly [Effect.TypeId]: AsEffectReturn[Effect.TypeId]; [Symbol.iterator](): Effect.EffectIterator>; } /** * Returns a subclass of the provided class that inserts the Effect prototype * into the inheritance chain. * * **When to use** * * Use to make instances of an existing class behave as `Effect` values without * extending {@link Class} or modifying the original prototype. * * **Details** * * Pass the class to wrap, then implement `asEffect` on the final class. The * returned class is abstract, and the success, error, and service types are * inferred from the concrete `asEffect` return type. Concrete and abstract base * classes are supported. Constructor parameters and instance members are * preserved, except that Effect's prototype members shadow base prototype * members with the same name: `pipe`, `toString`, `toJSON`, `[Symbol.iterator]`, * and `[Symbol.for("nodejs.util.inspect.custom")]`. * * **Example** (Evaluating a mixed-in class) * * ```ts import.meta.vitest * import { Effect, Effectable } from "effect" * * class Box { * constructor(readonly value: number) {} * } * * class EffectBox extends Effectable.Mixin(Box) { * asEffect() { * return Effect.succeed(this.value) * } * } * * const box = new EffectBox(2) * Effect.isEffect(box) // => true * await Effect.runPromise(box) // => 2 * ``` * * @see {@link Prototype} for a lower-level primitive approach to creating custom Effect-like values without a class * @see {@link Class} for a base constructor to extend * @stability stable * @category constructors * @since 4.0.0 */ export declare const Mixin: ) => object>(klass: TBase) => TBase & typeof MixinBase; export {}; //# sourceMappingURL=Effectable.d.ts.map