using System;
using System.Collections.Generic;
using System.Net;
using System.Reflection;
using System.Threading;
using System.Threading.Tasks;
using System.Web;
using Funq;
using ServiceStack.Configuration;
using ServiceStack.Host;
using ServiceStack.Host.Handlers;
using ServiceStack.Html;
using ServiceStack.IO;
using ServiceStack.Messaging;
using ServiceStack.Script;
using ServiceStack.Web;

namespace ServiceStack;

/// <summary>
/// ASP.NET or HttpListener ServiceStack host
/// </summary>
public interface IAppHost : IResolver
{
    /// <summary>
    /// The base path ServiceStack is hosted on
    /// </summary>
    string PathBase { get; }
        
    /// <summary>
    /// The assemblies reflected to find api services provided in the AppHost constructor
    /// </summary>
    List<Assembly> ServiceAssemblies { get; }
        
    /// <summary>
    /// Register dependency in AppHost IOC on Startup
    /// </summary>
    void Register<T>(T instance);

    /// <summary>
    /// AutoWired Registration of an interface with a concrete type in AppHost IOC on Startup.
    /// </summary>
    void RegisterAs<T, TAs>() where T : TAs;

    /// <summary>
    /// Allows the clean up for executed autowired services and filters.
    /// Calls directly after services and filters are executed.
    /// </summary>
    void Release(object instance);

    /// <summary>
    /// Called at the end of each request. Enables Request Scope.
    /// </summary>
    void OnEndRequest(IRequest request = null);
        
    /// <summary>
    /// Register callbacks to be called at the end of each request.
    /// </summary>
    List<Action<IRequest>> OnEndRequestCallbacks { get; }

    /// <summary>
    /// Register user-defined custom routes.
    /// </summary>
    IServiceRoutes Routes { get; }

    /// <summary>
    /// Inferred Metadata available from existing services 
    /// </summary>
    ServiceMetadata Metadata { get; }

    /// <summary>
    /// Register custom ContentType serializers
    /// </summary>
    IContentTypes ContentTypes { get; }

    /// <summary>
    /// Add Request Filters, to be applied before the dto is deserialized
    /// </summary>
    List<Action<IRequest, IResponse>> PreRequestFilters { get; }

    /// <summary>
    /// Add Request Converter to convert Request DTO's
    /// </summary>
    List<Func<IRequest, object, Task<object>>> RequestConverters { get; }

    /// <summary>
    /// Add Response Converter to convert Response DTO's
    /// </summary>
    List<Func<IRequest, object, Task<object>>> ResponseConverters { get; }

    /// <summary>
    /// Add Request Filters for HTTP Requests
    /// </summary>
    List<Action<IRequest, IResponse, object>> GlobalRequestFilters { get; }

    /// <summary>
    /// Add Async Request Filters for HTTP Requests
    /// </summary>
    List<Func<IRequest, IResponse, object, Task>> GlobalRequestFiltersAsync { get; }

    /// <summary>
    /// Add Response Filters for HTTP Responses
    /// </summary>
    List<Action<IRequest, IResponse, object>> GlobalResponseFilters { get; }

    /// <summary>
    /// Add Async Response Filters for HTTP Responses
    /// </summary>
    List<Func<IRequest, IResponse, object, Task>> GlobalResponseFiltersAsync { get; set; }

    /// <summary>
    /// Add Request Filters for MQ/TCP Requests
    /// </summary>
    List<Action<IRequest, IResponse, object>> GlobalMessageRequestFilters { get; }

    /// <summary>
    /// Add Async Request Filters for MQ/TCP Requests
    /// </summary>
    List<Func<IRequest, IResponse, object, Task>> GlobalMessageRequestFiltersAsync { get; }

    /// <summary>
    /// Add Response Filters for MQ/TCP Responses
    /// </summary>
    List<Action<IRequest, IResponse, object>> GlobalMessageResponseFilters { get; }
        
    /// <summary>
    /// Add Async Response Filters for MQ/TCP Responses
    /// </summary>
    List<Func<IRequest, IResponse, object, Task>> GlobalMessageResponseFiltersAsync { get; }

    /// <summary>
    /// Add Request Filter for a specific Request DTO Type
    /// </summary>
    void RegisterTypedRequestFilter<T>(Action<IRequest, IResponse, T> filterFn);

