feat(chat): moderation api extending

Author: Olek

docs/catalog.json

@@ -45,7 +45,11 @@
         "chat_platform_ban",
         "chat_room",
         "chat_room_ban",
+        "chat_room_configuration",
         "chat_room_member",
+        "chat_room_mute",
+        "chat_room_remove",
+        "chat_room_rule",
         "chat_user_block",
         "chat_user_ignore"
       ],
@@ -59,33 +63,45 @@
         "chat.adminMute",
         "chat.adminUnban",
         "chat.adminUnmute",
-        "chat.banMember",
+        "chat.banRoomMember",
         "chat.blockUser",
         "chat.createPrivateRoom",
         "chat.createRoom",
+        "chat.createRoomRule",
         "chat.deleteMessage",
         "chat.deletePrivateRoom",
         "chat.deleteRoom",
+        "chat.deleteRoomRule",
         "chat.getConnection",
         "chat.getGlobalMessages",
         "chat.getOnlineCount",
         "chat.getRoom",
+        "chat.getRoomConfiguration",
         "chat.getRoomMessages",
+        "chat.getRoomRules",
         "chat.ignoreUser",
+        "chat.joinPublicRoom",
         "chat.joinRoom",
-        "chat.kickMember",
         "chat.leaveRoom",
         "chat.listAdminRooms",
         "chat.listBlockedUsers",
         "chat.listIgnoredUsers",
+        "chat.listRoomBlockedUsers",
         "chat.listRoomMembers",
+        "chat.listRoomUsers",
         "chat.listRooms",
+        "chat.muteRoomMember",
+        "chat.removeMember",
         "chat.sendGlobalMessage",
         "chat.sendRoomMessage",
         "chat.streamMessages",
+        "chat.unbanRoomMember",
         "chat.unblockUser",
         "chat.unignoreUser",
-        "chat.updateRoom"
+        "chat.unmuteRoomMember",
+        "chat.updateRoom",
+        "chat.updateRoomConfiguration",
+        "chat.updateRoomRule"
       ]
     },
     {
@@ -486,6 +502,15 @@
         "packages/core/src/pam/player-management/plugin.ts"
       ]
     },
+    {
+      "category": "chat-moderation",
+      "interface": "ChatModerationEntry",
+      "token": "CHAT_MODERATION",
+      "status": "wired",
+      "boundIn": [
+        "packages/core/src/engagement/chat/plugin.ts"
+      ]
+    },
     {
       "category": "chat-room-access",
       "interface": "ChatRoomAccess",
@@ -748,8 +773,8 @@
     "chat.room.deleted",
     "chat.room.member.banned",
     "chat.room.member.joined",
-    "chat.room.member.kicked",
     "chat.room.member.left",
+    "chat.room.member.removed",
     "chat.room.updated",
     "chat.user.blocked",
     "chat.user.ignored",
@@ -1024,10 +1049,22 @@
       "name": "ChatPlatformBanSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
     },
+    {
+      "name": "ChatRoomAccessStatusSchema",
+      "file": "packages/core/src/engagement/chat/contract/index.ts"
+    },
+    {
+      "name": "ChatRoomBanSchema",
+      "file": "packages/core/src/engagement/chat/contract/index.ts"
+    },
     {
       "name": "ChatRoomCategorySchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
     },
+    {
+      "name": "ChatRoomConfigurationSchema",
+      "file": "packages/core/src/engagement/chat/contract/index.ts"
+    },
     {
       "name": "ChatRoomIdSchema",
       "file": "packages/core/src/contracts/schemas/chat-command.ts"
@@ -1040,6 +1077,10 @@
       "name": "ChatRoomRoleSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
     },
+    {
+      "name": "ChatRoomRuleSchema",
+      "file": "packages/core/src/engagement/chat/contract/index.ts"
+    },
     {
       "name": "ChatRoomSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
@@ -1048,6 +1089,10 @@
       "name": "ChatRoomSlugSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
     },
