Compare commits

...
Author SHA1 Message Date
shadowdaoandClaude Sonnet 5.5 4cec93067c Add in-WordPress updater: checks Gitea releases, one-click and auto updates
Test and Release / test (push) Successful in 1m15s
Test and Release / release (push) Successful in 7s
- Update\ReleaseParser (pure, host-pinned, https only) and Update\Updater (WP hooks, cached, failure-safe)
- Settings: optional access token for a private repo, 'Check for updates now'

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-15 11:53:42 -08:00
shadowdaoandClaude Sonnet 5.5 27646c1001 Fix Rules screen crash: Store::rules() discarded decoded config (by-ref foreach over a cast copy)
Test and Release / test (push) Successful in 1m14s
Test and Release / release (push) Successful in 5s
Also make an unreadable rule non-fatal on the Rules screen, and add a regression test.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-15 11:47:13 -08:00
10 changed files with 520 additions and 3 deletions

No files matched your search

+6
View File
@@ -55,6 +55,12 @@ with the Live credentials and switch the mode to Live in Settings.
- **Refunds and chargebacks are not tracked.** If you refund someone in PayPal, goal totals, timers and
counters are not adjusted.
## Updates
New versions appear in WordPress automatically (Dashboard > Updates and the Plugins screen). If the update
repository is private, paste an access token with read access to releases in
StreamGoals > Settings > Advanced > Plugin updates. You can switch automatic updates on or off for this plugin
on the Plugins screen.
## Development
```
composer install
+7 -1
View File
@@ -197,7 +197,13 @@ final class GoalsPage {
foreach ( $rules as $r ) {
$rid = (int) $r['id'];
echo '<tr class="' . ( $r['enabled'] ? '' : 'sg-off' ) . '"><td>' . esc_html( RuleConfig::TYPES[ $r['type'] ] ?? (string) $r['type'] ) . ( $r['enabled'] ? '' : ' <em>(off)</em>' ) . '</td>';
echo '<td>' . esc_html( RuleConfig::summary( (string) $r['type'], $r['config'], $cur ) ) . '</td><td class="sg-actions">';
try {
$summary = RuleConfig::summary( (string) $r['type'], $r['config'], $cur );
} catch ( \Throwable $e ) {
// One unreadable rule must not take down the whole screen; say what is wrong so it can be fixed or deleted.
$summary = 'Could not read this rule (' . $e->getMessage() . '). You can delete it and add it again.';
}
echo '<td>' . esc_html( $summary ) . '</td><td class="sg-actions">';
echo '<a class="button" href="' . esc_url( Admin::url( Admin::HOME, array( 'view' => 'rules', 'goal' => $goalId, 'rule' => $rid ) ) ) . '#sg-rule-form">Edit</a> ';
Admin::form( 'sg_rule_toggle', array( 'goal_id' => $goalId, 'rule_id' => $rid, 'enabled' => $r['enabled'] ? 0 : 1 ), 'sg-inline' );
echo '<button class="button">' . ( $r['enabled'] ? 'Turn off' : 'Turn on' ) . '</button></form> ';
+14
View File
@@ -60,11 +60,21 @@ final class SettingsPage {
self::ipDiagnostics( (string) $s['visitor_ip_header'] );
echo '</td></tr></table></div>';
$rel = \StreamGoals\Update\Updater::latest();
echo '<div class="sg-card"><h2>Plugin updates</h2><table class="form-table" role="presentation">';
echo '<tr><th scope="row">Installed version</th><td><code>' . esc_html( STREAMGOALS_VERSION ) . '</code></td></tr>';
echo '<tr><th scope="row">Latest release</th><td>' . ( $rel ? '<code>' . esc_html( $rel['version'] ) . '</code>' . ( \StreamGoals\Update\ReleaseParser::isNewer( $rel['version'], STREAMGOALS_VERSION ) ? ' (update available)' : ' (up to date)' ) : 'Not found yet (or the check failed).' ) . ' <button type="submit" form="sg_update_check_form" class="button">Check for updates now</button></td></tr>';
echo '<tr><th scope="row"><label for="sg_utoken">Access token (only needed while the update repository is private)</label></th><td><input type="password" id="sg_utoken" name="update_token" class="regular-text code" autocomplete="new-password" spellcheck="false" value="" placeholder="' . esc_attr( '' !== (string) $s['update_token'] ? Input::maskSecret( (string) $s['update_token'] ) : 'Paste a read-only token' ) . '">';
echo '<p class="description">' . ( '' !== (string) $s['update_token'] ? 'A token is saved. Leave this empty to keep it, or paste a new one to replace it.' : 'Not needed once the repository is public.' ) . '</p></td></tr></table></div>';
echo '<div class="sg-card"><h2>PayPal fee estimate</h2>';
echo '<p>When a donor chooses "cover the fees", the form adds the estimated PayPal fee so you receive the amount they intended. The defaults (<strong>3.49% + $0.49</strong>) are <strong>US domestic estimates</strong>. Fees for international (cross-border) payments and currency conversion are higher and are <strong>not</strong> included, so you may receive slightly less than expected in those cases. Check PayPal\'s current fee page for your country and adjust.</p>';
echo '<table class="form-table" role="presentation"><tr><th scope="row"><label for="sg_pct">Percentage fee</label></th><td><input type="text" id="sg_pct" name="fee_percent" class="small-text" inputmode="decimal" value="' . esc_attr( number_format( (int) $s['fee_percent_bps'] / 100, 2, '.', '' ) ) . '"> %</td></tr>';
echo '<tr><th scope="row"><label for="sg_fix">Fixed fee (' . esc_html( $cur ) . ')</label></th><td><input type="text" id="sg_fix" name="fee_fixed" class="small-text" inputmode="decimal" value="' . esc_attr( Format::decimal( (int) $s['fee_fixed_minor'], $cur ) ) . '"></td></tr></table></div>';
echo '<p><button class="button button-primary button-hero">Save settings</button></p></form>';
echo '<form id="sg_update_check_form" method="post" action="' . esc_url( admin_url( 'admin-post.php' ) ) . '"><input type="hidden" name="action" value="' . esc_attr( \StreamGoals\Update\Updater::ACTION_CHECK ) . '">';
wp_nonce_field( \StreamGoals\Update\Updater::ACTION_CHECK );
echo '</form>';
Admin::close();
}
@@ -129,6 +139,10 @@ final class SettingsPage {
} else {
$upd['visitor_ip_header'] = $ipMode;
}
$tok = $post['update_token'] ?? '';
if ( ! Input::secretUnchanged( is_string( $tok ) ? $tok : '' ) ) {
$upd['update_token'] = Input::text( $tok, 300 );
}
$upd['funding_card'] = ! empty( $post['funding_card'] );
$upd['funding_paylater'] = ! empty( $post['funding_paylater'] );
$upd['moderate_messages'] = ! empty( $post['moderate_messages'] );
+5 -2
View File
@@ -26,11 +26,14 @@ final class Store {
public static function rules( int $goalId ): array {
global $wpdb;
$rows = $wpdb->get_results( $wpdb->prepare( 'SELECT * FROM ' . self::t( 'rules' ) . ' WHERE goal_id = %d ORDER BY sort ASC, id ASC', $goalId ), ARRAY_A );
foreach ( (array) $rows as &$r ) {
$rows = (array) $rows;
// Iterate $rows itself by reference: `foreach ( (array) $rows as &$r )` would modify a temporary copy and discard the decoding.
foreach ( $rows as &$r ) {
$cfg = json_decode( (string) $r['config'], true );
$r['config'] = is_array( $cfg ) ? $cfg : array();
}
return (array) $rows;
unset( $r );
return $rows;
}
public static function rule( int $ruleId, int $goalId ): ?array {
+1
View File
@@ -14,6 +14,7 @@ final class Plugin {
\StreamGoals\Rest\WebhookController::class,
\StreamGoals\Rest\OverlayController::class,
\StreamGoals\Admin\Admin::class,
\StreamGoals\Update\Updater::class,
);
public static function boot(): void {
+1
View File
@@ -37,6 +37,7 @@ final class Settings {
'overlay_token' => '',
'visitor_ip_header' => '', // '' | cloudflare | real_ip | forwarded (see Core\ClientIp)
'funding_paylater' => false, // show PayPal "Pay Later" button
'update_token' => '', // optional Gitea read token (only while the update repo is private)
'funding_card' => true, // show the Debit/Credit Card button
);
}
+137
View File
@@ -0,0 +1,137 @@
<?php
declare( strict_types=1 );
namespace StreamGoals\Update;
/**
* Pure (WordPress-free) parsing of a Gitea release payload.
*/
final class ReleaseParser {
public const ASSET_NAME = 'streamgoals-donate.zip';
private const DATE_TAG = '/^\d{4}\.\d{2}\.\d{2}-\d{4}$/';
private const SEMVER = '/^\d+\.\d+\.\d+$/';
/**
* @param array $release Decoded Gitea release JSON.
* @param string $host The only host a package URL may point to (e.g. repo.anhonesthost.net).
* @return array{version:string,package:string,url:string,notes:string,published:string}|null
*/
public static function parse( array $release, string $host ): ?array {
if ( ! empty( $release['draft'] ) || ! empty( $release['prerelease'] ) ) {
return null;
}
$version = self::normalizeVersion( $release['tag_name'] ?? null );
if ( null === $version ) {
return null;
}
$assets = isset( $release['assets'] ) && is_array( $release['assets'] ) ? $release['assets'] : array();
$package = self::pickPackage( $assets, $host );
if ( null === $package ) {
return null;
}
$url = $release['html_url'] ?? '';
return array(
'version' => $version,
'package' => $package,
'url' => is_string( $url ) && self::isAllowedUrl( $url, $host ) ? $url : '',
'notes' => is_string( $release['body'] ?? null ) ? $release['body'] : '',
'published' => is_string( $release['published_at'] ?? null ) ? $release['published_at'] : '',
);
}
public static function normalizeVersion( mixed $tag ): ?string {
if ( ! is_string( $tag ) ) {
return null;
}
$t = trim( $tag );
if ( '' !== $t && ( 'v' === $t[0] || 'V' === $t[0] ) ) {
$t = substr( $t, 1 );
}
return 1 === preg_match( self::DATE_TAG, $t ) || 1 === preg_match( self::SEMVER, $t ) ? $t : null;
}
public static function isNewer( string $remote, string $current ): bool {
$r = self::normalizeVersion( $remote );
if ( null === $r ) {
return false;
}
return version_compare( $r, ltrim( $current, 'vV' ), '>' );
}
/** https URL on exactly the configured host (no userinfo tricks). */
public static function isAllowedUrl( string $url, string $host ): bool {
$p = parse_url( $url );
if ( ! is_array( $p ) || ! isset( $p['scheme'], $p['host'] ) || isset( $p['user'] ) || isset( $p['pass'] ) ) {
return false;
}
return 'https' === strtolower( $p['scheme'] ) && '' !== $host && strtolower( $p['host'] ) === strtolower( $host );
}
private static function pickPackage( array $assets, string $host ): ?string {
$exact = null;
$first = null;
foreach ( $assets as $a ) {
if ( ! is_array( $a ) || ! is_string( $a['name'] ?? null ) || ! is_string( $a['browser_download_url'] ?? null ) ) {
continue;
}
if ( ! self::isAllowedUrl( $a['browser_download_url'], $host ) ) {
continue;
}
if ( self::ASSET_NAME === $a['name'] ) {
$exact = $exact ?? $a['browser_download_url'];
} elseif ( null === $first && str_ends_with( strtolower( $a['name'] ), '.zip' ) ) {
$first = $a['browser_download_url'];
}
}
return $exact ?? $first;
}
/** Minimal markdown to safe HTML: everything is escaped first; only paragraphs, headings (as <h4>) and lists. */
public static function changelogHtml( string $markdown ): string {
$lines = preg_split( '/\r\n|\r|\n/', $markdown ) ?: array();
$out = '';
$list = false;
$para = array();
$flush = static function () use ( &$out, &$para ): void {
if ( $para ) {
$out .= '<p>' . implode( ' ', $para ) . '</p>';
$para = array();
}
};
foreach ( $lines as $line ) {
$t = trim( $line );
if ( 1 === preg_match( '/^[*\-+]\s+(.*)$/', $t, $m ) ) {
$flush();
if ( ! $list ) {
$out .= '<ul>';
$list = true;
}
$out .= '<li>' . self::esc( $m[1] ) . '</li>';
continue;
}
if ( $list ) {
$out .= '</ul>';
$list = false;
}
if ( '' === $t ) {
$flush();
} elseif ( 1 === preg_match( '/^#{1,6}\s+(.*)$/', $t, $m ) ) {
$flush();
$out .= '<h4>' . self::esc( $m[1] ) . '</h4>';
} else {
$para[] = self::esc( $t );
}
}
$flush();
if ( $list ) {
$out .= '</ul>';
}
return $out;
}
private static function esc( string $s ): string {
return htmlspecialchars( $s, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8' );
}
}
+201
View File
@@ -0,0 +1,201 @@
<?php
declare( strict_types=1 );
namespace StreamGoals\Update;
use StreamGoals\Admin\Admin;
use StreamGoals\Core\Settings;
/**
* Self-updater: checks the Gitea repo's latest release and feeds WordPress' plugin update machinery.
* Every network/parse failure degrades to "no update known"; nothing here throws into WP screens.
*/
final class Updater {
public const SLUG = 'streamgoals-donate';
public const BASE_URL = 'https://repo.anhonesthost.net';
public const OWNER = 'wp-plugins';
public const REPO = 'wp-donations';
public const CACHE_KEY = 'sg_update_release';
public const CACHE_OK = HOUR_IN_SECONDS;
public const CACHE_FAIL = 10 * MINUTE_IN_SECONDS;
public const TIMEOUT = 8;
public const ACTION_CHECK = 'sg_update_check';
public static function register(): void {
if ( ! self::enabled() ) {
return;
}
add_filter( 'pre_set_site_transient_update_plugins', array( self::class, 'inject' ) );
add_filter( 'plugins_api', array( self::class, 'pluginInfo' ), 10, 3 );
add_filter( 'http_request_args', array( self::class, 'authorize' ), 10, 2 );
add_action( 'upgrader_process_complete', array( self::class, 'afterUpgrade' ), 10, 2 );
add_action( 'admin_post_' . self::ACTION_CHECK, array( self::class, 'handleCheck' ) );
}
public static function enabled(): bool {
return (bool) apply_filters( 'streamgoals_updates_enabled', true );
}
/** @return array{base:string,owner:string,repo:string,host:string} */
public static function repo(): array {
$r = apply_filters( 'streamgoals_update_repo', array( 'base' => self::BASE_URL, 'owner' => self::OWNER, 'repo' => self::REPO ) );
$r = is_array( $r ) ? $r : array();
$base = rtrim( is_string( $r['base'] ?? null ) ? $r['base'] : self::BASE_URL, '/' );
$host = parse_url( $base, PHP_URL_HOST );
return array(
'base' => $base,
'owner' => is_string( $r['owner'] ?? null ) ? $r['owner'] : self::OWNER,
'repo' => is_string( $r['repo'] ?? null ) ? $r['repo'] : self::REPO,
'host' => is_string( $host ) ? strtolower( $host ) : '',
);
}
/**
* Cached latest release (parsed) or null. Failures are cached briefly so WP never re-hits a broken endpoint.
*
* @return array{version:string,package:string,url:string,notes:string,published:string}|null
*/
public static function latest( bool $force = false ): ?array {
try {
if ( ! $force ) {
$c = get_site_transient( self::CACHE_KEY );
if ( is_array( $c ) && array_key_exists( 'release', $c ) ) {
return is_array( $c['release'] ) ? $c['release'] : null;
}
}
$release = self::fetch();
set_site_transient( self::CACHE_KEY, array( 'release' => $release ), null === $release ? self::CACHE_FAIL : self::CACHE_OK );
return $release;
} catch ( \Throwable $e ) {
return null;
}
}
public static function clearCache(): void {
delete_site_transient( self::CACHE_KEY );
}
private static function fetch(): ?array {
$repo = self::repo();
if ( '' === $repo['host'] || 'https' !== strtolower( (string) parse_url( $repo['base'], PHP_URL_SCHEME ) ) ) {
return null;
}
$url = $repo['base'] . '/api/v1/repos/' . rawurlencode( $repo['owner'] ) . '/' . rawurlencode( $repo['repo'] ) . '/releases/latest';
$resp = wp_remote_get( $url, array( 'timeout' => self::TIMEOUT, 'redirection' => 2, 'headers' => array( 'Accept' => 'application/json' ) ) );
if ( is_wp_error( $resp ) || 200 !== (int) wp_remote_retrieve_response_code( $resp ) ) {
return null;
}
$data = json_decode( (string) wp_remote_retrieve_body( $resp ), true );
return is_array( $data ) ? ReleaseParser::parse( $data, $repo['host'] ) : null;
}
public static function pluginFile(): string {
return plugin_basename( STREAMGOALS_FILE );
}
private static function entry( array $rel ): object {
$e = new \stdClass();
$e->id = $rel['url'] ?: self::BASE_URL;
$e->slug = self::SLUG;
$e->plugin = self::pluginFile();
$e->new_version = $rel['version'];
$e->url = $rel['url'];
$e->package = $rel['package'];
$e->requires = '6.8';
$e->requires_php = '8.1';
return $e;
}
public static function inject( mixed $transient ): mixed {
try {
if ( ! is_object( $transient ) ) {
return $transient;
}
$rel = self::latest();
$file = self::pluginFile();
unset( $transient->response[ $file ], $transient->no_update[ $file ] );
if ( null === $rel ) {
return $transient;
}
$entry = self::entry( $rel );
if ( ReleaseParser::isNewer( $rel['version'], STREAMGOALS_VERSION ) ) {
$transient->response = is_array( $transient->response ?? null ) ? $transient->response : array();
$transient->response[ $file ] = $entry;
} else {
$entry->new_version = STREAMGOALS_VERSION;
$transient->no_update = is_array( $transient->no_update ?? null ) ? $transient->no_update : array();
$transient->no_update[ $file ] = $entry;
}
} catch ( \Throwable $e ) {
// Never break the Updates screen.
}
return $transient;
}
public static function pluginInfo( mixed $result, mixed $action = '', mixed $args = null ): mixed {
try {
if ( 'plugin_information' !== $action || ! is_object( $args ) || ( $args->slug ?? '' ) !== self::SLUG ) {
return $result;
}
$rel = self::latest();
if ( null === $rel ) {
return $result;
}
$i = new \stdClass();
$i->name = 'StreamGoals Donate';
$i->slug = self::SLUG;
$i->version = $rel['version'];
$i->author = 'StreamGoals';
$i->homepage = $rel['url'];
$i->requires = '6.8';
$i->requires_php = '8.1';
$i->last_updated = $rel['published'];
$i->download_link = $rel['package'];
$i->sections = array(
'description' => 'PayPal donations with multiple goals, fee coverage, and OBS stream overlays.',
'changelog' => '' !== $rel['notes'] ? ReleaseParser::changelogHtml( $rel['notes'] ) : '<p>No release notes.</p>',
);
return $i;
} catch ( \Throwable $e ) {
return $result;
}
}
/** Adds the token ONLY for https requests to the configured Gitea host. */
public static function authorize( mixed $args, mixed $url ): mixed {
try {
if ( ! is_array( $args ) || ! is_string( $url ) ) {
return $args;
}
$token = trim( (string) Settings::get( 'update_token', '' ) );
$host = self::repo()['host'];
if ( '' === $token || ! ReleaseParser::isAllowedUrl( $url, $host ) ) {
return $args;
}
$args['headers'] = is_array( $args['headers'] ?? null ) ? $args['headers'] : array();
$args['headers']['Authorization'] = 'token ' . $token;
} catch ( \Throwable $e ) {
// Fall through without credentials.
}
return $args;
}
public static function afterUpgrade( mixed $upgrader, mixed $options ): void {
if ( is_array( $options ) && ( $options['type'] ?? '' ) === 'plugin' ) {
self::clearCache();
}
}
public static function handleCheck(): void {
Admin::guard( self::ACTION_CHECK );
self::clearCache();
delete_site_transient( 'update_plugins' );
$rel = self::latest( true );
$back = Admin::url( 'streamgoals-settings' );
if ( null === $rel ) {
Admin::redirect( $back, 'warning', 'Could not read the latest release. Check your connection and, if the update repository is private, the access token.' );
}
Admin::redirect( $back, 'success', ReleaseParser::isNewer( $rel['version'], STREAMGOALS_VERSION ) ? 'Version ' . $rel['version'] . ' is available. See Dashboard > Updates.' : 'You are up to date.' );
}
}
+55
View File
@@ -0,0 +1,55 @@
<?php
declare( strict_types=1 );
namespace StreamGoals\Tests\Unit;
use PHPUnit\Framework\TestCase;
use StreamGoals\Admin\Store;
/**
* Regression: Store::rules() must return rules whose `config` is a decoded array, not the raw JSON string.
* (A by-reference foreach over a cast temporary once discarded the decoding and crashed the Rules screen.)
*/
final class AdminStoreRulesTest extends TestCase {
private $previous;
protected function setUp(): void {
if ( ! defined( 'ARRAY_A' ) ) {
define( 'ARRAY_A', 'ARRAY_A' ); // WordPress constant; not loaded in plain PHPUnit
}
$this->previous = $GLOBALS['wpdb'] ?? null;
$GLOBALS['wpdb'] = new class() {
public string $prefix = 'wp_';
public function prepare( string $q, ...$args ): string { return $q; }
public function get_results( string $q, $output = null ): array {
return array(
array( 'id' => '1', 'goal_id' => '1', 'type' => 'add_time', 'config' => '{"seconds_per_unit":60,"unit_minor":100,"max_timer_seconds":5400}', 'enabled' => '1', 'sort' => '0' ),
array( 'id' => '2', 'goal_id' => '1', 'type' => 'counter', 'config' => 'not json', 'enabled' => '0', 'sort' => '1' ),
array( 'id' => '3', 'goal_id' => '1', 'type' => 'bonus', 'config' => '{"min_minor":5000}', 'enabled' => '1', 'sort' => '2' ),
);
}
};
}
protected function tearDown(): void {
$GLOBALS['wpdb'] = $this->previous;
}
public function test_every_rule_config_is_a_decoded_array(): void {
$rules = Store::rules( 1 );
$this->assertCount( 3, $rules );
foreach ( $rules as $r ) {
$this->assertIsArray( $r['config'], 'rule ' . $r['id'] . ' config was not decoded' );
}
$this->assertSame( 5400, $rules[0]['config']['max_timer_seconds'] );
$this->assertSame( array(), $rules[1]['config'], 'invalid JSON becomes an empty config, not a crash' );
$this->assertSame( 5000, $rules[2]['config']['min_minor'] );
}
public function test_rule_lookup_returns_decoded_config(): void {
$r = Store::rule( 3, 1 );
$this->assertIsArray( $r['config'] );
$this->assertNull( Store::rule( 99, 1 ) );
}
}
+93
View File
@@ -0,0 +1,93 @@
<?php
declare( strict_types=1 );
namespace StreamGoals\Tests\Unit;
use PHPUnit\Framework\TestCase;
use StreamGoals\Update\ReleaseParser;
final class UpdateReleaseParserTest extends TestCase {
private const HOST = 'repo.anhonesthost.net';
private const ZIP = 'https://repo.anhonesthost.net/wp-plugins/wp-donations/releases/download/2026.11.15-1941/streamgoals-donate.zip';
private function release( array $over = array() ): array {
return array_merge(
array(
'tag_name' => '2026.11.15-1941',
'draft' => false,
'prerelease' => false,
'body' => "## What's New\n\n* one\n* two",
'html_url' => 'https://repo.anhonesthost.net/wp-plugins/wp-donations/releases/tag/2026.11.15-1941',
'published_at' => '2026-11-15T19:41:00Z',
'assets' => array( array( 'name' => 'streamgoals-donate.zip', 'browser_download_url' => self::ZIP ) ),
),
$over
);
}
public function test_valid_release(): void {
$r = ReleaseParser::parse( $this->release(), self::HOST );
$this->assertSame( '2026.11.15-1941', $r['version'] );
$this->assertSame( self::ZIP, $r['package'] );
$this->assertSame( '2026-11-15T19:41:00Z', $r['published'] );
$this->assertStringContainsString( 'releases/tag', $r['url'] );
}
public function test_draft_and_prerelease_ignored(): void {
$this->assertNull( ReleaseParser::parse( $this->release( array( 'draft' => true ) ), self::HOST ) );
$this->assertNull( ReleaseParser::parse( $this->release( array( 'prerelease' => true ) ), self::HOST ) );
}
public function test_bad_tag(): void {
foreach ( array( 'nightly', '2026.1.15-1941', '', null, array() ) as $t ) {
$this->assertNull( ReleaseParser::parse( $this->release( array( 'tag_name' => $t ) ), self::HOST ) );
}
}
public function test_v_prefix_and_semver(): void {
$this->assertSame( '2026.11.15-1941', ReleaseParser::parse( $this->release( array( 'tag_name' => 'v2026.11.15-1941' ) ), self::HOST )['version'] );
$this->assertSame( '1.2.3', ReleaseParser::parse( $this->release( array( 'tag_name' => 'v1.2.3' ) ), self::HOST )['version'] );
}
public function test_wrong_host_and_non_https_rejected(): void {
foreach ( array( 'https://evil.example/streamgoals-donate.zip', 'http://repo.anhonesthost.net/x.zip', 'https://repo.anhonesthost.net@evil.example/x.zip', 'https://repo.anhonesthost.net.evil.example/x.zip', '//repo.anhonesthost.net/x.zip' ) as $u ) {
$rel = $this->release( array( 'assets' => array( array( 'name' => 'streamgoals-donate.zip', 'browser_download_url' => $u ) ) ) );
$this->assertNull( ReleaseParser::parse( $rel, self::HOST ), $u );
}
}
public function test_missing_asset(): void {
$this->assertNull( ReleaseParser::parse( $this->release( array( 'assets' => array() ) ), self::HOST ) );
$this->assertNull( ReleaseParser::parse( $this->release( array( 'assets' => array( array( 'name' => 'notes.txt', 'browser_download_url' => self::ZIP ) ) ) ), self::HOST ) );
$this->assertNull( ReleaseParser::parse( array( 'tag_name' => '1.0.0' ), self::HOST ) );
}
public function test_picks_right_asset(): void {
$other = 'https://repo.anhonesthost.net/dl/other.zip';
$a = array( array( 'name' => 'source.zip', 'browser_download_url' => $other ), array( 'name' => 'streamgoals-donate.zip', 'browser_download_url' => self::ZIP ) );
$this->assertSame( self::ZIP, ReleaseParser::parse( $this->release( array( 'assets' => $a ) ), self::HOST )['package'] );
$this->assertSame( $other, ReleaseParser::parse( $this->release( array( 'assets' => array( $a[0] ) ) ), self::HOST )['package'] );
}
public function test_version_comparison(): void {
$this->assertTrue( ReleaseParser::isNewer( '2026.11.15-1830', '2026.11.15-0930' ) );
$this->assertFalse( ReleaseParser::isNewer( '2026.11.15-0930', '2026.11.15-1830' ) );
$this->assertFalse( ReleaseParser::isNewer( '2026.11.15-0930', '2026.11.15-0930' ) );
$this->assertTrue( ReleaseParser::isNewer( 'v2026.11.16-0001', '2026.11.15-2359' ) );
$this->assertTrue( ReleaseParser::isNewer( '2026.11.15-1941', '0.1.0' ) );
$this->assertFalse( ReleaseParser::isNewer( 'garbage', '0.1.0' ) );
}
public function test_changelog_escapes_html(): void {
$h = ReleaseParser::changelogHtml( "<script>alert(1)</script>\n\n* <b>bold</b> & \"q\"\n* two" );
$this->assertStringNotContainsString( '<script', $h );
$this->assertStringNotContainsString( '<b>', $h );
$this->assertStringContainsString( '&lt;script&gt;', $h );
$this->assertStringContainsString( '<ul><li>&lt;b&gt;bold&lt;/b&gt; &amp; &quot;q&quot;</li><li>two</li></ul>', $h );
}
public function test_changelog_paragraphs_and_headings(): void {
$this->assertSame( '<h4>What&#039;s New</h4><p>a b</p><ul><li>x</li></ul>', ReleaseParser::changelogHtml( "## What's New\n\na\nb\n\n- x" ) );
}
}