// Config registry and store (cJSON in NVS), part of aes67_web.
// Each component registers its group; /api/config is built from the registry.
#pragma once

#include <stdbool.h>
#include <stddef.h>

#include "cJSON.h"
#include "esp_err.h"

// Validate a candidate group object. On failure write "key: reason" to err and return false.
typedef bool (*cfg_validate_cb_t)(const cJSON *group, char *err, size_t err_len);
// Called with the new group values after a successful save (apply live where possible).
typedef void (*cfg_apply_cb_t)(const cJSON *group);

// Project defaults merged over a group's core defaults. Call before that group is registered.
esp_err_t cfg_override_defaults(const char *group, const char *json);
// Register a group. Stored values (NVS) are loaded immediately, merged over the defaults.
esp_err_t cfg_register(const char *group, const char *defaults_json,
                       cfg_validate_cb_t validate, cfg_apply_cb_t apply);
// Copy of a group's current values; caller frees with cJSON_Delete. NULL if not registered.
cJSON *cfg_get(const char *group);

// Validation helpers for validate callbacks. Each returns false and fills err on failure.
bool cfg_check_num(const cJSON *g, const char *key, double min, double max, char *err, size_t n);
bool cfg_check_int(const cJSON *g, const char *key, double min, double max, char *err, size_t n);
bool cfg_check_num_in(const cJSON *g, const char *key, const double *vals, int count, char *err, size_t n);
bool cfg_check_enum(const cJSON *g, const char *key, const char *const *opts, char *err, size_t n);
bool cfg_check_str(const cJSON *g, const char *key, size_t min_len, size_t max_len, char *err, size_t n);
bool cfg_check_ipv4(const cJSON *g, const char *key, bool allow_empty, char *err, size_t n);