@invarn/cibuild 1.3.16 → 1.3.17

package/dist/src/yaml/platform-detector.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Platform detection logic for YAML pipelines
+ * Implements 3-tier priority detection: stack → platform → auto-detect from steps
+ */
+import type { YAMLPipeline, YAMLWorkflow, Platform, MachineType, PlatformInfo } from './types.js';
+export declare class PlatformDetectionError extends Error {
+    constructor(message: string);
+}
+/**
+ * PlatformDetector analyzes a YAML workflow and determines the target platform
+ */
+export declare class PlatformDetector {
+    private pipeline;
+    private workflow;
+    private workflowName;
+    constructor(pipeline: YAMLPipeline, workflow: YAMLWorkflow, workflowName: string);
+    /**
+     * Detects the platform using 3-tier priority detection
+     * Priority 1: meta.cibuild.io.stack
+     * Priority 2: meta.platform
+     * Priority 3: auto-detect from workflow steps
+     *
+     * @returns Detected platform ('macos', 'linux', or 'windows')
+     * @throws PlatformDetectionError if detection fails or mixed platforms detected
+     */
+    getPlatform(): Platform;
+    /**
+     * Gets the full stack identifier if specified
+     * @returns Stack identifier (e.g., 'macos-xcode-26.4') or null
+     */
+    getStack(): string | null;
+    /**
+     * Gets the machine type if specified
+     * @returns Machine type ('standard' or 'performance') or null
+     */
+    getMachineType(): MachineType | null;
+    /**
+     * Gets complete platform information
+     * @returns PlatformInfo object with platform, stack, and machineType
+     */
+    getPlatformInfo(): PlatformInfo;
+    /**
+     * Extracts platform from stack name by parsing the prefix
+     * @param stack Stack identifier (e.g., 'macos-xcode-26.4')
+     * @returns Platform or null if pattern doesn't match
+     */
+    private extractPlatformFromStack;
+    /**
+     * Auto-detects platform by analyzing workflow steps
+     * @returns Detected platform, defaults to 'linux' for platform-agnostic steps
+     * @throws PlatformDetectionError if mixed platforms detected
+     */
+    private autoDetectFromSteps;
+    /**
+     * Extracts step names from workflow steps
+     * Parses step-name@version format to extract just the step name
+     * @returns Array of step names
+     */
+    private extractStepNames;
+    /**
+     * Parses step name from "step-name@version" or "step-name" format
+     * @param stepNameWithVersion Full step identifier (e.g., "git-clone@4.0.17")
+     * @returns Step name without version (e.g., "git-clone")
+     */
+    private parseStepName;
+}
+/**
+ * Helper function to detect platform for a specific workflow
+ * @param pipeline Parsed YAML pipeline
+ * @param workflowName Name of the workflow to analyze
+ * @returns Detected platform
+ * @throws Error if workflow doesn't exist
+ */
+export declare function detectPlatform(pipeline: YAMLPipeline, workflowName: string): Platform;
+/**
+ * Helper function to get complete platform information for a workflow
+ * @param pipeline Parsed YAML pipeline
+ * @param workflowName Name of the workflow to analyze
+ * @returns PlatformInfo object
+ * @throws Error if workflow doesn't exist
+ */
+export declare function detectPlatformInfo(pipeline: YAMLPipeline, workflowName: string): PlatformInfo;
+//# sourceMappingURL=platform-detector.d.ts.map

package/dist/src/yaml/platform-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-detector.d.ts","sourceRoot":"","sources":["../../../src/yaml/platform-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElG,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAMD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,YAAY,CAAS;gBAEjB,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM;IAMhF;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ;IAmBvB;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB;;;OAGG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC;;;OAGG;IACH,eAAe,IAAI,YAAY;IAQ/B;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAchC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAqC3B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAOtB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,QAAQ,CAQrF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,CAQ7F"}

package/dist/src/yaml/platform-detector.js

