Linode\Support\SupportTicket

Complexity

Total Complexity

2

Size/Duplication

Total Lines	38
Duplicated Lines	0 %

Importance

Changes

0

1 Method

Rating	Name	Duplication	Size	Complexity
A	__get()	0	6	2

<?php

// ---------------------------------------------------------------------
//
//  Copyright (C) 2018-2024 Artem Rodygin
//
//  You should have received a copy of the MIT License along with
//  this file. If not, see <https://opensource.org/licenses/MIT>.
//
// ---------------------------------------------------------------------

namespace Linode\Support;

use Linode\Entity;
use Linode\Linode\LinodeEntity;
use Linode\Support\Repository\SupportTicketReplyRepository;

/**
 * A Support Ticket opened on your Account.
 *
 * @property int                                   $id          The ID of the Support Ticket.
 * @property string                                $summary     The summary or title for this Ticket.
 * @property string                                $opened_by   The User who opened this Ticket.
 * @property string                                $opened      The date and time this Ticket was created.
 * @property string                                $description The full details of the issue or question.
 * @property null|LinodeEntity                     $entity      The entity this Ticket was opened for.
 * @property string                                $gravatar_id The Gravatar ID of the User who opened this Ticket.
 * @property string                                $status      The current status of this Ticket.
 * @property bool                                  $closable    Whether the Support Ticket may be closed.
 * @property null|string                           $updated_by  The User who last updated this Ticket.
 * @property string                                $updated     The date and time this Ticket was last updated.
 * @property null|string                           $closed      The date and time this Ticket was closed.
 * @property string[]                              $attachments A list of filenames representing attached files associated with this Ticket.
 * @property SupportTicketReplyRepositoryInterface $replies     Support ticket replies.
 */
class SupportTicket extends Entity
{
    // Available fields.
    public const FIELD_ID          = 'id';
    public const FIELD_SUMMARY     = 'summary';
    public const FIELD_OPENED_BY   = 'opened_by';
    public const FIELD_OPENED      = 'opened';
    public const FIELD_DESCRIPTION = 'description';
    public const FIELD_ENTITY      = 'entity';
    public const FIELD_GRAVATAR_ID = 'gravatar_id';
    public const FIELD_STATUS      = 'status';
    public const FIELD_CLOSABLE    = 'closable';
    public const FIELD_UPDATED_BY  = 'updated_by';
    public const FIELD_UPDATED     = 'updated';
    public const FIELD_CLOSED      = 'closed';
    public const FIELD_ATTACHMENTS = 'attachments';

    // Extra fields for POST/PUT requests.
    public const FIELD_DOMAIN_ID         = 'domain_id';
    public const FIELD_LINODE_ID         = 'linode_id';
    public const FIELD_LONGVIEWCLIENT_ID = 'longviewclient_id';
    public const FIELD_NODEBALANCER_ID   = 'nodebalancer_id';
    public const FIELD_VOLUME_ID         = 'volume_id';

    // `FIELD_STATUS` values.
    public const STATUS_CLOSED = 'closed';
    public const STATUS_NEW    = 'new';
    public const STATUS_OPEN   = 'open';

    /**
     * @codeCoverageIgnore This method was autogenerated.
     */
    public function __get(string $name): mixed
    {
        return match ($name) {
            self::FIELD_ENTITY => null === $this->data[$name] ? null : new LinodeEntity($this->client, $this->data[$name]),
            'replies'          => new SupportTicketReplyRepository($this->client, $this->id),
            default            => parent::__get($name),
        };
    }
}