@openora/core 0.4.0 → 0.4.1-canary.100

package/dist/engagement/chat-commands/service/chat-commands.service.js

@@ -0,0 +1,258 @@
+import { eq, asc, desc, count } from 'drizzle-orm';
+import { makeNotFoundError, makeConflictError, createDomainError, findOneOrThrow, pageToOffset, } from '@openora/core/server';
+import { chatChannel } from '@openora/core/contracts';
+import { ChatCommandTypeSchema } from '../contract/index.js';
+import { chatCommandConfig } from '../schema/index.js';
+export const CommandDisabledError = makeNotFoundError('ChatCommand');
+export const ChatPlayerNotFoundError = makeNotFoundError('ChatPlayer');
+export const InsufficientBalanceError = makeConflictError('InsufficientBalance', 'Not enough balance');
+export const ExceedsLimitError = makeConflictError('ExceedsLimit', 'Amount exceeds the command limit');
+export const BelowMinimumError = makeConflictError('BelowMinimum', 'Amount is below the minimum for this command');
+export const NoOnlineUsersError = makeConflictError('NoOnlineUsers', 'No other users are online in this room');
+export const TooManyRecipientsError = makeConflictError('TooManyRecipients', 'Amount too small: you need at least $1 per recipient');
+export const RainCreditError = makeConflictError('RainCreditError', 'A recipient wallet is unavailable; rain aborted');
+export const GiftNotFoundError = makeNotFoundError('ChatGift');
+export const GiftAlreadyClaimedError = makeConflictError('GiftAlreadyClaimed', 'This gift has already been claimed');
+export const GiftSelfClaimError = makeConflictError('GiftSelfClaim', 'You cannot claim your own gift');
+export const BlockedRecipientError = makeConflictError('BlockedRecipient', 'You cannot receive money from a user you blocked');
+export const GiftCreditError = makeConflictError('GiftCreditError', 'Recipient wallet is unavailable; gift claim aborted');
+export const ChatCommandIdempotencyKeyReuseError = makeConflictError('ChatCommandIdempotencyKeyReuse', 'This idempotency key was already used with different request parameters');
+export const ConcurrentCommandReplayError = makeConflictError('ConcurrentCommandReplay', 'This request is already being processed - please retry');
+export const ChatRoomNotMemberError = createDomainError('ChatRoomNotMemberError', (roomId) => roomId ? `You are not a member of room: ${roomId}` : 'You are not a member of global chat');
+function toDescriptor(row) {
+    return {
+        key: ChatCommandTypeSchema.parse(row.key),
+        enabled: row.enabled,
+        label: row.label,
+        description: row.description ?? null,
+        config: row.config ?? null,
+        updatedAt: row.updatedAt.toISOString(),
+    };
+}
+const ADMIN_COMMAND_SORT_COLUMNS = {
+    key: chatCommandConfig.key,
+    updatedAt: chatCommandConfig.updatedAt,
+};
+export class ChatCommandsService {
+    drizzle;
+    directory;
+    blockWriter;
+    giftCommands;
+    rainCommands;
+    transport;
+    audit;
+    constructor(drizzle, directory, blockWriter, giftCommands, rainCommands, transport, audit) {
+        this.drizzle = drizzle;
+        this.directory = directory;
+        this.blockWriter = blockWriter;
+        this.giftCommands = giftCommands;
+        this.rainCommands = rainCommands;
+        this.transport = transport;
+        this.audit = audit;
+    }
+    async listCommands(includeDisabled = false) {
+        const rows = await this.drizzle.db
+            .select()
+            .from(chatCommandConfig)
+            .where(includeDisabled ? undefined : eq(chatCommandConfig.enabled, true));
+        return rows.map(toDescriptor);
+    }
+    async adminListCommands({ page, limit, sortBy, sortOrder, }) {
+        const dir = sortOrder === 'asc' ? asc : desc;
+        const col = ADMIN_COMMAND_SORT_COLUMNS[sortBy];
+        const [rows, [{ n }]] = await Promise.all([
+            this.drizzle.db
+                .select()
+                .from(chatCommandConfig)
+                .orderBy(dir(col))
+                .limit(limit)
+                .offset(pageToOffset(page, limit)),
+            this.drizzle.db.select({ n: count() }).from(chatCommandConfig),
+        ]);
+        return { items: rows.map(toDescriptor), total: Number(n), page, limit };
+    }
+    async adminUpdateCommand(input, actorId) {
+        const rows = await this.drizzle.db
+            .insert(chatCommandConfig)
+            .values({
+            key: input.key,
+            enabled: input.enabled,
+            label: input.key.charAt(0).toUpperCase() + input.key.slice(1),
+            config: input.config ?? null,
+            updatedAt: new Date(),
+        })
+            .onConflictDoUpdate({
+            target: chatCommandConfig.key,
+            set: {
+                enabled: input.enabled,
+                ...(input.config !== undefined ? { config: input.config } : {}),
+                updatedAt: new Date(),
+            },
+        })
+            .returning();
+        const row = findOneOrThrow(rows, new CommandDisabledError(input.key));
+        await this.audit.record({
+            actorId,
+            actorType: 'admin',
+            action: 'chat.command.updated',
+            resourceType: 'chat_command',
+            resourceId: input.key,
+            before: null,
+            after: { enabled: input.enabled, config: input.config ?? null },
+        });
+        return toDescriptor(row);
+    }
+    async searchMentions({ q, limit, roomId, viewerId, }) {
+        const onlineUserIds = await this.transport.getOnlineUserIds(chatChannel(roomId));
+        if (onlineUserIds.length === 0) {
+            return [];
+        }
+        const onlineIds = new Set(onlineUserIds);
+        const query = q.trim();
+        const canSeeAdminUsers = await this.canSeeAdminUsers(viewerId);
+        let ids = query.length === 0
+            ? onlineUserIds
+            : await this.directory.findPlayerIds(query, Math.max(limit, onlineUserIds.length));
+        if (canSeeAdminUsers && query.length > 0) {
+            const onlineAccounts = await this.directory.lookupUsers(onlineUserIds);
+            const queryLower = query.toLowerCase();
+            const matchingAdminIds = onlineAccounts
+                .filter((account) => (account.role === 'admin' || account.role === 'super-admin') &&
+                [account.name, account.email].some((value) => value?.toLowerCase().includes(queryLower)))
+                .map((account) => account.id);
+            ids = [...new Set([...ids, ...matchingAdminIds])];
+        }
+        if (ids.length === 0) {
+            return [];
+        }
+        const excluded = new Set(await this.blockWriter.getExcludedUserIds(viewerId));
+        const filteredIds = ids
+            .filter((id) => id !== viewerId && onlineIds.has(id) && !excluded.has(id))
+            .slice(0, limit);
+        if (filteredIds.length === 0) {
+            return [];
+        }
+        const summaries = await this.directory.lookupPlayers(filteredIds);
+        if (!canSeeAdminUsers) {
+            return summaries.map((s) => ({ userId: s.userId, username: s.username }));
+        }
+        const summaryById = new Map(summaries.map((summary) => [summary.userId, summary.username]));
+        const accounts = canSeeAdminUsers ? await this.directory.lookupUsers(filteredIds) : [];
+        const accountsById = new Map(accounts.map((account) => [account.id, account]));
+        const visible = filteredIds.map((userId) => {
+            const username = summaryById.get(userId);
+            if (username) {
+                return { userId, username };
+            }
+            const account = accountsById.get(userId);
+            return account ? { userId, username: account.name ?? account.email } : null;
+        });
+        return visible.filter((user) => user !== null);
+    }
+    async canSeeAdminUsers(viewerId) {
+        if (typeof this.directory.get !== 'function') {
+            return false;
+        }
+        const viewer = await this.directory.get(viewerId);
+        return viewer?.role === 'admin' || viewer?.role === 'super-admin';
+    }
+    async postGift(input, actorId) {
+        const result = await this.giftCommands.sendGift(input, actorId);
+        if (result.ok) {
+            return result.message;
+        }
+        switch (result.reason) {
+            case 'disabled':
+                throw new CommandDisabledError('gift');
+            case 'player_not_found':
+                throw new ChatPlayerNotFoundError(result.playerId);
+            case 'insufficient_balance':
+                throw new InsufficientBalanceError();
+            case 'exceeds_limit':
+                throw new ExceedsLimitError();
+            case 'below_minimum':
+                throw new BelowMinimumError();
+            case 'idempotency_key_reuse':
+                throw new ChatCommandIdempotencyKeyReuseError();
+            case 'concurrent_replay':
+                throw new ConcurrentCommandReplayError();
+            case 'room_not_member':
+                throw new ChatRoomNotMemberError(input.roomId);
+        }
+    }
+    async claimGift(giftId, claimerId) {
+        const result = await this.giftCommands.claimGift(giftId, claimerId);
+        if (result.ok) {
+            return {
+                claimedBy: result.claimedBy,
+                claimedByUsername: result.claimedByUsername,
+                claimedAt: result.claimedAt,
+            };
+        }
+        switch (result.reason) {
+            case 'gift_not_found':
+                throw new GiftNotFoundError(giftId);
+            case 'already_claimed':
+                throw new GiftAlreadyClaimedError();
+            case 'self_claim':
+                throw new GiftSelfClaimError();
+            case 'blocked_recipient':
+                throw new BlockedRecipientError();
+            case 'room_not_member':
+                throw new ChatRoomNotMemberError(result.roomId ?? null);
+            case 'gift_credit_failed':
+                throw new GiftCreditError();
+        }
+    }
+    async getGift(giftId, viewerId) {
+        const result = await this.giftCommands.getGift(giftId, viewerId);
+        if (result.ok) {
+            return result.gift;
+        }
+        switch (result.reason) {
+            case 'gift_not_found':
+                throw new GiftNotFoundError(giftId);
+            case 'room_not_member':
+                throw new ChatRoomNotMemberError(result.roomId ?? null);
+        }
+    }
+    // Zero rain business logic here - the RAIN_COMMANDS port (bound by
+    // social-transfers) owns money movement, limit checks, idempotency, and
+    // posting/publishing the resulting chat message. This module only resolves
+    // who is online (it owns presence for the whole chat-command surface via
+    // its own dependency on `chat`) and translates the port's discriminated
+    // result into the typed errors this module's router maps to transport codes.
+    async postRain(input, actorId) {
+        const onlineUserIds = await this.transport.getOnlineUserIds(chatChannel(input.roomId));
+        const visiblePlayers = await this.directory.lookupPlayers(onlineUserIds);
+        const result = await this.rainCommands.sendRain({ ...input, onlineUserIds: visiblePlayers.map((player) => player.userId) }, actorId);
+        if (result.ok) {
+            return result.message;
+        }
+        switch (result.reason) {
+            case 'disabled':
+                throw new CommandDisabledError('rain');
+            case 'player_not_found':
+                throw new ChatPlayerNotFoundError(result.playerId);
+            case 'insufficient_balance':
+                throw new InsufficientBalanceError();
+            case 'exceeds_limit':
+                throw new ExceedsLimitError();
+            case 'below_minimum':
+                throw new BelowMinimumError();
+            case 'no_online_users':
+                throw new NoOnlineUsersError();
+            case 'too_many_recipients':
+                throw new TooManyRecipientsError();
+            case 'rain_credit_failed':
+                throw new RainCreditError();
+            case 'idempotency_key_reuse':
+                throw new ChatCommandIdempotencyKeyReuseError();
+            case 'concurrent_replay':
+                throw new ConcurrentCommandReplayError();
+            case 'room_not_member':
+                throw new ChatRoomNotMemberError(input.roomId);
+        }
+    }
+}
+//# sourceMappingURL=chat-commands.service.js.map

