@jintianxiayu/http-client-decorator 0.1.2

package/README.md

@@ -0,0 +1,201 @@
+# @jintianxiayu/http-client-decorator
+
+基于装饰器的 HTTP 客户端框架，提供 RPC-like 调用体验。
+
+## 特性
+
+- 基于装饰器的声明式 HTTP 客户端定义
+- 支持 `@Get`、`@Post`、`@Put`、`@Delete`、`@Patch` 方法装饰器
+- 支持 `@Path`、`@Query`、`@Body`、`@Header` 参数装饰器
+- Koa 风格洋葱模型中间件机制
+- HTTP 4xx/5xx 错误自动抛出 `HttpError` 异常
+- 底层使用 axios，支持所有 axios 特性
+
+## 安装
+
+```bash
+npm install @jintianxiayu/http-client-decorator
+```
+
+## 快速开始
+
+### 定义 HTTP 客户端
+
+```typescript
+import {
+  HttpClient,
+  Get,
+  Post,
+  Path,
+  Query,
+  Body,
+  Header,
+} from '@jintianxiayu/http-client-decorator';
+
+@HttpClient({
+  baseURL: 'https://api.example.com',
+})
+class UserService {
+  @Get('/users/:id')
+  getUser(
+    @Path('id') id: string,
+    @Header('Authorization') token: string
+  ): Promise<User> {
+    // 实际不会调用，仅用于类型标注
+    return Promise.resolve({} as User);
+  }
+
+  @Post('/users')
+  createUser(@Body() dto: CreateUserDto): Promise<User> {
+    return Promise.resolve({} as User);
+  }
+
+  @Get('/users')
+  listUsers(
+    @Query('page') page: string,
+    @Query('size') size: string
+  ): Promise<User[]> {
+    return Promise.resolve([] as User[]);
+  }
+}
+```
+
+### 使用客户端
+
+```typescript
+const userService = new UserService();
+
+// GET https://api.example.com/users/123
+const user = await userService.getUser('123', 'Bearer xxx');
+
+// POST https://api.example.com/users
+const newUser = await userService.createUser({ name: 'John' });
+
+// GET https://api.example.com/users?page=1&size=10
+const users = await userService.listUsers('1', '10');
+```
+
+## 中间件
+
+### 定义中间件
+
+```typescript
+import type { Middleware, HttpContext } from '@jintianxiayu/http-client-decorator';
+
+const authMiddleware: Middleware = async (ctx: HttpContext, next) => {
+  // 请求前处理
+  ctx.request.headers['Authorization'] = `Bearer ${getToken()}`;
+
+  await next(); // 调用下一个中间件
+
+  // 响应后处理
+  console.log(`Response status: ${ctx.response?.status}`);
+};
+```
+
+### 洋葱模型执行顺序
+
+```
+请求前: middlewareA.before → middlewareB.before
+       ↓
+    [HTTP 请求]
+       ↓
+响应后: middlewareB.after → middlewareA.after
+```
+
+### 使用中间件
+
+```typescript
+@HttpClient({
+  baseURL: 'https://api.example.com',
+  middlewares: [authMiddleware, logMiddleware],
+})
+class UserService {}
+```
+
+## 错误处理
+
+HTTP 4xx/5xx 响应会抛出 `HttpError` 异常：
+
+```typescript
+import { HttpError } from '@jintianxiayu/http-client-decorator';
+
+try {
+  await userService.getUser('not-found');
+} catch (e) {
+  if (e instanceof HttpError) {
+    console.error(`HTTP ${e.status}: ${e.message}`);
+    console.error('Response data:', e.data);
+  }
+}
+```
+
+## API 参考
+
+### 装饰器
+
+#### 类装饰器
+
+- `@HttpClient(config: HttpClientConfig)` - 标记并配置 HTTP 客户端类
+
+#### 方法装饰器
+
+- `@Get(path: string)` - GET 请求
+- `@Post(path: string)` - POST 请求
+- `@Put(path: string)` - PUT 请求
+- `@Delete(path: string)` - DELETE 请求
+- `@Patch(path: string)` - PATCH 请求
+
+#### 参数装饰器
+
+- `@Path(name: string)` - URL 路径参数
+- `@Query(name: string)` - URL 查询参数
+- `@Body()` - 请求体
+- `@Header(name: string)` - 请求头
+
+### 类型
+
+```typescript
+interface HttpClientConfig {
+  baseURL: string;
+  middlewares?: Middleware[];
+  timeout?: number;
+  headers?: Record<string, string>;
+}
+
+interface HttpContext {
+  request: {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: unknown;
+  };
+  response?: {
+    status: number;
+    headers: Record<string, string>;
+    data: unknown;
+  };
+  state: Record<string, unknown>;
+  error?: Error;
+}
+
+type Middleware = (
+  ctx: HttpContext,
+  next: () => Promise<void>
+) => Promise<void>;
+
+class HttpError extends Error {
+  constructor(
+    public status: number,
+    public data: unknown,
+    message: string
+  ) {
+    super(message);
+    this.name = 'HttpError';
+  }
+}
+```
+
+## License
+
+MIT

package/dist/core/http-client-config.d.ts

