keq 5.0.0-alpha.25 → 5.0.0-alpha.27

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## 5.0.0-alpha.6 (2025-09-17)
 
+## 5.0.0-alpha.27
+
+### Major Changes
+
+- 0c7db81: **BREAKING CHANGE:** remove appendMiddlewares and prependMiddlewares from Keq.
+
+## 5.0.0-alpha.26
+
+### Minor Changes
+
+- 63161c4: **Feat:** the .flowControl() support concurrency.
+
+### Patch Changes
+
+- 22ce01a: **Fix:** JSON.stringify ctx.response always get empty object.
+
 ## 5.0.0-alpha.25
 
 ### Major Changes

package/dist/context/types/keq-global.d.ts

@@ -1,7 +1,12 @@
 import type { queueAsPromised } from 'fastq';
 import type { KeqNext } from '../../middleware/index.js';
-export interface KeqGlobal {
+export interface KeqGlobalCore {
     abortFlowControl?: Record<string, ((reason: any) => void) | undefined>;
-    serialFlowControl?: Record<string, queueAsPromised<KeqNext, void>>;
+    serialFlowControl?: Record<string, queueAsPromised<{
+        next: KeqNext;
+    }, void>>;
+}
+export interface KeqGlobal {
+    core?: KeqGlobalCore;
 }
 //# sourceMappingURL=keq-global.d.ts.map

package/dist/context/types/keq-global.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keq-global.d.ts","sourceRoot":"","sources":["../../../src/context/types/keq-global.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAGpD,MAAM,WAAW,SAAS;IAExB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;CACnE"}
+{"version":3,"file":"keq-global.d.ts","sourceRoot":"","sources":["../../../src/context/types/keq-global.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAGpD,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,IAAI,CAAC,CAAC,CAAA;CAC7E;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,aAAa,CAAA;CACrB"}

package/dist/context/utils/fork.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../../src/context/utils/fork.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAgEtC;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAErC"}
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../../src/context/utils/fork.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CA4EtC;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAErC"}

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { createRequest, Keq, request, KeqRequest, type KeqOptions, type KeqApiSc
 export { type KeqBodyInit, } from './request-init';
 export { composeMiddleware, type KeqMiddleware, type KeqNext, } from './middleware';
 export { type KeqRoute, composeRoute, } from './router';
-export { createProxyResponse, KeqExecutionContext, KeqSharedContext, type KeqSharedContextOptions, type KeqContext, type KeqContextData, type KeqContextEmitter, type KeqGlobal, type KeqContextOptions, type KeqMiddlewareOptions, type KeqEvents, type KeqRetryDelay, type KeqRetryOn, } from './context';
+export { createProxyResponse, KeqExecutionContext, KeqSharedContext, type KeqSharedContextOptions, type KeqContext, type KeqContextData, type KeqContextEmitter, type KeqGlobal, type KeqGlobalCore, type KeqContextOptions, type KeqMiddlewareOptions, type KeqEvents, type KeqRetryDelay, type KeqRetryOn, } from './context';
 export { Exception, TypeException, TimeoutException, AbortException, RequestException, BadRequestException, UnauthorizedException, ForbiddenException, NotFoundedException, MethodNotAllowedException, NotAcceptableException, ProxyAuthenticationRequiredException, RequestTimeoutException, ConflictException, PreconditionFailedException, ContentTooLargeException, UriTooLongException, ImATeapotException, TooManyRequestsException, UnsupportedMediaTypeException, InternalServerErrorException, NotImplementedException, BadGatewayException, ServiceUnavailableException, GatewayTimeoutException, } from './exception';
 export { KeqMiddlewareOrchestrator, KeqMiddlewareExecutor, } from './orchestrator';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,GAAG,EACH,OAAO,EACP,UAAU,EACV,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,OAAO,GACb,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,KAAK,QAAQ,EACb,YAAY,GACb,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,EAEd,gBAAgB,EAEhB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,oCAAoC,EACpC,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAE7B,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,GAAG,EACH,OAAO,EACP,UAAU,EACV,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,OAAO,GACb,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,KAAK,QAAQ,EACb,YAAY,GACb,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,EAEd,gBAAgB,EAEhB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,oCAAoC,EACpC,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAE7B,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -790,15 +790,16 @@ function fork(original) {
     return current;
   };
   const createProxy = (path = []) => {
-    return new Proxy({}, {
-      get(_, prop) {
-        const target = objectPath(current, path);
-        if (prop === UnWrapPropertyKey) return target;
-        const value = target[prop];
+    const getTarget = () => objectPath(current, path);
+    return new Proxy(getTarget(), {
+      get(target, prop) {
+        const realTarget = getTarget();
+        if (prop === UnWrapPropertyKey) return realTarget;
+        const value = realTarget[prop];
         if (current !== original) {
           return value;
         }
-        if (Array.isArray(target) && ARRAY_MUTATORS.has(prop)) {
+        if (Array.isArray(realTarget) && ARRAY_MUTATORS.has(prop)) {
           return new Proxy(value, {
             apply(fn, thisArg, args) {
               ensureCopy();
@@ -812,15 +813,23 @@ function fork(original) {
         }
         return value;
       },
-      set(_, prop, value) {
+      set(target, prop, value) {
         ensureCopy();
         objectPath(current, path)[prop] = value;
         return true;
       },
-      deleteProperty(_, prop) {
+      deleteProperty(target, prop) {
         ensureCopy();
         delete objectPath(current, path)[prop];
         return true;
+      },
+      ownKeys(target) {
+        const realTarget = getTarget();
+        return Reflect.ownKeys(realTarget);
+      },
+      getOwnPropertyDescriptor(target, prop) {
+        const realTarget = getTarget();
+        return Reflect.getOwnPropertyDescriptor(realTarget, prop);
       }
     });
   };
@@ -1050,7 +1059,7 @@ function assignSharedContext(target, source) {
 
 // src/orchestrator/orchestrator.ts
 var KeqMiddlewareOrchestrator = class _KeqMiddlewareOrchestrator {
-  constructor(context, middlewares = []) {
+  constructor(context, middlewares = [], inherit) {
     __publicField(this, "main");
     __publicField(this, "status", "idle");
     __publicField(this, "context");
@@ -1058,6 +1067,7 @@ var KeqMiddlewareOrchestrator = class _KeqMiddlewareOrchestrator {
     __publicField(this, "current", -1);
     this.context = context;
     this.executors = middlewares.map((mw) => new KeqMiddlewareExecutor(mw));
+    if (inherit == null ? void 0 : inherit.main) this.main = inherit.main;
   }
   cancelNotFinished() {
     const current = this.current;
@@ -1116,11 +1126,12 @@ var KeqMiddlewareOrchestrator = class _KeqMiddlewareOrchestrator {
     const context = cloneSharedContext(this.context);
     const next = this.current + 1;
     const middlewares = this.executors.slice(next).map((executor) => executor.middleware);
-    const forkedOrchestrator = new _KeqMiddlewareOrchestrator(context, middlewares);
-    forkedOrchestrator.main = {
-      orchestrator: this.main ? this.main.orchestrator : this,
-      index: this.main ? this.main.index + next : next
-    };
+    const forkedOrchestrator = new _KeqMiddlewareOrchestrator(context, middlewares, {
+      main: {
+        orchestrator: this.main ? this.main.orchestrator : this,
+        index: this.main ? this.main.index + next : next
+      }
+    });
     return forkedOrchestrator;
   }
   merge(source) {
@@ -1313,26 +1324,30 @@ var Core = class {
       ...options,
       url: new URL(url.href)
     });
+    if (options.middlewares) {
+      this.__append_middlewares__.push(...options.middlewares);
+    }
   }
   get __middlewares__() {
     return [...this.__prepend_middlewares__, ...this.__append_middlewares__];
   }
-  prependMiddlewares(...middlewares) {
+  // prependMiddlewares(...middlewares: KeqMiddleware[]): this {
+  //   this.__prepend_middlewares__.push(...middlewares)
+  //   return this
+  // }
+  // /**
+  //  * Appends middlewares to the end of the middleware chain.
+  //  * Using this method indiscriminately is discouraged;
+  //  * prefer using `.use` to maintain predictable execution order.
+  //  */
+  // appendMiddlewares(...middlewares: KeqMiddleware[]): this {
+  //   this.__append_middlewares__.unshift(...middlewares)
+  //   return this
+  // }
+  use(...middlewares) {
     this.__prepend_middlewares__.push(...middlewares);
     return this;
   }
-  /**
-   * Appends middlewares to the end of the middleware chain.
-   * Using this method indiscriminately is discouraged;
-   * prefer using `.use` to maintain predictable execution order.
-   */
-  appendMiddlewares(...middlewares) {
-    this.__append_middlewares__.unshift(...middlewares);
-    return this;
-  }
-  use(...middlewares) {
-    return this.prependMiddlewares(...middlewares);
-  }
   on(event, listener) {
     this.__listeners__[event] = this.__listeners__[event] || [];
     this.__listeners__[event].push(listener);
@@ -1599,13 +1614,15 @@ var Keq = class extends Core {
     this.requestInit.mode = mod;
     return this;
   }
-  flowControl(mode, signal) {
-    const sig = signal ? signal : this.__locationId__;
+  flowControl(mode, arg2, arg3) {
+    const concurrencyLimit = typeof arg2 === "number" ? arg2 : void 0;
+    const sig = typeof arg2 === "function" || typeof arg2 === "string" ? arg2 : arg3 && (typeof arg3 === "function" || typeof arg3 === "string") ? arg3 : this.__locationId__;
     if (!sig) {
       throw new Exception("please set signal to .flowControl()");
     }
     const flowControl = {
       mode,
+      concurrencyLimit,
       signal: sig
     };
     this.option("flowControl", flowControl);
@@ -1776,20 +1793,22 @@ function keqTimeoutMiddleware() {
 var fastq = __toESM(require("fastq"));
 function keqSerialFlowControlMiddleware() {
   return async function serialFlowControlMiddleware(ctx, next) {
-    if (!ctx.options.flowControl || ctx.options.flowControl.mode !== "serial") {
+    if (!ctx.options.flowControl || !["serial", "concurrent"].includes(ctx.options.flowControl.mode)) {
       await next();
       return;
     }
     const { signal } = ctx.options.flowControl;
+    const concurrent = ctx.options.flowControl.mode === "serial" ? 1 : !ctx.options.flowControl.concurrencyLimit ? 1 : ctx.options.flowControl.concurrencyLimit < 1 ? 1 : parseInt(ctx.options.flowControl.concurrencyLimit, 10);
     const key = typeof signal === "string" ? signal : signal(ctx);
-    if (!ctx.global.serialFlowControl) ctx.global.serialFlowControl = {};
-    if (!ctx.global.serialFlowControl[key]) {
-      ctx.global.serialFlowControl[key] = fastq.promise(async (next2) => {
+    if (!ctx.global.core) ctx.global.core = {};
+    if (!ctx.global.core.serialFlowControl) ctx.global.core.serialFlowControl = {};
+    if (!ctx.global.core.serialFlowControl[key]) {
+      ctx.global.core.serialFlowControl[key] = fastq.promise(async ({ next: next2 }) => {
         await next2();
-      }, 1);
+      }, concurrent);
     }
-    const queue = ctx.global.serialFlowControl[key];
-    await queue.push(next);
+    const queue = ctx.global.core.serialFlowControl[key];
+    await queue.push({ next });
   };
 }
 
@@ -1802,19 +1821,20 @@ function keqAbortFlowControlMiddleware() {
     }
     const { signal } = ctx.options.flowControl;
     const key = typeof signal === "string" ? signal : signal(ctx);
-    if (!ctx.global.abortFlowControl) ctx.global.abortFlowControl = {};
-    const abort = ctx.global.abortFlowControl[key];
+    if (!ctx.global.core) ctx.global.core = {};
+    if (!ctx.global.core.abortFlowControl) ctx.global.core.abortFlowControl = {};
+    const abort = ctx.global.core.abortFlowControl[key];
     if (abort) {
       const reason = new AbortException('Previous request was aborted by AbortFlowControl with key "'.concat(key, '"'));
       abort(reason);
     }
     const fn = ctx.request.abort.bind(ctx.request);
-    ctx.global.abortFlowControl[key] = fn;
+    ctx.global.core.abortFlowControl[key] = fn;
     try {
       await next();
     } finally {
-      if (ctx.global.abortFlowControl[key] === fn) {
-        ctx.global.abortFlowControl[key] = void 0;
+      if (ctx.global.core.abortFlowControl[key] === fn) {
+        ctx.global.core.abortFlowControl[key] = void 0;
       }
     }
   };
@@ -1871,9 +1891,19 @@ var KeqRequest = class {
     return new URL(url.href);
   }
   __fetch__(url, init, locationId) {
-    const keq = new Keq(this.__formatUrl__(url), { ...init, locationId, global: this.global, qs: this.qs });
-    keq.appendMiddlewares(...this.postMiddlewares);
-    keq.prependMiddlewares(...this.preMiddlewares);
+    const keq = new Keq(
+      this.__formatUrl__(url),
+      {
+        ...init,
+        locationId,
+        global: this.global,
+        qs: this.qs,
+        middlewares: [
+          ...this.preMiddlewares,
+          ...this.postMiddlewares
+        ]
+      }
+    );
     return keq;
   }
   fetch(url, init) {
@@ -1891,18 +1921,11 @@ var KeqRequest = class {
     );
   }
   put(url) {
-    const locationId = getLocationId(1);
-    const keq = new Keq(
-      this.__formatUrl__(url),
-      {
-        method: "put",
-        locationId,
-        global: this.global
-      }
+    return this.__fetch__(
+      url,
+      { method: "put" },
+      getLocationId(1)
     );
-    keq.appendMiddlewares(...this.postMiddlewares);
-    keq.prependMiddlewares(...this.preMiddlewares);
-    return keq;
   }
   delete(url) {
     return this.__fetch__(
@@ -1954,6 +1977,7 @@ var KeqRequest = class {
       context.emitter.on(event, listener);
       await next();
     };
+    middleware.__keqMiddlewareName__ = "listen(".concat(event, ", ").concat(listener.name || "anonymous", ")");
     this.use(middleware);
     return this;
   }