package/dist/engagement/chat-commands/service/chat-commands.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-commands.service.js","sourceRoot":"","sources":["../../../../src/engagement/chat-commands/service/chat-commands.service.ts"],"names":[],"mappings":"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"}

package/dist/engagement/contracts.d.ts

@@ -1,3 +1,6 @@
 export * as chat from './chat/contract/index.js';
+export * as chatCommands from './chat-commands/contract/index.js';
 export * as notifications from './notifications/contract/index.js';
+export * as socialTransfers from './social-transfers/contract/index.js';
+export * as social from './social/contract/index.js';
 //# sourceMappingURL=contracts.d.ts.map

package/dist/engagement/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/engagement/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/engagement/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,YAAY,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,eAAe,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC"}

package/dist/engagement/contracts.js

@@ -1,3 +1,6 @@
 export * as chat from './chat/contract/index.js';
+export * as chatCommands from './chat-commands/contract/index.js';
 export * as notifications from './notifications/contract/index.js';
+export * as socialTransfers from './social-transfers/contract/index.js';
+export * as social from './social/contract/index.js';
 //# sourceMappingURL=contracts.js.map

package/dist/engagement/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/engagement/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/engagement/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,YAAY,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,eAAe,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC"}

package/dist/engagement/index.d.ts

@@ -1,3 +1,6 @@
 export * as chat from './chat/contract/index.js';
