@invarn/cibuild 2.9.5 → 2.9.7

package/dist/src/yaml/e2e.test.js

@@ -1,446 +0,0 @@
-/**
- * End-to-end integration tests for YAML pipelines
- * Tests complete YAML pipeline loading and execution through CLI components
- */
-import { describe, test, expect } from '@jest/globals';
-import { loadYAMLPipeline } from './parser.js';
-import { convertYAMLToPipelineDef } from './converter.js';
-import { detectPlatformInfo } from './platform-detector.js';
-import { resolve } from 'node:path';
-import { existsSync } from 'node:fs';
-import * as jsYaml from 'js-yaml';
-import './steps/index.js'; // Initialize step registry
-// Test helper for default config
-const testConfig = {
-    artifactsDir: './artifacts',
-    interpreters: {
-        python: 'python3',
-        ruby: 'ruby',
-        node: 'node',
-        bash: '/bin/bash',
-    },
-    maxConcurrentJobs: 1,
-    paths: {
-        buildsDir: '.ci-builds',
-        cacheDir: '.ci-cache',
-        derivedDataDir: '~/Library/Developer/Xcode/DerivedData',
-    },
-};
-describe('YAML Pipeline End-to-End Tests', () => {
-    const examplesDir = resolve(process.cwd(), 'examples');
-    describe('iOS Build Pipeline', () => {
-        const pipelinePath = resolve(examplesDir, 'ios-build.yml');
-        test('should load and parse iOS pipeline file', () => {
-            expect(existsSync(pipelinePath)).toBe(true);
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            expect(yamlPipeline.format_version).toBe('4');
-            expect(yamlPipeline.workflows).toBeDefined();
-            expect(yamlPipeline.workflows.primary).toBeDefined();
-            expect(yamlPipeline.workflows.debug).toBeDefined();
-        });
-        test('should convert primary workflow to PipelineDef', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'primary');
-            expect(result.pipeline.name).toBe('primary (YAML)');
-            expect(result.pipeline.steps).toBeDefined();
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-            // Verify step IDs are generated
-            const stepIds = result.pipeline.steps.map(s => s.id);
-            expect(stepIds).toContain('step_1');
-            expect(stepIds).toContain('step_2');
-        });
-        test('should detect macOS platform for iOS workflow', () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const platformInfo = detectPlatformInfo(yamlPipeline, 'primary');
-            expect(platformInfo.platform).toBe('macos');
-            expect(platformInfo.stack).toBe('macos-ventura-xcode-15.1');
-            expect(platformInfo.machineType).toBe('performance');
-        });
-        test('should convert debug workflow to PipelineDef', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'debug');
-            expect(result.pipeline.name).toBe('debug (YAML)');
-            expect(result.pipeline.steps).toBeDefined();
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-        });
-        test('should include all expected iOS steps', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'primary');
-            const stepNames = result.pipeline.steps.map(s => s.name);
-            expect(stepNames).toContain('git-clone');
-            expect(stepNames).toContain('cache-pull');
-            expect(stepNames).toContain('cache-push');
-            // xcodebuild and xcode-test steps should exist (titles may vary)
-            expect(result.pipeline.steps.length).toBeGreaterThanOrEqual(5);
-        });
-        test('should include environment-dependent step scripts', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'primary');
-            // Check that steps have generated scripts (environment variables resolved during conversion)
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-            // Check that all steps have valid scripts
-            for (const step of result.pipeline.steps) {
-                expect(step.script).toBeDefined();
-                expect(typeof step.script).toBe('string');
-                expect(step.script.length).toBeGreaterThan(0);
-            }
-        });
-    });
-    describe('Android Build Pipeline', () => {
-        const pipelinePath = resolve(examplesDir, 'android-build.yml');
-        test('should load and parse Android pipeline file', () => {
-            expect(existsSync(pipelinePath)).toBe(true);
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            expect(yamlPipeline.format_version).toBe('4');
-            expect(yamlPipeline.workflows).toBeDefined();
-            expect(yamlPipeline.workflows.primary).toBeDefined();
-            expect(yamlPipeline.workflows.debug).toBeDefined();
-            expect(yamlPipeline.workflows.qa).toBeDefined();
-        });
-        test('should convert primary workflow to PipelineDef', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'primary');
-            expect(result.pipeline.name).toBe('primary (YAML)');
-            expect(result.pipeline.steps).toBeDefined();
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-        });
-        test('should detect Linux platform for Android workflow', () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const platformInfo = detectPlatformInfo(yamlPipeline, 'primary');
-            expect(platformInfo.platform).toBe('linux');
-            expect(platformInfo.stack).toBe('linux-docker-android-22.04');
-            expect(platformInfo.machineType).toBe('standard');
-        });
-        test('should include all expected Android steps', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'primary');
-            const stepNames = result.pipeline.steps.map(s => s.name);
-            expect(stepNames).toContain('git-clone');
-            expect(stepNames).toContain('cache-pull');
-            expect(stepNames).toContain('cache-push');
-            // Android build steps should exist (8 total in primary workflow)
-            expect(result.pipeline.steps.length).toBe(8);
-        });
-        test('should convert qa workflow with test filters', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'qa');
-            expect(result.pipeline.name).toBe('qa (YAML)');
-            expect(result.pipeline.steps).toBeDefined();
-            // QA workflow should have test steps with generated scripts
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-            for (const step of result.pipeline.steps) {
-                expect(step.kind).toBe('script');
-                expect(step.script).toBeDefined();
-            }
-        });
-        test('should generate scripts with environment variables', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'primary');
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-            // Check that all steps have generated scripts
-            for (const step of result.pipeline.steps) {
-                expect(step.script).toBeDefined();
-                expect(step.script.length).toBeGreaterThan(0);
-            }
-        });
-    });
-    describe('Multi-Platform Pipeline', () => {
-        const pipelinePath = resolve(examplesDir, 'multi-platform.yml');
-        test('should load and parse multi-platform pipeline file', () => {
-            expect(existsSync(pipelinePath)).toBe(true);
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            expect(yamlPipeline.format_version).toBe('4');
-            expect(yamlPipeline.workflows).toBeDefined();
-            expect(Object.keys(yamlPipeline.workflows)).toHaveLength(4);
-        });
-        test('should have iOS and Android workflows', () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            expect(yamlPipeline.workflows['ios-build']).toBeDefined();
-            expect(yamlPipeline.workflows['android-build']).toBeDefined();
-            expect(yamlPipeline.workflows['ios-debug']).toBeDefined();
-            expect(yamlPipeline.workflows['android-debug']).toBeDefined();
-        });
-        test('should detect macOS platform for ios-build workflow', () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const platformInfo = detectPlatformInfo(yamlPipeline, 'ios-build');
-            expect(platformInfo.platform).toBe('macos');
-            expect(platformInfo.machineType).toBe('standard');
-        });
-        test('should detect Linux platform for android-build workflow', () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const platformInfo = detectPlatformInfo(yamlPipeline, 'android-build');
-            expect(platformInfo.platform).toBe('linux');
-            expect(platformInfo.machineType).toBe('standard');
-        });
-        test('should convert ios-build workflow to PipelineDef', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'ios-build');
-            expect(result.pipeline.name).toBe('ios-build (YAML)');
-            expect(result.pipeline.steps).toBeDefined();
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-            // Verify all steps have scripts
-            for (const step of result.pipeline.steps) {
-                expect(step.script).toBeDefined();
-            }
-        });
-        test('should convert android-build workflow to PipelineDef', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'android-build');
-            expect(result.pipeline.name).toBe('android-build (YAML)');
-            expect(result.pipeline.steps).toBeDefined();
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-            // Verify all steps have scripts
-            for (const step of result.pipeline.steps) {
-                expect(step.script).toBeDefined();
-            }
-        });
-        test('should process global and workflow-specific environment variables into scripts', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'ios-build');
-            // Verify steps were generated
-            expect(result.pipeline.steps).toBeDefined();
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-            // All steps should have generated scripts
-            for (const step of result.pipeline.steps) {
-                expect(step.script).toBeDefined();
-                expect(step.script.length).toBeGreaterThan(0);
-            }
-        });
-        test('should use first workflow when no workflow specified', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig);
-            // Should default to first workflow in the object
-            expect(result.pipeline.name).toContain('(YAML)');
-            expect(result.pipeline.steps).toBeDefined();
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-        });
-    });
-    describe('Workflow Selection', () => {
-        const pipelinePath = resolve(examplesDir, 'multi-platform.yml');
-        test('should throw error for non-existent workflow', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            await expect(async () => {
-                await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'non-existent-workflow');
-            }).rejects.toThrow();
-        });
-        test('should successfully select each workflow by name', async () => {
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const workflowNames = ['ios-build', 'android-build', 'ios-debug', 'android-debug'];
-            for (const workflowName of workflowNames) {
-                const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, workflowName);
-                expect(result.pipeline.name).toBe(`${workflowName} (YAML)`);
-            }
-        });
-    });
-    describe('Step Script Generation', () => {
-        test('should generate valid bash scripts for all steps', async () => {
-            const pipelinePath = resolve(examplesDir, 'ios-build.yml');
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'primary');
-            for (const step of result.pipeline.steps) {
-                expect(step.kind).toBe('script');
-                expect(step.script).toBeDefined();
-                expect(typeof step.script).toBe('string');
-                expect(step.script.length).toBeGreaterThan(0);
-                // Scripts should be valid bash (start with shebang)
-                expect(step.script).toMatch(/^#!/);
-            }
-        });
-        test('should generate unique step IDs', async () => {
-            const pipelinePath = resolve(examplesDir, 'ios-build.yml');
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'primary');
-            const stepIds = result.pipeline.steps.map(s => s.id);
-            const uniqueIds = new Set(stepIds);
-            // All step IDs should be unique
-            expect(stepIds.length).toBe(uniqueIds.size);
-        });
-    });
-    describe('Environment Variable Resolution', () => {
-        test('should generate scripts with resolved variables', async () => {
-            const pipelinePath = resolve(examplesDir, 'android-build.yml');
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'primary');
-            // Scripts should be generated with resolved variable values
-            expect(result.pipeline.steps.length).toBe(8);
-            for (const step of result.pipeline.steps) {
-                expect(step.kind).toBe('script');
-                expect(step.script).toBeDefined();
-                expect(step.script.length).toBeGreaterThan(0);
-            }
-        });
-        test('should process app-level and workflow-level environment variables', async () => {
-            const pipelinePath = resolve(examplesDir, 'multi-platform.yml');
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'android-build');
-            // Verify all steps have valid scripts
-            expect(result.pipeline.steps.length).toBeGreaterThan(0);
-            for (const step of result.pipeline.steps) {
-                expect(step.script).toBeDefined();
-            }
-        });
-    });
-    describe('Platform Detection', () => {
-        test('should auto-detect platform from xcodebuild step', () => {
-            const pipelinePath = resolve(examplesDir, 'multi-platform.yml');
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const platformInfo = detectPlatformInfo(yamlPipeline, 'ios-build');
-            expect(platformInfo.platform).toBe('macos');
-        });
-        test('should auto-detect platform from gradle-build step', () => {
-            const pipelinePath = resolve(examplesDir, 'multi-platform.yml');
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const platformInfo = detectPlatformInfo(yamlPipeline, 'android-build');
-            expect(platformInfo.platform).toBe('linux');
-        });
-        test('should use stack metadata when available', () => {
-            const pipelinePath = resolve(examplesDir, 'ios-build.yml');
-            const yamlPipeline = loadYAMLPipeline(pipelinePath);
-            const platformInfo = detectPlatformInfo(yamlPipeline, 'primary');
-            expect(platformInfo.stack).toBe('macos-ventura-xcode-15.1');
-            expect(platformInfo.platform).toBe('macos');
-        });
-    });
-    describe('Unsupported Steps Integration', () => {
-        test('should handle YAML with mixed supported and unsupported steps', async () => {
-            // Create a temporary YAML in memory with mixed steps
-            const yamlContent = `format_version: '4'
-
-workflows:
-  test-warnings:
-    steps:
-      - script@1.0.0:
-          title: Valid script step
-          inputs:
-            content: |
-              echo "This step is supported"
-      - unsupported-bitrise-step@1.0.0:
-          title: This step does not exist
-          inputs:
-            some_input: value
-      - npm@1.0.0:
-          title: NPM step (should suggest script alternative)
-          inputs:
-            command: install
-      - script@1.0.0:
-          title: Another valid step
-          inputs:
-            content: |
-              echo "This step is also supported"
-      - cocoapods-install@2.0.0:
-          title: CocoaPods (should suggest script alternative)
-      - completely-unknown-step@3.0.0:
-          title: Unknown step (no suggestion)
-`;
-            // Parse YAML manually
-            // Use js-yaml for parsing
-            const yamlPipeline = jsYaml.load(yamlContent);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'test-warnings');
-            // Verify warnings were collected
-            expect(result.warnings).toBeDefined();
-            expect(result.warnings.length).toBe(3); // 3 unsupported steps (cocoapods-install is now supported)
-            // Verify skipped steps count
-            expect(result.skippedSteps).toBe(3);
-            // Verify supported steps were processed (script x2 + cocoapods-install)
-            expect(result.pipeline.steps.length).toBe(3);
-            expect(result.pipeline.steps[0].name).toBe('Valid script step');
-            expect(result.pipeline.steps[1].name).toBe('Another valid step');
-            expect(result.pipeline.steps[2].name).toBe('CocoaPods (should suggest script alternative)');
-            // Verify warning messages contain step names
-            expect(result.warnings[0]).toContain('unsupported-bitrise-step@1.0.0');
-            expect(result.warnings[1]).toContain('npm@1.0.0');
-            expect(result.warnings[2]).toContain('completely-unknown-step@3.0.0');
-            // Verify suggestions are included for known steps
-            expect(result.warnings[1]).toContain('💡 Suggestion');
-            expect(result.warnings[1]).toContain('script step with npm commands');
-            // Verify no suggestion for unknown step
-            expect(result.warnings[2]).not.toContain('💡 Suggestion');
-        });
-        test('should handle YAML with all unsupported steps', async () => {
-            const yamlContent = `format_version: '4'
-
-workflows:
-  all-unsupported:
-    steps:
-      - unsupported-1@1.0.0:
-          inputs: {}
-      - unsupported-2@2.0.0:
-          inputs: {}
-      - unsupported-3@3.0.0:
-          inputs: {}
-`;
-            // Use js-yaml for parsing
-            const yamlPipeline = jsYaml.load(yamlContent);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'all-unsupported');
-            // All steps should be skipped
-            expect(result.warnings.length).toBe(3);
-            expect(result.skippedSteps).toBe(3);
-            expect(result.pipeline.steps.length).toBe(0);
-            // Pipeline should still be valid
-            expect(result.pipeline.name).toBe('all-unsupported (YAML)');
-            expect(result.pipeline.stepsOrder.length).toBe(0);
-        });
-        test('should preserve step order after filtering unsupported steps', async () => {
-            const yamlContent = `format_version: '4'
-
-workflows:
-  order-test:
-    steps:
-      - script@1.0.0:
-          title: Step 1
-          inputs:
-            content: echo "1"
-      - unsupported-step@1.0.0:
-          inputs: {}
-      - script@1.0.0:
-          title: Step 2
-          inputs:
-            content: echo "2"
-      - another-unsupported@1.0.0:
-          inputs: {}
-      - script@1.0.0:
-          title: Step 3
-          inputs:
-            content: echo "3"
-`;
-            // Use js-yaml for parsing
-            const yamlPipeline = jsYaml.load(yamlContent);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'order-test');
-            // Verify order is preserved
-            expect(result.pipeline.steps.length).toBe(3);
-            expect(result.pipeline.steps[0].name).toBe('Step 1');
-            expect(result.pipeline.steps[1].name).toBe('Step 2');
-            expect(result.pipeline.steps[2].name).toBe('Step 3');
-            // Verify stepsOrder matches
-            expect(result.pipeline.stepsOrder.length).toBe(3);
-        });
-        test('should handle multiple versions of same unsupported step', async () => {
-            const yamlContent = `format_version: '4'
-
-workflows:
-  version-test:
-    steps:
-      - npm@1.0.0:
-          inputs: {}
-      - npm@2.0.0:
-          inputs: {}
-      - npm@3.5.0:
-          inputs: {}
-`;
-            // Use js-yaml for parsing
-            const yamlPipeline = jsYaml.load(yamlContent);
-            const result = await convertYAMLToPipelineDef(yamlPipeline, testConfig, 'version-test');
-            // Should warn about each version separately
-            expect(result.warnings.length).toBe(3);
-            expect(result.warnings[0]).toContain('npm@1.0.0');
-            expect(result.warnings[1]).toContain('npm@2.0.0');
-            expect(result.warnings[2]).toContain('npm@3.5.0');
-            // All should have the same suggestion
-            result.warnings.forEach(warning => {
-                expect(warning).toContain('💡 Suggestion');
-                expect(warning).toContain('script step with npm commands');
-            });
-        });
-    });
-});
-//# sourceMappingURL=e2e.test.js.map

