/*
 * SonarQube
 * Copyright (C) 2009-2025 SonarSource SA
 * mailto:info AT sonarsource DOT com
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 3 of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 */
package org.sonar.db.purge;

import java.util.List;
import java.util.Set;
import javax.annotation.CheckForNull;
import javax.annotation.Nullable;
import org.apache.ibatis.annotations.Param;

public interface PurgeMapper {

  List<String> selectAnalysisUuids(PurgeSnapshotQuery query);

  /**
   * Returns the list of subviews and the application/view/project for the specified project_uuid.
   */
  List<String> selectRootAndSubviewsByProjectUuid(@Param("rootUuid") String rootUuid);

  Set<String> selectDisabledComponentsWithFileSource(@Param("branchUuid") String branchUuid);

  Set<String> selectDisabledComponentsWithUnresolvedIssues(@Param("branchUuid") String branchUuid);

  Set<String> selectDisabledComponentsWithMeasures(@Param("branchUuid") String branchUuid);

  void deleteAnalyses(@Param("analysisUuids") List<String> analysisUuids);

  void deleteAnalysisProperties(@Param("analysisUuids") List<String> analysisUuids);

  void deleteAnalysisDuplications(@Param("analysisUuids") List<String> analysisUuids);

  void deleteAnalysisEvents(@Param("analysisUuids") List<String> analysisUuids);

  void deleteAnalysisEventComponentChanges(@Param("analysisUuids") List<String> analysisUuids);

  void deleteAnalysisMeasures(@Param("analysisUuids") List<String> analysisUuids);

  void fullDeleteComponentMeasures(@Param("componentUuids") List<String> componentUuids);

  /**
   * Purge status flag is used to not attempt to remove duplications & historical data of analyses
   * for which we already removed them.
   */
  void updatePurgeStatusToOne(@Param("analysisUuids") List<String> analysisUuid);

  void resolveComponentIssuesNotAlreadyResolved(@Param("componentUuids") List<String> componentUuids, @Param("dateAsLong") Long dateAsLong);

  void deleteProjectLinksByProjectUuid(@Param("rootUuid") String rootUuid);

  void deletePropertiesByEntityUuids(@Param("entityUuids") List<String> entityUuids);

  void deleteComponentsByBranchUuid(@Param("rootUuid") String rootUuid);

  void deleteNonMainBranchComponentsByProjectUuid(@Param("uuid") String uuid);

  void deleteProjectsByProjectUuid(@Param("projectUuid") String projectUuid);

  void deleteComponentsByUuids(@Param("componentUuids") List<String> componentUuids);

  void deleteGroupRolesByEntityUuid(@Param("entityUuid") String entityUuid);

  void deleteUserRolesByEntityUuid(@Param("entityUuid") String entityUuid);

  void deleteEventsByComponentUuid(@Param("componentUuid") String componentUuid);

  void deleteEventComponentChangesByComponentUuid(@Param("componentUuid") String componentUuid);

  List<PurgeableAnalysisDto> selectProcessedAnalysisByComponentUuid(@Param("componentUuid") String componentUuid);

  void deleteIssuesByProjectUuid(@Param("projectUuid") String projectUuid);

  void deleteIssueChangesByProjectUuid(@Param("projectUuid") String projectUuid);

  List<String> selectBranchOrphanIssues(@Param("branchUuid") String branchUuid);

  void deleteNewCodeReferenceIssuesByProjectUuid(@Param("projectUuid") String projectUuid);

  void deleteIssuesImpactsByProjectUuid(@Param("projectUuid") String projectUuid);

  List<String> selectOldClosedIssueKeys(@Param("projectUuid") String projectUuid, @Nullable @Param("toDate") Long toDate);

  List<String> selectStaleBranchesAndPullRequests(@Param("projectUuid") String projectUuid, @Param("toDate") Long toDate);

  @CheckForNull
  String selectSpecificAnalysisNewCodePeriod(@Param("projectUuid") String projectUuid);

  List<String> selectDisabledComponentsWithoutIssues(@Param("branchUuid") String branchUuid);

  void deleteIssuesFromKeys(@Param("keys") List<String> keys);

  void deleteIssueChangesFromIssueKeys(@Param("issueKeys") List<String> issueKeys);

  void deleteNewCodeReferenceIssuesFromKeys(@Param("issueKeys") List<String> keys);

  void deleteIssuesImpactsFromKeys(@Param("issueKeys") List<String> keys);

  void deleteFileSourcesByProjectUuid(String rootProjectUuid);

  void deleteFileSourcesByFileUuid(@Param("fileUuids") List<String> fileUuids);

  void deleteCeTaskCharacteristicsOfCeActivityByRootUuidOrBefore(@Nullable @Param("rootUuid") String rootUuid,
    @Nullable @Param("entityUuidToPurge") String entityUuidToPurge, @Nullable @Param("createdAtBefore") Long createdAtBefore);

