npm - @yoonion/mimi-seed-mcp - Versions diffs - 0.3.29 → 0.3.31 - Mend

@yoonion/mimi-seed-mcp 0.3.29 → 0.3.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/dist/auth/google-auth.js +2 -1
package/dist/googleads/config.js +10 -1
package/dist/googleads/tools.js +4 -1
package/dist/helpers.d.ts +17 -2
package/dist/helpers.js +50 -18
package/dist/lib/google-errors.d.ts +10 -0
package/dist/lib/google-errors.js +71 -0
package/dist/playstore/errors.d.ts +1 -0
package/dist/playstore/errors.js +33 -0
package/dist/playstore/tools.js +13 -4
package/dist/registers/admob.js +7 -7
package/dist/registers/checks.js +1 -1
package/dist/registers/firebase.js +43 -18
package/dist/registers/googleads.js +4 -4
package/dist/registers/iam.js +5 -5
package/dist/registers/playstore.js +31 -2
package/package.json +2 -2

package/dist/auth/google-auth.js CHANGED Viewed

@@ -12,6 +12,7 @@ const SCOPES = [
     'https://www.googleapis.com/auth/admob.readonly',
     'https://www.googleapis.com/auth/admob.monetization',
     'https://www.googleapis.com/auth/androidpublisher',
+    'https://www.googleapis.com/auth/adwords', // Google Ads API (googleads_* tools)
 ];
 // Primary config dir. Legacy `~/.preseed` is read as a fallback during the
 // rebrand so existing auth sessions don't force a re-login; new writes go to