package/dist/src/yaml/env-resolver.d.ts

@@ -1,218 +0,0 @@
-/**
- * Environment variable resolution and interpolation
- * Merges global and workflow-level environment variables
- * Supports variable interpolation in multiple formats
- */
-import type { YAMLPipeline, YAMLWorkflow, Platform } from './types.js';
-export declare class MissingEnvironmentVariableError extends Error {
-    readonly variableName: string;
-    readonly stepName?: string | undefined;
-    readonly hint?: string | undefined;
-    constructor(variableName: string, stepName?: string | undefined, hint?: string | undefined);
-}
-/**
- * A `{{checksum "path"}}` naming a file this checkout does not have.
- *
- * Distinct from a generic read failure because a caller can reasonably
- * decide it does not matter. A cache key is the usual case: the file is
- * absent, so there is nothing to key a cache on, so there is no cache — which
- * is a slower build, not a broken one.
- */
-export declare class ChecksumFileMissingError extends Error {
-    readonly filePath: string;
-    readonly stepName?: string | undefined;
-    constructor(filePath: string, stepName?: string | undefined);
-}
-/**
- * A credential slot scoped to a workflow the pipeline does not have.
- *
- * Thrown at generation time, before any step converts, because every way of
- * getting the name wrong is otherwise silent. A slot naming a workflow nobody
- * runs declares the credential for nobody: `file@1.0.0` finds no key in its
- * map, calls the credential optional and skips it with a warning, and
- * `ci secrets upload` cheerfully pushes a value under the same wrong name.
- * Two green halves and a build that dies later inside the project's own build
- * tool.
- *
- * The underscore case gets its own sentence because the workflow is right
- * there in the pipeline. `encodeSecretName` upper-cases the workflow and turns
- * dashes into underscores, so decoding turns every underscore back into a
- * dash: a workflow genuinely called `my_wf` can only ever be addressed as
- * `my-wf`, and "no such workflow" about a workflow that plainly exists reads
- * as a defect in us rather than a name that cannot survive the round trip.
- */
-export declare class UnknownWorkflowSlotError extends Error {
-    readonly slot: string;
-    readonly varName: string;
-    readonly workflow: string;
-    constructor(slot: string, varName: string, workflow: string, declared: string[]);
-}
-/**
- * EnvResolver handles environment variable merging and interpolation
- */
-export declare class EnvResolver {
-    private envVars;
-    private referencedVars;
-    private secretsManager;
-    /**
-     * Every key the pipeline names in `app.envs` or `workflow.envs`, whether or
-     * not it gave one a value. Read by `importDeclaredFromProcessEnv`.
-     */
-    private declaredVars;
-    /** The workflow being resolved. Decides which scoped slots apply — `slotKeyFor`. */
-    private workflowName;
-    /** Every workflow this pipeline declares. A scoped slot has to name one of them. */
-    private declaredWorkflows;
-    constructor(pipeline: YAMLPipeline, workflow: YAMLWorkflow, workflowName: string, platform: Platform, stack?: string, yamlFilePath?: string);
-    /**
-     * Gets the value of an environment variable
-     * @param name Variable name
-     * @returns Variable value or undefined if not found
-     */
-    get(name: string): string | undefined;
-    /**
-     * Checks if an environment variable is defined
-     * @param name Variable name
-     * @returns True if variable exists
-     */
-    has(name: string): boolean;
-    /**
-     * Registers a variable as a step output passthrough.
-     * When this variable appears in a later step's inputs it will be kept as
-     * the literal shell reference "$NAME" so the shell resolves it at runtime.
-     */
-    registerStepOutput(name: string): void;
-    /**
-     * Gets all environment variables as a plain object
-     * @returns Object with all environment variables
-     */
-    getAll(): Record<string, string>;
-    /**
-     * Interpolates environment variables in a string
-     * Supports four formats:
-     * - $VAR
-     * - ${VAR}
-     * - {{getenv "VAR"}}
-     * - {{checksum "path/to/file"}}
-     *
-     * @param str String to interpolate
-     * @param stepName Optional step name for error messages
-     * @returns Interpolated string
-     * @throws MissingEnvironmentVariableError if referenced variable not found
-     */
-    interpolate(str: string, stepName?: string): string;
-    /**
-     * Interpolates environment variables in an object recursively
-     * @param obj Object to interpolate
-     * @param stepName Optional step name for error messages
-     * @returns Interpolated object
-     */
-    interpolateObject(obj: any, stepName?: string): any;
-    /**
-     * Validates that all referenced variables are defined
-     * @throws MissingEnvironmentVariableError if any referenced variable is missing
-     */
-    validateReferencedVars(): void;
-    /**
-     * Resolves a single variable reference
-     * @param varName Variable name
-     * @param stepName Optional step name for error messages
-     * @returns Variable value
-     * @throws MissingEnvironmentVariableError if variable not found
-     */
-    private resolveVar;
-    /**
-     * Computes MD5 checksum of a file
-     * @param filePath Path to file (relative to current working directory)
-     * @returns MD5 hash of file contents
-     * @throws Error if file does not exist or cannot be read
-     */
-    private computeChecksum;
-    /**
-     * Adds built-in environment variables
-     * @param workflowName Name of the current workflow
-     * @param platform Detected platform
-     * @param stack Optional stack identifier
-     */
-    private addBuiltInVars;
-    /**
-     * Merges environment variables from YAML array format
-     * @param envArray Array of environment variable objects
-     */
-    /**
-     * The variable a declared `envs` key stands for, or null when the
-     * declaration belongs to a different workflow.
-     *
-     * A credential two workflows cannot share is declared once per workflow,
-     * under the same name a workflow-scoped secret carries — the pipeline says
-     * `CIBUILD_SW__RELEASE__LOCAL_PROPERTIES: ""` where it used to say
-     * `LOCAL_PROPERTIES: ""`. The build still reads the credential under its
-     * plain name, so the declaration has to mean the plain name: it is what puts
-     * an unsupplied key in the map for `file@1.0.0` to refuse over, and what
-     * lets `importDeclaredFromProcessEnv` accept a value delivered flat.
-     *
-     * A slot naming another workflow is dropped rather than declared. Declaring
-     * it would make this workflow demand a value only that one was ever going to
-     * be given. The decoding lives here, beside the decoding of the secret
-     * itself, so the steps keep reading their plain `var_name` and never learn
-     * the convention exists.
-     *
-     * A slot naming a workflow the pipeline does not have is refused rather than
-     * dropped — see `UnknownWorkflowSlotError`. Dropping it silently is the same
-     * outcome as never declaring the credential, which is the green skip issue 03
-     * exists to end.
-     */
-    private slotKeyFor;
-    private mergeEnvVars;
-    /**
-     * Fills a declared-but-still-empty variable from the process environment.
-     *
-     * This is how a credential dispatched by a build service arrives. The
-     * dispatch hands the value to the runner, the runner merges it into the
-     * environment of the `ci` invocation, and nothing else copies it anywhere —
-     * it writes no `.cibuild-secrets.json`, and that file is gitignored so the
-     * clone has none either. Without this step the value sits in the shell and
-     * is invisible to the steps that read this map: `file@1.0.0` reads
-     * `env[var_name]`, finds nothing, prints "not set — skipping" and reports
-     * success. Every credential a pipeline declared as an empty slot was
-     * dropped that way, on every dispatched build, with a green step.
-     *
-     * Scoped to keys the pipeline declares, deliberately. Copying `process.env`
-     * wholesale would turn arbitrary host environment into pipeline values and
-     * would change what every existing pipeline resolves. The declaration is
-     * the opt-in: `- GOOGLE_SERVICES_JSON: ""` is the pipeline saying "I read
-     * this key and I have no value for it", which is exactly the invitation the
-     * dispatched environment needs. A key nothing declares stays out, so `HOME`
-     * and the rest of the host's environment are not pipeline variables.
-     *
-     * Last, so anything an earlier source did supply wins — a developer's
-     * `.cibuild-secrets.json` still beats an inherited environment. The value
-     * is taken verbatim, with no interpolation, for the same reason step 2
-     * takes secrets verbatim: a credential is bytes, and a `$` inside one is
-     * not a variable reference.
-     */
-    private importDeclaredFromProcessEnv;
-    /**
-     * Resolves $SECRET{secret_id} references to actual secret values
-     * @param value Value that may contain a secret reference
-     * @returns Resolved value with secret content, or empty string if secret not found
-     */
-    private resolveSecretReference;
-    /**
-     * Interpolates environment variable value during initial setup
-     * This allows env vars to reference other env vars
-     * @param value Raw value
-     * @returns Interpolated value or original if interpolation fails
-     */
-    private interpolateEnvValue;
-}
-/**
- * Helper function to create an EnvResolver for a workflow
- * @param pipeline Parsed YAML pipeline
- * @param workflowName Name of the workflow
- * @param platform Detected platform
- * @param stack Optional stack identifier
- * @returns EnvResolver instance
- */
-export declare function createEnvResolver(pipeline: YAMLPipeline, workflowName: string, platform: Platform, stack?: string): EnvResolver;
-//# sourceMappingURL=env-resolver.d.ts.map

