lmxopcua/src/ZB.MOM.WW.OtOpcUa.Host/Configuration/MxAccessConfiguration.cs

namespace ZB.MOM.WW.OtOpcUa.Host.Configuration
{
    /// <summary>
    ///     MXAccess client configuration. (SVC-003, MXA-008, MXA-009)
    /// </summary>
    public class MxAccessConfiguration
    {
        /// <summary>
        ///     Gets or sets the client name registered with the MXAccess runtime for this bridge instance.
        /// </summary>
        public string ClientName { get; set; } = "LmxOpcUa";

        /// <summary>
        ///     Gets or sets the Galaxy node name to target when the service connects to a specific runtime node.
        /// </summary>
        public string? NodeName { get; set; }

        /// <summary>
        ///     Gets or sets the Galaxy name used when resolving MXAccess references and diagnostics.
        /// </summary>
        public string? GalaxyName { get; set; }

        /// <summary>
        ///     Gets or sets the maximum time, in seconds, to wait for a live tag read to complete.
        /// </summary>
        public int ReadTimeoutSeconds { get; set; } = 5;

        /// <summary>
        ///     Gets or sets the maximum time, in seconds, to wait for a tag write acknowledgment from the runtime.
        /// </summary>
        public int WriteTimeoutSeconds { get; set; } = 5;

        /// <summary>
        ///     Gets or sets an outer safety timeout, in seconds, applied to sync-over-async MxAccess
        ///     operations invoked from the OPC UA stack thread (Read, Write, address-space rebuild probe
        ///     sync). This is a backstop for the case where an async path hangs outside the inner
        ///     <see cref="ReadTimeoutSeconds"/> / <see cref="WriteTimeoutSeconds"/> bounds — e.g., a
        ///     slow reconnect or a scheduler stall. Must be comfortably larger than the inner timeouts
        ///     so normal operation is never affected. Default 30s.
        /// </summary>
        public int RequestTimeoutSeconds { get; set; } = 30;

        /// <summary>
        ///     Gets or sets the cap on concurrent MXAccess operations so the bridge does not overload the runtime.
        /// </summary>
        public int MaxConcurrentOperations { get; set; } = 10;

        /// <summary>
        ///     Gets or sets how often, in seconds, the connectivity monitor probes the runtime connection.
        /// </summary>
        public int MonitorIntervalSeconds { get; set; } = 5;

        /// <summary>
        ///     Gets or sets a value indicating whether the bridge should automatically attempt to re-establish a dropped MXAccess
        ///     session.
        /// </summary>
        public bool AutoReconnect { get; set; } = true;

        /// <summary>
        ///     Gets or sets the optional probe tag used to verify that the MXAccess runtime is still returning fresh data.
        /// </summary>
        public string? ProbeTag { get; set; }

        /// <summary>
        ///     Gets or sets the number of seconds a probe value may remain unchanged before the connection is considered stale.
        /// </summary>
        public int ProbeStaleThresholdSeconds { get; set; } = 60;

        /// <summary>
        ///     Gets or sets a value indicating whether the bridge advises <c>&lt;ObjectName&gt;.ScanState</c> for every
        ///     deployed <c>$WinPlatform</c> and <c>$AppEngine</c>, reporting per-host runtime state on the status
        ///     dashboard and proactively invalidating OPC UA variable quality when a host transitions to Stopped.
        ///     Enabled by default. Disable to return to legacy behavior where host runtime state is invisible and
        ///     MxAccess's per-tag bad-quality fan-out is the only stop signal.
        /// </summary>
        public bool RuntimeStatusProbesEnabled { get; set; } = true;

        /// <summary>
        ///     Gets or sets the maximum seconds to wait for the initial probe callback before marking a host as
        ///     Stopped. Only applies to the Unknown → Stopped transition. Because <c>ScanState</c> is delivered
        ///     on-change only, a stably Running host does not time out — no starvation check runs on Running
        ///     entries. Default 15s.
        /// </summary>
        public int RuntimeStatusUnknownTimeoutSeconds { get; set; } = 15;
    }
}