using SmartStack.Domain.Common;
using SmartStack.Domain.Support.Events;

namespace {{ProjectName}}.Domain.Common;

/// <summary>
/// Extension base entity that adds soft-delete and domain events support
/// on top of SmartStack's <see cref="BaseEntity"/> (which provides Id,
/// CreatedAt, UpdatedAt and the ExtensionData JSON bag).
///
/// Every scaffolded client entity inherits this class — the package's
/// <c>BaseEntity</c> deliberately ships WITHOUT <c>DeletedAt</c> /
/// <c>AddDomainEvent</c>, so the extension owns its own lifecycle surface.
/// </summary>
public abstract class ExtensionBaseEntity : BaseEntity
{
    private readonly List<IDomainEvent> _domainEvents = new();

    /// <summary>
    /// The package's <c>BaseEntity</c> leaves <c>Id</c> and <c>CreatedAt</c>
    /// unset at construction (EF assigns them at SaveChanges). Extension
    /// entities assign both up-front so a factory-created aggregate carries a
    /// REAL identity before any persistence — its creation domain event can
    /// reference <c>Id</c>, and domain unit tests can assert identity without
    /// a DbContext. <c>CoreDbContext.StampAuditFields</c> only fills
    /// <c>CreatedAt</c> when it is still <c>default</c>, so this stays
    /// compatible with the persistence pipeline.
    /// </summary>
    protected ExtensionBaseEntity()
    {
        Id = Guid.NewGuid();
        CreatedAt = DateTime.UtcNow;
    }

    /// <summary>Soft-delete marker — scaffolded EF configs filter on <c>DeletedAt == null</c>.</summary>
    public DateTime? DeletedAt { get; protected set; }

    public IReadOnlyCollection<IDomainEvent> DomainEvents => _domainEvents.AsReadOnly();

    protected void AddDomainEvent(IDomainEvent domainEvent)
    {
        _domainEvents.Add(domainEvent);
    }

    public void ClearDomainEvents()
    {
        _domainEvents.Clear();
    }
}