using ZB.MOM.WW.OtOpcUa.Commons.OpcUa;

namespace ZB.MOM.WW.OtOpcUa.OpcUaServer;

/// <summary>
///     Production <see cref="IOpcUaAddressSpaceSink"/> binding for v2 — bridges
///     OpcUaPublishActor's writes to the SDK address space owned by
///     <see cref="OtOpcUaNodeManager"/>. The host wires this in once the StandardServer has
///     been started (so the node manager exists).
/// </summary>
public sealed class SdkAddressSpaceSink : IOpcUaAddressSpaceSink, ISurgicalAddressSpaceSink
{
    private readonly OtOpcUaNodeManager _nodeManager;

    /// <summary>Initializes a new instance of the SdkAddressSpaceSink class.</summary>
    /// <param name="nodeManager">The OPC UA node manager.</param>
    public SdkAddressSpaceSink(OtOpcUaNodeManager nodeManager)
    {
        ArgumentNullException.ThrowIfNull(nodeManager);
        _nodeManager = nodeManager;
    }

    /// <summary>Writes a value to the OPC UA address space.</summary>
    /// <param name="nodeId">The OPC UA node identifier.</param>
    /// <param name="value">The value being written.</param>
    /// <param name="quality">The OPC UA quality status.</param>
    /// <param name="sourceTimestampUtc">The source timestamp in UTC.</param>
    public void WriteValue(string nodeId, object? value, OpcUaQuality quality, DateTime sourceTimestampUtc)
        => _nodeManager.WriteValue(nodeId, value, quality, sourceTimestampUtc);

    /// <summary>Writes the full Part 9 alarm-condition state to the OPC UA address space.</summary>
    /// <param name="alarmNodeId">The alarm node identifier.</param>
    /// <param name="state">The full condition state to project onto the node.</param>
    /// <param name="sourceTimestampUtc">The source timestamp in UTC.</param>
    public void WriteAlarmCondition(string alarmNodeId, AlarmConditionSnapshot state, DateTime sourceTimestampUtc)
        => _nodeManager.WriteAlarmCondition(alarmNodeId, state, sourceTimestampUtc);

    /// <summary>Materialises a real Part 9 alarm-condition node in the address space.</summary>
    /// <param name="alarmNodeId">The alarm node identifier (== ScriptedAlarmId).</param>
    /// <param name="equipmentNodeId">The equipment folder node identifier the condition parents under.</param>
    /// <param name="displayName">The human-readable condition name.</param>
    /// <param name="alarmType">The domain alarm type.</param>
    /// <param name="severity">The domain severity.</param>
    /// <param name="isNative">True for a driver-fed (native) equipment-tag alarm; false (default) for a scripted alarm.</param>
    public void MaterialiseAlarmCondition(string alarmNodeId, string equipmentNodeId, string displayName, string alarmType, int severity, bool isNative = false)
        => _nodeManager.MaterialiseAlarmCondition(alarmNodeId, equipmentNodeId, displayName, alarmType, severity, isNative);

    /// <summary>Ensures a folder node exists in the address space.</summary>
    /// <param name="folderNodeId">The folder node identifier.</param>
    /// <param name="parentNodeId">The parent folder node identifier.</param>
    /// <param name="displayName">The display name for the folder.</param>
    public void EnsureFolder(string folderNodeId, string? parentNodeId, string displayName)
        => _nodeManager.EnsureFolder(folderNodeId, parentNodeId, displayName);

    /// <summary>Ensures a variable node exists in the address space.</summary>
    /// <param name="variableNodeId">The variable node identifier.</param>
    /// <param name="parentFolderNodeId">The parent folder node identifier.</param>
    /// <param name="displayName">The display name for the variable.</param>
    /// <param name="dataType">The OPC UA data type.</param>
    /// <param name="writable">When true the node is created read/write; otherwise read-only.</param>
    /// <param name="historianTagname">null ⇒ not historized; non-null ⇒ create Historizing with the
    /// HistoryRead access bit and register the historian tagname.</param>
    /// <param name="isArray">When true the node is created as a 1-D array; when false (default) scalar.</param>
    /// <param name="arrayLength">The declared length of the 1-D array when <paramref name="isArray"/> is true.</param>
    public void EnsureVariable(string variableNodeId, string? parentFolderNodeId, string displayName, string dataType, bool writable, string? historianTagname = null, bool isArray = false, uint? arrayLength = null)
        => _nodeManager.EnsureVariable(variableNodeId, parentFolderNodeId, displayName, dataType, writable, historianTagname, isArray, arrayLength);

    /// <summary>F10b: surgically update an existing variable node's Writable + Historizing + presentation
    /// shape (DataType / array-ness) in place (no rebuild). Returns false when the node does not exist
    /// (caller falls back to a full rebuild).</summary>
    /// <param name="variableNodeId">The variable node identifier.</param>
    /// <param name="writable">When true the node becomes read/write with the inbound-write handler; otherwise read-only.</param>
    /// <param name="historianTagname">null ⇒ not historized; non-null ⇒ Historizing with the HistoryRead bit and tagname binding.</param>
    /// <param name="dataType">The OPC UA built-in data type name to apply in place.</param>
    /// <param name="isArray">When true the node becomes a 1-D array; when false scalar.</param>
    /// <param name="arrayLength">The declared length of the 1-D array when <paramref name="isArray"/> is true.</param>
    public bool UpdateTagAttributes(string variableNodeId, bool writable, string? historianTagname, string dataType, bool isArray, uint? arrayLength)
        => _nodeManager.UpdateTagAttributes(variableNodeId, writable, historianTagname, dataType, isArray, arrayLength);

    /// <summary>OpcUaServer-001: surgically update an existing folder node's display name in place (no
    /// rebuild) for a UNS Area / Line rename. Returns false when the folder does not exist (caller falls
    /// back to a full rebuild).</summary>
    /// <param name="folderNodeId">The folder node identifier whose display name to update in place.</param>
    /// <param name="displayName">The new display name to apply.</param>
    /// <returns>True when the in-place update was applied; false when the folder is missing.</returns>
    public bool UpdateFolderDisplayName(string folderNodeId, string displayName)
        => _nodeManager.UpdateFolderDisplayName(folderNodeId, displayName);

    /// <summary>Rebuilds the entire OPC UA address space.</summary>
    public void RebuildAddressSpace() => _nodeManager.RebuildAddressSpace();

    /// <summary>Announces a runtime NodeAdded model-change (discovered-node injection) to subscribed clients.</summary>
    /// <param name="affectedNodeId">The node under which discovered nodes were added.</param>
    public void RaiseNodesAddedModelChange(string affectedNodeId) => _nodeManager.RaiseNodesAddedModelChange(affectedNodeId);
}