using System;

namespace XP.Common.Dump.Interfaces
{
    /// <summary>
    /// Dump 文件管理服务接口 | Dump file management service interface
    /// </summary>
    public interface IDumpService : IDisposable
    {
        /// <summary>
        /// 手动触发 Mini Dump 生成 | Manually trigger Mini Dump generation
        /// </summary>
        /// <returns>生成的 Dump 文件完整路径，失败返回 null | Full path of generated dump file, null on failure</returns>
        string? CreateMiniDump();

        /// <summary>
        /// 手动触发 Full Dump 生成 | Manually trigger Full Dump generation
        /// </summary>
        /// <returns>生成的 Dump 文件完整路径，失败返回 null | Full path of generated dump file, null on failure</returns>
        string? CreateFullDump();

        /// <summary>
        /// 启动服务（订阅崩溃事件、启动定时任务和清理任务）| Start service (subscribe crash events, start scheduled and cleanup tasks)
        /// </summary>
        void Start();

        /// <summary>
        /// 停止服务（取消定时任务、取消事件订阅）| Stop service (cancel scheduled tasks, unsubscribe events)
        /// </summary>
        void Stop();
    }
}