flare-chat-core 0.2.2 → 0.2.4

package/src/app/core-chat-entry/useDevCapabilityStatusNote.js

@@ -1,22 +0,0 @@
-import { useMemo } from 'react';
-
-export function useDevCapabilityStatusNote({
-  isDev = false,
-  mode = '',
-  labels = {},
-} = {}) {
-  return useMemo(() => {
-    if (!isDev) {
-      return '';
-    }
-    const normalizedMode = String(mode || '').trim().toLowerCase();
-    if (normalizedMode === 'persistent') {
-      return String(labels.persistent || '开发态：资料能力已接入持久化链路');
-    }
-    if (normalizedMode === 'local_fallback') {
-      return String(labels.localFallback || '开发态：资料能力当前为本地回退模式');
-    }
-    return String(labels.unknown || '开发态：资料能力状态未知');
-  }, [isDev, labels.localFallback, labels.persistent, labels.unknown, mode]);
-}
-

package/src/app/core-chat-entry/useProjectNameEditing.js

@@ -1,41 +0,0 @@
-import { useState } from 'react';
-
-export function useProjectNameEditing({ defaultProjectName } = {}) {
-  const initialName = String(defaultProjectName || '').trim() || '本地演示项目';
-  const [projectNameEditing, setProjectNameEditing] = useState(false);
-  const [projectNameDraft, setProjectNameDraft] = useState(initialName);
-  const [projectDisplayName, setProjectDisplayName] = useState(initialName);
-
-  const handleProjectNameStartEdit = (projectSlot) => {
-    if (!projectSlot?.key) {
-      return;
-    }
-    setProjectNameDraft(String(projectDisplayName || '').trim());
-    setProjectNameEditing(true);
-  };
-
-  const handleProjectNameCancel = () => {
-    setProjectNameEditing(false);
-    setProjectNameDraft('');
-  };
-
-  const handleProjectNameSave = () => {
-    const nextName = String(projectNameDraft || '').trim();
-    if (nextName) {
-      setProjectDisplayName(nextName);
-    }
-    handleProjectNameCancel();
-  };
-
-  return {
-    projectNameEditing,
-    projectNameDraft,
-    setProjectNameDraft,
-    projectDisplayName,
-    handleProjectNameStartEdit,
-    handleProjectNameCancel,
-    handleProjectNameSave,
-  };
-}
-
-export default useProjectNameEditing;

package/src/app/core-chat-entry/useProjectSourceUpload.js

