import type {
  Announcement,
  AnnouncementAudience,
  AnnouncementCatalogs,
  AnnouncementExampleVehicle,
  AnnouncementHistoryEntry,
  AnnouncementInput,
  AnnouncementPreviewToken,
  AnnouncementRules,
  AnnouncementStatus,
  AnnouncementStats,
  AudienceCount,
  EligibilityResult,
  MenuLabelEntry,
  MenuLabelSection,
} from "@/domain/entities/announcement";
import type { BackendPaginatedData, PaginationQueryParams } from "@/shared/types";

export interface AnnouncementRepository {
  list(params: PaginationQueryParams): Promise<BackendPaginatedData<Announcement>>;
  get(id: number): Promise<Announcement>;
  create(input: AnnouncementInput): Promise<Announcement>;
  update(id: number, input: AnnouncementInput): Promise<Announcement>;
  remove(id: number): Promise<void>;

  publish(id: number): Promise<Announcement>;
  unpublish(id: number): Promise<Announcement>;
  archive(id: number): Promise<Announcement>;
  duplicate(id: number): Promise<Announcement>;
  reset(id: number, reason?: string): Promise<Announcement>;

  /** Live count for an audience, saved or not. */
  audienceCount(audience: AnnouncementAudience, rules?: AnnouncementRules): Promise<AudienceCount>;
  /** "Why isn't it shown?" for one company, against an audience (saved or not) and the schedule;
   * with the saved announcement's id, also what its users already did with it. */
  eligibility(input: { id?: number | null; company_id: number; audience: AnnouncementAudience; rules: AnnouncementRules; starts_at: string | null; ends_at: string | null; status: AnnouncementStatus }): Promise<EligibilityResult>;
  /** Published or scheduled modals whose period and audience overlap the given one. */
  overlappingModals(input: { id?: number; starts_at: string | null; ends_at: string | null; audience: AnnouncementAudience }): Promise<Announcement[]>;
  stats(id: number, round?: number): Promise<AnnouncementStats>;
  history(id: number): Promise<AnnouncementHistoryEntry[]>;
  previewToken(id: number, exampleVehicleId?: number): Promise<AnnouncementPreviewToken>;
  uploadMedia(file: File): Promise<{ url: string }>;

  catalogs(): Promise<AnnouncementCatalogs>;
  exampleVehicles(search: string): Promise<AnnouncementExampleVehicle[]>;

  /** « Étiquettes du menu »: Fleet's menu with each entry's status label (BETA…). */
  menuLabels(): Promise<MenuLabelSection[]>;
  /** Sets one entry's label; every client sees it on their next page load. */
  updateMenuLabel(id: number, input: { shown: boolean; text: string | null }): Promise<MenuLabelEntry>;
}
