// Copyright 2021 Espressif Systems (Shanghai) PTE LTD
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#pragma once

#include <esp_err.h>
#include <stdbool.h>
#include <stdint.h>

#include <app/data-model/Nullable.h>

/* Nullable base for nullable attribute */
#define ESP_MATTER_VAL_NULLABLE_BASE 0x80

/** ESP Matter Attribute Value type */
typedef enum {
    /** Invalid */
    ESP_MATTER_VAL_TYPE_INVALID = 0,
    /** Boolean */
    ESP_MATTER_VAL_TYPE_BOOLEAN = 1,
    /** Integer. Mapped to a 32 bit signed integer */
    ESP_MATTER_VAL_TYPE_INTEGER = 2,
    /** Floating point number */
    ESP_MATTER_VAL_TYPE_FLOAT = 3,
    /** Array Eg. [1,2,3] */
    ESP_MATTER_VAL_TYPE_ARRAY = 4,
    /** Char String Eg. "123", Max length 0xFE */
    ESP_MATTER_VAL_TYPE_CHAR_STRING = 5,
    /** Octet String Eg. [0x01, 0x20], Max length 0xFE */
    ESP_MATTER_VAL_TYPE_OCTET_STRING = 6,
    /** 8 bit signed integer */
    ESP_MATTER_VAL_TYPE_INT8 = 7,
    /** 8 bit unsigned integer */
    ESP_MATTER_VAL_TYPE_UINT8 = 8,
    /** 16 bit signed integer */
    ESP_MATTER_VAL_TYPE_INT16 = 9,
    /** 16 bit unsigned integer */
    ESP_MATTER_VAL_TYPE_UINT16 = 10,
    /** 32 bit signed integer */
    ESP_MATTER_VAL_TYPE_INT32 = 11,
    /** 32 bit unsigned integer */
    ESP_MATTER_VAL_TYPE_UINT32 = 12,
    /** 64 bit signed integer */
    ESP_MATTER_VAL_TYPE_INT64 = 13,
    /** 64 bit unsigned integer */
    ESP_MATTER_VAL_TYPE_UINT64 = 14,
    /** 8 bit enum */
    ESP_MATTER_VAL_TYPE_ENUM8 = 15,
    /** 8 bit bitmap */
    ESP_MATTER_VAL_TYPE_BITMAP8 = 16,
    /** 16 bit bitmap */
    ESP_MATTER_VAL_TYPE_BITMAP16 = 17,
    /** 32 bit bitmap */
    ESP_MATTER_VAL_TYPE_BITMAP32 = 18,
    /** 16 bit enum */
    ESP_MATTER_VAL_TYPE_ENUM16 = 19,
    /** Long Char String, Max length 0xFFFE **/
    ESP_MATTER_VAL_TYPE_LONG_CHAR_STRING = 20,
    /** Long Octet String, Max length 0xFFFE **/
    ESP_MATTER_VAL_TYPE_LONG_OCTET_STRING = 21,

    /** nullable types **/
    ESP_MATTER_VAL_TYPE_NULLABLE_BOOLEAN = ESP_MATTER_VAL_TYPE_BOOLEAN + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_INTEGER = ESP_MATTER_VAL_TYPE_INTEGER + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_FLOAT = ESP_MATTER_VAL_TYPE_FLOAT + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_INT8 = ESP_MATTER_VAL_TYPE_INT8 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_UINT8 = ESP_MATTER_VAL_TYPE_UINT8 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_INT16 = ESP_MATTER_VAL_TYPE_INT16 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_UINT16 = ESP_MATTER_VAL_TYPE_UINT16 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_INT32 = ESP_MATTER_VAL_TYPE_INT32 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_UINT32 = ESP_MATTER_VAL_TYPE_UINT32 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_INT64 = ESP_MATTER_VAL_TYPE_INT64 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_UINT64 = ESP_MATTER_VAL_TYPE_UINT64 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_ENUM8 = ESP_MATTER_VAL_TYPE_ENUM8 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_BITMAP8 = ESP_MATTER_VAL_TYPE_BITMAP8 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_BITMAP16 = ESP_MATTER_VAL_TYPE_BITMAP16 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_BITMAP32 = ESP_MATTER_VAL_TYPE_BITMAP32 + ESP_MATTER_VAL_NULLABLE_BASE,
    ESP_MATTER_VAL_TYPE_NULLABLE_ENUM16 = ESP_MATTER_VAL_TYPE_ENUM16 + ESP_MATTER_VAL_NULLABLE_BASE,
} esp_matter_val_type_t;

