AcquiaCloudApi\Endpoints\Codebases

Complexity

Total Complexity

12

Size/Duplication

Total Lines	182
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

11 Methods

Rating	Name	Duplication	Size	Complexity
A	getAll()	0	6	1
A	get()	0	6	1
A	getEnvironments()	0	6	1
A	getReferences()	0	6	1
A	getReference()	0	6	1
A	getSites()	0	6	1
A	getApplications()	0	6	1
A	getBySubscription()	0	6	1
A	getBulkCodeSwitches()	0	5	1
A	getBulkCodeSwitch()	0	6	1
A	createBulkCodeSwitch()	0	24	2

<?php

namespace AcquiaCloudApi\Endpoints;

use AcquiaCloudApi\Response\CodebasesResponse;
use AcquiaCloudApi\Response\CodebaseResponse;
use AcquiaCloudApi\Response\ApplicationsResponse;
use AcquiaCloudApi\Response\ReferencesResponse;
use AcquiaCloudApi\Response\ReferenceResponse;
use AcquiaCloudApi\Response\BulkCodeSwitchResponse;
use AcquiaCloudApi\Response\CodebaseEnvironmentsResponse;
use AcquiaCloudApi\Response\SitesResponse;
use AcquiaCloudApi\Response\OperationResponse;

class Codebases extends CloudApiBase
{
    /**
     * Shows all codebases.
     */
    public function getAll(): CodebasesResponse
    {
        return new CodebasesResponse(
            $this->client->request(
                'get',
                "/codebases"
            )
        );
    }

    /**
     * Shows information about a specific codebase.
     *
     * @param string $codebaseUuid The codebase UUID.
     */
    public function get(string $codebaseUuid): CodebaseResponse
    {
        return new CodebaseResponse(
            $this->client->request(
                'get',
                "/codebases/$codebaseUuid"
            )
        );
    }

    /**
     * Shows all codebases for a subscription.
     *
     * @param string $subscriptionUuid The subscription UUID.
     */
    public function getBySubscription(string $subscriptionUuid): CodebasesResponse
    {
        return new CodebasesResponse(
            $this->client->request(
                'get',
                "/subscriptions/$subscriptionUuid/codebases"
            )
        );
    }

    /**
     * Shows all applications associated with a codebase.
     *
     * @param string $codebaseUuid The codebase UUID.
     */
    public function getApplications(string $codebaseUuid): ApplicationsResponse
    {
        return new ApplicationsResponse(
            $this->client->request(
                'get',
                "/codebases/$codebaseUuid/applications"
            )
        );
    }

    /**
     * Shows all git references for a codebase.
     *
     * @param string $codebaseUuid The codebase UUID.
     */
    public function getReferences(string $codebaseUuid): ReferencesResponse
    {
        return new ReferencesResponse(
            $this->client->request(
                'get',
                "/codebases/$codebaseUuid/references"
            )
        );
    }

    /**
     * Shows information about a specific git reference.
     *
     * @param string $codebaseUuid The codebase UUID.
     * @param string $referenceName The reference name (branch or tag).
     */
    public function getReference(string $codebaseUuid, string $referenceName): ReferenceResponse
    {
        return new ReferenceResponse(
            $this->client->request(
                'get',
                "/codebases/$codebaseUuid/references/$referenceName"
            )
        );
    }

    /**
     * Shows all sites associated with a codebase.
     *
     * @param string $codebaseUuid The codebase UUID.
     */
    public function getSites(string $codebaseUuid): SitesResponse
    {
        return new SitesResponse(
            $this->client->request(
                'get',
                "/codebases/$codebaseUuid/sites"
            )
        );
    }
    /**
     * Shows all environments associated with a codebase.
     *
     * @param string $codebaseUuid The codebase UUID.
     */
    public function getEnvironments(string $codebaseUuid): CodebaseEnvironmentsResponse
    {
        return new CodebaseEnvironmentsResponse(
            $this->client->request(
                'get',
                "/codebases/$codebaseUuid/environments"
            )
        );
    }

    /**
     * Retrieves a list of bulk code switches performed on a codebase.
     *
     * @param string $codebaseUuid The codebase UUID.
     * @param array<string, mixed> $options Query parameters (limit, offset).
     */
    public function getBulkCodeSwitches(string $codebaseUuid, array $options = []): BulkCodeSwitchResponse
    {
        $path = "/codebases/$codebaseUuid/bulk-code-switch";
        return new BulkCodeSwitchResponse(
            $this->client->request('get', $path, $options)
        );
    }

    /**
     * Shows information about a specific bulk code switch.
     *
     * @param string $codebaseUuid The codebase UUID.
     * @param string $bulkCodeSwitchId The bulk code switch ID.
     */
    public function getBulkCodeSwitch(string $codebaseUuid, string $bulkCodeSwitchId): BulkCodeSwitchResponse
    {
        return new BulkCodeSwitchResponse(
            $this->client->request(
                'get',
                "/codebases/$codebaseUuid/bulk-code-switch/$bulkCodeSwitchId"
            )
        );
    }

    /**
     * Starts a new bulk code switch for a codebase.
     *
     * @param string $codebaseUuid The codebase UUID.
     * @param string $reference The reference to switch to (branch name or tag).
     * @param array<int, array<string, mixed>> $targets Array of targets with environment_id and optional cloud_actions.
     * @param array<string, mixed> $cloudActions Optional global cloud actions to perform.
     */
    public function createBulkCodeSwitch(
        string $codebaseUuid,
        string $reference,
        array $targets,
        array $cloudActions = []
    ): OperationResponse {
        $data = [
            'reference' => $reference,
            'targets' => $targets,
        ];

        if (!empty($cloudActions)) {
            $data['cloud_actions'] = $cloudActions;
        }

        $options = [
            'json' => $data,
        ];

        return new OperationResponse(
            $this->client->request(
                'post',
                "/codebases/$codebaseUuid/bulk-code-switch",
                $options
            )
        );
    }
}