@expo/eas-build-job 18.0.1 → 18.2.0

package/dist/android.d.ts

@@ -1,6 +1,6 @@
 import { LoggerLevel } from '@expo/logger';
 import Joi from 'joi';
-import { ArchiveSource, BuildMode, BuildTrigger, Cache, Env, EnvironmentSecret, Platform, StaticWorkflowInterpolationContext, Workflow } from './common';
+import { ArchiveSource, BuildMode, BuildTrigger, Cache, Env, EnvironmentSecret, Hooks, Platform, StaticWorkflowInterpolationContext, Workflow } from './common';
 import { Step } from './step';
 export interface Keystore {
     dataBase64: string;
@@ -63,6 +63,7 @@ export interface Job {
     customBuildConfig?: {
         path: string;
     };
+    hooks?: Hooks;
     steps?: Step[];
     outputs?: Record<string, string>;
     experimental?: {

package/dist/android.js

@@ -70,6 +70,7 @@ exports.JobSchema = joi_1.default.object({
     applicationArchivePath: joi_1.default.string(),
     buildType: joi_1.default.string().valid(...Object.values(BuildType)),
     username: joi_1.default.string(),
+    hooks: common_1.HooksSchema,
     experimental: joi_1.default.object({
         prebuildCommand: joi_1.default.string(),
     }),

package/dist/common.d.ts

@@ -1,6 +1,7 @@
 import Joi from 'joi';
 import { z } from 'zod';
 import { BuildPhase, BuildPhaseResult } from './logs';
+import { Step } from './step';
 export declare enum BuildMode {
     BUILD = "build",
     RESIGN = "resign",
@@ -93,6 +94,39 @@ export declare const EnvironmentSecretZ: z.ZodObject<{
     value: z.ZodString;
     type: z.ZodEnum<typeof EnvironmentSecretType>;
 }, z.core.$strip>;
+export type Hooks = Record<string, Step[]>;
+export declare const HooksSchema: Joi.ObjectSchema<any>;
+export declare const HooksZ: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    if: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    working_directory: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    __metrics_id: z.ZodOptional<z.ZodString>;
+    run: z.ZodString;
+    shell: z.ZodOptional<z.ZodString>;
+    outputs: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodCodec<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>, z.ZodObject<{
+        name: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>]>>>;
+    uses: z.ZodOptional<z.ZodNever>;
+    with: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    if: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    working_directory: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    __metrics_id: z.ZodOptional<z.ZodString>;
+    uses: z.ZodString;
+    with: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    run: z.ZodOptional<z.ZodNever>;
+    shell: z.ZodOptional<z.ZodNever>;
+    outputs: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>]>>>;
 export interface Cache {
     disabled: boolean;
     clear: boolean;

package/dist/common.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EasCliNpmTags = exports.CustomBuildConfigSchema = exports.StaticWorkflowInterpolationContextZ = exports.CacheSchema = exports.EnvironmentSecretZ = exports.EnvironmentSecretsSchema = exports.EnvironmentSecretType = exports.EnvSchema = exports.ArchiveSourceSchemaZ = exports.ArchiveSourceSchema = exports.BuildTrigger = exports.ArchiveSourceType = exports.Platform = exports.Workflow = exports.BuildMode = void 0;
+exports.EasCliNpmTags = exports.CustomBuildConfigSchema = exports.StaticWorkflowInterpolationContextZ = exports.CacheSchema = exports.HooksZ = exports.HooksSchema = exports.EnvironmentSecretZ = exports.EnvironmentSecretsSchema = exports.EnvironmentSecretType = exports.EnvSchema = exports.ArchiveSourceSchemaZ = exports.ArchiveSourceSchema = exports.BuildTrigger = exports.ArchiveSourceType = exports.Platform = exports.Workflow = exports.BuildMode = void 0;
 const joi_1 = __importDefault(require("joi"));
 const zod_1 = require("zod");
 const step_1 = require("./step");
@@ -113,6 +113,16 @@ exports.EnvironmentSecretZ = zod_1.z.object({
     value: zod_1.z.string(),
     type: zod_1.z.nativeEnum(EnvironmentSecretType),
 });
+exports.HooksSchema = joi_1.default.object().pattern(joi_1.default.string(), joi_1.default.array()
+    .items(joi_1.default.any())
+    .required()
+    .custom(steps => {
+    if (steps.length === 0) {
+        return steps;
+    }
+    return (0, step_1.validateSteps)(steps);
+}, 'steps validation'));
+exports.HooksZ = zod_1.z.record(zod_1.z.string(), zod_1.z.array(step_1.StepZ));
 exports.CacheSchema = joi_1.default.object({
     disabled: joi_1.default.boolean().default(false),
     clear: joi_1.default.boolean().default(false),

package/dist/errors.d.ts

@@ -14,29 +14,43 @@ export interface ExternalBuildError {
     docsUrl?: string;
     buildPhase?: BuildPhase;
 }
-interface BuildErrorDetails {
+export type ErrorMetadata = Record<string, unknown>;
+interface ExpoErrorDetails<TMetadata extends ErrorMetadata = ErrorMetadata> {
     errorCode: string;
-    userFacingMessage: string;
-    userFacingErrorCode: string;
+    trackingCode?: string;
     docsUrl?: string;
-    innerError?: Error;
     buildPhase?: BuildPhase;
+    /**
+     * Metadata object for the error. Used internally for Sentry/logging/debugging.
+     * It is not included in the external build error payload.
+     */
+    metadata?: TMetadata;
+    /**
+     * Underlying error that caused this error to be created. Used internally to
+     * propagate blame stack traces to the response.
+     */
+    cause?: unknown;
 }
-export declare class BuildError extends Error {
+export declare abstract class ExpoError<TMetadata extends ErrorMetadata = ErrorMetadata> extends Error {
     errorCode: string;
-    userFacingMessage: string;
-    userFacingErrorCode: string;
+    trackingCode?: string;
     docsUrl?: string;
-    innerError?: Error;
+    readonly metadata?: TMetadata;
     buildPhase?: BuildPhase;
-    constructor(message: string, details: BuildErrorDetails);
+    constructor(message: string, details: ExpoErrorDetails<TMetadata>);
     format(): ExternalBuildError;
 }
-export declare class UserFacingError extends Error {
+export declare class BuildError<TMetadata extends ErrorMetadata = ErrorMetadata> extends ExpoError<TMetadata> {
+    constructor(message: string, details: ExpoErrorDetails<TMetadata>);
+}
+export declare class UserFacingError<TMetadata extends ErrorMetadata = ErrorMetadata> extends ExpoError<TMetadata> {
     errorCode: string;
     message: string;
-    docsUrl?: string | undefined;
-    constructor(errorCode: string, message: string, docsUrl?: string | undefined);
+    constructor(errorCode: string, message: string, options?: {
+        docsUrl?: string;
+        metadata?: TMetadata;
+        cause?: unknown;
+    });
 }
 export declare class UnknownError extends UserFacingError {
     constructor(buildPhase?: BuildPhase);

package/dist/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CredentialsDistCertMismatchError = exports.UnknownCustomBuildError = exports.UnknownBuildError = exports.UnknownError = exports.UserFacingError = exports.BuildError = exports.ErrorCode = void 0;
+exports.CredentialsDistCertMismatchError = exports.UnknownCustomBuildError = exports.UnknownBuildError = exports.UnknownError = exports.UserFacingError = exports.BuildError = exports.ExpoError = exports.ErrorCode = void 0;
 const logs_1 = require("./logs");
 var ErrorCode;
 (function (ErrorCode) {
@@ -12,41 +12,50 @@ var ErrorCode;
     ErrorCode["UNKNOWN_GRADLE_ERROR"] = "EAS_BUILD_UNKNOWN_GRADLE_ERROR";
     ErrorCode["BUILD_TIMEOUT_ERROR"] = "EAS_BUILD_TIMEOUT_ERROR";
 })(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
-class BuildError extends Error {
+class ExpoError extends Error {
     errorCode;
-    userFacingMessage;
-    userFacingErrorCode;
+    // Internal-only classification used for Sentry, analytics, and worker internalErrorCode.
+    // The public error saved on builds and job runs is always `errorCode`.
+    trackingCode;
     docsUrl;
-    innerError;
+    metadata;
     buildPhase;
     constructor(message, details) {
-        super(message);
+        super(message, { cause: details.cause });
         this.errorCode = details.errorCode;
-        this.userFacingErrorCode = details.userFacingErrorCode;
-        this.userFacingMessage = details.userFacingMessage;
+        this.trackingCode = details.trackingCode;
         this.docsUrl = details.docsUrl;
-        this.innerError = details.innerError;
+        this.metadata = details.metadata;
         this.buildPhase = details.buildPhase;
     }
     format() {
         return {
-            errorCode: this.userFacingErrorCode,
-            message: this.userFacingMessage,
+            errorCode: this.errorCode,
+            message: this.message,
             docsUrl: this.docsUrl,
             buildPhase: this.buildPhase,
         };
     }
 }
+exports.ExpoError = ExpoError;
+class BuildError extends ExpoError {
+    constructor(message, details) {
+        super(message, details);
+    }
+}
 exports.BuildError = BuildError;
-class UserFacingError extends Error {
+class UserFacingError extends ExpoError {
     errorCode;
     message;
-    docsUrl;
-    constructor(errorCode, message, docsUrl) {
-        super(message);
+    constructor(errorCode, message, options) {
+        super(message, {
+            errorCode,
+            docsUrl: options?.docsUrl,
+            metadata: options?.metadata,
+            cause: options?.cause,
+        });
         this.errorCode = errorCode;
         this.message = message;
-        this.docsUrl = docsUrl;
     }
 }
 exports.UserFacingError = UserFacingError;
@@ -64,8 +73,6 @@ class UnknownBuildError extends BuildError {
         const message = 'Unknown error. See logs for more information.';
         super(message, {
             errorCode,
-            userFacingMessage: message,
-            userFacingErrorCode: errorCode,
         });
     }
 }
@@ -76,8 +83,6 @@ class UnknownCustomBuildError extends BuildError {
         const message = 'Unknown custom build error. See logs for more information.';
         super(message, {
             errorCode,
-            userFacingMessage: message,
-            userFacingErrorCode: errorCode,
         });
     }
 }

package/dist/generic.d.ts

@@ -107,6 +107,37 @@ export declare namespace Generic {
         }, z.core.$strip>>;
         initiatingUserId: z.ZodString;
         appId: z.ZodString;
+        hooks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            if: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            working_directory: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            __metrics_id: z.ZodOptional<z.ZodString>;
+            run: z.ZodString;
+            shell: z.ZodOptional<z.ZodString>;
+            outputs: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodCodec<z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>>, z.ZodObject<{
+                name: z.ZodString;
+                required: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>]>>>;
+            uses: z.ZodOptional<z.ZodNever>;
+            with: z.ZodOptional<z.ZodNever>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            if: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            working_directory: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            __metrics_id: z.ZodOptional<z.ZodString>;
+            uses: z.ZodString;
+            with: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            run: z.ZodOptional<z.ZodNever>;
+            shell: z.ZodOptional<z.ZodNever>;
+            outputs: z.ZodOptional<z.ZodNever>;
+        }, z.core.$strip>]>>>>;
         steps: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             if: z.ZodOptional<z.ZodString>;
@@ -245,6 +276,37 @@ export declare namespace Generic {
         }, z.core.$strip>>>;
         initiatingUserId: z.ZodOptional<z.ZodString>;
         appId: z.ZodOptional<z.ZodString>;
+        hooks: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            if: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            working_directory: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            __metrics_id: z.ZodOptional<z.ZodString>;
+            run: z.ZodString;
+            shell: z.ZodOptional<z.ZodString>;
+            outputs: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodCodec<z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>>, z.ZodObject<{
+                name: z.ZodString;
+                required: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>]>>>;
+            uses: z.ZodOptional<z.ZodNever>;
+            with: z.ZodOptional<z.ZodNever>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            if: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            working_directory: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            __metrics_id: z.ZodOptional<z.ZodString>;
+            uses: z.ZodString;
+            with: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            run: z.ZodOptional<z.ZodNever>;
+            shell: z.ZodOptional<z.ZodNever>;
+            outputs: z.ZodOptional<z.ZodNever>;
+        }, z.core.$strip>]>>>>>;
         steps: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             if: z.ZodOptional<z.ZodString>;

package/dist/generic.js

@@ -38,6 +38,7 @@ var Generic;
         workflowInterpolationContext: common_1.StaticWorkflowInterpolationContextZ.optional(),
         initiatingUserId: zod_1.z.string(),
         appId: zod_1.z.string(),
+        hooks: common_1.HooksZ.optional(),
         steps: zod_1.z.array(step_1.StepZ).min(1),
         outputs: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
     });

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * as Android from './android';
 export * as Ios from './ios';
-export { ArchiveSourceType, ArchiveSource, ArchiveSourceSchemaZ, BuildMode, BuildPhaseStats, BuildTrigger, EasCliNpmTags, Env, EnvironmentSecret, EnvironmentSecretType, Workflow, Platform, Cache, WorkflowInterpolationContext, } from './common';
+export { ArchiveSourceType, ArchiveSource, ArchiveSourceSchemaZ, BuildMode, BuildPhaseStats, BuildTrigger, EasCliNpmTags, Env, EnvironmentSecret, EnvironmentSecretType, Hooks, Workflow, Platform, Cache, WorkflowInterpolationContext, } from './common';
 export { Metadata, sanitizeMetadata } from './metadata';
 export * from './job';
 export * from './logs';

package/dist/ios.d.ts

@@ -1,6 +1,6 @@
 import { LoggerLevel } from '@expo/logger';
 import Joi from 'joi';
-import { ArchiveSource, BuildMode, BuildTrigger, Cache, Env, EnvironmentSecret, Platform, StaticWorkflowInterpolationContext, Workflow } from './common';
+import { ArchiveSource, BuildMode, BuildTrigger, Cache, Env, EnvironmentSecret, Hooks, Platform, StaticWorkflowInterpolationContext, Workflow } from './common';
 import { Step } from './step';
 export type DistributionType = 'store' | 'internal' | 'simulator';
 export interface TargetCredentials {
@@ -68,6 +68,7 @@ export interface Job {
     customBuildConfig?: {
         path: string;
     };
+    hooks?: Hooks;
     steps?: Step[];
     outputs?: Record<string, string>;
     experimental?: {

package/dist/ios.js

@@ -89,6 +89,7 @@ exports.JobSchema = joi_1.default.object({
     buildConfiguration: joi_1.default.string(),
     applicationArchivePath: joi_1.default.string(),
     username: joi_1.default.string(),
+    hooks: common_1.HooksSchema,
     experimental: joi_1.default.object({
         prebuildCommand: joi_1.default.string(),
     }),

package/dist/logs.d.ts

@@ -16,6 +16,7 @@ export declare enum BuildPhase {
     EAS_BUILD_INTERNAL = "EAS_BUILD_INTERNAL",
     PREBUILD = "PREBUILD",
     PREPARE_CREDENTIALS = "PREPARE_CREDENTIALS",
+    CONFIGURE_ANDROID_VERSION = "CONFIGURE_ANDROID_VERSION",
     CALCULATE_EXPO_UPDATES_RUNTIME_VERSION = "CALCULATE_EXPO_UPDATES_RUNTIME_VERSION",
     CONFIGURE_EXPO_UPDATES = "CONFIGURE_EXPO_UPDATES",
     EAGER_BUNDLE = "EAGER_BUNDLE",

package/dist/logs.js

@@ -20,6 +20,7 @@ var BuildPhase;
     BuildPhase["EAS_BUILD_INTERNAL"] = "EAS_BUILD_INTERNAL";
     BuildPhase["PREBUILD"] = "PREBUILD";
     BuildPhase["PREPARE_CREDENTIALS"] = "PREPARE_CREDENTIALS";
+    BuildPhase["CONFIGURE_ANDROID_VERSION"] = "CONFIGURE_ANDROID_VERSION";
     BuildPhase["CALCULATE_EXPO_UPDATES_RUNTIME_VERSION"] = "CALCULATE_EXPO_UPDATES_RUNTIME_VERSION";
     BuildPhase["CONFIGURE_EXPO_UPDATES"] = "CONFIGURE_EXPO_UPDATES";
     BuildPhase["EAGER_BUNDLE"] = "EAGER_BUNDLE";
@@ -78,6 +79,7 @@ exports.buildPhaseDisplayName = {
     [BuildPhase.EAS_BUILD_INTERNAL]: 'Resolve build configuration',
     [BuildPhase.PREBUILD]: 'Prebuild',
     [BuildPhase.PREPARE_CREDENTIALS]: 'Prepare credentials',
+    [BuildPhase.CONFIGURE_ANDROID_VERSION]: 'Configure Android version',
     [BuildPhase.CALCULATE_EXPO_UPDATES_RUNTIME_VERSION]: 'Calculate expo-updates runtime version',
     [BuildPhase.CONFIGURE_EXPO_UPDATES]: 'Configure expo-updates',
     [BuildPhase.EAGER_BUNDLE]: 'Bundle JavaScript',
@@ -135,6 +137,7 @@ exports.buildPhaseWebsiteId = {
     [BuildPhase.EAS_BUILD_INTERNAL]: 'resolve-build-configuration',
     [BuildPhase.PREBUILD]: 'prebuild',
     [BuildPhase.PREPARE_CREDENTIALS]: 'prepare-credentials',
+    [BuildPhase.CONFIGURE_ANDROID_VERSION]: 'configure-android-version',
     [BuildPhase.CALCULATE_EXPO_UPDATES_RUNTIME_VERSION]: 'calculate-expo-updates-runtime-version',
     [BuildPhase.CONFIGURE_EXPO_UPDATES]: 'configure-expo-updates',
     [BuildPhase.EAGER_BUNDLE]: 'eager-bundle',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/eas-build-job",
-  "version": "18.0.1",
+  "version": "18.2.0",
   "bugs": "https://github.com/expo/eas-cli/issues",
   "license": "MIT",
   "author": "Expo <support@expo.io>",
@@ -37,5 +37,5 @@
     "ts-jest": "^29.1.4",
     "typescript": "^5.5.4"
   },
-  "gitHead": "772d4dd654a71b0d88e73341106d417222dd401e"
+  "gitHead": "5f400d77660990422c6976a65dfb41f99374c5cc"
 }