+    {
+      "name": "ChatRoomUserSchema",
+      "file": "packages/core/src/engagement/chat/contract/index.ts"
+    },
     {
       "name": "ClaimGiftOutputSchema",
       "file": "packages/core/src/engagement/chat-commands/contract/index.ts"

packages/core/src/contracts/adapters/chat-moderation.ts

@@ -0,0 +1,60 @@
+import { createToken } from './token.js';
+
+export type ChatModerationEntry = {
+  id: string;
+  userId: string;
+  roomId: string | null;
+  reason: string;
+  createdAt: string;
+  expiresAt: string | null;
+};
+
+export type ChatPlatformBan = {
+  id: string;
+  userId: string;
+  reason: string;
+  createdAt: string;
+  liftedAt: string | null;
+};
+
+export type ChatModeration = {
+  assertCanSend(userId: string, roomId: string | null, isPublic?: boolean): Promise<void>;
+  deleteMessage(
+    id: string,
+    actorId: string,
+    meta?: { ip: string | null; userAgent: string | null },
+  ): Promise<{ success: true }>;
+  mute(input: {
+    userId: string;
+    roomId: string | null;
+    durationSeconds: number | null;
+    reason: string;
+    actorId: string;
+    ip: string | null;
+    userAgent: string | null;
+  }): Promise<{ success: true }>;
+  unmute(input: {
+    userId: string;
+    roomId: string | null;
+    actorId: string;
+    ip: string | null;
+    userAgent: string | null;
+  }): Promise<{ success: true }>;
+  listMutes(userId?: string): Promise<ChatModerationEntry[]>;
+  ban(input: {
+    userId: string;
+    reason: string;
+    actorId: string;
+    ip: string | null;
+    userAgent: string | null;
+  }): Promise<{ success: true }>;
+  unban(input: {
+    userId: string;
+    actorId: string;
+    ip: string | null;
+    userAgent: string | null;
+  }): Promise<{ success: true }>;
+  listBans(userId?: string): Promise<ChatPlatformBan[]>;
+};
+
+export const CHAT_MODERATION = createToken<ChatModeration>('ChatModeration');

packages/core/src/contracts/adapters/index.ts

@@ -15,6 +15,8 @@ export type {
   TokenValue,
 } from './token.js';
 export { createToken, createSealedToken, createClientPageToken } from './token.js';
+export type { ChatModeration, ChatModerationEntry, ChatPlatformBan } from './chat-moderation.js';
+export { CHAT_MODERATION } from './chat-moderation.js';
 
 export type {
   EventEnvelope,

packages/core/src/contracts/schemas/events.ts

@@ -156,19 +156,19 @@ export const domainEventSchemas = {
     roomId: UuidSchema,
     name: z.string(),
     slug: z.string(),
-    category: z.string(),
+    category: z.string().nullable(),
     actorId: UuidSchema.optional(),
   }),
   'chat.room.deleted': authContextBase.extend({
     roomId: UuidSchema,
     actorId: UuidSchema.optional(),
-    before: z.object({ name: z.string(), slug: z.string(), category: z.string() }),
+    before: z.object({ name: z.string(), slug: z.string(), category: z.string().nullable() }),
   }),
   'chat.room.updated': authContextBase.extend({
     roomId: UuidSchema,
     actorId: UuidSchema.optional(),
-    before: z.object({ name: z.string(), slug: z.string(), category: z.string() }),
-    after: z.object({ name: z.string(), slug: z.string(), category: z.string() }),
+    before: z.object({ name: z.string(), slug: z.string(), category: z.string().nullable() }),
+    after: z.object({ name: z.string(), slug: z.string(), category: z.string().nullable() }),
   }),
 
   // Private room lifecycle: creation and member membership changes.
@@ -187,6 +187,11 @@ export const domainEventSchemas = {
     userId: UuidSchema,
     kickedBy: UuidSchema,
   }),
+  'chat.room.member.removed': authContextBase.extend({
+    roomId: UuidSchema,
+    userId: UuidSchema,
+    removedBy: UuidSchema,
+  }),
   'chat.room.member.banned': authContextBase.extend({
     roomId: UuidSchema,
     userId: UuidSchema,