<?php

namespace MediaWiki\Extension\ConfirmEdit\SimpleCaptcha;

use MediaWiki\Api\ApiBase;
use MediaWiki\Api\ApiEditPage;
use MediaWiki\Auth\AuthenticationRequest;
use MediaWiki\Content\Content;
use MediaWiki\Content\TextContent;
use MediaWiki\Content\WikitextContent;
use MediaWiki\Context\IContextSource;
use MediaWiki\Context\RequestContext;
use MediaWiki\EditPage\EditPage;
use MediaWiki\Extension\ConfirmEdit\Auth\CaptchaAuthenticationRequest;
use MediaWiki\Extension\ConfirmEdit\CaptchaTriggers;
use MediaWiki\Extension\ConfirmEdit\Hooks\HookRunner;
use MediaWiki\Extension\ConfirmEdit\Store\CaptchaStore;
use MediaWiki\ExternalLinks\ExternalLinksLookup;
use MediaWiki\ExternalLinks\LinkFilter;
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\Mail\MailAddress;
use MediaWiki\MediaWikiServices;
use MediaWiki\Message\Message;
use MediaWiki\Output\OutputPage;
use MediaWiki\Page\CacheKeyHelper;
use MediaWiki\Page\WikiPage;
use MediaWiki\Parser\ParserOptions;
use MediaWiki\Registration\ExtensionRegistry;
use MediaWiki\Request\ContentSecurityPolicy;
use MediaWiki\Request\WebRequest;
use MediaWiki\Revision\RevisionAccessException;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\Status\Status;
use MediaWiki\Title\Title;
use MediaWiki\User\User;
use OOUI\FieldLayout;
use OOUI\HiddenInputWidget;
use OOUI\NumberInputWidget;
use UnexpectedValueException;
use Wikimedia\IPUtils;
use Wikimedia\Rdbms\IDBAccessObject;
use Wikimedia\Timestamp\ConvertibleTimestamp;

/**
 * Demo CAPTCHA (not for production usage) and base class for real CAPTCHAs
 */
class SimpleCaptcha {
	/**
	 * The session key that stores the UNIX timestamp when the AbuseFilter
	 * "showcaptcha" consequence stops applying to the user represented by the session.
	 *
	 * This is used to enforce that `::shouldForceShowCaptcha` persists across
	 * the requests made for a single action.
	 */
	public const ABUSEFILTER_CAPTCHA_CONSEQUENCE_SESSION_KEY = 'confirmedit-captcha-consequence';

	/** @var string */
	protected static $messagePrefix = 'captcha';

	/** @var bool Override to force showing the CAPTCHA to users who don't have "skipcaptcha" right. */
	private bool $forceShowCaptcha = false;

	/** @var bool|null Was the CAPTCHA already passed and if yes, with which result? */
	private ?bool $captchaSolved = null;

	/** @var bool Flag to indicate whether the onEditFilterMergedContent hook was invoked. */
	private bool $editFilterMergedContentHandlerCalled = false;

	/** @var array<string,true> Activated captcha status list for a pages by key */
	private $activatedCaptchas = [];

	/**
	 * Used to select the right message.
	 * One of sendmail, createaccount, badlogin, edit, create, addurl.
	 * @var string
	 */
	protected $action;

	/** @var string Used in log messages. */
	protected $trigger;

	private array $config = [];

	/**
	 * @param string $action
	 */
	public function setAction( $action ) {
		$this->action = $action;
	}

	/**
	 * @param string $trigger
	 */
	public function setTrigger( $trigger ) {
		$this->trigger = $trigger;
	}

	/**
	 * Return the error from the last passCaptcha* call.
	 * Not implemented but needed by some child classes.
	 * @return mixed
	 */
	public function getError() {
		return null;
	}

	public function getName(): string {
		return wfMessage( static::$messagePrefix . '-name' )->text();
	}

	/**
	 * Returns an array with 'question' and 'answer' keys.
	 * Subclasses might use a different structure.
	 * Since MW 1.27, all subclasses must implement this method.
	 * @return array
	 */
	public function getCaptcha() {
		$a = random_int( 0, 100 );
		$b = random_int( 0, 10 );

		/* Minus sign is used in the question. UTF-8,
		   since the api uses text/plain, not text/html */
		$op = random_int( 0, 1 ) ? '+' : '−';

		// No space before and after $op, to ensure correct
		// directionality.
		$test = "$a$op$b";
		$answer = ( $op == '+' ) ? ( $a + $b ) : ( $a - $b );
		return [ 'question' => $test, 'answer' => $answer ];
	}

	/**
	 * Returns a list of pages with a key generated by {@see CacheKeyHelper::getKeyForPage}, that have activated
	 * captchas.
	 *
	 * @return array<string,true>
	 */
	public function getActivatedCaptchas() {
		return $this->activatedCaptchas;
	}

	/**
	 * @param array &$resultArr
	 */
	protected function addCaptchaAPI( &$resultArr ) {
		$captcha = $this->getCaptcha();
		$index = $this->storeCaptcha( $captcha );
		$resultArr['captcha'] = $this->describeCaptchaType( $this->action );
		$resultArr['captcha']['id'] = $index;
		$resultArr['captcha']['question'] = $captcha['question'];
	}

	/**
	 * Describes the captcha type for API clients.
	 * @param string|null $action The captcha trigger action
	 * @return array An array with keys 'type' and 'mime', and possibly other
	 *   implementation-specific
	 */
	public function describeCaptchaType( ?string $action = null ) {
		return [
			'type' => 'simple',
			'mime' => 'text/plain',
		];
	}

