@framingui/mcp-server 0.6.0 → 0.6.2

package/dist/api/api-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-result.d.ts","sourceRoot":"","sources":["../../src/api/api-result.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,MAAM,MAAM,YAAY,GACpB,aAAa,GACb,WAAW,GACX,WAAW,GACX,cAAc,GACd,cAAc,GACd,eAAe,GACf,mBAAmB,CAAC;AAExB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAElF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAcjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBzE"}

package/dist/api/api-result.js

@@ -0,0 +1,50 @@
+/**
+ * API Result 타입 시스템
+ * 에러 유형을 명확히 구분하여 tool 핸들러가 적절한 메시지를 반환할 수 있게 함
+ *
+ * 기존 문제: apiFetch가 모든 실패를 null로 반환 → "라이선스 없음"으로 오해
+ * 해결: 에러 코드 기반 분류로 auth/forbidden/not_found/server/network 구분
+ */
+/**
+ * HTTP 상태 코드 → ApiErrorCode 매핑
+ */
+export function mapStatusToErrorCode(status) {
+    if (status === 401) {
+        return 'AUTH_FAILED';
+    }
+    if (status === 403) {
+        return 'FORBIDDEN';
+    }
+    if (status === 404) {
+        return 'NOT_FOUND';
+    }
+    if (status === 429) {
+        return 'RATE_LIMITED';
+    }
+    return 'SERVER_ERROR';
+}
+/**
+ * Tool 핸들러용 에러 메시지 포맷터
+ * ApiError → 사용자 친화적 메시지 변환
+ */
+export function formatToolError(error, context) {
+    const prefix = context ? `[${context}] ` : '';
+    switch (error.code) {
+        case 'AUTH_FAILED':
+        case 'NOT_AUTHENTICATED':
+            return `${prefix}Authentication failed. Please run \`whoami\` first or check your API key.`;
+        case 'FORBIDDEN':
+            return `${prefix}${error.message}`;
+        case 'NOT_FOUND':
+            return `${prefix}${error.message}`;
+        case 'RATE_LIMITED':
+            return `${prefix}Rate limit exceeded. Please wait a moment and try again.`;
+        case 'SERVER_ERROR':
+            return `${prefix}Server error (${error.status || 'unknown'}). Please try again later. Details: ${error.message}`;
+        case 'NETWORK_ERROR':
+            return `${prefix}Network error: ${error.message}. Check your internet connection.`;
+        default:
+            return `${prefix}Unexpected error: ${error.message}`;
+    }
+}
+//# sourceMappingURL=api-result.js.map

package/dist/api/api-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-result.js","sourceRoot":"","sources":["../../src/api/api-result.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAe,EAAE,OAAgB;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,aAAa,CAAC;QACnB,KAAK,mBAAmB;YACtB,OAAO,GAAG,MAAM,2EAA2E,CAAC;QAC9F,KAAK,WAAW;YACd,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACrC,KAAK,WAAW;YACd,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACrC,KAAK,cAAc;YACjB,OAAO,GAAG,MAAM,0DAA0D,CAAC;QAC7E,KAAK,cAAc;YACjB,OAAO,GAAG,MAAM,iBAAiB,KAAK,CAAC,MAAM,IAAI,SAAS,uCAAuC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnH,KAAK,eAAe;YAClB,OAAO,GAAG,MAAM,kBAAkB,KAAK,CAAC,OAAO,mCAAmC,CAAC;QACrF;YACE,OAAO,GAAG,MAAM,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC;IACzD,CAAC;AACH,CAAC"}

package/dist/api/data-client.d.ts

@@ -1,12 +1,17 @@
 /**
- * MCP 서버 API 데이터 클라이언트
- * 로컬 파일 시스템 읽기를 framingui.com API fetch로 대체
+ * MCP 서버 API 데이터 클라이언트 (v2 - ApiResult 기반)
+ *
+ * 변경 이력:
+ * - v1: T | null 반환 → 모든 실패가 null로 통일되어 에러 유형 구분 불가
+ * - v2: ApiResult<T> 반환 → 에러 코드 기반 분류로 tool이 적절한 메시지 제공
  *
  * 기존 인프라 재사용:
  * - resolveFraminguiApiUrl(): base URL 결정
- * - getAuthData(): API key 가져오기
- * - MemoryCache: 인메모리 캐시 (TTL: 10분)
+ * - getAuthData(): 인증 상태 확인
+ * - getRawApiKey(): Bearer 토큰
+ * - MemoryCache: 인메모리 캐시 (TTL: 10분, stale fallback 지원)
  */
