/**
 * Shares scoped resources by key and releases them when no one is using them.
 *
 * An `RcMap` runs a lookup effect the first time a key is requested, shares the
 * in-progress or acquired resource with other callers for the same key, and
 * tracks each caller through its current `Scope`. When the last scope for a key
 * closes, the resource is released immediately or kept alive until its idle
 * time-to-live expires. Entries can also be explicitly invalidated. Capacity
 * limits do not evict entries: idle entries count toward capacity, and a new
 * key fails with `ExceededCapacityError` when the map is full. It is meant for
 * resource lifecycles such as clients, sessions, and connections, not as a
 * general mutable cache.
 *
 * @stability stable
 * @since 3.5.0
 */
import * as Cause from "./Cause.ts";
import * as Context from "./Context.ts";
import * as Deferred from "./Deferred.ts";
import * as Duration from "./Duration.ts";
import * as Effect from "./Effect.ts";
import * as Fiber from "./Fiber.ts";
import * as MutableHashMap from "./MutableHashMap.ts";
import type * as Option from "./Option.ts";
import type { Pipeable } from "./Pipeable.ts";
import * as Scope from "./Scope.ts";
declare const TypeId = "~effect/RcMap";
/**
 * An `RcMap` is a reference-counted map data structure that manages the lifecycle
 * of resources indexed by keys. Resources are lazily acquired and automatically
 * released when no longer in use.
 *
 * **When to use**
 *
 * Use to share scoped resources by key while automatically releasing them after
 * their last active reference is gone.
 *
 * **Example** (Inspecting a reference-counted map)
 *
 * ```ts import.meta.vitest
 * import { Effect, RcMap } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   // Create an RcMap that manages database connections
 *   const dbConnectionMap = yield* RcMap.make({
 *     lookup: (dbName: string) =>
 *       Effect.acquireRelease(Effect.succeed(`Connection to ${dbName}`), () => Effect.void),
 *     capacity: 10,
 *     idleTimeToLive: "5 minutes"
 *   })
 *
 *   // The RcMap interface provides access to:
 *   // - lookup: Function to acquire resources
 *   // - capacity: Maximum number of resources
 *   // - idleTimeToLive: Time before idle resources are released
 *   // - state: Current state of the map
 *
 *   return dbConnectionMap.capacity
 * })
 *
 * await Effect.runPromise(Effect.scoped(program)) // => 10
 * ```
 *
 * @see {@link make} for creating an `RcMap`
 * @see {@link get} for acquiring or retaining a resource by key
 *
 * @stability stable
 * @category models
 * @since 3.5.0
 */
export interface RcMap<in out K, in out A, in out E = never> extends Pipeable {
    readonly [TypeId]: typeof TypeId;
    readonly lookup: (key: K) => Effect.Effect<A, E, Scope.Scope>;
    readonly context: Context.Context<never>;
    readonly scope: Scope.Scope;
    readonly idleTimeToLive: (key: K) => Duration.Duration;
    readonly capacity: number;
    state: State<K, A, E>;
}
/**
 * Represents the internal state of an RcMap, which can be either Open (active)
 * or Closed (shutdown and no longer accepting operations).
 *
 * **When to use**
 *
 * Use when typing code that inspects an `RcMap`'s `state` field and narrows
 * between open and closed lifecycle states.
 *
 * @see {@link RcMap} for the map value that exposes this state
 * @see {@link State.Open} for the active state with entries
 * @see {@link State.Closed} for the shutdown state
 *
 * @stability stable
 * @category models
 * @since 4.0.0
 */
export type State<K, A, E> = State.Open<K, A, E> | State.Closed;
/**
 * Namespace containing the internal state types for RcMap.
 *
 * **When to use**
 *
 * Use when referring to the concrete open, closed, and entry state shapes used
 * by `RcMap`.
 *
 * @stability stable
 * @since 4.0.0
 */