@@ -0,0 +1,18 @@
+import type { Middleware } from './middleware';
+/**
+ * HTTP 客户端配置接口
+ *
+ * 定义 HTTP 客户端的基础配置信息
+ *
+ * @param baseURL - 服务端基础地址
+ * @param middlewares - 中间件列表（可选）
+ * @param timeout - 请求超时时间（毫秒）
+ * @param headers - 默认请求头
+ */
+export interface HttpClientConfig {
+    baseURL: string;
+    middlewares?: Middleware[];
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+//# sourceMappingURL=http-client-config.d.ts.map

package/dist/core/http-client-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client-config.d.ts","sourceRoot":"","sources":["../../src/core/http-client-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}

package/dist/core/http-client-config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=http-client-config.js.map

package/dist/core/http-client-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client-config.js","sourceRoot":"","sources":["../../src/core/http-client-config.ts"],"names":[],"mappings":""}

package/dist/core/http-client.d.ts

@@ -0,0 +1,19 @@
+import type { HttpContext } from './middleware';
+/**
+ * 创建 HTTP 请求函数
+ *
+ * 根据配置创建发送 HTTP 请求的函数，内部处理错误转换和日志记录
+ *
+ * @param config - HTTP 客户端配置
+ * @returns 发送请求的函数
+ */
+export declare function createHttpRequest(config: Readonly<{
+    baseURL: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}>): (request: HttpContext["request"]) => Promise<{
+    status: number;
+    headers: Record<string, string>;
+    data: unknown;
+}>;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/core/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/core/http-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,QAAQ,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,IAGvF,SAAS,WAAW,CAAC,SAAS,CAAC,KAC9B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAmD/E"}