+import type { ApiResult } from './api-result.js';
 export interface ThemeMeta {
     id: string;
     name: string;
@@ -70,55 +75,48 @@ export interface ScreenExample {
 /**
  * 테마 목록 조회 (라이선스 보유 테마만)
  */
-export declare function fetchThemeList(): Promise<ThemeMeta[]>;
+export declare function fetchThemeList(): Promise<ApiResult<ThemeMeta[]>>;
 /**
  * 단일 테마 상세 조회 (전체 ThemeV2 JSON)
  */
-export declare function fetchTheme(themeId: string): Promise<any | null>;
+export declare function fetchTheme(themeId: string): Promise<ApiResult<any>>;
 /**
  * 아이콘 라이브러리 목록 조회
  */
-export declare function fetchIconLibraryList(): Promise<IconLibMeta[]>;
+export declare function fetchIconLibraryList(): Promise<ApiResult<IconLibMeta[]>>;
 /**
- * 단일 아이콘 라이브러리 상세 조회 (전체 IconLibrary JSON)
+ * 단일 아이콘 라이브러리 상세 조회
  */
-export declare function fetchIconLibrary(libraryId: string): Promise<any | null>;
+export declare function fetchIconLibrary(libraryId: string): Promise<ApiResult<any>>;
 /**
  * 스크린 템플릿 목록 조회
- * [SPEC-MCP-007:E-001]
  */
 export declare function fetchTemplateList(params?: {
     category?: string;
     search?: string;
-}): Promise<TemplateMeta[]>;
+}): Promise<ApiResult<TemplateMeta[]>>;
 /**
  * 단일 스크린 템플릿 상세 조회
- * [SPEC-MCP-007:E-002]
  */
-export declare function fetchTemplate(templateId: string): Promise<any | null>;
+export declare function fetchTemplate(templateId: string): Promise<ApiResult<any>>;
 /**
- * UI 컴포넌트 목록 조회 (전체 카탈로그)
- * [SPEC-MCP-007:E-003]
+ * UI 컴포넌트 목록 조회
  */
-export declare function fetchComponentList(): Promise<ComponentMeta[]>;
+export declare function fetchComponentList(): Promise<ApiResult<ComponentMeta[]>>;
 /**
- * 단일 컴포넌트 상세 정보 조회 (props + variants + examples 포함)
- * [SPEC-MCP-007:E-004]
+ * 단일 컴포넌트 상세 조회
  */
-export declare function fetchComponent(componentId: string): Promise<ComponentDetail | null>;
+export declare function fetchComponent(componentId: string): Promise<ApiResult<ComponentDetail>>;
 /**
- * 레이아웃 토큰 목록 조회 (shell / page / section)
- * [SPEC-MCP-007:E-005]
+ * 레이아웃 토큰 목록 조회
  */
-export declare function fetchTokenList(tokenType?: 'shell' | 'page' | 'section' | 'all'): Promise<TokenListResponse>;
+export declare function fetchTokenList(tokenType?: 'shell' | 'page' | 'section' | 'all'): Promise<ApiResult<TokenListResponse>>;
 /**
  * 테마 CSS 변수 문자열 조회
- * [SPEC-MCP-007:E-006]
  */
-export declare function fetchCSSVariables(themeId: string): Promise<string | null>;
+export declare function fetchCSSVariables(themeId: string): Promise<ApiResult<string>>;
 /**
  * 스크린 예제 정의 목록 조회
- * [SPEC-MCP-007:E-007]
  */
-export declare function fetchScreenExamples(): Promise<ScreenExample[]>;
+export declare function fetchScreenExamples(): Promise<ApiResult<ScreenExample[]>>;
 //# sourceMappingURL=data-client.d.ts.map

package/dist/api/data-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-client.d.ts","sourceRoot":"","sources":["../../src/api/data-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-client.d.ts","sourceRoot":"","sources":["../../src/api/data-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAUjD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1D,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,GAAG,CAAC;CACjB;AA+KD;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAQtE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAQzE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAW9E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAQjF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,CAwBrC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAQ/E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAW9E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAW7F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAC/C,OAAO,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAkBvC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAQnF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAW/E"}