	/**
	 * Insert a captcha prompt into the edit form.
	 * This sample implementation generates a simple arithmetic operation;
	 * it would be easy to defeat by machine.
	 *
	 * Override this!
	 *
	 * It is not guaranteed that the CAPTCHA will load synchronously with the main page
	 * content. So you cannot rely on registering handlers before the page load. E.g.:
	 *
	 * NOT SAFE: $( window ).on( 'load', handler )
	 * SAFE: $( handler )
	 *
	 * However, if the HTML is loaded dynamically via AJAX, the following order will
	 * be used.
	 *
	 * headitems => modulestyles + modules => add main HTML to DOM when modulestyles +
	 * modules are ready.
	 *
	 * @param int $tabIndex Tab index to start from
	 * @param OutputPage|null $out The OutputPage instance where associated with the form the captcha is being added
	 *    to. If this is null, then the OutputPage object from the main request context is used. It is recommended
	 *    to provide this and may be made required in the future.
	 *
	 * @return array Associative array with the following keys:
	 *   string html - Main HTML
	 *   array modules (optional) - Array of ResourceLoader module names
	 *   array modulestyles (optional) - Array of ResourceLoader module names to be
	 * 		included as style-only modules.
	 *   array headitems (optional) - Head items (see OutputPage::addHeadItems), as a numeric array
	 * 		of raw HTML strings. Do not use unless no other option is feasible.
	 */
	public function getFormInformation( $tabIndex = 1, ?OutputPage $out = null ) {
		$captcha = $this->getCaptcha();
		$index = $this->storeCaptcha( $captcha );

		return [
			'html' =>
				new FieldLayout(
					new NumberInputWidget( [
						'name' => 'wpCaptchaWord',
						'classes' => [ 'simplecaptcha-answer' ],
						'id' => 'wpCaptchaWord',
						'autocomplete' => 'off',
						// tab in before the edit textarea
						'tabIndex' => $tabIndex
					] ),
					[
						'align' => 'left',
						'label' => $captcha['question'] . ' = ',
						'classes' => [ 'simplecaptcha-field' ],
					]
				) .
				new HiddenInputWidget( [
					'name' => 'wpCaptchaId',
					'id' => 'wpCaptchaId',
					'value' => $index
				] ),
			'modulestyles' => [
				'ext.confirmEdit.simpleCaptcha'
			]
		];
	}

	/**
	 * @return string[]
	 */
	public static function getCSPUrls() {
		return [];
	}

	/**
	 * Adds the necessary CSP policies for the captcha module to work in a CSP enforced
	 * setup.
	 *
	 * @param ContentSecurityPolicy $csp The CSP instance to add the policies to, usually
	 * obtained from {@link OutputPage::getCSP()}
	 */
	public static function addCSPSources( ContentSecurityPolicy $csp ) {
		foreach ( static::getCSPUrls() as $src ) {
			$csp->addScriptSrc( $src );
			$csp->addStyleSrc( $src );
		}
	}

	/**
	 * Uses getFormInformation() to get the CAPTCHA form and adds it to the given
	 * OutputPage object.
	 *
	 * @param OutputPage $out The OutputPage object to which the form should be added
	 * @param int $tabIndex See self::getFormInformation
	 */
	public function addFormToOutput( OutputPage $out, $tabIndex = 1 ) {
		$this->addFormInformationToOutput( $out, $this->getFormInformation( $tabIndex, $out ) );
	}

	/**
	 * Processes the given $formInformation array and adds the options (see getFormInformation())
	 * to the given OutputPage object.
	 *
	 * @param OutputPage $out The OutputPage object to which the form should be added
	 * @param array $formInformation
	 */
	public function addFormInformationToOutput( OutputPage $out, array $formInformation ) {
		static::addCSPSources( $out->getCSP() );

		if ( !$formInformation ) {
			return;
		}
		if ( isset( $formInformation['html'] ) ) {
			$out->addHTML( $formInformation['html'] );
		}
		if ( isset( $formInformation['modules'] ) ) {
			$out->addModules( $formInformation['modules'] );
		}
		if ( isset( $formInformation['modulestyles'] ) ) {
			$out->addModuleStyles( $formInformation['modulestyles'] );
		}
		if ( isset( $formInformation['headitems'] ) ) {
			$out->addHeadItems( $formInformation['headitems'] );
		}
	}

	/**
	 * @param array $captchaData Data given by getCaptcha
	 * @param string $id ID given by storeCaptcha
	 * @return string Description of the captcha. Format is not specified; could be text, HTML, URL...
	 */
	public function getCaptchaInfo( $captchaData, $id ) {
		return array_key_exists( 'question', $captchaData ) ? ( $captchaData['question'] . ' =' ) : '';
	}

	/**
	 * Show the error message for missing or incorrect captcha on EditPage.
	 * @param EditPage $editPage
	 * @param OutputPage $out
	 */
	public function showEditFormFields( EditPage $editPage, OutputPage $out ) {
		$out->enableOOUI();
		$page = $editPage->getArticle()->getPage();
		$key = CacheKeyHelper::getKeyForPage( $page );
		if ( !isset( $this->activatedCaptchas[$key] ) ) {
			return;
		}

		if ( $this->action !== 'edit' ) {
			unset( $this->activatedCaptchas[$key] );
			$out->addHTML( $this->getMessage( $this->action )->parseAsBlock() );
			$this->addFormToOutput( $out );
		}
	}

	/**
	 * Insert the captcha prompt into an edit form.
	 * @param EditPage $editPage
	 */
	public function editShowCaptcha( $editPage ) {
		$context = $editPage->getArticle()->getContext();
		$page = $editPage->getArticle()->getPage();
		$out = $context->getOutput();
		$key = CacheKeyHelper::getKeyForPage( $page );
		if ( isset( $this->activatedCaptchas[$key] ) ||
			$this->shouldCheck( $page, '', '', $context )
		) {
			$out->addHTML( $this->getMessage( $this->action )->parseAsBlock() );
			$this->addFormToOutput( $out );
		}
		unset( $this->activatedCaptchas[$key] );
	}

	/**
	 * Show a message asking the user to enter a captcha on edit
	 * The result will be treated as wiki text
	 *
	 * @param string $action Action being performed
	 * @return Message
	 */
	public function getMessage( $action ) {
		// one of captcha-edit, captcha-addurl, captcha-badlogin, captcha-createaccount,
		// captcha-create, captcha-sendemail
		$msg = wfMessage( static::$messagePrefix . '-' . $action );
		// obtain a more tailored message, if possible, otherwise, fall back to
		// the default for edits
		return $msg->isDisabled() ? wfMessage( static::$messagePrefix . '-edit' ) : $msg;
	}

