1#[cfg(feature = "performance-optimized")]
42pub mod performance;
43
44#[cfg(feature = "correlation-enhanced")]
46pub mod correlation;
47
48#[cfg(feature = "convenience")]
50pub mod convenience;
51
52#[cfg(feature = "convenience")]
54pub mod context_adapter;
55
56pub mod panic_handler;
58
59pub mod extension;
61
62mod error;
64
65pub use observability_core::{
67 BatchingConfig,
68 BatchingManager,
69 CompactJsonFormatter,
70 ContextPort,
71 FormatterPort,
72 JsonFormatter,
73 LogEntry,
75 ObservabilityConfig,
76
77 ObservabilityError,
79 ObservabilityManager,
81 ObservabilityResult,
82
83 ProcessorChain,
84 StandardLogAdapter,
85
86 StandardLoggingPort,
87 TransportPort,
89 W3CTraceContext,
91 WasmStdoutAdapter,
92 traits::LogLevel,
93};
94
95pub use observability_core::domain::TraceContext;
97
98pub use error::{Result, StructuredLoggingError};
100pub use extension::{
101 EnhancedObservabilityConfig, PerformanceExtension, create_performance_extension,
102 create_performance_extension_from_config,
103};
104
105pub use panic_handler::{
107 PanicHandlerConfig, PanicPattern, PanicSeverity, PanicStats, StructuredPanicInfo, ThreadInfo,
108 get_panic_stats, install_panic_handler, install_panic_handler_with_config, reset_panic_stats,
109};
110
111#[cfg(feature = "performance-optimized")]
116pub use performance::{
117 BufferPool, FastPathLogger, OptimizedWasmStdoutAdapter, PerformanceStats,
118 StringInterningProcessor,
119};
120
121#[cfg(feature = "correlation-enhanced")]
123pub use correlation::{
124 BaggageManager, CorrelationProcessor, EnhancedTraceContext, ScopedContextManager,
125 W3CBaggageSupport,
126};
127
128#[cfg(feature = "convenience")]
130pub use convenience::{
131 A2AContext,
132 ConvenienceManager,
133 DomainContextProcessor,
135 LLMContext,
137 TemplateContext,
138 clear_a2a_context,
139 clear_all_contexts,
140 clear_llm_context,
141 clear_request_context,
142 clear_template_context,
143 emit_a2a_message_latency,
144 emit_counter,
145 emit_histogram,
146 emit_llm_request_duration,
148 emit_llm_tokens_used,
149 emit_request_duration,
150 emit_template_render_duration,
151 log_a2a_message,
152 log_llm_request,
154 log_template_render,
155 set_a2a_context,
156 set_llm_context,
158 set_request_context,
159 set_template_context,
160};
161
162#[cfg(feature = "convenience")]
164pub use context_adapter::{
165 A2aContextGuard,
166 A2aContextManager,
167 AllContextsGuard,
168
169 ContextManagerRegistry,
170 LlmContextGuard,
172 LlmContextManager,
174 RequestContextGuard,
175 RequestContextManager,
176 ScopedContextBuilder,
178
179 StructuredA2aContextManager,
180 StructuredContextRegistry,
182 StructuredLlmContextManager,
183 StructuredRequestContextManager,
184 init_context_integration,
186
187 set_a2a_context_scoped,
188 set_all_contexts_scoped,
189
190 set_llm_context_scoped,
192 set_request_context_scoped,
193 with_a2a_context,
194 with_all_contexts,
195
196 with_llm_context,
198 with_request_context,
199};
200
201#[cfg(feature = "convenience")]
203pub use extension::ConvenienceConfig;
204#[cfg(feature = "correlation-enhanced")]
205pub use extension::CorrelationConfig;
206#[cfg(feature = "performance-optimized")]
207pub use extension::PerformanceConfig;
208
209pub const VERSION: &str = env!("CARGO_PKG_VERSION");
211
212pub fn create_logger() -> ObservabilityResult<ObservabilityManager> {
214 ObservabilityManager::new(ObservabilityConfig::default())
215}
216
217#[cfg(feature = "performance-optimized")]
219pub fn create_performance_logger() -> Result<PerformanceExtension> {
220 PerformanceExtension::new(EnhancedObservabilityConfig::default())
221}
222
223pub fn create_logger_from_config(
225 config: ObservabilityConfig,
226) -> ObservabilityResult<ObservabilityManager> {
227 ObservabilityManager::new(config)
228}
229
230pub fn create_enhanced_logger_from_config(
232 config: EnhancedObservabilityConfig,
233) -> Result<PerformanceExtension> {
234 PerformanceExtension::new(config)
235}
236
237#[cfg(test)]
238mod tests {
239 use super::*;
240
241 #[test]
242 fn test_basic_logger_creation() {
243 let logger = create_logger();
244 assert!(logger.is_ok());
245 }
246
247 #[cfg(feature = "performance-optimized")]
248 #[test]
249 fn test_performance_logger_creation() {
250 let logger = create_performance_logger();
251 assert!(logger.is_ok());
252 }
253
254 #[test]
255 fn test_version_constant() {
256 assert!(!VERSION.is_empty());
257 }
258}