using EAIAdminDAL.DTO;
using GB5Shared.DTO.Framework.Login;
using System.Threading;
using System.Threading.Tasks;

namespace EAIAdminBLL.Sync
{
    /// <summary>
    /// Pushes/pulls EAIAdmin config to/from gbEAI (AI-Enterprise-v1.0) over REST, built on top of
    /// the shared GB5Shared.ExternalAI.IAIEngineSyncClient transport. One method pair per entity.
    ///
    /// Failure semantics (every Push*/Delete* method): called AFTER the caller's own local
    /// IQueryExecutor commit has already succeeded — never inside a DB transaction. A failed push
    /// does NOT roll back the local save; GB5 stays system-of-record even when gbEAI is
    /// unreachable. Callers surface EAISyncResult.Success == false as a warning suffix on their
    /// own return message, never as a thrown exception.
    ///
    /// Every Push* call is an upsert on the gbEAI side, keyed by each entity's business code (not
    /// gbEAI's own numeric id) — GB5 never needs to know gbEAI's id ahead of time; it comes back
    /// in the result and is persisted onto each table's EAIRemoteId column as a correlation
    /// accelerator only. Every Delete* call no-ops (Success=true) if EAIRemoteId is null — nothing
    /// was ever synced remotely, so there is nothing to delete there.
    /// </summary>
    public interface IEAISyncClient
    {
        Task<EAISyncResult> PushInitiativeAsync(
            EAIInitiativeAdminDTO dto, LoginDTO login, CancellationToken ct = default);
        Task<EAISyncResult> DeleteInitiativeAsync(
            EAIInitiativeAdminDTO dto, LoginDTO login, CancellationToken ct = default);

        Task<EAISyncResult> PushCapabilityAsync(
            EAICapabilityAdminDTO dto, LoginDTO login, CancellationToken ct = default);
        Task<EAISyncResult> DeleteCapabilityAsync(
            EAICapabilityAdminDTO dto, LoginDTO login, CancellationToken ct = default);

        Task<EAISyncResult> PushBotAsync(
            EAIBotAdminDTO dto, LoginDTO login, CancellationToken ct = default);
        Task<EAISyncResult> DeleteBotAsync(
            EAIBotAdminDTO dto, LoginDTO login, CancellationToken ct = default);

        /// <summary>Response carries the new server-computed PromptVersion in addition to
        /// EAIRemoteId — callers must persist both back onto the local row.</summary>
        Task<EAISyncResult> PushPromptTemplateAsync(
            EAIPromptTemplateAdminDTO dto, LoginDTO login, CancellationToken ct = default);
        Task<EAISyncResult> DeletePromptTemplateAsync(
            EAIPromptTemplateAdminDTO dto, LoginDTO login, CancellationToken ct = default);

        /// <summary>Never sends dto.ApiKeyVaultKey's underlying secret — only the Vault path
        /// itself is not even sent to gbEAI at all (gbEAI has no Vault client; GB5 never forwards
        /// the raw key). This call carries only modelCode/modelName/provider/endpoint.</summary>
        Task<EAISyncResult> PushModelConfigAsync(
            EAIModelConfigAdminDTO dto, LoginDTO login, CancellationToken ct = default);
        Task<EAISyncResult> DeleteModelConfigAsync(
            EAIModelConfigAdminDTO dto, LoginDTO login, CancellationToken ct = default);

        Task<EAISyncResult> PushAgentRouteAsync(
            EAIAgentRouteAdminDTO dto, LoginDTO login, CancellationToken ct = default);
        Task<EAISyncResult> DeleteAgentRouteAsync(
            EAIAgentRouteAdminDTO dto, LoginDTO login, CancellationToken ct = default);
    }
}