/** ESP Matter Value */
typedef union {
    /** Boolean */
    bool b;
    /** Integer */
    int i;
    /** Float */
    float f;
    /** 8 bit signed integer */
    int8_t i8;
    /** 8 bit unsigned integer */
    uint8_t u8;
    /** 16 bit signed integer */
    int16_t i16;
    /** 16 bit unsigned integer */
    uint16_t u16;
    /** 32 bit signed integer */
    int32_t i32;
    /** 32 bit unsigned integer */
    uint32_t u32;
    /** 64 bit signed integer */
    int64_t i64;
    /** 64 bit unsigned integer */
    uint64_t u64;
    /** Array */
    struct {
        /** Buffer */
        uint8_t *b;
        /** Data size */
        uint16_t s;
        /** Data max size */
        uint16_t max;
        /** Total size */
        uint16_t t;
    } a;
    /** Pointer */
    void *p;
} esp_matter_val_t;

/** ESP Matter Attribute Value */
typedef struct {
    /** Type of Value */
    esp_matter_val_type_t type;
    /** Actual value. Depends on the type */
    esp_matter_val_t val;
} esp_matter_attr_val_t;

/** ESP Matter Attribute Bounds */
typedef struct esp_matter_attr_bounds {
    /** Minimum Value */
    esp_matter_attr_val_t min;
    /** Maximum Value */
    esp_matter_attr_val_t max;
    /** TODO: Step Value might be needed here later */
} esp_matter_attr_bounds_t;

template <typename T>
class nullable {

    /** NOTE: GetNullValue is taken from src/app/util/attribute-storage-null-handling.h */
private:
    template <typename U = T, typename std::enable_if_t<std::is_floating_point<U>::value, int> = 0>
    static constexpr T GetNullValue()
    {
        return std::numeric_limits<T>::quiet_NaN();
    }

    template <typename U = T, typename std::enable_if_t<std::is_integral<U>::value, int> = 0>
    static constexpr T GetNullValue()
    {
        return std::is_signed<T>::value ? std::numeric_limits<T>::min() : std::numeric_limits<T>::max();
    }

    template <typename U = T, typename std::enable_if_t<std::is_enum<U>::value, int> = 0>
    static constexpr T GetNullValue()
    {
        static_assert(!std::is_signed<std::underlying_type_t<T>>::value, "Enums must be unsigned");
        return static_cast<T>(std::numeric_limits<std::underlying_type_t<T>>::max());
    }

public:
    nullable(T value)
    {
        if (chip::app::NumericAttributeTraits<T>::IsNullValue(value)) {
            chip::app::NumericAttributeTraits<T>::SetNull(val);
        } else {
            val = value;
        }
    }

    nullable()
    {
        chip::app::NumericAttributeTraits<T>::SetNull(val);
    }

    T value()
    {
        if (is_null()) {
            return GetNullValue();
        } else {
            return val;
        }

    }

    T value_or(T ret)
    {
        return is_null() ? ret : val;
    }

    bool is_null()
    {
        return chip::app::NumericAttributeTraits<T>::IsNullValue(val);
    }

    void operator=(T value)
    {
        if (chip::app::NumericAttributeTraits<T>::IsNullValue(value)) {
            chip::app::NumericAttributeTraits<T>::SetNull(this->val);
        } else {
            this->val = value;
        }
    }

    void operator=(std::nullptr_t)
    {
        chip::app::NumericAttributeTraits<T>::SetNull(this->val);
    }
private:
    T val;
};

/** Template specialization for bool */
template <>
class nullable<bool> {
    using Traits      = chip::app::NumericAttributeTraits<bool>;
    using StorageType = typename Traits::StorageType; // Resolves to uint8_t

    static_assert(std::is_same_v<StorageType, uint8_t>,
                  "nullable<bool> specialization assumes bool StorageType is uint8_t. Revisit if this changes.");

public:
    /** Constructors */
    nullable()
    {
        Traits::SetNull(storage);
    }
    nullable(std::nullptr_t)
    {
        Traits::SetNull(storage);
    }
    constexpr nullable(bool v)               : storage(static_cast<StorageType>(v)) {}

    /** Observers */
    constexpr bool is_null()  const
    {
        return Traits::IsNullValue(storage);
    }

