using HtmlToPdfService.Core.Models;
using PuppeteerSharp;
using PuppeteerSharp.Media;

namespace HtmlToPdfService.Core.Services;

/// <summary>
/// PDF 转换服务接口
/// </summary>
public interface IPdfService
{
    /// <summary>
    /// 将 HTML 内容转换为 PDF
    /// </summary>
    /// <param name="html">HTML 内容</param>
    /// <param name="options">PDF 选项</param>
    /// <param name="callbackUrl">回调 URL（可选）</param>
    /// <param name="callbackHeaders">回调自定义 Headers（可选）</param>
    /// <param name="includePdfInCallback">是否在回调中包含 PDF 数据</param>
    /// <param name="saveLocal">是否保存本地副本</param>
    /// <param name="cancellationToken">取消令牌</param>
    /// <returns>转换结果</returns>
    Task<ConversionResult> ConvertHtmlToPdfAsync(
        string html,
        PdfOptions? options = null,
        string? callbackUrl = null,
        Dictionary<string, string>? callbackHeaders = null,
        bool? includePdfInCallback = null,
        bool? saveLocal = null,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// 将 URL 转换为 PDF
    /// </summary>
    /// <param name="url">URL 地址</param>
    /// <param name="options">PDF 选项</param>
    /// <param name="waitUntil">等待条件</param>
    /// <param name="timeout">页面加载超时（毫秒）</param>
    /// <param name="callbackUrl">回调 URL（可选）</param>
    /// <param name="callbackHeaders">回调自定义 Headers（可选）</param>
    /// <param name="includePdfInCallback">是否在回调中包含 PDF 数据</param>
    /// <param name="saveLocal">是否保存本地副本</param>
    /// <param name="cancellationToken">取消令牌</param>
    /// <returns>转换结果</returns>
    Task<ConversionResult> ConvertUrlToPdfAsync(
        string url,
        PdfOptions? options = null,
        WaitUntilNavigation[]? waitUntil = null,
        int? timeout = null,
        string? callbackUrl = null,
        Dictionary<string, string>? callbackHeaders = null,
        bool? includePdfInCallback = null,
        bool? saveLocal = null,
        CancellationToken cancellationToken = default);
}