import type {
  ComplianceRule,
  ComplianceStats,
  ComplianceVehicle,
  ComplianceVehicleDetail,
  ComplianceCompany,
  ComplianceAlert,
  ComplianceAlertPreview,
  SendComplianceAlertPayload,
  SendComplianceAlertResult,
} from "@/domain/entities/compliance";
import type { BackendPaginatedData, PaginationQueryParams } from "@/shared/types";

export interface ComplianceRepository {
  getRules(): Promise<ComplianceRule[]>;
  getStats(params?: { company_id?: number }): Promise<ComplianceStats>;

  /** Filters: search, company_id, status, category, missing, severity, fuel_type, score_min, score_max. */
  getVehicles(params: PaginationQueryParams): Promise<BackendPaginatedData<ComplianceVehicle>>;
  getVehicle(vehicleId: number): Promise<ComplianceVehicleDetail>;

  getCompanies(params: PaginationQueryParams): Promise<BackendPaginatedData<ComplianceCompany>>;
  getAlerts(params: PaginationQueryParams): Promise<BackendPaginatedData<ComplianceAlert>>;

  getVehicleAlertPreview(vehicleId: number): Promise<ComplianceAlertPreview>;
  sendVehicleAlert(vehicleId: number, payload: SendComplianceAlertPayload): Promise<SendComplianceAlertResult>;

  getCompanyAlertPreview(companyId: number): Promise<ComplianceAlertPreview>;
  sendCompanyAlert(companyId: number, payload: SendComplianceAlertPayload): Promise<SendComplianceAlertResult>;

  /** Queue a recompute of the scores (all clients, or one). */
  recompute(companyId?: number): Promise<{ queued: number }>;
}
