byuckchon-frontend-cli 1.0.3 → 1.4.0

package/src/openapi/fetch.js

@@ -0,0 +1,69 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+/**
+ * OpenAPI 스펙을 URL/파일경로/JSON객체 중 무엇으로 받든 정상화해서
+ * `{ source, doc }` 로 돌려준다.
+ *
+ * - URL  ('http://' / 'https://') → fetch 후 파싱
+ * - 파일 경로 (.json / .yaml / .yml) → 디스크에서 읽기
+ *   - YAML 은 openapi-typescript 에 그대로 넘겨도 되지만, 우리가 endpoint 요약을
+ *     뽑을 땐 JSON 객체가 필요해서 yaml 파서가 필요함. 의존성 키우지 않도록
+ *     YAML 인 경우 doc 필드는 null 로 두고 source(원본 문자열)만 반환한다.
+ * - 그 외 → 에러
+ *
+ * 반환된 source 는 openapi-typescript 의 입력으로 그대로 쓸 수 있다.
+ */
+export async function loadOpenApi(input) {
+  if (!input) {
+    const e = new Error('OpenAPI 입력이 비어있습니다 (URL 또는 파일 경로 필요).');
+    e.code = 'BC_NO_OPENAPI_INPUT';
+    throw e;
+  }
+
+  // URL?
+  if (/^https?:\/\//.test(input)) {
+    const res = await fetch(input);
+    if (!res.ok) {
+      const e = new Error(`OpenAPI fetch 실패: ${res.status} ${res.statusText} (${input})`);
+      e.code = 'BC_OPENAPI_FETCH_FAILED';
+      throw e;
+    }
+    const text = await res.text();
+    let doc = null;
+    try {
+      doc = JSON.parse(text);
+    } catch {
+      // 서버가 YAML 을 줄 수도 있다 — 객체 추출은 포기하지만 source(URL) 는 그대로.
+    }
+    return { source: input, text, doc };
+  }
+
+  // 로컬 파일?
+  const abs = path.resolve(input);
+  let stat;
+  try {
+    stat = await fs.stat(abs);
+  } catch {
+    const e = new Error(`OpenAPI 파일을 찾을 수 없습니다: ${input}`);
+    e.code = 'BC_OPENAPI_FILE_NOT_FOUND';
+    throw e;
+  }
+  if (!stat.isFile()) {
+    const e = new Error(`OpenAPI 경로가 파일이 아닙니다: ${input}`);
+    e.code = 'BC_OPENAPI_NOT_A_FILE';
+    throw e;
+  }
+  const text = await fs.readFile(abs, 'utf8');
+  let doc = null;
+  if (abs.endsWith('.json')) {
+    try {
+      doc = JSON.parse(text);
+    } catch (err) {
+      const e = new Error(`JSON 파싱 실패: ${err.message}`);
+      e.code = 'BC_OPENAPI_PARSE_FAILED';
+      throw e;
+    }
+  }
+  return { source: abs, text, doc };
+}

package/src/openapi/summary.js

@@ -0,0 +1,75 @@
+/**
+ * 파싱된 OpenAPI 객체를 → 모델에 주입할 "압축 요약" 텍스트로 변환.
+ *
+ * 목표: 토큰 폭발 방지하면서도 모델이 "이 API 스펙이 있구나, 어떤 엔드포인트가
+ * 있구나" 를 알게 하는 정도. 자세한 스키마는 RAG 가 types.gen.ts 통해서 별도로
+ * 가져오게 함.
+ *
+ * 결과 형태 (예):
+ *   API: Petstore v3.0
+ *   base: /api/v3
+ *   endpoints:
+ *     GET    /pet/{petId}        Find pet by ID
+ *     POST   /pet                 Add a new pet to the store
+ *     ...
+ */
+const METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+const MAX_ENDPOINTS = 200;
+const MAX_BYTES = 8 * 1024;
+
+export function summarizeOpenApi(doc) {
+  if (!doc || typeof doc !== 'object') return null;
+
+  const lines = [];
+  const title = doc.info?.title ?? '(untitled)';
+  const version = doc.info?.version ?? '';
+  lines.push(`API: ${title}${version ? ' v' + version : ''}`);
+
+  const servers = (doc.servers ?? []).map((s) => s.url).filter(Boolean);
+  if (servers.length) {
+    lines.push(`base: ${servers.slice(0, 3).join(', ')}`);
+  }
+
+  const endpoints = [];
+  for (const [pathStr, methods] of Object.entries(doc.paths ?? {})) {
+    if (!methods || typeof methods !== 'object') continue;
+    for (const m of METHODS) {
+      const op = methods[m];
+      if (!op || typeof op !== 'object') continue;
+      const desc = op.summary || op.operationId || op.description || '';
+      endpoints.push({
+        method: m.toUpperCase(),
+        path: pathStr,
+        desc: desc.split('\n')[0].slice(0, 90),
+      });
+    }
+  }
+
+  // 너무 많으면 자른다 — 모델이 알아야 하는 건 "어떤 종류의 엔드포인트가 있다" 정도면 충분.
+  const total = endpoints.length;
+  const shown = endpoints.slice(0, MAX_ENDPOINTS);
+
+  lines.push(`endpoints: (${shown.length}/${total})`);
+  for (const e of shown) {
+    lines.push(`  ${e.method.padEnd(6)} ${e.path}${e.desc ? '  -- ' + e.desc : ''}`);
+  }
+  if (shown.length < total) {
+    lines.push(`  ... and ${total - shown.length} more`);
+  }
+
+  let result = lines.join('\n');
+  if (Buffer.byteLength(result, 'utf8') > MAX_BYTES) {
+    // 안전 장치 — desc 다 자르고 다시.
+    const compact = [
+      lines[0],
+      servers.length ? lines[1] : null,
+      `endpoints: (${shown.length}/${total})`,
+      ...shown.map((e) => `  ${e.method.padEnd(6)} ${e.path}`),
+      shown.length < total ? `  ... and ${total - shown.length} more` : null,
+    ]
+      .filter(Boolean)
+      .join('\n');
+    result = compact;
+  }
+  return result;
+}

package/src/prompts/initPrompts.js

@@ -1,5 +1,7 @@
 import inquirer from 'inquirer';
 
+import { modelChoices, DEFAULT_MODEL_ID } from '../ai/models.js';
+
 export async function askInitQuestions() {
   return inquirer.prompt([
     {
@@ -22,5 +24,27 @@ export async function askInitQuestions() {
         { name: 'Next.js  (App Router + TypeScript)', value: 'next' },
       ],
     },
+    {
+      type: 'list',
+      name: 'aiModel',
+      message: 'bc chat 에서 기본으로 쓸 AI 모델은?',
+      choices: [
+        ...modelChoices(),
+        { name: '나중에 설정 (bc config set-model)', value: null },
+      ],
+      default: DEFAULT_MODEL_ID,
+    },
+    {
+      type: 'input',
+      name: 'figmaUrl',
+      message: 'Figma 파일 URL (선택, 엔터로 건너뛰기):',
+      default: '',
+    },
+    {
+      type: 'input',
+      name: 'openapiUrl',
+      message: '백엔드 OpenAPI(Swagger) URL (선택, 엔터로 건너뛰기):',
+      default: '',
+    },
   ]);
 }