👁 Image
CasCap.Common.Abstractions 4.12.1

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

Enums

Configuration Types

Models

Event Models

Attributes

Extension Methods

Contract

string SinkType { get; }
Task InitializeAsync(CancellationToken cancellationToken);
Task WriteEvent(T @event, CancellationToken cancellationToken = default);
Task HousekeepingAsync(IReadOnlyCollection<string> validIds, CancellationToken cancellationToken = default);

SinkType is a self-describing property that each implementation sets to its own sink identifier (e.g. "Redis", "AzureTables", "Console"). This enables targeted dispatch filtering at runtime without reflection. The value should match the string passed to on the same class.

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

Read-path queries (retrieving stored events, snapshots) are intentionally not part of this interface. Each domain defines its own query interface (e.g. IFroniusQuery, IKnxQuery) with methods tailored to the domain's access patterns. This follows the Interface Segregation Principle — write-only sinks (e.g. Console, SignalR) are not forced to implement read methods they cannot support.

Dependencies

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

NuGet Packages

This project has no project references.