@@ -214,7 +215,7 @@ export function startAuth(clientId, clientSecret, options = {}) {
           <html><body style="font-family:system-ui;display:flex;justify-content:center;align-items:center;height:100vh;margin:0">
             <div style="text-align:center">
               <h1>✅ Mimi Seed 인증 완료!</h1>
-              <p>이 창을 닫고 Claude Code 또는 Codex로 돌아가세요.</p>
+              <p>이 창을 닫고 Claude Code 또는 Codex로 돌아가세요.</p>
             </div>
           </body></html>
         `);

package/dist/googleads/config.js CHANGED Viewed

@@ -24,7 +24,16 @@ export function loadConfig() {
     if (!fs.existsSync(CONFIG_PATH))
         return null;
     try {
-        return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+        const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+        // 읽기 시점에도 정규화 — 하이픈 포함 값이 손으로 적히거나 구버전이 쓴 경우에도
+        // URL/login-customer-id 헤더가 항상 숫자만 포함하도록 보장 (write 경로 의존 제거).
+        return {
+            ...cfg,
+            customerId: normalizeCustomerId(cfg.customerId),
+            loginCustomerId: cfg.loginCustomerId
+                ? normalizeCustomerId(cfg.loginCustomerId)
+                : undefined,
+        };
     }
     catch {
         return null;

package/dist/googleads/tools.js CHANGED Viewed

@@ -1,4 +1,7 @@
-const API_VERSION = 'v17';
+// Google Ads API는 ~13개월 주기로 sunset (항상 최신 3개 major만 유지).
+// v24 = 2026-06 기준 현행 major. 새 major 출시 시 갱신 필요.
+// https://developers.google.com/google-ads/api/docs/sunset-dates
+const API_VERSION = 'v24';
 const BASE = `https://googleads.googleapis.com/${API_VERSION}`;
 // ─── 내부 헬퍼 ───────────────────────────────────────────────
 async function getAccessToken(auth) {

package/dist/helpers.d.ts CHANGED Viewed

@@ -1,8 +1,23 @@
 import { ensureFreshAccessToken } from './auth/google-auth.js';
 export { ensureFreshAccessToken };
-export declare function requireAuth(): import("google-auth-library").OAuth2Client;
+/**
+ * OAuth 클라이언트 확보 — 호출 전에 access_token 을 사전 갱신하고,
+ * refresh_token 이 만료/누락이면 raw googleapis 에러(invalid_grant 등) 대신
+ * 친절한 재로그인 안내를 던진다.
+ *
+ * 기존엔 만료 시 각 OAuth 도구(firebase/admob/iam/googleads/checks)가
+ * googleapis GaxiosError 를 그대로 노출 → 사용자는 "재로그인하라"는 안내를 못 받았다.
+ */
+export declare function requireAuth(): Promise<import("google-auth-library").OAuth2Client>;
 export declare const PLAY_AUTH_HINT: string;
 export declare const APPSTORE_AUTH_HINT: string;
-export declare function requirePlayStoreAuth(packageName?: string): import("google-auth-library").JWT;
+/**
+ * Google Play 인증 — 서비스 계정 JSON 우선, 없으면 OAuth 클라이언트로 폴백.
+ *
+ * 로그인(mimi-seed-auth) 시 androidpublisher scope 를 이미 부여받으므로,
+ * 별도 서비스 계정 JSON 을 받지 않아도 대부분의 Play 작업이 가능하다.
+ * (서비스 계정은 서버/헤드리스 — onesub 영수증 검증 등 — 용도로 계속 우선 적용.)
+ */
+export declare function requirePlayStoreAuth(packageName?: string): import("google-auth-library").OAuth2Client;
 export declare function requireServiceAccountJson(packageName?: string): string;
 export declare function requireAppStoreCreds(): import("./appstore/auth.js").AppStoreCredentials;

package/dist/helpers.js CHANGED Viewed

@@ -2,30 +2,52 @@ import { getAuthenticatedClient, ensureFreshAccessToken } from './auth/google-au
 import { getServiceAccountClient, getServiceAccountJson } from './auth/playstore-auth.js';
 import { getAppStoreCredentials } from './appstore/auth.js';
 export { ensureFreshAccessToken };
-export function requireAuth() {
+const REAUTH_CMD = '  npx -y @yoonion/mimi-seed-mcp mimi-seed-auth';
+function formatAuthError(p) {
+    return [
+        `❌ [${p.code}] ${p.message}`,
+        p.hint ? `→ ${p.hint}` : '',
+        '',
+        '터미널에서 재로그인:',
+        REAUTH_CMD,
+    ]
+        .filter((l) => l !== '')
+        .join('\n');
+}
+/**
+ * OAuth 클라이언트 확보 — 호출 전에 access_token 을 사전 갱신하고,
+ * refresh_token 이 만료/누락이면 raw googleapis 에러(invalid_grant 등) 대신
+ * 친절한 재로그인 안내를 던진다.
+ *
+ * 기존엔 만료 시 각 OAuth 도구(firebase/admob/iam/googleads/checks)가
+ * googleapis GaxiosError 를 그대로 노출 → 사용자는 "재로그인하라"는 안내를 못 받았다.
+ */
+export async function requireAuth() {
+    const result = await ensureFreshAccessToken();
+    if (result.status === 'unauthenticated' || result.status === 'expired_refresh_failed') {
+        throw new Error(formatAuthError(result.error));
+    }
     const client = getAuthenticatedClient();
     if (!client) {
-        throw new Error([
-            '❌ Google 계정이 연결되지 않았어.',
-            '',
-            '터미널에서 이것만 실행하면 돼:',
-            '',
-            '  npx -y @yoonion/mimi-seed-mcp mimi-seed-auth',
-            '',
-            '브라우저가 열리면 Google 로그인 → 끝.',
-            '그 다음에 다시 물어봐줘.',
-        ].join('\n'));
+        throw new Error(formatAuthError({
+            code: 'UNAUTHENTICATED',
+            message: 'Google 계정이 연결되지 않았어.',
+            hint: 'mimi-seed-auth 로 로그인하세요.',
+            retriable: false,
+            needsReauth: true,
+        }));
     }
     return client;
 }
 export const PLAY_AUTH_HINT = [
-    '❌ Google Play 서비스 계정이 연결되지 않았어.',
+    '❌ Google Play 인증이 없어.',
     '',
-    '터미널에서 이것만 실행하면 돼:',
+    '가장 쉬운 방법 — Google 로그인 (androidpublisher 권한 포함):',
+    REAUTH_CMD,
     '',
+    '또는 서버/헤드리스 환경이면 서비스 계정 JSON 등록:',
     '  npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth',
     '',
-    '서비스 계정 JSON 파일 경로를 입력하면 저장 완료.',
     '그 다음에 다시 물어봐줘.',
 ].join('\n');
 export const APPSTORE_AUTH_HINT = [
@@ -38,11 +60,21 @@ export const APPSTORE_AUTH_HINT = [
     'Issuer ID, Key ID, .p8 파일 경로를 입력하면 저장 완료.',
     '그 다음에 다시 물어봐줘.',
 ].join('\n');
+/**
+ * Google Play 인증 — 서비스 계정 JSON 우선, 없으면 OAuth 클라이언트로 폴백.
+ *
+ * 로그인(mimi-seed-auth) 시 androidpublisher scope 를 이미 부여받으므로,
+ * 별도 서비스 계정 JSON 을 받지 않아도 대부분의 Play 작업이 가능하다.
+ * (서비스 계정은 서버/헤드리스 — onesub 영수증 검증 등 — 용도로 계속 우선 적용.)
+ */
 export function requirePlayStoreAuth(packageName) {
-    const client = getServiceAccountClient(packageName);
-    if (!client)
-        throw new Error(PLAY_AUTH_HINT);
-    return client;
+    const sa = getServiceAccountClient(packageName);
+    if (sa)
+        return sa;
+    const oauth = getAuthenticatedClient();
+    if (oauth)
+        return oauth;
+    throw new Error(PLAY_AUTH_HINT);
 }
 export function requireServiceAccountJson(packageName) {
     const json = getServiceAccountJson(packageName);

package/dist/lib/google-errors.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+export declare function extractHttpStatus(e: unknown): number | undefined;
+export declare function rawMessage(e: unknown): string;
+/** invalid_grant / 만료 refresh_token / 부족 scope → 재로그인 안내 메시지. 아니면 null. */
+export declare function authReauthMessage(text: string): string | null;
+export declare function withCause(err: Error, cause: unknown): Error;
+/**
+ * Firebase / GCP 에러를 친절 메시지로 변환. 신규 사용자가 가장 자주 만나는
+ * 'API 미활성화 / 프로젝트 없음 / billing / 권한' 케이스에 다음 행동을 붙인다.
+ */
+export declare function friendlyGoogleError(e: unknown): Error;

package/dist/lib/google-errors.js ADDED Viewed

@@ -0,0 +1,71 @@
+// Google API 에러 친절화 (Firebase / Cloud Resource Manager / 공용 OAuth).
+// raw GaxiosError dump 대신 "무엇을 어떻게 고칠지"를 즉시 보여준다.
+// 인식 못 한 에러는 원본을 그대로 보존한다.
+const REAUTH = '터미널에서 재로그인:\n  npx -y @yoonion/mimi-seed-mcp mimi-seed-auth';
+export function extractHttpStatus(e) {
+    if (e && typeof e === 'object') {
+        const any = e;
+        if (typeof any.code === 'number')
+            return any.code;
+        if (typeof any.status === 'number')
+            return any.status;
+        if (any.response && typeof any.response.status === 'number')
+            return any.response.status;
+    }
+    return undefined;
+}
+export function rawMessage(e) {
+    if (e instanceof Error)
+        return e.message;
+    if (typeof e === 'string')
+        return e;
+    try {
+        return JSON.stringify(e);
+    }
+    catch {
+        return String(e);
+    }
+}
+/** invalid_grant / 만료 refresh_token / 부족 scope → 재로그인 안내 메시지. 아니면 null. */
+export function authReauthMessage(text) {
+    if (/invalid_grant|invalid_rapt|rapt_required|unauthorized_client|ACCESS_TOKEN_SCOPE_INSUFFICIENT|insufficient.*scope/i.test(text)) {
+        return ['❌ Google 인증이 만료됐거나 권한이 부족해요.', '', REAUTH].join('\n');
+    }
+    return null;
+}
+function extractActivationUrl(text) {
+    const m = text.match(/https?:\/\/console\.(?:developers|cloud)\.google\.com\/\S+/);
+    return m?.[0]?.replace(/[).,'"]+$/, '');
+}
+export function withCause(err, cause) {
+    err.cause = cause;
+    return err;
+}
+/**
+ * Firebase / GCP 에러를 친절 메시지로 변환. 신규 사용자가 가장 자주 만나는
+ * 'API 미활성화 / 프로젝트 없음 / billing / 권한' 케이스에 다음 행동을 붙인다.
+ */
+export function friendlyGoogleError(e) {
+    const text = rawMessage(e);
+    const status = extractHttpStatus(e);
+    const reauth = authReauthMessage(text);
+    if (reauth)
+        return withCause(new Error(reauth), e);
+    if (/SERVICE_DISABLED|has not been used in project|is disabled|accessNotConfigured/i.test(text)) {
+        const url = extractActivationUrl(text);
+        return withCause(new Error([
+            '❌ 필요한 Google API가 비활성화돼 있어요.',
+            url ? `→ 활성화: ${url}` : '→ Google Cloud Console에서 해당 API를 활성화한 뒤 다시 시도하세요.',
+        ].join('\n')), e);
+    }
+    if (/BILLING_DISABLED|billing.*(disabled|not enabled|required)/i.test(text)) {
+        return withCause(new Error('❌ 결제(billing)가 비활성화된 프로젝트예요.\n→ Google Cloud Console → 결제 에서 결제 계정을 연결하세요.'), e);
+    }
+    if (status === 404 || /NOT_FOUND|not found/i.test(text)) {
+        return withCause(new Error('❌ 프로젝트/리소스를 찾을 수 없어요.\n→ firebase_list_projects 로 유효한 projectId를 확인하세요.'), e);
+    }
+    if (status === 403 || /PERMISSION_DENIED|forbidden|permission/i.test(text)) {
+        return withCause(new Error('❌ 권한 부족 — 이 Google 계정이 해당 프로젝트에 접근 권한이 있는지 확인하세요.'), e);
+    }
+    return e instanceof Error ? e : new Error(text);
+}

package/dist/playstore/errors.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export declare function friendlyPlayError(e: unknown, packageName?: string): Error;

package/dist/playstore/errors.js ADDED Viewed

@@ -0,0 +1,33 @@
+// Google Play (Android Publisher / Developer Reporting) 에러 친절화.
+// App Store 의 friendlyAppStoreError 와 대칭 — Play 쪽엔 없던 친절화 레이어.
+// 신규 사용자가 가장 자주 막히는 두 케이스(서비스 계정 권한 403, edit 세션 충돌)에
+// 구체적 복구 단계를 붙인다. 인식 못 한 에러(도메인 에러 포함)는 원본 보존.
+import { extractHttpStatus, authReauthMessage, withCause } from '../lib/google-errors.js';
+// playstore_verify_service_account 의 403 안내와 동일한 체크리스트.
+const PERMISSION_403 = [
+    '❌ Google Play 권한 부족 (403).',
+    '원인: 인증은 됐지만 Play Console에서 이 계정/서비스 계정에 권한이 없어요.',
+    '',
+    '1. Play Console → 사용자 및 권한(Users and permissions)',
+    '2. 이 Google 계정(또는 서비스 계정 이메일)을 초대 / 권한 부여',
+    '3. 앱 권한에 "앱 정보 관리" (재무 데이터 필요 시 "재무 데이터 보기") 부여',
+    '4. 권한 적용까지 ~5분 대기 후 재시도 (너무 빨리 시도하면 계속 403)',
+].join('\n');
+export function friendlyPlayError(e, packageName) {
+    const text = e instanceof Error ? e.message : String(e);
+    const status = extractHttpStatus(e);
+    const reauth = authReauthMessage(text);
+    if (reauth)
+        return withCause(new Error(reauth), e);
+    if (status === 403 || /PERMISSION_DENIED|insufficient permission|forbidden/i.test(text)) {
+        return withCause(new Error(PERMISSION_403), e);
+    }
+    if (status === 404 || /NOT_FOUND|not found/i.test(text)) {
+        return withCause(new Error(`❌ 패키지${packageName ? ` (${packageName})` : ''}를 이 개발자 계정에서 찾을 수 없어요.\n→ packageName 철자와 계정 권한을 확인하세요.`), e);
+    }
+    if (/This Edit has been deleted|editAlreadyCommitted|edit.*(deleted|expired|not found)/i.test(text)) {
+        return withCause(new Error('❌ Play edit 세션 충돌 — 같은 요청에서 edit 세션을 여러 번 열었을 수 있어요.\n→ 작업을 하나의 withEdit 트랜잭션으로 묶고, 잠시 후 재시도하세요.'), e);
+    }
+    // 인식 못 한 에러(이미 친절한 도메인 에러 포함)는 원본 보존
+    return e instanceof Error ? e : new Error(text);
+}

package/dist/playstore/tools.js CHANGED Viewed

@@ -62,23 +62,32 @@ export async function withEdit(auth, packageName, fn, commit = false) {
 export async function getStatistics(auth, packageName, query) {
     const metricSet = query.metricSet ?? 'anrRate';
     const resource = METRIC_SET_RESOURCE[metricSet];
-    const timeZone = query.timeZone ?? 'America/Los_Angeles';
+    const period = query.aggregationPeriod ?? 'DAILY';
+    // Reporting API는 집계 단위별 지원 timezone이 고정: HOURLY=UTC, DAILY=America/Los_Angeles.
+    // 단일 default를 모든 period에 쓰면 HOURLY가 INVALID_ARGUMENT로 실패한다.
+    const timeZone = query.timeZone ?? (period === 'HOURLY' ? 'UTC' : 'America/Los_Angeles');
+    // errorCountMetricSet은 reportType dimension이 필수 — default에 포함하지 않으면 실패.
+    const dimensions = query.dimensions ??
+        (metricSet === 'errorCount' ? ['reportType', 'versionCode'] : ['versionCode']);
     const url = `${REPORTING_API_BASE}/apps/${encodeURIComponent(packageName)}/${resource}:query`;
     const res = await auth.request({
         url,
         method: 'POST',
         data: {
             timelineSpec: {
-                aggregationPeriod: query.aggregationPeriod ?? 'DAILY',
+                aggregationPeriod: period,
                 startTime: dateToReportingDateTime(query.startDate, timeZone),
                 endTime: dateToReportingDateTime(query.endDate, timeZone),
             },
-            dimensions: query.dimensions ?? ['versionCode'],
+            dimensions,
             metrics: query.metrics ?? DEFAULT_METRICS[metricSet],
             ...(query.filter ? { filter: query.filter } : {}),
             ...(query.pageSize ? { pageSize: query.pageSize } : {}),
             ...(query.pageToken ? { pageToken: query.pageToken } : {}),
-            ...(query.userCohort ? { userCohort: query.userCohort } : {}),
+            // userCohort는 anrRate/crashRate만 지원 (errorCount에 보내면 INVALID_ARGUMENT).
+            ...(query.userCohort && metricSet !== 'errorCount'
+                ? { userCohort: query.userCohort }
+                : {}),
         },
     });
     return res.data;

package/dist/registers/admob.js CHANGED Viewed

@@ -3,22 +3,22 @@ import * as admob from '../admob/tools.js';
 import { requireAuth } from '../helpers.js';
 export function registerAdmobTools(server) {
     server.tool('admob_list_accounts', 'AdMob 계정 목록 조회', {}, async () => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const accounts = await admob.listAccounts(auth);
         return { content: [{ type: 'text', text: JSON.stringify(accounts, null, 2) }] };
     });
     server.tool('admob_list_apps', 'AdMob에 등록된 앱 목록', { accountId: z.string().describe('AdMob 계정 ID (예: accounts/pub-XXXX)') }, async ({ accountId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const apps = await admob.listApps(auth, accountId);
         return { content: [{ type: 'text', text: JSON.stringify(apps, null, 2) }] };
     });
     server.tool('admob_list_ad_units', 'AdMob 광고 단위 목록', { accountId: z.string().describe('AdMob 계정 ID') }, async ({ accountId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const units = await admob.listAdUnits(auth, accountId);
         return { content: [{ type: 'text', text: JSON.stringify(units, null, 2) }] };
     });
     server.tool('admob_get_today_earnings', '오늘 AdMob 수익 요약', { accountId: z.string().describe('AdMob 계정 ID') }, async ({ accountId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const report = await admob.getTodayEarnings(auth, accountId);
         return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }] };
     });
@@ -31,7 +31,7 @@ export function registerAdmobTools(server) {
         endMonth: z.number().describe('종료 월 (1-12)'),
         endDay: z.number().describe('종료 일'),
     }, async ({ accountId, startYear, startMonth, startDay, endYear, endMonth, endDay }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const report = await admob.getNetworkReport(auth, accountId, { year: startYear, month: startMonth, day: startDay }, { year: endYear, month: endMonth, day: endDay });
         return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }] };
     });
@@ -40,7 +40,7 @@ export function registerAdmobTools(server) {
         platform: z.enum(['ANDROID', 'IOS']).describe('플랫폼'),
         displayName: z.string().describe('앱 이름'),
     }, async ({ accountId, platform, displayName }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         try {
             const result = await admob.createApp(auth, accountId, platform, displayName);
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
@@ -71,7 +71,7 @@ export function registerAdmobTools(server) {
         displayName: z.string().describe('광고 단위 이름'),
         adFormat: z.enum(['BANNER', 'INTERSTITIAL', 'REWARDED', 'REWARDED_INTERSTITIAL', 'APP_OPEN', 'NATIVE']).describe('광고 형식'),
     }, async ({ accountId, appId, displayName, adFormat }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         try {
             const result = await admob.createAdUnit(auth, accountId, appId, displayName, adFormat);
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };

package/dist/registers/checks.js CHANGED Viewed

@@ -13,7 +13,7 @@ export function registerChecksTools(server) {
         packageName: z.string().describe('Android 패키지명 (예: com.example.myapp)'),
         language: z.string().optional().describe('언어 코드 (기본: ko-KR)'),
     }, async ({ packageName, language }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const risks = await checkPlayStoreRisks(auth, packageName, language ?? 'ko-KR');
         const text = formatRisks(risks, 'Google Play');
         return { content: [{ type: 'text', text }] };

package/dist/registers/firebase.js CHANGED Viewed

@@ -1,19 +1,44 @@
 import { z } from 'zod';
-import * as firebase from '../firebase/tools.js';
+import * as firebaseRaw from '../firebase/tools.js';
 import { requireAuth } from '../helpers.js';
+import { friendlyGoogleError } from '../lib/google-errors.js';
+// 모든 firebase tools 호출을 친절 에러로 감싸는 프록시 — 17개 핸들러에 개별
+// try/catch 없이 raw GaxiosError(API 미활성화/프로젝트 없음/billing/권한)를
+// "다음에 뭘 할지" 메시지로 변환. 비-Promise 반환은 그대로 통과.
+const firebase = new Proxy(firebaseRaw, {
+    get(target, prop, receiver) {
+        const orig = Reflect.get(target, prop, receiver);
+        if (typeof orig !== 'function')
+            return orig;
+        return (...args) => {
+            try {
+                const out = orig(...args);
+                if (out && typeof out.then === 'function') {
+                    return out.catch((err) => {
+                        throw friendlyGoogleError(err);
+                    });
+                }
+                return out;
+            }
+            catch (err) {
+                throw friendlyGoogleError(err);
+            }
+        };
+    },
+});
 export function registerFirebaseTools(server) {
     server.tool('firebase_list_projects', '내 Firebase 프로젝트 목록 조회', {}, async () => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const projects = await firebase.listProjects(auth);
         return { content: [{ type: 'text', text: JSON.stringify(projects, null, 2) }] };
     });
     server.tool('firebase_get_project', 'Firebase 프로젝트 상세 정보 조회', { projectId: z.string().describe('Firebase 프로젝트 ID') }, async ({ projectId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const project = await firebase.getProject(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(project, null, 2) }] };
     });
     server.tool('firebase_list_android_apps', 'Firebase 프로젝트의 Android 앱 목록', { projectId: z.string().describe('Firebase 프로젝트 ID') }, async ({ projectId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const apps = await firebase.listAndroidApps(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(apps, null, 2) }] };
     });
@@ -22,7 +47,7 @@ export function registerFirebaseTools(server) {
         packageName: z.string().describe('Android 패키지명 (예: com.example.myapp)'),
         displayName: z.string().describe('앱 표시 이름'),
     }, async ({ projectId, packageName, displayName }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const result = await firebase.createAndroidApp(auth, projectId, packageName, displayName);
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
@@ -30,7 +55,7 @@ export function registerFirebaseTools(server) {
         projectId: z.string().describe('Firebase 프로젝트 ID'),
         appId: z.string().describe('Firebase 앱 ID'),
     }, async ({ projectId, appId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const config = await firebase.getAndroidConfig(auth, projectId, appId);
         return { content: [{ type: 'text', text: JSON.stringify(config, null, 2) }] };
     });
@@ -38,12 +63,12 @@ export function registerFirebaseTools(server) {
         projectId: z.string().describe('Firebase 프로젝트 ID'),
         appId: z.string().describe('삭제할 Firebase 앱 ID'),
     }, async ({ projectId, appId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const result = await firebase.deleteAndroidApp(auth, projectId, appId);
         return { content: [{ type: 'text', text: `삭제 완료: ${JSON.stringify(result)}` }] };
     });
     server.tool('firebase_list_ios_apps', 'Firebase 프로젝트의 iOS 앱 목록', { projectId: z.string().describe('Firebase 프로젝트 ID') }, async ({ projectId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const apps = await firebase.listIosApps(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(apps, null, 2) }] };
     });
@@ -52,7 +77,7 @@ export function registerFirebaseTools(server) {
         bundleId: z.string().describe('iOS Bundle ID (예: com.example.myapp)'),
         displayName: z.string().describe('앱 표시 이름'),
     }, async ({ projectId, bundleId, displayName }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const result = await firebase.createIosApp(auth, projectId, bundleId, displayName);
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
@@ -60,7 +85,7 @@ export function registerFirebaseTools(server) {
         projectId: z.string().describe('Firebase 프로젝트 ID'),
         appId: z.string().describe('Firebase 앱 ID'),
     }, async ({ projectId, appId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const config = await firebase.getIosConfig(auth, projectId, appId);
         return { content: [{ type: 'text', text: JSON.stringify(config, null, 2) }] };
     });
@@ -68,12 +93,12 @@ export function registerFirebaseTools(server) {
         projectId: z.string().describe('Firebase 프로젝트 ID'),
         appId: z.string().describe('삭제할 Firebase 앱 ID'),
     }, async ({ projectId, appId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const result = await firebase.deleteIosApp(auth, projectId, appId);
         return { content: [{ type: 'text', text: `삭제 완료: ${JSON.stringify(result)}` }] };
     });
     server.tool('firebase_list_web_apps', 'Firebase 프로젝트의 Web 앱 목록', { projectId: z.string().describe('Firebase 프로젝트 ID') }, async ({ projectId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const apps = await firebase.listWebApps(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(apps, null, 2) }] };
     });
@@ -81,7 +106,7 @@ export function registerFirebaseTools(server) {
         projectId: z.string().describe('Firebase 프로젝트 ID'),
         displayName: z.string().describe('앱 표시 이름'),
     }, async ({ projectId, displayName }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const result = await firebase.createWebApp(auth, projectId, displayName);
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
@@ -89,7 +114,7 @@ export function registerFirebaseTools(server) {
         projectId: z.string().describe('Firebase 프로젝트 ID'),
         appId: z.string().describe('Firebase 앱 ID'),
     }, async ({ projectId, appId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const config = await firebase.getWebConfig(auth, projectId, appId);
         return { content: [{ type: 'text', text: JSON.stringify(config, null, 2) }] };
     });
@@ -97,7 +122,7 @@ export function registerFirebaseTools(server) {
         projectId: z.string().describe('Firebase 프로젝트 ID'),
         appId: z.string().describe('삭제할 Firebase 앱 ID'),
     }, async ({ projectId, appId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const result = await firebase.deleteWebApp(auth, projectId, appId);
         return { content: [{ type: 'text', text: `삭제 완료: ${JSON.stringify(result)}` }] };
     });
@@ -105,17 +130,17 @@ export function registerFirebaseTools(server) {
         projectId: z.string().describe('프로젝트 ID'),
         serviceId: z.string().describe('서비스 ID (예: firestore.googleapis.com)'),
     }, async ({ projectId, serviceId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const result = await firebase.enableService(auth, projectId, serviceId);
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
     server.tool('firebase_enable_common_services', 'Firebase 기본 서비스 일괄 활성화 (Firestore, Auth, Storage, FCM 등)', { projectId: z.string().describe('프로젝트 ID') }, async ({ projectId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const results = await firebase.enableCommonServices(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
     });
     server.tool('firebase_list_enabled_services', '프로젝트에서 활성화된 GCP 서비스 목록', { projectId: z.string().describe('프로젝트 ID') }, async ({ projectId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const services = await firebase.listEnabledServices(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(services, null, 2) }] };
     });

package/dist/registers/googleads.js CHANGED Viewed

@@ -26,7 +26,7 @@ export function registerGoogleAdsTools(server) {
         };
     });
     server.tool('googleads_list_campaigns', 'Google Ads 캠페인 목록 조회 (상태, 채널 타입, 일일 예산 포함)', {}, async () => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const cfg = requireConfig();
         const campaigns = await googleads.listCampaigns(auth, cfg);
         return {
@@ -40,7 +40,7 @@ export function registerGoogleAdsTools(server) {
         startDate: z.string().describe('시작일 (YYYY-MM-DD)'),
         endDate: z.string().describe('종료일 (YYYY-MM-DD)'),
     }, async ({ startDate, endDate }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const cfg = requireConfig();
         const report = await googleads.getCampaignReport(auth, cfg, { startDate, endDate });
         const totalCost = report.reduce((s, r) => s + r.cost, 0);
@@ -68,7 +68,7 @@ export function registerGoogleAdsTools(server) {
         startDate: z.string().describe('시작일 (YYYY-MM-DD)'),
         endDate: z.string().describe('종료일 (YYYY-MM-DD)'),
     }, async ({ startDate, endDate }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const cfg = requireConfig();
         const report = await googleads.getUacReport(auth, cfg, { startDate, endDate });
         const totalCost = report.reduce((s, r) => s + r.cost, 0);
@@ -90,7 +90,7 @@ export function registerGoogleAdsTools(server) {
         };
     });
     server.tool('googleads_list_accessible_customers', 'OAuth 토큰으로 접근 가능한 Google Ads 계정 목록 (API 연결 확인용)', {}, async () => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const cfg = requireConfig();
         const result = await googleads.listAccessibleCustomers(auth, cfg);
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };

package/dist/registers/iam.js CHANGED Viewed

@@ -5,7 +5,7 @@ export function registerIamTools(server) {
     server.tool('iam_list_service_accounts', '주어진 projectId의 서비스 계정 목록. 이메일 / displayName / disabled 상태 반환.', {
         projectId: z.string().describe('Google Cloud 프로젝트 ID'),
     }, async ({ projectId }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const accounts = await iam.listServiceAccounts(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(accounts, null, 2) }] };
     });
@@ -17,7 +17,7 @@ export function registerIamTools(server) {
             .describe('서비스 계정 ID (이메일 로컬 파트)'),
         displayName: z.string().describe('사람이 읽을 표시 이름 (예: "onesub Play verifier")'),
     }, async ({ projectId, accountId, displayName }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const account = await iam.createServiceAccount(auth, projectId, accountId, displayName);
         return {
             content: [
@@ -41,7 +41,7 @@ export function registerIamTools(server) {
     server.tool('iam_list_keys', '주어진 서비스 계정의 기존 키 목록. keyId / keyType / 만료시간 반환. 회수할 키 찾을 때 사용.', {
         serviceAccount: z.string().describe('서비스 계정 이메일'),
     }, async ({ serviceAccount }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const keys = await iam.listServiceAccountKeys(auth, serviceAccount);
         return { content: [{ type: 'text', text: JSON.stringify(keys, null, 2) }] };
     });
@@ -51,7 +51,7 @@ export function registerIamTools(server) {
     ].join(' '), {
         serviceAccount: z.string().describe('서비스 계정 이메일'),
     }, async ({ serviceAccount }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const key = await iam.createServiceAccountKey(auth, serviceAccount);
         return {
             content: [
@@ -89,7 +89,7 @@ export function registerIamTools(server) {
             .describe('권한 받을 주체 (예: serviceAccount:my-sa@my-project.iam.gserviceaccount.com)'),
         role: z.string().describe('IAM 역할 (예: roles/iam.serviceAccountTokenCreator)'),
     }, async ({ projectId, member, role }) => {
-        const auth = requireAuth();
+        const auth = await requireAuth();
         const result = await iam.addProjectIamPolicyBinding(auth, projectId, member, role);
         return {
             content: [

package/dist/registers/playstore.js CHANGED Viewed

@@ -1,10 +1,36 @@
 import { z } from 'zod';
-import * as playstore from '../playstore/tools.js';
+import * as playstoreRaw from '../playstore/tools.js';
+import { friendlyPlayError } from '../playstore/errors.js';
 import { saveServiceAccountJsonForPackage, listRegisteredServiceAccounts, deleteServiceAccountJsonForPackage, } from '../auth/playstore-auth.js';
 import { createGoogleOneTimePurchase, createGoogleSubscription, updateGoogleProduct, deleteGoogleProduct, listGoogleProducts, } from '@onesub/providers';
 import { requirePlayStoreAuth, requireServiceAccountJson } from '../helpers.js';
 import { buildPlayStoreReleasePlan } from '../checks/plan.js';
 import { validatePlayReleaseNotes, formatIssuesForUser } from '../lib/text-validators.js';
+// 모든 playstore tools 호출을 친절 에러로 감싸는 프록시 — 403(권한)/404/edit 충돌/
+// invalid_grant 를 raw dump 대신 구체적 복구 안내로 변환. args[1] 이 packageName 규약.
+// 비-Promise 반환(publisher 등 sync factory)은 그대로 통과, 도메인 에러는 원본 보존.
+const playstore = new Proxy(playstoreRaw, {
+    get(target, prop, receiver) {
+        const orig = Reflect.get(target, prop, receiver);
+        if (typeof orig !== 'function')
+            return orig;
+        return (...args) => {
+            const pkg = typeof args[1] === 'string' ? args[1] : undefined;
+            try {
+                const out = orig(...args);
+                if (out && typeof out.then === 'function') {
+                    return out.catch((err) => {
+                        throw friendlyPlayError(err, pkg);
+                    });
+                }
+                return out;
+            }
+            catch (err) {
+                throw friendlyPlayError(err, pkg);
+            }
+        };
+    },
+});
 export function registerPlaystoreTools(server) {
     server.tool('playstore_get_app', 'Google Play 앱 상세 정보 조회', { packageName: z.string().describe('패키지명 (예: com.findthem.app)') }, async ({ packageName }) => {
         const auth = requirePlayStoreAuth(packageName);
@@ -46,6 +72,9 @@ export function registerPlaystoreTools(server) {
         endDate: z.string().describe('종료일 YYYY-MM-DD (보통 exclusive처럼 다음날 지정 권장)'),
         aggregationPeriod: z.enum(['DAILY', 'HOURLY']).default('DAILY').describe('집계 단위'),
         dimensions: z.array(z.enum([
+            'reportType', // errorCount metricSet 필수
+            'issueId', // errorCount 전용
+            'osBuild', // OS_BETA cohort 전용
             'apiLevel',
             'versionCode',
             'deviceModel',
@@ -64,7 +93,7 @@ export function registerPlaystoreTools(server) {
             'deviceGlEsVersion',
             'deviceScreenSize',
             'deviceScreenDpi',
-        ])).optional().describe('분해 차원. 기본: ["versionCode"]'),
+        ])).optional().describe('분해 차원. 기본: ["versionCode"] (errorCount는 ["reportType","versionCode"]). reportType/issueId는 errorCount 전용, countryCode/deviceBrand는 anrRate/crashRate 전용'),
         metrics: z.array(z.string()).optional().describe('조회 metric. 기본은 metricSet별 핵심 metric + distinctUsers'),
         filter: z.string().optional().describe('AIP-160 필터. 예: versionCode = 42'),
         pageSize: z.number().int().min(1).max(100000).optional().describe('최대 행 수'),

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.3.29",
+  "version": "0.3.31",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {
@@ -37,7 +37,7 @@
   "homepage": "https://mimi-seed.pryzm.gg",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/jeonghwanko/mimi-seed.git",
+    "url": "git+https://github.com/jeonghwanko/mimi-seed-sdk.git",
     "directory": "packages/mcp-server"
   },
   "publishConfig": {