using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.Build.Framework;
using Microsoft.Build.Utilities;
namespace CarpaNet.BuildTasks;
///
/// MSBuild task that resolves ATProtocol lexicon schemas from the network via DNS.
/// Invoked automatically when items are present.
///
public sealed class ResolveLexiconTask : Microsoft.Build.Utilities.Task
{
///
/// NSIDs to resolve (from LexiconResolve MSBuild items).
///
[Required]
public ITaskItem[] Nsids { get; set; } = Array.Empty();
///
/// Directory to cache resolved lexicon files.
///
[Required]
public string CacheDir { get; set; } = string.Empty;
///
/// Cache TTL in hours. Set to 0 to force refresh.
///
public double CacheTtlHours { get; set; } = 24;
///
/// Whether to fail the build on resolution errors (true) or just warn (false).
///
public bool FailOnError { get; set; } = true;
///
/// PLC directory URL for did:plc resolution.
///
public string PlcDirectoryUrl { get; set; } = "https://plc.directory";
///
/// Semicolon-separated DNS server IP addresses.
///
public string DnsServers { get; set; } = string.Empty;
///
/// Output: resolved lexicon file paths to be fed into LexiconFiles.
///
[Output]
public ITaskItem[] ResolvedLexiconFiles { get; set; } = Array.Empty();
public override bool Execute()
{
if (Nsids.Length == 0)
return true;
var cache = new LexiconCache(CacheDir, CacheTtlHours);
var resolvedFiles = new List();
var nsidsToResolve = new List();
// Check cache first
foreach (var item in Nsids)
{
var nsid = item.ItemSpec;
if (!NsidAuthority.IsValidNsid(nsid))
{
Log.LogError("Invalid NSID format: '{0}'. NSIDs must have at least 3 dot-separated segments.", nsid);
return false;
}
var cached = cache.TryGet(nsid);
if (cached != null)
{
Log.LogMessage(MessageImportance.Low, "Using cached lexicon for '{0}'", nsid);
resolvedFiles.Add(new TaskItem(cache.GetJsonPath(nsid)));
}
else
{
nsidsToResolve.Add(nsid);
}
}
// Resolve any uncached NSIDs
if (nsidsToResolve.Count > 0)
{
var dnsServers = string.IsNullOrWhiteSpace(DnsServers)
? null
: DnsServers.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
using var resolver = new LexiconResolver(
PlcDirectoryUrl,
dnsServers,
msg => Log.LogMessage(MessageImportance.Normal, msg),
msg => Log.LogWarning(msg));
try
{
var resolved = resolver.ResolveMultipleAsync(nsidsToResolve).GetAwaiter().GetResult();
foreach (var (nsid, json) in resolved)
{
cache.Store(nsid, json);
resolvedFiles.Add(new TaskItem(cache.GetJsonPath(nsid)));
Log.LogMessage(MessageImportance.Normal, "Resolved lexicon: {0}", nsid);
}
}
catch (LexiconResolutionException ex)
{
if (FailOnError)
{
Log.LogError("Lexicon resolution failed: {0}", ex.Message);
return false;
}
else
{
Log.LogWarning("Lexicon resolution failed (continuing because CarpaNet_LexiconFailOnError=false): {0}", ex.Message);
}
}
catch (Exception ex)
{
if (FailOnError)
{
Log.LogError("Lexicon resolution failed with unexpected error: {0}", ex.Message);
return false;
}
else
{
Log.LogWarning("Lexicon resolution failed with unexpected error (continuing because CarpaNet_LexiconFailOnError=false): {0}", ex.Message);
}
}
}
ResolvedLexiconFiles = resolvedFiles.ToArray();
return !Log.HasLoggedErrors;
}
}