<?php
/**
 * What every third-party integration answers.
 *
 * @package ActivityLog404
 */

namespace ActivityLog404\Events\Integrations;

defined( 'ABSPATH' ) || exit;

/**
 * The static shape every integration class has (see Events\Integrations).
 */
interface Integration {

	/** Whether the integration's plugin is loaded on this request. */
	public static function is_active(): bool;

	/**
	 * @return array<string, string> Event type => label for the log's filter.
	 */
	public static function event_types(): array;

	/**
	 * Add the integration's hooks, only when its plugin is active.
	 *
	 * @param bool|null $active Whether the plugin is active; null asks is_active(). Tests pass it.
	 */
	public static function register( ?bool $active = null ): void;

	/**
	 * Post types this integration's plugin keeps its own objects in, logged
	 * as that object rather than as a post.
	 *
	 * @return array<string, array{prefix: string, noun: string, plugin: string}>
	 */
	public static function post_types(): array;

	/**
	 * Post types the plugin uses internally, never logged as posts.
	 *
	 * @return array<int, string>
	 */
	public static function internal_post_types(): array;
}