nolo-cli 0.1.31 → 0.1.32

package/database/actions/read.ts

@@ -1,378 +0,0 @@
-// 文件路径: database/actions/read.ts
-
-import type { AppThunkApi } from "../../app/store";
-import { getRuntimeServerContext } from "../runtimeServerContext";
-import {
-  fetchFromClientDb,
-  fetchReadOutcomeFromServer,
-  isReadTimeoutError,
-  logger,
-} from "./common";
-import { buildReadMissError } from "./readOutcome";
-import { resolveAgentReadServers } from "./agentReadResolution";
-import {
-  partitionReadServers,
-  pickBestSettledRemoteRecord,
-  shouldReplaceLocalWithRemoteRecord,
-  shouldReplicateLocalRecord,
-} from "./readResolution";
-import { readRequestManager } from "./readRequestManager";
-import { shouldReplaceWithNextRecord } from "../tombstones";
-import { scheduleExistingRecordReplication } from "./replication";
-import {
-  buildBuiltinPlatformAgentRecord,
-} from "../../core/builtinAgents";
-import { isBuiltinPlatformAgentKey } from "./agentReadResolution";
-
-// --- 辅助函数 ---
-
-const updateClientDbIfNewer = async (
-  clientDb: any,
-  dbKey: string,
-  remoteData: any,
-  localData: any
-): Promise<void> => {
-  if (!clientDb) return;
-  try {
-    if (isRemoteDataNewer(remoteData, localData)) {
-      await clientDb.put(dbKey, remoteData);
-    }
-  } catch (err) {
-    throw err;
-  }
-};
-
-const isRemoteDataNewer = (remoteData: any, localData: any): boolean => {
-  if (!remoteData || typeof remoteData !== "object") return false;
-  if (!localData || typeof localData !== "object") return true;
-  return shouldReplaceWithNextRecord(remoteData, localData);
-};
-
-const syncLocalDataToServer = async (
-  replicationContext: {
-    currentServer: string | undefined;
-    syncServers: string[] | undefined;
-    state: unknown;
-  },
-  dbKey: string,
-  localData: any
-): Promise<void> => {
-  try {
-    scheduleExistingRecordReplication({
-      currentServer: replicationContext.currentServer,
-      syncServers: replicationContext.syncServers,
-      dbKey,
-      localData,
-      state: replicationContext.state,
-    });
-  } catch (err) {
-    // Error ignored
-  }
-};
-
-const saveRemoteDataToClientDb = async (
-  clientDb: any,
-  dbKey: string,
-  remoteData: any,
-  serverOrigin?: string | null
-): Promise<void> => {
-  if (!clientDb) return;
-  try {
-    await clientDb.put(
-      dbKey,
-      serverOrigin
-        ? {
-            ...remoteData,
-            serverOrigin,
-          }
-        : remoteData
-    );
-  } catch (err) {
-    // Error ignored
-  }
-};
-
-const processRemoteDataInBackground = async (
-  clientDb: any,
-  dbKey: string,
-  remotePromises: Promise<any>[],
-  remoteServers: string[],
-  localData: any,
-  replicationContext: {
-    currentServer: string | undefined;
-    syncServers: string[] | undefined;
-    state: unknown;
-  }
-): Promise<void> => {
-  if (!clientDb) return;
-  try {
-    const settledResults = await Promise.allSettled(remotePromises);
-    const remoteResult = pickBestSettledRemoteRecord({
-      settledResults,
-      isBetterCandidate: (current, latest) =>
-        shouldReplaceWithNextRecord(current, latest),
-    });
-    const validRemoteData = remoteResult ? remoteResult.data : null;
-    const serverOrigin =
-      remoteResult && remoteServers[remoteResult.index]
-        ? remoteServers[remoteResult.index]
-        : undefined;
-
-    if (
-      shouldReplaceLocalWithRemoteRecord({
-        localData,
-        remoteData: validRemoteData,
-        isRemoteNewer,
-      })
-    ) {
-      await updateClientDbIfNewer(
-        clientDb,
-        dbKey,
-        serverOrigin ? { ...validRemoteData, serverOrigin } : validRemoteData,
-        localData
-      );
-    }
-    if (
-      shouldReplicateLocalRecord({
-        localData,
-        remoteData: validRemoteData,
-        remoteTargetCount: remotePromises.length,
-      })
-    ) {
-      await syncLocalDataToServer(replicationContext, dbKey, localData);
-    }
-  } catch (err) {
-    // Background sync errors ignored
-  }
-};
-
-// --- 主函数 ---
-
-export const readAction = async (
-  payload: {
-    dbKey: string;
-    signal?: AbortSignal;
-    preferredServerOrigin?: string | null;
-  },
-  thunkApi: AppThunkApi
-): Promise<any> => {
-  const dbKey = payload.dbKey;
-  const signal = payload.signal;
-  const preferredServerOrigin = payload.preferredServerOrigin;
-
-  if (!dbKey || typeof dbKey !== "string") {
-    throw new Error("readAction requires a non-empty dbKey.");
-  }
-
-  // 2. 尽早检查中止信号，快速退出
-  if (signal?.aborted) {
-    throw new DOMException("Aborted", "AbortError");
-  }
-
-  const { db: clientDb } = thunkApi.extra;
-  if (!clientDb) {
-    throw new Error("Client database is not available.");
-  }
-
-  const executeRead = async (): Promise<any> => {
-    if (isBuiltinPlatformAgentKey(dbKey)) {
-      const builtinRecord = buildBuiltinPlatformAgentRecord(dbKey);
-      if (builtinRecord) {
-        await saveRemoteDataToClientDb(clientDb, dbKey, builtinRecord);
-        readRequestManager.clearMiss(dbKey);
-        return builtinRecord;
-      }
-    }
-
-    const state = thunkApi.getState();
-    const { currentToken, remoteServers: configuredServers } =
-      getRuntimeServerContext(state, preferredServerOrigin);
-    const { currentServer, syncServers } = getRuntimeServerContext(
-      state,
-      preferredServerOrigin
-    );
-    const allServers = resolveAgentReadServers({ dbKey, configuredServers });
-    const isLoggedIn = !!currentToken;
-    const now = Date.now();
-    const localData = await fetchFromClientDb(clientDb, dbKey);
-    const {
-      preferredServer,
-      fallbackServers,
-      orderedServersForLocalHit,
-    } = partitionReadServers({
-      allServers,
-      preferredServerOrigin,
-    });
-    readRequestManager.cleanupMisses(now);
-    readRequestManager.cleanupLocalHitRevalidations(now);
-
-    if (localData) {
-      readRequestManager.clearMiss(dbKey);
-    } else {
-      const retryInMs = readRequestManager.getRetryInMs(dbKey, now);
-      if (typeof retryInMs === "number" && retryInMs > 0) {
-        logger.debug(
-          { dbKey, retryInMs },
-          "[readAction] Suppressing repeated miss read"
-        );
-        throw buildReadMissError({
-          dbKey,
-          reason: "temporarily_suppressed",
-        });
-      }
-    }
-
-    // 离线 / 无可用远程服务器：只看本地
-    if (allServers.length === 0) {
-      if (localData) {
-        return { ...localData, dbKey };
-      }
-      readRequestManager.markMiss(dbKey, now);
-      throw buildReadMissError({
-        dbKey,
-        reason: "offline_without_local_data",
-      });
-    }
-
-    if (localData) {
-      // Local-first: return durable local data immediately and only revalidate
-      // against remote servers in the background. This avoids turning a
-      // preferred-server timeout into a visible read failure for data we
-      // already have locally (for example createDialog -> initDialog).
-      if (!signal?.aborted) {
-        const retryInMs = readRequestManager.getLocalHitRevalidateInMs(
-          dbKey,
-          now
-        );
-        if (retryInMs === null) {
-          readRequestManager.markLocalHitRevalidated(dbKey, now);
-          const remotePromises = orderedServersForLocalHit.map(async (server) => {
-            const outcome = await fetchReadOutcomeFromServer(
-              server,
-              dbKey,
-              isLoggedIn ? currentToken : undefined,
-              signal
-            );
-            return outcome.tag === "success" ? outcome.data : null;
-          }
-          );
-          void processRemoteDataInBackground(
-            clientDb,
-            dbKey,
-            remotePromises,
-            orderedServersForLocalHit,
-            localData,
-            { currentServer, syncServers, state }
-          );
-        } else {
-          logger.debug(
-            { dbKey, retryInMs },
-            "[readAction] Skipping frequent local-hit revalidation"
-          );
-        }
-      }
-      return { ...localData, dbKey };
-    }
-
-    if (preferredServer) {
-      try {
-        const preferredOutcome = await fetchReadOutcomeFromServer(
-          preferredServer,
-          dbKey,
-          isLoggedIn ? currentToken : undefined,
-          signal
-        );
-
-        if (preferredOutcome.tag === "success") {
-          const preferredRemoteData = preferredOutcome.data;
-          await saveRemoteDataToClientDb(
-            clientDb,
-            dbKey,
-            preferredRemoteData,
-            preferredServer
-          );
-          readRequestManager.clearMiss(dbKey);
-          return { ...preferredRemoteData, dbKey, serverOrigin: preferredServer };
-        }
-      } catch (error) {
-        if (signal?.aborted || (error as { name?: string } | null)?.name === "AbortError") {
-          throw error;
-        }
-        if (isReadTimeoutError(error)) {
-          logger.warn(
-            { dbKey, preferredServer, error: String((error as Error).message) },
-            "[readAction] Preferred server timed out; falling back to remaining servers"
-          );
-        } else {
-          logger.warn(
-            { dbKey, preferredServer, error: String(error) },
-            "[readAction] Preferred server read failed; falling back to remaining servers"
-          );
-        }
-      }
-    }
-
-    // 3. 将 signal 传递给所有网络请求
-    const remotePromises = fallbackServers.map(async (server) => {
-      const outcome = await fetchReadOutcomeFromServer(
-        server,
-        dbKey,
-        isLoggedIn ? currentToken : undefined,
-        signal
-      );
-      return outcome.tag === "success" ? outcome.data : null;
-    }
-    );
-
-    // 如果本地没有数据，则等待网络请求结果
-    const settledResults = await Promise.allSettled(remotePromises);
-
-    // 4. 在处理网络结果前，再次检查中止信号
-    if (signal?.aborted) {
-      throw new DOMException("Aborted", "AbortError");
-    }
-
-    const remoteResult = pickBestSettledRemoteRecord({
-      settledResults,
-      isBetterCandidate: (current, latest) =>
-        shouldReplaceWithNextRecord(current, latest),
-    });
-    if (remoteResult) {
-      const { data: validRemoteData } = remoteResult;
-      const serverOrigin = fallbackServers[remoteResult.index];
-      if (!signal?.aborted) {
-        await saveRemoteDataToClientDb(
-          clientDb,
-          dbKey,
-          validRemoteData,
-          serverOrigin
-        );
-      }
-      readRequestManager.clearMiss(dbKey);
-      return serverOrigin
-        ? { ...validRemoteData, dbKey, serverOrigin }
-        : { ...validRemoteData, dbKey };
-    }
-
-    readRequestManager.markMiss(dbKey, Date.now());
-    throw buildReadMissError({
-      dbKey,
-      reason: "all_sources_failed",
-    });
-  };
-
-  const canDedup = !signal;
-  if (canDedup) {
-    const existing = readRequestManager.getInFlight(dbKey);
-    if (existing) return existing;
-
-    let inFlightPromise: Promise<any>;
-    inFlightPromise = executeRead().finally(() => {
-      readRequestManager.clearInFlight(dbKey, inFlightPromise);
-    });
-    readRequestManager.setInFlight(dbKey, inFlightPromise);
-    return inFlightPromise;
-  }
-
-  return executeRead();
-};

