@kepoai/provider 1.0.7 → 1.0.8

package/api/index.d.ts

@@ -48,6 +48,24 @@ export interface OptionEvent {
     currentTarget: Options
 }
 
+// 配置事件成功结果结构
+export interface OptionEventSuccessResult {
+    success: true
+    data?: unknown
+}
+
+// 配置事件失败结果结构
+export interface OptionEventFailureResult {
+    success: false
+    error: string
+}
+
+// 配置事件允许返回的结果类型
+export type OptionEventResult = void | OptionEventSuccessResult | OptionEventFailureResult
+
+// 配置事件处理函数签名
+export type OptionEventHandler = (e: OptionEvent) => Promise<OptionEventResult> | OptionEventResult
+
 // 配置选项基础结构
 interface OptionBase<T> {
     key: string
@@ -64,10 +82,10 @@ interface OptionBase<T> {
 export interface InputOption extends OptionBase<string> {
     type: 'input';
     event?: { // 事件结构
-        onLoad?: (e: OptionEvent) => void; // 加载事件
-        onChange?: (e: OptionEvent) => void; // 改变事件
-        onFocus?: (e: OptionEvent) => void; // 聚焦事件
-        onBlur?: (e: OptionEvent) => void; // 失焦事件
+        onLoad?: OptionEventHandler; // 加载事件
+        onChange?: OptionEventHandler; // 改变事件
+        onFocus?: OptionEventHandler; // 聚焦事件
+        onBlur?: OptionEventHandler; // 失焦事件
     }
 }
 
@@ -80,9 +98,9 @@ export interface SelectOption extends OptionBase<string[]> {
     multiple: boolean;
     search?: string,
     event?: {
-        onLoad?: (e: OptionEvent) => void;
-        onSearch?: (e: OptionEvent) => void;
-        onChange?: (e: OptionEvent) => void;
+        onLoad?: OptionEventHandler;
+        onSearch?: OptionEventHandler;
+        onChange?: OptionEventHandler;
     }
 }
 
@@ -90,9 +108,9 @@ export interface SelectOption extends OptionBase<string[]> {
 export interface SwitchOption extends OptionBase<boolean> {
     type: 'switch';
     event?: {
-        onLoad?: (e: OptionEvent) => void;
+        onLoad?: OptionEventHandler;
 
-        onChange?: (e: OptionEvent) => void;
+        onChange?: OptionEventHandler;
     }
 }
 
@@ -100,8 +118,8 @@ export interface SwitchOption extends OptionBase<boolean> {
 export interface ButtonOption extends OptionBase<string> {
     type: 'button';
     event: ?{
-        onLoad?: (e: OptionEvent) => void;
-        onClick: (e: OptionEvent) => void;
+        onLoad?: OptionEventHandler;
+        onClick: OptionEventHandler;
     }
 }
 
@@ -147,6 +165,40 @@ export interface Events {
     onHide?: (props: EventProps) => void; // 隐藏事件
 }
 
+// 简化请求查询参数值
+export type SimpleFetchQueryValue = string | number | boolean | null | undefined
+
+// 简化请求选项
+export interface SimpleFetchOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD'
+    baseURL?: string
+    query?: Record<string, SimpleFetchQueryValue>
+    params?: Record<string, SimpleFetchQueryValue>
+    headers?: Record<string, string>
+    body?: string | Record<string, unknown> | ArrayBuffer | Uint8Array
+    responseType?: 'json' | 'text' | 'arrayBuffer'
+    timeout?: number
+    ignoreResponseError?: boolean
+}
+
+// 简化请求 raw 返回结构
+export interface SimpleFetchRawResponse<T> {
+    status: number
+    statusText: string
+    ok: boolean
+    url: string
+    headers: Record<string, string>
+    data: T
+}
+
+// Build Mode / Provider 专用的会话感知简化请求能力
+export interface SimpleFetch {
+    <T = unknown>(url: string, options?: SimpleFetchOptions): Promise<T>
+    raw<T = unknown>(url: string, options?: SimpleFetchOptions): Promise<SimpleFetchRawResponse<T>>
+}
+
+export const $fetch: SimpleFetch
+
 // AI 消息结构
 export interface AiMessage {
     role: 'system' | 'user' | 'assistant'
@@ -178,7 +230,6 @@ export interface AiCompleteResult {
     text: string
     usage: AiUsage
     quota: AiQuotaSnapshot
-    model: string
     source: string
     requestId: string
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kepoai/provider",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "",
   "files": [
     "api"