@invarn/cibuild 1.3.16 → 1.3.17

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

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

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

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

package/dist/src/yaml/steps/bitrise-slack.test.js

@@ -0,0 +1,484 @@
+/**
+ * Unit tests for Bitrise slack step
+ */
+import { describe, test, expect } from '@jest/globals';
+import { BitriseSlackStepExecutor } from './bitrise-slack.js';
+describe('BitriseSlackStepExecutor', () => {
+    const mockConfig = {
+        artifactsDir: '/ci/artifacts',
+        interpreters: {
+            python: '/usr/bin/python3',
+            ruby: '/usr/bin/ruby',
+            node: '/usr/bin/node',
+            bash: '/bin/bash',
+        },
+        maxConcurrentJobs: 4,
+        paths: {
+            buildsDir: '/ci/builds',
+            cacheDir: '/ci/cache',
+            derivedDataDir: '/ci/derived_data',
+        },
+    };
+    describe('Basic functionality', () => {
+        test('should create Slack notification script with minimal inputs', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/services/TEST/WEBHOOK/URL',
+                text: 'Build completed!',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.kind).toBe('script');
+            expect(result.name).toBe('slack');
+            expect(result.script).toContain('Sending Slack notification');
+            expect(result.script).toContain('https://hooks.slack.com/services/TEST/WEBHOOK/URL');
+            expect(result.script).toContain('Build completed!');
+        });
+        test('should use text input for message content', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test message',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('Test message');
+        });
+        test('should fall back to message input if text not provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                message: 'Fallback message',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('Fallback message');
+        });
+        test('should use default message if neither text nor message provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('CI Build build notification');
+        });
+    });
+    describe('Webhook URL handling', () => {
+        test('should use webhook_url from inputs', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/services/CUSTOM',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('https://hooks.slack.com/services/CUSTOM');
+        });
+        test('should fall back to SLACK_WEBHOOK_URL environment variable', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {
+                SLACK_WEBHOOK_URL: 'https://hooks.slack.com/services/FROM_ENV',
+            };
+            const inputs = {
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('https://hooks.slack.com/services/FROM_ENV');
+        });
+        test('should prefer input over environment variable', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {
+                SLACK_WEBHOOK_URL: 'https://hooks.slack.com/env',
+            };
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/input',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('https://hooks.slack.com/input');
+            expect(result.script).not.toContain('https://hooks.slack.com/env');
+        });
+    });
+    describe('Message formatting', () => {
+        test('should include channel when provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                channel: '#builds',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"channel": "#builds"');
+        });
+        test('should include custom username', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                from_username: 'Build Bot',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"username": "Build Bot"');
+        });
+        test('should use default username CI Build', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"username": "CI Build"');
+        });
+        test('should include icon_emoji when provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                icon_emoji: ':robot_face:',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"icon_emoji": ":robot_face:"');
+        });
+        test('should include icon_url when provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                icon_url: 'https://example.com/icon.png',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"icon_url": "https://example.com/icon.png"');
+        });
+        test('should include color attachment', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                color: 'danger',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"color": "danger"');
+        });
+        test('should use default color good', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"color": "good"');
+        });
+    });
+    describe('Advanced formatting', () => {
+        test('should include pretext when provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                pretext: 'Build notification:',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"pretext": "Build notification:"');
+        });
+        test('should include author_name when provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                author_name: 'John Doe',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"author_name": "John Doe"');
+        });
+        test('should include title and title_link', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                title: 'Build #42',
+                title_link: 'https://ci.example.com/builds/42',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"title": "Build #42"');
+            expect(result.script).toContain('"title_link": "https://ci.example.com/builds/42"');
+        });
+        test('should include footer when provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                footer: 'CI Build',
+                footer_icon: 'https://example.com/footer.png',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"footer": "CI Build"');
+            expect(result.script).toContain('"footer_icon": "https://example.com/footer.png"');
+        });
+        test('should include timestamp when provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                timestamp: '1234567890',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"ts": 1234567890');
+        });
+        test('should include fields when provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                fields: '[{"title":"Status","value":"Success","short":true}]',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('"fields": [{"title":"Status","value":"Success","short":true}]');
+        });
+        test('should include buttons when provided', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                buttons: 'View Build|https://example.com',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            // Buttons are now base64-encoded and processed as inline links, not JSON actions
+            expect(result.script).toContain('BUTTONS_DATA=$(echo "');
+            expect(result.script).toContain('base64 -d)');
+            expect(result.script).toContain('BUTTON_LINKS');
+        });
+    });
+    describe('JSON payload generation', () => {
+        test('should generate valid JSON structure', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test message',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('cat > /tmp/slack-payload.json');
+            expect(result.script).toContain('"attachments": [');
+            expect(result.script).toContain('"text": "$SLACK_MESSAGE_TEXT"');
+        });
+        test('should use curl POST request', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('curl -X POST');
+            expect(result.script).toContain('-H "Content-Type: application/json"');
+            expect(result.script).toContain('-d @/tmp/slack-payload.json');
+        });
+        test('should clean up temporary file', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('rm -f /tmp/slack-payload.json');
+        });
+    });
+    describe('Debug mode', () => {
+        test('should not display payload by default', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).not.toContain('Debug: Display payload');
+        });
+        test('should display payload when is_debug_mode is true', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                is_debug_mode: 'true',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('Debug: Display payload');
+            expect(result.script).toContain('cat /tmp/slack-payload.json');
+        });
+        test('should display payload when is_debug_mode is yes', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+                is_debug_mode: 'yes',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('Debug: Display payload');
+        });
+    });
+    describe('Error handling', () => {
+        test('should throw error when webhook_url is missing', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                text: 'Test',
+            };
+            await expect(executor.execute(inputs, env, mockConfig)).rejects.toThrow(/Missing environment variable: 'SLACK_WEBHOOK_URL'/);
+        });
+        test('should include helpful error message for missing webhook', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {};
+            await expect(executor.execute(inputs, env, mockConfig)).rejects.toThrow(/Missing environment variable: 'SLACK_WEBHOOK_URL'[\s\S]*Slack webhook URL/);
+        });
+        test('should check curl exit status', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('if [ "$HTTP_CODE" = "200" ] || [ "$RESPONSE_BODY" = "ok" ]; then');
+            expect(result.script).toContain('Slack notification sent successfully');
+            expect(result.script).toContain('Failed to send Slack notification');
+        });
+    });
+    describe('Special characters handling', () => {
+        test('should escape quotes in message text', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Build "success" message',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('Build \\"success\\" message');
+        });
+        test('should escape newlines in message text', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Line 1\nLine 2',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('Line 1\\nLine 2');
+        });
+        test('should escape backslashes in message text', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Path: C:\\Windows\\System32',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('C:\\\\Windows\\\\System32');
+        });
+    });
+    describe('Script structure', () => {
+        test('should include bash error handling directives', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('#!/bin/bash');
+            expect(result.script).toContain('set -e');
+            expect(result.script).toContain('set -o pipefail');
+        });
+        test('should include informative messages', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('Bitrise slack step → CI Build Slack notification');
+            expect(result.script).toContain('Sending Slack notification');
+        });
+    });
+    describe('Integration scenarios', () => {
+        test('should work with all formatting options combined', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Build completed',
+                channel: '#deployments',
+                from_username: 'Deploy Bot',
+                icon_emoji: ':rocket:',
+                color: 'good',
+                pretext: 'Deployment notification',
+                author_name: 'CI Build',
+                title: 'Production Deploy',
+                title_link: 'https://example.com/deploy',
+                footer: 'CI Build',
+                timestamp: '1234567890',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.kind).toBe('script');
+            expect(result.script).toContain('#deployments');
+            expect(result.script).toContain('Deploy Bot');
+            expect(result.script).toContain(':rocket:');
+            expect(result.script).toContain('Production Deploy');
+        });
+        test('should work with minimal configuration', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {
+                SLACK_WEBHOOK_URL: 'https://hooks.slack.com/minimal',
+            };
+            const inputs = {};
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.kind).toBe('script');
+            expect(result.script).toContain('CI Build build notification');
+        });
+    });
+    describe('Bitrise compatibility', () => {
+        test('should support Bitrise input naming conventions', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Build message',
+                from_username: 'Bitrise',
+                icon_emoji: ':bitrise:',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toBeDefined();
+            expect(result.kind).toBe('script');
+        });
+        test('should map to CI Build Slack notification pattern', async () => {
+            const executor = new BitriseSlackStepExecutor();
+            const env = {};
+            const inputs = {
+                webhook_url: 'https://hooks.slack.com/test',
+                text: 'Test',
+            };
+            const result = await executor.execute(inputs, env, mockConfig);
+            expect(result.script).toContain('CI Build Slack notification');
+        });
+    });
+});
+//# sourceMappingURL=bitrise-slack.test.js.map