export declare namespace State {
    /**
     * Represents the open/active state of an RcMap, containing the actual
     * resource map that stores entries.
     *
     * **When to use**
     *
     * Use when handling an `RcMap` that can still accept operations and contains
     * stored entries.
     *
     * @category models
     * @since 4.0.0
     */
    interface Open<K, A, E> {
        readonly _tag: "Open";
        readonly map: MutableHashMap.MutableHashMap<K, Entry<A, E>>;
    }
    /**
     * Represents the closed state of an RcMap, indicating that the map has been
     * shut down and will no longer accept new operations.
     *
     * **When to use**
     *
     * Use when handling an `RcMap` after its owning scope has closed.
     *
     * @category models
     * @since 4.0.0
     */
    interface Closed {
        readonly _tag: "Closed";
    }
    /**
     * Represents an individual entry in the RcMap, containing the resource's
     * metadata including reference count, expiration time, and lifecycle management.
     *
     * **When to use**
     *
     * Use when inspecting the stored resource, reference count, and idle lifecycle
     * metadata for a single key.
     *
     * @category models
     * @since 4.0.0
     */
    interface Entry<A, E> {
        readonly deferred: Deferred.Deferred<A, E>;
        readonly scope: Scope.Closeable;
        readonly finalizer: Effect.Effect<void>;
        readonly idleTimeToLive: Duration.Duration;
        fiber: Fiber.Fiber<void> | undefined;
        expiresAt: number;
        refCount: number;
    }
}
/**
 * Creates an `RcMap` that can contain multiple reference counted resources that can be indexed
 * by a key. The resources are lazily acquired on the first call to `get` and
 * released when the last reference is released.
 *
 * **When to use**
 *
 * Use to create a scoped reference-counted map for resources that should be
 * acquired once per key and shared while in use.
 *
 * **Details**
 *
 * Complex keys can extend `Equal` and `Hash` to allow lookups by value.
 *
 * - `capacity`: The maximum number of entries, including idle entries. A new key
 *   fails with `ExceededCapacityError` when full; existing entries are not evicted.
 * - `idleTimeToLive`: When the reference count reaches zero, the resource will be released after this duration.
 *
 * **Example** (Creating a reference-counted map)
 *
 * ```ts import.meta.vitest
 * import { Effect, RcMap } from "effect"
 *
 * const events: Array<string> = []
 *
 * const program = Effect.gen(function*() {
 *   const map = yield* RcMap.make({
 *     lookup: (key: string) =>
 *       Effect.acquireRelease(
 *         Effect.succeed(`acquired ${key}`),
 *         () => Effect.sync(() => events.push(`released ${key}`))
 *       )
 *   })
 *
 *   // Get "foo" from the map twice, which will only acquire it once.
 *   // It will then be released once the scope closes.
 *   yield* RcMap.get(map, "foo").pipe(
 *     Effect.andThen(RcMap.get(map, "foo")),
 *     Effect.scoped
 *   )
 * })
 *
 * await Effect.runPromise(Effect.scoped(program))
 * events // => ["released foo"]
 * ```
 *
 * @see {@link get} for acquiring or retaining a resource by key
 * @see {@link invalidate} for removing a resource from the map
 *
 * @stability stable
 * @category constructors
 * @since 3.5.0
 */
