@yoonion/mimi-seed-mcp 0.19.5 → 0.19.7

package/README.md

@@ -63,10 +63,18 @@ npx -y @yoonion/mimi-seed-mcp mimi-seed-tiktok-business-auth # TikTok Business O
 
 각 자격증명을 **어디서 어떻게 발급받는지**는 [`docs/credentials.md`](../../docs/credentials.md) 참고.
 
-- **App Store Connect**: Users and Access → Integrations에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력 → `~/.mimi-seed/appstore.json` (.p8은 **1회만** 다운로드됨)
+- **App Store Connect**: Users and Access → Integrations에서 API Key 생성 후 Issuer ID / Key ID / `.p8`
+  경로와 선택적인 Vendor Number 입력 → Apple API 검증 성공 후 `~/.mimi-seed/appstore.json` 저장 (`.p8`은
+  **1회만** 다운로드됨). 기존 연결의 첫 질문에서 Enter/`N`은 종료, `y`는 기본 키 교체, `v`는 Vendor
+  Number만 갱신합니다. 키 교체 시 기존 `vendorNumber`와 별도 `reportsKey`는 보존됩니다.
 - **Google Play**: 서비스 계정은 **선택** — OAuth 토큰이 `androidpublisher` 스코프를 갖고 있어 로컬 작업은 그대로 됩니다. CI/헤드리스에서만 필요.
 - **BigQuery**: 선택 — OAuth로도 동작하며, Workspace 재인증 정책에 막힐 때만 서비스 계정이 필요합니다.
 
+App Store 권한은 작업별로 다릅니다. 메타데이터·출시는 **App Manager**, Analytics 리포트 요청 생성은
+**Admin**, 매출 리포트는 **Admin / Finance / Sales and Reports**가 필요합니다. Vendor Number는 App Store
+Connect 상단 **Reports**의 왼쪽 위 Legal Entity Name 아래에 표시되는 숫자입니다. 자세한 내용은
+[`docs/credentials.ko.md`](../../docs/credentials.ko.md#app-store-connect)를 참고하세요.
+
 AI 기능(릴리즈 노트 생성, 리뷰 답변)을 쓰려면:
 
 ```bash

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,8 @@ export interface AppStoreKey {
     keyId: string;
     privateKey: string;
 }
+/** 빈 입력은 미설정으로 처리하고, 값이 있으면 Apple 보고서 필터에 안전한 숫자인지 확인한다. */
+export declare function normalizeVendorNumber(vendorNumber?: string): string | undefined;
 /**
  * 최상위 ASC API 키를 교체하되 같은 파일에 저장된 선택 설정은 보존한다.
  *

package/dist/appstore/auth.js

@@ -10,6 +10,16 @@ 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 키를 교체하되 같은 파일에 저장된 선택 설정은 보존한다.
  *
@@ -19,7 +29,7 @@ const LEGACY_CONFIG_PATH = path.join(os.homedir(), '.preseed', 'appstore.json');
  */
 export function mergeAppStoreCredentials(existing, primary, vendorNumber) {
     const merged = { ...(existing ?? {}), ...primary };
-    const normalizedVendorNumber = vendorNumber?.trim();
+    const normalizedVendorNumber = normalizeVendorNumber(vendorNumber);
     if (normalizedVendorNumber)
         merged.vendorNumber = normalizedVendorNumber;
     return merged;

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,6 +1,6 @@
 #!/usr/bin/env node
 import { getAppStoreCredentials, mergeAppStoreCredentials } from './auth.js';
-import { verifyAndSaveAppStoreCredentials } from './setup.js';
+import { collectExistingSetupIntent, verifyAndSaveAppStoreCredentials } from './setup.js';
 import readline from 'node:readline';
 import fs from 'node:fs';
 import { resolveLang } from '../lib/lang.js';
@@ -8,7 +8,7 @@ import { resolveLang } from '../lib/lang.js';
 const ko = {
     title: '  🍎 Mimi Seed — App Store Connect 연결',
     already: (keyId) => `  ✅ 설정 파일 있음 (Key ID: ${keyId}) — API 권한은 다시 검증합니다`,
-    reconnect: '  API Key도 다시 설정할래? (y/N): ',
+    reconnect: '  API Key를 다시 설정할래? (y/N, v=Vendor Number만): ',
     needTitle: '  App Store Connect에서 API Key를 만들어야 해:',
     step1: '  1. "키 생성" 클릭',
     step2: '  2. 이름: Mimi Seed, 역할: Admin',
@@ -29,7 +29,7 @@ const ko = {
 const en = {
     title: '  🍎 Mimi Seed — Connect App Store Connect',
     already: (keyId) => `  ✅ Configuration found (Key ID: ${keyId}) — API access will be verified again`,
-    reconnect: '  Replace the API Key too? (y/N): ',
+    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',
@@ -64,12 +64,15 @@ async function main() {
     console.log(M.title);
     console.log('');
     const existing = getAppStoreCredentials();
-    let vendorNumber = '';
+    let vendorNumber;
     if (existing) {
         console.log(M.already(existing.keyId));
-        vendorNumber = await ask(M.askVendorNumber);
-        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))
@@ -89,8 +92,7 @@ async function main() {
     const issuerId = await ask(M.askIssuerId);
     const keyId = await ask(M.askKeyId);
     const p8Path = await ask(M.askP8Path);
-    if (!existing)
-        vendorNumber = await ask(M.askVendorNumber);
+    vendorNumber = await ask(M.askVendorNumber);
     const trimmedPath = p8Path.trim().replace(/^["']|["']$/g, '');
     if (!fs.existsSync(trimmedPath)) {
         console.log(M.noFile(trimmedPath));

package/dist/appstore/setup.d.ts

@@ -4,6 +4,15 @@ 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

@@ -4,6 +4,21 @@ 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);

package/package.json

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