@ahoo-wang/fetcher-decorator 1.6.0 → 1.6.2

package/dist/apiDecorator.d.ts

@@ -1,5 +1,4 @@
-import { AttributesCapable, Fetcher, RequestHeaders, RequestHeadersCapable, TimeoutCapable } from '@ahoo-wang/fetcher';
-import { ResultExtractorCapable } from './resultExtractor';
+import { AttributesCapable, Fetcher, RequestHeaders, RequestHeadersCapable, ResultExtractorCapable, TimeoutCapable } from '@ahoo-wang/fetcher';
 import { FetcherCapable } from './fetcherCapable';
 /**
  * Metadata for class-level API configuration.

package/dist/apiDecorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiDecorator.d.ts","sourceRoot":"","sources":["../src/apiDecorator.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,iBAAiB,EACtB,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD;;;;;;GAMG;AACH,MAAM,WAAW,WACf,SAAQ,cAAc,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EAAE,iBAAiB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB,eAAyB,CAAC;AAwDvD,wBAAgB,GAAG,CACjB,QAAQ,GAAE,MAAW,EACrB,QAAQ,GAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAM,IAE3B,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,aAAa,CAAC,KAAG,CAAC,CAgB3E"}
+{"version":3,"file":"apiDecorator.d.ts","sourceRoot":"","sources":["../src/apiDecorator.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,iBAAiB,EACtB,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD;;;;;;GAMG;AACH,MAAM,WAAW,WACf,SAAQ,cAAc,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EAAE,iBAAiB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB,eAAyB,CAAC;AAwDvD,wBAAgB,GAAG,CACjB,QAAQ,GAAE,MAAW,EACrB,QAAQ,GAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAM,IAE3B,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,aAAa,CAAC,KAAG,CAAC,CAgB3E"}

package/dist/endpointDecorator.d.ts

@@ -1,6 +1,5 @@
-import { HttpMethod } from '@ahoo-wang/fetcher';
+import { HttpMethod, ResultExtractorCapable } from '@ahoo-wang/fetcher';
 import { ApiMetadata } from './apiDecorator';
-import { ResultExtractorCapable } from './resultExtractor';
 export interface PathCapable {
     /**
      * Path for the endpoint (relative to class base path).

package/dist/endpointDecorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpointDecorator.d.ts","sourceRoot":"","sources":["../src/endpointDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBACf,SAAQ,WAAW,EACjB,sBAAsB,EACtB,WAAW;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,eAAO,MAAM,qBAAqB,eAA8B,CAAC;AAEjE,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CACtB,MAAM,CAAC,EAAE,UAAU,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,GAAE,sBAA2B,IAErB,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,KAAG,IAAI,CAcpE;AAED,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YAhBlD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAkBpE;AAED,wBAAgB,IAAI,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YApBnD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAsBpE;AAED,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YAxBlD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CA0BpE;AAED,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YA5BlD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CA8BpE;AAED,wBAAgB,KAAK,CACnB,IAAI,GAAE,MAAW,EACjB,QAAQ,GAAE,sBAA2B,YAlCb,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAqCpE;AAED,wBAAgB,IAAI,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YAvCnD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAyCpE;AAED,wBAAgB,OAAO,CACrB,IAAI,GAAE,MAAW,EACjB,QAAQ,GAAE,sBAA2B,YA7Cb,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAgDpE"}
+{"version":3,"file":"endpointDecorator.d.ts","sourceRoot":"","sources":["../src/endpointDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,kBAAkB,CAAC;AAE1B,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBACf,SAAQ,WAAW,EACjB,sBAAsB,EACtB,WAAW;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,eAAO,MAAM,qBAAqB,eAA8B,CAAC;AAEjE,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CACtB,MAAM,CAAC,EAAE,UAAU,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,GAAE,sBAA2B,IAErB,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,KAAG,IAAI,CAcpE;AAED,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YAhBlD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAkBpE;AAED,wBAAgB,IAAI,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YApBnD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAsBpE;AAED,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YAxBlD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CA0BpE;AAED,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YA5BlD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CA8BpE;AAED,wBAAgB,KAAK,CACnB,IAAI,GAAE,MAAW,EACjB,QAAQ,GAAE,sBAA2B,YAlCb,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAqCpE;AAED,wBAAgB,IAAI,CAAC,IAAI,GAAE,MAAW,EAAE,QAAQ,GAAE,sBAA2B,YAvCnD,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAyCpE;AAED,wBAAgB,OAAO,CACrB,IAAI,GAAE,MAAW,EACjB,QAAQ,GAAE,sBAA2B,YA7Cb,MAAM,eAAe,MAAM,GAAG,MAAM,KAAG,IAAI,CAgDpE"}

package/dist/functionMetadata.d.ts

@@ -69,7 +69,7 @@ export declare class FunctionMetadata implements NamedCapable {
      */
     resolveTimeout(): number | undefined;
     resolveResultExtractor(): ResultExtractor<any>;
-    resolveAttributes(): Record<string, any>;
+    resolveAttributes(): Map<string, any>;
     /**
      * Resolves the request configuration from the method arguments.
      *

package/dist/functionMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"functionMetadata.d.ts","sourceRoot":"","sources":["../src/functionMetadata.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,OAAO,EACP,KAAK,iBAAiB,EAGtB,YAAY,EAEZ,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAmC,MAAM,sBAAsB,CAAC;AAI1F;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,EAAE,WAAW,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAE3B;;;;;;;;;;OAUG;IACH,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE3C;;;;;;;OAOG;gBAED,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAQ5C;;;;;;;OAOG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;OAKG;IACH,WAAW,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM;IAW3C;;;;;;;OAOG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,sBAAsB,IAAI,eAAe,CAAC,GAAG,CAAC;IAQ9C,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAOxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,YAAY,CAAC,CAAC;IA2E7F,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,kBAAkB;IAU1B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,sBAAsB;CAY/B"}
+{"version":3,"file":"functionMetadata.d.ts","sourceRoot":"","sources":["../src/functionMetadata.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,OAAO,EACP,KAAK,iBAAiB,EAGtB,YAAY,EAEZ,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAmC,MAAM,sBAAsB,CAAC;AAI1F;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,EAAE,WAAW,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAE3B;;;;;;;;;;OAUG;IACH,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE3C;;;;;;;OAOG;gBAED,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAQ5C;;;;;;;OAOG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;OAKG;IACH,WAAW,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM;IAW3C;;;;;;;OAOG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,sBAAsB,IAAI,eAAe,CAAC,GAAG,CAAC;IAQ9C,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;IAKrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,YAAY,CAAC,CAAC;IA2E7F,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,kBAAkB;IAU1B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,sBAAsB;CAU/B"}

package/dist/index.es.js

@@ -1,7 +1,7 @@
-import { HttpMethod as u, Fetcher as A, fetcherRegistrar as _, JsonResultExtractor as P, TextResultExtractor as D, ResponseResultExtractor as O, ExchangeResultExtractor as I, fetcher as w, combineURLs as U, mergeRequest as S } from "@ahoo-wang/fetcher";
+import { HttpMethod as u, Fetcher as x, fetcherRegistrar as D, JsonResultExtractor as T, TextResultExtractor as I, ResponseResultExtractor as O, ExchangeResultExtractor as w, fetcher as U, combineURLs as v, mergeRecordToMap as b, mergeRequest as S } from "@ahoo-wang/fetcher";
 import "reflect-metadata";
-import { JsonEventStreamResultExtractor as v, EventStreamResultExtractor as H } from "@ahoo-wang/fetcher-eventstream";
-const x = Symbol("endpoint:metadata");
+import { JsonEventStreamResultExtractor as H, EventStreamResultExtractor as F } from "@ahoo-wang/fetcher-eventstream";
+const g = Symbol("endpoint:metadata");
 function h(t, e, r = {}) {
   return function(n, a) {
     const s = {
@@ -10,36 +10,36 @@ function h(t, e, r = {}) {
       ...r
     };
     Reflect.defineMetadata(
-      x,
+      g,
       s,
       n,
       a
     );
   };
 }
-function at(t = "", e = {}) {
+function st(t = "", e = {}) {
   return h(u.GET, t, e);
 }
-function st(t = "", e = {}) {
+function ot(t = "", e = {}) {
   return h(u.POST, t, e);
 }
-function ot(t = "", e = {}) {
+function it(t = "", e = {}) {
   return h(u.PUT, t, e);
 }
-function it(t = "", e = {}) {
+function ct(t = "", e = {}) {
   return h(u.DELETE, t, e);
 }
-function ct(t = "", e = {}) {
+function ut(t = "", e = {}) {
   return h(u.PATCH, t, e);
 }
-function ut(t = "", e = {}) {
+function ht(t = "", e = {}) {
   return h(u.HEAD, t, e);
 }
-function ht(t = "", e = {}) {
+function dt(t = "", e = {}) {
   return h(u.OPTIONS, t, e);
 }
-const F = "fetcher", Y = "__decorator_target__";
-class k {
+const Y = "fetcher", k = "__decorator_target__";
+class N {
   /**
    * Creates a new RequestExecutor instance.
    *
@@ -57,8 +57,8 @@ class k {
   getTargetFetcher(e) {
     if (!e || typeof e != "object")
       return;
-    const r = e[F];
-    if (r instanceof A)
+    const r = e[Y];
+    if (r instanceof x)
       return r;
   }
   /**
@@ -100,57 +100,57 @@ class k {
    */
   async execute(e, r) {
     const n = this.getTargetFetcher(e) || this.metadata.fetcher, a = this.metadata.resolveExchangeInit(r);
-    a.attributes[Y] = e;
+    a.attributes?.set(k, e);
     const s = this.metadata.resolveResultExtractor();
-    return n.request(a.request, s, a.attributes);
+    return n.request(a.request, { resultExtractor: s, attributes: a.attributes });
   }
 }
 const E = /* @__PURE__ */ new WeakMap();
