@yoonion/mimi-seed-mcp 0.3.39 → 0.4.0

package/dist/admob/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/admob/cli.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// mimi-seed-admob — AdMob sub-CLI (계정/앱/광고단위 조회 + v1beta 생성).
+// 사용자 진입점은 `mimi-seed admob <subcommand>`.
+// ⚠️ create-* 는 AdMob v1beta(Limited Access)라 계정 allowlist 미승인 시 403 → 콘솔 수동 폴백.
+import { requireAuth } from '../helpers.js';
+import * as admob from './tools.js';
+import { runDomainCli, requireFlag, flag, CliUsageError } from '../lib/cli-args.js';
+const HELP = `
+  💰 mimi-seed-admob — AdMob attach
+
+  사용법:
+    mimi-seed admob accounts
+        AdMob 계정 목록 (accountId 확인 — accounts/pub-XXXX)
+
+    mimi-seed admob apps --account <id>
+    mimi-seed admob ad-units --account <id>
+        등록된 앱 / 광고 단위 목록
+
+    mimi-seed admob create-app --account <id> --platform <ANDROID|IOS> --name <displayName>
+                               [--store-id com.x.y | 123456789]
+        앱 등록 (store-id 주면 스토어 링크). ⚠️ v1beta Limited Access — 403 가능
+
+    mimi-seed admob create-ad-unit --account <id> --app <appId> --name <name>
+                                   --format <BANNER|INTERSTITIAL|REWARDED|REWARDED_INTERSTITIAL|APP_OPEN|NATIVE>
+        광고 단위 생성. ⚠️ v1beta Limited Access — 403 가능
+
+  인증: npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
+`;
+const AD_FORMATS = ['BANNER', 'INTERSTITIAL', 'REWARDED', 'REWARDED_INTERSTITIAL', 'APP_OPEN', 'NATIVE'];
+runDomainCli({
+    binName: 'mimi-seed-admob',
+    argv: process.argv.slice(2),
+    help: HELP,
+    handlers: {
+        accounts: async () => admob.listAccounts(await requireAuth()),
+        apps: async (p) => admob.listApps(await requireAuth(), requireFlag(p, 'account')),
+        'ad-units': async (p) => admob.listAdUnits(await requireAuth(), requireFlag(p, 'account')),
+        'create-app': async (p) => {
+            const platform = requireFlag(p, 'platform').toUpperCase();
+            if (platform !== 'ANDROID' && platform !== 'IOS') {
+                throw new CliUsageError('--platform 은 ANDROID | IOS 여야 합니다.');
+            }
+            return admob.createApp(await requireAuth(), requireFlag(p, 'account'), platform, requireFlag(p, 'name'), flag(p, 'store-id'));
+        },
+        'create-ad-unit': async (p) => {
+            const format = requireFlag(p, 'format').toUpperCase();
+            if (!AD_FORMATS.includes(format)) {
+                throw new CliUsageError(`--format 은 ${AD_FORMATS.join(' | ')} 중 하나여야 합니다.`);
+            }
+            return admob.createAdUnit(await requireAuth(), requireFlag(p, 'account'), requireFlag(p, 'app'), requireFlag(p, 'name'), format);
+        },
+    },
+});

package/dist/admob/tools.d.ts

@@ -35,5 +35,15 @@ export declare function getNetworkReport(auth: OAuth2Client, accountId: string,
     day: number;
 }): Promise<import("googleapis").admob_v1.Schema$GenerateNetworkReportResponse>;
 export declare function getTodayEarnings(auth: OAuth2Client, accountId: string): Promise<import("googleapis").admob_v1.Schema$GenerateNetworkReportResponse>;
