@yh-ui/hooks 0.1.10 → 0.1.12

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

@@ -0,0 +1,254 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.localStorageAdapter = exports.IndexedDBAdapter = void 0;
+exports.useAiConversations = useAiConversations;
+var _vue = require("vue");
+const localStorageAdapter = exports.localStorageAdapter = {
+  getItem: key => {
+    try {
+      return localStorage.getItem(key);
+    } catch {
+      return null;
+    }
+  },
+  setItem: (key, value) => {
+    try {
+      localStorage.setItem(key, value);
+    } catch {}
+  },
+  removeItem: key => {
+    try {
+      localStorage.removeItem(key);
+    } catch {}
+  }
+};
+class IndexedDBAdapter {
+  db = null;
+  dbName;
+  storeName = "ai_conversations";
+  ready;
+  constructor(dbName = "yh-ui-ai") {
+    this.dbName = dbName;
+    this.ready = this.init();
+  }
+  init() {
+    return new Promise((resolve, reject) => {
+      if (typeof indexedDB === "undefined") {
+        resolve();
+        return;
+      }
+      const req = indexedDB.open(this.dbName, 1);
+      req.onupgradeneeded = () => {
+        req.result.createObjectStore(this.storeName);
+      };
+      req.onsuccess = () => {
+        this.db = req.result;
+        resolve();
+      };
+      req.onerror = () => reject(req.error);
+    });
+  }
+  async getItem(key) {
+    await this.ready;
+    if (!this.db) return null;
+    return new Promise(resolve => {
+      const tx = this.db.transaction(this.storeName, "readonly");
+      const req = tx.objectStore(this.storeName).get(key);
+      req.onsuccess = () => resolve(req.result ?? null);
+      req.onerror = () => resolve(null);
+    });
+  }
+  async setItem(key, value) {
+    await this.ready;
+    if (!this.db) return;
+    return new Promise(resolve => {
+      const tx = this.db.transaction(this.storeName, "readwrite");
+      tx.objectStore(this.storeName).put(value, key);
+      tx.oncomplete = () => resolve();
+    });
+  }
+  async removeItem(key) {
+    await this.ready;
+    if (!this.db) return;
+    return new Promise(resolve => {
+      const tx = this.db.transaction(this.storeName, "readwrite");
+      tx.objectStore(this.storeName).delete(key);
+      tx.oncomplete = () => resolve();
+    });
+  }
+}
+exports.IndexedDBAdapter = IndexedDBAdapter;
+function getGroupLabel(updatedAt) {
+  const now = Date.now();
+  const diff = now - updatedAt;
+  const oneDay = 864e5;
+  if (diff < oneDay) return "today";
+  if (diff < 7 * oneDay) return "last7Days";
+  if (diff < 30 * oneDay) return "last30Days";
+  return "earlier";
+}
+const GROUP_ORDER = ["today", "last7Days", "last30Days", "earlier"];
+function useAiConversations(options = {}) {
+  const {
+    idGenerator = () => Math.random().toString(36).substring(2, 9),
+    storage = "localStorage",
+    storageKey = "yh-ui-ai-conversations",
+    pageSize = 20
+  } = options;
+  let adapter = null;
+  if (storage === "localStorage") {
+    adapter = localStorageAdapter;
+  } else if (storage === "indexedDB") {
+    adapter = new IndexedDBAdapter();
+  } else if (storage && typeof storage === "object") {
+    adapter = storage;
+  }
+  const conversations = (0, _vue.ref)([]);
+  const page = (0, _vue.ref)(1);
+  const isLoadingMore = (0, _vue.ref)(false);
+  const initPromise = (async () => {
+    let stored = [];
+    if (adapter) {
+      try {
+        const raw = await adapter.getItem(storageKey);
+        if (raw) stored = JSON.parse(raw);
+      } catch {
+        stored = [];
+      }
+    }
+    const init = options.initialConversations ?? [];
+    const merged = [...init];
+    for (const s of stored) {
+      if (!merged.find(c => c.id === s.id)) {
+        merged.push(s);
+      }
+    }
+    conversations.value = merged.sort((a, b) => {
+      if (a.pinned !== b.pinned) return a.pinned ? -1 : 1;
+      return b.updatedAt - a.updatedAt;
+    });
+  })();
+  const persist = async () => {
+    if (!adapter) return;
+    try {
+      await adapter.setItem(storageKey, JSON.stringify(conversations.value));
+    } catch {}
+  };
+  const groupedConversations = (0, _vue.computed)(() => {
+    const groups = {
+      today: [],
+      last7Days: [],
+      last30Days: [],
+      earlier: []
+    };
+    for (const c of conversations.value) {
+      if (c.pinned) continue;
+      const key = getGroupLabel(c.updatedAt);
+      groups[key].push(c);
+    }
+    const result = [];
+    const pinned = conversations.value.filter(c => c.pinned);
+    if (pinned.length > 0) {
+      result.push({
+        label: "pinned",
+        items: pinned
+      });
+    }
+    for (const key of GROUP_ORDER) {
+      if (groups[key].length > 0) {
+        result.push({
+          label: key,
+          items: groups[key]
+        });
+      }
+    }
+    return result;
+  });
+  const pagedConversations = (0, _vue.computed)(() => {
+    return conversations.value.slice(0, page.value * pageSize);
+  });
+  const hasMore = (0, _vue.computed)(() => {
+    return pagedConversations.value.length < conversations.value.length;
+  });
+  const loadMore = async () => {
+    if (!hasMore.value || isLoadingMore.value) return;
+    isLoadingMore.value = true;
+    await new Promise(r => setTimeout(r, 300));
+    page.value++;
+    isLoadingMore.value = false;
+  };
+  const createConversation = async (title, meta) => {
+    const newConv = {
+      id: idGenerator(),
+      title,
+      updatedAt: Date.now(),
+      meta
+    };
+    conversations.value.unshift(newConv);
+    await persist();
+    return newConv;
+  };
+  const removeConversation = async id => {
+    const idx = conversations.value.findIndex(c => c.id === id);
+    if (idx !== -1) {
+      conversations.value.splice(idx, 1);
+      await persist();
+    }
+  };
+  const updateConversation = async (id, updates) => {
+    const idx = conversations.value.findIndex(c => c.id === id);
+    if (idx !== -1) {
+      conversations.value[idx] = {
+        ...conversations.value[idx],
+        ...updates,
+        updatedAt: Date.now()
+      };
+      await persist();
+    }
+  };
+  const pinConversation = async (id, pinned = true) => {
+    await updateConversation(id, {
+      pinned
+    });
+    conversations.value.sort((a, b) => {
+      if (a.pinned !== b.pinned) return a.pinned ? -1 : 1;
+      return b.updatedAt - a.updatedAt;
+    });
+    await persist();
+  };
+  const clear = async () => {
+    conversations.value = [];
+    if (adapter) {
+      await adapter.removeItem(storageKey);
+    }
+  };
+  return {
+    /** 完整会话列表 */
+    conversations,
+    /** 按时间分组后的列表（置顶 / 今天 / 最近 7 天 / 更早） */
+    groupedConversations,
+    /** 分页后的列表 */
+    pagedConversations,
+    /** 是否还有更多数据 */
+    hasMore,
+    /** 加载更多 */
+    loadMore,
+    /** 加载更多状态 */
+    isLoadingMore,
+    /** 等待初始化完成（SSR 场景使用） */
+    ready: initPromise,
+    /** 新建会话 */
+    createConversation,
+    /** 删除会话 */
+    removeConversation,
+    /** 更新会话属性 */
+    updateConversation,
+    /** 置顶/取消置顶 */
+    pinConversation,
+    /** 清空全部 */
+    clear
+  };
+}

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