	/**
	 * Inject whazawhoo
	 * @fixme if multiple thingies insert a header, could break
	 * @param HTMLForm $form
	 * @return bool true to keep running callbacks
	 */
	public function injectEmailUser( HTMLForm $form ) {
		$out = $form->getOutput();
		$user = $form->getUser();
		if ( $this->triggersCaptcha( CaptchaTriggers::SENDEMAIL ) ) {
			$this->action = 'sendemail';
			if ( $this->canSkipCaptcha( $user ) ) {
				return true;
			}
			$formInformation = $this->getFormInformation( 1, $out );
			$formMetainfo = $formInformation;
			unset( $formMetainfo['html'] );
			$this->addFormInformationToOutput( $out, $formMetainfo );
			$form->addFooterHtml(
				"<div class='captcha'>" .
				$this->getMessage( 'sendemail' )->parseAsBlock() .
				$formInformation['html'] .
				"</div>\n" );
		}
		return true;
	}

	/**
	 * Check if the current IP is allowed to skip solving a captcha.
	 * This checks the bypass list from two sources.
	 *  1) From the server-side config array $wgCaptchaBypassIPs
	 *  2) From the local [[MediaWiki:Captcha-ip-whitelist]] message
	 *
	 * @return bool true if the IP can bypass a captcha, false if not
	 */
	private function canIPBypassCaptcha() {
		global $wgCaptchaBypassIPs, $wgRequest;
		$ip = $wgRequest->getIP();

		if ( $wgCaptchaBypassIPs && IPUtils::isInRanges( $ip, $wgCaptchaBypassIPs ) ) {
			return true;
		}

		$msg = wfMessage( 'captcha-ip-whitelist' )->inContentLanguage();
		if ( !$msg->isDisabled() ) {
			$allowedIPs = $this->getWikiIPBypassList( $msg );
			if ( IPUtils::isInRanges( $ip, $allowedIPs ) ) {
				return true;
			}
		}

		return false;
	}

	/**
	 * Get the on-wiki IP bypass list stored on a MediaWiki page from cache if possible.
	 *
	 * @param Message $msg Message on wiki with IP lists
	 * @return array Allowed IP addresses or IP ranges, empty array if none
	 */
	private function getWikiIPBypassList( Message $msg ) {
		$cache = MediaWikiServices::getInstance()->getMainWANObjectCache();
		$cacheKey = $cache->makeKey( 'confirmedit', 'ipbypasslist' );

		$cached = $cache->get( $cacheKey );
		if ( $cached !== false ) {
			return $cached;
		}

		// Could not retrieve from cache, so build the list directly
		// from the MediaWiki page
		$list = $this->buildValidIPs(
			explode( "\n", $msg->plain() )
		);
		// And then store it in cache for one day.
		// This cache is cleared on modifications to the wiki page.
		// @see MediaWiki\Extension\ConfirmEdit\Hooks::onPageSaveComplete()
		$cache->set( $cacheKey, $list, 86400 );

		return $list;
	}

	/**
	 * From a list of unvalidated input, get all the valid
	 * IP addresses and IP ranges from it.
	 *
	 * Note that only lines with just the IP address or the IP range is considered
	 * as valid. Whitespace is allowed, but if there is any other character on
	 * the line, it's not considered as a valid entry.
	 *
	 * @param string[] $input
	 * @return string[] of valid IP addresses and IP ranges
	 */
	private function buildValidIPs( array $input ) {
		// Remove whitespace and blank lines first
		$ips = array_map( 'trim', $input );
		$ips = array_filter( $ips );

		$validIPs = [];
		foreach ( $ips as $ip ) {
			if ( IPUtils::isIPAddress( $ip ) ) {
				$validIPs[] = $ip;
			}
		}

		return $validIPs;
	}

	/**
	 * Check if the submitted form matches the captcha session data provided
	 * by the plugin when the form was generated.
	 *
	 * Override this!
	 *
	 * @param string $answer
	 * @param array $info
	 * @return bool
	 */
	protected function keyMatch( $answer, $info ) {
		return $answer == $info['answer'];
	}

	// ----------------------------------

	/**
	 * Checks, whether the passed action should trigger a CAPTCHA. The optional $title parameter
	 * will be used to check namespace specific CAPTCHA triggers.
	 *
	 * @param string $action The CAPTCHA trigger to check (see CaptchaTriggers for ConfirmEdit
	 * built-in triggers)
	 * @param Title|null $title An optional Title object, if the namespace specific triggers
	 * should be checked, too.
	 * @return bool True, if the action should trigger a CAPTCHA, false otherwise
	 */
	public function triggersCaptcha( $action, $title = null ) {
		// Captcha was already solved, we don't need to check anything else.
		if ( $this->isCaptchaSolved() ) {
			return false;
		}

		global $wgCaptchaTriggers, $wgCaptchaTriggersOnNamespace;

		$result = false;
		$triggers = $wgCaptchaTriggers;
		$attributeCaptchaTriggers = ExtensionRegistry::getInstance()
			->getAttribute( CaptchaTriggers::EXT_REG_ATTRIBUTE_NAME );
		if ( is_array( $attributeCaptchaTriggers ) ) {
			$triggers += $attributeCaptchaTriggers;
		}

		if ( isset( $triggers[$action] ) ) {
			$res = $triggers[$action];
			if ( !is_array( $res ) ) {
				// Handle old style triggers where it was a boolean
				$result = $triggers[$action];
			} else {
				$result = $triggers[$action]['trigger'] ?? false;
			}
		}

		if (
			$title !== null &&
			isset( $wgCaptchaTriggersOnNamespace[$title->getNamespace()][$action] )
		) {
			$result = $wgCaptchaTriggersOnNamespace[$title->getNamespace()][$action];
		}

		// SimpleCaptcha has been instructed to force showing the CAPTCHA, no need to
		// check what other hook implementations think.
		if ( $this->shouldForceShowCaptcha() ) {
			return true;
		}

		$hookRunner = new HookRunner(
			MediaWikiServices::getInstance()->getHookContainer()
		);
		$hookRunner->onConfirmEditTriggersCaptcha( $action, $title, $result );

		return $result;
	}

