<?php
defined( 'ABSPATH' ) || exit;

/** All configured groups, including extension-owned targets. No network calls. */
function customfields_get_groups() {
    $groups = get_option( 'customfields_groups', array() );
    return apply_filters( 'customfields_registered_groups', is_array( $groups ) ? array_values( $groups ) : array() );
}

/**
 * Read a registered field on a matching post type; never arbitrary private metadata.
 * Returns the configured default only when no metadata row exists. Escape for your output context.
 */
function customfields_get( $name, $post_id = 0 ) {
    if ( ! is_string( $name ) || ! preg_match( '/^[a-z][a-z0-9_]{0,63}$/D', $name ) ) { return null; }
    $post_id = $post_id ? absint( $post_id ) : get_the_ID();
    $post = get_post( $post_id );
    if ( ! $post ) { return null; }
    foreach ( customfields_get_groups() as $group ) {
        if ( ! \CustomFields\Editor::matches( $group, $post ) ) { continue; }
        foreach ( $group['fields'] as $field ) {
            if ( $field['name'] !== $name ) { continue; }
            $value = metadata_exists( 'post', $post_id, $name ) ? get_post_meta( $post_id, $name, true ) : ( $field['default'] ?? '' );
            if ( 'checkbox' === $field['type'] ) { $value = (bool) $value; }
            if ( 'number' === $field['type'] && '' !== $value && is_numeric( $value ) ) { $value = (float) $value; }
            return apply_filters( 'customfields_get_value', $value, $field, $post_id );
        }
    }
    return null;
}

/** Registered user/term values for trusted PHP templates; callers authorize and escape output. */
function customfields_get_object( $name, $kind, $object_id, $fallback = null ) {
    if ( ! is_string( $name ) || ! in_array( $kind, array( 'user', 'term' ), true ) || ! is_numeric( $object_id ) || $object_id < 1 ) { return $fallback; }
    if ( 'user' === $kind && \CustomFields\Schema::reserved_user_name( $name ) ) { return $fallback; }
    $object_id = (int) $object_id;
    foreach ( customfields_get_groups() as $group ) {
        if ( ( $group['target'] ?? '' ) !== $kind ) { continue; }
        if ( 'term' === $kind ) { $term = get_term( $object_id ); if ( ! $term || is_wp_error( $term ) || ! in_array( $term->taxonomy, $group['taxonomies'] ?? array(), true ) ) { continue; } }
        elseif ( ! get_userdata( $object_id ) ) { return $fallback; }
        foreach ( $group['fields'] as $field ) {
            if ( $field['name'] !== $name ) { continue; }
            $value = metadata_exists( $kind, $object_id, $name ) ? get_metadata( $kind, $object_id, $name, true ) : $field['default'];
            if ( 'checkbox' === $field['type'] ) { return (bool) $value; }
            return $value;
        }
    }
    return $fallback;
}