Pennington.StandardSite.WellKnownArtifactService

namespace Pennington.StandardSite;

/// Artifact-tier service for the Standard Site verification well-known files: the publication AT-URI at /.well-known/site.standard.publication[{path}] and, when enabled, the bare DID at /.well-known/atproto-did. Bytes derive from options alone — the trivial proof that the artifact tier does not require the site projection. Claims nothing when the options are incompletely configured (fail-safe). Transient so it captures current options.
public class WellKnownArtifactService
{
    /// URL territories this service serves. Options-derived and consulted on every request — must be cheap and must not trigger discovery, the projection, or any lazy corpus work.
    
public ImmutableList<ArtifactClaim> Claims { get; }


    /// Enumerates every artifact route the static build should write, as GeneratedSource items. May consume the projection — the build invokes this outside any request, after the page crawl has primed the render cache. Never called on the request path.
    
public IAsyncEnumerable<DiscoveredItem> DiscoverAsync()
;

    /// Returns the bytes for relativePath (no leading slash, e.g. search/en/index.json), or null to decline so the request falls through to content routing. May materialize the projection, build an index, or run Chromium on demand.
    
public Task<ArtifactContent> ResolveAsync(string relativePath, CancellationToken cancellationToken)
;

    /// Creates the service; claims derive from the options alone.
    
public WellKnownArtifactService(StandardSiteOptions options)
;
}