@expo/steps 0.0.1

package/dist_esm/BuildConfig.d.ts

@@ -0,0 +1,25 @@
+import Joi from 'joi';
+export interface BuildConfig {
+    build: {
+        name?: string;
+        steps: BuildStepConfig[];
+    };
+}
+export type BuildStepInputsConfig = Record<string, string>;
+export type BuildStepOutputsConfig = (string | {
+    name: string;
+    required?: boolean;
+})[];
+export type BuildStepConfig = string | {
+    run: string | {
+        id?: string;
+        inputs?: BuildStepInputsConfig;
+        outputs?: BuildStepOutputsConfig;
+        name?: string;
+        workingDirectory?: string;
+        shell?: string;
+        command: string;
+    };
+};
+export declare const BuildConfigSchema: Joi.ObjectSchema<BuildConfig>;
+export declare function validateBuildConfig(rawConfig: object): BuildConfig;

package/dist_esm/BuildConfig.js

@@ -0,0 +1,43 @@
+import Joi from 'joi';
+import { BuildConfigError } from './errors/BuildConfigError.js';
+export const BuildConfigSchema = Joi.object({
+    build: Joi.object({
+        name: Joi.string(),
+        steps: Joi.array()
+            .items(Joi.object({
+            run: Joi.alternatives().conditional('run', {
+                is: Joi.string(),
+                then: Joi.string().required(),
+                otherwise: Joi.object({
+                    id: Joi.string(),
+                    inputs: Joi.object().pattern(Joi.string(), Joi.string()),
+                    outputs: Joi.array().items(Joi.alternatives().try(Joi.string().required(), Joi.object({
+                        name: Joi.string().required(),
+                        required: Joi.boolean(),
+                    }).required())),
+                    name: Joi.string(),
+                    workingDirectory: Joi.string(),
+                    shell: Joi.string(),
+                    command: Joi.string().required(),
+                })
+                    .rename('working_directory', 'workingDirectory')
+                    .required(),
+            }),
+        }))
+            .required(),
+    }).required(),
+}).required();
+export function validateBuildConfig(rawConfig) {
+    const { error, value } = BuildConfigSchema.validate(rawConfig, {
+        allowUnknown: false,
+        abortEarly: false,
+    });
+    if (error) {
+        const errorMessage = error.details.map(({ message }) => message).join(', ');
+        throw new BuildConfigError(errorMessage, { cause: error });
+    }
+    else {
+        return value;
+    }
+}
+//# sourceMappingURL=BuildConfig.js.map