export declare const make: {
    /**
     * Creates an `RcMap` that can contain multiple reference counted resources that can be indexed
     * by a key. The resources are lazily acquired on the first call to `get` and
     * released when the last reference is released.
     *
     * **When to use**
     *
     * Use to create a scoped reference-counted map for resources that should be
     * acquired once per key and shared while in use.
     *
     * **Details**
     *
     * Complex keys can extend `Equal` and `Hash` to allow lookups by value.
     *
     * - `capacity`: The maximum number of entries, including idle entries. A new key
     *   fails with `ExceededCapacityError` when full; existing entries are not evicted.
     * - `idleTimeToLive`: When the reference count reaches zero, the resource will be released after this duration.
     *
     * **Example** (Creating a reference-counted map)
     *
     * ```ts import.meta.vitest
     * import { Effect, RcMap } from "effect"
     *
     * const events: Array<string> = []
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) =>
     *       Effect.acquireRelease(
     *         Effect.succeed(`acquired ${key}`),
     *         () => Effect.sync(() => events.push(`released ${key}`))
     *       )
     *   })
     *
     *   // Get "foo" from the map twice, which will only acquire it once.
     *   // It will then be released once the scope closes.
     *   yield* RcMap.get(map, "foo").pipe(
     *     Effect.andThen(RcMap.get(map, "foo")),
     *     Effect.scoped
     *   )
     * })
     *
     * await Effect.runPromise(Effect.scoped(program))
     * events // => ["released foo"]
     * ```
     *
     * @see {@link get} for acquiring or retaining a resource by key
     * @see {@link invalidate} for removing a resource from the map
     *
     * @stability stable
     * @category constructors
     * @since 3.5.0
     */
    <K, A, E, R>(options: {
        readonly lookup: (key: K) => Effect.Effect<A, E, R>;
        readonly idleTimeToLive?: Duration.Input | ((key: K) => Duration.Input) | undefined;
        readonly capacity?: undefined;
    }): Effect.Effect<RcMap<K, A, E>, never, Scope.Scope | R>;
    /**
     * Creates an `RcMap` that can contain multiple reference counted resources that can be indexed
     * by a key. The resources are lazily acquired on the first call to `get` and
     * released when the last reference is released.
     *
     * **When to use**
     *
     * Use to create a scoped reference-counted map for resources that should be
     * acquired once per key and shared while in use.
     *
     * **Details**
     *
     * Complex keys can extend `Equal` and `Hash` to allow lookups by value.
     *
     * - `capacity`: The maximum number of entries, including idle entries. A new key
     *   fails with `ExceededCapacityError` when full; existing entries are not evicted.
     * - `idleTimeToLive`: When the reference count reaches zero, the resource will be released after this duration.
     *
     * **Example** (Creating a reference-counted map)
     *
     * ```ts import.meta.vitest
     * import { Effect, RcMap } from "effect"
     *
     * const events: Array<string> = []
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) =>
     *       Effect.acquireRelease(
     *         Effect.succeed(`acquired ${key}`),
     *         () => Effect.sync(() => events.push(`released ${key}`))
     *       )
     *   })
     *
     *   // Get "foo" from the map twice, which will only acquire it once.
     *   // It will then be released once the scope closes.
     *   yield* RcMap.get(map, "foo").pipe(
     *     Effect.andThen(RcMap.get(map, "foo")),
     *     Effect.scoped
     *   )
     * })
     *
     * await Effect.runPromise(Effect.scoped(program))
     * events // => ["released foo"]
     * ```
     *
     * @see {@link get} for acquiring or retaining a resource by key
     * @see {@link invalidate} for removing a resource from the map
     *
     * @stability stable
     * @category constructors
     * @since 3.5.0
     */
    <K, A, E, R>(options: {
        readonly lookup: (key: K) => Effect.Effect<A, E, R>;
        readonly idleTimeToLive?: Duration.Input | ((key: K) => Duration.Input) | undefined;
        readonly capacity: number;
    }): Effect.Effect<RcMap<K, A, E | Cause.ExceededCapacityError>, never, Scope.Scope | R>;
};
/**
 * Gets the resource for a key, acquiring it with the map's lookup function when
 * the key is not already cached.
 *
 * **When to use**
 *
 * Use to acquire or retain the resource for a key within the current scope.
 *
 * **Details**
 *
 * The resource's reference count is incremented for the current `Scope`, and a
 * release finalizer is added to that scope. When the current scope closes, the
 * reference is released; the resource is closed when the last reference is
 * released, subject to the map's idle time-to-live setting.
 *
 * **Example** (Acquiring a resource)
 *
 * ```ts import.meta.vitest
 * import { Effect, RcMap } from "effect"
 *
 * const events: Array<string> = []
 *
 * const program = Effect.gen(function*() {
 *   const map = yield* RcMap.make({
 *     lookup: (key: string) =>
 *       Effect.acquireRelease(
 *         Effect.succeed(`Resource: ${key}`),
 *         () => Effect.sync(() => events.push(`released ${key}`))
 *       )
 *   })
 *
 *   // Get a resource - it will be acquired on first access
 *   const resource = yield* RcMap.get(map, "database")
 *   return [resource, events] as const
 * })
 *
 * await Effect.runPromise(Effect.scoped(program)) // => ["Resource: database", ["released database"]]
 * ```
 *
 * @see {@link make} for creating the reference-counted map
 * @see {@link invalidate} for removing a resource by key
 *
 * @stability stable
 * @category combinators
 * @since 3.5.0
 */
