Function collectBitbucketCloud

packages/setupWizard/src/bitbucket.ts:29–155

(
    connectionName: string,
    config: BitbucketConnectionConfig,
    env: EnvVars,
)

}

async function collectBitbucketCloud(
    connectionName: string,
    config: BitbucketConnectionConfig,
    env: EnvVars,
): Promise<CollectResult> {
    const authMethod = await select<'api-token' | 'access-token' | 'app-password'>({
        message: 'How will you authenticate?',
        choices: [
            { value: 'api-token', name: 'API Token', description: 'Recommended by Atlassian' },
            { value: 'access-token', name: 'Access Token', description: 'Scoped to a repo, project, or workspace' },
            { value: 'app-password', name: 'App Password (deprecated)', description: 'Deprecated by Atlassian' },
        ],
    });

    if (authMethod === 'api-token') {
        note(
            'The email you use to sign in to Atlassian (e.g. you@example.com).',
            'Atlassian account email',
        );

        const email = await input({
            message: 'Atlassian account email',
            validate: (v) => !v?.trim() ? 'Email is required' : true,
        });
        config.user = email;

        note(
            [
                'Your Bitbucket username (separate from your Atlassian email).',
                '  Find it at: https://bitbucket.org/account/settings/',
            ].join('\n'),
            'Bitbucket username',
        );

        const gitUser = await input({
            message: 'Bitbucket username',
            validate: (v) => !v?.trim() ? 'Username is required' : true,
        });
        config.gitUser = gitUser;

        note(
            [
                'Create an API Token at:',
                '  https://id.atlassian.com/manage-profile/security/api-tokens',
                'Click "Create API token with scopes", choose Bitbucket, and grant:',
                '  read:repository:bitbucket',
                '  read:workspace:bitbucket',
            ].join('\n'),
            'Bitbucket Cloud API Token',
        );

        const tokenEnvKey = toEnvKey(connectionName, 'TOKEN');
        const token = await password({
            message: `API Token (stored locally in .env as ${tokenEnvKey})`,
            mask: true,
            validate: (v) => !v?.trim() ? 'Token is required' : true,
        });
        env[tokenEnvKey] = token;