Files
wp-donations/tests/Unit/RulesEngineTest.php
T
2026-11-15 08:44:52 -08:00

138 lines
5.2 KiB
PHP

<?php
declare( strict_types=1 );
namespace StreamGoals\Tests\Unit;
use PHPUnit\Framework\TestCase;
use StreamGoals\Rules\Donation;
use StreamGoals\Rules\Engine;
use StreamGoals\Rules\RuleDef;
final class RulesEngineTest extends TestCase {
private FakeStateRepository $state;
private FakeEventStore $events;
private int $now = 1000;
private array $fired = array();
private function engine( array $rules ): Engine {
$this->state = new FakeStateRepository();
$this->events = new FakeEventStore();
return new Engine(
new FakeRuleStore( $rules ),
$this->events,
$this->state,
fn(): int => $this->now,
function ( string $e, RuleDef $r, Donation $d, bool $rev ): void {
$this->fired[] = array( $e, $d->id, $rev );
}
);
}
private function d( int $id, int $base, string $cur = 'USD' ): Donation {
return new Donation( $id, 1, $base, 0, $base, $cur );
}
private function timer( array $extra = array() ): RuleDef {
return new RuleDef( 1, 1, 'add_time', $extra + array( 'seconds_per_unit' => 60, 'unit_minor' => 100 ) );
}
private function counter( array $extra = array() ): RuleDef {
return new RuleDef( 2, 1, 'counter', $extra + array( 'step' => 1, 'per_minor' => 1000, 'carry_over' => true ) );
}
public function test_apply_persists_timer_counter_and_events(): void {
$e = $this->engine( array( $this->timer(), $this->counter() ) );
$e->applyDonation( $this->d( 10, 2500 ) );
$this->assertSame( 1000 + 1500, $this->state->getInt( 1, 'timer_ends_at' ) );
$this->assertSame( 2, $this->state->getInt( 1, 'counter:2' ) );
$this->assertSame( 500, $this->state->getInt( 1, 'carry:2' ) );
$this->assertSame( 1500, $this->events->events['1:10'][0] );
}
public function test_replay_is_idempotent(): void {
$e = $this->engine( array( $this->timer(), $this->counter() ) );
$d = $this->d( 10, 2500 );
$e->applyDonation( $d );
$snapshot = $this->state->data;
$e->applyDonation( $d );
$e->applyDonation( $d );
$this->assertSame( $snapshot, $this->state->data );
}
public function test_expired_timer_restarts_from_now(): void {
$e = $this->engine( array( $this->timer() ) );
$this->state->setInt( 1, 'timer_ends_at', 10 );
$e->applyDonation( $this->d( 10, 100 ) );
$this->assertSame( 1060, $this->state->getInt( 1, 'timer_ends_at' ) );
}
public function test_running_timer_extends(): void {
$e = $this->engine( array( $this->timer() ) );
$this->state->setInt( 1, 'timer_ends_at', 5000 );
$e->applyDonation( $this->d( 10, 100 ) );
$this->assertSame( 5060, $this->state->getInt( 1, 'timer_ends_at' ) );
}
public function test_max_total_across_donations(): void {
$e = $this->engine( array( $this->timer( array( 'max_total_seconds' => 100 ) ) ) );
$e->applyDonation( $this->d( 1, 100 ) );
$e->applyDonation( $this->d( 2, 100 ) );
$this->assertSame( 1000 + 100, $this->state->getInt( 1, 'timer_ends_at' ) );
}
public function test_reversal_undoes_and_is_not_double_applied(): void {
$e = $this->engine( array( $this->timer(), $this->counter() ) );
$d = $this->d( 10, 2500 );
$e->applyDonation( $d );
$e->reverseDonation( $d );
$e->reverseDonation( $d );
$this->assertSame( 1000, $this->state->getInt( 1, 'timer_ends_at' ) );
$this->assertSame( 0, $this->state->getInt( 1, 'counter:2' ) );
$this->assertSame( 0, $this->state->getInt( 1, 'carry:2' ) );
}
public function test_reversal_never_below_floor(): void {
$e = $this->engine( array( $this->timer(), $this->counter() ) );
$d = $this->d( 10, 2500 );
$e->applyDonation( $d );
$this->state->setInt( 1, 'counter:2', 1 ); // already lower than the delta
$this->now = 5000; // timer long expired
$e->reverseDonation( $d );
$this->assertSame( 0, $this->state->getInt( 1, 'counter:2' ) );
$this->assertSame( 2500, $this->state->getInt( 1, 'timer_ends_at' ) ); // untouched, not pushed below
}
public function test_reverse_on_refund_false_is_honored(): void {
$e = $this->engine( array( $this->counter( array( 'reverse_on_refund' => false ) ) ) );
$d = $this->d( 10, 2000 );
$e->applyDonation( $d );
$e->reverseDonation( $d );
$this->assertSame( 2, $this->state->getInt( 1, 'counter:2' ) );
}
public function test_reverse_unapplied_donation_is_noop(): void {
$e = $this->engine( array( $this->counter() ) );
$this->state->setInt( 1, 'counter:2', 5 );
$e->reverseDonation( $this->d( 99, 5000 ) );
$this->assertSame( 5, $this->state->getInt( 1, 'counter:2' ) );
}
public function test_bonus_fires_once_and_zero_decimal_currency(): void {
$bonus = new RuleDef( 3, 1, 'bonus', array( 'min_minor' => 5000, 'event' => 'big_donation' ) );
$e = $this->engine( array( $bonus, $this->counter( array( 'per_minor' => 1000 ) ) ) );
$d = $this->d( 7, 6000, 'JPY' );
$e->applyDonation( $d );
$e->applyDonation( $d );
$this->assertSame( array( array( 'big_donation', 7, false ) ), $this->fired );
$this->assertSame( 6, $this->state->getInt( 1, 'counter:2' ) );
}
public function test_bad_config_does_not_block_other_rules(): void {
$bad = new RuleDef( 9, 1, 'add_time', array( 'seconds_per_unit' => 1, 'unit_minor' => 0 ) );
$e = $this->engine( array( $bad, $this->counter() ) );
$e->applyDonation( $this->d( 1, 1000 ) );
$this->assertSame( 1, $this->state->getInt( 1, 'counter:2' ) );
}
}