package/dist/src/yaml/steps/bitrise-ssh.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Bitrise activate-ssh-key step implementation
+ * Maps Bitrise activate-ssh-key@* to CI Build SSH key activation
+ */
+import { BaseStepExecutor } from './base.js';
+import type { StepDef, CIConfig } from '../../types.js';
+import type { ValidationRequirement } from '../validation-types.js';
+/**
+ * Inputs for activate-ssh-key step
+ */
+export interface BitriseSSHInputs {
+    ssh_rsa_private_key?: string;
+    ssh_key_save_path?: string;
+    is_remove_other_identities?: string;
+}
+/**
+ * Bitrise activate-ssh-key step executor (FR-2)
+ * Activates an SSH key for Git operations
+ *
+ * Supports Bitrise step versions: activate-ssh-key@1, @2, @3, @4
+ */
+export declare class BitriseSSHStepExecutor extends BaseStepExecutor {
+    isSkippedInLocalMode(): boolean;
+    getValidationRequirements(_inputs: BitriseSSHInputs, env: Record<string, string>, config: CIConfig): ValidationRequirement[];
+    execute(inputs: BitriseSSHInputs, env: Record<string, string>, config: CIConfig): Promise<StepDef>;
+}
+//# sourceMappingURL=bitrise-ssh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bitrise-ssh.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/bitrise-ssh.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;IAC1D,oBAAoB,IAAI,OAAO;IAI/B,yBAAyB,CACvB,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,MAAM,EAAE,QAAQ,GACf,qBAAqB,EAAE;IAsBpB,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;CAmIzG"}