export declare const get: {
    /**
     * Gets the resource for a key, acquiring it with the map's lookup function when
     * the key is not already cached.
     *
     * **When to use**
     *
     * Use to acquire or retain the resource for a key within the current scope.
     *
     * **Details**
     *
     * The resource's reference count is incremented for the current `Scope`, and a
     * release finalizer is added to that scope. When the current scope closes, the
     * reference is released; the resource is closed when the last reference is
     * released, subject to the map's idle time-to-live setting.
     *
     * **Example** (Acquiring a resource)
     *
     * ```ts import.meta.vitest
     * import { Effect, RcMap } from "effect"
     *
     * const events: Array<string> = []
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) =>
     *       Effect.acquireRelease(
     *         Effect.succeed(`Resource: ${key}`),
     *         () => Effect.sync(() => events.push(`released ${key}`))
     *       )
     *   })
     *
     *   // Get a resource - it will be acquired on first access
     *   const resource = yield* RcMap.get(map, "database")
     *   return [resource, events] as const
     * })
     *
     * await Effect.runPromise(Effect.scoped(program)) // => ["Resource: database", ["released database"]]
     * ```
     *
     * @see {@link make} for creating the reference-counted map
     * @see {@link invalidate} for removing a resource by key
     *
     * @stability stable
     * @category combinators
     * @since 3.5.0
     */
    <K>(key: K): <A, E>(self: RcMap<K, A, E>) => Effect.Effect<A, E, Scope.Scope>;
    /**
     * Gets the resource for a key, acquiring it with the map's lookup function when
     * the key is not already cached.
     *
     * **When to use**
     *
     * Use to acquire or retain the resource for a key within the current scope.
     *
     * **Details**
     *
     * The resource's reference count is incremented for the current `Scope`, and a
     * release finalizer is added to that scope. When the current scope closes, the
     * reference is released; the resource is closed when the last reference is
     * released, subject to the map's idle time-to-live setting.
     *
     * **Example** (Acquiring a resource)
     *
     * ```ts import.meta.vitest
     * import { Effect, RcMap } from "effect"
     *
     * const events: Array<string> = []
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) =>
     *       Effect.acquireRelease(
     *         Effect.succeed(`Resource: ${key}`),
     *         () => Effect.sync(() => events.push(`released ${key}`))
     *       )
     *   })
     *
     *   // Get a resource - it will be acquired on first access
     *   const resource = yield* RcMap.get(map, "database")
     *   return [resource, events] as const
     * })
     *
     * await Effect.runPromise(Effect.scoped(program)) // => ["Resource: database", ["released database"]]
     * ```
     *
     * @see {@link make} for creating the reference-counted map
     * @see {@link invalidate} for removing a resource by key
     *
     * @stability stable
     * @category combinators
     * @since 3.5.0
     */
    <K, A, E>(self: RcMap<K, A, E>, key: K): Effect.Effect<A, E, Scope.Scope>;
};
/**
 * Retains and returns an existing resource without invoking the map's lookup
 * function when the key is missing.
 *
 * **When to use**
 *
 * Use when you only want to acquire a reference to a resource that is currently
 * cached.
 *
 * **Details**
 *
 * Returns `Option.none` when the key is not currently stored or the map is
 * closed. If an entry exists, its reference count is incremented for the current
 * `Scope` before awaiting its result. A successful entry returns
 * `Option.some(value)`, while an in-flight or cached failure fails with the same
 * error as `get`.
 *
 * **Example** (Retaining only cached resources)
 *
 * ```ts import.meta.vitest
 * import { Effect, Option, RcMap } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const map = yield* RcMap.make({
 *     lookup: (key: string) => Effect.succeed(`Resource: ${key}`),
 *     idleTimeToLive: "1 minute"
 *   })
 *
 *   const missing = yield* RcMap.getOption(map, "database")
 *   yield* Effect.scoped(RcMap.get(map, "database"))
 *   const cached = yield* Effect.scoped(RcMap.getOption("database")(map))
 *
 *   return [missing, cached] as const
 * })
 *
 * await Effect.runPromise(Effect.scoped(program)) // => [Option.none(), Option.some("Resource: database")]
 * ```
 *
 * @see {@link get} for acquiring a resource when the key is missing
 * @see {@link has} for checking presence without retaining or awaiting the entry
 *
 * @stability stable
 * @category combinators
 * @since 4.0.0
 */
