@invarn/cibuild 1.3.16 → 1.3.17

package/dist/src/yaml/steps/xcode.js

@@ -0,0 +1,999 @@
+/**
+ * Xcode step implementations (xcodebuild, xcode-test)
+ */
+import { existsSync } from 'node:fs';
+import { BaseStepExecutor } from './base.js';
+/**
+ * Xcodebuild step executor
+ * Builds iOS/macOS projects using xcodebuild
+ */
+export class XcodeBuildStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(inputs, _env, _config) {
+        const requirements = [];
+        // xcodebuild command must exist
+        requirements.push(this.requireCommand('xcodebuild', 'Xcode Command Line Tools are required for iOS builds', 'Install Xcode from the App Store, then run: xcode-select --install'));
+        // Required inputs
+        requirements.push(this.requireInput('project_path', inputs, 'Path to .xcodeproj or .xcworkspace', 'Provide project_path input in YAML'));
+        requirements.push(this.requireInput('scheme', inputs, 'Xcode scheme name', 'Provide scheme input in YAML'));
+        // Project file - runtime check only if it doesn't already exist locally
+        if (inputs.project_path && !existsSync(inputs.project_path)) {
+            requirements.push(this.runtimeRequirement(inputs.project_path, 'Xcode project/workspace file', 'file', 'git-clone'));
+        }
+        return requirements;
+    }
+    async execute(inputs, env, config) {
+        const stepName = 'xcodebuild';
+        // Get project path - required
+        let projectPath = this.getRequiredInput(inputs, 'project_path', stepName);
+        // Resolve path identifiers
+        if (projectPath.startsWith('builds:')) {
+            projectPath = projectPath.replace('builds:', `${config.paths.buildsDir}/`);
+        }
+        // Get scheme - required
+        const scheme = this.getRequiredInput(inputs, 'scheme', stepName);
+        // Get configuration - defaults to Release
+        const configuration = this.getInput(inputs, 'configuration', 'Release');
+        // Get destination - defaults to generic/platform=iOS
+        const destination = this.getInput(inputs, 'destination', 'generic/platform=iOS');
+        // Get output directory - defaults to build
+        const outputDir = this.getInput(inputs, 'output_dir', 'build');
+        // Get clean build flag
+        const isCleanBuild = this.getInput(inputs, 'is_clean_build', false);
+        // Get xcconfig content - optional
+        const xcconfigContent = this.getInput(inputs, 'xcconfig_content', '');
+        const commands = [];
+        commands.push('# Xcode Build');
+        commands.push(`echo "Building project: ${this.escapeBash(projectPath)}"`);
+        commands.push(`echo "Scheme: ${this.escapeBash(scheme)}"`);
+        commands.push(`echo "Configuration: ${this.escapeBash(configuration)}"`);
+        // Create output directory and resolve to absolute path
+        // Using an absolute path for CONFIGURATION_BUILD_DIR prevents xcodebuild from
+        // creating a 'build' directory inside each SPM package checkout in DerivedData,
+        // which causes "File exists but is not a directory" errors on repeated runs.
+        commands.push('');
+        commands.push('# Create output directory and resolve to absolute path');
+        commands.push(`mkdir -p '${this.escapeBash(outputDir)}'`);
+        commands.push(`OUTPUT_DIR="$(cd '${this.escapeBash(outputDir)}' && pwd)"`);
+        // Create xcconfig file if content provided
+        if (xcconfigContent && xcconfigContent.trim() !== '') {
+            commands.push('');
+            commands.push('# Create custom xcconfig file');
+            commands.push('XCCONFIG_FILE=".ci-custom.xcconfig"');
+            commands.push('cat > "$XCCONFIG_FILE" << \'EOF\'');
+            commands.push(xcconfigContent);
+            commands.push('EOF');
+            commands.push('echo "Custom xcconfig created"');
+        }
+        // Determine if workspace or project
+        commands.push('');
+        commands.push('# Determine project type');
+        const escapedPath = this.escapeBash(projectPath);
+        commands.push(`if [[ '${escapedPath}' == *.xcworkspace ]]; then`);
+        commands.push('  PROJECT_TYPE="-workspace"');
+        commands.push('else');
+        commands.push('  PROJECT_TYPE="-project"');
+        commands.push('fi');
+        // Build xcodebuild command
+        commands.push('');
+        commands.push('# Build xcodebuild command');
+        let xcodebuildCmd = 'xcodebuild';
+        // Add clean if requested
+        if (isCleanBuild) {
+            xcodebuildCmd += ' clean';
+        }
+        xcodebuildCmd += ' build';
+        xcodebuildCmd += ` "$PROJECT_TYPE" '${escapedPath}'`;
+        xcodebuildCmd += ` -scheme '${this.escapeBash(scheme)}'`;
+        xcodebuildCmd += ` -configuration '${this.escapeBash(configuration)}'`;
+        xcodebuildCmd += ` -destination '${this.escapeBash(destination)}'`;
+        // Add build path (absolute, resolved above)
+        xcodebuildCmd += ` CONFIGURATION_BUILD_DIR="$OUTPUT_DIR"`;
+        // Add xcconfig if provided
+        if (xcconfigContent && xcconfigContent.trim() !== '') {
+            xcodebuildCmd += ' -xcconfig "$XCCONFIG_FILE"';
+        }
+        commands.push(xcodebuildCmd);
+        // Show build results
+        commands.push('');
+        commands.push('# Build completed');
+        commands.push('echo "Build completed successfully"');
+        commands.push('echo "Build artifacts in: $OUTPUT_DIR"');
+        commands.push('ls -lh "$OUTPUT_DIR" || true');
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+/**
+ * Xcode test step executor
+ * Runs tests for iOS/macOS projects using xcodebuild test
+ */
+export class XcodeTestStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(inputs, _env, _config) {
+        const requirements = [];
+        // xcodebuild command must exist
+        requirements.push(this.requireCommand('xcodebuild', 'Xcode Command Line Tools are required for iOS tests', 'Install Xcode from the App Store, then run: xcode-select --install'));
+        // Required inputs
+        requirements.push(this.requireInput('project_path', inputs, 'Path to .xcodeproj or .xcworkspace', 'Provide project_path input in YAML'));
+        requirements.push(this.requireInput('scheme', inputs, 'Xcode scheme name', 'Provide scheme input in YAML'));
+        // Project file - runtime check only if it doesn't already exist locally
+        if (inputs.project_path && !existsSync(inputs.project_path)) {
+            requirements.push(this.runtimeRequirement(inputs.project_path, 'Xcode project/workspace file', 'file', 'git-clone'));
+        }
+        return requirements;
+    }
+    async execute(inputs, env, config) {
+        const stepName = 'xcode-test';
+        // Get project path - required
+        let projectPath = this.getRequiredInput(inputs, 'project_path', stepName);
+        // Resolve path identifiers
+        if (projectPath.startsWith('builds:')) {
+            projectPath = projectPath.replace('builds:', `${config.paths.buildsDir}/`);
+        }
+        // Get scheme - required
+        const scheme = this.getRequiredInput(inputs, 'scheme', stepName);
+        // Get destination - defaults to platform=iOS Simulator
+        const destination = this.getInput(inputs, 'destination', 'platform=iOS Simulator,name=iPhone 14,OS=latest');
+        // Get test plan - optional
+        const testPlan = this.getInput(inputs, 'test_plan', '');
+        // Get code coverage flag
+        const isCodeCoverageEnabled = this.getInput(inputs, 'is_code_coverage_enabled', false);
+        const commands = [];
+        commands.push('# Xcode Test');
+        commands.push(`echo "Testing project: ${this.escapeBash(projectPath)}"`);
+        commands.push(`echo "Scheme: ${this.escapeBash(scheme)}"`);
+        // Determine if workspace or project
+        commands.push('');
+        commands.push('# Determine project type');
+        const escapedPath = this.escapeBash(projectPath);
+        commands.push(`if [[ '${escapedPath}' == *.xcworkspace ]]; then`);
+        commands.push('  PROJECT_TYPE="-workspace"');
+        commands.push('else');
+        commands.push('  PROJECT_TYPE="-project"');
+        commands.push('fi');
+        // Build xcodebuild test command
+        commands.push('');
+        commands.push('# Run tests');
+        let xcodebuildCmd = 'xcodebuild test';
+        xcodebuildCmd += ` "$PROJECT_TYPE" '${escapedPath}'`;
+        xcodebuildCmd += ` -scheme '${this.escapeBash(scheme)}'`;
+        xcodebuildCmd += ` -destination '${this.escapeBash(destination)}'`;
+        // Add test plan if specified
+        if (testPlan && testPlan.trim() !== '') {
+            xcodebuildCmd += ` -testPlan '${this.escapeBash(testPlan)}'`;
+        }
+        // Add code coverage if enabled
+        if (isCodeCoverageEnabled) {
+            xcodebuildCmd += ' -enableCodeCoverage YES';
+        }
+        commands.push(xcodebuildCmd);
+        // Show test results
+        commands.push('');
+        commands.push('# Tests completed');
+        commands.push('echo "Tests completed successfully"');
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+/**
+ * xcode-archive step executor
+ * Archives and exports an iOS app to IPA, mirroring bitrise xcode-archive@5.
+ */
+export class XcodeArchiveStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(inputs, _env, _config) {
+        const requirements = [];
+        requirements.push(this.requireCommand('xcodebuild', 'Xcode Command Line Tools are required for iOS builds', 'Install Xcode from the App Store, then run: xcode-select --install'));
+        requirements.push(this.requireInput('project_path', inputs, 'Path to .xcodeproj or .xcworkspace', 'Provide project_path input in YAML'));
+        requirements.push(this.requireInput('scheme', inputs, 'Xcode scheme name', 'Provide scheme input in YAML'));
+        // Project file - runtime check only if it doesn't already exist locally
+        if (inputs.project_path && !existsSync(inputs.project_path)) {
+            requirements.push(this.runtimeRequirement(inputs.project_path, 'Xcode project/workspace file', 'file', 'git-clone'));
+        }
+        return requirements;
+    }
+    getOutputs() {
+        return [
+            { name: 'CIBUILD_IPA_PATH', type: 'environment', description: 'Path to the exported IPA file' },
+            { name: 'CIBUILD_XCARCHIVE_PATH', type: 'environment', description: 'Path to the generated .xcarchive' },
+            { name: 'CIBUILD_DSYM_PATH', type: 'environment', description: 'Path to the zipped dSYM files' },
+            { name: 'CIBUILD_APP_PATH', type: 'environment', description: 'Path to the .app inside the xcarchive (when code signing is off)' },
+        ];
+    }
+    async execute(inputs, env, config) {
+        const stepName = 'xcode-archive';
+        let projectPath = this.getRequiredInput(inputs, 'project_path', stepName);
+        if (projectPath.startsWith('builds:')) {
+            projectPath = projectPath.replace('builds:', `${config.paths.buildsDir}/`);
+        }
+        const scheme = this.getRequiredInput(inputs, 'scheme', stepName);
+        const configuration = this.getInput(inputs, 'configuration', 'Release');
+        const platform = this.getInput(inputs, 'platform', 'iOS');
+        const distributionMethod = this.getInput(inputs, 'distribution_method', 'development');
+        const performClean = this.getInput(inputs, 'perform_clean_action', 'no');
+        const compileBitcode = this.getInput(inputs, 'compile_bitcode', 'yes');
+        const uploadBitcode = this.getInput(inputs, 'upload_bitcode', 'yes');
+        const automaticCodeSigning = this.getInput(inputs, 'automatic_code_signing', 'off');
+        const xcodebuildOptions = this.getInput(inputs, 'xcodebuild_options', '');
+        const xcconfigContent = this.getInput(inputs, 'xcconfig_content', 'COMPILER_INDEX_STORE_ENABLE = NO');
+        const exportOptionsPlistContent = this.getInput(inputs, 'export_options_plist_content', '');
+        const outputDir = this.getInput(inputs, 'output_dir', 'build/ipa');
+        const artifactName = this.getInput(inputs, 'artifact_name', '');
+        const escapedPath = this.escapeBash(projectPath);
+        const escapedScheme = this.escapeBash(scheme);
+        const escapedConfig = this.escapeBash(configuration);
+        const commands = [];
+        commands.push('# xcode-archive — archive and export iOS app to IPA');
+        commands.push(`echo "Project: ${escapedPath}"`);
+        commands.push(`echo "Scheme: ${escapedScheme}"`);
+        commands.push(`echo "Configuration: ${escapedConfig}"`);
+        commands.push(`echo "Distribution method: ${this.escapeBash(distributionMethod)}"`);
+        commands.push('');
+        // Determine project type
+        commands.push('# Determine project type (-workspace vs -project)');
+        commands.push(`if [[ '${escapedPath}' == *.xcworkspace ]]; then`);
+        commands.push('  PROJECT_TYPE="-workspace"');
+        commands.push('else');
+        commands.push('  PROJECT_TYPE="-project"');
+        commands.push('fi');
+        commands.push('');
+        // Derive artifact name
+        if (artifactName) {
+            commands.push(`ARTIFACT_NAME="${this.escapeBash(artifactName)}"`);
+        }
+        else {
+            commands.push(`ARTIFACT_NAME="${escapedScheme}"`);
+        }
+        // Paths
+        commands.push(`OUTPUT_DIR="${this.escapeBash(outputDir)}"`);
+        commands.push('ARCHIVE_PATH="$OUTPUT_DIR/archive/${ARTIFACT_NAME}.xcarchive"');
+        commands.push('mkdir -p "$(dirname "$ARCHIVE_PATH")"');
+        commands.push('mkdir -p "$OUTPUT_DIR"');
+        commands.push('');
+        // Write xcconfig override
+        commands.push('# Write xcconfig overrides');
+        commands.push('XCCONFIG_PATH="$(mktemp -t cibuild-xcconfig).xcconfig"');
+        // When automatic_code_signing is off (default), disable code signing so
+        // archives succeed on CI without a development team / provisioning profile.
+        let effectiveXcconfig = xcconfigContent.trim() || 'COMPILER_INDEX_STORE_ENABLE = NO';
+        if (automaticCodeSigning === 'off') {
+            effectiveXcconfig += '\nCODE_SIGNING_ALLOWED = NO';
+            effectiveXcconfig += '\nCODE_SIGN_IDENTITY = -';
+        }
+        commands.push(`cat > "$XCCONFIG_PATH" << 'XCCONFIG_EOF'`);
+        commands.push(effectiveXcconfig);
+        commands.push('XCCONFIG_EOF');
+        commands.push('');
+        // Build xcodebuild archive command
+        commands.push('# Run xcodebuild archive');
+        let archiveCmd = 'xcodebuild';
+        if (performClean === 'yes')
+            archiveCmd += ' clean';
+        archiveCmd += ' archive';
+        archiveCmd += ` "$PROJECT_TYPE" '${escapedPath}'`;
+        archiveCmd += ` -scheme '${escapedScheme}'`;
+        archiveCmd += ` -configuration '${escapedConfig}'`;
+        archiveCmd += ` -destination 'generic/platform=${this.escapeBash(platform)}'`;
+        archiveCmd += ' -archivePath "$ARCHIVE_PATH"';
+        archiveCmd += ' -xcconfig "$XCCONFIG_PATH"';
+        // When code signing is off, also pass settings as command-line build
+        // settings so they take highest priority and override any target-level
+        // signing configuration in the Xcode project.
+        if (automaticCodeSigning === 'off') {
+            archiveCmd += ' CODE_SIGNING_ALLOWED=NO CODE_SIGN_IDENTITY=- CODE_SIGNING_REQUIRED=NO';
+        }
+        if (xcodebuildOptions) {
+            archiveCmd += ` ${xcodebuildOptions}`;
+        }
+        commands.push(archiveCmd);
+        commands.push('');
+        commands.push('echo "✓ Archive created: $ARCHIVE_PATH"');
+        commands.push('');
+        // Write output env var helper (used in both signing and non-signing paths)
+        commands.push('# Export output environment variables');
+        commands.push('ENVSTORE_FILE="${ENVMAN_ENVSTORE_PATH:-.ci/.envstore.json}"');
+        commands.push('export_env() {');
+        commands.push('  local key="$1" val="$2"');
+        commands.push('  if [ -f "$ENVSTORE_FILE" ]; then');
+        commands.push('    node -e "');
+        commands.push('      const fs=require(\'fs\');');
+        commands.push('      const s=JSON.parse(fs.readFileSync(process.argv[1],\'utf-8\'));');
+        commands.push('      s.envs=s.envs||[];');
+        commands.push('      s.envs=s.envs.filter(e=>e.key!==process.argv[2]);');
+        commands.push('      s.envs.push({key:process.argv[2],value:process.argv[3]});');
+        commands.push('      fs.writeFileSync(process.argv[1],JSON.stringify(s));');
+        commands.push('    " "$ENVSTORE_FILE" "$key" "$val" 2>/dev/null || true');
+        commands.push('  fi');
+        commands.push('  export "$key=$val"');
+        commands.push('  echo "  $key=$val"');
+        commands.push('}');
+        commands.push('');
+        if (automaticCodeSigning === 'off') {
+            // Signing is disabled — skip IPA export (unsigned archives cannot be exported).
+            // Output the xcarchive path and the .app inside it instead.
+            commands.push('# Code signing disabled — export xcarchive path only');
+            commands.push('export_env CIBUILD_XCARCHIVE_PATH "$(pwd)/$ARCHIVE_PATH"');
+            commands.push('');
+            commands.push('# Locate .app inside the xcarchive for downstream use');
+            commands.push('APP_PATH=$(find "$ARCHIVE_PATH/Products" -name "*.app" -maxdepth 3 2>/dev/null | head -1 || true)');
+            commands.push('[ -n "$APP_PATH" ] && export_env CIBUILD_APP_PATH "$(pwd)/$APP_PATH" || true');
+            commands.push('');
+            commands.push('echo "✓ xcode-archive complete (unsigned — code signing disabled)"');
+        }
+        else {
+            // Signing enabled — generate ExportOptions.plist and export to IPA
+            commands.push('# Generate ExportOptions.plist');
+            commands.push('EXPORT_PLIST="$(mktemp -t ExportOptions).plist"');
+            if (exportOptionsPlistContent.trim()) {
+                commands.push(`cat > "$EXPORT_PLIST" << 'PLIST_EOF'`);
+                commands.push(exportOptionsPlistContent);
+                commands.push('PLIST_EOF');
+            }
+            else {
+                // Map deprecated "development" method name to "debugging" (Apple renamed it in Xcode 15)
+                const exportMethod = distributionMethod === 'development' ? 'debugging' : distributionMethod;
+                const compileBitcodeVal = compileBitcode === 'yes' ? 'true' : 'false';
+                const uploadBitcodeVal = uploadBitcode === 'yes' ? 'true' : 'false';
+                const signingStyle = 'automatic';
+                commands.push(`cat > "$EXPORT_PLIST" << 'PLIST_EOF'`);
+                commands.push('<?xml version="1.0" encoding="UTF-8"?>');
+                commands.push('<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">');
+                commands.push('<plist version="1.0">');
+                commands.push('<dict>');
+                commands.push('    <key>method</key>');
+                commands.push(`    <string>${exportMethod}</string>`);
+                commands.push('    <key>signingStyle</key>');
+                commands.push(`    <string>${signingStyle}</string>`);
+                if (exportMethod !== 'app-store') {
+                    commands.push('    <key>compileBitcode</key>');
+                    commands.push(`    <${compileBitcodeVal}/>`);
+                }
+                if (exportMethod === 'app-store') {
+                    commands.push('    <key>uploadBitcode</key>');
+                    commands.push(`    <${uploadBitcodeVal}/>`);
+                }
+                commands.push('</dict>');
+                commands.push('</plist>');
+                commands.push('PLIST_EOF');
+            }
+            commands.push('');
+            // Export archive to IPA
+            commands.push('# Export archive to IPA');
+            let exportCmd = 'xcodebuild -exportArchive';
+            exportCmd += ' -archivePath "$ARCHIVE_PATH"';
+            exportCmd += ' -exportOptionsPlist "$EXPORT_PLIST"';
+            exportCmd += ' -exportPath "$OUTPUT_DIR"';
+            commands.push(exportCmd);
+            commands.push('');
+            // Locate generated IPA
+            commands.push('# Locate generated IPA and export paths');
+            commands.push('IPA_PATH=$(find "$OUTPUT_DIR" -name "*.ipa" | head -1)');
+            commands.push('DSYM_PATH=$(find "$OUTPUT_DIR" -name "*.dSYM.zip" 2>/dev/null | head -1 || true)');
+            commands.push('');
+            commands.push('if [ -z "$IPA_PATH" ]; then');
+            commands.push('  echo "Error: IPA not found in $OUTPUT_DIR" >&2');
+            commands.push('  exit 1');
+            commands.push('fi');
+            commands.push('');
+            commands.push('echo "✓ IPA created: $IPA_PATH"');
+            commands.push('ls -lh "$IPA_PATH"');
+            commands.push('');
+            commands.push('export_env CIBUILD_IPA_PATH "$IPA_PATH"');
+            commands.push('export_env CIBUILD_XCARCHIVE_PATH "$(pwd)/$ARCHIVE_PATH"');
+            commands.push('[ -n "$DSYM_PATH" ] && export_env CIBUILD_DSYM_PATH "$DSYM_PATH" || true');
+            commands.push('');
+            commands.push('echo "✓ xcode-archive complete"');
+            commands.push('rm -f "$EXPORT_PLIST"');
+        }
+        commands.push('rm -f "$XCCONFIG_PATH"');
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+/**
+ * iOS Archive step executor
+ * Creates an IPA file from a .app bundle
+ */
+export class IosArchiveStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(inputs, _env, _config) {
+        const requirements = [];
+        // Required input
+        requirements.push(this.requireInput('app_path', inputs, 'Path to .app bundle', 'Provide app_path input pointing to your built .app file'));
+        // zip command for creating IPA
+        requirements.push(this.requireCommand('zip', 'zip utility for creating IPA files', 'zip should be pre-installed on macOS'));
+        // .app file - runtime check (created by xcodebuild)
+        if (inputs.app_path) {
+            requirements.push(this.runtimeRequirement(inputs.app_path, '.app bundle file', 'directory', 'xcodebuild'));
+        }
+        return requirements;
+    }
+    async execute(inputs, env, config) {
+        const stepName = 'ios-archive';
+        // Get app path - required
+        let appPath = this.getRequiredInput(inputs, 'app_path', stepName);
+        // Resolve path identifiers
+        if (appPath.startsWith('builds:')) {
+            appPath = appPath.replace('builds:', `${config.paths.buildsDir}/`);
+        }
+        // Get output path - defaults to artifacts/
+        const outputPath = this.getInput(inputs, 'output_path', 'artifacts');
+        // Get output name - optional, will derive from .app name if not provided
+        const outputName = this.getInput(inputs, 'output_name', '');
+        const commands = [];
+        commands.push('# iOS Archive - Create IPA');
+        commands.push(`echo "Creating IPA from: ${this.escapeBash(appPath)}"`);
+        // Check if .app exists
+        commands.push('');
+        commands.push('# Verify .app bundle exists');
+        commands.push(`if [ ! -d '${this.escapeBash(appPath)}' ]; then`);
+        commands.push(`  echo "Error: .app bundle not found at ${this.escapeBash(appPath)}"`);
+        commands.push('  exit 1');
+        commands.push('fi');
+        // Determine output IPA name
+        commands.push('');
+        commands.push('# Determine IPA name');
+        if (outputName && outputName.trim() !== '') {
+            // Use provided name
+            const cleanName = outputName.replace(/\.ipa$/, '');
+            commands.push(`IPA_NAME="${this.escapeBash(cleanName)}"`);
+        }
+        else {
+            // Derive from .app bundle name
+            commands.push(`APP_BUNDLE='${this.escapeBash(appPath)}'`);
+            commands.push('IPA_NAME=$(basename "$APP_BUNDLE" .app)');
+        }
+        commands.push('echo "IPA name: $IPA_NAME.ipa"');
+        // Create IPA
+        commands.push('');
+        commands.push('# Create IPA structure');
+        commands.push('TEMP_DIR=$(mktemp -d)');
+        commands.push('mkdir -p "$TEMP_DIR/Payload"');
+        commands.push('');
+        commands.push('# Copy .app to Payload directory');
+        commands.push(`cp -r '${this.escapeBash(appPath)}' "$TEMP_DIR/Payload/"`);
+        commands.push('');
+        commands.push('# Create IPA (zip with .ipa extension)');
+        commands.push('cd "$TEMP_DIR"');
+        commands.push(`zip -r "$IPA_NAME.ipa" Payload -q`);
+        commands.push('cd - > /dev/null');
+        commands.push('');
+        commands.push('# Create output directory and move IPA');
+        commands.push(`mkdir -p '${this.escapeBash(outputPath)}'`);
+        commands.push(`mv "$TEMP_DIR/$IPA_NAME.ipa" '${this.escapeBash(outputPath)}/'`);
+        commands.push('');
+        commands.push('# Cleanup temp directory');
+        commands.push('rm -rf "$TEMP_DIR"');
+        commands.push('');
+        commands.push('# Show result');
+        commands.push('echo "✓ IPA created successfully"');
+        commands.push(`ls -lh '${this.escapeBash(outputPath)}'/"$IPA_NAME.ipa"`);
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+/**
+ * OTA install step executor.
+ * Generates manifest.plist and a QR code for itms-services:// OTA installation.
+ * The IPA and manifest must be hosted at user-provided HTTPS URLs.
+ */
+export class OtaInstallStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(inputs, _env, _config) {
+        return [
+            this.requireInput('ipa_url', inputs, 'HTTPS URL where the IPA file will be hosted', 'Provide the full HTTPS URL to where the IPA will be uploaded'),
+            this.requireInput('bundle_id', inputs, 'iOS bundle identifier (e.g. com.example.app)'),
+            this.requireInput('bundle_version', inputs, 'App version string (e.g. 1.2.3)'),
+            this.requireInput('title', inputs, 'App display name shown during install'),
+        ];
+    }
+    getOutputs() {
+        return [
+            {
+                name: 'CIBUILD_PUBLIC_INSTALL_PAGE_QR_CODE_IMAGE_URL',
+                type: 'environment',
+                description: 'QR code image URL for the OTA install page (api.qrserver.com link)',
+            },
+        ];
+    }
+    async execute(inputs, _env, _config) {
+        const stepName = 'ota-install';
+        const ipaUrl = this.getRequiredInput(inputs, 'ipa_url', stepName);
+        const bundleId = this.getRequiredInput(inputs, 'bundle_id', stepName);
+        const bundleVersion = this.getRequiredInput(inputs, 'bundle_version', stepName);
+        const title = this.getRequiredInput(inputs, 'title', stepName);
+        const outputDir = this.getInput(inputs, 'output_dir', '.ci/artifacts');
+        const manifestUrlInput = this.getInput(inputs, 'manifest_url', '');
+        const escapedIpaUrl = this.escapeBash(ipaUrl);
+        const escapedBundleId = this.escapeBash(bundleId);
+        const escapedBundleVersion = this.escapeBash(bundleVersion);
+        const escapedTitle = this.escapeBash(title);
+        const escapedOutputDir = this.escapeBash(outputDir);
+        const commands = [];
+        commands.push('# ota-install — generate OTA manifest + QR code');
+        commands.push(`IPA_URL='${escapedIpaUrl}'`);
+        commands.push(`BUNDLE_ID='${escapedBundleId}'`);
+        commands.push(`BUNDLE_VERSION='${escapedBundleVersion}'`);
+        commands.push(`TITLE='${escapedTitle}'`);
+        commands.push(`OUTPUT_DIR='${escapedOutputDir}'`);
+        commands.push('');
+        // Derive manifest URL if not provided
+        if (manifestUrlInput.trim()) {
+            commands.push(`MANIFEST_URL='${this.escapeBash(manifestUrlInput)}'`);
+        }
+        else {
+            commands.push('# Derive manifest URL from IPA URL (same directory, manifest.plist filename)');
+            commands.push('MANIFEST_URL="$(dirname "$IPA_URL")/manifest.plist"');
+        }
+        commands.push('');
+        // Build OTA link
+        commands.push('OTA_URL="itms-services://?action=download-manifest&url=${MANIFEST_URL}"');
+        commands.push('');
+        // Create output dir and write manifest.plist
+        commands.push('mkdir -p "$OUTPUT_DIR"');
+        commands.push('');
+        commands.push('# Write manifest.plist');
+        commands.push('cat > "$OUTPUT_DIR/manifest.plist" << PLIST_EOF');
+        commands.push('<?xml version="1.0" encoding="UTF-8"?>');
+        commands.push('<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">');
+        commands.push('<plist version="1.0">');
+        commands.push('<dict>');
+        commands.push('  <key>items</key>');
+        commands.push('  <array>');
+        commands.push('    <dict>');
+        commands.push('      <key>assets</key>');
+        commands.push('      <array>');
+        commands.push('        <dict>');
+        commands.push('          <key>kind</key><string>software-package</string>');
+        commands.push('          <key>url</key><string>${IPA_URL}</string>');
+        commands.push('        </dict>');
+        commands.push('      </array>');
+        commands.push('      <key>metadata</key>');
+        commands.push('      <dict>');
+        commands.push('        <key>bundle-identifier</key><string>${BUNDLE_ID}</string>');
+        commands.push('        <key>bundle-version</key><string>${BUNDLE_VERSION}</string>');
+        commands.push('        <key>kind</key><string>software</string>');
+        commands.push('        <key>title</key><string>${TITLE}</string>');
+        commands.push('      </dict>');
+        commands.push('    </dict>');
+        commands.push('  </array>');
+        commands.push('</dict>');
+        commands.push('</plist>');
+        commands.push('PLIST_EOF');
+        commands.push('');
+        commands.push('echo "✓ manifest.plist written to $OUTPUT_DIR/manifest.plist"');
+        commands.push('');
+        // Generate QR code (qrencode preferred; graceful fallback)
+        commands.push('# Generate QR code');
+        commands.push('if command -v qrencode &>/dev/null; then');
+        commands.push('  echo ""');
+        commands.push('  echo "Scan to install:"');
+        commands.push('  qrencode -t ansiutf8 "$OTA_URL"');
+        commands.push('else');
+        commands.push('  echo "ℹ  Install qrencode for terminal QR: brew install qrencode"');
+        commands.push('fi');
+        commands.push('');
+        // Print summary
+        commands.push('echo ""');
+        commands.push('echo "─────────────────────────────────────────"');
+        commands.push('echo "OTA Install Summary"');
+        commands.push('echo "─────────────────────────────────────────"');
+        commands.push('echo "IPA URL:      $IPA_URL"');
+        commands.push('echo "Manifest URL: $MANIFEST_URL"');
+        commands.push('echo "OTA Link:     $OTA_URL"');
+        commands.push('echo ""');
+        commands.push('echo "Host the IPA and manifest.plist at the URLs above, then share the OTA link."');
+        commands.push('echo "─────────────────────────────────────────"');
+        commands.push('');
+        // Export QR image URL to envstore (api.qrserver.com image link, usable in notifications)
+        commands.push('# Export QR image URL to envstore for downstream steps (e.g. Slack notifications)');
+        commands.push('ENCODED_OTA="$(python3 -c "import urllib.parse,sys; print(urllib.parse.quote(sys.argv[1]))" "$OTA_URL" 2>/dev/null || printf "%s" "$OTA_URL" | sed \'s/ /%20/g; s/:/%3A/g; s|/|%2F|g; s/?/%3F/g; s/=/%3D/g; s/&/%26/g\')"');
+        commands.push('QR_IMAGE_URL="https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=${ENCODED_OTA}"');
+        commands.push('');
+        commands.push('ENVSTORE_FILE="${ENVMAN_ENVSTORE_PATH:-.ci/.envstore.json}"');
+        commands.push('if [ -f "$ENVSTORE_FILE" ]; then');
+        commands.push('  node -e "');
+        commands.push('    const fs=require(\'fs\');');
+        commands.push('    const s=JSON.parse(fs.readFileSync(process.argv[1],\'utf-8\'));');
+        commands.push('    s.envs=s.envs||[];');
+        commands.push('    s.envs=s.envs.filter(e=>e.key!==\'CIBUILD_PUBLIC_INSTALL_PAGE_QR_CODE_IMAGE_URL\');');
+        commands.push('    s.envs.push({key:\'CIBUILD_PUBLIC_INSTALL_PAGE_QR_CODE_IMAGE_URL\',value:process.argv[2]});');
+        commands.push('    fs.writeFileSync(process.argv[1],JSON.stringify(s));');
+        commands.push('  " "$ENVSTORE_FILE" "$QR_IMAGE_URL" 2>/dev/null || true');
+        commands.push('fi');
+        commands.push('export CIBUILD_PUBLIC_INSTALL_PAGE_QR_CODE_IMAGE_URL="$QR_IMAGE_URL"');
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+/**
+ * Builds the app and tests without executing them.
+ * Produces an .xctestrun file for use with xcode-test-without-building.
+ */
+export class XcodeBuildForTestStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(inputs, _env, _config) {
+        const requirements = [];
+        requirements.push(this.requireCommand('xcodebuild', 'Xcode Command Line Tools are required', 'Install Xcode, then run: xcode-select --install'));
+        requirements.push(this.requireInput('project_path', inputs, 'Path to .xcodeproj or .xcworkspace'));
+        requirements.push(this.requireInput('scheme', inputs, 'Xcode scheme name'));
+        if (inputs.project_path && !existsSync(inputs.project_path)) {
+            requirements.push(this.runtimeRequirement(inputs.project_path, 'Xcode project/workspace file', 'file', 'git-clone'));
+        }
+        return requirements;
+    }
+    getOutputs() {
+        return [
+            { name: 'CIBUILD_TEST_BUNDLE_PATH', type: 'environment', description: 'Directory containing the built test bundle' },
+            { name: 'CIBUILD_XCTESTRUN_FILE_PATH', type: 'environment', description: 'Path to the generated .xctestrun file' },
+        ];
+    }
+    async execute(inputs, _env, _config) {
+        const stepName = 'xcode-build-for-test';
+        const projectPath = this.getRequiredInput(inputs, 'project_path', stepName);
+        const scheme = this.getRequiredInput(inputs, 'scheme', stepName);
+        const configuration = this.getInput(inputs, 'configuration', 'Debug');
+        const destination = this.getInput(inputs, 'destination', 'generic/platform=iOS Simulator');
+        const testPlan = this.getInput(inputs, 'test_plan', '');
+        const xcconfigContent = this.getInput(inputs, 'xcconfig_content', '');
+        const xcodebuildOptions = this.getInput(inputs, 'xcodebuild_options', '');
+        const outputDir = this.getInput(inputs, 'output_dir', 'build');
+        const escapedPath = this.escapeBash(projectPath);
+        const escapedScheme = this.escapeBash(scheme);
+        const commands = [];
+        commands.push('# xcode-build-for-test — build-for-testing');
+        commands.push(`echo "Building for testing: ${escapedPath}"`);
+        commands.push(`echo "Scheme: ${escapedScheme}"`);
+        commands.push('');
+        // Output directory
+        commands.push(`mkdir -p '${this.escapeBash(outputDir)}'`);
+        commands.push(`OUTPUT_DIR="$(cd '${this.escapeBash(outputDir)}' && pwd)"`);
+        commands.push('');
+        // xcconfig
+        if (xcconfigContent.trim()) {
+            commands.push('XCCONFIG_FILE="$(mktemp -t cibuild-xcconfig).xcconfig"');
+            commands.push(`cat > "$XCCONFIG_FILE" << 'XCCONFIG_EOF'`);
+            commands.push(xcconfigContent);
+            commands.push('XCCONFIG_EOF');
+            commands.push('');
+        }
+        // Determine project type
+        commands.push(`if [[ '${escapedPath}' == *.xcworkspace ]]; then`);
+        commands.push('  PROJECT_TYPE="-workspace"');
+        commands.push('else');
+        commands.push('  PROJECT_TYPE="-project"');
+        commands.push('fi');
+        commands.push('');
+        // Build command
+        let cmd = 'xcodebuild build-for-testing';
+        cmd += ` "$PROJECT_TYPE" '${escapedPath}'`;
+        cmd += ` -scheme '${escapedScheme}'`;
+        cmd += ` -configuration '${this.escapeBash(configuration)}'`;
+        cmd += ` -destination '${this.escapeBash(destination)}'`;
+        cmd += ` -derivedDataPath "$OUTPUT_DIR/DerivedData"`;
+        if (testPlan) {
+            cmd += ` -testPlan '${this.escapeBash(testPlan)}'`;
+        }
+        if (xcconfigContent.trim()) {
+            cmd += ' -xcconfig "$XCCONFIG_FILE"';
+        }
+        if (xcodebuildOptions) {
+            cmd += ` ${xcodebuildOptions}`;
+        }
+        commands.push(cmd);
+        commands.push('');
+        // Locate .xctestrun file
+        commands.push('# Locate generated .xctestrun file');
+        commands.push('XCTESTRUN_PATH=$(find "$OUTPUT_DIR/DerivedData/Build/Products" -name "*.xctestrun" | head -1)');
+        commands.push('if [ -z "$XCTESTRUN_PATH" ]; then');
+        commands.push('  echo "❌ Error: .xctestrun file not found"');
+        commands.push('  exit 1');
+        commands.push('fi');
+        commands.push('');
+        commands.push('TEST_BUNDLE_DIR="$(dirname "$XCTESTRUN_PATH")"');
+        commands.push('echo "✅ Build for testing complete"');
+        commands.push('echo "xctestrun: $XCTESTRUN_PATH"');
+        commands.push('');
+        // Export env vars
+        commands.push('envman add --key CIBUILD_TEST_BUNDLE_PATH --value "$TEST_BUNDLE_DIR"');
+        commands.push('envman add --key CIBUILD_XCTESTRUN_FILE_PATH --value "$XCTESTRUN_PATH"');
+        if (xcconfigContent.trim()) {
+            commands.push('rm -f "$XCCONFIG_FILE"');
+        }
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+/**
+ * Runs pre-compiled tests from an .xctestrun file.
+ */
+export class XcodeTestWithoutBuildingStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(_inputs, _env, _config) {
+        return [
+            this.requireCommand('xcodebuild', 'Xcode Command Line Tools are required', 'Install Xcode, then run: xcode-select --install'),
+        ];
+    }
+    getOutputs() {
+        return [
+            { name: 'CIBUILD_XCRESULT_PATH', type: 'environment', description: 'Path to the .xcresult test result bundle' },
+        ];
+    }
+    async execute(inputs, _env, _config) {
+        const stepName = 'xcode-test-without-building';
+        const xctestrun = this.getInput(inputs, 'xctestrun', '$CIBUILD_XCTESTRUN_FILE_PATH');
+        const destination = this.getInput(inputs, 'destination', 'platform=iOS Simulator,name=iPhone 15,OS=latest');
+        const onlyTesting = this.getInput(inputs, 'only_testing', '');
+        const skipTesting = this.getInput(inputs, 'skip_testing', '');
+        const repetitionMode = this.getInput(inputs, 'test_repetition_mode', 'none');
+        const maxRepetitions = this.getInput(inputs, 'maximum_test_repetitions', '3');
+        const xcodebuildOptions = this.getInput(inputs, 'xcodebuild_options', '');
+        const commands = [];
+        commands.push('# xcode-test-without-building');
+        commands.push('echo "Running pre-built tests..."');
+        commands.push('');
+        // Resolve xctestrun path
+        commands.push(`XCTESTRUN_FILE="${xctestrun}"`);
+        commands.push('if [ -z "$XCTESTRUN_FILE" ]; then');
+        commands.push('  echo "❌ Error: xctestrun file path is empty. Run xcode-build-for-test first."');
+        commands.push('  exit 1');
+        commands.push('fi');
+        commands.push('if [ ! -f "$XCTESTRUN_FILE" ]; then');
+        commands.push('  echo "❌ Error: xctestrun file not found: $XCTESTRUN_FILE"');
+        commands.push('  exit 1');
+        commands.push('fi');
+        commands.push('echo "xctestrun: $XCTESTRUN_FILE"');
+        commands.push('');
+        // Result bundle path
+        commands.push('RESULT_BUNDLE_PATH="build/test-results/$(date +%Y%m%d_%H%M%S).xcresult"');
+        commands.push('mkdir -p "$(dirname "$RESULT_BUNDLE_PATH")"');
+        commands.push('');
+        // Build command
+        let cmd = 'xcodebuild test-without-building';
+        cmd += ' -xctestrun "$XCTESTRUN_FILE"';
+        cmd += ` -destination '${this.escapeBash(destination)}'`;
+        cmd += ' -resultBundlePath "$RESULT_BUNDLE_PATH"';
+        // Test filtering
+        if (onlyTesting) {
+            for (const test of onlyTesting.split('\n').filter(Boolean)) {
+                cmd += ` -only-testing:'${this.escapeBash(test.trim())}'`;
+            }
+        }
+        if (skipTesting) {
+            for (const test of skipTesting.split('\n').filter(Boolean)) {
+                cmd += ` -skip-testing:'${this.escapeBash(test.trim())}'`;
+            }
+        }
+        // Repetition
+        if (repetitionMode && repetitionMode !== 'none') {
+            if (repetitionMode === 'until_failure') {
+                cmd += ' -run-tests-until-failure';
+            }
+            else if (repetitionMode === 'retry_on_failure') {
+                cmd += ' -retry-tests-on-failure';
+            }
+            cmd += ` -test-iterations ${maxRepetitions}`;
+        }
+        if (xcodebuildOptions) {
+            cmd += ` ${xcodebuildOptions}`;
+        }
+        commands.push(cmd);
+        commands.push('');
+        commands.push('echo "✅ Tests completed"');
+        commands.push('echo "Result bundle: $RESULT_BUNDLE_PATH"');
+        commands.push('');
+        // Export
+        commands.push('envman add --key CIBUILD_XCRESULT_PATH --value "$RESULT_BUNDLE_PATH"');
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+/**
+ * Builds an iOS/tvOS/watchOS app for the simulator.
+ * Produces a .app bundle with code signing disabled by default.
+ */
+export class XcodeBuildForSimulatorStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(inputs, _env, _config) {
+        const requirements = [];
+        requirements.push(this.requireCommand('xcodebuild', 'Xcode Command Line Tools are required', 'Install Xcode, then run: xcode-select --install'));
+        requirements.push(this.requireInput('project_path', inputs, 'Path to .xcodeproj or .xcworkspace'));
+        requirements.push(this.requireInput('scheme', inputs, 'Xcode scheme name'));
+        if (inputs.project_path && !existsSync(inputs.project_path)) {
+            requirements.push(this.runtimeRequirement(inputs.project_path, 'Xcode project/workspace file', 'file', 'git-clone'));
+        }
+        return requirements;
+    }
+    getOutputs() {
+        return [
+            { name: 'CIBUILD_APP_DIR_PATH', type: 'environment', description: 'Path to the generated .app directory' },
+        ];
+    }
+    async execute(inputs, _env, _config) {
+        const stepName = 'xcode-build-for-simulator';
+        const projectPath = this.getRequiredInput(inputs, 'project_path', stepName);
+        const scheme = this.getRequiredInput(inputs, 'scheme', stepName);
+        const configuration = this.getInput(inputs, 'configuration', '');
+        const destination = this.getInput(inputs, 'destination', 'generic/platform=iOS Simulator');
+        const performClean = this.getInput(inputs, 'perform_clean_action', 'no');
+        const xcconfigContent = this.getInput(inputs, 'xcconfig_content', 'CODE_SIGNING_ALLOWED=NO');
+        const xcodebuildOptions = this.getInput(inputs, 'xcodebuild_options', '');
+        const outputDir = this.getInput(inputs, 'output_dir', 'build');
+        const escapedPath = this.escapeBash(projectPath);
+        const escapedScheme = this.escapeBash(scheme);
+        const commands = [];
+        commands.push('# xcode-build-for-simulator');
+        commands.push(`echo "Building for simulator: ${escapedPath}"`);
+        commands.push(`echo "Scheme: ${escapedScheme}"`);
+        commands.push('');
+        // Output dir
+        commands.push(`mkdir -p '${this.escapeBash(outputDir)}'`);
+        commands.push(`OUTPUT_DIR="$(cd '${this.escapeBash(outputDir)}' && pwd)"`);
+        commands.push('');
+        // xcconfig
+        commands.push('XCCONFIG_FILE="$(mktemp -t cibuild-xcconfig).xcconfig"');
+        if (xcconfigContent.trim()) {
+            commands.push(`cat > "$XCCONFIG_FILE" << 'XCCONFIG_EOF'`);
+            commands.push(xcconfigContent);
+            commands.push('XCCONFIG_EOF');
+        }
+        else {
+            commands.push('echo "CODE_SIGNING_ALLOWED=NO" > "$XCCONFIG_FILE"');
+        }
+        commands.push('');
+        // Project type
+        commands.push(`if [[ '${escapedPath}' == *.xcworkspace ]]; then`);
+        commands.push('  PROJECT_TYPE="-workspace"');
+        commands.push('else');
+        commands.push('  PROJECT_TYPE="-project"');
+        commands.push('fi');
+        commands.push('');
+        // Build command
+        let cmd = 'xcodebuild';
+        if (performClean === 'yes') {
+            cmd += ' clean';
+        }
+        cmd += ' build';
+        cmd += ` "$PROJECT_TYPE" '${escapedPath}'`;
+        cmd += ` -scheme '${escapedScheme}'`;
+        if (configuration) {
+            cmd += ` -configuration '${this.escapeBash(configuration)}'`;
+        }
+        cmd += ` -destination '${this.escapeBash(destination)}'`;
+        cmd += ` CONFIGURATION_BUILD_DIR="$OUTPUT_DIR"`;
+        cmd += ' -xcconfig "$XCCONFIG_FILE"';
+        if (xcodebuildOptions) {
+            cmd += ` ${xcodebuildOptions}`;
+        }
+        commands.push(cmd);
+        commands.push('');
+        // Locate .app
+        commands.push('# Locate generated .app');
+        commands.push('APP_PATH=$(find "$OUTPUT_DIR" -maxdepth 1 -name "*.app" -type d | head -1)');
+        commands.push('if [ -z "$APP_PATH" ]; then');
+        commands.push('  echo "❌ Error: .app not found in $OUTPUT_DIR"');
+        commands.push('  exit 1');
+        commands.push('fi');
+        commands.push('');
+        commands.push('echo "✅ Simulator build complete"');
+        commands.push('echo "App: $APP_PATH"');
+        commands.push('');
+        // Export
+        commands.push('envman add --key CIBUILD_APP_DIR_PATH --value "$APP_PATH"');
+        commands.push('rm -f "$XCCONFIG_FILE"');
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+/**
+ * Exports an IPA from an existing .xcarchive using xcodebuild -exportArchive.
+ */
+export class ExportXcarchiveStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(_inputs, _env, _config) {
+        return [
+            this.requireCommand('xcodebuild', 'Xcode is required for archive export'),
+        ];
+    }
+    getOutputs() {
+        return [
+            { name: 'CIBUILD_IPA_PATH', type: 'environment', description: 'Path to the exported IPA file' },
+            { name: 'CIBUILD_DSYM_PATH', type: 'environment', description: 'Path to the zipped dSYM files' },
+        ];
+    }
+    async execute(inputs, _env, _config) {
+        const stepName = 'export-xcarchive';
+        const archivePath = this.getRequiredInput(inputs, 'archive_path', stepName);
+        const product = this.getInput(inputs, 'product', 'app');
+        const distributionMethod = this.getInput(inputs, 'distribution_method', 'development');
+        const compileBitcode = this.getInput(inputs, 'compile_bitcode', 'yes') === 'yes';
+        const uploadBitcode = this.getInput(inputs, 'upload_bitcode', 'yes') === 'yes';
+        const exportOptionsPlistContent = this.getInput(inputs, 'export_options_plist_content', '');
+        const verbose = this.getInput(inputs, 'verbose_log', 'no') === 'yes';
+        const commands = [];
+        commands.push('# export-xcarchive — export IPA from .xcarchive');
+        commands.push('echo "📦 Exporting IPA from xcarchive..."');
+        commands.push('');
+        commands.push(`ARCHIVE_PATH='${this.escapeBash(archivePath)}'`);
+        commands.push('');
+        // Validate archive exists
+        commands.push('if [ ! -d "$ARCHIVE_PATH" ]; then');
+        commands.push('  echo "❌ Error: Archive not found: $ARCHIVE_PATH"');
+        commands.push('  exit 1');
+        commands.push('fi');
+        commands.push('');
+        // Set up export directory
+        commands.push('EXPORT_DIR="${CIBUILD_DEPLOY_DIR:-./artifacts}/export"');
+        commands.push('mkdir -p "$EXPORT_DIR"');
+        commands.push('');
+        // Generate or use provided ExportOptions.plist
+        commands.push('EXPORT_OPTIONS="$EXPORT_DIR/ExportOptions.plist"');
+        if (exportOptionsPlistContent) {
+            commands.push('cat > "$EXPORT_OPTIONS" << \'PLIST_EOF\'');
+            commands.push(exportOptionsPlistContent);
+            commands.push('PLIST_EOF');
+        }
+        else {
+            // Map distribution method for Xcode 15.3+
+            commands.push('# Determine distribution method');
+            commands.push(`METHOD='${this.escapeBash(distributionMethod)}'`);
+            commands.push('XCODE_VERSION=$(xcodebuild -version | head -1 | grep -oE "[0-9]+\\.[0-9]+" || echo "0.0")');
+            commands.push('XCODE_MAJOR=$(echo "$XCODE_VERSION" | cut -d. -f1)');
+            commands.push('XCODE_MINOR=$(echo "$XCODE_VERSION" | cut -d. -f2)');
+            commands.push('if [ "$XCODE_MAJOR" -ge 16 ] || ([ "$XCODE_MAJOR" -eq 15 ] && [ "$XCODE_MINOR" -ge 3 ]); then');
+            commands.push('  case "$METHOD" in');
+            commands.push('    development) METHOD="debugging" ;;');
+            commands.push('    app-store) METHOD="app-store-connect" ;;');
+            commands.push('    ad-hoc) METHOD="release-testing" ;;');
+            commands.push('  esac');
+            commands.push('fi');
+            commands.push('');
+            commands.push('cat > "$EXPORT_OPTIONS" << PLIST_EOF');
+            commands.push('<?xml version="1.0" encoding="UTF-8"?>');
+            commands.push('<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">');
+            commands.push('<plist version="1.0">');
+            commands.push('<dict>');
+            commands.push('  <key>method</key>');
+            commands.push('  <string>$METHOD</string>');
+            commands.push(`  <key>compileBitcode</key>`);
+            commands.push(`  <${compileBitcode}/>`);
+            commands.push(`  <key>uploadBitcode</key>`);
+            commands.push(`  <${uploadBitcode}/>`);
+            if (product === 'app-clip') {
+                commands.push('  <key>exportForThinning</key>');
+                commands.push('  <string>app-clip</string>');
+            }
+            commands.push('</dict>');
+            commands.push('</plist>');
+            commands.push('PLIST_EOF');
+        }
+        commands.push('');
+        // Run xcodebuild -exportArchive
+        const verboseFlag = verbose ? '' : ' -quiet';
+        commands.push('echo "Exporting with method: $METHOD"');
+        commands.push(`xcodebuild -exportArchive \\`);
+        commands.push(`  -archivePath "$ARCHIVE_PATH" \\`);
+        commands.push(`  -exportPath "$EXPORT_DIR" \\`);
+        commands.push(`  -exportOptionsPlist "$EXPORT_OPTIONS"${verboseFlag}`);
+        commands.push('');
+        // Find IPA
+        commands.push('# Find exported IPA');
+        commands.push('IPA_PATH=$(find "$EXPORT_DIR" -name "*.ipa" | head -1)');
+        commands.push('if [ -z "$IPA_PATH" ]; then');
+        commands.push('  echo "❌ Error: No IPA found in export directory"');
+        commands.push('  exit 1');
+        commands.push('fi');
+        commands.push('echo "✅ Exported IPA: $IPA_PATH"');
+        commands.push('');
+        // Collect dSYMs
+        commands.push('# Collect dSYMs');
+        commands.push('DSYM_DIR="$ARCHIVE_PATH/dSYMs"');
+        commands.push('DSYM_ZIP=""');
+        commands.push('if [ -d "$DSYM_DIR" ] && [ "$(ls -A "$DSYM_DIR" 2>/dev/null)" ]; then');
+        commands.push('  DSYM_ZIP="$EXPORT_DIR/dSYMs.zip"');
+        commands.push('  cd "$DSYM_DIR" && zip -r "$DSYM_ZIP" . && cd -');
+        commands.push('  echo "dSYMs: $DSYM_ZIP"');
+        commands.push('fi');
+        commands.push('');
+        // Export env vars
+        commands.push('envman add --key CIBUILD_IPA_PATH --value "$IPA_PATH"');
+        commands.push('if [ -n "$DSYM_ZIP" ]; then');
+        commands.push('  envman add --key CIBUILD_DSYM_PATH --value "$DSYM_ZIP"');
+        commands.push('fi');
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+//# sourceMappingURL=xcode.js.map