keq 2.8.13 → 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,20 @@
 
 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)
+
+
+### Bug Fixes
+
+* resolve pnpm singleton trap ([89eed47](https://github.com/keq-request/keq/commit/89eed475346262d5cad371a1aa39cf257bf2a42f))
+
 ### [2.8.13](https://github.com/keq-request/keq/compare/v2.8.12...v2.8.13) (2026-01-14)
 
 

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/esm/src/util/create-response-proxy.js

@@ -1,6 +1,6 @@
 import { fork } from './fork.js';
-const JsonCachePropertyKey = Symbol('KeqResponseProxyJsonCachePropertyKey');
-const TextCachePropertyKey = Symbol('KeqResponseProxyTextCachePropertyKey');
+const JsonCachePropertyKey = '__KeqProtectedProperty(response.proxy.cache.json)__';
+const TextCachePropertyKey = '__KeqProtectedProperty(response.proxy.cache.text)__';
 export function createResponseProxy(response) {
     return new Proxy(response, {
         get(res, prop) {

package/dist/esm/src/util/fork.js

@@ -1,6 +1,6 @@
 /* eslint-disable @typescript-eslint/no-unsafe-return */
 import { klona } from 'klona/json';
-const UnWrapPropertyKey = Symbol('UnWrapPropertyKey');
+const ForkedObjectBrandPropertyKey = '__KeqProtectedProperty(forked.object.brand)__';
 const ARRAY_MUTATORS = new Set([
     'push',
     'pop',
@@ -35,7 +35,7 @@ export function fork(original) {
         return new Proxy(getTarget(), {
             get(target, prop) {
                 const realTarget = getTarget();
-                if (prop === UnWrapPropertyKey)
+                if (prop === ForkedObjectBrandPropertyKey)
                     return realTarget;
                 const value = realTarget[prop];
                 // return value directly if already copied
@@ -81,5 +81,5 @@ export function fork(original) {
     return createProxy();
 }
 export function unwrap(proxy) {
-    return proxy && proxy[UnWrapPropertyKey] ? proxy[UnWrapPropertyKey] : proxy;
+    return proxy && proxy[ForkedObjectBrandPropertyKey] ? proxy[ForkedObjectBrandPropertyKey] : proxy;
 }

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/dist/umd/src/util/create-response-proxy.js

@@ -11,8 +11,8 @@
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.createResponseProxy = void 0;
     const fork_js_1 = require("./fork.js");
-    const JsonCachePropertyKey = Symbol('KeqResponseProxyJsonCachePropertyKey');
-    const TextCachePropertyKey = Symbol('KeqResponseProxyTextCachePropertyKey');
+    const JsonCachePropertyKey = '__KeqProtectedProperty(response.proxy.cache.json)__';
+    const TextCachePropertyKey = '__KeqProtectedProperty(response.proxy.cache.text)__';
     function createResponseProxy(response) {
         return new Proxy(response, {
             get(res, prop) {

package/dist/umd/src/util/fork.js

@@ -12,7 +12,7 @@
     exports.unwrap = exports.fork = void 0;
     /* eslint-disable @typescript-eslint/no-unsafe-return */
     const json_1 = require("klona/json");
-    const UnWrapPropertyKey = Symbol('UnWrapPropertyKey');
+    const ForkedObjectBrandPropertyKey = '__KeqProtectedProperty(forked.object.brand)__';
     const ARRAY_MUTATORS = new Set([
         'push',
         'pop',
@@ -47,7 +47,7 @@
             return new Proxy(getTarget(), {
                 get(target, prop) {
                     const realTarget = getTarget();
-                    if (prop === UnWrapPropertyKey)
+                    if (prop === ForkedObjectBrandPropertyKey)
                         return realTarget;
                     const value = realTarget[prop];
                     // return value directly if already copied
@@ -94,7 +94,7 @@
     }
     exports.fork = fork;
     function unwrap(proxy) {
-        return proxy && proxy[UnWrapPropertyKey] ? proxy[UnWrapPropertyKey] : proxy;
+        return proxy && proxy[ForkedObjectBrandPropertyKey] ? proxy[ForkedObjectBrandPropertyKey] : proxy;
     }
     exports.unwrap = unwrap;
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keq",
-  "version": "2.8.13",
+  "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,19 +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
-CJS dist/index.js     43.02 KB
-CJS dist/index.js.map 77.81 KB
-CJS ⚡️ Build success in 194ms
-ESM dist/index.mjs     41.10 KB
-ESM dist/index.mjs.map 77.05 KB
-ESM ⚡️ Build success in 194ms
+ℹ 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