@@ -0,0 +1,148 @@
+export interface AiConversation {
+    id: string;
+    title: string;
+    /**
+     * 最近更新时间（时间戳 ms）
+     */
+    updatedAt: number;
+    /**
+     * 对话预览/最后一条消息内容
+     */
+    excerpt?: string;
+    /**
+     * 是否置顶
+     */
+    pinned?: boolean;
+    /**
+     * 自定义数据（例如知识库 ID 等业务数据）
+     */
+    meta?: Record<string, unknown>;
+}
+export interface StorageAdapter {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+/**
+ * localStorage 适配器（默认）
+ */
+export declare const localStorageAdapter: StorageAdapter;
+/**
+ * IndexedDB 适配器（适合大量数据持久化）
+ */
+export declare class IndexedDBAdapter implements StorageAdapter {
+    private db;
+    private dbName;
+    private storeName;
+    private ready;
+    constructor(dbName?: string);
+    private init;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+export type ConversationGroup = {
+    label: string;
+    items: AiConversation[];
+};
+export interface UseAiConversationsOptions {
+    /** 初始化数据（或从后端的直出） */
+    initialConversations?: AiConversation[];
+    /** 自定义生成 ID 的函数 */
+    idGenerator?: () => string;
+    /**
+     * 持久化存储适配器
+     * - false: 不持久化（仅内存）
+     * - 'localStorage': 使用 localStorage（默认）
+     * - 'indexedDB': 使用 IndexedDB
+     * - StorageAdapter: 自定义适配器
+     */
+    storage?: false | 'localStorage' | 'indexedDB' | StorageAdapter;
+    /** 持久化 key 前缀 */
+    storageKey?: string;
+    /**
+     * 每次加载的数量（用于分页 / 懒加载）
+     * @default 20
+     */
+    pageSize?: number;
+}
+/**
+ * useAiConversations - 会话历史管理 Hook
+ *
+ * 特性：
+ * - 完整的 CRUD + 置顶操作
+ * - 可插拔持久化（localStorage / IndexedDB / 自定义）
+ * - 按时间自动分组（今天 / 最近 7 天 / 最近 30 天 / 更早）
+ * - 分页懒加载
+ */
+export declare function useAiConversations(options?: UseAiConversationsOptions): {
+    /** 完整会话列表 */
+    conversations: import("vue").Ref<{
+        id: string;
+        title: string;
+        updatedAt: number;
+        excerpt?: string
+        /**
+         * 是否置顶
+         */
+         | undefined;
+        pinned?: boolean
+        /**
+         * 自定义数据（例如知识库 ID 等业务数据）
+         */
+         | undefined;
+        meta?: Record<string, unknown> | undefined;
+    }[], AiConversation[] | {
+        id: string;
+        title: string;
+        updatedAt: number;
+        excerpt?: string
+        /**
+         * 是否置顶
+         */
+         | undefined;
+        pinned?: boolean
+        /**
+         * 自定义数据（例如知识库 ID 等业务数据）
+         */
+         | undefined;
+        meta?: Record<string, unknown> | undefined;
+    }[]>;
+    /** 按时间分组后的列表（置顶 / 今天 / 最近 7 天 / 更早） */
+    groupedConversations: import("vue").ComputedRef<ConversationGroup[]>;
+    /** 分页后的列表 */
+    pagedConversations: import("vue").ComputedRef<{
+        id: string;
+        title: string;
+        updatedAt: number;
+        excerpt?: string
+        /**
+         * 是否置顶
+         */
+         | undefined;
+        pinned?: boolean
+        /**
+         * 自定义数据（例如知识库 ID 等业务数据）
+         */
+         | undefined;
+        meta?: Record<string, unknown> | undefined;
+    }[]>;
+    /** 是否还有更多数据 */
+    hasMore: import("vue").ComputedRef<boolean>;
+    /** 加载更多 */
+    loadMore: () => Promise<void>;
+    /** 加载更多状态 */
+    isLoadingMore: import("vue").Ref<boolean, boolean>;
+    /** 等待初始化完成（SSR 场景使用） */
+    ready: Promise<void>;
+    /** 新建会话 */
+    createConversation: (title: string, meta?: Record<string, unknown>) => Promise<AiConversation>;
+    /** 删除会话 */
+    removeConversation: (id: string) => Promise<void>;
+    /** 更新会话属性 */
+    updateConversation: (id: string, updates: Partial<Omit<AiConversation, "id">>) => Promise<void>;
+    /** 置顶/取消置顶 */
+    pinConversation: (id: string, pinned?: boolean) => Promise<void>;
+    /** 清空全部 */
+    clear: () => Promise<void>;
+};

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

@@ -0,0 +1,241 @@
+import { ref, computed } from "vue";
+export const localStorageAdapter = {
+  getItem: (key) => {
+    try {
+      return localStorage.getItem(key);
+    } catch {
+      return null;
+    }
+  },
+  setItem: (key, value) => {
+    try {
+      localStorage.setItem(key, value);
+    } catch {
+    }
+  },
+  removeItem: (key) => {
+    try {
+      localStorage.removeItem(key);
+    } catch {
+    }
+  }
+};
+export class IndexedDBAdapter {
+  db = null;
+  dbName;
+  storeName = "ai_conversations";
+  ready;
+  constructor(dbName = "yh-ui-ai") {
+    this.dbName = dbName;
+    this.ready = this.init();
+  }
+  init() {
+    return new Promise((resolve, reject) => {
+      if (typeof indexedDB === "undefined") {
+        resolve();
+        return;
+      }
+      const req = indexedDB.open(this.dbName, 1);
+      req.onupgradeneeded = () => {
+        req.result.createObjectStore(this.storeName);
+      };
+      req.onsuccess = () => {
+        this.db = req.result;
+        resolve();
+      };
+      req.onerror = () => reject(req.error);
+    });
+  }
+  async getItem(key) {
+    await this.ready;
+    if (!this.db) return null;
+    return new Promise((resolve) => {
+      const tx = this.db.transaction(this.storeName, "readonly");
+      const req = tx.objectStore(this.storeName).get(key);
+      req.onsuccess = () => resolve(req.result ?? null);
+      req.onerror = () => resolve(null);
+    });
+  }
+  async setItem(key, value) {
+    await this.ready;
+    if (!this.db) return;
+    return new Promise((resolve) => {
+      const tx = this.db.transaction(this.storeName, "readwrite");
+      tx.objectStore(this.storeName).put(value, key);
+      tx.oncomplete = () => resolve();
+    });
+  }
+  async removeItem(key) {
+    await this.ready;
+    if (!this.db) return;
+    return new Promise((resolve) => {
+      const tx = this.db.transaction(this.storeName, "readwrite");
+      tx.objectStore(this.storeName).delete(key);
+      tx.oncomplete = () => resolve();
+    });
+  }
+}
+function getGroupLabel(updatedAt) {
+  const now = Date.now();
+  const diff = now - updatedAt;
+  const oneDay = 864e5;
+  if (diff < oneDay) return "today";
+  if (diff < 7 * oneDay) return "last7Days";
+  if (diff < 30 * oneDay) return "last30Days";
+  return "earlier";
+}
+const GROUP_ORDER = ["today", "last7Days", "last30Days", "earlier"];
+export function useAiConversations(options = {}) {
+  const {
+    idGenerator = () => Math.random().toString(36).substring(2, 9),
+    storage = "localStorage",
+    storageKey = "yh-ui-ai-conversations",
+    pageSize = 20
+  } = options;
+  let adapter = null;
+  if (storage === "localStorage") {
+    adapter = localStorageAdapter;
+  } else if (storage === "indexedDB") {
+    adapter = new IndexedDBAdapter();
+  } else if (storage && typeof storage === "object") {
+    adapter = storage;
+  }
+  const conversations = ref([]);
+  const page = ref(1);
+  const isLoadingMore = ref(false);
+  const initPromise = (async () => {
+    let stored = [];
+    if (adapter) {
+      try {
+        const raw = await adapter.getItem(storageKey);
+        if (raw) stored = JSON.parse(raw);
+      } catch {
+        stored = [];
+      }
+    }
+    const init = options.initialConversations ?? [];
+    const merged = [...init];
+    for (const s of stored) {
+      if (!merged.find((c) => c.id === s.id)) {
+        merged.push(s);
+      }
+    }
+    conversations.value = merged.sort((a, b) => {
+      if (a.pinned !== b.pinned) return a.pinned ? -1 : 1;
+      return b.updatedAt - a.updatedAt;
+    });
+  })();
+  const persist = async () => {
+    if (!adapter) return;
+    try {
+      await adapter.setItem(storageKey, JSON.stringify(conversations.value));
+    } catch {
+    }
+  };
+  const groupedConversations = computed(() => {
+    const groups = {
+      today: [],
+      last7Days: [],
+      last30Days: [],
+      earlier: []
+    };
+    for (const c of conversations.value) {
+      if (c.pinned) continue;
+      const key = getGroupLabel(c.updatedAt);
+      groups[key].push(c);
+    }
+    const result = [];
+    const pinned = conversations.value.filter((c) => c.pinned);
+    if (pinned.length > 0) {
+      result.push({ label: "pinned", items: pinned });
+    }
+    for (const key of GROUP_ORDER) {
+      if (groups[key].length > 0) {
+        result.push({ label: key, items: groups[key] });
+      }
+    }
+    return result;
+  });
+  const pagedConversations = computed(() => {
+    return conversations.value.slice(0, page.value * pageSize);
+  });
+  const hasMore = computed(() => {
+    return pagedConversations.value.length < conversations.value.length;
+  });
+  const loadMore = async () => {
+    if (!hasMore.value || isLoadingMore.value) return;
+    isLoadingMore.value = true;
+    await new Promise((r) => setTimeout(r, 300));
+    page.value++;
+    isLoadingMore.value = false;
+  };
+  const createConversation = async (title, meta) => {
+    const newConv = {
+      id: idGenerator(),
+      title,
+      updatedAt: Date.now(),
+      meta
+    };
+    conversations.value.unshift(newConv);
+    await persist();
+    return newConv;
+  };
+  const removeConversation = async (id) => {
+    const idx = conversations.value.findIndex((c) => c.id === id);
+    if (idx !== -1) {
+      conversations.value.splice(idx, 1);
+      await persist();
+    }
+  };
+  const updateConversation = async (id, updates) => {
+    const idx = conversations.value.findIndex((c) => c.id === id);
+    if (idx !== -1) {
+      conversations.value[idx] = {
+        ...conversations.value[idx],
+        ...updates,
+        updatedAt: Date.now()
+      };
+      await persist();
+    }
+  };
+  const pinConversation = async (id, pinned = true) => {
+    await updateConversation(id, { pinned });
+    conversations.value.sort((a, b) => {
+      if (a.pinned !== b.pinned) return a.pinned ? -1 : 1;
+      return b.updatedAt - a.updatedAt;
+    });
+    await persist();
+  };
+  const clear = async () => {
+    conversations.value = [];
+    if (adapter) {
+      await adapter.removeItem(storageKey);
+    }
+  };
+  return {
+    /** 完整会话列表 */
+    conversations,
+    /** 按时间分组后的列表（置顶 / 今天 / 最近 7 天 / 更早） */
+    groupedConversations,
+    /** 分页后的列表 */
+    pagedConversations,
+    /** 是否还有更多数据 */
+    hasMore,
+    /** 加载更多 */
+    loadMore,
+    /** 加载更多状态 */
+    isLoadingMore,
+    /** 等待初始化完成（SSR 场景使用） */
+    ready: initPromise,
+    /** 新建会话 */
+    createConversation,
+    /** 删除会话 */
+    removeConversation,
+    /** 更新会话属性 */
+    updateConversation,
+    /** 置顶/取消置顶 */
+    pinConversation,
+    /** 清空全部 */
+    clear
+  };
+}