	/**
	 * @param WikiPage $page
	 * @param Content|string $content
	 * @param string $section
	 * @param IContextSource $context
	 * @param string|null $oldtext The content of the revision prior to $content When
	 *  null this will be loaded from the database.
	 * @return bool true if the captcha should run
	 */
	public function shouldCheck( WikiPage $page, $content, $section, $context, $oldtext = null ) {
		if ( !$context instanceof IContextSource ) {
			$context = RequestContext::getMain();
		}

		$request = $context->getRequest();
		$user = $context->getUser();

		if ( $this->canSkipCaptcha( $user ) ) {
			return false;
		}

		$title = $page->getTitle();
		$this->trigger = '';

		// If force show captcha is set (e.g., by AbuseFilter), bypass normal trigger checks
		if ( $this->shouldForceShowCaptcha() && !$this->isCaptchaSolved() ) {
			// Preserve existing action if set, otherwise default to 'edit'
			if ( $this->action === null ) {
				$this->action = CaptchaTriggers::EDIT;
			}
			wfDebug( "ConfirmEdit: force showing captcha for {$this->action}...\n" );
			$this->trigger = sprintf( "force show trigger by '%s' at [[%s]] for %s",
				$user->getName(),
				$title->getPrefixedText(),
				$this->action );
			return true;
		}

		if ( $content instanceof Content ) {
			if ( $content->getModel() == CONTENT_MODEL_WIKITEXT ) {
				'@phan-var WikitextContent $content';
				$newtext = $content->getText();
			} else {
				$newtext = null;
			}
			$isEmpty = $content->isEmpty();
		} else {
			// $content is a non-null string here, so $newtext is also non-null
			$newtext = $content;
			$isEmpty = $content === '';
		}

		if ( !$isEmpty && $request->wasPosted() && $this->triggersCaptcha( CaptchaTriggers::ADD_URL, $title ) ) {
			// Only check edits that add URLs
			if ( $content instanceof Content ) {
				// Get links from the database
				$oldLinks = ExternalLinksLookup::getExtLinksForPage(
					$title->getArticleID(),
					MediaWikiServices::getInstance()->getConnectionProvider(),
					__METHOD__
				);
				// Share a parse operation with Article::doEdit()
				$editInfo = $page->prepareContentForEdit( $content, null, $user );
				if ( $editInfo->output ) {
					$newLinks = LinkFilter::getIndexedUrlsNonReversed(
						array_keys( $editInfo->output->getExternalLinks() )
					);
				} else {
					$newLinks = [];
				}
			} else {
				// Get link changes in the slowest way known to man
				'@phan-var string $newtext';
				$oldtext ??= $this->loadText( $title, $section );
				$oldLinks = $this->findLinks( $title, $oldtext );
				$newLinks = $this->findLinks( $title, $newtext );
			}

			$unknownLinks = array_filter( $newLinks, [ $this, 'filterLink' ] );
			$addedLinks = array_diff( $unknownLinks, $oldLinks );
			$numLinks = count( $addedLinks );

			if ( $numLinks > 0 ) {
				$this->trigger = sprintf(
					"URL trigger by '%s' at [[%s]] (%u URLs): %s",
					$user->getName(),
					$title->getPrefixedText(),
					$numLinks,
					// T411168 Truncate the message if it contains too many URLs
					$this->joinURLs( $addedLinks )
				);

				$this->action = CaptchaTriggers::ADD_URL;

				// Set instance-specific config from CaptchaTriggers for addurl
				// to allow per-trigger configuration (e.g., different sitekeys)
				$config = MediaWikiServices::getInstance()->getMainConfig();
				$captchaTriggers = $config->get( 'CaptchaTriggers' );
				if ( is_array( $captchaTriggers[CaptchaTriggers::ADD_URL] ?? null ) ) {
					$this->setConfig( $captchaTriggers[CaptchaTriggers::ADD_URL]['config'] ?? [] );
				} else {
					$this->setConfig( [] );
				}

				return true;
			}
		}

		if ( $this->triggersCaptcha( CaptchaTriggers::EDIT, $title ) ) {
			// Check on all edits
			$this->trigger = sprintf( "edit trigger by '%s' at [[%s]]",
				$user->getName(),
				$title->getPrefixedText() );
			$this->action = CaptchaTriggers::EDIT;
			wfDebug( "ConfirmEdit: checking all edits...\n" );
			return true;
		}

		if ( $this->triggersCaptcha( CaptchaTriggers::CREATE, $title ) && !$title->exists() ) {
			// Check if creating a page
			$this->trigger = sprintf( "Create trigger by '%s' at [[%s]]",
				$user->getName(),
				$title->getPrefixedText() );
			$this->action = CaptchaTriggers::CREATE;
			wfDebug( "ConfirmEdit: checking on page creation...\n" );
			return true;
		}

		// The following checks are expensive and should be done only if we can assume that the edit will be saved
		if ( !$request->wasPosted() ) {
			wfDebug(
				"ConfirmEdit: request not posted, assuming that no content will be saved -> no CAPTCHA check"
			);
			return false;
		}

		global $wgCaptchaRegexes;
		if ( $newtext !== null && $wgCaptchaRegexes ) {
			if ( !is_array( $wgCaptchaRegexes ) ) {
				throw new UnexpectedValueException(
					'$wgCaptchaRegexes is required to be an array, ' . get_debug_type( $wgCaptchaRegexes ) . ' given.'
				);
			}
			// Custom regex checks. Reuse $oldtext if set above.
			$oldtext ??= $this->loadText( $title, $section );

			foreach ( $wgCaptchaRegexes as $regex ) {
				$newMatches = [];
				if ( preg_match_all( $regex, $newtext, $newMatches ) ) {
					$oldMatches = [];
					preg_match_all( $regex, $oldtext, $oldMatches );

					$addedMatches = array_diff( $newMatches[0], $oldMatches[0] );

					$numHits = count( $addedMatches );
					if ( $numHits > 0 ) {
						$this->trigger = sprintf( "%dx %s by %s at [[%s]]: %s",
							$numHits,
							$regex,
							$user->getName(),
							$title->getPrefixedText(),
							implode( ", ", $addedMatches ) );
						$this->action = CaptchaTriggers::EDIT;
						return true;
					}
				}
			}
		}

		return false;
	}

