GovBuilt.FeatureFlags.Abstraction 1.0.4

GovBuilt.FeatureFlags.Abstraction

Private package — GovBuiltFeed only. Do not publish to nuget.org.

A lightweight helper library for checking per-tenant feature flags in any GovBuilt module or application.

Add this package to any module that needs to check flags. The GovBuilt.FeatureFlags module must be enabled on the tenant — it owns storage and registers the helper.

What this package does

• Provides IFeatureFlagHelper for reading feature flags anywhere in the application
• Provides FeatureFlagSetting — the single source of truth for all flag definitions
• Provides AddFeatureFlagHelper() extension method for DI registration
• Degrades gracefully: returns all-false defaults when the GovBuilt.FeatureFlags module is disabled

What this package does NOT

• Store or write flag values
• Create controllers or endpoints
• Read configuration from appsettings.json

Prerequisites

• .NET 8
• Orchard Core application
• GovBuilt.FeatureFlags module enabled on the tenant

Installation

Step 1: Add the private feed (once per machine)

dotnet nuget add source "https://pkgs.dev.azure.com/MCCinnovations/_packaging/GovBuiltFeed/nuget/v3/index.json" \
  --name GovBuiltFeed \
  --username az \
  --password <PAT>

Step 2: Add the package reference

<PackageReference Include="GovBuilt.FeatureFlags.Abstraction" Version="1.0.1" />

Step 3: Register in your module's Startup

public override void ConfigureServices(IServiceCollection services)
{
    services.AddFeatureFlagHelper();
}

Usage

In a service

public class MyService(IFeatureFlagHelper featureFlags)
{
    public async Task DoWorkAsync()
    {
        if (await featureFlags.IsEnabledAsync(f => f.IsAdvancedSearch))
        {
            // feature is enabled for this tenant
        }
    }
}

In a controller

public class MyController(IFeatureFlagHelper featureFlags) : Controller
{
    public async Task<IActionResult> Index()
    {
        if (!await featureFlags.IsEnabledAsync(f => f.IsBetaDashboard))
            return NotFound();

        return View();
    }
}

In a Razor view

@inject IFeatureFlagHelper FeatureFlags

@if (await FeatureFlags.IsEnabledAsync(f => f.IsMaintenanceBanner))
{
    <div class="alert alert-warning">Scheduled maintenance tonight.</div>
}

Read all flags at once

var settings = await featureFlags.GetAsync();

if (settings.IsDarkMode) { ... }
if (settings.IsWorkflowAutomation) { ... }

API

Security notes

• Flag reads are tenant-scoped automatically via Orchard Core's ISiteService
• Flags can only be toggled by users with the ManageFeatureFlags permission (Administrators by default)
• When the GovBuilt.FeatureFlags module is disabled on a tenant, all flags return false — no exceptions are thrown

Publishing

dotnet pack src/GovBuilt.Helpers/GovBuilt.FeatureFlags.Abstraction/GovBuilt.FeatureFlags.Abstraction.csproj -c Release -o ./artifacts
dotnet nuget push ./artifacts/GovBuilt.FeatureFlags.Abstraction.*.nupkg --source GovBuiltFeed --api-key az