    /**
     * @brief Gets the stored bool value.
     *
     * Returns the boolean interpretation of the internal storage.
     * @warning Returns `true` when `is_null()` is true. Check `is_null()` first
     *          if the distinction between null and `true` is important.
     *
     * Example:
     * ```
     * nullable<bool> v_true(true);   // v_true.value() == true
     * nullable<bool> v_false(false); // v_false.value() == false
     * nullable<bool> v_null;         // v_null.value() == true (because internal null 0xFF is non-zero)
     * ```
     * @return `true` if storage is non-zero (includes null state), `false` if storage is zero.
     */
    constexpr bool value()  const
    {
        return static_cast<bool>(storage);
    }

    constexpr bool value_or(bool d)  const
    {
        return is_null() ? d : static_cast<bool>(storage);
    }

    /** Modifiers */
    void operator=(std::nullptr_t)
    {
        Traits::SetNull(storage);
    }
    void operator=(bool v)
    {
        storage = static_cast<StorageType>(v);
    }

private:
    StorageType storage; // 1‑byte payload holding 0 / 1 / 0xFF
};

/*** Attribute val APIs ***/
/** Invalid */
esp_matter_attr_val_t esp_matter_invalid(void *val);
/** Boolean */
esp_matter_attr_val_t esp_matter_bool(bool val);
esp_matter_attr_val_t esp_matter_nullable_bool(nullable<bool> val);

/** Integer */
esp_matter_attr_val_t esp_matter_int(int val);
esp_matter_attr_val_t esp_matter_nullable_int(nullable<int> val);

/** Float */
esp_matter_attr_val_t esp_matter_float(float val);
esp_matter_attr_val_t esp_matter_nullable_float(nullable<float> val);

/** 8 bit integer */
esp_matter_attr_val_t esp_matter_int8(int8_t val);
esp_matter_attr_val_t esp_matter_nullable_int8(nullable<int8_t> val);

/** 8 bit unsigned integer */
esp_matter_attr_val_t esp_matter_uint8(uint8_t val);
esp_matter_attr_val_t esp_matter_nullable_uint8(nullable<uint8_t> val);

/** 16 bit signed integer */
esp_matter_attr_val_t esp_matter_int16(int16_t val);
esp_matter_attr_val_t esp_matter_nullable_int16(nullable<int16_t> val);

/** 16 bit unsigned integer */
esp_matter_attr_val_t esp_matter_uint16(uint16_t val);
esp_matter_attr_val_t esp_matter_nullable_uint16(nullable<uint16_t> val);

/** 32 bit signed integer */
esp_matter_attr_val_t esp_matter_int32(int32_t val);
esp_matter_attr_val_t esp_matter_nullable_int32(nullable<int32_t> val);

/** 32 bit unsigned integer */
esp_matter_attr_val_t esp_matter_uint32(uint32_t val);
esp_matter_attr_val_t esp_matter_nullable_uint32(nullable<uint32_t> val);

/** 64 bit signed integer */
esp_matter_attr_val_t esp_matter_int64(int64_t val);
esp_matter_attr_val_t esp_matter_nullable_int64(nullable<int64_t> val);

/** 64 bit unsigned integer */
esp_matter_attr_val_t esp_matter_uint64(uint64_t val);
esp_matter_attr_val_t esp_matter_nullable_uint64(nullable<uint64_t> val);

/** 8 bit enum */
esp_matter_attr_val_t esp_matter_enum8(uint8_t val);
esp_matter_attr_val_t esp_matter_nullable_enum8(nullable<uint8_t> val);

/** 16 bit enum */
esp_matter_attr_val_t esp_matter_enum16(uint16_t val);
esp_matter_attr_val_t esp_matter_nullable_enum16(nullable<uint16_t> val);

/** 8 bit bitmap */
esp_matter_attr_val_t esp_matter_bitmap8(uint8_t val);
esp_matter_attr_val_t esp_matter_nullable_bitmap8(nullable<uint8_t> val);

/** 16 bit bitmap */
esp_matter_attr_val_t esp_matter_bitmap16(uint16_t val);
esp_matter_attr_val_t esp_matter_nullable_bitmap16(nullable<uint16_t> val);

/** 32 bit bitmap */
esp_matter_attr_val_t esp_matter_bitmap32(uint32_t val);
esp_matter_attr_val_t esp_matter_nullable_bitmap32(nullable<uint32_t> val);

/** Character string */
esp_matter_attr_val_t esp_matter_char_str(char *val, uint16_t data_size);
esp_matter_attr_val_t esp_matter_long_char_str(char *val, uint16_t data_size);

/** Octet string */
esp_matter_attr_val_t esp_matter_octet_str(uint8_t *val, uint16_t data_size);
esp_matter_attr_val_t esp_matter_long_octet_str(uint8_t *val, uint16_t data_size);

