/**
* @since 3.14.0
* @experimental
*/
import * as Context from "./Context.js";
import type * as Duration from "./Duration.js";
import * as Effect from "./Effect.js";
import * as Layer from "./Layer.js";
import * as RcMap from "./RcMap.js";
import * as Runtime from "./Runtime.js";
import * as Scope from "./Scope.js";
/**
* @since 3.14.0
* @category Symbols
*/
export declare const TypeId: unique symbol;
/**
* @since 3.14.0
* @category Symbols
*/
export type TypeId = typeof TypeId;
/**
* @since 3.14.0
* @category Models
* @experimental
*/
export interface LayerMap<in K, in out I, out E = never> {
readonly [TypeId]: TypeId;
/**
* The internal RcMap that stores the resources.
*/
readonly rcMap: RcMap.RcMap<K, {
readonly layer: Layer.Layer<I, E>;
readonly runtimeEffect: Effect.Effect<Runtime.Runtime<I>, E, Scope.Scope>;
}, E>;
/**
* Retrieves a Layer for the resources associated with the key.
*/
get(key: K): Layer.Layer<I, E>;
/**
* Retrieves a Runtime for the resources associated with the key.
*/
runtime(key: K): Effect.Effect<Runtime.Runtime<I>, E, Scope.Scope>;
/**
* Invalidates the resource associated with the key.
*/
invalidate(key: K): Effect.Effect<void>;
}
/**
* @since 3.14.0
* @category Constructors
* @experimental
*
* A `LayerMap` allows you to create a map of Layer's that can be used to
* dynamically access resources based on a key.
*
* ```ts
* import { NodeRuntime } from "@effect/platform-node"
* import { Context, Effect, FiberRef, Layer, LayerMap } from "effect"
*
* class Greeter extends Context.Tag("Greeter")<Greeter, {
* greet: Effect.Effect<string>
* }>() {}
*
* // create a service that wraps a LayerMap
* class GreeterMap extends LayerMap.Service<GreeterMap>()("GreeterMap", {
* // define the lookup function for the layer map
* //
* // The returned Layer will be used to provide the Greeter service for the
* // given name.
* lookup: (name: string) =>
* Layer.succeed(Greeter, {
* greet: Effect.succeed(`Hello, ${name}!`)
* }).pipe(
* Layer.merge(Layer.locallyScoped(FiberRef.currentConcurrency, 123))
* ),
*
* // If a layer is not used for a certain amount of time, it can be removed
* idleTimeToLive: "5 seconds",
*
* // Supply the dependencies for the layers in the LayerMap
* dependencies: []
* }) {}
*
* // usage
* const program: Effect.Effect<void, never, GreeterMap> = Effect.gen(function*() {
* // access and use the Greeter service
* const greeter = yield* Greeter
* yield* Effect.log(yield* greeter.greet)
* }).pipe(
* // use the GreeterMap service to provide a variant of the Greeter service
* Effect.provide(GreeterMap.get("John"))
* )
*
* // run the program
* program.pipe(
* Effect.provide(GreeterMap.Default),
* NodeRuntime.runMain
* )
* ```
*/
export declare const make: <K, L extends Layer.Layer<any, any, any>>(lookup: (key: K) => L, options?: {
readonly idleTimeToLive?: Duration.DurationInput | undefined;
} | undefined) => Effect.Effect<LayerMap<K, L extends Layer.Layer<infer _A, infer _E, infer _R> ? _A : never, L extends Layer.Layer<infer _A, infer _E, infer _R> ? _E : never>, never, Scope.Scope | (L extends Layer.Layer<infer _A, infer _E, infer _R> ? _R : never)>;
/**
* @since 3.14.0
* @category Constructors
* @experimental
*/
export declare const fromRecord: <const Layers extends Record<string, Layer.Layer<any, any, any>>>(layers: Layers, options?: {
readonly idleTimeToLive?: Duration.DurationInput | undefined;
} | undefined) => Effect.Effect<LayerMap<keyof Layers, Layers[keyof Layers] extends Layer.Layer<infer _A, infer _E, infer _R> ? _A : never, Layers[keyof Layers] extends Layer.Layer<infer _A, infer _E_1, infer _R_1> ? _E_1 : never>, never, Scope.Scope | (Layers[keyof Layers] extends Layer.Layer<infer _A, infer _E_2, infer _R_2> ? _R_2 : never)>;
/**
* @since 3.14.0
* @category Service
*/
export interface TagClass<in out Self, in out Id extends string, in out K, in out I, in out E, in out R, in out Deps extends Layer.Layer<any, any, any>> extends Context.TagClass<Self, Id, LayerMap<K, I, E>> {
/**
* A default layer for the `LayerMap` service.
*/
readonly Default: Layer.Layer<Self, (Deps extends Layer.Layer<infer _A, infer _E, infer _R> ? _E : never), Exclude<R, (Deps extends Layer.Layer<infer _A, infer _E, infer _R> ? _A : never)> | (Deps extends Layer.Layer<infer _A, infer _E, infer _R> ? _R : never)>;
/**
* A default layer for the `LayerMap` service without the dependencies provided.
*/
readonly DefaultWithoutDependencies: Layer.Layer<Self, never, R>;
/**
* Retrieves a Layer for the resources associated with the key.
*/
readonly get: (key: K) => Layer.Layer<I, E, Self>;
/**
* Retrieves a Runtime for the resources associated with the key.
*/
readonly runtime: (key: K) => Effect.Effect<Runtime.Runtime<I>, E, Scope.Scope | Self>;
/**
* Invalidates the resource associated with the key.
*/
readonly invalidate: (key: K) => Effect.Effect<void, never, Self>;
}
/**
* @since 3.14.0
* @category Service
* @experimental
*
* Create a `LayerMap` service that provides a dynamic set of resources based on
* a key.
*
* ```ts
* import { NodeRuntime } from "@effect/platform-node"
* import { Context, Effect, FiberRef, Layer, LayerMap } from "effect"
*
* class Greeter extends Context.Tag("Greeter")<Greeter, {
* greet: Effect.Effect<string>
* }>() {}
*
* // create a service that wraps a LayerMap
* class GreeterMap extends LayerMap.Service<GreeterMap>()("GreeterMap", {
* // define the lookup function for the layer map
* //
* // The returned Layer will be used to provide the Greeter service for the
* // given name.
* lookup: (name: string) =>
* Layer.succeed(Greeter, {
* greet: Effect.succeed(`Hello, ${name}!`)
* }).pipe(
* Layer.merge(Layer.locallyScoped(FiberRef.currentConcurrency, 123))
* ),
*
* // If a layer is not used for a certain amount of time, it can be removed
* idleTimeToLive: "5 seconds",
*
* // Supply the dependencies for the layers in the LayerMap
* dependencies: []
* }) {}
*
* // usage
* const program: Effect.Effect<void, never, GreeterMap> = Effect.gen(function*() {
* // access and use the Greeter service
* const greeter = yield* Greeter
* yield* Effect.log(yield* greeter.greet)
* }).pipe(
* // use the GreeterMap service to provide a variant of the Greeter service
* Effect.provide(GreeterMap.get("John"))
* )
*
* // run the program
* program.pipe(
* Effect.provide(GreeterMap.Default),
* NodeRuntime.runMain
* )
* ```
*/
export declare const Service: <Self>() => <const Id extends string, Lookup extends {
readonly lookup: (key: any) => Layer.Layer<any, any, any>;
} | {
readonly layers: Record<string, Layer.Layer<any, any, any>>;
}, const Deps extends ReadonlyArray<Layer.Layer<any, any, any>> = []>(id: Id, options: Lookup & {
readonly dependencies?: Deps | undefined;
readonly idleTimeToLive?: Duration.DurationInput | undefined;
}) => TagClass<Self, Id, Lookup extends {
readonly lookup: (key: infer K) => any;
} ? K : Lookup extends {
readonly layers: infer Layers;
} ? keyof Layers : never, Service.Success<Lookup>, Service.Error<Lookup>, Service.Context<Lookup>, Deps[number]>;
/**
* @since 3.14.0
* @category Service
* @experimental
*/
export declare namespace Service {
/**
* @since 3.14.0
* @category Service
* @experimental
*/
type Key<Options> = Options extends {
readonly lookup: (key: infer K) => any;
} ? K : Options extends {
readonly layers: infer Layers;
} ? keyof Layers : never;
/**
* @since 3.14.0
* @category Service
* @experimental
*/
type Layers<Options> = Options extends {
readonly lookup: (key: infer _K) => infer Layers;
} ? Layers : Options extends {
readonly layers: infer Layers;
} ? Layers[keyof Layers] : never;
/**
* @since 3.14.0
* @category Service
* @experimental
*/
type Success<Options> = Layers<Options> extends Layer.Layer<infer _A, infer _E, infer _R> ? _A : never;
/**
* @since 3.14.0
* @category Service
* @experimental
*/
type Error<Options> = Layers<Options> extends Layer.Layer<infer _A, infer _E, infer _R> ? _E : never;
/**
* @since 3.14.0
* @category Service
* @experimental
*/
type Context<Options> = Layers<Options> extends Layer.Layer<infer _A, infer _E, infer _R> ? _R : never;
}
//# sourceMappingURL=LayerMap.d.ts.map