cdumay_error_json 0.1.6

# cdumay_error_json

[![License: BSD-3-Clause](https://img.shields.io/badge/license-BSD--3--Clause-blue)](./LICENSE)
[![cdumay_error_json on crates.io](https://img.shields.io/crates/v/cdumay_error_json)](https://crates.io/crates/cdumay_error_json)
[![cdumay_error_json on docs.rs](https://docs.rs/cdumay_error_json/badge.svg)](https://docs.rs/cdumay_error_json)
[![Source Code Repository](https://img.shields.io/badge/Code-On%20GitHub-blue?logo=GitHub)](https://github.com/cdumay/cdumay_error_json)

A utility crate that converts `serde_json::Error` into structured, typed errors using the [`cdumay_error`](https://docs.rs/cdumay-error/) framework. This ensures consistent error handling, easier debugging, and informative error reporting across your Rust applications.

### Features

- Categorizes `serde_json::Error` into specific error types (`Syntax`, `IO`, `Data`, `EOF`)
- Each error type is associated with a custom code, HTTP status, and descriptive message
- Structured output for APIs, logging systems, and observability platforms
- Includes context metadata via `BTreeMap`
- Provides a convenient `convert_result!` macro for error conversion

### Usage

Using the `JsonErrorConverter` directly:
```rust
use cdumay_error::ErrorConverter;
use serde_json::Value;
use std::collections::BTreeMap;
use cdumay_error_json::JsonErrorConverter;

fn parse_json(input: &str) -> Result<Value, cdumay_error::Error> {
    serde_json::from_str::<Value>(input).map_err(|e| {
       let mut ctx = BTreeMap::new();
       ctx.insert("input".to_string(), serde_value::Value::String(input.to_string()));
       JsonErrorConverter::convert(&e, "Failed to parse JSON".to_string(), ctx)
   })
}
```

Using the `convert_result!` macro:
```rust
use cdumay_error_json::convert_result;
use serde_json::Value;
use std::collections::BTreeMap;
use cdumay_error::ErrorConverter;

fn parse_json(input: &str) -> Result<Value, cdumay_error::Error> {
    // Basic usage with just the result
    convert_result!(serde_json::from_str::<Value>(input));

    // With custom error message
    convert_result!(serde_json::from_str::<Value>(input), "Failed to parse JSON");

    // With custom context and message
    let mut ctx = BTreeMap::new();
    ctx.insert("input".to_string(), serde_value::Value::String(input.to_string()));
    convert_result!(serde_json::from_str::<Value>(input), ctx, "Failed to parse JSON")
}
```