  void deleteCeTaskInputOfCeActivityByRootUuidOrBefore(@Nullable @Param("rootUuid") String rootUuid,
    @Nullable @Param("entityUuidToPurge") String entityUuidToPurge, @Nullable @Param("createdAtBefore") Long createdAtBefore);

  void deleteCeScannerContextOfCeActivityByRootUuidOrBefore(@Nullable @Param("rootUuid") String rootUuid,
    @Nullable @Param("entityUuidToPurge") String entityUuidToPurge, @Nullable @Param("createdAtBefore") Long createdAtBefore);

  void deleteCeTaskMessageOfCeActivityByRootUuidOrBefore(@Nullable @Param("rootUuid") String rootUuid,
    @Nullable @Param("entityUuidToPurge") String entityUuidToPurge, @Nullable @Param("createdAtBefore") Long createdAtBefore);

  /**
   * Delete rows in CE_ACTIVITY of tasks of the specified component and/or created before specified date.
   */
  void deleteCeActivityByRootUuidOrBefore(@Nullable @Param("rootUuid") String rootUuid,
    @Nullable @Param("entityUuidToPurge") String entityUuidToPurge, @Nullable @Param("createdAtBefore") Long createdAtBefore);

  void deleteCeScannerContextOfCeQueueByRootUuid(@Param("rootUuid") String rootUuid);

  void deleteCeTaskCharacteristicsOfCeQueueByRootUuid(@Param("rootUuid") String rootUuid);

  void deleteCeTaskInputOfCeQueueByRootUuid(@Param("rootUuid") String rootUuid);

  void deleteCeTaskMessageOfCeQueueByRootUuid(@Param("rootUuid") String rootUuid);

  void deleteCeQueueByRootUuid(@Param("rootUuid") String rootUuid);

  void deleteWebhooksByProjectUuid(@Param("projectUuid") String projectUuid);

  void deleteWebhookDeliveriesByProjectUuid(@Param("projectUuid") String projectUuid);

  void deleteAppProjectsByAppUuid(@Param("applicationUuid") String applicationUuid);

  void deleteAppProjectsByProjectUuid(@Param("projectUuid") String projectUuid);

  void deleteAppBranchProjectBranchesByAppUuid(@Param("applicationUuid") String applicationUuid);

  void deleteAppBranchProjectBranchesByProjectUuid(@Param("projectUuid") String projectUuid);

  void deleteAppBranchProjectsByAppBranchUuid(@Param("branchUuid") String applicationBranchUuid);

  void deleteAppBranchProjectBranchesByProjectBranchUuid(@Param("projectBranchUuid") String projectBranchUuid);

  void deletePortfolioProjectsByBranchUuid(@Param("branchUuid") String branchUuid);

  void deletePortfolioProjectsByProjectUuid(@Param("projectUuid") String projectUuid);

  void deletePortfolioProjectBranchesByBranchUuid(@Param("branchUuid") String branchUuid);

  void deleteBranchByUuid(@Param("uuid") String uuid);

  void deleteMeasuresByBranchUuid(@Param("branchUuid") String branchUuid);

  void deleteMeasuresByComponentUuids(@Param("componentUuids") List<String> componentUuids);

  void deleteNewCodePeriodsByProjectUuid(String projectUuid);

  void deleteNewCodePeriodsByBranchUuid(String branchUuid);

  void deleteProjectAlmSettingsByProjectUuid(@Param("projectUuid") String projectUuid);

  void deleteProjectBadgeTokenByProjectUuid(@Param("projectUuid") String rootUuid);

  void deleteUserDismissedMessagesByProjectUuid(@Param("projectUuid") String projectUuid);

  void deleteScannerAnalysisCacheByBranchUuid(@Param("branchUuid") String branchUuid);

  void deleteReportSchedulesByBranchUuid(@Param("branchUuid") String branchUuid);

  void deleteReportSubscriptionsByBranchUuid(@Param("branchUuid") String branchUuid);

  void deleteReportSchedulesByPortfolioUuids(@Param("portfolioUuids") List<String> portfolioUuids);

  void deleteReportSubscriptionsByPortfolioUuids(@Param("portfolioUuids") List<String> portfolioUuids);

  void deleteAnticipatedTransitionsByProjectUuidAndCreationDate(@Param("projectUuid") String projectUuid, @Param("createdAtBefore") Long createdAtBefore);

  void deleteIssuesFixedByBranchUuid(@Param("branchUuid") String branchUuid);

  void deleteScaDependenciesByComponentUuid(@Param("componentUuid") String componentUuid);

  void deleteScaIssuesReleasesByComponentUuid(@Param("componentUuid") String componentUuid);

  void deleteScaReleasesByComponentUuid(@Param("componentUuid") String componentUuid);
}