@taco_tsinghua/graphnode-sdk 0.1.7 → 0.1.9

package/dist/endpoints/graph.d.ts

@@ -8,94 +8,303 @@ export declare class GraphApi {
     private readonly rb;
     constructor(rb: RequestBuilder);
     /**
-     * 새 노드를 생성하거나 기존 노드를 업데이트합니다.
+     * 새 노트를 생성하거나 기존 노드를 업데이트합니다.
      * @param node - 생성 또는 업데이트할 노드 데이터
-     * @returns 생성 또는 업데이트된 노드
+     *    - `id` (number): 노드 ID (정수)
+     *    - `userId` (string): 사용자 ID
+     *    - `origId` (string): 원본 데이터 ID (예: conversationId)
+     *    - `clusterId` (string): 클러스터 ID
+     *    - `clusterName` (string): 클러스터 이름
+     *    - `timestamp` (string | null): 타임스탬프
+     *    - `numMessages` (number): 메시지 수
+     * @returns 생성 또는 업데이트된 노드 정보
+     * @example
+     * const response = await client.graph.createNode({
+     *   id: 101,
+     *   userId: 'user-123',
+     *   origId: 'conv-uuid-1',
+     *   clusterId: 'cluster-a',
+     *   clusterName: 'Project Alpha',
+     *   timestamp: new Date().toISOString(),
+     *   numMessages: 5
+     * });
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 101,
+     *   userId: 'user-123',
+     *   origId: 'conv-uuid-1',
+     *   clusterId: 'cluster-a',
+     *   clusterName: 'Project Alpha',
+     *   timestamp: '...',
+     *   numMessages: 5
+     * }
      */
     createNode(node: GraphNodeDto): Promise<HttpResponse<GraphNodeDto>>;
     /**
      * 사용자의 모든 노드를 가져옵니다.
-     * @returns 노드 목록
+     * @returns 노드 목록 (GraphNodeDto 배열)
+     * @example
+     * const response = await client.graph.listNodes();
+     *
+     * console.log(response.data);
+     * // Output:
+     * [
+     *   {
+     *     id: 101,
+     *     userId: 'user-123',
+     *     origId: 'conv-uuid-1',
+     *     clusterId: 'cluster-a',
+     *     clusterName: 'Project Alpha',
+     *     timestamp: '...',
+     *     numMessages: 5
+     *   },
+     *   {
+     *     id: 102,
+     *     userId: 'user-123',
+     *     origId: 'conv-uuid-2',
+     *     clusterId: 'cluster-b',
+     *     clusterName: 'Project Beta',
+     *     timestamp: '...',
+     *     numMessages: 3
+     *   }
+     * ]
      */
     listNodes(): Promise<HttpResponse<GraphNodeDto[]>>;
     /**
      * 특정 ID의 노드를 가져옵니다.
-     * @param nodeId - 가져올 노드의 ID
-     * @returns 요청한 노드
+     * @param nodeId - 가져올 노드의 ID (정수)
+     * @returns 요청한 노드 상세 정보
+     * @example
+     * const response = await client.graph.getNode(101);
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 101,
+     *   userId: 'user-123',
+     *   origId: 'conv-uuid-1',
+     *   clusterId: 'cluster-a',
+     *   clusterName: 'Project Alpha',
+     *   timestamp: '...',
+     *   numMessages: 5
+     * }
      */
     getNode(nodeId: number): Promise<HttpResponse<GraphNodeDto>>;
     /**
      * 특정 노드를 부분적으로 업데이트합니다.
      * @param nodeId - 업데이트할 노드의 ID
      * @param payload - 업데이트할 데이터
+     *    - `clusterId` (string, optional): 변경할 클러스터 ID
+     *    - `clusterName` (string, optional): 변경할 클러스터 이름
+     * @example
+     * await client.graph.updateNode(101, {
+     *   clusterName: 'Project Beta'
+     * });
+     * // Output: (No content)
      */
     updateNode(nodeId: number, payload: UpdateNodePayload): Promise<HttpResponse<void>>;
     /**
      * 특정 노드를 삭제합니다.
      * @param nodeId - 삭제할 노드의 ID
+     * @example
+     * await client.graph.deleteNode(101);
+     * // Output: (No content)
      */
     deleteNode(nodeId: number): Promise<HttpResponse<void>>;
     /**
      * 특정 노드와 연결된 모든 엣지를 함께 삭제합니다.
      * @param nodeId - 삭제할 노드의 ID
+     * @example
+     * await client.graph.deleteNodeCascade(101);
+     * // Output: (No content)
      */
     deleteNodeCascade(nodeId: number): Promise<HttpResponse<void>>;
     /**
      * 새 엣지를 생성합니다.
      * @param edge - 생성할 엣지 데이터
-     * @returns 생성된 엣지의 ID
+     *    - `source` (number): 출발 노드 ID
+     *    - `target` (number): 도착 노드 ID
+     *    - `weight` (number): 가중치
+     *    - `type` ('hard' | 'insight'): 엣지 타입
+     *    - `intraCluster` (boolean): 클러스터 내부 연결 여부
+     * @returns 생성된 엣지 ID
+     *    - `id` (string): 엣지 ID
+     * @example
+     * const response = await client.graph.createEdge({
+     *   source: 101,
+     *   target: 102,
+     *   weight: 0.85,
+     *   type: 'insight',
+     *   intraCluster: true
+     * });
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 'edge-uuid-...'
+     * }
      */
     createEdge(edge: GraphEdgeDto): Promise<HttpResponse<CreateEdgeResponse>>;
     /**
      * 사용자의 모든 엣지를 가져옵니다.
-     * @returns 엣지 목록
+     * @returns 엣지 목록 (GraphEdgeDto 배열)
+     * @example
+     * const response = await client.graph.listEdges();
+     *
+     * console.log(response.data);
+     * // Output:
+     * [
+     *   {
+     *     id: 'edge-1',
+     *     source: 101,
+     *     target: 102,
+     *     weight: 0.85,
+     *     type: 'insight',
+     *     intraCluster: true
+     *   },
+     *   {
+     *     id: 'edge-2',
+     *     source: 102,
+     *     target: 103,
+     *     weight: 0.5,
+     *     type: 'hard',
+     *     intraCluster: false
+     *   }
+     * ]
      */
     listEdges(): Promise<HttpResponse<GraphEdgeDto[]>>;
     /**
      * 특정 엣지를 삭제합니다.
      * @param edgeId - 삭제할 엣지의 ID
+     * @example
+     * await client.graph.deleteEdge('edge-uuid-...');
+     * // Output: (No content)
      */
     deleteEdge(edgeId: string): Promise<HttpResponse<void>>;
     /**
      * 새 클러스터를 생성하거나 기존 클러스터를 업데이트합니다.
      * @param cluster - 생성 또는 업데이트할 클러스터 데이터
      * @returns 생성 또는 업데이트된 클러스터
+     * @example
+     * const response = await client.graph.createCluster({
+     *   id: 'cluster-a',
+     *   name: 'Project Alpha',
+     *   summary: 'Main project discussion'
+     * });
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 'cluster-a',
+     *   name: 'Project Alpha',
+     *   summary: 'Main project discussion'
+     * }
      */
     createCluster(cluster: GraphClusterDto): Promise<HttpResponse<GraphClusterDto>>;
     /**
      * 사용자의 모든 클러스터를 가져옵니다.
      * @returns 클러스터 목록
+     * @example
+     * const response = await client.graph.listClusters();
+     *
+     * console.log(response.data);
+     * // Output:
+     * [
+     *   {
+     *     id: 'cluster-a',
+     *     name: 'Project Alpha',
+     *     summary: 'Main project discussion'
+     *   },
+     *   {
+     *     id: 'cluster-b',
+     *     name: 'Project Beta',
+     *     summary: 'Secondary project'
+     *   }
+     * ]
      */
     listClusters(): Promise<HttpResponse<GraphClusterDto[]>>;
     /**
      * 특정 ID의 클러스터를 가져옵니다.
      * @param clusterId - 가져올 클러스터의 ID
      * @returns 요청한 클러스터
+     * @example
+     * const response = await client.graph.getCluster('cluster-a');
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 'cluster-a',
+     *   name: 'Project Alpha',
+     *   summary: 'Main project discussion'
+     * }
      */
     getCluster(clusterId: string): Promise<HttpResponse<GraphClusterDto>>;
     /**
      * 특정 클러스터를 삭제합니다.
      * @param clusterId - 삭제할 클러스터의 ID
+     * @example
+     * await client.graph.deleteCluster('cluster-a');
+     * // Output: (No content)
      */
     deleteCluster(clusterId: string): Promise<HttpResponse<void>>;
     /**
      * 특정 클러스터와 그 안의 모든 노드 및 엣지를 삭제합니다.
      * @param clusterId - 삭제할 클러스터의 ID
+     * @example
+     * await client.graph.deleteClusterCascade('cluster-a');
+     * // Output: (No content)
      */
     deleteClusterCascade(clusterId: string): Promise<HttpResponse<void>>;
     /**
      * 그래프 통계를 가져옵니다.
      * @returns 그래프 통계
+     * @example
+     * const response = await client.graph.getStats();
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   nodeCount: 100,
+     *   edgeCount: 150,
+     *   clusterCount: 5,
+     *   density: 0.03
+     * }
      */
     getStats(): Promise<HttpResponse<GraphStatsDto>>;
     /**
      * 전체 그래프 스냅샷을 가져옵니다.
      * @returns 그래프 스냅샷
+     * @example
+     * const response = await client.graph.getSnapshot();
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   nodes: [
+     *     { id: 101, ... },
+     *     { id: 102, ... }
+     *   ],
+     *   edges: [
+     *     { id: 'edge-1', ... }
+     *   ],
+     *   clusters: [
+     *     { id: 'cluster-a', ... }
+     *   ]
+     * }
      */
     getSnapshot(): Promise<HttpResponse<GraphSnapshotDto>>;
     /**
      * 전체 그래프 스냅샷을 서버에 저장합니다.
      * @param snapshot - 저장할 스냅샷 데이터
+     * @example
+     * await client.graph.saveSnapshot({
+     *   nodes: [...],
+     *   edges: [...],
+     *   clusters: [...]
+     * });
+     * // Output: (No content)
      */
     saveSnapshot(snapshot: GraphSnapshotDto): Promise<HttpResponse<void>>;
 }