export declare const getOption: {
    /**
     * Retains and returns an existing resource without invoking the map's lookup
     * function when the key is missing.
     *
     * **When to use**
     *
     * Use when you only want to acquire a reference to a resource that is currently
     * cached.
     *
     * **Details**
     *
     * Returns `Option.none` when the key is not currently stored or the map is
     * closed. If an entry exists, its reference count is incremented for the current
     * `Scope` before awaiting its result. A successful entry returns
     * `Option.some(value)`, while an in-flight or cached failure fails with the same
     * error as `get`.
     *
     * **Example** (Retaining only cached resources)
     *
     * ```ts import.meta.vitest
     * import { Effect, Option, RcMap } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) => Effect.succeed(`Resource: ${key}`),
     *     idleTimeToLive: "1 minute"
     *   })
     *
     *   const missing = yield* RcMap.getOption(map, "database")
     *   yield* Effect.scoped(RcMap.get(map, "database"))
     *   const cached = yield* Effect.scoped(RcMap.getOption("database")(map))
     *
     *   return [missing, cached] as const
     * })
     *
     * await Effect.runPromise(Effect.scoped(program)) // => [Option.none(), Option.some("Resource: database")]
     * ```
     *
     * @see {@link get} for acquiring a resource when the key is missing
     * @see {@link has} for checking presence without retaining or awaiting the entry
     *
     * @stability stable
     * @category combinators
     * @since 4.0.0
     */
    <K>(key: K): <A, E>(self: RcMap<K, A, E>) => Effect.Effect<Option.Option<A>, E, Scope.Scope>;
    /**
     * Retains and returns an existing resource without invoking the map's lookup
     * function when the key is missing.
     *
     * **When to use**
     *
     * Use when you only want to acquire a reference to a resource that is currently
     * cached.
     *
     * **Details**
     *
     * Returns `Option.none` when the key is not currently stored or the map is
     * closed. If an entry exists, its reference count is incremented for the current
     * `Scope` before awaiting its result. A successful entry returns
     * `Option.some(value)`, while an in-flight or cached failure fails with the same
     * error as `get`.
     *
     * **Example** (Retaining only cached resources)
     *
     * ```ts import.meta.vitest
     * import { Effect, Option, RcMap } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) => Effect.succeed(`Resource: ${key}`),
     *     idleTimeToLive: "1 minute"
     *   })
     *
     *   const missing = yield* RcMap.getOption(map, "database")
     *   yield* Effect.scoped(RcMap.get(map, "database"))
     *   const cached = yield* Effect.scoped(RcMap.getOption("database")(map))
     *
     *   return [missing, cached] as const
     * })
     *
     * await Effect.runPromise(Effect.scoped(program)) // => [Option.none(), Option.some("Resource: database")]
     * ```
     *
     * @see {@link get} for acquiring a resource when the key is missing
     * @see {@link has} for checking presence without retaining or awaiting the entry
     *
     * @stability stable
     * @category combinators
     * @since 4.0.0
     */
    <K, A, E>(self: RcMap<K, A, E>, key: K): Effect.Effect<Option.Option<A>, E, Scope.Scope>;
};
/**
 * Returns an iterable of all keys currently stored in the `RcMap`.
 *
 * **When to use**
 *
 * Use to inspect which keys currently have stored resources in an `RcMap`.
 *
 * **Details**
 *
 * If the `RcMap` has been closed, the effect is interrupted.
 *
 * **Example** (Listing keys)
 *
 * ```ts import.meta.vitest
 * import { Effect, RcMap } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const map = yield* RcMap.make({
 *     lookup: (key: string) => Effect.succeed(`value-${key}`)
 *   })
 *
 *   // Add some resources to the map
 *   yield* RcMap.get(map, "foo")
 *   yield* RcMap.get(map, "bar")
 *   yield* RcMap.get(map, "baz")
 *
 *   // Get all keys currently in the map
 *   const allKeys = yield* RcMap.keys(map)
 *   return Array.from(allKeys)
 * })
 *
 * await Effect.runPromise(Effect.scoped(program)) // => ["foo", "bar", "baz"]
 * ```
 *
 * @see {@link has} for checking one key without enumerating all keys
 *
 * @stability stable
 * @category combinators
 * @since 3.8.0
 */