    /// <summary>
    /// Add an Async Request Filter for a specific Request DTO Type
    /// </summary>
    void RegisterTypedRequestFilterAsync<T>(Func<IRequest, IResponse, T, Task> filterFn);

    /// <summary>
    /// Add <seealso cref="ITypedFilter{T}"/> as a Typed Request Filter for a specific Request DTO Type
    /// </summary>
    /// <typeparam name="T">The DTO Type.</typeparam>
    /// <param name="filter">The <seealso cref="Container"/> methods to resolve the <seealso cref="ITypedFilter{T}"/>.</param>
    void RegisterTypedRequestFilter<T>(Func<Container, ITypedFilter<T>> filter);

    /// <summary>
    /// Add <seealso cref="ITypedFilterAsync{T}"/> as an Async Typed Request Filter for a specific Request DTO Type
    /// </summary>
    /// <typeparam name="T">The DTO Type.</typeparam>
    /// <param name="filter">The <seealso cref="Container"/> methods to resolve the <seealso cref="ITypedFilterAsync{T}"/>.</param>
    void RegisterTypedRequestFilterAsync<T>(Func<Container, ITypedFilterAsync<T>> filter);

    /// <summary>
    /// Add Request Filter for a specific Response DTO Type
    /// </summary>
    void RegisterTypedResponseFilter<T>(Action<IRequest, IResponse, T> filterFn);

    /// <summary>
    /// Add an Async Request Filter for a specific Response DTO Type
    /// </summary>
    void RegisterTypedResponseFilterAsync<T>(Func<IRequest, IResponse, T, Task> filterFn);

    /// <summary>
    /// Add <seealso cref="ITypedFilter{T}"/> as a Typed Request Filter for a specific Request DTO Type
    /// </summary>
    /// <typeparam name="T">The DTO Type.</typeparam>
    /// <param name="filter">The <seealso cref="Container"/> methods to resolve the <seealso cref="ITypedFilter{T}"/>.</param>
    void RegisterTypedResponseFilter<T>(Func<Container, ITypedFilter<T>> filter);

    /// <summary>
    /// Add <seealso cref="ITypedFilterAsync{T}"/> as an Async Typed Request Filter for a specific Request DTO Type
    /// </summary>
    /// <typeparam name="T">The DTO Type.</typeparam>
    /// <param name="filter">The <seealso cref="Container"/> methods to resolve the <seealso cref="ITypedFilterAsync{T}"/>.</param>
    void RegisterTypedResponseFilterAsync<T>(Func<Container, ITypedFilterAsync<T>> filter);

    /// <summary>
    /// Add Request Filter for a specific MQ Request DTO Type
    /// </summary>
    void RegisterTypedMessageRequestFilter<T>(Action<IRequest, IResponse, T> filterFn);

    /// <summary>
    /// Add Request Filter for a specific MQ Response DTO Type
    /// </summary>
    void RegisterTypedMessageResponseFilter<T>(Action<IRequest, IResponse, T> filterFn);

    /// <summary>
    /// Add Request Filter for Service Gateway Requests
    /// </summary>
    List<Action<IRequest, object>> GatewayRequestFilters { get; }

    /// <summary>
    /// Add Async Request Filter for Service Gateway Requests
    /// </summary>
    List<Func<IRequest, object, Task>> GatewayRequestFiltersAsync { get; }

    /// <summary>
    /// Add Response Filter for Service Gateway Responses
    /// </summary>
    List<Action<IRequest, object>> GatewayResponseFilters { get; }

    /// <summary>
    /// Add Async Response Filter for Service Gateway Responses
    /// </summary>
    List<Func<IRequest, object, Task>> GatewayResponseFiltersAsync { get; }

    /// <summary>
    /// Add alternative HTML View Engines
    /// </summary>
    List<IViewEngine> ViewEngines { get; }

    /// <summary>
    /// Provide an exception handler for unhandled exceptions
    /// </summary>
    List<HandleServiceExceptionDelegate> ServiceExceptionHandlers { get; }

    /// <summary>
    /// Provide an exception handler for unhandled exceptions (Async)
    /// </summary>
    List<HandleServiceExceptionAsyncDelegate> ServiceExceptionHandlersAsync { get; }

