@yh-ui/hooks 0.1.17 → 0.1.21

package/dist/storage/index.cjs

@@ -0,0 +1,128 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.IndexedDBAdapter = exports.APIClient = void 0;
+class IndexedDBAdapter {
+  dbName;
+  storeName;
+  db = null;
+  constructor(dbName = "yh-ui-db", storeName = "yh-ui-store") {
+    this.dbName = dbName;
+    this.storeName = storeName;
+  }
+  async getDB() {
+    if (this.db) return this.db;
+    return new Promise((resolve, reject) => {
+      const request = indexedDB.open(this.dbName, 1);
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => {
+        this.db = request.result;
+        resolve(request.result);
+      };
+      request.onupgradeneeded = event => {
+        const db = event.target.result;
+        if (!db.objectStoreNames.contains(this.storeName)) {
+          db.createObjectStore(this.storeName, {
+            keyPath: "key"
+          });
+        }
+      };
+    });
+  }
+  async get(key) {
+    const db = await this.getDB();
+    return new Promise((resolve, reject) => {
+      const transaction = db.transaction(this.storeName, "readonly");
+      const store = transaction.objectStore(this.storeName);
+      const request = store.get(key);
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve(request.result?.value ?? null);
+    });
+  }
+  async set(key, value) {
+    const db = await this.getDB();
+    return new Promise((resolve, reject) => {
+      const transaction = db.transaction(this.storeName, "readwrite");
+      const store = transaction.objectStore(this.storeName);
+      const request = store.put({
+        key,
+        value
+      });
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve();
+    });
+  }
+  async remove(key) {
+    const db = await this.getDB();
+    return new Promise((resolve, reject) => {
+      const transaction = db.transaction(this.storeName, "readwrite");
+      const store = transaction.objectStore(this.storeName);
+      const request = store.delete(key);
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve();
+    });
+  }
+  async clear() {
+    const db = await this.getDB();
+    return new Promise((resolve, reject) => {
+      const transaction = db.transaction(this.storeName, "readwrite");
+      const store = transaction.objectStore(this.storeName);
+      const request = store.clear();
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve();
+    });
+  }
+}
+exports.IndexedDBAdapter = IndexedDBAdapter;
+class APIClient {
+  baseURL;
+  headers;
+  constructor(baseURL, headers = {}) {
+    this.baseURL = baseURL.replace(/\/$/, "");
+    this.headers = headers;
+  }
+  async get(key) {
+    const response = await fetch(`${this.baseURL}/storage/${key}`, {
+      headers: this.headers
+    });
+    if (!response.ok) {
+      if (response.status === 404) return null;
+      throw new Error(`HTTP ${response.status}`);
+    }
+    return response.json();
+  }
+  async set(key, value) {
+    const response = await fetch(`${this.baseURL}/storage/${key}`, {
+      method: "PUT",
+      headers: {
+        ...this.headers,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(value)
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+  }
+  async remove(key) {
+    const response = await fetch(`${this.baseURL}/storage/${key}`, {
+      method: "DELETE",
+      headers: this.headers
+    });
+    if (!response.ok && response.status !== 404) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+  }
+  async clear() {
+    const response = await fetch(`${this.baseURL}/storage`, {
+      method: "DELETE",
+      headers: this.headers
+    });
+    if (!response.ok && response.status !== 404) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+  }
+}
+exports.APIClient = APIClient;

package/dist/storage/index.d.ts

@@ -0,0 +1,26 @@
+export interface StorageAdapter {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+export declare class IndexedDBAdapter implements StorageAdapter {
+    private dbName;
+    private storeName;
+    private db;
+    constructor(dbName?: string, storeName?: string);
+    private getDB;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+export declare class APIClient implements StorageAdapter {
+    private baseURL;
+    private headers;
+    constructor(baseURL: string, headers?: Record<string, string>);
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/storage/index.mjs

@@ -0,0 +1,112 @@
+export class IndexedDBAdapter {
+  dbName;
+  storeName;
+  db = null;
+  constructor(dbName = "yh-ui-db", storeName = "yh-ui-store") {
+    this.dbName = dbName;
+    this.storeName = storeName;
+  }
+  async getDB() {
+    if (this.db) return this.db;
+    return new Promise((resolve, reject) => {
+      const request = indexedDB.open(this.dbName, 1);
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => {
+        this.db = request.result;
+        resolve(request.result);
+      };
+      request.onupgradeneeded = (event) => {
+        const db = event.target.result;
+        if (!db.objectStoreNames.contains(this.storeName)) {
+          db.createObjectStore(this.storeName, { keyPath: "key" });
+        }
+      };
+    });
+  }
+  async get(key) {
+    const db = await this.getDB();
+    return new Promise((resolve, reject) => {
+      const transaction = db.transaction(this.storeName, "readonly");
+      const store = transaction.objectStore(this.storeName);
+      const request = store.get(key);
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve(request.result?.value ?? null);
+    });
+  }
+  async set(key, value) {
+    const db = await this.getDB();
+    return new Promise((resolve, reject) => {
+      const transaction = db.transaction(this.storeName, "readwrite");
+      const store = transaction.objectStore(this.storeName);
+      const request = store.put({ key, value });
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve();
+    });
+  }
+  async remove(key) {
+    const db = await this.getDB();
+    return new Promise((resolve, reject) => {
+      const transaction = db.transaction(this.storeName, "readwrite");
+      const store = transaction.objectStore(this.storeName);
+      const request = store.delete(key);
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve();
+    });
+  }
+  async clear() {
+    const db = await this.getDB();
+    return new Promise((resolve, reject) => {
+      const transaction = db.transaction(this.storeName, "readwrite");
+      const store = transaction.objectStore(this.storeName);
+      const request = store.clear();
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve();
+    });
+  }
+}
+export class APIClient {
+  baseURL;
+  headers;
+  constructor(baseURL, headers = {}) {
+    this.baseURL = baseURL.replace(/\/$/, "");
+    this.headers = headers;
+  }
+  async get(key) {
+    const response = await fetch(`${this.baseURL}/storage/${key}`, {
+      headers: this.headers
+    });
+    if (!response.ok) {
+      if (response.status === 404) return null;
+      throw new Error(`HTTP ${response.status}`);
+    }
+    return response.json();
+  }
+  async set(key, value) {
+    const response = await fetch(`${this.baseURL}/storage/${key}`, {
+      method: "PUT",
+      headers: { ...this.headers, "Content-Type": "application/json" },
+      body: JSON.stringify(value)
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+  }
+  async remove(key) {
+    const response = await fetch(`${this.baseURL}/storage/${key}`, {
+      method: "DELETE",
+      headers: this.headers
+    });
+    if (!response.ok && response.status !== 404) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+  }
+  async clear() {
+    const response = await fetch(`${this.baseURL}/storage`, {
+      method: "DELETE",
+      headers: this.headers
+    });
+    if (!response.ok && response.status !== 404) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+  }
+}

package/dist/use-ai/index.cjs

@@ -57,4 +57,15 @@ Object.keys(_useAiVoice).forEach(function (key) {
       return _useAiVoice[key];
     }
   });
+});
+var _useAiPersistence = require("./use-ai-persistence.cjs");
+Object.keys(_useAiPersistence).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useAiPersistence[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useAiPersistence[key];
+    }
+  });
 });

package/dist/use-ai/index.d.ts

@@ -3,3 +3,4 @@ export * from './use-ai-stream';
 export * from './use-ai-conversations';
 export * from './use-ai-request';
 export * from './use-ai-voice';
+export * from './use-ai-persistence';

package/dist/use-ai/index.mjs

@@ -3,3 +3,4 @@ export * from "./use-ai-stream.mjs";
 export * from "./use-ai-conversations.mjs";
 export * from "./use-ai-request.mjs";
 export * from "./use-ai-voice.mjs";
+export * from "./use-ai-persistence.mjs";

package/dist/use-ai/use-ai-conversations.cjs

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.localStorageAdapter = exports.IndexedDBAdapter = void 0;
+exports.localStorageAdapter = exports.AiIndexedDBAdapter = void 0;
 exports.useAiConversations = useAiConversations;
 var _vue = require("vue");
 const localStorageAdapter = exports.localStorageAdapter = {
@@ -25,7 +25,7 @@ const localStorageAdapter = exports.localStorageAdapter = {
     } catch {}
   }
 };
