커넥터 가이드

import type { FileManagerConnector } from "@reopt-ai/opt-filemanager";

// 1단계: 읽기 전용 — capabilities 전부 false + list만 구현해도
// 탐색·정렬·필터·상세 패널이 전부 동작합니다.
export function createReadOnlyConnector(): FileManagerConnector {
  return {
    capabilities: {
      createFolder: false, createFile: false, upload: false,
      rename: false, remove: false, move: false,
      readText: false, usage: false, download: true,
    },
    async list({ folderId, signal }) {
      const res = await fetch(`/api/files?folder=${folderId ?? ""}`, { signal });
      return { entries: await res.json() };
    },
  };
}

// 2단계: mutation은 "capability + 메서드"를 항상 쌍으로 추가합니다.
// 하나만 추가하면 UI가 액션을 숨기거나(메서드만) 호출이 실패합니다(플래그만).
{
  capabilities: { ...readOnly, upload: true, remove: true },
  async upload({ parentId, file, onProgress, signal }) {
    // XHR/presigned 등 진행률을 알 수 있으면 onProgress(0~1)를 호출하세요.
    // 없으면 완료 시 onProgress?.(1) 한 번이면 큐가 정상 종료됩니다.
    return uploadToBackend(parentId, file, { onProgress, signal });
  },
  async remove({ id }) {
    await deleteFromBackend(id); // 거부 사유는 throw로 — 아래 에러 계약 참조
  },
}

import { FileManagerConnectorError } from "@reopt-ai/opt-filemanager";

// message는 오류 배너에 그대로 표시됩니다 — 사람이 읽을 문장으로.
throw new FileManagerConnectorError(
  "FILE_IN_USE",
  "브랜드프론트 히어로 섹션에서 사용 중인 파일입니다",
);

# 크레덴셜 없이 로컬에서 실서버 계약을 검증하려면:
reopt brandapp dev -p 4300   # 오프라인 인메모리 Files 서버

# createReoptFileClient({ baseUrl: "http://localhost:4300",
#   clientId: "dev", clientSecret: "dev", brandappId: "dev-brandapp" })
# 를 createBrandappFilesConnector({ client })에 주입하면 끝.