SVSim/SVSimServer
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

feat(guild): controller scaffolding + /guild/info baseline

Browse Source 
- 5 common DTOs under Models/Dtos/Common/Guild/ (GuildDetailDto,
  GuildUserBaseDto, GuildMemberInfoDto, ChatUserDto, ChatMessageDto)
- 28 per-endpoint request/response DTOs under Models/Dtos/Guild/ and
  Models/Dtos/GuildChat/ with full [MessagePackObject]/[Key]/
  [JsonPropertyName] attribute mirrors on every property
- GuildController (22 actions): /guild/info returns prod-shape with
  config-backed max_member_num/max_sub_leader_num/usable_stamp_list;
  21 stubs return empty/default DTOs
- GuildChatController (7 stubs), /guild_chat/messages stub returns
  wait_interval=10 per config
- 29 new routing smoke test cases (100 total, all pass)
- GuildWireShape literal-JSON test for GuildInfoResponse (1/1 pass)
- GameConfigurationJsonbTests updated for 17th GuildConfig section
- Total: 1422 tests pass, 0 errors

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
gamer147
2026-06-27 12:01:27 -04:00
parent a1aa6998b8
commit 99019963ca
50 changed files with 1576 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
SVSim.EmulatedEntrypoint/Models/Dtos/Common/Guild/ChatMessageDto.cs Normal file
View File

