@openora/core 0.4.1-canary.11 → 0.4.1-canary.111

package/dist/wallet/__tests__/bonus-rollover-concurrency.int.test.js

@@ -0,0 +1,163 @@
+import { describe, it, expect, vi, beforeAll, afterAll, beforeEach } from 'vitest';
+import { findOneOrThrow } from '@openora/core/server';
+import { randomUUID } from 'node:crypto';
+import { eq, sql } from 'drizzle-orm';
+import { createTestDb } from '@openora/core/testing';
+import { mock, makeEventBus, makeAuditWriter, makeIdentityReader, makePaymentProviderRegistry, } from '../../testing/mock.js';
+import { migrate } from '../migrate.js';
+import { wallet, walletBalance, walletTransaction, walletBonusCredit, walletBonusRolloverConfig, } from '../schema/index.js';
+import { WalletCommandsService } from '../service/wallet-commands.service.js';
+import { WalletService, BonusRolloverLockedError, InsufficientBalanceError, } from '../service/wallet.service.js';
+let db;
+const unrestricted = mock({ isRestricted: vi.fn().mockResolvedValue(false) });
+async function seedWallet(balance, currency = 'USD') {
+    const row = findOneOrThrow(await db.drizzle.db.insert(wallet).values({ userId: randomUUID(), currency }).returning(), new Error('seedWallet: query returned no row'));
+    await db.drizzle.db
+        .insert(walletBalance)
+        .values({ walletId: row.id, currency: row.currency, amount: balance });
+    return row;
+}
+async function insertCredit(w, overrides = {}) {
+    return findOneOrThrow(await db.drizzle.db
+        .insert(walletBonusCredit)
+        .values({
+        walletId: w.id,
+        userId: w.userId,
+        currency: w.currency,
+        sourceType: 'gift',
+        creditedAmount: '0',
+        rolloverMultiplier: '1',
+        rolloverRequired: '0',
+        rolloverProgress: '0',
+        status: 'active',
+        ...overrides,
+    })
+        .returning(), new Error('insertCredit: query returned no row'));
+}
+function makeCommandsSvc() {
+    return new WalletCommandsService(unrestricted, makeAuditWriter());
+}
+function makeWalletSvc() {
+    return new WalletService({
+        drizzle: db.drizzle,
+        events: makeEventBus(),
+        payment: mock({ processDeposit: vi.fn(), processWithdrawal: vi.fn() }),
+        paymentProviders: makePaymentProviderRegistry(),
+        identityReader: makeIdentityReader(),
+        audit: makeAuditWriter(),
+    });
+}
+beforeAll(async () => {
+    db = await createTestDb([migrate]);
+});
+afterAll(async () => {
+    await db.drop();
+});
+beforeEach(async () => {
+    await db.drizzle.db.execute(sql `TRUNCATE ${walletTransaction}, ${walletBonusCredit}, ${walletBonusRolloverConfig}, ${wallet} RESTART IDENTITY CASCADE`);
+});
+describe('bonus-rollover QA concurrency probe: two simultaneous bets against ONE active credit', () => {
+    const TRIALS = 8;
+    it('never lets rolloverProgress exceed rolloverRequired and completes the credit exactly once, across repeated trials', async () => {
+        for (let trial = 0; trial < TRIALS; trial++) {
+            const w = await seedWallet('1000');
+            const credit = await insertCredit(w, { creditedAmount: '100', rolloverRequired: '100' });
+            const svc = makeCommandsSvc();
+            const [r1, r2] = await Promise.all([
+                db.drizzle.db.transaction((txn) => svc.debit(txn, { userId: w.userId, amount: '70', type: 'bet' })),
+                db.drizzle.db.transaction((txn) => svc.debit(txn, { userId: w.userId, amount: '70', type: 'bet' })),
+            ]);
+            if (!r1.ok || !r2.ok) {
+                throw new Error(`trial ${trial}: expected both debits ok`);
+            }
+            const [row] = await db.drizzle.db
+                .select()
+                .from(walletBonusCredit)
+                .where(eq(walletBonusCredit.id, credit.id));
+            expect(Number(row.rolloverProgress), `trial ${trial}: progress must cap at 100`).toBe(100);
+            expect(row.status, `trial ${trial}: must flip to completed`).toBe('completed');
+            const completions = [
+                ...(r1.completedBonusCredits ?? []),
+                ...(r2.completedBonusCredits ?? []),
+            ];
+            expect(completions, `trial ${trial}: exactly one debit reports the completion, not zero, not both`).toHaveLength(1);
+            expect(completions[0].id).toBe(credit.id);
+        }
+    });
+});
+describe('bonus-rollover QA concurrency probe: withdrawal racing the bet that unlocks it', () => {
+    const TRIALS = 8;
+    it('a withdrawal for the full pre-bet balance never succeeds, regardless of which transaction wins the race', async () => {
+        for (let trial = 0; trial < TRIALS; trial++) {
+            const w = await seedWallet('100');
+            await insertCredit(w, {
+                creditedAmount: '100',
+                rolloverRequired: '100',
+                rolloverProgress: '90',
+            });
+            const commandsSvc = makeCommandsSvc();
+            const walletSvc = makeWalletSvc();
+            const betPromise = db.drizzle.db.transaction((txn) => commandsSvc.debit(txn, { userId: w.userId, amount: '10', type: 'bet' }));
+            const withdrawPromise = walletSvc
+                .withdraw({
+                userId: w.userId,
+                amount: '100',
+                currency: 'USD',
+                ip: null,
+                userAgent: null,
+            })
+                .then((res) => ({ ok: true, res }), (err) => ({ ok: false, err }));
+            const [betResult, withdrawOutcome] = await Promise.all([betPromise, withdrawPromise]);
+            if (!betResult.ok) {
+                throw new Error(`trial ${trial}: expected bet debit ok`);
+            }
+            expect(withdrawOutcome.ok, `trial ${trial}: a 100-unit withdrawal must never succeed here`).toBe(false);
+            if (!withdrawOutcome.ok) {
+                expect(withdrawOutcome.err, `trial ${trial}: refusal must be one of the two expected domain errors, not a generic failure`).toSatisfy((err) => err instanceof BonusRolloverLockedError || err instanceof InsufficientBalanceError);
+            }
+            const [balRow] = await db.drizzle.db
+                .select()
+                .from(walletBalance)
+                .where(eq(walletBalance.walletId, w.id));
+            expect(Number(balRow.amount), `trial ${trial}: only the bet's 10 ever left the balance`).toBe(90);
+            const [creditRow] = await db.drizzle.db
+                .select()
+                .from(walletBonusCredit)
+                .where(eq(walletBonusCredit.walletId, w.id));
+            expect(creditRow.status).toBe('completed');
+            expect(Number(creditRow.rolloverProgress)).toBe(100);
+        }
+    });
+    it('a withdrawal for exactly the pre-bet UNLOCKED portion succeeds under either race ordering, and total money out is consistent', async () => {
+        for (let trial = 0; trial < TRIALS; trial++) {
+            const w = await seedWallet('100');
+            await insertCredit(w, {
+                creditedAmount: '100',
+                rolloverRequired: '100',
+                rolloverProgress: '90',
+            });
+            const commandsSvc = makeCommandsSvc();
+            const walletSvc = makeWalletSvc();
+            const betPromise = db.drizzle.db.transaction((txn) => commandsSvc.debit(txn, { userId: w.userId, amount: '10', type: 'bet' }));
+            const withdrawPromise = walletSvc
+                .withdraw({
+                userId: w.userId,
+                amount: '10',
+                currency: 'USD',
+                ip: null,
+                userAgent: null,
+            })
+                .then(() => true, () => false);
+            const [betResult, withdrawSucceeded] = await Promise.all([betPromise, withdrawPromise]);
+            if (!betResult.ok) {
+                throw new Error(`trial ${trial}: expected bet debit ok`);
+            }
+            const [balRow] = await db.drizzle.db
+                .select()
+                .from(walletBalance)
+                .where(eq(walletBalance.walletId, w.id));
+            expect(Number(balRow.amount), `trial ${trial}: balance must equal 100 - bet(10) - withdraw(10 if it succeeded)`).toBe(withdrawSucceeded ? 80 : 90);
+        }
+    });
+});
+//# sourceMappingURL=bonus-rollover-concurrency.int.test.js.map

