keq 2.8.14 → 2.9.0

package/.claude/settings.local.json

@@ -0,0 +1,26 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx tsup:*)",
+      "Bash(npx jest *)",
+      "Bash(npm view *)",
+      "Bash(npm pack *)",
+      "Bash(tar -xzf eslint-10.2.1.tgz package/lib/api.js -O)",
+      "Bash(rm -f eslint-10.2.1.tgz)",
+      "Read(//private/tmp/**)",
+      "Bash(tar -xzf /Users/10009313/Shein/workspace/@keq/keq/eslint-10.2.1.tgz)",
+      "Bash(cat /tmp/package/lib/api.js)",
+      "Bash(rm -rf /tmp/package /Users/10009313/Shein/workspace/@keq/keq/eslint-10.2.1.tgz)",
+      "Bash(tar -xzf /tmp/eslint-10.2.1.tgz -C /tmp)",
+      "Bash(rm -rf /tmp/package /tmp/eslint-10.2.1.tgz)",
+      "Bash(npm info *)",
+      "Bash(mkdir -p /tmp/picomatch2 /tmp/picomatch4)",
+      "Bash(tar -xzf types-picomatch-2.3.4.tgz -C /tmp/picomatch2)",
+      "Bash(tar -xzf types-picomatch-4.0.3.tgz -C /tmp/picomatch4)",
+      "Bash(npx eslint *)",
+      "Bash(npm ls *)",
+      "Bash(pnpm ls *)",
+      "Bash(npm test *)"
+    ]
+  }
+}

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [2.9.0](https://github.com/keq-request/keq/compare/v2.8.14...v2.9.0) (2026-06-17)
+
+
+### Features
+
+* add mutex flow control ([3213028](https://github.com/keq-request/keq/commit/3213028b90fee45a5ef066500b4206686e7c83dc))
+
 ### [2.8.14](https://github.com/keq-request/keq/compare/v2.8.13...v2.8.14) (2026-01-20)
 
 

package/dist/esm/src/create-request.js

@@ -2,6 +2,7 @@
 import { isBrowser } from './is/is-browser.js';
 import { Keq } from './keq.js';
 import { abortFlowControlMiddleware } from './middlewares/abort-flow-control-middleware.js';
+import { mutexFlowControlMiddleware } from './middlewares/mutex-flow-control-middleware.js';
 import { fetchArgumentsMiddleware } from './middlewares/fetch-arguments-middleware.js';
 import { fetchMiddleware } from './middlewares/fetch-middleware.js';
 import { proxyResponseMiddleware } from './middlewares/proxy-response-middleware.js';
@@ -24,6 +25,7 @@ export function createRequest(options) {
         retryMiddleware(),
         serialFlowControlMiddleware(),
         abortFlowControlMiddleware(),
+        mutexFlowControlMiddleware(),
         timeoutMiddleware(),
         proxyResponseMiddleware(),
         fetchArgumentsMiddleware(),

package/dist/esm/src/middlewares/mutex-flow-control-middleware.d.ts

@@ -0,0 +1,2 @@
+import type { KeqMiddleware } from "../types/keq-middleware.js";
+export declare function mutexFlowControlMiddleware(): KeqMiddleware;

package/dist/esm/src/middlewares/mutex-flow-control-middleware.js

@@ -0,0 +1,22 @@
+export function mutexFlowControlMiddleware() {
+    return async function mutexFlowControlMiddleware(ctx, next) {
+        if (!ctx.options.flowControl || ctx.options.flowControl.mode !== 'mutex') {
+            await next();
+            return;
+        }
+        const { signal } = ctx.options.flowControl;
+        const key = typeof signal === 'string' ? signal : signal(ctx);
+        if (!ctx.global.mutexFlowControl)
+            ctx.global.mutexFlowControl = {};
+        if (ctx.global.mutexFlowControl[key]) {
+            throw new DOMException('A request with the same signal is already in progress, keq flowControl mutex rejected this request.', 'AbortError');
+        }
+        ctx.global.mutexFlowControl[key] = true;
+        try {
+            await next();
+        }
+        finally {
+            ctx.global.mutexFlowControl[key] = false;
+        }
+    };
+}

package/dist/esm/src/types/keq-flow-control.d.ts

@@ -1,6 +1,6 @@
 import type { KeqContext } from './keq-context.js';
 export interface KeqFlowControl {
-    mode: 'abort' | 'serial';
+    mode: 'abort' | 'serial' | 'mutex';
     signal: string | ((ctx: KeqContext) => string);
 }
 export type KeqFlowControlMode = KeqFlowControl['mode'];

package/dist/esm/src/types/keq-global.d.ts

@@ -3,4 +3,5 @@ import type { KeqNext } from './keq-next.js';
 export interface KeqGlobal {
     abortFlowControl?: Record<string, ((reason: any) => void) | undefined>;
     serialFlowControl?: Record<string, queueAsPromised<KeqNext, void>>;
+    mutexFlowControl?: Record<string, boolean>;
 }

package/dist/umd/src/create-request.js

@@ -4,7 +4,7 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./is/is-browser.js", "./keq.js", "./middlewares/abort-flow-control-middleware.js", "./middlewares/fetch-arguments-middleware.js", "./middlewares/fetch-middleware.js", "./middlewares/proxy-response-middleware.js", "./middlewares/retry-middleware.js", "./middlewares/serial-flow-control-middleware.js", "./router/keq-router.js", "./middlewares/timeout-middleware.js", "./util/get-unique-code-identifier.js"], factory);
+        define(["require", "exports", "./is/is-browser.js", "./keq.js", "./middlewares/abort-flow-control-middleware.js", "./middlewares/mutex-flow-control-middleware.js", "./middlewares/fetch-arguments-middleware.js", "./middlewares/fetch-middleware.js", "./middlewares/proxy-response-middleware.js", "./middlewares/retry-middleware.js", "./middlewares/serial-flow-control-middleware.js", "./router/keq-router.js", "./middlewares/timeout-middleware.js", "./util/get-unique-code-identifier.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -14,6 +14,7 @@
     const is_browser_js_1 = require("./is/is-browser.js");
     const keq_js_1 = require("./keq.js");
     const abort_flow_control_middleware_js_1 = require("./middlewares/abort-flow-control-middleware.js");
+    const mutex_flow_control_middleware_js_1 = require("./middlewares/mutex-flow-control-middleware.js");
     const fetch_arguments_middleware_js_1 = require("./middlewares/fetch-arguments-middleware.js");
     const fetch_middleware_js_1 = require("./middlewares/fetch-middleware.js");
     const proxy_response_middleware_js_1 = require("./middlewares/proxy-response-middleware.js");
@@ -36,6 +37,7 @@
             (0, retry_middleware_js_1.retryMiddleware)(),
             (0, serial_flow_control_middleware_js_1.serialFlowControlMiddleware)(),
             (0, abort_flow_control_middleware_js_1.abortFlowControlMiddleware)(),
+            (0, mutex_flow_control_middleware_js_1.mutexFlowControlMiddleware)(),
             (0, timeout_middleware_js_1.timeoutMiddleware)(),
             (0, proxy_response_middleware_js_1.proxyResponseMiddleware)(),
             (0, fetch_arguments_middleware_js_1.fetchArgumentsMiddleware)(),

package/dist/umd/src/middlewares/mutex-flow-control-middleware.d.ts

@@ -0,0 +1,2 @@
+import type { KeqMiddleware } from "../types/keq-middleware.js";
+export declare function mutexFlowControlMiddleware(): KeqMiddleware;

package/dist/umd/src/middlewares/mutex-flow-control-middleware.js

@@ -0,0 +1,36 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.mutexFlowControlMiddleware = void 0;
+    function mutexFlowControlMiddleware() {
+        return async function mutexFlowControlMiddleware(ctx, next) {
+            if (!ctx.options.flowControl || ctx.options.flowControl.mode !== 'mutex') {
+                await next();
+                return;
+            }
+            const { signal } = ctx.options.flowControl;
+            const key = typeof signal === 'string' ? signal : signal(ctx);
+            if (!ctx.global.mutexFlowControl)
+                ctx.global.mutexFlowControl = {};
+            if (ctx.global.mutexFlowControl[key]) {
+                throw new DOMException('A request with the same signal is already in progress, keq flowControl mutex rejected this request.', 'AbortError');
+            }
+            ctx.global.mutexFlowControl[key] = true;
+            try {
+                await next();
+            }
+            finally {
+                ctx.global.mutexFlowControl[key] = false;
+            }
+        };
+    }
+    exports.mutexFlowControlMiddleware = mutexFlowControlMiddleware;
+});

package/dist/umd/src/types/keq-flow-control.d.ts

@@ -1,6 +1,6 @@
 import type { KeqContext } from './keq-context.js';
 export interface KeqFlowControl {
-    mode: 'abort' | 'serial';
+    mode: 'abort' | 'serial' | 'mutex';
     signal: string | ((ctx: KeqContext) => string);
 }
 export type KeqFlowControlMode = KeqFlowControl['mode'];

package/dist/umd/src/types/keq-global.d.ts

@@ -3,4 +3,5 @@ import type { KeqNext } from './keq-next.js';
 export interface KeqGlobal {
     abortFlowControl?: Record<string, ((reason: any) => void) | undefined>;
     serialFlowControl?: Record<string, queueAsPromised<KeqNext, void>>;
+    mutexFlowControl?: Record<string, boolean>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keq",
-  "version": "2.8.14",
+  "version": "2.9.0",
   "description": "Request API write by Typescript for flexibility, readability, and a low learning curve.",
   "keywords": [
     "request",

package/packages/cache/.turbo/turbo-build.log

@@ -1,14 +1,29 @@
 
 
-> @keq-request/cache@5.0.0-alpha.25 build /Users/10009313/code/github/@keq/keq/packages/cache
-> tsup
+> @keq-request/cache@5.0.0-beta.10 build /Users/10009313/Shein/workspace/@keq/keq/packages/cache
+> tsdown
 
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.lib.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/10009313/code/github/@keq/keq/packages/cache/tsup.config.ts
-CLI Target: chrome70,firefox78,safari12,edge80,node20
-CLI Cleaning output folder
-CJS Build start
-ESM Build start
- ELIFECYCLE  Command failed.
+ℹ tsdown v0.21.10 powered by rolldown v1.0.0-rc.17
+ℹ config file: /Users/10009313/Shein/workspace/@keq/keq/packages/cache/tsdown.config.ts 
+(node:38149) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///Users/10009313/Shein/workspace/@keq/keq/packages/cache/tsdown.config.ts?no-cache=3138c138-dedb-4c2e-bc89-bc119eb95378 is not specified and it doesn't parse as CommonJS.
+Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
+To eliminate this warning, add "type": "module" to /Users/10009313/Shein/workspace/@keq/keq/packages/cache/package.json.
+(Use `node --trace-warnings ...` to show where the warning was created)
+ℹ entry: src/index.ts
+ℹ targets: chrome91, firefox90, safari15, edge91, node20
+ℹ tsconfig: tsconfig.lib.json
+ℹ Build start
+ℹ Cleaning 8 files
+ℹ [CJS] dist/index.js      40.01 kB │ gzip:  8.54 kB
+ℹ [CJS] dist/index.js.map  76.69 kB │ gzip: 15.26 kB
+ℹ [CJS] 2 files, total: 116.70 kB
+ℹ [CJS] dist/index.d.ts.map   4.67 kB │ gzip: 1.42 kB
+ℹ [CJS] dist/index.d.ts      10.65 kB │ gzip: 3.09 kB
+ℹ [CJS] 2 files, total: 15.31 kB
+✔ Build complete in 1775ms
+ℹ [ESM] dist/index.mjs        38.55 kB │ gzip:  8.06 kB
+ℹ [ESM] dist/index.mjs.map    76.50 kB │ gzip: 15.21 kB
+ℹ [ESM] dist/index.d.mts.map   4.67 kB │ gzip:  1.42 kB
+ℹ [ESM] dist/index.d.mts      10.65 kB │ gzip:  3.09 kB
+ℹ [ESM] 4 files, total: 130.37 kB
+✔ Build complete in 1776ms

package/packages/cache/dist/index.d.mts

@@ -0,0 +1,354 @@
+import { queueAsPromised } from "fastq";
+import { Keq, KeqContext, KeqExecutionContext, KeqMiddleware, KeqNext } from "keq";
+import { Promisable } from "type-fest";
+
+//#region src/cache-entry/types/cache-entry-options.d.ts
+interface CacheEntryOptions {
+  key: string;
+  response: Response;
+  size: number;
+  expiredAt?: Date;
+}
+//#endregion
+//#region src/cache-entry/types/cache-entry-build-options.d.ts
+interface CacheEntryBuildOptions {
+  key: string;
+  response: Response;
+  size?: number;
+  ttl?: number;
+  expiredAt?: Date;
+}
+//#endregion
+//#region src/cache-entry/cache-entry.d.ts
+declare class CacheEntry {
+  key: string;
+  response: Response;
+  /**
+   * @en bytes
+   * @zh 字节数
+   */
+  size: number;
+  expiredAt: Date;
+  constructor(options: CacheEntryOptions);
+  static build(options: CacheEntryBuildOptions): Promise<CacheEntry>;
+  clone(): CacheEntry;
+  assignResponseHeaders(headers: Headers): void;
+}
+//#endregion
+//#region src/storage/keq-cache-storage.d.ts
+declare abstract class KeqCacheStorage {
+  /**
+   * @en Get the length of the storage
+   * @zh 获取 Storage 缓存的条目数量
+   */
+  abstract get(key: string): Promisable<CacheEntry | undefined>;
+  /**
+   * @en Set a new entry to the storage
+   * @zh 将被缓存的数据添加到Storage中
+   */
+  abstract set(entry: CacheEntry): Promisable<void>;
+  /**
+   * @en Remove an entry by key
+   * @zh 根据key删除Storage中的数据
+   */
+  abstract remove(key: string): Promisable<void>;
+}
+//#endregion
+//#region src/types/keq-cache-key.d.ts
+type KeqCacheKeyFactory = ((context: KeqContext) => string);
+type KeqCacheKey = string | KeqCacheKeyFactory;
+//#endregion
+//#region src/constants/eviction.enum.d.ts
+declare enum Eviction {
+  LRU = "lru",
+  LFU = "lfu",
+  RANDOM = "random",
+  TTL = "ttl"
+}
+//#endregion
+//#region src/constants/size.enum.d.ts
+declare enum Size {
+  B = 1,
+  KB = 1024,
+  MB = 1048576,
+  GB = 1073741824
+}
+//#endregion
+//#region src/constants/strategy.enum.d.ts
+declare const Strategy: {
+  STALE_WHILE_REVALIDATE: KeqCacheStrategy;
+  NETWORK_FIRST: KeqCacheStrategy;
+  NETWORK_ONLY: KeqCacheStrategy;
+  CACHE_FIRST: KeqCacheStrategy;
+};
+//#endregion
+//#region src/storage/internal-storage/types/events.d.ts
+interface OnCacheGetEvent {
+  readonly key: string;
+}
+interface OnCacheSetEvent {
+  readonly key: string;
+}
+interface OnCacheRemoveEvent {
+  readonly key: string;
+}
+interface OnCacheEvictEvent {
+  readonly keys: string[];
+}
+interface OnCacheExpiredEvent {
+  readonly keys: string[];
+}
+//#endregion
+//#region src/storage/internal-storage/types/storage-options.d.ts
+interface InternalStorageOptions {
+  /**
+   * @default false
+   */
+  debug?: boolean;
+  /**
+   * @en bytes
+   * @zh 字节数
+   *
+   * @default Infinity
+   */
+  size?: number;
+  onCacheGet?: (event: OnCacheGetEvent) => void;
+  onCacheSet?: (event: OnCacheSetEvent) => void;
+  onCacheRemove?: (event: OnCacheRemoveEvent) => void;
+  onCacheEvict?: (event: OnCacheEvictEvent) => void;
+  onCacheExpired?: (event: OnCacheExpiredEvent) => void;
+}
+//#endregion
+//#region src/storage/memory-storage/types/memory-storage-options.d.ts
+interface MemoryStorageOptions extends InternalStorageOptions {
+  /**
+   * @default Eviction.LRU
+   */
+  eviction?: Eviction;
+}
+//#endregion
+//#region src/storage/memory-storage/memory-storage.d.ts
+declare class MemoryStorage extends KeqCacheStorage {
+  private storage;
+  constructor(options?: MemoryStorageOptions);
+  set(entry: CacheEntry): Promisable<void>;
+  get(key: string): Promisable<CacheEntry | undefined>;
+  remove(key: string): Promisable<void>;
+  print(): Promise<void>;
+}
+//#endregion
+//#region src/storage/indexed-db-storage/types/indexed-db-storage-options.d.ts
+interface IndexedDbStorageOptions extends InternalStorageOptions {
+  /**
+   * @en The table name for the IndexedDB storage, multiple instances using the same table name will share the cached data.
+   * @zh IndexedDB 存储的表名, 多个实例使用同一个表名会共享缓存数据。
+   */
+  tableName?: string;
+  /**
+   * @default Eviction.LRU
+   */
+  eviction?: Eviction;
+}
+//#endregion
+//#region src/storage/indexed-db-storage/indexed-db-storage.d.ts
+declare class IndexedDBStorage extends KeqCacheStorage {
+  private storage;
+  constructor(options?: IndexedDbStorageOptions);
+  set(entry: CacheEntry): Promisable<void>;
+  get(key: string): Promisable<CacheEntry | undefined>;
+  remove(key: string): Promisable<void>;
+}
+//#endregion
+//#region src/storage/multi-tier-storage/types/multi-tier-storage-options.d.ts
+interface MultiTierStorageOptions {
+  tiers: KeqCacheStorage[];
+}
+//#endregion
+//#region src/storage/multi-tier-storage/multi-tier-storage.d.ts
+/**
+ * @en Multi-tier cache storage that manages multiple KeqCacheStorage instances in tiers
+ * @zh 多层缓存存储，管理多个分层的 KeqCacheStorage 实例
+ */
+declare class MultiTierStorage extends KeqCacheStorage {
+  private readonly storages;
+  /**
+   * @param storages Array of storage instances ordered by performance (fastest first)
+   * @zh 按性价比排序的存储实例数组，排在前面的成本低，排在后面的成本高
+   */
+  constructor(options: MultiTierStorageOptions);
+  /**
+   * @en Get cache entry, searching from lowest to highest tier
+   * @zh 获取缓存条目，从最底层到高层依次搜索
+   */
+  get(key: string): Promise<CacheEntry | undefined>;
+  /**
+   * @en Set cache entry to all tiers concurrently
+   * @zh 并发写入所有层的缓存
+   */
+  set(entry: CacheEntry): Promise<void>;
+  /**
+   * @en Remove cache entry from all tiers
+   * @zh 从所有层删除缓存条目
+   */
+  remove(key: string): Promise<void>;
+  /**
+   * @en Sync cache entry to all lower tiers (tiers with index < currentTierIndex)
+   * @zh 将缓存条目同步到所有低层存储（索引小于当前层的存储）
+   */
+  private syncToLowerTiers;
+}
+//#endregion
+//#region src/storage/tier-storage/types/tier-storage-options.d.ts
+/**
+ * @en Configuration options for TierStorage
+ * @zh TierStorage 的配置选项
+ */
+interface TierStorageOptions {
+  /**
+   * @en Memory storage instance or options for the memory storage (L1 cache)
+   * @zh 内存存储实例或配置选项（一级缓存）
+   */
+  memory?: MemoryStorage | MemoryStorageOptions;
+  /**
+   * @en IndexedDB storage instance or options for the IndexedDB storage (L2 cache)
+   * @zh IndexedDB 存储实例或配置选项（二级缓存）
+   */
+  indexedDB?: IndexedDBStorage | IndexedDbStorageOptions;
+}
+//#endregion
+//#region src/storage/tier-storage/tier-storage.d.ts
+/**
+ * @en Two-tier cache storage that combines MemoryStorage (L1) and IndexedDBStorage (L2)
+ * @zh 二级缓存存储，结合了MemoryStorage（一级）和IndexedDBStorage（二级）
+ *
+ * This is a convenience wrapper around MultiTierStorage that provides:
+ * - Fast in-memory cache (L1)
+ * - Persistent IndexedDB cache (L2)
+ * - Simplified configuration options
+ */
+declare class TierStorage extends MultiTierStorage {
+  constructor(options?: TierStorageOptions);
+}
+//#endregion
+//#region src/request-cache-handler/request-cache-handler.d.ts
+type RequestCacheHandlerOptions = Omit<RequestCacheOptions, 'strategy'>;
+declare class RequestCacheHandler {
+  readonly cacheKey: string;
+  readonly storage: KeqCacheStorage;
+  readonly options: Readonly<RequestCacheHandlerOptions>;
+  constructor(cacheKey: string, storage: KeqCacheStorage, options: Readonly<RequestCacheHandlerOptions>);
+  /**
+   * Resolve cache key for request context
+   */
+  static resolveRequestCacheKey(context: KeqContext, options: RequestCacheHandlerOptions): string;
+  /**
+   * Get cache from storage
+   */
+  getCache(): Promise<[string, CacheEntry | undefined]>;
+  /**
+   * Store response that in context to storage
+   */
+  setCache(context: KeqContext): Promise<[string, CacheEntry | undefined]>;
+}
+//#endregion
+//#region src/types/keq-cache-strategy.d.ts
+interface KeqCacheStrategy {
+  (handler: RequestCacheHandler, context: KeqExecutionContext, next: KeqNext): Promise<void>;
+}
+//#endregion
+//#region src/types/request-cache-options.d.ts
+/**
+ * The options for a cacheable request.
+ */
+interface RequestCacheOptions {
+  /**
+   * Enable debug logs
+   */
+  debug?: boolean;
+  /**
+   * Enable Server-Timing header
+   */
+  serverTiming?: boolean;
+  /**
+   * This configuration item controls whether requests are allowed to be concurrent.
+   * By default, concurrency is disabled
+   *
+   * When multiple requests with the same key occur,
+   * the subsequent ones are blocked until the previous request completes.
+   * This ensures that the cache is utilized effectively and prevents redundant processing for identical keys
+   *
+   * @default false
+   */
+  concurrent?: boolean;
+  /**
+   * Cache Key
+   */
+  key?: KeqCacheKey;
+  /**
+   * @default Strategy.NETWORK_FIRST
+   */
+  strategy: KeqCacheStrategy;
+  /**
+   * @en seconds
+   * @zh 秒
+   *
+   * @default Infinity
+   */
+  ttl?: number;
+  /**
+   * If exclude is true, the request will not be cached.
+   */
+  exclude?: (res: Response) => (Promise<boolean> | boolean);
+}
+//#endregion
+//#region src/types/keq-cache-pattern.d.ts
+type KeqCachePattern = RegExp | ((ctx: KeqContext) => boolean) | true;
+//#endregion
+//#region src/types/keq-cache-rule.d.ts
+interface KeqCacheRule extends RequestCacheOptions {
+  pattern?: KeqCachePattern;
+}
+//#endregion
+//#region src/cache.d.ts
+interface KeqCacheOptions extends Pick<RequestCacheOptions, 'serverTiming'> {
+  storage: KeqCacheStorage;
+  /**
+   * Cache Key Factory
+   */
+  keyFactory?: KeqCacheKeyFactory;
+  rules?: KeqCacheRule[];
+}
+declare module 'keq' {
+  interface KeqMiddlewareOptions<OP> {
+    /**
+     * [keq-cache](https://github.com/keq-request/keq-cache)
+     */
+    cache(option: RequestCacheOptions | false): Keq<OP>;
+  }
+  interface KeqEvents {
+    'cache:hit': {
+      key: string;
+      response: Response;
+      context: KeqContext;
+    };
+    'cache:miss': {
+      key: string;
+      context: KeqContext;
+    };
+    'cache:update': {
+      key: string;
+      oldResponse?: Response;
+      newResponse: Response;
+      context: KeqContext;
+    };
+  }
+  interface KeqGlobalCore {
+    cache?: Record<string, queueAsPromised<{
+      next: KeqNext;
+    }, void>>;
+  }
+}
+declare function cache(options: KeqCacheOptions): KeqMiddleware;
+//#endregion
+export { Eviction, IndexedDBStorage, type IndexedDbStorageOptions, type KeqCacheKey, type KeqCacheKeyFactory, KeqCacheOptions, type KeqCachePattern, type KeqCacheRule, KeqCacheStorage, type KeqCacheStrategy, MemoryStorage, type MemoryStorageOptions, MultiTierStorage, type MultiTierStorageOptions, Size, Strategy, TierStorage, type TierStorageOptions, cache };
+//# sourceMappingURL=index.d.mts.map

package/packages/cache/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/cache-entry/types/cache-entry-options.ts","../src/cache-entry/types/cache-entry-build-options.ts","../src/cache-entry/cache-entry.ts","../src/storage/keq-cache-storage.ts","../src/types/keq-cache-key.ts","../src/constants/eviction.enum.ts","../src/constants/size.enum.ts","../src/constants/strategy.enum.ts","../src/storage/internal-storage/types/events.ts","../src/storage/internal-storage/types/storage-options.ts","../src/storage/memory-storage/types/memory-storage-options.ts","../src/storage/memory-storage/memory-storage.ts","../src/storage/indexed-db-storage/types/indexed-db-storage-options.ts","../src/storage/indexed-db-storage/indexed-db-storage.ts","../src/storage/multi-tier-storage/types/multi-tier-storage-options.ts","../src/storage/multi-tier-storage/multi-tier-storage.ts","../src/storage/tier-storage/types/tier-storage-options.ts","../src/storage/tier-storage/tier-storage.ts","../src/request-cache-handler/request-cache-handler.ts","../src/types/keq-cache-strategy.ts","../src/types/request-cache-options.ts","../src/types/keq-cache-pattern.ts","../src/types/keq-cache-rule.ts","../src/cache.ts"],"mappings":"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"}