/** Array */
esp_matter_attr_val_t esp_matter_array(uint8_t *val, uint16_t data_size, uint16_t count);

namespace esp_matter {

namespace attribute {

/** Attribute update callback type */
typedef enum callback_type {
    /** Callback before updating the value in the database */
    PRE_UPDATE,
    /** Callback after updating the value in the database */
    POST_UPDATE,
    /** Callback for reading the attribute value. This is used when the `ATTRIBUTE_FLAG_OVERRIDE` is set. */
    READ,
    /** Callback for writing the attribute value. This is used when the `ATTRIBUTE_FLAG_OVERRIDE` is set. */
    WRITE,
} callback_type_t;

/** Callback for attribute update
 *
 * @note If the callback type is `PRE_UPDATE` and an error is returned from the callback, the attribute will
 * not be updated.
 *
 * @param[in] type callback type.
 * @param[in] endpoint_id Endpoint ID of the attribute.
 * @param[in] cluster_id Cluster ID of the attribute.
 * @param[in] attribute_id Attribute ID of the attribute.
 * @param[in] val Pointer to `esp_matter_attr_val_t`. Use appropriate elements as per the value type.
 * @param[in] priv_data Pointer to the private data passed while creating the endpoint.
 *
 * @return ESP_OK on success.
 * @return error in case of failure.
 */
typedef esp_err_t (*callback_t)(callback_type_t type, uint16_t endpoint_id, uint32_t cluster_id, uint32_t attribute_id,
                                esp_matter_attr_val_t *val, void *priv_data);

/** Set attribute callback
 *
 * Set the common attribute update callback. Whenever an attribute managed by the application is updated, the callback
 * will be called with the appropriate `callback_type_t`.
 *
 * @param[in] callback attribute update callback.
 *
 * @return ESP_OK on success.
 * @return error in case of failure.
 */
esp_err_t set_callback(callback_t callback);

/** Attribute update
 *
 * This API updates the attribute value.
 * After this API is called, the application gets the attribute update callback with `PRE_UPDATE`, then the
 * attribute is updated in the database, then the application get the callback with `POST_UPDATE`.
 *
 * @param[in] endpoint_id Endpoint ID of the attribute.
 * @param[in] cluster_id Cluster ID of the attribute.
 * @param[in] attribute_id Attribute ID of the attribute.
 * @param[in] val Pointer to `esp_matter_attr_val_t`. Appropriate elements should be used as per the value type.
 *
 * @return ESP_OK on success.
 * @return error in case of failure.
 */
esp_err_t update(uint16_t endpoint_id, uint32_t cluster_id, uint32_t attribute_id, esp_matter_attr_val_t *val);

/** Attribute report
 *
 * This API reports the attribute value.
 * After this API is called, the application doesn't gets the attribute update callback with `PRE_UPDATE` or `POST_UPDATE`, the
 * attribute is updated in the database.
 * This also marks the attribute as dirty, so that it can be reported in the next subscription report.
 *
 * @param[in] endpoint_id Endpoint ID of the attribute.
 * @param[in] cluster_id Cluster ID of the attribute.
 * @param[in] attribute_id Attribute ID of the attribute.
 *
 * @return ESP_OK on success.
 * @return error in case of failure.
 */
esp_err_t report(uint16_t endpoint_id, uint32_t cluster_id, uint32_t attribute_id, esp_matter_attr_val_t *val);

/** Attribute value print
 *
 * This API prints the attribute value according to the type.
 *
 * @param[in] endpoint_id Endpoint ID of the attribute.
 * @param[in] cluster_id Cluster ID of the attribute.
 * @param[in] attribute_id Attribute ID of the attribute.
 * @param[in] val Pointer to `esp_matter_attr_val_t`. Appropriate elements should be used as per the value type.
 * @param[in] is_read Boolean variable to indicate read or write for attributes.
 */
void val_print(uint16_t endpoint_id, uint32_t cluster_id, uint32_t attribute_id, esp_matter_attr_val_t *val, bool is_read);

/** Attribute value compare
 *
 * This API compares the two attribute values.
 *
 * @param[in] val1 Pointer to the first attribute value.
 * @param[in] val2 Pointer to the second attribute value.
 *
 * @return true if the two values are the same.
 * @return false if the two values are different.
 */
bool val_compare(const esp_matter_attr_val_t *val1, const esp_matter_attr_val_t *val2);

} /* attribute */
} /* esp_matter */