package/dist_esm/BuildConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildConfig.js","sourceRoot":"","sources":["../src/BuildConfig.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAmChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,CAAc;IACvD,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE;QAClB,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;aACf,KAAK,CACJ,GAAG,CAAC,MAAM,CAAC;YACT,GAAG,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE;gBACzC,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE;gBAChB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC;oBACpB,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE;oBAChB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;oBACxD,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,CACxB,GAAG,CAAC,YAAY,EAAE,CAAC,GAAG,CACpB,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EACvB,GAAG,CAAC,MAAM,CAAC;wBACT,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;wBAC7B,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE;qBACxB,CAAC,CAAC,QAAQ,EAAE,CACd,CACF;oBACD,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE;oBAClB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE;oBAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;oBACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBACjC,CAAC;qBACC,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;qBAC/C,QAAQ,EAAE;aACd,CAAC;SACH,CAAC,CACH;aACA,QAAQ,EAAE;KACd,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEd,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,SAAS,EAAE;QAC7D,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IACH,IAAI,KAAK,EAAE;QACT,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,MAAM,IAAI,gBAAgB,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;KAC5D;SAAM;QACL,OAAO,KAAK,CAAC;KACd;AACH,CAAC","sourcesContent":["import Joi from 'joi';\n\nimport { BuildConfigError } from './errors/BuildConfigError.js';\n\nexport interface BuildConfig {\n  build: {\n    name?: string;\n    steps: BuildStepConfig[];\n  };\n}\n\nexport type BuildStepInputsConfig = Record<string, string>;\n\nexport type BuildStepOutputsConfig = (\n  | string\n  | {\n      name: string;\n      required?: boolean;\n    }\n)[];\n\nexport type BuildStepConfig =\n  | string\n  | {\n      run:\n        | string\n        | {\n            id?: string;\n            inputs?: BuildStepInputsConfig;\n            outputs?: BuildStepOutputsConfig;\n            name?: string;\n            workingDirectory?: string;\n            shell?: string;\n            command: string;\n          };\n    };\n\nexport const BuildConfigSchema = Joi.object<BuildConfig>({\n  build: Joi.object({\n    name: Joi.string(),\n    steps: Joi.array()\n      .items(\n        Joi.object({\n          run: Joi.alternatives().conditional('run', {\n            is: Joi.string(),\n            then: Joi.string().required(),\n            otherwise: Joi.object({\n              id: Joi.string(),\n              inputs: Joi.object().pattern(Joi.string(), Joi.string()),\n              outputs: Joi.array().items(\n                Joi.alternatives().try(\n                  Joi.string().required(),\n                  Joi.object({\n                    name: Joi.string().required(),\n                    required: Joi.boolean(),\n                  }).required()\n                )\n              ),\n              name: Joi.string(),\n              workingDirectory: Joi.string(),\n              shell: Joi.string(),\n              command: Joi.string().required(),\n            })\n              .rename('working_directory', 'workingDirectory')\n              .required(),\n          }),\n        })\n      )\n      .required(),\n  }).required(),\n}).required();\n\nexport function validateBuildConfig(rawConfig: object): BuildConfig {\n  const { error, value } = BuildConfigSchema.validate(rawConfig, {\n    allowUnknown: false,\n    abortEarly: false,\n  });\n  if (error) {\n    const errorMessage = error.details.map(({ message }) => message).join(', ');\n    throw new BuildConfigError(errorMessage, { cause: error });\n  } else {\n    return value;\n  }\n}\n"]}

package/dist_esm/BuildConfigParser.d.ts

@@ -0,0 +1,14 @@
+import { BuildStepContext } from './BuildStepContext.js';
+import { BuildWorkflow } from './BuildWorkflow.js';
+export declare class BuildConfigParser {
+    private readonly ctx;
+    private readonly configPath;
+    constructor(ctx: BuildStepContext, { configPath }: {
+        configPath: string;
+    });
+    parseAsync(): Promise<BuildWorkflow>;
+    private readRawConfigAsync;
+    private createBuildStepFromConfig;
+    private createBuildStepInputsFromConfig;
+    private createBuildStepOutputsFromConfig;
+}

package/dist_esm/BuildConfigParser.js