export declare const keys: <K, A, E>(self: RcMap<K, A, E>) => Effect.Effect<Iterable<K>>;
/**
 * Invalidates and removes a specific key from the RcMap. If the resource is not
 * currently in use (reference count is 0), it will be immediately released.
 *
 * **When to use**
 *
 * Use to remove a resource by key so the next access performs a fresh lookup.
 *
 * **Example** (Invalidating a resource)
 *
 * ```ts import.meta.vitest
 * import { Effect, RcMap } from "effect"
 *
 * const events: Array<string> = []
 *
 * const program = Effect.gen(function*() {
 *   const map = yield* RcMap.make({
 *     lookup: (key: string) =>
 *       Effect.acquireRelease(
 *         Effect.succeed(`Resource: ${key}`),
 *         () => Effect.sync(() => events.push(`released ${key}`))
 *       )
 *   })
 *
 *   // Get a resource
 *   yield* RcMap.get(map, "cache")
 *
 *   // Invalidate the resource - it will be removed from the map
 *   // and released if no longer in use
 *   yield* RcMap.invalidate(map, "cache")
 *
 *   // Next access will create a new resource
 *   yield* RcMap.get(map, "cache")
 * })
 *
 * await Effect.runPromise(Effect.scoped(program))
 * events // => ["released cache", "released cache"]
 * ```
 *
 * @see {@link get} for acquiring or retaining the resource for a key
 * @see {@link touch} for extending the idle lifetime without removing the entry
 *
 * @stability stable
 * @category combinators
 * @since 3.13.0
 */
