d3ro-voice/apps/desktop/tests/unit/AdMediationEngine.test.ts
Yun Chan 7fe49c437e chore: land in-progress workspace changes before 1.16.2
The tree carried uncommitted work from several areas (web push, mobile
screens, admin charts, test-hygiene cleanup, CI and map docs). It is landed
as one commit so the release pipeline can start from a clean tree; the
desktop transcript-correction behaviour shipped in the previous commit and
is unchanged here.
2026-11-05 21:58:44 +09:00

363 lines
12 KiB
TypeScript

import { beforeEach, describe, expect, it, vi } from 'vitest'
import { Feature, type AdMediationConfig } from '@d3ro/core/types'
import { getAdMediationEngine } from '../../src/main/services/ads/AdMediationEngine'
import { getAdSettlementService } from '../../src/main/services/ads/AdSettlementService'
import { getLicenseService } from '../../src/main/services/LicenseService'
import { EthicalAdsAdapter } from '../../src/main/services/ads/EthicalAdsAdapter'
import { CarbonAdsAdapter } from '../../src/main/services/ads/CarbonAdsAdapter'
import { PlaywireAdapter } from '../../src/main/services/ads/PlaywireAdapter'
import { UnityAdsAdapter } from '../../src/main/services/ads/UnityAdsAdapter'
import { AppLovinAdapter } from '../../src/main/services/ads/AppLovinAdapter'
import { GoogleAdManagerAdapter } from '../../src/main/services/ads/GoogleAdManagerAdapter'
import { InMobiAdapter } from '../../src/main/services/ads/InMobiAdapter'
import { PubMaticAdapter } from '../../src/main/services/ads/PubMaticAdapter'
import { MintegralAdapter } from '../../src/main/services/ads/MintegralAdapter'
import { DirectHouseSponsorAdapter } from '../../src/main/services/ads/DirectHouseSponsorAdapter'
const adapterCases = [
['EthicalAds', new EthicalAdsAdapter()],
['Carbon Ads', new CarbonAdsAdapter()],
['Playwire', new PlaywireAdapter()],
['Unity Ads', new UnityAdsAdapter()],
['AppLovin', new AppLovinAdapter()],
['Google Ad Manager', new GoogleAdManagerAdapter()],
['InMobi', new InMobiAdapter()],
['PubMatic', new PubMaticAdapter()],
['Mintegral', new MintegralAdapter()],
] as const
describe('desktop ad provider boundaries', () => {
it.each(adapterCases)('%s returns no bid until a real provider is integrated', async (_name, adapter) => {
await adapter.init()
const bid = await adapter.requestBid({
placement: adapter.supportedFormats.includes('rewarded_video')
? 'rewarded_video_quota'
: 'bottom_dock_banner',
format: adapter.supportedFormats[0],
})
expect(bid).toEqual({
hasBid: false,
bidEcpm: 0,
latencyMs: 0,
error: 'provider_not_integrated',
})
await expect(adapter.reportRewardCompletion('forged-ad-id')).resolves.toEqual({
success: false,
tokenReward: 0,
})
})
})
describe('DirectHouseSponsorAdapter live decision endpoint', () => {
it('is fail-closed until an endpoint is configured', async () => {
const adapter = new DirectHouseSponsorAdapter()
await adapter.init()
const bid = await adapter.requestBid({ placement: 'bottom_dock_banner', format: 'banner_dock' })
expect(bid).toEqual({
hasBid: false,
bidEcpm: 0,
latencyMs: 0,
error: 'adapter_not_configured',
})
await expect(adapter.reportRewardCompletion('forged-ad-id')).resolves.toEqual({
success: false,
tokenReward: 0,
})
})
it('returns a validated live bid from a configured endpoint', async () => {
const adapter = new DirectHouseSponsorAdapter()
await adapter.init({ endpointUrl: 'https://ads.example.com', apiSecret: 'secret' })
const fetchMock = vi.fn().mockResolvedValue(
new Response(
JSON.stringify({
bidEcpm: 9.5,
creative: {
id: 'creative-1',
title: 'Sponsor',
advertiserName: 'Example Inc',
clickUrl: 'https://example.com/offer',
format: 'banner_dock',
},
}),
{ status: 200 },
),
)
vi.stubGlobal('fetch', fetchMock)
try {
const bid = await adapter.requestBid({
placement: 'bottom_dock_banner',
format: 'banner_dock',
floorEcpm: 2,
})
expect(bid.hasBid).toBe(true)
expect(bid.bidEcpm).toBe(9.5)
expect(bid.creative?.networkId).toBe('direct_sponsor')
expect(bid.creative?.clickUrl).toBe('https://example.com/offer')
const [url, init] = fetchMock.mock.calls[0] as [string, RequestInit]
expect(String(url)).toBe('https://ads.example.com/bid')
expect(init.headers).toMatchObject({ Authorization: 'Bearer secret' })
} finally {
vi.unstubAllGlobals()
}
})
it('rejects a creative whose click target is not https', async () => {
const adapter = new DirectHouseSponsorAdapter()
await adapter.init({ endpointUrl: 'https://ads.example.com' })
vi.stubGlobal(
'fetch',
vi.fn().mockResolvedValue(
new Response(
JSON.stringify({
bidEcpm: 9.5,
creative: {
id: 'c',
title: 't',
advertiserName: 'a',
clickUrl: 'http://insecure.example.com',
format: 'banner_dock',
},
}),
{ status: 200 },
),
),
)
try {
const bid = await adapter.requestBid({
placement: 'bottom_dock_banner',
format: 'banner_dock',
})
expect(bid.hasBid).toBe(false)
expect(bid.error).toBe('invalid_creative')
} finally {
vi.unstubAllGlobals()
}
})
})
describe('AdMediationEngine fail-closed auction and telemetry', () => {
const engine = getAdMediationEngine()
const settlement = getAdSettlementService()
const knownNetworks = engine.getConfig().networks
let disabledNetworks: AdMediationConfig['networks']
beforeEach(() => {
disabledNetworks = knownNetworks.map((network) => ({
...network,
enabled: false,
}))
engine.setConfig({ networks: disabledNetworks, houseAdFallback: false })
})
it('returns a real no-fill result instead of inventing a winner', async () => {
const result = await engine.runAuction({
placement: 'bottom_dock_banner',
format: 'banner_dock',
floorEcpm: 2,
auctionTimeoutMs: 800,
})
expect(result.winner).toBeNull()
expect(result.winningBidEcpm).toBe(0)
expect(result.participatingBids).toEqual([])
expect(result.totalAuctionLatencyMs).toBeGreaterThanOrEqual(0)
})
it('keeps provider shells no-bid even if an operator enables them prematurely', async () => {
engine.setConfig({
networks: disabledNetworks.map((network) => ({ ...network, enabled: true })),
})
const result = await engine.runAuction({
placement: 'bottom_dock_banner',
format: 'banner_dock',
floorEcpm: 0.01,
auctionTimeoutMs: 800,
})
expect(result.winner).toBeNull()
expect(result.winningBidEcpm).toBe(0)
expect(result.participatingBids.length).toBeGreaterThan(0)
expect(result.participatingBids.every((bid) => bid.status === 'no_bid')).toBe(true)
})
it('does not enable an adapter merely because its config entry is omitted', async () => {
engine.setConfig({ networks: [] })
const result = await engine.runAuction({
placement: 'bottom_dock_banner',
format: 'banner_dock',
})
expect(result.winner).toBeNull()
expect(result.participatingBids).toEqual([])
})
it('returns a defensive config copy', () => {
const exposedConfig = engine.getConfig()
exposedConfig.networks[0].enabled = true
expect(engine.getConfig().networks[0].enabled).toBe(false)
})
it('ignores renderer-forged impressions and clicks', () => {
const before = settlement.getRevenueStats('2026-08')
engine.recordImpression({
adId: 'forged-ad-id',
format: 'banner_dock',
network: 'ethical_ads',
earnedEcpm: 999,
})
engine.recordClick('forged-ad-id', 'ethical_ads')
const after = settlement.getRevenueStats('2026-08')
expect(after.totalImpressions).toBe(before.totalImpressions)
expect(after.totalClicks).toBe(before.totalClicks)
expect(after.totalRevenueUsd).toBe(before.totalRevenueUsd)
})
it('never grants desktop quota without server-verified completion', async () => {
await expect(engine.claimReward('forged-reward-id', 'unity_ads')).resolves.toEqual({
success: false,
tokensAdded: 0,
newTotalQuota: 0,
})
})
})
describe('AdSettlementService fail-closed ledger', () => {
const settlement = getAdSettlementService()
it('does not ship personal payout details or pretend providers are configured', () => {
expect(settlement.getPublisherAccount()).toEqual({
accountEmail: '',
beneficiaryName: '',
payoutBank: '',
payoutAccountNumber: '',
taxRegistrationNumber: '',
paypalEmail: '',
networksConfigured: 0,
})
})
it('does not synthesize revenue, fill rate, or settlement history', () => {
const stats = settlement.getRevenueStats('2026-08')
expect(stats.totalImpressions).toBe(0)
expect(stats.totalClicks).toBe(0)
expect(stats.totalCompletions).toBe(0)
expect(stats.totalRevenueUsd).toBe(0)
expect(stats.avgEcpm).toBe(0)
expect(stats.fillRatePercent).toBe(0)
expect(stats.networkBreakdown).toEqual([])
expect(stats.settlements).toEqual([])
})
it('rejects payout without an external settlement provider', () => {
expect(settlement.requestPayout('forged-settlement-id')).toEqual({
success: false,
message: 'external_settlement_not_configured',
})
})
it('ignores invalid or unattested settlement events', () => {
const before = settlement.getRevenueStats('2026-08')
settlement.recordImpression('', 10)
settlement.recordImpression('forged-network', Number.NaN)
settlement.recordImpression('forged-network', -10)
settlement.recordClick('forged-network')
settlement.recordCompletion('forged-network')
expect(settlement.getRevenueStats('2026-08')).toEqual(before)
})
})
describe('GAP-ADS-02 rewarded quota integration', () => {
const engine = getAdMediationEngine()
const knownNetworks = engine.getConfig().networks
it('grants LicenseService bonus quota on verified rewarded ad completion and blocks replay', async () => {
const license = getLicenseService()
const baseQuota = license.getUsage(Feature.PREMIUM_LLM)
engine.setConfig({
rewardTokensAmount: 50,
rewardCooldownSeconds: 0,
networks: knownNetworks.map((n) =>
n.id === 'direct_sponsor'
? {
...n,
enabled: true,
endpointUrl: 'https://ads.example.com',
apiSecret: 'secret',
}
: { ...n, enabled: false },
),
})
const fetchMock = vi
.fn()
.mockResolvedValueOnce(
new Response(
JSON.stringify({
bidEcpm: 15,
creative: {
id: 'rewarded-ad-1',
title: 'Rewarded Video',
advertiserName: 'D3RO Partner',
clickUrl: 'https://example.com/reward',
format: 'rewarded_video',
rewardTokens: 50,
durationSeconds: 15,
},
}),
{ status: 200 },
),
)
.mockResolvedValueOnce(new Response(JSON.stringify({ ok: true }), { status: 200 }))
.mockResolvedValueOnce(
new Response(JSON.stringify({ success: true, tokenReward: 50 }), { status: 200 }),
)
vi.stubGlobal('fetch', fetchMock)
try {
const auction = await engine.runAuction({
placement: 'rewarded_video_quota',
format: 'rewarded_video',
floorEcpm: 4,
})
expect(auction.winner?.id).toBe('rewarded-ad-1')
engine.recordImpression({
adId: 'rewarded-ad-1',
format: 'rewarded_video',
network: 'direct_sponsor',
earnedEcpm: auction.winningBidEcpm,
})
const claim = await engine.claimReward('rewarded-ad-1', 'direct_sponsor', 'nonce-1')
expect(claim.success).toBe(true)
expect(claim.tokensAdded).toBe(50)
expect(claim.newTotalQuota).toBe(baseQuota.limit + 50)
expect(license.getUsage(Feature.PREMIUM_LLM).limit).toBe(baseQuota.limit + 50)
// Replay with same adId or nonce is rejected
const replay = await engine.claimReward('rewarded-ad-1', 'direct_sponsor', 'nonce-1')
expect(replay).toEqual({
success: false,
tokensAdded: 0,
newTotalQuota: 0,
})
} finally {
vi.unstubAllGlobals()
engine.setConfig({
networks: knownNetworks.map((n) => ({ ...n, enabled: false })),
})
}
})
})