@@ -0,0 +1,80 @@
+import fs from 'fs';
+import path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+import YAML from 'yaml';
+import { validateBuildConfig, } from './BuildConfig.js';
+import { BuildStep } from './BuildStep.js';
+import { BuildStepInput } from './BuildStepInput.js';
+import { BuildStepOutput } from './BuildStepOutput.js';
+import { BuildWorkflow } from './BuildWorkflow.js';
+import { BuildWorkflowValidator } from './BuildWorkflowValidator.js';
+export class BuildConfigParser {
+    constructor(ctx, { configPath }) {
+        this.ctx = ctx;
+        this.configPath = configPath;
+    }
+    async parseAsync() {
+        const rawConfig = await this.readRawConfigAsync();
+        const config = validateBuildConfig(rawConfig);
+        const steps = config.build.steps.map((stepConfig) => this.createBuildStepFromConfig(stepConfig));
+        const workflow = new BuildWorkflow({ buildSteps: steps });
+        new BuildWorkflowValidator(workflow).validate();
+        return workflow;
+    }
+    async readRawConfigAsync() {
+        const contents = await fs.promises.readFile(this.configPath, 'utf-8');
+        return YAML.parse(contents);
+    }
+    createBuildStepFromConfig(buildStepConfig) {
+        if (typeof buildStepConfig === 'string') {
+            // TODO: implement calling functions
+            throw new Error('Not implemented yet');
+        }
+        else if (typeof buildStepConfig.run === 'string') {
+            const command = buildStepConfig.run;
+            return new BuildStep(this.ctx, {
+                id: uuidv4(),
+                workingDirectory: this.ctx.workingDirectory,
+                command,
+            });
+        }
+        else {
+            const { id, inputs: inputsConfig, outputs: outputsConfig, name, workingDirectory, shell, command, } = buildStepConfig.run;
+            const stepId = id !== null && id !== void 0 ? id : uuidv4();
+            const inputs = inputsConfig && this.createBuildStepInputsFromConfig(inputsConfig, stepId);
+            const outputs = outputsConfig && this.createBuildStepOutputsFromConfig(outputsConfig, stepId);
+            return new BuildStep(this.ctx, {
+                id: stepId,
+                inputs,
+                outputs,
+                name,
+                workingDirectory: workingDirectory !== undefined
+                    ? path.resolve(this.ctx.workingDirectory, workingDirectory)
+                    : this.ctx.workingDirectory,
+                shell,
+                command,
+            });
+        }
+    }
+    createBuildStepInputsFromConfig(buildStepInputsConfig, stepId) {
+        return Object.entries(buildStepInputsConfig).map(([key, value]) => new BuildStepInput(this.ctx, {
+            id: key,
+            stepId,
+            defaultValue: value,
+            required: true,
+        }));
+    }
+    createBuildStepOutputsFromConfig(buildStepOutputsConfig, stepId) {
+        return buildStepOutputsConfig.map((entry) => {
+            var _a;
+            return typeof entry === 'string'
+                ? new BuildStepOutput(this.ctx, { id: entry, stepId, required: true })
+                : new BuildStepOutput(this.ctx, {
+                    id: entry.name,
+                    stepId,
+                    required: (_a = entry.required) !== null && _a !== void 0 ? _a : true,
+                });
+        });
+    }
+}
+//# sourceMappingURL=BuildConfigParser.js.map

