feat(chat): chat commands implementation

.rulesync/rules/overview.md

@@ -62,6 +62,7 @@ extensions.config.ts # the single registry of enabled plugins
 - **New HTTP route** -> the module's `router/index.ts` via `pnpm gen route <module> <method> <path>`. Player routes resolve the caller from `x-user-id`; admin routes MUST be guarded (next).
 - **Admin-only route** -> `plugin.ts` resolves `AdminGuard` (`c.get(ADMIN_GUARD)`, seeded by `createApp`) and passes it into the router; `await adminGuard.assert(context)` is the handler's FIRST line. The single admin-enforcement point - never re-implement the role check.
 - **New DB table** -> a Drizzle `pgTable` in the module's `schema/index.ts`; run `propose-table-change` (MCP) first, then `pnpm regen`. See `db-conventions`.
+- **Reference / seed data** (roles, command configs, default tags, static lookup rows) -> `<module>/seed/index.ts` exporting a `seed<Module>(db: DrizzleDb): Promise<void>` function. Wire the subpath export (`@openora/core/<domain>/seed/<module>`) in `packages/core/package.json` + `tsconfig.json`, then import and call from `tools/db/seed.ts`. Use `onConflictDoNothing()` — seed is always idempotent. Never inline seed rows in a migration or in `tools/db/seed.ts` directly. Reference: `iam/seed/`, `pam/tag/seed/`, `engagement/chat-commands/seed/`.
 - **Reusable Zod schema** -> `packages/core/src/contracts/schemas/<namespace>.ts`. Module-local schemas in the module's `contract/`.
 - **Enum / status value set** -> a values + schema + type triple on the contract surface (cross-domain: core `contracts/schemas/`; domain-local: the module's `contract/`), pgEnum derived from the tuple. `conventions` section 3 + `db-conventions` > Enums.
 - **Cross-module event** -> declare the payload in `domainEventSchemas` (`packages/core/src/contracts/schemas/events.ts`), emit via `EventBus`, subscribe with `ctx.events.on(...)`. ADR-0010; detail in `messaging-and-microservices`.

docs/catalog.json

@@ -44,34 +44,57 @@
         "chat_room",
         "chat_room_ban",
         "chat_room_member",
-        "chat_user_block"
+        "chat_user_block",
+        "chat_user_ignore"
       ],
       "routes": [
         "chat.banMember",
         "chat.blockUser",
         "chat.createPrivateRoom",
         "chat.createRoom",
         "chat.deleteMessage",
+        "chat.deletePrivateRoom",
         "chat.deleteRoom",
         "chat.getConnection",
         "chat.getGlobalMessages",
         "chat.getOnlineCount",
         "chat.getRoom",
         "chat.getRoomMessages",
+        "chat.ignoreUser",
         "chat.joinRoom",
         "chat.kickMember",
         "chat.leaveRoom",
         "chat.listAdminRooms",
         "chat.listBlockedUsers",
+        "chat.listIgnoredUsers",
         "chat.listRoomMembers",
         "chat.listRooms",
         "chat.sendGlobalMessage",
         "chat.sendRoomMessage",
         "chat.streamMessages",
         "chat.unblockUser",
+        "chat.unignoreUser",
         "chat.updateRoom"
       ]
     },