@@ -1,341 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
-
-const projectSourceListSingleflight = new Map();
-const SOURCE_STATUS_TERMINAL = new Set(['ready', 'failed', 'error']);
-
-function normalizeError(error, fallbackMessage) {
-  if (error instanceof Error) {
-    return error;
-  }
-  return new Error(String(error || fallbackMessage));
-}
-
-function buildSourceItem(file, index, scopedProjectId) {
-  return {
-    id: `project-source-${Date.now()}-${index}`,
-    project_id: scopedProjectId,
-    message_id: null,
-    scope: 'project',
-    source: 'local_upload',
-    filename: String(file?.name || '').trim() || `资料 ${index + 1}`,
-    mime_type: String(file?.type || '').trim(),
-    size: Number.isFinite(file?.size) ? file.size : null,
-    created_at: new Date().toISOString(),
-    status: 'ready',
-    error_message: '',
-    persisted_to_project: false,
-  };
-}
-
-function buildSourceFileSignature(item = {}) {
-  return `${item.filename || ''}::${item.size || ''}::${item.mime_type || ''}`;
-}
-
-function parseSourceList(response) {
-  if (Array.isArray(response?.sources)) {
-    return response.sources;
-  }
-  if (Array.isArray(response?.data?.sources)) {
-    return response.data.sources;
-  }
-  return [];
-}
-
-function normalizeSourceStatus(status) {
-  return String(status || '').trim().toLowerCase();
-}
-
-function hasPendingSourceProcessing(items = []) {
-  if (!Array.isArray(items) || items.length === 0) {
-    return false;
-  }
-  return items.some((item) => !SOURCE_STATUS_TERMINAL.has(normalizeSourceStatus(item?.status)));
-}
-
-function createUploadProgressItem(file, index) {
-  return {
-    id: `upload-progress-${Date.now()}-${index}`,
-    filename: String(file?.name || '').trim() || `资料 ${index + 1}`,
-    progress: 0,
-    stage: 'reading',
-    error_message: '',
-  };
-}
-
-function readFileWithProgress(file, onProgress) {
-  return new Promise((resolve, reject) => {
-    const reader = new FileReader();
-    reader.onprogress = (event) => {
-      if (!event.lengthComputable) {
-        return;
-      }
-      const percent = (event.loaded / event.total) * 80;
-      onProgress(percent);
-    };
-    reader.onload = () => {
-      onProgress(80);
-      resolve();
-    };
-    reader.onerror = () => {
-      reject(reader.error || new Error('读取文件失败'));
-    };
-    reader.readAsArrayBuffer(file);
-  });
-}
-
-export function useProjectSourceUpload({
-  projectId = '',
-  userId = '',
-  sourceAPI = null,
-  shouldLoadSources = true,
-} = {}) {
-  const fileInputRef = useRef(null);
-  const [sourceItems, setSourceItems] = useState([]);
-  const [sourceActionError, setSourceActionError] = useState(null);
-  const [sourceUploadLoading, setSourceUploadLoading] = useState(false);
-  const [sourceUploadProgressItems, setSourceUploadProgressItems] = useState([]);
-  const [sourceSyncLoading, setSourceSyncLoading] = useState(false);
-  const [sourceRemovingId, setSourceRemovingId] = useState('');
-  const [sourceEndpointUnavailable, setSourceEndpointUnavailable] = useState(false);
-
-  const canUsePersistentSourceAPI = (
-    typeof sourceAPI?.listProjectSources === 'function'
-    && typeof sourceAPI?.uploadSourceFile === 'function'
-    && typeof sourceAPI?.deleteProjectSource === 'function'
-    && !sourceEndpointUnavailable
-  );
-
-  const loadProjectSources = useCallback(async ({ silent = false } = {}) => {
-    const scopedProjectId = String(projectId || '').trim();
-    if (!canUsePersistentSourceAPI || !scopedProjectId) {
-      return;
-    }
-    if (!silent) {
-      setSourceSyncLoading(true);
-      setSourceActionError(null);
-    }
-    try {
-      const requestKey = scopedProjectId;
-      let pendingRequest = projectSourceListSingleflight.get(requestKey);
-      if (!pendingRequest) {
-        pendingRequest = sourceAPI.listProjectSources(scopedProjectId)
-          .finally(() => {
-            projectSourceListSingleflight.delete(requestKey);
-          });
-        projectSourceListSingleflight.set(requestKey, pendingRequest);
-      }
-      const response = await pendingRequest;
-      setSourceItems(parseSourceList(response));
-      setSourceEndpointUnavailable(false);
-    } catch (error) {
-      if (Number(error?.status) === 404) {
-        setSourceEndpointUnavailable(true);
-        if (!silent) {
-          setSourceActionError(null);
-        }
-        return;
-      }
-      if (!silent) {
-        setSourceActionError(normalizeError(error, '加载资料失败'));
-      }
-    } finally {
-      if (!silent) {
-        setSourceSyncLoading(false);
-      }
-    }
-  }, [canUsePersistentSourceAPI, projectId, sourceAPI]);
-
-  useEffect(() => {
-    if (!shouldLoadSources) {
-      return;
-    }
-    loadProjectSources();
-  }, [loadProjectSources, shouldLoadSources]);
-
-  useEffect(() => {
-    if (!shouldLoadSources) {
-      return undefined;
-    }
-    if (!canUsePersistentSourceAPI) {
-      return undefined;
-    }
-    if (!hasPendingSourceProcessing(sourceItems)) {
-      return undefined;
-    }
-    const timer = setInterval(() => {
-      void loadProjectSources({ silent: true });
-    }, 1500);
-    return () => {
-      clearInterval(timer);
-    };
-  }, [canUsePersistentSourceAPI, loadProjectSources, shouldLoadSources, sourceItems]);
-
-  const appendLocalSourceFiles = useCallback((nativeFiles = []) => {
-    setSourceItems((prev) => {
-      const existingSignatures = new Set(prev.map((item) => buildSourceFileSignature(item)));
-      const nextItems = nativeFiles
-        .map((file, index) => buildSourceItem(file, index, projectId))
-        .filter((item) => {
-          const signature = buildSourceFileSignature(item);
-          if (existingSignatures.has(signature)) {
-            return false;
-          }
-          existingSignatures.add(signature);
-          return true;
-        });
-      return [...nextItems, ...prev];
-    });
-  }, [projectId]);
-
-  const uploadSourceFiles = useCallback(async (nativeFiles = []) => {
-    const scopedProjectId = String(projectId || '').trim();
-    if (nativeFiles.length === 0) {
-      return;
-    }
-    setSourceUploadLoading(true);
-    setSourceActionError(null);
-    const progressItems = nativeFiles.map((file, index) => createUploadProgressItem(file, index));
-    setSourceUploadProgressItems((prev) => [...progressItems, ...prev]);
-    const updateProgressItem = (itemId, patch = {}) => {
-      setSourceUploadProgressItems((prev) => prev.map((item) => (item.id === itemId ? { ...item, ...patch } : item)));
-    };
-    try {
-      if (canUsePersistentSourceAPI && scopedProjectId) {
-        for (let index = 0; index < nativeFiles.length; index += 1) {
-          const file = nativeFiles[index];
-          const progressItem = progressItems[index];
-          await readFileWithProgress(file, (percent) => {
-            updateProgressItem(progressItem.id, {
-              stage: 'reading',
-              progress: percent,
-            });
-          });
-          updateProgressItem(progressItem.id, {
-            stage: 'uploading',
-            progress: 80,
-          });
-          await sourceAPI.uploadSourceFile({
-            project_id: scopedProjectId,
-            user_id: String(userId || '').trim() || null,
-            file,
-            filename: file.name,
-            onProgress: (percent) => {
-              const safePercent = Number.isFinite(percent) ? percent : 0;
-              const mappedPercent = 80 + (Math.max(0, Math.min(100, safePercent)) * 0.2);
-              updateProgressItem(progressItem.id, {
-                stage: 'uploading',
-                progress: mappedPercent,
-              });
-            },
-          });
-          updateProgressItem(progressItem.id, {
-            stage: 'done',
-            progress: 100,
-          });
-        }
-        await loadProjectSources();
-        return;
-      }
-      for (let index = 0; index < nativeFiles.length; index += 1) {
-        const file = nativeFiles[index];
-        const progressItem = progressItems[index];
-        await readFileWithProgress(file, (percent) => {
-          updateProgressItem(progressItem.id, {
-            stage: 'reading',
-            progress: percent,
-          });
-        });
-        updateProgressItem(progressItem.id, {
-          stage: 'uploading',
-          progress: 95,
-        });
-        appendLocalSourceFiles([file]);
-        updateProgressItem(progressItem.id, {
-          stage: 'done',
-          progress: 100,
-        });
-      }
-    } catch (error) {
-      const errorMessage = String(error?.message || '添加资料失败');
-      setSourceUploadProgressItems((prev) => prev.map((item) => (item.stage === 'done'
-        ? item
-        : {
-          ...item,
-          stage: 'error',
-          error_message: errorMessage,
-        })));
-      setSourceActionError(normalizeError(error, '添加资料失败'));
-    } finally {
-      setSourceUploadLoading(false);
-    }
-  }, [appendLocalSourceFiles, canUsePersistentSourceAPI, loadProjectSources, projectId, sourceAPI, userId]);
-
-  const handleOpenSourcePicker = useCallback((nativeFiles = []) => {
-    if (sourceUploadLoading) {
-      return;
-    }
-    if (Array.isArray(nativeFiles) && nativeFiles.length > 0) {
-      void uploadSourceFiles(nativeFiles);
-      return;
-    }
-    setSourceActionError(null);
-    fileInputRef.current?.click();
-  }, [sourceUploadLoading, uploadSourceFiles]);
-
-  const handleSourceFileChange = useCallback((event) => {
-    const nativeFiles = Array.from(event?.target?.files || []);
-    event.target.value = '';
-    void uploadSourceFiles(nativeFiles);
-  }, [uploadSourceFiles]);
-
-  const handleRemoveSource = useCallback(async (sourceId) => {
-    const scopedProjectId = String(projectId || '').trim();
-    const normalizedSourceId = String(sourceId || '').trim();
-    if (!normalizedSourceId) {
-      return;
-    }
-    setSourceActionError(null);
-    setSourceRemovingId(normalizedSourceId);
-    try {
-      if (canUsePersistentSourceAPI && scopedProjectId) {
-        await sourceAPI.deleteProjectSource(scopedProjectId, normalizedSourceId);
-        await loadProjectSources();
-      } else {
-        setSourceItems((prev) => prev.filter((item) => {
-          const currentSourceId = String(item?.source_id || item?.id || '').trim();
-          return currentSourceId !== normalizedSourceId;
-        }));
-      }
-    } catch (error) {
-      setSourceActionError(normalizeError(error, '删除资料失败'));
-    } finally {
-      setSourceRemovingId('');
-    }
-  }, [canUsePersistentSourceAPI, loadProjectSources, projectId, sourceAPI]);
-
-  const handleRetrySource = useCallback(() => {
-    if (canUsePersistentSourceAPI) {
-      loadProjectSources();
-      return;
-    }
-    setSourceActionError(null);
-  }, [canUsePersistentSourceAPI, loadProjectSources]);
-
-  const handleViewSourceDetail = useCallback(() => {}, []);
-
-  return {
-    fileInputRef,
-    sourceCapabilityMode: canUsePersistentSourceAPI ? 'persistent' : 'local_fallback',
-    sourceActionError,
-    sourceItems,
-    sourceRemovingId,
-    sourceSyncLoading,
-    sourceUploadLoading,
-    sourceUploadProgressItems,
-    handleOpenSourcePicker,
-    handleSourceFileChange,
-    handleRemoveSource,
-    handleRetrySource,
-    handleViewSourceDetail,
-  };
-}