package/dist/wallet/__tests__/bonus-rollover-concurrency.int.test.js.map

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

package/dist/wallet/__tests__/bonus-rollover.int.test.d.ts

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

package/dist/wallet/__tests__/bonus-rollover.int.test.d.ts.map

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

package/dist/wallet/__tests__/bonus-rollover.int.test.js

@@ -0,0 +1,444 @@
+import { describe, it, expect, vi, beforeAll, afterAll, beforeEach } from 'vitest';
+import { findOneOrThrow } from '@openora/core/server';
+import { randomUUID } from 'node:crypto';
+import { eq, sql } from 'drizzle-orm';
+import { createTestDb } from '@openora/core/testing';
+import { mock, makeEventBus, makeAuditWriter, makeIdentityReader, makePaymentProviderRegistry, NO_CLIENT_META, } from '../../testing/mock.js';
+import { migrate } from '../migrate.js';
+import { wallet, walletBalance, walletTransaction, walletBonusCredit, walletBonusRolloverConfig, } from '../schema/index.js';
+import { WalletCommandsService } from '../service/wallet-commands.service.js';
+import { WalletService, BonusRolloverLockedError, BonusRolloverConfigNotFoundError, InsufficientBalanceError, } from '../service/wallet.service.js';
+let db;
+const unrestricted = mock({ isRestricted: vi.fn().mockResolvedValue(false) });
+async function seedWallet({ balance = '0', currency = 'USD', ...overrides } = {}) {
+    const row = findOneOrThrow(await db.drizzle.db
+        .insert(wallet)
+        .values({ userId: randomUUID(), currency, ...overrides })
+        .returning(), new Error('seedWallet: query returned no row'));
+    await db.drizzle.db
+        .insert(walletBalance)
+        .values({ walletId: row.id, currency: row.currency, amount: balance });
+    return row;
+}
+async function insertCredit(w, overrides = {}) {
+    const row = findOneOrThrow(await db.drizzle.db
+        .insert(walletBonusCredit)
+        .values({
+        walletId: w.id,
+        userId: w.userId,
+        currency: w.currency,
+        sourceType: 'gift',
+        creditedAmount: '0',
+        rolloverMultiplier: '1',
+        rolloverRequired: '0',
+        rolloverProgress: '0',
+        status: 'active',
+        ...overrides,
+    })
+        .returning(), new Error('insertCredit: query returned no row'));
+    return row;
+}
+async function creditsFor(userId) {
+    return db.drizzle.db
+        .select()
+        .from(walletBonusCredit)
+        .where(eq(walletBonusCredit.userId, userId))
+        .orderBy(walletBonusCredit.createdAt);
+}
+function makeWalletService(audit = makeAuditWriter()) {
+    return {
+        svc: new WalletService({
+            drizzle: db.drizzle,
+            events: makeEventBus(),
+            payment: mock({ processDeposit: vi.fn(), processWithdrawal: vi.fn() }),
+            paymentProviders: makePaymentProviderRegistry(),
+            identityReader: makeIdentityReader(),
+            audit,
+        }),
+        audit,
+    };
+}
+beforeAll(async () => {
+    db = await createTestDb([migrate]);
+});
+afterAll(async () => {
+    await db.drop();
+});
+beforeEach(async () => {
+    await db.drizzle.db.execute(sql `TRUNCATE ${walletTransaction}, ${walletBonusCredit}, ${walletBonusRolloverConfig}, ${wallet} RESTART IDENTITY CASCADE`);
+});
+describe('WalletCommandsService bonus credit creation on gift/rain (real PG)', () => {
+    it('creates an active credit with rolloverRequired = creditedAmount * multiplier, and audits it', async () => {
+        await db.drizzle.db
+            .insert(walletBonusRolloverConfig)
+            .values({ singletonKey: 'global', multiplier: '2' });
+        const w = await seedWallet({ balance: '0' });
+        const audit = makeAuditWriter();
+        const svc = new WalletCommandsService(unrestricted, audit);
+        const res = await svc.credit(db.drizzle.db, {
+            userId: w.userId,
+            amount: '50',
+            currency: 'USD',
+            type: 'gift',
+        });
+        expect(res.ok).toBe(true);
+        const credits = await creditsFor(w.userId);
+        expect(credits).toHaveLength(1);
+        const credit = credits[0];
+        expect(credit).toMatchObject({
+            walletId: w.id,
+            currency: 'USD',
+            sourceType: 'gift',
+            status: 'active',
+        });
+        expect(Number(credit.creditedAmount)).toBe(50);
+        expect(Number(credit.rolloverMultiplier)).toBe(2);
+        expect(Number(credit.rolloverRequired)).toBe(100);
+        expect(Number(credit.rolloverProgress)).toBe(0);
+        expect(audit.recordInTransaction).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({
+            actorType: 'system',
+            action: 'wallet.bonus_credit.created',
+            resourceType: 'wallet_bonus_credit',
+            resourceId: credit.id,
+        }));
+    });
+    it('falls back to a 1x multiplier without throwing when the config row is missing', async () => {
+        const w = await seedWallet({ balance: '0' });
+        const svc = new WalletCommandsService(unrestricted, makeAuditWriter());
+        const res = await svc.credit(db.drizzle.db, {
+            userId: w.userId,
+            amount: '25',
+            currency: 'USD',
+            type: 'rain',
+        });
+        expect(res.ok).toBe(true);
+        const credits = await creditsFor(w.userId);
+        expect(Number(credits[0].rolloverMultiplier)).toBe(1);
+        expect(Number(credits[0].rolloverRequired)).toBe(25);
+    });
+    it('never creates a bonus credit for a non gift/rain credit type', async () => {
+        await db.drizzle.db
+            .insert(walletBonusRolloverConfig)
+            .values({ singletonKey: 'global', multiplier: '2' });
+        const w = await seedWallet({ balance: '0' });
+        const svc = new WalletCommandsService(unrestricted, makeAuditWriter());
+        await svc.credit(db.drizzle.db, {
+            userId: w.userId,
+            amount: '50',
+            currency: 'USD',
+            type: 'win',
+        });
+        expect(await creditsFor(w.userId)).toHaveLength(0);
+    });
+    it('stores bonus-credit currencies using the canonical balance key', async () => {
+        const w = await seedWallet({ balance: '0', currency: 'usd' });
+        const svc = new WalletCommandsService(unrestricted, makeAuditWriter());
+        const result = await svc.credit(db.drizzle.db, {
+            userId: w.userId,
+            amount: '10',
+            currency: 'usd',
+            type: 'gift',
+        });
+        expect(result.ok).toBe(true);
+        expect((await creditsFor(w.userId))[0].currency).toBe('USD');
+    });
+});
+describe('WalletCommandsService bonus rollover progress waterfall (real PG)', () => {
+    it('drains the oldest active credit first, caps at rolloverRequired, and cascades leftover', async () => {
+        const w = await seedWallet({ balance: '1000' });
+        const older = await insertCredit(w, {
+            creditedAmount: '30',
+            rolloverRequired: '30',
+            createdAt: new Date('2026-01-01T00:00:00.000Z'),
+        });
+        const newer = await insertCredit(w, {
+            creditedAmount: '50',
+            rolloverRequired: '50',
+            createdAt: new Date('2026-01-02T00:00:00.000Z'),
+        });
+        const svc = new WalletCommandsService(unrestricted, makeAuditWriter());
+        const res1 = await svc.debit(db.drizzle.db, { userId: w.userId, amount: '40', type: 'bet' });
+        if (!res1.ok) {
+            throw new Error('expected res1.ok');
+        }
+        expect(res1.completedBonusCredits).toEqual([
+            { id: older.id, currency: 'USD', creditedAmount: older.creditedAmount },
+        ]);
+        let rows = await creditsFor(w.userId);
+        expect(rows.find((r) => r.id === older.id)).toMatchObject({ status: 'completed' });
+        expect(Number(rows.find((r) => r.id === older.id).rolloverProgress)).toBe(30);
+        expect(rows.find((r) => r.id === newer.id)).toMatchObject({ status: 'active' });
+        expect(Number(rows.find((r) => r.id === newer.id).rolloverProgress)).toBe(10);
+        const res2 = await svc.debit(db.drizzle.db, { userId: w.userId, amount: '30', type: 'bet' });
+        if (!res2.ok) {
+            throw new Error('expected res2.ok');
+        }
+        expect(res2.completedBonusCredits).toEqual([]);
+        rows = await creditsFor(w.userId);
+        expect(rows.find((r) => r.id === newer.id)).toMatchObject({ status: 'active' });
+        expect(Number(rows.find((r) => r.id === newer.id).rolloverProgress)).toBe(40);
+        const res3 = await svc.debit(db.drizzle.db, { userId: w.userId, amount: '20', type: 'bet' });
+        if (!res3.ok) {
+            throw new Error('expected res3.ok');
+        }
+        expect(res3.completedBonusCredits).toEqual([
+            { id: newer.id, currency: 'USD', creditedAmount: newer.creditedAmount },
+        ]);
+        rows = await creditsFor(w.userId);
+        const finalNewer = rows.find((r) => r.id === newer.id);
+        expect(finalNewer.status).toBe('completed');
+        expect(Number(finalNewer.rolloverProgress)).toBe(50);
+        expect(finalNewer.completedAt).toBeInstanceOf(Date);
+    });
+    it('audits each completion with its own wallet.bonus_credit.completed record', async () => {
+        const w = await seedWallet({ balance: '1000' });
+        const credit = await insertCredit(w, { creditedAmount: '10', rolloverRequired: '10' });
+        const audit = makeAuditWriter();
+        const svc = new WalletCommandsService(unrestricted, audit);
+        await svc.debit(db.drizzle.db, { userId: w.userId, amount: '10', type: 'bet' });
+        expect(audit.recordInTransaction).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({
+            actorType: 'system',
+            action: 'wallet.bonus_credit.completed',
+            resourceType: 'wallet_bonus_credit',
+            resourceId: credit.id,
+            before: { status: 'active', rolloverProgress: expect.any(String) },
+            after: {
+                userId: w.userId,
+                currency: 'USD',
+                creditedAmount: '10.000000000000000000',
+                rolloverRequired: '10.000000000000000000',
+                rolloverProgress: '10.000000000000000000',
+                status: 'completed',
+            },
+        }));
+    });
+    it('leaves an already-completed credit and a different-currency credit untouched', async () => {
+        const w = await seedWallet({ balance: '1000', currency: 'USD' });
+        const alreadyDone = await insertCredit(w, {
+            creditedAmount: '10',
+            rolloverRequired: '10',
+            rolloverProgress: '10',
+            status: 'completed',
+        });
+        const otherCurrency = await insertCredit(w, {
+            currency: 'EUR',
+            creditedAmount: '30',
+            rolloverRequired: '30',
+        });
+        const svc = new WalletCommandsService(unrestricted, makeAuditWriter());
+        const res = await svc.debit(db.drizzle.db, { userId: w.userId, amount: '30', type: 'bet' });
+        if (!res.ok) {
+            throw new Error('expected res.ok');
+        }
+        expect(res.completedBonusCredits).toEqual([]);
+        const [done] = await db.drizzle.db
+            .select()
+            .from(walletBonusCredit)
+            .where(eq(walletBonusCredit.id, alreadyDone.id));
+        expect(Number(done.rolloverProgress)).toBe(10);
+        const [eur] = await db.drizzle.db
+            .select()
+            .from(walletBonusCredit)
+            .where(eq(walletBonusCredit.id, otherCurrency.id));
+        expect(Number(eur.rolloverProgress)).toBe(0);
+    });
+    it('does not apply rollover progress for a non-bet debit type', async () => {
+        const w = await seedWallet({ balance: '1000' });
+        const credit = await insertCredit(w, { creditedAmount: '10', rolloverRequired: '10' });
+        const svc = new WalletCommandsService(unrestricted, makeAuditWriter());
+        const res = await svc.credit(db.drizzle.db, {
+            userId: w.userId,
+            amount: '10',
+            currency: 'USD',
+            type: 'win',
+        });
+        expect(res.ok).toBe(true);
+        const [row] = await db.drizzle.db
+            .select()
+            .from(walletBonusCredit)
+            .where(eq(walletBonusCredit.id, credit.id));
+        expect(Number(row.rolloverProgress)).toBe(0);
+    });
+    it('blocks non-bet debits from spending rollover-locked funds', async () => {
+        const w = await seedWallet({ balance: '100' });
+        await insertCredit(w, {
+            creditedAmount: '100',
+            rolloverRequired: '1000',
+        });
+        const svc = new WalletCommandsService(unrestricted, makeAuditWriter());
+        const result = await svc.debit(db.drizzle.db, {
+            userId: w.userId,
+            amount: '1',
+            type: 'gift',
+        });
+        expect(result.ok).toBe(false);
+        if (result.ok) {
+            throw new Error('expected locked debit to fail');
+        }
+        expect(Number(result.available)).toBe(100);
+        expect(await creditsFor(w.userId)).toHaveLength(1);
+        const [balance] = await db.drizzle.db
+            .select()
+            .from(walletBalance)
+            .where(eq(walletBalance.walletId, w.id));
+        expect(balance.amount).toBe('100.000000000000000000');
+    });
+});
+describe('WalletService.withdraw with an active bonus rollover lock (real PG)', () => {
+    it('locks only the proportional credited amount when the multiplier exceeds 1x', async () => {
+        const w = await seedWallet({ balance: '100' });
+        await insertCredit(w, {
+            creditedAmount: '100',
+            rolloverRequired: '1000',
+            rolloverProgress: '500',
+        });
+        const { svc } = makeWalletService();
+        await expect(svc.withdraw({ userId: w.userId, amount: '51', currency: 'USD', ip: null, userAgent: null })).rejects.toBeInstanceOf(BonusRolloverLockedError);
+        const result = await svc.withdraw({
+            userId: w.userId,
+            amount: '50',
+            currency: 'USD',
+            ip: null,
+            userAgent: null,
+        });
+        expect(result.status).toBe('pending');
+    });
+    it('blocks a withdrawal once the requested amount exceeds the withdrawable (unlocked) balance', async () => {
+        const w = await seedWallet({ balance: '100' });
+        await insertCredit(w, {
+            creditedAmount: '100',
+            rolloverRequired: '100',
+            rolloverProgress: '20',
+        });
+        const { svc } = makeWalletService();
+        await expect(svc.withdraw({ userId: w.userId, amount: '50', currency: 'USD', ip: null, userAgent: null })).rejects.toBeInstanceOf(BonusRolloverLockedError);
+        const [bal] = await db.drizzle.db
+            .select()
+            .from(walletBalance)
+            .where(eq(walletBalance.walletId, w.id));
+        expect(Number(bal.amount)).toBe(100);
+    });
+    it('allows a withdrawal within the unlocked portion and debits exactly that amount', async () => {
+        const w = await seedWallet({ balance: '100' });
+        await insertCredit(w, {
+            creditedAmount: '100',
+            rolloverRequired: '100',
+            rolloverProgress: '20',
+        });
+        const { svc } = makeWalletService();
+        const res = await svc.withdraw({
+            userId: w.userId,
+            amount: '20',
+            currency: 'USD',
+            ip: null,
+            userAgent: null,
+        });
+        expect(res.status).toBe('pending');
+        const [bal] = await db.drizzle.db
+            .select()
+            .from(walletBalance)
+            .where(eq(walletBalance.walletId, w.id));
+        expect(Number(bal.amount)).toBe(80);
+    });
+    it('allows a full-balance withdrawal once the bonus credit has completed', async () => {
+        const w = await seedWallet({ balance: '100' });
+        await insertCredit(w, {
+            creditedAmount: '100',
+            rolloverRequired: '100',
+            rolloverProgress: '100',
+            status: 'completed',
+        });
+        const { svc } = makeWalletService();
+        const res = await svc.withdraw({
+            userId: w.userId,
+            amount: '100',
+            currency: 'USD',
+            ip: null,
+            userAgent: null,
+        });
+        expect(res.status).toBe('pending');
+        const [bal] = await db.drizzle.db
+            .select()
+            .from(walletBalance)
+            .where(eq(walletBalance.walletId, w.id));
+        expect(Number(bal.amount)).toBe(0);
+    });
+    it('still reports InsufficientBalanceError (not the bonus-lock error) when the raw balance itself is short', async () => {
+        const w = await seedWallet({ balance: '10' });
+        const { svc } = makeWalletService();
+        await expect(svc.withdraw({ userId: w.userId, amount: '50', currency: 'USD', ip: null, userAgent: null })).rejects.toBeInstanceOf(InsufficientBalanceError);
+    });
+});
+describe('WalletService bonus rollover status (real PG)', () => {
+    it('returns active credits by default and completed credits when requested', async () => {
+        const w = await seedWallet({ balance: '0' });
+        await insertCredit(w, { status: 'active' });
+        await insertCredit(w, { status: 'completed', completedAt: new Date() });
+        const { svc } = makeWalletService();
+        const active = await svc.getBonusRolloverStatus(w.userId);
+        const completed = await svc.getBonusRolloverStatus(w.userId, 'completed');
+        expect(active.credits).toHaveLength(1);
+        expect(active.credits[0].status).toBe('active');
+        expect(completed.credits).toHaveLength(1);
+        expect(completed.credits[0].status).toBe('completed');
+    });
+});
+describe('WalletService bonus rollover config admin (real PG)', () => {
+    it('fails closed (NotFound) on GET when unseeded', async () => {
+        const { svc } = makeWalletService();
+        await expect(svc.getBonusRolloverConfig()).rejects.toBeInstanceOf(BonusRolloverConfigNotFoundError);
+        expect(await svc.getBonusRolloverConfigOrNull()).toBeNull();
+    });
+    it('self-heals a missing singleton row on first SET and audits a null-before change', async () => {
+        const { svc, audit } = makeWalletService();
+        const adminId = randomUUID();
+        const config = await svc.setBonusRolloverConfig(adminId, { multiplier: '3' }, NO_CLIENT_META);
+        expect(Number(config.multiplier)).toBe(3);
+        expect(await svc.getBonusRolloverConfig()).toMatchObject({ id: config.id });
+        expect(audit.recordInTransaction).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({
+            actorId: adminId,
+            actorType: 'admin',
+            action: 'wallet.bonus_rollover_config.set',
+            resourceType: 'bonus_rollover_config',
+            before: null,
+            after: { multiplier: config.multiplier },
+        }));
+    });
+    it('updates the existing singleton row (one row total) and audits a before/after diff', async () => {
+        await db.drizzle.db
+            .insert(walletBonusRolloverConfig)
+            .values({ singletonKey: 'global', multiplier: '1' });
+        const { svc, audit } = makeWalletService();
+        const adminId = randomUUID();
+        const [before] = await db.drizzle.db.select().from(walletBonusRolloverConfig);
+        await new Promise((resolve) => setTimeout(resolve, 2));
+        const updated = await svc.setBonusRolloverConfig(adminId, { multiplier: '2' }, NO_CLIENT_META);
+        expect(Number(updated.multiplier)).toBe(2);
+        expect(Date.parse(updated.updatedAt)).toBeGreaterThan(before.updatedAt.getTime());
+        expect(await db.drizzle.db.select().from(walletBonusRolloverConfig)).toHaveLength(1);
+        expect(audit.recordInTransaction).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({
+            action: 'wallet.bonus_rollover_config.set',
+            before: expect.objectContaining({ multiplier: expect.any(String) }),
+            after: { multiplier: updated.multiplier },
+        }));
+    });
+    it('does not retroactively change the multiplier already snapshotted on an existing bonus credit', async () => {
+        await db.drizzle.db
+            .insert(walletBonusRolloverConfig)
+            .values({ singletonKey: 'global', multiplier: '1' });
+        const w = await seedWallet({ balance: '0' });
+        const commandsSvc = new WalletCommandsService(unrestricted, makeAuditWriter());
+        await commandsSvc.credit(db.drizzle.db, {
+            userId: w.userId,
+            amount: '10',
+            currency: 'USD',
+            type: 'gift',
+        });
+        const { svc } = makeWalletService();
+        await svc.setBonusRolloverConfig(randomUUID(), { multiplier: '5' }, NO_CLIENT_META);
+        const [credit] = await creditsFor(w.userId);
+        expect(Number(credit.rolloverMultiplier)).toBe(1);
+        expect(Number(credit.rolloverRequired)).toBe(10);
+    });
+});
+//# sourceMappingURL=bonus-rollover.int.test.js.map