feat: turnkey

Author: RAprogramm

CHANGELOG.md

@@ -1,6 +1,17 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.3.2] - 2025-09-08
+### Added
+- New feature flag `turnkey`:
+  - Provides `TurnkeyErrorKind` (stable taxonomy of Turnkey-specific failures).
+  - Provides `TurnkeyError` (kind + public message).
+  - Adds `classify_turnkey_error` helper for mapping raw SDK/provider messages.
+  - Includes conversions into `AppError` / `AppErrorKind`.
+
+### Notes
+- Feature is framework-agnostic; no extra dependencies are pulled.
+
 ## [0.3.1] - 2025-08-25
 ### Added
 - Implemented `axum::response::IntoResponse` for `AppError` (behind the `axum` feature).
@@ -50,6 +61,7 @@ All notable changes to this project will be documented in this file.
 - **MSRV:** 1.89
 - **No unsafe:** the crate forbids `unsafe`.
 
+[0.3.2]: https://github.com/RAprogramm/masterror/releases/tag/v0.3.2
 [0.3.1]: https://github.com/RAprogramm/masterror/releases/tag/v0.3.1
 [0.3.0]: https://github.com/RAprogramm/masterror/releases/tag/v0.3.0
 [0.2.1]: https://github.com/RAprogramm/masterror/releases/tag/v0.2.1

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "masterror"
-version = "0.3.1"
+version = "0.3.2"
 rust-version = "1.89"
 edition = "2024"
 description = "Application error types and response mapping"
@@ -24,6 +24,7 @@ config = ["dep:config"]                     # config::ConfigError -> AppError
 multipart = ["axum"]
 tokio = ["dep:tokio"]
 reqwest = ["dep:reqwest"]
+turnkey = []
 
 openapi = ["dep:utoipa"]
 

Cargo.toml

@@ -172,6 +172,7 @@ utoipa = "5"
 - `openapi` — utoipa schema  
 - `serde_json` — JSON details  
 - `sqlx`, `redis`, `reqwest`, `validator`, `config`, `tokio`, `multipart`
+- `turnkey` — domain taxonomy and conversions for Turnkey errors
 
 </details>
 
@@ -218,6 +219,26 @@ masterror = { version = "0.3", features = [
 
 </details>
 
+<details>
+  <summary><b>Turnkey</b></summary>
+
+~~~rust
+// features = ["turnkey"]
+use masterror::turnkey::{classify_turnkey_error, TurnkeyError, TurnkeyErrorKind};
+use masterror::{AppError, AppErrorKind};
+
+// Classify a raw SDK/provider error
+let kind = classify_turnkey_error("429 Too Many Requests");
+assert!(matches!(kind, TurnkeyErrorKind::RateLimited));
+
+// Wrap into AppError
+let e = TurnkeyError::new(TurnkeyErrorKind::RateLimited, "throttled upstream");
+let app: AppError = e.into();
+assert_eq!(app.kind, AppErrorKind::RateLimited);
+~~~
+
+</details>
+
 <details>
   <summary><b>Migration 0.2 → 0.3</b></summary>