@openora/core 0.4.1-canary.12 → 0.4.1-canary.121

package/dist/engagement/chat/service/chat.service.d.ts

@@ -1,87 +1,1185 @@
-import { type EventBus, DrizzleService } from '@openora/core/server';
-import type { RealtimeTransport } from '@openora/core/contracts';
+import { type EventBus, DrizzleService, type DrizzleDb, type DrizzleTx } from '@openora/core/server';
+import type { ClientMeta, ChatModeration, RealtimeSignal, RealtimeTransport, CommandMetadata, ChatSystemMessage, CommandChatMessage, AdminUserDirectory, AuditWritePort, IdentityReader, SocialCommands, Uuid, ChatAttachment } from '@openora/core/contracts';
+import { GLOBAL_CHAT_ROOM_ID } from '@openora/core/contracts';
 import type { User } from '@openora/core/pam/schema/identity';
-import type { ChatRoom, ChatMessage } from '../contract/index.js';
-export declare function chatChannel(roomId: ChatRoom['id'] | null): string;
-export declare const ChatRoomNotFoundError: new (id: string) => Error;
-export declare const ChatMessageNotFoundError: new (id: string) => Error;
-export declare const ChatMessageOwnershipError: new (id: string) => Error;
-export declare const ChatMessageBlockedError: new () => Error;
-export declare const ChatSelfBlockError: new () => Error;
+export { ChatRoomNotMemberError, ChatRoomNotModeratorError, ChatRoomSelfModerationError, ChatRoomLastModeratorError, ChatRoomOwnerCannotLeaveError, ChatRoomJoinCodeNotFoundError, ChatRoomBannedError, ChatPlayerBannedError, } from './errors/chat-moderation.errors.js';
+import type { AdminRoomSortBy, BlockedUserSortBy, IgnoredUserSortBy, ChatRoom, ChatMessage, ChatRoomCategory, SortOrder } from '../contract/index.js';
+export declare const ChatRoomOwnershipError: new () => Error & {
+    data?: Record<string, string>;
+};
+export declare const ChatMessageBlockedError: new () => Error & {
+    data?: Record<string, string>;
+};
+export declare const ChatAttachmentRejectedError: new (reason: string) => Error & {
+    data?: Record<string, string>;
+};
+export declare const ChatSelfBlockError: new () => Error & {
+    data?: Record<string, string>;
+};
+export declare const ChatSelfIgnoreError: new () => Error & {
+    data?: Record<string, string>;
+};
+export declare const ChatRoomSlugConflictError: new () => Error & {
+    data?: Record<string, string>;
+};
+export declare const ChatRoomLimitReachedError: new () => Error & {
+    data?: Record<string, string>;
+};
+export declare const ChatRoomProtectedError: new () => Error & {
+    data?: Record<string, string>;
+};
+export declare const ChatRoomRuleNotFoundError: new (id: string) => Error & {
+    data?: Record<string, string>;
+};
+export declare const ChatRoomConfigurationNotFoundError: new (id: string) => Error & {
+    data?: Record<string, string>;
+};
+type ChatServiceDependencies = {
+    drizzle: DrizzleService;
+    events: EventBus;
+    transport: RealtimeTransport;
+    directory: AdminUserDirectory;
+    audit: AuditWritePort;
+    moderation: ChatModeration;
+    identityReader: IdentityReader;
+    allowedAttachmentHosts: readonly string[];
+    socialCommands?: SocialCommands;
+};
 export declare class ChatService {
     private readonly drizzle;
     private readonly events;
     private readonly transport;
-    constructor(drizzle: DrizzleService, events: EventBus, transport: RealtimeTransport);
-    subscribeMessages(roomId: ChatRoom['id'] | null, listener: (message: ChatMessage) => void, viewerId?: User['id']): () => void;
+    private readonly directory;
+    private readonly audit;
+    private readonly moderation;
+    private readonly identityReader;
+    private readonly allowedAttachmentHosts;
+    private readonly socialCommands?;
+    constructor({ drizzle, events, transport, directory, audit, moderation, identityReader, allowedAttachmentHosts, socialCommands, }: ChatServiceDependencies);
+    subscribeMessages(roomId: ChatRoom['id'] | null, listener: (message: ChatMessage) => void, viewerId?: User['id'], connectionId?: string): () => void;
+    subscribeSignals(roomId: ChatRoom['id'] | null, listener: (signal: RealtimeSignal) => void, viewerId?: User['id']): () => void;
+    getOnlineCount(roomId: ChatRoom['id'] | null): Promise<{
+        count: number;
+    }>;
     private blockedIdsFor;
-    private resolveDisplayName;
-    listRooms(): Promise<import("@openora/core/server").SerializedRow<{
+    private ignoredIdsFor;
+    private excludedSenderIdsFor;
+    private usernamesFor;
+    private resolveUsername;
+    /** Throws ChatRoomNotFoundError or ChatRoomNotMemberError; returns the room on success. */
+    verifyRoomAccess(roomId: ChatRoom['id'], viewerId?: User['id']): Promise<{
+        id: string;
+        name: string;
+        slug: string;
+        category: "games-sports" | "regions" | "languages" | "private-channels" | null;
+        isPublic: boolean;
+        joinCode: string | null;
+        creatorId: string | null;
+        createdAt: Date;
+        deletedAt: Date | null;
+    }>;
+    verifyGlobalAccess(viewerId?: User['id']): Promise<void>;
+    listRooms(viewerId?: User['id']): Promise<import("@openora/core/server").SerializedRow<{
+        isBanned: boolean;
+        bannedUntil: null;
+        id: string;
+        createdAt: Date;
+        name: string;
+        slug: string;
+        category: "games-sports" | "regions" | "languages" | "private-channels" | null;
+        creatorId: string | null;
+        isPublic: boolean;
+        joinCode: string | null;
+    }, "createdAt" | "bannedUntil">[]>;
+    listAdminRooms({ page, limit, name, sortBy, sortOrder, }: {
+        page: number;
+        limit: number;
+        name?: string;
+        sortBy: AdminRoomSortBy;
+        sortOrder: SortOrder;
+    }): Promise<{
+        items: import("@openora/core/server").SerializedRow<{
+            isBanned: boolean;
+            bannedUntil: null;
+            id: string;
+            createdAt: Date;
+            name: string;
+            slug: string;
+            category: "games-sports" | "regions" | "languages" | "private-channels" | null;
+            creatorId: string | null;
+            isPublic: boolean;
+            joinCode: string | null;
+        }, "createdAt" | "bannedUntil">[];
+        total: number;
+        page: number;
+        limit: number;
+    }>;
+    listModeratedRooms({ viewerId, page, limit, name, sortBy, sortOrder, }: {
+        viewerId: User['id'];
+        page: number;
+        limit: number;
+        name?: string;
+        sortBy: 'name' | 'createdAt';
+        sortOrder: SortOrder;
+    }): Promise<{
+        items: import("@openora/core/server").SerializedRow<{
+            isBanned: boolean;
+            bannedUntil: null;
+            id: string;
+            createdAt: Date;
+            name: string;
+            slug: string;
+            category: "games-sports" | "regions" | "languages" | "private-channels" | null;
+            creatorId: string | null;
+            isPublic: boolean;
+            joinCode: string | null;
+        }, "createdAt" | "bannedUntil">[];
+        total: number;
+        page: number;
+        limit: number;
+    }>;
+    getRoom({ roomId, viewerId }: {
+        roomId: ChatRoom['id'];
+        viewerId?: User['id'];
+    }): Promise<import("@openora/core/server").SerializedRow<{
+        isBanned: boolean;
+        bannedUntil: null;
         id: string;
         createdAt: Date;
         name: string;
         slug: string;
+        category: "games-sports" | "regions" | "languages" | "private-channels" | null;
+        creatorId: string | null;
         isPublic: boolean;
-    }, "createdAt">[]>;
+        joinCode: string | null;
+    }, "createdAt" | "bannedUntil">>;
+    private assertRoomModerator;
+    listRoomRules(roomReference: ChatRoom['id'] | typeof GLOBAL_CHAT_ROOM_ID, viewerId?: User['id']): Promise<import("@openora/core/server").SerializedRow<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        content: string;
+        roomId: string;
+        createdBy: string;
+        orderNum: number;
+    }, "createdAt" | "updatedAt">[]>;
+    createRoomRule({ roomId, actorId, orderNum, content, }: {
+        roomId: ChatRoom['id'];
+        actorId: User['id'];
+        orderNum?: number;
+        content: string;
+    }): Promise<import("@openora/core/server").SerializedRow<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        content: string;
+        roomId: string;
+        createdBy: string;
+        orderNum: number;
+    }, "createdAt" | "updatedAt">>;
+    updateRoomRule({ roomId, id, actorId, orderNum, content, }: {
+        roomId: ChatRoom['id'];
+        id: string;
+        actorId: User['id'];
+        orderNum?: number;
+        content?: string;
+    }): Promise<import("@openora/core/server").SerializedRow<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        content: string;
+        roomId: string;
+        createdBy: string;
+        orderNum: number;
+    }, "createdAt" | "updatedAt">>;
+    deleteRoomRule({ roomId, id, actorId, }: {
+        roomId: ChatRoom['id'];
+        id: string;
+        actorId: User['id'];
+    }): Promise<{
+        readonly success: true;
+    }>;
+    getRoomConfiguration(roomId: ChatRoom['id'], viewerId?: User['id']): Promise<import("@openora/core/server").SerializedRow<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        roomId: string;
+        slowMode: boolean;
+        slowModeSeconds: number;
+        readOnlyMode: boolean;
+        onlyInvitedCanJoin: boolean;
+        lockRoom: boolean;
+        moderatorInvite: boolean;
+    }, "createdAt" | "updatedAt">>;
+    updateRoomConfiguration({ roomId, actorId, ...patch }: {
+        roomId: ChatRoom['id'];
+        actorId: User['id'];
+        slowMode?: boolean;
+        slowModeSeconds?: number;
+        readOnlyMode?: boolean;
+        onlyInvitedCanJoin?: boolean;
+        lockRoom?: boolean;
+        moderatorInvite?: boolean;
+    }): Promise<import("@openora/core/server").SerializedRow<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        roomId: string;
+        slowMode: boolean;
+        slowModeSeconds: number;
+        readOnlyMode: boolean;
+        onlyInvitedCanJoin: boolean;
+        lockRoom: boolean;
+        moderatorInvite: boolean;
+    }, "createdAt" | "updatedAt">>;
+    listRoomUsers({ roomId, actorId, status, }: {
+        roomId: ChatRoom['id'];
+        actorId: User['id'];
+        status: 'all' | 'member' | 'owner';
+    }): Promise<import("@openora/core/server").SerializedRow<{
+        userId: string;
+        username: string | null;
+        role: "owner" | "member" | "moderator";
+        joinedAt: Date;
+        blocked: boolean;
+        banId: string | null;
+        banExpiresAt: Date | null;
+    }, "joinedAt" | "banExpiresAt">[]>;
+    listRoomBlockedUsers({ roomId, actorId }: {
+        roomId: ChatRoom['id'];
+        actorId: User['id'];
+    }): Promise<import("@openora/core/server").SerializedRow<{
+        id: string;
+        roomId: string;
+        userId: string;
+        bannedBy: string;
+        createdAt: Date;
+        expiresAt: Date | null;
+        liftedAt: Date | null;
+        liftedBy: string | null;
+    }, "createdAt" | "expiresAt" | "liftedAt">[]>;
     getRoomMessages({ roomId, limit, before, viewerId, }: {
         roomId: ChatRoom['id'];
         limit?: number;
         before?: string;
         viewerId?: User['id'];
-    }): Promise<import("@openora/core/server").SerializedRow<{
+    }): Promise<({
         id: string;
+        roomId: string | null;
+        actorId: string;
         userId: string;
-        createdAt: Date;
+        username: string;
+        content: string;
+        type: "system";
+        metadata: {
+            command: "profile";
+            targetUserId: string;
+            displayName: string;
+            level: number;
+        } | {
+            command: "gift";
+            giftId: string;
+            senderId: string;
+            senderUsername: string;
+            amount: string;
+            currency: string;
+            status?: "available" | "claimed" | undefined;
+            claimedBy?: string | null | undefined;
+            claimedByUsername?: string | null | undefined;
+            claimedAt?: string | null | undefined;
+        } | {
+            command: "rain";
+            fromUserId: string;
+            amount: string;
+            currency: string;
+            recipientCount: number;
+            perRecipient: string;
+            fromUsername?: string | undefined;
+            recipients?: {
+                userId: string;
+                username: string;
+            }[] | undefined;
+        } | {
+            command: "block";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unblock";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "ignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "donate";
+            recipientId: string;
+            recipientUsername: string;
+            amount: string;
+            currency: string;
+            senderId?: string | undefined;
+            senderUsername?: string | undefined;
+        };
+        isDeleted: boolean;
+        createdAt: string;
+    } | {
+        id: string;
         roomId: string | null;
+        userId: string;
         username: string;
         content: string;
+        type: "user";
+        metadata: {
+            command: "profile";
+            targetUserId: string;
+            displayName: string;
+            level: number;
+        } | {
+            command: "gift";
+            giftId: string;
+            senderId: string;
+            senderUsername: string;
+            amount: string;
+            currency: string;
+            status?: "available" | "claimed" | undefined;
+            claimedBy?: string | null | undefined;
+            claimedByUsername?: string | null | undefined;
+            claimedAt?: string | null | undefined;
+        } | {
+            command: "rain";
+            fromUserId: string;
+            amount: string;
+            currency: string;
+            recipientCount: number;
+            perRecipient: string;
+            fromUsername?: string | undefined;
+            recipients?: {
+                userId: string;
+                username: string;
+            }[] | undefined;
+        } | {
+            command: "block";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unblock";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "ignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "donate";
+            recipientId: string;
+            recipientUsername: string;
+            amount: string;
+            currency: string;
+            senderId?: string | undefined;
+            senderUsername?: string | undefined;
+        } | null;
+        attachment: {
+            kind: "gif";
+            provider: string;
+            externalId: string;
+            url: string;
+            previewUrl: string;
+            width: number;
+            height: number;
+            title: string;
+        } | null;
         isDeleted: boolean;
-    }, "createdAt">[]>;
-    private appendBlockFilter;
-    sendRoomMessage({ userId, username, roomId, content, }: {
+        createdAt: string;
+    })[]>;
+    listAdminRoomMessages({ roomId, page, limit, senderId, playerId, includeDeleted, }: {
+        roomId: ChatRoom['id'] | typeof GLOBAL_CHAT_ROOM_ID;
+        page: number;
+        limit: number;
+        senderId?: User['id'];
+        playerId?: Uuid;
+        includeDeleted: boolean;
+    }): Promise<{
+        items: ({
+            playerId: string | null;
+            id: string;
+            roomId: string | null;
+            actorId: string;
+            userId: string;
+            username: string;
+            content: string;
+            type: "system";
+            metadata: {
+                command: "profile";
+                targetUserId: string;
+                displayName: string;
+                level: number;
+            } | {
+                command: "gift";
+                giftId: string;
+                senderId: string;
+                senderUsername: string;
+                amount: string;
+                currency: string;
+                status?: "available" | "claimed" | undefined;
+                claimedBy?: string | null | undefined;
+                claimedByUsername?: string | null | undefined;
+                claimedAt?: string | null | undefined;
+            } | {
+                command: "rain";
+                fromUserId: string;
+                amount: string;
+                currency: string;
+                recipientCount: number;
+                perRecipient: string;
+                fromUsername?: string | undefined;
+                recipients?: {
+                    userId: string;
+                    username: string;
+                }[] | undefined;
+            } | {
+                command: "block";
+                targetUserId: string;
+                displayName: string;
+            } | {
+                command: "unblock";
+                targetUserId: string;
+                displayName: string;
+            } | {
+                command: "ignore";
+                targetUserId: string;
+                displayName: string;
+            } | {
+                command: "unignore";
+                targetUserId: string;
+                displayName: string;
+            } | {
+                command: "donate";
+                recipientId: string;
+                recipientUsername: string;
+                amount: string;
+                currency: string;
+                senderId?: string | undefined;
+                senderUsername?: string | undefined;
+            };
+            isDeleted: boolean;
+            createdAt: string;
+        } | {
+            playerId: string | null;
+            id: string;
+            roomId: string | null;
+            userId: string;
+            username: string;
+            content: string;
+            type: "user";
+            metadata: {
+                command: "profile";
+                targetUserId: string;
+                displayName: string;
+                level: number;
+            } | {
+                command: "gift";
+                giftId: string;
+                senderId: string;
+                senderUsername: string;
+                amount: string;
+                currency: string;
+                status?: "available" | "claimed" | undefined;
+                claimedBy?: string | null | undefined;
+                claimedByUsername?: string | null | undefined;
+                claimedAt?: string | null | undefined;
+            } | {
+                command: "rain";
+                fromUserId: string;
+                amount: string;
+                currency: string;
+                recipientCount: number;
+                perRecipient: string;
+                fromUsername?: string | undefined;
+                recipients?: {
+                    userId: string;
+                    username: string;
+                }[] | undefined;
+            } | {
+                command: "block";
+                targetUserId: string;
+                displayName: string;
+            } | {
+                command: "unblock";
+                targetUserId: string;
+                displayName: string;
+            } | {
+                command: "ignore";
+                targetUserId: string;
+                displayName: string;
+            } | {
+                command: "unignore";
+                targetUserId: string;
+                displayName: string;
+            } | {
+                command: "donate";
+                recipientId: string;
+                recipientUsername: string;
+                amount: string;
+                currency: string;
+                senderId?: string | undefined;
+                senderUsername?: string | undefined;
+            } | null;
+            attachment: {
+                kind: "gif";
+                provider: string;
+                externalId: string;
+                url: string;
+                previewUrl: string;
+                width: number;
+                height: number;
+                title: string;
+            } | null;
+            isDeleted: boolean;
+            createdAt: string;
+        })[];
+        total: number;
+        page: number;
+        limit: number;
+    }>;
+    listAdminMessages({ page, limit, roomId, senderId, playerId, search, includeDeleted, sortOrder, }: {
+        page: number;
+        limit: number;
+        roomId?: ChatRoom['id'] | typeof GLOBAL_CHAT_ROOM_ID;
+        senderId?: User['id'];
+        playerId?: Uuid;
+        search?: string;
+        includeDeleted: boolean;
+        sortOrder: SortOrder;
+    }): Promise<{
+        items: {
+            id: string;
+            date: string;
+            roomId: string;
+            playerId: string | null;
+            roomName: string;
+            content: string;
+            attachment: {
+                kind: "gif";
+                provider: string;
+                externalId: string;
+                url: string;
+                previewUrl: string;
+                width: number;
+                height: number;
+                title: string;
+            } | null;
+            time: string;
+        }[];
+        total: number;
+        page: number;
+        limit: number;
+    }>;
+    private appendExcludedSendersFilter;
+    sendRoomMessage({ userId, username, roomId, content, attachment, }: {
         userId: User['id'];
         username: string;
         roomId: ChatRoom['id'];
         content: string;
-    }): Promise<import("@openora/core/server").SerializedRow<{
+        attachment?: ChatAttachment | null;
+    }): Promise<{
         id: string;
+        roomId: string | null;
+        actorId: string;
         userId: string;
-        createdAt: Date;
+        username: string;
+        content: string;
+        type: "system";
+        metadata: {
+            command: "profile";
+            targetUserId: string;
+            displayName: string;
+            level: number;
+        } | {
+            command: "gift";
+            giftId: string;
+            senderId: string;
+            senderUsername: string;
+            amount: string;
+            currency: string;
+            status?: "available" | "claimed" | undefined;
+            claimedBy?: string | null | undefined;
+            claimedByUsername?: string | null | undefined;
+            claimedAt?: string | null | undefined;
+        } | {
+            command: "rain";
+            fromUserId: string;
+            amount: string;
+            currency: string;
+            recipientCount: number;
+            perRecipient: string;
+            fromUsername?: string | undefined;
+            recipients?: {
+                userId: string;
+                username: string;
+            }[] | undefined;
+        } | {
+            command: "block";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unblock";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "ignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "donate";
+            recipientId: string;
+            recipientUsername: string;
+            amount: string;
+            currency: string;
+            senderId?: string | undefined;
+            senderUsername?: string | undefined;
+        };
+        isDeleted: boolean;
+        createdAt: string;
+    } | {
+        id: string;
         roomId: string | null;
+        userId: string;
         username: string;
         content: string;
+        type: "user";
+        metadata: {
+            command: "profile";
+            targetUserId: string;
+            displayName: string;
+            level: number;
+        } | {
+            command: "gift";
+            giftId: string;
+            senderId: string;
+            senderUsername: string;
+            amount: string;
+            currency: string;
+            status?: "available" | "claimed" | undefined;
+            claimedBy?: string | null | undefined;
+            claimedByUsername?: string | null | undefined;
+            claimedAt?: string | null | undefined;
+        } | {
+            command: "rain";
+            fromUserId: string;
+            amount: string;
+            currency: string;
+            recipientCount: number;
+            perRecipient: string;
+            fromUsername?: string | undefined;
+            recipients?: {
+                userId: string;
+                username: string;
+            }[] | undefined;
+        } | {
+            command: "block";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unblock";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "ignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "donate";
+            recipientId: string;
+            recipientUsername: string;
+            amount: string;
+            currency: string;
+            senderId?: string | undefined;
+            senderUsername?: string | undefined;
+        } | null;
+        attachment: {
+            kind: "gif";
+            provider: string;
+            externalId: string;
+            url: string;
+            previewUrl: string;
+            width: number;
+            height: number;
+            title: string;
+        } | null;
         isDeleted: boolean;
-    }, "createdAt">>;
-    deleteMessage(id: ChatMessage['id'], userId: User['id']): Promise<{
-        readonly success: true;
+        createdAt: string;
+    }>;
+    deleteMessage(id: ChatMessage['id'], userId: User['id'], meta?: ClientMeta): Promise<{
+        success: true;
     }>;