+    {
+      "id": "chat-commands",
+      "group": "engagement",
+      "tables": [
+        "chat_command_config",
+        "chat_gift"
+      ],
+      "routes": [
+        "chat-commands.adminUpdateCommand",
+        "chat-commands.claimGift",
+        "chat-commands.execute",
+        "chat-commands.getGift",
+        "chat-commands.listCommands",
+        "chat-commands.mentionSearch",
+        "chat-commands.playerProfile",
+        "chat-commands.playerSearch"
+      ]
+    },
     {
       "id": "cms",
       "group": "cms",
@@ -320,7 +343,8 @@
       "status": "wired",
       "boundIn": [
         "packages/core/src/admin-console/plugin.ts",
-        "packages/core/src/casino/gaming/plugin.ts"
+        "packages/core/src/casino/gaming/plugin.ts",
+        "packages/core/src/engagement/chat-commands/plugin.ts"
       ]
     },
     {
@@ -351,6 +375,7 @@
       "boundIn": [
         "packages/core/src/admin-console/plugin.ts",
         "packages/core/src/compliance/plugin.ts",
+        "packages/core/src/engagement/chat-commands/plugin.ts",
         "packages/core/src/engagement/notifications/plugin.ts",
         "packages/core/src/pam/identity/plugin.ts",
         "packages/core/src/pam/tag/plugin.ts",
@@ -383,6 +408,7 @@
         "packages/core/src/admin-console/plugin.ts",
         "packages/core/src/audit/plugin.ts",
         "packages/core/src/compliance/plugin.ts",
+        "packages/core/src/engagement/chat-commands/plugin.ts",
         "packages/core/src/pam/player-management/plugin.ts",
         "packages/core/src/wallet/plugin.ts"
       ]
@@ -411,6 +437,26 @@
         "packages/core/src/pam/identity/plugin.ts"
       ]
     },
+    {
+      "category": "chat-block-writer",
+      "interface": "ChatBlockWriter",
+      "token": "CHAT_BLOCK_WRITER",
+      "status": "wired",
+      "boundIn": [
+        "packages/core/src/engagement/chat-commands/plugin.ts",
+        "packages/core/src/engagement/chat/plugin.ts"
+      ]
+    },
+    {
+      "category": "chat-system-writer",
+      "interface": "ChatSystemWriter",
+      "token": "CHAT_SYSTEM_WRITER",
+      "status": "wired",
+      "boundIn": [
+        "packages/core/src/engagement/chat-commands/plugin.ts",
+        "packages/core/src/engagement/chat/plugin.ts"
+      ]
+    },
     {
       "category": "email",
       "interface": "SendEmailPort",
@@ -566,8 +612,7 @@
       "token": "REALTIME_TRANSPORT",
       "status": "wired",
       "boundIn": [
-        "packages/core/src/compliance/plugin.ts",
-        "packages/core/src/engagement/chat/plugin.ts"
+        "packages/core/src/compliance/plugin.ts"
       ]
     },
     {
@@ -606,6 +651,7 @@
       "status": "wired",
       "boundIn": [
         "packages/core/src/casino/gaming/plugin.ts",
+        "packages/core/src/engagement/chat-commands/plugin.ts",
         "packages/core/src/wallet/plugin.ts"
       ]
     },
@@ -621,8 +667,13 @@
     }
   ],
   "events": [
+    "chat.donate.sent",
+    "chat.gift.claimed",
+    "chat.gift.sent",
     "chat.message.sent",
     "chat.private_room.created",
+    "chat.private_room.deleted",
+    "chat.rain.distributed",
     "chat.room.created",
     "chat.room.deleted",
     "chat.room.member.banned",
@@ -631,7 +682,9 @@
     "chat.room.member.left",
     "chat.room.updated",
     "chat.user.blocked",
+    "chat.user.ignored",
     "chat.user.unblocked",
+    "chat.user.unignored",
     "cms.banner.created",
     "cms.banner.deleted",
     "cms.banner.updated",
@@ -803,6 +856,10 @@
       "name": "BannerSchema",
       "file": "packages/core/src/cms/contract/index.ts"
     },
+    {
+      "name": "BlockCommandMetadataSchema",
+      "file": "packages/core/src/contracts/schemas/chat-command-metadata.ts"
+    },
     {
       "name": "BlockedUserSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
@@ -843,6 +900,14 @@
       "name": "ChangePasswordInputSchema",
       "file": "packages/core/src/contracts/schemas/identity.ts"
     },