	public function isCaptchaSolved(): ?bool {
		return $this->captchaSolved;
	}

	protected function setCaptchaSolved( ?bool $captchaSolved ): void {
		$this->captchaSolved = $captchaSolved;
	}

	/**
	 * @return bool True if an override is set to force showing a CAPTCHA
	 *  to the user. Note that users with "skipcaptcha" right may still
	 *  bypass this override.
	 */
	public function shouldForceShowCaptcha(): bool {
		if ( $this->forceShowCaptcha ) {
			return $this->forceShowCaptcha;
		}

		$expiry = (int)RequestContext::getMain()->getRequest()->getSession()->get(
			self::ABUSEFILTER_CAPTCHA_CONSEQUENCE_SESSION_KEY,
			0
		);

		// Update the local variable in order to avoid further lookups in the
		// user session on next calls in case the session value is still valid.
		$this->forceShowCaptcha = ( $expiry > ConvertibleTimestamp::time() );

		return $this->forceShowCaptcha;
	}

	/**
	 * @param bool $forceShowCaptcha True if the caller wants to force showing
	 *  a CAPTCHA to the user. Note that users with "skipcaptcha" right may
	 *  still bypass this override.
	 * @return void
	 */
	public function setForceShowCaptcha( bool $forceShowCaptcha ): void {
		$this->forceShowCaptcha = $forceShowCaptcha;

		// The flag won't survive a page reload in cases when the user is taken
		// back to the edit form with an error message stating that the captcha
		// should be solved. Therefore, a session variable is used to make
		// ::shouldForceShowCaptcha() return true even if it is called on an
		// instance where setForceShowCaptcha() has not been explicitly called
		// as part of handling the current request.
		//
		// Please note that makes the showcaptcha consequence to remain set for
		// next requests instead of being set just for the current one.
		//
		// On the other hand, if the flag is explicitly set back to false, the
		// session variable is removed.
		$session = RequestContext::getMain()->getRequest()->getSession();
		if ( $forceShowCaptcha ) {
			$session->set(
				self::ABUSEFILTER_CAPTCHA_CONSEQUENCE_SESSION_KEY,
				ConvertibleTimestamp::time() +
					MediaWikiServices::getInstance()->getMainConfig()->get(
						'CaptchaAbuseFilterCaptchaConsequenceTTL'
					)
			);
		} else {
			$session->remove(
				self::ABUSEFILTER_CAPTCHA_CONSEQUENCE_SESSION_KEY
			);
		}
	}

	/**
	 * @return bool Was the EditFilterMergedContent hook implementation already
	 * invoked?
	 */
	public function editFilterMergedContentHandlerAlreadyInvoked(): bool {
		return $this->editFilterMergedContentHandlerCalled;
	}

	/**
	 * @return void Set a flag on the class stating that EditFilterMergedContent handler
	 * was already run.
	 */
	public function setEditFilterMergedContentHandlerInvoked(): void {
		$this->editFilterMergedContentHandlerCalled = true;
	}

	/**
	 * @param array $config The 'config' property from wgCaptchaTriggers
	 * @return void
	 */
	public function setConfig( array $config ): void {
		$this->config = $config;
	}

	/**
	 * @return array The 'config' property from wgCaptchaTriggers for a given action
	 */
	public function getConfig(): array {
		return $this->config;
	}

	/**
	 * Filter callback function for URL allow-listing
	 * @param string $url string to check
	 * @return bool true if unknown, false if allowed
	 */
	private function filterLink( $url ) {
		global $wgCaptchaIgnoredUrls;
		static $regexes = null;

		if ( $regexes === null ) {
			$source = wfMessage( 'captcha-addurl-whitelist' )->inContentLanguage();

			$regexes = $source->isDisabled()
				? []
				: $this->buildRegexes( explode( "\n", $source->plain() ) );

			if ( $wgCaptchaIgnoredUrls !== false ) {
				array_unshift( $regexes, $wgCaptchaIgnoredUrls );
			}
		}

		foreach ( $regexes as $regex ) {
			if ( preg_match( $regex, $url ) ) {
				return false;
			}
		}

		return true;
	}

	/**
	 * Build regex from the list of URLs
	 * @param string[] $lines string from MediaWiki page
	 * @return string[] Regexes
	 * @private
	 */
	private function buildRegexes( $lines ) {
		# Code duplicated from the SpamBlacklist extension (r19197)
		# and later modified.

		# Strip comments and whitespace, then remove blanks
		$lines = array_filter( array_map( 'trim', preg_replace( '/#.*$/', '', $lines ) ) );

		# No lines, don't make a regex which will match everything
		if ( count( $lines ) === 0 ) {
			wfDebug( "No lines\n" );
			return [];
		}

		# Make regex
		# It's faster using the S modifier even though it will usually only be run once
		// $regex = 'http://+[a-z0-9_\-.]*(' . implode( '|', $lines ) . ')';
		// return '/' . str_replace( '/', '\/', preg_replace('|\\\*/|', '/', $regex) ) . '/Si';
		$regexes = [];
		$regexStart = [
			'normal' => '/^(?:https?:)?\/\/+[a-z0-9_\-.]*(?:',
			'noprotocol' => '/^(?:',
		];
		$regexEnd = [
			'normal' => ')/Si',
			'noprotocol' => ')/Si',
		];
		$regexMax = 4096;
		$build = [];
		foreach ( $lines as $line ) {
			# Extract flags from the line
			$options = [];
			if ( preg_match( '/^(.*?)\s*<([^<>]*)>$/', $line, $matches ) ) {
				if ( $matches[1] === '' ) {
					wfDebug( "Line with empty regex\n" );
					continue;
				}
				$line = $matches[1];
				$opts = preg_split( '/\s*\|\s*/', trim( $matches[2] ) );
				foreach ( $opts as $opt ) {
					$opt = strtolower( $opt );
					if ( $opt == 'noprotocol' ) {
						$options['noprotocol'] = true;
					}
				}
			}

			$key = isset( $options['noprotocol'] ) ? 'noprotocol' : 'normal';

			// FIXME: not very robust size check, but should work. :)
			if ( !isset( $build[$key] ) ) {
				$build[$key] = $line;
			} elseif ( strlen( $build[$key] ) + strlen( $line ) > $regexMax ) {
				$regexes[] = $regexStart[$key] .
					str_replace( '/', '\/', preg_replace( '|\\\*/|', '/', $build[$key] ) ) .
					$regexEnd[$key];
				$build[$key] = $line;
			} else {
				$build[$key] .= '|' . $line;
			}
		}
		foreach ( $build as $key => $value ) {
			$regexes[] = $regexStart[$key] .
				str_replace( '/', '\/', preg_replace( '|\\\*/|', '/', $value ) ) .
				$regexEnd[$key];
		}

		return $regexes;
	}