-function N(t) {
+function B(t) {
   if (typeof t != "function")
     throw new TypeError("Expected a function");
   if (E.has(t))
     return E.get(t);
   try {
-    const e = t.toString().trim(), r = G(e);
-    if (!C(r)) {
+    const e = t.toString().trim(), r = Q(e);
+    if (!G(r)) {
       const a = [];
       return E.set(t, a), a;
     }
-    const n = Q(r);
+    const n = j(r);
     return E.set(t, n), n;
   } catch {
     const e = [];
     return E.set(t, e), e;
   }
 }
-function B(t, e, r, n) {
+function C(t, e, r, n) {
   if (n)
     return n;
   try {
     const a = t[e];
     if (a && typeof a == "function") {
-      const s = N(a);
+      const s = B(a);
       if (r < s.length)
         return s[r];
     }
   } catch {
   }
 }
-function C(t) {
+function G(t) {
   return t != null && t.trim() !== "";
 }
-function G(t) {
+function Q(t) {
   if (t.startsWith("(")) {
-    const n = T(t, 0);
+    const n = A(t, 0);
     return n === -1 ? "" : t.substring(1, n);
   }
   const e = t.indexOf("(");
   if (e === -1) return "";
-  const r = T(t, e);
+  const r = A(t, e);
   return r === -1 ? "" : t.substring(e + 1, r);
 }
-function T(t, e) {
+function A(t, e) {
   let r = 1;
   for (let n = e + 1; n < t.length; n++) {
     const a = t[n];
@@ -161,93 +161,93 @@ function T(t, e) {
   }
   return -1;
 }
-function Q(t) {
-  return t.split(",").map(j).filter(J).map(L);
-}
 function j(t) {
-  return t.trim();
+  return t.split(",").map(J).filter(L).map(W);
 }
 function J(t) {
-  return t.length > 0;
+  return t.trim();
 }
 function L(t) {
-  let e = W(t);
-  return e = K(e), e.trim();
+  return t.length > 0;
 }
 function W(t) {
+  let e = K(t);
+  return e = $(e), e.trim();
+}
+function K(t) {
   const e = t.indexOf("=");
   return e !== -1 ? t.substring(0, e) : t;
 }
-function K(t) {
+function $(t) {
   const e = t.indexOf(":");
   return e !== -1 ? t.substring(0, e) : t;
 }
 var i = /* @__PURE__ */ ((t) => (t.PATH = "path", t.QUERY = "query", t.HEADER = "header", t.BODY = "body", t.REQUEST = "request", t.ATTRIBUTE = "attribute", t.ATTRIBUTES = "attributes", t))(i || {});
-const b = Symbol("parameter:metadata");
+const R = Symbol("parameter:metadata");
 function d(t, e = "") {
   return function(r, n, a) {
-    const s = B(
+    const s = C(
       r,
       n,
       a,
       e
-    ), c = Reflect.getMetadata(b, r, n) || /* @__PURE__ */ new Map(), f = {
+    ), c = Reflect.getMetadata(R, r, n) || /* @__PURE__ */ new Map(), f = {
       type: t,
       name: s,
       index: a
     };
     c.set(a, f), Reflect.defineMetadata(
-      b,
+      R,
       c,
       r,
       n
     );
   };
 }
-function dt(t = "") {
+function ft(t = "") {
   return d("path", t);
 }
-function ft(t = "") {
+function pt(t = "") {
   return d("query", t);
 }
-function pt(t = "") {
+function mt(t = "") {
   return d("header", t);
 }
-function mt() {
+function Et() {
   return d(
     "body"
     /* BODY */
   );
 }
-function Et() {
+function lt() {
   return d(
     "request"
     /* REQUEST */
   );
 }
-function lt(t = "") {
+function bt(t = "") {
   return d("attribute", t);
 }
-function bt() {
+function Rt() {
   return d(
     "attributes"
     /* ATTRIBUTES */
   );
 }
-function $(t) {
+function V(t) {
   if (t)
-    return t instanceof A ? t : _.requiredGet(t);
+    return t instanceof x ? t : D.requiredGet(t);
 }
-const V = {
-  Exchange: I,
+const z = {
+  Exchange: w,
   Response: O,
-  Json: P,
-  Text: D,
-  EventStream: H,
-  JsonEventStream: v,
-  DEFAULT: P
+  Json: T,
+  Text: I,
+  EventStream: F,
+  JsonEventStream: H,
+  DEFAULT: T
 };
-class z {
+class X {
   /**
    * Creates a new FunctionMetadata instance.
    *
@@ -268,7 +268,7 @@ class z {
    * @returns The fetcher instance
    */
   get fetcher() {
-    return $(this.endpoint.fetcher ?? this.api.fetcher) ?? w;
+    return V(this.endpoint.fetcher ?? this.api.fetcher) ?? U;
   }
   /**
    * Resolves the complete path by combining base path and endpoint path
@@ -278,7 +278,7 @@ class z {
    */
   resolvePath(e) {
     const r = this.endpoint.basePath || this.api.basePath || "", n = e || this.endpoint.path || "";
-    return U(r, n);
+    return v(r, n);
   }
   /**
    * Resolves the timeout for the request.
@@ -292,13 +292,11 @@ class z {
     return this.endpoint.timeout || this.api.timeout;
   }
   resolveResultExtractor() {
-    return this.endpoint.resultExtractor || this.api.resultExtractor || V.DEFAULT;
+    return this.endpoint.resultExtractor || this.api.resultExtractor || z.DEFAULT;
   }
   resolveAttributes() {
-    return {
-      ...this.api.attributes,
-      ...this.endpoint.attributes
-    };
+    const e = b(this.api.attributes);
+    return b(this.endpoint.attributes, e);
   }
   /**
    * Resolves the request configuration from the method arguments.
@@ -353,7 +351,7 @@ class z {
     };
     let s, c, f, m = {};
     const l = this.resolveAttributes();
-    e.forEach((o, M) => {
+    e.forEach((o, _) => {
       if (o instanceof AbortSignal) {
         c = o;
         return;
@@ -362,7 +360,7 @@ class z {
         f = o;
         return;
       }
-      const p = this.parameters.get(M);
+      const p = this.parameters.get(_);
       if (p)
         switch (p.type) {
           case i.PATH:
@@ -388,23 +386,23 @@ class z {
             break;
         }
     });
-    const g = {
+    const y = {
       path: r,
       query: n
-    }, y = {
+    }, M = {
       method: this.endpoint.method,
-      urlParams: g,
+      urlParams: y,
       headers: a,
       body: s,
       timeout: this.resolveTimeout(),
       signal: c,
       abortController: f
-    }, R = S(
-      y,
+    }, P = S(
+      M,
       m
     ), q = m.path;
-    return R.url = this.resolvePath(q), {
-      request: R,
+    return P.url = this.resolvePath(q), {
+      request: P,
       attributes: l
     };
   }
@@ -454,89 +452,87 @@ class z {
     };
   }
   processAttributeParam(e, r, n) {
-    e.name && r !== void 0 && (n[e.name] = r);
+    e.name && r !== void 0 && n.set(e.name, r);
   }
   processAttributesParam(e, r) {
-    if (typeof e != "object")
-      throw new Error("@attributes() parameter must be an object");
-    Object.keys(e).forEach((n) => {
-      r[n] = e[n];
-    });
+    if (typeof e != "object" || e instanceof Map)
+      throw new Error("@attributes() parameter must be an object or an Map");
+    b(e, r);
   }
 }
-const X = Symbol("api:metadata");
-function Z(t, e, r) {
+const Z = Symbol("api:metadata");
+function tt(t, e, r) {
   const n = t.prototype[e];
   if (e === "constructor" || typeof n != "function")
     return;
   const a = Reflect.getMetadata(
-    x,
+    g,
     t.prototype,
     e
   );
   if (!a)
     return;
   const s = Reflect.getMetadata(
-    b,
+    R,
     t.prototype,
     e
-  ) || /* @__PURE__ */ new Map(), c = new z(
+  ) || /* @__PURE__ */ new Map(), c = new X(
     e,
     r,
     a,
     s
-  ), f = new k(c);
+  ), f = new N(c);
   t.prototype[e] = function(...m) {
     return f.execute(this, m);
   };
 }
-function Rt(t = "", e = {}) {
+function Pt(t = "", e = {}) {
   return function(r) {
     const n = {
       basePath: t,
       ...e
     };
-    return Reflect.defineMetadata(X, n, r), Object.getOwnPropertyNames(r.prototype).forEach((a) => {
-      Z(r, a, n);
+    return Reflect.defineMetadata(Z, n, r), Object.getOwnPropertyNames(r.prototype).forEach((a) => {
+      tt(r, a, n);
     }), r;
   };
 }
-class tt extends Error {
+class et extends Error {
   constructor() {
     super("Implementation will be generated automatically."), this.name = "AutoGenerated";
   }
 }
-const Pt = (...t) => new tt();
+const Tt = (...t) => new et();
 export {
-  X as API_METADATA_KEY,
-  tt as AutoGenerated,
-  Y as DECORATOR_TARGET_ATTRIBUTE_KEY,
-  x as ENDPOINT_METADATA_KEY,
-  z as FunctionMetadata,
-  b as PARAMETER_METADATA_KEY,
+  Z as API_METADATA_KEY,
+  et as AutoGenerated,
+  k as DECORATOR_TARGET_ATTRIBUTE_KEY,
+  g as ENDPOINT_METADATA_KEY,
+  X as FunctionMetadata,
+  R as PARAMETER_METADATA_KEY,
   i as ParameterType,
-  k as RequestExecutor,
-  V as ResultExtractors,
-  Rt as api,
-  lt as attribute,
-  bt as attributes,
-  Pt as autoGeneratedError,
-  mt as body,
-  it as del,
+  N as RequestExecutor,
+  z as ResultExtractors,
+  Pt as api,
+  bt as attribute,
+  Rt as attributes,
+  Tt as autoGeneratedError,
+  Et as body,
+  ct as del,
   h as endpoint,
-  at as get,
-  $ as getFetcher,
-  B as getParameterName,
-  N as getParameterNames,
-  ut as head,
-  pt as header,
-  ht as options,
+  st as get,
+  V as getFetcher,
+  C as getParameterName,
+  B as getParameterNames,
+  ht as head,
+  mt as header,
+  dt as options,
   d as parameter,
-  ct as patch,
-  dt as path,
-  st as post,
-  ot as put,
-  ft as query,
-  Et as request
+  ut as patch,
+  ft as path,
+  ot as post,
+  it as put,
+  pt as query,
+  lt as request
 };
 //# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../src/endpointDecorator.ts","../src/requestExecutor.ts","../src/reflection.ts","../src/parameterDecorator.ts","../src/fetcherCapable.ts","../src/resultExtractor.ts","../src/functionMetadata.ts","../src/apiDecorator.ts","../src/generated.ts"],"sourcesContent":["import { HttpMethod } from '@ahoo-wang/fetcher';\nimport { type ApiMetadata } from './apiDecorator';\nimport 'reflect-metadata';\nimport { type ResultExtractorCapable } from './resultExtractor';\n\nexport interface PathCapable {\n  /**\n   * Path for the endpoint (relative to class base path).\n   *\n   * This path will be appended to the class's base path to form the complete URL.\n   * Path parameters can be specified using curly braces, e.g., '/users/{id}'\n   */\n  path?: string;\n}\n\n/**\n * Metadata for HTTP endpoints.\n *\n * Defines the configuration options for individual HTTP endpoints (methods).\n * These settings will override any corresponding class-level settings from ApiMetadata.\n */\nexport interface EndpointMetadata\n  extends ApiMetadata,\n    ResultExtractorCapable,\n    PathCapable {\n  /**\n   * HTTP method for the endpoint.\n   *\n   * Specifies the HTTP verb to be used for this endpoint (GET, POST, PUT, DELETE, etc.)\n   */\n  method?: HttpMethod;\n}\n\nexport const ENDPOINT_METADATA_KEY = Symbol('endpoint:metadata');\n\nexport type MethodEndpointMetadata = Omit<EndpointMetadata, 'method' | 'path'>;\n\n/**\n * Decorator factory for defining HTTP endpoints.\n *\n * Creates a decorator that can be used to define HTTP endpoints\n * on class methods. It stores metadata about the endpoint that will be used\n * to generate the actual HTTP request.\n *\n * @param method - The HTTP method for this endpoint\n * @param path - The path for this endpoint (relative to class base path)\n * @param metadata - Additional endpoint metadata (headers, timeout, etc.)\n * @returns A method decorator function\n *\n * @example\n * ```typescript\n * @api('/api/v1')\n * class UserService {\n *   @endpoint(HttpMethod.GET, '/users/{id}')\n *   getUser(@path('id') id: string): Promise<Response> {\n *     // Implementation will be generated automatically\n *     throw autoGeneratedError();\n *   }\n * }\n * ```\n */\nexport function endpoint(\n  method?: HttpMethod,\n  path?: string,\n  metadata: MethodEndpointMetadata = {},\n) {\n  return function(target: object, propertyKey: string | symbol): void {\n    // Store metadata directly on the method\n    const endpointMetadata = {\n      method: method,\n      path,\n      ...metadata,\n    };\n    Reflect.defineMetadata(\n      ENDPOINT_METADATA_KEY,\n      endpointMetadata,\n      target,\n      propertyKey,\n    );\n  };\n}\n\nexport function get(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.GET, path, metadata);\n}\n\nexport function post(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.POST, path, metadata);\n}\n\nexport function put(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.PUT, path, metadata);\n}\n\nexport function del(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.DELETE, path, metadata);\n}\n\nexport function patch(\n  path: string = '',\n  metadata: MethodEndpointMetadata = {},\n) {\n  return endpoint(HttpMethod.PATCH, path, metadata);\n}\n\nexport function head(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.HEAD, path, metadata);\n}\n\nexport function options(\n  path: string = '',\n  metadata: MethodEndpointMetadata = {},\n) {\n  return endpoint(HttpMethod.OPTIONS, path, metadata);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { Fetcher } from '@ahoo-wang/fetcher';\nimport { FunctionMetadata } from './functionMetadata';\n\nconst TARGET_FETCHER_PROPERTY = 'fetcher';\n\nexport const DECORATOR_TARGET_ATTRIBUTE_KEY = '__decorator_target__';\n\n/**\n * Executor for HTTP requests based on decorated method metadata.\n *\n * This class is responsible for executing HTTP requests based on the metadata\n * collected from decorators. It resolves the path, constructs the request,\n * and executes it using the appropriate fetcher.\n */\nexport class RequestExecutor {\n  private readonly metadata: FunctionMetadata;\n\n  /**\n   * Creates a new RequestExecutor instance.\n   *\n   * @param metadata - The function metadata containing all request information\n   */\n  constructor(metadata: FunctionMetadata) {\n    this.metadata = metadata;\n  }\n\n  /**\n   * Retrieves the fetcher instance from the target object.\n   *\n   * @param target - The target object that may contain a fetcher property\n   * @returns The fetcher instance if exists, otherwise undefined\n   */\n  private getTargetFetcher(target: any): Fetcher | undefined {\n    if (!target || typeof target !== 'object') {\n      return undefined;\n    }\n    // Extract the fetcher property from the target object\n    const fetcher = target[TARGET_FETCHER_PROPERTY];\n\n    // Validate that the fetcher is an instance of the Fetcher class\n    if (fetcher instanceof Fetcher) {\n      return fetcher;\n    }\n\n    // Return undefined if no valid fetcher instance is found\n    return undefined;\n  }\n\n  /**\n   * Executes the HTTP request.\n   *\n   * This method resolves the path and request configuration from the metadata\n   * and arguments, then executes the request using the configured fetcher.\n   * It handles the complete request lifecycle from parameter processing to\n   * response extraction.\n   *\n   * @param target - The target object that the method is called on.\n   *                 This can contain a custom fetcher instance in its 'fetcher' property.\n   * @param args - The runtime arguments passed to the decorated method.\n   *               These are mapped to request components based on parameter decorators.\n   * @returns A Promise that resolves to the extracted result based on the configured result extractor.\n   *          By default, this is the Response object, but can be customized to return\n   *          parsed JSON, the raw exchange object, or any other transformed result.\n   *\n   * @example\n   * ```typescript\n   * // Given a decorated service method:\n   * class UserService {\n   *   @get('/users/{id}')\n   *   getUser(@path('id') id: number): Promise<Response> {\n   *     // This method body is replaced by the executor at runtime\n   *   }\n   * }\n   *\n   * // When calling:\n   * const userService = new UserService();\n   * const response = await userService.getUser(123);\n   *\n   * // The execute method will:\n   * // 1. Resolve the path to '/users/123'\n   * // 2. Create a request with method 'GET'\n   * // 3. Execute the request using the configured fetcher\n   * // 4. Return the Response object\n   * ```\n   */\n  async execute(target: any, args: any[]): Promise<any> {\n    const fetcher = this.getTargetFetcher(target) || this.metadata.fetcher;\n    const exchangeInit = this.metadata.resolveExchangeInit(args);\n    exchangeInit.attributes[DECORATOR_TARGET_ATTRIBUTE_KEY] = target;\n    const extractor = this.metadata.resolveResultExtractor();\n    return fetcher.request(exchangeInit.request, extractor, exchangeInit.attributes);\n  }\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Cache for storing previously extracted parameter names to improve performance\nconst parameterNameCache = new WeakMap<Function, string[]>();\n\n/**\n * Extracts parameter names from a function.\n *\n * This function parses the string representation of a function to extract\n * the names of its parameters. It handles various function formats including\n * regular functions, arrow functions, and methods.\n *\n * Note: This implementation provides basic parameter name extraction and may not\n * handle all edge cases of complex TypeScript parameter declarations.\n *\n * @param func - The function to extract parameter names from\n * @returns An array of parameter names, or an empty array if extraction fails\n * @throws {TypeError} If the input is not a function\n *\n * @example\n * ```typescript\n * function example(a, b, c) {}\n * const paramNames = getParameterNames(example);\n * // Returns: ['a', 'b', 'c']\n *\n * const arrowFunc = (x, y) => x + y;\n * const arrowParamNames = getParameterNames(arrowFunc);\n * // Returns: ['x', 'y']\n *\n * function complex(param1: string, param2: number = 10, ...rest: any[]) {}\n * const complexParamNames = getParameterNames(complex);\n * // Returns: ['param1', 'param2', '...rest']\n * ```\n */\nexport function getParameterNames(func: (...args: any[]) => any): string[] {\n  // Validate that the input is a function\n  if (typeof func !== 'function') {\n    throw new TypeError('Expected a function');\n  }\n\n  // Check cache first to improve performance\n  if (parameterNameCache.has(func)) {\n    return parameterNameCache.get(func)!;\n  }\n\n  try {\n    // Convert function to string and trim whitespace\n    const fnStr = func.toString().trim();\n\n    // Extract parameter string from the function\n    const paramsStr = extractParameterString(fnStr);\n\n    // Handle empty parameters\n    if (!hasParameters(paramsStr)) {\n      const emptyResult: string[] = [];\n      parameterNameCache.set(func, emptyResult);\n      return emptyResult;\n    }\n\n    // Parse and clean parameter names\n    const result = parseParameterNames(paramsStr);\n    parameterNameCache.set(func, result);\n    return result;\n  } catch {\n    // Return empty array on any parsing errors to avoid breaking the application\n    const errorResult: string[] = [];\n    parameterNameCache.set(func, errorResult);\n    return errorResult;\n  }\n}\n\n/**\n * Helper function to automatically extract parameter name when not provided.\n *\n * @param target - The target object (class prototype)\n * @param propertyKey - The method name\n * @param parameterIndex - The index of the parameter\n * @param providedName - The name explicitly provided by the user (if any)\n * @returns The parameter name, either provided or automatically extracted\n */\nexport function getParameterName(\n  target: object,\n  propertyKey: string | symbol,\n  parameterIndex: number,\n  providedName?: string,\n): string | undefined {\n  // If a name was explicitly provided, use it\n  if (providedName) {\n    return providedName;\n  }\n\n  // Try to automatically extract the parameter name\n  try {\n    const method = target[propertyKey as keyof typeof target];\n    if (method && typeof method === 'function') {\n      const paramNames = getParameterNames(method);\n      if (parameterIndex < paramNames.length) {\n        return paramNames[parameterIndex];\n      }\n    }\n  } catch {\n    // If we can't get the parameter name, return undefined\n    // This will use default naming in the execution logic\n  }\n\n  return undefined;\n}\n\n/**\n * Checks if a parameter string contains actual parameters.\n *\n * @param paramsStr - The parameter string to check\n * @returns True if the string contains parameters, false otherwise\n */\nfunction hasParameters(paramsStr: string): boolean {\n  return (\n    paramsStr !== null && paramsStr !== undefined && paramsStr.trim() !== ''\n  );\n}\n\n/**\n * Extracts the parameter string from a function string representation.\n *\n * @param fnStr - The string representation of the function\n * @returns The parameter string, or empty string if not found\n */\nfunction extractParameterString(fnStr: string): string {\n  // Handle arrow functions that start with parentheses\n  if (fnStr.startsWith('(')) {\n    const endParenIndex = findClosingParenthesis(fnStr, 0);\n    if (endParenIndex === -1) return '';\n    return fnStr.substring(1, endParenIndex);\n  }\n\n  // Handle regular functions, async functions, and methods\n  const startParenIndex = fnStr.indexOf('(');\n  if (startParenIndex === -1) return '';\n\n  const endParenIndex = findClosingParenthesis(fnStr, startParenIndex);\n  if (endParenIndex === -1) return '';\n\n  return fnStr.substring(startParenIndex + 1, endParenIndex);\n}\n\n/**\n * Finds the matching closing parenthesis for an opening parenthesis.\n *\n * @param str - The string to search in\n * @param openingParenIndex - The index of the opening parenthesis\n * @returns The index of the matching closing parenthesis, or -1 if not found\n */\nfunction findClosingParenthesis(\n  str: string,\n  openingParenIndex: number,\n): number {\n  let parenDepth = 1;\n\n  for (let i = openingParenIndex + 1; i < str.length; i++) {\n    const char = str[i];\n\n    if (char === '(') {\n      parenDepth++;\n    } else if (char === ')') {\n      parenDepth--;\n      if (parenDepth === 0) {\n        return i;\n      }\n    }\n  }\n\n  return -1; // No matching closing parenthesis found\n}\n\n/**\n * Parses and cleans parameter names from a parameter string.\n *\n * @param paramsStr - The parameter string to parse\n * @returns An array of cleaned parameter names\n */\nfunction parseParameterNames(paramsStr: string): string[] {\n  return paramsStr\n    .split(',')\n    .map(trimWhitespace)\n    .filter(isNotEmpty)\n    .map(extractParameterName);\n}\n\n/**\n * Trims whitespace from a string.\n *\n * @param str - The string to trim\n * @returns The trimmed string\n */\nfunction trimWhitespace(str: string): string {\n  return str.trim();\n}\n\n/**\n * Checks if a string is not empty.\n *\n * @param str - The string to check\n * @returns True if the string is not empty, false otherwise\n */\nfunction isNotEmpty(str: string): boolean {\n  return str.length > 0;\n}\n\n/**\n * Extracts a clean parameter name by removing type annotations and default values.\n *\n * @param param - The raw parameter string\n * @returns The cleaned parameter name\n */\nfunction extractParameterName(param: string): string {\n  // Remove default value assignment (everything after =)\n  let cleanedParam = removeDefaultValue(param);\n\n  // Remove type annotations (everything after :)\n  cleanedParam = removeTypeAnnotation(cleanedParam);\n\n  return cleanedParam.trim();\n}\n\n/**\n * Removes default value from a parameter string.\n *\n * @param param - The parameter string\n * @returns The parameter string without default value\n */\nfunction removeDefaultValue(param: string): string {\n  const equalsIndex = param.indexOf('=');\n  if (equalsIndex !== -1) {\n    return param.substring(0, equalsIndex);\n  }\n  return param;\n}\n\n/**\n * Removes type annotation from a parameter string.\n *\n * @param param - The parameter string\n * @returns The parameter string without type annotation\n */\nfunction removeTypeAnnotation(param: string): string {\n  const colonIndex = param.indexOf(':');\n  if (colonIndex !== -1) {\n    return param.substring(0, colonIndex);\n  }\n  return param;\n}\n","import { getParameterName } from './reflection';\nimport 'reflect-metadata';\nimport { type PathCapable } from './endpointDecorator';\nimport { type FetchRequestInit } from '@ahoo-wang/fetcher';\n\n/**\n * Parameter types for decorator parameters.\n *\n * Defines the different types of parameters that can be used\n * in API method decorators to specify how arguments should be handled\n * in the HTTP request.\n */\nexport enum ParameterType {\n  /**\n   * Path parameter that will be inserted into the URL path.\n   *\n   * Path parameters are used to specify dynamic parts of the URL path.\n   * They are defined using curly braces in the endpoint path.\n   *\n   * @example\n   * ```typescript\n   * @get('/users/{id}')\n   * getUser(@path('id') userId: string): Promise<Response>\n   * ```\n   */\n  PATH = 'path',\n\n  /**\n   * Query parameter that will be appended to the URL query string.\n   *\n   * Query parameters are used to pass non-hierarchical data to the server.\n   * They appear after the '?' in the URL.\n   *\n   * @example\n   * ```typescript\n   * @get('/users')\n   * getUsers(@query('limit') limit: number): Promise<Response>\n   * ```\n   */\n  QUERY = 'query',\n\n  /**\n   * Header parameter that will be added to the request headers.\n   *\n   * Header parameters are used to pass metadata about the request,\n   * such as authentication tokens or content type information.\n   *\n   * @example\n   * ```typescript\n   * @get('/users')\n   * getUsers(@header('Authorization') token: string): Promise<Response>\n   * ```\n   */\n  HEADER = 'header',\n\n  /**\n   * Body parameter that will be sent as the request body.\n   *\n   * The body parameter represents the main data payload of the request.\n   * It is typically used with POST, PUT, and PATCH requests.\n   *\n   * @example\n   * ```typescript\n   * @post('/users')\n   * createUser(@body() user: User): Promise<Response>\n   * ```\n   */\n  BODY = 'body',\n\n  /**\n   * Request parameter that will be used as the request object.\n   */\n  REQUEST = 'request',\n\n\n  /**\n   * Attribute parameter that will be used as a single attribute in the request attributes.\n   *\n   * The attribute parameter allows passing a single key-value pair that will be added\n   * to the request attributes object. This is useful for passing specific contextual\n   * information that can be accessed by interceptors.\n   */\n  ATTRIBUTE = 'attribute',\n  /**\n   * Attributes parameter that will be used as the request attributes.\n   *\n   * The attributes parameter allows passing custom data that can be accessed\n   * by interceptors throughout the request lifecycle. This is useful for\n   * sharing contextual information between different parts of the request processing.\n   */\n  ATTRIBUTES = 'attributes'\n}\n\n/**\n * Metadata for method parameters.\n *\n * Defines the metadata stored for each parameter\n * decorated with @path, @query, @header, or @body decorators.\n */\nexport interface ParameterMetadata {\n  /**\n   * Type of parameter (path, query, header, body).\n   *\n   * Specifies how this parameter should be handled in the HTTP request.\n   */\n  type: ParameterType;\n\n  /**\n   * Name of the parameter (used for path, query, and header parameters).\n   *\n   * For path and query parameters, this corresponds to the key in the URL.\n   * For header parameters, this corresponds to the header name.\n   * For body parameters, this is not used.\n   */\n  name?: string;\n\n  /**\n   * Index of the parameter in the method signature.\n   *\n   * This is used to map the runtime argument values to the correct parameter metadata.\n   */\n  index: number;\n}\n\nexport const PARAMETER_METADATA_KEY = Symbol('parameter:metadata');\n\n/**\n * Decorator factory for method parameters.\n *\n * Creates a decorator that can be used to specify how a method parameter\n * should be handled in the HTTP request. It stores metadata about the parameter\n * that will be used during request execution.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param type - The type of parameter (PATH, QUERY, HEADER, or BODY)\n * @param name - The name of the parameter (used for path, query, and header parameters, optional - auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users/{id}')\n * getUser(@parameter(ParameterType.PATH, 'id') userId: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users/{userId}')\n * getUser(@parameter(ParameterType.PATH) userId: string): Promise<Response>\n * ```\n */\nexport function parameter(type: ParameterType, name: string = '') {\n  return function(\n    target: object,\n    propertyKey: string | symbol,\n    parameterIndex: number,\n  ) {\n    const paramName = getParameterName(\n      target,\n      propertyKey as string,\n      parameterIndex,\n      name,\n    );\n\n    const existingParameters: Map<number, ParameterMetadata> =\n      Reflect.getMetadata(PARAMETER_METADATA_KEY, target, propertyKey) ||\n      new Map();\n    const parameterMetadata: ParameterMetadata = {\n      type: type,\n      name: paramName,\n      index: parameterIndex,\n    };\n    existingParameters.set(parameterIndex, parameterMetadata);\n    Reflect.defineMetadata(\n      PARAMETER_METADATA_KEY,\n      existingParameters,\n      target,\n      propertyKey,\n    );\n  };\n}\n\n/**\n * Path parameter decorator.\n *\n * Defines a path parameter that will be inserted into the URL path.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the path parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users/{id}')\n * getUser(@path('id') userId: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users/{userId}')\n * getUser(@path() userId: string): Promise<Response>\n * ```\n */\nexport function path(name: string = '') {\n  return parameter(ParameterType.PATH, name);\n}\n\n/**\n * Query parameter decorator.\n *\n * Defines a query parameter that will be appended to the URL query string.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the query parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users')\n * getUsers(@query('limit') limit: number): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users')\n * getUsers(@query() limit: number): Promise<Response>\n * ```\n */\nexport function query(name: string = '') {\n  return parameter(ParameterType.QUERY, name);\n}\n\n/**\n * Header parameter decorator.\n *\n * Defines a header parameter that will be added to the request headers.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the header parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users')\n * getUsers(@header('Authorization') token: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users')\n * getUsers(@header() authorization: string): Promise<Response>\n * ```\n */\nexport function header(name: string = '') {\n  return parameter(ParameterType.HEADER, name);\n}\n\n/**\n * Body parameter decorator.\n *\n * Defines a body parameter that will be sent as the request body.\n * Note that body parameters don't have names since there's only one body per request.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @post('/users')\n * createUser(@body() user: User): Promise<Response>\n * ```\n */\nexport function body() {\n  return parameter(ParameterType.BODY);\n}\n\n/**\n * Interface for request parameter objects.\n *\n * Combines FetchRequestInit and PathCapable interfaces to provide\n * a complete request configuration object that can be used with\n * the @request() decorator. This allows full customization of\n * the HTTP request including method, headers, body, and URL parameters.\n */\nexport interface ParameterRequest extends FetchRequestInit, PathCapable {\n}\n\n/**\n * Request parameter decorator.\n *\n * Defines a request parameter that will be used as the base request object.\n * This allows you to pass a complete ParameterRequest object to customize\n * the request configuration.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @post('/users')\n * createUsers(@request() request: ParameterRequest): Promise<Response>\n * ```\n */\nexport function request() {\n  return parameter(ParameterType.REQUEST);\n}\n\n/**\n * Parameter decorator for adding a single attribute to the request attributes.\n *\n * This decorator allows you to pass a key-value pair as an attribute that can be accessed\n * by interceptors during the request lifecycle. If no name is provided, the parameter's\n * property name will be used as the attribute key.\n *\n * @param name - Optional name for the attribute. If not provided, the parameter's property name will be used.\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attribute('userId') userId: string): Promise<Response>\n *\n * // Using property name as attribute key\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attribute() userId: string): Promise<Response>\n * ```\n */\nexport function attribute(name: string = '') {\n  return parameter(ParameterType.ATTRIBUTE, name);\n}\n\n/**\n * Parameter decorator for adding multiple attributes to the request.\n *\n * This decorator allows you to pass an entire object as attributes that can be accessed\n * by interceptors during the request lifecycle. The parameter should be an object whose\n * properties will be merged into the request attributes.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attributes() attrs: Record<string, any>): Promise<Response>\n * ```\n */\nexport function attributes() {\n  return parameter(ParameterType.ATTRIBUTES);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Fetcher, fetcherRegistrar } from '@ahoo-wang/fetcher';\n\n/**\n * Interface that defines a capability for objects that can have a fetcher.\n * This interface is typically used to mark components or objects that can perform fetching operations\n * and may need access to fetcher functionality.\n */\nexport interface FetcherCapable {\n  /**\n   * Optional fetcher property that can be either a string identifier or a Fetcher instance.\n   * When present, this property indicates the fetcher associated with the implementing object.\n   */\n  fetcher?: string | Fetcher;\n}\n\n/**\n * Gets a Fetcher instance based on the provided fetcher parameter.\n *\n * @param fetcher - A string identifier or Fetcher instance to resolve\n * @returns A Fetcher instance if found, undefined otherwise\n */\nexport function getFetcher(fetcher?: string | Fetcher): Fetcher | undefined {\n  // Return undefined if no fetcher is provided\n  if (!fetcher) {\n    return undefined;\n  }\n\n  // Return the fetcher directly if it's already a Fetcher instance,\n  // otherwise resolve it through the fetcher registrar\n  return fetcher instanceof Fetcher\n    ? fetcher\n    : fetcherRegistrar.requiredGet(fetcher);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  ExchangeResultExtractor,\n  JsonResultExtractor,\n  ResponseResultExtractor,\n  ResultExtractor,\n  TextResultExtractor,\n} from '@ahoo-wang/fetcher';\nimport {\n  EventStreamResultExtractor,\n  JsonEventStreamResultExtractor,\n} from '@ahoo-wang/fetcher-eventstream';\n\n/**\n * Interface with result extractor capability\n * Defines an optional resultExtractor property\n */\nexport interface ResultExtractorCapable {\n  resultExtractor?: ResultExtractor<any>;\n}\n\n/**\n * ResultExtractors is an object that maps result extractor names to their corresponding\n * extractor functions. These extractors are used to process and extract data from different\n * types of responses or results in the application.\n *\n * Each property represents a specific type of result extractor:\n * - Exchange: Handles exchange-related result extraction\n * - Response: Handles general response result extraction\n * - Json: Handles JSON format result extraction\n * - Text: Handles plain text result extraction\n * - EventStream: Handles server-sent event stream result extraction\n * - JsonEventStream: Handles JSON server-sent event stream result extraction\n */\nexport const ResultExtractors = {\n  Exchange: ExchangeResultExtractor,\n  Response: ResponseResultExtractor,\n  Json: JsonResultExtractor,\n  Text: TextResultExtractor,\n  EventStream: EventStreamResultExtractor,\n  JsonEventStream: JsonEventStreamResultExtractor,\n  DEFAULT: JsonResultExtractor,\n};\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  combineURLs,\n  Fetcher, fetcher,\n  type FetchExchangeInit,\n  FetchRequestInit,\n  mergeRequest,\n  NamedCapable,\n  type RequestHeaders,\n  ResultExtractor,\n  type UrlParams,\n} from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport { EndpointMetadata } from './endpointDecorator';\nimport { ParameterMetadata, ParameterRequest, ParameterType } from './parameterDecorator';\nimport { getFetcher } from './fetcherCapable';\nimport { ResultExtractors } from './resultExtractor';\n\n/**\n * Metadata container for a function with HTTP endpoint decorators.\n *\n * Encapsulates all the metadata needed to execute an HTTP request\n * for a decorated method, including API-level defaults, endpoint-specific\n * configuration, and parameter metadata.\n */\nexport class FunctionMetadata implements NamedCapable {\n  /**\n   * Name of the function.\n   */\n  name: string;\n\n  /**\n   * API-level metadata (class-level configuration).\n   */\n  api: ApiMetadata;\n\n  /**\n   * Endpoint-level metadata (method-level configuration).\n   */\n  endpoint: EndpointMetadata;\n\n  /**\n   * Metadata for method parameters.\n   *\n   * Defines the metadata stored for each parameter decorated with @path, @query,\n   * @header, or @body decorators. Stored as a Map keyed by parameter index.\n   *\n   * @remarks\n   * The metadata is stored as a Map<number, ParameterMetadata> where the key is\n   * the parameter index and the value is the parameter metadata. This ensures\n   * correct parameter ordering regardless of decorator application order.\n   */\n  parameters: Map<number, ParameterMetadata>;\n\n  /**\n   * Creates a new FunctionMetadata instance.\n   *\n   * @param name - The name of the function\n   * @param api - API-level metadata\n   * @param endpoint - Endpoint-level metadata\n   * @param parameters - Parameter metadata array\n   */\n  constructor(\n    name: string,\n    api: ApiMetadata,\n    endpoint: EndpointMetadata,\n    parameters: Map<number, ParameterMetadata>,\n  ) {\n    this.name = name;\n    this.api = api;\n    this.endpoint = endpoint;\n    this.parameters = parameters;\n  }\n\n  /**\n   * Gets the fetcher instance to use for this function.\n   *\n   * Returns the fetcher specified in the endpoint metadata, or the API metadata,\n   * or falls back to the default fetcher if none is specified.\n   *\n   * @returns The fetcher instance\n   */\n  get fetcher(): Fetcher {\n    return getFetcher(this.endpoint.fetcher ?? this.api.fetcher) ?? fetcher;\n  }\n\n  /**\n   * Resolves the complete path by combining base path and endpoint path\n   *\n   * @param parameterPath - Optional path parameter to use instead of endpoint path\n   * @returns The combined URL path\n   */\n  resolvePath(parameterPath?: string): string {\n    // Get the base path from endpoint, API, or default to empty string\n    const basePath = this.endpoint.basePath || this.api.basePath || '';\n\n    // Use provided parameter path or fallback to endpoint path\n    const endpointPath = parameterPath || this.endpoint.path || '';\n\n    // Combine the base path and endpoint path into a complete URL\n    return combineURLs(basePath, endpointPath);\n  }\n\n  /**\n   * Resolves the timeout for the request.\n   *\n   * Returns the timeout specified in the endpoint metadata, or the API metadata,\n   * or undefined if no timeout is specified.\n   *\n   * @returns The timeout value in milliseconds, or undefined\n   */\n  resolveTimeout(): number | undefined {\n    return this.endpoint.timeout || this.api.timeout;\n  }\n\n  resolveResultExtractor(): ResultExtractor<any> {\n    return (\n      this.endpoint.resultExtractor ||\n      this.api.resultExtractor ||\n      ResultExtractors.DEFAULT\n    );\n  }\n\n  resolveAttributes(): Record<string, any> {\n    return {\n      ...this.api.attributes,\n      ...this.endpoint.attributes,\n    };\n  }\n\n  /**\n   * Resolves the request configuration from the method arguments.\n   *\n   * This method processes the runtime arguments according to the parameter metadata\n   * and constructs a FetcherRequest object with path parameters, query parameters,\n   * headers, body, and timeout. It handles various parameter types including:\n   * - Path parameters (@path decorator)\n   * - Query parameters (@query decorator)\n   * - Header parameters (@header decorator)\n   * - Body parameter (@body decorator)\n   * - Complete request object (@request decorator)\n   * - AbortSignal for request cancellation\n   *\n   * The method uses mergeRequest to combine the endpoint-specific configuration\n   * with the parameter-provided request object, where the parameter request\n   * takes precedence over endpoint configuration.\n   *\n   * @param args - The runtime arguments passed to the method\n   * @returns A FetcherRequest object with all request configuration\n   *\n   * @example\n   * ```typescript\n   * // For a method decorated like:\n   * @get('/users/{id}')\n   * getUser(\n   *   @path('id') id: number,\n   *   @query('include') include: string,\n   *   @header('Authorization') auth: string\n   * ): Promise<Response>\n   *\n   * // Calling with: getUser(123, 'profile', 'Bearer token')\n   * // Would produce a request with:\n   * // {\n   * //   method: 'GET',\n   * //   urlParams: {\n   * //     path: { id: 123 },\n   * //     query: { include: 'profile' }\n   * //   },\n   * //   headers: {\n   * //     'Authorization': 'Bearer token',\n   * //     ...apiHeaders,\n   * //     ...endpointHeaders\n   * //   }\n   * // }\n   * ```\n   */\n  resolveExchangeInit(args: any[]): Required<Pick<FetchExchangeInit, 'request' | 'attributes'>> {\n    const pathParams: Record<string, any> = {};\n    const queryParams: Record<string, any> = {};\n    const headers: RequestHeaders = {\n      ...this.api.headers,\n      ...this.endpoint.headers,\n    };\n    let body: any = undefined;\n    let signal: AbortSignal | null | undefined = undefined;\n    let abortController: AbortController | null | undefined = undefined;\n    let parameterRequest: ParameterRequest = {};\n    const attributes: Record<string, any> = this.resolveAttributes();\n    // Process parameters based on their decorators\n    args.forEach((value, index) => {\n      if (value instanceof AbortSignal) {\n        signal = value;\n        return;\n      }\n      if (value instanceof AbortController) {\n        abortController = value;\n        return;\n      }\n      const funParameter = this.parameters.get(index);\n      if (!funParameter) {\n        return;\n      }\n      switch (funParameter.type) {\n        case ParameterType.PATH:\n          this.processPathParam(funParameter, value, pathParams);\n          break;\n        case ParameterType.QUERY:\n          this.processQueryParam(funParameter, value, queryParams);\n          break;\n        case ParameterType.HEADER:\n          this.processHeaderParam(funParameter, value, headers);\n          break;\n        case ParameterType.BODY:\n          body = value;\n          break;\n        case ParameterType.REQUEST:\n          parameterRequest = this.processRequestParam(value);\n          break;\n        case ParameterType.ATTRIBUTE:\n          this.processAttributeParam(funParameter, value, attributes);\n          break;\n        case ParameterType.ATTRIBUTES:\n          this.processAttributesParam(value, attributes);\n          break;\n      }\n    });\n    const urlParams: UrlParams = {\n      path: pathParams,\n      query: queryParams,\n    };\n    const endpointRequest: FetchRequestInit = {\n      method: this.endpoint.method,\n      urlParams,\n      headers,\n      body,\n      timeout: this.resolveTimeout(),\n      signal,\n      abortController,\n    };\n    const mergedRequest = mergeRequest(\n      endpointRequest,\n      parameterRequest,\n    ) as any;\n    const parameterPath = parameterRequest.path;\n    mergedRequest.url = this.resolvePath(parameterPath);\n    return {\n      request: mergedRequest,\n      attributes,\n    };\n  }\n\n  private processPathParam(\n    param: ParameterMetadata,\n    value: any,\n    path: Record<string, any>,\n  ) {\n    const paramName = param.name || `param${param.index}`;\n    path[paramName] = value;\n  }\n\n  private processQueryParam(\n    param: ParameterMetadata,\n    value: any,\n    query: Record<string, any>,\n  ) {\n    const paramName = param.name || `param${param.index}`;\n    query[paramName] = value;\n  }\n\n  private processHeaderParam(\n    param: ParameterMetadata,\n    value: any,\n    headers: RequestHeaders,\n  ) {\n    if (param.name && value !== undefined) {\n      headers[param.name] = String(value);\n    }\n  }\n\n  /**\n   * Processes a request parameter value.\n   *\n   * This method handles the @request() decorator parameter by casting\n   * the provided value to a FetcherRequest. The @request() decorator\n   * allows users to pass a complete FetcherRequest object to customize\n   * the request configuration.\n   *\n   * @param value - The value provided for the @request() parameter\n   * @returns The value cast to FetcherRequest type\n   *\n   * @example\n   * ```typescript\n   * @post('/users')\n   * createUsers(@request() request: FetcherRequest): Promise<Response>\n   *\n   * // Usage:\n   * const customRequest: FetcherRequest = {\n   *   headers: { 'X-Custom': 'value' },\n   *   timeout: 5000\n   * };\n   * await service.createUsers(customRequest);\n   * ```\n   */\n  private processRequestParam(value: any): ParameterRequest {\n    if (!value) {\n      return {};\n    }\n\n    const request = value as ParameterRequest;\n    // 确保请求对象中的属性被正确保留\n    return {\n      ...request,\n      headers: request.headers || {},\n      urlParams: request.urlParams || { path: {}, query: {} },\n    };\n  }\n\n\n  private processAttributeParam(\n    param: ParameterMetadata,\n    value: any,\n    attributes: Record<string, any>,\n  ) {\n    if (param.name && value !== undefined) {\n      attributes[param.name] = value;\n    }\n  }\n\n  private processAttributesParam(\n    value: any,\n    attributes: Record<string, any>,\n  ) {\n    if (typeof value !== 'object') {\n      throw new Error('@attributes() parameter must be an object');\n    }\n    Object.keys(value).forEach(key => {\n      attributes[key] = value[key];\n    });\n  }\n\n}","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  type AttributesCapable,\n  Fetcher,\n  type RequestHeaders,\n  type RequestHeadersCapable,\n  type TimeoutCapable,\n} from '@ahoo-wang/fetcher';\nimport { ENDPOINT_METADATA_KEY } from './endpointDecorator';\nimport { RequestExecutor } from './requestExecutor';\nimport { PARAMETER_METADATA_KEY } from './parameterDecorator';\nimport 'reflect-metadata';\nimport { type ResultExtractorCapable } from './resultExtractor';\nimport { type FetcherCapable } from './fetcherCapable';\nimport { FunctionMetadata } from './functionMetadata';\n\n/**\n * Metadata for class-level API configuration.\n *\n * Defines the configuration options that can be applied to an entire API class.\n * These settings will be used as defaults for all endpoints within the class unless overridden\n * at the method level.\n */\nexport interface ApiMetadata\n  extends TimeoutCapable,\n    RequestHeadersCapable,\n    ResultExtractorCapable,\n    FetcherCapable, AttributesCapable {\n  /**\n   * Base path for all endpoints in the class.\n   *\n   * This path will be prepended to all endpoint paths defined in the class.\n   * For example, if basePath is '/api/v1' and an endpoint has path '/users',\n   * the full path will be '/api/v1/users'.\n   */\n  basePath?: string;\n\n  /**\n   * Default headers for all requests in the class.\n   *\n   * These headers will be included in every request made by methods in this class.\n   * They can be overridden or extended at the method level.\n   */\n  headers?: RequestHeaders;\n\n  /**\n   * Default timeout for all requests in the class (in milliseconds).\n   *\n   * This timeout value will be applied to all requests made by methods in this class.\n   * Individual methods can specify their own timeout values to override this default.\n   */\n  timeout?: number;\n\n  /**\n   * Name of the fetcher instance to use, default: 'default'.\n   *\n   * This allows you to specify which fetcher instance should be used for requests\n   * from this API class. The fetcher must be registered with the FetcherRegistrar.\n   */\n  fetcher?: string | Fetcher;\n}\n\nexport const API_METADATA_KEY = Symbol('api:metadata');\n\n/**\n * Binds a request executor to a method, replacing the original method with\n * an implementation that makes HTTP requests based on the decorator metadata.\n *\n * @param constructor - The class constructor\n * @param functionName - The name of the method to bind\n * @param apiMetadata - The API metadata for the class\n */\nfunction bindExecutor<T extends new (...args: any[]) => any>(\n  constructor: T,\n  functionName: string,\n  apiMetadata: ApiMetadata,\n) {\n  const endpointFunction = constructor.prototype[functionName];\n  if (functionName === 'constructor') {\n    return;\n  }\n  if (typeof endpointFunction !== 'function') {\n    return;\n  }\n\n  const endpointMetadata = Reflect.getMetadata(\n    ENDPOINT_METADATA_KEY,\n    constructor.prototype,\n    functionName,\n  );\n  if (!endpointMetadata) {\n    return;\n  }\n  // Get parameter metadata for this method\n  const parameterMetadata =\n    Reflect.getMetadata(\n      PARAMETER_METADATA_KEY,\n      constructor.prototype,\n      functionName,\n    ) || new Map();\n\n  // Create function metadata\n  const functionMetadata = new FunctionMetadata(\n    functionName,\n    apiMetadata,\n    endpointMetadata,\n    parameterMetadata,\n  );\n\n  // Create request executor\n  const requestExecutor = new RequestExecutor(functionMetadata);\n\n  // Replace method with actual implementation\n  constructor.prototype[functionName] = function(...args: unknown[]) {\n    return requestExecutor.execute(this, args);\n  };\n}\n\nexport function api(\n  basePath: string = '',\n  metadata: Omit<ApiMetadata, 'basePath'> = {},\n) {\n  return function <T extends new (...args: any[]) => any>(constructor: T): T {\n    const apiMetadata: ApiMetadata = {\n      basePath,\n      ...metadata,\n    };\n\n    // Store metadata directly on the class constructor\n    Reflect.defineMetadata(API_METADATA_KEY, apiMetadata, constructor);\n\n    // Override prototype methods to implement actual HTTP calls\n    Object.getOwnPropertyNames(constructor.prototype).forEach(functionName => {\n      bindExecutor(constructor, functionName, apiMetadata);\n    });\n\n    return constructor;\n  };\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Custom error class that indicates a method implementation will be automatically generated.\n *\n * @example\n * ```\n *     @post()\n *     createUser(@body() user: User):Promise<Response> {\n *         throw autoGeneratedError(user);\n *     }\n * ```\n */\nexport class AutoGenerated extends Error {\n  constructor() {\n    super('Implementation will be generated automatically.');\n    this.name = 'AutoGenerated';\n  }\n}\n\n/**\n * Factory function that creates an AutoGenerated error instance.\n * This is typically used in methods that will be automatically implemented,\n * where a placeholder implementation is needed.\n *\n * @param _ignored - Arguments (such as 'user' in the example) are ignored to prevent\n *                   ESLint no-unused-vars errors in method signatures that will be auto-generated.\n * @returns A new AutoGenerated error instance\n */\nexport const autoGeneratedError = (..._ignored: any[]): AutoGenerated => {\n  return new AutoGenerated();\n};\n"],"names":["ENDPOINT_METADATA_KEY","endpoint","method","path","metadata","target","propertyKey","endpointMetadata","get","HttpMethod","post","put","del","patch","head","options","TARGET_FETCHER_PROPERTY","DECORATOR_TARGET_ATTRIBUTE_KEY","RequestExecutor","fetcher","Fetcher","args","exchangeInit","extractor","parameterNameCache","getParameterNames","func","fnStr","paramsStr","extractParameterString","hasParameters","emptyResult","result","parseParameterNames","errorResult","getParameterName","parameterIndex","providedName","paramNames","endParenIndex","findClosingParenthesis","startParenIndex","str","openingParenIndex","parenDepth","i","char","trimWhitespace","isNotEmpty","extractParameterName","param","cleanedParam","removeDefaultValue","removeTypeAnnotation","equalsIndex","colonIndex","ParameterType","PARAMETER_METADATA_KEY","parameter","type","name","paramName","existingParameters","parameterMetadata","query","header","body","request","attribute","attributes","getFetcher","fetcherRegistrar","ResultExtractors","ExchangeResultExtractor","ResponseResultExtractor","JsonResultExtractor","TextResultExtractor","EventStreamResultExtractor","JsonEventStreamResultExtractor","FunctionMetadata","api","parameters","parameterPath","basePath","endpointPath","combineURLs","pathParams","queryParams","headers","signal","abortController","parameterRequest","value","index","funParameter","urlParams","endpointRequest","mergedRequest","mergeRequest","key","API_METADATA_KEY","bindExecutor","constructor","functionName","apiMetadata","endpointFunction","functionMetadata","requestExecutor","AutoGenerated","autoGeneratedError","_ignored"],"mappings":"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"}
+{"version":3,"file":"index.es.js","sources":["../src/endpointDecorator.ts","../src/requestExecutor.ts","../src/reflection.ts","../src/parameterDecorator.ts","../src/fetcherCapable.ts","../src/resultExtractor.ts","../src/functionMetadata.ts","../src/apiDecorator.ts","../src/generated.ts"],"sourcesContent":["import { HttpMethod, type ResultExtractorCapable } from '@ahoo-wang/fetcher';\nimport { type ApiMetadata } from './apiDecorator';\nimport 'reflect-metadata';\n\nexport interface PathCapable {\n  /**\n   * Path for the endpoint (relative to class base path).\n   *\n   * This path will be appended to the class's base path to form the complete URL.\n   * Path parameters can be specified using curly braces, e.g., '/users/{id}'\n   */\n  path?: string;\n}\n\n/**\n * Metadata for HTTP endpoints.\n *\n * Defines the configuration options for individual HTTP endpoints (methods).\n * These settings will override any corresponding class-level settings from ApiMetadata.\n */\nexport interface EndpointMetadata\n  extends ApiMetadata,\n    ResultExtractorCapable,\n    PathCapable {\n  /**\n   * HTTP method for the endpoint.\n   *\n   * Specifies the HTTP verb to be used for this endpoint (GET, POST, PUT, DELETE, etc.)\n   */\n  method?: HttpMethod;\n}\n\nexport const ENDPOINT_METADATA_KEY = Symbol('endpoint:metadata');\n\nexport type MethodEndpointMetadata = Omit<EndpointMetadata, 'method' | 'path'>;\n\n/**\n * Decorator factory for defining HTTP endpoints.\n *\n * Creates a decorator that can be used to define HTTP endpoints\n * on class methods. It stores metadata about the endpoint that will be used\n * to generate the actual HTTP request.\n *\n * @param method - The HTTP method for this endpoint\n * @param path - The path for this endpoint (relative to class base path)\n * @param metadata - Additional endpoint metadata (headers, timeout, etc.)\n * @returns A method decorator function\n *\n * @example\n * ```typescript\n * @api('/api/v1')\n * class UserService {\n *   @endpoint(HttpMethod.GET, '/users/{id}')\n *   getUser(@path('id') id: string): Promise<Response> {\n *     // Implementation will be generated automatically\n *     throw autoGeneratedError();\n *   }\n * }\n * ```\n */\nexport function endpoint(\n  method?: HttpMethod,\n  path?: string,\n  metadata: MethodEndpointMetadata = {},\n) {\n  return function(target: object, propertyKey: string | symbol): void {\n    // Store metadata directly on the method\n    const endpointMetadata = {\n      method: method,\n      path,\n      ...metadata,\n    };\n    Reflect.defineMetadata(\n      ENDPOINT_METADATA_KEY,\n      endpointMetadata,\n      target,\n      propertyKey,\n    );\n  };\n}\n\nexport function get(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.GET, path, metadata);\n}\n\nexport function post(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.POST, path, metadata);\n}\n\nexport function put(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.PUT, path, metadata);\n}\n\nexport function del(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.DELETE, path, metadata);\n}\n\nexport function patch(\n  path: string = '',\n  metadata: MethodEndpointMetadata = {},\n) {\n  return endpoint(HttpMethod.PATCH, path, metadata);\n}\n\nexport function head(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.HEAD, path, metadata);\n}\n\nexport function options(\n  path: string = '',\n  metadata: MethodEndpointMetadata = {},\n) {\n  return endpoint(HttpMethod.OPTIONS, path, metadata);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { Fetcher } from '@ahoo-wang/fetcher';\nimport { FunctionMetadata } from './functionMetadata';\n\nconst TARGET_FETCHER_PROPERTY = 'fetcher';\n\nexport const DECORATOR_TARGET_ATTRIBUTE_KEY = '__decorator_target__';\n\n/**\n * Executor for HTTP requests based on decorated method metadata.\n *\n * This class is responsible for executing HTTP requests based on the metadata\n * collected from decorators. It resolves the path, constructs the request,\n * and executes it using the appropriate fetcher.\n */\nexport class RequestExecutor {\n  private readonly metadata: FunctionMetadata;\n\n  /**\n   * Creates a new RequestExecutor instance.\n   *\n   * @param metadata - The function metadata containing all request information\n   */\n  constructor(metadata: FunctionMetadata) {\n    this.metadata = metadata;\n  }\n\n  /**\n   * Retrieves the fetcher instance from the target object.\n   *\n   * @param target - The target object that may contain a fetcher property\n   * @returns The fetcher instance if exists, otherwise undefined\n   */\n  private getTargetFetcher(target: any): Fetcher | undefined {\n    if (!target || typeof target !== 'object') {\n      return undefined;\n    }\n    // Extract the fetcher property from the target object\n    const fetcher = target[TARGET_FETCHER_PROPERTY];\n\n    // Validate that the fetcher is an instance of the Fetcher class\n    if (fetcher instanceof Fetcher) {\n      return fetcher;\n    }\n\n    // Return undefined if no valid fetcher instance is found\n    return undefined;\n  }\n\n  /**\n   * Executes the HTTP request.\n   *\n   * This method resolves the path and request configuration from the metadata\n   * and arguments, then executes the request using the configured fetcher.\n   * It handles the complete request lifecycle from parameter processing to\n   * response extraction.\n   *\n   * @param target - The target object that the method is called on.\n   *                 This can contain a custom fetcher instance in its 'fetcher' property.\n   * @param args - The runtime arguments passed to the decorated method.\n   *               These are mapped to request components based on parameter decorators.\n   * @returns A Promise that resolves to the extracted result based on the configured result extractor.\n   *          By default, this is the Response object, but can be customized to return\n   *          parsed JSON, the raw exchange object, or any other transformed result.\n   *\n   * @example\n   * ```typescript\n   * // Given a decorated service method:\n   * class UserService {\n   *   @get('/users/{id}')\n   *   getUser(@path('id') id: number): Promise<Response> {\n   *     // This method body is replaced by the executor at runtime\n   *   }\n   * }\n   *\n   * // When calling:\n   * const userService = new UserService();\n   * const response = await userService.getUser(123);\n   *\n   * // The execute method will:\n   * // 1. Resolve the path to '/users/123'\n   * // 2. Create a request with method 'GET'\n   * // 3. Execute the request using the configured fetcher\n   * // 4. Return the Response object\n   * ```\n   */\n  async execute(target: any, args: any[]): Promise<any> {\n    const fetcher = this.getTargetFetcher(target) || this.metadata.fetcher;\n    const exchangeInit = this.metadata.resolveExchangeInit(args);\n    exchangeInit.attributes?.set(DECORATOR_TARGET_ATTRIBUTE_KEY, target);\n    const extractor = this.metadata.resolveResultExtractor();\n    return fetcher.request(exchangeInit.request, { resultExtractor: extractor, attributes: exchangeInit.attributes });\n  }\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Cache for storing previously extracted parameter names to improve performance\nconst parameterNameCache = new WeakMap<Function, string[]>();\n\n/**\n * Extracts parameter names from a function.\n *\n * This function parses the string representation of a function to extract\n * the names of its parameters. It handles various function formats including\n * regular functions, arrow functions, and methods.\n *\n * Note: This implementation provides basic parameter name extraction and may not\n * handle all edge cases of complex TypeScript parameter declarations.\n *\n * @param func - The function to extract parameter names from\n * @returns An array of parameter names, or an empty array if extraction fails\n * @throws {TypeError} If the input is not a function\n *\n * @example\n * ```typescript\n * function example(a, b, c) {}\n * const paramNames = getParameterNames(example);\n * // Returns: ['a', 'b', 'c']\n *\n * const arrowFunc = (x, y) => x + y;\n * const arrowParamNames = getParameterNames(arrowFunc);\n * // Returns: ['x', 'y']\n *\n * function complex(param1: string, param2: number = 10, ...rest: any[]) {}\n * const complexParamNames = getParameterNames(complex);\n * // Returns: ['param1', 'param2', '...rest']\n * ```\n */\nexport function getParameterNames(func: (...args: any[]) => any): string[] {\n  // Validate that the input is a function\n  if (typeof func !== 'function') {\n    throw new TypeError('Expected a function');\n  }\n\n  // Check cache first to improve performance\n  if (parameterNameCache.has(func)) {\n    return parameterNameCache.get(func)!;\n  }\n\n  try {\n    // Convert function to string and trim whitespace\n    const fnStr = func.toString().trim();\n\n    // Extract parameter string from the function\n    const paramsStr = extractParameterString(fnStr);\n\n    // Handle empty parameters\n    if (!hasParameters(paramsStr)) {\n      const emptyResult: string[] = [];\n      parameterNameCache.set(func, emptyResult);\n      return emptyResult;\n    }\n\n    // Parse and clean parameter names\n    const result = parseParameterNames(paramsStr);\n    parameterNameCache.set(func, result);\n    return result;\n  } catch {\n    // Return empty array on any parsing errors to avoid breaking the application\n    const errorResult: string[] = [];\n    parameterNameCache.set(func, errorResult);\n    return errorResult;\n  }\n}\n\n/**\n * Helper function to automatically extract parameter name when not provided.\n *\n * @param target - The target object (class prototype)\n * @param propertyKey - The method name\n * @param parameterIndex - The index of the parameter\n * @param providedName - The name explicitly provided by the user (if any)\n * @returns The parameter name, either provided or automatically extracted\n */\nexport function getParameterName(\n  target: object,\n  propertyKey: string | symbol,\n  parameterIndex: number,\n  providedName?: string,\n): string | undefined {\n  // If a name was explicitly provided, use it\n  if (providedName) {\n    return providedName;\n  }\n\n  // Try to automatically extract the parameter name\n  try {\n    const method = target[propertyKey as keyof typeof target];\n    if (method && typeof method === 'function') {\n      const paramNames = getParameterNames(method);\n      if (parameterIndex < paramNames.length) {\n        return paramNames[parameterIndex];\n      }\n    }\n  } catch {\n    // If we can't get the parameter name, return undefined\n    // This will use default naming in the execution logic\n  }\n\n  return undefined;\n}\n\n/**\n * Checks if a parameter string contains actual parameters.\n *\n * @param paramsStr - The parameter string to check\n * @returns True if the string contains parameters, false otherwise\n */\nfunction hasParameters(paramsStr: string): boolean {\n  return (\n    paramsStr !== null && paramsStr !== undefined && paramsStr.trim() !== ''\n  );\n}\n\n/**\n * Extracts the parameter string from a function string representation.\n *\n * @param fnStr - The string representation of the function\n * @returns The parameter string, or empty string if not found\n */\nfunction extractParameterString(fnStr: string): string {\n  // Handle arrow functions that start with parentheses\n  if (fnStr.startsWith('(')) {\n    const endParenIndex = findClosingParenthesis(fnStr, 0);\n    if (endParenIndex === -1) return '';\n    return fnStr.substring(1, endParenIndex);\n  }\n\n  // Handle regular functions, async functions, and methods\n  const startParenIndex = fnStr.indexOf('(');\n  if (startParenIndex === -1) return '';\n\n  const endParenIndex = findClosingParenthesis(fnStr, startParenIndex);\n  if (endParenIndex === -1) return '';\n\n  return fnStr.substring(startParenIndex + 1, endParenIndex);\n}\n\n/**\n * Finds the matching closing parenthesis for an opening parenthesis.\n *\n * @param str - The string to search in\n * @param openingParenIndex - The index of the opening parenthesis\n * @returns The index of the matching closing parenthesis, or -1 if not found\n */\nfunction findClosingParenthesis(\n  str: string,\n  openingParenIndex: number,\n): number {\n  let parenDepth = 1;\n\n  for (let i = openingParenIndex + 1; i < str.length; i++) {\n    const char = str[i];\n\n    if (char === '(') {\n      parenDepth++;\n    } else if (char === ')') {\n      parenDepth--;\n      if (parenDepth === 0) {\n        return i;\n      }\n    }\n  }\n\n  return -1; // No matching closing parenthesis found\n}\n\n/**\n * Parses and cleans parameter names from a parameter string.\n *\n * @param paramsStr - The parameter string to parse\n * @returns An array of cleaned parameter names\n */\nfunction parseParameterNames(paramsStr: string): string[] {\n  return paramsStr\n    .split(',')\n    .map(trimWhitespace)\n    .filter(isNotEmpty)\n    .map(extractParameterName);\n}\n\n/**\n * Trims whitespace from a string.\n *\n * @param str - The string to trim\n * @returns The trimmed string\n */\nfunction trimWhitespace(str: string): string {\n  return str.trim();\n}\n\n/**\n * Checks if a string is not empty.\n *\n * @param str - The string to check\n * @returns True if the string is not empty, false otherwise\n */\nfunction isNotEmpty(str: string): boolean {\n  return str.length > 0;\n}\n\n/**\n * Extracts a clean parameter name by removing type annotations and default values.\n *\n * @param param - The raw parameter string\n * @returns The cleaned parameter name\n */\nfunction extractParameterName(param: string): string {\n  // Remove default value assignment (everything after =)\n  let cleanedParam = removeDefaultValue(param);\n\n  // Remove type annotations (everything after :)\n  cleanedParam = removeTypeAnnotation(cleanedParam);\n\n  return cleanedParam.trim();\n}\n\n/**\n * Removes default value from a parameter string.\n *\n * @param param - The parameter string\n * @returns The parameter string without default value\n */\nfunction removeDefaultValue(param: string): string {\n  const equalsIndex = param.indexOf('=');\n  if (equalsIndex !== -1) {\n    return param.substring(0, equalsIndex);\n  }\n  return param;\n}\n\n/**\n * Removes type annotation from a parameter string.\n *\n * @param param - The parameter string\n * @returns The parameter string without type annotation\n */\nfunction removeTypeAnnotation(param: string): string {\n  const colonIndex = param.indexOf(':');\n  if (colonIndex !== -1) {\n    return param.substring(0, colonIndex);\n  }\n  return param;\n}\n","import { getParameterName } from './reflection';\nimport 'reflect-metadata';\nimport { type PathCapable } from './endpointDecorator';\nimport { type FetchRequestInit } from '@ahoo-wang/fetcher';\n\n/**\n * Parameter types for decorator parameters.\n *\n * Defines the different types of parameters that can be used\n * in API method decorators to specify how arguments should be handled\n * in the HTTP request.\n */\nexport enum ParameterType {\n  /**\n   * Path parameter that will be inserted into the URL path.\n   *\n   * Path parameters are used to specify dynamic parts of the URL path.\n   * They are defined using curly braces in the endpoint path.\n   *\n   * @example\n   * ```typescript\n   * @get('/users/{id}')\n   * getUser(@path('id') userId: string): Promise<Response>\n   * ```\n   */\n  PATH = 'path',\n\n  /**\n   * Query parameter that will be appended to the URL query string.\n   *\n   * Query parameters are used to pass non-hierarchical data to the server.\n   * They appear after the '?' in the URL.\n   *\n   * @example\n   * ```typescript\n   * @get('/users')\n   * getUsers(@query('limit') limit: number): Promise<Response>\n   * ```\n   */\n  QUERY = 'query',\n\n  /**\n   * Header parameter that will be added to the request headers.\n   *\n   * Header parameters are used to pass metadata about the request,\n   * such as authentication tokens or content type information.\n   *\n   * @example\n   * ```typescript\n   * @get('/users')\n   * getUsers(@header('Authorization') token: string): Promise<Response>\n   * ```\n   */\n  HEADER = 'header',\n\n  /**\n   * Body parameter that will be sent as the request body.\n   *\n   * The body parameter represents the main data payload of the request.\n   * It is typically used with POST, PUT, and PATCH requests.\n   *\n   * @example\n   * ```typescript\n   * @post('/users')\n   * createUser(@body() user: User): Promise<Response>\n   * ```\n   */\n  BODY = 'body',\n\n  /**\n   * Request parameter that will be used as the request object.\n   */\n  REQUEST = 'request',\n\n\n  /**\n   * Attribute parameter that will be used as a single attribute in the request attributes.\n   *\n   * The attribute parameter allows passing a single key-value pair that will be added\n   * to the request attributes object. This is useful for passing specific contextual\n   * information that can be accessed by interceptors.\n   */\n  ATTRIBUTE = 'attribute',\n  /**\n   * Attributes parameter that will be used as the request attributes.\n   *\n   * The attributes parameter allows passing custom data that can be accessed\n   * by interceptors throughout the request lifecycle. This is useful for\n   * sharing contextual information between different parts of the request processing.\n   */\n  ATTRIBUTES = 'attributes'\n}\n\n/**\n * Metadata for method parameters.\n *\n * Defines the metadata stored for each parameter\n * decorated with @path, @query, @header, or @body decorators.\n */\nexport interface ParameterMetadata {\n  /**\n   * Type of parameter (path, query, header, body).\n   *\n   * Specifies how this parameter should be handled in the HTTP request.\n   */\n  type: ParameterType;\n\n  /**\n   * Name of the parameter (used for path, query, and header parameters).\n   *\n   * For path and query parameters, this corresponds to the key in the URL.\n   * For header parameters, this corresponds to the header name.\n   * For body parameters, this is not used.\n   */\n  name?: string;\n\n  /**\n   * Index of the parameter in the method signature.\n   *\n   * This is used to map the runtime argument values to the correct parameter metadata.\n   */\n  index: number;\n}\n\nexport const PARAMETER_METADATA_KEY = Symbol('parameter:metadata');\n\n/**\n * Decorator factory for method parameters.\n *\n * Creates a decorator that can be used to specify how a method parameter\n * should be handled in the HTTP request. It stores metadata about the parameter\n * that will be used during request execution.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param type - The type of parameter (PATH, QUERY, HEADER, or BODY)\n * @param name - The name of the parameter (used for path, query, and header parameters, optional - auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users/{id}')\n * getUser(@parameter(ParameterType.PATH, 'id') userId: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users/{userId}')\n * getUser(@parameter(ParameterType.PATH) userId: string): Promise<Response>\n * ```\n */\nexport function parameter(type: ParameterType, name: string = '') {\n  return function(\n    target: object,\n    propertyKey: string | symbol,\n    parameterIndex: number,\n  ) {\n    const paramName = getParameterName(\n      target,\n      propertyKey as string,\n      parameterIndex,\n      name,\n    );\n\n    const existingParameters: Map<number, ParameterMetadata> =\n      Reflect.getMetadata(PARAMETER_METADATA_KEY, target, propertyKey) ||\n      new Map();\n    const parameterMetadata: ParameterMetadata = {\n      type: type,\n      name: paramName,\n      index: parameterIndex,\n    };\n    existingParameters.set(parameterIndex, parameterMetadata);\n    Reflect.defineMetadata(\n      PARAMETER_METADATA_KEY,\n      existingParameters,\n      target,\n      propertyKey,\n    );\n  };\n}\n\n/**\n * Path parameter decorator.\n *\n * Defines a path parameter that will be inserted into the URL path.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the path parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users/{id}')\n * getUser(@path('id') userId: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users/{userId}')\n * getUser(@path() userId: string): Promise<Response>\n * ```\n */\nexport function path(name: string = '') {\n  return parameter(ParameterType.PATH, name);\n}\n\n/**\n * Query parameter decorator.\n *\n * Defines a query parameter that will be appended to the URL query string.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the query parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users')\n * getUsers(@query('limit') limit: number): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users')\n * getUsers(@query() limit: number): Promise<Response>\n * ```\n */\nexport function query(name: string = '') {\n  return parameter(ParameterType.QUERY, name);\n}\n\n/**\n * Header parameter decorator.\n *\n * Defines a header parameter that will be added to the request headers.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the header parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users')\n * getUsers(@header('Authorization') token: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users')\n * getUsers(@header() authorization: string): Promise<Response>\n * ```\n */\nexport function header(name: string = '') {\n  return parameter(ParameterType.HEADER, name);\n}\n\n/**\n * Body parameter decorator.\n *\n * Defines a body parameter that will be sent as the request body.\n * Note that body parameters don't have names since there's only one body per request.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @post('/users')\n * createUser(@body() user: User): Promise<Response>\n * ```\n */\nexport function body() {\n  return parameter(ParameterType.BODY);\n}\n\n/**\n * Interface for request parameter objects.\n *\n * Combines FetchRequestInit and PathCapable interfaces to provide\n * a complete request configuration object that can be used with\n * the @request() decorator. This allows full customization of\n * the HTTP request including method, headers, body, and URL parameters.\n */\nexport interface ParameterRequest extends FetchRequestInit, PathCapable {\n}\n\n/**\n * Request parameter decorator.\n *\n * Defines a request parameter that will be used as the base request object.\n * This allows you to pass a complete ParameterRequest object to customize\n * the request configuration.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @post('/users')\n * createUsers(@request() request: ParameterRequest): Promise<Response>\n * ```\n */\nexport function request() {\n  return parameter(ParameterType.REQUEST);\n}\n\n/**\n * Parameter decorator for adding a single attribute to the request attributes.\n *\n * This decorator allows you to pass a key-value pair as an attribute that can be accessed\n * by interceptors during the request lifecycle. If no name is provided, the parameter's\n * property name will be used as the attribute key.\n *\n * @param name - Optional name for the attribute. If not provided, the parameter's property name will be used.\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attribute('userId') userId: string): Promise<Response>\n *\n * // Using property name as attribute key\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attribute() userId: string): Promise<Response>\n * ```\n */\nexport function attribute(name: string = '') {\n  return parameter(ParameterType.ATTRIBUTE, name);\n}\n\n/**\n * Parameter decorator for adding multiple attributes to the request.\n *\n * This decorator allows you to pass an entire object as attributes that can be accessed\n * by interceptors during the request lifecycle. The parameter should be an object whose\n * properties will be merged into the request attributes.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attributes() attrs: Record<string, any>): Promise<Response>\n * ```\n */\nexport function attributes() {\n  return parameter(ParameterType.ATTRIBUTES);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Fetcher, fetcherRegistrar } from '@ahoo-wang/fetcher';\n\n/**\n * Interface that defines a capability for objects that can have a fetcher.\n * This interface is typically used to mark components or objects that can perform fetching operations\n * and may need access to fetcher functionality.\n */\nexport interface FetcherCapable {\n  /**\n   * Optional fetcher property that can be either a string identifier or a Fetcher instance.\n   * When present, this property indicates the fetcher associated with the implementing object.\n   */\n  fetcher?: string | Fetcher;\n}\n\n/**\n * Gets a Fetcher instance based on the provided fetcher parameter.\n *\n * @param fetcher - A string identifier or Fetcher instance to resolve\n * @returns A Fetcher instance if found, undefined otherwise\n */\nexport function getFetcher(fetcher?: string | Fetcher): Fetcher | undefined {\n  // Return undefined if no fetcher is provided\n  if (!fetcher) {\n    return undefined;\n  }\n\n  // Return the fetcher directly if it's already a Fetcher instance,\n  // otherwise resolve it through the fetcher registrar\n  return fetcher instanceof Fetcher\n    ? fetcher\n    : fetcherRegistrar.requiredGet(fetcher);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  ExchangeResultExtractor,\n  JsonResultExtractor,\n  ResponseResultExtractor,\n  TextResultExtractor,\n} from '@ahoo-wang/fetcher';\nimport {\n  EventStreamResultExtractor,\n  JsonEventStreamResultExtractor,\n} from '@ahoo-wang/fetcher-eventstream';\n\n/**\n * ResultExtractors is an object that maps result extractor names to their corresponding\n * extractor functions. These extractors are used to process and extract data from different\n * types of responses or results in the application.\n *\n * Each property represents a specific type of result extractor:\n * - Exchange: Handles exchange-related result extraction\n * - Response: Handles general response result extraction\n * - Json: Handles JSON format result extraction\n * - Text: Handles plain text result extraction\n * - EventStream: Handles server-sent event stream result extraction\n * - JsonEventStream: Handles JSON server-sent event stream result extraction\n */\nexport const ResultExtractors = {\n  Exchange: ExchangeResultExtractor,\n  Response: ResponseResultExtractor,\n  Json: JsonResultExtractor,\n  Text: TextResultExtractor,\n  EventStream: EventStreamResultExtractor,\n  JsonEventStream: JsonEventStreamResultExtractor,\n  DEFAULT: JsonResultExtractor,\n};\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  combineURLs,\n  Fetcher, fetcher,\n  type FetchExchangeInit,\n  FetchRequestInit, mergeRecordToMap,\n  mergeRequest,\n  NamedCapable,\n  type RequestHeaders,\n  ResultExtractor,\n  type UrlParams,\n} from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport { EndpointMetadata } from './endpointDecorator';\nimport { ParameterMetadata, ParameterRequest, ParameterType } from './parameterDecorator';\nimport { getFetcher } from './fetcherCapable';\nimport { ResultExtractors } from './resultExtractor';\n\n/**\n * Metadata container for a function with HTTP endpoint decorators.\n *\n * Encapsulates all the metadata needed to execute an HTTP request\n * for a decorated method, including API-level defaults, endpoint-specific\n * configuration, and parameter metadata.\n */\nexport class FunctionMetadata implements NamedCapable {\n  /**\n   * Name of the function.\n   */\n  name: string;\n\n  /**\n   * API-level metadata (class-level configuration).\n   */\n  api: ApiMetadata;\n\n  /**\n   * Endpoint-level metadata (method-level configuration).\n   */\n  endpoint: EndpointMetadata;\n\n  /**\n   * Metadata for method parameters.\n   *\n   * Defines the metadata stored for each parameter decorated with @path, @query,\n   * @header, or @body decorators. Stored as a Map keyed by parameter index.\n   *\n   * @remarks\n   * The metadata is stored as a Map<number, ParameterMetadata> where the key is\n   * the parameter index and the value is the parameter metadata. This ensures\n   * correct parameter ordering regardless of decorator application order.\n   */\n  parameters: Map<number, ParameterMetadata>;\n\n  /**\n   * Creates a new FunctionMetadata instance.\n   *\n   * @param name - The name of the function\n   * @param api - API-level metadata\n   * @param endpoint - Endpoint-level metadata\n   * @param parameters - Parameter metadata array\n   */\n  constructor(\n    name: string,\n    api: ApiMetadata,\n    endpoint: EndpointMetadata,\n    parameters: Map<number, ParameterMetadata>,\n  ) {\n    this.name = name;\n    this.api = api;\n    this.endpoint = endpoint;\n    this.parameters = parameters;\n  }\n\n  /**\n   * Gets the fetcher instance to use for this function.\n   *\n   * Returns the fetcher specified in the endpoint metadata, or the API metadata,\n   * or falls back to the default fetcher if none is specified.\n   *\n   * @returns The fetcher instance\n   */\n  get fetcher(): Fetcher {\n    return getFetcher(this.endpoint.fetcher ?? this.api.fetcher) ?? fetcher;\n  }\n\n  /**\n   * Resolves the complete path by combining base path and endpoint path\n   *\n   * @param parameterPath - Optional path parameter to use instead of endpoint path\n   * @returns The combined URL path\n   */\n  resolvePath(parameterPath?: string): string {\n    // Get the base path from endpoint, API, or default to empty string\n    const basePath = this.endpoint.basePath || this.api.basePath || '';\n\n    // Use provided parameter path or fallback to endpoint path\n    const endpointPath = parameterPath || this.endpoint.path || '';\n\n    // Combine the base path and endpoint path into a complete URL\n    return combineURLs(basePath, endpointPath);\n  }\n\n  /**\n   * Resolves the timeout for the request.\n   *\n   * Returns the timeout specified in the endpoint metadata, or the API metadata,\n   * or undefined if no timeout is specified.\n   *\n   * @returns The timeout value in milliseconds, or undefined\n   */\n  resolveTimeout(): number | undefined {\n    return this.endpoint.timeout || this.api.timeout;\n  }\n\n  resolveResultExtractor(): ResultExtractor<any> {\n    return (\n      this.endpoint.resultExtractor ||\n      this.api.resultExtractor ||\n      ResultExtractors.DEFAULT\n    );\n  }\n\n  resolveAttributes(): Map<string, any> {\n    const resolvedAttributes = mergeRecordToMap(this.api.attributes);\n    return mergeRecordToMap(this.endpoint.attributes, resolvedAttributes);\n  }\n\n  /**\n   * Resolves the request configuration from the method arguments.\n   *\n   * This method processes the runtime arguments according to the parameter metadata\n   * and constructs a FetcherRequest object with path parameters, query parameters,\n   * headers, body, and timeout. It handles various parameter types including:\n   * - Path parameters (@path decorator)\n   * - Query parameters (@query decorator)\n   * - Header parameters (@header decorator)\n   * - Body parameter (@body decorator)\n   * - Complete request object (@request decorator)\n   * - AbortSignal for request cancellation\n   *\n   * The method uses mergeRequest to combine the endpoint-specific configuration\n   * with the parameter-provided request object, where the parameter request\n   * takes precedence over endpoint configuration.\n   *\n   * @param args - The runtime arguments passed to the method\n   * @returns A FetcherRequest object with all request configuration\n   *\n   * @example\n   * ```typescript\n   * // For a method decorated like:\n   * @get('/users/{id}')\n   * getUser(\n   *   @path('id') id: number,\n   *   @query('include') include: string,\n   *   @header('Authorization') auth: string\n   * ): Promise<Response>\n   *\n   * // Calling with: getUser(123, 'profile', 'Bearer token')\n   * // Would produce a request with:\n   * // {\n   * //   method: 'GET',\n   * //   urlParams: {\n   * //     path: { id: 123 },\n   * //     query: { include: 'profile' }\n   * //   },\n   * //   headers: {\n   * //     'Authorization': 'Bearer token',\n   * //     ...apiHeaders,\n   * //     ...endpointHeaders\n   * //   }\n   * // }\n   * ```\n   */\n  resolveExchangeInit(args: any[]): Required<Pick<FetchExchangeInit, 'request' | 'attributes'>> {\n    const pathParams: Record<string, any> = {};\n    const queryParams: Record<string, any> = {};\n    const headers: RequestHeaders = {\n      ...this.api.headers,\n      ...this.endpoint.headers,\n    };\n    let body: any = undefined;\n    let signal: AbortSignal | null | undefined = undefined;\n    let abortController: AbortController | null | undefined = undefined;\n    let parameterRequest: ParameterRequest = {};\n    const attributes: Map<string, any> = this.resolveAttributes();\n    // Process parameters based on their decorators\n    args.forEach((value, index) => {\n      if (value instanceof AbortSignal) {\n        signal = value;\n        return;\n      }\n      if (value instanceof AbortController) {\n        abortController = value;\n        return;\n      }\n      const funParameter = this.parameters.get(index);\n      if (!funParameter) {\n        return;\n      }\n      switch (funParameter.type) {\n        case ParameterType.PATH:\n          this.processPathParam(funParameter, value, pathParams);\n          break;\n        case ParameterType.QUERY:\n          this.processQueryParam(funParameter, value, queryParams);\n          break;\n        case ParameterType.HEADER:\n          this.processHeaderParam(funParameter, value, headers);\n          break;\n        case ParameterType.BODY:\n          body = value;\n          break;\n        case ParameterType.REQUEST:\n          parameterRequest = this.processRequestParam(value);\n          break;\n        case ParameterType.ATTRIBUTE:\n          this.processAttributeParam(funParameter, value, attributes);\n          break;\n        case ParameterType.ATTRIBUTES:\n          this.processAttributesParam(value, attributes);\n          break;\n      }\n    });\n    const urlParams: UrlParams = {\n      path: pathParams,\n      query: queryParams,\n    };\n    const endpointRequest: FetchRequestInit = {\n      method: this.endpoint.method,\n      urlParams,\n      headers,\n      body,\n      timeout: this.resolveTimeout(),\n      signal,\n      abortController,\n    };\n    const mergedRequest = mergeRequest(\n      endpointRequest,\n      parameterRequest,\n    ) as any;\n    const parameterPath = parameterRequest.path;\n    mergedRequest.url = this.resolvePath(parameterPath);\n    return {\n      request: mergedRequest,\n      attributes,\n    };\n  }\n\n  private processPathParam(\n    param: ParameterMetadata,\n    value: any,\n    path: Record<string, any>,\n  ) {\n    const paramName = param.name || `param${param.index}`;\n    path[paramName] = value;\n  }\n\n  private processQueryParam(\n    param: ParameterMetadata,\n    value: any,\n    query: Record<string, any>,\n  ) {\n    const paramName = param.name || `param${param.index}`;\n    query[paramName] = value;\n  }\n\n  private processHeaderParam(\n    param: ParameterMetadata,\n    value: any,\n    headers: RequestHeaders,\n  ) {\n    if (param.name && value !== undefined) {\n      headers[param.name] = String(value);\n    }\n  }\n\n  /**\n   * Processes a request parameter value.\n   *\n   * This method handles the @request() decorator parameter by casting\n   * the provided value to a FetcherRequest. The @request() decorator\n   * allows users to pass a complete FetcherRequest object to customize\n   * the request configuration.\n   *\n   * @param value - The value provided for the @request() parameter\n   * @returns The value cast to FetcherRequest type\n   *\n   * @example\n   * ```typescript\n   * @post('/users')\n   * createUsers(@request() request: FetcherRequest): Promise<Response>\n   *\n   * // Usage:\n   * const customRequest: FetcherRequest = {\n   *   headers: { 'X-Custom': 'value' },\n   *   timeout: 5000\n   * };\n   * await service.createUsers(customRequest);\n   * ```\n   */\n  private processRequestParam(value: any): ParameterRequest {\n    if (!value) {\n      return {};\n    }\n\n    const request = value as ParameterRequest;\n    // 确保请求对象中的属性被正确保留\n    return {\n      ...request,\n      headers: request.headers || {},\n      urlParams: request.urlParams || { path: {}, query: {} },\n    };\n  }\n\n\n  private processAttributeParam(\n    param: ParameterMetadata,\n    value: any,\n    attributes: Map<string, any>,\n  ) {\n    if (param.name && value !== undefined) {\n      attributes.set(param.name, value);\n    }\n  }\n\n  private processAttributesParam(\n    value: any,\n    attributes: Map<string, any>,\n  ) {\n    if (typeof value !== 'object' || value ! instanceof Map) {\n      throw new Error('@attributes() parameter must be an object or an Map');\n    }\n    mergeRecordToMap(value, attributes);\n  }\n\n}","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  type AttributesCapable,\n  Fetcher,\n  type RequestHeaders,\n  type RequestHeadersCapable,\n  type ResultExtractorCapable,\n  type TimeoutCapable,\n} from '@ahoo-wang/fetcher';\nimport { ENDPOINT_METADATA_KEY } from './endpointDecorator';\nimport { RequestExecutor } from './requestExecutor';\nimport { PARAMETER_METADATA_KEY } from './parameterDecorator';\nimport 'reflect-metadata';\nimport { type FetcherCapable } from './fetcherCapable';\nimport { FunctionMetadata } from './functionMetadata';\n\n/**\n * Metadata for class-level API configuration.\n *\n * Defines the configuration options that can be applied to an entire API class.\n * These settings will be used as defaults for all endpoints within the class unless overridden\n * at the method level.\n */\nexport interface ApiMetadata\n  extends TimeoutCapable,\n    RequestHeadersCapable,\n    ResultExtractorCapable,\n    FetcherCapable, AttributesCapable {\n  /**\n   * Base path for all endpoints in the class.\n   *\n   * This path will be prepended to all endpoint paths defined in the class.\n   * For example, if basePath is '/api/v1' and an endpoint has path '/users',\n   * the full path will be '/api/v1/users'.\n   */\n  basePath?: string;\n\n  /**\n   * Default headers for all requests in the class.\n   *\n   * These headers will be included in every request made by methods in this class.\n   * They can be overridden or extended at the method level.\n   */\n  headers?: RequestHeaders;\n\n  /**\n   * Default timeout for all requests in the class (in milliseconds).\n   *\n   * This timeout value will be applied to all requests made by methods in this class.\n   * Individual methods can specify their own timeout values to override this default.\n   */\n  timeout?: number;\n\n  /**\n   * Name of the fetcher instance to use, default: 'default'.\n   *\n   * This allows you to specify which fetcher instance should be used for requests\n   * from this API class. The fetcher must be registered with the FetcherRegistrar.\n   */\n  fetcher?: string | Fetcher;\n}\n\nexport const API_METADATA_KEY = Symbol('api:metadata');\n\n/**\n * Binds a request executor to a method, replacing the original method with\n * an implementation that makes HTTP requests based on the decorator metadata.\n *\n * @param constructor - The class constructor\n * @param functionName - The name of the method to bind\n * @param apiMetadata - The API metadata for the class\n */\nfunction bindExecutor<T extends new (...args: any[]) => any>(\n  constructor: T,\n  functionName: string,\n  apiMetadata: ApiMetadata,\n) {\n  const endpointFunction = constructor.prototype[functionName];\n  if (functionName === 'constructor') {\n    return;\n  }\n  if (typeof endpointFunction !== 'function') {\n    return;\n  }\n\n  const endpointMetadata = Reflect.getMetadata(\n    ENDPOINT_METADATA_KEY,\n    constructor.prototype,\n    functionName,\n  );\n  if (!endpointMetadata) {\n    return;\n  }\n  // Get parameter metadata for this method\n  const parameterMetadata =\n    Reflect.getMetadata(\n      PARAMETER_METADATA_KEY,\n      constructor.prototype,\n      functionName,\n    ) || new Map();\n\n  // Create function metadata\n  const functionMetadata = new FunctionMetadata(\n    functionName,\n    apiMetadata,\n    endpointMetadata,\n    parameterMetadata,\n  );\n\n  // Create request executor\n  const requestExecutor = new RequestExecutor(functionMetadata);\n\n  // Replace method with actual implementation\n  constructor.prototype[functionName] = function(...args: unknown[]) {\n    return requestExecutor.execute(this, args);\n  };\n}\n\nexport function api(\n  basePath: string = '',\n  metadata: Omit<ApiMetadata, 'basePath'> = {},\n) {\n  return function <T extends new (...args: any[]) => any>(constructor: T): T {\n    const apiMetadata: ApiMetadata = {\n      basePath,\n      ...metadata,\n    };\n\n    // Store metadata directly on the class constructor\n    Reflect.defineMetadata(API_METADATA_KEY, apiMetadata, constructor);\n\n    // Override prototype methods to implement actual HTTP calls\n    Object.getOwnPropertyNames(constructor.prototype).forEach(functionName => {\n      bindExecutor(constructor, functionName, apiMetadata);\n    });\n\n    return constructor;\n  };\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Custom error class that indicates a method implementation will be automatically generated.\n *\n * @example\n * ```\n *     @post()\n *     createUser(@body() user: User):Promise<Response> {\n *         throw autoGeneratedError(user);\n *     }\n * ```\n */\nexport class AutoGenerated extends Error {\n  constructor() {\n    super('Implementation will be generated automatically.');\n    this.name = 'AutoGenerated';\n  }\n}\n\n/**\n * Factory function that creates an AutoGenerated error instance.\n * This is typically used in methods that will be automatically implemented,\n * where a placeholder implementation is needed.\n *\n * @param _ignored - Arguments (such as 'user' in the example) are ignored to prevent\n *                   ESLint no-unused-vars errors in method signatures that will be auto-generated.\n * @returns A new AutoGenerated error instance\n */\nexport const autoGeneratedError = (..._ignored: any[]): AutoGenerated => {\n  return new AutoGenerated();\n};\n"],"names":["ENDPOINT_METADATA_KEY","endpoint","method","path","metadata","target","propertyKey","endpointMetadata","get","HttpMethod","post","put","del","patch","head","options","TARGET_FETCHER_PROPERTY","DECORATOR_TARGET_ATTRIBUTE_KEY","RequestExecutor","fetcher","Fetcher","args","exchangeInit","extractor","parameterNameCache","getParameterNames","func","fnStr","paramsStr","extractParameterString","hasParameters","emptyResult","result","parseParameterNames","errorResult","getParameterName","parameterIndex","providedName","paramNames","endParenIndex","findClosingParenthesis","startParenIndex","str","openingParenIndex","parenDepth","i","char","trimWhitespace","isNotEmpty","extractParameterName","param","cleanedParam","removeDefaultValue","removeTypeAnnotation","equalsIndex","colonIndex","ParameterType","PARAMETER_METADATA_KEY","parameter","type","name","paramName","existingParameters","parameterMetadata","query","header","body","request","attribute","attributes","getFetcher","fetcherRegistrar","ResultExtractors","ExchangeResultExtractor","ResponseResultExtractor","JsonResultExtractor","TextResultExtractor","EventStreamResultExtractor","JsonEventStreamResultExtractor","FunctionMetadata","api","parameters","parameterPath","basePath","endpointPath","combineURLs","resolvedAttributes","mergeRecordToMap","pathParams","queryParams","headers","signal","abortController","parameterRequest","value","index","funParameter","urlParams","endpointRequest","mergedRequest","mergeRequest","API_METADATA_KEY","bindExecutor","constructor","functionName","apiMetadata","endpointFunction","functionMetadata","requestExecutor","AutoGenerated","autoGeneratedError","_ignored"],"mappings":"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"}

package/dist/index.umd.js

@@ -1,2 +1,2 @@
-(function(a,i){typeof exports=="object"&&typeof module<"u"?i(exports,require("@ahoo-wang/fetcher"),require("reflect-metadata"),require("@ahoo-wang/fetcher-eventstream")):typeof define=="function"&&define.amd?define(["exports","@ahoo-wang/fetcher","reflect-metadata","@ahoo-wang/fetcher-eventstream"],i):(a=typeof globalThis<"u"?globalThis:a||self,i(a.FetcherDecorator={},a.Fetcher,a["reflect-metadata"],a.FetcherEventStream))})(this,(function(a,i,ut,b){"use strict";const R=Symbol("endpoint:metadata");function d(t,e,r={}){return function(n,o){const s={method:t,path:e,...r};Reflect.defineMetadata(R,s,n,o)}}function F(t="",e={}){return d(i.HttpMethod.GET,t,e)}function S(t="",e={}){return d(i.HttpMethod.POST,t,e)}function v(t="",e={}){return d(i.HttpMethod.PUT,t,e)}function U(t="",e={}){return d(i.HttpMethod.DELETE,t,e)}function x(t="",e={}){return d(i.HttpMethod.PATCH,t,e)}function Y(t="",e={}){return d(i.HttpMethod.HEAD,t,e)}function N(t="",e={}){return d(i.HttpMethod.OPTIONS,t,e)}const G="fetcher",P="__decorator_target__";class g{constructor(e){this.metadata=e}getTargetFetcher(e){if(!e||typeof e!="object")return;const r=e[G];if(r instanceof i.Fetcher)return r}async execute(e,r){const n=this.getTargetFetcher(e)||this.metadata.fetcher,o=this.metadata.resolveExchangeInit(r);o.attributes[P]=e;const s=this.metadata.resolveResultExtractor();return n.request(o.request,s,o.attributes)}}const p=new WeakMap;function M(t){if(typeof t!="function")throw new TypeError("Expected a function");if(p.has(t))return p.get(t);try{const e=t.toString().trim(),r=B(e);if(!k(r)){const o=[];return p.set(t,o),o}const n=C(r);return p.set(t,n),n}catch{const e=[];return p.set(t,e),e}}function y(t,e,r,n){if(n)return n;try{const o=t[e];if(o&&typeof o=="function"){const s=M(o);if(r<s.length)return s[r]}}catch{}}function k(t){return t!=null&&t.trim()!==""}function B(t){if(t.startsWith("(")){const n=q(t,0);return n===-1?"":t.substring(1,n)}const e=t.indexOf("(");if(e===-1)return"";const r=q(t,e);return r===-1?"":t.substring(e+1,r)}function q(t,e){let r=1;for(let n=e+1;n<t.length;n++){const o=t[n];if(o==="(")r++;else if(o===")"&&(r--,r===0))return n}return-1}function C(t){return t.split(",").map(j).filter(K).map(Q)}function j(t){return t.trim()}function K(t){return t.length>0}function Q(t){let e=J(t);return e=L(e),e.trim()}function J(t){const e=t.indexOf("=");return e!==-1?t.substring(0,e):t}function L(t){const e=t.indexOf(":");return e!==-1?t.substring(0,e):t}var c=(t=>(t.PATH="path",t.QUERY="query",t.HEADER="header",t.BODY="body",t.REQUEST="request",t.ATTRIBUTE="attribute",t.ATTRIBUTES="attributes",t))(c||{});const T=Symbol("parameter:metadata");function h(t,e=""){return function(r,n,o){const s=y(r,n,o,e),m=Reflect.getMetadata(T,r,n)||new Map,f={type:t,name:s,index:o};m.set(o,f),Reflect.defineMetadata(T,m,r,n)}}function W(t=""){return h("path",t)}function V(t=""){return h("query",t)}function z(t=""){return h("header",t)}function X(){return h("body")}function Z(){return h("request")}function $(t=""){return h("attribute",t)}function tt(){return h("attributes")}function _(t){if(t)return t instanceof i.Fetcher?t:i.fetcherRegistrar.requiredGet(t)}const D={Exchange:i.ExchangeResultExtractor,Response:i.ResponseResultExtractor,Json:i.JsonResultExtractor,Text:i.TextResultExtractor,EventStream:b.EventStreamResultExtractor,JsonEventStream:b.JsonEventStreamResultExtractor,DEFAULT:i.JsonResultExtractor};class O{constructor(e,r,n,o){this.name=e,this.api=r,this.endpoint=n,this.parameters=o}get fetcher(){return _(this.endpoint.fetcher??this.api.fetcher)??i.fetcher}resolvePath(e){const r=this.endpoint.basePath||this.api.basePath||"",n=e||this.endpoint.path||"";return i.combineURLs(r,n)}resolveTimeout(){return this.endpoint.timeout||this.api.timeout}resolveResultExtractor(){return this.endpoint.resultExtractor||this.api.resultExtractor||D.DEFAULT}resolveAttributes(){return{...this.api.attributes,...this.endpoint.attributes}}resolveExchangeInit(e){const r={},n={},o={...this.api.headers,...this.endpoint.headers};let s,m,f,l={};const A=this.resolveAttributes();e.forEach((u,st)=>{if(u instanceof AbortSignal){m=u;return}if(u instanceof AbortController){f=u;return}const E=this.parameters.get(st);if(E)switch(E.type){case c.PATH:this.processPathParam(E,u,r);break;case c.QUERY:this.processQueryParam(E,u,n);break;case c.HEADER:this.processHeaderParam(E,u,o);break;case c.BODY:s=u;break;case c.REQUEST:l=this.processRequestParam(u);break;case c.ATTRIBUTE:this.processAttributeParam(E,u,A);break;case c.ATTRIBUTES:this.processAttributesParam(u,A);break}});const at={path:r,query:n},ot={method:this.endpoint.method,urlParams:at,headers:o,body:s,timeout:this.resolveTimeout(),signal:m,abortController:f},H=i.mergeRequest(ot,l),it=l.path;return H.url=this.resolvePath(it),{request:H,attributes:A}}processPathParam(e,r,n){const o=e.name||`param${e.index}`;n[o]=r}processQueryParam(e,r,n){const o=e.name||`param${e.index}`;n[o]=r}processHeaderParam(e,r,n){e.name&&r!==void 0&&(n[e.name]=String(r))}processRequestParam(e){if(!e)return{};const r=e;return{...r,headers:r.headers||{},urlParams:r.urlParams||{path:{},query:{}}}}processAttributeParam(e,r,n){e.name&&r!==void 0&&(n[e.name]=r)}processAttributesParam(e,r){if(typeof e!="object")throw new Error("@attributes() parameter must be an object");Object.keys(e).forEach(n=>{r[n]=e[n]})}}const w=Symbol("api:metadata");function et(t,e,r){const n=t.prototype[e];if(e==="constructor"||typeof n!="function")return;const o=Reflect.getMetadata(R,t.prototype,e);if(!o)return;const s=Reflect.getMetadata(T,t.prototype,e)||new Map,m=new O(e,r,o,s),f=new g(m);t.prototype[e]=function(...l){return f.execute(this,l)}}function rt(t="",e={}){return function(r){const n={basePath:t,...e};return Reflect.defineMetadata(w,n,r),Object.getOwnPropertyNames(r.prototype).forEach(o=>{et(r,o,n)}),r}}class I extends Error{constructor(){super("Implementation will be generated automatically."),this.name="AutoGenerated"}}const nt=(...t)=>new I;a.API_METADATA_KEY=w,a.AutoGenerated=I,a.DECORATOR_TARGET_ATTRIBUTE_KEY=P,a.ENDPOINT_METADATA_KEY=R,a.FunctionMetadata=O,a.PARAMETER_METADATA_KEY=T,a.ParameterType=c,a.RequestExecutor=g,a.ResultExtractors=D,a.api=rt,a.attribute=$,a.attributes=tt,a.autoGeneratedError=nt,a.body=X,a.del=U,a.endpoint=d,a.get=F,a.getFetcher=_,a.getParameterName=y,a.getParameterNames=M,a.head=Y,a.header=z,a.options=N,a.parameter=h,a.patch=x,a.path=W,a.post=S,a.put=v,a.query=V,a.request=Z,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})}));
+(function(a,s){typeof exports=="object"&&typeof module<"u"?s(exports,require("@ahoo-wang/fetcher"),require("reflect-metadata"),require("@ahoo-wang/fetcher-eventstream")):typeof define=="function"&&define.amd?define(["exports","@ahoo-wang/fetcher","reflect-metadata","@ahoo-wang/fetcher-eventstream"],s):(a=typeof globalThis<"u"?globalThis:a||self,s(a.FetcherDecorator={},a.Fetcher,a["reflect-metadata"],a.FetcherEventStream))})(this,(function(a,s,ut,b){"use strict";const R=Symbol("endpoint:metadata");function d(t,e,r={}){return function(n,o){const i={method:t,path:e,...r};Reflect.defineMetadata(R,i,n,o)}}function v(t="",e={}){return d(s.HttpMethod.GET,t,e)}function F(t="",e={}){return d(s.HttpMethod.POST,t,e)}function S(t="",e={}){return d(s.HttpMethod.PUT,t,e)}function x(t="",e={}){return d(s.HttpMethod.DELETE,t,e)}function U(t="",e={}){return d(s.HttpMethod.PATCH,t,e)}function Y(t="",e={}){return d(s.HttpMethod.HEAD,t,e)}function N(t="",e={}){return d(s.HttpMethod.OPTIONS,t,e)}const G="fetcher",P="__decorator_target__";class g{constructor(e){this.metadata=e}getTargetFetcher(e){if(!e||typeof e!="object")return;const r=e[G];if(r instanceof s.Fetcher)return r}async execute(e,r){const n=this.getTargetFetcher(e)||this.metadata.fetcher,o=this.metadata.resolveExchangeInit(r);o.attributes?.set(P,e);const i=this.metadata.resolveResultExtractor();return n.request(o.request,{resultExtractor:i,attributes:o.attributes})}}const p=new WeakMap;function M(t){if(typeof t!="function")throw new TypeError("Expected a function");if(p.has(t))return p.get(t);try{const e=t.toString().trim(),r=B(e);if(!k(r)){const o=[];return p.set(t,o),o}const n=C(r);return p.set(t,n),n}catch{const e=[];return p.set(t,e),e}}function y(t,e,r,n){if(n)return n;try{const o=t[e];if(o&&typeof o=="function"){const i=M(o);if(r<i.length)return i[r]}}catch{}}function k(t){return t!=null&&t.trim()!==""}function B(t){if(t.startsWith("(")){const n=q(t,0);return n===-1?"":t.substring(1,n)}const e=t.indexOf("(");if(e===-1)return"";const r=q(t,e);return r===-1?"":t.substring(e+1,r)}function q(t,e){let r=1;for(let n=e+1;n<t.length;n++){const o=t[n];if(o==="(")r++;else if(o===")"&&(r--,r===0))return n}return-1}function C(t){return t.split(",").map(j).filter(K).map(Q)}function j(t){return t.trim()}function K(t){return t.length>0}function Q(t){let e=J(t);return e=L(e),e.trim()}function J(t){const e=t.indexOf("=");return e!==-1?t.substring(0,e):t}function L(t){const e=t.indexOf(":");return e!==-1?t.substring(0,e):t}var c=(t=>(t.PATH="path",t.QUERY="query",t.HEADER="header",t.BODY="body",t.REQUEST="request",t.ATTRIBUTE="attribute",t.ATTRIBUTES="attributes",t))(c||{});const T=Symbol("parameter:metadata");function h(t,e=""){return function(r,n,o){const i=y(r,n,o,e),m=Reflect.getMetadata(T,r,n)||new Map,f={type:t,name:i,index:o};m.set(o,f),Reflect.defineMetadata(T,m,r,n)}}function W(t=""){return h("path",t)}function V(t=""){return h("query",t)}function z(t=""){return h("header",t)}function X(){return h("body")}function Z(){return h("request")}function $(t=""){return h("attribute",t)}function tt(){return h("attributes")}function _(t){if(t)return t instanceof s.Fetcher?t:s.fetcherRegistrar.requiredGet(t)}const D={Exchange:s.ExchangeResultExtractor,Response:s.ResponseResultExtractor,Json:s.JsonResultExtractor,Text:s.TextResultExtractor,EventStream:b.EventStreamResultExtractor,JsonEventStream:b.JsonEventStreamResultExtractor,DEFAULT:s.JsonResultExtractor};class O{constructor(e,r,n,o){this.name=e,this.api=r,this.endpoint=n,this.parameters=o}get fetcher(){return _(this.endpoint.fetcher??this.api.fetcher)??s.fetcher}resolvePath(e){const r=this.endpoint.basePath||this.api.basePath||"",n=e||this.endpoint.path||"";return s.combineURLs(r,n)}resolveTimeout(){return this.endpoint.timeout||this.api.timeout}resolveResultExtractor(){return this.endpoint.resultExtractor||this.api.resultExtractor||D.DEFAULT}resolveAttributes(){const e=s.mergeRecordToMap(this.api.attributes);return s.mergeRecordToMap(this.endpoint.attributes,e)}resolveExchangeInit(e){const r={},n={},o={...this.api.headers,...this.endpoint.headers};let i,m,f,l={};const A=this.resolveAttributes();e.forEach((u,it)=>{if(u instanceof AbortSignal){m=u;return}if(u instanceof AbortController){f=u;return}const E=this.parameters.get(it);if(E)switch(E.type){case c.PATH:this.processPathParam(E,u,r);break;case c.QUERY:this.processQueryParam(E,u,n);break;case c.HEADER:this.processHeaderParam(E,u,o);break;case c.BODY:i=u;break;case c.REQUEST:l=this.processRequestParam(u);break;case c.ATTRIBUTE:this.processAttributeParam(E,u,A);break;case c.ATTRIBUTES:this.processAttributesParam(u,A);break}});const at={path:r,query:n},ot={method:this.endpoint.method,urlParams:at,headers:o,body:i,timeout:this.resolveTimeout(),signal:m,abortController:f},H=s.mergeRequest(ot,l),st=l.path;return H.url=this.resolvePath(st),{request:H,attributes:A}}processPathParam(e,r,n){const o=e.name||`param${e.index}`;n[o]=r}processQueryParam(e,r,n){const o=e.name||`param${e.index}`;n[o]=r}processHeaderParam(e,r,n){e.name&&r!==void 0&&(n[e.name]=String(r))}processRequestParam(e){if(!e)return{};const r=e;return{...r,headers:r.headers||{},urlParams:r.urlParams||{path:{},query:{}}}}processAttributeParam(e,r,n){e.name&&r!==void 0&&n.set(e.name,r)}processAttributesParam(e,r){if(typeof e!="object"||e instanceof Map)throw new Error("@attributes() parameter must be an object or an Map");s.mergeRecordToMap(e,r)}}const w=Symbol("api:metadata");function et(t,e,r){const n=t.prototype[e];if(e==="constructor"||typeof n!="function")return;const o=Reflect.getMetadata(R,t.prototype,e);if(!o)return;const i=Reflect.getMetadata(T,t.prototype,e)||new Map,m=new O(e,r,o,i),f=new g(m);t.prototype[e]=function(...l){return f.execute(this,l)}}function rt(t="",e={}){return function(r){const n={basePath:t,...e};return Reflect.defineMetadata(w,n,r),Object.getOwnPropertyNames(r.prototype).forEach(o=>{et(r,o,n)}),r}}class I extends Error{constructor(){super("Implementation will be generated automatically."),this.name="AutoGenerated"}}const nt=(...t)=>new I;a.API_METADATA_KEY=w,a.AutoGenerated=I,a.DECORATOR_TARGET_ATTRIBUTE_KEY=P,a.ENDPOINT_METADATA_KEY=R,a.FunctionMetadata=O,a.PARAMETER_METADATA_KEY=T,a.ParameterType=c,a.RequestExecutor=g,a.ResultExtractors=D,a.api=rt,a.attribute=$,a.attributes=tt,a.autoGeneratedError=nt,a.body=X,a.del=x,a.endpoint=d,a.get=v,a.getFetcher=_,a.getParameterName=y,a.getParameterNames=M,a.head=Y,a.header=z,a.options=N,a.parameter=h,a.patch=U,a.path=W,a.post=F,a.put=S,a.query=V,a.request=Z,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})}));
 //# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.umd.js","sources":["../src/endpointDecorator.ts","../src/requestExecutor.ts","../src/reflection.ts","../src/parameterDecorator.ts","../src/fetcherCapable.ts","../src/resultExtractor.ts","../src/functionMetadata.ts","../src/apiDecorator.ts","../src/generated.ts"],"sourcesContent":["import { HttpMethod } from '@ahoo-wang/fetcher';\nimport { type ApiMetadata } from './apiDecorator';\nimport 'reflect-metadata';\nimport { type ResultExtractorCapable } from './resultExtractor';\n\nexport interface PathCapable {\n  /**\n   * Path for the endpoint (relative to class base path).\n   *\n   * This path will be appended to the class's base path to form the complete URL.\n   * Path parameters can be specified using curly braces, e.g., '/users/{id}'\n   */\n  path?: string;\n}\n\n/**\n * Metadata for HTTP endpoints.\n *\n * Defines the configuration options for individual HTTP endpoints (methods).\n * These settings will override any corresponding class-level settings from ApiMetadata.\n */\nexport interface EndpointMetadata\n  extends ApiMetadata,\n    ResultExtractorCapable,\n    PathCapable {\n  /**\n   * HTTP method for the endpoint.\n   *\n   * Specifies the HTTP verb to be used for this endpoint (GET, POST, PUT, DELETE, etc.)\n   */\n  method?: HttpMethod;\n}\n\nexport const ENDPOINT_METADATA_KEY = Symbol('endpoint:metadata');\n\nexport type MethodEndpointMetadata = Omit<EndpointMetadata, 'method' | 'path'>;\n\n/**\n * Decorator factory for defining HTTP endpoints.\n *\n * Creates a decorator that can be used to define HTTP endpoints\n * on class methods. It stores metadata about the endpoint that will be used\n * to generate the actual HTTP request.\n *\n * @param method - The HTTP method for this endpoint\n * @param path - The path for this endpoint (relative to class base path)\n * @param metadata - Additional endpoint metadata (headers, timeout, etc.)\n * @returns A method decorator function\n *\n * @example\n * ```typescript\n * @api('/api/v1')\n * class UserService {\n *   @endpoint(HttpMethod.GET, '/users/{id}')\n *   getUser(@path('id') id: string): Promise<Response> {\n *     // Implementation will be generated automatically\n *     throw autoGeneratedError();\n *   }\n * }\n * ```\n */\nexport function endpoint(\n  method?: HttpMethod,\n  path?: string,\n  metadata: MethodEndpointMetadata = {},\n) {\n  return function(target: object, propertyKey: string | symbol): void {\n    // Store metadata directly on the method\n    const endpointMetadata = {\n      method: method,\n      path,\n      ...metadata,\n    };\n    Reflect.defineMetadata(\n      ENDPOINT_METADATA_KEY,\n      endpointMetadata,\n      target,\n      propertyKey,\n    );\n  };\n}\n\nexport function get(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.GET, path, metadata);\n}\n\nexport function post(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.POST, path, metadata);\n}\n\nexport function put(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.PUT, path, metadata);\n}\n\nexport function del(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.DELETE, path, metadata);\n}\n\nexport function patch(\n  path: string = '',\n  metadata: MethodEndpointMetadata = {},\n) {\n  return endpoint(HttpMethod.PATCH, path, metadata);\n}\n\nexport function head(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.HEAD, path, metadata);\n}\n\nexport function options(\n  path: string = '',\n  metadata: MethodEndpointMetadata = {},\n) {\n  return endpoint(HttpMethod.OPTIONS, path, metadata);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { Fetcher } from '@ahoo-wang/fetcher';\nimport { FunctionMetadata } from './functionMetadata';\n\nconst TARGET_FETCHER_PROPERTY = 'fetcher';\n\nexport const DECORATOR_TARGET_ATTRIBUTE_KEY = '__decorator_target__';\n\n/**\n * Executor for HTTP requests based on decorated method metadata.\n *\n * This class is responsible for executing HTTP requests based on the metadata\n * collected from decorators. It resolves the path, constructs the request,\n * and executes it using the appropriate fetcher.\n */\nexport class RequestExecutor {\n  private readonly metadata: FunctionMetadata;\n\n  /**\n   * Creates a new RequestExecutor instance.\n   *\n   * @param metadata - The function metadata containing all request information\n   */\n  constructor(metadata: FunctionMetadata) {\n    this.metadata = metadata;\n  }\n\n  /**\n   * Retrieves the fetcher instance from the target object.\n   *\n   * @param target - The target object that may contain a fetcher property\n   * @returns The fetcher instance if exists, otherwise undefined\n   */\n  private getTargetFetcher(target: any): Fetcher | undefined {\n    if (!target || typeof target !== 'object') {\n      return undefined;\n    }\n    // Extract the fetcher property from the target object\n    const fetcher = target[TARGET_FETCHER_PROPERTY];\n\n    // Validate that the fetcher is an instance of the Fetcher class\n    if (fetcher instanceof Fetcher) {\n      return fetcher;\n    }\n\n    // Return undefined if no valid fetcher instance is found\n    return undefined;\n  }\n\n  /**\n   * Executes the HTTP request.\n   *\n   * This method resolves the path and request configuration from the metadata\n   * and arguments, then executes the request using the configured fetcher.\n   * It handles the complete request lifecycle from parameter processing to\n   * response extraction.\n   *\n   * @param target - The target object that the method is called on.\n   *                 This can contain a custom fetcher instance in its 'fetcher' property.\n   * @param args - The runtime arguments passed to the decorated method.\n   *               These are mapped to request components based on parameter decorators.\n   * @returns A Promise that resolves to the extracted result based on the configured result extractor.\n   *          By default, this is the Response object, but can be customized to return\n   *          parsed JSON, the raw exchange object, or any other transformed result.\n   *\n   * @example\n   * ```typescript\n   * // Given a decorated service method:\n   * class UserService {\n   *   @get('/users/{id}')\n   *   getUser(@path('id') id: number): Promise<Response> {\n   *     // This method body is replaced by the executor at runtime\n   *   }\n   * }\n   *\n   * // When calling:\n   * const userService = new UserService();\n   * const response = await userService.getUser(123);\n   *\n   * // The execute method will:\n   * // 1. Resolve the path to '/users/123'\n   * // 2. Create a request with method 'GET'\n   * // 3. Execute the request using the configured fetcher\n   * // 4. Return the Response object\n   * ```\n   */\n  async execute(target: any, args: any[]): Promise<any> {\n    const fetcher = this.getTargetFetcher(target) || this.metadata.fetcher;\n    const exchangeInit = this.metadata.resolveExchangeInit(args);\n    exchangeInit.attributes[DECORATOR_TARGET_ATTRIBUTE_KEY] = target;\n    const extractor = this.metadata.resolveResultExtractor();\n    return fetcher.request(exchangeInit.request, extractor, exchangeInit.attributes);\n  }\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Cache for storing previously extracted parameter names to improve performance\nconst parameterNameCache = new WeakMap<Function, string[]>();\n\n/**\n * Extracts parameter names from a function.\n *\n * This function parses the string representation of a function to extract\n * the names of its parameters. It handles various function formats including\n * regular functions, arrow functions, and methods.\n *\n * Note: This implementation provides basic parameter name extraction and may not\n * handle all edge cases of complex TypeScript parameter declarations.\n *\n * @param func - The function to extract parameter names from\n * @returns An array of parameter names, or an empty array if extraction fails\n * @throws {TypeError} If the input is not a function\n *\n * @example\n * ```typescript\n * function example(a, b, c) {}\n * const paramNames = getParameterNames(example);\n * // Returns: ['a', 'b', 'c']\n *\n * const arrowFunc = (x, y) => x + y;\n * const arrowParamNames = getParameterNames(arrowFunc);\n * // Returns: ['x', 'y']\n *\n * function complex(param1: string, param2: number = 10, ...rest: any[]) {}\n * const complexParamNames = getParameterNames(complex);\n * // Returns: ['param1', 'param2', '...rest']\n * ```\n */\nexport function getParameterNames(func: (...args: any[]) => any): string[] {\n  // Validate that the input is a function\n  if (typeof func !== 'function') {\n    throw new TypeError('Expected a function');\n  }\n\n  // Check cache first to improve performance\n  if (parameterNameCache.has(func)) {\n    return parameterNameCache.get(func)!;\n  }\n\n  try {\n    // Convert function to string and trim whitespace\n    const fnStr = func.toString().trim();\n\n    // Extract parameter string from the function\n    const paramsStr = extractParameterString(fnStr);\n\n    // Handle empty parameters\n    if (!hasParameters(paramsStr)) {\n      const emptyResult: string[] = [];\n      parameterNameCache.set(func, emptyResult);\n      return emptyResult;\n    }\n\n    // Parse and clean parameter names\n    const result = parseParameterNames(paramsStr);\n    parameterNameCache.set(func, result);\n    return result;\n  } catch {\n    // Return empty array on any parsing errors to avoid breaking the application\n    const errorResult: string[] = [];\n    parameterNameCache.set(func, errorResult);\n    return errorResult;\n  }\n}\n\n/**\n * Helper function to automatically extract parameter name when not provided.\n *\n * @param target - The target object (class prototype)\n * @param propertyKey - The method name\n * @param parameterIndex - The index of the parameter\n * @param providedName - The name explicitly provided by the user (if any)\n * @returns The parameter name, either provided or automatically extracted\n */\nexport function getParameterName(\n  target: object,\n  propertyKey: string | symbol,\n  parameterIndex: number,\n  providedName?: string,\n): string | undefined {\n  // If a name was explicitly provided, use it\n  if (providedName) {\n    return providedName;\n  }\n\n  // Try to automatically extract the parameter name\n  try {\n    const method = target[propertyKey as keyof typeof target];\n    if (method && typeof method === 'function') {\n      const paramNames = getParameterNames(method);\n      if (parameterIndex < paramNames.length) {\n        return paramNames[parameterIndex];\n      }\n    }\n  } catch {\n    // If we can't get the parameter name, return undefined\n    // This will use default naming in the execution logic\n  }\n\n  return undefined;\n}\n\n/**\n * Checks if a parameter string contains actual parameters.\n *\n * @param paramsStr - The parameter string to check\n * @returns True if the string contains parameters, false otherwise\n */\nfunction hasParameters(paramsStr: string): boolean {\n  return (\n    paramsStr !== null && paramsStr !== undefined && paramsStr.trim() !== ''\n  );\n}\n\n/**\n * Extracts the parameter string from a function string representation.\n *\n * @param fnStr - The string representation of the function\n * @returns The parameter string, or empty string if not found\n */\nfunction extractParameterString(fnStr: string): string {\n  // Handle arrow functions that start with parentheses\n  if (fnStr.startsWith('(')) {\n    const endParenIndex = findClosingParenthesis(fnStr, 0);\n    if (endParenIndex === -1) return '';\n    return fnStr.substring(1, endParenIndex);\n  }\n\n  // Handle regular functions, async functions, and methods\n  const startParenIndex = fnStr.indexOf('(');\n  if (startParenIndex === -1) return '';\n\n  const endParenIndex = findClosingParenthesis(fnStr, startParenIndex);\n  if (endParenIndex === -1) return '';\n\n  return fnStr.substring(startParenIndex + 1, endParenIndex);\n}\n\n/**\n * Finds the matching closing parenthesis for an opening parenthesis.\n *\n * @param str - The string to search in\n * @param openingParenIndex - The index of the opening parenthesis\n * @returns The index of the matching closing parenthesis, or -1 if not found\n */\nfunction findClosingParenthesis(\n  str: string,\n  openingParenIndex: number,\n): number {\n  let parenDepth = 1;\n\n  for (let i = openingParenIndex + 1; i < str.length; i++) {\n    const char = str[i];\n\n    if (char === '(') {\n      parenDepth++;\n    } else if (char === ')') {\n      parenDepth--;\n      if (parenDepth === 0) {\n        return i;\n      }\n    }\n  }\n\n  return -1; // No matching closing parenthesis found\n}\n\n/**\n * Parses and cleans parameter names from a parameter string.\n *\n * @param paramsStr - The parameter string to parse\n * @returns An array of cleaned parameter names\n */\nfunction parseParameterNames(paramsStr: string): string[] {\n  return paramsStr\n    .split(',')\n    .map(trimWhitespace)\n    .filter(isNotEmpty)\n    .map(extractParameterName);\n}\n\n/**\n * Trims whitespace from a string.\n *\n * @param str - The string to trim\n * @returns The trimmed string\n */\nfunction trimWhitespace(str: string): string {\n  return str.trim();\n}\n\n/**\n * Checks if a string is not empty.\n *\n * @param str - The string to check\n * @returns True if the string is not empty, false otherwise\n */\nfunction isNotEmpty(str: string): boolean {\n  return str.length > 0;\n}\n\n/**\n * Extracts a clean parameter name by removing type annotations and default values.\n *\n * @param param - The raw parameter string\n * @returns The cleaned parameter name\n */\nfunction extractParameterName(param: string): string {\n  // Remove default value assignment (everything after =)\n  let cleanedParam = removeDefaultValue(param);\n\n  // Remove type annotations (everything after :)\n  cleanedParam = removeTypeAnnotation(cleanedParam);\n\n  return cleanedParam.trim();\n}\n\n/**\n * Removes default value from a parameter string.\n *\n * @param param - The parameter string\n * @returns The parameter string without default value\n */\nfunction removeDefaultValue(param: string): string {\n  const equalsIndex = param.indexOf('=');\n  if (equalsIndex !== -1) {\n    return param.substring(0, equalsIndex);\n  }\n  return param;\n}\n\n/**\n * Removes type annotation from a parameter string.\n *\n * @param param - The parameter string\n * @returns The parameter string without type annotation\n */\nfunction removeTypeAnnotation(param: string): string {\n  const colonIndex = param.indexOf(':');\n  if (colonIndex !== -1) {\n    return param.substring(0, colonIndex);\n  }\n  return param;\n}\n","import { getParameterName } from './reflection';\nimport 'reflect-metadata';\nimport { type PathCapable } from './endpointDecorator';\nimport { type FetchRequestInit } from '@ahoo-wang/fetcher';\n\n/**\n * Parameter types for decorator parameters.\n *\n * Defines the different types of parameters that can be used\n * in API method decorators to specify how arguments should be handled\n * in the HTTP request.\n */\nexport enum ParameterType {\n  /**\n   * Path parameter that will be inserted into the URL path.\n   *\n   * Path parameters are used to specify dynamic parts of the URL path.\n   * They are defined using curly braces in the endpoint path.\n   *\n   * @example\n   * ```typescript\n   * @get('/users/{id}')\n   * getUser(@path('id') userId: string): Promise<Response>\n   * ```\n   */\n  PATH = 'path',\n\n  /**\n   * Query parameter that will be appended to the URL query string.\n   *\n   * Query parameters are used to pass non-hierarchical data to the server.\n   * They appear after the '?' in the URL.\n   *\n   * @example\n   * ```typescript\n   * @get('/users')\n   * getUsers(@query('limit') limit: number): Promise<Response>\n   * ```\n   */\n  QUERY = 'query',\n\n  /**\n   * Header parameter that will be added to the request headers.\n   *\n   * Header parameters are used to pass metadata about the request,\n   * such as authentication tokens or content type information.\n   *\n   * @example\n   * ```typescript\n   * @get('/users')\n   * getUsers(@header('Authorization') token: string): Promise<Response>\n   * ```\n   */\n  HEADER = 'header',\n\n  /**\n   * Body parameter that will be sent as the request body.\n   *\n   * The body parameter represents the main data payload of the request.\n   * It is typically used with POST, PUT, and PATCH requests.\n   *\n   * @example\n   * ```typescript\n   * @post('/users')\n   * createUser(@body() user: User): Promise<Response>\n   * ```\n   */\n  BODY = 'body',\n\n  /**\n   * Request parameter that will be used as the request object.\n   */\n  REQUEST = 'request',\n\n\n  /**\n   * Attribute parameter that will be used as a single attribute in the request attributes.\n   *\n   * The attribute parameter allows passing a single key-value pair that will be added\n   * to the request attributes object. This is useful for passing specific contextual\n   * information that can be accessed by interceptors.\n   */\n  ATTRIBUTE = 'attribute',\n  /**\n   * Attributes parameter that will be used as the request attributes.\n   *\n   * The attributes parameter allows passing custom data that can be accessed\n   * by interceptors throughout the request lifecycle. This is useful for\n   * sharing contextual information between different parts of the request processing.\n   */\n  ATTRIBUTES = 'attributes'\n}\n\n/**\n * Metadata for method parameters.\n *\n * Defines the metadata stored for each parameter\n * decorated with @path, @query, @header, or @body decorators.\n */\nexport interface ParameterMetadata {\n  /**\n   * Type of parameter (path, query, header, body).\n   *\n   * Specifies how this parameter should be handled in the HTTP request.\n   */\n  type: ParameterType;\n\n  /**\n   * Name of the parameter (used for path, query, and header parameters).\n   *\n   * For path and query parameters, this corresponds to the key in the URL.\n   * For header parameters, this corresponds to the header name.\n   * For body parameters, this is not used.\n   */\n  name?: string;\n\n  /**\n   * Index of the parameter in the method signature.\n   *\n   * This is used to map the runtime argument values to the correct parameter metadata.\n   */\n  index: number;\n}\n\nexport const PARAMETER_METADATA_KEY = Symbol('parameter:metadata');\n\n/**\n * Decorator factory for method parameters.\n *\n * Creates a decorator that can be used to specify how a method parameter\n * should be handled in the HTTP request. It stores metadata about the parameter\n * that will be used during request execution.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param type - The type of parameter (PATH, QUERY, HEADER, or BODY)\n * @param name - The name of the parameter (used for path, query, and header parameters, optional - auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users/{id}')\n * getUser(@parameter(ParameterType.PATH, 'id') userId: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users/{userId}')\n * getUser(@parameter(ParameterType.PATH) userId: string): Promise<Response>\n * ```\n */\nexport function parameter(type: ParameterType, name: string = '') {\n  return function(\n    target: object,\n    propertyKey: string | symbol,\n    parameterIndex: number,\n  ) {\n    const paramName = getParameterName(\n      target,\n      propertyKey as string,\n      parameterIndex,\n      name,\n    );\n\n    const existingParameters: Map<number, ParameterMetadata> =\n      Reflect.getMetadata(PARAMETER_METADATA_KEY, target, propertyKey) ||\n      new Map();\n    const parameterMetadata: ParameterMetadata = {\n      type: type,\n      name: paramName,\n      index: parameterIndex,\n    };\n    existingParameters.set(parameterIndex, parameterMetadata);\n    Reflect.defineMetadata(\n      PARAMETER_METADATA_KEY,\n      existingParameters,\n      target,\n      propertyKey,\n    );\n  };\n}\n\n/**\n * Path parameter decorator.\n *\n * Defines a path parameter that will be inserted into the URL path.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the path parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users/{id}')\n * getUser(@path('id') userId: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users/{userId}')\n * getUser(@path() userId: string): Promise<Response>\n * ```\n */\nexport function path(name: string = '') {\n  return parameter(ParameterType.PATH, name);\n}\n\n/**\n * Query parameter decorator.\n *\n * Defines a query parameter that will be appended to the URL query string.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the query parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users')\n * getUsers(@query('limit') limit: number): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users')\n * getUsers(@query() limit: number): Promise<Response>\n * ```\n */\nexport function query(name: string = '') {\n  return parameter(ParameterType.QUERY, name);\n}\n\n/**\n * Header parameter decorator.\n *\n * Defines a header parameter that will be added to the request headers.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the header parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users')\n * getUsers(@header('Authorization') token: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users')\n * getUsers(@header() authorization: string): Promise<Response>\n * ```\n */\nexport function header(name: string = '') {\n  return parameter(ParameterType.HEADER, name);\n}\n\n/**\n * Body parameter decorator.\n *\n * Defines a body parameter that will be sent as the request body.\n * Note that body parameters don't have names since there's only one body per request.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @post('/users')\n * createUser(@body() user: User): Promise<Response>\n * ```\n */\nexport function body() {\n  return parameter(ParameterType.BODY);\n}\n\n/**\n * Interface for request parameter objects.\n *\n * Combines FetchRequestInit and PathCapable interfaces to provide\n * a complete request configuration object that can be used with\n * the @request() decorator. This allows full customization of\n * the HTTP request including method, headers, body, and URL parameters.\n */\nexport interface ParameterRequest extends FetchRequestInit, PathCapable {\n}\n\n/**\n * Request parameter decorator.\n *\n * Defines a request parameter that will be used as the base request object.\n * This allows you to pass a complete ParameterRequest object to customize\n * the request configuration.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @post('/users')\n * createUsers(@request() request: ParameterRequest): Promise<Response>\n * ```\n */\nexport function request() {\n  return parameter(ParameterType.REQUEST);\n}\n\n/**\n * Parameter decorator for adding a single attribute to the request attributes.\n *\n * This decorator allows you to pass a key-value pair as an attribute that can be accessed\n * by interceptors during the request lifecycle. If no name is provided, the parameter's\n * property name will be used as the attribute key.\n *\n * @param name - Optional name for the attribute. If not provided, the parameter's property name will be used.\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attribute('userId') userId: string): Promise<Response>\n *\n * // Using property name as attribute key\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attribute() userId: string): Promise<Response>\n * ```\n */\nexport function attribute(name: string = '') {\n  return parameter(ParameterType.ATTRIBUTE, name);\n}\n\n/**\n * Parameter decorator for adding multiple attributes to the request.\n *\n * This decorator allows you to pass an entire object as attributes that can be accessed\n * by interceptors during the request lifecycle. The parameter should be an object whose\n * properties will be merged into the request attributes.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attributes() attrs: Record<string, any>): Promise<Response>\n * ```\n */\nexport function attributes() {\n  return parameter(ParameterType.ATTRIBUTES);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Fetcher, fetcherRegistrar } from '@ahoo-wang/fetcher';\n\n/**\n * Interface that defines a capability for objects that can have a fetcher.\n * This interface is typically used to mark components or objects that can perform fetching operations\n * and may need access to fetcher functionality.\n */\nexport interface FetcherCapable {\n  /**\n   * Optional fetcher property that can be either a string identifier or a Fetcher instance.\n   * When present, this property indicates the fetcher associated with the implementing object.\n   */\n  fetcher?: string | Fetcher;\n}\n\n/**\n * Gets a Fetcher instance based on the provided fetcher parameter.\n *\n * @param fetcher - A string identifier or Fetcher instance to resolve\n * @returns A Fetcher instance if found, undefined otherwise\n */\nexport function getFetcher(fetcher?: string | Fetcher): Fetcher | undefined {\n  // Return undefined if no fetcher is provided\n  if (!fetcher) {\n    return undefined;\n  }\n\n  // Return the fetcher directly if it's already a Fetcher instance,\n  // otherwise resolve it through the fetcher registrar\n  return fetcher instanceof Fetcher\n    ? fetcher\n    : fetcherRegistrar.requiredGet(fetcher);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  ExchangeResultExtractor,\n  JsonResultExtractor,\n  ResponseResultExtractor,\n  ResultExtractor,\n  TextResultExtractor,\n} from '@ahoo-wang/fetcher';\nimport {\n  EventStreamResultExtractor,\n  JsonEventStreamResultExtractor,\n} from '@ahoo-wang/fetcher-eventstream';\n\n/**\n * Interface with result extractor capability\n * Defines an optional resultExtractor property\n */\nexport interface ResultExtractorCapable {\n  resultExtractor?: ResultExtractor<any>;\n}\n\n/**\n * ResultExtractors is an object that maps result extractor names to their corresponding\n * extractor functions. These extractors are used to process and extract data from different\n * types of responses or results in the application.\n *\n * Each property represents a specific type of result extractor:\n * - Exchange: Handles exchange-related result extraction\n * - Response: Handles general response result extraction\n * - Json: Handles JSON format result extraction\n * - Text: Handles plain text result extraction\n * - EventStream: Handles server-sent event stream result extraction\n * - JsonEventStream: Handles JSON server-sent event stream result extraction\n */\nexport const ResultExtractors = {\n  Exchange: ExchangeResultExtractor,\n  Response: ResponseResultExtractor,\n  Json: JsonResultExtractor,\n  Text: TextResultExtractor,\n  EventStream: EventStreamResultExtractor,\n  JsonEventStream: JsonEventStreamResultExtractor,\n  DEFAULT: JsonResultExtractor,\n};\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  combineURLs,\n  Fetcher, fetcher,\n  type FetchExchangeInit,\n  FetchRequestInit,\n  mergeRequest,\n  NamedCapable,\n  type RequestHeaders,\n  ResultExtractor,\n  type UrlParams,\n} from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport { EndpointMetadata } from './endpointDecorator';\nimport { ParameterMetadata, ParameterRequest, ParameterType } from './parameterDecorator';\nimport { getFetcher } from './fetcherCapable';\nimport { ResultExtractors } from './resultExtractor';\n\n/**\n * Metadata container for a function with HTTP endpoint decorators.\n *\n * Encapsulates all the metadata needed to execute an HTTP request\n * for a decorated method, including API-level defaults, endpoint-specific\n * configuration, and parameter metadata.\n */\nexport class FunctionMetadata implements NamedCapable {\n  /**\n   * Name of the function.\n   */\n  name: string;\n\n  /**\n   * API-level metadata (class-level configuration).\n   */\n  api: ApiMetadata;\n\n  /**\n   * Endpoint-level metadata (method-level configuration).\n   */\n  endpoint: EndpointMetadata;\n\n  /**\n   * Metadata for method parameters.\n   *\n   * Defines the metadata stored for each parameter decorated with @path, @query,\n   * @header, or @body decorators. Stored as a Map keyed by parameter index.\n   *\n   * @remarks\n   * The metadata is stored as a Map<number, ParameterMetadata> where the key is\n   * the parameter index and the value is the parameter metadata. This ensures\n   * correct parameter ordering regardless of decorator application order.\n   */\n  parameters: Map<number, ParameterMetadata>;\n\n  /**\n   * Creates a new FunctionMetadata instance.\n   *\n   * @param name - The name of the function\n   * @param api - API-level metadata\n   * @param endpoint - Endpoint-level metadata\n   * @param parameters - Parameter metadata array\n   */\n  constructor(\n    name: string,\n    api: ApiMetadata,\n    endpoint: EndpointMetadata,\n    parameters: Map<number, ParameterMetadata>,\n  ) {\n    this.name = name;\n    this.api = api;\n    this.endpoint = endpoint;\n    this.parameters = parameters;\n  }\n\n  /**\n   * Gets the fetcher instance to use for this function.\n   *\n   * Returns the fetcher specified in the endpoint metadata, or the API metadata,\n   * or falls back to the default fetcher if none is specified.\n   *\n   * @returns The fetcher instance\n   */\n  get fetcher(): Fetcher {\n    return getFetcher(this.endpoint.fetcher ?? this.api.fetcher) ?? fetcher;\n  }\n\n  /**\n   * Resolves the complete path by combining base path and endpoint path\n   *\n   * @param parameterPath - Optional path parameter to use instead of endpoint path\n   * @returns The combined URL path\n   */\n  resolvePath(parameterPath?: string): string {\n    // Get the base path from endpoint, API, or default to empty string\n    const basePath = this.endpoint.basePath || this.api.basePath || '';\n\n    // Use provided parameter path or fallback to endpoint path\n    const endpointPath = parameterPath || this.endpoint.path || '';\n\n    // Combine the base path and endpoint path into a complete URL\n    return combineURLs(basePath, endpointPath);\n  }\n\n  /**\n   * Resolves the timeout for the request.\n   *\n   * Returns the timeout specified in the endpoint metadata, or the API metadata,\n   * or undefined if no timeout is specified.\n   *\n   * @returns The timeout value in milliseconds, or undefined\n   */\n  resolveTimeout(): number | undefined {\n    return this.endpoint.timeout || this.api.timeout;\n  }\n\n  resolveResultExtractor(): ResultExtractor<any> {\n    return (\n      this.endpoint.resultExtractor ||\n      this.api.resultExtractor ||\n      ResultExtractors.DEFAULT\n    );\n  }\n\n  resolveAttributes(): Record<string, any> {\n    return {\n      ...this.api.attributes,\n      ...this.endpoint.attributes,\n    };\n  }\n\n  /**\n   * Resolves the request configuration from the method arguments.\n   *\n   * This method processes the runtime arguments according to the parameter metadata\n   * and constructs a FetcherRequest object with path parameters, query parameters,\n   * headers, body, and timeout. It handles various parameter types including:\n   * - Path parameters (@path decorator)\n   * - Query parameters (@query decorator)\n   * - Header parameters (@header decorator)\n   * - Body parameter (@body decorator)\n   * - Complete request object (@request decorator)\n   * - AbortSignal for request cancellation\n   *\n   * The method uses mergeRequest to combine the endpoint-specific configuration\n   * with the parameter-provided request object, where the parameter request\n   * takes precedence over endpoint configuration.\n   *\n   * @param args - The runtime arguments passed to the method\n   * @returns A FetcherRequest object with all request configuration\n   *\n   * @example\n   * ```typescript\n   * // For a method decorated like:\n   * @get('/users/{id}')\n   * getUser(\n   *   @path('id') id: number,\n   *   @query('include') include: string,\n   *   @header('Authorization') auth: string\n   * ): Promise<Response>\n   *\n   * // Calling with: getUser(123, 'profile', 'Bearer token')\n   * // Would produce a request with:\n   * // {\n   * //   method: 'GET',\n   * //   urlParams: {\n   * //     path: { id: 123 },\n   * //     query: { include: 'profile' }\n   * //   },\n   * //   headers: {\n   * //     'Authorization': 'Bearer token',\n   * //     ...apiHeaders,\n   * //     ...endpointHeaders\n   * //   }\n   * // }\n   * ```\n   */\n  resolveExchangeInit(args: any[]): Required<Pick<FetchExchangeInit, 'request' | 'attributes'>> {\n    const pathParams: Record<string, any> = {};\n    const queryParams: Record<string, any> = {};\n    const headers: RequestHeaders = {\n      ...this.api.headers,\n      ...this.endpoint.headers,\n    };\n    let body: any = undefined;\n    let signal: AbortSignal | null | undefined = undefined;\n    let abortController: AbortController | null | undefined = undefined;\n    let parameterRequest: ParameterRequest = {};\n    const attributes: Record<string, any> = this.resolveAttributes();\n    // Process parameters based on their decorators\n    args.forEach((value, index) => {\n      if (value instanceof AbortSignal) {\n        signal = value;\n        return;\n      }\n      if (value instanceof AbortController) {\n        abortController = value;\n        return;\n      }\n      const funParameter = this.parameters.get(index);\n      if (!funParameter) {\n        return;\n      }\n      switch (funParameter.type) {\n        case ParameterType.PATH:\n          this.processPathParam(funParameter, value, pathParams);\n          break;\n        case ParameterType.QUERY:\n          this.processQueryParam(funParameter, value, queryParams);\n          break;\n        case ParameterType.HEADER:\n          this.processHeaderParam(funParameter, value, headers);\n          break;\n        case ParameterType.BODY:\n          body = value;\n          break;\n        case ParameterType.REQUEST:\n          parameterRequest = this.processRequestParam(value);\n          break;\n        case ParameterType.ATTRIBUTE:\n          this.processAttributeParam(funParameter, value, attributes);\n          break;\n        case ParameterType.ATTRIBUTES:\n          this.processAttributesParam(value, attributes);\n          break;\n      }\n    });\n    const urlParams: UrlParams = {\n      path: pathParams,\n      query: queryParams,\n    };\n    const endpointRequest: FetchRequestInit = {\n      method: this.endpoint.method,\n      urlParams,\n      headers,\n      body,\n      timeout: this.resolveTimeout(),\n      signal,\n      abortController,\n    };\n    const mergedRequest = mergeRequest(\n      endpointRequest,\n      parameterRequest,\n    ) as any;\n    const parameterPath = parameterRequest.path;\n    mergedRequest.url = this.resolvePath(parameterPath);\n    return {\n      request: mergedRequest,\n      attributes,\n    };\n  }\n\n  private processPathParam(\n    param: ParameterMetadata,\n    value: any,\n    path: Record<string, any>,\n  ) {\n    const paramName = param.name || `param${param.index}`;\n    path[paramName] = value;\n  }\n\n  private processQueryParam(\n    param: ParameterMetadata,\n    value: any,\n    query: Record<string, any>,\n  ) {\n    const paramName = param.name || `param${param.index}`;\n    query[paramName] = value;\n  }\n\n  private processHeaderParam(\n    param: ParameterMetadata,\n    value: any,\n    headers: RequestHeaders,\n  ) {\n    if (param.name && value !== undefined) {\n      headers[param.name] = String(value);\n    }\n  }\n\n  /**\n   * Processes a request parameter value.\n   *\n   * This method handles the @request() decorator parameter by casting\n   * the provided value to a FetcherRequest. The @request() decorator\n   * allows users to pass a complete FetcherRequest object to customize\n   * the request configuration.\n   *\n   * @param value - The value provided for the @request() parameter\n   * @returns The value cast to FetcherRequest type\n   *\n   * @example\n   * ```typescript\n   * @post('/users')\n   * createUsers(@request() request: FetcherRequest): Promise<Response>\n   *\n   * // Usage:\n   * const customRequest: FetcherRequest = {\n   *   headers: { 'X-Custom': 'value' },\n   *   timeout: 5000\n   * };\n   * await service.createUsers(customRequest);\n   * ```\n   */\n  private processRequestParam(value: any): ParameterRequest {\n    if (!value) {\n      return {};\n    }\n\n    const request = value as ParameterRequest;\n    // 确保请求对象中的属性被正确保留\n    return {\n      ...request,\n      headers: request.headers || {},\n      urlParams: request.urlParams || { path: {}, query: {} },\n    };\n  }\n\n\n  private processAttributeParam(\n    param: ParameterMetadata,\n    value: any,\n    attributes: Record<string, any>,\n  ) {\n    if (param.name && value !== undefined) {\n      attributes[param.name] = value;\n    }\n  }\n\n  private processAttributesParam(\n    value: any,\n    attributes: Record<string, any>,\n  ) {\n    if (typeof value !== 'object') {\n      throw new Error('@attributes() parameter must be an object');\n    }\n    Object.keys(value).forEach(key => {\n      attributes[key] = value[key];\n    });\n  }\n\n}","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  type AttributesCapable,\n  Fetcher,\n  type RequestHeaders,\n  type RequestHeadersCapable,\n  type TimeoutCapable,\n} from '@ahoo-wang/fetcher';\nimport { ENDPOINT_METADATA_KEY } from './endpointDecorator';\nimport { RequestExecutor } from './requestExecutor';\nimport { PARAMETER_METADATA_KEY } from './parameterDecorator';\nimport 'reflect-metadata';\nimport { type ResultExtractorCapable } from './resultExtractor';\nimport { type FetcherCapable } from './fetcherCapable';\nimport { FunctionMetadata } from './functionMetadata';\n\n/**\n * Metadata for class-level API configuration.\n *\n * Defines the configuration options that can be applied to an entire API class.\n * These settings will be used as defaults for all endpoints within the class unless overridden\n * at the method level.\n */\nexport interface ApiMetadata\n  extends TimeoutCapable,\n    RequestHeadersCapable,\n    ResultExtractorCapable,\n    FetcherCapable, AttributesCapable {\n  /**\n   * Base path for all endpoints in the class.\n   *\n   * This path will be prepended to all endpoint paths defined in the class.\n   * For example, if basePath is '/api/v1' and an endpoint has path '/users',\n   * the full path will be '/api/v1/users'.\n   */\n  basePath?: string;\n\n  /**\n   * Default headers for all requests in the class.\n   *\n   * These headers will be included in every request made by methods in this class.\n   * They can be overridden or extended at the method level.\n   */\n  headers?: RequestHeaders;\n\n  /**\n   * Default timeout for all requests in the class (in milliseconds).\n   *\n   * This timeout value will be applied to all requests made by methods in this class.\n   * Individual methods can specify their own timeout values to override this default.\n   */\n  timeout?: number;\n\n  /**\n   * Name of the fetcher instance to use, default: 'default'.\n   *\n   * This allows you to specify which fetcher instance should be used for requests\n   * from this API class. The fetcher must be registered with the FetcherRegistrar.\n   */\n  fetcher?: string | Fetcher;\n}\n\nexport const API_METADATA_KEY = Symbol('api:metadata');\n\n/**\n * Binds a request executor to a method, replacing the original method with\n * an implementation that makes HTTP requests based on the decorator metadata.\n *\n * @param constructor - The class constructor\n * @param functionName - The name of the method to bind\n * @param apiMetadata - The API metadata for the class\n */\nfunction bindExecutor<T extends new (...args: any[]) => any>(\n  constructor: T,\n  functionName: string,\n  apiMetadata: ApiMetadata,\n) {\n  const endpointFunction = constructor.prototype[functionName];\n  if (functionName === 'constructor') {\n    return;\n  }\n  if (typeof endpointFunction !== 'function') {\n    return;\n  }\n\n  const endpointMetadata = Reflect.getMetadata(\n    ENDPOINT_METADATA_KEY,\n    constructor.prototype,\n    functionName,\n  );\n  if (!endpointMetadata) {\n    return;\n  }\n  // Get parameter metadata for this method\n  const parameterMetadata =\n    Reflect.getMetadata(\n      PARAMETER_METADATA_KEY,\n      constructor.prototype,\n      functionName,\n    ) || new Map();\n\n  // Create function metadata\n  const functionMetadata = new FunctionMetadata(\n    functionName,\n    apiMetadata,\n    endpointMetadata,\n    parameterMetadata,\n  );\n\n  // Create request executor\n  const requestExecutor = new RequestExecutor(functionMetadata);\n\n  // Replace method with actual implementation\n  constructor.prototype[functionName] = function(...args: unknown[]) {\n    return requestExecutor.execute(this, args);\n  };\n}\n\nexport function api(\n  basePath: string = '',\n  metadata: Omit<ApiMetadata, 'basePath'> = {},\n) {\n  return function <T extends new (...args: any[]) => any>(constructor: T): T {\n    const apiMetadata: ApiMetadata = {\n      basePath,\n      ...metadata,\n    };\n\n    // Store metadata directly on the class constructor\n    Reflect.defineMetadata(API_METADATA_KEY, apiMetadata, constructor);\n\n    // Override prototype methods to implement actual HTTP calls\n    Object.getOwnPropertyNames(constructor.prototype).forEach(functionName => {\n      bindExecutor(constructor, functionName, apiMetadata);\n    });\n\n    return constructor;\n  };\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Custom error class that indicates a method implementation will be automatically generated.\n *\n * @example\n * ```\n *     @post()\n *     createUser(@body() user: User):Promise<Response> {\n *         throw autoGeneratedError(user);\n *     }\n * ```\n */\nexport class AutoGenerated extends Error {\n  constructor() {\n    super('Implementation will be generated automatically.');\n    this.name = 'AutoGenerated';\n  }\n}\n\n/**\n * Factory function that creates an AutoGenerated error instance.\n * This is typically used in methods that will be automatically implemented,\n * where a placeholder implementation is needed.\n *\n * @param _ignored - Arguments (such as 'user' in the example) are ignored to prevent\n *                   ESLint no-unused-vars errors in method signatures that will be auto-generated.\n * @returns A new AutoGenerated error instance\n */\nexport const autoGeneratedError = (..._ignored: any[]): AutoGenerated => {\n  return new AutoGenerated();\n};\n"],"names":["ENDPOINT_METADATA_KEY","endpoint","method","path","metadata","target","propertyKey","endpointMetadata","get","HttpMethod","post","put","del","patch","head","options","TARGET_FETCHER_PROPERTY","DECORATOR_TARGET_ATTRIBUTE_KEY","RequestExecutor","fetcher","Fetcher","args","exchangeInit","extractor","parameterNameCache","getParameterNames","func","fnStr","paramsStr","extractParameterString","hasParameters","emptyResult","result","parseParameterNames","errorResult","getParameterName","parameterIndex","providedName","paramNames","endParenIndex","findClosingParenthesis","startParenIndex","str","openingParenIndex","parenDepth","i","char","trimWhitespace","isNotEmpty","extractParameterName","param","cleanedParam","removeDefaultValue","removeTypeAnnotation","equalsIndex","colonIndex","ParameterType","PARAMETER_METADATA_KEY","parameter","type","name","paramName","existingParameters","parameterMetadata","query","header","body","request","attribute","attributes","getFetcher","fetcherRegistrar","ResultExtractors","ExchangeResultExtractor","ResponseResultExtractor","JsonResultExtractor","TextResultExtractor","EventStreamResultExtractor","JsonEventStreamResultExtractor","FunctionMetadata","api","parameters","parameterPath","basePath","endpointPath","combineURLs","pathParams","queryParams","headers","signal","abortController","parameterRequest","value","index","funParameter","urlParams","endpointRequest","mergedRequest","mergeRequest","key","API_METADATA_KEY","bindExecutor","constructor","functionName","apiMetadata","endpointFunction","functionMetadata","requestExecutor","AutoGenerated","autoGeneratedError","_ignored"],"mappings":"kdAiCO,MAAMA,EAAwB,OAAO,mBAAmB,EA4BxD,SAASC,EACdC,EACAC,EACAC,EAAmC,CAAA,EACnC,CACA,OAAO,SAASC,EAAgBC,EAAoC,CAElE,MAAMC,EAAmB,CACvB,OAAAL,EACA,KAAAC,EACA,GAAGC,CAAA,EAEL,QAAQ,eACNJ,EACAO,EACAF,EACAC,CAAA,CAEJ,CACF,CAEO,SAASE,EAAIL,EAAe,GAAIC,EAAmC,CAAA,EAAI,CAC5E,OAAOH,EAASQ,EAAAA,WAAW,IAAKN,EAAMC,CAAQ,CAChD,CAEO,SAASM,EAAKP,EAAe,GAAIC,EAAmC,CAAA,EAAI,CAC7E,OAAOH,EAASQ,EAAAA,WAAW,KAAMN,EAAMC,CAAQ,CACjD,CAEO,SAASO,EAAIR,EAAe,GAAIC,EAAmC,CAAA,EAAI,CAC5E,OAAOH,EAASQ,EAAAA,WAAW,IAAKN,EAAMC,CAAQ,CAChD,CAEO,SAASQ,EAAIT,EAAe,GAAIC,EAAmC,CAAA,EAAI,CAC5E,OAAOH,EAASQ,EAAAA,WAAW,OAAQN,EAAMC,CAAQ,CACnD,CAEO,SAASS,EACdV,EAAe,GACfC,EAAmC,CAAA,EACnC,CACA,OAAOH,EAASQ,EAAAA,WAAW,MAAON,EAAMC,CAAQ,CAClD,CAEO,SAASU,EAAKX,EAAe,GAAIC,EAAmC,CAAA,EAAI,CAC7E,OAAOH,EAASQ,EAAAA,WAAW,KAAMN,EAAMC,CAAQ,CACjD,CAEO,SAASW,EACdZ,EAAe,GACfC,EAAmC,CAAA,EACnC,CACA,OAAOH,EAASQ,EAAAA,WAAW,QAASN,EAAMC,CAAQ,CACpD,CCnGA,MAAMY,EAA0B,UAEnBC,EAAiC,uBASvC,MAAMC,CAAgB,CAQ3B,YAAYd,EAA4B,CACtC,KAAK,SAAWA,CAClB,CAQQ,iBAAiBC,EAAkC,CACzD,GAAI,CAACA,GAAU,OAAOA,GAAW,SAC/B,OAGF,MAAMc,EAAUd,EAAOW,CAAuB,EAG9C,GAAIG,aAAmBC,EAAAA,QACrB,OAAOD,CAKX,CAuCA,MAAM,QAAQd,EAAagB,EAA2B,CACpD,MAAMF,EAAU,KAAK,iBAAiBd,CAAM,GAAK,KAAK,SAAS,QACzDiB,EAAe,KAAK,SAAS,oBAAoBD,CAAI,EAC3DC,EAAa,WAAWL,CAA8B,EAAIZ,EAC1D,MAAMkB,EAAY,KAAK,SAAS,uBAAA,EAChC,OAAOJ,EAAQ,QAAQG,EAAa,QAASC,EAAWD,EAAa,UAAU,CACjF,CACF,CC1FA,MAAME,MAAyB,QA+BxB,SAASC,EAAkBC,EAAyC,CAEzE,GAAI,OAAOA,GAAS,WAClB,MAAM,IAAI,UAAU,qBAAqB,EAI3C,GAAIF,EAAmB,IAAIE,CAAI,EAC7B,OAAOF,EAAmB,IAAIE,CAAI,EAGpC,GAAI,CAEF,MAAMC,EAAQD,EAAK,SAAA,EAAW,KAAA,EAGxBE,EAAYC,EAAuBF,CAAK,EAG9C,GAAI,CAACG,EAAcF,CAAS,EAAG,CAC7B,MAAMG,EAAwB,CAAA,EAC9B,OAAAP,EAAmB,IAAIE,EAAMK,CAAW,EACjCA,CACT,CAGA,MAAMC,EAASC,EAAoBL,CAAS,EAC5C,OAAAJ,EAAmB,IAAIE,EAAMM,CAAM,EAC5BA,CACT,MAAQ,CAEN,MAAME,EAAwB,CAAA,EAC9B,OAAAV,EAAmB,IAAIE,EAAMQ,CAAW,EACjCA,CACT,CACF,CAWO,SAASC,EACd9B,EACAC,EACA8B,EACAC,EACoB,CAEpB,GAAIA,EACF,OAAOA,EAIT,GAAI,CACF,MAAMnC,EAASG,EAAOC,CAAkC,EACxD,GAAIJ,GAAU,OAAOA,GAAW,WAAY,CAC1C,MAAMoC,EAAab,EAAkBvB,CAAM,EAC3C,GAAIkC,EAAiBE,EAAW,OAC9B,OAAOA,EAAWF,CAAc,CAEpC,CACF,MAAQ,CAGR,CAGF,CAQA,SAASN,EAAcF,EAA4B,CACjD,OACEA,GAAc,MAAmCA,EAAU,SAAW,EAE1E,CAQA,SAASC,EAAuBF,EAAuB,CAErD,GAAIA,EAAM,WAAW,GAAG,EAAG,CACzB,MAAMY,EAAgBC,EAAuBb,EAAO,CAAC,EACrD,OAAIY,IAAkB,GAAW,GAC1BZ,EAAM,UAAU,EAAGY,CAAa,CACzC,CAGA,MAAME,EAAkBd,EAAM,QAAQ,GAAG,EACzC,GAAIc,IAAoB,GAAI,MAAO,GAEnC,MAAMF,EAAgBC,EAAuBb,EAAOc,CAAe,EACnE,OAAIF,IAAkB,GAAW,GAE1BZ,EAAM,UAAUc,EAAkB,EAAGF,CAAa,CAC3D,CASA,SAASC,EACPE,EACAC,EACQ,CACR,IAAIC,EAAa,EAEjB,QAASC,EAAIF,EAAoB,EAAGE,EAAIH,EAAI,OAAQG,IAAK,CACvD,MAAMC,EAAOJ,EAAIG,CAAC,EAElB,GAAIC,IAAS,IACXF,YACSE,IAAS,MAClBF,IACIA,IAAe,GACjB,OAAOC,CAGb,CAEA,MAAO,EACT,CAQA,SAASZ,EAAoBL,EAA6B,CACxD,OAAOA,EACJ,MAAM,GAAG,EACT,IAAImB,CAAc,EAClB,OAAOC,CAAU,EACjB,IAAIC,CAAoB,CAC7B,CAQA,SAASF,EAAeL,EAAqB,CAC3C,OAAOA,EAAI,KAAA,CACb,CAQA,SAASM,EAAWN,EAAsB,CACxC,OAAOA,EAAI,OAAS,CACtB,CAQA,SAASO,EAAqBC,EAAuB,CAEnD,IAAIC,EAAeC,EAAmBF,CAAK,EAG3C,OAAAC,EAAeE,EAAqBF,CAAY,EAEzCA,EAAa,KAAA,CACtB,CAQA,SAASC,EAAmBF,EAAuB,CACjD,MAAMI,EAAcJ,EAAM,QAAQ,GAAG,EACrC,OAAII,IAAgB,GACXJ,EAAM,UAAU,EAAGI,CAAW,EAEhCJ,CACT,CAQA,SAASG,EAAqBH,EAAuB,CACnD,MAAMK,EAAaL,EAAM,QAAQ,GAAG,EACpC,OAAIK,IAAe,GACVL,EAAM,UAAU,EAAGK,CAAU,EAE/BL,CACT,CCxPO,IAAKM,GAAAA,IAaVA,EAAA,KAAO,OAcPA,EAAA,MAAQ,QAcRA,EAAA,OAAS,SAcTA,EAAA,KAAO,OAKPA,EAAA,QAAU,UAUVA,EAAA,UAAY,YAQZA,EAAA,WAAa,aA9EHA,IAAAA,GAAA,CAAA,CAAA,EAgHL,MAAMC,EAAyB,OAAO,oBAAoB,EA0B1D,SAASC,EAAUC,EAAqBC,EAAe,GAAI,CAChE,OAAO,SACLvD,EACAC,EACA8B,EACA,CACA,MAAMyB,EAAY1B,EAChB9B,EACAC,EACA8B,EACAwB,CAAA,EAGIE,EACJ,QAAQ,YAAYL,EAAwBpD,EAAQC,CAAW,OAC3D,IACAyD,EAAuC,CAC3C,KAAAJ,EACA,KAAME,EACN,MAAOzB,CAAA,EAET0B,EAAmB,IAAI1B,EAAgB2B,CAAiB,EACxD,QAAQ,eACNN,EACAK,EACAzD,EACAC,CAAA,CAEJ,CACF,CAuBO,SAASH,EAAKyD,EAAe,GAAI,CACtC,OAAOF,EAAU,OAAoBE,CAAI,CAC3C,CAuBO,SAASI,EAAMJ,EAAe,GAAI,CACvC,OAAOF,EAAU,QAAqBE,CAAI,CAC5C,CAuBO,SAASK,EAAOL,EAAe,GAAI,CACxC,OAAOF,EAAU,SAAsBE,CAAI,CAC7C,CAgBO,SAASM,GAAO,CACrB,OAAOR,EAAU,MAAA,CACnB,CA4BO,SAASS,GAAU,CACxB,OAAOT,EAAU,SAAA,CACnB,CAsBO,SAASU,EAAUR,EAAe,GAAI,CAC3C,OAAOF,EAAU,YAAyBE,CAAI,CAChD,CAiBO,SAASS,IAAa,CAC3B,OAAOX,EAAU,YAAA,CACnB,CCvTO,SAASY,EAAWnD,EAAiD,CAE1E,GAAKA,EAML,OAAOA,aAAmBC,EAAAA,QACtBD,EACAoD,EAAAA,iBAAiB,YAAYpD,CAAO,CAC1C,CCCO,MAAMqD,EAAmB,CAC9B,SAAUC,EAAAA,wBACV,SAAUC,EAAAA,wBACV,KAAMC,EAAAA,oBACN,KAAMC,EAAAA,oBACN,YAAaC,EAAAA,2BACb,gBAAiBC,EAAAA,+BACjB,QAASH,EAAAA,mBACX,ECjBO,MAAMI,CAAyC,CAqCpD,YACEnB,EACAoB,EACA/E,EACAgF,EACA,CACA,KAAK,KAAOrB,EACZ,KAAK,IAAMoB,EACX,KAAK,SAAW/E,EAChB,KAAK,WAAagF,CACpB,CAUA,IAAI,SAAmB,CACrB,OAAOX,EAAW,KAAK,SAAS,SAAW,KAAK,IAAI,OAAO,GAAKnD,EAAAA,OAClE,CAQA,YAAY+D,EAAgC,CAE1C,MAAMC,EAAW,KAAK,SAAS,UAAY,KAAK,IAAI,UAAY,GAG1DC,EAAeF,GAAiB,KAAK,SAAS,MAAQ,GAG5D,OAAOG,EAAAA,YAAYF,EAAUC,CAAY,CAC3C,CAUA,gBAAqC,CACnC,OAAO,KAAK,SAAS,SAAW,KAAK,IAAI,OAC3C,CAEA,wBAA+C,CAC7C,OACE,KAAK,SAAS,iBACd,KAAK,IAAI,iBACTZ,EAAiB,OAErB,CAEA,mBAAyC,CACvC,MAAO,CACL,GAAG,KAAK,IAAI,WACZ,GAAG,KAAK,SAAS,UAAA,CAErB,CAgDA,oBAAoBnD,EAA0E,CAC5F,MAAMiE,EAAkC,CAAA,EAClCC,EAAmC,CAAA,EACnCC,EAA0B,CAC9B,GAAG,KAAK,IAAI,QACZ,GAAG,KAAK,SAAS,OAAA,EAEnB,IAAItB,EACAuB,EACAC,EACAC,EAAqC,CAAA,EACzC,MAAMtB,EAAkC,KAAK,kBAAA,EAE7ChD,EAAK,QAAQ,CAACuE,EAAOC,KAAU,CAC7B,GAAID,aAAiB,YAAa,CAChCH,EAASG,EACT,MACF,CACA,GAAIA,aAAiB,gBAAiB,CACpCF,EAAkBE,EAClB,MACF,CACA,MAAME,EAAe,KAAK,WAAW,IAAID,EAAK,EAC9C,GAAKC,EAGL,OAAQA,EAAa,KAAA,CACnB,KAAKtC,EAAc,KACjB,KAAK,iBAAiBsC,EAAcF,EAAON,CAAU,EACrD,MACF,KAAK9B,EAAc,MACjB,KAAK,kBAAkBsC,EAAcF,EAAOL,CAAW,EACvD,MACF,KAAK/B,EAAc,OACjB,KAAK,mBAAmBsC,EAAcF,EAAOJ,CAAO,EACpD,MACF,KAAKhC,EAAc,KACjBU,EAAO0B,EACP,MACF,KAAKpC,EAAc,QACjBmC,EAAmB,KAAK,oBAAoBC,CAAK,EACjD,MACF,KAAKpC,EAAc,UACjB,KAAK,sBAAsBsC,EAAcF,EAAOvB,CAAU,EAC1D,MACF,KAAKb,EAAc,WACjB,KAAK,uBAAuBoC,EAAOvB,CAAU,EAC7C,KAAA,CAEN,CAAC,EACD,MAAM0B,GAAuB,CAC3B,KAAMT,EACN,MAAOC,CAAA,EAEHS,GAAoC,CACxC,OAAQ,KAAK,SAAS,OACtB,UAAAD,GACA,QAAAP,EACA,KAAAtB,EACA,QAAS,KAAK,eAAA,EACd,OAAAuB,EACA,gBAAAC,CAAA,EAEIO,EAAgBC,EAAAA,aACpBF,GACAL,CAAA,EAEIT,GAAgBS,EAAiB,KACvC,OAAAM,EAAc,IAAM,KAAK,YAAYf,EAAa,EAC3C,CACL,QAASe,EACT,WAAA5B,CAAA,CAEJ,CAEQ,iBACNnB,EACA0C,EACAzF,EACA,CACA,MAAM0D,EAAYX,EAAM,MAAQ,QAAQA,EAAM,KAAK,GACnD/C,EAAK0D,CAAS,EAAI+B,CACpB,CAEQ,kBACN1C,EACA0C,EACA5B,EACA,CACA,MAAMH,EAAYX,EAAM,MAAQ,QAAQA,EAAM,KAAK,GACnDc,EAAMH,CAAS,EAAI+B,CACrB,CAEQ,mBACN1C,EACA0C,EACAJ,EACA,CACItC,EAAM,MAAQ0C,IAAU,SAC1BJ,EAAQtC,EAAM,IAAI,EAAI,OAAO0C,CAAK,EAEtC,CA0BQ,oBAAoBA,EAA8B,CACxD,GAAI,CAACA,EACH,MAAO,CAAA,EAGT,MAAMzB,EAAUyB,EAEhB,MAAO,CACL,GAAGzB,EACH,QAASA,EAAQ,SAAW,CAAA,EAC5B,UAAWA,EAAQ,WAAa,CAAE,KAAM,CAAA,EAAI,MAAO,CAAA,CAAC,CAAE,CAE1D,CAGQ,sBACNjB,EACA0C,EACAvB,EACA,CACInB,EAAM,MAAQ0C,IAAU,SAC1BvB,EAAWnB,EAAM,IAAI,EAAI0C,EAE7B,CAEQ,uBACNA,EACAvB,EACA,CACA,GAAI,OAAOuB,GAAU,SACnB,MAAM,IAAI,MAAM,2CAA2C,EAE7D,OAAO,KAAKA,CAAK,EAAE,QAAQO,GAAO,CAChC9B,EAAW8B,CAAG,EAAIP,EAAMO,CAAG,CAC7B,CAAC,CACH,CAEF,CCtRO,MAAMC,EAAmB,OAAO,cAAc,EAUrD,SAASC,GACPC,EACAC,EACAC,EACA,CACA,MAAMC,EAAmBH,EAAY,UAAUC,CAAY,EAI3D,GAHIA,IAAiB,eAGjB,OAAOE,GAAqB,WAC9B,OAGF,MAAMlG,EAAmB,QAAQ,YAC/BP,EACAsG,EAAY,UACZC,CAAA,EAEF,GAAI,CAAChG,EACH,OAGF,MAAMwD,EACJ,QAAQ,YACNN,EACA6C,EAAY,UACZC,CAAA,OACO,IAGLG,EAAmB,IAAI3B,EAC3BwB,EACAC,EACAjG,EACAwD,CAAA,EAII4C,EAAkB,IAAIzF,EAAgBwF,CAAgB,EAG5DJ,EAAY,UAAUC,CAAY,EAAI,YAAYlF,EAAiB,CACjE,OAAOsF,EAAgB,QAAQ,KAAMtF,CAAI,CAC3C,CACF,CAEO,SAAS2D,GACdG,EAAmB,GACnB/E,EAA0C,CAAA,EAC1C,CACA,OAAO,SAAiDkG,EAAmB,CACzE,MAAME,EAA2B,CAC/B,SAAArB,EACA,GAAG/E,CAAA,EAIL,eAAQ,eAAegG,EAAkBI,EAAaF,CAAW,EAGjE,OAAO,oBAAoBA,EAAY,SAAS,EAAE,QAAQC,GAAgB,CACxEF,GAAaC,EAAaC,EAAcC,CAAW,CACrD,CAAC,EAEMF,CACT,CACF,CC9HO,MAAMM,UAAsB,KAAM,CACvC,aAAc,CACZ,MAAM,iDAAiD,EACvD,KAAK,KAAO,eACd,CACF,CAWO,MAAMC,GAAqB,IAAIC,IAC7B,IAAIF"}
+{"version":3,"file":"index.umd.js","sources":["../src/endpointDecorator.ts","../src/requestExecutor.ts","../src/reflection.ts","../src/parameterDecorator.ts","../src/fetcherCapable.ts","../src/resultExtractor.ts","../src/functionMetadata.ts","../src/apiDecorator.ts","../src/generated.ts"],"sourcesContent":["import { HttpMethod, type ResultExtractorCapable } from '@ahoo-wang/fetcher';\nimport { type ApiMetadata } from './apiDecorator';\nimport 'reflect-metadata';\n\nexport interface PathCapable {\n  /**\n   * Path for the endpoint (relative to class base path).\n   *\n   * This path will be appended to the class's base path to form the complete URL.\n   * Path parameters can be specified using curly braces, e.g., '/users/{id}'\n   */\n  path?: string;\n}\n\n/**\n * Metadata for HTTP endpoints.\n *\n * Defines the configuration options for individual HTTP endpoints (methods).\n * These settings will override any corresponding class-level settings from ApiMetadata.\n */\nexport interface EndpointMetadata\n  extends ApiMetadata,\n    ResultExtractorCapable,\n    PathCapable {\n  /**\n   * HTTP method for the endpoint.\n   *\n   * Specifies the HTTP verb to be used for this endpoint (GET, POST, PUT, DELETE, etc.)\n   */\n  method?: HttpMethod;\n}\n\nexport const ENDPOINT_METADATA_KEY = Symbol('endpoint:metadata');\n\nexport type MethodEndpointMetadata = Omit<EndpointMetadata, 'method' | 'path'>;\n\n/**\n * Decorator factory for defining HTTP endpoints.\n *\n * Creates a decorator that can be used to define HTTP endpoints\n * on class methods. It stores metadata about the endpoint that will be used\n * to generate the actual HTTP request.\n *\n * @param method - The HTTP method for this endpoint\n * @param path - The path for this endpoint (relative to class base path)\n * @param metadata - Additional endpoint metadata (headers, timeout, etc.)\n * @returns A method decorator function\n *\n * @example\n * ```typescript\n * @api('/api/v1')\n * class UserService {\n *   @endpoint(HttpMethod.GET, '/users/{id}')\n *   getUser(@path('id') id: string): Promise<Response> {\n *     // Implementation will be generated automatically\n *     throw autoGeneratedError();\n *   }\n * }\n * ```\n */\nexport function endpoint(\n  method?: HttpMethod,\n  path?: string,\n  metadata: MethodEndpointMetadata = {},\n) {\n  return function(target: object, propertyKey: string | symbol): void {\n    // Store metadata directly on the method\n    const endpointMetadata = {\n      method: method,\n      path,\n      ...metadata,\n    };\n    Reflect.defineMetadata(\n      ENDPOINT_METADATA_KEY,\n      endpointMetadata,\n      target,\n      propertyKey,\n    );\n  };\n}\n\nexport function get(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.GET, path, metadata);\n}\n\nexport function post(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.POST, path, metadata);\n}\n\nexport function put(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.PUT, path, metadata);\n}\n\nexport function del(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.DELETE, path, metadata);\n}\n\nexport function patch(\n  path: string = '',\n  metadata: MethodEndpointMetadata = {},\n) {\n  return endpoint(HttpMethod.PATCH, path, metadata);\n}\n\nexport function head(path: string = '', metadata: MethodEndpointMetadata = {}) {\n  return endpoint(HttpMethod.HEAD, path, metadata);\n}\n\nexport function options(\n  path: string = '',\n  metadata: MethodEndpointMetadata = {},\n) {\n  return endpoint(HttpMethod.OPTIONS, path, metadata);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { Fetcher } from '@ahoo-wang/fetcher';\nimport { FunctionMetadata } from './functionMetadata';\n\nconst TARGET_FETCHER_PROPERTY = 'fetcher';\n\nexport const DECORATOR_TARGET_ATTRIBUTE_KEY = '__decorator_target__';\n\n/**\n * Executor for HTTP requests based on decorated method metadata.\n *\n * This class is responsible for executing HTTP requests based on the metadata\n * collected from decorators. It resolves the path, constructs the request,\n * and executes it using the appropriate fetcher.\n */\nexport class RequestExecutor {\n  private readonly metadata: FunctionMetadata;\n\n  /**\n   * Creates a new RequestExecutor instance.\n   *\n   * @param metadata - The function metadata containing all request information\n   */\n  constructor(metadata: FunctionMetadata) {\n    this.metadata = metadata;\n  }\n\n  /**\n   * Retrieves the fetcher instance from the target object.\n   *\n   * @param target - The target object that may contain a fetcher property\n   * @returns The fetcher instance if exists, otherwise undefined\n   */\n  private getTargetFetcher(target: any): Fetcher | undefined {\n    if (!target || typeof target !== 'object') {\n      return undefined;\n    }\n    // Extract the fetcher property from the target object\n    const fetcher = target[TARGET_FETCHER_PROPERTY];\n\n    // Validate that the fetcher is an instance of the Fetcher class\n    if (fetcher instanceof Fetcher) {\n      return fetcher;\n    }\n\n    // Return undefined if no valid fetcher instance is found\n    return undefined;\n  }\n\n  /**\n   * Executes the HTTP request.\n   *\n   * This method resolves the path and request configuration from the metadata\n   * and arguments, then executes the request using the configured fetcher.\n   * It handles the complete request lifecycle from parameter processing to\n   * response extraction.\n   *\n   * @param target - The target object that the method is called on.\n   *                 This can contain a custom fetcher instance in its 'fetcher' property.\n   * @param args - The runtime arguments passed to the decorated method.\n   *               These are mapped to request components based on parameter decorators.\n   * @returns A Promise that resolves to the extracted result based on the configured result extractor.\n   *          By default, this is the Response object, but can be customized to return\n   *          parsed JSON, the raw exchange object, or any other transformed result.\n   *\n   * @example\n   * ```typescript\n   * // Given a decorated service method:\n   * class UserService {\n   *   @get('/users/{id}')\n   *   getUser(@path('id') id: number): Promise<Response> {\n   *     // This method body is replaced by the executor at runtime\n   *   }\n   * }\n   *\n   * // When calling:\n   * const userService = new UserService();\n   * const response = await userService.getUser(123);\n   *\n   * // The execute method will:\n   * // 1. Resolve the path to '/users/123'\n   * // 2. Create a request with method 'GET'\n   * // 3. Execute the request using the configured fetcher\n   * // 4. Return the Response object\n   * ```\n   */\n  async execute(target: any, args: any[]): Promise<any> {\n    const fetcher = this.getTargetFetcher(target) || this.metadata.fetcher;\n    const exchangeInit = this.metadata.resolveExchangeInit(args);\n    exchangeInit.attributes?.set(DECORATOR_TARGET_ATTRIBUTE_KEY, target);\n    const extractor = this.metadata.resolveResultExtractor();\n    return fetcher.request(exchangeInit.request, { resultExtractor: extractor, attributes: exchangeInit.attributes });\n  }\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Cache for storing previously extracted parameter names to improve performance\nconst parameterNameCache = new WeakMap<Function, string[]>();\n\n/**\n * Extracts parameter names from a function.\n *\n * This function parses the string representation of a function to extract\n * the names of its parameters. It handles various function formats including\n * regular functions, arrow functions, and methods.\n *\n * Note: This implementation provides basic parameter name extraction and may not\n * handle all edge cases of complex TypeScript parameter declarations.\n *\n * @param func - The function to extract parameter names from\n * @returns An array of parameter names, or an empty array if extraction fails\n * @throws {TypeError} If the input is not a function\n *\n * @example\n * ```typescript\n * function example(a, b, c) {}\n * const paramNames = getParameterNames(example);\n * // Returns: ['a', 'b', 'c']\n *\n * const arrowFunc = (x, y) => x + y;\n * const arrowParamNames = getParameterNames(arrowFunc);\n * // Returns: ['x', 'y']\n *\n * function complex(param1: string, param2: number = 10, ...rest: any[]) {}\n * const complexParamNames = getParameterNames(complex);\n * // Returns: ['param1', 'param2', '...rest']\n * ```\n */\nexport function getParameterNames(func: (...args: any[]) => any): string[] {\n  // Validate that the input is a function\n  if (typeof func !== 'function') {\n    throw new TypeError('Expected a function');\n  }\n\n  // Check cache first to improve performance\n  if (parameterNameCache.has(func)) {\n    return parameterNameCache.get(func)!;\n  }\n\n  try {\n    // Convert function to string and trim whitespace\n    const fnStr = func.toString().trim();\n\n    // Extract parameter string from the function\n    const paramsStr = extractParameterString(fnStr);\n\n    // Handle empty parameters\n    if (!hasParameters(paramsStr)) {\n      const emptyResult: string[] = [];\n      parameterNameCache.set(func, emptyResult);\n      return emptyResult;\n    }\n\n    // Parse and clean parameter names\n    const result = parseParameterNames(paramsStr);\n    parameterNameCache.set(func, result);\n    return result;\n  } catch {\n    // Return empty array on any parsing errors to avoid breaking the application\n    const errorResult: string[] = [];\n    parameterNameCache.set(func, errorResult);\n    return errorResult;\n  }\n}\n\n/**\n * Helper function to automatically extract parameter name when not provided.\n *\n * @param target - The target object (class prototype)\n * @param propertyKey - The method name\n * @param parameterIndex - The index of the parameter\n * @param providedName - The name explicitly provided by the user (if any)\n * @returns The parameter name, either provided or automatically extracted\n */\nexport function getParameterName(\n  target: object,\n  propertyKey: string | symbol,\n  parameterIndex: number,\n  providedName?: string,\n): string | undefined {\n  // If a name was explicitly provided, use it\n  if (providedName) {\n    return providedName;\n  }\n\n  // Try to automatically extract the parameter name\n  try {\n    const method = target[propertyKey as keyof typeof target];\n    if (method && typeof method === 'function') {\n      const paramNames = getParameterNames(method);\n      if (parameterIndex < paramNames.length) {\n        return paramNames[parameterIndex];\n      }\n    }\n  } catch {\n    // If we can't get the parameter name, return undefined\n    // This will use default naming in the execution logic\n  }\n\n  return undefined;\n}\n\n/**\n * Checks if a parameter string contains actual parameters.\n *\n * @param paramsStr - The parameter string to check\n * @returns True if the string contains parameters, false otherwise\n */\nfunction hasParameters(paramsStr: string): boolean {\n  return (\n    paramsStr !== null && paramsStr !== undefined && paramsStr.trim() !== ''\n  );\n}\n\n/**\n * Extracts the parameter string from a function string representation.\n *\n * @param fnStr - The string representation of the function\n * @returns The parameter string, or empty string if not found\n */\nfunction extractParameterString(fnStr: string): string {\n  // Handle arrow functions that start with parentheses\n  if (fnStr.startsWith('(')) {\n    const endParenIndex = findClosingParenthesis(fnStr, 0);\n    if (endParenIndex === -1) return '';\n    return fnStr.substring(1, endParenIndex);\n  }\n\n  // Handle regular functions, async functions, and methods\n  const startParenIndex = fnStr.indexOf('(');\n  if (startParenIndex === -1) return '';\n\n  const endParenIndex = findClosingParenthesis(fnStr, startParenIndex);\n  if (endParenIndex === -1) return '';\n\n  return fnStr.substring(startParenIndex + 1, endParenIndex);\n}\n\n/**\n * Finds the matching closing parenthesis for an opening parenthesis.\n *\n * @param str - The string to search in\n * @param openingParenIndex - The index of the opening parenthesis\n * @returns The index of the matching closing parenthesis, or -1 if not found\n */\nfunction findClosingParenthesis(\n  str: string,\n  openingParenIndex: number,\n): number {\n  let parenDepth = 1;\n\n  for (let i = openingParenIndex + 1; i < str.length; i++) {\n    const char = str[i];\n\n    if (char === '(') {\n      parenDepth++;\n    } else if (char === ')') {\n      parenDepth--;\n      if (parenDepth === 0) {\n        return i;\n      }\n    }\n  }\n\n  return -1; // No matching closing parenthesis found\n}\n\n/**\n * Parses and cleans parameter names from a parameter string.\n *\n * @param paramsStr - The parameter string to parse\n * @returns An array of cleaned parameter names\n */\nfunction parseParameterNames(paramsStr: string): string[] {\n  return paramsStr\n    .split(',')\n    .map(trimWhitespace)\n    .filter(isNotEmpty)\n    .map(extractParameterName);\n}\n\n/**\n * Trims whitespace from a string.\n *\n * @param str - The string to trim\n * @returns The trimmed string\n */\nfunction trimWhitespace(str: string): string {\n  return str.trim();\n}\n\n/**\n * Checks if a string is not empty.\n *\n * @param str - The string to check\n * @returns True if the string is not empty, false otherwise\n */\nfunction isNotEmpty(str: string): boolean {\n  return str.length > 0;\n}\n\n/**\n * Extracts a clean parameter name by removing type annotations and default values.\n *\n * @param param - The raw parameter string\n * @returns The cleaned parameter name\n */\nfunction extractParameterName(param: string): string {\n  // Remove default value assignment (everything after =)\n  let cleanedParam = removeDefaultValue(param);\n\n  // Remove type annotations (everything after :)\n  cleanedParam = removeTypeAnnotation(cleanedParam);\n\n  return cleanedParam.trim();\n}\n\n/**\n * Removes default value from a parameter string.\n *\n * @param param - The parameter string\n * @returns The parameter string without default value\n */\nfunction removeDefaultValue(param: string): string {\n  const equalsIndex = param.indexOf('=');\n  if (equalsIndex !== -1) {\n    return param.substring(0, equalsIndex);\n  }\n  return param;\n}\n\n/**\n * Removes type annotation from a parameter string.\n *\n * @param param - The parameter string\n * @returns The parameter string without type annotation\n */\nfunction removeTypeAnnotation(param: string): string {\n  const colonIndex = param.indexOf(':');\n  if (colonIndex !== -1) {\n    return param.substring(0, colonIndex);\n  }\n  return param;\n}\n","import { getParameterName } from './reflection';\nimport 'reflect-metadata';\nimport { type PathCapable } from './endpointDecorator';\nimport { type FetchRequestInit } from '@ahoo-wang/fetcher';\n\n/**\n * Parameter types for decorator parameters.\n *\n * Defines the different types of parameters that can be used\n * in API method decorators to specify how arguments should be handled\n * in the HTTP request.\n */\nexport enum ParameterType {\n  /**\n   * Path parameter that will be inserted into the URL path.\n   *\n   * Path parameters are used to specify dynamic parts of the URL path.\n   * They are defined using curly braces in the endpoint path.\n   *\n   * @example\n   * ```typescript\n   * @get('/users/{id}')\n   * getUser(@path('id') userId: string): Promise<Response>\n   * ```\n   */\n  PATH = 'path',\n\n  /**\n   * Query parameter that will be appended to the URL query string.\n   *\n   * Query parameters are used to pass non-hierarchical data to the server.\n   * They appear after the '?' in the URL.\n   *\n   * @example\n   * ```typescript\n   * @get('/users')\n   * getUsers(@query('limit') limit: number): Promise<Response>\n   * ```\n   */\n  QUERY = 'query',\n\n  /**\n   * Header parameter that will be added to the request headers.\n   *\n   * Header parameters are used to pass metadata about the request,\n   * such as authentication tokens or content type information.\n   *\n   * @example\n   * ```typescript\n   * @get('/users')\n   * getUsers(@header('Authorization') token: string): Promise<Response>\n   * ```\n   */\n  HEADER = 'header',\n\n  /**\n   * Body parameter that will be sent as the request body.\n   *\n   * The body parameter represents the main data payload of the request.\n   * It is typically used with POST, PUT, and PATCH requests.\n   *\n   * @example\n   * ```typescript\n   * @post('/users')\n   * createUser(@body() user: User): Promise<Response>\n   * ```\n   */\n  BODY = 'body',\n\n  /**\n   * Request parameter that will be used as the request object.\n   */\n  REQUEST = 'request',\n\n\n  /**\n   * Attribute parameter that will be used as a single attribute in the request attributes.\n   *\n   * The attribute parameter allows passing a single key-value pair that will be added\n   * to the request attributes object. This is useful for passing specific contextual\n   * information that can be accessed by interceptors.\n   */\n  ATTRIBUTE = 'attribute',\n  /**\n   * Attributes parameter that will be used as the request attributes.\n   *\n   * The attributes parameter allows passing custom data that can be accessed\n   * by interceptors throughout the request lifecycle. This is useful for\n   * sharing contextual information between different parts of the request processing.\n   */\n  ATTRIBUTES = 'attributes'\n}\n\n/**\n * Metadata for method parameters.\n *\n * Defines the metadata stored for each parameter\n * decorated with @path, @query, @header, or @body decorators.\n */\nexport interface ParameterMetadata {\n  /**\n   * Type of parameter (path, query, header, body).\n   *\n   * Specifies how this parameter should be handled in the HTTP request.\n   */\n  type: ParameterType;\n\n  /**\n   * Name of the parameter (used for path, query, and header parameters).\n   *\n   * For path and query parameters, this corresponds to the key in the URL.\n   * For header parameters, this corresponds to the header name.\n   * For body parameters, this is not used.\n   */\n  name?: string;\n\n  /**\n   * Index of the parameter in the method signature.\n   *\n   * This is used to map the runtime argument values to the correct parameter metadata.\n   */\n  index: number;\n}\n\nexport const PARAMETER_METADATA_KEY = Symbol('parameter:metadata');\n\n/**\n * Decorator factory for method parameters.\n *\n * Creates a decorator that can be used to specify how a method parameter\n * should be handled in the HTTP request. It stores metadata about the parameter\n * that will be used during request execution.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param type - The type of parameter (PATH, QUERY, HEADER, or BODY)\n * @param name - The name of the parameter (used for path, query, and header parameters, optional - auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users/{id}')\n * getUser(@parameter(ParameterType.PATH, 'id') userId: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users/{userId}')\n * getUser(@parameter(ParameterType.PATH) userId: string): Promise<Response>\n * ```\n */\nexport function parameter(type: ParameterType, name: string = '') {\n  return function(\n    target: object,\n    propertyKey: string | symbol,\n    parameterIndex: number,\n  ) {\n    const paramName = getParameterName(\n      target,\n      propertyKey as string,\n      parameterIndex,\n      name,\n    );\n\n    const existingParameters: Map<number, ParameterMetadata> =\n      Reflect.getMetadata(PARAMETER_METADATA_KEY, target, propertyKey) ||\n      new Map();\n    const parameterMetadata: ParameterMetadata = {\n      type: type,\n      name: paramName,\n      index: parameterIndex,\n    };\n    existingParameters.set(parameterIndex, parameterMetadata);\n    Reflect.defineMetadata(\n      PARAMETER_METADATA_KEY,\n      existingParameters,\n      target,\n      propertyKey,\n    );\n  };\n}\n\n/**\n * Path parameter decorator.\n *\n * Defines a path parameter that will be inserted into the URL path.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the path parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users/{id}')\n * getUser(@path('id') userId: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users/{userId}')\n * getUser(@path() userId: string): Promise<Response>\n * ```\n */\nexport function path(name: string = '') {\n  return parameter(ParameterType.PATH, name);\n}\n\n/**\n * Query parameter decorator.\n *\n * Defines a query parameter that will be appended to the URL query string.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the query parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users')\n * getUsers(@query('limit') limit: number): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users')\n * getUsers(@query() limit: number): Promise<Response>\n * ```\n */\nexport function query(name: string = '') {\n  return parameter(ParameterType.QUERY, name);\n}\n\n/**\n * Header parameter decorator.\n *\n * Defines a header parameter that will be added to the request headers.\n * The name is optional - if not provided, it will be automatically extracted\n * from the method parameter name using reflection.\n *\n * @param name - The name of the header parameter (optional, auto-extracted if not provided)\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * // With explicit name\n * @get('/users')\n * getUsers(@header('Authorization') token: string): Promise<Response>\n *\n * // With auto-extracted name\n * @get('/users')\n * getUsers(@header() authorization: string): Promise<Response>\n * ```\n */\nexport function header(name: string = '') {\n  return parameter(ParameterType.HEADER, name);\n}\n\n/**\n * Body parameter decorator.\n *\n * Defines a body parameter that will be sent as the request body.\n * Note that body parameters don't have names since there's only one body per request.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @post('/users')\n * createUser(@body() user: User): Promise<Response>\n * ```\n */\nexport function body() {\n  return parameter(ParameterType.BODY);\n}\n\n/**\n * Interface for request parameter objects.\n *\n * Combines FetchRequestInit and PathCapable interfaces to provide\n * a complete request configuration object that can be used with\n * the @request() decorator. This allows full customization of\n * the HTTP request including method, headers, body, and URL parameters.\n */\nexport interface ParameterRequest extends FetchRequestInit, PathCapable {\n}\n\n/**\n * Request parameter decorator.\n *\n * Defines a request parameter that will be used as the base request object.\n * This allows you to pass a complete ParameterRequest object to customize\n * the request configuration.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @post('/users')\n * createUsers(@request() request: ParameterRequest): Promise<Response>\n * ```\n */\nexport function request() {\n  return parameter(ParameterType.REQUEST);\n}\n\n/**\n * Parameter decorator for adding a single attribute to the request attributes.\n *\n * This decorator allows you to pass a key-value pair as an attribute that can be accessed\n * by interceptors during the request lifecycle. If no name is provided, the parameter's\n * property name will be used as the attribute key.\n *\n * @param name - Optional name for the attribute. If not provided, the parameter's property name will be used.\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attribute('userId') userId: string): Promise<Response>\n *\n * // Using property name as attribute key\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attribute() userId: string): Promise<Response>\n * ```\n */\nexport function attribute(name: string = '') {\n  return parameter(ParameterType.ATTRIBUTE, name);\n}\n\n/**\n * Parameter decorator for adding multiple attributes to the request.\n *\n * This decorator allows you to pass an entire object as attributes that can be accessed\n * by interceptors during the request lifecycle. The parameter should be an object whose\n * properties will be merged into the request attributes.\n *\n * @returns A parameter decorator function\n *\n * @example\n * ```typescript\n * @get('/users/{id}')\n * getUser(@path('id') id: string, @attributes() attrs: Record<string, any>): Promise<Response>\n * ```\n */\nexport function attributes() {\n  return parameter(ParameterType.ATTRIBUTES);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Fetcher, fetcherRegistrar } from '@ahoo-wang/fetcher';\n\n/**\n * Interface that defines a capability for objects that can have a fetcher.\n * This interface is typically used to mark components or objects that can perform fetching operations\n * and may need access to fetcher functionality.\n */\nexport interface FetcherCapable {\n  /**\n   * Optional fetcher property that can be either a string identifier or a Fetcher instance.\n   * When present, this property indicates the fetcher associated with the implementing object.\n   */\n  fetcher?: string | Fetcher;\n}\n\n/**\n * Gets a Fetcher instance based on the provided fetcher parameter.\n *\n * @param fetcher - A string identifier or Fetcher instance to resolve\n * @returns A Fetcher instance if found, undefined otherwise\n */\nexport function getFetcher(fetcher?: string | Fetcher): Fetcher | undefined {\n  // Return undefined if no fetcher is provided\n  if (!fetcher) {\n    return undefined;\n  }\n\n  // Return the fetcher directly if it's already a Fetcher instance,\n  // otherwise resolve it through the fetcher registrar\n  return fetcher instanceof Fetcher\n    ? fetcher\n    : fetcherRegistrar.requiredGet(fetcher);\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  ExchangeResultExtractor,\n  JsonResultExtractor,\n  ResponseResultExtractor,\n  TextResultExtractor,\n} from '@ahoo-wang/fetcher';\nimport {\n  EventStreamResultExtractor,\n  JsonEventStreamResultExtractor,\n} from '@ahoo-wang/fetcher-eventstream';\n\n/**\n * ResultExtractors is an object that maps result extractor names to their corresponding\n * extractor functions. These extractors are used to process and extract data from different\n * types of responses or results in the application.\n *\n * Each property represents a specific type of result extractor:\n * - Exchange: Handles exchange-related result extraction\n * - Response: Handles general response result extraction\n * - Json: Handles JSON format result extraction\n * - Text: Handles plain text result extraction\n * - EventStream: Handles server-sent event stream result extraction\n * - JsonEventStream: Handles JSON server-sent event stream result extraction\n */\nexport const ResultExtractors = {\n  Exchange: ExchangeResultExtractor,\n  Response: ResponseResultExtractor,\n  Json: JsonResultExtractor,\n  Text: TextResultExtractor,\n  EventStream: EventStreamResultExtractor,\n  JsonEventStream: JsonEventStreamResultExtractor,\n  DEFAULT: JsonResultExtractor,\n};\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  combineURLs,\n  Fetcher, fetcher,\n  type FetchExchangeInit,\n  FetchRequestInit, mergeRecordToMap,\n  mergeRequest,\n  NamedCapable,\n  type RequestHeaders,\n  ResultExtractor,\n  type UrlParams,\n} from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport { EndpointMetadata } from './endpointDecorator';\nimport { ParameterMetadata, ParameterRequest, ParameterType } from './parameterDecorator';\nimport { getFetcher } from './fetcherCapable';\nimport { ResultExtractors } from './resultExtractor';\n\n/**\n * Metadata container for a function with HTTP endpoint decorators.\n *\n * Encapsulates all the metadata needed to execute an HTTP request\n * for a decorated method, including API-level defaults, endpoint-specific\n * configuration, and parameter metadata.\n */\nexport class FunctionMetadata implements NamedCapable {\n  /**\n   * Name of the function.\n   */\n  name: string;\n\n  /**\n   * API-level metadata (class-level configuration).\n   */\n  api: ApiMetadata;\n\n  /**\n   * Endpoint-level metadata (method-level configuration).\n   */\n  endpoint: EndpointMetadata;\n\n  /**\n   * Metadata for method parameters.\n   *\n   * Defines the metadata stored for each parameter decorated with @path, @query,\n   * @header, or @body decorators. Stored as a Map keyed by parameter index.\n   *\n   * @remarks\n   * The metadata is stored as a Map<number, ParameterMetadata> where the key is\n   * the parameter index and the value is the parameter metadata. This ensures\n   * correct parameter ordering regardless of decorator application order.\n   */\n  parameters: Map<number, ParameterMetadata>;\n\n  /**\n   * Creates a new FunctionMetadata instance.\n   *\n   * @param name - The name of the function\n   * @param api - API-level metadata\n   * @param endpoint - Endpoint-level metadata\n   * @param parameters - Parameter metadata array\n   */\n  constructor(\n    name: string,\n    api: ApiMetadata,\n    endpoint: EndpointMetadata,\n    parameters: Map<number, ParameterMetadata>,\n  ) {\n    this.name = name;\n    this.api = api;\n    this.endpoint = endpoint;\n    this.parameters = parameters;\n  }\n\n  /**\n   * Gets the fetcher instance to use for this function.\n   *\n   * Returns the fetcher specified in the endpoint metadata, or the API metadata,\n   * or falls back to the default fetcher if none is specified.\n   *\n   * @returns The fetcher instance\n   */\n  get fetcher(): Fetcher {\n    return getFetcher(this.endpoint.fetcher ?? this.api.fetcher) ?? fetcher;\n  }\n\n  /**\n   * Resolves the complete path by combining base path and endpoint path\n   *\n   * @param parameterPath - Optional path parameter to use instead of endpoint path\n   * @returns The combined URL path\n   */\n  resolvePath(parameterPath?: string): string {\n    // Get the base path from endpoint, API, or default to empty string\n    const basePath = this.endpoint.basePath || this.api.basePath || '';\n\n    // Use provided parameter path or fallback to endpoint path\n    const endpointPath = parameterPath || this.endpoint.path || '';\n\n    // Combine the base path and endpoint path into a complete URL\n    return combineURLs(basePath, endpointPath);\n  }\n\n  /**\n   * Resolves the timeout for the request.\n   *\n   * Returns the timeout specified in the endpoint metadata, or the API metadata,\n   * or undefined if no timeout is specified.\n   *\n   * @returns The timeout value in milliseconds, or undefined\n   */\n  resolveTimeout(): number | undefined {\n    return this.endpoint.timeout || this.api.timeout;\n  }\n\n  resolveResultExtractor(): ResultExtractor<any> {\n    return (\n      this.endpoint.resultExtractor ||\n      this.api.resultExtractor ||\n      ResultExtractors.DEFAULT\n    );\n  }\n\n  resolveAttributes(): Map<string, any> {\n    const resolvedAttributes = mergeRecordToMap(this.api.attributes);\n    return mergeRecordToMap(this.endpoint.attributes, resolvedAttributes);\n  }\n\n  /**\n   * Resolves the request configuration from the method arguments.\n   *\n   * This method processes the runtime arguments according to the parameter metadata\n   * and constructs a FetcherRequest object with path parameters, query parameters,\n   * headers, body, and timeout. It handles various parameter types including:\n   * - Path parameters (@path decorator)\n   * - Query parameters (@query decorator)\n   * - Header parameters (@header decorator)\n   * - Body parameter (@body decorator)\n   * - Complete request object (@request decorator)\n   * - AbortSignal for request cancellation\n   *\n   * The method uses mergeRequest to combine the endpoint-specific configuration\n   * with the parameter-provided request object, where the parameter request\n   * takes precedence over endpoint configuration.\n   *\n   * @param args - The runtime arguments passed to the method\n   * @returns A FetcherRequest object with all request configuration\n   *\n   * @example\n   * ```typescript\n   * // For a method decorated like:\n   * @get('/users/{id}')\n   * getUser(\n   *   @path('id') id: number,\n   *   @query('include') include: string,\n   *   @header('Authorization') auth: string\n   * ): Promise<Response>\n   *\n   * // Calling with: getUser(123, 'profile', 'Bearer token')\n   * // Would produce a request with:\n   * // {\n   * //   method: 'GET',\n   * //   urlParams: {\n   * //     path: { id: 123 },\n   * //     query: { include: 'profile' }\n   * //   },\n   * //   headers: {\n   * //     'Authorization': 'Bearer token',\n   * //     ...apiHeaders,\n   * //     ...endpointHeaders\n   * //   }\n   * // }\n   * ```\n   */\n  resolveExchangeInit(args: any[]): Required<Pick<FetchExchangeInit, 'request' | 'attributes'>> {\n    const pathParams: Record<string, any> = {};\n    const queryParams: Record<string, any> = {};\n    const headers: RequestHeaders = {\n      ...this.api.headers,\n      ...this.endpoint.headers,\n    };\n    let body: any = undefined;\n    let signal: AbortSignal | null | undefined = undefined;\n    let abortController: AbortController | null | undefined = undefined;\n    let parameterRequest: ParameterRequest = {};\n    const attributes: Map<string, any> = this.resolveAttributes();\n    // Process parameters based on their decorators\n    args.forEach((value, index) => {\n      if (value instanceof AbortSignal) {\n        signal = value;\n        return;\n      }\n      if (value instanceof AbortController) {\n        abortController = value;\n        return;\n      }\n      const funParameter = this.parameters.get(index);\n      if (!funParameter) {\n        return;\n      }\n      switch (funParameter.type) {\n        case ParameterType.PATH:\n          this.processPathParam(funParameter, value, pathParams);\n          break;\n        case ParameterType.QUERY:\n          this.processQueryParam(funParameter, value, queryParams);\n          break;\n        case ParameterType.HEADER:\n          this.processHeaderParam(funParameter, value, headers);\n          break;\n        case ParameterType.BODY:\n          body = value;\n          break;\n        case ParameterType.REQUEST:\n          parameterRequest = this.processRequestParam(value);\n          break;\n        case ParameterType.ATTRIBUTE:\n          this.processAttributeParam(funParameter, value, attributes);\n          break;\n        case ParameterType.ATTRIBUTES:\n          this.processAttributesParam(value, attributes);\n          break;\n      }\n    });\n    const urlParams: UrlParams = {\n      path: pathParams,\n      query: queryParams,\n    };\n    const endpointRequest: FetchRequestInit = {\n      method: this.endpoint.method,\n      urlParams,\n      headers,\n      body,\n      timeout: this.resolveTimeout(),\n      signal,\n      abortController,\n    };\n    const mergedRequest = mergeRequest(\n      endpointRequest,\n      parameterRequest,\n    ) as any;\n    const parameterPath = parameterRequest.path;\n    mergedRequest.url = this.resolvePath(parameterPath);\n    return {\n      request: mergedRequest,\n      attributes,\n    };\n  }\n\n  private processPathParam(\n    param: ParameterMetadata,\n    value: any,\n    path: Record<string, any>,\n  ) {\n    const paramName = param.name || `param${param.index}`;\n    path[paramName] = value;\n  }\n\n  private processQueryParam(\n    param: ParameterMetadata,\n    value: any,\n    query: Record<string, any>,\n  ) {\n    const paramName = param.name || `param${param.index}`;\n    query[paramName] = value;\n  }\n\n  private processHeaderParam(\n    param: ParameterMetadata,\n    value: any,\n    headers: RequestHeaders,\n  ) {\n    if (param.name && value !== undefined) {\n      headers[param.name] = String(value);\n    }\n  }\n\n  /**\n   * Processes a request parameter value.\n   *\n   * This method handles the @request() decorator parameter by casting\n   * the provided value to a FetcherRequest. The @request() decorator\n   * allows users to pass a complete FetcherRequest object to customize\n   * the request configuration.\n   *\n   * @param value - The value provided for the @request() parameter\n   * @returns The value cast to FetcherRequest type\n   *\n   * @example\n   * ```typescript\n   * @post('/users')\n   * createUsers(@request() request: FetcherRequest): Promise<Response>\n   *\n   * // Usage:\n   * const customRequest: FetcherRequest = {\n   *   headers: { 'X-Custom': 'value' },\n   *   timeout: 5000\n   * };\n   * await service.createUsers(customRequest);\n   * ```\n   */\n  private processRequestParam(value: any): ParameterRequest {\n    if (!value) {\n      return {};\n    }\n\n    const request = value as ParameterRequest;\n    // 确保请求对象中的属性被正确保留\n    return {\n      ...request,\n      headers: request.headers || {},\n      urlParams: request.urlParams || { path: {}, query: {} },\n    };\n  }\n\n\n  private processAttributeParam(\n    param: ParameterMetadata,\n    value: any,\n    attributes: Map<string, any>,\n  ) {\n    if (param.name && value !== undefined) {\n      attributes.set(param.name, value);\n    }\n  }\n\n  private processAttributesParam(\n    value: any,\n    attributes: Map<string, any>,\n  ) {\n    if (typeof value !== 'object' || value ! instanceof Map) {\n      throw new Error('@attributes() parameter must be an object or an Map');\n    }\n    mergeRecordToMap(value, attributes);\n  }\n\n}","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  type AttributesCapable,\n  Fetcher,\n  type RequestHeaders,\n  type RequestHeadersCapable,\n  type ResultExtractorCapable,\n  type TimeoutCapable,\n} from '@ahoo-wang/fetcher';\nimport { ENDPOINT_METADATA_KEY } from './endpointDecorator';\nimport { RequestExecutor } from './requestExecutor';\nimport { PARAMETER_METADATA_KEY } from './parameterDecorator';\nimport 'reflect-metadata';\nimport { type FetcherCapable } from './fetcherCapable';\nimport { FunctionMetadata } from './functionMetadata';\n\n/**\n * Metadata for class-level API configuration.\n *\n * Defines the configuration options that can be applied to an entire API class.\n * These settings will be used as defaults for all endpoints within the class unless overridden\n * at the method level.\n */\nexport interface ApiMetadata\n  extends TimeoutCapable,\n    RequestHeadersCapable,\n    ResultExtractorCapable,\n    FetcherCapable, AttributesCapable {\n  /**\n   * Base path for all endpoints in the class.\n   *\n   * This path will be prepended to all endpoint paths defined in the class.\n   * For example, if basePath is '/api/v1' and an endpoint has path '/users',\n   * the full path will be '/api/v1/users'.\n   */\n  basePath?: string;\n\n  /**\n   * Default headers for all requests in the class.\n   *\n   * These headers will be included in every request made by methods in this class.\n   * They can be overridden or extended at the method level.\n   */\n  headers?: RequestHeaders;\n\n  /**\n   * Default timeout for all requests in the class (in milliseconds).\n   *\n   * This timeout value will be applied to all requests made by methods in this class.\n   * Individual methods can specify their own timeout values to override this default.\n   */\n  timeout?: number;\n\n  /**\n   * Name of the fetcher instance to use, default: 'default'.\n   *\n   * This allows you to specify which fetcher instance should be used for requests\n   * from this API class. The fetcher must be registered with the FetcherRegistrar.\n   */\n  fetcher?: string | Fetcher;\n}\n\nexport const API_METADATA_KEY = Symbol('api:metadata');\n\n/**\n * Binds a request executor to a method, replacing the original method with\n * an implementation that makes HTTP requests based on the decorator metadata.\n *\n * @param constructor - The class constructor\n * @param functionName - The name of the method to bind\n * @param apiMetadata - The API metadata for the class\n */\nfunction bindExecutor<T extends new (...args: any[]) => any>(\n  constructor: T,\n  functionName: string,\n  apiMetadata: ApiMetadata,\n) {\n  const endpointFunction = constructor.prototype[functionName];\n  if (functionName === 'constructor') {\n    return;\n  }\n  if (typeof endpointFunction !== 'function') {\n    return;\n  }\n\n  const endpointMetadata = Reflect.getMetadata(\n    ENDPOINT_METADATA_KEY,\n    constructor.prototype,\n    functionName,\n  );\n  if (!endpointMetadata) {\n    return;\n  }\n  // Get parameter metadata for this method\n  const parameterMetadata =\n    Reflect.getMetadata(\n      PARAMETER_METADATA_KEY,\n      constructor.prototype,\n      functionName,\n    ) || new Map();\n\n  // Create function metadata\n  const functionMetadata = new FunctionMetadata(\n    functionName,\n    apiMetadata,\n    endpointMetadata,\n    parameterMetadata,\n  );\n\n  // Create request executor\n  const requestExecutor = new RequestExecutor(functionMetadata);\n\n  // Replace method with actual implementation\n  constructor.prototype[functionName] = function(...args: unknown[]) {\n    return requestExecutor.execute(this, args);\n  };\n}\n\nexport function api(\n  basePath: string = '',\n  metadata: Omit<ApiMetadata, 'basePath'> = {},\n) {\n  return function <T extends new (...args: any[]) => any>(constructor: T): T {\n    const apiMetadata: ApiMetadata = {\n      basePath,\n      ...metadata,\n    };\n\n    // Store metadata directly on the class constructor\n    Reflect.defineMetadata(API_METADATA_KEY, apiMetadata, constructor);\n\n    // Override prototype methods to implement actual HTTP calls\n    Object.getOwnPropertyNames(constructor.prototype).forEach(functionName => {\n      bindExecutor(constructor, functionName, apiMetadata);\n    });\n\n    return constructor;\n  };\n}\n","/*\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *      http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Custom error class that indicates a method implementation will be automatically generated.\n *\n * @example\n * ```\n *     @post()\n *     createUser(@body() user: User):Promise<Response> {\n *         throw autoGeneratedError(user);\n *     }\n * ```\n */\nexport class AutoGenerated extends Error {\n  constructor() {\n    super('Implementation will be generated automatically.');\n    this.name = 'AutoGenerated';\n  }\n}\n\n/**\n * Factory function that creates an AutoGenerated error instance.\n * This is typically used in methods that will be automatically implemented,\n * where a placeholder implementation is needed.\n *\n * @param _ignored - Arguments (such as 'user' in the example) are ignored to prevent\n *                   ESLint no-unused-vars errors in method signatures that will be auto-generated.\n * @returns A new AutoGenerated error instance\n */\nexport const autoGeneratedError = (..._ignored: any[]): AutoGenerated => {\n  return new AutoGenerated();\n};\n"],"names":["ENDPOINT_METADATA_KEY","endpoint","method","path","metadata","target","propertyKey","endpointMetadata","get","HttpMethod","post","put","del","patch","head","options","TARGET_FETCHER_PROPERTY","DECORATOR_TARGET_ATTRIBUTE_KEY","RequestExecutor","fetcher","Fetcher","args","exchangeInit","extractor","parameterNameCache","getParameterNames","func","fnStr","paramsStr","extractParameterString","hasParameters","emptyResult","result","parseParameterNames","errorResult","getParameterName","parameterIndex","providedName","paramNames","endParenIndex","findClosingParenthesis","startParenIndex","str","openingParenIndex","parenDepth","i","char","trimWhitespace","isNotEmpty","extractParameterName","param","cleanedParam","removeDefaultValue","removeTypeAnnotation","equalsIndex","colonIndex","ParameterType","PARAMETER_METADATA_KEY","parameter","type","name","paramName","existingParameters","parameterMetadata","query","header","body","request","attribute","attributes","getFetcher","fetcherRegistrar","ResultExtractors","ExchangeResultExtractor","ResponseResultExtractor","JsonResultExtractor","TextResultExtractor","EventStreamResultExtractor","JsonEventStreamResultExtractor","FunctionMetadata","api","parameters","parameterPath","basePath","endpointPath","combineURLs","resolvedAttributes","mergeRecordToMap","pathParams","queryParams","headers","signal","abortController","parameterRequest","value","index","funParameter","urlParams","endpointRequest","mergedRequest","mergeRequest","API_METADATA_KEY","bindExecutor","constructor","functionName","apiMetadata","endpointFunction","functionMetadata","requestExecutor","AutoGenerated","autoGeneratedError","_ignored"],"mappings":"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"}

package/dist/resultExtractor.d.ts

@@ -1,11 +1,3 @@
-import { ResultExtractor } from '@ahoo-wang/fetcher';
-/**
- * Interface with result extractor capability
- * Defines an optional resultExtractor property
- */
-export interface ResultExtractorCapable {
-    resultExtractor?: ResultExtractor<any>;
-}
 /**
  * ResultExtractors is an object that maps result extractor names to their corresponding
  * extractor functions. These extractors are used to process and extract data from different
@@ -20,12 +12,12 @@ export interface ResultExtractorCapable {
  * - JsonEventStream: Handles JSON server-sent event stream result extraction
  */
 export declare const ResultExtractors: {
-    Exchange: ResultExtractor<import('@ahoo-wang/fetcher').FetchExchange>;
-    Response: ResultExtractor<Response>;
-    Json: ResultExtractor<Promise<any>>;
-    Text: ResultExtractor<Promise<string>>;
-    EventStream: ResultExtractor<import('@ahoo-wang/fetcher-eventstream').ServerSentEventStream>;
-    JsonEventStream: ResultExtractor<import('@ahoo-wang/fetcher-eventstream').JsonServerSentEventStream<any>>;
-    DEFAULT: ResultExtractor<Promise<any>>;
+    Exchange: import('@ahoo-wang/fetcher').ResultExtractor<import('@ahoo-wang/fetcher').FetchExchange>;
+    Response: import('@ahoo-wang/fetcher').ResultExtractor<Response>;
+    Json: import('@ahoo-wang/fetcher').ResultExtractor<Promise<any>>;
+    Text: import('@ahoo-wang/fetcher').ResultExtractor<Promise<string>>;
+    EventStream: import('@ahoo-wang/fetcher').ResultExtractor<import('@ahoo-wang/fetcher-eventstream').ServerSentEventStream>;
+    JsonEventStream: import('@ahoo-wang/fetcher').ResultExtractor<import('@ahoo-wang/fetcher-eventstream').JsonServerSentEventStream<any>>;
+    DEFAULT: import('@ahoo-wang/fetcher').ResultExtractor<Promise<any>>;
 };
 //# sourceMappingURL=resultExtractor.d.ts.map

package/dist/resultExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resultExtractor.d.ts","sourceRoot":"","sources":["../src/resultExtractor.ts"],"names":[],"mappings":"AAaA,OAAO,EAIL,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAM5B;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;CAQ5B,CAAC"}
+{"version":3,"file":"resultExtractor.d.ts","sourceRoot":"","sources":["../src/resultExtractor.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;CAQ5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher-decorator",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "TypeScript decorators for clean, declarative API service definitions with Fetcher HTTP client. Enables automatic parameter binding, method mapping, and type-safe API interactions.",
   "keywords": [
     "fetch",
@@ -40,8 +40,8 @@
   ],
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@ahoo-wang/fetcher": "1.6.0",
-    "@ahoo-wang/fetcher-eventstream": "1.6.0"
+    "@ahoo-wang/fetcher-eventstream": "1.6.2",
+    "@ahoo-wang/fetcher": "1.6.2"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^3.2.4",