+export * as chatCommands from './chat-commands/contract/index.js';
 export * as notifications from './notifications/contract/index.js';
+export * as socialTransfers from './social-transfers/contract/index.js';
+export * as social from './social/contract/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/engagement/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engagement/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engagement/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,YAAY,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,eAAe,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC"}

package/dist/engagement/index.js

@@ -1,3 +1,6 @@
 export * as chat from './chat/contract/index.js';
+export * as chatCommands from './chat-commands/contract/index.js';
 export * as notifications from './notifications/contract/index.js';
+export * as socialTransfers from './social-transfers/contract/index.js';
+export * as social from './social/contract/index.js';
 //# sourceMappingURL=index.js.map

package/dist/engagement/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engagement/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engagement/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,YAAY,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,eAAe,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC"}

package/dist/engagement/notifications/__tests__/notifications.service.int.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=notifications.service.int.test.d.ts.map

package/dist/engagement/notifications/__tests__/notifications.service.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.service.int.test.d.ts","sourceRoot":"","sources":["../../../../src/engagement/notifications/__tests__/notifications.service.int.test.ts"],"names":[],"mappings":""}

package/dist/engagement/notifications/__tests__/notifications.service.int.test.js

@@ -0,0 +1,192 @@
+import { describe, it, expect, beforeAll, afterAll, beforeEach } from 'vitest';
+import { randomUUID } from 'node:crypto';
+import { eq, sql } from 'drizzle-orm';
+import { createTestDb } from '@openora/core/testing';
+import { makeEventBus } from '../../../testing/mock.js';
+import { migrate } from '../migrate.js';
+import { notification } from '../schema/index.js';
+import { NotificationsService, NotificationNotFoundError, NotificationOwnershipError, } from '../service/notifications.service.js';
+let db;
+function makeService() {
+    const events = makeEventBus();
+    return { svc: new NotificationsService(db.drizzle, events), events };
+}
+async function seedNotification(overrides = {}) {
+    const [row] = await db.drizzle.db
+        .insert(notification)
+        .values({
+        userId: randomUUID(),
+        type: 'withdrawal.approved',
+        title: 'Payout approved',
+        body: 'Your withdrawal is on its way.',
+        ...overrides,
+    })
+        .returning();
+    return row;
+}
+beforeAll(async () => {
+    db = await createTestDb([migrate]);
+});
+afterAll(async () => {
+    await db.drop();
+});
+beforeEach(async () => {
+    await db.drizzle.db.execute(sql `TRUNCATE ${notification} RESTART IDENTITY CASCADE`);
+});
+describe('NotificationsService.create (real PG)', () => {
+    it('persists an unread notification and emits created', async () => {
+        const { svc, events } = makeService();
+        const userId = randomUUID();
+        const created = await svc.create({
+            userId,
+            type: 'withdrawal.approved',
+            title: 'Hello',
+            body: 'World',
+        });
+        expect(created).toMatchObject({ userId, title: 'Hello', readAt: null });
+        expect(await db.drizzle.db.select().from(notification)).toHaveLength(1);
+        expect(events.emit).toHaveBeenCalledWith('notifications.created', {
+            notificationId: created.id,
+            userId,
+        });
+    });
+    it('persists the row a social.friend_request.sent subscriber would create', async () => {
+        const { svc } = makeService();
+        const addresseeId = randomUUID();
+        const created = await svc.create({
+            userId: addresseeId,
+            type: 'social.friend_request.received',
+            title: 'New friend request',
+            body: 'Alex sent you a friend request.',
+        });
+        expect(created).toMatchObject({
+            userId: addresseeId,
+            type: 'social.friend_request.received',
+            title: 'New friend request',
+            body: 'Alex sent you a friend request.',
+            readAt: null,
+        });
+    });
+    it('persists the row a social.friend_request.accepted subscriber would create', async () => {
+        const { svc } = makeService();
+        const requesterId = randomUUID();
+        const created = await svc.create({
+            userId: requesterId,
+            type: 'social.friend_request.accepted',
+            title: 'Friend request accepted',
+            body: 'Sam accepted your friend request.',
+        });
+        expect(created).toMatchObject({
+            userId: requesterId,
+            type: 'social.friend_request.accepted',
+            title: 'Friend request accepted',
+            body: 'Sam accepted your friend request.',
+            readAt: null,
+        });
+    });
+    it('persists the row a wallet.bonus_rollover.completed subscriber would create', async () => {
+        const { svc } = makeService();
+        const userId = randomUUID();
+        const created = await svc.create({
+            userId,
+            type: 'wallet.bonus_rollover.completed',
+            title: 'Bonus unlocked',
+            body: 'Your 25.00 USD bonus credit has cleared its rollover requirement and is now fully withdrawable.',
+        });
+        expect(created).toMatchObject({
+            userId,
+            type: 'wallet.bonus_rollover.completed',
+            title: 'Bonus unlocked',
+            body: 'Your 25.00 USD bonus credit has cleared its rollover requirement and is now fully withdrawable.',
+            readAt: null,
+        });
+    });
+});
+describe('NotificationsService.listForUser (real PG)', () => {
+    it('returns only the requesting player rows, newest first', async () => {
+        const { svc } = makeService();
+        const userId = randomUUID();
+        const older = await seedNotification({
+            userId,
+            createdAt: new Date('2026-01-01T00:00:00.000Z'),
+        });
+        const newer = await seedNotification({
+            userId,
+            createdAt: new Date('2026-02-01T00:00:00.000Z'),
+        });
+        await seedNotification();
+        const rows = await svc.listForUser(userId);
+        expect(rows.map((r) => r.id)).toEqual([newer.id, older.id]);
+    });
+    it('returns an empty list for a player with nothing on file', async () => {
+        const { svc } = makeService();
+        expect(await svc.listForUser(randomUUID())).toEqual([]);
+    });
+    it('caps the feed at fifty rows', async () => {
+        const { svc } = makeService();
+        const userId = randomUUID();
+        await db.drizzle.db.insert(notification).values(Array.from({ length: 55 }, () => ({
+            userId,
+            type: 'withdrawal.approved',
+            title: 'Payout approved',
+            body: 'body',
+        })));
+        expect(await svc.listForUser(userId)).toHaveLength(50);
+    });
+});
+describe('NotificationsService.markRead (real PG)', () => {
+    it('stamps readAt on the owned notification', async () => {
+        const { svc } = makeService();
+        const row = await seedNotification();
+        const updated = await svc.markRead(row.id, row.userId);
+        expect(updated.readAt).toBeInstanceOf(Date);
+        const [stored] = await db.drizzle.db
+            .select()
+            .from(notification)
+            .where(eq(notification.id, row.id));
+        expect(stored?.readAt).toBeInstanceOf(Date);
+    });
+    it('throws NotificationNotFoundError for an unknown id', async () => {
+        const { svc } = makeService();
+        await expect(svc.markRead(randomUUID(), randomUUID())).rejects.toBeInstanceOf(NotificationNotFoundError);
+    });
+    it('refuses another players notification and leaves it unread', async () => {
+        const { svc } = makeService();
+        const row = await seedNotification();
+        await expect(svc.markRead(row.id, randomUUID())).rejects.toBeInstanceOf(NotificationOwnershipError);
+        const [stored] = await db.drizzle.db
+            .select()
+            .from(notification)
+            .where(eq(notification.id, row.id));
+        expect(stored?.readAt).toBeNull();
+    });
+});
+describe('NotificationsService.markAllRead (real PG)', () => {
+    it('counts only the rows it actually flipped', async () => {
+        const { svc } = makeService();
+        const userId = randomUUID();
+        await seedNotification({ userId });
+        await seedNotification({ userId });
+        await seedNotification({ userId, readAt: new Date() });
+        expect(await svc.markAllRead(userId)).toEqual({ count: 2 });
+    });
+    it('leaves other players notifications untouched', async () => {
+        const { svc } = makeService();
+        const userId = randomUUID();
+        await seedNotification({ userId });
+        const other = await seedNotification();
+        await svc.markAllRead(userId);
+        const [stored] = await db.drizzle.db
+            .select()
+            .from(notification)
+            .where(eq(notification.id, other.id));
+        expect(stored?.readAt).toBeNull();
+    });
+    it('reports zero when everything is already read', async () => {
+        const { svc } = makeService();
+        const userId = randomUUID();
+        await seedNotification({ userId, readAt: new Date() });
+        expect(await svc.markAllRead(userId)).toEqual({ count: 0 });
+    });
+});
+//# sourceMappingURL=notifications.service.int.test.js.map

