.opencode/node_modules/effect/dist/Cache.d.ts

import * as Deferred from "./Deferred.ts";
import * as Duration from "./Duration.ts";
import type * as Effect from "./Effect.ts";
import type * as Exit from "./Exit.ts";
import * as MutableHashMap from "./MutableHashMap.ts";
import * as Option from "./Option.ts";
import type { Pipeable } from "./Pipeable.ts";
import type { Predicate } from "./Predicate.ts";
declare const TypeId = "~effect/Cache";
/**
 * A cache interface that provides a mutable key-value store with automatic TTL management,
 * capacity limits, and lookup functions for cache misses.
 *
 * **Example** (Creating a basic cache)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Basic cache with string keys and number values
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make<string, number>({
 *     capacity: 100,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Cache operations
 *   const value1 = yield* Cache.get(cache, "hello") // 5
 *   const value2 = yield* Cache.get(cache, "world") // 5
 *   const value3 = yield* Cache.get(cache, "hello") // 5 (cached)
 *
 *   return [value1, value2, value3]
 * })
 * ```
 *
 * **Example** (Handling lookup failures)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Cache with error handling
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make<string, number, string>({
 *     capacity: 10,
 *     lookup: (key: string) =>
 *       key === "error"
 *         ? Effect.fail("Lookup failed")
 *         : Effect.succeed(key.length)
 *   })
 *
 *   // Handle successful and failed lookups
 *   const success = yield* Cache.get(cache, "test") // 4
 *   const failure = yield* Effect.exit(Cache.get(cache, "error")) // Exit.fail
 *
 *   return { success, failure }
 * })
 * ```
 *
 * **Example** (Using complex keys with TTL)
 *
 * ```ts
 * import { Cache, Data, Duration, Effect } from "effect"
 *
 * // Cache with complex key types and TTL
 * class UserId extends Data.Class<{ id: number }> {}
 *
 * const program = Effect.gen(function*() {
 *   const userCache = yield* Cache.make<UserId, string>({
 *     capacity: 1000,
 *     lookup: (userId: UserId) => Effect.succeed(`User-${userId.id}`),
 *     timeToLive: Duration.minutes(5)
 *   })
 *
 *   const userId = new UserId({ id: 123 })
 *   const userName = yield* Cache.get(userCache, userId)
 *
 *   return userName // "User-123"
 * })
 * ```
 *
 * @category models
 * @since 2.0.0
 */
export interface Cache<in out Key, in out A, in out E = never, out R = never> extends Pipeable {
    readonly [TypeId]: typeof TypeId;
    readonly map: MutableHashMap.MutableHashMap<Key, Entry<A, E>>;
    readonly capacity: number;
    readonly lookup: (key: Key) => Effect.Effect<A, E, R>;
    readonly timeToLive: (exit: Exit.Exit<A, E>, key: Key) => Duration.Duration;
}
/**
 * Represents a low-level cache entry containing a deferred lookup result and
 * an optional expiration timestamp.
 *
 * **When to use**
 *
 * Use when inspecting a `Cache`'s low-level map and you need the stored
 * deferred lookup result or expiration timestamp for a key.
 *
 * **Details**
 *
 * An `expiresAt` value of `undefined` means the entry does not expire.
 *
 * @see {@link Cache} for the public cache API that manages entries through
 * combinators
 *
 * @category models
 * @since 4.0.0
 */
export interface Entry<A, E> {
    expiresAt: number | undefined;
    readonly deferred: Deferred.Deferred<A, E>;
}
/**
 * Creates a cache with dynamic time-to-live based on the result and key.
 *
 * **When to use**
 *
 * Use when you need different cache entry lifetimes based on the lookup result
 * or key characteristics.
 *
 * **Details**
 *
 * The timeToLive function receives both the exit result and the key, allowing
 * for flexible TTL policies based on success/failure state and key characteristics.
 *
 * **Example** (Using dynamic time to live)
 *
 * ```ts
 * import { Cache, Effect, Exit } from "effect"
 *
 * // Cache with TTL based on computed value
 * const userCache = Effect.gen(function*() {
 *   const cache = yield* Cache.makeWith(
 *     (id: number) => Effect.succeed({ id, active: id % 2 === 0 }),
 *     {
 *       capacity: 1000,
 *       timeToLive(exit) {
 *         if (Exit.isSuccess(exit)) {
 *           const user = exit.value
 *           return user.active ? "1 hour" : "5 minutes"
 *         }
 *         return "30 seconds"
 *       }
 *     }
 *   )
 *
 *   return cache
 * })
 * ```
 *
 * @see {@link make} for a simpler cache constructor with a fixed time-to-live for all entries
 * @category constructors
 * @since 2.0.0
 */
export declare const makeWith: <Key, A, E = never, R = never, ServiceMode extends "lookup" | "construction" = never>(lookup: (key: Key) => Effect.Effect<A, E, R>, options: {
    readonly capacity: number;
    readonly timeToLive?: ((exit: Exit.Exit<A, E>, key: Key) => Duration.Input) | undefined;
    readonly requireServicesAt?: ServiceMode | undefined;
}) => Effect.Effect<Cache<Key, A, E, "lookup" extends ServiceMode ? R : never>, never, "lookup" extends ServiceMode ? never : R>;
/**
 * Creates a cache with a fixed time-to-live for all entries.
 *
 * **Details**
 *
 * This is the basic cache constructor where all entries share the same TTL.
 * The lookup function will be called when a key is not found or has expired.
 *
 * **Example** (Creating a basic cache)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Basic cache with string keys
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make<string, number>({
 *     capacity: 100,
 *     lookup: (key) => Effect.succeed(key.length)
 *   })
 *
 *   const result1 = yield* Cache.get(cache, "hello")
 *   const result2 = yield* Cache.get(cache, "world")
 *   console.log({ result1, result2 }) // { result1: 5, result2: 5 }
 * })
 * ```
 *
 * **Example** (Creating a cache with TTL)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const users = new Map([
 *     [123, { name: "Ada", email: "ada@example.com" }],
 *     [456, { name: "Grace", email: "grace@example.com" }]
 *   ])
 *
 *   const cache = yield* Cache.make<
 *     number,
 *     { name: string; email: string },
 *     string
 *   >({
 *     capacity: 500,
 *     lookup: (userId) =>
 *       Effect.suspend(() => {
 *         const user = users.get(userId)
 *         return user === undefined
 *           ? Effect.fail(`User ${userId} not found`)
 *           : Effect.succeed(user)
 *       }),
 *     timeToLive: "15 minutes"
 *   })
 *
 *   const user1 = yield* Cache.get(cache, 123)
 *   console.log(user1) // { name: "Ada", email: "ada@example.com" }
 *
 *   const user2 = yield* Cache.get(cache, 123)
 *   console.log(user2) // { name: "Ada", email: "ada@example.com" }
 * })
 * ```
 *
 * @category constructors
 * @since 2.0.0
 */
