Files
game_voice_recorder/packages/shared/src/protocol.ts
EJClaw 9abda88046 M2: 사이트 서버 · 사이트 v1 - gvr.tkrmagid.kr 배포
- site/server: Discord OAuth2 + 봇 토큰 멤버 확인, 세션, 1회용 등록 코드·기기 키 인증, 게임 PC WebSocket 중계(JSON·음성 바이너리), 15초 무응답 잠금, 게임 이미지 캐시, 관리 CLI
- site/web: 타임라인·따라 읽기 재생(단어 강조·이어듣기·현장 모드·재생 게인)·필터·검색·실시간·교정, 발로란트/롤 경기 상세, 잠금 화면(관리자 등록 코드), 모바일, 효과음
- deploy/site: Dockerfile·compose·deploy.sh·make-env.sh (.5, 포트 2972)
- 앱 코어: 사이트 필터 묶음(킬·라운드)과 유저 필터 규칙 맞춤, hello 에 서버 ID

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 01:32:51 +09:00

227 lines
5.8 KiB
TypeScript

// 앱 코어 · 사이트 서버 · 사이트 프런트엔드가 같이 쓰는 타입. docs/dev/ARCHITECTURE.md 4~6장.
export type GameType = 'valorant' | 'lol';
export interface TimeLabel {
/** 발로란트 "R7 · 0:42" / 롤 "21:14" / 경기 밖 "21:08:44" */
primary: string;
/** 발로란트 경기 경과 시간 "12:18" */
secondary?: string;
/** 현실 시각 (unix ms) */
real: number;
}
export interface Word {
w: string;
/** 발화 시작 기준 초 */
s: number;
e: number;
p?: number;
}
export interface User {
id: string;
name: string;
color: string;
avatar: string | null;
excluded: boolean;
riot: { puuid: string; riotId: string }[];
}
export type UtteranceStatus = 'pending' | 'realtime' | 'precise' | 'failed';
export interface UtteranceItem {
kind: 'utterance';
id: string;
ts: number;
endTs: number;
userId: string;
text: string | null;
words: Word[];
noise: boolean;
status: UtteranceStatus;
corrected: boolean;
confidence: number | null;
model: string | null;
audio: { url: string; durationMs: number; gainDb: number } | null;
game: { type: GameType; matchId: string; round?: number } | null;
time: TimeLabel;
}
export type EventType =
| 'kill'
| 'chat'
| 'object'
| 'spike'
| 'round_end'
| 'match_start'
| 'match_end'
| 'multikill'
| 'ace';
export interface PlayerRef {
puuid?: string;
name: string;
team?: string;
/** 발로란트 요원 / 롤 챔피언 */
character?: { id: string; name: string; icon: string | null };
userId?: string;
}
export interface KillData {
killer: PlayerRef | null;
victim: PlayerRef;
assists: PlayerRef[];
weapon: { id: string; name: string; icon: string | null } | null;
headshot?: boolean;
location?: { x: number; y: number } | null;
ally?: boolean;
}
export interface ChatData {
sender: PlayerRef;
channel: 'team' | 'all' | 'party' | 'system';
text: string;
source: 'api' | 'ocr' | 'lcu' | 'log';
}
export interface ObjectData {
object: 'dragon' | 'baron' | 'herald' | 'grub' | 'tower' | 'inhibitor' | 'atakhan';
subtype?: string;
team?: string;
killer?: PlayerRef | null;
ally?: boolean;
}
export interface RoundEndData {
round: number;
win: boolean;
result: string;
score: { ally: number; enemy: number };
}
export interface EventItem {
kind: 'event';
id: string;
ts: number;
game: GameType;
matchId: string;
type: EventType;
data: any;
time: TimeLabel;
userId?: string;
}
export type TimelineItem = UtteranceItem | EventItem;
export interface TimelinePage {
items: TimelineItem[];
next: string | null;
}
export interface MatchSummary {
id: string;
game: GameType;
startedAt: number;
endedAt: number | null;
map: { id: string; name: string; image: string | null };
mode: string;
win: boolean | null;
score: { ally: number; enemy: number } | null;
status: 'live' | 'pending_detail' | 'complete';
participants: string[];
}
export interface MatchPlayer {
puuid: string;
name: string;
tag?: string;
team: string;
ally: boolean;
character: { id: string; name: string; icon: string | null };
kills: number;
deaths: number;
assists: number;
score?: number;
cs?: number;
gold?: number;
level?: number;
items?: { id: number; name: string; icon: string | null }[];
rank?: string | null;
userId?: string;
}
export interface MatchRound {
num: number;
startedAt: number;
endedAt: number;
win: boolean;
result: string;
score: { ally: number; enemy: number };
economy?: Record<string, { spent: number; remaining: number; weapon?: string }>;
}
export interface MatchDetail extends MatchSummary {
players: MatchPlayer[];
rounds?: MatchRound[];
goldDiff?: { t: number; diff: number }[];
events: EventItem[];
utterances: UtteranceItem[];
mapTransform:
| { valorant: { xMultiplier: number; yMultiplier: number; xScalarToAdd: number; yScalarToAdd: number } }
| { lol: { minX: number; minY: number; maxX: number; maxY: number } }
| null;
}
export interface Overview {
guild: { id: string; name: string; icon: string | null } | null;
recording: { active: boolean; channel: string | null; since: number | null; participants: string[] };
users: User[];
games: { valorant: { connected: boolean; inMatch: boolean }; lol: { connected: boolean; inMatch: boolean } };
counts: { utterances: number; matches: number };
version: string;
}
export interface UserProfile {
user: User;
stats: { talkMs: number; count: number; topWords: { w: string; n: number }[] };
matches: MatchSummary[];
}
export type LiveEvent =
| { type: 'utterance.created' | 'utterance.updated'; data: UtteranceItem }
| { type: 'event.created'; data: EventItem }
| { type: 'match.updated'; data: MatchSummary }
| { type: 'recording.state'; data: Overview['recording'] }
| { type: 'users.updated'; data: User[] };
export interface DeviceStatus {
registered: boolean;
online: boolean;
name: string | null;
lastSeen: number | null;
version: string | null;
}
export type BrowserMessage = { type: 'status'; data: { device: DeviceStatus } } | LiveEvent;
// 사이트 서버 ↔ 앱 WebSocket
export type RelayToDevice =
| {
t: 'req';
id: string;
method: string;
path: string;
headers: Record<string, string>;
user: { id: string; name: string; avatar: string | null } | null;
body: string | null;
}
| { t: 'cancel'; id: string }
| { t: 'pong'; ts: number }
| { t: 'welcome'; deviceId: string };
export type RelayFromDevice =
| { t: 'hello'; name: string; version: string; guildId?: string | null }
| { t: 'ping'; ts: number }
| { t: 'res'; id: string; status: number; headers: Record<string, string>; body: string | null }
| { t: 'res_head'; id: string; status: number; headers: Record<string, string> }
| { t: 'res_end'; id: string }
| { t: 'event'; event: LiveEvent };