@yoonion/mimi-seed-mcp 0.3.3 → 0.3.4

package/dist/appstore/tools.d.ts

@@ -20,6 +20,25 @@ export declare function updateVersionWhatsNew(versionId: string, locale: string,
 export declare function listBuilds(appId: string): Promise<any>;
 export declare function listBetaGroups(appId: string): Promise<any>;
 export declare function getAppInfo(appId: string): Promise<any>;
+export interface AppInfoLocalizationFields {
+    name?: string;
+    subtitle?: string;
+    privacyPolicyUrl?: string;
+    privacyPolicyText?: string;
+}
+export declare function listAppInfoLocalizations(appId: string, locale?: string): Promise<{
+    appInfoId: string;
+    appInfoState: string;
+    localizations: {
+        id: any;
+        locale: any;
+        name: any;
+        subtitle: any;
+        privacyPolicyUrl: any;
+        privacyPolicyText: any;
+    }[];
+}>;
+export declare function updateAppInfoLocalization(localizationId: string, fields: AppInfoLocalizationFields): Promise<any>;
 export interface ListCustomerReviewsOptions {
     limit?: number;
     territory?: string;
@@ -27,4 +46,12 @@ export interface ListCustomerReviewsOptions {
 }
 export declare function listCustomerReviews(appId: string, opts?: ListCustomerReviewsOptions): Promise<any>;
 export declare function createReviewResponse(reviewId: string, responseBody: string): Promise<any>;
-export declare function submitVersionForReview(versionId: string): Promise<any>;
+export declare function submitVersionForReview(versionId: string): Promise<{
+    submissionId: string;
+    appId: string;
+    platform: string;
+    versionId: string;
+    reusedSubmission: boolean;
+    itemAttached: boolean;
+    state: any;
+}>;

package/dist/appstore/tools.js

@@ -174,16 +174,64 @@ export async function listBetaGroups(appId) {
     }));
 }
 // ─── 앱 정보 (카테고리 등) ───
+// AppInfoState — READY_FOR_DISTRIBUTION이 라이브 버전, 그 외(PREPARE_FOR_SUBMISSION /
+// DEVELOPER_REJECTED 등)가 편집 가능한 appInfo.
+const APP_INFO_LIVE_STATE = 'READY_FOR_DISTRIBUTION';
 export async function getAppInfo(appId) {
     const data = await apiGet(`/apps/${appId}/appInfos`, {
-        'fields[appInfos]': 'appStoreState,appStoreAgeRating,brazilAgeRating',
+        'fields[appInfos]': 'state,appStoreAgeRating,brazilAgeRating',
     });
     return (data.data ?? []).map((i) => ({
         id: i.id,
-        state: i.attributes?.appStoreState,
+        // 새 필드명 state, 옛 필드명 appStoreState 모두 케어
+        state: i.attributes?.state ?? i.attributes?.appStoreState,
         ageRating: i.attributes?.appStoreAgeRating,
     }));
 }
+async function findEditableAppInfoId(appId) {
+    const data = await apiGet(`/apps/${appId}/appInfos`, {
+        'fields[appInfos]': 'state',
+        'limit': '10',
+    });
+    const infos = (data?.data ?? []);
+    if (infos.length === 0) {
+        throw new Error(`앱 ${appId}에 appInfos가 없어. 앱 ID 확인 필요.`);
+    }
+    const stateOf = (i) => i.attributes?.state ?? i.attributes?.appStoreState ?? '';
+    const editable = infos.find((i) => stateOf(i) !== APP_INFO_LIVE_STATE);
+    const target = editable ?? infos[0];
+    return { appInfoId: target.id, state: stateOf(target) };
+}
+export async function listAppInfoLocalizations(appId, locale) {
+    const { appInfoId, state } = await findEditableAppInfoId(appId);
+    const data = await apiGet(`/appInfos/${appInfoId}/appInfoLocalizations`, {
+        'fields[appInfoLocalizations]': 'locale,name,subtitle,privacyPolicyUrl,privacyPolicyText',
+        'limit': '200',
+    });
+    const all = (data?.data ?? []).map((l) => ({
+        id: l.id,
+        locale: l.attributes?.locale,
+        name: l.attributes?.name,
+        subtitle: l.attributes?.subtitle,
+        privacyPolicyUrl: l.attributes?.privacyPolicyUrl,
+        privacyPolicyText: l.attributes?.privacyPolicyText,
+    }));
+    const filtered = locale ? all.filter((l) => l.locale === locale) : all;
+    return { appInfoId, appInfoState: state, localizations: filtered };
+}
+export async function updateAppInfoLocalization(localizationId, fields) {
+    const attributes = Object.fromEntries(Object.entries(fields).filter(([, v]) => v !== undefined));
+    if (Object.keys(attributes).length === 0) {
+        throw new Error('수정할 필드가 없어 (name / subtitle / privacyPolicyUrl / privacyPolicyText 중 하나 이상).');
+    }
+    return apiPatch(`/appInfoLocalizations/${localizationId}`, {
+        data: {
+            type: 'appInfoLocalizations',
+            id: localizationId,
+            attributes,
+        },
+    });
+}
 export async function listCustomerReviews(appId, opts = {}) {
     const params = {
         'sort': '-createdDate',
@@ -237,15 +285,92 @@ export async function createReviewResponse(reviewId, responseBody) {
     });
 }
 // ─── 심사 제출 (Submit for Review) ───
