26 lines
811 B
PHP
26 lines
811 B
PHP
<?php
|
|||
|
|
declare( strict_types=1 );
|
||
|
|
|
||
|
|
namespace StreamGoals\Overlay;
|
||
|
|
|
||
|
|
/** Optional capability: configurable alert media (definitions, triggered rewards, attachment lookup). */
|
||
|
|
interface AlertMediaSource {
|
||
|
|
|
||
|
|
/** Enabled alert definitions, raw rows. Called at most once per request. */
|
||
|
|
public function alertDefs(): array;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Rewards triggered per donation, one lookup for the whole page.
|
||
|
|
*
|
||
|
|
* @param int[] $donationIds
|
||
|
|
* @return array<int,array<int,array{action_id:int,amount_minor:int,title:string}>> donation id => rewards
|
||
|
|
*/
|
||
|
|
public function triggeredActionsFor( array $donationIds ): array;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Server-side attachment lookup (the only place media URLs come from). Null when it is gone.
|
||
|
|
*
|
||
|
|
* @return array{url:string,mime:string}|null
|
||
|
|
*/
|
||
|
|
public function attachment( int $id ): ?array;
|
||
|
|
}
|