export declare const invalidate: {
    /**
     * Invalidates and removes a specific key from the RcMap. If the resource is not
     * currently in use (reference count is 0), it will be immediately released.
     *
     * **When to use**
     *
     * Use to remove a resource by key so the next access performs a fresh lookup.
     *
     * **Example** (Invalidating a resource)
     *
     * ```ts import.meta.vitest
     * import { Effect, RcMap } from "effect"
     *
     * const events: Array<string> = []
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) =>
     *       Effect.acquireRelease(
     *         Effect.succeed(`Resource: ${key}`),
     *         () => Effect.sync(() => events.push(`released ${key}`))
     *       )
     *   })
     *
     *   // Get a resource
     *   yield* RcMap.get(map, "cache")
     *
     *   // Invalidate the resource - it will be removed from the map
     *   // and released if no longer in use
     *   yield* RcMap.invalidate(map, "cache")
     *
     *   // Next access will create a new resource
     *   yield* RcMap.get(map, "cache")
     * })
     *
     * await Effect.runPromise(Effect.scoped(program))
     * events // => ["released cache", "released cache"]
     * ```
     *
     * @see {@link get} for acquiring or retaining the resource for a key
     * @see {@link touch} for extending the idle lifetime without removing the entry
     *
     * @stability stable
     * @category combinators
     * @since 3.13.0
     */
    <K>(key: K): <A, E>(self: RcMap<K, A, E>) => Effect.Effect<void>;
    /**
     * Invalidates and removes a specific key from the RcMap. If the resource is not
     * currently in use (reference count is 0), it will be immediately released.
     *
     * **When to use**
     *
     * Use to remove a resource by key so the next access performs a fresh lookup.
     *
     * **Example** (Invalidating a resource)
     *
     * ```ts import.meta.vitest
     * import { Effect, RcMap } from "effect"
     *
     * const events: Array<string> = []
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) =>
     *       Effect.acquireRelease(
     *         Effect.succeed(`Resource: ${key}`),
     *         () => Effect.sync(() => events.push(`released ${key}`))
     *       )
     *   })
     *
     *   // Get a resource
     *   yield* RcMap.get(map, "cache")
     *
     *   // Invalidate the resource - it will be removed from the map
     *   // and released if no longer in use
     *   yield* RcMap.invalidate(map, "cache")
     *
     *   // Next access will create a new resource
     *   yield* RcMap.get(map, "cache")
     * })
     *
     * await Effect.runPromise(Effect.scoped(program))
     * events // => ["released cache", "released cache"]
     * ```
     *
     * @see {@link get} for acquiring or retaining the resource for a key
     * @see {@link touch} for extending the idle lifetime without removing the entry
     *
     * @stability stable
     * @category combinators
     * @since 3.13.0
     */
    <K, A, E>(self: RcMap<K, A, E>, key: K): Effect.Effect<void>;
};
/**
 * Returns whether the `RcMap` currently contains an entry for the specified
 * key.
 *
 * **When to use**
 *
 * Use to check whether a key is already present in an `RcMap` without running
 * the lookup function or acquiring a missing resource.
 *
 * **Details**
 *
 * This operation only checks the current map state.
 *
 * **Gotchas**
 *
 * Closed maps return `false`, so `false` does not distinguish a missing key
 * from a closed map.
 *
 * @see {@link get} for acquiring or retaining the resource for a key
 * @see {@link keys} for enumerating all currently stored keys
 *
 * @stability stable
 * @category combinators
 * @since 3.17.7
 */
export declare const has: {
    /**
     * Returns whether the `RcMap` currently contains an entry for the specified
     * key.
     *
     * **When to use**
     *
     * Use to check whether a key is already present in an `RcMap` without running
     * the lookup function or acquiring a missing resource.
     *
     * **Details**
     *
     * This operation only checks the current map state.
     *
     * **Gotchas**
     *
     * Closed maps return `false`, so `false` does not distinguish a missing key
     * from a closed map.
     *
     * @see {@link get} for acquiring or retaining the resource for a key
     * @see {@link keys} for enumerating all currently stored keys
     *
     * @stability stable
     * @category combinators
     * @since 3.17.7
     */
    <K>(key: K): <A, E>(self: RcMap<K, A, E>) => Effect.Effect<boolean>;
    /**
     * Returns whether the `RcMap` currently contains an entry for the specified
     * key.
     *
     * **When to use**
     *
     * Use to check whether a key is already present in an `RcMap` without running
     * the lookup function or acquiring a missing resource.
     *
     * **Details**
     *
     * This operation only checks the current map state.
     *
     * **Gotchas**
     *
     * Closed maps return `false`, so `false` does not distinguish a missing key
     * from a closed map.
     *
     * @see {@link get} for acquiring or retaining the resource for a key
     * @see {@link keys} for enumerating all currently stored keys
     *
     * @stability stable
     * @category combinators
     * @since 3.17.7
     */
    <K, A, E>(self: RcMap<K, A, E>, key: K): Effect.Effect<boolean>;
};
/**
 * Extends the idle time for a resource in the RcMap. If the RcMap has an
 * `idleTimeToLive` configured, calling `touch` will reset the expiration
 * timer for the specified key.
 *
 * **When to use**
 *
 * Use to keep an idle resource alive longer without acquiring a new reference.
 *
 * **Example** (Extending resource idle time)
 *
 * ```ts import.meta.vitest
 * import { Effect, RcMap } from "effect"
 *
 * const events: Array<string> = []
 *
 * const program = Effect.gen(function*() {
 *   const map = yield* RcMap.make({
 *     lookup: (key: string) =>
 *       Effect.acquireRelease(
 *         Effect.succeed(`Resource: ${key}`),
 *         () => Effect.sync(() => events.push(`released ${key}`))
 *       ),
 *     idleTimeToLive: "10 seconds"
 *   })
 *
 *   // Get a resource
 *   yield* RcMap.get(map, "session")
 *
 *   // Touch the resource to extend its idle time
 *   // This resets the 10-second expiration timer
 *   yield* RcMap.touch(map, "session")
 *
 *   // The resource will now live for another 10 seconds
 *   // from the time it was touched
 * })
 *
 * await Effect.runPromise(Effect.scoped(program))
 * events // => ["released session"]
 * ```
 *
 * @see {@link invalidate} for removing the resource instead of extending it
 *
 * @stability stable
 * @category combinators
 * @since 3.13.0
 */
