Cannery.Contracts 1.1.285

Accessor Adapter Abstractions

Generic, composable interfaces and adapters for domain model access and capability delegation.

Overview

This package provides a set of generic interfaces and adapters for building clean, testable, and decoupled access patterns to domain models and capabilities. It is designed for use in modular, DDD-inspired .NET solutions where you want to abstract away storage, workflow, or capability details behind simple, strongly-typed contracts.

• Adapters: Define and compose CRUD, capability, and workflow operations.
• Accessors: Provide delegating implementations for adapters.
• No dependencies on infrastructure or HTTP concerns.
• Ideal for use in Core.Domain, Core.Application, and above.

Key Interfaces

• ICapabilityAdapter<TRequest, TResponse>
  For non-RESTful, task-oriented operations (e.g., workflows, batch jobs, MCP servers).

• IModelAdapter<TKey, TModel, TCreateCommand, TModifyCommand>
  Full CRUD with PATCH-style modify semantics.

• ICreateDeleteAdapter<TKey, TModel, TCreateCommand>
  For immutable models supporting only Create, Read, and Delete.

• IReadable<TKey, TModel>
  Read operations, including paginated queries.

• ICreatable<TModel, TCreateCommand>
  Create operations.

• IModifiable<TKey, TModifyCommand>
  PATCH-style partial update operations.

• IDeletable<TKey>
  Delete operations.

Example Usage

public class MyEntityAdapter : IModelAdapter<Guid, MyEntity, CreateMyEntityCommand, ModifyMyEntityCommand>
{
    // Implement all CRUD and patch methods here
}

You can also use the provided ModelAccessor and CapabilityAccessor classes to delegate to your adapters.

Why Use Accessor/Adapter Abstractions?

• Testability: Easily mock or swap implementations for testing.
• Separation of concerns: Keep domain/application logic decoupled from storage or workflow details.
• Composability: Compose adapters for complex scenarios (e.g., aggregate roots, workflows).
• Consistency: Enforce a uniform access pattern across your solution.

Installation

Add the NuGet package to your project:

dotnet add package [Your.Package.Name]

License

MIT

Contributing

Contributions and feedback are welcome! Please open issues or submit pull requests.