package/dist/core/http-client.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHttpRequest = createHttpRequest;
+const axios_1 = __importStar(require("axios"));
+const http_error_1 = require("./http-error");
+const logger_1 = require("@jintianxiayu/logger");
+const logger = logger_1.LoggerFactory.getLogger('@jintianxiayu/http-client-decorator');
+/**
+ * 创建 HTTP 请求函数
+ *
+ * 根据配置创建发送 HTTP 请求的函数，内部处理错误转换和日志记录
+ *
+ * @param config - HTTP 客户端配置
+ * @returns 发送请求的函数
+ */
+function createHttpRequest(config) {
+    return async function sendRequest(request) {
+        const axiosConfig = {
+            method: request.method,
+            url: request.url,
+            headers: request.headers,
+            data: request.body,
+            timeout: config.timeout,
+            validateStatus: () => true,
+        };
+        logger.debug(`HTTP ${request.method} ${request.url}`);
+        try {
+            const response = await (0, axios_1.default)(axiosConfig);
+            if (response.status >= 400) {
+                throw new http_error_1.HttpError(response.status, response.data, `HTTP ${response.status}: ${request.url}`);
+            }
+            const responseHeaders = {};
+            for (const [key, value] of Object.entries(response.headers)) {
+                if (typeof value === 'string') {
+                    responseHeaders[key] = value;
+                }
+            }
+            logger.debug(`HTTP ${response.status} ${request.url}`);
+            return {
+                status: response.status,
+                headers: responseHeaders,
+                data: response.data,
+            };
+        }
+        catch (error) {
+            if (error instanceof http_error_1.HttpError) {
+                throw error;
+            }
+            if (error instanceof axios_1.AxiosError) {
+                throw new http_error_1.HttpError(error.response?.status ?? 0, error.response?.data ?? error.message, error.message);
+            }
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=http-client.js.map

package/dist/core/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/core/http-client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,8CAwDC;AAvED,+CAAmE;AACnE,6CAAyC;AAEzC,iDAAqD;AAErD,MAAM,MAAM,GAAG,sBAAa,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAC/B,MAAyF;IAEzF,OAAO,KAAK,UAAU,WAAW,CAC/B,OAA+B;QAE/B,MAAM,WAAW,GAAuB;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI;SAC3B,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,QAAQ,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAEtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAA,eAAK,EAAC,WAAW,CAAC,CAAC;YAE1C,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC3B,MAAM,IAAI,sBAAS,CACjB,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,IAAI,EACb,QAAQ,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,GAAG,EAAE,CAC1C,CAAC;YACJ,CAAC;YAED,MAAM,eAAe,GAA2B,EAAE,CAAC;YACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAEvD,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,eAAe;gBACxB,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,sBAAS,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,KAAK,YAAY,kBAAU,EAAE,CAAC;gBAChC,MAAM,IAAI,sBAAS,CACjB,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,EAC3B,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,OAAO,EACrC,KAAK,CAAC,OAAO,CACd,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/http-context.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 导出 HttpContext 类型
+ */
+export type { HttpContext } from './middleware';
+//# sourceMappingURL=http-context.d.ts.map

package/dist/core/http-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-context.d.ts","sourceRoot":"","sources":["../../src/core/http-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/http-context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=http-context.js.map

package/dist/core/http-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-context.js","sourceRoot":"","sources":["../../src/core/http-context.ts"],"names":[],"mappings":""}

package/dist/core/http-error.d.ts

@@ -0,0 +1,15 @@
+/**
+ * HTTP 错误类
+ *
+ * 当 HTTP 请求返回 4xx 或 5xx 状态码时抛出此异常
+ *
+ * @param status - HTTP 状态码
+ * @param data - 响应数据
+ * @param message - 错误消息
+ */
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly data: unknown;
+    constructor(status: number, data: unknown, message: string);
+}
+//# sourceMappingURL=http-error.d.ts.map

package/dist/core/http-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error.d.ts","sourceRoot":"","sources":["../../src/core/http-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,SAAU,SAAQ,KAAK;aAEhB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,OAAO;gBADb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EAC7B,OAAO,EAAE,MAAM;CAKlB"}

package/dist/core/http-error.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = void 0;
+/**
+ * HTTP 错误类
+ *
+ * 当 HTTP 请求返回 4xx 或 5xx 状态码时抛出此异常
+ *
+ * @param status - HTTP 状态码
+ * @param data - 响应数据
+ * @param message - 错误消息
+ */
+class HttpError extends Error {
+    constructor(status, data, message) {
+        super(message);
+        this.status = status;
+        this.data = data;
+        this.name = 'HttpError';
+    }
+}
+exports.HttpError = HttpError;
+//# sourceMappingURL=http-error.js.map

package/dist/core/http-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error.js","sourceRoot":"","sources":["../../src/core/http-error.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,MAAa,SAAU,SAAQ,KAAK;IAClC,YACkB,MAAc,EACd,IAAa,EAC7B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAS;QAI7B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AATD,8BASC"}

package/dist/core/method-metadata.d.ts

@@ -0,0 +1,17 @@
+/**
+ * HTTP 方法类型定义
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+/**
+ * HTTP 方法元数据接口
+ *
+ * 存储方法装饰器标记的 HTTP 方法信息
+ *
+ * @param method - HTTP 方法类型
+ * @param path - 请求路径
+ */
+export interface MethodMetadata {
+    method: HttpMethod;
+    path: string;
+}
+//# sourceMappingURL=method-metadata.d.ts.map

package/dist/core/method-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-metadata.d.ts","sourceRoot":"","sources":["../../src/core/method-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/core/method-metadata.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=method-metadata.js.map

package/dist/core/method-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-metadata.js","sourceRoot":"","sources":["../../src/core/method-metadata.ts"],"names":[],"mappings":""}

package/dist/core/middleware-chain.d.ts

@@ -0,0 +1,3 @@
+import type { Middleware, HttpContext } from './middleware';
+export declare function executeMiddlewareChain(ctx: HttpContext, middlewares: Middleware[], finalHandler: () => Promise<void>): Promise<void>;
+//# sourceMappingURL=middleware-chain.d.ts.map

package/dist/core/middleware-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-chain.d.ts","sourceRoot":"","sources":["../../src/core/middleware-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5D,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,UAAU,EAAE,EACzB,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/core/middleware-chain.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeMiddlewareChain = executeMiddlewareChain;
+async function executeMiddlewareChain(ctx, middlewares, finalHandler) {
+    let index = 0;
+    const next = async () => {
+        if (index >= middlewares.length) {
+            await finalHandler();
+            return;
+        }
+        const middleware = middlewares[index];
+        index++;
+        if (middleware) {
+            await middleware(ctx, next);
+        }
+        else {
+            await finalHandler();
+        }
+    };
+    await next();
+}
+//# sourceMappingURL=middleware-chain.js.map

package/dist/core/middleware-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-chain.js","sourceRoot":"","sources":["../../src/core/middleware-chain.ts"],"names":[],"mappings":";;AAEA,wDAsBC;AAtBM,KAAK,UAAU,sBAAsB,CAC1C,GAAgB,EAChB,WAAyB,EACzB,YAAiC;IAEjC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,IAAI,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,YAAY,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,EAAE,CAAC;QACR,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,EAAE,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,EAAE,CAAC;AACf,CAAC"}

package/dist/core/middleware.d.ts

@@ -0,0 +1,63 @@
+/**
+ * HTTP 客户端配置接口
+ *
+ * 定义 HTTP 客户端的基础配置信息，包括服务端地址、中间件、超时设置等
+ *
+ * @param baseURL - 服务端基础地址
+ * @param middlewares - 中间件列表（可选），用于拦截请求/响应
+ * @param timeout - 请求超时时间（毫秒）
+ * @param headers - 默认请求头
+ */
+export interface HttpClientConfig {
+    baseURL: string;
+    middlewares?: readonly Middleware[];
+    timeout?: number;
+    headers?: Readonly<Record<string, string>>;
+}
+/**
+ * 中间件类型定义
+ *
+ * 采用 Koa 风格洋葱模型，支持请求前后的拦截处理
+ *
+ * @param ctx - HTTP 上下文，包含请求、响应、状态和错误信息
+ * @param next - 调用下一个中间件的函数
+ * @throws 当中间件执行出错时
+ */
+export type Middleware = (ctx: HttpContext, next: () => Promise<void>) => Promise<void>;
+/**
+ * HTTP 上下文接口
+ *
+ * 在中间件链中传递的请求/响应上下文对象
+ *
+ * @param request - 请求信息
+ * @param response - 响应信息（可选），在请求完成后填充
+ * @param state - 中间件间共享的状态对象
+ * @param error - 错误信息（可选），当请求失败时填充
+ */
+export interface HttpContext {
+    request: Readonly<{
+        method: string;
+        url: string;
+        headers: Readonly<Record<string, string>>;
+        body?: unknown;
+    }>;
+    response?: Readonly<{
+        status: number;
+        headers: Readonly<Record<string, string>>;
+        data: unknown;
+    }>;
+    state: Record<string, unknown>;
+    error?: Error;
+}
+/**
+ * 执行中间件链
+ *
+ * 按照洋葱模型顺序执行所有中间件，每个中间件在 next() 调用前后有特定的执行时机
+ *
+ * @param ctx - HTTP 上下文对象
+ * @param middlewares - 中间件列表
+ * @param finalHandler - 最终处理器（在所有中间件之后执行）
+ * @throws 当中间件执行出错时
+ */
+export declare function executeMiddlewareChain(ctx: HttpContext, middlewares: readonly Middleware[], finalHandler: () => Promise<void>): Promise<void>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/core/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/core/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,QAAQ,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1C,IAAI,EAAE,OAAO,CAAC;KACf,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/core/middleware.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeMiddlewareChain = executeMiddlewareChain;
+/**
+ * 执行中间件链
+ *
+ * 按照洋葱模型顺序执行所有中间件，每个中间件在 next() 调用前后有特定的执行时机
+ *
+ * @param ctx - HTTP 上下文对象
+ * @param middlewares - 中间件列表
+ * @param finalHandler - 最终处理器（在所有中间件之后执行）
+ * @throws 当中间件执行出错时
+ */
+async function executeMiddlewareChain(ctx, middlewares, finalHandler) {
+    let currentIndex = 0;
+    const next = async () => {
+        if (currentIndex >= middlewares.length) {
+            await finalHandler();
+            return;
+        }
+        const currentMiddleware = middlewares[currentIndex];
+        currentIndex++;
+        if (currentMiddleware) {
+            await currentMiddleware(ctx, next);
+        }
+        else {
+            await finalHandler();
+        }
+    };
+    await next();
+}
+//# sourceMappingURL=middleware.js.map

package/dist/core/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/core/middleware.ts"],"names":[],"mappings":";;AAmEA,wDAsBC;AAhCD;;;;;;;;;GASG;AACI,KAAK,UAAU,sBAAsB,CAC1C,GAAgB,EAChB,WAAkC,EAClC,YAAiC;IAEjC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,IAAI,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvC,MAAM,YAAY,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,iBAAiB,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QACpD,YAAY,EAAE,CAAC;QACf,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,EAAE,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,EAAE,CAAC;AACf,CAAC"}

package/dist/core/param-metadata.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 参数类型定义
+ */
+export type ParamType = 'path' | 'query' | 'body' | 'header';
+/**
+ * 参数元数据接口
+ *
+ * 存储参数装饰器标记的方法参数信息
+ *
+ * @param paramIndex - 参数在函数签名中的索引位置
+ * @param paramType - 参数类型（path/query/body/header）
+ * @param paramName - 参数名称（用于 path、query、header 类型）
+ */
+export interface ParamMetadata {
+    paramIndex: number;
+    paramType: ParamType;
+    paramName?: string;
+}
+//# sourceMappingURL=param-metadata.d.ts.map

package/dist/core/param-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-metadata.d.ts","sourceRoot":"","sources":["../../src/core/param-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/core/param-metadata.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=param-metadata.js.map

package/dist/core/param-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-metadata.js","sourceRoot":"","sources":["../../src/core/param-metadata.ts"],"names":[],"mappings":""}

package/dist/core/proxy-factory.d.ts

@@ -0,0 +1,12 @@
+import type { HttpClientConfig } from './http-client-config';
+/**
+ * 创建代理实例
+ *
+ * 使用 ES Proxy 包装目标对象，拦截所有方法调用
+ *
+ * @param target - 目标实例
+ * @param config - HTTP 客户端配置
+ * @returns 代理包装后的实例
+ */
+export declare function createProxyInstance<T extends object>(target: T, config: HttpClientConfig): T;
+//# sourceMappingURL=proxy-factory.d.ts.map

package/dist/core/proxy-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-factory.d.ts","sourceRoot":"","sources":["../../src/core/proxy-factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,gBAAgB,GACvB,CAAC,CAUH"}

package/dist/core/proxy-factory.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProxyInstance = createProxyInstance;
+const http_methods_1 = require("../decorators/http-methods");
+const params_1 = require("../decorators/params");
+const http_client_1 = require("./http-client");
+const middleware_1 = require("./middleware");
+/**
+ * 创建代理实例
+ *
+ * 使用 ES Proxy 包装目标对象，拦截所有方法调用
+ *
+ * @param target - 目标实例
+ * @param config - HTTP 客户端配置
+ * @returns 代理包装后的实例
+ */
+function createProxyInstance(target, config) {
+    return new Proxy(target, {
+        get(_targetProxy, prop, receiver) {
+            const methodMeta = (0, http_methods_1.getMethodMetadata)(target, prop);
+            if (methodMeta) {
+                return createHttpMethod(target, prop, methodMeta, config);
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+/**
+ * 创建 HTTP 方法处理函数
+ *
+ * 包装方法调用，执行参数映射、中间件链和 HTTP 请求
+ *
+ * @param instanceTarget - 实例目标对象
+ * @param propertyKey - 方法属性名
+ * @param methodMeta - 方法元数据
+ * @param config - HTTP 客户端配置
+ * @returns 异步方法函数
+ */
+function createHttpMethod(instanceTarget, propertyKey, methodMeta, config) {
+    return async function (...args) {
+        const paramMeta = (0, params_1.getParamMetadata)(instanceTarget, propertyKey);
+        const { url, body, headers } = buildRequestParts(paramMeta, args, methodMeta, config);
+        const middlewares = config.middlewares ?? [];
+        const httpClient = (0, http_client_1.createHttpRequest)(config);
+        const ctx = {
+            request: {
+                method: methodMeta.method,
+                url,
+                headers,
+                body,
+            },
+            state: {},
+        };
+        const handler = async () => {
+            const result = await httpClient(ctx.request);
+            ctx.response = result;
+        };
+        await (0, middleware_1.executeMiddlewareChain)(ctx, middlewares, handler);
+        return ctx.response?.data;
+    };
+}
+/**
+ * 构建请求组成部分
+ *
+ * 从参数元数据和方法参数中提取 URL、Body 和 Headers
+ *
+ * @param paramMeta - 参数元数据数组
+ * @param args - 方法实际参数
+ * @param methodMeta - 方法元数据
+ * @param config - HTTP 客户端配置
+ * @returns 请求的各部分数据
+ */
+function buildRequestParts(paramMeta, args, methodMeta, config) {
+    let path = methodMeta.path;
+    const query = {};
+    let body;
+    const headers = { ...config.headers };
+    for (const param of paramMeta) {
+        const value = args[param.paramIndex];
+        switch (param.paramType) {
+            case 'path':
+                path = path.replace(`:${param.paramName}`, String(value));
+                break;
+            case 'query':
+                if (param.paramName && value !== undefined) {
+                    query[param.paramName] = String(value);
+                }
+                break;
+            case 'body':
+                body = value;
+                break;
+            case 'header':
+                if (param.paramName && value !== undefined) {
+                    headers[param.paramName] = String(value);
+                }
+                break;
+        }
+    }
+    const url = buildUrl(config.baseURL, path, query);
+    return { url, body, headers };
+}
+/**
+ * 构建完整 URL
+ *
+ * 拼接 baseURL、path 和 query 参数
+ *
+ * @param baseURL - 基础地址
+ * @param path - 请求路径
+ * @param query - 查询参数对象
+ * @returns 完整的 URL 字符串
+ */
+function buildUrl(baseURL, path, query) {
+    const url = new URL(path, baseURL);
+    for (const [key, value] of Object.entries(query)) {
+        url.searchParams.set(key, value);
+    }
+    return url.toString();
+}
+//# sourceMappingURL=proxy-factory.js.map

package/dist/core/proxy-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-factory.js","sourceRoot":"","sources":["../../src/core/proxy-factory.ts"],"names":[],"mappings":"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"}

package/dist/decorators/http-client.d.ts

@@ -0,0 +1,19 @@
+import 'reflect-metadata';
+import type { HttpClientConfig } from '../core/http-client-config';
+/**
+ * HTTP 客户端类装饰器
+ *
+ * 标记一个类为 HTTP 客户端服务类，返回代理实例而非原实例
+ *
+ * @param config - HTTP 客户端配置
+ * @returns 类装饰器
+ */
+export declare function HttpClient(config: HttpClientConfig): <T extends new (...args: unknown[]) => object>(Target: T) => T;
+/**
+ * 获取类的 HTTP 客户端配置
+ *
+ * @param target - 目标类
+ * @returns HTTP 客户端配置（如果存在）
+ */
+export declare function getHttpClientConfig(target: object): HttpClientConfig | undefined;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/decorators/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/decorators/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAKnE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,IAChC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,EAC3D,QAAQ,CAAC,KACR,CAAC,CAeL;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GACb,gBAAgB,GAAG,SAAS,CAI9B"}

package/dist/decorators/http-client.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = HttpClient;
+exports.getHttpClientConfig = getHttpClientConfig;
+require("reflect-metadata");
+const proxy_factory_1 = require("../core/proxy-factory");
+const HTTP_CLIENT_CONFIG_KEY = Symbol.for('bics:http-client:config');
+/**
+ * HTTP 客户端类装饰器
+ *
+ * 标记一个类为 HTTP 客户端服务类，返回代理实例而非原实例
+ *
+ * @param config - HTTP 客户端配置
+ * @returns 类装饰器
+ */
+function HttpClient(config) {
+    return function (Target) {
+        Reflect.defineMetadata(HTTP_CLIENT_CONFIG_KEY, config, Target);
+        const DecoratedConstructor = function (...args) {
+            const instance = new Target(...args);
+            return (0, proxy_factory_1.createProxyInstance)(instance, config);
+        };
+        DecoratedConstructor.prototype = Target.prototype;
+        Object.setPrototypeOf(DecoratedConstructor, Target);
+        return DecoratedConstructor;
+    };
+}
+/**
+ * 获取类的 HTTP 客户端配置
+ *
+ * @param target - 目标类
+ * @returns HTTP 客户端配置（如果存在）
+ */
+function getHttpClientConfig(target) {
+    return Reflect.getMetadata(HTTP_CLIENT_CONFIG_KEY, target);
+}
+//# sourceMappingURL=http-client.js.map

package/dist/decorators/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/decorators/http-client.ts"],"names":[],"mappings":";;AAcA,gCAkBC;AAQD,kDAMC;AA9CD,4BAA0B;AAE1B,yDAA4D;AAE5D,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAErE;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,MAAwB;IACjD,OAAO,UACL,MAAS;QAET,OAAO,CAAC,cAAc,CAAC,sBAAsB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAE/D,MAAM,oBAAoB,GAAG,UAC3B,GAAG,IAAe;YAElB,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACrC,OAAO,IAAA,mCAAmB,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAiB,CAAC;QAElB,oBAAoB,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClD,MAAM,CAAC,cAAc,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QAEpD,OAAO,oBAAoB,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,MAAc;IAEd,OAAO,OAAO,CAAC,WAAW,CAAC,sBAAsB,EAAE,MAAM,CAE5C,CAAC;AAChB,CAAC"}

package/dist/decorators/http-methods.d.ts

@@ -0,0 +1,31 @@
+import 'reflect-metadata';
+import type { MethodMetadata } from '../core/method-metadata';
+/**
+ * GET 请求装饰器
+ */
+export declare const Get: (path: string) => (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/**
+ * POST 请求装饰器
+ */
+export declare const Post: (path: string) => (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/**
+ * PUT 请求装饰器
+ */
+export declare const Put: (path: string) => (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/**
+ * DELETE 请求装饰器
+ */
+export declare const Delete: (path: string) => (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/**
+ * PATCH 请求装饰器
+ */
+export declare const Patch: (path: string) => (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+/**
+ * 获取方法的 HTTP 元数据
+ *
+ * @param target - 目标对象
+ * @param propertyKey - 方法属性名
+ * @returns 方法元数据（如果存在）
+ */
+export declare function getMethodMetadata(target: object, propertyKey: string | symbol): MethodMetadata | undefined;
+//# sourceMappingURL=http-methods.d.ts.map

package/dist/decorators/http-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-methods.d.ts","sourceRoot":"","sources":["../../src/decorators/http-methods.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAwB1E;;GAEG;AACH,eAAO,MAAM,GAAG,SAhBS,MAAM,MAEzB,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAE5B,aAAa,kBAAkB,KAC9B,IAUwC,CAAC;AAChD;;GAEG;AACH,eAAO,MAAM,IAAI,SApBQ,MAAM,MAEzB,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAE5B,aAAa,kBAAkB,KAC9B,IAc0C,CAAC;AAClD;;GAEG;AACH,eAAO,MAAM,GAAG,SAxBS,MAAM,MAEzB,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAE5B,aAAa,kBAAkB,KAC9B,IAkBwC,CAAC;AAChD;;GAEG;AACH,eAAO,MAAM,MAAM,SA5BM,MAAM,MAEzB,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAE5B,aAAa,kBAAkB,KAC9B,IAsB8C,CAAC;AACtD;;GAEG;AACH,eAAO,MAAM,KAAK,SAhCO,MAAM,MAEzB,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAE5B,aAAa,kBAAkB,KAC9B,IA0B4C,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,cAAc,GAAG,SAAS,CAI5B"}

package/dist/decorators/http-methods.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Patch = exports.Delete = exports.Put = exports.Post = exports.Get = void 0;
+exports.getMethodMetadata = getMethodMetadata;
+require("reflect-metadata");
+const METHOD_METADATA_KEY = Symbol.for('bics:http-client:method');
+/**
+ * 创建 HTTP 方法装饰器
+ *
+ * @param method - HTTP 方法类型
+ * @returns 方法装饰器工厂函数
+ */
+function createMethodDecorator(method) {
+    return function (path) {
+        return function (target, propertyKey, 
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        _descriptor) {
+            const metadata = { method, path };
+            Reflect.defineMetadata(METHOD_METADATA_KEY, metadata, target, propertyKey);
+        };
+    };
+}
+/**
+ * GET 请求装饰器
+ */
+exports.Get = createMethodDecorator('GET');
+/**
+ * POST 请求装饰器
+ */
+exports.Post = createMethodDecorator('POST');
+/**
+ * PUT 请求装饰器
+ */
+exports.Put = createMethodDecorator('PUT');
+/**
+ * DELETE 请求装饰器
+ */
+exports.Delete = createMethodDecorator('DELETE');
+/**
+ * PATCH 请求装饰器
+ */
+exports.Patch = createMethodDecorator('PATCH');
+/**
+ * 获取方法的 HTTP 元数据
+ *
+ * @param target - 目标对象
+ * @param propertyKey - 方法属性名
+ * @returns 方法元数据（如果存在）
+ */
+function getMethodMetadata(target, propertyKey) {
+    return Reflect.getMetadata(METHOD_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=http-methods.js.map

package/dist/decorators/http-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-methods.js","sourceRoot":"","sources":["../../src/decorators/http-methods.ts"],"names":[],"mappings":";;;AAqDA,8CAOC;AA5DD,4BAA0B;AAG1B,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAElE;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,MAAkB;IAC/C,OAAO,UAAU,IAAY;QAC3B,OAAO,UACL,MAAc,EACd,WAA4B;QAC5B,6DAA6D;QAC7D,WAA+B;YAE/B,MAAM,QAAQ,GAAmB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YAClD,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7E,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACU,QAAA,GAAG,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAChD;;GAEG;AACU,QAAA,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAClD;;GAEG;AACU,QAAA,GAAG,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAChD;;GAEG;AACU,QAAA,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AACtD;;GAEG;AACU,QAAA,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,MAAc,EACd,WAA4B;IAE5B,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,EAAE,WAAW,CAEtD,CAAC;AAChB,CAAC"}

package/dist/decorators/params.d.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import type { ParamMetadata } from '../core/param-metadata';
+/**
+ * URL 路径参数装饰器
+ *
+ * @param paramName - 参数名称
+ */
+export declare const Path: (paramName: string) => (target: object, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * URL 查询参数装饰器
+ *
+ * @param paramName - 参数名称
+ */
+export declare const Query: (paramName: string) => (target: object, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * 请求体参数装饰器
+ */
+export declare const Body: () => (target: object, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * 请求头参数装饰器
+ *
+ * @param paramName - 参数名称
+ */
+export declare const Header: (paramName: string) => (target: object, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * 获取方法的参数元数据列表
+ *
+ * @param target - 目标对象
+ * @param propertyKey - 方法属性名
+ * @returns 参数元数据数组
+ */
+export declare function getParamMetadata(target: object, propertyKey: string | symbol): ParamMetadata[];
+//# sourceMappingURL=params.d.ts.map

package/dist/decorators/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/decorators/params.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,wBAAwB,CAAC;AA+BvE;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,WAAW,MAAM,cAvB1B,MAAM,eACD,MAAM,GAAG,MAAM,kBACZ,MAAM,KACrB,IAoB6E,CAAC;AACnF;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,WAAW,MAAM,cA7B3B,MAAM,eACD,MAAM,GAAG,MAAM,kBACZ,MAAM,KACrB,IA2BqC,CAAC;AAC3C;;GAEG;AACH,eAAO,MAAM,IAAI,iBAlCL,MAAM,eACD,MAAM,GAAG,MAAM,kBACZ,MAAM,KACrB,IA+BiD,CAAC;AACvD;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,WAAW,MAAM,cAxC5B,MAAM,eACD,MAAM,GAAG,MAAM,kBACZ,MAAM,KACrB,IAsCsC,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,aAAa,EAAE,CAKjB"}

package/dist/decorators/params.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Header = exports.Body = exports.Query = exports.Path = void 0;
+exports.getParamMetadata = getParamMetadata;
+require("reflect-metadata");
+const PARAM_METADATA_KEY = Symbol.for('bics:http-client:param');
+/**
+ * 创建参数装饰器
+ *
+ * @param paramType - 参数类型
+ * @param paramName - 参数名称（可选）
+ * @returns 参数装饰器工厂函数
+ */
+function createParamDecorator(paramType, paramName) {
+    return function (target, propertyKey, parameterIndex) {
+        const existing = Reflect.getMetadata(PARAM_METADATA_KEY, target, propertyKey) || [];
+        const metadata = {
+            paramIndex: parameterIndex,
+            paramType,
+            paramName,
+        };
+        existing.push(metadata);
+        Reflect.defineMetadata(PARAM_METADATA_KEY, existing, target, propertyKey);
+    };
+}
+/**
+ * URL 路径参数装饰器
+ *
+ * @param paramName - 参数名称
+ */
+const Path = (paramName) => createParamDecorator('path', paramName);
+exports.Path = Path;
+/**
+ * URL 查询参数装饰器
+ *
+ * @param paramName - 参数名称
+ */
+const Query = (paramName) => createParamDecorator('query', paramName);
+exports.Query = Query;
+/**
+ * 请求体参数装饰器
+ */
+const Body = () => createParamDecorator('body');
+exports.Body = Body;
+/**
+ * 请求头参数装饰器
+ *
+ * @param paramName - 参数名称
+ */
+const Header = (paramName) => createParamDecorator('header', paramName);
+exports.Header = Header;
+/**
+ * 获取方法的参数元数据列表
+ *
+ * @param target - 目标对象
+ * @param propertyKey - 方法属性名
+ * @returns 参数元数据数组
+ */
+function getParamMetadata(target, propertyKey) {
+    return (Reflect.getMetadata(PARAM_METADATA_KEY, target, propertyKey) ||
+        []);
+}
+//# sourceMappingURL=params.js.map

package/dist/decorators/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/decorators/params.ts"],"names":[],"mappings":";;;AAgEA,4CAQC;AAxED,4BAA0B;AAG1B,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,SAAoB,EAAE,SAAkB;IACpE,OAAO,UACL,MAAc,EACd,WAA4B,EAC5B,cAAsB;QAEtB,MAAM,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAErE,MAAM,QAAQ,GAAkB;YAC9B,UAAU,EAAE,cAAc;YAC1B,SAAS;YACT,SAAS;SACV,CAAC;QAEF,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACI,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAAtE,QAAA,IAAI,QAAkE;AACnF;;;;GAIG;AACI,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAE,EAAE,CACzC,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAD9B,QAAA,KAAK,SACyB;AAC3C;;GAEG;AACI,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAA1C,QAAA,IAAI,QAAsC;AACvD;;;;GAIG;AACI,MAAM,MAAM,GAAG,CAAC,SAAiB,EAAE,EAAE,CAC1C,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAD/B,QAAA,MAAM,UACyB;AAE5C;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,MAAc,EACd,WAA4B;IAE5B,OAAO,CACJ,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,MAAM,EAAE,WAAW,CAAqB;QACjF,EAAE,CACH,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @jintianxiayu/http-client-decorator - 基于装饰器的 HTTP 客户端框架
+ *
+ * 提供 RPC-like 调用体验的 HTTP 客户端框架，支持：
+ * - 装饰器声明式 HTTP 方法定义
+ * - Koa 风格洋葱模型中间件
+ * - 自动错误处理
+ */
+export { HttpClient, getHttpClientConfig } from './decorators/http-client';
+export { Get, Post, Put, Delete, Patch, getMethodMetadata, } from './decorators/http-methods';
+export { Path, Query, Body, Header, getParamMetadata, } from './decorators/params';
+export type { HttpClientConfig } from './core/http-client-config';
+export type { HttpContext } from './core/middleware';
+export type { Middleware } from './core/middleware';
+export type { MethodMetadata, HttpMethod } from './core/method-metadata';
+export type { ParamMetadata, ParamType } from './core/param-metadata';
+export { HttpError } from './core/http-error';
+export { executeMiddlewareChain } from './core/middleware';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG3E,OAAO,EACL,GAAG,EACH,IAAI,EACJ,GAAG,EACH,MAAM,EACN,KAAK,EACL,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,MAAM,EACN,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * @jintianxiayu/http-client-decorator - 基于装饰器的 HTTP 客户端框架
+ *
+ * 提供 RPC-like 调用体验的 HTTP 客户端框架，支持：
+ * - 装饰器声明式 HTTP 方法定义
+ * - Koa 风格洋葱模型中间件
+ * - 自动错误处理
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeMiddlewareChain = exports.HttpError = exports.getParamMetadata = exports.Header = exports.Body = exports.Query = exports.Path = exports.getMethodMetadata = exports.Patch = exports.Delete = exports.Put = exports.Post = exports.Get = exports.getHttpClientConfig = exports.HttpClient = void 0;
+// 类装饰器
+var http_client_1 = require("./decorators/http-client");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_client_1.HttpClient; } });
+Object.defineProperty(exports, "getHttpClientConfig", { enumerable: true, get: function () { return http_client_1.getHttpClientConfig; } });
+// 方法装饰器
+var http_methods_1 = require("./decorators/http-methods");
+Object.defineProperty(exports, "Get", { enumerable: true, get: function () { return http_methods_1.Get; } });
+Object.defineProperty(exports, "Post", { enumerable: true, get: function () { return http_methods_1.Post; } });
+Object.defineProperty(exports, "Put", { enumerable: true, get: function () { return http_methods_1.Put; } });
+Object.defineProperty(exports, "Delete", { enumerable: true, get: function () { return http_methods_1.Delete; } });
+Object.defineProperty(exports, "Patch", { enumerable: true, get: function () { return http_methods_1.Patch; } });
+Object.defineProperty(exports, "getMethodMetadata", { enumerable: true, get: function () { return http_methods_1.getMethodMetadata; } });
+// 参数装饰器
+var params_1 = require("./decorators/params");
+Object.defineProperty(exports, "Path", { enumerable: true, get: function () { return params_1.Path; } });
+Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return params_1.Query; } });
+Object.defineProperty(exports, "Body", { enumerable: true, get: function () { return params_1.Body; } });
+Object.defineProperty(exports, "Header", { enumerable: true, get: function () { return params_1.Header; } });
+Object.defineProperty(exports, "getParamMetadata", { enumerable: true, get: function () { return params_1.getParamMetadata; } });
+// 错误类
+var http_error_1 = require("./core/http-error");
+Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return http_error_1.HttpError; } });
+// 中间件链
+var middleware_1 = require("./core/middleware");
+Object.defineProperty(exports, "executeMiddlewareChain", { enumerable: true, get: function () { return middleware_1.executeMiddlewareChain; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,OAAO;AACP,wDAA2E;AAAlE,yGAAA,UAAU,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAExC,QAAQ;AACR,0DAOmC;AANjC,mGAAA,GAAG,OAAA;AACH,oGAAA,IAAI,OAAA;AACJ,mGAAA,GAAG,OAAA;AACH,sGAAA,MAAM,OAAA;AACN,qGAAA,KAAK,OAAA;AACL,iHAAA,iBAAiB,OAAA;AAGnB,QAAQ;AACR,8CAM6B;AAL3B,8FAAA,IAAI,OAAA;AACJ,+FAAA,KAAK,OAAA;AACL,8FAAA,IAAI,OAAA;AACJ,gGAAA,MAAM,OAAA;AACN,0GAAA,gBAAgB,OAAA;AAUlB,MAAM;AACN,gDAA8C;AAArC,uGAAA,SAAS,OAAA;AAElB,OAAO;AACP,gDAA2D;AAAlD,oHAAA,sBAAsB,OAAA"}

package/package.json

@@ -0,0 +1,32 @@
+{
+    "name": "@jintianxiayu/http-client-decorator",
+    "version": "0.1.2",
+    "description": "Decorator-based HTTP client framework providing RPC-like calling experience",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc",
+        "test": "jest",
+        "lint": "eslint src --ext .ts",
+        "clean": "rm -rf dist"
+    },
+    "files": [
+        "dist"
+    ],
+    "dependencies": {
+        "axios": "^1.7.9",
+        "reflect-metadata": "^0.2.2"
+    },
+    "peerDependencies": {
+        "@jintianxiayu/logger": "*"
+    },
+    "devDependencies": {
+        "@jintianxiayu/logger": "^0.1.2",
+        "axios-mock-adapter": "^2.1.0",
+        "ts-jest": "^29.2.5"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "gitHead": "357e736abbe6b25a707663c1b9e027b2e8b532a6"
+}