@mpgd/cli 0.67.0 → 0.68.0

package/dist/asc-session.d.ts

@@ -19,8 +19,12 @@ export declare const ascListTimeoutMs: number;
 export declare const ascUploadTimeoutMs: number;
 /** asc exit code for an App Store Connect 404 (`cmd/exit_codes.go`, 5.5.0). */
 export declare const ascExitNotFound = 4;
-/** Copy and verify the pinned binary into a private directory; `close` removes it. */
-export declare function openAscSession(credential: AscCredential, signal?: AbortSignal): Promise<{
+/**
+* Copy and verify the pinned binary into a private directory; `close` removes
+* it. `extraSecretValues` are redacted from asc output like the API key (for
+* example a TestFlight review demo account password).
+*/
+export declare function openAscSession(credential: AscCredential, signal?: AbortSignal, extraSecretValues?: readonly string[]): Promise<{
   readonly run: AscCommandRunner;
   close(): void;
 }>;

package/dist/asc-session.js

@@ -9,8 +9,12 @@ export const ascUploadTimeoutMs = 10 * 60_000;
 const maxJsonBytes = 8 * 1024 * 1024;
 /** asc exit code for an App Store Connect 404 (`cmd/exit_codes.go`, 5.5.0). */
 export const ascExitNotFound = 4;
-/** Copy and verify the pinned binary into a private directory; `close` removes it. */
-export async function openAscSession(credential, signal) {
+/**
+ * Copy and verify the pinned binary into a private directory; `close` removes
+ * it. `extraSecretValues` are redacted from asc output like the API key (for
+ * example a TestFlight review demo account password).
+ */
+export async function openAscSession(credential, signal, extraSecretValues = []) {
     if (!path.isAbsolute(credential.ascBinary)) {
         throw new Error('asc binary must be an absolute file path.');
     }
@@ -30,7 +34,12 @@ export async function openAscSession(credential, signal) {
                 timeoutMs,
                 maxOutputBytes: maxJsonBytes,
                 captureMachineStdout: true,
-                secretValues: [credential.apiKeyId, credential.apiIssuerId, credential.apiPrivateKeyBase64],
+                secretValues: [
+                    credential.apiKeyId,
+                    credential.apiIssuerId,
+                    credential.apiPrivateKeyBase64,
+                    ...extraSecretValues.filter((value) => value !== ''),
+                ],
                 signal,
             });
             if (result.truncated || result.machineStdout === undefined) {

package/dist/index.d.ts

@@ -17,11 +17,16 @@ export { StorePlanStaleError } from './store-sync.js';
 export { applyStorePresence, planStorePresence, saveStorePresencePlan, type StorePresenceApplyOptions, type StorePresencePlanFile, type StorePresencePlanOptions, type StorePresencePorts, type StorePresenceStore, } from './store-presence-command.js';
 export { applyPlayPresence, formatPlayPresencePlan, planPlayPresence, PlayPresenceApplyError, type PlannedPlayImageSlot, type PlannedPlayLanguage, type PlayPresenceApplyResult, type PlayPresencePlan, type PlayPresencePlanInput, } from './store-presence-play.js';
 export { applyAppStorePresence, AppStorePresenceApplyError, formatAppStorePresencePlan, planAppStorePresence, type AppStorePresenceApplyResult, type AppStorePresencePlan, type AppStorePresencePlanInput, type PlannedAppStoreLocale, type PlannedAscScreenshotSet, } from './store-presence-app-store.js';
+export { applyAppStoreReleaseCommand, changeAppStorePhasedReleaseCommand, planAppStoreReleaseCommand, publishAppStoreVersionCommand, readAppStoreReleaseStatusCommand, saveAppStoreReleasePlan, type AppStoreReleaseApplyOptions, type AppStoreReleaseCommandPorts, type AppStoreReleasePlanFile, type AppStoreReleasePlanOptions, type AppStoreReleaseVersionOptions, type ReleaseTypeOption, } from './app-store-release-command.js';
+export { applyAppStoreRelease, AppStoreReleaseApplyError, changeAppStorePhasedRelease, formatAppStoreReleasePlan, planAppStoreRelease, publishAppStoreVersion, readAppStoreReleaseStatus, type AppStoreReleaseApplyResult, type AppStoreReleasePlan, type AppStoreReleasePlanInput, type AppStoreReleaseRequest, type AppStoreReleaseStatus, type PhasedReleaseAction, } from './app-store-release.js';
+export type { AscReleasePort } from './app-store-release-port.js';
 export type { AscAppInfo, AscAppInfoLocalization, AscAppStoreVersion, AscScreenshot, AscScreenshotSet, AscStorePresencePort, AscVersionLocalization, AscVersionLocalizationFields, } from './app-store-presence-port.js';
 export type { PlayAppDetails, PlayImage, PlayImageType, PlayListing, PlayStoreListingPort, } from './play-listing-port.js';
 export { PlayPromoteUncertainError, promotePlayRelease, type PlayPromoteInput, type PlayPromoteResult, } from './play-release-promote.js';
 export { PlayRolloutUncertainError, changePlayRollout, type PlayRolloutAction, type PlayRolloutInput, type PlayRolloutResult, } from './play-release-rollout.js';
 export { IosSubmissionUncertainError, submitVerifiedIosBuild, type IosTestFlightStatus, type IosTestFlightSubmissionInput, type IosTestFlightSubmissionResult, } from './testflight-submission.js';
+export { applyTestFlightDistribution, planTestFlightDistribution, readTestFlightBuildStatus, type TestFlightBetaReviewInput, type TestFlightBetaReviewStatus, type TestFlightBuildTarget, type TestFlightDistributionReport, type TestFlightDistributionRequest, type TestFlightStatusReport, } from './testflight-distribution.js';
+export type { TestFlightDistributionPort } from './testflight-distribution-port.js';
 export { createBrowserGameplayE2EDriver, type BrowserGameplayE2EInspectInput, type BrowserGameplayE2EPage, type BrowserGameplayE2EScreenshotOptions, type BrowserGameplayE2EViewport, type CreateBrowserGameplayE2EDriverInput, } from './browser-gameplay-e2e.js';
 export { collectGameplayE2EPathEvidence, defaultGameplayE2EReportFile, maximumGameplayE2EStates, parseGameplayE2EPlan, readGameplayE2EPlan, renderGameplayE2EMarkdown, resolveGameplayE2EReportFile, runGameplayE2E, type GameplayE2EAction, type GameplayE2EActionResult, type GameplayE2EDriver, type GameplayE2EHashLimits, type GameplayE2EInputAction, type GameplayE2EObservation, type GameplayE2EPauseResumeAction, type GameplayE2EPathEvidence, type GameplayE2EPlan, type GameplayE2EReport, type GameplayE2EResultStatus, type GameplayE2EState, type GameplayE2EStateResult, type GameplayE2EStatus, type RunGameplayE2EInput, type RunGameplayE2EResult, } from './gameplay-e2e.js';
 export { cloudflarePagesDeploymentProfiles, hostedPwaDeploymentHosts, isSupportedHostedPwaProfile, verifyHostedPwaDeployment, type CloudflarePagesDeploymentProfile, type HostedPwaDeploymentHost, type HostedPwaDeploymentVerification, type VerifyHostedPwaDeploymentInput, } from './hosted-pwa-deployment.js';

package/dist/index.js

@@ -33,7 +33,9 @@ import { runMicrosoftStoreSubmissionPreflight } from './microsoft-store-submissi
 import { defaultOfflinePlaytestArtifactDir, defaultOfflinePlaytestMaximumBytes, defaultOfflinePlaytestOutputDir, runOfflinePlaytestPackaging, } from './offline-playtest.js';
 import { targetConfigExtensionsFileEnv, targetConfigMatrixFileEnv } from './target-config-env.js';
 import { readStoreCredential, runNativeDeployment } from './native-deploy-run.js';
-import { isNativeDeployApproved, planRecordedAndroidSubmission, submitRecordedNativeTarget, } from './native-deploy-submission.js';
+import { isNativeDeployApproved, planRecordedAndroidSubmission, readRecordedIosBuild, submitRecordedNativeTarget, } from './native-deploy-submission.js';
+import { applyTestFlightDistribution, parseTestFlightGroups, planTestFlightDistribution, readTestFlightBetaReviewFile, readTestFlightBuildStatus, readTestFlightWhatToTestFile, } from './testflight-distribution.js';
+import { openAscTestFlightDistributionSession } from './testflight-distribution-asc.js';
 import { createPlayReleaseRequest, parsePlayUserFraction, readPlayReleaseNotesFile, } from './play-release-options.js';
 import { promotePlayRelease } from './play-release-promote.js';
 import { applyStoreProducts, planStoreProducts, saveStoreProductPlan, } from './store-products-command.js';
@@ -42,6 +44,8 @@ import { formatPlayProductPlan } from './store-products-play.js';
 import { applyStorePresence, planStorePresence, saveStorePresencePlan, } from './store-presence-command.js';
 import { formatPlayPresencePlan } from './store-presence-play.js';
 import { formatAppStorePresencePlan } from './store-presence-app-store.js';
+import { applyAppStoreReleaseCommand, changeAppStorePhasedReleaseCommand, planAppStoreReleaseCommand, publishAppStoreVersionCommand, readAppStoreReleaseStatusCommand, saveAppStoreReleasePlan, } from './app-store-release-command.js';
+import { formatAppStoreReleasePlan } from './app-store-release.js';
 import { changePlayRollout } from './play-release-rollout.js';
 import { readNativeReleaseStatus as readNativeReleaseStatusForCli } from './release-state.js';
 import { uploadRecordedCrashSymbols } from './crash-symbols-upload.js';
@@ -64,9 +68,12 @@ export { StorePlanStaleError } from './store-sync.js';
 export { applyStorePresence, planStorePresence, saveStorePresencePlan, } from './store-presence-command.js';
 export { applyPlayPresence, formatPlayPresencePlan, planPlayPresence, PlayPresenceApplyError, } from './store-presence-play.js';
 export { applyAppStorePresence, AppStorePresenceApplyError, formatAppStorePresencePlan, planAppStorePresence, } from './store-presence-app-store.js';
+export { applyAppStoreReleaseCommand, changeAppStorePhasedReleaseCommand, planAppStoreReleaseCommand, publishAppStoreVersionCommand, readAppStoreReleaseStatusCommand, saveAppStoreReleasePlan, } from './app-store-release-command.js';
+export { applyAppStoreRelease, AppStoreReleaseApplyError, changeAppStorePhasedRelease, formatAppStoreReleasePlan, planAppStoreRelease, publishAppStoreVersion, readAppStoreReleaseStatus, } from './app-store-release.js';
 export { PlayPromoteUncertainError, promotePlayRelease, } from './play-release-promote.js';
 export { PlayRolloutUncertainError, changePlayRollout, } from './play-release-rollout.js';
 export { IosSubmissionUncertainError, submitVerifiedIosBuild, } from './testflight-submission.js';
+export { applyTestFlightDistribution, planTestFlightDistribution, readTestFlightBuildStatus, } from './testflight-distribution.js';
 export { createBrowserGameplayE2EDriver, } from './browser-gameplay-e2e.js';
 export { collectGameplayE2EPathEvidence, defaultGameplayE2EReportFile, maximumGameplayE2EStates, parseGameplayE2EPlan, readGameplayE2EPlan, renderGameplayE2EMarkdown, resolveGameplayE2EReportFile, runGameplayE2E, } from './gameplay-e2e.js';
 export { cloudflarePagesDeploymentProfiles, hostedPwaDeploymentHosts, isSupportedHostedPwaProfile, verifyHostedPwaDeployment, } from './hosted-pwa-deployment.js';
@@ -675,6 +682,92 @@ const deployCommand = defineI18n({
                 console.info(JSON.stringify(result, null, 2));
             },
         }),
+        testflight: defineI18n({
+            name: 'testflight',
+            description: 'Distribute a submitted iOS build to more TestFlight groups and read its App Review state.',
+            resource: commandResource({
+                en: 'Distribute a submitted iOS build to more TestFlight groups and read its App Review state.',
+                ko: '제출한 iOS 빌드를 다른 TestFlight 그룹에 배포하고 앱 심사 상태를 조회합니다.',
+            }),
+            subCommands: {
+                distribute: defineI18n({
+                    name: 'distribute',
+                    description: 'Add the build to TestFlight groups, set What to Test and submit external groups for TestFlight App Review.',
+                    resource: commandResource({
+                        en: 'Add the build to TestFlight groups, set What to Test and submit external groups for TestFlight App Review.',
+                        ko: '빌드를 TestFlight 그룹에 추가하고 테스트 내용을 설정하며, 외부 그룹이면 TestFlight 앱 심사에 제출합니다.',
+                    }),
+                    args: {
+                        plan: { type: 'string', required: true, description: 'Saved deployment plan JSON (bundle ID and credential).' },
+                        game: { type: 'string', required: false, description: 'Current game directory if the plan moved.' },
+                        'game-id': { type: 'string', required: true, description: 'Explicit release ledger game ID.' },
+                        release: { type: 'string', required: true, description: 'Explicit release ID whose recorded iOS build is distributed.' },
+                        groups: {
+                            type: 'string', required: true,
+                            description: 'Comma-separated TestFlight group IDs or exact names; external groups need TestFlight App Review.',
+                        },
+                        'what-to-test': {
+                            type: 'string', required: false,
+                            description: 'What to Test file, <en-US>…</en-US> blocks or JSON (the --release-notes format); required for a first external group.',
+                        },
+                        'beta-review': {
+                            type: 'string', required: false,
+                            description: 'TestFlight review details JSON: contact, notes and a demo account by environment variable names.',
+                        },
+                        approve: { type: 'boolean', required: false, description: 'Approve the group changes and the review submission.' },
+                        'dry-run': { type: 'boolean', required: false, description: 'Read App Store Connect and print the planned changes; write nothing.' },
+                    },
+                    run: async (ctx) => {
+                        const dryRun = ctx.values['dry-run'] === true;
+                        if (!dryRun && ctx.values.approve !== true) {
+                            throw new Error('TestFlight distribution requires --approve (or --dry-run to preview it).');
+                        }
+                        const groups = parseTestFlightGroups(readRequiredCliOption(ctx.values.groups, '--groups'));
+                        const whatToTestFile = readOptionalString(ctx.values['what-to-test']);
+                        const betaReviewFile = readOptionalString(ctx.values['beta-review']);
+                        const betaReview = betaReviewFile === undefined
+                            ? undefined
+                            : readTestFlightBetaReviewFile(betaReviewFile, process.env, { requireValues: !dryRun });
+                        const context = await readTestFlightCliContext(ctx.values);
+                        const request = {
+                            ...context.target,
+                            groups,
+                            ...(whatToTestFile === undefined ? {} : { whatToTest: readTestFlightWhatToTestFile(whatToTestFile) }),
+                            ...(betaReview === undefined ? {} : { betaReview }),
+                        };
+                        const secrets = betaReview?.demoAccount?.password === undefined ? [] : [betaReview.demoAccount.password];
+                        const result = await withTestFlightCliPort(context.credential, secrets, (port) => dryRun
+                            ? planTestFlightDistribution(port, request)
+                            : applyTestFlightDistribution(port, request));
+                        console.info(JSON.stringify(result, null, 2));
+                        if (!dryRun && (result.betaReview.status === 'action-required'
+                            || result.betaReview.status === 'rejected')) {
+                            throw new Error(`TestFlight distribution needs action in App Store Connect (${result.betaReview.status}): `
+                                + (result.detail ?? 'see App Review > TestFlight.'));
+                        }
+                    },
+                }),
+                status: defineI18n({
+                    name: 'status',
+                    description: "Read the build's TestFlight groups and App Review state; never writes.",
+                    resource: commandResource({
+                        en: "Read the build's TestFlight groups and App Review state; never writes.",
+                        ko: '빌드의 TestFlight 그룹과 앱 심사 상태를 조회합니다. 쓰지 않습니다.',
+                    }),
+                    args: {
+                        plan: { type: 'string', required: true, description: 'Saved deployment plan JSON (bundle ID and credential).' },
+                        game: { type: 'string', required: false, description: 'Current game directory if the plan moved.' },
+                        'game-id': { type: 'string', required: true, description: 'Explicit release ledger game ID.' },
+                        release: { type: 'string', required: true, description: 'Explicit release ID whose recorded iOS build is read.' },
+                    },
+                    run: async (ctx) => {
+                        const { target, credential } = await readTestFlightCliContext(ctx.values);
+                        const result = await withTestFlightCliPort(credential, [], (port) => readTestFlightBuildStatus(port, target));
+                        console.info(JSON.stringify(result, null, 2));
+                    },
+                }),
+            },
+        }),
         run: defineI18n({
             name: 'run',
             description: 'Reserve, build, verify and submit native internal-test releases.',
@@ -906,9 +999,167 @@ const storeCommand = defineI18n({
                 }),
             },
         }),
+        release: defineI18n({
+            name: 'release',
+            description: 'App Store: prepare an iOS version, submit it for review, and release it.',
+            resource: commandResource({
+                en: 'App Store: prepare an iOS version, submit it for review, and release it.',
+                ko: 'App Store: iOS 버전을 준비해 심사에 제출하고 출시합니다.',
+            }),
+            subCommands: {
+                plan: defineI18n({
+                    name: 'plan',
+                    description: 'Read App Store Connect and print the release plan; never writes to the store.',
+                    resource: commandResource({
+                        en: 'Read App Store Connect and print the release plan; never writes to the store.',
+                        ko: 'App Store Connect를 읽고 출시 계획을 출력합니다. 스토어에 쓰지 않습니다.',
+                    }),
+                    args: {
+                        game: { type: 'string', required: false, description: 'Game project directory.' },
+                        profile: { type: 'string', required: false, description: 'Deployment profile naming the app and credential; defaults to beta.' },
+                        presence: { type: 'string', required: false, description: 'Store presence file path, relative to the current directory; defaults to mpgd.store-presence.json in the game.' },
+                        'marketing-version': { type: 'string', required: false, description: 'Marketing version to submit, for example 1.0.1.' },
+                        'build-number': { type: 'string', required: false, description: 'Build number to submit; defaults to the newest build of the version.' },
+                        'game-id': { type: 'string', required: false, description: 'Release ledger game ID of the build deploy run recorded (with --release).' },
+                        release: { type: 'string', required: false, description: 'Release ID of the build deploy run recorded (with --game-id).' },
+                        'release-type': { type: 'string', required: false, description: 'manual (default), after-approval or scheduled.' },
+                        'release-date': { type: 'string', required: false, description: 'Earliest release date for scheduled, ISO 8601 with time and offset.' },
+                        'phased-release': { type: 'boolean', required: false, description: 'Release over 7 days (phased release); off by default.' },
+                        'skip-iap': { type: 'string', required: false, description: 'Comma-separated in-app purchase product IDs to leave out of this submission.' },
+                        'rotate-demo-password': { type: 'boolean', required: false, description: 'Send the demo account password again even when App Store Connect has one.' },
+                        out: { type: 'string', required: false, description: 'New plan JSON path for apply; existing files are not overwritten.' },
+                    },
+                    run: async (ctx) => {
+                        const optional = (key) => readOptionalString(ctx.values[key]);
+                        const skipIaps = optional('skip-iap')?.split(',').map((entry) => entry.trim()).filter((entry) => entry !== '');
+                        const presence = optional('presence');
+                        const version = optional('marketing-version');
+                        const buildNumber = optional('build-number');
+                        const gameId = optional('game-id');
+                        const release = optional('release');
+                        const releaseType = optional('release-type');
+                        const releaseDate = optional('release-date');
+                        const result = await planAppStoreReleaseCommand({
+                            game: optional('game') ?? '.',
+                            profile: optional('profile') ?? 'beta',
+                            ...(presence === undefined ? {} : { presenceFile: presence }),
+                            ...(version === undefined ? {} : { version }),
+                            ...(buildNumber === undefined ? {} : { buildNumber }),
+                            ...(gameId === undefined ? {} : { gameId }),
+                            ...(release === undefined ? {} : { release }),
+                            ...(releaseType === undefined ? {} : { releaseType: releaseType }),
+                            ...(releaseDate === undefined ? {} : { releaseDate }),
+                            ...(ctx.values['phased-release'] === true ? { phasedRelease: true } : {}),
+                            ...(skipIaps === undefined ? {} : { skipIaps }),
+                            ...(ctx.values['rotate-demo-password'] === true ? { rotateDemoPassword: true } : {}),
+                        });
+                        console.info(formatAppStoreReleasePlan(result.plan));
+                        const out = optional('out');
+                        if (out !== undefined) {
+                            console.info(`Wrote store release plan: ${saveAppStoreReleasePlan(out, result)}`);
+                        }
+                    },
+                }),
+                apply: defineI18n({
+                    name: 'apply',
+                    description: 'Perform the reviewed release plan; refuses when App Store Connect or the files changed since.',
+                    resource: commandResource({
+                        en: 'Perform the reviewed release plan; refuses when App Store Connect or the files changed since.',
+                        ko: '검토한 출시 계획을 수행합니다. 이후 App Store Connect나 파일이 바뀌었으면 거부합니다.',
+                    }),
+                    args: {
+                        plan: { type: 'string', required: true, description: 'Plan JSON written by "store release plan --out".' },
+                        game: { type: 'string', required: false, description: 'Current game directory if the game moved.' },
+                        approve: { type: 'boolean', required: false, description: 'Approve the App Store Connect writes and the review submission.' },
+                        'dry-run': { type: 'boolean', required: false, description: 'Re-check the plan against App Store Connect and print the writes; write nothing.' },
+                    },
+                    run: async (ctx) => {
+                        const game = readOptionalString(ctx.values.game);
+                        const result = await applyAppStoreReleaseCommand({
+                            planFile: readRequiredCliOption(ctx.values.plan, '--plan'),
+                            ...(game === undefined ? {} : { game }),
+                            approved: ctx.values.approve === true,
+                            ...(ctx.values['dry-run'] === true ? { dryRun: true } : {}),
+                        });
+                        console.info(JSON.stringify(result, null, 2));
+                    },
+                }),
+                status: defineI18n({
+                    name: 'status',
+                    description: 'Report where the iOS version and its review submission stand; reads only.',
+                    resource: commandResource({
+                        en: 'Report where the iOS version and its review submission stand; reads only.',
+                        ko: 'iOS 버전과 심사 제출 상태를 보고합니다. 읽기만 합니다.',
+                    }),
+                    args: {
+                        game: { type: 'string', required: false, description: 'Game project directory.' },
+                        profile: { type: 'string', required: false, description: 'Deployment profile naming the app and credential; defaults to beta.' },
+                        'marketing-version': { type: 'string', required: false, description: 'Marketing version; defaults to the newest iOS version.' },
+                    },
+                    run: async (ctx) => {
+                        const version = readOptionalString(ctx.values['marketing-version']);
+                        const result = await readAppStoreReleaseStatusCommand({
+                            game: readOptionalString(ctx.values.game) ?? '.',
+                            profile: readOptionalString(ctx.values.profile) ?? 'beta',
+                            ...(version === undefined ? {} : { version }),
+                        });
+                        console.info(result.summary);
+                        console.info(JSON.stringify(result, null, 2));
+                    },
+                }),
+                publish: defineI18n({
+                    name: 'publish',
+                    description: 'Release an approved version that waits for a manual release.',
+                    resource: commandResource({
+                        en: 'Release an approved version that waits for a manual release.',
+                        ko: '수동 출시를 기다리는 승인된 버전을 출시합니다.',
+                    }),
+                    args: {
+                        game: { type: 'string', required: false, description: 'Game project directory.' },
+                        profile: { type: 'string', required: false, description: 'Deployment profile naming the app and credential; defaults to beta.' },
+                        'marketing-version': { type: 'string', required: true, description: 'Marketing version to release.' },
+                        approve: { type: 'boolean', required: false, description: 'Approve releasing the version to players.' },
+                    },
+                    run: async (ctx) => {
+                        const result = await publishAppStoreVersionCommand({
+                            game: readOptionalString(ctx.values.game) ?? '.',
+                            profile: readOptionalString(ctx.values.profile) ?? 'beta',
+                            version: readRequiredCliOption(ctx.values['marketing-version'], '--marketing-version'),
+                            approved: ctx.values.approve === true,
+                        });
+                        console.info(JSON.stringify(result, null, 2));
+                    },
+                }),
+                phased: defineI18n({
+                    name: 'phased',
+                    description: 'Pause, resume or complete the phased release of a released version.',
+                    resource: commandResource({
+                        en: 'Pause, resume or complete the phased release of a released version.',
+                        ko: '출시된 버전의 단계적 출시를 일시 중지, 재개 또는 완료합니다.',
+                    }),
+                    args: {
+                        game: { type: 'string', required: false, description: 'Game project directory.' },
+                        profile: { type: 'string', required: false, description: 'Deployment profile naming the app and credential; defaults to beta.' },
+                        'marketing-version': { type: 'string', required: true, description: 'Marketing version of the phased release.' },
+                        action: { type: 'string', required: true, description: 'pause, resume or complete.' },
+                        approve: { type: 'boolean', required: false, description: 'Approve the phased release change.' },
+                    },
+                    run: async (ctx) => {
+                        const result = await changeAppStorePhasedReleaseCommand({
+                            game: readOptionalString(ctx.values.game) ?? '.',
+                            profile: readOptionalString(ctx.values.profile) ?? 'beta',
+                            version: readRequiredCliOption(ctx.values['marketing-version'], '--marketing-version'),
+                            action: readRequiredCliOption(ctx.values.action, '--action'),
+                            approved: ctx.values.approve === true,
+                        });
+                        console.info(JSON.stringify(result, null, 2));
+                    },
+                }),
+            },
+        }),
     },
     run: () => {
-        console.info('Use "mpgd store products plan|apply" or "mpgd store presence plan|apply".');
+        console.info('Use "mpgd store products plan|apply", "mpgd store presence plan|apply" or "mpgd store release plan|apply|status".');
     },
 });
 const gameCommand = defineI18n({
@@ -4522,6 +4773,42 @@ async function readPlayReleaseOptions(values, android) {
     }
     return createPlayReleaseRequest({ track, status, userFraction, releaseNotesFile, mappingFile });
 }
+/**
+ * The release's recorded iOS build, the App Store Connect app it belongs to,
+ * and the iOS credential, read once from the saved plan.
+ */
+async function readTestFlightCliContext(values) {
+    const game = readOptionalString(values.game);
+    const plan = readNativeDeploymentPlan(readRequiredCliOption(values.plan, '--plan'), game === undefined ? undefined : path.resolve(game));
+    const credential = readStoreCredential(plan, 'ios', process.env);
+    if (credential.target !== 'ios') {
+        throw new Error('TestFlight distribution needs the iOS submission credential.');
+    }
+    const recorded = await readRecordedIosBuild({
+        plan,
+        gameId: readRequiredCliOption(values['game-id'], '--game-id'),
+        releaseKey: readRequiredCliOption(values.release, '--release'),
+    });
+    return {
+        credential,
+        target: {
+            appStoreAppId: credential.appStoreAppId,
+            bundleId: recorded.bundleId,
+            marketingVersion: recorded.marketingVersion,
+            buildNumber: recorded.buildNumber,
+            ...(recorded.buildId === undefined ? {} : { expectedBuildId: recorded.buildId }),
+        },
+    };
+}
+async function withTestFlightCliPort(credential, secretValues, action) {
+    const session = await openAscTestFlightDistributionSession(credential, { secretValues });
+    try {
+        return await action(session.port);
+    }
+    finally {
+        session.close();
+    }
+}
 function reportPlayDraftAppFallback(track) {
     console.warn(`Google Play accepts only draft releases until this app's first release is rolled out, `
         + `so the ${track} release is committed as a draft. Open that draft release in Play Console `

package/dist/native-build-info.json

@@ -1,5 +1,5 @@
 {
-  "kitGitSha": "1be07c42f7d67faaae8b908ee1a56d766b4b5120",
+  "kitGitSha": "3263fb99465db390c2e0027a3cf7b597cdee45b6",
   "kitDirty": false,
-  "packageVersion": "0.67.0"
+  "packageVersion": "0.68.0"
 }

package/dist/native-build-target.js

@@ -3335,7 +3335,7 @@ function inferProfileName(targetName2, target2) {
 
 // node_modules/.cache/mpgd-native-build/tools/icons/types.js
 var iconManifestSchemaVersion = 2;
-var iconGeneratorVersion = "1.1.0";
+var iconGeneratorVersion = "1.1.1";
 var generatedIconCacheDirectory = ".mpgd/generated/icons";
 
 // node_modules/.cache/mpgd-native-build/tools/icons/generator.js
@@ -3609,12 +3609,13 @@ function createReadiness(input, outputs, externalUrl) {
       externalUrl
     };
   }
-  if (input.enforceExternalReadiness === true) {
+  const consoleManagedBranding = input.target.metadata?.sdkMajor === 3;
+  if (input.enforceExternalReadiness === true && !consoleManagedBranding) {
     throw new Error(`${input.targetName}.icon.externalUrl is required for a production Apps in Toss package. Upload ${requireOutput(outputs, "console-icon").path} in the Apps in Toss console first.`);
   }
   return {
     state: "console-upload-required",
-    message: `Upload ${requireOutput(outputs, "console-icon").path} in the Apps in Toss console and configure icon.externalUrl before production packaging.`
+    message: consoleManagedBranding ? `SDK 3 packaging does not require an external icon URL. Upload ${requireOutput(outputs, "console-icon").path} in the Apps in Toss console before requesting review; console registration is not verified by this manifest.` : `Upload ${requireOutput(outputs, "console-icon").path} in the Apps in Toss console and configure icon.externalUrl before production packaging.`
   };
 }
 function requireOutput(outputs, purpose) {
@@ -8045,7 +8046,9 @@ var appStorePresenceLimits = Object.freeze({
   keywordBytes: 100,
   promotionalText: 170,
   whatsNew: 4e3,
-  screenshots: 10
+  screenshots: 10,
+  /** App Review notes. */
+  reviewNotes: 4e3
 });
 var appStorePresenceScreenshotSizes = Object.freeze({
   iphone69: [

package/dist/native-deploy-submission.d.ts

@@ -60,6 +60,17 @@ export declare function withRecordedR8Mapping(request: PlayReleaseRequest | unde
 export declare function submitRecordedNativeTarget(input: SubmitRecordedNativeTargetInput): Promise<NativeSubmissionCheckpoint>;
 /** Verify one recorded Android build and print its Play edit without any store call. */
 export declare function planRecordedAndroidSubmission(input: Omit<SubmitRecordedNativeTargetInput, 'credential' | 'approved'>, readStatus?: typeof readNativeReleaseStatus): Promise<PlaySubmissionPlan>;
+/**
+* The recorded iOS build of a release as App Store Connect knows it, for
+* `mpgd deploy testflight`: bundle ID, marketing version, build number and,
+* once the submission found it, the build ID. The IPA itself is not needed.
+*/
+export declare function readRecordedIosBuild(input: Pick<SubmitRecordedNativeTargetInput, 'plan' | 'gameId' | 'releaseKey' | 'environment' | 'signal'>, readStatus?: typeof readNativeReleaseStatus): Promise<{
+  readonly bundleId: string;
+  readonly marketingVersion: string;
+  readonly buildNumber: string;
+  readonly buildId?: string;
+}>;
 export declare function submitRecordedNativeTargetWithPorts(input: SubmitRecordedNativeTargetInput, ports: NativeSubmissionPorts): Promise<NativeSubmissionCheckpoint>;
 /** Validate the workflow-restored manifest against the immutable release-state hash. */
 export declare function verifyRecordedReleaseManifest(gameRoot: string, record: Pick<ImmutableNativeBuildRecord, 'artifactLocation' | 'releaseManifestSha256' | 'target'>): void;

package/dist/native-deploy-submission.js

@@ -82,6 +82,31 @@ export async function planRecordedAndroidSubmission(input, readStatus = readNati
     });
 }
 async function readRecordedSubmission(input, target, readStatus) {
+    const recorded = await readRecordedBuild(input, target, readStatus);
+    const artifactFile = resolveRecordedArtifact(input.plan.gameRoot, recorded.record.artifactLocation);
+    return { ...recorded, artifactFile };
+}
+/**
+ * The recorded iOS build of a release as App Store Connect knows it, for
+ * `mpgd deploy testflight`: bundle ID, marketing version, build number and,
+ * once the submission found it, the build ID. The IPA itself is not needed.
+ */
+export async function readRecordedIosBuild(input, readStatus = readNativeReleaseStatus) {
+    const { planned, record, status } = await readRecordedBuild(input, 'ios', readStatus);
+    const { marketingVersion, buildNumber } = record.platformVersion;
+    if (typeof marketingVersion !== 'string' || !/^\d+(?:\.\d+){0,2}$/u.test(marketingVersion)
+        || !/^[1-9]\d*$/u.test(String(buildNumber))) {
+        throw new Error('The recorded iOS build has no valid marketing version and build number.');
+    }
+    const buildId = status.submissions.ios?.remoteBuildId;
+    return {
+        bundleId: planned.appId,
+        marketingVersion,
+        buildNumber: String(buildNumber),
+        ...(buildId === undefined ? {} : { buildId }),
+    };
+}
+async function readRecordedBuild(input, target, readStatus) {
     const planned = input.plan.targets.find((entry) => entry.target === target);
     if (planned === undefined) {
         throw new Error('Native store submission requires a planned target and explicit approval.');
@@ -107,8 +132,7 @@ async function readRecordedSubmission(input, target, readStatus) {
         || record.internalTestGroupId !== planned.testGroup) {
         throw new Error('Store submission requires a matching immutable native build record.');
     }
-    const artifactFile = resolveRecordedArtifact(input.plan.gameRoot, record.artifactLocation);
-    return { planned, record, artifactFile, status };
+    return { planned, record, status };
 }
 export async function submitRecordedNativeTargetWithPorts(input, ports) {
     const target = input.credential.target;

package/dist/play-release-options.d.ts

@@ -63,6 +63,13 @@ export declare function parsePlayUserFraction(value: string | number): number;
 export declare function assertPlayUserFraction(fraction: number): void;
 export declare function readPlayReleaseNotesFile(file: string): PlayReleaseNote[];
 /**
+* A per-language notes file in the release-notes format below, without a
+* store's length limit; `label` names the notes in errors. TestFlight's
+* "What to Test" (`mpgd deploy testflight distribute --what-to-test`) reads
+* the same file format as Google Play release notes.
+*/
+export declare function readLocalizedNotesFile(file: string, label?: string): PlayReleaseNote[];
+/**
 * Accepts the Play Console's own language-tag format, one block per language:
 *
 *     <en-US>
@@ -72,7 +79,11 @@ export declare function readPlayReleaseNotesFile(file: string): PlayReleaseNote[
 * or JSON: `{ "en-US": "Bug fixes." }` or `[{ "language": "en-US", "text": "Bug fixes." }]`.
 */
 export declare function parsePlayReleaseNotes(source: string): PlayReleaseNote[];
+/** `parsePlayReleaseNotes` without Google Play's length limit. */
+export declare function parseLocalizedNotes(source: string, label?: string): PlayReleaseNote[];
 export declare function assertPlayReleaseNotes(notes: readonly PlayReleaseNote[]): void;
+/** One non-empty text per BCP-47 language, each language once. */
+export declare function assertLocalizedNotes(notes: readonly PlayReleaseNote[], label: string): void;
 export declare function hashMappingFile(mappingFile: string): Promise<string>;
 /** Build the Release body for a new bundle; the default matches the original body exactly. */
 export declare function newPlayRelease(request: PlayReleaseRequest, name: string, versionCode: number): PlayTrackRelease;