Muonroi.Pdf.Enterprise 1.0.7

Muonroi.Pdf.Enterprise

Enterprise-tier extensions for Muonroi.Pdf: per-tenant quota metering, license-backed capability gates, an HTTP template registry client, polling hot-reload, and an SSIM visual-quality scorer.

Muonroi.Pdf.Enterprise sits on top of the OSS Muonroi.Pdf engine and adds capabilities that require a commercial activation proof. It decorates IMPdfService with a metering wrapper that records per-tenant PdfRendersPerDay quota via ITenantQuotaTracker, replaces the no-op feature gate with a governance-backed LicenseFeatureGate, and ships an HTTP client for the Muonroi PDF template registry together with a transport-agnostic polling hot-reload service. A pure-managed SSIM scorer is included for visual-regression quality gates. The package has a one-way dependency on the OSS engine — the OSS engine has zero awareness of this package.

Installation

dotnet add package Muonroi.Pdf.Enterprise --prerelease

Quick Start

Call order matters: AddPdf must run before AddPdfEnterprise, and AddMEnterpriseGovernance must run before both (it registers ILicenseGuard).

using Muonroi.Pdf.Extensions;

WebApplicationBuilder builder = WebApplication.CreateBuilder(args);

// 1. OSS PDF engine — registers IMPdfService (MPdfService) via TryAddSingleton.
builder.Services.AddPdf(builder.Configuration);

// 2. Governance layer — registers ILicenseGuard (required by LicenseFeatureGate).
builder.Services.AddMEnterpriseGovernance(builder.Configuration);

// 3. Enterprise decorator — replaces IMPdfService with EnterprisePdfServiceWrapper
//    (quota metering) and registers LicenseFeatureGate as IFeatureGate.
builder.Services.AddPdfEnterprise();

For development / OSS environments where no license activation is needed, skip AddPdfEnterprise and register the no-op gate directly:

// dev / OSS: all capability keys are always allowed; metering is skipped.
builder.Services.AddSingleton(AlwaysAllowFeatureGate.Instance);

Guard a feature in any service:

public class MyService(IFeatureGate gate, IMPdfService pdf)
{
    public async Task<byte[]> RenderWithRegistryAsync(string html, CancellationToken ct)
    {
        // Throws FeatureNotLicensedException if pdf.registry is not in the activation proof.
        gate.EnsureFeatureOrThrow(CapabilityKeys.PdfRegistry);

        (byte[] bytes, _) = await pdf.RenderToBytesAsync(html, new PdfRenderOptions(), ct);
        return bytes;
    }
}

Features

• Per-tenant quota metering — EnterprisePdfServiceWrapper decorates IMPdfService and increments QuotaType.PdfRendersPerDay via ITenantQuotaTracker after every render. Metering failures are caught, logged, and swallowed so the render result is always returned.
• License-backed capability gate — LicenseFeatureGate delegates to ILicenseGuard.HasFeature, which reads the RSA-verified ActivationProof.Features[] supplied by the governance layer.
• HTTP template registry client — HttpPdfTemplateRegistry fetches template descriptors and version payloads from the control-plane REST API (GET /api/v1/pdf-templates/{id} and /versions/{version}). Uses the named HttpClient "PdfTemplateRegistry".
• Polling hot-reload — PdfTemplateHotReload polls a configured list of template IDs via IMPdfTemplateRegistry.LookupAsync and notifies an IAsyncObserver<TemplateChange> whenever a version changes or a template disappears. Works against any registry implementation; no push transport required.
• SSIM visual-quality scorer — SsimScorer.Compare computes mean structural similarity (Wang/Bovik 2004, Rec.709 luma) between two interleaved 8-bit RGB pixel buffers. Returns 1.0 for identical buffers; use as a canary gate threshold.
• Capability key constants — CapabilityKeys defines pdf.designer, pdf.registry, and pdf.canary as typed constants for use with IFeatureGate.

Configuration

DI registration

// Register the named HttpClient the registry resolves from the factory.
builder.Services.AddHttpClient(PdfTemplateRegistryOptions.HttpClientName, client =>
{
    client.BaseAddress = new Uri("https://control-plane.example.com/");
});

// Register HttpPdfTemplateRegistry as IMPdfTemplateRegistry.
builder.Services.AddSingleton<PdfTemplateRegistryOptions>(new PdfTemplateRegistryOptions
{
    AccessTokenFactory = async ct => await tokenProvider.GetTokenAsync(ct)
});
builder.Services.AddSingleton<IMPdfTemplateRegistry, HttpPdfTemplateRegistry>();

Hot-reload

var options = new PdfTemplateHotReloadOptions
{
    PollInterval = TimeSpan.FromSeconds(30),   // default: 30 s
    TemplateIds  = ["invoice-v2", "receipt-v1"]
};

// PdfTemplateHotReload.StartAsync is the loop entry point; wrap in a hosted service.
var hotReload = new PdfTemplateHotReload(registry, myObserver, options);
_ = Task.Run(() => hotReload.StartAsync(appLifetime.ApplicationStopping));

Options reference

API Reference

Samples

• Quickstart.Pdf.Advanced — ASP.NET Core API demonstrating AlwaysAllowFeatureGate, CapabilityKeys, SsimScorer, and IMPdfTemplateRegistry alongside the OSS PDF engine and the design-system template provider.

Compatibility

• Target framework: net8.0
• License: Commercial — requires activation. See LICENSE-COMMERCIAL.

Related Packages

• Muonroi.Pdf — OSS HTML/CSS-to-PDF engine; must be registered before this package
• Muonroi.Pdf.Abstractions — IMPdfService, PdfRenderOptions, and PdfRenderResult contracts shared by both layers
• Muonroi.Governance.Enterprise — provides ILicenseGuard and AddMEnterpriseGovernance; required before calling AddPdfEnterprise

License

Commercial license — requires a valid Muonroi activation proof. Contact leanhphi1706@gmail.com or see LICENSE-COMMERCIAL for terms.