@longzai-intelligence-transport/http 0.1.0

package/README.md

@@ -0,0 +1,147 @@
+# @longzai-intelligence-transport/http
+
+HTTP 工具统一入口，整合核心模块和各框架适配器，提供类型安全的 HTTP 客户端解决方案。
+
+## 安装
+
+```bash
+bun add @longzai-intelligence-transport/http
+```
+
+## 功能特性
+
+- **类型安全的 API 定义** - 基于 Zod Schema 的请求/响应类型推断
+- **多框架适配器** - 支持 React（SWR）和 NestJS（Swagger）
+- **统一的 HTTP 客户端** - 基于 Axios 的 REST 客户端
+- **API 函数工厂** - 自动生成类型安全的 API 调用函数
+
+## 子模块
+
+### 核心模块
+
+```typescript
+import { createHttpClient, createApiFunctions } from '@longzai-intelligence-transport/http';
+// 或
+import { createHttpClient, createApiFunctions } from '@longzai-intelligence-transport/http/core';
+```
+
+### React 适配器
+
+```typescript
+import {
+  createQueryHook,
+  createMutationHook,
+} from '@longzai-intelligence-transport/http/adapters/react';
+```
+
+### NestJS 适配器
+
+```typescript
+import {
+  ApiRoute,
+  RequireAuth,
+  zodToOpenApi,
+} from '@longzai-intelligence-transport/http/adapters/nestjs';
+```
+
+## 依赖
+
+### 必需依赖
+
+- `zod` - Schema 验证（peer dependency）
+
+### 可选依赖
+
+- `react` - React 框架（使用 React 适配器时需要）
+- `swr` - SWR 数据请求库（使用 React 适配器时需要）
+- `@nestjs/common` - NestJS 核心模块（使用 NestJS 适配器时需要）
+- `@nestjs/swagger` - Swagger 集成模块（使用 NestJS 适配器时需要）
+
+## 使用示例
+
+### 定义 API 路由
+
+```typescript
+import { defineRoute } from '@longzai-intelligence-transport/http';
+import { z } from 'zod';
+
+const UserSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  email: z.string().email(),
+});
+
+const routes = {
+  getUser: defineRoute({
+    method: 'GET',
+    path: '/users/:id',
+    response: UserSchema,
+  }),
+  createUser: defineRoute({
+    method: 'POST',
+    path: '/users',
+    body: UserSchema.omit({ id: true }),
+    response: UserSchema,
+  }),
+};
+```
+
+### 创建客户端和 API 函数
+
+```typescript
+import { createHttpClient, createApiFunctions } from '@longzai-intelligence-transport/http';
+
+const client = createHttpClient({
+  baseURL: 'https://api.example.com',
+  headers: {
+    Authorization: 'Bearer token',
+  },
+});
+
+const api = createApiFunctions(client, routes);
+
+// 类型安全的 API 调用
+const user = await api.getUser({ id: '123' });
+```
+
+### React Hook 使用
+
+```typescript
+import { createQueryHook, createMutationHook } from '@longzai-intelligence-transport/http/adapters/react';
+
+const useGetUser = createQueryHook(api.getUser, 'user');
+const useCreateUser = createMutationHook(api.createUser);
+
+function UserComponent() {
+  const { data, isLoading } = useGetUser({ id: '123' });
+  const { trigger } = useCreateUser();
+
+  return (
+    // ...
+  );
+}
+```
+
+### NestJS 控制器使用
+
+```typescript
+import { ApiRoute, RequireAuth } from '@longzai-intelligence-transport/http/adapters/nestjs';
+import { Controller, Get, Post, Body } from '@nestjs/common';
+
+@Controller('users')
+@RequireAuth()
+export class UserController {
+  @Get(':id')
+  @ApiRoute({
+    summary: '获取用户信息',
+    response: UserSchema,
+  })
+  async getUser() {
+    // ...
+  }
+}
+```
+
+## 许可证
+
+UNLICENSED

package/dist/chunk-CenpyGzJ.js

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,r=Object.prototype.hasOwnProperty,i=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n||e(r,Symbol.toStringTag,{value:`Module`}),r},a=(i,a,o,s)=>{if(a&&typeof a==`object`||typeof a==`function`)for(var c=n(a),l=0,u=c.length,d;l<u;l++)d=c[l],!r.call(i,d)&&d!==o&&e(i,d,{get:(e=>a[e]).bind(null,d),enumerable:!(s=t(a,d))||s.enumerable});return i},o=(e,t,n)=>(a(e,t,`default`),n&&a(n,t,`default`));export{o as n,i as t};

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "@longzai-intelligence-transport/http-core";
+
+//#region src/index.d.ts

package/dist/index.js

@@ -0,0 +1 @@
+import"./chunk-CenpyGzJ.js";export*from"@longzai-intelligence-transport/http-core";export{};

package/package.json

@@ -0,0 +1,109 @@
+{
+  "name": "@longzai-intelligence-transport/http",
+  "version": "0.1.0",
+  "keywords": [
+    "api",
+    "facade",
+    "http",
+    "typescript",
+    "utils"
+  ],
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core.module.d.ts",
+      "import": "./dist/core.module.js"
+    },
+    "./adapters/react": {
+      "types": "./dist/react-adapter.d.ts",
+      "import": "./dist/react-adapter.js"
+    },
+    "./adapters/nestjs": {
+      "types": "./dist/nestjs-adapter.d.ts",
+      "import": "./dist/nestjs-adapter.js"
+    },
+    "./adapters/taro": {
+      "types": "./dist/taro-adapter.d.ts",
+      "import": "./dist/taro-adapter.js"
+    },
+    "./adapters/bun": {
+      "types": "./dist/bun-adapter.d.ts",
+      "import": "./dist/bun-adapter.js"
+    },
+    "./presets/browser": {
+      "types": "./dist/browser-preset.d.ts",
+      "import": "./dist/browser-preset.js"
+    },
+    "./presets/node": {
+      "types": "./dist/node-preset.d.ts",
+      "import": "./dist/node-preset.js"
+    }
+  },
+  "scripts": {
+    "build": "tsgo --build tsconfig/build.json && resolve-aliases -p tsconfig/build.json",
+    "build:prod": "NODE_ENV=production tsdown",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "tsgo --noEmit -p tsconfig/app.json",
+    "typecheck:node": "tsgo --noEmit -p tsconfig/node.json",
+    "typecheck:test": "tsgo --noEmit -p tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "clean": "rimraf dist out .cache"
+  },
+  "dependencies": {
+    "@longzai-intelligence-transport/http-adapter-bun": "0.1.0",
+    "@longzai-intelligence-transport/http-adapter-nestjs": "0.1.0",
+    "@longzai-intelligence-transport/http-adapter-react": "0.1.0",
+    "@longzai-intelligence-transport/http-adapter-taro": "0.1.0",
+    "@longzai-intelligence-transport/http-core": "0.1.0",
+    "@longzai-intelligence-transport/http-preset-browser": "0.1.0",
+    "@longzai-intelligence-transport/http-preset-node": "0.1.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.1.26",
+    "@nestjs/swagger": "^11.4.4",
+    "@types/react": "^19.2.17",
+    "react": "^19.2.7",
+    "swr": "^2.4.1",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/swagger": "^11.0.0",
+    "@tarojs/taro": ">=3.6.0",
+    "react": ">=18.0.0",
+    "swr": ">=2.0.0",
+    "zod": "^4.4.3"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "swr": {
+      "optional": true
+    },
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/swagger": {
+      "optional": true
+    },
+    "@tarojs/taro": {
+      "optional": true
+    }
+  }
+}