@vafast/api-client 0.1.2 → 0.1.4

package/README.md

@@ -5,7 +5,7 @@
 ## ✨ 特性
 
 - 🔒 **完整类型推断** - 从路由定义自动推断 API 类型，无需手动定义接口
-- 🎯 **无需 `as const`** - 使用 `route()` 函数，类型自动保留
+- 🎯 **无需 `as const`** - `defineRoutes()` 自动保留字面量类型
 - 🌊 **SSE 流式响应** - 内置 Server-Sent Events 支持，包含自动重连
 - ⏹️ **请求取消** - 支持 AbortController 取消进行中的请求
 - 🔗 **链式调用** - 优雅的 `api.users({ id }).posts.get()` 语法
@@ -15,8 +15,6 @@
 
 ```bash
 npm install @vafast/api-client
-# 或
-bun add @vafast/api-client
 ```
 
 ## 🚀 快速开始
@@ -25,39 +23,52 @@ bun add @vafast/api-client
 
 ```typescript
 // server.ts
-import { defineRoutes, route, createHandler, createSSEHandler, Type } from 'vafast'
+import { defineRoutes, createHandler, createSSEHandler, Type } from 'vafast'
 
 export const routes = defineRoutes([
-  // ✨ 使用 route() 函数，无需 as const
-  route('GET', '/users', createHandler(
-    { query: Type.Object({ page: Type.Optional(Type.Number()) }) },
-    async ({ query }) => ({ users: [], total: 0, page: query.page ?? 1 })
-  )),
-  
-  route('POST', '/users', createHandler(
-    { body: Type.Object({ name: Type.String(), email: Type.String() }) },
-    async ({ body }) => ({ id: crypto.randomUUID(), ...body })
-  )),
-  
-  route('GET', '/users/:id', createHandler(
-    { params: Type.Object({ id: Type.String() }) },
-    async ({ params }) => ({ id: params.id, name: 'User' })
-  )),
-  
+  // ✨ defineRoutes() 自动保留字面量类型，无需 as const
+  {
+    method: 'GET',
+    path: '/users',
+    handler: createHandler(
+      { query: Type.Object({ page: Type.Optional(Type.Number()) }) },
+      async ({ query }) => ({ users: [], total: 0, page: query.page ?? 1 })
+    )
+  },
+  {
+    method: 'POST',
+    path: '/users',
+    handler: createHandler(
+      { body: Type.Object({ name: Type.String(), email: Type.String() }) },
+      async ({ body }) => ({ id: crypto.randomUUID(), ...body })
+    )
+  },
+  {
+    method: 'GET',
+    path: '/users/:id',
+    handler: createHandler(
+      { params: Type.Object({ id: Type.String() }) },
+      async ({ params }) => ({ id: params.id, name: 'User' })
+    )
+  },
   // 🌊 SSE 流式响应
-  route('GET', '/chat/stream', createSSEHandler(
-    { query: Type.Object({ prompt: Type.String() }) },
-    async function* ({ query }) {
-      yield { event: 'start', data: { message: 'Starting...' } }
-      
-      for (const word of query.prompt.split(' ')) {
-        yield { data: { text: word } }
-        await new Promise(r => setTimeout(r, 100))
+  {
+    method: 'GET',
+    path: '/chat/stream',
+    handler: createSSEHandler(
+      { query: Type.Object({ prompt: Type.String() }) },
+      async function* ({ query }) {
+        yield { event: 'start', data: { message: 'Starting...' } }
+        
+        for (const word of query.prompt.split(' ')) {
+          yield { data: { text: word } }
+          await new Promise(r => setTimeout(r, 100))
+        }
+        
+        yield { event: 'end', data: { message: 'Done!' } }
       }
-      
-      yield { event: 'end', data: { message: 'Done!' } }
-    }
-  ))
+    )
+  }
 ])
 
 // 导出类型供客户端使用
@@ -280,8 +291,6 @@ interface RequestConfig {
 
 ```bash
 npm test
