<?php

declare (strict_types=1);
namespace LassoLiteVendor\Sentry;

use LassoLiteVendor\Jean85\PrettyVersions;
use LassoLiteVendor\Sentry\Context\OsContext;
use LassoLiteVendor\Sentry\Context\RuntimeContext;
use LassoLiteVendor\Sentry\Tracing\Span;
/**
 * This is the base class for classes containing event data.
 *
 * @author Stefano Arlandini <sarlandini@alice.it>
 */
final class Event
{
    public const DEFAULT_ENVIRONMENT = 'production';
    /**
     * @var EventId The ID
     */
    private $id;
    /**
     * @var float|null The date and time of when this event was generated
     */
    private $timestamp;
    /**
     * This property is used if it's a Transaction event together with $timestamp it's the duration of the transaction.
     *
     * @var float|null The date and time of when this event was generated
     */
    private $startTimestamp;
    /**
     * @var Severity|null The severity of this event
     */
    private $level;
    /**
     * @var string|null The name of the logger which created the record
     */
    private $logger;
    /**
     * @var string|null the name of the transaction (or culprit) which caused this exception
     */
    private $transaction;
    /**
     * @var string|null The name of the server (e.g. the host name)
     */
    private $serverName;
    /**
     * @var string|null The release of the program
     */
    private $release;
    /**
     * @var string|null The error message
     */
    private $message;
    /**
     * @var string|null The formatted error message
     */
    private $messageFormatted;
    /**
     * @var string[] The parameters to use to format the message
     */
    private $messageParams = [];
    /**
     * @var string|null The environment where this event generated (e.g. production)
     */
    private $environment;
    /**
     * @var array<string, string> A list of relevant modules and their versions
     */
    private $modules = [];
    /**
     * @var array<string, mixed> The request data
     */
    private $request = [];
    /**
     * @var array<string, string> A list of tags associated to this event
     */
    private $tags = [];
    /**
     * @var OsContext|null The server OS context data
     */
    private $osContext;
    /**
     * @var RuntimeContext|null The runtime context data
     */
    private $runtimeContext;
    /**
     * @var UserDataBag|null The user context data
     */
    private $user;
    /**
     * @var array<string, array<string, mixed>> An arbitrary mapping of additional contexts associated to this event
     */
    private $contexts = [];
    /**
     * @var array<string, mixed> An arbitrary mapping of additional metadata
     */
    private $extra = [];
    /**
     * @var string[] An array of strings used to dictate the deduplication of this event
     */
    private $fingerprint = [];
    /**
     * @var Breadcrumb[] The associated breadcrumbs
     */
    private $breadcrumbs = [];
    /**
     * @var Span[] The array of spans if it's a transaction
     */
    private $spans = [];
    /**
     * @var ExceptionDataBag[] The exceptions
     */
    private $exceptions = [];
    /**
     * @var Stacktrace|null The stacktrace that generated this event
     */
    private $stacktrace;
    /**
     * @var string The Sentry SDK identifier
     */
    private $sdkIdentifier = Client::SDK_IDENTIFIER;
    /**
     * @var string The Sentry SDK version
     */
    private $sdkVersion;
    /**
     * @var EventType The type of the Event
     */
    private $type;
    private function __construct(?EventId $eventId, EventType $eventType)
    {
        $this->id = $eventId ?? EventId::generate();
        $this->timestamp = \microtime(\true);
        $this->sdkVersion = PrettyVersions::getVersion('sentry/sentry')->getPrettyVersion();
        $this->type = $eventType;
    }
    /**
     * Creates a new event.
     *
     * @param EventId|null $eventId The ID of the event
     */
    public static function createEvent(?EventId $eventId = null) : self
    {
        return new self($eventId, EventType::event());
    }
    /**
     * Creates a new transaction event.
     *
     * @param EventId|null $eventId The ID of the event
     */
    public static function createTransaction(EventId $eventId = null) : self
    {
        return new self($eventId, EventType::transaction());
    }
    /**
     * Gets the ID of this event.
     */
    public function getId() : EventId
    {
        return $this->id;
    }
    /**
     * Gets the identifier of the SDK package that generated this event.
     *
     * @internal
     */
    public function getSdkIdentifier() : string
    {
        return $this->sdkIdentifier;
    }
    /**
     * Sets the identifier of the SDK package that generated this event.
     *
     * @internal
     */
    public function setSdkIdentifier(string $sdkIdentifier) : void
    {
        $this->sdkIdentifier = $sdkIdentifier;
    }
    /**
     * Gets the version of the SDK package that generated this Event.
     *
     * @internal
     */
    public function getSdkVersion() : string
    {
        return $this->sdkVersion;
    }
    /**
     * Sets the version of the SDK package that generated this Event.
     *
     * @internal
     */
    public function setSdkVersion(string $sdkVersion) : void
    {
        $this->sdkVersion = $sdkVersion;
    }
    /**
     * Gets the timestamp of when this event was generated.
     *
     * @return float
     */
    public function getTimestamp() : ?float
    {
        return $this->timestamp;
    }
    /**
     * Sets the timestamp of when the Event was created.
     */
    public function setTimestamp(?float $timestamp) : void
    {
        $this->timestamp = $timestamp;
    }
    /**
     * Gets the severity of this event.
     */
    public function getLevel() : ?Severity
    {
        return $this->level;
    }
    /**
     * Sets the severity of this event.
     *
     * @param Severity|null $level The severity
     */
    public function setLevel(?Severity $level) : void
    {
        $this->level = $level;
    }
    /**
     * Gets the name of the logger which created the event.
     */
    public function getLogger() : ?string
    {
        return $this->logger;
    }
    /**
     * Sets the name of the logger which created the event.
     *
     * @param string|null $logger The logger name
     */
    public function setLogger(?string $logger) : void
    {
        $this->logger = $logger;
    }
    /**
     * Gets the name of the transaction (or culprit) which caused this
     * exception.
     */
    public function getTransaction() : ?string
    {
        return $this->transaction;
    }
    /**
     * Sets the name of the transaction (or culprit) which caused this
     * exception.
     *
     * @param string|null $transaction The transaction name
     */
    public function setTransaction(?string $transaction) : void
    {
        $this->transaction = $transaction;
    }
    /**
     * Gets the name of the server.
     */
    public function getServerName() : ?string
    {
        return $this->serverName;
    }
    /**
     * Sets the name of the server.
     *
     * @param string|null $serverName The server name
     */
    public function setServerName(?string $serverName) : void
    {
        $this->serverName = $serverName;
    }
    /**
     * Gets the release of the program.
     */
    public function getRelease() : ?string
    {
        return $this->release;
    }
    /**
     * Sets the release of the program.
     *
     * @param string|null $release The release
     */
    public function setRelease(?string $release) : void
    {
        $this->release = $release;
    }
    /**
     * Gets the error message.
     */
    public function getMessage() : ?string
    {
        return $this->message;
    }
    /**
     * Gets the formatted message.
     */
    public function getMessageFormatted() : ?string
    {
        return $this->messageFormatted;
    }
    /**
     * Gets the parameters to use to format the message.
     *
     * @return string[]
     */
    public function getMessageParams() : array
    {
        return $this->messageParams;
    }
    /**
     * Sets the error message.
     *
     * @param string      $message   The message
     * @param string[]    $params    The parameters to use to format the message
     * @param string|null $formatted The formatted message
     */
    public function setMessage(string $message, array $params = [], ?string $formatted = null) : void
    {
        $this->message = $message;
        $this->messageParams = $params;
        $this->messageFormatted = $formatted;
    }
    /**
     * Gets a list of relevant modules and their versions.
     *
     * @return array<string, string>
     */
    public function getModules() : array
    {
        return $this->modules;
    }
    /**
     * Sets a list of relevant modules and their versions.
     *
     * @param array<string, string> $modules
     */
    public function setModules(array $modules) : void
    {
        $this->modules = $modules;
    }
    /**
     * Gets the request data.
     *
     * @return array<string, mixed>
     */
    public function getRequest() : array
    {
        return $this->request;
    }
    /**
     * Sets the request data.
     *
     * @param array<string, mixed> $request The request data
     */
    public function setRequest(array $request) : void
    {
        $this->request = $request;
    }
    /**
     * Gets an arbitrary mapping of additional contexts.
     *
     * @return array<string, array<string, mixed>>
     */
    public function getContexts() : array
    {
        return $this->contexts;
    }
    /**
     * Sets the data of the context with the given name.
     *
     * @param string               $name The name that uniquely identifies the context
     * @param array<string, mixed> $data The data of the context
     */
    public function setContext(string $name, array $data) : self
    {
        $this->contexts[$name] = $data;
        return $this;
    }
    /**
     * Gets an arbitrary mapping of additional metadata.
     *
     * @return array<string, mixed>
     */
    public function getExtra() : array
    {
        return $this->extra;
    }
    /**
     * Sets an arbitrary mapping of additional metadata.
     *
     * @param array<string, mixed> $extra The context object
     */
    public function setExtra(array $extra) : void
    {
        $this->extra = $extra;
    }
    /**
     * Gets a list of tags associated to this event.
     *
     * @return array<string, string>
     */
    public function getTags() : array
    {
        return $this->tags;
    }
    /**
     * Sets a list of tags associated to this event.
     *
     * @param array<string, string> $tags The tags to set
     */
    public function setTags(array $tags) : void
    {
        $this->tags = $tags;
    }
    /**
     * Sets or updates a tag in this event.
     *
     * @param string $key   The key that uniquely identifies the tag
     * @param string $value The value
     */
    public function setTag(string $key, string $value) : void
    {
        $this->tags[$key] = $value;
    }
    /**
     * Removes a given tag from the event.
     *
     * @param string $key The key that uniquely identifies the tag
     */
    public function removeTag(string $key) : void
    {
        unset($this->tags[$key]);
    }
    /**
     * Gets the user context.
     */
    public function getUser() : ?UserDataBag
    {
        return $this->user;
    }
    /**
     * Sets the user context.
     *
     * @param UserDataBag|null $user The context object
     */
    public function setUser(?UserDataBag $user) : void
    {
        $this->user = $user;
    }
    /**
     * Gets the server OS context.
     */
    public function getOsContext() : ?OsContext
    {
        return $this->osContext;
    }
    /**
     * Sets the server OS context.
     *
     * @param OsContext|null $osContext The context object
     */
    public function setOsContext(?OsContext $osContext) : void
    {
        $this->osContext = $osContext;
    }
    /**
     * Gets the runtime context data.
     */
    public function getRuntimeContext() : ?RuntimeContext
    {
        return $this->runtimeContext;
    }
    /**
     * Sets the runtime context data.
     *
     * @param RuntimeContext|null $runtimeContext The context object
     */
    public function setRuntimeContext(?RuntimeContext $runtimeContext) : void
    {
        $this->runtimeContext = $runtimeContext;
    }
    /**
     * Gets an array of strings used to dictate the deduplication of this
     * event.
     *
     * @return string[]
     */
    public function getFingerprint() : array
    {
        return $this->fingerprint;
    }
    /**
     * Sets an array of strings used to dictate the deduplication of this
     * event.
     *
     * @param string[] $fingerprint The strings
     */
    public function setFingerprint(array $fingerprint) : void
    {
        $this->fingerprint = $fingerprint;
    }
    /**
     * Gets the environment in which this event was generated.
     */
    public function getEnvironment() : ?string
    {
        return $this->environment;
    }
    /**
     * Sets the environment in which this event was generated.
     *
     * @param string|null $environment The name of the environment
     */
    public function setEnvironment(?string $environment) : void
    {
        $this->environment = $environment;
    }
    /**
     * Gets the breadcrumbs.
     *
     * @return Breadcrumb[]
     */
    public function getBreadcrumbs() : array
    {
        return $this->breadcrumbs;
    }
    /**
     * Set new breadcrumbs to the event.
     *
     * @param Breadcrumb[] $breadcrumbs The breadcrumb array
     */
    public function setBreadcrumb(array $breadcrumbs) : void
    {
        $this->breadcrumbs = $breadcrumbs;
    }
    /**
     * Gets the exception.
     *
     * @return ExceptionDataBag[]
     */
    public function getExceptions() : array
    {
        return $this->exceptions;
    }
    /**
     * Sets the exceptions.
     *
     * @param ExceptionDataBag[] $exceptions The exceptions
     */
    public function setExceptions(array $exceptions) : void
    {
        foreach ($exceptions as $exception) {
            if (!$exception instanceof ExceptionDataBag) {
                throw new \UnexpectedValueException(\sprintf('Expected an instance of the "%s" class. Got: "%s".', ExceptionDataBag::class, \get_debug_type($exception)));
            }
        }
        $this->exceptions = $exceptions;
    }
    /**
     * Gets the stacktrace that generated this event.
     */
    public function getStacktrace() : ?Stacktrace
    {
        return $this->stacktrace;
    }
    /**
     * Sets the stacktrace that generated this event.
     *
     * @param Stacktrace|null $stacktrace The stacktrace instance
     */
    public function setStacktrace(?Stacktrace $stacktrace) : void
    {
        $this->stacktrace = $stacktrace;
    }
    public function getType() : EventType
    {
        return $this->type;
    }
    /**
     * Gets a timestamp representing when the measuring of a transaction started.
     */
    public function getStartTimestamp() : ?float
    {
        return $this->startTimestamp;
    }
    /**
     * Sets a timestamp representing when the measuring of a transaction started.
     *
     * @param float|null $startTimestamp The start time of the measurement
     */
    public function setStartTimestamp(?float $startTimestamp) : void
    {
        $this->startTimestamp = $startTimestamp;
    }
    /**
     * A list of timed application events that have a start and end time.
     *
     * @return Span[]
     */
    public function getSpans() : array
    {
        return $this->spans;
    }
    /**
     * Sets a list of timed application events that have a start and end time.
     *
     * @param Span[] $spans The list of spans
     */
    public function setSpans(array $spans) : void
    {
        $this->spans = $spans;
    }
}