	/**
	 * Backend function for confirmEditMerged()
	 * @param WikiPage $page
	 * @param Content|string $newtext
	 * @param string $section
	 * @param IContextSource $context
	 * @param User $user
	 * @return bool false if the CAPTCHA is rejected, true otherwise
	 */
	private function doConfirmEdit(
		WikiPage $page,
		$newtext,
		$section,
		IContextSource $context,
		User $user
	) {
		global $wgRequest;
		$request = $context->getRequest();

		// FIXME: Stop using wgRequest in other parts of ConfirmEdit so we can
		// stop having to duplicate code for it.
		if ( $request->getVal( 'captchaid' ) ) {
			$request->setVal( 'wpCaptchaId', $request->getVal( 'captchaid' ) );
			$wgRequest->setVal( 'wpCaptchaId', $request->getVal( 'captchaid' ) );
		}
		if ( $request->getVal( 'captchaword' ) ) {
			$request->setVal( 'wpCaptchaWord', $request->getVal( 'captchaword' ) );
			$wgRequest->setVal( 'wpCaptchaWord', $request->getVal( 'captchaword' ) );
		}
		if ( $this->shouldCheck( $page, $newtext, $section, $context ) ) {
			return $this->passCaptchaLimitedFromRequest( $wgRequest, $user );
		}

		wfDebug( "ConfirmEdit: no need to show captcha.\n" );
		return true;
	}

	/**
	 * An efficient edit filter callback based on the text after section merging
	 * @param IContextSource $context
	 * @param Content $content
	 * @param Status $status
	 * @param string $summary
	 * @param User $user
	 * @param bool $minorEdit
	 * @return bool
	 */
	public function confirmEditMerged( $context, $content, $status, $summary, $user, $minorEdit ) {
		$title = $context->getTitle();
		if ( !$title->canExist() ) {
			// we check WikiPage only
			// try to get an appropriate title for this page
			$title = $context->getTitle();
			if ( $title instanceof Title ) {
				$title = $title->getFullText();
			} else {
				// otherwise it's an unknown page where this function is called from
				$title = 'unknown';
			}
			// log this error, it could be a problem in another MediaWiki extension,
			// edits should always have a WikiPage if they go through EditFilterMergedContent.
			wfDebug( __METHOD__ . ': Skipped ConfirmEdit check: No WikiPage for title ' . $title );
			return true;
		}
		$page = MediaWikiServices::getInstance()->getWikiPageFactory()->newFromTitle( $title );
		if ( !$this->doConfirmEdit( $page, $content, '', $context, $user ) ) {
			$status->value = EditPage::AS_HOOK_ERROR_EXPECTED;
			$status->statusData = [];
			$fatalErrorMessage = $this->getConfirmEditMergedFatalStatusMessageKey();
			if ( $fatalErrorMessage ) {
				$status->fatal( $fatalErrorMessage );
			}
			$this->addCaptchaAPI( $status->statusData );
			$key = CacheKeyHelper::getKeyForPage( $page );
			$this->activatedCaptchas[$key] = true;
			return false;
		}
		return true;
	}

	/**
	 * Returns the message to be added to the {@link Status} provided to {@link self::confirmEditMerged}
	 * method.
	 */
	protected function getConfirmEditMergedFatalStatusMessageKey(): null|string {
		$message = null;

		// give an error message for the user to know, what goes wrong here.
		// this can't be done for addurl trigger, because this requires one "free" save
		// for the user, which we don't know when they did it.
		if ( $this->action === 'edit' ) {
			// The default message is that the user failed a CAPTCHA, so show 'captcha-edit-fail'.
			$message = 'captcha-edit-fail';
			if ( $this->shouldForceShowCaptcha() ) {
				// If an extension set the forceShowCaptcha property, then it likely means
				// that the user already submitted an edit, and so the 'captcha-edit'
				// message is more appropriate.
				$message = 'captcha-edit';
				[ , $word ] = $this->getCaptchaParamsFromRequest(
					RequestContext::getMain()->getRequest()
				);
				// But if there's a word supplied in the request, then we should
				// use 'captcha-edit-fail' as it indicates a failed attempt
				// at solving the CAPTCHA by the user.
				if ( $word ) {
					$message = 'captcha-edit-fail';
				}
			}
		}

		return $message;
	}

	/**
	 * Logic to check if we need to pass a captcha for the current user
	 * to create a new account, or not
	 *
	 * @param User $creatingUser
	 * @return bool true to show captcha, false to skip captcha
	 */
	public function needCreateAccountCaptcha( User $creatingUser ) {
		if ( $this->triggersCaptcha( CaptchaTriggers::CREATE_ACCOUNT ) ) {
			return !$this->canSkipCaptcha( $creatingUser );
		}
		return false;
	}

