sozsoft-platform/api/modules/Sozsoft.SqlQueryManager/Sozsoft.SqlQueryManager.Application.Contracts/ISqlObjectManagerAppService.cs

using System.Collections.Generic;
using System.Threading.Tasks;
using Volo.Abp.Application.Services;

namespace Sozsoft.SqlQueryManager.Application.Contracts;

/// <summary>
/// SQL Query Manager - executes T-SQL and provides database metadata.
/// Does not persist SQL objects to its own tables.
/// </summary>
public interface ISqlObjectManagerAppService : IApplicationService
{
    /// <summary>
    /// Returns tables (and optionally templates) available on the given data source.
    /// </summary>
    Task<SqlObjectExplorerDto> GetAllObjectsAsync(string dataSourceCode);

    /// <summary>
    /// Executes raw T-SQL against the specified data source.
    /// </summary>
    Task<SqlQueryExecutionResultDto> ExecuteQueryAsync(ExecuteSqlQueryDto input);

    // Database Metadata Operations
    Task<List<DatabaseColumnDto>> GetTableColumnsAsync(string dataSourceCode, string schemaName, string tableName);
    Task<string> GetTableCreateScriptAsync(string dataSourceCode, string schemaName, string tableName);

    /// <summary>
    /// Gets the SQL definition/body of a native SQL Server object (Stored Procedure, View, or Function)
    /// </summary>
    Task<string> GetNativeObjectDefinitionAsync(string dataSourceCode, string schemaName, string objectName);

    /// <summary>
    /// Saves the T-SQL script to {SeedsRoot}/{host|tenants/{tenantId}}/{sql|postgres}/object/{fileName}.sql
    /// (repo: configs/seeds). The scope folder follows the current tenant: host context writes to host/.
    /// Called automatically after a successful SqlTableDesigner deploy so the script can be re-seeded.
    /// </summary>
    Task SaveTableScriptAsync(SaveTableScriptDto input);

    /// <summary>
    /// Deletes matching SQL seed files from the current scope's object folder when objects are
    /// dropped from the UI.
    /// Non-existing files are ignored.
    /// </summary>
    Task DeleteSqlDataFilesAsync(DeleteSqlDataFilesDto input);
}