    /// <summary>
    /// Provide an exception handler for un-caught exceptions
    /// </summary>
    List<HandleUncaughtExceptionDelegate> UncaughtExceptionHandlers { get; }

    /// <summary>
    /// Provide an exception handler for un-caught exceptions (Async)
    /// </summary>
    List<HandleUncaughtExceptionAsyncDelegate> UncaughtExceptionHandlersAsync { get; }

    /// <summary>
    /// Provide an exception handler for Service Gateway Exceptions
    /// </summary>
    List<HandleGatewayExceptionDelegate> GatewayExceptionHandlers { get; }

    /// <summary>
    /// Provide an exception handler for Service Gateway Exceptions (Async)
    /// </summary>
    List<HandleGatewayExceptionAsyncDelegate> GatewayExceptionHandlersAsync { get; }
        
    /// <summary>
    /// Register callbacks fired just before AppHost.Configure() 
    /// </summary>
    List<Action<ServiceStackHost>> BeforeConfigure { get; set; }

    /// <summary>
    /// Register callbacks fired just after AppHost.Configure() 
    /// </summary>
    List<Action<ServiceStackHost>> AfterConfigure { get; set; }

    /// <summary>
    /// Register callbacks to be fired after all plugins are loaded 
    /// </summary>
    List<Action<ServiceStackHost>> AfterPluginsLoaded { get; set; }
        
    /// <summary>
    /// Register callbacks to be fired after the AppHost has finished initializing
    /// </summary>
    List<Action<IAppHost>> AfterInitCallbacks { get; }

    /// <summary>
    /// Register callbacks to be fired when AppHost is being disposed
    /// </summary>
    List<Action<IAppHost>> OnDisposeCallbacks { get; }

    /// <summary>
    /// Skip the ServiceStack Request Pipeline and process the returned IHttpHandler instead
    /// </summary>
    List<Func<IHttpRequest, IHttpHandler>> RawHttpHandlers { get; }

    /// <summary>
    /// Provide a catch-all handler that doesn't match any routes
    /// </summary>
    List<HttpHandlerResolverDelegate> CatchAllHandlers { get; }

    /// <summary>
    /// Provide a fallback handler for not found requests (last filter in Request Pipeline)
    /// </summary>
    List<HttpHandlerResolverDelegate> FallbackHandlers { get; }

    /// <summary>
    /// Use a fall-back Error Handler for handling global errors
    /// </summary>
    IServiceStackHandler GlobalHtmlErrorHttpHandler { get; }

    /// <summary>
    /// Use a Custom Error Handler for handling specific error HttpStatusCodes
    /// </summary>
    Dictionary<HttpStatusCode, IServiceStackHandler> CustomErrorHttpHandlers { get; }

    /// <summary>
    /// Provide a custom model minder for a specific Request DTO
    /// </summary>
    Dictionary<Type, Func<IRequest, object>> RequestBinders { get; }

    /// <summary>
    /// The AppHost config
    /// </summary>
    HostConfig Config { get; }

    /// <summary>
    /// The AppHost AppSettings. Defaults to App or Web.config appSettings.
    /// </summary>
    IAppSettings AppSettings { get; }

    /// <summary>
    /// Allow specific configuration to be overridden at runtime in multi-tenancy Applications
    /// by overriding GetRuntimeConfig in your AppHost
    /// </summary>
    T GetRuntimeConfig<T>(IRequest req, string name, T defaultValue);

    /// <summary>
    /// Register an Adhoc web service on Startup
    /// </summary>
    void RegisterService(Type serviceType, params string[] atRestPaths);

    /// <summary>
    /// Register all Services in Assembly
    /// </summary>
    void RegisterServicesInAssembly(Assembly assembly);

    /// <summary>
    /// List of pre-registered and user-defined plugins to be enabled in this AppHost
    /// </summary>
    List<IPlugin> Plugins { get; }

    /// <summary>
    /// Apply plugins to this AppHost
    /// </summary>
    void LoadPlugin(params IPlugin[] plugins);

    /// <summary>
    /// Returns the Absolute File Path, relative from your AppHost's Project Path
    /// </summary>
    string MapProjectPath(string relativePath);

    /// <summary>
    /// Cascading number of file sources, inc. Embedded Resources, File System, In Memory, S3
    /// </summary>
    IVirtualPathProvider VirtualFileSources { get; set; }

