expo-release 2.3.2 → 2.4.0

package/dist/decide.d.ts

@@ -7,13 +7,26 @@ export type EASBuild = {
     buildUrl?: string;
     fingerprint?: string;
     runtimeVersion?: string;
+    /** Why EAS failed the build, for an errored one. */
+    error?: string;
+};
+/** Why the decision came out the way it did. */
+export type DecisionReason = 'no-impact-path' | 'finished-build' | 'build-in-progress' | 'no-build-for-fingerprint';
+/** What changed since the profile's last finished build, for a native decision. */
+export type FingerprintDiff = {
+    buildId: string;
+    buildUrl?: string;
+    /** `changed <path>`, `added <path>` or `removed <path>`; contents sources by id. */
+    sources: string[];
 };
 export type ReleaseDecision = {
     deployType: DeployType;
+    reason: DecisionReason;
     nativeBuildPending: boolean;
     changedFiles: string[];
     fingerprint: string | null;
     build: EASBuild | null;
+    fingerprintDiff?: FingerprintDiff | null;
 };
 export type DecisionInput = {
     base?: string;
@@ -22,14 +35,27 @@ export type DecisionInput = {
     platform: ReleasePlatform;
     impactPaths: string[];
     ignoreExpoImpact?: boolean;
+    /** Passed to `eas fingerprint:compare` when explaining a native decision. */
+    environment?: string;
+    /** Runs once the diff says EAS is needed, before the first EAS command. */
+    preflight?: () => Promise<void>;
 };
 export declare function parseBuildList(output: string): EASBuild[];
 export declare function isExpoImpactPath(path: string, impactPaths?: readonly string[]): boolean;
 export declare function hasExpoImpact(paths: string[], impactPaths?: readonly string[]): boolean;
 export declare function resolveBuildDecision(builds: EASBuild[]): {
     deployType: Exclude<DeployType, 'none'>;
+    reason: Exclude<DecisionReason, 'no-impact-path'>;
     nativeBuildPending: boolean;
     build: EASBuild | null;
 };
+/**
+ * Without `--base`: the merge base with the PR's base branch on a pull request
+ * (`github.event.before` there is the previous push, not the base), else
+ * `github.event.before`.
+ */
+export declare function defaultBase(head: string | undefined, commandRunner: CommandRunner): Promise<string | undefined>;
+/** Changed sources between the two fingerprints `eas fingerprint:compare --json` prints. */
+export declare function diffFingerprintSources(compare: unknown): string[];
 export declare function decideRelease(input: DecisionInput, commandRunner?: CommandRunner): Promise<ReleaseDecision>;
 export declare function writeDecideGitHubOutput(decision: ReleaseDecision): Promise<void>;

package/dist/doctor.d.ts

@@ -0,0 +1,30 @@
+import type { ReleasePlatform } from './args';
+import type { BuildProfile, EasJson } from './eas-json';
+import { type CommandRunner } from './run';
+export type Finding = {
+    level: 'error' | 'warning';
+    message: string;
+    /** The command or change that fixes it. */
+    fix?: string;
+};
+export type DoctorInput = {
+    profile: string;
+    platform: ReleasePlatform;
+    environment?: string;
+    autoSubmit: boolean;
+    easJson: EasJson | null;
+    buildProfile: BuildProfile | null;
+    /** Also load the app config (`expo config`, slow in large apps). */
+    full?: boolean;
+    readPackageJson?: () => Promise<unknown>;
+    readFile?: (path: string) => Promise<string | null>;
+    env?: Record<string, string | undefined>;
+    bunVersion?: string;
+};
+/** Checks what makes a release fail later, or ship the wrong thing. */
+export declare function runDoctor(input: DoctorInput, runner?: CommandRunner): Promise<Finding[]>;
+/** One line per finding; GitHub annotations inside Actions. */
+export declare function formatFindings(findings: Finding[], options?: {
+    asWarnings?: boolean;
+    github?: boolean;
+}): string;

package/dist/eas-json.d.ts

@@ -0,0 +1,25 @@
+import type { ReleasePlatform } from './args';
+/** The fields of an eas.json build profile that expo-release reads. */
+export type BuildProfile = {
+    channel?: string;
+    environment?: string;
+    env?: Record<string, string>;
+    node?: string;
+    bun?: string;
+};
+export type EasJson = {
+    cli?: {
+        version?: string;
+    };
+    build?: Record<string, Record<string, unknown>>;
+    submit?: Record<string, unknown>;
+};
+/** Reads eas.json from the working directory. eas-cli accepts JSON5 there. */
+export declare function readEasJson(path?: string): Promise<EasJson | null>;
+/** `build.<name>` with `extends` and the platform block applied, or null. */
+export declare function resolveBuildProfile(easJson: EasJson, name: string, platform: ReleasePlatform): BuildProfile | null;
+/**
+ * Puts the profile's `env` into this process, so every EAS command and hook
+ * sees what the EAS build machine sees. Variables already set win.
+ */
+export declare function applyProfileEnv(profile: BuildProfile | null, env?: Record<string, string | undefined>): string[];

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { DEFAULT_IMPACT_PATHS, type CommandName, type DeployType, type Operation, type ReleaseOptions, type ReleasePlatform } from './args';
-export { type DecisionInput, type EASBuild, type ReleaseDecision, decideRelease } from './decide';
+export { type DecisionInput, type DecisionReason, type EASBuild, type FingerprintDiff, type ReleaseDecision, decideRelease } from './decide';
 export { type OperationInput, type OperationResult, operateRelease } from './operate';