@ahoo-wang/fetcher-decorator 1.0.8 → 1.1.0

package/dist/index.es.js

@@ -1,55 +1,55 @@
-import { HttpMethod as c, ExchangeError as g, fetcherRegistrar as v, Fetcher as q, fetcher as M, mergeRequest as S, combineURLs as w } from "@ahoo-wang/fetcher";
+import { HttpMethod as c, fetcherRegistrar as A, Fetcher as g, fetcher as M, mergeRequest as v, combineURLs as D } from "@ahoo-wang/fetcher";
 import "reflect-metadata";
-const T = Symbol("endpoint:metadata");
+const q = Symbol("endpoint:metadata");
 function d(t, e, r = {}) {
-  return function(n, s) {
-    const a = {
+  return function(n, a) {
+    const s = {
       method: t,
       path: e,
       ...r
     };
     Reflect.defineMetadata(
-      T,
-      a,
+      q,
+      s,
       n,
-      s
+      a
     );
   };
 }
-function et(t = "", e = {}) {
+function tt(t = "", e = {}) {
   return d(c.GET, t, e);
 }
-function rt(t = "", e = {}) {
+function et(t = "", e = {}) {
   return d(c.POST, t, e);
 }
-function nt(t = "", e = {}) {
+function rt(t = "", e = {}) {
   return d(c.PUT, t, e);
 }
-function st(t = "", e = {}) {
+function nt(t = "", e = {}) {
   return d(c.DELETE, t, e);
 }
 function at(t = "", e = {}) {
   return d(c.PATCH, t, e);
 }
-function ot(t = "", e = {}) {
+function st(t = "", e = {}) {
   return d(c.HEAD, t, e);
 }
-function it(t = "", e = {}) {
+function ot(t = "", e = {}) {
   return d(c.OPTIONS, t, e);
 }
 const f = /* @__PURE__ */ new WeakMap();
-function D(t) {
+function w(t) {
   if (typeof t != "function")
     throw new TypeError("Expected a function");
   if (f.has(t))
     return f.get(t);
   try {
-    const e = t.toString().trim(), r = F(e);
-    if (!H(r)) {
-      const s = [];
-      return f.set(t, s), s;
+    const e = t.toString().trim(), r = H(e);
+    if (!S(r)) {
+      const a = [];
+      return f.set(t, a), a;
     }
-    const n = _(r);
+    const n = F(r);
     return f.set(t, n), n;
   } catch {
     const e = [];
@@ -60,19 +60,19 @@ function O(t, e, r, n) {
   if (n)
     return n;
   try {
-    const s = t[e];
-    if (s && typeof s == "function") {
-      const a = D(s);
-      if (r < a.length)
-        return a[r];
+    const a = t[e];
+    if (a && typeof a == "function") {
+      const s = w(a);
+      if (r < s.length)
+        return s[r];
     }
   } catch {
   }
 }
-function H(t) {
+function S(t) {
   return t != null && t.trim() !== "";
 }
-function F(t) {
+function H(t) {
   if (t.startsWith("(")) {
     const n = P(t, 0);
     return n === -1 ? "" : t.substring(1, n);
@@ -85,50 +85,50 @@ function F(t) {
 function P(t, e) {
   let r = 1;
   for (let n = e + 1; n < t.length; n++) {
-    const s = t[n];
-    if (s === "(")
+    const a = t[n];
+    if (a === "(")
       r++;
-    else if (s === ")" && (r--, r === 0))
+    else if (a === ")" && (r--, r === 0))
       return n;
   }
   return -1;
 }
+function F(t) {
+  return t.split(",").map(_).filter(N).map(U);
+}
 function _(t) {
-  return t.split(",").map(N).filter(U).map(Y);
+  return t.trim();
 }
 function N(t) {
-  return t.trim();
+  return t.length > 0;
 }
 function U(t) {
-  return t.length > 0;
+  let e = Y(t);
+  return e = k(e), e.trim();
 }
 function Y(t) {
-  let e = k(t);
-  return e = G(e), e.trim();
-}
-function k(t) {
   const e = t.indexOf("=");
   return e !== -1 ? t.substring(0, e) : t;
 }
-function G(t) {
+function k(t) {
   const e = t.indexOf(":");
   return e !== -1 ? t.substring(0, e) : t;
 }
-var p = /* @__PURE__ */ ((t) => (t.PATH = "path", t.QUERY = "query", t.HEADER = "header", t.BODY = "body", t.REQUEST = "request", t))(p || {});
+var h = /* @__PURE__ */ ((t) => (t.PATH = "path", t.QUERY = "query", t.HEADER = "header", t.BODY = "body", t.REQUEST = "request", t))(h || {});
 const l = Symbol("parameter:metadata");
 function m(t, e = "") {
-  return function(r, n, s) {
-    const a = O(
+  return function(r, n, a) {
+    const s = O(
       r,
       n,
-      s,
+      a,
       e
     ), o = Reflect.getMetadata(l, r, n) || /* @__PURE__ */ new Map(), i = {
       type: t,
-      name: a,
-      index: s
+      name: s,
+      index: a
     };
-    o.set(s, i), Reflect.defineMetadata(
+    o.set(a, i), Reflect.defineMetadata(
       l,
       o,
       r,
@@ -136,16 +136,16 @@ function m(t, e = "") {
     );
   };
 }
-function ut(t = "") {
+function it(t = "") {
   return m("path", t);
 }
-function ct(t = "") {
+function ut(t = "") {
   return m("query", t);
 }
-function dt(t = "") {
+function ct(t = "") {
   return m("header", t);
 }
-function pt() {
+function dt() {
   return m(
     "body"
     /* BODY */
@@ -157,31 +157,20 @@ function ht() {
     /* REQUEST */
   );
 }
-const I = (t) => t, Q = (t) => t.requiredResponse, x = (t) => t.requiredResponse.json(), j = (t) => t.requiredResponse.text(), J = (t) => {
-  if (!t.requiredResponse.eventStream)
-    throw new g(t, "ServerSentEventStream is not supported");
-  return t.requiredResponse.eventStream();
-}, C = (t) => {
-  if (!t.requiredResponse.jsonEventStream)
-    throw new g(
-      t,
-      "JsonServerSentEventStream is not supported"
-    );
-  return t.requiredResponse.jsonEventStream();
-}, L = {
-  Exchange: I,
-  Response: Q,
+const G = (t) => t, I = (t) => t.requiredResponse, x = (t) => t.requiredResponse.json(), Q = (t) => t.requiredResponse.text(), J = (t) => t.requiredResponse.requiredEventStream(), C = (t) => t.requiredResponse.requiredJsonEventStream(), L = {
+  Exchange: G,
+  Response: I,
   Json: x,
-  Text: j,
+  Text: Q,
   EventStream: J,
   JsonEventStream: C,
   DEFAULT: x
 };
-function W(t) {
+function j(t) {
   if (t)
-    return t instanceof q ? t : v.requiredGet(t);
+    return t instanceof g ? t : A.requiredGet(t);
 }
-class B {
+class W {
   /**
    * Creates a new FunctionMetadata instance.
    *
@@ -190,8 +179,8 @@ class B {
    * @param endpoint - Endpoint-level metadata
    * @param parameters - Parameter metadata array
    */
-  constructor(e, r, n, s) {
-    this.name = e, this.api = r, this.endpoint = n, this.parameters = s;
+  constructor(e, r, n, a) {
+    this.name = e, this.api = r, this.endpoint = n, this.parameters = a;
   }
   /**
    * Gets the fetcher instance to use for this function.
@@ -202,7 +191,7 @@ class B {
    * @returns The fetcher instance
    */
   get fetcher() {
-    return W(this.endpoint.fetcher ?? this.api.fetcher) ?? M;
+    return j(this.endpoint.fetcher ?? this.api.fetcher) ?? M;
   }
   /**
    * Resolves the request configuration from the method arguments.
@@ -251,32 +240,32 @@ class B {
    * ```
    */
   resolveRequest(e) {
-    const r = {}, n = {}, s = {
+    const r = {}, n = {}, a = {
       ...this.api.headers,
       ...this.endpoint.headers
     };
-    let a, o, i = {};
-    e.forEach((u, A) => {
+    let s, o, i = {};
+    e.forEach((u, y) => {
       if (u instanceof AbortSignal) {
         o = u;
         return;
       }
-      const h = this.parameters.get(A);
-      if (h)
-        switch (h.type) {
-          case p.PATH:
-            this.processPathParam(h, u, r);
+      const p = this.parameters.get(y);
+      if (p)
+        switch (p.type) {
+          case h.PATH:
+            this.processPathParam(p, u, r);
             break;
-          case p.QUERY:
-            this.processQueryParam(h, u, n);
+          case h.QUERY:
+            this.processQueryParam(p, u, n);
             break;
-          case p.HEADER:
-            this.processHeaderParam(h, u, s);
+          case h.HEADER:
+            this.processHeaderParam(p, u, a);
             break;
-          case p.BODY:
-            a = u;
+          case h.BODY:
+            s = u;
             break;
-          case p.REQUEST:
+          case h.REQUEST:
             i = this.processRequestParam(u);
             break;
         }
@@ -284,26 +273,26 @@ class B {
     const E = {
       path: r,
       query: n
-    }, b = {
+    }, T = {
       method: this.endpoint.method,
       urlParams: E,
-      headers: s,
-      body: a,
+      headers: a,
+      body: s,
       timeout: this.resolveTimeout(),
       signal: o
-    }, R = S(
-      b,
+    }, R = v(
+      T,
       i
-    ), y = i.path;
-    return R.url = this.resolvePath(y), R;
+    ), b = i.path;
+    return R.url = this.resolvePath(b), R;
   }
   processPathParam(e, r, n) {
-    const s = e.name || `param${e.index}`;
-    n[s] = r;
+    const a = e.name || `param${e.index}`;
+    n[a] = r;
   }
   processQueryParam(e, r, n) {
-    const s = e.name || `param${e.index}`;
-    n[s] = r;
+    const a = e.name || `param${e.index}`;
+    n[a] = r;
   }
   processHeaderParam(e, r, n) {
     e.name && r !== void 0 && (n[e.name] = String(r));
@@ -343,7 +332,7 @@ class B {
    */
   resolvePath(e) {
     const r = this.endpoint.basePath || this.api.basePath || "", n = e || this.endpoint.path || "";
-    return w(r, n);
+    return D(r, n);
   }
   /**
    * Resolves the timeout for the request.
@@ -360,8 +349,8 @@ class B {
     return this.endpoint.resultExtractor || this.api.resultExtractor || L.DEFAULT;
   }
 }
-const $ = "fetcher";
-class K {
+const B = "fetcher";
+class $ {
   /**
    * Creates a new RequestExecutor instance.
    *
@@ -379,8 +368,8 @@ class K {
   getTargetFetcher(e) {
     if (!e || typeof e != "object")
       return;
-    const r = e[$];
-    if (r instanceof q)
+    const r = e[B];
+    if (r instanceof g)
       return r;
   }
   /**
@@ -394,86 +383,86 @@ class K {
    * @returns A Promise that resolves to the Response
    */
   async execute(e, r) {
-    const n = this.getTargetFetcher(e) || this.metadata.fetcher, s = this.metadata.resolveRequest(r), a = await n.request(s);
-    return this.metadata.resolveResultExtractor()(a);
+    const n = this.getTargetFetcher(e) || this.metadata.fetcher, a = this.metadata.resolveRequest(r), s = await n.request(a);
+    return this.metadata.resolveResultExtractor()(s);
   }
 }
-const V = Symbol("api:metadata");
-function z(t, e, r) {
+const K = Symbol("api:metadata");
+function V(t, e, r) {
   const n = t.prototype[e];
   if (e === "constructor" || typeof n != "function")
     return;
-  const s = Reflect.getMetadata(
-    T,
+  const a = Reflect.getMetadata(
+    q,
     t.prototype,
     e
   );
-  if (!s)
+  if (!a)
     return;
-  const a = Reflect.getMetadata(
+  const s = Reflect.getMetadata(
     l,
     t.prototype,
     e
-  ) || /* @__PURE__ */ new Map(), o = new B(
+  ) || /* @__PURE__ */ new Map(), o = new W(
     e,
     r,
-    s,
-    a
-  ), i = new K(o);
+    a,
+    s
+  ), i = new $(o);
   t.prototype[e] = function(...E) {
     return i.execute(this, E);
   };
 }
-function ft(t = "", e = {}) {
+function pt(t = "", e = {}) {
   return function(r) {
     const n = {
       basePath: t,
       ...e
     };
-    return Reflect.defineMetadata(V, n, r), Object.getOwnPropertyNames(r.prototype).forEach((s) => {
-      z(r, s, n);
+    return Reflect.defineMetadata(K, n, r), Object.getOwnPropertyNames(r.prototype).forEach((a) => {
+      V(r, a, n);
     }), r;
   };
 }
-class X extends Error {
+class z extends Error {
   constructor() {
     super("Implementation will be generated automatically."), this.name = "AutoGenerated";
   }
 }
-const mt = (...t) => new X();
+const ft = (...t) => new z();
 export {
-  V as API_METADATA_KEY,
-  X as AutoGenerated,
-  T as ENDPOINT_METADATA_KEY,
+  K as API_METADATA_KEY,
+  z as AutoGenerated,
+  q as ENDPOINT_METADATA_KEY,
   J as EventStreamResultExtractor,
-  I as ExchangeResultExtractor,
-  B as FunctionMetadata,
+  G as ExchangeResultExtractor,
+  W as FunctionMetadata,
   C as JsonEventStreamResultExtractor,
   x as JsonResultExtractor,
   l as PARAMETER_METADATA_KEY,
-  p as ParameterType,
-  K as RequestExecutor,
-  Q as ResponseResultExtractor,
+  h as ParameterType,
+  $ as RequestExecutor,
+  I as ResponseResultExtractor,
   L as ResultExtractors,
-  j as TextResultExtractor,
-  ft as api,
-  mt as autoGeneratedError,
-  pt as body,
-  st as del,
+  Q as TextResultExtractor,
+  pt as api,
+  ft as autoGeneratedError,
+  dt as body,
+  nt as del,
   d as endpoint,
-  et as get,
-  W as getFetcher,
+  tt as get,
+  j as getFetcher,
   O as getParameterName,
-  D as getParameterNames,
-  ot as head,
-  dt as header,
-  it as options,
+  w as getParameterNames,
+  st as head,
+  ct as header,
+  ot as options,
   m as parameter,
   at as patch,
-  ut as path,
-  rt as post,
-  nt as put,
-  ct as query,
+  it as path,
+  et as post,
+  rt as put,
+  ut as query,
   ht 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/reflection.ts","../src/parameterDecorator.ts","../src/resultExtractor.ts","../src/fetcherCapable.ts","../src/requestExecutor.ts","../src/apiDecorator.ts","../src/generated.ts"],"sourcesContent":["import { HttpMethod } from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport 'reflect-metadata';\nimport { ResultExtractor, 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 */\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 { PathCapable } from './endpointDecorator';\nimport { 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 * 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 * 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 { ExchangeError, FetchExchange } from '@ahoo-wang/fetcher';\nimport {\n  JsonServerSentEventStream,\n  ServerSentEventStream,\n} from '@ahoo-wang/fetcher-eventstream';\n\n/**\n * Result extractor interface\n * Defines a function type for extracting results from a FetchExchange\n * @param exchange - FetchExchange object containing request and response information\n * @returns Returns a value of type FetchExchange, Response, or Promise<any>\n */\nexport interface ResultExtractor {\n  (\n    exchange: FetchExchange,\n  ):\n    | FetchExchange\n    | Response\n    | Promise<any>\n    | ServerSentEventStream\n    | JsonServerSentEventStream<any>;\n}\n\n/**\n * Interface with result extractor capability\n * Defines an optional resultExtractor property\n */\nexport interface ResultExtractorCapable {\n  resultExtractor?: ResultExtractor;\n}\n\n/**\n * Returns the original FetchExchange object\n * @param exchange - FetchExchange object\n * @returns The original FetchExchange object\n */\nexport const ExchangeResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange;\n};\n\n/**\n * Returns the response object from FetchExchange\n * @param exchange - FetchExchange object\n * @returns The response object from FetchExchange\n */\nexport const ResponseResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse;\n};\n\n/**\n * Parses the response content as JSON format\n * @param exchange - FetchExchange object\n * @returns Promise of parsed JSON data\n */\nexport const JsonResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.json();\n};\n\n/**\n * Parses the response content as text format\n * @param exchange - FetchExchange object\n * @returns Promise of parsed text data\n */\nexport const TextResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.text();\n};\n\n/**\n * ServerSentEventStream result extractor, used to extract server-sent event stream from FetchExchange\n *\n * @param exchange - FetchExchange object containing request and response information\n * @returns Readable stream object of server-sent event stream\n * @throws ExchangeError exception when server does not support ServerSentEventStream\n */\nexport const EventStreamResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  // Check if response supports event stream, throw exception if not supported\n  if (!exchange.requiredResponse.eventStream) {\n    throw new ExchangeError(exchange, 'ServerSentEventStream is not supported');\n  }\n  // Return the event stream\n  return exchange.requiredResponse.eventStream()!;\n};\n\n/**\n * JsonServerSentEventStream result extractor, used to extract JSON server-sent event stream from FetchExchange\n *\n * @param exchange - FetchExchange object containing request and response information\n * @returns Readable stream object of JSON server-sent event stream\n * @throws ExchangeError exception when server does not support JsonServerSentEventStream\n */\nexport const JsonEventStreamResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  // Check if response supports event stream, throw exception if not supported\n  if (!exchange.requiredResponse.jsonEventStream) {\n    throw new ExchangeError(\n      exchange,\n      'JsonServerSentEventStream is not supported',\n    );\n  }\n  // Return the event stream\n  return exchange.requiredResponse.jsonEventStream()!;\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 { 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 */\nimport {\n  combineURLs,\n  fetcher,\n  Fetcher,\n  FetchExchange,\n  FetchRequest,\n  FetchRequestInit,\n  mergeRequest,\n  NamedCapable,\n  RequestHeaders,\n  UrlParams,\n} from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport { EndpointMetadata, PathCapable } from './endpointDecorator';\nimport {\n  ParameterMetadata,\n  ParameterRequest,\n  ParameterType,\n} from './parameterDecorator';\nimport { ResultExtractor, ResultExtractors } from './resultExtractor';\nimport { ServerSentEventStream } from '@ahoo-wang/fetcher-eventstream';\nimport { getFetcher } from './fetcherCapable';\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 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  resolveRequest(args: any[]): FetchRequest {\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 parameterRequest: ParameterRequest = {};\n    // Process parameters based on their decorators\n    args.forEach((value, index) => {\n      if (value instanceof AbortSignal) {\n        signal = 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      }\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    };\n    const mergedRequest = mergeRequest(\n      endpointRequest,\n      parameterRequest,\n    ) as any;\n    const parameterPath = parameterRequest.path;\n    mergedRequest.url = this.resolvePath(parameterPath);\n    return mergedRequest;\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    return value as ParameterRequest;\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 {\n    return (\n      this.endpoint.resultExtractor ||\n      this.api.resultExtractor ||\n      ResultExtractors.DEFAULT\n    );\n  }\n}\n\nconst TARGET_FETCHER_PROPERTY = 'fetcher';\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   *\n   * @param target - The target object that the method is called on\n   * @param args - The runtime arguments passed to the method\n   * @returns A Promise that resolves to the Response\n   */\n  async execute(\n    target: any,\n    args: any[],\n  ): Promise<FetchExchange | Response | any | ServerSentEventStream> {\n    const fetcher = this.getTargetFetcher(target) || this.metadata.fetcher;\n    const request = this.metadata.resolveRequest(args);\n    const exchange = await fetcher.request(request);\n    const extractor = this.metadata.resolveResultExtractor();\n    return extractor(exchange);\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  Fetcher,\n  RequestHeaders,\n  RequestHeadersCapable,\n  TimeoutCapable,\n} from '@ahoo-wang/fetcher';\nimport { ENDPOINT_METADATA_KEY } from './endpointDecorator';\nimport { FunctionMetadata, RequestExecutor } from './requestExecutor';\nimport { PARAMETER_METADATA_KEY } from './parameterDecorator';\nimport 'reflect-metadata';\nimport { ResultExtractorCapable } from './resultExtractor';\nimport { FetcherCapable } from './fetcherCapable';\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 {\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","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","ExchangeResultExtractor","exchange","ResponseResultExtractor","JsonResultExtractor","TextResultExtractor","EventStreamResultExtractor","ExchangeError","JsonEventStreamResultExtractor","ResultExtractors","getFetcher","fetcher","Fetcher","fetcherRegistrar","FunctionMetadata","api","parameters","args","pathParams","queryParams","headers","signal","parameterRequest","value","index","funParameter","urlParams","endpointRequest","mergedRequest","mergeRequest","parameterPath","basePath","endpointPath","combineURLs","TARGET_FETCHER_PROPERTY","RequestExecutor","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/reflection.ts","../src/parameterDecorator.ts","../src/resultExtractor.ts","../src/fetcherCapable.ts","../src/requestExecutor.ts","../src/apiDecorator.ts","../src/generated.ts"],"sourcesContent":["import { HttpMethod } from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport 'reflect-metadata';\nimport { ResultExtractor, 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 */\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 { PathCapable } from './endpointDecorator';\nimport { 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 * 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 * 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 { FetchExchange } from '@ahoo-wang/fetcher';\nimport {\n  JsonServerSentEventStream,\n  ServerSentEventStream,\n} from '@ahoo-wang/fetcher-eventstream';\n\n/**\n * Result extractor interface\n * Defines a function type for extracting results from a FetchExchange\n * @param exchange - FetchExchange object containing request and response information\n * @returns Returns a value of type FetchExchange, Response, or Promise<any>\n */\nexport interface ResultExtractor {\n  (\n    exchange: FetchExchange,\n  ):\n    | FetchExchange\n    | Response\n    | Promise<any>\n    | ServerSentEventStream\n    | JsonServerSentEventStream<any>;\n}\n\n/**\n * Interface with result extractor capability\n * Defines an optional resultExtractor property\n */\nexport interface ResultExtractorCapable {\n  resultExtractor?: ResultExtractor;\n}\n\n/**\n * Returns the original FetchExchange object\n * @param exchange - FetchExchange object\n * @returns The original FetchExchange object\n */\nexport const ExchangeResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange;\n};\n\n/**\n * Returns the response object from FetchExchange\n * @param exchange - FetchExchange object\n * @returns The response object from FetchExchange\n */\nexport const ResponseResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse;\n};\n\n/**\n * Parses the response content as JSON format\n * @param exchange - FetchExchange object\n * @returns Promise of parsed JSON data\n */\nexport const JsonResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.json();\n};\n\n/**\n * Parses the response content as text format\n * @param exchange - FetchExchange object\n * @returns Promise of parsed text data\n */\nexport const TextResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.text();\n};\n\n/**\n * ServerSentEventStream result extractor, used to extract server-sent event stream from FetchExchange\n *\n * @param exchange - FetchExchange object containing request and response information\n * @returns Readable stream object of server-sent event stream\n * @throws ExchangeError exception when server does not support ServerSentEventStream\n */\nexport const EventStreamResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.requiredEventStream();\n};\n\n/**\n * JsonServerSentEventStream result extractor, used to extract JSON server-sent event stream from FetchExchange\n *\n * @param exchange - FetchExchange object containing request and response information\n * @returns Readable stream object of JSON server-sent event stream\n * @throws ExchangeError exception when server does not support JsonServerSentEventStream\n */\nexport const JsonEventStreamResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.requiredJsonEventStream();\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 { 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 */\nimport {\n  combineURLs,\n  fetcher,\n  Fetcher,\n  FetchExchange,\n  FetchRequest,\n  FetchRequestInit,\n  mergeRequest,\n  NamedCapable,\n  RequestHeaders,\n  UrlParams,\n} from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport { EndpointMetadata, PathCapable } from './endpointDecorator';\nimport {\n  ParameterMetadata,\n  ParameterRequest,\n  ParameterType,\n} from './parameterDecorator';\nimport { ResultExtractor, ResultExtractors } from './resultExtractor';\nimport { ServerSentEventStream } from '@ahoo-wang/fetcher-eventstream';\nimport { getFetcher } from './fetcherCapable';\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 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  resolveRequest(args: any[]): FetchRequest {\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 parameterRequest: ParameterRequest = {};\n    // Process parameters based on their decorators\n    args.forEach((value, index) => {\n      if (value instanceof AbortSignal) {\n        signal = 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      }\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    };\n    const mergedRequest = mergeRequest(\n      endpointRequest,\n      parameterRequest,\n    ) as any;\n    const parameterPath = parameterRequest.path;\n    mergedRequest.url = this.resolvePath(parameterPath);\n    return mergedRequest;\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    return value as ParameterRequest;\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 {\n    return (\n      this.endpoint.resultExtractor ||\n      this.api.resultExtractor ||\n      ResultExtractors.DEFAULT\n    );\n  }\n}\n\nconst TARGET_FETCHER_PROPERTY = 'fetcher';\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   *\n   * @param target - The target object that the method is called on\n   * @param args - The runtime arguments passed to the method\n   * @returns A Promise that resolves to the Response\n   */\n  async execute(\n    target: any,\n    args: any[],\n  ): Promise<FetchExchange | Response | any | ServerSentEventStream> {\n    const fetcher = this.getTargetFetcher(target) || this.metadata.fetcher;\n    const request = this.metadata.resolveRequest(args);\n    const exchange = await fetcher.request(request);\n    const extractor = this.metadata.resolveResultExtractor();\n    return extractor(exchange);\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  Fetcher,\n  RequestHeaders,\n  RequestHeadersCapable,\n  TimeoutCapable,\n} from '@ahoo-wang/fetcher';\nimport { ENDPOINT_METADATA_KEY } from './endpointDecorator';\nimport { FunctionMetadata, RequestExecutor } from './requestExecutor';\nimport { PARAMETER_METADATA_KEY } from './parameterDecorator';\nimport 'reflect-metadata';\nimport { ResultExtractorCapable } from './resultExtractor';\nimport { FetcherCapable } from './fetcherCapable';\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 {\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","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","ExchangeResultExtractor","exchange","ResponseResultExtractor","JsonResultExtractor","TextResultExtractor","EventStreamResultExtractor","JsonEventStreamResultExtractor","ResultExtractors","getFetcher","fetcher","Fetcher","fetcherRegistrar","FunctionMetadata","api","parameters","args","pathParams","queryParams","headers","signal","parameterRequest","value","index","funParameter","urlParams","endpointRequest","mergedRequest","mergeRequest","parameterPath","basePath","endpointPath","combineURLs","TARGET_FETCHER_PROPERTY","RequestExecutor","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(r,s){typeof exports=="object"&&typeof module<"u"?s(exports,require("@ahoo-wang/fetcher"),require("reflect-metadata")):typeof define=="function"&&define.amd?define(["exports","@ahoo-wang/fetcher","reflect-metadata"],s):(r=typeof globalThis<"u"?globalThis:r||self,s(r.FetcherDecorator={},r.Fetcher))})(this,(function(r,s){"use strict";const R=Symbol("endpoint:metadata");function u(t,e,n={}){return function(a,o){const i={method:t,path:e,...n};Reflect.defineMetadata(R,i,a,o)}}function N(t="",e={}){return u(s.HttpMethod.GET,t,e)}function Y(t="",e={}){return u(s.HttpMethod.POST,t,e)}function G(t="",e={}){return u(s.HttpMethod.PUT,t,e)}function I(t="",e={}){return u(s.HttpMethod.DELETE,t,e)}function U(t="",e={}){return u(s.HttpMethod.PATCH,t,e)}function j(t="",e={}){return u(s.HttpMethod.HEAD,t,e)}function J(t="",e={}){return u(s.HttpMethod.OPTIONS,t,e)}const f=new WeakMap;function g(t){if(typeof t!="function")throw new TypeError("Expected a function");if(f.has(t))return f.get(t);try{const e=t.toString().trim(),n=Q(e);if(!k(n)){const o=[];return f.set(t,o),o}const a=C(n);return f.set(t,a),a}catch{const e=[];return f.set(t,e),e}}function A(t,e,n,a){if(a)return a;try{const o=t[e];if(o&&typeof o=="function"){const i=g(o);if(n<i.length)return i[n]}}catch{}}function k(t){return t!=null&&t.trim()!==""}function Q(t){if(t.startsWith("(")){const a=q(t,0);return a===-1?"":t.substring(1,a)}const e=t.indexOf("(");if(e===-1)return"";const n=q(t,e);return n===-1?"":t.substring(e+1,n)}function q(t,e){let n=1;for(let a=e+1;a<t.length;a++){const o=t[a];if(o==="(")n++;else if(o===")"&&(n--,n===0))return a}return-1}function C(t){return t.split(",").map(K).filter(L).map(W)}function K(t){return t.trim()}function L(t){return t.length>0}function W(t){let e=B(t);return e=V(e),e.trim()}function B(t){const e=t.indexOf("=");return e!==-1?t.substring(0,e):t}function V(t){const e=t.indexOf(":");return e!==-1?t.substring(0,e):t}var d=(t=>(t.PATH="path",t.QUERY="query",t.HEADER="header",t.BODY="body",t.REQUEST="request",t))(d||{});const l=Symbol("parameter:metadata");function E(t,e=""){return function(n,a,o){const i=A(n,a,o,e),c=Reflect.getMetadata(l,n,a)||new Map,h={type:t,name:i,index:o};c.set(o,h),Reflect.defineMetadata(l,c,n,a)}}function z(t=""){return E("path",t)}function X(t=""){return E("query",t)}function Z(t=""){return E("header",t)}function $(){return E("body")}function tt(){return E("request")}const M=t=>t,y=t=>t.requiredResponse,P=t=>t.requiredResponse.json(),b=t=>t.requiredResponse.text(),v=t=>{if(!t.requiredResponse.eventStream)throw new s.ExchangeError(t,"ServerSentEventStream is not supported");return t.requiredResponse.eventStream()},S=t=>{if(!t.requiredResponse.jsonEventStream)throw new s.ExchangeError(t,"JsonServerSentEventStream is not supported");return t.requiredResponse.jsonEventStream()},D={Exchange:M,Response:y,Json:P,Text:b,EventStream:v,JsonEventStream:S,DEFAULT:P};function w(t){if(t)return t instanceof s.Fetcher?t:s.fetcherRegistrar.requiredGet(t)}class H{constructor(e,n,a,o){this.name=e,this.api=n,this.endpoint=a,this.parameters=o}get fetcher(){return w(this.endpoint.fetcher??this.api.fetcher)??s.fetcher}resolveRequest(e){const n={},a={},o={...this.api.headers,...this.endpoint.headers};let i,c,h={};e.forEach((m,it)=>{if(m instanceof AbortSignal){c=m;return}const p=this.parameters.get(it);if(p)switch(p.type){case d.PATH:this.processPathParam(p,m,n);break;case d.QUERY:this.processQueryParam(p,m,a);break;case d.HEADER:this.processHeaderParam(p,m,o);break;case d.BODY:i=m;break;case d.REQUEST:h=this.processRequestParam(m);break}});const T={path:n,query:a},ot={method:this.endpoint.method,urlParams:T,headers:o,body:i,timeout:this.resolveTimeout(),signal:c},O=s.mergeRequest(ot,h),st=h.path;return O.url=this.resolvePath(st),O}processPathParam(e,n,a){const o=e.name||`param${e.index}`;a[o]=n}processQueryParam(e,n,a){const o=e.name||`param${e.index}`;a[o]=n}processHeaderParam(e,n,a){e.name&&n!==void 0&&(a[e.name]=String(n))}processRequestParam(e){return e}resolvePath(e){const n=this.endpoint.basePath||this.api.basePath||"",a=e||this.endpoint.path||"";return s.combineURLs(n,a)}resolveTimeout(){return this.endpoint.timeout||this.api.timeout}resolveResultExtractor(){return this.endpoint.resultExtractor||this.api.resultExtractor||D.DEFAULT}}const et="fetcher";class x{constructor(e){this.metadata=e}getTargetFetcher(e){if(!e||typeof e!="object")return;const n=e[et];if(n instanceof s.Fetcher)return n}async execute(e,n){const a=this.getTargetFetcher(e)||this.metadata.fetcher,o=this.metadata.resolveRequest(n),i=await a.request(o);return this.metadata.resolveResultExtractor()(i)}}const _=Symbol("api:metadata");function nt(t,e,n){const a=t.prototype[e];if(e==="constructor"||typeof a!="function")return;const o=Reflect.getMetadata(R,t.prototype,e);if(!o)return;const i=Reflect.getMetadata(l,t.prototype,e)||new Map,c=new H(e,n,o,i),h=new x(c);t.prototype[e]=function(...T){return h.execute(this,T)}}function rt(t="",e={}){return function(n){const a={basePath:t,...e};return Reflect.defineMetadata(_,a,n),Object.getOwnPropertyNames(n.prototype).forEach(o=>{nt(n,o,a)}),n}}class F extends Error{constructor(){super("Implementation will be generated automatically."),this.name="AutoGenerated"}}const at=(...t)=>new F;r.API_METADATA_KEY=_,r.AutoGenerated=F,r.ENDPOINT_METADATA_KEY=R,r.EventStreamResultExtractor=v,r.ExchangeResultExtractor=M,r.FunctionMetadata=H,r.JsonEventStreamResultExtractor=S,r.JsonResultExtractor=P,r.PARAMETER_METADATA_KEY=l,r.ParameterType=d,r.RequestExecutor=x,r.ResponseResultExtractor=y,r.ResultExtractors=D,r.TextResultExtractor=b,r.api=rt,r.autoGeneratedError=at,r.body=$,r.del=I,r.endpoint=u,r.get=N,r.getFetcher=w,r.getParameterName=A,r.getParameterNames=g,r.head=j,r.header=Z,r.options=J,r.parameter=E,r.patch=U,r.path=z,r.post=Y,r.put=G,r.query=X,r.request=tt,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})}));
+(function(r,s){typeof exports=="object"&&typeof module<"u"?s(exports,require("@ahoo-wang/fetcher"),require("reflect-metadata")):typeof define=="function"&&define.amd?define(["exports","@ahoo-wang/fetcher","reflect-metadata"],s):(r=typeof globalThis<"u"?globalThis:r||self,s(r.FetcherDecorator={},r.Fetcher))})(this,(function(r,s){"use strict";const R=Symbol("endpoint:metadata");function u(t,e,n={}){return function(a,o){const i={method:t,path:e,...n};Reflect.defineMetadata(R,i,a,o)}}function N(t="",e={}){return u(s.HttpMethod.GET,t,e)}function Y(t="",e={}){return u(s.HttpMethod.POST,t,e)}function G(t="",e={}){return u(s.HttpMethod.PUT,t,e)}function I(t="",e={}){return u(s.HttpMethod.DELETE,t,e)}function U(t="",e={}){return u(s.HttpMethod.PATCH,t,e)}function J(t="",e={}){return u(s.HttpMethod.HEAD,t,e)}function k(t="",e={}){return u(s.HttpMethod.OPTIONS,t,e)}const E=new WeakMap;function T(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(),n=j(e);if(!Q(n)){const o=[];return E.set(t,o),o}const a=C(n);return E.set(t,a),a}catch{const e=[];return E.set(t,e),e}}function A(t,e,n,a){if(a)return a;try{const o=t[e];if(o&&typeof o=="function"){const i=T(o);if(n<i.length)return i[n]}}catch{}}function Q(t){return t!=null&&t.trim()!==""}function j(t){if(t.startsWith("(")){const a=q(t,0);return a===-1?"":t.substring(1,a)}const e=t.indexOf("(");if(e===-1)return"";const n=q(t,e);return n===-1?"":t.substring(e+1,n)}function q(t,e){let n=1;for(let a=e+1;a<t.length;a++){const o=t[a];if(o==="(")n++;else if(o===")"&&(n--,n===0))return a}return-1}function C(t){return t.split(",").map(K).filter(L).map(W)}function K(t){return t.trim()}function L(t){return t.length>0}function W(t){let e=B(t);return e=V(e),e.trim()}function B(t){const e=t.indexOf("=");return e!==-1?t.substring(0,e):t}function V(t){const e=t.indexOf(":");return e!==-1?t.substring(0,e):t}var d=(t=>(t.PATH="path",t.QUERY="query",t.HEADER="header",t.BODY="body",t.REQUEST="request",t))(d||{});const p=Symbol("parameter:metadata");function f(t,e=""){return function(n,a,o){const i=A(n,a,o,e),c=Reflect.getMetadata(p,n,a)||new Map,h={type:t,name:i,index:o};c.set(o,h),Reflect.defineMetadata(p,c,n,a)}}function z(t=""){return f("path",t)}function X(t=""){return f("query",t)}function Z(t=""){return f("header",t)}function $(){return f("body")}function tt(){return f("request")}const M=t=>t,y=t=>t.requiredResponse,P=t=>t.requiredResponse.json(),b=t=>t.requiredResponse.text(),v=t=>t.requiredResponse.requiredEventStream(),D=t=>t.requiredResponse.requiredJsonEventStream(),x={Exchange:M,Response:y,Json:P,Text:b,EventStream:v,JsonEventStream:D,DEFAULT:P};function H(t){if(t)return t instanceof s.Fetcher?t:s.fetcherRegistrar.requiredGet(t)}class S{constructor(e,n,a,o){this.name=e,this.api=n,this.endpoint=a,this.parameters=o}get fetcher(){return H(this.endpoint.fetcher??this.api.fetcher)??s.fetcher}resolveRequest(e){const n={},a={},o={...this.api.headers,...this.endpoint.headers};let i,c,h={};e.forEach((m,it)=>{if(m instanceof AbortSignal){c=m;return}const l=this.parameters.get(it);if(l)switch(l.type){case d.PATH:this.processPathParam(l,m,n);break;case d.QUERY:this.processQueryParam(l,m,a);break;case d.HEADER:this.processHeaderParam(l,m,o);break;case d.BODY:i=m;break;case d.REQUEST:h=this.processRequestParam(m);break}});const g={path:n,query:a},ot={method:this.endpoint.method,urlParams:g,headers:o,body:i,timeout:this.resolveTimeout(),signal:c},O=s.mergeRequest(ot,h),st=h.path;return O.url=this.resolvePath(st),O}processPathParam(e,n,a){const o=e.name||`param${e.index}`;a[o]=n}processQueryParam(e,n,a){const o=e.name||`param${e.index}`;a[o]=n}processHeaderParam(e,n,a){e.name&&n!==void 0&&(a[e.name]=String(n))}processRequestParam(e){return e}resolvePath(e){const n=this.endpoint.basePath||this.api.basePath||"",a=e||this.endpoint.path||"";return s.combineURLs(n,a)}resolveTimeout(){return this.endpoint.timeout||this.api.timeout}resolveResultExtractor(){return this.endpoint.resultExtractor||this.api.resultExtractor||x.DEFAULT}}const et="fetcher";class _{constructor(e){this.metadata=e}getTargetFetcher(e){if(!e||typeof e!="object")return;const n=e[et];if(n instanceof s.Fetcher)return n}async execute(e,n){const a=this.getTargetFetcher(e)||this.metadata.fetcher,o=this.metadata.resolveRequest(n),i=await a.request(o);return this.metadata.resolveResultExtractor()(i)}}const w=Symbol("api:metadata");function nt(t,e,n){const a=t.prototype[e];if(e==="constructor"||typeof a!="function")return;const o=Reflect.getMetadata(R,t.prototype,e);if(!o)return;const i=Reflect.getMetadata(p,t.prototype,e)||new Map,c=new S(e,n,o,i),h=new _(c);t.prototype[e]=function(...g){return h.execute(this,g)}}function rt(t="",e={}){return function(n){const a={basePath:t,...e};return Reflect.defineMetadata(w,a,n),Object.getOwnPropertyNames(n.prototype).forEach(o=>{nt(n,o,a)}),n}}class F extends Error{constructor(){super("Implementation will be generated automatically."),this.name="AutoGenerated"}}const at=(...t)=>new F;r.API_METADATA_KEY=w,r.AutoGenerated=F,r.ENDPOINT_METADATA_KEY=R,r.EventStreamResultExtractor=v,r.ExchangeResultExtractor=M,r.FunctionMetadata=S,r.JsonEventStreamResultExtractor=D,r.JsonResultExtractor=P,r.PARAMETER_METADATA_KEY=p,r.ParameterType=d,r.RequestExecutor=_,r.ResponseResultExtractor=y,r.ResultExtractors=x,r.TextResultExtractor=b,r.api=rt,r.autoGeneratedError=at,r.body=$,r.del=I,r.endpoint=u,r.get=N,r.getFetcher=H,r.getParameterName=A,r.getParameterNames=T,r.head=J,r.header=Z,r.options=k,r.parameter=f,r.patch=U,r.path=z,r.post=Y,r.put=G,r.query=X,r.request=tt,Object.defineProperty(r,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/reflection.ts","../src/parameterDecorator.ts","../src/resultExtractor.ts","../src/fetcherCapable.ts","../src/requestExecutor.ts","../src/apiDecorator.ts","../src/generated.ts"],"sourcesContent":["import { HttpMethod } from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport 'reflect-metadata';\nimport { ResultExtractor, 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 */\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 { PathCapable } from './endpointDecorator';\nimport { 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 * 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 * 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 { ExchangeError, FetchExchange } from '@ahoo-wang/fetcher';\nimport {\n  JsonServerSentEventStream,\n  ServerSentEventStream,\n} from '@ahoo-wang/fetcher-eventstream';\n\n/**\n * Result extractor interface\n * Defines a function type for extracting results from a FetchExchange\n * @param exchange - FetchExchange object containing request and response information\n * @returns Returns a value of type FetchExchange, Response, or Promise<any>\n */\nexport interface ResultExtractor {\n  (\n    exchange: FetchExchange,\n  ):\n    | FetchExchange\n    | Response\n    | Promise<any>\n    | ServerSentEventStream\n    | JsonServerSentEventStream<any>;\n}\n\n/**\n * Interface with result extractor capability\n * Defines an optional resultExtractor property\n */\nexport interface ResultExtractorCapable {\n  resultExtractor?: ResultExtractor;\n}\n\n/**\n * Returns the original FetchExchange object\n * @param exchange - FetchExchange object\n * @returns The original FetchExchange object\n */\nexport const ExchangeResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange;\n};\n\n/**\n * Returns the response object from FetchExchange\n * @param exchange - FetchExchange object\n * @returns The response object from FetchExchange\n */\nexport const ResponseResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse;\n};\n\n/**\n * Parses the response content as JSON format\n * @param exchange - FetchExchange object\n * @returns Promise of parsed JSON data\n */\nexport const JsonResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.json();\n};\n\n/**\n * Parses the response content as text format\n * @param exchange - FetchExchange object\n * @returns Promise of parsed text data\n */\nexport const TextResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.text();\n};\n\n/**\n * ServerSentEventStream result extractor, used to extract server-sent event stream from FetchExchange\n *\n * @param exchange - FetchExchange object containing request and response information\n * @returns Readable stream object of server-sent event stream\n * @throws ExchangeError exception when server does not support ServerSentEventStream\n */\nexport const EventStreamResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  // Check if response supports event stream, throw exception if not supported\n  if (!exchange.requiredResponse.eventStream) {\n    throw new ExchangeError(exchange, 'ServerSentEventStream is not supported');\n  }\n  // Return the event stream\n  return exchange.requiredResponse.eventStream()!;\n};\n\n/**\n * JsonServerSentEventStream result extractor, used to extract JSON server-sent event stream from FetchExchange\n *\n * @param exchange - FetchExchange object containing request and response information\n * @returns Readable stream object of JSON server-sent event stream\n * @throws ExchangeError exception when server does not support JsonServerSentEventStream\n */\nexport const JsonEventStreamResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  // Check if response supports event stream, throw exception if not supported\n  if (!exchange.requiredResponse.jsonEventStream) {\n    throw new ExchangeError(\n      exchange,\n      'JsonServerSentEventStream is not supported',\n    );\n  }\n  // Return the event stream\n  return exchange.requiredResponse.jsonEventStream()!;\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 { 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 */\nimport {\n  combineURLs,\n  fetcher,\n  Fetcher,\n  FetchExchange,\n  FetchRequest,\n  FetchRequestInit,\n  mergeRequest,\n  NamedCapable,\n  RequestHeaders,\n  UrlParams,\n} from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport { EndpointMetadata, PathCapable } from './endpointDecorator';\nimport {\n  ParameterMetadata,\n  ParameterRequest,\n  ParameterType,\n} from './parameterDecorator';\nimport { ResultExtractor, ResultExtractors } from './resultExtractor';\nimport { ServerSentEventStream } from '@ahoo-wang/fetcher-eventstream';\nimport { getFetcher } from './fetcherCapable';\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 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  resolveRequest(args: any[]): FetchRequest {\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 parameterRequest: ParameterRequest = {};\n    // Process parameters based on their decorators\n    args.forEach((value, index) => {\n      if (value instanceof AbortSignal) {\n        signal = 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      }\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    };\n    const mergedRequest = mergeRequest(\n      endpointRequest,\n      parameterRequest,\n    ) as any;\n    const parameterPath = parameterRequest.path;\n    mergedRequest.url = this.resolvePath(parameterPath);\n    return mergedRequest;\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    return value as ParameterRequest;\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 {\n    return (\n      this.endpoint.resultExtractor ||\n      this.api.resultExtractor ||\n      ResultExtractors.DEFAULT\n    );\n  }\n}\n\nconst TARGET_FETCHER_PROPERTY = 'fetcher';\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   *\n   * @param target - The target object that the method is called on\n   * @param args - The runtime arguments passed to the method\n   * @returns A Promise that resolves to the Response\n   */\n  async execute(\n    target: any,\n    args: any[],\n  ): Promise<FetchExchange | Response | any | ServerSentEventStream> {\n    const fetcher = this.getTargetFetcher(target) || this.metadata.fetcher;\n    const request = this.metadata.resolveRequest(args);\n    const exchange = await fetcher.request(request);\n    const extractor = this.metadata.resolveResultExtractor();\n    return extractor(exchange);\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  Fetcher,\n  RequestHeaders,\n  RequestHeadersCapable,\n  TimeoutCapable,\n} from '@ahoo-wang/fetcher';\nimport { ENDPOINT_METADATA_KEY } from './endpointDecorator';\nimport { FunctionMetadata, RequestExecutor } from './requestExecutor';\nimport { PARAMETER_METADATA_KEY } from './parameterDecorator';\nimport 'reflect-metadata';\nimport { ResultExtractorCapable } from './resultExtractor';\nimport { FetcherCapable } from './fetcherCapable';\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 {\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","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","ExchangeResultExtractor","exchange","ResponseResultExtractor","JsonResultExtractor","TextResultExtractor","EventStreamResultExtractor","ExchangeError","JsonEventStreamResultExtractor","ResultExtractors","getFetcher","fetcher","Fetcher","fetcherRegistrar","FunctionMetadata","api","parameters","args","pathParams","queryParams","headers","signal","parameterRequest","value","index","funParameter","urlParams","endpointRequest","mergedRequest","mergeRequest","parameterPath","basePath","endpointPath","combineURLs","TARGET_FETCHER_PROPERTY","RequestExecutor","API_METADATA_KEY","bindExecutor","constructor","functionName","apiMetadata","endpointFunction","functionMetadata","requestExecutor","AutoGenerated","autoGeneratedError","_ignored"],"mappings":"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"}
+{"version":3,"file":"index.umd.js","sources":["../src/endpointDecorator.ts","../src/reflection.ts","../src/parameterDecorator.ts","../src/resultExtractor.ts","../src/fetcherCapable.ts","../src/requestExecutor.ts","../src/apiDecorator.ts","../src/generated.ts"],"sourcesContent":["import { HttpMethod } from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport 'reflect-metadata';\nimport { ResultExtractor, 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 */\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 { PathCapable } from './endpointDecorator';\nimport { 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 * 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 * 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 { FetchExchange } from '@ahoo-wang/fetcher';\nimport {\n  JsonServerSentEventStream,\n  ServerSentEventStream,\n} from '@ahoo-wang/fetcher-eventstream';\n\n/**\n * Result extractor interface\n * Defines a function type for extracting results from a FetchExchange\n * @param exchange - FetchExchange object containing request and response information\n * @returns Returns a value of type FetchExchange, Response, or Promise<any>\n */\nexport interface ResultExtractor {\n  (\n    exchange: FetchExchange,\n  ):\n    | FetchExchange\n    | Response\n    | Promise<any>\n    | ServerSentEventStream\n    | JsonServerSentEventStream<any>;\n}\n\n/**\n * Interface with result extractor capability\n * Defines an optional resultExtractor property\n */\nexport interface ResultExtractorCapable {\n  resultExtractor?: ResultExtractor;\n}\n\n/**\n * Returns the original FetchExchange object\n * @param exchange - FetchExchange object\n * @returns The original FetchExchange object\n */\nexport const ExchangeResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange;\n};\n\n/**\n * Returns the response object from FetchExchange\n * @param exchange - FetchExchange object\n * @returns The response object from FetchExchange\n */\nexport const ResponseResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse;\n};\n\n/**\n * Parses the response content as JSON format\n * @param exchange - FetchExchange object\n * @returns Promise of parsed JSON data\n */\nexport const JsonResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.json();\n};\n\n/**\n * Parses the response content as text format\n * @param exchange - FetchExchange object\n * @returns Promise of parsed text data\n */\nexport const TextResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.text();\n};\n\n/**\n * ServerSentEventStream result extractor, used to extract server-sent event stream from FetchExchange\n *\n * @param exchange - FetchExchange object containing request and response information\n * @returns Readable stream object of server-sent event stream\n * @throws ExchangeError exception when server does not support ServerSentEventStream\n */\nexport const EventStreamResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.requiredEventStream();\n};\n\n/**\n * JsonServerSentEventStream result extractor, used to extract JSON server-sent event stream from FetchExchange\n *\n * @param exchange - FetchExchange object containing request and response information\n * @returns Readable stream object of JSON server-sent event stream\n * @throws ExchangeError exception when server does not support JsonServerSentEventStream\n */\nexport const JsonEventStreamResultExtractor: ResultExtractor = (\n  exchange: FetchExchange,\n) => {\n  return exchange.requiredResponse.requiredJsonEventStream();\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 { 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 */\nimport {\n  combineURLs,\n  fetcher,\n  Fetcher,\n  FetchExchange,\n  FetchRequest,\n  FetchRequestInit,\n  mergeRequest,\n  NamedCapable,\n  RequestHeaders,\n  UrlParams,\n} from '@ahoo-wang/fetcher';\nimport { ApiMetadata } from './apiDecorator';\nimport { EndpointMetadata, PathCapable } from './endpointDecorator';\nimport {\n  ParameterMetadata,\n  ParameterRequest,\n  ParameterType,\n} from './parameterDecorator';\nimport { ResultExtractor, ResultExtractors } from './resultExtractor';\nimport { ServerSentEventStream } from '@ahoo-wang/fetcher-eventstream';\nimport { getFetcher } from './fetcherCapable';\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 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  resolveRequest(args: any[]): FetchRequest {\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 parameterRequest: ParameterRequest = {};\n    // Process parameters based on their decorators\n    args.forEach((value, index) => {\n      if (value instanceof AbortSignal) {\n        signal = 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      }\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    };\n    const mergedRequest = mergeRequest(\n      endpointRequest,\n      parameterRequest,\n    ) as any;\n    const parameterPath = parameterRequest.path;\n    mergedRequest.url = this.resolvePath(parameterPath);\n    return mergedRequest;\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    return value as ParameterRequest;\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 {\n    return (\n      this.endpoint.resultExtractor ||\n      this.api.resultExtractor ||\n      ResultExtractors.DEFAULT\n    );\n  }\n}\n\nconst TARGET_FETCHER_PROPERTY = 'fetcher';\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   *\n   * @param target - The target object that the method is called on\n   * @param args - The runtime arguments passed to the method\n   * @returns A Promise that resolves to the Response\n   */\n  async execute(\n    target: any,\n    args: any[],\n  ): Promise<FetchExchange | Response | any | ServerSentEventStream> {\n    const fetcher = this.getTargetFetcher(target) || this.metadata.fetcher;\n    const request = this.metadata.resolveRequest(args);\n    const exchange = await fetcher.request(request);\n    const extractor = this.metadata.resolveResultExtractor();\n    return extractor(exchange);\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  Fetcher,\n  RequestHeaders,\n  RequestHeadersCapable,\n  TimeoutCapable,\n} from '@ahoo-wang/fetcher';\nimport { ENDPOINT_METADATA_KEY } from './endpointDecorator';\nimport { FunctionMetadata, RequestExecutor } from './requestExecutor';\nimport { PARAMETER_METADATA_KEY } from './parameterDecorator';\nimport 'reflect-metadata';\nimport { ResultExtractorCapable } from './resultExtractor';\nimport { FetcherCapable } from './fetcherCapable';\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 {\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","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","ExchangeResultExtractor","exchange","ResponseResultExtractor","JsonResultExtractor","TextResultExtractor","EventStreamResultExtractor","JsonEventStreamResultExtractor","ResultExtractors","getFetcher","fetcher","Fetcher","fetcherRegistrar","FunctionMetadata","api","parameters","args","pathParams","queryParams","headers","signal","parameterRequest","value","index","funParameter","urlParams","endpointRequest","mergedRequest","mergeRequest","parameterPath","basePath","endpointPath","combineURLs","TARGET_FETCHER_PROPERTY","RequestExecutor","API_METADATA_KEY","bindExecutor","constructor","functionName","apiMetadata","endpointFunction","functionMetadata","requestExecutor","AutoGenerated","autoGeneratedError","_ignored"],"mappings":"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"}

package/dist/resultExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resultExtractor.d.ts","sourceRoot":"","sources":["../src/resultExtractor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAiB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,CACE,QAAQ,EAAE,aAAa,GAErB,aAAa,GACb,QAAQ,GACR,OAAO,CAAC,GAAG,CAAC,GACZ,qBAAqB,GACrB,yBAAyB,CAAC,GAAG,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAIrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAIrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAIjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAIjC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,eASxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,eAY5C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;CAQ5B,CAAC"}
+{"version":3,"file":"resultExtractor.d.ts","sourceRoot":"","sources":["../src/resultExtractor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,CACE,QAAQ,EAAE,aAAa,GAErB,aAAa,GACb,QAAQ,GACR,OAAO,CAAC,GAAG,CAAC,GACZ,qBAAqB,GACrB,yBAAyB,CAAC,GAAG,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAIrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAIrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAIjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAIjC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,eAIxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,eAI5C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;CAQ5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher-decorator",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "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.0.8",
-    "@ahoo-wang/fetcher-eventstream": "1.0.8"
+    "@ahoo-wang/fetcher-eventstream": "1.1.0",
+    "@ahoo-wang/fetcher": "1.1.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^3.2.4",