@capgo/cli 7.120.0 → 7.122.0

package/dist/src/build/onboarding/ui/steps/android-sa-gcp.d.ts

@@ -0,0 +1,85 @@
+import type { FC } from 'react';
+export interface SelectOption {
+    label: string;
+    value: string;
+}
+export type ServiceAccountMethodChoice = 'existing' | 'generate';
+export interface ServiceAccountMethodSelectStepProps {
+    onChoose: (choice: ServiceAccountMethodChoice) => void;
+    dense?: boolean;
+}
+export declare const ServiceAccountMethodSelectStep: FC<ServiceAccountMethodSelectStepProps>;
+export interface SaJsonExistingPathStepProps {
+    showChooser: boolean;
+    onChoosePicker: () => void;
+    onChooseManual: () => void;
+    onSubmitPath: (value: string) => void;
+    dense?: boolean;
+}
+export declare const SaJsonExistingPathStep: FC<SaJsonExistingPathStepProps>;
+export declare const SaJsonExistingPickerStep: FC;
+export declare const SaJsonValidatingStep: FC;
+export interface SaJsonValidationFailedStepProps {
+    message: string;
+    onChoose: (choice: 'retry' | 'save-anyway' | 'oauth') => void;
+    dense?: boolean;
+}
+export declare const SaJsonValidationFailedStep: FC<SaJsonValidationFailedStepProps>;
+export type GoogleSignInChoice = 'go' | 'learn' | 'exit';
+export interface GoogleSignInStepProps {
+    onChoose: (choice: GoogleSignInChoice) => void;
+    dense?: boolean;
+}
+export declare const GoogleSignInStep: FC<GoogleSignInStepProps>;
+export interface GoogleSignInLearnMoreStepProps {
+    onBack: () => void;
+    dense?: boolean;
+}
+export declare const GoogleSignInLearnMoreStep: FC<GoogleSignInLearnMoreStepProps>;
+export interface GoogleSignInRunningStepProps {
+    statusMessages: string[];
+    dense?: boolean;
+}
+export declare const GoogleSignInRunningStep: FC<GoogleSignInRunningStepProps>;
+export type PlayDevIdActionChoice = 'open' | 'tutorial' | 'manual';
+export interface PlayDeveloperIdActionsStepProps {
+    playDeveloperUrl: string;
+    onChoose: (choice: PlayDevIdActionChoice) => void;
+    dense?: boolean;
+}
+export declare const PlayDeveloperIdActionsStep: FC<PlayDeveloperIdActionsStepProps>;
+export interface PlayDeveloperIdInputStepProps {
+    onSubmit: (value: string) => void;
+    dense?: boolean;
+}
+export declare const PlayDeveloperIdInputStep: FC<PlayDeveloperIdInputStepProps>;
+export declare const GcpProjectsLoadingStep: FC;
+export interface GcpProjectsSelectStepProps {
+    options: SelectOption[];
+    onChange: (value: string) => void;
+    dense?: boolean;
+}
+export declare const GcpProjectsSelectStep: FC<GcpProjectsSelectStepProps>;
+export interface GcpProjectCreateNameStepProps {
+    /** Placeholder shown for the default project display name. */
+    defaultDisplayName: string;
+    onSubmit: (value: string) => void;
+    dense?: boolean;
+}
+export declare const GcpProjectCreateNameStep: FC<GcpProjectCreateNameStepProps>;
+export interface AndroidPackageSelectStepProps {
+    showChooser: boolean;
+    detectedOptions: SelectOption[];
+    detectedCount: number;
+    /** The configured native dir (e.g. "android") — used in the comfortable copy. */
+    androidDir: string;
+    onChooseDetected: (value: string) => void;
+    onSubmitManual: (value: string) => void;
+    dense?: boolean;
+}
+export declare const AndroidPackageSelectStep: FC<AndroidPackageSelectStepProps>;
+export interface GcpSetupRunningStepProps {
+    statusMessages: string[];
+    dense?: boolean;
+}
+export declare const GcpSetupRunningStep: FC<GcpSetupRunningStepProps>;

package/dist/src/build/onboarding/ui/steps/android-shared.d.ts

