@kepoai/provider 1.0.7 → 1.0.9

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;
     }
 }
 
@@ -139,14 +157,68 @@ export interface EventProps {
     size: size;
 }
 
+export interface PopupLayerEventProps {
+    event: 'popupLayer:opened' | 'popupLayer:closed';
+    popupLayerId: string;
+    type: 'browser' | 'custom';
+    source: 'widget' | 'panel';
+    widgetId?: string;
+    panelRequestId?: string;
+}
+
+export interface PopupLayerOpenedEventProps extends PopupLayerEventProps {
+    event: 'popupLayer:opened';
+}
+
+export interface PopupLayerClosedEventProps extends PopupLayerEventProps {
+    event: 'popupLayer:closed';
+    reason: 'user-close' | 'completed' | 'cancelled' | 'host-reset';
+}
+
 // 系统事件类型
 export interface Events {
     onScheduled: (props: EventProps) => void; // 定时任务事件
     onCreated?: (props: EventProps) => void; // 创建事件
     onShow?: (props: EventProps) => void; // 显示事件
     onHide?: (props: EventProps) => void; // 隐藏事件
+    onPopupLayerOpened?: (props: PopupLayerOpenedEventProps) => void; // 弹出层打开完成事件
+    onPopupLayerClosed?: (props: PopupLayerClosedEventProps) => 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 +250,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.9",
   "description": "",
   "files": [
     "api"
@@ -21,6 +21,6 @@
     "@types/uuid": "^9.0.7",
     "puppeteer-core": "^22.4.1",
     "typescript": "^5.3.3",
-    "@kepoai/types": "^0.0.11"
+    "@kepoai/types": "^0.0.12"
   }
 }