Bumping version to v0.9.0 + README + CHANGELOG

Author: JeremieRodon

CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.0] - 2026-01-09
+
+### Added
+- **Tracing support**: New `tracing` feature flag enables tracing/tracing-subscriber integration as an alternative to env_logger
+- **Configurable logging initialization**: New `log_init = function_name` macro parameter allows custom log initialization functions instead of relying on defaults
+- **Event logging control**: New `event_logging = bool` macro parameter controls whether Lambda event payloads are logged (defaults to `false` for better security)
+- Structured JSON logging by default when tracing is enabled
+- `#[tracing::instrument]` attributes on generated handler functions with request ID and operation name in trace spans
+- Signature validation for the `hook` option with clear error messages for invalid function signatures
+
+### Changed
+- **Breaking**: Event payload logging is now disabled by default for security reasons (can be re-enabled with `event_logging = true`)
+- When Lambda event payloads logging is enabled, Lambda event payloads are now logged at `debug` level instead of `info`
+- `env_logger` is now an optional feature (still enabled by default for backward compatibility)
+- Independent `log` feature flag controls log statement generation in generated code
+
+### Fixed
+- Generated `main` and `function_handler` now use fully qualified `::core::result::Result` instead of `Result`, preventing compilation failures when users override the Result type
+- Request hook trybuild test was not actually testing anything
+- Release CI could fail tests but still proceed with publishing
+
+[0.9.0]: https://github.com/JeremieRodon/lambda-appsync/compare/v0.8.0...v0.9.0
+
 ## [0.8.0] - 2025-11-16
 
 ### Changed

Cargo.lock

@@ -3,7 +3,7 @@ members = ["lambda-appsync", "lambda-appsync-proc"]
 resolver = "2"
 
 [workspace.package]
-version = "0.8.0"
+version = "0.9.0"
 rust-version = "1.82.0"
 edition = "2021"
 authors = ["Jérémie RODON <jeremie.rodon@gmail.com>"]

Cargo.toml

@@ -20,6 +20,8 @@ The lambda-appsync crate provides procedural macros that convert GraphQL schemas
 - 📦 Performance-optimized batching support
 - 🛡️ Flexible request validation hooks (e.g. for advanced authentication flows)
 - 🔐 Comprehensive support for all AWS AppSync auth types
+- 📊 Configurable logging with support for either `env_logger` and `tracing` (or both!)
+- 🔧 Custom log initialization functions
 
 ## Known limitations
 
@@ -37,7 +39,7 @@ Add this dependency to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-lambda-appsync = "0.8.0"
+lambda-appsync = "0.9.0"
 ```
 
 ## Quick Start
@@ -253,6 +255,87 @@ async fn store_item(item: Item, client: &aws_sdk_dynamodb::Client) -> Result<(),
 
 Error types and messages are extracted from AWS SDK error metadata, allowing use of the `?` operator with AWS SDK calls for properly formatted AppSync response errors.
 
+### Logging Configuration
+
+The framework provides flexible logging configuration with support for both `env_logger` (default) and `tracing`.
+
+#### Default Logging (env_logger)
+
+By default, lambda-appsync uses `env_logger`:
+
+```rust
+appsync_lambda_main!(
+    "graphql/schema.gql",
+    dynamodb() -> aws_sdk_dynamodb::Client,
+);
+```
+
+#### Custom Log Initialization
+
+Override the default logging setup with a custom function:
+
+```rust
+fn custom_log_init() {
+    use lambda_appsync::env_logger;
+    env_logger::Builder::from_env(
+        env_logger::Env::default()
+            .default_filter_or("info,tracing::span=warn")
+            .default_write_style_or("never"),
+    )
+    .format_timestamp_micros()
+    .init();
+}
+
+appsync_lambda_main!(
+    "graphql/schema.gql",
+    log_init = custom_log_init,
+    dynamodb() -> aws_sdk_dynamodb::Client,
+);
+```
+
+#### Tracing Support
+
+Enable structured JSON logging with tracing by adding the `tracing` feature:
+
+```toml
+[dependencies]
+lambda-appsync = { version = "0.9.0", default-features = false, features = ["tracing"] }
+```
+
+```rust
+fn tracing_init() {
+    use lambda_appsync::{tracing, tracing_subscriber};
+    tracing_subscriber::fmt()
+        .json()
+        .with_env_filter(
+            tracing_subscriber::EnvFilter::from_default_env()
+                .add_directive(tracing::Level::INFO.into()),
+        )
+        .with_current_span(false)
+        .with_ansi(false)
+        .with_target(false)
+        .init();
+}
+
+appsync_lambda_main!(
+    "graphql/schema.gql",
+    log_init = tracing_init,
+    dynamodb() -> aws_sdk_dynamodb::Client,
+);
+```
+
+#### Event Logging Control
+
+Control whether Lambda event payloads are logged (disabled by default for security):
+
+```rust
+appsync_lambda_main!(
+    "graphql/schema.gql",
+    event_logging = true,  // Enable full event payload logging for debugging
+    dynamodb() -> aws_sdk_dynamodb::Client,
+);
+```
+
 ### Error Merging
 
 Combine multiple errors using the pipe operator:
@@ -262,6 +345,27 @@ let err = AppsyncError::new("ValidationError", "Invalid email")
     | AppsyncError::new("DatabaseError", "User not found");
 ```
 
+### Feature Flags
+
+The `lambda-appsync` crate supports several feature flags for different use cases:
+
+- `env_logger` (default): Enables env_logger integration and re-exports
+- `tracing`: Enables tracing/tracing-subscriber integration as an alternative to env_logger  
+- `log`: Controls log statement generation in generated code and availability of re-exported `log` crate
+
+You can mix and match these features based on your needs:
+
+```toml
+# Use tracing instead of env_logger
+lambda-appsync = { version = "0.9.0", default-features = false, features = ["tracing"] }
+
+# Use both (for migration scenarios)
+lambda-appsync = { version = "0.9.0", features = ["tracing"] }
+
+# Use your custom logging framework while still getting logs from the macro-generated code
+lambda-appsync = { version = "0.9.0", default-features = false, features = ["log"] }
+```
+
 ## Minimum Supported Rust Version (MSRV)
 
 This crate requires Rust version 1.82.0 or later.