-export declare function createApp(auth: OAuth2Client, accountId: string, platform: 'ANDROID' | 'IOS', displayName: string): Promise<any>;
-export declare function createAdUnit(auth: OAuth2Client, accountId: string, appId: string, displayName: string, adFormat: 'BANNER' | 'INTERSTITIAL' | 'REWARDED' | 'REWARDED_INTERSTITIAL' | 'APP_OPEN' | 'NATIVE'): Promise<any>;
+export type AdFormat = 'BANNER' | 'INTERSTITIAL' | 'REWARDED' | 'REWARDED_INTERSTITIAL' | 'APP_OPEN' | 'NATIVE';
+/**
+ * adFormat → adTypes 파생 (순수 함수 — 테스트 대상).
+ * AdMob v1beta adTypes 의 유효값은 'RICH_MEDIA'(텍스트·이미지 등 비동영상)와 'VIDEO' 둘뿐
+ * (Schema$AdUnit.adTypes 문서). 동영상 지원 포맷은 VIDEO 를 포함하고,
+ * REWARDED_INTERSTITIAL 은 문서상 video-only 다.
+ */
+export declare function adTypesForFormat(adFormat: AdFormat): string[];
+export declare function createApp(auth: OAuth2Client, accountId: string, platform: 'ANDROID' | 'IOS', displayName: string, 
+/** 스토어에 게시된 앱이면 store ID 로 링크 (Android=패키지명, iOS=App Store 숫자 ID). 없으면 manual(unlinked) 앱. */
+appStoreId?: string): Promise<any>;
+export declare function createAdUnit(auth: OAuth2Client, accountId: string, appId: string, displayName: string, adFormat: AdFormat): Promise<any>;

package/dist/admob/tools.js

@@ -91,17 +91,42 @@ export async function getTodayEarnings(auth, accountId) {
     const today = { year: now.getFullYear(), month: now.getMonth() + 1, day: now.getDate() };
     return getNetworkReport(auth, accountId, today, today);
 }
-// ─── v1beta: 앱 생성 (Limited Access) ───
-export async function createApp(auth, accountId, platform, displayName) {
+/**
+ * adFormat → adTypes 파생 (순수 함수 — 테스트 대상).
+ * AdMob v1beta adTypes 의 유효값은 'RICH_MEDIA'(텍스트·이미지 등 비동영상)와 'VIDEO' 둘뿐
+ * (Schema$AdUnit.adTypes 문서). 동영상 지원 포맷은 VIDEO 를 포함하고,
+ * REWARDED_INTERSTITIAL 은 문서상 video-only 다.
+ */
+export function adTypesForFormat(adFormat) {
+    switch (adFormat) {
+        case 'INTERSTITIAL':
+        case 'REWARDED':
+        case 'APP_OPEN':
+            return ['RICH_MEDIA', 'VIDEO'];
+        case 'REWARDED_INTERSTITIAL':
+            return ['VIDEO'];
+        case 'BANNER':
+        case 'NATIVE':
+        default:
+            return ['RICH_MEDIA'];
+    }
+}
+export async function createApp(auth, accountId, platform, displayName, 
+/** 스토어에 게시된 앱이면 store ID 로 링크 (Android=패키지명, iOS=App Store 숫자 ID). 없으면 manual(unlinked) 앱. */
+appStoreId) {
     // v1beta — 대부분 계정에서 403. Google Account Manager 승인 필요.
     const admobBeta = google.admob('v1beta');
+    const requestBody = { platform };
+    // manualAppInfo.displayName 은 writable(사용자 제공, AdMob UI 표시명) — linking 후에도 유지된다.
+    // linkedAppInfo.displayName 은 output-only(스토어 표시명)라 보내도 무시되므로, store 링크엔 appStoreId 만 넣는다.
+    requestBody.manualAppInfo = { displayName };
+    if (appStoreId) {
+        requestBody.linkedAppInfo = { appStoreId };
+    }
     const res = await admobBeta.accounts.apps.create({
         auth,
         parent: accountId,
-        requestBody: {
-            platform,
-            manualAppInfo: { displayName },
-        },
+        requestBody,
     });
     return res.data;
 }
@@ -115,7 +140,7 @@ export async function createAdUnit(auth, accountId, appId, displayName, adFormat
             appId,
             displayName,
             adFormat,
-            adTypes: ['DISPLAY'],
+            adTypes: adTypesForFormat(adFormat),
         },
     });
     return res.data;

package/dist/auth/errors.d.ts

