@yoonion/mimi-seed-mcp 0.19.4 → 0.19.6

package/dist/appstore/auth.d.ts

@@ -5,7 +5,7 @@ export interface AppStoreCredentials {
     /**
      * Sales and Trends / Finance 리포트 전용 판매자 번호.
      *
-     * **API 로는 조회할 수 없다** — ASC > 지급 및 재무 보고서 화면에서 눈으로 읽어
+     * **API 로는 조회할 수 없다** — ASC > Reports 화면의 Legal Entity Name 아래에서 눈으로 읽어
      * 여기 적어두는 수밖에 없다. 리포트 도구에만 쓰이므로 없어도 나머지는 다 동작한다.
      */
     vendorNumber?: string;
@@ -31,6 +31,16 @@ export interface AppStoreKey {
     keyId: string;
     privateKey: string;
 }
+/** 빈 입력은 미설정으로 처리하고, 값이 있으면 Apple 보고서 필터에 안전한 숫자인지 확인한다. */
+export declare function normalizeVendorNumber(vendorNumber?: string): string | undefined;
+/**
+ * 최상위 ASC API 키를 교체하되 같은 파일에 저장된 선택 설정은 보존한다.
+ *
+ * 재인증은 primary key 교체이지 appstore.json 전체 초기화가 아니다. 특히
+ * vendorNumber 와 reportsKey 는 별도 화면/키에서 얻는 값이라 다시 묻지 않고
+ * 지우면 매출·분석 기능이 조용히 망가진다.
+ */
+export declare function mergeAppStoreCredentials(existing: AppStoreCredentials | null, primary: AppStoreKey, vendorNumber?: string): AppStoreCredentials;
 export declare function getAppStoreCredentials(): AppStoreCredentials | null;
 export declare function saveAppStoreCredentials(creds: AppStoreCredentials): void;
 export declare function generateToken(creds: AppStoreCredentials): Promise<string>;

package/dist/appstore/auth.js

@@ -10,6 +10,30 @@ import { writeCredentialJson } from '../lib/atomic-write.js';
 // force a re-setup.
 const CONFIG_PATH = path.join(os.homedir(), '.mimi-seed', 'appstore.json');
 const LEGACY_CONFIG_PATH = path.join(os.homedir(), '.preseed', 'appstore.json');
+/** 빈 입력은 미설정으로 처리하고, 값이 있으면 Apple 보고서 필터에 안전한 숫자인지 확인한다. */
+export function normalizeVendorNumber(vendorNumber) {
+    const normalized = vendorNumber?.trim();
+    if (!normalized)
+        return undefined;
+    if (!/^\d+$/.test(normalized)) {
+        throw new Error('Vendor Number는 숫자만 입력하세요 (digits only).');
+    }
+    return normalized;
+}
+/**
+ * 최상위 ASC API 키를 교체하되 같은 파일에 저장된 선택 설정은 보존한다.
+ *
+ * 재인증은 primary key 교체이지 appstore.json 전체 초기화가 아니다. 특히
+ * vendorNumber 와 reportsKey 는 별도 화면/키에서 얻는 값이라 다시 묻지 않고
+ * 지우면 매출·분석 기능이 조용히 망가진다.
+ */
+export function mergeAppStoreCredentials(existing, primary, vendorNumber) {
+    const merged = { ...(existing ?? {}), ...primary };
+    const normalizedVendorNumber = normalizeVendorNumber(vendorNumber);
+    if (normalizedVendorNumber)
+        merged.vendorNumber = normalizedVendorNumber;
+    return merged;
+}
 export function getAppStoreCredentials() {
     const pathToRead = fs.existsSync(CONFIG_PATH)
         ? CONFIG_PATH

package/dist/appstore/sales.js

@@ -9,7 +9,7 @@
 // sandbox 가 들어오지 않는 창구를 봐야 하고, 그게 이 리포트다.
 import zlib from 'node:zlib';
 import { fetchWithTimeout } from '../lib/http.js';
-import { getAppStoreCredentials, getReportsAuthHeaders } from './auth.js';
+import { getAppStoreCredentials, getReportsAuthHeaders, normalizeVendorNumber } from './auth.js';
 import { friendlyAppStoreError } from './errors.js';
 import { V1_BASE } from './http.js';
 /**
@@ -20,12 +20,13 @@ import { V1_BASE } from './http.js';
  * 매출 0 으로 둔갑하는 게 이 도구에서 제일 위험한 오답이라 사전에 막는다.
  */
 function resolveVendorNumber(explicit) {
-    const vendorNumber = explicit?.trim() || getAppStoreCredentials()?.vendorNumber?.trim();
+    const vendorNumber = normalizeVendorNumber(explicit)
+        ?? normalizeVendorNumber(getAppStoreCredentials()?.vendorNumber);
     if (!vendorNumber) {
         throw new Error([
             '❌ vendorNumber 가 없어 — 매출 리포트는 판매자 번호가 반드시 필요해.',
             '',
-            'App Store Connect > 비즈니스(지급 및 재무 보고서) 상단에 있는 8~9자리 숫자야.',
+            'App Store Connect > Reports > 왼쪽 위 Legal Entity Name 아래에 있는 숫자야.',
             'API 로는 조회할 수 없으니 한 번만 저장해 두면 이후 생략할 수 있어:',
             '  ~/.mimi-seed/appstore.json 에 "vendorNumber": "<번호>" 추가',
             '또는 이 도구의 vendorNumber 인자로 직접 넘겨.',

package/dist/appstore/setup-cli.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
-import { saveAppStoreCredentials, getAppStoreCredentials } from './auth.js';
+import { getAppStoreCredentials, mergeAppStoreCredentials } from './auth.js';
+import { collectExistingSetupIntent, verifyAndSaveAppStoreCredentials } from './setup.js';
 import readline from 'node:readline';
 import fs from 'node:fs';
 import { resolveLang } from '../lib/lang.js';
 // ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
 const ko = {
     title: '  🍎 Mimi Seed — App Store Connect 연결',
-    already: (keyId) => `  ✅ 이미 연결됨 (Key ID: ${keyId})`,
-    reconnect: '  다시 설정할래? (y/N): ',
+    already: (keyId) => `  ✅ 설정 파일 있음 (Key ID: ${keyId}) — API 권한은 다시 검증합니다`,
+    reconnect: '  API Key를 다시 설정할래? (y/N, v=Vendor Number만): ',
     needTitle: '  App Store Connect에서 API Key를 만들어야 해:',
     step1: '  1. "키 생성" 클릭',
     step2: '  2. 이름: Mimi Seed, 역할: Admin',
@@ -15,16 +16,20 @@ const ko = {
     askIssuerId: '  Issuer ID: ',
     askKeyId: '  Key ID: ',
     askP8Path: '  .p8 파일 경로: ',
+    askVendorNumber: '  Vendor Number (선택, Enter로 기존 값 유지): ',
     noFile: (p) => `  ❌ 파일 없음: ${p}`,
-    done: '  ✅ 연결 완료!',
+    verifying: '  Apple API로 자격증명을 검증하는 중...',
+    verifyFailed: (stage, message) => `  ❌ 검증 실패 (${stage}) — 저장하지 않았습니다.\n${message}`,
+    done: '  ✅ 연결 완료! (App Store API 검증 성공)',
+    vendorDone: '  ✅ Vendor Number 저장 완료! (기존 App Store API 키 검증 성공)',
     nextTitle: '  이제 Claude Code 또는 Codex에서:',
     nextExample1: '    "내 앱스토어 앱 목록 보여줘"',
     nextExample2: '    "TestFlight 빌드 목록 보여줘"',
 };
 const en = {
     title: '  🍎 Mimi Seed — Connect App Store Connect',
-    already: (keyId) => `  ✅ Already connected (Key ID: ${keyId})`,
-    reconnect: '  Set it up again? (y/N): ',
+    already: (keyId) => `  ✅ Configuration found (Key ID: ${keyId}) — API access will be verified again`,
+    reconnect: '  Replace the API Key? (y/N, v=Vendor Number only): ',
     needTitle: '  You need to create an API Key in App Store Connect:',
     step1: '  1. Click "Generate API Key"',
     step2: '  2. Name: Mimi Seed, Access: Admin',
@@ -32,8 +37,12 @@ const en = {
     askIssuerId: '  Issuer ID: ',
     askKeyId: '  Key ID: ',
     askP8Path: '  Path to the .p8 file: ',
+    askVendorNumber: '  Vendor Number (optional, Enter keeps the saved value): ',
     noFile: (p) => `  ❌ File not found: ${p}`,
-    done: '  ✅ Connected!',
+    verifying: '  Verifying the credentials with the Apple API...',
+    verifyFailed: (stage, message) => `  ❌ Verification failed (${stage}) — nothing was saved.\n${message}`,
+    done: '  ✅ Connected! (App Store API verification passed)',
+    vendorDone: '  ✅ Vendor Number saved! (existing App Store API key verification passed)',
     nextTitle: '  Now, in Claude Code or Codex:',
     nextExample1: '    "Show my App Store apps"',
     nextExample2: '    "List the TestFlight builds"',
@@ -41,15 +50,34 @@ const en = {
 const M = resolveLang() === 'en' ? en : ko;
 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 const ask = (q) => new Promise((r) => rl.question(q, r));
+async function saveIfVerified(credentials) {
+    console.log(M.verifying);
+    const verification = await verifyAndSaveAppStoreCredentials(credentials);
+    if (verification.ok)
+        return true;
+    console.log(M.verifyFailed(verification.stage, verification.message));
+    process.exitCode = 1;
+    return false;
+}
 async function main() {
     console.log('');
     console.log(M.title);
     console.log('');
     const existing = getAppStoreCredentials();
+    let vendorNumber;
     if (existing) {
         console.log(M.already(existing.keyId));
-        const answer = await ask(M.reconnect);
-        if (answer.toLowerCase() !== 'y') {
+        const intent = await collectExistingSetupIntent(ask, {
+            reconnect: M.reconnect,
+            vendorNumber: M.askVendorNumber,
+        });
+        if (!intent.replacePrimaryKey) {
+            vendorNumber = intent.vendorNumber;
+            if (vendorNumber.trim()) {
+                const credentials = mergeAppStoreCredentials(existing, existing, vendorNumber);
+                if (await saveIfVerified(credentials))
+                    console.log(M.vendorDone);
+            }
             rl.close();
             return;
         }
@@ -64,6 +92,7 @@ async function main() {
     const issuerId = await ask(M.askIssuerId);
     const keyId = await ask(M.askKeyId);
     const p8Path = await ask(M.askP8Path);
+    vendorNumber = await ask(M.askVendorNumber);
     const trimmedPath = p8Path.trim().replace(/^["']|["']$/g, '');
     if (!fs.existsSync(trimmedPath)) {
         console.log(M.noFile(trimmedPath));
@@ -71,11 +100,11 @@ async function main() {
         process.exit(1);
     }
     const privateKey = fs.readFileSync(trimmedPath, 'utf-8');
-    saveAppStoreCredentials({
-        issuerId: issuerId.trim(),
-        keyId: keyId.trim(),
-        privateKey,
-    });
+    const credentials = mergeAppStoreCredentials(existing, { issuerId: issuerId.trim(), keyId: keyId.trim(), privateKey }, vendorNumber);
+    if (!(await saveIfVerified(credentials))) {
+        rl.close();
+        return;
+    }
     console.log('');
     console.log(M.done);
     console.log('');

package/dist/appstore/setup.d.ts

@@ -0,0 +1,18 @@
+import { type AppStoreCredentials } from './auth.js';
+import { type AppStoreVerifyResult } from './tools.js';
+interface SetupDependencies {
+    verify: (credentials: AppStoreCredentials) => Promise<AppStoreVerifyResult>;
+    save: (credentials: AppStoreCredentials) => void;
+}
+export interface ExistingSetupIntent {
+    replacePrimaryKey: boolean;
+    vendorNumber: string;
+}
+/** 기존 사용자의 익숙한 첫 질문(API Key 재설정)을 바꾸지 않는 대화 순서 계약. */
+export declare function collectExistingSetupIntent(ask: (question: string) => Promise<string>, prompts: {
+    reconnect: string;
+    vendorNumber: string;
+}): Promise<ExistingSetupIntent>;
+/** Apple API에서 실제로 쓸 수 있는 키인지 확인한 뒤에만 디스크에 저장한다. */
+export declare function verifyAndSaveAppStoreCredentials(credentials: AppStoreCredentials, dependencies?: SetupDependencies): Promise<AppStoreVerifyResult>;
+export {};

package/dist/appstore/setup.js

@@ -0,0 +1,28 @@
+import { saveAppStoreCredentials, } from './auth.js';
+import { verifyAppStoreCredentials, } from './tools.js';
+const defaultDependencies = {
+    verify: verifyAppStoreCredentials,
+    save: saveAppStoreCredentials,
+};
+/** 기존 사용자의 익숙한 첫 질문(API Key 재설정)을 바꾸지 않는 대화 순서 계약. */
+export async function collectExistingSetupIntent(ask, prompts) {
+    const reconnect = await ask(prompts.reconnect);
+    const action = reconnect.trim().toLowerCase();
+    if (action === 'y') {
+        return { replacePrimaryKey: true, vendorNumber: '' };
+    }
+    if (action !== 'v') {
+        return { replacePrimaryKey: false, vendorNumber: '' };
+    }
+    return {
+        replacePrimaryKey: false,
+        vendorNumber: await ask(prompts.vendorNumber),
+    };
+}
+/** Apple API에서 실제로 쓸 수 있는 키인지 확인한 뒤에만 디스크에 저장한다. */
+export async function verifyAndSaveAppStoreCredentials(credentials, dependencies = defaultDependencies) {
+    const result = await dependencies.verify(credentials);
+    if (result.ok)
+        dependencies.save(credentials);
+    return result;
+}

package/dist/appstore/tools.d.ts

@@ -17,7 +17,7 @@ export interface AppStoreVerifyResult {
  * 파일 존재만 보는 requireAppStoreCreds 와 달리, 잘못된 .p8/keyId/issuerId 를
  * "첫 호출 401" 로 늦게 터지기 전에 setup 단계에서 잡아준다.
  */
-export declare function verifyAppStoreCredentials(): Promise<AppStoreVerifyResult>;
+export declare function verifyAppStoreCredentials(creds?: import("./auth.js").AppStoreCredentials | null): Promise<AppStoreVerifyResult>;
 export declare function listApps(): Promise<any>;
 export declare function getApp(appId: string): Promise<any>;
 export declare function listVersions(appId: string): Promise<any>;

package/dist/appstore/tools.js

@@ -36,8 +36,7 @@ export async function apiGet(path, params) {
  * 파일 존재만 보는 requireAppStoreCreds 와 달리, 잘못된 .p8/keyId/issuerId 를
  * "첫 호출 401" 로 늦게 터지기 전에 setup 단계에서 잡아준다.
  */
-export async function verifyAppStoreCredentials() {
-    const creds = getAppStoreCredentials();
+export async function verifyAppStoreCredentials(creds = getAppStoreCredentials()) {
     if (!creds) {
         return {
             ok: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.19.4",
+  "version": "0.19.6",
   "description": "Mimi Seed MCP server \u2014 Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {