ThunderPropagator.BuildingBlocks 1.0.1-beta.14

This is a prerelease version of ThunderPropagator.BuildingBlocks.

dotnet add package ThunderPropagator.BuildingBlocks --version 1.0.1-beta.14

NuGet\Install-Package ThunderPropagator.BuildingBlocks -Version 1.0.1-beta.14

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="ThunderPropagator.BuildingBlocks" Version="1.0.1-beta.14" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="ThunderPropagator.BuildingBlocks" Version="1.0.1-beta.14" />
                    

                            Directory.Packages.props

<PackageReference Include="ThunderPropagator.BuildingBlocks" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add ThunderPropagator.BuildingBlocks --version 1.0.1-beta.14

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: ThunderPropagator.BuildingBlocks, 1.0.1-beta.14"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package ThunderPropagator.BuildingBlocks@1.0.1-beta.14

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=ThunderPropagator.BuildingBlocks&version=1.0.1-beta.14&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=ThunderPropagator.BuildingBlocks&version=1.0.1-beta.14&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

ThunderPropagator BuildingBlocks (Project ARC)

ThunderPropagator BuildingBlocks (Project ARC) is a comprehensive .NET library providing production-ready, reusable components for building high-performance, cloud-native applications. Targets .NET 8.0, 9.0, and 10.0 with multi-platform support (AnyCPU, x86, x64, ARM64).

📚 Documentation

Main Documentation Hub: docs/README.md

Documentation Catalog

Application Layer (Core Building Blocks)

Area	Types	Files	Diagrams	Description
BuildingBlocks.Application	`15`	`12`	`✓`	Core abstractions (FeederMessage, ServiceConfiguration, Telemetry)
├─ Attributes	`2`	`2`	`✓`	JSON serialization control and member ignore attributes
├─ Certificate	`1`	`1`	`✗`	X.509 certificate handling and management
├─ ChangeTrackingItems	`5`	`5`	`✗`	Property change tracking with observable patterns
├─ Ciphering	`3`	`3`	`✓`	AES/RSA encryption and password generation
├─ Collections	`3`	`3`	`✓`	LinkedArray, BindingDictionary, GenericOrderedDictionary
├─ CorrelationId	`3`	`3`	`✗`	Correlation ID management for distributed tracing
├─ Enums	`4`	`4`	`✗`	Common enumerations (AuthenticationType, CastType, DataType)
├─ Helpers	`18`	`18`	`✓`	Serialization, collection, string, date/time utilities
├─ Identity	`2`	`2`	`✗`	JWT identity helper utilities
├─ Objects	`5`	`5`	`✓`	Base classes (DisposableObject, EquatableObject, NotifiableObject)
└─ Serializations	`4`	`4`	`✗`	Serialization abstractions and Kafka serializer types

Infrastructure Layer (System-Level Components)

Area	Types	Files	Diagrams	Description
BuildingBlocks.Infrastructure	`0`	`1`	`✓`	Infrastructure layer entry point
├─ HealthChecks	`0`	`0`	`✗`	ASP.NET Core health check integrations
├─ System	`0`	`0`	`✗`	System-level utilities and abstractions
│ └─ Network	`2`	`2`	`✗`	Network performance monitoring
└─ SystemResourceMonitor	`4`	`4`	`✓`	Cross-platform resource monitoring
├─ Metrics	`2`	`2`	`✗`	Metrics client abstractions
├─ Battery	`3`	`2`	`✗`	Battery status, charge, health (Windows/macOS/Linux)
├─ Cpu	`4`	`4`	`✗`	CPU usage and temperature monitoring
├─ Disk	`6`	`4`	`✗`	Disk health (SMART) and I/O performance
├─ Gpu	`3`	`2`	`✗`	GPU utilization, memory, temperature
├─ Memory	`2`	`2`	`✗`	System and process memory usage
└─ SystemDrives	`2`	`2`	`✗`	System drive enumeration and space

Total: 100+ types, 92 files, 25+ diagrams created

Last generated: December 28, 2025

📦 NuGet Installation (GitHub Packages)

ThunderPropagator packages are hosted on GitHub Packages: https://nuget.pkg.github.com/KiarashMinoo/index.json

Configure NuGet Source

Option 1: nuget.config (recommended)


