export type Category = "concert" | "sports" | "festival" | "theater" | "other";

export type Sport = "nfl" | "nba" | "nhl" | "mlb" | "tennis" | "f1" | "soccer" | "other";

export type EventStatus = "announced" | "presale" | "onsale" | "soldout" | "cancelled";

export type DropType = "new" | "status" | "price" | "inventory" | "announcement";

export type SourceCategory = "primary" | "resale" | "scraper";

export type SourceStatus = "healthy" | "degraded" | "down" | "disabled";

export type WatchlistKind =

  | "artist"

  | "team"

  | "venue"

  | "sport"

  | "category"

  | "keyword"

  | "twitter_account";

export type Priority = "low" | "normal" | "high" | "critical";

export interface ApiMeta {

  request_id: string;

  version: string;

  page?: number;

  per_page?: number;

  total?: number;

  total_pages?: number;

}

export interface ApiCollection<T> {

  data: T[];

  meta: ApiMeta;

}

export interface ApiResource<T> {

  data: T;

  meta: ApiMeta;

}

export interface ApiErrorBody {

  error: {

    code: string;

    message: string;

    request_id: string;

    details?: { fields?: Array<{ field: string; message: string }> } & Record<string, unknown>;

  };

}

export interface TicketEvent {

  id: number;

  source_id: string;

  source_event_id: string;

  title: string;

  subtitle: string | null;

  category: Category;

  sport: Sport | null;

  starts_at: string | null;

  venue_name: string | null;

  city: string | null;

  country: string | null;

  latitude: number | null;

  longitude: number | null;

  image_url: string | null;

  on_sale_at: string | null;

  presale_on_sale_at: string | null;

  status: EventStatus;

  price_min: number | null;

  price_max: number | null;

  currency: string;

  inventory_remaining: number | null;

  buy_url: string;

  seatmap_url: string | null;

  first_seen_at: string;

  updated_at: string;

}

export interface Drop {

  id: number;

  event_id: number;

  drop_type: DropType;

  from_state: Record<string, unknown> | null;

  to_state: Record<string, unknown> | null;

  detected_at: string;

  notified: boolean;

  notified_at: string | null;

  event: TicketEvent;

}

export interface WatchlistRule {

  id: number;

  kind: WatchlistKind;

  pattern: string;

  label: string;

  active: boolean;

  priority: Priority;

  matches_30d: number;

  created_at: string;

}

export interface WatchlistCreate {

  kind: WatchlistKind;

  pattern: string;

  label: string;

  priority?: Priority;

}

export interface Source {

  id: string;

  name: string;

  category: SourceCategory;

  enabled: boolean;

  status: SourceStatus;

  last_poll_at: string | null;

  last_success_at: string | null;

  last_error: string | null;

  consecutive_failures: number;

  poll_interval_s: number;

  tight_interval_s: number;

  latency_ms_p50: number | null;

  latency_ms_p95: number | null;

  events_seen_24h: number;

}

export interface Stats {

  drops_24h: number;

  drops_7d: number;

  sources_healthy: number;

  sources_total: number;

  sources_down: number;

  watchlist_matches_24h: number;

  detection_latency_ms_p50: number;

  detection_latency_ms_p99: number;

  events_tracked: number;

  events_onsale_now: number;

}

export type StreamEventName =

  | "drop.new"

  | "drop.status"

  | "drop.price"

  | "drop.inventory"

  | "drop.announcement"

  | "source.health"

  | "system.info";