Aislo/B06_Section/B06_Section_Section_Store.ts

/* =============================================================================
 * B06_Section_Section_Store.ts
 * 종횡단 상세(SectionDetailResponse)의 **프론트 공유 캐시** — B05·B06이 같은 객체를 본다.
 *
 * ── 왜 필요한가 (2026-08-03 사용자 확정) ─────────────────────────────
 * B05(노선·계획선)와 B06(종횡단 설계)은 같은 영구저장소 데이터의 두 창이다. 페이지마다
 * 따로 fetch해 제각각 들고 있으면, B06에서 지반유형·암 경계를 고친 뒤 B05로 넘어갔을 때
 * 횡단 기준 유토곡선이 옛 값으로 그려진다(사용자가 실제로 겪은 문제). 여기서 한 번 받아
 * **같은 객체 참조**를 두 페이지에 주면, B06이 측점 설계를 제자리 갱신하는 순간 B05가
 * 다음 그리기에서 그대로 본다 — 별도 동기화 코드가 필요 없다.
 *
 * ── 수명 규칙 ─────────────────────────────────────────────────────
 * 키는 `projectId:routeId`. SPA 모듈 싱글턴이라 페이지를 오가도 살아 있고, 새로고침이면
 * 사라져 영구저장소에서 다시 받는다(영구저장소가 항상 정본). 서버가 파일을 통째로 다시
 * 쓰는 조작(재생성·계획선 편집 저장·확정)은 그 응답/재조회로 `replace`·`invalidate`한다.
 * ========================================================================== */

import type { SectionDetailResponse } from "./B06_Section_Api_Fetch";
import { fetchSectionDetail } from "./B06_Section_Api_Fetch";

const cache = new Map<string, SectionDetailResponse>();
const pending = new Map<string, Promise<SectionDetailResponse>>();

function keyOf(projectId: string, routeId: number): string {
  return `${projectId}:${routeId}`;
}

/**
 * 상세를 가져온다 — 캐시가 있으면 **같은 객체**를 즉시 돌려주고, 없으면 한 번만 fetch한다
 * (동시 호출은 같은 Promise를 공유). `force`면 캐시를 버리고 다시 받는다.
 */
export async function loadSectionDetail(
  projectId: string,
  routeId: number,
  options?: { force?: boolean },
): Promise<SectionDetailResponse> {
  const key = keyOf(projectId, routeId);
  if (!options?.force) {
    const cached = cache.get(key);
    if (cached) return cached;
    const inFlight = pending.get(key);
    if (inFlight) return inFlight;
  }
  const request = fetchSectionDetail(projectId, routeId)
    .then((detail) => {
      cache.set(key, detail);
      return detail;
    })
    .finally(() => {
      pending.delete(key);
    });
  pending.set(key, request);
  return request;
}

/** 서버가 새 상세를 통째로 돌려준 조작(재생성 등) 뒤 캐시를 그 값으로 바꾼다. */
export function replaceSectionDetail(
  projectId: string,
  routeId: number,
  detail: SectionDetailResponse,
): void {
  cache.set(keyOf(projectId, routeId), detail);
}

/**
 * 캐시를 비운다. routeId를 생략하면 그 프로젝트 전부 —
 * 서버 쪽 정본이 바뀌었는데 새 상세를 손에 못 쥔 조작(계획선 편집 저장 등) 뒤에 쓴다.
 */
export function invalidateSectionDetail(projectId: string, routeId?: number): void {
  if (routeId !== undefined) {
    cache.delete(keyOf(projectId, routeId));
    return;
  }
  const prefix = `${projectId}:`;
  for (const key of [...cache.keys()]) {
    if (key.startsWith(prefix)) cache.delete(key);
  }
}