-class IndexedDBAdapter {
+class AiIndexedDBAdapter {
   db = null;
   dbName;
   storeName = "ai_conversations";
@@ -80,7 +80,7 @@ class IndexedDBAdapter {
     });
   }
 }
-exports.IndexedDBAdapter = IndexedDBAdapter;
+exports.AiIndexedDBAdapter = AiIndexedDBAdapter;
 function getGroupLabel(updatedAt) {
   const now = Date.now();
   const diff = now - updatedAt;
@@ -96,13 +96,16 @@ function useAiConversations(options = {}) {
     idGenerator = () => Math.random().toString(36).substring(2, 9),
     storage = "localStorage",
     storageKey = "yh-ui-ai-conversations",
-    pageSize = 20
+    pageSize = 20,
+    remoteSync,
+    autoSync = false,
+    syncInterval = 3e4
   } = options;
   let adapter = null;
   if (storage === "localStorage") {
     adapter = localStorageAdapter;
   } else if (storage === "indexedDB") {
-    adapter = new IndexedDBAdapter();
+    adapter = new AiIndexedDBAdapter();
   } else if (storage && typeof storage === "object") {
     adapter = storage;
   }
@@ -225,6 +228,61 @@ function useAiConversations(options = {}) {
       await adapter.removeItem(storageKey);
     }
   };