package/database/actions/readAndWait.ts

@@ -1,197 +0,0 @@
-// 文件路径: database/actions/readAndWait.ts
-
-import type { AppThunkApi } from "../../app/store";
-import {
-  buildBuiltinPlatformAgentRecord,
-} from "../../core/builtinAgents";
-import { fetchFromClientDb, fetchFromServer } from "./common";
-import { readRequestManager } from "./readRequestManager";
-import { scheduleExistingRecordReplication } from "./replication";
-import { getRuntimeServerContext } from "../runtimeServerContext";
-import { resolveAgentReadServers } from "./agentReadResolution";
-import { isBuiltinPlatformAgentKey } from "./agentReadResolution";
-import {
-  compareRemoteRecordsByComparableTime,
-  pickBestSettledRemoteRecord,
-  shouldReplaceLocalWithRemoteRecord,
-  shouldReplicateLocalRecord,
-} from "./readResolution";
-
-/**
- * 比较远程数据和本地数据的时间戳，判断远程数据是否更新。
- * @param remoteData - 从服务器获取的数据。
- * @param localData - 从本地数据库获取的数据。
- * @returns 如果远程数据更新，则返回 true。
- */
-const isRemoteDataNewer = (remoteData: any, localData: any): boolean => {
-  return compareRemoteRecordsByComparableTime(remoteData, localData) > 0;
-};
-
-/**
- * 触发一个“即发即忘”的异步任务，将本地数据上传（写入）到服务器。
- * 通常在发现本地存在数据而所有远程服务器上都不存在该数据时调用。
- */
-const syncLocalDataToServer = async (
-  replicationContext: {
-    currentServer: string | undefined;
-    syncServers: string[] | undefined;
-    state: unknown;
-  },
-  dbKey: string,
-  localData: any
-): Promise<void> => {
-  try {
-    scheduleExistingRecordReplication({
-      currentServer: replicationContext.currentServer,
-      syncServers: replicationContext.syncServers,
-      dbKey,
-      localData,
-      state: replicationContext.state,
-    });
-  } catch {
-    // 后台同步失败不阻塞主流程，静默处理即可
-  }
-};
-
-/**
- * 核心处理函数：协调本地和远程数据，决定最终返回哪个版本的数据，并处理同步逻辑。
- */
-const processRemoteData = async (
-  db: any,
-  dbKey: string,
-  remotePromises: Promise<any>[],
-  localData: any,
-  replicationContext: {
-    currentServer: string | undefined;
-    syncServers: string[] | undefined;
-    state: unknown;
-  }
-): Promise<any> => {
-  try {
-    // 并行执行所有远程请求，并等待它们全部完成（无论成功或失败）。
-    const settledResults = await Promise.allSettled(remotePromises);
-    // 从所有结果中，找出最“权威”的远程版本（时间戳最新）。
-    const remoteResult = pickBestSettledRemoteRecord({
-      settledResults,
-      isBetterCandidate: (current, latest) =>
-        compareRemoteRecordsByComparableTime(current, latest) > 0,
-    });
-    const validRemoteData = remoteResult ? remoteResult.data : null;
-
-    // --- 数据决策核心逻辑 ---
-
-    // 场景 1: 至少一个远程服务器返回了有效数据。
-    if (
-      shouldReplaceLocalWithRemoteRecord({
-        localData,
-        remoteData: validRemoteData,
-        isRemoteNewer: isRemoteDataNewer,
-      })
-    ) {
-      // 如果本地没有数据，或者远程更新更新，则用远程覆盖本地缓存。
-      await db.put(dbKey, validRemoteData);
-      // 最终决策：返回权威的远程数据。
-      return validRemoteData;
-    }
-
-    // 场景 2: 所有远程服务器都没有返回有效数据，但我们本地数据库中存在数据。
-    if (localData) {
-      // 仅当“确实有远程目标”时，才尝试上传本地数据到服务器。
-      if (
-        shouldReplicateLocalRecord({
-          localData,
-          remoteData: validRemoteData,
-          remoteTargetCount: remotePromises.length,
-        })
-      ) {
-        void syncLocalDataToServer(replicationContext, dbKey, localData);
-      }
-      // 最终决策：返回本地数据。
-      return localData;
-    }
-
-    // 场景 3: 远程和本地都找不到任何数据。
-    throw new Error("Failed to fetch data from all sources");
-  } catch (err) {
-    // 如果在上述过程中发生错误，且有本地数据，则优先返回本地数据，避免崩溃。
-    if (localData) {
-      return localData;
-    }
-    throw err;
-  }
-};
-
-/**
- * 主函数：读取数据，并等待远程和本地操作都完成后才返回最合适的数据。
- * - 本地优先：有本地数据时，远程只用于更新缓存或回填云端。
- * - 远程优先：若拿到了有效远程数据，以其为准。
- */
-export const readAndWaitAction = async (
-  dbKey: string,
-  thunkApi: AppThunkApi
-): Promise<any> => {
-  const { db } = thunkApi.extra;
-
-  if (!db) {
-    throw new Error(
-      "Database instance is not available in thunk extra argument."
-    );
-  }
-
-  const state = thunkApi.getState();
-  const { currentToken, remoteServers: configuredServers, currentServer, syncServers } =
-    getRuntimeServerContext(state);
-  const allServers = resolveAgentReadServers({ dbKey, configuredServers });
-  const isLoggedIn = !!currentToken;
-
-  const executeReadAndWait = async (): Promise<any> => {
-    if (isBuiltinPlatformAgentKey(dbKey)) {
-      const builtinRecord = buildBuiltinPlatformAgentRecord(dbKey);
-      if (builtinRecord) {
-        await db.put(dbKey, builtinRecord);
-        return { ...builtinRecord, dbKey };
-      }
-    }
-
-    // 1. 准备所有需要访问的远程服务器（带去重 + 离线检测）
-    // 2. 首先，尝试从本地数据库获取数据（可能为 null）
-    const localData = await fetchFromClientDb(db, dbKey);
-
-    // 如果离线或没有任何可用远程服务器：
-    if (allServers.length === 0) {
-      if (localData) {
-        return { ...localData, dbKey };
-      }
-      throw new Error(
-        `Failed to fetch data for key "${dbKey}" because network is offline and no local data is available.`
-      );
-    }
-
-    // 3. 创建所有到远程服务器的并行请求
-    const remotePromises = allServers.map((server) =>
-      fetchFromServer(server, dbKey, isLoggedIn ? currentToken : undefined)
-    );
-
-    // 4. 将所有信息交给核心处理函数去做最终决策
-    const chosenData = await processRemoteData(
-      db,
-      dbKey,
-      remotePromises,
-      localData,
-      { currentServer, syncServers, state }
-    );
-
-    // ⭐ 统一：不论返回的是本地还是远程，最终都附加 dbKey 字段
-    return { ...chosenData, dbKey };
-  };
-
-  const existing = readRequestManager.getInFlight(dbKey);
-  if (existing) return existing;
-
-  let inFlightPromise: Promise<any>;
-  inFlightPromise = executeReadAndWait().finally(() => {
-    readRequestManager.clearInFlight(dbKey, inFlightPromise);
-  });
-  readRequestManager.setInFlight(dbKey, inFlightPromise);
-  return inFlightPromise;
-};

