<?php
/**
 * Webhook lookup.
 *
 * @package FormPilot
 * @since   1.0.0
 */

declare( strict_types = 1 );

namespace FormPilot\Webhooks;

use FormPilot\Models\Form;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Reads the webhooks a form has been given.
 *
 * They live in the form's settings, next to its notifications, because that is
 * what they are: another thing that happens when a submission arrives. A site
 * can add endpoints that are not in the settings at all through the filter.
 *
 * @since 1.0.0
 */
final class WebhookRegistry {

	/**
	 * Settings key holding the webhooks.
	 */
	public const SETTING = 'webhooks';

	/**
	 * Largest number of endpoints one form may hold.
	 */
	public const LIMIT = 10;

	/**
	 * Returns every webhook of a form, active or not.
	 *
	 * @param Form $form Form to read.
	 *
	 * @return array<string, Webhook> Webhooks keyed by their identifier.
	 */
	public function all( Form $form ): array {
		$stored   = $form->setting( self::SETTING, array() );
		$stored   = is_array( $stored ) ? $stored : array();
		$webhooks = array();

		foreach ( $stored as $key => $data ) {
			$key = sanitize_key( (string) $key );

			if ( '' === $key || ! is_array( $data ) ) {
				continue;
			}

			$webhooks[ $key ] = Webhook::from_array( $key, $data );
		}

		/**
		 * Filters the webhooks of a form.
		 *
		 * Lets a site send submissions somewhere without storing an endpoint, and
		 * a secret, in the database.
		 *
		 * @since 1.0.0
		 *
		 * @param array<string, Webhook> $webhooks Webhooks keyed by identifier.
		 * @param Form                   $form     Form they belong to.
		 */
		$webhooks = (array) apply_filters( 'formpilot_webhooks', $webhooks, $form );

		return array_filter( $webhooks, static fn( $webhook ): bool => $webhook instanceof Webhook );
	}

	/**
	 * Returns the webhooks that should receive a submission.
	 *
	 * @param Form $form Form to read.
	 *
	 * @return array<string, Webhook> Webhooks keyed by their identifier.
	 */
	public function active( Form $form ): array {
		return array_filter( $this->all( $form ), static fn( Webhook $webhook ): bool => $webhook->is_active() );
	}

	/**
	 * Returns one webhook of a form.
	 *
	 * @param Form   $form Form to read.
	 * @param string $key  Webhook identifier.
	 *
	 * @return Webhook|null The webhook, or null when the form has no such entry.
	 */
	public function find( Form $form, string $key ): ?Webhook {
		return $this->all( $form )[ sanitize_key( $key ) ] ?? null;
	}
}