+  const isSyncing = (0, _vue.ref)(false);
+  const lastSyncTime = (0, _vue.ref)(0);
+  const syncError = (0, _vue.ref)(null);
+  const syncToRemote = async () => {
+    if (!remoteSync || isSyncing.value) return;
+    isSyncing.value = true;
+    syncError.value = null;
+    try {
+      await remoteSync.batchUpdate(conversations.value);
+      lastSyncTime.value = Date.now();
+    } catch (err) {
+      syncError.value = err instanceof Error ? err : new Error(String(err));
+    } finally {
+      isSyncing.value = false;
+    }
+  };
+  const fetchFromRemote = async () => {
+    if (!remoteSync || isSyncing.value) return;
+    isSyncing.value = true;
+    syncError.value = null;
+    try {
+      const remoteConversations = await remoteSync.fetchConversations();
+      for (const rc of remoteConversations) {
+        if (!conversations.value.find(c => c.id === rc.id)) {
+          conversations.value.push(rc);
+        }
+      }
+      conversations.value.sort((a, b) => {
+        if (a.pinned !== b.pinned) return a.pinned ? -1 : 1;
+        return b.updatedAt - a.updatedAt;
+      });
+      lastSyncTime.value = Date.now();
+      await persist();
+    } catch (err) {
+      syncError.value = err instanceof Error ? err : new Error(String(err));
+    } finally {
+      isSyncing.value = false;
+    }
+  };
+  let syncTimer = null;
+  const startSync = () => {
+    if (!remoteSync || syncTimer) return;
+    if (syncInterval > 0) {
+      syncTimer = setInterval(syncToRemote, syncInterval);
+    }
+  };
+  const stopSync = () => {
+    if (syncTimer) {
+      clearInterval(syncTimer);
+      syncTimer = null;
+    }
+  };
+  if (remoteSync && autoSync) {
+    startSync();
+  }
   return {
     /** 完整会话列表 */
     conversations,
@@ -249,6 +307,15 @@ function useAiConversations(options = {}) {
     /** 置顶/取消置顶 */
     pinConversation,
     /** 清空全部 */
-    clear
+    clear,
+    /** 远程同步状态 */
+    isSyncing,
+    lastSyncTime,
+    syncError,
+    /** 远程同步方法 */
+    syncToRemote,
+    fetchFromRemote,
+    startSync,
+    stopSync
   };
 }

package/dist/use-ai/use-ai-conversations.d.ts

@@ -18,7 +18,7 @@ export interface AiConversation {
      */
     meta?: Record<string, unknown>;
 }