package/src/app/core-chat-entry/useRealApiReadinessGate.js

@@ -1,103 +0,0 @@
-import { useEffect, useMemo, useState } from 'react';
-
-function joinUrl(baseUrl = '', path = '') {
-  if (!baseUrl) {
-    return path || '';
-  }
-  if (!path) {
-    return baseUrl;
-  }
-  return `${baseUrl.replace(/\/+$/, '')}/${path.replace(/^\/+/, '')}`;
-}
-
-function createGateError({ message, status = 0, method = 'GET', url = '' }) {
-  const error = new Error(message);
-  error.status = status;
-  error.method = method;
-  error.url = url;
-  return error;
-}
-
-export function useRealApiReadinessGate({
-  enabled = false,
-  apiBaseUrl = '',
-  apiToken = '',
-} = {}) {
-  const [checking, setChecking] = useState(false);
-  const [ready, setReady] = useState(false);
-  const [error, setError] = useState(null);
-
-  const normalizedApiBaseUrl = String(apiBaseUrl || '').trim();
-
-  useEffect(() => {
-    let cancelled = false;
-
-    const run = async () => {
-      if (!enabled) {
-        setChecking(false);
-        setReady(true);
-        setError(null);
-        return;
-      }
-
-      if (!normalizedApiBaseUrl) {
-        setChecking(false);
-        setReady(false);
-        setError(createGateError({
-          message: 'real 模式要求配置 VITE_FLARE_CHAT_API_BASE_URL',
-        }));
-        return;
-      }
-
-      setChecking(true);
-      setReady(false);
-      setError(null);
-
-      const url = joinUrl(normalizedApiBaseUrl, '/chat/sessions?page=1&page_size=1');
-      const headers = new Headers();
-      if (apiToken) {
-        headers.set('Authorization', `Bearer ${String(apiToken || '').trim()}`);
-      }
-
-      try {
-        const response = await fetch(url, {
-          method: 'GET',
-          headers,
-        });
-        if (!response.ok) {
-          throw createGateError({
-            message: `API 预检失败: HTTP ${response.status} ${response.statusText || ''}`.trim(),
-            status: response.status,
-            method: 'GET',
-            url,
-          });
-        }
-        if (!cancelled) {
-          setReady(true);
-        }
-      } catch (nextError) {
-        if (!cancelled) {
-          setReady(false);
-          setError(nextError);
-        }
-      } finally {
-        if (!cancelled) {
-          setChecking(false);
-        }
-      }
-    };
-
-    run();
-
-    return () => {
-      cancelled = true;
-    };
-  }, [apiToken, enabled, normalizedApiBaseUrl]);
-
-  return useMemo(() => ({
-    checking,
-    ready,
-    error,
-    blocked: enabled && Boolean(error),
-  }), [checking, enabled, error, ready]);
-}

package/src/app/core-chat-entry/useUnavailableActionError.js

@@ -1,29 +0,0 @@
-import { useCallback, useState } from 'react';
-
-function createUnavailableError(message, fallbackMessage) {
-  if (message instanceof Error) {
-    return message;
-  }
-  return new Error(String(message || fallbackMessage));
-}
-
-export function useUnavailableActionError({
-  fallbackMessage = '当前能力尚未接入。',
-} = {}) {
-  const [error, setError] = useState(null);
-
-  const raiseUnavailableError = useCallback((message) => {
-    setError(createUnavailableError(message, fallbackMessage));
-  }, [fallbackMessage]);
-
-  const clearUnavailableError = useCallback(() => {
-    setError(null);
-  }, []);
-
-  return {
-    error,
-    raiseUnavailableError,
-    clearUnavailableError,
-  };
-}
-