+    {
+      "name": "ChatCommandDescriptorSchema",
+      "file": "packages/core/src/engagement/chat-commands/contract/index.ts"
+    },
+    {
+      "name": "ChatCommandTypeSchema",
+      "file": "packages/core/src/engagement/chat-commands/contract/index.ts"
+    },
     {
       "name": "ChatConnectionGrantSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
@@ -851,6 +916,10 @@
       "name": "ChatMessageSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
     },
+    {
+      "name": "ChatMessageTypeSchema",
+      "file": "packages/core/src/contracts/schemas/chat-command.ts"
+    },
     {
       "name": "ChatOnlineCountSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
@@ -875,10 +944,22 @@
       "name": "ChatRoomSlugSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
     },
+    {
+      "name": "ClaimGiftOutputSchema",
+      "file": "packages/core/src/engagement/chat-commands/contract/index.ts"
+    },
     {
       "name": "ClientMetaSchema",
       "file": "packages/core/src/contracts/schemas/common.ts"
     },
+    {
+      "name": "CommandConfigSchema",
+      "file": "packages/core/src/engagement/chat-commands/contract/index.ts"
+    },
+    {
+      "name": "CommandMetadataSchema",
+      "file": "packages/core/src/contracts/schemas/chat-command.ts"
+    },
     {
       "name": "ConversionFunnelSchema",
       "file": "packages/core/src/analytics/contract/funnel.ts"
@@ -927,6 +1008,10 @@
       "name": "Disable2faInputSchema",
       "file": "packages/core/src/contracts/schemas/identity.ts"
     },
+    {
+      "name": "DonateCommandMetadataSchema",
+      "file": "packages/core/src/contracts/schemas/chat-command-metadata.ts"
+    },
     {
       "name": "E164PhoneSchema",
       "file": "packages/core/src/contracts/schemas/identity.ts"
@@ -1039,6 +1124,14 @@
       "name": "GgrSeriesSchema",
       "file": "packages/core/src/analytics/contract/financial.ts"
     },
+    {
+      "name": "GiftCommandMetadataSchema",
+      "file": "packages/core/src/contracts/schemas/chat-command-metadata.ts"
+    },
+    {
+      "name": "GiftStateSchema",
+      "file": "packages/core/src/engagement/chat-commands/contract/index.ts"
+    },
     {
       "name": "GrantInputSchema",
       "file": "packages/core/src/iam/contract/index.ts"
@@ -1083,6 +1176,14 @@
       "name": "IgamingConfigSchema",
       "file": "packages/core/src/contracts/schemas/igaming-config.ts"
     },
+    {
+      "name": "IgnoreCommandMetadataSchema",
+      "file": "packages/core/src/contracts/schemas/chat-command-metadata.ts"
+    },
+    {
+      "name": "IgnoredUserSchema",
+      "file": "packages/core/src/engagement/chat/contract/index.ts"
+    },
     {
       "name": "InvitationStatusSchema",
       "file": "packages/core/src/contracts/schemas/iam.ts"
@@ -1191,6 +1292,10 @@
       "name": "MemberSchema",
       "file": "packages/core/src/contracts/schemas/identity.ts"
     },
+    {
+      "name": "MentionResultSchema",
+      "file": "packages/core/src/engagement/chat-commands/contract/index.ts"
+    },
     {
       "name": "MessageContentSchema",
       "file": "packages/core/src/engagement/chat/contract/index.ts"
@@ -1299,6 +1404,10 @@
       "name": "PlayerNoteSortBySchema",
       "file": "packages/core/src/pam/player-note/contract/index.ts"
     },
+    {
+      "name": "PlayerProfileCardSchema",
+      "file": "packages/core/src/engagement/chat-commands/contract/index.ts"
+    },
     {
       "name": "PlayerRegistrationPointSchema",
       "file": "packages/core/src/pam/player-management/contract/index.ts"
@@ -1311,6 +1420,10 @@
       "name": "PlayerSearchArgsSchema",
       "file": "packages/core/src/contracts/schemas/player.ts"
     },