package/dist_esm/BuildConfigParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildConfigParser.js","sourceRoot":"","sources":["../src/BuildConfigParser.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\nimport { v4 as uuidv4 } from 'uuid';\nimport YAML from 'yaml';\n\nimport {\n  BuildStepConfig,\n  BuildStepInputsConfig,\n  BuildStepOutputsConfig,\n  validateBuildConfig,\n} from './BuildConfig.js';\nimport { BuildStep } from './BuildStep.js';\nimport { BuildStepContext } from './BuildStepContext.js';\nimport { BuildStepInput } from './BuildStepInput.js';\nimport { BuildStepOutput } from './BuildStepOutput.js';\nimport { BuildWorkflow } from './BuildWorkflow.js';\nimport { BuildWorkflowValidator } from './BuildWorkflowValidator.js';\n\nexport class BuildConfigParser {\n  private readonly configPath: string;\n\n  constructor(private readonly ctx: BuildStepContext, { configPath }: { configPath: string }) {\n    this.configPath = configPath;\n  }\n\n  public async parseAsync(): Promise<BuildWorkflow> {\n    const rawConfig = await this.readRawConfigAsync();\n    const config = validateBuildConfig(rawConfig);\n    const steps = config.build.steps.map((stepConfig) =>\n      this.createBuildStepFromConfig(stepConfig)\n    );\n    const workflow = new BuildWorkflow({ buildSteps: steps });\n    new BuildWorkflowValidator(workflow).validate();\n    return workflow;\n  }\n\n  private async readRawConfigAsync(): Promise<any> {\n    const contents = await fs.promises.readFile(this.configPath, 'utf-8');\n    return YAML.parse(contents);\n  }\n\n  private createBuildStepFromConfig(buildStepConfig: BuildStepConfig): BuildStep {\n    if (typeof buildStepConfig === 'string') {\n      // TODO: implement calling functions\n      throw new Error('Not implemented yet');\n    } else if (typeof buildStepConfig.run === 'string') {\n      const command = buildStepConfig.run;\n      return new BuildStep(this.ctx, {\n        id: uuidv4(),\n        workingDirectory: this.ctx.workingDirectory,\n        command,\n      });\n    } else {\n      const {\n        id,\n        inputs: inputsConfig,\n        outputs: outputsConfig,\n        name,\n        workingDirectory,\n        shell,\n        command,\n      } = buildStepConfig.run;\n      const stepId = id ?? uuidv4();\n      const inputs = inputsConfig && this.createBuildStepInputsFromConfig(inputsConfig, stepId);\n      const outputs = outputsConfig && this.createBuildStepOutputsFromConfig(outputsConfig, stepId);\n      return new BuildStep(this.ctx, {\n        id: stepId,\n        inputs,\n        outputs,\n        name,\n        workingDirectory:\n          workingDirectory !== undefined\n            ? path.resolve(this.ctx.workingDirectory, workingDirectory)\n            : this.ctx.workingDirectory,\n        shell,\n        command,\n      });\n    }\n  }\n\n  private createBuildStepInputsFromConfig(\n    buildStepInputsConfig: BuildStepInputsConfig,\n    stepId: string\n  ): BuildStepInput[] {\n    return Object.entries(buildStepInputsConfig).map(\n      ([key, value]) =>\n        new BuildStepInput(this.ctx, {\n          id: key,\n          stepId,\n          defaultValue: value,\n          required: true,\n        })\n    );\n  }\n\n  private createBuildStepOutputsFromConfig(\n    buildStepOutputsConfig: BuildStepOutputsConfig,\n    stepId: string\n  ): BuildStepOutput[] {\n    return buildStepOutputsConfig.map((entry) =>\n      typeof entry === 'string'\n        ? new BuildStepOutput(this.ctx, { id: entry, stepId, required: true })\n        : new BuildStepOutput(this.ctx, {\n            id: entry.name,\n            stepId,\n            required: entry.required ?? true,\n          })\n    );\n  }\n}\n"]}

package/dist_esm/BuildStep.d.ts

@@ -0,0 +1,40 @@
+import { BuildStepContext } from './BuildStepContext.js';
+import { BuildStepInput } from './BuildStepInput.js';
+import { BuildStepOutput } from './BuildStepOutput.js';
+export declare enum BuildStepStatus {
+    NEW = "new",
+    IN_PROGRESS = "in-progress",
+    CANCELED = "canceled",
+    FAILED = "failed",
+    SUCCEEDED = "succeeded"
+}
+export declare class BuildStep {
+    private readonly ctx;
+    readonly id: string;
+    readonly name?: string;
+    readonly inputs?: BuildStepInput[];
+    readonly outputs?: BuildStepOutput[];
+    readonly command: string;
+    readonly workingDirectory: string;
+    readonly shell: string;
+    status: BuildStepStatus;
+    private readonly internalId;
+    private readonly logger;
+    private readonly outputById;
+    private executed;
+    constructor(ctx: BuildStepContext, { id, name, inputs, outputs, command, workingDirectory, shell, }: {
+        id: string;
+        name?: string;
+        inputs?: BuildStepInput[];
+        outputs?: BuildStepOutput[];
+        command: string;
+        workingDirectory: string;
+        shell?: string;
+    });
+    executeAsync(): Promise<void>;
+    hasOutputParameter(name: string): boolean;
+    getOutputValueByName(name: string): string | undefined;
+    private interpolateInputsInCommand;
+    private collectAndValidateOutputsAsync;
+    private getScriptEnv;
+}

package/dist_esm/BuildStep.js

@@ -0,0 +1,139 @@
+import fs from 'fs';
+import path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+import { BIN_PATH } from './utils/shell/bin.js';
+import { getDefaultShell, getShellCommandAndArgs } from './utils/shell/command.js';
+import { cleanUpTemporaryDirectoriesAsync, createTemporaryOutputsDirectoryAsync, saveScriptToTemporaryFileAsync, } from './utils/shell/temporaryFiles.js';
+import { spawnAsync } from './utils/shell/spawn.js';
+import { interpolateWithInputs } from './utils/template.js';
+import { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';
+export var BuildStepStatus;
+(function (BuildStepStatus) {
+    BuildStepStatus["NEW"] = "new";
+    BuildStepStatus["IN_PROGRESS"] = "in-progress";
+    BuildStepStatus["CANCELED"] = "canceled";
+    BuildStepStatus["FAILED"] = "failed";
+    BuildStepStatus["SUCCEEDED"] = "succeeded";
+})(BuildStepStatus || (BuildStepStatus = {}));
+export class BuildStep {
+    constructor(ctx, { id, name, inputs, outputs, command, workingDirectory, shell, }) {
+        this.ctx = ctx;
+        this.executed = false;
+        this.id = id;
+        this.name = name;
+        this.inputs = inputs;
+        this.outputs = outputs;
+        this.outputById =
+            outputs === undefined
+                ? {}
+                : outputs.reduce((acc, output) => {
+                    acc[output.id] = output;
+                    return acc;
+                }, {});
+        this.command = command;
+        this.workingDirectory = workingDirectory;
+        this.shell = shell !== null && shell !== void 0 ? shell : getDefaultShell();
+        this.status = BuildStepStatus.NEW;
+        this.internalId = uuidv4();
+        this.logger = ctx.logger.child({ buildStepInternalId: this.internalId, buildStepId: this.id });
+        ctx.registerStep(this);
+    }
+    async executeAsync() {
+        try {
+            this.logger.debug(`Executing build step "${this.id}"`);
+            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 createTemporaryOutputsDirectoryAsync(this.ctx, this.id);
+            this.logger.debug(`Created temporary directory for step outputs: ${outputsDir}`);
+            const scriptPath = await saveScriptToTemporaryFileAsync(this.ctx, this.id, command);
+            this.logger.debug(`Saved script to ${scriptPath}`);
+            const { command: shellCommand, args } = getShellCommandAndArgs(this.shell, scriptPath);
+            this.logger.debug(`Executing script: ${shellCommand}${args !== undefined ? ` ${args.join(' ')}` : ''}`);
+            await spawnAsync(shellCommand, args !== null && args !== void 0 ? args : [], {
+                cwd: this.workingDirectory,
+                logger: this.logger,
+                env: this.getScriptEnv(outputsDir),
+            });
+            this.logger.debug(`Script completed successfully`);
+            await this.collectAndValidateOutputsAsync(outputsDir);
+            this.logger.debug('Finished collecting output paramters');
+            this.logger.debug('Finished successfully');
+            this.status = BuildStepStatus.SUCCEEDED;
+        }
+        catch (err) {
+            this.status = BuildStepStatus.FAILED;
+            throw err;
+        }
+        finally {
+            this.executed = true;
+            await cleanUpTemporaryDirectoriesAsync(this.ctx, this.id);
+        }
+    }
+    hasOutputParameter(name) {
+        return name in this.outputById;
+    }
+    getOutputValueByName(name) {
+        if (!this.executed) {
+            throw new BuildStepRuntimeError(`Failed getting output "${name}" from step "${this.id}". The step has not been executed yet.`);
+        }
+        if (!this.hasOutputParameter(name)) {
+            throw new BuildStepRuntimeError(`Step "${this.id}" does not have output "${name}"`);
+        }
+        return this.outputById[name].value;
+    }
+    interpolateInputsInCommand(command, inputs) {
+        if (!inputs) {
+            return command;
+        }
+        const vars = inputs.reduce((acc, input) => {
+            var _a;
+            acc[input.id] = (_a = input.value) !== null && _a !== void 0 ? _a : '';
+            return acc;
+        }, {});
+        return interpolateWithInputs(command, vars);
+    }
+    async collectAndValidateOutputsAsync(outputsDir) {
+        var _a;
+        const files = await fs.promises.readdir(outputsDir);
+        const nonDefinedOutputIds = [];
+        for (const outputId of files) {
+            if (!(outputId in this.outputById)) {
+                nonDefinedOutputIds.push(outputId);
+            }
+            else {
+                const file = path.join(outputsDir, outputId);
+                const rawContents = await fs.promises.readFile(file, 'utf-8');
+                const value = rawContents.trim();
+                this.outputById[outputId].set(value);
+            }
+        }
+        if (nonDefinedOutputIds.length > 0) {
+            const idsString = nonDefinedOutputIds.map((i) => `"${i}"`).join(', ');
+            this.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}"`);
+            }
+            catch (err) {
+                this.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(`Some required output parameters have not been set: ${idsString}`, { metadata: { ids: nonSetRequiredOutputIds } });
+        }
+    }
+    getScriptEnv(outputsDir) {
+        return {
+            ...process.env,
+            __EXPO_STEPS_OUTPUTS_DIR: outputsDir,
+            PATH: `${BIN_PATH}:${process.env.PATH}`,
+        };
+    }
+}
+//# sourceMappingURL=BuildStep.js.map

package/dist_esm/BuildStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildStep.js","sourceRoot":"","sources":["../src/BuildStep.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs';\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  cleanUpTemporaryDirectoriesAsync,\n  createTemporaryOutputsDirectoryAsync,\n  saveScriptToTemporaryFileAsync,\n} from './utils/shell/temporaryFiles.js';\nimport { spawnAsync } from './utils/shell/spawn.js';\nimport { interpolateWithInputs } from './utils/template.js';\nimport { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';\n\nexport enum BuildStepStatus {\n  NEW = 'new',\n  IN_PROGRESS = 'in-progress',\n  CANCELED = 'canceled',\n  FAILED = 'failed',\n  SUCCEEDED = 'succeeded',\n}\n\nexport class BuildStep {\n  public readonly id: string;\n  public readonly name?: 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.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({ buildStepInternalId: this.internalId, buildStepId: this.id });\n\n    ctx.registerStep(this);\n  }\n\n  public async executeAsync(): Promise<void> {\n    try {\n      this.logger.debug(`Executing build step \"${this.id}\"`);\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(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.debug('Finished successfully');\n      this.status = BuildStepStatus.SUCCEEDED;\n    } catch (err) {\n      this.status = BuildStepStatus.FAILED;\n      throw err;\n    } finally {\n      this.executed = true;\n      await cleanUpTemporaryDirectoriesAsync(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.promises.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.promises.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(outputsDir: string): Record<string, string> {\n    return {\n      ...process.env,\n      __EXPO_STEPS_OUTPUTS_DIR: outputsDir,\n      PATH: `${BIN_PATH}:${process.env.PATH}`,\n    };\n  }\n}\n"]}

package/dist_esm/BuildStepContext.d.ts

@@ -0,0 +1,13 @@
+import { bunyan } from '@expo/logger';
+import { BuildStep } from './BuildStep.js';
+export declare class BuildStepContext {
+    readonly buildId: string;
+    readonly logger: bunyan;
+    readonly skipCleanup: boolean;
+    readonly baseWorkingDirectory: string;
+    readonly workingDirectory: string;
+    private stepById;
+    constructor(buildId: string, logger: bunyan, skipCleanup: boolean, workingDirectory?: string);
+    registerStep(step: BuildStep): void;
+    getStepOutputValue(path: string): string | undefined;
+}

package/dist_esm/BuildStepContext.js

@@ -0,0 +1,25 @@
+import os from 'os';
+import path from 'path';
+import { parseOutputPath } from './utils/template.js';
+import { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';
+export class BuildStepContext {
+    constructor(buildId, logger, skipCleanup, workingDirectory) {
+        this.buildId = buildId;
+        this.logger = logger;
+        this.skipCleanup = skipCleanup;
+        this.stepById = {};
+        this.baseWorkingDirectory = path.join(os.tmpdir(), 'eas-build', buildId);
+        this.workingDirectory = workingDirectory !== null && workingDirectory !== void 0 ? workingDirectory : path.join(this.baseWorkingDirectory, 'project');
+    }
+    registerStep(step) {
+        this.stepById[step.id] = step;
+    }
+    getStepOutputValue(path) {
+        const { stepId, outputId } = parseOutputPath(path);
+        if (!(stepId in this.stepById)) {
+            throw new BuildStepRuntimeError(`Step "${stepId}" does not exist.`);
+        }
+        return this.stepById[stepId].getOutputValueByName(outputId);
+    }
+}
+//# sourceMappingURL=BuildStepContext.js.map

package/dist_esm/BuildStepContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildStepContext.js","sourceRoot":"","sources":["../src/BuildStepContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAKxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,OAAO,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,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAI,IAAI,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,eAAe,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE;YAC9B,MAAM,IAAI,qBAAqB,CAAC,SAAS,MAAM,mBAAmB,CAAC,CAAC;SACrE;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;CACF","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"]}

package/dist_esm/BuildStepInput.d.ts

@@ -0,0 +1,17 @@
+import { BuildStepContext } from './BuildStepContext.js';
+export declare class BuildStepInput {
+    private readonly ctx;
+    readonly id: string;
+    readonly stepId: string;
+    readonly defaultValue?: string;
+    readonly required: boolean;
+    private _value?;
+    constructor(ctx: BuildStepContext, { id, stepId, defaultValue, required, }: {
+        id: string;
+        stepId: string;
+        defaultValue?: string;
+        required?: boolean;
+    });
+    get value(): string | undefined;
+    set(value: string | undefined): BuildStepInput;
+}

package/dist_esm/BuildStepInput.js

@@ -0,0 +1,32 @@
+import { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';
+import { interpolateWithOutputs } from './utils/template.js';
+export class BuildStepInput {
+    constructor(ctx, { id, stepId, defaultValue, required = false, }) {
+        this.ctx = ctx;
+        this.id = id;
+        this.stepId = stepId;
+        this.defaultValue = defaultValue;
+        this.required = required;
+    }
+    get value() {
+        var _a;
+        const rawValue = (_a = this._value) !== null && _a !== void 0 ? _a : this.defaultValue;
+        if (this.required && rawValue === undefined) {
+            throw new BuildStepRuntimeError(`Input parameter "${this.id}" for step "${this.stepId}" is required but it was not set.`);
+        }
+        if (rawValue === undefined) {
+            return rawValue;
+        }
+        else {
+            return interpolateWithOutputs(rawValue, (path) => { var _a; return (_a = this.ctx.getStepOutputValue(path)) !== null && _a !== void 0 ? _a : ''; });
+        }
+    }
+    set(value) {
+        if (this.required && value === undefined) {
+            throw new BuildStepRuntimeError(`Input parameter "${this.id}" for step "${this.stepId}" is required.`);
+        }
+        this._value = value;
+        return this;
+    }
+}
+//# sourceMappingURL=BuildStepInput.js.map

package/dist_esm/BuildStepInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildStepInput.js","sourceRoot":"","sources":["../src/BuildStepInput.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,OAAO,cAAc;IAQzB,YACmB,GAAqB,EACtC,EACE,EAAE,EACF,MAAM,EACN,YAAY,EACZ,QAAQ,GAAG,KAAK,GAMjB;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,qBAAqB,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,sBAAsB,CAAC,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,qBAAqB,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","sourcesContent":["import { BuildStepContext } from './BuildStepContext.js';\nimport { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';\nimport { interpolateWithOutputs } from './utils/template.js';\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 = false,\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"]}

package/dist_esm/BuildStepOutput.d.ts

@@ -0,0 +1,15 @@
+import { BuildStepContext } from './BuildStepContext.js';
+export declare class BuildStepOutput {
+    private readonly ctx;
+    readonly id: string;
+    readonly stepId: string;
+    readonly required: boolean;
+    private _value?;
+    constructor(ctx: BuildStepContext, { id, stepId, required }: {
+        id: string;
+        stepId: string;
+        required?: boolean;
+    });
+    get value(): string | undefined;
+    set(value: string | undefined): BuildStepOutput;
+}

package/dist_esm/BuildStepOutput.js

@@ -0,0 +1,25 @@
+import { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';
+export class BuildStepOutput {
+    constructor(
+    // @ts-expect-error ctx is not used in this class but let's keep it here for consistency
+    ctx, { id, stepId, required = true }) {
+        this.ctx = ctx;
+        this.id = id;
+        this.stepId = stepId;
+        this.required = required;
+    }
+    get value() {
+        if (this.required && this._value === undefined) {
+            throw new BuildStepRuntimeError(`Output parameter "${this.id}" for step "${this.stepId}" is required but it was not set.`);
+        }
+        return this._value;
+    }
+    set(value) {
+        if (this.required && value === undefined) {
+            throw new BuildStepRuntimeError(`Output parameter "${this.id}" for step "${this.stepId}" is required.`);
+        }
+        this._value = value;
+        return this;
+    }
+}
+//# sourceMappingURL=BuildStepOutput.js.map

package/dist_esm/BuildStepOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildStepOutput.js","sourceRoot":"","sources":["../src/BuildStepOutput.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,OAAO,eAAe;IAO1B;IACE,wFAAwF;IACvE,GAAqB,EACtC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAsD;QADlE,QAAG,GAAH,GAAG,CAAkB;QAGtC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE;YAC9C,MAAM,IAAI,qBAAqB,CAC7B,qBAAqB,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,MAAM,mCAAmC,CAC1F,CAAC;SACH;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,KAAyB;QAC3B,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,KAAK,SAAS,EAAE;YACxC,MAAM,IAAI,qBAAqB,CAC7B,qBAAqB,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,MAAM,gBAAgB,CACvE,CAAC;SACH;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;CACF","sourcesContent":["import { BuildStepContext } from './BuildStepContext.js';\nimport { BuildStepRuntimeError } from './errors/BuildStepRuntimeError.js';\n\nexport class BuildStepOutput {\n  public readonly id: string;\n  public readonly stepId: string;\n  public readonly required: boolean;\n\n  private _value?: string;\n\n  constructor(\n    // @ts-expect-error ctx is not used in this class but let's keep it here for consistency\n    private readonly ctx: BuildStepContext,\n    { id, stepId, required = true }: { id: string; stepId: string; required?: boolean }\n  ) {\n    this.id = id;\n    this.stepId = stepId;\n    this.required = required;\n  }\n\n  get value(): string | undefined {\n    if (this.required && this._value === undefined) {\n      throw new BuildStepRuntimeError(\n        `Output parameter \"${this.id}\" for step \"${this.stepId}\" is required but it was not set.`\n      );\n    }\n    return this._value;\n  }\n\n  set(value: string | undefined): BuildStepOutput {\n    if (this.required && value === undefined) {\n      throw new BuildStepRuntimeError(\n        `Output parameter \"${this.id}\" for step \"${this.stepId}\" is required.`\n      );\n    }\n    this._value = value;\n    return this;\n  }\n}\n"]}

package/dist_esm/BuildWorkflow.d.ts

@@ -0,0 +1,8 @@
+import { BuildStep } from './BuildStep.js';
+export declare class BuildWorkflow {
+    readonly buildSteps: BuildStep[];
+    constructor({ buildSteps }: {
+        buildSteps: BuildStep[];
+    });
+    executeAsync(): Promise<void>;
+}

package/dist_esm/BuildWorkflow.js

@@ -0,0 +1,11 @@
+export class BuildWorkflow {
+    constructor({ buildSteps }) {
+        this.buildSteps = buildSteps;
+    }
+    async executeAsync() {
+        for (const step of this.buildSteps) {
+            await step.executeAsync();
+        }
+    }
+}
+//# sourceMappingURL=BuildWorkflow.js.map

package/dist_esm/BuildWorkflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildWorkflow.js","sourceRoot":"","sources":["../src/BuildWorkflow.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IAGxB,YAAY,EAAE,UAAU,EAA+B;QACrD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,YAAY;QACvB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE;YAClC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;SAC3B;IACH,CAAC;CACF","sourcesContent":["import { BuildStep } from './BuildStep.js';\n\nexport class BuildWorkflow {\n  public readonly buildSteps: BuildStep[];\n\n  constructor({ buildSteps }: { buildSteps: BuildStep[] }) {\n    this.buildSteps = buildSteps;\n  }\n\n  public async executeAsync(): Promise<void> {\n    for (const step of this.buildSteps) {\n      await step.executeAsync();\n    }\n  }\n}\n"]}

package/dist_esm/BuildWorkflowValidator.d.ts

@@ -0,0 +1,8 @@
+import { BuildWorkflow } from './BuildWorkflow.js';
+export declare class BuildWorkflowValidator {
+    private readonly workflow;
+    constructor(workflow: BuildWorkflow);
+    validate(): void;
+    private validateUniqueStepIds;
+    private validateInputs;
+}