@expo/steps 0.0.8 → 0.0.10

package/dist_commonjs/BuildFunction.js.map

@@ -1 +1 @@
-{"version":3,"file":"BuildFunction.js","sourceRoot":"","sources":["../src/BuildFunction.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AAGpC,iDAA2C;AAQ3C,MAAa,aAAa;IASxB,YACmB,GAAqB,EACtC,EACE,EAAE,EACF,IAAI,EACJ,SAAS,EACT,aAAa,EACb,cAAc,EACd,OAAO,EACP,KAAK,GASN;QAjBgB,QAAG,GAAH,GAAG,CAAkB;QAmBtC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEM,+BAA+B,CAAC,EACrC,EAAE,EACF,UAAU,GAAG,EAAE,EACf,gBAAgB,EAChB,KAAK,GAMN;;QACC,MAAM,WAAW,GAAG,MAAA,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,IAAI,CAAC,EAAE,mCAAI,IAAA,SAAM,GAAE,CAAC;QAE9C,MAAM,MAAM,GAAG,MAAA,IAAI,CAAC,aAAa,0CAAE,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;YACtD,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE;gBAC1B,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;aACjC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAA,IAAI,CAAC,cAAc,0CAAE,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;QAExF,OAAO,IAAI,wBAAS,CAAC,IAAI,CAAC,GAAG,EAAE;YAC7B,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,gBAAgB;YAChB,MAAM;YACN,OAAO;YACP,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF;AAtED,sCAsEC","sourcesContent":["import { v4 as uuidv4 } from 'uuid';\n\nimport { BuildPlatform } from './BuildPlatform.js';\nimport { BuildStep } from './BuildStep.js';\nimport { BuildStepContext } from './BuildStepContext.js';\nimport { BuildStepInputCreator } from './BuildStepInput.js';\nimport { BuildStepOutputCreator } from './BuildStepOutput.js';\n\nexport type BuildFunctionById = Record<string, BuildFunction>;\nexport type BuildFunctionCallInputs = Record<string, string>;\n\nexport class BuildFunction {\n  public readonly id?: string;\n  public readonly name?: string;\n  public readonly platforms?: BuildPlatform[];\n  public readonly inputCreators?: BuildStepInputCreator[];\n  public readonly outputCreators?: BuildStepOutputCreator[];\n  public readonly command: string;\n  public readonly shell?: string;\n\n  constructor(\n    private readonly ctx: BuildStepContext,\n    {\n      id,\n      name,\n      platforms,\n      inputCreators,\n      outputCreators,\n      command,\n      shell,\n    }: {\n      id?: string;\n      name?: string;\n      platforms?: BuildPlatform[];\n      inputCreators?: BuildStepInputCreator[];\n      outputCreators?: BuildStepOutputCreator[];\n      command: string;\n      shell?: string;\n    }\n  ) {\n    this.id = id;\n    this.name = name;\n    this.platforms = platforms;\n    this.inputCreators = inputCreators;\n    this.outputCreators = outputCreators;\n    this.command = command;\n    this.shell = shell;\n  }\n\n  public createBuildStepFromFunctionCall({\n    id,\n    callInputs = {},\n    workingDirectory,\n    shell,\n  }: {\n    id?: string;\n    callInputs?: BuildFunctionCallInputs;\n    workingDirectory: string;\n    shell?: string;\n  }): BuildStep {\n    const buildStepId = id ?? this.id ?? uuidv4();\n\n    const inputs = this.inputCreators?.map((inputCreator) => {\n      const input = inputCreator(buildStepId);\n      if (input.id in callInputs) {\n        input.set(callInputs[input.id]);\n      }\n      return input;\n    });\n    const outputs = this.outputCreators?.map((outputCreator) => outputCreator(buildStepId));\n\n    return new BuildStep(this.ctx, {\n      id: buildStepId,\n      name: this.name,\n      command: this.command,\n      workingDirectory,\n      inputs,\n      outputs,\n      shell,\n    });\n  }\n}\n"]}
+{"version":3,"file":"BuildFunction.js","sourceRoot":"","sources":["../src/BuildFunction.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAG5B,iDAA8D;AAQ9D,MAAa,aAAa;IAWxB,YAAY,EACV,SAAS,EACT,EAAE,EACF,IAAI,EACJ,SAAS,EACT,cAAc,EACd,eAAe,EACf,OAAO,EACP,EAAE,EACF,KAAK,GAWN;QACC,IAAA,gBAAM,EAAC,OAAO,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,EAAE,uCAAuC,CAAC,CAAC;QAC3F,IAAA,gBAAM,EAAC,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,CAAC,EAAE,oCAAoC,CAAC,CAAC;QAE3F,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEM,SAAS;QACd,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;IACjF,CAAC;IAEM,+BAA+B,CACpC,GAAqB,EACrB,EACE,EAAE,EACF,IAAI,EACJ,UAAU,GAAG,EAAE,EACf,gBAAgB,EAChB,KAAK,MAOH,EAAE;;QAEN,MAAM,WAAW,GAAG,wBAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,aAAa,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,IAAI,CAAC,IAAI,CAAC;QACxC,MAAM,oBAAoB,GAAG,wBAAS,CAAC,cAAc,CAAC;YACpD,EAAE,EAAE,WAAW;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAA,IAAI,CAAC,cAAc,0CAAE,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE;YACxD,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC9C,IAAI,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE;gBAC1B,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;aACjC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAA,IAAI,CAAC,eAAe,0CAAE,GAAG,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;QAEhG,OAAO,IAAI,wBAAS,CAAC,GAAG,EAAE;YACxB,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,oBAAoB;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,gBAAgB;YAChB,MAAM;YACN,OAAO;YACP,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF;AA/FD,sCA+FC","sourcesContent":["import assert from 'assert';\n\nimport { BuildPlatform } from './BuildPlatform.js';\nimport { BuildStep, BuildStepFunction } from './BuildStep.js';\nimport { BuildStepContext } from './BuildStepContext.js';\nimport { BuildStepInputProvider } from './BuildStepInput.js';\nimport { BuildStepOutputProvider } from './BuildStepOutput.js';\n\nexport type BuildFunctionById = Record<string, BuildFunction>;\nexport type BuildFunctionCallInputs = Record<string, string>;\n\nexport class BuildFunction {\n  public readonly namespace?: string;\n  public readonly id: string;\n  public readonly name?: string;\n  public readonly platforms?: BuildPlatform[];\n  public readonly inputProviders?: BuildStepInputProvider[];\n  public readonly outputProviders?: BuildStepOutputProvider[];\n  public readonly command?: string;\n  public readonly fn?: BuildStepFunction;\n  public readonly shell?: string;\n\n  constructor({\n    namespace,\n    id,\n    name,\n    platforms,\n    inputProviders,\n    outputProviders,\n    command,\n    fn,\n    shell,\n  }: {\n    namespace?: string;\n    id: string;\n    name?: string;\n    platforms?: BuildPlatform[];\n    inputProviders?: BuildStepInputProvider[];\n    outputProviders?: BuildStepOutputProvider[];\n    command?: string;\n    fn?: BuildStepFunction;\n    shell?: string;\n  }) {\n    assert(command !== undefined || fn !== undefined, 'Either command or fn must be defined.');\n    assert(!(command !== undefined && fn !== undefined), 'Command and fn cannot be both set.');\n\n    this.namespace = namespace;\n    this.id = id;\n    this.name = name;\n    this.platforms = platforms;\n    this.inputProviders = inputProviders;\n    this.outputProviders = outputProviders;\n    this.command = command;\n    this.fn = fn;\n    this.shell = shell;\n  }\n\n  public getFullId(): string {\n    return this.namespace === undefined ? this.id : `${this.namespace}/${this.id}`;\n  }\n\n  public createBuildStepFromFunctionCall(\n    ctx: BuildStepContext,\n    {\n      id,\n      name,\n      callInputs = {},\n      workingDirectory,\n      shell,\n    }: {\n      id?: string;\n      name?: string;\n      callInputs?: BuildFunctionCallInputs;\n      workingDirectory?: string;\n      shell?: string;\n    } = {}\n  ): BuildStep {\n    const buildStepId = BuildStep.getNewId(id);\n    const buildStepName = name ?? this.name;\n    const buildStepDisplayName = BuildStep.getDisplayName({\n      id: buildStepId,\n      command: this.command,\n      name: buildStepName,\n    });\n\n    const inputs = this.inputProviders?.map((inputProvider) => {\n      const input = inputProvider(ctx, buildStepId);\n      if (input.id in callInputs) {\n        input.set(callInputs[input.id]);\n      }\n      return input;\n    });\n    const outputs = this.outputProviders?.map((outputProvider) => outputProvider(ctx, buildStepId));\n\n    return new BuildStep(ctx, {\n      id: buildStepId,\n      name: buildStepName,\n      displayName: buildStepDisplayName,\n      command: this.command,\n      fn: this.fn,\n      workingDirectory,\n      inputs,\n      outputs,\n      shell,\n    });\n  }\n}\n"]}

package/dist_commonjs/BuildStep.cjs

@@ -4,15 +4,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BuildStep = exports.BuildStepLogMarker = exports.BuildStepStatus = void 0;
+const assert_1 = __importDefault(require("assert"));
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const uuid_1 = require("uuid");
+const BuildStepInput_js_1 = require("./BuildStepInput.cjs");
+const BuildStepOutput_js_1 = require("./BuildStepOutput.cjs");
 const bin_js_1 = require("./utils/shell/bin.cjs");
 const command_js_1 = require("./utils/shell/command.cjs");
 const BuildTemporaryFiles_js_1 = require("./BuildTemporaryFiles.cjs");
 const spawn_js_1 = require("./utils/shell/spawn.cjs");
 const template_js_1 = require("./utils/template.cjs");
-const BuildStepRuntimeError_js_1 = require("./errors/BuildStepRuntimeError.cjs");
+const errors_js_1 = require("./errors.cjs");
 var BuildStepStatus;
 (function (BuildStepStatus) {
     BuildStepStatus["NEW"] = "new";
@@ -27,66 +30,78 @@ var BuildStepLogMarker;
     BuildStepLogMarker["START_STEP"] = "start-step";
     BuildStepLogMarker["END_STEP"] = "end-step";
 })(BuildStepLogMarker = exports.BuildStepLogMarker || (exports.BuildStepLogMarker = {}));
+// TODO: move to a place common with tests
+const UUID_REGEX = /^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$/;
 class BuildStep {
-    constructor(ctx, { id, name, inputs, outputs, command, workingDirectory, shell, }) {
-        this.ctx = ctx;
+    static getNewId(userDefinedId) {
+        return userDefinedId !== null && userDefinedId !== void 0 ? userDefinedId : (0, uuid_1.v4)();
+    }
+    static getDisplayName({ id, name, command, }) {
+        if (name) {
+            return name;
+        }
+        if (!id.match(UUID_REGEX)) {
+            return id;
+        }
+        if (command) {
+            const splits = command.trim().split('\n');
+            for (const split of splits) {
+                const trimmed = split.trim();
+                if (trimmed && !trimmed.startsWith('#')) {
+                    return trimmed;
+                }
+            }
+        }
+        return id;
+    }
+    constructor(ctx, { id, name, displayName, inputs, outputs, command, fn, workingDirectory: maybeWorkingDirectory, shell, }) {
         this.executed = false;
+        (0, assert_1.default)(command !== undefined || fn !== undefined, 'Either command or fn must be defined.');
+        (0, assert_1.default)(!(command !== undefined && fn !== undefined), 'Command and fn cannot be both set.');
         this.id = id;
         this.name = name;
-        this.displayName = this.getStepDisplayName(name, command);
+        this.displayName = displayName;
         this.inputs = inputs;
         this.outputs = outputs;
-        this.outputById =
-            outputs === undefined
-                ? {}
-                : outputs.reduce((acc, output) => {
-                    acc[output.id] = output;
-                    return acc;
-                }, {});
+        this.inputById = (0, BuildStepInput_js_1.makeBuildStepInputByIdMap)(inputs);
+        this.outputById = (0, BuildStepOutput_js_1.makeBuildStepOutputByIdMap)(outputs);
+        this.fn = fn;
         this.command = command;
-        this.workingDirectory = workingDirectory;
         this.shell = shell !== null && shell !== void 0 ? shell : (0, command_js_1.getDefaultShell)();
         this.status = BuildStepStatus.NEW;
         this.internalId = (0, uuid_1.v4)();
-        this.logger = ctx.logger.child({
+        const logger = ctx.logger.child({
             buildStepInternalId: this.internalId,
             buildStepId: this.id,
             buildStepDisplayName: this.displayName,
         });
+        const workingDirectory = maybeWorkingDirectory !== undefined
+            ? path_1.default.resolve(ctx.workingDirectory, maybeWorkingDirectory)
+            : ctx.workingDirectory;
+        this.ctx = ctx.child({ logger, workingDirectory });
         ctx.registerStep(this);
     }
     async executeAsync(env = process.env) {
         try {
-            this.logger.info({ marker: BuildStepLogMarker.START_STEP }, `Executing build step "${this.id}"`);
+            this.ctx.logger.info({ marker: BuildStepLogMarker.START_STEP }, `Executing build step "${this.displayName}"`);
             this.status = BuildStepStatus.IN_PROGRESS;
-            const command = this.interpolateInputsInCommand(this.command, this.inputs);
-            this.logger.debug(`Interpolated inputs in the command template`);
-            const outputsDir = await (0, BuildTemporaryFiles_js_1.createTemporaryOutputsDirectoryAsync)(this.ctx, this.id);
-            this.logger.debug(`Created temporary directory for step outputs: ${outputsDir}`);
-            const scriptPath = await (0, BuildTemporaryFiles_js_1.saveScriptToTemporaryFileAsync)(this.ctx, this.id, command);
-            this.logger.debug(`Saved script to ${scriptPath}`);
-            const { command: shellCommand, args } = (0, command_js_1.getShellCommandAndArgs)(this.shell, scriptPath);
-            this.logger.debug(`Executing script: ${shellCommand}${args !== undefined ? ` ${args.join(' ')}` : ''}`);
-            await (0, spawn_js_1.spawnAsync)(shellCommand, args !== null && args !== void 0 ? args : [], {
-                cwd: this.workingDirectory,
-                logger: this.logger,
-                env: this.getScriptEnv(env, outputsDir),
-            });
-            this.logger.debug(`Script completed successfully`);
-            await this.collectAndValidateOutputsAsync(outputsDir);
-            this.logger.debug('Finished collecting output paramters');
-            this.logger.info({ marker: BuildStepLogMarker.END_STEP, result: BuildStepStatus.SUCCESS }, `Finished build step "${this.id}" successfully`);
+            if (this.command !== undefined) {
+                await this.executeCommandAsync(env);
+            }
+            else {
+                await this.exectuteFnAsync(env);
+            }
+            this.ctx.logger.info({ marker: BuildStepLogMarker.END_STEP, result: BuildStepStatus.SUCCESS }, `Finished build step "${this.displayName}" successfully`);
             this.status = BuildStepStatus.SUCCESS;
         }
         catch (err) {
-            this.logger.error({ err });
-            this.logger.error({ marker: BuildStepLogMarker.END_STEP, result: BuildStepStatus.FAIL }, `Build step "${this.id}" failed`);
+            this.ctx.logger.error({ err });
+            this.ctx.logger.error({ marker: BuildStepLogMarker.END_STEP, result: BuildStepStatus.FAIL }, `Build step "${this.displayName}" failed`);
             this.status = BuildStepStatus.FAIL;
             throw err;
         }
         finally {
             this.executed = true;
-            await (0, BuildTemporaryFiles_js_1.cleanUpStepTemporaryDirectoriesAsync)(this.ctx, this.id);
         }
     }
     hasOutputParameter(name) {
@@ -94,13 +109,41 @@ class BuildStep {
     }
     getOutputValueByName(name) {
         if (!this.executed) {
-            throw new BuildStepRuntimeError_js_1.BuildStepRuntimeError(`Failed getting output "${name}" from step "${this.id}". The step has not been executed yet.`);
+            throw new errors_js_1.BuildStepRuntimeError(`Failed getting output "${name}" from step "${this.displayName}". The step has not been executed yet.`);
         }
         if (!this.hasOutputParameter(name)) {
-            throw new BuildStepRuntimeError_js_1.BuildStepRuntimeError(`Step "${this.id}" does not have output "${name}"`);
+            throw new errors_js_1.BuildStepRuntimeError(`Step "${this.displayName}" does not have output "${name}".`);
         }
         return this.outputById[name].value;
     }
+    async executeCommandAsync(env) {
+        (0, assert_1.default)(this.command, 'Command must be defined.');
+        try {
+            const command = this.interpolateInputsInCommand(this.command, this.inputs);
+            this.ctx.logger.debug(`Interpolated inputs in the command template`);
+            const outputsDir = await (0, BuildTemporaryFiles_js_1.createTemporaryOutputsDirectoryAsync)(this.ctx, this.id);
+            this.ctx.logger.debug(`Created temporary directory for step outputs: ${outputsDir}`);
+            const scriptPath = await (0, BuildTemporaryFiles_js_1.saveScriptToTemporaryFileAsync)(this.ctx, this.id, command);
+            this.ctx.logger.debug(`Saved script to ${scriptPath}`);
+            const { command: shellCommand, args } = (0, command_js_1.getShellCommandAndArgs)(this.shell, scriptPath);
+            this.ctx.logger.debug(`Executing script: ${shellCommand}${args !== undefined ? ` ${args.join(' ')}` : ''}`);
+            await (0, spawn_js_1.spawnAsync)(shellCommand, args !== null && args !== void 0 ? args : [], {
+                cwd: this.ctx.workingDirectory,
+                logger: this.ctx.logger,
+                env: this.getScriptEnv(env, outputsDir),
+            });
+            this.ctx.logger.debug(`Script completed successfully`);
+            await this.collectAndValidateOutputsAsync(outputsDir);
+            this.ctx.logger.debug('Finished collecting output paramters');
+        }
+        finally {
+            await (0, BuildTemporaryFiles_js_1.cleanUpStepTemporaryDirectoriesAsync)(this.ctx, this.id);
+        }
+    }
+    async exectuteFnAsync(env) {
+        (0, assert_1.default)(this.fn, 'Function (fn) must be defined');
+        await this.fn(this.ctx, { inputs: this.inputById, outputs: this.outputById, env });
+    }
     interpolateInputsInCommand(command, inputs) {
         if (!inputs) {
             return command;
@@ -129,22 +172,22 @@ class BuildStep {
         }
         if (nonDefinedOutputIds.length > 0) {
             const idsString = nonDefinedOutputIds.map((i) => `"${i}"`).join(', ');
-            this.logger.warn(`Some outputs are not defined in step config: ${idsString}`);
+            this.ctx.logger.warn(`Some outputs are not defined in step config: ${idsString}`);
         }
         const nonSetRequiredOutputIds = [];
         for (const output of (_a = this.outputs) !== null && _a !== void 0 ? _a : []) {
             try {
                 const value = output.value;
-                this.logger.debug(`Output parameter "${output.id}" is set to "${value}"`);
+                this.ctx.logger.debug(`Output parameter "${output.id}" is set to "${value}"`);
             }
             catch (err) {
-                this.logger.debug({ err }, `Getting value for output parameter "${output.id}" failed.`);
+                this.ctx.logger.debug({ err }, `Getting value for output parameter "${output.id}" failed.`);
                 nonSetRequiredOutputIds.push(output.id);
             }
         }
         if (nonSetRequiredOutputIds.length > 0) {
             const idsString = nonSetRequiredOutputIds.map((i) => `"${i}"`).join(', ');
-            throw new BuildStepRuntimeError_js_1.BuildStepRuntimeError(`Some required output parameters have not been set: ${idsString}`, { metadata: { ids: nonSetRequiredOutputIds } });
+            throw new errors_js_1.BuildStepRuntimeError(`Some required output parameters have not been set: ${idsString}`, { metadata: { ids: nonSetRequiredOutputIds } });
         }
     }
     getScriptEnv(env, outputsDir) {
@@ -159,21 +202,6 @@ class BuildStep {
             PATH: newPath,
         };
     }
-    getStepDisplayName(name, command) {
-        if (name) {
-            return name;
-        }
-        if (command !== '') {
-            const splits = command.trim().split('\n');
-            for (const split of splits) {
-                const trimmed = split.trim();
-                if (trimmed && !trimmed.startsWith('#')) {
-                    return trimmed;
-                }
-            }
-        }
-        return undefined;
-    }
 }
 exports.BuildStep = BuildStep;
 //# sourceMappingURL=BuildStep.js.map

package/dist_commonjs/BuildStep.d.ts

@@ -1,6 +1,6 @@
 import { BuildStepContext } from './BuildStepContext.js';
-import { BuildStepInput } from './BuildStepInput.js';
-import { BuildStepOutput } from './BuildStepOutput.js';
+import { BuildStepInput, BuildStepInputById } from './BuildStepInput.js';
+import { BuildStepOutput, BuildStepOutputById } from './BuildStepOutput.js';
 import { BuildStepEnv } from './BuildStepEnv.js';
 export declare enum BuildStepStatus {
     NEW = "new",
@@ -14,35 +14,49 @@ export declare enum BuildStepLogMarker {
     START_STEP = "start-step",
     END_STEP = "end-step"
 }
+export type BuildStepFunction = (ctx: BuildStepContext, { inputs, outputs, env, }: {
+    inputs: BuildStepInputById;
+    outputs: BuildStepOutputById;
+    env: BuildStepEnv;
+}) => unknown;
 export declare class BuildStep {
-    private readonly ctx;
     readonly id: string;
     readonly name?: string;
-    readonly displayName?: string;
+    readonly displayName: string;
     readonly inputs?: BuildStepInput[];
     readonly outputs?: BuildStepOutput[];
-    readonly command: string;
-    readonly workingDirectory: string;
+    readonly command?: string;
+    readonly fn?: BuildStepFunction;
     readonly shell: string;
+    readonly ctx: BuildStepContext;
     status: BuildStepStatus;
     private readonly internalId;
-    private readonly logger;
+    private readonly inputById;
     private readonly outputById;
     private executed;
-    constructor(ctx: BuildStepContext, { id, name, inputs, outputs, command, workingDirectory, shell, }: {
+    static getNewId(userDefinedId?: string): string;
+    static getDisplayName({ id, name, command, }: {
         id: string;
         name?: string;
+        command?: string;
+    }): string;
+    constructor(ctx: BuildStepContext, { id, name, displayName, inputs, outputs, command, fn, workingDirectory: maybeWorkingDirectory, shell, }: {
+        id: string;
+        name?: string;
+        displayName: string;
         inputs?: BuildStepInput[];
         outputs?: BuildStepOutput[];
-        command: string;
-        workingDirectory: string;
+        command?: string;
+        fn?: BuildStepFunction;
+        workingDirectory?: string;
         shell?: string;
     });
     executeAsync(env?: BuildStepEnv): Promise<void>;
     hasOutputParameter(name: string): boolean;
     getOutputValueByName(name: string): string | undefined;
+    private executeCommandAsync;
+    private exectuteFnAsync;
     private interpolateInputsInCommand;
     private collectAndValidateOutputsAsync;
     private getScriptEnv;
-    private getStepDisplayName;
 }

package/dist_commonjs/BuildStep.js.map

@@ -1 +1 @@
-{"version":3,"file":"BuildStep.js","sourceRoot":"","sources":["../src/BuildStep.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs/promises';\nimport path from 'path';\n\nimport { bunyan } from '@expo/logger';\nimport { v4 as uuidv4 } from 'uuid';\n\nimport { BuildStepContext } from './BuildStepContext.js';\nimport { BuildStepInput } from './BuildStepInput.js';\nimport { BuildStepOutput } from './BuildStepOutput.js';\nimport { BIN_PATH } from './utils/shell/bin.js';\nimport { getDefaultShell, getShellCommandAndArgs } from './utils/shell/command.js';\nimport {\n  cleanUpStepTemporaryDirectoriesAsync,\n  createTemporaryOutputsDirectoryAsync,\n  saveScriptToTemporaryFileAsync,\n} from './BuildTemporaryFiles.js';\nimport { spawnAsync } from './utils/shell/spawn.js';\nimport { interpolateWithInputs } from './utils/template.js';\nimport { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';\nimport { BuildStepEnv } from './BuildStepEnv.js';\n\nexport enum BuildStepStatus {\n  NEW = 'new',\n  IN_PROGRESS = 'in-progress',\n  CANCELED = 'canceled',\n  FAIL = 'fail',\n  WARNING = 'warning',\n  SUCCESS = 'success',\n}\n\nexport enum BuildStepLogMarker {\n  START_STEP = 'start-step',\n  END_STEP = 'end-step',\n}\n\nexport class BuildStep {\n  public readonly id: string;\n  public readonly name?: string;\n  public readonly displayName?: string;\n  public readonly inputs?: BuildStepInput[];\n  public readonly outputs?: BuildStepOutput[];\n  public readonly command: string;\n  public readonly workingDirectory: string;\n  public readonly shell: string;\n  public status: BuildStepStatus;\n\n  private readonly internalId: string;\n  private readonly logger: bunyan;\n  private readonly outputById: Record<string, BuildStepOutput>;\n  private executed = false;\n\n  constructor(\n    private readonly ctx: BuildStepContext,\n    {\n      id,\n      name,\n      inputs,\n      outputs,\n      command,\n      workingDirectory,\n      shell,\n    }: {\n      id: string;\n      name?: string;\n      inputs?: BuildStepInput[];\n      outputs?: BuildStepOutput[];\n      command: string;\n      workingDirectory: string;\n      shell?: string;\n    }\n  ) {\n    this.id = id;\n    this.name = name;\n    this.displayName = this.getStepDisplayName(name, command);\n    this.inputs = inputs;\n    this.outputs = outputs;\n    this.outputById =\n      outputs === undefined\n        ? {}\n        : outputs.reduce((acc, output) => {\n            acc[output.id] = output;\n            return acc;\n          }, {} as Record<string, BuildStepOutput>);\n    this.command = command;\n    this.workingDirectory = workingDirectory;\n    this.shell = shell ?? getDefaultShell();\n    this.status = BuildStepStatus.NEW;\n\n    this.internalId = uuidv4();\n    this.logger = ctx.logger.child({\n      buildStepInternalId: this.internalId,\n      buildStepId: this.id,\n      buildStepDisplayName: this.displayName,\n    });\n\n    ctx.registerStep(this);\n  }\n\n  public async executeAsync(env: BuildStepEnv = process.env): Promise<void> {\n    try {\n      this.logger.info(\n        { marker: BuildStepLogMarker.START_STEP },\n        `Executing build step \"${this.id}\"`\n      );\n      this.status = BuildStepStatus.IN_PROGRESS;\n\n      const command = this.interpolateInputsInCommand(this.command, this.inputs);\n      this.logger.debug(`Interpolated inputs in the command template`);\n\n      const outputsDir = await createTemporaryOutputsDirectoryAsync(this.ctx, this.id);\n      this.logger.debug(`Created temporary directory for step outputs: ${outputsDir}`);\n\n      const scriptPath = await saveScriptToTemporaryFileAsync(this.ctx, this.id, command);\n      this.logger.debug(`Saved script to ${scriptPath}`);\n\n      const { command: shellCommand, args } = getShellCommandAndArgs(this.shell, scriptPath);\n      this.logger.debug(\n        `Executing script: ${shellCommand}${args !== undefined ? ` ${args.join(' ')}` : ''}`\n      );\n      await spawnAsync(shellCommand, args ?? [], {\n        cwd: this.workingDirectory,\n        logger: this.logger,\n        env: this.getScriptEnv(env, outputsDir),\n      });\n      this.logger.debug(`Script completed successfully`);\n\n      await this.collectAndValidateOutputsAsync(outputsDir);\n      this.logger.debug('Finished collecting output paramters');\n\n      this.logger.info(\n        { marker: BuildStepLogMarker.END_STEP, result: BuildStepStatus.SUCCESS },\n        `Finished build step \"${this.id}\" successfully`\n      );\n      this.status = BuildStepStatus.SUCCESS;\n    } catch (err) {\n      this.logger.error({ err });\n      this.logger.error(\n        { marker: BuildStepLogMarker.END_STEP, result: BuildStepStatus.FAIL },\n        `Build step \"${this.id}\" failed`\n      );\n      this.status = BuildStepStatus.FAIL;\n      throw err;\n    } finally {\n      this.executed = true;\n      await cleanUpStepTemporaryDirectoriesAsync(this.ctx, this.id);\n    }\n  }\n\n  public hasOutputParameter(name: string): boolean {\n    return name in this.outputById;\n  }\n\n  public getOutputValueByName(name: string): string | undefined {\n    if (!this.executed) {\n      throw new BuildStepRuntimeError(\n        `Failed getting output \"${name}\" from step \"${this.id}\". The step has not been executed yet.`\n      );\n    }\n    if (!this.hasOutputParameter(name)) {\n      throw new BuildStepRuntimeError(`Step \"${this.id}\" does not have output \"${name}\"`);\n    }\n    return this.outputById[name].value;\n  }\n\n  private interpolateInputsInCommand(command: string, inputs?: BuildStepInput[]): string {\n    if (!inputs) {\n      return command;\n    }\n    const vars = inputs.reduce((acc, input) => {\n      acc[input.id] = input.value ?? '';\n      return acc;\n    }, {} as Record<string, string>);\n    return interpolateWithInputs(command, vars);\n  }\n\n  private async collectAndValidateOutputsAsync(outputsDir: string): Promise<void> {\n    const files = await fs.readdir(outputsDir);\n\n    const nonDefinedOutputIds: string[] = [];\n    for (const outputId of files) {\n      if (!(outputId in this.outputById)) {\n        nonDefinedOutputIds.push(outputId);\n      } else {\n        const file = path.join(outputsDir, outputId);\n        const rawContents = await fs.readFile(file, 'utf-8');\n        const value = rawContents.trim();\n        this.outputById[outputId].set(value);\n      }\n    }\n\n    if (nonDefinedOutputIds.length > 0) {\n      const idsString = nonDefinedOutputIds.map((i) => `\"${i}\"`).join(', ');\n      this.logger.warn(`Some outputs are not defined in step config: ${idsString}`);\n    }\n\n    const nonSetRequiredOutputIds: string[] = [];\n    for (const output of this.outputs ?? []) {\n      try {\n        const value = output.value;\n        this.logger.debug(`Output parameter \"${output.id}\" is set to \"${value}\"`);\n      } catch (err) {\n        this.logger.debug({ err }, `Getting value for output parameter \"${output.id}\" failed.`);\n        nonSetRequiredOutputIds.push(output.id);\n      }\n    }\n    if (nonSetRequiredOutputIds.length > 0) {\n      const idsString = nonSetRequiredOutputIds.map((i) => `\"${i}\"`).join(', ');\n      throw new BuildStepRuntimeError(\n        `Some required output parameters have not been set: ${idsString}`,\n        { metadata: { ids: nonSetRequiredOutputIds } }\n      );\n    }\n  }\n\n  private getScriptEnv(env: BuildStepEnv, outputsDir: string): Record<string, string> {\n    const currentPath = env.PATH ?? process.env.PATH;\n    const newPath = currentPath ? `${BIN_PATH}:${currentPath}` : BIN_PATH;\n    return {\n      ...env,\n      __EXPO_STEPS_BUILD_ID: this.ctx.buildId,\n      __EXPO_STEPS_OUTPUTS_DIR: outputsDir,\n      __EXPO_STEPS_WORKING_DIRECTORY: this.ctx.workingDirectory,\n      PATH: newPath,\n    };\n  }\n\n  private getStepDisplayName(name: string | undefined, command: string): string | undefined {\n    if (name) {\n      return name;\n    }\n    if (command !== '') {\n      const splits = command.trim().split('\\n');\n      for (const split of splits) {\n        const trimmed = split.trim();\n        if (trimmed && !trimmed.startsWith('#')) {\n          return trimmed;\n        }\n      }\n    }\n    return undefined;\n  }\n}\n"]}
+{"version":3,"file":"BuildStep.js","sourceRoot":"","sources":["../src/BuildStep.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from 'assert';\nimport fs from 'fs/promises';\nimport path from 'path';\n\nimport { v4 as uuidv4 } from 'uuid';\n\nimport { BuildStepContext } from './BuildStepContext.js';\nimport { BuildStepInput, BuildStepInputById, makeBuildStepInputByIdMap } from './BuildStepInput.js';\nimport {\n  BuildStepOutput,\n  BuildStepOutputById,\n  makeBuildStepOutputByIdMap,\n} from './BuildStepOutput.js';\nimport { BIN_PATH } from './utils/shell/bin.js';\nimport { getDefaultShell, getShellCommandAndArgs } from './utils/shell/command.js';\nimport {\n  cleanUpStepTemporaryDirectoriesAsync,\n  createTemporaryOutputsDirectoryAsync,\n  saveScriptToTemporaryFileAsync,\n} from './BuildTemporaryFiles.js';\nimport { spawnAsync } from './utils/shell/spawn.js';\nimport { interpolateWithInputs } from './utils/template.js';\nimport { BuildStepRuntimeError } from './errors.js';\nimport { BuildStepEnv } from './BuildStepEnv.js';\n\nexport enum BuildStepStatus {\n  NEW = 'new',\n  IN_PROGRESS = 'in-progress',\n  CANCELED = 'canceled',\n  FAIL = 'fail',\n  WARNING = 'warning',\n  SUCCESS = 'success',\n}\n\nexport enum BuildStepLogMarker {\n  START_STEP = 'start-step',\n  END_STEP = 'end-step',\n}\n\nexport type BuildStepFunction = (\n  ctx: BuildStepContext,\n  {\n    inputs,\n    outputs,\n    env,\n  }: { inputs: BuildStepInputById; outputs: BuildStepOutputById; env: BuildStepEnv }\n) => unknown;\n\n// TODO: move to a place common with tests\nconst UUID_REGEX =\n  /^[0-9a-fA-F]{8}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{12}$/;\n\nexport class BuildStep {\n  public readonly id: string;\n  public readonly name?: string;\n  public readonly displayName: string;\n  public readonly inputs?: BuildStepInput[];\n  public readonly outputs?: BuildStepOutput[];\n  public readonly command?: string;\n  public readonly fn?: BuildStepFunction;\n  public readonly shell: string;\n  public readonly ctx: BuildStepContext;\n  public status: BuildStepStatus;\n\n  private readonly internalId: string;\n  private readonly inputById: BuildStepInputById;\n  private readonly outputById: BuildStepOutputById;\n  private executed = false;\n\n  public static getNewId(userDefinedId?: string): string {\n    return userDefinedId ?? uuidv4();\n  }\n\n  public static getDisplayName({\n    id,\n    name,\n    command,\n  }: {\n    id: string;\n    name?: string;\n    command?: string;\n  }): string {\n    if (name) {\n      return name;\n    }\n    if (!id.match(UUID_REGEX)) {\n      return id;\n    }\n    if (command) {\n      const splits = command.trim().split('\\n');\n      for (const split of splits) {\n        const trimmed = split.trim();\n        if (trimmed && !trimmed.startsWith('#')) {\n          return trimmed;\n        }\n      }\n    }\n    return id;\n  }\n\n  constructor(\n    ctx: BuildStepContext,\n    {\n      id,\n      name,\n      displayName,\n      inputs,\n      outputs,\n      command,\n      fn,\n      workingDirectory: maybeWorkingDirectory,\n      shell,\n    }: {\n      id: string;\n      name?: string;\n      displayName: string;\n      inputs?: BuildStepInput[];\n      outputs?: BuildStepOutput[];\n      command?: string;\n      fn?: BuildStepFunction;\n      workingDirectory?: string;\n      shell?: string;\n    }\n  ) {\n    assert(command !== undefined || fn !== undefined, 'Either command or fn must be defined.');\n    assert(!(command !== undefined && fn !== undefined), 'Command and fn cannot be both set.');\n\n    this.id = id;\n    this.name = name;\n    this.displayName = displayName;\n    this.inputs = inputs;\n    this.outputs = outputs;\n    this.inputById = makeBuildStepInputByIdMap(inputs);\n    this.outputById = makeBuildStepOutputByIdMap(outputs);\n    this.fn = fn;\n    this.command = command;\n    this.shell = shell ?? getDefaultShell();\n    this.status = BuildStepStatus.NEW;\n\n    this.internalId = uuidv4();\n\n    const logger = ctx.logger.child({\n      buildStepInternalId: this.internalId,\n      buildStepId: this.id,\n      buildStepDisplayName: this.displayName,\n    });\n    const workingDirectory =\n      maybeWorkingDirectory !== undefined\n        ? path.resolve(ctx.workingDirectory, maybeWorkingDirectory)\n        : ctx.workingDirectory;\n    this.ctx = ctx.child({ logger, workingDirectory });\n\n    ctx.registerStep(this);\n  }\n\n  public async executeAsync(env: BuildStepEnv = process.env): Promise<void> {\n    try {\n      this.ctx.logger.info(\n        { marker: BuildStepLogMarker.START_STEP },\n        `Executing build step \"${this.displayName}\"`\n      );\n      this.status = BuildStepStatus.IN_PROGRESS;\n\n      if (this.command !== undefined) {\n        await this.executeCommandAsync(env);\n      } else {\n        await this.exectuteFnAsync(env);\n      }\n\n      this.ctx.logger.info(\n        { marker: BuildStepLogMarker.END_STEP, result: BuildStepStatus.SUCCESS },\n        `Finished build step \"${this.displayName}\" successfully`\n      );\n      this.status = BuildStepStatus.SUCCESS;\n    } catch (err) {\n      this.ctx.logger.error({ err });\n      this.ctx.logger.error(\n        { marker: BuildStepLogMarker.END_STEP, result: BuildStepStatus.FAIL },\n        `Build step \"${this.displayName}\" failed`\n      );\n      this.status = BuildStepStatus.FAIL;\n      throw err;\n    } finally {\n      this.executed = true;\n    }\n  }\n\n  public hasOutputParameter(name: string): boolean {\n    return name in this.outputById;\n  }\n\n  public getOutputValueByName(name: string): string | undefined {\n    if (!this.executed) {\n      throw new BuildStepRuntimeError(\n        `Failed getting output \"${name}\" from step \"${this.displayName}\". The step has not been executed yet.`\n      );\n    }\n    if (!this.hasOutputParameter(name)) {\n      throw new BuildStepRuntimeError(`Step \"${this.displayName}\" does not have output \"${name}\".`);\n    }\n    return this.outputById[name].value;\n  }\n\n  private async executeCommandAsync(env: BuildStepEnv): Promise<void> {\n    assert(this.command, 'Command must be defined.');\n\n    try {\n      const command = this.interpolateInputsInCommand(this.command, this.inputs);\n      this.ctx.logger.debug(`Interpolated inputs in the command template`);\n\n      const outputsDir = await createTemporaryOutputsDirectoryAsync(this.ctx, this.id);\n      this.ctx.logger.debug(`Created temporary directory for step outputs: ${outputsDir}`);\n\n      const scriptPath = await saveScriptToTemporaryFileAsync(this.ctx, this.id, command);\n      this.ctx.logger.debug(`Saved script to ${scriptPath}`);\n\n      const { command: shellCommand, args } = getShellCommandAndArgs(this.shell, scriptPath);\n      this.ctx.logger.debug(\n        `Executing script: ${shellCommand}${args !== undefined ? ` ${args.join(' ')}` : ''}`\n      );\n      await spawnAsync(shellCommand, args ?? [], {\n        cwd: this.ctx.workingDirectory,\n        logger: this.ctx.logger,\n        env: this.getScriptEnv(env, outputsDir),\n      });\n      this.ctx.logger.debug(`Script completed successfully`);\n\n      await this.collectAndValidateOutputsAsync(outputsDir);\n      this.ctx.logger.debug('Finished collecting output paramters');\n    } finally {\n      await cleanUpStepTemporaryDirectoriesAsync(this.ctx, this.id);\n    }\n  }\n\n  private async exectuteFnAsync(env: BuildStepEnv): Promise<void> {\n    assert(this.fn, 'Function (fn) must be defined');\n\n    await this.fn(this.ctx, { inputs: this.inputById, outputs: this.outputById, env });\n  }\n\n  private interpolateInputsInCommand(command: string, inputs?: BuildStepInput[]): string {\n    if (!inputs) {\n      return command;\n    }\n    const vars = inputs.reduce((acc, input) => {\n      acc[input.id] = input.value ?? '';\n      return acc;\n    }, {} as Record<string, string>);\n    return interpolateWithInputs(command, vars);\n  }\n\n  private async collectAndValidateOutputsAsync(outputsDir: string): Promise<void> {\n    const files = await fs.readdir(outputsDir);\n\n    const nonDefinedOutputIds: string[] = [];\n    for (const outputId of files) {\n      if (!(outputId in this.outputById)) {\n        nonDefinedOutputIds.push(outputId);\n      } else {\n        const file = path.join(outputsDir, outputId);\n        const rawContents = await fs.readFile(file, 'utf-8');\n        const value = rawContents.trim();\n        this.outputById[outputId].set(value);\n      }\n    }\n\n    if (nonDefinedOutputIds.length > 0) {\n      const idsString = nonDefinedOutputIds.map((i) => `\"${i}\"`).join(', ');\n      this.ctx.logger.warn(`Some outputs are not defined in step config: ${idsString}`);\n    }\n\n    const nonSetRequiredOutputIds: string[] = [];\n    for (const output of this.outputs ?? []) {\n      try {\n        const value = output.value;\n        this.ctx.logger.debug(`Output parameter \"${output.id}\" is set to \"${value}\"`);\n      } catch (err) {\n        this.ctx.logger.debug({ err }, `Getting value for output parameter \"${output.id}\" failed.`);\n        nonSetRequiredOutputIds.push(output.id);\n      }\n    }\n    if (nonSetRequiredOutputIds.length > 0) {\n      const idsString = nonSetRequiredOutputIds.map((i) => `\"${i}\"`).join(', ');\n      throw new BuildStepRuntimeError(\n        `Some required output parameters have not been set: ${idsString}`,\n        { metadata: { ids: nonSetRequiredOutputIds } }\n      );\n    }\n  }\n\n  private getScriptEnv(env: BuildStepEnv, outputsDir: string): Record<string, string> {\n    const currentPath = env.PATH ?? process.env.PATH;\n    const newPath = currentPath ? `${BIN_PATH}:${currentPath}` : BIN_PATH;\n    return {\n      ...env,\n      __EXPO_STEPS_BUILD_ID: this.ctx.buildId,\n      __EXPO_STEPS_OUTPUTS_DIR: outputsDir,\n      __EXPO_STEPS_WORKING_DIRECTORY: this.ctx.workingDirectory,\n      PATH: newPath,\n    };\n  }\n}\n"]}

package/dist_commonjs/BuildStepContext.cjs

@@ -7,7 +7,7 @@ exports.BuildStepContext = void 0;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const template_js_1 = require("./utils/template.cjs");
-const BuildStepRuntimeError_js_1 = require("./errors/BuildStepRuntimeError.cjs");
+const errors_js_1 = require("./errors.cjs");
 class BuildStepContext {
     constructor(buildId, logger, skipCleanup, workingDirectory) {
         this.buildId = buildId;
@@ -23,10 +23,13 @@ class BuildStepContext {
     getStepOutputValue(path) {
         const { stepId, outputId } = (0, template_js_1.parseOutputPath)(path);
         if (!(stepId in this.stepById)) {
-            throw new BuildStepRuntimeError_js_1.BuildStepRuntimeError(`Step "${stepId}" does not exist.`);
+            throw new errors_js_1.BuildStepRuntimeError(`Step "${stepId}" does not exist.`);
         }
         return this.stepById[stepId].getOutputValueByName(outputId);
     }
+    child({ logger, workingDirectory, } = {}) {
+        return new BuildStepContext(this.buildId, logger !== null && logger !== void 0 ? logger : this.logger, this.skipCleanup, workingDirectory !== null && workingDirectory !== void 0 ? workingDirectory : this.workingDirectory);
+    }
 }
 exports.BuildStepContext = BuildStepContext;
 //# sourceMappingURL=BuildStepContext.js.map

package/dist_commonjs/BuildStepContext.d.ts

@@ -10,4 +10,8 @@ export declare class BuildStepContext {
     constructor(buildId: string, logger: bunyan, skipCleanup: boolean, workingDirectory?: string);
     registerStep(step: BuildStep): void;
     getStepOutputValue(path: string): string | undefined;
+    child({ logger, workingDirectory, }?: {
+        logger?: bunyan;
+        workingDirectory?: string;
+    }): BuildStepContext;
 }

package/dist_commonjs/BuildStepContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"BuildStepContext.js","sourceRoot":"","sources":["../src/BuildStepContext.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAKxB,qDAAsD;AACtD,gFAA0E;AAE1E,MAAa,gBAAgB;IAM3B,YACkB,OAAe,EACf,MAAc,EACd,WAAoB,EACpC,gBAAyB;QAHT,YAAO,GAAP,OAAO,CAAQ;QACf,WAAM,GAAN,MAAM,CAAQ;QACd,gBAAW,GAAX,WAAW,CAAS;QAL9B,aAAQ,GAA8B,EAAE,CAAC;QAQ/C,IAAI,CAAC,oBAAoB,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAI,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;IAC9F,CAAC;IAEM,YAAY,CAAC,IAAe;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAChC,CAAC;IAEM,kBAAkB,CAAC,IAAY;QACpC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAA,6BAAe,EAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE;YAC9B,MAAM,IAAI,gDAAqB,CAAC,SAAS,MAAM,mBAAmB,CAAC,CAAC;SACrE;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;CACF;AA3BD,4CA2BC","sourcesContent":["import os from 'os';\nimport path from 'path';\n\nimport { bunyan } from '@expo/logger';\n\nimport { BuildStep } from './BuildStep.js';\nimport { parseOutputPath } from './utils/template.js';\nimport { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';\n\nexport class BuildStepContext {\n  public readonly baseWorkingDirectory: string;\n  public readonly workingDirectory: string;\n\n  private stepById: Record<string, BuildStep> = {};\n\n  constructor(\n    public readonly buildId: string,\n    public readonly logger: bunyan,\n    public readonly skipCleanup: boolean,\n    workingDirectory?: string\n  ) {\n    this.baseWorkingDirectory = path.join(os.tmpdir(), 'eas-build', buildId);\n    this.workingDirectory = workingDirectory ?? path.join(this.baseWorkingDirectory, 'project');\n  }\n\n  public registerStep(step: BuildStep): void {\n    this.stepById[step.id] = step;\n  }\n\n  public getStepOutputValue(path: string): string | undefined {\n    const { stepId, outputId } = parseOutputPath(path);\n    if (!(stepId in this.stepById)) {\n      throw new BuildStepRuntimeError(`Step \"${stepId}\" does not exist.`);\n    }\n    return this.stepById[stepId].getOutputValueByName(outputId);\n  }\n}\n"]}
+{"version":3,"file":"BuildStepContext.js","sourceRoot":"","sources":["../src/BuildStepContext.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAKxB,qDAAsD;AACtD,2CAAoD;AAEpD,MAAa,gBAAgB;IAM3B,YACkB,OAAe,EACf,MAAc,EACd,WAAoB,EACpC,gBAAyB;QAHT,YAAO,GAAP,OAAO,CAAQ;QACf,WAAM,GAAN,MAAM,CAAQ;QACd,gBAAW,GAAX,WAAW,CAAS;QAL9B,aAAQ,GAA8B,EAAE,CAAC;QAQ/C,IAAI,CAAC,oBAAoB,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAI,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;IAC9F,CAAC;IAEM,YAAY,CAAC,IAAe;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAChC,CAAC;IAEM,kBAAkB,CAAC,IAAY;QACpC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAA,6BAAe,EAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE;YAC9B,MAAM,IAAI,iCAAqB,CAAC,SAAS,MAAM,mBAAmB,CAAC,CAAC;SACrE;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAEM,KAAK,CAAC,EACX,MAAM,EACN,gBAAgB,MAId,EAAE;QACJ,OAAO,IAAI,gBAAgB,CACzB,IAAI,CAAC,OAAO,EACZ,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,IAAI,CAAC,MAAM,EACrB,IAAI,CAAC,WAAW,EAChB,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAI,IAAI,CAAC,gBAAgB,CAC1C,CAAC;IACJ,CAAC;CACF;AA1CD,4CA0CC","sourcesContent":["import os from 'os';\nimport path from 'path';\n\nimport { bunyan } from '@expo/logger';\n\nimport { BuildStep } from './BuildStep.js';\nimport { parseOutputPath } from './utils/template.js';\nimport { BuildStepRuntimeError } from './errors.js';\n\nexport class BuildStepContext {\n  public readonly baseWorkingDirectory: string;\n  public readonly workingDirectory: string;\n\n  private stepById: Record<string, BuildStep> = {};\n\n  constructor(\n    public readonly buildId: string,\n    public readonly logger: bunyan,\n    public readonly skipCleanup: boolean,\n    workingDirectory?: string\n  ) {\n    this.baseWorkingDirectory = path.join(os.tmpdir(), 'eas-build', buildId);\n    this.workingDirectory = workingDirectory ?? path.join(this.baseWorkingDirectory, 'project');\n  }\n\n  public registerStep(step: BuildStep): void {\n    this.stepById[step.id] = step;\n  }\n\n  public getStepOutputValue(path: string): string | undefined {\n    const { stepId, outputId } = parseOutputPath(path);\n    if (!(stepId in this.stepById)) {\n      throw new BuildStepRuntimeError(`Step \"${stepId}\" does not exist.`);\n    }\n    return this.stepById[stepId].getOutputValueByName(outputId);\n  }\n\n  public child({\n    logger,\n    workingDirectory,\n  }: {\n    logger?: bunyan;\n    workingDirectory?: string;\n  } = {}): BuildStepContext {\n    return new BuildStepContext(\n      this.buildId,\n      logger ?? this.logger,\n      this.skipCleanup,\n      workingDirectory ?? this.workingDirectory\n    );\n  }\n}\n"]}

package/dist_commonjs/BuildStepInput.cjs

@@ -1,13 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BuildStepInput = void 0;
-const BuildStepRuntimeError_js_1 = require("./errors/BuildStepRuntimeError.cjs");
+exports.makeBuildStepInputByIdMap = exports.BuildStepInput = void 0;
+const errors_js_1 = require("./errors.cjs");
 const template_js_1 = require("./utils/template.cjs");
 class BuildStepInput {
-    constructor(ctx, { id, stepId, defaultValue, required = true, }) {
+    static createProvider(params) {
+        return (ctx, stepDisplayName) => new BuildStepInput(ctx, { ...params, stepDisplayName });
+    }
+    constructor(ctx, { id, stepDisplayName, defaultValue, required = true, }) {
         this.ctx = ctx;
         this.id = id;
-        this.stepId = stepId;
+        this.stepDisplayName = stepDisplayName;
         this.defaultValue = defaultValue;
         this.required = required;
     }
@@ -15,7 +18,7 @@ class BuildStepInput {
         var _a;
         const rawValue = (_a = this._value) !== null && _a !== void 0 ? _a : this.defaultValue;
         if (this.required && rawValue === undefined) {
-            throw new BuildStepRuntimeError_js_1.BuildStepRuntimeError(`Input parameter "${this.id}" for step "${this.stepId}" is required but it was not set.`);
+            throw new errors_js_1.BuildStepRuntimeError(`Input parameter "${this.id}" for step "${this.stepDisplayName}" is required but it was not set.`);
         }
         if (rawValue === undefined) {
             return rawValue;
@@ -26,11 +29,21 @@ class BuildStepInput {
     }
     set(value) {
         if (this.required && value === undefined) {
-            throw new BuildStepRuntimeError_js_1.BuildStepRuntimeError(`Input parameter "${this.id}" for step "${this.stepId}" is required.`);
+            throw new errors_js_1.BuildStepRuntimeError(`Input parameter "${this.id}" for step "${this.stepDisplayName}" is required.`);
         }
         this._value = value;
         return this;
     }
 }
 exports.BuildStepInput = BuildStepInput;
+function makeBuildStepInputByIdMap(inputs) {
+    if (inputs === undefined) {
+        return {};
+    }
+    return inputs.reduce((acc, input) => {
+        acc[input.id] = input;
+        return acc;
+    }, {});
+}
+exports.makeBuildStepInputByIdMap = makeBuildStepInputByIdMap;
 //# sourceMappingURL=BuildStepInput.js.map

package/dist_commonjs/BuildStepInput.d.ts

@@ -1,18 +1,25 @@
 import { BuildStepContext } from './BuildStepContext.js';
-export type BuildStepInputCreator = (stepId: string) => BuildStepInput;
+export type BuildStepInputById = Record<string, BuildStepInput>;
+export type BuildStepInputProvider = (ctx: BuildStepContext, stepId: string) => BuildStepInput;
 export declare class BuildStepInput {
     private readonly ctx;
     readonly id: string;
-    readonly stepId: string;
+    readonly stepDisplayName: string;
     readonly defaultValue?: string;
     readonly required: boolean;
     private _value?;
-    constructor(ctx: BuildStepContext, { id, stepId, defaultValue, required, }: {
+    static createProvider(params: {
         id: string;
-        stepId: string;
+        defaultValue?: string;
+        required?: boolean;
+    }): BuildStepInputProvider;
+    constructor(ctx: BuildStepContext, { id, stepDisplayName, defaultValue, required, }: {
+        id: string;
+        stepDisplayName: string;
         defaultValue?: string;
         required?: boolean;
     });
     get value(): string | undefined;
     set(value: string | undefined): BuildStepInput;
 }
+export declare function makeBuildStepInputByIdMap(inputs?: BuildStepInput[]): BuildStepInputById;

package/dist_commonjs/BuildStepInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"BuildStepInput.js","sourceRoot":"","sources":["../src/BuildStepInput.ts"],"names":[],"mappings":";;;AACA,gFAA0E;AAC1E,qDAA6D;AAI7D,MAAa,cAAc;IAQzB,YACmB,GAAqB,EACtC,EACE,EAAE,EACF,MAAM,EACN,YAAY,EACZ,QAAQ,GAAG,IAAI,GAMhB;QAXgB,QAAG,GAAH,GAAG,CAAkB;QAatC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK;;QACP,MAAM,QAAQ,GAAG,MAAA,IAAI,CAAC,MAAM,mCAAI,IAAI,CAAC,YAAY,CAAC;QAClD,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC3C,MAAM,IAAI,gDAAqB,CAC7B,oBAAoB,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,MAAM,mCAAmC,CACzF,CAAC;SACH;QAED,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC1B,OAAO,QAAQ,CAAC;SACjB;aAAM;YACL,OAAO,IAAA,oCAAsB,EAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,WAAC,OAAA,MAAA,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,mCAAI,EAAE,CAAA,EAAA,CAAC,CAAC;SAC5F;IACH,CAAC;IAED,GAAG,CAAC,KAAyB;QAC3B,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,KAAK,SAAS,EAAE;YACxC,MAAM,IAAI,gDAAqB,CAC7B,oBAAoB,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,MAAM,gBAAgB,CACtE,CAAC;SACH;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AApDD,wCAoDC","sourcesContent":["import { BuildStepContext } from './BuildStepContext.js';\nimport { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';\nimport { interpolateWithOutputs } from './utils/template.js';\n\nexport type BuildStepInputCreator = (stepId: string) => BuildStepInput;\n\nexport class BuildStepInput {\n  public readonly id: string;\n  public readonly stepId: string;\n  public readonly defaultValue?: string;\n  public readonly required: boolean;\n\n  private _value?: string;\n\n  constructor(\n    private readonly ctx: BuildStepContext,\n    {\n      id,\n      stepId,\n      defaultValue,\n      required = true,\n    }: {\n      id: string;\n      stepId: string;\n      defaultValue?: string;\n      required?: boolean;\n    }\n  ) {\n    this.id = id;\n    this.stepId = stepId;\n    this.defaultValue = defaultValue;\n    this.required = required;\n  }\n\n  get value(): string | undefined {\n    const rawValue = this._value ?? this.defaultValue;\n    if (this.required && rawValue === undefined) {\n      throw new BuildStepRuntimeError(\n        `Input parameter \"${this.id}\" for step \"${this.stepId}\" is required but it was not set.`\n      );\n    }\n\n    if (rawValue === undefined) {\n      return rawValue;\n    } else {\n      return interpolateWithOutputs(rawValue, (path) => this.ctx.getStepOutputValue(path) ?? '');\n    }\n  }\n\n  set(value: string | undefined): BuildStepInput {\n    if (this.required && value === undefined) {\n      throw new BuildStepRuntimeError(\n        `Input parameter \"${this.id}\" for step \"${this.stepId}\" is required.`\n      );\n    }\n    this._value = value;\n    return this;\n  }\n}\n"]}
+{"version":3,"file":"BuildStepInput.js","sourceRoot":"","sources":["../src/BuildStepInput.ts"],"names":[],"mappings":";;;AACA,2CAAoD;AACpD,qDAA6D;AAK7D,MAAa,cAAc;IAQlB,MAAM,CAAC,cAAc,CAAC,MAI5B;QACC,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,YACmB,GAAqB,EACtC,EACE,EAAE,EACF,eAAe,EACf,YAAY,EACZ,QAAQ,GAAG,IAAI,GAMhB;QAXgB,QAAG,GAAH,GAAG,CAAkB;QAatC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK;;QACP,MAAM,QAAQ,GAAG,MAAA,IAAI,CAAC,MAAM,mCAAI,IAAI,CAAC,YAAY,CAAC;QAClD,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC3C,MAAM,IAAI,iCAAqB,CAC7B,oBAAoB,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,eAAe,mCAAmC,CAClG,CAAC;SACH;QAED,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC1B,OAAO,QAAQ,CAAC;SACjB;aAAM;YACL,OAAO,IAAA,oCAAsB,EAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,WAAC,OAAA,MAAA,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,mCAAI,EAAE,CAAA,EAAA,CAAC,CAAC;SAC5F;IACH,CAAC;IAED,GAAG,CAAC,KAAyB;QAC3B,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,KAAK,SAAS,EAAE;YACxC,MAAM,IAAI,iCAAqB,CAC7B,oBAAoB,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,eAAe,gBAAgB,CAC/E,CAAC;SACH;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA5DD,wCA4DC;AAED,SAAgB,yBAAyB,CAAC,MAAyB;IACjE,IAAI,MAAM,KAAK,SAAS,EAAE;QACxB,OAAO,EAAE,CAAC;KACX;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAClC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;QACtB,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAwB,CAAC,CAAC;AAC/B,CAAC;AARD,8DAQC","sourcesContent":["import { BuildStepContext } from './BuildStepContext.js';\nimport { BuildStepRuntimeError } from './errors.js';\nimport { interpolateWithOutputs } from './utils/template.js';\n\nexport type BuildStepInputById = Record<string, BuildStepInput>;\nexport type BuildStepInputProvider = (ctx: BuildStepContext, stepId: string) => BuildStepInput;\n\nexport class BuildStepInput {\n  public readonly id: string;\n  public readonly stepDisplayName: string;\n  public readonly defaultValue?: string;\n  public readonly required: boolean;\n\n  private _value?: string;\n\n  public static createProvider(params: {\n    id: string;\n    defaultValue?: string;\n    required?: boolean;\n  }): BuildStepInputProvider {\n    return (ctx, stepDisplayName) => new BuildStepInput(ctx, { ...params, stepDisplayName });\n  }\n\n  constructor(\n    private readonly ctx: BuildStepContext,\n    {\n      id,\n      stepDisplayName,\n      defaultValue,\n      required = true,\n    }: {\n      id: string;\n      stepDisplayName: string;\n      defaultValue?: string;\n      required?: boolean;\n    }\n  ) {\n    this.id = id;\n    this.stepDisplayName = stepDisplayName;\n    this.defaultValue = defaultValue;\n    this.required = required;\n  }\n\n  get value(): string | undefined {\n    const rawValue = this._value ?? this.defaultValue;\n    if (this.required && rawValue === undefined) {\n      throw new BuildStepRuntimeError(\n        `Input parameter \"${this.id}\" for step \"${this.stepDisplayName}\" is required but it was not set.`\n      );\n    }\n\n    if (rawValue === undefined) {\n      return rawValue;\n    } else {\n      return interpolateWithOutputs(rawValue, (path) => this.ctx.getStepOutputValue(path) ?? '');\n    }\n  }\n\n  set(value: string | undefined): BuildStepInput {\n    if (this.required && value === undefined) {\n      throw new BuildStepRuntimeError(\n        `Input parameter \"${this.id}\" for step \"${this.stepDisplayName}\" is required.`\n      );\n    }\n    this._value = value;\n    return this;\n  }\n}\n\nexport function makeBuildStepInputByIdMap(inputs?: BuildStepInput[]): BuildStepInputById {\n  if (inputs === undefined) {\n    return {};\n  }\n  return inputs.reduce((acc, input) => {\n    acc[input.id] = input;\n    return acc;\n  }, {} as BuildStepInputById);\n}\n"]}

package/dist_commonjs/BuildStepOutput.cjs

@@ -1,29 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BuildStepOutput = void 0;
-const BuildStepRuntimeError_js_1 = require("./errors/BuildStepRuntimeError.cjs");
+exports.makeBuildStepOutputByIdMap = exports.BuildStepOutput = void 0;
+const errors_js_1 = require("./errors.cjs");
 class BuildStepOutput {
+    static createProvider(params) {
+        return (ctx, stepDisplayName) => new BuildStepOutput(ctx, { ...params, stepDisplayName });
+    }
     constructor(
     // @ts-expect-error ctx is not used in this class but let's keep it here for consistency
-    ctx, { id, stepId, required = true }) {
+    ctx, { id, stepDisplayName, required = true, }) {
         this.ctx = ctx;
         this.id = id;
-        this.stepId = stepId;
+        this.stepDisplayName = stepDisplayName;
         this.required = required;
     }
     get value() {
         if (this.required && this._value === undefined) {
-            throw new BuildStepRuntimeError_js_1.BuildStepRuntimeError(`Output parameter "${this.id}" for step "${this.stepId}" is required but it was not set.`);
+            throw new errors_js_1.BuildStepRuntimeError(`Output parameter "${this.id}" for step "${this.stepDisplayName}" is required but it was not set.`);
         }
         return this._value;
     }
     set(value) {
         if (this.required && value === undefined) {
-            throw new BuildStepRuntimeError_js_1.BuildStepRuntimeError(`Output parameter "${this.id}" for step "${this.stepId}" is required.`);
+            throw new errors_js_1.BuildStepRuntimeError(`Output parameter "${this.id}" for step "${this.stepDisplayName}" is required.`);
         }
         this._value = value;
         return this;
     }
 }
 exports.BuildStepOutput = BuildStepOutput;
+function makeBuildStepOutputByIdMap(outputs) {
+    if (outputs === undefined) {
+        return {};
+    }
+    return outputs.reduce((acc, output) => {
+        acc[output.id] = output;
+        return acc;
+    }, {});
+}
+exports.makeBuildStepOutputByIdMap = makeBuildStepOutputByIdMap;
 //# sourceMappingURL=BuildStepOutput.js.map

package/dist_commonjs/BuildStepOutput.d.ts

@@ -1,16 +1,22 @@
 import { BuildStepContext } from './BuildStepContext.js';
-export type BuildStepOutputCreator = (stepId: string) => BuildStepOutput;
+export type BuildStepOutputById = Record<string, BuildStepOutput>;
+export type BuildStepOutputProvider = (ctx: BuildStepContext, stepDisplayName: string) => BuildStepOutput;
 export declare class BuildStepOutput {
     private readonly ctx;
     readonly id: string;
-    readonly stepId: string;
+    readonly stepDisplayName: string;
     readonly required: boolean;
     private _value?;
-    constructor(ctx: BuildStepContext, { id, stepId, required }: {
+    static createProvider(params: {
         id: string;
-        stepId: string;
+        required?: boolean;
+    }): BuildStepOutputProvider;
+    constructor(ctx: BuildStepContext, { id, stepDisplayName, required, }: {
+        id: string;
+        stepDisplayName: string;
         required?: boolean;
     });
     get value(): string | undefined;
     set(value: string | undefined): BuildStepOutput;
 }
+export declare function makeBuildStepOutputByIdMap(outputs?: BuildStepOutput[]): BuildStepOutputById;