package/dist/engagement/notifications/__tests__/notifications.service.int.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.service.int.test.js","sourceRoot":"","sources":["../../../../src/engagement/notifications/__tests__/notifications.service.int.test.ts"],"names":[],"mappings":"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"}

package/dist/engagement/notifications/contract/index.d.ts

@@ -1,18 +1,56 @@
 import * as z from 'zod';
+export declare const NOTIFICATION_TYPES: readonly ["withdrawal.approved", "withdrawal.rejected", "kyc.resubmission_requested", "social.friend_request.received", "social.friend_request.accepted", "wallet.bonus_rollover.completed"];
+export declare const NotificationTypeSchema: z.ZodEnum<{
+    "wallet.bonus_rollover.completed": "wallet.bonus_rollover.completed";
+    "social.friend_request.accepted": "social.friend_request.accepted";
+    "withdrawal.approved": "withdrawal.approved";
+    "withdrawal.rejected": "withdrawal.rejected";
+    "kyc.resubmission_requested": "kyc.resubmission_requested";
+    "social.friend_request.received": "social.friend_request.received";
+}>;
+export type NotificationType = z.infer<typeof NotificationTypeSchema>;
 export declare const NotificationSchema: z.ZodObject<{
     id: z.ZodUUID;
     userId: z.ZodUUID;
-    type: z.ZodString;
+    type: z.ZodEnum<{
+        "wallet.bonus_rollover.completed": "wallet.bonus_rollover.completed";
+        "social.friend_request.accepted": "social.friend_request.accepted";
+        "withdrawal.approved": "withdrawal.approved";
+        "withdrawal.rejected": "withdrawal.rejected";
+        "kyc.resubmission_requested": "kyc.resubmission_requested";
+        "social.friend_request.received": "social.friend_request.received";
+    }>;
     title: z.ZodString;
     body: z.ZodString;
     readAt: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodISODateTime;
 }, z.core.$strip>;
