@yoonion/mimi-seed-mcp 0.3.3 → 0.3.5

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', [
@@ -689,6 +718,39 @@ server.tool('playstore_submit_release', [
     const result = await playstore.submitRelease(auth, packageName, track, versionCode, status);
     return { content: [{ type: 'text', text: `✅ ${packageName} ${track} v${versionCode}: ${result.previousStatus} → ${result.newStatus}\n\n${JSON.stringify(result, null, 2)}` }] };
 });
+// --- Play Store 트랙 간 promote (internal → production 등) ---
+server.tool('playstore_promote_release', [
+    'Google Play 트랙 간 release promote — fromTrack(예: internal)의 versionCode를 toTrack(예: production)에 새 release로 추가.',
+    '단일 edit session에서 source 조회 → target 업데이트 → commit 까지 한 번에 처리.',
+    'source의 releaseNotes를 자동 복사 (copyReleaseNotes=false 또는 releaseNotes로 덮어쓰기 가능).',
+    'status="completed" + production 으로 전체 출시, status="inProgress" + userFraction 으로 단계 출시(예: 0.1 = 10%).',
+    'target에 같은 versionCode가 이미 있으면 해당 항목을 교체. status="completed"면 target 활성 release를 통째로 새 것으로 대체.',
+    '⚠️ status="completed"는 비가역에 가까움. playstore_check_submission_risks로 사전 점검 권장.',
+].join(' '), {
+    packageName: z.string().describe('패키지명 (예: gg.pryzm.coffee)'),
+    fromTrack: z.enum(['production', 'beta', 'alpha', 'internal']).describe('출처 트랙 (예: internal)'),
+    toTrack: z.enum(['production', 'beta', 'alpha', 'internal']).describe('대상 트랙 (예: production)'),
+    versionCode: z.string().describe('promote할 versionCode (문자열)'),
+    status: z.enum(['completed', 'draft', 'inProgress', 'halted']).optional().describe('대상 트랙에서의 status (기본 completed)'),
+    userFraction: z.number().min(0).max(1).optional().describe('status="inProgress"일 때 단계 출시 비율 (0~1, 예: 0.1)'),
+    releaseName: z.string().optional().describe('release 이름 (미지정 시 source 이름 그대로)'),
+    copyReleaseNotes: z.boolean().optional().describe('source releaseNotes 복사 여부 (기본 true)'),
+    releaseNotes: z.array(z.object({
+        language: z.string().describe('언어 코드 (예: ko-KR, en-US)'),
+        text: z.string().describe('릴리스 노트 본문 (500자 이내)'),
+    })).optional().describe('대상 트랙용 릴리스 노트 (미지정 + copyReleaseNotes=true면 source 그대로)'),
+}, async ({ packageName, fromTrack, toTrack, versionCode, status, userFraction, releaseName, copyReleaseNotes, releaseNotes }) => {
+    const auth = requireAuth();
+    const result = await playstore.promoteRelease(auth, packageName, fromTrack, toTrack, versionCode, {
+        status,
+        userFraction,
+        releaseName,
+        copyReleaseNotes,
+        releaseNotes,
+    });
+    const summary = `✅ ${packageName} ${fromTrack} → ${toTrack} v${versionCode} (status: ${result.newStatus}${result.userFraction != null ? `, userFraction: ${result.userFraction}` : ''})`;
+    return { content: [{ type: 'text', text: `${summary}\n\n${JSON.stringify(result, null, 2)}` }] };
+});
 // --- 인증 상태 ---
 server.tool('mimi_seed_auth_start', [
     'Google OAuth 로그인 링크를 발급하고 백그라운드 콜백 서버를 시작.',

package/dist/playstore/tools.d.ts

@@ -62,6 +62,28 @@ export declare function submitRelease(auth: OAuth2Client, packageName: string, t
     committed: boolean;
     result: import("googleapis").androidpublisher_v3.Schema$Track;
 }>;
+export interface PromoteReleaseOptions {
+    status?: 'completed' | 'draft' | 'inProgress' | 'halted';
+    userFraction?: number;
+    releaseName?: string;
+    releaseNotes?: Array<{
+        language: string;
+        text: string;
+    }>;
+    copyReleaseNotes?: boolean;
+}
+export declare function promoteRelease(auth: OAuth2Client, packageName: string, fromTrack: string, toTrack: string, versionCode: string, options?: PromoteReleaseOptions): Promise<{
+    packageName: string;
+    fromTrack: string;
+    toTrack: string;
+    versionCode: string;
+    newStatus: "completed" | "draft" | "inProgress" | "halted";
+    userFraction: number | undefined;
+    releaseName: string | null | undefined;
+    releaseNotesLanguages: (string | null | undefined)[];
+    committed: boolean;
+    result: import("googleapis").androidpublisher_v3.Schema$Track;
+}>;
 export declare function listReviews(auth: OAuth2Client, packageName: string): Promise<{
     reviewId: string | null | undefined;
     authorName: string | null | undefined;

package/dist/playstore/tools.js

@@ -262,6 +262,79 @@ export async function submitRelease(auth, packageName, track, versionCode, statu
         };
     }, true);
 }
