namespace ZB.MOM.WW.OtOpcUa.Driver.Galaxy.Config;

/// <summary>
///     Driver-instance options for the in-process .NET 10 Galaxy driver. Maps to the
///     <c>DriverConfig</c> JSON column on the central config DB. Decomposed into nested
///     records so the JSON structure mirrors the runtime shape and operators can target
///     individual sections (gateway endpoint, mxaccess client identity, reconnect policy)
///     without touching the rest.
/// </summary>
/// <param name="Gateway">Connection details for the MxAccess gateway (mxaccessgw repo).</param>
/// <param name="MxAccess">MXAccess-specific knobs surfaced through gw — client name, publishing interval, write-user.</param>
/// <param name="Repository">Galaxy Repository browse options consumed by the discoverer.</param>
/// <param name="Reconnect">Backoff knobs for the in-driver reconnect supervisor (PR 4.5).</param>
public sealed record GalaxyDriverOptions(
    GalaxyGatewayOptions Gateway,
    GalaxyMxAccessOptions MxAccess,
    GalaxyRepositoryOptions Repository,
    GalaxyReconnectOptions Reconnect);

/// <summary>
///     Connection details for the MxAccess gateway. <see cref="ApiKeySecretRef"/> resolves
///     through the server-side secret store (DPAPI for production, environment override for
///     dev) — the API key never appears in cleartext config.
/// </summary>
public sealed record GalaxyGatewayOptions(
    string Endpoint,
    string ApiKeySecretRef,
    bool UseTls = true,
    string? CaCertificatePath = null,
    int ConnectTimeoutSeconds = 10,
    int DefaultCallTimeoutSeconds = 5,
    int StreamTimeoutSeconds = 0);

/// <summary>
///     MXAccess-specific knobs the gateway forwards to the worker process.
/// </summary>
/// <param name="ClientName">
///     Wonderware client identity. MUST be unique per OtOpcUa instance — when two instances
///     share a name, the older session loses subscription state. Redundancy pairs (decision
///     #149) enforce uniqueness via install scripts.
/// </param>
/// <param name="PublishingIntervalMs">
///     Hint forwarded as <c>buffered_update_interval_ms</c> on subscribe; lets the worker
///     coalesce updates at the OPC UA publishing cadence rather than every COM tick.
/// </param>
/// <param name="WriteUserId">
///     Reserved for ArchestrA secured-write user mapping; PR 4.3 wires <c>WriteSecured</c>
///     routing against this id. 0 = anonymous.
/// </param>
public sealed record GalaxyMxAccessOptions(
    string ClientName,
    int PublishingIntervalMs = 1000,
    int WriteUserId = 0);

/// <summary>
///     Galaxy Repository browse-side knobs consumed by PR 4.1's <c>GalaxyDiscoverer</c>.
/// </summary>
public sealed record GalaxyRepositoryOptions(
    int DiscoverPageSize = 5000,
    bool WatchDeployEvents = true);

/// <summary>
///     Backoff knobs for the in-driver reconnect supervisor (PR 4.5). Replay-on-session-lost
///     calls the gw's <c>ReplaySubscriptions</c> RPC after reconnect rather than re-issuing
///     subscribe-bulk for every tag.
/// </summary>
public sealed record GalaxyReconnectOptions(
    int InitialBackoffMs = 500,
    int MaxBackoffMs = 30_000,
    bool ReplayOnSessionLost = true);