Genarrative/apps/ai-game-creator-shell/src/features/app-shell/sessionPreview.ts

import type { GameCreationAppPreviewState } from '../../../../../packages/shared/src/contracts/gameCreationApp';

/**
 * 进入项目时的预览活体核验。
 *
 * 为什么不能直接信项目 manifest 里的 `preview`：那是"上次留下的一条记录"，不是"现在
 * 有没有在跑"。本地预览服务器是**进程内线程**（`src-tauri/src/preview.rs` 的
 * `thread::spawn` + loopback listener），非 Linux 平台端口还是**随机临时端口**
 * （`bind_loopback_listener_with_linux_fallback` 里的 `TcpListener::bind(..., 0)`），
 * 客户端一退 URL 就永久失效；而落盘记录会一直写着 `running`。照它渲染，用户就会被直接
 * 丢进一个打不开的运行界面——这正是"有时候进项目看到的是运行界面"的成因。
 *
 * 所以进项目时问一次内存 registry（`get_local_game_preview_status`）：
 * - 确实在跑 → 作为**本次会话的预览**交给工作台（工作台据此自动进运行视图）；
 * - 没在跑但记录写着 running → 记录陈旧：把落盘记录对齐成 stopped（复用现役
 *   `stop_local_game_preview`，它现在会把陈旧记录一并收尾），本次会话不带预览。
 */
export type SessionPreviewResolution = {
  /** 本次会话可用的预览：只有内存 registry 里真的在跑才有值。 */
  sessionPreview: GameCreationAppPreviewState | null;
  /**
   * 会话 manifest 里该投影成的预览状态；`null` 表示落盘记录与真相一致，不用改。
   *
   * 判定陈旧的同一刻就按真相投影（而不是等落盘写成功）：否则一份写不进去的陈旧记录
   * （例如项目策略把 `preview.stop` 设成需确认）会让运行入口继续拿着一个打不开的 URL
   * 渲染运行画面。落盘那份由这次写入、退出收尾或下次进入时的核对负责收敛。
   */
  manifestPreviewPatch: GameCreationAppPreviewState | null;
};

/** 预览命令的最小 invoke 形状（与 App 里 `window.__TAURI__.core.invoke` 一致）。 */
export type PreviewCommandInvoke = <T>(
  command: string,
  args?: Record<string, unknown>,
) => Promise<T>;

type LocalPreviewStatusLike = {
  status?: string | null;
  url?: string | null;
  port?: number | null;
};

function livePreviewFromStatus(
  status: LocalPreviewStatusLike | null,
): GameCreationAppPreviewState | null {
  const url = typeof status?.url === 'string' ? status.url.trim() : '';
  if (status?.status !== 'running' || !url) {
    return null;
  }
  return {
    status: 'running',
    url,
    port: typeof status.port === 'number' ? status.port : null,
  };
}

export async function resolveSessionPreviewOnProjectOpen({
  invoke,
  projectPath,
  recordedPreview,
}: {
  invoke: PreviewCommandInvoke | null | undefined;
  projectPath: string;
  recordedPreview: GameCreationAppPreviewState | null;
}): Promise<SessionPreviewResolution> {
  const trimmedProjectPath = projectPath.trim();
  if (!invoke || !trimmedProjectPath) {
    return { sessionPreview: null, manifestPreviewPatch: null };
  }

  let status: LocalPreviewStatusLike | null = null;
  try {
    status = await invoke<LocalPreviewStatusLike>(
      'get_local_game_preview_status',
      { projectPath: trimmedProjectPath },
    );
  } catch {
    // 读不到 registry 不等于"确认没有在跑"：`stop_local_game_preview` 会停掉
    // 真在跑的活体预览，读失败（权限拒绝 / 瞬时 IPC 错误）时不能顺手当清理动作。
    // 只按"不带预览进入"处理，让用户自己点「运行」。
    return { sessionPreview: null, manifestPreviewPatch: null };
  }
  const sessionPreview = livePreviewFromStatus(status);
  if (sessionPreview) {
    return { sessionPreview, manifestPreviewPatch: null };
  }

  if (recordedPreview?.status !== 'running') {
    return { sessionPreview: null, manifestPreviewPatch: null };
  }

  try {
    await invoke('stop_local_game_preview', {
      projectPath: trimmedProjectPath,
    });
  } catch {
    // 对齐落盘记录失败不改判：本次会话照样不把陈旧记录当活体用。
  }
  return {
    sessionPreview: null,
    manifestPreviewPatch: { status: 'stopped' },
  };
}