export declare const make: <Key, A, E = never, R = never, ServiceMode extends "lookup" | "construction" = never>(options: {
    readonly lookup: (key: Key) => Effect.Effect<A, E, R>;
    readonly capacity: number;
    readonly timeToLive?: Duration.Input | undefined;
    readonly requireServicesAt?: ServiceMode | undefined;
}) => Effect.Effect<Cache<Key, A, E, "lookup" extends ServiceMode ? R : never>, never, "lookup" extends ServiceMode ? never : R>;
/**
 * Retrieves the value for a key, invoking the lookup function on a cache miss
 * or expired entry.
 *
 * **Details**
 *
 * Concurrent `get` calls for the same missing key share the same pending
 * lookup. The cache stores the lookup `Exit`, so failed lookups are cached and
 * will fail again until the entry expires, is invalidated, or is refreshed.
 *
 * **Example** (Getting cached values)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Cache miss - triggers lookup function
 *   const result1 = yield* Cache.get(cache, "hello")
 *   console.log(result1) // 5
 *
 *   // Cache hit - returns cached value without lookup
 *   const result2 = yield* Cache.get(cache, "hello")
 *   console.log(result2) // 5 (from cache)
 *
 *   return { result1, result2 }
 * })
 * ```
 *
 * **Example** (Handling lookup failures)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Error handling when lookup fails
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make<string, number, string>({
 *     capacity: 10,
 *     lookup: (key: string) =>
 *       key === "error"
 *         ? Effect.fail("Lookup failed")
 *         : Effect.succeed(key.length)
 *   })
 *
 *   // Successful lookup
 *   const success = yield* Cache.get(cache, "hello")
 *   console.log(success) // 5
 *
 *   // Failed lookup - returns error
 *   const failure = yield* Effect.exit(Cache.get(cache, "error"))
 *   console.log(failure) // Exit.fail("Lookup failed")
 * })
 * ```
 *
 * **Example** (Sharing concurrent lookups)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Concurrent access - multiple gets of same key only invoke lookup once
 * const program = Effect.gen(function*() {
 *   let lookupCount = 0
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) =>
 *       Effect.sync(() => {
 *         lookupCount++
 *         return key.length
 *       })
 *   })
 *
 *   // Multiple concurrent gets
 *   const results = yield* Effect.all([
 *     Cache.get(cache, "hello"),
 *     Cache.get(cache, "hello"),
 *     Cache.get(cache, "hello")
 *   ], { concurrency: "unbounded" })
 *
 *   console.log(results) // [5, 5, 5]
 *   console.log(lookupCount) // 1 (lookup called only once)
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const get: {
    /**
     * Retrieves the value for a key, invoking the lookup function on a cache miss
     * or expired entry.
     *
     * **Details**
     *
     * Concurrent `get` calls for the same missing key share the same pending
     * lookup. The cache stores the lookup `Exit`, so failed lookups are cached and
     * will fail again until the entry expires, is invalidated, or is refreshed.
     *
     * **Example** (Getting cached values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Cache miss - triggers lookup function
     *   const result1 = yield* Cache.get(cache, "hello")
     *   console.log(result1) // 5
     *
     *   // Cache hit - returns cached value without lookup
     *   const result2 = yield* Cache.get(cache, "hello")
     *   console.log(result2) // 5 (from cache)
     *
     *   return { result1, result2 }
     * })
     * ```
     *
     * **Example** (Handling lookup failures)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Error handling when lookup fails
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make<string, number, string>({
     *     capacity: 10,
     *     lookup: (key: string) =>
     *       key === "error"
     *         ? Effect.fail("Lookup failed")
     *         : Effect.succeed(key.length)
     *   })
     *
     *   // Successful lookup
     *   const success = yield* Cache.get(cache, "hello")
     *   console.log(success) // 5
     *
     *   // Failed lookup - returns error
     *   const failure = yield* Effect.exit(Cache.get(cache, "error"))
     *   console.log(failure) // Exit.fail("Lookup failed")
     * })
     * ```
     *
     * **Example** (Sharing concurrent lookups)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Concurrent access - multiple gets of same key only invoke lookup once
     * const program = Effect.gen(function*() {
     *   let lookupCount = 0
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) =>
     *       Effect.sync(() => {
     *         lookupCount++
     *         return key.length
     *       })
     *   })
     *
     *   // Multiple concurrent gets
     *   const results = yield* Effect.all([
     *     Cache.get(cache, "hello"),
     *     Cache.get(cache, "hello"),
     *     Cache.get(cache, "hello")
     *   ], { concurrency: "unbounded" })
     *
     *   console.log(results) // [5, 5, 5]
     *   console.log(lookupCount) // 1 (lookup called only once)
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A>(key: Key): <E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<A, E, R>;
    /**
     * Retrieves the value for a key, invoking the lookup function on a cache miss
     * or expired entry.
     *
     * **Details**
     *
     * Concurrent `get` calls for the same missing key share the same pending
     * lookup. The cache stores the lookup `Exit`, so failed lookups are cached and
     * will fail again until the entry expires, is invalidated, or is refreshed.
     *
     * **Example** (Getting cached values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Cache miss - triggers lookup function
     *   const result1 = yield* Cache.get(cache, "hello")
     *   console.log(result1) // 5
     *
     *   // Cache hit - returns cached value without lookup
     *   const result2 = yield* Cache.get(cache, "hello")
     *   console.log(result2) // 5 (from cache)
     *
     *   return { result1, result2 }
     * })
     * ```
     *
     * **Example** (Handling lookup failures)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Error handling when lookup fails
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make<string, number, string>({
     *     capacity: 10,
     *     lookup: (key: string) =>
     *       key === "error"
     *         ? Effect.fail("Lookup failed")
     *         : Effect.succeed(key.length)
     *   })
     *
     *   // Successful lookup
     *   const success = yield* Cache.get(cache, "hello")
     *   console.log(success) // 5
     *
     *   // Failed lookup - returns error
     *   const failure = yield* Effect.exit(Cache.get(cache, "error"))
     *   console.log(failure) // Exit.fail("Lookup failed")
     * })
     * ```
     *
     * **Example** (Sharing concurrent lookups)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Concurrent access - multiple gets of same key only invoke lookup once
     * const program = Effect.gen(function*() {
     *   let lookupCount = 0
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) =>
     *       Effect.sync(() => {
     *         lookupCount++
     *         return key.length
     *       })
     *   })
     *
     *   // Multiple concurrent gets
     *   const results = yield* Effect.all([
     *     Cache.get(cache, "hello"),
     *     Cache.get(cache, "hello"),
     *     Cache.get(cache, "hello")
     *   ], { concurrency: "unbounded" })
     *
     *   console.log(results) // [5, 5, 5]
     *   console.log(lookupCount) // 1 (lookup called only once)
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A, E, R>(self: Cache<Key, A, E, R>, key: Key): Effect.Effect<A, E, R>;
};
/**
 * Reads an existing cache entry without invoking the lookup function.
 *
 * **Details**
 *
 * Returns `Option.none()` when the key is missing or expired, and `Option.some`
 * when a cached lookup has succeeded. If the entry is still pending, waits for
 * it to complete. If the cached or pending lookup fails, this effect fails with
 * the same error.
 *
 * **Example** (Reading cached values without lookup)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // No value in cache yet - returns None without lookup
 *   const empty = yield* Cache.getOption(cache, "hello")
 *   console.log(empty) // Option.none()
 *
 *   // Populate cache using get
 *   yield* Cache.get(cache, "hello")
 *
 *   // Now getOption returns the cached value
 *   const cached = yield* Cache.getOption(cache, "hello")
 *   console.log(cached) // Option.some(5)
 *
 *   return { empty, cached }
 * })
 * ```
 *
 * **Example** (Skipping expired entries)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 * import { TestClock } from "effect/testing"
 *
 * // Expired entries return None
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length),
 *     timeToLive: "1 hour"
 *   })
 *
 *   // Add value to cache
 *   yield* Cache.get(cache, "hello")
 *
 *   // Value exists before expiration
 *   const beforeExpiry = yield* Cache.getOption(cache, "hello")
 *   console.log(beforeExpiry) // Option.some(5)
 *
 *   // Simulate time passing
 *   yield* TestClock.adjust("2 hours")
 *
 *   // Value expired - returns None
 *   const afterExpiry = yield* Cache.getOption(cache, "hello")
 *   console.log(afterExpiry) // Option.none()
 * })
 * ```
 *
 * **Example** (Waiting for pending lookups)
 *
 * ```ts
 * import { Cache, Deferred, Effect, Fiber } from "effect"
 *
 * // Waits for ongoing computation to complete
 * const program = Effect.gen(function*() {
 *   const deferred = yield* Deferred.make<void>()
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (_key: string) => Deferred.await(deferred).pipe(Effect.as(42))
 *   })
 *
 *   // Start lookup in background
 *   const getFiber = yield* Effect.forkChild(Cache.get(cache, "key"))
 *
 *   // getOption waits for ongoing computation
 *   const optionFiber = yield* Effect.forkChild(Cache.getOption(cache, "key"))
 *
 *   // Complete the computation
 *   yield* Deferred.succeed(deferred, void 0)
 *
 *   const result = yield* Fiber.join(optionFiber)
 *   console.log(result) // Option.some(42)
 *
 *   const value = yield* Fiber.join(getFiber)
 *   console.log(value) // 42
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const getOption: {
    /**
     * Reads an existing cache entry without invoking the lookup function.
     *
     * **Details**
     *
     * Returns `Option.none()` when the key is missing or expired, and `Option.some`
     * when a cached lookup has succeeded. If the entry is still pending, waits for
     * it to complete. If the cached or pending lookup fails, this effect fails with
     * the same error.
     *
     * **Example** (Reading cached values without lookup)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // No value in cache yet - returns None without lookup
     *   const empty = yield* Cache.getOption(cache, "hello")
     *   console.log(empty) // Option.none()
     *
     *   // Populate cache using get
     *   yield* Cache.get(cache, "hello")
     *
     *   // Now getOption returns the cached value
     *   const cached = yield* Cache.getOption(cache, "hello")
     *   console.log(cached) // Option.some(5)
     *
     *   return { empty, cached }
     * })
     * ```
     *
     * **Example** (Skipping expired entries)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     * import { TestClock } from "effect/testing"
     *
     * // Expired entries return None
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length),
     *     timeToLive: "1 hour"
     *   })
     *
     *   // Add value to cache
     *   yield* Cache.get(cache, "hello")
     *
     *   // Value exists before expiration
     *   const beforeExpiry = yield* Cache.getOption(cache, "hello")
     *   console.log(beforeExpiry) // Option.some(5)
     *
     *   // Simulate time passing
     *   yield* TestClock.adjust("2 hours")
     *
     *   // Value expired - returns None
     *   const afterExpiry = yield* Cache.getOption(cache, "hello")
     *   console.log(afterExpiry) // Option.none()
     * })
     * ```
     *
     * **Example** (Waiting for pending lookups)
     *
     * ```ts
     * import { Cache, Deferred, Effect, Fiber } from "effect"
     *
     * // Waits for ongoing computation to complete
     * const program = Effect.gen(function*() {
     *   const deferred = yield* Deferred.make<void>()
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (_key: string) => Deferred.await(deferred).pipe(Effect.as(42))
     *   })
     *
     *   // Start lookup in background
     *   const getFiber = yield* Effect.forkChild(Cache.get(cache, "key"))
     *
     *   // getOption waits for ongoing computation
     *   const optionFiber = yield* Effect.forkChild(Cache.getOption(cache, "key"))
     *
     *   // Complete the computation
     *   yield* Deferred.succeed(deferred, void 0)
     *
     *   const result = yield* Fiber.join(optionFiber)
     *   console.log(result) // Option.some(42)
     *
     *   const value = yield* Fiber.join(getFiber)
     *   console.log(value) // 42
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A>(key: Key): <E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<Option.Option<A>, E>;
    /**
     * Reads an existing cache entry without invoking the lookup function.
     *
     * **Details**
     *
     * Returns `Option.none()` when the key is missing or expired, and `Option.some`
     * when a cached lookup has succeeded. If the entry is still pending, waits for
     * it to complete. If the cached or pending lookup fails, this effect fails with
     * the same error.
     *
     * **Example** (Reading cached values without lookup)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // No value in cache yet - returns None without lookup
     *   const empty = yield* Cache.getOption(cache, "hello")
     *   console.log(empty) // Option.none()
     *
     *   // Populate cache using get
     *   yield* Cache.get(cache, "hello")
     *
     *   // Now getOption returns the cached value
     *   const cached = yield* Cache.getOption(cache, "hello")
     *   console.log(cached) // Option.some(5)
     *
     *   return { empty, cached }
     * })
     * ```
     *
     * **Example** (Skipping expired entries)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     * import { TestClock } from "effect/testing"
     *
     * // Expired entries return None
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length),
     *     timeToLive: "1 hour"
     *   })
     *
     *   // Add value to cache
     *   yield* Cache.get(cache, "hello")
     *
     *   // Value exists before expiration
     *   const beforeExpiry = yield* Cache.getOption(cache, "hello")
     *   console.log(beforeExpiry) // Option.some(5)
     *
     *   // Simulate time passing
     *   yield* TestClock.adjust("2 hours")
     *
     *   // Value expired - returns None
     *   const afterExpiry = yield* Cache.getOption(cache, "hello")
     *   console.log(afterExpiry) // Option.none()
     * })
     * ```
     *
     * **Example** (Waiting for pending lookups)
     *
     * ```ts
     * import { Cache, Deferred, Effect, Fiber } from "effect"
     *
     * // Waits for ongoing computation to complete
     * const program = Effect.gen(function*() {
     *   const deferred = yield* Deferred.make<void>()
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (_key: string) => Deferred.await(deferred).pipe(Effect.as(42))
     *   })
     *
     *   // Start lookup in background
     *   const getFiber = yield* Effect.forkChild(Cache.get(cache, "key"))
     *
     *   // getOption waits for ongoing computation
     *   const optionFiber = yield* Effect.forkChild(Cache.getOption(cache, "key"))
     *
     *   // Complete the computation
     *   yield* Deferred.succeed(deferred, void 0)
     *
     *   const result = yield* Fiber.join(optionFiber)
     *   console.log(result) // Option.some(42)
     *
     *   const value = yield* Fiber.join(getFiber)
     *   console.log(value) // 42
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A, E, R>(self: Cache<Key, A, E, R>, key: Key): Effect.Effect<Option.Option<A>, E>;
};
/**
 * Retrieves the value associated with the specified key from the cache, only if
 * it contains a resolved successful value.
 *
 * **Details**
 *
 * This checks only an existing non-expired entry. It returns `Option.some` when
 * the entry has already resolved successfully, and `Option.none` for missing,
 * expired, failed, or still-pending entries.
 *
 * @see {@link get} for triggering or awaiting the cache lookup
 * @see {@link getOption} for reading an existing entry as an optional effect
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const getSuccess: {
    /**
     * Retrieves the value associated with the specified key from the cache, only if
     * it contains a resolved successful value.
     *
     * **Details**
     *
     * This checks only an existing non-expired entry. It returns `Option.some` when
     * the entry has already resolved successfully, and `Option.none` for missing,
     * expired, failed, or still-pending entries.
     *
     * @see {@link get} for triggering or awaiting the cache lookup
     * @see {@link getOption} for reading an existing entry as an optional effect
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A, R>(key: Key): <E>(self: Cache<Key, A, E, R>) => Effect.Effect<Option.Option<A>>;
    /**
     * Retrieves the value associated with the specified key from the cache, only if
     * it contains a resolved successful value.
     *
     * **Details**
     *
     * This checks only an existing non-expired entry. It returns `Option.some` when
     * the entry has already resolved successfully, and `Option.none` for missing,
     * expired, failed, or still-pending entries.
     *
     * @see {@link get} for triggering or awaiting the cache lookup
     * @see {@link getOption} for reading an existing entry as an optional effect
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A, E, R>(self: Cache<Key, A, E, R>, key: Key): Effect.Effect<Option.Option<A>>;
};
/**
 * Sets the value associated with the specified key in the cache. This will
 * overwrite any existing value for that key, skipping the lookup function.
 *
 * **Example** (Setting values directly)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 100,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Set a value directly without invoking lookup
 *   yield* Cache.set(cache, "hello", 42)
 *   const result = yield* Cache.get(cache, "hello")
 *   console.log(result) // 42 (not 5 from lookup)
 * })
 * ```
 *
 * **Example** (Overwriting cached values)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Overwriting existing cached values
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 100,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // First get populates via lookup
 *   const original = yield* Cache.get(cache, "test") // 4
 *
 *   // Set overwrites the cached value
 *   yield* Cache.set(cache, "test", 999)
 *   const updated = yield* Cache.get(cache, "test") // 999
 *
 *   console.log({ original, updated })
 * })
 * ```
 *
 * **Example** (Applying TTL to set values)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 * import { TestClock } from "effect/testing"
 *
 * // TTL behavior with set operations
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 100,
 *     lookup: (key: string) => Effect.succeed(key.length),
 *     timeToLive: "1 hour"
 *   })
 *
 *   // Set value with TTL applied
 *   yield* Cache.set(cache, "temporary", 123)
 *   console.log(yield* Cache.has(cache, "temporary")) // true
 *
 *   // Advance time past TTL
 *   yield* TestClock.adjust("2 hours")
 *   console.log(yield* Cache.has(cache, "temporary")) // false
 * })
 * ```
 *
 * **Example** (Enforcing capacity when setting values)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Capacity enforcement with set operations
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 2,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Fill cache to capacity
 *   yield* Cache.set(cache, "a", 1)
 *   yield* Cache.set(cache, "b", 2)
 *   console.log(yield* Cache.size(cache)) // 2
 *
 *   // Adding another entry evicts oldest
 *   yield* Cache.set(cache, "c", 3)
 *   console.log(yield* Cache.size(cache)) // 2
 *   console.log(yield* Cache.has(cache, "a")) // false (evicted)
 *   console.log(yield* Cache.has(cache, "c")) // true
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const set: {
    /**
     * Sets the value associated with the specified key in the cache. This will
     * overwrite any existing value for that key, skipping the lookup function.
     *
     * **Example** (Setting values directly)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Set a value directly without invoking lookup
     *   yield* Cache.set(cache, "hello", 42)
     *   const result = yield* Cache.get(cache, "hello")
     *   console.log(result) // 42 (not 5 from lookup)
     * })
     * ```
     *
     * **Example** (Overwriting cached values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Overwriting existing cached values
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // First get populates via lookup
     *   const original = yield* Cache.get(cache, "test") // 4
     *
     *   // Set overwrites the cached value
     *   yield* Cache.set(cache, "test", 999)
     *   const updated = yield* Cache.get(cache, "test") // 999
     *
     *   console.log({ original, updated })
     * })
     * ```
     *
     * **Example** (Applying TTL to set values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     * import { TestClock } from "effect/testing"
     *
     * // TTL behavior with set operations
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length),
     *     timeToLive: "1 hour"
     *   })
     *
     *   // Set value with TTL applied
     *   yield* Cache.set(cache, "temporary", 123)
     *   console.log(yield* Cache.has(cache, "temporary")) // true
     *
     *   // Advance time past TTL
     *   yield* TestClock.adjust("2 hours")
     *   console.log(yield* Cache.has(cache, "temporary")) // false
     * })
     * ```
     *
     * **Example** (Enforcing capacity when setting values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Capacity enforcement with set operations
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 2,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Fill cache to capacity
     *   yield* Cache.set(cache, "a", 1)
     *   yield* Cache.set(cache, "b", 2)
     *   console.log(yield* Cache.size(cache)) // 2
     *
     *   // Adding another entry evicts oldest
     *   yield* Cache.set(cache, "c", 3)
     *   console.log(yield* Cache.size(cache)) // 2
     *   console.log(yield* Cache.has(cache, "a")) // false (evicted)
     *   console.log(yield* Cache.has(cache, "c")) // true
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A>(key: Key, value: A): <E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<void>;
    /**
     * Sets the value associated with the specified key in the cache. This will
     * overwrite any existing value for that key, skipping the lookup function.
     *
     * **Example** (Setting values directly)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Set a value directly without invoking lookup
     *   yield* Cache.set(cache, "hello", 42)
     *   const result = yield* Cache.get(cache, "hello")
     *   console.log(result) // 42 (not 5 from lookup)
     * })
     * ```
     *
     * **Example** (Overwriting cached values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Overwriting existing cached values
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // First get populates via lookup
     *   const original = yield* Cache.get(cache, "test") // 4
     *
     *   // Set overwrites the cached value
     *   yield* Cache.set(cache, "test", 999)
     *   const updated = yield* Cache.get(cache, "test") // 999
     *
     *   console.log({ original, updated })
     * })
     * ```
     *
     * **Example** (Applying TTL to set values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     * import { TestClock } from "effect/testing"
     *
     * // TTL behavior with set operations
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length),
     *     timeToLive: "1 hour"
     *   })
     *
     *   // Set value with TTL applied
     *   yield* Cache.set(cache, "temporary", 123)
     *   console.log(yield* Cache.has(cache, "temporary")) // true
     *
     *   // Advance time past TTL
     *   yield* TestClock.adjust("2 hours")
     *   console.log(yield* Cache.has(cache, "temporary")) // false
     * })
     * ```
     *
     * **Example** (Enforcing capacity when setting values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Capacity enforcement with set operations
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 2,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Fill cache to capacity
     *   yield* Cache.set(cache, "a", 1)
     *   yield* Cache.set(cache, "b", 2)
     *   console.log(yield* Cache.size(cache)) // 2
     *
     *   // Adding another entry evicts oldest
     *   yield* Cache.set(cache, "c", 3)
     *   console.log(yield* Cache.size(cache)) // 2
     *   console.log(yield* Cache.has(cache, "a")) // false (evicted)
     *   console.log(yield* Cache.has(cache, "c")) // true
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A, E, R>(self: Cache<Key, A, E, R>, key: Key, value: A): Effect.Effect<void>;
};
/**
 * Checks whether the cache contains an entry for the specified key.
 *
 * **Details**
 *
 * This checks for an existing non-expired entry without invoking the cache
 * lookup function. Expired entries are treated as absent.
 *
 * **Example** (Checking for cached keys)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 100,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Check non-existent key
 *   console.log(yield* Cache.has(cache, "missing")) // false
 *
 *   // Add entry and check existence
 *   yield* Cache.get(cache, "hello")
 *   console.log(yield* Cache.has(cache, "hello")) // true
 * })
 * ```
 *
 * **Example** (Checking TTL expiration)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 * import { TestClock } from "effect/testing"
 *
 * // TTL expiration behavior
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 100,
 *     lookup: (key: string) => Effect.succeed(key.length),
 *     timeToLive: "1 hour"
 *   })
 *
 *   // Add entry with TTL
 *   yield* Cache.get(cache, "expires")
 *   console.log(yield* Cache.has(cache, "expires")) // true
 *
 *   // Still valid before expiration
 *   yield* TestClock.adjust("30 minutes")
 *   console.log(yield* Cache.has(cache, "expires")) // true
 *
 *   // Expired after TTL
 *   yield* TestClock.adjust("31 minutes")
 *   console.log(yield* Cache.has(cache, "expires")) // false
 * })
 * ```
 *
 * **Example** (Checking multiple keys)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Checking multiple keys efficiently
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 100,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Populate some entries
 *   yield* Cache.set(cache, "apple", 5)
 *   yield* Cache.set(cache, "banana", 6)
 *
 *   // Check multiple keys
 *   const keys = ["apple", "banana", "cherry", "date"]
 *   for (const key of keys) {
 *     const exists = yield* Cache.has(cache, key)
 *     console.log(`${key}: ${exists}`)
 *   }
 *   // Output:
 *   // apple: true
 *   // banana: true
 *   // cherry: false
 *   // date: false
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const has: {
    /**
     * Checks whether the cache contains an entry for the specified key.
     *
     * **Details**
     *
     * This checks for an existing non-expired entry without invoking the cache
     * lookup function. Expired entries are treated as absent.
     *
     * **Example** (Checking for cached keys)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Check non-existent key
     *   console.log(yield* Cache.has(cache, "missing")) // false
     *
     *   // Add entry and check existence
     *   yield* Cache.get(cache, "hello")
     *   console.log(yield* Cache.has(cache, "hello")) // true
     * })
     * ```
     *
     * **Example** (Checking TTL expiration)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     * import { TestClock } from "effect/testing"
     *
     * // TTL expiration behavior
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length),
     *     timeToLive: "1 hour"
     *   })
     *
     *   // Add entry with TTL
     *   yield* Cache.get(cache, "expires")
     *   console.log(yield* Cache.has(cache, "expires")) // true
     *
     *   // Still valid before expiration
     *   yield* TestClock.adjust("30 minutes")
     *   console.log(yield* Cache.has(cache, "expires")) // true
     *
     *   // Expired after TTL
     *   yield* TestClock.adjust("31 minutes")
     *   console.log(yield* Cache.has(cache, "expires")) // false
     * })
     * ```
     *
     * **Example** (Checking multiple keys)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Checking multiple keys efficiently
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Populate some entries
     *   yield* Cache.set(cache, "apple", 5)
     *   yield* Cache.set(cache, "banana", 6)
     *
     *   // Check multiple keys
     *   const keys = ["apple", "banana", "cherry", "date"]
     *   for (const key of keys) {
     *     const exists = yield* Cache.has(cache, key)
     *     console.log(`${key}: ${exists}`)
     *   }
     *   // Output:
     *   // apple: true
     *   // banana: true
     *   // cherry: false
     *   // date: false
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A>(key: Key): <E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<boolean>;
    /**
     * Checks whether the cache contains an entry for the specified key.
     *
     * **Details**
     *
     * This checks for an existing non-expired entry without invoking the cache
     * lookup function. Expired entries are treated as absent.
     *
     * **Example** (Checking for cached keys)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Check non-existent key
     *   console.log(yield* Cache.has(cache, "missing")) // false
     *
     *   // Add entry and check existence
     *   yield* Cache.get(cache, "hello")
     *   console.log(yield* Cache.has(cache, "hello")) // true
     * })
     * ```
     *
     * **Example** (Checking TTL expiration)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     * import { TestClock } from "effect/testing"
     *
     * // TTL expiration behavior
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length),
     *     timeToLive: "1 hour"
     *   })
     *
     *   // Add entry with TTL
     *   yield* Cache.get(cache, "expires")
     *   console.log(yield* Cache.has(cache, "expires")) // true
     *
     *   // Still valid before expiration
     *   yield* TestClock.adjust("30 minutes")
     *   console.log(yield* Cache.has(cache, "expires")) // true
     *
     *   // Expired after TTL
     *   yield* TestClock.adjust("31 minutes")
     *   console.log(yield* Cache.has(cache, "expires")) // false
     * })
     * ```
     *
     * **Example** (Checking multiple keys)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Checking multiple keys efficiently
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 100,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Populate some entries
     *   yield* Cache.set(cache, "apple", 5)
     *   yield* Cache.set(cache, "banana", 6)
     *
     *   // Check multiple keys
     *   const keys = ["apple", "banana", "cherry", "date"]
     *   for (const key of keys) {
     *     const exists = yield* Cache.has(cache, key)
     *     console.log(`${key}: ${exists}`)
     *   }
     *   // Output:
     *   // apple: true
     *   // banana: true
     *   // cherry: false
     *   // date: false
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A, E, R>(self: Cache<Key, A, E, R>, key: Key): Effect.Effect<boolean>;
};
/**
 * Invalidates the entry associated with the specified key in the cache.
 *
 * **Example** (Invalidating cached entries)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Add a value to the cache
 *   yield* Cache.get(cache, "hello")
 *   console.log(yield* Cache.has(cache, "hello")) // true
 *
 *   // Invalidate the entry
 *   yield* Cache.invalidate(cache, "hello")
 *   console.log(yield* Cache.has(cache, "hello")) // false
 *
 *   // Invalidating non-existent keys doesn't error
 *   yield* Cache.invalidate(cache, "nonexistent")
 *
 *   // Get after invalidation will invoke lookup again
 *   let lookupCount = 0
 *   const cache2 = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) =>
 *       Effect.sync(() => {
 *         lookupCount++
 *         return key.length
 *       })
 *   })
 *
 *   yield* Cache.get(cache2, "test") // lookupCount = 1
 *   yield* Cache.invalidate(cache2, "test")
 *   yield* Cache.get(cache2, "test") // lookupCount = 2 (lookup called again)
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const invalidate: {
    /**
     * Invalidates the entry associated with the specified key in the cache.
     *
     * **Example** (Invalidating cached entries)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Add a value to the cache
     *   yield* Cache.get(cache, "hello")
     *   console.log(yield* Cache.has(cache, "hello")) // true
     *
     *   // Invalidate the entry
     *   yield* Cache.invalidate(cache, "hello")
     *   console.log(yield* Cache.has(cache, "hello")) // false
     *
     *   // Invalidating non-existent keys doesn't error
     *   yield* Cache.invalidate(cache, "nonexistent")
     *
     *   // Get after invalidation will invoke lookup again
     *   let lookupCount = 0
     *   const cache2 = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) =>
     *       Effect.sync(() => {
     *         lookupCount++
     *         return key.length
     *       })
     *   })
     *
     *   yield* Cache.get(cache2, "test") // lookupCount = 1
     *   yield* Cache.invalidate(cache2, "test")
     *   yield* Cache.get(cache2, "test") // lookupCount = 2 (lookup called again)
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A>(key: Key): <E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<void>;
    /**
     * Invalidates the entry associated with the specified key in the cache.
     *
     * **Example** (Invalidating cached entries)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Add a value to the cache
     *   yield* Cache.get(cache, "hello")
     *   console.log(yield* Cache.has(cache, "hello")) // true
     *
     *   // Invalidate the entry
     *   yield* Cache.invalidate(cache, "hello")
     *   console.log(yield* Cache.has(cache, "hello")) // false
     *
     *   // Invalidating non-existent keys doesn't error
     *   yield* Cache.invalidate(cache, "nonexistent")
     *
     *   // Get after invalidation will invoke lookup again
     *   let lookupCount = 0
     *   const cache2 = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) =>
     *       Effect.sync(() => {
     *         lookupCount++
     *         return key.length
     *       })
     *   })
     *
     *   yield* Cache.get(cache2, "test") // lookupCount = 1
     *   yield* Cache.invalidate(cache2, "test")
     *   yield* Cache.get(cache2, "test") // lookupCount = 2 (lookup called again)
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A, E, R>(self: Cache<Key, A, E, R>, key: Key): Effect.Effect<void>;
};
/**
 * Invalidates the entry associated with the specified key in the cache when the
 * predicate returns true for the cached value.
 *
 * **Example** (Invalidating entries conditionally)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Add values to the cache
 *   yield* Cache.get(cache, "hello") // value = 5
 *   yield* Cache.get(cache, "hi") // value = 2
 *
 *   // Invalidate when value equals 5
 *   const invalidated1 = yield* Cache.invalidateWhen(
 *     cache,
 *     "hello",
 *     (value) => value === 5
 *   )
 *   console.log(invalidated1) // true
 *   console.log(yield* Cache.has(cache, "hello")) // false
 *
 *   // Don't invalidate when predicate doesn't match
 *   const invalidated2 = yield* Cache.invalidateWhen(
 *     cache,
 *     "hi",
 *     (value) => value === 5
 *   )
 *   console.log(invalidated2) // false
 *   console.log(yield* Cache.has(cache, "hi")) // true (still present)
 *
 *   // Returns false for non-existent keys
 *   const invalidated3 = yield* Cache.invalidateWhen(
 *     cache,
 *     "nonexistent",
 *     () => true
 *   )
 *   console.log(invalidated3) // false
 *
 *   // Returns false for failed cached values
 *   const cacheWithErrors = yield* Cache.make<string, number, string>({
 *     capacity: 10,
 *     lookup: (key: string) =>
 *       key === "fail" ? Effect.fail("error") : Effect.succeed(key.length)
 *   })
 *
 *   yield* Effect.exit(Cache.get(cacheWithErrors, "fail"))
 *   const invalidated4 = yield* Cache.invalidateWhen(
 *     cacheWithErrors,
 *     "fail",
 *     () => true
 *   )
 *   console.log(invalidated4) // false (can't invalidate failed values)
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const invalidateWhen: {
    /**
     * Invalidates the entry associated with the specified key in the cache when the
     * predicate returns true for the cached value.
     *
     * **Example** (Invalidating entries conditionally)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Add values to the cache
     *   yield* Cache.get(cache, "hello") // value = 5
     *   yield* Cache.get(cache, "hi") // value = 2
     *
     *   // Invalidate when value equals 5
     *   const invalidated1 = yield* Cache.invalidateWhen(
     *     cache,
     *     "hello",
     *     (value) => value === 5
     *   )
     *   console.log(invalidated1) // true
     *   console.log(yield* Cache.has(cache, "hello")) // false
     *
     *   // Don't invalidate when predicate doesn't match
     *   const invalidated2 = yield* Cache.invalidateWhen(
     *     cache,
     *     "hi",
     *     (value) => value === 5
     *   )
     *   console.log(invalidated2) // false
     *   console.log(yield* Cache.has(cache, "hi")) // true (still present)
     *
     *   // Returns false for non-existent keys
     *   const invalidated3 = yield* Cache.invalidateWhen(
     *     cache,
     *     "nonexistent",
     *     () => true
     *   )
     *   console.log(invalidated3) // false
     *
     *   // Returns false for failed cached values
     *   const cacheWithErrors = yield* Cache.make<string, number, string>({
     *     capacity: 10,
     *     lookup: (key: string) =>
     *       key === "fail" ? Effect.fail("error") : Effect.succeed(key.length)
     *   })
     *
     *   yield* Effect.exit(Cache.get(cacheWithErrors, "fail"))
     *   const invalidated4 = yield* Cache.invalidateWhen(
     *     cacheWithErrors,
     *     "fail",
     *     () => true
     *   )
     *   console.log(invalidated4) // false (can't invalidate failed values)
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A>(key: Key, f: Predicate<A>): <E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<boolean>;
    /**
     * Invalidates the entry associated with the specified key in the cache when the
     * predicate returns true for the cached value.
     *
     * **Example** (Invalidating entries conditionally)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length)
     *   })
     *
     *   // Add values to the cache
     *   yield* Cache.get(cache, "hello") // value = 5
     *   yield* Cache.get(cache, "hi") // value = 2
     *
     *   // Invalidate when value equals 5
     *   const invalidated1 = yield* Cache.invalidateWhen(
     *     cache,
     *     "hello",
     *     (value) => value === 5
     *   )
     *   console.log(invalidated1) // true
     *   console.log(yield* Cache.has(cache, "hello")) // false
     *
     *   // Don't invalidate when predicate doesn't match
     *   const invalidated2 = yield* Cache.invalidateWhen(
     *     cache,
     *     "hi",
     *     (value) => value === 5
     *   )
     *   console.log(invalidated2) // false
     *   console.log(yield* Cache.has(cache, "hi")) // true (still present)
     *
     *   // Returns false for non-existent keys
     *   const invalidated3 = yield* Cache.invalidateWhen(
     *     cache,
     *     "nonexistent",
     *     () => true
     *   )
     *   console.log(invalidated3) // false
     *
     *   // Returns false for failed cached values
     *   const cacheWithErrors = yield* Cache.make<string, number, string>({
     *     capacity: 10,
     *     lookup: (key: string) =>
     *       key === "fail" ? Effect.fail("error") : Effect.succeed(key.length)
     *   })
     *
     *   yield* Effect.exit(Cache.get(cacheWithErrors, "fail"))
     *   const invalidated4 = yield* Cache.invalidateWhen(
     *     cacheWithErrors,
     *     "fail",
     *     () => true
     *   )
     *   console.log(invalidated4) // false (can't invalidate failed values)
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A, E, R>(self: Cache<Key, A, E, R>, key: Key, f: Predicate<A>): Effect.Effect<boolean>;
};
/**
 * Forces a refresh of the value associated with the specified key in the cache.
 *
 * **Details**
 *
 * It will always invoke the lookup function to construct a new value,
 * overwriting any existing value for that key.
 *
 * **Example** (Refreshing cached values)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Force refresh of existing cached values
 * const program = Effect.gen(function*() {
 *   let counter = 0
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.sync(() => `${key}-${++counter}`)
 *   })
 *
 *   // Initial cache population
 *   const value1 = yield* Cache.get(cache, "user")
 *   console.log(value1) // "user-1"
 *
 *   // Get from cache (no lookup)
 *   const value2 = yield* Cache.get(cache, "user")
 *   console.log(value2) // "user-1" (same value)
 *
 *   // Force refresh - always calls lookup
 *   const refreshed = yield* Cache.refresh(cache, "user")
 *   console.log(refreshed) // "user-2" (new value)
 *
 *   // Subsequent gets return refreshed value
 *   const value3 = yield* Cache.get(cache, "user")
 *   console.log(value3) // "user-2"
 * })
 * ```
 *
 * **Example** (Resetting TTL on refresh)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 * import { TestClock } from "effect/testing"
 *
 * // Refresh resets TTL (Time To Live)
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length),
 *     timeToLive: "1 hour"
 *   })
 *
 *   yield* Cache.get(cache, "test")
 *   yield* TestClock.adjust("45 minutes")
 *
 *   // Entry would normally expire in 15 minutes
 *   console.log(yield* Cache.has(cache, "test")) // true
 *
 *   // Refresh resets the TTL to full 1 hour
 *   yield* Cache.refresh(cache, "test")
 *   yield* TestClock.adjust("30 minutes")
 *
 *   // Still valid because TTL was reset
 *   console.log(yield* Cache.has(cache, "test")) // true
 * })
 * ```
 *
 * **Example** (Refreshing missing keys)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Refresh non-existent keys
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(`value-for-${key}`)
 *   })
 *
 *   // Refresh non-existent key creates new entry
 *   const result = yield* Cache.refresh(cache, "newKey")
 *   console.log(result) // "value-for-newKey"
 *
 *   // Verify it's now cached
 *   console.log(yield* Cache.has(cache, "newKey")) // true
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const refresh: {
    /**
     * Forces a refresh of the value associated with the specified key in the cache.
     *
     * **Details**
     *
     * It will always invoke the lookup function to construct a new value,
     * overwriting any existing value for that key.
     *
     * **Example** (Refreshing cached values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Force refresh of existing cached values
     * const program = Effect.gen(function*() {
     *   let counter = 0
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.sync(() => `${key}-${++counter}`)
     *   })
     *
     *   // Initial cache population
     *   const value1 = yield* Cache.get(cache, "user")
     *   console.log(value1) // "user-1"
     *
     *   // Get from cache (no lookup)
     *   const value2 = yield* Cache.get(cache, "user")
     *   console.log(value2) // "user-1" (same value)
     *
     *   // Force refresh - always calls lookup
     *   const refreshed = yield* Cache.refresh(cache, "user")
     *   console.log(refreshed) // "user-2" (new value)
     *
     *   // Subsequent gets return refreshed value
     *   const value3 = yield* Cache.get(cache, "user")
     *   console.log(value3) // "user-2"
     * })
     * ```
     *
     * **Example** (Resetting TTL on refresh)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     * import { TestClock } from "effect/testing"
     *
     * // Refresh resets TTL (Time To Live)
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length),
     *     timeToLive: "1 hour"
     *   })
     *
     *   yield* Cache.get(cache, "test")
     *   yield* TestClock.adjust("45 minutes")
     *
     *   // Entry would normally expire in 15 minutes
     *   console.log(yield* Cache.has(cache, "test")) // true
     *
     *   // Refresh resets the TTL to full 1 hour
     *   yield* Cache.refresh(cache, "test")
     *   yield* TestClock.adjust("30 minutes")
     *
     *   // Still valid because TTL was reset
     *   console.log(yield* Cache.has(cache, "test")) // true
     * })
     * ```
     *
     * **Example** (Refreshing missing keys)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Refresh non-existent keys
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(`value-for-${key}`)
     *   })
     *
     *   // Refresh non-existent key creates new entry
     *   const result = yield* Cache.refresh(cache, "newKey")
     *   console.log(result) // "value-for-newKey"
     *
     *   // Verify it's now cached
     *   console.log(yield* Cache.has(cache, "newKey")) // true
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A>(key: Key): <E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<A, E, R>;
    /**
     * Forces a refresh of the value associated with the specified key in the cache.
     *
     * **Details**
     *
     * It will always invoke the lookup function to construct a new value,
     * overwriting any existing value for that key.
     *
     * **Example** (Refreshing cached values)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Force refresh of existing cached values
     * const program = Effect.gen(function*() {
     *   let counter = 0
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.sync(() => `${key}-${++counter}`)
     *   })
     *
     *   // Initial cache population
     *   const value1 = yield* Cache.get(cache, "user")
     *   console.log(value1) // "user-1"
     *
     *   // Get from cache (no lookup)
     *   const value2 = yield* Cache.get(cache, "user")
     *   console.log(value2) // "user-1" (same value)
     *
     *   // Force refresh - always calls lookup
     *   const refreshed = yield* Cache.refresh(cache, "user")
     *   console.log(refreshed) // "user-2" (new value)
     *
     *   // Subsequent gets return refreshed value
     *   const value3 = yield* Cache.get(cache, "user")
     *   console.log(value3) // "user-2"
     * })
     * ```
     *
     * **Example** (Resetting TTL on refresh)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     * import { TestClock } from "effect/testing"
     *
     * // Refresh resets TTL (Time To Live)
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(key.length),
     *     timeToLive: "1 hour"
     *   })
     *
     *   yield* Cache.get(cache, "test")
     *   yield* TestClock.adjust("45 minutes")
     *
     *   // Entry would normally expire in 15 minutes
     *   console.log(yield* Cache.has(cache, "test")) // true
     *
     *   // Refresh resets the TTL to full 1 hour
     *   yield* Cache.refresh(cache, "test")
     *   yield* TestClock.adjust("30 minutes")
     *
     *   // Still valid because TTL was reset
     *   console.log(yield* Cache.has(cache, "test")) // true
     * })
     * ```
     *
     * **Example** (Refreshing missing keys)
     *
     * ```ts
     * import { Cache, Effect } from "effect"
     *
     * // Refresh non-existent keys
     * const program = Effect.gen(function*() {
     *   const cache = yield* Cache.make({
     *     capacity: 10,
     *     lookup: (key: string) => Effect.succeed(`value-for-${key}`)
     *   })
     *
     *   // Refresh non-existent key creates new entry
     *   const result = yield* Cache.refresh(cache, "newKey")
     *   console.log(result) // "value-for-newKey"
     *
     *   // Verify it's now cached
     *   console.log(yield* Cache.has(cache, "newKey")) // true
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <Key, A, E, R>(self: Cache<Key, A, E, R>, key: Key): Effect.Effect<A, E, R>;
};
/**
 * Invalidates all entries in the cache.
 *
 * **Example** (Invalidating all entries)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Clear all cached entries at once
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Populate cache with multiple entries
 *   yield* Cache.get(cache, "apple")
 *   yield* Cache.get(cache, "banana")
 *   yield* Cache.get(cache, "cherry")
 *
 *   console.log(yield* Cache.size(cache)) // 3
 *   console.log(yield* Cache.has(cache, "apple")) // true
 *
 *   // Clear all entries
 *   yield* Cache.invalidateAll(cache)
 *
 *   // Verify cache is empty
 *   console.log(yield* Cache.size(cache)) // 0
 *   console.log(yield* Cache.has(cache, "apple")) // false
 *   console.log(yield* Cache.has(cache, "banana")) // false
 *   console.log(yield* Cache.has(cache, "cherry")) // false
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const invalidateAll: <Key, A, E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<void>;
/**
 * Retrieves the approximate number of entries in the cache.
 *
 * **Details**
 *
 * Note that expired entries are counted until they are accessed and removed.
 * The size reflects the current number of entries stored, not the number
 * of valid entries.
 *
 * **Example** (Reading cache size)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Empty cache has size 0
 *   const emptySize = yield* Cache.size(cache)
 *   console.log(emptySize) // 0
 *
 *   // Add entries and check size
 *   yield* Cache.get(cache, "hello")
 *   yield* Cache.get(cache, "world")
 *   const sizeAfterAdding = yield* Cache.size(cache)
 *   console.log(sizeAfterAdding) // 2
 *
 *   // Size decreases after invalidation
 *   yield* Cache.invalidate(cache, "hello")
 *   const sizeAfterInvalidation = yield* Cache.size(cache)
 *   console.log(sizeAfterInvalidation) // 1
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const size: <Key, A, E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<number>;
/**
 * Retrieves all active keys from the cache, automatically filtering out expired entries.
 *
 * **Example** (Reading active keys)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * // Basic key enumeration
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Add some entries to the cache
 *   yield* Cache.get(cache, "hello")
 *   yield* Cache.get(cache, "world")
 *   yield* Cache.get(cache, "cache")
 *
 *   // Retrieve all active keys
 *   const keys = yield* Cache.keys(cache)
 *
 *   console.log(Array.from(keys).sort()) // ["cache", "hello", "world"]
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const keys: <Key, A, E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<Iterable<Key>>;
/**
 * Retrieves all successfully cached values from the cache, excluding failed
 * lookups and expired entries.
 *
 * **Example** (Reading all cached values)
 *
 * ```ts
 * import { Cache, Effect } from "effect"
 *
 * const program = Effect.gen(function*() {
 *   const cache = yield* Cache.make({
 *     capacity: 10,
 *     lookup: (key: string) => Effect.succeed(key.length)
 *   })
 *
 *   // Add some values to the cache
 *   yield* Cache.get(cache, "a")
 *   yield* Cache.get(cache, "ab")
 *   yield* Cache.get(cache, "abc")
 *
 *   // Retrieve all cached values
 *   const values = yield* Cache.values(cache)
 *   const valuesArray = Array.from(values).sort()
 *
 *   console.log(valuesArray) // [1, 2, 3]
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const values: <Key, A, E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<Iterable<A>>;
/**
 * Retrieves all key-value pairs from the cache as an iterable. This function
 * only returns entries with successfully resolved values, filtering out any
 * failed lookups or expired entries.
 *
 * **Gotchas**
 *
 * Expired entries are removed from the cache while `entries` filters them out.
 *
 * @see {@link keys} for retrieving only cached keys
 * @see {@link values} for retrieving only cached values
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const entries: <Key, A, E, R>(self: Cache<Key, A, E, R>) => Effect.Effect<Iterable<[Key, A]>>;
export {};
//# sourceMappingURL=Cache.d.ts.map