<?php
/**
 * LearnDash: enrolments, completions and groups.
 *
 * @package ActivityLog404
 */

namespace ActivityLog404\Events\Integrations;

use ActivityLog404\Events\Integrations;

defined( 'ABSPATH' ) || exit;

/**
 * From LearnDash's developer documentation (developers.learndash.com, 15 Oct
 * 2026; the source is not public, so live verification is a named deferral):
 *
 *  - `learndash_update_course_access( $user_id, $course_id, $access_list, $remove )`
 *    -- enrolled, or removed when `$remove` is true;
 *  - `learndash_course_completed( $data )` -- `$data['user']` (WP_User) and
 *    `$data['course']` (WP_Post);
 *  - `learndash_quiz_completed( $quizdata, $user )` -- since 4.2.1 on a pass
 *    and a fail; `$quizdata`'s keys are not documented, so `quiz` and
 *    `course` are read as an id or a post, `pass` as truthy and
 *    `percentage` only when numeric;
 *  - `ld_added_group_access` / `ld_removed_group_access( $user_id, $group_id )`.
 *
 * Courses, lessons and quizzes themselves are posts (`sfwd-courses`, ...)
 * and their edits are post events, as before.
 */
final class LearnDash implements Integration {

	public const PLUGIN = 'learndash';

	public static function is_active(): bool {
		return Integrations::enabled( self::PLUGIN, defined( 'LEARNDASH_VERSION' ) );
	}

	public static function event_types(): array {
		return Lms::event_types();
	}

	public static function register( ?bool $active = null ): void {
		if ( ! ( $active ?? self::is_active() ) ) {
			return;
		}

		add_action( 'learndash_update_course_access', array( __CLASS__, 'log_course_access' ), 10, 4 );
		add_action( 'learndash_course_completed', array( __CLASS__, 'log_course_completed' ) );
		add_action( 'learndash_quiz_completed', array( __CLASS__, 'log_quiz_completed' ), 10, 2 );
		add_action( 'ld_added_group_access', array( __CLASS__, 'log_group_joined' ), 10, 2 );
		add_action( 'ld_removed_group_access', array( __CLASS__, 'log_group_left' ), 10, 2 );
	}

	public static function post_types(): array {
		return array();
	}

	public static function internal_post_types(): array {
		return array();
	}

	/**
	 * @param mixed $user_id     The student.
	 * @param mixed $course_id   The course.
	 * @param mixed $access_list Legacy access list (unused).
	 * @param mixed $remove      Whether access was removed.
	 */
	public static function log_course_access( $user_id, $course_id, $access_list = null, $remove = false ): void { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundBeforeLastUsed -- the hook's signature.
		$course = People::id( $course_id );
		if ( $course <= 0 ) {
			return;
		}

		People::log(
			$remove ? Lms::UNENROLLED : Lms::ENROLLED,
			$remove ? 'User %1$s removed from course "%2$s"' : 'User %1$s enrolled in course "%2$s"',
			People::id( $user_id ),
			People::post_title( $course ),
			array(
				'plugin'    => self::PLUGIN,
				'course_id' => $course,
			)
		);
	}

	/**
	 * @param mixed $data `user`, `course`, `progress`.
	 */
	public static function log_course_completed( $data ): void {
		if ( ! is_array( $data ) ) {
			return;
		}

		$course = People::id( $data['course'] ?? 0 );
		if ( $course <= 0 ) {
			return;
		}

		People::log(
			Lms::COURSE_COMPLETED,
			'User %1$s completed course "%2$s"',
			People::id( $data['user'] ?? 0 ),
			People::post_title( $course ),
			array(
				'plugin'    => self::PLUGIN,
				'course_id' => $course,
			)
		);
	}

	/**
	 * @param mixed $quizdata The attempt's data.
	 * @param mixed $user     The student.
	 */
	public static function log_quiz_completed( $quizdata, $user ): void {
		if ( ! is_array( $quizdata ) ) {
			return;
		}

		$quiz = People::id( $quizdata['quiz'] ?? 0 );
		if ( $quiz <= 0 ) {
			return;
		}

		$passed  = ! empty( $quizdata['pass'] );
		$details = array(
			'plugin'  => self::PLUGIN,
			'quiz_id' => $quiz,
			'passed'  => $passed,
		);
		$course  = People::id( $quizdata['course'] ?? 0 );
		if ( $course > 0 ) {
			$details['course_id'] = $course;
		}
		$score = Lms::score( $quizdata['percentage'] ?? null );
		if ( null !== $score ) {
			$details['percentage'] = $score;
		}

		People::log(
			Lms::QUIZ_COMPLETED,
			$passed ? 'User %1$s passed quiz "%2$s"' : 'User %1$s did not pass quiz "%2$s"',
			People::id( $user ),
			People::post_title( $quiz ),
			$details
		);
	}

	/**
	 * @param mixed $user_id  The user.
	 * @param mixed $group_id The group.
	 */
	public static function log_group_joined( $user_id, $group_id ): void {
		self::group_row( Lms::GROUP_JOINED, 'User %1$s added to group "%2$s"', $user_id, $group_id );
	}

	/**
	 * @param mixed $user_id  The user.
	 * @param mixed $group_id The group.
	 */
	public static function log_group_left( $user_id, $group_id ): void {
		self::group_row( Lms::GROUP_LEFT, 'User %1$s removed from group "%2$s"', $user_id, $group_id );
	}

	/**
	 * @param string $type     Event type.
	 * @param string $format   Summary format.
	 * @param mixed  $user_id  The user.
	 * @param mixed  $group_id The group.
	 */
	private static function group_row( string $type, string $format, $user_id, $group_id ): void {
		$group = People::id( $group_id );
		if ( $group <= 0 ) {
			return;
		}

		People::log(
			$type,
			$format,
			People::id( $user_id ),
			People::post_title( $group ),
			array(
				'plugin'   => self::PLUGIN,
				'group_id' => $group,
			)
		);
	}
}