package/dist/endpoints/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/endpoints/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;gBAExB,EAAE,EAAE,cAAc;IAI9B;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAInE;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;IAIlD;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAI5D;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAInF;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAIvD;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAI9D;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAIzE;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;IAIlD;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAIvD;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAI/E;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC;IAIxD;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAIrE;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAI7D;;;OAGG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAIpE;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAIhD;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAItD;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;CAGtE"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/endpoints/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;gBAExB,EAAE,EAAE,cAAc;IAI9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAInE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;IAIlD;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAI5D;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAInF;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAIvD;;;;;;OAMG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAI9D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAIzE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;IAIlD;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAIvD;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAI/E;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC;IAIxD;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAIrE;;;;;;OAMG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAI7D;;;;;;OAMG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAIpE;;;;;;;;;;;;;;OAcG;IACH,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAIhD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAItD;;;;;;;;;;OAUG;IACH,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;CAGtE"}

package/dist/endpoints/graph.js

@@ -8,24 +8,92 @@ export class GraphApi {
         this.rb = rb.path('/v1/graph');
     }
     /**
-     * 새 노드를 생성하거나 기존 노드를 업데이트합니다.
+     * 새 노트를 생성하거나 기존 노드를 업데이트합니다.
      * @param node - 생성 또는 업데이트할 노드 데이터
-     * @returns 생성 또는 업데이트된 노드
+     *    - `id` (number): 노드 ID (정수)
+     *    - `userId` (string): 사용자 ID
+     *    - `origId` (string): 원본 데이터 ID (예: conversationId)
+     *    - `clusterId` (string): 클러스터 ID
+     *    - `clusterName` (string): 클러스터 이름
+     *    - `timestamp` (string | null): 타임스탬프
+     *    - `numMessages` (number): 메시지 수
+     * @returns 생성 또는 업데이트된 노드 정보
+     * @example
+     * const response = await client.graph.createNode({
+     *   id: 101,
+     *   userId: 'user-123',
+     *   origId: 'conv-uuid-1',
+     *   clusterId: 'cluster-a',
+     *   clusterName: 'Project Alpha',
+     *   timestamp: new Date().toISOString(),
+     *   numMessages: 5
+     * });
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 101,
+     *   userId: 'user-123',
+     *   origId: 'conv-uuid-1',
+     *   clusterId: 'cluster-a',
+     *   clusterName: 'Project Alpha',
+     *   timestamp: '...',
+     *   numMessages: 5
+     * }
      */
     createNode(node) {
         return this.rb.path('/nodes').post(node);
     }
     /**
      * 사용자의 모든 노드를 가져옵니다.
-     * @returns 노드 목록
+     * @returns 노드 목록 (GraphNodeDto 배열)
+     * @example
+     * const response = await client.graph.listNodes();
+     *
+     * console.log(response.data);
+     * // Output:
+     * [
+     *   {
+     *     id: 101,
+     *     userId: 'user-123',
+     *     origId: 'conv-uuid-1',
+     *     clusterId: 'cluster-a',
+     *     clusterName: 'Project Alpha',
+     *     timestamp: '...',
+     *     numMessages: 5
+     *   },
+     *   {
+     *     id: 102,
+     *     userId: 'user-123',
+     *     origId: 'conv-uuid-2',
+     *     clusterId: 'cluster-b',
+     *     clusterName: 'Project Beta',
+     *     timestamp: '...',
+     *     numMessages: 3
+     *   }
+     * ]
      */
     listNodes() {
         return this.rb.path('/nodes').get();
     }
     /**
      * 특정 ID의 노드를 가져옵니다.
-     * @param nodeId - 가져올 노드의 ID
-     * @returns 요청한 노드
+     * @param nodeId - 가져올 노드의 ID (정수)
+     * @returns 요청한 노드 상세 정보
+     * @example
+     * const response = await client.graph.getNode(101);
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 101,
+     *   userId: 'user-123',
+     *   origId: 'conv-uuid-1',
+     *   clusterId: 'cluster-a',
+     *   clusterName: 'Project Alpha',
+     *   timestamp: '...',
+     *   numMessages: 5
+     * }
      */
     getNode(nodeId) {
         return this.rb.path(`/nodes/${nodeId}`).get();
@@ -34,6 +102,13 @@ export class GraphApi {
      * 특정 노드를 부분적으로 업데이트합니다.
      * @param nodeId - 업데이트할 노드의 ID
      * @param payload - 업데이트할 데이터
+     *    - `clusterId` (string, optional): 변경할 클러스터 ID
+     *    - `clusterName` (string, optional): 변경할 클러스터 이름
+     * @example
+     * await client.graph.updateNode(101, {
+     *   clusterName: 'Project Beta'
+     * });
+     * // Output: (No content)
      */
     updateNode(nodeId, payload) {
         return this.rb.path(`/nodes/${nodeId}`).patch(payload);
@@ -41,6 +116,9 @@ export class GraphApi {
     /**
      * 특정 노드를 삭제합니다.
      * @param nodeId - 삭제할 노드의 ID
+     * @example
+     * await client.graph.deleteNode(101);
+     * // Output: (No content)
      */
     deleteNode(nodeId) {
         return this.rb.path(`/nodes/${nodeId}`).delete();
@@ -48,6 +126,9 @@ export class GraphApi {
     /**
      * 특정 노드와 연결된 모든 엣지를 함께 삭제합니다.
      * @param nodeId - 삭제할 노드의 ID
+     * @example
+     * await client.graph.deleteNodeCascade(101);
+     * // Output: (No content)
      */
     deleteNodeCascade(nodeId) {
         return this.rb.path(`/nodes/${nodeId}/cascade`).delete();
@@ -55,14 +136,57 @@ export class GraphApi {
     /**
      * 새 엣지를 생성합니다.
      * @param edge - 생성할 엣지 데이터
-     * @returns 생성된 엣지의 ID
+     *    - `source` (number): 출발 노드 ID
+     *    - `target` (number): 도착 노드 ID
+     *    - `weight` (number): 가중치
+     *    - `type` ('hard' | 'insight'): 엣지 타입
+     *    - `intraCluster` (boolean): 클러스터 내부 연결 여부
+     * @returns 생성된 엣지 ID
+     *    - `id` (string): 엣지 ID
+     * @example
+     * const response = await client.graph.createEdge({
+     *   source: 101,
+     *   target: 102,
+     *   weight: 0.85,
+     *   type: 'insight',
+     *   intraCluster: true
+     * });
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 'edge-uuid-...'
+     * }
      */
     createEdge(edge) {
         return this.rb.path('/edges').post(edge);
     }
     /**
      * 사용자의 모든 엣지를 가져옵니다.
-     * @returns 엣지 목록
+     * @returns 엣지 목록 (GraphEdgeDto 배열)
+     * @example
+     * const response = await client.graph.listEdges();
+     *
+     * console.log(response.data);
+     * // Output:
+     * [
+     *   {
+     *     id: 'edge-1',
+     *     source: 101,
+     *     target: 102,
+     *     weight: 0.85,
+     *     type: 'insight',
+     *     intraCluster: true
+     *   },
+     *   {
+     *     id: 'edge-2',
+     *     source: 102,
+     *     target: 103,
+     *     weight: 0.5,
+     *     type: 'hard',
+     *     intraCluster: false
+     *   }
+     * ]
      */
     listEdges() {
         return this.rb.path('/edges').get();
@@ -70,6 +194,9 @@ export class GraphApi {
     /**
      * 특정 엣지를 삭제합니다.
      * @param edgeId - 삭제할 엣지의 ID
+     * @example
+     * await client.graph.deleteEdge('edge-uuid-...');
+     * // Output: (No content)
      */
     deleteEdge(edgeId) {
         return this.rb.path(`/edges/${edgeId}`).delete();
@@ -78,6 +205,20 @@ export class GraphApi {
      * 새 클러스터를 생성하거나 기존 클러스터를 업데이트합니다.
      * @param cluster - 생성 또는 업데이트할 클러스터 데이터
      * @returns 생성 또는 업데이트된 클러스터
+     * @example
+     * const response = await client.graph.createCluster({
+     *   id: 'cluster-a',
+     *   name: 'Project Alpha',
+     *   summary: 'Main project discussion'
+     * });
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 'cluster-a',
+     *   name: 'Project Alpha',
+     *   summary: 'Main project discussion'
+     * }
      */
     createCluster(cluster) {
         return this.rb.path('/clusters').post(cluster);
@@ -85,6 +226,23 @@ export class GraphApi {
     /**
      * 사용자의 모든 클러스터를 가져옵니다.
      * @returns 클러스터 목록
+     * @example
+     * const response = await client.graph.listClusters();
+     *
+     * console.log(response.data);
+     * // Output:
+     * [
+     *   {
+     *     id: 'cluster-a',
+     *     name: 'Project Alpha',
+     *     summary: 'Main project discussion'
+     *   },
+     *   {
+     *     id: 'cluster-b',
+     *     name: 'Project Beta',
+     *     summary: 'Secondary project'
+     *   }
+     * ]
      */
     listClusters() {
         return this.rb.path('/clusters').get();
@@ -93,6 +251,16 @@ export class GraphApi {
      * 특정 ID의 클러스터를 가져옵니다.
      * @param clusterId - 가져올 클러스터의 ID
      * @returns 요청한 클러스터
+     * @example
+     * const response = await client.graph.getCluster('cluster-a');
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   id: 'cluster-a',
+     *   name: 'Project Alpha',
+     *   summary: 'Main project discussion'
+     * }
      */
     getCluster(clusterId) {
         return this.rb.path(`/clusters/${clusterId}`).get();
@@ -100,6 +268,9 @@ export class GraphApi {
     /**
      * 특정 클러스터를 삭제합니다.
      * @param clusterId - 삭제할 클러스터의 ID
+     * @example
+     * await client.graph.deleteCluster('cluster-a');
+     * // Output: (No content)
      */
     deleteCluster(clusterId) {
         return this.rb.path(`/clusters/${clusterId}`).delete();
@@ -107,6 +278,9 @@ export class GraphApi {
     /**
      * 특정 클러스터와 그 안의 모든 노드 및 엣지를 삭제합니다.
      * @param clusterId - 삭제할 클러스터의 ID
+     * @example
+     * await client.graph.deleteClusterCascade('cluster-a');
+     * // Output: (No content)
      */
     deleteClusterCascade(clusterId) {
         return this.rb.path(`/clusters/${clusterId}/cascade`).delete();
@@ -114,6 +288,17 @@ export class GraphApi {
     /**
      * 그래프 통계를 가져옵니다.
      * @returns 그래프 통계
+     * @example
+     * const response = await client.graph.getStats();
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   nodeCount: 100,
+     *   edgeCount: 150,
+     *   clusterCount: 5,
+     *   density: 0.03
+     * }
      */
     getStats() {
         return this.rb.path('/stats').get();
@@ -121,6 +306,23 @@ export class GraphApi {
     /**
      * 전체 그래프 스냅샷을 가져옵니다.
      * @returns 그래프 스냅샷
+     * @example
+     * const response = await client.graph.getSnapshot();
+     *
+     * console.log(response.data);
+     * // Output:
+     * {
+     *   nodes: [
+     *     { id: 101, ... },
+     *     { id: 102, ... }
+     *   ],
+     *   edges: [
+     *     { id: 'edge-1', ... }
+     *   ],
+     *   clusters: [
+     *     { id: 'cluster-a', ... }
+     *   ]
+     * }
      */
     getSnapshot() {
         return this.rb.path('/snapshot').get();
@@ -128,6 +330,13 @@ export class GraphApi {
     /**
      * 전체 그래프 스냅샷을 서버에 저장합니다.
      * @param snapshot - 저장할 스냅샷 데이터
+     * @example
+     * await client.graph.saveSnapshot({
+     *   nodes: [...],
+     *   edges: [...],
+     *   clusters: [...]
+     * });
+     * // Output: (No content)
      */
     saveSnapshot(snapshot) {
         return this.rb.path('/snapshot').post({ snapshot });

package/dist/endpoints/graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/endpoints/graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/endpoints/graph.ts"],"names":[],"mappings":"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"}