+export declare const CreateNotificationInputSchema: z.ZodObject<{
+    userId: z.ZodUUID;
+    type: z.ZodEnum<{
+        "wallet.bonus_rollover.completed": "wallet.bonus_rollover.completed";
+        "social.friend_request.accepted": "social.friend_request.accepted";
+        "withdrawal.approved": "withdrawal.approved";
+        "withdrawal.rejected": "withdrawal.rejected";
+        "kyc.resubmission_requested": "kyc.resubmission_requested";
+        "social.friend_request.received": "social.friend_request.received";
+    }>;
+    title: z.ZodString;
+    body: z.ZodString;
+}, z.core.$strip>;
+export type CreateNotificationInput = z.infer<typeof CreateNotificationInputSchema>;
 export declare const notificationsContract: {
     list: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodArray<z.ZodObject<{
         id: z.ZodUUID;
         userId: z.ZodUUID;
-        type: z.ZodString;
+        type: z.ZodEnum<{
+            "wallet.bonus_rollover.completed": "wallet.bonus_rollover.completed";
+            "social.friend_request.accepted": "social.friend_request.accepted";
+            "withdrawal.approved": "withdrawal.approved";
+            "withdrawal.rejected": "withdrawal.rejected";
+            "kyc.resubmission_requested": "kyc.resubmission_requested";
+            "social.friend_request.received": "social.friend_request.received";
+        }>;
         title: z.ZodString;
         body: z.ZodString;
         readAt: z.ZodNullable<z.ZodString>;

package/dist/engagement/notifications/contract/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engagement/notifications/contract/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,eAAO,MAAM,kBAAkB;;;;;;;;iBAQ7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;CAWjC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engagement/notifications/contract/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,eAAO,MAAM,kBAAkB,8LAOrB,CAAC;AACX,eAAO,MAAM,sBAAsB;;;;;;;EAA6B,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;iBAQ7B,CAAC;AAGH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;iBAKxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;CAWjC,CAAC"}

package/dist/engagement/notifications/contract/index.js

@@ -1,15 +1,31 @@
 import { oc } from '@orpc/contract';
 import * as z from 'zod';
 import { IdInputSchema, TimestampSchema, UuidSchema } from '@openora/core/contracts';
+export const NOTIFICATION_TYPES = [
+    'withdrawal.approved',
+    'withdrawal.rejected',
+    'kyc.resubmission_requested',
+    'social.friend_request.received',
+    'social.friend_request.accepted',
+    'wallet.bonus_rollover.completed',
+];
+export const NotificationTypeSchema = z.enum(NOTIFICATION_TYPES);
 export const NotificationSchema = z.object({
     id: UuidSchema,
     userId: UuidSchema,
-    type: z.string(),
+    type: NotificationTypeSchema,
     title: z.string(),
     body: z.string(),
     readAt: z.string().nullable(),
     createdAt: TimestampSchema,
 });
+// Internal-only - fed by domain-event handlers in plugin.ts, not a wire route.
+export const CreateNotificationInputSchema = z.object({
+    userId: UuidSchema,
+    type: NotificationTypeSchema,
+    title: z.string(),
+    body: z.string(),
+});
 export const notificationsContract = {
     list: oc.route({ method: 'GET', path: '/notifications' }).output(z.array(NotificationSchema)),
     markRead: oc