	/**
	 * Check the captcha on Special:EmailUser
	 * @param MailAddress $from
	 * @param MailAddress $to
	 * @param string $subject
	 * @param string $text
	 * @param Status &$error
	 * @return bool true to continue saving, false to abort and show a captcha form
	 */
	public function confirmEmailUser( $from, $to, $subject, $text, &$error ) {
		global $wgRequest;

		$user = RequestContext::getMain()->getUser();
		if ( $this->triggersCaptcha( CaptchaTriggers::SENDEMAIL ) ) {
			if ( $this->canSkipCaptcha( $user ) ) {
				return true;
			}

			if ( defined( 'MW_API' ) ) {
				# API mode
				# Asking for captchas in the API is really silly
				$error = Status::newFatal( 'captcha-disabledinapi' );
				return false;
			}
			$this->trigger = "{$user->getName()} sending email";
			if ( !$this->passCaptchaLimitedFromRequest( $wgRequest, $user ) ) {
				$error = Status::newFatal( 'captcha-sendemail-fail' );
				return false;
			}
		}
		return true;
	}

	/**
	 * @param ApiBase $module
	 * @return bool
	 */
	protected function isAPICaptchaModule( $module ) {
		return $module instanceof ApiEditPage;
	}

	/**
	 * @param ApiBase $module
	 * @param array &$params
	 * @param int $flags
	 * @return bool
	 */
	public function apiGetAllowedParams( ApiBase $module, &$params, $flags ) {
		if ( $this->isAPICaptchaModule( $module ) ) {
			$params['captchaword'] = [
				ApiBase::PARAM_HELP_MSG => 'captcha-apihelp-param-captchaword',
			];
			$params['captchaid'] = [
				ApiBase::PARAM_HELP_MSG => 'captcha-apihelp-param-captchaid',
			];
		}

		return true;
	}

	/**
	 * Checks if the user reached the number of false CAPTCHAs and give him some vacation
	 * or run self::passCaptcha() and clear counter if correct.
	 *
	 * @param WebRequest $request
	 * @param User $user
	 * @return bool
	 */
	public function passCaptchaLimitedFromRequest( WebRequest $request, User $user ) {
		[ $index, $word ] = $this->getCaptchaParamsFromRequest( $request );
		return $this->passCaptchaLimited( $index, $word, $user );
	}

	/**
	 * @param WebRequest $request
	 * @return string[]|null[] [ captcha ID, captcha solution ]
	 */
	protected function getCaptchaParamsFromRequest( WebRequest $request ) {
		$index = $request->getVal( 'wpCaptchaId' );
		$word = $request->getVal( 'wpCaptchaWord' );
		return [ $index, $word ];
	}

	/**
	 * Checks, if the user reached the number of false CAPTCHAs and give him some vacation
	 * or run self::passCaptcha() and clear counter if correct.
	 *
	 * @param string|null $index Captcha identifier
	 * @param string|null $word Captcha solution
	 * @param User $user User for throttling captcha solving attempts
	 * @return bool
	 * @see self::passCaptcha()
	 */
	public function passCaptchaLimited( $index, $word, User $user ) {
		// don't increase pingLimiter here, just check, if CAPTCHA limit exceeded
		if ( $user->pingLimiter( 'badcaptcha', 0 ) ) {
			// for debugging add a proper error message, the user will just see a false captcha error message
			$this->log( 'User reached RateLimit, preventing action' );
			return false;
		}

		if ( $this->passCaptcha( $index, $word, $user ) ) {
			return true;
		}

		// captcha was not solved: increase the limit and return false
		$user->pingLimiter( 'badcaptcha' );
		return false;
	}

	/**
	 * Given a required captcha run, test form input for correct
	 * input on the open session.
	 * @param WebRequest $request
	 * @param User $user
	 * @return bool if passed, false if failed or new session
	 */
	public function passCaptchaFromRequest( WebRequest $request, User $user ) {
		[ $index, $word ] = $this->getCaptchaParamsFromRequest( $request );
		return $this->passCaptcha( $index, $word, $user );
	}

	/**
	 * Given a required captcha run, test form input for correct
	 * input on the open session.
	 * @param string|null $index Captcha identifier
	 * @param string|null $word Captcha solution
	 * @param User $user
	 * @return bool if passed, false if failed or new session
	 */
	protected function passCaptcha( $index, $word, $user ) {
		// Don't check the same CAPTCHA twice in one session,
		// if the CAPTCHA was already checked - Bug T94276
		if ( $this->isCaptchaSolved() !== null ) {
			return (bool)$this->isCaptchaSolved();
		}

		if ( $index === null ) {
			$this->log( "new captcha session" );
			// If no captcha ID was passed, we need to start a new session (T384858).
			return false;
		}

		$info = $this->retrieveCaptcha( $index );
		if ( $info ) {
			if ( $this->keyMatch( $word, $info ) ) {
				$this->log( "passed" );
				$this->clearCaptcha( $index );
				$this->setCaptchaSolved( true );
				return true;
			} else {
				$this->clearCaptcha( $index );
				$this->log( "bad form input" );
				$this->setCaptchaSolved( false );
				return false;
			}
		} else {
			$this->log( "new captcha session" );
			return false;
		}
	}

	/**
	 * Log the status and any triggering info for debugging or statistics
	 * @param string $message
	 */
	protected function log( $message ) {
		wfDebugLog(
			'captcha',
			'ConfirmEdit: ' . $message . '; {trigger}',
			'all',
			[ 'trigger' => $this->trigger ]
		);
	}

	/**
	 * Generate a captcha session ID and save the info in PHP's session storage.
	 * (Requires the user to have cookies enabled to get through the captcha.)
	 *
	 * A random ID is used so legit users can make edits in multiple tabs or
	 * windows without being unnecessarily hobbled by a serial order requirement.
	 * Pass the returned id value into the edit form as wpCaptchaId.
	 *
	 * @param array $info data to store
	 * @return string captcha ID key
	 */
	public function storeCaptcha( $info ) {
		if ( !isset( $info['index'] ) ) {
			// Assign random index if we're not updating
			$info['index'] = (string)random_int( 0, PHP_INT_MAX );
		}
		CaptchaStore::get()->store( $info['index'], $info );
		return $info['index'];
	}