package/dist/src/yaml/steps/bitrise-ssh.js

@@ -0,0 +1,134 @@
+/**
+ * Bitrise activate-ssh-key step implementation
+ * Maps Bitrise activate-ssh-key@* to CI Build SSH key activation
+ */
+import { BaseStepExecutor } from './base.js';
+import { MissingEnvironmentVariableError } from '../env-resolver.js';
+/**
+ * Bitrise activate-ssh-key step executor (FR-2)
+ * Activates an SSH key for Git operations
+ *
+ * Supports Bitrise step versions: activate-ssh-key@1, @2, @3, @4
+ */
+export class BitriseSSHStepExecutor extends BaseStepExecutor {
+    isSkippedInLocalMode() {
+        return true;
+    }
+    getValidationRequirements(_inputs, env, config) {
+        if (config.local)
+            return [];
+        return [
+            this.requireEnvVar('SSH_RSA_PRIVATE_KEY', 'SSH private key for git authentication', env, 'Set SSH_RSA_PRIVATE_KEY environment variable with your private key'),
+            this.requireCommand('ssh-agent', 'SSH agent for managing SSH keys', 'ssh-agent should be pre-installed on macOS and Linux'),
+            this.requireCommand('ssh-add', 'SSH key management tool', 'ssh-add should be pre-installed on macOS and Linux'),
+        ];
+    }
+    async execute(inputs, env, config) {
+        const stepName = 'activate-ssh-key';
+        if (config.local) {
+            const script = this.createBashScriptFromCommands(['echo "⏭️  activate-ssh-key: skipped in local mode"'], stepName);
+            return this.createScriptStep(script, stepName);
+        }
+        // Get SSH key from environment variable (FR-2.3)
+        const sshKeyEnvVar = 'SSH_RSA_PRIVATE_KEY';
+        // Check if SSH key is available
+        if (!env[sshKeyEnvVar]) {
+            throw new MissingEnvironmentVariableError(sshKeyEnvVar, stepName, 'SSH private key used for Git authentication and repository access.\n\n' +
+                'Expected format (PEM):\n' +
+                '  ┌────────────────────────────────────────┐\n' +
+                '  │ -----BEGIN RSA PRIVATE KEY-----        │\n' +
+                '  │ MIIEpAIBAAKCAQEA...                    │\n' +
+                '  │ -----END RSA PRIVATE KEY-----          │\n' +
+                '  └────────────────────────────────────────┘\n\n' +
+                'Or OpenSSH format:\n' +
+                '  ┌────────────────────────────────────────┐\n' +
+                '  │ -----BEGIN OPENSSH PRIVATE KEY-----    │\n' +
+                '  │ b3BlbnNzaC1rZXktdjEAAAAA...            │\n' +
+                '  │ -----END OPENSSH PRIVATE KEY-----      │\n' +
+                '  └────────────────────────────────────────┘\n\n' +
+                'How to generate:\n' +
+                '  • ssh-keygen -t rsa -b 4096 -C "ci@example.com"\n' +
+                '  • Add public key to GitHub/GitLab deploy keys\n' +
+                '  • Store private key in CI secrets');
+        }
+        // Get SSH key save path (FR-2.4)
+        // Use YAML filename in key path to avoid conflicts between different pipeline files
+        const yamlFilename = env['CIBUILD_YAML_FILENAME'] || env['CIBUILD_TRIGGERED_WORKFLOW_ID'] || 'default';
+        const defaultKeyPath = `~/.ssh/${yamlFilename}.pem`;
+        const sshKeyPath = this.getInput(inputs, 'ssh_key_save_path', defaultKeyPath);
+        // Get remove other identities flag
+        const removeOtherIdentities = this.getInput(inputs, 'is_remove_other_identities', 'true');
+        // Get the actual SSH key value to embed in the script
+        const sshKeyValue = env[sshKeyEnvVar];
+        const commands = [];
+        commands.push('# Bitrise activate-ssh-key step → CI Build SSH activation');
+        commands.push('echo "📋 Setting up SSH key for Git operations..."');
+        commands.push('');
+        // Create .ssh directory if it doesn't exist
+        commands.push('# Create .ssh directory with proper permissions');
+        commands.push('mkdir -p ~/.ssh');
+        commands.push('chmod 700 ~/.ssh');
+        commands.push('');
+        // Write SSH key to file using node to handle newlines properly
+        // Export the key using heredoc to preserve special characters
+        commands.push('# Export SSH key from YAML config');
+        commands.push(`export ${sshKeyEnvVar}=$(cat <<'SSHKEY_EOF'`);
+        commands.push(sshKeyValue);
+        commands.push('SSHKEY_EOF');
+        commands.push(')');
+        commands.push('');
+        // Write SSH private key to file
+        // Use tr to convert \r to \n, then printf %b to interpret escape sequences
+        const keyFileName = sshKeyPath.replace('~/.ssh/', '');
+        commands.push('# Write SSH private key to file');
+        commands.push(`echo "Writing SSH key to ${sshKeyPath}"`);
+        commands.push(`echo "\${${sshKeyEnvVar}}" | tr '\\r' '\\n' > ~/.ssh/${keyFileName}`);
+        commands.push(`chmod 600 ${sshKeyPath}`);
+        commands.push('');
+        // Remove other SSH identities if requested
+        if (removeOtherIdentities === 'true' || removeOtherIdentities === 'yes') {
+            commands.push('# Remove other SSH identities from agent');
+            commands.push('ssh-add -D 2>/dev/null || true');
+            commands.push('');
+        }
+        // Start SSH agent and add key (FR-2.5)
+        commands.push('# Start SSH agent and add key');
+        commands.push('eval "$(ssh-agent -s)"');
+        commands.push(`ssh-add ${sshKeyPath}`);
+        commands.push('');
+        // Configure SSH to use the key file and avoid host key verification issues
+        // This ensures the key is used in subsequent steps without needing ssh-agent
+        commands.push('# Configure SSH client to use the key file');
+        commands.push('cat >> ~/.ssh/config << EOF');
+        commands.push('Host github.com');
+        commands.push(`  IdentityFile ${sshKeyPath}`);
+        commands.push('  StrictHostKeyChecking no');
+        commands.push('  UserKnownHostsFile=/dev/null');
+        commands.push('  LogLevel ERROR');
+        commands.push('');
+        commands.push('Host gitlab.com');
+        commands.push(`  IdentityFile ${sshKeyPath}`);
+        commands.push('  StrictHostKeyChecking no');
+        commands.push('  UserKnownHostsFile=/dev/null');
+        commands.push('  LogLevel ERROR');
+        commands.push('');
+        commands.push('Host bitbucket.org');
+        commands.push(`  IdentityFile ${sshKeyPath}`);
+        commands.push('  StrictHostKeyChecking no');
+        commands.push('  UserKnownHostsFile=/dev/null');
+        commands.push('  LogLevel ERROR');
+        commands.push('');
+        commands.push('Host *');
+        commands.push(`  IdentityFile ${sshKeyPath}`);
+        commands.push('  StrictHostKeyChecking no');
+        commands.push('  UserKnownHostsFile=/dev/null');
+        commands.push('  LogLevel ERROR');
+        commands.push('EOF');
+        commands.push('chmod 600 ~/.ssh/config');
+        commands.push('');
+        commands.push('echo "✅ SSH key activated successfully"');
+        const script = this.createBashScriptFromCommands(commands, stepName);
+        return this.createScriptStep(script, stepName);
+    }
+}
+//# sourceMappingURL=bitrise-ssh.js.map

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

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for Bitrise activate-ssh-key step
+ */
+export {};
+//# sourceMappingURL=bitrise-ssh.test.d.ts.map

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

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