@openora/core 0.4.1-canary.17 → 0.4.1-canary.170

package/dist/casino/gaming/__tests__/gaming.service.int.test.js

@@ -0,0 +1,803 @@
+import { describe, it, expect, vi, beforeAll, afterAll, beforeEach } from 'vitest';
+import { randomUUID } from 'node:crypto';
+import { eq, sql } from 'drizzle-orm';
+import { createTestDb } from '@openora/core/testing';
+import { migrate as migrateProfile } from '@openora/core/pam/migrate/profile';
+import { mock, makeEventBus, makeIdentityReader, NO_CLIENT_META } from '../../../testing/mock.js';
+import { migrate } from '../migrate.js';
+import { game, gameCategory, gameCategoryGame, gameProvider, gameProviderAggregatorMapping, gameRound, gameTag, gameTagGame, } from '../schema/index.js';
+import { GamingService, GameAggregatorNotMappedError, GameNotFoundError, GameSlugTakenError, RgRestrictedError, InsufficientBalanceError, WinCreditFailedError, ExternalRoundOwnerMismatchError, } from '../service/gaming.service.js';
+import { GameProviderNotFoundError } from '../service/game-provider.service.js';
+import { GameCategoryNotFoundError } from '../service/game-category.service.js';
+import { GameTagNotFoundError } from '../service/game-tag.service.js';
+let db;
+const noopEvents = makeEventBus();
+const ACTOR = { actorId: '00000000-0000-4000-8000-000000000001', ...NO_CLIENT_META };
+const eligibility = (isRestricted) => mock({ isRestricted: vi.fn().mockResolvedValue(isRestricted) });
+const unrestricted = eligibility(false);
+function makeWalletCommands(debitResult, creditResult = { ok: true, newBalance: '0' }) {
+    return mock({
+        debit: vi.fn().mockResolvedValue(debitResult),
+        credit: vi.fn().mockResolvedValue(creditResult),
+    });
+}
+function makeService({ provider = mock({
+    launchGame: vi.fn().mockResolvedValue({ launchUrl: 'https://mock/play', token: 'tok' }),
+    endRound: vi.fn(),
+}), playEligibility = unrestricted, walletCommands = makeWalletCommands({ ok: true, newBalance: '0', currency: 'USD' }), rgLimits, gameGeoCheck, events = noopEvents, } = {}) {
+    return new GamingService(db.drizzle, events, provider, playEligibility, walletCommands, makeIdentityReader(), rgLimits, gameGeoCheck);
+}
+function startRound(svc, userId, gameId, currency, betAmount) {
+    return svc.startRound(userId, gameId, currency, betAmount, '1.2.3.4');
+}
+async function seedProvider(overrides = {}) {
+    const [row] = await db.drizzle.db
+        .insert(gameProvider)
+        .values({ slug: `studio-${randomUUID()}`, name: 'Studio', isActive: true, ...overrides })
+        .returning();
+    await db.drizzle.db
+        .insert(gameProviderAggregatorMapping)
+        .values({ providerId: row.id, aggregator: 'direct', vendorId: row.slug });
+    return row;
+}
+async function seedCategory(overrides = {}) {
+    const [row] = await db.drizzle.db
+        .insert(gameCategory)
+        .values({ slug: `category-${randomUUID()}`, name: 'Slots', ...overrides })
+        .returning();
+    return row;
+}
+async function seedTag(overrides = {}) {
+    const [row] = await db.drizzle.db
+        .insert(gameTag)
+        .values({ name: `Tag ${randomUUID()}`, ...overrides })
+        .returning();
+    return row;
+}
+async function seedGame(overrides = {}, categoryIds) {
+    const provider = await seedProvider({ name: 'Mock Studio' });
+    const ids = categoryIds ?? [(await seedCategory()).id];
+    const [row] = await db.drizzle.db
+        .insert(game)
+        .values({
+        name: 'Game',
+        slug: `game-${randomUUID()}`,
+        providerId: provider.id,
+        aggregator: 'direct',
+        isActive: true,
+        ...overrides,
+    })
+        .returning();
+    await db.drizzle.db
+        .insert(gameCategoryGame)
+        .values(ids.map((categoryId) => ({ gameId: row.id, categoryId })));
+    return row;
+}
+beforeAll(async () => {
+    db = await createTestDb([migrate, migrateProfile]);
+});
+afterAll(async () => {
+    await db.drop();
+});
+beforeEach(async () => {
+    await db.drizzle.db.execute(sql `TRUNCATE ${gameRound}, ${gameCategoryGame}, ${gameTagGame}, ${game}, ${gameProvider}, ${gameCategory}, ${gameTag} RESTART IDENTITY CASCADE`);
+});
+describe('GamingService lobby (real PG)', () => {
+    it('listGamesPublic paginates playable games ordered by name', async () => {
+        await seedGame({ name: 'Baccarat', isActive: true });
+        await seedGame({ name: 'Aces', isActive: true });
+        await seedGame({ name: 'Retired', isActive: false });
+        const page = await makeService().listGamesPublic({ page: 1, limit: 10 });
+        expect(page.total).toBe(2);
+        expect(page.items.map((g) => g.name)).toEqual(['Aces', 'Baccarat']);
+    });
+    it('listGamesPublic searches and filters by provider and category', async () => {
+        const p1 = await seedProvider({ slug: 'studio-one', name: 'One' });
+        const p2 = await seedProvider({ slug: 'studio-two', name: 'Two' });
+        const slots = await seedCategory({ slug: 'slots', name: 'Slots' });
+        const live = await seedCategory({ slug: 'live', name: 'Live' });
+        await seedGame({ name: 'Gates of Olympus', slug: 'gates-of-olympus', providerId: p1.id, isActive: true }, [slots.id]);
+        await seedGame({ name: 'Sweet Bonanza', slug: 'sweet-bonanza', providerId: p1.id, isActive: true }, [slots.id]);
+        await seedGame({ name: 'Crazy Time', slug: 'crazy-time', providerId: p2.id, isActive: true }, [
+            live.id,
+            slots.id,
+        ]);
+        const svc = makeService();
+        expect((await svc.listGamesPublic({ page: 1, limit: 10, q: 'bonanza' })).total).toBe(1);
+        expect((await svc.listGamesPublic({ page: 1, limit: 10, providerId: p1.id })).items.map((g) => g.slug)).toEqual(['gates-of-olympus', 'sweet-bonanza']);
+        expect((await svc.listGamesPublic({ page: 1, limit: 10, categoryId: live.id })).total).toBe(1);
+        expect((await svc.listGamesPublic({ page: 1, limit: 10, categoryId: slots.id })).total).toBe(3);
+    });
+    it('hides an inactive category from public filtering while retaining admin filtering', async () => {
+        const inactive = await seedCategory({ name: 'Hidden', isActive: false });
+        const linked = await seedGame({ name: 'Linked Game' }, [inactive.id]);
+        const svc = makeService();
+        const publicResult = await svc.listGamesPublic({
+            page: 1,
+            limit: 10,
+            categoryId: inactive.id,
+        });
+        expect(publicResult).toMatchObject({ items: [], total: 0 });
+        const adminResult = await svc.listGamesAdmin({
+            page: 1,
+            limit: 10,
+            categoryId: inactive.id,
+            isActive: true,
+        });
+        expect(adminResult.items.map((item) => item.id)).toEqual([linked.id]);
+        expect(adminResult.total).toBe(1);
+    });
+    it('getGame returns the row for a known id and 404s an unknown one', async () => {
+        const table = await seedCategory({
+            slug: 'table-games',
+            name: 'Table Games',
+            translations: { de: { name: 'Tischspiele' } },
+        });
+        const blackjack = await seedCategory({ slug: 'blackjack', name: 'Blackjack', isActive: false });
+        const created = await seedGame({ name: 'Roulette' }, [table.id, blackjack.id]);
+        const svc = makeService();
+        expect(await svc.getGame(created.id)).toMatchObject({
+            name: 'Roulette',
+            categories: [
+                { slug: 'blackjack', translations: {} },
+                { slug: 'table-games', translations: { de: { name: 'Tischspiele' } } },
+            ],
+        });
+        await expect(svc.getGame(created.id, { activeOnly: true })).resolves.toMatchObject({
+            categories: [{ slug: 'table-games' }],
+        });
+        await expect(svc.getGame('00000000-0000-0000-0000-000000000000')).rejects.toBeInstanceOf(GameNotFoundError);
+    });
+    it('getGame hides inactive games and deactivated providers only behind activeOnly', async () => {
+        const dark = await seedGame({ name: 'Dark', isActive: false });
+        const orphaned = await seedGame({ name: 'Orphaned' });
+        await db.drizzle.db
+            .update(gameProvider)
+            .set({ isActive: false })
+            .where(eq(gameProvider.id, orphaned.providerId));
+        const svc = makeService();
+        await expect(svc.getGame(dark.id, { activeOnly: true })).rejects.toBeInstanceOf(GameNotFoundError);
+        await expect(svc.getGame(orphaned.id, { activeOnly: true })).rejects.toBeInstanceOf(GameNotFoundError);
+        await expect(svc.getGame(dark.id)).resolves.toMatchObject({ name: 'Dark', isActive: false });
+        await expect(svc.getGame(orphaned.id)).resolves.toMatchObject({ name: 'Orphaned' });
+    });
+    it('returns visible tags publicly and all tags to admin callers', async () => {
+        const visible = await seedTag({ name: 'Visible', visibility: 'visible' });
+        const invisible = await seedTag({ name: 'Invisible', visibility: 'invisible' });
+        const created = await seedGame();
+        await db.drizzle.db.insert(gameTagGame).values([
+            { gameId: created.id, tagId: visible.id },
+            { gameId: created.id, tagId: invisible.id },
+        ]);
+        const svc = makeService();
+        await expect(svc.getGame(created.id)).resolves.toMatchObject({
+            tags: [{ name: 'Visible', visibility: 'visible' }],
+        });
+        await expect(svc.getGame(created.id, { includeInvisibleTags: true })).resolves.toMatchObject({
+            tags: [
+                { name: 'Invisible', visibility: 'invisible' },
+                { name: 'Visible', visibility: 'visible' },
+            ],
+        });
+    });
+});
+const refusingLimits = () => mock({
+    checkDeposit: vi.fn(),
+    checkWager: vi.fn().mockResolvedValue({
+        allowed: false,
+        limitType: 'wager',
+        period: 'daily',
+        limit: '50',
+        used: '45',
+    }),
+});
+describe('GamingService.startRound (real PG)', () => {
+    it('denies a blocked game before debit, round insertion, or provider launch', async () => {
+        const created = await seedGame({ name: 'Blocked' });
+        const launchGame = vi.fn();
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '90', currency: 'USD' });
+        const gameGeoCheck = mock({
+            checkGame: vi.fn().mockResolvedValue({
+                allowed: false,
+                countryCode: 'US',
+                reason: 'game_block',
+            }),
+        });
+        const svc = makeService({
+            provider: mock({ launchGame, endRound: vi.fn() }),
+            walletCommands,
+            gameGeoCheck,
+        });
+        await expect(startRound(svc, '00000000-0000-0000-0000-000000000110', created.id, 'USD', '10')).rejects.toMatchObject({
+            name: 'GameGeoRestrictedError',
+            data: { reason: 'game_block', countryCode: 'US' },
+        });
+        expect(walletCommands.debit).not.toHaveBeenCalled();
+        expect(launchGame).not.toHaveBeenCalled();
+        expect(await db.drizzle.db.select().from(gameRound)).toHaveLength(0);
+    });
+    it('does not consult geo for an inactive game', async () => {
+        const created = await seedGame({ name: 'Inactive', isActive: false });
+        const checkGame = vi.fn();
+        const svc = makeService({ gameGeoCheck: mock({ checkGame }) });
+        await expect(startRound(svc, '00000000-0000-0000-0000-000000000110', created.id, 'USD', '10')).rejects.toBeInstanceOf(GameNotFoundError);
+        expect(checkGame).not.toHaveBeenCalled();
+    });
+    it('refuses a wager over the players own limit before touching the provider', async () => {
+        const created = await seedGame({ name: 'Limited' });
+        const launchGame = vi.fn();
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '0', currency: 'USD' });
+        const svc = makeService({
+            provider: mock({ launchGame, endRound: vi.fn() }),
+            walletCommands,
+            rgLimits: refusingLimits(),
+        });
+        await expect(startRound(svc, 'user-1', created.id, 'EUR', '10')).rejects.toMatchObject({
+            name: 'RgLimitExceededError',
+            data: { reason: 'wager_limit_exceeded', limitType: 'wager', limit: '50', used: '45' },
+        });
+        expect(launchGame).not.toHaveBeenCalled();
+        expect(walletCommands.debit).not.toHaveBeenCalled();
+    });
+    it('starts a round when no limit gate is bound at all', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000c1', name: 'Ungated' });
+        const svc = makeService();
+        await expect(startRound(svc, '00000000-0000-0000-0000-000000000111', created.id, 'USD', '10')).resolves.toMatchObject({ launchUrl: 'https://mock/play' });
+    });
+    it('refuses a restricted player before touching the provider', async () => {
+        const created = await seedGame({ name: 'Restricted' });
+        const launchGame = vi.fn();
+        const svc = makeService({
+            provider: mock({ launchGame, endRound: vi.fn() }),
+            playEligibility: eligibility(true),
+        });
+        await expect(startRound(svc, 'user-1', created.id, 'EUR', '10')).rejects.toBeInstanceOf(RgRestrictedError);
+        expect(launchGame).not.toHaveBeenCalled();
+    });
+    it('passes the gate for an unrestricted player and fails later on the game lookup', async () => {
+        const launchGame = vi.fn();
+        const svc = makeService({
+            provider: mock({ launchGame, endRound: vi.fn() }),
+        });
+        await expect(startRound(svc, '00000000-0000-0000-0000-000000000111', '00000000-0000-0000-0000-000000000222', 'EUR', '10')).rejects.toBeInstanceOf(GameNotFoundError);
+        expect(launchGame).not.toHaveBeenCalled();
+    });
+    it('404s an inactive game without touching the wallet or provider', async () => {
+        const created = await seedGame({ name: 'Dark', isActive: false });
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '90', currency: 'USD' });
+        const launchGame = vi.fn();
+        const svc = makeService({
+            provider: mock({ launchGame, endRound: vi.fn() }),
+            walletCommands,
+        });
+        await expect(svc.startRound('00000000-0000-0000-0000-000000000311', created.id, 'USD', '10')).rejects.toBeInstanceOf(GameNotFoundError);
+        expect(walletCommands.debit).not.toHaveBeenCalled();
+        expect(launchGame).not.toHaveBeenCalled();
+        expect(await db.drizzle.db.select().from(gameRound)).toHaveLength(0);
+    });
+    it('404s a game on a deactivated provider without touching the wallet or provider', async () => {
+        const created = await seedGame({ name: 'Orphaned' });
+        await db.drizzle.db
+            .update(gameProvider)
+            .set({ isActive: false })
+            .where(eq(gameProvider.id, created.providerId));
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '90', currency: 'USD' });
+        const launchGame = vi.fn();
+        const svc = makeService({
+            provider: mock({ launchGame, endRound: vi.fn() }),
+            walletCommands,
+        });
+        await expect(svc.startRound('00000000-0000-0000-0000-000000000312', created.id, 'USD', '10')).rejects.toBeInstanceOf(GameNotFoundError);
+        expect(walletCommands.debit).not.toHaveBeenCalled();
+        expect(launchGame).not.toHaveBeenCalled();
+        expect(await db.drizzle.db.select().from(gameRound)).toHaveLength(0);
+    });
+    it('debits the stake and persists the round on sufficient balance', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000a1', name: 'Aces' });
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '90', currency: 'USD' });
+        const launchGame = vi.fn().mockResolvedValue({ launchUrl: 'https://mock/play', token: 'tok' });
+        const svc = makeService({
+            provider: mock({ launchGame, endRound: vi.fn() }),
+            walletCommands,
+        });
+        const userId = '00000000-0000-0000-0000-000000000301';
+        const result = await startRound(svc, userId, created.id, 'USD', '10');
+        expect(walletCommands.debit).toHaveBeenCalledWith(expect.anything(), {
+            userId,
+            amount: '10',
+            currency: 'USD',
+            type: 'bet',
+        });
+        expect(launchGame).toHaveBeenCalledWith(created.id, userId, 'USD');
+        expect(result).toEqual({
+            roundId: expect.any(String),
+            launchUrl: 'https://mock/play',
+            token: 'tok',
+        });
+        const rounds = await db.drizzle.db.select().from(gameRound);
+        expect(rounds).toHaveLength(1);
+        expect(rounds[0]).toMatchObject({ gameId: created.id, userId, currency: 'USD' });
+        expect(Number(rounds[0]?.betAmount)).toBe(10);
+    });
+    it('throws InsufficientBalanceError, persists no round, and never launches the game when the debit fails', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000a2', name: 'Aces' });
+        const walletCommands = makeWalletCommands({ ok: false, available: '2' });
+        const launchGame = vi.fn();
+        const svc = makeService({
+            provider: mock({ launchGame, endRound: vi.fn() }),
+            walletCommands,
+        });
+        await expect(startRound(svc, '00000000-0000-0000-0000-000000000302', created.id, 'USD', '10')).rejects.toBeInstanceOf(InsufficientBalanceError);
+        expect(launchGame).not.toHaveBeenCalled();
+        expect(await db.drizzle.db.select().from(gameRound)).toHaveLength(0);
+    });
+});
+describe('GamingService listGames provider gate (real PG)', () => {
+    it('separates the public playable gate from the admin game-active filter', async () => {
+        const live = await seedGame({ name: 'Live Game' });
+        const hidden = await seedGame({ name: 'Hidden Game' });
+        await db.drizzle.db
+            .update(gameProvider)
+            .set({ isActive: false })
+            .where(eq(gameProvider.id, hidden.providerId));
+        const svc = makeService();
+        const pub = await svc.listGamesPublic({ page: 1, limit: 10 });
+        expect(pub.items.map((g) => g.id)).toEqual([live.id]);
+        expect(pub.total).toBe(1);
+        const admin = await svc.listGamesAdmin({ page: 1, limit: 10, isActive: true });
+        expect(admin.total).toBe(2);
+    });
+    it('listGamesAdmin includes non-playable games and sorts by provider and game fields', async () => {
+        const alphaZulu = await seedProvider({ name: 'Alpha', slug: 'zulu' });
+        const alphaAlpha = await seedProvider({ name: 'Alpha', slug: 'alpha' });
+        const betaAlpha = await seedProvider({ name: 'Beta', slug: 'beta-alpha', isActive: false });
+        await seedGame({
+            id: '00000000-0000-4000-8000-000000000002',
+            name: 'Same',
+            providerId: alphaZulu.id,
+        });
+        await seedGame({
+            id: '00000000-0000-4000-8000-000000000001',
+            name: 'Same',
+            providerId: alphaZulu.id,
+        });
+        await seedGame({ name: 'Zulu', providerId: alphaAlpha.id });
+        await seedGame({ name: 'Aardvark', providerId: betaAlpha.id });
+        const result = await makeService().listGamesAdmin({ page: 1, limit: 10 });
+        expect(result.items.map((item) => [item.provider.name, item.provider.slug, item.name, item.id])).toEqual([
+            ['Alpha', 'alpha', 'Zulu', expect.any(String)],
+            ['Alpha', 'zulu', 'Same', '00000000-0000-4000-8000-000000000001'],
+            ['Alpha', 'zulu', 'Same', '00000000-0000-4000-8000-000000000002'],
+            ['Beta', 'beta-alpha', 'Aardvark', expect.any(String)],
+        ]);
+        expect(result.total).toBe(4);
+    });
+});
+describe('GamingService.startRound bonus rollover completion (real PG)', () => {
+    it('emits wallet.bonus_rollover.completed once per credit the bet just completed', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000a3', name: 'Aces' });
+        const events = makeEventBus();
+        const walletCommands = makeWalletCommands({
+            ok: true,
+            newBalance: '60',
+            currency: 'USD',
+            completedBonusCredits: [
+                { id: '00000000-0000-0000-0000-0000000000c1', currency: 'USD', creditedAmount: '25' },
+                { id: '00000000-0000-0000-0000-0000000000c2', currency: 'USD', creditedAmount: '10' },
+            ],
+        });
+        const svc = new GamingService(db.drizzle, events, mock({
+            launchGame: vi.fn().mockResolvedValue({ launchUrl: 'https://mock/play', token: 'tok' }),
+            endRound: vi.fn(),
+        }), unrestricted, walletCommands, makeIdentityReader());
+        const userId = '00000000-0000-0000-0000-000000000401';
+        await startRound(svc, userId, created.id, 'USD', '40');
+        expect(events.emit).toHaveBeenCalledWith('wallet.bonus_rollover.completed', {
+            userId,
+            creditId: '00000000-0000-0000-0000-0000000000c1',
+            currency: 'USD',
+            creditedAmount: '25',
+        });
+        expect(events.emit).toHaveBeenCalledWith('wallet.bonus_rollover.completed', {
+            userId,
+            creditId: '00000000-0000-0000-0000-0000000000c2',
+            currency: 'USD',
+            creditedAmount: '10',
+        });
+    });
+    it('emits rollover completion before a provider launch failure can discard the notification', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000a5', name: 'Aces' });
+        const events = makeEventBus();
+        const launchGame = vi.fn().mockRejectedValue(new Error('provider unavailable'));
+        const walletCommands = makeWalletCommands({
+            ok: true,
+            newBalance: '0',
+            currency: 'USD',
+            completedBonusCredits: [
+                { id: '00000000-0000-0000-0000-0000000000c5', currency: 'USD', creditedAmount: '25' },
+            ],
+        });
+        const svc = new GamingService(db.drizzle, events, mock({ launchGame, endRound: vi.fn() }), unrestricted, walletCommands, makeIdentityReader());
+        const userId = '00000000-0000-0000-0000-000000000405';
+        await expect(startRound(svc, userId, created.id, 'USD', '25')).rejects.toThrow('provider unavailable');
+        expect(events.emit).toHaveBeenCalledWith('wallet.bonus_rollover.completed', {
+            userId,
+            creditId: '00000000-0000-0000-0000-0000000000c5',
+            currency: 'USD',
+            creditedAmount: '25',
+        });
+        expect(launchGame).toHaveBeenCalledOnce();
+    });
+    it('emits no wallet.bonus_rollover.completed event when the debit completed no credit', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000a4', name: 'Aces' });
+        const events = makeEventBus();
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '90', currency: 'USD' });
+        const svc = new GamingService(db.drizzle, events, mock({
+            launchGame: vi.fn().mockResolvedValue({ launchUrl: 'https://mock/play', token: 'tok' }),
+            endRound: vi.fn(),
+        }), unrestricted, walletCommands, makeIdentityReader());
+        const userId = '00000000-0000-0000-0000-000000000402';
+        await startRound(svc, userId, created.id, 'USD', '10');
+        expect(events.emit).not.toHaveBeenCalledWith('wallet.bonus_rollover.completed', expect.anything());
+    });
+});
+describe('GamingService updateGame (real PG)', () => {
+    const emittedTopics = (events) => events.emit.mock.calls.map(([topic]) => topic);
+    it('patches scalar fields and emits an event', async () => {
+        const created = await seedGame({ name: 'Roulette' });
+        const events = makeEventBus();
+        const svc = makeService({ events });
+        const updated = await svc.updateGame({
+            id: created.id,
+            name: 'Roulette Gold',
+            isActive: false,
+            ...ACTOR,
+        });
+        expect(updated).toMatchObject({ name: 'Roulette Gold', isActive: false });
+        expect(emittedTopics(events)).toContain('gaming.game.updated');
+    });
+    it('replaces the category set, including clearing it with an empty array', async () => {
+        const table = await seedCategory({ slug: 'table-games', name: 'Table Games' });
+        const blackjack = await seedCategory({ slug: 'blackjack', name: 'Blackjack' });
+        const created = await seedGame({}, [table.id, blackjack.id]);
+        const svc = makeService();
+        const replaced = await svc.updateGame({
+            id: created.id,
+            categoryIds: [blackjack.id],
+            ...ACTOR,
+        });
+        expect(replaced.categories.map((c) => c.slug)).toEqual(['blackjack']);
+        const cleared = await svc.updateGame({ id: created.id, categoryIds: [], ...ACTOR });
+        expect(cleared.categories).toEqual([]);
+    });
+    it('replaces the tag set, including invisible tags for admin results', async () => {
+        const visible = await seedTag({ name: 'Visible', visibility: 'visible' });
+        const invisible = await seedTag({ name: 'Invisible', visibility: 'invisible' });
+        const created = await seedGame();
+        const svc = makeService();
+        const replaced = await svc.updateGame({
+            id: created.id,
+            tagIds: [visible.id, invisible.id],
+            ...ACTOR,
+        });
+        expect(replaced.tags.map((tag) => tag.name)).toEqual(['Invisible', 'Visible']);
+        expect((await svc.getGame(created.id)).tags.map((tag) => tag.name)).toEqual(['Visible']);
+        const cleared = await svc.updateGame({ id: created.id, tagIds: [], ...ACTOR });
+        expect(cleared.tags).toEqual([]);
+    });
+    it('serializes against a concurrent tag delete instead of racing an FK violation', async () => {
+        const tag = await seedTag({ name: 'Raced', type: 'custom' });
+        const created = await seedGame();
+        const svc = makeService();
+        let updateGamePromise;
+        await db.drizzle.db.transaction(async (tx) => {
+            await tx.select({ id: gameTag.id }).from(gameTag).where(eq(gameTag.id, tag.id)).for('update');
+            updateGamePromise = svc.updateGame({ id: created.id, tagIds: [tag.id], ...ACTOR });
+            await tx.delete(gameTag).where(eq(gameTag.id, tag.id));
+        });
+        await expect(updateGamePromise).rejects.toBeInstanceOf(GameTagNotFoundError);
+    });
+    it('leaves links untouched when categoryIds is omitted', async () => {
+        const table = await seedCategory({ slug: 'table-games', name: 'Table Games' });
+        const created = await seedGame({}, [table.id]);
+        const svc = makeService();
+        const updated = await svc.updateGame({ id: created.id, name: 'Renamed', ...ACTOR });
+        expect(updated.categories.map((c) => c.slug)).toEqual(['table-games']);
+    });
+    it('reassigns the provider and validates all references', async () => {
+        const created = await seedGame();
+        const other = await seedProvider({ slug: 'other-studio', name: 'Other' });
+        const svc = makeService();
+        const updated = await svc.updateGame({
+            id: created.id,
+            providerId: other.id,
+            ...ACTOR,
+        });
+        expect(updated.provider).toMatchObject({ slug: 'other-studio' });
+        await expect(svc.updateGame({
+            id: created.id,
+            providerId: '00000000-0000-4000-8000-000000000000',
+            ...ACTOR,
+        })).rejects.toBeInstanceOf(GameProviderNotFoundError);
+        await expect(svc.updateGame({
+            id: created.id,
+            categoryIds: ['00000000-0000-4000-8000-000000000000'],
+            ...ACTOR,
+        })).rejects.toBeInstanceOf(GameCategoryNotFoundError);
+        await expect(svc.updateGame({
+            id: created.id,
+            tagIds: ['00000000-0000-4000-8000-000000000000'],
+            ...ACTOR,
+        })).rejects.toBeInstanceOf(GameTagNotFoundError);
+        await expect(svc.updateGame({
+            id: '00000000-0000-4000-8000-000000000000',
+            name: 'X',
+            ...ACTOR,
+        })).rejects.toBeInstanceOf(GameNotFoundError);
+    });
+    it('rejects an aggregator the target provider is not mapped on', async () => {
+        const created = await seedGame();
+        const unmapped = await seedProvider({ slug: 'unmapped-studio', name: 'Unmapped' });
+        await db.drizzle.db
+            .delete(gameProviderAggregatorMapping)
+            .where(eq(gameProviderAggregatorMapping.providerId, unmapped.id));
+        const svc = makeService();
+        await expect(svc.updateGame({ id: created.id, providerId: unmapped.id, ...ACTOR })).rejects.toBeInstanceOf(GameAggregatorNotMappedError);
+        await expect(svc.updateGame({ id: created.id, aggregator: 'everymatrix', ...ACTOR })).rejects.toBeInstanceOf(GameAggregatorNotMappedError);
+        await db.drizzle.db
+            .insert(gameProviderAggregatorMapping)
+            .values({ providerId: unmapped.id, aggregator: 'everymatrix', vendorId: 'vendor-unmapped' });
+        const moved = await svc.updateGame({
+            id: created.id,
+            providerId: unmapped.id,
+            aggregator: 'everymatrix',
+            ...ACTOR,
+        });
+        expect(moved).toMatchObject({
+            provider: { slug: 'unmapped-studio' },
+            aggregator: 'everymatrix',
+        });
+    });
+    it('rejects a taken game slug', async () => {
+        const created = await seedGame({ slug: 'game-one' });
+        await seedGame({ slug: 'game-two' });
+        const svc = makeService();
+        await expect(svc.updateGame({ id: created.id, slug: 'game-two', ...ACTOR })).rejects.toBeInstanceOf(GameSlugTakenError);
+    });
+});
+async function seedRound(gameId, userId) {
+    const [row] = await db.drizzle.db
+        .insert(gameRound)
+        .values({ gameId, userId, currency: 'USD', betAmount: '10', status: 'active' })
+        .returning();
+    return row;
+}
+const settlingProvider = (winAmount) => mock({
+    launchGame: vi.fn(),
+    endRound: vi.fn().mockResolvedValue(winAmount === undefined ? undefined : { winAmount }),
+});
+describe('GamingService.endRound (real PG)', () => {
+    const userId = '00000000-0000-0000-0000-000000000501';
+    it('settles an admitted active round without rechecking a newly blocking geo policy', async () => {
+        const created = await seedGame();
+        const round = await seedRound(created.id, userId);
+        const checkGame = vi.fn().mockResolvedValue({
+            allowed: false,
+            countryCode: 'US',
+            reason: 'game_block',
+        });
+        const svc = makeService({
+            provider: settlingProvider('5'),
+            gameGeoCheck: mock({ checkGame }),
+        });
+        await expect(svc.endRound(userId, round.id)).resolves.toEqual({
+            success: true,
+            winAmount: '5',
+        });
+        expect(checkGame).not.toHaveBeenCalled();
+    });
+    it('credits the provider-reported win to the round currency and records it on the round', async () => {
+        const created = await seedGame();
+        const round = await seedRound(created.id, userId);
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '0', currency: 'USD' });
+        const svc = makeService({ provider: settlingProvider('42.50'), walletCommands });
+        expect(await svc.endRound(userId, round.id)).toEqual({ success: true, winAmount: '42.50' });
+        expect(walletCommands.credit).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ userId, amount: '42.50', currency: 'USD', type: 'win' }));
+        const [settled] = await db.drizzle.db.select().from(gameRound);
+        expect(settled?.status).toBe('completed');
+        expect(Number(settled?.winAmount)).toBe(42.5);
+    });
+    it('credits nothing when the provider reports no outcome', async () => {
+        const created = await seedGame();
+        const round = await seedRound(created.id, userId);
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '0', currency: 'USD' });
+        const svc = makeService({ provider: settlingProvider(), walletCommands });
+        expect(await svc.endRound(userId, round.id)).toEqual({ success: true, winAmount: '0' });
+        expect(walletCommands.credit).not.toHaveBeenCalled();
+    });
+    it('pays a win once - a replayed end never asks the provider or credits again', async () => {
+        const created = await seedGame();
+        const round = await seedRound(created.id, userId);
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '0', currency: 'USD' });
+        const provider = settlingProvider('7');
+        const svc = makeService({ provider, walletCommands });
+        await svc.endRound(userId, round.id);
+        const replayed = await svc.endRound(userId, round.id);
+        expect(replayed.success).toBe(true);
+        expect(Number(replayed.winAmount)).toBe(7);
+        expect(provider.endRound).toHaveBeenCalledOnce();
+        expect(walletCommands.credit).toHaveBeenCalledOnce();
+    });
+    it('leaves the round open when the win credit is refused, so the payout is not lost', async () => {
+        const created = await seedGame();
+        const round = await seedRound(created.id, userId);
+        const walletCommands = makeWalletCommands({ ok: true, newBalance: '0', currency: 'USD' }, { ok: false, reason: 'wallet not found' });
+        const svc = makeService({ provider: settlingProvider('7'), walletCommands });
+        await expect(svc.endRound(userId, round.id)).rejects.toBeInstanceOf(WinCreditFailedError);
+        const [unsettled] = await db.drizzle.db.select().from(gameRound);
+        expect(unsettled?.status).toBe('active');
+        expect(Number(unsettled?.winAmount)).toBe(0);
+    });
+});
+describe('GamingService.accumulateExternalRound (real PG)', () => {
+    it('creates a game_round row on the first call for a given externalRoundId', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000b1', name: 'Aces' });
+        const svc = makeService();
+        const userId = '00000000-0000-0000-0000-000000000501';
+        const result = await svc.accumulateExternalRound(db.drizzle.db, {
+            gameId: created.id,
+            userId,
+            currency: 'USD',
+            externalRoundId: 'ext-round-1',
+            betDelta: '10',
+            winDelta: '0',
+        });
+        expect(Number(result.betAmount)).toBe(10);
+        expect(Number(result.winAmount)).toBe(0);
+        const rows = await db.drizzle.db.select().from(gameRound);
+        expect(rows).toHaveLength(1);
+        expect(rows[0]).toMatchObject({
+            id: result.roundId,
+            gameId: created.id,
+            userId,
+            currency: 'USD',
+            externalRoundId: 'ext-round-1',
+            status: 'active',
+        });
+    });
+    it('accumulates betAmount/winAmount on every subsequent call for the same externalRoundId', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000b2', name: 'Aces' });
+        const svc = makeService();
+        const userId = '00000000-0000-0000-0000-000000000502';
+        const first = await svc.accumulateExternalRound(db.drizzle.db, {
+            gameId: created.id,
+            userId,
+            currency: 'USD',
+            externalRoundId: 'ext-round-2',
+            betDelta: '10',
+        });
+        const second = await svc.accumulateExternalRound(db.drizzle.db, {
+            gameId: created.id,
+            userId,
+            currency: 'USD',
+            externalRoundId: 'ext-round-2',
+            betDelta: '5',
+            winDelta: '20',
+        });
+        expect(second.roundId).toBe(first.roundId);
+        expect(Number(second.betAmount)).toBe(15);
+        expect(Number(second.winAmount)).toBe(20);
+        const rows = await db.drizzle.db.select().from(gameRound);
+        expect(rows).toHaveLength(1);
+    });
+    it('loses no update when two calls race against the same externalRoundId', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000b3', name: 'Aces' });
+        const svc = makeService();
+        const userId = '00000000-0000-0000-0000-000000000503';
+        await Promise.all([
+            svc.accumulateExternalRound(db.drizzle.db, {
+                gameId: created.id,
+                userId,
+                currency: 'USD',
+                externalRoundId: 'ext-round-3',
+                betDelta: '10',
+            }),
+            svc.accumulateExternalRound(db.drizzle.db, {
+                gameId: created.id,
+                userId,
+                currency: 'USD',
+                externalRoundId: 'ext-round-3',
+                betDelta: '7',
+            }),
+        ]);
+        const rows = await db.drizzle.db.select().from(gameRound);
+        expect(rows).toHaveLength(1);
+        expect(Number(rows[0]?.betAmount)).toBe(17);
+    });
+    it('rolls back the accumulated round together with the caller transaction', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000b4', name: 'Aces' });
+        const svc = makeService();
+        const userId = '00000000-0000-0000-0000-000000000504';
+        await expect(db.drizzle.db.transaction(async (tx) => {
+            await svc.accumulateExternalRound(tx, {
+                gameId: created.id,
+                userId,
+                currency: 'USD',
+                externalRoundId: 'ext-round-4',
+                betDelta: '10',
+            });
+            throw new Error('caller rolled back');
+        })).rejects.toThrow('caller rolled back');
+        const rows = await db.drizzle.db
+            .select()
+            .from(gameRound)
+            .where(eq(gameRound.externalRoundId, 'ext-round-4'));
+        expect(rows).toHaveLength(0);
+    });
+    it('marks the round completed with endedAt set when the terminating callback passes isFinal', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000b5', name: 'Aces' });
+        const svc = makeService();
+        const userId = '00000000-0000-0000-0000-000000000505';
+        await svc.accumulateExternalRound(db.drizzle.db, {
+            gameId: created.id,
+            userId,
+            currency: 'USD',
+            externalRoundId: 'ext-round-5',
+            betDelta: '10',
+        });
+        const result = await svc.accumulateExternalRound(db.drizzle.db, {
+            gameId: created.id,
+            userId,
+            currency: 'USD',
+            externalRoundId: 'ext-round-5',
+            winDelta: '15',
+            isFinal: true,
+        });
+        const rows = await db.drizzle.db
+            .select()
+            .from(gameRound)
+            .where(eq(gameRound.id, result.roundId));
+        expect(rows[0]).toMatchObject({ status: 'completed' });
+        expect(rows[0]?.endedAt).not.toBeNull();
+    });
+    it('refuses to merge a delta onto a round owned by a different user', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000b6', name: 'Aces' });
+        const svc = makeService();
+        const ownerId = '00000000-0000-0000-0000-000000000506';
+        const otherId = '00000000-0000-0000-0000-000000000507';
+        await svc.accumulateExternalRound(db.drizzle.db, {
+            gameId: created.id,
+            userId: ownerId,
+            currency: 'USD',
+            externalRoundId: 'ext-round-6',
+            betDelta: '10',
+        });
+        await expect(svc.accumulateExternalRound(db.drizzle.db, {
+            gameId: created.id,
+            userId: otherId,
+            currency: 'USD',
+            externalRoundId: 'ext-round-6',
+            betDelta: '5',
+        })).rejects.toThrow(ExternalRoundOwnerMismatchError);
+        const rows = await db.drizzle.db
+            .select()
+            .from(gameRound)
+            .where(eq(gameRound.externalRoundId, 'ext-round-6'));
+        expect(rows).toHaveLength(1);
+        expect(Number(rows[0]?.betAmount)).toBe(10);
+    });
+    it('preserves a sub-cent crypto delta instead of rounding it to zero', async () => {
+        const created = await seedGame({ id: '00000000-0000-0000-0000-0000000000b7', name: 'Aces' });
+        const svc = makeService();
+        const userId = '00000000-0000-0000-0000-000000000508';
+        const result = await svc.accumulateExternalRound(db.drizzle.db, {
+            gameId: created.id,
+            userId,
+            currency: 'BTC',
+            externalRoundId: 'ext-round-7',
+            betDelta: '0.000000000000000001',
+        });
+        expect(result.betAmount).toBe('0.000000000000000001');
+    });
+});
+//# sourceMappingURL=gaming.service.int.test.js.map