@@ -1,4 +1,4 @@
-export type AuthErrorCode = 'UNAUTHENTICATED' | 'NO_REFRESH_TOKEN' | 'INVALID_GRANT' | 'RAPT_REQUIRED' | 'INVALID_CLIENT' | 'UNAUTHORIZED_CLIENT' | 'REFRESH_NETWORK_ERROR' | 'REFRESH_UNKNOWN' | 'CALLBACK_PORT_IN_USE' | 'CALLBACK_TIMEOUT' | 'BROWSER_OPEN_FAILED' | 'USER_DENIED' | 'CODE_EXCHANGE_FAILED' | 'TOKEN_RESPONSE_INVALID';
+export type AuthErrorCode = 'UNAUTHENTICATED' | 'NO_REFRESH_TOKEN' | 'INVALID_GRANT' | 'RAPT_REQUIRED' | 'INVALID_CLIENT' | 'UNAUTHORIZED_CLIENT' | 'REFRESH_NETWORK_ERROR' | 'REFRESH_UNKNOWN' | 'INSUFFICIENT_SCOPE' | 'CALLBACK_PORT_IN_USE' | 'CALLBACK_TIMEOUT' | 'BROWSER_OPEN_FAILED' | 'USER_DENIED' | 'CODE_EXCHANGE_FAILED' | 'TOKEN_RESPONSE_INVALID';
 export interface AuthErrorPayload {
     code: AuthErrorCode;
     message: string;

package/dist/auth/google-auth.d.ts

@@ -4,6 +4,8 @@ export interface StoredTokens {
     refresh_token: string;
     token_type: string;
     expiry_date: number;
+    /** 공백 구분 부여 스코프. 신규 도구(GA4 등) pre-flight 스코프 검사에 사용. 구 토큰은 undefined. */
+    scope?: string;
 }
 export declare function getStoredCredentials(): {
     clientId: string;

package/dist/auth/google-auth.js

@@ -14,6 +14,7 @@ const SCOPES = [
     'https://www.googleapis.com/auth/androidpublisher',
     'https://www.googleapis.com/auth/adwords', // Google Ads API (googleads_* tools)
     'https://www.googleapis.com/auth/webmasters', // Search Console API (gsc_* tools, 사이트맵 제출 포함)
+    'https://www.googleapis.com/auth/analytics.edit', // GA4 Analytics Admin API (ga4_* tools — property/data stream 생성·조회)
 ];
 // 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
@@ -112,6 +113,7 @@ export function getAuthenticatedClient() {
                 ...(newTokens.access_token && { access_token: newTokens.access_token }),
                 ...(newTokens.refresh_token && { refresh_token: newTokens.refresh_token }),
                 ...(newTokens.expiry_date && { expiry_date: newTokens.expiry_date }),
+                ...(newTokens.scope && { scope: newTokens.scope }),
             });
         }
     });
@@ -209,6 +211,7 @@ export function startAuth(clientId, clientSecret, options = {}) {
                     refresh_token: tokens.refresh_token,
                     token_type: tokens.token_type ?? 'Bearer',
                     expiry_date: tokens.expiry_date ?? Date.now() + 3600_000,
+                    ...(tokens.scope && { scope: tokens.scope }),
                 };
                 saveTokens(stored);
                 res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