-    getGlobalMessages(limit?: number, viewerId?: User['id']): Promise<import("@openora/core/server").SerializedRow<{
+    getGlobalMessages(limit?: number, viewerId?: User['id']): Promise<({
         id: string;
+        roomId: string | null;
+        actorId: string;
         userId: string;
-        createdAt: Date;
+        username: string;
+        content: string;
+        type: "system";
+        metadata: {
+            command: "profile";
+            targetUserId: string;
+            displayName: string;
+            level: number;
+        } | {
+            command: "gift";
+            giftId: string;
+            senderId: string;
+            senderUsername: string;
+            amount: string;
+            currency: string;
+            status?: "available" | "claimed" | undefined;
+            claimedBy?: string | null | undefined;
+            claimedByUsername?: string | null | undefined;
+            claimedAt?: string | null | undefined;
+        } | {
+            command: "rain";
+            fromUserId: string;
+            amount: string;
+            currency: string;
+            recipientCount: number;
+            perRecipient: string;
+            fromUsername?: string | undefined;
+            recipients?: {
+                userId: string;
+                username: string;
+            }[] | undefined;
+        } | {
+            command: "block";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unblock";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "ignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "donate";
+            recipientId: string;
+            recipientUsername: string;
+            amount: string;
+            currency: string;
+            senderId?: string | undefined;
+            senderUsername?: string | undefined;
+        };
+        isDeleted: boolean;
+        createdAt: string;
+    } | {
+        id: string;
         roomId: string | null;
+        userId: string;
         username: string;
         content: string;
+        type: "user";
+        metadata: {
+            command: "profile";
+            targetUserId: string;
+            displayName: string;
+            level: number;
+        } | {
+            command: "gift";
+            giftId: string;
+            senderId: string;
+            senderUsername: string;
+            amount: string;
+            currency: string;
+            status?: "available" | "claimed" | undefined;
+            claimedBy?: string | null | undefined;
+            claimedByUsername?: string | null | undefined;
+            claimedAt?: string | null | undefined;
+        } | {
+            command: "rain";
+            fromUserId: string;
+            amount: string;
+            currency: string;
+            recipientCount: number;
+            perRecipient: string;
+            fromUsername?: string | undefined;
+            recipients?: {
+                userId: string;
+                username: string;
+            }[] | undefined;
+        } | {
+            command: "block";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unblock";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "ignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "donate";
+            recipientId: string;
+            recipientUsername: string;
+            amount: string;
+            currency: string;
+            senderId?: string | undefined;
+            senderUsername?: string | undefined;
+        } | null;
+        attachment: {
+            kind: "gif";
+            provider: string;
+            externalId: string;
+            url: string;
+            previewUrl: string;
+            width: number;
+            height: number;
+            title: string;
+        } | null;
         isDeleted: boolean;
-    }, "createdAt">[]>;
-    sendGlobalMessage(userId: User['id'], username: string, content: string): Promise<import("@openora/core/server").SerializedRow<{
+        createdAt: string;
+    })[]>;
+    sendGlobalMessage({ userId, username, content, attachment, }: {
+        userId: User['id'];
+        username: string;
+        content: string;
+        attachment?: ChatAttachment | null;
+    }): Promise<{
         id: string;
+        roomId: string | null;
+        actorId: string;
         userId: string;
-        createdAt: Date;
+        username: string;
+        content: string;
+        type: "system";
+        metadata: {
+            command: "profile";
+            targetUserId: string;
+            displayName: string;
+            level: number;
+        } | {
+            command: "gift";
+            giftId: string;
+            senderId: string;
+            senderUsername: string;
+            amount: string;
+            currency: string;
+            status?: "available" | "claimed" | undefined;
+            claimedBy?: string | null | undefined;
+            claimedByUsername?: string | null | undefined;
+            claimedAt?: string | null | undefined;
+        } | {
+            command: "rain";
+            fromUserId: string;
+            amount: string;
+            currency: string;
+            recipientCount: number;
+            perRecipient: string;
+            fromUsername?: string | undefined;
+            recipients?: {
+                userId: string;
+                username: string;
+            }[] | undefined;
+        } | {
+            command: "block";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unblock";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "ignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "donate";
+            recipientId: string;
+            recipientUsername: string;
+            amount: string;
+            currency: string;
+            senderId?: string | undefined;
+            senderUsername?: string | undefined;
+        };
+        isDeleted: boolean;
+        createdAt: string;
+    } | {
+        id: string;
         roomId: string | null;
+        userId: string;
         username: string;
         content: string;
+        type: "user";
+        metadata: {
+            command: "profile";
+            targetUserId: string;
+            displayName: string;
+            level: number;
+        } | {
+            command: "gift";
+            giftId: string;
+            senderId: string;
+            senderUsername: string;
+            amount: string;
+            currency: string;
+            status?: "available" | "claimed" | undefined;
+            claimedBy?: string | null | undefined;
+            claimedByUsername?: string | null | undefined;
+            claimedAt?: string | null | undefined;
+        } | {
+            command: "rain";
+            fromUserId: string;
+            amount: string;
+            currency: string;
+            recipientCount: number;
+            perRecipient: string;
+            fromUsername?: string | undefined;
+            recipients?: {
+                userId: string;
+                username: string;
+            }[] | undefined;
+        } | {
+            command: "block";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unblock";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "ignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "unignore";
+            targetUserId: string;
+            displayName: string;
+        } | {
+            command: "donate";
+            recipientId: string;
+            recipientUsername: string;
+            amount: string;
+            currency: string;
+            senderId?: string | undefined;
+            senderUsername?: string | undefined;
+        } | null;
+        attachment: {
+            kind: "gif";
+            provider: string;
+            externalId: string;
+            url: string;
+            previewUrl: string;
+            width: number;
+            height: number;
+            title: string;
+        } | null;
         isDeleted: boolean;
-    }, "createdAt">>;
-    listBlockedUsers(blockerId: User['id']): Promise<import("@openora/core/server").SerializedRow<{
-        blockedId: string;
+        createdAt: string;
+    }>;
+    listBlockedUsers({ blockerId, page, limit, sortBy, sortOrder, }: {
+        blockerId: User['id'];
+        page: number;
+        limit: number;
+        sortBy: BlockedUserSortBy;
+        sortOrder: SortOrder;
+    }): Promise<{
+        items: import("@openora/core/server").SerializedRow<{
+            username: string | null;
+            blockedId: string;
+            createdAt: Date;
+        }, "createdAt">[];
+        total: number;
+        page: number;
+        limit: number;
+    }>;
+    /** Backoffice-only, site-wide: every active block relationship, not just the caller's. */
+    adminListBlockedUsers({ page, limit, sortBy, sortOrder, }: {
+        page: number;
+        limit: number;
+        sortBy: BlockedUserSortBy;
+        sortOrder: SortOrder;
+    }): Promise<{
+        items: import("@openora/core/server").SerializedRow<{
+            blockerId: string;
+            blockedId: string;
+            createdAt: Date;
+        }, "createdAt">[];
+        total: number;
+        page: number;
+        limit: number;
+    }>;
+    blockUser(blockerId: User['id'], blockedId: User['id'], meta?: ClientMeta): Promise<{
+        readonly success: true;
+    }>;
+    unblockUser(blockerId: User['id'], blockedId: User['id'], meta?: ClientMeta): Promise<{
+        readonly success: true;
+    }>;
+    listIgnoredUsers({ ignorerId, page, limit, sortBy, sortOrder, }: {
+        ignorerId: User['id'];
+        page: number;
+        limit: number;
+        sortBy: IgnoredUserSortBy;
+        sortOrder: SortOrder;
+    }): Promise<{
+        items: import("@openora/core/server").SerializedRow<{
+            username: string | null;
+            ignoredId: string;
+            createdAt: Date;
+        }, "createdAt">[];
+        total: number;
+        page: number;
+        limit: number;
+    }>;
+    /** Backoffice-only, site-wide: every active ignore relationship, not just the caller's. */
+    adminListIgnoredUsers({ page, limit, sortBy, sortOrder, }: {
+        page: number;
+        limit: number;
+        sortBy: IgnoredUserSortBy;
+        sortOrder: SortOrder;
+    }): Promise<{
+        items: import("@openora/core/server").SerializedRow<{
+            ignorerId: string;
+            ignoredId: string;
+            createdAt: Date;
+        }, "createdAt">[];
+        total: number;
+        page: number;
+        limit: number;
+    }>;
+    ignoreUser(ignorerId: User['id'], ignoredId: User['id'], meta?: ClientMeta): Promise<{
+        readonly success: true;
+    }>;
+    unignoreUser(ignorerId: User['id'], ignoredId: User['id'], meta?: ClientMeta): Promise<{
+        readonly success: true;
+    }>;
+    getExcludedUserIds(viewerId: User['id']): Promise<User['id'][]>;
+    getBlockedUserIds(viewerId: User['id']): Promise<string[]>;
+    isBlocked(tx: DrizzleDb | DrizzleTx, blockerId: User['id'], blockedId: User['id']): Promise<boolean>;
+    createRoom({ name, slug, category, actorId, ip, userAgent, }: {
+        name: string;
+        slug: string;
+        category: ChatRoomCategory;
+        actorId?: User['id'];
+    } & ClientMeta): Promise<import("@openora/core/server").SerializedRow<{
+        isBanned: boolean;
+        bannedUntil: null;
+        id: string;
+        createdAt: Date;
+        name: string;
+        slug: string;
+        category: "games-sports" | "regions" | "languages" | "private-channels" | null;
+        creatorId: string | null;
+        isPublic: boolean;
+        joinCode: string | null;
+    }, "createdAt" | "bannedUntil">>;
+    updateRoom({ id, name, slug, category, actorId, ip, userAgent, }: {
+        id: ChatRoom['id'];
+        name?: string;
+        slug?: string;
+        category?: ChatRoomCategory;
+        actorId?: User['id'];
+    } & ClientMeta): Promise<import("@openora/core/server").SerializedRow<{
+        isBanned: boolean;
+        bannedUntil: null;
+        id: string;
+        createdAt: Date;
+        name: string;
+        slug: string;
+        category: "games-sports" | "regions" | "languages" | "private-channels" | null;
+        creatorId: string | null;
+        isPublic: boolean;
+        joinCode: string | null;
+    }, "createdAt" | "bannedUntil">>;
+    updatePrivateRoom({ id, name, actorId, ip, userAgent, }: {
+        id: ChatRoom['id'];
+        name: string;
+        actorId: User['id'];
+    } & ClientMeta): Promise<import("@openora/core/server").SerializedRow<{
+        isBanned: boolean;
+        bannedUntil: null;
+        id: string;
         createdAt: Date;
-    }, "createdAt">[]>;
-    blockUser(blockerId: User['id'], blockedId: User['id']): Promise<{
+        name: string;
+        slug: string;
+        category: "games-sports" | "regions" | "languages" | "private-channels" | null;
+        creatorId: string | null;
+        isPublic: boolean;
+        joinCode: string | null;
+    }, "createdAt" | "bannedUntil">>;
+    deletePrivateRoom({ roomId, userId, ip, userAgent, }: {
+        roomId: ChatRoom['id'];
+        userId: User['id'];
+    } & ClientMeta): Promise<{
         readonly success: true;
     }>;
-    unblockUser(blockerId: User['id'], blockedId: User['id']): Promise<{
+    deleteRoom(id: ChatRoom['id'], actorId?: User['id'], meta?: ClientMeta): Promise<{
         readonly success: true;
     }>;
+    createPrivateRoom({ userId, name, ip, userAgent, }: {
+        userId: User['id'];
+        name: string;
+    } & ClientMeta): Promise<import("@openora/core/server").SerializedRow<{
+        isBanned: boolean;
+        bannedUntil: null;
+        id: string;
+        createdAt: Date;
+        name: string;
+        slug: string;
+        category: "games-sports" | "regions" | "languages" | "private-channels" | null;
+        creatorId: string | null;
+        isPublic: boolean;
+        joinCode: string | null;
+    }, "createdAt" | "bannedUntil">>;
+    postSystemMessage(args: {
+        roomId: ChatRoom['id'] | null;
+        actorId: User['id'];
+        username: User['name'];
+        metadata: CommandMetadata;
+        tx?: unknown;
+    }): Promise<ChatSystemMessage>;
+    updateSystemMessage(args: {
+        messageId: ChatMessage['id'];
+        metadata: CommandMetadata;
+        tx?: unknown;
+    }): Promise<CommandChatMessage>;
+    listRoomMembers({ roomId, viewerId }: {
+        roomId: ChatRoom['id'];
+        viewerId?: User['id'];
+    }): Promise<import("@openora/core/server").SerializedRow<{
+        username: string | null;
+        userId: string;
+        role: "owner" | "member" | "moderator";
+        joinedAt: Date;
+    }, "joinedAt">[]>;
+    private canSeeAdminUsers;
 }
 //# sourceMappingURL=chat.service.d.ts.map