calendar/packages/lib/server/repository/bookingReport.interface.ts

import type { BookingReportReason, BookingReportStatus } from "@calcom/prisma/enums";

export interface CreateBookingReportInput {
  bookingUid: string;
  bookerEmail: string;
  reportedById: number;
  reason: BookingReportReason;
  description?: string;
  cancelled: boolean;
  organizationId?: number | null;
}

export interface BookingReportSummary {
  id: string;
  reportedById: number | null;
  reason: BookingReportReason;
  description: string | null;
  createdAt: Date;
}

export interface ListBookingReportsFilters {
  reason?: BookingReportReason[];
  cancelled?: boolean;
  hasWatchlist?: boolean;
  status?: BookingReportStatus[];
}

export interface BookingReportWithDetails {
  id: string;
  bookingUid: string;
  bookerEmail: string;
  reportedById: number | null;
  reason: BookingReportReason;
  description: string | null;
  cancelled: boolean;
  createdAt: Date;
  status: BookingReportStatus;
  watchlistId: string | null;
  reporter: {
    id: number;
    email: string;
    name: string | null;
  } | null;
  booking: {
    id: number;
    uid: string;
    title: string | null;
    startTime: Date;
    endTime: Date;
  };
  watchlist: {
    id: string;
    type: string;
    value: string;
    action: string;
    description: string | null;
  } | null;
  organization: {
    id: number;
    name: string;
    slug: string | null;
  } | null;
}

export interface IBookingReportRepository {
  createReport(input: CreateBookingReportInput): Promise<{ id: string }>;

  findAllReportedBookings(params: {
    organizationId?: number;
    skip?: number;
    take?: number;
    searchTerm?: string;
    filters?: ListBookingReportsFilters;
  }): Promise<{
    rows: BookingReportWithDetails[];
    meta: { totalRowCount: number };
  }>;

  findReportsByIds(params: {
    reportIds: string[];
    organizationId?: number;
  }): Promise<BookingReportWithDetails[]>;

  linkWatchlistToReport(params: { reportId: string; watchlistId: string }): Promise<void>;

  updateReportStatus(params: {
    reportId: string;
    status: BookingReportStatus;
    organizationId?: number;
  }): Promise<void>;

  bulkUpdateReportStatus(params: {
    reportIds: string[];
    status: BookingReportStatus;
    organizationId?: number;
  }): Promise<{ updated: number }>;

  bulkLinkWatchlistWithStatus(params: {
    links: Array<{ reportId: string; watchlistId: string }>;
    status: BookingReportStatus;
  }): Promise<void>;

  countPendingReports(params: { organizationId: number }): Promise<number>;
}