@@ -0,0 +1,63 @@
+import type { FC } from 'react';
+import type { AiResultKind } from '../components.js';
+export declare const WelcomeStep: FC;
+export interface NoPlatformStepProps {
+    androidDir: string;
+    dense?: boolean;
+}
+export declare const NoPlatformStep: FC<NoPlatformStepProps>;
+export interface CredentialsExistStepProps {
+    appId: string;
+    onChoose: (choice: 'backup' | 'exit') => void;
+    dense?: boolean;
+}
+export declare const CredentialsExistStep: FC<CredentialsExistStepProps>;
+export declare const BackingUpStep: FC;
+export interface BuildCompleteStepProps {
+    uploadSummary: string | null;
+    buildUrl: string;
+    /** Absolute path of a workflow file written by the GitHub Actions flow. */
+    workflowWrittenPath?: string | null;
+    /** Absolute path of credentials exported to a .env fallback. */
+    envExportPath?: string | null;
+    /** Surfaced when the .env export failed (non-fatal). */
+    envExportError?: string | null;
+    dense?: boolean;
+}
+export declare const BuildCompleteStep: FC<BuildCompleteStepProps>;
+export interface ErrorStepProps {
+    message: string;
+    onChoose: (choice: 'retry' | 'exit') => void;
+    dense?: boolean;
+}
+export declare const ErrorStep: FC<ErrorStepProps>;
+export interface AiAnalysisPromptStepProps {
+    onChoose: (choice: 'debug' | 'skip') => void;
+    dense?: boolean;
+}
+export declare const AiAnalysisPromptStep: FC<AiAnalysisPromptStepProps>;
+export declare const AiAnalysisRunningStep: FC;
+export interface AiAnalysisResultStepProps {
+    /** Pre-rendered (markdown→ANSI) analysis text, or null on a non-success result. */
+    analysisText: string | null;
+    /**
+     * True when the analysis is too tall to show inline alongside the picker, so
+     * it lives in the scroll viewer and is replaced here by a compact marker + a
+     * "Re-read analysis" option. False ⇒ render the full text inline.
+     */
+    collapsed: boolean;
+    /** Non-success outcome banner (error / already_analyzed / too_big), else null. */
+    result: {
+        kind: AiResultKind;
+        message: string;
+    } | null;
+    /** Retries already consumed; with `maxRetries` decides whether retry is offered. */
+    retryCount: number;
+    maxRetries: number;
+    onRetry: () => void;
+    onSkipOrContinue: () => void;
+    /** Re-open the fullscreen scroll viewer to re-read the analysis. */
+    onReread: () => void;
+    dense?: boolean;
+}
+export declare const AiAnalysisResultStep: FC<AiAnalysisResultStepProps>;

package/dist/src/build/onboarding/ui/steps/ios-ci.d.ts

