CasCap.Common.Abstractions 4.11.0

Prefix Reserved
.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher. 
dotnet add package CasCap.Common.Abstractions --version 4.11.0
                    


                    

                
NuGet\Install-Package CasCap.Common.Abstractions -Version 4.11.0
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="CasCap.Common.Abstractions" Version="4.11.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="CasCap.Common.Abstractions" Version="4.11.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="CasCap.Common.Abstractions" />
                    


                            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 CasCap.Common.Abstractions --version 4.11.0
                    


                    

                
#r "nuget: CasCap.Common.Abstractions, 4.11.0"
#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 CasCap.Common.Abstractions@4.11.0
#: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=CasCap.Common.Abstractions&version=4.11.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=CasCap.Common.Abstractions&version=4.11.0
                    


                            Install as a Cake Tool

CasCap.Common.Abstractions

Core interface definitions shared across the CasCap ecosystem. This project provides the foundational contracts that other CasCap libraries and applications may depend upon.

Installation

dotnet add package CasCap.Common.Abstractions

Purpose

This library contains no concrete implementations — only interfaces and abstractions that define the contracts between components.

Target frameworks: netstandard2.0, net8.0, net9.0, net10.0

Interfaces

Interface Description
IAppConfig Marker interface implemented by all application configuration records to allow easy identification and generic constraint usage
IBgFeature Identifies a feature-gated background service — exposes a string FeatureName and ExecuteAsync entry point. Matched case-insensitively against the enabled features set at startup
IFeature<T> [Obsolete] Generic predecessor of IBgFeature that used a bitwise feature-flag enum via FeatureType. Retained for backward compatibility
IEventSink<T> Generic event sink contract. Domain events are fanned out to every registered IEventSink<T> implementation in parallel
ILocalCache Abstraction for an in-process cache provider supporting Get, Set, Delete, and DeleteAll
IMyBlob Represents a blob with associated metadata (bytes, DateCreatedUtc, BlobName, SizeInBytes, HasImage)
INotifier Abstracts a notification service capable of sending and receiving messages with optional attachment support
INotificationMessage Represents an outgoing notification message (text, sender, recipients, attachments)
INotificationAttachment Metadata for an attachment received as part of a notification (Id, ContentType)
INotificationGroup Represents a named group in a notification service (Id, Name, members)
INotificationResponse Response returned after sending a notification (Timestamp)
IReceivedNotification Represents a notification received from an external messaging service (Sender, GroupId, Message, attachments)
IHttpAuditStore Abstraction for persisting HTTP audit entries (net8.0+ only)
IAzBlobStorageConfig Exposes Azure Blob Storage connection properties (endpoint/connection string, container name, health check probe type) for feature-specific configuration records
IAzTableStorageConfig Exposes Azure Table Storage connection properties (endpoint/connection string, health check probe type) for feature-specific configuration records
IFeatureConfig<T> [Obsolete] Pairs with IFeature<T> to carry the enabled EnabledFeatures flags into the BackgroundService launcher
IKubeAppConfig Exposes Kubernetes-specific runtime properties (node name, pod name, namespace, pod IP, service account name)
IMetricsConfig Exposes OpenTelemetry metric configuration (metric name prefix, OTel service name)

Enums

Type Description
KubernetesProbeTypes [Flags] enum for Kubernetes container health probe types: None, Readiness, Liveness, Startup

Configuration Types

Type Description
ApiAuthConfig Basic authentication settings for a REST API (Username, Password)
SinkConfig Dictionary of SinkTypeAttribute name → SinkConfigParams
SinkConfigParams Per-sink settings: Enabled, and a Settings dictionary for sink-specific key/value settings
SinkSettingKeys Compile-time constants for common sink setting keys

Models

Type Description
HttpAuditEntry Represents a single HTTP request/response audit record — Source, HttpMethod, RequestUri, StatusCode, ElapsedMs, RequestBody, ResponseBody (net8.0+ only)

Event Models

Type Description
CommsEvent A comms stream entry with Source, Message, TimestampUtc, and optional JsonPayload for AI agent context

Attributes

Attribute Description
SinkTypeAttribute Decorates IEventSink<T> implementations with a string type name (e.g. "Redis", "AzureTables", "Console") used by AddEventSinks() for discovery

Extension Methods

Method Description
IServiceCollection.AddEventSinks<T>(SinkConfig, Assembly) Discovers and registers all IEventSink<T> implementations in the supplied assembly whose SinkTypeAttribute name is enabled in SinkConfig
KubernetesProbeTypes.GetTags() Returns the string health-check tag array for a probe type ("ready", "live", "startup")

IEventSink<T> Contract

Task InitializeAsync(CancellationToken cancellationToken);
Task WriteEvent(T @event, CancellationToken cancellationToken = default);
IAsyncEnumerable<T> GetEvents(string? id = null, int limit = 1000, CancellationToken cancellationToken = default);
Task HousekeepingAsync(IReadOnlyCollection<string> validIds, CancellationToken cancellationToken = default);

InitializeAsync and HousekeepingAsync have default no-op implementations so that sink authors only need to implement WriteEvent and GetEvents.

Dependencies

The only valid dependencies for this library are other Abstractions-style libraries.

NuGet Packages

Package
Microsoft.Extensions.Hosting.Abstractions

This project has no project references.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  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. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (8)

Showing the top 5 NuGet packages that depend on CasCap.Common.Abstractions:

Package Downloads
CasCap.Common.Net

Helper library for common HttpClient/WebAPI requirements.
CasCap.Common.Caching

Helper library for local and remote object caching.
CasCap.Common.Extensions.Diagnostics.HealthChecks

Custom ASP.NET Core health check base classes for monitoring HTTP endpoint availability.
CasCap.Common.Services

Feature-flag background service launcher using bitwise EnabledFeatures flags to activate IFeature implementations.
CasCap.Common.Configuration

Configuration bootstrapping helpers — standard IConfiguration pipeline setup and validated IOptions binding for IAppConfig records.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.11.0 5 5/8/2026
4.10.5 307 5/4/2026
4.10.4 292 5/2/2026
4.10.3 488 4/24/2026
4.10.2 240 4/24/2026
4.10.1 357 4/23/2026
4.10.0 230 4/23/2026
4.9.3 246 4/20/2026
4.9.2 230 4/19/2026
4.9.1 307 4/17/2026
4.9.0 314 4/15/2026
4.8.1 268 4/2/2026
4.8.1-2026-04-updates.6 63 4/1/2026
4.8.0 249 4/1/2026

See https://github.com/f2calv/CasCap.Common/releases