@invarn/cibuild 1.3.15 → 1.3.17

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

@@ -0,0 +1,345 @@
+/**
+ * Base interfaces and utilities for YAML step executors
+ */
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+/**
+ * Base class for step executors providing common utilities
+ */
+export class BaseStepExecutor {
+    /**
+     * Creates a script-based StepDef
+     * @param script Bash script content
+     * @param name Step name
+     * @returns StepDef with kind 'script'
+     */
+    createScriptStep(script, name) {
+        return {
+            id: '', // Will be set by converter
+            name,
+            kind: 'script',
+            shell: 'bash',
+            script,
+        };
+    }
+    /**
+     * Creates a Python-based StepDef
+     * @param script Python script content
+     * @param name Step name
+     * @returns StepDef with kind 'python'
+     */
+    createPythonStep(script, name) {
+        return {
+            id: '', // Will be set by converter
+            name,
+            kind: 'python',
+            script,
+        };
+    }
+    /**
+     * Creates a Node.js-based StepDef
+     * @param script Node.js script content
+     * @param name Step name
+     * @returns StepDef with kind 'node'
+     */
+    createNodeStep(script, name) {
+        return {
+            id: '', // Will be set by converter
+            name,
+            kind: 'node',
+            script,
+        };
+    }
+    /**
+     * Creates a Ruby-based StepDef
+     * @param script Ruby script content
+     * @param name Step name
+     * @returns StepDef with kind 'ruby'
+     */
+    createRubyStep(script, name) {
+        return {
+            id: '', // Will be set by converter
+            name,
+            kind: 'ruby',
+            script,
+        };
+    }
+    /**
+     * Gets an input value with a default fallback
+     * @param inputs Input object
+     * @param key Input key
+     * @param defaultValue Default value if not found
+     * @returns Input value or default
+     */
+    getInput(inputs, key, defaultValue) {
+        if (inputs && key in inputs && inputs[key] !== undefined) {
+            return inputs[key];
+        }
+        return defaultValue;
+    }
+    /**
+     * Gets a required input value, throws if not found
+     * @param inputs Input object
+     * @param key Input key
+     * @param stepName Step name for error message
+     * @returns Input value
+     * @throws Error if input not found
+     */
+    getRequiredInput(inputs, key, stepName) {
+        if (!inputs || !(key in inputs) || inputs[key] === undefined) {
+            throw new Error(`Missing required input '${key}' for step '${stepName}'`);
+        }
+        return inputs[key];
+    }
+    /**
+     * Escapes a string for safe use in bash scripts
+     * @param str String to escape
+     * @returns Escaped string safe for bash
+     */
+    escapeBash(str) {
+        // Escape single quotes by replacing ' with '\''
+        return str.replace(/'/g, "'\\''");
+    }
+    /**
+     * Interpolates environment variables in a string at runtime
+     * Supports ${VAR} and $VAR formats
+     * @param str String to interpolate
+     * @param env Environment variables
+     * @returns Interpolated string
+     */
+    interpolateString(str, env) {
+        let result = str;
+        // Format 1: ${VAR}
+        result = result.replace(/\$\{([A-Z_][A-Z0-9_]*)\}/g, (match, varName) => {
+            return env[varName] || '';
+        });
+        // Format 2: $VAR (must not be followed by alphanumeric or underscore)
+        result = result.replace(/\$([A-Z_][A-Z0-9_]*)(?![A-Z0-9_])/g, (match, varName) => {
+            return env[varName] || '';
+        });
+        return result;
+    }
+    /**
+     * Creates a bash script with proper error handling
+     * Automatically sources envman store to load variables from previous steps
+     * @param scriptContent Main script content
+     * @param stepName Step name for error messages
+     * @returns Complete bash script with error handling
+     */
+    createBashScript(scriptContent, stepName) {
+        return `#!/bin/bash
+set -e  # Exit on error
+set -o pipefail  # Catch errors in pipes
+
+# Step: ${stepName}
+
+# Load environment variables from envman store (set by previous steps)
+ENVSTORE_FILE="\${ENVMAN_ENVSTORE_PATH:-.ci/.envstore.json}"
+if [ -f "$ENVSTORE_FILE" ]; then
+  while IFS='=' read -r key value; do
+    [ -n "$key" ] && export "$key=$value"
+  done < <(node -e "const fs=require('fs');try{const s=JSON.parse(fs.readFileSync('$ENVSTORE_FILE','utf-8'));(s.envs||[]).forEach(e=>console.log(e.key+'='+e.value))}catch(err){}" 2>/dev/null || true)
+fi
+
+${scriptContent}
+`;
+    }
+    /**
+     * Creates a multiline bash script from an array of commands
+     * @param commands Array of bash commands
+     * @param stepName Step name for error messages
+     * @returns Complete bash script
+     */
+    createBashScriptFromCommands(commands, stepName) {
+        const scriptContent = commands.join('\n');
+        return this.createBashScript(scriptContent, stepName);
+    }
+    // ========== VALIDATION METHODS ==========
+    // These methods are READ-ONLY and safe to run on user's machine
+    /**
+     * Default implementation - no validation requirements
+     * Override in subclasses to add step-specific validations
+     */
+    getValidationRequirements(_inputs, _env, _config) {
+        return [];
+    }
+    /**
+     * Default implementation - no outputs
+     * Override in subclasses to declare step outputs
+     */
+    getOutputs() {
+        return [];
+    }
+    /**
+     * Returns true if this step will be skipped entirely in local mode.
+     * When true, the validator skips all validation (requirements + auto-discovery).
+     * Override in steps that check config.local in execute() and skip.
+     */
+    isSkippedInLocalMode() {
+        return false;
+    }
+    /**
+     * Creates a requirement for an external command to exist
+     * Uses 'which' to check - READ-ONLY operation
+     */
+    requireCommand(command, description, hint) {
+        return {
+            category: 'command',
+            name: command,
+            description,
+            timing: 'pre-execution',
+            severity: 'error',
+            hint,
+            check: async () => this.checkCommandExists(command),
+        };
+    }
+    /**
+     * Creates a requirement for an environment variable to be set
+     * Reads process.env - READ-ONLY operation
+     */
+    requireEnvVar(varName, description, env, hint) {
+        return {
+            category: 'environment',
+            name: varName,
+            description,
+            timing: 'pre-execution',
+            severity: 'error',
+            hint,
+            check: async () => ({
+                passed: !!(env[varName] || process.env[varName]),
+                message: env[varName] || process.env[varName]
+                    ? `${varName} is set`
+                    : `${varName} is not set`,
+            }),
+        };
+    }
+    /**
+     * Creates a requirement for a file to exist
+     * Uses existsSync - READ-ONLY operation
+     */
+    requireFile(path, description, hint) {
+        return {
+            category: 'file',
+            name: path,
+            description,
+            timing: 'pre-execution',
+            severity: 'error',
+            hint,
+            check: async () => ({
+                passed: existsSync(path),
+                message: existsSync(path)
+                    ? `File exists: ${path}`
+                    : `File not found: ${path}`,
+            }),
+        };
+    }
+    /**
+     * Creates a requirement for a directory to exist
+     * Uses existsSync - READ-ONLY operation
+     */
+    requireDirectory(path, description, hint) {
+        return {
+            category: 'directory',
+            name: path,
+            description,
+            timing: 'pre-execution',
+            severity: 'error',
+            hint,
+            check: async () => ({
+                passed: existsSync(path),
+                message: existsSync(path)
+                    ? `Directory exists: ${path}`
+                    : `Directory not found: ${path}`,
+            }),
+        };
+    }
+    /**
+     * Creates a requirement for a YAML input
+     * Just checks object property - READ-ONLY operation
+     */
+    requireInput(inputName, inputs, description, hint) {
+        return {
+            category: 'input',
+            name: inputName,
+            description,
+            timing: 'pre-execution',
+            severity: 'error',
+            hint,
+            check: async () => ({
+                passed: inputs && inputName in inputs && inputs[inputName] !== undefined,
+                message: inputs && inputs[inputName] !== undefined
+                    ? `Input '${inputName}' is provided`
+                    : `Missing required input '${inputName}'`,
+            }),
+        };
+    }
+    /**
+     * Creates a runtime-only requirement (checked at step execution time)
+     * Used for files/directories that will be created by earlier steps
+     */
+    runtimeRequirement(name, description, category = 'file', providedBy) {
+        return {
+            category,
+            name,
+            description,
+            timing: 'runtime',
+            severity: 'info',
+            providedBy,
+        };
+    }
+    /**
+     * Checks if a command exists on the system
+     * Uses 'which' command - READ-ONLY operation
+     */
+    async checkCommandExists(command) {
+        try {
+            // Use 'which' on macOS/Linux, 'where' on Windows
+            const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+            execSync(`${whichCmd} ${command}`, { stdio: 'pipe' });
+            return {
+                passed: true,
+                message: `Command '${command}' is available`,
+            };
+        }
+        catch {
+            return {
+                passed: false,
+                message: `Command '${command}' not found in PATH`,
+            };
+        }
+    }
+    /**
+     * Checks if Java is installed at a specific version
+     * Uses java_home or checks directory existence - READ-ONLY operation
+     */
+    async checkJavaVersion(version) {
+        try {
+            if (process.platform === 'darwin') {
+                // macOS: use java_home
+                execSync(`/usr/libexec/java_home -v "${version}"`, { stdio: 'pipe' });
+            }
+            else {
+                // Linux: check common paths
+                const paths = [
+                    `/usr/lib/jvm/java-${version}-openjdk-amd64`,
+                    `/usr/lib/jvm/java-${version}-openjdk`,
+                    `/usr/lib/jvm/temurin-${version}-jdk-amd64`,
+                ];
+                const exists = paths.some((p) => existsSync(p));
+                if (!exists)
+                    throw new Error('Not found');
+            }
+            return { passed: true, message: `Java ${version} is available` };
+        }
+        catch {
+            return {
+                passed: false,
+                message: `Java ${version} not found`,
+                details: process.platform === 'darwin'
+                    ? `Install: brew install openjdk@${version}`
+                    : `Install: sudo apt install openjdk-${version}-jdk`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/src/yaml/steps/bitrise-android-tools.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Bitrise install-missing-android-tools step implementation
+ * Maps Bitrise install-missing-android-tools@* to CI Build Android environment setup
+ */
+import { BaseStepExecutor } from './base.js';
+import type { StepDef, CIConfig } from '../../types.js';
+import type { ValidationRequirement, StepOutput } from '../validation-types.js';
+/**
+ * Inputs for install-missing-android-tools step
+ */
+export interface BitriseAndroidToolsInputs {
+    gradlew_path?: string;
+    ndk_revision?: string;
+}
+/**
+ * Bitrise install-missing-android-tools step executor (FR-3)
+ * Ensures Android development environment is properly configured
+ *
+ * Supports Bitrise step versions: install-missing-android-tools@1, @2, @3, @4
+ */
+export declare class BitriseAndroidToolsStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(_inputs: BitriseAndroidToolsInputs, env: Record<string, string>, _config: CIConfig): ValidationRequirement[];
+    getOutputs(): StepOutput[];
+    execute(inputs: BitriseAndroidToolsInputs, env: Record<string, string>, config: CIConfig): Promise<StepDef>;
+}
+//# sourceMappingURL=bitrise-android-tools.d.ts.map

package/dist/src/yaml/steps/bitrise-android-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitrise-android-tools.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/bitrise-android-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,+BAAgC,SAAQ,gBAAgB;IACnE,yBAAyB,CACvB,OAAO,EAAE,yBAAyB,EAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAiD1B,UAAU,IAAI,UAAU,EAAE;IAMpB,OAAO,CAAC,MAAM,EAAE,yBAAyB,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;CAyJlH"}

package/dist/src/yaml/steps/bitrise-android-tools.js

@@ -0,0 +1,198 @@
+/**
+ * Bitrise install-missing-android-tools step implementation
+ * Maps Bitrise install-missing-android-tools@* to CI Build Android environment setup
+ */
+import { BaseStepExecutor } from './base.js';
+/**
+ * Bitrise install-missing-android-tools step executor (FR-3)
+ * Ensures Android development environment is properly configured
+ *
+ * Supports Bitrise step versions: install-missing-android-tools@1, @2, @3, @4
+ */
+export class BitriseAndroidToolsStepExecutor extends BaseStepExecutor {
+    getValidationRequirements(_inputs, env, _config) {
+        // Check if ANDROID_HOME is set OR can be auto-detected
+        const androidHomeSet = !!(env.ANDROID_HOME || process.env.ANDROID_HOME);
+        return [
+            {
+                category: 'environment',
+                name: 'ANDROID_HOME',
+                description: 'Android SDK installation directory',
+                timing: 'pre-execution',
+                severity: 'info', // Info because we can auto-detect
+                check: async () => {
+                    if (androidHomeSet) {
+                        return {
+                            passed: true,
+                            message: 'ANDROID_HOME is set',
+                        };
+                    }
+                    // Check if we can auto-detect
+                    const { existsSync } = await import('node:fs');
+                    const { homedir } = await import('node:os');
+                    const homeDir = homedir();
+                    const commonPaths = [
+                        `${homeDir}/Library/Android/sdk`, // macOS
+                        `${homeDir}/Android/Sdk`, // Linux
+                        '/usr/local/android-sdk',
+                    ];
+                    const foundPath = commonPaths.find(p => existsSync(p));
+                    if (foundPath) {
+                        return {
+                            passed: true,
+                            message: `ANDROID_HOME not set, but will auto-detect at: ${foundPath}`,
+                        };
+                    }
+                    return {
+                        passed: false,
+                        message: 'ANDROID_HOME not set and Android SDK not found in common locations',
+                    };
+                },
+            },
+            this.runtimeRequirement('gradlew', 'Gradle wrapper', 'file', 'git-clone'),
+        ];
+    }
+    getOutputs() {
+        return [
+            { name: 'ANDROID_HOME', type: 'environment', description: 'Android SDK installation directory' },
+        ];
+    }
+    async execute(inputs, env, config) {
+        const stepName = 'install-missing-android-tools';
+        // Get gradlew path (FR-3.4)
+        const gradlewPath = this.getInput(inputs, 'gradlew_path', './gradlew');
+        // Get NDK revision (optional)
+        const ndkRevision = this.getInput(inputs, 'ndk_revision', '');
+        const commands = [];
+        commands.push('# Bitrise install-missing-android-tools step → CI Build Android environment setup');
+        commands.push('echo "📋 Verifying Android development environment..."');
+        commands.push('');
+        // Verify or auto-detect ANDROID_HOME (FR-3.3, FR-3.6)
+        commands.push('# Verify or auto-detect ANDROID_HOME environment variable');
+        commands.push('if [ -z "$ANDROID_HOME" ]; then');
+        commands.push('  echo "⚠️  ANDROID_HOME is not set, checking common locations..."');
+        commands.push('  ');
+        commands.push('  # Common Android SDK locations');
+        commands.push('  if [ -d "$HOME/Library/Android/sdk" ]; then');
+        commands.push('    export ANDROID_HOME="$HOME/Library/Android/sdk"');
+        commands.push('    echo "✅ Found Android SDK at: $ANDROID_HOME (macOS default)"');
+        commands.push('  elif [ -d "$HOME/Android/Sdk" ]; then');
+        commands.push('    export ANDROID_HOME="$HOME/Android/Sdk"');
+        commands.push('    echo "✅ Found Android SDK at: $ANDROID_HOME (Linux default)"');
+        commands.push('  elif [ -d "/usr/local/android-sdk" ]; then');
+        commands.push('    export ANDROID_HOME="/usr/local/android-sdk"');
+        commands.push('    echo "✅ Found Android SDK at: $ANDROID_HOME"');
+        commands.push('  else');
+        commands.push('    echo ""');
+        commands.push('    echo "❌ Android SDK not found in common locations:"');
+        commands.push('    echo "   - ~/Library/Android/sdk (macOS)"');
+        commands.push('    echo "   - ~/Android/Sdk (Linux)"');
+        commands.push('    echo "   - /usr/local/android-sdk"');
+        commands.push('    echo ""');
+        commands.push('    echo "Please install Android Studio or set ANDROID_HOME manually:"');
+        commands.push('    echo "  export ANDROID_HOME=/path/to/android-sdk"');
+        commands.push('    exit 1');
+        commands.push('  fi');
+        commands.push('  ');
+        commands.push('  # Persist ANDROID_HOME for subsequent steps');
+        commands.push('  envman add --key ANDROID_HOME --value "$ANDROID_HOME"');
+        commands.push('else');
+        commands.push('  echo "✅ ANDROID_HOME is set to: $ANDROID_HOME"');
+        commands.push('fi');
+        commands.push('');
+        // Verify ANDROID_HOME directory exists
+        commands.push('# Verify ANDROID_HOME directory exists');
+        commands.push('if [ ! -d "$ANDROID_HOME" ]; then');
+        commands.push('  echo "❌ Error: ANDROID_HOME directory does not exist: $ANDROID_HOME"');
+        commands.push('  exit 1');
+        commands.push('fi');
+        commands.push('');
+        // Display Android SDK information
+        commands.push('# Display Android SDK information');
+        commands.push('echo "Android SDK location: $ANDROID_HOME"');
+        commands.push('if [ -d "$ANDROID_HOME/platform-tools" ]; then');
+        commands.push('  echo "Platform tools: Available"');
+        commands.push('fi');
+        commands.push('if [ -d "$ANDROID_HOME/build-tools" ]; then');
+        commands.push('  echo "Build tools: Available"');
+        commands.push('fi');
+        commands.push('');
+        // Validate JAVA_HOME before using Gradle
+        commands.push('# Validate JAVA_HOME for Gradle (optional check)');
+        commands.push('if [ -n "$JAVA_HOME" ] && [ ! -d "$JAVA_HOME" ]; then');
+        commands.push('  echo ""');
+        commands.push('  echo "⚠️  Warning: JAVA_HOME is set but points to invalid directory:"');
+        commands.push('  echo "   $JAVA_HOME"');
+        commands.push('  echo ""');
+        commands.push('  echo "This may cause Gradle to fail. Common fixes:"');
+        commands.push('  echo "  1. Unset JAVA_HOME: unset JAVA_HOME"');
+        commands.push('  echo "  2. Run set-java-version step before this step"');
+        commands.push('  echo "  3. Set correct JAVA_HOME for your OS"');
+        commands.push('  echo ""');
+        commands.push('  echo "Skipping Gradle verification due to invalid JAVA_HOME..."');
+        commands.push('  SKIP_GRADLE_CHECK=1');
+        commands.push('fi');
+        commands.push('');
+        // Make gradlew executable (FR-3.4)
+        commands.push('# Make gradlew executable');
+        commands.push('# Check in project directory if CIBUILD_SOURCE_DIR is set');
+        commands.push('if [ -n "$CIBUILD_SOURCE_DIR" ]; then');
+        commands.push(`  GRADLEW_FULL_PATH="$CIBUILD_SOURCE_DIR/${this.escapeBash(gradlewPath)}"`);
+        commands.push('else');
+        commands.push(`  GRADLEW_FULL_PATH="${this.escapeBash(gradlewPath)}"`);
+        commands.push('fi');
+        commands.push('');
+        commands.push('if [ -f "$GRADLEW_FULL_PATH" ]; then');
+        commands.push('  echo "Making gradlew executable: $GRADLEW_FULL_PATH"');
+        commands.push('  chmod +x "$GRADLEW_FULL_PATH"');
+        commands.push('  echo "✅ gradlew is now executable"');
+        commands.push('else');
+        commands.push('  echo "ℹ️  gradlew not found at $GRADLEW_FULL_PATH (will be checked at runtime by gradle steps)"');
+        commands.push('fi');
+        commands.push('');
+        // Verify Gradle works (FR-3.5)
+        commands.push('# Verify Gradle is working');
+        commands.push('if [ -f "$GRADLEW_FULL_PATH" ] && [ -z "$SKIP_GRADLE_CHECK" ]; then');
+        commands.push('  echo "Testing Gradle..."');
+        commands.push('  cd "$(dirname "$GRADLEW_FULL_PATH")"');
+        commands.push('  if ./gradlew --version 2>/dev/null; then');
+        commands.push('    echo "✅ Gradle is working correctly"');
+        commands.push('  else');
+        commands.push('    echo ""');
+        commands.push('    echo "⚠️  Warning: Gradle test failed"');
+        commands.push('    echo "   This usually means JAVA_HOME is not set correctly."');
+        commands.push('    echo "   Make sure to run the set-java-version step before this step."');
+        commands.push('    echo ""');
+        commands.push('    echo "Continuing anyway (Gradle will be needed for build steps)..."');
+        commands.push('  fi');
+        commands.push('fi');
+        commands.push('');
+        // Display NDK information if specified
+        if (ndkRevision) {
+            commands.push('# NDK information');
+            commands.push(`echo "Requested NDK revision: ${this.escapeBash(ndkRevision)}"`);
+            commands.push('if [ -d "$ANDROID_HOME/ndk" ]; then');
+            commands.push('  echo "NDK directory: $ANDROID_HOME/ndk"');
+            commands.push('  ls -1 "$ANDROID_HOME/ndk" 2>/dev/null || echo "  (empty)"');
+            commands.push('fi');
+            commands.push('');
+        }
+        // Set up Android SDK path in PATH
+        commands.push('# Add Android SDK tools to PATH');
+        commands.push('export PATH="$ANDROID_HOME/platform-tools:$PATH"');
+        commands.push('export PATH="$ANDROID_HOME/tools:$PATH"');
+        commands.push('export PATH="$ANDROID_HOME/tools/bin:$PATH"');
+        commands.push('');
+        // Display ADB version if available
+        commands.push('# Display ADB version if available');
+        commands.push('if command -v adb >/dev/null 2>&1; then');
+        commands.push('  echo "ADB version:"');
+        commands.push('  adb version');
+        commands.push('fi');
+        commands.push('');
+        commands.push('echo "✅ Android development environment verified successfully"');
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+//# sourceMappingURL=bitrise-android-tools.js.map

package/dist/src/yaml/steps/bitrise-android-tools.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for Bitrise install-missing-android-tools step
+ */
+export {};
+//# sourceMappingURL=bitrise-android-tools.test.d.ts.map

package/dist/src/yaml/steps/bitrise-android-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitrise-android-tools.test.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/bitrise-android-tools.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}