-# 或
-bun test
 ```
 
 ## 📄 许可证

package/dist/index.d.mts

@@ -0,0 +1,296 @@
+//#region src/types/index.d.ts
+/**
+ * 类型定义
+ */
+/** HTTP 方法 */
+type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+/**
+ * 请求配置
+ */
+interface RequestConfig {
+  /** 请求头 */
+  headers?: Record<string, string>;
+  /** 超时时间（毫秒） */
+  timeout?: number;
+  /** 取消信号 */
+  signal?: AbortSignal;
+}
+/**
+ * API 响应
+ */
+interface ApiResponse<T = unknown> {
+  /** 响应数据 */
+  data: T | null;
+  /** 错误信息 */
+  error: Error | null;
+  /** HTTP 状态码 */
+  status: number;
+  /** 响应头 */
+  headers: Headers;
+  /** 原始响应对象 */
+  response: Response;
+}
+//#endregion
+//#region src/core/eden.d.ts
+interface EdenConfig {
+  headers?: Record<string, string>;
+  onRequest?: (request: Request) => Request | Promise<Request>;
+  onResponse?: <T>(response: ApiResponse<T>) => ApiResponse<T> | Promise<ApiResponse<T>>;
+  onError?: (error: Error) => void;
+  timeout?: number;
+}
+/**
+ * SSE 事件
+ */
+interface SSEEvent<T = unknown> {
+  event?: string;
+  data: T;
+  id?: string;
+  retry?: number;
+}
+/**
+ * SSE 订阅选项
+ */
+interface SSESubscribeOptions {
+  /** 自定义请求头 */
+  headers?: Record<string, string>;
+  /** 重连间隔（毫秒） */
+  reconnectInterval?: number;
+  /** 最大重连次数 */
+  maxReconnects?: number;
+  /** 连接超时（毫秒） */
+  timeout?: number;
+}
+/**
+ * SSE 订阅结果
+ */
+interface SSESubscription<T = unknown> {
+  /** 取消订阅 */
+  unsubscribe: () => void;
+  /** 是否已连接 */
+  readonly connected: boolean;
+}
+/**
+ * 从 TypeBox Schema 提取静态类型
+ * 使用 TypeBox 内部的 static 属性提取类型
+ */
+type InferStatic<T> = T extends {
+  static: infer S;
+} ? S : T;
+/** 从 InferableHandler 提取返回类型 */
+type ExtractReturn<T> = T extends {
+  __returnType: infer R;
+} ? R : unknown;
+/** 从 InferableHandler 提取 Schema */
+type ExtractSchema<T> = T extends {
+  __schema: infer S;
+} ? S : {};
+/** 检查是否是 SSE Handler（使用品牌类型检测） */
+type IsSSEHandler<T> = T extends {
+  __sse: {
+    readonly __brand: 'SSE';
+  };
+} ? true : false;
+/** 从 Schema 提取各部分类型 */
+type GetQuery<S> = S extends {
+  query: infer Q;
+} ? InferStatic<Q> : undefined;
+type GetBody<S> = S extends {
+  body: infer B;
+} ? InferStatic<B> : undefined;
+type GetParams<S> = S extends {
+  params: infer P;
+} ? InferStatic<P> : undefined;
+/** 移除开头斜杠：/users → users */
+type TrimSlash<P$1 extends string> = P$1 extends `/${infer R}` ? R : P$1;
+/** 检查是否是动态参数段：:id → true */
+type IsDynamicSegment<S extends string> = S extends `:${string}` ? true : false;
+/** 清理 undefined 字段 */
+type Clean<T> = { [K in keyof T as T[K] extends undefined ? never : K]: T[K] };
+/** SSE 标记类型 */
+type SSEBrand = {
+  readonly __brand: 'SSE';
+};
+/** 从路由构建方法定义 */
+type BuildMethodDef<R extends {
+  readonly handler: unknown;
+}> = IsSSEHandler<R['handler']> extends true ? Clean<{
+  query: GetQuery<ExtractSchema<R['handler']>>;
+  params: GetParams<ExtractSchema<R['handler']>>;
+  return: ExtractReturn<R['handler']>;
+  sse: SSEBrand;
+}> : Clean<{
+  query: GetQuery<ExtractSchema<R['handler']>>;
+  body: GetBody<ExtractSchema<R['handler']>>;
+  params: GetParams<ExtractSchema<R['handler']>>;
+  return: ExtractReturn<R['handler']>;
+}>;
+/**
+ * 递归构建嵌套路径结构
+ *
+ * 处理动态参数：/users/:id → { users: { ':id': { ... } } }
+ */
+type BuildPath<Path extends string, Method extends string, Def> = Path extends `${infer First}/${infer Rest}` ? IsDynamicSegment<First> extends true ? {
+  ':id': BuildPath<Rest, Method, Def>;
+} : { [K in First]: BuildPath<Rest, Method, Def> } : IsDynamicSegment<Path> extends true ? {
+  ':id': { [M in Method]: Def };
+} : { [K in Path]: { [M in Method]: Def } };
+/**
+ * 从单个路由生成嵌套类型结构
+ */
+type RouteToTree<R extends {
+  readonly method: string;
+  readonly path: string;
+  readonly handler: unknown;
+}> = BuildPath<TrimSlash<R['path']>, Lowercase<R['method']>, BuildMethodDef<R>>;
+type DeepMerge<A, B$1> = { [K in keyof A | keyof B$1]: K extends keyof A & keyof B$1 ? A[K] extends object ? B$1[K] extends object ? DeepMerge<A[K], B$1[K]> : A[K] & B$1[K] : A[K] & B$1[K] : K extends keyof A ? A[K] : K extends keyof B$1 ? B$1[K] : never };
+/** 递归合并路由数组为单一类型结构 */
+type MergeRoutes<T extends readonly unknown[]> = T extends readonly [infer First extends {
+  readonly method: string;
+  readonly path: string;
+  readonly handler: unknown;
+}] ? RouteToTree<First> : T extends readonly [infer First extends {
+  readonly method: string;
+  readonly path: string;
+  readonly handler: unknown;
+}, ...infer Rest extends readonly {
+  readonly method: string;
+  readonly path: string;
+  readonly handler: unknown;
+}[]] ? DeepMerge<RouteToTree<First>, MergeRoutes<Rest>> : {};
+/**
+ * 从 vafast 路由数组自动推断 Eden 契约
+ *
+ * @example
+ * ```typescript
+ * import { defineRoutes, createHandler, Type } from 'vafast'
+ * import { eden, InferEden } from 'vafast-api-client'
+ *
+ * // ✨ defineRoutes() 自动保留字面量类型，无需 as const
+ * const routes = defineRoutes([
+ *   {
+ *     method: 'GET',
+ *     path: '/users',
+ *     handler: createHandler(
+ *       { query: Type.Object({ page: Type.Number() }) },
+ *       async ({ query }) => ({ users: [], total: 0 })
+ *     )
+ *   },
+ *   {
+ *     method: 'GET',
+ *     path: '/chat/stream',
+ *     handler: createSSEHandler(
+ *       { query: Type.Object({ prompt: Type.String() }) },
+ *       async function* ({ query }) {
+ *         yield { data: { text: 'Hello' } }
+ *       }
+ *     )
+ *   }
+ * ])
+ *
+ * type Api = InferEden<typeof routes>
+ * const api = eden<Api>('http://localhost:3000')
+ *
+ * // 普通请求
+ * const { data } = await api.users.get({ page: 1 })
+ *
+ * // SSE 流式请求
+ * api.chat.stream.subscribe({ prompt: 'Hi' }, {
+ *   onMessage: (data) => console.log(data),
+ *   onError: (err) => console.error(err)
+ * })
+ * ```
+ */
+type InferEden<T extends readonly {
+  readonly method: string;
+  readonly path: string;
+  readonly handler: unknown;
+}[]> = MergeRoutes<T>;
+/** HTTP 方法定义 */
+interface MethodDef {
+  query?: unknown;
+  body?: unknown;
+  params?: unknown;
+  return: unknown;
+  sse?: SSEBrand;
+}
+/** SSE 订阅回调 */
+interface SSECallbacks<T> {
+  /** 收到消息 */
+  onMessage: (data: T) => void;
+  /** 发生错误 */
+  onError?: (error: Error) => void;
+  /** 连接打开 */
+  onOpen?: () => void;
+  /** 连接关闭 */
+  onClose?: () => void;
+  /** 正在重连 */
+  onReconnect?: (attempt: number, maxAttempts: number) => void;
+  /** 达到最大重连次数 */
+  onMaxReconnects?: () => void;
+}
+/** 从方法定义提取调用签名 */
+type MethodCall<M$1 extends MethodDef, HasParams extends boolean = false> = M$1 extends {
+  sse: SSEBrand;
+} ? M$1 extends {
+  query: infer Q;
+} ? (query: Q, callbacks: SSECallbacks<M$1['return']>, options?: SSESubscribeOptions) => SSESubscription<M$1['return']> : (callbacks: SSECallbacks<M$1['return']>, options?: SSESubscribeOptions) => SSESubscription<M$1['return']> : HasParams extends true ? M$1 extends {
+  body: infer B;
+} ? (body: B, config?: RequestConfig) => Promise<ApiResponse<M$1['return']>> : (config?: RequestConfig) => Promise<ApiResponse<M$1['return']>> : M$1 extends {
+  query: infer Q;
+} ? (query?: Q, config?: RequestConfig) => Promise<ApiResponse<M$1['return']>> : M$1 extends {
+  body: infer B;
+} ? (body: B, config?: RequestConfig) => Promise<ApiResponse<M$1['return']>> : (config?: RequestConfig) => Promise<ApiResponse<M$1['return']>>;
+/** 检查是否是 SSE 端点（检测品牌类型标记） */
+type IsSSEEndpoint<M$1> = M$1 extends {
+  sse: {
+    readonly __brand: 'SSE';
+  };
+} ? true : false;
+/** 端点类型 - 包含 subscribe 方法用于 SSE */
+type Endpoint<T, HasParams extends boolean = false> = { [K in 'get' | 'post' | 'put' | 'patch' | 'delete' as T extends { [P in K]: MethodDef } ? K : never]: T extends { [P in K]: infer M extends MethodDef } ? MethodCall<M, HasParams> : never } & (T extends {
+  get: infer M extends MethodDef;
+} ? IsSSEEndpoint<M> extends true ? {
+  subscribe: MethodCall<M, HasParams>;
+} : {} : {});
+/** HTTP 方法名 */
+type HTTPMethods = 'get' | 'post' | 'put' | 'patch' | 'delete';
+/** 递归构建客户端类型 */
+type EdenClient<T, HasParams extends boolean = false> = { [K in keyof T as K extends HTTPMethods | `:${string}` ? never : K]: T[K] extends {
+  ':id': infer Child;
+} ? ((params: Record<string, string>) => EdenClient<Child, true>) & EdenClient<T[K], false> : EdenClient<T[K], false> } & Endpoint<T, HasParams>;
+/**
+ * 创建 Eden 风格的类型安全 API 客户端
+ *
+ * @param baseURL - API 基础 URL
+ * @param config - 可选配置
+ * @returns 类型安全的 API 客户端
+ *
+ * @example
+ * ```typescript
+ * // 使用自动推断的契约（无需 as const）
+ * const routes = defineRoutes([
+ *   route('GET', '/users', createHandler(...)),
+ *   route('GET', '/chat/stream', createSSEHandler(...))
+ * ])
+ *
+ * type Api = InferEden<typeof routes>
+ * const api = eden<Api>('http://localhost:3000')
+ *
+ * // 普通请求
+ * const { data } = await api.users.get({ page: 1 })
+ *
+ * // SSE 流式请求
+ * const sub = api.chat.stream.subscribe({ prompt: 'Hello' }, {
+ *   onMessage: (data) => console.log(data),
+ *   onError: (err) => console.error(err)
+ * })
+ *
+ * // 取消订阅
+ * sub.unsubscribe()
+ * ```
+ */
+declare function eden<T>(baseURL: string, config?: EdenConfig): EdenClient<T>;
+//#endregion
+export { type ApiResponse, type EdenClient, type EdenConfig, type HTTPMethod, type InferEden, type RequestConfig, type SSEEvent, type SSESubscribeOptions, type SSESubscription, eden };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/index.ts","../src/core/eden.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,226 @@
+//#region src/core/eden.ts
+/**
+* 解析 SSE 事件流
+*/
+async function* parseSSEStream(reader) {
+	const decoder = new TextDecoder();
+	let buffer = "";
+	while (true) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		buffer += decoder.decode(value, { stream: true });
+		const events = buffer.split("\n\n");
+		buffer = events.pop() || "";
+		for (const eventStr of events) {
+			if (!eventStr.trim()) continue;
+			const event = { data: "" };
+			const lines = eventStr.split("\n");
+			let dataLines = [];
+			for (const line of lines) if (line.startsWith("event:")) event.event = line.slice(6).trim();
+			else if (line.startsWith("data:")) dataLines.push(line.slice(5).trim());
+			else if (line.startsWith("id:")) event.id = line.slice(3).trim();
+			else if (line.startsWith("retry:")) event.retry = parseInt(line.slice(6).trim(), 10);
+			const dataStr = dataLines.join("\n");
+			try {
+				event.data = JSON.parse(dataStr);
+			} catch {
+				event.data = dataStr;
+			}
+			yield event;
+		}
+	}
+}
+/**
+* 创建 Eden 风格的类型安全 API 客户端
+* 
+* @param baseURL - API 基础 URL
+* @param config - 可选配置
+* @returns 类型安全的 API 客户端
+* 
+* @example
+* ```typescript
+* // 使用自动推断的契约（无需 as const）
+* const routes = defineRoutes([
+*   route('GET', '/users', createHandler(...)),
+*   route('GET', '/chat/stream', createSSEHandler(...))
+* ])
+* 
+* type Api = InferEden<typeof routes>
+* const api = eden<Api>('http://localhost:3000')
+* 
+* // 普通请求
+* const { data } = await api.users.get({ page: 1 })
+* 
+* // SSE 流式请求
+* const sub = api.chat.stream.subscribe({ prompt: 'Hello' }, {
+*   onMessage: (data) => console.log(data),
+*   onError: (err) => console.error(err)
+* })
+* 
+* // 取消订阅
+* sub.unsubscribe()
+* ```
+*/
+function eden(baseURL, config) {
+	const { headers: defaultHeaders, onRequest, onResponse, onError, timeout } = config ?? {};
+	async function request(method, path, data, requestConfig) {
+		const url = new URL(path, baseURL);
+		if (method === "GET" && data && typeof data === "object") {
+			for (const [key, value] of Object.entries(data)) if (value !== void 0 && value !== null) url.searchParams.set(key, String(value));
+		}
+		const headers = {
+			"Content-Type": "application/json",
+			...defaultHeaders,
+			...requestConfig?.headers
+		};
+		const controller = new AbortController();
+		let timeoutId;
+		const userSignal = requestConfig?.signal;
+		const requestTimeout = requestConfig?.timeout ?? timeout;
+		if (userSignal) if (userSignal.aborted) controller.abort();
+		else userSignal.addEventListener("abort", () => controller.abort());
+		if (requestTimeout) timeoutId = setTimeout(() => controller.abort(), requestTimeout);
+		const fetchOptions = {
+			method,
+			headers,
+			signal: controller.signal
+		};
+		if (method !== "GET" && method !== "HEAD" && data) fetchOptions.body = JSON.stringify(data);
+		let req = new Request(url.toString(), fetchOptions);
+		if (onRequest) req = await onRequest(req);
+		try {
+			const response = await fetch(req);
+			if (timeoutId) clearTimeout(timeoutId);
+			const contentType = response.headers.get("content-type");
+			let responseData = null;
+			if (contentType?.includes("application/json")) responseData = await response.json();
+			else if (contentType?.includes("text/")) responseData = await response.text();
+			let result = {
+				data: responseData,
+				error: response.ok ? null : /* @__PURE__ */ new Error(`HTTP ${response.status}`),
+				status: response.status,
+				headers: response.headers,
+				response
+			};
+			if (onResponse) result = await onResponse(result);
+			if (!response.ok && onError) onError(result.error);
+			return result;
+		} catch (error) {
+			const err = error instanceof Error ? error : new Error(String(error));
+			if (onError) onError(err);
+			return {
+				data: null,
+				error: err,
+				status: 0,
+				headers: new Headers(),
+				response: new Response()
+			};
+		}
+	}
+	function subscribe(path, query, callbacks, options) {
+		const url = new URL(path, baseURL);
+		if (query) {
+			for (const [key, value] of Object.entries(query)) if (value !== void 0 && value !== null) url.searchParams.set(key, String(value));
+		}
+		let abortController = new AbortController();
+		let connected = false;
+		let reconnectCount = 0;
+		let isUnsubscribed = false;
+		let lastEventId;
+		const reconnectInterval = options?.reconnectInterval ?? 3e3;
+		const maxReconnects = options?.maxReconnects ?? 5;
+		const connect = async () => {
+			if (isUnsubscribed) return;
+			try {
+				abortController = new AbortController();
+				const headers = {
+					"Accept": "text/event-stream",
+					...defaultHeaders,
+					...options?.headers
+				};
+				if (lastEventId) headers["Last-Event-ID"] = lastEventId;
+				const response = await fetch(url.toString(), {
+					method: "GET",
+					headers,
+					signal: abortController.signal
+				});
+				if (!response.ok) throw new Error(`HTTP ${response.status}`);
+				if (!response.body) throw new Error("No response body");
+				connected = true;
+				reconnectCount = 0;
+				callbacks.onOpen?.();
+				const reader = response.body.getReader();
+				for await (const event of parseSSEStream(reader)) {
+					if (event.id) lastEventId = event.id;
+					if (event.event === "error") callbacks.onError?.(new Error(String(event.data)));
+					else callbacks.onMessage(event.data);
+				}
+				connected = false;
+				callbacks.onClose?.();
+			} catch (error) {
+				connected = false;
+				if (error.name === "AbortError" || isUnsubscribed) return;
+				callbacks.onError?.(error);
+				if (reconnectCount < maxReconnects) {
+					reconnectCount++;
+					callbacks.onReconnect?.(reconnectCount, maxReconnects);
+					setTimeout(() => {
+						if (!isUnsubscribed) connect();
+					}, reconnectInterval);
+				} else callbacks.onMaxReconnects?.();
+			}
+		};
+		connect();
+		return {
+			unsubscribe: () => {
+				isUnsubscribed = true;
+				abortController?.abort();
+				abortController = null;
+				connected = false;
+			},
+			get connected() {
+				return connected;
+			}
+		};
+	}
+	function createEndpoint(basePath) {
+		const methods = [
+			"get",
+			"post",
+			"put",
+			"patch",
+			"delete"
+		];
+		const handler = (params) => {
+			const paramValue = Object.values(params)[0];
+			return createEndpoint(`${basePath}/${encodeURIComponent(paramValue)}`);
+		};
+		return new Proxy(handler, {
+			get(_, prop) {
+				if (methods.includes(prop)) {
+					const httpMethod = prop.toUpperCase();
+					return (data, cfg) => {
+						return request(httpMethod, basePath, data, cfg);
+					};
+				}
+				if (prop === "subscribe") return (queryOrCallbacks, callbacksOrOptions, options) => {
+					if (typeof queryOrCallbacks === "object" && "onMessage" in queryOrCallbacks) return subscribe(basePath, void 0, queryOrCallbacks, callbacksOrOptions);
+					else return subscribe(basePath, queryOrCallbacks, callbacksOrOptions, options);
+				};
+				return createEndpoint(`${basePath}/${prop}`);
+			},
+			apply(_, __, args) {
+				const params = args[0];
+				const paramValue = Object.values(params)[0];
+				return createEndpoint(`${basePath}/${encodeURIComponent(paramValue)}`);
+			}
+		});
+	}
+	return new Proxy({}, { get(_, prop) {
+		return createEndpoint(`/${prop}`);
+	} });
+}
+
+//#endregion
+export { eden };
+//# sourceMappingURL=index.mjs.map