Core Types

import type { CollabKitRole, CollabKitUser, CollabKitRoom, CollabKitOrganization, CollabKitComment, CollabKitUserSession } from '@collab-kit/utils';

type CollabKitRole = 'editor' | 'viewer';

interface CollabKitUser {
  id: string;
  room_id?: string;            // present in REST API responses, stripped from WebSocket responses
  name: string;
  profile_picture?: string;
  custom_id?: string;          // optional external identifier
  created_at?: string;         // present in REST API responses, stripped from WebSocket responses
  joined_at?: string;
  left_at?: string;
  status: 'online' | 'offline';
  token?: string;              // present only in the create-user REST API response
  following?: string[];
  followers?: string[];
}

interface CollabKitRoom {
  id: string;
  account_id: string;
  name: string;
  custom_id?: string;          // optional external identifier
  created_at: string;
  state: 'active' | 'disabled';
  duration_seconds: number;
  active_participants: number;
  total_users_created: number;
}

interface CollabKitOrganization {
  id: string;
  user_id: string;
  email: string;
  name: string;
  description?: string;
  created_at: string;
  status: 'active' | 'disabled' | 'blocked';
}

interface CollabKitClientOptions<T extends StoresConfig = StoresConfig> {
  serverUrl: string;
  authToken: string;
  stores?: T;
}

interface CollabKitComment {
  id: string;
  userId: string;
  text: string;
  reactions: Record<string, string[]>;
  tags: string[];
  parentId: string | null;
  replies: CollabKitComment[];
  createdAt: string;
}

interface CollabKitUserSession {
  id: string;
  user_id: string;
  room_id: string;
  joined_at: string;
  left_at?: string;
}