# =====================================================================================================
# endpoint-logging - the REACTIVE twin's addition to the shared reference configuration
#
# The complete, commented reference for every property of the limesium-reactive-logging module is the
# repository-shared /docs/endpoint-logging-reference.yml: the namespace is IDENTICAL in both twins,
# key for key and default for default, and that file is the ONE place the property semantics are
# documented (architecture review of 2026-09-05, finding 2 - a second full copy was a drift surface).
# This file carries exactly the ONE reactive-only key. Copy the shared block into an application.yml,
# add the key below when the classpath should not decide the variant, and change only what you need.
#
# Bound by this module's RequestLoggingProperties; this module's EndpointLoggingReferenceConfigTest
# binds the shared file against that class (the cross-stack proof that the namespace is identical)
# and pins that this file documents nothing but the variant key.
# =====================================================================================================

endpoint-logging:
  # Which filter variant this module registers - the ONE reactive-only key (the servlet twin has
  # nothing to select). `auto` (the default) keeps the classpath-based choice: the coroutine variant
  # (CoRequestLoggingWebFilter) when kotlinx-coroutines-reactor AND kotlinx-coroutines-slf4j are
  # present, the Reactor variant otherwise. `reactor` forces the Reactor variant even with the
  # coroutine libraries present (e.g. pulled in transitively by a Reactor-only host); `coroutine`
  # requires them and fails the context start when they are missing, instead of silently falling back.
  # Logging, configuration and metrics are identical across the variants - the choice is invisible to
  # dashboards; it decides how handler-side MDC works (natively via MDCContext, or via the optional
  # context-propagation accessors plus spring.reactor.context-propagation=auto).
  variant: auto