package/dist/src/yaml/env-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"env-resolver.d.ts","sourceRoot":"","sources":["../../../src/yaml/env-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAc,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkEnF,qBAAa,+BAAgC,SAAQ,KAAK;aAEtC,YAAY,EAAE,MAAM;aACpB,QAAQ,CAAC,EAAE,MAAM;aACjB,IAAI,CAAC,EAAE,MAAM;gBAFb,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,IAAI,CAAC,EAAE,MAAM,YAAA;CAUhC;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;aAE/B,QAAQ,EAAE,MAAM;aAChB,QAAQ,CAAC,EAAE,MAAM;gBADjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;CAgChF;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,cAAc,CAAiB;IACvC;;;OAGG;IACH,OAAO,CAAC,YAAY,CAA0B;IAC9C,oFAAoF;IACpF,OAAO,CAAC,YAAY,CAAS;IAC7B,oFAAoF;IACpF,OAAO,CAAC,iBAAiB,CAAW;gBAGlC,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM;IAoCvB;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKrC;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMtC;;;OAGG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQhC;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAqCnD;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG;IAoBnD;;;OAGG;IACH,sBAAsB,IAAI,IAAI;IAQ9B;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAalB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IA0BvB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IA4FtB;;;OAGG;IACH;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,YAAY;IAsBpB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,CAAC,4BAA4B;IAUpC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;CAS5B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,WAAW,CAOb"}