-export interface StorageAdapter {
+export interface AiStorageAdapter {
     getItem(key: string): string | null | Promise<string | null>;
     setItem(key: string, value: string): void | Promise<void>;
     removeItem(key: string): void | Promise<void>;
@@ -26,11 +26,11 @@ export interface StorageAdapter {
 /**
  * localStorage 适配器（默认）
  */
-export declare const localStorageAdapter: StorageAdapter;
+export declare const localStorageAdapter: AiStorageAdapter;
 /**
  * IndexedDB 适配器（适合大量数据持久化）
  */
-export declare class IndexedDBAdapter implements StorageAdapter {
+export declare class AiIndexedDBAdapter implements AiStorageAdapter {
     private db;
     private dbName;
     private storeName;
@@ -45,6 +45,18 @@ export type ConversationGroup = {
     label: string;
     items: AiConversation[];
 };
+export interface RemoteSyncAdapter {
+    /** 获取所有会话 */
+    fetchConversations(): Promise<AiConversation[]>;
+    /** 创建会话 */
+    createConversation(conversation: AiConversation): Promise<AiConversation>;
+    /** 更新会话 */
+    updateConversation(id: string, updates: Partial<AiConversation>): Promise<AiConversation>;
+    /** 删除会话 */
+    deleteConversation(id: string): Promise<void>;
+    /** 批量更新（用于同步） */
+    batchUpdate(conversations: AiConversation[]): Promise<AiConversation[]>;
+}
 export interface UseAiConversationsOptions {
     /** 初始化数据（或从后端的直出） */
     initialConversations?: AiConversation[];
@@ -57,7 +69,7 @@ export interface UseAiConversationsOptions {
      * - 'indexedDB': 使用 IndexedDB
      * - StorageAdapter: 自定义适配器
      */
-    storage?: false | 'localStorage' | 'indexedDB' | StorageAdapter;
+    storage?: false | 'localStorage' | 'indexedDB' | AiStorageAdapter;
     /** 持久化 key 前缀 */
     storageKey?: string;
     /**
@@ -65,6 +77,15 @@ export interface UseAiConversationsOptions {
      * @default 20
      */
     pageSize?: number;
+    /**
+     * 远程同步适配器（用于与后端同步）
+     * 设置后会自动进行本地与远程的数据同步
+     */
+    remoteSync?: RemoteSyncAdapter;
+    /** 是否自动同步（仅在设置了 remoteSync 时有效） */
+    autoSync?: boolean;
+    /** 同步间隔（毫秒），0 表示实时同步 */
+    syncInterval?: number;
 }
 /**
  * useAiConversations - 会话历史管理 Hook
@@ -145,4 +166,13 @@ export declare function useAiConversations(options?: UseAiConversationsOptions):
     pinConversation: (id: string, pinned?: boolean) => Promise<void>;
     /** 清空全部 */
     clear: () => Promise<void>;
+    /** 远程同步状态 */
+    isSyncing: import("vue").Ref<boolean, boolean>;
+    lastSyncTime: import("vue").Ref<number, number>;
+    syncError: import("vue").Ref<Error | null, Error | null>;
+    /** 远程同步方法 */
+    syncToRemote: () => Promise<void>;
+    fetchFromRemote: () => Promise<void>;
+    startSync: () => void;
+    stopSync: () => void;
 };

package/dist/use-ai/use-ai-conversations.mjs

@@ -20,7 +20,7 @@ export const localStorageAdapter = {
     }
   }
 };
-export class IndexedDBAdapter {
+export class AiIndexedDBAdapter {
   db = null;
   dbName;
   storeName = "ai_conversations";
@@ -90,13 +90,16 @@ export function useAiConversations(options = {}) {
     idGenerator = () => Math.random().toString(36).substring(2, 9),
     storage = "localStorage",
     storageKey = "yh-ui-ai-conversations",
-    pageSize = 20
+    pageSize = 20,
+    remoteSync,
+    autoSync = false,
+    syncInterval = 3e4
   } = options;
   let adapter = null;
   if (storage === "localStorage") {
     adapter = localStorageAdapter;
   } else if (storage === "indexedDB") {
-    adapter = new IndexedDBAdapter();
+    adapter = new AiIndexedDBAdapter();
   } else if (storage && typeof storage === "object") {
     adapter = storage;
   }
@@ -212,6 +215,61 @@ export function useAiConversations(options = {}) {
       await adapter.removeItem(storageKey);
     }
   };
+  const isSyncing = ref(false);
+  const lastSyncTime = ref(0);
+  const syncError = ref(null);
+  const syncToRemote = async () => {
+    if (!remoteSync || isSyncing.value) return;
+    isSyncing.value = true;
+    syncError.value = null;
+    try {
+      await remoteSync.batchUpdate(conversations.value);
+      lastSyncTime.value = Date.now();
+    } catch (err) {
+      syncError.value = err instanceof Error ? err : new Error(String(err));
+    } finally {
+      isSyncing.value = false;
+    }
+  };
+  const fetchFromRemote = async () => {
+    if (!remoteSync || isSyncing.value) return;
+    isSyncing.value = true;
+    syncError.value = null;
+    try {
+      const remoteConversations = await remoteSync.fetchConversations();
+      for (const rc of remoteConversations) {
+        if (!conversations.value.find((c) => c.id === rc.id)) {
+          conversations.value.push(rc);
+        }
+      }
+      conversations.value.sort((a, b) => {
+        if (a.pinned !== b.pinned) return a.pinned ? -1 : 1;
+        return b.updatedAt - a.updatedAt;
+      });
+      lastSyncTime.value = Date.now();
+      await persist();
+    } catch (err) {
+      syncError.value = err instanceof Error ? err : new Error(String(err));
+    } finally {
+      isSyncing.value = false;
+    }
+  };
+  let syncTimer = null;
+  const startSync = () => {
+    if (!remoteSync || syncTimer) return;
+    if (syncInterval > 0) {
+      syncTimer = setInterval(syncToRemote, syncInterval);
+    }
+  };
+  const stopSync = () => {
+    if (syncTimer) {
+      clearInterval(syncTimer);
+      syncTimer = null;
+    }
+  };
+  if (remoteSync && autoSync) {
+    startSync();
+  }
   return {
     /** 完整会话列表 */
     conversations,
@@ -236,6 +294,15 @@ export function useAiConversations(options = {}) {
     /** 置顶/取消置顶 */
     pinConversation,
     /** 清空全部 */
-    clear
+    clear,
+    /** 远程同步状态 */
+    isSyncing,
+    lastSyncTime,
+    syncError,
+    /** 远程同步方法 */
+    syncToRemote,
+    fetchFromRemote,
+    startSync,
+    stopSync
   };
 }