@@ -327,6 +330,8 @@ export async function ensureFreshAccessToken(marginMs = 300_000) {
             refresh_token: credentials.refresh_token ?? tokens.refresh_token,
             token_type: credentials.token_type ?? tokens.token_type ?? 'Bearer',
             expiry_date: credentials.expiry_date ?? Date.now() + 3600_000,
+            // refresh 응답은 scope 를 생략할 수 있으므로 기존 값을 보존(blank 방지).
+            scope: credentials.scope ?? tokens.scope,
         };
         saveTokens(refreshed);
         return {

package/dist/firebase/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/firebase/cli.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// mimi-seed-firebase — Firebase 프로비저닝 sub-CLI (프로젝트/앱 조회·생성, config 다운로드, GA4 링크).
+// 사용자 진입점은 `mimi-seed firebase <subcommand>`.
+import { requireAuth } from '../helpers.js';
+import * as firebase from './tools.js';
+import { runDomainCli, requireFlag, flag, CliUsageError } from '../lib/cli-args.js';
+const FB_PLATFORMS = ['android', 'ios', 'web'];
+const HELP = `
+  🔥 mimi-seed-firebase — Firebase attach (프로비저닝 + config 산출)
+
+  사용법:
+    mimi-seed firebase projects
+        내 Firebase 프로젝트 목록
+
+    mimi-seed firebase apps --project <id> [--platform android|ios|web]
+        프로젝트의 앱 목록 (기본: android+ios+web 전부)
+
+    mimi-seed firebase create-android --project <id> --package com.x.y --name <displayName>
+    mimi-seed firebase create-ios     --project <id> --bundle com.x.y  --name <displayName>
+        새 앱 등록
+
+    mimi-seed firebase config --project <id> --app <appId> --platform <android|ios|web>
+        ⭐ google-services.json / GoogleService-Info.plist / web config 출력 (attach 페이로드)
+
+    mimi-seed firebase enable-services --project <id>
+        Firebase 기본 서비스 일괄 활성화 (Analytics 포함)
+
+    mimi-seed firebase link-analytics --project <id> (--account <gaAccountId> | --property <gaPropertyId>)
+        GA4 링크 (앱 measurement 자동 활성화) — account(신규 property 생성) 또는 property(기존 연결) 중 하나 필수
+
+    mimi-seed firebase analytics-details --project <id>
+        GA4 링크 상세 (property + stream 매핑)
+
+  인증: npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
+`;
+async function listApps(projectId, platform) {
+    const auth = await requireAuth();
+    // platform 이 지정됐는데 알 수 없는 값이면 조용히 'all' 로 떨어지지 않고 명시적으로 거부.
+    if (platform !== undefined && !FB_PLATFORMS.includes(platform)) {
+        throw new CliUsageError('--platform 은 android | ios | web 중 하나여야 합니다.');
+    }
+    if (platform === 'android')
+        return firebase.listAndroidApps(auth, projectId);
+    if (platform === 'ios')
+        return firebase.listIosApps(auth, projectId);
+    if (platform === 'web')
+        return firebase.listWebApps(auth, projectId);
+    const [android, ios, web] = await Promise.all([
+        firebase.listAndroidApps(auth, projectId),
+        firebase.listIosApps(auth, projectId),
+        firebase.listWebApps(auth, projectId),
+    ]);
+    return { android, ios, web };
+}
+async function getConfig(projectId, appId, platform) {
+    const auth = await requireAuth();
+    if (platform === 'android')
+        return firebase.getAndroidConfig(auth, projectId, appId);
+    if (platform === 'ios')
+        return firebase.getIosConfig(auth, projectId, appId);
+    if (platform === 'web')
+        return firebase.getWebConfig(auth, projectId, appId);
+    throw new CliUsageError('--platform 은 android | ios | web 중 하나여야 합니다.');
+}
+runDomainCli({
+    binName: 'mimi-seed-firebase',
+    argv: process.argv.slice(2),
+    help: HELP,
+    handlers: {
+        projects: async () => firebase.listProjects(await requireAuth()),
+        apps: async (p) => listApps(requireFlag(p, 'project'), flag(p, 'platform')?.toLowerCase()),
+        'create-android': async (p) => firebase.createAndroidApp(await requireAuth(), requireFlag(p, 'project'), requireFlag(p, 'package'), requireFlag(p, 'name')),
+        'create-ios': async (p) => firebase.createIosApp(await requireAuth(), requireFlag(p, 'project'), requireFlag(p, 'bundle'), requireFlag(p, 'name')),
+        config: async (p) => getConfig(requireFlag(p, 'project'), requireFlag(p, 'app'), requireFlag(p, 'platform').toLowerCase()),
+        'enable-services': async (p) => firebase.enableCommonServices(await requireAuth(), requireFlag(p, 'project')),
+        'link-analytics': async (p) => firebase.linkAnalytics(await requireAuth(), requireFlag(p, 'project'), {
+            analyticsAccountId: flag(p, 'account'),
+            analyticsPropertyId: flag(p, 'property'),
+        }),
+        'analytics-details': async (p) => firebase.getAnalyticsDetails(await requireAuth(), requireFlag(p, 'project')),
+    },
+});

package/dist/firebase/tools.d.ts

@@ -49,6 +49,20 @@ export declare function listEnabledServices(auth: OAuth2Client, projectId: strin
     name: string | null | undefined;
     title: string | null | undefined;
 }[]>;
+/**
+ * Firebase 프로젝트에 Google Analytics(GA4)를 링크한다.
+ * - analyticsAccountId: 그 GA 계정 하위에 GA4 property 를 새로 만들어 링크.
+ * - analyticsPropertyId: 기존 GA4 property 에 링크.
+ * 둘 중 정확히 하나는 필수다(addGoogleAnalytics API 계약 — 무인자 모드 없음).
+ * 앱별 data stream(android/ios measurement)은 링크 후 Firebase 가 자동 생성한다.
+ * (반환값은 long-running Operation — 완료까지 수 초 소요될 수 있음.)
+ */
+export declare function linkAnalytics(auth: OAuth2Client, projectId: string, opts?: {
+    analyticsAccountId?: string;
+    analyticsPropertyId?: string;
+}): Promise<import("googleapis").firebase_v1beta1.Schema$Operation>;
+/** 프로젝트의 GA4 링크 상세 — 연결된 analyticsProperty + 앱↔stream 매핑 조회. */
+export declare function getAnalyticsDetails(auth: OAuth2Client, projectId: string): Promise<import("googleapis").firebase_v1beta1.Schema$AnalyticsDetails>;
 export declare function enableCommonServices(auth: OAuth2Client, projectId: string): Promise<({
     service: string;
     status: string;

package/dist/firebase/tools.js

@@ -158,6 +158,39 @@ export async function listEnabledServices(auth, projectId) {
         title: s.config?.title,
     }));
 }