package/database/actions/readOutcome.ts

@@ -1,45 +0,0 @@
-export type RemoteReadStatusTag =
-  | "success"
-  | "not_found"
-  | "unauthorized"
-  | "forbidden"
-  | "transient_error"
-  | "http_error";
-
-export const classifyRemoteReadStatus = (
-  status: number
-): RemoteReadStatusTag => {
-  if (status === 200) return "success";
-  if (status === 404) return "not_found";
-  if (status === 401) return "unauthorized";
-  if (status === 403) return "forbidden";
-  if ([408, 425, 429, 500, 502, 503, 504].includes(status)) {
-    return "transient_error";
-  }
-  return "http_error";
-};
-
-export type ReadMissReason =
-  | "temporarily_suppressed"
-  | "offline_without_local_data"
-  | "all_sources_failed";
-
-export const buildReadMissError = ({
-  dbKey,
-  reason,
-}: {
-  dbKey: string;
-  reason: ReadMissReason;
-}) => {
-  switch (reason) {
-    case "temporarily_suppressed":
-      return new Error(`Read temporarily suppressed for missing key "${dbKey}".`);
-    case "offline_without_local_data":
-      return new Error(
-        `Failed to fetch data for key "${dbKey}" because network is offline and no local data is available.`
-      );
-    case "all_sources_failed":
-    default:
-      return new Error(`Failed to fetch data for key "${dbKey}" from all sources.`);
-  }
-};