export declare const touch: {
    /**
     * Extends the idle time for a resource in the RcMap. If the RcMap has an
     * `idleTimeToLive` configured, calling `touch` will reset the expiration
     * timer for the specified key.
     *
     * **When to use**
     *
     * Use to keep an idle resource alive longer without acquiring a new reference.
     *
     * **Example** (Extending resource idle time)
     *
     * ```ts import.meta.vitest
     * import { Effect, RcMap } from "effect"
     *
     * const events: Array<string> = []
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) =>
     *       Effect.acquireRelease(
     *         Effect.succeed(`Resource: ${key}`),
     *         () => Effect.sync(() => events.push(`released ${key}`))
     *       ),
     *     idleTimeToLive: "10 seconds"
     *   })
     *
     *   // Get a resource
     *   yield* RcMap.get(map, "session")
     *
     *   // Touch the resource to extend its idle time
     *   // This resets the 10-second expiration timer
     *   yield* RcMap.touch(map, "session")
     *
     *   // The resource will now live for another 10 seconds
     *   // from the time it was touched
     * })
     *
     * await Effect.runPromise(Effect.scoped(program))
     * events // => ["released session"]
     * ```
     *
     * @see {@link invalidate} for removing the resource instead of extending it
     *
     * @stability stable
     * @category combinators
     * @since 3.13.0
     */
    <K>(key: K): <A, E>(self: RcMap<K, A, E>) => Effect.Effect<void>;
    /**
     * Extends the idle time for a resource in the RcMap. If the RcMap has an
     * `idleTimeToLive` configured, calling `touch` will reset the expiration
     * timer for the specified key.
     *
     * **When to use**
     *
     * Use to keep an idle resource alive longer without acquiring a new reference.
     *
     * **Example** (Extending resource idle time)
     *
     * ```ts import.meta.vitest
     * import { Effect, RcMap } from "effect"
     *
     * const events: Array<string> = []
     *
     * const program = Effect.gen(function*() {
     *   const map = yield* RcMap.make({
     *     lookup: (key: string) =>
     *       Effect.acquireRelease(
     *         Effect.succeed(`Resource: ${key}`),
     *         () => Effect.sync(() => events.push(`released ${key}`))
     *       ),
     *     idleTimeToLive: "10 seconds"
     *   })
     *
     *   // Get a resource
     *   yield* RcMap.get(map, "session")
     *
     *   // Touch the resource to extend its idle time
     *   // This resets the 10-second expiration timer
     *   yield* RcMap.touch(map, "session")
     *
     *   // The resource will now live for another 10 seconds
     *   // from the time it was touched
     * })
     *
     * await Effect.runPromise(Effect.scoped(program))
     * events // => ["released session"]
     * ```
     *
     * @see {@link invalidate} for removing the resource instead of extending it
     *
     * @stability stable
     * @category combinators
     * @since 3.13.0
     */
    <K, A, E>(self: RcMap<K, A, E>, key: K): Effect.Effect<void>;
};
export {};
//# sourceMappingURL=RcMap.d.ts.map