box-nestjs-monorepo/libs/common/src/events/user-login-event.dto.ts

// libs/common/src/events/user-login-event.dto.ts

export interface UserLoginEventPayload {
  uid: string; // device ID
  ip: string; // login IP
  userAgent?: string; // optional, but useful
  appVersion?: string; // optional
  os?: string; // iOS / Android / Browser / Web
  channelId?: string; // required channel ID
  machine?: string; // required machine model

  tokenId?: string; // JWT jti or session token ID (optional for now)

  // epoch millis; will be stored as BigInt in Mongo
  loginAt: number | bigint;
}