using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

namespace ManagerService.Services
{
    /// <summary>
    /// Transforme du texte en vecteur pour la recherche sémantique du guide IA.
    /// La dimension est figée dans le schéma (`vector(768)` sur ContentEmbedding) :
    /// changer de modèle ou de dimension impose un re-embed complet et une migration de colonne.
    /// </summary>
    public interface IEmbeddingService
    {
        int Dimensions { get; }

        Task<float[]> EmbedAsync(string text, CancellationToken cancellationToken = default);

        /// <summary>
        /// Vectorise plusieurs textes en un minimum d'appels réseau.
        /// Indispensable : un PDF de 100 pages produit ~150 morceaux, soit autant
        /// d'allers-retours HTTP séquentiels si on n'embed qu'un texte à la fois.
        /// L'ordre des résultats suit celui des textes fournis.
        /// </summary>
        Task<IReadOnlyList<float[]>> EmbedBatchAsync(IReadOnlyList<string> texts, CancellationToken cancellationToken = default);
    }
}