@@ -0,0 +1,44 @@
+import type { FC } from 'react';
+import type { CiSecretSetupAdvice, CiSecretTarget } from '../../ci-secrets.js';
+export interface SelectOption {
+    label: string;
+    value: string;
+}
+export declare const DetectingCiSecretsStep: FC;
+export interface CiSecretsSetupStepProps {
+    advice: CiSecretSetupAdvice[];
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const CiSecretsSetupStep: FC<CiSecretsSetupStepProps>;
+export interface CiSecretsTargetSelectStepProps {
+    options: SelectOption[];
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const CiSecretsTargetSelectStep: FC<CiSecretsTargetSelectStepProps>;
+export interface AskCiSecretsStepProps {
+    entryCount: number;
+    target: CiSecretTarget | null;
+    targetLabel: string;
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const AskCiSecretsStep: FC<AskCiSecretsStepProps>;
+export interface ConfirmCiSecretOverwriteStepProps {
+    existingKeys: string[];
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const ConfirmCiSecretOverwriteStep: FC<ConfirmCiSecretOverwriteStepProps>;
+export interface CiSecretsFailedStepProps {
+    error: string | null;
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const CiSecretsFailedStep: FC<CiSecretsFailedStepProps>;
+export interface AskBuildStepProps {
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const AskBuildStep: FC<AskBuildStepProps>;

package/dist/src/build/onboarding/ui/steps/ios-credentials.d.ts

@@ -0,0 +1,66 @@
+import type { FC } from 'react';
+export interface SelectOption {
+    label: string;
+    value: string;
+}
+export interface CredentialsExistStepProps {
+    appId: string;
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const CredentialsExistStep: FC<CredentialsExistStepProps>;
+export declare const BackingUpStep: FC;
+export interface SetupMethodSelectStepProps {
+    dense?: boolean;
+    onChange: (value: string) => void | Promise<void>;
+}
+export declare const SetupMethodSelectStep: FC<SetupMethodSelectStepProps>;
+export interface ApiKeyInstructionsStepProps {
+    canUseFilePicker: boolean;
+    dense?: boolean;
+    onMethodChange: (value: string) => void;
+    onPathSubmit: (value: string) => void | Promise<void>;
+}
+export declare const ApiKeyInstructionsStep: FC<ApiKeyInstructionsStepProps>;
+export declare const P8MethodSelectStep: FC;
+export interface InputP8PathStepProps {
+    onSubmit: (value: string) => void | Promise<void>;
+}
+export declare const InputP8PathStep: FC<InputP8PathStepProps>;
+export interface InputKeyIdStepProps {
+    keyId: string;
+    dense?: boolean;
+    onSubmit: (value: string) => void;
+}
+export declare const InputKeyIdStep: FC<InputKeyIdStepProps>;
+export interface InputIssuerIdStepProps {
+    dense?: boolean;
+    onSubmit: (value: string) => void;
+}
+export declare const InputIssuerIdStep: FC<InputIssuerIdStepProps>;
+export declare const VerifyingKeyStep: FC;
+export declare const CreatingCertificateStep: FC;
+export interface CertLimitPromptStepProps {
+    existingCount: number;
+    options: SelectOption[];
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const CertLimitPromptStep: FC<CertLimitPromptStepProps>;
+export declare const RevokingCertificateStep: FC;
+export interface CreatingProfileStepProps {
+    appId: string;
+    dense?: boolean;
+}
+export declare const CreatingProfileStep: FC<CreatingProfileStepProps>;
+export interface DuplicateProfilePromptStepProps {
+    duplicateCount: number;
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const DuplicateProfilePromptStep: FC<DuplicateProfilePromptStepProps>;
+export interface DeletingDuplicateProfilesStepProps {
+    duplicateCount: number;
+}
+export declare const DeletingDuplicateProfilesStep: FC<DeletingDuplicateProfilesStepProps>;
+export declare const SavingCredentialsStep: FC;

package/dist/src/build/onboarding/ui/steps/ios-import.d.ts

@@ -0,0 +1,47 @@
+import type { FC } from 'react';
+export interface SelectOption {
+    label: string;
+    value: string;
+}
+export declare const ImportScanningStep: FC;
+export interface ImportDistributionModeStepProps {
+    dense?: boolean;
+    onChange: (value: string) => void | Promise<void>;
+}
+export declare const ImportDistributionModeStep: FC<ImportDistributionModeStepProps>;
+export interface ImportPickIdentityStepProps {
+    identityCount: number;
+    options: SelectOption[];
+    dense?: boolean;
+    onChange: (value: string) => void | Promise<void>;
+}
+export declare const ImportPickIdentityStep: FC<ImportPickIdentityStepProps>;
+export interface ImportPickProfileStepProps {
+    matchedCount: number;
+    droppedCount: number;
+    distribution: 'app_store' | 'ad_hoc' | null;
+    options: SelectOption[];
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const ImportPickProfileStep: FC<ImportPickProfileStepProps>;
+export interface ImportNoMatchRecoveryStepProps {
+    identityName: string;
+    options: SelectOption[];
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const ImportNoMatchRecoveryStep: FC<ImportNoMatchRecoveryStepProps>;
+export declare const ImportFetchingProfileStep: FC;
+export declare const ImportCreateProfileOnlyStep: FC;
+export interface ImportExportWarningStepProps {
+    identityName: string;
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const ImportExportWarningStep: FC<ImportExportWarningStepProps>;
+export interface ImportCompilingHelperStepProps {
+    dense?: boolean;
+}
+export declare const ImportCompilingHelperStep: FC<ImportCompilingHelperStepProps>;
+export declare const ImportExportingStep: FC;

package/dist/src/build/onboarding/ui/steps/ios-shared.d.ts

@@ -0,0 +1,89 @@
+import type { FC } from 'react';
+import type { BuildOnboardingRecoveryAdvice } from '../../recovery.js';
+import type { AiResultKind } from '../components.js';
+export declare const WelcomeStep: FC;
+export interface PlatformSelectStepProps {
+    appId: string;
+    dense?: boolean;
+    onChange: (value: string) => void | Promise<void>;
+}
+export declare const PlatformSelectStep: FC<PlatformSelectStepProps>;
+export interface NoPlatformStepProps {
+    iosDir: string;
+    addIosCommand: string;
+    syncIosCommand: string;
+    dense?: boolean;
+    onChange: (value: string) => void;
+}
+export declare const NoPlatformStep: FC<NoPlatformStepProps>;
+export interface AddingPlatformStepProps {
+    addIosCommand: string;
+    doctorCommand: string;
+    dense?: boolean;
+}
+export declare const AddingPlatformStep: FC<AddingPlatformStepProps>;
+export interface AiAnalysisPromptStepProps {
+    dense?: boolean;
+    onChange: (value: string) => void | Promise<void>;
+}
+export declare const AiAnalysisPromptStep: FC<AiAnalysisPromptStepProps>;
+export declare const AiAnalysisRunningStep: FC;
+export interface AiAnalysisResultStepProps {
+    analysisText: string | null;
+    collapsed: boolean;
+    result: {
+        kind: AiResultKind;
+        message: string;
+    } | null;
+    canRetry: boolean;
+    retriesLeft: number;
+    maxRetries: number;
+    dense?: boolean;
+    onChange: (value: string) => void | Promise<void>;
+}
+export declare const AiAnalysisResultStep: FC<AiAnalysisResultStepProps>;
+export interface ErrorStepProps {
+    error: string;
+    recoveryAdvice: BuildOnboardingRecoveryAdvice | null;
+    supportBundlePath: string | null;
+    showRetry: boolean;
+    dense?: boolean;
+    /** When true, the full error + recovery advice was already shown in the
+     *  scrollable viewer (it was taller than the viewport), so render only the
+     *  error headline + the action prompt here — keeping Try again / Restart /
+     *  Exit reachable no matter how long the advice was. */
+    collapsed?: boolean;
+    onChange: (value: string) => void | Promise<void>;
+}
+export declare function formatErrorViewerLines(error: string, recoveryAdvice: BuildOnboardingRecoveryAdvice | null, supportBundlePath: string | null): string[];
+/**
+ * Estimate the rendered row height of the COMFORTABLE ErrorStep body (marginTop
+ * + error line + recovery advice + action prompt), independent of whether the
+ * collapsed or full form actually renders. The parent uses this to decide
+ * whether to route the error through the scroll viewer.
+ *
+ * Why a structural estimate and not `measureElement`: measuring the rendered
+ * body would FEEDBACK-LOOP — a collapsed body measures short → "fits" → render
+ * full → measures tall → collapse → measures short → … This estimate depends
+ * only on the advice shape + width, so the decision is stable at any size.
+ *
+ * Calibrated against the VT harness: the body estimate lands within ~1 row of
+ * the real render across every recovery-advice shape, and the surrounding frame
+ * chrome (boxed header + completed-steps log + padding) is a fixed ~15 rows the
+ * caller reserves on top.
+ */
+export declare function estimateErrorBodyRows(error: string, recoveryAdvice: BuildOnboardingRecoveryAdvice | null, supportBundlePath: string | null, cols: number, showRetry: boolean): number;
+export declare const ErrorStep: FC<ErrorStepProps>;
+export interface BuildCompleteStepProps {
+    buildUrl: string;
+    ciSecretUploadSummary: string | null;
+    buildRequestCommand: string;
+    /** Absolute path of a workflow file written by the GitHub Actions flow. */
+    workflowWrittenPath?: string | null;
+    /** Absolute path of credentials exported to a .env fallback. */
+    envExportPath?: string | null;
+    /** Surfaced when the .env export failed (non-fatal). */
+    envExportError?: string | null;
+    dense?: boolean;
+}
+export declare const BuildCompleteStep: FC<BuildCompleteStepProps>;

package/dist/src/bundle/builder-cta.d.ts

@@ -13,6 +13,24 @@ export interface BuilderCtaContext {
  *   whether the app already has build credentials.
  */
 export declare function decideBuilderCtaSurface(ctx: BuilderCtaContext): BuilderCtaSurface;
+export interface ShouldBlockIncompatibleUploadContext {
+    incompatible: boolean;
+    failOnIncompatible: boolean;
+    interactive: boolean;
+    /** The resolved Builder CTA action (`continue` in CI / when declined). */
+    builderAction: BuilderCtaAction;
+}
+/**
+ * Pure decision: should an incompatible upload be blocked (abort + exit non-zero)
+ * instead of uploaded, given `--fail-on-incompatible`?
+ *
+ * - Only confirmed-incompatible bundles with the flag set are candidates.
+ * - Non-interactive (CI): block immediately.
+ * - Interactive: block only when the user declined the Capgo Builder native-build
+ *   escape hatch (`builderAction === 'continue'`). Accepting a native build
+ *   (`launch-build` / `launch-onboarding`) supersedes the OTA upload, so do not block.
+ */
+export declare function shouldBlockIncompatibleUpload(ctx: ShouldBlockIncompatibleUploadContext): boolean;
 export declare function printBuilderCiAd(hasCredentials: boolean): void;
 /** Confirm-prompt seam (`@clack/prompts` `confirm` satisfies it); injectable for tests. */
 export type BuilderConfirm = (opts: {

package/dist/src/bundle/upload.d.ts

@@ -5,6 +5,13 @@ type SupabaseType = Awaited<ReturnType<typeof createSupabaseClient>>;
 export type { UploadBundleResult };
 export declare function getDefaultUploadChannel(appId: string, supabase: SupabaseType, hostWeb: string): Promise<string>;
 export declare function uploadBundleInternal(preAppid: string, options: OptionsUpload, silent?: boolean): Promise<UploadBundleResult>;
+/**
+ * Validate mutually-exclusive and dependent upload options, failing fast (via
+ * `uploadFail`) before any network call. Exported so the option-conflict guards
+ * (e.g. `--fail-on-incompatible` + `--ignore-metadata-check`) can be unit-tested
+ * directly.
+ */
+export declare function checkValidOptions(options: OptionsUpload): void;
 export declare function uploadBundle(appid: string, options: OptionsUpload): Promise<{
     success: boolean;
     bundle: string;

package/dist/src/schemas/build.d.ts

@@ -59,6 +59,11 @@ export declare const buildRequestOptionsSchema: z.ZodObject<{
     playstoreUpload: z.ZodOptional<z.ZodBoolean>;
     verbose: z.ZodOptional<z.ZodBoolean>;
     aiAnalytics: z.ZodOptional<z.ZodBoolean>;
+    aiAnalysisMode: z.ZodOptional<z.ZodEnum<{
+        skip: "skip";
+        "auto-prompt": "auto-prompt";
+        "caller-handled": "caller-handled";
+    }>>;
 }, z.core.$strip>;
 export type BuildRequestOptions = z.infer<typeof buildRequestOptionsSchema>;
 export declare const buildNeededOptionsSchema: z.ZodObject<{
@@ -77,6 +82,11 @@ export declare const buildRequestResultSchema: z.ZodObject<{
     uploadUrl: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
+    aiAnalysis: z.ZodOptional<z.ZodObject<{
+        jobId: z.ZodString;
+        capturedLogPath: z.ZodString;
+        ready: z.ZodBoolean;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type BuildRequestResult = z.infer<typeof buildRequestResultSchema>;
 export declare const buildOptionsPayloadSchema: z.ZodObject<{

package/dist/src/schemas/bundle.d.ts

@@ -26,6 +26,7 @@ export declare const optionsUploadSchema: z.ZodObject<{
     autoMinUpdateVersion: z.ZodOptional<z.ZodBoolean>;
     autoSetBundle: z.ZodOptional<z.ZodBoolean>;
     ignoreMetadataCheck: z.ZodOptional<z.ZodBoolean>;
+    failOnIncompatible: z.ZodOptional<z.ZodBoolean>;
     ignoreChecksumCheck: z.ZodOptional<z.ZodBoolean>;
     forceCrc32Checksum: z.ZodOptional<z.ZodBoolean>;
     timeout: z.ZodOptional<z.ZodNumber>;