@yoonion/mimi-seed-mcp 0.6.3 → 0.6.4

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/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/package.json

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