<?php
/**
 * Read the local Search Ops capability contract without coupling Optimiser to
 * a Content Pal implementation class.
 */
if ( ! defined( 'ABSPATH' ) ) { exit; }

final class AI_O_Optimiser_Search_Ops_Ownership {
    public const CONTRACT = 'aio-search-ops/1';

    /** @return array<string,mixed>|null */
    public static function manifest() {
        // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Published by the Search Ops plugin under its aio-search-ops/1 contract, not ours to rename; this side only reads it.
        $manifest = apply_filters( 'aio_search_ops_capability_manifest', null );
        if ( ! is_array( $manifest ) ) { return null; }
        if ( self::CONTRACT !== (string) ( $manifest['contract'] ?? '' ) ) { return null; }
        $authority = (string) ( $manifest['authority'] ?? '' );
        if ( ! in_array( $authority, array( 'foundation', 'shadow', 'authoritative' ), true ) ) { return null; }
        return $manifest;
    }

    public static function authority(): string {
        $manifest = self::manifest();
        return is_array( $manifest ) ? (string) $manifest['authority'] : '';
    }

    public static function external_authoritative(): bool {
        return 'authoritative' === self::authority();
    }
}