@taco_tsinghua/graphnode-sdk 0.1.17 → 0.1.21

package/src/types/graphAi.ts

@@ -0,0 +1,21 @@
+/**
+ * Graph AI Generation Response DTO
+ * @public
+ * @property message 상태 메시지
+ * @property taskId 백그라운드 작업의 ID
+ * @property status 작업의 상태 (예: 'queued')
+ */
+export interface GraphGenerationResponseDto {
+  /**
+   * Status message
+   */
+  message: string;
+  /**
+   * The ID of the background task
+   */
+  taskId: string;
+  /**
+   * The status of the task (e.g., 'queued')
+   */
+  status: string;
+}

package/src/types/me.ts

@@ -0,0 +1,49 @@
+/**
+ * 사용자 프로필 DTO
+ * @public
+ * @property id 사용자 ID (UUID/ULID)
+ * @property email 이메일 (선택)
+ * @property displayName 표시 이름
+ * @property avatarUrl 아바타 URL (없으면 null)
+ */
+export interface UserProfileDto {
+  id: string;
+  email?: string | null;
+  displayName?: string | null;
+  avatarUrl?: string | null;
+}
+
+/**
+ * 내 정보 응답 DTO
+ * @public
+ * @property userId 사용자 ID
+ * @property profile 사용자 프로필 정보 (선택)
+ */
+export interface MeResponseDto {
+  userId: string;
+  profile?: UserProfileDto;
+}
+
+/**
+ * API Key 모델 타입
+ * @public
+ */
+export type ApiKeyModel = 'openai' | 'deepseek';
+
+/**
+ * GET /v1/me/api-keys 응답 DTO
+ * @public
+ * @property apiKey 마스킹된 API 키 또는 null
+ */
+export interface ApiKeysResponseDto {
+  apiKey: string | null;
+}
+
+/**
+ * PATCH /v1/me/api-keys/:model 요청 DTO
+ * @public
+ * @property apiKey 설정할 API 키
+ */
+export interface UpdateApiKeyRequestDto {
+  apiKey: string;
+}

package/src/types/message.ts

@@ -0,0 +1,40 @@
+/**
+ * 메시지(Message) DTO
+ * @public
+ * @property id 메시지 ID (UUID/ULID)
+ * @property role 메시지 역할 ('user' | 'assistant' | 'system')
+ * @property content 메시지 내용
+ * @property createdAt 생성 일시 (ISO 8601)
+ * @property updatedAt 수정 일시 (ISO 8601)
+ * @property deletedAt 삭제 일시 (ISO 8601, null이면 활성)
+ */
+export interface MessageDto {
+  id: string; // FE generated UUID/ULID
+  role: 'user' | 'assistant' | 'system';
+  content: string;
+  createdAt?: string; // ISO 8601
+  updatedAt?: string; // ISO 8601
+  deletedAt?: string | null; // ISO 8601
+}
+
+/**
+ * 메시지 생성 요청 DTO
+ * @public
+ * @property id 메시지 ID (선택, 클라이언트 생성 시)
+ * @property role 메시지 역할
+ * @property content 메시지 내용
+ */
+export interface MessageCreateDto {
+  id?: string;
+  role: 'user' | 'assistant' | 'system';
+  content: string;
+}
+
+/**
+ * 메시지 수정 요청 DTO
+ * @public
+ * @property content 변경할 메시지 내용 (선택)
+ */
+export interface MessageUpdateDto {
+  content?: string;
+}

package/src/types/note.ts