@@ -0,0 +1,188 @@
+/**
+ * Platform detection logic for YAML pipelines
+ * Implements 3-tier priority detection: stack → platform → auto-detect from steps
+ */
+export class PlatformDetectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PlatformDetectionError';
+    }
+}
+// Platform-specific step names
+const MACOS_STEPS = new Set(['xcodebuild', 'xcode-test']);
+const LINUX_STEPS = new Set(['gradle-build', 'android-lint', 'android-unit-test', 'set-java-version']);
+/**
+ * PlatformDetector analyzes a YAML workflow and determines the target platform
+ */
+export class PlatformDetector {
+    pipeline;
+    workflow;
+    workflowName;
+    constructor(pipeline, workflow, workflowName) {
+        this.pipeline = pipeline;
+        this.workflow = workflow;
+        this.workflowName = workflowName;
+    }
+    /**
+     * Detects the platform using 3-tier priority detection
+     * Priority 1: meta.cibuild.io.stack
+     * Priority 2: meta.platform
+     * Priority 3: auto-detect from workflow steps
+     *
+     * @returns Detected platform ('macos', 'linux', or 'windows')
+     * @throws PlatformDetectionError if detection fails or mixed platforms detected
+     */
+    getPlatform() {
+        // Priority 1: Extract from meta.cibuild.io.stack
+        if (this.pipeline.meta?.['cibuild.io']?.stack) {
+            const stack = this.pipeline.meta['cibuild.io'].stack;
+            const platform = this.extractPlatformFromStack(stack);
+            if (platform) {
+                return platform;
+            }
+        }
+        // Priority 2: Use meta.platform
+        if (this.pipeline.meta?.platform) {
+            return this.pipeline.meta.platform;
+        }
+        // Priority 3: Auto-detect from workflow steps
+        return this.autoDetectFromSteps();
+    }
+    /**
+     * Gets the full stack identifier if specified
+     * @returns Stack identifier (e.g., 'macos-xcode-26.4') or null
+     */
+    getStack() {
+        return this.pipeline.meta?.['cibuild.io']?.stack ?? null;
+    }
+    /**
+     * Gets the machine type if specified
+     * @returns Machine type ('standard' or 'performance') or null
+     */
+    getMachineType() {
+        return this.pipeline.meta?.['cibuild.io']?.machine_type ?? null;
+    }
+    /**
+     * Gets complete platform information
+     * @returns PlatformInfo object with platform, stack, and machineType
+     */
+    getPlatformInfo() {
+        return {
+            platform: this.getPlatform(),
+            stack: this.getStack() ?? undefined,
+            machineType: this.getMachineType() ?? undefined,
+        };
+    }
+    /**
+     * Extracts platform from stack name by parsing the prefix
+     * @param stack Stack identifier (e.g., 'macos-xcode-26.4')
+     * @returns Platform or null if pattern doesn't match
+     */
+    extractPlatformFromStack(stack) {
+        const parts = stack.split('-');
+        if (parts.length === 0) {
+            return null;
+        }
+        const platformPrefix = parts[0];
+        if (platformPrefix === 'macos' || platformPrefix === 'linux' || platformPrefix === 'windows') {
+            return platformPrefix;
+        }
+        return null;
+    }
+    /**
+     * Auto-detects platform by analyzing workflow steps
+     * @returns Detected platform, defaults to 'linux' for platform-agnostic steps
+     * @throws PlatformDetectionError if mixed platforms detected
+     */
+    autoDetectFromSteps() {
+        const stepNames = this.extractStepNames();
+        const macosStepNames = [];
+        const linuxStepNames = [];
+        for (const stepName of stepNames) {
+            if (MACOS_STEPS.has(stepName)) {
+                macosStepNames.push(stepName);
+            }
+            if (LINUX_STEPS.has(stepName)) {
+                linuxStepNames.push(stepName);
+            }
+        }
+        // Check for mixed platforms (FR-37)
+        if (macosStepNames.length > 0 && linuxStepNames.length > 0) {
+            throw new PlatformDetectionError(`Workflow '${this.workflowName}' contains steps for multiple platforms\n` +
+                `  macOS steps: ${macosStepNames.join(', ')}\n` +
+                `  Linux steps: ${linuxStepNames.join(', ')}\n` +
+                `Create separate workflows for each platform or use explicit meta.platform declaration.`);
+        }
+        // Return detected platform
+        if (macosStepNames.length > 0) {
+            return 'macos';
+        }
+        if (linuxStepNames.length > 0) {
+            return 'linux';
+        }
+        // Default to linux for platform-agnostic steps (script, git-clone, cache-*)
+        return 'linux';
+    }
+    /**
+     * Extracts step names from workflow steps
+     * Parses step-name@version format to extract just the step name
+     * @returns Array of step names
+     */
+    extractStepNames() {
+        const stepNames = [];
+        for (const stepObj of this.workflow.steps) {
+            // Each step is an object with one key: "step-name@version"
+            const stepKeys = Object.keys(stepObj);
+            if (stepKeys.length === 0) {
+                continue;
+            }
+            const stepNameWithVersion = stepKeys[0];
+            const stepName = this.parseStepName(stepNameWithVersion);
+            stepNames.push(stepName);
+        }
+        return stepNames;
+    }
+    /**
+     * Parses step name from "step-name@version" or "step-name" format
+     * @param stepNameWithVersion Full step identifier (e.g., "git-clone@4.0.17")
+     * @returns Step name without version (e.g., "git-clone")
+     */
+    parseStepName(stepNameWithVersion) {
+        const atIndex = stepNameWithVersion.indexOf('@');
+        if (atIndex === -1) {
+            return stepNameWithVersion;
+        }
+        return stepNameWithVersion.substring(0, atIndex);
+    }
+}
+/**
+ * Helper function to detect platform for a specific workflow
+ * @param pipeline Parsed YAML pipeline
+ * @param workflowName Name of the workflow to analyze
+ * @returns Detected platform
+ * @throws Error if workflow doesn't exist
+ */
+export function detectPlatform(pipeline, workflowName) {
+    const workflow = pipeline.workflows[workflowName];
+    if (!workflow) {
+        throw new Error(`Workflow '${workflowName}' not found in pipeline`);
+    }
+    const detector = new PlatformDetector(pipeline, workflow, workflowName);
+    return detector.getPlatform();
+}
+/**
+ * Helper function to get complete platform information for a workflow
+ * @param pipeline Parsed YAML pipeline
+ * @param workflowName Name of the workflow to analyze
+ * @returns PlatformInfo object
+ * @throws Error if workflow doesn't exist
+ */
+export function detectPlatformInfo(pipeline, workflowName) {
+    const workflow = pipeline.workflows[workflowName];
+    if (!workflow) {
+        throw new Error(`Workflow '${workflowName}' not found in pipeline`);
+    }
+    const detector = new PlatformDetector(pipeline, workflow, workflowName);
+    return detector.getPlatformInfo();
+}
+//# sourceMappingURL=platform-detector.js.map

package/dist/src/yaml/platform-detector.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for platform detection
+ */
+export {};
+//# sourceMappingURL=platform-detector.test.d.ts.map

package/dist/src/yaml/platform-detector.test.d.ts.map

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