+// ─── Google Analytics(GA4) 링크 ───
+/**
+ * Firebase 프로젝트에 Google Analytics(GA4)를 링크한다.
+ * - analyticsAccountId: 그 GA 계정 하위에 GA4 property 를 새로 만들어 링크.
+ * - analyticsPropertyId: 기존 GA4 property 에 링크.
+ * 둘 중 정확히 하나는 필수다(addGoogleAnalytics API 계약 — 무인자 모드 없음).
+ * 앱별 data stream(android/ios measurement)은 링크 후 Firebase 가 자동 생성한다.
+ * (반환값은 long-running Operation — 완료까지 수 초 소요될 수 있음.)
+ */
+export async function linkAnalytics(auth, projectId, opts = {}) {
+    const requestBody = {};
+    if (opts.analyticsAccountId)
+        requestBody.analyticsAccountId = opts.analyticsAccountId;
+    if (opts.analyticsPropertyId)
+        requestBody.analyticsPropertyId = opts.analyticsPropertyId;
+    if (!requestBody.analyticsAccountId && !requestBody.analyticsPropertyId) {
+        throw new Error('GA4 링크엔 analyticsAccountId(신규 property 생성) 또는 analyticsPropertyId(기존 property 연결) 중 하나가 필요합니다.');
+    }
+    const res = await google.firebase('v1beta1').projects.addGoogleAnalytics({
+        auth,
+        parent: `projects/${projectId}`,
+        requestBody,
+    });
+    return res.data;
+}
+/** 프로젝트의 GA4 링크 상세 — 연결된 analyticsProperty + 앱↔stream 매핑 조회. */
+export async function getAnalyticsDetails(auth, projectId) {
+    const res = await google.firebase('v1beta1').projects.getAnalyticsDetails({
+        auth,
+        name: `projects/${projectId}/analyticsDetails`,
+    });
+    return res.data;
+}
 // ─── 편의 함수 ───
 const COMMON_SERVICES = [
     'firebase.googleapis.com',
@@ -167,6 +200,7 @@ const COMMON_SERVICES = [
     'fcm.googleapis.com',
     'identitytoolkit.googleapis.com',
     'cloudresourcemanager.googleapis.com',
+    'firebaseanalytics.googleapis.com', // GA4(Firebase Analytics) — linkAnalytics 전에 활성화
 ];
 export async function enableCommonServices(auth, projectId) {
     const results = [];

package/dist/ga4/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/ga4/cli.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+// mimi-seed-ga4 — GA4 Analytics Admin/Data API sub-CLI.
+// 사용자 진입점은 `mimi-seed ga4 <subcommand>` (cli 패키지가 npx 로 이 bin 을 호출).
+import { requireAuth } from '../helpers.js';
+import * as ga4 from './tools.js';
+import { runDomainCli, requireFlag, flag, flagList } from '../lib/cli-args.js';
+const HELP = `
+  📊 mimi-seed-ga4 — GA4(Google Analytics 4) attach
+
+  사용법:
+    mimi-seed ga4 accounts
+        접근 가능한 GA 계정 + property 요약 (accountId/propertyId 확인)
+
+    mimi-seed ga4 properties --account <id>
+        계정 하위 GA4 property 목록
+
+    mimi-seed ga4 create-property --account <id> --name <displayName>
+                                  [--timezone Asia/Seoul] [--currency KRW]
+        새 GA4 property 생성
+
+    mimi-seed ga4 create-stream --property <id> --platform <web|android|ios> --name <name>
+                                [--uri https://...] [--package com.x.y] [--bundle com.x.y]
+        data stream 생성 (web→measurementId, app→firebaseAppId)
+
+    mimi-seed ga4 streams --property <id>
+        data stream 목록
+
+    mimi-seed ga4 report --property <id> --start 28daysAgo --end today
+                         [--dimensions date,country] [--metrics activeUsers,eventCount]
+        GA4 Data API 리포트
+
+  ⚠️ analytics.edit 스코프 필요 — 처음이면 재로그인:
+     npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
+`;
+runDomainCli({
+    binName: 'mimi-seed-ga4',
+    argv: process.argv.slice(2),
+    help: HELP,
+    handlers: {
+        accounts: async () => ga4.listAccountSummaries(await requireAuth(ga4.GA4_SCOPE)),
+        properties: async (p) => ga4.listProperties(await requireAuth(ga4.GA4_SCOPE), requireFlag(p, 'account')),
+        'create-property': async (p) => ga4.createProperty(await requireAuth(ga4.GA4_SCOPE), {
+            accountId: requireFlag(p, 'account'),
+            displayName: requireFlag(p, 'name'),
+            timeZone: flag(p, 'timezone'),
+            currencyCode: flag(p, 'currency'),
+        }),
+        'create-stream': async (p) => ga4.createDataStream(await requireAuth(ga4.GA4_SCOPE), requireFlag(p, 'property'), {
+            platform: requireFlag(p, 'platform'),
+            displayName: requireFlag(p, 'name'),
+            defaultUri: flag(p, 'uri'),
+            packageName: flag(p, 'package'),
+            bundleId: flag(p, 'bundle'),
+        }),
+        streams: async (p) => ga4.listDataStreams(await requireAuth(ga4.GA4_SCOPE), requireFlag(p, 'property')),
+        report: async (p) => ga4.runReport(await requireAuth(ga4.GA4_SCOPE), requireFlag(p, 'property'), {
+            startDate: requireFlag(p, 'start'),
+            endDate: requireFlag(p, 'end'),
+            dimensions: flagList(p, 'dimensions'),
+            metrics: flagList(p, 'metrics'),
+        }),
+    },
+});

package/dist/ga4/tools.d.ts

@@ -0,0 +1,107 @@
+import type { OAuth2Client } from 'google-auth-library';
+/** GA4 도구가 요구하는 OAuth 스코프 — requireAuth() pre-flight 검사에 사용. */
+export declare const GA4_SCOPE = "https://www.googleapis.com/auth/analytics.edit";
+export type Ga4Auth = OAuth2Client;
+export type DataStreamPlatform = 'web' | 'android' | 'ios';
+/** '123' | 'accounts/123' → 'accounts/123' */
+export declare function normalizeAccountName(accountId: string): string;
+/** '123' | 'properties/123' → 'properties/123' */
+export declare function normalizePropertyName(propertyId: string): string;
+/**
+ * dataStreams.create 응답에서 클라이언트가 실제로 필요로 하는 식별자를 평탄화한다.
+ * - web stream → measurementId (G-XXXX, gtag/web 연동용)
+ * - app stream → firebaseAppId (Firebase 앱과 자동 링크된 경우)
+ */
+export declare function flattenDataStream(d: {
+    name?: string | null;
+    type?: string | null;
+    displayName?: string | null;
+    webStreamData?: {
+        measurementId?: string | null;
+        defaultUri?: string | null;
+    } | null;
+    androidAppStreamData?: {
+        firebaseAppId?: string | null;
+        packageName?: string | null;
+    } | null;
+    iosAppStreamData?: {
+        firebaseAppId?: string | null;
+        bundleId?: string | null;
+    } | null;
+}): {
+    name: string | null;
+    type: string | null;
+    displayName: string | null;
+    measurementId: string | null;
+    firebaseAppId: string | null;
+};
+/** data stream 생성 요청 본문 조립 (순수 함수 — 테스트 대상). */
+export declare function buildDataStreamBody(opts: {
+    platform: DataStreamPlatform;
+    displayName: string;
+    defaultUri?: string;
+    packageName?: string;
+    bundleId?: string;
+}): {
+    type: string;
+    displayName: string;
+    webStreamData: {
+        defaultUri: string | undefined;
+    };
+    androidAppStreamData?: undefined;
+    iosAppStreamData?: undefined;
+} | {
+    type: string;
+    displayName: string;
+    androidAppStreamData: {
+        packageName: string | undefined;
+    };
+    webStreamData?: undefined;
+    iosAppStreamData?: undefined;
+} | {
+    type: string;
+    displayName: string;
+    iosAppStreamData: {
+        bundleId: string | undefined;
+    };
+    webStreamData?: undefined;
+    androidAppStreamData?: undefined;
+};
+/** 접근 가능한 GA 계정 + 각 계정의 property 요약. accountId/propertyId 를 찾는 시작점. */
+export declare function listAccountSummaries(auth: Ga4Auth): Promise<import("googleapis").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaAccountSummary[]>;
+/** 계정 하위 GA4 property 목록. accountId: '123' 또는 'accounts/123'. */
+export declare function listProperties(auth: Ga4Auth, accountId: string): Promise<import("googleapis").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaProperty[]>;
+export declare function createProperty(auth: Ga4Auth, opts: {
+    accountId: string;
+    displayName: string;
+    timeZone?: string;
+    currencyCode?: string;
+}): Promise<import("googleapis").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaProperty>;
+export declare function createDataStream(auth: Ga4Auth, propertyId: string, opts: {
+    platform: DataStreamPlatform;
+    displayName: string;
+    defaultUri?: string;
+    packageName?: string;
+    bundleId?: string;
+}): Promise<{
+    raw: import("googleapis").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaDataStream;
+    name: string | null;
+    type: string | null;
+    displayName: string | null;
+    measurementId: string | null;
+    firebaseAppId: string | null;
+}>;
+export declare function listDataStreams(auth: Ga4Auth, propertyId: string): Promise<{
+    name: string | null;
+    type: string | null;
+    displayName: string | null;
+    measurementId: string | null;
+    firebaseAppId: string | null;
+}[]>;
+export interface RunReportParams {
+    startDate: string;
+    endDate: string;
+    dimensions?: string[];
+    metrics?: string[];
+}
+export declare function runReport(auth: Ga4Auth, propertyId: string, params: RunReportParams): Promise<import("googleapis").analyticsdata_v1beta.Schema$RunReportResponse>;

package/dist/ga4/tools.js

@@ -0,0 +1,119 @@
+import { google } from 'googleapis';
+/**
+ * Google Analytics 4 — Admin API(v1beta) + Data API(v1beta) 래퍼.
+ *
+ * Admin API 로 GA4 property/data stream 을 직접 생성·조회한다. Firebase Analytics 를
+ * enable 하면 GA4 property 가 자동 생성되지만, 그 경로는 property 이름/타임존/통화나
+ * web data stream(measurement ID, G-XXXX) 을 제어할 수 없다. 풀 컨트롤이 필요하면 이 모듈을 쓴다.
+ *
+ * 인증은 mimi-seed OAuth 클라이언트(`requireAuth()`)를 그대로 사용 — `analytics.edit` 스코프 필요.
+ * (스코프 추가 후 기존 사용자는 1회 재로그인: `npx -y @yoonion/mimi-seed-mcp mimi-seed-auth`)
+ */
+const admin = () => google.analyticsadmin('v1beta');
+const data = () => google.analyticsdata('v1beta');
+/** GA4 도구가 요구하는 OAuth 스코프 — requireAuth() pre-flight 검사에 사용. */
+export const GA4_SCOPE = 'https://www.googleapis.com/auth/analytics.edit';
+// ─── 경로 정규화 (순수 함수 — 테스트 대상) ───
+/** '123' | 'accounts/123' → 'accounts/123' */
+export function normalizeAccountName(accountId) {
+    const id = accountId.trim();
+    return id.startsWith('accounts/') ? id : `accounts/${id}`;
+}
+/** '123' | 'properties/123' → 'properties/123' */
+export function normalizePropertyName(propertyId) {
+    const id = propertyId.trim();
+    return id.startsWith('properties/') ? id : `properties/${id}`;
+}
+/**
+ * dataStreams.create 응답에서 클라이언트가 실제로 필요로 하는 식별자를 평탄화한다.
+ * - web stream → measurementId (G-XXXX, gtag/web 연동용)
+ * - app stream → firebaseAppId (Firebase 앱과 자동 링크된 경우)
+ */
+export function flattenDataStream(d) {
+    return {
+        name: d.name ?? null,
+        type: d.type ?? null,
+        displayName: d.displayName ?? null,
+        measurementId: d.webStreamData?.measurementId ?? null,
+        firebaseAppId: d.androidAppStreamData?.firebaseAppId ?? d.iosAppStreamData?.firebaseAppId ?? null,
+    };
+}
+/** data stream 생성 요청 본문 조립 (순수 함수 — 테스트 대상). */
+export function buildDataStreamBody(opts) {
+    switch (opts.platform) {
+        case 'web':
+            return {
+                type: 'WEB_DATA_STREAM',
+                displayName: opts.displayName,
+                webStreamData: { defaultUri: opts.defaultUri },
+            };
+        case 'android':
+            return {
+                type: 'ANDROID_APP_DATA_STREAM',
+                displayName: opts.displayName,
+                androidAppStreamData: { packageName: opts.packageName },
+            };
+        case 'ios':
+            return {
+                type: 'IOS_APP_DATA_STREAM',
+                displayName: opts.displayName,
+                iosAppStreamData: { bundleId: opts.bundleId },
+            };
+    }
+}
+// ─── 계정/속성 디스커버리 ───
+/** 접근 가능한 GA 계정 + 각 계정의 property 요약. accountId/propertyId 를 찾는 시작점. */
+export async function listAccountSummaries(auth) {
+    const res = await admin().accountSummaries.list({ auth, pageSize: 200 });
+    return res.data.accountSummaries ?? [];
+}
+/** 계정 하위 GA4 property 목록. accountId: '123' 또는 'accounts/123'. */
+export async function listProperties(auth, accountId) {
+    const res = await admin().properties.list({
+        auth,
+        filter: `parent:${normalizeAccountName(accountId)}`,
+        pageSize: 200,
+    });
+    return res.data.properties ?? [];
+}
+// ─── property / data stream 생성 (attach 핵심) ───
+export async function createProperty(auth, opts) {
+    const res = await admin().properties.create({
+        auth,
+        requestBody: {
+            parent: normalizeAccountName(opts.accountId),
+            displayName: opts.displayName,
+            timeZone: opts.timeZone ?? 'America/Los_Angeles',
+            currencyCode: opts.currencyCode ?? 'USD',
+        },
+    });
+    return res.data; // { name: 'properties/XXXX', displayName, ... }
+}
+export async function createDataStream(auth, propertyId, opts) {
+    const res = await admin().properties.dataStreams.create({
+        auth,
+        parent: normalizePropertyName(propertyId),
+        requestBody: buildDataStreamBody(opts),
+    });
+    return { ...flattenDataStream(res.data), raw: res.data };
+}
+export async function listDataStreams(auth, propertyId) {
+    const res = await admin().properties.dataStreams.list({
+        auth,
+        parent: normalizePropertyName(propertyId),
+        pageSize: 200,
+    });
+    return (res.data.dataStreams ?? []).map((d) => flattenDataStream(d));
+}
+export async function runReport(auth, propertyId, params) {
+    const res = await data().properties.runReport({
+        auth,
+        property: normalizePropertyName(propertyId),
+        requestBody: {
+            dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
+            dimensions: (params.dimensions ?? []).map((name) => ({ name })),
+            metrics: (params.metrics ?? ['activeUsers', 'eventCount']).map((name) => ({ name })),
+        },
+    });
+    return res.data;
+}

package/dist/helpers.d.ts

@@ -8,7 +8,7 @@ export { ensureFreshAccessToken };
  * 기존엔 만료 시 각 OAuth 도구(firebase/admob/iam/googleads/checks)가
  * googleapis GaxiosError 를 그대로 노출 → 사용자는 "재로그인하라"는 안내를 못 받았다.
  */
-export declare function requireAuth(): Promise<import("google-auth-library").OAuth2Client>;
+export declare function requireAuth(requiredScope?: string): Promise<import("google-auth-library").OAuth2Client>;
 export declare const PLAY_AUTH_HINT: string;
 export declare const APPSTORE_AUTH_HINT: string;
 /**