@@ -0,0 +1,54 @@
using MessagePack;
using System.Text.Json;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
/// <summary>
/// Wire shape for a single chat message in /guild_chat/messages `chat_message[]`
/// and /gathering_chat/messages. Matches guild_chat-messages.md ChatMessage interface.
///
/// deck / replay / room are JsonElement? so arbitrary payloads can pass through in Phase 5
/// without premature typing (TODO task-17: replace with typed DTOs when replay subsystem is documented).
/// </summary>
[MessagePackObject]
public class ChatMessageDto
{
[JsonPropertyName("viewer_id"), Key("viewer_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long ViewerId { get; set; }
[JsonPropertyName("message_id"), Key("message_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long MessageId { get; set; }
/// <summary>eMessageType: 0=NORMAL 1=STAMP 2=DECK 3=JOIN 4=LEAVE 5=REPLAY etc.</summary>
[JsonPropertyName("message_type"), Key("message_type"), JsonConverter(typeof(StringifiedIntConverter))]
public int MessageType { get; set; }
[JsonPropertyName("create_time"), Key("create_time"), JsonConverter(typeof(StringifiedLongConverter))]
public long CreateTime { get; set; }
/// <summary>Text body for NORMAL, stringified stamp id for STAMP, etc.</summary>
[JsonPropertyName("message"), Key("message")]
public string Message { get; set; } = "";
/// <summary>Present when message_type = DECK (2). Inline DeckLogData payload.</summary>
[JsonPropertyName("deck"), Key("deck")]
public JsonElement? Deck { get; set; }
/// <summary>Present when message_type = REPLAY (5). Inline ReplayInfoItem payload.</summary>
[JsonPropertyName("replay"), Key("replay")]
public JsonElement? Replay { get; set; }
/// <summary>Present when message_type = ROOM_MATCH (10). Inline room-invite payload.</summary>
[JsonPropertyName("room"), Key("room")]
public JsonElement? Room { get; set; }
/// <summary>GATHERING_TOURNAMENT_ROOM extras — only meaningful for /gathering_chat.</summary>
[JsonPropertyName("viewer_id1"), Key("viewer_id1")]
public long? ViewerId1 { get; set; }
/// <summary>GATHERING_TOURNAMENT_ROOM extras — only meaningful for /gathering_chat.</summary>
[JsonPropertyName("viewer_id2"), Key("viewer_id2")]
public long? ViewerId2 { get; set; }
}

39
SVSim.EmulatedEntrypoint/Models/Dtos/Common/Guild/ChatUserDto.cs Normal file
View File

@@ -0,0 +1,39 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
/// <summary>
/// Generic UserInfoBase shape for chat contexts — used in /guild_chat/messages `users[]`
/// and shared with /gathering_chat. Matches types.ts.md#user-profile-types ChatUser (UserInfoBase).
/// </summary>
[MessagePackObject]
public class ChatUserDto
{
[JsonPropertyName("viewer_id"), Key("viewer_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long ViewerId { get; set; }
[JsonPropertyName("name"), Key("name")]
public string Name { get; set; } = "";
[JsonPropertyName("emblem_id"), Key("emblem_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long EmblemId { get; set; }
[JsonPropertyName("country_code"), Key("country_code")]
public string CountryCode { get; set; } = "";
[JsonPropertyName("rank"), Key("rank"), JsonConverter(typeof(StringifiedIntConverter))]
public int Rank { get; set; }
[JsonPropertyName("degree_id"), Key("degree_id"), JsonConverter(typeof(StringifiedIntConverter))]
public int DegreeId { get; set; }
/// <summary>Optional — omit when the viewer has no friend relationship with this user.</summary>
[JsonPropertyName("is_friend"), Key("is_friend")]
public int? IsFriend { get; set; }
/// <summary>Optional — omit when no pending friend apply.</summary>
[JsonPropertyName("is_friend_apply"), Key("is_friend_apply")]
public int? IsFriendApply { get; set; }
}

41
SVSim.EmulatedEntrypoint/Models/Dtos/Common/Guild/GuildDetailDto.cs Normal file
View File

@@ -0,0 +1,41 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
/// <summary>
/// Mirrors GuildDetailInfo.cs:143-156. Wire ints are emitted as stringified.
/// member_num is included on the wire only when this dto represents a search-result row
/// (the /guild/info "detail" inside `guild` object also includes it).
/// </summary>
[MessagePackObject]
public class GuildDetailDto
{
[JsonPropertyName("guild_id"), Key("guild_id"), JsonConverter(typeof(StringifiedIntConverter))]
public int GuildId { get; set; }
[JsonPropertyName("guild_name"), Key("guild_name")]
public string GuildName { get; set; } = "";
[JsonPropertyName("description"), Key("description")]
public string Description { get; set; } = "";
[JsonPropertyName("guild_emblem_id"), Key("guild_emblem_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long GuildEmblemId { get; set; }
[JsonPropertyName("join_condition"), Key("join_condition"), JsonConverter(typeof(StringifiedIntConverter))]
public int JoinCondition { get; set; }
[JsonPropertyName("activity"), Key("activity"), JsonConverter(typeof(StringifiedIntConverter))]
public int Activity { get; set; }
[JsonPropertyName("member_num"), Key("member_num"), JsonConverter(typeof(StringifiedIntConverter))]
public int MemberNum { get; set; }
[JsonPropertyName("leader_name"), Key("leader_name")]
public string LeaderName { get; set; } = "";
[JsonPropertyName("leader_viewer_id"), Key("leader_viewer_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long LeaderViewerId { get; set; }
}

52
SVSim.EmulatedEntrypoint/Models/Dtos/Common/Guild/GuildMemberInfoDto.cs Normal file
View File

@@ -0,0 +1,52 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
/// <summary>
/// GuildMember wire shape — extends UserInfoBase (flat-spread) with is_official_mark_displayed + role.
/// Matches GuildMemberInfo.cs:43-50 and types.ts.md#guild-types GuildMember.
/// role: 0 = REGULAR, 1 = LEADER, 2 = SUB_LEADER.
/// </summary>
[MessagePackObject]
public class GuildMemberInfoDto
{
[JsonPropertyName("viewer_id"), Key("viewer_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long ViewerId { get; set; }
[JsonPropertyName("name"), Key("name")]
public string Name { get; set; } = "";
[JsonPropertyName("emblem_id"), Key("emblem_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long EmblemId { get; set; }
[JsonPropertyName("country_code"), Key("country_code")]
public string CountryCode { get; set; } = "";
[JsonPropertyName("rank"), Key("rank"), JsonConverter(typeof(StringifiedIntConverter))]
public int Rank { get; set; }
[JsonPropertyName("degree_id"), Key("degree_id"), JsonConverter(typeof(StringifiedIntConverter))]
public int DegreeId { get; set; }
/// <summary>Optional — omit when the caller has no friend relationship with this member.</summary>
[JsonPropertyName("is_friend"), Key("is_friend")]
public int? IsFriend { get; set; }
/// <summary>Optional — omit when no pending friend apply.</summary>
[JsonPropertyName("is_friend_apply"), Key("is_friend_apply")]
public int? IsFriendApply { get; set; }
/// <summary>
/// Whether the official-account badge is shown for this member.
/// Client reads this unconditionally from GuildMemberInfo.Parse — always emit it.
/// </summary>
[JsonPropertyName("is_official_mark_displayed"), Key("is_official_mark_displayed"),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public int IsOfficialMarkDisplayed { get; set; }
/// <summary>0 = REGULAR, 1 = LEADER, 2 = SUB_LEADER. Stringified.</summary>
[JsonPropertyName("role"), Key("role"), JsonConverter(typeof(StringifiedIntConverter))]
public int Role { get; set; }
}

40
SVSim.EmulatedEntrypoint/Models/Dtos/Common/Guild/GuildUserBaseDto.cs Normal file
View File

@@ -0,0 +1,40 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
/// <summary>
/// UserInfoBase flat-spread fields as used in guild contexts (GuildMemberInfo.cs, invite lists, etc.).
/// viewer_id / name / emblem_id / country_code / rank / degree_id / is_friend? / is_friend_apply?.
/// Matches types.ts.md#user-profile-types UserInfoBase.
/// </summary>
[MessagePackObject]
public class GuildUserBaseDto
{
[JsonPropertyName("viewer_id"), Key("viewer_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long ViewerId { get; set; }
[JsonPropertyName("name"), Key("name")]
public string Name { get; set; } = "";
[JsonPropertyName("emblem_id"), Key("emblem_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long EmblemId { get; set; }
[JsonPropertyName("country_code"), Key("country_code")]
public string CountryCode { get; set; } = "";
[JsonPropertyName("rank"), Key("rank"), JsonConverter(typeof(StringifiedIntConverter))]
public int Rank { get; set; }
[JsonPropertyName("degree_id"), Key("degree_id"), JsonConverter(typeof(StringifiedIntConverter))]
public int DegreeId { get; set; }
/// <summary>Optional — omit when the caller has no friend relationship with this user.</summary>
[JsonPropertyName("is_friend"), Key("is_friend")]
public int? IsFriend { get; set; }
/// <summary>Optional — omit when the caller has no pending friend apply to this user.</summary>
[JsonPropertyName("is_friend_apply"), Key("is_friend_apply")]
public int? IsFriendApply { get; set; }
}

22
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildCancelInviteRequest.cs Normal file
View File

@@ -0,0 +1,22 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/cancel_invite. Leader/sub-leader retracts an outstanding invite.</summary>
[MessagePackObject]
public class GuildCancelInviteRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>Invite id from /guild/invite_user_list.</summary>
[JsonPropertyName("invite_id"), Key("invite_id")]
public long InviteId { get; set; }
}

22
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildCancelJoinRequestRequest.cs Normal file
View File

@@ -0,0 +1,22 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Request for POST /guild/cancel_join_request.
/// No fields — server identifies the pending request from the calling user's state.
/// Uses explicit DTO (not BaseRequest) so we can add fields if needed in later tasks.
/// </summary>
[MessagePackObject]
public class GuildCancelJoinRequestRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
}

26
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildChangeRoleRequest.cs Normal file
View File

@@ -0,0 +1,26 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/change_role. Change a member's role (promote/demote/transfer leadership).</summary>
[MessagePackObject]
public class GuildChangeRoleRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>ViewerId of the member whose role is changing.</summary>
[JsonPropertyName("target_viewer_id"), Key("target_viewer_id")]
public long TargetViewerId { get; set; }
/// <summary>New role: 0 = REGULAR, 1 = LEADER, 2 = SUB_LEADER.</summary>
[JsonPropertyName("role_id"), Key("role_id")]
public int RoleId { get; set; }
}

16
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildChangeRoleResponse.cs Normal file
View File

@@ -0,0 +1,16 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Response for POST /guild/change_role.
/// Returns the full updated member list so the client can redraw without re-fetching /guild/info.
/// </summary>
[MessagePackObject]
public class GuildChangeRoleResponse
{
[JsonPropertyName("members"), Key("members")]
public List<GuildMemberInfoDto> Members { get; set; } = new();
}

29
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildCreateRequest.cs Normal file
View File

@@ -0,0 +1,29 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/create.</summary>
[MessagePackObject]
public class GuildCreateRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
[JsonPropertyName("guild_name"), Key("guild_name")]
public string GuildName { get; set; } = "";
/// <summary>GuildDetailInfo.ActivityType enum (1..16).</summary>
[JsonPropertyName("activity"), Key("activity")]
public int Activity { get; set; }
/// <summary>GuildDetailInfo.JoinConditionType enum (1 FREE, 2 APPROVAL, 3 ONLY_INVITE).</summary>
[JsonPropertyName("join_condition"), Key("join_condition")]
public int JoinCondition { get; set; }
}

21
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildEmblemListResponse.cs Normal file
View File

@@ -0,0 +1,21 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Response for POST /guild/emblem_list. List of emblem entries the leader can select.</summary>
[MessagePackObject]
public class GuildEmblemListResponse
{
[JsonPropertyName("guild_emblem_list"), Key("guild_emblem_list")]
public List<GuildEmblemEntry> EmblemList { get; set; } = new();
}
/// <summary>One emblem entry. emblem_id is long per spec.</summary>
[MessagePackObject]
public class GuildEmblemEntry
{
[JsonPropertyName("emblem_id"), Key("emblem_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long EmblemId { get; set; }
}

53
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildFriendListResponse.cs Normal file
View File

@@ -0,0 +1,53 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Response for POST /guild/friend_list.
/// NOTE: per guild-friend_list.md, `data` is an array at the root — BUT we return this
/// as a wrapper for now; the controller returns the List directly.
/// TODO(task-14): verify array-root shape via capture; may need a custom response wrapper.
/// </summary>
[MessagePackObject]
public class GuildFriendListResponse
{
// Placeholder — see controller; actual wire shape is array-at-root per spec.
// The controller returns List<GuildInviteCandidateDto> directly for now.
[JsonPropertyName("friends"), Key("friends")]
public List<GuildInviteCandidateDto> Friends { get; set; } = new();
}
/// <summary>InviteCandidate — UserInfoBase + is_join_guild flag.</summary>
[MessagePackObject]
public class GuildInviteCandidateDto
{
[JsonPropertyName("viewer_id"), Key("viewer_id"), JsonConverter(typeof(SVSim.EmulatedEntrypoint.Models.Dtos.Common.StringifiedLongConverter))]
public long ViewerId { get; set; }
[JsonPropertyName("name"), Key("name")]
public string Name { get; set; } = "";
[JsonPropertyName("emblem_id"), Key("emblem_id"), JsonConverter(typeof(SVSim.EmulatedEntrypoint.Models.Dtos.Common.StringifiedLongConverter))]
public long EmblemId { get; set; }
[JsonPropertyName("country_code"), Key("country_code")]
public string CountryCode { get; set; } = "";
[JsonPropertyName("rank"), Key("rank"), JsonConverter(typeof(SVSim.EmulatedEntrypoint.Models.Dtos.Common.StringifiedIntConverter))]
public int Rank { get; set; }
[JsonPropertyName("degree_id"), Key("degree_id"), JsonConverter(typeof(SVSim.EmulatedEntrypoint.Models.Dtos.Common.StringifiedIntConverter))]
public int DegreeId { get; set; }
[JsonPropertyName("is_friend"), Key("is_friend")]
public int? IsFriend { get; set; }
[JsonPropertyName("is_friend_apply"), Key("is_friend_apply")]
public int? IsFriendApply { get; set; }
/// <summary>true => friend is already in a guild and can't be invited.</summary>
[JsonPropertyName("is_join_guild"), Key("is_join_guild")]
public bool IsJoinGuild { get; set; }
}

51
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildInfoResponse.cs Normal file
View File

@@ -0,0 +1,51 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Mirrors GuildInfo.cs:68-86. Always-present: max_member_num, max_sub_leader_num,
/// guild_status, usable_stamp_list. Conditionally present (client `Keys.Contains` -gated):
/// guild (detail + members), join_request_count, invite_count.
/// </summary>
[MessagePackObject]
public class GuildInfoResponse
{
[JsonPropertyName("max_member_num"), Key("max_member_num"), JsonConverter(typeof(StringifiedIntConverter)),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public int MaxMemberNum { get; set; }
[JsonPropertyName("max_sub_leader_num"), Key("max_sub_leader_num"), JsonConverter(typeof(StringifiedIntConverter)),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public int MaxSubLeaderNum { get; set; }
[JsonPropertyName("guild_status"), Key("guild_status"), JsonConverter(typeof(StringifiedIntConverter)),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public int GuildStatus { get; set; }
/// <summary>Stamp ids the viewer can use in chat. Stringified ints (capture: ["100001",...]).</summary>
[JsonPropertyName("usable_stamp_list"), Key("usable_stamp_list"),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public List<string> UsableStampList { get; set; } = new();
[JsonPropertyName("guild"), Key("guild")]
public GuildBundle? Guild { get; set; }
[JsonPropertyName("join_request_count"), Key("join_request_count"), JsonConverter(typeof(StringifiedIntConverter))]
public int? JoinRequestCount { get; set; }
[JsonPropertyName("invite_count"), Key("invite_count"), JsonConverter(typeof(StringifiedIntConverter))]
public int? InviteCount { get; set; }
}
[MessagePackObject]
public class GuildBundle
{
[JsonPropertyName("detail"), Key("detail")]
public GuildDetailDto Detail { get; set; } = new();
[JsonPropertyName("members"), Key("members")]
public List<GuildMemberInfoDto> Members { get; set; } = new();
}

26
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildInviteRequest.cs Normal file
View File

@@ -0,0 +1,26 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/invite. Leader/sub-leader sends invite to a user.</summary>
[MessagePackObject]
public class GuildInviteRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>ViewerId of the user to invite.</summary>
[JsonPropertyName("invited_viewer_id"), Key("invited_viewer_id")]
public long InvitedViewerId { get; set; }
/// <summary>Free-text invite message. Client hardcodes "" — always empty on wire.</summary>
[JsonPropertyName("invite_message"), Key("invite_message")]
public string InviteMessage { get; set; } = "";
}

56
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildInviteUserListResponse.cs Normal file
View File

@@ -0,0 +1,56 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Response for POST /guild/invite_user_list.
/// Lists outstanding invites the guild has sent out (leader/sub-leader view).
/// </summary>
[MessagePackObject]
public class GuildInviteUserListResponse
{
[JsonPropertyName("list"), Key("list")]
public List<GuildOutgoingInviteDto> Users { get; set; } = new();
}
/// <summary>
/// OutgoingInvite — UserInfoBase fields flat-spread + invite_id + invite_time.
/// Matches guild-invite_user_list.md OutgoingInvite interface.
/// </summary>
[MessagePackObject]
public class GuildOutgoingInviteDto
{
[JsonPropertyName("viewer_id"), Key("viewer_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long ViewerId { get; set; }
[JsonPropertyName("name"), Key("name")]
public string Name { get; set; } = "";
[JsonPropertyName("emblem_id"), Key("emblem_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long EmblemId { get; set; }
[JsonPropertyName("country_code"), Key("country_code")]
public string CountryCode { get; set; } = "";
[JsonPropertyName("rank"), Key("rank"), JsonConverter(typeof(StringifiedIntConverter))]
public int Rank { get; set; }
[JsonPropertyName("degree_id"), Key("degree_id"), JsonConverter(typeof(StringifiedIntConverter))]
public int DegreeId { get; set; }
[JsonPropertyName("is_friend"), Key("is_friend")]
public int? IsFriend { get; set; }
[JsonPropertyName("is_friend_apply"), Key("is_friend_apply")]
public int? IsFriendApply { get; set; }
/// <summary>Invite id — pass to /guild/cancel_invite to retract.</summary>
[JsonPropertyName("invite_id"), Key("invite_id")]
public long InviteId { get; set; }
/// <summary>Unix seconds when the invite was sent.</summary>
[JsonPropertyName("invite_time"), Key("invite_time")]
public long InviteTime { get; set; }
}

22
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildInvitedGuildListRequest.cs Normal file
View File

@@ -0,0 +1,22 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/invited_guild_list. Lists pending invites the user has received.</summary>
[MessagePackObject]
public class GuildInvitedGuildListRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>Pagination page index. This list is the only one the client actually scrolls.</summary>
[JsonPropertyName("page"), Key("page")]
public int Page { get; set; }
}

57
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildInvitedGuildListResponse.cs Normal file
View File

@@ -0,0 +1,57 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Response for POST /guild/invited_guild_list.
/// Each entry is GuildDetail fields + invite_id as flat siblings on the wire.
/// Per spec: client constructs GuildDetailInfo + reads invite_id from the SAME object.
/// </summary>
[MessagePackObject]
public class GuildInvitedGuildListResponse
{
[JsonPropertyName("list"), Key("list")]
public List<GuildReceivedInviteDto> List { get; set; } = new();
}
/// <summary>
/// ReceivedInvite — GuildDetail fields flat-spread + invite_id.
/// invite_id and detail fields are siblings, not nested (per guild-invited_guild_list.md).
/// </summary>
[MessagePackObject]
public class GuildReceivedInviteDto
{
[JsonPropertyName("guild_id"), Key("guild_id"), JsonConverter(typeof(StringifiedIntConverter))]
public int GuildId { get; set; }
[JsonPropertyName("guild_name"), Key("guild_name")]
public string GuildName { get; set; } = "";
[JsonPropertyName("description"), Key("description")]
public string Description { get; set; } = "";
[JsonPropertyName("guild_emblem_id"), Key("guild_emblem_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long GuildEmblemId { get; set; }
[JsonPropertyName("join_condition"), Key("join_condition"), JsonConverter(typeof(StringifiedIntConverter))]
public int JoinCondition { get; set; }
[JsonPropertyName("activity"), Key("activity"), JsonConverter(typeof(StringifiedIntConverter))]
public int Activity { get; set; }
[JsonPropertyName("member_num"), Key("member_num"), JsonConverter(typeof(StringifiedIntConverter))]
public int MemberNum { get; set; }
[JsonPropertyName("leader_name"), Key("leader_name")]
public string LeaderName { get; set; } = "";
[JsonPropertyName("leader_viewer_id"), Key("leader_viewer_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long LeaderViewerId { get; set; }
/// <summary>Invite id — pass to /guild/join (from_invite=true) or /guild/reject_invite.</summary>
[JsonPropertyName("invite_id"), Key("invite_id")]
public long InviteId { get; set; }
}

30
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildJoinEndpointRequest.cs Normal file
View File

@@ -0,0 +1,30 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Request for POST /guild/join.
/// NOTE: named GuildJoinEndpointRequest (not GuildJoinRequest) to avoid collision with
/// SVSim.Database.Entities.Guild.GuildJoinRequest which is an EF entity.
/// </summary>
[MessagePackObject]
public class GuildJoinEndpointRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
[JsonPropertyName("guild_id"), Key("guild_id"), JsonConverter(typeof(StringifiedIntConverter))]
public int GuildId { get; set; }
/// <summary>true = consuming an open invite (from /guild/invited_guild_list).</summary>
[JsonPropertyName("from_invite"), Key("from_invite")]
public bool FromInvite { get; set; }
}

25
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildJoinRequestAcceptRequest.cs Normal file
View File

@@ -0,0 +1,25 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Request for POST /guild/join_request_accept.
/// GuildJoinRequestActionParam shape — single field request_viewer_id.
/// </summary>
[MessagePackObject]
public class GuildJoinRequestAcceptRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>ViewerId of the user whose join request is being accepted.</summary>
[JsonPropertyName("request_viewer_id"), Key("request_viewer_id")]
public long RequestViewerId { get; set; }
}

27
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildJoinRequestListRequest.cs Normal file
View File

@@ -0,0 +1,27 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Request for POST /guild/join_request_list.
/// KeysetPagination shape — client always sends page=0, oldest_time=0.
/// </summary>
[MessagePackObject]
public class GuildJoinRequestListRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
[JsonPropertyName("page"), Key("page")]
public int Page { get; set; }
[JsonPropertyName("oldest_time"), Key("oldest_time")]
public long OldestTime { get; set; }
}

52
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildJoinRequestListResponse.cs Normal file
View File

@@ -0,0 +1,52 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Response for POST /guild/join_request_list (leader/sub-leader view).</summary>
[MessagePackObject]
public class GuildJoinRequestListResponse
{
[JsonPropertyName("list"), Key("list")]
public List<GuildJoinRequestEntryDto> Users { get; set; } = new();
}
/// <summary>
/// JoinRequest entry — UserInfoBase fields flat-spread + is_official_mark_displayed + request_time.
/// Matches guild-join_request_list.md JoinRequest interface.
/// </summary>
[MessagePackObject]
public class GuildJoinRequestEntryDto
{
[JsonPropertyName("viewer_id"), Key("viewer_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long ViewerId { get; set; }
[JsonPropertyName("name"), Key("name")]
public string Name { get; set; } = "";
[JsonPropertyName("emblem_id"), Key("emblem_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long EmblemId { get; set; }
[JsonPropertyName("country_code"), Key("country_code")]
public string CountryCode { get; set; } = "";
[JsonPropertyName("rank"), Key("rank"), JsonConverter(typeof(StringifiedIntConverter))]
public int Rank { get; set; }
[JsonPropertyName("degree_id"), Key("degree_id"), JsonConverter(typeof(StringifiedIntConverter))]
public int DegreeId { get; set; }
[JsonPropertyName("is_friend"), Key("is_friend")]
public int? IsFriend { get; set; }
[JsonPropertyName("is_friend_apply"), Key("is_friend_apply")]
public int? IsFriendApply { get; set; }
[JsonPropertyName("is_official_mark_displayed"), Key("is_official_mark_displayed")]
public int IsOfficialMarkDisplayed { get; set; }
/// <summary>Unix seconds when the request was submitted. Don't send millisecond timestamps.</summary>
[JsonPropertyName("request_time"), Key("request_time")]
public long RequestTime { get; set; }
}

18
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildJoinResponse.cs Normal file
View File

@@ -0,0 +1,18 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Response for POST /guild/join.
/// Returns the user's new guild_status; client calls /guild/info next when status is JOINING.
/// </summary>
[MessagePackObject]
public class GuildJoinResponse
{
/// <summary>eGUILD_STATUS the user is now in. Stringified.</summary>
[JsonPropertyName("guild_status"), Key("guild_status"), JsonConverter(typeof(StringifiedIntConverter)),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public int GuildStatus { get; set; }
}

22
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildOthersInfoRequest.cs Normal file
View File

@@ -0,0 +1,22 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/others_info. Browse another guild's public detail.</summary>
[MessagePackObject]
public class GuildOthersInfoRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
[JsonPropertyName("guild_id"), Key("guild_id"), JsonConverter(typeof(StringifiedIntConverter))]
public int GuildId { get; set; }
}

15
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildOthersInfoResponse.cs Normal file
View File

@@ -0,0 +1,15 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Response for POST /guild/others_info. Only the detail sub-tree — no member list (privacy).
/// Reuses GuildDetailSubTree (same shape as /guild/update response).
/// </summary>
[MessagePackObject]
public class GuildOthersInfoResponse
{
[JsonPropertyName("guild"), Key("guild")]
public GuildDetailSubTree Guild { get; set; } = new();
}

22
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildRejectInviteRequest.cs Normal file
View File

@@ -0,0 +1,22 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/reject_invite. User declines an incoming invite.</summary>
[MessagePackObject]
public class GuildRejectInviteRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>Invite id from /guild/invited_guild_list.</summary>
[JsonPropertyName("invite_id"), Key("invite_id")]
public long InviteId { get; set; }
}

25
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildRejectJoinRequestRequest.cs Normal file
View File

@@ -0,0 +1,25 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Request for POST /guild/reject_join_request.
/// GuildJoinRequestActionParam shape — single field request_viewer_id.
/// </summary>
[MessagePackObject]
public class GuildRejectJoinRequestRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>ViewerId of the user whose join request is being rejected.</summary>
[JsonPropertyName("request_viewer_id"), Key("request_viewer_id")]
public long RequestViewerId { get; set; }
}

22
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildRemoveRequest.cs Normal file
View File

@@ -0,0 +1,22 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/remove. Kick a member (leader/sub-leader only).</summary>
[MessagePackObject]
public class GuildRemoveRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>ViewerId of the member to remove. Field is `remove_viewer_id`, not `viewer_id`.</summary>
[JsonPropertyName("remove_viewer_id"), Key("remove_viewer_id")]
public long RemoveViewerId { get; set; }
}

34
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildSearchGuildRequest.cs Normal file
View File

@@ -0,0 +1,34 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/search_guild.</summary>
[MessagePackObject]
public class GuildSearchGuildRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>Name query. Empty string = match-all.</summary>
[JsonPropertyName("guild_name"), Key("guild_name")]
public string GuildName { get; set; } = "";
/// <summary>ActivityType filter (1..16). 0 = any.</summary>
[JsonPropertyName("activity"), Key("activity")]
public int Activity { get; set; }
/// <summary>JoinConditionType filter (1..3). 0 = any.</summary>
[JsonPropertyName("join_condition"), Key("join_condition")]
public int JoinCondition { get; set; }
/// <summary>Member-count bucket filter. 0 = any, 1 = small, 2 = medium, 3 = large.</summary>
[JsonPropertyName("member_condition_range"), Key("member_condition_range")]
public int MemberConditionRange { get; set; }
}

13
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildSearchGuildResponse.cs Normal file
View File

@@ -0,0 +1,13 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Response for POST /guild/search_guild. Flat list of guild details matching the filter.</summary>
[MessagePackObject]
public class GuildSearchGuildResponse
{
[JsonPropertyName("list"), Key("list")]
public List<GuildDetailDto> List { get; set; } = new();
}

21
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildUpdateDescriptionRequest.cs Normal file
View File

@@ -0,0 +1,21 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/update_description. Leader-only.</summary>
[MessagePackObject]
public class GuildUpdateDescriptionRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
[JsonPropertyName("description"), Key("description")]
public string Description { get; set; } = "";
}

23
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildUpdateEmblemRequest.cs Normal file
View File

@@ -0,0 +1,23 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/update_emblem. Leader-only. emblem_id is long.</summary>
[MessagePackObject]
public class GuildUpdateEmblemRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>Emblem id from /guild/emblem_list. long per spec.</summary>
[JsonPropertyName("emblem_id"), Key("emblem_id"), JsonConverter(typeof(StringifiedLongConverter))]
public long EmblemId { get; set; }
}

29
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildUpdateRequest.cs Normal file
View File

@@ -0,0 +1,29 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>Request for POST /guild/update. Leader-only.</summary>
[MessagePackObject]
public class GuildUpdateRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
[JsonPropertyName("guild_name"), Key("guild_name")]
public string GuildName { get; set; } = "";
/// <summary>ActivityType enum (1..16).</summary>
[JsonPropertyName("activity"), Key("activity")]
public int Activity { get; set; }
/// <summary>JoinConditionType enum (1..3).</summary>
[JsonPropertyName("join_condition"), Key("join_condition")]
public int JoinCondition { get; set; }
}

23
SVSim.EmulatedEntrypoint/Models/Dtos/Guild/GuildUpdateResponse.cs Normal file
View File

@@ -0,0 +1,23 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.Guild;
/// <summary>
/// Response for POST /guild/update and POST /guild/update_emblem.
/// Returns the full updated guild detail sub-tree; client merges without re-fetching members.
/// </summary>
[MessagePackObject]
public class GuildUpdateResponse
{
[JsonPropertyName("guild"), Key("guild")]
public GuildDetailSubTree Guild { get; set; } = new();
}
[MessagePackObject]
public class GuildDetailSubTree
{
[JsonPropertyName("detail"), Key("detail")]
public GuildDetailDto Detail { get; set; } = new();
}

26
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatAddDeckRequest.cs Normal file
View File

@@ -0,0 +1,26 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>Request for POST /guild_chat/add_deck. Shares a deck snapshot to guild chat.</summary>
[MessagePackObject]
public class GuildChatAddDeckRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>API-side Format value of the deck being shared.</summary>
[JsonPropertyName("deck_format"), Key("deck_format")]
public int DeckFormat { get; set; }
/// <summary>Slot number of the deck being shared (within the user's regular deck slots).</summary>
[JsonPropertyName("deck_no"), Key("deck_no")]
public int DeckNo { get; set; }
}

22
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatAddReplayRequest.cs Normal file
View File

@@ -0,0 +1,22 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>Request for POST /guild_chat/add_replay. Shares a battle replay to guild chat.</summary>
[MessagePackObject]
public class GuildChatAddReplayRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>Battle id of the replay being shared. long per spec.</summary>
[JsonPropertyName("battle_id"), Key("battle_id")]
public long BattleId { get; set; }
}

18
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatDeckLogRequest.cs Normal file
View File

@@ -0,0 +1,18 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>Request for POST /guild_chat/deck_log. No fields — returns all shared decks by format.</summary>
[MessagePackObject]
public class GuildChatDeckLogRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
}

26
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatDeckLogResponse.cs Normal file
View File

@@ -0,0 +1,26 @@
using MessagePack;
using System.Text.Json;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>
/// Response for POST /guild_chat/deck_log.
/// deck_log keys are stringified API-side Format ints (e.g. "1", "2").
/// TODO(task-17): replace deck_log with typed DTOs when DeckLogData shape is fully specified.
/// Crossover/MyRotation keys must be OMITTED (not empty arrays) when those formats are disabled.
/// </summary>
[MessagePackObject]
public class GuildChatDeckLogResponse
{
[JsonPropertyName("maintenance_card_list"), Key("maintenance_card_list"),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public List<int> MaintenanceCardList { get; set; } = new();
/// <summary>
/// Decks shared in chat, bucketed by API-side Format value (stringified int keys).
/// JsonElement pass-through for now — Task 17 will type the inner DeckLogEntry shape.
/// </summary>
[JsonPropertyName("deck_log"), Key("deck_log")]
public JsonElement? DeckLog { get; set; }
}

26
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatDeleteDeckRequest.cs Normal file
View File

@@ -0,0 +1,26 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>Request for POST /guild_chat/delete_deck. Deletes a previously-shared deck from the chat archive.</summary>
[MessagePackObject]
public class GuildChatDeleteDeckRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>API-side Format of the deck being deleted.</summary>
[JsonPropertyName("deck_format"), Key("deck_format")]
public int DeckFormat { get; set; }
/// <summary>Message id of the chat message that originally shared the deck.</summary>
[JsonPropertyName("message_id"), Key("message_id")]
public long MessageId { get; set; }
}

25
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatDeleteDeckResponse.cs Normal file
View File

@@ -0,0 +1,25 @@
using MessagePack;
using System.Text.Json;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>
/// Response for POST /guild_chat/delete_deck.
/// Returns refreshed deck_log after deletion.
/// TODO(task-17): replace deck_log with typed DeckLogData DTOs when deck-log shape is fully documented.
/// </summary>
[MessagePackObject]
public class GuildChatDeleteDeckResponse
{
[JsonPropertyName("maintenance_card_list"), Key("maintenance_card_list"),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public List<int> MaintenanceCardList { get; set; } = new();
/// <summary>
/// Refreshed deck log keyed by API-side Format int (stringified, e.g. "1", "2").
/// Using JsonElement for now; Task 17 will type this properly.
/// </summary>
[JsonPropertyName("deck_log"), Key("deck_log")]
public JsonElement? DeckLog { get; set; }
}

30
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatMessagesRequest.cs Normal file
View File

@@ -0,0 +1,30 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>Request for POST /guild_chat/messages. Polling endpoint for guild chat.</summary>
[MessagePackObject]
public class GuildChatMessagesRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>Anchor message id. 0 = latest log head.</summary>
[JsonPropertyName("start_message_id"), Key("start_message_id")]
public long StartMessageId { get; set; }
/// <summary>Chat.eRequestDirection: 1=OLD 2=NEW 3=BOTH.</summary>
[JsonPropertyName("direction"), Key("direction")]
public int Direction { get; set; }
/// <summary>Client's current polling interval in seconds.</summary>
[JsonPropertyName("wait_interval"), Key("wait_interval")]
public int WaitInterval { get; set; }
}

31
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatMessagesResponse.cs Normal file
View File

@@ -0,0 +1,31 @@
using MessagePack;
using System.Text.Json.Serialization;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common;
using SVSim.EmulatedEntrypoint.Models.Dtos.Common.Guild;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>Response for POST /guild_chat/messages.</summary>
[MessagePackObject]
public class GuildChatMessagesResponse
{
/// <summary>Card ids currently disabled for maintenance — client refreshes its global list.</summary>
[JsonPropertyName("maintenance_card_list"), Key("maintenance_card_list"),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public List<int> MaintenanceCardList { get; set; } = new();
/// <summary>Users referenced by messages in this batch — deduplicated catalog.</summary>
[JsonPropertyName("users"), Key("users"),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public List<ChatUserDto> Users { get; set; } = new();
/// <summary>Messages ordered oldest-to-newest.</summary>
[JsonPropertyName("chat_message"), Key("chat_message"),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public List<ChatMessageDto> ChatMessage { get; set; } = new();
/// <summary>Server-driven polling interval in seconds. Client uses this for the next poll.</summary>
[JsonPropertyName("wait_interval"), Key("wait_interval"), JsonConverter(typeof(StringifiedIntConverter)),
JsonIgnore(Condition = JsonIgnoreCondition.Never)]
public int WaitInterval { get; set; }
}

26
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatPostRequest.cs Normal file
View File

@@ -0,0 +1,26 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>Request for POST /guild_chat/post. Posts a text message or stamp to guild chat.</summary>
[MessagePackObject]
public class GuildChatPostRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>eMessageType: 0=NORMAL (text body), 1=STAMP (stringified stamp id).</summary>
[JsonPropertyName("type"), Key("type")]
public int Type { get; set; }
/// <summary>Text body for NORMAL; stringified stamp id for STAMP.</summary>
[JsonPropertyName("message"), Key("message")]
public string Message { get; set; } = "";
}

22
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatPostResponse.cs Normal file
View File

@@ -0,0 +1,22 @@
using MessagePack;
using System.Text.Json;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>
/// Response for POST /guild_chat/post.
/// achieved_info and reward_list are optional; only present when posting triggered a mission completion.
/// TODO(task-16): populate achieved_info + reward_list shapes when chat missions are implemented.
/// </summary>
[MessagePackObject]
public class GuildChatPostResponse
{
/// <summary>Optional. Present when posting triggered a mission completion.</summary>
[JsonPropertyName("achieved_info"), Key("achieved_info")]
public JsonElement? AchievedInfo { get; set; }
/// <summary>Optional. Goods deltas from any rewards in achieved_info.</summary>
[JsonPropertyName("reward_list"), Key("reward_list")]
public JsonElement? RewardList { get; set; }
}

22
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatReplayDetailRequest.cs Normal file
View File

@@ -0,0 +1,22 @@
using MessagePack;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>Request for POST /guild_chat/replay_detail. Fetches full replay payload for a shared replay.</summary>
[MessagePackObject]
public class GuildChatReplayDetailRequest
{
[JsonPropertyName("viewer_id"), Key("viewer_id")]
public string ViewerId { get; set; } = "";
[JsonPropertyName("steam_id"), Key("steam_id")]
public ulong SteamId { get; set; }
[JsonPropertyName("steam_session_ticket"), Key("steam_session_ticket")]
public string SteamSessionTicket { get; set; } = "";
/// <summary>Message id of the REPLAY chat message.</summary>
[JsonPropertyName("message_id"), Key("message_id")]
public long MessageId { get; set; }
}

19
SVSim.EmulatedEntrypoint/Models/Dtos/GuildChat/GuildChatReplayDetailResponse.cs Normal file
View File

@@ -0,0 +1,19 @@
using MessagePack;
using System.Text.Json;
using System.Text.Json.Serialization;
namespace SVSim.EmulatedEntrypoint.Models.Dtos.GuildChat;
/// <summary>
/// Response for POST /guild_chat/replay_detail.
/// Shape is opaque pending replay-subsystem documentation.
/// TODO(task-17): enumerate fields from Wizard/ReplayDetailInfo.cs when replay subsystem is documented.
/// </summary>
[MessagePackObject]
public class GuildChatReplayDetailResponse
{
// Placeholder — replay detail shape is undocumented until we capture a live trace.
// Using JsonElement pass-through for now.
[JsonPropertyName("_todo"), Key("_todo")]
public JsonElement? Placeholder { get; set; }
}