<configuration>
  <packageSources>
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
    <add key="github" value="https://nuget.pkg.github.com/KiarashMinoo/index.json" />
  </packageSources>
  <packageSourceMapping>
    <packageSource key="github">
      <package pattern="ThunderPropagator.*" />
    </packageSource>
    <packageSource key="nuget.org">
      <package pattern="*" />
    </packageSource>
  </packageSourceMapping>
  <packageSourceCredentials>
    <github>
      <add key="Username" value="YOUR_GITHUB_USERNAME" />
      <add key="ClearTextPassword" value="YOUR_GITHUB_PAT" />
    </github>
  </packageSourceCredentials>
</configuration>

Option 2: CLI

dotnet nuget add source https://nuget.pkg.github.com/KiarashMinoo/index.json \
  --name github \
  --username YOUR_GITHUB_USERNAME \
  --password YOUR_GITHUB_PAT \
  --store-password-in-clear-text

Install Packages

# Core application building blocks
dotnet add package ThunderPropagator.BuildingBlocks.Application

# Infrastructure components
dotnet add package ThunderPropagator.BuildingBlocks.Infrastructure

🎯 Quick Start

FeederMessage Pattern

using ThunderPropagator.BuildingBlocks.Application;

public class OrderMessage : FeederMessage
{
    public Guid OrderId
    {
        get => GetValueOrDefault(Guid.NewGuid());
        set => SetValue(value);
    }
    
    public decimal Amount
    {
        get => GetValueOrDefault(0m);
        set => SetValue(value);
    }
}

var order = new OrderMessage
{
    OrderId = Guid.NewGuid(),
    Amount = 99.99m,
    CorrelationId = "req-12345"
};

System Resource Monitoring

using ThunderPropagator.BuildingBlocks.Infrastructure.SystemResourceMonitor;

services.AddSystemResourceMonitor(options =>
{
    options.EnableCpuMetrics = true;
    options.EnableMemoryMetrics = true;
    options.EnableDiskHealth = true;
    options.DefaultSamplingWindowMs = 500;
});

// Inject and use
public class MonitoringService
{
    private readonly ISystemResourceMonitor _monitor;
    
    public MonitoringService(ISystemResourceMonitor monitor)
    {
        _monitor = monitor;
    }
    
    public async Task<SystemResourceMonitorMetrics> GetMetricsAsync()
    {
        return await _monitor.GetMetricsAsync();
    }
}

Serialization Helpers

using ThunderPropagator.BuildingBlocks.Application.Helpers;

// JSON
var json = myObject.ToJson();
var obj = json.FromJson<MyType>();

// YAML
var yaml = myObject.ToYaml();

// ProtoBuf
var bytes = myObject.ToProtoBufBytes();

// MessagePack
var base64 = myObject.ToMessagePackBase64();

🛠 Build & Test

# Restore dependencies
dotnet restore

# Build (Release)
dotnet build -c Release

# Run tests
dotnet test -c Release

# Package
dotnet pack -c Release -o artifacts/pkg

Multi-Platform Builds:

Platforms: AnyCPU, x86, x64, ARM64
Frameworks: net8.0, net9.0, net10.0

📄 Available Packages

Package	Version	Description	Documentation
ThunderPropagator.BuildingBlocks.Application	`1.0.1-beta.*`	Core application building blocks (FeederMessage, ServiceConfiguration, Helpers, Serialization)	docs/BuildingBlocks.Application
ThunderPropagator.BuildingBlocks.Infrastructure	`1.0.1-beta.*`	Infrastructure components (SystemResourceMonitor, HealthChecks, Network)	docs/BuildingBlocks.Infrastructure

📖 Key Features

Application Layer

FeederMessage: Dictionary-based message abstraction with correlation ID
ServiceConfiguration: Strongly-typed configuration with change notifications
Telemetry: OpenTelemetry integration (Activities, Counters, Histograms)
Helpers: Comprehensive serialization (JSON, YAML, ProtoBuf, MessagePack, NetJSON, Newtonsoft.Json)
Collections: LinkedArray, BindingDictionary, GenericOrderedDictionary
Ciphering: AES/RSA encryption, password generation
Objects: DisposableObject, EquatableObject, NotifiableObject base classes

Infrastructure Layer

SystemResourceMonitor: Cross-platform monitoring (CPU, Memory, Disk, GPU, Battery)
Platform Providers: Windows/Linux/macOS with graceful degradation
SMART Disk Health: Disk health monitoring via platform-specific tools
GPU Metrics: nvidia-smi/rocm-smi integration
Battery Status: Power management metrics
No External Packages: Uses .NET BCL and CLI tools only

