/** Platform-agnostic types for the messaging provider abstraction. */

export interface Conversation {
  id: string;
  name: string;
  type: "channel" | "dm" | "group" | "inbox" | "thread";
  platform: string;
  unreadCount: number;
  lastActivityAt: number;
  memberCount?: number;
  topic?: string;
  isArchived?: boolean;
  isPrivate?: boolean;
  metadata?: Record<string, unknown>;
}

export interface MessageSender {
  id: string;
  name: string;
  email?: string;
}

export interface Message {
  id: string;
  conversationId: string;
  sender: MessageSender;
  text: string;
  timestamp: number;
  threadId?: string;
  replyCount?: number;
  platform: string;
  reactions?: Array<{ name: string; count: number }>;
  hasAttachments?: boolean;
  metadata?: Record<string, unknown>;
}

export interface SearchResult {
  total: number;
  messages: Message[];
  hasMore: boolean;
  nextCursor?: string;
}

export interface HistoryPageResult {
  messages: Message[];
  hasMore: boolean;
  nextCursor?: string;
}

export interface SendResult {
  id: string;
  timestamp: number;
  conversationId: string;
  threadId?: string;
}

export interface ConnectionInfo {
  connected: boolean;
  user: string;
  platform: string;
  metadata?: Record<string, unknown>;
}

export interface ListOptions {
  types?: Array<"channel" | "dm" | "group" | "inbox">;
  excludeArchived?: boolean;
  limit?: number;
  cursor?: string;
}

export interface HistoryOptions {
  limit?: number;
  before?: string;
  after?: string;
  cursor?: string;
  inclusive?: boolean;
}

export interface SearchOptions {
  count?: number;
  cursor?: string;
}

/** A file to attach to an outbound message, with its content already read into memory. */
export interface OutboundAttachment {
  filename: string;
  mimeType: string;
  data: Buffer;
}

export interface SendOptions {
  threadId?: string;
  /** For email: subject line */
  subject?: string;
  /** For email: in-reply-to message ID */
  inReplyTo?: string;
  /** For email: files to attach. Providers that don't support attachments ignore this. */
  attachments?: OutboundAttachment[];
  /** Optional assistant scope for multi-assistant channels. */
  assistantId?: string;
}

/** Result from a sender digest scan — groups messages by sender for bulk cleanup. */
export interface SenderDigestEntry {
  id: string;
  displayName: string;
  email: string;
  messageCount: number;
  hasUnsubscribe: boolean;
  newestMessageId: string;
  searchQuery: string;
  messageIds: string[];
  hasMore: boolean;
}

export interface SenderDigestResult {
  senders: SenderDigestEntry[];
  totalScanned: number;
  queryUsed: string;
  /** True when pagination was stopped because the scan cap was reached but more messages exist. */
  truncated?: boolean;
}

export interface ArchiveResult {
  archived: number;
  truncated?: boolean;
}