using Microsoft.EntityFrameworkCore;

namespace {{ProjectName}}.Application.Common.Interfaces;

/// <summary>
/// Interface for Extensions DbContext (client-specific entities).
///
/// For Core entities in the V1 whitelist (User, Role, Tenant, TenantOrganisation,
/// Department, JobTitle, Office, Language, Group), declare real navigation
/// properties on your entities — the base class <c>SmartStackExtensionDbContext</c>
/// exposes them via <c>ExcludeFromMigrations</c>, so EF emits a real
/// cross-schema FK at migration time.
///
/// For Core entities OUTSIDE the whitelist (sessions, tokens, navigation,
/// permissions, AI / workflow / support internals, audit logs, …) inject
/// <c>ICoreDataService</c> and use its lookup helpers.
/// </summary>
public interface IExtensionsDbContext
{
    // === YOUR ENTITIES ===
    // Add DbSet properties for your entities here. Example:
    // DbSet<Order> Orders { get; }

    /// <summary>
    /// Generic entity-set accessor. Lets services and handlers query any mapped
    /// extension entity (<c>_context.Set&lt;Order&gt;()</c>) without declaring a
    /// typed DbSet property for each one — and lets unit tests inject an
    /// in-memory <c>ExtensionsDbContext</c> through this interface.
    /// </summary>
    DbSet<TEntity> Set<TEntity>() where TEntity : class;

    /// <summary>
    /// Saves all changes made in this context to the database.
    /// </summary>
    Task<int> SaveChangesAsync(CancellationToken cancellationToken = default);
}