Participant Events

[son-hyejun]

📑 Participant Events Overview

Category	Event (String)	Direction	Payload Schema	Link
Participant	room:pt_joined	⬇️	PtJoinedPayload	room:pt_joined
Participant	room:pt_disconnect	⬇️	PtDisconnectPayload	room:pt_disconnect
Participant	room:pt_left	⬇️	PtLeftPayload	room:pt_left
Participant	pt:update	⬇️	PtUpdatePayload	pt:update
Participant	pt:update_role	⬆️	PtUpdateRolePayload	pt:update_role
Participant	pt:update_nickname	⬆️	PtUpdateNamePayload	pt:update_nickname
Host	host:transferred	⬇️	HostTransferredPayload	host:transferred
Host	host:claim	⬆️	ClaimHostPayload	host:claim
Host	host:claim:request	⬇️	HostClaimRequestPayload	host:claim:request
Host	host:claim:accept	⬆️	-	host:claim:accept
Host	host:claim:reject	⬆️	-	host:claim:reject
Host	host:claim:rejected	⬇️	-	host:claim:rejected
Host	host:claim:cancelled	⬇️	-	host:claim:cancelled
Host	host:claim:failed	⬇️	-	host:claim:failed

• ⬆️ C -> S: 클라이언트가 서버로 송신 (Request/Emit)
• ⬇️ S -> C: 서버가 클라이언트로 송신 (Response/Broadcast)
• 🔁 C <-> S: 양방향 통신

---

👥 Participant 상세 명세

room:pt_joined

Direction

• Server → Client (새 참가자 입장 알림)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• packages\common\src\schemas\socket\pt.schema.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod) ptJoinedPayloadSchema

z.object({
  pt: ptSchema,
});

TypeScript Type

type PtJoinedPayload = {
  pt: Pt;
};

---

room:pt_disconnect

Direction

• Server → Client (참가자 연결 끊김 알림)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• packages\common\src\schemas\socket\pt.schema.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod) ptDisconnectPayloadSchema

z.object({
  ptId: ptIdSchema,
});

TypeScript Type

type PtDisconnectPayload = {
  ptId: string;
};

---

room:pt_left

Direction

• Server → Client (참가자 퇴장 알림)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• packages\common\src\schemas\socket\pt.schema.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod) ptLeftPayloadSchema

z.object({
  ptId: ptIdSchema,
});

TypeScript Type

type PtLeftPayload = {
  ptId: string;
};

---

pt:update

Direction

• Server → Client (참가자 정보 업데이트 알림)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• packages\common\src\schemas\socket\pt.schema.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod) ptUpdatePayloadSchema

z.object({
  pt: ptSchema,
});

TypeScript Type

type PtUpdatePayload = {
  pt: Pt;
};

---

pt:update_role

Direction

• Client → Server (참가자 권한 업데이트 요청, Host Only)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• packages\common\src\schemas\socket\pt.schema.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.gateway.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod) ptUpdateRolePayloadSchema

z.object({
  ptId: ptIdSchema,
  role: updatablePtRoleSchema,
});

TypeScript Type

type PtUpdateRolePayload = {
  ptId: string;
  role: 'viewer' | 'editor';
};

---

pt:update_nickname

Direction

• Client → Server (참가자 닉네임 업데이트 요청)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• packages\common\src\schemas\socket\pt.schema.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.gateway.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod) ptUpdateNamePayloadSchema

z.object({
  ptId: ptIdSchema,
  nickname: nicknameSchema,
});

TypeScript Type

type PtUpdateNamePayload = {
  ptId: string;
  nickname: string;
};

---

👑 Host 상세 명세

host:transferred

Direction

• Server → Client (호스트 권한 이전 알림)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• packages\common\src\schemas\socket\pt.schema.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod) hostTransferredPayloadSchema

z.object({
  newHostPtId: ptIdSchema,
});

TypeScript Type

type HostTransferredPayload = {
  newHostPtId: string;
};

---

host:claim

Direction

• Client → Server (호스트 권한 요청)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• packages\common\src\schemas\socket\pt.schema.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.gateway.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod) claimHostPayloadSchema

z.object({
  hostPassword: passwordSchema,
});

TypeScript Type

type ClaimHostPayload = {
  hostPassword: string;
};

---

host:claim:request

Direction

• Server → Client (호스트 권한 요청 알림, 현재 호스트에게 전송)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• packages\common\src\schemas\socket\pt.schema.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod) hostClaimRequestPayloadSchema

z.object({
  requesterPtId: ptIdSchema,
  requesterNickname: nicknameSchema,
});

TypeScript Type

type HostClaimRequestPayload = {
  requesterPtId: string;
  requesterNickname: string;
};

---

host:claim:accept

Direction

• Client → Server (호스트 권한 요청 수락, 현재 Host만 가능)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.gateway.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod)

• Payload 없음

---

host:claim:reject

Direction

• Client → Server (호스트 권한 요청 거절, 현재 Host만 가능)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.gateway.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod)

• Payload 없음

---

host:claim:rejected

Direction

• Server → Client (호스트 권한 요청 거절됨 알림)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod)

• Payload 없음

---

host:claim:cancelled

Direction

• Server → Client (호스트 권한 요청 취소됨 알림)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod)

• Payload 없음

---

host:claim:failed

Direction

• Server → Client (호스트 권한 요청 실패 알림)

Used In (Files)

• packages\common\src\constants\socket-events.ts
• apps\client\src\stores\socket-events\pts.ts
• apps\server\src\modules\collaboration\collaboration.service.ts

Schema (Zod)

• Payload 없음

[son-hyejun]

• ⬆️ C -> S: 클라이언트가 서버로 송신 (Request/Emit)
• ⬇️ S -> C: 서버가 클라이언트로 송신 (Response/Broadcast)
• 🔁 C <-> S: 양방향 통신