import type { Request, Response } from 'express';
/**
 * Options passed when invoking `cache()` to create a route-level middleware.
 *
 * @example
 * ```ts
 * // This route uses a 10-second TTL instead of the global 60-second TTL.
 * app.get('/products', cache({ ttl: 10_000 }), handler);
 * ```
 */
export interface MemorizeCallOptions {
    /**
     * Time-to-live override for this specific route, in milliseconds.
     * Takes precedence over the global `ttl` set in {@link MemorizeOptions}.
     * Omit to fall back to the global TTL. Pass `Infinity` to cache indefinitely.
     * Pass `0` to expire immediately.
     */
    ttl?: number;
    /**
     * When `true`, the middleware skips both reading from and writing to the cache
     * for this route and sets `X-Cache: BYPASS` on the response. Useful when a
     * global `app.use(cache())` is in place but a specific route should never be cached.
     */
    noCache?: boolean;
    /**
     * Custom cache key extractor. Defaults to `req.originalUrl` (which includes
     * the query string).
     *
     * @example
     * ```ts
     * // Ignore the query string
     * app.get('/users', cache({ key: (req) => req.path }), handler);
     * ```
     */
    key?: (req: Request) => string;
    /**
     * Predicate evaluated once per request, before the cache is read. When it
     * returns `false` the middleware skips both reading from and writing to the
     * cache for that request and sets `X-Cache: BYPASS`.
     *
     * Useful to keep per-user responses out of a shared cache:
     *
     * @example
     * ```ts
     * app.use(cache({ shouldCache: (req) => !req.headers.authorization }));
     * ```
     */
    shouldCache?: (req: Request, res: Response) => boolean;
    /**
     * Invalidation tags attached to every entry cached by this middleware.
     * All tagged entries can be removed at once with `cache.deleteByTag(tag)`.
     *
     * @example
     * ```ts
     * app.get('/users', cache({ tags: ['users'] }), handler);
     * // later: cache.deleteByTag('users');
     * ```
     */
    tags?: string[];
}
//# sourceMappingURL=MemorizeCallOptions.d.ts.map