+// 2024년 1월부터 옛 /appStoreVersionSubmissions가 deprecated 됐고,
+// 새 모델은 /reviewSubmissions + /reviewSubmissionItems 2단계 + PATCH submitted=true.
+// 참고: https://developer.apple.com/documentation/appstoreconnectapi/submit-an-app-for-review
+async function getVersionAppAndPlatform(versionId) {
+    const data = await apiGet(`/appStoreVersions/${versionId}`, {
+        'fields[appStoreVersions]': 'platform,app',
+        'include': 'app',
+    });
+    const platform = data?.data?.attributes?.platform;
+    const appId = data?.data?.relationships?.app?.data?.id;
+    if (!platform || !appId) {
+        throw new Error(`appStoreVersion ${versionId}에서 app 또는 platform을 찾지 못했어. 버전 ID 확인 필요.`);
+    }
+    return { appId, platform };
+}
+async function findOpenReviewSubmission(appId, platform) {
+    const data = await apiGet('/reviewSubmissions', {
+        'filter[app]': appId,
+        'filter[platform]': platform,
+        'filter[state]': 'READY_FOR_REVIEW,COMPLETING,UNRESOLVED_ISSUES',
+        'limit': '1',
+    });
+    // CREATED 상태(아직 제출 안 된)도 별도 조회해서 우선 재사용
+    const created = await apiGet('/reviewSubmissions', {
+        'filter[app]': appId,
+        'filter[platform]': platform,
+        'filter[state]': 'CREATED',
+        'limit': '1',
+    });
+    return created?.data?.[0]?.id ?? data?.data?.[0]?.id ?? null;
+}
+async function isVersionAttached(submissionId, versionId) {
+    const data = await apiGet(`/reviewSubmissions/${submissionId}/items`, {
+        'limit': '50',
+    });
+    const items = (data?.data ?? []);
+    return items.some((it) => it?.relationships?.appStoreVersion?.data?.id === versionId);
+}
 export async function submitVersionForReview(versionId) {
-    return apiPost('/appStoreVersionSubmissions', {
-        data: {
-            type: 'appStoreVersionSubmissions',
-            relationships: {
-                appStoreVersion: {
-                    data: { type: 'appStoreVersions', id: versionId },
+    const { appId, platform } = await getVersionAppAndPlatform(versionId);
+    // 1. CREATED 상태의 reviewSubmission이 있으면 재사용, 없으면 새로 생성
+    let submissionId = await findOpenReviewSubmission(appId, platform);
+    const reusedSubmission = Boolean(submissionId);
+    if (!submissionId) {
+        const created = await apiPost('/reviewSubmissions', {
+            data: {
+                type: 'reviewSubmissions',
+                attributes: { platform },
+                relationships: {
+                    app: { data: { type: 'apps', id: appId } },
                 },
             },
+        });
+        submissionId = created?.data?.id;
+        if (!submissionId) {
+            throw new Error(`reviewSubmission 생성 응답에 id가 없어: ${JSON.stringify(created)}`);
+        }
+    }
+    // 2. 버전을 reviewSubmissionItems로 attach (이미 붙어있으면 skip)
+    const alreadyAttached = reusedSubmission ? await isVersionAttached(submissionId, versionId) : false;
+    if (!alreadyAttached) {
+        await apiPost('/reviewSubmissionItems', {
+            data: {
+                type: 'reviewSubmissionItems',
+                relationships: {
+                    reviewSubmission: { data: { type: 'reviewSubmissions', id: submissionId } },
+                    appStoreVersion: { data: { type: 'appStoreVersions', id: versionId } },
+                },
+            },
+        });
+    }
+    // 3. PATCH submitted=true → state: CREATED → WAITING_FOR_REVIEW
+    const submitted = await apiPatch(`/reviewSubmissions/${submissionId}`, {
+        data: {
+            type: 'reviewSubmissions',
+            id: submissionId,
+            attributes: { submitted: true },
         },
     });
+    return {
+        submissionId,
+        appId,
+        platform,
+        versionId,
+        reusedSubmission,
+        itemAttached: !alreadyAttached,
+        state: submitted?.data?.attributes?.state ?? 'WAITING_FOR_REVIEW',
+    };
 }

package/dist/index.js

@@ -631,10 +631,37 @@ server.tool('appstore_list_beta_groups', 'TestFlight 베타 그룹 목록', { ap
     const groups = await appstore.listBetaGroups(appId);
     return { content: [{ type: 'text', text: JSON.stringify(groups, null, 2) }] };
 });
-server.tool('appstore_get_app_info', 'App Store 앱 정보 (카테고리, 연령 등급)', { appId: z.string().describe('앱 ID') }, async ({ appId }) => {
+server.tool('appstore_get_app_info', 'App Store 앱 정보 (카테고리, 연령 등급, state). state=READY_FOR_DISTRIBUTION이 라이브, 그 외가 편집 가능 appInfo.', { appId: z.string().describe('앱 ID') }, async ({ appId }) => {
     const info = await appstore.getAppInfo(appId);
     return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] };
 });
+server.tool('appstore_list_app_info_localizations', [
+    '편집 가능한 appInfo의 로컬라이제이션 목록 조회 — 앱 이름(name), 부제(subtitle), 개인정보 URL/텍스트.',
+    'appInfo.relationships.appInfoLocalizations가 빈 배열로 오는 케이스를 우회하려고 /appInfos/{id}/appInfoLocalizations 직접 호출.',
+    'locale을 주면 해당 언어만 반환 (예: "ko", "en-US").',
+    '※ versionLocalization(설명/키워드/whatsNew)과 다름 — 그건 appstore_get_metadata 사용.',
+].join(' '), {
+    appId: z.string().describe('앱 ID (appstore_list_apps 결과)'),
+    locale: z.string().optional().describe('언어 필터 (예: "ko", "en-US"). 생략 시 전체 반환.'),
+}, async ({ appId, locale }) => {
+    const result = await appstore.listAppInfoLocalizations(appId, locale);
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+});
+server.tool('appstore_update_app_info_localization', [
+    'appInfo 로컬라이제이션(앱 이름/부제/개인정보 URL/텍스트) 수정 — PATCH /appInfoLocalizations/{id}.',
+    'localizationId는 appstore_list_app_info_localizations 결과의 id.',
+    '편집 가능 상태(PREPARE_FOR_SUBMISSION / DEVELOPER_REJECTED 등)에서만 반영됨.',
+    '제한: name 30자, subtitle 30자.',
+].join(' '), {
+    localizationId: z.string().describe('appInfoLocalization ID'),
+    name: z.string().optional().describe('앱 이름 (30자 이내)'),
+    subtitle: z.string().optional().describe('부제 (30자 이내)'),
+    privacyPolicyUrl: z.string().url().optional().describe('개인정보 처리방침 URL'),
+    privacyPolicyText: z.string().optional().describe('개인정보 처리방침 텍스트'),
+}, async ({ localizationId, ...fields }) => {
+    const result = await appstore.updateAppInfoLocalization(localizationId, fields);
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+});
 // --- App Store 고객 리뷰 ---
 server.tool('appstore_list_reviews', [
     'App Store 받은 고객 리뷰 조회 (최신순).',
@@ -663,7 +690,9 @@ server.tool('appstore_reply_review', [
 });
 // --- App Store 심사 제출 (Submit for Review) ---
 server.tool('appstore_submit_for_review', [
-    'App Store 버전을 심사에 제출 — POST /appStoreVersionSubmissions.',
+    'App Store 버전을 심사에 제출 — 새 reviewSubmissions API 사용 (옛 /appStoreVersionSubmissions는 2024-01 deprecated).',
+    '내부 흐름: POST /reviewSubmissions(또는 CREATED 상태 재사용) → POST /reviewSubmissionItems(version attach) → PATCH submitted=true.',
+    'appId와 platform은 versionId에서 자동 조회 — 별도 입력 불필요.',
     '⚠️ 비가역 작업: 제출 후엔 Apple 심사가 시작되며, 메타데이터/스크린샷/빌드를 더 못 바꿈 (REJECTED/METADATA_REJECTED 시 다시 편집 가능).',
     '사전 조건: 버전이 PREPARE_FOR_SUBMISSION 또는 DEVELOPER_REJECTED 상태, 빌드 attached, 모든 필수 메타데이터 채워짐.',
     'appstore_check_submission_risks로 사전 점검 권장.',
@@ -671,7 +700,7 @@ server.tool('appstore_submit_for_review', [
     versionId: z.string().describe('App Store 버전 ID (appstore_list_versions 결과)'),
 }, async ({ versionId }) => {
     const result = await appstore.submitVersionForReview(versionId);
-    return { content: [{ type: 'text', text: `✅ 버전 ${versionId} 심사 제출 완료. App Store Connect에서 진행 상태 확인 가능.\n\n${JSON.stringify(result, null, 2)}` }] };
+    return { content: [{ type: 'text', text: `✅ 버전 ${versionId} 심사 제출 완료 (state: ${result.state}). App Store Connect에서 진행 상태 확인 가능.\n\n${JSON.stringify(result, null, 2)}` }] };
 });
 // --- Play Store 심사 제출 / release status 변경 ---
 server.tool('playstore_submit_release', [

package/package.json

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