+export async function promoteRelease(auth, packageName, fromTrack, toTrack, versionCode, options = {}) {
+    const { status = 'completed', userFraction, releaseName, releaseNotes, copyReleaseNotes = true, } = options;
+    if (fromTrack === toTrack) {
+        throw new Error('fromTrack과 toTrack이 같아. 다른 트랙으로 promote 해야 의미 있어.');
+    }
+    if (status === 'inProgress' && (userFraction == null || userFraction <= 0 || userFraction >= 1)) {
+        throw new Error('status="inProgress"일 때 userFraction은 0과 1 사이 필수 (예: 0.1 → 10%).');
+    }
+    return withEdit(auth, packageName, async (editId) => {
+        // 1. source 트랙에서 versionCode 매칭 release 찾기
+        const fromData = await publisher().edits.tracks.get({
+            auth, packageName, editId, track: fromTrack,
+        });
+        const fromReleases = fromData.data.releases ?? [];
+        const sourceRelease = fromReleases.find((r) => (r.versionCodes ?? []).some((v) => String(v) === String(versionCode)));
+        if (!sourceRelease) {
+            const available = fromReleases.map((r) => ({
+                name: r.name,
+                versionCodes: r.versionCodes,
+                status: r.status,
+            }));
+            throw new Error(`versionCode "${versionCode}"를 ${fromTrack} 트랙에서 찾을 수 없어. 가능한 릴리스: ${JSON.stringify(available)}`);
+        }
+        // 2. 새 release 객체 구성
+        const newRelease = {
+            name: releaseName ?? sourceRelease.name ?? versionCode,
+            versionCodes: [String(versionCode)],
+            status,
+            releaseNotes: releaseNotes ??
+                (copyReleaseNotes ? sourceRelease.releaseNotes ?? [] : []),
+        };
+        if (status === 'inProgress' && userFraction != null) {
+            newRelease.userFraction = userFraction;
+        }
+        // 3. target 트랙 현재 상태 조회 후 merge
+        //    - 같은 versionCode가 이미 target에 있으면 그 항목을 새 release로 교체
+        //    - status='completed'면 활성 release가 1개여야 하므로 [newRelease]로 통째 교체
+        //    - 그 외(draft/inProgress)는 기존 release에 append
+        const toData = await publisher().edits.tracks.get({
+            auth, packageName, editId, track: toTrack,
+        });
+        const toReleases = toData.data.releases ?? [];
+        const existingIdx = toReleases.findIndex((r) => (r.versionCodes ?? []).some((v) => String(v) === String(versionCode)));
+        let mergedReleases;
+        if (existingIdx >= 0) {
+            mergedReleases = [...toReleases];
+            mergedReleases[existingIdx] = newRelease;
+        }
+        else if (status === 'completed') {
+            mergedReleases = [newRelease];
+        }
+        else {
+            mergedReleases = [...toReleases, newRelease];
+        }
+        // 4. target 트랙 업데이트 (commit은 withEdit 마지막에)
+        const updated = await publisher().edits.tracks.update({
+            auth, packageName, editId, track: toTrack,
+            requestBody: { track: toTrack, releases: mergedReleases },
+        });
+        return {
+            packageName,
+            fromTrack,
+            toTrack,
+            versionCode: String(versionCode),
+            newStatus: status,
+            userFraction: status === 'inProgress' ? userFraction : undefined,
+            releaseName: newRelease.name,
+            releaseNotesLanguages: (newRelease.releaseNotes ?? []).map((n) => n.language),
+            committed: true,
+            result: updated.data,
+        };
+    }, true);
+}
 export async function listReviews(auth, packageName) {
     const res = await publisher().reviews.list({ auth, packageName });
     return (res.data.reviews ?? []).map((r) => ({

package/package.json

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