@@ -0,0 +1,89 @@
+/**
+ * Note DTO
+ * @public
+ * @property id 노트 ID (UUID)
+ * @property title 노트 제목
+ * @property content 노트 내용 (Markdown)
+ * @property folderId 폴더 ID (null이면 최상위)
+ * @property createdAt 생성 일시 (ISO 8601)
+ * @property updatedAt 수정 일시 (ISO 8601)
+ * @property deletedAt 삭제 일시 (ISO 8601, null이면 활성)
+ */
+export interface NoteDto {
+  id: string;
+  title: string;
+  content: string;
+  folderId: string | null;
+  createdAt: string;
+  updatedAt: string;
+  deletedAt?: string | null;
+}
+
+/**
+ * Folder DTO
+ * @public
+ * @property id 폴더 ID (UUID)
+ * @property name 폴더 이름
+ * @property parentId 상위 폴더 ID (null이면 최상위)
+ * @property createdAt 생성 일시 (ISO 8601)
+ * @property updatedAt 수정 일시 (ISO 8601)
+ * @property deletedAt 삭제 일시 (ISO 8601, null이면 활성)
+ */
+export interface FolderDto {
+  id: string;
+  name: string;
+  parentId: string | null;
+  createdAt: string;
+  updatedAt: string;
+  deletedAt?: string | null;
+}
+
+/**
+ * Note Create DTO
+ * @public
+ * @property id 노트 ID (UUID) - 클라이언트 생성
+ * @property title 노트 제목 (선택)
+ * @property content 노트 내용
+ * @property folderId 폴더 ID (선택)
+ */
+export interface NoteCreateDto {
+  id: string;
+  title?: string;
+  content: string;
+  folderId?: string | null;
+}
+
+/**
+ * Note Update DTO
+ * @public
+ * @property title 노트 제목 (선택)
+ * @property content 노트 내용 (선택)
+ * @property folderId 폴더 ID (선택)
+ */
+export interface NoteUpdateDto {
+  title?: string;
+  content?: string;
+  folderId?: string | null;
+}
+
+/**
+ * Folder Create DTO
+ * @public
+ * @property name 폴더 이름
+ * @property parentId 상위 폴더 ID (선택)
+ */
+export interface FolderCreateDto {
+  name: string;
+  parentId?: string | null;
+}
+
+/**
+ * Folder Update DTO
+ * @public
+ * @property name 폴더 이름 (선택)
+ * @property parentId 상위 폴더 ID (선택)
+ */
+export interface FolderUpdateDto {
+  name?: string;
+  parentId?: string | null;
+}

package/src/types/problem.ts

@@ -0,0 +1,22 @@
+/**
+ * RFC 9457 Problem Details (에러 응답)
+ * @public
+ * @property type 문제 유형 URI
+ * @property title 문제 제목
+ * @property status HTTP 상태 코드
+ * @property detail 문제 상세 설명
+ * @property instance 문제 발생 리소스 URI
+ * @property correlationId 요청 추적 ID
+ * @property errors 세부 에러 목록 (선택)
+ * @property retryable 재시도 가능 여부 (선택)
+ */
+export interface ProblemDetails {
+  type: string;
+  title: string;
+  status: number;
+  detail: string;
+  instance: string;
+  correlationId?: string;
+  errors?: Array<Record<string, unknown>>;
+  retryable?: boolean;
+}

package/src/types/sync.ts

@@ -0,0 +1,35 @@
+import type { ConversationDto } from './conversation.js';
+import type { MessageDto } from './message.js';
+import type { NoteDto, FolderDto } from './note.js';
+
+/**
+ * 동기화 푸시 요청 DTO
+ * @public
+ * @property conversations 변경된 대화 목록 (선택)
+ * @property messages 변경된 메시지 목록 (선택, conversationId 포함)
+ * @property notes 변경된 노트 목록 (선택)
+ * @property folders 변경된 폴더 목록 (선택)
+ */
+export interface SyncPushRequest {
+  conversations?: ConversationDto[];
+  messages?: (MessageDto & { conversationId: string })[];
+  notes?: NoteDto[];
+  folders?: FolderDto[];
+}
+
+/**
+ * 동기화 풀 응답 DTO
+ * @public
+ * @property conversations 변경된 대화 목록
+ * @property messages 변경된 메시지 목록
+ * @property notes 변경된 노트 목록
+ * @property folders 변경된 폴더 목록
+ * @property serverTime 서버 현재 시각 (ISO 8601) - 다음 동기화 커서로 사용
+ */
+export interface SyncPullResponse {
+  conversations: ConversationDto[];
+  messages: MessageDto[];
+  notes: NoteDto[];
+  folders: FolderDto[];
+  serverTime: string; // ISO 8601
+}