<?php

declare(strict_types=1);

defined('ABSPATH') || exit;

/**
 * The plugin's public API for theme and plugin code — how a WordPress developer
 * honors a live patch in their own validation:
 *
 *   if (!sarcio_skips('referral_code_required')) {
 *       // enforce the rule as normal
 *   }
 *
 * All three are safe to call unconditionally: with no live patch (or with the
 * plugin's server tier switched off) they return empty values, so callers never
 * branch on whether Sarcio is installed.
 *
 * @package Sarcio
 */

use Sarcio\WordPress\Context;
use Sarcio\WordPress\Plugin;

if (!function_exists('sarcio_context')) {
    /**
     * The patch context for the current request: the validations a live patch
     * says to skip, its config overrides, and the overridden request body.
     *
     * @return array{body:array<string,mixed>|null,config:array<string,mixed>,skipValidations:array<int,string>}
     */
    function sarcio_context(): array
    {
        return Context::all();
    }
}

if (!function_exists('sarcio_skips')) {
    /** True when a live patch says to skip the named validation on this request. */
    function sarcio_skips(string $validation): bool
    {
        return Context::skips($validation);
    }
}

if (!function_exists('sarcio_config')) {
    /** A named config override from the live patch, or $default when unpatched. */
    function sarcio_config(string $key, mixed $default = null): mixed
    {
        return Context::config($key, $default);
    }
}

if (!function_exists('sarcio_patched_routes')) {
    /**
     * The routes that currently carry a live server patch, as `METHOD /path`.
     * Empty when the server tier is off or the sidecar is unreachable — this
     * reads the same cached route set the request path does, so calling it is
     * cheap and never opens a socket of its own on a warm cache.
     *
     * @return array<int,string>
     */
    function sarcio_patched_routes(): array
    {
        return Plugin::instance()?->shim()?->routeSet() ?? [];
    }
}