2026-11-15 13:01:31 -08:00
<? 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.
*
2026-11-15 13:41:18 -08:00
* @return array{url:string,mime:string,v?:int,modified?:string}|null (v = file mtime, modified = post_modified_gmt; used only for the ?v= cache-bust suffix)
2026-11-15 13:01:31 -08:00
*/
public function attachment ( int $id ) : ? array ;
}