	/**
	 * Fetch this session's captcha info.
	 * @param string $index
	 * @return array|false array of info, or false if missing
	 */
	public function retrieveCaptcha( $index ) {
		return CaptchaStore::get()->retrieve( $index );
	}

	/**
	 * Clear out existing captcha info from the session, to ensure
	 * it can't be reused.
	 * @param string $index
	 */
	public function clearCaptcha( $index ) {
		CaptchaStore::get()->clear( $index );
	}

	/**
	 * Retrieve the current version of the page or section being edited...
	 * @param Title $title
	 * @param string $section
	 * @param int $flags Flags for Revision loading methods
	 * @return string
	 * @private
	 */
	private function loadText( $title, $section, $flags = IDBAccessObject::READ_LATEST ) {
		$revRecord = MediaWikiServices::getInstance()
			->getRevisionLookup()
			->getRevisionByTitle( $title, 0, $flags );

		if ( $revRecord === null ) {
			return "";
		}

		try {
			$content = $revRecord->getContent( SlotRecord::MAIN );
		} catch ( RevisionAccessException ) {
			return '';
		}

		$text = ( $content instanceof TextContent ) ? $content->getText() : null;
		if ( $section !== '' ) {
			return MediaWikiServices::getInstance()->getParser()
				->getSection( $text, $section );
		}

		return $text;
	}

	/**
	 * Extract a list of all recognized HTTP links in the text.
	 * @param Title $title
	 * @param string $text
	 * @return string[]
	 */
	private function findLinks( $title, $text ) {
		$parser = MediaWikiServices::getInstance()->getParser();
		$user = $parser->getUserIdentity();
		$options = new ParserOptions( $user );
		$text = $parser->preSaveTransform( $text, $title, $user, $options );
		$out = $parser->parse( $text, $title, $options );

		return array_keys( $out->getExternalLinks() );
	}

	/**
	 * Show a page explaining what this wacky thing is.
	 *
	 * @param OutputPage $out The OutputPage to add the help text to
	 */
	public function showHelp( OutputPage $out ) {
		$msg = wfMessage( static::$messagePrefix . 'help-text' );
		if ( $msg->isDisabled() ) {
			// Fallback to captchahelp-text
			$msg = wfMessage( self::$messagePrefix . 'help-text' );
		}

		$out->addWikiMsg( $msg );
	}

	/**
	 * @return CaptchaAuthenticationRequest
	 */
	public function createAuthenticationRequest() {
		$captchaData = $this->getCaptcha();
		$id = $this->storeCaptcha( $captchaData );
		return new CaptchaAuthenticationRequest( $id, $captchaData );
	}

	/**
	 * Modify the appearance of the captcha field
	 * @param AuthenticationRequest[] $requests
	 * @param array $fieldInfo Field description as given by AuthenticationRequest::mergeFieldInfo
	 * @param array &$formDescriptor A form descriptor suitable for the HTMLForm constructor
	 * @param string $action One of the AuthManager::ACTION_* constants
	 */
	public function onAuthChangeFormFields(
		array $requests, array $fieldInfo, array &$formDescriptor, $action
	) {
		/** @var CaptchaAuthenticationRequest $req */
		$req = AuthenticationRequest::getRequestByClass(
			$requests,
			CaptchaAuthenticationRequest::class,
			true
		);
		if ( !$req ) {
			return;
		}

		$formDescriptor['captchaWord'] = [
			'label-message' => null,
			'autocomplete' => false,
			'persistent' => false,
			'required' => true,
		] + $formDescriptor['captchaWord'];
	}

	/**
	 * Check whether the user provided / IP making the request is allowed to skip captchas
	 */
	public function canSkipCaptcha( User $user ): bool {
		$result = false;
		if ( $user->isAllowed( 'skipcaptcha' ) ) {
			wfDebug( "ConfirmEdit: user group allows skipping captcha\n" );
			$result = true;
		}
		if ( $user->isSystemUser() ) {
			wfDebug( "ConfirmEdit: system user skips captcha\n" );
			$result = true;
		}
		if ( $this->canIPBypassCaptcha() ) {
			wfDebug( "ConfirmEdit: user IP can bypass captcha\n" );
			$result = true;
		}

		$hookRunner = new HookRunner(
			MediaWikiServices::getInstance()->getHookContainer()
		);
		$hookRunner->onConfirmEditCanUserSkipCaptcha( $user, $result );

		return $result;
	}

	/**
	 * Given a list of URLs, returns them concatenated (separated by commas).
	 *
	 * In case the string resulting from concatenating all of them exceeds a
	 * fixed max size of 4 kB, the last URLs are replaced by "...". However, if
	 * no URL is shorter than 4 kB, the returned value will include the shortest
	 * URL plus a ", ..." postfix indicating there are URLs that were omitted.
	 *
	 * @param string[] $urls URLs to be concatenated
	 * @return string
	 */
	private function joinURLs( array $urls ): string {
		if ( count( $urls ) === 0 ) {
			return '';
		}

		usort(
			$urls,
			static fn ( $a, $b ) => strlen( $a ) <=> strlen( $b )
		);

		$urlString = '';

		foreach ( $urls as $link ) {
			if ( strlen( $link ) > 4090 ) {
				// URLs from this one onward cannot fit individually within
				// the size limit.
				break;
			}

			$candidate = ( $urlString === '' ? $link : "{$urlString}, {$link}" );

			// Ensure the list of URLs remains below 4kB. To do so, compare
			// against 4090 to take into account the length of the postfix
			// appended (5 chars) in case $candidate is too long.
			if ( strlen( $candidate ) > 4090 ) {
				$urlString .= ', ...';
				break;
			}

			$urlString = $candidate;
		}

		if ( $urlString === '' ) {
			// All URLs were > 4090 bytes, return the shortest one anyway
			return ( $urls[0] ?? '' ) . ( count( $urls ) > 1 ? ', ...' : '' );
		}

		return $urlString;
	}
}