🏗 Architecture

The solution follows a strict two-layer architecture:

Application Layer (ThunderPropagator.BuildingBlocks.Application)
- Core building blocks with NO infrastructure dependencies
- Helpers, serialization, collections, base classes
- Verified by Tests/ArchTests/ArchitectureTests.cs
Infrastructure Layer (ThunderPropagator.BuildingBlocks.Infrastructure)
- System-level components (monitoring, health checks)
- Depends on Application layer
- Platform-specific providers with graceful degradation

Critical Rule: Application layer MUST NEVER depend on Infrastructure layer.

🧪 Testing

Run All Tests

dotnet test -c Release

Architecture Tests

Architecture constraints are enforced by NetArchTest.Rules in Tests/ArchTests/:

Application layer has no Infrastructure dependencies
Naming conventions
Layer boundaries

Unit Tests

Comprehensive unit tests with xUnit and NSubstitute in Tests/ThunderPropagator.UnitTests/:

FeederMessage, ServiceConfiguration tests
Helper method tests
Collection tests
SystemResourceMonitor tests

Benchmarks

BenchmarkDotNet benchmarks for performance-critical code:

CollectionHelperBenchmark.cs
SizeBenchmark.cs

🚀 CI/CD Workflows

develop branch → develop-beta-ci.yml → Increments beta version
release/ branch → develop-release-ci.yml → Creates GitHub release, strips beta suffix
GitHub Packages feed: https://nuget.pkg.github.com/KiarashMinoo/index.json

📝 Contributing

Follow the existing code conventions (see .github/copilot-instructions.md)
Add XML documentation for all public APIs
Include unit tests for new features
Update relevant documentation in /docs
Ensure architecture tests pass

📜 License

See LICENSE for details.

Product	Compatible and additional computed target framework versions.
.NET	net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Ardalis.GuardClauses (>= 5.0.0)
- CaseConverter (>= 2.0.1)
- JetBrains.Annotations (>= 2025.2.4)
- MessagePack (>= 3.1.4)
- MessagePackAnalyzer (>= 3.1.4)
- NetJSON (>= 1.4.5)
- Newtonsoft.Json (>= 13.0.4)
- protobuf-net (>= 3.2.56)
- SharpZipLib (>= 1.4.2)
- System.IdentityModel.Tokens.Jwt (>= 8.15.0)
- ToonNet (>= 1.0.4)
- YamlDotNet (>= 16.3.0)
net8.0
- Ardalis.GuardClauses (>= 5.0.0)
- CaseConverter (>= 2.0.1)
- JetBrains.Annotations (>= 2025.2.4)
- MessagePack (>= 3.1.4)
- MessagePackAnalyzer (>= 3.1.4)
- NetJSON (>= 1.4.5)
- Newtonsoft.Json (>= 13.0.4)
- protobuf-net (>= 3.2.56)
- SharpZipLib (>= 1.4.2)
- System.IdentityModel.Tokens.Jwt (>= 8.15.0)
- ToonNet (>= 1.0.4)
- YamlDotNet (>= 16.3.0)
net9.0
- Ardalis.GuardClauses (>= 5.0.0)
- CaseConverter (>= 2.0.1)
- JetBrains.Annotations (>= 2025.2.4)
- MessagePack (>= 3.1.4)
- MessagePackAnalyzer (>= 3.1.4)
- NetJSON (>= 1.4.5)
- Newtonsoft.Json (>= 13.0.4)
- protobuf-net (>= 3.2.56)
- SharpZipLib (>= 1.4.2)
- System.IdentityModel.Tokens.Jwt (>= 8.15.0)
- ToonNet (>= 1.0.4)
- YamlDotNet (>= 16.3.0)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.0.1-beta.14	45	12/28/2025
1.0.1-beta.13	39	12/28/2025
1.0.1-beta.12	40	12/28/2025
1.0.1-beta.11	39	12/28/2025
1.0.1-beta.10	34	12/28/2025
1.0.1-beta.8	34	12/28/2025
1.0.1-beta.7	33	12/28/2025
1.0.1-beta.6	37	12/28/2025
1.0.1-beta.5	37	12/28/2025

- fix: update GitHub token references to use GH_TOKEN for consistency