Types

interface Message {
  content: string;
  authorId: string;
  authorName: string;
  messageId: string;
  serverId: string | null;   // null for a DM
  channelId: string;         // for a DM, this is the dm id
  isDM: boolean;
  dmId: string | null;
  createdAt: Date | null;
  repliedTo: {
    messageId: string;
    authorId: string;
    content: string;
    createdAt: Date | null;
  } | null;
  mentions: MessageMentions;
  mentionsMe: boolean;
  reply(text: string, opts?: SendOptions): Promise<void>;
  channel: { send(text: string, opts?: SendOptions): Promise<void> };
  react(reactionId: string): Promise<void>;
  unreact(reactionId: string): Promise<void>;
  edit(newContent: string): Promise<void>;
  delete(): Promise<void>;
  pin(): Promise<void>;
  unpin(): Promise<void>;
  pinned?: boolean;
  command?: CommandInvocation;
}

interface SendOptions {
  groupId?: string;
  mentions?: MentionTarget[];
  replyTo?: ReplyTarget;
}

type ReplyTarget = Pick<Message, 'messageId' | 'authorId' | 'createdAt'>;

type MentionTarget =
  | { userId: string }
  | { roleId: string }
  | 'everyone'
  | 'here';

interface MessageMentions {
  userIds: string[];
  names: string[];
  everyone: boolean;
  here: boolean;
}

interface SystemMessageEvent {
  type: 'member_join' | 'bot_add' | 'unknown';
  actorId: string;
  actorName: string;
  serverId: string;
  channelId: string;
  groupId?: string;
}

interface Member {
  userId: string;
  username: string;
  status: number;
  createdAt: Date | null;
  icon: string | null;
  subscriptionTier: number | null;
  isBot: boolean;
  role: MemberRole | null;
}

interface MemberRole {
  id: string;
  name: string;
  color: string | null;
  secondColor: string | null;
  admin: boolean;
}

interface Role {
  id: string;
  name: string;
  color: string | null;
  secondColor: string | null;
  position: number | null;
  memberCount: number;
}

interface BanInfo {
  userId: string;
  username: string | null;
  bannedAt: Date | null;
  reason: string;
}

interface MessageLocation {
  serverId: string | null;
  channelId: string;
  groupId?: string;
  authorId: string;
  createdAtMs: number | null;
}

interface VoiceConnection {
  serverId: string;
  channelId: string;
  groupId: string;
  token: string;
  url: string;
  selfMuted: boolean;
  selfDeafened: boolean;
  joinedAt: Date;
}

interface VoiceParticipant {
  userId: string;
  channelId: string;
  muted: boolean;
  deafened: boolean;
  serverMuted: boolean;
  serverDeafened: boolean;
  webcam: boolean;
  stream: boolean;
  reconnecting: boolean;
  // Deprecated. P2P was removed from the platform, so both are always false.
  p2pWebcam: boolean;
  p2pStream: boolean;
}

type BotStatus = 'invisible' | 'online' | 'away' | 'busy' | 'dnd';

type VoiceStateFlag = 'muted' | 'deafened' | 'webcam' | 'stream' | 'p2pWebcam' | 'p2pStream';

interface Guild {
  id: string;
}

interface BotUser {
  id: string;
  username: string;
}

type PermissionSet = { effectiveRank: number } & Record<PermissionName, boolean>;