@htgabriel/release-kit 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,957 @@
+import { z } from 'zod';
+
+interface RunResult {
+    status: number;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+    dryRun?: boolean;
+    printed?: string;
+}
+interface RunOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    inherit?: boolean;
+    dryRun?: boolean;
+}
+type Runner = (command: string, args: string[], options?: RunOptions) => RunResult;
+
+type LogFn = (message: string) => void;
+interface Logger {
+    info: LogFn;
+    warn: LogFn;
+    error: LogFn;
+    success: LogFn;
+    step: LogFn;
+    debug: LogFn;
+}
+
+interface ReleaseKitContext {
+    /** Raiz do repositório git do projeto consumidor. */
+    repoRoot: string;
+    /** Diretório do app Expo (".", "packages/app", etc). */
+    appDir: string;
+    /** Onde ficam os artefatos e metadata de build (gitignored). */
+    releaseDir: string;
+    env: NodeJS.ProcessEnv;
+    dryRun: boolean;
+    json: boolean;
+    verbose: boolean;
+    /** Sem TTY / --non-interactive: nunca pergunta, nunca publica sem flags explícitas. */
+    nonInteractive: boolean;
+    run: Runner;
+    log: Logger;
+    /** Usado no gate de canal protegido: pede para digitar a versão exata. */
+    confirm?: (question: string) => Promise<string> | string;
+}
+interface CreateContextOverrides {
+    repoRoot: string;
+    appDir?: string;
+    releaseDir?: string;
+    env?: NodeJS.ProcessEnv;
+    dryRun?: boolean;
+    json?: boolean;
+    verbose?: boolean;
+    nonInteractive?: boolean;
+    run?: Runner;
+    log?: Logger;
+    confirm?: (question: string) => Promise<string> | string;
+}
+declare function createContext(overrides: CreateContextOverrides): ReleaseKitContext;
+
+declare const platformSchema: z.ZodEnum<["android", "ios"]>;
+type Platform = z.infer<typeof platformSchema>;
+declare const gitPolicySchema: z.ZodObject<{
+    releaseBranch: z.ZodDefault<z.ZodString>;
+    tagFormat: z.ZodDefault<z.ZodString>;
+    requireClean: z.ZodDefault<z.ZodBoolean>;
+    requireSyncedWithRemote: z.ZodDefault<z.ZodBoolean>;
+    remote: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    releaseBranch: string;
+    tagFormat: string;
+    requireClean: boolean;
+    requireSyncedWithRemote: boolean;
+    remote: string;
+}, {
+    releaseBranch?: string | undefined;
+    tagFormat?: string | undefined;
+    requireClean?: boolean | undefined;
+    requireSyncedWithRemote?: boolean | undefined;
+    remote?: string | undefined;
+}>;
+type GitPolicy = z.infer<typeof gitPolicySchema>;
+declare const channelSchema: z.ZodObject<{
+    /** Canal protegido (produção): exige --i-know-this-is-production ou confirmação digitando a versão. */
+    protected: z.ZodDefault<z.ZodBoolean>;
+    /** Se false, o canal nunca envia à loja (ex: build local de sideload). */
+    store: z.ZodDefault<z.ZodBoolean>;
+    buildProfile: z.ZodString;
+    submitProfile: z.ZodOptional<z.ZodString>;
+    /** Nome do "environment" do EAS (eas.json build.<profile>.environment) — usado nos checks de fingerprint/Sentry. */
+    easEnvironment: z.ZodOptional<z.ZodString>;
+    /** Se o build profile já reusa o build number/versionCode (eas.json autoIncrement). */
+    autoIncrement: z.ZodDefault<z.ZodBoolean>;
+    /** Profiles com upload de sourcemap desligado (ex: SENTRY_DISABLE_AUTO_UPLOAD) não exigem token no doctor. */
+    sentryUploadDisabled: z.ZodDefault<z.ZodBoolean>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    ios: z.ZodOptional<z.ZodObject<{
+        bundleId: z.ZodString;
+        ascAppId: z.ZodOptional<z.ZodString>;
+        appleTeamId: z.ZodOptional<z.ZodString>;
+        phasedRelease: z.ZodDefault<z.ZodBoolean>;
+        automaticRelease: z.ZodDefault<z.ZodBoolean>;
+        copyright: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        bundleId: string;
+        phasedRelease: boolean;
+        automaticRelease: boolean;
+        ascAppId?: string | undefined;
+        appleTeamId?: string | undefined;
+        copyright?: string | undefined;
+    }, {
+        bundleId: string;
+        ascAppId?: string | undefined;
+        appleTeamId?: string | undefined;
+        phasedRelease?: boolean | undefined;
+        automaticRelease?: boolean | undefined;
+        copyright?: string | undefined;
+    }>>;
+    android: z.ZodOptional<z.ZodObject<{
+        package: z.ZodString;
+        testTrack: z.ZodDefault<z.ZodString>;
+        productionTrack: z.ZodDefault<z.ZodString>;
+        initialRollout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        package: string;
+        testTrack: string;
+        productionTrack: string;
+        initialRollout: number;
+    }, {
+        package: string;
+        testTrack?: string | undefined;
+        productionTrack?: string | undefined;
+        initialRollout?: number | undefined;
+    }>>;
+    ota: z.ZodOptional<z.ZodObject<{
+        channel: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        channel: string;
+    }, {
+        channel: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    env: Record<string, string>;
+    protected: boolean;
+    store: boolean;
+    buildProfile: string;
+    autoIncrement: boolean;
+    sentryUploadDisabled: boolean;
+    android?: {
+        package: string;
+        testTrack: string;
+        productionTrack: string;
+        initialRollout: number;
+    } | undefined;
+    ios?: {
+        bundleId: string;
+        phasedRelease: boolean;
+        automaticRelease: boolean;
+        ascAppId?: string | undefined;
+        appleTeamId?: string | undefined;
+        copyright?: string | undefined;
+    } | undefined;
+    submitProfile?: string | undefined;
+    easEnvironment?: string | undefined;
+    ota?: {
+        channel: string;
+    } | undefined;
+}, {
+    buildProfile: string;
+    env?: Record<string, string> | undefined;
+    android?: {
+        package: string;
+        testTrack?: string | undefined;
+        productionTrack?: string | undefined;
+        initialRollout?: number | undefined;
+    } | undefined;
+    ios?: {
+        bundleId: string;
+        ascAppId?: string | undefined;
+        appleTeamId?: string | undefined;
+        phasedRelease?: boolean | undefined;
+        automaticRelease?: boolean | undefined;
+        copyright?: string | undefined;
+    } | undefined;
+    protected?: boolean | undefined;
+    store?: boolean | undefined;
+    submitProfile?: string | undefined;
+    easEnvironment?: string | undefined;
+    autoIncrement?: boolean | undefined;
+    sentryUploadDisabled?: boolean | undefined;
+    ota?: {
+        channel: string;
+    } | undefined;
+}>;
+type ChannelConfig = z.infer<typeof channelSchema>;
+declare const releaseKitConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    appDir: z.ZodDefault<z.ZodString>;
+    /** Conta/organização esperada no `eas whoami` (opcional; reforça o doctor). */
+    easOwner: z.ZodOptional<z.ZodString>;
+    platforms: z.ZodArray<z.ZodEnum<["android", "ios"]>, "many">;
+    locales: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    notesDir: z.ZodDefault<z.ZodString>;
+    version: z.ZodDefault<z.ZodObject<{
+        source: z.ZodDefault<z.ZodEnum<["app.json", "package.json"]>>;
+    }, "strip", z.ZodTypeAny, {
+        source: "app.json" | "package.json";
+    }, {
+        source?: "app.json" | "package.json" | undefined;
+    }>>;
+    git: z.ZodDefault<z.ZodObject<{
+        releaseBranch: z.ZodDefault<z.ZodString>;
+        tagFormat: z.ZodDefault<z.ZodString>;
+        requireClean: z.ZodDefault<z.ZodBoolean>;
+        requireSyncedWithRemote: z.ZodDefault<z.ZodBoolean>;
+        remote: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        releaseBranch: string;
+        tagFormat: string;
+        requireClean: boolean;
+        requireSyncedWithRemote: boolean;
+        remote: string;
+    }, {
+        releaseBranch?: string | undefined;
+        tagFormat?: string | undefined;
+        requireClean?: boolean | undefined;
+        requireSyncedWithRemote?: boolean | undefined;
+        remote?: string | undefined;
+    }>>;
+    channels: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodObject<{
+        /** Canal protegido (produção): exige --i-know-this-is-production ou confirmação digitando a versão. */
+        protected: z.ZodDefault<z.ZodBoolean>;
+        /** Se false, o canal nunca envia à loja (ex: build local de sideload). */
+        store: z.ZodDefault<z.ZodBoolean>;
+        buildProfile: z.ZodString;
+        submitProfile: z.ZodOptional<z.ZodString>;
+        /** Nome do "environment" do EAS (eas.json build.<profile>.environment) — usado nos checks de fingerprint/Sentry. */
+        easEnvironment: z.ZodOptional<z.ZodString>;
+        /** Se o build profile já reusa o build number/versionCode (eas.json autoIncrement). */
+        autoIncrement: z.ZodDefault<z.ZodBoolean>;
+        /** Profiles com upload de sourcemap desligado (ex: SENTRY_DISABLE_AUTO_UPLOAD) não exigem token no doctor. */
+        sentryUploadDisabled: z.ZodDefault<z.ZodBoolean>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        ios: z.ZodOptional<z.ZodObject<{
+            bundleId: z.ZodString;
+            ascAppId: z.ZodOptional<z.ZodString>;
+            appleTeamId: z.ZodOptional<z.ZodString>;
+            phasedRelease: z.ZodDefault<z.ZodBoolean>;
+            automaticRelease: z.ZodDefault<z.ZodBoolean>;
+            copyright: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            bundleId: string;
+            phasedRelease: boolean;
+            automaticRelease: boolean;
+            ascAppId?: string | undefined;
+            appleTeamId?: string | undefined;
+            copyright?: string | undefined;
+        }, {
+            bundleId: string;
+            ascAppId?: string | undefined;
+            appleTeamId?: string | undefined;
+            phasedRelease?: boolean | undefined;
+            automaticRelease?: boolean | undefined;
+            copyright?: string | undefined;
+        }>>;
+        android: z.ZodOptional<z.ZodObject<{
+            package: z.ZodString;
+            testTrack: z.ZodDefault<z.ZodString>;
+            productionTrack: z.ZodDefault<z.ZodString>;
+            initialRollout: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            package: string;
+            testTrack: string;
+            productionTrack: string;
+            initialRollout: number;
+        }, {
+            package: string;
+            testTrack?: string | undefined;
+            productionTrack?: string | undefined;
+            initialRollout?: number | undefined;
+        }>>;
+        ota: z.ZodOptional<z.ZodObject<{
+            channel: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            channel: string;
+        }, {
+            channel: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        env: Record<string, string>;
+        protected: boolean;
+        store: boolean;
+        buildProfile: string;
+        autoIncrement: boolean;
+        sentryUploadDisabled: boolean;
+        android?: {
+            package: string;
+            testTrack: string;
+            productionTrack: string;
+            initialRollout: number;
+        } | undefined;
+        ios?: {
+            bundleId: string;
+            phasedRelease: boolean;
+            automaticRelease: boolean;
+            ascAppId?: string | undefined;
+            appleTeamId?: string | undefined;
+            copyright?: string | undefined;
+        } | undefined;
+        submitProfile?: string | undefined;
+        easEnvironment?: string | undefined;
+        ota?: {
+            channel: string;
+        } | undefined;
+    }, {
+        buildProfile: string;
+        env?: Record<string, string> | undefined;
+        android?: {
+            package: string;
+            testTrack?: string | undefined;
+            productionTrack?: string | undefined;
+            initialRollout?: number | undefined;
+        } | undefined;
+        ios?: {
+            bundleId: string;
+            ascAppId?: string | undefined;
+            appleTeamId?: string | undefined;
+            phasedRelease?: boolean | undefined;
+            automaticRelease?: boolean | undefined;
+            copyright?: string | undefined;
+        } | undefined;
+        protected?: boolean | undefined;
+        store?: boolean | undefined;
+        submitProfile?: string | undefined;
+        easEnvironment?: string | undefined;
+        autoIncrement?: boolean | undefined;
+        sentryUploadDisabled?: boolean | undefined;
+        ota?: {
+            channel: string;
+        } | undefined;
+    }>>, Record<string, {
+        env: Record<string, string>;
+        protected: boolean;
+        store: boolean;
+        buildProfile: string;
+        autoIncrement: boolean;
+        sentryUploadDisabled: boolean;
+        android?: {
+            package: string;
+            testTrack: string;
+            productionTrack: string;
+            initialRollout: number;
+        } | undefined;
+        ios?: {
+            bundleId: string;
+            phasedRelease: boolean;
+            automaticRelease: boolean;
+            ascAppId?: string | undefined;
+            appleTeamId?: string | undefined;
+            copyright?: string | undefined;
+        } | undefined;
+        submitProfile?: string | undefined;
+        easEnvironment?: string | undefined;
+        ota?: {
+            channel: string;
+        } | undefined;
+    }>, Record<string, {
+        buildProfile: string;
+        env?: Record<string, string> | undefined;
+        android?: {
+            package: string;
+            testTrack?: string | undefined;
+            productionTrack?: string | undefined;
+            initialRollout?: number | undefined;
+        } | undefined;
+        ios?: {
+            bundleId: string;
+            ascAppId?: string | undefined;
+            appleTeamId?: string | undefined;
+            phasedRelease?: boolean | undefined;
+            automaticRelease?: boolean | undefined;
+            copyright?: string | undefined;
+        } | undefined;
+        protected?: boolean | undefined;
+        store?: boolean | undefined;
+        submitProfile?: string | undefined;
+        easEnvironment?: string | undefined;
+        autoIncrement?: boolean | undefined;
+        sentryUploadDisabled?: boolean | undefined;
+        ota?: {
+            channel: string;
+        } | undefined;
+    }>>;
+    toolchain: z.ZodDefault<z.ZodObject<{
+        easCli: z.ZodOptional<z.ZodObject<{
+            min: z.ZodString;
+            tested: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            min: string;
+            tested: string;
+        }, {
+            min: string;
+            tested: string;
+        }>>;
+        node: z.ZodOptional<z.ZodObject<{
+            min: z.ZodString;
+            tested: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            min: string;
+            tested: string;
+        }, {
+            min: string;
+            tested: string;
+        }>>;
+        jdk: z.ZodOptional<z.ZodObject<{
+            min: z.ZodString;
+            tested: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            min: string;
+            tested: string;
+        }, {
+            min: string;
+            tested: string;
+        }>>;
+        xcode: z.ZodOptional<z.ZodObject<{
+            min: z.ZodString;
+            tested: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            min: string;
+            tested: string;
+        }, {
+            min: string;
+            tested: string;
+        }>>;
+        cocoapods: z.ZodOptional<z.ZodObject<{
+            min: z.ZodString;
+            tested: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            min: string;
+            tested: string;
+        }, {
+            min: string;
+            tested: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        easCli?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        node?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        jdk?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        xcode?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        cocoapods?: {
+            min: string;
+            tested: string;
+        } | undefined;
+    }, {
+        easCli?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        node?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        jdk?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        xcode?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        cocoapods?: {
+            min: string;
+            tested: string;
+        } | undefined;
+    }>>;
+    doctor: z.ZodDefault<z.ZodObject<{
+        sentry: z.ZodDefault<z.ZodBoolean>;
+        expoDoctor: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        sentry: boolean;
+        expoDoctor: boolean;
+    }, {
+        sentry?: boolean | undefined;
+        expoDoctor?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    appDir: string;
+    platforms: ("android" | "ios")[];
+    locales: string[];
+    notesDir: string;
+    version: {
+        source: "app.json" | "package.json";
+    };
+    git: {
+        releaseBranch: string;
+        tagFormat: string;
+        requireClean: boolean;
+        requireSyncedWithRemote: boolean;
+        remote: string;
+    };
+    channels: Record<string, {
+        env: Record<string, string>;
+        protected: boolean;
+        store: boolean;
+        buildProfile: string;
+        autoIncrement: boolean;
+        sentryUploadDisabled: boolean;
+        android?: {
+            package: string;
+            testTrack: string;
+            productionTrack: string;
+            initialRollout: number;
+        } | undefined;
+        ios?: {
+            bundleId: string;
+            phasedRelease: boolean;
+            automaticRelease: boolean;
+            ascAppId?: string | undefined;
+            appleTeamId?: string | undefined;
+            copyright?: string | undefined;
+        } | undefined;
+        submitProfile?: string | undefined;
+        easEnvironment?: string | undefined;
+        ota?: {
+            channel: string;
+        } | undefined;
+    }>;
+    toolchain: {
+        easCli?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        node?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        jdk?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        xcode?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        cocoapods?: {
+            min: string;
+            tested: string;
+        } | undefined;
+    };
+    doctor: {
+        sentry: boolean;
+        expoDoctor: boolean;
+    };
+    $schema?: string | undefined;
+    easOwner?: string | undefined;
+}, {
+    platforms: ("android" | "ios")[];
+    channels: Record<string, {
+        buildProfile: string;
+        env?: Record<string, string> | undefined;
+        android?: {
+            package: string;
+            testTrack?: string | undefined;
+            productionTrack?: string | undefined;
+            initialRollout?: number | undefined;
+        } | undefined;
+        ios?: {
+            bundleId: string;
+            ascAppId?: string | undefined;
+            appleTeamId?: string | undefined;
+            phasedRelease?: boolean | undefined;
+            automaticRelease?: boolean | undefined;
+            copyright?: string | undefined;
+        } | undefined;
+        protected?: boolean | undefined;
+        store?: boolean | undefined;
+        submitProfile?: string | undefined;
+        easEnvironment?: string | undefined;
+        autoIncrement?: boolean | undefined;
+        sentryUploadDisabled?: boolean | undefined;
+        ota?: {
+            channel: string;
+        } | undefined;
+    }>;
+    $schema?: string | undefined;
+    appDir?: string | undefined;
+    easOwner?: string | undefined;
+    locales?: string[] | undefined;
+    notesDir?: string | undefined;
+    version?: {
+        source?: "app.json" | "package.json" | undefined;
+    } | undefined;
+    git?: {
+        releaseBranch?: string | undefined;
+        tagFormat?: string | undefined;
+        requireClean?: boolean | undefined;
+        requireSyncedWithRemote?: boolean | undefined;
+        remote?: string | undefined;
+    } | undefined;
+    toolchain?: {
+        easCli?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        node?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        jdk?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        xcode?: {
+            min: string;
+            tested: string;
+        } | undefined;
+        cocoapods?: {
+            min: string;
+            tested: string;
+        } | undefined;
+    } | undefined;
+    doctor?: {
+        sentry?: boolean | undefined;
+        expoDoctor?: boolean | undefined;
+    } | undefined;
+}>;
+type ReleaseKitConfig = z.infer<typeof releaseKitConfigSchema>;
+declare function parseConfig(input: unknown): ReleaseKitConfig;
+declare function channelOf(config: ReleaseKitConfig, name: string): ChannelConfig;
+declare function protectedChannelNames(config: ReleaseKitConfig): string[];
+
+declare function configExists(repoRoot: string): boolean;
+declare function loadConfig(repoRoot: string): ReleaseKitConfig;
+declare function writeConfig(repoRoot: string, config: ReleaseKitConfig): string;
+
+interface GitCheckResult {
+    name: string;
+    status: 'pass' | 'fail' | 'skip' | 'warn';
+    message: string;
+}
+/**
+ * Assertivas de política de git usadas pelo doctor e pelo gate de build.
+ * Reflete a regra do release kit original: production exige branch de
+ * release, tag == HEAD, e HEAD == remoto.
+ */
+declare function checkGitPolicy(ctx: ReleaseKitContext, policy: GitPolicy, { version, isProtectedChannel }: {
+    version: string;
+    isProtectedChannel: boolean;
+}): GitCheckResult[];
+
+interface CommitEntry {
+    sha: string;
+    subject: string;
+    type: string | null;
+    scope: string | null;
+    description: string;
+}
+/**
+ * Lista os commits desde a última tag que casa com `tagFormat` (ou desde o
+ * início do histórico, se nenhuma tag existir ainda). Usado para rascunhar
+ * as notas de versão.
+ */
+declare function commitsSinceLastTag(ctx: ReleaseKitContext, tagFormat: string): CommitEntry[];
+/** Filtra só o que interessa ao usuário final (feat/fix), descarta o resto. */
+declare function userFacingCommits(commits: CommitEntry[]): CommitEntry[];
+
+declare function readAppVersion(appDir: string, config: ReleaseKitConfig): string;
+type VersionBump = 'patch' | 'minor' | 'major' | string;
+declare function nextVersion(current: string, bump: VersionBump): string;
+/**
+ * Grava a nova versão preservando o resto do arquivo. Retorna o path
+ * escrito, para o caller decidir o `git add`/commit.
+ */
+declare function writeAppVersion(appDir: string, config: ReleaseKitConfig, next: string): string;
+
+interface ToolchainInfo {
+    easCli: string | null;
+    node: string | null;
+    yarn: string | null;
+    jdk: string | null;
+    xcode: string | null;
+    xcodeBuild: string | null;
+    cocoapods: string | null;
+    ndkHome: string | null;
+    host: string;
+}
+
+type CheckStatus = 'pass' | 'fail' | 'skip' | 'warn';
+interface Check {
+    name: string;
+    status: CheckStatus;
+    message: string;
+}
+
+interface DoctorOptions {
+    channel?: string;
+    platform?: Platform;
+    deep?: boolean;
+    buildId?: string;
+    allowToolchainDrift?: boolean;
+}
+interface DoctorReport {
+    ok: boolean;
+    checks: Check[];
+    toolchainDrift: boolean;
+}
+declare function runDoctor(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: DoctorOptions): DoctorReport;
+
+interface ProtectedGateOptions {
+    iKnowThisIsProduction?: boolean;
+    confirmVersion?: string;
+}
+/**
+ * Gate fail-closed para canais `protected: true`: exige
+ * `--i-know-this-is-production` (não-interativo) ou confirmação digitando a
+ * versão exata. Sem isso, nenhum comando toca um canal protegido — nem
+ * build, nem submit, nem update OTA.
+ */
+declare function assertChannelOptIn(ctx: ReleaseKitContext, config: ReleaseKitConfig, channel: ChannelConfig, opts: ProtectedGateOptions): void;
+
+interface ReleaseMetadata {
+    platform: Platform;
+    channel: string;
+    buildProfile: string;
+    version: string;
+    buildNumber: string | null;
+    versionCode: string | null;
+    artifactPath: string;
+    sha256: string;
+    commitSha: string;
+    branch: string;
+    tag: string;
+    createdAt: string;
+    toolchain: ToolchainInfo | null;
+    toolchainDrift: boolean;
+}
+
+interface BuildOptions extends ProtectedGateOptions {
+    channel: string;
+    platform: Platform;
+    cloud?: boolean;
+    output?: string;
+    toolchainDrift?: boolean;
+}
+interface BuildResult {
+    dryRun?: boolean;
+    command?: string;
+    artifactPath?: string;
+    metadata?: ReleaseMetadata;
+    staging?: string;
+}
+declare function buildRelease(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: BuildOptions): BuildResult;
+
+interface SubmitOptions extends ProtectedGateOptions {
+    channel: string;
+    platform?: Platform;
+    /** true = usa o metadata.json mais recente gerado por `build`. */
+    latest?: boolean;
+    /** artefato avulso (.aab/.ipa), sem passar por `build`. */
+    path?: string;
+}
+interface SubmitResult {
+    dryRun?: boolean;
+    command?: string;
+    submitProfile: string;
+    artifactPath: string;
+}
+declare function submitRelease(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: SubmitOptions): SubmitResult;
+
+interface ShipOptions extends BuildOptions {
+    skipDoctor?: boolean;
+    allowToolchainDrift?: boolean;
+}
+interface ShipResult {
+    dryRun?: boolean;
+    artifactPath?: string;
+    submit?: SubmitResult;
+}
+declare function shipRelease(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: ShipOptions): ShipResult;
+
+interface BumpVersionOptions {
+    bump: VersionBump;
+    push?: boolean;
+}
+interface BumpVersionResult {
+    from: string;
+    to: string;
+    tag: string;
+    dryRun?: boolean;
+}
+declare function bumpVersion(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: BumpVersionOptions): BumpVersionResult;
+
+declare const PLAY_NOTES_MAX = 500;
+declare const APPLE_WHATS_NEW_MAX = 4000;
+type NotesTarget = 'ios' | 'play';
+declare function notesMaxFor(target: NotesTarget): number;
+declare function assertNotesWithinLimit(text: string, target: NotesTarget, locale: string): void;
+
+interface NotesOptions {
+    version?: string;
+    /** Reabre no editor mesmo se o arquivo já existir. */
+    edit?: boolean;
+    skipEditor?: boolean;
+}
+interface NotesResult {
+    version: string;
+    files: Array<{
+        path: string;
+        target: NotesTarget;
+        locale: string;
+    }>;
+}
+/**
+ * Gera (se faltar) e abre para edição as notas de cada locale/loja. Não
+ * publica nada — só prepara os arquivos que `promote`/`review`/`notes`
+ * (comando de loja) vão ler depois.
+ */
+declare function draftAndEditNotes(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: NotesOptions): NotesResult;
+
+interface PromoteOptions extends ProtectedGateOptions {
+    channel: string;
+    platform?: Platform;
+}
+interface PromoteResult {
+    android?: {
+        versionCodes?: string[];
+        status: string;
+    };
+    ios?: {
+        submissionId: string;
+        state: string;
+        alreadyInProgress: boolean;
+    };
+}
+/**
+ * `build` + `submit` já colocaram o binário na faixa de teste
+ * (Play Internal / TestFlight). `promote` não faz upload nenhum: copia a
+ * release pra faixa de produção (Play) ou cria a Review Submission
+ * (Apple) — é o equivalente ao `local-validation` → produção do kit
+ * original.
+ */
+declare function promoteRelease(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: PromoteOptions): Promise<PromoteResult>;
+
+interface GoogleServiceAccount {
+    client_email: string;
+    private_key: string;
+    [key: string]: unknown;
+}
+declare function parseServiceAccountJson(raw: string): GoogleServiceAccount;
+/**
+ * Fluxo OAuth de service account (JWT bearer, RFC 7523), sem
+ * `google-auth-library`: assina um JWT RS256 com a private_key da SA e
+ * troca por um access_token de curta duração. node:crypto puro.
+ */
+declare function fetchAccessToken(account: GoogleServiceAccount, fetchImpl?: typeof fetch, now?: number): Promise<string>;
+
+interface PlayRelease {
+    name?: string;
+    versionCodes?: string[];
+    status: 'completed' | 'inProgress' | 'halted' | 'draft';
+    releaseNotes?: Array<{
+        language: string;
+        text: string;
+    }>;
+    userFraction?: number;
+}
+type RolloutTarget = number | 'complete' | 'halt';
+
+interface RolloutOptions extends ProtectedGateOptions {
+    channel: string;
+    platform: Platform;
+    to: RolloutTarget;
+}
+/**
+ * Só Android tem rollout percentual manipulável via API sem reupload
+ * (`userFraction`). No iOS o equivalente é o phased release, controlado
+ * pelo próprio App Store Connect após a review — não há endpoint de
+ * pause/resume simples e estável na API pública hoje; documentado como
+ * limitação em vez de fingir suporte.
+ */
+declare function rolloutRelease(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: RolloutOptions): Promise<PlayRelease | {
+    dryRun: boolean;
+}>;
+
+interface StatusOptions {
+    channel: string;
+}
+interface StatusResult {
+    version: string;
+    android?: {
+        track: string;
+        releases: Array<{
+            status: string;
+            versionCodes?: string[];
+            userFraction?: number;
+        }>;
+    };
+    ios?: {
+        appStoreState: string | null;
+        reviewSubmissionState: string | null;
+    };
+}
+declare function statusOf(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: StatusOptions): Promise<StatusResult>;
+
+interface UpdateOptions extends ProtectedGateOptions {
+    channel: string;
+    message?: string;
+    platform?: Platform | 'all';
+}
+interface UpdateResult {
+    dryRun?: boolean;
+    command?: string;
+    channel: string;
+}
+/**
+ * OTA via `eas update`. Canal protegido passa pelo mesmo gate fail-closed
+ * do build/submit: só roda com --i-know-this-is-production ou confirmando
+ * a versão — nunca por padrão, mesmo em `release-kit update` sem flags.
+ */
+declare function updateRelease(ctx: ReleaseKitContext, config: ReleaseKitConfig, opts: UpdateOptions): UpdateResult;
+
+/**
+ * Rascunho a partir dos commits (feat/fix) desde a última tag. Não traduz
+ * nem reescreve em linguagem de usuário — é ponto de partida para editar
+ * no $EDITOR, não o texto final.
+ */
+declare function draftNotes(commits: CommitEntry[], version: string): string;
+
+interface AppStoreConnectCredentials {
+    keyId: string;
+    issuerId: string;
+    /** Conteúdo do arquivo .p8 (PEM), não o path. */
+    privateKeyPem: string;
+}
+/**
+ * JWT ES256 exigido pela App Store Connect API. Sem SDK (Spaceship) —
+ * assinatura via node:crypto puro, então funciona igual em qualquer SO.
+ * Expira em 20 minutos (o máximo aceito pela Apple); gerar um novo por
+ * chamada evita lidar com relógio/cache entre processos.
+ */
+declare function createAppStoreConnectToken(credentials: AppStoreConnectCredentials, now?: number): string;
+
+export { APPLE_WHATS_NEW_MAX, type ChannelConfig, PLAY_NOTES_MAX, type Platform, type ReleaseKitConfig, type ReleaseKitContext, assertChannelOptIn, assertNotesWithinLimit, buildRelease, bumpVersion, channelOf, checkGitPolicy, commitsSinceLastTag, configExists, createAppStoreConnectToken, createContext, draftAndEditNotes, draftNotes, fetchAccessToken, loadConfig, nextVersion, notesMaxFor, parseConfig, parseServiceAccountJson, promoteRelease, protectedChannelNames, readAppVersion, releaseKitConfigSchema, rolloutRelease, runDoctor, shipRelease, statusOf, submitRelease, updateRelease, userFacingCommits, writeAppVersion, writeConfig };