    /// <summary>
    /// Read/Write Virtual FileSystem. Defaults to FileSystemVirtualPathProvider
    /// </summary>
    IVirtualFiles VirtualFiles { get; set; }
        
    /// <summary>
    /// The WebRoot VFS Directory of the cascading VirtualFileSources 
    /// </summary>
    IVirtualDirectory RootDirectory { get; }
        
    /// <summary>
    /// The ContentRoot VFS Directory of the read/write VirtualFiles Provider 
    /// </summary>
    IVirtualDirectory ContentRootDirectory { get; }
        
    /// <summary>
    /// Insert Virtual File Sources at the beginning so they take precedence over built-in sources 
    /// </summary>
    List<IVirtualPathProvider> InsertVirtualFileSources { get; set; }
        
    /// <summary>
    /// Add additional Virtual File Sources at the end after built-in Virtual File Sources 
    /// </summary>
    List<IVirtualPathProvider> AddVirtualFileSources { get; }

    /// <summary>
    /// Create a service runner for IService actions
    /// </summary>
    IServiceRunner<TRequest> CreateServiceRunner<TRequest>(ActionContext actionContext);

    /// <summary>
    /// Resolve the absolute url for this request
    /// </summary>
    string ResolveAbsoluteUrl(string virtualPath, IRequest httpReq);

    /// <summary>
    /// Resolve localized text, returns itself by default.
    /// The Request is provided when exists.
    /// </summary>
    string ResolveLocalizedString(string text, IRequest request);

    /// <summary>
    /// Execute MQ Message in ServiceStack
    /// </summary>
    object ExecuteMessage(IMessage mqMessage);

    /// <summary>
    /// Execute MQ Message in ServiceStack
    /// </summary>
    Task<object> ExecuteMessageAsync(IMessage mqMessage, CancellationToken token=default);
        
    /// <summary>
    /// Access Service Controller for ServiceStack
    /// </summary>
    ServiceController ServiceController { get; }

    /// <summary>
    /// Publish Message to be processed by AppHost
    /// </summary>
    void PublishMessage<T>(IMessageProducer messageProducer, T message);
        
    /// <summary>
    /// Global #Script ScriptContext for AppHost. Returns SharpPagesFeature plugin or fallsback to DefaultScriptContext.
    /// </summary>
    ScriptContext ScriptContext { get; }

    /// <summary>
    /// Evaluate Expressions in ServiceStack's ScriptContext.
    /// Can be overridden if you want to customize how different expressions are evaluated.
    /// </summary>
    object EvalExpression(string expr);

    /// <summary>
    /// Evaluate Expressions in ServiceStack's ScriptContext.
    /// Can be overridden if you want to customize how different expressions are evaluated.
    /// </summary>
    object EvalExpressionCached(string expr);

    /// <summary>
    /// Evaluate a script value, `IScriptValue.Expression` results are cached globally.
    /// If `IRequest` is provided, results from the same `IScriptValue.Eval` are cached per request. 
    /// </summary>
    object EvalScriptValue(IScriptValue scriptValue, IRequest req = null, Dictionary<string, object> args = null);

    /// <summary>
    /// Evaluate a script value, `IScriptValue.Expression` results are cached globally.
    /// If `IRequest` is provided, results from the same `IScriptValue.Eval` are cached per request. 
    /// </summary>
    Task<object> EvalScriptValueAsync(IScriptValue scriptValue, IRequest req = null, Dictionary<string, object> args = null);

    /// <summary>
    /// Register a callback to configure a plugin just before it's registered 
    /// </summary>
    void ConfigurePlugin<T>(Action<T> configure) where T : class, IPlugin;

    /// <summary>
    /// Register a callback to configure a plugin just after it's registered 
    /// </summary>
    void PostConfigurePlugin<T>(Action<T> configure) where T : class, IPlugin;

    /// <summary>
    /// Register a callback to configure a plugin after AfterPluginsLoaded is run 
    /// </summary>
    void AfterPluginLoaded<T>(Action<T> configure) where T : class, IPlugin;
    
    /// <summary>
    /// Whether the AppHost has been disposed
    /// </summary>
    bool IsDisposed { get; }
}

public interface IHasAppHost
{
    IAppHost AppHost { get; }
}