Umbraco-CMS/src/Umbraco.Infrastructure/Persistence/UmbracoDatabaseExtensions.cs

using System.Linq.Expressions;
using NPoco;
using Umbraco.Cms.Core.Models;
using Umbraco.Cms.Core.Persistence;
using Umbraco.Cms.Infrastructure.Persistence.Dtos;
using Umbraco.Cms.Infrastructure.Persistence.SqlSyntax;
using Umbraco.Cms.Infrastructure.Runtime;
using Umbraco.Extensions;

namespace Umbraco.Cms.Infrastructure.Persistence;

internal static class UmbracoDatabaseExtensions
{
    public static UmbracoDatabase AsUmbracoDatabase(this IUmbracoDatabase database)
    {
        if (database is not UmbracoDatabase asDatabase)
        {
            throw new Exception("oops: database.");
        }

        return asDatabase;
    }

    /// <summary>
    ///     Gets a dictionary of key/values directly from the database, no scope, nothing.
    /// </summary>
    /// <remarks>Used by <see cref="RuntimeState" /> to determine the runtime state.</remarks>
    public static IReadOnlyDictionary<string, string?>? GetFromKeyValueTable(
        this IUmbracoDatabase? database,
        string keyPrefix)
    {
        if (database is null)
        {
            return null;
        }

        // create the wildcard where clause
        ISqlSyntaxProvider sqlSyntax = database.SqlContext.SqlSyntax;
        var whereParam = sqlSyntax.GetStringColumnWildcardComparison(
            sqlSyntax.GetColumn(database.SqlContext.DatabaseType, KeyValueDto.TableName, "key", null),
            0,
            TextColumnType.NVarchar);

        Sql<ISqlContext>? sql = database.SqlContext.Sql()
            .Select<KeyValueDto>()
            .From<KeyValueDto>()
            .Where(whereParam, keyPrefix + sqlSyntax.GetWildcardPlaceholder());

        return database.Fetch<KeyValueDto>(sql)
            .ToDictionary(x => x.Key, x => x.Value);
    }

    /// <summary>
    ///     Returns true if the database contains the specified table
    /// </summary>
    /// <param name="database"></param>
    /// <param name="tableName"></param>
    /// <returns></returns>
    public static bool HasTable(this IUmbracoDatabase database, string tableName)
    {
        try
        {
            return database.SqlContext.SqlSyntax.GetTablesInSchema(database)
                .Any(table => table.InvariantEquals(tableName));
        }
        catch (Exception)
        {
            return false; // will occur if the database cannot connect
        }
    }

    /// <summary>
    ///     Returns true if the database contains no tables
    /// </summary>
    /// <param name="database"></param>
    /// <returns></returns>
    public static bool IsDatabaseEmpty(this IUmbracoDatabase database)
        => database.SqlContext.SqlSyntax.GetTablesInSchema(database).Any() == false;

    public static long Count(this IUmbracoDatabase database, Sql sql)
    {
        // We need to copy the sql into a new object, to avoid this method from changing the sql.
        var query = new Sql().Select("COUNT(*)").From().Append("(").Append(new Sql(sql.SQL, sql.Arguments)).Append(") as count_query");

        return database.ExecuteScalar<long>(query);
    }

    public static async Task<long> CountAsync(this IUmbracoDatabase database, Sql sql)
    {
        // We need to copy the sql into a new object, to avoid this method from changing the sql.
        Sql query = new Sql().Select("COUNT(*)").From().Append("(").Append(new Sql(sql.SQL, sql.Arguments)).Append(") as count_query");

        return await database.ExecuteScalarAsync<long>(query);
    }

    public static async Task<PagedModel<TResult>> PagedAsync<TDto, TResult>(
        this IUmbracoDatabase database,
        Sql<ISqlContext> sql,
        int skip,
        int take,
        Action<Sql<ISqlContext>> sortingAction,
        Func<TDto, TResult> mapper)
    {
        ArgumentOutOfRangeException.ThrowIfLessThan(skip, 0, nameof(skip));
        ArgumentOutOfRangeException.ThrowIfLessThan(take, 0, nameof(take));

        var count = await database.CountAsync(sql);
        if (take == 0 || skip >= count)
        {
            return new PagedModel<TResult>
            {
                Total = count,
                Items = [],
            };
        }

        sortingAction(sql);

        List<TDto> results = await database.SkipTakeAsync<TDto>(
            skip,
            take,
            sql);

        return new PagedModel<TResult>
        {
            Total = count,
            Items = results.Select(mapper),
        };
    }
}