+    {
+      "name": "PlayerSearchResultSchema",
+      "file": "packages/core/src/engagement/chat-commands/contract/index.ts"
+    },
     {
       "name": "PlayerSearchSchema",
       "file": "packages/core/src/admin-console/contract/index.ts"
@@ -1355,10 +1468,18 @@
       "name": "PositiveMoneyAmountSchema",
       "file": "packages/core/src/casino/gaming/contract/index.ts"
     },
+    {
+      "name": "ProfileCommandMetadataSchema",
+      "file": "packages/core/src/contracts/schemas/chat-command-metadata.ts"
+    },
     {
       "name": "ProviderSelectionSchema",
       "file": "packages/core/src/contracts/schemas/igaming-config.ts"
     },
+    {
+      "name": "RainCommandMetadataSchema",
+      "file": "packages/core/src/contracts/schemas/chat-command-metadata.ts"
+    },
     {
       "name": "RegisterInputSchema",
       "file": "packages/core/src/contracts/schemas/identity.ts"
@@ -1487,6 +1608,10 @@
       "name": "SubmitKycOutputSchema",
       "file": "packages/core/src/compliance/contract/index.ts"
     },
+    {
+      "name": "SystemChatMessageSchema",
+      "file": "packages/core/src/contracts/schemas/chat-command.ts"
+    },
     {
       "name": "TagKeySchema",
       "file": "packages/core/src/contracts/schemas/tag.ts"
@@ -1644,7 +1769,9 @@
   "httpRoutes": [
     "DELETE /backoffice/chat/rooms/{id}",
     "DELETE /chat/blocks/{blockedId}",
+    "DELETE /chat/ignores/{ignoredId}",
     "DELETE /chat/messages/{id}",
+    "DELETE /chat/rooms/{roomId}",
     "DELETE /cms/banners/{id}",
     "DELETE /cms/pages/{id}",
     "DELETE /compliance/limits/{id}",
@@ -1667,9 +1794,15 @@
     "GET /backoffice/transactions/{id}",
     "GET /backoffice/users",
     "GET /backoffice/users/{userId}",
+    "GET /chat-command/commands",
+    "GET /chat-command/gift/{id}",
+    "GET /chat-command/mention-search",
+    "GET /chat-command/player-profile/{userId}",
+    "GET /chat-command/player-search",
     "GET /chat/blocks",
     "GET /chat/connection",
     "GET /chat/global",
+    "GET /chat/ignores",
     "GET /chat/online-count",
     "GET /chat/rooms",
     "GET /chat/rooms/{roomId}",
@@ -1722,13 +1855,17 @@
     "GET /wallet/withdrawals",
     "PATCH /backoffice/chat/rooms/{id}",
     "PATCH /backoffice/users/{userId}",
+    "PATCH /chat-command/admin/commands/{key}",
     "PATCH /iam/roles/{roleId}",
     "PATCH /identity/profile",
     "PATCH /players/{playerId}",
     "PATCH /profile",
     "POST /backoffice/chat/rooms",
+    "POST /chat-command/execute",
+    "POST /chat-command/gift/{id}/claim",
     "POST /chat/blocks",
     "POST /chat/global",
+    "POST /chat/ignores",
     "POST /chat/rooms/join",
     "POST /chat/rooms/private",
     "POST /chat/rooms/{roomId}/ban",

extensions.config.ts

@@ -20,6 +20,7 @@ export const extensions = [
   { id: 'gaming', path: './packages/core/dist/casino/gaming/plugin.js' },
   { id: 'lobby', path: './packages/core/dist/casino/lobby/plugin.js' },
   { id: 'chat', path: './packages/core/dist/engagement/chat/plugin.js' },
+  { id: 'chat-commands', path: './packages/core/dist/engagement/chat-commands/plugin.js' },
   // Player self-profile (owns the `player` table); the admin PAM surface is
   // player-management below, which reads that table via the /schema subpath.
   { id: 'profile', path: './packages/core/dist/pam/profile/plugin.js' },