@yoonion/mimi-seed-mcp 0.6.3 → 0.6.5

package/README.md

@@ -66,7 +66,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
-| App Store Connect | 31 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_whats_new` / `appstore_create_version` |
+| App Store Connect | 33 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
 | Google Play | 28 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
 | Firebase | 20 | `firebase_create_project` / `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` |
 | AdMob | 7 | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
@@ -84,7 +84,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 | 인증 | 3 | `mimi_seed_status` / `mimi_seed_auth_start` / `mimi_seed_auth_status` |
 | AI (Claude) | 2 | `generate_release_notes_from_commits` / `generate_review_reply` |
 
-> 인앱 결제(IAP·구독) 도구는 위 Play Store·App Store 카운트에 포함됩니다 — `playstore_create_subscription` · `appstore_create_inapp_purchase` 등 (`@onesub/providers` 위임).
+> 인앱 결제(IAP·구독) 도구는 위 Play Store·App Store 카운트에 포함됩니다 — `appstore_create_inapp_purchase` · `appstore_update_product_review_note` · `appstore_upload_product_review_screenshot` 등.
 > 전체 카탈로그(항상 최신): [`docs/domain/tool-catalog.md`](../../docs/domain/tool-catalog.md)
 
 ---

package/dist/appstore/product-review.d.ts

@@ -0,0 +1,28 @@
+export type AppStoreProductType = 'subscription' | 'consumable' | 'non_consumable';
+/** 기존 IAP/구독 상품의 App Review 노트를 수정한다. */
+export declare function updateProductReviewNote(args: {
+    internalId: string;
+    productType: AppStoreProductType;
+    reviewNote: string;
+}): Promise<{
+    internalId: string;
+    productType: AppStoreProductType;
+    state?: string;
+}>;
+/**
+ * 기존 IAP/구독 상품에 App Review 스크린샷을 reserve → upload → commit 한다.
+ * App Store Connect API는 상품당 심사용 스크린샷 하나를 허용한다.
+ */
+export declare function uploadProductReviewScreenshot(args: {
+    internalId: string;
+    productType: AppStoreProductType;
+    filePath: string;
+}): Promise<{
+    id: string;
+    internalId: string;
+    productType: AppStoreProductType;
+    fileName: string;
+    fileSize: number;
+    state?: string;
+    verified: boolean;
+}>;

package/dist/appstore/product-review.js

@@ -0,0 +1,179 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getAuthHeaders } from './auth.js';
+import { friendlyAppStoreError } from './errors.js';
+const V1_BASE = 'https://api.appstoreconnect.apple.com/v1';
+const V2_BASE = 'https://api.appstoreconnect.apple.com/v2';
+async function authHeadersOrThrow() {
+    const headers = await getAuthHeaders();
+    if (!headers) {
+        throw new Error([
+            '❌ App Store Connect 인증이 필요해.',
+            '',
+            '터미널에서 실행:',
+            '  npx -p @yoonion/mimi-seed-mcp mimi-seed-appstore-auth',
+        ].join('\n'));
+    }
+    return headers;
+}
+async function apiRequest(base, resourcePath, authHeaders, init) {
+    const response = await fetch(`${base}${resourcePath}`, {
+        ...init,
+        headers: { ...authHeaders, ...(init.headers ?? {}) },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw friendlyAppStoreError(response.status, body);
+    }
+    const text = await response.text();
+    return (text ? JSON.parse(text) : { ok: true });
+}
+function productResource(productType) {
+    if (productType === 'subscription') {
+        return { base: V1_BASE, type: 'subscriptions', path: '/subscriptions' };
+    }
+    return { base: V2_BASE, type: 'inAppPurchases', path: '/inAppPurchases' };
+}
+function reviewScreenshotResource(productType) {
+    if (productType === 'subscription') {
+        return {
+            type: 'subscriptionAppStoreReviewScreenshots',
+            path: '/subscriptionAppStoreReviewScreenshots',
+            relationship: 'subscription',
+            relatedType: 'subscriptions',
+        };
+    }
+    return {
+        type: 'inAppPurchaseAppStoreReviewScreenshots',
+        path: '/inAppPurchaseAppStoreReviewScreenshots',
+        relationship: 'inAppPurchaseV2',
+        relatedType: 'inAppPurchases',
+    };
+}
+/** 기존 IAP/구독 상품의 App Review 노트를 수정한다. */
+export async function updateProductReviewNote(args) {
+    const { internalId, productType, reviewNote } = args;
+    const resource = productResource(productType);
+    const authHeaders = await authHeadersOrThrow();
+    const result = await apiRequest(resource.base, `${resource.path}/${internalId}`, authHeaders, {
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            data: {
+                type: resource.type,
+                id: internalId,
+                attributes: { reviewNote },
+            },
+        }),
+    });
+    return { internalId, productType, state: result.data?.attributes?.state };
+}
+async function uploadChunks(buffer, operations) {
+    for (const operation of operations) {
+        const uploadUrl = new URL(operation.url);
+        if (uploadUrl.protocol !== 'https:') {
+            throw new Error(`HTTPS가 아닌 업로드 URL은 거부해: ${uploadUrl.protocol}`);
+        }
+        if (operation.offset < 0 ||
+            operation.length <= 0 ||
+            operation.offset + operation.length > buffer.length) {
+            throw new Error(`잘못된 업로드 청크 범위: offset=${operation.offset}, ` +
+                `length=${operation.length}, fileSize=${buffer.length}`);
+        }
+        const chunk = buffer.subarray(operation.offset, operation.offset + operation.length);
+        const headers = {};
+        for (const header of operation.requestHeaders)
+            headers[header.name] = header.value;
+        const response = await fetch(operation.url, {
+            method: operation.method,
+            headers,
+            body: new Uint8Array(chunk),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`청크 업로드 실패 (offset=${operation.offset}, length=${operation.length}): ` +
+                `${response.status} ${body}`);
+        }
+    }
+}
+/**
+ * 기존 IAP/구독 상품에 App Review 스크린샷을 reserve → upload → commit 한다.
+ * App Store Connect API는 상품당 심사용 스크린샷 하나를 허용한다.
+ */
+export async function uploadProductReviewScreenshot(args) {
+    const { internalId, productType, filePath } = args;
+    if (!path.isAbsolute(filePath)) {
+        throw new Error(`절대 경로가 필요해: ${filePath}`);
+    }
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`파일이 존재하지 않아: ${filePath}`);
+    }
+    const buffer = fs.readFileSync(filePath);
+    const fileName = path.basename(filePath);
+    const fileSize = buffer.length;
+    if (!/\.(png|jpe?g)$/i.test(fileName)) {
+        throw new Error(`PNG/JPG 파일만 업로드할 수 있어: ${fileName}`);
+    }
+    if (fileSize === 0) {
+        throw new Error(`빈 파일은 업로드할 수 없어: ${fileName}`);
+    }
+    const checksum = crypto.createHash('md5').update(buffer).digest('hex');
+    const resource = reviewScreenshotResource(productType);
+    const authHeaders = await authHeadersOrThrow();
+    const reserved = await apiRequest(V1_BASE, resource.path, authHeaders, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            data: {
+                type: resource.type,
+                attributes: { fileName, fileSize },
+                relationships: {
+                    [resource.relationship]: {
+                        data: { type: resource.relatedType, id: internalId },
+                    },
+                },
+            },
+        }),
+    });
+    const screenshotId = reserved.data.id;
+    const operations = reserved.data.attributes?.uploadOperations ?? [];
+    if (operations.length === 0) {
+        await apiRequest(V1_BASE, `${resource.path}/${screenshotId}`, authHeaders, {
+            method: 'DELETE',
+        }).catch(() => undefined);
+        throw new Error('uploadOperations가 비어있음 — Apple API 응답 형식 확인 필요.');
+    }
+    try {
+        await uploadChunks(buffer, operations);
+        await apiRequest(V1_BASE, `${resource.path}/${screenshotId}`, authHeaders, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                data: {
+                    type: resource.type,
+                    id: screenshotId,
+                    attributes: { uploaded: true, sourceFileChecksum: checksum },
+                },
+            }),
+        });
+    }
+    catch (error) {
+        // 완료되지 않은 reservation이 남지 않도록 best-effort 정리.
+        await apiRequest(V1_BASE, `${resource.path}/${screenshotId}`, authHeaders, {
+            method: 'DELETE',
+        }).catch(() => undefined);
+        throw error;
+    }
+    let state;
+    let verified = false;
+    try {
+        const confirmed = await apiRequest(V1_BASE, `${resource.path}/${screenshotId}`, authHeaders, { method: 'GET' });
+        state = confirmed.data.attributes?.assetDeliveryState?.state;
+        verified = true;
+    }
+    catch {
+        // commit 성공 후 확인 GET만 실패하면 재업로드를 유도하지 않는다.
+    }
+    return { id: screenshotId, internalId, productType, fileName, fileSize, state, verified };
+}

package/dist/playstore/tools.d.ts

@@ -25,6 +25,12 @@ export interface PlayStatisticsQuery {
 export declare function withEdit<T>(auth: OAuth2Client | JWT, packageName: string, fn: (editId: string) => Promise<T>, commit?: boolean): Promise<T>;
 export declare function getStatistics(auth: OAuth2Client | JWT, packageName: string, query: PlayStatisticsQuery): Promise<unknown>;
 export declare function getAppDetails(auth: OAuth2Client | JWT, packageName: string): Promise<import("googleapis").androidpublisher_v3.Schema$AppDetails>;
+export declare function updateAppDetails(auth: OAuth2Client | JWT, packageName: string, data: {
+    contactEmail?: string;
+    contactPhone?: string;
+    contactWebsite?: string;
+    defaultLanguage?: string;
+}): Promise<import("googleapis").androidpublisher_v3.Schema$AppDetails>;
 export declare function getListing(auth: OAuth2Client | JWT, packageName: string, language?: string): Promise<import("googleapis").androidpublisher_v3.Schema$Listing>;
 export declare function updateListing(auth: OAuth2Client | JWT, packageName: string, language: string, data: {
     title?: string;

package/dist/playstore/tools.js

@@ -111,6 +111,22 @@ export async function getAppDetails(auth, packageName) {
         return details.data;
     });
 }
+// ─── 앱 세부정보(개발자 연락처·기본 언어) 수정 ───
+//
+// edits.details = 스토어 리스팅(제목·설명)과 별개인 개발자 연락처(이메일/전화/웹사이트)
+// 와 기본 언어. patch 로 부분 갱신 — 넘긴 필드만 교체하고 나머지 연락처는 보존한다
+// (update=PUT 은 전체 치환이라 미지정 필드가 지워질 수 있어 patch 사용). edit → commit.
+export async function updateAppDetails(auth, packageName, data) {
+    return withEdit(auth, packageName, async (editId) => {
+        const updated = await publisher().edits.details.patch({
+            auth,
+            packageName,
+            editId,
+            requestBody: data,
+        });
+        return updated.data;
+    }, true);
+}
 // ─── 스토어 리스팅 조회 ───
 export async function getListing(auth, packageName, language = 'ko-KR') {
     return withEdit(auth, packageName, async (editId) => {

package/dist/registers/appstore.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import * as appstore from '../appstore/tools.js';
 import * as appstoreScreenshots from '../appstore/screenshots.js';
+import * as appstoreProductReview from '../appstore/product-review.js';
 import { createAppleOneTimePurchase, createAppleSubscription, updateAppleProduct, deleteAppleProduct, listAppleProducts, } from '@onesub/providers';
 import { requireAppStoreCreds } from '../helpers.js';
 import { buildAppStoreReleasePlan } from '../checks/plan.js';
@@ -440,6 +441,71 @@ export function registerAppstoreTools(server) {
         });
         return { content: [{ type: 'text', text: JSON.stringify(products, null, 2) }] };
     });
+    server.tool('appstore_update_product_review_note', '기존 App Store IAP/구독 상품의 App Review 노트를 수정. appstore_list_products의 productId/type을 사용.', {
+        appId: z.string().describe('App Store 앱 ID (숫자형, appstore_list_apps 결과)'),
+        productId: z.string().describe('상품 ID (appstore_list_products 결과)'),
+        productType: z.enum(['subscription', 'consumable', 'non_consumable']).describe('상품 유형'),
+        reviewNote: z.string().max(4000).describe('Apple 심사용 노트 (4000자 이하, 빈 문자열은 초기화)'),
+    }, async ({ appId, productId, productType, reviewNote }) => {
+        const creds = requireAppStoreCreds();
+        const products = await listAppleProducts({
+            appId, keyId: creds.keyId, issuerId: creds.issuerId, privateKey: creds.privateKey,
+        });
+        const product = products.find((item) => item.productId === productId && item.type === productType);
+        if (!product) {
+            return { content: [{ type: 'text', text: `상품을 찾을 수 없음: ${productId} (${productType})` }] };
+        }
+        const result = await appstoreProductReview.updateProductReviewNote({
+            internalId: product.internalId,
+            productType,
+            reviewNote,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✓ App Review 노트 수정 완료',
+                        `productId: ${productId}`,
+                        `internalId: ${result.internalId}`,
+                        result.state ? `state: ${result.state}` : '',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('appstore_upload_product_review_screenshot', '기존 App Store IAP/구독 상품의 심사용 스크린샷을 reserve → upload → commit. 상품당 1장, 절대 파일 경로 필요.', {
+        appId: z.string().describe('App Store 앱 ID (숫자형, appstore_list_apps 결과)'),
+        productId: z.string().describe('상품 ID (appstore_list_products 결과)'),
+        productType: z.enum(['subscription', 'consumable', 'non_consumable']).describe('상품 유형'),
+        filePath: z.string().describe('업로드할 PNG/JPG의 절대 파일 경로'),
+    }, async ({ appId, productId, productType, filePath }) => {
+        const creds = requireAppStoreCreds();
+        const products = await listAppleProducts({
+            appId, keyId: creds.keyId, issuerId: creds.issuerId, privateKey: creds.privateKey,
+        });
+        const product = products.find((item) => item.productId === productId && item.type === productType);
+        if (!product) {
+            return { content: [{ type: 'text', text: `상품을 찾을 수 없음: ${productId} (${productType})` }] };
+        }
+        const result = await appstoreProductReview.uploadProductReviewScreenshot({
+            internalId: product.internalId,
+            productType,
+            filePath,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✓ App Review 스크린샷 업로드 완료',
+                        `productId: ${productId}`,
+                        `internalId: ${result.internalId}`,
+                        `screenshotId: ${result.id}`,
+                        `file: ${result.fileName} (${result.fileSize} bytes)`,
+                        result.state ? `state: ${result.state}` : '',
+                        result.verified ? '✓ commit 후 조회 확인' : '⚠ commit은 성공했지만 후속 조회는 확인하지 못함',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
     server.tool('appstore_update_product', 'App Store IAP 상품의 reference name 변경. productId / 유형은 변경 불가.', {
         appId: z.string().optional().describe('App Store 앱 ID'),
         bundleId: z.string().optional().describe('번들 ID (appId 대신 사용 가능)'),

package/dist/registers/playstore.js

@@ -33,11 +33,24 @@ const playstore = new Proxy(playstoreRaw, {
     },
 });
 export function registerPlaystoreTools(server) {
-    server.tool('playstore_get_app', 'Google Play 앱 상세 정보 조회', { packageName: z.string().describe('패키지명 (예: com.findthem.app)') }, async ({ packageName }) => {
+    server.tool('playstore_get_app', 'Google Play 앱 세부정보 조회 — 개발자 연락처(이메일·전화·웹사이트)·기본 언어 등 (edits.details). 수정은 playstore_update_details.', { packageName: z.string().describe('패키지명 (예: com.findthem.app)') }, async ({ packageName }) => {
         const auth = requirePlayStoreAuth(packageName);
         const details = await playstore.getAppDetails(auth, packageName);
         return { content: [{ type: 'text', text: JSON.stringify(details, null, 2) }] };
     });
+    server.tool('playstore_update_details', 'Google Play 앱 세부정보(개발자 연락처·기본 언어) 수정 — 연락처 이메일/전화/웹사이트, 기본 언어. 스토어 리스팅(제목·설명)과는 별개이며, 넘긴 필드만 부분 갱신(edits.details.patch). ⚠️ Console 에서 같은 앱을 편집·미게시 중이면 충돌할 수 있음.', {
+        packageName: z.string().describe('패키지명 (예: gg.pryzm.penguinrun)'),
+        contactEmail: z.string().optional().describe('개발자 연락처 이메일 (스토어 등록정보에 공개)'),
+        contactPhone: z.string().optional().describe('개발자 연락처 전화번호 (선택)'),
+        contactWebsite: z.string().optional().describe('개발자 웹사이트 URL (예: https://penguin.pryzm.gg)'),
+        defaultLanguage: z.string().optional().describe('기본 언어 코드 (예: ko-KR, en-US)'),
+    }, async ({ packageName, contactEmail, contactPhone, contactWebsite, defaultLanguage }) => {
+        const auth = requirePlayStoreAuth(packageName);
+        const result = await playstore.updateAppDetails(auth, packageName, {
+            contactEmail, contactPhone, contactWebsite, defaultLanguage,
+        });
+        return { content: [{ type: 'text', text: `수정 완료:\n${JSON.stringify(result, null, 2)}` }] };
+    });
     server.tool('playstore_get_listing', 'Google Play 스토어 리스팅 조회 (제목, 설명문 등)', {
         packageName: z.string().describe('패키지명'),
         language: z.string().default('ko-KR').describe('언어 코드 (기본: ko-KR)'),

package/package.json

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