<?php

declare(strict_types=1);

namespace KTXF\Event;

/**
 * Base event class for the event bus system
 */
class Event
{
    private bool $propagationStopped = false;
    private readonly array $data;
    private readonly float $timestamp;
    private readonly string $eventId;

    public function __construct(
        private readonly string $name,
        array $data = [],
        private readonly ?string $tenantId = null,
        private readonly ?string $identityId = null,
    ) {
        self::validateData($data);

        $this->data = $data;
        $this->timestamp = microtime(true);
        $this->eventId = bin2hex(random_bytes(16));
    }

    /**
     * Get the event name
     */
    public function getName(): string
    {
        return $this->name;
    }

    /**
     * Get a data value by key
     */
    public function get(string $key, mixed $default = null): mixed
    {
        return $this->data[$key] ?? $default;
    }

    /**
     * Check if a data key exists
     */
    public function has(string $key): bool
    {
        return array_key_exists($key, $this->data);
    }

    /**
     * Get all data
     */
    public function getData(): array
    {
        return $this->data;
    }

    /**
     * Alias for getData() for backward compatibility
     */
    public function all(): array
    {
        return $this->data;
    }

    /**
     * Get the event timestamp
     */
    public function getTimestamp(): float
    {
        return $this->timestamp;
    }

    public function getEventId(): string
    {
        return $this->eventId;
    }

    /**
     * Stop event propagation to subsequent listeners
     */
    public function stopPropagation(): void
    {
        $this->propagationStopped = true;
    }

    /**
     * Check if propagation is stopped
     */
    public function isPropagationStopped(): bool
    {
        return $this->propagationStopped;
    }

    /**
     * Get tenant ID for multi-tenant context
     */
    public function getTenantId(): ?string
    {
        return $this->tenantId;
    }

    /**
     * Get identity ID (user who triggered the event)
     */
    public function getIdentityId(): ?string
    {
        return $this->identityId;
    }

    private static function validateData(array $data): void
    {
        foreach ($data as $value) {
            if (is_array($value)) {
                self::validateData($value);
                continue;
            }
            if ($value !== null && !is_scalar($value)) {
                throw new \InvalidArgumentException(
                    'Event data must contain only scalar, null, or array values.',
                );
            }
        }
    }
}